@techspokes/typescript-wsdl-client 0.7.14 → 0.8.14

package/dist/index.js

@@ -13,14 +13,16 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS } from "./config.js";
+import { resolveCompilerOptions } from "./config.js";
 import { loadWsdl } from "./loader/wsdlLoader.js";
 import { compileCatalog } from "./compiler/schemaCompiler.js";
-import { emitTypes } from "./emit/typesEmitter.js";
-import { emitUtils } from "./emit/utilsEmitter.js";
-import { emitCatalog } from "./emit/catalogEmitter.js";
-import { emitClient } from "./emit/clientEmitter.js";
+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 { info } from "./util/cli.js";
 export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
+export { generateGateway } from "./gateway/generateGateway.js";
 export { runGenerationPipeline } from "./pipeline.js";
 // noinspection JSUnusedGlobalSymbols
 /**
@@ -45,33 +47,31 @@ export { runGenerationPipeline } from "./pipeline.js";
  */
 export async function compileWsdlToProject(input) {
     // Merge defaults with overrides, always set wsdl+out
-    const finalOptions = {
-        ...TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS,
-        ...(input.options || {}),
+    const finalOptions = resolveCompilerOptions(input.options || {}, {
         wsdl: input.wsdl,
         out: input.outDir,
-    };
+    });
     // Load & compile
     const wsdlCatalog = await loadWsdl(input.wsdl);
-    console.log(`Loaded WSDL: ${wsdlCatalog.wsdlUri}`);
+    info(`Loaded WSDL: ${wsdlCatalog.wsdlUri}`);
     if (wsdlCatalog.schemas.length === 0) {
         throw new Error(`No schemas found in WSDL: ${input.wsdl}`);
     }
-    console.log(`Schemas discovered: ${wsdlCatalog.schemas.length}`);
+    info(`Schemas discovered: ${wsdlCatalog.schemas.length}`);
     const compiled = compileCatalog(wsdlCatalog, finalOptions);
-    console.log(`Compiled WSDL: ${wsdlCatalog.wsdlUri}`);
+    info(`Compiled WSDL: ${wsdlCatalog.wsdlUri}`);
     // check if we have any types and operations
     if (compiled.types.length === 0) {
         throw new Error(`No types compiled from WSDL: ${input.wsdl}`);
     }
     else {
-        console.log(`Types discovered: ${compiled.types.length}`);
+        info(`Types discovered: ${compiled.types.length}`);
     }
     if (compiled.operations.length === 0) {
         throw new Error(`No operations compiled from WSDL: ${input.wsdl}`);
     }
     else {
-        console.log(`Operations discovered: ${compiled.operations.length}`);
+        info(`Operations discovered: ${compiled.operations.length}`);
     }
     // Emit artifacts
     const typesFile = path.join(input.outDir, "types.ts");
@@ -86,10 +86,10 @@ export async function compileWsdlToProject(input) {
         throw new Error(`Failed to create output directory '${input.outDir}': ${e instanceof Error ? e.message : String(e)}`);
     }
     // Emit files
-    emitClient(clientFile, compiled);
-    emitTypes(typesFile, compiled);
-    emitUtils(utilsFile, compiled);
+    generateClient(clientFile, compiled);
+    generateTypes(typesFile, compiled);
+    generateUtils(utilsFile, compiled);
     if (compiled.options.catalog) {
-        emitCatalog(catalogFile, compiled);
+        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":"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,CAqC1E"}
+{"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"}

package/dist/loader/wsdlLoader.js

@@ -13,8 +13,7 @@
 import { XMLParser } from "fast-xml-parser";
 import { fetchText } from "./fetch.js";
 import path from "node:path";
-// noinspection ES6UnusedImports
-import { getChildrenWithLocalName, normalizeArray } from "../util/tools.js";
+import { getChildrenWithLocalName } from "../util/tools.js";
 // Configure XML parser to preserve attributes with @_ prefix
 const parser = new XMLParser({ ignoreAttributes: false, attributeNamePrefix: "@_" });
 /**
@@ -61,7 +60,6 @@ export async function loadWsdl(wsdlUrlOrPath) {
             schemas.push(...discovered);
         }
     }
-    console.log(`[wsdl] types->schemas: ${schemas.length}`);
     return { wsdlUri, wsdlXml, schemas, prefixMap: { ...prefixMap, tns } };
 }
 /**

package/dist/openapi/generateOpenAPI.d.ts

@@ -1,3 +1,27 @@
+/**
+ * OpenAPI 3.1 Generator from WSDL
+ *
+ * Generates OpenAPI 3.1 specs from WSDL documents or compiled catalogs.
+ * Converts SOAP web services into REST-style APIs by producing an OpenAPI
+ * definition aligned with the TypeScript model from the WSDL client generator.
+ *
+ * Core features:
+ * - Supports multiple input types: WSDL URL, file path, compiled catalog, or in-memory catalog
+ * - Emits deterministic schemas and paths matching generated TypeScript output
+ * - Integrates security schemes and header parameters from `security.json`
+ * - Uses tagging heuristics with optional tag and operation override files
+ * - Outputs in JSON, YAML, or both, with optional schema validation
+ * - Includes a Standard Response Envelope (since 0.7.1)
+ *   - Automatically wraps responses in a base envelope plus per-payload extensions
+ *   - Provides consistent top-level fields: `status`, `message`, `data`, `error`
+ *   - Customizable via `--envelope-namespace` and `--error-namespace`
+ *
+ * Naming rules:
+ * - Namespace flags are used verbatim for component names
+ * - Defaults: `${serviceName}ResponseEnvelope` and `${serviceName}ErrorObject`
+ * - Each operation output defines `<PayloadType|OpName><EnvelopeNamespace>` extension schemas
+ * - All schemas, paths, methods, security schemes, and parameters are alphabetically sorted for easy diffs
+ */
 import { type CompiledCatalog } from "../compiler/schemaCompiler.js";
 import type { PathStyle } from "./casing.js";
 /**
@@ -23,7 +47,7 @@ import type { PathStyle } from "./casing.js";
  * @property {boolean} [asYaml] - Force YAML output regardless of extension (deprecated)
  * @property {boolean} [validate] - Whether to validate using swagger-parser
  * @property {"default"|"first"|"service"} [tagStyle] - Heuristic for deriving tags
- * @property {"json"|"yaml"|"both"} [format] - Output format (default: json)
+ * @property {"json"|"yaml"|"both"} [format] - Output format (default: JSON)
  * @property {boolean} [skipValidate] - Skip validation (default: false)
  * @property {string} [envelopeNamespace] - Namespace segment for envelope (default ResponseEnvelope)
  * @property {string} [errorNamespace] - Namespace segment for error object (default ErrorObject)

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

@@ -1 +1 @@
-{"version":3,"file":"generateOpenAPI.d.ts","sourceRoot":"","sources":["../../src/openapi/generateOpenAPI.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAiB,KAAK,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAInF,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;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"}

package/dist/openapi/generateOpenAPI.js

@@ -1,40 +1,41 @@
 /**
  * OpenAPI 3.1 Generator from WSDL
  *
- * This module generates OpenAPI 3.1 specifications from WSDL documents or compiled catalogs.
- * It bridges the gap between SOAP web services and REST APIs by creating an OpenAPI
- * representation that mirrors the TypeScript model generated by the WSDL client generator.
+ * Generates OpenAPI 3.1 specs from WSDL documents or compiled catalogs.
+ * Converts SOAP web services into REST-style APIs by producing an OpenAPI
+ * definition aligned with the TypeScript model from the WSDL client generator.
  *
- * Core capabilities:
- * - Multiple input sources (WSDL URL/path, pre-compiled catalog, or in-memory catalog)
- * - Deterministic schema + path emission mirroring generated TypeScript
- * - Security scheme + header parameter integration (via security.json)
- * - Operation tagging heuristics + explicit tag + op override files
- * - Multi-format output (json|yaml|both) with optional validation
- * - Always-on Standard Response Envelope (since 0.7.1): automatically wraps all
- *   responses in a base envelope plus per-payload extensions, providing stable
- *   top-level fields (status, message, data, error). Naming is customizable via
- *   --envelope-namespace / --error-namespace.
+ * Core features:
+ * - Supports multiple input types: WSDL URL, file path, compiled catalog, or in-memory catalog
+ * - Emits deterministic schemas and paths matching generated TypeScript output
+ * - Integrates security schemes and header parameters from `security.json`
+ * - Uses tagging heuristics with optional tag and operation override files
+ * - Outputs in JSON, YAML, or both, with optional schema validation
+ * - Includes a Standard Response Envelope (since 0.7.1)
+ *   - Automatically wraps responses in a base envelope plus per-payload extensions
+ *   - Provides consistent top-level fields: `status`, `message`, `data`, `error`
+ *   - Customizable via `--envelope-namespace` and `--error-namespace`
  *
- * Naming Rules:
- *   - If a namespace flag is provided its value is used verbatim as the component name.
- *   - Otherwise `${serviceName}ResponseEnvelope` / `${serviceName}ErrorObject` are used.
- *   - Each operation output produces an extension schema named `<PayloadType|OpName><EnvelopeNamespace>`.
- *   - All schemas, paths, methods, securitySchemes, and parameters are alphabetically sorted for diff friendliness.
+ * Naming rules:
+ * - Namespace flags are used verbatim for component names
+ * - Defaults: `${serviceName}ResponseEnvelope` and `${serviceName}ErrorObject`
+ * - Each operation output defines `<PayloadType|OpName><EnvelopeNamespace>` extension schemas
+ * - All schemas, paths, methods, security schemes, and parameters are alphabetically sorted for easy diffs
  */
 import * as fs from "fs";
 import * as path from "path";
 import * as yaml from "js-yaml";
 import { loadWsdl } from "../loader/wsdlLoader.js";
 import { compileCatalog } from "../compiler/schemaCompiler.js";
-import { buildSchemas } from "./buildSchemas.js";
-import { buildPaths } from "./buildPaths.js";
+import { generateSchemas } from "./generateSchemas.js";
+import { generatePaths } from "./generatePaths.js";
+import { error, info, warn } from "../util/cli.js";
 import { buildSecurity, loadSecurityConfig } from "./security.js";
 export async function generateOpenAPI(opts) {
     // Normalize format (back-compat: asYaml overrides if provided and format not set)
     let format = opts.format || (opts.asYaml ? "yaml" : "json");
     if (format === "yaml" && opts.asYaml && opts.outFile && /\.json$/i.test(opts.outFile)) {
-        // user asked for yaml but provided .json path → we'll still switch extension
+        // user asked for YAML but provided .json path → we'll still switch extension
     }
     if (!opts.compiledCatalog && !opts.wsdl && !opts.catalogFile) {
         throw new Error("Provide one of: compiledCatalog, wsdl, or catalogFile");
@@ -76,7 +77,7 @@ export async function generateOpenAPI(opts) {
     const securityCfg = loadSecurityConfig(opts.securityConfigFile);
     const securityBuilt = buildSecurity(securityCfg);
     // Build components.schemas
-    const schemas = buildSchemas(compiled, {
+    const schemas = generateSchemas(compiled, {
         closedSchemas: opts.closedSchemas,
         pruneUnusedSchemas: opts.pruneUnusedSchemas,
     });
@@ -89,7 +90,7 @@ export async function generateOpenAPI(opts) {
             return "General"; // fallback; per-op derivation below
         return compiled.serviceName || "SOAP";
     })();
-    const paths = buildPaths(compiled, {
+    const paths = generatePaths(compiled, {
         basePath: opts.basePath || "/",
         pathStyle: opts.pathStyle || "kebab",
         defaultMethod: opts.defaultMethod || "post",
@@ -263,15 +264,15 @@ export async function generateOpenAPI(opts) {
         try {
             const parser = await import("@apidevtools/swagger-parser");
             await parser.default.validate(JSON.parse(JSON.stringify(doc)));
-            console.log("OpenAPI validation: OK");
+            // Validation passed - no message needed (only report failures)
         }
         catch (e) {
-            console.error("OpenAPI validation failed:", e instanceof Error ? e.message : e);
+            error(`OpenAPI validation failed: ${e instanceof Error ? e.message : e}`);
             throw e;
         }
     }
     else {
-        console.log("OpenAPI validation skipped by flag");
+        info("OpenAPI validation skipped by flag");
     }
     // Determine base path for writing
     let base = opts.outFile;
@@ -309,7 +310,7 @@ function safeJson(file) {
         return JSON.parse(fs.readFileSync(file, "utf8"));
     }
     catch (e) {
-        console.warn(`⚠️ Failed to parse JSON file '${file}': ${e instanceof Error ? e.message : String(e)}`);
+        warn(`Failed to parse JSON file '${file}': ${e instanceof Error ? e.message : String(e)}`);
         return undefined;
     }
 }

package/dist/openapi/{buildPaths.d.ts → generatePaths.d.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenAPI Paths Builder
+ * OpenAPI Paths Generator
  *
  * This module transforms WSDL operations into OpenAPI 3.1 paths and operations.
  * It bridges the gap between SOAP's operation-centric model and REST's resource-oriented
@@ -48,9 +48,9 @@ export interface TagsMappingFile {
     [opName: string]: string;
 }
 /**
- * Options for building OpenAPI paths
+ * Options for generating OpenAPI paths
  *
- * @interface BuildPathsOptions
+ * @interface GeneratePathsOptions
  * @property {string} [basePath] - Base path prefix for all operations (e.g., /v1/soap)
  * @property {PathStyle} pathStyle - Style for converting operation names to path segments
  * @property {string} defaultMethod - Default HTTP method for operations
@@ -60,7 +60,7 @@ export interface TagsMappingFile {
  * @property {Record<string, any[]>} opSecurity - Operation-specific security requirements
  * @property {Record<string, string[]>} opHeaderParameters - Operation-specific header parameters
  */
-export interface BuildPathsOptions {
+export interface GeneratePathsOptions {
     basePath?: string;
     pathStyle: PathStyle;
     defaultMethod: string;
@@ -70,5 +70,5 @@ export interface BuildPathsOptions {
     opSecurity: Record<string, any[] | undefined>;
     opHeaderParameters: Record<string, string[]>;
 }
-export declare function buildPaths(compiled: CompiledCatalog, opts: BuildPathsOptions): Record<string, any>;
-//# sourceMappingURL=buildPaths.d.ts.map
+export declare function generatePaths(compiled: CompiledCatalog, opts: GeneratePathsOptions): Record<string, any>;
+//# sourceMappingURL=generatePaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generatePaths.d.ts","sourceRoot":"","sources":["../../src/openapi/generatePaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAG3C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,MAAM,EAAE,MAAM,GAAG;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAE9B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,oBAAoB,uBAyDlF"}

package/dist/openapi/{buildPaths.js → generatePaths.js}

@@ -1,5 +1,5 @@
 import { toPathSegment } from "./casing.js";
-export function buildPaths(compiled, opts) {
+export function generatePaths(compiled, opts) {
     const paths = {};
     const base = normalizeBase(opts.basePath || "/");
     for (const op of compiled.operations) {

package/dist/openapi/{buildSchemas.d.ts → generateSchemas.d.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenAPI Schema Component Builder
+ * OpenAPI Schema Component Generator
  *
  * This module transforms the compiled TypeScript types from the WSDL catalog
  * into OpenAPI 3.1 schema components. It handles the conversion of complex types,
@@ -15,13 +15,13 @@
  */
 import type { CompiledCatalog } from "../compiler/schemaCompiler.js";
 /**
- * Options for building OpenAPI schema components
+ * Options for generating OpenAPI schema components
  *
- * @interface BuildSchemasOptions
+ * @interface GenerateSchemasOptions
  * @property {boolean} [closedSchemas] - Whether to add additionalProperties:false to object schemas
  * @property {boolean} [pruneUnusedSchemas] - Whether to exclude schemas not referenced by operations
  */
-export interface BuildSchemasOptions {
+export interface GenerateSchemasOptions {
     closedSchemas?: boolean;
     pruneUnusedSchemas?: boolean;
 }
@@ -29,16 +29,16 @@ export type ComponentsSchemas = Record<string, any>;
 /**
  * Transforms the compiled WSDL catalog into OpenAPI schema components
  *
- * @function buildSchemas
+ * @function generateSchemas
  * @param {CompiledCatalog} compiled - The compiled WSDL catalog containing types, aliases, and operations
- * @param {BuildSchemasOptions} opts - Options for schema generation
+ * @param {GenerateSchemasOptions} opts - Options for schema generation
  * @returns {ComponentsSchemas} - A record of schema component names to their JSON Schema definitions
  *
  * @throws Will throw an error if there are unknown referenced types or bases while building schemas
  *
  * @example
- * // Example usage: building schemas with closed schemas enforcement and unused schema pruning
- * const schemas = buildSchemas(compiledCatalog, { closedSchemas: true, pruneUnusedSchemas: true });
+ * // Example usage: generating schemas with closed schemas enforcement and unused schema pruning
+ * const schemas = generateSchemas(compiledCatalog, { closedSchemas: true, pruneUnusedSchemas: true });
  */
-export declare function buildSchemas(compiled: CompiledCatalog, opts: BuildSchemasOptions): ComponentsSchemas;
-//# sourceMappingURL=buildSchemas.d.ts.map
+export declare function generateSchemas(compiled: CompiledCatalog, opts: GenerateSchemasOptions): ComponentsSchemas;
+//# sourceMappingURL=generateSchemas.d.ts.map

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

@@ -0,0 +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;AAmIpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CA8C1G"}

package/dist/openapi/{buildSchemas.js → generateSchemas.js}

@@ -131,18 +131,18 @@ function buildComplexSchema(t, closed, knownTypeNames, aliasNames) {
 /**
  * Transforms the compiled WSDL catalog into OpenAPI schema components
  *
- * @function buildSchemas
+ * @function generateSchemas
  * @param {CompiledCatalog} compiled - The compiled WSDL catalog containing types, aliases, and operations
- * @param {BuildSchemasOptions} opts - Options for schema generation
+ * @param {GenerateSchemasOptions} opts - Options for schema generation
  * @returns {ComponentsSchemas} - A record of schema component names to their JSON Schema definitions
  *
  * @throws Will throw an error if there are unknown referenced types or bases while building schemas
  *
  * @example
- * // Example usage: building schemas with closed schemas enforcement and unused schema pruning
- * const schemas = buildSchemas(compiledCatalog, { closedSchemas: true, pruneUnusedSchemas: true });
+ * // Example usage: generating schemas with closed schemas enforcement and unused schema pruning
+ * const schemas = generateSchemas(compiledCatalog, { closedSchemas: true, pruneUnusedSchemas: true });
  */
-export function buildSchemas(compiled, opts) {
+export function generateSchemas(compiled, opts) {
     const closed = !!opts.closedSchemas;
     const schemas = {};
     const typeNames = new Set(compiled.types.map(t => t.name));

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

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/openapi/security.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,MAAM,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAC;QACxC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,GAAG,CAAA;SAAE,CAAC,CAAA;KACpE,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAShF;AAeD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,CA+FjE"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/openapi/security.ts"],"names":[],"mappings":"AAmBA;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE;YAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,MAAM,CAAC,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAC;QACxC,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,GAAG,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACzB,MAAM,CAAC,EAAE,UAAU,CAAC;QACpB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,GAAG,CAAA;SAAE,CAAC,CAAA;KACpE,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;IAC9C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAShF;AAeD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,cAAc,GAAG,aAAa,CA+FjE"}

package/dist/openapi/security.js

@@ -15,6 +15,7 @@
  * security overrides through an external JSON configuration file.
  */
 import fs from "node:fs";
+import { warn } from "../util/cli.js";
 /**
  * Load security configuration from a JSON file
  *
@@ -29,7 +30,7 @@ export function loadSecurityConfig(filePath) {
         return JSON.parse(raw);
     }
     catch (e) {
-        console.warn(`⚠️ Failed to read security config '${filePath}': ${e instanceof Error ? e.message : String(e)}`);
+        warn(`Failed to read security config '${filePath}': ${e instanceof Error ? e.message : String(e)}`);
         return undefined;
     }
 }

package/dist/pipeline.d.ts

@@ -1,25 +1,37 @@
 import { type GenerateOpenAPIOptions } from "./openapi/generateOpenAPI.js";
-import type { CompilerOptions } from "./config.js";
+import { type GenerateGatewayOptions } from "./gateway/generateGateway.js";
+import { type CompilerOptions } from "./config.js";
 /**
  * Configuration options for the generation pipeline
  *
  * @interface PipelineOptions
  * @property {string} wsdl - Path or URL to the WSDL file to process
- * @property {string} outDir - Output directory for generated TypeScript artifacts
+ * @property {string} catalogOut - Output path for catalog.json (always generated when compiling WSDL)
+ * @property {string} [clientOutDir] - Optional client output directory; when provided, client artifacts are generated
  * @property {Partial<CompilerOptions>} [compiler] - Compiler options for type generation
  * @property {object} [openapi] - OpenAPI generation configuration (optional)
- * @property {string} [openapi.outFile] - Optional output path for OpenAPI specification
+ * @property {string} openapi.outFile - Output path for OpenAPI specification
+ * @property {object} [gateway] - Gateway generation configuration (optional, requires openapi and explicit versionSlug/serviceSlug)
+ * @property {string} gateway.outDir - Output directory for gateway code
+ * @property {string} gateway.versionSlug - Version identifier for URN generation (required)
+ * @property {string} gateway.serviceSlug - Service identifier for URN generation (required)
  */
 export interface PipelineOptions {
     wsdl: string;
-    outDir: string;
+    catalogOut: string;
+    clientOutDir?: string;
     compiler?: Partial<CompilerOptions>;
     openapi?: Omit<GenerateOpenAPIOptions, "wsdl" | "catalogFile" | "compiledCatalog"> & {
         outFile?: string;
     };
+    gateway?: Omit<GenerateGatewayOptions, "openapiFile" | "openapiDocument"> & {
+        outDir?: string;
+        versionSlug: string;
+        serviceSlug: string;
+    };
 }
 /**
- * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI
+ * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway
  *
  * This function orchestrates the entire process:
  * 1. Loads and parses the WSDL from file or URL
@@ -27,11 +39,13 @@ export interface PipelineOptions {
  * 3. Emits TypeScript client code, types, and utilities
  * 4. Optionally emits a JSON catalog for introspection
  * 5. Optionally generates an OpenAPI 3.1 specification
+ * 6. Optionally generates Fastify gateway code from the OpenAPI spec
  *
  * @param {PipelineOptions} opts - Configuration options for the pipeline
- * @returns {Promise<{compiled: any}>} - The compiled catalog for potential further processing
+ * @returns {Promise<{compiled: any; openapiDoc?: any}>} - The compiled catalog and optional OpenAPI document
  */
 export declare function runGenerationPipeline(opts: PipelineOptions): Promise<{
-    compiled: import("./compiler/schemaCompiler.js").CompiledCatalog;
+    compiled: any;
+    openapiDoc?: any;
 }>;
 //# sourceMappingURL=pipeline.d.ts.map

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,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAGjD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,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;CAC3G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe;;GAgDhE"}
+{"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;;;;;;;;;;;;;;GAcG;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;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CA+FhH"}

package/dist/pipeline.js

@@ -10,14 +10,16 @@ import path from "node:path";
 import fs from "node:fs";
 import { loadWsdl } from "./loader/wsdlLoader.js";
 import { compileCatalog } from "./compiler/schemaCompiler.js";
-import { emitClient } from "./emit/clientEmitter.js";
-import { emitTypes } from "./emit/typesEmitter.js";
-import { emitUtils } from "./emit/utilsEmitter.js";
-import { emitCatalog } from "./emit/catalogEmitter.js";
+import { generateClient } from "./client/generateClient.js";
+import { generateTypes } from "./client/generateTypes.js";
+import { generateUtils } from "./client/generateUtils.js";
+import { generateCatalog } from "./compiler/generateCatalog.js";
 import { generateOpenAPI } from "./openapi/generateOpenAPI.js";
-import { TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS } from "./config.js";
+import { generateGateway } from "./gateway/generateGateway.js";
+import { resolveCompilerOptions } from "./config.js";
+import { emitClientArtifacts, reportCompilationStats, reportOpenApiSuccess, success } from "./util/cli.js";
 /**
- * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI
+ * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway
  *
  * This function orchestrates the entire process:
  * 1. Loads and parses the WSDL from file or URL
@@ -25,48 +27,80 @@ import { TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS } from "./config.js";
  * 3. Emits TypeScript client code, types, and utilities
  * 4. Optionally emits a JSON catalog for introspection
  * 5. Optionally generates an OpenAPI 3.1 specification
+ * 6. Optionally generates Fastify gateway code from the OpenAPI spec
  *
  * @param {PipelineOptions} opts - Configuration options for the pipeline
- * @returns {Promise<{compiled: any}>} - The compiled catalog for potential further processing
+ * @returns {Promise<{compiled: any; openapiDoc?: any}>} - The compiled catalog and optional OpenAPI document
  */
 export async function runGenerationPipeline(opts) {
+    // Determine a working directory for the compiler (used for relative path resolution)
+    // Use the first available output location as the base
+    const workingDir = opts.clientOutDir
+        ? opts.clientOutDir
+        : opts.openapi?.outFile
+            ? path.dirname(opts.openapi.outFile)
+            : opts.gateway?.outDir
+                ? opts.gateway.outDir
+                : path.dirname(opts.catalogOut);
     // Merge provided compiler options with defaults, ensuring required fields are set
-    const finalCompiler = {
-        ...TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS,
-        catalog: opts.compiler?.catalog ?? true, // default to emitting catalog in pipeline mode
-        ...(opts.compiler || {}),
+    const finalCompiler = resolveCompilerOptions({
+        ...opts.compiler,
+        catalog: true, // Always emit catalog in pipeline mode
+    }, {
         wsdl: opts.wsdl,
-        out: opts.outDir,
-    };
+        out: workingDir,
+    });
     // Step 1: Load and parse the WSDL document
     const wsdlCatalog = await loadWsdl(opts.wsdl);
     // Step 2: Compile the WSDL into a structured catalog
     const compiled = compileCatalog(wsdlCatalog, finalCompiler);
-    // Step 3: Ensure the output directory exists
-    fs.mkdirSync(opts.outDir, { recursive: true });
-    // Step 4: Emit TypeScript artifacts
-    emitClient(path.join(opts.outDir, "client.ts"), compiled);
-    emitTypes(path.join(opts.outDir, "types.ts"), compiled);
-    emitUtils(path.join(opts.outDir, "utils.ts"), compiled);
-    // Step 5: Optionally emit the JSON catalog for introspection
-    if (finalCompiler.catalog) {
-        emitCatalog(path.join(opts.outDir, "catalog.json"), compiled);
+    // Report compilation statistics
+    reportCompilationStats(wsdlCatalog, compiled);
+    // Step 3: Emit catalog.json (always, to the specified catalogOut path)
+    fs.mkdirSync(path.dirname(opts.catalogOut), { recursive: true });
+    generateCatalog(opts.catalogOut, compiled);
+    success(`Compiled catalog written to ${opts.catalogOut}`);
+    // Step 4: Optionally generate TypeScript client artifacts
+    if (opts.clientOutDir) {
+        emitClientArtifacts(opts.clientOutDir, compiled, generateClient, generateTypes, generateUtils);
     }
-    // Step 6: Optionally generate OpenAPI specification
+    // Step 4: Optionally generate OpenAPI specification
+    let openapiDoc;
     if (opts.openapi) {
-        // Determine output path for OpenAPI specification
-        let resolvedOut = opts.openapi.outFile;
-        if (!resolvedOut) {
-            const yamlPreferred = !!opts.openapi.asYaml;
-            resolvedOut = path.join(opts.outDir, yamlPreferred ? "openapi.yaml" : "openapi.json");
+        // OpenAPI output file must be explicitly provided
+        if (!opts.openapi.outFile) {
+            throw new Error("OpenAPI generation requires an explicit output file path via openapi.outFile");
         }
         // Generate the OpenAPI specification using the compiled catalog
-        await generateOpenAPI({
+        const result = await generateOpenAPI({
             ...opts.openapi,
             compiledCatalog: compiled,
-            outFile: resolvedOut,
+            outFile: opts.openapi.outFile,
         });
+        openapiDoc = result.doc;
+        // Report OpenAPI generation success
+        reportOpenApiSuccess(result);
     }
-    // Return the compiled catalog for potential further processing
-    return { compiled };
+    // Step 5: Optionally generate Fastify gateway code
+    if (opts.gateway) {
+        if (!openapiDoc) {
+            throw new Error("Gateway generation requires OpenAPI generation to be enabled in the pipeline");
+        }
+        if (!opts.gateway.outDir) {
+            throw new Error("Gateway generation requires an explicit output directory via gateway.outDir");
+        }
+        const gatewayOutDir = path.resolve(opts.gateway.outDir);
+        await generateGateway({
+            ...opts.gateway,
+            openapiDocument: openapiDoc,
+            outDir: gatewayOutDir,
+            // Pass the client directory if client is being generated
+            clientDir: opts.clientOutDir ? path.resolve(opts.clientOutDir) : undefined,
+            // Reuse the same imports mode as the TypeScript client/types/utils emitters
+            imports: finalCompiler.imports,
+        });
+        success(`Gateway code generated in ${gatewayOutDir}`);
+    }
+    // Return the compiled catalog and OpenAPI doc for potential further processing
+    return { compiled, openapiDoc };
 }