@daiso-tech/core 0.39.0 → 0.41.0

package/dist/semaphore/implementations/derivables/semaphore-provider/semaphore.js

@@ -0,0 +1,336 @@
+/**
+ * @module Semaphore
+ */
+import { Task } from "../../../../task/_module-exports.js";
+import {} from "../../../../event-bus/contracts/_module-exports.js";
+import { FailedRefreshSemaphoreError, LimitReachedSemaphoreError, FailedReleaseSemaphoreError, SEMAPHORE_EVENTS, SEMAPHORE_STATE, isSemaphoreError, } from "../../../../semaphore/contracts/_module-exports.js";
+import { TimeSpan } from "../../../../time-span/implementations/_module-exports.js";
+import { resolveLazyable, resultFailure, resultSuccess, } from "../../../../utilities/_module-exports.js";
+/**
+ * @internal
+ */
+export class Semaphore {
+    /**
+     * @internal
+     */
+    static _internal_serialize(deserializedValue) {
+        return {
+            version: "1",
+            key: deserializedValue._key.get(),
+            limit: deserializedValue.limit,
+            slotId: deserializedValue.slotId,
+            ttlInMs: deserializedValue._ttl?.toMilliseconds() ?? null,
+        };
+    }
+    slotId;
+    limit;
+    adapter;
+    originalAdapter;
+    eventDispatcher;
+    _key;
+    _ttl;
+    defaultBlockingInterval;
+    defaultBlockingTime;
+    defaultRefreshTime;
+    serdeTransformerName;
+    namespace;
+    constructor(settings) {
+        const { slotId, limit, adapter, originalAdapter, eventDispatcher, key, ttl, serdeTransformerName, defaultBlockingInterval, defaultBlockingTime, defaultRefreshTime, namespace, } = settings;
+        this.namespace = namespace;
+        this.slotId = slotId;
+        this.limit = limit;
+        this.serdeTransformerName = serdeTransformerName;
+        this.adapter = adapter;
+        this.eventDispatcher = eventDispatcher;
+        this._key = key;
+        this._ttl = ttl;
+        this.defaultBlockingInterval = defaultBlockingInterval;
+        this.defaultBlockingTime = defaultBlockingTime;
+        this.defaultRefreshTime = defaultRefreshTime;
+        this.originalAdapter = originalAdapter;
+    }
+    _internal_getNamespace() {
+        return this.namespace;
+    }
+    _internal_getSerdeTransformerName() {
+        return this.serdeTransformerName;
+    }
+    _internal_getAdapter() {
+        return this.originalAdapter;
+    }
+    run(asyncFn) {
+        return new Task(async () => {
+            try {
+                const hasAquired = await this.acquire();
+                if (!hasAquired) {
+                    return resultFailure(new LimitReachedSemaphoreError(`Key "${this._key.get()}" has reached the limit ${String(this.limit)}`));
+                }
+                return resultSuccess(await resolveLazyable(asyncFn));
+            }
+            finally {
+                await this.release();
+            }
+        });
+    }
+    runOrFail(asyncFn) {
+        return new Task(async () => {
+            try {
+                await this.acquireOrFail();
+                return await resolveLazyable(asyncFn);
+            }
+            finally {
+                await this.release();
+            }
+        });
+    }
+    runBlocking(asyncFn, settings) {
+        return new Task(async () => {
+            try {
+                const hasAquired = await this.acquireBlocking(settings);
+                if (!hasAquired) {
+                    return resultFailure(new LimitReachedSemaphoreError(`Key "${this._key.get()}" has reached the limit ${String(this.limit)}`));
+                }
+                return resultSuccess(await resolveLazyable(asyncFn));
+            }
+            finally {
+                await this.release();
+            }
+        });
+    }
+    runBlockingOrFail(asyncFn, settings) {
+        return new Task(async () => {
+            try {
+                await this.acquireBlockingOrFail(settings);
+                return await resolveLazyable(asyncFn);
+            }
+            finally {
+                await this.release();
+            }
+        });
+    }
+    handleUnexpectedError = () => {
+        return async (args, next) => {
+            try {
+                return await next(...args);
+            }
+            catch (error) {
+                if (isSemaphoreError(error)) {
+                    throw error;
+                }
+                this.eventDispatcher
+                    .dispatch(SEMAPHORE_EVENTS.UNEXPECTED_ERROR, {
+                    error,
+                    semaphore: this,
+                })
+                    .detach();
+                throw error;
+            }
+        };
+    };
+    handleDispatch = (settings) => {
+        return async (args, next) => {
+            const result = await next(...args);
+            if (result && settings.on === "true") {
+                this.eventDispatcher
+                    .dispatch(settings.eventName, settings.eventData)
+                    .detach();
+            }
+            if (!result && settings.on === "false") {
+                this.eventDispatcher
+                    .dispatch(settings.eventName, settings.eventData)
+                    .detach();
+            }
+            return result;
+        };
+    };
+    acquire() {
+        return new Task(async () => {
+            return await this.adapter.acquire({
+                key: this._key.toString(),
+                slotId: this.slotId,
+                limit: this.limit,
+                ttl: this._ttl,
+            });
+        }).pipe([
+            this.handleUnexpectedError(),
+            this.handleDispatch({
+                on: "true",
+                eventName: SEMAPHORE_EVENTS.ACQUIRED,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+            this.handleDispatch({
+                on: "false",
+                eventName: SEMAPHORE_EVENTS.LIMIT_REACHED,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+        ]);
+    }
+    acquireOrFail() {
+        return new Task(async () => {
+            const hasAquired = await this.acquire();
+            if (!hasAquired) {
+                throw new LimitReachedSemaphoreError(`Key "${this._key.get()}" has reached the limit`);
+            }
+        });
+    }
+    acquireBlocking(settings = {}) {
+        return new Task(async () => {
+            const { time = this.defaultBlockingTime, interval = this.defaultBlockingInterval, } = settings;
+            const timeAsTimeSpan = TimeSpan.fromTimeSpan(time);
+            const intervalAsTimeSpan = TimeSpan.fromTimeSpan(interval);
+            const endDate = timeAsTimeSpan.toEndDate();
+            while (endDate.getTime() > new Date().getTime()) {
+                const hasAquired = await this.acquire();
+                if (hasAquired) {
+                    return true;
+                }
+                await Task.delay(intervalAsTimeSpan);
+            }
+            return false;
+        });
+    }
+    acquireBlockingOrFail(settings) {
+        return new Task(async () => {
+            const hasAquired = await this.acquireBlocking(settings);
+            if (!hasAquired) {
+                throw new LimitReachedSemaphoreError(`Key "${this._key.get()}" has reached the limit`);
+            }
+        });
+    }
+    release() {
+        return new Task(async () => {
+            return await this.adapter.release(this._key.toString(), this.slotId);
+        }).pipe([
+            this.handleUnexpectedError(),
+            this.handleDispatch({
+                on: "true",
+                eventName: SEMAPHORE_EVENTS.RELEASED,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+            this.handleDispatch({
+                on: "false",
+                eventName: SEMAPHORE_EVENTS.FAILED_RELEASE,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+        ]);
+    }
+    releaseOrFail() {
+        return new Task(async () => {
+            const hasReleased = await this.release();
+            if (!hasReleased) {
+                throw new FailedReleaseSemaphoreError(`Failed to release slot "${this.slotId}" of key "${this._key.get()}"`);
+            }
+        });
+    }
+    forceReleaseAll() {
+        return new Task(async () => {
+            return await this.adapter.forceReleaseAll(this._key.toString());
+        }).pipe([
+            this.handleUnexpectedError(),
+            async (args, next) => {
+                const hasReleased = await next(...args);
+                this.eventDispatcher
+                    .dispatch(SEMAPHORE_EVENTS.ALL_FORCE_RELEASED, {
+                    semaphore: this,
+                    hasReleased,
+                })
+                    .detach();
+                return hasReleased;
+            },
+        ]);
+    }
+    refresh(ttl = this.defaultRefreshTime) {
+        return new Task(async () => {
+            return await this.adapter.refresh(this._key.toString(), this.slotId, TimeSpan.fromTimeSpan(ttl));
+        }).pipe([
+            this.handleUnexpectedError(),
+            this.handleDispatch({
+                on: "true",
+                eventName: SEMAPHORE_EVENTS.REFRESHED,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+            this.handleDispatch({
+                on: "false",
+                eventName: SEMAPHORE_EVENTS.FAILED_REFRESH,
+                eventData: {
+                    semaphore: this,
+                },
+            }),
+            async (args, next) => {
+                const hasRefreshed = await next(...args);
+                if (hasRefreshed) {
+                    this._ttl = TimeSpan.fromTimeSpan(ttl);
+                }
+                return hasRefreshed;
+            },
+        ]);
+    }
+    refreshOrFail(ttl) {
+        return new Task(async () => {
+            const hasRefreshed = await this.refresh(ttl);
+            if (!hasRefreshed) {
+                throw new FailedRefreshSemaphoreError(`Failed to refresh slot "${this.slotId}" of key "${this._key.get()}"`);
+            }
+        });
+    }
+    get id() {
+        return this.slotId;
+    }
+    get ttl() {
+        return this._ttl;
+    }
+    get key() {
+        return this._key.get();
+    }
+    getState() {
+        return new Task(async () => {
+            const state = await this.adapter.getState(this._key.toString());
+            if (state === null) {
+                return {
+                    type: SEMAPHORE_STATE.EXPIRED,
+                };
+            }
+            if (state.acquiredSlots.size >= state.limit) {
+                return {
+                    type: SEMAPHORE_STATE.LIMIT_REACHED,
+                    limit: state.limit,
+                    acquiredSlots: [...state.acquiredSlots.keys()],
+                };
+            }
+            const slot = state.acquiredSlots.get(this.slotId);
+            if (slot === undefined) {
+                return {
+                    type: SEMAPHORE_STATE.UNACQUIRED,
+                    acquiredSlots: [...state.acquiredSlots.keys()],
+                    acquiredSlotsCount: state.acquiredSlots.size,
+                    freeSlotsCount: state.limit - state.acquiredSlots.size,
+                    limit: state.limit,
+                };
+            }
+            return {
+                type: SEMAPHORE_STATE.ACQUIRED,
+                acquiredSlots: [...state.acquiredSlots.keys()],
+                acquiredSlotsCount: state.acquiredSlots.size,
+                freeSlotsCount: state.limit - state.acquiredSlots.size,
+                limit: state.limit,
+                remainingTime: slot === null
+                    ? null
+                    : TimeSpan.fromDateRange({
+                        start: new Date(),
+                        end: slot,
+                    }),
+            };
+        }).pipe(this.handleUnexpectedError());
+    }
+}
+//# sourceMappingURL=semaphore.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider/semaphore.js.map

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

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../../semaphore/implementations/derivables/semaphore-provider-factory/_module.js";

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../../semaphore/implementations/derivables/semaphore-provider-factory/_module.js";
+//# sourceMappingURL=_module.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider-factory/_module.ts"],"names":[],"mappings":"AAAA,cAAc,8EAA8E,CAAC"}

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/semaphore-provider-factory.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module Semaphore
+ */
+import type { IEventBus } from "../../../../event-bus/contracts/_module-exports.js";
+import type { ISemaphoreProviderFactory, ISemaphoreProvider, SemaphoreAdapterVariants } from "../../../../semaphore/contracts/_module-exports.js";
+import { type SemaphoreProviderSettingsBase } from "../../../../semaphore/implementations/derivables/semaphore-provider/_module.js";
+import type { ITimeSpan } from "../../../../time-span/contracts/_module-exports.js";
+import type { Namespace } from "../../../../namespace/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore"`
+ * @group Derivables
+ */
+export type SemaphoreAdapters<TAdapters extends string> = Partial<Record<TAdapters, SemaphoreAdapterVariants>>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore"`
+ * @group Derivables
+ */
+export type SemaphoreProviderFactorySettings<TAdapters extends string> = SemaphoreProviderSettingsBase & {
+    adapters: SemaphoreAdapters<TAdapters>;
+    defaultAdapter?: NoInfer<TAdapters>;
+};
+/**
+ * The `SemaphoreProviderFactory` class is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore"`
+ * @group Derivables
+ */
+export declare class SemaphoreProviderFactory<TAdapters extends string> implements ISemaphoreProviderFactory<TAdapters> {
+    private readonly settings;
+    constructor(settings: SemaphoreProviderFactorySettings<TAdapters>);
+    setNamespace(namespace: Namespace): SemaphoreProviderFactory<TAdapters>;
+    setEventBus(eventBus: IEventBus): SemaphoreProviderFactory<TAdapters>;
+    setDefaultTtl(ttl: ITimeSpan): SemaphoreProviderFactory<TAdapters>;
+    setDefaultBlockingInterval(interval: ITimeSpan): SemaphoreProviderFactory<TAdapters>;
+    setDefaultBlockingTime(time: ITimeSpan): SemaphoreProviderFactory<TAdapters>;
+    setDefaultRefreshTime(time: ITimeSpan): SemaphoreProviderFactory<TAdapters>;
+    use(adapterName?: TAdapters | undefined): ISemaphoreProvider;
+}

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/semaphore-provider-factory.js

@@ -0,0 +1,67 @@
+import { DefaultAdapterNotDefinedError, UnregisteredAdapterError, } from "../../../../utilities/_module-exports.js";
+import { DEFAULT_SEMAPHORE_PROVIDER_NAMESPACE, SemaphoreProvider, } from "../../../../semaphore/implementations/derivables/semaphore-provider/_module.js";
+/**
+ * The `SemaphoreProviderFactory` class is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore"`
+ * @group Derivables
+ */
+export class SemaphoreProviderFactory {
+    settings;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    setNamespace(namespace) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            namespace,
+        });
+    }
+    setEventBus(eventBus) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            eventBus,
+        });
+    }
+    setDefaultTtl(ttl) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            defaultTtl: ttl,
+        });
+    }
+    setDefaultBlockingInterval(interval) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            defaultBlockingInterval: interval,
+        });
+    }
+    setDefaultBlockingTime(time) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            defaultBlockingTime: time,
+        });
+    }
+    setDefaultRefreshTime(time) {
+        return new SemaphoreProviderFactory({
+            ...this.settings,
+            defaultRefreshTime: time,
+        });
+    }
+    use(adapterName = this.settings.defaultAdapter) {
+        if (adapterName === undefined) {
+            throw new DefaultAdapterNotDefinedError(SemaphoreProviderFactory.name);
+        }
+        const adapter = this.settings.adapters[adapterName];
+        if (adapter === undefined) {
+            throw new UnregisteredAdapterError(adapterName);
+        }
+        const { namespace = DEFAULT_SEMAPHORE_PROVIDER_NAMESPACE } = this.settings;
+        return new SemaphoreProvider({
+            ...this.settings,
+            adapter,
+            namespace: namespace.appendRoot(adapterName),
+            serdeTransformerName: adapterName,
+        });
+    }
+}
+//# sourceMappingURL=semaphore-provider-factory.js.map

package/dist/semaphore/implementations/derivables/semaphore-provider-factory/semaphore-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore-provider-factory.js","sourceRoot":"","sources":["../../../../../src/semaphore/implementations/derivables/semaphore-provider-factory/semaphore-provider-factory.ts"],"names":[],"mappings":"AASA,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACH,oCAAoC,EACpC,iBAAiB,GAEpB,MAAM,sEAAsE,CAAC;AAyB9E;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAIZ;IADrB,YACqB,QAAqD;QAArD,aAAQ,GAAR,QAAQ,CAA6C;IACvE,CAAC;IAEJ,YAAY,CAAC,SAAoB;QAC7B,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,QAAmB;QAC3B,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IAED,aAAa,CAAC,GAAc;QACxB,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,UAAU,EAAE,GAAG;SAClB,CAAC,CAAC;IACP,CAAC;IAED,0BAA0B,CACtB,QAAmB;QAEnB,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,uBAAuB,EAAE,QAAQ;SACpC,CAAC,CAAC;IACP,CAAC;IAED,sBAAsB,CAClB,IAAe;QAEf,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,mBAAmB,EAAE,IAAI;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,qBAAqB,CACjB,IAAe;QAEf,OAAO,IAAI,wBAAwB,CAAC;YAChC,GAAG,IAAI,CAAC,QAAQ;YAChB,kBAAkB,EAAE,IAAI;SAC3B,CAAC,CAAC;IACP,CAAC;IAED,GAAG,CACC,cAAqC,IAAI,CAAC,QAAQ,CAAC,cAAc;QAEjE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,6BAA6B,CACnC,wBAAwB,CAAC,IAAI,CAChC,CAAC;QACN,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,EAAE,SAAS,GAAG,oCAAoC,EAAE,GACtD,IAAI,CAAC,QAAQ,CAAC;QAClB,OAAO,IAAI,iBAAiB,CAAC;YACzB,GAAG,IAAI,CAAC,QAAQ;YAChB,OAAO;YACP,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC;YAC5C,oBAAoB,EAAE,WAAW;SACpC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/semaphore/implementations/test-utilities/_module-exports.d.ts

@@ -0,0 +1,3 @@
+export * from "../../../semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.js";
+export * from "../../../semaphore/implementations/test-utilities/semaphore-adapter.test-suite.js";
+export * from "../../../semaphore/implementations/test-utilities/semaphore-provider.test-suite.js";

package/dist/semaphore/implementations/test-utilities/_module-exports.js

@@ -0,0 +1,4 @@
+export * from "../../../semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.js";
+export * from "../../../semaphore/implementations/test-utilities/semaphore-adapter.test-suite.js";
+export * from "../../../semaphore/implementations/test-utilities/semaphore-provider.test-suite.js";
+//# sourceMappingURL=_module-exports.js.map

package/dist/semaphore/implementations/test-utilities/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/semaphore/implementations/test-utilities/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,qFAAqF,CAAC;AACpG,cAAc,4EAA4E,CAAC;AAC3F,cAAc,6EAA6E,CAAC"}

package/dist/semaphore/implementations/test-utilities/database-semaphore-adapter.test-suite.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @module Semaphore
+ */
+import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
+import { type IDatabaseSemaphoreAdapter } from "../../../semaphore/contracts/_module-exports.js";
+import type { Promisable } from "../../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/test-utilities"`
+ * @group Utilities
+ */
+export type DatabaseSemaphoreAdapterTestSuiteSettings = {
+    expect: ExpectStatic;
+    test: TestAPI;
+    describe: SuiteAPI;
+    beforeEach: typeof beforeEach;
+    createAdapter: () => Promisable<IDatabaseSemaphoreAdapter>;
+};
+/**
+ * The `databaseSemaphoreAdapterTestSuite` function simplifies the process of testing your custom implementation of {@link IDatabaseSemaphoreAdapter | `IDatabaseSemaphoreAdapter`} with `vitest`.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/semaphore/test-utilities"`
+ * @group Utilities
+ * @example
+ * ```ts
+ * import { afterEach, beforeEach, describe, expect, test } from "vitest";
+ * import { databaseSemaphoreAdapterTestSuite } from "@daiso-tech/core/semaphore/test-utilities";
+ * import { LibsqlSemaphoreAdapter } from "@daiso-tech/core/semaphore/adapters";
+ * import { type Client, createClient } from "@libsql/client";
+ *
+ * describe("class: LibsqlSemaphoreAdapter", () => {
+ *     let client: Client;
+ *     beforeEach(() => {
+ *         client = createClient({
+ *             url: ":memory:",
+ *         });
+ *     });
+ *     afterEach(() => {
+ *         client.close();
+ *     });
+ *     databaseSemaphoreAdapterTestSuite({
+ *         createAdapter: async () => {
+ *             const semaphoreAdapter = new LibsqlSemaphoreAdapter({
+ *                database: client,
+ *                 tableName: "custom_table",
+ *                 shouldRemoveExpiredKeys: false,
+ *             });
+ *             await semaphoreAdapter.init();
+ *             return semaphoreAdapter;
+ *         },
+ *         test,
+ *         beforeEach,
+ *         expect,
+ *         describe,
+ *     });
+ * });
+ * ```
+ */
+export declare function databaseSemaphoreAdapterTestSuite(settings: DatabaseSemaphoreAdapterTestSuiteSettings): void;