@arts-n-crafts/ts 3.19.0 → 5.0.0-rc.2

package/packages/v3/dist/index.d.cts

@@ -11,7 +11,7 @@ interface Command<TType = string, TPayload = unknown> extends WithIdentifier {
     type: TType;
     aggregateId: string;
     payload: TPayload;
-    kind: 'command';
+    kind: "command";
     timestamp: string;
     metadata: Partial<CommandMetadata>;
 }
@@ -28,7 +28,7 @@ interface IntegrationEventMetadata {
 interface IntegrationEvent<TPayload = unknown> {
     id: string;
     type: string;
-    source: 'external';
+    source: "external";
     payload: TPayload;
     timestamp: string;
     metadata: {} & Partial<IntegrationEventMetadata>;
@@ -43,7 +43,7 @@ interface DomainEvent<TPayload = unknown> {
     id: string;
     type: string;
     aggregateId: string;
-    source: 'internal';
+    source: "internal";
     payload: TPayload;
     timestamp: string;
     metadata: Partial<DomainEventMetadata>;
@@ -65,7 +65,7 @@ interface QueryMetadata {
 interface Query<TType = string, TPayload = unknown> extends WithIdentifier {
     type: TType;
     payload: TPayload;
-    kind: 'query';
+    kind: "query";
     timestamp: string;
     metadata: Partial<QueryMetadata>;
 }
@@ -129,14 +129,14 @@ interface Repository<TEvent, TLoadReturnType, TStoreReturnType = Promise<void>>
 }
 
 type QueryNode = {
-    type: 'eq' | 'gt' | 'lt';
+    type: "eq" | "gt" | "lt";
     field: string | number | symbol;
     value: Primitive;
 } | {
-    type: 'and' | 'or';
+    type: "and" | "or";
     nodes: QueryNode[];
 } | {
-    type: 'not';
+    type: "not";
     node: QueryNode;
 };
 
@@ -185,9 +185,9 @@ declare class FieldGreaterThan<T> extends Specification<T> {
     toQuery(): QueryNode;
 }
 
-declare function createQueryNode(type: 'eq' | 'gt' | 'lt', field: string | number | symbol, value: Primitive): QueryNode;
-declare function createQueryNode(type: 'and' | 'or', field: undefined, value: QueryNode[]): QueryNode;
-declare function createQueryNode(type: 'not', field: undefined, value: QueryNode): QueryNode;
+declare function createQueryNode(type: "eq" | "gt" | "lt", field: string | number | symbol, value: Primitive): QueryNode;
+declare function createQueryNode(type: "and" | "or", field: undefined, value: QueryNode[]): QueryNode;
+declare function createQueryNode(type: "not", field: undefined, value: QueryNode): QueryNode;
 
 declare function createDomainEvent<TPayload = unknown>(type: string, aggregateId: string, payload: TPayload, metadata?: Partial<DomainEventMetadata>): DomainEvent<TPayload>;
 
@@ -196,7 +196,7 @@ declare function isDomainEvent(event: unknown): event is DomainEvent;
 declare function isEvent(event: unknown): event is BaseEvent;
 
 interface Registerable$1<TCommand extends Command, TResult = void> {
-    register(aTypeOfCommand: TCommand['type'], anHandler: CommandHandler<TCommand>): TResult;
+    register(aTypeOfCommand: TCommand["type"], anHandler: CommandHandler<TCommand>): TResult;
 }
 interface Executable$2<TCommand extends Command, TResult = Promise<void>> {
     execute(aCommand: TCommand): TResult;
@@ -206,7 +206,7 @@ interface CommandBus<TCommand extends Command, TExecutionResult = Promise<void>,
 
 declare class SimpleCommandBus<TCommand extends Command> implements CommandBus<TCommand> {
     private handlers;
-    register(aTypeOfCommand: TCommand['type'], anHandler: CommandHandler<TCommand>): void;
+    register(aTypeOfCommand: TCommand["type"], anHandler: CommandHandler<TCommand>): void;
     execute(aCommand: TCommand): Promise<void>;
 }
 
@@ -303,7 +303,7 @@ interface OutboxEntry {
 }
 
 interface Queueable<TReturnType = Promise<void>> {
-    enqueue(event: OutboxEntry['event']): TReturnType;
+    enqueue(event: OutboxEntry["event"]): TReturnType;
 }
 interface Outbox<TEnqueueReturnType = Promise<void>, TGetPendingReturnType = Promise<OutboxEntry[]>, TMarkAsPublishedReturnType = Promise<void>, TMarkAsFailedReturnType = Promise<void>> extends Queueable<TEnqueueReturnType> {
     getPending(limit?: number): TGetPendingReturnType;
@@ -356,7 +356,7 @@ declare class InMemoryOutbox implements Outbox {
 declare function createOutboxEntry(event: DomainEvent<unknown>): OutboxEntry;
 
 interface Registerable<TQuery extends Query, TResult = void> {
-    register(aTypeOfQuery: TQuery['type'], anHandler: QueryHandler<TQuery>): TResult;
+    register(aTypeOfQuery: TQuery["type"], anHandler: QueryHandler<TQuery>): TResult;
 }
 interface Executable<TQuery extends Query, TResult = Promise<unknown>> {
     execute(aQuery: TQuery): TResult;
@@ -366,7 +366,7 @@ interface QueryBus<TQuery extends Query, TExecutionResult, TRegisterResult = voi
 
 declare class SimpleQueryBus<TQuery extends Query, TProjection> implements QueryBus<TQuery, Promise<TProjection>> {
     private handlers;
-    register(aTypeOfQuery: TQuery['type'], anHandler: QueryHandler<TQuery, Promise<TProjection>>): void;
+    register(aTypeOfQuery: TQuery["type"], anHandler: QueryHandler<TQuery, Promise<TProjection>>): void;
     execute(aQuery: TQuery): Promise<TProjection>;
 }
 
@@ -375,7 +375,7 @@ declare class SimpleRepository<TState, TCommand, TEvent extends DomainEvent> imp
     readonly streamName: string;
     private readonly evolveFn;
     private readonly initialState;
-    constructor(eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, streamName: string, evolveFn: Decider<TState, TCommand, TEvent>['evolve'], initialState: Decider<TState, TCommand, TEvent>['initialState']);
+    constructor(eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, streamName: string, evolveFn: Decider<TState, TCommand, TEvent>["evolve"], initialState: Decider<TState, TCommand, TEvent>["initialState"]);
     load(aggregateId: string): Promise<TState>;
     store(events: TEvent[]): Promise<void>;
 }
@@ -394,14 +394,14 @@ declare class ScenarioTest<TState, TEvent extends DomainEvent> {
     private givenInput;
     private whenInput;
     constructor(streamName: string, eventBus: EventProducer<BaseEvent> & EventConsumer<BaseEvent>, eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, commandBus: CommandBus<Command>, queryBus: QueryBus<Query, Promise<Record<string, unknown>[]>>, repository: Repository<DomainEvent, Promise<TState>>, outboxWorker: OutboxWorker);
-    given(...events: GivenInput): {
-        when(action: WhenInput): ReturnType<ScenarioTest<TState, TEvent>['when']>;
-        then(outcome: ThenInput): Promise<void>;
+    Given(...events: GivenInput): {
+        When(action: WhenInput): ReturnType<ScenarioTest<TState, TEvent>["When"]>;
+        Then(outcome: ThenInput): Promise<void>;
     };
-    when(action: WhenInput): {
-        then(outcome: ThenInput): Promise<void>;
+    When(action: WhenInput): {
+        Then(outcome: ThenInput): Promise<void>;
     };
-    then(thenInput: ThenInput): Promise<void>;
+    Then(thenInput: ThenInput): Promise<void>;
     private handleCommand;
     private handleQuery;
     private handleEvent;

package/packages/v3/dist/index.d.ts

@@ -11,7 +11,7 @@ interface Command<TType = string, TPayload = unknown> extends WithIdentifier {
     type: TType;
     aggregateId: string;
     payload: TPayload;
-    kind: 'command';
+    kind: "command";
     timestamp: string;
     metadata: Partial<CommandMetadata>;
 }
@@ -28,7 +28,7 @@ interface IntegrationEventMetadata {
 interface IntegrationEvent<TPayload = unknown> {
     id: string;
     type: string;
-    source: 'external';
+    source: "external";
     payload: TPayload;
     timestamp: string;
     metadata: {} & Partial<IntegrationEventMetadata>;
@@ -43,7 +43,7 @@ interface DomainEvent<TPayload = unknown> {
     id: string;
     type: string;
     aggregateId: string;
-    source: 'internal';
+    source: "internal";
     payload: TPayload;
     timestamp: string;
     metadata: Partial<DomainEventMetadata>;
@@ -65,7 +65,7 @@ interface QueryMetadata {
 interface Query<TType = string, TPayload = unknown> extends WithIdentifier {
     type: TType;
     payload: TPayload;
-    kind: 'query';
+    kind: "query";
     timestamp: string;
     metadata: Partial<QueryMetadata>;
 }
@@ -129,14 +129,14 @@ interface Repository<TEvent, TLoadReturnType, TStoreReturnType = Promise<void>>
 }
 
 type QueryNode = {
-    type: 'eq' | 'gt' | 'lt';
+    type: "eq" | "gt" | "lt";
     field: string | number | symbol;
     value: Primitive;
 } | {
-    type: 'and' | 'or';
+    type: "and" | "or";
     nodes: QueryNode[];
 } | {
-    type: 'not';
+    type: "not";
     node: QueryNode;
 };
 
@@ -185,9 +185,9 @@ declare class FieldGreaterThan<T> extends Specification<T> {
     toQuery(): QueryNode;
 }
 
-declare function createQueryNode(type: 'eq' | 'gt' | 'lt', field: string | number | symbol, value: Primitive): QueryNode;
-declare function createQueryNode(type: 'and' | 'or', field: undefined, value: QueryNode[]): QueryNode;
-declare function createQueryNode(type: 'not', field: undefined, value: QueryNode): QueryNode;
+declare function createQueryNode(type: "eq" | "gt" | "lt", field: string | number | symbol, value: Primitive): QueryNode;
+declare function createQueryNode(type: "and" | "or", field: undefined, value: QueryNode[]): QueryNode;
+declare function createQueryNode(type: "not", field: undefined, value: QueryNode): QueryNode;
 
 declare function createDomainEvent<TPayload = unknown>(type: string, aggregateId: string, payload: TPayload, metadata?: Partial<DomainEventMetadata>): DomainEvent<TPayload>;
 
@@ -196,7 +196,7 @@ declare function isDomainEvent(event: unknown): event is DomainEvent;
 declare function isEvent(event: unknown): event is BaseEvent;
 
 interface Registerable$1<TCommand extends Command, TResult = void> {
-    register(aTypeOfCommand: TCommand['type'], anHandler: CommandHandler<TCommand>): TResult;
+    register(aTypeOfCommand: TCommand["type"], anHandler: CommandHandler<TCommand>): TResult;
 }
 interface Executable$2<TCommand extends Command, TResult = Promise<void>> {
     execute(aCommand: TCommand): TResult;
@@ -206,7 +206,7 @@ interface CommandBus<TCommand extends Command, TExecutionResult = Promise<void>,
 
 declare class SimpleCommandBus<TCommand extends Command> implements CommandBus<TCommand> {
     private handlers;
-    register(aTypeOfCommand: TCommand['type'], anHandler: CommandHandler<TCommand>): void;
+    register(aTypeOfCommand: TCommand["type"], anHandler: CommandHandler<TCommand>): void;
     execute(aCommand: TCommand): Promise<void>;
 }
 
@@ -303,7 +303,7 @@ interface OutboxEntry {
 }
 
 interface Queueable<TReturnType = Promise<void>> {
-    enqueue(event: OutboxEntry['event']): TReturnType;
+    enqueue(event: OutboxEntry["event"]): TReturnType;
 }
 interface Outbox<TEnqueueReturnType = Promise<void>, TGetPendingReturnType = Promise<OutboxEntry[]>, TMarkAsPublishedReturnType = Promise<void>, TMarkAsFailedReturnType = Promise<void>> extends Queueable<TEnqueueReturnType> {
     getPending(limit?: number): TGetPendingReturnType;
@@ -356,7 +356,7 @@ declare class InMemoryOutbox implements Outbox {
 declare function createOutboxEntry(event: DomainEvent<unknown>): OutboxEntry;
 
 interface Registerable<TQuery extends Query, TResult = void> {
-    register(aTypeOfQuery: TQuery['type'], anHandler: QueryHandler<TQuery>): TResult;
+    register(aTypeOfQuery: TQuery["type"], anHandler: QueryHandler<TQuery>): TResult;
 }
 interface Executable<TQuery extends Query, TResult = Promise<unknown>> {
     execute(aQuery: TQuery): TResult;
@@ -366,7 +366,7 @@ interface QueryBus<TQuery extends Query, TExecutionResult, TRegisterResult = voi
 
 declare class SimpleQueryBus<TQuery extends Query, TProjection> implements QueryBus<TQuery, Promise<TProjection>> {
     private handlers;
-    register(aTypeOfQuery: TQuery['type'], anHandler: QueryHandler<TQuery, Promise<TProjection>>): void;
+    register(aTypeOfQuery: TQuery["type"], anHandler: QueryHandler<TQuery, Promise<TProjection>>): void;
     execute(aQuery: TQuery): Promise<TProjection>;
 }
 
@@ -375,7 +375,7 @@ declare class SimpleRepository<TState, TCommand, TEvent extends DomainEvent> imp
     readonly streamName: string;
     private readonly evolveFn;
     private readonly initialState;
-    constructor(eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, streamName: string, evolveFn: Decider<TState, TCommand, TEvent>['evolve'], initialState: Decider<TState, TCommand, TEvent>['initialState']);
+    constructor(eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, streamName: string, evolveFn: Decider<TState, TCommand, TEvent>["evolve"], initialState: Decider<TState, TCommand, TEvent>["initialState"]);
     load(aggregateId: string): Promise<TState>;
     store(events: TEvent[]): Promise<void>;
 }
@@ -394,14 +394,14 @@ declare class ScenarioTest<TState, TEvent extends DomainEvent> {
     private givenInput;
     private whenInput;
     constructor(streamName: string, eventBus: EventProducer<BaseEvent> & EventConsumer<BaseEvent>, eventStore: EventStore<TEvent, Promise<void>, Promise<TEvent[]>>, commandBus: CommandBus<Command>, queryBus: QueryBus<Query, Promise<Record<string, unknown>[]>>, repository: Repository<DomainEvent, Promise<TState>>, outboxWorker: OutboxWorker);
-    given(...events: GivenInput): {
-        when(action: WhenInput): ReturnType<ScenarioTest<TState, TEvent>['when']>;
-        then(outcome: ThenInput): Promise<void>;
+    Given(...events: GivenInput): {
+        When(action: WhenInput): ReturnType<ScenarioTest<TState, TEvent>["When"]>;
+        Then(outcome: ThenInput): Promise<void>;
     };
-    when(action: WhenInput): {
-        then(outcome: ThenInput): Promise<void>;
+    When(action: WhenInput): {
+        Then(outcome: ThenInput): Promise<void>;
     };
-    then(thenInput: ThenInput): Promise<void>;
+    Then(thenInput: ThenInput): Promise<void>;
     private handleCommand;
     private handleQuery;
     private handleEvent;

package/packages/v3/dist/index.js

@@ -25,23 +25,17 @@ function createQuery(type, payload, metadata = {}) {
 
 // src/core/utils/isCommand.ts
 function isCommand(candidate) {
-  if (candidate === null)
-    return false;
-  if (typeof candidate !== "object")
-    return false;
-  if (!("type" in candidate))
-    return false;
+  if (candidate === null) return false;
+  if (typeof candidate !== "object") return false;
+  if (!("type" in candidate)) return false;
   return "kind" in candidate && candidate.kind === "command";
 }
 
 // src/core/utils/isQuery.ts
 function isQuery(candidate) {
-  if (candidate === null)
-    return false;
-  if (typeof candidate !== "object")
-    return false;
-  if (!("type" in candidate))
-    return false;
+  if (candidate === null) return false;
+  if (typeof candidate !== "object") return false;
+  if (!("type" in candidate)) return false;
   return "kind" in candidate && candidate.kind === "query";
 }
 
@@ -144,8 +138,7 @@ function fail(anExpression) {
 
 // src/utils/invariant/invariant.ts
 function invariant(condition, onInvalid) {
-  if (!condition)
-    onInvalid();
+  if (!condition) onInvalid();
 }
 
 // src/domain/Specification/implementations/FieldGreaterThan.specification.ts
@@ -162,9 +155,7 @@ var FieldGreaterThan = class extends Specification {
     const field = entity[this.field];
     invariant(
       this.isNumber(field),
-      fail(
-        new TypeError(`Field ${String(this.field)} is not a number`)
-      )
+      fail(new TypeError(`Field ${String(this.field)} is not a number`))
     );
     return field > this.value;
   }
@@ -186,12 +177,9 @@ function createDomainEvent(type, aggregateId, payload, metadata = {}) {
 
 // src/domain/utils/isEvent.ts
 function isEvent(event) {
-  if (typeof event !== "object")
-    return false;
-  if (event === null)
-    return false;
-  if (!("type" in event))
-    return false;
+  if (typeof event !== "object") return false;
+  if (event === null) return false;
+  if (!("type" in event)) return false;
   return "source" in event;
 }
 
@@ -249,43 +237,36 @@ var SimpleDatabase = class {
   datasource = /* @__PURE__ */ new Map();
   simulateOffline = false;
   async query(tableName, specification) {
-    if (this.simulateOffline)
-      throw new DatabaseOfflineException();
+    if (this.simulateOffline) throw new DatabaseOfflineException();
     const tableRecords = this.datasource.get(tableName) || [];
     return tableRecords.filter((record) => specification.isSatisfiedBy(record));
   }
   async execute(tableName, statement) {
-    if (this.simulateOffline)
-      throw new DatabaseOfflineException();
-    if (!this.datasource.has(tableName))
-      this.datasource.set(tableName, []);
+    if (this.simulateOffline) throw new DatabaseOfflineException();
+    if (!this.datasource.has(tableName)) this.datasource.set(tableName, []);
     const table = this.datasource.get(tableName);
     switch (statement.operation) {
       case "CREATE" /* CREATE */: {
         const isDuplicate = table.some((item) => item.id === statement.payload.id);
-        if (isDuplicate)
-          throw new DuplicateRecordException(statement.payload.id);
+        if (isDuplicate) throw new DuplicateRecordException(statement.payload.id);
         table.push(statement.payload);
         break;
       }
       case "PUT" /* PUT */: {
         const index = table.findIndex((item) => item.id === statement.payload.id);
-        if (index === -1)
-          throw new RecordNotFoundException(statement.payload.id);
+        if (index === -1) throw new RecordNotFoundException(statement.payload.id);
         table[index] = statement.payload;
         break;
       }
       case "PATCH" /* PATCH */: {
         const index = table.findIndex((item) => item.id === statement.payload.id);
-        if (index === -1)
-          throw new RecordNotFoundException(statement.payload.id);
+        if (index === -1) throw new RecordNotFoundException(statement.payload.id);
         table[index] = { ...table[index], ...statement.payload };
         break;
       }
       case "DELETE" /* DELETE */: {
         const index = table.findIndex((item) => item.id === statement.payload.id);
-        if (index === -1)
-          throw new RecordNotFoundException(statement.payload.id);
+        if (index === -1) throw new RecordNotFoundException(statement.payload.id);
         table.splice(index, 1);
         break;
       }
@@ -305,12 +286,13 @@ var SimpleEventBus = class {
     this.handlers.set(stream, handlersForType);
   }
   async consume(stream, anEvent) {
-    if (!this.handlers.has(stream))
-      return;
+    if (!this.handlers.has(stream)) return;
     const handlers = this.handlers.get(stream);
-    await Promise.all(handlers.map(async (handler) => {
-      return handler.handle(anEvent);
-    }));
+    await Promise.all(
+      handlers.map(async (handler) => {
+        return handler.handle(anEvent);
+      })
+    );
   }
   async publish(stream, anEvent) {
     await this.consume(stream, anEvent);
@@ -372,11 +354,12 @@ var SimpleEventStore = class {
   }
   async append(streamName, events) {
     const uniqueAggregateIds = new Set(events.map((event2) => event2.aggregateId));
-    if (uniqueAggregateIds.size > 1)
-      throw new MultipleAggregatesException();
+    if (uniqueAggregateIds.size > 1) throw new MultipleAggregatesException();
     const event = events[0];
     const currentStream = await this.load(streamName, event.aggregateId);
-    const eventsToStore = events.map((event2) => createStoredEvent(streamName, currentStream.length + 1, event2));
+    const eventsToStore = events.map(
+      (event2) => createStoredEvent(streamName, currentStream.length + 1, event2)
+    );
     await Promise.all(
       eventsToStore.map(
         async (payload) => this.database.execute(this.tableName, { operation: "CREATE" /* CREATE */, payload })
@@ -395,14 +378,16 @@ var GenericOutboxWorker = class {
   }
   async runOnce() {
     const pending = await this.outbox.getPending();
-    await Promise.all(pending.map(async (entry) => {
-      try {
-        await this.eventBus.publish(this.stream, entry.event);
-        await this.outbox.markAsPublished(entry.id);
-      } catch {
-        await this.outbox.markAsFailed(entry.id);
-      }
-    }));
+    await Promise.all(
+      pending.map(async (entry) => {
+        try {
+          await this.eventBus.publish(this.stream, entry.event);
+          await this.outbox.markAsPublished(entry.id);
+        } catch {
+          await this.outbox.markAsFailed(entry.id);
+        }
+      })
+    );
   }
   async tick() {
     await this.runOnce();
@@ -485,12 +470,7 @@ var SimpleRepository = class {
   }
   async store(events) {
     await Promise.all(
-      events.map(
-        async (event) => this.eventStore.append(
-          this.streamName,
-          [event]
-        )
-      )
+      events.map(async (event) => this.eventStore.append(this.streamName, [event]))
     );
   }
 };
@@ -519,20 +499,20 @@ var ScenarioTest = class {
   }
   givenInput = [];
   whenInput;
-  given(...events) {
+  Given(...events) {
     this.givenInput = events;
     return {
-      when: this.when.bind(this),
-      then: this.then.bind(this)
+      When: this.When.bind(this),
+      Then: this.Then.bind(this)
     };
   }
-  when(action) {
+  When(action) {
     this.whenInput = action;
     return {
-      then: this.then.bind(this)
+      Then: this.Then.bind(this)
     };
   }
-  async then(thenInput) {
+  async Then(thenInput) {
     const domainEvents = this.givenInput.filter(isDomainEvent);
     const integrationEvents = this.givenInput.filter(isIntegrationEvent);
     await Promise.all([
@@ -543,15 +523,28 @@ var ScenarioTest = class {
       throw new Error("In the ScenarioTest, the when-step cannot be empty");
     }
     if (isCommand(this.whenInput)) {
-      invariant(isDomainEvent(thenInput), fail(new TypeError('When "command" expects a domain event in the then-step')));
+      invariant(
+        isDomainEvent(thenInput),
+        fail(new TypeError('When "command" expects a domain event in the then-step'))
+      );
       await this.handleCommand(this.whenInput, thenInput);
     }
     if (isQuery(this.whenInput)) {
-      invariant(Array.isArray(thenInput), fail(new TypeError('When "query" expects an array of expected results in the then-step')));
+      invariant(
+        Array.isArray(thenInput),
+        fail(new TypeError('When "query" expects an array of expected results in the then-step'))
+      );
       await this.handleQuery(this.whenInput, thenInput);
     }
     if (isDomainEvent(this.whenInput) || isIntegrationEvent(this.whenInput)) {
-      invariant(isDomainEvent(thenInput), fail(new TypeError('When "domain event" or "integration event" expects a domain event in the then-step')));
+      invariant(
+        isDomainEvent(thenInput),
+        fail(
+          new TypeError(
+            'When "domain event" or "integration event" expects a domain event in the then-step'
+          )
+        )
+      );
       await this.handleEvent(this.whenInput, thenInput);
     }
   }
@@ -608,10 +601,8 @@ var ScenarioTest = class {
 
 // src/utils/parseAsError/parseAsError.ts
 function parseAsError(value) {
-  if (value instanceof Error)
-    return value;
-  if (typeof value === "string")
-    return new Error(value);
+  if (value instanceof Error) return value;
+  if (typeof value === "string") return new Error(value);
   try {
     const json = JSON.stringify(value);
     return new Error(json ?? String(value));