@daiso-tech/core 0.39.0 → 0.41.0

package/dist/shared-lock/implementations/derivables/shared-lock-provider/database-shared-lock-adapter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module SharedLock
+ */
+import type { IDatabaseSharedLockAdapter } from "../../../../shared-lock/contracts/_module-exports.js";
+import type { ISharedLockAdapter, ISharedLockAdapterState, SharedLockAcquireSettings } from "../../../../shared-lock/contracts/_module-exports.js";
+import type { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+/**
+ * @internal
+ */
+export declare class DatabaseSharedLockAdapter implements ISharedLockAdapter {
+    private readonly adapter;
+    private static _forceReleaseWriter;
+    private static _forceReleaseAllReaders;
+    private static getWriterState;
+    private static getReaderState;
+    constructor(adapter: IDatabaseSharedLockAdapter);
+    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>;
+    acquireReader(settings: SharedLockAcquireSettings): Promise<boolean>;
+    releaseReader(key: string, lockId: 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>;
+}

package/dist/shared-lock/implementations/derivables/shared-lock-provider/database-shared-lock-adapter.js

@@ -0,0 +1,208 @@
+/**
+ * @module SharedLock
+ */
+/**
+ * @internal
+ */
+export class DatabaseSharedLockAdapter {
+    adapter;
+    static async _forceReleaseWriter(trx, key) {
+        const readerSemaphore = await trx.reader.findSemaphore(key);
+        if (readerSemaphore !== null) {
+            return false;
+        }
+        const lockData = await trx.writer.remove(key);
+        if (lockData === null) {
+            return false;
+        }
+        if (lockData.expiration === null) {
+            return true;
+        }
+        return lockData.expiration > new Date();
+    }
+    static async _forceReleaseAllReaders(trx, key) {
+        const writerLock = await trx.writer.find(key);
+        if (writerLock !== null) {
+            return false;
+        }
+        const semapahoreSlotDataArray = await trx.reader.removeAllSlots(key);
+        return semapahoreSlotDataArray.some((semapahoreSlotData) => {
+            return (semapahoreSlotData.expiration === null ||
+                semapahoreSlotData.expiration > new Date());
+        });
+    }
+    static async getWriterState(trx, key) {
+        const lockData = await trx.writer.find(key);
+        if (lockData === null) {
+            return null;
+        }
+        if (lockData.expiration === null) {
+            return lockData;
+        }
+        if (lockData.expiration <= new Date()) {
+            return null;
+        }
+        return lockData;
+    }
+    static async getReaderState(trx, key) {
+        const semaphore = await trx.reader.findSemaphore(key);
+        if (semaphore === null) {
+            return null;
+        }
+        const slots = await trx.reader.findSlots(key);
+        const unexpiredSlots = slots.filter((slot) => 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,
+        };
+    }
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async acquireWriter(key, lockId, ttl) {
+        return await this.adapter.transaction(async (trx) => {
+            const readerSemaphore = await trx.reader.findSemaphore(key);
+            if (readerSemaphore !== null) {
+                return false;
+            }
+            const writerLock = await trx.writer.find(key);
+            if (writerLock === null) {
+                await trx.writer.upsert(key, lockId, ttl?.toEndDate() ?? null);
+                return true;
+            }
+            if (writerLock.owner === lockId) {
+                return true;
+            }
+            if (writerLock.expiration === null) {
+                return false;
+            }
+            if (writerLock.expiration <= new Date()) {
+                await trx.writer.upsert(key, lockId, ttl?.toEndDate() ?? null);
+                return true;
+            }
+            return writerLock.expiration <= new Date();
+        });
+    }
+    async releaseWriter(key, lockId) {
+        return await this.adapter.transaction(async (trx) => {
+            const readerSemaphore = await trx.reader.findSemaphore(key);
+            if (readerSemaphore !== null) {
+                return false;
+            }
+            const lockData = await trx.writer.removeIfOwner(key, lockId);
+            if (lockData === null) {
+                return false;
+            }
+            const { expiration } = lockData;
+            const hasNoExpiration = expiration === null;
+            if (hasNoExpiration) {
+                return true;
+            }
+            const { owner } = lockData;
+            const isNotExpired = expiration > new Date();
+            const isCurrentOwner = lockId === owner;
+            return isNotExpired && isCurrentOwner;
+        });
+    }
+    async forceReleaseWriter(key) {
+        return await this.adapter.transaction(async (trx) => {
+            return DatabaseSharedLockAdapter._forceReleaseWriter(trx, key);
+        });
+    }
+    async refreshWriter(key, lockId, ttl) {
+        return await this.adapter.transaction(async (trx) => {
+            const readerSemaphore = await trx.reader.findSemaphore(key);
+            if (readerSemaphore !== null) {
+                return false;
+            }
+            const updateCount = await trx.writer.updateExpiration(key, lockId, ttl.toEndDate());
+            return Number(updateCount) > 0;
+        });
+    }
+    async acquireReader(settings) {
+        return await this.adapter.transaction(async (trx) => {
+            const writerLock = await trx.writer.find(settings.key);
+            if (writerLock !== null) {
+                return false;
+            }
+            const expiration = settings.ttl?.toEndDate() ?? null;
+            const semaphoreData = await trx.reader.findSemaphore(settings.key);
+            let limit = semaphoreData?.limit;
+            if (limit === undefined) {
+                limit = settings.limit;
+                await trx.reader.upsertSemaphore(settings.key, limit);
+            }
+            const slots = await trx.reader.findSlots(settings.key);
+            const unexpiredSlots = slots.filter((slot) => slot.expiration === null || slot.expiration > new Date());
+            if (unexpiredSlots.length === 0) {
+                await trx.reader.upsertSemaphore(settings.key, settings.limit);
+            }
+            if (unexpiredSlots.length >= limit) {
+                return false;
+            }
+            const hasNotSlot = unexpiredSlots.every((slot) => slot.id !== settings.lockId);
+            if (hasNotSlot) {
+                await trx.reader.upsertSlot(settings.key, settings.lockId, expiration);
+            }
+            return true;
+        });
+    }
+    async releaseReader(key, lockId) {
+        return await this.adapter.transaction(async (trx) => {
+            const writerLock = await trx.writer.find(key);
+            if (writerLock !== null) {
+                return false;
+            }
+            const semapahoreSlotData = await trx.reader.removeSlot(key, lockId);
+            if (semapahoreSlotData === null) {
+                return false;
+            }
+            return (semapahoreSlotData.expiration === null ||
+                semapahoreSlotData.expiration > new Date());
+        });
+    }
+    async forceReleaseAllReaders(key) {
+        return await this.adapter.transaction(async (trx) => {
+            return DatabaseSharedLockAdapter._forceReleaseAllReaders(trx, key);
+        });
+    }
+    async refreshReader(key, slotId, ttl) {
+        return await this.adapter.transaction(async (trx) => {
+            const writerLock = await trx.writer.find(key);
+            if (writerLock !== null) {
+                return false;
+            }
+            const updateCount = await trx.reader.updateExpiration(key, slotId, ttl.toEndDate());
+            return Number(updateCount) > 0;
+        });
+    }
+    async forceRelease(key) {
+        return await this.adapter.transaction(async (trx) => {
+            const [hasForceReleasedWriter, hasForceReleasedAllReaders] = await Promise.all([
+                await DatabaseSharedLockAdapter._forceReleaseWriter(trx, key),
+                await DatabaseSharedLockAdapter._forceReleaseAllReaders(trx, key),
+            ]);
+            return hasForceReleasedWriter || hasForceReleasedAllReaders;
+        });
+    }
+    async getState(key) {
+        return await this.adapter.transaction(async (trx) => {
+            const [writerState, readerState] = await Promise.all([
+                DatabaseSharedLockAdapter.getWriterState(trx, key),
+                DatabaseSharedLockAdapter.getReaderState(trx, key),
+            ]);
+            if (writerState === null && readerState === null) {
+                return null;
+            }
+            return {
+                writer: writerState,
+                reader: readerState,
+            };
+        });
+    }
+}
+//# sourceMappingURL=database-shared-lock-adapter.js.map

package/dist/shared-lock/implementations/derivables/shared-lock-provider/database-shared-lock-adapter.js.map

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

package/dist/shared-lock/implementations/derivables/shared-lock-provider/is-database-shared-lock-adapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module SharedLock
+ */
+import type { IDatabaseSharedLockAdapter, SharedLockAdapterVariants } from "../../../../shared-lock/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export declare function isDatabaseSharedLockAdapter(adapter: SharedLockAdapterVariants): adapter is IDatabaseSharedLockAdapter;

package/dist/shared-lock/implementations/derivables/shared-lock-provider/is-database-shared-lock-adapter.js

@@ -0,0 +1,12 @@
+/**
+ * @module SharedLock
+ */
+/**
+ * @internal
+ */
+export function isDatabaseSharedLockAdapter(adapter) {
+    const adapter_ = adapter;
+    return (typeof adapter_["transaction"] === "function" &&
+        adapter_["transaction"].length === 1);
+}
+//# sourceMappingURL=is-database-shared-lock-adapter.js.map

package/dist/shared-lock/implementations/derivables/shared-lock-provider/is-database-shared-lock-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-database-shared-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/shared-lock/implementations/derivables/shared-lock-provider/is-database-shared-lock-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACvC,OAAkC;IAElC,MAAM,QAAQ,GAAG,OAEhB,CAAC;IAEF,OAAO,CACH,OAAO,QAAQ,CAAC,aAAa,CAAC,KAAK,UAAU;QAC7C,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,CACvC,CAAC;AACN,CAAC"}

package/dist/shared-lock/implementations/derivables/shared-lock-provider/resolve-database-shared-lock-adapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module SharedLock
+ */
+import type { ISharedLockAdapter, SharedLockAdapterVariants } from "../../../../shared-lock/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export declare function resolveDatabaseSharedLockAdapter(adapter: SharedLockAdapterVariants): ISharedLockAdapter;

package/dist/shared-lock/implementations/derivables/shared-lock-provider/resolve-database-shared-lock-adapter.js

@@ -0,0 +1,15 @@
+/**
+ * @module SharedLock
+ */
+import { isDatabaseSharedLockAdapter } from "../../../../shared-lock/implementations/derivables/shared-lock-provider/is-database-shared-lock-adapter.js";
+import { DatabaseSharedLockAdapter } from "../../../../shared-lock/implementations/derivables/shared-lock-provider/database-shared-lock-adapter.js";
+/**
+ * @internal
+ */
+export function resolveDatabaseSharedLockAdapter(adapter) {
+    if (isDatabaseSharedLockAdapter(adapter)) {
+        return new DatabaseSharedLockAdapter(adapter);
+    }
+    return adapter;
+}
+//# sourceMappingURL=resolve-database-shared-lock-adapter.js.map

package/dist/shared-lock/implementations/derivables/shared-lock-provider/resolve-database-shared-lock-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-database-shared-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/shared-lock/implementations/derivables/shared-lock-provider/resolve-database-shared-lock-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kGAAkG,CAAC;AAC/I,OAAO,EAAE,yBAAyB,EAAE,MAAM,+FAA+F,CAAC;AAE1I;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC5C,OAAkC;IAElC,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/shared-lock/implementations/derivables/shared-lock-provider/shared-lock-provider.d.ts

@@ -0,0 +1,190 @@
+/**
+ * @module SharedLock
+ */
+import { type Invokable } from "../../../../utilities/_module-exports.js";
+import { type OneOrMore } from "../../../../utilities/_module-exports.js";
+import type { ISharedLock, SharedLockEventMap, SharedLockProviderCreateSettings, ISharedLockProvider, SharedLockAdapterVariants } from "../../../../shared-lock/contracts/_module-exports.js";
+import type { Task } from "../../../../task/_module-exports.js";
+import type { EventListener, IEventBus, Unsubscribe } from "../../../../event-bus/contracts/_module-exports.js";
+import type { ISerderRegister } from "../../../../serde/contracts/_module-exports.js";
+import { Namespace } from "../../../../namespace/namespace.js";
+import type { ITimeSpan } from "../../../../time-span/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock"`
+ * @group Derivables
+ */
+export type SharedLockProviderSettingsBase = {
+    /**
+     * @default
+     * ```ts
+     * import { Namespace } from "@daiso-tech/core/namespace";
+     *
+     * new Namespace("@shared-lock")
+     * ```
+     */
+    namespace?: Namespace;
+    serde: OneOrMore<ISerderRegister>;
+    /**
+     * @default ""
+     */
+    serdeTransformerName?: string;
+    /**
+     * You can pass your lock id id generator function.
+     */
+    createLockId?: Invokable<[], string>;
+    /**
+     * @default
+     * ```ts
+     * import { EventBus } from "@daiso-tech/core/event-bus";
+     * import { MemoryEventBusAdapter } from "@daiso-tech/core/event-bus/adapters";
+     *
+     * new EventBus({
+     *   adapter: new MemoryEventBusAdapter()
+     * })
+     * ```
+     */
+    eventBus?: IEventBus;
+    /**
+     * You can decide the default ttl value for {@link ISharedLock | `ISharedLock`} expiration. If null is passed then no ttl will be used by default.
+     * @default
+     * ```ts
+     * TimeSpan.fromMinutes(5);
+     * ```
+     */
+    defaultTtl?: ITimeSpan | null;
+    /**
+     * The default refresh time used in the {@link ISharedLock | `ISharedLock`} `acquireBlocking` and `runBlocking` methods.
+     * @default
+     * ```ts
+     * TimeSpan.fromSeconds(1);
+     * ```
+     */
+    defaultBlockingInterval?: ITimeSpan;
+    /**
+     * The default refresh time used in the {@link ISharedLock | `ISharedLock`} `acquireBlocking` and `runBlocking` methods.
+     * @default
+     * ```ts
+     * TimeSpan.fromMinutes(1);
+     * ```
+     */
+    defaultBlockingTime?: ITimeSpan;
+    /**
+     * The default refresh time used in the {@link ISharedLock | `ISharedLock`} `referesh` method.
+     * ```ts
+     * TimeSpan.fromMinutes(5);
+     * ```
+     */
+    defaultRefreshTime?: ITimeSpan;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock"`
+ * @group Derivables
+ */
+export type SharedLockProviderSettings = SharedLockProviderSettingsBase & {
+    adapter: SharedLockAdapterVariants;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock"`
+ * @group Derivables
+ */
+export declare const DEFAULT_SHARED_LOCK_NAMESPACE: Namespace;
+/**
+ * `SharedLockProvider` class can be derived from any {@link ISharedLockAdapter | `ISharedLockAdapter`} or {@link IDatabaseSharedLockAdapter | `IDatabaseSharedLockAdapter`}.
+ *
+ * Note the {@link ISharedLock | `ISharedLock`} instances created by the `SharedLockProvider` class are serializable and deserializable,
+ * allowing them to be seamlessly transferred across different servers, processes, and databases.
+ * This can be done directly using {@link ISerderRegister | `ISerderRegister`} or indirectly through components that rely on {@link ISerderRegister | `ISerderRegister`} internally.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/shared-lock"`
+ * @group Derivables
+ */
+export declare class SharedLockProvider implements ISharedLockProvider {
+    private readonly eventBus;
+    private readonly originalAdapter;
+    private readonly adapter;
+    private readonly namespace;
+    private readonly creatLockId;
+    private readonly defaultTtl;
+    private readonly defaultBlockingInterval;
+    private readonly defaultBlockingTime;
+    private readonly defaultRefreshTime;
+    private readonly serde;
+    private readonly serdeTransformerName;
+    /**
+     * @example
+     * ```ts
+     * import { SqliteSharedLockAdapter } from "@daiso-tech/core/shared-lock/adapters";
+     * import { SharedLockProvider } from "@daiso-tech/core/shared-lock";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters";
+     * import Sqlite from "better-sqlite3";
+     *
+     * const database = new Sqlite("local.db");
+     * const lockAdapter = new SqliteSharedLockAdapter({
+     *   database,
+     * });
+     * // You need initialize the adapter once before using it.
+     * await lockAdapter.init();
+     *
+     * const serde = new Serde(new SuperJsonSerdeAdapter())
+     * const lockProvider = new SharedLockProvider({
+     *   serde,
+     *   adapter: lockAdapter,
+     * });
+     * ```
+     */
+    constructor(settings: SharedLockProviderSettings);
+    private registerToSerde;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    addListener<TEventName extends keyof SharedLockEventMap>(eventName: TEventName, listener: EventListener<SharedLockEventMap[TEventName]>): Task<void>;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    removeListener<TEventName extends keyof SharedLockEventMap>(eventName: TEventName, listener: EventListener<SharedLockEventMap[TEventName]>): Task<void>;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    listenOnce<TEventName extends keyof SharedLockEventMap>(eventName: TEventName, listener: EventListener<SharedLockEventMap[TEventName]>): Task<void>;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    asPromise<TEventName extends keyof SharedLockEventMap>(eventName: TEventName): Task<SharedLockEventMap[TEventName]>;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    subscribeOnce<TEventName extends keyof SharedLockEventMap>(eventName: TEventName, listener: EventListener<SharedLockEventMap[TEventName]>): Task<Unsubscribe>;
+    /**
+     * You can listen to the following {@link SharedLockEventMap | `SharedLockEventMap`} of all {@link ISharedLock | `ISharedLock`} instances created by the {@link ISharedLockProvider | `ISharedLockProvider`}.
+     * To understand how this method works, refer to {@link IEventListenable | `IEventListenable `}.
+     */
+    subscribe<TEventName extends keyof SharedLockEventMap>(eventName: TEventName, listener: EventListener<SharedLockEventMap[TEventName]>): Task<Unsubscribe>;
+    /**
+     * @example
+     * ```ts
+     * import { SharedLockProvider } from "@daiso-tech/core/shared-lock";
+     * import { MemorySharedLockAdapter } from "@daiso-tech/core/shared-lock/adapters";
+     * import { Namespace } from "@daiso-tech/core/namespace";
+     * import { Serde } from "@daiso-tech/core/serde";
+     * import { SuperJsonSerdeAdapter } from "@daiso-tech/core/serde/adapters";
+     *
+     * const lockProvider = new SharedLockProvider({
+     *   adapter: new MemorySharedLockAdapter(),
+     *   namespace: new Namespace("shared_lock"),
+     *   serde: new Serde(new SuperJsonSerdeAdapter())
+     * });
+     *
+     * const lock = lockProvider.create("a");
+     * ```
+     */
+    create(key: string, settings: SharedLockProviderCreateSettings): ISharedLock;
+}