@techspokes/typescript-wsdl-client 0.11.0 → 0.11.3

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"generateApp.d.ts","sourceRoot":"","sources":["../../src/app/generateApp.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;;;;;;;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;AAklBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDzE"}

package/dist/app/generateApp.js

@@ -25,6 +25,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { deriveClientName } from "../util/tools.js";
 import { info, success } from "../util/cli.js";
+import { computeRelativeImport, getImportExtension } from "../util/imports.js";
 /**
  * Validates that all required files and directories exist
  *
@@ -73,11 +74,7 @@ function validateRequiredFiles(opts) {
  * @returns {string} - File extension with leading dot or empty string for bare
  */
 function getExtension(imports) {
-    if (imports === "js")
-        return ".js";
-    if (imports === "ts")
-        return ".ts";
-    return "";
+    return getImportExtension(imports);
 }
 /**
  * Returns the file extension for scaffold app files (server, config).
@@ -88,27 +85,7 @@ function getExtension(imports) {
 function getAppFileExtension() {
     return ".ts";
 }
-/**
- * Computes a relative import path from source to target
- *
- * @param {string} from - Source directory
- * @param {string} to - Target file or directory
- * @param {string} imports - Import mode (js, ts, or bare)
- * @returns {string} - Relative import specifier with proper extension
- */
-function computeRelativeImport(from, to, imports) {
-    const rel = path.relative(from, to);
-    // Normalize to POSIX separators
-    const posix = rel.split(path.sep).join("/");
-    // Ensure it starts with ./ or ../
-    const prefixed = posix.startsWith(".") ? posix : `./${posix}`;
-    // Apply import extension rules
-    const ext = getExtension(imports);
-    if (ext) {
-        return prefixed + ext;
-    }
-    return prefixed;
-}
+// computeRelativeImport is now imported from ../util/imports.js
 /**
  * Checks if a string is a URL (http:// or https://)
  */

package/dist/cli.js

@@ -665,6 +665,16 @@ if (rawArgs[0] === "pipeline") {
         type: "string",
         default: "",
         desc: "Route prefix for app scaffold"
+    })
+        // Test generation flags
+        .option("test-dir", {
+        type: "string",
+        desc: "Output directory for generated Vitest test suite"
+    })
+        .option("force-test", {
+        type: "boolean",
+        default: false,
+        desc: "Overwrite existing test files when using --test-dir"
     })
         .strict()
         .help()
@@ -741,6 +751,14 @@ if (rawArgs[0] === "pipeline") {
             handleCLIError("--init-app requires --client-dir, --gateway-dir, and --openapi-file to be set");
         }
     }
+    // Validate test generation requirements
+    const testDir = pipelineArgv["test-dir"];
+    const forceTest = pipelineArgv["force-test"];
+    if (testDir) {
+        if (!clientOut || !gatewayOut) {
+            handleCLIError("--test-dir requires --client-dir and --gateway-dir to be set");
+        }
+    }
     await runGenerationPipeline({
         wsdl: pipelineArgv["wsdl-source"],
         clientOutDir: clientOut ? path.resolve(clientOut) : undefined,
@@ -771,6 +789,10 @@ if (rawArgs[0] === "pipeline") {
             port: pipelineArgv["app-port"],
             prefix: pipelineArgv["app-prefix"],
         } : undefined,
+        test: testDir ? {
+            testDir: path.resolve(testDir),
+            force: forceTest,
+        } : undefined,
     });
     process.exit(0);
 }

package/dist/gateway/generators.js

@@ -467,7 +467,7 @@ export function classifyError(err: unknown): ClassifiedError {
       httpStatus: 400,
       code: "VALIDATION_ERROR",
       message: "Request validation failed",
-      details: (err as Record<string, unknown>).validation,
+      details: { validationErrors: (err as Record<string, unknown>).validation },
     };
   }
 
@@ -494,7 +494,7 @@ export function classifyError(err: unknown): ClassifiedError {
         httpStatus: 503,
         code: "SERVICE_UNAVAILABLE",
         message: "Unable to connect to SOAP service",
-        details: err.message,
+        details: { message: err.message },
       };
     }
     if (err.message.includes("ETIMEDOUT") || err.message.includes("timeout")) {
@@ -502,7 +502,7 @@ export function classifyError(err: unknown): ClassifiedError {
         httpStatus: 504,
         code: "GATEWAY_TIMEOUT",
         message: "SOAP service request timed out",
-        details: err.message,
+        details: { message: err.message },
       };
     }
   }

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import type { CompilerOptions } from "./config.js";
 export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 export { generateGateway } from "./gateway/generateGateway.js";
+export { generateTests } from "./test/generateTests.js";
 export { runGenerationPipeline } from "./pipeline.js";
 /**
  * Compiles a WSDL file to TypeScript client code

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAWjD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAwDf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAC;AAWjD,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,eAAe,EAAC,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAC,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,eAAe,CAAA;CAAE,GACjE,OAAO,CAAC,IAAI,CAAC,CAwDf"}

package/dist/index.js

@@ -24,6 +24,7 @@ import { generateOperations } from "./client/generateOperations.js";
 import { info } from "./util/cli.js";
 export { generateOpenAPI } from "./openapi/generateOpenAPI.js";
 export { generateGateway } from "./gateway/generateGateway.js";
+export { generateTests } from "./test/generateTests.js";
 export { runGenerationPipeline } from "./pipeline.js";
 // noinspection JSUnusedGlobalSymbols
 /**

package/dist/pipeline.d.ts

@@ -40,6 +40,10 @@ export interface PipelineOptions {
         port?: number;
         prefix?: string;
     };
+    test?: {
+        testDir: string;
+        force?: boolean;
+    };
 }
 /**
  * Runs the complete generation pipeline from WSDL to TypeScript artifacts and optionally OpenAPI/Gateway/App

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,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;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,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,CA4HhH"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAiBA,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;QACnC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,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,CAgJhH"}

package/dist/pipeline.js

@@ -128,6 +128,23 @@ export async function runGenerationPipeline(opts) {
             prefix: opts.app.prefix,
         });
     }
+    // Step 7: Optionally generate test suite
+    if (opts.test) {
+        if (!opts.clientOutDir || !opts.gateway?.outDir) {
+            throw new Error("Test generation requires client and gateway to be generated in the pipeline");
+        }
+        const { generateTests } = await import("./test/generateTests.js");
+        await generateTests({
+            testDir: path.resolve(opts.test.testDir),
+            gatewayDir: path.resolve(opts.gateway.outDir),
+            clientDir: path.resolve(opts.clientOutDir),
+            catalogFile: path.resolve(opts.catalogOut),
+            imports: finalCompiler.imports,
+            force: opts.test.force,
+            versionSlug: opts.gateway.versionSlug,
+            serviceSlug: opts.gateway.serviceSlug,
+        });
+    }
     // Return the compiled catalog and OpenAPI doc for potential further processing
     return { compiled, openapiDoc };
 }

package/dist/test/generateTests.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Options for test suite generation
+ */
+export interface GenerateTestsOptions {
+    testDir: string;
+    gatewayDir: string;
+    clientDir: string;
+    catalogFile: string;
+    imports?: "js" | "ts" | "bare";
+    force?: boolean;
+    versionSlug?: string;
+    serviceSlug?: string;
+}
+/**
+ * Generates a complete Vitest test suite for the generated gateway artifacts.
+ *
+ * @param opts - Test generation options
+ */
+export declare function generateTests(opts: GenerateTestsOptions): Promise<void>;
+//# sourceMappingURL=generateTests.d.ts.map

package/dist/test/generateTests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateTests.d.ts","sourceRoot":"","sources":["../../src/test/generateTests.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAuBD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4J7E"}

package/dist/test/generateTests.js

@@ -0,0 +1,136 @@
+/**
+ * Test Suite Generator Orchestrator
+ *
+ * Generates a complete, runnable Vitest test suite that validates all
+ * generated gateway artifacts. Opt-in via --test-dir flag.
+ *
+ * Steps:
+ * 1. Validate gatewayDir, clientDir, catalogFile exist
+ * 2. Read and parse catalog.json
+ * 3. Resolve ClientMeta and OperationMetadata
+ * 4. Create output directories
+ * 5. For each file: skip-if-exists check, then write
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { info, success } from "../util/cli.js";
+import { resolveClientMeta, resolveOperationMeta } from "../gateway/helpers.js";
+import { emitVitestConfig, emitMockClientHelper, emitTestAppHelper, emitRoutesTest, emitErrorsTest, emitEnvelopeTest, emitValidationTest, emitClassifyErrorTest, emitEnvelopeBuildersTest, emitUnwrapTest, } from "./generators.js";
+/**
+ * Checks whether a test file should be written.
+ * Returns true if the file does not exist or force is enabled.
+ * Logs an info message and returns false if the file exists and force is disabled.
+ */
+function shouldWriteTestFile(filePath, force) {
+    if (!fs.existsSync(filePath))
+        return true;
+    if (force)
+        return true;
+    info(`Skipping ${path.basename(filePath)} (already exists, use --force-test to overwrite)`);
+    return false;
+}
+/**
+ * Writes a test file if it should be written (skip-if-exists with force override).
+ */
+function writeTestFile(filePath, content, force) {
+    if (!shouldWriteTestFile(filePath, force))
+        return;
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, "utf-8");
+}
+/**
+ * Generates a complete Vitest test suite for the generated gateway artifacts.
+ *
+ * @param opts - Test generation options
+ */
+export async function generateTests(opts) {
+    const testDir = path.resolve(opts.testDir);
+    const gatewayDir = path.resolve(opts.gatewayDir);
+    const clientDir = path.resolve(opts.clientDir);
+    const catalogFile = path.resolve(opts.catalogFile);
+    const importsMode = opts.imports ?? "js";
+    const force = opts.force ?? false;
+    // Validate required files exist
+    if (!fs.existsSync(gatewayDir)) {
+        throw new Error(`Gateway directory does not exist: ${gatewayDir}`);
+    }
+    if (!fs.existsSync(clientDir)) {
+        throw new Error(`Client directory does not exist: ${clientDir}`);
+    }
+    if (!fs.existsSync(catalogFile)) {
+        throw new Error(`Catalog file does not exist: ${catalogFile}`);
+    }
+    // Read and parse catalog
+    const catalogRaw = fs.readFileSync(catalogFile, "utf-8");
+    const catalog = JSON.parse(catalogRaw);
+    // Resolve client metadata
+    const clientMeta = resolveClientMeta({
+        clientDir,
+        catalogFile,
+        serviceSlug: opts.serviceSlug ?? "service",
+        importsMode,
+    }, catalog);
+    // Build operation metadata from catalog + OpenAPI paths
+    const operations = [];
+    if (catalog.operations) {
+        // Read OpenAPI doc paths from the gateway's generated routes to get URL paths
+        // We use the catalog operations and derive paths using the same pattern as gateway generation
+        for (const op of catalog.operations) {
+            const operationSlug = op.name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+            // Try to find the path from the generated operation schema
+            const opSchemaPath = path.join(gatewayDir, "schemas", "operations", `${operationSlug}.json`);
+            let urlPath = `/${operationSlug.replace(/_/g, "-")}`;
+            if (fs.existsSync(opSchemaPath)) {
+                // Read the route file to extract the actual URL path
+                const routeFilePath = path.join(gatewayDir, "routes", `${operationSlug}.ts`);
+                if (fs.existsSync(routeFilePath)) {
+                    const routeContent = fs.readFileSync(routeFilePath, "utf-8");
+                    const urlMatch = routeContent.match(/url:\s*"([^"]+)"/);
+                    if (urlMatch) {
+                        urlPath = urlMatch[1];
+                    }
+                }
+            }
+            const resolved = resolveOperationMeta(op.name, operationSlug, "post", // Default method for SOAP operations
+            urlPath, catalog.operations);
+            // Try to read method from the route file
+            const routeFilePath = path.join(gatewayDir, "routes", `${operationSlug}.ts`);
+            if (fs.existsSync(routeFilePath)) {
+                const routeContent = fs.readFileSync(routeFilePath, "utf-8");
+                const methodMatch = routeContent.match(/method:\s*"([^"]+)"/);
+                if (methodMatch) {
+                    resolved.method = methodMatch[1].toLowerCase();
+                }
+            }
+            operations.push(resolved);
+        }
+    }
+    // Create output directories
+    fs.mkdirSync(path.join(testDir, "helpers"), { recursive: true });
+    fs.mkdirSync(path.join(testDir, "gateway"), { recursive: true });
+    fs.mkdirSync(path.join(testDir, "runtime"), { recursive: true });
+    // Emit vitest.config.ts
+    writeTestFile(path.join(testDir, "vitest.config.ts"), emitVitestConfig(), force);
+    // Emit helpers/mock-client.ts
+    writeTestFile(path.join(testDir, "helpers", "mock-client.ts"), emitMockClientHelper(testDir, clientDir, importsMode, clientMeta, operations, catalog), force);
+    // Emit helpers/test-app.ts
+    writeTestFile(path.join(testDir, "helpers", "test-app.ts"), emitTestAppHelper(testDir, gatewayDir, importsMode, clientMeta), force);
+    // Emit gateway/routes.test.ts
+    writeTestFile(path.join(testDir, "gateway", "routes.test.ts"), emitRoutesTest(testDir, importsMode, operations, catalog), force);
+    // Emit gateway/errors.test.ts
+    writeTestFile(path.join(testDir, "gateway", "errors.test.ts"), emitErrorsTest(testDir, importsMode, operations, catalog), force);
+    // Emit gateway/envelope.test.ts
+    writeTestFile(path.join(testDir, "gateway", "envelope.test.ts"), emitEnvelopeTest(testDir, importsMode, operations, catalog), force);
+    // Emit gateway/validation.test.ts
+    writeTestFile(path.join(testDir, "gateway", "validation.test.ts"), emitValidationTest(testDir, importsMode, operations), force);
+    // Emit runtime/classify-error.test.ts
+    writeTestFile(path.join(testDir, "runtime", "classify-error.test.ts"), emitClassifyErrorTest(testDir, gatewayDir, importsMode), force);
+    // Emit runtime/envelope-builders.test.ts
+    writeTestFile(path.join(testDir, "runtime", "envelope-builders.test.ts"), emitEnvelopeBuildersTest(testDir, gatewayDir, importsMode), force);
+    // Emit runtime/unwrap.test.ts (conditional: only when ArrayOf* wrappers exist)
+    const unwrapContent = emitUnwrapTest(testDir, gatewayDir, importsMode, catalog);
+    if (unwrapContent) {
+        writeTestFile(path.join(testDir, "runtime", "unwrap.test.ts"), unwrapContent, force);
+    }
+    success(`Test suite generated in ${testDir}`);
+}

package/dist/test/generators.d.ts

@@ -0,0 +1,69 @@
+import type { ClientMeta, ResolvedOperationMeta } from "../gateway/helpers.js";
+import type { CatalogForMocks } from "./mockData.js";
+/**
+ * Emits vitest.config.ts content.
+ *
+ * Sets root to __dirname so test glob patterns resolve relative to the
+ * config file location, not the working directory.
+ */
+export declare function emitVitestConfig(): string;
+/**
+ * Emits helpers/mock-client.ts content with full default responses per operation.
+ *
+ * @param testDir - Absolute path to test output directory
+ * @param clientDir - Absolute path to client directory
+ * @param importsMode - Import extension mode
+ * @param clientMeta - Client metadata
+ * @param operations - Resolved operation metadata
+ * @param catalog - Compiled catalog for mock data generation
+ */
+export declare function emitMockClientHelper(testDir: string, clientDir: string, importsMode: "js" | "ts" | "bare", clientMeta: ClientMeta, operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+/**
+ * Emits helpers/test-app.ts content.
+ *
+ * @param testDir - Absolute path to test output directory
+ * @param gatewayDir - Absolute path to gateway directory
+ * @param importsMode - Import extension mode
+ * @param clientMeta - Client metadata
+ */
+export declare function emitTestAppHelper(testDir: string, gatewayDir: string, importsMode: "js" | "ts" | "bare", clientMeta: ClientMeta): string;
+/**
+ * Emits gateway/routes.test.ts with one test per operation.
+ *
+ * @param testDir - Absolute path to test output directory
+ * @param importsMode - Import extension mode
+ * @param operations - Resolved operation metadata
+ * @param catalog - Compiled catalog for mock data generation
+ */
+export declare function emitRoutesTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+/**
+ * Emits gateway/errors.test.ts with error classification tests through Fastify.
+ *
+ * @param testDir - Absolute path to test output directory
+ * @param importsMode - Import extension mode
+ * @param operations - Resolved operation metadata (uses first operation for error tests)
+ * @param catalog - Compiled catalog for mock data generation
+ */
+export declare function emitErrorsTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+/**
+ * Emits gateway/envelope.test.ts with SUCCESS/ERROR structure assertions.
+ */
+export declare function emitEnvelopeTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[], catalog: CatalogForMocks): string;
+/**
+ * Emits gateway/validation.test.ts with invalid payload tests per route.
+ */
+export declare function emitValidationTest(testDir: string, importsMode: "js" | "ts" | "bare", operations: ResolvedOperationMeta[]): string;
+/**
+ * Emits runtime/classify-error.test.ts with direct classifyError() unit tests.
+ */
+export declare function emitClassifyErrorTest(testDir: string, gatewayDir: string, importsMode: "js" | "ts" | "bare"): string;
+/**
+ * Emits runtime/envelope-builders.test.ts with buildSuccessEnvelope/buildErrorEnvelope tests.
+ */
+export declare function emitEnvelopeBuildersTest(testDir: string, gatewayDir: string, importsMode: "js" | "ts" | "bare"): string;
+/**
+ * Emits runtime/unwrap.test.ts with unwrapArrayWrappers tests.
+ * Returns null if no array wrappers exist in the catalog.
+ */
+export declare function emitUnwrapTest(testDir: string, gatewayDir: string, importsMode: "js" | "ts" | "bare", catalog: CatalogForMocks): string | null;
+//# sourceMappingURL=generators.d.ts.map

package/dist/test/generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../src/test/generators.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,eAAe,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAiBzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,eAAe,GACvB,MAAM,CAiDR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,UAAU,GACrB,MAAM,CAsCR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,eAAe,GACvB,MAAM,CA8CR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,eAAe,GACvB,MAAM,CAkIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,EACnC,OAAO,EAAE,eAAe,GACvB,MAAM,CAuER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,UAAU,EAAE,qBAAqB,EAAE,GAClC,MAAM,CAoCR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgFR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAChC,MAAM,CAgDR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EACjC,OAAO,EAAE,eAAe,GACvB,MAAM,GAAG,IAAI,CAyCf"}