@xeno-js/shared 0.1.0

package/dist/domain/contracts/cache/icache.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icache.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/cache/icache.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;GAOG;AAEH;;;;;;;;KAQK;AACL,MAAM,WAAW,MAAM;IACrB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAEzC;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnE;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE9E;;;;;;;;;OASG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAElC;;;;;;;;OAQG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/domain/contracts/cache/icache.contracts.js

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

package/dist/domain/contracts/cache/icache.contracts.js.map

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

package/dist/domain/contracts/cache/ikey-builder.contracts.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @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
+ */
+export interface ICacheKeyBuilder {
+    /**
+     * @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
+     */
+    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.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    buildUserScopedKey(key: string): string;
+}
+//# sourceMappingURL=ikey-builder.contracts.d.ts.map

package/dist/domain/contracts/cache/ikey-builder.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ikey-builder.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/cache/ikey-builder.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IAEvC;;;;;;;;;OASG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACxC"}

package/dist/domain/contracts/cache/ikey-builder.contracts.js

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

package/dist/domain/contracts/cache/ikey-builder.contracts.js.map

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

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

@@ -0,0 +1,3 @@
+export type * from './icache.contracts';
+export type * from './ikey-builder.contracts';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/domain/contracts/configuration/iconfiguration.contracts.d.ts

@@ -0,0 +1,61 @@
+import type { Optional } from '../../../shared';
+/**
+ * @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
+ */
+export interface IConfigurationService {
+    /**
+     * 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
+     */
+    get(key: string, defaultValue?: string): Optional<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
+     */
+    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
+     */
+    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
+     */
+    getOrThrow(key: string): string;
+}
+//# sourceMappingURL=iconfiguration.contracts.d.ts.map

package/dist/domain/contracts/configuration/iconfiguration.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconfiguration.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/configuration/iconfiguration.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEzD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE/D;;;;;;;;;;OAUG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAElE;;;;;;;;;;OAUG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAChC"}

package/dist/domain/contracts/configuration/iconfiguration.contracts.js

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

package/dist/domain/contracts/configuration/iconfiguration.contracts.js.map

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity-context.types.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/identity-context.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;;KAQK;AAEL;;;;;;;;KAQK;AACL,MAAM,WAAW,QAAQ;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAEhC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IAE/B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IAEjC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAElC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACzC"}

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

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

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

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

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

@@ -0,0 +1,6 @@
+export type * from './identity-context.types';
+export type * from './messaging-context.types';
+export type * from './network-context.types';
+export type * from './request-context.types';
+export type * from './tracing-context.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/context/context_types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,0BAA0B,CAAA;AAC7C,mBAAmB,2BAA2B,CAAA;AAC9C,mBAAmB,yBAAyB,CAAA;AAC5C,mBAAmB,yBAAyB,CAAA;AAC5C,mBAAmB,yBAAyB,CAAA"}

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

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

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

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

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

@@ -0,0 +1,70 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,82 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,48 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,54 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

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