@daiso-tech/core 0.26.1 → 0.28.0

package/dist/utilities/{pipeline → classes/pipeline}/pipeline.d.ts

@@ -1,14 +1,15 @@
 /**
  * @module Utilities
  */
-import { LazyPromise } from "../../async/_module-exports.js";
-import type { AsyncLazyable, IInvokableObject, Invokable } from "../../utilities/types.js";
+import { LazyPromise } from "../../../async/_module-exports.js";
+import type { AsyncLazyable, IInvokableObject, Invokable } from "../../../utilities/types.js";
 /**
  * The <i>Pipeline</i> class provides a convenient way to pipe multiple functions and <i>{@link IInvokableObject}</i>,
  * giving each functions and <i>{@link IInvokableObject}</i> the opportunity to inspect or modify the input.
  * Pipeline class is immutable meaning you can extend it without causing problems.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group Pipeline
  */
 export declare class Pipeline<TInitial, TPrev = TInitial, TCurrent = TPrev> implements IInvokableObject<AsyncLazyable<TInitial>, TCurrent> {
     /**

package/dist/utilities/{pipeline → classes/pipeline}/pipeline.js

@@ -1,14 +1,15 @@
 /**
  * @module Utilities
  */
-import { LazyPromise } from "../../async/_module-exports.js";
-import { resolveAsyncLazyable } from "../../utilities/functions.js";
+import { LazyPromise } from "../../../async/_module-exports.js";
+import { resolveAsyncLazyable } from "../../../utilities/functions.js";
 /**
  * The <i>Pipeline</i> class provides a convenient way to pipe multiple functions and <i>{@link IInvokableObject}</i>,
  * giving each functions and <i>{@link IInvokableObject}</i> the opportunity to inspect or modify the input.
  * Pipeline class is immutable meaning you can extend it without causing problems.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group Pipeline
  */
 export class Pipeline {
     /**

package/dist/utilities/classes/pipeline/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../src/utilities/classes/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAMzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,OAAO,QAAQ;IAGjB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,MAAM,CAAC,KAAK;QACR,OAAO,IAAI,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,OAAO,CACxB,KAAa,EACb,IAAgC;QAEhC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEgB,KAAK,GAA0B,EAAE,CAAC;IAEnD,YAAoB,IAA0B;QAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED,IAAI,CACA,IAAgC;QAEhC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,KAA8B;QACjC,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;YACpC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACrB,+DAA+D;gBAC/D,OAAO,aAAoB,CAAC;YAChC,CAAC;YACD,mEAAmE;YACnE,IAAI,MAAM,GAAa,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,mEAAmE;gBACnE,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/utilities/classes/time-span/_module.d.ts

@@ -0,0 +1 @@
+export * from "../../../utilities/classes/time-span/time-span.js";

package/dist/utilities/classes/time-span/_module.js

@@ -0,0 +1,2 @@
+export * from "../../../utilities/classes/time-span/time-span.js";
+//# sourceMappingURL=_module.js.map

package/dist/utilities/classes/time-span/_module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/utilities/classes/time-span/_module.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/utilities/{time-span → classes/time-span}/time-span.d.ts

@@ -1,12 +1,13 @@
 /**
  * @module Utilities
  */
-import type { ISerializable } from "../../serde/contracts/_module-exports.js";
+import type { ISerializable } from "../../../serde/contracts/_module-exports.js";
 /**
  * The <i>TimeSpan</i> class is used for representing time interval that is the difference between two times measured in a number of days, hours, minutes, and seconds.
  * <i>TimeSpan</i> cannot be negative.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group TimeSpan
  */
 export declare class TimeSpan implements ISerializable<number> {
     private readonly milliseconds;

package/dist/utilities/{time-span → classes/time-span}/time-span.js

@@ -6,6 +6,7 @@
  * <i>TimeSpan</i> cannot be negative.
  *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group TimeSpan
  */
 export class TimeSpan {
     milliseconds;

package/dist/utilities/classes/time-span/time-span.js.map

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

package/dist/utilities/{_constants.d.ts → constants.d.ts}

@@ -1,7 +1,4 @@
 /**
  * @module Utilities
  */
-/**
- * @internal
- */
 export declare const CORE = "core";

package/dist/utilities/constants.js

@@ -0,0 +1,5 @@
+/**
+ * @module Utilities
+ */
+export const CORE = "core";
+//# sourceMappingURL=constants.js.map

package/dist/utilities/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utilities/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC"}

package/dist/utilities/contracts/_module.d.ts

@@ -1,3 +1,5 @@
-export * from "../../utilities/contracts/serialized-error.contract.js";
 export * from "../../utilities/contracts/deinitizable.contract.js";
 export * from "../../utilities/contracts/initizable.contract.js";
+export * from "../../utilities/contracts/prunable.contract.js";
+export * from "../../utilities/contracts/serialized-error.contract.js";
+export * from "../../utilities/contracts/sqlite-database.contract.js";

package/dist/utilities/contracts/_module.js

@@ -1,4 +1,6 @@
-export * from "../../utilities/contracts/serialized-error.contract.js";
 export * from "../../utilities/contracts/deinitizable.contract.js";
 export * from "../../utilities/contracts/initizable.contract.js";
+export * from "../../utilities/contracts/prunable.contract.js";
+export * from "../../utilities/contracts/serialized-error.contract.js";
+export * from "../../utilities/contracts/sqlite-database.contract.js";
 //# sourceMappingURL=_module.js.map

package/dist/utilities/contracts/_module.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/utilities/contracts/_module.ts"],"names":[],"mappings":"AAAA,cAAc,oDAAoD,CAAC;AACnE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../src/utilities/contracts/_module.ts"],"names":[],"mappings":"AAAA,cAAc,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC"}

package/dist/utilities/contracts/prunable.contract.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module Utilities
+ */
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities/contracts"```
+ * @group Contracts
+ */
+export type IPrunable = {
+    removeAllExpired(): PromiseLike<void>;
+};

package/dist/utilities/contracts/prunable.contract.js

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

package/dist/utilities/contracts/prunable.contract.js.map

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

package/dist/utilities/contracts/sqlite-database.contract.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @module Utilities
+ */
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group Contracts
+ */
+export type ISqliteStatement = {
+    readonly reader: boolean;
+    all(parameters: ReadonlyArray<unknown>): unknown[];
+    run(parameters: ReadonlyArray<unknown>): {
+        changes: number | bigint;
+        lastInsertRowid: number | bigint;
+    };
+    iterate(parameters: ReadonlyArray<unknown>): IterableIterator<unknown>;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * @group Contracts
+ */
+export type ISqliteDatabase = {
+    close(): void;
+    prepare(sql: string): ISqliteStatement;
+};

package/dist/utilities/contracts/sqlite-database.contract.js

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

package/dist/utilities/contracts/sqlite-database.contract.js.map

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

package/dist/utilities/functions.d.ts

@@ -1,7 +1,7 @@
 /**
  * @module Utilities
  */
-import type { Lazyable, OneOrMore } from "../utilities/types.js";
+import type { Factory, Factoryable, FactoryFn, IFactoryObject, Invokable, InvokableFn, Lazyable, OneOrMore } from "../utilities/types.js";
 import { type AsyncLazyable } from "../utilities/types.js";
 /**
  * @internal
@@ -18,8 +18,40 @@ export declare function isObjectEmpty(object: Record<string | number | symbol, a
 /**
  * @internal
  */
-export declare function resolveOneOrMoreStr(name: OneOrMore<string>): string;
+export declare function resolveOneOrMore<TType>(value: OneOrMore<TType>): TType[];
+/**
+ * @internal
+ */
+export declare function resolveOneOrMoreStr(name: OneOrMore<string>, joinStr?: string): string;
 /**
  * @internal
  */
 export declare function getConstructorName(instance: object): string;
+/**
+ * @internal
+ */
+export declare function isFactoryFn<TInput, TOutput>(factory: Factoryable<TInput, TOutput>): factory is FactoryFn<TInput, TOutput>;
+/**
+ * @internal
+ */
+export declare function isFactoryObject<TInput, TOutput>(factory: Factoryable<TInput, TOutput>): factory is IFactoryObject<TInput, TOutput>;
+/**
+ * @internal
+ */
+export declare function isFactory<TInput, TOutput>(factoryable: Factoryable<TInput, TOutput>): factoryable is Factory<TInput, TOutput>;
+/**
+ * @internal
+ */
+export declare function resolveFactory<TInput, TOutput>(factory: Factory<TInput, TOutput>): FactoryFn<TInput, TOutput>;
+/**
+ * @internal
+ */
+export declare function resolveFactoryable<TInput, TOutput>(factoryable: Factoryable<TInput, TOutput>, input: TInput): Promise<TOutput>;
+/**
+ * @internal
+ */
+export declare function resolveInvokable<TInput, TOutput>(invokable: Invokable<TInput, TOutput>): InvokableFn<TInput, TOutput>;
+/**
+ * @internal
+ */
+export declare function removeUndefinedProperties<TObject extends Partial<Record<string, unknown>>>(object: TObject): TObject;

package/dist/utilities/functions.js

@@ -2,6 +2,7 @@
  * @module Utilities
  */
 import { LazyPromise } from "../async/_module-exports.js";
+import { isIterable } from "../collection/implementations/_shared.js";
 import {} from "../utilities/types.js";
 /**
  * @internal
@@ -40,11 +41,22 @@ object) {
 /**
  * @internal
  */
-export function resolveOneOrMoreStr(name) {
-    if (Array.isArray(name)) {
-        name = name.filter((str) => str.length > 0).join("/");
+export function resolveOneOrMore(value) {
+    if (isIterable(value)) {
+        return [...value];
     }
-    return name;
+    return [value];
+}
+/**
+ * @internal
+ */
+export function resolveOneOrMoreStr(name, joinStr = "/") {
+    if (typeof name === "string") {
+        return name;
+    }
+    return resolveOneOrMore(name)
+        .filter((str) => str.length > 0)
+        .join(joinStr);
 }
 /**
  * @internal
@@ -52,4 +64,60 @@ export function resolveOneOrMoreStr(name) {
 export function getConstructorName(instance) {
     return instance.constructor.name;
 }
+/**
+ * @internal
+ */
+export function isFactoryFn(factory) {
+    return typeof factory === "function";
+}
+/**
+ * @internal
+ */
+export function isFactoryObject(factory) {
+    return (typeof factory === "object" &&
+        factory !== null &&
+        typeof factory["use"] === "function");
+}
+/**
+ * @internal
+ */
+export function isFactory(factoryable) {
+    return isFactoryFn(factoryable) || isFactoryObject(factoryable);
+}
+/**
+ * @internal
+ */
+export function resolveFactory(factory) {
+    if (isFactoryObject(factory)) {
+        return factory.use.bind(factory);
+    }
+    return factory;
+}
+/**
+ * @internal
+ */
+export async function resolveFactoryable(factoryable, input) {
+    if (isFactory(factoryable)) {
+        const factory = resolveFactory(factoryable);
+        return await factory(input);
+    }
+    else {
+        return factoryable;
+    }
+}
+/**
+ * @internal
+ */
+export function resolveInvokable(invokable) {
+    if (typeof invokable === "function") {
+        return invokable;
+    }
+    return invokable.invoke.bind(invokable);
+}
+/**
+ * @internal
+ */
+export function removeUndefinedProperties(object) {
+    return Object.fromEntries(Object.entries(object).filter(([_key, value]) => value !== undefined));
+}
 //# sourceMappingURL=functions.js.map

package/dist/utilities/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/utilities/functions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAsB,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAS,QAA0B;IAC9D,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAwB,CAAC;QAC1C,OAAO,QAAQ,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AACD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,QAA+B;IAE/B,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,QAAiC,CAAC;QACnD,OAAO,QAAQ,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,YAAY,WAAW,EAAE,CAAC;QAClC,OAAO,MAAM,QAAQ,CAAC;IAC1B,CAAC;IACD,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;AACzB,8DAA8D;AAC9D,MAA6C;IAE7C,OAAO;IACH,mEAAmE;IACnE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC5D,MAAM,KAAK,CAAC,CACpB,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;AACrC,CAAC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/utilities/functions.ts"],"names":[],"mappings":"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"}

package/dist/utilities/types.d.ts

@@ -2,70 +2,103 @@
  * @module Utilities
  */
 import type { LazyPromise } from "../async/_module-exports.js";
+export type Items<TArray extends any[]> = TArray[number];
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
-export type OneOrMore<TItem> = TItem | [TItem, ...TItem[]];
+export type AtLeastOne<TItem> = [TItem, ...TItem[]];
 /**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type OneOrMore<TItem> = TItem | Iterable<TItem>;
+/**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type Lazyable<TValue> = TValue | (() => TValue);
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type Promisable<TValue> = TValue | PromiseLike<TValue>;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type LazyPromiseable<TValue> = LazyPromise<TValue> | (() => Promisable<TValue>);
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type AsyncLazyable<TValue> = TValue | LazyPromiseable<TValue>;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type Result<TValue, TError> = [TValue, null] | [null, TError];
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type AsyncIterableValue<TInput> = Iterable<TInput> | AsyncIterable<TInput>;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
-export type AnyFunction = (...parameters: unknown[]) => unknown;
+export type Func<TArgs extends unknown[], TReturn> = (...args_: TArgs) => TReturn;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
-export type Func<TArgs extends unknown[], TReturn> = (...args_: TArgs) => TReturn;
+export type AnyFunction = Func<any[], any>;
 /**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type NoneFunction<TType> = Exclude<TType, AnyFunction>;
+/**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type GetOrAddValue<TValue> = Awaited<TValue extends AnyFunction ? ReturnType<TValue> : TValue>;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type InvokableFn<TInput = unknown, TOutput = unknown> = (value: TInput) => Promisable<TOutput>;
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type IInvokableObject<TInput = unknown, TOutput = unknown> = {
     invoke(value: TInput): Promisable<TOutput>;
 };
 /**
+ *
  * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
- * @group Contracts
  */
 export type Invokable<TInput = unknown, TOutput = unknown> = InvokableFn<TInput, TOutput> | IInvokableObject<TInput, TOutput>;
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type FactoryFn<TInput, TOutput> = (value: TInput) => Promisable<NoneFunction<TOutput>>;
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type IFactoryObject<TInput, TOutput> = {
+    use(value: TInput): Promisable<NoneFunction<TOutput>>;
+};
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type Factory<TInput, TOutput> = FactoryFn<TInput, TOutput> | IFactoryObject<TInput, TOutput>;
+/**
+ *
+ * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ */
+export type Factoryable<TInput, TOutput> = NoneFunction<TOutput> | Factory<TInput, TOutput>;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@daiso-tech/core",
     "private": false,
-    "version": "0.26.1",
+    "version": "0.28.0",
     "author": "Yousif Abdulkarim",
     "license": "Apache-2.0",
     "type": "module",
@@ -43,26 +43,26 @@
     ],
     "exports": {
         "./*": {
-            "import": "./dist/*/_module-exports.js",
-            "types": "./dist/*/_module-exports.d.ts"
-        },
-        "./*/implementations": {
-            "import": "./dist/*/implementations/_module-exports.js",
-            "types": "./dist/*/implementations/_module-exports.d.ts"
+            "import": [
+                "./dist/*/_module-exports.js",
+                "./dist/*/implementations/_module-exports.js",
+                "./dist/*/implementations/derivables/_module-exports.js"
+            ],
+            "types": [
+                "./dist/*/_module-exports.d.ts",
+                "./dist/*/implementations/_module-exports.d.ts",
+                "./dist/*/implementations/derivables/_module-exports.d.ts"
+            ]
         },
         "./*/contracts": {
             "import": "./dist/*/contracts/_module-exports.js",
             "types": "./dist/*/contracts/_module-exports.d.ts"
         },
-        "./*/implementations/adapters": {
+        "./*/adapters": {
             "import": "./dist/*/implementations/adapters/_module-exports.js",
             "types": "./dist/*/implementations/adapters/_module-exports.d.ts"
         },
-        "./*/implementations/derivables": {
-            "import": "./dist/*/implementations/derivables/_module-exports.js",
-            "types": "./dist/*/implementations/derivables/_module-exports.d.ts"
-        },
-        "./*/implementations/test-utilities": {
+        "./*/test-utilities": {
             "import": "./dist/*/implementations/test-utilities/_module-exports.js",
             "types": "./dist/*/implementations/test-utilities/_module-exports.d.ts"
         }
@@ -129,6 +129,7 @@
     },
     "dependencies": {
         "@libsql/kysely-libsql": "^0.4.0",
+        "escape-string-regexp": "^5.0.0",
         "kysely": "^0.27.0",
         "superjson-cjs": "^2.2.3",
         "uuid": "^11.0.5"

package/dist/cache/implementations/adapters/kysely-sqlite-cache-adapter/_module.js

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

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

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

package/dist/cache/implementations/adapters/kysely-sqlite-cache-adapter/kysely-sqlite-cache-adapter.d.ts

@@ -1,61 +0,0 @@
-/**
- * @module Cache
- */
-import { type ICacheAdapter } from "../../../../cache/contracts/_module-exports.js";
-import { type Kysely } from "kysely";
-import { type ISerde } from "../../../../serde/contracts/_module-exports.js";
-import type { IDeinitizable, IInitizable } from "../../../../utilities/_module-exports.js";
-import { TimeSpan } from "../../../../utilities/_module-exports.js";
-/**
- * @internal
- */
-type KyselySqliteCacheTable = {
-    group: string;
-    key: string;
-    value: string;
-    expiresAt: number | null;
-};
-/**
- * @internal
- */
-type KyselySqliteTables = {
-    cache: KyselySqliteCacheTable;
-};
-/**
- * @internal
- */
-type KyselySqliteSettings = {
-    db: Kysely<KyselySqliteTables>;
-    serde: ISerde<string>;
-    enableTransactions: boolean;
-    expiredKeysRemovalInterval?: TimeSpan;
-    shouldRemoveExpiredKeys?: boolean;
-    rootGroup: string;
-};
-/**
- * @internal
- */
-export declare class KyselySqliteCacheAdapter<TType = unknown> implements ICacheAdapter<TType>, IInitizable, IDeinitizable {
-    private readonly group;
-    private readonly serde;
-    private readonly enableTransactions;
-    private readonly expiredKeysRemovalInterval;
-    private readonly shouldRemoveExpiredKeys;
-    private timeoutId;
-    private readonly db;
-    constructor(settings: KyselySqliteSettings);
-    getGroup(): string;
-    withGroup(group: string): ICacheAdapter<TType>;
-    private withTransaction;
-    removeExpiredKeys(): Promise<void>;
-    init(): Promise<void>;
-    deInit(): Promise<void>;
-    get(key: string): Promise<TType | null>;
-    add(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    update(key: string, value: TType): Promise<boolean>;
-    put(key: string, value: TType, ttl: TimeSpan | null): Promise<boolean>;
-    remove(key: string): Promise<boolean>;
-    increment(key: string, value: number): Promise<boolean>;
-    clear(): Promise<void>;
-}
-export {};