@techspokes/typescript-wsdl-client 0.15.2 → 0.17.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

@@ -452,14 +452,15 @@ function generatePackageJson(appDir, force) {
             dev: "tsx watch server.ts",
         },
         dependencies: {
-            fastify: "^5.8.4",
+            fastify: "^5.8.5",
             "fastify-plugin": "^5.1.0",
-            soap: "^1.8.0",
+            saxes: "^6.0.0",
+            soap: "^1.9.1",
         },
         devDependencies: {
             "@types/node": "^25.6.0",
             tsx: "^4.21.0",
-            typescript: "^6.0.2",
+            typescript: "^6.0.3",
         },
     };
     fs.writeFileSync(filePath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");

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,13 +55,16 @@ 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)
             ? op.name
             : `[${JSON.stringify(op.name)}]`;
-        const inTypeName = op.inputElement ? pascal(op.inputElement.local) : undefined;
-        const outTypeName = op.outputElement ? pascal(op.outputElement.local) : undefined;
+        const inTypeName = op.inputTypeName ?? (op.inputElement ? pascal(op.inputElement.local) : undefined);
+        const outTypeName = op.outputTypeName ?? (op.outputElement ? pascal(op.outputElement.local) : undefined);
         if (!inTypeName && !outTypeName) {
             warn(`Operation ${op.name} has no input or output type defined. Skipping method generation.`);
             continue;
@@ -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,9 +32,12 @@ 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.inputElement ? pascal(op.inputElement.local) : undefined;
-        const outTypeName = op.outputElement ? pascal(op.outputElement.local) : undefined;
+        const inTypeName = op.inputTypeName ?? (op.inputElement ? pascal(op.inputElement.local) : undefined);
+        const outTypeName = op.outputTypeName ?? (op.outputElement ? pascal(op.outputElement.local) : undefined);
         if (!inTypeName && !outTypeName) {
             continue;
         }
@@ -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/client/generateTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateTypes.d.ts","sourceRoot":"","sources":["../../src/client/generateTypes.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAGjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QAyLvE"}
+{"version":3,"file":"generateTypes.d.ts","sourceRoot":"","sources":["../../src/client/generateTypes.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAGjF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QAsMvE"}

package/dist/client/generateTypes.js

@@ -61,8 +61,17 @@ export function generateTypes(outFile, compiled) {
     };
     // Convenience lookups
     const typeNames = new Set(compiled.types.map((t) => t.name));
+    const aliasNames = new Set(compiled.aliases.map((a) => a.name));
     const isValidIdent = (name) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name);
     const emitPropName = (name) => (isValidIdent(name) ? name : JSON.stringify(name));
+    const isSyntheticAliasSelfWrapper = (t) => {
+        const elems = t.elems || [];
+        return aliasNames.has(t.name) &&
+            (t.attrs || []).length === 0 &&
+            elems.length === 1 &&
+            elems[0].name === "$value" &&
+            elems[0].tsType === t.name;
+    };
     //
     // 1) Named simple types (aliases) first
     //
@@ -85,12 +94,16 @@ export function generateTypes(outFile, compiled) {
     // sort types by name to ensure consistent order
     compiled.types.sort((a, b) => a.name.localeCompare(b.name));
     for (const t of compiled.types) {
+        if (isSyntheticAliasSelfWrapper(t)) {
+            continue;
+        }
         // Detect complexContent extension via compiled metadata or mis-mapped simpleContent extension
         const complexBase = t.base;
         // Detect mis-mapped simpleContent extension: single "$value" whose tsType is another named interface
         const valueElems = (t.elems || []).filter((e) => e.name === "$value" &&
             (e.max === 1 || e.max === undefined) &&
             typeof e.tsType === "string" &&
+            e.tsType !== t.name &&
             typeNames.has(e.tsType));
         const isSimpleContentExtension = !complexBase && (t.elems?.length || 0) === 1 && valueElems.length === 1;
         const baseName = complexBase ?? (isSimpleContentExtension ? valueElems[0].tsType : undefined);

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)
@@ -123,6 +141,29 @@ export type CompiledWsdlDocs = {
     messages?: CompiledWsdlMessageDoc[];
     services?: CompiledWsdlServiceDoc[];
 };
+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
  *
@@ -146,20 +187,12 @@ 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;
     wsdlDocs?: CompiledWsdlDocs;
+    diagnostics?: CompiledDiagnostics;
 };
 /**
  * Compile a WSDL catalog into an internal representation (CompiledCatalog).
@@ -171,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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"}