@daiso-tech/core 0.39.0 → 0.41.0

package/dist/semaphore/implementations/adapters/no-op-semaphore-adapter/no-op-semaphore-adapter.js

@@ -0,0 +1,30 @@
+/**
+ * @module Semaphore
+ */
+/**
+ * This `NoOpSemaphoreAdapter` will do nothing and is used for easily mocking {@link ISemaphoreProvider | `ISemaphoreProvider`} for testing.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export class NoOpSemaphoreAdapter {
+    getState(_key) {
+        return Promise.resolve({
+            limit: Infinity,
+            acquiredSlots: new Map(),
+        });
+    }
+    acquire(_settings) {
+        return Promise.resolve(true);
+    }
+    release(_key, _slotId) {
+        return Promise.resolve(true);
+    }
+    forceReleaseAll(_key) {
+        return Promise.resolve(true);
+    }
+    refresh(_key, _slotId, _ttl) {
+        return Promise.resolve(true);
+    }
+}
+//# sourceMappingURL=no-op-semaphore-adapter.js.map

package/dist/semaphore/implementations/adapters/no-op-semaphore-adapter/no-op-semaphore-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-semaphore-adapter.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/adapters/no-op-semaphore-adapter/no-op-semaphore-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAC7B,QAAQ,CAAC,IAAY;QACjB,OAAO,OAAO,CAAC,OAAO,CAAC;YACnB,KAAK,EAAE,QAAQ;YACf,aAAa,EAAE,IAAI,GAAG,EAAE;SAC3B,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,SAAmC;QACvC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,OAAe;QACjC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,eAAe,CAAC,IAAY;QACxB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,OAAe,EAAE,IAAc;QACjD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACJ"}

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../semaphore/implementations/adapters/redis-semaphore-adapter/redis-semaphore-adapter.js";

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../semaphore/implementations/adapters/redis-semaphore-adapter/redis-semaphore-adapter.js";
+//# sourceMappingURL=_module.js.map

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/adapters/redis-semaphore-adapter/_module.ts"],"names":[],"mappings":"AAAA,cAAc,yFAAyF,CAAC"}

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/redis-semaphore-adapter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @module Semaphore
+ */
+import type { ISemaphoreAdapter, ISemaphoreAdapterState, SemaphoreAcquireSettings } from "../../../../semaphore/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+import type { Redis, Result } from "ioredis";
+declare module "ioredis" {
+    interface RedisCommander<Context> {
+        daiso_semaphore_acquire(key: string, slotId: string, limit: number, expiration: number | null, now: number): Result<1 | 0, Context>;
+        daiso_semaphore_release(key: string, slotId: string, now: number): Result<1 | 0, Context>;
+        daiso_semaphore_force_release_all(key: string, now: number): Result<1 | 0, Context>;
+        daiso_semaphore_refresh(key: string, slotId: string, newExpiration: number, now: number): Result<1 | 0, Context>;
+        /**
+         * Returns {@link IRedisJsonSemaphoreState | `IRedisJsonSemaphoreState | null`} as json string.
+         */
+        daiso_semaphore_get_state(key: string, now: number): Result<string, Context>;
+    }
+}
+/**
+ * To utilize the `RedisSemaphoreAdapter`, you must install the `"ioredis"` package.
+ *
+ * Note in order to use `RedisSemaphoreAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export declare class RedisSemaphoreAdapter implements ISemaphoreAdapter {
+    private readonly database;
+    constructor(database: Redis);
+    private static getLimitKey;
+    private static removeExpiredSlots;
+    private static getOrSetLimit;
+    private static isLimitReached;
+    private static hasSlotId;
+    private static addSlot;
+    private static updateKeyExpiration;
+    private static removeSemaphoreIfEmpty;
+    private initAquireCommand;
+    private initReleaseCommand;
+    private initForceReleaseAllCommand;
+    private initRefreshCommand;
+    private initGetStateCommand;
+    acquire(settings: SemaphoreAcquireSettings): Promise<boolean>;
+    release(key: string, slotId: string): Promise<boolean>;
+    forceReleaseAll(key: string): Promise<boolean>;
+    refresh(key: string, slotId: string, ttl: TimeSpan): Promise<boolean>;
+    getState(key: string): Promise<ISemaphoreAdapterState | null>;
+}

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/redis-semaphore-adapter.js

@@ -0,0 +1,338 @@
+/**
+ * @module Semaphore
+ */
+// acquiredSlots: Map<string, Date | null>;
+/**
+ * To utilize the `RedisSemaphoreAdapter`, you must install the `"ioredis"` package.
+ *
+ * Note in order to use `RedisSemaphoreAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export class RedisSemaphoreAdapter {
+    database;
+    constructor(database) {
+        this.database = database;
+        this.initAquireCommand();
+        this.initReleaseCommand();
+        this.initRefreshCommand();
+        this.initForceReleaseAllCommand();
+        this.initGetStateCommand();
+    }
+    static getLimitKey(keyVar) {
+        return `
+            (function(key)
+                return key .. "__limit";
+            end)(${keyVar});
+        `;
+    }
+    static removeExpiredSlots(keyVar, nowVar) {
+        return `
+            (function(key, now)
+                redis.call("zremrangebyscore", key, 1, now + 1);
+            end)(${keyVar}, ${nowVar});
+        `;
+    }
+    static getOrSetLimit(limitKeyVar, limitVar) {
+        return `
+            (function(limitKey, limit)
+                local currentLimit = tonumber(redis.call("set", limitKey, limit, "nx", "get"));
+                if currentLimit == nil then
+                    currentLimit = limit;
+                end
+                return currentLimit;
+            end)(${limitKeyVar}, ${limitVar});
+        `;
+    }
+    static isLimitReached(keyVar, limitVar) {
+        return `
+            (function(key, limit)
+                return tonumber(redis.call("zcard", key)) >= limit;
+            end)(${keyVar}, ${limitVar});
+        `;
+    }
+    static hasSlotId(keyVar, slotIdVar) {
+        return `
+            (function(key, slotId)
+                return tonumber(redis.call("zscore", key, slotId)) ~= nil;
+            end)(${keyVar}, ${slotIdVar});
+        `;
+    }
+    static addSlot(slotIdVar, expirationVar) {
+        return `
+            (function(slotId, expiration)
+                local isSlotNotExpirable = expiration == nil;
+                if isSlotNotExpirable then
+                    redis.call("zadd", key, 0, slotId);
+                else
+                    redis.call("zadd", key, expiration, slotId);
+                end
+            end)(${slotIdVar}, ${expirationVar});
+        `;
+    }
+    static updateKeyExpiration(keyVar, limitKeyVar) {
+        return `
+            (function(key, limitKey)
+                local hasAtLeastOneUnexpirableSlot = tonumber(redis.call("zcount", key, 0, 0)) > 0;
+                if hasAtLeastOneUnexpirableSlot then
+                    redis.call("persist", key);
+                    redis.call("persist", limitKey);
+                    return
+                end
+                
+                local longestExpiration = tonumber(redis.call("zrange", key, 0, 0, "BYSCORE", "REV", "WITHSCORES")[2]);
+                local hasAtLeastOneExpireableSlot = longestExpiration ~= nil and longestExpiration > 0;
+
+                if hasAtLeastOneExpireableSlot then
+                    redis.call("pexpireat", key, longestExpiration);
+                    redis.call("pexpireat", limitKey, longestExpiration);
+                end
+            end)(${keyVar}, ${limitKeyVar});
+        `;
+    }
+    static removeSemaphoreIfEmpty(keyVar, limitKeyVar) {
+        return `
+            (function(key, limitKey)
+                local slotCount = redis.call("zcard", key)
+                if slotCount <= 0 then
+                    redis.call("del", key)
+                    redis.call("del", limitKey)
+                end
+            end)(${keyVar}, ${limitKeyVar});
+        `;
+    }
+    initAquireCommand() {
+        if (typeof this.database.daiso_semaphore_acquire === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_semaphore_acquire", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local slotId = ARGV[1];
+                local limit = tonumber(ARGV[2]);
+
+                -- Expiration time as unix timestamp in ms
+                local expiration = tonumber(ARGV[3]);
+
+                -- Current time as unix timestamp in ms
+                local now = tonumber(ARGV[4]);
+                
+                local limitKey = ${RedisSemaphoreAdapter.getLimitKey("key")}
+                limit = ${RedisSemaphoreAdapter.getOrSetLimit("limitKey", "limit")}
+
+                ${RedisSemaphoreAdapter.removeExpiredSlots("key", "now")}
+
+                local isLimitReached = ${RedisSemaphoreAdapter.isLimitReached("key", "limit")}
+                if isLimitReached then
+                    return 0;
+                end
+
+                local hasSlotId = ${RedisSemaphoreAdapter.hasSlotId("key", "slotId")}
+                if hasSlotId then
+                    return 1;
+                end
+
+                ${RedisSemaphoreAdapter.addSlot("slotId", "expiration")}
+
+                ${RedisSemaphoreAdapter.updateKeyExpiration("key", "limitKey")}
+
+                return 1;
+            `,
+        });
+    }
+    initReleaseCommand() {
+        if (typeof this.database.daiso_semaphore_release === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_semaphore_release", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local slotId = ARGV[1];
+                -- The key where the slot limit will be stored
+                local limitKey = ${RedisSemaphoreAdapter.getLimitKey("key")}
+
+                -- Current time as unix timestamp in ms
+                local now = tonumber(ARGV[2]);
+
+                ${RedisSemaphoreAdapter.removeExpiredSlots("key", "now")}
+
+                -- Removes the given slot
+                local removedCount = redis.call("zrem", key, slotId);
+                local hasRemoved = removedCount == 1;
+
+                ${RedisSemaphoreAdapter.removeSemaphoreIfEmpty("key", "limitKey")}
+
+                ${RedisSemaphoreAdapter.updateKeyExpiration("key", "limitKey")}
+
+                return hasRemoved;
+            `,
+        });
+    }
+    initForceReleaseAllCommand() {
+        if (typeof this.database.daiso_semaphore_force_release_all ===
+            "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_semaphore_force_release_all", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+
+                -- current time as unix timestamp in ms
+                local now = ARGV[1];
+
+                -- The key where the slot limit will be stored
+                local limitKey = ${RedisSemaphoreAdapter.getLimitKey("key")}
+            
+                ${RedisSemaphoreAdapter.removeExpiredSlots("key", "now")}
+
+                local slotCount = redis.call("zcard", key);
+                redis.call("del", key);
+                redis.call("del", limitKey);
+                
+                local hasSlots = slotCount > 0
+                if hasSlots then
+                    return 1;
+                end
+
+                return 0;
+            `,
+        });
+    }
+    initRefreshCommand() {
+        if (typeof this.database.daiso_semaphore_refresh === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_semaphore_refresh", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local slotId = ARGV[1];
+
+                -- unix timestamp in ms
+                local newExpiration = tonumber(ARGV[2]);
+
+                -- current time as unix timestamp in ms
+                local now = tonumber(ARGV[3]);
+
+                -- The key where the slot limit will be stored
+                local limitKey = ${RedisSemaphoreAdapter.getLimitKey("key")}
+
+                ${RedisSemaphoreAdapter.removeExpiredSlots("key", "now")}
+
+                local expiration = tonumber(redis.call("zscore", key, slotId));
+                local isExpiredOrDoesNotExist = expiration == nil;
+                if isExpiredOrDoesNotExist then
+                    return 0
+                end
+
+                local isUnexpireable = expiration == 0;
+                if isUnexpireable then
+                    return 0
+                end
+                
+                -- Update expiration if slotId exists
+                redis.call("zadd", key, "xx", newExpiration, slotId);
+
+                local hasAtLeastOneUnexpirableSlot = tonumber(redis.call("zcount", key, 0, 0)) > 0;
+                local longestExpiration = tonumber(redis.call("zrange", key, 0, 0, "BYSCORE", "REV", "WITHSCORES")[2]);
+                if hasAtLeastOneUnexpirableSlot then
+                    redis.call("persist", key);
+                    redis.call("persist", limitKey);
+                elseif longestExpiration ~= nil and longestExpiration > 0 then
+                    redis.call("pexpireat", key, longestExpiration);
+                    redis.call("pexpireat", limitKey, longestExpiration);
+                end
+
+                return 1
+            `,
+        });
+    }
+    initGetStateCommand() {
+        if (typeof this.database.daiso_semaphore_get_state === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_semaphore_get_state", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                
+                -- current time as unix timestamp in ms
+                local now = tonumber(ARGV[1]);
+
+                local limitKey = ${RedisSemaphoreAdapter.getLimitKey("key")}
+
+                ${RedisSemaphoreAdapter.removeExpiredSlots("key", "now")}
+
+                local limit = redis.call("get", limitKey);
+                if limit == nil then
+                    return cjson.encode(nil);
+                end
+
+                local acquiredSlots = {};
+
+                local unexpiredSlotsArr = redis.call("zrange", key, now + 1, "+inf", "BYSCORE", "WITHSCORES");
+                for i = 1, #unexpiredSlotsArr, 2 do
+                    local member = unexpiredSlotsArr[i];
+                    local score = unexpiredSlotsArr[i+1];
+                    acquiredSlots[member] = tonumber(score);
+                end
+
+                local unexpireableSlotsArr = redis.call("zrange", key, 0, 0, "BYSCORE", "WITHSCORES");
+                for i = 1, #unexpireableSlotsArr, 2 do
+                    local member = unexpireableSlotsArr[i];
+                    local score = unexpireableSlotsArr[i+1];
+                    acquiredSlots[member] = tonumber(score);
+                end
+
+                local isEmpty = next(acquiredSlots) == nil;
+                if isEmpty then
+                    return cjson.encode(nil);
+                end
+
+                local state = {
+                    limit = tonumber(limit),
+                    acquiredSlots = acquiredSlots
+                }
+
+                return cjson.encode(state);
+            `,
+        });
+    }
+    async acquire(settings) {
+        const { key, slotId, limit, ttl } = settings;
+        const result = await this.database.daiso_semaphore_acquire(key, slotId, limit, ttl?.toEndDate().getTime() ?? null, Date.now());
+        return result === 1;
+    }
+    async release(key, slotId) {
+        const result = await this.database.daiso_semaphore_release(key, slotId, Date.now());
+        return result === 1;
+    }
+    async forceReleaseAll(key) {
+        const hasDeleted = await this.database.daiso_semaphore_force_release_all(key, Date.now());
+        return hasDeleted === 1;
+    }
+    async refresh(key, slotId, ttl) {
+        const result = await this.database.daiso_semaphore_refresh(key, slotId, ttl.toEndDate().getTime(), Date.now());
+        return result === 1;
+    }
+    async getState(key) {
+        const json = JSON.parse(await this.database.daiso_semaphore_get_state(key, Date.now()));
+        if (json === null) {
+            return null;
+        }
+        return {
+            limit: json.limit,
+            acquiredSlots: new Map(Object.entries(json.acquiredSlots).map(([key, expiration]) => {
+                if (expiration === 0) {
+                    return [key, null];
+                }
+                return [key, new Date(expiration)];
+            })),
+        };
+    }
+}
+//# sourceMappingURL=redis-semaphore-adapter.js.map

package/dist/semaphore/implementations/adapters/redis-semaphore-adapter/redis-semaphore-adapter.js.map

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

package/dist/semaphore/implementations/derivables/_module-exports.d.ts

@@ -0,0 +1,2 @@
+export * from "../../../semaphore/implementations/derivables/semaphore-provider/_module.js";
+export * from "../../../semaphore/implementations/derivables/semaphore-provider-factory/_module.js";

package/dist/semaphore/implementations/derivables/_module-exports.js

@@ -0,0 +1,3 @@
+export * from "../../../semaphore/implementations/derivables/semaphore-provider/_module.js";
+export * from "../../../semaphore/implementations/derivables/semaphore-provider-factory/_module.js";
+//# sourceMappingURL=_module-exports.js.map

package/dist/semaphore/implementations/derivables/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/semaphore/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,sEAAsE,CAAC;AACrF,cAAc,8EAA8E,CAAC"}

package/dist/semaphore/implementations/derivables/semaphore-provider/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../semaphore/implementations/derivables/semaphore-provider/semaphore-provider.js";

package/dist/semaphore/implementations/derivables/semaphore-provider/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../semaphore/implementations/derivables/semaphore-provider/semaphore-provider.js";
+//# sourceMappingURL=_module.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider/_module.ts"],"names":[],"mappings":"AAAA,cAAc,iFAAiF,CAAC"}

package/dist/semaphore/implementations/derivables/semaphore-provider/database-semaphore-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module Semaphore
+ */
+import type { SemaphoreAcquireSettings, IDatabaseSemaphoreAdapter, ISemaphoreAdapter, ISemaphoreAdapterState } from "../../../../semaphore/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ * @internal
+ */
+export declare class DatabaseSemaphoreAdapter implements ISemaphoreAdapter {
+    private readonly adapter;
+    constructor(adapter: IDatabaseSemaphoreAdapter);
+    acquire(settings: SemaphoreAcquireSettings): Promise<boolean>;
+    release(key: string, slotId: string): Promise<boolean>;
+    forceReleaseAll(key: string): Promise<boolean>;
+    refresh(key: string, slotId: string, ttl: TimeSpan): Promise<boolean>;
+    getState(key: string): Promise<ISemaphoreAdapterState | null>;
+}

package/dist/semaphore/implementations/derivables/semaphore-provider/database-semaphore-adapter.js

@@ -0,0 +1,74 @@
+/**
+ * @module Semaphore
+ */
+/**
+ * @internal
+ */
+export class DatabaseSemaphoreAdapter {
+    adapter;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async acquire(settings) {
+        return await this.adapter.transaction(async (methods) => {
+            const expiration = settings.ttl?.toEndDate() ?? null;
+            const semaphoreData = await methods.findSemaphore(settings.key);
+            let limit = semaphoreData?.limit;
+            if (limit === undefined) {
+                limit = settings.limit;
+                await methods.upsertSemaphore(settings.key, limit);
+            }
+            const slots = await methods.findSlots(settings.key);
+            const unexpiredSlots = slots.filter((slot) => slot.expiration === null || slot.expiration > new Date());
+            if (unexpiredSlots.length === 0) {
+                await methods.upsertSemaphore(settings.key, settings.limit);
+            }
+            if (unexpiredSlots.length >= limit) {
+                return false;
+            }
+            const hasNotSlot = unexpiredSlots.every((slot) => slot.id !== settings.slotId);
+            if (hasNotSlot) {
+                await methods.upsertSlot(settings.key, settings.slotId, expiration);
+            }
+            return true;
+        });
+    }
+    async release(key, slotId) {
+        const semapahoreSlotData = await this.adapter.removeSlot(key, slotId);
+        if (semapahoreSlotData === null) {
+            return false;
+        }
+        return (semapahoreSlotData.expiration === null ||
+            semapahoreSlotData.expiration > new Date());
+    }
+    async forceReleaseAll(key) {
+        const semapahoreSlotDataArray = await this.adapter.removeAllSlots(key);
+        return semapahoreSlotDataArray.some((semapahoreSlotData) => {
+            return (semapahoreSlotData.expiration === null ||
+                semapahoreSlotData.expiration > new Date());
+        });
+    }
+    async refresh(key, slotId, ttl) {
+        const updateCount = await this.adapter.updateExpiration(key, slotId, ttl.toEndDate());
+        return Number(updateCount) > 0;
+    }
+    async getState(key) {
+        return await this.adapter.transaction(async (trx) => {
+            const semaphore = await trx.findSemaphore(key);
+            if (semaphore === null) {
+                return null;
+            }
+            const slots = await trx.findSlots(key);
+            const unexpiredSlots = slots.filter((slot) => slot.expiration === null || slot.expiration > new Date());
+            if (unexpiredSlots.length === 0) {
+                return null;
+            }
+            const unexpiredSlotsAsMap = new Map(unexpiredSlots.map((slot) => [slot.id, slot.expiration]));
+            return {
+                limit: semaphore.limit,
+                acquiredSlots: unexpiredSlotsAsMap,
+            };
+        });
+    }
+}
+//# sourceMappingURL=database-semaphore-adapter.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider/database-semaphore-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-semaphore-adapter.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider/database-semaphore-adapter.ts"],"names":[],"mappings":"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"}

package/dist/semaphore/implementations/derivables/semaphore-provider/is-database-semaphore-adapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module Semaphore
+ */
+import type { IDatabaseSemaphoreAdapter, SemaphoreAdapterVariants } from "../../../../semaphore/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export declare function isDatabaseSemaphoreAdapter(adapter: SemaphoreAdapterVariants): adapter is IDatabaseSemaphoreAdapter;

package/dist/semaphore/implementations/derivables/semaphore-provider/is-database-semaphore-adapter.js

@@ -0,0 +1,15 @@
+/**
+ * @internal
+ */
+export function isDatabaseSemaphoreAdapter(adapter) {
+    const adapter_ = adapter;
+    return (typeof adapter_["transaction"] === "function" &&
+        adapter_["transaction"].length === 1 &&
+        typeof adapter_["removeSlot"] === "function" &&
+        adapter_["removeSlot"].length === 2 &&
+        typeof adapter_["removeAllSlots"] === "function" &&
+        adapter_["removeAllSlots"].length === 1 &&
+        typeof adapter_["updateExpiration"] === "function" &&
+        adapter_["updateExpiration"].length === 3);
+}
+//# sourceMappingURL=is-database-semaphore-adapter.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider/is-database-semaphore-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-database-semaphore-adapter.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider/is-database-semaphore-adapter.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACtC,OAAiC;IAEjC,MAAM,QAAQ,GAAG,OAEhB,CAAC;IACF,OAAO,CACH,OAAO,QAAQ,CAAC,aAAa,CAAC,KAAK,UAAU;QAC7C,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC;QACpC,OAAO,QAAQ,CAAC,YAAY,CAAC,KAAK,UAAU;QAC5C,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QACnC,OAAO,QAAQ,CAAC,gBAAgB,CAAC,KAAK,UAAU;QAChD,QAAQ,CAAC,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC;QACvC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,KAAK,UAAU;QAClD,QAAQ,CAAC,kBAAkB,CAAC,CAAC,MAAM,KAAK,CAAC,CAC5C,CAAC;AACN,CAAC"}

package/dist/semaphore/implementations/derivables/semaphore-provider/resolve-database-semaphore-adapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module Semaphore
+ */
+import type { ISemaphoreAdapter, SemaphoreAdapterVariants } from "../../../../semaphore/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export declare function resolveDatabaseSemaphoreAdapter(adapter: SemaphoreAdapterVariants): ISemaphoreAdapter;

package/dist/semaphore/implementations/derivables/semaphore-provider/resolve-database-semaphore-adapter.js

@@ -0,0 +1,15 @@
+/**
+ * @module Semaphore
+ */
+import { isDatabaseSemaphoreAdapter } from "../../../../semaphore/implementations/derivables/semaphore-provider/is-database-semaphore-adapter.js";
+import { DatabaseSemaphoreAdapter } from "../../../../semaphore/implementations/derivables/semaphore-provider/database-semaphore-adapter.js";
+/**
+ * @internal
+ */
+export function resolveDatabaseSemaphoreAdapter(adapter) {
+    if (isDatabaseSemaphoreAdapter(adapter)) {
+        return new DatabaseSemaphoreAdapter(adapter);
+    }
+    return adapter;
+}
+//# sourceMappingURL=resolve-database-semaphore-adapter.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider/resolve-database-semaphore-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-database-semaphore-adapter.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider/resolve-database-semaphore-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4FAA4F,CAAC;AACxI,OAAO,EAAE,wBAAwB,EAAE,MAAM,yFAAyF,CAAC;AAEnI;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC3C,OAAiC;IAEjC,IAAI,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC"}