@hexaijs/core 0.4.0 → 0.5.1

package/README.md

@@ -51,6 +51,84 @@ command.getPayload();        // the typed payload object
 
 Every message automatically receives headers including a unique ID and timestamp. The `type` static property follows the convention `"bounded-context.message-name"`.
 
+#### MessageOptions
+
+The constructor accepts an optional `MessageOptions` object for passing custom headers:
+
+```typescript
+interface MessageOptions {
+    headers?: Record<string, unknown>;
+}
+
+// Pass custom headers
+const command = new CreateOrderCommand(
+    { customerId: "customer-123", items: [] },
+    { headers: { correlationId: "corr-abc" } }
+);
+```
+
+#### Serialization
+
+Messages provide two serialization methods:
+
+```typescript
+// toJSON() - preserves Date objects, suitable for structured output
+const json = command.toJSON();
+// { headers: { id, type, createdAt: Date, ... }, payload: { ... } }
+
+// serialize() - fully serialized plain object (dates become strings)
+const plain = command.serialize();
+// { headers: { id, type, createdAt: "2026-...", ... }, payload: { ... } }
+
+// JSON.stringify uses toJSON() automatically
+JSON.stringify(command);
+```
+
+Override `serializePayload()` to customize how the payload is serialized:
+
+```typescript
+class MyEvent extends DomainEvent<{ date: Temporal.PlainDate }> {
+    protected serializePayload(payload: { date: Temporal.PlainDate }) {
+        return { date: payload.date.toString() };
+    }
+}
+```
+
+#### Deserialization
+
+Use the static `from()` method to reconstruct a message from serialized data:
+
+```typescript
+const raw = { customerId: "c-123", items: [] };
+const headers = { id: "msg-1", type: "order.create-order", createdAt: "2026-01-01T00:00:00Z" };
+
+const command = CreateOrderCommand.from(raw, headers);
+```
+
+Override `deserializeRawPayload()` for custom deserialization:
+
+```typescript
+class MyEvent extends DomainEvent<{ date: Temporal.PlainDate }> {
+    protected static deserializeRawPayload(raw: any) {
+        return { date: Temporal.PlainDate.from(raw.date) };
+    }
+}
+```
+
+#### Fluent Header API
+
+Use `withHeader()` to create a new message instance with an additional header:
+
+```typescript
+const command = new CreateOrderCommand({ customerId: "c-123", items: [] })
+    .withHeader("correlationId", "corr-abc")
+    .withHeader("source", "api-gateway");
+
+command.getHeader("correlationId"); // "corr-abc"
+```
+
+`withHeader()` returns a new immutable instance - the original message is not modified.
+
 ### DomainEvent
 
 `DomainEvent` extends `Message` for events that represent something that happened in your domain.
@@ -257,6 +335,7 @@ throw new DuplicateObjectError("Order with this ID already exists");
 | Export | Description |
 |--------|-------------|
 | `Message<P>` | Base message class with headers and typed payload |
+| `MessageOptions` | Options for Message constructor (`{ headers? }`) |
 | `DomainEvent<P>` | Message subclass for domain events |
 | `AggregateRoot<T>` | Base class for aggregates with event collection |
 | `Id<T>` | Value object for typed identities |

package/dist/{message.d.ts → event-store-DQXtakLF.d.ts}

@@ -1,5 +1,5 @@
 type Version = string | number | undefined;
-export interface MessageHeaders {
+interface MessageHeaders {
     id: string;
     type: string;
     intent?: string;
@@ -11,7 +11,10 @@ type ExtraHeaderField = Exclude<keyof MessageHeaders, "id" | "type" | "intent" |
 type RawMessageHeaders = Omit<MessageHeaders, "createdAt"> & {
     createdAt: string | Date;
 };
-export declare class Message<Payload = any> {
+interface MessageOptions {
+    headers?: Record<string, unknown>;
+}
+declare class Message<Payload = any> {
     protected readonly payload: Payload;
     protected headers: MessageHeaders;
     static getSchemaVersion(): Version;
@@ -21,10 +24,11 @@ export declare class Message<Payload = any> {
     static from(rawPayload: Record<string, unknown>, headers?: RawMessageHeaders): Message;
     protected static deserializeRawPayload(rawPayload: any): any;
     protected static deserializeRawHeaders(headers: RawMessageHeaders): MessageHeaders;
-    constructor(payload: Payload, headers?: Record<string, unknown>);
+    constructor(payload: Payload, options?: MessageOptions);
     protected static mergeHeaders(headers: Record<string, unknown>): MessageHeaders;
     withHeader(field: ExtraHeaderField, value: unknown): this;
     protected clone(): this;
+    protected cloneWithHeaders(headers: Record<string, unknown>): this;
     getHeader<T = string>(field: string): T | undefined;
     getHeaders(): MessageHeaders;
     getPayload(): Payload;
@@ -33,22 +37,37 @@ export declare class Message<Payload = any> {
     getSchemaVersion(): Version | undefined;
     getTimestamp(): Date;
     getIntent(): string | undefined;
+    toJSON(): {
+        headers: MessageHeaders;
+        payload: unknown;
+    };
     serialize(): {
         headers: MessageHeaders;
         payload: Record<string, unknown>;
     };
-    private doSerialize;
     protected serializePayload(payload: Payload): unknown;
     asType<M extends MessageClass>(cls: M): InstanceType<M>;
 }
-export type AnyMessage = Message;
-export type MessageClass<T extends Message = Message> = {
+type AnyMessage = Message;
+type MessageClass<T extends Message = Message> = {
     getSchemaVersion(): Version;
     getType(): string;
     getIntent(): string | undefined;
     from: (rawPayload: any, header?: MessageHeaders) => T;
     new (...args: any[]): T;
 };
-export type PayloadOf<M> = M extends Message<infer P> ? P : never;
-export {};
-//# sourceMappingURL=message.d.ts.map
+type PayloadOf<M> = M extends Message<infer P> ? P : never;
+
+interface StoredEvent {
+    position: number;
+    event: Message;
+}
+interface EventStoreFetchResult {
+    events: StoredEvent[];
+    lastPosition: number;
+}
+interface EventStore {
+    fetch(afterPosition: number, limit?: number): Promise<EventStoreFetchResult>;
+}
+
+export { type AnyMessage as A, type EventStore as E, Message as M, type PayloadOf as P, type StoredEvent as S, type EventStoreFetchResult as a, type MessageClass as b, type MessageHeaders as c, type MessageOptions as d };

package/dist/index.d.ts

@@ -1,5 +1,67 @@
-export * from "./domain";
-export * from "./unit-of-work";
-export * from "./message";
-export * from "./event-store";
-//# sourceMappingURL=index.d.ts.map
+import { M as Message } from './event-store-DQXtakLF.js';
+export { A as AnyMessage, E as EventStore, a as EventStoreFetchResult, b as MessageClass, c as MessageHeaders, d as MessageOptions, P as PayloadOf, S as StoredEvent } from './event-store-DQXtakLF.js';
+
+declare class DomainEvent<P extends Record<string, any> = Record<string, unknown>> extends Message<P> {
+    static getIntent(): string;
+}
+
+declare class Id<T extends string | number> {
+    private readonly value;
+    constructor(value: T);
+    getValue(): T;
+    equals(other: Id<T>): boolean;
+}
+type IdOf<T> = T extends Identifiable<infer Id> ? Id : never;
+interface Identifiable<T extends Id<string | number> = Id<string>> {
+    getId(): T;
+}
+
+declare class AggregateRoot<T extends Id<string | number>> implements Identifiable<T> {
+    protected readonly id: T;
+    protected events: DomainEvent[];
+    constructor(id: T);
+    getId(): T;
+    protected raise(event: DomainEvent): void;
+    getEventsOccurred(): DomainEvent[];
+}
+
+declare class DomainError extends Error {
+}
+declare class InvariantNotSatisfiedError extends DomainError {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
+declare class ValidationError extends InvariantNotSatisfiedError {
+    readonly field: string;
+    constructor(field: string, code: string, message?: string);
+}
+
+interface Repository<T extends Identifiable<any>> {
+    get(id: IdOf<T>): Promise<T>;
+    add(entity: T): Promise<void>;
+    update(entity: T): Promise<void>;
+}
+declare class RepositoryError extends Error {
+    constructor(message: string);
+}
+declare class DuplicateObjectError extends RepositoryError {
+    constructor(message: string);
+}
+declare class ObjectNotFoundError extends RepositoryError {
+    constructor(message: string);
+}
+
+declare enum Propagation {
+    NEW = "new",
+    EXISTING = "existing",
+    NESTED = "nested"
+}
+interface BaseUnitOfWorkOptions {
+    propagation: Propagation;
+}
+interface UnitOfWork<Client = unknown, Options extends BaseUnitOfWorkOptions = BaseUnitOfWorkOptions> {
+    getClient(): Client;
+    wrap<T>(fn: (client: Client) => Promise<T>, options?: Partial<Options>): Promise<T>;
+}
+
+export { AggregateRoot, type BaseUnitOfWorkOptions, DomainError, DomainEvent, DuplicateObjectError, Id, type IdOf, type Identifiable, InvariantNotSatisfiedError, Message, ObjectNotFoundError, Propagation, type Repository, RepositoryError, type UnitOfWork, ValidationError };

package/dist/index.js

@@ -1,21 +1,214 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+import { v4 } from 'uuid';
+
+// src/domain/aggregate-root.ts
+var AggregateRoot = class {
+  constructor(id) {
+    this.id = id;
+  }
+  events = [];
+  getId() {
+    return this.id;
+  }
+  raise(event) {
+    this.events.push(event);
+  }
+  getEventsOccurred() {
+    return [...this.events];
+  }
+};
+
+// src/domain/domain-error.ts
+var DomainError = class extends Error {
+};
+var InvariantNotSatisfiedError = class extends DomainError {
+  constructor(code, message = "") {
+    super(message);
+    this.code = code;
+    this.name = "InvariantNotSatisfiedError";
+  }
+};
+var ValidationError = class extends InvariantNotSatisfiedError {
+  constructor(field, code, message = "") {
+    super(code, message);
+    this.field = field;
+    this.name = "ValidationError";
+  }
+};
+var Message = class {
+  constructor(payload, options) {
+    this.payload = payload;
+    this.headers = Object.freeze(
+      this.constructor.mergeHeaders(options?.headers ?? {})
+    );
+    if (payload && typeof payload === "object") {
+      Object.freeze(payload);
+    }
+  }
+  headers;
+  static getSchemaVersion() {
+    return this.schemaVersion ?? void 0;
+  }
+  static getType() {
+    return this.type ?? this.name;
+  }
+  static getIntent() {
+    return this.intent ?? void 0;
+  }
+  static newHeaders(...excludes) {
+    return generateHeaderFor(this, ...excludes);
+  }
+  static from(rawPayload, headers) {
+    const payload = this.deserializeRawPayload(rawPayload);
+    return new this(payload, {
+      headers: headers ? this.deserializeRawHeaders(headers) : this.newHeaders()
+    });
+  }
+  static deserializeRawPayload(rawPayload) {
+    return rawPayload;
+  }
+  static deserializeRawHeaders(headers) {
+    headers.createdAt = new Date(headers.createdAt);
+    return headers;
+  }
+  static mergeHeaders(headers) {
+    return {
+      ...this.newHeaders(...Object.keys(headers)),
+      ...headers
+    };
+  }
+  withHeader(field, value) {
+    const newHeaders = { ...this.headers, [field]: value };
+    return this.cloneWithHeaders(newHeaders);
+  }
+  clone() {
+    const cloned = Object.create(Object.getPrototypeOf(this));
+    Object.assign(cloned, this);
+    return cloned;
+  }
+  cloneWithHeaders(headers) {
+    const cloned = this.clone();
+    Object.defineProperty(cloned, "headers", {
+      value: Object.freeze(headers),
+      writable: false,
+      configurable: true
+    });
+    return cloned;
+  }
+  getHeader(field) {
+    return this.headers[field];
+  }
+  getHeaders() {
+    return Object.freeze({ ...this.headers });
+  }
+  getPayload() {
+    return this.payload;
+  }
+  getMessageId() {
+    return this.headers.id;
+  }
+  getMessageType() {
+    return this.headers.type;
+  }
+  getSchemaVersion() {
+    return this.headers.schemaVersion;
+  }
+  getTimestamp() {
+    return this.headers.createdAt;
+  }
+  getIntent() {
+    return this.constructor.getIntent();
+  }
+  toJSON() {
+    return {
+      headers: { ...this.headers },
+      payload: this.serializePayload(this.payload)
+    };
+  }
+  serialize() {
+    return JSON.parse(JSON.stringify(this.toJSON()));
+  }
+  serializePayload(payload) {
+    return payload;
+  }
+  asType(cls) {
+    const { headers, payload } = this.serialize();
+    return cls.from(payload, headers);
+  }
+};
+function generateHeaderFor(cls, ...excludes) {
+  const headers = {};
+  if (!excludes.includes("id")) {
+    headers.id = v4();
+  }
+  if (!excludes.includes("type")) {
+    headers.type = cls.getType();
+  }
+  if (!excludes.includes("intent")) {
+    const intent = cls.getIntent();
+    if (intent !== void 0) {
+      headers.intent = intent;
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./domain"), exports);
-__exportStar(require("./unit-of-work"), exports);
-__exportStar(require("./message"), exports);
-__exportStar(require("./event-store"), exports);
+  }
+  if (!excludes.includes("schemaVersion")) {
+    const schemaVersion = cls.getSchemaVersion();
+    if (schemaVersion !== void 0) {
+      headers.schemaVersion = schemaVersion;
+    }
+  }
+  if (!excludes.includes("createdAt")) {
+    headers.createdAt = /* @__PURE__ */ new Date();
+  }
+  return headers;
+}
+
+// src/domain/domain-event.ts
+var DomainEvent = class extends Message {
+  static getIntent() {
+    return "event";
+  }
+};
+
+// src/domain/identifiable.ts
+var Id = class {
+  constructor(value) {
+    this.value = value;
+  }
+  getValue() {
+    return this.value;
+  }
+  equals(other) {
+    return this.constructor === other.constructor && this.getValue() === other.getValue();
+  }
+};
+
+// src/domain/repository.ts
+var RepositoryError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "RepositoryError";
+  }
+};
+var DuplicateObjectError = class extends RepositoryError {
+  constructor(message) {
+    super(message);
+    this.name = "DuplicateObjectError";
+  }
+};
+var ObjectNotFoundError = class extends RepositoryError {
+  constructor(message) {
+    super(message);
+    this.name = "ObjectNotFoundError";
+  }
+};
+
+// src/unit-of-work.ts
+var Propagation = /* @__PURE__ */ ((Propagation2) => {
+  Propagation2["NEW"] = "new";
+  Propagation2["EXISTING"] = "existing";
+  Propagation2["NESTED"] = "nested";
+  return Propagation2;
+})(Propagation || {});
+
+export { AggregateRoot, DomainError, DomainEvent, DuplicateObjectError, Id, InvariantNotSatisfiedError, Message, ObjectNotFoundError, Propagation, RepositoryError, ValidationError };
+//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,iDAA+B;AAC/B,4CAA0B;AAC1B,gDAA8B"}
+{"version":3,"sources":["../src/domain/aggregate-root.ts","../src/domain/domain-error.ts","../src/message.ts","../src/domain/domain-event.ts","../src/domain/identifiable.ts","../src/domain/repository.ts","../src/unit-of-work.ts"],"names":["uuid","Propagation"],"mappings":"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","file":"index.js","sourcesContent":["import { DomainEvent } from \"./domain-event\";\nimport { Id, Identifiable } from \"./identifiable\";\n\nexport class AggregateRoot<T extends Id<string | number>>\n    implements Identifiable<T>\n{\n    protected events: DomainEvent[] = [];\n\n    constructor(protected readonly id: T) {}\n\n    public getId(): T {\n        return this.id;\n    }\n\n    protected raise(event: DomainEvent): void {\n        this.events.push(event);\n    }\n\n    public getEventsOccurred(): DomainEvent[] {\n        return [...this.events];\n    }\n}\n","export class DomainError extends Error {}\n\nexport class InvariantNotSatisfiedError extends DomainError {\n    constructor(\n        public readonly code: string,\n        message: string = \"\"\n    ) {\n        super(message);\n        this.name = \"InvariantNotSatisfiedError\";\n    }\n}\n\nexport class ValidationError extends InvariantNotSatisfiedError {\n    constructor(\n        public readonly field: string,\n        code: string,\n        message: string = \"\"\n    ) {\n        super(code, message);\n\n        this.name = \"ValidationError\";\n    }\n}\n","import { v4 as uuid } from \"uuid\";\n\ntype Version = string | number | undefined;\n\nexport interface MessageHeaders {\n    id: string;\n    type: string;\n    intent?: string;\n    schemaVersion?: Version;\n    createdAt: Date;\n\n    [key: string]: unknown;\n}\n\ntype ExtraHeaderField = Exclude<\n    keyof MessageHeaders,\n    \"id\" | \"type\" | \"intent\" | \"schemaVersion\" | \"createdAt\"\n>;\n\ntype RawMessageHeaders = Omit<MessageHeaders, \"createdAt\"> & {\n    createdAt: string | Date;\n};\n\nexport interface MessageOptions {\n    headers?: Record<string, unknown>;\n}\n\nexport class Message<Payload = any> {\n    protected headers!: MessageHeaders;\n\n    public static getSchemaVersion(): Version {\n        return (this as any).schemaVersion ?? undefined;\n    }\n\n    public static getType(): string {\n        return (this as any).type ?? this.name;\n    }\n\n    public static getIntent(): string | undefined {\n        return (this as any).intent ?? undefined;\n    }\n\n    protected static newHeaders(...excludes: string[]): MessageHeaders {\n        return generateHeaderFor(this as any, ...excludes);\n    }\n\n    public static from(\n        rawPayload: Record<string, unknown>,\n        headers?: RawMessageHeaders\n    ): Message {\n        const payload = this.deserializeRawPayload(rawPayload);\n        return new this(payload, {\n            headers: headers\n                ? this.deserializeRawHeaders(headers)\n                : this.newHeaders(),\n        });\n    }\n\n    protected static deserializeRawPayload(rawPayload: any): any {\n        return rawPayload;\n    }\n\n    protected static deserializeRawHeaders(\n        headers: RawMessageHeaders\n    ): MessageHeaders {\n        headers.createdAt = new Date(headers.createdAt);\n\n        return headers as MessageHeaders;\n    }\n\n    constructor(\n        protected readonly payload: Payload,\n        options?: MessageOptions\n    ) {\n        this.headers = Object.freeze(\n            (this.constructor as any).mergeHeaders(options?.headers ?? {})\n        );\n\n        if (payload && typeof payload === \"object\") {\n            Object.freeze(payload);\n        }\n    }\n\n    protected static mergeHeaders(\n        headers: Record<string, unknown>\n    ): MessageHeaders {\n        return {\n            ...this.newHeaders(...Object.keys(headers)),\n            ...headers,\n        };\n    }\n\n    public withHeader(field: ExtraHeaderField, value: unknown): this {\n        const newHeaders = { ...this.headers, [field]: value };\n        return this.cloneWithHeaders(newHeaders);\n    }\n\n    protected clone(): this {\n        const cloned = Object.create(Object.getPrototypeOf(this));\n        Object.assign(cloned, this);\n        return cloned;\n    }\n\n    protected cloneWithHeaders(headers: Record<string, unknown>): this {\n        const cloned = this.clone();\n        Object.defineProperty(cloned, \"headers\", {\n            value: Object.freeze(headers),\n            writable: false,\n            configurable: true,\n        });\n        return cloned;\n    }\n\n    public getHeader<T = string>(field: string): T | undefined {\n        return this.headers[field] as any;\n    }\n\n    public getHeaders(): MessageHeaders {\n        return Object.freeze({ ...this.headers });\n    }\n\n    public getPayload(): Payload {\n        return this.payload;\n    }\n\n    public getMessageId(): string {\n        return this.headers.id;\n    }\n\n    public getMessageType(): string {\n        return this.headers.type;\n    }\n\n    public getSchemaVersion(): Version | undefined {\n        return this.headers.schemaVersion;\n    }\n\n    public getTimestamp(): Date {\n        return this.headers.createdAt;\n    }\n\n    public getIntent(): string | undefined {\n        return (this.constructor as MessageClass).getIntent();\n    }\n\n    public toJSON(): {\n        headers: MessageHeaders;\n        payload: unknown;\n    } {\n        return {\n            headers: { ...this.headers },\n            payload: this.serializePayload(this.payload),\n        };\n    }\n\n    public serialize(): {\n        headers: MessageHeaders;\n        payload: Record<string, unknown>;\n    } {\n        return JSON.parse(JSON.stringify(this.toJSON()));\n    }\n\n    protected serializePayload(payload: Payload): unknown {\n        return payload;\n    }\n\n    public asType<M extends MessageClass>(cls: M): InstanceType<M> {\n        const { headers, payload } = this.serialize();\n        return cls.from(payload, headers) as InstanceType<M>;\n    }\n}\n\nexport type AnyMessage = Message;\n\nexport type MessageClass<T extends Message = Message> = {\n    getSchemaVersion(): Version;\n    getType(): string;\n    getIntent(): string | undefined;\n    from: (rawPayload: any, header?: MessageHeaders) => T;\n    new (...args: any[]): T;\n};\n\nfunction generateHeaderFor(\n    cls: MessageClass,\n    ...excludes: string[]\n): MessageHeaders {\n    const headers: Partial<MessageHeaders> = {};\n\n    if (!excludes.includes(\"id\")) {\n        headers.id = uuid();\n    }\n\n    if (!excludes.includes(\"type\")) {\n        headers.type = cls.getType();\n    }\n\n    if (!excludes.includes(\"intent\")) {\n        const intent = cls.getIntent();\n        if (intent !== undefined) {\n            headers.intent = intent;\n        }\n    }\n\n    if (!excludes.includes(\"schemaVersion\")) {\n        const schemaVersion = cls.getSchemaVersion();\n        if (schemaVersion !== undefined) {\n            headers.schemaVersion = schemaVersion;\n        }\n    }\n\n    if (!excludes.includes(\"createdAt\")) {\n        headers.createdAt = new Date();\n    }\n\n    return headers as MessageHeaders;\n}\n\nexport type PayloadOf<M> = M extends Message<infer P> ? P : never;\n","import { Message } from \"@/message\";\n\nexport class DomainEvent<\n    P extends Record<string, any> = Record<string, unknown>,\n> extends Message<P> {\n    static override getIntent() {\n        return \"event\";\n    }\n}\n","export class Id<T extends string | number> {\n    public constructor(private readonly value: T) {}\n\n    public getValue(): T {\n        return this.value;\n    }\n\n    public equals(other: Id<T>): boolean {\n        return (\n            this.constructor === other.constructor &&\n            this.getValue() === other.getValue()\n        );\n    }\n}\n\nexport type IdOf<T> = T extends Identifiable<infer Id> ? Id : never;\n\nexport interface Identifiable<T extends Id<string | number> = Id<string>> {\n    getId(): T;\n}\n","import { Identifiable, IdOf } from \"./identifiable\";\n\nexport interface Repository<T extends Identifiable<any>> {\n    get(id: IdOf<T>): Promise<T>;\n    add(entity: T): Promise<void>;\n    update(entity: T): Promise<void>;\n}\n\nexport class RepositoryError extends Error {\n    constructor(message: string) {\n        super(message);\n        this.name = \"RepositoryError\";\n    }\n}\n\nexport class DuplicateObjectError extends RepositoryError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"DuplicateObjectError\";\n    }\n}\n\nexport class ObjectNotFoundError extends RepositoryError {\n    constructor(message: string) {\n        super(message);\n        this.name = \"ObjectNotFoundError\";\n    }\n}\n","export enum Propagation {\n    NEW = \"new\",\n    EXISTING = \"existing\",\n    NESTED = \"nested\",\n}\n\nexport interface BaseUnitOfWorkOptions {\n    propagation: Propagation;\n}\n\nexport interface UnitOfWork<\n    Client = unknown,\n    Options extends BaseUnitOfWorkOptions = BaseUnitOfWorkOptions,\n> {\n    getClient(): Client;\n    wrap<T>(\n        fn: (client: Client) => Promise<T>,\n        options?: Partial<Options>\n    ): Promise<T>;\n}\n\n"]}

package/dist/test/index.d.ts

@@ -1,7 +1,38 @@
-export * as matchers from "./matchers";
-export * from "./matchers";
-export * from "./dummy-message";
-export { setExpect } from "./expect";
-export * from "./utils";
-export * from "./in-memory-event-store";
-//# sourceMappingURL=index.d.ts.map
+import { M as Message, b as MessageClass, c as MessageHeaders, E as EventStore, S as StoredEvent, a as EventStoreFetchResult } from '../event-store-DQXtakLF.js';
+
+declare function expectMessagesToBeFullyEqual(messages: Message[], expectedMessages: Message[]): void;
+declare function expectMessagesToContain(messages: Message[], expectedMessages: Message[]): void;
+declare function expectMessageToMatch(messages: Message[], messageType: string | MessageClass<any>, payload?: Record<string, unknown>): void;
+
+declare const matchers_expectMessageToMatch: typeof expectMessageToMatch;
+declare const matchers_expectMessagesToBeFullyEqual: typeof expectMessagesToBeFullyEqual;
+declare const matchers_expectMessagesToContain: typeof expectMessagesToContain;
+declare namespace matchers {
+  export { matchers_expectMessageToMatch as expectMessageToMatch, matchers_expectMessagesToBeFullyEqual as expectMessagesToBeFullyEqual, matchers_expectMessagesToContain as expectMessagesToContain };
+}
+
+declare class DummyMessage extends Message<Record<never, never>> {
+    static type: string;
+    static create(): DummyMessage;
+    static createMany(number: number): DummyMessage[];
+    static from(_: Record<never, never>, headers?: MessageHeaders): DummyMessage;
+}
+
+declare function setExpect(expectStatic: any): void;
+
+declare function partialMatch(source: Record<any, any>, target: Record<any, any>): boolean;
+
+declare function waitForTicks(number?: number): Promise<void>;
+declare function waitForMs(number?: number): Promise<void>;
+declare function waitFor(type?: "ticks" | "ms", number?: number): Promise<void>;
+
+declare class InMemoryEventStore implements EventStore {
+    private events;
+    store(event: Message): Promise<StoredEvent>;
+    storeAll(events: Message[]): Promise<StoredEvent[]>;
+    fetch(afterPosition: number, limit?: number): Promise<EventStoreFetchResult>;
+    getLastPosition(): Promise<number>;
+    clear(): void;
+}
+
+export { DummyMessage, InMemoryEventStore, expectMessageToMatch, expectMessagesToBeFullyEqual, expectMessagesToContain, matchers, partialMatch, setExpect, waitFor, waitForMs, waitForTicks };