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

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

@@ -0,0 +1,396 @@
+{
+  "variant": "specs",
+  "flows": [
+    {
+      "name": "Seasonal Assistant",
+      "slices": [
+        {
+          "type": "command",
+          "name": "enters shopping criteria into assistant",
+          "client": {
+            "specs": [
+              {
+                "description": "Assistant Chat Interface",
+                "should": [
+                  "allow shopper to describe their shopping needs in natural language",
+                  "provide a text input for entering criteria",
+                  "show examples of what to include (age, interests, budget)"
+                ]
+              }
+            ]
+          },
+          "clientDescription": "",
+          "server": {
+            "specs": [
+              {
+                "description": "When shopper submits criteria, a shopping session is started",
+                "should": [],
+                "when": {
+                  "type": "EnterShoppingCriteria",
+                  "data": {
+                    "shopperId": "shopper-123",
+                    "criteria": "I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering."
+                  },
+                  "__messageCategory": "command"
+                },
+                "then": [
+                  {
+                    "type": "ShoppingCriteriaEntered",
+                    "data": {
+                      "sessionId": "session-abc",
+                      "shopperId": "shopper-123",
+                      "criteria": "I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.",
+                      "timestamp": "2025-07-17T12:07:47.400Z"
+                    },
+                    "__messageCategory": "event"
+                  }
+                ]
+              }
+            ],
+            "data": [
+              {
+                "target": {
+                  "type": "Event",
+                  "name": "ShoppingCriteriaEntered"
+                },
+                "destination": {
+                  "type": "stream",
+                  "pattern": "shopping-session-{id}"
+                },
+                "__type": "sink"
+              }
+            ]
+          },
+          "serverDescription": ""
+        },
+        {
+          "type": "reaction",
+          "name": "finds items in product catalogue",
+          "server": {
+            "specs": [
+              {
+                "description": "When shopping criteria are entered, request wishlist creation",
+                "should": [],
+                "when": [
+                  {
+                    "type": "ShoppingCriteriaEntered",
+                    "data": {
+                      "sessionId": "session-abc",
+                      "shopperId": "shopper-123",
+                      "criteria": "I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.",
+                      "timestamp": "2025-07-17T12:07:47.400Z"
+                    },
+                    "__messageCategory": "event"
+                  }
+                ],
+                "then": [
+                  {
+                    "type": "DoChat",
+                    "data": {
+                      "sessionId": "session-abc",
+                      "prompt": "I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering."
+                    },
+                    "__messageCategory": "command"
+                  }
+                ]
+              }
+            ]
+          },
+          "serverDescription": ""
+        },
+        {
+          "type": "command",
+          "name": "Do Chat",
+          "server": {
+            "specs": [
+              {
+                "description": "When chat is triggered, AI suggests items based on product catalog",
+                "should": [],
+                "when": {
+                  "type": "DoChat",
+                  "data": {
+                    "sessionId": "session-abc",
+                    "prompt": "I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering."
+                  },
+                  "__messageCategory": "command"
+                },
+                "then": [
+                  {
+                    "type": "ChatCompleted",
+                    "data": {
+                      "sessionId": "session-abc",
+                      "suggestedItems": [
+                        {
+                          "productId": "prod-soccer-ball",
+                          "name": "Super Soccer Ball",
+                          "quantity": 1,
+                          "reason": "Perfect for your daughter who loves soccer"
+                        },
+                        {
+                          "productId": "prod-craft-kit",
+                          "name": "Deluxe Craft Kit",
+                          "quantity": 1,
+                          "reason": "Great for creative activities and crafts"
+                        },
+                        {
+                          "productId": "prod-laptop-bag",
+                          "name": "Tech Laptop Backpack",
+                          "quantity": 1,
+                          "reason": "Essential for your son's school computer needs"
+                        },
+                        {
+                          "productId": "prod-mtg-starter",
+                          "name": "Magic the Gathering Starter Set",
+                          "quantity": 1,
+                          "reason": "Ideal starter set for Magic the Gathering enthusiasts"
+                        }
+                      ],
+                      "timestamp": "2025-07-17T12:07:47.400Z"
+                    },
+                    "__messageCategory": "event"
+                  }
+                ]
+              }
+            ],
+            "data": [
+              {
+                "target": {
+                  "type": "Command",
+                  "name": "DoChat"
+                },
+                "destination": {
+                  "type": "integration",
+                  "systems": ["AI"]
+                },
+                "__type": "sink"
+              },
+              {
+                "target": {
+                  "type": "State",
+                  "name": "Products"
+                },
+                "origin": {
+                  "type": "integration",
+                  "systems": ["ProductCatalogService"]
+                },
+                "__type": "source"
+              }
+            ]
+          },
+          "serverDescription": ""
+        },
+        {
+          "type": "query",
+          "name": "views suggested items",
+          "request": {
+            "kind": "Document",
+            "definitions": [
+              {
+                "kind": "OperationDefinition",
+                "operation": "query",
+                "name": { "kind": "Name", "value": "GetSuggestedItems" },
+                "variableDefinitions": [
+                  {
+                    "kind": "VariableDefinition",
+                    "variable": {
+                      "kind": "Variable",
+                      "name": { "kind": "Name", "value": "sessionId" }
+                    },
+                    "type": {
+                      "kind": "NonNullType",
+                      "type": {
+                        "kind": "NamedType",
+                        "name": { "kind": "Name", "value": "ID" }
+                      }
+                    },
+                    "directives": []
+                  }
+                ],
+                "directives": [],
+                "selectionSet": {
+                  "kind": "SelectionSet",
+                  "selections": [
+                    {
+                      "kind": "Field",
+                      "name": { "kind": "Name", "value": "suggestedItems" },
+                      "arguments": [
+                        {
+                          "kind": "Argument",
+                          "name": { "kind": "Name", "value": "sessionId" },
+                          "value": {
+                            "kind": "Variable",
+                            "name": { "kind": "Name", "value": "sessionId" }
+                          }
+                        }
+                      ],
+                      "selectionSet": {
+                        "kind": "SelectionSet",
+                        "selections": [
+                          {
+                            "kind": "Field",
+                            "name": { "kind": "Name", "value": "items" },
+                            "selectionSet": {
+                              "kind": "SelectionSet",
+                              "selections": [
+                                { "kind": "Field", "name": { "kind": "Name", "value": "productId" } },
+                                { "kind": "Field", "name": { "kind": "Name", "value": "name" } },
+                                { "kind": "Field", "name": { "kind": "Name", "value": "quantity" } },
+                                { "kind": "Field", "name": { "kind": "Name", "value": "reason" } }
+                              ]
+                            }
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              }
+            ],
+            "loc": { "start": 0, "end": 229 }
+          },
+          "client": {
+            "specs": [
+              {
+                "description": "Suggested Items Screen",
+                "should": [
+                  "display all suggested items with names and reasons",
+                  "show quantity selectors for each item",
+                  "have an \"Add to Cart\" button for selected items",
+                  "allow removing items from the suggestions"
+                ]
+              }
+            ]
+          },
+          "clientDescription": "",
+          "server": {
+            "specs": [
+              {
+                "description": "Suggested items are available for viewing",
+                "should": [],
+                "when": {
+                  "type": "ChatCompleted",
+                  "data": {
+                    "sessionId": "session-abc",
+                    "suggestedItems": [
+                      {
+                        "productId": "prod-soccer-ball",
+                        "name": "Super Soccer Ball",
+                        "quantity": 1,
+                        "reason": "Perfect for your daughter who loves soccer"
+                      },
+                      {
+                        "productId": "prod-craft-kit",
+                        "name": "Deluxe Craft Kit",
+                        "quantity": 1,
+                        "reason": "Great for creative activities and crafts"
+                      },
+                      {
+                        "productId": "prod-laptop-bag",
+                        "name": "Tech Laptop Backpack",
+                        "quantity": 1,
+                        "reason": "Essential for your son's school computer needs"
+                      },
+                      {
+                        "productId": "prod-mtg-starter",
+                        "name": "Magic the Gathering Starter Set",
+                        "quantity": 1,
+                        "reason": "Ideal starter set for Magic the Gathering enthusiasts"
+                      }
+                    ],
+                    "timestamp": "2025-07-17T12:07:47.401Z"
+                  },
+                  "__messageCategory": "event"
+                },
+                "then": [
+                  {
+                    "type": "SuggestedItems",
+                    "data": {
+                      "sessionId": "session-abc",
+                      "items": [
+                        { "productId": "prod-soccer-ball", "quantity": 1 },
+                        { "productId": "prod-craft-kit", "quantity": 1 },
+                        { "productId": "prod-laptop-bag", "quantity": 1 },
+                        { "productId": "prod-mtg-starter", "quantity": 1 }
+                      ]
+                    },
+                    "__messageCategory": "state"
+                  }
+                ]
+              }
+            ],
+            "data": [
+              {
+                "target": {
+                  "type": "State",
+                  "name": "SuggestedItems"
+                },
+                "origin": {
+                  "type": "projection",
+                  "name": "SuggestedItemsProjection"
+                },
+                "__type": "source"
+              }
+            ]
+          },
+          "serverDescription": ""
+        },
+        {
+          "type": "command",
+          "name": "accepts items and adds to their cart",
+          "client": {
+            "specs": [
+              {
+                "description": "Suggested Items Screen",
+                "should": [
+                  "allow selecting specific items to add",
+                  "update quantities before adding to cart",
+                  "provide feedback when items are added"
+                ]
+              }
+            ]
+          },
+          "clientDescription": "",
+          "server": {
+            "specs": [
+              {
+                "description": "When shopper accepts items, they are added to cart",
+                "should": [],
+                "when": {
+                  "type": "AddItemsToCart",
+                  "data": {
+                    "sessionId": "session-abc",
+                    "items": [
+                      { "productId": "prod-soccer-ball", "quantity": 1 },
+                      { "productId": "prod-craft-kit", "quantity": 1 },
+                      { "productId": "prod-laptop-bag", "quantity": 1 },
+                      { "productId": "prod-mtg-starter", "quantity": 1 }
+                    ]
+                  },
+                  "__messageCategory": "command"
+                },
+                "then": [
+                  {
+                    "type": "ItemsAddedToCart",
+                    "data": {
+                      "cartId": "cart-xyz",
+                      "shopperId": "shopper-123",
+                      "items": [
+                        { "productId": "prod-soccer-ball", "quantity": 1 },
+                        { "productId": "prod-craft-kit", "quantity": 1 },
+                        { "productId": "prod-laptop-bag", "quantity": 1 },
+                        { "productId": "prod-mtg-starter", "quantity": 1 }
+                      ],
+                      "timestamp": "2025-07-17T12:07:47.401Z"
+                    },
+                    "__messageCategory": "event"
+                  }
+                ]
+              }
+            ]
+          },
+          "serverDescription": ""
+        }
+      ]
+    }
+  ]
+}

package/src/codegen/types.ts

@@ -0,0 +1,35 @@
+import { CommandExample, EventExample } from '@auto-engineer/flow';
+
+export interface Message {
+  type: string;
+  fields: Field[];
+  source?: 'when' | 'given' | 'then';
+  sourceFlowName?: string;
+  sourceSliceName?: string;
+}
+
+export interface Field {
+  name: string;
+  tsType: string;
+  required: boolean;
+}
+
+export interface MessageDefinition {
+  type: 'command' | 'event' | 'state';
+  name: string;
+  fields?: Array<{
+    name: string;
+    type: string;
+    required?: boolean;
+    description?: string;
+    defaultValue?: unknown;
+  }>;
+  metadata?: unknown;
+  description?: string;
+}
+
+export interface GwtCondition {
+  given?: EventExample[];
+  when: CommandExample;
+  then: Array<EventExample | { errorType: string; message?: string }>;
+}

package/src/codegen/utils/path.ts

@@ -0,0 +1,20 @@
+import path from 'path';
+import { mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+
+export function toKebabCase(str: string): string {
+  return str
+    .replace(/([a-z])([A-Z])/g, '$1-$2')
+    .replace(/\s+/g, '-')
+    .toLowerCase();
+}
+
+export function ensureDirPath(...segments: string[]): string {
+  return path.join(...segments);
+}
+
+export async function ensureDirExists(dirPath: string): Promise<void> {
+  if (!existsSync(dirPath)) {
+    await mkdir(dirPath, { recursive: true });
+  }
+}