@xeno-js/shared 0.1.5 → 0.1.7

package/dist/index.d.ts

@@ -785,25 +785,14 @@ type Permission = (typeof PERMISSIONS)[keyof typeof PERMISSIONS];
  * @description This file defines the tokens used for dependency injection in the application.
  * Tokens are unique identifiers that are used to register and resolve dependencies in the container.
  * They can be symbols, strings, or classes, but using symbols is a common practice to avoid naming collisions.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
 declare const TOKENS: Readonly<{
-    readonly ALLOW_ORIGIN: "ALLOW_ORIGIN";
-    readonly ALLOW_METHOD: "ALLOW_METHOD";
-    /** @description Token used to register and resolve the AuthorizationPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly AUTHORIZATION_PIPELINE: "AUTHORIZATION_PIPELINE";
-    /** @description Token used to register and resolve the AuthService instance in the dependency injection container.
+    /** @description Token used to register and resolve the Extendend AuthService instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
@@ -811,15 +800,14 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly AUTH_SERVICE: "AUTH_SERVICE";
-    readonly BASE_AUTH_SERVICE: "BASE_AUTH_SERVICE";
-    /** @description Token used to register and resolve the BearerTokenExtractor instance in the dependency injection container.
+    /** @description Token used to register and resolve the BaseAuthService instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly BEARER_TOKEN_EXTRACTOR: "BEARER_TOKEN_EXTRACTOR";
+    readonly BASE_AUTH_SERVICE: "BASE_AUTH_SERVICE";
     /** @description Token used to register and resolve the InMemoryCache instance in the dependency injection container.
      *
      * @author Xeno
@@ -836,14 +824,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly CACHE_KEY_BUILDER: "CACHE_KEY_BUILDER";
-    /** @description Token used to register and resolve the ClaimsIdentityMapper instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly CLAIMS_IDENTITY_MAPPER: "CLAIMS_IDENTITY_MAPPER";
     /** @description Token used to register and resolve command pipeline behaviors in the dependency injection container.
      *
      * @author Xeno
@@ -852,22 +832,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly COMMAND_PIPELINES_BEHAVIOR: "COMMAND_PIPELINES_BEHAVIOR";
-    /** @description Token used to register and resolve the CompositePipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly COMPOSITE_PIPELINE: "COMPOSITE_PIPELINE";
-    /** @description Token used to register and resolve the ConcurrencyRetryPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly CONCURRENCY_RETRY_PIPELINE: "CONCURRENCY_RETRY_PIPELINE";
     /** @description Token used to register and resolve the ConcurrencyService instance in the dependency injection container.
      *
      * @author Xeno
@@ -884,14 +848,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly CONFIGURATION_SERVICE: "CONFIGURATION_SERVICE";
-    /** @description Token used to register and resolve the ConsoleLogger instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly CONSOLE_LOGGER: "CONSOLE_LOGGER";
     /** @description Token used to register and resolve the ContextAccessor instance in the dependency injection container.
      *
      * @author Xeno
@@ -900,46 +856,30 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly CONTEXT_ACCESSOR: "CONTEXT_ACCESSOR";
-    /** @description Token used to register and resolve the DbContext instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly DB_CONTEXT: "DB_CONTEXT";
-    /** @description Token used to register and resolve the ExceptionPipeline instance in the dependency injection container.
+    /** @description Token used to register and resolve the CryptoService instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly EXCEPTION_PIPELINE: "EXCEPTION_PIPELINE";
-    /** @description Token used to register and resolve the GateKeeper instance in the dependency injection container.
+    readonly CRYPTO_SERVICE: "CRYPTO_SERVICE";
+    /** @description Token used to register and resolve the CsrfTokenService instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly GATE_KEEPER: "GATE_KEEPER";
-    /** @description Token used to register and resolve the IdempotencyPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly IDEMPOTENCY_PIPELINE: "IDEMPOTENCY_PIPELINE";
-    /** @description Token used to register and resolve the IdempotencyStore instance in the dependency injection container.
+    readonly CSRF_TOKEN_SERVICE: "CSRF_TOKEN_SERVICE";
+    /** @description Token used to register and resolve the DbContext instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly IDEMPOTENCY_STORE: "IDEMPOTENCY_STORE";
+    readonly DB_CONTEXT: "DB_CONTEXT";
     /** @description Token used to register and resolve the IdentityAccessor instance in the dependency injection container.
      *
      * @author Xeno
@@ -956,22 +896,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly LOGGER: "LOGGER";
-    /** @description Token used to register and resolve the LoggerConfig instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly LOGGER_CONFIG: "LOGGER_CONFIG";
-    /** @description Token used to register and resolve the LoggingPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly LOGGING_PIPELINE: "LOGGING_PIPELINE";
     /** @description Token used to register and resolve the Mediator instance in the dependency injection container.
      *
      * @author Xeno
@@ -980,46 +904,14 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly MEDIATOR: "MEDIATOR";
-    /** @description Token used to register and resolve the PerformancePipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly PERFORMANCE_PIPELINE: "PERFORMANCE_PIPELINE";
-    /** @description Token used to register and resolve the PermissionAuthorizationPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly PERMISSION_AUTHORIZATION_PIPELINE: "PERMISSION_AUTHORIZATION_PIPELINE";
-    /** @description Token used to register and resolve the PinoLogger instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly PINO_LOGGER: "PINO_LOGGER";
-    /** @description Token used to register and resolve the PolicyRegistry instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly POLICY_REGISTRY: "POLICY_REGISTRY";
-    /** @description Token used to register and resolve the QueryCachingPipeline instance in the dependency injection container.
+    /** @description Token used to register and resolve the NetworkContextFactory in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly QUERY_CACHING_PIPELINE: "QUERY_CACHING_PIPELINE";
+    readonly NETWORK_CONTEXT_ACCESSOR: "NETWORK_CONTEXT_ACCESSOR";
     /** @description Token used to register and resolve query pipeline behaviors in the dependency injection container.
      *
      * @author Xeno
@@ -1036,7 +928,7 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly REQUEST_CONTEXT: "REQUEST_CONTEXT";
-    /** @description Token used to register and resolve the RequestContextMiddleware in the dependency injection container.
+    /** @description Token used to register and resolve the CompositeMiddleware in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
@@ -1044,14 +936,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly MIDDLEWARE: "MIDDLEWARE";
-    readonly AUTH_MIDDLEWARE: "AUTH_MIDDLEWARE";
-    readonly CSRF_MIDDLEWARE: "CSRF_MIDDLEWARE";
-    readonly ALLOW_ORIGIN_MIDDLEWARE: "ALLOW_ORIGIN_MIDDLEWARE";
-    readonly CORS_MIDDLEWARE: "CORS_MIDDLEWARE";
-    readonly METHOD_CHECK_MIDDLEWARE: "METHOD_CHECK_MIDDLEWARE";
-    readonly OPTIONS_MIDDLEWARE: "OPTIONS_MIDDLEWARE";
-    readonly REQUEST_CONTEXT_MIDDLEWARE: "REQUEST_CONTEXT_MIDDLEWARE";
-    readonly RATE_LIMITER_MIDDLEWARE: "RATE_LIMITER_MIDDLEWARE";
     /** @description Token used to register and resolve the IServiceResilience instance in the dependency injection container.
      *
      * @author Xeno
@@ -1060,14 +944,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly RESILIENCE_CLIENT: "RESILIENCE_CLIENT";
-    /** @description Token used to register and resolve the RoleAuthorizationPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly ROLE_AUTHORIZATION_PIPELINE: "ROLE_AUTHORIZATION_PIPELINE";
     /** @description Token used to register and resolve the SchemaValidationStrategy instance in the dependency injection container.
      *
      * @author Xeno
@@ -1076,14 +952,6 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly SCHEMA_VALIDATION_STRATEGY: "SCHEMA_VALIDATION_STRATEGY";
-    /** @description Token used to register and resolve the SentryLogger instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly SENTRY_LOGGER: "SENTRY_LOGGER";
     /** @description Token used to register and resolve the ServiceContainer instance in the dependency injection container.
      *
      * @author Xeno
@@ -1100,22 +968,14 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly SERVICE_EXTRACTOR: "SERVICE_EXTRACTOR";
-    /** @description Token used to register and resolve the ServiceScopeFactory instance in the dependency injection container.
+    /** @description Token used to register and resolve the ServiceScopeAccessor in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly SERVICE_SCOPE_FACTORY: "SERVICE_SCOPE_FACTORY";
-    /** @description Token used to register and resolve the TenantAuthorizationPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly TENANT_AUTHORIZATION_PIPELINE: "TENANT_AUTHORIZATION_PIPELINE";
+    readonly SERVICE_SCOPE_ACCESSOR: "SERVICE_SCOPE_ACCESSOR";
     /** @description Token used to register and resolve the UnitOfWork instance in the dependency injection container.
      *
      * @author Xeno
@@ -1124,34 +984,14 @@ declare const TOKENS: Readonly<{
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly UNIT_OF_WORK: "UNIT_OF_WORK";
-    /** @description Token used to register and resolve the UserAuthorizationPipeline instance in the dependency injection container.
+    /** @description Token used to register and resolve the ValidatorService instance in the dependency injection container.
      *
      * @author Xeno
      * @version 1.0.0
      * @since 2025-09-30
      * @link https://github.com/xeno-js/xeno-js
      */
-    readonly USER_AUTHORIZATION_PIPELINE: "USER_AUTHORIZATION_PIPELINE";
-    /** @description Token used to register and resolve the ValidationPipeline instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly VALIDATION_PIPELINE: "VALIDATION_PIPELINE";
-    /** @description Token used to register and resolve the ZodValidator instance in the dependency injection container.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    readonly ZOD_VALIDATOR: "ZOD_VALIDATOR";
-    readonly SERVICE_SCOPE_ACCESSOR: "SERVICE_SCOPE_ACCESSOR";
-    readonly NETWORK_CONTEXT_ACCESSOR: "NETWORK_CONTEXT_ACCESSOR";
-    readonly USER_CONTEXT_FACTORY: "USER_CONTEXT_FACTORY";
-    readonly TRANSACTION_STATE: "TRANSACTION_STATE";
+    readonly VALIDATOR_SERVICE: "VALIDATOR_SERVICE";
 }>;
 
 /**
@@ -1546,12 +1386,25 @@ interface HttpResponse<TData = unknown> {
      */
     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>;
-    sameSite?: Optional<'lax' | 'strict' | 'none' | boolean>;
-    secure?: boolean;
+    /** @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>;
 }
 
 /**
@@ -2720,6 +2573,12 @@ declare const GuidHelper: Readonly<{
    * @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.
@@ -3032,17 +2891,47 @@ declare const StringHelper: Readonly<{
     readonly getSingleValueWithSplit: (value: string, separator: string) => string;
 }>;
 
+/**
+ * @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>;
-    storageOpts: {
-        type: Optional<'local' | 'session' | 'memory' | 'cookie'>;
-        cookieOpts: Optional<CookieOptions>;
-        storage: Optional<IStorage>;
-    };
+    /**
+     * @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.
  *
@@ -3686,6 +3575,15 @@ interface NetworkContext {
      * @link https://github.com/xeno-js/xeno-js
      */
     readonly csrf: Optional<string>;
+    /**
+     * @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
+     */
+    readonly csrfCookie: Optional<string>;
     /**
      * @description The transport used for the request, which can be used for logging, monitoring, or applying specific middleware logic.
      *
@@ -4969,6 +4867,29 @@ interface ILoggerClient {
     track<T>(level: LogLevel, message: string, context: Optional<T>, error: Optional<unknown>): void;
 }
 
+/**
+ * @description LoggerContext defines the structure for logging-related information used in logging and monitoring. It includes identity, network, and tracing information, as well as optional messaging context for distributed tracing.
+ */
+interface LoggerContext {
+    identity: {
+        userId: Optional<string>;
+        tenantId: Optional<string>;
+    };
+    network: {
+        requestId: Optional<string>;
+        path: Optional<string>;
+        origin: Optional<string>;
+        clientIp: Optional<string>;
+    };
+    tracing: {
+        correlationId: Optional<string>;
+        spanId: Optional<string>;
+        startTime: Optional<number>;
+        parentSpanId: Optional<string>;
+    };
+    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.
@@ -5260,18 +5181,16 @@ interface IRepository<T> {
 /**
  * @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
-   */
+ *
+ * @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
@@ -5280,14 +5199,19 @@ interface IBaseAuthService {
      */
     isAuthenticated(): Promise<boolean>;
     /**
-     * Restituisce l'utente attualmente autenticato.
+     * 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
@@ -5308,22 +5232,38 @@ interface IBaseAuthService {
    */
 interface IAuthService {
     /**
-     * Avvia il flusso di autenticazione OAuth con un provider esterno (es. Google).
+     * 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;
     }>>;
     /**
-     * Restituisce la sessione corrente attiva salvata nel client Supabase.
+     * @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>>>;
     /**
-     * Esegue il logout dell'utente e pulisce la sessione locale.
+     * @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>>>;
 }
-interface IExtendendService extends IBaseAuthService, IAuthService {
+/**
+ * @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 {
 }
 
 /**
@@ -5815,12 +5755,26 @@ declare abstract class ValueObject<T extends object> implements IValueObject<T>
     toString(): string;
 }
 
+/**
+ * @description Base class for all commands.
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
 declare abstract class Command<TResponse = unknown> implements ICommand<TResponse> {
     readonly intent: string;
     readonly type: RequestType;
     constructor(intent: string);
 }
 
+/**
+ * @description Base class for all queries.
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
 declare abstract class Query<TResponse = unknown> implements IQuery<TResponse> {
     readonly intent: string;
     readonly cacheOptions: ICacheableOptions;
@@ -5830,13 +5784,12 @@ declare abstract class Query<TResponse = unknown> implements IQuery<TResponse> {
 
 /**
  * @description Concrete implementation of the ILogger interface that serves as a central logging service within the application. This class is designed to broadcast log messages to multiple logging clients (implementations of ILoggerClient) that are injected via the constructor. The BaseLogger class provides methods for logging messages at different levels (info, warn, debug, error) and ensures that only messages that meet or exceed the specified minimum log level are forwarded to the registered logging clients. This design allows for flexibility in logging, enabling the use of various logging providers (e.g., Sentry, Pino) without coupling the application code to specific logging frameworks.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
 declare class BaseLogger implements ILogger {
     private readonly _requestContext;
     private readonly _minLevel;
@@ -5846,7 +5799,6 @@ declare class BaseLogger implements ILogger {
      * @param _requestContext The request context that provides contextual information for log messages, such as request-specific data or metadata.
      * @param config The minimum log level for this logger instance. Only messages with a log level equal to or higher than this level will be processed and forwarded to the logging clients.
      * @param loggers An array of ILoggerClient instances that will receive log messages from this logger. Each ILoggerClient represents a different logging provider or destination (e.g., console, file, external service).
-    
      *
      * @author Xeno
      * @version 1.0.0
@@ -5864,7 +5816,6 @@ declare class BaseLogger implements ILogger {
      * @param message The log message.
      * @param context Optional context information to include with the log message.
      * @param error Optional error object to include with the log message.
-    
      *
      * @author Xeno
      * @version 1.0.0
@@ -5874,6 +5825,18 @@ declare class BaseLogger implements ILogger {
     private broadcast;
 }
 
+/**
+ * @description LoggerUtils provides utility functions for working with LoggerContext objects.
+ */
+declare const LoggerUtils: Readonly<{
+    /**
+     * @description toSafeContext converts a RequestContext object to a LoggerContext object, ensuring that only the necessary fields are included.
+     * @param ctx The RequestContext object to convert.
+     * @returns The converted LoggerContext object.
+     */
+    readonly toSafeContext: (ctx: Optional<RequestContext>) => LoggerContext;
+}>;
+
 declare const StorageHelper: Readonly<{
     readonly create: (opts: {
         type: Optional<"local" | "session" | "memory" | "cookie">;
@@ -6068,4 +6031,4 @@ declare class ZodValidatorService implements IValidatorService {
     validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
 }
 
-export { AbortSignalHelper, type AbstractConstructor, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, 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 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 IEntity, type IExtendendService, 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, 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, type AbstractConstructor, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, 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 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 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 };