@auto-engineer/server-generator-apollo-emmett 1.124.0 → 1.125.0

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

@@ -762,8 +762,250 @@ export type BarberNotified = Event<
     const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
     const reactFile = plans.find((p) => p.outputPath.endsWith('check-record-updates/react.ts'));
 
-    expect(reactFile?.contents).toContain("'WorkoutSummary-' + event.data.memberId");
+    expect(reactFile?.contents).toContain('`WorkoutSummary-${event.data.memberId}`');
     expect(reactFile?.contents).toContain('aggregateStream');
     expect(reactFile?.contents).not.toContain('event.data.exercises');
   });
+
+  it('should scaffold handlers for multiple event→command pairs', async () => {
+    const spec: SpecsSchema = {
+      variant: 'specs',
+      narratives: [
+        {
+          name: 'fitness flow',
+          slices: [
+            {
+              type: 'command',
+              name: 'earn points',
+              client: { specs: [] },
+              server: {
+                description: '',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Earn points',
+                    rules: [
+                      {
+                        name: 'Should earn',
+                        examples: [
+                          {
+                            name: 'Points earned',
+                            steps: [
+                              { keyword: 'When', text: 'EarnPoints', docString: { memberId: 'm1', amount: 10 } },
+                              { keyword: 'Then', text: 'PointsEarned', docString: { memberId: 'm1', amount: 10 } },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'command',
+              name: 'update record',
+              client: { specs: [] },
+              server: {
+                description: '',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Update record',
+                    rules: [
+                      {
+                        name: 'Should update',
+                        examples: [
+                          {
+                            name: 'Record updated',
+                            steps: [
+                              { keyword: 'When', text: 'UpdateRecord', docString: { memberId: 'm1' } },
+                              {
+                                keyword: 'Then',
+                                text: 'PersonalRecordUpdated',
+                                docString: { memberId: 'm1', record: 'bench' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'react',
+              name: 'award badges',
+              server: {
+                description: 'Awards badges based on points and records',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Award badges',
+                    rules: [
+                      {
+                        name: 'Should award on points',
+                        examples: [
+                          {
+                            name: 'Badge for points',
+                            steps: [
+                              { keyword: 'When', text: 'PointsEarned', docString: { memberId: 'm1', amount: 100 } },
+                              {
+                                keyword: 'Then',
+                                text: 'AwardBadge',
+                                docString: { memberId: 'm1', badge: 'centurion' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        name: 'Should notify on record',
+                        examples: [
+                          {
+                            name: 'Notification for record',
+                            steps: [
+                              {
+                                keyword: 'When',
+                                text: 'PersonalRecordUpdated',
+                                docString: { memberId: 'm1', record: 'bench' },
+                              },
+                              {
+                                keyword: 'Then',
+                                text: 'SendRecordNotification',
+                                docString: { memberId: 'm1', message: 'New record!' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+          ],
+        },
+      ],
+      messages: [
+        {
+          type: 'command',
+          name: 'EarnPoints',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'amount', type: 'number', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'PointsEarned',
+          source: 'internal',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'amount', type: 'number', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'UpdateRecord',
+          fields: [{ name: 'memberId', type: 'string', required: true }],
+        },
+        {
+          type: 'event',
+          name: 'PersonalRecordUpdated',
+          source: 'internal',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'record', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'AwardBadge',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'badge', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'SendRecordNotification',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'message', type: 'string', required: true },
+          ],
+        },
+      ],
+    };
+
+    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const reactFile = plans.find((p) => p.outputPath.endsWith('award-badges/react.ts'));
+
+    expect(reactFile?.contents).toMatchInlineSnapshot(`
+      "import { inMemoryReactor, type MessageHandlerResult } from '@event-driven-io/emmett';
+      import type { PointsEarned } from '../earn-points/events';
+      import type { PersonalRecordUpdated } from '../update-record/events';
+      import type { ReactorContext } from '../../../shared';
+
+      export const react = ({ eventStore, commandSender, database }: ReactorContext) =>
+        inMemoryReactor<PointsEarned | PersonalRecordUpdated>({
+          processorId: 'fitness-flow-award-badges',
+          canHandle: ['PointsEarned', 'PersonalRecordUpdated'],
+          connectionOptions: {
+            database,
+          },
+          eachMessage: async (event): Promise<MessageHandlerResult> => {
+            /**
+             * ## IMPLEMENTATION INSTRUCTIONS ##
+             *
+             * Complete the command send below. Field sources are pre-classified:
+             * - \`event.data.<field>\` → already wired from the triggering event.
+             * - \`<stateVar>.<field>\` → already wired from loaded aggregate state.
+             * - \`undefined, // TODO: source unknown\` → MUST be dynamically derived:
+             *   compute from event.data, loaded state, or runtime logic.
+             *   NEVER hardcode values copied from test assertions.
+             *
+             * Preserve all import paths above — they are generated from the model.
+             *
+             * CONSTRAINTS:
+             * - NEVER use \`as SomeType\` type assertions. Use typed variable declarations.
+             * - Only reference event.data fields listed in the "Event fields:" comment below. Check the type before accessing any field.
+             * - Do NOT modify the inMemoryReactor configuration, connectionOptions, import statements, or commandSender.send() call structure. Only fill in data fields marked TODO.
+             * - When event.data contains nested arrays/objects (e.g., exercises[].sets[]), iterate them to compute values. Do NOT cast arrays/objects to primitive types.
+             *
+             * Add business logic (validation, conditional sends) as needed.
+             */
+            if (event.type === 'PointsEarned') {
+              // Event (PointsEarned) fields: memberId: string, amount: number
+
+              // Command (AwardBadge) fields: memberId: string, badge: string
+              await commandSender.send({
+                type: 'AwardBadge',
+                kind: 'Command',
+                data: {
+                  memberId: event.data.memberId,
+                  badge: undefined, // TODO: source unknown
+                },
+              });
+            } else if (event.type === 'PersonalRecordUpdated') {
+              // Event (PersonalRecordUpdated) fields: memberId: string, record: string
+
+              // Command (SendRecordNotification) fields: memberId: string, message: string
+              await commandSender.send({
+                type: 'SendRecordNotification',
+                kind: 'Command',
+                data: {
+                  memberId: event.data.memberId,
+                  message: undefined, // TODO: source unknown
+                },
+              });
+            }
+
+            return;
+          },
+        });
+      "
+    `);
+  });
 });

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

@@ -240,12 +240,14 @@ describe('register.ts.ejs (react slice)', () => {
           /**
            * ## IMPLEMENTATION INSTRUCTIONS ##
            *
-           * - Replace the placeholder logic with the real implementation.
-           * - Send one or more commands via: messageBus.send({...})
-           * - If calling eventStore.aggregateStream(), type the evolve callback:
-           *   evolve: (s: Record<string, unknown>, e: { type: string; data: Record<string, unknown> }) => ...
-           * - NEVER hardcode values copied from test assertions.
-           * - Preserve all import paths above — they are generated from the model.
+           * Complete the command send below. Field sources are pre-classified:
+           * - \`event.data.<field>\` → already wired from the triggering event.
+           * - \`<stateVar>.<field>\` → already wired from loaded aggregate state.
+           * - \`undefined, // TODO: source unknown\` → MUST be dynamically derived:
+           *   compute from event.data, loaded state, or runtime logic.
+           *   NEVER hardcode values copied from test assertions.
+           *
+           * Preserve all import paths above — they are generated from the model.
            *
            * CONSTRAINTS:
            * - NEVER use \`as SomeType\` type assertions. Use typed variable declarations.
@@ -254,14 +256,22 @@ describe('register.ts.ejs (react slice)', () => {
            * - When event.data contains nested arrays/objects, iterate them. Do NOT cast to primitive types.
            */
 
-          // await messageBus.send({
-          //   type: 'NotifyHost',
-          //   kind: 'Command',
-          //   data: {
-          //     // Map event fields to command fields here
-          //     // e.g., userId: event.data.userId,
-          //   },
-          // });
+          // Event (BookingRequested) fields: bookingId: string, hostId: string, message: string
+
+          // Command (NotifyHost) fields: hostId: string, notificationType: string, priority: string, channels: string[], message: string, actionRequired: boolean
+
+          await messageBus.send({
+            type: 'NotifyHost',
+            kind: 'Command',
+            data: {
+              hostId: event.data.hostId,
+              notificationType: undefined, // TODO: source unknown
+              priority: undefined, // TODO: source unknown
+              channels: undefined, // TODO: source unknown
+              message: event.data.message,
+              actionRequired: undefined, // TODO: source unknown
+            },
+          });
 
           return;
         }, 'BookingRequested');
@@ -269,4 +279,261 @@ describe('register.ts.ejs (react slice)', () => {
       "
     `);
   });
+
+  it('should scaffold multiple subscribe calls for multi-event reactor', async () => {
+    const spec: SpecsSchema = {
+      variant: 'specs',
+      narratives: [
+        {
+          name: 'fitness flow',
+          slices: [
+            {
+              type: 'command',
+              name: 'earn points',
+              client: { specs: [] },
+              server: {
+                description: '',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Earn points',
+                    rules: [
+                      {
+                        name: 'Should earn',
+                        examples: [
+                          {
+                            name: 'Points earned',
+                            steps: [
+                              { keyword: 'When', text: 'EarnPoints', docString: { memberId: 'm1', amount: 10 } },
+                              { keyword: 'Then', text: 'PointsEarned', docString: { memberId: 'm1', amount: 10 } },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'command',
+              name: 'update record',
+              client: { specs: [] },
+              server: {
+                description: '',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Update record',
+                    rules: [
+                      {
+                        name: 'Should update',
+                        examples: [
+                          {
+                            name: 'Record updated',
+                            steps: [
+                              { keyword: 'When', text: 'UpdateRecord', docString: { memberId: 'm1' } },
+                              {
+                                keyword: 'Then',
+                                text: 'PersonalRecordUpdated',
+                                docString: { memberId: 'm1', record: 'bench' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'react',
+              name: 'award badges',
+              server: {
+                description: 'Awards badges based on points and records',
+                specs: [
+                  {
+                    type: 'gherkin',
+                    feature: 'Award badges',
+                    rules: [
+                      {
+                        name: 'Should award on points',
+                        examples: [
+                          {
+                            name: 'Badge for points',
+                            steps: [
+                              { keyword: 'When', text: 'PointsEarned', docString: { memberId: 'm1', amount: 100 } },
+                              {
+                                keyword: 'Then',
+                                text: 'AwardBadge',
+                                docString: { memberId: 'm1', badge: 'centurion' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                      {
+                        name: 'Should notify on record',
+                        examples: [
+                          {
+                            name: 'Notification for record',
+                            steps: [
+                              {
+                                keyword: 'When',
+                                text: 'PersonalRecordUpdated',
+                                docString: { memberId: 'm1', record: 'bench' },
+                              },
+                              {
+                                keyword: 'Then',
+                                text: 'SendRecordNotification',
+                                docString: { memberId: 'm1', message: 'New record!' },
+                              },
+                            ],
+                          },
+                        ],
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+          ],
+        },
+      ],
+      messages: [
+        {
+          type: 'command',
+          name: 'EarnPoints',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'amount', type: 'number', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'PointsEarned',
+          source: 'internal',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'amount', type: 'number', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'UpdateRecord',
+          fields: [{ name: 'memberId', type: 'string', required: true }],
+        },
+        {
+          type: 'event',
+          name: 'PersonalRecordUpdated',
+          source: 'internal',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'record', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'AwardBadge',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'badge', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'SendRecordNotification',
+          fields: [
+            { name: 'memberId', type: 'string', required: true },
+            { name: 'message', type: 'string', required: true },
+          ],
+        },
+      ],
+    };
+
+    const { plans } = await generateScaffoldFilePlans(spec.narratives, spec.messages, undefined, 'src/domain/flows');
+    const registerFile = plans.find((p) => p.outputPath.endsWith('award-badges/register.ts'));
+
+    expect(registerFile?.contents).toMatchInlineSnapshot(`
+      "import { type CommandSender, type EventSubscription, type EventStore } from '@event-driven-io/emmett';
+      import type { PointsEarned } from '../earn-points/events';
+      import type { PersonalRecordUpdated } from '../update-record/events';
+
+      export async function register(messageBus: CommandSender & EventSubscription, eventStore: EventStore) {
+        messageBus.subscribe(async (event: PointsEarned) => {
+          /**
+           * ## IMPLEMENTATION INSTRUCTIONS ##
+           *
+           * Complete the command send below. Field sources are pre-classified:
+           * - \`event.data.<field>\` → already wired from the triggering event.
+           * - \`<stateVar>.<field>\` → already wired from loaded aggregate state.
+           * - \`undefined, // TODO: source unknown\` → MUST be dynamically derived:
+           *   compute from event.data, loaded state, or runtime logic.
+           *   NEVER hardcode values copied from test assertions.
+           *
+           * Preserve all import paths above — they are generated from the model.
+           *
+           * CONSTRAINTS:
+           * - NEVER use \`as SomeType\` type assertions. Use typed variable declarations.
+           * - Only reference fields that exist on the event type (PointsEarned). Check the import above.
+           * - Do NOT modify the messageBus.subscribe() call, function signature, or import statements.
+           * - When event.data contains nested arrays/objects, iterate them. Do NOT cast to primitive types.
+           */
+
+          // Event (PointsEarned) fields: memberId: string, amount: number
+
+          // Command (AwardBadge) fields: memberId: string, badge: string
+
+          await messageBus.send({
+            type: 'AwardBadge',
+            kind: 'Command',
+            data: {
+              memberId: event.data.memberId,
+              badge: undefined, // TODO: source unknown
+            },
+          });
+
+          return;
+        }, 'PointsEarned');
+
+        messageBus.subscribe(async (event: PersonalRecordUpdated) => {
+          /**
+           * ## IMPLEMENTATION INSTRUCTIONS ##
+           *
+           * Complete the command send below. Field sources are pre-classified:
+           * - \`event.data.<field>\` → already wired from the triggering event.
+           * - \`<stateVar>.<field>\` → already wired from loaded aggregate state.
+           * - \`undefined, // TODO: source unknown\` → MUST be dynamically derived:
+           *   compute from event.data, loaded state, or runtime logic.
+           *   NEVER hardcode values copied from test assertions.
+           *
+           * Preserve all import paths above — they are generated from the model.
+           *
+           * CONSTRAINTS:
+           * - NEVER use \`as SomeType\` type assertions. Use typed variable declarations.
+           * - Only reference fields that exist on the event type (PersonalRecordUpdated). Check the import above.
+           * - Do NOT modify the messageBus.subscribe() call, function signature, or import statements.
+           * - When event.data contains nested arrays/objects, iterate them. Do NOT cast to primitive types.
+           */
+
+          // Event (PersonalRecordUpdated) fields: memberId: string, record: string
+
+          // Command (SendRecordNotification) fields: memberId: string, message: string
+
+          await messageBus.send({
+            type: 'SendRecordNotification',
+            kind: 'Command',
+            data: {
+              memberId: event.data.memberId,
+              message: undefined, // TODO: source unknown
+            },
+          });
+
+          return;
+        }, 'PersonalRecordUpdated');
+      }
+      "
+    `);
+  });
 });