Source file

• alisa.cache

Creator(s)

• Ali (Fearless Crazy)

Social media accounts

• Ali: Instagram - Discord - Spotify

How to download?

• First we create a node.js file (If you have not downloaded node.js to computer before, you can download node.js by clicking here)

• Then we open the PowerShell terminal by "shift + right click" on the folder of the file you created.

• Then we write npm i alisa.cache and press enter.

• Download the alisa.cache module

• And now we have downloaded the alisa.cache module, congratulations 🎉🎉

What is this module?

• This module is a high-performance and flexible JavaScript caching system designed to be modular and extendable

• Supports TTL, LRU/FIFO/MFU, tagging, namespacing, event emitters, auto pruning, and more

• Easily usable and thoroughly tested with assert-based and Jest-style tests

Features

• ✅ LRU / FIFO / MFU / CUSTOM strategy support
• 🔁 TTL with auto cleanup support
• 🔖 Tag system (getByTag, deleteByTag, etc.)
• 📂 Namespaces for isolated sub-caches
• 🧠 Smart methods: filter, map, groupBy, partition, reduce
• 🔍 Utility methods: rename, search, expire, ttl
• 📦 Full snapshot + restore system
• 📡 on() and emit() support (custom event listeners)
• 🧪 Manual and automated testing support (test.js)

How to use?

const AlisaCache = require("alisa.cache");
const cache = new AlisaCache({ limit: 100, ttl: 6000 });

cache.set("user:1", { name: "Alice" }, { ttl: 5000, tags: ["admin"] });
console.log(cache.get("user:1")); // { name: "Alice" }

cache.set("owner", { name: "Tom", role: "owner" }, { tags: ["owner"] })

cache.protect("owner");
cache.delete("owner"); // false, owner is still there

await cache.saveToFile("./cache.json");
await cache.loadFromFile("./cache.json");

Real-world example: Discord bot prefix per guild

const cache = new AlisaCache({ limit: 500 });

function onMessage(msg) {
  const guildId = msg.guild?.id;
  if (!guildId) return;

  const guildCache = cache.namespace(guildId);
  const prefix = guildCache.get("prefix") || "!";

  if (msg.content.startsWith(prefix)) {
    const command = msg.content.slice(prefix.length).split(" ")[0];
    console.log(`Command received: ${command}`);
  }
}

// Setup example
cache.namespace("1234").set("prefix", ".");

How to test?

node test.js

If all goes well, you'll see:

[✓] All tests passed

API Table

| Method | Description | |------------------------|-----------------------------------------| | set(key, value, opts)| Add item to cache | | get(key) | Retrieve value | | has(key) | Check existence | | delete(key) | Remove key | | ttl(key) | Remaining TTL in ms | | expire(key) | Instantly expire a key | | rename(old, new) | Rename a key | | filter(fn) | Return matching entries | | groupBy(fn) | Group entries | | partition(fn) | Separate matching & non-matching | | search(q, where?) | Find keys/values with RegExp support | | namespace(name) | Get isolated cache segment | | snapshot() | Export cache state | | loadSnapshot(obj) | Restore from snapshot | | on(event, cb) | Register listener | | protect(key) | Prevent a key from being removed | | unprotect(key) | Remove protection from a key | | saveToFile(path) | Save cache as JSON file | | loadFromFile(path) | Load cache from JSON file |

Please do not forget to use it in the latest version for more stable and performance of the module!

And finally

• If you want to support this module, if you request me on github, I will be happy to help you.

• Thank you for reading this far, i love you 💗

• See you in my next modules!