@woltz/rich-domain 1.3.2 → 1.4.0

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

@@ -0,0 +1,226 @@
+import { Entity } from "../entity.js";
+import { ValueObject } from "../value-object.js";
+/**
+ * Base operation with common information.
+ */
+export interface BaseOperation {
+    /** Entity name in the domain (e.g., 'User', 'Post', 'Comment') */
+    entity: string;
+    /** Depth in the aggregate tree (0 = root, 1 = direct children, etc.) */
+    depth: number;
+    /** Name of the relation field in the parent entity (e.g., 'tags', 'comments') */
+    relationField?: string;
+}
+/**
+ * Create operation.
+ */
+export interface CreateOperation<T = any> extends BaseOperation {
+    type: "create";
+    /** Entity data to be created */
+    data: T;
+    /** Parent ID (for FK) */
+    parentId?: string;
+    /** Parent entity name */
+    parentEntity?: string;
+}
+/**
+ * Update operation.
+ */
+export interface UpdateOperation<T = any> extends BaseOperation {
+    type: "update";
+    /** Entity ID */
+    id: string;
+    /** Current entity instance */
+    data: T;
+    /** Only fields that have changed */
+    changedFields: Record<string, any>;
+}
+/**
+ * Delete operation.
+ */
+export interface DeleteOperation<T = any> extends BaseOperation {
+    type: "delete";
+    /** Entity ID to be deleted */
+    id: string;
+    /** Entity data (for reference) */
+    data: T;
+    /** Parent entity name */
+    parentEntity?: string;
+    /** Parent ID */
+    parentId?: string;
+}
+/**
+ * Union of all possible operations.
+ */
+export type Operation<T = any> = CreateOperation<T> | UpdateOperation<T> | DeleteOperation<T>;
+/**
+ * Item for batch creation.
+ */
+export interface BatchCreateItem<T = any> {
+    /** Entity data */
+    data: T;
+    /** Parent ID (for FK) */
+    parentId?: string;
+    /** Parent entity name */
+    parentEntity?: string;
+    /** Relation field name */
+    relationField?: string;
+}
+/**
+ * Item for batch update.
+ */
+export interface BatchUpdateItem {
+    /** Entity ID */
+    id: string;
+    /** Fields that have changed */
+    changedFields: Record<string, any>;
+}
+/**
+ * Item for batch delete.
+ */
+export interface BatchDeleteItem {
+    /** Entity ID */
+    id: string;
+    /** Relation field name */
+    relationField?: string;
+}
+/**
+ * Grouped and ordered operations for batch execution.
+ */
+export interface BatchOperations {
+    /**
+     * Deletes grouped by entity, ordered by depth descending (leaf → root).
+     */
+    deletes: Array<{
+        entity: string;
+        depth: number;
+        ids: string[];
+        parentId?: string;
+        /** Relation field name (for determining owned vs reference) */
+        relationField?: string;
+        /** Parent entity name */
+        parentEntity?: string;
+        /** Individual items with their relation fields (when mixed) */
+        items?: BatchDeleteItem[];
+    }>;
+    /**
+     * Creates grouped by entity, ordered by depth ascending (root → leaf).
+     */
+    creates: Array<{
+        entity: string;
+        depth: number;
+        items: BatchCreateItem[];
+        /** Relation field name (for determining owned vs reference) */
+        relationField?: string;
+        /** Parent entity name */
+        parentEntity?: string;
+    }>;
+    /**
+     * Updates grouped by entity.
+     */
+    updates: Array<{
+        entity: string;
+        items: BatchUpdateItem[];
+    }>;
+}
+/**
+ * Changes detected in a collection (1:N).
+ */
+export interface CollectionChanges<T = any> {
+    /** Created items */
+    created: T[];
+    /** Updated items with their changes */
+    updated: Array<{
+        entity: T;
+        changes: Record<string, {
+            from: any;
+            to: any;
+        }>;
+    }>;
+    /** Deleted items */
+    deleted: T[];
+}
+/**
+ * Possible states for a 1:1 relationship.
+ */
+export type EntityChangeState = "created" | "updated" | "deleted" | "replaced" | "unchanged";
+/**
+ * Change in a 1:1 entity relationship.
+ */
+export interface EntityChange<T = any> {
+    /** State of the change */
+    state: EntityChangeState;
+    /** Current entity (null if deleted) */
+    current: T | null;
+    /** Previous entity (null if created) */
+    previous: T | null;
+    /** Field changes (if state === 'updated') */
+    changes?: Record<string, {
+        from: any;
+        to: any;
+    }>;
+}
+/**
+ * Change in a primitive field.
+ */
+export interface FieldChange<T = any> {
+    from: T;
+    to: T;
+}
+/**
+ * Extracts the props type from an Entity or ValueObject.
+ */
+export type ExtractProps<T> = T extends Entity<infer P> ? P : T extends ValueObject<infer P> ? P : never;
+/**
+ * Keys of primitive properties (not Entity, ValueObject or Array).
+ */
+export type PrimitiveKeys<T> = {
+    [K in keyof T]: T[K] extends Entity<any> | ValueObject<any> | Array<any> | undefined ? never : K;
+}[keyof T];
+/**
+ * Keys of collections (arrays).
+ */
+export type CollectionKeys<T> = {
+    [K in keyof T]: T[K] extends Array<any> ? K : never;
+}[keyof T];
+/**
+ * Keys of single entities (1:1).
+ */
+export type SingleEntityKeys<T> = {
+    [K in keyof T]: T[K] extends Entity<any> | ValueObject<any> | null | undefined ? T[K] extends Array<any> ? never : K : never;
+}[keyof T];
+/**
+ * Change history entry.
+ */
+export interface HistoryEntry {
+    path: string;
+    previousValue: any;
+    currentValue: any;
+    timestamp: number;
+}
+/**
+ * Metadata from a tracked entity/VO.
+ */
+export interface TrackedEntityMetadata {
+    /** Entity name */
+    entityName: string;
+    /** Depth in the tree */
+    depth: number;
+    /** Parent ID */
+    parentId?: string;
+    /** Parent entity name */
+    parentEntity?: string;
+    /** Path in the object (e.g., 'posts[0].comments[1]') */
+    path: string;
+}
+export interface TrackedItem {
+    entity: any;
+    metadata: TrackedEntityMetadata;
+    originalState: any;
+}
+export interface ArrayState {
+    cloned: any[];
+    original: any[];
+    metadata: TrackedEntityMetadata;
+}
+//# sourceMappingURL=change-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"change-tracker.d.ts","sourceRoot":"","sources":["../../../src/types/change-tracker.ts"],"names":[],"mappings":"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"}

package/dist/types/types/criteria.d.ts

@@ -0,0 +1,60 @@
+import { Primitive } from "./utils.js";
+export declare const FILTER_OPERATORS: readonly ["equals", "notEquals", "greaterThan", "greaterThanOrEqual", "lessThan", "lessThanOrEqual", "contains", "startsWith", "endsWith", "in", "notIn", "between", "isNull", "isNotNull"];
+export type FilterOperator = (typeof FILTER_OPERATORS)[number];
+export type StringOperators = "equals" | "notEquals" | "contains" | "startsWith" | "endsWith" | "in" | "notIn" | "isNull" | "isNotNull";
+export type NumberOperators = "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "in" | "notIn" | "between" | "isNull" | "isNotNull";
+export type DateOperators = "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "in" | "notIn" | "between" | "isNull" | "isNotNull";
+export type BooleanOperators = "equals" | "notEquals" | "isNull" | "isNotNull";
+export type ArrayOperators = "in" | "notIn" | "isNull" | "isNotNull";
+export type OperatorsForType<T> = T extends string ? StringOperators : T extends number ? NumberOperators : T extends Date ? DateOperators : T extends boolean ? BooleanOperators : T extends Array<any> ? ArrayOperators : FilterOperator;
+export type FilterValueFor<T> = T | (T extends number | Date ? [T, T] : never) | T[] | null;
+export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? T[K] extends Array<infer U> ? PathValue<U, Rest> : PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+export interface Filter<TField = string, TValue = unknown> {
+    field: TField;
+    operator: unknown extends TValue ? FilterOperator : OperatorsForType<TValue>;
+    value: TValue;
+    options?: CriteriaOptions;
+}
+export type TypedFilter<T> = {
+    [K in FieldPath<T>]: {
+        field: K;
+        operator: OperatorsForType<NonNullable<PathValue<T, K>>>;
+        value: FilterValueFor<NonNullable<PathValue<T, K>>>;
+        options?: CriteriaOptions;
+    };
+}[FieldPath<T>];
+export type CriteriaAdapter<Input, Output> = {
+    [K in FieldPath<Input>]?: FieldPath<Output>;
+};
+export type OrderDirection = "asc" | "desc";
+export interface Order {
+    field: string;
+    direction: OrderDirection;
+}
+export type TypedOrder<T> = {
+    field: FieldPath<T>;
+    direction: OrderDirection;
+};
+export interface Pagination {
+    page: number;
+    limit: number;
+    offset: number;
+}
+export type Search = string;
+export interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+export interface CriteriaOptions {
+    quantifier?: "some" | "every" | "none";
+}
+type ExcludeBuiltInKeys<T> = Exclude<keyof T, keyof any[] | number | symbol>;
+export type FieldPath<T> = T extends Primitive ? never : {
+    [K in ExcludeBuiltInKeys<T> & string]: NonNullable<T[K]> extends Primitive ? K : NonNullable<T[K]> extends Array<infer U> ? U extends Primitive ? K : K | `${K}.${FieldPath<U>}` : `${K}.${FieldPath<NonNullable<T[K]>>}`;
+}[ExcludeBuiltInKeys<T> & string];
+export {};
+//# sourceMappingURL=criteria.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"criteria.d.ts","sourceRoot":"","sources":["../../../src/types/criteria.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+/**
+ * Interface for all domain events
+ */
+export interface IDomainEvent {
+    /**
+     * Unique identifier for this event occurrence
+     */
+    readonly eventId: string;
+    /**
+     * When the event occurred
+     */
+    readonly occurredOn: Date;
+    /**
+     * Name/type of the event (e.g., "UserCreated", "OrderPlaced")
+     */
+    readonly eventName: string;
+    /**
+     * ID of the aggregate that raised this event
+     */
+    readonly aggregateId: string;
+}
+/**
+ * Event handler function type
+ */
+export type DomainEventHandler<T extends IDomainEvent = IDomainEvent> = (event: T) => void | Promise<void>;
+/**
+ * Event handler class type
+ */
+export interface IDomainEventHandler<T extends IDomainEvent = IDomainEvent> {
+    handle(event: T): void | Promise<void>;
+}
+//# sourceMappingURL=domain-event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.d.ts","sourceRoot":"","sources":["../../../src/types/domain-event.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,CACtE,KAAK,EAAE,CAAC,KACL,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACxE,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/types/types/domain.d.ts

@@ -0,0 +1,29 @@
+import { Id } from "../id.js";
+import { StandardSchema } from "./standard-schema.js";
+export interface BaseProps {
+    id: Id;
+}
+interface DomainValidation<T> {
+    schema: StandardSchema<T>;
+    config?: ValidationConfig;
+}
+export type EntityValidation<T> = DomainValidation<T>;
+export type VOValidation<T> = DomainValidation<T>;
+export interface VOHooks<T, E> {
+    onBeforeCreate?: (props: T) => void;
+    onCreate?: (entity: E) => void;
+    rules?: (entity: E) => void;
+}
+export interface EntityHooks<T extends BaseProps, E> {
+    onBeforeCreate?: (props: T) => void;
+    onBeforeUpdate?: (entity: E, snapshot: T) => boolean;
+    onCreate?: (entity: E) => void;
+    rules?: (entity: E) => void;
+}
+export interface ValidationConfig {
+    onCreate?: boolean;
+    onUpdate?: boolean;
+    throwOnError?: boolean;
+}
+export {};
+//# sourceMappingURL=domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/types/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,EAAE,CAAC;CACR;AAED,UAAU,gBAAgB,CAAC,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AACtD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAElD,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC;IACjD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB"}

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

@@ -0,0 +1,8 @@
+export * from "./criteria.js";
+export * from "./domain.js";
+export * from "./standard-schema.js";
+export * from "./utils.js";
+export * from "./unit-of-work.js";
+export * from "./domain-event.js";
+export * from "./change-tracker.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/types/types/standard-schema.d.ts

@@ -0,0 +1,15 @@
+export interface StandardSchemaIssue {
+    message: string;
+    path?: ReadonlyArray<unknown>;
+}
+export interface StandardSchemaResult<T> {
+    value?: T;
+    issues?: ReadonlyArray<StandardSchemaIssue>;
+}
+export interface StandardSchemaProps<T> {
+    validate: (value: unknown) => StandardSchemaResult<T> | Promise<StandardSchemaResult<T>>;
+}
+export interface StandardSchema<T = unknown> {
+    "~standard": StandardSchemaProps<T>;
+}
+//# sourceMappingURL=standard-schema.d.ts.map

package/dist/types/types/standard-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standard-schema.d.ts","sourceRoot":"","sources":["../../../src/types/standard-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,MAAM,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,QAAQ,EAAE,CACR,KAAK,EAAE,OAAO,KACX,oBAAoB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;CACrC"}

package/dist/types/types/unit-of-work.d.ts

@@ -0,0 +1,39 @@
+import { Aggregate } from "../entity.js";
+import { Repository } from "../repository/base-repository.js";
+/**
+ * Transaction context for Unit of Work
+ */
+export interface TransactionContext {
+    /**
+     * Commit all changes
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback all changes
+     */
+    rollback(): Promise<void>;
+    /**
+     * Check if transaction is active
+     */
+    isActive(): boolean;
+}
+/**
+ * Unit of Work interface
+ * Manages transactions across multiple repositories
+ */
+export interface IUnitOfWork {
+    /**
+     * Start a new transaction
+     */
+    begin(): Promise<TransactionContext>;
+    /**
+     * Execute work within a transaction
+     * Auto-commits on success, rolls back on error
+     */
+    transaction<T>(work: (ctx: TransactionContext) => Promise<T>): Promise<T>;
+    /**
+     * Get repository within transaction context
+     */
+    getRepository<TDomain extends Aggregate<any>>(repository: new (...args: any[]) => Repository<TDomain>): Repository<TDomain>;
+}
+//# sourceMappingURL=unit-of-work.d.ts.map

package/dist/types/types/unit-of-work.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work.d.ts","sourceRoot":"","sources":["../../../src/types/unit-of-work.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAErC;;;OAGG;IACH,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAE1E;;OAEG;IACH,aAAa,CAAC,OAAO,SAAS,SAAS,CAAC,GAAG,CAAC,EAC1C,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,OAAO,CAAC,GACtD,UAAU,CAAC,OAAO,CAAC,CAAC;CACxB"}

package/dist/types/types/utils.d.ts

@@ -0,0 +1,13 @@
+import { Id } from "../id.js";
+export type DeepJsonResult<T> = {
+    [K in keyof T]: T[K] extends Id ? string : T[K] extends {
+        toJSON(): infer U;
+    } ? U : T[K] extends Array<infer U> ? U extends {
+        toJSON(): infer V;
+    } ? V[] : U extends Id ? string[] : U[] : T[K];
+};
+export type Primitive = string | number | boolean | Date | null | undefined;
+export type UnwrapArray<T> = T extends Array<infer U> ? U : never;
+export type IsArray<T> = T extends Array<any> ? true : false;
+export type NonUndefined<T> = T extends undefined ? never : T;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/types/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,GAC3B,MAAM,GACN,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,IAAI,MAAM,CAAC,CAAA;KAAE,GAClC,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAC3B,CAAC,SAAS;QAAE,MAAM,IAAI,MAAM,CAAC,CAAA;KAAE,GAC7B,CAAC,EAAE,GACH,CAAC,SAAS,EAAE,GACZ,MAAM,EAAE,GACR,CAAC,EAAE,GACL,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAC5E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAClE,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAC7D,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC"}

package/dist/types/utils/criteria-operator-validation.d.ts

@@ -0,0 +1,6 @@
+import { FilterOperator } from "../types/index.js";
+export declare function sanitizeFieldValue(value: unknown, operator: FilterOperator): unknown;
+export declare function isValidOperatorForType(value: unknown, operator: FilterOperator): boolean;
+export declare function getValidOperatorsForType(value: unknown): FilterOperator[];
+export declare function isOperator(value: string): value is FilterOperator;
+//# sourceMappingURL=criteria-operator-validation.d.ts.map

package/dist/types/utils/criteria-operator-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"criteria-operator-validation.d.ts","sourceRoot":"","sources":["../../../src/utils/criteria-operator-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,cAAc,EAGf,MAAM,mBAAmB,CAAC;AAI3B,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,cAAc,GACvB,OAAO,CAsCT;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,cAAc,GACvB,OAAO,CAkFT;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,EAAE,CA8DzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEjE"}

package/dist/types/utils/helpers.d.ts

@@ -0,0 +1,3 @@
+export declare function parseQueryValue(value: string): any;
+export declare function levenshteinDistance(a: string, b: string): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/types/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAKlD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BhE"}

package/dist/types/validation-error.d.ts

@@ -0,0 +1,56 @@
+export interface ValidationIssue {
+    path: string[];
+    message: string;
+}
+export declare class ValidationError extends Error {
+    readonly issues: ValidationIssue[];
+    readonly __isValidationError = true;
+    readonly entityName?: string;
+    constructor(issues: ValidationIssue[], options?: {
+        message?: string;
+        entityName?: string;
+    });
+    private static formatMessage;
+    /**
+     * Check if an error is a ValidationError (works across module boundaries)
+     */
+    static isValidationError(error: unknown): error is ValidationError;
+    /**
+     * Get all error messages as a simple array
+     */
+    getMessages(): string[];
+    /**
+     * Get errors for a specific field path
+     */
+    getErrorsForPath(path: string): ValidationIssue[];
+    /**
+     * Check if a specific path has errors
+     */
+    hasErrorsForPath(path: string): boolean;
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        issues: ValidationIssue[];
+        entityName?: string;
+    };
+    /**
+     * Get a formatted string with all validation errors
+     */
+    getFormattedErrors(): string;
+    /**
+     * Get a summary of the error for logging
+     */
+    getSummary(): string;
+}
+/**
+ * Helper to create a single validation issue
+ */
+export declare function createValidationIssue(path: string | string[], message: string): ValidationIssue;
+/**
+ * Helper to throw a validation error with a single issue
+ */
+export declare function throwValidationError(path: string | string[], message: string): never;
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/types/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/validation-error.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1C,SAAgB,mBAAmB,QAAQ;IAC3C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAY1F,OAAO,CAAC,MAAM,CAAC,aAAa;IAqB5B;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe;IAYlE;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAIjD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAS3F;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAO5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAarB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,eAAe,CAKjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,KAAK,CAEP"}

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

@@ -0,0 +1,96 @@
+import { ValidationError } from "./validation-error.js";
+import { IDomainEvent } from ".";
+import { VOHooks, EntityValidation } from "./types/index.js";
+/**
+ * Identity key type for a Value Object. Can be a single key or an array of keys (composite key).
+ */
+export type IdentityKeyDefinition<T> = (keyof T)[] | keyof T;
+export declare abstract class ValueObject<T> {
+    protected readonly props: T;
+    private validationConfig;
+    private domainHooks?;
+    private domainSchema?;
+    private domainEvents;
+    protected static validation?: EntityValidation<any>;
+    protected static hooks?: VOHooks<any, any>;
+    /**
+     * Identity key for identification in collections.
+     * Used by ChangeTracker to track changes in arrays of Value Objects.
+     *
+     * @example
+     * ```typescript
+     * // Simple key
+     * class TagReference extends ValueObject<{ tagId: string }> {
+     *   static readonly identityKey = 'tagId';
+     * }
+     *
+     * // Composite key
+     * class Like extends ValueObject<{ postId: string; userId: string }> {
+     *   static readonly identityKey = ['postId', 'userId'];
+     * }
+     * ```
+     */
+    protected static identityKey?: IdentityKeyDefinition<any>;
+    constructor(props: T);
+    private validateProps;
+    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;
+    /**
+     * Returns the identity key for this Value Object.
+     * Used for identification in collections when identityKey is set.
+     *
+     * @returns String with the identity key or null if not defined
+     *
+     * @example
+     * ```typescript
+     * const like = new Like({ postId: 'p1', userId: 'u1' });
+     * like.getIdentityKey(); // 'p1:u1'
+     *
+     * const tag = new TagReference({ tagId: 'tag-123' });
+     * tag.getIdentityKey(); // 'tag-123'
+     * ```
+     */
+    getIdentityKey(): string | null;
+    /**
+     * Returns true if this Value Object has an identity key defined.
+     */
+    hasIdentityKey(): boolean;
+    /**
+     * Returns the identity key definition (if any).
+     */
+    static getIdentityKeyDefinition<P>(): IdentityKeyDefinition<P> | undefined;
+    /**
+     * 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;
+    toJSON(): T;
+    /**
+     * Creates a new ValueObject with updated properties.
+     * ValueObjects are immutable, so this returns a new instance.
+     */
+    protected clone(updates: Partial<T>): this;
+}
+//# sourceMappingURL=value-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value-object.d.ts","sourceRoot":"","sources":["../../src/value-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC;AACjC,OAAO,EACL,OAAO,EAGP,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAW1B;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;AAE7D,8BAAsB,WAAW,CAAC,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAG,CAAC,CAAC;IAC7B,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;IAE3C;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAC;gBAE9C,KAAK,EAAE,CAAC;IAyCpB,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;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAiB/B;;OAEG;IACH,cAAc,IAAI,OAAO;IAOzB;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS;IAI1E;;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,MAAM,IAAI,CAAC;IAIX;;;OAGG;IACH,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;CAI3C"}