@auto-engineer/server-generator-nestjs 0.11.16

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+> @auto-engineer/server-generator-nestjs@0.11.16 build /home/runner/work/auto-engineer/auto-engineer/packages/server-generator-nestjs
+> 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
+
+Fixed ESM imports in dist/

package/LICENSE

@@ -0,0 +1,10 @@
+Elastic License 2.0
+
+Copyright 2024 Sam Hatoum
+
+This software and associated documentation files (the "Software") are licensed under the Elastic License 2.0 (the "License"). You may not use this file except in compliance with the License.
+
+You may obtain a copy of the License at:
+https://www.elastic.co/licensing/elastic-license
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. 

package/README.md

@@ -0,0 +1,290 @@
+# @auto-engineer/server-generator-nestjs
+
+| | |
+| --- | --- |
+| **Status** | EXPERIMENTAL - NOT READY FOR PRODUCTION |
+| **Stability** | APIs will change without notice |
+| **Completeness** | Features may be incomplete or broken |
+
+Generates complete NestJS servers from narrative domain models with CQRS, GraphQL, and MikroORM.
+
+---
+
+## Purpose
+
+Without `@auto-engineer/server-generator-nestjs`, you would have to manually scaffold NestJS modules, wire up CQRS command/query handlers, configure GraphQL resolvers, define MikroORM entities, and write boilerplate test files for every domain slice.
+
+This package takes a narrative model (JSON) describing your domain flows and slices, then generates a fully functional NestJS server with:
+
+- CQRS pattern via `@nestjs/cqrs` for command and query separation
+- GraphQL API via Apollo Server with auto-generated resolvers
+- MikroORM entities with SQLite persistence
+- Test scaffolds for each command handler
+
+The generated server is immediately runnable and provides a foundation for domain-driven development.
+
+---
+
+## Installation
+
+```bash
+pnpm add @auto-engineer/server-generator-nestjs
+```
+
+## Quick Start
+
+This package generates NestJS servers from domain models. Here is how to use it.
+
+### 1. Register the handlers
+
+```typescript
+import { COMMANDS } from "@auto-engineer/server-generator-nestjs";
+import { createMessageBus } from "@auto-engineer/message-bus";
+
+const bus = createMessageBus();
+COMMANDS.forEach((cmd) => bus.register(cmd));
+```
+
+### 2. Send a command
+
+```typescript
+const result = await bus.send({
+  type: "GenerateServer",
+  data: {
+    modelPath: ".context/model.json",
+    destination: ".",
+  },
+});
+
+console.log(result);
+// → { type: 'ServerGenerated', data: { serverDir: './server', ... } }
+```
+
+The command reads your model file, generates a complete NestJS server in the `server/` directory, and installs dependencies automatically.
+
+---
+
+## How-to Guides
+
+### Run via CLI
+
+```bash
+auto generate:server --model-path=.context/model.json --destination=.
+```
+
+### Run Programmatically
+
+```typescript
+import { commandHandler } from "@auto-engineer/server-generator-nestjs";
+
+const result = await commandHandler.handle({
+  type: "GenerateServer",
+  data: {
+    modelPath: ".context/model.json",
+    destination: "/path/to/project",
+  },
+  requestId: "req-123",
+});
+```
+
+### Handle Errors
+
+```typescript
+if (result.type === "ServerGenerationFailed") {
+  console.error(result.data.error);
+}
+```
+
+### Handle Per-Slice Progress
+
+The handler emits `SliceGeneratedEvent` for each domain slice processed:
+
+```typescript
+const events = await commandHandler.handle(command);
+
+for (const event of events) {
+  if (event.type === "SliceGenerated") {
+    console.log(`Generated: ${event.data.flowName}.${event.data.sliceName}`);
+  }
+}
+```
+
+### Enable Debug Logging
+
+```bash
+DEBUG=auto:server-generator-nestjs:* pnpm auto generate:server
+```
+
+Available debug namespaces:
+
+- `auto:server-generator-nestjs` - General operation logging
+- `auto:server-generator-nestjs:schema` - Model parsing details
+- `auto:server-generator-nestjs:files` - File copy operations
+- `auto:server-generator-nestjs:deps` - Dependency installation
+- `auto:server-generator-nestjs:scaffold` - Scaffold generation
+
+---
+
+## API Reference
+
+### Exports
+
+```typescript
+import { COMMANDS } from "@auto-engineer/server-generator-nestjs";
+
+import type {
+  GenerateServerCommand,
+  GenerateServerEvents,
+  ServerGeneratedEvent,
+  ServerGenerationFailedEvent,
+  SliceGeneratedEvent,
+} from "@auto-engineer/server-generator-nestjs";
+```
+
+### Commands
+
+| Command          | CLI Alias         | Description                       |
+| ---------------- | ----------------- | --------------------------------- |
+| `GenerateServer` | `generate:server` | Generate NestJS server from model |
+
+### Command Fields
+
+| Field         | Type     | Required | Description                                |
+| ------------- | -------- | -------- | ------------------------------------------ |
+| `modelPath`   | `string` | Yes      | Path to the JSON model file                |
+| `destination` | `string` | Yes      | Destination directory for generated server |
+
+### Events
+
+| Event                         | Description                      |
+| ----------------------------- | -------------------------------- |
+| `ServerGeneratedEvent`        | Emitted on successful generation |
+| `ServerGenerationFailedEvent` | Emitted when generation fails    |
+| `SliceGeneratedEvent`         | Emitted for each slice processed |
+
+### ServerGeneratedEvent Data
+
+```typescript
+{
+  modelPath: string;
+  destination: string;
+  serverDir: string;
+  contextSchemaGraphQL?: string;
+}
+```
+
+### ServerGenerationFailedEvent Data
+
+```typescript
+{
+  modelPath: string;
+  destination: string;
+  error: string;
+}
+```
+
+### SliceGeneratedEvent Data
+
+```typescript
+{
+  flowName: string;
+  sliceName: string;
+  sliceType: string;
+  schemaPath: string;
+  slicePath: string;
+}
+```
+
+---
+
+## Architecture
+
+```
+src/
+├── index.ts                    # Package entry point (exports COMMANDS)
+├── commands/
+│   └── generate-server.ts      # Main command handler
+├── codegen/
+│   ├── scaffoldFromSchema.ts   # Scaffold orchestrator
+│   ├── entity-consolidation.ts # Entity field merging
+│   ├── types.ts                # Core type definitions
+│   ├── extract/                # Message/GWT extraction
+│   │   ├── commands.ts         # Command extraction
+│   │   ├── events.ts           # Event extraction
+│   │   ├── states.ts           # State extraction
+│   │   ├── fields.ts           # Field extraction
+│   │   ├── gwt.ts              # GWT mapping builders
+│   │   ├── graphql.ts          # GraphQL query parsing
+│   │   └── imports.ts          # Cross-slice imports
+│   ├── templates/              # EJS templates
+│   │   ├── command/            # Command slice templates
+│   │   ├── query/              # Query slice templates
+│   │   ├── entity/             # Entity templates
+│   │   └── module/             # NestJS module templates
+│   └── utils/
+│       └── path.ts             # Path utilities
+└── shared/                     # Files copied to generated server
+    ├── main.ts                 # NestJS bootstrap
+    ├── mikro-orm.config.ts     # Database configuration
+    └── graphql-types.ts        # Shared GraphQL types
+```
+
+### Generated Server Structure
+
+The command generates the following structure:
+
+```
+server/
+├── package.json
+├── tsconfig.json
+├── vitest.config.ts
+├── mikro-orm.config.ts
+└── src/
+    ├── main.ts
+    └── domain/
+        ├── shared/
+        │   └── graphql-types.ts
+        ├── {flow-name}/
+        │   ├── {slice-name}/
+        │   │   ├── command.ts
+        │   │   ├── input.ts
+        │   │   ├── handler.ts
+        │   │   ├── handler.specs.ts
+        │   │   └── resolver.ts
+        │   └── entities/
+        │       └── {entity}.entity.ts
+        └── {flow-name}.module.ts
+```
+
+### Dependencies
+
+**Monorepo:**
+
+| Package                    | Usage                         |
+| -------------------------- | ----------------------------- |
+| `@auto-engineer/narrative` | Domain model type definitions |
+
+**External:**
+
+| Package             | Usage                       |
+| ------------------- | --------------------------- |
+| `@nestjs/cqrs`      | CQRS command/query pattern  |
+| `@nestjs/graphql`   | GraphQL schema generation   |
+| `@nestjs/apollo`    | Apollo Server integration   |
+| `@mikro-orm/core`   | ORM for entity persistence  |
+| `@mikro-orm/sqlite` | SQLite database driver      |
+| `ejs`               | Template rendering engine   |
+| `prettier`          | Generated code formatting   |
+| `change-case`       | Naming convention utilities |
+| `execa`             | Dependency installation     |
+
+---
+
+## Known Limitations
+
+This generator is experimental. Current limitations include:
+
+- Schema extraction is incomplete for complex slice types
+- Generated code may require manual fixes
+- Test coverage is minimal
+- Only SQLite persistence is supported

package/dist/src/codegen/entity-consolidation.d.ts

@@ -0,0 +1,19 @@
+import type { Narrative } from '@auto-engineer/narrative';
+import type { MessageDefinition } from './types.js';
+export interface EntityField {
+    name: string;
+    tsType: string;
+    nullable: boolean;
+    isPrimary: boolean;
+    isEnum: boolean;
+    enumName?: string;
+    indexed: boolean;
+}
+export interface ConsolidatedEntity {
+    entityName: string;
+    tableName: string;
+    fields: EntityField[];
+    enumImports: string[];
+}
+export declare function consolidateEntityFields(flow: Narrative, messages: MessageDefinition[], unionToEnumName: Map<string, string>): ConsolidatedEntity;
+//# sourceMappingURL=entity-consolidation.d.ts.map

package/dist/src/codegen/entity-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-consolidation.d.ts","sourceRoot":"","sources":["../../../src/codegen/entity-consolidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAI1D,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAkKD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,kBAAkB,CAuBpB"}

package/dist/src/codegen/entity-consolidation.js

@@ -0,0 +1,134 @@
+import { camelCase, pascalCase } from 'change-case';
+import createDebug from 'debug';
+import { extractMessagesFromSpecs } from './extract/index.js';
+const debug = createDebug('auto:server-generator-nestjs:entity');
+function isEnumType(tsType) {
+    const cleanType = tsType.replace(/\s*\|\s*null\b/g, '').trim();
+    return /^"[^"]+"(\s*\|\s*"[^"]+")+$/.test(cleanType) || /^'[^']+'(\s*\|\s*'[^']+)+$/.test(cleanType);
+}
+function detectPrimaryKeyField(fields, flowName) {
+    const idCandidates = [`${camelCase(flowName)}Id`, 'id', `${camelCase(flowName)}ID`, 'ID'];
+    for (const candidate of idCandidates) {
+        const field = fields.find((f) => f.name === candidate);
+        if (field) {
+            return field.name;
+        }
+    }
+    const stringFields = fields.filter((f) => f.tsType === 'string' && f.name.toLowerCase().includes('id'));
+    if (stringFields.length > 0) {
+        return stringFields[0].name;
+    }
+    return null;
+}
+function shouldIndexField(fieldName, tsType) {
+    const indexableNames = ['status', 'type', 'category', 'state'];
+    const nameLower = fieldName.toLowerCase();
+    if (indexableNames.some((name) => nameLower.includes(name))) {
+        return true;
+    }
+    if (isEnumType(tsType)) {
+        return true;
+    }
+    return false;
+}
+function processFieldsFromMessages(fields, fieldMap, unionToEnumName, enumsUsed) {
+    for (const field of fields) {
+        if (field.name === 'now')
+            continue;
+        if (!fieldMap.has(field.name)) {
+            const isEnum = isEnumType(field.tsType);
+            const cleanType = field.tsType.replace(/\s*\|\s*null\b/g, '').trim();
+            let enumName;
+            if (isEnum) {
+                const matches = cleanType.match(/'([^']+)'/g);
+                const values = matches !== null ? matches.map((v) => v.slice(1, -1)) : [];
+                const normalized = values
+                    .sort()
+                    .map((v) => `'${v}'`)
+                    .join(' | ');
+                enumName = unionToEnumName.get(normalized);
+                if (typeof enumName === 'string' && enumName.length > 0) {
+                    enumsUsed.add(enumName);
+                }
+            }
+            fieldMap.set(field.name, {
+                name: field.name,
+                tsType: field.tsType,
+                nullable: /\|\s*null\b/.test(field.tsType),
+                isPrimary: false,
+                isEnum,
+                enumName,
+                indexed: false,
+            });
+        }
+    }
+}
+function processMessagesWithFields(messageArray, messageLabel, fieldMap, unionToEnumName, enumsUsed) {
+    for (const msg of messageArray) {
+        debug('    %s: %s with %d fields', messageLabel, msg.type, msg.fields.length);
+        if (msg.fields.length > 0) {
+            processFieldsFromMessages(msg.fields, fieldMap, unionToEnumName, enumsUsed);
+        }
+    }
+}
+function processCommandSlice(slice, messages, fieldMap, unionToEnumName, enumsUsed) {
+    debug('  Processing slice: %s (type: %s)', slice.name, slice.type);
+    const extracted = extractMessagesFromSpecs(slice, messages);
+    processMessagesWithFields(extracted.commands, 'Command', fieldMap, unionToEnumName, enumsUsed);
+    processMessagesWithFields(extracted.events, 'Event', fieldMap, unionToEnumName, enumsUsed);
+}
+function processQuerySlice(slice, messages, fieldMap, unionToEnumName, enumsUsed) {
+    debug('  Processing slice: %s (type: %s)', slice.name, slice.type);
+    const extracted = extractMessagesFromSpecs(slice, messages);
+    processMessagesWithFields(extracted.states, 'State', fieldMap, unionToEnumName, enumsUsed);
+}
+function collectFieldsFromSlices(flow, messages, fieldMap, unionToEnumName, enumsUsed) {
+    for (const slice of flow.slices) {
+        if (slice.type === 'experience')
+            continue;
+        if (slice.type === 'command') {
+            processCommandSlice(slice, messages, fieldMap, unionToEnumName, enumsUsed);
+        }
+        if (slice.type === 'query') {
+            processQuerySlice(slice, messages, fieldMap, unionToEnumName, enumsUsed);
+        }
+    }
+}
+function markPrimaryKeyAndIndexes(fields, fieldMap, flowName) {
+    const primaryKeyField = detectPrimaryKeyField(fields, flowName);
+    if (typeof primaryKeyField === 'string' && primaryKeyField.length > 0) {
+        const field = fieldMap.get(primaryKeyField);
+        if (field !== undefined) {
+            field.isPrimary = true;
+            debug('  Detected primary key: %s', primaryKeyField);
+        }
+    }
+    else {
+        debug('  WARNING: No primary key detected for flow: %s', flowName);
+    }
+    for (const field of fields) {
+        if (!field.isPrimary && shouldIndexField(field.name, field.tsType)) {
+            field.indexed = true;
+            debug('  Marking field for indexing: %s', field.name);
+        }
+    }
+}
+export function consolidateEntityFields(flow, messages, unionToEnumName) {
+    debug('Consolidating entity fields for flow: %s', flow.name);
+    const fieldMap = new Map();
+    const enumsUsed = new Set();
+    collectFieldsFromSlices(flow, messages, fieldMap, unionToEnumName, enumsUsed);
+    const fields = Array.from(fieldMap.values());
+    markPrimaryKeyAndIndexes(fields, fieldMap, flow.name);
+    const entityName = pascalCase(flow.name) + 'Entity';
+    const tableName = camelCase(flow.name) + 's';
+    debug('Consolidated entity: %s with %d fields', entityName, fields.length);
+    debug('  Enum imports: %o', Array.from(enumsUsed));
+    return {
+        entityName,
+        tableName,
+        fields,
+        enumImports: Array.from(enumsUsed),
+    };
+}
+//# sourceMappingURL=entity-consolidation.js.map

package/dist/src/codegen/entity-consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-consolidation.js","sourceRoot":"","sources":["../../../src/codegen/entity-consolidation.ts"],"names":[],"mappings":"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"}

package/dist/src/codegen/extract/commands.d.ts

@@ -0,0 +1,25 @@
+import type { Message, MessageDefinition } from '../types';
+import type { CommandExample, EventExample } from './step-types';
+export declare function extractCommandsFromGwt(gwtSpecs: Array<{
+    given?: Array<EventExample | unknown>;
+    when?: CommandExample | EventExample | unknown[];
+    then: Array<EventExample | unknown | {
+        errorType: string;
+        message?: string;
+    }>;
+}>, allMessages: MessageDefinition[]): {
+    commands: Message[];
+    commandSchemasByName: Record<string, Message>;
+};
+export declare function extractCommandsFromThen(gwtSpecs: Array<{
+    given?: Array<EventExample | unknown>;
+    when?: CommandExample | EventExample | unknown[];
+    then: Array<EventExample | unknown | {
+        errorType: string;
+        message?: string;
+    }>;
+}>, allMessages: MessageDefinition[]): {
+    commands: Message[];
+    commandSchemasByName: Record<string, Message>;
+};
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/codegen/extract/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../src/codegen/extract/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAoBjE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,OAAO,EAAE,CAAC;IACjD,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E,CAAC,EACF,WAAW,EAAE,iBAAiB,EAAE,GAC/B;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAwBxE;AAgCD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,cAAc,GAAG,YAAY,GAAG,OAAO,EAAE,CAAC;IACjD,IAAI,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,GAAG;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E,CAAC,EACF,WAAW,EAAE,iBAAiB,EAAE,GAC/B;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAexE"}

package/dist/src/codegen/extract/commands.js

@@ -0,0 +1,67 @@
+import { extractFieldsFromMessage } from './fields.js';
+function createCommandMessage(commandRef, allMessages, source) {
+    const fields = extractFieldsFromMessage(commandRef, 'command', allMessages);
+    if (fields.length === 0 && source === 'then') {
+        return undefined;
+    }
+    return {
+        type: commandRef,
+        fields,
+        source,
+    };
+}
+export function extractCommandsFromGwt(gwtSpecs, allMessages) {
+    const commandSchemasByName = {};
+    const commands = gwtSpecs
+        .map((gwt) => {
+        const cmd = gwt.when;
+        if (Array.isArray(cmd) ||
+            typeof cmd !== 'object' ||
+            cmd === null ||
+            !('commandRef' in cmd) ||
+            typeof cmd.commandRef !== 'string' ||
+            !cmd.commandRef)
+            return undefined;
+        const command = createCommandMessage(cmd.commandRef, allMessages, 'when');
+        if (command) {
+            commandSchemasByName[cmd.commandRef] = command;
+        }
+        return command;
+    })
+        .filter((cmd) => cmd !== undefined);
+    return { commands, commandSchemasByName };
+}
+function isValidCommandExample(commandExample) {
+    return (typeof commandExample === 'object' &&
+        commandExample !== null &&
+        'commandRef' in commandExample &&
+        typeof commandExample.commandRef === 'string' &&
+        !!commandExample.commandRef);
+}
+function processCommandExample(commandExample, commands, commandSchemasByName, allMessages) {
+    if (!isValidCommandExample(commandExample)) {
+        return;
+    }
+    const commandRef = commandExample.commandRef;
+    if (!(commandRef in commandSchemasByName)) {
+        const command = createCommandMessage(commandRef, allMessages, 'then');
+        if (command) {
+            commands.push(command);
+            commandSchemasByName[commandRef] = command;
+        }
+    }
+}
+export function extractCommandsFromThen(gwtSpecs, allMessages) {
+    const commands = [];
+    const commandSchemasByName = {};
+    for (const gwt of gwtSpecs) {
+        if (!Array.isArray(gwt.then)) {
+            continue;
+        }
+        for (const commandExample of gwt.then) {
+            processCommandExample(commandExample, commands, commandSchemasByName, allMessages);
+        }
+    }
+    return { commands, commandSchemasByName };
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/codegen/extract/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../../src/codegen/extract/commands.ts"],"names":[],"mappings":"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"}

package/dist/src/codegen/extract/data-sink.d.ts

@@ -0,0 +1,6 @@
+import type { Slice } from '@auto-engineer/narrative';
+export declare function getStreamFromSink(slice: Slice): {
+    streamPattern?: string;
+    streamId?: string;
+};
+//# sourceMappingURL=data-sink.d.ts.map

package/dist/src/codegen/extract/data-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-sink.d.ts","sourceRoot":"","sources":["../../../../src/codegen/extract/data-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AA2EtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAiB7F"}

package/dist/src/codegen/extract/data-sink.js

@@ -0,0 +1,78 @@
+import { extractGwtSpecsFromSlice } from './step-converter.js';
+function resolveStreamId(stream, exampleData) {
+    return stream.replace(/\$\{([^}]+)\}/g, (_, key) => String(exampleData?.[key] ?? 'unknown'));
+}
+function extractExampleDataFromReact(firstSpec) {
+    if (Array.isArray(firstSpec.when)) {
+        const firstWhen = firstSpec.when[0];
+        return typeof firstWhen?.exampleData === 'object' && firstWhen.exampleData !== null ? firstWhen.exampleData : {};
+    }
+    return {};
+}
+function extractExampleDataFromCommand(firstSpec) {
+    const then = firstSpec.then;
+    const firstExample = then.find((t) => 'exampleData' in t);
+    return typeof firstExample?.exampleData === 'object' && firstExample.exampleData !== null
+        ? firstExample.exampleData
+        : {};
+}
+function extractExampleDataFromQuery(firstSpec) {
+    if (Array.isArray(firstSpec.when)) {
+        const firstWhen = firstSpec.when[0];
+        return typeof firstWhen?.exampleData === 'object' && firstWhen.exampleData !== null ? firstWhen.exampleData : {};
+    }
+    return {};
+}
+function extractExampleDataFromSpecs(slice, gwtSpecs) {
+    if (gwtSpecs.length === 0) {
+        return {};
+    }
+    const firstSpec = gwtSpecs[0];
+    switch (slice.type) {
+        case 'react':
+            return extractExampleDataFromReact(firstSpec);
+        case 'command':
+            return extractExampleDataFromCommand(firstSpec);
+        case 'query':
+            return extractExampleDataFromQuery(firstSpec);
+        default:
+            return {};
+    }
+}
+function isValidStreamSink(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'destination' in item &&
+        typeof item.destination === 'object' &&
+        item.destination !== null &&
+        'type' in item.destination &&
+        item.destination.type === 'stream' &&
+        'pattern' in item.destination &&
+        typeof item.destination.pattern === 'string');
+}
+function processStreamSink(item, exampleData) {
+    if (!isValidStreamSink(item)) {
+        return null;
+    }
+    const streamPattern = item.destination.pattern;
+    const streamId = streamPattern.length > 0 ? resolveStreamId(streamPattern, exampleData) : undefined;
+    return { streamPattern, streamId };
+}
+export function getStreamFromSink(slice) {
+    if (!('server' in slice))
+        return {};
+    const gwtSpecs = extractGwtSpecsFromSlice(slice);
+    const exampleData = extractExampleDataFromSpecs(slice, gwtSpecs);
+    if (!('server' in slice) || slice.server == null || !('data' in slice.server) || !Array.isArray(slice.server.data)) {
+        return {};
+    }
+    const serverData = slice.server.data;
+    for (const item of serverData) {
+        const result = processStreamSink(item, exampleData);
+        if (result) {
+            return result;
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=data-sink.js.map