@techspokes/typescript-wsdl-client 0.10.2 → 0.11.0

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

@@ -390,12 +390,16 @@ export function resolveClientMeta(opts, catalog) {
     const pluginImportPath = opts.clientDir
         ? `../client/client${suffix}`
         : `./client/client${suffix}`;
+    const operationsImportPath = opts.clientDir
+        ? `../client/operations${suffix}`
+        : `./client/operations${suffix}`;
     return {
         className,
         decoratorName,
         importPath,
         typesImportPath,
         pluginImportPath,
+        operationsImportPath,
     };
 }
 /**

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;AAUjD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,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,CAsDf"}
+{"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,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,CAwDf"}

package/dist/index.js

@@ -20,6 +20,7 @@ import { generateTypes } from "./client/generateTypes.js";
 import { generateUtils } from "./client/generateUtils.js";
 import { generateCatalog } from "./compiler/generateCatalog.js";
 import { generateClient } from "./client/generateClient.js";
+import { generateOperations } from "./client/generateOperations.js";
 import { info } from "./util/cli.js";
 export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 export { generateGateway } from "./gateway/generateGateway.js";
@@ -76,6 +77,7 @@ export async function compileWsdlToProject(input) {
     // Emit artifacts
     const typesFile = path.join(input.outDir, "types.ts");
     const utilsFile = path.join(input.outDir, "utils.ts");
+    const operationsFile = path.join(input.outDir, "operations.ts");
     const catalogFile = path.join(input.outDir, "catalog.json");
     const clientFile = path.join(input.outDir, "client.ts");
     // Prepare output dir
@@ -89,6 +91,7 @@ export async function compileWsdlToProject(input) {
     generateClient(clientFile, compiled);
     generateTypes(typesFile, compiled);
     generateUtils(utilsFile, compiled);
+    generateOperations(operationsFile, compiled);
     if (compiled.options.catalog) {
         generateCatalog(catalogFile, compiled);
     }

package/dist/loader/wsdlLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wsdlLoader.d.ts","sourceRoot":"","sources":["../../src/loader/wsdlLoader.ts"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAKF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoC1E"}
+{"version":3,"file":"wsdlLoader.d.ts","sourceRoot":"","sources":["../../src/loader/wsdlLoader.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC;IACb,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAKF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsE1E"}

package/dist/loader/wsdlLoader.js

@@ -14,6 +14,7 @@ import { XMLParser } from "fast-xml-parser";
 import { fetchText } from "./fetch.js";
 import path from "node:path";
 import { getChildrenWithLocalName } from "../util/tools.js";
+import { WsdlCompilationError } from "../util/errors.js";
 // Configure XML parser to preserve attributes with @_ prefix
 const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_" });
 /**
@@ -32,12 +33,37 @@ const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_
  */
 export async function loadWsdl(wsdlUrlOrPath) {
     // Fetch and parse the WSDL document
-    const { uri: wsdlUri, text } = await fetchText(wsdlUrlOrPath);
-    const wsdlXml = parser.parse(text);
+    let wsdlUri;
+    let text;
+    try {
+        const fetched = await fetchText(wsdlUrlOrPath);
+        wsdlUri = fetched.uri;
+        text = fetched.text;
+    }
+    catch (err) {
+        throw new WsdlCompilationError(`Failed to load WSDL document: ${err instanceof Error ? err.message : String(err)}`, {
+            file: wsdlUrlOrPath,
+            suggestion: "Verify the file path or URL is correct and accessible.",
+        });
+    }
+    let wsdlXml;
+    try {
+        wsdlXml = parser.parse(text);
+    }
+    catch (err) {
+        throw new WsdlCompilationError(`Failed to parse WSDL/XSD document as XML: ${err instanceof Error ? err.message : String(err)}`, {
+            file: wsdlUrlOrPath,
+            suggestion: "Validate the XML with an external tool (e.g., xmllint) and fix any syntax errors.",
+        });
+    }
     // Extract the WSDL definitions node (with or without namespace prefix)
     const defs = wsdlXml["wsdl:definitions"] || wsdlXml["definitions"];
-    if (!defs)
-        throw new Error("Not a WSDL 1.1 file: missing wsdl:definitions");
+    if (!defs) {
+        throw new WsdlCompilationError("Not a WSDL 1.1 file: missing <wsdl:definitions> root element.", {
+            file: wsdlUrlOrPath,
+            suggestion: "Ensure the file is a valid WSDL 1.1 document with a <definitions> root element.",
+        });
+    }
     // Extract namespace prefixes declared at the WSDL level
     const prefixMap = {};
     for (const [k, v] of Object.entries(defs)) {

package/dist/openapi/generateOpenAPI.d.ts

@@ -76,6 +76,7 @@ export interface GenerateOpenAPIOptions {
     skipValidate?: boolean;
     envelopeNamespace?: string;
     errorNamespace?: string;
+    flattenArrayWrappers?: boolean;
 }
 export declare function generateOpenAPI(opts: GenerateOpenAPIOptions): Promise<{
     doc: any;

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

package/dist/openapi/generateOpenAPI.js

@@ -80,6 +80,7 @@ export async function generateOpenAPI(opts) {
     const schemas = generateSchemas(compiled, {
         closedSchemas: opts.closedSchemas,
         pruneUnusedSchemas: opts.pruneUnusedSchemas,
+        flattenArrayWrappers: opts.flattenArrayWrappers,
     });
     // Build paths
     const tagStyle = opts.tagStyle || "default";

package/dist/openapi/generateSchemas.d.ts

@@ -24,6 +24,7 @@ import type { CompiledCatalog } from "../compiler/schemaCompiler.js";
 export interface GenerateSchemasOptions {
     closedSchemas?: boolean;
     pruneUnusedSchemas?: boolean;
+    flattenArrayWrappers?: boolean;
 }
 export type ComponentsSchemas = Record<string, any>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"generateSchemas.d.ts","sourceRoot":"","sources":["../../src/openapi/generateSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAgB,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAwIpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CA8C1G"}
+{"version":3,"file":"generateSchemas.d.ts","sourceRoot":"","sources":["../../src/openapi/generateSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAgB,eAAe,EAAe,MAAM,+BAA+B,CAAC;AAEhG;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAwIpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CA+C1G"}

package/dist/openapi/generateSchemas.js

@@ -47,7 +47,7 @@ function isArrayWrapper(t) {
         return null;
     return { itemType: e.tsType };
 }
-function buildComplexSchema(t, closed, knownTypeNames, aliasNames) {
+function buildComplexSchema(t, closed, knownTypeNames, aliasNames, flattenWrappers) {
     // Use knownTypeNames/aliasNames to validate $ref targets so we surface
     // compiler issues early instead of emitting dangling references in OpenAPI output.
     function refOrPrimitive(ts) {
@@ -77,7 +77,7 @@ function buildComplexSchema(t, closed, knownTypeNames, aliasNames) {
                 return { $ref: `#/components/schemas/${ts}` };
         }
     }
-    const arrayWrap = isArrayWrapper(t);
+    const arrayWrap = flattenWrappers ? isArrayWrapper(t) : null;
     if (arrayWrap) {
         const item = refOrPrimitive(String(arrayWrap.itemType));
         return { type: "array", items: item };
@@ -148,6 +148,7 @@ function buildComplexSchema(t, closed, knownTypeNames, aliasNames) {
  */
 export function generateSchemas(compiled, opts) {
     const closed = !!opts.closedSchemas;
+    const flattenWrappers = opts.flattenArrayWrappers !== false; // default true
     const schemas = {};
     const typeNames = new Set(compiled.types.map(t => t.name));
     const aliasNames = new Set(compiled.aliases.map(a => a.name));
@@ -156,7 +157,7 @@ export function generateSchemas(compiled, opts) {
         schemas[a.name] = buildAliasSchema(a);
     }
     for (const t of compiled.types) {
-        schemas[t.name] = buildComplexSchema(t, closed, typeNames, aliasNames);
+        schemas[t.name] = buildComplexSchema(t, closed, typeNames, aliasNames, flattenWrappers);
     }
     if (opts.pruneUnusedSchemas) {
         // Root references: each operation's inputElement.local, outputElement.local

package/dist/pipeline.d.ts

@@ -35,6 +35,10 @@ export interface PipelineOptions {
     app?: {
         appDir: string;
         openapiMode?: "copy" | "reference";
+        force?: boolean;
+        host?: string;
+        port?: number;
+        prefix?: string;
     };
 }
 /**

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAgBA,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;KACpC,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,CAmHhH"}
+{"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;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,CA4HhH"}

package/dist/pipeline.js

@@ -13,6 +13,7 @@ import { compileCatalog } from "./compiler/schemaCompiler.js";
 import { generateClient } from "./client/generateClient.js";
 import { generateTypes } from "./client/generateTypes.js";
 import { generateUtils } from "./client/generateUtils.js";
+import { generateOperations } from "./client/generateOperations.js";
 import { generateCatalog } from "./compiler/generateCatalog.js";
 import { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 import { generateGateway } from "./gateway/generateGateway.js";
@@ -63,7 +64,7 @@ export async function runGenerationPipeline(opts) {
     success(`Compiled catalog written to ${opts.catalogOut}`);
     // Step 4: Optionally generate TypeScript client artifacts
     if (opts.clientOutDir) {
-        emitClientArtifacts(opts.clientOutDir, compiled, generateClient, generateTypes, generateUtils);
+        emitClientArtifacts(opts.clientOutDir, compiled, generateClient, generateTypes, generateUtils, generateOperations);
     }
     // Step 4: Optionally generate OpenAPI specification
     let openapiDoc;
@@ -99,6 +100,10 @@ export async function runGenerationPipeline(opts) {
             clientDir: opts.clientOutDir ? path.resolve(opts.clientOutDir) : undefined,
             // Reuse the same imports mode as the TypeScript client/types/utils emitters
             imports: finalCompiler.imports,
+            // Pass catalog for runtime unwrap generation
+            catalogFile: path.resolve(opts.catalogOut),
+            // Thread flatten flag from OpenAPI options
+            flattenArrayWrappers: opts.openapi?.flattenArrayWrappers,
         });
         success(`Gateway code generated in ${gatewayOutDir}`);
     }
@@ -117,6 +122,10 @@ export async function runGenerationPipeline(opts) {
             appDir: path.resolve(opts.app.appDir),
             imports: finalCompiler.imports,
             openapiMode: opts.app.openapiMode || "copy",
+            force: opts.app.force,
+            host: opts.app.host,
+            port: opts.app.port,
+            prefix: opts.app.prefix,
         });
     }
     // Return the compiled catalog and OpenAPI doc for potential further processing

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

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/util/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,+BAA+B,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAgBhF;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAC5C,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAC,CAoBtF"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/util/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,+BAA+B,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAgBhF;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAC5C,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAAC,CAqBtF"}

package/dist/util/builder.js

@@ -47,6 +47,7 @@ export function buildOpenApiOptionsFromArgv(argv, format, servers) {
         tagsFile: argv["openapi-tags-file"],
         title: argv["openapi-title"],
         version: argv["openapi-version-tag"],
+        flattenArrayWrappers: argv["openapi-flatten-array-wrappers"],
         asYaml: format === "yaml",
     };
 }

package/dist/util/cli.d.ts

@@ -81,7 +81,7 @@ export declare function reportCompilationStats(wsdlCatalog: {
     operations: any[];
 }): void;
 /**
- * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts)
+ * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts, operations.ts)
  *
  * Note: catalog.json is NOT emitted by this function - it should be handled
  * separately by the caller using generateCatalog() with explicit --catalog-file path.
@@ -91,8 +91,9 @@ export declare function reportCompilationStats(wsdlCatalog: {
  * @param generateClient - Client generator function
  * @param generateTypes - Types generator function
  * @param generateUtils - Utils generator function
+ * @param generateOperations - Operations interface generator function
  */
-export declare function emitClientArtifacts(outDir: string, compiled: any, generateClient: (path: string, compiled: any) => void, generateTypes: (path: string, compiled: any) => void, generateUtils: (path: string, compiled: any) => void): void;
+export declare function emitClientArtifacts(outDir: string, compiled: any, generateClient: (path: string, compiled: any) => void, generateTypes: (path: string, compiled: any) => void, generateUtils: (path: string, compiled: any) => void, generateOperations?: (path: string, compiled: any) => void): void;
 /**
  * Validate gateway generation requirements
  *

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/util/cli.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK,CAI7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE;IAAE,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,EAC/B,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,EAAE,CAAA;CAAE,GAC5C,IAAI,CAIN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACrD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,GACnD,IAAI,CASN;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,IAAI,CAUN"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/util/cli.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAc1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAMhE;AAED;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CASP;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE;IAAE,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,EAC/B,QAAQ,EAAE;IAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,EAAE,GAAG,EAAE,CAAA;CAAE,GAC5C,IAAI,CAIN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,EACb,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACrD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,EACpD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,GACzD,IAAI,CAWN;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,IAAI,CAUN"}

package/dist/util/cli.js

@@ -7,6 +7,7 @@
  */
 import path from "node:path";
 import fs from "node:fs";
+import { WsdlCompilationError } from "./errors.js";
 /**
  * Parse comma-separated status codes from CLI argument
  *
@@ -94,8 +95,13 @@ export function info(message) {
  * @param exitCode - Process exit code (default: 1)
  */
 export function handleCLIError(errorObj, exitCode = 1) {
-    const message = errorObj instanceof Error ? errorObj.message : String(errorObj);
-    error(message);
+    if (errorObj instanceof WsdlCompilationError) {
+        error(errorObj.toUserMessage());
+    }
+    else {
+        const message = errorObj instanceof Error ? errorObj.message : String(errorObj);
+        error(message);
+    }
     process.exit(exitCode);
 }
 /**
@@ -125,7 +131,7 @@ export function reportCompilationStats(wsdlCatalog, compiled) {
     info(`Operations: ${compiled.operations.length}`);
 }
 /**
- * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts)
+ * Emit TypeScript client artifacts (client.ts, types.ts, utils.ts, operations.ts)
  *
  * Note: catalog.json is NOT emitted by this function - it should be handled
  * separately by the caller using generateCatalog() with explicit --catalog-file path.
@@ -135,12 +141,16 @@ export function reportCompilationStats(wsdlCatalog, compiled) {
  * @param generateClient - Client generator function
  * @param generateTypes - Types generator function
  * @param generateUtils - Utils generator function
+ * @param generateOperations - Operations interface generator function
  */
-export function emitClientArtifacts(outDir, compiled, generateClient, generateTypes, generateUtils) {
+export function emitClientArtifacts(outDir, compiled, generateClient, generateTypes, generateUtils, generateOperations) {
     fs.mkdirSync(outDir, { recursive: true });
     generateClient(path.join(outDir, "client.ts"), compiled);
     generateTypes(path.join(outDir, "types.ts"), compiled);
     generateUtils(path.join(outDir, "utils.ts"), compiled);
+    if (generateOperations) {
+        generateOperations(path.join(outDir, "operations.ts"), compiled);
+    }
     success(`Generated TypeScript client in ${outDir}`);
 }
 /**

package/dist/util/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Structured error types for WSDL compilation
+ *
+ * Provides context-rich error messages with element names, namespaces,
+ * and actionable suggestions for common issues.
+ */
+/**
+ * Context information attached to WSDL compilation errors
+ */
+export interface WsdlErrorContext {
+    /** Element or type name that triggered the error */
+    element?: string;
+    /** XML namespace where the error occurred */
+    namespace?: string;
+    /** File or URI of the source document */
+    file?: string;
+    /** Referenced-by context (e.g., "element 'bar' in type 'Baz'") */
+    referencedBy?: string;
+    /** Actionable suggestion for resolving the error */
+    suggestion?: string;
+}
+/**
+ * Structured error for WSDL/XSD compilation failures.
+ *
+ * Extends Error with context fields for element, namespace, file, and suggestion.
+ * The CLI error handler formats these into multi-line user-friendly messages.
+ */
+export declare class WsdlCompilationError extends Error {
+    readonly context: WsdlErrorContext;
+    readonly name = "WsdlCompilationError";
+    constructor(message: string, context?: WsdlErrorContext);
+    /**
+     * Formats the error into a user-friendly multi-line message.
+     */
+    toUserMessage(): string;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAK3B,OAAO,EAAE,gBAAgB;IAJ3C,SAAkB,IAAI,0BAA0B;gBAG9C,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,gBAAqB;IAKhD;;OAEG;IACH,aAAa,IAAI,MAAM;CASxB"}

package/dist/util/errors.js

@@ -0,0 +1,37 @@
+/**
+ * Structured error types for WSDL compilation
+ *
+ * Provides context-rich error messages with element names, namespaces,
+ * and actionable suggestions for common issues.
+ */
+/**
+ * Structured error for WSDL/XSD compilation failures.
+ *
+ * Extends Error with context fields for element, namespace, file, and suggestion.
+ * The CLI error handler formats these into multi-line user-friendly messages.
+ */
+export class WsdlCompilationError extends Error {
+    context;
+    name = "WsdlCompilationError";
+    constructor(message, context = {}) {
+        super(message);
+        this.context = context;
+    }
+    /**
+     * Formats the error into a user-friendly multi-line message.
+     */
+    toUserMessage() {
+        const parts = [this.message];
+        if (this.context.element)
+            parts.push(`  Element: ${this.context.element}`);
+        if (this.context.namespace)
+            parts.push(`  Namespace: ${this.context.namespace}`);
+        if (this.context.referencedBy)
+            parts.push(`  Referenced by: ${this.context.referencedBy}`);
+        if (this.context.file)
+            parts.push(`  File: ${this.context.file}`);
+        if (this.context.suggestion)
+            parts.push(`  Suggestion: ${this.context.suggestion}`);
+        return parts.join("\n");
+    }
+}

package/docs/README.md

@@ -13,6 +13,7 @@ Human-maintained reference documents for `@techspokes/typescript-wsdl-client`. T
 - [generated-code.md](generated-code.md) – Using clients and types
 - [migration.md](migration.md) – Upgrade paths between versions
 - [production.md](production.md) – CI/CD, validation, logging, limitations
+- [testing.md](testing.md) – Testing patterns and mock client examples
 - [troubleshooting.md](troubleshooting.md) – Common issues and debugging
 
 ## Conventions

package/docs/architecture.md

@@ -54,7 +54,7 @@ generateGateway.ts orchestrates all gateway file generation. generators.ts conta
 
 ### app/
 
-generateApp.ts generates server.js, config.js, and .env.example.
+generateApp.ts scaffolds server.ts, config.ts, package.json, tsconfig.json, .env.example, and README.md.
 
 ### Top-level Modules
 

package/docs/cli-reference.md

@@ -54,7 +54,6 @@ The catalog is auto-placed alongside the first available output directory: `{cli
 | `--client-dir` | Generate TypeScript client in this directory |
 | `--openapi-file` | Generate OpenAPI spec at this path |
 | `--gateway-dir` | Generate Fastify gateway in this directory |
-| `--generate-app` | Generate runnable app (requires gateway) |
 
 ### Client Flags
 
@@ -79,12 +78,16 @@ The catalog is auto-placed alongside the first available output directory: `{cli
 | `--openapi-title` | (derived) | API title |
 | `--openapi-version` | `0.0.0` | API version |
 | `--openapi-description` | (empty) | API description |
-| `--openapi-servers` | `/` | Comma-separated server URLs |
+| `--openapi-servers` | `/` | Comma-separated server URLs (see note below) |
+
+> When `--init-app` is used and `--openapi-servers` is not provided, servers default to `http://localhost:3000`. The app scaffold also rewrites the servers array in its local `openapi.json` copy to match the configured port and prefix.
+
 | `--openapi-base-path` | (empty) | Base path prefix |
 | `--openapi-path-style` | `kebab` | Path transform: kebab, asis, or lower |
 | `--openapi-method` | `post` | Default HTTP method |
 | `--openapi-tag-style` | `default` | Tag inference: default, service, or first |
 | `--openapi-closed-schemas` | `false` | Add additionalProperties: false |
+| `--openapi-flatten-array-wrappers` | `true` | Flatten ArrayOf* wrappers to plain arrays; emit runtime unwrap in gateway |
 | `--openapi-prune-unused-schemas` | `false` | Emit only referenced schemas |
 | `--openapi-envelope-namespace` | `ResponseEnvelope` | Envelope component name suffix |
 | `--openapi-error-namespace` | `ErrorObject` | Error object name suffix |
@@ -105,6 +108,19 @@ The catalog is auto-placed alongside the first available output directory: `{cli
 | `--gateway-decorator-name` | {serviceSlug}Client | Fastify decorator name |
 | `--gateway-skip-plugin` | `false` | Skip plugin.ts generation |
 | `--gateway-skip-runtime` | `false` | Skip runtime.ts generation |
+| `--openapi-flatten-array-wrappers` | `true` | Generate runtime unwrap for ArrayOf* wrapper types |
+
+### App Scaffold Flags
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--init-app` | `false` | Scaffold runnable Fastify app (requires client, gateway, OpenAPI) |
+| `--force-init` | `false` | Overwrite existing scaffold files |
+| `--app-dir` | sibling `app/` | Output directory for app scaffold |
+| `--app-openapi-mode` | `copy` | How to handle OpenAPI file: copy or reference |
+| `--app-host` | `127.0.0.1` | Default server host |
+| `--app-port` | `3000` | Default server port |
+| `--app-prefix` | (empty) | Route prefix |
 
 ### Pipeline Workflow
 
@@ -116,7 +132,7 @@ Steps execute in order:
 4. Generate client (if --client-dir)
 5. Generate OpenAPI (if --openapi-file)
 6. Generate gateway (if --gateway-dir)
-7. Generate app (if --generate-app)
+7. Scaffold app (if --init-app)
 
 All steps share the same parsed WSDL and compiled catalog.
 
@@ -134,17 +150,17 @@ npx wsdl-tsc pipeline \
   --gateway-version-prefix v1
 ```
 
-With app generation:
+With app scaffold:
 
 ```bash
 npx wsdl-tsc pipeline \
-  --wsdl-source examples/minimal/weather.wsdl \
-  --client-dir tmp/client \
-  --openapi-file tmp/openapi.json \
-  --gateway-dir tmp/gateway \
+  --wsdl-source https://example.com/weather?wsdl \
+  --client-dir ./generated/client \
+  --openapi-file ./generated/openapi.json \
+  --gateway-dir ./generated/gateway \
   --gateway-service-name weather \
   --gateway-version-prefix v1 \
-  --generate-app
+  --init-app
 ```
 
 Client and OpenAPI only:
@@ -371,7 +387,9 @@ npx wsdl-tsc gateway \
 
 ## app
 
-Generate a runnable Fastify application integrating client, gateway, and OpenAPI spec.
+Scaffold a runnable Fastify application integrating client, gateway, and OpenAPI spec. The generated app is TypeScript and includes `package.json` and `tsconfig.json` for immediate use.
+
+Scaffold files that already exist are skipped by default. Use `--force` to overwrite.
 
 ### Usage
 
@@ -404,13 +422,16 @@ npx wsdl-tsc app \
 | `--prefix` | (empty) | Route prefix |
 | `--logger` | true | Enable Fastify logger |
 | `--openapi-mode` | copy | copy or reference |
+| `--force` | false | Overwrite existing scaffold files |
 
 ### Generated Structure
 
 ```text
 app/
-├── server.js        # Main entry point
-├── config.js        # Configuration with env support
+├── server.ts        # Main entry point (TypeScript)
+├── config.ts        # Configuration with env support
+├── package.json     # Dependencies (fastify, soap, tsx)
+├── tsconfig.json    # NodeNext/ES2022 configuration
 ├── .env.example     # Environment template
 ├── README.md        # Usage instructions
 └── openapi.json     # OpenAPI spec (when --openapi-mode=copy)
@@ -420,11 +441,12 @@ app/
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `WSDL_SOURCE` | From catalog or required | WSDL URL or path |
+| `WSDL_SOURCE` | URL fallback or required | WSDL URL or path |
 | `HOST` | 127.0.0.1 | Server bind address |
 | `PORT` | 3000 | Server listen port |
 | `PREFIX` | (empty) | Route prefix |
 | `LOGGER` | true | Fastify logger |
+| `OPENAPI_SERVER_URL` | (empty) | Override OpenAPI spec server URL at runtime |
 
 ### Endpoints
 
@@ -432,7 +454,17 @@ app/
 - `GET /openapi.json` returns the OpenAPI specification
 - All SOAP operations are exposed as REST endpoints
 
-The app can also be generated via pipeline with `--generate-app`.
+### Quick Start
+
+```bash
+cd app/
+npm install
+cp .env.example .env
+# Edit .env — set WSDL_SOURCE to your WSDL URL
+npm start
+```
+
+The app can also be scaffolded via pipeline with `--init-app`.
 
 ## compile
 

package/docs/concepts.md

@@ -163,7 +163,8 @@ interface MyType {
 ## Array Wrapper Flattening
 
 A complex type whose only child is a single repeated element with no attributes
-collapses to an array schema in OpenAPI.
+collapses to an array schema in OpenAPI. Controlled by
+`--openapi-flatten-array-wrappers` (default `true`).
 
 ```xml
 <xs:complexType name="ArrayOfForecast">
@@ -173,7 +174,7 @@ collapses to an array schema in OpenAPI.
 </xs:complexType>
 ```
 
-The resulting OpenAPI schema:
+With flattening enabled (default), the OpenAPI schema becomes a plain array:
 
 ```json
 {
@@ -184,6 +185,32 @@ The resulting OpenAPI schema:
 }
 ```
 
+The TypeScript types preserve the wrapper structure:
+
+```typescript
+export interface ArrayOfForecast {
+  Forecast?: Forecast[];
+}
+```
+
+### Runtime Unwrap
+
+Because the SOAP client returns wrapper-shaped objects (`{ Forecast: [...] }`)
+while the OpenAPI schema expects flat arrays, the generated gateway includes an
+`unwrapArrayWrappers()` function in `runtime.ts`. Route handlers call it
+automatically before serialization. This bridges the TS-type/schema gap without
+requiring consumers to transform responses manually.
+
+### Disabling Flattening
+
+Pass `--openapi-flatten-array-wrappers false` to preserve the wrapper object
+structure in OpenAPI schemas. When disabled:
+
+- ArrayOf* types emit as `type: "object"` with their inner element as a property
+- No `unwrapArrayWrappers()` function is generated in `runtime.ts`
+- Route handlers pass SOAP responses through unmodified
+- The OpenAPI schema matches the TypeScript types exactly
+
 ## Inheritance Flattening
 
 Three XSD inheritance patterns are supported.