@techspokes/typescript-wsdl-client 0.16.1 → 0.18.0

package/README.md

@@ -28,6 +28,7 @@ Most tools in this space stop at one layer: a SOAP runtime, type generation, or
 - Handles complex inheritance, `xs:attribute`, namespace collisions, nested XSD imports, and choice elements
 - Generated `operations.ts` interface enables testing without importing `soap` or calling a live service
 - OpenAPI is a first-class output, not an afterthought; types, schemas, and descriptions stay aligned
+- Opt-in NDJSON streaming for large SOAP responses: client emits `AsyncIterable<RecordType>`, gateway flushes records incrementally, OpenAPI advertises the record schema via `x-wsdl-tsc-stream`
 - MIT licensed; generated code is yours with no attribution required
 
 ## Installation
@@ -103,6 +104,7 @@ See [Output Anatomy](docs/output-anatomy.md) for a detailed walkthrough of each
 - You want OpenAPI documentation that stays in sync with WSDL changes
 - You need deterministic codegen output safe for CI/CD regeneration
 - You are modernizing a legacy SOAP integration incrementally
+- You have SOAP operations that return large payloads and need to stream records incrementally instead of buffering
 
 ## When NOT to Use This
 
@@ -137,6 +139,7 @@ Platform API gateways solve governance, policy, and multi-language SDK generatio
 | REST gateway generation | no | no | no | yes |
 | Runnable app scaffolding | no | no | no | yes |
 | Mockable operations interface | no | no | no | yes |
+| Streaming large responses (NDJSON) | no | no | no | yes |
 
 Data as of April 2026.
 
@@ -152,6 +155,7 @@ Real-world WSDL/XSD files are rarely clean. This generator handles patterns that
 - Correct optionality for nillable fields in both TypeScript and OpenAPI output
 - The `$value` pattern for simple content with attributes, preserving text content alongside attribute properties
 - `ArrayOf*` wrapper types, unwrapped automatically in OpenAPI with runtime bridging
+- `xs:any` wildcard payloads mapped to concrete record shapes from a companion WSDL, enabling streaming over responses that the primary WSDL describes only as opaque wrappers
 
 See [Core Concepts](docs/concepts.md) and [Supported Patterns](docs/supported-patterns.md) for details.
 
@@ -226,6 +230,7 @@ See [CLI Reference](docs/cli-reference.md) for all flags and examples.
 | [Programmatic API](docs/api-reference.md) | TypeScript functions for build tools |
 | [Core Concepts](docs/concepts.md) | Flattening, $value, primitives, determinism |
 | [Architecture](docs/architecture.md) | Internal pipeline for contributors |
+| [Streamable Responses (ADR-002)](docs/decisions/002-streamable-responses.md) | Opt-in streaming: client `AsyncIterable`, gateway NDJSON, `x-wsdl-tsc-stream` |
 | [Version Migration](docs/migration.md) | Upgrading between package versions |
 
 ## Why This Exists

package/dist/app/generateApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateApp.d.ts","sourceRoot":"","sources":["../../src/app/generateApp.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA4kBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzE"}
+{"version":3,"file":"generateApp.d.ts","sourceRoot":"","sources":["../../src/app/generateApp.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA6kBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzE"}

package/dist/app/generateApp.js

@@ -454,10 +454,11 @@ function generatePackageJson(appDir, force) {
         dependencies: {
             fastify: "^5.8.5",
             "fastify-plugin": "^5.1.0",
+            saxes: "^6.0.0",
             soap: "^1.9.1",
         },
         devDependencies: {
-            "@types/node": "^25.6.0",
+            "@types/node": "^25.7.0",
             tsx: "^4.21.0",
             typescript: "^6.0.3",
         },

package/dist/cli.js

@@ -25,6 +25,25 @@ import { runGenerationPipeline } from "./pipeline.js";
 import { resolveCompilerOptions } from "./config.js";
 import { emitClientArtifacts, handleCLIError, parseServers, parseStatusCodes, reportCompilationStats, reportOpenApiSuccess, success, validateGatewayRequirements, } from "./util/cli.js";
 import { buildCompilerOptionsFromArgv, buildOpenApiOptionsFromArgv } from "./util/builder.js";
+import { loadStreamConfigFile, StreamConfigError } from "./util/streamConfig.js";
+/**
+ * Load and parse a stream-config file, or call the shared CLI error handler
+ * (which prints the structured message and exits). Returns `undefined` when
+ * `filePath` is falsy so callers can chain with `argv["stream-config"]`.
+ */
+function loadStreamConfigOrExit(filePath) {
+    if (!filePath)
+        return undefined;
+    try {
+        return loadStreamConfigFile(filePath);
+    }
+    catch (err) {
+        if (err instanceof StreamConfigError) {
+            handleCLIError(err);
+        }
+        throw err;
+    }
+}
 // Process command line arguments, removing the first two elements (node executable and script path)
 const rawArgs = hideBin(process.argv);
 // Available commands
@@ -75,6 +94,7 @@ if (rawArgs[0] === "compile") {
         .option("client-choice-mode", { type: "string", choices: ["all-optional", "union"], default: "all-optional" })
         .option("client-fail-on-unresolved", { type: "boolean", default: false })
         .option("client-nillable-as-optional", { type: "boolean", default: false })
+        .option("stream-config", { type: "string", desc: "Path to a stream configuration JSON file (ADR-002)." })
         .strict()
         .help()
         .parse();
@@ -89,7 +109,17 @@ if (rawArgs[0] === "compile") {
         wsdl: String(compileArgv["wsdl-source"]),
         out: path.dirname(catalogOut),
     });
-    const compiled = compileCatalog(wsdlCatalog, compilerOptions);
+    const streamConfig = compileArgv["stream-config"]
+        ? loadStreamConfigOrExit(String(compileArgv["stream-config"]))
+        : undefined;
+    const compiled = compileCatalog(wsdlCatalog, compilerOptions, streamConfig);
+    if (streamConfig) {
+        const { applyShapeCatalogs } = await import("./compiler/shapeResolver.js");
+        const shapeBaseDir = compileArgv["stream-config"]
+            ? path.dirname(path.resolve(String(compileArgv["stream-config"])))
+            : path.dirname(path.resolve(String(compileArgv["wsdl-source"])));
+        await applyShapeCatalogs(compiled, streamConfig, { baseDir: shapeBaseDir });
+    }
     // Report compilation statistics
     reportCompilationStats(wsdlCatalog, compiled);
     // Ensure output directory exists
@@ -136,6 +166,7 @@ if (rawArgs[0] === "client") {
         .option("client-choice-mode", { type: "string", choices: ["all-optional", "union"], default: "all-optional" })
         .option("client-fail-on-unresolved", { type: "boolean", default: false })
         .option("client-nillable-as-optional", { type: "boolean", default: false })
+        .option("stream-config", { type: "string", desc: "Path to a stream configuration JSON file (ADR-002). Only applied when compiling from WSDL." })
         .strict()
         .help()
         .parse();
@@ -175,7 +206,15 @@ if (rawArgs[0] === "client") {
             wsdl: String(clientArgv["wsdl-source"]),
             out: clientOutDir,
         });
-        compiled = compileCatalog(wsdlCatalog, compilerOptions);
+        const clientStreamConfig = loadStreamConfigOrExit(clientArgv["stream-config"]);
+        compiled = compileCatalog(wsdlCatalog, compilerOptions, clientStreamConfig);
+        if (clientStreamConfig) {
+            const { applyShapeCatalogs } = await import("./compiler/shapeResolver.js");
+            const shapeBaseDir = clientArgv["stream-config"]
+                ? path.dirname(path.resolve(String(clientArgv["stream-config"])))
+                : path.dirname(path.resolve(String(clientArgv["wsdl-source"])));
+            await applyShapeCatalogs(compiled, clientStreamConfig, { baseDir: shapeBaseDir });
+        }
         // Report compilation statistics
         reportCompilationStats(wsdlCatalog, compiled);
         // Emit catalog
@@ -675,6 +714,10 @@ if (rawArgs[0] === "pipeline") {
         type: "boolean",
         default: false,
         desc: "Overwrite existing test files when using --test-dir"
+    })
+        .option("stream-config", {
+        type: "string",
+        desc: "Path to a stream configuration JSON file (ADR-002). Applied to every stage that consumes the compiled catalog."
     })
         .strict()
         .help()
@@ -764,6 +807,7 @@ if (rawArgs[0] === "pipeline") {
         clientOutDir: clientOut ? path.resolve(clientOut) : undefined,
         catalogOut,
         compiler: compilerOptions,
+        streamConfigFile: pipelineArgv["stream-config"],
         openapi: openApiOptions ? {
             ...openApiOptions,
             outFile: path.resolve(openapiOut),

package/dist/client/generateClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateClient.d.ts","sourceRoot":"","sources":["../../src/client/generateClient.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAInE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QA+WxE"}
+{"version":3,"file":"generateClient.d.ts","sourceRoot":"","sources":["../../src/client/generateClient.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAKnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QAsaxE"}

package/dist/client/generateClient.js

@@ -13,8 +13,10 @@
  * - Consistent error handling and client configuration
  */
 import fs from "node:fs";
+import path from "node:path";
 import { deriveClientName, pascal, pascalToSnakeCase } from "../util/tools.js";
 import { error, warn } from "../util/cli.js";
+import { loadRuntimeSource } from "../util/runtimeSource.js";
 /**
  * Generates a TypeScript SOAP client class from a compiled WSDL catalog
  *
@@ -53,6 +55,9 @@ export function generateClient(outFile, compiled) {
     // get the class name for the client
     const clientName = deriveClientName(compiled);
     const clientConstant = pascalToSnakeCase(clientName).toUpperCase();
+    // Track whether any operation opts into streaming, so we can emit the
+    // supporting runtime helpers only when they're actually used.
+    let anyStream = false;
     // Build the dynamic methods for the client class
     for (const op of compiled.operations) {
         const m = isValidIdent(op.name) && !reserved.has(op.name)
@@ -70,6 +75,38 @@ export function generateClient(outFile, compiled) {
         const opDocLines = op.doc ? normalizeDocLines(op.doc) : [];
         const opDocStr = opDocLines.length ? `\n   *\n${opDocLines.map(line => `   * ${line}`).join("\n")}` : "";
         const secHintsStr = secHints.length ? `\n   *\n   * Security (WSDL policy hint): ${secHints.join(", ")}` : "";
+        if (op.stream) {
+            anyStream = true;
+            const recordTs = op.stream.recordTypeName;
+            const inputElementLocal = op.inputElement?.local ?? op.name;
+            const inputElementNs = op.inputElement?.ns ?? compiled.wsdlTargetNS;
+            const methodTemplate = `
+
+  /**
+   * Streams records from the ${m} operation of the ${clientName}.${opDocStr}${secHintsStr}
+   *
+   * @param args - The request arguments for the ${m} operation.
+   * @returns A promise resolving to a streaming response whose \`records\` is an
+   *          async iterable of ${recordTs} objects parsed from the SOAP body as
+   *          chunks arrive. Iteration pulls bytes on demand.
+   */
+  async ${m}<HeadersType = Record<string, string>>(
+    args: ${inTs}
+  ): Promise<StreamOperationResponse<T.${recordTs}, HeadersType>> {
+    return this.callStream<${inTs}, T.${recordTs}, HeadersType>(
+      args,
+      ${JSON.stringify(m)},
+      ${inTypeName ? JSON.stringify(inTypeName) : "undefined"},
+      ${JSON.stringify(recordTs)},
+      ${JSON.stringify(inputElementLocal)},
+      ${JSON.stringify(inputElementNs)},
+      ${JSON.stringify(op.soapAction ?? "")},
+      ${JSON.stringify(op.stream.recordPath)}
+    );
+  }`;
+            methods.push(methodTemplate);
+            continue;
+        }
         const methodTemplate = `
 
   /**
@@ -91,6 +128,11 @@ export function generateClient(outFile, compiled) {
         methods.push(methodTemplate);
     }
     const methodsBody = methods.join("\n");
+    // The streaming transport + envelope builders are carried in a sibling
+    // *.tpl file so the IDE does not try to parse their content as code nested
+    // inside this template literal (which would flag `this`, `await`, `yield`
+    // outside-of-function false positives).
+    const streamMethodsBlock = anyStream ? "\n" + loadRuntimeSource("clientStreamMethods.tpl.txt") : "";
     // noinspection JSFileReferences,JSUnresolvedReference,CommaExpressionJS,JSDuplicatedDeclaration,ReservedWordAsName,JSCommentMatchesSignature,JSValidateTypes,JSIgnoredPromiseFromCall,BadExpressionStatementJS,ES6UnusedImports,JSUnnecessarySemicolon,UnreachableCodeJS,JSUnusedLocalSymbols
     const classTemplate = `// noinspection JSAnnotator
 
@@ -101,7 +143,9 @@ export function generateClient(outFile, compiled) {
 import * as soap from "soap";
 import type * as T from "./types${suffix}";
 import type {${clientName}DataTypes} from "./utils${suffix}";
-import {${clientConstant}_DATA_TYPES} from "./utils${suffix}";
+import {${clientConstant}_DATA_TYPES} from "./utils${suffix}";${anyStream ? `
+import {parseRecords, type RecordParseSpec} from "./streamXml${suffix}";
+import type {StreamOperationResponse} from "./operations${suffix}";` : ""}
 
 /**
  * Represents the response structure for ${clientName} operations.
@@ -287,7 +331,7 @@ ${methodsBody}
 
     // Get metadata for this specific type to know which props are attributes
     const attributesList = (typeName && this.dataTypes?.Attributes?.[typeName]) || [];
-    const childrenTypes = (typeName && this.dataTypes?.ChildrenTypes?.[typeName]) || {};
+    const childrenTypes: Readonly<Record<string, string>> = (typeName && this.dataTypes?.ChildrenTypes?.[typeName]) || {};
 
     const out: any = {};
     const attributesBag: Record<string, any> = {};
@@ -320,7 +364,7 @@ ${methodsBody}
       }
 
       // Everything else becomes a child element, recursively processed
-      const childType = (childrenTypes as any)[k] as string | undefined;
+      const childType: string | undefined = childrenTypes[k];
       out[k] = Array.isArray(v)
         ? v.map(node => this.toSoapArgs(node, childType))
         : this.toSoapArgs(v, childType);
@@ -356,7 +400,7 @@ ${methodsBody}
     }
 
     // Get child type mapping for recursive processing with correct types
-    const childrenTypes = (typeName && this.dataTypes?.ChildrenTypes?.[typeName]) || {};
+    const childrenTypes: Readonly<Record<string, string>> = (typeName && this.dataTypes?.ChildrenTypes?.[typeName]) || {};
     const result: any = {};
 
     // Preserve text content for mixed XML elements
@@ -379,14 +423,14 @@ ${methodsBody}
         continue;
       }
       // Recursively convert child elements with their specific type info
-      const childType = (childrenTypes as any)[k] as string | undefined;
+      const childType: string | undefined = childrenTypes[k];
       result[k] = Array.isArray(v)
         ? v.map(node => this.fromSoapResult(node, childType))
         : this.fromSoapResult(v, childType);
     }
 
     return result;
-  }
+  }${streamMethodsBlock}
 }
 `;
     try {
@@ -395,4 +439,16 @@ ${methodsBody}
     catch (e) {
         error(`Failed to write client to ${outFile}`);
     }
+    // If any operation opted into streaming, drop the runtime XML parser
+    // alongside the client so the generated class can import it without
+    // depending on a `@techspokes/typescript-wsdl-client/runtime/...` subpath.
+    if (anyStream) {
+        try {
+            const streamXmlOut = path.join(path.dirname(outFile), "streamXml.ts");
+            fs.writeFileSync(streamXmlOut, loadRuntimeSource("streamXml.ts"), "utf-8");
+        }
+        catch (e) {
+            error(`Failed to emit streamXml.ts next to ${outFile}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
 }

package/dist/client/generateOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateOperations.d.ts","sourceRoot":"","sources":["../../src/client/generateOperations.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIrE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAsEnF"}
+{"version":3,"file":"generateOperations.d.ts","sourceRoot":"","sources":["../../src/client/generateOperations.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKrE;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CA8FnF"}

package/dist/client/generateOperations.js

@@ -8,6 +8,7 @@
 import fs from "node:fs";
 import { deriveClientName, pascal } from "../util/tools.js";
 import { error } from "../util/cli.js";
+import { loadRuntimeSource } from "../util/runtimeSource.js";
 /**
  * Generates an operations.ts file with a fully-typed interface for all SOAP operations
  *
@@ -31,6 +32,9 @@ export function generateOperations(outFile, compiled) {
     // Collect type names used in method signatures for the import statement
     const importedTypes = new Set();
     const methods = [];
+    // Does any operation opt into streaming? If so we also emit the
+    // StreamOperationResponse helper type below.
+    let anyStream = false;
     for (const op of compiled.operations) {
         const inTypeName = op.inputTypeName ?? (op.inputElement ? pascal(op.inputElement.local) : undefined);
         const outTypeName = op.outputTypeName ?? (op.outputElement ? pascal(op.outputElement.local) : undefined);
@@ -47,15 +51,34 @@ export function generateOperations(outFile, compiled) {
         const docBlock = docLines.length > 0
             ? `  /**\n${docLines.map(line => `   * ${line}`).join("\n")}\n   */\n`
             : "";
-        methods.push(`${docBlock}  ${op.name}(\n` +
-            `    args: ${inTs}\n` +
-            `  ): Promise<{ response: ${outTs}; headers: unknown }>;\n`);
+        if (op.stream) {
+            anyStream = true;
+            const recordTs = op.stream.recordTypeName;
+            importedTypes.add(recordTs);
+            methods.push(`${docBlock}  ${op.name}(\n` +
+                `    args: ${inTs}\n` +
+                `  ): Promise<StreamOperationResponse<${recordTs}>>;\n`);
+        }
+        else {
+            methods.push(`${docBlock}  ${op.name}(\n` +
+                `    args: ${inTs}\n` +
+                `  ): Promise<{ response: ${outTs}; headers: unknown }>;\n`);
+        }
     }
     // Build sorted import list for deterministic output
     const sortedImports = Array.from(importedTypes).sort();
     const typeImport = sortedImports.length > 0
         ? `import type {\n${sortedImports.map((t) => `  ${t},`).join("\n")}\n} from "./types${suffix}";\n\n`
         : "";
+    // Emit the StreamOperationResponse helper type iff at least one operation
+    // is stream-configured. Kept inside operations.ts so that mocks and gateway
+    // code can import it without pulling in the SOAP runtime. The raw template
+    // lives in a sibling .tpl file so the IDE does not try to parse embedded
+    // TypeScript type-parameter defaults (HeadersType = Record<...>) as
+    // JavaScript assignment expressions.
+    const streamHelper = anyStream
+        ? loadRuntimeSource("operationsStreamHelper.tpl.txt").replace(/__CLIENT_NAME__/g, clientName)
+        : "";
     const content = `/**
  * Typed operations interface for the ${clientName} service.
  *
@@ -64,7 +87,7 @@ export function generateOperations(outFile, compiled) {
  *
  * Auto-generated - do not edit manually.
  */
-${typeImport}/**
+${typeImport}${streamHelper}/**
  * All operations exposed by the ${clientName} SOAP service.
  *
  * The concrete ${clientName} class satisfies this interface.

package/dist/compiler/schemaCompiler.d.ts

@@ -11,6 +11,7 @@
  */
 import type { CompilerOptions } from "../config.js";
 import type { WsdlCatalog } from "../loader/wsdlLoader.js";
+import type { OperationStreamMetadata, StreamConfig } from "../util/streamConfig.js";
 /**
  * Qualified name with namespace and local part
  *
@@ -22,6 +23,21 @@ export type QName = {
     ns: string;
     local: string;
 };
+/**
+ * Represents an xs:any wildcard particle retained on a complex type.
+ *
+ * The base compiler previously dropped wildcards silently. Keeping them as
+ * explicit markers lets downstream tools (stream-candidate detection,
+ * streaming XML converter) reason honestly about types whose payload lives
+ * outside the statically-typed schema — e.g. Escapia's content-service
+ * stream wrappers that mix an xs:schema marker with an xs:any payload.
+ */
+export type CompiledWildcard = {
+    min: number;
+    max: number | "unbounded";
+    namespace?: string;
+    processContents?: "lax" | "strict" | "skip";
+};
 /**
  * Represents a compiled complex type with attributes and elements
  *
@@ -34,6 +50,7 @@ export type QName = {
  * @property {string} [base] - Base type name for extension/inheritance
  * @property {Array<Object>} [localAttrs] - Attributes added in extension (not inherited)
  * @property {Array<Object>} [localElems] - Elements added in extension (not inherited)
+ * @property {Array<Object>} [wildcards] - xs:any wildcard particles retained on the type
  */
 export type CompiledType = {
     name: string;
@@ -73,6 +90,7 @@ export type CompiledType = {
         declaredType: string;
         doc?: string;
     }>;
+    wildcards?: CompiledWildcard[];
 };
 /**
  * Represents a compiled type alias (simple type or restricted type)
@@ -126,6 +144,26 @@ export type CompiledWsdlDocs = {
 export type CompiledDiagnostics = {
     notes?: string[];
 };
+/**
+ * Compiled SOAP operation shape. Extracted so that extended fields (stream
+ * metadata, future delivery modes) live in one named type instead of being
+ * buried inline on CompiledCatalog.operations.
+ */
+export type CompiledOperation = {
+    name: string;
+    soapAction: string;
+    inputElement?: QName;
+    outputElement?: QName;
+    security?: string[];
+    inputTypeName?: string;
+    outputTypeName?: string;
+    doc?: string;
+    /**
+     * Stream delivery metadata; populated from a StreamConfig when the operation
+     * is opted in. Absent for ordinary buffered operations.
+     */
+    stream?: OperationStreamMetadata;
+};
 /**
  * Complete compiled catalog with all types, aliases, operations and metadata
  *
@@ -149,16 +187,7 @@ export type CompiledCatalog = {
         childType: Record<string, Record<string, string>>;
         propMeta: Record<string, Record<string, any>>;
     };
-    operations: Array<{
-        name: string;
-        soapAction: string;
-        inputElement?: QName;
-        outputElement?: QName;
-        security?: string[];
-        inputTypeName?: string;
-        outputTypeName?: string;
-        doc?: string;
-    }>;
+    operations: CompiledOperation[];
     wsdlTargetNS: string;
     wsdlUri: string;
     serviceName?: string;
@@ -175,5 +204,5 @@ export type CompiledCatalog = {
  * 4. Extract WSDL operations: pick the appropriate SOAP binding (v1.1 or v1.2), resolve its
  *    portType reference, then enumerate operations and their soapAction URIs.
  */
-export declare function compileCatalog(cat: WsdlCatalog, options: CompilerOptions): CompiledCatalog;
+export declare function compileCatalog(cat: WsdlCatalog, options: CompilerOptions, streamConfig?: StreamConfig): CompiledCatalog;
 //# sourceMappingURL=schemaCompiler.d.ts.map

package/dist/compiler/schemaCompiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"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"}

package/dist/compiler/schemaCompiler.js

@@ -153,7 +153,7 @@ function extractAnnotationDocumentation(node) {
  * 4. Extract WSDL operations: pick the appropriate SOAP binding (v1.1 or v1.2), resolve its
  *    portType reference, then enumerate operations and their soapAction URIs.
  */
-export function compileCatalog(cat, options) {
+export function compileCatalog(cat, options, streamConfig) {
     // symbol tables discovered across all schemas
     const complexTypes = new Map();
     const simpleTypes = new Map();
@@ -353,6 +353,33 @@ export function compileCatalog(cat, options) {
             }
             return out;
         };
+        // Walks the same compositor structure as collectParticles and returns any
+        // xs:any wildcard particles found. Kept as a sibling to avoid reshaping
+        // collectParticles' return type at the three call sites below.
+        const collectWildcards = (node) => {
+            const out = [];
+            const recurse = (groupNode) => {
+                for (const a of getChildrenWithLocalName(groupNode, "any")) {
+                    const min = a["@_minOccurs"] ? Number(a["@_minOccurs"]) : 1;
+                    const maxAttr = a["@_maxOccurs"];
+                    const max = maxAttr === "unbounded" ? "unbounded" : maxAttr ? Number(maxAttr) : 1;
+                    const pc = a["@_processContents"];
+                    out.push({
+                        min,
+                        max,
+                        ...(a["@_namespace"] ? { namespace: a["@_namespace"] } : {}),
+                        ...(pc === "lax" || pc === "strict" || pc === "skip" ? { processContents: pc } : {}),
+                    });
+                }
+                for (const comp of ["sequence", "all", "choice"]) {
+                    for (const sub of getChildrenWithLocalName(groupNode, comp)) {
+                        recurse(sub);
+                    }
+                }
+            };
+            recurse(node);
+            return out;
+        };
         const collectParticles = (ownerTypeName, node) => {
             const out = [];
             // process a compositor or element container recursively
@@ -424,8 +451,12 @@ export function compileCatalog(cat, options) {
             // On duplicate definitions, merge new attributes and elements
             const newAttrs = collectAttributes(cnode);
             const newElems = collectParticles(outName, cnode);
+            const newWildcards = collectWildcards(cnode);
             mergeAttrs(present.attrs, newAttrs);
             mergeElems(present.elems, newElems);
+            if (newWildcards.length > 0) {
+                present.wildcards = [...(present.wildcards ?? []), ...newWildcards];
+            }
             if (!present.doc && typeDoc) {
                 present.doc = typeDoc;
             }
@@ -460,6 +491,7 @@ export function compileCatalog(cat, options) {
                 // collect local additions/overrides
                 const locals = collectAttributes(node);
                 const localElems = collectParticles(outName, node);
+                const localWildcards = collectWildcards(node);
                 attrs.push(...locals);
                 elems.push(...localElems);
                 const result = {
@@ -470,7 +502,8 @@ export function compileCatalog(cat, options) {
                     doc: typeDoc,
                     base: baseName,
                     localAttrs: locals,
-                    localElems
+                    localElems,
+                    ...(localWildcards.length > 0 ? { wildcards: localWildcards } : {}),
                 };
                 compiledMap.set(key, result);
                 inProgress.delete(key);
@@ -513,7 +546,15 @@ export function compileCatalog(cat, options) {
         // Attributes + particles
         mergeAttrs(attrs, collectAttributes(cnode));
         mergeElems(elems, collectParticles(outName, cnode));
-        const result = { name: outName, ns: schemaNS, attrs, elems, doc: typeDoc };
+        const wildcards = collectWildcards(cnode);
+        const result = {
+            name: outName,
+            ns: schemaNS,
+            attrs,
+            elems,
+            doc: typeDoc,
+            ...(wildcards.length > 0 ? { wildcards } : {}),
+        };
         compiledMap.set(key, result);
         inProgress.delete(rawKey);
         return result;
@@ -832,7 +873,7 @@ export function compileCatalog(cat, options) {
         .filter((x) => x != null)
         .sort((a, b) => a.name.localeCompare(b.name));
     // build operations list
-    const ops = (pOps
+    const ops = pOps
         .map(po => {
         const name = po?.["@_name"];
         if (!name)
@@ -845,9 +886,18 @@ export function compileCatalog(cat, options) {
         // Derive TypeScript type names from element local names
         const inputTypeName = inputElement ? pascal(inputElement.local) : undefined;
         const outputTypeName = outputElement ? pascal(outputElement.local) : undefined;
-        return { name, soapAction: bOps.get(name) || "", inputElement, outputElement, inputTypeName, outputTypeName, doc };
+        const op = {
+            name,
+            soapAction: bOps.get(name) || "",
+            ...(inputElement ? { inputElement } : {}),
+            ...(outputElement ? { outputElement } : {}),
+            ...(inputTypeName ? { inputTypeName } : {}),
+            ...(outputTypeName ? { outputTypeName } : {}),
+            ...(doc ? { doc } : {}),
+        };
+        return op;
     })
-        .filter((x) => x != null));
+        .filter((x) => x != null);
     // --- WS-Policy: scan for security requirements (inline policies only) ---
     const bindingPolicies = getChildrenWithLocalName(soapBinding || {}, "Policy");
     const bindingSec = collectSecurityFromPolicyNodes(bindingPolicies);
@@ -858,6 +908,31 @@ export function compileCatalog(cat, options) {
         const secSet = new Set([...bindingSec, ...opSec]);
         op.security = Array.from(secSet);
     }
+    // --- Stream config application ---
+    // A stream-configured operation is matched by name against the WSDL's
+    // portType operations. Unknown operation names are fatal so that consumers
+    // find out about stale configs at generation time, not at runtime.
+    if (streamConfig) {
+        const opByName = new Map(ops.map((op) => [op.name, op]));
+        for (const [opName, meta] of Object.entries(streamConfig.operations)) {
+            const op = opByName.get(opName);
+            if (!op) {
+                throw new WsdlCompilationError(`Stream config references operation "${opName}" but the WSDL portType does not declare it.`, {
+                    element: opName,
+                    suggestion: `Remove the entry under "operations.${opName}" in the stream config, or correct the operation name to match one defined in the WSDL.`,
+                });
+            }
+            op.stream = {
+                mode: meta.mode,
+                format: meta.format,
+                mediaType: meta.mediaType,
+                recordPath: [...meta.recordPath],
+                recordTypeName: meta.recordTypeName,
+                ...(meta.shapeCatalogName ? { shapeCatalogName: meta.shapeCatalogName } : {}),
+                ...(op.outputTypeName ? { sourceOutputTypeName: op.outputTypeName } : {}),
+            };
+        }
+    }
     // --- Service discovery (for client naming) ---
     let serviceName;
     const soapBindingName = soapBinding?.["@_name"];

package/dist/compiler/shapeResolver.d.ts

@@ -0,0 +1,18 @@
+import { type CompiledCatalog } from "./schemaCompiler.js";
+import type { StreamConfig } from "../util/streamConfig.js";
+export interface ApplyShapeCatalogsOptions {
+    /** Directory against which relative `catalogFile`/`wsdlSource` paths resolve. Defaults to process.cwd(). */
+    baseDir?: string;
+}
+/**
+ * Apply a parsed StreamConfig to a compiled catalog:
+ *   1. Verify every opted-in operation's record type is resolvable.
+ *   2. For each operation that names a shapeCatalog, load the companion
+ *      catalog (once, cached) and copy the reachable record-type graph.
+ *
+ * Mutates `compiled` in place. Safe to call with a StreamConfig that has
+ * zero shapeCatalogs — it will still validate record-type presence against
+ * the current catalog.
+ */
+export declare function applyShapeCatalogs(compiled: CompiledCatalog, streamConfig: StreamConfig, options?: ApplyShapeCatalogsOptions): Promise<void>;
+//# sourceMappingURL=shapeResolver.d.ts.map