@techspokes/typescript-wsdl-client 0.11.3 → 0.11.6

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;AAklBD;;;;;;;;;;;;;;;;;;;;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;AA0kBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzE"}

package/dist/app/generateApp.js

@@ -25,7 +25,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { deriveClientName } from "../util/tools.js";
 import { info, success } from "../util/cli.js";
-import { computeRelativeImport, getImportExtension } from "../util/imports.js";
+import { computeRelativeImport } from "../util/imports.js";
 /**
  * Validates that all required files and directories exist
  *
@@ -67,15 +67,6 @@ function validateRequiredFiles(opts) {
         throw new Error(`Gateway plugin entrypoint does not exist in ${opts.gatewayDir} (tried plugin.ts, plugin.js, plugin)`);
     }
 }
-/**
- * Returns the file extension for the import mode
- *
- * @param {string} imports - Import mode (js, ts, or bare)
- * @returns {string} - File extension with leading dot or empty string for bare
- */
-function getExtension(imports) {
-    return getImportExtension(imports);
-}
 /**
  * Returns the file extension for scaffold app files (server, config).
  * Always .ts — the scaffold is TypeScript for full type safety.
@@ -295,6 +286,7 @@ main().catch((err) => {
 function generateConfigFile(appDir, opts, defaultWsdlSource, force) {
     const ext = getAppFileExtension();
     const filePath = path.join(appDir, `config${ext}`);
+    // noinspection DuplicatedCode
     if (!shouldWriteScaffoldFile(filePath, force))
         return;
     const defaultHost = opts.host || "127.0.0.1";
@@ -384,6 +376,7 @@ export function loadConfig(): AppConfig {
  */
 function generateEnvExample(appDir, opts, defaultWsdlSource, force) {
     const filePath = path.join(appDir, ".env.example");
+    // noinspection DuplicatedCode
     if (!shouldWriteScaffoldFile(filePath, force))
         return;
     const defaultHost = opts.host || "127.0.0.1";
@@ -461,7 +454,7 @@ function generatePackageJson(appDir, force) {
         dependencies: {
             fastify: "^5.7.4",
             "fastify-plugin": "^5.1.0",
-            soap: "^1.6.5",
+            soap: "^1.7.1",
         },
         devDependencies: {
             tsx: "^4.21.0",

package/dist/compiler/schemaCompiler.d.ts

@@ -105,6 +105,7 @@ export type CompiledCatalog = {
     aliases: CompiledAlias[];
     meta: {
         attrSpec: Record<string, string[]>;
+        attrType: Record<string, Record<string, string>>;
         childType: Record<string, Record<string, string>>;
         propMeta: Record<string, Record<string, any>>;
     };

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

@@ -136,6 +136,7 @@ export function compileCatalog(cat, options) {
     const inProgress = new Set();
     // meta accumulators
     const attrSpec = {};
+    const attrType = {};
     const childType = {};
     const propMeta = {};
     /** Compile a simpleType node to TS */
@@ -536,9 +537,28 @@ export function compileCatalog(cat, options) {
     // emit lists
     const typesList = Array.from(compiledMap.values());
     const aliasList = Array.from(aliasMap.values());
+    // Build alias resolution map for simple type aliases (e.g. YesNoType -> '"Yes" | "No"')
+    const aliasResolve = new Map();
+    for (const a of aliasList) {
+        if (a.tsType && a.tsType !== a.name) {
+            aliasResolve.set(a.name, a.tsType);
+        }
+    }
     // meta
     for (const t of typesList) {
         attrSpec[t.name] = (t.attrs || []).map(a => a.name);
+        const attrMap = {};
+        for (const a of t.attrs || []) {
+            let tsType = typeof a.tsType === "string" ? a.tsType : "string";
+            // Resolve alias names to their underlying TS types for mock data generation
+            if (aliasResolve.has(tsType)) {
+                tsType = aliasResolve.get(tsType);
+            }
+            attrMap[a.name] = tsType;
+        }
+        if (Object.keys(attrMap).length > 0) {
+            attrType[t.name] = attrMap;
+        }
         const child = {};
         const meta = {};
         for (const e of t.elems || []) {
@@ -561,6 +581,9 @@ export function compileCatalog(cat, options) {
                 childType[a.name] = childType[a.tsType];
                 propMeta[a.name] = propMeta[a.tsType];
                 attrSpec[a.name] = attrSpec[a.tsType];
+                if (a.tsType in attrType) {
+                    attrType[a.name] = attrType[a.tsType];
+                }
             }
         }
     }
@@ -664,7 +687,7 @@ export function compileCatalog(cat, options) {
         options: options,
         types: typesList,
         aliases: aliasList,
-        meta: { attrSpec, childType, propMeta },
+        meta: { attrSpec, attrType, childType, propMeta },
         operations: ops,
         wsdlTargetNS: defs?.["@_targetNamespace"] || "",
         serviceName,

package/dist/gateway/generateGateway.js

@@ -183,7 +183,7 @@ export async function generateGateway(opts) {
     }
     // Step 7: Emit plugin.ts and type-check fixture (if enabled)
     if (emitPlugin) {
-        emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode, operations);
+        emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode);
         emitTypeCheckFixture(outDir, clientMeta, importsMode);
     }
 }

package/dist/gateway/generators.d.ts

@@ -36,6 +36,8 @@ export interface OperationMetadata {
     clientMethodName?: string;
     requestTypeName?: string;
     responseTypeName?: string;
+    /** When true, response schema is omitted from route registration to avoid fast-json-stringify stack overflow on deeply nested $ref graphs */
+    skipResponseSchema?: boolean;
 }
 /**
  * Emits Fastify-compatible operation schema files
@@ -118,9 +120,8 @@ export declare function emitRuntimeModule(outDir: string, versionSlug: string, s
  * @param {string} serviceSlug - Service slug for function naming
  * @param {ClientMeta} clientMeta - Client class metadata
  * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
- * @param {OperationMetadata[]} operations - Operation metadata for generating the operations interface
  */
-export declare function emitPluginModule(outDir: string, versionSlug: string, serviceSlug: string, clientMeta: ClientMeta, importsMode: "js" | "ts" | "bare", operations: OperationMetadata[]): void;
+export declare function emitPluginModule(outDir: string, versionSlug: string, serviceSlug: string, clientMeta: ClientMeta, importsMode: "js" | "ts" | "bare"): void;
 /**
  * Emits a type-check fixture that verifies plugin-client type compatibility
  *
@@ -151,6 +152,7 @@ export declare function emitTypeCheckFixture(outDir: string, clientMeta: ClientM
  * @param {OperationMetadata[]} operations - Array of operation metadata
  * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
  * @param {ClientMeta} clientMeta - Client class metadata
+ * @param {any} [catalog] - Compiled catalog for detecting ArrayOf* wrapper types to unwrap
  */
 export declare function emitRouteFilesWithHandlers(outDir: string, routesDir: string, versionSlug: string, serviceSlug: string, operations: OperationMetadata[], importsMode: "js" | "ts" | "bare", clientMeta: ClientMeta, catalog?: any): void;
 //# sourceMappingURL=generators.d.ts.map

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

@@ -12,7 +12,8 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { flattenAllOf, rewriteSchemaRefs, slugName, } from "./helpers.js";
+import { flattenAllOf, measureSchemaRefComplexity, rewriteSchemaRefs, slugName, } from "./helpers.js";
+import { detectArrayWrappers as detectArrayWrappersShared } from "../util/catalogMeta.js";
 /**
  * Emits individual JSON Schema files for each OpenAPI component schema
  *
@@ -174,12 +175,29 @@ export function emitOperationSchemas(doc, opsDir, versionSlug, serviceSlug, sche
                 opSchema.querystring = querySchema;
             if (headersSchema)
                 opSchema.headers = headersSchema;
+            // Check response schema $ref complexity — fast-json-stringify stack-overflows
+            // on deeply nested $ref graphs (typically > 150 unique schema references).
+            const REF_COMPLEXITY_LIMIT = 150;
+            let skipResponseSchema = false;
+            const allSchemas = doc.components?.schemas ?? {};
+            for (const code of Object.keys(responseObj)) {
+                const refId = responseObj[code]?.$ref;
+                if (!refId)
+                    continue;
+                // Extract component name from URN: look up inverse of schemaIdByName
+                const schemaName = Object.keys(schemaIdByName).find(n => schemaIdByName[n] + "#" === refId);
+                if (schemaName && measureSchemaRefComplexity(schemaName, allSchemas, REF_COMPLEXITY_LIMIT) >= REF_COMPLEXITY_LIMIT) {
+                    skipResponseSchema = true;
+                    break;
+                }
+            }
             const opOutPath = path.join(opsDir, `${operationSlug}.json`);
             fs.writeFileSync(opOutPath, JSON.stringify(opSchema, null, 2), "utf8");
             operations.push({
                 operationSlug,
                 method: lowerMethod,
                 path: p,
+                skipResponseSchema,
             });
         }
     }
@@ -255,10 +273,22 @@ export function emitRouteFiles(outDir, routesDir, versionSlug, serviceSlug, oper
         routeTs += `import type { FastifyInstance } from "fastify";\n`;
         routeTs += `import schema from "../schemas/operations/${op.operationSlug}.json" with { type: "json" };\n\n`;
         routeTs += `export async function ${fnName}(fastify: FastifyInstance) {\n`;
-        routeTs += `  fastify.route({\n`;
-        routeTs += `    method: "${op.method.toUpperCase()}",\n`;
-        routeTs += `    url: "${op.path}",\n`;
-        routeTs += `    schema: schema as any,\n`;
+        if (op.skipResponseSchema) {
+            // Response schema too complex for fast-json-stringify — strip it so Fastify
+            // falls back to JSON.stringify for response serialization.
+            routeTs += `  // Response schema omitted: $ref graph exceeds fast-json-stringify depth limit\n`;
+            routeTs += `  const { response: _response, ...routeSchema } = schema as Record<string, unknown>;\n`;
+            routeTs += `  fastify.route({\n`;
+            routeTs += `    method: "${op.method.toUpperCase()}",\n`;
+            routeTs += `    url: "${op.path}",\n`;
+            routeTs += `    schema: routeSchema as any,\n`;
+        }
+        else {
+            routeTs += `  fastify.route({\n`;
+            routeTs += `    method: "${op.method.toUpperCase()}",\n`;
+            routeTs += `    url: "${op.path}",\n`;
+            routeTs += `    schema: schema as any,\n`;
+        }
         routeTs += `    handler: async (request, reply) => {\n`;
         routeTs += `      throw new Error("Not implemented");\n`;
         routeTs += `    }\n`;
@@ -291,25 +321,13 @@ export function emitRouteFiles(outDir, routesDir, versionSlug, serviceSlug, oper
 /**
  * Detects ArrayOf* wrapper types from catalog type metadata.
  *
- * An ArrayOf* wrapper has exactly one element with max "unbounded" (or > 1)
- * and no attributes — mirroring the logic in generateSchemas.ts isArrayWrapper().
+ * Delegates to the shared utility in src/util/catalogMeta.ts.
  *
  * @param catalog - Compiled catalog object
  * @returns Record mapping wrapper type name to inner element property name
  */
 function detectArrayWrappers(catalog) {
-    const wrappers = {};
-    for (const t of catalog.types || []) {
-        if (t.attrs && t.attrs.length !== 0)
-            continue;
-        if (!t.elems || t.elems.length !== 1)
-            continue;
-        const e = t.elems[0];
-        if (e.max !== "unbounded" && !(e.max > 1))
-            continue;
-        wrappers[t.name] = e.name;
-    }
-    return wrappers;
+    return detectArrayWrappersShared(catalog.types || []);
 }
 export function emitRuntimeModule(outDir, versionSlug, serviceSlug, catalog) {
     const vSlug = slugName(versionSlug);
@@ -351,7 +369,13 @@ export function unwrapArrayWrappers(data: unknown, typeName: string): unknown {
   // If this type is itself a wrapper, unwrap it
   if (typeName in ARRAY_WRAPPERS) {
     const innerKey = ARRAY_WRAPPERS[typeName];
-    return (data as Record<string, unknown>)[innerKey] ?? [];
+    const arr = (data as Record<string, unknown>)[innerKey] ?? [];
+    // Recurse into each item using the element's type from CHILDREN_TYPES
+    if (Array.isArray(arr) && typeName in CHILDREN_TYPES) {
+      const elemType = CHILDREN_TYPES[typeName][innerKey];
+      if (elemType) return arr.map(item => unwrapArrayWrappers(item, elemType));
+    }
+    return arr;
   }
 
   // Recurse into children whose types may contain wrappers
@@ -360,7 +384,11 @@ export function unwrapArrayWrappers(data: unknown, typeName: string): unknown {
     for (const [propName, propType] of Object.entries(children)) {
       const val = (data as Record<string, unknown>)[propName];
       if (val !== undefined) {
-        (data as Record<string, unknown>)[propName] = unwrapArrayWrappers(val, propType);
+        if (Array.isArray(val)) {
+          (data as Record<string, unknown>)[propName] = val.map(item => unwrapArrayWrappers(item, propType));
+        } else {
+          (data as Record<string, unknown>)[propName] = unwrapArrayWrappers(val, propType);
+        }
       }
     }
   }
@@ -558,9 +586,8 @@ export function createGatewayErrorHandler_${vSlug}_${sSlug}() {
  * @param {string} serviceSlug - Service slug for function naming
  * @param {ClientMeta} clientMeta - Client class metadata
  * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
- * @param {OperationMetadata[]} operations - Operation metadata for generating the operations interface
  */
-export function emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode, operations) {
+export function emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode) {
     const vSlug = slugName(versionSlug);
     const sSlug = slugName(serviceSlug);
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
@@ -704,6 +731,7 @@ void _assertClientCompatible;
  * @param {OperationMetadata[]} operations - Array of operation metadata
  * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
  * @param {ClientMeta} clientMeta - Client class metadata
+ * @param {any} [catalog] - Compiled catalog for detecting ArrayOf* wrapper types to unwrap
  */
 export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, serviceSlug, operations, importsMode, clientMeta, catalog) {
     fs.mkdirSync(routesDir, { recursive: true });
@@ -746,6 +774,12 @@ export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, servi
             ? `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`
+            : "";
+        const schemaLine = op.skipResponseSchema
+            ? "    schema: routeSchema,"
+            : "    schema,";
         let routeTs = `/**
  * Route: ${op.method.toUpperCase()} ${op.path}
  * Operation: ${op.operationId || op.operationSlug}
@@ -756,12 +790,12 @@ export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, servi
 import type { FastifyInstance } from "fastify";
 ${typeImport}import schema from "../schemas/operations/${op.operationSlug}.json" with { type: "json" };
 ${runtimeImport}
-
+${schemaBinding}
 export async function ${fnName}(fastify: FastifyInstance) {
   fastify.route${routeGeneric}({
     method: "${op.method.toUpperCase()}",
     url: "${op.path}",
-    schema,
+${schemaLine}
     handler: async (request) => {
       const client = fastify.${clientMeta.decoratorName};
       const result = await client.${clientMethod}(${bodyArg});

package/dist/gateway/helpers.d.ts

@@ -222,4 +222,17 @@ export declare function resolveOperationMeta(operationId: string, operationSlug:
     inputTypeName?: string;
     outputTypeName?: string;
 }>): ResolvedOperationMeta;
+/**
+ * Measures the $ref graph complexity of a schema component.
+ *
+ * Walks all $ref chains from the starting schema and counts the number of
+ * unique schemas referenced. Used to detect response schemas that are too
+ * complex for fast-json-stringify to compile without stack overflow.
+ *
+ * @param startSchemaName - Name of the schema component to start from
+ * @param allSchemas - All component schemas (from doc.components.schemas)
+ * @param limit - Stop walking after this many unique refs (default 200)
+ * @returns Number of unique schema components reachable via $ref
+ */
+export declare function measureSchemaRefComplexity(startSchemaName: string, allSchemas: Record<string, any>, limit?: number): number;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -428,3 +428,61 @@ export function resolveOperationMeta(operationId, operationSlug, method, path, c
         responseTypeName,
     };
 }
+/**
+ * Measures the $ref graph complexity of a schema component.
+ *
+ * Walks all $ref chains from the starting schema and counts the number of
+ * unique schemas referenced. Used to detect response schemas that are too
+ * complex for fast-json-stringify to compile without stack overflow.
+ *
+ * @param startSchemaName - Name of the schema component to start from
+ * @param allSchemas - All component schemas (from doc.components.schemas)
+ * @param limit - Stop walking after this many unique refs (default 200)
+ * @returns Number of unique schema components reachable via $ref
+ */
+export function measureSchemaRefComplexity(startSchemaName, allSchemas, limit = 200) {
+    const visited = new Set();
+    function walkSchema(node) {
+        if (!node || typeof node !== "object" || visited.size >= limit)
+            return;
+        if (Array.isArray(node)) {
+            for (const item of node)
+                walkSchema(item);
+            return;
+        }
+        if (node.$ref && typeof node.$ref === "string") {
+            const prefix = "#/components/schemas/";
+            if (node.$ref.startsWith(prefix)) {
+                const refName = node.$ref.slice(prefix.length);
+                if (!visited.has(refName)) {
+                    visited.add(refName);
+                    if (allSchemas[refName])
+                        walkSchema(allSchemas[refName]);
+                }
+            }
+            return;
+        }
+        if (node.properties) {
+            for (const propSchema of Object.values(node.properties))
+                walkSchema(propSchema);
+        }
+        if (node.items)
+            walkSchema(node.items);
+        if (node.additionalProperties && typeof node.additionalProperties === "object") {
+            walkSchema(node.additionalProperties);
+        }
+        if (node.allOf)
+            for (const m of node.allOf)
+                walkSchema(m);
+        if (node.anyOf)
+            for (const m of node.anyOf)
+                walkSchema(m);
+        if (node.oneOf)
+            for (const m of node.oneOf)
+                walkSchema(m);
+    }
+    visited.add(startSchemaName);
+    if (allSchemas[startSchemaName])
+        walkSchema(allSchemas[startSchemaName]);
+    return visited.size;
+}

package/dist/pipeline.d.ts

@@ -43,6 +43,7 @@ export interface PipelineOptions {
     test?: {
         testDir: string;
         force?: boolean;
+        flattenArrayWrappers?: boolean;
     };
 }
 /**

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAGzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CAgJhH"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAGzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CAiJhH"}

package/dist/pipeline.js

@@ -143,6 +143,7 @@ export async function runGenerationPipeline(opts) {
             force: opts.test.force,
             versionSlug: opts.gateway.versionSlug,
             serviceSlug: opts.gateway.serviceSlug,
+            flattenArrayWrappers: opts.test.flattenArrayWrappers ?? opts.openapi?.flattenArrayWrappers,
         });
     }
     // Return the compiled catalog and OpenAPI doc for potential further processing

package/dist/test/generateTests.d.ts

@@ -10,6 +10,7 @@ export interface GenerateTestsOptions {
     force?: boolean;
     versionSlug?: string;
     serviceSlug?: string;
+    flattenArrayWrappers?: boolean;
 }
 /**
  * Generates a complete Vitest test suite for the generated gateway artifacts.

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

@@ -1 +1 @@
-{"version":3,"file":"generateTests.d.ts","sourceRoot":"","sources":["../../src/test/generateTests.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4J7E"}
+{"version":3,"file":"generateTests.d.ts","sourceRoot":"","sources":["../../src/test/generateTests.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAuBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiK7E"}

package/dist/test/generateTests.js

@@ -15,6 +15,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { info, success } from "../util/cli.js";
 import { resolveClientMeta, resolveOperationMeta } from "../gateway/helpers.js";
+import { generateAllOperationMocks } from "./mockData.js";
 import { emitVitestConfig, emitMockClientHelper, emitTestAppHelper, emitRoutesTest, emitErrorsTest, emitEnvelopeTest, emitValidationTest, emitClassifyErrorTest, emitEnvelopeBuildersTest, emitUnwrapTest, } from "./generators.js";
 /**
  * Checks whether a test file should be written.
@@ -109,18 +110,22 @@ export async function generateTests(opts) {
     fs.mkdirSync(path.join(testDir, "helpers"), { recursive: true });
     fs.mkdirSync(path.join(testDir, "gateway"), { recursive: true });
     fs.mkdirSync(path.join(testDir, "runtime"), { recursive: true });
+    // Compute mock data once for all emitters
+    const mocks = generateAllOperationMocks(catalog, {
+        flattenArrayWrappers: opts.flattenArrayWrappers,
+    });
     // Emit vitest.config.ts
     writeTestFile(path.join(testDir, "vitest.config.ts"), emitVitestConfig(), force);
     // Emit helpers/mock-client.ts
-    writeTestFile(path.join(testDir, "helpers", "mock-client.ts"), emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, catalog), force);
+    writeTestFile(path.join(testDir, "helpers", "mock-client.ts"), emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, mocks), force);
     // Emit helpers/test-app.ts
     writeTestFile(path.join(testDir, "helpers", "test-app.ts"), emitTestAppHelper(testDir, gatewayDir, importsMode, clientMeta), force);
     // Emit gateway/routes.test.ts
-    writeTestFile(path.join(testDir, "gateway", "routes.test.ts"), emitRoutesTest(testDir, importsMode, operations, catalog), force);
+    writeTestFile(path.join(testDir, "gateway", "routes.test.ts"), emitRoutesTest(testDir, importsMode, operations, mocks), force);
     // Emit gateway/errors.test.ts
-    writeTestFile(path.join(testDir, "gateway", "errors.test.ts"), emitErrorsTest(testDir, importsMode, operations, catalog), force);
+    writeTestFile(path.join(testDir, "gateway", "errors.test.ts"), emitErrorsTest(testDir, importsMode, operations, mocks), force);
     // Emit gateway/envelope.test.ts
-    writeTestFile(path.join(testDir, "gateway", "envelope.test.ts"), emitEnvelopeTest(testDir, importsMode, operations, catalog), force);
+    writeTestFile(path.join(testDir, "gateway", "envelope.test.ts"), emitEnvelopeTest(testDir, importsMode, operations, mocks), force);
     // Emit gateway/validation.test.ts
     writeTestFile(path.join(testDir, "gateway", "validation.test.ts"), emitValidationTest(testDir, importsMode, operations), force);
     // Emit runtime/classify-error.test.ts

package/dist/test/generators.d.ts

@@ -1,5 +1,10 @@
 import type { ClientMeta, ResolvedOperationMeta } from "../gateway/helpers.js";
 import type { CatalogForMocks } from "./mockData.js";
+/** Pre-computed mock data map passed from the orchestrator to all emitters. */
+export type OperationMocksMap = Map<string, {
+    request: Record<string, unknown>;
+    response: Record<string, unknown>;
+}>;
 /**
  * Emits vitest.config.ts content.
  *
@@ -15,9 +20,9 @@ export declare function emitVitestConfig(): string;
  * @param importsMode - Import extension mode
  * @param clientMeta - Client metadata
  * @param operations - Resolved operation metadata
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export declare function emitMockClientHelper(testDir: string, clientDir: string, importsMode: "js" | "ts" | "bare", clientMeta: ClientMeta, operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+export declare function emitMockClientHelper(testDir: string, clientDir: string, importsMode: "js" | "ts" | "bare", clientMeta: ClientMeta, operations: ResolvedOperationMeta[], mocks: OperationMocksMap): string;
 /**
  * Emits helpers/test-app.ts content.
  *
@@ -33,22 +38,22 @@ export declare function emitTestAppHelper(testDir: string, gatewayDir: string, i
  * @param testDir - Absolute path to test output directory
  * @param importsMode - Import extension mode
  * @param operations - Resolved operation metadata
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export declare function emitRoutesTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+export declare function emitRoutesTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], mocks: OperationMocksMap): string;
 /**
  * Emits gateway/errors.test.ts with error classification tests through Fastify.
  *
  * @param testDir - Absolute path to test output directory
  * @param importsMode - Import extension mode
  * @param operations - Resolved operation metadata (uses first operation for error tests)
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export declare function emitErrorsTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+export declare function emitErrorsTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], mocks: OperationMocksMap): string;
 /**
  * Emits gateway/envelope.test.ts with SUCCESS/ERROR structure assertions.
  */
-export declare function emitEnvelopeTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+export declare function emitEnvelopeTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], mocks: OperationMocksMap): string;
 /**
  * Emits gateway/validation.test.ts with invalid payload tests per route.
  */

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

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

package/dist/test/generators.js

@@ -1,3 +1,4 @@
+// noinspection DuplicatedCode
 /**
  * Test File Emitters
  *
@@ -8,7 +9,7 @@
  * via computeRelativeImport() from src/util/imports.ts.
  */
 import { computeRelativeImport } from "../util/imports.js";
-import { generateAllOperationMocks } from "./mockData.js";
+import { detectArrayWrappers, detectChildrenTypes } from "../util/catalogMeta.js";
 /**
  * Emits vitest.config.ts content.
  *
@@ -16,12 +17,13 @@ import { generateAllOperationMocks } from "./mockData.js";
  * config file location, not the working directory.
  */
 export function emitVitestConfig() {
-    return `import { dirname } from "node:path";
+    return `import { defineProject } from "vitest/config";
+import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-export default {
+export default defineProject({
   test: {
     root: __dirname,
     include: [
@@ -30,7 +32,7 @@ export default {
     ],
     testTimeout: 30000,
   },
-};
+});
 `;
 }
 /**
@@ -41,12 +43,11 @@ export default {
  * @param importsMode - Import extension mode
  * @param clientMeta - Client metadata
  * @param operations - Resolved operation metadata
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export function emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, catalog) {
+export function emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, mocks) {
     const helpersDir = `${testDir}/helpers`;
     const operationsImport = computeRelativeImport(helpersDir, `${clientDir}/operations`, importsMode);
-    const mocks = generateAllOperationMocks(catalog);
     // Sort operations for deterministic output
     const sortedOps = [...operations].sort((a, b) => a.operationId.localeCompare(b.operationId));
     const methodEntries = sortedOps.map((op) => {
@@ -140,12 +141,12 @@ export async function createTestApp(
  * @param testDir - Absolute path to test output directory
  * @param importsMode - Import extension mode
  * @param operations - Resolved operation metadata
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export function emitRoutesTest(testDir, importsMode, operations, catalog) {
+// noinspection JSUnusedLocalSymbols
+export function emitRoutesTest(testDir, importsMode, operations, mocks) {
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
     const testAppImport = `../helpers/test-app${suffix}`;
-    const mocks = generateAllOperationMocks(catalog);
     // Sort operations for deterministic output
     const sortedOps = [...operations].sort((a, b) => a.operationId.localeCompare(b.operationId));
     const testCases = sortedOps.map((op) => {
@@ -190,9 +191,10 @@ ${testCases}
  * @param testDir - Absolute path to test output directory
  * @param importsMode - Import extension mode
  * @param operations - Resolved operation metadata (uses first operation for error tests)
- * @param catalog - Compiled catalog for mock data generation
+ * @param mocks - Pre-computed mock data map
  */
-export function emitErrorsTest(testDir, importsMode, operations, catalog) {
+// noinspection JSUnusedLocalSymbols
+export function emitErrorsTest(testDir, importsMode, operations, mocks) {
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
     const testAppImport = `../helpers/test-app${suffix}`;
     const mockClientImport = `../helpers/mock-client${suffix}`;
@@ -201,7 +203,6 @@ export function emitErrorsTest(testDir, importsMode, operations, catalog) {
     const op = sortedOps[0];
     if (!op)
         return "// No operations found\n";
-    const mocks = generateAllOperationMocks(catalog);
     const mockData = mocks.get(op.operationId);
     const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
     return `/**
@@ -324,7 +325,9 @@ describe("gateway routes — error handling", () => {
 /**
  * Emits gateway/envelope.test.ts with SUCCESS/ERROR structure assertions.
  */
-export function emitEnvelopeTest(testDir, importsMode, operations, catalog) {
+// noinspection JSUnusedLocalSymbols
+export function emitEnvelopeTest(testDir, importsMode, operations, mocks) {
+    // noinspection DuplicatedCode
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
     const testAppImport = `../helpers/test-app${suffix}`;
     const mockClientImport = `../helpers/mock-client${suffix}`;
@@ -332,7 +335,6 @@ export function emitEnvelopeTest(testDir, importsMode, operations, catalog) {
     const op = sortedOps[0];
     if (!op)
         return "// No operations found\n";
-    const mocks = generateAllOperationMocks(catalog);
     const mockData = mocks.get(op.operationId);
     const requestPayload = JSON.stringify(mockData?.request ?? {}, null, 4).replace(/\n/g, "\n    ");
     return `/**
@@ -397,6 +399,7 @@ describe("gateway — envelope structure", () => {
 /**
  * Emits gateway/validation.test.ts with invalid payload tests per route.
  */
+// noinspection JSUnusedLocalSymbols
 export function emitValidationTest(testDir, importsMode, operations) {
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
     const testAppImport = `../helpers/test-app${suffix}`;
@@ -570,10 +573,14 @@ describe("buildErrorEnvelope", () => {
  * Returns null if no array wrappers exist in the catalog.
  */
 export function emitUnwrapTest(testDir, gatewayDir, importsMode, catalog) {
-    // Detect array wrappers
-    const wrappers = detectArrayWrappersFromCatalog(catalog);
+    // Detect array wrappers using shared utility with full type definitions
+    const types = catalog.types ?? [];
+    const wrappers = detectArrayWrappers(types);
     if (Object.keys(wrappers).length === 0)
         return null;
+    // Detect children-only types (in CHILDREN_TYPES but NOT in ARRAY_WRAPPERS)
+    const childTypeMap = catalog.meta?.childType ?? {};
+    const childrenOnly = detectChildrenTypes(childTypeMap, wrappers);
     const runtimeDir = `${testDir}/runtime`;
     const runtimeImport = computeRelativeImport(runtimeDir, `${gatewayDir}/runtime`, importsMode);
     const wrapperTests = Object.entries(wrappers).map(([wrapperType, innerKey]) => {
@@ -583,6 +590,24 @@ export function emitUnwrapTest(testDir, gatewayDir, importsMode, catalog) {
     expect(result).toEqual([{ id: 1 }]);
   });`;
     }).join("\n\n");
+    // Generate tests for children-only types that have nested wrappers
+    const childrenTests = [];
+    for (const [typeName, children] of Object.entries(childrenOnly)) {
+        // Find children whose types are array wrappers (these get recursively unwrapped)
+        const wrappedChildren = Object.entries(children).filter(([, childType]) => childType in wrappers);
+        if (wrappedChildren.length === 0)
+            continue;
+        const [childProp, childType] = wrappedChildren[0];
+        const innerKey = wrappers[childType];
+        childrenTests.push(`  it("recursively unwraps nested wrappers in ${typeName}", () => {
+    const input = { ${childProp}: { ${innerKey}: [{ id: 1 }] } };
+    const result = unwrapArrayWrappers(input, "${typeName}");
+    expect(result).toEqual({ ${childProp}: [{ id: 1 }] });
+  });`);
+    }
+    const childrenTestBlock = childrenTests.length > 0
+        ? "\n" + childrenTests.join("\n\n") + "\n"
+        : "";
     return `/**
  * unwrapArrayWrappers() Unit Tests
  *
@@ -595,7 +620,7 @@ import { unwrapArrayWrappers } from "${runtimeImport}";
 
 describe("unwrapArrayWrappers", () => {
 ${wrapperTests}
-
+${childrenTestBlock}
   it("returns empty array when inner key is missing", () => {
     const result = unwrapArrayWrappers({}, "${Object.keys(wrappers)[0]}");
     expect(result).toEqual([]);
@@ -609,22 +634,3 @@ ${wrapperTests}
 });
 `;
 }
-/**
- * Detects ArrayOf* wrapper types from catalog (mirrors the logic in generators.ts).
- */
-function detectArrayWrappersFromCatalog(catalog) {
-    const wrappers = {};
-    const childTypes = catalog.meta?.childType ?? {};
-    const propMeta = catalog.meta?.propMeta ?? {};
-    for (const [typeName, children] of Object.entries(childTypes)) {
-        const childEntries = Object.entries(children);
-        if (childEntries.length !== 1)
-            continue;
-        const [propName] = childEntries[0];
-        const meta = propMeta[typeName]?.[propName];
-        if (meta?.max === "unbounded" || (typeof meta?.max === "number" && meta.max > 1)) {
-            wrappers[typeName] = propName;
-        }
-    }
-    return wrappers;
-}

package/dist/test/mockData.d.ts

@@ -1,12 +1,3 @@
-/**
- * Mock Data Generator
- *
- * Generates realistic mock data trees from compiled catalog type metadata.
- * Used by the test generator to create full default responses per operation
- * so that generated tests pass out of the box.
- *
- * Pure logic — no I/O or side effects.
- */
 /**
  * Options for mock data generation
  */
@@ -18,6 +9,7 @@ export interface MockDataOptions {
  */
 export interface CatalogForMocks {
     meta?: {
+        attrType?: Record<string, Record<string, string>>;
         childType?: Record<string, Record<string, string>>;
         propMeta?: Record<string, Record<string, {
             declaredType?: string;
@@ -31,6 +23,16 @@ export interface CatalogForMocks {
         inputTypeName?: string;
         outputTypeName?: string;
     }>;
+    types?: Array<{
+        name: string;
+        attrs: Array<{
+            name: string;
+        }>;
+        elems: Array<{
+            name: string;
+            max: number | "unbounded";
+        }>;
+    }>;
 }
 /**
  * Generates a mock primitive value based on the TypeScript type and property name.
@@ -52,16 +54,27 @@ export declare function generateMockPrimitive(tsType: string, propName: string):
  * @returns Mock data object matching the type structure
  */
 export declare function generateMockData(typeName: string, catalog: CatalogForMocks, opts?: MockDataOptions, visited?: Set<string>, depth?: number): Record<string, unknown>;
+/**
+ * Options for bulk mock generation
+ */
+export interface GenerateAllMocksOptions {
+    flattenArrayWrappers?: boolean;
+}
 /**
  * Generates mock request and response data for all operations in the catalog.
  *
  * Response data uses the pre-unwrap shape (e.g. { WeatherDescription: [{...}] }
  * not [{...}]) since the generated route handler calls unwrapArrayWrappers() at runtime.
  *
+ * When flattenArrayWrappers is enabled, request payloads are post-processed to
+ * flatten ArrayOf* wrapper objects into plain arrays, matching the OpenAPI schema
+ * shape that AJV validates against.
+ *
  * @param catalog - The compiled catalog with operations and type metadata
+ * @param opts - Optional generation options
  * @returns Map from operation name to { request, response } mock data
  */
-export declare function generateAllOperationMocks(catalog: CatalogForMocks): Map<string, {
+export declare function generateAllOperationMocks(catalog: CatalogForMocks, opts?: GenerateAllMocksOptions): Map<string, {
     request: Record<string, unknown>;
     response: Record<string, unknown>;
 }>;

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

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

package/dist/test/mockData.js

@@ -7,6 +7,7 @@
  *
  * Pure logic — no I/O or side effects.
  */
+import { detectArrayWrappers, flattenMockPayload } from "../util/catalogMeta.js";
 /**
  * Generates a mock primitive value based on the TypeScript type and property name.
  * Uses contextual defaults based on common property names.
@@ -33,6 +34,13 @@ export function generateMockPrimitive(tsType, propName) {
             return 1013;
         return 0;
     }
+    // String union / enum type — pick the first literal value
+    // e.g. '"Test" | "Production"' → "Test"
+    if (tsType.includes("|") && tsType.includes('"')) {
+        const match = tsType.match(/"([^"]+)"/);
+        if (match)
+            return match[1];
+    }
     // string type — use contextual defaults
     if (lower === "zip" || lower === "zipcode" || lower === "postalcode")
         return "10001";
@@ -84,14 +92,15 @@ export function generateMockData(typeName, catalog, opts, visited, depth) {
         return {};
     }
     const childTypes = catalog.meta?.childType?.[typeName];
-    if (!childTypes || Object.keys(childTypes).length === 0) {
+    const attrTypes = catalog.meta?.attrType?.[typeName];
+    if ((!childTypes || Object.keys(childTypes).length === 0) && !attrTypes) {
         return {};
     }
     const propMeta = catalog.meta?.propMeta?.[typeName] ?? {};
     const newVisited = new Set(currentVisited);
     newVisited.add(typeName);
     const result = {};
-    for (const [propName, propType] of Object.entries(childTypes)) {
+    for (const [propName, propType] of Object.entries(childTypes ?? {})) {
         const meta = propMeta[propName];
         const isArray = meta?.max === "unbounded" || (typeof meta?.max === "number" && meta.max > 1);
         // Check if it's a primitive type
@@ -105,6 +114,21 @@ export function generateMockData(typeName, catalog, opts, visited, depth) {
             result[propName] = isArray ? [childData] : childData;
         }
     }
+    // Include XML attributes (not in childType, stored separately in attrType)
+    if (attrTypes) {
+        for (const [attrName, attrTsType] of Object.entries(attrTypes)) {
+            if (!(attrName in result)) {
+                // Handle array-typed attributes (e.g. "string[]")
+                if (attrTsType.endsWith("[]")) {
+                    const baseType = attrTsType.slice(0, -2);
+                    result[attrName] = [generateMockPrimitive(baseType, attrName)];
+                }
+                else {
+                    result[attrName] = generateMockPrimitive(attrTsType, attrName);
+                }
+            }
+        }
+    }
     return result;
 }
 /**
@@ -113,17 +137,33 @@ export function generateMockData(typeName, catalog, opts, visited, depth) {
  * Response data uses the pre-unwrap shape (e.g. { WeatherDescription: [{...}] }
  * not [{...}]) since the generated route handler calls unwrapArrayWrappers() at runtime.
  *
+ * When flattenArrayWrappers is enabled, request payloads are post-processed to
+ * flatten ArrayOf* wrapper objects into plain arrays, matching the OpenAPI schema
+ * shape that AJV validates against.
+ *
  * @param catalog - The compiled catalog with operations and type metadata
+ * @param opts - Optional generation options
  * @returns Map from operation name to { request, response } mock data
  */
-export function generateAllOperationMocks(catalog) {
+export function generateAllOperationMocks(catalog, opts) {
     const result = new Map();
     if (!catalog.operations)
         return result;
+    // Detect array wrappers once for all operations
+    const arrayWrappers = opts?.flattenArrayWrappers !== false && catalog.types
+        ? detectArrayWrappers(catalog.types)
+        : {};
+    const shouldFlatten = Object.keys(arrayWrappers).length > 0;
+    const childTypeMap = catalog.meta?.childType ?? {};
     for (const op of catalog.operations) {
-        const request = op.inputTypeName
+        let request = op.inputTypeName
             ? generateMockData(op.inputTypeName, catalog)
             : {};
+        // Flatten request payloads when array wrappers are active
+        if (shouldFlatten && op.inputTypeName) {
+            request = flattenMockPayload(request, op.inputTypeName, childTypeMap, arrayWrappers);
+        }
+        // Response stays SOAP-shaped (pre-unwrap) since runtime unwrapArrayWrappers() handles it
         const response = op.outputTypeName
             ? generateMockData(op.outputTypeName, catalog)
             : {};

package/dist/util/catalogMeta.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared catalog analysis utilities.
+ *
+ * Provides canonical array-wrapper and children-type detection used by both
+ * the gateway generator (runtime.ts emission) and the test generator.
+ */
+export interface CatalogTypeDef {
+    name: string;
+    attrs: Array<{
+        name: string;
+    }>;
+    elems: Array<{
+        name: string;
+        max: number | "unbounded";
+    }>;
+}
+/**
+ * Detects ArrayOf* wrapper types: exactly 1 element with max unbounded, no attributes.
+ * Returns Record<wrapperTypeName, innerPropertyName>.
+ */
+export declare function detectArrayWrappers(types: CatalogTypeDef[]): Record<string, string>;
+/**
+ * Builds CHILDREN_TYPES map: all childType entries that are NOT array wrappers.
+ * Used by the runtime unwrapArrayWrappers() for recursive child processing.
+ */
+export declare function detectChildrenTypes(childTypeMap: Record<string, Record<string, string>>, arrayWrappers: Record<string, string>): Record<string, Record<string, string>>;
+/**
+ * Post-processes a mock request payload to flatten array-wrapper fields.
+ * Replaces { InnerProp: [...items] } with [...items] for wrapper types.
+ * Recursion follows the childType map.
+ */
+export declare function flattenMockPayload(data: Record<string, unknown>, typeName: string, childTypeMap: Record<string, Record<string, string>>, arrayWrappers: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=catalogMeta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogMeta.d.ts","sourceRoot":"","sources":["../../src/util/catalogMeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUnF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACpD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOxC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACpD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB"}

package/dist/util/catalogMeta.js

@@ -0,0 +1,95 @@
+/**
+ * Shared catalog analysis utilities.
+ *
+ * Provides canonical array-wrapper and children-type detection used by both
+ * the gateway generator (runtime.ts emission) and the test generator.
+ */
+/**
+ * Detects ArrayOf* wrapper types: exactly 1 element with max unbounded, no attributes.
+ * Returns Record<wrapperTypeName, innerPropertyName>.
+ */
+export function detectArrayWrappers(types) {
+    const wrappers = {};
+    for (const t of types) {
+        if (t.attrs && t.attrs.length !== 0)
+            continue;
+        if (!t.elems || t.elems.length !== 1)
+            continue;
+        const e = t.elems[0];
+        if (e.max !== "unbounded" && !(typeof e.max === "number" && e.max > 1))
+            continue;
+        wrappers[t.name] = e.name;
+    }
+    return wrappers;
+}
+/**
+ * Builds CHILDREN_TYPES map: all childType entries that are NOT array wrappers.
+ * Used by the runtime unwrapArrayWrappers() for recursive child processing.
+ */
+export function detectChildrenTypes(childTypeMap, arrayWrappers) {
+    const result = {};
+    for (const [typeName, children] of Object.entries(childTypeMap)) {
+        if (typeName in arrayWrappers)
+            continue;
+        result[typeName] = children;
+    }
+    return result;
+}
+/**
+ * Post-processes a mock request payload to flatten array-wrapper fields.
+ * Replaces { InnerProp: [...items] } with [...items] for wrapper types.
+ * Recursion follows the childType map.
+ */
+export function flattenMockPayload(data, typeName, childTypeMap, arrayWrappers) {
+    const children = childTypeMap[typeName];
+    if (!children)
+        return data;
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const childTypeName = children[key];
+        if (childTypeName && childTypeName in arrayWrappers && value != null && typeof value === "object" && !Array.isArray(value)) {
+            // This field's type is an array wrapper — flatten it
+            const innerKey = arrayWrappers[childTypeName];
+            const innerValue = value[innerKey];
+            // Recurse into each item of the unwrapped array
+            const itemTypeName = childTypeMap[childTypeName]?.[innerKey];
+            if (Array.isArray(innerValue) && itemTypeName) {
+                result[key] = innerValue.map(item => item != null && typeof item === "object" && !Array.isArray(item)
+                    ? flattenMockPayload(item, itemTypeName, childTypeMap, arrayWrappers)
+                    : item);
+            }
+            else {
+                result[key] = innerValue ?? [];
+            }
+        }
+        else if (childTypeName && value != null && typeof value === "object" && !Array.isArray(value)) {
+            // Recurse into complex types
+            result[key] = flattenMockPayload(value, childTypeName, childTypeMap, arrayWrappers);
+        }
+        else if (childTypeName && Array.isArray(value)) {
+            // Array of complex types — flatten each item
+            result[key] = value.map(item => {
+                if (item != null && typeof item === "object" && !Array.isArray(item)) {
+                    if (childTypeName in arrayWrappers) {
+                        const innerKey = arrayWrappers[childTypeName];
+                        const innerValue = item[innerKey];
+                        // Recurse into each item of the unwrapped array
+                        const itemTypeName = childTypeMap[childTypeName]?.[innerKey];
+                        if (Array.isArray(innerValue) && itemTypeName) {
+                            return innerValue.map(subItem => subItem != null && typeof subItem === "object" && !Array.isArray(subItem)
+                                ? flattenMockPayload(subItem, itemTypeName, childTypeMap, arrayWrappers)
+                                : subItem);
+                        }
+                        return innerValue ?? [];
+                    }
+                    return flattenMockPayload(item, childTypeName, childTypeMap, arrayWrappers);
+                }
+                return item;
+            });
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techspokes/typescript-wsdl-client",
-  "version": "0.11.3",
+  "version": "0.11.6",
   "description": "Generate type-safe TypeScript SOAP clients, OpenAPI 3.1 specs, and production-ready Fastify REST gateways from WSDL/XSD definitions.",
   "keywords": [
     "wsdl",