@techspokes/typescript-wsdl-client 0.15.2 → 0.17.0

package/dist/runtime/streamXml.js

@@ -0,0 +1,212 @@
+/**
+ * Streaming SOAP-payload to record iterator.
+ *
+ * Phase 3 of ADR-002. Driven by saxes (chunk-boundary safe — proven in
+ * test/research/sax-record-path.test.ts) and the compiled-catalog metadata
+ * that the buffered client already relies on. The parser accepts an async
+ * iterable of bytes/strings (typically an upstream SOAP HTTP response) and
+ * yields fully-materialized record objects as the corresponding end tags
+ * close. Consumers never see partial records.
+ *
+ * Open questions resolved here:
+ *   Q3 (terminal error policy): stream aborts. Errors that happen before the
+ *        first record bubble out as a rejected promise from the first
+ *        iterator.next(). Errors after a record was emitted throw from a
+ *        later iterator.next() — callers are expected to treat that as a
+ *        truncated stream.
+ *   Q4 (saxes placement): runtime dependency of the wsdl-tsc package; the
+ *        generated client imports the emitted copy of this module and
+ *        inherits saxes via its own dependency tree.
+ */
+import { SaxesParser } from "saxes";
+/**
+ * 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 async function* parseRecords(source, spec) {
+    const parser = new SaxesParser({ xmlns: false, position: false });
+    const recordPath = spec.recordPath;
+    if (recordPath.length === 0) {
+        throw new Error("parseRecords: recordPath must not be empty");
+    }
+    const attrsKey = spec.attributesKey ?? "$attributes";
+    // Global tag stack, maintained across the entire document.
+    const stack = [];
+    // Records materialized during the current chunk write, awaiting yield.
+    const pending = [];
+    // When a parser.on('error') fires we buffer the error for re-throw on the
+    // next yield cycle; saxes emits 'error' and continues unless we stop it.
+    let parseError = null;
+    const openNodes = [];
+    parser.on("opentag", (tag) => {
+        stack.push(tag.name);
+        if (openNodes.length === 0) {
+            // Not yet inside a record. Check whether entering the path tail.
+            if (tailMatches(stack, recordPath)) {
+                openNodes.push(newNode(tag, spec.recordTypeName, null, attrsKey));
+            }
+            return;
+        }
+        // Inside a record: descend.
+        const parent = openNodes[openNodes.length - 1];
+        parent.hadChildren = true;
+        const parentType = parent.typeName;
+        const childTypeRaw = parentType ? spec.childType?.[parentType]?.[tag.name] : undefined;
+        const childTypeName = childTypeRaw ? stripArraySuffix(childTypeRaw) : null;
+        openNodes.push(newNode(tag, childTypeName, tag.name, attrsKey));
+    });
+    const appendText = (t) => {
+        if (openNodes.length > 0)
+            openNodes[openNodes.length - 1].textBuf.push(t);
+    };
+    parser.on("text", appendText);
+    parser.on("cdata", appendText);
+    parser.on("closetag", (_tag) => {
+        if (openNodes.length > 0) {
+            const closing = openNodes.pop();
+            const value = materialize(closing, attrsKey);
+            if (openNodes.length === 0) {
+                // We just closed the record root. Stack tail must match once more.
+                if (tailMatches(stack, recordPath)) {
+                    pending.push(value);
+                }
+            }
+            else {
+                assignChild(openNodes[openNodes.length - 1], closing.propName, value, spec);
+            }
+        }
+        stack.pop();
+    });
+    parser.on("error", (err) => {
+        parseError = err;
+    });
+    try {
+        for await (const chunk of source) {
+            if (parseError)
+                throw parseError;
+            const text = typeof chunk === "string" ? chunk : decodeUtf8(chunk);
+            parser.write(text);
+            if (parseError)
+                throw parseError;
+            while (pending.length > 0) {
+                yield pending.shift();
+            }
+        }
+        parser.close();
+        if (parseError)
+            throw parseError;
+        while (pending.length > 0) {
+            yield pending.shift();
+        }
+    }
+    finally {
+        // Best-effort cleanup: detach handlers so the parser can be GC'd even
+        // when the consumer aborts iteration early.
+        parser.off("opentag");
+        parser.off("closetag");
+        parser.off("text");
+        parser.off("cdata");
+        parser.off("error");
+    }
+}
+function newNode(tag, typeName, propName, attrsKey) {
+    const attrs = tag.attributes;
+    const obj = {};
+    let isNil = false;
+    const attrKeys = Object.keys(attrs);
+    if (attrKeys.length > 0) {
+        // Detect xsi:nil and drop it from the attribute bag — it's a wire-level
+        // concern that should not pollute the user-visible record.
+        const cleaned = {};
+        for (const k of attrKeys) {
+            if ((k === "xsi:nil" || k === "nil") && attrs[k] === "true") {
+                isNil = true;
+                continue;
+            }
+            cleaned[k] = attrs[k];
+        }
+        if (Object.keys(cleaned).length > 0) {
+            obj[attrsKey] = cleaned;
+        }
+    }
+    return {
+        obj,
+        typeName,
+        propName,
+        textBuf: [],
+        hadChildren: false,
+        isNil,
+    };
+}
+function materialize(node, attrsKey) {
+    if (node.isNil)
+        return null;
+    if (!node.hadChildren) {
+        // Leaf with no child elements: it's simple text. Preserve attributes via
+        // a `$value` pairing when present, mirroring how the buffered mapper
+        // surfaces simpleContent-with-attributes types.
+        const text = node.textBuf.join("");
+        if (attrsKey in node.obj) {
+            return { ...node.obj, $value: text };
+        }
+        return text;
+    }
+    return node.obj;
+}
+function assignChild(parent, propName, value, spec) {
+    const parentType = parent.typeName;
+    const propMetaEntry = parentType ? spec.propMeta?.[parentType]?.[propName] : undefined;
+    const childTypeHint = parentType ? spec.childType?.[parentType]?.[propName] : undefined;
+    // Array if: (a) propMeta says max > 1 or "unbounded", or (b) childType hint
+    // ends in `[]`, or (c) the slot is already occupied (implicit repetition).
+    const metaSaysArray = propMetaEntry?.max === "unbounded" ||
+        (typeof propMetaEntry?.max === "number" && propMetaEntry.max > 1);
+    const hintSaysArray = !!childTypeHint && childTypeHint.endsWith("[]");
+    const existing = parent.obj[propName];
+    const slotTaken = existing !== undefined;
+    if (metaSaysArray || hintSaysArray) {
+        if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else if (slotTaken) {
+            parent.obj[propName] = [existing, value];
+        }
+        else {
+            parent.obj[propName] = [value];
+        }
+        return;
+    }
+    if (slotTaken) {
+        // Schema said scalar but the wire repeated it. Promote to array rather
+        // than drop data.
+        if (Array.isArray(existing)) {
+            existing.push(value);
+        }
+        else {
+            parent.obj[propName] = [existing, value];
+        }
+        return;
+    }
+    parent.obj[propName] = value;
+}
+function stripArraySuffix(tsType) {
+    return tsType.endsWith("[]") ? tsType.slice(0, -2) : tsType;
+}
+function tailMatches(stack, path) {
+    if (stack.length < path.length)
+        return false;
+    const offset = stack.length - path.length;
+    for (let i = 0; i < path.length; i++) {
+        if (stack[offset + i] !== path[i])
+            return false;
+    }
+    return true;
+}
+const UTF8_DECODER = new TextDecoder("utf-8");
+function decodeUtf8(buf) {
+    return UTF8_DECODER.decode(buf);
+}

package/dist/test/generators.d.ts

@@ -2,8 +2,8 @@ import type { ClientMeta, ResolvedOperationMeta } from "../gateway/helpers.js";
 import type { CatalogForMocks } from "./mockData.js";
 /** Pre-computed mock data map passed from the orchestrator to all emitters. */
 export type OperationMocksMap = Map<string, {
-    request: Record<string, unknown>;
-    response: Record<string, unknown>;
+    request: unknown;
+    response: unknown;
 }>;
 /**
  * Emits vitest.config.ts content.

package/dist/test/generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/test/generators.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAGnD,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAerH;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CA+CR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,MAAM,CAsCR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CA8CR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAiIR;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAuER;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,GAClC,MAAM,CAoCR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAkEf"}
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/test/generators.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAGnD,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAerF;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAgFR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,MAAM,CAsCR;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAuER;AAED;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAiIR;AAED;;GAEG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAuER;AAED;;GAEG;AAEH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,GAClC,MAAM,CAoCR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAkEf"}

package/dist/test/generators.js

@@ -60,46 +60,75 @@ export default defineProject({
 export function emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, mocks) {
     const helpersDir = `${testDir}/helpers`;
     const operationsImport = computeRelativeImport(helpersDir, `${clientDir}/operations`, importsMode);
+    const operationsType = `${clientMeta.className}Operations`;
     // Sort operations for deterministic output
     const sortedOps = [...operations].sort((a, b) => a.operationId.localeCompare(b.operationId));
+    const hasStream = sortedOps.some((op) => !!op.stream);
     const methodEntries = sortedOps.map((op) => {
         const mockData = mocks.get(op.operationId);
         const response = mockData?.response ?? {};
+        if (op.stream) {
+            // For stream operations, the mock emits a single-record iterable derived
+            // from the mock data. Tests that need multi-record sequences can pass an
+            // override via createMockClient({...}).
+            const recordJson = JSON.stringify(response, null, 6).replace(/\n/g, "\n    ");
+            return `    ${op.operationId}: async () => ({
+      records: asyncIterableOf(${recordJson}),
+      headers: {},
+    })`;
+        }
         const responseJson = JSON.stringify(response, null, 6).replace(/\n/g, "\n    ");
         return `    ${op.operationId}: async () => ({
       response: ${responseJson},
       headers: {},
     })`;
     }).join(",\n");
-    return `/**
- * Mock SOAP Client Helper
- *
- * Creates a mock client implementing the ${clientMeta.className}Operations interface
- * with full default responses per operation. Override individual methods as needed.
- *
- * Auto-generated by wsdl-tsc --test-dir. Customize freely.
- */
-import type { ${clientMeta.className}Operations } from "${operationsImport}";
-
+    const streamHelper = hasStream
+        ? `
 /**
- * Creates a mock SOAP client with default responses for all operations.
- *
- * Response shapes match the real SOAP client wrapper structure.
- * ArrayOf* types use wrapper objects (e.g. { Forecast: [...] }).
- * The generated unwrapArrayWrappers() function strips these at runtime.
- *
- * @param overrides - Override specific operation implementations
- * @returns Mock client implementing ${clientMeta.className}Operations
+ * Wraps a single record (or an array of records) as an async iterable, matching
+ * the StreamOperationResponse.records shape the real client would return.
  */
-export function createMockClient(
-  overrides: Partial<${clientMeta.className}Operations> = {}
-): ${clientMeta.className}Operations {
-  return {
-${methodEntries},
-    ...overrides,
-  } as ${clientMeta.className}Operations;
+function asyncIterableOf<T>(value: T | T[]): AsyncIterable<T> {
+  const items = Array.isArray(value) ? value : [value];
+  return (async function* () {
+    for (const item of items) yield item;
+  })();
 }
-`;
+`
+        : "";
+    return [
+        "/**",
+        " * Mock SOAP Client Helper",
+        " *",
+        ` * Creates a mock client implementing the ${operationsType} interface`,
+        " * with full default responses per operation. Override individual methods as needed.",
+        " *",
+        " * Auto-generated by wsdl-tsc --test-dir. Customize freely.",
+        " */",
+        "import type { " + operationsType + ` } from "${operationsImport}";`,
+        "",
+        "/**",
+        " * Creates a mock SOAP client with default responses for all operations.",
+        " *",
+        " * Response shapes match the real SOAP client wrapper structure.",
+        " * ArrayOf* types use wrapper objects (e.g. { Forecast: [...] }).",
+        " * The generated unwrapArrayWrappers() function strips these at runtime.",
+        " *",
+        " * @param overrides - Override specific operation implementations",
+        ` * @returns Mock client implementing ${operationsType}`,
+        " */",
+        "export function createMockClient(",
+        "  overrides: Partial<" + operationsType + "> = {}",
+        "): " + operationsType + " {",
+        "  return {",
+        methodEntries ? `${methodEntries},` : "",
+        "    ...overrides,",
+        "  } as " + operationsType + ";",
+        "}",
+        ...(streamHelper ? [streamHelper] : []),
+        "",
+    ].join("\n");
 }
 /**
  * Emits helpers/test-app.ts content.
@@ -166,6 +195,30 @@ export function emitRoutesTest(testDir, importsMode, operations, mocks) {
         const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
         const hint = formatOperationHint(op.summary, op.description);
         const hintComment = hint ? `  // ${hint}\n` : "";
+        if (op.stream) {
+            // Stream routes return NDJSON lines, not a single JSON envelope. Assert
+            // on content-type and at least one parseable record per line.
+            return `${hintComment}  it("${op.method.toUpperCase()} ${op.path} streams ${op.stream.format} records", async () => {
+    const app = await createTestApp();
+    try {
+      const res = await app.inject({
+        method: "${op.method.toUpperCase()}",
+        url: "${op.path}",
+        payload: ${requestPayload},
+      });
+      expect(res.statusCode).toBe(200);
+      expect(String(res.headers["content-type"] ?? "")).toContain(${JSON.stringify(op.stream.mediaType)});
+      const lines = res.body.split("\\n").filter((l: string) => l.length > 0);
+      expect(lines.length).toBeGreaterThan(0);
+      for (const line of lines) {
+        const record = JSON.parse(line);
+        expect(record).toBeDefined();
+      }
+    } finally {
+      await app.close();
+    }
+  });`;
+        }
         return `${hintComment}  it("${op.method.toUpperCase()} ${op.path} returns SUCCESS envelope", async () => {
     const app = await createTestApp();
     try {

package/dist/test/mockData.d.ts

@@ -22,6 +22,12 @@ export interface CatalogForMocks {
         name: string;
         inputTypeName?: string;
         outputTypeName?: string;
+        stream?: {
+            format: "ndjson" | "json-array";
+            mediaType: string;
+            recordTypeName: string;
+            recordPath: string[];
+        };
     }>;
     types?: Array<{
         name: string;
@@ -33,6 +39,10 @@ export interface CatalogForMocks {
             max: number | "unbounded";
         }>;
     }>;
+    aliases?: Array<{
+        name: string;
+        tsType: string;
+    }>;
 }
 /**
  * Generates a mock primitive value based on the TypeScript type and property name.
@@ -75,7 +85,7 @@ export interface GenerateAllMocksOptions {
  * @returns Map from operation name to { request, response } mock data
  */
 export declare function generateAllOperationMocks(catalog: CatalogForMocks, opts?: GenerateAllMocksOptions): Map<string, {
-    request: Record<string, unknown>;
-    response: Record<string, unknown>;
+    request: unknown;
+    response: unknown;
 }>;
 //# sourceMappingURL=mockData.d.ts.map

package/dist/test/mockData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mockData.d.ts","sourceRoot":"","sources":["../../src/test/mockData.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YACvC,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;YAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC,CAAC;KACL,CAAC;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;SAAE,CAAC,CAAC;KAC3D,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAwCjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CA+BtF"}
+{"version":3,"file":"mockData.d.ts","sourceRoot":"","sources":["../../src/test/mockData.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YACvC,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;YAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC,CAAC;KACL,CAAC;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE;YACP,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAC;YAChC,SAAS,EAAE,MAAM,CAAC;YAClB,cAAc,EAAE,MAAM,CAAC;YACvB,UAAU,EAAE,MAAM,EAAE,CAAC;SACtB,CAAC;KACH,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/B,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;SAAE,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAwCjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB;AAWD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,uBAAuB,GAC7B,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CA+BtD"}

package/dist/test/mockData.js

@@ -131,6 +131,15 @@ export function generateMockData(typeName, catalog, opts, visited, depth) {
     }
     return result;
 }
+function generateOperationPayload(typeName, catalog) {
+    if (!typeName)
+        return {};
+    const alias = catalog.aliases?.find(a => a.name === typeName);
+    if (alias) {
+        return generateMockPrimitive(alias.tsType, typeName);
+    }
+    return generateMockData(typeName, catalog);
+}
 /**
  * Generates mock request and response data for all operations in the catalog.
  *
@@ -156,17 +165,17 @@ export function generateAllOperationMocks(catalog, opts) {
     const shouldFlatten = Object.keys(arrayWrappers).length > 0;
     const childTypeMap = catalog.meta?.childType ?? {};
     for (const op of catalog.operations) {
-        let request = op.inputTypeName
-            ? generateMockData(op.inputTypeName, catalog)
-            : {};
+        let request = generateOperationPayload(op.inputTypeName, catalog);
         // Flatten request payloads when array wrappers are active
-        if (shouldFlatten && op.inputTypeName) {
+        if (shouldFlatten && op.inputTypeName && request != null && typeof request === "object" && !Array.isArray(request)) {
             request = flattenMockPayload(request, op.inputTypeName, childTypeMap, arrayWrappers);
         }
-        // Response stays SOAP-shaped (pre-unwrap) since runtime unwrapArrayWrappers() handles it
-        const response = op.outputTypeName
-            ? generateMockData(op.outputTypeName, catalog)
-            : {};
+        // Response: for stream ops we generate a single record of the configured
+        // recordType so the mock client can yield it through asyncIterableOf().
+        // Otherwise the SOAP-shaped outputType envelope (pre-unwrap).
+        const response = op.stream
+            ? generateOperationPayload(op.stream.recordTypeName, catalog)
+            : generateOperationPayload(op.outputTypeName, catalog);
         result.set(op.name, { request, response });
     }
     return result;

package/dist/util/cli.d.ts

@@ -79,6 +79,9 @@ export declare function reportCompilationStats(wsdlCatalog: {
 }, compiled: {
     types: any[];
     operations: any[];
+    diagnostics?: {
+        notes?: string[];
+    };
 }): void;
 /**
  * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts, operations.ts)

package/dist/util/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/util/cli.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE;IAAE,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,EAC/B,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,EAAE,CAAA;CAAE,GAC5C,IAAI,CAIN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACrD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,GACzD,IAAI,CAWN;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,IAAI,CAUN"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/util/cli.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK,CAY7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE;IAAE,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,EAC/B,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GAChF,IAAI,CAON;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACrD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,GACzD,IAAI,CAWN;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,IAAI,CAUN"}

package/dist/util/cli.js

@@ -95,7 +95,9 @@ export function info(message) {
  * @param exitCode - Process exit code (default: 1)
  */
 export function handleCLIError(errorObj, exitCode = 1) {
-    if (errorObj instanceof WsdlCompilationError) {
+    // Known structured errors carry richer context; print their multi-line form.
+    if (errorObj instanceof WsdlCompilationError ||
+        (errorObj instanceof Error && typeof errorObj.toUserMessage === "function")) {
         error(errorObj.toUserMessage());
     }
     else {
@@ -129,6 +131,9 @@ export function reportCompilationStats(wsdlCatalog, compiled) {
     info(`Schemas discovered: ${wsdlCatalog.schemas.length}`);
     info(`Compiled types: ${compiled.types.length}`);
     info(`Operations: ${compiled.operations.length}`);
+    for (const note of compiled.diagnostics?.notes ?? []) {
+        info(`Note: ${note}`);
+    }
 }
 /**
  * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts, operations.ts)

package/dist/util/runtimeSource.d.ts

@@ -0,0 +1,2 @@
+export declare function loadRuntimeSource(filename: string): string;
+//# sourceMappingURL=runtimeSource.d.ts.map

package/dist/util/runtimeSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeSource.d.ts","sourceRoot":"","sources":["../../src/util/runtimeSource.ts"],"names":[],"mappings":"AAsCA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI1D"}

package/dist/util/runtimeSource.js

@@ -0,0 +1,38 @@
+/**
+ * Helpers to load wsdl-tsc's own runtime modules as source text, for embedding
+ * into generated client and gateway output.
+ *
+ * The runtime modules live at `src/runtime/*.ts` and are published alongside
+ * `dist/` via the `files` field in package.json. Resolving via
+ * `import.meta.url` works both in dev (tsx runs the .ts directly from src/) and
+ * in a published install (generator code lives under dist/, and `../../src/runtime/…`
+ * climbs to the package root where the source .ts files sit beside `dist/`).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
+const HEADER = (sourceName) => `// -----------------------------------------------------------------------------
+// Embedded from @techspokes/typescript-wsdl-client runtime (${sourceName}).
+// This file is generated output — do not edit; regenerate via wsdl-tsc.
+// -----------------------------------------------------------------------------
+`;
+function resolveRuntimeSourcePath(filename) {
+    // Walk candidates in order: dev layout (src/util -> src/runtime),
+    // then published layout (dist/util -> ../src/runtime), then package root.
+    const candidates = [
+        path.resolve(MODULE_DIR, "..", "runtime", filename),
+        path.resolve(MODULE_DIR, "..", "..", "src", "runtime", filename),
+        path.resolve(MODULE_DIR, "..", "..", "..", "src", "runtime", filename),
+    ];
+    for (const c of candidates) {
+        if (fs.existsSync(c))
+            return c;
+    }
+    throw new Error(`Could not locate runtime source "${filename}". Looked in:\n${candidates.join("\n")}`);
+}
+export function loadRuntimeSource(filename) {
+    const abs = resolveRuntimeSourcePath(filename);
+    const raw = fs.readFileSync(abs, "utf-8");
+    return HEADER(filename) + "\n" + raw;
+}

package/dist/util/streamConfig.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Per-operation stream metadata, normalized form. Exported so that the
+ * compiler, emitters, and gateway all consume the same shape.
+ */
+export interface OperationStreamMetadata {
+    mode: "stream";
+    format: "ndjson" | "json-array";
+    mediaType: string;
+    recordPath: string[];
+    recordTypeName: string;
+    shapeCatalogName?: string;
+    sourceOutputTypeName?: string;
+}
+/**
+ * Reference to a companion catalog that supplies record shapes. Exactly one
+ * of `wsdlSource` or `catalogFile` must be set.
+ */
+export interface ShapeCatalogRef {
+    wsdlSource?: string;
+    catalogFile?: string;
+}
+/**
+ * Parsed and normalized stream configuration.
+ */
+export interface StreamConfig {
+    shapeCatalogs: Record<string, ShapeCatalogRef>;
+    operations: Record<string, OperationStreamMetadata>;
+}
+/**
+ * Structured error thrown when a stream configuration cannot be parsed.
+ * The CLI error handler prints `.toUserMessage()` verbatim.
+ */
+export declare class StreamConfigError extends Error {
+    readonly context: {
+        file?: string;
+        pointer?: string;
+        suggestion?: string;
+    };
+    readonly name = "StreamConfigError";
+    constructor(message: string, context?: {
+        file?: string;
+        pointer?: string;
+        suggestion?: string;
+    });
+    toUserMessage(): string;
+}
+/**
+ * Parse a stream configuration from an in-memory JSON value. Used directly
+ * by tests; the file-based variant below wraps this.
+ */
+export declare function parseStreamConfig(raw: unknown, opts?: {
+    file?: string;
+}): StreamConfig;
+/**
+ * Load and parse a stream configuration file. Relative paths are resolved
+ * against the caller's cwd.
+ */
+export declare function loadStreamConfigFile(filePath: string): StreamConfig;
+//# sourceMappingURL=streamConfig.d.ts.map

package/dist/util/streamConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamConfig.d.ts","sourceRoot":"","sources":["../../src/util/streamConfig.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aAKxB,OAAO,EAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAC;IAJjF,SAAkB,IAAI,uBAAuB;gBAG3C,OAAO,EAAE,MAAM,EACC,OAAO,GAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAM;IAKtF,aAAa,IAAI,MAAM;CAOxB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,YAAY,CAwBxF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAqBnE"}