@techspokes/typescript-wsdl-client 0.5.1 → 0.6.1

package/README.md

@@ -79,7 +79,7 @@ console.log(response);
 
 ## Features
 
-- **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.
+- **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.
@@ -117,6 +117,7 @@ wsdl-tsc --wsdl <path-or-url> --out <dir> [options]
 | `--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                   |
+| `--nillable-as-optional` | boolean | true, false                    | false          | Treat nillable elements as optional properties in types          |
 
 ---
 
@@ -159,6 +160,7 @@ await compileWsdlToProject({
     failOnUnresolved: true,
     attributesKey: "$attributes",
     clientName: "MyServiceClient",
+    nillableAsOptional: false,
   },
 });
 ```
@@ -168,18 +170,18 @@ await compileWsdlToProject({
 ## Troubleshooting
 
 - 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`.  
+  • "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`.  
+  • "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`).  
+  • "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
@@ -212,7 +214,7 @@ MIT © TechSpokes.
 
 ---
 
-## 💖 Sponsors
+## Sponsors
 
 **Silver Sponsors**
 - Your Name Here!

package/dist/cli.js

@@ -76,6 +76,11 @@ const argv = await yargs(hideBin(process.argv))
     type: "boolean",
     default: true,
     desc: "Emit errors if any type references cannot be resolved in the WSDL schema",
+})
+    .option("nillable-as-optional", {
+    type: "boolean",
+    default: false,
+    desc: "Emit nillable elements as optional properties in types.",
 })
     .strict()
     .help()
@@ -98,6 +103,7 @@ const compiled = compileCatalog(catalog, {
     failOnUnresolved: argv["fail-on-unresolved"],
     attributesKey: argv["attributes-key"],
     clientName: argv["client-name"],
+    nillableAsOptional: argv["nillable-as-optional"],
 });
 // Report counts of types and operations for user visibility
 console.log(`Schemas discovered: ${catalog.schemas.length}`);

package/dist/config.d.ts

@@ -21,6 +21,8 @@ export type CompilerOptions = {
     attributesKey?: string;
     /** Override the generated client class name (from --client-name). */
     clientName?: string;
+    /** Emit nillable elements as optional properties in types. */
+    nillableAsOptional?: boolean;
 };
 /**
  * Default compiler options. Users may override selectively.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"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;IACpB,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+CAA+C,EAAE,eAgB7D,CAAC"}

package/dist/config.js

@@ -16,4 +16,5 @@ export const TYPESCRIPT_WSDL_CLIENT_DEFAULT_COMPLIER_OPTIONS = {
     failOnUnresolved: false, // CLI default
     attributesKey: "$attributes", // CLI default
     clientName: undefined, // no default
+    nillableAsOptional: false, // CLI default
 };

package/dist/emit/typesEmitter.js

@@ -116,7 +116,7 @@ export function emitTypes(outFile, compiled) {
         for (const e of elementsToEmit) {
             const isArray = e.max === "unbounded" || (e.max > 1);
             const arr = isArray ? "[]" : "";
-            const opt = (e.min ?? 0) === 0 ? "?" : "";
+            const opt = (compiled.options.nillableAsOptional && e.nillable) || (e.min ?? 0) === 0 ? "?" : "";
             const annObj = {
                 // if a.name === "$value", the kind should be "scalar value"
                 kind: e.name === "$value" ? "scalar value" : "element",

package/dist/index.js

@@ -40,7 +40,7 @@ export async function compileWsdlToProject(input) {
     }
     // Emit artifacts
     const typesFile = path.join(input.outDir, "types.ts");
-    const metaFile = path.join(input.outDir, "meta.ts");
+    const utilsFile = path.join(input.outDir, "utils.ts");
     const catalogFile = path.join(input.outDir, "catalog.json");
     const clientFile = path.join(input.outDir, "client.ts");
     // Prepare output dir
@@ -53,7 +53,7 @@ export async function compileWsdlToProject(input) {
     // Emit files
     emitClient(clientFile, compiled);
     emitTypes(typesFile, compiled);
-    emitUtils(metaFile, compiled);
+    emitUtils(utilsFile, compiled);
     if (compiled.options.catalog) {
         emitCatalog(catalogFile, compiled);
     }

package/package.json

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