@daiso-tech/core 0.40.0 → 0.41.1

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

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