@xeno-js/shared 0.1.0

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

@@ -0,0 +1,62 @@
+import type { Optional } from '../../../shared';
+/**
+ * @description Interface for a logger that provides methods for logging messages at different levels (info, warn, error, debug) and tracking exceptions. Each logging method accepts a message and an optional context, while the error method also accepts an optional Error object.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface ILogger {
+    /**
+     * Log a message at the info level with an optional context.
+     * @param message The message to log.
+     * @param context An optional dictionary containing additional context for the log message.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    info(message: string): void;
+    /**
+     * Log a message at the warning level with an optional context.
+     * @param message The message to log.
+     * @param context An optional dictionary containing additional context for the log message.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    warn(message: string): void;
+    /**
+     * Log a message at the error level with an optional error object and context.
+     * @param message The message to log.
+     * @param error An optional unknown object associated with the log message.
+     * @param context An optional dictionary containing additional context for the log message.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    error(message: string, error: Optional<unknown>): void;
+    /**
+     * Log a message at the debug level with an optional context.
+     * @param message The message to log.
+     * @param context An optional dictionary containing additional context for the log message.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    debug(message: string): void;
+}
+//# sourceMappingURL=ilogger.contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ilogger.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/loggers/ilogger.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;;;;KAQK;AACL,MAAM,WAAW,OAAO;IACtB;;;;;;;;;;OAUG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;IACtD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B"}

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/mappers/ibase-mapper.contracts.d.ts

@@ -0,0 +1,33 @@
+/**
+ *  @description Generic mapper interface defining a contract for mapping objects of type TSource to type TDestination. Mappers are used to convert data between different layers of the application, such as transforming DTOs to domain entities or vice versa. This interface defines a contract that all mappers must implement, ensuring consistency and maintainability of the code.
+ *  @template TSource The type of the source object to be mapped.
+ *  @template TDestination The type of the destination object resulting from the mapping.
+ *  @example
+ *  // Example of a UserMapper that maps a UserDTO to a UserEntity
+ *  class UserMapper implements IBaseMapper<UserDTO, UserEntity> {
+ *      map(source: UserDTO): UserEntity {
+ *          // Mapping logic here
+ *      }
+ *  }
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IBaseMapper<TSource, TDestination> {
+    /**
+     * @description Maps an object of type TSource to an object of type TDestination. The implementation of this method should contain the logic for transforming the source object into the desired destination format, which may involve copying properties, converting data types, or applying any necessary transformations to ensure that the resulting object is correctly structured for its intended use.
+     * @param source The source object of type TSource that needs to be mapped to type TDestination. This object contains the data that will be transformed and returned as a new object of the destination type.
+     * @returns An object of type TDestination that is the result of mapping the source object. The returned object should be a new instance that represents the transformed data according to the mapping logic defined in the implementation of this method.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    map(source: TSource): TDestination;
+}
+//# sourceMappingURL=ibase-mapper.contracts.d.ts.map

package/dist/domain/contracts/mappers/ibase-mapper.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibase-mapper.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/mappers/ibase-mapper.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;KAiBK;AACL,MAAM,WAAW,WAAW,CAAC,OAAO,EAAE,YAAY;IAChD;;;;;;;;;;OAUG;IACH,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAAA;CACnC"}

package/dist/domain/contracts/mappers/ibase-mapper.contracts.js

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

package/dist/domain/contracts/mappers/ibase-mapper.contracts.js.map

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

package/dist/domain/contracts/mappers/imapper.contracts.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @description Contratto per i Mapper, che definisce i metodi per convertire tra entità e Data Transfer Object (DTO).
+ *
+ * @template TE - Il tipo dell'entità.
+ * @template TDto - Il tipo del Data Transfer Object (DTO).
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IMapper<TE, TDto> {
+    /**
+     * Converts an entity of type TE to a Data Transfer Object (DTO) of type TDto.
+     *
+     * @param entity - The entity to be converted.
+     * @returns A DTO representation of the given entity.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    toDto(entity: TE): TDto;
+    /**
+     * Converts a Data Transfer Object (DTO) of type TDto to an entity of type TE.
+     *
+     * @param dto - The DTO to be converted.
+     * @returns An entity representation of the given DTO.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    toEntity(dto: TDto): TE;
+    /**
+     * Converts a partial entity of type TE to a partial Data Transfer Object (DTO) of type TDto.
+     * @param entity - The partial entity to be converted.
+     * @returns A partial DTO representation of the given partial entity.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    toPartialDto(entity: Partial<TE>): Partial<TDto>;
+}
+//# sourceMappingURL=imapper.contracts.d.ts.map

package/dist/domain/contracts/mappers/imapper.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imapper.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/mappers/imapper.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;KAWK;AACL,MAAM,WAAW,OAAO,CAAC,EAAE,EAAE,IAAI;IAC/B;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,CAAA;IAEvB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAA;IAEvB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}

package/dist/domain/contracts/mappers/imapper.contracts.js

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

package/dist/domain/contracts/mappers/imapper.contracts.js.map

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

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

@@ -0,0 +1,3 @@
+export type * from './ibase-mapper.contracts';
+export type * from './imapper.contracts';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/domain/contracts/middlewares/imiddleware.contracts.d.ts

@@ -0,0 +1,34 @@
+import type { HttpMethod, ResponseDto } from '../../../shared';
+/**
+ * @description The IMiddleware interface defines the contract for middleware components that process incoming HTTP requests. Implementing classes must provide an execute method that takes an HttpRequest as input and returns a Promise of a ResponseDto, which can either be a successful response or an error response. This design allows for flexible middleware implementations that can perform various tasks such as authentication, logging, request transformation, or response generation.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IMiddleware<THeaders = unknown> {
+    /**
+     * @description The execute method processes an incoming HTTP request and returns a ResponseDto that can either be a successful response or an error response. This allows for flexible middleware implementations that can either modify the request, perform side effects, or generate a response directly.
+     * @param path The path of the incoming HTTP request. This allows middleware to perform actions based on the request path, such as routing, logging, or applying specific middleware logic.
+     * @param request The incoming HTTP request that the middleware will process. This object typically contains information such as the request method, URL, headers, body, and other relevant data needed for processing.
+     * @param next A callback function that, when invoked, will pass control to the next middleware in the chain or to the final request handler. This allows for a composable middleware architecture where multiple middleware components can be chained together to process a request.
+     * @returns A Promise that resolves to a ResponseDto containing either a successful response or an error response. The ResponseDto 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
+     */
+    execute<T>(req: {
+        method: HttpMethod;
+        path: string;
+        transport: {
+            req: unknown;
+            res: unknown;
+        };
+    }, headers: THeaders, next: () => Promise<ResponseDto<T>>): Promise<ResponseDto<T>>;
+}
+//# sourceMappingURL=imiddleware.contracts.d.ts.map

package/dist/domain/contracts/middlewares/imiddleware.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imiddleware.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/middlewares/imiddleware.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEvD;;;;;;;;KAQK;AACL,MAAM,WAAW,WAAW,CAAC,QAAQ,GAAG,OAAO;IAC7C;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,CAAC,EACP,GAAG,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE;YAAE,GAAG,EAAE,OAAO,CAAC;YAAC,GAAG,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,EACpF,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;CAC3B"}

package/dist/domain/contracts/middlewares/imiddleware.contracts.js

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

package/dist/domain/contracts/middlewares/imiddleware.contracts.js.map

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/domain/contracts/policies/ipolicy-registry.contracts.d.ts

@@ -0,0 +1,38 @@
+import type { AuthPolicy, Optional } from '../../../shared';
+/**
+ * @description The IPolicyRegistry interface defines the contract for a Policy registry that manages role-based access control policies. It provides methods to add policies for certain intents and to retrieve the access control policy for a given intent. Implementations of this interface can be used to enforce Policy policies across the application by associating roles and permissions with specific actions or intents.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IPolicyRegistry {
+    /**
+     * @description Adds a policy for a specific intent. If a policy for the intent already exists, it will be updated with the new roles and permissions.
+     * @param intent - The intent for which the policy is being added.
+     * @param policy - The policy to be added.
+     * @returns The current instance of the policy registry.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    addPolicy(intent: string, policy: AuthPolicy): this;
+    /**
+     * @description Retrieves the policy for a specific intent.
+     * @param intent - The intent for which the policy is being retrieved.
+     * @returns The policy associated with the intent, or undefined if no policy exists.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    getPolicy(intent: string): Optional<AuthPolicy>;
+}
+//# sourceMappingURL=ipolicy-registry.contracts.d.ts.map

package/dist/domain/contracts/policies/ipolicy-registry.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipolicy-registry.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/policies/ipolicy-registry.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEpD;;;;;;;;KAQK;AACL,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAEnD;;;;;;;;;;OAUG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;CAChD"}

package/dist/domain/contracts/policies/ipolicy-registry.contracts.js

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

package/dist/domain/contracts/policies/ipolicy-registry.contracts.js.map

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

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

@@ -0,0 +1,3 @@
+export type * from './iread-dao.contracts';
+export type * from './irepository.contracts';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/domain/contracts/repositories/iread-dao.contracts.d.ts

@@ -0,0 +1,41 @@
+import type { Optional, UserContext } from '../../../shared';
+import type { ResultType } from '../../results/result.types';
+/**
+ * @description Interface representing a Data Access Object (DAO) for read operations. This interface defines the contract for retrieving data from a data source, such as a database or an API. It includes methods for finding an entity by its unique identifier and for finding multiple entities based on a filter. The IReadDao interface is designed to be implemented by classes that provide specific data access logic, allowing for separation of concerns and easier testing.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IReadDao<T> {
+    /**
+     * @description Finds an entity by its unique identifier. This method takes an ID and an optional AbortSignal for cancellation. It returns a promise that resolves to the entity if found, or null | undefined if not found. The implementation of this method is responsible for constructing the appropriate query based on the provided ID and handling any necessary data transformations before returning the result.
+     * @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 for cancellation.
+     * @returns A promise that resolves to the entity if found, or null | undefined if not found.
+    
+     *
+     * @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<ResultType<Optional<T>>>;
+    /**
+     * @description Finds entities based on a filter. This method takes a filter object and an optional AbortSignal for cancellation. It returns a promise that resolves to an array of entities that match the filter criteria. 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 for cancellation.
+     * @returns A promise that resolves to an array of entities that match the filter criteria.
+    
+     *
+     * @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<ResultType<T[]>>;
+}
+//# sourceMappingURL=iread-dao.contracts.d.ts.map

package/dist/domain/contracts/repositories/iread-dao.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iread-dao.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/repositories/iread-dao.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D;;;;;;;;KAQK;AACL,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CACnF"}

package/dist/domain/contracts/repositories/iread-dao.contracts.js

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

package/dist/domain/contracts/repositories/iread-dao.contracts.js.map

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

package/dist/domain/contracts/repositories/irepository.contracts.d.ts

@@ -0,0 +1,95 @@
+import type { Optional, UserContext } from '../../../shared';
+import type { ResultType } from '../../results/result.types';
+/**
+ * @fileoverview Defines the IRepository interface for generic data access operations.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+/**
+ * A generic repository interface for performing basic CRUD operations on entities of type T.
+ *
+ * @template T - The type of the entity that the repository will manage.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IRepository<T> {
+    /**
+     * @description Finds an entity by its unique identifier. This method takes an ID and an optional AbortSignal for cancellation. It returns a promise that resolves to the entity if found, or null | undefined if not found. The implementation of this method is responsible for constructing the appropriate query based on the provided ID and handling any necessary data transformations before returning the result.
+     * @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 for cancellation.
+     * @returns A promise that resolves to the entity if found, or null | undefined if not found.
+    
+     *
+     * @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<ResultType<Optional<T>>>;
+    /**
+     * @description Finds entities based on the user context. This method takes a user context and an optional AbortSignal for cancellation. It returns a promise that resolves to an array of entities that match the context. The implementation of this method is responsible for constructing the appropriate query based on the provided context 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 for cancellation.
+     * @returns A promise that resolves to an array of entities that match the context.
+    
+     *
+     * @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<ResultType<T[]>>;
+    /**
+     * @description Updates entities based on the user context. This method takes a user context and an optional AbortSignal for cancellation. It returns a promise that resolves when the update operation is complete.
+     * @param id The unique identifier of the entity to update.
+     * @param entity The partial entity object containing the data to be updated.
+     * @param ctx The context of the authenticated user, which may be used for authorization and auditing purposes.
+     * @param signal An optional AbortSignal for cancellation.
+     * @returns A promise that resolves when the update operation is complete.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    update(id: string | number, entity: Partial<T>, ctx: UserContext, signal: Optional<AbortSignal>): Promise<ResultType<void>>;
+    /**
+     * @description Saves an entity to the repository. This method takes an entity object and an optional AbortSignal for cancellation. It returns a promise that resolves when the save operation is complete.
+     * @param entity The entity object to save.
+     * @param signal An optional AbortSignal to allow cancellation of the save operation.
+     * @returns A promise that resolves when the entity has been saved.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    save(entity: T, signal: Optional<AbortSignal>): Promise<ResultType<void>>;
+    /**
+     * Deletes an entity from the repository by its unique identifier.
+     *
+     * @param entity The entity to delete.
+     * @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 entity has been deleted.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    delete(entity: T, ctx: UserContext, signal: Optional<AbortSignal>): Promise<ResultType<void>>;
+}
+//# sourceMappingURL=irepository.contracts.d.ts.map

package/dist/domain/contracts/repositories/irepository.contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"irepository.contracts.d.ts","sourceRoot":"","sources":["../../../../src/domain/contracts/repositories/irepository.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAE5D;;;;;;;;KAQK;AAEL;;;;;;;;;;KAUK;AACL,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;;;;;;;;;;;;OAYG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAEnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAElF;;;;;;;;;;;;;OAaG;IACH,MAAM,CACJ,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IAE5B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IAEzE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;CAC9F"}

package/dist/domain/contracts/repositories/irepository.contracts.js

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

package/dist/domain/contracts/repositories/irepository.contracts.js.map

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

package/dist/domain/contracts/services/auth/iauth-service.contracts.d.ts

@@ -0,0 +1,71 @@
+import type { ResultType } from '../../../../domain';
+import type { AuthClaims, Maybe, Optional, Provider, Session } from '../../../../shared';
+/**
+ * @description IAuthService defines the contract for authentication services.
+ * It provides methods to check if a user is authenticated and to retrieve the user's claims.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IBaseAuthService {
+    /**
+     * Checks if the user is authenticated.
+     * @returns A promise that resolves to true if the user is authenticated, false otherwise.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Restituisce l'utente attualmente autenticato.
+     */
+    getUser(): Promise<ResultType<Maybe<AuthClaims>>>;
+    /**
+     * Authenticates a user based on a token.
+     * @param token The token to authenticate the user.
+     * @returns A promise that resolves to the user's claims, or null if not authenticated.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    authenticate(token: string): Promise<ResultType<AuthClaims>>;
+}
+/**
+ * @description IAuthService defines the contract for authentication services.
+ * It provides methods to check if a user is authenticated and to retrieve the user's claims.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+export interface IAuthService {
+    /**
+     * Avvia il flusso di autenticazione OAuth con un provider esterno (es. Google).
+     */
+    signInWithProvider(provider: Provider): Promise<ResultType<{
+        url: string;
+    }>>;
+    /**
+     * Restituisce la sessione corrente attiva salvata nel client Supabase.
+     */
+    getSession(): Promise<ResultType<Maybe<Session>>>;
+    /**
+     * Esegue il logout dell'utente e pulisce la sessione locale.
+     */
+    signOut(): Promise<ResultType<void>>;
+    exchangeCodeForSession(code: string): Promise<ResultType<Optional<Session>>>;
+}
+export interface IExtendendService extends IBaseAuthService, IAuthService {
+}
+//# sourceMappingURL=iauth-service.contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iauth-service.contracts.d.ts","sourceRoot":"","sources":["../../../../../src/domain/contracts/services/auth/iauth-service.contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAE9E;;;;;;;;;KASK;AACL,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAEnC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAEjD;;;;;;;;;;OAUG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;CAC7D;AAED;;;;;;;;;KASK;AACL,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAE5E;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAEjD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;IAEpC,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB,EAAE,YAAY;CAAG"}

package/dist/domain/contracts/services/auth/iauth-service.contracts.js

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

package/dist/domain/contracts/services/auth/iauth-service.contracts.js.map

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

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

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

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

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

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

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