@daiso-tech/core 0.22.2 → 0.24.0

package/dist/lock/contracts/lock-provider.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-provider.contract.js","sourceRoot":"","sources":["../../../src/lock/contracts/lock-provider.contract.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,93 @@
+/**
+ * @module Lock
+ */
+import type { LazyPromiseable, Result, TimeSpan } from "../../utilities/_module-exports.js";
+import type { LazyPromise } from "../../async/_module-exports.js";
+import type { KeyAlreadyAcquiredLockError } from "../../lock/contracts/lock.errors.js";
+import type { IEventListener } from "../../event-bus/contracts/_module-exports.js";
+import type { LockEvents } from "../../lock/contracts/lock.events.js";
+/**
+ * The <i>ILockListener</i> contract defines a way for listening <i>{@link ILock}</i> operations.
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Contracts
+ */
+export type ILockListener = IEventListener<LockEvents>;
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Contracts
+ */
+export type ILock = ILockListener & {
+    /**
+     * @throws {UnableToAquireLockError} {@link UnableToAquireLockError}
+     * @throws {UnableToReleaseLockError} {@link UnableToReleaseLockError}
+     */
+    run<TValue = void>(asyncFn: LazyPromiseable<TValue>): LazyPromise<Result<TValue, KeyAlreadyAcquiredLockError>>;
+    /**
+     * @throws {UnableToAquireLockError} {@link UnableToAquireLockError}
+     * @throws {UnableToReleaseLockError} {@link UnableToReleaseLockError}
+     * @throws {KeyAlreadyAcquiredLockError} {@link KeyAlreadyAcquiredLockError}
+     */
+    runOrFail<TValue = void>(asyncFn: LazyPromiseable<TValue>): LazyPromise<TValue>;
+    /**
+     * The <i>acquire</i> method acquires a lock only if the lock is not already acquired.
+     * Throws an error if a different owner attempts to release the lock.
+     * Returns true if the lock is acquired otherwise true is returned.
+     * @throws {UnableToAquireLockError} {@link UnableToAquireLockError}
+     */
+    acquire(): LazyPromise<boolean>;
+    /**
+     * The <i>acquireOrFail</i> method acquires a lock only if the lock is not already acquired.
+     * Throws an error if already acquired.
+     * @throws {UnableToAquireLockError} {@link UnableToAquireLockError}
+     * @throws {KeyAlreadyAcquiredLockError} {@link KeyAlreadyAcquiredLockError}
+     */
+    acquireOrFail(): LazyPromise<void>;
+    /**
+     * The <i>release</i> method releases a lock if owned by the same owner.
+     * Returns true if the lock is released otherwise false is returned.
+     * @throws {UnableToReleaseLockError} {@link UnableToReleaseLockError}
+     */
+    release(): LazyPromise<boolean>;
+    /**
+     * The <i>releaseOrFail</i> method releases a lock if owned by the same owner.
+     * Throws an error if a different owner attempts to release the lock.
+     * @throws {UnableToReleaseLockError} {@link UnableToReleaseLockError}
+     * @throws {UnownedReleaseLockError} {@link UnownedReleaseLockError}
+     */
+    releaseOrFail(): LazyPromise<void>;
+    /**
+     * The <i>forceRelease</i> method releases a lock regardless of the owner.
+     * @throws {UnableToReleaseLockError} {@link UnableToReleaseLockError}
+     */
+    forceRelease(): LazyPromise<void>;
+    /**
+     * The <i>isExpired</i> method returns true if the expired otherwise false is returned.
+     */
+    isExpired(): LazyPromise<boolean>;
+    /**
+     * The <i>isLocked</i> method returns true if the locked otherwise false is returned.
+     */
+    isLocked(): LazyPromise<boolean>;
+    /**
+     * The <i>refresh</i> method updates the TTL of the lock if owned by the same owner.
+     * Returns true if the lock is refreshed occurs otherwise false is returned.
+     */
+    refresh(ttl?: TimeSpan): LazyPromise<boolean>;
+    /**
+     * The <i>refreshOrFail</i> method updates the TTL of the lock if owned by the same owner.
+     * Throws an error if a different owner attempts to refresh the lock.
+     * @throws {UnownedRefreshLockError} {@link UnownedRefreshLockError}
+     */
+    refreshOrFail(ttl?: TimeSpan): LazyPromise<void>;
+    /**
+     * The <i>getRemainingTime</i> return the reaming time as <i>{@link TimeSpan}</i>.
+     * Returns null if the key doesnt exist, key has no expiration and key has expired.
+     */
+    getRemainingTime(): LazyPromise<TimeSpan | null>;
+    /**
+     * The <i>getOwner</i> method return the current owner.
+     */
+    getOwner(): LazyPromise<string>;
+};

package/dist/lock/contracts/lock.contract.js

@@ -0,0 +1,5 @@
+/**
+ * @module Lock
+ */
+export {};
+//# sourceMappingURL=lock.contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.contract.js","sourceRoot":"","sources":["../../../src/lock/contracts/lock.contract.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,82 @@
+/**
+ * @module Lock
+ */
+import { type ISerializedError, type OneOrMore } from "../../utilities/_module-exports.js";
+import type { IFlexibleSerde, ISerializable } from "../../serde/contracts/_module-exports.js";
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class LockError extends Error implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): LockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class UnexpectedLockError extends LockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): UnexpectedLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class UnableToAquireLockError extends UnexpectedLockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): UnableToAquireLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class UnableToReleaseLockError extends UnexpectedLockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): UnableToReleaseLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class KeyAlreadyAcquiredLockError extends LockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): KeyAlreadyAcquiredLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class UnownedReleaseLockError extends LockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): UnownedReleaseLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/lock/contracts"```
+ * @group Errors
+ */
+export declare class UnownedRefreshLockError extends LockError implements ISerializable<ISerializedError> {
+    static deserialize(serializedError: ISerializedError): UnownedRefreshLockError;
+    constructor(message: string, cause?: unknown);
+    serialize(): ISerializedError;
+}
+/**
+ * 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 declare function registerLockErrorsToSerde(serde: OneOrMore<IFlexibleSerde>): void;

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 {};