@xeno-js/shared 0.1.0

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

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

package/dist/domain/contracts/services/concurrency/concurrency-service.contracts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @description The IConcurrencyService interface provides a contract for executing multiple asynchronous tasks in parallel while strictly controlling the maximum number of concurrent executions. This is crucial for protecting system resources (CPU, RAM) and avoiding event loop blocking during massive batch operations (e.g., processing large CSV files, bulk database inserts).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IConcurrencyService {
+    /**
+     * @description Executes an array of asynchronous tasks in parallel, limiting the number of tasks running at the exact same time.
+     * @param tasks An array of functions, where each function returns a Promise representing the asynchronous task to be executed.
+     * @param concurrencyLimit The maximum number of promises allowed to run concurrently.
+     * @returns A Promise that resolves to an array containing the results of all tasks, in the same order as the input array.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    executeInParallel<T>(tasks: (() => Promise<T>)[], concurrencyLimit: number): Promise<T[]>;
+}
+//# sourceMappingURL=concurrency-service.contracts.d.ts.map

package/dist/domain/contracts/services/concurrency/concurrency-service.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-service.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/services/concurrency/concurrency-service.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;KAQK;AACL,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CAC1F"}

package/dist/domain/contracts/services/concurrency/concurrency-service.contracts.js

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

package/dist/domain/contracts/services/concurrency/concurrency-service.contracts.js.map

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

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

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

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

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

package/dist/domain/contracts/services/concurrency/index.js

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

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

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

package/dist/domain/contracts/services/extractors/iextractor-service.contracts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @description The IServiceExtractor interface defines a contract for extracting metadata from HTTP headers. Implementing classes must provide the extract method, which takes HttpHeaders as input and returns a Metadata object containing the extracted information. This allows for flexible and consistent extraction of metadata across different parts of the application, such as authentication, logging, or request validation.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IServiceExtractor<TRequest, TResponse = unknown> {
+    /**
+     * @description The extract method retrieves metadata from the provided HttpHeaders. Implementing classes must provide this method to allow flexible extraction of metadata for various purposes such as authentication, logging, or request validation.
+     * @param headers The HTTP headers from which the metadata will be extracted. This object typically contains key-value pairs representing the headers of the incoming request.
+     * @returns A Metadata object containing the extracted metadata information. This allows for handling both success and error cases in a consistent manner.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    extract(headers: TRequest): TResponse;
+}
+//# sourceMappingURL=iextractor-service.contracts.d.ts.map

package/dist/domain/contracts/services/extractors/iextractor-service.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iextractor-service.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/services/extractors/iextractor-service.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;KAQK;AACL,MAAM,WAAW,iBAAiB,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO;IAC9D;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,CAAA;CACtC"}

package/dist/domain/contracts/services/extractors/iextractor-service.contracts.js

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

package/dist/domain/contracts/services/extractors/iextractor-service.contracts.js.map

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

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

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

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

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

package/dist/domain/contracts/services/extractors/index.js

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

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

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

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

@@ -0,0 +1,6 @@
+export type * from './auth/index';
+export type * from './concurrency/index';
+export type * from './extractors/index';
+export type * from './resiliences/index';
+export type * from './validators/index';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/services/resiliences/index.js

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

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

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

package/dist/domain/contracts/services/resiliences/iresilience-service.contracts.d.ts

@@ -0,0 +1,26 @@
+import type { Optional } from '../../../../shared';
+/**
+ * @description The ServiceResilience interface defines a contract for implementing resilience features in service calls. It provides a method to execute asynchronous operations with built-in support for retries, timeouts, and circuit breakers. This interface is designed to enhance the reliability of service interactions by automatically handling transient faults and preventing cascading failures in distributed systems.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IServiceResilience {
+    /**
+     * @description Executes a given asynchronous operation with resilience features such as retries, timeouts, and circuit breakers. This method is designed to handle transient faults and improve the reliability of service calls by automatically retrying failed operations, enforcing timeouts to prevent hanging requests, and implementing circuit breaker patterns to avoid overwhelming services that are experiencing issues. The method takes an asynchronous function as input and returns a Promise that resolves with the result of the operation or rejects with an error if the operation fails after exhausting all retry attempts or if a timeout occurs.
+     * @param action An asynchronous function that represents the operation to be executed with resilience features. This function should return a Promise that resolves with the result of the operation or rejects with an error if the operation fails.
+     * @param signal An optional AbortSignal that can be used to cancel the operation.
+     * @returns A Promise that resolves with the result of the operation if it succeeds within the allowed retry attempts and timeouts, or rejects with an error if it fails after exhausting all retry attempts or if a timeout occurs.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    execute<T>(action: () => Promise<T>, signal: Optional<AbortSignal>): Promise<T>;
+}
+//# sourceMappingURL=iresilience-service.contracts.d.ts.map

package/dist/domain/contracts/services/resiliences/iresilience-service.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iresilience-service.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/services/resiliences/iresilience-service.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;;KAQK;AACL,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAChF"}

package/dist/domain/contracts/services/resiliences/iresilience-service.contracts.js

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

package/dist/domain/contracts/services/resiliences/iresilience-service.contracts.js.map

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

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

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

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

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

package/dist/domain/contracts/services/validators/index.js

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

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

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

package/dist/domain/contracts/services/validators/ivalidator-service.contracts.d.ts

@@ -0,0 +1,38 @@
+import type { ResultType } from '../../../results/result.types';
+/**
+ * @description Interface for a validation service that provides methods to check for the existence of validation schemas and to validate data against those schemas. The IValidatorService interface defines two methods: hasSchema, which checks if a validation schema exists for a given key, and validate, which validates data against a specified schema key and returns a ResultType indicating the success or failure of the validation process. This interface can be implemented by various validation services that utilize different schema validation libraries or custom validation logic to ensure that incoming data meets the required criteria before being processed further in the application.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IValidatorService {
+    /**
+     * @description Validates the provided data against the validation schema associated with the specified key. This method performs the actual validation logic, checking if the data conforms to the rules defined in the corresponding schema. It returns a ResultType indicating whether the validation was successful or if it failed, along with any relevant error information if the validation did not pass.
+     * @param key The key representing the type of data or request for which the validation is being performed. This key is used to identify the appropriate validation schema to apply to the data.
+     * @param data The data to be validated against the schema. This can be any type of data that needs to be checked for conformity with the validation rules defined in the schema.
+     * @returns A ResultType indicating the outcome of the validation. If the validation is successful, it returns a ResultType with a value of true; if the validation fails, it returns a ResultType with a value of false and includes error information.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
+    /**
+     * @description Adds a new validation schema to the service's registry, associating it with the specified key. This method allows for dynamically registering validation schemas that can be used later for validating incoming data. The schema must conform to the expected structure defined by the validation library being used (e.g., Zod schemas). By adding schemas to the service, it enables the application to perform validation checks against those schemas when processing requests or data that require validation.
+     * @param key The key representing the type of data or request for which the validation schema is being added. This key is used to identify the schema when performing validation checks.
+     * @param schema The validation schema to be added, which defines the rules and structure that incoming data must conform to in order to pass validation. The specific type of the schema will depend on the validation library being used (e.g., ZodType for Zod schemas).
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    addSchema(key: string, schema: unknown): void;
+}
+//# sourceMappingURL=ivalidator-service.contracts.d.ts.map

package/dist/domain/contracts/services/validators/ivalidator-service.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ivalidator-service.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/services/validators/ivalidator-service.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAE/D;;;;;;;;KAQK;AACL,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;IAE/D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CAC9C"}

package/dist/domain/contracts/services/validators/ivalidator-service.contracts.js

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

package/dist/domain/contracts/services/validators/ivalidator-service.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/specifications/ispecification.contracts.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Interfaccia che definisce il contratto per una specifica di dominio.
+ * Una specifica permette di verificare se un oggetto (candidato)
+ * soddisfa determinati criteri di business.
+ *
+ * @template T - Il tipo dell'oggetto da convalidare.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface ISpecification<T> {
+    /**
+     * Verifica se il candidato soddisfa i criteri della specifica.
+     * @param candidate - L'oggetto da testare.
+     * @returns Booleano: true se i criteri sono soddisfatti.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isSatisfiedBy(candidate: T): boolean;
+    /**
+     * Combina questa specifica con un'altra tramite l'operatore logico AND.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    and(other: ISpecification<T>): ISpecification<T>;
+    /**
+     * Combina questa specifica con un'altra tramite l'operatore logico OR.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    or(other: ISpecification<T>): ISpecification<T>;
+    /**
+     * Inverte il risultato di questa specifica tramite l'operatore logico NOT.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    not(): ISpecification<T>;
+}
+//# sourceMappingURL=ispecification.contracts.d.ts.map

package/dist/domain/contracts/specifications/ispecification.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ispecification.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/specifications/ispecification.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;KAYK;AACL,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B;;;;;;;;;;OAUG;IACH,aAAa,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAA;IACpC;;;;;;;;OAQG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;IAEhD;;;;;;;;OAQG;IACH,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;IAE/C;;;;;;;;OAQG;IACH,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA;CACzB"}

package/dist/domain/contracts/specifications/ispecification.contracts.js

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

package/dist/domain/contracts/specifications/ispecification.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/storage/istorage.contracts.d.ts

@@ -0,0 +1,6 @@
+export interface IStorage {
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string) => void;
+    removeItem: (key: string) => void;
+}
+//# sourceMappingURL=istorage.contracts.d.ts.map

package/dist/domain/contracts/storage/istorage.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"istorage.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/storage/istorage.contracts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC"}

package/dist/domain/contracts/storage/istorage.contracts.js

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

package/dist/domain/contracts/storage/istorage.contracts.js.map

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/strategies/istrategy.contracts.d.ts

@@ -0,0 +1,25 @@
+import type { ResultType } from '../../results/result.types';
+/**
+ * @description Interface that defines the contract for a strategy used in the authorization pipeline. Each strategy must implement the isApplicable method to determine if it should be applied to a given request, and the execute method to perform the necessary authorization checks. The execute method returns a ResultType indicating whether the authorization was successful or if it failed, allowing the pipeline to handle the outcome accordingly.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IStrategy<TInput, TResult = void> {
+    /**
+     * @description Executes the strategy's logic for the given context. This method is called by the authorization pipeline when a strategy is deemed applicable. The implementation of this method should perform the necessary checks to determine if the request is authorized, and return a ResultType indicating the outcome of the authorization process. The ResultType should indicate success if the authorization checks pass, or contain an error if the checks fail, allowing the pipeline to handle the result accordingly.
+     * @param context - The context for which the strategy should be executed, which can be of any type depending on the specific implementation of the strategy. This could include the request object, user information, or any other relevant data needed to perform the authorization checks.
+     * @returns A Promise that resolves to a ResultType indicating the outcome of the strategy's execution. The ResultType should indicate success if the authorization checks pass, or contain an error if the checks fail, allowing the pipeline to handle the result accordingly.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    execute(context: TInput): Promise<ResultType<TResult>>;
+}
+//# sourceMappingURL=istrategy.contracts.d.ts.map

package/dist/domain/contracts/strategies/istrategy.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"istrategy.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/strategies/istrategy.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D;;;;;;;;KAQK;AACL,MAAM,WAAW,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAC/C;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;CACvD"}

package/dist/domain/contracts/strategies/istrategy.contracts.js

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

package/dist/domain/contracts/strategies/istrategy.contracts.js.map

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

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

@@ -0,0 +1,3 @@
+export type * from './itransaction-state.types';
+export type * from './iunit-of-work.types';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/domain/contracts/transaction/itransaction-state.types.d.ts

@@ -0,0 +1,44 @@
+import type { Maybe } from '../../../shared';
+/**
+ * @file itransaction-state.types.ts
+ * @description This file contains the definition of the ITransactionState interface.
+ * @version 1.0.0
+ * @author Xeno
+ * @since 2025-09-30
+ * @link
+ */
+/**
+ * @interface ITransactionState
+ * @template TTx - The type of the transaction state.
+ * @description Represents the state of a transaction, which can be either a specific transaction type or null.
+ *
+ * @property {Maybe<TTx>} state - The current state of the transaction.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link
+ */
+export interface ITransactionState<TTx = unknown> {
+    /**
+     * Gets the current state of the transaction, which can be either a specific transaction type or null.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    get state(): Maybe<TTx>;
+    /**
+     * Sets the current state of the transaction, which can be either a specific transaction type or null.
+     *
+     * @param value - The new state of the transaction.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    set state(value: Maybe<TTx>);
+}
+//# sourceMappingURL=itransaction-state.types.d.ts.map

package/dist/domain/contracts/transaction/itransaction-state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"itransaction-state.types.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/transaction/itransaction-state.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC;;;;;;;GAOG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB,CAAC,GAAG,GAAG,OAAO;IAC9C;;;;;;;OAOG;IACH,IAAI,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAA;IAEvB;;;;;;;;;OASG;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAC;CAC7B"}

package/dist/domain/contracts/transaction/itransaction-state.types.js

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

package/dist/domain/contracts/transaction/itransaction-state.types.js.map

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

package/dist/domain/contracts/transaction/iunit-of-work.types.d.ts

@@ -0,0 +1,25 @@
+import type { Optional } from '../../../shared';
+/**
+ * @file unit-of-work.types.ts
+ * @description This file contains the interface for the Unit of Work pattern.
+ 
+ * @author Xeno
+ * @version 1.0.0
+ * @since 2025-09-30
+ * @link https://github.com/xeno-js/xeno-js
+ */
+export interface IUnitOfWork {
+    /**
+     * Executes a callback function within a transaction.
+     * @param callback The callback function to execute.
+     * @param signal An optional AbortSignal to cancel the transaction.
+     * @returns A promise that resolves with the result of the callback function.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    runInTransaction<T>(callback: () => Promise<T>, signal: Optional<AbortSignal>): Promise<T>;
+}
+//# sourceMappingURL=iunit-of-work.types.d.ts.map

package/dist/domain/contracts/transaction/iunit-of-work.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iunit-of-work.types.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/transaction/iunit-of-work.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC3F"}

package/dist/domain/contracts/transaction/iunit-of-work.types.js

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

package/dist/domain/contracts/transaction/iunit-of-work.types.js.map

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

package/dist/domain/entities/__tests__/entity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity.test.d.ts.map

package/dist/domain/entities/__tests__/entity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.test.d.ts","sourceRoot":"","sources":["../../../../src/domain/entities/__tests__/entity.test.ts"],"names":[],"mappings":""}