BAMIMI Cache is a lightweight, file-based caching library designed for Node.js applications. It provides flexible caching with optional compression, expiration handling, and keyword search capabilities. The library is easy to use and integrates seamlessly into modern applications.
Install BAMIMI Cache via npm or yarn:
npm i @knfs-tech/bamimi-cache
# OR
yarn add @knfs-tech/bamimi-cache- File-based Caching: Store data directly on the file system for fast and efficient access.
- Compression: Reduce file sizes with Snappy compression.
- Expiration Handling: Automatically delete cached entries after a specified duration.
- Keyword Search: Search through cached entries using keywords with
AND/ORlogic. - Logging: Enable optional logging for debugging and monitoring.
- Flexible Configuration: Set up default settings for expiration, compression, and cache directory.
const CacheFile = require('@knfs-tech/bamimi-cache');
// Initialize the cache system
const cache = new CacheFile({
folder: './my-cache', // Custom cache folder
autoCompress: true, // Automatically compress data
log: true, // Enable logging
});
cache.setup()
// Store data in the cache
await cache.set('user:123', JSON.stringify({ name: 'John Doe' }), { expire: 60000 });
// Retrieve data from the cache
const userData = await cache.get('user:123');
console.log(JSON.parse(userData));
// Check if a key exists
const exists = await cache.exist('user:123');
console.log(exists ? 'Key exists' : 'Key does not exist');
// Delete a cache entry
await cache.del('user:123');Creates a new instance of BAMIMI Cache.
| Parameter | Type | Default | Description | Support Version |
|---|---|---|---|---|
config.folder |
String | projectPath + /cache |
Directory to store cached files. | >= 1.0.2 |
config.expire |
Number | 0 |
Default expiration time in milliseconds, (0 is not expire) | >= 1.0.2 |
config.autoCompress |
Boolean | false |
Enable auto-compression for cached content. | >= 1.0.2 |
config.log |
Boolean | false |
Enable or disable logging. | >= 1.0.2 |
config.peakDuration |
Number | 3000 |
Allows peak time to use cache to store the results returned when getting, to increase query speed. If peakDuration is 0, it means it is not used. | >= 1.1.3 |
config.maxSize |
Number | 0 |
Default max size of cache content in bytes, (0 is not verify). | >= 1.2.9 |
config.logHandle |
Number | use console.log |
Function handle log | >= 1.3.0 (Latest) |
config.errorHandle |
Number | use throw new Error |
Function handle error. | >= 1.3.0 |
Initialize configuration files
Stores data in the cache.
| Parameter | Type | Description |
|---|---|---|
key |
String | Unique identifier for the cache entry. |
content |
String | Content to cache. |
options.compress |
Boolean | Enable compression for this entry. |
options.expire |
Number | Expiration time in milliseconds. |
options.search |
Array | Keywords to enable search for this entry. |
Retrieves cached content by its key.
| Parameter | Type | Description |
|---|---|---|
key |
String | Unique identifier for the cache. |
Returns: Promise<String> - Cached content.
Checks if a key exists in the cache.
| Parameter | Type | Description |
|---|---|---|
key |
String | Unique identifier for the cache. |
Returns: Boolean - true if the key exists, otherwise false.
Deletes a cached entry by its key.
| Parameter | Type | Description |
|---|---|---|
key |
String | Unique identifier for the cache. |
Searches for cached entries based on keywords.
| Parameter | Type | Default | Description |
|---|---|---|---|
keywords |
Array | [] |
Keywords to search for. |
logic |
String (AND/OR) |
AND |
Logic to apply during the search. |
Returns: Array<String> - Matching cache keys.
Publish event
| Parameter | Type | Default | Description |
|---|---|---|---|
key |
String | Key or event. | |
message |
any | Message publish to event. |
Subscribe event
| Parameter | Type | Default | Description |
|---|---|---|---|
key |
String | Key or event. | |
logic |
function(message) | Listen event publish. |
Ex:
const storage = new CacheFile(configDefault)
storage.setup()
storage.subscribe("event-1", async (message) => {
console.log("listener 1", message)
})
storage.publish("event-1", contentNumber)To customize the cache configuration:
const cache = new CacheFile({
folder: './cache-directory',
expire: 60000, // Default expiration time: 60 seconds
autoCompress: true, // Enable automatic compression
log: true, // Enable logging
});Uses Snappy for fast and lightweight compression. To enable compression:
await cache.set('key', 'content', { compress: true });Automatically removes expired entries:
await cache.set('tempKey', 'tempData', { expire: 5000 }); // Expires in 5 secondsWe welcome contributions! Please create a pull request or submit issues on GitHub.
BAMIMI Cache is open-source software licensed under the MIT License.