@xeno-js/shared 2.0.1 → 3.0.0

package/dist/index.d.ts

@@ -1,6 +1,13 @@
-import { SupabaseClient, User, Session as Session$1, Provider as Provider$1 } from '@supabase/supabase-js';
-import { AxiosInstance } from 'axios';
-import { z, ZodType } from 'zod';
+import { D as Dictionary, O as Optional, G as Guid, M as Maybe, F as Factory } from './common.types-DT8JtZ0E.js';
+export { A as AbstractConstructor, a as AsyncFactory, b as AsyncResolver, C as Constructor, K as KeysOfType, N as Nullable, c as Override, R as RequireKeys, d as Resolver, S as SetupAction } from './common.types-DT8JtZ0E.js';
+import { c as HttpHeaders, C as CookieOptions, E as ExtendedRequest, d as HttpBaseRequest } from './ihttp-client.contracts-DX2hDTW6.js';
+export { e as HttpMethod, a as HttpOptions, f as HttpQueryValue, H as HttpRequest, b as HttpResponse, g as HttpResponseType, I as IHttpClient } from './ihttp-client.contracts-DX2hDTW6.js';
+import { I as ILogger } from './ivalidator-service.contracts-ulue7FGh.js';
+export { a as IValidatorService } from './ivalidator-service.contracts-ulue7FGh.js';
+import { R as ResultType } from './result.types-DRyxvpQs.js';
+export { A as AppError, a as Result } from './result.types-DRyxvpQs.js';
+import { U as UserContext } from './iauth-service.contracts-DotziBbm.js';
+export { A as AuthClaims, I as IAuthService, a as IBaseAuthService, b as IBaseMapper, c as IExtendendAuthService, P as Provider, S as Session } from './iauth-service.contracts-DotziBbm.js';
 
 /**
  * @description DomainEvent is an interface that represents a domain event in the application. It defines the structure and properties of a domain event, which is a message that is published when a significant change
@@ -1071,251 +1078,12 @@ declare const TOKENS: Readonly<{
 }>;
 
 /**
- * @description Represents a value that may be `null`.
- * Prefer this over `T | null` in all public APIs so intent is self-documenting.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Nullable<T> = T | null;
-/**
- * @description Represents a value that may be `undefined`.
- * Prefer this over `T | undefined` in all public APIs.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Optional<T> = T | undefined;
-/**
- * @description Represents a value that may be either `null` or `undefined`.
- * Use when a value is absent regardless of the reason.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Maybe<T> = T | null | undefined;
-/**
- * @description Represents a concrete (instantiable) class.
- * Used by IoC containers and auto-wiring utilities to bind concrete implementations.
- *
- * @template T  The instance type produced by `new`.
- * @template TArgs  Constructor parameter tuple; defaults to `any[]`.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Constructor<T, TArgs extends Dictionary[] = Dictionary[]> = new (...args: TArgs) => T;
-/**
- * @description Represents an abstract class that cannot be instantiated directly.
- * Used for binding abstract base classes in the IoC container without requiring
- * a concrete constructor signature.
- *
- * @template T  The instance type produced by subclasses.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type AbstractConstructor<T> = abstract new (...args: Dictionary[]) => T;
-/**
- * @description A plain-object dictionary with string keys and uniform value type.
- * Prefer over `{ [key: string]: V }` for self-documenting intent.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Dictionary<V = unknown> = Record<string, V>;
-/**
- * @description Produces a new type with only the keys `K` made required;
- * all other keys retain their original optionality.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
-/**
- * @description Produces a new type where property `K` is overridden with type `V`.
- * Useful for narrowing a property inside a generic base type.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Override<T, K extends keyof T, V> = Omit<T, K> & Record<K, V>;
-/**
- * @description Extracts only the keys of `T` whose values are assignable to `V`.
- *
- * @example
- * type StringKeys = KeysOfType<{ a: string; b: number; c: string }, string>;
- * // => 'a' | 'c'
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type KeysOfType<T, V> = {
-    [K in keyof T]: T[K] extends V ? K : never;
-}[keyof T];
-/**
- * @description Generic factory function that produces a value of type `T`.
- *
- * `TArgs` defaults to an empty tuple for zero-argument factories, enabling
- * usage both as a plain provider (`Factory<T>`) and as a parameterised
- * creator (`Factory<T, [config: MyConfig]>`).
- *
- * @template T     The type of the value produced.
- * @template TArgs Tuple of constructor/factory argument types.
- *
- * @example
- * // Zero-argument factory
- * const makeLogger: Factory<ILoggerService> = () => new ConsoleLogger();
- *
- * // Parameterised factory
- * const makeRepo: Factory<IRepository<Entity>, [tx: Transaction]> =
- *   (tx) => new DrizzleRepository(tx);
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Factory<T, TArgs extends unknown[] = []> = (...args: TArgs) => T;
-/**
- * @description Async variant of `Factory<T, TArgs>`.
- * Use when the construction process involves I/O (e.g. DB pool acquisition).
- *
- * @template T     The type of the resolved value.
- * @template TArgs Tuple of factory argument types.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type AsyncFactory<T, TArgs extends unknown[] = []> = (...args: TArgs) => Promise<T>;
-/**
- * @description Delegate used by application-layer services to perform lazy,
- * symbol-keyed dependency resolution without coupling to the concrete container.
- *
- * This is the **only** sanctioned way to resolve dependencies at runtime outside
- * of constructor injection. Never inject the raw IoC container into services.
- *
- * @template T  Narrows the return type at each call site.
- *
- * @example
- * class NexusMediator {
- *   constructor(private readonly resolve: Resolver) {}
+ * @description Standardised paginated response envelope returned by query handlers.
  *
- *   send<TResult>(command: ICommand): Promise<TResult> {
- *     const handler = this.resolve<ICommandHandler<typeof command, TResult>>(
- *       command.resolverToken,
- *     );
- *     return handler.execute(command);
- *   }
- * }
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Resolver<T = unknown> = (token: symbol) => T;
-/**
- * @description Async variant of `Resolver` for containers that resolve
- * dependencies asynchronously (e.g. lazy module loading, remote config).
+ * Wraps the items array with cursor metadata so callers can navigate pages
+ * without re-computing totals on every request.
  *
- * @template T  Narrows the resolved type at each call site.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type AsyncResolver = <T>(token: symbol) => Promise<T>;
-/**
- * @description Represents a globally unique identifier (GUID/UUID) as a string.
- * The format is typically 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type Guid = `${string}-${string}-${string}-${string}-${string}`;
-/**
- * @description Represents a function that performs setup or configuration
- * based on the provided options of type `T`.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type SetupAction<T, E = undefined> = (options: T, config: E) => void;
-
-/**
- * @description Supported HTTP methods.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
-/**
- * @description Header map used by agnostic HTTP clients.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type HttpHeaders = Dictionary<Optional<string | string[]>>;
-/**
- * @description Query string value accepted by the HTTP contract.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-type HttpQueryValue = Maybe<string | number | boolean>;
-/**
- * @description Agnostic contract used to execute HTTP calls independently
- * from concrete transport libraries (fetch, axios, undici, etc.).
+ * @template T  The type of each item in the page.
 
    *
    * @author Xeno
@@ -1323,69 +1091,92 @@ type HttpQueryValue = Maybe<string | number | boolean>;
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-type HttpOptions = 'url' | 'method' | 'body';
-/**
- * @description Base Request options accepted by the agnostic HTTP client.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface HttpBaseRequest {
-    /** @description Optional query string parameters.
+interface IPaginatedResult<T> {
+    /**
+     * @description Immutable slice of items for the requested page.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly items: readonly T[];
+    /**
+     * @description Total number of items matching the query across all pages.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly total: number;
+    /**
+     * @description Current 1-based page index.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly query?: Optional<Dictionary<HttpQueryValue>>;
-    /** @description Optional request headers.
+    readonly page: number;
+    /**
+     * @description Number of items per page used for this result.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly headers?: Optional<HttpHeaders>;
-    /** @description Optional abort signal used to cancel the request.
+    readonly pageSize: number;
+    /**
+     * @description Total number of pages given `total` and `pageSize`.
+     * Computed as `Math.ceil(total / pageSize)`.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly signal: Optional<AbortSignal>;
-    /** @description Optional request timeout in milliseconds.
+    readonly totalPages: number;
+    /**
+     * @description `true` when a next page exists (i.e. `page < totalPages`).
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly timeoutMs?: Optional<number>;
+    readonly hasNextPage: boolean;
     /**
-     * @description Optional response type for the request.
+     * @description `true` when a previous page exists (i.e. `page > 1`).
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly responseType?: Optional<HttpResponseType>;
+    readonly hasPreviousPage: boolean;
 }
+
 /**
- * @description Represents the structure of an HTTP response.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-type HttpResponseType = 'json' | 'blob' | 'text' | 'arraybuffer';
+ * @file api-response.types.ts
+ * @description Defines types related to API responses, including the structure of successful and error responses returned by the server.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
 /**
- * @description Request options accepted by the agnostic HTTP client.
+ * @description Defines the structure of the API response returned by the server. It includes a status indicating whether the request was successful or resulted in an error, a boolean flag 'ok' for quick checks, headers containing any relevant HTTP headers, and a data field that can either be a successful response with the expected data or an error response with details about the failure.
 
    *
    * @author Xeno
@@ -1393,34 +1184,42 @@ type HttpResponseType = 'json' | 'blob' | 'text' | 'arraybuffer';
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface HttpRequest<TBody = unknown> extends HttpBaseRequest {
-    /** @description HTTP method used for the outgoing call.
+interface ResponseDto<T = unknown> {
+    /** @description Indicates the overall status of the API response, which can be either 'success' or 'error'.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    status: number;
+    /** @description A boolean flag that is true if the response status is 'success' and false if it is 'error'. This provides a convenient way to check the success of the API call without having to compare the status string.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly method: HttpMethod;
-    /** @description Optional request body.
+    ok: boolean;
+    /** @description A dictionary of HTTP headers included in the API response. This can contain any relevant headers returned by the server, such as content type, caching directives, or custom headers.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly body?: Optional<TBody>;
-    /** @description Absolute or relative target URL.
+    headers: HttpHeaders;
+    /** @description The payload of the API response, which can either be a successful response containing the expected data or an error response containing details about the failure. The structure of this field depends on whether the API call was successful or resulted in an error.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly url?: string;
+    data: ApiResponseDto<T>;
 }
 /**
- * @description Normalized response returned by an agnostic HTTP client.
+ * @description Defines the structure of a successful API response, which includes a data field containing the expected response payload. This interface is used when the API call is successful and the server returns the requested data.
 
    *
    * @author Xeno
@@ -1428,245 +1227,24 @@ interface HttpRequest<TBody = unknown> extends HttpBaseRequest {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface HttpResponse<TData = unknown> {
-    /** @description HTTP status code returned by the server.
+interface SuccessResponseDto<T = unknown> {
+    /** @description A boolean flag that is always true for successful responses. This provides a consistent way to check for success in the API response.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly status: number;
-    /** @description Indicates if the response status is in the 2xx range.
+    readonly success: true;
+    /** @description The actual data payload returned by the API call. The structure of this field can vary depending on the specific endpoint and the type of data being returned. It is defined as a generic type T, allowing for flexibility in the shape of the response data.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly ok: boolean;
-    /** @description Response headers normalized as a dictionary.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly headers: HttpHeaders;
-    /** @description Parsed response payload.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly data: TData;
-}
-/**
- * @description Represents the CookieOptions interface.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface CookieOptions {
-    /** @description The path for which the cookie is valid. Defaults to '/'. */
-    path?: Optional<string>;
-    /** @description The value of the maximum age in seconds. If not specified, the cookie will expire when the browser session ends. */
-    maxAge?: Optional<number>;
-    /** @description The domain for which the cookie is valid. Defaults to the domain of the current document host. */
-    domain?: Optional<string>;
-    /** @description Whether the cookie is only transmitted over secure (HTTPS) connections. Defaults to true in production. */
-    secure?: Optional<boolean>;
-    /** @description Controls whether the cookie is withheld on cross-site requests, providing some protection against cross-site request forgery attacks. */
-    sameSite?: Optional<'lax' | 'strict' | 'none' | boolean>;
-}
-/**
- * @description Represents an extended Request object that includes additional properties
- * required by the Xeno-js framework, such as custom path handling.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface ExtendedRequest extends Request {
-    /**
-     * @description The path of the request, which may be modified by middleware.
-     * Example: '/api/v1/user'
-     */
-    path: string;
-}
-
-/**
- * @description Standardised paginated response envelope returned by query handlers.
- *
- * Wraps the items array with cursor metadata so callers can navigate pages
- * without re-computing totals on every request.
- *
- * @template T  The type of each item in the page.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IPaginatedResult<T> {
-    /**
-     * @description Immutable slice of items for the requested page.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly items: readonly T[];
-    /**
-     * @description Total number of items matching the query across all pages.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly total: number;
-    /**
-     * @description Current 1-based page index.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly page: number;
-    /**
-     * @description Number of items per page used for this result.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly pageSize: number;
-    /**
-     * @description Total number of pages given `total` and `pageSize`.
-     * Computed as `Math.ceil(total / pageSize)`.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly totalPages: number;
-    /**
-     * @description `true` when a next page exists (i.e. `page < totalPages`).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly hasNextPage: boolean;
-    /**
-     * @description `true` when a previous page exists (i.e. `page > 1`).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly hasPreviousPage: boolean;
-}
-
-/**
- * @file api-response.types.ts
- * @description Defines types related to API responses, including the structure of successful and error responses returned by the server.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-/**
- * @description Defines the structure of the API response returned by the server. It includes a status indicating whether the request was successful or resulted in an error, a boolean flag 'ok' for quick checks, headers containing any relevant HTTP headers, and a data field that can either be a successful response with the expected data or an error response with details about the failure.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface ResponseDto<T = unknown> {
-    /** @description Indicates the overall status of the API response, which can be either 'success' or 'error'.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    status: number;
-    /** @description A boolean flag that is true if the response status is 'success' and false if it is 'error'. This provides a convenient way to check the success of the API call without having to compare the status string.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    ok: boolean;
-    /** @description A dictionary of HTTP headers included in the API response. This can contain any relevant headers returned by the server, such as content type, caching directives, or custom headers.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    headers: HttpHeaders;
-    /** @description The payload of the API response, which can either be a successful response containing the expected data or an error response containing details about the failure. The structure of this field depends on whether the API call was successful or resulted in an error.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    data: ApiResponseDto<T>;
-}
-/**
- * @description Defines the structure of a successful API response, which includes a data field containing the expected response payload. This interface is used when the API call is successful and the server returns the requested data.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface SuccessResponseDto<T = unknown> {
-    /** @description A boolean flag that is always true for successful responses. This provides a consistent way to check for success in the API response.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly success: true;
-    /** @description The actual data payload returned by the API call. The structure of this field can vary depending on the specific endpoint and the type of data being returned. It is defined as a generic type T, allowing for flexibility in the shape of the response data.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly data: T | IPaginatedResult<T>;
-    /** @description Metadata associated with the successful API response. This can include pagination information, rate limit details, or other relevant metadata.
+    readonly data: T | IPaginatedResult<T>;
+    /** @description Metadata associated with the successful API response. This can include pagination information, rate limit details, or other relevant metadata.
      *
      * @author Xeno
      * @version 1.0.0
@@ -1770,8 +1348,7 @@ interface ErrorResponseDto {
 type ApiResponseDto<T = unknown> = SuccessResponseDto<T> | ErrorResponseDto;
 
 /**
- * @file auth.types.ts
- * @description Defines types related to authentication and authorization.
+ * @description The AuthPolicy interface defines the structure of an authorization policy, which includes a list of roles and permissions. This interface is used to represent the access control policies associated with different intents or actions within the application. Implementations of this interface can be used to enforce role-based and permission-based access control by specifying which roles and permissions are required for specific operations.
 
    *
    * @author Xeno
@@ -1779,8 +1356,47 @@ type ApiResponseDto<T = unknown> = SuccessResponseDto<T> | ErrorResponseDto;
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
+interface AuthPolicy {
+    /**
+     * An optional boolean flag indicating whether the authorization policy requires a user ID for authentication. If set to true, the policy enforces that a valid user ID must be present in the request context for authorization to succeed. This flag can be used to differentiate between policies that require user-level authentication and those that do not.
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly userId?: boolean;
+    /**
+     * An optional boolean flag indicating whether the authorization policy requires a tenant ID for authentication. If set to true, the policy enforces that a valid tenant ID must be present in the request context for authorization to succeed. This flag can be used to differentiate between policies that require tenant-level authentication and those that do not.
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly tenantId?: boolean;
+    /**
+     * An array of roles that are associated with the authorization policy. These roles define the access level and permissions granted to users who possess them. The roles can be used to determine whether a user is authorized to perform certain actions or access specific resources within the application.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly roles?: string[];
+    /**
+     * An array of permissions that are associated with the authorization policy. These permissions define the specific actions or operations that a user is allowed to perform within the application. The permissions can be used to enforce fine-grained access control by specifying which operations require certain permissions.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly permissions?: string[];
+}
+
 /**
- * @description An interface representing the claims associated with an authenticated user. This typically includes standard claims such as 'sub' (subject) and 'email', as well as any additional claims that may be relevant to the application's authorization logic.
+ * @description An interface representing cacheable options, which includes properties for cache key, TTL, and bypass flags. This allows query handlers to determine how to cache the results of the query based on the provided options.
 
    *
    * @author Xeno
@@ -1788,9 +1404,9 @@ type ApiResponseDto<T = unknown> = SuccessResponseDto<T> | ErrorResponseDto;
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface AuthClaims {
+interface ICacheableOptions {
     /**
-     * The unique identifier for the user (subject).
+     * @description A unique key under which to save the result. Must include parameters (e.g., `travel-intents:tenant-123:page-1`).
     
      *
      * @author Xeno
@@ -1798,19 +1414,20 @@ interface AuthClaims {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly sub: string;
+    readonly cacheKey: string;
     /**
-     * The user's email
+     * @description Time to live for the cache entry in seconds. Optional; if omitted, a default TTL defined in the caching layer will be used. Must be a positive integer if provided.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly email: Optional<string>;
-    readonly name: Optional<string>;
+    readonly ttl: Optional<number>;
     /**
-     * The tenant ID associated with the user, if applicable. This is useful in multi-tenant applications to identify which tenant the user belongs to.
+     * @description If true, indicates that the cache should be bypassed for this request. Similar to consistentRead but less semantically explicit.
+     * If both bypassCache and consistentRead are provided, consistentRead takes precedence.
     
      *
      * @author Xeno
@@ -1818,9 +1435,9 @@ interface AuthClaims {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly tenantId: Optional<string>;
+    readonly bypassCache: Optional<boolean>;
     /**
-     * An array of roles assigned to the user. This can be used for role-based access control (RBAC) to determine what actions the user is authorized to perform.
+     * @description (Optional) If true, indicates that a consistent read is required, bypassing the cache. Similar to bypassCache but more semantically explicit.
     
      *
      * @author Xeno
@@ -1828,9 +1445,9 @@ interface AuthClaims {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly roles: Optional<string[]>;
+    readonly consistentRead: Optional<boolean>;
     /**
-     * An array of permissions assigned to the user. This can be used for permission-based access control to determine what specific operations the user is authorized to perform.
+     * @description (Optional) If true, indicates that the cache entry is scoped to the current user. This is useful for multi-tenant applications where cached data should be isolated per user or tenant.
     
      *
      * @author Xeno
@@ -1838,154 +1455,10 @@ interface AuthClaims {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly permissions: Optional<string[]>;
+    readonly isUserScoped: boolean;
 }
-/**
- * @description An interface representing the context of an authenticated user, including their unique identifier and tenant ID. This context can be used throughout the application to enforce authorization rules and access control based on the user's identity and associated claims.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface UserContext {
-    /**
-     * The unique identifier for the user (subject).
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly userId: Optional<Guid>;
-    /**
-     * The tenant ID associated with the user, if applicable. This is useful in multi-tenant applications to identify which tenant the user belongs to.
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly tenantId: Optional<Guid>;
-}
-interface Session {
-    readonly accessToken: string;
-    readonly refreshToken: string;
-    readonly expiresAt: Optional<number>;
-    readonly user: AuthClaims;
-}
-type Provider = 'apple' | 'discord' | 'facebook' | 'github' | 'gitlab' | 'google' | 'linkedin' | 'linkedin_oidc' | 'spotify';
-
-/**
- * @description The AuthPolicy interface defines the structure of an authorization policy, which includes a list of roles and permissions. This interface is used to represent the access control policies associated with different intents or actions within the application. Implementations of this interface can be used to enforce role-based and permission-based access control by specifying which roles and permissions are required for specific operations.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface AuthPolicy {
-    /**
-     * An optional boolean flag indicating whether the authorization policy requires a user ID for authentication. If set to true, the policy enforces that a valid user ID must be present in the request context for authorization to succeed. This flag can be used to differentiate between policies that require user-level authentication and those that do not.
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly userId?: boolean;
-    /**
-     * An optional boolean flag indicating whether the authorization policy requires a tenant ID for authentication. If set to true, the policy enforces that a valid tenant ID must be present in the request context for authorization to succeed. This flag can be used to differentiate between policies that require tenant-level authentication and those that do not.
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly tenantId?: boolean;
-    /**
-     * An array of roles that are associated with the authorization policy. These roles define the access level and permissions granted to users who possess them. The roles can be used to determine whether a user is authorized to perform certain actions or access specific resources within the application.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly roles?: string[];
-    /**
-     * An array of permissions that are associated with the authorization policy. These permissions define the specific actions or operations that a user is allowed to perform within the application. The permissions can be used to enforce fine-grained access control by specifying which operations require certain permissions.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly permissions?: string[];
-}
-
-/**
- * @description An interface representing cacheable options, which includes properties for cache key, TTL, and bypass flags. This allows query handlers to determine how to cache the results of the query based on the provided options.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface ICacheableOptions {
-    /**
-     * @description A unique key under which to save the result. Must include parameters (e.g., `travel-intents:tenant-123:page-1`).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly cacheKey: string;
-    /**
-     * @description Time to live for the cache entry in seconds. Optional; if omitted, a default TTL defined in the caching layer will be used. Must be a positive integer if provided.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly ttl: Optional<number>;
-    /**
-     * @description If true, indicates that the cache should be bypassed for this request. Similar to consistentRead but less semantically explicit.
-     * If both bypassCache and consistentRead are provided, consistentRead takes precedence.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly bypassCache: Optional<boolean>;
-    /**
-     * @description (Optional) If true, indicates that a consistent read is required, bypassing the cache. Similar to bypassCache but more semantically explicit.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly consistentRead: Optional<boolean>;
-    /**
-     * @description (Optional) If true, indicates that the cache entry is scoped to the current user. This is useful for multi-tenant applications where cached data should be isolated per user or tenant.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isUserScoped: boolean;
-}
-
-declare const _phantom: unique symbol;
+
+declare const _phantom: unique symbol;
 /**
  * @description A typed injection token that binds a runtime `symbol` to a
  * compile-time type `T` via a phantom property.
@@ -2495,644 +1968,15 @@ declare const Guards: Readonly<{
     
      *
      * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isFunction: (value: unknown) => value is (...args: readonly unknown[]) => unknown;
-    /**
-     * @description Checks value is an array.
-     * @param value Candidate value.
-     * @returns True when value is array.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isArray: <TValue>(value: unknown) => value is TValue[];
-    /**
-     * @description Checks value is a Date instance with valid timestamp.
-     * @param value Candidate value.
-     * @returns True when value is valid Date.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isDate: (value: unknown) => value is Date;
-    /**
-     * @description Checks value is an Error instance.
-     * @param value Candidate value.
-     * @returns True when value is Error.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isError: (value: unknown) => value is Error;
-    /**
-     * @description Checks value is a plain object record.
-     * @param value Candidate value.
-     * @returns True when value is object record.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isObjectRecord: (value: unknown) => value is Readonly<Dictionary<unknown>>;
-    /**
-     * @description Checks value is an object (not null).
-     * @param value Candidate value.
-     * @returns True when value is object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isObject: (value: unknown) => value is object;
-    /**
-     * @description Checks value is PromiseLike.
-     * @param value Candidate value.
-     * @returns True when value has then function.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isPromiseLike: <TValue>(value: unknown) => value is PromiseLike<TValue>;
-}>;
-
-/**
- * @fileoverview Utility functions for generating and validating GUIDs (UUID v4).
- * This module provides a simple interface for working with GUIDs, including generation and validation.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare const GuidHelper: Readonly<{
-    /**
-     * @description Generates a cryptographically-random UUID v4.
-     * @returns Lowercase UUID v4 string.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly generate: () => Guid;
-    /**
-     * @description Validates if a value is a valid GUID (UUID v4) and not empty.
-     * @param value The value to validate.
-     * @returns True if the value is a valid and non-empty GUID, false otherwise.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isValidGuid: (value: Guid) => boolean;
-    /**
-     * @description Validates if a string is a valid UUID v4.
-     * @param value Candidate string to validate.
-     * @returns True if the string is a valid UUID v4, false otherwise.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isValid: (value: string) => value is Guid;
-    /**
-     * @description Converts a string to a GUID if it's valid.
-     * @param value The string to convert.
-     * @returns The GUID if the string is valid, otherwise undefined.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly parse: (value: Optional<string>) => Optional<Guid>;
-    /**
-     * @description Checks if a GUID is the empty GUID (all zeros).
-     * @param value The GUID to check.
-     * @returns True if the GUID is the empty GUID, false otherwise.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly isEmpty: (value: string) => boolean;
-}>;
-
-/**
- * @description This module provides utility functions for handling HTTP-related tasks, such as normalizing HTTP headers. It includes a single function, `normalizeHeaders`, which takes an input of unknown type and returns an object with normalized header values. The function ensures that all header values are converted to strings, and if a header value is an array, it joins the elements into a single string separated by commas. This utility is useful for ensuring consistent header formats when working with various HTTP client libraries.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-/**
- * @description A helper object that provides utility functions for HTTP-related tasks. Currently, it includes a method for normalizing HTTP headers, which ensures that all header values are strings and handles cases where header values may be arrays. This helper can be extended in the future to include additional HTTP-related utilities as needed.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare const HttpHelper: Readonly<{
-    /**
-     * @description A function that masks the IP address in the given headers object.
-     * @param ip The IP address to mask.
-     * @returns The masked IP address.
-     */
-    readonly maskIp: (ip: Optional<string>) => Optional<string>;
-    /**
-     * @description Normalizes HTTP headers by converting all header values to strings. If a header value is an array, it joins the array elements into a single string separated by commas. This method ensures that the headers are in a consistent format, which can be particularly useful when working with different HTTP client libraries that may represent headers in various ways. If the input headers are not defined or not an object, it returns an empty object.
-     * @param headers The input headers to be normalized, which can be of any type. The method checks if the headers are defined and are an object before processing them.
-     * @returns An object containing the normalized headers, where each header value is a string. If the input headers were not valid, it returns an empty object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly normalizeHeaders: (headers: unknown) => HttpHeaders;
-    /**
-     * @description Sanitizes the origin URL by parsing it and extracting the origin part. If the URL is not valid or cannot be parsed or does not contain an origin, it returns undefined.
-     * @param url The URL to be sanitized.
-     * @returns The sanitized origin URL or undefined if the URL is not valid or cannot be parsed or does not contain an origin.
-     *
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly sanitizeOriginUrl: (url: Optional<string>) => Optional<string>;
-    /**
-     * @description Generates a standardized successful HTTP response with the provided data, status code, metadata, and custom headers. The response includes a success flag set to true, the data payload, and any additional metadata. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
-     * @param data The actual data payload to be included in the successful response. This can be of any type and will be wrapped in a SuccessResponseDto structure.
-     * @param status The HTTP status code for the response, defaulting to 200 (OK) if not provided. This allows for flexibility in indicating different types of successful responses (e.g., 201 for created, 204 for no content).
-     * @param meta Optional metadata to be included in the response. This can contain additional information relevant to the response, such as pagination details, rate limit information, or any other contextual data that may be useful for clients consuming the API.
-     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific responses, such as caching directives, custom authentication headers, or other relevant information.
-     * @returns A ResponseDto object representing the successful HTTP response, containing the status code, success flag, headers, and data payload structured as a SuccessResponseDto.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly success: <T>(data: T | IPaginatedResult<T>, status?: number, meta?: Dictionary, customHeaders?: HttpHeaders) => ResponseDto<T>;
-    /**
-     * @description Generates a standardized error HTTP response with the provided error details, status code, correlation ID, request ID, timestamp, and custom headers. The response includes a success flag set to false, an error object containing the error code, message, and optional details, as well as metadata such as correlation ID and request ID for tracking purposes. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
-     * @param dto An object containing the error details, including the error code, message, optional details, and optional path. This information is structured as an ErrorResponseDto and provides context about the error that occurred.
-     * @param status The HTTP status code for the response, defaulting to 500 (Internal Server Error) if not provided. This allows for flexibility in indicating different types of error responses (e.g., 400 for bad request, 404 for not found).
-     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific error responses, such as caching directives, custom authentication headers, or other relevant information.
-     * @returns A ResponseDto object representing the error HTTP response, containing the status code, success flag, headers, and data payload structured as an ErrorResponseDto.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly error: <T>(dto: ErrorResponseDto, status?: Optional<number>, customHeaders?: Optional<HttpHeaders>) => ResponseDto<T>;
-}>;
-
-/**
- * @description Namespace for safe mathematical operations.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare const MathHelper: Readonly<{
-    /**
-     * @description Constrains a value within an inclusive min-max range.
-     * @param value Input value.
-     * @param min Minimum bound.
-     * @param max Maximum bound.
-     * @returns Clamped value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly clamp: (value: number, min: number, max: number) => number;
-    /**
-     * @description Rounds a number to the specified decimal precision.
-     * @param value Input value.
-     * @param decimals Number of decimal places.
-     * @returns Rounded value.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly roundTo: (value: number, decimals: number) => number;
-    /**
-     * @description Divides two numbers, returning a safe fallback on zero denominator.
-     * @param numerator Numerator.
-     * @param denominator Denominator.
-     * @param fallback Return value when denominator is zero.
-     * @returns Division result or fallback.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly safeDivide: (numerator: number, denominator: number, fallback?: number) => number;
-    /**
-     * @description Returns the percentage of part over total (0–100 scale).
-     * @param part Part value.
-     * @param total Total value.
-     * @returns Percentage or 0 when total is zero.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly toPercentage: (part: number, total: number) => number;
-    /**
-     * @description Converts a value to a number, returning a fallback for non-numeric inputs.
-     * @param value Input value.
-     * @param fallback Fallback value for non-numeric inputs.
-     * @returns Numeric value or fallback.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly toNumber: (value: Optional<unknown>, fallback?: number) => number;
-}>;
-
-/**
- * @description Fornisce utilità per la gestione avanzata di Promise, ritardi asincroni e concorrenza.
- * Astrae le logiche di timing per renderle facilmente testabili e riutilizzabili.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare const PromiseHelper: Readonly<{
-    /**
-     * @description Sospende l'esecuzione asincrona per un numero esatto di millisecondi.
-     * @param ms I millisecondi di attesa.
-     * @returns Una Promise che si risolve al termine del tempo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly delay: (ms: number) => Promise<void>;
-    /**
-     * @description Introduce un ritardo asincrono composto da un tempo base più una variazione casuale.
-     * Fondamentale per mitigare il "Thundering Herd problem" (effetto gregge) distribuendo
-     * nel tempo i retry simultanei di più client.
-     * * @param baseDelayMs Il ritardo minimo garantito.
-     * @param maxJitterMs La variazione massima casuale aggiuntiva.
-     * @returns Una Promise che si risolve al termine del calcolo.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly delayWithJitter: (baseDelayMs: number, maxJitterMs: number) => Promise<void>;
-}>;
-
-/**
- * @description Centralized security utility for data and context sanitization.
- * Enforces OWASP guidelines preventing Log Injection (CWE-117), CRLF injection,
- * and URI protocol manipulation across all application layers.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-declare const SanitizeHelper: Readonly<{
-    /**
-     * @description Removes carriage returns, line feeds, null bytes, and non-printable control characters.
-     * Mitigates Log Forging and Log Injection attacks (CWE-117).
-     * @param value The candidate string to sanitize.
-     * @param maxLength Maximum allowable length after sanitization. Defaults to 256.
-     * @returns Sanitized string or undefined if empty/non-string.
-     */
-    readonly stripControlChars: (value: Optional<string>, maxLength?: number) => Optional<string>;
-    /**
-     * @description Sanitizes navigation paths and URLs, removing control characters
-     * and preventing execution of dangerous pseudo-protocols (e.g. javascript:, data:).
-     * @param path The path string to sanitize.
-     * @param maxLength Maximum length of the path. Defaults to 512.
-     * @returns Sanitized path or '/' fallback for unsafe inputs.
-     */
-    readonly sanitizePath: (path: Optional<string>, maxLength?: number) => Optional<string>;
-    /**
-     * @description Sanitizes an array of strings (e.g. roles, permissions, scopes).
-     * Strips control characters, filters out empty entries, and limits collection size.
-     * @param items Array of strings to sanitize.
-     * @param maxItemLength Maximum allowable character length per item. Defaults to 64.
-     * @param maxItems Maximum total number of elements kept. Defaults to 50.
-     * @returns Immutable array of sanitized strings.
-     */
-    readonly sanitizeStringArray: (items: Optional<string[]>, maxItemLength?: number, maxItems?: number) => Optional<string[]>;
-}>;
-
-/**
- * @description Namespace for string manipulation utilities.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare const StringHelper: Readonly<{
-    /**
-     * @description Safely converts a value to a JSON string, falling back to String() on failure.
-     * @param value The value to stringify.
-     * @returns A JSON string representation of the value, or a fallback string if serialization fails.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly safeStringify: <T>(value: T) => string;
-    /**
-     * @description Safely parses a JSON string, returning a fallback value on failure.
-     * @param input The JSON string to parse.
-     * @param fallback Optional fallback value to return if parsing fails.
-     * @returns The parsed value, or the fallback value if parsing fails.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly safeParse: <T = unknown>(input: string, fallback?: Optional<T>) => T | Optional<string>;
-    /**
-     * @description Converts a string to camelCase.
-     * @param input Input string (supports snake_case, kebab-case, or space-separated).
-     * @returns camelCase string.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly camelCase: (input: string) => string;
-    /**
-     * @description Interpolates {{key}} placeholders in a template string.
-     * @param template Template string with {{key}} tokens.
-     * @param vars Key-value substitution map.
-     * @returns Interpolated string with resolved placeholders.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly interpolate: (template: string, vars: Readonly<Dictionary<string | number>>) => string;
-    /**
-     * @description Truncates a string to maxLength, appending a suffix when truncated.
-     * @param input Input string.
-     * @param maxLength Maximum character length including the suffix.
-     * @param suffix Appended suffix on truncation.
-     * @returns Truncated string.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly truncate: (input: string, maxLength: number, suffix?: string) => string;
-    /**
-     * @description Generates a reference code with a prefix, random alphanumeric part, and year.
-     * @param prefix Custom prefix for the reference code (e.g., "TRV" for travel).
-     * @returns Formatted reference code string.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly generateReferenceCode: (prefix: string) => string;
-    /**
-     * @description Extracts a single string value from a header that may be a string or an array of strings.
-     * @param value The header value, which can be a string or an array of strings.
-     * @returns The first string value if it's an array, the string itself if it's a string, or undefined if it's empty or not defined.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly getSingleValue: (value: Optional<string | string[]>, separator?: Optional<string>) => Optional<string>;
-    readonly getSingleValueWithSplit: (value: string, separator: string) => string;
-}>;
-
-/**
- * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare abstract class ValueObject<T extends object> implements IValueObject<T> {
-    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    protected readonly _props: T;
-    protected constructor(props: T);
-    equals(vo?: Optional<IValueObject<T>>): boolean;
-    getValue(): T;
-    toString(): string;
-}
-
-/**
- * @description AggregateRoot is an abstract class that represents the base class for all aggregate roots in the application. An aggregate root is the root entity of an aggregate, which is a group of related entities and value objects that are treated as a single unit. The AggregateRoot class provides common functionality for managing the state and behavior of aggregate roots, including methods for adding and retrieving uncommitted events, and methods for applying events to the aggregate.
- *
- * @author Xeno
- * @version 1.0.0
- */
-declare abstract class AggregateRoot<TEvent = unknown, TValueObject extends object = object> {
-    readonly id: IValueObject<TValueObject>;
-    private _version;
-    private readonly _uncommittedEvents;
-    /**
-     * @description Constructs a new instance of the AggregateRoot class with the specified ID.
-     * @param {IValueObject<TValueObject>} id - The ID of the aggregate.
-     */
-    constructor(id: IValueObject<TValueObject>);
-    /**
-     * @description Gets the current version of the aggregate.
-     * @returns {number} The current version of the aggregate.
-     */
-    get version(): number;
-    /**
-     * @description Gets the uncommitted events of the aggregate.
-     * @returns {readonly IDomainEvent[]} The uncommitted events of the aggregate.
-     */
-    getUncommittedEvents(): readonly IDomainEvent<TEvent, IValueObject<TValueObject>>[];
-    /**
-     * @description Clears the uncommitted events of the aggregate.
-     */
-    clearUncommittedEvents(): void;
-    /**
-     * @description Loads the aggregate from a history of domain events.
-     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>[]} history - The history of domain events to load.
-     */
-    loadFromHistory(history: IDomainEvent<TEvent, IValueObject<TValueObject>>[]): void;
-    /**
-     * @description Raises a domain event and adds it to the uncommitted events list.
-     * @param {Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>} eventData - The data of the domain event to raise.
-     */
-    protected raise(eventData: Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>): void;
-    /**
-     * @description Applies a domain event to the aggregate root.
-     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>} event - The domain event to apply.
-     * @param {boolean} isNew - Indicates whether the event is new or already committed.
-     */
-    protected abstract apply(event: IDomainEvent<TEvent, IValueObject<TValueObject>>, isNew: boolean): void;
-}
-
-/**
- * @description Configuration options for the authentication service.
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface AuthConfig<TOptions = unknown> {
-    /**
-     * @description The URL of the authentication service.
-     * @type {string}
-     */
-    url: string;
-    /**
-     * @description The key of the authentication service.
-     * @type {string}
-     */
-    key: string;
-    /**
-     * @description The options of the authentication service.
-     * @type {TOptions}
-     */
-    opts: Optional<TOptions>;
-    /**
-     * @description The storage options of the authentication service.
-     * @type {StorageOptions}
-     * @default { type: 'local', cookieOpts: {}, storage: null }
-     */
-    storageOpts: Optional<StorageOptions>;
-    /**
-     * @description The redirect URL of the authentication service.
-     * @type {string}
-     * @default '/'
-     */
-    redirectTo: Optional<string>;
-}
-interface StorageOptions {
-    type: Optional<'local' | 'session' | 'memory' | 'cookie'>;
-    cookieOpts: Optional<CookieOptions>;
-    storage: Optional<IStorage>;
-}
-
-/** @description Configuration for Redis integration, including details such as host, port, and credentials. If enabled, the query bus and command bus (in case of idempotency) pipelines will use Redis as the cache system to store and retrieve data efficiently. The configuration includes specific details for Redis integration, such as host, port, and credentials, providing flexibility in how the cache is implemented and used within the application.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface CacheConfig {
-    /** @description Optional configuration for in-memory cache integration. If enabled, the query bus and command bus (in case of idempotency) pipelines will use an in-memory cache system to store and retrieve data efficiently. The configuration includes specific details for in-memory cache integration, providing flexibility in how the cache is implemented and used within the application.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    inMemory: boolean;
-    /** @description Optional configuration for Redis integration, including details such as host, port, and credentials. If provided and enabled, the application will use Redis as the cache system to store and retrieve data efficiently. The configuration includes specific details for Redis integration, such as host, port, and credentials, providing flexibility in how the cache is implemented and used within the application.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    redis: Optional<CacheClientConfig>;
-}
-/**
- * @description An interface representing a cache client, which provides methods for getting and setting values in a cache storage. This interface abstracts the underlying cache implementation, allowing for flexibility in choosing different caching solutions (e.g., in-memory, Redis) without affecting the rest of the application.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface CacheClientConfig {
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly isFunction: (value: unknown) => value is (...args: readonly unknown[]) => unknown;
     /**
-     * @description The host address of the cache server (e.g., Redis). Optional for in-memory cache implementations.
+     * @description Checks value is an array.
+     * @param value Candidate value.
+     * @returns True when value is array.
     
      *
      * @author Xeno
@@ -3140,18 +1984,23 @@ interface CacheClientConfig {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    host: Optional<string>;
+    readonly isArray: <TValue>(value: unknown) => value is TValue[];
     /**
-     * @description The port number of the cache server (e.g., Redis). Optional for in-memory cache implementations.
+     * @description Checks value is a Date instance with valid timestamp.
+     * @param value Candidate value.
+     * @returns True when value is valid Date.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    port: Optional<number>;
+    readonly isDate: (value: unknown) => value is Date;
     /**
-     * @description The password for authenticating with the cache server (e.g., Redis). Optional for in-memory cache implementations.
+     * @description Checks value is an Error instance.
+     * @param value Candidate value.
+     * @returns True when value is Error.
     
      *
      * @author Xeno
@@ -3159,8 +2008,11 @@ interface CacheClientConfig {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    password: Optional<string>;
-    /** @description The username for authenticating with the cache server (e.g., Redis). Optional for in-memory cache implementations.
+    readonly isError: (value: unknown) => value is Error;
+    /**
+     * @description Checks value is a plain object record.
+     * @param value Candidate value.
+     * @returns True when value is object record.
     
      *
      * @author Xeno
@@ -3168,28 +2020,36 @@ interface CacheClientConfig {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    username: Optional<string>;
-    /** @description A boolean flag indicating whether to use TLS/SSL for the connection to the cache server (e.g., Redis). Optional for in-memory cache implementations.
+    readonly isObjectRecord: (value: unknown) => value is Readonly<Dictionary<unknown>>;
+    /**
+     * @description Checks value is an object (not null).
+     * @param value Candidate value.
+     * @returns True when value is object.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    tls: boolean;
-    /** @description The maximum number of reconnection attempts before declaring failure. Optional for in-memory cache implementations.
+    readonly isObject: (value: unknown) => value is object;
+    /**
+     * @description Checks value is PromiseLike.
+     * @param value Candidate value.
+     * @returns True when value has then function.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    maxRetriesPerRequest: Optional<number>;
-}
+    readonly isPromiseLike: <TValue>(value: unknown) => value is PromiseLike<TValue>;
+}>;
 
 /**
- * @description Configuration options for the Database Module.
- * Contains the connection string for PostgreSQL and a dictionary mapping schema names to Drizzle PgTable definitions.
+ * @fileoverview Utility functions for generating and validating GUIDs (UUID v4).
+ * This module provides a simple interface for working with GUIDs, including generation and validation.
 
    *
    * @author Xeno
@@ -3197,182 +2057,306 @@ interface CacheClientConfig {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface DbConfig {
-    /** @description The connection string used to connect to the PostgreSQL database. This should include the necessary credentials and connection details (e.g., host, port, database name, username, password) required for establishing a connection to the database.
+declare const GuidHelper: Readonly<{
+    /**
+     * @description Generates a cryptographically-random UUID v4.
+     * @returns Lowercase UUID v4 string.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    connectionString: string;
-    /** @description A boolean flag indicating whether to enable SQLite support in the database configuration. If set to true, the application will be configured to use SQLite as the underlying database engine, allowing for lightweight and file-based database operations. This option is useful for scenarios where a full-fledged PostgreSQL server is not required or when running in environments with limited resources.
+    readonly generate: () => Guid;
+    /**
+     * @description Validates if a value is a valid GUID (UUID v4) and not empty.
+     * @param value The value to validate.
+     * @returns True if the value is a valid and non-empty GUID, false otherwise.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    enableSqlLite: boolean;
-}
-
-/**
- * @description Agnostic contract used to execute HTTP calls independently
- * from concrete transport libraries (fetch, axios, undici, etc.),
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface HttpClientConfig {
-    /** @description Optional default headers to include in every request made by the HTTP client.
+    readonly isValidGuid: (value: Guid) => boolean;
+    /**
+     * @description Validates if a string is a valid UUID v4.
+     * @param value Candidate string to validate.
+     * @returns True if the string is a valid UUID v4, false otherwise.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    defaultHeaders: Optional<HttpHeaders>;
-    /** @description Optional base URL to prepend to all request URLs made by the HTTP client.
+    readonly isValid: (value: string) => value is Guid;
+    /**
+     * @description Converts a string to a GUID if it's valid.
+     * @param value The string to convert.
+     * @returns The GUID if the string is valid, otherwise undefined.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    baseURL: Optional<string>;
-    /** @description Optional timeout in milliseconds for all requests made by the HTTP client.
+    readonly parse: (value: Optional<string>) => Optional<Guid>;
+    /**
+     * @description Checks if a GUID is the empty GUID (all zeros).
+     * @param value The GUID to check.
+     * @returns True if the GUID is the empty GUID, false otherwise.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    timeoutMs: Optional<number>;
-    /** @description Optional keep-alive configuration for the HTTP client.
+    readonly isEmpty: (value: string) => boolean;
+}>;
+
+/**
+ * @description This module provides utility functions for handling HTTP-related tasks, such as normalizing HTTP headers. It includes a single function, `normalizeHeaders`, which takes an input of unknown type and returns an object with normalized header values. The function ensures that all header values are converted to strings, and if a header value is an array, it joins the elements into a single string separated by commas. This utility is useful for ensuring consistent header formats when working with various HTTP client libraries.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+/**
+ * @description A helper object that provides utility functions for HTTP-related tasks. Currently, it includes a method for normalizing HTTP headers, which ensures that all header values are strings and handles cases where header values may be arrays. This helper can be extended in the future to include additional HTTP-related utilities as needed.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare const HttpHelper: Readonly<{
+    /**
+     * @description A function that masks the IP address in the given headers object.
+     * @param ip The IP address to mask.
+     * @returns The masked IP address.
+     */
+    readonly maskIp: (ip: Optional<string>) => Optional<string>;
+    /**
+     * @description Normalizes HTTP headers by converting all header values to strings. If a header value is an array, it joins the array elements into a single string separated by commas. This method ensures that the headers are in a consistent format, which can be particularly useful when working with different HTTP client libraries that may represent headers in various ways. If the input headers are not defined or not an object, it returns an empty object.
+     * @param headers The input headers to be normalized, which can be of any type. The method checks if the headers are defined and are an object before processing them.
+     * @returns An object containing the normalized headers, where each header value is a string. If the input headers were not valid, it returns an empty object.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    keepAlive: Optional<boolean>;
-    /** @description Optional maximum number of sockets to be used by the HTTP client.
+    readonly normalizeHeaders: (headers: unknown) => HttpHeaders;
+    /**
+     * @description Sanitizes the origin URL by parsing it and extracting the origin part. If the URL is not valid or cannot be parsed or does not contain an origin, it returns undefined.
+     * @param url The URL to be sanitized.
+     * @returns The sanitized origin URL or undefined if the URL is not valid or cannot be parsed or does not contain an origin.
+     *
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    maxSockets: Optional<number>;
+    readonly sanitizeOriginUrl: (url: Optional<string>) => Optional<string>;
     /**
-     * @description Optional maximum number of redirects to follow for the HTTP client.
+     * @description Generates a standardized successful HTTP response with the provided data, status code, metadata, and custom headers. The response includes a success flag set to true, the data payload, and any additional metadata. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
+     * @param data The actual data payload to be included in the successful response. This can be of any type and will be wrapped in a SuccessResponseDto structure.
+     * @param status The HTTP status code for the response, defaulting to 200 (OK) if not provided. This allows for flexibility in indicating different types of successful responses (e.g., 201 for created, 204 for no content).
+     * @param meta Optional metadata to be included in the response. This can contain additional information relevant to the response, such as pagination details, rate limit information, or any other contextual data that may be useful for clients consuming the API.
+     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific responses, such as caching directives, custom authentication headers, or other relevant information.
+     * @returns A ResponseDto object representing the successful HTTP response, containing the status code, success flag, headers, and data payload structured as a SuccessResponseDto.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    maxRedirects: Optional<number>;
+    readonly success: <T>(data: T | IPaginatedResult<T>, status?: number, meta?: Dictionary, customHeaders?: HttpHeaders) => ResponseDto<T>;
     /**
-     * @description Optional flag to enable or disable automatic decompression of response bodies.
+     * @description Generates a standardized error HTTP response with the provided error details, status code, correlation ID, request ID, timestamp, and custom headers. The response includes a success flag set to false, an error object containing the error code, message, and optional details, as well as metadata such as correlation ID and request ID for tracking purposes. The headers include a default 'Content-Type' of 'application/json' along with any custom headers provided.
+     * @param dto An object containing the error details, including the error code, message, optional details, and optional path. This information is structured as an ErrorResponseDto and provides context about the error that occurred.
+     * @param status The HTTP status code for the response, defaulting to 500 (Internal Server Error) if not provided. This allows for flexibility in indicating different types of error responses (e.g., 400 for bad request, 404 for not found).
+     * @param customHeaders Optional custom HTTP headers to be included in the response. This allows for adding any additional headers that may be necessary for specific error responses, such as caching directives, custom authentication headers, or other relevant information.
+     * @returns A ResponseDto object representing the error HTTP response, containing the status code, success flag, headers, and data payload structured as an ErrorResponseDto.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    decompress: Optional<boolean>;
+    readonly error: <T>(dto: ErrorResponseDto, status?: Optional<number>, customHeaders?: Optional<HttpHeaders>) => ResponseDto<T>;
+}>;
+
+/**
+ * @description Namespace for safe mathematical operations.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare const MathHelper: Readonly<{
     /**
-     * @description Optional flag to enable or disable sending credentials (cookies, authorization headers, or TLS client certificates) with cross-origin requests.
+     * @description Constrains a value within an inclusive min-max range.
+     * @param value Input value.
+     * @param min Minimum bound.
+     * @param max Maximum bound.
+     * @returns Clamped value.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
      */
-    withCredentials: Optional<boolean>;
+    readonly clamp: (value: number, min: number, max: number) => number;
     /**
-     * @description Optional proxy configuration for the HTTP client.
+     * @description Rounds a number to the specified decimal precision.
+     * @param value Input value.
+     * @param decimals Number of decimal places.
+     * @returns Rounded value.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    proxy: ProxyConfig | false;
-}
-/**
- * @description Configuration interface for HTTP client settings, defining parameters such as timeouts, headers, and proxy configurations.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface ProxyConfig {
+    readonly roundTo: (value: number, decimals: number) => number;
     /**
-     * @description The hostname or IP address of the proxy server.
+     * @description Divides two numbers, returning a safe fallback on zero denominator.
+     * @param numerator Numerator.
+     * @param denominator Denominator.
+     * @param fallback Return value when denominator is zero.
+     * @returns Division result or fallback.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    host: string;
+    readonly safeDivide: (numerator: number, denominator: number, fallback?: number) => number;
     /**
-     * @description The port number of the proxy server.
+     * @description Returns the percentage of part over total (0–100 scale).
+     * @param part Part value.
+     * @param total Total value.
+     * @returns Percentage or 0 when total is zero.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    port: number;
+    readonly toPercentage: (part: number, total: number) => number;
     /**
-     * @description Optional authentication credentials for the proxy server.
+     * @description Converts a value to a number, returning a fallback for non-numeric inputs.
+     * @param value Input value.
+     * @param fallback Fallback value for non-numeric inputs.
+     * @returns Numeric value or fallback.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly toNumber: (value: Optional<unknown>, fallback?: number) => number;
+}>;
+
+/**
+ * @description Fornisce utilità per la gestione avanzata di Promise, ritardi asincroni e concorrenza.
+ * Astrae le logiche di timing per renderle facilmente testabili e riutilizzabili.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare const PromiseHelper: Readonly<{
+    /**
+     * @description Sospende l'esecuzione asincrona per un numero esatto di millisecondi.
+     * @param ms I millisecondi di attesa.
+     * @returns Una Promise che si risolve al termine del tempo.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    auth?: {
-        /**
-         * @description The username for the proxy server.
-         *
-         * @author Xeno
-         * @version 1.0.0
-         * @since 2025-09-30
-         * @link https://github.com/xeno-js/xeno-js
-         */
-        username: string;
-        /**
-         * @description The password for the proxy server.
-         *
-         * @author Xeno
-         * @version 1.0.0
-         * @since 2025-09-30
-         * @link https://github.com/xeno-js/xeno-js
-         */
-        password: string;
-    };
+    readonly delay: (ms: number) => Promise<void>;
     /**
-     * @description The protocol to use for the proxy server (e.g., 'http', 'https').
+     * @description Introduce un ritardo asincrono composto da un tempo base più una variazione casuale.
+     * Fondamentale per mitigare il "Thundering Herd problem" (effetto gregge) distribuendo
+     * nel tempo i retry simultanei di più client.
+     * * @param baseDelayMs Il ritardo minimo garantito.
+     * @param maxJitterMs La variazione massima casuale aggiuntiva.
+     * @returns Una Promise che si risolve al termine del calcolo.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
      */
-    protocol?: string;
-}
+    readonly delayWithJitter: (baseDelayMs: number, maxJitterMs: number) => Promise<void>;
+}>;
 
 /**
- * @fileoverview Defines the ICache interface for caching mechanisms within the application.
+ * @description Centralized security utility for data and context sanitization.
+ * Enforces OWASP guidelines preventing Log Injection (CWE-117), CRLF injection,
+ * and URI protocol manipulation across all application layers.
  *
  * @author Xeno
  * @version 1.0.0
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
+declare const SanitizeHelper: Readonly<{
+    /**
+     * @description Removes carriage returns, line feeds, null bytes, and non-printable control characters.
+     * Mitigates Log Forging and Log Injection attacks (CWE-117).
+     * @param value The candidate string to sanitize.
+     * @param maxLength Maximum allowable length after sanitization. Defaults to 256.
+     * @returns Sanitized string or undefined if empty/non-string.
+     */
+    readonly stripControlChars: (value: Optional<string>, maxLength?: number) => Optional<string>;
+    /**
+     * @description Sanitizes navigation paths and URLs, removing control characters
+     * and preventing execution of dangerous pseudo-protocols (e.g. javascript:, data:).
+     * @param path The path string to sanitize.
+     * @param maxLength Maximum length of the path. Defaults to 512.
+     * @returns Sanitized path or '/' fallback for unsafe inputs.
+     */
+    readonly sanitizePath: (path: Optional<string>, maxLength?: number) => Optional<string>;
+    /**
+     * @description Sanitizes an array of strings (e.g. roles, permissions, scopes).
+     * Strips control characters, filters out empty entries, and limits collection size.
+     * @param items Array of strings to sanitize.
+     * @param maxItemLength Maximum allowable character length per item. Defaults to 64.
+     * @param maxItems Maximum total number of elements kept. Defaults to 50.
+     * @returns Immutable array of sanitized strings.
+     */
+    readonly sanitizeStringArray: (items: Optional<string[]>, maxItemLength?: number, maxItems?: number) => Optional<string[]>;
+}>;
+
 /**
- * An interface representing a caching mechanism within the application. This interface provides methods for retrieving and storing values in the cache, as well as clearing the cache when necessary. The get method allows for retrieving values from the cache based on a specified key, while the set method enables storing values in the cache with an optional time-to-live (TTL) parameter to specify how long the value should remain in the cache before it expires. The clear method provides a way to remove all entries from the cache when needed.
+ * @description Namespace for string manipulation utilities.
 
    *
    * @author Xeno
@@ -3380,11 +2364,11 @@ interface ProxyConfig {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface ICache {
+declare const StringHelper: Readonly<{
     /**
-     * Retrieves a value from the cache based on the specified key. If the key exists in the cache and has not expired, the corresponding value will be returned. If the key does not exist or has expired, this method will return undefined, indicating that there is no valid cached value available for the given key.
-     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
-     * @returns The value associated with the specified key if it exists and has not expired; otherwise, returns undefined.
+     * @description Safely converts a value to a JSON string, falling back to String() on failure.
+     * @param value The value to stringify.
+     * @returns A JSON string representation of the value, or a fallback string if serialization fails.
     
      *
      * @author Xeno
@@ -3392,12 +2376,12 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    get<T>(key: string): Promise<Optional<T>>;
+    readonly safeStringify: <T>(value: T) => string;
     /**
-     * Stores a value in the cache with the specified key and an optional time-to-live (TTL) parameter. The TTL parameter specifies how long the value should remain in the cache before it expires. If the TTL is not provided, the value will be stored indefinitely until it is explicitly removed or cleared from the cache. This method allows for efficient caching of values that may have a limited lifespan, ensuring that stale data is not returned when retrieving values from the cache.
-     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
-     * @param value The value to be stored in the cache associated with the specified key.
-     * @param ttl Optional time-to-live (TTL) in milliseconds, indicating how long the value should remain in the cache before it expires. If not provided, the value will be stored indefinitely.
+     * @description Safely parses a JSON string, returning a fallback value on failure.
+     * @param input The JSON string to parse.
+     * @param fallback Optional fallback value to return if parsing fails.
+     * @returns The parsed value, or the fallback value if parsing fails.
     
      *
      * @author Xeno
@@ -3405,13 +2389,11 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    set<T>(key: string, value: T, ttl: Optional<number>): Promise<void>;
+    readonly safeParse: <T = unknown>(input: string, fallback?: Optional<T>) => T | Optional<string>;
     /**
-     * Stores a value in the cache only if the specified key does not already exist. This method is useful for ensuring that a value is only set in the cache if it has not been previously stored, preventing overwriting of existing values. The TTL parameter specifies how long the value should remain in the cache before it expires, similar to the set method. If the key already exists in the cache, this method will return false, indicating that the value was not set; otherwise, it will store the value and return true.
-     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
-     * @param value The value to be stored in the cache associated with the specified key.
-     * @param ttl Optional time-to-live (TTL) in milliseconds, indicating how long the value should remain in the cache before it expires. If not provided, the value will be stored indefinitely.
-     * @returns True if the value was successfully stored in the cache because the key did not already exist; otherwise, returns false if the key already exists in the cache and the value was not set.
+     * @description Converts a string to camelCase.
+     * @param input Input string (supports snake_case, kebab-case, or space-separated).
+     * @returns camelCase string.
     
      *
      * @author Xeno
@@ -3419,10 +2401,12 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    setIfAbsent<T>(key: string, value: T, ttl: Optional<number>): Promise<boolean>;
+    readonly camelCase: (input: string) => string;
     /**
-     * Removes a specific entry from the cache based on the provided key. This method allows for targeted invalidation of cached values when they are no longer valid or needed. After calling this method with a specific key, subsequent calls to the get method with that key will return undefined until a new value is stored in the cache using the set method.
-     * @param key The unique identifier for the cached value to be removed. This key is used to identify which entry in the cache should be invalidated.
+     * @description Interpolates {{key}} placeholders in a template string.
+     * @param template Template string with {{key}} tokens.
+     * @param vars Key-value substitution map.
+     * @returns Interpolated string with resolved placeholders.
     
      *
      * @author Xeno
@@ -3430,11 +2414,13 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    remove(key: string): Promise<void>;
+    readonly interpolate: (template: string, vars: Readonly<Dictionary<string | number>>) => string;
     /**
-     * Checks if a specific key exists in the cache and has not expired. This method returns true if the key is present in the cache and its associated value is still valid; otherwise, it returns false. This can be useful for determining whether a cached value can be retrieved without actually fetching it, allowing for more efficient cache management and decision-making based on the presence of valid cached data.
-     * @param key The unique identifier for the cached value to check for existence. This key is used to determine if a valid entry exists in the cache.
-     * @returns True if the key exists in the cache and has not expired; otherwise, returns false.
+     * @description Truncates a string to maxLength, appending a suffix when truncated.
+     * @param input Input string.
+     * @param maxLength Maximum character length including the suffix.
+     * @param suffix Appended suffix on truncation.
+     * @returns Truncated string.
     
      *
      * @author Xeno
@@ -3442,9 +2428,11 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    has(key: string): Promise<boolean>;
+    readonly truncate: (input: string, maxLength: number, suffix?: string) => string;
     /**
-     * Clears all entries from the cache, effectively removing all stored values. This method can be used when there is a need to invalidate the entire cache, such as when significant changes occur in the underlying data or when the cache needs to be reset for any reason. After calling this method, subsequent calls to the get method will return undefined until new values are stored in the cache using the set method.
+     * @description Generates a reference code with a prefix, random alphanumeric part, and year.
+     * @param prefix Custom prefix for the reference code (e.g., "TRV" for travel).
+     * @returns Formatted reference code string.
     
      *
      * @author Xeno
@@ -3452,114 +2440,162 @@ interface ICache {
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    clear(): Promise<void>;
-}
-
-/**
- * @interface ICacheKeyBuilder
- * @description Interface for building cache keys with contextual information.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface ICacheKeyBuilder {
+    readonly generateReferenceCode: (prefix: string) => string;
     /**
-     * @description Builds a contextual cache key based on the provided key and the current user's identity. If a tenant ID is present in the identity, the cache key is prefixed with the tenant ID; otherwise, it defaults to a public cache key. This method ensures that cached data is appropriately scoped to the user's context, preventing data leakage between tenants.
-     * @param key The base key to be used for building the contextual cache key.
-     * @returns The contextual cache key.
+     * @description Extracts a single string value from a header that may be a string or an array of strings.
+     * @param value The header value, which can be a string or an array of strings.
+     * @returns The first string value if it's an array, the string itself if it's a string, or undefined if it's empty or not defined.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    buildContextualKey(key: string): string;
-    /**
-     * @description Builds a user-scoped cache key based on the provided key and the current user's identity. If a user ID is present in the identity, the cache key is prefixed with the user ID; otherwise, it defaults to a public cache key. This method ensures that cached data is appropriately scoped to the user's context, preventing data leakage between users.
-     * @param key The base key to be used for building the user-scoped cache key.
-     * @returns The user-scoped cache key.
+    readonly getSingleValue: (value: Optional<string | string[]>, separator?: Optional<string>) => Optional<string>;
+    readonly getSingleValueWithSplit: (value: string, separator: string) => string;
+}>;
+
+/**
+ * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare abstract class ValueObject<T extends object> implements IValueObject<T> {
+    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    buildUserScopedKey(key: string): string;
+    protected readonly _props: T;
+    protected constructor(props: T);
+    equals(vo?: Optional<IValueObject<T>>): boolean;
+    getValue(): T;
+    toString(): string;
 }
 
 /**
- * @description
- * This interface defines the contract for a configuration service that provides methods to retrieve configuration values.
+ * @description AggregateRoot is an abstract class that represents the base class for all aggregate roots in the application. An aggregate root is the root entity of an aggregate, which is a group of related entities and value objects that are treated as a single unit. The AggregateRoot class provides common functionality for managing the state and behavior of aggregate roots, including methods for adding and retrieving uncommitted events, and methods for applying events to the aggregate.
  *
  * @author Xeno
  * @version 1.0.0
+ */
+declare abstract class AggregateRoot<TEvent = unknown, TValueObject extends object = object> {
+    readonly id: IValueObject<TValueObject>;
+    private _version;
+    private readonly _uncommittedEvents;
+    /**
+     * @description Constructs a new instance of the AggregateRoot class with the specified ID.
+     * @param {IValueObject<TValueObject>} id - The ID of the aggregate.
+     */
+    constructor(id: IValueObject<TValueObject>);
+    /**
+     * @description Gets the current version of the aggregate.
+     * @returns {number} The current version of the aggregate.
+     */
+    get version(): number;
+    /**
+     * @description Gets the uncommitted events of the aggregate.
+     * @returns {readonly IDomainEvent[]} The uncommitted events of the aggregate.
+     */
+    getUncommittedEvents(): readonly IDomainEvent<TEvent, IValueObject<TValueObject>>[];
+    /**
+     * @description Clears the uncommitted events of the aggregate.
+     */
+    clearUncommittedEvents(): void;
+    /**
+     * @description Loads the aggregate from a history of domain events.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>[]} history - The history of domain events to load.
+     */
+    loadFromHistory(history: IDomainEvent<TEvent, IValueObject<TValueObject>>[]): void;
+    /**
+     * @description Raises a domain event and adds it to the uncommitted events list.
+     * @param {Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>} eventData - The data of the domain event to raise.
+     */
+    protected raise(eventData: Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>): void;
+    /**
+     * @description Applies a domain event to the aggregate root.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>} event - The domain event to apply.
+     * @param {boolean} isNew - Indicates whether the event is new or already committed.
+     */
+    protected abstract apply(event: IDomainEvent<TEvent, IValueObject<TValueObject>>, isNew: boolean): void;
+}
+
+/**
+ * @description Configuration options for the authentication service.
+ * @author Xeno
+ * @version 1.0.0
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface IConfigurationService {
+interface AuthConfig<TOptions = unknown> {
     /**
-     * Retrieves a configuration value as a string. Returns the default value if the key is not present.
-     * @param key - The configuration key to retrieve.
-     * @param defaultValue - The default value to return if the key is not present.
-     * @returns The configuration value as a string, or the default value if the key is not present.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
+     * @description The URL of the authentication service.
+     * @type {string}
      */
-    get(key: string, defaultValue?: string): Optional<string>;
+    url: string;
     /**
-     * Retrieves a configuration value as a number. Returns the default value if the key is not present.
-     * @param key - The configuration key to retrieve.
-     * @param defaultValue - The default value to return if the key is not present.
-     * @returns The configuration value as a number, or the default value if the key is not present.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
+     * @description The key of the authentication service.
+     * @type {string}
+     */
+    key: string;
+    /**
+     * @description The options of the authentication service.
+     * @type {TOptions}
+     */
+    opts: Optional<TOptions>;
+    /**
+     * @description The storage options of the authentication service.
+     * @type {StorageOptions}
+     * @default { type: 'local', cookieOpts: {}, storage: null }
      */
-    getNumber(key: string, defaultValue?: number): Optional<number>;
+    storageOpts: Optional<StorageOptions>;
     /**
-     * Retrieves a configuration value as a boolean. Returns the default value if the key is not present.
-     * @param key - The configuration key to retrieve.
-     * @param defaultValue - The default value to return if the key is not present.
-     * @returns The configuration value as a boolean, or the default value if the key is not present.
+     * @description The redirect URL of the authentication service.
+     * @type {string}
+     * @default '/'
+     */
+    redirectTo: Optional<string>;
+}
+interface StorageOptions {
+    type: Optional<'local' | 'session' | 'memory' | 'cookie'>;
+    cookieOpts: Optional<CookieOptions>;
+    storage: Optional<IStorage>;
+}
+
+/** @description Configuration for Redis integration, including details such as host, port, and credentials. If enabled, the query bus and command bus (in case of idempotency) pipelines will use Redis as the cache system to store and retrieve data efficiently. The configuration includes specific details for Redis integration, such as host, port, and credentials, providing flexibility in how the cache is implemented and used within the application.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface CacheConfig {
+    /** @description Optional configuration for in-memory cache integration. If enabled, the query bus and command bus (in case of idempotency) pipelines will use an in-memory cache system to store and retrieve data efficiently. The configuration includes specific details for in-memory cache integration, providing flexibility in how the cache is implemented and used within the application.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getBoolean(key: string, defaultValue?: boolean): Optional<boolean>;
-    /**
-     * Retrieves a configuration value as a string. Throws an error if the key is not present.
-     * @param key - The configuration key to retrieve.
-     * @returns The configuration value as a string.
-     * @throws An error if the key is not present in the configuration.
+    inMemory: boolean;
+    /** @description Optional configuration for Redis integration, including details such as host, port, and credentials. If provided and enabled, the application will use Redis as the cache system to store and retrieve data efficiently. The configuration includes specific details for Redis integration, such as host, port, and credentials, providing flexibility in how the cache is implemented and used within the application.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getOrThrow(key: string): string;
+    redis: Optional<CacheClientConfig>;
 }
-
-/**
- * @fileoverview Defines the Identity interface representing the authenticated user's identity in the system.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
 /**
- * An interface representing the authenticated user's identity in the system. This interface includes properties such as the user's unique identifier, email address, and assigned roles, which can be used for authentication and authorization purposes throughout the application.
+ * @description An interface representing a cache client, which provides methods for getting and setting values in a cache storage. This interface abstracts the underlying cache implementation, allowing for flexibility in choosing different caching solutions (e.g., in-memory, Redis) without affecting the rest of the application.
 
    *
    * @author Xeno
@@ -3567,211 +2603,249 @@ interface IConfigurationService {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface Identity {
-    /** @description The unique identifier of the user.
+interface CacheClientConfig {
+    /**
+     * @description The host address of the cache server (e.g., Redis). Optional for in-memory cache implementations.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly userId: Optional<Guid>;
-    /** @description The email address of the user.
+    host: Optional<string>;
+    /**
+     * @description The port number of the cache server (e.g., Redis). Optional for in-memory cache implementations.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly email: Optional<string>;
-    readonly name: Optional<string>;
-    /** @description The tenant ID associated with the user.
+    port: Optional<number>;
+    /**
+     * @description The password for authenticating with the cache server (e.g., Redis). Optional for in-memory cache implementations.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly tenantId: Optional<Guid>;
-    /** @description The roles assigned to the user, which can be used for authorization purposes.
+    password: Optional<string>;
+    /** @description The username for authenticating with the cache server (e.g., Redis). Optional for in-memory cache implementations.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly roles: Optional<string[]>;
-    /** @description The permissions assigned to the user, which can be used for fine-grained authorization checks.
+    username: Optional<string>;
+    /** @description A boolean flag indicating whether to use TLS/SSL for the connection to the cache server (e.g., Redis). Optional for in-memory cache implementations.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly permissions: Optional<string[]>;
-}
-
-/**
- * @description MessagingContext defines the structure for messaging-related information used in message handling and processing. It includes properties such as return address, expiration time, and message sequence information, which can be used for managing message delivery, expiration, and sequencing in distributed systems.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface MessageSequence {
-    /** @description The unique identifier for the message sequence, which can be used to track and manage the order of messages in a sequence.
+    tls: boolean;
+    /** @description The maximum number of reconnection attempts before declaring failure. Optional for in-memory cache implementations.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly sequenceId: Optional<string>;
-    /** @description The position of the message within the sequence, which can be used to determine the order of messages in a sequence.
+    maxRetriesPerRequest: Optional<number>;
+}
+
+/**
+ * @description Configuration options for the Database Module.
+ * Contains the connection string for PostgreSQL and a dictionary mapping schema names to Drizzle PgTable definitions.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface DbConfig {
+    /** @description The connection string used to connect to the PostgreSQL database. This should include the necessary credentials and connection details (e.g., host, port, database name, username, password) required for establishing a connection to the database.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly position: Optional<number>;
-    /** @description The total number of messages in the sequence, which can be used to determine the size of the sequence.
+    connectionString: string;
+    /** @description A boolean flag indicating whether to enable SQLite support in the database configuration. If set to true, the application will be configured to use SQLite as the underlying database engine, allowing for lightweight and file-based database operations. This option is useful for scenarios where a full-fledged PostgreSQL server is not required or when running in environments with limited resources.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly size: Optional<number>;
+    enableSqlLite: boolean;
 }
+
 /**
- * @description MessagingContext defines the structure for messaging-related information used in message handling and processing. It includes properties such as return address, expiration time, and message sequence information, which can be used for managing message delivery, expiration, and sequencing in distributed systems.
+ * @description Agnostic contract used to execute HTTP calls independently
+ * from concrete transport libraries (fetch, axios, undici, etc.),
  *
  * @author Xeno
  * @version 1.0.0
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface MessagingContext {
-    /** @description The return address for asynchronous responses, which can be used to specify where to send responses for asynchronous message processing.
+interface HttpClientConfig {
+    /** @description Optional default headers to include in every request made by the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly returnAddress: Optional<string>;
-    /** @description The expiration time for the message, which can be used to determine when the message should be considered expired and no longer processed.
+    defaultHeaders: Optional<HttpHeaders>;
+    /** @description Optional base URL to prepend to all request URLs made by the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly expiration: Optional<number>;
-    /** @description The sequence information for the message, which can be used to manage the order and grouping of messages in a sequence.
+    baseURL: Optional<string>;
+    /** @description Optional timeout in milliseconds for all requests made by the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly sequence: Optional<MessageSequence>;
-}
-
-/**
- * @description NetworkContext defines the structure for network-related information used in logging and monitoring. It includes a request ID for ensuring idempotency and a client IP address for audit logging purposes.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface NetworkContext {
-    /** A unique identifier for the request, which can be used for ensuring idempotency and tracing purposes.
+    timeoutMs: Optional<number>;
+    /** @description Optional keep-alive configuration for the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly requestId: Guid;
-    /** The IP address of the client making the request, which can be used for audit logging and security purposes.
+    keepAlive: Optional<boolean>;
+    /** @description Optional maximum number of sockets to be used by the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly clientIp: Optional<string>;
-    /** The user agent string of the client making the request, which can be used for audit logging and security purposes.
+    maxSockets: Optional<number>;
+    /**
+     * @description Optional maximum number of redirects to follow for the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly userAgent: Optional<string>;
-    /** The format indicator for the request, which can be used for content negotiation and logging purposes.
+    maxRedirects: Optional<number>;
+    /**
+     * @description Optional flag to enable or disable automatic decompression of response bodies.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly formatIndicator: Optional<string>;
-    /** The path of the request, which can be used for routing, logging, or applying specific middleware logic.
+    decompress: Optional<boolean>;
+    /**
+     * @description Optional flag to enable or disable sending credentials (cookies, authorization headers, or TLS client certificates) with cross-origin requests.
+     */
+    withCredentials: Optional<boolean>;
+    /**
+     * @description Optional proxy configuration for the HTTP client.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly path: Optional<string>;
+    proxy: ProxyConfig | false;
+}
+/**
+ * @description Configuration interface for HTTP client settings, defining parameters such as timeouts, headers, and proxy configurations.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface ProxyConfig {
     /**
-     * @description The CSRF token for the request, which can be used for preventing cross-site request forgery attacks.
+     * @description The hostname or IP address of the proxy server.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly csrf: Optional<string>;
+    host: string;
     /**
-     * @description The CSRF cookie for the request, which can be used for preventing cross-site request forgery attacks.
+     * @description The port number of the proxy server.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly csrfCookie: Optional<string>;
+    port: number;
     /**
-     * @description The transport used for the request, which can be used for logging, monitoring, or applying specific middleware logic.
+     * @description Optional authentication credentials for the proxy server.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly transport: Optional<{
-        req: ExtendedRequest;
-        res: Response;
-    }>;
+    auth?: {
+        /**
+         * @description The username for the proxy server.
+         *
+         * @author Xeno
+         * @version 1.0.0
+         * @since 2025-09-30
+         * @link https://github.com/xeno-js/xeno-js
+         */
+        username: string;
+        /**
+         * @description The password for the proxy server.
+         *
+         * @author Xeno
+         * @version 1.0.0
+         * @since 2025-09-30
+         * @link https://github.com/xeno-js/xeno-js
+         */
+        password: string;
+    };
     /**
-     * @description The origin of the request, which can be used for logging, monitoring, or applying specific middleware logic.
+     * @description The protocol to use for the proxy server (e.g., 'http', 'https').
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
      */
-    readonly origin: Optional<string>;
+    protocol?: string;
 }
 
 /**
- * @description TracingContext defines the structure for tracing information used in logging and monitoring. It includes a correlation ID for tracking related operations, a start time for measuring duration, and an optional span ID for distributed tracing.
+ * @fileoverview Defines the ICache interface for caching mechanisms within the application.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+/**
+ * An interface representing a caching mechanism within the application. This interface provides methods for retrieving and storing values in the cache, as well as clearing the cache when necessary. The get method allows for retrieving values from the cache based on a specified key, while the set method enables storing values in the cache with an optional time-to-live (TTL) parameter to specify how long the value should remain in the cache before it expires. The clear method provides a way to remove all entries from the cache when needed.
 
    *
    * @author Xeno
@@ -3779,213 +2853,177 @@ interface NetworkContext {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface TracingContext {
-    /** A unique identifier for correlating related operations across different services or components.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly correlationId: Guid;
-    /** The timestamp indicating when the operation started, used for measuring duration and performance.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly startTime: number;
-    /** An optional identifier for distributed tracing, which can be used to track the flow of requests across multiple services in a microservices architecture.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly spanId: Optional<string>;
-    /** An optional identifier for the parent span in distributed tracing, which can be used to establish a hierarchy of spans and track the flow of requests across multiple services in a microservices architecture.
+interface ICache {
+    /**
+     * Retrieves a value from the cache based on the specified key. If the key exists in the cache and has not expired, the corresponding value will be returned. If the key does not exist or has expired, this method will return undefined, indicating that there is no valid cached value available for the given key.
+     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
+     * @returns The value associated with the specified key if it exists and has not expired; otherwise, returns undefined.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly parentSpanId: Optional<string>;
+    get<T>(key: string): Promise<Optional<T>>;
     /**
-     * @description The referer header of the request.
+     * Stores a value in the cache with the specified key and an optional time-to-live (TTL) parameter. The TTL parameter specifies how long the value should remain in the cache before it expires. If the TTL is not provided, the value will be stored indefinitely until it is explicitly removed or cleared from the cache. This method allows for efficient caching of values that may have a limited lifespan, ensuring that stale data is not returned when retrieving values from the cache.
+     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
+     * @param value The value to be stored in the cache associated with the specified key.
+     * @param ttl Optional time-to-live (TTL) in milliseconds, indicating how long the value should remain in the cache before it expires. If not provided, the value will be stored indefinitely.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly referer?: Optional<string>;
-}
-
-/**
- * @description RequestContext defines the structure for the context of a request execution, which includes the identity of the user or system executing the request, the network context for tracing and logging purposes, and the tracing context for distributed tracing across services. This context is essential for ensuring proper authentication, authorization, and observability in a distributed system.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface RequestContext {
-    /** The identity of the user or system executing the request, which can be used for authentication and authorization purposes.
+    set<T>(key: string, value: T, ttl: Optional<number>): Promise<void>;
+    /**
+     * Stores a value in the cache only if the specified key does not already exist. This method is useful for ensuring that a value is only set in the cache if it has not been previously stored, preventing overwriting of existing values. The TTL parameter specifies how long the value should remain in the cache before it expires, similar to the set method. If the key already exists in the cache, this method will return false, indicating that the value was not set; otherwise, it will store the value and return true.
+     * @param key The unique identifier for the cached value. This key is used to store and retrieve values from the cache.
+     * @param value The value to be stored in the cache associated with the specified key.
+     * @param ttl Optional time-to-live (TTL) in milliseconds, indicating how long the value should remain in the cache before it expires. If not provided, the value will be stored indefinitely.
+     * @returns True if the value was successfully stored in the cache because the key did not already exist; otherwise, returns false if the key already exists in the cache and the value was not set.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly identity: Identity;
-    /** The network context of the request, which includes information such as the client's IP address and request ID for tracing purposes.
+    setIfAbsent<T>(key: string, value: T, ttl: Optional<number>): Promise<boolean>;
+    /**
+     * Removes a specific entry from the cache based on the provided key. This method allows for targeted invalidation of cached values when they are no longer valid or needed. After calling this method with a specific key, subsequent calls to the get method with that key will return undefined until a new value is stored in the cache using the set method.
+     * @param key The unique identifier for the cached value to be removed. This key is used to identify which entry in the cache should be invalidated.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly network: NetworkContext;
-    /** The tracing context of the request, which includes information for distributed tracing and correlation across services.
+    remove(key: string): Promise<void>;
+    /**
+     * Checks if a specific key exists in the cache and has not expired. This method returns true if the key is present in the cache and its associated value is still valid; otherwise, it returns false. This can be useful for determining whether a cached value can be retrieved without actually fetching it, allowing for more efficient cache management and decision-making based on the presence of valid cached data.
+     * @param key The unique identifier for the cached value to check for existence. This key is used to determine if a valid entry exists in the cache.
+     * @returns True if the key exists in the cache and has not expired; otherwise, returns false.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly tracing: TracingContext;
-    /** The messaging context of the request, which includes information related to messaging systems, such as return addresses and message expiration times. This context is useful for handling asynchronous communication and message-based workflows.
+    has(key: string): Promise<boolean>;
+    /**
+     * Clears all entries from the cache, effectively removing all stored values. This method can be used when there is a need to invalidate the entire cache, such as when significant changes occur in the underlying data or when the cache needs to be reset for any reason. After calling this method, subsequent calls to the get method will return undefined until new values are stored in the cache using the set method.
+    
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly messaging?: Maybe<MessagingContext>;
+    clear(): Promise<void>;
 }
 
-interface IBaseAccessor<TCtx> extends IContextAccessor<TCtx>, IIdentityAccessor, INetworkContextAccessor {
-}
 /**
- * @description The IRequestContext interface is a contract that defines the structure and behavior of a request context within the application. It provides methods for executing asynchronous functions with the current user's identity context and retrieving the current user's identity information. This interface is essential for managing user identity and ensuring that identity-related data is properly propagated throughout the application.
- *
+ * @interface ICacheKeyBuilder
+ * @description Interface for building cache keys with contextual information.
  *
  * @author Xeno
  * @version 1.0.0
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface IIdentityAccessor {
+interface ICacheKeyBuilder {
     /**
-     * Retrieves the current user's identity information, including user ID, roles, and correlation ID. This method can be used to access identity data outside of the context of an asynchronous function, allowing for synchronous access to identity information when needed.
-     * @returns An object representing the current user's identity, containing properties such as user ID, roles, and correlation ID. This information can be used for authentication and authorization purposes throughout the application.
+     * @description Builds a contextual cache key based on the provided key and the current user's identity. If a tenant ID is present in the identity, the cache key is prefixed with the tenant ID; otherwise, it defaults to a public cache key. This method ensures that cached data is appropriately scoped to the user's context, preventing data leakage between tenants.
+     * @param key The base key to be used for building the contextual cache key.
+     * @returns The contextual cache key.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getIdentity(): Optional<Identity>;
-}
-/**
- * @description The IServiceScopeAccessor interface is a contract that defines the structure and behavior of a service scope accessor within the application. It provides a method for retrieving the current service scope, which allows for managing dependencies during the execution of a request. This interface is essential for ensuring that services are properly scoped and disposed of after the request is processed.
- *
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface IContextAccessor<TCtx> {
+    buildContextualKey(key: string): string;
     /**
-     * Retrieves the current context, which can include information about the identity of the user or system executing the request, as well as network and tracing contexts for observability. This method allows for synchronous access to context-related data when needed.
-     * @returns An object representing the current context, containing properties such as identity, network, and tracing contexts. This information can be used for managing execution context and ensuring that context-related data is accessible when needed.
+     * @description Builds a user-scoped cache key based on the provided key and the current user's identity. If a user ID is present in the identity, the cache key is prefixed with the user ID; otherwise, it defaults to a public cache key. This method ensures that cached data is appropriately scoped to the user's context, preventing data leakage between users.
+     * @param key The base key to be used for building the user-scoped cache key.
+     * @returns The user-scoped cache key.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getContext(): Optional<TCtx>;
+    buildUserScopedKey(key: string): string;
 }
+
 /**
- * @description The IContextAccessor interface is a contract that defines the structure and behavior of a context accessor within the application. It provides a method for retrieving the current context, which can include information about the identity of the user or system executing the request, as well as network and tracing contexts for observability. This interface is essential for managing execution context and ensuring that context-related data is accessible when needed.
- *
+ * @description
+ * This interface defines the contract for a configuration service that provides methods to retrieve configuration values.
  *
  * @author Xeno
  * @version 1.0.0
  * @since 2025-09-30
  * @link https://github.com/xeno-js/xeno-js
  */
-interface INetworkContextAccessor {
+interface IConfigurationService {
     /**
-     * Retrieves the current network context, which can include information about the request ID, correlation ID, and other network-related data. This method allows for synchronous access to network context-related data when needed.
-     * @returns An object representing the current network context, containing properties such as request ID, correlation ID, and other network-related data. This information can be used for managing execution context and ensuring that network context-related data is accessible when needed.
+     * Retrieves a configuration value as a string. Returns the default value if the key is not present.
+     * @param key - The configuration key to retrieve.
+     * @param defaultValue - The default value to return if the key is not present.
+     * @returns The configuration value as a string, or the default value if the key is not present.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getNetworkContext(): Optional<NetworkContext>;
-}
-
-/**
- * @fileoverview IController defines the interface for controllers in the application. A controller is responsible for handling incoming requests, processing them, and returning appropriate responses. The IController interface ensures that all controllers adhere to a consistent structure, making it easier to manage and maintain the application's request handling logic. Each controller must implement the handle method, which takes an incoming request and returns a response, typically as a promise to accommodate asynchronous operations.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface IController<TRequest = unknown, TResponse = unknown> {
+    get(key: string, defaultValue?: string): Optional<string>;
     /**
-     * Handles an incoming request and returns a response.
-     * @param request - The incoming request object.
-     * @param signal - The AbortSignal
-     * @returns A promise that resolves to a ResponseDto containing the response object.
+     * Retrieves a configuration value as a number. Returns the default value if the key is not present.
+     * @param key - The configuration key to retrieve.
+     * @param defaultValue - The default value to return if the key is not present.
+     * @returns The configuration value as a number, or the default value if the key is not present.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-shared
+     * @link https://github.com/xeno-js/xeno-js
      */
-    handle(request: TRequest, signal: AbortSignal): Promise<ResponseDto<TResponse>>;
-}
-
-/**
- * @fileoverview Defines the IRequest interface for requests in a CQRS architecture.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IRequest<TResponse = unknown> {
-    readonly $type?: TResponse;
-    /** @description The intent of the request, which can be used to describe the purpose or action associated with the request.
+    getNumber(key: string, defaultValue?: number): Optional<number>;
+    /**
+     * Retrieves a configuration value as a boolean. Returns the default value if the key is not present.
+     * @param key - The configuration key to retrieve.
+     * @param defaultValue - The default value to return if the key is not present.
+     * @returns The configuration value as a boolean, or the default value if the key is not present.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly intent: string;
-    /** @description The type of the request, which can be used to distinguish between different kinds of requests (e.g., command, query).
+    getBoolean(key: string, defaultValue?: boolean): Optional<boolean>;
+    /**
+     * Retrieves a configuration value as a string. Throws an error if the key is not present.
+     * @param key - The configuration key to retrieve.
+     * @returns The configuration value as a string.
+     * @throws An error if the key is not present in the configuration.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly type: RequestType;
+    getOrThrow(key: string): string;
 }
 
 /**
- * @fileoverview Defines the ICommand interface for base requests in a CQRS architecture.
+ * @fileoverview Defines the Identity interface representing the authenticated user's identity in the system.
 
    *
    * @author Xeno
@@ -3994,7 +3032,7 @@ interface IRequest<TResponse = unknown> {
    * @link https://github.com/xeno-js/xeno-js
    */
 /**
- * @description An interface representing a base request in a CQRS architecture. This interface can be implemented by both command and query requests, as it includes common properties such as the request type, timestamp, and a unique token for identification.
+ * An interface representing the authenticated user's identity in the system. This interface includes properties such as the user's unique identifier, email address, and assigned roles, which can be used for authentication and authorization purposes throughout the application.
 
    *
    * @author Xeno
@@ -4002,416 +3040,463 @@ interface IRequest<TResponse = unknown> {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-interface ICommand<TResponse = unknown> extends IRequest<TResponse> {
-    /** @description An optional property to specify the expected response type of the command, which can be used for type inference and validation in command handlers.
+interface Identity {
+    /** @description The unique identifier of the user.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly $type?: TResponse;
-}
-
-/**
- * @fileoverview Defines the IQuery interface for query requests in a CQRS architecture.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-/**
- * @description An interface representing a paginated query request, which extends the IQuery interface and includes pagination parameters.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IQuery<TResponse = unknown> extends IRequest<TResponse> {
-    /**
-     * @description Cache options for the query, including cache key, TTL, and bypass flags.
+    readonly userId: Optional<Guid>;
+    /** @description The email address of the user.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly cacheOptions: ICacheableOptions;
+    readonly email: Optional<string>;
+    readonly name: Optional<string>;
+    /** @description The tenant ID associated with the user.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly tenantId: Optional<Guid>;
+    /** @description The roles assigned to the user, which can be used for authorization purposes.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly roles: Optional<string[]>;
+    /** @description The permissions assigned to the user, which can be used for fine-grained authorization checks.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly permissions: Optional<string[]>;
 }
 
 /**
- * A class representing an application error, which extends the built-in Error class.
- * It includes additional properties such as an error code and an HTTP status code.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface ErrorPayload {
-    /** The error message describing the error.
+ * @description MessagingContext defines the structure for messaging-related information used in message handling and processing. It includes properties such as return address, expiration time, and message sequence information, which can be used for managing message delivery, expiration, and sequencing in distributed systems.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface MessageSequence {
+    /** @description The unique identifier for the message sequence, which can be used to track and manage the order of messages in a sequence.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly sequenceId: Optional<string>;
+    /** @description The position of the message within the sequence, which can be used to determine the order of messages in a sequence.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    message: string;
-    /** The error code representing the type of error.
+    readonly position: Optional<number>;
+    /** @description The total number of messages in the sequence, which can be used to determine the size of the sequence.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    code: string;
-    /** The HTTP status code associated with the error.
+    readonly size: Optional<number>;
+}
+/**
+ * @description MessagingContext defines the structure for messaging-related information used in message handling and processing. It includes properties such as return address, expiration time, and message sequence information, which can be used for managing message delivery, expiration, and sequencing in distributed systems.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface MessagingContext {
+    /** @description The return address for asynchronous responses, which can be used to specify where to send responses for asynchronous message processing.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    status: number;
-    /** The name of the error, typically the class name.
+    readonly returnAddress: Optional<string>;
+    /** @description The expiration time for the message, which can be used to determine when the message should be considered expired and no longer processed.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    name: string;
-    /** An optional property to hold the original error or any additional context.
+    readonly expiration: Optional<number>;
+    /** @description The sequence information for the message, which can be used to manage the order and grouping of messages in a sequence.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    cause: Optional<unknown>;
-    /** A Dictionary to hold any additional context or information related to the error.
+    readonly sequence: Optional<MessageSequence>;
+}
+
+/**
+ * @description NetworkContext defines the structure for network-related information used in logging and monitoring. It includes a request ID for ensuring idempotency and a client IP address for audit logging purposes.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface NetworkContext {
+    /** A unique identifier for the request, which can be used for ensuring idempotency and tracing purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    [key: string]: unknown;
-}
-/**
- * A class representing an application error, which extends the built-in Error class.
- * It includes additional properties such as an error code and an HTTP status code.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare class AppError extends Error {
-    /**
-     * The error code representing the type of error.
-    
+    readonly requestId: Guid;
+    /** The IP address of the client making the request, which can be used for audit logging and security purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly code: string;
-    /**
-     * The HTTP status code associated with the error.
-    
+    readonly clientIp: Optional<string>;
+    /** The user agent string of the client making the request, which can be used for audit logging and security purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly status: number;
-    /**
-     * A Dictionary to hold any additional context or information related to the error.
+    readonly userAgent: Optional<string>;
+    /** The format indicator for the request, which can be used for content negotiation and logging purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly [key: string]: unknown;
-    /**
-     * Private constructor to prevent direct instantiation. Use the static methods `create` and `throw` to create instances.
-     *
-     * @param payload - The payload containing error details.
-    
+    readonly formatIndicator: Optional<string>;
+    /** The path of the request, which can be used for routing, logging, or applying specific middleware logic.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    private constructor();
+    readonly path: Optional<string>;
     /**
-     * Creates an AppError instance with the given error payload.
-     *
-     * @param payload - The payload containing error details.
-     * @returns An AppError instance representing the error.
-    
+     * @description The CSRF token for the request, which can be used for preventing cross-site request forgery attacks.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static create(payload: ErrorPayload): AppError;
+    readonly csrf: Optional<string>;
     /**
-     * Creates an AppError instance and throws it immediately.
-     * @param payload - The payload containing error details.
-     * @throws An AppError instance representing the error.
-    
+     * @description The CSRF cookie for the request, which can be used for preventing cross-site request forgery attacks.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static throw(payload: ErrorPayload): never;
+    readonly csrfCookie: Optional<string>;
     /**
-     * Creates an AppError instance representing an aborted request.
-     * @param name - The name of the error, typically the class name or context where the error occurred.
-     * @returns An AppError instance representing the aborted request error.
-    
+     * @description The transport used for the request, which can be used for logging, monitoring, or applying specific middleware logic.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static aborted(name: string): AppError;
+    readonly transport: Optional<{
+        req: ExtendedRequest;
+        res: Response;
+    }>;
     /**
-     * Utility method to check if an AbortSignal has been triggered and throw an AppError if it has.
-     * @param signal - The AbortSignal to check for abortion.
-     * @param name - The name of the error, typically the class name or context where the error occurred.
-    
+     * @description The origin of the request, which can be used for logging, monitoring, or applying specific middleware logic.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static throwIfAborted(signal: Maybe<AbortSignal>, name: string): void;
-    /** @description Creates an AppError instance representing an unauthorized access error. This method is used to generate a standardized error response when a user attempts to access a resource or perform an action without the necessary authentication or authorization.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the unauthorized access. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the unauthorized access error.
+    readonly origin: Optional<string>;
+}
+
+/**
+ * @description TracingContext defines the structure for tracing information used in logging and monitoring. It includes a correlation ID for tracking related operations, a start time for measuring duration, and an optional span ID for distributed tracing.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface TracingContext {
+    /** A unique identifier for correlating related operations across different services or components.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static unauthorized(name: string, message: string): AppError;
-    static notSupported(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a forbidden access error. This method is used to generate a standardized error response when a user attempts to access a resource or perform an action that they are not authorized to access, even if they are authenticated.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the forbidden access. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the forbidden access error.
+    readonly correlationId: Guid;
+    /** The timestamp indicating when the operation started, used for measuring duration and performance.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static forbidden(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a bad request error. This method is used to generate a standardized error response when a request made by the client is invalid or cannot be processed due to client-side issues, such as validation errors or malformed requests.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the bad request. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the bad request error.
+    readonly startTime: number;
+    /** An optional identifier for distributed tracing, which can be used to track the flow of requests across multiple services in a microservices architecture.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static badRequest(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a validation error. This method is used to generate a standardized error response when one or more input fields fail invariant or schema validation, indicating that the request cannot be processed due to invalid data.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the validation failure. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the validation error.
+    readonly spanId: Optional<string>;
+    /** An optional identifier for the parent span in distributed tracing, which can be used to establish a hierarchy of spans and track the flow of requests across multiple services in a microservices architecture.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static validationError(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a conflict error. This method is used to generate a standardized error response when a request conflicts with the current state of the resource, such as when attempting to create a resource that already exists or update a resource that has been modified by another process.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the conflict. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the conflict error.
+    readonly parentSpanId: Optional<string>;
+    /**
+     * @description The referer header of the request.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static conflict(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a not found error. This method is used to generate a standardized error response when a requested resource does not exist, indicating that the client attempted to access a resource that could not be found on the server.
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the not found error. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the not found error.
+    readonly referer?: Optional<string>;
+}
+
+/**
+ * @description RequestContext defines the structure for the context of a request execution, which includes the identity of the user or system executing the request, the network context for tracing and logging purposes, and the tracing context for distributed tracing across services. This context is essential for ensuring proper authentication, authorization, and observability in a distributed system.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface RequestContext {
+    /** The identity of the user or system executing the request, which can be used for authentication and authorization purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static notFound(name: string, message: string): AppError;
-    /** @description Creates an AppError instance representing a Authentication failed. This method is used to generate a standardized error response when an auth requested produce an error..
-     * @param name The name of the error, typically the class name or context where the error occurred. This helps in identifying the source of the error in logs and error reports.
-     * @param message A custom message describing the reason for the Authentication failed. This message is included in the AppError's cause for detailed error reporting.
-     * @returns An AppError instance representing the Authentication failed.
+    readonly identity: Identity;
+    /** The network context of the request, which includes information such as the client's IP address and request ID for tracing purposes.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static authFailed(name: string, message: string): AppError;
-}
-
-/**
- * A class representing the result of an operation, which can either be a success or a failure.
- * It encapsulates the value of a successful operation or the error of a failed operation.
- *
- * @template TValue - The type of the value in case of a successful operation.
- * @template TError - The type of the error in case of a failed operation (default is never).
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare class Result<TValue, TError = never> {
-    /**
-     * Indicates whether the operation was successful or not.
-    
+    readonly network: NetworkContext;
+    /** The tracing context of the request, which includes information for distributed tracing and correlation across services.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    private readonly _isSuccess;
-    /**
-     * The error of the operation in case it failed.
-    
+    readonly tracing: TracingContext;
+    /** The messaging context of the request, which includes information related to messaging systems, such as return addresses and message expiration times. This context is useful for handling asynchronous communication and message-based workflows.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    private readonly _error;
+    readonly messaging?: Maybe<MessagingContext>;
+}
+
+interface IBaseAccessor<TCtx> extends IContextAccessor<TCtx>, IIdentityAccessor, INetworkContextAccessor {
+}
+/**
+ * @description The IRequestContext interface is a contract that defines the structure and behavior of a request context within the application. It provides methods for executing asynchronous functions with the current user's identity context and retrieving the current user's identity information. This interface is essential for managing user identity and ensuring that identity-related data is properly propagated throughout the application.
+ *
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface IIdentityAccessor {
     /**
-     * The value of the operation in case it succeeded.
-    
+     * Retrieves the current user's identity information, including user ID, roles, and correlation ID. This method can be used to access identity data outside of the context of an asynchronous function, allowing for synchronous access to identity information when needed.
+     * @returns An object representing the current user's identity, containing properties such as user ID, roles, and correlation ID. This information can be used for authentication and authorization purposes throughout the application.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    private readonly _value;
+    getIdentity(): Optional<Identity>;
+}
+/**
+ * @description The IServiceScopeAccessor interface is a contract that defines the structure and behavior of a service scope accessor within the application. It provides a method for retrieving the current service scope, which allows for managing dependencies during the execution of a request. This interface is essential for ensuring that services are properly scoped and disposed of after the request is processed.
+ *
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface IContextAccessor<TCtx> {
     /**
-     * Private constructor to prevent direct instantiation. Use the static methods `ok` and `fail` to create instances.
-     *
-     * @param isSuccess - A boolean indicating whether the operation was successful.
-     * @param error - The error of the operation in case it failed (optional).
-     * @param value - The value of the operation in case it succeeded (optional).
-    
+     * Retrieves the current context, which can include information about the identity of the user or system executing the request, as well as network and tracing contexts for observability. This method allows for synchronous access to context-related data when needed.
+     * @returns An object representing the current context, containing properties such as identity, network, and tracing contexts. This information can be used for managing execution context and ensuring that context-related data is accessible when needed.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    private constructor();
+    getContext(): Optional<TCtx>;
+}
+/**
+ * @description The IContextAccessor interface is a contract that defines the structure and behavior of a context accessor within the application. It provides a method for retrieving the current context, which can include information about the identity of the user or system executing the request, as well as network and tracing contexts for observability. This interface is essential for managing execution context and ensuring that context-related data is accessible when needed.
+ *
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface INetworkContextAccessor {
     /**
-     * Creates a successful result with the given value.
-     *
-     * @param value - The value of the successful operation.
-     * @returns A Result instance representing a successful operation.
-    
+     * Retrieves the current network context, which can include information about the request ID, correlation ID, and other network-related data. This method allows for synchronous access to network context-related data when needed.
+     * @returns An object representing the current network context, containing properties such as request ID, correlation ID, and other network-related data. This information can be used for managing execution context and ensuring that network context-related data is accessible when needed.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    static ok<U>(value?: U): Result<U>;
+    getNetworkContext(): Optional<NetworkContext>;
+}
+
+/**
+ * @fileoverview IController defines the interface for controllers in the application. A controller is responsible for handling incoming requests, processing them, and returning appropriate responses. The IController interface ensures that all controllers adhere to a consistent structure, making it easier to manage and maintain the application's request handling logic. Each controller must implement the handle method, which takes an incoming request and returns a response, typically as a promise to accommodate asynchronous operations.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+interface IController<TRequest = unknown, TResponse = unknown> {
     /**
-     * Creates a failed result with the given error.
-     *
-     * @param error - The error of the failed operation.
-     * @returns A Result instance representing a failed operation.
-    
+     * Handles an incoming request and returns a response.
+     * @param request - The incoming request object.
+     * @param signal - The AbortSignal
+     * @returns A promise that resolves to a ResponseDto containing the response object.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
+     * @link https://github.com/xeno-js/xeno-shared
      */
-    static fail<U, V = never>(error: V): Result<U, V>;
-    /**
-     * Checks if the result is a success.
-     *
-     * @returns True if the result is a success, false otherwise.
-    
+    handle(request: TRequest, signal: AbortSignal): Promise<ResponseDto<TResponse>>;
+}
+
+/**
+ * @fileoverview Defines the IRequest interface for requests in a CQRS architecture.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface IRequest<TResponse = unknown> {
+    readonly $type?: TResponse;
+    /** @description The intent of the request, which can be used to describe the purpose or action associated with the request.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    isOk(): boolean;
-    /**
-     * Gets the value of the result or throws an error if the result is a failure.
-     *
-     * @returns The value of the result.
-     * @throws An error if the result is a failure.
-    
+    readonly intent: string;
+    /** @description The type of the request, which can be used to distinguish between different kinds of requests (e.g., command, query).
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getValueOrThrow(): Optional<TValue>;
-    /**
-     * Gets the error of the result or throws an error if the result is a success.
-     *
-     * @returns The error of the result.
-     * @throws An error if the result is a success.
-    
+    readonly type: RequestType;
+}
+
+/**
+ * @fileoverview Defines the ICommand interface for base requests in a CQRS architecture.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+/**
+ * @description An interface representing a base request in a CQRS architecture. This interface can be implemented by both command and query requests, as it includes common properties such as the request type, timestamp, and a unique token for identification.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface ICommand<TResponse = unknown> extends IRequest<TResponse> {
+    /** @description An optional property to specify the expected response type of the command, which can be used for type inference and validation in command handlers.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    getErrorOrThrow(): TError;
+    readonly $type?: TResponse;
 }
 
 /**
- * A utility type to extract the value type from a Result instance.
- *
- * @template T - The type of the Result instance.
+ * @fileoverview Defines the IQuery interface for query requests in a CQRS architecture.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+/**
+ * @description An interface representing a paginated query request, which extends the IQuery interface and includes pagination parameters.
 
    *
    * @author Xeno
@@ -4419,7 +3504,17 @@ declare class Result<TValue, TError = never> {
    * @since 2025-09-30
    * @link https://github.com/xeno-js/xeno-js
    */
-type ResultType<T, E = AppError> = Result<T, E>;
+interface IQuery<TResponse = unknown> extends IRequest<TResponse> {
+    /**
+     * @description Cache options for the query, including cache key, TTL, and bypass flags.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    readonly cacheOptions: ICacheableOptions;
+}
 
 /**
  * An interface representing a handler for processing requests in a CQRS (Command Query Responsibility Segregation) pattern.
@@ -4792,86 +3887,6 @@ interface IGateKeeper {
     authenticate(token: Optional<string>): Promise<ResultType<Identity>>;
 }
 
-/**
- * @description Agnostic contract used to execute HTTP calls independently from concrete transport libraries (fetch, axios, undici, etc.).
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IHttpClient {
-    /**
-     * @description Executes an HTTP GET request to the specified URL with optional request options.
-     * @param url The URL to which the GET request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
-     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
-     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    get<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    /**
-     * @description Executes an HTTP POST request to the specified URL with the provided request body and optional request options.
-     * @param url The URL to which the POST request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
-     * @param body The request body to be sent with the POST request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
-     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
-     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    post<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    /**
-     * @description Executes an HTTP PUT request to the specified URL with the provided request body and optional request options.
-     * @param url The URL to which the PUT request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
-     * @param body The request body to be sent with the PUT request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
-     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
-     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    put<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    /**
-     * @description Executes an HTTP PATCH request to the specified URL with the provided request body and optional request options.
-     * @param url The URL to which the PATCH request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
-     * @param body The request body to be sent with the PATCH request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
-     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
-     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    patch<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    /**
-     * @description Executes an HTTP DELETE request to the specified URL with optional request options.
-     * @param url The URL to which the DELETE request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
-     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
-     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    delete<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-}
-
 /**
  * @description Interface for an idempotency store that provides methods for acquiring locks, checking if a command has been processed, marking commands as processed with associated payloads, retrieving stored payloads, and releasing locks. This interface is designed to support idempotent command processing in a distributed system, ensuring that duplicate commands are not processed multiple times and that the results of previously processed commands can be retrieved when necessary.
 
@@ -4942,67 +3957,6 @@ interface IIdempotencyStore {
     releaseLock(commandId: string): Promise<void>;
 }
 
-/**
- * @description Interface for a logger that provides methods for logging messages at different levels (info, warn, error, debug) and tracking exceptions. Each logging method accepts a message and an optional context, while the error method also accepts an optional Error object.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface ILogger {
-    /**
-     * Log a message at the info level with an optional context.
-     * @param message The message to log.
-     * @param context An optional dictionary containing additional context for the log message.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    info(message: string): void;
-    /**
-     * Log a message at the warning level with an optional context.
-     * @param message The message to log.
-     * @param context An optional dictionary containing additional context for the log message.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    warn(message: string): void;
-    /**
-     * Log a message at the error level with an optional error object and context.
-     * @param message The message to log.
-     * @param error An optional unknown object associated with the log message.
-     * @param context An optional dictionary containing additional context for the log message.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    error(message: string, error: Optional<unknown>): void;
-    /**
-     * Log a message at the debug level with an optional context.
-     * @param message The message to log.
-     * @param context An optional dictionary containing additional context for the log message.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    debug(message: string): void;
-}
-
 /**
  * @description Interface for a logger client that provides a method for tracking log messages with a specified log level, message, optional context, and optional error.
 
@@ -5052,39 +4006,6 @@ interface LoggerContext {
     messaging?: Maybe<MessagingContext>;
 }
 
-/**
- *  @description Generic mapper interface defining a contract for mapping objects of type TSource to type TDestination. Mappers are used to convert data between different layers of the application, such as transforming DTOs to domain entities or vice versa. This interface defines a contract that all mappers must implement, ensuring consistency and maintainability of the code.
- *  @template TSource The type of the source object to be mapped.
- *  @template TDestination The type of the destination object resulting from the mapping.
- *  @example
- *  // Example of a UserMapper that maps a UserDTO to a UserEntity
- *  class UserMapper implements IBaseMapper<UserDTO, UserEntity> {
- *      map(source: UserDTO): UserEntity {
- *          // Mapping logic here
- *      }
- *  }
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IBaseMapper<TSource, TDestination> {
-    /**
-     * @description Maps an object of type TSource to an object of type TDestination. The implementation of this method should contain the logic for transforming the source object into the desired destination format, which may involve copying properties, converting data types, or applying any necessary transformations to ensure that the resulting object is correctly structured for its intended use.
-     * @param source The source object of type TSource that needs to be mapped to type TDestination. This object contains the data that will be transformed and returned as a new object of the destination type.
-     * @returns An object of type TDestination that is the result of mapping the source object. The returned object should be a new instance that represents the transformed data according to the mapping logic defined in the implementation of this method.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    map(source: TSource): TDestination;
-}
-
 /**
  * @description Contratto per i Mapper, che definisce i metodi per convertire tra entità e Data Transfer Object (DTO).
  *
@@ -5332,94 +4253,6 @@ interface IRepository<T> {
     delete(entity: T, ctx: UserContext, signal: Optional<AbortSignal>): Promise<ResultType<void>>;
 }
 
-/**
- * @description IAuthService defines the contract for authentication services.
- * It provides methods to check if a user is authenticated and to retrieve the user's claims.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface IBaseAuthService {
-    /**
-     * Checks if the user is authenticated.
-     * @returns A promise that resolves to true if the user is authenticated, false otherwise.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    isAuthenticated(): Promise<boolean>;
-    /**
-     * Retrieves the user's claims.
-     * @returns A promise that resolves to the user's claims, or null if not authenticated.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    getUser(): Promise<ResultType<Maybe<AuthClaims>>>;
-    /**
-     * Authenticates a user based on a token.
-     * @param token The token to authenticate the user.
-     * @returns A promise that resolves to the user's claims, or null if not authenticated.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    authenticate(token: string): Promise<ResultType<AuthClaims>>;
-}
-/**
- * @description IAuthService defines the contract for authentication services.
- * It provides methods to check if a user is authenticated and to retrieve the user's claims.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IAuthService {
-    /**
-     * Signs in a user by the specified provider.
-     * @param provider The provider to use for signing in the user.
-     * @returns A promise that resolves to the URL for the specified provider.
-     */
-    signInWithProvider(provider: Provider): Promise<ResultType<{
-        url: string;
-    }>>;
-    /**
-     * @description Gets the current session of the user.
-     * @returns A promise that resolves to the current session of the user.
-     */
-    getSession(): Promise<ResultType<Maybe<Session>>>;
-    /**
-     * @description Signs out the user.
-     * @returns A promise that resolves when the user is signed out.
-     */
-    signOut(): Promise<ResultType<void>>;
-    /**
-     * @description Exchanges the code for a session.
-     * @param code the code to exchange for a session
-     * @returns A promise that resolves to the session wit
-     */
-    exchangeCodeForSession(code: string): Promise<ResultType<Optional<Session>>>;
-}
-/**
- * @description An extended version of the IAuthService interface that includes additional methods for managing user sessions.
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-interface IExtendendAuthService extends IBaseAuthService, IAuthService {
-}
-
 /**
  * @description The IConcurrencyService interface provides a contract for executing multiple asynchronous tasks in parallel while strictly controlling the maximum number of concurrent executions. This is crucial for protecting system resources (CPU, RAM) and avoiding event loop blocking during massive batch operations (e.g., processing large CSV files, bulk database inserts).
 
@@ -5494,43 +4327,6 @@ interface IServiceResilience {
     execute<T>(action: () => Promise<T>, signal: Optional<AbortSignal>): Promise<T>;
 }
 
-/**
- * @description Interface for a validation service that provides methods to check for the existence of validation schemas and to validate data against those schemas. The IValidatorService interface defines two methods: hasSchema, which checks if a validation schema exists for a given key, and validate, which validates data against a specified schema key and returns a ResultType indicating the success or failure of the validation process. This interface can be implemented by various validation services that utilize different schema validation libraries or custom validation logic to ensure that incoming data meets the required criteria before being processed further in the application.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IValidatorService {
-    /**
-     * @description Validates the provided data against the validation schema associated with the specified key. This method performs the actual validation logic, checking if the data conforms to the rules defined in the corresponding schema. It returns a ResultType indicating whether the validation was successful or if it failed, along with any relevant error information if the validation did not pass.
-     * @param key The key representing the type of data or request for which the validation is being performed. This key is used to identify the appropriate validation schema to apply to the data.
-     * @param data The data to be validated against the schema. This can be any type of data that needs to be checked for conformity with the validation rules defined in the schema.
-     * @returns A ResultType indicating the outcome of the validation. If the validation is successful, it returns a ResultType with a value of true; if the validation fails, it returns a ResultType with a value of false and includes error information.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
-    /**
-     * @description Adds a new validation schema to the service's registry, associating it with the specified key. This method allows for dynamically registering validation schemas that can be used later for validating incoming data. The schema must conform to the expected structure defined by the validation library being used (e.g., Zod schemas). By adding schemas to the service, it enables the application to perform validation checks against those schemas when processing requests or data that require validation.
-     * @param key The key representing the type of data or request for which the validation schema is being added. This key is used to identify the schema when performing validation checks.
-     * @param schema The validation schema to be added, which defines the rules and structure that incoming data must conform to in order to pass validation. The specific type of the schema will depend on the validation library being used (e.g., ZodType for Zod schemas).
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    addSchema(key: string, schema: unknown): void;
-}
-
 /**
  * Interfaccia che definisce il contratto per una specifica di dominio.
  * Una specifica permette di verificare se un oggetto (candidato)
@@ -5929,34 +4725,6 @@ declare const StorageHelper: Readonly<{
     }) => Optional<IStorage>;
 }>;
 
-/**
- * @description The SupabaseAuthService class is responsible for handling authentication-related operations using a SupabaseClient instance. It implements the IAuthService interface, providing methods to check if a user is authenticated and to retrieve authentication claims from a given token. The authenticate method interacts with the Supabase authentication API to fetch user information based on the provided token, while the isAuthenticated method checks if there is an active session. The class also includes error handling to create standardized authentication errors when necessary.
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-declare class SupabaseAuthService implements IBaseAuthService, IAuthService {
-    private readonly _supabase;
-    private readonly _mapper;
-    private readonly _sessionMapper;
-    private readonly _opts;
-    constructor(_supabase: SupabaseClient, _mapper: IBaseMapper<User, AuthClaims>, _sessionMapper: IBaseMapper<Session$1, Session>, _opts: {
-        redirectTo: Optional<string>;
-    });
-    authenticate(token: string): Promise<ResultType<AuthClaims>>;
-    isAuthenticated(): Promise<boolean>;
-    exchangeCodeForSession(code: string): Promise<ResultType<Optional<Session>>>;
-    signInWithProvider(provider: Provider$1): Promise<ResultType<{
-        url: string;
-    }>>;
-    getSession(): Promise<ResultType<Maybe<Session>>>;
-    getUser(): Promise<ResultType<Maybe<AuthClaims>>>;
-    signOut(): Promise<ResultType<void>>;
-    getSessionToken(): Promise<ResultType<Optional<string>>>;
-}
-
 /**
  * @description The InMemoryCache class provides an implementation of the ICache interface using an in-memory Map to store cached values. This class allows for storing, retrieving, and managing cached values in memory, supporting features such as time-to-live (TTL) for cache entries and atomic operations for setting values only if they do not already exist. The InMemoryCache class is a simple and efficient caching solution for scenarios where a lightweight, in-memory cache is sufficient, such as during development or for caching non-critical data that does not require persistence across application restarts.
 
@@ -6014,94 +4782,4 @@ declare class CacheKeyBuilder implements ICacheKeyBuilder {
     buildUserScopedKey(key: string): string;
 }
 
-declare class AxiosHttpClient implements IHttpClient {
-    private readonly _client;
-    constructor(_client: AxiosInstance);
-    private executInAsync;
-    get<TResponse = unknown>(url: string, options?: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    post<TResponse = unknown, TBody = unknown>(url: string, body?: Optional<TBody>, options?: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    put<TResponse = unknown, TBody = unknown>(url: string, body?: Optional<TBody>, options?: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    patch<TResponse = unknown, TBody = unknown>(url: string, body?: Optional<TBody>, options?: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    delete<TResponse = unknown>(url: string, options?: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
-    private buildConfig;
-    private handleResponse;
-    private handleError;
-}
-
-/**
- * @description SupabaseClaimsMapper is responsible for mapping authentication claims (AuthClaims) to an Identity object. This mapper takes the claims extracted from a token (such as a JWT) and transforms them into a structured Identity that can be used throughout the application for authentication and authorization purposes. The mapping includes parsing the user ID and tenant ID from the claims, as well as extracting roles and permissions.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare class SupabaseClaimsMapper implements IBaseMapper<User, AuthClaims> {
-    map(user: User): AuthClaims;
-}
-
-declare class SupabaseSessionMapper implements IBaseMapper<Session$1, Session> {
-    private readonly _claimsMapper;
-    constructor(_claimsMapper: IBaseMapper<User, AuthClaims>);
-    map(source: Session$1): Session;
-}
-
-/**
- * @description Utility functions for creating Zod schemas for commands and queries.
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-declare const ZodUtils: Readonly<{
-    /**
-     * @description Creates a Zod schema for a command by extending the base command schema with additional properties.
-     * @param intent - The intent of the command.
-     * @param additionalSchema - An object representing additional properties to be added to the command schema.
-     * @returns A Zod schema for the command.
-     */
-    createCommandSchema: (intent: string, additionalSchema: z.ZodRawShape) => z.ZodObject<{
-        [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }, z.core.$strict>;
-    /**
-     * @description Creates a Zod schema for a query by extending the base query schema with additional properties.
-     * @param intent - The intent of the query.
-     * @param additionalSchema - An object representing additional properties to be added to the query schema.
-     * @returns A Zod schema for the query.
-     */
-    createQuerySchema: (intent: string, additionalSchema: z.ZodRawShape) => z.ZodObject<{
-        [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
-    }, z.core.$strict>;
-}>;
-
-/**
- * @description Implementation of the IValidatorService interface using Zod schemas for validation. This service maintains a registry of Zod schemas identified by unique keys and provides methods to check for the existence of a schema and to validate data against a specified schema. The validate method returns a ResultType indicating success or failure, with detailed error information in case of validation failure, including formatted error messages from Zod.
-
- *
- * @author Xeno
- * @version 1.0.0
- * @since 2025-09-30
- * @link https://github.com/xeno-js/xeno-js
- */
-declare class ZodValidatorService implements IValidatorService {
-    private readonly _cache;
-    private readonly _logger;
-    /**
-     * @description Constructs a new instance of the ZodValidatorService class, which takes an ICache instance as a parameter. This cache is used to store and manage the validation schemas that will be applied to incoming data. The constructor initializes the service with the provided cache, allowing it to perform validation checks based on the cached schemas when the validate method is called.
-     *
-     * @param _cache An instance of ICache used to store and retrieve Zod schemas. This cache is essential for the operation of the validator service, as it allows it to look up and apply the correct schema for validating incoming data.
-     * @param _logger An instance of ILogger used to log warning when schema was not found.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    constructor(_cache: Map<string, ZodType> | undefined, _logger: ILogger);
-    private static formatIssue;
-    addSchema(key: string, schema: ZodType): void;
-    validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
-}
-
-export { AbortSignalHelper, type AbstractConstructor, AggregateRoot, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosHttpClient, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, type Constructor, type CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, type Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, type ExtendedRequest, type Factory, GUEST, Guards, type Guid, GuidHelper, type HttpBaseRequest, type HttpClientConfig, type HttpHeaders, HttpHelper, type HttpMethod, type HttpOptions, type HttpQueryValue, type HttpRequest, type HttpResponse, type HttpResponseType, type IAuthService, type IBaseAccessor, type IBaseAuthService, type IBaseMapper, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IDomainEvent, type IEntity, type IExtendendAuthService, type IFactory, type IGateKeeper, type IHandler, type IHttpClient, type IIdempotencyStore, type IIdentityAccessor, type ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValidatorService, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, type KeysOfType, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, type Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, type Nullable, type Optional, type Override, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type Provider, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type RequireKeys, type Resolver, type ResponseDto, Result, type ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type Session, type SetupAction, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, SupabaseAuthService, SupabaseClaimsMapper, SupabaseSessionMapper, TOKENS, type TracingContext, UniqueId, type UserContext, ValueObject, ZodUtils, ZodValidatorService };
+export { AbortSignalHelper, AggregateRoot, type ApiResponseDto, type AuthConfig, type AuthPolicy, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, ExtendedRequest, Factory, GUEST, Guards, Guid, GuidHelper, HttpBaseRequest, type HttpClientConfig, HttpHeaders, HttpHelper, type IBaseAccessor, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IDomainEvent, type IEntity, type IFactory, type IGateKeeper, type IHandler, type IIdempotencyStore, type IIdentityAccessor, ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, Optional, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type ResponseDto, ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, TOKENS, type TracingContext, UniqueId, UserContext, ValueObject };