@techspokes/typescript-wsdl-client 0.10.2 → 0.11.0

package/README.md

@@ -35,7 +35,7 @@ npx wsdl-tsc pipeline \
   --gateway-dir ./tmp/gateway \
   --gateway-service-name weather \
   --gateway-version-prefix v1 \
-  --generate-app
+  --init-app
 ```
 
 This parses the WSDL, generates a typed SOAP client, creates an OpenAPI 3.1 spec, builds Fastify gateway handlers, and creates a runnable application.
@@ -43,7 +43,7 @@ This parses the WSDL, generates a typed SOAP client, creates an OpenAPI 3.1 spec
 ### Run and Test
 
 ```bash
-cd tmp/app && cp .env.example .env && npx tsx server.js
+cd tmp/app && npm install && cp .env.example .env && npm start
 ```
 
 ```bash
@@ -62,6 +62,31 @@ curl -X POST http://localhost:3000/get-weather-information \
 | Fastify Gateway | plugin.ts, routes/, schemas/ | Production REST handlers |
 | Catalog | catalog.json | Compiled WSDL (debuggable, cacheable) |
 
+## Testing With Generated Code
+
+The generated `operations.ts` provides a typed interface for mocking the SOAP client without importing the concrete class or the `soap` package:
+
+```typescript
+import type { WeatherOperations } from "./generated/client/operations.js";
+
+const mockClient: WeatherOperations = {
+  GetCityWeatherByZIP: async (args) => ({
+    response: { GetCityWeatherByZIPResult: { Success: true, City: "Test" } },
+    headers: {},
+  }),
+  // ... other operations
+};
+
+// Use with the gateway plugin
+import Fastify from "fastify";
+import { weatherGateway } from "./generated/gateway/plugin.js";
+
+const app = Fastify();
+await app.register(weatherGateway, { client: mockClient, prefix: "/v1/weather" });
+```
+
+See [Testing Guide](docs/testing.md) for integration test patterns and mock examples.
+
 ## Commands
 
 | Command | Purpose |
@@ -85,6 +110,7 @@ See [CLI Reference](docs/cli-reference.md) for all flags and examples.
 | [Gateway Guide](docs/gateway-guide.md) | Fastify integration and error handling |
 | [Configuration](docs/configuration.md) | Security, tags, operations config files |
 | [Production Guide](docs/production.md) | CI/CD, validation, logging, limitations |
+| [Testing Guide](docs/testing.md) | Testing patterns and mock client examples |
 | [Troubleshooting](docs/troubleshooting.md) | Common issues and debugging |
 | [Working With Generated Code](docs/generated-code.md) | Using clients and types |
 | [Architecture](docs/architecture.md) | Internal pipeline for contributors |

package/dist/app/generateApp.d.ts

@@ -13,6 +13,7 @@
  * @property {string} [prefix] - Route prefix (default: "")
  * @property {boolean} [logger] - Enable Fastify logger (default: true)
  * @property {"copy"|"reference"} [openapiMode] - How to handle OpenAPI file (default: "copy")
+ * @property {boolean} [force] - Overwrite existing scaffold files (default: false)
  */
 export interface GenerateAppOptions {
     clientDir: string;
@@ -26,19 +27,24 @@ export interface GenerateAppOptions {
     prefix?: string;
     logger?: boolean;
     openapiMode?: "copy" | "reference";
+    force?: boolean;
 }
 /**
- * Generates a runnable Fastify application
+ * Generates a runnable Fastify application scaffold
  *
- * This function orchestrates the complete app generation process:
+ * This function orchestrates the complete app scaffold process:
  * 1. Validates all required inputs exist
  * 2. Reads catalog.json for metadata
  * 3. Creates app directory
  * 4. Generates server.ts with Fastify setup
  * 5. Generates config.ts with environment loading
- * 6. Generates .env.example with configuration template
- * 7. Generates README.md with usage instructions
- * 8. Optionally copies OpenAPI spec into app directory
+ * 6. Generates package.json with dependencies
+ * 7. Generates tsconfig.json with TypeScript settings
+ * 8. Generates .env.example with configuration template
+ * 9. Generates README.md with usage instructions
+ * 10. Optionally copies OpenAPI spec into app directory
+ *
+ * Files that already exist are skipped unless force is true.
  *
  * @param {GenerateAppOptions} opts - App generation options
  * @returns {Promise<void>}

package/dist/app/generateApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateApp.d.ts","sourceRoot":"","sources":["../../src/app/generateApp.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACpC;AA2gBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE"}
+{"version":3,"file":"generateApp.d.ts","sourceRoot":"","sources":["../../src/app/generateApp.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAymBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzE"}