@woltz/rich-domain 1.7.0 → 1.8.0

package/dist/types/core/base-entity.d.ts

@@ -0,0 +1,88 @@
+import { ValidationError } from "../validation-error.js";
+import { BaseProps, HistoryEntry, DeepJsonResult, EntityHooks, EntityValidation, IDomainEventBus, IDomainEvent } from "../types/index.js";
+import { AggregateChanges, Id } from "./index";
+export declare abstract class BaseEntity<T extends BaseProps> {
+    private _props;
+    private tracker;
+    private proxiedProps;
+    private snapshot;
+    private validationConfig;
+    private entityHooks?;
+    private entitySchema?;
+    private domainEvents;
+    protected static validation?: EntityValidation<any>;
+    protected static hooks?: EntityHooks<any, any>;
+    constructor(props: Omit<T, "id"> & {
+        id?: Id;
+    });
+    private validateProps;
+    private extractPathKey;
+    /**
+     * Setup validation that runs on every property change.
+     * Uses the ChangeTracker's onChangeValidator callback.
+     */
+    private setupUpdateValidation;
+    private takeSnapshot;
+    private deepCloneProps;
+    get id(): Id;
+    isNew(): boolean;
+    /**
+     * Check equality with another entity by comparing IDs
+     */
+    equals(other: BaseEntity<T> | Id | string): boolean;
+    get props(): T;
+    /**
+     * Check if entity has validation errors (when throwOnError is false)
+     */
+    get hasValidationErrors(): boolean;
+    /**
+     * Get validation errors (when throwOnError is false)
+     */
+    get validationErrors(): ValidationError | undefined;
+    /**
+     * Returns all detected changes as AggregateChanges.
+     *
+     * @example
+     * ```typescript
+     * const changes = user.getChanges();
+     * const batch = changes.toBatchOperations();
+     *
+     * for (const del of batch.deletes) { ... }
+     * for (const create of batch.creates) { ... }
+     * for (const upd of batch.updates) { ... }
+     * ```
+     */
+    getChanges<TEntityMap = Record<string, any>>(): AggregateChanges<TEntityMap>;
+    /**
+     * Returns the change history (for debugging).
+     */
+    getHistory(): HistoryEntry[];
+    /**
+     * Clears history and marks entity as "clean".
+     * Call this after successfully persisting to the database.
+     */
+    markAsClean(): void;
+    /**
+     * Add a domain event to this entity
+     */
+    protected addDomainEvent(event: IDomainEvent): void;
+    /**
+     * Dispatch all events through the event bus
+     */
+    dispatchAll(bus: IDomainEventBus): Promise<void>;
+    /**
+     * Get all uncommitted domain events
+     */
+    getUncommittedEvents(): IDomainEvent[];
+    /**
+     * Clear all domain events (call after publishing)
+     */
+    clearEvents(): void;
+    /**
+     * Check if entity has uncommitted events
+     */
+    hasUncommittedEvents(): boolean;
+    toJSON(): DeepJsonResult<T>;
+    private deepToJson;
+}
+//# sourceMappingURL=base-entity.d.ts.map

package/dist/types/core/base-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-entity.d.ts","sourceRoot":"","sources":["../../../src/core/base-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,WAAW,EAGX,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAiB,gBAAgB,EAAE,EAAE,EAAe,MAAM,SAAS,CAAC;AAS3E,8BAAsB,UAAU,CAAC,CAAC,SAAS,SAAS;IAClD,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAE1C,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAEnC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,EAAE,CAAA;KAAE;IAqD9C,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA4E7B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,cAAc;IAkDtB,IAAI,EAAE,IAAI,EAAE,CAEX;IAEM,KAAK,IAAI,OAAO;IAIvB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,OAAO;IAoBnD,IAAW,KAAK,IAAI,CAAC,CAEpB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,eAAe,GAAG,SAAS,CAElD;IAED;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,gBAAgB,CAAC,UAAU,CAAC;IAI5E;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;;OAGG;IACH,WAAW,IAAI,IAAI;IAKnB;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInD;;OAEG;IACU,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D;;OAEG;IACH,oBAAoB,IAAI,YAAY,EAAE;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC;IAI3B,OAAO,CAAC,UAAU;CAiBnB"}

package/dist/types/core/change-tracker.d.ts

@@ -0,0 +1,96 @@
+import { HistoryEntry } from "../types/index.js";
+import { AggregateChanges } from "./aggregate-changes.js";
+/**
+ * Callback for validation on property change.
+ * Return false to reject the change, or throw an error.
+ */
+export type OnChangeValidator = (path: string, newValue: any) => boolean | void;
+/**
+ * Tracks changes in Aggregates using Proxy.
+ *
+ * Features:
+ * - Tracks changes in primitive properties
+ * - Tracks changes in nested entities (1:1)
+ * - Tracks changes in collections (1:N)
+ * - Calculates depth automatically
+ * - Generates AggregateChanges for persistence
+ * - Supports validation on change via onChangeValidator
+ */
+export declare class ChangeTracker {
+    private target;
+    private rootEntityName;
+    private path;
+    private depth;
+    private parentId?;
+    private parentEntity?;
+    private rootTracker?;
+    private history;
+    private originalValues;
+    private trackedArrays;
+    private trackedEntities;
+    private onChangeValidator?;
+    constructor(target: any, rootEntityName: string, path?: string, depth?: number, parentId?: string | undefined, parentEntity?: string | undefined, rootTracker?: ChangeTracker | undefined);
+    /**
+     * Sets a validator callback that will be called on every property change.
+     * The validator can:
+     * - Return false to reject the change (value will be reverted)
+     * - Throw an error to reject the change with an error
+     * - Return true/undefined to accept the change
+     */
+    setOnChangeValidator(validator: OnChangeValidator): void;
+    private captureInitialState;
+    private captureEntityState;
+    private captureArrayState;
+    createProxy(): any;
+    private createArrayProxy;
+    /**
+     * Returns all detected changes as AggregateChanges.
+     */
+    getChanges<TEntityMap = Record<string, any>>(): AggregateChanges<TEntityMap>;
+    private analyzeRootChanges;
+    private analyzeCollectionChanges;
+    /**
+     * Recursively marks all nested items as created when a parent is created.
+     */
+    private markNestedItemsAsCreated;
+    /**
+     * Recursively marks all nested items as deleted when a parent is deleted.
+     * Uses the original captured state to find nested items.
+     */
+    private markNestedItemsAsDeleted;
+    /**
+     * Recursively marks nested items as deleted from a JSON object.
+     * This is used when processing cloned (JSON) state.
+     */
+    private markNestedJsonItemAsDeleted;
+    /**
+     * Extracts identity key from a JSON object by looking at the original Entity instances.
+     */
+    private extractIdentityKeyFromJson;
+    private collectNestedArrays;
+    private analyzeEntityChanges;
+    private detectEntityChangeState;
+    private detectArrayChanges;
+    private detectChangedFields;
+    private handleArrayAssignment;
+    private handleEntityChange;
+    private getRootTracker;
+    private buildPath;
+    private shouldSkipProperty;
+    private getValueAtPath;
+    private extractRelationField;
+    private getItemKey;
+    private getEntityId;
+    private getEntityName;
+    private isEqual;
+    private deepEqual;
+    private hasChanged;
+    private cloneArray;
+    private deepClone;
+    private normalizeAndStringify;
+    getHistory(): HistoryEntry[];
+    clearHistory(): void;
+    markAsClean(): void;
+    getTarget(): any;
+}
+//# sourceMappingURL=change-tracker.d.ts.map

package/dist/types/core/change-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-tracker.d.ts","sourceRoot":"","sources":["../../../src/core/change-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,OAAO,GAAG,IAAI,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IAQtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,KAAK;IAEb,OAAO,CAAC,QAAQ,CAAC;IAEjB,OAAO,CAAC,YAAY,CAAC;IACrB,OAAO,CAAC,WAAW,CAAC;IAftB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAoB;gBAGpC,MAAM,EAAE,GAAG,EACX,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE,MAAW,EACjB,KAAK,GAAE,MAAU,EAEjB,QAAQ,CAAC,EAAE,MAAM,YAAA,EAEjB,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,WAAW,CAAC,EAAE,aAAa,YAAA;IAQrC;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAIxD,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,iBAAiB;IAoCzB,WAAW,IAAI,GAAG;IAmFlB,OAAO,CAAC,gBAAgB;IA+GxB;;OAEG;IACH,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,gBAAgB,CAAC,UAAU,CAAC;IAW5E,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,wBAAwB;IAsFhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA8ChC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IA8ChC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA0DnC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmBlC,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,oBAAoB;IA0F5B,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,kBAAkB;IA2C1B,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,qBAAqB;IAe7B,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,SAAS;IA4CjB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,qBAAqB;IAkB7B,UAAU,IAAI,YAAY,EAAE;IAI5B,YAAY,IAAI,IAAI;IASpB,WAAW,IAAI,IAAI;IAInB,SAAS,IAAI,GAAG;CAGjB"}

package/dist/types/core/domain-event.d.ts

@@ -0,0 +1,23 @@
+import { IDomainEvent } from "..";
+/**
+ * Base class for domain events
+ */
+export declare abstract class DomainEvent<P> implements IDomainEvent<P> {
+    readonly eventId: string;
+    readonly occurredOn: Date;
+    readonly payload: P;
+    static readonly queueName?: string;
+    constructor(payload: P);
+    /**
+     * Get the event name (defaults to class name)
+     */
+    get eventName(): string;
+    private generateEventId;
+    toJSON(): {
+        eventId: string;
+        eventName: string;
+        occurredOn: string;
+        payload: P;
+    };
+}
+//# sourceMappingURL=domain-event.d.ts.map

package/dist/types/core/domain-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.d.ts","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC;;GAEG;AACH,8BAAsB,WAAW,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC7D,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,UAAU,EAAE,IAAI,CAAC;IACjC,SAAgB,OAAO,EAAE,CAAC,CAAC;IAC3B,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,CAAC;IAMtB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,eAAe;IAIvB,MAAM;;;;;;CAQP"}

package/dist/types/core/entity-changes.d.ts

@@ -0,0 +1,84 @@
+import { Operation } from "../types/change-tracker.js";
+/**
+ * Represents the changes filtered for a specific entity.
+ *
+ * @example
+ * ```typescript
+ * const changes = user.getChanges();
+ * const postChanges = changes.for('Post');
+ *
+ * if (postChanges.hasCreates()) {
+ *   console.log('Created posts:', postChanges.creates);
+ * }
+ *
+ * if (postChanges.hasUpdates()) {
+ *   postChanges.updates.forEach(({ entity, changed }) => {
+ *     console.log(`Post ${entity.id} has changed:`, changed);
+ *   });
+ * }
+ * ```
+ */
+export declare class EntityChanges<T = any> {
+    private readonly operations;
+    constructor(operations: Operation<T>[]);
+    /**
+     * Returns all created entities
+     */
+    get creates(): T[];
+    /**
+     * Returns all updated entities with their changed fields
+     */
+    get updates(): Array<{
+        entity: T;
+        changed: Record<string, any>;
+    }>;
+    /**
+     * Returns all deleted entities
+     */
+    get deletes(): T[];
+    /**
+     * Returns the IDs of the created entities
+     */
+    get createIds(): string[];
+    /**
+     * Returns the IDs of the updated entities
+     */
+    get updateIds(): string[];
+    /**
+     * Returns the IDs of the deleted entities
+     */
+    get deleteIds(): string[];
+    /**
+     * Checks if there are any creates
+     */
+    hasCreates(): boolean;
+    /**
+     * Checks if there are any updates
+     */
+    hasUpdates(): boolean;
+    /**
+     * Checks if there are any deletes
+     */
+    hasDeletes(): boolean;
+    /**
+     * Checks if there is any change
+     */
+    hasChanges(): boolean;
+    /**
+     * Checks if it is empty (no changes)
+     */
+    isEmpty(): boolean;
+    /**
+     * Returns the total number of operations
+     */
+    get count(): number;
+    /**
+     * Returns the raw operations (for advanced use cases)
+     */
+    get rawOperations(): Operation<T>[];
+    /**
+     * Extracts the ID from an entity
+     */
+    private extractId;
+}
+//# sourceMappingURL=entity-changes.d.ts.map

package/dist/types/core/entity-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-changes.d.ts","sourceRoot":"","sources":["../../../src/core/entity-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAIV,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE;IAEvD;;OAEG;IACH,IAAI,OAAO,IAAI,CAAC,EAAE,CAIjB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAOhE;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,CAAC,EAAE,CAIjB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAKxB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAIxB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAIxB;IAED;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,SAAS,CAAC,CAAC,CAAC,EAAE,CAElC;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;CAMlB"}

package/dist/types/core/entity.d.ts

@@ -0,0 +1,7 @@
+import { BaseEntity } from "./base-entity.js";
+import { BaseProps } from "../types/index.js";
+export declare class Entity<T extends BaseProps> extends BaseEntity<T> {
+}
+export declare class Aggregate<T extends BaseProps> extends BaseEntity<T> {
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/types/core/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/core/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,qBAAa,MAAM,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;CAAG;AACjE,qBAAa,SAAS,CAAC,CAAC,SAAS,SAAS,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;CAAG"}

package/dist/types/core/id.d.ts

@@ -0,0 +1,59 @@
+export declare class Id {
+    private readonly _value;
+    private readonly _isNew;
+    /**
+     * Create a new Id
+     * @param value - Optional existing ID value. If not provided, generates a new UUID.
+     *
+     * @example
+     * // New entity (generates UUID)
+     * const newId = new Id();
+     * newuser.isNew() // true
+     *
+     * // Existing entity (uses provided ID)
+     * const existingId = new Id("550e8400-e29b-41d4-a716-446655440000");
+     * existinguser.isNew() // false
+     */
+    constructor(value: string, isNew?: boolean);
+    constructor(value?: string);
+    /**
+     * Get the string value of the ID
+     */
+    get value(): string;
+    /**
+     * Check if this ID represents a new entity
+     */
+    isNew(): boolean;
+    /**
+     * Convert to string (for JSON serialization and comparisons)
+     */
+    toString(): string;
+    /**
+     * Convert to JSON (returns the string value)
+     */
+    toJSON(): string;
+    /**
+     * Check equality with another Id or string
+     */
+    equals(other: Id | string): boolean;
+    /**
+     * Generate a UUID v4
+     */
+    private generateUUID;
+    /**
+     * Create a new Id (convenience static method)
+     */
+    static create(): Id;
+    /**
+     * Create an Id from an existing value
+     */
+    static from(value: string): Id;
+    /**
+     * Compose two IDs into a single ID
+     * @param a - The first ID
+     * @param b - The second ID
+     * @returns The composed ID
+     */
+    static compose(a: string | Id, b: string | Id): string;
+}
+//# sourceMappingURL=id.d.ts.map

package/dist/types/core/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../../src/core/id.ts"],"names":[],"mappings":"AAEA,qBAAa,EAAE;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAEjC;;;;;;;;;;;;OAYG;gBACS,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;gBAC9B,KAAK,CAAC,EAAE,MAAM;IAa1B;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACI,KAAK,IAAI,OAAO;IAIvB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,IAAI,MAAM;IAIhB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,GAAG,OAAO;IAOnC;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,EAAE;IAInB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE;IAI9B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,EAAE,GAAG,MAAM;CAUvD"}

package/dist/types/core/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./base-entity";
+export * from "./aggregate-changes";
+export * from "./change-tracker";
+export * from "./domain-event";
+export * from "./entity-changes";
+export * from "./entity";
+export * from "./id";
+export * from "./value-object";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,gBAAgB,CAAC"}

package/dist/types/core/value-object.d.ts

@@ -0,0 +1,49 @@
+import { ValidationError } from "../validation-error.js";
+import { IDomainEvent } from "../index.js";
+import { VOHooks, EntityValidation, Primitive } from "../types/index.js";
+export declare abstract class ValueObject<T extends Primitive> {
+    readonly value: T;
+    private validationConfig;
+    private domainHooks?;
+    private domainSchema?;
+    private domainEvents;
+    protected static validation?: EntityValidation<any>;
+    protected static hooks?: VOHooks<any, any>;
+    constructor(value: T);
+    private validateValue;
+    private extractPathKey;
+    /**
+     * Returns true if the value object has validation errors (when throwOnError is false).
+     */
+    get hasValidationErrors(): boolean;
+    /**
+     * Returns the validation errors (when throwOnError is false).
+     */
+    get validationErrors(): ValidationError | undefined;
+    /**
+     * Compare this ValueObject with another for equality based on their properties.
+     */
+    equals(other: ValueObject<T>): boolean;
+    /**
+     * Adds a domain event to this value object.
+     */
+    protected addDomainEvent(event: IDomainEvent): void;
+    /**
+     * Returns all uncommitted domain events.
+     */
+    getUncommittedEvents(): IDomainEvent[];
+    /**
+     * Clears all domain events (call after publishing).
+     */
+    clearEvents(): void;
+    /**
+     * Returns true if the value object has uncommitted events.
+     */
+    hasUncommittedEvents(): boolean;
+    /**
+     * Creates a new ValueObject with updated value.
+     * ValueObjects are immutable, so this returns a new instance.
+     */
+    protected clone(value: T): this;
+}
+//# sourceMappingURL=value-object.d.ts.map

package/dist/types/core/value-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-object.d.ts","sourceRoot":"","sources":["../../../src/core/value-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EACL,OAAO,EAGP,gBAAgB,EAChB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAW3B,8BAAsB,WAAW,CAAC,CAAC,SAAS,SAAS;IACnD,SAAgB,KAAK,EAAG,CAAC,CAAC;IAC1B,OAAO,CAAC,gBAAgB,CAA6B;IAErD,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAE1C,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAE/B,KAAK,EAAE,CAAC;IAmCpB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,eAAe,GAAG,SAAS,CAElD;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO;IAKtC;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInD;;OAEG;IACH,oBAAoB,IAAI,YAAY,EAAE;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;;OAGG;IACH,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;CAIhC"}

package/dist/types/index.d.ts

@@ -1,16 +1,10 @@
 export * from "./validation-error.js";
-export * from "./domain-event.js";
+export * from "./core/domain-event.js";
 export * from "./exceptions.js";
 export * from "./criteria.js";
-export * from "./paginated-result.js";
-export * from "./repository/index.js";
-export { Id } from "./id.js";
-export { Entity, Aggregate } from "./entity.js";
-export { ValueObject } from "./value-object.js";
-export { Mapper } from "./mapper.js";
-export { EntitySchemaRegistry } from "./entity-schema-registry.js";
-export { AggregateChanges } from "./aggregate-changes.js";
-export type { EntityHooks, Filter, EntityValidation, IDomainEvent, VOValidation, VOHooks, ValidationConfig, Primitive, TransactionContext, PaginationMeta, Pagination, OrderDirection, Order, IUnitOfWork, FieldPath, FilterOperator, Search, FilterValueFor, PathValue, OperatorsForType, DateOperators, NumberOperators, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, DeepJsonResult, IDomainEventBus, } from "./types/index.js";
-export { ARRAY_OPERATORS, BOOLEAN_OPERATORS, DATE_OPERATORS, NUMBER_OPERATORS, STRING_OPERATORS, FILTER_OPERATORS, } from "./constants.js";
 export { isValidOperatorForType } from "./utils/criteria-operator-validation.js";
+export { ARRAY_OPERATORS, BOOLEAN_OPERATORS, DATE_OPERATORS, NUMBER_OPERATORS, STRING_OPERATORS, FILTER_OPERATORS, } from "./constants.js";
+export { Id, Entity, Aggregate, ValueObject, AggregateChanges, DomainEvent, } from "./core/index.js";
+export { type PaginatedJsonResult, type CollectionConfig, Repository, Mapper, UnitOfWork, PaginatedResult, ReadRepository, WriteAndRead, WriteRepository, BaseTransactionContext, EntitySchemaRegistry, } from "./repository/index.js";
+export type { EntityHooks, Filter, EntityValidation, IDomainEvent, VOValidation, VOHooks, ValidationConfig, Primitive, TransactionContext, PaginationMeta, Pagination, OrderDirection, Order, IUnitOfWork, FieldPath, FilterOperator, Search, FilterValueFor, PathValue, OperatorsForType, DateOperators, NumberOperators, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, IDomainEventBus, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EACd,KAAK,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,MAAM,EACN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,EAAE,EACF,MAAM,EACN,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,UAAU,EACV,MAAM,EACN,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,cAAc,EACd,KAAK,EACL,WAAW,EACX,SAAS,EACT,cAAc,EACd,MAAM,EACN,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/types/paginated-result.d.ts

@@ -1,54 +1,62 @@
-import type { Criteria } from "./criteria.js";
-import type { Pagination, PaginationMeta, DeepJsonResult } from "./types/index.js";
+import type { Criteria } from "../criteria.js";
+import type {
+  Pagination,
+  PaginationMeta,
+  DeepJsonResult,
+} from "../types/index.js";
 /**
  * Type for the serialized result of PaginatedResult.toJSON()
  * Uses DeepJsonResult to ensure all nested entities are converted to plain objects
  */
 export type PaginatedJsonResult<T> = {
-    data: DeepJsonResult<T>[];
-    meta: PaginationMeta;
+  data: DeepJsonResult<T>[];
+  meta: PaginationMeta;
 };
 export declare class PaginatedResult<T> {
-    readonly data: T[];
-    readonly meta: PaginationMeta;
-    constructor(data: T[], meta: PaginationMeta);
-    /**
-     * Creates a PaginatedResult with calculated metadata
-     */
-    static create<T>(data: T[], pagination: Pagination, total: number): PaginatedResult<T>;
-    /**
-     * Creates pagination metadata from total count
-     */
-    static createMeta(pagination: Pagination, total: number): PaginationMeta;
-    /**
-     * Applies criteria to an in-memory array (useful for testing)
-     */
-    static fromArray<T>(items: T[], criteria: Criteria<T>): PaginatedResult<T>;
-    /**
-     * Converts the result to JSON, deeply serializing all entities/aggregates/value objects
-     * - Entities/Aggregates → calls toJSON() recursively
-     * - Value Objects → converts to value
-     * - Id → converts to string
-     * - Arrays → maps recursively
-     * - Plain objects → serializes properties recursively
-     * - Primitives → returns as-is
-     */
-    toJSON(): PaginatedJsonResult<T>;
-    /**
-     * Deep serialization logic (similar to BaseEntity.deepToJson)
-     */
-    private deepSerialize;
-    /**
-     * Transform each item in the result using a mapper function
-     */
-    map<U>(fn: (item: T) => U): PaginatedResult<U>;
-    /**
-     * Check if result has no data
-     */
-    get isEmpty(): boolean;
-    /**
-     * Check if there are more pages available
-     */
-    get hasMore(): boolean;
+  readonly data: T[];
+  readonly meta: PaginationMeta;
+  constructor(data: T[], meta: PaginationMeta);
+  /**
+   * Creates a PaginatedResult with calculated metadata
+   */
+  static create<T>(
+    data: T[],
+    pagination: Pagination,
+    total: number
+  ): PaginatedResult<T>;
+  /**
+   * Creates pagination metadata from total count
+   */
+  static createMeta(pagination: Pagination, total: number): PaginationMeta;
+  /**
+   * Applies criteria to an in-memory array (useful for testing)
+   */
+  static fromArray<T>(items: T[], criteria: Criteria<T>): PaginatedResult<T>;
+  /**
+   * Converts the result to JSON, deeply serializing all entities/aggregates/value objects
+   * - Entities/Aggregates → calls toJSON() recursively
+   * - Value Objects → converts to value
+   * - Id → converts to string
+   * - Arrays → maps recursively
+   * - Plain objects → serializes properties recursively
+   * - Primitives → returns as-is
+   */
+  toJSON(): PaginatedJsonResult<T>;
+  /**
+   * Deep serialization logic (similar to BaseEntity.deepToJson)
+   */
+  private deepSerialize;
+  /**
+   * Transform each item in the result using a mapper function
+   */
+  map<U>(fn: (item: T) => U): PaginatedResult<U>;
+  /**
+   * Check if result has no data
+   */
+  get isEmpty(): boolean;
+  /**
+   * Check if there are more pages available
+   */
+  get hasMore(): boolean;
 }
-//# sourceMappingURL=paginated-result.d.ts.map
+//# sourceMappingURL=paginated-result.d.ts.map