@techspokes/typescript-wsdl-client 0.16.1 → 0.18.0

package/dist/openapi/generateOpenAPI.js

@@ -183,6 +183,34 @@ export async function generateOpenAPI(opts) {
             const op = compiled.operations.find(o => o.name === opId);
             if (!op)
                 continue;
+            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);

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"}

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.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,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,CAkDR;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

@@ -63,15 +63,40 @@ export function emitMockClientHelper(testDir, clientDir, importsMode, clientMeta
     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");
+    const streamHelper = hasStream
+        ? `
+/**
+ * Wraps a single record (or an array of records) as an async iterable, matching
+ * the StreamOperationResponse.records shape the real client would return.
+ */
+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",
@@ -101,6 +126,7 @@ export function emitMockClientHelper(testDir, clientDir, importsMode, clientMeta
         "    ...overrides,",
         "  } as " + operationsType + ";",
         "}",
+        ...(streamHelper ? [streamHelper] : []),
         "",
     ].join("\n");
 }
@@ -169,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;

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;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,CA2BtD"}
+{"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

@@ -170,8 +170,12 @@ export function generateAllOperationMocks(catalog, opts) {
         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 = generateOperationPayload(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.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,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"}
+{"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 {

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;
+}