@auto-engineer/server-generator-apollo-emmett 1.89.0 → 1.95.0

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

@@ -81,35 +81,39 @@ describe('evolve.ts.ejs', () => {
     const evolveFile = plans.find((p) => p.outputPath.endsWith('evolve.ts'));
 
     expect(evolveFile?.contents).toMatchInlineSnapshot(`
-          "import type { State } from './state';
-          import type { ListingCreated } from './events';
+      "import type { State } from './state';
+      import type { ListingCreated } from './events';
 
-          /**
-           * ## IMPLEMENTATION INSTRUCTIONS ##
-           *
-           * This function defines how the domain state evolves in response to events.
-           *
-           * 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.
-           */
+      /**
+       * ## IMPLEMENTATION INSTRUCTIONS ##
+       *
+       * This function defines how the domain state evolves in response to events.
+       *
+       * 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 };\`
+       */
 
-          export const evolve = (state: State, event: ListingCreated): State => {
-            switch (event.type) {
-              case 'ListingCreated': {
-                // TODO: Update state based on ListingCreated
-                return {
-                  ...state,
-                };
-              }
-              default:
-                return state;
-            }
-          };
-          "
-        `);
+      export const evolve = (state: State, event: ListingCreated): State => {
+        switch (event.type) {
+          case 'ListingCreated': {
+            // TODO: Update state based on ListingCreated
+            return {
+              ...state,
+            };
+          }
+          default:
+            return state;
+        }
+      };
+      "
+    `);
   });
 });

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

@@ -15,6 +15,10 @@
     * - 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 };`
     */
 
     export const evolve = (

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

@@ -1571,6 +1571,7 @@ describe('projection.specs.ts.ejs', () => {
       * Derive ALL field values from event.data or existing document state.
       * NEVER hardcode constant values — every output field must trace to an input.
       * Preserve all import paths above — they are generated from the model.
+      * ⚠️ \`document\` may be null (first event for this entity). Guard before accessing properties.
       *
           * Implement how this event updates the projection.
           *

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

@@ -243,6 +243,7 @@ describe('projection.ts.ejs', () => {
       * Derive ALL field values from event.data or existing document state.
       * NEVER hardcode constant values — every output field must trace to an input.
       * Preserve all import paths above — they are generated from the model.
+      * ⚠️ \`document\` may be null (first event for this entity). Guard before accessing properties.
       *
           * Implement how this event updates the projection.
           *
@@ -282,6 +283,7 @@ describe('projection.ts.ejs', () => {
       * Derive ALL field values from event.data or existing document state.
       * NEVER hardcode constant values — every output field must trace to an input.
       * Preserve all import paths above — they are generated from the model.
+      * ⚠️ \`document\` may be null (first event for this entity). Guard before accessing properties.
       *
           * This event might indicate removal of a AvailableListings.
           *
@@ -582,6 +584,7 @@ describe('projection.ts.ejs', () => {
       * Derive ALL field values from event.data or existing document state.
       * NEVER hardcode constant values — every output field must trace to an input.
       * Preserve all import paths above — they are generated from the model.
+      * ⚠️ \`document\` may be null (first event for this entity). Guard before accessing properties.
       *
           * **SINGLETON AGGREGATION PATTERN**
           *
@@ -803,6 +806,7 @@ describe('projection.ts.ejs', () => {
       * Derive ALL field values from event.data or existing document state.
       * NEVER hardcode constant values — every output field must trace to an input.
       * Preserve all import paths above — they are generated from the model.
+      * ⚠️ \`document\` may be null (first event for this entity). Guard before accessing properties.
       *
           * **COMPOSITE KEY PROJECTION**
           *

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

@@ -124,6 +124,7 @@ case '<%= event.type %>': {
 * Derive ALL field values from event.data or existing document state.
 * NEVER hardcode constant values — every output field must trace to an input.
 * Preserve all import paths above — they are generated from the model.
+* ⚠️ `document` may be null (first event for this entity). Guard before accessing properties.
 *
 <% if (isSingleton) { -%>
     * **SINGLETON AGGREGATION PATTERN**