@techspokes/typescript-wsdl-client 0.9.9 → 0.10.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techspokes/typescript-wsdl-client",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "description": "TypeScript WSDL → SOAP client generator with full xs:attribute support, complex types, sequences, inheritance, and namespace-collision merging.",
   "keywords": [
     "wsdl",