@auto-engineer/server-generator-apollo-emmett 0.1.1

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

@@ -0,0 +1,222 @@
+import { describe, it, expect } from 'vitest';
+import { SpecsSchemaType as SpecsSchema } from '@auto-engineer/flow';
+import { generateScaffoldFilePlans } from '../../scaffoldFromSchema';
+
+describe('register.ts.ejs (react slice)', () => {
+  it('should generate correct register.ts', async () => {
+    const spec: SpecsSchema = {
+      variant: 'specs',
+      flows: [
+        {
+          name: 'manage bookings',
+          slices: [
+            {
+              type: 'command',
+              name: 'guest submits booking request',
+              client: { description: '', specs: [] },
+              server: {
+                description: '',
+                gwt: [
+                  {
+                    when: {
+                      commandRef: 'RequestBooking',
+                      exampleData: {
+                        propertyId: 'listing_123',
+                        hostId: 'host_123',
+                        guestId: 'guest_456',
+                        checkIn: '2025-07-15',
+                        checkOut: '2025-07-18',
+                        guests: 2,
+                        message: 'Looking forward to my stay!',
+                        metadata: { now: 'bar', bookingId: '123' },
+                      },
+                    },
+                    then: [
+                      {
+                        eventRef: 'BookingRequested',
+                        exampleData: {
+                          bookingId: 'book_xyz789',
+                          hostId: 'host_123',
+                          propertyId: 'prop_789',
+                          guestId: 'guest_456',
+                          checkIn: '2025-07-15',
+                          checkOut: '2025-07-18',
+                          guests: 2,
+                          message: 'Hey',
+                          status: 'pending_host_approval',
+                          requestedAt: '2025-06-10T16:30:00.000Z',
+                          expiresAt: '2025-06-11T16:30:00.000Z',
+                        },
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'react',
+              name: 'Send notification to host',
+              server: {
+                description: 'Sends a host notification command in response to BookingRequested',
+                gwt: [
+                  {
+                    when: [
+                      {
+                        eventRef: 'BookingRequested',
+                        exampleData: {
+                          bookingId: 'book_xyz789',
+                          hostId: 'host_123',
+                          propertyId: 'prop_789',
+                          guestId: 'guest_456',
+                          checkIn: '2025-07-15',
+                          checkOut: '2025-07-18',
+                          guests: 2,
+                          message: 'Hey',
+                          status: 'pending_host_approval',
+                          requestedAt: '2025-06-10T16:30:00.000Z',
+                          expiresAt: '2025-06-11T16:30:00.000Z',
+                        },
+                      },
+                    ],
+                    then: [
+                      {
+                        commandRef: 'NotifyHost',
+                        exampleData: {
+                          hostId: 'host_123',
+                          notificationType: 'booking_request',
+                          priority: 'high',
+                          channels: ['email', 'push'],
+                          message: 'A guest has requested to book your place.',
+                          actionRequired: true,
+                        },
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+            {
+              type: 'command',
+              name: 'notify host',
+              client: { description: '', specs: [] },
+              server: {
+                description: '',
+                gwt: [
+                  {
+                    when: {
+                      commandRef: 'NotifyHost',
+                      exampleData: {
+                        hostId: 'host_123',
+                        notificationType: 'booking_request',
+                        priority: 'high',
+                        channels: ['email', 'push'],
+                        message: 'A guest has requested to book your place.',
+                        actionRequired: true,
+                      },
+                    },
+                    then: [
+                      {
+                        eventRef: 'HostNotified',
+                        exampleData: {
+                          bookingId: 'book_xyz789',
+                          hostId: 'host_123',
+                          notificationType: 'booking_request',
+                          channels: ['email', 'push'],
+                          message: 'hi.',
+                          notifiedAt: '2025-06-10T16:30:00.000Z',
+                          actionRequired: true,
+                        },
+                      },
+                    ],
+                  },
+                ],
+              },
+            },
+          ],
+        },
+      ],
+      messages: [
+        {
+          type: 'command',
+          name: 'RequestBooking',
+          fields: [
+            { name: 'propertyId', type: 'string', required: true },
+            { name: 'hostId', type: 'string', required: true },
+            { name: 'guestId', type: 'string', required: true },
+            { name: 'checkIn', type: 'date', required: true },
+            { name: 'checkOut', type: 'date', required: true },
+            { name: 'guests', type: 'number', required: true },
+            { name: 'message', type: 'string', required: false },
+          ],
+        },
+        {
+          type: 'command',
+          name: 'NotifyHost',
+          fields: [
+            { name: 'hostId', type: 'string', required: true },
+            { name: 'notificationType', type: 'string', required: true },
+            { name: 'priority', type: 'string', required: true },
+            { name: 'channels', type: 'string[]', required: true },
+            { name: 'message', type: 'string', required: true },
+            { name: 'actionRequired', type: 'boolean', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'BookingRequested',
+          source: 'internal',
+          fields: [
+            { name: 'bookingId', type: 'string', required: true },
+            { name: 'hostId', type: 'string', required: true },
+            { name: 'message', type: 'string', required: true },
+          ],
+        },
+        {
+          type: 'event',
+          name: 'HostNotified',
+          source: 'internal',
+          fields: [
+            { name: 'bookingId', type: 'string', required: true },
+            { name: 'hostId', type: 'string', required: true },
+            { name: 'notificationType', type: 'string', required: true },
+            { name: 'channels', type: 'string[]', required: true },
+            { name: 'notifiedAt', type: 'date', required: true },
+            { name: 'actionRequired', type: 'boolean', required: true },
+            { name: 'message', type: 'string', required: true },
+          ],
+        },
+      ],
+    };
+
+    const plans = await generateScaffoldFilePlans(spec.flows, spec.messages, undefined, 'src/domain/flows');
+    const registerFile = plans.find((p) => p.outputPath.endsWith('send-notification-to-host/register.ts'));
+
+    expect(registerFile?.contents).toMatchInlineSnapshot(`
+          "import { type CommandSender, type EventSubscription, type InMemoryEventStore } from '@event-driven-io/emmett';
+          import type { BookingRequested } from '../guest-submits-booking-request/events';
+
+          export async function register(messageBus: CommandSender & EventSubscription, eventStore: InMemoryEventStore) {
+            messageBus.subscribe(async (event: BookingRequested) => {
+              /**
+               * ## IMPLEMENTATION INSTRUCTIONS ##
+               *
+               * - Replace the placeholder logic with the  real implementation.
+               * - Send one or more commands via: messageBus.send({...})
+               */
+
+              // await messageBus.send({
+              //   type: 'NotifyHost',
+              //   kind: 'Command',
+              //   data: {
+              //     // Map event fields to command fields here
+              //     // e.g., userId: event.data.userId,
+              //   },
+              // });
+
+              return;
+            }, 'BookingRequested');
+          }
+          "
+        `);
+  });
+});

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

@@ -0,0 +1,39 @@
+<%
+const gwt = slice.server?.gwt?.[0];
+const when = Array.isArray(gwt?.when) ? gwt.when[0] : gwt?.when;
+const then = Array.isArray(gwt?.then) ? gwt.then[0] : gwt?.then;
+
+const eventType = when?.eventRef;
+const commandType = then?.commandRef;
+const event = events.find(e => e.type === eventType);
+%>
+import { type CommandSender, type EventSubscription, type InMemoryEventStore } from '@event-driven-io/emmett';
+import type { <%= pascalCase(eventType) %> } from '../<%= toKebabCase(event?.sourceSliceName ?? 'unknown') %>/events';
+
+export async function register(
+messageBus: CommandSender & EventSubscription,
+eventStore: InMemoryEventStore
+) {
+messageBus.subscribe(
+async (event: <%= pascalCase(eventType) %>) => {
+/**
+* ## IMPLEMENTATION INSTRUCTIONS ##
+*
+* - Replace the placeholder logic with the  real implementation.
+* - Send one or more commands via: messageBus.send({...})
+*/
+
+// await messageBus.send({
+//   type: '<%= commandType %>',
+//   kind: 'Command',
+//   data: {
+//     // Map event fields to command fields here
+//     // e.g., userId: event.data.userId,
+//   },
+// });
+
+return;
+},
+'<%= eventType %>'
+);
+}

package/src/codegen/test-data/specVariant1.json

@@ -0,0 +1,212 @@
+{
+  "variant": "specs",
+  "flows": [
+    {
+      "name": "Add item",
+      "description": "Flow to add items to a system",
+      "slices": [
+        {
+          "type": "command",
+          "stream": "item-${itemId}",
+          "name": "Create item",
+          "description": "Handles item creation",
+          "client": {
+            "description": "A form that allows users to add items",
+            "specs": ["have fields for id and description"]
+          },
+          "server": {
+            "description": "Handles creation logic",
+            "gwt": [
+              {
+                "when": {
+                  "commandRef": "CreateItem",
+                  "exampleData": {
+                    "itemId": "item_123",
+                    "description": "A new item"
+                  }
+                },
+                "then": [
+                  {
+                    "eventRef": "ItemCreated",
+                    "exampleData": {
+                      "id": "item_123",
+                      "description": "A new item",
+                      "addedAt": "2024-01-15T10:00:00.000Z"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "type": "command",
+          "name": "Notify new item",
+          "description": "Handles the NotifyNewItem command",
+          "server": {
+            "description": "Sends a system notification and emits NotificationSent",
+            "gwt": [
+              {
+                "when": {
+                  "commandRef": "NotifyNewItem",
+                  "exampleData": {
+                    "itemId": "item_123",
+                    "message": "A new item was added to the system."
+                  }
+                },
+                "then": [
+                  {
+                    "eventRef": "NotificationSent",
+                    "exampleData": {
+                      "itemId": "item_123",
+                      "message": "A new item was added to the system.",
+                      "sentAt": "2024-01-15T10:00:00.000Z"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "type": "query",
+          "name": "Get available items",
+          "description": "Projection of available items",
+          "client": {
+            "description": "Show available items",
+            "specs": []
+          },
+          "server": {
+            "description": "Project items based on ItemCreated",
+            "data": [
+              {
+                "origin": {
+                  "type": "projection",
+                  "name": "ItemCreated",
+                  "idField": "id"
+                },
+                "target": {
+                  "type": "State",
+                  "name": "AvailableItems",
+                  "fields": {
+                    "id": { "type": "string" },
+                    "description": { "type": "string" },
+                    "addedAt": { "type": "Date" }
+                  }
+                }
+              }
+            ],
+            "gwt": [
+              {
+                "given": [
+                  {
+                    "eventRef": "ItemCreated",
+                    "exampleData": {
+                      "id": "item_123",
+                      "description": "A new item",
+                      "addedAt": "2024-01-15T10:00:00.000Z"
+                    }
+                  }
+                ],
+                "then": [
+                  {
+                    "stateRef": "AvailableItems",
+                    "exampleData": {
+                      "id": "item_123",
+                      "description": "A new item",
+                      "addedAt": "2024-01-15T10:00:00.000Z"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "type": "react",
+          "name": "Notify on new item",
+          "description": "Sends a notification command when a new item is created",
+          "server": {
+            "description": "Triggers NotifyNewItem command in response to ItemCreated",
+            "gwt": [
+              {
+                "when": [
+                  {
+                    "eventRef": "ItemCreated",
+                    "exampleData": {
+                      "id": "item_123",
+                      "description": "A new item",
+                      "addedAt": "2024-01-15T10:00:00.000Z"
+                    }
+                  }
+                ],
+                "then": [
+                  {
+                    "commandRef": "NotifyNewItem",
+                    "exampleData": {
+                      "itemId": "item_123",
+                      "message": "A new item was added to the system."
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "messages": [
+    {
+      "type": "command",
+      "name": "CreateItem",
+      "description": "Command to create a new item",
+      "fields": [
+        { "name": "itemId", "type": "string", "required": true },
+        { "name": "description", "type": "string", "required": true }
+      ],
+      "metadata": {
+        "version": 1
+      }
+    },
+    {
+      "type": "command",
+      "name": "NotifyNewItem",
+      "description": "Command to notify other systems when a new item is created",
+      "fields": [
+        { "name": "itemId", "type": "string", "required": true },
+        { "name": "message", "type": "string", "required": true }
+      ],
+      "metadata": {
+        "version": 1
+      }
+    },
+    {
+      "type": "event",
+      "name": "ItemCreated",
+      "description": "Event emitted when an item is created",
+      "source": "internal",
+      "fields": [
+        { "name": "id", "type": "string", "required": true },
+        { "name": "description", "type": "string", "required": true },
+        { "name": "addedAt", "type": "Date", "required": true }
+      ],
+      "metadata": {
+        "version": 1
+      }
+    },
+    {
+      "type": "state",
+      "name": "AvailableItems",
+      "description": "State representing available items in the system",
+      "fields": [
+        { "name": "id", "type": "string", "required": true },
+        { "name": "description", "type": "string", "required": true },
+        { "name": "addedAt", "type": "Date", "required": true }
+      ],
+      "metadata": {
+        "version": 1
+      }
+    }
+  ]
+}

package/src/codegen/test-data/specVariant1.ts

@@ -0,0 +1,188 @@
+import { SpecsSchemaType as SpecsSchema } from '@auto-engineer/flow';
+
+const specVariant1: SpecsSchema = {
+  variant: 'specs',
+  flows: [
+    {
+      name: 'Add item',
+      description: 'Flow to add items to a system',
+      slices: [
+        {
+          type: 'command',
+          stream: 'item-${itemId}',
+          name: 'Create item',
+          description: 'Handles item creation',
+          client: {
+            description: 'A form that allows users to add items',
+            specs: ['have fields for id and description'],
+          },
+
+          server: {
+            description: 'Handles creation logic',
+            gwt: [
+              {
+                when: {
+                  commandRef: 'CreateItem',
+                  exampleData: {
+                    itemId: 'item_123',
+                    description: 'A new item',
+                  },
+                },
+                then: [
+                  {
+                    eventRef: 'ItemCreated',
+                    exampleData: {
+                      id: 'item_123',
+                      description: 'A new item',
+                      addedAt: '2024-01-15T10:00:00.000Z',
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        },
+        {
+          type: 'query',
+          name: 'Get available items',
+          description: 'Projection of available items',
+          client: {
+            description: 'Show available items',
+            specs: [],
+          },
+          server: {
+            description: 'Project items based on ItemCreated',
+            data: [
+              {
+                origin: {
+                  type: 'projection',
+                  name: 'ItemCreated',
+                  idField: 'id',
+                },
+                target: {
+                  type: 'State',
+                  name: 'AvailableItems',
+                  fields: {
+                    id: { type: 'string' },
+                    description: { type: 'string' },
+                    addedAt: { type: 'Date' },
+                  },
+                },
+              },
+            ],
+            gwt: [
+              {
+                given: [
+                  {
+                    eventRef: 'ItemCreated',
+                    exampleData: {
+                      id: 'item_123',
+                      description: 'A new item',
+                      addedAt: '2024-01-15T10:00:00.000Z',
+                    },
+                  },
+                ],
+                then: [
+                  {
+                    stateRef: 'AvailableItems',
+                    exampleData: {
+                      id: 'item_123',
+                      description: 'A new item',
+                      addedAt: '2024-01-15T10:00:00.000Z',
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        },
+        {
+          type: 'react',
+          name: 'Notify on new item',
+          description: 'Sends a notification command when a new item is created',
+          server: {
+            description: 'Triggers NotifyNewItem command in response to ItemCreated',
+            gwt: [
+              {
+                when: [
+                  {
+                    eventRef: 'ItemCreated',
+                    exampleData: {
+                      id: 'item_123',
+                      description: 'A new item',
+                      addedAt: '2024-01-15T10:00:00.000Z',
+                    },
+                  },
+                ],
+                then: [
+                  {
+                    commandRef: 'NotifyNewItem',
+                    exampleData: {
+                      itemId: 'item_123',
+                      message: 'A new item was added to the system.',
+                    },
+                  },
+                ],
+              },
+            ],
+          },
+        },
+      ],
+    },
+  ],
+  messages: [
+    {
+      type: 'command',
+      name: 'CreateItem',
+      description: 'Command to create a new item',
+      fields: [
+        { name: 'itemId', type: 'string', required: true },
+        { name: 'description', type: 'string', required: true },
+      ],
+      metadata: {
+        version: 1,
+      },
+    },
+    {
+      type: 'command',
+      name: 'NotifyNewItem',
+      description: 'Command to notify other systems when a new item is created',
+      fields: [
+        { name: 'itemId', type: 'string', required: true },
+        { name: 'message', type: 'string', required: true },
+      ],
+      metadata: {
+        version: 1,
+      },
+    },
+    {
+      type: 'event',
+      name: 'ItemCreated',
+      description: 'Event emitted when an item is created',
+      source: 'internal',
+      fields: [
+        { name: 'id', type: 'string', required: true },
+        { name: 'description', type: 'string', required: true },
+        { name: 'addedAt', type: 'Date', required: true },
+      ],
+      metadata: {
+        version: 1,
+      },
+    },
+    {
+      type: 'state',
+      name: 'AvailableItems',
+      description: 'State representing available items in the system',
+      fields: [
+        { name: 'id', type: 'string', required: true },
+        { name: 'description', type: 'string', required: true },
+        { name: 'addedAt', type: 'Date', required: true },
+      ],
+      metadata: {
+        version: 1,
+      },
+    },
+  ],
+};
+
+export default specVariant1;