@xeno-js/shared 0.1.0

package/dist/domain/contracts/datasources/iwrite-datasource.contracts.d.ts

@@ -0,0 +1,82 @@
+import type { Optional, UserContext } from '../../../shared';
+import type { IDisposable } from '../disposables';
+/**
+ * @description Interface representing a data source for performing database operations. This interface defines the contract for executing SQL queries and commands against a database, including methods for finding records based on filters and unique identifiers, as well as inserting and deleting records. The IWriteDataSource interface is designed to be implemented by classes that provide specific data access logic, allowing for separation of concerns and easier testing. It extends the IReadDataSource interface, which includes basic read operations, and adds methods for write operations such as insert and delete.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IWriteDataSource<TDto> extends IDisposable {
+    /**
+     * @description Finds entities This method takes a filter object and an optional AbortSignal for cancellation. It returns a promise that resolves to an array of entities. The implementation of this method is responsible for constructing the appropriate query based on the provided filter and handling any necessary data transformations before returning the results.
+     * @param ctx The context of the authenticated user, which may be used for authorization and auditing purposes.
+     * @param signal An optional AbortSignal to allow cancellation of the query operation.
+     * @returns A promise that resolves to an array of objects representing the rows returned by the query.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    findAll(ctx: UserContext, signal: Optional<AbortSignal>): Promise<TDto[]>;
+    /**
+     * Executes a SQL query and returns the result as an array of objects.
+     * @param id The unique identifier of the entity to find.
+     * @param ctx The context of the authenticated user, which may be used for authorization and auditing purposes.
+     * @param signal An optional AbortSignal to allow cancellation of the query operation.
+     * @returns A promise that resolves to an object representing the row returned by the query.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    findById(id: string | number, ctx: UserContext, signal: Optional<AbortSignal>): Promise<Optional<TDto>>;
+    /**
+     * @description Executes a SQL command that does not return any rows (e.g., INSERT, UPDATE, DELETE). This method takes a data transfer object (DTO) containing the data to be inserted into the database and an optional AbortSignal for cancellation. It returns a promise that resolves when the command has been executed successfully. The implementation of this method is responsible for constructing the appropriate SQL command based on the provided DTO and handling any necessary data transformations before executing the command.
+     * @param dto The data transfer object containing the data to be inserted into the database.
+     * @param signal An optional AbortSignal to allow cancellation of the insert operation.
+     * @returns A promise that resolves when the command has been executed successfully.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    insert(dto: TDto, signal: Optional<AbortSignal>): Promise<void>;
+    /**
+     * @description Executes a SQL command that does not return any rows (e.g., INSERT, UPDATE, DELETE). This method takes a data transfer object (DTO) containing the data to be deleted from the database, a user context, and an optional AbortSignal for cancellation. It returns a promise that resolves when the command has been executed successfully. The implementation of this method is responsible for constructing the appropriate SQL command based on the provided DTO and handling any necessary data transformations before executing the command.
+     * @param dto The data transfer object containing the data to be deleted from the database.
+     * @param ctx The context of the authenticated user, which may be used for authorization and auditing purposes.
+     * @param signal An optional AbortSignal to allow cancellation of the delete operation.
+     * @returns A promise that resolves when the command has been executed successfully.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    delete(dto: TDto, ctx: UserContext, signal: Optional<AbortSignal>): Promise<void>;
+    /**
+     * @description Executes a SQL command that does not return any rows (e.g., INSERT, UPDATE, DELETE). This method takes a data transfer object (DTO) containing the data to be updated in the database, a user context, and an optional AbortSignal for cancellation. It returns a promise that resolves when the command has been executed successfully. The implementation of this method is responsible for constructing the appropriate SQL command based on the provided DTO and handling any necessary data transformations before executing the command.
+     * @param dto The data transfer object containing the data to be updated in the database.
+     * @param ctx The context of the authenticated user, which may be used for authorization and auditing purposes.
+     * @param signal An optional AbortSignal to allow cancellation of the update operation.
+     * @returns A promise that resolves when the command has been executed successfully.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    update(id: string | number, dto: Partial<TDto>, ctx: UserContext, signal: Optional<AbortSignal>): Promise<void>;
+}
+//# sourceMappingURL=iwrite-datasource.contracts.d.ts.map

package/dist/domain/contracts/datasources/iwrite-datasource.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iwrite-datasource.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/datasources/iwrite-datasource.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;;;;;;;KAQK;AACL,MAAM,WAAW,gBAAgB,CAAC,IAAI,CAAE,SAAQ,WAAW;IACzD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAEzE;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAE1B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjF;;;;;;;;;;;;OAYG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,EAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAA;CACjB"}

package/dist/domain/contracts/datasources/iwrite-datasource.contracts.js

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

package/dist/domain/contracts/datasources/iwrite-datasource.contracts.js.map

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

package/dist/domain/contracts/disposables/idisposable.contracts.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file disposable.contracts.ts
+ * @description This file defines the interface for disposable resources in the application. The IDisposable interface specifies a method for disposing of resources, which is expected to be implemented by any class that adheres to this contract. This allows for consistent management of resource cleanup across different implementations.
+ */
+/**
+ * @description IDisposable defines the contract for disposable resources. It provides a method to dispose of resources, allowing for proper cleanup when they are no longer needed. This interface ensures that any class implementing it will provide a consistent way to manage the lifecycle of disposable resources.
+ * @example
+ * ```ts
+ * class MyResource implements IDisposable {
+ *     async dispose(): Promise<void> {
+ *         // Cleanup logic here
+ *     }
+ * }
+ * ```
+ */
+export interface IDisposable {
+    /**
+     * @description Disposes of the resource, releasing any held resources and performing necessary cleanup. This method should be called when the resource is no longer needed to ensure proper cleanup and avoid resource leaks.
+     * @returns A promise that resolves when the disposal process is complete.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=idisposable.contracts.d.ts.map

package/dist/domain/contracts/disposables/idisposable.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idisposable.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/disposables/idisposable.contracts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

package/dist/domain/contracts/disposables/idisposable.contracts.js

@@ -0,0 +1,6 @@
+/**
+ * @file disposable.contracts.ts
+ * @description This file defines the interface for disposable resources in the application. The IDisposable interface specifies a method for disposing of resources, which is expected to be implemented by any class that adheres to this contract. This allows for consistent management of resource cleanup across different implementations.
+ */
+export {};
+//# sourceMappingURL=idisposable.contracts.js.map

package/dist/domain/contracts/disposables/idisposable.contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idisposable.contracts.js","sourceRoot":"","sources":["../../../../src/domain/contracts/disposables/idisposable.contracts.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

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

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

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

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

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

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

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

package/dist/domain/contracts/factories/ifactory.contracts.d.ts

@@ -0,0 +1,29 @@
+import type { Factory } from '../../../shared';
+/**
+ * @description Generic factory type for creating instances of a given type `T`.
+ * The factory can be used in two ways: as a simple provider that takes no arguments, or as a parameterized creator that accepts a single input of type `TInput`.
+ *
+ * @template TInput  The type of the input parameter for the factory method.
+ * @template TOutput The type of the output produced by the factory method.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IFactory<TInput, TOutput> {
+    /**
+     * Creates an instance of `Output` using the provided `input` of type `TInput`.
+     * @param input The input data required to create the instance.
+     * @returns An instance of type `Output`.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    create: Factory<TOutput, [TInput]>;
+}
+//# sourceMappingURL=ifactory.contracts.d.ts.map

package/dist/domain/contracts/factories/ifactory.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifactory.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/factories/ifactory.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAEvC;;;;;;;;;;;;KAYK;AACL,MAAM,WAAW,QAAQ,CAAC,MAAM,EAAE,OAAO;IACvC;;;;;;;;;;OAUG;IACH,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;CACnC"}

package/dist/domain/contracts/factories/ifactory.contracts.js

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

package/dist/domain/contracts/factories/ifactory.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/gate_keepers/igate-keeper.contracts.d.ts

@@ -0,0 +1,27 @@
+import type { Optional } from '../../../shared';
+import type { Identity } from '../../contracts/context/context_types/identity-context.types';
+import type { ResultType } from '../../results/result.types';
+/**
+ * @description IGateKeeper defines the contract for gatekeeper services responsible for authorizing users based on their identity and permissions. It provides a method to check if a user has a specific permission, taking into account their roles and permissions. The authorize method checks if the user's permissions include the required permission or if they have a role that grants them access (e.g., SUPER_ADMIN or ADMIN). If the user does not have the necessary permissions, it returns false.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IGateKeeper {
+    /**
+     * Authenticates a user based on a provided token and returns their identity.
+     * @param token The authentication token to validate and extract the user's identity from.
+     * @returns A promise that resolves to the user's identity if authentication is successful, or an error if it fails.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    authenticate(token: Optional<string>): Promise<ResultType<Identity>>;
+}
+//# sourceMappingURL=igate-keeper.contracts.d.ts.map

package/dist/domain/contracts/gate_keepers/igate-keeper.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"igate-keeper.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/gate_keepers/igate-keeper.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAA;AAC5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D;;;;;;;;KAQK;AACL,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;OAUG;IACH,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;CACrE"}

package/dist/domain/contracts/gate_keepers/igate-keeper.contracts.js

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

package/dist/domain/contracts/gate_keepers/igate-keeper.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/http/iallow-origin.contracts.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=iallow-origin.contracts.d.ts.map

package/dist/domain/contracts/http/iallow-origin.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iallow-origin.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/http/iallow-origin.contracts.ts"],"names":[],"mappings":""}

package/dist/domain/contracts/http/iallow-origin.contracts.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=iallow-origin.contracts.js.map

package/dist/domain/contracts/http/iallow-origin.contracts.js.map

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

package/dist/domain/contracts/http/ihttp-client.contracts.d.ts

@@ -0,0 +1,81 @@
+import type { HttpOptions, HttpRequest, HttpResponse, Optional } from '../../../shared';
+/**
+ * @description Agnostic contract used to execute HTTP calls independently from concrete transport libraries (fetch, axios, undici, etc.).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IHttpClient {
+    /**
+     * @description Executes an HTTP GET request to the specified URL with optional request options.
+     * @param url The URL to which the GET request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    get<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP POST request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the POST request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the POST request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    post<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PUT request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PUT request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PUT request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    put<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP PATCH request to the specified URL with the provided request body and optional request options.
+     * @param url The URL to which the PATCH request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param body The request body to be sent with the PATCH request. This can be of any type, such as an object, string, or FormData, depending on the requirements of the server endpoint.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    patch<TResponse = unknown, TBody = unknown>(url: string, body: Optional<TBody>, options: Optional<Omit<HttpRequest<TBody>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+    /**
+     * @description Executes an HTTP DELETE request to the specified URL with optional request options.
+     * @param url The URL to which the DELETE request is sent. This can be an absolute or relative URL depending on the configuration of the HTTP client.
+     * @param options Optional request options that can include headers, query parameters, abort signal, and timeout settings. These options allow for customization of the HTTP request, such as adding specific headers, including query parameters in the URL, setting a timeout for the request, or providing an abort signal to cancel the request if needed.
+     * @returns A promise that resolves to an HttpResponse object containing the status code, response headers, and response data from the server. The HttpResponse object provides information about the outcome of the HTTP request, including whether it was successful (status code 2xx) or if there was an error (status code 4xx or 5xx).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    delete<TResponse = unknown>(url: string, options: Optional<Omit<HttpRequest<never>, HttpOptions>>): Promise<HttpResponse<TResponse>>;
+}
+//# sourceMappingURL=ihttp-client.contracts.d.ts.map

package/dist/domain/contracts/http/ihttp-client.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ihttp-client.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/http/ihttp-client.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEhF;;;;;;;;KAQK;AACL,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,SAAS,GAAG,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,GACvD,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,GACvD,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,GACvD,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EACxC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,EACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,GACvD,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,GAAG,OAAO,EACxB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,GACvD,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;CACpC"}

package/dist/domain/contracts/http/ihttp-client.contracts.js

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

package/dist/domain/contracts/http/ihttp-client.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/idempotency/idempotency-store.contracts.d.ts

@@ -0,0 +1,71 @@
+import type { Optional } from '../../../shared';
+/**
+ * @description Interface for an idempotency store that provides methods for acquiring locks, checking if a command has been processed, marking commands as processed with associated payloads, retrieving stored payloads, and releasing locks. This interface is designed to support idempotent command processing in a distributed system, ensuring that duplicate commands are not processed multiple times and that the results of previously processed commands can be retrieved when necessary.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IIdempotencyStore {
+    /** @description Acquires a lock for the given commandId with a specified time-to-live (TTL) in seconds. This method is used to ensure that only one instance of a command with the same commandId is processed at a time, preventing duplicate processing of the same command. If the lock is successfully acquired, it returns true; otherwise, it returns false, indicating that another instance of the command is currently being processed.
+     * @param commandId The unique identifier for the command for which the lock is being acquired. This ID is used to identify and manage locks for specific commands in the idempotency store.
+     * @param ttlSeconds The time-to-live (TTL) in seconds for the lock being acquired. This parameter specifies how long the lock should be held before it expires, allowing for automatic release of locks in case of failures or timeouts during command processing.
+     * @returns A promise that resolves to true if the lock was successfully acquired, or false if the lock is currently held by another instance of the command.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    acquireLock(commandId: string, ttlSeconds: number): Promise<boolean>;
+    /** @description Checks if a command with the given commandId has already been processed. This method is used to determine if a command has been previously executed and its result stored in the idempotency store. If the command has been processed, it returns true; otherwise, it returns false, indicating that the command has not been processed yet and can be safely executed.
+     * @param commandId The unique identifier for the command to check for processing status. This ID is used to query the idempotency store to determine if a command with the specified ID has already been processed.
+     * @returns A promise that resolves to true if the command has already been processed, or false if it has not been processed yet.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    hasBeenProcessed(commandId: string): Promise<boolean>;
+    /** @description Marks a command with the given commandId as processed and stores the associated payload in the idempotency store with a specified time-to-live (TTL) in seconds. This method is used to record the result of processing a command, allowing subsequent attempts to process the same commandId to recognize that it has already been handled and return the stored payload instead of executing the command again. The TTL parameter ensures that the stored result will expire after a certain period, allowing for eventual cleanup of old entries in the idempotency store.
+     * @param commandId The unique identifier for the command being marked as processed. This ID is used to store the processing status and associated payload in the idempotency store for future reference.
+     * @param payload The result or output associated with the processed command that should be stored in the idempotency store. This payload can be retrieved later when checking if the command has already been processed, allowing clients to obtain the result without re-executing the command.
+     * @param ttlSeconds The time-to-live (TTL) in seconds for the stored payload. This parameter specifies how long the payload should remain in the idempotency store before it expires, ensuring that old entries are eventually cleaned up and do not consume storage indefinitely.
+     * @returns A promise that resolves when the command has been marked as processed and the payload has been stored successfully in the idempotency store.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    markAsProcessed<T>(commandId: string, payload: T, ttlSeconds: number): Promise<void>;
+    /** @description Retrieves the payload associated with a processed command identified by the given commandId. This method is used to fetch the result of a previously processed command from the idempotency store, allowing clients to obtain the outcome of the command execution without having to reprocess the command. If a payload is found for the specified commandId, it returns the payload; otherwise, it returns null, indicating that there is no stored result for that commandId, which may occur if the command has not been processed or if the stored result has expired due to TTL.
+     * @param commandId The unique identifier for the command whose associated payload is being retrieved. This ID is used to query the idempotency store for the stored result of the command execution.
+     * @returns A promise that resolves to the payload associated with the processed command if it exists, or null if there is no stored result for the specified commandId.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    getPayload<T>(commandId: string): Promise<Optional<T>>;
+    /** @description Releases the lock associated with the given commandId, allowing other instances of the command to be processed. This method is used to free up the lock after a command has been processed, ensuring that subsequent attempts to process the same commandId can acquire the lock and execute the command if necessary. Releasing the lock is important for preventing deadlocks and ensuring that the idempotency mechanism functions correctly by allowing new commands with the same commandId to be processed after the previous one has completed.
+     * @param commandId The unique identifier for the command whose lock is being released. This ID is used to identify the lock in the idempotency store and free it for subsequent command processing.
+     * @returns A promise that resolves when the lock has been successfully released.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    releaseLock(commandId: string): Promise<void>;
+}
+//# sourceMappingURL=idempotency-store.contracts.d.ts.map

package/dist/domain/contracts/idempotency/idempotency-store.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-store.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/idempotency/idempotency-store.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;;KAQK;AACL,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEpE;;;;;;;;;OASG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAErD;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpF;;;;;;;;;OASG;IACH,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAEtD;;;;;;;;;OASG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C"}

package/dist/domain/contracts/idempotency/idempotency-store.contracts.js

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

package/dist/domain/contracts/idempotency/idempotency-store.contracts.js.map

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,22 @@
+export type * from './cache/index';
+export type * from './configuration/index';
+export type * from './context/index';
+export type * from './controllers/index';
+export type * from './cqrs/index';
+export type * from './datasources/index';
+export type * from './disposables/index';
+export type * from './factories/index';
+export type * from './gate_keepers/index';
+export type * from './http/index';
+export type * from './idempotency/index';
+export type * from './loggers/index';
+export type * from './mappers/index';
+export type * from './middlewares/index';
+export type * from './policies/index';
+export type * from './repositories/index';
+export type * from './services/index';
+export type * from './specifications/index';
+export type * from './storage/index';
+export type * from './strategies/index';
+export type * from './transaction/index';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/contracts/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,uBAAuB,CAAA;AAC1C,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,cAAc,CAAA;AACjC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,wBAAwB,CAAA;AAC3C,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,qBAAqB,CAAA"}

package/dist/domain/contracts/index.js

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

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

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

package/dist/domain/contracts/loggers/ilogger-client.contracts.d.ts

@@ -0,0 +1,27 @@
+import type { LogLevel, Optional } from '../../../shared';
+/**
+ * @description Interface for a logger client that provides a method for tracking log messages with a specified log level, message, optional context, and optional error.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface ILoggerClient {
+    /**
+     * Track a log message with a specified log level, message, optional context, and optional error.
+     * @param level The log level (e.g., info, warn, error, debug) for the log message.
+     * @param message The message to be logged.
+     * @param context An optional dictionary containing additional context for the log message.
+     * @param error An optional unknown object associated with the log message.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    track<T>(level: LogLevel, message: string, context: Optional<T>, error: Optional<unknown>): void;
+}
+//# sourceMappingURL=ilogger-client.contracts.d.ts.map

package/dist/domain/contracts/loggers/ilogger-client.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ilogger-client.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/loggers/ilogger-client.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAElD;;;;;;;;KAQK;AACL,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CACjG"}

package/dist/domain/contracts/loggers/ilogger-client.contracts.js

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

package/dist/domain/contracts/loggers/ilogger-client.contracts.js.map

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