@daiso-tech/core 0.40.0 → 0.41.0

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>;
+}

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

@@ -0,0 +1,141 @@
+/**
+ * @module Semaphore
+ */
+/**
+ * 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 class MemorySemaphoreAdapter {
+    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 = new Map()) {
+        this.map = map;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async acquire(settings) {
+        const { key, slotId, limit, ttl } = settings;
+        let semaphore = this.map.get(key);
+        if (semaphore === undefined) {
+            semaphore = {
+                limit,
+                slots: new Map(),
+            };
+            this.map.set(key, semaphore);
+        }
+        if (semaphore.slots.size >= semaphore.limit) {
+            return false;
+        }
+        if (semaphore.slots.has(slotId)) {
+            return true;
+        }
+        if (ttl === null) {
+            semaphore.slots.set(slotId, {
+                timeoutId: null,
+                expiration: null,
+            });
+        }
+        else {
+            const timeoutId = setTimeout(() => {
+                semaphore.slots.delete(slotId);
+            }, ttl.toMilliseconds());
+            semaphore.slots.set(slotId, {
+                timeoutId,
+                expiration: ttl.toEndDate(),
+            });
+        }
+        this.map.set(key, semaphore);
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async release(key, slotId) {
+        const semaphore = this.map.get(key);
+        if (!semaphore) {
+            return false;
+        }
+        const slot = semaphore.slots.get(slotId);
+        if (slot === undefined) {
+            return false;
+        }
+        if (slot.timeoutId !== null) {
+            clearTimeout(slot.timeoutId);
+        }
+        semaphore.slots.delete(slotId);
+        this.map.set(key, semaphore);
+        if (semaphore.slots.size === 0) {
+            this.map.delete(key);
+        }
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async forceReleaseAll(key) {
+        const semaphore = this.map.get(key);
+        if (semaphore === undefined) {
+            return false;
+        }
+        const hasSlots = semaphore.slots.size > 0;
+        for (const [slotId, { timeoutId }] of semaphore.slots) {
+            clearTimeout(timeoutId ?? undefined);
+            semaphore.slots.delete(slotId);
+        }
+        this.map.delete(key);
+        return hasSlots;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async refresh(key, slotId, ttl) {
+        const semaphore = this.map.get(key);
+        if (!semaphore) {
+            return false;
+        }
+        const slot = semaphore.slots.get(slotId);
+        if (slot === undefined) {
+            return false;
+        }
+        if (slot.timeoutId === null) {
+            return false;
+        }
+        clearTimeout(slot.timeoutId);
+        const timeoutId = setTimeout(() => {
+            semaphore.slots.delete(slotId);
+            this.map.set(key, semaphore);
+        }, ttl.toMilliseconds());
+        semaphore.slots.set(slotId, {
+            timeoutId,
+            expiration: ttl.toEndDate(),
+        });
+        this.map.set(key, semaphore);
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getState(key) {
+        const semaphore = this.map.get(key);
+        if (semaphore === undefined) {
+            return null;
+        }
+        if (semaphore.slots.size === 0) {
+            return null;
+        }
+        return {
+            limit: semaphore.limit,
+            acquiredSlots: new Map([...semaphore.slots.entries()].map(([key, value]) => [key, value.expiration])),
+        };
+    }
+}
+//# sourceMappingURL=memory-semaphore-adapter.js.map

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * @module Semaphore
+ */
+import { type IDeinitizable, type IInitizable } from "../../../../utilities/_module-exports.js";
+import type { ISemaphoreAdapter, ISemaphoreAdapterState, SemaphoreAcquireSettings } from "../../../../semaphore/contracts/_module-exports.js";
+import type { ObjectId } from "mongodb";
+import { type CollectionOptions, type Db } from "mongodb";
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MongodbSemaphoreSlotSubDocument = {
+    id: string;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MongodbSemaphoreDocument = {
+    _id: ObjectId;
+    key: string;
+    limit: number;
+    slots: Array<MongodbSemaphoreSlotSubDocument>;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MongodbSemaphoreAdapterSettings = {
+    database: Db;
+    /**
+     * @default "semaphore"
+     */
+    collectionName?: string;
+    collectionSettings?: CollectionOptions;
+};
+/**
+ * To utilize the `MongodbSemaphoreAdapter`, you must install the `"mongodb"` package.
+ *
+ * Note in order to use `MongodbSemaphoreAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export declare class MongodbSemaphoreAdapter implements ISemaphoreAdapter, IDeinitizable, IInitizable {
+    private static isSlotNotExpired;
+    private readonly collection;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbSemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+     * import { MongoClient } from "mongodb";
+     *
+     * const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     * const database = client.db("database");
+     * const semaphoreAdapter = new MongodbSemaphoreAdapter({
+     *   database
+     * });
+     * // You need initialize the adapter once before using it.
+     * await semaphoreAdapter.init()
+     * ```
+     */
+    constructor(settings: MongodbSemaphoreAdapterSettings);
+    init(): Promise<void>;
+    deInit(): Promise<void>;
+    private initSemaphoreIfNotExistsStage;
+    private removeExpiredSlotsStage;
+    private updateSemaphoreExpiration;
+    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>;
+}