@daiso-tech/core 0.39.0 → 0.41.0

package/dist/shared-lock/implementations/adapters/memory-shared-lock-adapter/memory-shared-lock-adapter.js

@@ -0,0 +1,347 @@
+/**
+ * @module SharedLock
+ */
+import { UnexpectedError, } from "../../../../utilities/_module-exports.js";
+/**
+ * Note the `MemorySharedLockAdapter` 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/shared-lock/adapters"`
+ * @group Adapters
+ */
+export class MemorySharedLockAdapter {
+    map;
+    /**
+     *  @example
+     * ```ts
+     * import { MemorySharedLockAdapter } from "@daiso-tech/core/shared-lock/adapters";
+     *
+     * const lockAdapter = new MemorySharedLockAdapter();
+     * ```
+     * You can also provide an `Map`.
+     * @example
+     * ```ts
+     * import { MemorySharedLockAdapter } from "@daiso-tech/core/shared-lock/adapters";
+     *
+     * const map = new Map<any, any>();
+     * const lockAdapter = new MemorySharedLockAdapter(map);
+     * ```
+     */
+    constructor(map = new Map()) {
+        this.map = map;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async deInit() {
+        for (const [key, sharedLock] of this.map) {
+            const writerLock = sharedLock.writerLock;
+            if (writerLock !== null && writerLock.hasExpiration) {
+                clearTimeout(writerLock.timeoutId);
+            }
+            const readerSemaphore = sharedLock.readerSemaphore;
+            if (readerSemaphore !== null) {
+                for (const [_, { timeoutId }] of readerSemaphore.slots) {
+                    if (timeoutId !== null) {
+                        clearTimeout(timeoutId);
+                    }
+                }
+            }
+            this.map.delete(key);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async acquireWriter(key, lockId, ttl) {
+        const sharedLock = this.map.get(key);
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore !== null) {
+            return false;
+        }
+        let writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock !== null) {
+            return writerLock.owner === lockId;
+        }
+        if (ttl === null) {
+            writerLock = {
+                owner: lockId,
+                hasExpiration: false,
+            };
+            this.map.set(key, {
+                writerLock,
+                readerSemaphore: null,
+            });
+        }
+        else {
+            const timeoutId = setTimeout(() => {
+                this.map.delete(key);
+            }, ttl.toMilliseconds());
+            writerLock = {
+                owner: lockId,
+                hasExpiration: true,
+                timeoutId,
+                expiration: ttl.toEndDate(),
+            };
+            this.map.set(key, {
+                writerLock,
+                readerSemaphore: null,
+            });
+        }
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async releaseWriter(key, lockId) {
+        const sharedLock = this.map.get(key);
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore !== null) {
+            return false;
+        }
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock === null) {
+            return false;
+        }
+        if (writerLock.owner !== lockId) {
+            return false;
+        }
+        if (writerLock.hasExpiration) {
+            clearTimeout(writerLock.timeoutId);
+        }
+        this.map.delete(key);
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async forceReleaseWriter(key) {
+        const sharedLock = this.map.get(key);
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore !== null) {
+            return false;
+        }
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock === null) {
+            return false;
+        }
+        if (writerLock.hasExpiration) {
+            clearTimeout(writerLock.timeoutId);
+        }
+        this.map.delete(key);
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async refreshWriter(key, lockId, ttl) {
+        const sharedLock = this.map.get(key);
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore !== null) {
+            return false;
+        }
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock === null) {
+            return false;
+        }
+        if (writerLock.owner !== lockId) {
+            return false;
+        }
+        if (!writerLock.hasExpiration) {
+            return false;
+        }
+        clearTimeout(writerLock.timeoutId);
+        const timeoutId = setTimeout(() => {
+            this.map.delete(key);
+        }, ttl.toMilliseconds());
+        this.map.set(key, {
+            readerSemaphore: null,
+            writerLock: {
+                ...writerLock,
+                timeoutId,
+            },
+        });
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async acquireReader(settings) {
+        const { key, lockId, limit, ttl } = settings;
+        const sharedLock = this.map.get(key);
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock !== null) {
+            return false;
+        }
+        let readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore === null) {
+            readerSemaphore = {
+                limit,
+                slots: new Map(),
+            };
+            this.map.set(key, {
+                readerSemaphore,
+                writerLock: null,
+            });
+        }
+        if (readerSemaphore.slots.size >= readerSemaphore.limit) {
+            return false;
+        }
+        if (readerSemaphore.slots.has(lockId)) {
+            return true;
+        }
+        if (ttl === null) {
+            readerSemaphore.slots.set(lockId, {
+                timeoutId: null,
+                expiration: null,
+            });
+        }
+        else {
+            const timeoutId = setTimeout(() => {
+                readerSemaphore.slots.delete(lockId);
+            }, ttl.toMilliseconds());
+            readerSemaphore.slots.set(lockId, {
+                timeoutId,
+                expiration: ttl.toEndDate(),
+            });
+        }
+        this.map.set(key, {
+            readerSemaphore,
+            writerLock: null,
+        });
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async releaseReader(key, lockId) {
+        const sharedLock = this.map.get(key);
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock !== null) {
+            return false;
+        }
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore === null) {
+            return false;
+        }
+        const slot = readerSemaphore.slots.get(lockId);
+        if (slot === undefined) {
+            return false;
+        }
+        if (slot.timeoutId !== null) {
+            clearTimeout(slot.timeoutId);
+        }
+        readerSemaphore.slots.delete(lockId);
+        this.map.set(key, {
+            readerSemaphore,
+            writerLock: null,
+        });
+        if (readerSemaphore.slots.size === 0) {
+            this.map.delete(key);
+        }
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async forceReleaseAllReaders(key) {
+        const sharedLock = this.map.get(key);
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock !== null) {
+            return false;
+        }
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (readerSemaphore === null) {
+            return false;
+        }
+        const hasSlots = readerSemaphore.slots.size > 0;
+        for (const [slotId, { timeoutId }] of readerSemaphore.slots) {
+            clearTimeout(timeoutId ?? undefined);
+            readerSemaphore.slots.delete(slotId);
+        }
+        this.map.delete(key);
+        return hasSlots;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async refreshReader(key, lockId, ttl) {
+        const sharedLock = this.map.get(key);
+        const writerLock = sharedLock?.writerLock ?? null;
+        if (writerLock !== null) {
+            return false;
+        }
+        const readerSemaphore = sharedLock?.readerSemaphore ?? null;
+        if (!readerSemaphore) {
+            return false;
+        }
+        const slot = readerSemaphore.slots.get(lockId);
+        if (slot === undefined) {
+            return false;
+        }
+        if (slot.timeoutId === null) {
+            return false;
+        }
+        clearTimeout(slot.timeoutId);
+        const timeoutId = setTimeout(() => {
+            readerSemaphore.slots.delete(lockId);
+            this.map.set(key, {
+                readerSemaphore,
+                writerLock: null,
+            });
+        }, ttl.toMilliseconds());
+        readerSemaphore.slots.set(lockId, {
+            timeoutId,
+            expiration: ttl.toEndDate(),
+        });
+        this.map.set(key, {
+            readerSemaphore,
+            writerLock: null,
+        });
+        return true;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async forceRelease(key) {
+        const [hasReleasedAllReaders, hasReleasedWriter] = await Promise.all([
+            this.forceReleaseAllReaders(key),
+            this.forceReleaseWriter(key),
+        ]);
+        return hasReleasedAllReaders || hasReleasedWriter;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getState(key) {
+        const sharedLock = this.map.get(key);
+        if (sharedLock === undefined) {
+            return null;
+        }
+        const { writerLock, readerSemaphore } = sharedLock;
+        if (writerLock === null &&
+            readerSemaphore !== null &&
+            readerSemaphore.slots.size === 0) {
+            return null;
+        }
+        if (writerLock === null &&
+            readerSemaphore !== null &&
+            readerSemaphore.slots.size !== 0) {
+            return {
+                writer: null,
+                reader: {
+                    limit: readerSemaphore.limit,
+                    acquiredSlots: new Map([...readerSemaphore.slots.entries()].map(([key, value]) => [key, value.expiration])),
+                },
+            };
+        }
+        if (readerSemaphore === null &&
+            writerLock !== null &&
+            !writerLock.hasExpiration) {
+            return {
+                reader: null,
+                writer: {
+                    owner: writerLock.owner,
+                    expiration: null,
+                },
+            };
+        }
+        if (readerSemaphore === null &&
+            writerLock !== null &&
+            writerLock.hasExpiration &&
+            writerLock.expiration <= new Date()) {
+            return null;
+        }
+        if (readerSemaphore === null &&
+            writerLock !== null &&
+            writerLock.hasExpiration) {
+            return {
+                reader: null,
+                writer: {
+                    owner: writerLock.owner,
+                    expiration: writerLock.expiration,
+                },
+            };
+        }
+        throw new UnexpectedError("Invalid ISharedLockAdapterState, expected either the reader field must be defined or the writer field must be defined, but not both.");
+    }
+}
+//# sourceMappingURL=memory-shared-lock-adapter.js.map

package/dist/shared-lock/implementations/adapters/memory-shared-lock-adapter/memory-shared-lock-adapter.js.map

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

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

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

package/dist/shared-lock/implementations/adapters/mongodb-shared-lock-adapter/_module.js

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

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

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

package/dist/shared-lock/implementations/adapters/mongodb-shared-lock-adapter/mongodb-shared-lock-adapter.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @module SharedLock
+ */
+import { type IDeinitizable, type IInitizable } from "../../../../utilities/_module-exports.js";
+import type { ISharedLockAdapter, ISharedLockAdapterState, SharedLockAcquireSettings } from "../../../../shared-lock/contracts/_module-exports.js";
+import type { CollectionOptions, Db, ObjectId } from "mongodb";
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock/adapters"`
+ * @group Adapters
+ */
+export type MongodbSharedLockAdapterSettings = {
+    database: Db;
+    /**
+     * @default "sharedLock"
+     */
+    collectionName?: string;
+    collectionSettings?: CollectionOptions;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
+ * @group Adapters
+ */
+export type MongodbWriterLockSubDocument = {
+    owner: string;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MongodbReaderSemaphoreSlotSubDocument = {
+    id: string;
+    expiration: Date | null;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/adapters"`
+ * @group Adapters
+ */
+export type MongodbReaderSemaphoreDocument = {
+    limit: number;
+    slots: Array<MongodbReaderSemaphoreSlotSubDocument>;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock/adapters"`
+ * @group Adapters
+ */
+export type MongodbSharedLockDocument = {
+    _id: ObjectId;
+    key: string;
+    expiration: Date | null;
+    writer: MongodbWriterLockSubDocument | null;
+    reader: MongodbReaderSemaphoreDocument | null;
+};
+/**
+ * To utilize the `MongodbSharedLockAdapter`, you must install the [`"mongodb"`](https://www.npmjs.com/package/mongodb) package.
+ *
+ * Note in order to use `MongodbSharedLockAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock/adapters"`
+ * @group Adapters
+ */
+export declare class MongodbSharedLockAdapter implements ISharedLockAdapter, IDeinitizable, IInitizable {
+    private static isSlotNotExpired;
+    private readonly collection;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbSharedLockAdapter } from "@daiso-tech/core/shared-lock/adapters";
+     * import { MongoClient } from "mongodb";
+     *
+     * const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     * const database = client.db("database");
+     * const lockAdapter = new MongodbSharedLockAdapter({
+     *   database
+     * });
+     * // You need initialize the adapter once before using it.
+     * await lockAdapter.init()
+     * ```
+     */
+    constructor(settings: MongodbSharedLockAdapterSettings);
+    /**
+     * Creates all related indexes.
+     * Note the `init` method needs to be called once before using the adapter.
+     */
+    init(): Promise<void>;
+    /**
+     * Removes the collection where the lock keys are stored and all it's related indexes.
+     * Note all lock data will be removed.
+     */
+    deInit(): Promise<void>;
+    private updateSemaphoreExpiration;
+    private removeWriterWhenReaderIsActive;
+    acquireWriter(key: string, lockId: string, ttl: TimeSpan | null): Promise<boolean>;
+    releaseWriter(key: string, lockId: string): Promise<boolean>;
+    forceReleaseWriter(key: string): Promise<boolean>;
+    refreshWriter(key: string, lockId: string, ttl: TimeSpan): Promise<boolean>;
+    private initSemaphoreIfNotExistsStage;
+    private removeExpiredSlotsStage;
+    private removeReaderWhenWriterIsActive;
+    acquireReader(settings: SharedLockAcquireSettings): Promise<boolean>;
+    releaseReader(key: string, slotId: string): Promise<boolean>;
+    forceReleaseAllReaders(key: string): Promise<boolean>;
+    refreshReader(key: string, slotId: string, ttl: TimeSpan): Promise<boolean>;
+    forceRelease(key: string): Promise<boolean>;
+    getState(key: string): Promise<ISharedLockAdapterState | null>;
+}