@xeno-js/shared 0.1.0 → 0.1.1

package/dist/domain/contracts/context/context_types/messaging-context.types.d.ts

@@ -1,70 +0,0 @@
-import type { Optional } from '../../../../shared';
-/**
- * @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
- */
-export 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
-     */
-    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
-     */
-    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
- */
-export 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
-     */
-    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
-     */
-    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
-     */
-    readonly sequence: Optional<MessageSequence>;
-}
-//# sourceMappingURL=messaging-context.types.d.ts.map

package/dist/domain/contracts/context/context_types/messaging-context.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"messaging-context.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/messaging-context.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACxC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;CAC7C"}

package/dist/domain/contracts/context/context_types/messaging-context.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=messaging-context.types.js.map

package/dist/domain/contracts/context/context_types/messaging-context.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"messaging-context.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/messaging-context.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/context/context_types/network-context.types.d.ts

@@ -1,82 +0,0 @@
-import type { Guid, Optional } from '../../../../shared';
-/**
- * @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
- */
-export 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
-     */
-    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 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 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 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
-     */
-    readonly path: Optional<string>;
-    /**
-     * @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
-     */
-    readonly csrf: Optional<string>;
-    /**
-     * @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
-     */
-    readonly transport: Optional<{
-        req: unknown;
-        res: unknown;
-    }>;
-    /**
-     * @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
-     */
-    readonly origin: Optional<string>;
-}
-//# sourceMappingURL=network-context.types.d.ts.map

package/dist/domain/contracts/context/context_types/network-context.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-context.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/network-context.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAE5D;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAClC"}

package/dist/domain/contracts/context/context_types/network-context.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=network-context.types.js.map

package/dist/domain/contracts/context/context_types/network-context.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"network-context.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/network-context.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/context/context_types/request-context.types.d.ts

@@ -1,48 +0,0 @@
-import type { Maybe } from '../../../../shared';
-import type { Identity } from './identity-context.types';
-import type { MessagingContext } from './messaging-context.types';
-import type { NetworkContext } from './network-context.types';
-import type { TracingContext } from './tracing-context.types';
-/**
- * @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
- */
-export 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
-     */
-    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
-     */
-    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
-     */
-    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
-     */
-    readonly messaging?: Maybe<MessagingContext>;
-}
-//# sourceMappingURL=request-context.types.d.ts.map

package/dist/domain/contracts/context/context_types/request-context.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request-context.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/request-context.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAA;CAC7C"}

package/dist/domain/contracts/context/context_types/request-context.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=request-context.types.js.map

package/dist/domain/contracts/context/context_types/request-context.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"request-context.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/request-context.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/context/context_types/tracing-context.types.d.ts

@@ -1,54 +0,0 @@
-import type { Guid, Optional } from '../../../../shared';
-/**
- * @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
-   */
-export 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.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    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
-     */
-    readonly referer?: Optional<string>;
-}
-//# sourceMappingURL=tracing-context.types.d.ts.map

package/dist/domain/contracts/context/context_types/tracing-context.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing-context.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/tracing-context.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;;KAQK;AACL,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CACpC"}

package/dist/domain/contracts/context/context_types/tracing-context.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=tracing-context.types.js.map

package/dist/domain/contracts/context/context_types/tracing-context.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"tracing-context.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/tracing-context.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/context/index.d.ts

@@ -1,3 +0,0 @@
-export type * from './context_types/index';
-export type * from './irequest-context.contracts';
-//# sourceMappingURL=index.d.ts.map

package/dist/domain/contracts/context/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/context/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,8BAA8B,CAAA"}

package/dist/domain/contracts/context/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/domain/contracts/context/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/contracts/context/index.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/context/irequest-context.contracts.d.ts

@@ -1,68 +0,0 @@
-import type { Optional } from '../../../shared';
-import type { Identity, NetworkContext } from './context_types';
-export 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
- */
-export interface IIdentityAccessor {
-    /**
-     * 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
-     */
-    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
- */
-export interface IContextAccessor<TCtx> {
-    /**
-     * 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
-     */
-    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
- */
-export interface INetworkContextAccessor {
-    /**
-     * 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
-     */
-    getNetworkContext(): Optional<NetworkContext>;
-}
-//# sourceMappingURL=irequest-context.contracts.d.ts.map

package/dist/domain/contracts/context/irequest-context.contracts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"irequest-context.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/context/irequest-context.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE/D,MAAM,WAAW,aAAa,CAAC,IAAI,CACjC,SAAQ,gBAAgB,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,uBAAuB;CAAG;AAE/E;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB,CAAC,IAAI;IACpC;;;;;;;;OAQG;IACH,UAAU,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,iBAAiB,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAA;CAC9C"}

package/dist/domain/contracts/context/irequest-context.contracts.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=irequest-context.contracts.js.map

package/dist/domain/contracts/context/irequest-context.contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"irequest-context.contracts.js","sourceRoot":"","sources":["../../../../src/domain/contracts/context/irequest-context.contracts.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/controllers/icontroller.contracts.d.ts

@@ -1,25 +0,0 @@
-import type { ResponseDto } from '../../../shared';
-/**
- * @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
-   */
-export interface IController<TRequest = unknown, TResponse = unknown> {
-    /**
-     * Handles an incoming request and returns a response.
-     * @param request - The incoming request object.
-     * @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
-     */
-    handle(request: TRequest): Promise<ResponseDto<TResponse>>;
-}
-//# sourceMappingURL=icontroller.contracts.d.ts.map

package/dist/domain/contracts/controllers/icontroller.contracts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"icontroller.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/controllers/icontroller.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;;;;;;;KAQK;AACL,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO;IAClE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAA;CAC3D"}

package/dist/domain/contracts/controllers/icontroller.contracts.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=icontroller.contracts.js.map

package/dist/domain/contracts/controllers/icontroller.contracts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"icontroller.contracts.js","sourceRoot":"","sources":["../../../../src/domain/contracts/controllers/icontroller.contracts.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/controllers/index.d.ts

@@ -1,2 +0,0 @@
-export type * from './icontroller.contracts';
-//# sourceMappingURL=index.d.ts.map

package/dist/domain/contracts/controllers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/controllers/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,yBAAyB,CAAA"}

package/dist/domain/contracts/controllers/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/domain/contracts/controllers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domain/contracts/controllers/index.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/cqrs/cqrs_types/icommand.types.d.ts

@@ -1,30 +0,0 @@
-import type { IRequest } from './irequest.types';
-/**
- * @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
-   */
-export 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
-     */
-    readonly $type?: TResponse;
-}
-//# sourceMappingURL=icommand.types.d.ts.map

package/dist/domain/contracts/cqrs/cqrs_types/icommand.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"icommand.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/icommand.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;;;;KAQK;AAEL;;;;;;;;KAQK;AACL,MAAM,WAAW,QAAQ,CAAC,SAAS,GAAG,OAAO,CAAE,SAAQ,QAAQ,CAAC,SAAS,CAAC;IACxE;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B"}

package/dist/domain/contracts/cqrs/cqrs_types/icommand.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=icommand.types.js.map

package/dist/domain/contracts/cqrs/cqrs_types/icommand.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"icommand.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/icommand.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/cqrs/cqrs_types/index.d.ts

@@ -1,4 +0,0 @@
-export type * from './icommand.types';
-export type * from './iquery.types';
-export type * from './irequest.types';
-//# sourceMappingURL=index.d.ts.map

package/dist/domain/contracts/cqrs/cqrs_types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,kBAAkB,CAAA"}

package/dist/domain/contracts/cqrs/cqrs_types/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/domain/contracts/cqrs/cqrs_types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/index.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/cqrs/cqrs_types/iquery.types.d.ts

@@ -1,32 +0,0 @@
-import type { ICacheableOptions } from '../../../../shared';
-import type { IRequest } from './irequest.types';
-/**
- * @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
-   */
-export 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;
-}
-//# sourceMappingURL=iquery.types.d.ts.map

package/dist/domain/contracts/cqrs/cqrs_types/iquery.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"iquery.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/iquery.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD;;;;;;;;KAQK;AAEL;;;;;;;;KAQK;AACL,MAAM,WAAW,MAAM,CAAC,SAAS,GAAG,OAAO,CAAE,SAAQ,QAAQ,CAAC,SAAS,CAAC;IACtE;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAA;CACzC"}

package/dist/domain/contracts/cqrs/cqrs_types/iquery.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=iquery.types.js.map

package/dist/domain/contracts/cqrs/cqrs_types/iquery.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"iquery.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/iquery.types.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/cqrs/cqrs_types/irequest.types.d.ts

@@ -1,30 +0,0 @@
-import type { RequestType } from '../../../../shared';
-/**
- * @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
-   */
-export 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
-     */
-    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
-     */
-    readonly type: RequestType;
-}
-//# sourceMappingURL=irequest.types.d.ts.map

package/dist/domain/contracts/cqrs/cqrs_types/irequest.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"irequest.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/irequest.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;;;;;;;KAQK;AACL,MAAM,WAAW,QAAQ,CAAC,SAAS,GAAG,OAAO;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAC3B"}

package/dist/domain/contracts/cqrs/cqrs_types/irequest.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=irequest.types.js.map

package/dist/domain/contracts/cqrs/cqrs_types/irequest.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"irequest.types.js","sourceRoot":"","sources":["../../../../../src/domain/contracts/cqrs/cqrs_types/irequest.types.ts"],"names":[],"mappings":""}