@daiso-tech/core 0.39.0 → 0.41.0

package/dist/semaphore/contracts/semaphore.events.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @module Semaphore
+ */
+import type { ISemaphoreStateMethods } from "../../semaphore/contracts/semaphore.contract.js";
+/**
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type SemaphoreEventBase = {
+    semaphore: ISemaphoreStateMethods;
+};
+/**
+ * The event is dispatched when a semaphore slot is aquired.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type AcquiredSemaphoreEvent = SemaphoreEventBase;
+/**
+ * The event is dispatched when a semaphore slot is released.
+ * Note this event is only dispatched when the semaphore slot is released and not when the semaphore slot expired.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type ReleasedSemaphoreEvent = SemaphoreEventBase;
+/**
+ * The event is dispatched when all slot of semapahore are released.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type AllForceReleasedSemaphoreEvent = SemaphoreEventBase & {
+    hasReleased: boolean;
+};
+/**
+ * The error is dispatched when trying to referesh a semaphore slot that is already expired.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type FailedRefreshSemaphoreEvent = SemaphoreEventBase;
+/**
+ * The error is dispatched when trying to release a semaphore slot that is already expired.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type FailedReleaseSemaphoreEvent = SemaphoreEventBase;
+/**
+ * The event is dispatched when trying to acquire a semaphore slot when all slots are unavailable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type LimitReachedSemaphoreEvent = SemaphoreEventBase;
+/**
+ * The event is dispatched when a semaphore slot is refreshed.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type RefreshedSemaphoreEvent = SemaphoreEventBase;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type UnexpectedErrorSemaphoreEvent = SemaphoreEventBase & {
+    error: unknown;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export declare const SEMAPHORE_EVENTS: {
+    readonly ACQUIRED: "ACQUIRED";
+    readonly RELEASED: "RELEASED";
+    readonly ALL_FORCE_RELEASED: "ALL_FORCE_RELEASED";
+    readonly FAILED_RELEASE: "FAILED_RELEASE";
+    readonly FAILED_REFRESH: "FAILED_REFRESH";
+    readonly LIMIT_REACHED: "LIMIT_REACHED";
+    readonly REFRESHED: "REFRESHED";
+    readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export type SemaphoreEventMap = {
+    [SEMAPHORE_EVENTS.ACQUIRED]: AcquiredSemaphoreEvent;
+    [SEMAPHORE_EVENTS.RELEASED]: ReleasedSemaphoreEvent;
+    [SEMAPHORE_EVENTS.ALL_FORCE_RELEASED]: AllForceReleasedSemaphoreEvent;
+    [SEMAPHORE_EVENTS.FAILED_RELEASE]: FailedReleaseSemaphoreEvent;
+    [SEMAPHORE_EVENTS.FAILED_REFRESH]: FailedRefreshSemaphoreEvent;
+    [SEMAPHORE_EVENTS.LIMIT_REACHED]: LimitReachedSemaphoreEvent;
+    [SEMAPHORE_EVENTS.REFRESHED]: RefreshedSemaphoreEvent;
+    [SEMAPHORE_EVENTS.UNEXPECTED_ERROR]: UnexpectedErrorSemaphoreEvent;
+};

package/dist/semaphore/contracts/semaphore.events.js

@@ -0,0 +1,19 @@
+/**
+ * @module Semaphore
+ */
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Events
+ */
+export const SEMAPHORE_EVENTS = {
+    ACQUIRED: "ACQUIRED",
+    RELEASED: "RELEASED",
+    ALL_FORCE_RELEASED: "ALL_FORCE_RELEASED",
+    FAILED_RELEASE: "FAILED_RELEASE",
+    FAILED_REFRESH: "FAILED_REFRESH",
+    LIMIT_REACHED: "LIMIT_REACHED",
+    REFRESHED: "REFRESHED",
+    UNEXPECTED_ERROR: "UNEXPECTED_ERROR",
+};
+//# sourceMappingURL=semaphore.events.js.map

package/dist/semaphore/contracts/semaphore.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.events.js","sourceRoot":"","sources":["../../../src/semaphore/contracts/semaphore.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgFH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;CAC9B,CAAC"}

package/dist/semaphore/contracts/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module Semaphore
+ */
+import type { IDatabaseSemaphoreAdapter } from "../../semaphore/contracts/database-semaphore-adapter.contract.js";
+import type { ISemaphoreAdapter } from "../../semaphore/contracts/semaphore-adapter.contract.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/contracts"`
+ * @group Contracts
+ */
+export type SemaphoreAdapterVariants = ISemaphoreAdapter | IDatabaseSemaphoreAdapter;

package/dist/semaphore/contracts/types.js

@@ -0,0 +1,5 @@
+/**
+ * @module Semaphore
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/semaphore/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/semaphore/contracts/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,5 @@
+export * from "../../../semaphore/implementations/adapters/kysely-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/memory-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/mongodb-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/no-op-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/redis-semaphore-adapter/_module.js";

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

@@ -0,0 +1,6 @@
+export * from "../../../semaphore/implementations/adapters/kysely-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/memory-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/mongodb-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/no-op-semaphore-adapter/_module.js";
+export * from "../../../semaphore/implementations/adapters/redis-semaphore-adapter/_module.js";
+//# sourceMappingURL=_module-exports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/semaphore/implementations/adapters/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,0EAA0E,CAAC;AACzF,cAAc,0EAA0E,CAAC;AACzF,cAAc,2EAA2E,CAAC;AAC1F,cAAc,yEAAyE,CAAC;AACxF,cAAc,yEAAyE,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +1,97 @@
+/**
+ * @module Semaphore
+ */
+import type { IDatabaseSemaphoreTransaction, IDatabaseSemaphoreAdapter, ISemaphoreSlotExpirationData } from "../../../../semaphore/contracts/_module-exports.js";
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+import { type IDeinitizable, type IInitizable, type InvokableFn, type IPrunable } from "../../../../utilities/_module-exports.js";
+import { type Kysely } from "kysely";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type KyselySemaphoreTable = {
+    key: string;
+    limit: number;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type KyselySemaphoreSlotTable = {
+    id: string;
+    key: string;
+    expiration: number | string | null;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type KyselySemaphoreTables = {
+    semaphore: KyselySemaphoreTable;
+    semaphoreSlot: KyselySemaphoreSlotTable;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type KyselySemaphoreAdapterSettings = {
+    kysely: Kysely<KyselySemaphoreTables>;
+    /**
+     * @default
+     * ```ts
+     * TimeSpan.fromMinutes(1)
+     * ```
+     */
+    expiredKeysRemovalInterval?: TimeSpan;
+    /**
+     * @default true
+     */
+    shouldRemoveExpiredKeys?: boolean;
+};
+/**
+ * To utilize the `KyselySemaphoreAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselySemaphoreAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export declare class KyselySemaphoreAdapter implements IDatabaseSemaphoreAdapter, IDeinitizable, IInitizable, IPrunable {
+    private readonly kysely;
+    private readonly expiredKeysRemovalInterval;
+    private readonly shouldRemoveExpiredKeys;
+    private intervalId;
+    private readonly isMysql;
+    /**
+     * @example
+     * ```ts
+     * import { KyselySemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+     * import Sqlite from "better-sqlite3";
+     *
+     * const semaphoreAdapter = new KyselySemaphoreAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     * });
+     * // You need initialize the adapter once before using it.
+     * await semaphoreAdapter.init();
+     * ```
+     */
+    constructor(settings: KyselySemaphoreAdapterSettings);
+    init(): Promise<void>;
+    deInit(): Promise<void>;
+    removeAllExpired(): Promise<void>;
+    transaction<TValue>(fn: InvokableFn<[
+        methods: IDatabaseSemaphoreTransaction
+    ], Promise<TValue>>): Promise<TValue>;
+    removeSlot(key: string, slotId: string): Promise<ISemaphoreSlotExpirationData | null>;
+    removeAllSlots(key: string): Promise<ISemaphoreSlotExpirationData[]>;
+    updateExpiration(key: string, slotId: string, expiration: Date): Promise<number>;
+}

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

@@ -0,0 +1,313 @@
+/**
+ * @module Semaphore
+ */
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+import {} from "../../../../utilities/_module-exports.js";
+import { MysqlAdapter } from "kysely";
+/**
+ * @internal
+ */
+class DatabaseSemaphoreTransaction {
+    kysely;
+    isMysql;
+    constructor(kysely) {
+        this.kysely = kysely;
+        this.isMysql =
+            this.kysely.getExecutor().adapter instanceof MysqlAdapter;
+    }
+    async findSlots(key) {
+        const rows = await this.kysely
+            .selectFrom("semaphoreSlot")
+            .where("semaphoreSlot.key", "=", key)
+            .select(["semaphoreSlot.id", "semaphoreSlot.expiration"])
+            .execute();
+        return rows.map((row) => {
+            if (row.expiration === null) {
+                return {
+                    id: row.id,
+                    expiration: null,
+                };
+            }
+            return {
+                id: row.id,
+                expiration: new Date(Number(row.expiration)),
+            };
+        });
+    }
+    async findSemaphore(key) {
+        const row = await this.kysely
+            .selectFrom("semaphore")
+            .where("semaphore.key", "=", key)
+            .select("limit")
+            .executeTakeFirst();
+        if (row === undefined) {
+            return null;
+        }
+        return row;
+    }
+    async upsertSemaphore(key, limit) {
+        await this.kysely
+            .insertInto("semaphore")
+            .values({ key, limit })
+            .$if(!this.isMysql, (eb) => eb.onConflict((eb) => eb.column("key").doUpdateSet({
+            key,
+            limit,
+        })))
+            .$if(this.isMysql, (eb) => eb.onDuplicateKeyUpdate({
+            key,
+            limit,
+        }))
+            .execute();
+    }
+    async upsertSlot(key, slotId, expiration) {
+        const expirationAsMs = expiration?.getTime() ?? null;
+        await this.kysely
+            .insertInto("semaphoreSlot")
+            .values({
+            key,
+            id: slotId,
+            expiration: expirationAsMs,
+        })
+            .$if(!this.isMysql, (eb) => eb.onConflict((eb) => eb.column("id").doUpdateSet({
+            key,
+            id: slotId,
+            expiration: expirationAsMs,
+        })))
+            .$if(this.isMysql, (eb) => eb.onDuplicateKeyUpdate({
+            key,
+            id: slotId,
+            expiration: expirationAsMs,
+        }))
+            .execute();
+    }
+}
+/**
+ * To utilize the `KyselySemaphoreAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselySemaphoreAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export class KyselySemaphoreAdapter {
+    kysely;
+    expiredKeysRemovalInterval;
+    shouldRemoveExpiredKeys;
+    intervalId = null;
+    isMysql;
+    /**
+     * @example
+     * ```ts
+     * import { KyselySemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+     * import Sqlite from "better-sqlite3";
+     *
+     * const semaphoreAdapter = new KyselySemaphoreAdapter({
+     *   kysely: new Kysely({
+     *     dialect: new SqliteDialect({
+     *       database: new Sqlite("local.db"),
+     *     }),
+     *   }),
+     * });
+     * // You need initialize the adapter once before using it.
+     * await semaphoreAdapter.init();
+     * ```
+     */
+    constructor(settings) {
+        const { kysely, expiredKeysRemovalInterval = TimeSpan.fromMinutes(1), shouldRemoveExpiredKeys = true, } = settings;
+        this.expiredKeysRemovalInterval = expiredKeysRemovalInterval;
+        this.shouldRemoveExpiredKeys = shouldRemoveExpiredKeys;
+        this.kysely = kysely;
+        this.isMysql =
+            this.kysely.getExecutor().adapter instanceof MysqlAdapter;
+    }
+    async init() {
+        // Should throw if the table already exists thats why the try catch is used.
+        try {
+            await this.kysely.schema
+                .createTable("semaphore")
+                .addColumn("key", "varchar(255)", (col) => col.notNull().primaryKey())
+                .addColumn("limit", "integer", (col) => col.notNull())
+                .execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+        // Should throw if the table already exists thats why the try catch is used.
+        try {
+            await this.kysely.schema
+                .createTable("semaphoreSlot")
+                .addColumn("id", "varchar(255)", (col) => col.notNull().primaryKey())
+                .addColumn("key", "varchar(255)", (col) => col.notNull())
+                .addColumn("expiration", "bigint")
+                .addForeignKeyConstraint("semaphoreSlot_key", ["key"], "semaphore", ["key"], (eb) => eb.onDelete("cascade"))
+                .execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+        // Should throw if the index already exists thats why the try catch is used.
+        try {
+            await this.kysely.schema
+                .createIndex("semaphoreSlot_expiration_index")
+                .on("semaphoreSlot")
+                .columns(["key", "expiresAt"])
+                .execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+        if (this.shouldRemoveExpiredKeys) {
+            this.intervalId = setInterval(() => {
+                void this.removeAllExpired();
+            }, this.expiredKeysRemovalInterval.toMilliseconds());
+        }
+    }
+    async deInit() {
+        if (this.shouldRemoveExpiredKeys && this.intervalId !== null) {
+            clearInterval(this.intervalId);
+        }
+        // Should throw if the index does not exists thats why the try catch is used.
+        try {
+            await this.kysely.schema
+                .dropIndex("semaphoreSlot_expiration_index")
+                .on("semaphoreSlot")
+                .execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+        // Should throw if the table does not exists thats why the try catch is used.
+        try {
+            await this.kysely.schema.dropTable("semaphoreSlot").execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+        // Should throw if the table does not exists thats why the try catch is used.
+        try {
+            await this.kysely.schema.dropTable("semaphore").execute();
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    async removeAllExpired() {
+        await this.kysely
+            .deleteFrom("semaphore")
+            .where((eb) => {
+            const hasUnexpiredSlots = eb
+                .selectFrom("semaphoreSlot")
+                .select(eb.val(1).as("value"))
+                .where("semaphoreSlot.key", "=", eb.ref("semaphore.key"))
+                .where((eb) => eb.and([
+                eb("semaphoreSlot.expiration", "is not", null),
+                eb("semaphoreSlot.expiration", ">", Date.now()),
+            ]));
+            return eb.not(eb.exists(hasUnexpiredSlots));
+        })
+            .execute();
+    }
+    async transaction(fn) {
+        return await this.kysely
+            .transaction()
+            .setIsolationLevel("serializable")
+            .execute(async (trx) => {
+            return await fn(new DatabaseSemaphoreTransaction(trx));
+        });
+    }
+    async removeSlot(key, slotId) {
+        let row;
+        if (this.isMysql) {
+            row = await this.kysely
+                .transaction()
+                .setIsolationLevel("serializable")
+                .execute(async (trx) => {
+                const row = await trx
+                    .selectFrom("semaphoreSlot")
+                    .select("semaphoreSlot.expiration")
+                    .where("semaphoreSlot.key", "=", key)
+                    .where("semaphoreSlot.id", "=", slotId)
+                    .executeTakeFirst();
+                await trx
+                    .deleteFrom("semaphoreSlot")
+                    .where("semaphoreSlot.key", "=", key)
+                    .where("semaphoreSlot.id", "=", slotId)
+                    .executeTakeFirst();
+                return row;
+            });
+        }
+        else {
+            row = await this.kysely
+                .deleteFrom("semaphoreSlot")
+                .where("semaphoreSlot.key", "=", key)
+                .where("semaphoreSlot.id", "=", slotId)
+                .returning("semaphoreSlot.expiration")
+                .executeTakeFirst();
+        }
+        if (row === undefined) {
+            return null;
+        }
+        if (row.expiration === null) {
+            return {
+                expiration: null,
+            };
+        }
+        return {
+            expiration: new Date(Number(row.expiration)),
+        };
+    }
+    async removeAllSlots(key) {
+        let rows;
+        if (this.isMysql) {
+            rows = await this.kysely
+                .transaction()
+                .setIsolationLevel("serializable")
+                .execute(async (trx) => {
+                const rows = trx
+                    .selectFrom("semaphoreSlot")
+                    .where("semaphoreSlot.key", "=", key)
+                    .select("semaphoreSlot.expiration")
+                    .execute();
+                await trx
+                    .deleteFrom("semaphoreSlot")
+                    .where("semaphoreSlot.key", "=", key)
+                    .execute();
+                return rows;
+            });
+        }
+        else {
+            rows = await this.kysely
+                .deleteFrom("semaphoreSlot")
+                .where("semaphoreSlot.key", "=", key)
+                .returning("semaphoreSlot.expiration")
+                .execute();
+        }
+        return rows.map((row) => {
+            if (row.expiration === null) {
+                return {
+                    expiration: null,
+                };
+            }
+            return {
+                expiration: new Date(Number(row.expiration)),
+            };
+        });
+    }
+    async updateExpiration(key, slotId, expiration) {
+        const result = await this.kysely
+            .updateTable("semaphoreSlot")
+            .where("semaphoreSlot.key", "=", key)
+            .where("semaphoreSlot.id", "=", slotId)
+            .where((eb) => eb.and([
+            eb("semaphoreSlot.expiration", "is not", null),
+            eb("semaphoreSlot.expiration", ">", Date.now()),
+        ]))
+            .set({
+            expiration: expiration.getTime(),
+        })
+            .executeTakeFirst();
+        return Number(result.numUpdatedRows);
+    }
+}
+//# sourceMappingURL=kysely-semaphore-adapter.js.map

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * @module Semaphore
+ */
+import type { ISemaphoreAdapter, ISemaphoreAdapterState, SemaphoreAcquireSettings } from "../../../../semaphore/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MemorySemaphoreAdapterData = {
+    limit: number;
+    slots: Map<string, {
+        timeoutId: string | number | NodeJS.Timeout | null;
+        expiration: Date | null;
+    }>;
+};
+/**
+ * Note the `MemorySemaphoreAdapter` is limited to single process usage and cannot be shared across multiple servers or different processes.
+ * This adapter is meant to be used for testing.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export declare class MemorySemaphoreAdapter implements ISemaphoreAdapter {
+    private readonly map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemorySemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+     *
+     * const semaphoreAdapter = new MemorySemaphoreAdapter();
+     * ```
+     * You can also provide an `Map`.
+     * @example
+     * ```ts
+     * import { MemorySemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+     *
+     * const map = new Map<any, any>();
+     * const semaphoreAdapter = new MemorySemaphoreAdapter(map);
+     * ```
+     */
+    constructor(map?: Map<string, MemorySemaphoreAdapterData>);
+    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>;
+}