@daiso-tech/core 0.22.2 → 0.24.0

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

@@ -0,0 +1,180 @@
+/**
+ * @module Lock
+ */
+import { simplifyOneOrMoreStr, } from "../../../../utilities/_module-exports.js";
+import { UnexpectedLockError } from "../../../../lock/contracts/_module-exports.js";
+import { ObjectId } from "mongodb";
+/**
+ * To utilize the <i>MongodbLockAdapter</i>, you must install the <i>"mongodb"</i> package.
+ *
+ * Note in order to use <i>MongodbLockAdapter</i> correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export class MongodbLockAdapter {
+    group;
+    database;
+    collection;
+    collectionName;
+    collectionSettings;
+    /**
+     * @example
+     * ```ts
+     * import { MongodbLockAdapter } from "@daiso-tech/core/lock/implementations/adapters";
+     * import { MongoClient } from "mongodb";
+     *
+     * (async () => {
+     *   const client = await MongoClient.connect("YOUR_MONGODB_CONNECTION_STRING");
+     *   const database = client.db("database");
+     *   const lockAdapter = new MongodbLockAdapter({
+     *     database,
+     *     rootGroup: "@global"
+     *   });
+     *   await lockAdapter.init();
+     * })();
+     * ```
+     */
+    constructor({ collectionName = "cache", collectionSettings, database, rootGroup, }) {
+        this.collectionName = collectionName;
+        this.database = database;
+        this.collection = database.collection(collectionName, collectionSettings);
+        this.collectionSettings = collectionSettings;
+        this.group = rootGroup;
+    }
+    async removeExpiredKeys() {
+        await this.collection.deleteMany({
+            expiresAt: {
+                $lte: new Date(),
+            },
+        });
+    }
+    /**
+     * Creates all related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    async init() {
+        await this.collection.createIndex({
+            key: 1,
+            group: 1,
+        }, {
+            unique: true,
+        });
+        await this.collection.createIndex("expiresAt", {
+            expireAfterSeconds: 0,
+        });
+    }
+    /**
+     * Removes the collection where the cache values are stored and all it's related indexes.
+     * Note all cache data will be removed.
+     */
+    async deInit() {
+        await this.collection.dropIndexes();
+        await this.database.dropCollection(this.collectionName);
+    }
+    async insert(key, owner, expiration) {
+        const insertResult = await this.collection.insertOne({
+            _id: new ObjectId(),
+            key,
+            owner,
+            group: this.group,
+            expiresAt: expiration,
+        });
+        if (!insertResult.acknowledged) {
+            throw new UnexpectedLockError("Mongodb insertion was not acknowledged");
+        }
+    }
+    async update(key, owner, expiration) {
+        const updateResult = await this.collection.updateOne({
+            key,
+            group: this.group,
+            $and: [
+                {
+                    expiresAt: {
+                        $ne: null,
+                    },
+                },
+                {
+                    expiresAt: {
+                        $lte: new Date(),
+                    },
+                },
+            ],
+        }, {
+            $set: {
+                owner,
+                expiresAt: expiration,
+            },
+        });
+        if (!updateResult.acknowledged) {
+            throw new UnexpectedLockError("Mongodb update was not acknowledged");
+        }
+        return updateResult.modifiedCount; // > 0;
+    }
+    async remove(key, owner) {
+        if (owner === null) {
+            const deleteResult = await this.collection.deleteOne({
+                key,
+                group: this.group,
+            });
+            if (!deleteResult.acknowledged) {
+                throw new UnexpectedLockError("Mongodb deletion was not acknowledged");
+            }
+            return;
+        }
+        const deleteResult = await this.collection.deleteOne({
+            key,
+            group: this.group,
+            owner,
+        });
+        if (!deleteResult.acknowledged) {
+            throw new UnexpectedLockError("Mongodb deletion was not acknowledged");
+        }
+    }
+    async refresh(key, owner, expiration) {
+        const updateResult = await this.collection.updateOne({
+            key,
+            group: this.group,
+            owner,
+        }, {
+            $set: {
+                expiresAt: expiration,
+            },
+        });
+        if (!updateResult.acknowledged) {
+            throw new UnexpectedLockError("Mongodb update was not acknowledged");
+        }
+        return updateResult.modifiedCount; // > 0;
+    }
+    async find(key) {
+        const document = await this.collection.findOne({
+            key: key,
+            group: this.group,
+        }, {
+            projection: {
+                _id: 0,
+                owner: 1,
+                expiresAt: 1,
+            },
+        });
+        if (document === null) {
+            return null;
+        }
+        return {
+            owner: document.owner,
+            expiration: document.expiresAt,
+        };
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new MongodbLockAdapter({
+            database: this.database,
+            collectionName: this.collectionName,
+            collectionSettings: this.collectionSettings,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+}
+//# sourceMappingURL=mongodb-lock-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/lock/implementations/adapters/mongodb-lock-adapter/mongodb-lock-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGH,oBAAoB,GACvB,MAAM,gCAAgC,CAAC;AAKxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAyBnC;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IAGV,KAAK,CAAS;IACd,QAAQ,CAAK;IACb,UAAU,CAAkC;IAC5C,cAAc,CAAS;IACvB,kBAAkB,CAAqB;IAExD;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,EACR,cAAc,GAAG,OAAO,EACxB,kBAAkB,EAClB,QAAQ,EACR,SAAS,GACgB;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CACjC,cAAc,EACd,kBAAkB,CACrB,CAAC;QACF,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,iBAAiB;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC7B,SAAS,EAAE;gBACP,IAAI,EAAE,IAAI,IAAI,EAAE;aACnB;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAC7B;YACI,GAAG,EAAE,CAAC;YACN,KAAK,EAAE,CAAC;SACX,EACD;YACI,MAAM,EAAE,IAAI;SACf,CACJ,CAAC;QACF,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,EAAE;YAC3C,kBAAkB,EAAE,CAAC;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACR,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM,CACR,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YACjD,GAAG,EAAE,IAAI,QAAQ,EAAE;YACnB,GAAG;YACH,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,UAAU;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,mBAAmB,CACzB,wCAAwC,CAC3C,CAAC;QACN,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CACR,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAChD;YACI,GAAG;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YAEjB,IAAI,EAAE;gBACF;oBACI,SAAS,EAAE;wBACP,GAAG,EAAE,IAAI;qBACZ;iBACJ;gBACD;oBACI,SAAS,EAAE;wBACP,IAAI,EAAE,IAAI,IAAI,EAAE;qBACnB;iBACJ;aACJ;SACJ,EACD;YACI,IAAI,EAAE;gBACF,KAAK;gBACL,SAAS,EAAE,UAAU;aACxB;SACJ,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,mBAAmB,CACzB,qCAAqC,CACxC,CAAC;QACN,CAAC;QACD,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAoB;QAC1C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBACjD,GAAG;gBACH,KAAK,EAAE,IAAI,CAAC,KAAK;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;gBAC7B,MAAM,IAAI,mBAAmB,CACzB,uCAAuC,CAC1C,CAAC;YACN,CAAC;YACD,OAAO;QACX,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YACjD,GAAG;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACR,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,mBAAmB,CACzB,uCAAuC,CAC1C,CAAC;QACN,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CACT,GAAW,EACX,KAAa,EACb,UAAgB;QAEhB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAChD;YACI,GAAG;YACH,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK;SACR,EACD;YACI,IAAI,EAAE;gBACF,SAAS,EAAE,UAAU;aACxB;SACJ,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,IAAI,mBAAmB,CACzB,qCAAqC,CACxC,CAAC;QACN,CAAC;QACD,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAC1C;YACI,GAAG,EAAE,GAAG;YACR,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,EACD;YACI,UAAU,EAAE;gBACR,GAAG,EAAE,CAAC;gBACN,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC;aACf;SACJ,CACJ,CAAC;QACF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO;YACH,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,UAAU,EAAE,QAAQ,CAAC,SAAS;SACjC,CAAC;IACN,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,kBAAkB,CAAC;YAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;YAC3C,SAAS,EAAE,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACvD,CAAC,CAAC;IACP,CAAC;CACJ"}

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

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

package/dist/lock/implementations/adapters/redis-lock-adapter/_module.js

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

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * @module Lock
+ */
+import type { TimeSpan } from "../../../../utilities/_module-exports.js";
+import type { ILockAdapter } from "../../../../lock/contracts/_module-exports.js";
+import type { Redis } from "ioredis";
+import type { Result } from "ioredis";
+declare module "ioredis" {
+    interface RedisCommander<Context> {
+        daiso_lock_acquire(key: string, owner: string, ttl: string): Result<number, Context>;
+        daiso_lock_release(key: string, owner: string): Result<number, Context>;
+        daiso_lock_refresh(key: string, owner: string, ttl: string): Result<number, Context>;
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export type RedisLockAdapterSettings = {
+    database: Redis;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>RedisLockAdapter</i>, you must install the <i>"ioredis"</i> package.
+ *
+ * Note in order to use <i>RedisLockAdapter</i> correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class RedisLockAdapter implements ILockAdapter {
+    private readonly group;
+    private readonly database;
+    /**
+     * @example
+     * ```ts
+     * import { RedisLockAdapter, SuperJsonSerde } from "@daiso-tech/core/lock/implementations/adapters";
+     * import Redis from "ioredis";
+     *
+     * const database = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const serde = new SuperJsonSerde();
+     * const lockAdapter = new RedisLockAdapter({
+     *   database,
+     *   serde,
+     *   rootGroup: "@global"
+     * });
+     * ```
+     */
+    constructor(settings: RedisLockAdapterSettings);
+    private initAquireCommand;
+    private initReleaseCommand;
+    private initRefreshComand;
+    private getPrefix;
+    private withPrefix;
+    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, ttl: TimeSpan): Promise<boolean>;
+    getGroup(): string;
+    withGroup(group: string): ILockAdapter;
+}

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

@@ -0,0 +1,140 @@
+/**
+ * @module Lock
+ */
+import { simplifyOneOrMoreStr } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>RedisLockAdapter</i>, you must install the <i>"ioredis"</i> package.
+ *
+ * Note in order to use <i>RedisLockAdapter</i> correctly, ensure you use a single, consistent database across all server instances.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export class RedisLockAdapter {
+    group;
+    database;
+    /**
+     * @example
+     * ```ts
+     * import { RedisLockAdapter, SuperJsonSerde } from "@daiso-tech/core/lock/implementations/adapters";
+     * import Redis from "ioredis";
+     *
+     * const database = new Redis("YOUR_REDIS_CONNECTION_STRING");
+     * const serde = new SuperJsonSerde();
+     * const lockAdapter = new RedisLockAdapter({
+     *   database,
+     *   serde,
+     *   rootGroup: "@global"
+     * });
+     * ```
+     */
+    constructor(settings) {
+        const { database, rootGroup } = settings;
+        this.database = database;
+        this.group = rootGroup;
+        this.initAquireCommand();
+        this.initReleaseCommand();
+        this.initRefreshComand();
+    }
+    initAquireCommand() {
+        if (typeof this.database.daiso_lock_acquire === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_lock_acquire", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local owner = ARGV[1];
+                local ttl = ARGV[2]
+                
+                local hasKey = redis.call("exists", key)
+                if hasKey == 1 then
+                    return 0
+                end
+                
+                if ttl == "null" then
+                    redis.call("set", key, owner, "nx")
+                else
+                    redis.call("set", key, owner, "px", ttl, "nx")
+                end
+                
+                return 1
+                `,
+        });
+    }
+    initReleaseCommand() {
+        if (typeof this.database.daiso_lock_release === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_lock_release", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local owner = ARGV[1];
+
+                local owner_ = redis.call("get", key)
+                if owner_ == owner then
+                    redis.call("del", key)
+                    return 1
+                end
+                
+                return 0
+                `,
+        });
+    }
+    initRefreshComand() {
+        if (typeof this.database.daiso_lock_refresh === "function") {
+            return;
+        }
+        this.database.defineCommand("daiso_lock_refresh", {
+            numberOfKeys: 1,
+            lua: `
+                local key = KEYS[1];
+                local owner = ARGV[1];
+                local ttl = ARGV[2]
+
+                local owner_ = redis.call("get", key)
+                if owner_ == owner then
+                    redis.call("pexpire", key, ttl)
+                    return 1
+                end
+                return 0 
+            `,
+        });
+    }
+    getPrefix() {
+        return simplifyOneOrMoreStr([this.group, "__KEY__"]);
+    }
+    withPrefix(key) {
+        return simplifyOneOrMoreStr([this.getPrefix(), key]);
+    }
+    async acquire(key, owner, ttl) {
+        key = this.withPrefix(key);
+        const result = await this.database.daiso_lock_acquire(key, owner, String(ttl?.toMilliseconds() ?? null));
+        return result > 0;
+    }
+    async release(key, owner) {
+        key = this.withPrefix(key);
+        const result = await this.database.daiso_lock_release(key, owner);
+        return result === 1;
+    }
+    async forceRelease(key) {
+        key = this.withPrefix(key);
+        await this.database.del(key);
+    }
+    async refresh(key, owner, ttl) {
+        key = this.withPrefix(key);
+        const result = await this.database.daiso_lock_refresh(key, owner, ttl.toMilliseconds().toString());
+        return Boolean(result);
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new RedisLockAdapter({
+            database: this.database,
+            rootGroup: simplifyOneOrMoreStr([this.group, group]),
+        });
+    }
+}
+//# sourceMappingURL=redis-lock-adapter.js.map

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

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

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

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

package/dist/lock/implementations/adapters/sqlite-lock-adapter/_module.js

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

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @module Lock
+ */
+import type { IDatabaseLockAdapter, ILockData } from "../../../../lock/contracts/_module-exports.js";
+import { type IDeinitizable, type IInitizable, TimeSpan } from "../../../../utilities/_module-exports.js";
+import type { SqliteDatabase } from "kysely";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export type SqliteLockAdapterSettings = {
+    database: SqliteDatabase;
+    tableName?: string;
+    expiredKeysRemovalInterval?: TimeSpan;
+    shouldRemoveExpiredKeys?: boolean;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>SqliteLockAdapter</i>, you must install the <i>"better-sqlite3"</i> and <i>"@types/better-sqlite3"</i> packages.
+ *
+ * Note the <i>SqliteLockAdapter</i> is limited to single server usage and cannot be shared across multiple servers but it can be shared between different processes.
+ * To use it correctly, ensure all process instances access the same consistent, persisted database.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class SqliteLockAdapter implements IDatabaseLockAdapter, IDeinitizable, IInitizable {
+    private databaseLockAdapter;
+    /**
+     * @example
+     * ```ts
+     * import { SqliteLockAdapter } from "@daiso-tech/core/lock/implementations/adapters";
+     * import Sqlite from "better-sqlite3";
+     *
+     * (async () => {
+     *   const database = new Sqlite("local.db");
+     *   const lockAdapter = new SqliteLockAdapter({
+     *     database,
+     *     rootGroup: "@global"
+     *   });
+     *   await lockAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings: SqliteLockAdapterSettings);
+    removeExpiredKeys(): Promise<void>;
+    /**
+     * Removes the table where the cache values are stored and removes the table indexes.
+     * Note all cache data will be removed.
+     */
+    deInit(): Promise<void>;
+    /**
+     * Creates the table where the cache values are stored and it's related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    init(): 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>;
+    find(key: string): Promise<ILockData | null>;
+    getGroup(): string;
+    withGroup(group: string): IDatabaseLockAdapter;
+}

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

@@ -0,0 +1,92 @@
+/**
+ * @module Lock
+ */
+import { TimeSpan, } from "../../../../utilities/_module-exports.js";
+import { KyselyLockAdapter } from "../../../../lock/implementations/adapters/kysely-lock-adapter/_module.js";
+import { Kysely, SqliteDialect } from "kysely";
+import { KyselyTableNameTransformerPlugin } from "../../../../utilities/_module-exports.js";
+/**
+ * To utilize the <i>SqliteLockAdapter</i>, you must install the <i>"better-sqlite3"</i> and <i>"@types/better-sqlite3"</i> packages.
+ *
+ * Note the <i>SqliteLockAdapter</i> is limited to single server usage and cannot be shared across multiple servers but it can be shared between different processes.
+ * To use it correctly, ensure all process instances access the same consistent, persisted database.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export class SqliteLockAdapter {
+    databaseLockAdapter;
+    /**
+     * @example
+     * ```ts
+     * import { SqliteLockAdapter } from "@daiso-tech/core/lock/implementations/adapters";
+     * import Sqlite from "better-sqlite3";
+     *
+     * (async () => {
+     *   const database = new Sqlite("local.db");
+     *   const lockAdapter = new SqliteLockAdapter({
+     *     database,
+     *     rootGroup: "@global"
+     *   });
+     *   await lockAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings) {
+        const { database, tableName = "lock", shouldRemoveExpiredKeys = true, expiredKeysRemovalInterval = TimeSpan.fromMinutes(1), rootGroup, } = settings;
+        this.databaseLockAdapter = new KyselyLockAdapter({
+            database: new Kysely({
+                dialect: new SqliteDialect({
+                    database: database,
+                }),
+                plugins: [
+                    new KyselyTableNameTransformerPlugin({
+                        lock: tableName,
+                    }),
+                ],
+            }),
+            rootGroup,
+            expiredKeysRemovalInterval,
+            shouldRemoveExpiredKeys,
+        });
+    }
+    async removeExpiredKeys() {
+        await this.databaseLockAdapter.removeExpiredKeys();
+    }
+    /**
+     * Removes the table where the cache values are stored and removes the table indexes.
+     * Note all cache data will be removed.
+     */
+    async deInit() {
+        await this.databaseLockAdapter.deInit();
+    }
+    /**
+     * Creates the table where the cache values are stored and it's related indexes.
+     * Note the <i>init</i> method needs to be called before using the adapter.
+     */
+    async init() {
+        await this.databaseLockAdapter.init();
+    }
+    async insert(key, owner, expiration) {
+        await this.databaseLockAdapter.insert(key, owner, expiration);
+    }
+    async update(key, owner, expiration) {
+        return await this.databaseLockAdapter.update(key, owner, expiration);
+    }
+    async remove(key, owner) {
+        await this.databaseLockAdapter.remove(key, owner);
+    }
+    async refresh(key, owner, expiration) {
+        return await this.databaseLockAdapter.refresh(key, owner, expiration);
+    }
+    async find(key) {
+        return await this.databaseLockAdapter.find(key);
+    }
+    getGroup() {
+        return this.databaseLockAdapter.getGroup();
+    }
+    withGroup(group) {
+        return this.databaseLockAdapter.withGroup(group);
+    }
+}
+//# sourceMappingURL=sqlite-lock-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-lock-adapter.js","sourceRoot":"","sources":["../../../../../src/lock/implementations/adapters/sqlite-lock-adapter/sqlite-lock-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAGH,QAAQ,GACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gEAAgE,CAAC;AAEnG,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAelF;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IAGlB,mBAAmB,CAAoB;IAE/C;;;;;;;;;;;;;;;OAeG;IACH,YAAY,QAAmC;QAC3C,MAAM,EACF,QAAQ,EACR,SAAS,GAAG,MAAM,EAClB,uBAAuB,GAAG,IAAI,EAC9B,0BAA0B,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EACpD,SAAS,GACZ,GAAG,QAAQ,CAAC;QAEb,IAAI,CAAC,mBAAmB,GAAG,IAAI,iBAAiB,CAAC;YAC7C,QAAQ,EAAE,IAAI,MAAM,CAAC;gBACjB,OAAO,EAAE,IAAI,aAAa,CAAC;oBACvB,QAAQ,EAAE,QAAQ;iBACrB,CAAC;gBACF,OAAO,EAAE;oBACL,IAAI,gCAAgC,CAAC;wBACjC,IAAI,EAAE,SAAS;qBAClB,CAAC;iBACL;aACJ,CAAC;YACF,SAAS;YACT,0BAA0B;YAC1B,uBAAuB;SAC1B,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,iBAAiB;QACnB,MAAM,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACR,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CACR,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAAM,CACR,GAAW,EACX,KAAa,EACb,UAAuB;QAEvB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,KAAoB;QAC1C,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO,CACT,GAAW,EACX,KAAa,EACb,UAAgB;QAEhB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QAClB,OAAO,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;CACJ"}

package/dist/lock/implementations/derivables/_module-exports.d.ts

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

package/dist/lock/implementations/derivables/_module-exports.js

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

package/dist/lock/implementations/derivables/_module-exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/lock/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,4DAA4D,CAAC;AAC3E,cAAc,oEAAoE,CAAC"}

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

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

package/dist/lock/implementations/derivables/lock-provider/_module.js

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

package/dist/lock/implementations/derivables/lock-provider/_module.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * @module Lock
+ */
+import type { TimeSpan } from "../../../../utilities/_module-exports.js";
+import type { IDatabaseLockAdapter, ILockAdapter } from "../../../../lock/contracts/_module-exports.js";
+/**
+ * @internal
+ */
+export declare class DatabaseLockAdapter implements ILockAdapter {
+    private readonly adapter;
+    constructor(adapter: IDatabaseLockAdapter);
+    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, ttl: TimeSpan): Promise<boolean>;
+    getGroup(): string;
+    withGroup(group: string): ILockAdapter;
+}