@glubean/runner 0.8.1 → 0.8.4

package/dist/dry-run-spawn.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Spawn-side of dry-run projection: launch the dry-run worker under tsx so it
+ * can import the user's TypeScript test modules, collect the projected shapes.
+ *
+ * Mirrors the TestExecutor spawn (tsx CLI + zero-project `--import` hook). The
+ * worker streams one sentinel line per file; a watchdog kills it if a body
+ * hangs (the request budget only bounds synthetic-HTTP loops — a pure-compute
+ * or non-HTTP data loop would otherwise block forever). Files that never report
+ * before the watchdog fires are returned as timeout errors, so partial results
+ * survive and `glubean dry-run` never hangs.
+ */
+import type { TestShape } from "./dry-run.js";
+export interface DryRunFilesResult {
+    shapes: Array<TestShape & {
+        file: string;
+    }>;
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Project the shapes of every simple test exported from `files` by executing
+ * each body against a synthetic context in a tsx subprocess.
+ *
+ * @param files Absolute paths to test files.
+ * @param opts.cwd Working dir used to resolve the runner + zero-project mode
+ *   (defaults to `process.cwd()`).
+ * @param opts.timeoutMs Watchdog budget for the whole run (default 60s).
+ */
+export declare function dryRunFiles(files: string[], opts?: {
+    cwd?: string;
+    timeoutMs?: number;
+}): Promise<DryRunFilesResult>;
+//# sourceMappingURL=dry-run-spawn.d.ts.map

package/dist/dry-run-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-spawn.d.ts","sourceRoot":"","sources":["../src/dry-run-spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AA8FD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,OAAO,CAAC,iBAAiB,CAAC,CA+G5B"}

package/dist/dry-run-spawn.js

@@ -0,0 +1,218 @@
+/**
+ * Spawn-side of dry-run projection: launch the dry-run worker under tsx so it
+ * can import the user's TypeScript test modules, collect the projected shapes.
+ *
+ * Mirrors the TestExecutor spawn (tsx CLI + zero-project `--import` hook). The
+ * worker streams one sentinel line per file; a watchdog kills it if a body
+ * hangs (the request budget only bounds synthetic-HTTP loops — a pure-compute
+ * or non-HTTP data loop would otherwise block forever). Files that never report
+ * before the watchdog fires are returned as timeout errors, so partial results
+ * survive and `glubean dry-run` never hangs.
+ */
+import { spawn } from "node:child_process";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { extractAliasesFromSource } from "@glubean/scanner";
+import { prepareZeroProject, resolveRunnerRoot, resolveTsxPath } from "./runner-resolve.js";
+import { DRY_RUN_SENTINEL } from "./dry-run-worker.js";
+/** Default watchdog: max wall-clock for the whole worker run across all files. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** Grace period between SIGTERM and SIGKILL. */
+const KILL_GRACE_MS = 2_000;
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ALIAS_SKIP_DIRS = new Set(["node_modules", ".git", "dist", "build", ".next", "coverage", ".turbo"]);
+/**
+ * Collect test.extend() aliases across the whole project so the worker can fold
+ * bareBranchCount even for tests that import an alias from a helper file NOT in
+ * the dry-run input set. Bounded (skips heavy dirs, caps files) — alias scanning
+ * is a cheap regex, never executes user code.
+ */
+function collectProjectAliases(root, cap = 2000) {
+    const aliases = new Set();
+    let scanned = 0;
+    const walk = (dir) => {
+        if (scanned >= cap)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (scanned >= cap)
+                return;
+            if (e.isDirectory()) {
+                if (!ALIAS_SKIP_DIRS.has(e.name) && !e.name.startsWith("."))
+                    walk(resolve(dir, e.name));
+            }
+            else if (e.isFile() && /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/.test(e.name) && !e.name.endsWith(".d.ts")) {
+                scanned++;
+                try {
+                    for (const a of extractAliasesFromSource(readFileSync(resolve(dir, e.name), "utf8")))
+                        aliases.add(a);
+                }
+                catch {
+                    /* unreadable file → skip */
+                }
+            }
+        }
+    };
+    walk(root);
+    return [...aliases];
+}
+/** Run a node subprocess, killing it if it exceeds `timeoutMs`. */
+function runNode(args, cwd, env, timeoutMs) {
+    return new Promise((resolveOut, reject) => {
+        const child = spawn("node", args, { cwd, env, stdio: ["ignore", "pipe", "inherit"] });
+        let stdout = "";
+        let timedOut = false;
+        const watchdog = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            const hard = setTimeout(() => {
+                try {
+                    child.kill("SIGKILL");
+                }
+                catch {
+                    /* already gone */
+                }
+            }, KILL_GRACE_MS);
+            hard.unref?.();
+        }, timeoutMs);
+        watchdog.unref?.();
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.on("error", (err) => {
+            clearTimeout(watchdog);
+            reject(err);
+        });
+        child.on("close", (code, signal) => {
+            clearTimeout(watchdog);
+            resolveOut({ stdout, timedOut, code, signal });
+        });
+    });
+}
+/**
+ * Project the shapes of every simple test exported from `files` by executing
+ * each body against a synthetic context in a tsx subprocess.
+ *
+ * @param files Absolute paths to test files.
+ * @param opts.cwd Working dir used to resolve the runner + zero-project mode
+ *   (defaults to `process.cwd()`).
+ * @param opts.timeoutMs Watchdog budget for the whole run (default 60s).
+ */
+export async function dryRunFiles(files, opts = {}) {
+    if (files.length === 0)
+        return { shapes: [], errors: [] };
+    const cwd = opts.cwd ?? process.cwd();
+    const envTimeout = Number(process.env.GLUBEAN_DRYRUN_TIMEOUT_MS);
+    const timeoutMs = opts.timeoutMs ?? (Number.isFinite(envTimeout) && envTimeout > 0 ? envTimeout : DEFAULT_TIMEOUT_MS);
+    const bundledDistDir = __dirname;
+    const bundledPkgRoot = resolve(__dirname, "..");
+    const resolved = resolveRunnerRoot(cwd, bundledDistDir, bundledPkgRoot);
+    let distDir = resolved.distDir;
+    let pkgRoot = resolved.pkgRoot;
+    let workerPath = resolve(distDir, "dry-run-worker.js");
+    const oldProjectRunner = resolved.source === "project" && !existsSync(workerPath);
+    if (oldProjectRunner) {
+        // The resolved project runner predates dry-run support (has harness.js but
+        // no dry-run-worker.js). Fall back to the bundled worker — mirrors the
+        // load-harness fallback.
+        distDir = bundledDistDir;
+        pkgRoot = bundledPkgRoot;
+        workerPath = resolve(bundledDistDir, "dry-run-worker.js");
+    }
+    const zp = prepareZeroProject(cwd, distDir, pkgRoot);
+    // Split-SDK guard: the worker (+ its runWithRuntime carrier) runs from the
+    // BUNDLED runner — and thus the bundled @glubean/sdk — whenever resolveRunnerRoot
+    // had no usable PROJECT runner (`source === "bundled"`) or we fell back from an
+    // old project runner. If the project ALSO ships its own @glubean/sdk (empty
+    // tsxArgs ⟺ no vendored redirect), user modules import the PROJECT sdk while the
+    // worker installs the carrier on the BUNDLED sdk, so configure()/carrier helpers
+    // throw. Fail with an upgrade hint instead of projecting incorrectly. (A normal
+    // install where resolveRunnerRoot finds the project's own runner is `source ===
+    // "project"` and is NOT flagged, even if that runner is physically the bundled
+    // package.)
+    const workerFromBundled = resolved.source === "bundled" || oldProjectRunner;
+    if (workerFromBundled && zp.tsxArgs.length === 0) {
+        zp.cleanup();
+        return {
+            shapes: [],
+            errors: [
+                {
+                    file: "",
+                    message: "dry-run needs @glubean/runner with dry-run support, but the project's installed @glubean/runner predates `glubean dry-run`. Upgrade @glubean/runner in this project.",
+                },
+            ],
+        };
+    }
+    try {
+        const args = [resolveTsxPath(), ...zp.tsxArgs, workerPath, ...files];
+        const env = {
+            ...process.env,
+            ...zp.env,
+            // Project-wide test.extend() aliases so the worker folds bareBranchCount
+            // even for aliases imported from helper files outside the input set.
+            GLUBEAN_DRYRUN_ALIASES: JSON.stringify(collectProjectAliases(cwd)),
+        };
+        const { stdout, timedOut, code, signal } = await runNode(args, cwd, env, timeoutMs);
+        const shapes = [];
+        const errors = [];
+        const reported = new Set();
+        let sawRecord = false;
+        // Split on the sentinel rather than by line, so a record still parses when a
+        // user module wrote to stdout WITHOUT a trailing newline before it (the
+        // sentinel then sits mid-line). Each record is `SENTINEL{json}\n`.
+        const parts = stdout.split(DRY_RUN_SENTINEL);
+        for (let i = 1; i < parts.length; i++) {
+            const nl = parts[i].indexOf("\n");
+            const jsonStr = nl >= 0 ? parts[i].slice(0, nl) : parts[i];
+            let rec;
+            try {
+                rec = JSON.parse(jsonStr);
+            }
+            catch {
+                continue; // truncated (e.g. killed mid-write) — skip
+            }
+            sawRecord = true;
+            if (rec.file)
+                reported.add(rec.file);
+            if (rec.shapes?.length)
+                shapes.push(...rec.shapes);
+            if (rec.error)
+                errors.push({ file: rec.file, message: rec.error });
+        }
+        // Attribute every UNREPORTED file to a per-file error (never a blank path),
+        // so callers always know which projections are missing. A reported file —
+        // including a builder-only file that emits an empty-shapes record — is a
+        // valid result and is not flagged.
+        const unreported = files.filter((f) => !reported.has(f));
+        if (unreported.length > 0) {
+            let why;
+            if (timedOut) {
+                why = `projection timed out after ${timeoutMs}ms (possible infinite loop or unintercepted async wait)`;
+            }
+            else {
+                const abnormal = signal ? `signal ${signal}` : code !== 0 && code !== null ? `code ${code}` : null;
+                why = abnormal
+                    ? `worker exited with ${abnormal}`
+                    : !sawRecord
+                        ? "worker produced no output"
+                        : "worker exited early (a module likely called process.exit())";
+            }
+            for (const f of unreported) {
+                errors.push({ file: f, message: `not projected (${why})` });
+            }
+        }
+        return { shapes, errors };
+    }
+    finally {
+        zp.cleanup();
+    }
+}
+//# sourceMappingURL=dry-run-spawn.js.map

package/dist/dry-run-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-spawn.js","sourceRoot":"","sources":["../src/dry-run-spawn.ts"],"names":[],"mappings":"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"}

package/dist/dry-run-worker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Dry-run worker entry — runs UNDER tsx (so it can import the user's `.ts` test
+ * modules) with the zero-project `--import` hook (so their `@glubean/*` imports
+ * resolve). Spawned by `dryRunFiles()` in dry-run-spawn.ts.
+ *
+ * argv: absolute test-file paths.
+ * stdout: ONE line per file `__GLUBEAN_DRYRUN__<json>` with
+ * `{ file, shapes, error? }`, streamed as each file completes. The streaming is
+ * deliberate: if a later file's body hangs and the parent's watchdog kills this
+ * process, the already-emitted files' projections survive. The sentinel prefix
+ * isolates our payload from any `console.log` a test module emits at import.
+ */
+import { type TestShape } from "./dry-run.js";
+export declare const DRY_RUN_SENTINEL = "__GLUBEAN_DRYRUN__";
+/** One streamed line: the projection of a single file. */
+export interface DryRunFileResult {
+    file: string;
+    shapes: Array<TestShape & {
+        file: string;
+    }>;
+    error?: string;
+}
+//# sourceMappingURL=dry-run-worker.d.ts.map

package/dist/dry-run-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-worker.d.ts","sourceRoot":"","sources":["../src/dry-run-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/dry-run-worker.js

@@ -0,0 +1,137 @@
+/**
+ * Dry-run worker entry — runs UNDER tsx (so it can import the user's `.ts` test
+ * modules) with the zero-project `--import` hook (so their `@glubean/*` imports
+ * resolve). Spawned by `dryRunFiles()` in dry-run-spawn.ts.
+ *
+ * argv: absolute test-file paths.
+ * stdout: ONE line per file `__GLUBEAN_DRYRUN__<json>` with
+ * `{ file, shapes, error? }`, streamed as each file completes. The streaming is
+ * deliberate: if a later file's body hangs and the parent's watchdog kills this
+ * process, the already-emitted files' projections survive. The sentinel prefix
+ * isolates our payload from any `console.log` a test module emits at import.
+ */
+import { readFileSync, writeSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+import { extractAliasesFromSource, extractFromSource } from "@glubean/scanner";
+import { bootstrap } from "./bootstrap.js";
+import { dryRunTest, installDryRunGlobals } from "./dry-run.js";
+export const DRY_RUN_SENTINEL = "__GLUBEAN_DRYRUN__";
+/** Duck-type a simple Test object (`{ meta:{id}, type:"simple", fn }`). */
+function isSimpleTest(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    const t = v;
+    return t.type === "simple" && typeof t.fn === "function" && typeof t.meta?.id === "string";
+}
+function emit(rec) {
+    // Synchronous write to fd 1 so a streamed line is flushed to the pipe even if
+    // a later file's body calls process.exit() before async stdout would drain.
+    writeSync(1, DRY_RUN_SENTINEL + JSON.stringify(rec) + "\n");
+}
+async function main() {
+    const files = process.argv.slice(2);
+    // Neutralize raw I/O globals (e.g. fetch) BEFORE importing user modules, so
+    // even import-time or non-ctx I/O performs no real network call.
+    installDryRunGlobals();
+    // Collect test.extend() aliases across ALL input files (union) up front, so an
+    // alias declared in one input file and used by another is still recognized
+    // when folding bareBranchCount. (Aliases imported from files OUTSIDE the input
+    // set are still covered by the CLI's full-project scan + fold.)
+    const srcByFile = new Map();
+    const aliasSet = new Set();
+    // Project-wide aliases collected by the spawn parent (covers helper files
+    // outside the input set), unioned with the input files' own aliases.
+    try {
+        for (const a of JSON.parse(process.env.GLUBEAN_DRYRUN_ALIASES ?? "[]")) {
+            if (typeof a === "string")
+                aliasSet.add(a);
+        }
+    }
+    catch {
+        /* malformed env → fall back to input-file aliases only */
+    }
+    for (const f of files) {
+        try {
+            const s = readFileSync(f, "utf8");
+            srcByFile.set(f, s);
+            for (const a of extractAliasesFromSource(s))
+                aliasSet.add(a);
+        }
+        catch {
+            /* unreadable file → its import below will report the error */
+        }
+    }
+    const aliases = [...aliasSet];
+    // Run project setup (glubean.setup.ts) first so plugin/matcher registrations
+    // are installed before user modules import — same as the harness/load paths.
+    // A setup failure is surfaced but doesn't abort: per-file imports still run
+    // (and will report their own errors if they depend on the missing setup).
+    try {
+        await bootstrap(process.cwd());
+    }
+    catch (err) {
+        emit({ file: "", shapes: [], error: `setup (glubean.setup.ts) failed: ${err?.message ?? String(err)}` });
+    }
+    for (const file of files) {
+        const shapes = [];
+        try {
+            // Static bare-branch counts per export (AST, no execution) so the public
+            // dryRunFiles() API folds them into projectionComplete on its own — not
+            // only when the CLI patches shapes after a separate scan().
+            const bareByExport = new Map();
+            try {
+                const src = srcByFile.get(file) ?? readFileSync(file, "utf8");
+                // Pass the union of test.extend() aliases (as the scanner does) so
+                // aliased tests still get a bareBranchCount; extractFromSource merges
+                // BASE_FNS.
+                for (const m of extractFromSource(src, aliases)) {
+                    if (m.bareBranchCount)
+                        bareByExport.set(m.exportName, m.bareBranchCount);
+                }
+            }
+            catch {
+                /* best-effort: a parse failure just means no static signal */
+            }
+            const mod = await import(pathToFileURL(file).href);
+            for (const [exportName, val] of Object.entries(mod)) {
+                // `test.each(...)` / `test.pick(...)` export an ARRAY of simple Tests —
+                // one per generated row, each with its OWN testId AND its OWN bound row
+                // data. Project EACH row separately: a row builds requests/skips/asserts
+                // from its data (e.g. `row.base`), so cloning the first row's shape would
+                // misreport the others. A full-snapshot sync needs every row's true
+                // projection (replace would otherwise delete or corrupt the omitted rows).
+                const candidates = Array.isArray(val) ? val.filter(isSimpleTest) : isSimpleTest(val) ? [val] : [];
+                for (const c of candidates) {
+                    const shape = await dryRunTest(c, {
+                        exportName,
+                        bareBranchCount: bareByExport.get(exportName),
+                    });
+                    shapes.push({ file, ...shape });
+                }
+            }
+            emit({ file, shapes });
+        }
+        catch (err) {
+            emit({ file, shapes, error: err?.message ?? String(err) });
+        }
+    }
+}
+// Only run when invoked directly as the spawned entry — NOT when imported (e.g.
+// dry-run-spawn imports this module for DRY_RUN_SENTINEL). Without this guard,
+// main() would run in the importing process against ITS argv.
+const isEntry = !!process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isEntry) {
+    main()
+        .then(() => {
+        // Exit explicitly once every record is emitted (writeSync already flushed
+        // them). Otherwise an open handle left by an imported module / setup (timer,
+        // mock server, DB pool) would keep the process alive until the parent's
+        // watchdog kills it — making a completed projection appear to hang.
+        process.exit(0);
+    })
+        .catch((err) => {
+        emit({ file: "", shapes: [], error: String(err) });
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=dry-run-worker.js.map

package/dist/dry-run-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-worker.js","sourceRoot":"","sources":["../src/dry-run-worker.ts"],"names":[],"mappings":"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"}

package/dist/dry-run.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Dry-run projection (C2 / P2) — execute a simple test's function body with a
+ * SYNTHETIC context that records its SHAPE (assertions made, endpoints hit)
+ * without performing any real I/O. Powers `glubean dry-run`, whose output feeds
+ * the cloud "test definition" team-review view.
+ *
+ * This is a SEPARATE execution path from the runner harness and from the
+ * scanner: the scanner never executes user code (pure AST), while dry-run DOES
+ * import + invoke the test body. The synthetic ctx makes that safe — every
+ * effect is intercepted — and a request budget breaks data-dependent loops.
+ *
+ * Branch completeness: native `if`/`switch` only reveals the one arm the
+ * synthetic response happens to take, so authors should use `ctx.when()` /
+ * `ctx.switch()`, which the projector runs EXHAUSTIVELY (every arm, branch-
+ * tagged). The scanner's `bareBranchCount` is folded in to mark a projection
+ * partial when bare branches remain.
+ */
+import type { Test } from "@glubean/sdk";
+/** A single recorded assertion intent. */
+export interface ProjAssertion {
+    /** assert | expect.<matcher> | fail | validate */
+    kind: string;
+    message?: string;
+    /** Branch path, e.g. "when#0:then" or "switch#1:case[2]" (nested joined by ">"). */
+    branch?: string;
+}
+/** A single recorded endpoint hit. */
+export interface ProjEndpoint {
+    method: string;
+    url: string;
+    branch?: string;
+    /** Author-declared canonical endpoint pattern via `.track("GET /users/:id")` —
+     *  the exact key for endpoint-coverage linking (collapses concrete URLs). */
+    pattern?: string;
+}
+/** The projected shape of one test — what it verifies and what it touches. */
+export interface TestShape {
+    testId: string;
+    exportName: string;
+    /** Resolved declared tags (static + `test.each` `tagFields`, per generated row).
+     *  Taken from the RUNTIME `test.meta.tags`, not the static scan, so data-driven
+     *  row tags (e.g. `country:JP`) match what `glubean run --tag` sees. */
+    tags?: string[];
+    assertions: ProjAssertion[];
+    endpoints: ProjEndpoint[];
+    assertionCount: number;
+    /**
+     * True when the projector captured the test's full shape. False when a bare
+     * `if`/`switch` remained (only one arm followed), the request budget broke a
+     * loop, the body threw, or the test isn't a simple test.
+     */
+    projectionComplete: boolean;
+    /** Human-readable reason when `projectionComplete` is false. */
+    incompleteReason?: string;
+    /** True when the body called `ctx.skip()`. */
+    skipped?: boolean;
+}
+/**
+ * Patch I/O globals so a dry-run never performs real network I/O even when a
+ * test body bypasses `ctx.http` (e.g. raw `fetch`). Raw fetches route into the
+ * ALS-carried recorder of the active projection. Returns a release function;
+ * the stub is removed when the last holder releases (ref-counted). The worker
+ * installs once before imports and never releases (process-wide). (fs/db clients
+ * a test imports directly can't be generically stubbed — authoring guidance is
+ * to route I/O through `ctx`.)
+ */
+export declare function installDryRunGlobals(): () => void;
+/**
+ * Project one test's shape by executing its body against a synthetic ctx.
+ *
+ * @param test The Test object (from importing the test module).
+ * @param opts.exportName JS export name (for the shape label).
+ * @param opts.bareBranchCount Scanner-reported count of native `if`/`switch` in
+ *   the body — when > 0 the projection is marked partial.
+ */
+export declare function dryRunTest(test: Test, opts: {
+    exportName: string;
+    bareBranchCount?: number;
+}): Promise<TestShape>;
+//# sourceMappingURL=dry-run.d.ts.map

package/dist/dry-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run.d.ts","sourceRoot":"","sources":["../src/dry-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,cAAc,CAAC;AAGlE,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;iFAC6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB;;4EAEwE;IACxE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkHD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,IAAI,CAuCjD;AAkQD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,SAAS,CAAC,CA6FpB"}