@hexaijs/core 0.6.0 → 0.7.0

package/README.md

@@ -273,7 +273,7 @@ async function confirmOrder(
 
 ### UnitOfWork
 
-Interface for transaction management. Controls transaction propagation and provides access to the underlying database client.
+Interface for transaction management. The primary API is `scope()` for defining transaction boundaries.
 
 ```typescript
 import { UnitOfWork, Propagation } from "@hexaijs/core";
@@ -284,10 +284,29 @@ interface OrderApplicationContext {
     getOrderRepository(): OrderRepository;
 }
 
+// Define a transaction boundary with scope()
+await unitOfWork.scope(async () => {
+    const order = Order.create(orderId, customerId);
+    await orderRepository.add(order);
+});
+```
+
+#### scope() vs wrap()
+
+| Method | Signature | Status |
+|--------|-----------|--------|
+| `scope(fn)` | `fn: () => Promise<T>` | **Recommended** |
+| `wrap(fn)` | `fn: (client) => Promise<T>` | **Deprecated** |
+
+`scope()` defines a transaction boundary without exposing the database client. Client access is handled separately through infrastructure methods (e.g., `withClient()` in `@hexaijs/postgres`). This separation enables lazy transaction initialization — the actual `BEGIN` is deferred until the first client access.
+
+#### Transaction Propagation
+
+```typescript
 // Transaction propagation options
-Propagation.NEW       // Start new transaction
-Propagation.EXISTING  // Use existing transaction (error if none)
-Propagation.NESTED    // Nested transaction (savepoint)
+Propagation.NEW       // Always start a new transaction
+Propagation.EXISTING  // Join existing transaction, or create new if none
+Propagation.NESTED    // Create a savepoint within current transaction
 ```
 
 ### EventStore
@@ -369,7 +388,7 @@ throw new DuplicateObjectError("Order with this ID already exists");
 | `Id<T>` | Value object for typed identities |
 | `Identifiable<T>` | Interface for entities with identity |
 | `Repository<T>` | Interface for aggregate persistence |
-| `UnitOfWork` | Interface for transaction management |
+| `UnitOfWork` | Interface for transaction management (`scope()` for boundaries, `wrap()` deprecated) |
 | `Propagation` | Enum for transaction propagation modes |
 | `EventStore` | Interface for event store implementations |
 

package/dist/index.d.ts

@@ -61,6 +61,8 @@ interface BaseUnitOfWorkOptions {
 }
 interface UnitOfWork<Client = unknown, Options extends BaseUnitOfWorkOptions = BaseUnitOfWorkOptions> {
     getClient(): Client;
+    scope<T>(fn: () => Promise<T>, options?: Partial<Options>): Promise<T>;
+    /** @deprecated Use scope() for transaction boundaries and withClient() for client access. */
     wrap<T>(fn: (client: Client) => Promise<T>, options?: Partial<Options>): Promise<T>;
 }
 

package/dist/index.js.map

@@ -1 +1 @@
-{"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 MessageTrace {\n    id: string;\n    type: string;\n}\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    public asTrace(): MessageTrace {\n        return { id: this.getMessageId(), type: this.getMessageType() };\n    }\n\n    public getCausation(): MessageTrace | undefined {\n        return this.getHeader<MessageTrace>(\"causation\");\n    }\n\n    public getCorrelation(): MessageTrace | undefined {\n        return this.getHeader<MessageTrace>(\"correlation\");\n    }\n\n    public withCausation(trace: MessageTrace): this {\n        return this.withHeader(\"causation\", trace);\n    }\n\n    public withCorrelation(trace: MessageTrace): this {\n        return this.withHeader(\"correlation\", trace);\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"]}
+{"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 MessageTrace {\n    id: string;\n    type: string;\n}\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    public asTrace(): MessageTrace {\n        return { id: this.getMessageId(), type: this.getMessageType() };\n    }\n\n    public getCausation(): MessageTrace | undefined {\n        return this.getHeader<MessageTrace>(\"causation\");\n    }\n\n    public getCorrelation(): MessageTrace | undefined {\n        return this.getHeader<MessageTrace>(\"correlation\");\n    }\n\n    public withCausation(trace: MessageTrace): this {\n        return this.withHeader(\"causation\", trace);\n    }\n\n    public withCorrelation(trace: MessageTrace): this {\n        return this.withHeader(\"correlation\", trace);\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\n    scope<T>(\n        fn: () => Promise<T>,\n        options?: Partial<Options>\n    ): Promise<T>;\n\n    /** @deprecated Use scope() for transaction boundaries and withClient() for client access. */\n    wrap<T>(\n        fn: (client: Client) => Promise<T>,\n        options?: Partial<Options>\n    ): Promise<T>;\n}\n\n"]}

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.6.0",
+    "version": "0.7.0",
     "type": "module",
     "description": "Core utilities/types/base classes for hexai projects",
     "license": "MIT",