@shohaghinfo/aerojs 0.1.0

package/dist/cache/cache-manager.js

@@ -0,0 +1,160 @@
+/**
+ * @file cache-manager.ts
+ * @description Manages cache drivers and provides high-level cache operations.
+ */
+import { MemoryCacheDriver } from './drivers/memory-cache-driver.js';
+import crypto from 'node:crypto';
+export class CacheManager {
+    drivers = new Map();
+    defaultDriverName = 'memory';
+    constructor() {
+        this.drivers.set('memory', new MemoryCacheDriver());
+    }
+    extend(name, driver) {
+        this.drivers.set(name, driver);
+    }
+    store(name) {
+        const target = name || this.defaultDriverName;
+        const driver = this.drivers.get(target);
+        if (!driver) {
+            throw new Error(`Cache driver [${target}] is not configured.`);
+        }
+        return driver;
+    }
+    async get(key) {
+        return this.store().get(key);
+    }
+    async set(key, value, ttlSeconds) {
+        return this.store().set(key, value, ttlSeconds);
+    }
+    async has(key) {
+        return this.store().has(key);
+    }
+    async delete(key) {
+        return this.store().delete(key);
+    }
+    async clear() {
+        return this.store().clear();
+    }
+    async getMany(keys) {
+        return this.store().getMany(keys);
+    }
+    async setMany(entries, ttlSeconds) {
+        return this.store().setMany(entries, ttlSeconds);
+    }
+    async increment(key, value) {
+        return this.store().increment(key, value);
+    }
+    async decrement(key, value) {
+        return this.store().decrement(key, value);
+    }
+    inflightPromises = new Map();
+    /**
+     * Remember an item in the cache, computing it if missing. Prevent race conditions by holding a single Promise.
+     */
+    async remember(key, ttlSeconds, callback) {
+        const existing = await this.get(key);
+        if (existing !== null) {
+            return existing;
+        }
+        if (this.inflightPromises.has(key)) {
+            return this.inflightPromises.get(key);
+        }
+        const promise = (async () => {
+            try {
+                const value = await callback();
+                await this.set(key, value, ttlSeconds);
+                return value;
+            }
+            finally {
+                this.inflightPromises.delete(key);
+            }
+        })();
+        this.inflightPromises.set(key, promise);
+        return promise;
+    }
+    /**
+     * Tagged cache. Implemented via namespacing.
+     */
+    tags(names) {
+        const getTagKeys = async () => {
+            const keys = [];
+            for (const name of names) {
+                let tagVersion = await this.get(`tag:${name}:version`);
+                if (!tagVersion) {
+                    tagVersion = 1;
+                    await this.set(`tag:${name}:version`, tagVersion);
+                }
+                keys.push(`tag:${name}:${tagVersion}`);
+            }
+            return keys.join('|') + ':';
+        };
+        return {
+            set: async (key, value, ttlSeconds) => {
+                const prefix = await getTagKeys();
+                await this.set(prefix + key, value, ttlSeconds);
+            },
+            get: async (key) => {
+                const prefix = await getTagKeys();
+                return this.get(prefix + key);
+            },
+            has: async (key) => {
+                const prefix = await getTagKeys();
+                return this.has(prefix + key);
+            },
+            remember: async (key, ttlSeconds, callback) => {
+                const prefix = await getTagKeys();
+                return this.remember(prefix + key, ttlSeconds, callback);
+            },
+            flush: async () => {
+                for (const name of names) {
+                    await this.increment(`tag:${name}:version`);
+                }
+            }
+        };
+    }
+    /**
+     * Atomic execution lock.
+     */
+    lock(name, seconds) {
+        return {
+            get: async (callback) => {
+                const lockKey = `lock:${name}`;
+                // Using inflightPromises to hold the local lock token synchronously
+                if (this.inflightPromises.has(lockKey))
+                    return null;
+                // Reserve the local lock immediately
+                let resolveLock;
+                const lockToken = new Promise(res => { resolveLock = res; });
+                this.inflightPromises.set(lockKey, lockToken);
+                let acquired = false;
+                // Use a unique token so we can verify we acquired the lock in distributed setups
+                const uniqueToken = crypto.randomUUID ? crypto.randomUUID() : Math.random().toString(36).substring(2, 15);
+                try {
+                    // Check remote lock
+                    const hasLock = await this.has(lockKey);
+                    if (hasLock)
+                        return null; // Lock is currently held
+                    await this.set(lockKey, uniqueToken, seconds);
+                    // Double check to narrow race condition window for distributed contexts
+                    const verifyLock = await this.get(lockKey);
+                    if (verifyLock !== uniqueToken)
+                        return null;
+                    acquired = true;
+                    const res = await callback();
+                    return res;
+                }
+                finally {
+                    if (acquired) {
+                        await this.delete(lockKey);
+                    }
+                    resolveLock();
+                    this.inflightPromises.delete(lockKey);
+                }
+            }
+        };
+    }
+}
+// Global static façade instance
+export const Cache = new CacheManager();
+//# sourceMappingURL=cache-manager.js.map

package/dist/cache/cache-manager.js.map

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

package/dist/cache/drivers/database-cache-driver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file database-cache-driver.ts
+ * @description Database backed CacheDriver utilizing AeroJS QueryBuilder.
+ */
+import type { CacheDriver } from '../cache-driver.js';
+export declare class DatabaseCacheDriver implements CacheDriver {
+    private tableName;
+    get<T = any>(key: string): Promise<T | null>;
+    set(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getMany(keys: string[]): Promise<Record<string, any>>;
+    setMany(entries: Record<string, any>, ttlSeconds?: number): Promise<void>;
+    increment(key: string, value?: number): Promise<number>;
+    decrement(key: string, value?: number): Promise<number>;
+}
+//# sourceMappingURL=database-cache-driver.d.ts.map

package/dist/cache/drivers/database-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/database-cache-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,SAAS,CAAgB;IAEpB,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiB5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWrD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhE"}

package/dist/cache/drivers/database-cache-driver.js

@@ -0,0 +1,77 @@
+/**
+ * @file database-cache-driver.ts
+ * @description Database backed CacheDriver utilizing AeroJS QueryBuilder.
+ */
+import { DB } from '../../database/index.js';
+export class DatabaseCacheDriver {
+    tableName = 'aero_cache';
+    async get(key) {
+        try {
+            const row = await DB.table(this.tableName).where('key', key).first();
+            if (!row)
+                return null;
+            const expiration = row.expiration;
+            if (expiration !== null && expiration <= Date.now()) {
+                await this.delete(key);
+                return null;
+            }
+            return JSON.parse(row.value);
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        const expiration = ttlSeconds ? Date.now() + ttlSeconds * 1000 : null;
+        const serializedValue = JSON.stringify(value);
+        const exists = await DB.table(this.tableName).where('key', key).first();
+        if (exists) {
+            await DB.table(this.tableName).where('key', key).update({
+                value: serializedValue,
+                expiration,
+            });
+        }
+        else {
+            await DB.table(this.tableName).insert({
+                key,
+                value: serializedValue,
+                expiration,
+            });
+        }
+    }
+    async has(key) {
+        return (await this.get(key)) !== null;
+    }
+    async delete(key) {
+        const result = await DB.table(this.tableName).where('key', key).delete();
+        return result > 0;
+    }
+    async clear() {
+        await DB.table(this.tableName).delete();
+    }
+    async getMany(keys) {
+        const result = {};
+        for (const key of keys) {
+            const val = await this.get(key);
+            if (val !== null) {
+                result[key] = val;
+            }
+        }
+        return result;
+    }
+    async setMany(entries, ttlSeconds) {
+        for (const [key, value] of Object.entries(entries)) {
+            await this.set(key, value, ttlSeconds);
+        }
+    }
+    async increment(key, value = 1) {
+        const current = await this.get(key) || 0;
+        const newValue = Number(current) + value;
+        await this.set(key, newValue);
+        return newValue;
+    }
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+}
+//# sourceMappingURL=database-cache-driver.js.map

package/dist/cache/drivers/database-cache-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-cache-driver.js","sourceRoot":"","sources":["../../../src/cache/drivers/database-cache-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAG7C,MAAM,OAAO,mBAAmB;IACtB,SAAS,GAAG,YAAY,CAAC;IAE1B,KAAK,CAAC,GAAG,CAAU,GAAW;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;YACrE,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YAEtB,MAAM,UAAU,GAAG,GAAG,CAAC,UAA2B,CAAC;YACnD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBACpD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAe,CAAM,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,UAAmB;QAC3D,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE9C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;QAExE,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;gBACtD,KAAK,EAAE,eAAe;gBACtB,UAAU;aACX,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;gBACpC,GAAG;gBACH,KAAK,EAAE,eAAe;gBACtB,UAAU;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAW;QAC1B,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAAW;QAC7B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;QACzE,OAAO,MAAM,GAAG,CAAC,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAc;QACjC,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAA4B,EAAE,UAAmB;QACpE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAS,GAAG,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QACzC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+/**
+ * @file file-cache-driver.ts
+ * @description File system backed CacheDriver storing cache in JSON files.
+ */
+import type { CacheDriver } from '../cache-driver.js';
+export declare class FileCacheDriver implements CacheDriver {
+    private cacheDir;
+    constructor(cacheDir?: string);
+    private ensureDir;
+    private getFilePath;
+    get<T = any>(key: string): Promise<T | null>;
+    set(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getMany(keys: string[]): Promise<Record<string, any>>;
+    setMany(entries: Record<string, any>, ttlSeconds?: number): Promise<void>;
+    increment(key: string, value?: number): Promise<number>;
+    decrement(key: string, value?: number): Promise<number>;
+}
+//# sourceMappingURL=file-cache-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache-driver.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/file-cache-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,SAAkB;YAIxB,SAAS;IAQvB,OAAO,CAAC,WAAW;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAiB5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWrD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhE"}

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

@@ -0,0 +1,95 @@
+/**
+ * @file file-cache-driver.ts
+ * @description File system backed CacheDriver storing cache in JSON files.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+export class FileCacheDriver {
+    cacheDir;
+    constructor(cacheDir = 'storage/cache') {
+        this.cacheDir = path.resolve(process.cwd(), cacheDir);
+    }
+    async ensureDir() {
+        try {
+            await fs.access(this.cacheDir);
+        }
+        catch {
+            await fs.mkdir(this.cacheDir, { recursive: true });
+        }
+    }
+    getFilePath(key) {
+        const hash = crypto.createHash('sha256').update(key).digest('hex');
+        return path.join(this.cacheDir, `${hash}.json`);
+    }
+    async get(key) {
+        try {
+            const filePath = this.getFilePath(key);
+            const data = await fs.readFile(filePath, 'utf-8');
+            const entry = JSON.parse(data);
+            if (entry.expiresAt !== null && entry.expiresAt <= Date.now()) {
+                await this.delete(key);
+                return null;
+            }
+            return entry.value;
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        await this.ensureDir();
+        const filePath = this.getFilePath(key);
+        const expiresAt = ttlSeconds ? Date.now() + ttlSeconds * 1000 : null;
+        const entry = { value, expiresAt };
+        await fs.writeFile(filePath, JSON.stringify(entry), 'utf-8');
+    }
+    async has(key) {
+        return (await this.get(key)) !== null;
+    }
+    async delete(key) {
+        try {
+            const filePath = this.getFilePath(key);
+            await fs.unlink(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async clear() {
+        try {
+            await this.ensureDir();
+            const files = await fs.readdir(this.cacheDir);
+            await Promise.all(files.map(file => fs.unlink(path.join(this.cacheDir, file)).catch(() => { })));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    async getMany(keys) {
+        const result = {};
+        for (const key of keys) {
+            const val = await this.get(key);
+            if (val !== null) {
+                result[key] = val;
+            }
+        }
+        return result;
+    }
+    async setMany(entries, ttlSeconds) {
+        for (const [key, value] of Object.entries(entries)) {
+            await this.set(key, value, ttlSeconds);
+        }
+    }
+    async increment(key, value = 1) {
+        const current = await this.get(key) || 0;
+        const newValue = Number(current) + value;
+        await this.set(key, newValue);
+        return newValue;
+    }
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+}
+//# sourceMappingURL=file-cache-driver.js.map

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

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

package/dist/cache/drivers/memory-cache-driver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file memory-cache-driver.ts
+ * @description In-memory CacheDriver with LRU eviction and TTL.
+ */
+import type { CacheDriver } from '../cache-driver.js';
+export declare class MemoryCacheDriver implements CacheDriver {
+    private store;
+    private maxSize;
+    constructor(maxSize?: number);
+    private isExpired;
+    get<T = any>(key: string): Promise<T | null>;
+    set(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getMany(keys: string[]): Promise<Record<string, any>>;
+    setMany(entries: Record<string, any>, ttlSeconds?: number): Promise<void>;
+    increment(key: string, value?: number): Promise<number>;
+    decrement(key: string, value?: number): Promise<number>;
+}
+//# sourceMappingURL=memory-cache-driver.d.ts.map

package/dist/cache/drivers/memory-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache-driver.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/memory-cache-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,SAAO;IAI1B,OAAO,CAAC,SAAS;IAIJ,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAgB5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAehE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWrD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhE"}

package/dist/cache/drivers/memory-cache-driver.js

@@ -0,0 +1,82 @@
+/**
+ * @file memory-cache-driver.ts
+ * @description In-memory CacheDriver with LRU eviction and TTL.
+ */
+export class MemoryCacheDriver {
+    store = new Map();
+    maxSize;
+    constructor(maxSize = 1000) {
+        this.maxSize = maxSize;
+    }
+    isExpired(entry) {
+        return entry.expiresAt !== null && entry.expiresAt <= Date.now();
+    }
+    async get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        if (this.isExpired(entry)) {
+            this.store.delete(key);
+            return null;
+        }
+        // Refresh LRU
+        this.store.delete(key);
+        this.store.set(key, entry);
+        return entry.value;
+    }
+    async set(key, value, ttlSeconds) {
+        if (this.store.has(key)) {
+            this.store.delete(key);
+        }
+        else if (this.store.size >= this.maxSize) {
+            // Evict oldest (Map iterates in insertion order)
+            const oldestKey = this.store.keys().next().value;
+            if (oldestKey) {
+                this.store.delete(oldestKey);
+            }
+        }
+        const expiresAt = ttlSeconds ? Date.now() + ttlSeconds * 1000 : null;
+        this.store.set(key, { value, expiresAt });
+    }
+    async has(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            this.store.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async delete(key) {
+        return this.store.delete(key);
+    }
+    async clear() {
+        this.store.clear();
+    }
+    async getMany(keys) {
+        const result = {};
+        for (const key of keys) {
+            const val = await this.get(key);
+            if (val !== null) {
+                result[key] = val;
+            }
+        }
+        return result;
+    }
+    async setMany(entries, ttlSeconds) {
+        for (const [key, value] of Object.entries(entries)) {
+            await this.set(key, value, ttlSeconds);
+        }
+    }
+    async increment(key, value = 1) {
+        const current = await this.get(key) || 0;
+        const newValue = Number(current) + value;
+        await this.set(key, newValue);
+        return newValue;
+    }
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+}
+//# sourceMappingURL=memory-cache-driver.js.map

package/dist/cache/drivers/memory-cache-driver.js.map

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

package/dist/cache/drivers/redis-cache-driver.d.ts

@@ -0,0 +1,18 @@
+import type { CacheDriver } from '../cache-driver.js';
+import { RedisClient } from '../../redis/redis-client.js';
+export declare class RedisCacheDriver implements CacheDriver {
+    private client;
+    private prefix;
+    constructor(client: RedisClient, prefix?: string);
+    private key;
+    get<T = any>(key: string): Promise<T | null>;
+    set(key: string, value: any, ttlSeconds?: number): Promise<void>;
+    has(key: string): Promise<boolean>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    getMany(keys: string[]): Promise<Record<string, any>>;
+    setMany(entries: Record<string, any>, ttlSeconds?: number): Promise<void>;
+    increment(key: string, value?: number): Promise<number>;
+    decrement(key: string, value?: number): Promise<number>;
+}
+//# sourceMappingURL=redis-cache-driver.d.ts.map

package/dist/cache/drivers/redis-cache-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-cache-driver.d.ts","sourceRoot":"","sources":["../../../src/cache/drivers/redis-cache-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,WAAW,EAAE,MAAM,SAAW;IAKlD,OAAO,CAAC,GAAG;IAIE,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAmBrD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAMhE"}

package/dist/cache/drivers/redis-cache-driver.js

@@ -0,0 +1,95 @@
+import { RedisClient } from '../../redis/redis-client.js';
+export class RedisCacheDriver {
+    client;
+    prefix;
+    constructor(client, prefix = 'cache:') {
+        this.client = client;
+        this.prefix = prefix;
+    }
+    key(k) {
+        return `${this.prefix}${k}`;
+    }
+    async get(key) {
+        const res = await this.client.get(this.key(key));
+        if (!res)
+            return null;
+        try {
+            return JSON.parse(res);
+        }
+        catch {
+            return res;
+        }
+    }
+    async set(key, value, ttlSeconds) {
+        const payload = JSON.stringify(value);
+        if (ttlSeconds && ttlSeconds > 0) {
+            await this.client.setex(this.key(key), ttlSeconds, payload);
+        }
+        else {
+            await this.client.set(this.key(key), payload);
+        }
+    }
+    async has(key) {
+        const exists = await this.client.exists(this.key(key));
+        return exists === 1;
+    }
+    async delete(key) {
+        const deleted = await this.client.del(this.key(key));
+        return deleted > 0;
+    }
+    async clear() {
+        // In a real world scenario, you'd use SCAN to find keys matching the prefix and DEL them.
+        // For simplicity, we flush the whole DB.
+        await this.client.flushdb();
+    }
+    async getMany(keys) {
+        if (keys.length === 0)
+            return {};
+        const prefixedKeys = keys.map((k) => this.key(k));
+        const results = await this.client.mget(...prefixedKeys);
+        const record = {};
+        for (let i = 0; i < keys.length; i++) {
+            const val = results[i];
+            if (val !== null) {
+                try {
+                    record[keys[i] || ""] = JSON.parse(val);
+                }
+                catch {
+                    record[keys[i] || ""] = val;
+                }
+            }
+        }
+        return record;
+    }
+    async setMany(entries, ttlSeconds) {
+        const itemsToSet = {};
+        for (const [k, v] of Object.entries(entries)) {
+            itemsToSet[this.key(k)] = JSON.stringify(v);
+        }
+        if (!ttlSeconds) {
+            await this.client.mset(itemsToSet);
+        }
+        else {
+            // Redis MSET doesn't support TTL, so we use pipeline or loop.
+            // We will loop with setex for simplicity since we don't have a native MULTI pipeline yet.
+            const promises = [];
+            for (const [k, v] of Object.entries(itemsToSet)) {
+                promises.push(this.client.setex(k, ttlSeconds, v));
+            }
+            await Promise.all(promises);
+        }
+    }
+    async increment(key, value = 1) {
+        if (value === 1) {
+            return this.client.incr(this.key(key));
+        }
+        return this.client.incrby(this.key(key), value);
+    }
+    async decrement(key, value = 1) {
+        if (value === 1) {
+            return this.client.decr(this.key(key));
+        }
+        return this.client.decrby(this.key(key), value);
+    }
+}
+//# sourceMappingURL=redis-cache-driver.js.map

package/dist/cache/drivers/redis-cache-driver.js.map

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