create-auto-app 0.1.0 → 0.1.2

package/templates/shopping-app/server/src/domain/shared/reactorSpecification.js

@@ -0,0 +1,155 @@
+import { isErrorConstructor, AssertionError, assertTrue, } from '@event-driven-io/emmett';
+export const ReactorSpecification = {
+    for: reactorSpecificationFor,
+};
+function createMockCommandSender() {
+    const sentCommands = [];
+    const send = async (command) => {
+        sentCommands.push(command);
+    };
+    return {
+        send,
+        sentCommands,
+        reset: () => {
+            sentCommands.length = 0;
+        },
+    };
+}
+function reactorSpecificationFor(processorOrReactor, createContext) {
+    return (givenEvents) => {
+        return {
+            when: (whenEvent, contextOverride) => {
+                const mockCommandSender = createMockCommandSender();
+                const defaultContext = createContext(mockCommandSender);
+                const context = contextOverride || defaultContext;
+                const handle = async () => {
+                    const givenArray = Array.isArray(givenEvents) ? givenEvents : givenEvents != null ? [givenEvents] : [];
+                    const whenArray = Array.isArray(whenEvent) ? whenEvent : [whenEvent];
+                    const allEvents = [...givenArray, ...whenArray];
+                    // Transform events to have metadata
+                    const eventsWithMetadata = allEvents.map((event, index) => ({
+                        ...event,
+                        kind: 'Event',
+                        metadata: {
+                            streamName: 'test-stream',
+                            messageId: `test-${index}`,
+                            streamPosition: BigInt(index + 1),
+                            globalPosition: BigInt(index + 1),
+                        },
+                    }));
+                    const contextWithMock = { ...context, commandSender: mockCommandSender };
+                    // Get the actual reactor instance
+                    const reactor = typeof processorOrReactor === 'function' ? processorOrReactor() : processorOrReactor;
+                    // Handle different reactor types
+                    if ('handle' in reactor && typeof reactor.handle === 'function') {
+                        // It's a MessageProcessor or has a handle method
+                        await reactor.handle(eventsWithMetadata, contextWithMock);
+                    }
+                    else if ('eachMessage' in reactor && typeof reactor.eachMessage === 'function') {
+                        // It has eachMessage
+                        for (const event of eventsWithMetadata) {
+                            await reactor.eachMessage(event, contextWithMock);
+                        }
+                    }
+                    else {
+                        throw new Error('Reactor must have either a handle or eachMessage method');
+                    }
+                    return mockCommandSender.sentCommands;
+                };
+                return {
+                    then: async (expectedCommand) => {
+                        try {
+                            const sentCommands = await handle();
+                            if (typeof expectedCommand === 'function') {
+                                const checkFn = expectedCommand;
+                                if (sentCommands.length === 1) {
+                                    assertTrue(checkFn(sentCommands[0]), `Sent command did not match the expected condition: ${JSON.stringify(sentCommands[0])}`);
+                                }
+                                else {
+                                    assertTrue(checkFn(sentCommands), `Sent commands did not match the expected condition: ${JSON.stringify(sentCommands)}`);
+                                }
+                                return;
+                            }
+                            if (Array.isArray(expectedCommand)) {
+                                assertTrue(sentCommands.length === expectedCommand.length, `Expected ${expectedCommand.length} command(s) to be sent, but ${sentCommands.length} were sent`);
+                                expectedCommand.forEach((expected, index) => {
+                                    const sent = sentCommands[index];
+                                    assertCommandsMatch(sent, expected, index);
+                                });
+                                return;
+                            }
+                            if (sentCommands.length === 0) {
+                                throw new AssertionError('No commands were sent');
+                            }
+                            if (sentCommands.length > 1) {
+                                throw new AssertionError(`Expected 1 command to be sent, but ${sentCommands.length} were sent`);
+                            }
+                            assertCommandsMatch(sentCommands[0], expectedCommand);
+                        }
+                        finally {
+                            mockCommandSender.reset();
+                        }
+                    },
+                    thenNothingHappened: async () => {
+                        try {
+                            const sentCommands = await handle();
+                            if (sentCommands.length > 0) {
+                                throw new AssertionError(`Expected no commands to be sent, but ${sentCommands.length} command(s) were sent: ${JSON.stringify(sentCommands)}`);
+                            }
+                        }
+                        finally {
+                            mockCommandSender.reset();
+                        }
+                    },
+                    thenThrows: async (...args) => {
+                        try {
+                            await handle();
+                            throw new AssertionError('Reactor did not fail as expected');
+                        }
+                        catch (error) {
+                            thenThrowsErrorHandler(error, args);
+                        }
+                        finally {
+                            mockCommandSender.reset();
+                        }
+                    },
+                };
+            },
+        };
+    };
+}
+// eslint-disable-next-line complexity
+function assertCommandsMatch(actual, expected, index) {
+    const actualCopy = { ...actual };
+    const expectedCopy = { ...expected };
+    if (actualCopy.metadata !== undefined && expectedCopy.metadata !== undefined) {
+        for (const key in expectedCopy.metadata) {
+            const expectedValue = expectedCopy.metadata[key];
+            const actualValue = actualCopy.metadata[key];
+            const expectedStr = expectedValue === undefined ? 'undefined' : expectedValue === null ? 'null' : String(expectedValue);
+            const actualStr = actualValue === undefined ? 'undefined' : actualValue === null ? 'null' : String(actualValue);
+            assertTrue(actualValue === expectedValue, `Command${index !== undefined ? ` at index ${index}` : ''} metadata.${key} does not match.\nExpected: ${expectedStr}\nActual: ${actualStr}`);
+        }
+        delete actualCopy.metadata;
+        delete expectedCopy.metadata;
+    }
+    else if (actualCopy.metadata !== undefined && expectedCopy.metadata === undefined) {
+        delete actualCopy.metadata;
+    }
+    assertTrue(JSON.stringify(actualCopy) === JSON.stringify(expectedCopy), `Command${index !== undefined ? ` at index ${index}` : ''} does not match.\nExpected: ${JSON.stringify(expected)}\nActual: ${JSON.stringify(actual)}`);
+}
+function thenThrowsErrorHandler(error, args) {
+    if (error instanceof AssertionError)
+        throw error;
+    if (args.length === 0)
+        return;
+    if (!isErrorConstructor(args[0])) {
+        assertTrue(args[0](error), `Error didn't match the error condition: ${error?.toString()}`);
+        return;
+    }
+    assertTrue(error instanceof args[0], `Caught error is not an instance of the expected type: ${error?.toString()}`);
+    if (args[1]) {
+        assertTrue(args[1](error), `Error didn't match the error condition: ${error?.toString()}`);
+    }
+}
+//# sourceMappingURL=reactorSpecification.js.map

package/templates/shopping-app/server/src/domain/shared/reactorSpecification.js.map

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

package/templates/shopping-app/server/src/domain/shared/reactorSpecification.ts

@@ -0,0 +1,257 @@
+import {
+  CommandSender,
+  isErrorConstructor,
+  type ErrorConstructor,
+  AssertionError,
+  assertTrue,
+  type MessageProcessor,
+} from '@event-driven-io/emmett';
+
+interface CommandCheck<CommandType> {
+  (command: CommandType): boolean;
+}
+
+interface ErrorCheck<ErrorType> {
+  (error: ErrorType): boolean;
+}
+
+export type ThenThrows<ErrorType extends Error> =
+  | (() => void)
+  | ((errorConstructor: ErrorConstructor<ErrorType>) => void)
+  | ((errorCheck: ErrorCheck<ErrorType>) => void)
+  | ((errorConstructor: ErrorConstructor<ErrorType>, errorCheck?: ErrorCheck<ErrorType>) => void);
+
+interface ReactorSpecificationReturn<Event, Command, Context> {
+  when: (
+    event: Event | Event[],
+    context?: Context,
+  ) => {
+    then: (expectedCommand: Command | Command[] | CommandCheck<Command> | CommandCheck<Command[]>) => Promise<void>;
+    thenNothingHappened: () => Promise<void>;
+    thenThrows: <ErrorType extends Error = Error>(...args: Parameters<ThenThrows<ErrorType>>) => Promise<void>;
+  };
+}
+
+export interface ReactorSpecification<
+  Event,
+  Command,
+  Context extends { commandSender: CommandSender } = { commandSender: CommandSender },
+> {
+  (givenEvents: Event | Event[]): ReactorSpecificationReturn<Event, Command, Context>;
+}
+
+export const ReactorSpecification = {
+  for: reactorSpecificationFor,
+};
+
+interface MockCommandSender<Command> extends CommandSender {
+  sentCommands: Command[];
+  reset: () => void;
+}
+
+function createMockCommandSender<Command>(): MockCommandSender<Command> {
+  const sentCommands: Command[] = [];
+
+  const send = async <CommandType extends Command = Command>(command: CommandType): Promise<void> => {
+    sentCommands.push(command);
+  };
+
+  return {
+    send,
+    sentCommands,
+    reset: () => {
+      sentCommands.length = 0;
+    },
+  } as MockCommandSender<Command>;
+}
+
+type ReactorLike<Event, Context> =
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | { handle: (events: Event[], context: Context) => Promise<any> }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | { eachMessage: (event: Event, context: Context) => Promise<any> }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | MessageProcessor<any, any, any>;
+
+function reactorSpecificationFor<Event, Command, Context extends { commandSender: CommandSender }>(
+  processorOrReactor: ReactorLike<Event, Context> | (() => ReactorLike<Event, Context>),
+  createContext: (commandSender: CommandSender) => Context,
+): ReactorSpecification<Event, Command, Context> {
+  return (givenEvents: Event | Event[]) => {
+    return {
+      when: (whenEvent: Event | Event[], contextOverride?: Context) => {
+        const mockCommandSender = createMockCommandSender<Command>();
+        const defaultContext = createContext(mockCommandSender);
+        const context = contextOverride || defaultContext;
+
+        const handle = async () => {
+          const givenArray = Array.isArray(givenEvents) ? givenEvents : givenEvents != null ? [givenEvents] : [];
+          const whenArray = Array.isArray(whenEvent) ? whenEvent : [whenEvent];
+          const allEvents = [...givenArray, ...whenArray];
+
+          // Transform events to have metadata
+          const eventsWithMetadata = allEvents.map((event, index) => ({
+            ...event,
+            kind: 'Event' as const,
+            metadata: {
+              streamName: 'test-stream',
+              messageId: `test-${index}`,
+              streamPosition: BigInt(index + 1),
+              globalPosition: BigInt(index + 1),
+            },
+          }));
+
+          const contextWithMock = { ...context, commandSender: mockCommandSender };
+
+          // Get the actual reactor instance
+          const reactor = typeof processorOrReactor === 'function' ? processorOrReactor() : processorOrReactor;
+
+          // Handle different reactor types
+          if ('handle' in reactor && typeof reactor.handle === 'function') {
+            // It's a MessageProcessor or has a handle method
+            await reactor.handle(eventsWithMetadata, contextWithMock);
+          } else if ('eachMessage' in reactor && typeof reactor.eachMessage === 'function') {
+            // It has eachMessage
+            for (const event of eventsWithMetadata) {
+              await reactor.eachMessage(event, contextWithMock);
+            }
+          } else {
+            throw new Error('Reactor must have either a handle or eachMessage method');
+          }
+
+          return mockCommandSender.sentCommands;
+        };
+
+        return {
+          then: async (
+            expectedCommand: Command | Command[] | CommandCheck<Command> | CommandCheck<Command[]>,
+          ): Promise<void> => {
+            try {
+              const sentCommands = await handle();
+
+              if (typeof expectedCommand === 'function') {
+                const checkFn = expectedCommand;
+                if (sentCommands.length === 1) {
+                  assertTrue(
+                    (checkFn as CommandCheck<Command>)(sentCommands[0]),
+                    `Sent command did not match the expected condition: ${JSON.stringify(sentCommands[0])}`,
+                  );
+                } else {
+                  assertTrue(
+                    (checkFn as CommandCheck<Command[]>)(sentCommands),
+                    `Sent commands did not match the expected condition: ${JSON.stringify(sentCommands)}`,
+                  );
+                }
+                return;
+              }
+
+              if (Array.isArray(expectedCommand)) {
+                assertTrue(
+                  sentCommands.length === expectedCommand.length,
+                  `Expected ${expectedCommand.length} command(s) to be sent, but ${sentCommands.length} were sent`,
+                );
+
+                expectedCommand.forEach((expected, index) => {
+                  const sent = sentCommands[index];
+                  assertCommandsMatch(sent, expected, index);
+                });
+                return;
+              }
+
+              if (sentCommands.length === 0) {
+                throw new AssertionError('No commands were sent');
+              }
+
+              if (sentCommands.length > 1) {
+                throw new AssertionError(`Expected 1 command to be sent, but ${sentCommands.length} were sent`);
+              }
+
+              assertCommandsMatch(sentCommands[0], expectedCommand);
+            } finally {
+              mockCommandSender.reset();
+            }
+          },
+
+          thenNothingHappened: async (): Promise<void> => {
+            try {
+              const sentCommands = await handle();
+              if (sentCommands.length > 0) {
+                throw new AssertionError(
+                  `Expected no commands to be sent, but ${sentCommands.length} command(s) were sent: ${JSON.stringify(sentCommands)}`,
+                );
+              }
+            } finally {
+              mockCommandSender.reset();
+            }
+          },
+
+          thenThrows: async <ErrorType extends Error>(...args: Parameters<ThenThrows<ErrorType>>): Promise<void> => {
+            try {
+              await handle();
+              throw new AssertionError('Reactor did not fail as expected');
+            } catch (error) {
+              thenThrowsErrorHandler(error, args);
+            } finally {
+              mockCommandSender.reset();
+            }
+          },
+        };
+      },
+    };
+  };
+}
+
+interface CommandWithMetadata {
+  metadata?: Record<string, unknown>;
+}
+
+// eslint-disable-next-line complexity
+function assertCommandsMatch<Command>(actual: Command, expected: Command, index?: number): void {
+  const actualCopy = { ...actual } as CommandWithMetadata & Record<string, unknown>;
+  const expectedCopy = { ...expected } as CommandWithMetadata & Record<string, unknown>;
+
+  if (actualCopy.metadata !== undefined && expectedCopy.metadata !== undefined) {
+    for (const key in expectedCopy.metadata) {
+      const expectedValue = expectedCopy.metadata[key];
+      const actualValue = actualCopy.metadata[key];
+
+      const expectedStr =
+        expectedValue === undefined ? 'undefined' : expectedValue === null ? 'null' : String(expectedValue);
+      const actualStr = actualValue === undefined ? 'undefined' : actualValue === null ? 'null' : String(actualValue);
+
+      assertTrue(
+        actualValue === expectedValue,
+        `Command${index !== undefined ? ` at index ${index}` : ''} metadata.${key} does not match.\nExpected: ${expectedStr}\nActual: ${actualStr}`,
+      );
+    }
+    delete actualCopy.metadata;
+    delete expectedCopy.metadata;
+  } else if (actualCopy.metadata !== undefined && expectedCopy.metadata === undefined) {
+    delete actualCopy.metadata;
+  }
+
+  assertTrue(
+    JSON.stringify(actualCopy) === JSON.stringify(expectedCopy),
+    `Command${index !== undefined ? ` at index ${index}` : ''} does not match.\nExpected: ${JSON.stringify(expected)}\nActual: ${JSON.stringify(actual)}`,
+  );
+}
+
+function thenThrowsErrorHandler<ErrorType extends Error>(
+  error: unknown,
+  args: Parameters<ThenThrows<ErrorType>>,
+): void {
+  if (error instanceof AssertionError) throw error;
+
+  if (args.length === 0) return;
+
+  if (!isErrorConstructor(args[0])) {
+    assertTrue(args[0](error as ErrorType), `Error didn't match the error condition: ${error?.toString()}`);
+    return;
+  }
+
+  assertTrue(error instanceof args[0], `Caught error is not an instance of the expected type: ${error?.toString()}`);
+
+  if (args[1]) {
+    assertTrue(args[1](error as ErrorType), `Error didn't match the error condition: ${error?.toString()}`);
+  }
+}

package/templates/shopping-app/server/src/domain/shared/sendCommand.d.ts

@@ -0,0 +1,4 @@
+import type { Command, CommandSender } from '@event-driven-io/emmett';
+import type { MutationResponse } from './types';
+export declare function sendCommand<T extends Command>(commandSender: CommandSender, command: T): Promise<MutationResponse>;
+//# sourceMappingURL=sendCommand.d.ts.map

package/templates/shopping-app/server/src/domain/shared/sendCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendCommand.d.ts","sourceRoot":"","sources":["../../../src/domain/shared/sendCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,wBAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,EACjD,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}

package/templates/shopping-app/server/src/domain/shared/sendCommand.js

@@ -0,0 +1,17 @@
+export async function sendCommand(commandSender, command) {
+    try {
+        await commandSender.send(command);
+        return { success: true };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            error: {
+                type: err?.name ?? 'UnknownError',
+                message: err?.message ?? 'An unexpected error occurred',
+            },
+        };
+    }
+}
+//# sourceMappingURL=sendCommand.js.map

package/templates/shopping-app/server/src/domain/shared/sendCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendCommand.js","sourceRoot":"","sources":["../../../src/domain/shared/sendCommand.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAA4B,EAC5B,OAAU;IAEV,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAA4C,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,cAAc;gBACjC,OAAO,EAAE,GAAG,EAAE,OAAO,IAAI,8BAA8B;aACxD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/templates/shopping-app/server/src/domain/shared/sendCommand.ts

@@ -0,0 +1,21 @@
+import type { Command, CommandSender } from '@event-driven-io/emmett';
+import type { MutationResponse } from './types';
+
+export async function sendCommand<T extends Command>(
+  commandSender: CommandSender,
+  command: T,
+): Promise<MutationResponse> {
+  try {
+    await commandSender.send(command);
+    return { success: true };
+  } catch (error: unknown) {
+    const err = error as { name?: string; message?: string };
+    return {
+      success: false,
+      error: {
+        type: err?.name ?? 'UnknownError',
+        message: err?.message ?? 'An unexpected error occurred',
+      },
+    };
+  }
+}

package/templates/shopping-app/server/src/domain/shared/types.d.ts

@@ -0,0 +1,19 @@
+import { CommandSender, InMemoryEventStore } from '@event-driven-io/emmett';
+export interface ReactorContext {
+    eventStore: InMemoryEventStore;
+    commandSender: CommandSender;
+    [key: string]: unknown;
+}
+export interface GraphQLContext {
+    eventStore: InMemoryEventStore;
+    messageBus: CommandSender;
+}
+export declare class MutationError {
+    type: string;
+    message?: string;
+}
+export declare class MutationResponse {
+    success: boolean;
+    error?: MutationError;
+}
+//# sourceMappingURL=types.d.ts.map

package/templates/shopping-app/server/src/domain/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/domain/shared/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG5E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,UAAU,EAAE,aAAa,CAAC;CAC3B;AAED,qBACa,aAAa;IAExB,IAAI,EAAG,MAAM,CAAC;IAGd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,gBAAgB;IAE3B,OAAO,EAAG,OAAO,CAAC;IAGlB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/templates/shopping-app/server/src/domain/shared/types.js

@@ -0,0 +1,39 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Field, ObjectType } from 'type-graphql';
+let MutationError = class MutationError {
+};
+__decorate([
+    Field(() => String),
+    __metadata("design:type", String)
+], MutationError.prototype, "type", void 0);
+__decorate([
+    Field(() => String, { nullable: true }),
+    __metadata("design:type", String)
+], MutationError.prototype, "message", void 0);
+MutationError = __decorate([
+    ObjectType()
+], MutationError);
+export { MutationError };
+let MutationResponse = class MutationResponse {
+};
+__decorate([
+    Field(() => Boolean),
+    __metadata("design:type", Boolean)
+], MutationResponse.prototype, "success", void 0);
+__decorate([
+    Field(() => MutationError, { nullable: true }),
+    __metadata("design:type", MutationError)
+], MutationResponse.prototype, "error", void 0);
+MutationResponse = __decorate([
+    ObjectType()
+], MutationResponse);
+export { MutationResponse };
+//# sourceMappingURL=types.js.map

package/templates/shopping-app/server/src/domain/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/domain/shared/types.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,IAAM,aAAa,GAAnB,MAAM,aAAa;CAMzB,CAAA;AAJC;IADC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;;2CACN;AAGd;IADC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACvB;AALN,aAAa;IADzB,UAAU,EAAE;GACA,aAAa,CAMzB;;AAGM,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAM5B,CAAA;AAJC;IADC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;;iDACH;AAGlB;IADC,KAAK,CAAC,GAAG,EAAE,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;8BACvC,aAAa;+CAAC;AALX,gBAAgB;IAD5B,UAAU,EAAE;GACA,gBAAgB,CAM5B"}

package/templates/shopping-app/server/src/domain/shared/types.ts

@@ -0,0 +1,31 @@
+import { CommandSender, InMemoryEventStore } from '@event-driven-io/emmett';
+import { Field, ObjectType } from 'type-graphql';
+
+export interface ReactorContext {
+  eventStore: InMemoryEventStore;
+  commandSender: CommandSender;
+  [key: string]: unknown;
+}
+
+export interface GraphQLContext {
+  eventStore: InMemoryEventStore;
+  messageBus: CommandSender;
+}
+
+@ObjectType()
+export class MutationError {
+  @Field(() => String)
+  type!: string;
+
+  @Field(() => String, { nullable: true })
+  message?: string;
+}
+
+@ObjectType()
+export class MutationResponse {
+  @Field(() => Boolean)
+  success!: boolean;
+
+  @Field(() => MutationError, { nullable: true })
+  error?: MutationError;
+}

package/templates/shopping-app/server/src/integrations/ai-integration.ts

@@ -0,0 +1,76 @@
+import { Integration, Event, Command } from '@auto-engineer/flowlang';
+import {
+  generateStructuredDataWithAI,
+  AIProvider,
+  z,
+  getSchemaByName,
+  generateTextWithAI,
+} from '@auto-engineer/ai-gateway';
+
+export type ChatCompleted = Event<
+  'ChatCompleted',
+  {
+    sessionId: string;
+    suggestedItems: { productId: string; name: string; quantity: number; reason: string }[];
+    timestamp: Date;
+  }
+>;
+
+export type DoChat = Command<
+  'DoChat',
+  {
+    sessionId: string;
+    prompt: string;
+    systemPrompt?: string;
+    schemaName?: string;
+  }
+>;
+
+type AICommands = {
+  DoChat: <T>(command: DoChat) => Promise<T>;
+};
+
+export const AI: Integration<'ai', Record<string, never>, AICommands> = {
+  __brand: 'Integration' as const,
+  type: 'ai' as const,
+  name: 'AI',
+  Commands: {
+    schema: {
+      DoChat: z.object({
+        sessionId: z.string(),
+        prompt: z.string(),
+        systemPrompt: z.string().optional(),
+        schemaName: z.string(),
+      }),
+    },
+    DoChat: async <T>(command: DoChat): Promise<T> => {
+      const { prompt, systemPrompt, schemaName } = command.data;
+
+      const fullPrompt = systemPrompt?.trim() != null ? `${systemPrompt.trim()}\n\n${prompt.trim()}` : prompt.trim();
+
+      if (schemaName != null) {
+        const schema = getSchemaByName(schemaName);
+
+        if (schema) {
+          return await generateStructuredDataWithAI(fullPrompt, AIProvider.Anthropic, {
+            schema: schema as z.ZodSchema<T>,
+            schemaName,
+            schemaDescription: `AI output matching schema '${schemaName}'`,
+            includeTools: true,
+          });
+        }
+      }
+      const raw = await generateTextWithAI(fullPrompt, AIProvider.Anthropic, {
+        includeTools: true,
+      });
+
+      try {
+        return JSON.parse(raw) as T;
+      } catch (err) {
+        throw new Error(
+          `Failed to parse unstructured AI response: ${err instanceof Error ? err.message : String(err)}`,
+        );
+      }
+    },
+  },
+};