@elench/testkit 0.1.82 → 0.1.84

package/lib/bundler/index.test.mjs

@@ -1,164 +0,0 @@
-import fs from "fs";
-import os from "os";
-import path from "path";
-import { pathToFileURL } from "url";
-import { afterEach, describe, expect, it } from "vitest";
-import { bundleK6File } from "./index.mjs";
-
-const cleanups = [];
-
-afterEach(() => {
-  while (cleanups.length > 0) {
-    cleanups.pop()();
-  }
-});
-
-describe("runtime bundler", () => {
-  it("bundles root and runtime package imports for execution", async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
-    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
-
-    const sourceFile = path.join(tmpDir, "health.js");
-    fs.writeFileSync(
-      sourceFile,
-      [
-        'import { defineHttpSuite } from "@elench/testkit";',
-        'import { check, json } from "@elench/testkit/runtime";',
-        "const suite = defineHttpSuite(({ rawReq }) => {",
-        '  const res = rawReq("GET", "/health");',
-        "  check(json(res), {",
-        '    "has status": (body) => typeof body.status === "string",',
-        "  });",
-        "});",
-        "export default suite;",
-        "",
-      ].join("\n")
-    );
-
-    const bundledFile = await bundleK6File({
-      productDir: tmpDir,
-      serviceName: "api",
-      sourceFile,
-    });
-
-    const bundled = fs.readFileSync(bundledFile, "utf8");
-    expect(bundled).toContain("defineHttpSuite");
-    expect(bundled).toContain('import { check');
-    expect(bundled).toContain('from "k6"');
-  });
-
-  it("bundles DAL execution through the public package surface", async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
-    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
-
-    const sourceFile = path.join(tmpDir, "dal.js");
-    fs.writeFileSync(
-      sourceFile,
-      [
-        'import { defineDalSuite } from "@elench/testkit";',
-        "const suite = defineDalSuite(({ db }) => {",
-        '  db.query("SELECT 1");',
-        "});",
-        "export default suite;",
-        "",
-      ].join("\n")
-    );
-
-    const bundledFile = await bundleK6File({
-      productDir: tmpDir,
-      serviceName: "api",
-      sourceFile,
-    });
-
-    const bundled = fs.readFileSync(bundledFile, "utf8");
-    expect(bundled).toContain("defineDalSuite");
-    expect(bundled).toContain('import sql from "k6/x/sql"');
-  });
-
-  it("bundles scenario execution through the public package surface", async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
-    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
-
-    const sourceFile = path.join(tmpDir, "scenario.js");
-    fs.writeFileSync(
-      sourceFile,
-      [
-        'import { defineScenarioSuite } from "@elench/testkit";',
-        "const suite = defineScenarioSuite(({ scenario }) => {",
-        "  const plan = scenario.choose('journey', { endpoint: scenario.pick('endpoint', ['/a', '/b']) });",
-        "  scenario.step('record choice', () => plan.endpoint);",
-        "});",
-        "export default suite;",
-        "",
-      ].join("\n")
-    );
-
-    const bundledFile = await bundleK6File({
-      productDir: tmpDir,
-      serviceName: "api",
-      sourceFile,
-    });
-
-    const bundled = fs.readFileSync(bundledFile, "utf8");
-    expect(bundled).toContain("defineScenarioSuite");
-    expect(bundled).toContain("createScenarioRuntime");
-  });
-
-  it("normalizes a default-exported suite object with no setup override", async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
-    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
-
-    const sourceFile = path.join(tmpDir, "no-setup.js");
-    fs.writeFileSync(
-      sourceFile,
-      [
-        "const suite = {",
-        "  options: { vus: 1, iterations: 1 },",
-        "  exec() {",
-        "    return 'ok';",
-        "  },",
-        "};",
-        "export default suite;",
-        "",
-      ].join("\n")
-    );
-
-    const bundledFile = await bundleK6File({
-      productDir: tmpDir,
-      serviceName: "api",
-      sourceFile,
-    });
-
-    const bundled = await import(`${pathToFileURL(bundledFile).href}?v=${Date.now()}`);
-    expect(typeof bundled.setup).toBe("function");
-    expect(bundled.setup()).toBeNull();
-    expect(typeof bundled.default).toBe("function");
-    expect(bundled.default()).toBe("ok");
-  });
-
-  it("throws a clear error when the default export is not a suite object", async () => {
-    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-bundle-"));
-    cleanups.push(() => fs.rmSync(tmpDir, { force: true, recursive: true }));
-
-    const sourceFile = path.join(tmpDir, "legacy-shape.js");
-    fs.writeFileSync(
-      sourceFile,
-      [
-        "export default function exec() {",
-        "  return 'legacy';",
-        "}",
-        "",
-      ].join("\n")
-    );
-
-    const bundledFile = await bundleK6File({
-      productDir: tmpDir,
-      serviceName: "api",
-      sourceFile,
-    });
-
-    await expect(
-      import(`${pathToFileURL(bundledFile).href}?v=${Date.now()}`)
-    ).rejects.toThrow(/default-export the suite object/);
-  });
-});

package/lib/cli/args.test.mjs

@@ -1,110 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  parseFileTimeoutOption,
-  parseShardOption,
-  parseSuiteOption,
-  parseTypeOption,
-  parseWorkersOption,
-  resolveRequestedFiles,
-  resolveCliSelection,
-} from "./args.mjs";
-
-describe("cli-args", () => {
-  it("resolves a positional suite type", () => {
-    expect(
-      resolveCliSelection({
-        first: "int",
-        second: null,
-        third: null,
-      })
-    ).toEqual({
-      dbAction: null,
-      lifecycle: null,
-      positionalType: "int",
-    });
-  });
-
-  it("resolves lifecycle commands", () => {
-    expect(
-      resolveCliSelection({
-        first: "status",
-        second: null,
-        third: null,
-      })
-    ).toEqual({
-      dbAction: null,
-      lifecycle: "status",
-      positionalType: null,
-    });
-  });
-
-  it("resolves db subcommands", () => {
-    expect(
-      resolveCliSelection({
-        first: "db",
-        second: "snapshot",
-        third: "capture",
-      })
-    ).toEqual({
-      dbAction: "snapshot-capture",
-      lifecycle: null,
-      positionalType: null,
-    });
-  });
-
-  it("rejects unknown positional arguments", () => {
-    expect(() =>
-      resolveCliSelection({
-        first: "mystery",
-        second: null,
-        third: null,
-      })
-    ).toThrow('Unknown argument "mystery"');
-  });
-
-  it("parses types and suite selectors", () => {
-    expect(parseTypeOption(["e2e,scenario,dal"], "int")).toEqual([
-      "int",
-      "e2e",
-      "scenario",
-      "dal",
-    ]);
-    expect(() => parseTypeOption(["all", "int"])).toThrow("cannot be combined");
-
-    expect(parseSuiteOption(["auth,scenario:journeys,dal:queries"])).toEqual([
-      { kind: "plain", name: "auth", raw: "auth" },
-      { kind: "typed", type: "scenario", name: "journeys", raw: "scenario:journeys" },
-      { kind: "typed", type: "dal", name: "queries", raw: "dal:queries" },
-    ]);
-  });
-
-  it("parses and validates execution options", () => {
-    expect(parseWorkersOption("3")).toBe(3);
-    expect(parseFileTimeoutOption("45")).toBe(45);
-    expect(() => parseWorkersOption("0")).toThrow("Invalid --workers value");
-    expect(() => parseFileTimeoutOption("0")).toThrow(
-      "Invalid --file-timeout-seconds value"
-    );
-  });
-
-  it("parses and validates shards", () => {
-    expect(parseShardOption("2/5")).toEqual({ index: 2, total: 5 });
-    expect(parseShardOption(null)).toBeNull();
-    expect(() => parseShardOption("2-of-5")).toThrow("Invalid --shard value");
-    expect(() => parseShardOption("3/2")).toThrow("Expected 1 <= i <= n");
-  });
-
-  it("normalizes requested file paths against the product directory", () => {
-    expect(
-      resolveRequestedFiles(
-        [
-          "/tmp/product/tests/api/integration/health.int.testkit.ts",
-          "./tests/api/integration/health.int.testkit.ts",
-          "product/tests/api/integration/health.int.testkit.ts",
-        ],
-        "/tmp/product",
-        "/tmp"
-      )
-    ).toEqual(["tests/api/integration/health.int.testkit.ts"]);
-  });
-});

package/lib/cli/presentation/code-frames.test.mjs

@@ -1,71 +0,0 @@
-import fs from "fs";
-import os from "os";
-import path from "path";
-import { afterEach, describe, expect, it } from "vitest";
-import { findFailureLocation, formatLocation, renderCodeFrame } from "./code-frames.mjs";
-
-const cleanups = [];
-
-afterEach(() => {
-  while (cleanups.length > 0) {
-    cleanups.pop()();
-  }
-});
-
-describe("code frame presentation", () => {
-  it("finds a location from structured failure metadata", () => {
-    expect(
-      findFailureLocation({
-        location: {
-          path: "/tmp/example.ts",
-          line: 10,
-          column: 2,
-        },
-      })
-    ).toEqual({
-      path: "/tmp/example.ts",
-      line: 10,
-      column: 2,
-    });
-  });
-
-  it("renders a code frame for a local file", () => {
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-code-frame-"));
-    cleanups.push(() => fs.rmSync(tempDir, { recursive: true, force: true }));
-    const filePath = path.join(tempDir, "example.ts");
-    fs.writeFileSync(
-      filePath,
-      [
-        "export function run() {",
-        "  const value = 1;",
-        "  return value + missing;",
-        "}",
-      ].join("\n")
-    );
-
-    const lines = renderCodeFrame(
-      {
-        path: filePath,
-        line: 3,
-        column: 18,
-      },
-      { cwd: tempDir }
-    );
-
-    expect(lines.join("\n")).toContain("example.ts:3:18");
-    expect(lines.join("\n")).toContain("return value + missing;");
-  });
-
-  it("formats locations relative to the cwd", () => {
-    expect(
-      formatLocation(
-        {
-          path: "/tmp/example.ts",
-          line: 7,
-          column: 3,
-        },
-        "/tmp"
-      )
-    ).toBe("example.ts:7:3");
-  });
-});

package/lib/cli/presentation/run-reporter.test.mjs

@@ -1,192 +0,0 @@
-import { Writable } from "stream";
-import figures from "figures";
-import { describe, expect, it } from "vitest";
-import { createRunReporter } from "./run-reporter.mjs";
-
-function createCapture(columns = 100) {
-  let stdout = "";
-  const stream = new Writable({
-    write(chunk, _encoding, callback) {
-      stdout += chunk.toString();
-      callback();
-    },
-  });
-  stream.columns = columns;
-  return {
-    stream,
-    read() {
-      return stdout;
-    },
-  };
-}
-
-describe("run reporter setup output", () => {
-  it("prints concise high-level setup summaries in compact mode", () => {
-    const capture = createCapture();
-    const reporter = createRunReporter({
-      outputMode: "compact",
-      stdout: capture.stream,
-    });
-
-    reporter.setupOperationFinished({
-      serviceName: "api",
-      stage: "template",
-      kind: "database-template",
-      summary: "template rebuild",
-      status: "passed",
-      durationMs: 8_000,
-    });
-
-    expect(capture.read()).toContain(`${figures.play} RUN SETUP api template rebuild`);
-    expect(capture.read()).toContain("8s");
-  });
-
-  it("does not print low-level setup steps in compact mode", () => {
-    const capture = createCapture();
-    const reporter = createRunReporter({
-      outputMode: "compact",
-      stdout: capture.stream,
-    });
-
-    reporter.setupOperationFinished({
-      serviceName: "api",
-      stage: "template:migrate:api:1",
-      kind: "setup-step",
-      summary: "sql-file: db/schema.sql",
-      status: "passed",
-      durationMs: 8_000,
-    });
-
-    expect(capture.read()).toBe("");
-  });
-
-  it("prints concise setup failures", () => {
-    const capture = createCapture();
-    const reporter = createRunReporter({
-      outputMode: "compact",
-      stdout: capture.stream,
-    });
-
-    reporter.setupOperationFinished({
-      serviceName: "api",
-      stage: "runtime:prepare",
-      kind: "runtime-prepare",
-      summary: "runtime prepare",
-      status: "failed",
-      durationMs: 1_200,
-      error: "Command failed with exit code 1: node scripts/fail-prepare.mjs",
-    });
-
-    expect(capture.read()).toContain(`${figures.cross} FAIL SETUP api runtime:prepare`);
-    expect(capture.read()).toContain("Command failed with exit code 1");
-  });
-});
-
-describe("run reporter task output", () => {
-  it("prints failure details on lines beneath the failed file result", () => {
-    const capture = createCapture(88);
-    const reporter = createRunReporter({
-      outputMode: "compact",
-      stdout: capture.stream,
-    });
-
-    reporter.setTotalFileCount(3);
-    reporter.taskFinished(
-      {
-        serviceName: "api",
-        type: "integration",
-        framework: "k6",
-        file: "__testkit__/health/health.int.testkit.ts",
-      },
-      {
-        status: "failed",
-        failed: true,
-        durationMs: 4_000,
-        error: "Default runtime thresholds failed: checks(rate==1.0)",
-        failureDetails: [
-          {
-            kind: "http-assertion",
-            title: "status is 200",
-            message: "GET /health expected 200, got 404",
-            request: {
-              method: "GET",
-              path: "/health",
-              requestId: "req-1",
-            },
-            response: {
-              status: 404,
-              bodyPreview: '{"error":"route not found"}',
-            },
-          },
-        ],
-      }
-    );
-
-    const lines = capture.read().trimEnd().split("\n");
-    expect(lines[0]).toContain("[1/3]");
-    expect(lines[0]).toContain(`${figures.cross} FAIL api int __testkit__/health/health.int.testkit.ts 4s`);
-    expect(lines[1]).toBe("    GET /health expected 200, got 404");
-    expect(lines[2]).toContain('    response: {"error":"route not found"}');
-    expect(lines[3]).toBe("    regression: new");
-    expect(lines[4]).toBe("    logs: requestId=req-1");
-  });
-
-  it("renders a compact aggregate summary box", () => {
-    const capture = createCapture(72);
-    const reporter = createRunReporter({
-      outputMode: "compact",
-      stdout: capture.stream,
-    });
-
-    reporter.runSummary(
-      [
-        {
-          name: "api",
-          skipped: false,
-          failed: true,
-          suiteCount: 1,
-          completedSuiteCount: 1,
-          skippedSuiteCount: 0,
-          failedSuiteCount: 1,
-          totalFileCount: 3,
-          passedFileCount: 2,
-          failedFileCount: 1,
-          skippedFileCount: 0,
-          notRunFileCount: 0,
-          durationMs: 10_000,
-          suites: [],
-          errors: [],
-        },
-      ],
-      20_000,
-      {
-        summary: {
-          newRegressions: 1,
-          knownRegressions: 2,
-          fixedKnownRegressions: 3,
-          catalogStale: 4,
-          catalogSyncUnavailable: false,
-          usedStaleCache: true,
-        },
-      }
-    );
-
-    const output = capture.read();
-    expect(output).toContain("┌");
-    expect(output).toContain("│ Result");
-    expect(output).toContain("FAILED");
-    expect(output).toContain("│ Passed");
-    expect(output).toContain("│ Failed");
-    expect(output).toContain("│ Skipped");
-    expect(output).toContain("│ Not run");
-    expect(output).toContain("│ Files");
-    expect(output).toContain("│ Duration");
-    expect(output).toContain("│ New regressions");
-    expect(output).toContain("│ Known regressions");
-    expect(output).toContain("│ Fixed known");
-    expect(output).toContain("│ Catalog stale");
-    expect(output).toContain("│ Catalog sync");
-    expect(output).not.toContain("Failures:");
-    expect(output).not.toContain("Runtime Errors:");
-  });
-});

package/lib/cli/presentation/summary-box.test.mjs

@@ -1,43 +0,0 @@
-import { Writable } from "stream";
-import { describe, expect, it } from "vitest";
-import { renderSummaryBox } from "./summary-box.mjs";
-
-function createStream(columns) {
-  const stream = new Writable({
-    write(_chunk, _encoding, callback) {
-      callback();
-    },
-  });
-  stream.columns = columns;
-  return stream;
-}
-
-describe("summary box", () => {
-  it("renders key/value rows inside a bounded box", () => {
-    const lines = renderSummaryBox(
-      [
-        ["Result", "FAILED"],
-        ["Passed", "203"],
-        ["Duration", "8m 56s"],
-      ],
-      { stdout: createStream(80) }
-    );
-
-    expect(lines[0]).toMatch(/^┌/);
-    expect(lines.at(-1)).toMatch(/^└/);
-    expect(lines.join("\n")).toContain("Result");
-    expect(lines.join("\n")).toContain("FAILED");
-  });
-
-  it("wraps long values instead of widening to content length", () => {
-    const lines = renderSummaryBox(
-      [["Catalog sync", "Used stale GitHub cache while catalog validation was unavailable"]],
-      { stdout: createStream(40) }
-    );
-
-    expect(lines.length).toBeGreaterThan(4);
-    expect(lines.join("\n")).toContain("Catalog sync");
-    expect(lines.join("\n")).toContain("stale");
-    expect(lines.join("\n")).toContain("cache");
-  });
-});

package/lib/cli/presentation/terminal-layout.test.mjs

@@ -1,23 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { getTerminalWidth, renderIndentedBlock, wrapText } from "./terminal-layout.mjs";
-
-describe("terminal layout", () => {
-  it("falls back to a default width when stream columns are unavailable", () => {
-    expect(getTerminalWidth({}, 91)).toBe(91);
-  });
-
-  it("wraps indented blocks to the provided width", () => {
-    const lines = renderIndentedBlock("response: abcdefghijklmnopqrstuvwxyz", {
-      width: 20,
-      indent: "    ",
-    });
-
-    expect(lines[0].startsWith("    ")).toBe(true);
-    expect(lines.length).toBeGreaterThan(1);
-  });
-
-  it("hard-wraps long unbroken values", () => {
-    const lines = wrapText("abcdefghijklmnopqrstuvwxyz", 8);
-    expect(lines.length).toBeGreaterThan(1);
-  });
-});

package/lib/config/database.test.mjs

@@ -1,29 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { normalizeDatabaseConfig } from "./database.mjs";
-
-describe("config database helpers", () => {
-  it("normalizes local database config with template defaults", () => {
-    expect(
-      normalizeDatabaseConfig(
-        {
-          database: {
-            template: {
-              migrate: [{ kind: "sql-file", path: "sql/migrate.sql" }],
-            },
-          },
-        },
-        "web"
-      )
-    ).toMatchObject({
-      provider: "local",
-      selectedBackend: "local",
-      reset: true,
-      template: {
-        inputs: [],
-        migrate: [{ kind: "sql-file", path: "sql/migrate.sql" }],
-        seed: [],
-        verify: [],
-      },
-    });
-  });
-});