@daiso-tech/core 0.39.0 → 0.41.0

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

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

@@ -0,0 +1,390 @@
+/**
+ * @module Semaphore
+ */
+import {} from "../../../../utilities/_module-exports.js";
+import {} from "mongodb";
+import {} from "mongodb";
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ * 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 class MongodbSemaphoreAdapter {
+    static isSlotNotExpired = (slot) => slot.expiration === null || slot.expiration > new Date();
+    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) {
+        const { collectionName = "semaphore", collectionSettings, database, } = settings;
+        this.collection = database.collection(collectionName, collectionSettings);
+    }
+    async init() {
+        try {
+            await this.collection.createIndex({
+                key: 1,
+            }, {
+                unique: true,
+            });
+        }
+        catch {
+            /* Empty */
+        }
+        try {
+            await this.collection.createIndex("expiration", {
+                expireAfterSeconds: 0,
+            });
+        }
+        catch {
+            /* Empty */
+        }
+    }
+    async deInit() {
+        try {
+            await this.collection.dropIndexes();
+        }
+        catch {
+            /* EMPTY */
+        }
+        try {
+            await this.collection.drop();
+        }
+        catch {
+            /* EMPTY */
+        }
+    }
+    initSemaphoreIfNotExistsStage(key, limit) {
+        // Initialies the fields if they dont exist when upserting
+        return {
+            $set: {
+                key,
+                limit: {
+                    $ifNull: ["$limit", limit],
+                },
+                slots: {
+                    $ifNull: ["$slots", []],
+                },
+            },
+        };
+    }
+    removeExpiredSlotsStage() {
+        return {
+            $set: {
+                slots: {
+                    // We filter all slots that are not expired
+                    $filter: {
+                        input: "$slots",
+                        as: "slot",
+                        cond: {
+                            $or: [
+                                // We filter all slots that have no ttl
+                                {
+                                    $eq: ["$$slot.expiration", null],
+                                },
+                                // We filter all slots that have ttl but are not expired
+                                {
+                                    $gt: ["$$slot.expiration", new Date()],
+                                },
+                            ],
+                        },
+                    },
+                },
+            },
+        };
+    }
+    updateSemaphoreExpiration() {
+        const hasUnexpireableSlotQuery = {
+            $in: [
+                null,
+                {
+                    $map: {
+                        input: "$slots",
+                        as: "slot",
+                        in: "$$slot.expiration",
+                    },
+                },
+            ],
+        };
+        const hasNoSlotsQuery = {
+            $eq: [{ $size: "$slots" }, 0],
+        };
+        return [
+            {
+                $set: {
+                    expiration: {
+                        $cond: {
+                            // Check if there is at least one unexpirable slot
+                            if: hasUnexpireableSlotQuery,
+                            // If there are at least one unexpirable slot we set the expiration to null
+                            then: null,
+                            // If all slots are expireable we set the expiration to highest expiration
+                            else: {
+                                $max: "$slots.expiration",
+                            },
+                        },
+                    },
+                },
+            },
+            {
+                $set: {
+                    expiration: {
+                        $cond: {
+                            // Are there slots acquired
+                            if: hasNoSlotsQuery,
+                            // If there are no slots acquired we immediatley expire the semaphore
+                            then: TimeSpan.fromMinutes(1).toStartDate(),
+                            // If there are slots acquired we do nothing
+                            else: "$expiration",
+                        },
+                    },
+                },
+            },
+        ];
+    }
+    async acquire(settings) {
+        const { key, slotId, limit, ttl } = settings;
+        const hasNotReachedLimitQuery = {
+            $lt: [
+                {
+                    $size: "$slots",
+                },
+                "$limit",
+            ],
+        };
+        const hasAlreadyAcquiredSlotQuery = {
+            $not: [
+                {
+                    $in: [
+                        slotId,
+                        // We select the ids of each element in the $slots
+                        {
+                            $map: {
+                                input: "$slots",
+                                as: "slot",
+                                in: "$$slot.id",
+                            },
+                        },
+                    ],
+                },
+            ],
+        };
+        const semaphoreData = await this.collection.findOneAndUpdate({
+            key,
+        }, [
+            this.initSemaphoreIfNotExistsStage(key, limit),
+            this.removeExpiredSlotsStage(),
+            {
+                $set: {
+                    limit: {
+                        $cond: {
+                            if: {
+                                $eq: [
+                                    {
+                                        $size: "$slots",
+                                    },
+                                    0,
+                                ],
+                            },
+                            then: limit,
+                            else: "$limit",
+                        },
+                    },
+                },
+            },
+            {
+                $set: {
+                    slots: {
+                        $cond: {
+                            // We check if the limit is not reached and slotId does not exist
+                            if: {
+                                $and: [
+                                    hasNotReachedLimitQuery,
+                                    hasAlreadyAcquiredSlotQuery,
+                                ],
+                            },
+                            // If the limit is not reached and slot id does not exist we append the slot
+                            then: {
+                                $concatArrays: [
+                                    "$slots",
+                                    [
+                                        {
+                                            id: slotId,
+                                            expiration: ttl?.toEndDate() ?? null,
+                                        },
+                                    ],
+                                ],
+                            },
+                            // If the limit is reached or slot id does exist we do nonthing
+                            else: "$slots",
+                        },
+                    },
+                },
+            },
+            ...this.updateSemaphoreExpiration(),
+        ], {
+            upsert: true,
+            projection: {
+                _id: 0,
+                limit: 1,
+                slots: 1,
+            },
+        });
+        if (semaphoreData === null) {
+            return true;
+        }
+        // We need to filter out expired slots from semaphoreData to ensure the data is current.
+        // The update that handles slot expiration runs after this function.
+        const unexpiredSlots = semaphoreData.slots.filter(MongodbSemaphoreAdapter.isSlotNotExpired);
+        const hasReachedLimit = unexpiredSlots.length >= semaphoreData.limit;
+        if (hasReachedLimit) {
+            return false;
+        }
+        const hasAlreadyAcquiredSlot = unexpiredSlots.some((slot) => slot.id === slotId);
+        if (hasAlreadyAcquiredSlot) {
+            return true;
+        }
+        return true;
+    }
+    async release(key, slotId) {
+        const semaphoreData = await this.collection.findOneAndUpdate({
+            key,
+        }, [
+            this.removeExpiredSlotsStage(),
+            {
+                $set: {
+                    slots: {
+                        $filter: {
+                            input: "$slots",
+                            as: "slot",
+                            cond: {
+                                $ne: ["$$slot.id", slotId],
+                            },
+                        },
+                    },
+                },
+            },
+            ...this.updateSemaphoreExpiration(),
+        ], {
+            projection: {
+                _id: 0,
+                slots: 1,
+            },
+        });
+        if (semaphoreData === null) {
+            return false;
+        }
+        const hasSlot = semaphoreData.slots.some((slot) => slot.id === slotId &&
+            MongodbSemaphoreAdapter.isSlotNotExpired(slot));
+        if (hasSlot) {
+            return true;
+        }
+        return false;
+    }
+    async forceReleaseAll(key) {
+        const semaphoreData = await this.collection.findOneAndDelete({
+            key,
+        }, {
+            projection: { _id: 0, slots: 1 },
+        });
+        if (semaphoreData === null) {
+            return false;
+        }
+        const unexpiredSlots = semaphoreData.slots.filter(MongodbSemaphoreAdapter.isSlotNotExpired);
+        return unexpiredSlots.length > 0;
+    }
+    async refresh(key, slotId, ttl) {
+        const isExpireableQuery = {
+            $ne: ["$$slot.expiration", null],
+        };
+        const isUnexpiredQuery = {
+            $gt: ["$$slot.expiration", new Date()],
+        };
+        const semaphoreData = await this.collection.findOneAndUpdate({
+            key,
+        }, [
+            this.removeExpiredSlotsStage(),
+            {
+                $set: {
+                    slots: {
+                        $map: {
+                            input: "$slots",
+                            as: "slot",
+                            in: {
+                                $cond: {
+                                    if: {
+                                        $and: [
+                                            {
+                                                $eq: ["$$slot.id", slotId],
+                                            },
+                                            isExpireableQuery,
+                                            isUnexpiredQuery,
+                                        ],
+                                    },
+                                    then: {
+                                        id: "$$slot.id",
+                                        expiration: ttl.toEndDate(),
+                                    },
+                                    else: "$$slot",
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            ...this.updateSemaphoreExpiration(),
+        ], {
+            projection: {
+                _id: 0,
+                slots: 1,
+            },
+            returnDocument: "after",
+        });
+        if (semaphoreData === null) {
+            return false;
+        }
+        const hasRefreshed = semaphoreData.slots
+            .filter(MongodbSemaphoreAdapter.isSlotNotExpired)
+            .some((slot) => slot.id === slotId && slot.expiration !== null);
+        return hasRefreshed;
+    }
+    async getState(key) {
+        const semaphore = await this.collection.findOne({ key }, {
+            projection: {
+                _id: 0,
+                slots: 1,
+                limit: 1,
+            },
+        });
+        if (semaphore === null) {
+            return null;
+        }
+        const unexpiredSlots = semaphore.slots.filter((slot) => {
+            return 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=mongodb-semaphore-adapter.js.map

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

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

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

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

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

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

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

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

package/dist/semaphore/implementations/adapters/no-op-semaphore-adapter/no-op-semaphore-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module Semaphore
+ */
+import type { ISemaphoreAdapter, ISemaphoreAdapterState, SemaphoreAcquireSettings } from "../../../../semaphore/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ * 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 declare class NoOpSemaphoreAdapter implements ISemaphoreAdapter {
+    getState(_key: string): Promise<ISemaphoreAdapterState | null>;
+    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>;
+}