@daiso-tech/core 0.49.1 → 0.50.0

package/README.md

@@ -10,7 +10,7 @@
 
 This framework is specifically optimized for building **modular monoliths** or **majestic monoliths** rather than distributed server architectures.
 
-[**Explore the Docs**](https://daiso-core.vercel.app/docs/Installation) | [**NPM Package**](https://www.npmjs.com/package/@daiso-tech/core)
+[**Explore the Docs**](https://daiso-tech.dev/docs/Installation) | [**NPM Package**](https://www.npmjs.com/package/@daiso-tech/core)
 
 ---
 

package/dist/cache/contracts/_module-exports.d.ts

@@ -1,5 +1,5 @@
 export type * from "../../cache/contracts/cache-adapter.contract.js";
-export type * from "../../cache/contracts/cache-factory.contract.js";
+export type * from "../../cache/contracts/cache-resolver.contract.js";
 export type * from "../../cache/contracts/cache.contract.js";
 export * from "../../cache/contracts/cache.errors.js";
 export * from "../../cache/contracts/cache.events.js";

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

@@ -1,5 +1,5 @@
 export type * from "../../cache/contracts/cache-adapter.contract.js";
-export type * from "../../cache/contracts/cache-factory.contract.js";
+export type * from "../../cache/contracts/cache-resolver.contract.js";
 export type * from "../../cache/contracts/cache.contract.js";
 export * from "../../cache/contracts/cache.errors.js";
 export * from "../../cache/contracts/cache.events.js";

package/dist/cache/contracts/{cache-factory.contract.d.ts → cache-resolver.contract.d.ts}

@@ -3,12 +3,12 @@
  */
 import { type ICache } from "../../cache/contracts/cache.contract.js";
 /**
- * The `ICacheFactory` contract makes it easy to configure and switch between different {@link ICache | `ICache`} dynamically.
+ * The `ICacheResolver` contract makes it easy to configure and switch between different {@link ICache | `ICache`} dynamically.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Contracts
  */
-export type ICacheFactory<TAdapters extends string = string, TType = unknown> = {
+export type ICacheResolver<TAdapters extends string = string, TType = unknown> = {
     /**
      * The `use` method will throw an error if you provide it unregisted adapter.
      * If no default adapter is defined an error will be thrown.

package/dist/cache/contracts/{cache-factory.contract.js → cache-resolver.contract.js}

@@ -7,4 +7,4 @@ import {
 UnregisteredAdapterError, 
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 DefaultAdapterNotDefinedError, } from "../../utilities/_module.js";
-//# sourceMappingURL=cache-factory.contract.js.map
+//# sourceMappingURL=cache-resolver.contract.js.map

package/dist/cache/contracts/cache-resolver.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-resolver.contract.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache-resolver.contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,MAAM,qCAAqC,CAAC;AAClE,OAAO;AACH,6DAA6D;AAC7D,wBAAwB;AACxB,6DAA6D;AAC7D,6BAA6B,GAChC,MAAM,wBAAwB,CAAC"}

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

@@ -80,7 +80,7 @@ export type ICacheBase<TType = unknown> = IReadableCache<TType> & {
     /**
      * The `add` method adds a `key` with given `value` when key doesn't exists.
      *
-     * @param ttl - If null is passed, the item will not expire.
+     * @param settings.ttl - If null is passed, the item will not expire.
      *
      * @returns Returns true when key doesn't exists otherwise false will be returned.
      */
@@ -95,7 +95,7 @@ export type ICacheBase<TType = unknown> = IReadableCache<TType> & {
     /**
      * The `put` methods upsert the given key and replaces the ttl when updated.
      *
-     * @param ttl - If null is passed, the item will not expire.
+     * @param settings.ttl - If null is passed, the item will not expire.
      *
      * @returns Returns true if the `key` where replaced otherwise false is returned.
      */

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

@@ -2,6 +2,7 @@
  * @module Cache
  */
 import { type IKey } from "../../namespace/contracts/_module.js";
+import { type InferInstance } from "../../utilities/_module.js";
 /**
  * The error is thrown when a key is not found
  *
@@ -37,13 +38,14 @@ export declare class KeyExistsCacheError extends Error {
  * @group Errors
  */
 export declare const CACHE_ERRORS: {
+    readonly KeyExists: typeof KeyExistsCacheError;
     readonly KeyNotFound: typeof KeyNotFoundCacheError;
 };
 /**
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Errors
  */
-export type AllCacheErrors = KeyNotFoundCacheError;
+export type AllCacheErrors = InferInstance<(typeof CACHE_ERRORS)[keyof typeof CACHE_ERRORS]>;
 /**
  * IMPORT_PATH: `"@daiso-tech/core/cache/contracts"`
  * @group Errors

package/dist/cache/contracts/cache.errors.js

@@ -2,6 +2,7 @@
  * @module Cache
  */
 import {} from "../../namespace/contracts/_module.js";
+import {} from "../../utilities/_module.js";
 /**
  * The error is thrown when a key is not found
  *
@@ -47,6 +48,7 @@ export class KeyExistsCacheError extends Error {
  * @group Errors
  */
 export const CACHE_ERRORS = {
+    KeyExists: KeyExistsCacheError,
     KeyNotFound: KeyNotFoundCacheError,
 };
 /**
@@ -55,10 +57,10 @@ export const CACHE_ERRORS = {
  */
 export function isCacheError(value) {
     for (const ErrorClass of Object.values(CACHE_ERRORS)) {
-        if (!(value instanceof ErrorClass)) {
-            return false;
+        if (value instanceof ErrorClass) {
+            return true;
         }
     }
-    return true;
+    return false;
 }
 //# sourceMappingURL=cache.errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"cache.errors.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAa,MAAM,kCAAkC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5C,MAAM,CAAC,MAAM,CAAC,GAAS,EAAE,KAAe;QACpC,OAAO,IAAI,qBAAqB,CAC5B,QAAQ,GAAG,CAAC,GAAG,EAAE,gBAAgB,EACjC,KAAK,CACR,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC1C,MAAM,CAAC,MAAM,CAAC,GAAS,EAAE,KAAe;QACpC,OAAO,IAAI,mBAAmB,CAC1B,QAAQ,GAAG,CAAC,GAAG,EAAE,kBAAkB,EACnC,KAAK,CACR,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;IACzC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,WAAW,EAAE,qBAAqB;CAC5B,CAAC;AAQX;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}
+{"version":3,"file":"cache.errors.js","sourceRoot":"","sources":["../../../src/cache/contracts/cache.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAa,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAsB,MAAM,wBAAwB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5C,MAAM,CAAC,MAAM,CAAC,GAAS,EAAE,KAAe;QACpC,OAAO,IAAI,qBAAqB,CAC5B,QAAQ,GAAG,CAAC,GAAG,EAAE,gBAAgB,EACjC,KAAK,CACR,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC3C,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC1C,MAAM,CAAC,MAAM,CAAC,GAAS,EAAE,KAAe;QACpC,OAAO,IAAI,mBAAmB,CAC1B,QAAQ,GAAG,CAAC,GAAG,EAAE,kBAAkB,EACnC,KAAK,CACR,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,YAAY,OAAe,EAAE,KAAe;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;IACzC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IACxB,SAAS,EAAE,mBAAmB;IAC9B,WAAW,EAAE,qBAAqB;CAC5B,CAAC;AAUX;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

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

@@ -4,7 +4,7 @@
 import { type ICacheAdapter } from "../../../../cache/contracts/_module.js";
 import { type TimeSpan } from "../../../../time-span/implementations/_module.js";
 /**
- * The `MemoryCacheAdapter` is used for easily facking {@link ICache | `ICache`} for testing.
+ * The `MemoryCacheAdapter` is used for easily faking{@link ICache | `ICache`} for testing.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/memory-cache-adapter"`
  * @group Adapters

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

@@ -4,7 +4,7 @@
 import {} from "../../../../cache/contracts/_module.js";
 import {} from "../../../../time-span/implementations/_module.js";
 /**
- * The `MemoryCacheAdapter` is used for easily facking {@link ICache | `ICache`} for testing.
+ * The `MemoryCacheAdapter` is used for easily faking{@link ICache | `ICache`} for testing.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache/memory-cache-adapter"`
  * @group Adapters
@@ -63,7 +63,6 @@ export class MemoryCacheAdapter {
         const hasKey = prevValue !== undefined;
         if (hasKey) {
             if (typeof prevValue !== "number") {
-                console.log("!!!_________________!!!:");
                 throw new TypeError(`Unable to increment or decrement none number type key "${key}"`);
             }
             const newValue = prevValue + value;

package/dist/cache/implementations/adapters/memory-cache-adapter/memory-cache-adapter.js.map

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

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

@@ -1,2 +1,2 @@
 export * from "../../../cache/implementations/derivables/cache/_module.js";
-export * from "../../../cache/implementations/derivables/cache-factory/_module.js";
+export * from "../../../cache/implementations/derivables/cache-resolver/_module.js";

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/cache/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,qDAAqD,CAAC;AACpE,cAAc,6DAA6D,CAAC"}
+{"version":3,"file":"_module-exports.js","sourceRoot":"","sources":["../../../../src/cache/implementations/derivables/_module-exports.ts"],"names":[],"mappings":"AAAA,cAAc,qDAAqD,CAAC;AACpE,cAAc,8DAA8D,CAAC"}

package/dist/cache/implementations/derivables/_module.d.ts

@@ -1,2 +1,2 @@
 export * from "../../../cache/implementations/derivables/cache/_module.js";
-export * from "../../../cache/implementations/derivables/cache-factory/_module.js";
+export * from "../../../cache/implementations/derivables/cache-resolver/_module.js";

package/dist/cache/implementations/derivables/_module.js

@@ -1,3 +1,3 @@
 export * from "../../../cache/implementations/derivables/cache/_module.js";
-export * from "../../../cache/implementations/derivables/cache-factory/_module.js";
+export * from "../../../cache/implementations/derivables/cache-resolver/_module.js";
 //# sourceMappingURL=_module.js.map

package/dist/cache/implementations/derivables/_module.js.map

@@ -1 +1 @@
-{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/cache/implementations/derivables/_module.ts"],"names":[],"mappings":"AAAA,cAAc,qDAAqD,CAAC;AACpE,cAAc,6DAA6D,CAAC"}
+{"version":3,"file":"_module.js","sourceRoot":"","sources":["../../../../src/cache/implementations/derivables/_module.ts"],"names":[],"mappings":"AAAA,cAAc,qDAAqD,CAAC;AACpE,cAAc,8DAA8D,CAAC"}

package/dist/cache/implementations/derivables/{cache-factory → cache-resolver}/_module.d.ts

@@ -1 +1 @@
-export * from "../../../../cache/implementations/derivables/cache-factory/cache-factory.js";
+export * from "../../../../cache/implementations/derivables/cache-resolver/cache-resolver.js";

package/dist/cache/implementations/derivables/cache-resolver/_module.js

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

package/dist/cache/implementations/derivables/cache-resolver/_module.js.map

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

package/dist/cache/implementations/derivables/{cache-factory/cache-factory.d.ts → cache-resolver/cache-resolver.d.ts}

@@ -2,7 +2,7 @@
  * @module Cache
  */
 import { type StandardSchemaV1 } from "@standard-schema/spec";
-import { type CacheAdapterVariants, type ICache, type ICacheFactory } from "../../../../cache/contracts/_module.js";
+import { type CacheAdapterVariants, type ICache, type ICacheResolver } from "../../../../cache/contracts/_module.js";
 import { type CacheSettingsBase } from "../../../../cache/implementations/derivables/cache/_module.js";
 import { type IEventBus } from "../../../../event-bus/contracts/_module.js";
 import { type INamespace } from "../../../../namespace/contracts/_module.js";
@@ -16,22 +16,22 @@ export type CacheAdapters<TAdapters extends string = string> = Partial<Record<TA
  * IMPORT_PATH: `"@daiso-tech/core/cache"`
  * @group Derivables
  */
-export type CacheFactorySettings<TAdapters extends string = string, TType = unknown> = CacheSettingsBase<TType> & {
+export type CacheResolverSettings<TAdapters extends string = string, TType = unknown> = CacheSettingsBase<TType> & {
     adapters: CacheAdapters<TAdapters>;
     defaultAdapter?: NoInfer<TAdapters>;
 };
 /**
- * The `CacheFactory` class is immutable.
+ * The `CacheResolver` class is immutable.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache"`
  * @group Derivables
  */
-export declare class CacheFactory<TAdapters extends string = string, TType = unknown> implements ICacheFactory<TAdapters, TType> {
+export declare class CacheResolver<TAdapters extends string = string, TType = unknown> implements ICacheResolver<TAdapters, TType> {
     private readonly settings;
     /**
      * @example
      * ```ts
-     * import { CacheFactory } from "@daiso-tech/core/cache";
+     * import { CacheResolver } from "@daiso-tech/core/cache";
      * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
      * import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
      * import { Serde } from "@daiso-tech/core/serde";
@@ -40,7 +40,7 @@ export declare class CacheFactory<TAdapters extends string = string, TType = unk
      * import Redis from "ioredis"
      *
      * const serde = new Serde(new SuperJsonSerdeAdapter());
-     * const cacheFactory = new CacheFactory({
+     * const cacheResolver = new CacheResolver({
      *   adapters: {
      *     memory: new MemoryCacheAdapter(),
      *     redis: new RedisCacheAdapter({
@@ -51,17 +51,17 @@ export declare class CacheFactory<TAdapters extends string = string, TType = unk
      *   defaultAdapter: "memory",
      * });
      */
-    constructor(settings: CacheFactorySettings<TAdapters, TType>);
-    setNamespace(namespace: INamespace): CacheFactory<TAdapters, TType>;
-    setDefaultTtl(ttl: ITimeSpan): CacheFactory<TAdapters, TType>;
-    setEventBus(eventBus: IEventBus): CacheFactory<TAdapters, TType>;
-    setSchema<TSchemaOutputType>(schema: StandardSchemaV1<TSchemaOutputType>): CacheFactory<TAdapters, TSchemaOutputType>;
-    setType<TOutputType>(): CacheFactory<TAdapters, TOutputType>;
-    setJitter(jitter: number): CacheFactory<TAdapters, TType>;
+    constructor(settings: CacheResolverSettings<TAdapters, TType>);
+    setNamespace(namespace: INamespace): CacheResolver<TAdapters, TType>;
+    setDefaultTtl(ttl: ITimeSpan | null): CacheResolver<TAdapters, TType>;
+    setEventBus(eventBus: IEventBus): CacheResolver<TAdapters, TType>;
+    setSchema<TSchemaOutputType>(schema: StandardSchemaV1<TSchemaOutputType>): CacheResolver<TAdapters, TSchemaOutputType>;
+    setType<TOutputType>(): CacheResolver<TAdapters, TOutputType>;
+    setJitter(jitter: number): CacheResolver<TAdapters, TType>;
     /**
      * @example
      * ```ts
-     * import { CacheFactory } from "@daiso-tech/core/cache";
+     * import { CacheResolver } from "@daiso-tech/core/cache";
      * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
      * import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
      * import { Serde } from "@daiso-tech/core/serde";
@@ -71,7 +71,7 @@ export declare class CacheFactory<TAdapters extends string = string, TType = unk
      * import Redis from "ioredis"
      *
      * const serde = new Serde(new SuperJsonSerdeAdapter());
-     * const cacheFactory = new CacheFactory({
+     * const cacheResolver = new CacheResolver({
      *   adapters: {
      *     memory: new MemoryCacheAdapter(),
      *     redis: new RedisCacheAdapter({
@@ -83,17 +83,17 @@ export declare class CacheFactory<TAdapters extends string = string, TType = unk
      * });
      *
      * // Will add key to cache using the default adapter which is MemoryCacheAdapter
-     * await cacheFactory
+     * await cacheResolver
      *   .use()
      *   .add("a", 1);
      *
      * // Will add key to cache using the redis adapter
-     * await cacheFactory
+     * await cacheResolver
      *   .use("redis")
      *   .add("a", 1);
      *
      * // You can change the default settings of the returned Cache instance.
-     * await cacheFactory
+     * await cacheResolver
      *   .setDefaultTtl(TimeSpan.fromMinutes(2))
      *   .use("sqlite")
      *   .add("a", 1);

package/dist/cache/implementations/derivables/{cache-factory/cache-factory.js → cache-resolver/cache-resolver.js}

@@ -9,17 +9,17 @@ import {} from "../../../../namespace/contracts/_module.js";
 import {} from "../../../../time-span/contracts/_module.js";
 import { DefaultAdapterNotDefinedError, UnregisteredAdapterError, } from "../../../../utilities/_module.js";
 /**
- * The `CacheFactory` class is immutable.
+ * The `CacheResolver` class is immutable.
  *
  * IMPORT_PATH: `"@daiso-tech/core/cache"`
  * @group Derivables
  */
-export class CacheFactory {
+export class CacheResolver {
     settings;
     /**
      * @example
      * ```ts
-     * import { CacheFactory } from "@daiso-tech/core/cache";
+     * import { CacheResolver } from "@daiso-tech/core/cache";
      * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
      * import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
      * import { Serde } from "@daiso-tech/core/serde";
@@ -28,7 +28,7 @@ export class CacheFactory {
      * import Redis from "ioredis"
      *
      * const serde = new Serde(new SuperJsonSerdeAdapter());
-     * const cacheFactory = new CacheFactory({
+     * const cacheResolver = new CacheResolver({
      *   adapters: {
      *     memory: new MemoryCacheAdapter(),
      *     redis: new RedisCacheAdapter({
@@ -43,34 +43,34 @@ export class CacheFactory {
         this.settings = settings;
     }
     setNamespace(namespace) {
-        return new CacheFactory({
+        return new CacheResolver({
             ...this.settings,
             namespace,
         });
     }
     setDefaultTtl(ttl) {
-        return new CacheFactory({
+        return new CacheResolver({
             ...this.settings,
             defaultTtl: ttl,
         });
     }
     setEventBus(eventBus) {
-        return new CacheFactory({
+        return new CacheResolver({
             ...this.settings,
             eventBus,
         });
     }
     setSchema(schema) {
-        return new CacheFactory({
+        return new CacheResolver({
             ...this.settings,
             schema,
         });
     }
     setType() {
-        return new CacheFactory(this.settings);
+        return new CacheResolver(this.settings);
     }
     setJitter(jitter) {
-        return new CacheFactory({
+        return new CacheResolver({
             ...this.settings,
             defaultJitter: jitter,
         });
@@ -78,7 +78,7 @@ export class CacheFactory {
     /**
      * @example
      * ```ts
-     * import { CacheFactory } from "@daiso-tech/core/cache";
+     * import { CacheResolver } from "@daiso-tech/core/cache";
      * import { MemoryCacheAdapter } from "@daiso-tech/core/cache/memory-cache-adapter";
      * import { RedisCacheAdapter } from "@daiso-tech/core/cache/redis-cache-adapter";
      * import { Serde } from "@daiso-tech/core/serde";
@@ -88,7 +88,7 @@ export class CacheFactory {
      * import Redis from "ioredis"
      *
      * const serde = new Serde(new SuperJsonSerdeAdapter());
-     * const cacheFactory = new CacheFactory({
+     * const cacheResolver = new CacheResolver({
      *   adapters: {
      *     memory: new MemoryCacheAdapter(),
      *     redis: new RedisCacheAdapter({
@@ -100,17 +100,17 @@ export class CacheFactory {
      * });
      *
      * // Will add key to cache using the default adapter which is MemoryCacheAdapter
-     * await cacheFactory
+     * await cacheResolver
      *   .use()
      *   .add("a", 1);
      *
      * // Will add key to cache using the redis adapter
-     * await cacheFactory
+     * await cacheResolver
      *   .use("redis")
      *   .add("a", 1);
      *
      * // You can change the default settings of the returned Cache instance.
-     * await cacheFactory
+     * await cacheResolver
      *   .setDefaultTtl(TimeSpan.fromMinutes(2))
      *   .use("sqlite")
      *   .add("a", 1);
@@ -118,7 +118,7 @@ export class CacheFactory {
      */
     use(adapterName = this.settings.defaultAdapter) {
         if (adapterName === undefined) {
-            throw new DefaultAdapterNotDefinedError(CacheFactory.name);
+            throw new DefaultAdapterNotDefinedError(CacheResolver.name);
         }
         const adapter = this.settings.adapters[adapterName];
         if (adapter === undefined) {
@@ -130,4 +130,4 @@ export class CacheFactory {
         });
     }
 }
-//# sourceMappingURL=cache-factory.js.map
+//# sourceMappingURL=cache-resolver.js.map

package/dist/cache/implementations/derivables/cache-resolver/cache-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-resolver.js","sourceRoot":"","sources":["../../../../../src/cache/implementations/derivables/cache-resolver/cache-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAyB,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAIN,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACH,KAAK,GAER,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAkB,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAmB,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAkB,MAAM,kCAAkC,CAAC;AAClE,OAAO,EACH,6BAA6B,EAC7B,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAuBhC;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IA2BD;IAxBrB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,YACqB,QAAiD;QAAjD,aAAQ,GAAR,QAAQ,CAAyC;IACnE,CAAC;IAEJ,YAAY,CAAC,SAAqB;QAC9B,OAAO,IAAI,aAAa,CAAC;YACrB,GAAG,IAAI,CAAC,QAAQ;YAChB,SAAS;SACZ,CAAC,CAAC;IACP,CAAC;IAED,aAAa,CAAC,GAAqB;QAC/B,OAAO,IAAI,aAAa,CAAC;YACrB,GAAG,IAAI,CAAC,QAAQ;YAChB,UAAU,EAAE,GAAG;SAClB,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,QAAmB;QAC3B,OAAO,IAAI,aAAa,CAAC;YACrB,GAAG,IAAI,CAAC,QAAQ;YAChB,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;IAED,SAAS,CACL,MAA2C;QAE3C,OAAO,IAAI,aAAa,CAAC;YACrB,GAAG,IAAI,CAAC,QAAQ;YAChB,MAAM;SACT,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,OAAO,IAAI,aAAa,CACpB,IAAI,CAAC,QAAyD,CACjE,CAAC;IACN,CAAC;IAED,SAAS,CAAC,MAAc;QACpB,OAAO,IAAI,aAAa,CAAC;YACrB,GAAG,IAAI,CAAC,QAAQ;YAChB,aAAa,EAAE,MAAM;SACxB,CAAC,CAAC;IACP,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,GAAG,CACC,cAAqC,IAAI,CAAC,QAAQ,CAAC,cAAc;QAEjE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,6BAA6B,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,KAAK,CAAC;YACb,GAAG,IAAI,CAAC,QAAQ;YAChB,OAAO;SACV,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/cache/implementations/test-utilities/cache-adapter.test-suite.d.ts

@@ -3,6 +3,7 @@
  */
 import { type TestAPI, type SuiteAPI, type ExpectStatic, type beforeEach } from "vitest";
 import { type ICacheAdapter } from "../../../cache/contracts/_module.js";
+import { type ITimeSpan } from "../../../time-span/contracts/_module.js";
 import { type Promisable } from "../../../utilities/_module.js";
 /**
  * IMPORT_PATH: `"@daiso-tech/core/cache/test-utilities"`
@@ -14,6 +15,15 @@ export type CacheAdapterTestSuiteSettings = {
     describe: SuiteAPI;
     beforeEach: typeof beforeEach;
     createAdapter: () => Promisable<ICacheAdapter>;
+    /**
+     * @default
+     * ```ts
+     * import { TimeSpan } from "@daiso-tech/core/time-span";
+     *
+     * TimeSpan.fromMilliseconds(10)
+     * ```
+     */
+    delayBuffer?: ITimeSpan;
 };
 /**
  * The `cacheAdapterTestSuite` function simplifies the process of testing your custom implementation of {@link ICacheAdapter | `ICacheAdapter`} with `vitest`.