@daiso-tech/core 0.38.0 → 0.40.0

package/dist/lock/contracts/lock.events.d.ts

@@ -52,13 +52,23 @@ export type UnownedRefreshTryLockEvent = {
     key: string;
     owner: string;
 };
+/**
+ * The event is dispatched when trying to refefresh a lock that is unexpireable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/lock/contracts"`
+ * @group Events
+ */
+export type UnexpireableKeyRefreshTryLockEvent = {
+    key: string;
+    owner: string;
+};
 /**
  * The event is dispatched when trying to acquire a lock that is owned by a different owner.
  *
  * IMPORT_PATH: `"@daiso-tech/core/lock/contracts"`
  * @group Events
  */
-export type NotAvailableLockEvent = {
+export type UnavailableLockEvent = {
     key: string;
     owner: string;
 };
@@ -94,7 +104,8 @@ export declare const LOCK_EVENTS: {
     readonly RELEASED: "RELEASED";
     readonly UNOWNED_RELEASE_TRY: "UNOWNED_RELEASE_TRY";
     readonly UNOWNED_REFRESH_TRY: "UNOWNED_REFRESH_TRY";
-    readonly NOT_AVAILABLE: "NOT_AVAILABLE";
+    readonly UNEXPIREABLE_KEY_REFRESH_TRY: "UNEXPIREABLE_KEY_REFRESH_TRY";
+    readonly UNAVAILABLE: "UNAVAILABLE";
     readonly FORCE_RELEASED: "FORCE_RELEASED";
     readonly REFRESHED: "REFRESHED";
     readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
@@ -109,7 +120,8 @@ export type LockEventMap = {
     [LOCK_EVENTS.RELEASED]: ReleasedLockEvent;
     [LOCK_EVENTS.UNOWNED_RELEASE_TRY]: UnownedReleaseTryLockEvent;
     [LOCK_EVENTS.UNOWNED_REFRESH_TRY]: UnownedRefreshTryLockEvent;
-    [LOCK_EVENTS.NOT_AVAILABLE]: NotAvailableLockEvent;
+    [LOCK_EVENTS.UNEXPIREABLE_KEY_REFRESH_TRY]: UnexpireableKeyRefreshTryLockEvent;
+    [LOCK_EVENTS.UNAVAILABLE]: UnavailableLockEvent;
     [LOCK_EVENTS.FORCE_RELEASED]: ForceReleasedLockEvent;
     [LOCK_EVENTS.REFRESHED]: RefreshedLockEvent;
     [LOCK_EVENTS.UNEXPECTED_ERROR]: UnexpectedErrorLockEvent;

package/dist/lock/contracts/lock.events.js

@@ -11,7 +11,8 @@ export const LOCK_EVENTS = {
     RELEASED: "RELEASED",
     UNOWNED_RELEASE_TRY: "UNOWNED_RELEASE_TRY",
     UNOWNED_REFRESH_TRY: "UNOWNED_REFRESH_TRY",
-    NOT_AVAILABLE: "NOT_AVAILABLE",
+    UNEXPIREABLE_KEY_REFRESH_TRY: "UNEXPIREABLE_KEY_REFRESH_TRY",
+    UNAVAILABLE: "UNAVAILABLE",
     FORCE_RELEASED: "FORCE_RELEASED",
     REFRESHED: "REFRESHED",
     UNEXPECTED_ERROR: "UNEXPECTED_ERROR",

package/dist/lock/contracts/lock.events.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.events.js","sourceRoot":"","sources":["../../../src/lock/contracts/lock.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;CAC9B,CAAC"}
+{"version":3,"file":"lock.events.js","sourceRoot":"","sources":["../../../src/lock/contracts/lock.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2GH;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,4BAA4B,EAAE,8BAA8B;IAC5D,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;CAC9B,CAAC"}

package/dist/lock/implementations/adapters/kysely-lock-adapter/kysely-lock-adapter.d.ts

@@ -1,25 +1,25 @@
 /**
  * @module Lock
  */
-import type { IDatabaseLockAdapter, ILockData } from "../../../../lock/contracts/_module-exports.js";
-import type { Kysely } from "kysely";
+import type { IDatabaseLockAdapter, ILockData, ILockExpirationData } from "../../../../lock/contracts/_module-exports.js";
+import { type Kysely } from "kysely";
 import { type IDeinitizable, type IInitizable, type IPrunable, TimeSpan } from "../../../../utilities/_module-exports.js";
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
  */
-type KyselyLockAdapterTable = {
+export type KyselyLockAdapterTable = {
     key: string;
     owner: string;
-    expiresAt: number | string | null;
+    expiration: number | bigint | string | null;
 };
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
  */
-type KyselyLockAdapterTables = {
+export type KyselyLockAdapterTables = {
     lock: KyselyLockAdapterTable;
 };
 /**
@@ -27,12 +27,39 @@ type KyselyLockAdapterTables = {
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
  */
-type KyselyLockAdapterSettings = {
+export type KyselyLockAdapterSettings = {
     kysely: Kysely<KyselyLockAdapterTables>;
+    /**
+     * @default
+     * ```ts
+     * TimeSpan.fromMinutes(1)
+     * ```
+     */
     expiredKeysRemovalInterval?: TimeSpan;
+    /**
+     * @default true
+     */
     shouldRemoveExpiredKeys?: boolean;
+    /**
+     *  @default
+     * ```ts
+     * () => new Date()
+     * ```
+     */
+    currentDate?: () => Date;
+    /**
+     * @default
+     * ```ts
+     * globalThis.setInterval
+     * ```
+     */
+    setInterval?: typeof setInterval;
 };
 /**
+ * To utilize the `KyselyLockAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselyLockAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
  *
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
@@ -42,6 +69,9 @@ export declare class KyselyLockAdapter implements IDatabaseLockAdapter, IDeiniti
     private readonly expiredKeysRemovalInterval;
     private readonly shouldRemoveExpiredKeys;
     private timeoutId;
+    private readonly currentDate;
+    private readonly setInterval;
+    private readonly isMysql;
     /**
      * @example
      * ```ts
@@ -64,9 +94,9 @@ export declare class KyselyLockAdapter implements IDatabaseLockAdapter, IDeiniti
     init(): Promise<void>;
     removeAllExpired(): Promise<void>;
     insert(key: string, owner: string, expiration: Date | null): Promise<void>;
-    update(key: string, owner: string, expiration: Date | null): Promise<number>;
-    remove(key: string, owner: string | null): Promise<void>;
-    refresh(key: string, owner: string, expiration: Date): Promise<number>;
+    updateIfExpired(key: string, owner: string, expiration: Date | null): Promise<number>;
+    remove(key: string): Promise<ILockExpirationData | null>;
+    removeIfOwner(key: string, owner: string): Promise<ILockData | null>;
+    updateExpirationIfOwner(key: string, owner: string, expiration: Date): Promise<number>;
     find(key: string): Promise<ILockData | null>;
 }
-export {};

package/dist/lock/implementations/adapters/kysely-lock-adapter/kysely-lock-adapter.js

@@ -1,8 +1,13 @@
 /**
  * @module Lock
  */
+import { MysqlAdapter } from "kysely";
 import { TimeSpan, } from "../../../../utilities/_module-exports.js";
 /**
+ * To utilize the `KyselyLockAdapter`, you must install the [`"kysely"`](https://www.npmjs.com/package/kysely) package and configure a `Kysely` class instance.
+ *
+ * Note in order to use `KyselyLockAdapter` correctly, ensure you use a single, consistent database across all server instances.
+ * The adapter have been tested with `sqlite`, `postgres` and `mysql` databases.
  *
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
@@ -12,6 +17,9 @@ export class KyselyLockAdapter {
     expiredKeysRemovalInterval;
     shouldRemoveExpiredKeys;
     timeoutId = null;
+    currentDate;
+    setInterval;
+    isMysql;
     /**
      * @example
      * ```ts
@@ -30,26 +38,30 @@ export class KyselyLockAdapter {
      * ```
      */
     constructor(settings) {
-        const { kysely, expiredKeysRemovalInterval = TimeSpan.fromMinutes(1), shouldRemoveExpiredKeys = true, } = settings;
+        const { kysely, expiredKeysRemovalInterval = TimeSpan.fromMinutes(1), shouldRemoveExpiredKeys = true, currentDate = () => new Date(), setInterval = globalThis.setInterval, } = settings;
         this.expiredKeysRemovalInterval = expiredKeysRemovalInterval;
         this.shouldRemoveExpiredKeys = shouldRemoveExpiredKeys;
         this.kysely = kysely;
+        this.isMysql =
+            this.kysely.getExecutor().adapter instanceof MysqlAdapter;
+        this.currentDate = currentDate;
+        this.setInterval = setInterval;
     }
     async deInit() {
         if (this.shouldRemoveExpiredKeys && this.timeoutId !== null) {
             clearTimeout(this.timeoutId);
         }
-        // Should not throw if the index does not exists thats why the try catch is used.
+        // Should throw if the index does not exists thats why the try catch is used.
         try {
             await this.kysely.schema
-                .dropIndex("lock_expiresAt")
+                .dropIndex("lock_expiration")
                 .on("lock")
                 .execute();
         }
         catch {
             /* EMPTY */
         }
-        // Should not throw if the table does not exists thats why the try catch is used.
+        // Should throw if the table does not exists thats why the try catch is used.
         try {
             await this.kysely.schema.dropTable("lock").execute();
         }
@@ -58,32 +70,31 @@ export class KyselyLockAdapter {
         }
     }
     async init() {
-        // Should not throw if the table already exists thats why the try catch is used.
+        // Should throw if the table already exists thats why the try catch is used.
         try {
             await this.kysely.schema
                 .createTable("lock")
-                .ifNotExists()
-                .addColumn("key", "varchar(255)", (col) => col.primaryKey())
-                .addColumn("owner", "varchar(255)")
-                .addColumn("expiresAt", "bigint")
+                .addColumn("key", "varchar(255)", (col) => col.notNull().primaryKey())
+                .addColumn("owner", "varchar(255)", (col) => col.notNull())
+                .addColumn("expiration", "bigint")
                 .execute();
         }
         catch {
             /* EMPTY */
         }
-        // Should not throw if the index already exists thats why the try catch is used.
+        // Should throw if the index already exists thats why the try catch is used.
         try {
             await this.kysely.schema
-                .createIndex("lock_expiresAt")
+                .createIndex("lock_expiration")
                 .on("lock")
-                .columns(["expiresAt"])
+                .columns(["expiration"])
                 .execute();
         }
         catch {
             /* EMPTY */
         }
         if (this.shouldRemoveExpiredKeys) {
-            this.timeoutId = setTimeout(() => {
+            this.timeoutId = this.setInterval(() => {
                 void this.removeAllExpired();
             }, this.expiredKeysRemovalInterval.toMilliseconds());
         }
@@ -91,7 +102,7 @@ export class KyselyLockAdapter {
     async removeAllExpired() {
         await this.kysely
             .deleteFrom("lock")
-            .where("lock.expiresAt", "<=", new Date().getTime())
+            .where("lock.expiration", "<=", this.currentDate().getTime())
             .execute();
     }
     async insert(key, owner, expiration) {
@@ -100,51 +111,138 @@ export class KyselyLockAdapter {
             .values({
             key,
             owner,
-            expiresAt: expiration?.getTime() ?? null,
+            expiration: expiration?.getTime() ?? null,
         })
             .execute();
     }
-    async update(key, owner, expiration) {
-        const updateResult = await this.kysely
+    async updateIfExpired(key, owner, expiration) {
+        const result = await this.kysely
             .updateTable("lock")
             .where("lock.key", "=", key)
-            // Has expired
-            .where((eb) => eb.and([
-            eb("lock.expiresAt", "is not", null),
-            eb("lock.expiresAt", "<=", Date.now()),
-        ]))
-            .set({ owner, expiresAt: expiration?.getTime() ?? null })
+            .where((eb) => {
+            const hasExpiration = eb("lock.expiration", "is not", null);
+            const hasExpired = eb("lock.expiration", "<=", Date.now());
+            return eb.and([hasExpiration, hasExpired]);
+        })
+            .set({
+            owner,
+            expiration: expiration?.getTime() ?? null,
+        })
             .executeTakeFirst();
-        return Number(updateResult.numUpdatedRows); // > 0;
+        return Number(result.numUpdatedRows);
     }
-    async remove(key, owner) {
-        await this.kysely
-            .deleteFrom("lock")
-            .where("lock.key", "=", key)
-            .$if(owner !== null, (query) => query.where("lock.owner", "=", owner))
-            .execute();
+    async remove(key) {
+        let result;
+        if (this.isMysql) {
+            result = await this.kysely
+                .transaction()
+                .setIsolationLevel("serializable")
+                .execute(async (trx) => {
+                const row = await trx
+                    .selectFrom("lock")
+                    .select("lock.expiration")
+                    .where("lock.key", "=", key)
+                    .executeTakeFirst();
+                await trx
+                    .deleteFrom("lock")
+                    .where("lock.key", "=", key)
+                    .executeTakeFirst();
+                return row;
+            });
+        }
+        else {
+            result = await this.kysely
+                .deleteFrom("lock")
+                .where("lock.key", "=", key)
+                .returning(["lock.expiration"])
+                .executeTakeFirst();
+        }
+        if (result === undefined) {
+            return null;
+        }
+        if (result.expiration === null) {
+            return {
+                expiration: null,
+            };
+        }
+        return {
+            expiration: new Date(Number(result.expiration)),
+        };
     }
-    async refresh(key, owner, expiration) {
-        const updateResult = await this.kysely
+    async removeIfOwner(key, owner) {
+        let row;
+        if (this.isMysql) {
+            row = await this.kysely
+                .transaction()
+                .setIsolationLevel("serializable")
+                .execute(async (trx) => {
+                const row = await trx
+                    .selectFrom("lock")
+                    .where("lock.key", "=", key)
+                    .where("lock.owner", "=", owner)
+                    .select(["lock.expiration", "lock.owner"])
+                    .executeTakeFirst();
+                await trx
+                    .deleteFrom("lock")
+                    .where("lock.key", "=", key)
+                    .where("lock.owner", "=", owner)
+                    .execute();
+                return row;
+            });
+        }
+        else {
+            row = await this.kysely
+                .deleteFrom("lock")
+                .where("lock.key", "=", key)
+                .where("lock.owner", "=", owner)
+                .returning(["lock.expiration", "lock.owner"])
+                .executeTakeFirst();
+        }
+        if (row === undefined) {
+            return null;
+        }
+        const { expiration } = row;
+        if (expiration === null) {
+            return {
+                owner: row.owner,
+                expiration: null,
+            };
+        }
+        return {
+            owner: row.owner,
+            expiration: new Date(Number(expiration)),
+        };
+    }
+    async updateExpirationIfOwner(key, owner, expiration) {
+        const result = await this.kysely
             .updateTable("lock")
             .where("lock.key", "=", key)
             .where("lock.owner", "=", owner)
-            .set({ expiresAt: expiration.getTime() })
+            .set({
+            expiration: expiration.getTime(),
+        })
             .executeTakeFirst();
-        return Number(updateResult.numUpdatedRows); // > 0;
+        return Number(result.numUpdatedRows);
     }
     async find(key) {
         const row = await this.kysely
             .selectFrom("lock")
+            .select(["lock.owner", "lock.expiration"])
             .where("lock.key", "=", key)
-            .select(["lock.owner", "lock.expiresAt"])
             .executeTakeFirst();
         if (row === undefined) {
             return null;
         }
+        const { owner, expiration } = row;
+        if (expiration === null) {
+            return {
+                owner,
+                expiration: null,
+            };
+        }
         return {
-            expiration: row.expiresAt ? new Date(Number(row.expiresAt)) : null,
-            owner: row.owner,
+            owner,
+            expiration: new Date(Number(expiration)),
         };
     }
 }

package/dist/lock/implementations/adapters/kysely-lock-adapter/kysely-lock-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"kysely-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/lock/implementations/adapters/kysely-lock-adapter/kysely-lock-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kysely-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/lock/implementations/adapters/kysely-lock-adapter/kysely-lock-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,YAAY,EAAe,MAAM,QAAQ,CAAC;AACnD,OAAO,EAIH,QAAQ,GACX,MAAM,gCAAgC,CAAC;AA+DxC;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IAGT,MAAM,CAAkC;IACxC,0BAA0B,CAAW;IACrC,uBAAuB,CAAU;IAC1C,SAAS,GACb,IAAI,CAAC;IACQ,WAAW,CAAa;IACxB,WAAW,CAAqB;IAChC,OAAO,CAAU;IAElC;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,QAAmC;QAC3C,MAAM,EACF,MAAM,EACN,0BAA0B,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EACpD,uBAAuB,GAAG,IAAI,EAC9B,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAC9B,WAAW,GAAG,UAAU,CAAC,WAAW,GACvC,GAAG,QAAQ,CAAC;QACb,IAAI,CAAC,0BAA0B,GAAG,0BAA0B,CAAC;QAC7D,IAAI,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO;YACR,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,YAAY,YAAY,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM;QACR,IAAI,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1D,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,6EAA6E;QAC7E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;iBACnB,SAAS,CAAC,iBAAiB,CAAC;iBAC5B,EAAE,CAAC,MAAM,CAAC;iBACV,OAAO,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;QAED,6EAA6E;QAC7E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACN,4EAA4E;QAC5E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;iBACnB,WAAW,CAAC,MAAM,CAAC;iBACnB,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CACtC,GAAG,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,CAC7B;iBACA,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;iBAC1D,SAAS,CAAC,YAAY,EAAE,QAAQ,CAAC;iBACjC,OAAO,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;QAED,4EAA4E;QAC5E,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;iBACnB,WAAW,CAAC,iBAAiB,CAAC;iBAC9B,EAAE,CAAC,MAAM,CAAC;iBACV,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;iBACvB,OAAO,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACL,WAAW;QACf,CAAC;QAED,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;gBACnC,KAAK,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjC,CAAC,EAAE,IAAI,CAAC,0BAA0B,CAAC,cAAc,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,MAAM,IAAI,CAAC,MAAM;aACZ,UAAU,CAAC,MAAM,CAAC;aAClB,KAAK,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,CAAC;aAC5D,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CACR,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,MAAM,IAAI,CAAC,MAAM;aACZ,UAAU,CAAC,MAAM,CAAC;aAClB,MAAM,CAAC;YACJ,GAAG;YACH,KAAK;YACL,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,IAAI;SAC5C,CAAC;aACD,OAAO,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,eAAe,CACjB,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM;aAC3B,WAAW,CAAC,MAAM,CAAC;aACnB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE;YACV,MAAM,aAAa,GAAG,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,EAAE,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAC3D,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;QAC/C,CAAC,CAAC;aACD,GAAG,CAAC;YACD,KAAK;YACL,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,IAAI;SAC5C,CAAC;aACD,gBAAgB,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,IAAI,MAA8D,CAAC;QACnE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM;iBACrB,WAAW,EAAE;iBACb,iBAAiB,CAAC,cAAc,CAAC;iBACjC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnB,MAAM,GAAG,GAAG,MAAM,GAAG;qBAChB,UAAU,CAAC,MAAM,CAAC;qBAClB,MAAM,CAAC,iBAAiB,CAAC;qBACzB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;qBAC3B,gBAAgB,EAAE,CAAC;gBACxB,MAAM,GAAG;qBACJ,UAAU,CAAC,MAAM,CAAC;qBAClB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;qBAC3B,gBAAgB,EAAE,CAAC;gBACxB,OAAO,GAAG,CAAC;YACf,CAAC,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM;iBACrB,UAAU,CAAC,MAAM,CAAC;iBAClB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;iBAC3B,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC;iBAC9B,gBAAgB,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO;gBACH,UAAU,EAAE,IAAI;aACnB,CAAC;QACN,CAAC;QACD,OAAO;YACH,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;SAClD,CAAC;IACN,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,KAAa;QAC1C,IAAI,GAEW,CAAC;QAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM;iBAClB,WAAW,EAAE;iBACb,iBAAiB,CAAC,cAAc,CAAC;iBACjC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnB,MAAM,GAAG,GAAG,MAAM,GAAG;qBAChB,UAAU,CAAC,MAAM,CAAC;qBAClB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;qBAC3B,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC;qBAC/B,MAAM,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;qBACzC,gBAAgB,EAAE,CAAC;gBACxB,MAAM,GAAG;qBACJ,UAAU,CAAC,MAAM,CAAC;qBAClB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;qBAC3B,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC;qBAC/B,OAAO,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC;YACf,CAAC,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACJ,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM;iBAClB,UAAU,CAAC,MAAM,CAAC;iBAClB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;iBAC3B,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC;iBAC/B,SAAS,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;iBAC5C,gBAAgB,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;QAC3B,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO;gBACH,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,UAAU,EAAE,IAAI;aACnB,CAAC;QACN,CAAC;QAED,OAAO;YACH,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;SAC3C,CAAC;IACN,CAAC;IAED,KAAK,CAAC,uBAAuB,CACzB,GAAW,EACX,KAAa,EACb,UAAgB;QAEhB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM;aAC3B,WAAW,CAAC,MAAM,CAAC;aACnB,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;aAC3B,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC;aAC/B,GAAG,CAAC;YACD,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE;SACnC,CAAC;aACD,gBAAgB,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM;aACxB,UAAU,CAAC,MAAM,CAAC;aAClB,MAAM,CAAC,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;aACzC,KAAK,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC;aAC3B,gBAAgB,EAAE,CAAC;QAExB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;QAClC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO;gBACH,KAAK;gBACL,UAAU,EAAE,IAAI;aACnB,CAAC;QACN,CAAC;QAED,OAAO;YACH,KAAK;YACL,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;SAC3C,CAAC;IACN,CAAC;CACJ"}

package/dist/lock/implementations/adapters/memory-lock-adapter/memory-lock-adapter.d.ts

@@ -1,8 +1,21 @@
 /**
  * @module Lock
  */
-import type { TimeSpan } from "../../../../utilities/_module-exports.js";
-import type { ILockAdapter, ILockData } from "../../../../lock/contracts/_module-exports.js";
+import type { IDeinitizable, TimeSpan } from "../../../../utilities/_module-exports.js";
+import { type ILockAdapter, type LockRefreshResult } from "../../../../lock/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
+ * @group Adapters
+ */
+export type MemoryLockData = {
+    owner: string;
+    hasExpiration: true;
+    timeoutId: string | number | NodeJS.Timeout;
+} | {
+    owner: string;
+    hasExpiration: false;
+};
 /**
  * Note the `MemoryLockAdapter` 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.
@@ -10,9 +23,8 @@ import type { ILockAdapter, ILockData } from "../../../../lock/contracts/_module
  * IMPORT_PATH: `"@daiso-tech/core/lock/adapters"`
  * @group Adapters
  */
-export declare class MemoryLockAdapter implements ILockAdapter {
+export declare class MemoryLockAdapter implements ILockAdapter, IDeinitizable {
     private readonly map;
-    private readonly timeoutMap;
     /**
      *  @example
      * ```ts
@@ -29,9 +41,10 @@ export declare class MemoryLockAdapter implements ILockAdapter {
      * const lockAdapter = new MemoryLockAdapter(map);
      * ```
      */
-    constructor(map?: Map<string, ILockData>);
+    constructor(map?: Map<string, MemoryLockData>);
+    deInit(): Promise<void>;
     acquire(key: string, owner: string, ttl: TimeSpan | null): Promise<boolean>;
     release(key: string, owner: string): Promise<boolean>;
-    forceRelease(key: string): Promise<void>;
-    refresh(key: string, owner: string, time: TimeSpan): Promise<boolean>;
+    forceRelease(key: string): Promise<boolean>;
+    refresh(key: string, owner: string, ttl: TimeSpan): Promise<LockRefreshResult>;
 }

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

@@ -1,6 +1,7 @@
 /**
  * @module Lock
  */
+import { LOCK_REFRESH_RESULT, } from "../../../../lock/contracts/_module-exports.js";
 /**
  * Note the `MemoryLockAdapter` 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.
@@ -10,7 +11,6 @@
  */
 export class MemoryLockAdapter {
     map;
-    timeoutMap = new Map();
     /**
      *  @example
      * ```ts
@@ -31,64 +31,88 @@ export class MemoryLockAdapter {
         this.map = map;
     }
     // eslint-disable-next-line @typescript-eslint/require-await
+    async deInit() {
+        for (const [key, lockData] of this.map) {
+            if (lockData.hasExpiration) {
+                clearTimeout(lockData.timeoutId);
+            }
+            this.map.delete(key);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
     async acquire(key, owner, ttl) {
-        const hasNotKey = !this.map.has(key);
-        if (hasNotKey) {
-            this.map.set(key, {
+        let lock = this.map.get(key);
+        if (lock !== undefined) {
+            return false;
+        }
+        if (ttl === null) {
+            lock = {
                 owner,
-                expiration: ttl?.toEndDate() ?? null,
-            });
+                hasExpiration: false,
+            };
+            this.map.set(key, lock);
         }
-        if (hasNotKey && ttl !== null) {
-            this.timeoutMap.set(key, setTimeout(() => {
+        else {
+            const timeoutId = setTimeout(() => {
                 this.map.delete(key);
-                this.timeoutMap.delete(key);
-            }, ttl.toMilliseconds()));
+            }, ttl.toMilliseconds());
+            lock = {
+                owner,
+                hasExpiration: true,
+                timeoutId,
+            };
+            this.map.set(key, lock);
         }
-        return hasNotKey;
+        return true;
     }
     // eslint-disable-next-line @typescript-eslint/require-await
     async release(key, owner) {
-        const data = this.map.get(key);
-        if (data === undefined) {
-            return true;
+        const lock = this.map.get(key);
+        if (lock === undefined) {
+            return false;
         }
-        if (data.owner !== owner) {
+        if (lock.owner !== owner) {
             return false;
         }
-        clearTimeout(this.timeoutMap.get(key));
-        this.timeoutMap.delete(key);
+        if (lock.hasExpiration) {
+            clearTimeout(lock.timeoutId);
+        }
         this.map.delete(key);
         return true;
     }
     // eslint-disable-next-line @typescript-eslint/require-await
     async forceRelease(key) {
-        clearTimeout(this.timeoutMap.get(key));
-        this.timeoutMap.delete(key);
+        const lock = this.map.get(key);
+        if (lock === undefined) {
+            return false;
+        }
+        if (lock.hasExpiration) {
+            clearTimeout(lock.timeoutId);
+        }
         this.map.delete(key);
+        return true;
     }
     // eslint-disable-next-line @typescript-eslint/require-await
-    async refresh(key, owner, time) {
-        const data = this.map.get(key);
-        if (data === undefined) {
-            return true;
+    async refresh(key, owner, ttl) {
+        const lock = this.map.get(key);
+        if (lock === undefined) {
+            return LOCK_REFRESH_RESULT.UNOWNED_REFRESH;
         }
-        if (data.owner !== owner) {
-            return false;
+        if (lock.owner !== owner) {
+            return LOCK_REFRESH_RESULT.UNOWNED_REFRESH;
         }
-        if (data.expiration === null) {
-            return true;
+        if (!lock.hasExpiration) {
+            return LOCK_REFRESH_RESULT.UNEXPIRABLE_KEY;
         }
+        clearTimeout(lock.timeoutId);
+        const timeoutId = setTimeout(() => {
+            this.map.delete(key);
+        }, ttl.toMilliseconds());
         this.map.set(key, {
-            ...data,
-            expiration: time.toEndDate(),
+            ...lock,
+            timeoutId,
         });
-        clearTimeout(this.timeoutMap.get(key));
-        this.timeoutMap.set(key, setTimeout(() => {
-            this.timeoutMap.delete(key);
-            this.map.delete(key);
-        }, time.toMilliseconds()));
-        return true;
+        return LOCK_REFRESH_RESULT.REFRESHED;
     }
 }
 //# sourceMappingURL=memory-lock-adapter.js.map