@orchestr-sh/orchestr 1.7.4 → 1.9.1

package/dist/Cache/CacheManager.d.ts

@@ -0,0 +1,109 @@
+/**
+ * CacheManager
+ *
+ * Manages multiple cache store connections.
+ * Follows the Manager pattern established by DatabaseManager and QueueManager.
+ *
+ * Mirrors Laravel's Illuminate\Cache\CacheManager.
+ *
+ * @example
+ * ```typescript
+ * const manager = new CacheManager({
+ *   default: 'file',
+ *   prefix: 'app_',
+ *   stores: {
+ *     file: { driver: 'file', path: 'storage/cache' },
+ *     array: { driver: 'array' },
+ *     database: { driver: 'database', table: 'cache' },
+ *   },
+ * });
+ *
+ * // Use default store
+ * const repo = manager.store();
+ * await repo.put('key', 'value', 3600);
+ *
+ * // Use specific store
+ * const redis = manager.store('redis');
+ * ```
+ */
+import type { Store } from './Contracts/Store';
+import { Repository } from './Repository';
+export interface StoreConfig {
+    driver: string;
+    [key: string]: any;
+}
+export interface CacheConfig {
+    default: string;
+    prefix: string;
+    stores: Record<string, StoreConfig>;
+}
+export type StoreFactory = (config: StoreConfig) => Store;
+export declare class CacheManager {
+    protected config: CacheConfig;
+    protected stores: Map<string, Repository>;
+    protected driverFactories: Map<string, StoreFactory>;
+    constructor(config: CacheConfig);
+    /**
+     * Register a cache store driver factory
+     */
+    registerDriver(name: string, factory: StoreFactory): void;
+    /**
+     * Get a cache store instance by name
+     */
+    store(name?: string): Repository;
+    /**
+     * Create a new cache store instance
+     */
+    protected createStore(name: string): Repository;
+    /**
+     * Extend the manager with a custom driver
+     */
+    extend(driver: string, factory: StoreFactory): void;
+    /**
+     * Get the default store name
+     */
+    getDefaultDriver(): string;
+    /**
+     * Set the default store name
+     */
+    setDefaultDriver(name: string): void;
+    /**
+     * Get the cache prefix
+     */
+    getPrefix(): string;
+    /**
+     * Get all configured store names
+     */
+    getStoreNames(): string[];
+    /**
+     * Get the store configuration
+     */
+    getStoreConfig(name?: string): StoreConfig;
+    /**
+     * Get the full configuration
+     */
+    getConfig(): CacheConfig;
+    /**
+     * Purge a store from the cache (remove the cached instance)
+     */
+    purge(name?: string): void;
+    /**
+     * Purge all cached store instances
+     */
+    purgeAll(): void;
+    get(key: string, defaultValue?: any): Promise<any>;
+    put(key: string, value: any, ttl?: number | Date): Promise<boolean>;
+    has(key: string): Promise<boolean>;
+    forget(key: string): Promise<boolean>;
+    flush(): Promise<boolean>;
+    remember(key: string, ttl: number | Date, callback: () => any | Promise<any>): Promise<any>;
+    rememberForever(key: string, callback: () => any | Promise<any>): Promise<any>;
+    forever(key: string, value: any): Promise<boolean>;
+    pull(key: string, defaultValue?: any): Promise<any>;
+    many(keys: string[]): Promise<Record<string, any>>;
+    putMany(values: Record<string, any>, ttl?: number | Date): Promise<boolean>;
+    increment(key: string, value?: number): Promise<number | boolean>;
+    decrement(key: string, value?: number): Promise<number | boolean>;
+    add(key: string, value: any, ttl?: number | Date): Promise<boolean>;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/Cache/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/Cache/CacheManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAE1D,qBAAa,YAAY;IAIX,SAAS,CAAC,MAAM,EAAE,WAAW;IAHzC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IACtD,SAAS,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAa;gBAE3C,MAAM,EAAE,WAAW;IAEzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIzD;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU;IAahC;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAuB/C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAInD;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAW1C;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMV,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAIlD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAI3F,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAI9E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAInD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAIlD,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAIjE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;IAIjE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;CAG1E"}

package/dist/Cache/CacheManager.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * CacheManager
+ *
+ * Manages multiple cache store connections.
+ * Follows the Manager pattern established by DatabaseManager and QueueManager.
+ *
+ * Mirrors Laravel's Illuminate\Cache\CacheManager.
+ *
+ * @example
+ * ```typescript
+ * const manager = new CacheManager({
+ *   default: 'file',
+ *   prefix: 'app_',
+ *   stores: {
+ *     file: { driver: 'file', path: 'storage/cache' },
+ *     array: { driver: 'array' },
+ *     database: { driver: 'database', table: 'cache' },
+ *   },
+ * });
+ *
+ * // Use default store
+ * const repo = manager.store();
+ * await repo.put('key', 'value', 3600);
+ *
+ * // Use specific store
+ * const redis = manager.store('redis');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheManager = void 0;
+const Repository_1 = require("./Repository");
+class CacheManager {
+    config;
+    stores = new Map();
+    driverFactories = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Register a cache store driver factory
+     */
+    registerDriver(name, factory) {
+        this.driverFactories.set(name, factory);
+    }
+    /**
+     * Get a cache store instance by name
+     */
+    store(name) {
+        const storeName = name || this.config.default;
+        if (this.stores.has(storeName)) {
+            return this.stores.get(storeName);
+        }
+        const repository = this.createStore(storeName);
+        this.stores.set(storeName, repository);
+        return repository;
+    }
+    /**
+     * Create a new cache store instance
+     */
+    createStore(name) {
+        const storeConfig = this.config.stores[name];
+        if (!storeConfig) {
+            throw new Error(`Cache store [${name}] not configured.`);
+        }
+        const factory = this.driverFactories.get(storeConfig.driver);
+        if (!factory) {
+            throw new Error(`Cache driver [${storeConfig.driver}] not registered. ` +
+                `Available drivers: ${Array.from(this.driverFactories.keys()).join(', ')}`);
+        }
+        const store = factory(storeConfig);
+        const repository = new Repository_1.Repository(store, storeConfig);
+        repository.setStoreName(name);
+        return repository;
+    }
+    /**
+     * Extend the manager with a custom driver
+     */
+    extend(driver, factory) {
+        this.registerDriver(driver, factory);
+    }
+    /**
+     * Get the default store name
+     */
+    getDefaultDriver() {
+        return this.config.default;
+    }
+    /**
+     * Set the default store name
+     */
+    setDefaultDriver(name) {
+        this.config.default = name;
+    }
+    /**
+     * Get the cache prefix
+     */
+    getPrefix() {
+        return this.config.prefix;
+    }
+    /**
+     * Get all configured store names
+     */
+    getStoreNames() {
+        return Object.keys(this.config.stores);
+    }
+    /**
+     * Get the store configuration
+     */
+    getStoreConfig(name) {
+        const storeName = name || this.config.default;
+        const config = this.config.stores[storeName];
+        if (!config) {
+            throw new Error(`Cache store [${storeName}] not configured.`);
+        }
+        return config;
+    }
+    /**
+     * Get the full configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Purge a store from the cache (remove the cached instance)
+     */
+    purge(name) {
+        const storeName = name || this.config.default;
+        this.stores.delete(storeName);
+    }
+    /**
+     * Purge all cached store instances
+     */
+    purgeAll() {
+        this.stores.clear();
+    }
+    // --- Proxy methods to default store for convenience ---
+    async get(key, defaultValue) {
+        return this.store().get(key, defaultValue);
+    }
+    async put(key, value, ttl) {
+        return this.store().put(key, value, ttl);
+    }
+    async has(key) {
+        return this.store().has(key);
+    }
+    async forget(key) {
+        return this.store().forget(key);
+    }
+    async flush() {
+        return this.store().flush();
+    }
+    async remember(key, ttl, callback) {
+        return this.store().remember(key, ttl, callback);
+    }
+    async rememberForever(key, callback) {
+        return this.store().rememberForever(key, callback);
+    }
+    async forever(key, value) {
+        return this.store().forever(key, value);
+    }
+    async pull(key, defaultValue) {
+        return this.store().pull(key, defaultValue);
+    }
+    async many(keys) {
+        return this.store().many(keys);
+    }
+    async putMany(values, ttl) {
+        return this.store().putMany(values, ttl);
+    }
+    async increment(key, value) {
+        return this.store().increment(key, value);
+    }
+    async decrement(key, value) {
+        return this.store().decrement(key, value);
+    }
+    async add(key, value, ttl) {
+        return this.store().add(key, value, ttl);
+    }
+}
+exports.CacheManager = CacheManager;
+//# sourceMappingURL=CacheManager.js.map

package/dist/Cache/CacheManager.js.map

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

package/dist/Cache/CacheServiceProvider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CacheServiceProvider
+ *
+ * Registers cache services into the container.
+ * Mirrors Laravel's Illuminate\Cache\CacheServiceProvider.
+ */
+import { ServiceProvider } from '../Foundation/ServiceProvider';
+import type { CacheConfig } from './CacheManager';
+export declare class CacheServiceProvider extends ServiceProvider {
+    /**
+     * Register cache services
+     */
+    register(): void;
+    /**
+     * Get the cache configuration
+     */
+    protected getConfig(): CacheConfig;
+}
+//# sourceMappingURL=CacheServiceProvider.d.ts.map

package/dist/Cache/CacheServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheServiceProvider.d.ts","sourceRoot":"","sources":["../../src/Cache/CacheServiceProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAMlD,qBAAa,oBAAqB,SAAQ,eAAe;IACvD;;OAEG;IACH,QAAQ,IAAI,IAAI;IA+BhB;;OAEG;IACH,SAAS,CAAC,SAAS,IAAI,WAAW;CA8BnC"}

package/dist/Cache/CacheServiceProvider.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * CacheServiceProvider
+ *
+ * Registers cache services into the container.
+ * Mirrors Laravel's Illuminate\Cache\CacheServiceProvider.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheServiceProvider = void 0;
+const ServiceProvider_1 = require("../Foundation/ServiceProvider");
+const CacheManager_1 = require("./CacheManager");
+const ArrayStore_1 = require("./Stores/ArrayStore");
+const FileStore_1 = require("./Stores/FileStore");
+const DatabaseStore_1 = require("./Stores/DatabaseStore");
+const NullStore_1 = require("./Stores/NullStore");
+class CacheServiceProvider extends ServiceProvider_1.ServiceProvider {
+    /**
+     * Register cache services
+     */
+    register() {
+        this.app.singleton('cache', () => {
+            const config = this.getConfig();
+            const manager = new CacheManager_1.CacheManager(config);
+            // Register built-in drivers
+            manager.registerDriver('array', (storeConfig) => new ArrayStore_1.ArrayStore(storeConfig, config.prefix));
+            manager.registerDriver('file', (storeConfig) => new FileStore_1.FileStore(storeConfig, config.prefix));
+            manager.registerDriver('database', (storeConfig) => new DatabaseStore_1.DatabaseStore(storeConfig, config.prefix, this.app));
+            manager.registerDriver('null', () => new NullStore_1.NullStore());
+            return manager;
+        });
+        // Bind the default store directly for convenience
+        this.app.singleton('cache.store', () => {
+            return this.app.make('cache').store();
+        });
+    }
+    /**
+     * Get the cache configuration
+     */
+    getConfig() {
+        try {
+            const configService = this.app.make('config');
+            const cacheConfig = configService?.items?.cache || configService?.get?.('cache');
+            if (cacheConfig) {
+                return {
+                    default: cacheConfig.default || 'array',
+                    prefix: cacheConfig.prefix || 'orchestr_cache_',
+                    stores: cacheConfig.stores || { array: { driver: 'array' } },
+                };
+            }
+        }
+        catch {
+            // Config service not available
+        }
+        // Default configuration
+        return {
+            default: 'array',
+            prefix: 'orchestr_cache_',
+            stores: {
+                array: {
+                    driver: 'array',
+                    serialize: false,
+                },
+                null: {
+                    driver: 'null',
+                },
+            },
+        };
+    }
+}
+exports.CacheServiceProvider = CacheServiceProvider;
+//# sourceMappingURL=CacheServiceProvider.js.map

package/dist/Cache/CacheServiceProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheServiceProvider.js","sourceRoot":"","sources":["../../src/Cache/CacheServiceProvider.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mEAAgE;AAChE,iDAA8C;AAE9C,oDAAiD;AACjD,kDAA+C;AAC/C,0DAAuD;AACvD,kDAA+C;AAE/C,MAAa,oBAAqB,SAAQ,iCAAe;IACvD;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,IAAI,2BAAY,CAAC,MAAM,CAAC,CAAC;YAEzC,4BAA4B;YAC5B,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE,CAC9C,IAAI,uBAAU,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAC3C,CAAC;YAEF,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,CAC7C,IAAI,qBAAS,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAC1C,CAAC;YAEF,OAAO,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,EAAE,CACjD,IAAI,6BAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CACxD,CAAC;YAEF,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,CAClC,IAAI,qBAAS,EAAE,CAChB,CAAC;YAEF,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,kDAAkD;QAClD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,EAAE;YACrC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAe,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,SAAS;QACjB,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAQ,CAAC;YACrD,MAAM,WAAW,GAAG,aAAa,EAAE,KAAK,EAAE,KAAK,IAAI,aAAa,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;YACjF,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO;oBACL,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;oBACvC,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,iBAAiB;oBAC/C,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;iBAC7D,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QAED,wBAAwB;QACxB,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE;gBACN,KAAK,EAAE;oBACL,MAAM,EAAE,OAAO;oBACf,SAAS,EAAE,KAAK;iBACjB;gBACD,IAAI,EAAE;oBACJ,MAAM,EAAE,MAAM;iBACf;aACF;SACF,CAAC;IACJ,CAAC;CACF;AApED,oDAoEC"}

package/dist/Cache/Contracts/Lock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Lock Contract
+ *
+ * Defines the interface for atomic lock implementations.
+ * Mirrors Laravel's Illuminate\Contracts\Cache\Lock.
+ */
+export interface LockContract {
+    /**
+     * Attempt to acquire the lock.
+     * If a callback is provided, it will be executed and the lock released automatically.
+     */
+    get(callback?: () => Promise<any> | any): Promise<boolean | any>;
+    /**
+     * Attempt to acquire the lock for the given number of seconds.
+     * Blocks until the lock is acquired or the timeout is reached.
+     */
+    block(seconds: number, callback?: () => Promise<any> | any): Promise<boolean | any>;
+    /**
+     * Release the lock
+     */
+    release(): Promise<boolean>;
+    /**
+     * Returns the current owner of the lock
+     */
+    owner(): string;
+    /**
+     * Releases this lock regardless of ownership
+     */
+    forceRelease(): Promise<boolean>;
+}
+//# sourceMappingURL=Lock.d.ts.map

package/dist/Cache/Contracts/Lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lock.d.ts","sourceRoot":"","sources":["../../../src/Cache/Contracts/Lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAEjE;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;IAEpF;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5B;;OAEG;IACH,KAAK,IAAI,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC"}

package/dist/Cache/Contracts/Lock.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Lock.js.map

package/dist/Cache/Contracts/Lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lock.js","sourceRoot":"","sources":["../../../src/Cache/Contracts/Lock.ts"],"names":[],"mappings":""}

package/dist/Cache/Contracts/Repository.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Repository Contract
+ *
+ * Defines the high-level cache API that wraps a store.
+ * Mirrors Laravel's Illuminate\Contracts\Cache\Repository.
+ */
+import type { Store } from './Store';
+import type { LockContract } from './Lock';
+export interface RepositoryContract extends Store {
+    /**
+     * Determine if an item exists in the cache
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Determine if an item doesn't exist in the cache
+     */
+    missing(key: string): Promise<boolean>;
+    /**
+     * Retrieve an item from the cache and delete it
+     */
+    pull(key: string, defaultValue?: any): Promise<any>;
+    /**
+     * Store an item in the cache if the key does not exist
+     */
+    add(key: string, value: any, ttl?: number | Date): Promise<boolean>;
+    /**
+     * Get an item from the cache, or execute the given closure and store the result
+     */
+    remember(key: string, ttl: number | Date, callback: () => any | Promise<any>): Promise<any>;
+    /**
+     * Get an item from the cache, or execute the given closure and store the result forever
+     */
+    rememberForever(key: string, callback: () => any | Promise<any>): Promise<any>;
+    /**
+     * Get an item from the cache using flexible stale-while-revalidate strategy
+     */
+    flexible(key: string, ttl: [number, number], callback: () => any | Promise<any>): Promise<any>;
+    /**
+     * Get a lock instance
+     */
+    lock(name: string, seconds?: number, owner?: string): LockContract;
+    /**
+     * Restore a lock instance using the owner identifier
+     */
+    restoreLock(name: string, owner: string): LockContract;
+    /**
+     * Get the underlying store implementation
+     */
+    getStore(): Store;
+    /**
+     * Get the default cache time in seconds
+     */
+    getDefaultCacheTime(): number | null;
+    /**
+     * Set the default cache time in seconds
+     */
+    setDefaultCacheTime(seconds: number | null): this;
+}
+//# sourceMappingURL=Repository.d.ts.map

package/dist/Cache/Contracts/Repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repository.d.ts","sourceRoot":"","sources":["../../../src/Cache/Contracts/Repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,kBAAmB,SAAQ,KAAK;IAC/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpE;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE5F;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/E;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/F;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAEnE;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAEvD;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC;IAElB;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;CACnD"}

package/dist/Cache/Contracts/Repository.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Repository Contract
+ *
+ * Defines the high-level cache API that wraps a store.
+ * Mirrors Laravel's Illuminate\Contracts\Cache\Repository.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Repository.js.map

package/dist/Cache/Contracts/Repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repository.js","sourceRoot":"","sources":["../../../src/Cache/Contracts/Repository.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/Cache/Contracts/Store.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Store Contract
+ *
+ * Defines the low-level interface for cache store implementations.
+ * Each driver (file, database, array, etc.) must implement this.
+ *
+ * Mirrors Laravel's Illuminate\Contracts\Cache\Store.
+ */
+export interface Store {
+    /**
+     * Retrieve an item from the cache by key
+     */
+    get(key: string): Promise<any>;
+    /**
+     * Retrieve multiple items from the cache by key
+     */
+    many(keys: string[]): Promise<Record<string, any>>;
+    /**
+     * Store an item in the cache for a given number of seconds
+     */
+    put(key: string, value: any, seconds: number): Promise<boolean>;
+    /**
+     * Store multiple items in the cache for a given number of seconds
+     */
+    putMany(values: Record<string, any>, seconds: number): Promise<boolean>;
+    /**
+     * Increment the value of an item in the cache
+     */
+    increment(key: string, value?: number): Promise<number | boolean>;
+    /**
+     * Decrement the value of an item in the cache
+     */
+    decrement(key: string, value?: number): Promise<number | boolean>;
+    /**
+     * Store an item in the cache indefinitely
+     */
+    forever(key: string, value: any): Promise<boolean>;
+    /**
+     * Remove an item from the cache
+     */
+    forget(key: string): Promise<boolean>;
+    /**
+     * Remove all items from the cache
+     */
+    flush(): Promise<boolean>;
+    /**
+     * Get the cache key prefix
+     */
+    getPrefix(): string;
+}
+//# sourceMappingURL=Store.d.ts.map

package/dist/Cache/Contracts/Store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.d.ts","sourceRoot":"","sources":["../../../src/Cache/Contracts/Store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAEnD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAElE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAElE;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1B;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;CACrB"}

package/dist/Cache/Contracts/Store.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Store.js.map

package/dist/Cache/Contracts/Store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Store.js","sourceRoot":"","sources":["../../../src/Cache/Contracts/Store.ts"],"names":[],"mappings":""}

package/dist/Cache/Events/CacheFlushed.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CacheFlushed Event
+ *
+ * Dispatched after all items have been flushed from the cache.
+ */
+export declare class CacheFlushed {
+    readonly storeName: string;
+    readonly tags: string[];
+    constructor(storeName: string, tags?: string[]);
+}
+//# sourceMappingURL=CacheFlushed.d.ts.map

package/dist/Cache/Events/CacheFlushed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFlushed.d.ts","sourceRoot":"","sources":["../../../src/Cache/Events/CacheFlushed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,YAAY;aAEL,SAAS,EAAE,MAAM;aACjB,IAAI,EAAE,MAAM,EAAE;gBADd,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAM,EAAO;CAEtC"}

package/dist/Cache/Events/CacheFlushed.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheFlushed = void 0;
+/**
+ * CacheFlushed Event
+ *
+ * Dispatched after all items have been flushed from the cache.
+ */
+class CacheFlushed {
+    storeName;
+    tags;
+    constructor(storeName, tags = []) {
+        this.storeName = storeName;
+        this.tags = tags;
+    }
+}
+exports.CacheFlushed = CacheFlushed;
+//# sourceMappingURL=CacheFlushed.js.map

package/dist/Cache/Events/CacheFlushed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheFlushed.js","sourceRoot":"","sources":["../../../src/Cache/Events/CacheFlushed.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,YAAY;IAEL;IACA;IAFlB,YACkB,SAAiB,EACjB,OAAiB,EAAE;QADnB,cAAS,GAAT,SAAS,CAAQ;QACjB,SAAI,GAAJ,IAAI,CAAe;IAClC,CAAC;CACL;AALD,oCAKC"}

package/dist/Cache/Events/CacheHit.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CacheHit Event
+ *
+ * Dispatched when a cache key is found.
+ */
+export declare class CacheHit {
+    readonly storeName: string;
+    readonly key: string;
+    readonly value: any;
+    readonly tags: string[];
+    constructor(storeName: string, key: string, value: any, tags?: string[]);
+}
+//# sourceMappingURL=CacheHit.d.ts.map

package/dist/Cache/Events/CacheHit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheHit.d.ts","sourceRoot":"","sources":["../../../src/Cache/Events/CacheHit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ;aAED,SAAS,EAAE,MAAM;aACjB,GAAG,EAAE,MAAM;aACX,KAAK,EAAE,GAAG;aACV,IAAI,EAAE,MAAM,EAAE;gBAHd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,EACV,IAAI,GAAE,MAAM,EAAO;CAEtC"}