@daiso-tech/core 0.34.0 → 0.35.0

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

@@ -3,6 +3,67 @@
  */
 import { type IInvokableObject, type Invokable, type InvokableFn, type OneOrMore, type Promisable } from "../../../utilities/_module-exports.js";
 import type { HookContext } from "../../../utilities/classes/hooks/types.js";
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type GetSignal<TParameters extends unknown[] = unknown[]> = Invokable<[
+    arguments_: TParameters
+], AbortSignal | undefined>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type ForwardSignal<TParameters> = Invokable<[
+    arguments_: TParameters,
+    signal: AbortSignal
+], void>;
+/**
+ * With {@link AbortSignalBinder | `AbortSignalBinder`}, you can bind an {@link AbortSignal | `AbortSignal`} to the middleware, enabling two-way abortion control.
+ * This means the middleware can abort the function, or the function can abort the middleware if the input function supports an {@link AbortSignal | `AbortSignal`}.
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ *
+ * @example
+ * ```ts
+ * import { AsyncHooks } from "@daiso-tech/core/utilities";
+ *
+ * const abortController = new AbortController();
+ *
+ * // You can abort the function based on by your on criteria
+ * abortController.abort("Aborted") // Remove this code if you want the function to aborted after 2 seconds by the middleware.
+ *
+ * const data = await new AsyncHooks(async (url: string, signal?: AbortSignal): Promise<unknown> => {
+ *   const response = await fetch(url, { signal });
+ *   return await response.json();
+ * }, [
+ *   (args, next, { abort, signal }) => {
+ *     // We abort the function when it execdes 2 seconds.
+ *     const id = setTimeout(() => abort("Timed out"), 2000);
+ *     // We remove the timeout if function is aborted before it execdes 2 seconds.
+ *     signal.addEventListener("abort", () => clearTimeout(id), { once: true });
+ *     return next(...args);
+ *   }
+ * ], {
+ *   signalBinder: {
+ *     getSignal: (args) => args[1],
+ *     forwardSignal: (args, signal) => {
+ *       args[1] = signal;
+ *     }
+ *   }
+ * })
+ * .invoke("url", abortController.signal);
+ *
+ * console.log("DATA:", data)
+ * ```
+ */
+export type AbortSignalBinder<TParameters extends unknown[] = unknown[]> = {
+    getSignal: GetSignal<TParameters>;
+    forwardSignal: ForwardSignal<TParameters>;
+};
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
@@ -14,27 +75,59 @@ export type AsyncNextFunc<TParameters extends unknown[] = unknown[], TReturn = u
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type AsyncMiddlewareFn<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = InvokableFn<[
+export type AsyncContext<TContext extends HookContext = HookContext> = {
+    name: string;
+    context: TContext;
+    abort: (error: unknown) => void;
+    signal: AbortSignal;
+};
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type AsyncMiddlewareFn<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = InvokableFn<[
     arguments_: TParameters,
     next: AsyncNextFunc<TParameters, TReturn>,
-    context: TContext
+    settings: AsyncContext<TContext>
 ], Promisable<TReturn>>;
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type IAsyncMiddlewareObject<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = IInvokableObject<[
+export type IAsyncMiddlewareObject<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = IInvokableObject<[
     arguments_: TParameters,
     next: AsyncNextFunc<TParameters, TReturn>,
-    context: TContext
+    settings: AsyncContext<TContext>
 ], Promisable<TReturn>>;
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type AsyncMiddleware<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = IAsyncMiddlewareObject<TParameters, TReturn, TContext> | AsyncMiddlewareFn<TParameters, TReturn, TContext>;
+export type AsyncMiddleware<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = IAsyncMiddlewareObject<TParameters, TReturn, TContext> | AsyncMiddlewareFn<TParameters, TReturn, TContext>;
+/**
+ *
+ * IMPORT_PATH: `"@daiso-tech/core/utilities"`
+ * @group Hooks
+ */
+export type AsyncHooksSettings<TParameters extends unknown[] = unknown[], 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;
+    /**
+     * If the input function accepts an {@link AbortSignal | `AbortSignal`}, you can bind it to the middleware by providing an {@link AbortSignalBinder | `AbortSignalBinder`}.
+     * This enables two-way abortion control: you can either abort the function from within the middleware, or abort the middleware from the function itself.
+     */
+    signalBinder?: AbortSignalBinder<TParameters>;
+    /**
+     * You can provide addtional context that can be used in the middleware.
+     */
+    context?: TContext;
+};
 /**
  * The `AsyncHooks` class provides a convenient way to change and inspect arguments and return value of both async and sync functions.
  * For example `AsyncHooks` class can be used to log function arguments and return values. Note this class will always return promise and is immutable.
@@ -45,10 +138,9 @@ export type AsyncMiddleware<TParameters extends unknown[] = unknown[], TReturn =
 export declare class AsyncHooks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> implements IInvokableObject<TParameters, Promise<TReturn>> {
     private readonly invokable;
     private readonly middlewares;
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    private readonly context;
+    private readonly settings;
+    private static defaultAbortSignalBinder;
+    private static resolveSignalBinder;
     private static init;
     private readonly func;
     /**
@@ -56,8 +148,8 @@ export declare class AsyncHooks<TParameters extends unknown[] = unknown[], TRetu
      * ```ts
      * import { AsyncHooks, type AsyncMiddlewareFn } from "@daiso-tech/core/utilities";
      *
-     * function log<TParameters extends unknown[], TReturn>(): AsyncMiddlewareFn<TParameters, TReturn, { funcName: string; }> {
-     *   return async (args, next, { funcName }) => {
+     * function log<TParameters extends unknown[], TReturn>(): AsyncMiddlewareFn<TParameters, TReturn> {
+     *   return async (args, next, { name: funcName }) => {
      *     console.log("FUNCTION_NAME:", funcName);
      *     console.log("ARGUMENTS:", args);
      *     const value = await next(...args);
@@ -84,10 +176,9 @@ export declare class AsyncHooks<TParameters extends unknown[] = unknown[], TRetu
      * const enhancedAdd = new AsyncHooks(add, [
      *   log(),
      *   time()
-     * ],
-     * // You can provide additional information to `AsyncMiddleware` invokables.
-     * {
-     *    funcName: add.name
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
      * });
      *
      * // Will log the function name, arguments and return value.
@@ -98,11 +189,7 @@ export declare class AsyncHooks<TParameters extends unknown[] = unknown[], TRetu
      * console.log(result);
      * ```
      */
-    constructor(invokable: Invokable<TParameters, Promisable<TReturn>>, middlewares: NoInfer<OneOrMore<AsyncMiddleware<TParameters, TReturn, TContext>>>, 
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    context?: TContext);
+    constructor(invokable: Invokable<TParameters, Promisable<TReturn>>, middlewares: NoInfer<OneOrMore<AsyncMiddleware<TParameters, TReturn, TContext>>>, settings?: AsyncHooksSettings<TParameters, TContext>);
     /**
      * The `pipe` method returns a new `AsyncHooks` instance with the additional `middlewares` applied.
      */

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

@@ -1,7 +1,7 @@
 /**
  * @module Utilities
  */
-import { resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-exports.js";
+import { callInvokable, getInvokableName, resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-exports.js";
 /**
  * The `AsyncHooks` class provides a convenient way to change and inspect arguments and return value of both async and sync functions.
  * For example `AsyncHooks` class can be used to log function arguments and return values. Note this class will always return promise and is immutable.
@@ -12,15 +12,49 @@ import { resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-
 export class AsyncHooks {
     invokable;
     middlewares;
-    context;
-    static init(invokable, middlewares, context) {
+    settings;
+    static defaultAbortSignalBinder() {
+        return {
+            forwardSignal: (args) => args,
+            getSignal: () => new AbortController().signal,
+        };
+    }
+    static resolveSignalBinder(signalBinder, args) {
+        const outerSignal = callInvokable(signalBinder.getSignal, args) ??
+            new AbortController().signal;
+        const abortController = new AbortController();
+        const abort = (reason) => {
+            abortController.abort(reason);
+        };
+        const mergedSignal = AbortSignal.any([
+            outerSignal,
+            abortController.signal,
+        ]);
+        callInvokable(signalBinder.forwardSignal, args, mergedSignal);
+        return {
+            abort,
+            changedArgs: args,
+            signal: mergedSignal,
+        };
+    }
+    static init(invokable, middlewares, { name = getInvokableName(invokable), signalBinder = AsyncHooks.defaultAbortSignalBinder(), context = {}, }) {
         let func = resolveInvokable(invokable);
         for (const hook of resolveOneOrMore(middlewares)
             .map(resolveInvokable)
             .reverse()) {
             const prevFunc = func;
             const next = async (...arguments_) => await prevFunc(...arguments_);
-            func = async (...arguments_) => await hook(arguments_, next, context);
+            func = async (...arguments_) => {
+                const resolvedSignalBinder = AsyncHooks.resolveSignalBinder(signalBinder, arguments_);
+                return await hook(resolvedSignalBinder.changedArgs, next, {
+                    name,
+                    abort: (error) => {
+                        resolvedSignalBinder.abort(error);
+                    },
+                    signal: resolvedSignalBinder.signal,
+                    context,
+                });
+            };
         }
         return func;
     }
@@ -30,8 +64,8 @@ export class AsyncHooks {
      * ```ts
      * import { AsyncHooks, type AsyncMiddlewareFn } from "@daiso-tech/core/utilities";
      *
-     * function log<TParameters extends unknown[], TReturn>(): AsyncMiddlewareFn<TParameters, TReturn, { funcName: string; }> {
-     *   return async (args, next, { funcName }) => {
+     * function log<TParameters extends unknown[], TReturn>(): AsyncMiddlewareFn<TParameters, TReturn> {
+     *   return async (args, next, { name: funcName }) => {
      *     console.log("FUNCTION_NAME:", funcName);
      *     console.log("ARGUMENTS:", args);
      *     const value = await next(...args);
@@ -58,10 +92,9 @@ export class AsyncHooks {
      * const enhancedAdd = new AsyncHooks(add, [
      *   log(),
      *   time()
-     * ],
-     * // You can provide additional information to `AsyncMiddleware` invokables.
-     * {
-     *    funcName: add.name
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
      * });
      *
      * // Will log the function name, arguments and return value.
@@ -72,15 +105,11 @@ export class AsyncHooks {
      * console.log(result);
      * ```
      */
-    constructor(invokable, middlewares, 
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    context = {}) {
+    constructor(invokable, middlewares, settings = {}) {
         this.invokable = invokable;
         this.middlewares = middlewares;
-        this.context = context;
-        this.func = AsyncHooks.init(invokable, middlewares, context);
+        this.settings = settings;
+        this.func = AsyncHooks.init(invokable, middlewares, this.settings);
     }
     /**
      * The `pipe` method returns a new `AsyncHooks` instance with the additional `middlewares` applied.
@@ -89,7 +118,7 @@ export class AsyncHooks {
         return new AsyncHooks(this.invokable, [
             ...resolveOneOrMore(this.middlewares),
             ...resolveOneOrMore(middlewares),
-        ], this.context);
+        ], this.settings);
     }
     /**
      * The `pipeWhen` method conditionally applies additional `middlewares`, returning a new `AsyncHooks` instance only if the specified condition is met.

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

@@ -1 +1 @@
-{"version":3,"file":"async-hooks.js","sourceRoot":"","sources":["../../../../src/utilities/classes/hooks/async-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,gBAAgB,EAChB,gBAAgB,GAMnB,MAAM,gCAAgC,CAAC;AA8DxC;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IA0EE;IACA;IAMA;IA3Eb,MAAM,CAAC,IAAI,CACf,SAAsD,EACtD,WAAuE,EACvE,OAAiB;QAEjB,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,KAAK,EAAE,GAAG,UAAuB,EAAE,EAAE,CAC9C,MAAM,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,EAAE,GAAG,UAAuB,EAAE,EAAE,CACxC,MAAM,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEgB,IAAI,CAAgD;IAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,YACqB,SAAsD,EACtD,WAEhB;IACD;;OAEG;IACc,UAAU,EAAc;QAPxB,cAAS,GAAT,SAAS,CAA6C;QACtD,gBAAW,GAAX,WAAW,CAE3B;QAIgB,YAAO,GAAP,OAAO,CAAiB;QAEzC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,IAAI,CACA,WAAuE;QAEvE,OAAO,IAAI,UAAU,CACjB,IAAI,CAAC,SAAS,EACd;YACI,GAAG,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC;YACrC,GAAG,gBAAgB,CAAC,WAAW,CAAC;SACnC,EACD,IAAI,CAAC,OAAO,CACf,CAAC;IACN,CAAC;IAED;;OAEG;IACH,QAAQ,CACJ,SAAkB,EAClB,WAAuE;QAEvE,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,KAAK,CAAC,MAAM,CAAC,GAAG,UAAuB;QACnC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1C,CAAC;CACJ"}
+{"version":3,"file":"async-hooks.js","sourceRoot":"","sources":["../../../../src/utilities/classes/hooks/async-hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAMnB,MAAM,gCAAgC,CAAC;AAsKxC;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IA6HE;IACA;IAGA;IA3Hb,MAAM,CAAC,wBAAwB;QAGnC,OAAO;YACH,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;YAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC,MAAM;SAChD,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,mBAAmB,CAC9B,YAA4C,EAC5C,IAAiB;QAEjB,MAAM,WAAW,GACb,aAAa,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC;YAC3C,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;QACjC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,CAAC,MAAe,EAAQ,EAAE;YACpC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC;QACF,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC;YACjC,WAAW;YACX,eAAe,CAAC,MAAM;SACzB,CAAC,CAAC;QACH,aAAa,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9D,OAAO;YACH,KAAK;YACL,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,YAAY;SACvB,CAAC;IACN,CAAC;IAEO,MAAM,CAAC,IAAI,CAKf,SAAsD,EACtD,WAAuE,EACvE,EACI,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAClC,YAAY,GAAG,UAAU,CAAC,wBAAwB,EAAE,EACpD,OAAO,GAAG,EAAc,GACgB;QAE5C,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,KAAK,EAAE,GAAG,UAAuB,EAAE,EAAE,CAC9C,MAAM,QAAQ,CAAC,GAAG,UAAU,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,EAAE,GAAG,UAAuB,EAAE,EAAE;gBACxC,MAAM,oBAAoB,GAAG,UAAU,CAAC,mBAAmB,CACvD,YAAY,EACZ,UAAU,CACb,CAAC;gBACF,OAAO,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,IAAI,EAAE;oBACtD,IAAI;oBACJ,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE;wBACtB,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACtC,CAAC;oBACD,MAAM,EAAE,oBAAoB,CAAC,MAAM;oBACnC,OAAO;iBACV,CAAC,CAAC;YACP,CAAC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEgB,IAAI,CAAgD;IAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACH,YACqB,SAAsD,EACtD,WAEhB,EACgB,WAGb,EAAE;QAPW,cAAS,GAAT,SAAS,CAA6C;QACtD,gBAAW,GAAX,WAAW,CAE3B;QACgB,aAAQ,GAAR,QAAQ,CAGnB;QAEN,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,IAAI,CACA,WAAuE;QAEvE,OAAO,IAAI,UAAU,CACjB,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,WAAuE;QAEvE,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,KAAK,CAAC,MAAM,CAAC,GAAG,UAAuB;QACnC,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;IAC1C,CAAC;CACJ"}

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

@@ -2,6 +2,7 @@
  * @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"`
@@ -13,41 +14,63 @@ export type NextFunc<TParameters extends unknown[] = unknown[], TReturn = unknow
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type MiddlewareFn<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = InvokableFn<[
+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>,
-    context: TContext
+    settings: Context<TContext>
 ], TReturn>;
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type IMiddlewareObject<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = IInvokableObject<[
+export type IMiddlewareObject<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> = IInvokableObject<[
     arguments_: TParameters,
     next: NextFunc<TParameters, TReturn>,
-    context: TContext
+    settings: Context<TContext>
 ], TReturn>;
 /**
  *
  * IMPORT_PATH: `"@daiso-tech/core/utilities"`
  * @group Hooks
  */
-export type Middleware<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext = object> = IMiddlewareObject<TParameters, TReturn, TContext> | MiddlewareFn<TParameters, TReturn, TContext>;
+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 sync value and is immutable.
+ * 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 Partial<Record<string, unknown>> = Partial<Record<string, unknown>>> implements IInvokableObject<TParameters, TReturn> {
+export declare class Hooks<TParameters extends unknown[] = unknown[], TReturn = unknown, TContext extends HookContext = HookContext> implements IInvokableObject<TParameters, TReturn> {
     private readonly invokable;
     private readonly middlewares;
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    private readonly context;
+    private readonly settings;
     private static init;
     private readonly func;
     /**
@@ -56,7 +79,7 @@ export declare class Hooks<TParameters extends unknown[] = unknown[], TReturn =
      * import { Hooks, type MiddlewareFn } from "@daiso-tech/core/utilities";
      *
      * function log<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn, { funcName: string; }> {
-     *   return (args, next, { funcName }) => {
+     *   return (args, next, { name: funcName }) => {
      *     console.log("FUNCTION_NAME:", funcName);
      *     console.log("ARGUMENTS:", args);
      *     const value = next(...args);
@@ -83,10 +106,9 @@ export declare class Hooks<TParameters extends unknown[] = unknown[], TReturn =
      * const enhancedAdd = new Hooks(add, [
      *   log(),
      *   time()
-     * ],
-     * // You can provide additional information to `Middleware` invokables.
-     * {
-     *    funcName: add.name
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
      * });
      *
      * // Will log the function name, arguments and return value.
@@ -97,11 +119,7 @@ export declare class Hooks<TParameters extends unknown[] = unknown[], TReturn =
      * console.log(result);
      * ```
      */
-    constructor(invokable: Invokable<TParameters, TReturn>, middlewares: NoInfer<OneOrMore<Middleware<TParameters, TReturn, TContext>>>, 
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    context?: TContext);
+    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.
      */

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

@@ -1,10 +1,10 @@
 /**
  * @module Utilities
  */
-import { resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-exports.js";
+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 sync value and is immutable.
+ * 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
@@ -12,14 +12,20 @@ import { resolveInvokable, resolveOneOrMore, } from "../../../utilities/_module-
 export class Hooks {
     invokable;
     middlewares;
-    context;
-    static init(invokable, middlewares, context) {
+    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;
-            func = (...arguments_) => hook(arguments_, prevFunc, context);
+            const next = (...arguments_) => prevFunc(...arguments_);
+            func = (...arguments_) => {
+                return hook(arguments_, next, {
+                    name,
+                    context,
+                });
+            };
         }
         return func;
     }
@@ -30,7 +36,7 @@ export class Hooks {
      * import { Hooks, type MiddlewareFn } from "@daiso-tech/core/utilities";
      *
      * function log<TParameters extends unknown[], TReturn>(): MiddlewareFn<TParameters, TReturn, { funcName: string; }> {
-     *   return (args, next, { funcName }) => {
+     *   return (args, next, { name: funcName }) => {
      *     console.log("FUNCTION_NAME:", funcName);
      *     console.log("ARGUMENTS:", args);
      *     const value = next(...args);
@@ -57,10 +63,9 @@ export class Hooks {
      * const enhancedAdd = new Hooks(add, [
      *   log(),
      *   time()
-     * ],
-     * // You can provide additional information to `Middleware` invokables.
-     * {
-     *    funcName: add.name
+     * ], {
+     *   // You can provide addtional data to be used the middleware.
+     *   context: {},
      * });
      *
      * // Will log the function name, arguments and return value.
@@ -71,15 +76,11 @@ export class Hooks {
      * console.log(result);
      * ```
      */
-    constructor(invokable, middlewares, 
-    /**
-     * You can pass in additional information that can be used by the middleware.
-     */
-    context = {}) {
+    constructor(invokable, middlewares, settings = {}) {
         this.invokable = invokable;
         this.middlewares = middlewares;
-        this.context = context;
-        this.func = Hooks.init(invokable, middlewares, context);
+        this.settings = settings;
+        this.func = Hooks.init(invokable, middlewares, this.settings);
     }
     /**
      * The `pipe` method returns a new `Hooks` instance with the additional `middlewares` applied.
@@ -88,7 +89,7 @@ export class Hooks {
         return new Hooks(this.invokable, [
             ...resolveOneOrMore(this.middlewares),
             ...resolveOneOrMore(middlewares),
-        ], this.context);
+        ], this.settings);
     }
     /**
      * The `pipeWhen` method conditionally applies additional `middlewares`, returning a new `Hooks` instance only if the specified condition is met.

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../src/utilities/classes/hooks/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,gBAAgB,EAChB,gBAAgB,GAKnB,MAAM,gCAAgC,CAAC;AA6DxC;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IA0EO;IACA;IAMA;IAzEb,MAAM,CAAC,IAAI,CACf,SAA0C,EAC1C,WAAkE,EAClE,OAAiB;QAEjB,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,IAAI,GAAG,CAAC,GAAG,UAAuB,EAAE,EAAE,CAClC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEgB,IAAI,CAAoC;IAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACH,YACqB,SAA0C,EAC1C,WAEhB;IACD;;OAEG;IACc,UAAU,EAAc;QAPxB,cAAS,GAAT,SAAS,CAAiC;QAC1C,gBAAW,GAAX,WAAW,CAE3B;QAIgB,YAAO,GAAP,OAAO,CAAiB;QAEzC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5D,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,OAAO,CACf,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"}
+{"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/key-prefixer/key-prefixer.js

@@ -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/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/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;

package/dist/utilities/functions/invokable.js

@@ -2,6 +2,7 @@
  * @module Utilities
  */
 import { isNullable } from "../../utilities/functions/is-nullable.js";
+import { getConstructorName } from "../../utilities/functions/get-constructor-name.js";
 /**
  * @internal
  */
@@ -39,4 +40,13 @@ export function callInvokable(invokable, ...args) {
     }
     return invokable(...args);
 }
+/**
+ * @internal
+ */
+export function getInvokableName(invokable) {
+    if (isInvokableFn(invokable)) {
+        return invokable.name;
+    }
+    return getConstructorName(invokable);
+}
 //# sourceMappingURL=invokable.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"invokable.js","sourceRoot":"","sources":["../../../src/utilities/functions/invokable.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC7B,SAA6C;IAE7C,MAAM,UAAU,GAAG,SAAoC,CAAC;IACxD,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,SAA6C;IAE7C,OAAO,OAAO,SAAS,KAAK,UAAU,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,SAA6C;IAE7C,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,SAAoC;IAEpC,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,SAAoC,EACpC,GAAG,IAAW;IAEd,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"invokable.js","sourceRoot":"","sources":["../../../src/utilities/functions/invokable.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AAEnF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAK7B,SAAmD;IAEnD,MAAM,UAAU,GAAG,SAAoC,CAAC;IACxD,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,SAAmD;IAEnD,OAAO,OAAO,SAAS,KAAK,UAAU,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACvB,SAAmD;IAEnD,OAAO,iBAAiB,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,SAA0C;IAE1C,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,SAA0C,EAC1C,GAAG,IAAiB;IAEpB,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,SAA0C;IAE1C,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC"}