@techspokes/typescript-wsdl-client 0.15.2 → 0.17.0

package/dist/gateway/generators.js

@@ -148,11 +148,19 @@ export function emitOperationSchemas(doc, opsDir, versionSlug, serviceSlug, sche
             // Build response schemas
             const responses = operation.responses || {};
             const responseObj = {};
+            // Detect streaming operation: OpenAPI emits a non-JSON content entry with
+            // an `x-wsdl-tsc-stream` extension on the 200 response.
+            const streamEntry = detectStreamResponse(responses["200"]);
             const explicitCodes = Object.keys(responses).filter(isNumeric);
             for (const code of explicitCodes) {
                 const r = responses[code];
                 if (!r || typeof r !== "object")
                     continue;
+                // Stream ops intentionally skip JSON response-schema construction on the
+                // streamed status code; the body is an NDJSON stream, not a single
+                // JSON object, so fast-json-stringify cannot serialize it anyway.
+                if (streamEntry && code === "200")
+                    continue;
                 const rSchema = r.content?.["application/json"]?.schema;
                 if (!rSchema) {
                     throw new Error(`Response ${code} for operation '${operationId}' is missing application/json schema`);
@@ -222,12 +230,38 @@ export function emitOperationSchemas(doc, opsDir, versionSlug, serviceSlug, sche
                 path: p,
                 summary: normalizeDocCommentText(typeof operation.summary === "string" ? operation.summary : undefined),
                 description: normalizeDocCommentText(typeof operation.description === "string" ? operation.description : undefined),
-                skipResponseSchema,
+                // Stream ops always skip response schema because NDJSON is not a single
+                // JSON document and fast-json-stringify can't serialize it.
+                skipResponseSchema: skipResponseSchema || !!streamEntry,
+                ...(streamEntry ? { stream: streamEntry } : {}),
             });
         }
     }
     return operations;
 }
+/**
+ * Look for an `x-wsdl-tsc-stream` extension on the 200 response's content map.
+ * Returns the normalized stream metadata when found, or undefined otherwise.
+ */
+function detectStreamResponse(response200) {
+    const content = response200?.content;
+    if (!content || typeof content !== "object")
+        return undefined;
+    for (const [mediaType, entry] of Object.entries(content)) {
+        const ext = entry && typeof entry === "object" ? entry["x-wsdl-tsc-stream"] : undefined;
+        if (!ext || typeof ext !== "object")
+            continue;
+        const format = ext.format;
+        if (format !== "ndjson" && format !== "json-array")
+            continue;
+        const itemRef = ext.itemSchema?.$ref;
+        const recordTypeName = typeof itemRef === "string"
+            ? itemRef.split("/").pop()
+            : undefined;
+        return { mediaType, format, recordTypeName };
+    }
+    return undefined;
+}
 /**
  * Emits schemas.ts module that registers all model schemas with Fastify
  *
@@ -361,7 +395,7 @@ import type { FastifyInstance } from "fastify";
 function detectArrayWrappers(catalog) {
     return detectArrayWrappersShared(catalog.types || []);
 }
-export function emitRuntimeModule(outDir, versionSlug, serviceSlug, catalog) {
+export function emitRuntimeModule(outDir, versionSlug, serviceSlug, catalog, opts) {
     const vSlug = slugName(versionSlug);
     const sSlug = slugName(serviceSlug);
     // Build unwrap maps from catalog if provided
@@ -602,7 +636,43 @@ export function createGatewayErrorHandler_${vSlug}_${sSlug}() {
   };
 }
 `;
-    fs.writeFileSync(path.join(outDir, "runtime.ts"), runtimeTs + unwrapSection, "utf8");
+    const streamSection = opts?.hasStreams ? buildStreamRuntimeSection() : "";
+    fs.writeFileSync(path.join(outDir, "runtime.ts"), runtimeTs + unwrapSection + streamSection, "utf8");
+}
+/**
+ * Returns the streaming helpers block for runtime.ts.
+ *
+ * The emitted `toNdjson` mirrors the reference implementation in
+ * src/runtime/ndjson.ts but is inlined here to avoid a cross-package import
+ * from the generated gateway (which would require wsdl-tsc to be a runtime
+ * dependency of the consumer's project).
+ */
+function buildStreamRuntimeSection() {
+    return `
+// -----------------------------------------------------------------------------
+// Streaming helpers (emitted because at least one operation is stream-configured).
+// -----------------------------------------------------------------------------
+
+import { Readable } from "node:stream";
+
+/**
+ * Wrap an async iterable of records in a Node Readable stream that emits
+ * NDJSON (one JSON document per line, LF-terminated). Downstream backpressure
+ * is honored by Readable.from's default iterator-pausing behavior. Source
+ * errors are forwarded to the returned stream's 'error' event — before-first-
+ * byte errors fire before any push(), so Fastify translates them into the
+ * standard JSON error envelope.
+ */
+export function toNdjson<T>(records: AsyncIterable<T>): Readable {
+  return Readable.from(encodeNdjson(records), { objectMode: false, encoding: "utf-8" });
+}
+
+async function* encodeNdjson<T>(records: AsyncIterable<T>): AsyncIterable<string> {
+  for await (const record of records) {
+    yield JSON.stringify(record) + "\\n";
+  }
+}
+`;
 }
 /**
  * Emits plugin.ts module as the primary Fastify plugin wrapper
@@ -799,25 +869,44 @@ export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, servi
             ? `request.body as ${reqTypeName}`
             : "request.body";
         // Build the runtime import and return expression based on unwrap availability
-        const runtimeImport = hasUnwrap
-            ? `import { buildSuccessEnvelope, unwrapArrayWrappers } from "../runtime${suffix}";`
-            : `import { buildSuccessEnvelope } from "../runtime${suffix}";`;
+        const runtimeImport = op.stream
+            ? `import { toNdjson } from "../runtime${suffix}";`
+            : hasUnwrap
+                ? `import { buildSuccessEnvelope, unwrapArrayWrappers } from "../runtime${suffix}";`
+                : `import { buildSuccessEnvelope } from "../runtime${suffix}";`;
         const returnExpr = hasUnwrap
             ? `return buildSuccessEnvelope(unwrapArrayWrappers(result.response, "${resTypeName}"));`
             : `return buildSuccessEnvelope(result.response);`;
         // Note: op.path comes from OpenAPI and already includes any base path
         const schemaBinding = op.skipResponseSchema
-            ? `\n// Response schema omitted: $ref graph exceeds fast-json-stringify depth limit\nconst { response: _response, ...routeSchema } = schema as Record<string, unknown>;\n`
+            ? `\n// Response schema omitted: ${op.stream
+                ? "stream operations emit NDJSON, not a single JSON object"
+                : "$ref graph exceeds fast-json-stringify depth limit"}\nconst { response: _response, ...routeSchema } = schema as Record<string, unknown>;\n`
             : "";
         const schemaLine = op.skipResponseSchema
             ? "    schema: routeSchema,"
             : "    schema,";
         const operationDocLines = buildOperationDocLines(op);
+        const handlerBody = op.stream
+            ? `    handler: async (request, reply) => {
+      const client = fastify.${clientMeta.decoratorName};
+      const result = await client.${clientMethod}(${bodyArg});
+      reply.type(${JSON.stringify(op.stream.mediaType)});
+      return reply.send(toNdjson(result.records));
+    },`
+            : `    handler: async (request) => {
+      const client = fastify.${clientMeta.decoratorName};
+      const result = await client.${clientMethod}(${bodyArg});
+      ${returnExpr}
+    },`;
+        const responseTypeDoc = op.stream
+            ? `${op.stream.recordTypeName ?? "records"} (streamed as ${op.stream.format})`
+            : `${resTypeName} (wrapped in envelope)`;
         let routeTs = `/**
  * Route: ${op.method.toUpperCase()} ${op.path}
  * Operation: ${op.operationId || op.operationSlug}
 ${operationDocLines} * Request Type: ${reqTypeName}
- * Response Type: ${resTypeName} (wrapped in envelope)
+ * Response Type: ${responseTypeDoc}
  * Auto-generated - do not edit manually.
  */
 import type { FastifyInstance } from "fastify";
@@ -829,11 +918,7 @@ export async function ${fnName}(fastify: FastifyInstance) {
     method: "${op.method.toUpperCase()}",
     url: "${op.path}",
 ${schemaLine}
-    handler: async (request) => {
-      const client = fastify.${clientMeta.decoratorName};
-      const result = await client.${clientMethod}(${bodyArg});
-      ${returnExpr}
-    },
+${handlerBody}
   });
 }
 `;

package/dist/gateway/helpers.d.ts

@@ -176,6 +176,16 @@ export interface ResolvedOperationMeta {
     responseTypeName?: string;
     summary?: string;
     description?: string;
+    /**
+     * Populated for operations that opt into streaming via stream-config. Drives
+     * mock-client emission (async-iterable records) and test-payload shape.
+     */
+    stream?: {
+        format: "ndjson" | "json-array";
+        mediaType: string;
+        recordTypeName: string;
+        recordPath: string[];
+    };
 }
 /**
  * Options for resolving client metadata
@@ -226,6 +236,12 @@ export declare function resolveOperationMeta(operationId: string, operationSlug:
     summary?: string;
     description?: string;
     doc?: string;
+    stream?: {
+        format: "ndjson" | "json-array";
+        mediaType: string;
+        recordTypeName: string;
+        recordPath: string[];
+    };
 }>): ResolvedOperationMeta;
 /**
  * Measures the $ref graph complexity of a schema component.

package/dist/gateway/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/gateway/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAqBxF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,GAAG,CA4GL;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAcxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,GAAG,GAAG,CAiB3E;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,GAAG,EACd,GAAG,EAAE,eAAe,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,sBAAsB,CAmFxB;AAED;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,UAAU,CAkD3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC,GACD,qBAAqB,CAuBvB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAE,MAAY,GAClB,MAAM,CAsCR"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/gateway/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,CAAC;CACH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,GAAG,CAqBxF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,GAAG,CA4GL;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAcxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,GAAG,GAAG,CAiB3E;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,aAAa,CAAC,EAAE,GAAG,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,GAAG,EACd,GAAG,EAAE,eAAe,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,sBAAsB,CAmFxB;AAED;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAGD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,UAAU,CAkD3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,KAAK,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH,CAAC,GACD,qBAAqB,CAwBvB;AAoBD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAE,MAAY,GAClB,MAAM,CAsCR"}

package/dist/gateway/helpers.js

@@ -430,6 +430,7 @@ export function resolveOperationMeta(operationId, operationSlug, method, path, c
         responseTypeName,
         ...(summary ? { summary } : {}),
         ...(description ? { description } : {}),
+        ...(catalogOp?.stream ? { stream: catalogOp.stream } : {}),
     };
 }
 function normalizeOperationText(value) {

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 export { generateGateway } from "./gateway/generateGateway.js";
 export { generateTests } from "./test/generateTests.js";
 export { runGenerationPipeline } from "./pipeline.js";
+export { loadStreamConfigFile, parseStreamConfig, StreamConfigError, type OperationStreamMetadata, type ShapeCatalogRef, type StreamConfig, } from "./util/streamConfig.js";
+export { applyShapeCatalogs, type ApplyShapeCatalogsOptions } from "./compiler/shapeResolver.js";
 /**
  * Compiles a WSDL file to TypeScript client code
  *
@@ -27,5 +29,9 @@ export declare function compileWsdlToProject(input: {
     wsdl: string;
     outDir: string;
     options?: CompilerOptions;
+    /** Path to a stream configuration JSON file (ADR-002). Takes precedence over `streamConfig` when both are set. */
+    streamConfigFile?: string;
+    /** In-memory stream configuration. Ignored when `streamConfigFile` is set. */
+    streamConfig?: import("./util/streamConfig.js").StreamConfig;
 }): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAWjD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAC,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAwDf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAWjD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAC,qBAAqB,EAAC,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAC,kBAAkB,EAAE,KAAK,yBAAyB,EAAC,MAAM,6BAA6B,CAAC;AAG/F;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,kHAAkH;IAClH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,wBAAwB,EAAE,YAAY,CAAC;CAC9D,GACA,OAAO,CAAC,IAAI,CAAC,CA2Ef"}

package/dist/index.js

@@ -26,6 +26,8 @@ export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 export { generateGateway } from "./gateway/generateGateway.js";
 export { generateTests } from "./test/generateTests.js";
 export { runGenerationPipeline } from "./pipeline.js";
+export { loadStreamConfigFile, parseStreamConfig, StreamConfigError, } from "./util/streamConfig.js";
+export { applyShapeCatalogs } from "./compiler/shapeResolver.js";
 // noinspection JSUnusedGlobalSymbols
 /**
  * Compiles a WSDL file to TypeScript client code
@@ -53,6 +55,11 @@ export async function compileWsdlToProject(input) {
         wsdl: input.wsdl,
         out: input.outDir,
     });
+    // Resolve stream configuration.
+    const { loadStreamConfigFile } = await import("./util/streamConfig.js");
+    const streamConfig = input.streamConfigFile
+        ? loadStreamConfigFile(input.streamConfigFile)
+        : input.streamConfig;
     // Load & compile
     const wsdlCatalog = await loadWsdl(input.wsdl);
     info(`Loaded WSDL: ${wsdlCatalog.wsdlUri}`);
@@ -60,14 +67,26 @@ export async function compileWsdlToProject(input) {
         throw new Error(`No schemas found in WSDL: ${input.wsdl}`);
     }
     info(`Schemas discovered: ${wsdlCatalog.schemas.length}`);
-    const compiled = compileCatalog(wsdlCatalog, finalOptions);
+    const compiled = compileCatalog(wsdlCatalog, finalOptions, streamConfig);
+    // Apply companion-catalog shape resolution when a stream config is present.
+    if (streamConfig) {
+        const { applyShapeCatalogs } = await import("./compiler/shapeResolver.js");
+        const shapeBaseDir = input.streamConfigFile
+            ? path.dirname(path.resolve(input.streamConfigFile))
+            : path.dirname(path.resolve(input.wsdl));
+        await applyShapeCatalogs(compiled, streamConfig, { baseDir: shapeBaseDir });
+    }
     info(`Compiled WSDL: ${wsdlCatalog.wsdlUri}`);
-    // check if we have any types and operations
-    if (compiled.types.length === 0) {
-        throw new Error(`No types compiled from WSDL: ${input.wsdl}`);
+    // check if we have any data models and operations
+    if (compiled.types.length === 0 && compiled.aliases.length === 0) {
+        throw new Error(`No types or aliases compiled from WSDL: ${input.wsdl}`);
     }
     else {
         info(`Types discovered: ${compiled.types.length}`);
+        info(`Aliases discovered: ${compiled.aliases.length}`);
+        for (const note of compiled.diagnostics?.notes ?? []) {
+            info(`Note: ${note}`);
+        }
     }
     if (compiled.operations.length === 0) {
         throw new Error(`No operations compiled from WSDL: ${input.wsdl}`);

package/dist/openapi/generateOpenAPI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateOpenAPI.d.ts","sourceRoot":"","sources":["../../src/openapi/generateOpenAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAiB,KAAK,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAKnF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAC3E,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CA0RD"}
+{"version":3,"file":"generateOpenAPI.d.ts","sourceRoot":"","sources":["../../src/openapi/generateOpenAPI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,OAAO,EAAiB,KAAK,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAKnF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3C,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAC3E,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAsTD"}

package/dist/openapi/generateOpenAPI.js

@@ -149,7 +149,7 @@ export async function generateOpenAPI(opts) {
     };
     const extensionSchemas = {};
     for (const op of compiled.operations) {
-        const payloadType = op.outputElement?.local;
+        const payloadType = op.outputTypeName ?? op.outputElement?.local;
         const payloadRef = payloadType && schemas[payloadType] ? { $ref: `#/components/schemas/${payloadType}` } : { type: "object" };
         const baseForExt = payloadType || op.name;
         const extName = joinWithNamespace(baseForExt, envelopeNamespace);
@@ -183,7 +183,35 @@ export async function generateOpenAPI(opts) {
             const op = compiled.operations.find(o => o.name === opId);
             if (!op)
                 continue;
-            const payloadType = op.outputElement?.local;
+            if (op.stream) {
+                // Stream operations bypass the standard JSON envelope for 200. Emit
+                // the configured media type with an itemSchema carried under the
+                // x-wsdl-tsc-stream extension so generated tooling can find the
+                // record schema without pretending NDJSON is a single JSON document.
+                // Errors raised before the first byte still use the standard envelope.
+                const recordType = op.stream.recordTypeName;
+                const itemRef = { $ref: `#/components/schemas/${recordType}` };
+                if (methodObj.responses?.["200"]) {
+                    methodObj.responses["200"] = {
+                        description: "Successful streamed SOAP operation response",
+                        content: {
+                            [op.stream.mediaType]: {
+                                schema: { type: "string" },
+                                "x-wsdl-tsc-stream": {
+                                    format: op.stream.format,
+                                    itemSchema: itemRef,
+                                },
+                            },
+                        },
+                    };
+                }
+                if (methodObj.responses?.default) {
+                    methodObj.responses.default.description = "Error raised before any stream record was emitted (standard envelope).";
+                    methodObj.responses.default.content = { "application/json": { schema: { $ref: `#/components/schemas/${baseEnvelopeName}` } } };
+                }
+                continue;
+            }
+            const payloadType = op.outputTypeName ?? op.outputElement?.local;
             const baseForExt = payloadType || op.name;
             const extName = joinWithNamespace(baseForExt, envelopeNamespace);
             if (methodObj.responses?.["200"]) {

package/dist/openapi/generatePaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generatePaths.d.ts","sourceRoot":"","sources":["../../src/openapi/generatePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,MAAM,EAAE,MAAM,GAAG;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,oBAAoB,uBAkElF"}
+{"version":3,"file":"generatePaths.d.ts","sourceRoot":"","sources":["../../src/openapi/generatePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,MAAM,EAAE,MAAM,GAAG;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,oBAAoB,uBAoElF"}

package/dist/openapi/generatePaths.js

@@ -8,8 +8,10 @@ export function generatePaths(compiled, opts) {
         const override = opts.overrides?.[op.name] || {};
         const method = (override.method || opts.defaultMethod || "post").toLowerCase();
         const tag = opts.tagsMap?.[op.name] || opts.defaultTag;
-        const inputRef = op.inputElement?.local ? { $ref: `#/components/schemas/${op.inputElement.local}` } : { type: "object" };
-        const outputRef = op.outputElement?.local ? { $ref: `#/components/schemas/${op.outputElement.local}` } : { type: "object" };
+        const inputTypeName = op.inputTypeName ?? op.inputElement?.local;
+        const outputTypeName = op.outputTypeName ?? op.outputElement?.local;
+        const inputRef = inputTypeName ? { $ref: `#/components/schemas/${inputTypeName}` } : { type: "object" };
+        const outputRef = outputTypeName ? { $ref: `#/components/schemas/${outputTypeName}` } : { type: "object" };
         const parameters = [];
         // Header parameters from security builder
         const headerParamNames = opts.opHeaderParameters[op.name] || [];

package/dist/openapi/generateSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateSchemas.d.ts","sourceRoot":"","sources":["../../src/openapi/generateSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAgB,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAgKpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CA+C1G"}
+{"version":3,"file":"generateSchemas.d.ts","sourceRoot":"","sources":["../../src/openapi/generateSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAgB,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAwKpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAoD1G"}

package/dist/openapi/generateSchemas.js

@@ -57,6 +57,16 @@ function isArrayWrapper(t) {
         return null;
     return { itemType: e.tsType };
 }
+function isSyntheticAliasSelfWrapper(t, aliasNames) {
+    if (!aliasNames.has(t.name))
+        return false;
+    if (t.attrs.length !== 0)
+        return false;
+    if (t.elems.length !== 1)
+        return false;
+    const e = t.elems[0];
+    return e.name === "$value" && e.tsType === t.name;
+}
 function buildComplexSchema(t, closed, knownTypeNames, aliasNames, flattenWrappers) {
     // Use knownTypeNames/aliasNames to validate $ref targets so we surface
     // compiler issues early instead of emitting dangling references in OpenAPI output.
@@ -181,16 +191,21 @@ export function generateSchemas(compiled, opts) {
         schemas[a.name] = buildAliasSchema(a);
     }
     for (const t of compiled.types) {
+        if (isSyntheticAliasSelfWrapper(t, aliasNames)) {
+            continue;
+        }
         schemas[t.name] = buildComplexSchema(t, closed, typeNames, aliasNames, flattenWrappers);
     }
     if (opts.pruneUnusedSchemas) {
-        // Root references: each operation's inputElement.local, outputElement.local
+        // Root references: operation type names when available, falling back to element local names.
         const roots = new Set();
         for (const op of compiled.operations) {
-            if (op.inputElement?.local)
-                roots.add(op.inputElement.local);
-            if (op.outputElement?.local)
-                roots.add(op.outputElement.local);
+            const inputRoot = op.inputTypeName ?? op.inputElement?.local;
+            const outputRoot = op.outputTypeName ?? op.outputElement?.local;
+            if (inputRoot)
+                roots.add(inputRoot);
+            if (outputRoot)
+                roots.add(outputRoot);
         }
         // BFS through $ref graph
         const reachable = new Set();

package/dist/pipeline.d.ts

@@ -1,6 +1,7 @@
 import { type GenerateOpenAPIOptions } from "./openapi/generateOpenAPI.js";
 import { type GenerateGatewayOptions } from "./gateway/generateGateway.js";
 import { type CompilerOptions } from "./config.js";
+import { type StreamConfig } from "./util/streamConfig.js";
 /**
  * Configuration options for the generation pipeline
  *
@@ -45,6 +46,18 @@ export interface PipelineOptions {
         force?: boolean;
         flattenArrayWrappers?: boolean;
     };
+    /**
+     * Path to a stream configuration JSON file. Loaded and parsed once before
+     * compilation; the parsed value takes precedence over `streamConfig` when
+     * both are set. Leave undefined to preserve byte-for-byte buffered output.
+     */
+    streamConfigFile?: string;
+    /**
+     * In-memory stream configuration. Useful for programmatic callers that
+     * do not want to round-trip through a file. Ignored when
+     * `streamConfigFile` is also provided.
+     */
+    streamConfig?: StreamConfig;
 }
 /**
  * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway/App

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAGzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CAiJhH"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAuB,KAAK,YAAY,EAAC,MAAM,wBAAwB,CAAC;AAG/E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;IACF;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CAiKhH"}

package/dist/pipeline.js

@@ -19,6 +19,8 @@ import { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 import { generateGateway } from "./gateway/generateGateway.js";
 import { resolveCompilerOptions } from "./config.js";
 import { emitClientArtifacts, reportCompilationStats, reportOpenApiSuccess, success } from "./util/cli.js";
+import { loadStreamConfigFile } from "./util/streamConfig.js";
+import { applyShapeCatalogs } from "./compiler/shapeResolver.js";
 /**
  * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway/App
  *
@@ -52,10 +54,24 @@ export async function runGenerationPipeline(opts) {
         wsdl: opts.wsdl,
         out: workingDir,
     });
+    // Resolve stream configuration (file path takes precedence over in-memory).
+    const streamConfig = opts.streamConfigFile
+        ? loadStreamConfigFile(opts.streamConfigFile)
+        : opts.streamConfig;
     // Step 1: Load and parse the WSDL document
     const wsdlCatalog = await loadWsdl(opts.wsdl);
     // Step 2: Compile the WSDL into a structured catalog
-    const compiled = compileCatalog(wsdlCatalog, finalCompiler);
+    const compiled = compileCatalog(wsdlCatalog, finalCompiler, streamConfig);
+    // Step 2b: Apply companion-catalog shape resolution when a stream config is
+    // provided. Relative paths in shapeCatalogs resolve against the stream
+    // config file's directory, or the WSDL's directory when the config came in
+    // programmatically.
+    if (streamConfig) {
+        const shapeBaseDir = opts.streamConfigFile
+            ? path.dirname(path.resolve(opts.streamConfigFile))
+            : path.dirname(path.resolve(opts.wsdl));
+        await applyShapeCatalogs(compiled, streamConfig, { baseDir: shapeBaseDir });
+    }
     // Report compilation statistics
     reportCompilationStats(wsdlCatalog, compiled);
     // Step 3: Emit catalog.json (always, to the specified catalogOut path)

package/dist/runtime/ndjson.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NDJSON adapter for record iterables.
+ *
+ * Phase 3 of ADR-002. Given an `AsyncIterable<T>` (typically the output of
+ * `parseRecords`), produce a Node `Readable` that emits one JSON-encoded line
+ * per record and respects downstream backpressure.
+ *
+ * Terminal-error policy (Q3 resolved): the stream aborts on source errors.
+ * Before-first-byte errors surface as the stream's `error` event before any
+ * bytes are pushed, so Fastify can translate them into a normal JSON error
+ * envelope. Errors after the first byte propagate as `error` events too, but
+ * callers should treat them as a truncated response.
+ */
+import { Readable } from "node:stream";
+/**
+ * Wrap an async iterable of records in a Node `Readable` stream that emits
+ * NDJSON (one JSON document per line, LF-terminated). Downstream backpressure
+ * is honored via `Readable.from`'s default behavior: the iterator's `next()`
+ * is not called until the internal buffer has room.
+ *
+ * Source errors are forwarded to the returned stream's `error` event.
+ */
+export declare function toNdjson<T>(records: AsyncIterable<T>): Readable;
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/runtime/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../src/runtime/ndjson.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAC;AAErC;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAE/D"}

package/dist/runtime/ndjson.js

@@ -0,0 +1,30 @@
+/**
+ * NDJSON adapter for record iterables.
+ *
+ * Phase 3 of ADR-002. Given an `AsyncIterable<T>` (typically the output of
+ * `parseRecords`), produce a Node `Readable` that emits one JSON-encoded line
+ * per record and respects downstream backpressure.
+ *
+ * Terminal-error policy (Q3 resolved): the stream aborts on source errors.
+ * Before-first-byte errors surface as the stream's `error` event before any
+ * bytes are pushed, so Fastify can translate them into a normal JSON error
+ * envelope. Errors after the first byte propagate as `error` events too, but
+ * callers should treat them as a truncated response.
+ */
+import { Readable } from "node:stream";
+/**
+ * Wrap an async iterable of records in a Node `Readable` stream that emits
+ * NDJSON (one JSON document per line, LF-terminated). Downstream backpressure
+ * is honored via `Readable.from`'s default behavior: the iterator's `next()`
+ * is not called until the internal buffer has room.
+ *
+ * Source errors are forwarded to the returned stream's `error` event.
+ */
+export function toNdjson(records) {
+    return Readable.from(encode(records), { objectMode: false, encoding: "utf-8" });
+}
+async function* encode(records) {
+    for await (const record of records) {
+        yield JSON.stringify(record) + "\n";
+    }
+}

package/dist/runtime/streamXml.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Catalog-driven parse specification. `recordPath` is an ordered XML element
+ * path from the SOAP body payload down to the repeated record element. The
+ * path is matched as a suffix of the open-tag stack, so callers may either
+ * pre-strip the SOAP envelope or feed the entire response body.
+ *
+ * Duplicate local names in `recordPath` are supported and expected (Escapia's
+ * EVRN content service nests two elements named `EVRN_UnitDescriptiveInfoRS`).
+ */
+export interface RecordParseSpec {
+    recordPath: string[];
+    /** TypeScript type name of the record, used to look up propMeta. */
+    recordTypeName: string;
+    /** Attribute bag key to stash XML attributes under. Defaults to "$attributes". */
+    attributesKey?: string;
+    /**
+     * Compiled-catalog child-type map: `childType[typeName][propName] = tsType`.
+     * Used to descend into nested complex types and to detect array-valued
+     * props (trailing `[]`). Optional — absent means occurrence-based array
+     * detection only.
+     */
+    childType?: Record<string, Record<string, string>>;
+    /**
+     * Compiled-catalog prop-meta map: carries min/max/nillable/declaredType.
+     * When present, `max > 1` or `max === "unbounded"` drives array emission
+     * even for props that happen to occur just once in a given record.
+     */
+    propMeta?: Record<string, Record<string, PropMeta>>;
+}
+export interface PropMeta {
+    min?: number;
+    max?: number | "unbounded";
+    nillable?: boolean;
+    declaredType?: string;
+}
+/**
+ * Consume an async iterable of XML bytes/strings and yield parsed records.
+ *
+ * The returned iterator is single-pass; iteration must complete (or be
+ * interrupted by the consumer via `break`/`return`) before the upstream
+ * source is released. Errors from the source or from the SAX parser abort
+ * the iteration via a rejected `next()`.
+ */
+export declare function parseRecords<T = unknown>(source: AsyncIterable<string | Uint8Array>, spec: RecordParseSpec): AsyncIterable<T>;
+//# sourceMappingURL=streamXml.d.ts.map

package/dist/runtime/streamXml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamXml.d.ts","sourceRoot":"","sources":["../../src/runtime/streamXml.ts"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAuB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC7C,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,EAC1C,IAAI,EAAE,eAAe,GACpB,aAAa,CAAC,CAAC,CAAC,CAqGlB"}