@techspokes/typescript-wsdl-client 0.9.9 → 0.10.1

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

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

package/dist/gateway/generateGateway.js

@@ -24,7 +24,7 @@ import fs from "node:fs";
 import path from "node:path";
 import * as yaml from "js-yaml";
 import { buildParamSchemasForOperation, getJsonSchemaRefName, isNumericStatus, resolveClientMeta, resolveOperationMeta, } from "./helpers.js";
-import { emitModelSchemas, emitOperationSchemas, emitPluginModule, emitRouteFiles, emitRouteFilesWithHandlers, emitRuntimeModule, emitSchemasModule, } from "./generators.js";
+import { emitModelSchemas, emitOperationSchemas, emitPluginModule, emitTypeCheckFixture, emitRouteFiles, emitRouteFilesWithHandlers, emitRuntimeModule, emitSchemasModule, } from "./generators.js";
 /**
  * Generates Fastify gateway code from an OpenAPI 3.1 specification
  *
@@ -179,8 +179,9 @@ export async function generateGateway(opts) {
     if (emitRuntime) {
         emitRuntimeModule(outDir, versionSlug, serviceSlug);
     }
-    // Step 7: Emit plugin.ts (if enabled)
+    // Step 7: Emit plugin.ts and type-check fixture (if enabled)
     if (emitPlugin) {
-        emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode);
+        emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode, operations);
+        emitTypeCheckFixture(outDir, clientMeta, importsMode);
     }
 }

package/dist/gateway/generators.d.ts

@@ -122,6 +122,7 @@ export declare function emitRuntimeModule(outDir: string, versionSlug: string, s
  *
  * Generated code includes:
  * - Plugin options interface with client and prefix support
+ * - Named operations interface for decorator type autocomplete
  * - Fastify decorator type augmentation
  * - Plugin implementation that registers schemas, routes, and error handler
  *
@@ -130,8 +131,21 @@ 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"): void;
+export declare function emitPluginModule(outDir: string, versionSlug: string, serviceSlug: string, clientMeta: ClientMeta, importsMode: "js" | "ts" | "bare", operations: OperationMetadata[]): void;
+/**
+ * Emits a type-check fixture that verifies plugin-client type compatibility
+ *
+ * Generates `_typecheck.ts` in the gateway output directory. This file is
+ * picked up by tsconfig.smoke.json and will fail to compile if the plugin
+ * options interface diverges from the concrete client class.
+ *
+ * @param {string} outDir - Gateway output directory
+ * @param {ClientMeta} clientMeta - Client metadata (className, pluginImportPath)
+ * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
+ */
+export declare function emitTypeCheckFixture(outDir: string, clientMeta: ClientMeta, importsMode: "js" | "ts" | "bare"): void;
 /**
  * Emits individual route files with full handler implementations
  *

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

@@ -1 +1 @@
-{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/gateway/generators.ts"],"names":[],"mappings":"AAcA,OAAO,EAAC,KAAK,UAAU,EAAE,KAAK,eAAe,EAA6C,MAAM,cAAc,CAAC;AAE/G;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,0BAA0B,EAAE,MAAM,EAAE,EACpC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,GAAG,EACvH,UAAU,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,EACnC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACnC,iBAAiB,EAAE,CA2HrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI,CAsBN;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,IAAI,CA2CN;AAGD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI,CAkLN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,IAAI,CAyFN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,iBAAiB,EAAE,EAC/B,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,IAAI,CAwEN"}
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/gateway/generators.ts"],"names":[],"mappings":"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"}

package/dist/gateway/generators.js

@@ -470,6 +470,7 @@ export function createGatewayErrorHandler_${vSlug}_${sSlug}() {
  *
  * Generated code includes:
  * - Plugin options interface with client and prefix support
+ * - Named operations interface for decorator type autocomplete
  * - Fastify decorator type augmentation
  * - Plugin implementation that registers schemas, routes, and error handler
  *
@@ -478,11 +479,17 @@ 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) {
+export function emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, importsMode, operations) {
     const vSlug = slugName(versionSlug);
     const sSlug = slugName(serviceSlug);
     const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
+    // Build named operations interface methods from operation metadata
+    const operationMethods = operations
+        .filter(op => op.clientMethodName)
+        .map(op => `  ${op.clientMethodName}(args: unknown): Promise<{ response: unknown; headers: unknown }>;`)
+        .join("\n");
     const pluginTs = `/**
  * ${clientMeta.className} Gateway Plugin
  *
@@ -491,6 +498,7 @@ export function emitPluginModule(outDir, versionSlug, serviceSlug, clientMeta, i
  */
 import fp from "fastify-plugin";
 import type { FastifyInstance, FastifyPluginOptions } from "fastify";
+import type { ${clientMeta.className} } from "${clientMeta.pluginImportPath}";
 import { registerSchemas_${vSlug}_${sSlug} } from "./schemas${suffix}";
 import { registerRoutes_${vSlug}_${sSlug} } from "./routes${suffix}";
 import { createGatewayErrorHandler_${vSlug}_${sSlug} } from "./runtime${suffix}";
@@ -503,9 +511,7 @@ export interface ${clientMeta.className}GatewayOptions extends FastifyPluginOpti
    * SOAP client instance (pre-configured).
    * The client should be instantiated with appropriate source and security settings.
    */
-  client: {
-    [method: string]: (args: unknown) => Promise<{ response: unknown; headers: unknown }>;
-  };
+  client: ${clientMeta.className};
   /**
    * Optional additional route prefix applied at runtime.
    * Note: If you used --openapi-base-path during generation, routes already have that prefix baked in.
@@ -515,13 +521,20 @@ export interface ${clientMeta.className}GatewayOptions extends FastifyPluginOpti
 }
 
 /**
- * Fastify decorator type augmentation
+ * Convenience type listing all SOAP operations with \`args: unknown\` signatures.
+ *
+ * This interface is NOT used for the decorator type (which uses the concrete
+ * client class for full type safety). It is exported as a lightweight alternative
+ * for mocking or testing scenarios where importing the full client class is
+ * undesirable.
  */
+export interface ${clientMeta.className}Operations {
+${operationMethods}
+}
+
 declare module "fastify" {
   interface FastifyInstance {
-    ${clientMeta.decoratorName}: {
-      [method: string]: (args: unknown) => Promise<{ response: unknown; headers: unknown }>;
-    };
+    ${clientMeta.decoratorName}: ${clientMeta.className};
   }
 }
 
@@ -567,6 +580,37 @@ export { ${sSlug}GatewayPlugin };
 `;
     fs.writeFileSync(path.join(outDir, "plugin.ts"), pluginTs, "utf8");
 }
+/**
+ * Emits a type-check fixture that verifies plugin-client type compatibility
+ *
+ * Generates `_typecheck.ts` in the gateway output directory. This file is
+ * picked up by tsconfig.smoke.json and will fail to compile if the plugin
+ * options interface diverges from the concrete client class.
+ *
+ * @param {string} outDir - Gateway output directory
+ * @param {ClientMeta} clientMeta - Client metadata (className, pluginImportPath)
+ * @param {"js"|"ts"|"bare"} importsMode - Import-extension mode
+ */
+export function emitTypeCheckFixture(outDir, clientMeta, importsMode) {
+    const suffix = importsMode === "bare" ? "" : `.${importsMode}`;
+    const content = `/**
+ * Type-check fixture — verifies plugin options accept the concrete client class.
+ * Auto-generated. Not intended for runtime use.
+ */
+import type { ${clientMeta.className} } from "${clientMeta.pluginImportPath}";
+import type { ${clientMeta.className}GatewayOptions } from "./plugin${suffix}";
+
+// This function verifies structural compatibility at the type level.
+// If the plugin options interface diverges from the client class, this
+// will produce a compile error with a clear message.
+function _assertClientCompatible(client: ${clientMeta.className}): void {
+  const _opts: ${clientMeta.className}GatewayOptions = { client };
+  void _opts;
+}
+void _assertClientCompatible;
+`;
+    fs.writeFileSync(path.join(outDir, "_typecheck.ts"), content, "utf8");
+}
 /**
  * Emits individual route files with full handler implementations
  *
@@ -600,9 +644,23 @@ export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, servi
         routesTs += `import { ${fnName} } from "./routes/${routeFileBase}${suffix}";\n`;
         // Generate individual route file with full handler
         const clientMethod = op.clientMethodName || op.operationId || op.operationSlug;
-        // Type names for documentation; we use unknown at runtime since schema validation handles it
         const reqTypeName = op.requestTypeName || "unknown";
         const resTypeName = op.responseTypeName || "unknown";
+        const hasRequestType = op.requestTypeName && op.requestTypeName !== "unknown";
+        // Build type import and route generic when request type is available.
+        // The Body generic narrows request.body for types with properties. For empty
+        // request types (e.g. no-arg operations), Fastify's KeysOf<Body> resolves to
+        // never and the generic is ignored — the `as` assertion at the call site
+        // handles this edge case. The cast is safe: JSON Schema validates at runtime.
+        const typeImport = hasRequestType
+            ? `import type { ${reqTypeName} } from "${clientMeta.typesImportPath}";\n`
+            : "";
+        const routeGeneric = hasRequestType
+            ? `<{ Body: ${reqTypeName} }>`
+            : "";
+        const bodyArg = hasRequestType
+            ? `request.body as ${reqTypeName}`
+            : "request.body";
         // Note: op.path comes from OpenAPI and already includes any base path
         let routeTs = `/**
  * Route: ${op.method.toUpperCase()} ${op.path}
@@ -612,17 +670,17 @@ export function emitRouteFilesWithHandlers(outDir, routesDir, versionSlug, servi
  * Auto-generated - do not edit manually.
  */
 import type { FastifyInstance } from "fastify";
-import schema from "../schemas/operations/${op.operationSlug}.json" with { type: "json" };
+${typeImport}import schema from "../schemas/operations/${op.operationSlug}.json" with { type: "json" };
 import { buildSuccessEnvelope } from "../runtime${suffix}";
 
 export async function ${fnName}(fastify: FastifyInstance) {
-  fastify.route({
+  fastify.route${routeGeneric}({
     method: "${op.method.toUpperCase()}",
     url: "${op.path}",
     schema,
     handler: async (request) => {
       const client = fastify.${clientMeta.decoratorName};
-      const result = await client.${clientMethod}(request.body);
+      const result = await client.${clientMethod}(${bodyArg});
       return buildSuccessEnvelope(result.response);
     },
   });

package/dist/gateway/helpers.d.ts

@@ -141,14 +141,16 @@ export declare function buildParamSchemasForOperation(pathItem: any, operation:
  * @interface ClientMeta
  * @property {string} className - Client class name (e.g., "EVRNService")
  * @property {string} decoratorName - Fastify decorator name (e.g., "evrnserviceClient")
- * @property {string} importPath - Import path relative to routes directory
- * @property {string} typesImportPath - Import path for types
+ * @property {string} importPath - Import path relative to routes/ directory — for future typed route handlers
+ * @property {string} typesImportPath - Types import path relative to routes/ directory — for future typed route handlers
+ * @property {string} pluginImportPath - Import path relative to gateway output directory — used by emitPluginModule()
  */
 export interface ClientMeta {
     className: string;
     decoratorName: string;
     importPath: string;
     typesImportPath: string;
+    pluginImportPath: string;
 }
 /**
  * Extended operation metadata for full handler generation
@@ -171,13 +173,6 @@ export interface ResolvedOperationMeta {
     requestTypeName?: string;
     responseTypeName?: string;
 }
-/**
- * PascalCase conversion utility
- *
- * @param {string} str - String to convert to PascalCase
- * @returns {string} - PascalCase version of the string
- */
-export declare function pascalCase(str: string): string;
 /**
  * Options for resolving client metadata
  *

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

@@ -10,6 +10,7 @@
  * - Parameter resolution with path-level and operation-level override support
  * - Automatic version/service detection from OpenAPI paths
  */
+import { pascal } from "../util/tools.js";
 /**
  * Converts a name to a deterministic slug for use in file names and URN IDs
  *
@@ -339,17 +340,6 @@ export function buildParamSchemasForOperation(pathItem, operation, doc, schemaId
         headersSchema,
     };
 }
-/**
- * PascalCase conversion utility
- *
- * @param {string} str - String to convert to PascalCase
- * @returns {string} - PascalCase version of the string
- */
-export function pascalCase(str) {
-    return str
-        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
-        .replace(/^(.)/, (c) => c.toUpperCase());
-}
 /**
  * Resolves client metadata from available sources
  *
@@ -370,10 +360,10 @@ export function resolveClientMeta(opts, catalog) {
         className = opts.clientClassName;
     }
     else if (catalog?.serviceName) {
-        className = pascalCase(catalog.serviceName);
+        className = pascal(catalog.serviceName);
     }
     else {
-        className = pascalCase(opts.serviceSlug);
+        className = pascal(opts.serviceSlug);
     }
     // Determine decorator name
     let decoratorName;
@@ -383,18 +373,29 @@ export function resolveClientMeta(opts, catalog) {
     else {
         decoratorName = slugName(className) + "Client";
     }
-    // Build import paths (relative from routes/ to client/)
+    // Build import paths for different directory depths.
+    //
+    // Standard layout (enforced by pipeline convention):
+    //   {parent}/
+    //     client/client.ts    ← --client-dir
+    //     gateway/            ← --gateway-dir
+    //       plugin.ts         ← pluginImportPath: one level up
+    //       routes/foo.ts     ← importPath: two levels up
     const importPath = opts.clientDir
         ? `../../client/client${suffix}`
         : `../client/client${suffix}`;
     const typesImportPath = opts.clientDir
         ? `../../client/types${suffix}`
         : `../client/types${suffix}`;
+    const pluginImportPath = opts.clientDir
+        ? `../client/client${suffix}`
+        : `./client/client${suffix}`;
     return {
         className,
         decoratorName,
         importPath,
         typesImportPath,
+        pluginImportPath,
     };
 }
 /**
@@ -411,8 +412,8 @@ export function resolveOperationMeta(operationId, operationSlug, method, path, c
     // Try to find matching operation in catalog
     const catalogOp = catalogOperations?.find(op => op.name === operationId || slugName(op.name) === operationSlug);
     // Use catalog type names if available, otherwise derive by convention
-    const requestTypeName = catalogOp?.inputTypeName ?? pascalCase(operationId);
-    const responseTypeName = catalogOp?.outputTypeName ?? pascalCase(operationId);
+    const requestTypeName = catalogOp?.inputTypeName ?? pascal(operationId);
+    const responseTypeName = catalogOp?.outputTypeName ?? pascal(operationId);
     return {
         operationId,
         operationSlug,

package/docs/api-reference.md

@@ -0,0 +1,223 @@
+# Programmatic API
+
+All CLI commands are available as TypeScript functions. This document covers each exported function, its usage, and its type signatures.
+
+See the main [README](../README.md) for installation, CLI usage, and project overview.
+
+## compileWsdlToProject
+
+Generate a TypeScript SOAP client from WSDL.
+
+```typescript
+import { compileWsdlToProject } from "@techspokes/typescript-wsdl-client";
+
+await compileWsdlToProject({
+  wsdl: "./wsdl/Hotel.wsdl",
+  outDir: "./src/services/hotel",
+  options: {
+    imports: "js",
+    catalog: true,
+    primitive: {
+      int64As: "number",
+      bigIntegerAs: "string",
+      decimalAs: "string",
+      dateAs: "string"
+    },
+    choice: "all-optional",
+    clientName: "HotelClient",
+    nillableAsOptional: false
+  }
+});
+```
+
+### Type Signature
+
+```typescript
+function compileWsdlToProject(input: {
+  wsdl: string;
+  outDir: string;
+  options?: Partial<CompilerOptions>;
+}): Promise<void>;
+```
+
+### CompilerOptions
+
+```typescript
+interface CompilerOptions {
+  wsdl: string;
+  out: string;
+  imports: "js" | "ts" | "bare";
+  catalog: boolean;
+  primitive: PrimitiveOptions;
+  choice?: "all-optional" | "union";
+  failOnUnresolved?: boolean;
+  attributesKey?: string;
+  clientName?: string;
+  nillableAsOptional?: boolean;
+}
+
+interface PrimitiveOptions {
+  int64As?: "string" | "number" | "bigint";
+  bigIntegerAs?: "string" | "number";
+  decimalAs?: "string" | "number";
+  dateAs?: "string" | "Date";
+}
+```
+
+## generateOpenAPI
+
+Generate an OpenAPI 3.1 specification from WSDL or catalog.
+
+```typescript
+import { generateOpenAPI } from "@techspokes/typescript-wsdl-client";
+
+const { doc, jsonPath, yamlPath } = await generateOpenAPI({
+  wsdl: "./wsdl/Hotel.wsdl",
+  outFile: "./docs/hotel-api",
+  format: "both",
+  title: "Hotel Booking API",
+  version: "1.0.0",
+  servers: ["https://api.example.com/v1"],
+  basePath: "/booking",
+  pathStyle: "kebab",
+  tagStyle: "service",
+  validate: true
+});
+```
+
+### Type Signature
+
+```typescript
+function generateOpenAPI(opts: GenerateOpenAPIOptions): Promise<{
+  doc: any;
+  jsonPath?: string;
+  yamlPath?: string;
+}>;
+```
+
+### GenerateOpenAPIOptions
+
+```typescript
+interface GenerateOpenAPIOptions {
+  wsdl?: string;
+  catalogFile?: string;
+  compiledCatalog?: CompiledCatalog;
+  outFile?: string;
+  format?: "json" | "yaml" | "both";
+  title?: string;
+  version?: string;
+  description?: string;
+  servers?: string[];
+  basePath?: string;
+  pathStyle?: "kebab" | "asis" | "lower";
+  defaultMethod?: string;
+  closedSchemas?: boolean;
+  pruneUnusedSchemas?: boolean;
+  tagStyle?: "default" | "first" | "service";
+  tagsFile?: string;
+  securityConfigFile?: string;
+  opsFile?: string;
+  envelopeNamespace?: string;
+  errorNamespace?: string;
+  validate?: boolean;
+  skipValidate?: boolean;
+  asYaml?: boolean;  // deprecated
+}
+```
+
+## generateGateway
+
+Generate Fastify gateway code from an OpenAPI specification.
+
+```typescript
+import { generateGateway } from "@techspokes/typescript-wsdl-client";
+
+await generateGateway({
+  openapiFile: "./docs/hotel-api.json",
+  outDir: "./src/gateway/hotel",
+  clientDir: "./src/services/hotel",
+  versionSlug: "v1",
+  serviceSlug: "hotel",
+  defaultResponseStatusCodes: [200, 400, 401, 403, 404, 409, 422, 429, 500, 502, 503, 504],
+  imports: "js"
+});
+```
+
+### Type Signature
+
+```typescript
+function generateGateway(opts: GenerateGatewayOptions): Promise<void>;
+```
+
+### GenerateGatewayOptions
+
+```typescript
+interface GenerateGatewayOptions {
+  openapiFile?: string;
+  openapiDocument?: any;
+  outDir: string;
+  clientDir?: string;
+  versionSlug?: string;
+  serviceSlug?: string;
+  defaultResponseStatusCodes?: number[];
+  imports?: "js" | "ts" | "bare";
+}
+```
+
+## runGenerationPipeline
+
+Run the complete pipeline: client, OpenAPI, and gateway in one pass.
+
+```typescript
+import { runGenerationPipeline } from "@techspokes/typescript-wsdl-client";
+
+const { compiled, openapiDoc } = await runGenerationPipeline({
+  wsdl: "./wsdl/Hotel.wsdl",
+  catalogOut: "./build/hotel-catalog.json",
+  clientOutDir: "./src/services/hotel",
+  compiler: {
+    imports: "js",
+    primitive: {
+      int64As: "number",
+      decimalAs: "string"
+    }
+  },
+  openapi: {
+    outFile: "./docs/hotel-api.json",
+    format: "both",
+    servers: ["https://api.example.com/v1"],
+    tagStyle: "service"
+  },
+  gateway: {
+    outDir: "./src/gateway/hotel",
+    versionSlug: "v1",
+    serviceSlug: "hotel"
+  }
+});
+```
+
+### Type Signature
+
+```typescript
+function runGenerationPipeline(opts: PipelineOptions): Promise<{
+  compiled: CompiledCatalog;
+  openapiDoc?: any;
+}>;
+```
+
+### PipelineOptions
+
+```typescript
+interface PipelineOptions {
+  wsdl: string;
+  catalogOut: string;
+  clientOutDir?: string;
+  compiler?: Partial<CompilerOptions>;
+  openapi?: Omit<GenerateOpenAPIOptions, "wsdl" | "catalogFile" | "compiledCatalog"> & {
+    outFile?: string;
+  };
+  gateway?: Omit<GenerateGatewayOptions, "openapiFile" | "openapiDocument"> & {
+    outDir?: string;
+  };
+}
+```