@auto-engineer/narrative 1.5.5 → 1.7.0

package/package.json

@@ -23,9 +23,9 @@
     "typescript": "^5.9.2",
     "zod": "^3.22.4",
     "zod-to-json-schema": "^3.22.3",
-    "@auto-engineer/file-store": "1.5.5",
-    "@auto-engineer/message-bus": "1.5.5",
-    "@auto-engineer/id": "1.5.5"
+    "@auto-engineer/file-store": "1.7.0",
+    "@auto-engineer/id": "1.7.0",
+    "@auto-engineer/message-bus": "1.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -35,7 +35,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.5.5",
+  "version": "1.7.0",
   "scripts": {
     "build": "tsx scripts/build.ts",
     "test": "vitest run --reporter=dot",

package/src/index.ts

@@ -74,6 +74,8 @@ export {
   ExampleSchema,
   ExperienceSliceSchema,
   IntegrationSchema,
+  MappingEntrySchema,
+  MappingFieldRefSchema,
   MessageFieldSchema,
   MessageRefSchema,
   MessageSchema,
@@ -105,6 +107,8 @@ import type {
   CommandSliceSchema,
   ExampleSchema,
   ExperienceSliceSchema,
+  MappingEntrySchema,
+  MappingFieldRefSchema,
   MessageFieldSchema,
   MessageRefSchema,
   MessageSchema,
@@ -133,6 +137,8 @@ export type Spec = z.infer<typeof SpecSchema>;
 export type Step = z.infer<typeof StepSchema>;
 export type Module = z.infer<typeof ModuleSchema>;
 export type MessageRef = z.infer<typeof MessageRefSchema>;
+export type MappingFieldRef = z.infer<typeof MappingFieldRefSchema>;
+export type MappingEntry = z.infer<typeof MappingEntrySchema>;
 
 // ID assignment utilities
 export { addAutoIds, hasAllIds } from './id';

package/src/schema.specs.ts

@@ -2,39 +2,59 @@ import { describe, expect, it } from 'vitest';
 import { CommandSliceSchema, QuerySliceSchema } from './schema';
 
 describe('CommandSliceSchema', () => {
-  it('should accept optional mappings field', () => {
+  it('should accept optional mappings field with structured entries', () => {
     const slice = {
       type: 'command' as const,
       name: 'Create User',
       client: { specs: [] },
       server: { description: 'Creates a user', specs: [] },
-      mappings: 'userId -> user.id',
+      mappings: [
+        {
+          source: { type: 'Command' as const, name: 'CreateUser', field: 'userId' },
+          target: { type: 'Event' as const, name: 'UserCreated', field: 'id' },
+        },
+      ],
     };
 
     const result = CommandSliceSchema.safeParse(slice);
 
     expect(result.success).toBe(true);
     if (result.success) {
-      expect(result.data.mappings).toBe('userId -> user.id');
+      expect(result.data.mappings).toEqual([
+        {
+          source: { type: 'Command', name: 'CreateUser', field: 'userId' },
+          target: { type: 'Event', name: 'UserCreated', field: 'id' },
+        },
+      ]);
     }
   });
 });
 
 describe('QuerySliceSchema', () => {
-  it('should accept optional mappings field', () => {
+  it('should accept optional mappings field with structured entries', () => {
     const slice = {
       type: 'query' as const,
       name: 'Get Users',
       client: { specs: [] },
       server: { description: 'Gets users', specs: [] },
-      mappings: 'users -> response.data',
+      mappings: [
+        {
+          source: { type: 'State' as const, name: 'UsersProjection', field: 'users' },
+          target: { type: 'Query' as const, name: 'GetUsers', field: 'data' },
+        },
+      ],
     };
 
     const result = QuerySliceSchema.safeParse(slice);
 
     expect(result.success).toBe(true);
     if (result.success) {
-      expect(result.data.mappings).toBe('users -> response.data');
+      expect(result.data.mappings).toEqual([
+        {
+          source: { type: 'State', name: 'UsersProjection', field: 'users' },
+          target: { type: 'Query', name: 'GetUsers', field: 'data' },
+        },
+      ]);
     }
   });
 });

package/src/schema.ts

@@ -180,6 +180,21 @@ const QuerySchema = BaseMessageSchema.extend({
 
 const MessageSchema = z.discriminatedUnion('type', [CommandSchema, EventSchema, StateSchema, QuerySchema]);
 
+export const MappingFieldRefSchema = z
+  .object({
+    type: z.enum(['Command', 'Event', 'State', 'Query']).describe('Message kind'),
+    name: z.string().describe('Message name'),
+    field: z.string().describe('Field name within the message'),
+  })
+  .describe('Reference to a specific field within a message type');
+
+export const MappingEntrySchema = z
+  .object({
+    source: MappingFieldRefSchema.describe('Source field reference'),
+    target: MappingFieldRefSchema.describe('Target field reference'),
+  })
+  .describe('Mapping entry linking a source field to a target field');
+
 const BaseSliceSchema = z
   .object({
     name: z.string(),
@@ -270,7 +285,7 @@ const CommandSliceSchema = BaseSliceSchema.extend({
     specs: ClientSpecSchema,
   }),
   request: z.string().describe('Command request (GraphQL, REST endpoint, or other query format)').optional(),
-  mappings: z.string().describe('Field mappings between Command/Event/State messages').optional(),
+  mappings: z.array(MappingEntrySchema).optional().describe('Field mappings between Command/Event/State messages'),
   server: z.object({
     description: z.string(),
     data: DataSchema.optional().describe('Data configuration for command slices'),
@@ -284,7 +299,7 @@ const QuerySliceSchema = BaseSliceSchema.extend({
     specs: ClientSpecSchema,
   }),
   request: z.string().describe('Query request (GraphQL, REST endpoint, or other query format)').optional(),
-  mappings: z.string().describe('Field mappings between Command/Event/State messages').optional(),
+  mappings: z.array(MappingEntrySchema).optional().describe('Field mappings between Command/Event/State messages'),
   server: z.object({
     description: z.string(),
     data: DataSchema.optional().describe('Data configuration for query slices'),