@techspokes/typescript-wsdl-client 0.9.1 → 0.9.2

package/dist/cli.js

@@ -26,10 +26,12 @@ import { emitClientArtifacts, handleCLIError, parseServers, parseStatusCodes, re
 import { buildCompilerOptionsFromArgv, buildOpenApiOptionsFromArgv } from "./util/builder.js";
 // Process command line arguments, removing the first two elements (node executable and script path)
 const rawArgs = hideBin(process.argv);
+// Available commands
+const COMMANDS = ["compile", "client", "openapi", "gateway", "app", "pipeline"];
 // ---------------------------------------------------------------------------
 // Show help if no subcommand provided
 // ---------------------------------------------------------------------------
-if (!rawArgs[0] || !["compile", "client", "openapi", "gateway", "pipeline"].includes(rawArgs[0])) {
+if (!rawArgs[0] || !COMMANDS.includes(rawArgs[0])) {
     await yargs(rawArgs)
         .version(false)
         .scriptName("wsdl-tsc")
@@ -38,8 +40,9 @@ if (!rawArgs[0] || !["compile", "client", "openapi", "gateway", "pipeline"].incl
         .command("client", "Generate TypeScript SOAP client from WSDL or catalog")
         .command("openapi", "Generate OpenAPI specification from WSDL or catalog")
         .command("gateway", "Generate Fastify gateway from OpenAPI specification")
+        .command("app", "Generate runnable Fastify application from client + gateway + OpenAPI")
         .command("pipeline", "Run full generation pipeline (client + OpenAPI + gateway)")
-        .demandCommand(1, "Please specify a command: compile, client, openapi, gateway, or pipeline")
+        .demandCommand(1, `Please specify a command: ${COMMANDS.join(", ")}`)
         .strict()
         .help()
         .parse();
@@ -389,6 +392,117 @@ if (rawArgs[0] === "gateway") {
     success(`Gateway code generated in ${outDir}`);
     process.exit(0);
 }
+/**
+ * Command handler for "app" subcommand
+ *
+ * This branch handles the Fastify application generation mode, which creates a runnable
+ * Fastify server that uses the generated gateway plugin and SOAP client.
+ */
+if (rawArgs[0] === "app") {
+    const { generateApp } = await import("./app/generateApp.js");
+    const appArgv = await yargs(rawArgs.slice(1))
+        .version(false)
+        .scriptName("wsdl-tsc app")
+        .usage("$0 --client-dir <dir> --gateway-dir <dir> --openapi-file <file> [--catalog-file <file>] [--app-dir <dir>] [options]")
+        .option("client-dir", {
+        type: "string",
+        demandOption: true,
+        desc: "Path to client directory (where client.ts is located)"
+    })
+        .option("gateway-dir", {
+        type: "string",
+        demandOption: true,
+        desc: "Path to gateway directory (where plugin.ts is located)"
+    })
+        .option("openapi-file", {
+        type: "string",
+        demandOption: true,
+        desc: "Path to OpenAPI spec file"
+    })
+        .option("catalog-file", {
+        type: "string",
+        desc: "Path to catalog.json (default: {client-dir}/catalog.json)"
+    })
+        .option("app-dir", {
+        type: "string",
+        desc: "Output directory for generated app (default: sibling to gateway-dir, named 'app')"
+    })
+        .option("import-extensions", {
+        type: "string",
+        choices: ["js", "ts", "bare"],
+        desc: "Import-extension mode for generated TypeScript modules (inferred from catalog when available)"
+    })
+        .option("host", {
+        type: "string",
+        default: "127.0.0.1",
+        desc: "Default server host"
+    })
+        .option("port", {
+        type: "number",
+        default: 3000,
+        desc: "Default server port"
+    })
+        .option("prefix", {
+        type: "string",
+        default: "",
+        desc: "Route prefix"
+    })
+        .option("logger", {
+        type: "boolean",
+        default: true,
+        desc: "Enable Fastify logger"
+    })
+        .option("openapi-mode", {
+        type: "string",
+        choices: ["copy", "reference"],
+        default: "copy",
+        desc: "How to handle OpenAPI file: copy into app dir or reference original"
+    })
+        .strict()
+        .help()
+        .parse();
+    const clientDir = path.resolve(String(appArgv["client-dir"]));
+    const gatewayDir = path.resolve(String(appArgv["gateway-dir"]));
+    const openapiFile = path.resolve(String(appArgv["openapi-file"]));
+    // Determine catalog file path
+    const catalogFile = appArgv["catalog-file"]
+        ? path.resolve(String(appArgv["catalog-file"]))
+        : path.join(clientDir, "catalog.json");
+    // Determine app directory (default: sibling to gateway-dir, named 'app')
+    const appDir = appArgv["app-dir"]
+        ? path.resolve(String(appArgv["app-dir"]))
+        : path.join(path.dirname(gatewayDir), "app");
+    // Infer import-extensions from catalog if not explicitly provided
+    let imports = appArgv["import-extensions"];
+    if (!imports && fs.existsSync(catalogFile)) {
+        try {
+            const catalogContent = fs.readFileSync(catalogFile, "utf-8");
+            const catalog = JSON.parse(catalogContent);
+            imports = catalog?.options?.imports || "js";
+        }
+        catch (err) {
+            // If catalog read fails, fall back to "js"
+            imports = "js";
+        }
+    }
+    else if (!imports) {
+        imports = "js";
+    }
+    await generateApp({
+        clientDir,
+        gatewayDir,
+        openapiFile,
+        catalogFile,
+        appDir,
+        imports,
+        host: String(appArgv.host),
+        port: Number(appArgv.port),
+        prefix: String(appArgv.prefix),
+        logger: Boolean(appArgv.logger),
+        openapiMode: appArgv["openapi-mode"],
+    });
+    process.exit(0);
+}
 if (rawArgs[0] === "pipeline") {
     const pipelineArgv = await yargs(rawArgs.slice(1))
         .version(false)
@@ -487,6 +601,22 @@ if (rawArgs[0] === "pipeline") {
         type: "boolean",
         default: false,
         desc: "Skip generating runtime.ts utilities"
+    })
+        // App generation flags
+        .option("generate-app", {
+        type: "boolean",
+        default: false,
+        desc: "Generate runnable Fastify application (requires --client-dir, --gateway-dir, --openapi-file)"
+    })
+        .option("app-dir", {
+        type: "string",
+        desc: "Output directory for generated app (default: sibling to gateway-dir, named 'app')"
+    })
+        .option("app-openapi-mode", {
+        type: "string",
+        choices: ["copy", "reference"],
+        default: "copy",
+        desc: "How to handle OpenAPI file in app: copy or reference"
     })
         .strict()
         .help()
@@ -550,6 +680,13 @@ if (rawArgs[0] === "pipeline") {
     const openApiOptions = openapiOut
         ? buildOpenApiOptionsFromArgv(pipelineArgv, format, servers)
         : undefined;
+    // Validate app generation requirements
+    const generateApp = pipelineArgv["generate-app"];
+    if (generateApp) {
+        if (!clientOut || !gatewayOut || !openapiOut) {
+            handleCLIError("--generate-app requires --client-dir, --gateway-dir, and --openapi-file to be set");
+        }
+    }
     await runGenerationPipeline({
         wsdl: pipelineArgv["wsdl-source"],
         clientOutDir: clientOut ? path.resolve(clientOut) : undefined,
@@ -570,6 +707,12 @@ if (rawArgs[0] === "pipeline") {
             emitPlugin: pipelineArgv["gateway-skip-plugin"] ? false : undefined,
             emitRuntime: pipelineArgv["gateway-skip-runtime"] ? false : undefined,
         } : undefined,
+        app: generateApp ? {
+            appDir: pipelineArgv["app-dir"]
+                ? path.resolve(pipelineArgv["app-dir"])
+                : path.join(path.dirname(path.resolve(gatewayOut)), "app"),
+            openapiMode: pipelineArgv["app-openapi-mode"],
+        } : undefined,
     });
     process.exit(0);
 }

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,EAA+B,MAAM,cAAc,CAAC;AAEjG;;;;;;;;;;;;;;;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,CA0BxB;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":"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"}

package/dist/gateway/generators.js

@@ -12,7 +12,7 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { rewriteSchemaRefs, slugName, } from "./helpers.js";
+import { flattenAllOf, rewriteSchemaRefs, slugName, } from "./helpers.js";
 /**
  * Emits individual JSON Schema files for each OpenAPI component schema
  *
@@ -42,10 +42,13 @@ export function emitModelSchemas(schemas, modelsDir, versionSlug, serviceSlug) {
         modelSlugByName[name] = slug;
         schemaIdByName[name] = `urn:services:${serviceSlug}:${versionSlug}:schemas:models:${slug}`;
     }
-    // Second pass: rewrite refs and emit files
+    // Second pass: flatten allOf, rewrite refs, and emit files
     for (const [name, schema] of Object.entries(schemas)) {
         const slug = modelSlugByName[name];
-        const cloned = rewriteSchemaRefs(schema, schemaIdByName);
+        // Flatten allOf compositions for Fastify/fast-json-stringify compatibility
+        const flattened = flattenAllOf(schema, schemas);
+        // Rewrite $refs to URN format
+        const cloned = rewriteSchemaRefs(flattened, schemaIdByName);
         cloned.$id = schemaIdByName[name];
         const outPath = path.join(modelsDir, `${slug}.json`);
         fs.writeFileSync(outPath, JSON.stringify(cloned, null, 2), "utf8");

package/dist/gateway/helpers.d.ts

@@ -61,6 +61,24 @@ export declare function isNumericStatus(code: string): boolean;
  * @throws {Error} If unknown schema reference is encountered
  */
 export declare function rewriteSchemaRefs(node: any, schemaIdByName: Record<string, string>): any;
+/**
+ * Flattens allOf compositions into a single merged schema for Fastify compatibility.
+ *
+ * This is necessary because fast-json-stringify cannot handle deeply nested allOf
+ * compositions, especially when referenced schemas also use allOf for inheritance.
+ *
+ * The function:
+ * - Recursively resolves $ref references within allOf members
+ * - Merges properties, required arrays, and other keywords
+ * - Handles circular references by keeping them as $ref
+ * - Preserves anyOf/oneOf without flattening (only allOf is problematic)
+ *
+ * @param {any} schema - The schema to flatten
+ * @param {Record<string, any>} allSchemas - All available schemas for $ref resolution
+ * @param {Set<string>} [visited] - Set of visited schema names to detect circular references
+ * @returns {any} - Flattened schema without allOf (or original if no allOf present)
+ */
+export declare function flattenAllOf(schema: any, allSchemas: Record<string, any>, visited?: Set<string>): any;
 /**
  * Extracts the component schema name from a $ref object
  *

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

@@ -77,6 +77,123 @@ export function rewriteSchemaRefs(node, schemaIdByName) {
     }
     return node;
 }
+/**
+ * Flattens allOf compositions into a single merged schema for Fastify compatibility.
+ *
+ * This is necessary because fast-json-stringify cannot handle deeply nested allOf
+ * compositions, especially when referenced schemas also use allOf for inheritance.
+ *
+ * The function:
+ * - Recursively resolves $ref references within allOf members
+ * - Merges properties, required arrays, and other keywords
+ * - Handles circular references by keeping them as $ref
+ * - Preserves anyOf/oneOf without flattening (only allOf is problematic)
+ *
+ * @param {any} schema - The schema to flatten
+ * @param {Record<string, any>} allSchemas - All available schemas for $ref resolution
+ * @param {Set<string>} [visited] - Set of visited schema names to detect circular references
+ * @returns {any} - Flattened schema without allOf (or original if no allOf present)
+ */
+export function flattenAllOf(schema, allSchemas, visited = new Set()) {
+    if (!schema || typeof schema !== "object") {
+        return schema;
+    }
+    // Handle arrays
+    if (Array.isArray(schema)) {
+        return schema.map(item => flattenAllOf(item, allSchemas, visited));
+    }
+    // If no allOf, recursively process nested schemas but preserve structure
+    if (!schema.allOf) {
+        const result = {};
+        for (const [key, value] of Object.entries(schema)) {
+            if (key === "properties" && value && typeof value === "object") {
+                result[key] = {};
+                for (const [propName, propSchema] of Object.entries(value)) {
+                    result[key][propName] = flattenAllOf(propSchema, allSchemas, visited);
+                }
+            }
+            else if (key === "items" && value && typeof value === "object") {
+                result[key] = flattenAllOf(value, allSchemas, visited);
+            }
+            else if ((key === "anyOf" || key === "oneOf") && Array.isArray(value)) {
+                result[key] = value.map(v => flattenAllOf(v, allSchemas, visited));
+            }
+            else if (key === "additionalProperties" && value && typeof value === "object") {
+                result[key] = flattenAllOf(value, allSchemas, visited);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    // Flatten allOf: merge all schemas into one
+    const merged = {
+        type: "object",
+        properties: {},
+    };
+    const requiredSet = new Set();
+    for (const member of schema.allOf) {
+        let resolvedMember = member;
+        // Resolve $ref if present
+        if (member.$ref && typeof member.$ref === "string") {
+            const refPath = member.$ref;
+            let schemaName = null;
+            if (refPath.startsWith("#/components/schemas/")) {
+                schemaName = refPath.slice("#/components/schemas/".length);
+            }
+            if (schemaName && allSchemas[schemaName]) {
+                if (visited.has(schemaName)) {
+                    // Circular reference - keep the $ref as-is in properties that reference it
+                    continue;
+                }
+                const newVisited = new Set(visited);
+                newVisited.add(schemaName);
+                resolvedMember = flattenAllOf(allSchemas[schemaName], allSchemas, newVisited);
+            }
+            else {
+                // Unknown ref - keep as-is (will be rewritten later by rewriteSchemaRefs)
+                continue;
+            }
+        }
+        // Merge properties
+        if (resolvedMember.properties && typeof resolvedMember.properties === "object") {
+            for (const [propName, propSchema] of Object.entries(resolvedMember.properties)) {
+                merged.properties[propName] = flattenAllOf(propSchema, allSchemas, visited);
+            }
+        }
+        // Merge required
+        if (Array.isArray(resolvedMember.required)) {
+            for (const req of resolvedMember.required) {
+                requiredSet.add(req);
+            }
+        }
+        // Copy other keywords (last one wins for conflicts)
+        if (resolvedMember.additionalProperties !== undefined) {
+            merged.additionalProperties = resolvedMember.additionalProperties;
+        }
+        if (resolvedMember.description !== undefined) {
+            merged.description = resolvedMember.description;
+        }
+        if (resolvedMember.title !== undefined) {
+            merged.title = resolvedMember.title;
+        }
+    }
+    // Apply description from the original allOf schema if present (overrides merged)
+    if (schema.description !== undefined) {
+        merged.description = schema.description;
+    }
+    // Convert required set to array
+    if (requiredSet.size > 0) {
+        merged.required = Array.from(requiredSet).sort();
+    }
+    // Clean up empty properties object
+    if (Object.keys(merged.properties).length === 0) {
+        delete merged.properties;
+        delete merged.type; // No properties means we shouldn't force type: object
+    }
+    return merged;
+}
 /**
  * Extracts the component schema name from a $ref object
  *

package/dist/openapi/generateSchemas.js

@@ -126,8 +126,7 @@ function buildComplexSchema(t, closed, knownTypeNames, aliasNames) {
         obj.allOf = [{ $ref: `#/components/schemas/${baseName}` }, { ...obj }];
         delete obj.type; // inner object part handled in allOf
         delete obj.properties;
-        if (!required.length)
-            delete obj.required;
+        delete obj.required; // Always remove from top-level; it's already in the allOf member
         if (!closed)
             delete obj.additionalProperties; // put closed only on leaf part
     }

package/dist/pipeline.d.ts

@@ -15,6 +15,9 @@ import { type CompilerOptions } from "./config.js";
  * @property {string} gateway.outDir - Output directory for gateway code
  * @property {string} gateway.versionSlug - Version identifier for URN generation (required)
  * @property {string} gateway.serviceSlug - Service identifier for URN generation (required)
+ * @property {object} [app] - App generation configuration (optional, requires client, gateway, and openapi)
+ * @property {string} app.appDir - Output directory for generated Fastify app
+ * @property {"copy"|"reference"} [app.openapiMode] - How to handle OpenAPI file (default: "copy")
  */
 export interface PipelineOptions {
     wsdl: string;
@@ -29,9 +32,13 @@ export interface PipelineOptions {
         versionSlug: string;
         serviceSlug: string;
     };
+    app?: {
+        appDir: string;
+        openapiMode?: "copy" | "reference";
+    };
 }
 /**
- * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway
+ * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway/App
  *
  * This function orchestrates the entire process:
  * 1. Loads and parses the WSDL from file or URL
@@ -40,6 +47,7 @@ export interface PipelineOptions {
  * 4. Optionally emits a JSON catalog for introspection
  * 5. Optionally generates an OpenAPI 3.1 specification
  * 6. Optionally generates Fastify gateway code from the OpenAPI spec
+ * 7. Optionally generates a runnable Fastify app that uses client and gateway
  *
  * @param {PipelineOptions} opts - Configuration options for the pipeline
  * @returns {Promise<{compiled: any; openapiDoc?: any}>} - The compiled catalog and optional OpenAPI document

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAGzE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CA+FhH"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAkB,KAAK,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAC,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAGzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1G,OAAO,CAAC,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;KACpC,CAAC;CACH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,CAAC;CAAE,CAAC,CAmHhH"}

package/dist/pipeline.js

@@ -19,7 +19,7 @@ import { generateGateway } from "./gateway/generateGateway.js";
 import { resolveCompilerOptions } from "./config.js";
 import { emitClientArtifacts, reportCompilationStats, reportOpenApiSuccess, success } from "./util/cli.js";
 /**
- * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway
+ * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway/App
  *
  * This function orchestrates the entire process:
  * 1. Loads and parses the WSDL from file or URL
@@ -28,6 +28,7 @@ import { emitClientArtifacts, reportCompilationStats, reportOpenApiSuccess, succ
  * 4. Optionally emits a JSON catalog for introspection
  * 5. Optionally generates an OpenAPI 3.1 specification
  * 6. Optionally generates Fastify gateway code from the OpenAPI spec
+ * 7. Optionally generates a runnable Fastify app that uses client and gateway
  *
  * @param {PipelineOptions} opts - Configuration options for the pipeline
  * @returns {Promise<{compiled: any; openapiDoc?: any}>} - The compiled catalog and optional OpenAPI document
@@ -101,6 +102,23 @@ export async function runGenerationPipeline(opts) {
         });
         success(`Gateway code generated in ${gatewayOutDir}`);
     }
+    // Step 6: Optionally generate Fastify app
+    if (opts.app) {
+        // App generation requires client, gateway, and openapi to be generated
+        if (!opts.clientOutDir || !opts.gateway?.outDir || !opts.openapi?.outFile) {
+            throw new Error("App generation requires client, gateway, and OpenAPI to be generated in the pipeline");
+        }
+        const { generateApp } = await import("./app/generateApp.js");
+        await generateApp({
+            clientDir: path.resolve(opts.clientOutDir),
+            gatewayDir: path.resolve(opts.gateway.outDir),
+            openapiFile: path.resolve(opts.openapi.outFile),
+            catalogFile: path.resolve(opts.catalogOut),
+            appDir: path.resolve(opts.app.appDir),
+            imports: finalCompiler.imports,
+            openapiMode: opts.app.openapiMode || "copy",
+        });
+    }
     // Return the compiled catalog and OpenAPI doc for potential further processing
     return { compiled, openapiDoc };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techspokes/typescript-wsdl-client",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "TypeScript WSDL → SOAP client generator with full xs:attribute support, complex types, sequences, inheritance, and namespace-collision merging.",
   "keywords": [
     "wsdl",
@@ -57,8 +57,9 @@
     "smoke:client": "rimraf tmp && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client && tsc -p tsconfig.smoke.json",
     "smoke:openapi": "rimraf tmp && tsx src/cli.ts openapi --wsdl-source examples/minimal/weather.wsdl --openapi-file tmp/openapi.json --openapi-format json && tsc -p tsconfig.smoke.json",
     "smoke:gateway": "rimraf tmp && tsx src/cli.ts client --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client && tsx src/cli.ts openapi --catalog-file tmp/client/catalog.json --openapi-file tmp/openapi.json --openapi-format json && tsx src/cli.ts gateway --openapi-file tmp/openapi.json --client-dir tmp/client --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 && tsc -p tsconfig.smoke.json",
+    "smoke:app": "rimraf tmp && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client --openapi-file tmp/openapi.json --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --openapi-servers https://example.com/api --generate-app && tsc -p tsconfig.smoke.json",
     "smoke:pipeline": "rimraf tmp && tsx src/cli.ts pipeline --wsdl-source examples/minimal/weather.wsdl --client-dir tmp/client --openapi-file tmp/openapi.json --gateway-dir tmp/gateway --gateway-service-name weather --gateway-version-prefix v1 --openapi-format json --openapi-servers https://example.com/api && tsc -p tsconfig.smoke.json",
-    "ci": "npm run build && npm run typecheck && npm run smoke:pipeline"
+    "ci": "npm run build && npm run typecheck && npm run smoke:app"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",