@daiso-tech/core 0.33.0 → 0.35.0

package/dist/utilities/classes/hooks/hooks.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @module Utilities
+ */
+import { type IInvokableObject, type Invokable, type InvokableFn, type OneOrMore } from "../../../utilities/_module-exports.js";
+import type { HookContext } from "../../../utilities/classes/hooks/types.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type NextFunc<TParameters extends unknown[] = unknown[], TReturn = unknown> = InvokableFn<TParameters, TReturn>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type Context<TContext extends HookContext = HookContext> = {
+    name: string;
+    context: TContext;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type MiddlewareFn<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = InvokableFn<[
+    arguments_: TParameters,
+    next: NextFunc<TParameters, TReturn>,
+    settings: Context<TContext>
+], TReturn>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type IMiddlewareObject<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = IInvokableObject<[
+    arguments_: TParameters,
+    next: NextFunc<TParameters, TReturn>,
+    settings: Context<TContext>
+], TReturn>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type Middleware<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = IMiddlewareObject<TParameters, TReturn, TContext> | MiddlewareFn<TParameters, TReturn, TContext>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type HooksSettings<TContext extends HookContext = HookContext> = {
+    /**
+     * The name of the function which can be used for logging inside the middleware.
+     * By default, it takes the function or method name. If an anonymous function is provided, the name defaults to "func".
+     */
+    name?: string;
+    /**
+     * You can provide addtional context that can be used in the middleware.
+     */
+    context?: TContext;
+};
+/**
+ * The `Hooks` class provides a convenient way to change and inspect arguments and return value of both only sync functions.
+ * For example `Hooks` class can be used to log function arguments and return values. Note this class will always return promise and is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export declare class Hooks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> implements IInvokableObject<TParameters, TReturn> {
+    private readonly invokable;
+    private readonly middlewares;
+    private readonly settings;
+    private static init;
+    private readonly func;
+    /**
+     * @example
+     * ```ts
+     * import { Hooks, type MiddlewareFn } from "@daiso-tech/core/utilities";
+     *
+     * function log<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn, { funcName: string; }> {
+     *   return (args, next, { name: funcName }) => {
+     *     console.log("FUNCTION_NAME:", funcName);
+     *     console.log("ARGUMENTS:", args);
+     *     const value = next(...args);
+     *     console.log("RETURN:", value);
+     *     return value;
+     *   }
+     * }
+     *
+     * function time<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn> {
+     *   return (args, next) => {
+     *     const start = performance.now();
+     *     const value = next(...args);
+     *     const end = performance.now();
+     *     const time = end - start;
+     *     console.log("TIME:", `${String(time)}ms`);
+     *     return value;
+     *   }
+     * }
+     *
+     * function add(a: number, b: number): number {
+     *   return a + b;
+     * }
+     *
+     * const enhancedAdd = new Hooks(add, [
+     *   log(),
+     *   time()
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
+     * });
+     *
+     * // Will log the function name, arguments and return value.
+     * // Will also log the execution time.
+     * const result = enhancedAdd.invoke(1, 2);
+     *
+     * // Will be 3.
+     * console.log(result);
+     * ```
+     */
+    constructor(invokable: Invokable<TParameters, TReturn>, middlewares: NoInfer<OneOrMore<Middleware<TParameters, TReturn, TContext>>>, settings?: HooksSettings<TContext>);
+    /**
+     * The `pipe` method returns a new `Hooks` instance with the additional `middlewares` applied.
+     */
+    pipe(middlewares: OneOrMore<Middleware<TParameters, TReturn, TContext>>): Hooks<TParameters, TReturn, TContext>;
+    /**
+     * The `pipeWhen` method conditionally applies additional `middlewares`, returning a new `Hooks` instance only if the specified condition is met.
+     */
+    pipeWhen(condition: boolean, middlewares: OneOrMore<Middleware<TParameters, TReturn, TContext>>): Hooks<TParameters, TReturn, TContext>;
+    /**
+     * The `toFunc` will return the function with all middlewares applied.
+     */
+    toFunc(): InvokableFn<TParameters, TReturn>;
+    /**
+     * The `invoke` method executes the constructor's input function, applying all middlewares.
+     */
+    invoke(...arguments_: TParameters): TReturn;
+}

package/dist/utilities/classes/hooks/hooks.js

@@ -0,0 +1,116 @@
+/**
+ * @module Utilities
+ */
+import { getInvokableName, resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-exports.js";
+/**
+ * The `Hooks` class provides a convenient way to change and inspect arguments and return value of both only sync functions.
+ * For example `Hooks` class can be used to log function arguments and return values. Note this class will always return promise and is immutable.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export class Hooks {
+    invokable;
+    middlewares;
+    settings;
+    static init(invokable, middlewares, { name = getInvokableName(invokable), context = {}, }) {
+        let func = resolveInvokable(invokable);
+        for (const hook of resolveOneOrMore(middlewares)
+            .map(resolveInvokable)
+            .reverse()) {
+            const prevFunc = func;
+            const next = (...arguments_) => prevFunc(...arguments_);
+            func = (...arguments_) => {
+                return hook(arguments_, next, {
+                    name,
+                    context,
+                });
+            };
+        }
+        return func;
+    }
+    func;
+    /**
+     * @example
+     * ```ts
+     * import { Hooks, type MiddlewareFn } from "@daiso-tech/core/utilities";
+     *
+     * function log<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn, { funcName: string; }> {
+     *   return (args, next, { name: funcName }) => {
+     *     console.log("FUNCTION_NAME:", funcName);
+     *     console.log("ARGUMENTS:", args);
+     *     const value = next(...args);
+     *     console.log("RETURN:", value);
+     *     return value;
+     *   }
+     * }
+     *
+     * function time<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn> {
+     *   return (args, next) => {
+     *     const start = performance.now();
+     *     const value = next(...args);
+     *     const end = performance.now();
+     *     const time = end - start;
+     *     console.log("TIME:", `${String(time)}ms`);
+     *     return value;
+     *   }
+     * }
+     *
+     * function add(a: number, b: number): number {
+     *   return a + b;
+     * }
+     *
+     * const enhancedAdd = new Hooks(add, [
+     *   log(),
+     *   time()
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
+     * });
+     *
+     * // Will log the function name, arguments and return value.
+     * // Will also log the execution time.
+     * const result = enhancedAdd.invoke(1, 2);
+     *
+     * // Will be 3.
+     * console.log(result);
+     * ```
+     */
+    constructor(invokable, middlewares, settings = {}) {
+        this.invokable = invokable;
+        this.middlewares = middlewares;
+        this.settings = settings;
+        this.func = Hooks.init(invokable, middlewares, this.settings);
+    }
+    /**
+     * The `pipe` method returns a new `Hooks` instance with the additional `middlewares` applied.
+     */
+    pipe(middlewares) {
+        return new Hooks(this.invokable, [
+            ...resolveOneOrMore(this.middlewares),
+            ...resolveOneOrMore(middlewares),
+        ], this.settings);
+    }
+    /**
+     * The `pipeWhen` method conditionally applies additional `middlewares`, returning a new `Hooks` instance only if the specified condition is met.
+     */
+    pipeWhen(condition, middlewares) {
+        if (condition) {
+            return this.pipe(middlewares);
+        }
+        return this;
+    }
+    /**
+     * The `toFunc` will return the function with all middlewares applied.
+     */
+    toFunc() {
+        return (...args) => this.invoke(...args);
+    }
+    /**
+     * The `invoke` method executes the constructor's input function, applying all middlewares.
+     */
+    invoke(...arguments_) {
+        return this.func(...arguments_);
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../src/utilities/classes/hooks/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAKnB,MAAM,gCAAgC,CAAC;AA0FxC;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IAoFO;IACA;IAGA;IAlFb,MAAM,CAAC,IAAI,CAKf,SAA0C,EAC1C,WAAkE,EAClE,EACI,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAClC,OAAO,GAAG,EAAc,GACF;QAE1B,IAAI,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,WAAW,CAAC;aAC3C,GAAG,CAAC,gBAAgB,CAAC;aACrB,OAAO,EAAE,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,IAAI,CAAC;YACtB,MAAM,IAAI,GAAG,CAAC,GAAG,UAAuB,EAAE,EAAE,CACxC,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC;YAC5B,IAAI,GAAG,CAAC,GAAG,UAAuB,EAAE,EAAE;gBAClC,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;oBAC1B,IAAI;oBACJ,OAAO;iBACV,CAAC,CAAC;YACP,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEgB,IAAI,CAAoC;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,YACqB,SAA0C,EAC1C,WAEhB,EACgB,WAAoC,EAAE;QAJtC,cAAS,GAAT,SAAS,CAAiC;QAC1C,gBAAW,GAAX,WAAW,CAE3B;QACgB,aAAQ,GAAR,QAAQ,CAA8B;QAEvD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,IAAI,CACA,WAAkE;QAElE,OAAO,IAAI,KAAK,CACZ,IAAI,CAAC,SAAS,EACd;YACI,GAAG,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC;YACrC,GAAG,gBAAgB,CAAC,WAAW,CAAC;SACnC,EACD,IAAI,CAAC,QAAQ,CAChB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,QAAQ,CACJ,SAAkB,EAClB,WAAkE;QAElE,IAAI,SAAS,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM;QACF,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,UAAuB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IACpC,CAAC;CACJ"}

package/dist/utilities/classes/hooks/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @module Utilities
+ */
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type HookContext = Partial<Record<string | symbol, unknown>>;

package/dist/utilities/classes/hooks/types.js

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

package/dist/utilities/classes/hooks/types.js.map

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

package/dist/utilities/classes/key-prefixer/key-prefixer.d.ts

@@ -13,7 +13,7 @@ type KeySettings = {
 };
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group KeyPrefixer
  */
 export declare class Key {
@@ -32,7 +32,7 @@ export declare class Key {
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group KeyPrefixer
  */
 export type KeyPrefixerSettings = {
@@ -44,7 +44,7 @@ export type KeyPrefixerSettings = {
 };
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group KeyPrefixer
  */
 export declare class KeyPrefixer {

package/dist/utilities/classes/key-prefixer/key-prefixer.js

@@ -4,7 +4,7 @@
 import { resolveOneOrMoreStr } from "../../../utilities/_module-exports.js";
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group KeyPrefixer
  */
 export class Key {
@@ -38,7 +38,7 @@ export class Key {
 }
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group KeyPrefixer
  */
 export class KeyPrefixer {
@@ -65,10 +65,10 @@ export class KeyPrefixer {
     validate(key) {
         const resolvedKey = resolveOneOrMoreStr(key);
         if (resolvedKey.includes(this.rootIdentifier)) {
-            throw new Error("!!__MESSAGE__!!");
+            throw new Error(`Resolved key "${resolvedKey}" cannot not include "${this.rootIdentifier}"`);
         }
         if (resolvedKey.includes(this.keyIdentifier)) {
-            throw new Error("!!__MESSAGE__!!");
+            throw new Error(`Resolved key "${resolvedKey}" cannot not include "${this.keyIdentifier}"`);
         }
     }
     getKeyPrefixArray() {

package/dist/utilities/classes/key-prefixer/key-prefixer.js.map

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

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

@@ -3,10 +3,10 @@
  */
 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.
+ * The `TimeSpan` class is used for representing time interval that is the difference between two times measured in a number of days, hours, minutes, and seconds.
+ * `TimeSpan` cannot be negative.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group TimeSpan
  */
 export declare class TimeSpan implements ISerializable<number> {
@@ -46,12 +46,12 @@ export declare class TimeSpan implements ISerializable<number> {
     toDays(): number;
     toUTCTimestamp(): number;
     /**
-     * Will return endDate relative to a given <i>startDate</i> argument.
+     * Will return endDate relative to a given `startDate` argument.
      * @default {new Date()} - current date
      */
     toEndDate(startDate?: Date): Date;
     /**
-     * Will return startDate relative to a given <i>endDate</i> argument.
+     * Will return startDate relative to a given `endDate` argument.
      * @default {new Date()} - current date
      */
     toStartDate(endDate?: Date): Date;

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

@@ -2,10 +2,10 @@
  * @module Utilities
  */
 /**
- * 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.
+ * The `TimeSpan` class is used for representing time interval that is the difference between two times measured in a number of days, hours, minutes, and seconds.
+ * `TimeSpan` cannot be negative.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group TimeSpan
  */
 export class TimeSpan {
@@ -106,14 +106,14 @@ export class TimeSpan {
         return Math.round(this.toMilliseconds() / 1000);
     }
     /**
-     * Will return endDate relative to a given <i>startDate</i> argument.
+     * Will return endDate relative to a given `startDate` argument.
      * @default {new Date()} - current date
      */
     toEndDate(startDate = new Date()) {
         return new Date(startDate.getTime() + this.toMilliseconds());
     }
     /**
-     * Will return startDate relative to a given <i>endDate</i> argument.
+     * Will return startDate relative to a given `endDate` argument.
      * @default {new Date()} - current date
      */
     toStartDate(endDate = new Date()) {

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

@@ -3,4 +3,3 @@ 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";
-export * from "../../utilities/contracts/sync-event-bus-listenable.js";

package/dist/utilities/contracts/_module.js

@@ -3,5 +3,4 @@ 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";
-export * from "../../utilities/contracts/sync-event-bus-listenable.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,gDAAgD,CAAC;AAC/D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,4CAA4C,CAAC;AAC3D,cAAc,oDAAoD,CAAC;AACnE,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,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/deinitizable.contract.d.ts

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Contracts
  */
 export type IDeinitizable = {

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

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Contracts
  */
 export type IInitizable = {

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

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities/contracts"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities/contracts"`
  * @group Contracts
  */
 export type IPrunable = {

package/dist/utilities/contracts/serialized-error.contract.d.ts

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Contracts
  */
 export type ISerializedError = {

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

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Contracts
  */
 export type ISqliteStatement = {
@@ -17,7 +17,7 @@ export type ISqliteStatement = {
 };
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Contracts
  */
 export type ISqliteDatabase = {

package/dist/utilities/errors.d.ts

@@ -3,25 +3,25 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export declare class FactoryError extends Error {
     constructor(message: string, cause?: unknown);
 }
 /**
- * The error occurs when attempting to access the default adapter of the <i>Factory</i> class instance, which has not been defined.
+ * The error occurs when attempting to access the default adapter of the `Factory` class instance, which has not been defined.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export declare class DefaultAdapterNotDefinedError extends FactoryError {
     constructor(factoryName: string);
 }
 /**
- * The error occurs when attempting to access the an adapter of the <i>Factory</i> class instance, which has not been registered.
+ * The error occurs when attempting to access the an adapter of the `Factory` class instance, which has not been registered.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export declare class UnregisteredAdapterError extends FactoryError {

package/dist/utilities/errors.js

@@ -3,7 +3,7 @@
  */
 /**
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export class FactoryError extends Error {
@@ -13,9 +13,9 @@ export class FactoryError extends Error {
     }
 }
 /**
- * The error occurs when attempting to access the default adapter of the <i>Factory</i> class instance, which has not been defined.
+ * The error occurs when attempting to access the default adapter of the `Factory` class instance, which has not been defined.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export class DefaultAdapterNotDefinedError extends FactoryError {
@@ -25,9 +25,9 @@ export class DefaultAdapterNotDefinedError extends FactoryError {
     }
 }
 /**
- * The error occurs when attempting to access the an adapter of the <i>Factory</i> class instance, which has not been registered.
+ * The error occurs when attempting to access the an adapter of the `Factory` class instance, which has not been registered.
  *
- * IMPORT_PATH: ```"@daiso-tech/core/utilities"```
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Errors
  */
 export class UnregisteredAdapterError extends FactoryError {

package/dist/utilities/functions/factory.js

@@ -46,7 +46,7 @@ export function isAsyncFactory(factoryable) {
  */
 export function resolveFactory(factory) {
     if (isFactoryObject(factory)) {
-        return factory.use.bind(factory);
+        return (value) => factory.use(value);
     }
     return factory;
 }
@@ -55,9 +55,9 @@ export function resolveFactory(factory) {
  */
 export function resolveAsyncFactory(factory) {
     if (isAsyncFactoryObject(factory)) {
-        return factory.use.bind(factory);
+        return (value) => factory.use(value);
     }
-    return factory;
+    return (value) => factory(value);
 }
 /**
  * @internal

package/dist/utilities/functions/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/utilities/functions/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,OAAqC;IAErC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,OAAqC;IAErC,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,OAA+B,CAAC,KAAK,CAAC,KAAK,UAAU,CAChE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACrB,WAAyC;IAEzC,OAAO,WAAW,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,OAA0C;IAE1C,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAA0C;IAE1C,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,OAA+B,CAAC,KAAK,CAAC,KAAK,UAAU,CAChE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,WAA8C;IAE9C,OAAO,gBAAgB,CAAC,WAAW,CAAC,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,OAAiC;IAEjC,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAC/B,OAAsC;IAEtC,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAC9B,WAAyC,EACzC,KAAa;IAEb,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,WAA8C,EAC9C,KAAa;IAEb,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/utilities/functions/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,OAAqC;IAErC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,OAAqC;IAErC,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,OAA+B,CAAC,KAAK,CAAC,KAAK,UAAU,CAChE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACrB,WAAyC;IAEzC,OAAO,WAAW,CAAC,WAAW,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,OAA0C;IAE1C,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAChC,OAA0C;IAE1C,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,OAA+B,CAAC,KAAK,CAAC,KAAK,UAAU,CAChE,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,WAA8C;IAE9C,OAAO,gBAAgB,CAAC,WAAW,CAAC,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC1B,OAAiC;IAEjC,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAC/B,OAAsC;IAEtC,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAC9B,WAAyC,EACzC,KAAa;IAEb,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;QACzB,OAAO,cAAc,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,WAA8C,EAC9C,KAAa;IAEb,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,WAAW,CAAC;AACvB,CAAC"}

package/dist/utilities/functions/invokable.d.ts

@@ -5,20 +5,24 @@ import type { Invokable, InvokableFn, IInvokableObject } from "../../utilities/t
 /**
  * @internal
  */
-export declare function isInvokableObject<TValue, TArgs extends unknown[], TReturn>(invokable: TValue | Invokable<TArgs, TReturn>): invokable is IInvokableObject<TArgs, TReturn>;
+export declare function isInvokableObject<TValue, TParameters extends unknown[], TReturn>(invokable: TValue | Invokable<TParameters, TReturn>): invokable is IInvokableObject<TParameters, TReturn>;
 /**
  * @internal
  */
-export declare function isInvokableFn<TValue, TArgs extends unknown[], TReturn>(invokable: TValue | Invokable<TArgs, TReturn>): invokable is InvokableFn<TArgs, TReturn>;
+export declare function isInvokableFn<TValue, TParameters extends unknown[], TReturn>(invokable: TValue | Invokable<TParameters, TReturn>): invokable is InvokableFn<TParameters, TReturn>;
 /**
  * @internal
  */
-export declare function isInvokable<TValue, TArgs extends unknown[], TReturn>(invokable: TValue | Invokable<TArgs, TReturn>): invokable is Invokable<TArgs, TReturn>;
+export declare function isInvokable<TValue, TParameters extends unknown[], TReturn>(invokable: TValue | Invokable<TParameters, TReturn>): invokable is Invokable<TParameters, TReturn>;
 /**
  * @internal
  */
-export declare function resolveInvokable<TArgs extends unknown[], TReturn>(invokable: Invokable<TArgs, TReturn>): InvokableFn<TArgs, TReturn>;
+export declare function resolveInvokable<TParameters extends unknown[], TReturn>(invokable: Invokable<TParameters, TReturn>): InvokableFn<TParameters, TReturn>;
 /**
  * @internal
  */
-export declare function callInvokable<TArgs extends unknown[], TReturn>(invokable: Invokable<TArgs, TReturn>, ...args: TArgs): TReturn;
+export declare function callInvokable<TParameters extends unknown[], TReturn>(invokable: Invokable<TParameters, TReturn>, ...args: TParameters): TReturn;
+/**
+ * @internal
+ */
+export declare function getInvokableName<TParameters extends unknown[], TReturn>(invokable: Invokable<TParameters, TReturn>): string;