@orchestr-sh/orchestr 1.8.0 → 1.9.1

package/dist/Cache/Events/CacheHit.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheHit = void 0;
+/**
+ * CacheHit Event
+ *
+ * Dispatched when a cache key is found.
+ */
+class CacheHit {
+    storeName;
+    key;
+    value;
+    tags;
+    constructor(storeName, key, value, tags = []) {
+        this.storeName = storeName;
+        this.key = key;
+        this.value = value;
+        this.tags = tags;
+    }
+}
+exports.CacheHit = CacheHit;
+//# sourceMappingURL=CacheHit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheHit.js","sourceRoot":"","sources":["../../../src/Cache/Events/CacheHit.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,QAAQ;IAED;IACA;IACA;IACA;IAJlB,YACkB,SAAiB,EACjB,GAAW,EACX,KAAU,EACV,OAAiB,EAAE;QAHnB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAK;QACV,SAAI,GAAJ,IAAI,CAAe;IAClC,CAAC;CACL;AAPD,4BAOC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheMissed.d.ts","sourceRoot":"","sources":["../../../src/Cache/Events/CacheMissed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,WAAW;aAEJ,SAAS,EAAE,MAAM;aACjB,GAAG,EAAE,MAAM;aACX,IAAI,EAAE,MAAM,EAAE;gBAFd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAM,EAAO;CAEtC"}

package/dist/Cache/Events/CacheMissed.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheMissed = void 0;
+/**
+ * CacheMissed Event
+ *
+ * Dispatched when a cache key is not found.
+ */
+class CacheMissed {
+    storeName;
+    key;
+    tags;
+    constructor(storeName, key, tags = []) {
+        this.storeName = storeName;
+        this.key = key;
+        this.tags = tags;
+    }
+}
+exports.CacheMissed = CacheMissed;
+//# sourceMappingURL=CacheMissed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheMissed.js","sourceRoot":"","sources":["../../../src/Cache/Events/CacheMissed.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,WAAW;IAEJ;IACA;IACA;IAHlB,YACkB,SAAiB,EACjB,GAAW,EACX,OAAiB,EAAE;QAFnB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAe;IAClC,CAAC;CACL;AAND,kCAMC"}

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

@@ -0,0 +1,12 @@
+/**
+ * KeyForgotten Event
+ *
+ * Dispatched when a key is removed from the cache.
+ */
+export declare class KeyForgotten {
+    readonly storeName: string;
+    readonly key: string;
+    readonly tags: string[];
+    constructor(storeName: string, key: string, tags?: string[]);
+}
+//# sourceMappingURL=KeyForgotten.d.ts.map

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

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

package/dist/Cache/Events/KeyForgotten.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyForgotten = void 0;
+/**
+ * KeyForgotten Event
+ *
+ * Dispatched when a key is removed from the cache.
+ */
+class KeyForgotten {
+    storeName;
+    key;
+    tags;
+    constructor(storeName, key, tags = []) {
+        this.storeName = storeName;
+        this.key = key;
+        this.tags = tags;
+    }
+}
+exports.KeyForgotten = KeyForgotten;
+//# sourceMappingURL=KeyForgotten.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KeyForgotten.js","sourceRoot":"","sources":["../../../src/Cache/Events/KeyForgotten.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,YAAY;IAEL;IACA;IACA;IAHlB,YACkB,SAAiB,EACjB,GAAW,EACX,OAAiB,EAAE;QAFnB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;QACX,SAAI,GAAJ,IAAI,CAAe;IAClC,CAAC;CACL;AAND,oCAMC"}

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

@@ -0,0 +1,14 @@
+/**
+ * KeyWritten Event
+ *
+ * Dispatched when a value is written to the cache.
+ */
+export declare class KeyWritten {
+    readonly storeName: string;
+    readonly key: string;
+    readonly value: any;
+    readonly seconds: number | null;
+    readonly tags: string[];
+    constructor(storeName: string, key: string, value: any, seconds: number | null, tags?: string[]);
+}
+//# sourceMappingURL=KeyWritten.d.ts.map

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

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

package/dist/Cache/Events/KeyWritten.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyWritten = void 0;
+/**
+ * KeyWritten Event
+ *
+ * Dispatched when a value is written to the cache.
+ */
+class KeyWritten {
+    storeName;
+    key;
+    value;
+    seconds;
+    tags;
+    constructor(storeName, key, value, seconds, tags = []) {
+        this.storeName = storeName;
+        this.key = key;
+        this.value = value;
+        this.seconds = seconds;
+        this.tags = tags;
+    }
+}
+exports.KeyWritten = KeyWritten;
+//# sourceMappingURL=KeyWritten.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KeyWritten.js","sourceRoot":"","sources":["../../../src/Cache/Events/KeyWritten.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,UAAU;IAEH;IACA;IACA;IACA;IACA;IALlB,YACkB,SAAiB,EACjB,GAAW,EACX,KAAU,EACV,OAAsB,EACtB,OAAiB,EAAE;QAJnB,cAAS,GAAT,SAAS,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAK;QACV,YAAO,GAAP,OAAO,CAAe;QACtB,SAAI,GAAJ,IAAI,CAAe;IAClC,CAAC;CACL;AARD,gCAQC"}

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

@@ -0,0 +1,6 @@
+export { CacheHit } from './CacheHit';
+export { CacheMissed } from './CacheMissed';
+export { KeyWritten } from './KeyWritten';
+export { KeyForgotten } from './KeyForgotten';
+export { CacheFlushed } from './CacheFlushed';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Cache/Events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/Cache/Events/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheFlushed = exports.KeyForgotten = exports.KeyWritten = exports.CacheMissed = exports.CacheHit = void 0;
+var CacheHit_1 = require("./CacheHit");
+Object.defineProperty(exports, "CacheHit", { enumerable: true, get: function () { return CacheHit_1.CacheHit; } });
+var CacheMissed_1 = require("./CacheMissed");
+Object.defineProperty(exports, "CacheMissed", { enumerable: true, get: function () { return CacheMissed_1.CacheMissed; } });
+var KeyWritten_1 = require("./KeyWritten");
+Object.defineProperty(exports, "KeyWritten", { enumerable: true, get: function () { return KeyWritten_1.KeyWritten; } });
+var KeyForgotten_1 = require("./KeyForgotten");
+Object.defineProperty(exports, "KeyForgotten", { enumerable: true, get: function () { return KeyForgotten_1.KeyForgotten; } });
+var CacheFlushed_1 = require("./CacheFlushed");
+Object.defineProperty(exports, "CacheFlushed", { enumerable: true, get: function () { return CacheFlushed_1.CacheFlushed; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Cache/Events/index.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/dist/Cache/Locks/CacheLock.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CacheLock
+ *
+ * Cache store-backed atomic lock implementation.
+ * Uses the cache store's add/forget methods for locking.
+ *
+ * Mirrors Laravel's Illuminate\Cache\CacheLock.
+ */
+import { Lock } from './Lock';
+import type { Store } from '../Contracts/Store';
+export declare class CacheLock extends Lock {
+    protected store: Store;
+    constructor(store: Store, name: string, seconds?: number, owner?: string);
+    protected acquire(): Promise<boolean>;
+    release(): Promise<boolean>;
+    forceRelease(): Promise<boolean>;
+    protected getCurrentOwner(): Promise<string | null>;
+}
+//# sourceMappingURL=CacheLock.d.ts.map

package/dist/Cache/Locks/CacheLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheLock.d.ts","sourceRoot":"","sources":["../../../src/Cache/Locks/CacheLock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qBAAa,SAAU,SAAQ,IAAI;IAE/B,SAAS,CAAC,KAAK,EAAE,KAAK;gBAAZ,KAAK,EAAE,KAAK,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAU,EACnB,KAAK,CAAC,EAAE,MAAM;cAKA,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBrC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAO3B,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;cAItB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAG1D"}

package/dist/Cache/Locks/CacheLock.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * CacheLock
+ *
+ * Cache store-backed atomic lock implementation.
+ * Uses the cache store's add/forget methods for locking.
+ *
+ * Mirrors Laravel's Illuminate\Cache\CacheLock.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheLock = void 0;
+const Lock_1 = require("./Lock");
+class CacheLock extends Lock_1.Lock {
+    store;
+    constructor(store, name, seconds = 0, owner) {
+        super(name, seconds, owner);
+        this.store = store;
+    }
+    async acquire() {
+        // Check if already locked
+        const existing = await this.store.get(this.name);
+        if (existing !== null) {
+            // Already locked - check if it's us
+            if (existing === this.ownerValue) {
+                return true;
+            }
+            return false;
+        }
+        // Acquire the lock
+        if (this.seconds > 0) {
+            return this.store.put(this.name, this.ownerValue, this.seconds);
+        }
+        return this.store.forever(this.name, this.ownerValue);
+    }
+    async release() {
+        if (await this.isOwnedByCurrentProcess()) {
+            return this.store.forget(this.name);
+        }
+        return false;
+    }
+    async forceRelease() {
+        return this.store.forget(this.name);
+    }
+    async getCurrentOwner() {
+        return this.store.get(this.name);
+    }
+}
+exports.CacheLock = CacheLock;
+//# sourceMappingURL=CacheLock.js.map

package/dist/Cache/Locks/CacheLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheLock.js","sourceRoot":"","sources":["../../../src/Cache/Locks/CacheLock.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,iCAA8B;AAG9B,MAAa,SAAU,SAAQ,WAAI;IAErB;IADZ,YACY,KAAY,EACtB,IAAY,EACZ,UAAkB,CAAC,EACnB,KAAc;QAEd,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QALlB,UAAK,GAAL,KAAK,CAAO;IAMxB,CAAC;IAES,KAAK,CAAC,OAAO;QACrB,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,oCAAoC;YACpC,IAAI,QAAQ,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,MAAM,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAES,KAAK,CAAC,eAAe;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AA5CD,8BA4CC"}

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

@@ -0,0 +1,51 @@
+/**
+ * Lock Base Class
+ *
+ * Abstract base class for atomic lock implementations.
+ * Provides the shared logic for acquiring, blocking, and releasing locks.
+ *
+ * Mirrors Laravel's Illuminate\Cache\Lock.
+ */
+import type { LockContract } from '../Contracts/Lock';
+export declare abstract class Lock implements LockContract {
+    protected name: string;
+    protected seconds: number;
+    protected ownerValue: string;
+    constructor(name: string, seconds?: number, owner?: string);
+    /**
+     * Attempt to acquire the lock at the driver level
+     */
+    protected abstract acquire(): Promise<boolean>;
+    /**
+     * Release the lock at the driver level
+     */
+    abstract release(): Promise<boolean>;
+    /**
+     * Force release the lock regardless of ownership
+     */
+    abstract forceRelease(): Promise<boolean>;
+    /**
+     * Get the current owner of the lock from the store
+     */
+    protected abstract getCurrentOwner(): Promise<string | null>;
+    /**
+     * Attempt to acquire the lock.
+     * If a callback is provided, execute it and auto-release.
+     */
+    get(callback?: () => Promise<any> | any): Promise<boolean | any>;
+    /**
+     * Block until the lock is acquired or timeout expires.
+     * If a callback is provided, execute it and auto-release.
+     */
+    block(seconds: number, callback?: () => Promise<any> | any): Promise<boolean | any>;
+    /**
+     * Returns the lock owner identifier
+     */
+    owner(): string;
+    /**
+     * Check if the lock is owned by the current process
+     */
+    isOwnedByCurrentProcess(): Promise<boolean>;
+    protected sleep(ms: number): Promise<void>;
+}
+//# sourceMappingURL=Lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Lock.d.ts","sourceRoot":"","sources":["../../../src/Cache/Locks/Lock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,8BAAsB,IAAK,YAAW,YAAY;IAI9C,SAAS,CAAC,IAAI,EAAE,MAAM;IACtB,SAAS,CAAC,OAAO,EAAE,MAAM;IAJ3B,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;gBAGjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAU,EAC7B,KAAK,CAAC,EAAE,MAAM;IAKhB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAE5D;;;OAGG;IACG,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;IAkBtE;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;IAwBzF;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjD,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/dist/Cache/Locks/Lock.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Lock Base Class
+ *
+ * Abstract base class for atomic lock implementations.
+ * Provides the shared logic for acquiring, blocking, and releasing locks.
+ *
+ * Mirrors Laravel's Illuminate\Cache\Lock.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Lock = void 0;
+const crypto_1 = require("crypto");
+const LockTimeoutException_1 = require("./LockTimeoutException");
+class Lock {
+    name;
+    seconds;
+    ownerValue;
+    constructor(name, seconds = 0, owner) {
+        this.name = name;
+        this.seconds = seconds;
+        this.ownerValue = owner || (0, crypto_1.randomUUID)();
+    }
+    /**
+     * Attempt to acquire the lock.
+     * If a callback is provided, execute it and auto-release.
+     */
+    async get(callback) {
+        const acquired = await this.acquire();
+        if (!acquired) {
+            return false;
+        }
+        if (callback) {
+            try {
+                return await callback();
+            }
+            finally {
+                await this.release();
+            }
+        }
+        return true;
+    }
+    /**
+     * Block until the lock is acquired or timeout expires.
+     * If a callback is provided, execute it and auto-release.
+     */
+    async block(seconds, callback) {
+        const startTime = Date.now();
+        const timeoutMs = seconds * 1000;
+        while (Date.now() - startTime < timeoutMs) {
+            if (await this.acquire()) {
+                if (callback) {
+                    try {
+                        return await callback();
+                    }
+                    finally {
+                        await this.release();
+                    }
+                }
+                return true;
+            }
+            await this.sleep(250);
+        }
+        throw new LockTimeoutException_1.LockTimeoutException(`Unable to acquire lock [${this.name}] within ${seconds} second(s).`);
+    }
+    /**
+     * Returns the lock owner identifier
+     */
+    owner() {
+        return this.ownerValue;
+    }
+    /**
+     * Check if the lock is owned by the current process
+     */
+    async isOwnedByCurrentProcess() {
+        const currentOwner = await this.getCurrentOwner();
+        return currentOwner === this.ownerValue;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.Lock = Lock;
+//# sourceMappingURL=Lock.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Lock.js","sourceRoot":"","sources":["../../../src/Cache/Locks/Lock.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,mCAAoC;AAEpC,iEAA8D;AAE9D,MAAsB,IAAI;IAIZ;IACA;IAJF,UAAU,CAAS;IAE7B,YACY,IAAY,EACZ,UAAkB,CAAC,EAC7B,KAAc;QAFJ,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAY;QAG7B,IAAI,CAAC,UAAU,GAAG,KAAK,IAAI,IAAA,mBAAU,GAAE,CAAC;IAC1C,CAAC;IAsBD;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,QAAmC;QAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QAEtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,OAAO,MAAM,QAAQ,EAAE,CAAC;YAC1B,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,QAAmC;QAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC;QAEjC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;YAC1C,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBACzB,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC;wBACH,OAAO,MAAM,QAAQ,EAAE,CAAC;oBAC1B,CAAC;4BAAS,CAAC;wBACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;oBACvB,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,IAAI,2CAAoB,CAC5B,2BAA2B,IAAI,CAAC,IAAI,YAAY,OAAO,aAAa,CACrE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB;QAC3B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAClD,OAAO,YAAY,KAAK,IAAI,CAAC,UAAU,CAAC;IAC1C,CAAC;IAES,KAAK,CAAC,EAAU;QACxB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF;AAnGD,oBAmGC"}

package/dist/Cache/Locks/LockTimeoutException.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LockTimeoutException
+ *
+ * Thrown when a lock cannot be acquired within the specified timeout.
+ */
+export declare class LockTimeoutException extends Error {
+    constructor(message?: string);
+}
+//# sourceMappingURL=LockTimeoutException.d.ts.map

package/dist/Cache/Locks/LockTimeoutException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockTimeoutException.d.ts","sourceRoot":"","sources":["../../../src/Cache/Locks/LockTimeoutException.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,GAAE,MAAkC;CAIxD"}

package/dist/Cache/Locks/LockTimeoutException.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockTimeoutException = void 0;
+/**
+ * LockTimeoutException
+ *
+ * Thrown when a lock cannot be acquired within the specified timeout.
+ */
+class LockTimeoutException extends Error {
+    constructor(message = 'Unable to acquire lock.') {
+        super(message);
+        this.name = 'LockTimeoutException';
+    }
+}
+exports.LockTimeoutException = LockTimeoutException;
+//# sourceMappingURL=LockTimeoutException.js.map

package/dist/Cache/Locks/LockTimeoutException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockTimeoutException.js","sourceRoot":"","sources":["../../../src/Cache/Locks/LockTimeoutException.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,UAAkB,yBAAyB;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC"}

package/dist/Cache/Locks/index.d.ts

@@ -0,0 +1,4 @@
+export { Lock } from './Lock';
+export { CacheLock } from './CacheLock';
+export { LockTimeoutException } from './LockTimeoutException';
+//# sourceMappingURL=index.d.ts.map

package/dist/Cache/Locks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Cache/Locks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/Cache/Locks/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockTimeoutException = exports.CacheLock = exports.Lock = void 0;
+var Lock_1 = require("./Lock");
+Object.defineProperty(exports, "Lock", { enumerable: true, get: function () { return Lock_1.Lock; } });
+var CacheLock_1 = require("./CacheLock");
+Object.defineProperty(exports, "CacheLock", { enumerable: true, get: function () { return CacheLock_1.CacheLock; } });
+var LockTimeoutException_1 = require("./LockTimeoutException");
+Object.defineProperty(exports, "LockTimeoutException", { enumerable: true, get: function () { return LockTimeoutException_1.LockTimeoutException; } });
+//# sourceMappingURL=index.js.map

package/dist/Cache/Locks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Cache/Locks/index.ts"],"names":[],"mappings":";;;AAAA,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}

package/dist/Cache/Repository.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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);
+ * });
+ * ```
+ */
+import type { Store } from './Contracts/Store';
+import type { RepositoryContract } from './Contracts/Repository';
+import type { LockContract } from './Contracts/Lock';
+import { TaggedCache } from './Tags/TaggedCache';
+export declare class Repository implements RepositoryContract {
+    protected store: Store;
+    protected config: Record<string, any>;
+    protected defaultCacheTime: number | null;
+    protected storeName: string;
+    constructor(store: Store, config?: Record<string, any>);
+    /**
+     * Set the store name (used for events)
+     */
+    setStoreName(name: string): this;
+    get(key: string, defaultValue?: any): Promise<any>;
+    many(keys: string[]): Promise<Record<string, any>>;
+    put(key: string, value: any, ttl?: number | Date): Promise<boolean>;
+    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>;
+    forever(key: string, value: any): Promise<boolean>;
+    forget(key: string): Promise<boolean>;
+    flush(): Promise<boolean>;
+    getPrefix(): string;
+    has(key: string): Promise<boolean>;
+    missing(key: string): Promise<boolean>;
+    pull(key: string, defaultValue?: any): Promise<any>;
+    add(key: string, value: any, ttl?: number | Date): Promise<boolean>;
+    remember(key: string, ttl: number | Date, callback: () => any | Promise<any>): Promise<any>;
+    rememberForever(key: string, callback: () => any | Promise<any>): Promise<any>;
+    flexible(key: string, ttl: [number, number], callback: () => any | Promise<any>): Promise<any>;
+    lock(name: string, seconds?: number, owner?: string): LockContract;
+    restoreLock(name: string, owner: string): LockContract;
+    tags(names: string | string[]): TaggedCache;
+    getStore(): Store;
+    getDefaultCacheTime(): number | null;
+    setDefaultCacheTime(seconds: number | null): this;
+    protected getSeconds(ttl?: number | Date | null): number | null;
+}
+//# sourceMappingURL=Repository.d.ts.map

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

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