@techspokes/typescript-wsdl-client 0.16.1 → 0.17.0

package/dist/compiler/shapeResolver.js

@@ -0,0 +1,280 @@
+/**
+ * Companion-catalog shape resolver (phase-2 of ADR-002).
+ *
+ * For stream operations whose record types live in a different WSDL (e.g.
+ * Escapia's main EVRN service provides the concrete UnitDescriptiveContentType
+ * while the content-service WSDL only exposes an xs:any-wrapped envelope),
+ * load the companion catalog and copy the reachable record-type graph into
+ * the current catalog.
+ *
+ * Invariants:
+ *   - A name collision against a type already in the current catalog is only
+ *     allowed when the two types are *structurally identical* — otherwise we
+ *     fail the build rather than silently rename public API types.
+ *   - Existing buffered generation stays byte-for-byte identical when no
+ *     streamConfig.shapeCatalogs entries are declared.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { compileCatalog } from "./schemaCompiler.js";
+import { loadWsdl } from "../loader/wsdlLoader.js";
+import { resolveCompilerOptions } from "../config.js";
+import { WsdlCompilationError } from "../util/errors.js";
+/**
+ * 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 async function applyShapeCatalogs(compiled, streamConfig, options = {}) {
+    const baseDir = options.baseDir ?? process.cwd();
+    // Load each declared shape catalog once, on-demand. Shape catalogs declared
+    // but never referenced are harmless — we only load the ones an operation
+    // actually uses.
+    const referencedCatalogs = new Set();
+    for (const meta of Object.values(streamConfig.operations)) {
+        if (meta.shapeCatalogName)
+            referencedCatalogs.add(meta.shapeCatalogName);
+    }
+    const companionByName = new Map();
+    for (const name of referencedCatalogs) {
+        const ref = streamConfig.shapeCatalogs[name];
+        if (!ref) {
+            throw new WsdlCompilationError(`Stream config references shape catalog "${name}" that is not declared under "shapeCatalogs".`, {
+                suggestion: `Add a "shapeCatalogs.${name}" entry pointing to a wsdlSource or catalogFile, or remove the reference.`,
+            });
+        }
+        companionByName.set(name, await loadCompanionCatalog(name, ref, baseDir, compiled));
+    }
+    for (const [opName, meta] of Object.entries(streamConfig.operations)) {
+        if (meta.shapeCatalogName) {
+            const companion = companionByName.get(meta.shapeCatalogName);
+            if (!companion) {
+                // Guarded by the loop above; this path is defensive.
+                throw new WsdlCompilationError(`Stream config for "${opName}" references shape catalog "${meta.shapeCatalogName}" which failed to load.`);
+            }
+            copyReachableGraph(compiled, companion, meta.recordTypeName, {
+                opName,
+                shapeCatalog: meta.shapeCatalogName,
+            });
+        }
+        else {
+            // No companion: the record type must already live in the main catalog.
+            if (!hasNamedType(compiled, meta.recordTypeName)) {
+                throw new WsdlCompilationError(`Stream config for operation "${opName}" references record type "${meta.recordTypeName}" which is not present in the compiled catalog.`, {
+                    element: meta.recordTypeName,
+                    suggestion: `Either declare a "shapeCatalogs.<name>" entry and set shapeCatalog on the operation, or correct the recordType to a type defined in the WSDL.`,
+                });
+            }
+        }
+    }
+}
+async function loadCompanionCatalog(name, ref, baseDir, compiled) {
+    if (ref.catalogFile) {
+        const abs = path.resolve(baseDir, ref.catalogFile);
+        let text;
+        try {
+            text = fs.readFileSync(abs, "utf-8");
+        }
+        catch (err) {
+            throw new WsdlCompilationError(`Failed to read companion catalog "${name}" at ${abs}: ${err.message}`, { suggestion: `Check that shapeCatalogs.${name}.catalogFile points to an existing catalog.json.` });
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch (err) {
+            throw new WsdlCompilationError(`Companion catalog "${name}" at ${abs} is not valid JSON: ${err.message}`);
+        }
+    }
+    if (ref.wsdlSource) {
+        // Relative paths resolve against baseDir; URLs pass through untouched.
+        const src = isLikelyUrl(ref.wsdlSource) ? ref.wsdlSource : path.resolve(baseDir, ref.wsdlSource);
+        const wsdlCatalog = await loadWsdl(src);
+        // Reuse the current catalog's compiler options so primitives / attrs keys
+        // / choice handling stay consistent with the main generation.
+        const companionOptions = resolveCompilerOptions({ ...compiled.options, catalog: false }, { wsdl: src, out: baseDir });
+        return compileCatalog(wsdlCatalog, companionOptions);
+    }
+    throw new WsdlCompilationError(`Shape catalog "${name}" declares neither wsdlSource nor catalogFile.`);
+}
+function isLikelyUrl(s) {
+    return /^[a-z][a-z0-9+.-]*:\/\//i.test(s);
+}
+function hasNamedType(cat, name) {
+    return cat.types.some((t) => t.name === name) || cat.aliases.some((a) => a.name === name);
+}
+/**
+ * Walk the reachable type graph from `rootTypeName` within the companion
+ * catalog and copy each reachable entry into `dst`. Types with the same name
+ * already present in `dst` are checked for structural equality; any divergence
+ * is fatal.
+ */
+function copyReachableGraph(dst, src, rootTypeName, context) {
+    const srcTypes = new Map(src.types.map((t) => [t.name, t]));
+    const srcAliases = new Map(src.aliases.map((a) => [a.name, a]));
+    if (!srcTypes.has(rootTypeName) && !srcAliases.has(rootTypeName)) {
+        throw new WsdlCompilationError(`Stream config for operation "${context.opName}" references record type "${rootTypeName}" but it is not present in shape catalog "${context.shapeCatalog}".`, {
+            element: rootTypeName,
+            suggestion: `Check the companion catalog or correct the recordType.`,
+        });
+    }
+    const known = new Set([...srcTypes.keys(), ...srcAliases.keys()]);
+    const queue = [rootTypeName];
+    const visited = new Set();
+    while (queue.length > 0) {
+        const typeName = queue.shift();
+        if (visited.has(typeName))
+            continue;
+        visited.add(typeName);
+        const srcType = srcTypes.get(typeName);
+        if (srcType) {
+            mergeType(dst, src, srcType, context);
+            // Enqueue referenced names from elems, attrs, base.
+            for (const e of srcType.elems ?? []) {
+                for (const ref of extractReferencedNames(e.tsType, known))
+                    queue.push(ref);
+            }
+            for (const a of srcType.attrs ?? []) {
+                for (const ref of extractReferencedNames(a.tsType, known))
+                    queue.push(ref);
+            }
+            if (srcType.base && known.has(srcType.base))
+                queue.push(srcType.base);
+            continue;
+        }
+        const srcAlias = srcAliases.get(typeName);
+        if (srcAlias) {
+            mergeAlias(dst, src, srcAlias, context);
+            for (const ref of extractReferencedNames(srcAlias.tsType, known))
+                queue.push(ref);
+        }
+        // Not in companion; silently skip — either a primitive or a type that
+        // the main catalog is expected to own.
+    }
+}
+function mergeType(dst, src, srcType, context) {
+    const existingIdx = dst.types.findIndex((t) => t.name === srcType.name);
+    if (existingIdx < 0) {
+        dst.types.push({ ...srcType });
+        copyTypeMeta(dst, src, srcType.name);
+        return;
+    }
+    const existing = dst.types[existingIdx];
+    if (!structurallyEqualType(existing, srcType)) {
+        throw new WsdlCompilationError(`Companion catalog "${context.shapeCatalog}" declares type "${srcType.name}" that conflicts structurally with the current catalog.`, {
+            element: srcType.name,
+            suggestion: `Rename one of the conflicting types in the source WSDL, or resolve the conflict before streaming. wsdl-tsc refuses to silently rename public API types.`,
+        });
+    }
+    // Structurally identical — keep the existing entry (and its meta) as-is.
+}
+function mergeAlias(dst, src, srcAlias, context) {
+    const existingIdx = dst.aliases.findIndex((a) => a.name === srcAlias.name);
+    if (existingIdx < 0) {
+        dst.aliases.push({ ...srcAlias });
+        // Aliases that point at a complex type get meta synonyms in compileCatalog;
+        // the main catalog already owns that path for its own types, so we only
+        // need to add meta if the companion aliases a complex type whose type we
+        // also just copied.
+        copyAliasSynonymMeta(dst, src, srcAlias.name);
+        return;
+    }
+    const existing = dst.aliases[existingIdx];
+    if (!structurallyEqualAlias(existing, srcAlias)) {
+        throw new WsdlCompilationError(`Companion catalog "${context.shapeCatalog}" declares alias "${srcAlias.name}" that conflicts structurally with the current catalog.`, {
+            element: srcAlias.name,
+            suggestion: `Resolve the conflicting type name before streaming. wsdl-tsc refuses to silently rename public API types.`,
+        });
+    }
+}
+function copyTypeMeta(dst, src, typeName) {
+    if (typeName in src.meta.attrSpec)
+        dst.meta.attrSpec[typeName] = [...src.meta.attrSpec[typeName]];
+    if (typeName in src.meta.attrType)
+        dst.meta.attrType[typeName] = { ...src.meta.attrType[typeName] };
+    if (typeName in src.meta.childType)
+        dst.meta.childType[typeName] = { ...src.meta.childType[typeName] };
+    if (typeName in src.meta.propMeta)
+        dst.meta.propMeta[typeName] = { ...src.meta.propMeta[typeName] };
+}
+function copyAliasSynonymMeta(dst, src, aliasName) {
+    // Phase-2 MVP: only copy meta for aliases whose name already keys into the
+    // source's meta maps. Aliases that are just simple-type renames don't need
+    // child/attr meta at all.
+    copyTypeMeta(dst, src, aliasName);
+}
+const TS_BUILTINS = new Set([
+    "string", "number", "boolean", "bigint", "null", "undefined", "void", "any", "unknown", "never",
+    "Date", "Array", "Record", "Map", "Set", "Promise", "Buffer", "Object", "Function",
+]);
+/**
+ * Extract PascalCase identifiers from a TypeScript type expression that are
+ * known to the companion catalog. Deliberately cheap — matches identifiers
+ * starting with an uppercase letter, skips TS built-ins and anything not
+ * present in the companion's known-names set.
+ */
+function extractReferencedNames(tsType, known) {
+    if (!tsType)
+        return [];
+    const out = [];
+    // Identifiers starting with an uppercase letter; bare word boundaries.
+    for (const m of tsType.matchAll(/\b[A-Z][A-Za-z0-9_]*\b/g)) {
+        const name = m[0];
+        if (TS_BUILTINS.has(name))
+            continue;
+        if (known.has(name))
+            out.push(name);
+    }
+    return out;
+}
+function structurallyEqualType(a, b) {
+    return canonicalizeType(a) === canonicalizeType(b);
+}
+function structurallyEqualAlias(a, b) {
+    return canonicalizeAlias(a) === canonicalizeAlias(b);
+}
+function canonicalizeType(t) {
+    // Drop fields that legitimately differ between catalogs (ns, docs) and
+    // stabilize ordering. Stream metadata is on operations, not on types.
+    return JSON.stringify({
+        name: t.name,
+        attrs: (t.attrs ?? []).map(canonicalizeAttr),
+        elems: (t.elems ?? []).map(canonicalizeElem),
+        base: t.base ?? null,
+        wildcards: (t.wildcards ?? []).map((w) => ({
+            min: w.min,
+            max: w.max,
+            namespace: w.namespace ?? null,
+            processContents: w.processContents ?? null,
+        })),
+    });
+}
+function canonicalizeAlias(a) {
+    return JSON.stringify({
+        name: a.name,
+        tsType: a.tsType,
+        declared: a.declared,
+    });
+}
+function canonicalizeAttr(a) {
+    return {
+        name: a.name,
+        tsType: a.tsType,
+        use: a.use ?? "optional",
+        declaredType: a.declaredType,
+    };
+}
+function canonicalizeElem(e) {
+    return {
+        name: e.name,
+        tsType: e.tsType,
+        min: e.min,
+        max: e.max,
+        nillable: !!e.nillable,
+        declaredType: e.declaredType,
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"generateGateway.d.ts","sourceRoot":"","sources":["../../src/gateway/generateGateway.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAE/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6JjF"}
+{"version":3,"file":"generateGateway.d.ts","sourceRoot":"","sources":["../../src/gateway/generateGateway.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAE/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8JjF"}

package/dist/gateway/generateGateway.js

@@ -183,7 +183,8 @@ export async function generateGateway(opts) {
     }
     // Step 6: Emit runtime.ts (if enabled)
     if (emitRuntime) {
-        emitRuntimeModule(outDir, versionSlug, serviceSlug, shouldUnwrap ? catalog : undefined);
+        const hasStreams = operations.some((o) => !!o.stream);
+        emitRuntimeModule(outDir, versionSlug, serviceSlug, shouldUnwrap ? catalog : undefined, { hasStreams });
     }
     // Step 7: Emit plugin.ts and type-check fixture (if enabled)
     if (emitPlugin) {

package/dist/gateway/generators.d.ts

@@ -40,6 +40,16 @@ export interface OperationMetadata {
     description?: string;
     /** When true, response schema is omitted from route registration to avoid fast-json-stringify stack overflow on deeply nested $ref graphs */
     skipResponseSchema?: boolean;
+    /**
+     * Stream metadata populated from the OpenAPI `x-wsdl-tsc-stream` extension.
+     * When present, the route handler pipes `result.records` through the NDJSON
+     * helper instead of envelope-wrapping a single response object.
+     */
+    stream?: {
+        mediaType: string;
+        format: "ndjson" | "json-array";
+        recordTypeName?: string;
+    };
 }
 /**
  * Emits Fastify-compatible operation schema files
@@ -107,7 +117,9 @@ export declare function emitSchemasModule(outDir: string, modelsDir: string, ver
  * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode for generated TypeScript modules
  */
 export declare function emitRouteFiles(outDir: string, routesDir: string, versionSlug: string, serviceSlug: string, operations: OperationMetadata[], importsMode: "js" | "ts" | "bare"): void;
-export declare function emitRuntimeModule(outDir: string, versionSlug: string, serviceSlug: string, catalog?: any): void;
+export declare function emitRuntimeModule(outDir: string, versionSlug: string, serviceSlug: string, catalog?: any, opts?: {
+    hasStreams?: boolean;
+}): void;
 /**
  * Emits plugin.ts module as the primary Fastify plugin wrapper
  *

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

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

package/dist/gateway/generators.js

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

package/dist/gateway/helpers.d.ts

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

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

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

package/dist/gateway/helpers.js

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

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

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

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