@woltz/rich-domain 1.3.2 → 1.5.0

package/dist/types/exceptions.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Base exception class for all Rich Domain exceptions
+ */
+declare abstract class DomainException extends Error {
+    readonly code: string;
+    readonly timestamp: Date;
+    readonly __isDomainException = true;
+    constructor(message: string, code?: string);
+    /**
+     * Check if an error is a DomainException
+     */
+    static isDomainException(error: unknown): error is DomainException;
+    /**
+     * Convert to JSON for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a domain rule or business logic is violated
+ */
+export declare class DomainError extends DomainException {
+    constructor(message: string, code?: string);
+}
+/**
+ * Thrown when an entity or aggregate is not found
+ */
+export declare class EntityNotFoundError extends DomainException {
+    readonly entityType: string;
+    readonly entityId?: string;
+    constructor(entityType: string, entityId?: string, message?: string);
+    toJSON(): {
+        entityType: string;
+        entityId: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when trying to create an entity that already exists
+ */
+export declare class EntityAlreadyExistsError extends DomainException {
+    readonly entityType: string;
+    readonly entityId?: string;
+    constructor(entityType: string, entityId?: string, message?: string);
+    toJSON(): {
+        entityType: string;
+        entityId: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Base exception for repository operations
+ */
+export declare class RepositoryError extends DomainException {
+    constructor(message: string, code?: string);
+}
+/**
+ * Thrown when a persistence operation fails
+ */
+export declare class PersistenceError extends RepositoryError {
+    readonly operation: string;
+    readonly cause?: Error;
+    constructor(operation: string, message?: string, cause?: Error);
+    toJSON(): {
+        operation: string;
+        cause: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a concurrency conflict occurs (optimistic locking)
+ */
+export declare class ConcurrencyError extends RepositoryError {
+    readonly entityType: string;
+    readonly entityId: string;
+    constructor(entityType: string, entityId: string, message?: string);
+    toJSON(): {
+        entityType: string;
+        entityId: string;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a database constraint is violated
+ */
+export declare class ConstraintViolationError extends RepositoryError {
+    readonly constraint: string;
+    constructor(constraint: string, message?: string);
+    toJSON(): {
+        constraint: string;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a value object has invalid data
+ */
+export declare class InvalidValueObjectError extends DomainException {
+    readonly valueObjectType: string;
+    readonly invalidValue?: any;
+    constructor(valueObjectType: string, message: string, invalidValue?: any);
+    toJSON(): {
+        valueObjectType: string;
+        invalidValue: any;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a domain event operation fails
+ */
+export declare class DomainEventError extends DomainException {
+    readonly eventType?: string;
+    constructor(message: string, eventType?: string);
+    toJSON(): {
+        eventType: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when an event handler fails
+ */
+export declare class EventHandlerError extends DomainEventError {
+    readonly handlerName: string;
+    readonly cause?: Error;
+    constructor(handlerName: string, eventType: string, cause?: Error);
+    toJSON(): {
+        handlerName: string;
+        cause: string | undefined;
+        eventType: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a criteria or query is invalid
+ */
+export declare class InvalidCriteriaError extends DomainException {
+    readonly field?: string;
+    constructor(message: string, field?: string);
+    toJSON(): {
+        field: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a transaction operation fails
+ */
+export declare class TransactionError extends DomainException {
+    readonly operation: string;
+    readonly cause?: Error;
+    constructor(operation: string, message?: string, cause?: Error);
+    toJSON(): {
+        operation: string;
+        cause: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when an unexpected or unknown error occurs
+ */
+export declare class UnknownError extends DomainException {
+    readonly originalError?: Error;
+    constructor(message?: string, originalError?: Error);
+    toJSON(): {
+        originalError: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a feature is not implemented yet
+ */
+export declare class NotImplementedError extends DomainException {
+    readonly feature: string;
+    constructor(feature: string, message?: string);
+    toJSON(): {
+        feature: string;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when a required configuration is missing
+ */
+export declare class ConfigurationError extends DomainException {
+    readonly configKey?: string;
+    constructor(message: string, configKey?: string);
+    toJSON(): {
+        configKey: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+/**
+ * Thrown when mapping between domain and persistence fails
+ */
+export declare class MapperError extends DomainException {
+    readonly direction: "toDomain" | "toPersistence";
+    readonly entityType: string;
+    readonly cause?: Error;
+    constructor(direction: "toDomain" | "toPersistence", entityType: string, message?: string, cause?: Error);
+    toJSON(): {
+        direction: "toDomain" | "toPersistence";
+        entityType: string;
+        cause: string | undefined;
+        name: string;
+        message: string;
+        code: string;
+        timestamp: string;
+    };
+}
+export {};
+//# sourceMappingURL=exceptions.d.ts.map

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

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

package/dist/types/id.d.ts

@@ -0,0 +1,52 @@
+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;
+}
+//# sourceMappingURL=id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/id.ts"],"names":[],"mappings":"AAMA,qBAAa,EAAE;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IAGjC;;;;;;;;;;;;MAYE;gBACU,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;CAG/B"}

package/dist/types/index.d.ts

@@ -1,8 +1,17 @@
-export * from "./criteria";
-export * from "./domain";
-export * from "./standard-schema";
-export * from "./utils";
-export * from "./unit-of-work";
-export * from "./domain-event";
-export * from "./change-tracker";
+export * from "./validation-error.js";
+export * from "./domain-event.js";
+export * from "./domain-event-bus.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 { DomainEventHandler, EntityHooks, Filter, EntityValidation, IDomainEvent, VOValidation, VOHooks, ValidationConfig, Primitive, TransactionContext, PaginationMeta, Pagination, OrderDirection, Order, IUnitOfWork, IDomainEventHandler, FieldPath, FilterOperator, Search, FilterValueFor, PathValue, OperatorsForType, DateOperators, NumberOperators, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, DeepJsonResult, } 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";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,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,kBAAkB,EAClB,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,mBAAmB,EACnB,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,GACf,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"}

package/dist/types/mapper.d.ts

@@ -0,0 +1,4 @@
+export declare abstract class Mapper<Input, Output> {
+    abstract build(input: Input, ...args: unknown[]): Output | Promise<Output>;
+}
+//# sourceMappingURL=mapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/mapper.ts"],"names":[],"mappings":"AAAA,8BAAsB,MAAM,CAAC,KAAK,EAAE,MAAM;aACxB,KAAK,CACnB,KAAK,EAAE,KAAK,EACZ,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAC5B"}

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

@@ -0,0 +1,62 @@
+import type { Criteria } from "./criteria.js";
+import type { Pagination, PaginationMeta } from "./types/index.js";
+/**
+ * Infers the JSON result type from T
+ * - If T has toJSON(), returns its return type
+ * - Otherwise returns T as-is
+ */
+type InferJsonResult<T> = T extends {
+    toJSON(): infer R;
+} ? R : T;
+/**
+ * Type for the serialized result of PaginatedResult.toJSON()
+ */
+export type PaginatedJsonResult<T> = {
+    data: InferJsonResult<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 → calls toJSON()
+     * - 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;
+}
+export {};
+//# sourceMappingURL=paginated-result.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paginated-result.d.ts","sourceRoot":"","sources":["../../src/paginated-result.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAU,MAAM,kBAAkB,CAAC;AAE3E;;;;GAIG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,IAAI,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,qBAAa,eAAe,CAAC,CAAC;aAEV,IAAI,EAAE,CAAC,EAAE;aACT,IAAI,EAAE,cAAc;gBADpB,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,cAAc;IAGtC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,EACb,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,GACZ,eAAe,CAAC,CAAC,CAAC;IAKrB;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;IAaxE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IA0C1E;;;;;;;;OAQG;IACH,MAAM,IAAI,mBAAmB,CAAC,CAAC,CAAC;IAShC;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAI9C;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;CACF"}

package/dist/types/repository/base-repository.d.ts

@@ -0,0 +1,28 @@
+import type { Aggregate } from "../entity.js";
+import type { Criteria } from "../criteria.js";
+import { PaginatedResult } from "../paginated-result.js";
+import { Mapper } from "../mapper.js";
+export declare abstract class ReadRepository<Agg extends Aggregate<any>> {
+    abstract find(criteria?: Criteria<Agg>): Promise<PaginatedResult<Agg>>;
+    abstract findById(id: string): Promise<Agg | null>;
+    abstract count(criteria?: Criteria<Agg>): Promise<number>;
+    abstract exists(id: string): Promise<boolean>;
+}
+export declare abstract class WriteRepository<Agg extends Aggregate<any>> {
+    abstract save(entity: Agg): Promise<void>;
+    abstract delete(entity: Agg): Promise<void>;
+}
+export declare abstract class WriteAndRead<Agg extends Aggregate<any>> {
+    abstract find(criteria?: Criteria<Agg>): Promise<PaginatedResult<Agg>>;
+    abstract findById(id: string): Promise<Agg | null>;
+    abstract save(entity: Agg): Promise<void>;
+    abstract delete(entity: Agg): Promise<void>;
+    abstract count(criteria?: Criteria<Agg>): Promise<number>;
+    abstract exists(id: string): Promise<boolean>;
+}
+export declare abstract class Repository<TDomain extends Aggregate<any>> extends WriteAndRead<TDomain> {
+    protected abstract readonly toDomainMapper: Mapper<unknown, TDomain>;
+    protected abstract readonly toPersistenceMapper: Mapper<TDomain, unknown>;
+    protected abstract get model(): any;
+}
+//# sourceMappingURL=base-repository.d.ts.map

package/dist/types/repository/base-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-repository.d.ts","sourceRoot":"","sources":["../../../src/repository/base-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,8BAAsB,cAAc,CAAC,GAAG,SAAS,SAAS,CAAC,GAAG,CAAC;IAC7D,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAC9C;AAED,8BAAsB,eAAe,CAAC,GAAG,SAAS,SAAS,CAAC,GAAG,CAAC;IAC9D,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAC5C;AAED,8BAAsB,YAAY,CAAC,GAAG,SAAS,SAAS,CAAC,GAAG,CAAC;IAC3D,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAC9C;AAED,8BAAsB,UAAU,CAC9B,OAAO,SAAS,SAAS,CAAC,GAAG,CAAC,CAC9B,SAAQ,YAAY,CAAC,OAAO,CAAC;IAC7B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1E,SAAS,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC;CACrC"}

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

@@ -0,0 +1,4 @@
+export { Mapper } from "../mapper.js";
+export * from "./base-repository.js";
+export { UnitOfWork, BaseTransactionContext } from "./unit-of-work.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { IUnitOfWork, TransactionContext } from "../types/index.js";
+/**
+ * Abstract Unit of Work
+ * Provides transaction management across multiple repositories
+ */
+export declare abstract class UnitOfWork implements IUnitOfWork {
+    protected currentContext: TransactionContext | null;
+    protected repositoryCache: Map<string, any>;
+    abstract 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 instance (cached per transaction)
+     */
+    getRepository<TRepo>(RepositoryClass: new (...args: any[]) => TRepo): TRepo;
+    /**
+     * Create repository instance - implement in subclass
+     */
+    protected abstract createRepository<TRepo>(RepositoryClass: new (...args: any[]) => TRepo): TRepo;
+}
+/**
+ * Base Transaction Context
+ */
+export declare abstract class BaseTransactionContext implements TransactionContext {
+    protected _isActive: boolean;
+    abstract commit(): Promise<void>;
+    abstract rollback(): Promise<void>;
+    isActive(): boolean;
+    protected markInactive(): void;
+}
+//# sourceMappingURL=unit-of-work.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unit-of-work.d.ts","sourceRoot":"","sources":["../../../src/repository/unit-of-work.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;GAGG;AACH,8BAAsB,UAAW,YAAW,WAAW;IACrD,SAAS,CAAC,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAC3D,SAAS,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IAExD,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAE7C;;;OAGG;IACG,WAAW,CAAC,CAAC,EACjB,IAAI,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,GAAG,KAAK;IAY3E;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EACvC,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,GAC7C,KAAK;CACT;AAED;;GAEG;AACH,8BAAsB,sBAAuB,YAAW,kBAAkB;IACxE,SAAS,CAAC,SAAS,UAAQ;IAE3B,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC,QAAQ,IAAI,OAAO;IAInB,SAAS,CAAC,YAAY,IAAI,IAAI;CAG/B"}