@techspokes/typescript-wsdl-client 0.2.72 → 0.4.1

package/README.md

@@ -13,13 +13,17 @@
 
 ## Introduction
 
-**TypeScript WSDL Client** is a generator that converts WSDL/XSD files into a fully-typed SOAP client for TypeScript. It simplifies SOAP integration by generating deterministic, type-safe code that works seamlessly with modern TypeScript and Node.js environments.
-
-Key features:
-- **Typed SOAP client**: Generates TypeScript interfaces and runtime code.
-- **Deterministic metadata**: Ensures clean JSON ⇄ SOAP mapping.
-- **ESM and CommonJS support**: Compatible with modern and legacy module systems.
-- **Customizable mappings**: Control how XML primitives (e.g., `xs:decimal`, `xs:date`) are mapped.
+- TypeScript WSDL Client transforms WSDL/XSD schemas into a fully-typed, ready-to-use SOAP client for TypeScript.
+- Eliminates common SOAP pain points: inconsistent XML mappings, complex type inheritance, and module interop headaches.
+- Generates maintainable, diff-friendly code that runs in modern Node.js (ESM/CJS) and strict TypeScript.
+
+With this tool you get:
+- End-to-end type safety: generated interfaces, aliases, and marshalling/unmarshalling logic.
+- Deterministic JSON ⇄ SOAP metadata: clear attribute vs element ordering.
+- Flexible primitive mapping: control decimals, dates, integers, and more via flags.
+- Automatic flattening of `<complexContent>`/`<simpleContent>` inheritance.
+- `<choice>` handling strategies and WS-Policy security hints baked in.
+- Pluggable ESM/CJS imports: target your runtime with `--imports` alone.
 
 Vendor: **[TechSpokes](https://www.techspokes.com)**  
 Maintainer: **Serge Liatko** ([@sergeliatko](https://github.com/sergeliatko))  
@@ -45,23 +49,20 @@ npm i soap
 Run the following command to generate a client from your WSDL file:
 
 ```bash
-npx wsdl-tsc --wsdl ./spec/wsdl/MyService.wsdl --out ./src/generated/my --imports js --ops-ts
+npx wsdl-tsc --wsdl ./spec/wsdl/MyService.wsdl --out ./src/services/my-service
 ```
 
 ### Use the Generated Client
 
 ```ts
-import { createSoapClient } from "./generated/my/runtime.js";
-import { MyServiceSoapClient } from "./generated/my/client.js";
 import soap from "soap";
+import { MyService } from "./services/my-service/client.js";
 
-const security = new soap.WSSecurity("user", "pass");
-const soapClient = await createSoapClient({
-  wsdlUrl: "https://example.com/MyService?wsdl",
-  security,
+const client = new MyService({
+  source: "https://example.com/MyService?wsdl",
+  security: new soap.WSSecurity("user", "pass")
 });
 
-const client = new MyServiceSoapClient(soapClient, "$attributes");
 const response = await client.MyOperation({
   MyOperationRQ: {
     MyElement: {
@@ -78,17 +79,22 @@ console.log(response);
 
 ## Features
 
-- **Attributes and Child Elements**: Supports both attributes and nested elements in SOAP requests.
-- **Literal Text Values**: Handles mixed content (attributes + text).
-- **Security Integration**: Works with `node-soap` security instances (e.g., `WSSecurity`, `BasicAuthSecurity`).
-- **WS-Policy Hints**: Provides inline hints for security configuration based on WSDL policies.
+- **Primitive-type mapping**: Fine-grained flags (`--int64-as`, `--bigint-as`, `--decimal-as`, `--date-as`) so you don’t have to hand-roll conversions for odd XSD primitives.
+- **Complex/simpleContent inheritance**: Automatically flattens and extends base types for `<complexContent>` and `<simpleContent>` extensions.
+- **Deterministic metadata**: Emits runtime maps for JSON ⇄ SOAP mapping—clear attribute vs element distinctions and order.
+- **Choice element support**: Two modes (`all-optional` or `union`) to handle `<choice>` constructs exactly how you need.
+- **Fail-fast unresolved references**: `--fail-on-unresolved` aborts codegen on missing type refs to catch XSD import issues early.
+- **WS-Policy security hints**: Parses WS-Policy tokens and surfaces required security hints in generated JSDoc.
+- **Full catalog introspection**: `--catalog` emits a JSON dump of the compiled schema for debugging large/malformed WSDLs.
+- **Stable, sorted output**: Interfaces, aliases, attributes, and elements are consistently sorted for diff-friendly regeneration.
+- **ESM/CJS interop & custom imports**: `--imports js|ts|bare` lets you target your module system without manual edits.
+- **Attributes and child elements**: Supports both XML attributes and nested elements (including mixed `$value` content).
+- **Security integration**: Works with any `soap.ISecurity` (e.g., `WSSecurity`, `BasicAuthSecurity`) for seamless auth.
 
 ---
 
 ## CLI Usage
 
-The CLI is the primary way to generate SOAP clients.
-
 ```bash
 wsdl-tsc --wsdl <path-or-url> --out <dir> [options]
 ```
@@ -99,15 +105,18 @@ wsdl-tsc --wsdl <path-or-url> --out <dir> [options]
 
 ### Options
 
-| Flag                | Type      | Choices                        | Default      | Description                                                      |
-|---------------------|-----------|--------------------------------|--------------|------------------------------------------------------------------|
-| `--imports`         | string    | js, ts, bare                   | js           | Intra-generated import specifiers: '.js', '.ts', or bare         |
-| `--ops-ts`          | boolean   | true, false                    | true         | Emit `operations.ts` instead of JSON                             |
-| `--attributes-key`  | string    | any                            | $attributes  | Key used by runtime marshaller for XML attributes                |
-| `--int64-as`        | string    | string, number, bigint         | string       | How to map xs:long/xs:unsignedLong                               |
-| `--bigint-as`       | string    | string, number                 | string       | How to map xs:integer family (positive/nonNegative/etc.)         |
-| `--decimal-as`      | string    | string, number                 | string       | How to map xs:decimal (money/precision)                          |
-| `--date-as`         | string    | string, Date                   | string       | How to map date/time/duration types                              |
+| Flag                   | Type      | Choices                        | Default        | Description                                                      |
+|------------------------|-----------|--------------------------------|----------------|------------------------------------------------------------------|
+| `--imports`            | string    | js, ts, bare                   | js             | Intra-generated import specifiers: '.js', '.ts', or bare         |
+| `--catalog`            | boolean   | true, false                    | false          | Emit catalog.json for introspection                              |
+| `--client-name`        | string    | —                              | derived        | Override the exported client class name                          |
+| `--attributes-key`     | string    | any                            | $attributes    | Key used by runtime marshaller for XML attributes                |
+| `--int64-as`           | string    | string, number, bigint         | string         | How to map xs:long/xs:unsignedLong                               |
+| `--bigint-as`          | string    | string, number                 | string         | How to map xs:integer family (positive/nonNegative/etc.)         |
+| `--decimal-as`         | string    | string, number                 | string         | How to map xs:decimal (money/precision)                          |
+| `--date-as`            | string    | string, Date                   | string         | How to map date/time/duration types                              |
+| `--choice`             | string    | all-optional, union            | all-optional   | Representation of `<choice>` elements                            |
+| `--fail-on-unresolved` | boolean   | true, false                    | true           | Fail if any type references cannot be resolved                   |
 
 ---
 
@@ -118,10 +127,9 @@ The generator produces the following files in the output directory:
 ```
 <out>/
   types.ts       # TypeScript interfaces and type aliases
-  client.ts      # Thin wrapper for SOAP operations
-  runtime.ts     # SOAP runtime utilities
-  meta.ts        # Metadata for JSON ⇄ SOAP mapping
-  operations.ts  # Operation metadata (optional, based on --ops-ts)
+  utils.ts       # Runtime metadata for JSON ⇄ SOAP mapping
+  client.ts      # Strongly-typed SOAP client wrapper
+  catalog.json   # (optional) Compiled catalog JSON if `--catalog` is set
 ```
 
 ---
@@ -130,26 +138,55 @@ The generator produces the following files in the output directory:
 
 ### Programmatic API
 
-You can use the generator programmatically for custom workflows:
+You can use the generator programmatically:
 
 ```ts
-import { compileCatalog } from "@techspokes/typescript-wsdl-client";
-
-const catalog = await loadWsdlCatalog("./spec/wsdl/MyService.wsdl");
-const compiled = compileCatalog(catalog, {
-  primitive: { decimalAs: "string", dateAs: "string" },
+import { compileWsdlToProject } from "@techspokes/typescript-wsdl-client";
+
+await compileWsdlToProject({
+  wsdl: "./spec/wsdl/MyService.wsdl",
+  outDir: "./generated",
+  options: {
+    imports: "js",
+    catalog: true,
+    primitive: {
+      int64As: "string",
+      bigIntegerAs: "string",
+      decimalAs: "string",
+      dateAs: "string",
+    },
+    choice: "all-optional",
+    failOnUnresolved: true,
+    attributesKey: "$attributes",
+    clientName: "MyServiceClient",
+  },
 });
-
-// Use the compiled output as needed.
 ```
 
 ---
 
 ## Troubleshooting
 
-- **Missing `runtime.ts`**: Ensure the output directory is writable and you're using the latest version.
-- **Module system issues**: Use `--imports js` for ESM/NodeNext or `--imports bare` for CommonJS.
-- **Security warnings**: Configure `node-soap` security (e.g., `WSSecurity`) as needed.
+- CLI errors  
+  • “Error: Cannot parse WSDL” → verify file path or URL; test with `curl -I <wsdl-url>`.  
+  • “Cannot resolve type XYZ” → ensure all XSD imports are reachable or use `--fail-on-unresolved=false`.  
+- Module resolution  
+  • `ERR_MODULE_NOT_FOUND` → align import extensions: use `--imports js` (adds `.js`), `--imports ts` (adds `.ts`), or `--imports bare` for no extension.  
+- TypeScript type issues  
+  • “Cannot find module './client'” → run `npm run typecheck`, confirm your `outDir` matches import paths, and include generated `.d.ts`.  
+- Runtime SOAP errors  
+  • Enable raw SOAP logging:  
+    ```bash
+    NODE_DEBUG=soap node your-app.js
+    ```  
+  • “wsdl is not valid” → update `soap` to latest (`npm i soap@latest`).  
+- Security warnings  
+  • Missing or invalid headers → pass a valid `soap.ISecurity` instance:  
+    ```ts
+    new soap.WSSecurity("user","pass",{passwordType:"PasswordText"});
+    ```  
+- XML attribute/content issues  
+  • Wrong key in requests → override with `--attributes-key inKey[:outKey]` (e.g., `--attributes-key $attributes:attributes`).
 
 ---
 

package/dist/cli.js

@@ -5,10 +5,9 @@ import fs from "node:fs";
 import path from "node:path";
 import { loadWsdl } from "./loader/wsdlLoader.js";
 import { compileCatalog } from "./compiler/schemaCompiler.js";
-import { emitRuntime } from "./emit/runtimeEmitter.js";
 import { emitTypes } from "./emit/typesEmitter.js";
-import { emitMeta } from "./emit/metaEmitter.js";
-import { emitOps } from "./emit/opsEmitter.js";
+import { emitUtils } from "./emit/utilsEmitter.js";
+import { emitCatalog } from "./emit/catalogEmitter.js";
 import { emitClient } from "./emit/clientEmitter.js";
 const argv = await yargs(hideBin(process.argv))
     .scriptName("wsdl-tsc")
@@ -26,12 +25,12 @@ const argv = await yargs(hideBin(process.argv))
     type: "string",
     choices: ["js", "ts", "bare"],
     default: "js",
-    desc: "Intra-generated import specifiers: '.js', '.ts', or bare (no extension)",
+    desc: "Intra-generated import specifiers: 'js', 'ts', or 'bare' (no extension). Default is 'js'.",
 })
-    .option("ops-ts", {
+    .option("catalog", {
     type: "boolean",
-    default: true,
-    desc: "Emit operations.ts instead of JSON",
+    default: false,
+    desc: "Emit catalog.json file with complied catalog object for introspection. Default is false.",
 })
     .option("attributes-key", {
     type: "string",
@@ -40,7 +39,7 @@ const argv = await yargs(hideBin(process.argv))
 })
     .option("client-name", {
     type: "string",
-    desc: "Override the generated client class name (exact export name)",
+    desc: "Override the generated client class name (exact export name). If not provided, it will be derived from the WSDL name or 'GeneratedSOAPClient' will be used.",
 })
     // Primitive mapping knobs (safe defaults)
     .option("int64-as", {
@@ -66,38 +65,52 @@ const argv = await yargs(hideBin(process.argv))
     choices: ["string", "Date"],
     default: "string",
     desc: "How to map date/time/duration types",
+})
+    .option("choice", {
+    type: "string",
+    choices: ["all-optional", "union"],
+    default: "all-optional",
+    desc: "Representation of <choice> elements: all-optional properties or discriminated union",
+})
+    .option("fail-on-unresolved", {
+    type: "boolean",
+    default: true,
+    desc: "Emit errors if any type references cannot be resolved in the WSDL schema",
 })
     .strict()
     .help()
     .parse();
 const outDir = path.resolve(String(argv.out));
-fs.mkdirSync(outDir, { recursive: true });
 // Load & compile
 const catalog = await loadWsdl(String(argv.wsdl));
 const compiled = compileCatalog(catalog, {
+    wsdl: argv.wsdl,
+    out: argv.out,
+    imports: argv.imports,
+    catalog: argv["catalog"],
     primitive: {
         int64As: argv["int64-as"],
         bigIntegerAs: argv["bigint-as"],
         decimalAs: argv["decimal-as"],
         dateAs: argv["date-as"],
     },
+    choice: argv.choice,
+    failOnUnresolved: argv["fail-on-unresolved"],
+    attributesKey: argv["attributes-key"],
+    clientName: argv["client-name"],
 });
 // Report counts of types and operations for user visibility
 console.log(`Schemas discovered: ${catalog.schemas.length}`);
 console.log(`Compiled types: ${compiled.types.length}`);
 console.log(`Operations: ${compiled.operations.length}`);
+// Ensure output directory exists
+fs.mkdirSync(outDir, { recursive: true });
 // Emit files
-const importExt = argv.imports === "js" ? ".js" : argv.imports === "ts" ? ".ts" : "";
+emitClient(path.join(outDir, "client.ts"), compiled);
 emitTypes(path.join(outDir, "types.ts"), compiled);
-emitMeta(path.join(outDir, "meta.ts"), compiled);
-emitOps(path.join(outDir, argv["ops-ts"] ? "operations.ts" : "operations.json"), compiled);
-emitRuntime(path.join(outDir, "runtime.ts"));
-emitClient(path.join(outDir, "client.ts"), compiled, {
-    // These fields are consumed by our client emitter options shape
-    // to keep CLI flexible without exposing full CompilerOptions here.
-    // @ts-ignore runtime-only options for emitter
-    importExt,
-    attributesKey: String(argv["attributes-key"]),
-    clientName: argv["client-name"],
-});
+emitUtils(path.join(outDir, "utils.ts"), compiled);
+// Emit catalog if requested
+if (compiled.options.catalog) {
+    emitCatalog(path.join(outDir, "catalog.json"), compiled);
+}
 console.log(`✅ Generated TypeScript client in ${outDir}`);

package/dist/compiler/schemaCompiler.d.ts

@@ -46,6 +46,7 @@ export type CompiledAlias = {
     jsdoc?: string;
 };
 export type CompiledCatalog = {
+    options: CompilerOptions;
     types: CompiledType[];
     aliases: CompiledAlias[];
     meta: {
@@ -61,8 +62,8 @@ export type CompiledCatalog = {
         security?: string[];
     }>;
     wsdlTargetNS: string;
-    serviceName?: string;
     wsdlUri: string;
+    serviceName?: string;
 };
 /**
  * Compile a WSDL catalog into an internal representation (CompiledCatalog).
@@ -74,5 +75,5 @@ export type CompiledCatalog = {
  * 4. Extract WSDL operations: pick the appropriate SOAP binding (v1.1 or v1.2), resolve its
  *    portType reference, then enumerate operations and their soapAction URIs.
  */
-export declare function compileCatalog(cat: WsdlCatalog, _opts: CompilerOptions): CompiledCatalog;
+export declare function compileCatalog(cat: WsdlCatalog, options: CompilerOptions): CompiledCatalog;
 //# sourceMappingURL=schemaCompiler.d.ts.map

package/dist/compiler/schemaCompiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAIzD,MAAM,MAAM,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;KAC/C,CAAC;IACF,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,KAAK,CAAC;QACrB,aAAa,CAAC,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA6DF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAmhBxF"}
+{"version":3,"file":"schemaCompiler.d.ts","sourceRoot":"","sources":["../../src/compiler/schemaCompiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAIzD,MAAM,MAAM,KAAK,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;QAC9B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC;QAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;KAC/C,CAAC;IACF,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,KAAK,CAAC;QACrB,aAAa,CAAC,EAAE,KAAK,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA6DF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,eAAe,CAohB1F"}

package/dist/compiler/schemaCompiler.js

@@ -1,4 +1,4 @@
-import { getChildrenWithLocalName, getFirstWithLocalName, normalizeArray, pascal, resolveQName, } from "../util/xml.js";
+import { getChildrenWithLocalName, getFirstWithLocalName, normalizeArray, pascal, resolveQName, } from "../util/tools.js";
 import { xsdToTsPrimitive } from "../xsd/primitives.js";
 const XS = "http://www.w3.org/2001/XMLSchema";
 function qkey(q) {
@@ -73,7 +73,7 @@ function collectSecurityFromPolicyNodes(policyNodes) {
  * 4. Extract WSDL operations: pick the appropriate SOAP binding (v1.1 or v1.2), resolve its
  *    portType reference, then enumerate operations and their soapAction URIs.
  */
-export function compileCatalog(cat, _opts) {
+export function compileCatalog(cat, options) {
     // symbol tables discovered across all schemas
     const complexTypes = new Map();
     const simpleTypes = new Map();
@@ -123,13 +123,13 @@ export function compileCatalog(cat, _opts) {
                 const union = enums.map((v) => JSON.stringify(v)).join(" | ");
                 return { tsType: union, declared, jsdoc: JSON.stringify({ kind: "enum", values: enums }) };
             }
-            return { tsType: xsdToTsPrimitive(declared, _opts?.primitive), declared };
+            return { tsType: xsdToTsPrimitive(declared, options?.primitive), declared };
         }
         const list = getFirstWithLocalName(simpleNode, "list");
         if (list?.["@_itemType"]) {
             const q = resolveQName(list["@_itemType"], schemaNS, prefixes);
             const declared = q.ns === XS ? `xs:${q.local}` : `{${q.ns}}${q.local}`;
-            return { tsType: `${xsdToTsPrimitive(declared, _opts?.primitive)}[]`, declared };
+            return { tsType: `${xsdToTsPrimitive(declared, options?.primitive)}[]`, declared };
         }
         // fallback
         return { tsType: "string", declared: "xs:string" };
@@ -153,7 +153,7 @@ export function compileCatalog(cat, _opts) {
         }
         if (q.ns === XS) {
             const label = `xs:${q.local}`;
-            return { tsType: xsdToTsPrimitive(label, _opts?.primitive), declared: label };
+            return { tsType: xsdToTsPrimitive(label, options?.primitive), declared: label };
         }
         const k = qkey(q);
         const srec = simpleTypes.get(k);
@@ -394,7 +394,7 @@ export function compileCatalog(cat, _opts) {
                     name: outName,
                     ns: schemaNS,
                     attrs: [],
-                    elems: [{ name: "$value", tsType: xsdToTsPrimitive(label, _opts?.primitive), min: 0, max: 1, nillable: false, declaredType: label }],
+                    elems: [{ name: "$value", tsType: xsdToTsPrimitive(label, options?.primitive), min: 0, max: 1, nillable: false, declaredType: label }],
                 };
                 compiledMap.set(key, t);
                 return t;
@@ -571,12 +571,13 @@ export function compileCatalog(cat, _opts) {
     });
     serviceName = serviceUsingBinding?.["@_name"] || serviceDefs[0]?.["@_name"];
     return {
+        options: options,
         types: typesList,
         aliases: aliasList,
         meta: { attrSpec, childType, propMeta },
         operations: ops,
         wsdlTargetNS: defs?.["@_targetNamespace"] || "",
         serviceName,
-        wsdlUri: cat.wsdlUri,
+        wsdlUri: cat.wsdlUri
     };
 }

package/dist/config.d.ts

@@ -3,38 +3,27 @@ import type { PrimitiveOptions } from "./xsd/primitives.js";
  * Options to control WSDL-to-TypeScript compilation behavior.
  */
 export type CompilerOptions = {
-    /**
-     * How to represent XML <choice> elements: as all-optional properties or a discriminated union.
-     */
+    /** Path/URL of the source WSDL (from --wsdl) */
+    wsdl: string;
+    /** Output directory (from --out) */
+    out: string;
+    /** Import-extension mode (from --imports) */
+    imports: "js" | "ts" | "bare";
+    /** Emit catalog.json file with complied catalog object */
+    catalog: boolean;
+    /** Low-level mapping of XSD primitives (from --int64-as, --bigint-as, etc.) */
+    primitive: PrimitiveOptions;
+    /** How to represent XML <choice> elements: as all-optional props or a discriminated union. */
     choice?: "all-optional" | "union";
-    /**
-     * Legacy flag: map all date/time/duration types to string or Date. Superceded by primitive.dateAs if set.
-     */
-    dateAs?: "string" | "date";
-    /**
-     * Legacy flag: shorthand for int64As and bigIntegerAs. Maps integer types to number or string.
-     */
-    intAs?: "number" | "string";
-    /**
-     * Emit errors if any type references cannot be resolved in the WSDL schema.
-     */
+    /** Emit errors if any type references cannot be resolved in the WSDL schema. */
     failOnUnresolved?: boolean;
-    /**
-     * Attribute bag key for the runtime mapper (node-soap).
-     */
+    /** Attribute bag key for the runtime mapper (from --attributes-key). */
     attributesKey?: string;
-    /**
-     * Optional override for the generated client class name.
-     * If provided, the emitter will export this exact class name.
-     */
+    /** Override the generated client class name (from --client-name). */
     clientName?: string;
-    /**
-     * Controls low-level mapping of XSD primitives to TypeScript types. Safe defaults are provided.
-     */
-    primitive?: PrimitiveOptions;
 };
 /**
  * Default compiler options. Users may override selectively.
  */
-export declare const defaultOptions: CompilerOptions;
+export declare const TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS: CompilerOptions;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,SAAS,EAAE,gBAAgB,CAAC;IAC5B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IAClC,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+CAA+C,EAAE,eAe7D,CAAC"}

package/dist/config.js

@@ -1,10 +1,19 @@
 /**
  * Default compiler options. Users may override selectively.
  */
-export const defaultOptions = {
-    choice: "all-optional",
-    dateAs: "string",
-    intAs: "number",
-    failOnUnresolved: false,
-    attributesKey: "$attributes",
+export const TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS = {
+    wsdl: "", // no default, required via CLI
+    out: "", // no default, required via CLI
+    imports: "js", // CLI default
+    catalog: true, // CLI default
+    primitive: {
+        int64As: "string",
+        bigIntegerAs: "string",
+        decimalAs: "string",
+        dateAs: "string",
+    },
+    choice: "all-optional", // CLI default
+    failOnUnresolved: false, // CLI default
+    attributesKey: "$attributes", // CLI default
+    clientName: undefined, // no default
 };

package/dist/emit/catalogEmitter.d.ts

@@ -0,0 +1,3 @@
+import type { CompiledCatalog } from "../compiler/schemaCompiler.js";
+export declare function emitCatalog(outFile: string, compiled: CompiledCatalog): void;
+//# sourceMappingURL=catalogEmitter.d.ts.map

package/dist/emit/catalogEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogEmitter.d.ts","sourceRoot":"","sources":["../../src/emit/catalogEmitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAEnE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QAOrE"}

package/dist/emit/catalogEmitter.js

@@ -0,0 +1,10 @@
+import fs from "node:fs";
+export function emitCatalog(outFile, compiled) {
+    try {
+        fs.writeFileSync(outFile, JSON.stringify(compiled, null, 2), "utf8");
+        console.log(`Catalog written to ${outFile}`);
+    }
+    catch (err) {
+        console.error(`Failed to write catalog to ${outFile}:`, err);
+    }
+}

package/dist/emit/clientEmitter.d.ts

@@ -1,6 +1,3 @@
 import type { CompiledCatalog } from "../compiler/schemaCompiler.js";
-import type { CompilerOptions } from "../config.js";
-export declare function emitClient(outFile: string, compiled: CompiledCatalog, opts: CompilerOptions & {
-    importExt?: string;
-}): void;
+export declare function emitClient(outFile: string, compiled: CompiledCatalog): void;
 //# sourceMappingURL=clientEmitter.d.ts.map

package/dist/emit/clientEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientEmitter.d.ts","sourceRoot":"","sources":["../../src/emit/clientEmitter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,QAmEpH"}
+{"version":3,"file":"clientEmitter.d.ts","sourceRoot":"","sources":["../../src/emit/clientEmitter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAGnE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,QA4VpE"}