@hazeljs/distributed-lock 0.4.0

package/dist/distributed-lock.decorator.d.ts

@@ -0,0 +1,3 @@
+import 'reflect-metadata';
+import { DistributedLockOptions } from './interfaces';
+export declare function DistributedLock(options: DistributedLockOptions): (target: object, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/distributed-lock.decorator.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistributedLock = DistributedLock;
+require("reflect-metadata");
+const lock_manager_1 = require("./lock-manager");
+function DistributedLock(options) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        descriptor.value = async function (...args) {
+            const lockManager = lock_manager_1.LockManager.getInstance();
+            let resolvedKey = options.key;
+            const paramNames = getParamNames(originalMethod);
+            paramNames.forEach((name, index) => {
+                const value = args[index];
+                const placeholder = `{${name}}`;
+                if (resolvedKey.includes(placeholder)) {
+                    resolvedKey = resolvedKey.replace(placeholder, String(value));
+                }
+            });
+            paramNames.forEach((name, index) => {
+                const obj = args[index];
+                if (obj && typeof obj === 'object') {
+                    for (const [prop, val] of Object.entries(obj)) {
+                        const placeholder = `{${name}.${prop}}`;
+                        if (resolvedKey.includes(placeholder)) {
+                            resolvedKey = resolvedKey.replace(placeholder, String(val));
+                        }
+                    }
+                }
+            });
+            const lock = await lockManager.acquire({
+                ...options,
+                key: resolvedKey,
+            });
+            if (!lock) {
+                throw new Error(`Could not acquire distributed lock for key: ${resolvedKey}`);
+            }
+            try {
+                return await originalMethod.apply(this, args);
+            }
+            finally {
+                await lock.release();
+            }
+        };
+        return descriptor;
+    };
+}
+function getParamNames(fn) {
+    const fnStr = fn.toString();
+    const result = fnStr.slice(fnStr.indexOf('(') + 1, fnStr.indexOf(')')).match(/([^\s,]+)/g);
+    return result === null ? [] : result.map((p) => p.split('=')[0]);
+}
+//# sourceMappingURL=distributed-lock.decorator.js.map

package/dist/distributed-lock.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-lock.decorator.js","sourceRoot":"","sources":["../src/distributed-lock.decorator.ts"],"names":[],"mappings":";;AASA,0CAuDC;AAhED,4BAA0B;AAE1B,iDAA6C;AAO7C,SAAgB,eAAe,CAAC,OAA+B;IAC7D,OAAO,UACL,MAAc,EACd,WAAmB,EACnB,UAA8B;QAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,UAAU,CAAC,KAAK,GAAG,KAAK,WAA0B,GAAG,IAAe;YAClE,MAAM,WAAW,GAAG,0BAAW,CAAC,WAAW,EAAE,CAAC;YAG9C,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;YAC9B,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;YAGjD,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,MAAM,WAAW,GAAG,IAAI,IAAI,GAAG,CAAC;gBAChC,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;oBACtC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC,CAAC,CAAC;YAGH,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;oBACnC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC9C,MAAM,WAAW,GAAG,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC;wBACxC,IAAI,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;4BACtC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;wBAC9D,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC;gBACrC,GAAG,OAAO;gBACV,GAAG,EAAE,WAAW;aACjB,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,+CAA+C,WAAW,EAAE,CAAC,CAAC;YAChF,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAChD,CAAC;oBAAS,CAAC;gBACT,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAKD,SAAS,aAAa,CAAC,EAAmC;IACxD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3F,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/distributed-lock.decorator.test.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/distributed-lock.decorator.test.js

@@ -0,0 +1,114 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const distributed_lock_decorator_1 = require("./distributed-lock.decorator");
+const lock_manager_1 = require("./lock-manager");
+class TestService {
+    async doSomething(id) {
+        return `done-${id}`;
+    }
+    async doNested(data) {
+        return `done-${data.userId}`;
+    }
+    async doNoParams() {
+        return 'done';
+    }
+}
+__decorate([
+    (0, distributed_lock_decorator_1.DistributedLock)({ key: 'test-lock-{id}', ttl: 5000 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number]),
+    __metadata("design:returntype", Promise)
+], TestService.prototype, "doSomething", null);
+__decorate([
+    (0, distributed_lock_decorator_1.DistributedLock)({ key: 'nested-lock-{data.userId}', ttl: 5000 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TestService.prototype, "doNested", null);
+__decorate([
+    (0, distributed_lock_decorator_1.DistributedLock)({ key: 'no-params-lock', ttl: 5000 }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], TestService.prototype, "doNoParams", null);
+describe('DistributedLock Decorator', () => {
+    let lockManager;
+    let service;
+    beforeEach(() => {
+        lockManager = lock_manager_1.LockManager.getInstance();
+        service = new TestService();
+    });
+    afterEach(async () => {
+        await lockManager.close();
+    });
+    it('should acquire and release lock for simple param', async () => {
+        const acquireSpy = jest.spyOn(lockManager, 'acquire');
+        const result = await service.doSomething(123);
+        expect(result).toBe('done-123');
+        expect(acquireSpy).toHaveBeenCalledWith(expect.objectContaining({
+            key: 'test-lock-123',
+        }));
+    });
+    it('should acquire and release lock for nested param', async () => {
+        const acquireSpy = jest.spyOn(lockManager, 'acquire');
+        const result = await service.doNested({ userId: 'u1', name: 'John' });
+        expect(result).toBe('done-u1');
+        expect(acquireSpy).toHaveBeenCalledWith(expect.objectContaining({
+            key: 'nested-lock-u1',
+        }));
+    });
+    it('should block concurrent calls for same key', async () => {
+        await lockManager.acquire({ key: 'no-params-lock', ttl: 5000 });
+        await expect(service.doNoParams()).rejects.toThrow('Could not acquire distributed lock for key: no-params-lock');
+    });
+    it('should handle complex key resolution from object', async () => {
+        const acquireSpy = jest.spyOn(lockManager, 'acquire');
+        class TestClass {
+            async execute(user, session) {
+                return 'executed';
+            }
+        }
+        __decorate([
+            (0, distributed_lock_decorator_1.DistributedLock)({ key: 'user-{user.id}-session-{session.token}' }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Object, Object]),
+            __metadata("design:returntype", Promise)
+        ], TestClass.prototype, "execute", null);
+        const instance = new TestClass();
+        const result = await instance.execute({ id: '1' }, { token: 'abc' });
+        expect(result).toBe('executed');
+        expect(acquireSpy).toHaveBeenCalledWith(expect.objectContaining({
+            key: 'user-1-session-abc',
+        }));
+    });
+    it('should handle missing keys gracefully', async () => {
+        const acquireSpy = jest.spyOn(lockManager, 'acquire');
+        class TestClass {
+            async execute(data) {
+                return 'executed';
+            }
+        }
+        __decorate([
+            (0, distributed_lock_decorator_1.DistributedLock)({ key: 'test-{missing}' }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Object]),
+            __metadata("design:returntype", Promise)
+        ], TestClass.prototype, "execute", null);
+        const instance = new TestClass();
+        await instance.execute({ id: '1' });
+        expect(acquireSpy).toHaveBeenCalledWith(expect.objectContaining({
+            key: 'test-{missing}',
+        }));
+    });
+});
+//# sourceMappingURL=distributed-lock.decorator.test.js.map

package/dist/distributed-lock.decorator.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './interfaces';
+export * from './lock-manager';
+export * from './distributed-lock.decorator';
+export * from './backends';

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./lock-manager"), exports);
+__exportStar(require("./distributed-lock.decorator"), exports);
+__exportStar(require("./backends"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,iDAA+B;AAC/B,+DAA6C;AAC7C,6CAA2B"}

package/dist/interfaces.d.ts

@@ -0,0 +1,20 @@
+export interface LockOptions {
+    key: string;
+    ttl?: number;
+    retry?: {
+        attempts: number;
+        delay: number;
+    };
+    backend?: 'redis' | 'memory' | string;
+}
+export interface ILock {
+    release(): Promise<void>;
+    extend(ttl: number): Promise<boolean>;
+}
+export interface ILockBackend {
+    acquire(options: LockOptions): Promise<ILock | null>;
+    release(key: string, identifier: string): Promise<void>;
+    extend(key: string, identifier: string, ttl: number): Promise<boolean>;
+    close?(): Promise<void>;
+}
+export type DistributedLockOptions = LockOptions;

package/dist/interfaces.js

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

package/dist/interfaces.js.map

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

package/dist/lock-manager.d.ts

@@ -0,0 +1,13 @@
+import { ILock, ILockBackend, LockOptions } from './interfaces';
+export declare class LockManager {
+    private static instance;
+    private readonly backends;
+    private defaultBackendName;
+    private constructor();
+    static getInstance(): LockManager;
+    registerBackend(name: string, backend: ILockBackend): void;
+    setDefaultBackend(name: string): void;
+    acquire(options: LockOptions): Promise<ILock | null>;
+    setupRedis(redisOptions: unknown, name?: string): void;
+    close(): Promise<void>;
+}

package/dist/lock-manager.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockManager = void 0;
+const memory_backend_1 = require("./backends/memory-backend");
+const redis_backend_1 = require("./backends/redis-backend");
+class LockManager {
+    constructor() {
+        this.backends = new Map();
+        this.defaultBackendName = 'memory';
+        this.registerBackend('memory', new memory_backend_1.MemoryLockBackend());
+    }
+    static getInstance() {
+        if (!LockManager.instance) {
+            LockManager.instance = new LockManager();
+        }
+        return LockManager.instance;
+    }
+    registerBackend(name, backend) {
+        this.backends.set(name, backend);
+    }
+    setDefaultBackend(name) {
+        if (!this.backends.has(name)) {
+            throw new Error(`Backend '${name}' is not registered.`);
+        }
+        this.defaultBackendName = name;
+    }
+    async acquire(options) {
+        const backendName = options.backend || this.defaultBackendName;
+        const backend = this.backends.get(backendName);
+        if (!backend) {
+            throw new Error(`Lock backend '${backendName}' not found`);
+        }
+        return backend.acquire(options);
+    }
+    setupRedis(redisOptions, name = 'redis') {
+        const backend = new redis_backend_1.RedisLockBackend(redisOptions);
+        this.registerBackend(name, backend);
+        if (this.defaultBackendName === 'memory') {
+            this.defaultBackendName = name;
+        }
+    }
+    async close() {
+        for (const backend of this.backends.values()) {
+            if (backend.close) {
+                await backend.close();
+            }
+        }
+        this.backends.clear();
+        this.registerBackend('memory', new memory_backend_1.MemoryLockBackend());
+    }
+}
+exports.LockManager = LockManager;
+//# sourceMappingURL=lock-manager.js.map

package/dist/lock-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.js","sourceRoot":"","sources":["../src/lock-manager.ts"],"names":[],"mappings":";;;AACA,8DAA8D;AAC9D,4DAA4D;AAE5D,MAAa,WAAW;IAKtB;QAHiB,aAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;QACpD,uBAAkB,GAAW,QAAQ,CAAC;QAG5C,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,kCAAiB,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC1B,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC3C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,OAAqB;QACjD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,iBAAiB,CAAC,IAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,sBAAsB,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAoB;QAChC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,kBAAkB,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,WAAW,aAAa,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAGD,UAAU,CAAC,YAAqB,EAAE,OAAe,OAAO;QACtD,MAAM,OAAO,GAAG,IAAI,gCAAgB,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,kBAAkB,KAAK,QAAQ,EAAE,CAAC;YACzC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,kCAAiB,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF;AAxDD,kCAwDC"}

package/dist/lock-manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lock-manager.test.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const lock_manager_1 = require("./lock-manager");
+describe('LockManager (Memory)', () => {
+    let lockManager;
+    beforeEach(() => {
+        lockManager = lock_manager_1.LockManager.getInstance();
+    });
+    afterEach(async () => {
+        await lockManager.close();
+    });
+    it('should acquire and release a lock', async () => {
+        const lock = await lockManager.acquire({ key: 'test-lock', ttl: 1000 });
+        expect(lock).toBeDefined();
+        expect(lock).not.toBeNull();
+        if (lock) {
+            const secondLock = await lockManager.acquire({ key: 'test-lock', ttl: 1000 });
+            expect(secondLock).toBeNull();
+            await lock.release();
+            const thirdLock = await lockManager.acquire({ key: 'test-lock', ttl: 1000 });
+            expect(thirdLock).not.toBeNull();
+            await thirdLock?.release();
+        }
+    });
+    it('should retry to acquire a lock', async () => {
+        const lock = await lockManager.acquire({ key: 'retry-lock', ttl: 500 });
+        expect(lock).not.toBeNull();
+        setTimeout(() => lock?.release(), 200);
+        const secondLock = await lockManager.acquire({
+            key: 'retry-lock',
+            ttl: 500,
+            retry: { attempts: 3, delay: 100 },
+        });
+        expect(secondLock).not.toBeNull();
+        await secondLock?.release();
+    });
+    it('should fail after max retries', async () => {
+        const lock = await lockManager.acquire({ key: 'fail-lock', ttl: 1000 });
+        expect(lock).not.toBeNull();
+        const startTime = Date.now();
+        const secondLock = await lockManager.acquire({
+            key: 'fail-lock',
+            ttl: 500,
+            retry: { attempts: 2, delay: 100 },
+        });
+        const duration = Date.now() - startTime;
+        expect(secondLock).toBeNull();
+        expect(duration).toBeGreaterThanOrEqual(190);
+        await lock?.release();
+    });
+    it('should register a new backend', async () => {
+        const mockBackend = {
+            acquire: jest.fn().mockResolvedValue({ release: jest.fn() }),
+            release: jest.fn(),
+            extend: jest.fn(),
+        };
+        lockManager.registerBackend('mock', mockBackend);
+        await lockManager.acquire({ key: 'test', backend: 'mock' });
+        expect(mockBackend.acquire).toHaveBeenCalled();
+    });
+    it('should throw error if backend is not found', async () => {
+        await expect(lockManager.acquire({ key: 'test', backend: 'non-existent' })).rejects.toThrow("Lock backend 'non-existent' not found");
+    });
+    it('should change default backend', async () => {
+        const mockBackend = {
+            acquire: jest.fn().mockResolvedValue({ release: jest.fn() }),
+            release: jest.fn(),
+            extend: jest.fn(),
+        };
+        lockManager.registerBackend('mock-default', mockBackend);
+        lockManager.setDefaultBackend('mock-default');
+        await lockManager.acquire({ key: 'test' });
+        expect(mockBackend.acquire).toHaveBeenCalled();
+        lockManager.setDefaultBackend('memory');
+    });
+    it('should throw error if setting non-existent default backend', () => {
+        expect(() => lockManager.setDefaultBackend('ghost')).toThrow("Backend 'ghost' is not registered.");
+    });
+    it('should setup redis backend', () => {
+        lockManager.setupRedis('redis://localhost:6379');
+        expect(lockManager.backends.has('redis')).toBe(true);
+    });
+});
+//# sourceMappingURL=lock-manager.test.js.map

package/dist/lock-manager.test.js.map

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