@orchestr-sh/orchestr 1.7.4 → 1.9.1

package/dist/Cache/Repository.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * Repository
+ *
+ * High-level cache API that wraps a Store implementation.
+ * Provides convenience methods like remember(), pull(), has(),
+ * lock(), tags(), and TTL normalization.
+ *
+ * Mirrors Laravel's Illuminate\Cache\Repository.
+ *
+ * @example
+ * ```typescript
+ * const repo = new Repository(new ArrayStore());
+ *
+ * await repo.put('key', 'value', 3600);
+ * const value = await repo.get('key', 'default');
+ *
+ * const user = await repo.remember('user:1', 3600, async () => {
+ *   return await fetchUser(1);
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Repository = void 0;
+const CacheLock_1 = require("./Locks/CacheLock");
+const TaggedCache_1 = require("./Tags/TaggedCache");
+const TagSet_1 = require("./Tags/TagSet");
+class Repository {
+    store;
+    config;
+    defaultCacheTime = null;
+    storeName = '';
+    constructor(store, config = {}) {
+        this.store = store;
+        this.config = config;
+    }
+    /**
+     * Set the store name (used for events)
+     */
+    setStoreName(name) {
+        this.storeName = name;
+        return this;
+    }
+    async get(key, defaultValue) {
+        const value = await this.store.get(key);
+        if (value !== null && value !== undefined) {
+            return value;
+        }
+        if (typeof defaultValue === 'function') {
+            return defaultValue();
+        }
+        return defaultValue ?? null;
+    }
+    async many(keys) {
+        return this.store.many(keys);
+    }
+    async put(key, value, ttl) {
+        const seconds = this.getSeconds(ttl);
+        if (seconds === null) {
+            return this.forever(key, value);
+        }
+        if (seconds <= 0) {
+            return this.forget(key);
+        }
+        return this.store.put(key, value, seconds);
+    }
+    async putMany(values, ttl) {
+        const seconds = this.getSeconds(ttl) ?? 0;
+        return this.store.putMany(values, seconds);
+    }
+    async increment(key, value = 1) {
+        return this.store.increment(key, value);
+    }
+    async decrement(key, value = 1) {
+        return this.store.decrement(key, value);
+    }
+    async forever(key, value) {
+        return this.store.forever(key, value);
+    }
+    async forget(key) {
+        return this.store.forget(key);
+    }
+    async flush() {
+        return this.store.flush();
+    }
+    getPrefix() {
+        return this.store.getPrefix();
+    }
+    // --- High-level Repository methods ---
+    async has(key) {
+        const value = await this.store.get(key);
+        return value !== null && value !== undefined;
+    }
+    async missing(key) {
+        return !(await this.has(key));
+    }
+    async pull(key, defaultValue) {
+        const value = await this.get(key, defaultValue);
+        if (value !== null && value !== undefined && value !== defaultValue) {
+            await this.forget(key);
+        }
+        return value;
+    }
+    async add(key, value, ttl) {
+        if (await this.has(key)) {
+            return false;
+        }
+        return this.put(key, value, ttl);
+    }
+    async remember(key, ttl, callback) {
+        const value = await this.store.get(key);
+        if (value !== null && value !== undefined) {
+            return value;
+        }
+        const result = await callback();
+        const seconds = this.getSeconds(ttl);
+        if (seconds !== null && seconds > 0) {
+            await this.store.put(key, result, seconds);
+        }
+        else {
+            await this.store.forever(key, result);
+        }
+        return result;
+    }
+    async rememberForever(key, callback) {
+        const value = await this.store.get(key);
+        if (value !== null && value !== undefined) {
+            return value;
+        }
+        const result = await callback();
+        await this.store.forever(key, result);
+        return result;
+    }
+    async flexible(key, ttl, callback) {
+        const [freshTtl, staleTtl] = ttl;
+        // Try to get the cached value with its freshness
+        const metaKey = `${key}:flexible_meta`;
+        const value = await this.store.get(key);
+        const meta = await this.store.get(metaKey);
+        if (value !== null && value !== undefined) {
+            // Check if still fresh
+            if (meta && typeof meta === 'object' && meta.freshUntil) {
+                const now = Math.floor(Date.now() / 1000);
+                if (now < meta.freshUntil) {
+                    // Still fresh
+                    return value;
+                }
+                // Stale but within total TTL - revalidate in background
+                setImmediate(async () => {
+                    try {
+                        const newValue = await callback();
+                        const freshUntil = Math.floor(Date.now() / 1000) + freshTtl;
+                        await this.store.put(key, newValue, staleTtl);
+                        await this.store.put(metaKey, { freshUntil }, staleTtl);
+                    }
+                    catch {
+                        // Silently fail background refresh
+                    }
+                });
+                return value;
+            }
+        }
+        // Cache miss - fetch and store
+        const result = await callback();
+        const freshUntil = Math.floor(Date.now() / 1000) + freshTtl;
+        await this.store.put(key, result, staleTtl);
+        await this.store.put(metaKey, { freshUntil }, staleTtl);
+        return result;
+    }
+    // --- Locks ---
+    lock(name, seconds = 0, owner) {
+        return new CacheLock_1.CacheLock(this.store, name, seconds, owner);
+    }
+    restoreLock(name, owner) {
+        return new CacheLock_1.CacheLock(this.store, name, 0, owner);
+    }
+    // --- Tags ---
+    tags(names) {
+        const tagNames = Array.isArray(names) ? names : [names];
+        const tagSet = new TagSet_1.TagSet(this.store, tagNames);
+        return new TaggedCache_1.TaggedCache(this.store, tagSet);
+    }
+    // --- Accessors ---
+    getStore() {
+        return this.store;
+    }
+    getDefaultCacheTime() {
+        return this.defaultCacheTime;
+    }
+    setDefaultCacheTime(seconds) {
+        this.defaultCacheTime = seconds;
+        return this;
+    }
+    // --- TTL helpers ---
+    getSeconds(ttl) {
+        if (ttl === undefined || ttl === null) {
+            return this.defaultCacheTime;
+        }
+        if (ttl instanceof Date) {
+            const seconds = Math.floor((ttl.getTime() - Date.now()) / 1000);
+            return Math.max(0, seconds);
+        }
+        return ttl;
+    }
+}
+exports.Repository = Repository;
+//# sourceMappingURL=Repository.js.map

package/dist/Cache/Repository.js.map

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

package/dist/Cache/Stores/ArrayStore.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ArrayStore
+ *
+ * In-memory cache store. Perfect for testing and short-lived caching.
+ * Supports tags via TaggableStore.
+ *
+ * Mirrors Laravel's Illuminate\Cache\ArrayStore.
+ *
+ * @example
+ * ```typescript
+ * const store = new ArrayStore({ serialize: false }, 'app_');
+ * await store.put('key', 'value', 3600);
+ * const value = await store.get('key');
+ * ```
+ */
+import type { Store } from '../Contracts/Store';
+interface CacheEntry {
+    value: any;
+    expiration: number;
+}
+export declare class ArrayStore implements Store {
+    protected config: Record<string, any>;
+    protected prefix: string;
+    protected storage: Map<string, CacheEntry>;
+    protected shouldSerialize: boolean;
+    constructor(config?: Record<string, any>, prefix?: string);
+    get(key: string): Promise<any>;
+    many(keys: string[]): Promise<Record<string, any>>;
+    put(key: string, value: any, seconds: number): Promise<boolean>;
+    putMany(values: Record<string, any>, seconds: number): Promise<boolean>;
+    increment(key: string, value?: number): Promise<number | boolean>;
+    decrement(key: string, value?: number): Promise<number | boolean>;
+    forever(key: string, value: any): Promise<boolean>;
+    forget(key: string): Promise<boolean>;
+    flush(): Promise<boolean>;
+    getPrefix(): string;
+    protected prefixedKey(key: string): string;
+    protected isExpired(expiration: number): boolean;
+    protected currentTime(): number;
+    protected serialize(value: any): any;
+    protected unserialize(value: any): any;
+}
+export {};
+//# sourceMappingURL=ArrayStore.d.ts.map

package/dist/Cache/Stores/ArrayStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayStore.d.ts","sourceRoot":"","sources":["../../../src/Cache/Stores/ArrayStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,UAAU,UAAU;IAClB,KAAK,EAAE,GAAG,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAW,YAAW,KAAK;IAKpC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM;IAL1B,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IACvD,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC;gBAGvB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAChC,MAAM,GAAE,MAAW;IAKzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAc9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAQlD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY/D,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAgBpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAIpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAKhD,SAAS,CAAC,WAAW,IAAI,MAAM;IAI/B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IAIpC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;CAUvC"}

package/dist/Cache/Stores/ArrayStore.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * ArrayStore
+ *
+ * In-memory cache store. Perfect for testing and short-lived caching.
+ * Supports tags via TaggableStore.
+ *
+ * Mirrors Laravel's Illuminate\Cache\ArrayStore.
+ *
+ * @example
+ * ```typescript
+ * const store = new ArrayStore({ serialize: false }, 'app_');
+ * await store.put('key', 'value', 3600);
+ * const value = await store.get('key');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArrayStore = void 0;
+class ArrayStore {
+    config;
+    prefix;
+    storage = new Map();
+    shouldSerialize;
+    constructor(config = {}, prefix = '') {
+        this.config = config;
+        this.prefix = prefix;
+        this.shouldSerialize = config.serialize !== false;
+    }
+    async get(key) {
+        const prefixed = this.prefixedKey(key);
+        const entry = this.storage.get(prefixed);
+        if (!entry)
+            return null;
+        if (this.isExpired(entry.expiration)) {
+            this.storage.delete(prefixed);
+            return null;
+        }
+        return this.shouldSerialize ? this.unserialize(entry.value) : entry.value;
+    }
+    async many(keys) {
+        const result = {};
+        for (const key of keys) {
+            result[key] = await this.get(key);
+        }
+        return result;
+    }
+    async put(key, value, seconds) {
+        const prefixed = this.prefixedKey(key);
+        const stored = this.shouldSerialize ? this.serialize(value) : value;
+        this.storage.set(prefixed, {
+            value: stored,
+            expiration: seconds > 0 ? this.currentTime() + seconds : 0,
+        });
+        return true;
+    }
+    async putMany(values, seconds) {
+        for (const [key, value] of Object.entries(values)) {
+            await this.put(key, value, seconds);
+        }
+        return true;
+    }
+    async increment(key, value = 1) {
+        const current = await this.get(key);
+        const newValue = (typeof current === 'number' ? current : 0) + value;
+        const prefixed = this.prefixedKey(key);
+        const entry = this.storage.get(prefixed);
+        const expiration = entry ? entry.expiration : 0;
+        this.storage.set(prefixed, {
+            value: this.shouldSerialize ? this.serialize(newValue) : newValue,
+            expiration,
+        });
+        return newValue;
+    }
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+    async forever(key, value) {
+        return this.put(key, value, 0);
+    }
+    async forget(key) {
+        const prefixed = this.prefixedKey(key);
+        return this.storage.delete(prefixed);
+    }
+    async flush() {
+        this.storage.clear();
+        return true;
+    }
+    getPrefix() {
+        return this.prefix;
+    }
+    prefixedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    isExpired(expiration) {
+        if (expiration === 0)
+            return false;
+        return this.currentTime() >= expiration;
+    }
+    currentTime() {
+        return Math.floor(Date.now() / 1000);
+    }
+    serialize(value) {
+        return JSON.stringify(value);
+    }
+    unserialize(value) {
+        if (typeof value === 'string') {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                return value;
+            }
+        }
+        return value;
+    }
+}
+exports.ArrayStore = ArrayStore;
+//# sourceMappingURL=ArrayStore.js.map

package/dist/Cache/Stores/ArrayStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayStore.js","sourceRoot":"","sources":["../../../src/Cache/Stores/ArrayStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AASH,MAAa,UAAU;IAKT;IACA;IALF,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAC7C,eAAe,CAAU;IAEnC,YACY,SAA8B,EAAE,EAChC,SAAiB,EAAE;QADnB,WAAM,GAAN,MAAM,CAA0B;QAChC,WAAM,GAAN,MAAM,CAAa;QAE7B,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAc;QACvB,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAU,EAAE,OAAe;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEpE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;YACzB,KAAK,EAAE,MAAM;YACb,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;SAC3D,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAA2B,EAAE,OAAe;QACxD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,QAAgB,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAErE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;YACzB,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ;YACjE,UAAU;SACX,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,QAAgB,CAAC;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAU;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAES,WAAW,CAAC,GAAW;QAC/B,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAChC,CAAC;IAES,SAAS,CAAC,UAAkB;QACpC,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC;IAC1C,CAAC;IAES,WAAW;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAES,SAAS,CAAC,KAAU;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAES,WAAW,CAAC,KAAU;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AArHD,gCAqHC"}

package/dist/Cache/Stores/DatabaseStore.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DatabaseStore
+ *
+ * Database-backed cache store. Stores cache entries in a database table.
+ * Requires a `cache` table with columns: key (PK), value (text), expiration (int).
+ *
+ * Mirrors Laravel's Illuminate\Cache\DatabaseStore.
+ *
+ * @example
+ * ```typescript
+ * const store = new DatabaseStore({
+ *   driver: 'database',
+ *   connection: null,
+ *   table: 'cache',
+ * }, 'app_', application);
+ * ```
+ */
+import type { Store } from '../Contracts/Store';
+import type { Application } from '../../Foundation/Application';
+import type { Connection } from '../../Database/Connection';
+export declare class DatabaseStore implements Store {
+    protected config: Record<string, any>;
+    protected prefix: string;
+    protected app: Application;
+    protected tableName: string;
+    protected connectionName?: string;
+    constructor(config: Record<string, any>, prefix: string | undefined, app: Application);
+    protected getConnection(): Connection;
+    get(key: string): Promise<any>;
+    many(keys: string[]): Promise<Record<string, any>>;
+    put(key: string, value: any, seconds: number): Promise<boolean>;
+    putMany(values: Record<string, any>, seconds: number): Promise<boolean>;
+    increment(key: string, value?: number): Promise<number | boolean>;
+    decrement(key: string, value?: number): Promise<number | boolean>;
+    forever(key: string, value: any): Promise<boolean>;
+    forget(key: string): Promise<boolean>;
+    flush(): Promise<boolean>;
+    getPrefix(): string;
+    protected prefixedKey(key: string): string;
+    protected currentTime(): number;
+    protected serialize(value: any): string;
+    protected unserialize(value: string): any;
+}
+//# sourceMappingURL=DatabaseStore.d.ts.map

package/dist/Cache/Stores/DatabaseStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseStore.d.ts","sourceRoot":"","sources":["../../../src/Cache/Stores/DatabaseStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,qBAAa,aAAc,YAAW,KAAK;IAKvC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM;IACxB,SAAS,CAAC,GAAG,EAAE,WAAW;IAN5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBAGtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,EAAE,MAAM,YAAK,EACnB,GAAG,EAAE,WAAW;IAM5B,SAAS,CAAC,aAAa,IAAI,UAAU;IAK/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAoB9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAQlD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/D,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAuBpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAIpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAW/B,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI1C,SAAS,CAAC,WAAW,IAAI,MAAM;IAI/B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAIvC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG;CAO1C"}

package/dist/Cache/Stores/DatabaseStore.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * DatabaseStore
+ *
+ * Database-backed cache store. Stores cache entries in a database table.
+ * Requires a `cache` table with columns: key (PK), value (text), expiration (int).
+ *
+ * Mirrors Laravel's Illuminate\Cache\DatabaseStore.
+ *
+ * @example
+ * ```typescript
+ * const store = new DatabaseStore({
+ *   driver: 'database',
+ *   connection: null,
+ *   table: 'cache',
+ * }, 'app_', application);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseStore = void 0;
+class DatabaseStore {
+    config;
+    prefix;
+    app;
+    tableName;
+    connectionName;
+    constructor(config, prefix = '', app) {
+        this.config = config;
+        this.prefix = prefix;
+        this.app = app;
+        this.tableName = config.table || 'cache';
+        this.connectionName = config.connection || undefined;
+    }
+    getConnection() {
+        const db = this.app.make('db');
+        return db.connection(this.connectionName);
+    }
+    async get(key) {
+        const prefixed = this.prefixedKey(key);
+        const conn = this.getConnection();
+        const now = this.currentTime();
+        const row = await conn.table(this.tableName)
+            .where('key', '=', prefixed)
+            .first();
+        if (!row)
+            return null;
+        // Check expiration
+        if (row.expiration !== 0 && now >= row.expiration) {
+            await this.forget(key);
+            return null;
+        }
+        return this.unserialize(row.value);
+    }
+    async many(keys) {
+        const result = {};
+        for (const key of keys) {
+            result[key] = await this.get(key);
+        }
+        return result;
+    }
+    async put(key, value, seconds) {
+        const prefixed = this.prefixedKey(key);
+        const serialized = this.serialize(value);
+        const expiration = seconds > 0 ? this.currentTime() + seconds : 0;
+        const conn = this.getConnection();
+        try {
+            // Try update first
+            const existing = await conn.table(this.tableName)
+                .where('key', '=', prefixed)
+                .first();
+            if (existing) {
+                await conn.table(this.tableName)
+                    .where('key', '=', prefixed)
+                    .update({ value: serialized, expiration });
+            }
+            else {
+                await conn.table(this.tableName)
+                    .insert({ key: prefixed, value: serialized, expiration });
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async putMany(values, seconds) {
+        let success = true;
+        for (const [key, value] of Object.entries(values)) {
+            if (!(await this.put(key, value, seconds))) {
+                success = false;
+            }
+        }
+        return success;
+    }
+    async increment(key, value = 1) {
+        const current = await this.get(key);
+        const newValue = (typeof current === 'number' ? current : 0) + value;
+        const prefixed = this.prefixedKey(key);
+        const conn = this.getConnection();
+        const existing = await conn.table(this.tableName)
+            .where('key', '=', prefixed)
+            .first();
+        if (existing) {
+            await conn.table(this.tableName)
+                .where('key', '=', prefixed)
+                .update({ value: this.serialize(newValue) });
+        }
+        else {
+            await conn.table(this.tableName)
+                .insert({ key: prefixed, value: this.serialize(newValue), expiration: 0 });
+        }
+        return newValue;
+    }
+    async decrement(key, value = 1) {
+        return this.increment(key, -value);
+    }
+    async forever(key, value) {
+        return this.put(key, value, 0);
+    }
+    async forget(key) {
+        const prefixed = this.prefixedKey(key);
+        const conn = this.getConnection();
+        try {
+            await conn.table(this.tableName)
+                .where('key', '=', prefixed)
+                .delete();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async flush() {
+        const conn = this.getConnection();
+        try {
+            await conn.table(this.tableName).delete();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    getPrefix() {
+        return this.prefix;
+    }
+    prefixedKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    currentTime() {
+        return Math.floor(Date.now() / 1000);
+    }
+    serialize(value) {
+        return JSON.stringify(value);
+    }
+    unserialize(value) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+}
+exports.DatabaseStore = DatabaseStore;
+//# sourceMappingURL=DatabaseStore.js.map

package/dist/Cache/Stores/DatabaseStore.js.map

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

package/dist/Cache/Stores/FileStore.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FileStore
+ *
+ * File-based cache store. Stores each cache entry as a JSON file
+ * on the filesystem, organized by a two-character hash prefix.
+ *
+ * Mirrors Laravel's Illuminate\Cache\FileStore.
+ *
+ * @example
+ * ```typescript
+ * const store = new FileStore({
+ *   driver: 'file',
+ *   path: 'storage/framework/cache/data',
+ * }, 'app_');
+ * ```
+ */
+import type { Store } from '../Contracts/Store';
+export declare class FileStore implements Store {
+    protected config: Record<string, any>;
+    protected prefix: string;
+    protected cachePath: string;
+    constructor(config: Record<string, any>, prefix?: string);
+    get(key: string): Promise<any>;
+    many(keys: string[]): Promise<Record<string, any>>;
+    put(key: string, value: any, seconds: number): Promise<boolean>;
+    putMany(values: Record<string, any>, seconds: number): Promise<boolean>;
+    increment(key: string, value?: number): Promise<number | boolean>;
+    decrement(key: string, value?: number): Promise<number | boolean>;
+    forever(key: string, value: any): Promise<boolean>;
+    forget(key: string): Promise<boolean>;
+    flush(): Promise<boolean>;
+    getPrefix(): string;
+    /**
+     * Get the full file path for a cache key
+     */
+    protected path(key: string): string;
+    /**
+     * Get the hashed key
+     */
+    protected hash(key: string): string;
+    /**
+     * Read and validate the cache payload
+     */
+    protected getPayload(key: string): Promise<any>;
+    protected ensureDirectory(dir: string): Promise<void>;
+    protected currentTime(): number;
+    protected serialize(value: any): any;
+    protected unserialize(value: any): any;
+}
+//# sourceMappingURL=FileStore.d.ts.map

package/dist/Cache/Stores/FileStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileStore.d.ts","sourceRoot":"","sources":["../../../src/Cache/Stores/FileStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qBAAa,SAAU,YAAW,KAAK;IAInC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM;IAJ1B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;gBAGhB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,MAAM,GAAE,MAAW;IAKzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAI9B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAQlD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB/D,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAOpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAIpE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAU/B,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQnC;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;cACa,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;cAmBrC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,SAAS,CAAC,WAAW,IAAI,MAAM;IAI/B,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IAIpC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;CAUvC"}