@warlock.js/cache 1.0.0

package/cjs/cache-manager.js

@@ -0,0 +1,148 @@
+'use strict';class CacheManager {
+    /**
+     * Cache Driver
+     */
+    currentDriver;
+    /**
+     * Loaded drivers
+     */
+    loadedDrivers = {};
+    /**
+     * Configurations list
+     */
+    configurations = {
+        drivers: {},
+    };
+    /**
+     * {@inheritdoc}
+     */
+    name = "cacheManager";
+    /**
+     * {@inheritdoc}
+     */
+    get client() {
+        return this.currentDriver?.client;
+    }
+    /**
+     * Set the cache configurations
+     */
+    setCacheConfigurations(configurations) {
+        this.configurations.default = configurations.default;
+        this.configurations.drivers = configurations.drivers;
+        this.configurations.options = configurations.options;
+    }
+    /**
+     * Use the given driver
+     */
+    async use(driver) {
+        if (typeof driver === "string") {
+            const driverInstance = await this.load(driver);
+            if (!driverInstance) {
+                throw new Error(`Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`);
+            }
+            driver = driverInstance;
+        }
+        this.currentDriver = driver;
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        return this.currentDriver?.get(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, value, ttl) {
+        return this.currentDriver?.set(key, value, ttl);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        return this.currentDriver?.remove(key);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        return this.currentDriver?.removeNamespace(namespace);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        return this.currentDriver?.flush();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async connect() {
+        return this.currentDriver?.connect();
+    }
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(key) {
+        return this.currentDriver?.parseKey(key) || "";
+    }
+    /**
+     * {@inheritdoc}
+     */
+    get options() {
+        return this.currentDriver?.options;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        return this.currentDriver?.setOptions(options);
+    }
+    /**
+     * Get an instance of the cache driver
+     */
+    async driver(driverName) {
+        return this.loadedDrivers[driverName] || (await this.load(driverName));
+    }
+    /**
+     * Initialize the cache manager and pick the default driver
+     */
+    async init() {
+        const defaultCacheDriverName = this.configurations.default;
+        if (!defaultCacheDriverName) {
+            return;
+        }
+        const driver = await this.driver(defaultCacheDriverName);
+        await this.use(driver);
+    }
+    /**
+     * Load the given cache driver name
+     */
+    async load(driver) {
+        if (this.loadedDrivers[driver])
+            return this.loadedDrivers[driver];
+        const Driver = this.configurations.drivers[driver];
+        if (!Driver) {
+            throw new Error(`Cache driver ${driver} is not found, please declare it in the cache drivers in the configurations list.`);
+        }
+        const driverInstance = new Driver();
+        driverInstance.setOptions(this.configurations.options[driver]);
+        await driverInstance.connect();
+        this.loadedDrivers[driver] = driverInstance;
+        return driverInstance;
+    }
+    /**
+     * Register and bind a driver
+     */
+    registerDriver(driverName, driverClass) {
+        this.configurations.drivers[driverName] = driverClass;
+    }
+    /**
+     * Disconnect the cache manager
+     */
+    async disconnect() {
+        await this.currentDriver?.disconnect();
+    }
+}
+const cache = new CacheManager();exports.CacheManager=CacheManager;exports.cache=cache;//# sourceMappingURL=cache-manager.js.map

package/cjs/cache-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.js","sources":["../src/cache-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/cjs/drivers/base-cache-driver.d.ts

@@ -0,0 +1,81 @@
+import { GenericObject } from "@mongez/reinforcements";
+import { CacheData, CacheDriver, CacheOperationType } from "../types";
+export declare abstract class BaseCacheDriver<ClientType, Options extends GenericObject> implements CacheDriver<ClientType, Options> {
+    /**
+     * CLient driver
+     */
+    protected clientDriver: ClientType;
+    /**
+     * {@inheritdoc}
+     */
+    get client(): ClientType;
+    /**
+     * Set client driver
+     */
+    set client(client: ClientType);
+    /**
+     * Get the cache driver name
+     */
+    abstract name: string;
+    /**
+     * Options list
+     */
+    options: Options;
+    /**
+     * {@inheritdoc}
+     */
+    parseKey(key: string | GenericObject): Promise<string>;
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options: Options): this;
+    /**
+     * {@inheritdoc}
+     */
+    abstract removeNamespace(namespace: string): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract set(key: string | GenericObject, value: any): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract get(key: string | GenericObject): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract remove(key: string | GenericObject): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    abstract flush(): Promise<void>;
+    /**
+     * Log the operation
+     */
+    protected log(operation: CacheOperationType, key?: string): any;
+    /**
+     * Get time to live value
+     */
+    get ttl(): any;
+    /**
+     * Get time to live value in milliseconds
+     */
+    getTtl(ttl?: number): number;
+    /**
+     * Prepare data for storage
+     */
+    protected prepareDataForStorage(data: any, ttl?: number): CacheData;
+    /**
+     * Parse fetched data from cache
+     */
+    protected parseCachedData(key: string, data: CacheData): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    connect(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=base-cache-driver.d.ts.map

package/cjs/drivers/base-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/base-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAuBtE,8BAAsB,eAAe,CAAC,UAAU,EAAE,OAAO,SAAS,aAAa,CAC7E,YAAW,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,YAAY,EAAG,UAAU,CAAC;IAEpC;;OAEG;IACH,IAAW,MAAM,IAOS,UAAU,CALnC;IAED;;OAEG;IACH,IAAW,MAAM,CAAC,MAAM,EAAE,UAAU,EAEnC;IAED;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACI,OAAO,EAAE,OAAO,CAAa;IAEpC;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAIjD;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,OAAO;IAKlC;;OAEG;aACa,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAEhE;;OAEG;aACa,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAE1E;;OAEG;aACa,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAE9D;;OAEG;aACa,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAElE;;OAEG;aACa,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtC;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,CAAC,EAAE,MAAM;IA8BzD;;OAEG;IACH,IAAW,GAAG,QAEb;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,GAAE,MAAiB;IAMpC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAavD;;OAEG;cACa,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAa5D;;OAEG;IACU,OAAO;IAKpB;;OAEG;IACU,UAAU;CAGxB"}

package/cjs/drivers/base-cache-driver.js

@@ -0,0 +1,123 @@
+'use strict';var logger=require('@warlock.js/logger'),utils=require('../utils.js');const messages = {
+    clearing: "Clearing namespace",
+    cleared: "Namespace cleared",
+    fetching: "Fetching key",
+    fetched: "Key fetched",
+    caching: "Caching key",
+    cached: "Key cached",
+    flushing: "Flushing cache",
+    flushed: "Cache flushed",
+    removing: "Removing key",
+    removed: "Key removed",
+    expired: "Key expired",
+    notFound: "Key not found",
+    connecting: "Connecting to the cache engine.",
+    connected: "Connected to the cache engine.",
+    disconnecting: "Disconnecting from the cache engine.",
+    disconnected: "Disconnected from the cache engine.",
+    error: "Error occurred",
+};
+class BaseCacheDriver {
+    /**
+     * CLient driver
+     */
+    clientDriver;
+    /**
+     * {@inheritdoc}
+     */
+    get client() {
+        return (this.clientDriver || this);
+    }
+    /**
+     * Set client driver
+     */
+    set client(client) {
+        this.clientDriver = client;
+    }
+    /**
+     * Options list
+     */
+    options = {};
+    /**
+     * {@inheritdoc}
+     */
+    async parseKey(key) {
+        return await utils.parseCacheKey(key, this.options);
+    }
+    /**
+     * {@inheritdoc}
+     */
+    setOptions(options) {
+        this.options = options || {};
+        return this;
+    }
+    /**
+     * Log the operation
+     */
+    log(operation, key) {
+        if (key) {
+            // this will be likely used with file cache driver as it will convert the dot to slash
+            // to make it consistent and not to confuse developers we will output the key by making sure it's a dot
+            key = key.replaceAll("/", ".");
+        }
+        if (operation == "notFound" || operation == "expired") {
+            return logger.log.error("cache:" + this.name, operation, (key ? key + " " : "") + messages[operation]);
+        }
+        if (operation.endsWith("ed")) {
+            return logger.log.success("cache:" + this.name, operation, (key ? key + " " : "") + messages[operation]);
+        }
+        logger.log.info("cache:" + this.name, operation, (key ? key + " " : "") + messages[operation]);
+    }
+    /**
+     * Get time to live value
+     */
+    get ttl() {
+        return this.options.ttl !== undefined ? this.options.ttl : Infinity;
+    }
+    /**
+     * Get time to live value in milliseconds
+     */
+    getTtl(ttl = this.ttl) {
+        if (ttl) {
+            return new Date().getTime() + ttl * 1000;
+        }
+    }
+    /**
+     * Prepare data for storage
+     */
+    prepareDataForStorage(data, ttl) {
+        const preparedData = {
+            data,
+        };
+        if (ttl) {
+            preparedData.ttl = ttl;
+            preparedData.expiresAt = this.getTtl(ttl);
+        }
+        return preparedData;
+    }
+    /**
+     * Parse fetched data from cache
+     */
+    async parseCachedData(key, data) {
+        this.log("fetched", key);
+        if (data.expiresAt && data.expiresAt < Date.now()) {
+            console.log("Expired key", key);
+            this.remove(key);
+            return null;
+        }
+        return data.data || null;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async connect() {
+        this.log("connecting");
+        this.log("connected");
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async disconnect() {
+        this.log("disconnected");
+    }
+}exports.BaseCacheDriver=BaseCacheDriver;//# sourceMappingURL=base-cache-driver.js.map

package/cjs/drivers/base-cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-cache-driver.js","sources":["../../src/drivers/base-cache-driver.ts"],"sourcesContent":[null],"names":["parseCacheKey","log"],"mappings":"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"}

package/cjs/drivers/file-cache-driver.d.ts

@@ -0,0 +1,42 @@
+import { GenericObject } from "@mongez/reinforcements";
+import { CacheDriver, FileCacheOptions } from "../types";
+import { BaseCacheDriver } from "./base-cache-driver";
+export declare class FileCacheDriver extends BaseCacheDriver<FileCacheDriver, FileCacheOptions> implements CacheDriver<FileCacheDriver, FileCacheOptions> {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Get the cache directory
+     */
+    get directory(): string;
+    /**
+     * Get file name
+     */
+    get fileName(): string;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(namespace: string): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: string | GenericObject, value: any, ttl?: number): Promise<this>;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: string | GenericObject): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: string | GenericObject): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    connect(): Promise<void>;
+}
+//# sourceMappingURL=file-cache-driver.d.ts.map

package/cjs/drivers/file-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/file-cache-driver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,qBAAa,eACX,SAAQ,eAAe,CAAC,eAAe,EAAE,gBAAgB,CACzD,YAAW,WAAW,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAEzD;;OAEG;IACI,IAAI,SAAU;IAErB;;OAEG;IACH,IAAW,SAAS,WAUnB;IAED;;OAEG;IACH,IAAW,QAAQ,WAQlB;IAED;;OAEG;IACU,eAAe,CAAC,SAAS,EAAE,MAAM;IAc9C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM;IAkBtE;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAoB5C;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAe/C;;OAEG;IACU,KAAK;IAYlB;;OAEG;IACU,OAAO;CAKrB"}

package/cjs/drivers/file-cache-driver.js

@@ -0,0 +1,106 @@
+'use strict';var fs=require('@mongez/fs'),path=require('path'),baseCacheDriver=require('./base-cache-driver.js');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var path__default=/*#__PURE__*/_interopDefault(path);class FileCacheDriver extends baseCacheDriver.BaseCacheDriver {
+    /**
+     * {@inheritdoc}
+     */
+    name = "file";
+    /**
+     * Get the cache directory
+     */
+    get directory() {
+        const directory = this.options.directory;
+        if (typeof directory === "function") {
+            return directory();
+        }
+        throw new Error("Cache directory is not defined, please define it in the file driver options");
+    }
+    /**
+     * Get file name
+     */
+    get fileName() {
+        const fileName = this.options.fileName;
+        if (typeof fileName === "function") {
+            return fileName();
+        }
+        return "cache.json";
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async removeNamespace(namespace) {
+        this.log("cleared", namespace);
+        try {
+            await fs.removeDirectoryAsync(path__default.default.resolve(this.directory, namespace));
+            this.log("cleared", namespace);
+        }
+        catch (error) {
+            //
+        }
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async set(key, value, ttl) {
+        key = await this.parseKey(key);
+        this.log("caching", key);
+        const data = this.prepareDataForStorage(value, ttl);
+        const fileDirectory = path__default.default.resolve(this.directory, key);
+        await fs.ensureDirectoryAsync(fileDirectory);
+        await fs.putJsonFileAsync(path__default.default.resolve(fileDirectory, this.fileName), data);
+        this.log("cached", key);
+        return this;
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async get(key) {
+        const parsedKey = await this.parseKey(key);
+        this.log("fetching", parsedKey);
+        const fileDirectory = path__default.default.resolve(this.directory, parsedKey);
+        try {
+            const value = await fs.getJsonFileAsync(path__default.default.resolve(fileDirectory, this.fileName));
+            return this.parseCachedData(parsedKey, value);
+        }
+        catch (error) {
+            this.log("notFound", parsedKey);
+            this.remove(key);
+            return null;
+        }
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async remove(key) {
+        const parsedKey = await this.parseKey(key);
+        this.log("removing", parsedKey);
+        const fileDirectory = path__default.default.resolve(this.directory, parsedKey);
+        try {
+            await fs.removeDirectoryAsync(fileDirectory);
+            this.log("removed", parsedKey);
+        }
+        catch (error) {
+            //
+        }
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async flush() {
+        this.log("flushing");
+        if (this.options.globalPrefix) {
+            await this.removeNamespace("");
+        }
+        else {
+            await fs.removeDirectoryAsync(this.directory);
+        }
+        this.log("flushed");
+    }
+    /**
+     * {@inheritdoc}
+     */
+    async connect() {
+        this.log("connecting");
+        await fs.ensureDirectoryAsync(this.directory);
+        this.log("connected");
+    }
+}exports.FileCacheDriver=FileCacheDriver;//# sourceMappingURL=file-cache-driver.js.map

package/cjs/drivers/file-cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache-driver.js","sources":["../../src/drivers/file-cache-driver.ts"],"sourcesContent":[null],"names":["BaseCacheDriver","removeDirectoryAsync","path","ensureDirectoryAsync","putJsonFileAsync","getJsonFileAsync"],"mappings":"uOAWM,MAAO,eACX,SAAQA,+BAAkD,CAAA;AAG1D;;AAEG;IACI,IAAI,GAAG,MAAM,CAAC;AAErB;;AAEG;AACH,IAAA,IAAW,SAAS,GAAA;AAClB,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;AAEzC,QAAA,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE;YACnC,OAAO,SAAS,EAAE,CAAC;AACpB,SAAA;AAED,QAAA,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;KACH;AAED;;AAEG;AACH,IAAA,IAAW,QAAQ,GAAA;AACjB,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;AAEvC,QAAA,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE;YAClC,OAAO,QAAQ,EAAE,CAAC;AACnB,SAAA;AAED,QAAA,OAAO,YAAY,CAAC;KACrB;AAED;;AAEG;IACI,MAAM,eAAe,CAAC,SAAiB,EAAA;AAC5C,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE/B,IAAI;AACF,YAAA,MAAMC,uBAAoB,CAACC,qBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE,YAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAChC,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;;AAEf,SAAA;AAED,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;AACI,IAAA,MAAM,GAAG,CAAC,GAA2B,EAAE,KAAU,EAAE,GAAY,EAAA;QACpE,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE/B,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAEzB,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAEpD,QAAA,MAAM,aAAa,GAAGA,qBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAExD,QAAA,MAAMC,uBAAoB,CAAC,aAAa,CAAC,CAAC;AAE1C,QAAA,MAAMC,mBAAgB,CAACF,qBAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;AAEzE,QAAA,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAExB,QAAA,OAAO,IAAI,CAAC;KACb;AAED;;AAEG;IACI,MAAM,GAAG,CAAC,GAA2B,EAAA;QAC1C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE3C,QAAA,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEhC,QAAA,MAAM,aAAa,GAAGA,qBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI;AACF,YAAA,MAAM,KAAK,GAAG,MAAMG,mBAAgB,CAClCH,qBAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAC3C,CAAC;YAEF,OAAO,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/C,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;AACd,YAAA,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAChC,YAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACjB,YAAA,OAAO,IAAI,CAAC;AACb,SAAA;KACF;AAED;;AAEG;IACI,MAAM,MAAM,CAAC,GAA2B,EAAA;QAC7C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC3C,QAAA,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEhC,QAAA,MAAM,aAAa,GAAGA,qBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE9D,IAAI;AACF,YAAA,MAAMD,uBAAoB,CAAC,aAAa,CAAC,CAAC;AAE1C,YAAA,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AAChC,SAAA;AAAC,QAAA,OAAO,KAAK,EAAE;;AAEf,SAAA;KACF;AAED;;AAEG;AACI,IAAA,MAAM,KAAK,GAAA;AAChB,QAAA,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAErB,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;AAC7B,YAAA,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAChC,SAAA;AAAM,aAAA;AACL,YAAA,MAAMA,uBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,SAAA;AAED,QAAA,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KACrB;AAED;;AAEG;AACI,IAAA,MAAM,OAAO,GAAA;AAClB,QAAA,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACvB,QAAA,MAAME,uBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC3C,QAAA,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;KACvB;AACF"}

package/cjs/drivers/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./base-cache-driver";
+export * from "./file-cache-driver";
+export * from "./lru-memory-cache-driver";
+export * from "./memory-cache-driver";
+export * from "./memory-extended-cache-driver";
+export * from "./null-cache-driver";
+export * from "./redis-cache-driver";
+//# sourceMappingURL=index.d.ts.map

package/cjs/drivers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/cjs/drivers/lru-memory-cache-driver.d.ts

@@ -0,0 +1,84 @@
+import { GenericObject } from "@mongez/reinforcements";
+import { CacheDriver, LRUMemoryCacheOptions } from "../types";
+import { BaseCacheDriver } from "./base-cache-driver";
+declare class CacheNode {
+    key: string;
+    value: any;
+    next: CacheNode | null;
+    prev: CacheNode | null;
+    constructor(key: string, value: any);
+}
+/**
+ * LRU Memory Cache Driver
+ * The concept of LRU is to remove the least recently used data
+ * whenever the cache is full
+ * The question that resides here is how to tell the cache is full?
+ */
+export declare class LRUMemoryCacheDriver extends BaseCacheDriver<LRUMemoryCacheDriver, LRUMemoryCacheOptions> implements CacheDriver<LRUMemoryCacheDriver, LRUMemoryCacheOptions> {
+    /**
+     * {@inheritdoc}
+     */
+    name: string;
+    /**
+     * Cache map
+     */
+    protected cache: Map<string, CacheNode>;
+    /**
+     * Head of the cache
+     */
+    protected head: CacheNode;
+    /**
+     * Tail of the cache
+     */
+    protected tail: CacheNode;
+    /**
+     * {@inheritdoc}
+     */
+    constructor();
+    /**
+     * Initialize the cache
+     */
+    init(): void;
+    /**
+     * {@inheritdoc}
+     */
+    removeNamespace(_namespace: string): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    set(key: string | GenericObject, value: any, _ttl?: number): Promise<this>;
+    /**
+     * Move the node to the head
+     */
+    protected moveHead(node: CacheNode): void;
+    /**
+     * Remove the node from the cache
+     */
+    protected removeNode(node: CacheNode): void;
+    /**
+     * Add the node to the head
+     */
+    protected addNode(node: CacheNode): void;
+    /**
+     * Remove the tail node
+     */
+    protected removeTail(): void;
+    /**
+     * {@inheritdoc}
+     */
+    get(key: string | GenericObject): Promise<any>;
+    /**
+     * {@inheritdoc}
+     */
+    remove(key: string | GenericObject): Promise<void>;
+    /**
+     * {@inheritdoc}
+     */
+    flush(): Promise<void>;
+    /**
+     * Get lru capacity
+     */
+    get capacity(): number;
+}
+export {};
+//# sourceMappingURL=lru-memory-cache-driver.d.ts.map

package/cjs/drivers/lru-memory-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru-memory-cache-driver.d.ts","sourceRoot":"","sources":["../../src/drivers/lru-memory-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,cAAM,SAAS;IAIJ,GAAG,EAAE,MAAM;IACX,KAAK,EAAE,GAAG;IAJZ,IAAI,EAAE,SAAS,GAAG,IAAI,CAAQ;IAC9B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG;CAIpB;AAED;;;;;GAKG;AACH,qBAAa,oBACX,SAAQ,eAAe,CAAC,oBAAoB,EAAE,qBAAqB,CACnE,YAAW,WAAW,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAEnE;;OAEG;IACI,IAAI,SAAS;IAEpB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAa;IAEpD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,SAAS,CAA2B;IAEpD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,SAAS,CAA2B;IAEpD;;OAEG;;IAOH;;OAEG;IACI,IAAI;IAKX;;OAEG;IACU,eAAe,CAAC,UAAU,EAAE,MAAM;IAI/C;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM;IA2BvE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS;IAKlC;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS;IAKpC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS;IAOjC;;OAEG;IACH,SAAS,CAAC,UAAU;IAQpB;;OAEG;IACU,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAmB5C;;OAEG;IACU,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa;IAe/C;;OAEG;IACU,KAAK;IAUlB;;OAEG;IACH,IAAW,QAAQ,WAElB;CACF"}