@woltz/rich-domain 1.9.0 → 1.9.1

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

@@ -12,6 +12,9 @@ export declare abstract class DomainEvent<P> implements IDomainEvent<P> {
      * Get the event name (defaults to class name)
      */
     get eventName(): string;
+    /**
+     * Generate a UUID v4
+     */
     private generateEventId;
     toJSON(): {
         eventId: string;

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

@@ -1 +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"}
+{"version":3,"file":"domain-event.d.ts","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGlC;;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;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB,MAAM;;;;;;CAQP"}

package/dist/cjs/core/domain-event.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomainEvent = void 0;
+const crypto_1 = __importDefault(require("../utils/crypto"));
 /**
  * Base class for domain events
  */
@@ -20,8 +24,11 @@ class DomainEvent {
     get eventName() {
         return this.constructor.name;
     }
+    /**
+     * Generate a UUID v4
+     */
     generateEventId() {
-        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        return (0, crypto_1.default)();
     }
     toJSON() {
         return {

package/dist/cjs/core/domain-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAsB,WAAW;IACf,OAAO,CAAS;IAChB,UAAU,CAAO;IACjB,OAAO,CAAI;IAC3B,MAAM,CAAU,SAAS,CAAU;IAEnC,YAAY,OAAU;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAEO,eAAe;QACrB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AA/BD,kCA+BC"}
+{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":";;;;;;AACA,6DAAmC;AAEnC;;GAEG;AACH,MAAsB,WAAW;IACf,OAAO,CAAS;IAChB,UAAU,CAAO;IACjB,OAAO,CAAI;IAC3B,MAAM,CAAU,SAAS,CAAU;IAEnC,YAAY,OAAU;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,OAAO,IAAA,gBAAI,GAAE,CAAC;IAChB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAlCD,kCAkCC"}

package/dist/cjs/criteria.d.ts

@@ -37,7 +37,7 @@ export declare class Criteria<T = any> {
     toJSON(): {
         filters: {
             field: FieldPath<T>;
-            operator: "in" | "notIn" | "isNull" | "isNotNull" | "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "between" | "contains" | "startsWith" | "endsWith";
+            operator: "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "contains" | "startsWith" | "endsWith" | "in" | "notIn" | "between" | "isNull" | "isNotNull";
             value: any;
             options: CriteriaOptions | undefined;
         }[];

package/dist/cjs/index.d.ts

@@ -6,5 +6,5 @@ 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, BatchDeleteOperation, BatchCreateOperation, BatchUpdateOperation, BatchOperations, BatchCreateItem, BatchUpdateItem, BatchDeleteItem, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, IDomainEventBus, } from "./types/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, BatchDeleteOperation, BatchCreateOperation, BatchUpdateOperation, BatchOperations, BatchCreateItem, BatchUpdateItem, BatchDeleteItem, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, IDomainEventBus, IOutboxStore, OutboxEntryData, OutboxFetchResult, OutboxStatus, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/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,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,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,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,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC"}

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

@@ -6,4 +6,5 @@ export * from "./unit-of-work.js";
 export * from "./domain-event.js";
 export * from "./change-tracker.js";
 export * from "./event-bus.js";
+export * from "./outbox-store.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AACpC,cAAc,gBAAgB,CAAC"}
+{"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;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/cjs/types/index.js

@@ -22,4 +22,5 @@ __exportStar(require("./unit-of-work.js"), exports);
 __exportStar(require("./domain-event.js"), exports);
 __exportStar(require("./change-tracker.js"), exports);
 __exportStar(require("./event-bus.js"), exports);
+__exportStar(require("./outbox-store.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,8CAA4B;AAC5B,uDAAqC;AACrC,6CAA2B;AAC3B,oDAAkC;AAClC,oDAAkC;AAClC,sDAAoC;AACpC,iDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,8CAA4B;AAC5B,uDAAqC;AACrC,6CAA2B;AAC3B,oDAAkC;AAClC,oDAAkC;AAClC,sDAAoC;AACpC,iDAA+B;AAC/B,oDAAkC"}

package/dist/cjs/types/outbox-store.d.ts

@@ -0,0 +1,91 @@
+import { IDomainEvent } from "./domain-event.js";
+/**
+ * Possible statuses for an outbox entry.
+ *
+ * - `pending`: The event has been persisted but not yet published.
+ * - `published`: The event has been successfully published to the message broker.
+ * - `failed`: The event failed to publish after the maximum number of retries.
+ */
+export type OutboxStatus = "pending" | "published" | "failed";
+/**
+ * The data shape of a single outbox entry returned by {@link IOutboxStore.fetchPending}.
+ * This is the flat wire format — no class logic, just data.
+ */
+export interface OutboxEntryData {
+    /** The event's own `eventId`, used as the primary key of the outbox table. */
+    id: string;
+    /** The event class name (e.g. `"OrderPlaced"`). */
+    eventName: string;
+    /** The event payload (the `P` generic from `DomainEvent<P>`). */
+    payload: unknown;
+    /** When the domain event was originally created. */
+    occurredOn: Date;
+    /** Current publish status. */
+    status: OutboxStatus;
+    /** Number of publish attempts so far. */
+    retries: number;
+    /** Error message from the most recent failed publish attempt, if any. */
+    lastError: string | null;
+    /** When this outbox row was inserted. */
+    createdAt: Date;
+}
+/**
+ * Result returned by {@link IOutboxStore.fetchPending}.
+ */
+export interface OutboxFetchResult {
+    entries: OutboxEntryData[];
+}
+/**
+ * Minimal, framework-agnostic contract for an outbox persistence store.
+ *
+ * Implementations exist for Prisma, Drizzle, TypeORM, and raw SQL.
+ * The interface lives in `@woltz/rich-domain` (core) so that the
+ * `@woltz/rich-domain-outbox` package can depend on it without
+ * coupling to any specific ORM or database.
+ */
+export interface IOutboxStore {
+    /**
+     * Persist one or more domain events to the outbox table.
+     *
+     * MUST be called within the same database transaction as the aggregate write
+     * so that both succeed or both roll back together.
+     *
+     * Each event's `eventId` becomes the primary key (`id`) of the outbox row.
+     * The `status` column is always set to `"pending"` initially.
+     *
+     * @param events  - The domain events to persist.
+     * @param tx      - Optional ORM-specific transaction context (e.g. a Prisma interactive tx client, a Drizzle tx, or a TypeORM EntityManager).
+     */
+    save(events: IDomainEvent[], tx?: unknown): Promise<void>;
+    /**
+     * Fetch a batch of events whose status is still `"pending"`.
+     * Entries are returned in insertion order (oldest first) so that
+     * earlier events are retried before later ones.
+     *
+     * The publisher calls this periodically and attempts to publish each entry.
+     * On success it calls {@link markPublished}; on failure it calls {@link markFailed}.
+     *
+     * @param batchSize - Maximum number of entries to return. Default 50.
+     * @returns A result object containing the matching entries.
+     */
+    fetchPending(batchSize?: number): Promise<OutboxFetchResult>;
+    /**
+     * Mark an outbox entry as successfully published.
+     *
+     * Mapping: `UPDATE outbox SET status = 'published' WHERE id = :eventId`
+     *
+     * @param id - The event's `eventId` (same value used as the outbox primary key).
+     */
+    markPublished(id: string): Promise<void>;
+    /**
+     * Mark an outbox entry as failed, incrementing its retry counter
+     * and recording the error that caused the failure.
+     *
+     * Mapping: `UPDATE outbox SET status = 'failed', retries = retries + 1, lastError = :error WHERE id = :eventId`
+     *
+     * @param id    - The event's `eventId`.
+     * @param error - The error message.
+     */
+    markFailed(id: string, error: string): Promise<void>;
+}
+//# sourceMappingURL=outbox-store.d.ts.map

package/dist/cjs/types/outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.d.ts","sourceRoot":"","sources":["../../../src/types/outbox-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,UAAU,EAAE,IAAI,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}

package/dist/cjs/types/outbox-store.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=outbox-store.js.map

package/dist/cjs/types/outbox-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.js","sourceRoot":"","sources":["../../../src/types/outbox-store.ts"],"names":[],"mappings":""}

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

@@ -12,6 +12,9 @@ export declare abstract class DomainEvent<P> implements IDomainEvent<P> {
      * Get the event name (defaults to class name)
      */
     get eventName(): string;
+    /**
+     * Generate a UUID v4
+     */
     private generateEventId;
     toJSON(): {
         eventId: string;

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

@@ -1 +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"}
+{"version":3,"file":"domain-event.d.ts","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAGlC;;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;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB,MAAM;;;;;;CAQP"}

package/dist/esm/core/domain-event.js

@@ -1,3 +1,4 @@
+import UUID from "../utils/crypto";
 /**
  * Base class for domain events
  */
@@ -17,8 +18,11 @@ export class DomainEvent {
     get eventName() {
         return this.constructor.name;
     }
+    /**
+     * Generate a UUID v4
+     */
     generateEventId() {
-        return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        return UUID();
     }
     toJSON() {
         return {

package/dist/esm/core/domain-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAgB,WAAW;IACf,OAAO,CAAS;IAChB,UAAU,CAAO;IACjB,OAAO,CAAI;IAC3B,MAAM,CAAU,SAAS,CAAU;IAEnC,YAAY,OAAU;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAEO,eAAe;QACrB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACpE,CAAC;IAED,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/core/domain-event.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,iBAAiB,CAAC;AAEnC;;GAEG;AACH,MAAM,OAAgB,WAAW;IACf,OAAO,CAAS;IAChB,UAAU,CAAO;IACjB,OAAO,CAAI;IAC3B,MAAM,CAAU,SAAS,CAAU;IAEnC,YAAY,OAAU;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,eAAe;QACrB,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/criteria.d.ts

@@ -37,7 +37,7 @@ export declare class Criteria<T = any> {
     toJSON(): {
         filters: {
             field: FieldPath<T>;
-            operator: "in" | "notIn" | "isNull" | "isNotNull" | "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "between" | "contains" | "startsWith" | "endsWith";
+            operator: "equals" | "notEquals" | "greaterThan" | "greaterThanOrEqual" | "lessThan" | "lessThanOrEqual" | "contains" | "startsWith" | "endsWith" | "in" | "notIn" | "between" | "isNull" | "isNotNull";
             value: any;
             options: CriteriaOptions | undefined;
         }[];

package/dist/esm/index.d.ts

@@ -6,5 +6,5 @@ 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, BatchDeleteOperation, BatchCreateOperation, BatchUpdateOperation, BatchOperations, BatchCreateItem, BatchUpdateItem, BatchDeleteItem, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, IDomainEventBus, } from "./types/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, BatchDeleteOperation, BatchCreateOperation, BatchUpdateOperation, BatchOperations, BatchCreateItem, BatchUpdateItem, BatchDeleteItem, StringOperators, BooleanOperators, ArrayOperators, CriteriaOptions, IDomainEventBus, IOutboxStore, OutboxEntryData, OutboxFetchResult, OutboxStatus, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/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,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,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,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,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC"}

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

@@ -6,4 +6,5 @@ export * from "./unit-of-work.js";
 export * from "./domain-event.js";
 export * from "./change-tracker.js";
 export * from "./event-bus.js";
+export * from "./outbox-store.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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;AACpC,cAAc,gBAAgB,CAAC"}
+{"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;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/esm/types/index.js

@@ -6,4 +6,5 @@ export * from "./unit-of-work.js";
 export * from "./domain-event.js";
 export * from "./change-tracker.js";
 export * from "./event-bus.js";
+export * from "./outbox-store.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","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;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/esm/types/outbox-store.d.ts

@@ -0,0 +1,91 @@
+import { IDomainEvent } from "./domain-event.js";
+/**
+ * Possible statuses for an outbox entry.
+ *
+ * - `pending`: The event has been persisted but not yet published.
+ * - `published`: The event has been successfully published to the message broker.
+ * - `failed`: The event failed to publish after the maximum number of retries.
+ */
+export type OutboxStatus = "pending" | "published" | "failed";
+/**
+ * The data shape of a single outbox entry returned by {@link IOutboxStore.fetchPending}.
+ * This is the flat wire format — no class logic, just data.
+ */
+export interface OutboxEntryData {
+    /** The event's own `eventId`, used as the primary key of the outbox table. */
+    id: string;
+    /** The event class name (e.g. `"OrderPlaced"`). */
+    eventName: string;
+    /** The event payload (the `P` generic from `DomainEvent<P>`). */
+    payload: unknown;
+    /** When the domain event was originally created. */
+    occurredOn: Date;
+    /** Current publish status. */
+    status: OutboxStatus;
+    /** Number of publish attempts so far. */
+    retries: number;
+    /** Error message from the most recent failed publish attempt, if any. */
+    lastError: string | null;
+    /** When this outbox row was inserted. */
+    createdAt: Date;
+}
+/**
+ * Result returned by {@link IOutboxStore.fetchPending}.
+ */
+export interface OutboxFetchResult {
+    entries: OutboxEntryData[];
+}
+/**
+ * Minimal, framework-agnostic contract for an outbox persistence store.
+ *
+ * Implementations exist for Prisma, Drizzle, TypeORM, and raw SQL.
+ * The interface lives in `@woltz/rich-domain` (core) so that the
+ * `@woltz/rich-domain-outbox` package can depend on it without
+ * coupling to any specific ORM or database.
+ */
+export interface IOutboxStore {
+    /**
+     * Persist one or more domain events to the outbox table.
+     *
+     * MUST be called within the same database transaction as the aggregate write
+     * so that both succeed or both roll back together.
+     *
+     * Each event's `eventId` becomes the primary key (`id`) of the outbox row.
+     * The `status` column is always set to `"pending"` initially.
+     *
+     * @param events  - The domain events to persist.
+     * @param tx      - Optional ORM-specific transaction context (e.g. a Prisma interactive tx client, a Drizzle tx, or a TypeORM EntityManager).
+     */
+    save(events: IDomainEvent[], tx?: unknown): Promise<void>;
+    /**
+     * Fetch a batch of events whose status is still `"pending"`.
+     * Entries are returned in insertion order (oldest first) so that
+     * earlier events are retried before later ones.
+     *
+     * The publisher calls this periodically and attempts to publish each entry.
+     * On success it calls {@link markPublished}; on failure it calls {@link markFailed}.
+     *
+     * @param batchSize - Maximum number of entries to return. Default 50.
+     * @returns A result object containing the matching entries.
+     */
+    fetchPending(batchSize?: number): Promise<OutboxFetchResult>;
+    /**
+     * Mark an outbox entry as successfully published.
+     *
+     * Mapping: `UPDATE outbox SET status = 'published' WHERE id = :eventId`
+     *
+     * @param id - The event's `eventId` (same value used as the outbox primary key).
+     */
+    markPublished(id: string): Promise<void>;
+    /**
+     * Mark an outbox entry as failed, incrementing its retry counter
+     * and recording the error that caused the failure.
+     *
+     * Mapping: `UPDATE outbox SET status = 'failed', retries = retries + 1, lastError = :error WHERE id = :eventId`
+     *
+     * @param id    - The event's `eventId`.
+     * @param error - The error message.
+     */
+    markFailed(id: string, error: string): Promise<void>;
+}
+//# sourceMappingURL=outbox-store.d.ts.map

package/dist/esm/types/outbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.d.ts","sourceRoot":"","sources":["../../../src/types/outbox-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,UAAU,EAAE,IAAI,CAAC;IACjB,8BAA8B;IAC9B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}

package/dist/esm/types/outbox-store.js

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

package/dist/esm/types/outbox-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store.js","sourceRoot":"","sources":["../../../src/types/outbox-store.ts"],"names":[],"mappings":""}