@auto-engineer/server-generator-nestjs 1.87.0 → 1.89.0

package/CHANGELOG.md

@@ -1,5 +1,100 @@
 # @auto-engineer/server-generator-nestjs
 
+## 1.89.0
+
+### Minor Changes
+
+- [`93ff5a5`](https://github.com/BeOnAuto/auto-engineer/commit/93ff5a559f087bb875b2b1e165713e1dc6fbea5b) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: embed instructions in scaffold templates
+
+- [`514525d`](https://github.com/BeOnAuto/auto-engineer/commit/514525d0ae9542693fc44e6922fd0c31d229c8c9) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: export validateSliceRequests and add integration tests
+
+- [`7af6ae4`](https://github.com/BeOnAuto/auto-engineer/commit/7af6ae46d50a7115da047d07824a4d3e4983338f) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: add nested field validation for query slice requests
+
+- [`971394a`](https://github.com/BeOnAuto/auto-engineer/commit/971394ad8d47faad27acf6c4fa82d11010568cda) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: type-annotate aggregateStream + dynamic error listing
+
+- [`dbfbe69`](https://github.com/BeOnAuto/auto-engineer/commit/dbfbe69e5fc1efb8a65df1d3d480b36c9666b95a) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: add validate-slice-requests skeleton with parse safety
+
+- [`d7b3af9`](https://github.com/BeOnAuto/auto-engineer/commit/d7b3af912b1e9f7e4f0bfc91b65768341f87229c) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: add query validation for operation type, state, and top-level fields
+
+- [`a36fc79`](https://github.com/BeOnAuto/auto-engineer/commit/a36fc79f40d236b49983574a7f8607e9028e3daf) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: filter linking field to primitive types only
+
+- [`73ef7b1`](https://github.com/BeOnAuto/auto-engineer/commit/73ef7b1f2818e72cc5b1cc77400f44ed948e0d39) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: filter event And-steps from react Then items
+
+- [`ea41643`](https://github.com/BeOnAuto/auto-engineer/commit/ea41643cbd1303f50313e7dd20d92d4f3a775114) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: use parsedRequest for command mutation names
+
+- [`3e9cf93`](https://github.com/BeOnAuto/auto-engineer/commit/3e9cf93af40df9636ae33b9e749dd85ca0b0802e) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: add expectEvents typing shim to decide.specs.ts.ejs
+
+- [`0231c5f`](https://github.com/BeOnAuto/auto-engineer/commit/0231c5f5a771786d6534c8a0f9d6dd2856d6b893) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: parseGraphQlRequest accepts mutation operations
+
+- [`aacffe9`](https://github.com/BeOnAuto/auto-engineer/commit/aacffe9244a1b364f550caf9b0d5d9ce9c905c2c) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-nestjs**: use parsedRequest for mutation and query names
+
+- [`a527ccc`](https://github.com/BeOnAuto/auto-engineer/commit/a527ccc39d7f769609252ebefcb4b26e5fe84316) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: add mutation validation to validate-slice-requests
+
+### Patch Changes
+
+- [`dc9b7d9`](https://github.com/BeOnAuto/auto-engineer/commit/dc9b7d9cbcebaf5e34025b6f08b9152f87a67073) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: update ketchup plan for bursts 13-14
+
+- [`1d1f519`](https://github.com/BeOnAuto/auto-engineer/commit/1d1f519fa17ba95228e58ef12ce64e3919c0697d) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: add ketchup plan for validate-slice-requests
+
+- [`8bbbc30`](https://github.com/BeOnAuto/auto-engineer/commit/8bbbc309734ff5dce3b51473f018caa31208fa7a) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: mark burst 18 done in ketchup plan
+
+- [`aabe8ae`](https://github.com/BeOnAuto/auto-engineer/commit/aabe8ae4feb13e8ee4b6d3e8a7ef50bb845eaebf) Thanks [@github-actions[bot]](https://github.com/github-actions%5Bbot%5D)! - - **server-generator-apollo-emmett**: derive stable metadata.now for ISO date fields
+  - **server-generator-apollo-emmett**: resolve findOne idField from events when missing in Then state
+  - **server-generator-apollo-emmett**: return array idField natively from extraction
+  - **server-implementer**: add prompt guardrails for phantom enums and hardcoded projections
+  - **server-generator-apollo-emmett**: align instruction comment with \_state parameter name
+
+- [`5af523f`](https://github.com/BeOnAuto/auto-engineer/commit/5af523f9cb5d1a4e6275589e1f12173637c6458e) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: fix [object Object] serialization bugs
+
+- [`a4053ef`](https://github.com/BeOnAuto/auto-engineer/commit/a4053ef91284b9718bacef58ebd3ab250d4cda79) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: update decide.specs.ts snapshots for dynamic errors
+
+- [`b63c308`](https://github.com/BeOnAuto/auto-engineer/commit/b63c308209f0316ea3b0433a82d46dec8e15169a) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-implementer**: add anti-hardcoding rules for decide functions
+
+- [`1947b66`](https://github.com/BeOnAuto/auto-engineer/commit/1947b66d0b4687abcde75f29fc32c8665b929582) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: move burst 17 to done in ketchup plan
+
+- [`16c9541`](https://github.com/BeOnAuto/auto-engineer/commit/16c954130331be27f54f2e1ef451545b7e22161d) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: extract parseGraphQlRequest to narrative package
+
+- [`bad8ef9`](https://github.com/BeOnAuto/auto-engineer/commit/bad8ef9ceb73f9b7efda58f821073ec9894ee7fb) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: rename ParsedGraphQlQuery to ParsedGraphQlOperation
+
+- [`a058731`](https://github.com/BeOnAuto/auto-engineer/commit/a0587319d6772df61b4004df1584d884222e7304) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **global**: add ketchup plan for parsedRequest mutation names
+
+- [`d6f6ef6`](https://github.com/BeOnAuto/auto-engineer/commit/d6f6ef6f79ceb712ccfcf00a22789c55d6e9a0b4) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: omit non-command fields from Then assertions
+  - **server-generator-apollo-emmett**: derive stable metadata.now for ISO date fields
+  - **server-generator-apollo-emmett**: resolve findOne idField from events when missing in Then state
+  - **server-generator-apollo-emmett**: return array idField natively from extraction
+  - **server-implementer**: add prompt guardrails for phantom enums and hardcoded projections
+
+- [`667b53f`](https://github.com/BeOnAuto/auto-engineer/commit/667b53f02b3cc933efe520022dd2f85ba1fbec3b) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: move burst 14 to done in ketchup plan
+
+- [`e69b385`](https://github.com/BeOnAuto/auto-engineer/commit/e69b38526ab9fd522ef91955a3ee98ed3c611473) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **narrative**: mark all bursts done in ketchup plan
+
+- Updated dependencies [[`dc9b7d9`](https://github.com/BeOnAuto/auto-engineer/commit/dc9b7d9cbcebaf5e34025b6f08b9152f87a67073), [`93ff5a5`](https://github.com/BeOnAuto/auto-engineer/commit/93ff5a559f087bb875b2b1e165713e1dc6fbea5b), [`514525d`](https://github.com/BeOnAuto/auto-engineer/commit/514525d0ae9542693fc44e6922fd0c31d229c8c9), [`7af6ae4`](https://github.com/BeOnAuto/auto-engineer/commit/7af6ae46d50a7115da047d07824a4d3e4983338f), [`1d1f519`](https://github.com/BeOnAuto/auto-engineer/commit/1d1f519fa17ba95228e58ef12ce64e3919c0697d), [`8bbbc30`](https://github.com/BeOnAuto/auto-engineer/commit/8bbbc309734ff5dce3b51473f018caa31208fa7a), [`aabe8ae`](https://github.com/BeOnAuto/auto-engineer/commit/aabe8ae4feb13e8ee4b6d3e8a7ef50bb845eaebf), [`971394a`](https://github.com/BeOnAuto/auto-engineer/commit/971394ad8d47faad27acf6c4fa82d11010568cda), [`5af523f`](https://github.com/BeOnAuto/auto-engineer/commit/5af523f9cb5d1a4e6275589e1f12173637c6458e), [`a4053ef`](https://github.com/BeOnAuto/auto-engineer/commit/a4053ef91284b9718bacef58ebd3ab250d4cda79), [`dbfbe69`](https://github.com/BeOnAuto/auto-engineer/commit/dbfbe69e5fc1efb8a65df1d3d480b36c9666b95a), [`d7b3af9`](https://github.com/BeOnAuto/auto-engineer/commit/d7b3af912b1e9f7e4f0bfc91b65768341f87229c), [`a36fc79`](https://github.com/BeOnAuto/auto-engineer/commit/a36fc79f40d236b49983574a7f8607e9028e3daf), [`73ef7b1`](https://github.com/BeOnAuto/auto-engineer/commit/73ef7b1f2818e72cc5b1cc77400f44ed948e0d39), [`ea41643`](https://github.com/BeOnAuto/auto-engineer/commit/ea41643cbd1303f50313e7dd20d92d4f3a775114), [`3e9cf93`](https://github.com/BeOnAuto/auto-engineer/commit/3e9cf93af40df9636ae33b9e749dd85ca0b0802e), [`0231c5f`](https://github.com/BeOnAuto/auto-engineer/commit/0231c5f5a771786d6534c8a0f9d6dd2856d6b893), [`b63c308`](https://github.com/BeOnAuto/auto-engineer/commit/b63c308209f0316ea3b0433a82d46dec8e15169a), [`1947b66`](https://github.com/BeOnAuto/auto-engineer/commit/1947b66d0b4687abcde75f29fc32c8665b929582), [`aacffe9`](https://github.com/BeOnAuto/auto-engineer/commit/aacffe9244a1b364f550caf9b0d5d9ce9c905c2c), [`a527ccc`](https://github.com/BeOnAuto/auto-engineer/commit/a527ccc39d7f769609252ebefcb4b26e5fe84316), [`16c9541`](https://github.com/BeOnAuto/auto-engineer/commit/16c954130331be27f54f2e1ef451545b7e22161d), [`bad8ef9`](https://github.com/BeOnAuto/auto-engineer/commit/bad8ef9ceb73f9b7efda58f821073ec9894ee7fb), [`a058731`](https://github.com/BeOnAuto/auto-engineer/commit/a0587319d6772df61b4004df1584d884222e7304), [`d6f6ef6`](https://github.com/BeOnAuto/auto-engineer/commit/d6f6ef6f79ceb712ccfcf00a22789c55d6e9a0b4), [`667b53f`](https://github.com/BeOnAuto/auto-engineer/commit/667b53f02b3cc933efe520022dd2f85ba1fbec3b), [`e69b385`](https://github.com/BeOnAuto/auto-engineer/commit/e69b38526ab9fd522ef91955a3ee98ed3c611473)]:
+  - @auto-engineer/narrative@1.89.0
+
+## 1.88.0
+
+### Minor Changes
+
+- [`0bd0133`](https://github.com/BeOnAuto/auto-engineer/commit/0bd0133f31bbcf82b4496619c06ec52b8b7c0443) Thanks [@github-actions[bot]](https://github.com/github-actions%5Bbot%5D)! - - **dev-server**: emit ComponentDBFileUploaded event on artifact upload
+  - **global**: version packages
+
+### Patch Changes
+
+- [`18d9065`](https://github.com/BeOnAuto/auto-engineer/commit/18d9065870dbd41ddac298c6b5a288dc9f9d5898) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: align instruction comment with \_state parameter name
+
+- [`48aed87`](https://github.com/BeOnAuto/auto-engineer/commit/48aed87a84982422ae52fd42626433fd0195cd61) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-implementer**: add prompt guardrails for phantom enums and hardcoded projections
+
+- [`b7bfd7b`](https://github.com/BeOnAuto/auto-engineer/commit/b7bfd7bf198713e5b4639a8f9dd8e720378b1c76) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: derive stable metadata.now for ISO date fields
+
+- [`af9294c`](https://github.com/BeOnAuto/auto-engineer/commit/af9294c4b2c44546124bffba1df76eb7da59e1a1) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: return array idField natively from extraction
+
+- [`ac6ff49`](https://github.com/BeOnAuto/auto-engineer/commit/ac6ff49ff17333fb1c7cab099084fb5b314b7658) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-implementer**: update ketchup plan with Bursts 6-7
+
+- [`b47c94a`](https://github.com/BeOnAuto/auto-engineer/commit/b47c94a1936734f5defafdcae9fa7060d0fefbb0) Thanks [@rami-hatoum](https://github.com/rami-hatoum)! - - **server-generator-apollo-emmett**: resolve findOne idField from events when missing in Then state
+
+- Updated dependencies [[`0bd0133`](https://github.com/BeOnAuto/auto-engineer/commit/0bd0133f31bbcf82b4496619c06ec52b8b7c0443), [`18d9065`](https://github.com/BeOnAuto/auto-engineer/commit/18d9065870dbd41ddac298c6b5a288dc9f9d5898), [`48aed87`](https://github.com/BeOnAuto/auto-engineer/commit/48aed87a84982422ae52fd42626433fd0195cd61), [`b7bfd7b`](https://github.com/BeOnAuto/auto-engineer/commit/b7bfd7bf198713e5b4639a8f9dd8e720378b1c76), [`af9294c`](https://github.com/BeOnAuto/auto-engineer/commit/af9294c4b2c44546124bffba1df76eb7da59e1a1), [`ac6ff49`](https://github.com/BeOnAuto/auto-engineer/commit/ac6ff49ff17333fb1c7cab099084fb5b314b7658), [`b47c94a`](https://github.com/BeOnAuto/auto-engineer/commit/b47c94a1936734f5defafdcae9fa7060d0fefbb0)]:
+  - @auto-engineer/narrative@1.88.0
+
 ## 1.87.0
 
 ### Minor Changes

package/package.json

@@ -40,7 +40,7 @@
     "ts-node": "^10.9.2",
     "type-fest": "^4.41.0",
     "uuid": "^11.0.0",
-    "@auto-engineer/narrative": "1.87.0"
+    "@auto-engineer/narrative": "1.89.0"
   },
   "publishConfig": {
     "access": "public"
@@ -52,9 +52,9 @@
     "tsx": "^4.19.2",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@auto-engineer/cli": "1.87.0"
+    "@auto-engineer/cli": "1.89.0"
   },
-  "version": "1.87.0",
+  "version": "1.89.0",
   "scripts": {
     "generate:server": "tsx src/cli/index.ts",
     "-DISABLE-build": "tsc && tsx ../../scripts/fix-esm-imports.ts && rm -rf dist/src/codegen/templates && mkdir -p dist/src/codegen && cp -r src/codegen/templates dist/src/codegen/templates && cp -r src/shared dist/src",

package/src/codegen/scaffoldFromSchema.ts

@@ -10,9 +10,9 @@ import { ensureDirExists, ensureDirPath, toKebabCase } from './utils/path.js';
 
 const debug = createDebug('auto:server-generator-nestjs:scaffold');
 
+import { parseSliceRequest } from '@auto-engineer/narrative';
 import { type ConsolidatedEntity, consolidateEntityFields } from './entity-consolidation.js';
 import { getStreamFromSink } from './extract/data-sink.js';
-import { parseGraphQlRequest } from './extract/graphql.js';
 import {
   baseTs,
   buildCommandGwtMapping,
@@ -353,7 +353,7 @@ async function prepareTemplateData(
     projectionSingleton,
     projectionName,
     projectionType: projectionName != null ? pascalCase(projectionName) : undefined,
-    parsedRequest: slice.type === 'query' && slice.request != null ? parseGraphQlRequest(slice.request) : undefined,
+    parsedRequest: parseSliceRequest(slice),
     messages: allMessages,
     message:
       slice.type === 'query' && allMessages

package/src/codegen/templates/command/resolver.ts.ejs

@@ -1,7 +1,7 @@
 <%
 const command = commands[0];
 if (!command) return '';
-const mutationName = camelCase(sliceName);
+const mutationName = parsedRequest?.operationName ?? camelCase(sliceName);
 %>import { Mutation, Resolver, Args } from '@nestjs/graphql';
 import { Logger, Injectable } from '@nestjs/common';
 import { CommandBus } from '@nestjs/cqrs';

package/src/codegen/templates/query/resolver.ts.ejs

@@ -1,6 +1,6 @@
 <%
 const typeName = projectionType || pascalCase(sliceName) + 'State';
-const queryName = camelCase(projectionName || sliceName);
+const queryName = parsedRequest?.operationName ?? camelCase(projectionName || sliceName);
 const isSingleton = projectionSingleton === true;
 %>import { Query, Resolver } from '@nestjs/graphql';
 import { Injectable } from '@nestjs/common';

package/src/codegen/extract/graphql.ts

@@ -1,103 +0,0 @@
-import { type OperationDefinitionNode, parse, print, type TypeNode } from 'graphql';
-
-export interface ParsedArg {
-  name: string;
-  tsType: string;
-  graphqlType: string;
-  nullable: boolean;
-}
-
-export interface ParsedGraphQlQuery {
-  queryName: string;
-  args: ParsedArg[];
-  returnType: string;
-  tsReturnType: string;
-}
-
-function getTypeName(typeNode: TypeNode): { graphqlType: string; nullable: boolean } {
-  if (typeNode.kind === 'NamedType') {
-    return { graphqlType: typeNode.name.value, nullable: true };
-  } else if (typeNode.kind === 'NonNullType') {
-    const inner = getTypeName(typeNode.type);
-    return { ...inner, nullable: false };
-  } else {
-    return getTypeName(typeNode.type);
-  }
-}
-
-function graphqlToTs(type: string): string {
-  switch (type) {
-    case 'String':
-      return 'string';
-    case 'Int':
-    case 'Float':
-    case 'Number':
-      return 'number';
-    case 'Boolean':
-      return 'boolean';
-    case 'Date':
-      return 'Date';
-    default:
-      return type;
-  }
-}
-
-function convertJsonAstToSdl(request: string): string {
-  // Handle JSON-serialized AST
-  if (request.startsWith('{') && request.includes('"kind"')) {
-    try {
-      const ast = JSON.parse(request) as unknown;
-      if (typeof ast === 'object' && ast !== null && 'kind' in ast && ast.kind === 'Document') {
-        // Convert AST to SDL string - cast is safe here as we've validated it's a Document
-        return print(ast as Parameters<typeof print>[0]);
-      }
-    } catch {
-      // If parsing fails, assume it's already a GraphQL string
-    }
-  }
-  return request;
-}
-
-export function parseGraphQlRequest(request: string): ParsedGraphQlQuery {
-  const sdlRequest = convertJsonAstToSdl(request);
-
-  const ast = parse(sdlRequest);
-  const op = ast.definitions.find(
-    (d): d is OperationDefinitionNode => d.kind === 'OperationDefinition' && d.operation === 'query',
-  );
-
-  if (!op) throw new Error('No query operation found');
-
-  const queryName = op.name?.value;
-  if (queryName == null) throw new Error('Query must have a name');
-
-  const args: ParsedArg[] = (op.variableDefinitions ?? []).map((def) => {
-    const varName = def.variable.name.value;
-    const { graphqlType, nullable } = getTypeName(def.type);
-    return {
-      name: varName,
-      graphqlType,
-      tsType: graphqlToTs(graphqlType),
-      nullable,
-    };
-  });
-
-  const field = op.selectionSet.selections[0];
-  if (field?.kind !== 'Field' || !field.name.value) {
-    throw new Error('Query selection must be a field');
-  }
-
-  const baseName = field.name.value;
-  const returnType = `${pascalCase(baseName)}View`;
-
-  return {
-    queryName: baseName,
-    args,
-    returnType,
-    tsReturnType: `${returnType}[]`,
-  };
-}
-
-function pascalCase(input: string): string {
-  return input.replace(/(^\w|_\w)/g, (match) => match.replace('_', '').toUpperCase());
-}