@xeno-js/shared 0.1.7 → 0.2.1

package/dist/index.d.cts

@@ -2,6 +2,82 @@ import { SupabaseClient, User, Session as Session$1, Provider as Provider$1 } fr
 import { AxiosInstance } from 'axios';
 import { z, ZodType } from 'zod';
 
+/**
+ * @description DomainEvent is an interface that represents a domain event in the application. It defines the structure and properties of a domain event, which is a message that is published when a significant change
+ * occurs within the domain. Domain events are used to notify other parts of the application about these changes and trigger appropriate actions.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ */
+interface IDomainEvent<TPayload = unknown, TValueObject extends object = object> {
+    /**
+     * @description The unique identifier of the aggregate that triggered the domain event.
+     */
+    readonly aggregateId: TValueObject;
+    /**
+     * @description The type of the domain event.
+     */
+    readonly eventType: string;
+    /**
+     * @description The version of the domain event.
+     */
+    readonly version: number;
+    /**
+     * @description The timestamp when the domain event occurred.
+     */
+    readonly occurredAt: Date;
+    /**
+     * @description The payload of the domain event, containing the specific data related to the event.
+     */
+    readonly payload: TPayload;
+}
+
+/**
+ * The IValueObject interface defines the contract for value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The IValueObject interface includes methods for retrieving the underlying value, comparing value objects for equality, and providing a string representation of the value object.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface IValueObject<T extends object> {
+    /**
+     * Retrieves the underlying value of the value object. This method provides access to the encapsulated data, allowing it to be used in comparisons, transformations, or other operations while maintaining the integrity and immutability of the value object.
+     * @returns The underlying value of the value object.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    getValue(): T;
+    /**
+     * Compares the current value object with another value object for equality. This method checks if the underlying values of both value objects are equal, allowing for meaningful comparisons between value objects based on their encapsulated data rather than their reference identity.
+     * @param other The other value object to compare with the current value object.
+     * @returns True if the underlying values of both value objects are equal; otherwise, returns false.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    equals(other: IValueObject<T>): boolean;
+    /**
+     * Returns a string representation of the value object. This method can be used for debugging, logging, or any scenario where a human-readable representation of the value object is needed. The string representation should ideally include relevant information about the underlying value to provide context when the value object is printed or logged.
+     * @returns A string representation of the value object.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    toString(): string;
+}
+
 /**
  * @description This module defines constants related to concurrency handling in the application, specifically for the ConcurrencyRetryPipeline. These constants include the maximum number of retry attempts, the base delay for retries, and the maximum jitter to be added to the delay. The constants are exported as a frozen object to prevent modification at runtime, ensuring consistent behavior across the application when handling concurrency conflicts.
 
@@ -2891,6 +2967,77 @@ declare const StringHelper: Readonly<{
     readonly getSingleValueWithSplit: (value: string, separator: string) => string;
 }>;
 
+/**
+ * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare abstract class ValueObject<T extends object> implements IValueObject<T> {
+    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    protected readonly _props: T;
+    protected constructor(props: T);
+    equals(vo?: Optional<IValueObject<T>>): boolean;
+    getValue(): T;
+    toString(): string;
+}
+
+/**
+ * @description AggregateRoot is an abstract class that represents the base class for all aggregate roots in the application. An aggregate root is the root entity of an aggregate, which is a group of related entities and value objects that are treated as a single unit. The AggregateRoot class provides common functionality for managing the state and behavior of aggregate roots, including methods for adding and retrieving uncommitted events, and methods for applying events to the aggregate.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ */
+declare abstract class AggregateRoot<TEvent = unknown, TValueObject extends object = object> {
+    readonly id: IValueObject<TValueObject>;
+    private _version;
+    private readonly _uncommittedEvents;
+    /**
+     * @description Constructs a new instance of the AggregateRoot class with the specified ID.
+     * @param {IValueObject<TValueObject>} id - The ID of the aggregate.
+     */
+    constructor(id: IValueObject<TValueObject>);
+    /**
+     * @description Gets the current version of the aggregate.
+     * @returns {number} The current version of the aggregate.
+     */
+    get version(): number;
+    /**
+     * @description Gets the uncommitted events of the aggregate.
+     * @returns {readonly IDomainEvent[]} The uncommitted events of the aggregate.
+     */
+    getUncommittedEvents(): readonly IDomainEvent<TEvent, IValueObject<TValueObject>>[];
+    /**
+     * @description Clears the uncommitted events of the aggregate.
+     */
+    clearUncommittedEvents(): void;
+    /**
+     * @description Loads the aggregate from a history of domain events.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>[]} history - The history of domain events to load.
+     */
+    loadFromHistory(history: IDomainEvent<TEvent, IValueObject<TValueObject>>[]): void;
+    /**
+     * @description Raises a domain event and adds it to the uncommitted events list.
+     * @param {Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>} eventData - The data of the domain event to raise.
+     */
+    protected raise(eventData: Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>): void;
+    /**
+     * @description Applies a domain event to the aggregate root.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>} event - The domain event to apply.
+     * @param {boolean} isNew - Indicates whether the event is new or already committed.
+     */
+    protected abstract apply(event: IDomainEvent<TEvent, IValueObject<TValueObject>>, isNew: boolean): void;
+}
+
 /**
  * @description Configuration options for the authentication service.
  * @author Xeno
@@ -5685,76 +5832,6 @@ declare abstract class Entity<T> implements IEntity<T> {
     getId(): UniqueId;
 }
 
-/**
- * The IValueObject interface defines the contract for value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The IValueObject interface includes methods for retrieving the underlying value, comparing value objects for equality, and providing a string representation of the value object.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IValueObject<T extends object> {
-    /**
-     * Retrieves the underlying value of the value object. This method provides access to the encapsulated data, allowing it to be used in comparisons, transformations, or other operations while maintaining the integrity and immutability of the value object.
-     * @returns The underlying value of the value object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    getValue(): T;
-    /**
-     * Compares the current value object with another value object for equality. This method checks if the underlying values of both value objects are equal, allowing for meaningful comparisons between value objects based on their encapsulated data rather than their reference identity.
-     * @param other The other value object to compare with the current value object.
-     * @returns True if the underlying values of both value objects are equal; otherwise, returns false.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    equals(other: IValueObject<T>): boolean;
-    /**
-     * Returns a string representation of the value object. This method can be used for debugging, logging, or any scenario where a human-readable representation of the value object is needed. The string representation should ideally include relevant information about the underlying value to provide context when the value object is printed or logged.
-     * @returns A string representation of the value object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    toString(): string;
-}
-
-/**
- * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare abstract class ValueObject<T extends object> implements IValueObject<T> {
-    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    protected readonly _props: T;
-    protected constructor(props: T);
-    equals(vo?: Optional<IValueObject<T>>): boolean;
-    getValue(): T;
-    toString(): string;
-}
-
 /**
  * @description Base class for all commands.
  * @author Xeno
@@ -6031,4 +6108,4 @@ declare class ZodValidatorService implements IValidatorService {
     validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
 }
 
-export { AbortSignalHelper, type AbstractConstructor, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, AxiosHttpClient, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, type Constructor, type CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, type Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, type Factory, GUEST, Guards, type Guid, GuidHelper, type HttpBaseRequest, type HttpClientConfig, type HttpHeaders, HttpHelper, type HttpMethod, type HttpOptions, type HttpQueryValue, type HttpRequest, type HttpResponse, type HttpResponseType, type IAuthService, type IBaseAccessor, type IBaseAuthService, type IBaseMapper, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IEntity, type IExtendendAuthService, type IFactory, type IGateKeeper, type IHandler, type IHttpClient, type IIdempotencyStore, type IIdentityAccessor, type ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValidatorService, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, type KeysOfType, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, type Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, type Nullable, type Optional, type Override, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type Provider, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type RequireKeys, type Resolver, type ResponseDto, Result, type ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type Session, type SetupAction, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, SupabaseAuthService, SupabaseClaimsMapper, SupabaseSessionMapper, TOKENS, type TracingContext, UniqueId, type UserContext, ValueObject, ZodUtils, ZodValidatorService };
+export { AbortSignalHelper, type AbstractConstructor, AggregateRoot, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, AxiosHttpClient, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, type Constructor, type CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, type Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, type Factory, GUEST, Guards, type Guid, GuidHelper, type HttpBaseRequest, type HttpClientConfig, type HttpHeaders, HttpHelper, type HttpMethod, type HttpOptions, type HttpQueryValue, type HttpRequest, type HttpResponse, type HttpResponseType, type IAuthService, type IBaseAccessor, type IBaseAuthService, type IBaseMapper, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IDomainEvent, type IEntity, type IExtendendAuthService, type IFactory, type IGateKeeper, type IHandler, type IHttpClient, type IIdempotencyStore, type IIdentityAccessor, type ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValidatorService, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, type KeysOfType, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, type Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, type Nullable, type Optional, type Override, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type Provider, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type RequireKeys, type Resolver, type ResponseDto, Result, type ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type Session, type SetupAction, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, SupabaseAuthService, SupabaseClaimsMapper, SupabaseSessionMapper, TOKENS, type TracingContext, UniqueId, type UserContext, ValueObject, ZodUtils, ZodValidatorService };

package/dist/index.d.ts

@@ -2,6 +2,82 @@ import { SupabaseClient, User, Session as Session$1, Provider as Provider$1 } fr
 import { AxiosInstance } from 'axios';
 import { z, ZodType } from 'zod';
 
+/**
+ * @description DomainEvent is an interface that represents a domain event in the application. It defines the structure and properties of a domain event, which is a message that is published when a significant change
+ * occurs within the domain. Domain events are used to notify other parts of the application about these changes and trigger appropriate actions.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ */
+interface IDomainEvent<TPayload = unknown, TValueObject extends object = object> {
+    /**
+     * @description The unique identifier of the aggregate that triggered the domain event.
+     */
+    readonly aggregateId: TValueObject;
+    /**
+     * @description The type of the domain event.
+     */
+    readonly eventType: string;
+    /**
+     * @description The version of the domain event.
+     */
+    readonly version: number;
+    /**
+     * @description The timestamp when the domain event occurred.
+     */
+    readonly occurredAt: Date;
+    /**
+     * @description The payload of the domain event, containing the specific data related to the event.
+     */
+    readonly payload: TPayload;
+}
+
+/**
+ * The IValueObject interface defines the contract for value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The IValueObject interface includes methods for retrieving the underlying value, comparing value objects for equality, and providing a string representation of the value object.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+interface IValueObject<T extends object> {
+    /**
+     * Retrieves the underlying value of the value object. This method provides access to the encapsulated data, allowing it to be used in comparisons, transformations, or other operations while maintaining the integrity and immutability of the value object.
+     * @returns The underlying value of the value object.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    getValue(): T;
+    /**
+     * Compares the current value object with another value object for equality. This method checks if the underlying values of both value objects are equal, allowing for meaningful comparisons between value objects based on their encapsulated data rather than their reference identity.
+     * @param other The other value object to compare with the current value object.
+     * @returns True if the underlying values of both value objects are equal; otherwise, returns false.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    equals(other: IValueObject<T>): boolean;
+    /**
+     * Returns a string representation of the value object. This method can be used for debugging, logging, or any scenario where a human-readable representation of the value object is needed. The string representation should ideally include relevant information about the underlying value to provide context when the value object is printed or logged.
+     * @returns A string representation of the value object.
+    
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    toString(): string;
+}
+
 /**
  * @description This module defines constants related to concurrency handling in the application, specifically for the ConcurrencyRetryPipeline. These constants include the maximum number of retry attempts, the base delay for retries, and the maximum jitter to be added to the delay. The constants are exported as a frozen object to prevent modification at runtime, ensuring consistent behavior across the application when handling concurrency conflicts.
 
@@ -2891,6 +2967,77 @@ declare const StringHelper: Readonly<{
     readonly getSingleValueWithSplit: (value: string, separator: string) => string;
 }>;
 
+/**
+ * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
+
+   *
+   * @author Xeno
+   * @version 1.0.0
+   * @since 2025-09-30
+   * @link https://github.com/xeno-js/xeno-js
+   */
+declare abstract class ValueObject<T extends object> implements IValueObject<T> {
+    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
+     *
+     * @author Xeno
+     * @version 1.0.0
+     * @since 2025-09-30
+     * @link https://github.com/xeno-js/xeno-js
+     */
+    protected readonly _props: T;
+    protected constructor(props: T);
+    equals(vo?: Optional<IValueObject<T>>): boolean;
+    getValue(): T;
+    toString(): string;
+}
+
+/**
+ * @description AggregateRoot is an abstract class that represents the base class for all aggregate roots in the application. An aggregate root is the root entity of an aggregate, which is a group of related entities and value objects that are treated as a single unit. The AggregateRoot class provides common functionality for managing the state and behavior of aggregate roots, including methods for adding and retrieving uncommitted events, and methods for applying events to the aggregate.
+ *
+ * @author Xeno
+ * @version 1.0.0
+ */
+declare abstract class AggregateRoot<TEvent = unknown, TValueObject extends object = object> {
+    readonly id: IValueObject<TValueObject>;
+    private _version;
+    private readonly _uncommittedEvents;
+    /**
+     * @description Constructs a new instance of the AggregateRoot class with the specified ID.
+     * @param {IValueObject<TValueObject>} id - The ID of the aggregate.
+     */
+    constructor(id: IValueObject<TValueObject>);
+    /**
+     * @description Gets the current version of the aggregate.
+     * @returns {number} The current version of the aggregate.
+     */
+    get version(): number;
+    /**
+     * @description Gets the uncommitted events of the aggregate.
+     * @returns {readonly IDomainEvent[]} The uncommitted events of the aggregate.
+     */
+    getUncommittedEvents(): readonly IDomainEvent<TEvent, IValueObject<TValueObject>>[];
+    /**
+     * @description Clears the uncommitted events of the aggregate.
+     */
+    clearUncommittedEvents(): void;
+    /**
+     * @description Loads the aggregate from a history of domain events.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>[]} history - The history of domain events to load.
+     */
+    loadFromHistory(history: IDomainEvent<TEvent, IValueObject<TValueObject>>[]): void;
+    /**
+     * @description Raises a domain event and adds it to the uncommitted events list.
+     * @param {Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>} eventData - The data of the domain event to raise.
+     */
+    protected raise(eventData: Omit<IDomainEvent<TEvent, IValueObject<TValueObject>>, 'aggregateId' | 'version' | 'occurredAt'>): void;
+    /**
+     * @description Applies a domain event to the aggregate root.
+     * @param {IDomainEvent<TEvent, IValueObject<TValueObject>>} event - The domain event to apply.
+     * @param {boolean} isNew - Indicates whether the event is new or already committed.
+     */
+    protected abstract apply(event: IDomainEvent<TEvent, IValueObject<TValueObject>>, isNew: boolean): void;
+}
+
 /**
  * @description Configuration options for the authentication service.
  * @author Xeno
@@ -5685,76 +5832,6 @@ declare abstract class Entity<T> implements IEntity<T> {
     getId(): UniqueId;
 }
 
-/**
- * The IValueObject interface defines the contract for value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The IValueObject interface includes methods for retrieving the underlying value, comparing value objects for equality, and providing a string representation of the value object.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-interface IValueObject<T extends object> {
-    /**
-     * Retrieves the underlying value of the value object. This method provides access to the encapsulated data, allowing it to be used in comparisons, transformations, or other operations while maintaining the integrity and immutability of the value object.
-     * @returns The underlying value of the value object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    getValue(): T;
-    /**
-     * Compares the current value object with another value object for equality. This method checks if the underlying values of both value objects are equal, allowing for meaningful comparisons between value objects based on their encapsulated data rather than their reference identity.
-     * @param other The other value object to compare with the current value object.
-     * @returns True if the underlying values of both value objects are equal; otherwise, returns false.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    equals(other: IValueObject<T>): boolean;
-    /**
-     * Returns a string representation of the value object. This method can be used for debugging, logging, or any scenario where a human-readable representation of the value object is needed. The string representation should ideally include relevant information about the underlying value to provide context when the value object is printed or logged.
-     * @returns A string representation of the value object.
-    
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    toString(): string;
-}
-
-/**
- * The ValueObject class is an abstract implementation of the IValueObject interface, providing a base class for creating value objects in the domain. A value object is an immutable type that represents a concept or measurement in the domain, and its equality is based on its properties rather than its identity. The ValueObject class includes a constructor that initializes the properties of the value object and an equals method that compares two value objects for equality based on their properties.
-
-   *
-   * @author Xeno
-   * @version 1.0.0
-   * @since 2025-09-30
-   * @link https://github.com/xeno-js/xeno-js
-   */
-declare abstract class ValueObject<T extends object> implements IValueObject<T> {
-    /** @description The properties of the value object, which are immutable and define the value represented by the value object.
-     *
-     * @author Xeno
-     * @version 1.0.0
-     * @since 2025-09-30
-     * @link https://github.com/xeno-js/xeno-js
-     */
-    protected readonly _props: T;
-    protected constructor(props: T);
-    equals(vo?: Optional<IValueObject<T>>): boolean;
-    getValue(): T;
-    toString(): string;
-}
-
 /**
  * @description Base class for all commands.
  * @author Xeno
@@ -6031,4 +6108,4 @@ declare class ZodValidatorService implements IValidatorService {
     validate<T>(key: string, data: T): Promise<ResultType<boolean>>;
 }
 
-export { AbortSignalHelper, type AbstractConstructor, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, AxiosHttpClient, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, type Constructor, type CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, type Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, type Factory, GUEST, Guards, type Guid, GuidHelper, type HttpBaseRequest, type HttpClientConfig, type HttpHeaders, HttpHelper, type HttpMethod, type HttpOptions, type HttpQueryValue, type HttpRequest, type HttpResponse, type HttpResponseType, type IAuthService, type IBaseAccessor, type IBaseAuthService, type IBaseMapper, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IEntity, type IExtendendAuthService, type IFactory, type IGateKeeper, type IHandler, type IHttpClient, type IIdempotencyStore, type IIdentityAccessor, type ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValidatorService, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, type KeysOfType, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, type Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, type Nullable, type Optional, type Override, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type Provider, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type RequireKeys, type Resolver, type ResponseDto, Result, type ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type Session, type SetupAction, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, SupabaseAuthService, SupabaseClaimsMapper, SupabaseSessionMapper, TOKENS, type TracingContext, UniqueId, type UserContext, ValueObject, ZodUtils, ZodValidatorService };
+export { AbortSignalHelper, type AbstractConstructor, AggregateRoot, type ApiResponseDto, AppError, type AsyncFactory, type AsyncResolver, type AuthClaims, type AuthConfig, type AuthPolicy, AxiosFactory, AxiosHttpClient, BaseLogger, type CacheClientConfig, type CacheConfig, CacheKeyBuilder, Command, type Constructor, type CookieOptions, DEFAULT_CONCURRENCY, DateHelper, type DbConfig, type Delegate, type Dictionary, ERROR_CODES, ERROR_CODE_MESSAGES, Entity, Enumerable, type ErrorCode, type ErrorResponseDto, type Factory, GUEST, Guards, type Guid, GuidHelper, type HttpBaseRequest, type HttpClientConfig, type HttpHeaders, HttpHelper, type HttpMethod, type HttpOptions, type HttpQueryValue, type HttpRequest, type HttpResponse, type HttpResponseType, type IAuthService, type IBaseAccessor, type IBaseAuthService, type IBaseMapper, type ICache, type ICacheKeyBuilder, type ICacheableOptions, type ICommand, type IConcurrencyService, type IConfigurationService, type IContextAccessor, type IController, IDEMPOTENCY_CONSTANTS, type IDisposable, type IDomainEvent, type IEntity, type IExtendendAuthService, type IFactory, type IGateKeeper, type IHandler, type IHttpClient, type IIdempotencyStore, type IIdentityAccessor, type ILogger, type ILoggerClient, type IMapper, type IMediator, type IMiddleware, type INetworkContextAccessor, type IPaginatedResult, type IPipelineBehavior, type IPolicyRegistry, type IQuery, type IReadDao, type IReadDataSource, type IRemoteDataSource, type IRepository, type IRequest, type IServiceExtractor, type IServiceResilience, type ISpecification, type IStorage, type IStrategy, type ITransactionState, type IUnitOfWork, type IValidatorService, type IValueObject, type IWriteDataSource, type Identity, InMemoryCache, type InjectionToken, type KeysOfType, LOG_LEVEL, LOG_LEVEL_NAMES, type LogLevel, type LoggerContext, LoggerUtils, MathHelper, type Maybe, type MessageSequence, type MessagingContext, type Metadata, type NetworkContext, type Nullable, type Optional, type Override, PAGINATION_DEFAULTS, PERMISSIONS, type Permission, PromiseHelper, type Provider, type ProxyConfig, Query, REQUEST_TYPE, RESILIENCE_DEFAULTS, ROLES, type RequestContext, type RequestType, type RequireKeys, type Resolver, type ResponseDto, Result, type ResultType, type Role, SORT_DIRECTION, STATUS_CODES, SanitizeHelper, type Session, type SetupAction, type SortDirection, type StatusCode, StorageHelper, StringHelper, type SuccessResponseDto, SupabaseAuthService, SupabaseClaimsMapper, SupabaseSessionMapper, TOKENS, type TracingContext, UniqueId, type UserContext, ValueObject, ZodUtils, ZodValidatorService };