@auto-engineer/server-generator-apollo-emmett 1.103.0 → 1.105.0

package/dist/src/codegen/templates/command/evolve.specs.ts

@@ -87,27 +87,28 @@ describe('evolve.ts.ejs', () => {
       /**
        * ## IMPLEMENTATION INSTRUCTIONS ##
        *
-       * This function defines how the domain state evolves in response to events.
+       * Evolve domain state in response to events.
+       * Only track fields needed for future decisions in decide.ts.
        *
-       * Guidelines:
-       * - Apply only the **minimal** necessary changes for future decisions in \`decide.ts\`.
-       * - Ignore any event fields not required for decision-making logic.
-       * - If the event doesn’t change decision-relevant state, return the existing \`state\`.
-       * - Prefer immutability: always return a **new state object**.
-       * - Avoid spreading all of \`event.data\` unless all fields are relevant.
-       * - If State is a discriminated union (e.g., NotInitialized | Initialized),
-       *   always include the discriminant field (e.g., \`status\`) in return values.
-       *   Do NOT spread \`...state\` and add variant-specific fields — construct a complete object:
-       *   \`return { status: 'initialized', field: event.data.field };\`
+       * RULES:
+       * - Return a new object literal for state transitions.
+       *   For no-op (event doesn’t affect state), return the existing \`state\`.
+       * - If State is a discriminated union (check state.ts), EVERY return
+       *   MUST include the discriminant field as a string literal.
+       *   Example: \`return { status: ‘active’, field: event.data.field };\`
+       * - NEVER spread ...event.data or ...state — list each field explicitly.
+       *
+       * VERIFY before finalizing:
+       *   [ ] Every return (except \`return state;\`) matches a variant from state.ts
+       *   [ ] Every return includes the discriminant field
+       *   [ ] No spread operators in return statements
        */
 
       export const evolve = (state: State, event: ListingCreated): State => {
         switch (event.type) {
           case 'ListingCreated': {
-            // TODO: Update state based on ListingCreated
-            return {
-              ...state,
-            };
+            // TODO: Return { status: 'variant', field1: ..., field2: ... } matching state.ts.
+            return state;
           }
           default:
             return state;

package/dist/src/codegen/templates/command/evolve.ts.ejs

@@ -7,18 +7,21 @@
     /**
     * ## IMPLEMENTATION INSTRUCTIONS ##
     *
-    * This function defines how the domain state evolves in response to events.
+    * Evolve domain state in response to events.
+    * Only track fields needed for future decisions in decide.ts.
     *
-    * Guidelines:
-    * - Apply only the **minimal** necessary changes for future decisions in `decide.ts`.
-    * - Ignore any event fields not required for decision-making logic.
-    * - If the event doesn’t change decision-relevant state, return the existing `state`.
-    * - Prefer immutability: always return a **new state object**.
-    * - Avoid spreading all of `event.data` unless all fields are relevant.
-    * - If State is a discriminated union (e.g., NotInitialized | Initialized),
-    *   always include the discriminant field (e.g., `status`) in return values.
-    *   Do NOT spread `...state` and add variant-specific fields — construct a complete object:
-    *   `return { status: 'initialized', field: event.data.field };`
+    * RULES:
+    * - Return a new object literal for state transitions.
+    *   For no-op (event doesn’t affect state), return the existing `state`.
+    * - If State is a discriminated union (check state.ts), EVERY return
+    *   MUST include the discriminant field as a string literal.
+    *   Example: `return { status: ‘active’, field: event.data.field };`
+    * - NEVER spread ...event.data or ...state — list each field explicitly.
+    *
+    * VERIFY before finalizing:
+    *   [ ] Every return (except `return state;`) matches a variant from state.ts
+    *   [ ] Every return includes the discriminant field
+    *   [ ] No spread operators in return statements
     */
 
     export const evolve = (
@@ -28,10 +31,8 @@
     switch (event.type) {
     <% events.forEach(event => { -%>
         case '<%= event.type %>': {
-        // TODO: Update state based on <%= event.type %>
-        return {
-        ...state
-        };
+        // TODO: Return { status: 'variant', field1: ..., field2: ... } matching state.ts.
+        return state;
         }
     <% }); -%>
     default:

package/dist/src/codegen/templates/command/handle.specs.ts

@@ -331,4 +331,150 @@ describe('generateScaffoldFilePlans', () => {
       "
     `);
   });
+  it('should generate stream guard when not all commands share stream pattern fields', async () => {
+    const spec: SpecsSchema = {
+      variant: 'specs',
+      narratives: [
+        {
+          name: 'Member tracks workouts',
+          slices: [
+            {
+              type: 'command',
+              name: 'Track workouts',
+              stream: 'workouts-${memberId}',
+              client: {
+                specs: [],
+              },
+              server: {
+                description: 'test',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Track workouts',
+                    rules: [
+                      {
+                        name: 'Should log workout',
+                        examples: [
+                          {
+                            name: 'Member logs a workout',
+                            steps: [
+                              {
+                                keyword: 'When',
+                                text: 'LogWorkout',
+                                docString: { memberId: 'm1', exercise: 'squat' },
+                              },
+                              {
+                                keyword: 'Then',
+                                text: 'WorkoutLogged',
+                                docString: { memberId: 'm1', exercise: 'squat' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        name: 'Should calculate points',
+                        examples: [
+                          {
+                            name: 'Points are calculated',
+                            steps: [
+                              {
+                                keyword: 'When',
+                                text: 'CalculatePoints',
+                                docString: { season: 'winter' },
+                              },
+                              {
+                                keyword: 'Then',
+                                text: 'PointsCalculated',
+                                docString: { season: 'winter', points: 10 },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+                data: {
+                  items: [
+                    {
+                      target: { type: 'Event', name: 'WorkoutLogged' },
+                      destination: {
+                        type: 'stream',
+                        pattern: 'workouts-${memberId}',
+                      },
+                    },
+                  ],
+                },
+              },
+            },
+          ],
+        },
+      ],
+      messages: [
+        {
+          type: 'command',
+          name: 'LogWorkout',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'exercise', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'CalculatePoints',
+          fields: [{ name: 'season', type: 'string', required: true }],
+        },
+        {
+          type: 'event',
+          name: 'WorkoutLogged',
+          source: 'internal',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'exercise', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'PointsCalculated',
+          source: 'internal',
+          fields: [
+            { name: 'season', type: 'string', required: true },
+            { name: 'points', type: 'number', required: true },
+          ],
+        },
+      ],
+    };
+
+    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const handleFile = plans.find((p) => p.outputPath.endsWith('handle.ts'));
+
+    expect(handleFile?.contents).toMatchInlineSnapshot(`
+      "import { CommandHandler, type EventStore, type MessageHandlerResult } from '@event-driven-io/emmett';
+      import { evolve } from './evolve';
+      import { initialState } from './state';
+      import { decide } from './decide';
+      import type { LogWorkout, CalculatePoints } from './commands';
+
+      const handler = CommandHandler({
+        evolve,
+        initialState,
+      });
+
+      export const handle = async (
+        eventStore: EventStore,
+        command: LogWorkout | CalculatePoints,
+      ): Promise<MessageHandlerResult> => {
+        const commandData = command.data;
+        if (!('memberId' in commandData)) {
+          throw new Error('Cannot determine stream: "memberId" not in command data');
+        }
+        const streamId = \`workouts-\${commandData.memberId}\`;
+
+        await handler(eventStore, streamId, (state) => decide(command, state));
+        return undefined;
+      };
+      "
+    `);
+  });
 });

package/dist/src/codegen/templates/command/handle.ts.ejs

@@ -53,6 +53,16 @@ const integrationCalls = integrationData.map((d, i) => {
 
 const resultVarName = integrationCalls.find(call => !!call.varName)?.varName;
 const needsReturnValue = typeof resultVarName === 'string';
+
+const streamVars = [];
+const streamPatternStr = stream?.pattern ?? '';
+const svRegex = /\$\{([^}]+)\}/g;
+let svMatch;
+while ((svMatch = svRegex.exec(streamPatternStr)) !== null) {
+    streamVars.push(svMatch[1]);
+}
+const allCmdFieldSets = commands.map(c => new Set((c.fields ?? []).map(f => f.name)));
+const needsStreamGuard = streamVars.length > 0 && !allCmdFieldSets.every(fs => streamVars.every(v => fs.has(v)));
 %>
 
 <% integrationSideEffectImports.forEach((importSource) => { %>
@@ -86,7 +96,17 @@ eventStore: EventStore,
 command: <%= commands.map(c => pascalCase(c.type)).join(' | ') %>
 ): Promise<MessageHandlerResult> => {
     <% if (stream?.pattern?.includes('${')) { -%>
-        const streamId = `<%= stream.pattern.replace(/\$\{([^}]+)\}/g, (_, key) => `\${command.data.${key}}`) %>`;
+        <% if (needsStreamGuard) { -%>
+            const commandData = command.data;
+            <% for (const v of streamVars) { -%>
+                if (!('<%= v %>' in commandData)) {
+                    throw new Error('Cannot determine stream: "<%= v %>" not in command data');
+                }
+            <% } -%>
+            const streamId = `<%= stream.pattern.replace(/\$\{([^}]+)\}/g, (_, key) => `\${commandData.${key}}`) %>`;
+        <% } else { -%>
+            const streamId = `<%= stream.pattern.replace(/\$\{([^}]+)\}/g, (_, key) => `\${command.data.${key}}`) %>`;
+        <% } -%>
     <% } else { -%>
         const streamId = '<%= stream?.pattern ?? 'unknown-stream' %>';
     <% } -%>

package/dist/src/codegen/templates/query/projection.specs.ts

@@ -562,8 +562,11 @@ describe('projection.ts.ejs', () => {
       // SINGLETON AGGREGATION PATTERN
       // This projection maintains a single document that aggregates data from multiple entities.
       // Use internal state to track individual entity information for accurate calculations.
+
+      type EntityData = TodoAdded['data'];
+
       interface InternalTodoSummary extends TodoSummary {
-        _entities?: Record<string, { status?: string; [key: string]: unknown }>;
+        _entities?: Record<string, EntityData>;
       }
 
       type AllEvents = TodoAdded;

package/dist/src/codegen/templates/query/projection.ts.ejs

@@ -45,8 +45,14 @@ import { <%= stateEnums.join(', ') %> } from '../../../shared';
 // SINGLETON AGGREGATION PATTERN
 // This projection maintains a single document that aggregates data from multiple entities.
 // Use internal state to track individual entity information for accurate calculations.
+<% if (events.length === 1) { %>
+type EntityData = <%= pascalCase(events[0].type) %>['data'];
+<% } else { %>
+type EntityData = Partial<<%= events.map(e => pascalCase(e.type) + "['data']").join(' & ') %>>;
+<% } %>
+
 interface Internal<%= pascalCase(targetName || 'State') %> extends <%= pascalCase(targetName || 'State') %> {
-  _entities?: Record<string, { status?: string; [key: string]: unknown }>;
+  _entities?: Record<string, EntityData>;
 }
 <% } %>
 type AllEvents = <%= allEventTypes %>;

package/dist/src/codegen/templates/react/react.specs.specs.ts

@@ -72,14 +72,6 @@ describe('react.specs.ts.ejs (react slice)', () => {
               name: 'Send notification to host',
               server: {
                 description: 'Sends a host notification command in response to BookingRequested',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'NotifyHost' },
-                      destination: { type: 'stream', pattern: 'booking-${hostId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -291,14 +283,6 @@ describe('react.specs.ts.ejs (react slice)', () => {
               name: 'Process tip after completion',
               server: {
                 description: 'Processes tip command after appointment completion',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'ProcessTip' },
-                      destination: { type: 'stream', pattern: 'tips-${appointmentId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -409,14 +393,6 @@ describe('react.specs.ts.ejs (react slice)', () => {
               name: 'notify milestone',
               server: {
                 description: 'Notifies on milestone',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'SendNotification' },
-                      destination: { type: 'stream', pattern: 'notif-${memberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -532,14 +508,6 @@ describe('react.specs.ts.ejs (react slice)', () => {
               name: 'notify barber of cancellation',
               server: {
                 description: 'Notifies barber when appointment is cancelled',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'NotifyBarber' },
-                      destination: { type: 'stream', pattern: 'barber-${barberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',

package/dist/src/codegen/templates/react/react.ts.specs.ts

@@ -15,14 +15,6 @@ describe('react.ts.ejs', () => {
               name: 'missing-when-slice',
               server: {
                 description: 'A react slice with no When step',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'DoSomething' },
-                      destination: { type: 'stream', pattern: 'things-${id}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -113,14 +105,6 @@ describe('react.ts.ejs', () => {
               name: 'Send order confirmation',
               server: {
                 description: 'Sends confirmation after order placed',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'SendConfirmation' },
-                      destination: { type: 'stream', pattern: 'confirmations-${orderId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -238,14 +222,6 @@ describe('react.ts.ejs', () => {
               name: 'Notify Barber of Cancellation',
               server: {
                 description: 'Notifies barber when appointment is cancelled',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'NotifyBarber' },
-                      destination: { type: 'stream', pattern: 'barber-${barberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -335,7 +311,6 @@ describe('react.ts.ejs', () => {
                   items: [
                     {
                       target: { type: 'Event', name: 'BarberNotified' },
-                      destination: { type: 'stream', pattern: 'barber-${barberId}' },
                     },
                   ],
                 },
@@ -466,14 +441,6 @@ export type BarberNotified = Event<
               name: 'notify barber of cancellation',
               server: {
                 description: 'Notifies barber when appointment is cancelled',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'NotifyBarber' },
-                      destination: { type: 'stream', pattern: 'barber-${barberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -607,14 +574,6 @@ export type BarberNotified = Event<
               name: 'notify milestone',
               server: {
                 description: 'Notifies on milestone',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'SendNotification' },
-                      destination: { type: 'stream', pattern: 'notif-${memberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',
@@ -728,14 +687,6 @@ export type BarberNotified = Event<
               name: 'check record updates',
               server: {
                 description: 'Updates records after workout',
-                data: {
-                  items: [
-                    {
-                      target: { type: 'Command', name: 'UpdateRecord' },
-                      destination: { type: 'stream', pattern: 'records-${memberId}' },
-                    },
-                  ],
-                },
                 specs: [
                   {
                     type: 'gherkin',

package/dist/src/commands/generate-server.d.ts

@@ -40,6 +40,9 @@ export type ServerGenerationFailedEvent = Event<'ServerGenerationFailed', {
     destination: string;
     error: string;
     model: Model;
+    flowName?: string;
+    sliceName?: string;
+    sliceType?: string;
 }>;
 export type SliceGeneratedEvent = Event<'SliceGenerated', {
     flowName: string;
@@ -67,6 +70,7 @@ export declare function deriveModelPath(destination: string): string;
 export declare function writeModelToDisk(model: Model, destination: string): Promise<void>;
 export declare function cleanServerDir(serverDir: string): Promise<void>;
 export declare function writeHealthResolver(serverDir: string): Promise<void>;
+export declare function createServerFailureEvent(command: GenerateServerCommand, error: unknown): ServerGenerationFailedEvent;
 export declare function createSliceGeneratedEvent(flow: Narrative, slice: Slice, command: GenerateServerCommand): SliceGeneratedEvent;
 export declare function emitSliceGenerationFailedForDuplicates(duplicateCommands: DuplicateCommandInfo[], spec: Model, command: GenerateServerCommand, events: GenerateServerEvents[]): void;
 export declare function emitSliceGenerationFailedForFieldIssues(fieldIssues: FieldIssue[], spec: Model, command: GenerateServerCommand, events: GenerateServerEvents[]): void;

package/dist/src/commands/generate-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-server.d.ts","sourceRoot":"","sources":["../../../src/commands/generate-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-server.d.ts","sourceRoot":"","sources":["../../../src/commands/generate-server.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/generate-server.js

@@ -6,7 +6,7 @@ import { defineCommandHandler } from '@auto-engineer/message-bus';
 import createDebug from 'debug';
 import { execa } from 'execa';
 import fs from 'fs-extra';
-import { generateScaffoldFilePlans, writeScaffoldFilePlans, } from '../codegen/scaffoldFromSchema.js';
+import { generateScaffoldFilePlans, ScaffoldError, TemplateRenderError, writeScaffoldFilePlans, } from '../codegen/scaffoldFromSchema.js';
 import { ensureDirExists, ensureDirPath, toKebabCase } from '../codegen/utils/path.js';
 const debug = createDebug('auto:server-generator-apollo-emmett');
 const debugFiles = createDebug('auto:server-generator-apollo-emmett:files');
@@ -167,9 +167,33 @@ function stripAnsiCodes(text) {
     // biome-ignore lint/suspicious/noControlCharactersInRegex: intentionally matching ANSI escape sequences
     return text.replace(/\x1B\[[0-9;]*m/g, '');
 }
-function createServerFailureEvent(command, error) {
+export function createServerFailureEvent(command, error) {
     debug('Server generation failed with error: %O', error);
-    const errorMessage = error instanceof Error ? stripAnsiCodes(error.stack ?? error.message) : 'Unknown error occurred';
+    let flowName;
+    let sliceName;
+    let sliceType;
+    let templateFile;
+    let errorMessage;
+    if (error instanceof Error) {
+        let current = error;
+        while (current instanceof Error) {
+            if (current instanceof ScaffoldError) {
+                flowName = current.flowName;
+                sliceName = current.sliceName;
+                sliceType = current.sliceType;
+            }
+            if (current instanceof TemplateRenderError) {
+                templateFile = current.templateFile;
+            }
+            current = current.cause;
+        }
+        const rootError = findRootCause(error);
+        const baseMessage = stripAnsiCodes(rootError.stack ?? rootError.message);
+        errorMessage = templateFile !== undefined ? `[template=${templateFile}] ${baseMessage}` : baseMessage;
+    }
+    else {
+        errorMessage = 'Unknown error occurred';
+    }
     return {
         type: 'ServerGenerationFailed',
         data: {
@@ -177,12 +201,22 @@ function createServerFailureEvent(command, error) {
             destination: command.data.destination,
             error: errorMessage,
             model: command.data.model,
+            flowName,
+            sliceName,
+            sliceType,
         },
         timestamp: new Date(),
         requestId: command.requestId,
         correlationId: command.correlationId,
     };
 }
+function findRootCause(error) {
+    let current = error;
+    while (current.cause instanceof Error) {
+        current = current.cause;
+    }
+    return current;
+}
 export function createSliceGeneratedEvent(flow, slice, command) {
     return {
         type: 'SliceGenerated',