2.1.0

What's Changed

• docs: Update documentation files and links by @ndragun92 in #9
• fix(deps): Update dependencies in package-lock.json and add 'pinceau' to package.json by @ndragun92 in #10
• feat: Add 'files' method to FileSysCache class by @ndragun92 in #11

2.0.1

What's Changed

• update(docs): Add examples and update package version by @ndragun92 in #8

1.1.2

What's Changed

• chore: Update generateKey function to accept objects by @ndragun92 in #4

1.1.1

What's Changed

• feat: Add generateKey function and update package version by @ndragun92 in #3

1.1.0

What's Changed

• feat: Add hash options to FileSysCache constructor by @ndragun92 in #2

1.0.3

Full Changelog:

Click here to see changes

1.0.2

Fix

• NODE_ENV variable

1.0.1

Fix

• Unit Tests for GitHub Actions

1.0.0

File-Sys-Cache

File-Sys-Cache is an npm package that provides a simple and efficient system files-based caching solution for Node.js applications.

Features

• Set Cache: Store data in the cache with options to specify file name prefix, file name, payload, and time-to-live (TTL).
• Get Cached Data: Retrieve cached data by providing the corresponding file name or prefix.
• Invalidate Cached Data: Automatically invalidate cached data for items with expired TTLs.
• Flush Cache by Regex: Flush cache entries that match a given regular expression.
• Flush Whole Cache: Clear the entire cache, removing all stored entries.
• Monitoring: Monitor cache usage and performance statistics, including invalidated files count, logs over time, size over time, and request count.

Installation

Install File-Sys-Cache via npm:

npm install file-sys-cache

Usage

import { FileSysCache } from 'file-sys-cache'

// Create a new cache instance
const cache = new FileSysCache({
    basePath: './.file-sys-cache', // Directory where cache will be stored
    defaultTTL: 60, // 60 seconds expiration time
    debug: false, // Enabled debug mode
    autoInvalidate: false ,// Auto invalidate files from file-system and delete expired files automatically without need of triggering .invalidate()
    enableMonitoring: false // Enabled monitoring which exposes cache.monitoring.get(), cache.monitoring.reset()
});

// Set cache with a file name prefix, file name, payload, and TTL
await cache.set({ fileName: 'myFileName', key: 'myUniqueKey', payload: myPayload, ttl: 3600 })

// Retrieve cached data by file name prefix and file name
const data = await cache.get({ fileName: 'myFileName', key: 'myUniqueKey' });

// Caching fresh data if not inside cache and returning original fresh payload, otherwise if it is inside the cache then it returns cached data
const data = await cache.getOrSet({ fileName: 'myFileName', key: 'myUniqueKey', payload: myPayload, ttl: 3600 });

// Flush cache by passing regex
await cache.flushByRegex('myString', 'myString2'); // Flush cache by regex match (single or multiple same matches)

// Flush whole cache
await cache.flushAll();

For more detailed usage examples and API documentation, please refer to the Documentation section.

Contributing

Contributions are welcome! Please see the Contributing Guidelines for more information.

License

This project is licensed under the MIT License - see the LICENSE file for details.