trickle-cli 0.1.208 → 0.1.209

package/dist/commands/test-gen.js

@@ -42,44 +42,29 @@ const path = __importStar(require("path"));
 const chalk_1 = __importDefault(require("chalk"));
 const api_client_1 = require("../api-client");
 /**
- * `trickle test --generate` — Generate API test files from runtime observations.
+ * `trickle test --generate` — Generate test files from runtime observations.
  *
- * Uses real sample request/response data captured at runtime to generate
- * ready-to-run test files with correct endpoints, request bodies, and
- * response shape assertions.
+ * Two modes:
+ *   Default: API route tests (HTTP endpoint integration tests)
+ *   --unit:  Function-level unit tests from observed inputs/outputs
+ *
+ * Frameworks: vitest, jest, pytest
  */
 async function testGenCommand(opts) {
-    const framework = opts.framework || "vitest";
+    const framework = opts.framework || (opts.unit ? "vitest" : "vitest");
     const baseUrl = opts.baseUrl || "http://localhost:3000";
-    if (framework !== "vitest" && framework !== "jest") {
+    const supportedFrameworks = ["vitest", "jest", "pytest"];
+    if (!supportedFrameworks.includes(framework)) {
         console.error(chalk_1.default.red(`\n  Unsupported framework: ${framework}`));
-        console.error(chalk_1.default.gray("  Supported: vitest, jest\n"));
+        console.error(chalk_1.default.gray(`  Supported: ${supportedFrameworks.join(", ")}\n`));
         process.exit(1);
     }
     try {
-        const { routes } = await (0, api_client_1.fetchMockConfig)();
-        if (routes.length === 0) {
-            console.error(chalk_1.default.yellow("\n  No API routes observed yet."));
-            console.error(chalk_1.default.gray("  Instrument your app and make some requests first.\n"));
-            process.exit(1);
-        }
-        const testCode = generateTestFile(routes, framework, baseUrl);
-        if (opts.out) {
-            const resolvedPath = path.resolve(opts.out);
-            const dir = path.dirname(resolvedPath);
-            if (!fs.existsSync(dir)) {
-                fs.mkdirSync(dir, { recursive: true });
-            }
-            fs.writeFileSync(resolvedPath, testCode, "utf-8");
-            console.log("");
-            console.log(chalk_1.default.green(`  Tests written to ${chalk_1.default.bold(opts.out)}`));
-            console.log(chalk_1.default.gray(`  ${routes.length} route tests generated (${framework})`));
-            console.log(chalk_1.default.gray(`  Run with: npx ${framework === "vitest" ? "vitest run" : "jest"} ${opts.out}`));
-            console.log("");
+        if (opts.unit) {
+            await generateUnitTests(opts, framework);
         }
         else {
-            console.log("");
-            console.log(testCode);
+            await generateRouteTests(opts, framework, baseUrl);
         }
     }
     catch (err) {
@@ -89,21 +74,239 @@ async function testGenCommand(opts) {
         process.exit(1);
     }
 }
-function generateTestFile(routes, framework, baseUrl) {
+// ── Route tests (existing behavior) ──
+async function generateRouteTests(opts, framework, baseUrl) {
+    if (framework === "pytest") {
+        console.error(chalk_1.default.red("\n  pytest is only supported with --unit mode"));
+        console.error(chalk_1.default.gray("  For API route tests, use vitest or jest\n"));
+        process.exit(1);
+    }
+    const { routes } = await (0, api_client_1.fetchMockConfig)();
+    if (routes.length === 0) {
+        console.error(chalk_1.default.yellow("\n  No API routes observed yet."));
+        console.error(chalk_1.default.gray("  Instrument your app and make some requests first.\n"));
+        process.exit(1);
+    }
+    const testCode = generateRouteTestFile(routes, framework, baseUrl);
+    outputTestCode(testCode, opts, routes.length, "route", framework);
+}
+async function generateUnitTests(opts, framework) {
+    // Fetch all functions with their sample data
+    const { functions } = await (0, api_client_1.listFunctions)({ limit: 500 });
+    if (functions.length === 0) {
+        console.error(chalk_1.default.yellow("\n  No functions observed yet."));
+        console.error(chalk_1.default.gray("  Run your app with trickle first: trickle run <command>\n"));
+        process.exit(1);
+    }
+    // Filter by function name or module if specified
+    let filtered = functions;
+    if (opts.function) {
+        const searchTerm = opts.function.toLowerCase();
+        filtered = functions.filter(f => f.function_name.toLowerCase().includes(searchTerm));
+    }
+    if (opts.module) {
+        const searchTerm = opts.module.toLowerCase();
+        filtered = filtered.filter(f => f.module.toLowerCase().includes(searchTerm));
+    }
+    // Skip route handlers (GET /api/..., POST /api/...) — those are covered by route tests
+    filtered = filtered.filter(f => !isRouteHandler(f.function_name));
+    if (filtered.length === 0) {
+        console.error(chalk_1.default.yellow("\n  No matching functions found."));
+        if (opts.function || opts.module) {
+            console.error(chalk_1.default.gray(`  Try without --function or --module filters\n`));
+        }
+        else {
+            console.error(chalk_1.default.gray("  Only route handlers were found. Try without --unit for API route tests.\n"));
+        }
+        process.exit(1);
+    }
+    // Collect sample data for each function
+    const functionSamples = [];
+    for (const fn of filtered) {
+        try {
+            const { snapshots } = await (0, api_client_1.listTypes)(fn.id, { limit: 10 });
+            const samples = [];
+            for (const snap of snapshots) {
+                if (snap.sample_input !== undefined || snap.sample_output !== undefined) {
+                    samples.push({
+                        input: snap.sample_input,
+                        output: snap.sample_output,
+                    });
+                }
+            }
+            if (samples.length > 0) {
+                functionSamples.push({
+                    functionName: fn.function_name,
+                    module: fn.module,
+                    language: fn.language,
+                    samples,
+                });
+            }
+        }
+        catch {
+            // Skip functions with no snapshot data
+        }
+    }
+    if (functionSamples.length === 0) {
+        console.error(chalk_1.default.yellow("\n  No functions with sample data found."));
+        console.error(chalk_1.default.gray("  Run your app with trickle to capture function inputs/outputs first.\n"));
+        process.exit(1);
+    }
+    // Auto-detect language if framework doesn't specify
+    const isPython = framework === "pytest";
+    const isJS = framework === "vitest" || framework === "jest";
+    // Filter samples by language
+    const languageFiltered = functionSamples.filter(f => isPython ? f.language === "python" : f.language !== "python");
+    if (languageFiltered.length === 0) {
+        const lang = isPython ? "Python" : "JavaScript/TypeScript";
+        console.error(chalk_1.default.yellow(`\n  No ${lang} functions with sample data found.`));
+        console.error(chalk_1.default.gray(`  Try --framework ${isPython ? "vitest" : "pytest"} for the other language\n`));
+        process.exit(1);
+    }
+    const testCode = isPython
+        ? generatePytestFile(languageFiltered)
+        : generateUnitTestFile(languageFiltered, framework);
+    outputTestCode(testCode, opts, languageFiltered.length, "function", framework);
+}
+function outputTestCode(testCode, opts, count, kind, framework) {
+    if (opts.out) {
+        const resolvedPath = path.resolve(opts.out);
+        const dir = path.dirname(resolvedPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(resolvedPath, testCode, "utf-8");
+        console.log("");
+        console.log(chalk_1.default.green(`  Tests written to ${chalk_1.default.bold(opts.out)}`));
+        console.log(chalk_1.default.gray(`  ${count} ${kind} tests generated (${framework})`));
+        const runCmd = framework === "pytest"
+            ? `pytest ${opts.out} -v`
+            : `npx ${framework === "vitest" ? "vitest run" : "jest"} ${opts.out}`;
+        console.log(chalk_1.default.gray(`  Run with: ${runCmd}`));
+        console.log("");
+    }
+    else {
+        console.log("");
+        console.log(testCode);
+    }
+}
+// ── JS/TS unit test generation ──
+function generateUnitTestFile(functions, framework) {
+    const lines = [];
+    lines.push("// Auto-generated unit tests by trickle");
+    lines.push(`// Generated at ${new Date().toISOString()}`);
+    lines.push("// Based on observed runtime behavior — re-run `trickle test --generate --unit` to update");
+    lines.push("");
+    if (framework === "vitest") {
+        lines.push('import { describe, it, expect } from "vitest";');
+        lines.push("");
+    }
+    // Group functions by module for import organization
+    const byModule = groupByModule(functions);
+    // Generate import statements
+    for (const [mod, fns] of Object.entries(byModule)) {
+        const importPath = normalizeImportPath(mod);
+        const fnNames = fns.map(f => sanitizeFnName(f.functionName));
+        lines.push(`import { ${fnNames.join(", ")} } from "${importPath}";`);
+    }
+    lines.push("");
+    // Generate test blocks
+    for (const [mod, fns] of Object.entries(byModule)) {
+        for (const fn of fns) {
+            const safeName = sanitizeFnName(fn.functionName);
+            lines.push(`describe("${safeName}", () => {`);
+            for (let i = 0; i < fn.samples.length; i++) {
+                const sample = fn.samples[i];
+                const testName = describeTestCase(sample.input, sample.output, i);
+                const isAsync = isPromiseOutput(sample.output);
+                lines.push(`  it("${testName}", ${isAsync ? "async " : ""}() => {`);
+                // Build function call
+                const argsStr = formatArgs(sample.input);
+                const resultVar = isAsync ? `await ${safeName}(${argsStr})` : `${safeName}(${argsStr})`;
+                lines.push(`    const result = ${resultVar};`);
+                // Generate assertions based on output
+                if (sample.output !== undefined && sample.output !== null) {
+                    const assertions = generateOutputAssertions(sample.output, "result");
+                    for (const assertion of assertions) {
+                        lines.push(`    ${assertion}`);
+                    }
+                }
+                else if (sample.output === null) {
+                    lines.push("    expect(result).toBeNull();");
+                }
+                else {
+                    lines.push("    expect(result).toBeDefined();");
+                }
+                lines.push("  });");
+                lines.push("");
+            }
+            lines.push("});");
+            lines.push("");
+        }
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}
+// ── Python pytest generation ──
+function generatePytestFile(functions) {
+    const lines = [];
+    lines.push("# Auto-generated unit tests by trickle");
+    lines.push(`# Generated at ${new Date().toISOString()}`);
+    lines.push("# Based on observed runtime behavior — re-run `trickle test --generate --unit --framework pytest` to update");
+    lines.push("");
+    // Group by module for imports
+    const byModule = groupByModule(functions);
+    // Generate import statements
+    for (const [mod, fns] of Object.entries(byModule)) {
+        const importModule = normalizePythonImport(mod);
+        const fnNames = fns.map(f => sanitizePythonName(f.functionName));
+        lines.push(`from ${importModule} import ${fnNames.join(", ")}`);
+    }
+    lines.push("");
+    lines.push("");
+    // Generate test functions
+    for (const fn of functions) {
+        const safeName = sanitizePythonName(fn.functionName);
+        for (let i = 0; i < fn.samples.length; i++) {
+            const sample = fn.samples[i];
+            const testSuffix = fn.samples.length > 1 ? `_case_${i + 1}` : "";
+            const testFnName = `test_${safeName}${testSuffix}`;
+            lines.push(`def ${testFnName}():`);
+            lines.push(`    """Test ${safeName} with observed runtime data."""`);
+            // Format input args
+            const argsStr = formatPythonArgs(sample.input);
+            lines.push(`    result = ${safeName}(${argsStr})`);
+            // Generate assertions
+            if (sample.output !== undefined && sample.output !== null) {
+                const assertions = generatePythonAssertions(sample.output, "result");
+                for (const assertion of assertions) {
+                    lines.push(`    ${assertion}`);
+                }
+            }
+            else if (sample.output === null) {
+                lines.push("    assert result is None");
+            }
+            else {
+                lines.push("    assert result is not None");
+            }
+            lines.push("");
+            lines.push("");
+        }
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}
+// ── Route test generation (existing logic, preserved) ──
+function generateRouteTestFile(routes, framework, baseUrl) {
     const lines = [];
     lines.push("// Auto-generated API tests by trickle");
     lines.push(`// Generated at ${new Date().toISOString()}`);
     lines.push("// Do not edit manually — re-run `trickle test --generate` to update");
     lines.push("");
-    // Import block
     if (framework === "vitest") {
         lines.push('import { describe, it, expect } from "vitest";');
     }
-    // jest needs no import — globals are available
     lines.push("");
     lines.push(`const BASE_URL = process.env.TEST_API_URL || "${baseUrl}";`);
     lines.push("");
-    // Group routes by resource path prefix
     const groups = groupByResource(routes);
     for (const [resource, resourceRoutes] of Object.entries(groups)) {
         lines.push(`describe("${resource}", () => {`);
@@ -111,9 +314,7 @@ function generateTestFile(routes, framework, baseUrl) {
             const testName = `${route.method} ${route.path}`;
             const hasBody = ["POST", "PUT", "PATCH"].includes(route.method);
             lines.push(`  it("${testName} — returns expected shape", async () => {`);
-            // Build fetch call
             const fetchPath = route.path.replace(/:(\w+)/g, (_, param) => {
-                // Use sample data to get a real param value if available
                 const sampleValue = extractParamFromSample(route.sampleInput, param);
                 return sampleValue || `test-${param}`;
             });
@@ -128,11 +329,9 @@ function generateTestFile(routes, framework, baseUrl) {
             }
             lines.push("    });");
             lines.push("");
-            // Status assertion
             lines.push("    expect(res.ok).toBe(true);");
             lines.push(`    expect(res.status).toBe(200);`);
             lines.push("");
-            // Response body assertions
             lines.push("    const body = await res.json();");
             if (route.sampleOutput && typeof route.sampleOutput === "object") {
                 const assertions = generateAssertions(route.sampleOutput, "body");
@@ -148,14 +347,318 @@ function generateTestFile(routes, framework, baseUrl) {
     }
     return lines.join("\n").trimEnd() + "\n";
 }
-/**
- * Group routes by their first meaningful path segment.
- */
+// ── Helpers: grouping & naming ──
+function isRouteHandler(name) {
+    return /^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s+\//.test(name);
+}
+function groupByModule(functions) {
+    const groups = {};
+    for (const fn of functions) {
+        const mod = fn.module || "unknown";
+        if (!groups[mod])
+            groups[mod] = [];
+        groups[mod].push(fn);
+    }
+    return groups;
+}
+function sanitizeFnName(name) {
+    // Handle names like "MyClass.method" → "method" (keep class context in describe)
+    // Handle names with special chars
+    return name
+        .replace(/[^a-zA-Z0-9_$]/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_+/g, "_");
+}
+function sanitizePythonName(name) {
+    return name
+        .replace(/[^a-zA-Z0-9_]/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .replace(/_+/g, "_");
+}
+function normalizeImportPath(mod) {
+    // Convert file paths to relative import paths
+    // e.g., "/Users/.../src/utils.ts" → "./src/utils"
+    // e.g., "src/helpers/math.js" → "./src/helpers/math"
+    let p = mod;
+    // Strip file extension
+    p = p.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "");
+    // If absolute path, try to make it relative to CWD
+    if (path.isAbsolute(p)) {
+        const cwd = process.cwd();
+        p = path.relative(cwd, p);
+    }
+    // Ensure starts with ./ or ../
+    if (!p.startsWith(".") && !p.startsWith("/")) {
+        p = "./" + p;
+    }
+    return p;
+}
+function normalizePythonImport(mod) {
+    // Convert file paths to Python module paths
+    // e.g., "app/utils.py" → "app.utils"
+    // e.g., "/abs/path/app/models.py" → "app.models"
+    let p = mod;
+    // Strip .py extension
+    p = p.replace(/\.py$/, "");
+    // If absolute path, try to make relative
+    if (path.isAbsolute(p)) {
+        const cwd = process.cwd();
+        p = path.relative(cwd, p);
+    }
+    // Convert path separators to dots
+    p = p.replace(/[/\\]/g, ".");
+    // Remove leading dots
+    p = p.replace(/^\.+/, "");
+    // Handle __init__ modules
+    p = p.replace(/\.__init__$/, "");
+    return p || "app";
+}
+function describeTestCase(input, output, index) {
+    // Generate a human-readable test name from the input/output
+    if (input === undefined && output === undefined) {
+        return `case ${index + 1}`;
+    }
+    const parts = [];
+    // Describe input
+    if (input !== undefined) {
+        if (input === null) {
+            parts.push("given null input");
+        }
+        else if (Array.isArray(input)) {
+            if (input.length === 0) {
+                parts.push("given empty args");
+            }
+            else {
+                const argSummaries = input.slice(0, 3).map(summarizeValue);
+                parts.push(`given ${argSummaries.join(", ")}`);
+            }
+        }
+        else if (typeof input === "object") {
+            // Named args or single object arg
+            const keys = Object.keys(input);
+            if (keys.length <= 3) {
+                parts.push(`given ${keys.join(", ")}`);
+            }
+            else {
+                parts.push(`given ${keys.length} params`);
+            }
+        }
+        else {
+            parts.push(`given ${summarizeValue(input)}`);
+        }
+    }
+    // Describe expected output briefly
+    if (output !== undefined) {
+        if (output === null) {
+            parts.push("returns null");
+        }
+        else if (Array.isArray(output)) {
+            parts.push(`returns array(${output.length})`);
+        }
+        else if (typeof output === "object") {
+            const keys = Object.keys(output);
+            parts.push(`returns {${keys.slice(0, 3).join(", ")}${keys.length > 3 ? ", ..." : ""}}`);
+        }
+        else {
+            parts.push(`returns ${summarizeValue(output)}`);
+        }
+    }
+    const name = parts.join(", ") || `case ${index + 1}`;
+    // Escape double quotes for use inside it("...") strings
+    return name.replace(/"/g, '\\"');
+}
+function summarizeValue(val) {
+    if (val === null)
+        return "null";
+    if (val === undefined)
+        return "undefined";
+    if (typeof val === "string") {
+        const escaped = val.replace(/"/g, '\\"');
+        return escaped.length > 20 ? `"${escaped.slice(0, 17)}..."` : `"${escaped}"`;
+    }
+    if (typeof val === "number")
+        return String(val);
+    if (typeof val === "boolean")
+        return String(val);
+    if (Array.isArray(val))
+        return `[${val.length} items]`;
+    if (typeof val === "object") {
+        const keys = Object.keys(val);
+        return `{${keys.length} keys}`;
+    }
+    return String(val);
+}
+function isPromiseOutput(output) {
+    // Heuristic: if the type node says "Promise" it's async
+    if (output && typeof output === "object" && "type" in output) {
+        const t = output.type;
+        if (typeof t === "string" && t.includes("Promise"))
+            return true;
+    }
+    return false;
+}
+// ── Helpers: argument formatting ──
+function formatArgs(input) {
+    if (input === undefined || input === null)
+        return "";
+    // If input is an array, it's positional args
+    if (Array.isArray(input)) {
+        return input.map(v => formatValue(v)).join(", ");
+    }
+    // If input is an object, check if it looks like named args or a single object arg
+    if (typeof input === "object") {
+        const obj = input;
+        const keys = Object.keys(obj);
+        // If it has typical Express-like keys (params, body, query), it's a route handler — skip
+        if (keys.some(k => ["params", "body", "query", "headers"].includes(k))) {
+            return formatValue(input);
+        }
+        // Treat as a single object argument
+        return formatValue(input);
+    }
+    return formatValue(input);
+}
+function formatValue(val) {
+    if (val === undefined)
+        return "undefined";
+    if (val === null)
+        return "null";
+    if (typeof val === "string")
+        return JSON.stringify(val);
+    if (typeof val === "number" || typeof val === "boolean")
+        return String(val);
+    if (Array.isArray(val)) {
+        if (val.length === 0)
+            return "[]";
+        if (val.length <= 5) {
+            return `[${val.map(v => formatValue(v)).join(", ")}]`;
+        }
+        // For large arrays, use JSON.stringify with formatting
+        return JSON.stringify(val);
+    }
+    if (typeof val === "object") {
+        return JSON.stringify(val);
+    }
+    return String(val);
+}
+function formatPythonArgs(input) {
+    if (input === undefined || input === null)
+        return "";
+    if (Array.isArray(input)) {
+        return input.map(v => formatPythonValue(v)).join(", ");
+    }
+    if (typeof input === "object") {
+        return formatPythonValue(input);
+    }
+    return formatPythonValue(input);
+}
+function formatPythonValue(val) {
+    if (val === undefined)
+        return "None";
+    if (val === null)
+        return "None";
+    if (typeof val === "boolean")
+        return val ? "True" : "False";
+    if (typeof val === "string")
+        return JSON.stringify(val); // JSON string syntax works in Python
+    if (typeof val === "number")
+        return String(val);
+    if (Array.isArray(val)) {
+        if (val.length === 0)
+            return "[]";
+        if (val.length <= 5) {
+            return `[${val.map(v => formatPythonValue(v)).join(", ")}]`;
+        }
+        return toPythonLiteral(val);
+    }
+    if (typeof val === "object") {
+        return toPythonLiteral(val);
+    }
+    return String(val);
+}
+function toPythonLiteral(val) {
+    // Convert JS objects/arrays to Python dict/list syntax
+    const json = JSON.stringify(val);
+    return json
+        .replace(/\bnull\b/g, "None")
+        .replace(/\btrue\b/g, "True")
+        .replace(/\bfalse\b/g, "False");
+}
+// ── Helpers: assertion generation ──
+function generateOutputAssertions(output, varName) {
+    if (output === null)
+        return [`expect(${varName}).toBeNull();`];
+    if (output === undefined)
+        return [`expect(${varName}).toBeDefined();`];
+    if (typeof output === "string") {
+        return [`expect(typeof ${varName}).toBe("string");`];
+    }
+    if (typeof output === "number") {
+        return [`expect(typeof ${varName}).toBe("number");`];
+    }
+    if (typeof output === "boolean") {
+        return [`expect(typeof ${varName}).toBe("boolean");`];
+    }
+    if (Array.isArray(output)) {
+        const assertions = [`expect(Array.isArray(${varName})).toBe(true);`];
+        if (output.length > 0 && typeof output[0] === "object" && output[0] !== null) {
+            assertions.push(`expect(${varName}.length).toBeGreaterThan(0);`);
+            const itemAssertions = generateOutputAssertions(output[0], `${varName}[0]`);
+            assertions.push(...itemAssertions);
+        }
+        return assertions;
+    }
+    if (typeof output === "object") {
+        return generateAssertions(output, varName);
+    }
+    return [`expect(${varName}).toBeDefined();`];
+}
+function generatePythonAssertions(output, varName, depth = 0) {
+    if (depth > 3)
+        return [];
+    if (output === null)
+        return [`assert ${varName} is None`];
+    if (output === undefined)
+        return [`assert ${varName} is not None`];
+    if (typeof output === "string") {
+        return [`assert isinstance(${varName}, str)`];
+    }
+    if (typeof output === "number") {
+        return [`assert isinstance(${varName}, (int, float))`];
+    }
+    if (typeof output === "boolean") {
+        return [`assert isinstance(${varName}, bool)`];
+    }
+    if (Array.isArray(output)) {
+        const assertions = [`assert isinstance(${varName}, list)`];
+        if (output.length > 0 && typeof output[0] === "object" && output[0] !== null) {
+            assertions.push(`assert len(${varName}) > 0`);
+            const itemAssertions = generatePythonAssertions(output[0], `${varName}[0]`, depth + 1);
+            assertions.push(...itemAssertions);
+        }
+        return assertions;
+    }
+    if (typeof output === "object") {
+        const obj = output;
+        const assertions = [`assert isinstance(${varName}, dict)`];
+        for (const [key, value] of Object.entries(obj)) {
+            if (depth < 2) {
+                assertions.push(`assert "${key}" in ${varName}`);
+                if (value !== null && value !== undefined && typeof value !== "object") {
+                    const typeAssertions = generatePythonAssertions(value, `${varName}["${key}"]`, depth + 1);
+                    assertions.push(...typeAssertions);
+                }
+            }
+        }
+        return assertions;
+    }
+    return [`assert ${varName} is not None`];
+}
+// ── Route test helpers (preserved from original) ──
 function groupByResource(routes) {
     const groups = {};
     for (const route of routes) {
         const parts = route.path.split("/").filter(Boolean);
-        // /api/users → "api/users", /users → "users"
         let resource;
         if (parts[0] === "api" && parts.length >= 2) {
             resource = `/api/${parts[1]}`;
@@ -169,14 +672,10 @@ function groupByResource(routes) {
     }
     return groups;
 }
-/**
- * Try to extract a path param value from sample input.
- */
 function extractParamFromSample(sampleInput, param) {
     if (!sampleInput || typeof sampleInput !== "object")
         return null;
     const input = sampleInput;
-    // Check params object
     if (input.params && typeof input.params === "object") {
         const params = input.params;
         if (params[param] !== undefined)
@@ -184,9 +683,6 @@ function extractParamFromSample(sampleInput, param) {
     }
     return null;
 }
-/**
- * Extract request body from sample input.
- */
 function extractBodyFromSample(sampleInput) {
     if (!sampleInput || typeof sampleInput !== "object")
         return null;
@@ -196,13 +692,9 @@ function extractBodyFromSample(sampleInput) {
     }
     return null;
 }
-/**
- * Generate expect() assertions for a sample response object.
- * Checks structure (property existence and types), not exact values.
- */
 function generateAssertions(obj, path, depth = 0) {
     if (depth > 3)
-        return []; // Prevent deeply nested assertions
+        return [];
     const assertions = [];
     for (const [key, value] of Object.entries(obj)) {
         const propPath = `${path}.${key}`;
@@ -211,7 +703,6 @@ function generateAssertions(obj, path, depth = 0) {
         }
         else if (Array.isArray(value)) {
             assertions.push(`expect(Array.isArray(${propPath})).toBe(true);`);
-            // If array has items, assert shape of first element
             if (value.length > 0 && typeof value[0] === "object" && value[0] !== null) {
                 assertions.push(`expect(${propPath}.length).toBeGreaterThan(0);`);
                 const itemAssertions = generateAssertions(value[0], `${propPath}[0]`, depth + 1);