@daiso-tech/core 0.23.0 → 0.25.0

package/dist/lock/contracts/lock.errors.js

@@ -0,0 +1,165 @@
+/**
+ * @module Lock
+ */
+import { CORE, } from "../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class LockError extends Error {
+    static deserialize(serializedError) {
+        return new LockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class UnexpectedLockError extends LockError {
+    static deserialize(serializedError) {
+        return new UnexpectedLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class UnableToAquireLockError extends UnexpectedLockError {
+    static deserialize(serializedError) {
+        return new UnableToAquireLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class UnableToReleaseLockError extends UnexpectedLockError {
+    static deserialize(serializedError) {
+        return new UnableToReleaseLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class KeyAlreadyAcquiredLockError extends LockError {
+    static deserialize(serializedError) {
+        return new KeyAlreadyAcquiredLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class UnownedReleaseLockError extends LockError {
+    static deserialize(serializedError) {
+        return new UnownedReleaseLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export class UnownedRefreshLockError extends LockError {
+    static deserialize(serializedError) {
+        return new UnownedRefreshLockError(serializedError.message, serializedError.cause);
+    }
+    constructor(message, cause) {
+        super(message, { cause });
+    }
+    serialize() {
+        return {
+            cause: this.cause,
+            message: this.message,
+            name: this.name,
+        };
+    }
+}
+/**
+ * The <i>registerLockErrorsToSerde</i> function registers all <i>{@link ILock}</i> related errors with <i>IFlexibleSerde</i>, ensuring they will properly be serialized and deserialized.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export function registerLockErrorsToSerde(serde) {
+    if (!Array.isArray(serde)) {
+        serde = [serde];
+    }
+    for (const serde_ of serde) {
+        serde_
+            .registerClass(LockError, CORE)
+            .registerClass(UnexpectedLockError, CORE)
+            .registerClass(UnableToAquireLockError, CORE)
+            .registerClass(UnableToReleaseLockError, CORE)
+            .registerClass(KeyAlreadyAcquiredLockError, CORE)
+            .registerClass(UnownedReleaseLockError, CORE);
+    }
+}
+//# sourceMappingURL=lock.errors.js.map

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

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

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

@@ -0,0 +1,103 @@
+/**
+ * @module Lock
+ */
+import { BaseEvent } from "../../event-bus/contracts/_module-exports.js";
+import type { IFlexibleSerde } from "../../serde/contracts/_module-exports.js";
+import type { OneOrMore } from "../../utilities/types.js";
+import { type TimeSpan } from "../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class KeyAcquiredLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+    ttl: TimeSpan | null;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class KeyReleasedLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class KeyForceReleasedLockEvent extends BaseEvent<{
+    key: string;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class UnownedReleaseLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class UnownedRefreshLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class KeyAlreadyAcquiredLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class KeyRefreshedLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+    ttl: TimeSpan;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare class UnexpectedErrorLockEvent extends BaseEvent<{
+    key: string;
+    owner: string;
+    ttl: TimeSpan | null;
+    error: unknown;
+}> {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export type LockEvents = KeyAcquiredLockEvent | KeyReleasedLockEvent | UnownedReleaseLockEvent | UnownedRefreshLockEvent | KeyAlreadyAcquiredLockEvent | KeyForceReleasedLockEvent | KeyRefreshedLockEvent | UnexpectedErrorLockEvent;
+/**
+ * The <i>registerLockEventsToSerde</i> function registers all <i>{@link ILock}</i> related events with <i>IFlexibleSerde</i>, ensuring they will properly be serialized and deserialized.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export declare function registerLockEventsToSerde(serde: OneOrMore<IFlexibleSerde>): void;

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

@@ -0,0 +1,82 @@
+/**
+ * @module Lock
+ */
+import { BaseEvent } from "../../event-bus/contracts/_module-exports.js";
+import { CORE } from "../../utilities/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class KeyAcquiredLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class KeyReleasedLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class KeyForceReleasedLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class UnownedReleaseLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class UnownedRefreshLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class KeyAlreadyAcquiredLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class KeyRefreshedLockEvent extends BaseEvent {
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export class UnexpectedErrorLockEvent extends BaseEvent {
+}
+/**
+ * The <i>registerLockEventsToSerde</i> function registers all <i>{@link ILock}</i> related events with <i>IFlexibleSerde</i>, ensuring they will properly be serialized and deserialized.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Events
+ */
+export function registerLockEventsToSerde(serde) {
+    if (!Array.isArray(serde)) {
+        serde = [serde];
+    }
+    for (const serde_ of serde) {
+        serde_
+            .registerEvent(KeyAcquiredLockEvent, CORE)
+            .registerEvent(KeyReleasedLockEvent, CORE)
+            .registerEvent(UnownedReleaseLockEvent, CORE)
+            .registerEvent(KeyAlreadyAcquiredLockEvent, CORE)
+            .registerEvent(UnownedRefreshLockEvent, CORE)
+            .registerEvent(UnexpectedErrorLockEvent, CORE);
+    }
+}
+//# sourceMappingURL=lock.events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.events.js","sourceRoot":"","sources":["../../../src/lock/contracts/lock.events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAGrE,OAAO,EAAE,IAAI,EAAiB,MAAM,gCAAgC,CAAC;AAErE;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAIxC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAGxC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,SAE7C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,SAG3C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,SAG3C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,2BAA4B,SAAQ,SAG/C;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAIzC;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAK5C;CAAG;AAiBL;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACrC,KAAgC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM;aACD,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC;aACzC,aAAa,CAAC,uBAAuB,EAAE,IAAI,CAAC;aAC5C,aAAa,CAAC,2BAA2B,EAAE,IAAI,CAAC;aAChD,aAAa,CAAC,uBAAuB,EAAE,IAAI,CAAC;aAC5C,aAAa,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from "../../../lock/implementations/adapters/libsql-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/memory-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/mongodb-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/redis-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/sqlite-lock-adapter/_module.js";

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

@@ -0,0 +1,6 @@
+export * from "../../../lock/implementations/adapters/libsql-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/memory-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/mongodb-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/redis-lock-adapter/_module.js";
+export * from "../../../lock/implementations/adapters/sqlite-lock-adapter/_module.js";
+//# sourceMappingURL=_module-exports.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/lock/implementations/adapters/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,gEAAgE,CAAC;AAC/E,cAAc,gEAAgE,CAAC;AAC/E,cAAc,iEAAiE,CAAC;AAChF,cAAc,+DAA+D,CAAC;AAC9E,cAAc,gEAAgE,CAAC"}

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

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

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

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

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * @module Lock
+ */
+import type { IDatabaseLockAdapter, ILockData } from "../../../../lock/contracts/_module-exports.js";
+import type { Kysely } from "kysely";
+import { type IDeinitizable, type IInitizable, TimeSpan } from "../../../../utilities/_module-exports.js";
+/**
+ * @internal
+ */
+type KyselyLockTable = {
+    group: string;
+    key: string;
+    owner: string;
+    expiresAt: number | null;
+};
+/**
+ * @internal
+ */
+type KyselyTables = {
+    lock: KyselyLockTable;
+};
+/**
+ * @internal
+ */
+type KyselySettings = {
+    database: Kysely<KyselyTables>;
+    rootGroup: string;
+    expiredKeysRemovalInterval?: TimeSpan;
+    shouldRemoveExpiredKeys?: boolean;
+};
+/**
+ * @internal
+ */
+export declare class KyselyLockAdapter implements IDatabaseLockAdapter, IDeinitizable, IInitizable {
+    private readonly group;
+    private readonly database;
+    private readonly expiredKeysRemovalInterval;
+    private readonly shouldRemoveExpiredKeys;
+    private timeoutId;
+    constructor(settings: KyselySettings);
+    deInit(): Promise<void>;
+    init(): Promise<void>;
+    removeExpiredKeys(): 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;
+}
+export {};

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

@@ -0,0 +1,129 @@
+/**
+ * @module Lock
+ */
+import { TimeSpan, } from "../../../../utilities/_module-exports.js";
+import { resolveOneOrMoreStr } from "../../../../utilities/_module-exports.js";
+/**
+ * @internal
+ */
+export class KyselyLockAdapter {
+    group;
+    database;
+    expiredKeysRemovalInterval;
+    shouldRemoveExpiredKeys;
+    timeoutId;
+    constructor(settings) {
+        const { database, rootGroup, expiredKeysRemovalInterval = TimeSpan.fromMinutes(1), shouldRemoveExpiredKeys = true, } = settings;
+        this.expiredKeysRemovalInterval = expiredKeysRemovalInterval;
+        this.shouldRemoveExpiredKeys = shouldRemoveExpiredKeys;
+        this.database = database;
+        this.group = rootGroup;
+    }
+    async deInit() {
+        await this.database.schema
+            .dropIndex("lock_expiresAt")
+            .ifExists()
+            .on("lock")
+            .execute();
+        await this.database.schema.dropTable("lock").ifExists().execute();
+        if (this.shouldRemoveExpiredKeys) {
+            clearTimeout(this.timeoutId);
+        }
+    }
+    async init() {
+        await this.database.schema
+            .createTable("lock")
+            .ifNotExists()
+            .addColumn("group", "varchar(255)")
+            .addColumn("key", "varchar(255)")
+            .addColumn("owner", "varchar(255)")
+            .addColumn("expiresAt", "bigint")
+            .addPrimaryKeyConstraint("cache_unique_columns", ["group", "key"])
+            .execute();
+        await this.database.schema
+            .createIndex("lock_expiresAt")
+            .ifNotExists()
+            .on("lock")
+            .columns(["expiresAt"])
+            .execute();
+        if (this.shouldRemoveExpiredKeys) {
+            this.timeoutId = setTimeout(() => {
+                void this.removeExpiredKeys();
+            }, this.expiredKeysRemovalInterval.toMilliseconds());
+        }
+    }
+    async removeExpiredKeys() {
+        await this.database
+            .deleteFrom("lock")
+            .where("lock.expiresAt", "<=", new Date().getTime())
+            .execute();
+    }
+    async insert(key, owner, expiration) {
+        await this.database
+            .insertInto("lock")
+            .values({
+            key,
+            owner,
+            group: this.group,
+            expiresAt: expiration?.getTime() ?? null,
+        })
+            .execute();
+    }
+    async update(key, owner, expiration) {
+        const updateResult = await this.database
+            .updateTable("lock")
+            .where("lock.key", "=", key)
+            .where("lock.group", "=", this.group)
+            // Has expired
+            .where((eb) => eb.and([
+            eb("lock.expiresAt", "is not", null),
+            eb("lock.expiresAt", "<=", Date.now()),
+        ]))
+            .set({ owner, expiresAt: expiration?.getTime() ?? null })
+            .executeTakeFirst();
+        return Number(updateResult.numUpdatedRows); // > 0;
+    }
+    async remove(key, owner) {
+        await this.database
+            .deleteFrom("lock")
+            .where("lock.key", "=", key)
+            .where("lock.group", "=", this.group)
+            .$if(owner !== null, (query) => query.where("lock.owner", "=", owner))
+            .execute();
+    }
+    async refresh(key, owner, expiration) {
+        const updateResult = await this.database
+            .updateTable("lock")
+            .where("lock.key", "=", key)
+            .where("lock.group", "=", this.group)
+            .where("lock.owner", "=", owner)
+            .set({ expiresAt: expiration.getTime() })
+            .executeTakeFirst();
+        return Number(updateResult.numUpdatedRows); // > 0;
+    }
+    async find(key) {
+        const row = await this.database
+            .selectFrom("lock")
+            .where("lock.key", "=", key)
+            .where("lock.group", "=", this.group)
+            .select(["lock.owner", "lock.expiresAt"])
+            .executeTakeFirst();
+        if (row === undefined) {
+            return null;
+        }
+        return {
+            expiration: row.expiresAt ? new Date(row.expiresAt) : null,
+            owner: row.owner,
+        };
+    }
+    getGroup() {
+        return this.group;
+    }
+    withGroup(group) {
+        return new KyselyLockAdapter({
+            database: this.database,
+            rootGroup: resolveOneOrMoreStr([this.group, group]),
+        });
+    }
+}
+//# sourceMappingURL=kysely-lock-adapter.js.map

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

@@ -0,0 +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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"}

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

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

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

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

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

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

package/dist/lock/implementations/adapters/libsql-lock-adapter/libsql-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 { Client } from "@libsql/client";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export type LibsqlLockAdapterSettings = {
+    database: Client;
+    tableName?: string;
+    expiredKeysRemovalInterval?: TimeSpan;
+    shouldRemoveExpiredKeys?: boolean;
+    rootGroup: string;
+};
+/**
+ * To utilize the <i>LibsqlLockAdapter</i>, you must install the <i>"@libsql/client"</i> package.
+ *
+ * Note in order to use <i>LibsqlLockAdapter</i> correctly, ensure you use a single, consistent database across all server instances.
+ * This means you can't use libsql embedded replicas.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/implementations/adapters"```
+ * @group Adapters
+ */
+export declare class LibsqlLockAdapter implements IDatabaseLockAdapter, IDeinitizable, IInitizable {
+    private databaseLockAdapter;
+    /***
+     * @example
+     * ```ts
+     * import { LibsqlCacheAdapter } from "@daiso-tech/core/lock/implementations/adapters";
+     * import { createClient } from "@libsql/client";
+     *
+     * (async () => {
+     *   const database = createClient({ url: "file:local.db" });
+     *   const lockAdapter = new LibsqlCacheAdapter({
+     *     database,
+     *     rootGroup: "@global"
+     *   });
+     *   await lockAdapter.init();
+     * })();
+     * ```
+     */
+    constructor(settings: LibsqlLockAdapterSettings);
+    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;
+}