@untestutils/core 0.5.0

package/dist/drivers/index.mjs

@@ -0,0 +1,6 @@
+export { defineDriver } from "./define-driver.mjs";
+export { command } from "./command.mjs";
+export { staticDir } from "./static-dir.mjs";
+export { nodeEntry } from "./node-entry.mjs";
+export { host } from "./host.mjs";
+export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./cli-framework.mjs";

package/dist/drivers/node-entry.d.mts

@@ -0,0 +1,13 @@
+import { type Recipe } from "../index.mjs";
+export interface NodeEntryOptions {
+	id: string;
+	entry: string;
+	cwd?: string;
+	prepare?: string;
+	hashInputs?: string[];
+	readyPath?: string;
+	readyTimeoutMs?: number;
+	env?: Record<string, string>;
+}
+export declare function nodeEntry(opts: NodeEntryOptions): Recipe;
+export default nodeEntry;

package/dist/drivers/node-entry.d.ts

@@ -0,0 +1,14 @@
+import { type Recipe } from '..';
+export interface NodeEntryOptions {
+    id: string;
+    entry: string;
+    cwd?: string;
+    prepare?: string;
+    hashInputs?: string[];
+    readyPath?: string;
+    readyTimeoutMs?: number;
+    env?: Record<string, string>;
+}
+export declare function nodeEntry(opts: NodeEntryOptions): Recipe;
+export default nodeEntry;
+//# sourceMappingURL=node-entry.d.ts.map

package/dist/drivers/node-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-entry.d.ts","sourceRoot":"","sources":["../../src/drivers/node-entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,IAAI,CAAC;AAEZ,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAoDxD;AAED,eAAe,SAAS,CAAC"}

package/dist/drivers/node-entry.mjs

@@ -0,0 +1,55 @@
+import { existsSync } from "node:fs";
+import { resolve } from "pathe";
+import { defineRecipe, loopbackUrl, waitForHttpReady, spawnManaged } from "../index.mjs";
+export function nodeEntry(opts) {
+	const entry = resolve(opts.entry);
+	const cwd = opts.cwd ? resolve(opts.cwd) : undefined;
+	const ensureEntry = () => {
+		if (!existsSync(entry)) {
+			throw new Error(`[untestutils/nodeEntry] entry not found: ${entry}`);
+		}
+	};
+	return defineRecipe({
+		id: opts.id,
+		share: "always",
+		hashInputs: async () => opts.hashInputs?.map((p) => resolve(p)) ?? [entry, ...cwd ? [cwd] : []],
+		ready: async () => {},
+		prepare: opts.prepare ? async ({ run }) => {
+			ensureEntry();
+			const result = await run.command(opts.prepare, { cwd });
+			if (result.exitCode !== 0) {
+				throw new Error(`[untestutils/nodeEntry] prepare failed:\n${result.stderr.slice(-2e3)}`);
+			}
+		} : undefined,
+		start: async ({ port, host }) => {
+			ensureEntry();
+			const managed = spawnManaged(process.execPath, [entry], {
+				cwd,
+				env: {
+					...process.env,
+					...opts.env,
+					PORT: String(port),
+					HOST: host
+				},
+				captureLogs: true
+			});
+			const url = loopbackUrl(port, "/", host);
+			try {
+				await waitForHttpReady(url, {
+					path: opts.readyPath ?? "/",
+					timeoutMs: opts.readyTimeoutMs
+				});
+			} catch (e) {
+				await managed.stop();
+				throw new Error(`[untestutils/nodeEntry] ready failed:\n${e}\n--- server logs ---\n${managed.logs().slice(-4e3)}`);
+			}
+			return {
+				kind: "url",
+				url,
+				stop: managed.stop,
+				pid: managed.pid
+			};
+		}
+	});
+}
+export default nodeEntry;

package/dist/drivers/static-dir.d.mts

@@ -0,0 +1,9 @@
+import { type Recipe } from "../index.mjs";
+export interface StaticDirOptions {
+	id: string;
+	root: string;
+	hashInputs?: string[];
+	readyPath?: string;
+}
+export declare function staticDir(opts: StaticDirOptions): Recipe;
+export default staticDir;

package/dist/drivers/static-dir.d.ts

@@ -0,0 +1,10 @@
+import { type Recipe } from '..';
+export interface StaticDirOptions {
+    id: string;
+    root: string;
+    hashInputs?: string[];
+    readyPath?: string;
+}
+export declare function staticDir(opts: StaticDirOptions): Recipe;
+export default staticDir;
+//# sourceMappingURL=static-dir.d.ts.map

package/dist/drivers/static-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-dir.d.ts","sourceRoot":"","sources":["../../src/drivers/static-dir.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+C,KAAK,MAAM,EAAE,MAAM,IAAI,CAAC;AAgB9E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA8ExD;AAED,eAAe,SAAS,CAAC"}

package/dist/drivers/static-dir.mjs

@@ -0,0 +1,90 @@
+import { createServer } from "node:http";
+import { existsSync } from "node:fs";
+import { readFile, stat } from "node:fs/promises";
+import { extname, join, normalize, resolve, sep } from "pathe";
+import { defineRecipe, loopbackUrl, waitForHttpReady } from "../index.mjs";
+const MIME = {
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".json": "application/json",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".ico": "image/x-icon",
+	".txt": "text/plain; charset=utf-8",
+	".wasm": "application/wasm"
+};
+export function staticDir(opts) {
+	const root = resolve(opts.root);
+	return defineRecipe({
+		id: opts.id,
+		share: "always",
+		hashInputs: async () => opts.hashInputs?.map((p) => resolve(p)) ?? [root],
+		
+		ready: async () => {},
+		start: async ({ port, host }) => {
+			if (!existsSync(root)) {
+				throw new Error(`[untestutils/staticDir] root not found: ${root}`);
+			}
+			const server = createServer(async (req, res) => {
+				try {
+					const urlPath = decodeURIComponent((req.url ?? "/").split("?")[0] || "/");
+					let filePath = join(root, urlPath === "/" ? "index.html" : urlPath);
+					
+					const normalized = normalize(filePath);
+					if (!normalized.startsWith(normalize(root) + sep) && normalized !== normalize(root)) {
+						res.statusCode = 403;
+						res.end("Forbidden");
+						return;
+					}
+					let st = await stat(normalized).catch(() => null);
+					if (st?.isDirectory()) {
+						filePath = join(normalized, "index.html");
+						st = await stat(filePath).catch(() => null);
+					} else {
+						filePath = normalized;
+					}
+					if (!st?.isFile()) {
+						
+						const fallback = join(root, "index.html");
+						const fb = await stat(fallback).catch(() => null);
+						if (fb?.isFile()) {
+							const body = await readFile(fallback);
+							res.setHeader("Content-Type", "text/html; charset=utf-8");
+							res.end(body);
+							return;
+						}
+						res.statusCode = 404;
+						res.end("Not Found");
+						return;
+					}
+					const body = await readFile(filePath);
+					res.setHeader("Content-Type", MIME[extname(filePath)] ?? "application/octet-stream");
+					res.end(body);
+				} catch (e) {
+					res.statusCode = 500;
+					res.end(String(e));
+				}
+			});
+			await new Promise((resolvePromise, reject) => {
+				server.listen(port, host, () => resolvePromise());
+				server.once("error", (err) => {
+					reject(new Error(`[untestutils/staticDir] listen failed on ${host}:${port}: ${err.message}`, { cause: err }));
+				});
+			});
+			const url = loopbackUrl(port, "/", host);
+			await waitForHttpReady(url, { path: opts.readyPath ?? "/" });
+			return {
+				kind: "url+dir",
+				url,
+				dir: root,
+				stop: async () => new Promise((resolvePromise) => {
+					server.close(() => resolvePromise());
+				})
+			};
+		}
+	});
+}
+export default staticDir;

package/dist/harness.d.mts

@@ -0,0 +1,4 @@
+import type { HarnessHandle, Recipe, UseHarnessOptions } from "./types.mjs";
+export declare function useHarness(recipe: string | Recipe, _opts?: UseHarnessOptions): Promise<HarnessHandle>;
+export declare function getCurrentHarness(): HarnessHandle | undefined;
+export declare function getHarness(id: string): HarnessHandle | undefined;

package/dist/harness.d.ts

@@ -0,0 +1,5 @@
+import type { HarnessHandle, Recipe, UseHarnessOptions } from './types';
+export declare function useHarness(recipe: string | Recipe, _opts?: UseHarnessOptions): Promise<HarnessHandle>;
+export declare function getCurrentHarness(): HarnessHandle | undefined;
+export declare function getHarness(id: string): HarnessHandle | undefined;
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../src/harness.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAOxE,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,KAAK,GAAE,iBAAsB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAE7D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEhE"}

package/dist/harness.mjs

@@ -0,0 +1,18 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHarnessHandle, ensurePrepared } from "./orchestrator.mjs";
+import { resolveArtifactsRoot } from "./paths.mjs";
+const storage = new AsyncLocalStorage();
+const handles = new Map();
+export async function useHarness(recipe, _opts = {}) {
+	const prepared = await ensurePrepared(recipe, { artifactsRoot: resolveArtifactsRoot() });
+	const handle = createHarnessHandle(prepared);
+	handles.set(handle.id, handle);
+	storage.enterWith(handle);
+	return handle;
+}
+export function getCurrentHarness() {
+	return storage.getStore();
+}
+export function getHarness(id) {
+	return handles.get(id);
+}

package/dist/hash.d.mts

@@ -0,0 +1,6 @@
+export declare function sha1(content: Buffer | string): string;
+export declare function hashFile(path: string): Promise<string>;
+export declare function collectFileHashes(dir: string, lines: string[], root?: string): Promise<void>;
+export declare function contentHash(inputs: string[]): Promise<string>;
+export declare function hashString(value: string): string;
+export declare function streamSha1(path: string): Promise<string>;

package/dist/hash.d.ts

@@ -0,0 +1,7 @@
+export declare function sha1(content: Buffer | string): string;
+export declare function hashFile(path: string): Promise<string>;
+export declare function collectFileHashes(dir: string, lines: string[], root?: string): Promise<void>;
+export declare function contentHash(inputs: string[]): Promise<string>;
+export declare function hashString(value: string): string;
+export declare function streamSha1(path: string): Promise<string>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAqBA,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAErD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG5D;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,MAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAenE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ9D"}

package/dist/hash.mjs

@@ -0,0 +1,76 @@
+import { createHash } from "node:crypto";
+import { createReadStream, existsSync } from "node:fs";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative } from "pathe";
+const SKIP_DIRS = new Set([
+	"node_modules",
+	".git",
+	".nuxt",
+	".output",
+	".untestutils",
+	"dist",
+	"coverage",
+	"test-results",
+	".data",
+	".turbo",
+	".next"
+]);
+const SKIP_FILES = new Set([
+	".DS_Store",
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"yarn.lock"
+]);
+export function sha1(content) {
+	return createHash("sha1").update(content).digest("hex");
+}
+export async function hashFile(path) {
+	const buf = await readFile(path);
+	return sha1(buf);
+}
+export async function collectFileHashes(dir, lines, root = dir) {
+	if (!existsSync(dir)) return;
+	let entries;
+	try {
+		entries = await readdir(dir, { withFileTypes: true });
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		if (SKIP_DIRS.has(entry.name) || SKIP_FILES.has(entry.name)) continue;
+		const path = join(dir, entry.name);
+		if (entry.isDirectory()) {
+			await collectFileHashes(path, lines, root);
+		} else if (entry.isFile()) {
+			lines.push(`${relative(root, path)}|${await hashFile(path)}`);
+		}
+	}
+}
+export async function contentHash(inputs) {
+	const lines = [];
+	for (const input of inputs) {
+		if (!existsSync(input)) {
+			lines.push(`missing:${input}`);
+			continue;
+		}
+		const s = await stat(input);
+		if (s.isDirectory()) {
+			await collectFileHashes(input, lines, input);
+		} else {
+			lines.push(`${input}|${await hashFile(input)}`);
+		}
+	}
+	return sha1(lines.sort().join("\n"));
+}
+export function hashString(value) {
+	return sha1(value);
+}
+export async function streamSha1(path) {
+	return new Promise((resolve, reject) => {
+		const hash = createHash("sha1");
+		const stream = createReadStream(path);
+		stream.on("data", (chunk) => hash.update(chunk));
+		stream.on("end", () => resolve(hash.digest("hex")));
+		stream.on("error", reject);
+	});
+}

package/dist/identity.d.mts

@@ -0,0 +1,9 @@
+import { type Recipe } from "./types.mjs";
+export declare function computeIdentity(recipe: Recipe, artifactsRoot: string, root?: string): Promise<{
+	identity: string;
+	hash: string;
+	id: string;
+}>;
+/** Detect colliding Recipe.id pointing at different identity hashes in-process. */
+export declare function assertUniqueRecipeBinding(id: string, identity: string): void;
+export declare function resetRecipeBindings(): void;

package/dist/identity.d.ts

@@ -0,0 +1,10 @@
+import { type Recipe } from './types';
+export declare function computeIdentity(recipe: Recipe, artifactsRoot: string, root?: string): Promise<{
+    identity: string;
+    hash: string;
+    id: string;
+}>;
+/** Detect colliding Recipe.id pointing at different identity hashes in-process. */
+export declare function assertUniqueRecipeBinding(id: string, identity: string): void;
+export declare function resetRecipeBindings(): void;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpE,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAwBD;AAQD,mFAAmF;AACnF,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ5E;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/identity.mjs

@@ -0,0 +1,44 @@
+import { resolve } from "pathe";
+import { contentHash, hashString } from "./hash.mjs";
+import { SCHEMA_VERSION } from "./types.mjs";
+export async function computeIdentity(recipe, artifactsRoot, root) {
+	const id = recipe.id;
+	if (!id) {
+		throw new Error("[untestutils] Recipe.id is required for sharing and registry");
+	}
+	const ctx = {
+		root: root ? resolve(root) : undefined,
+		outDir: "",
+		artifactsRoot
+	};
+	const inputParts = [];
+	if (recipe.hashInputs) {
+		const inputs = await recipe.hashInputs(ctx);
+		inputParts.push(...inputs.map((p) => resolve(p)));
+	} else if (root) {
+		inputParts.push(resolve(root));
+	}
+	const content = inputParts.length ? await contentHash(inputParts) : hashString(id);
+	const hash = hashString(`${SCHEMA_VERSION}|${id}|${content}|${recipe.share ?? "always"}`);
+	const identity = `${sanitize(id)}-${hash.slice(0, 12)}`;
+	return {
+		identity,
+		hash,
+		id
+	};
+}
+function sanitize(id) {
+	return id.replace(/[^a-zA-Z0-9._-]+/g, "-").slice(0, 64);
+}
+const registryIds = new Map();
+
+export function assertUniqueRecipeBinding(id, identity) {
+	const prev = registryIds.get(id);
+	if (prev && prev !== identity) {
+		throw new Error(`[untestutils] Recipe id "${id}" is bound to conflicting identities (${prev} vs ${identity}). Use distinct ids.`);
+	}
+	registryIds.set(id, identity);
+}
+export function resetRecipeBindings() {
+	registryIds.clear();
+}

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+export type { Recipe, RecipeFactory, RecipeRegistry, Running, HarnessHandle, SharePolicy, PrepareCtx, StartCtx, HashCtx, UseHarnessOptions } from "./types.mjs";
+export { SCHEMA_VERSION } from "./types.mjs";
+export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes } from "./recipes.mjs";
+export { useHarness, getCurrentHarness, getHarness } from "./harness.mjs";
+export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests } from "./orchestrator.mjs";
+export { TargetRegistry, envKey, envDirKey } from "./target-registry.mjs";
+export { ArtifactStore } from "./artifact-store.mjs";
+export { FileLock, atomicWriteJson, atomicWriteText, lockPathFor } from "./lock.mjs";
+export { contentHash, sha1, hashString, collectFileHashes } from "./hash.mjs";
+export { getFreePort, waitForPort } from "./ports.mjs";
+export { LOOPBACK_HOST, loopbackUrl, normalizeBaseUrl, resolveArtifactsRoot, resolveBindHost, resolveProbeHost, findRepoRoot } from "./paths.mjs";
+export { waitForHttpReady, defaultReady } from "./ready.mjs";
+export { scrubTestEnv, spawnManaged, runCommand, killProcessTree, killPidTree, isPidAlive } from "./process.mjs";
+export { createRunHelper } from "./run-helper.mjs";
+export { debug, isDebug, log, envFlag } from "./debug.mjs";
+export { progress, isQuiet, isCi, isProgressEnabled, progressIo, withQuietLogger } from "./progress.mjs";
+export { computeIdentity, assertUniqueRecipeBinding, resetRecipeBindings } from "./identity.mjs";
+export type { Driver } from "./drivers/define-driver.mjs";
+export { defineDriver } from "./drivers/define-driver.mjs";
+export { command } from "./drivers/command.mjs";
+export type { CommandOptions } from "./drivers/command.mjs";
+export { staticDir } from "./drivers/static-dir.mjs";
+export type { StaticDirOptions } from "./drivers/static-dir.mjs";
+export { nodeEntry } from "./drivers/node-entry.mjs";
+export type { NodeEntryOptions } from "./drivers/node-entry.mjs";
+export { host } from "./drivers/host.mjs";
+export type { HostOptions } from "./drivers/host.mjs";
+export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./drivers/cli-framework.mjs";
+export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions } from "./drivers/cli-framework.mjs";

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export type { Recipe, RecipeFactory, RecipeRegistry, Running, HarnessHandle, SharePolicy, PrepareCtx, StartCtx, HashCtx, UseHarnessOptions, } from './types';
+export { SCHEMA_VERSION } from './types';
+export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes, } from './recipes';
+export { useHarness, getCurrentHarness, getHarness } from './harness';
+export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests, } from './orchestrator';
+export { TargetRegistry, envKey, envDirKey } from './target-registry';
+export { ArtifactStore } from './artifact-store';
+export { FileLock, atomicWriteJson, atomicWriteText, lockPathFor } from './lock';
+export { contentHash, sha1, hashString, collectFileHashes } from './hash';
+export { getFreePort, waitForPort } from './ports';
+export { LOOPBACK_HOST, loopbackUrl, normalizeBaseUrl, resolveArtifactsRoot, resolveBindHost, resolveProbeHost, findRepoRoot, } from './paths';
+export { waitForHttpReady, defaultReady } from './ready';
+export { scrubTestEnv, spawnManaged, runCommand, killProcessTree, killPidTree, isPidAlive, } from './process';
+export { createRunHelper } from './run-helper';
+export { debug, isDebug, log, envFlag } from './debug';
+export { progress, isQuiet, isCi, isProgressEnabled, progressIo, withQuietLogger, } from './progress';
+export { computeIdentity, assertUniqueRecipeBinding, resetRecipeBindings } from './identity';
+export type { Driver } from './drivers/define-driver';
+export { defineDriver } from './drivers/define-driver';
+export { command } from './drivers/command';
+export type { CommandOptions } from './drivers/command';
+export { staticDir } from './drivers/static-dir';
+export type { StaticDirOptions } from './drivers/static-dir';
+export { nodeEntry } from './drivers/node-entry';
+export type { NodeEntryOptions } from './drivers/node-entry';
+export { host } from './drivers/host';
+export type { HostOptions } from './drivers/host';
+export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals, } from './drivers/cli-framework';
+export type { ResolveBinOptions, SpawnSpec, CliFrameworkRecipeOptions, FrameworkBaseOptions, } from './drivers/cli-framework';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,aAAa,EACb,cAAc,EACd,OAAO,EACP,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EACL,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG7F,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,22 @@
+export { SCHEMA_VERSION } from "./types.mjs";
+export { defineRecipe, defineRecipes, ensureRecipes, getRegisteredRecipe, getRecipesModulePath, listRegisteredRecipes, clearRegisteredRecipes } from "./recipes.mjs";
+export { useHarness, getCurrentHarness, getHarness } from "./harness.mjs";
+export { ensurePrepared, stopAllTargets, reclaimStaleTargets, resolveRecipe, detachLiveTargetsForTests } from "./orchestrator.mjs";
+export { TargetRegistry, envKey, envDirKey } from "./target-registry.mjs";
+export { ArtifactStore } from "./artifact-store.mjs";
+export { FileLock, atomicWriteJson, atomicWriteText, lockPathFor } from "./lock.mjs";
+export { contentHash, sha1, hashString, collectFileHashes } from "./hash.mjs";
+export { getFreePort, waitForPort } from "./ports.mjs";
+export { LOOPBACK_HOST, loopbackUrl, normalizeBaseUrl, resolveArtifactsRoot, resolveBindHost, resolveProbeHost, findRepoRoot } from "./paths.mjs";
+export { waitForHttpReady, defaultReady } from "./ready.mjs";
+export { scrubTestEnv, spawnManaged, runCommand, killProcessTree, killPidTree, isPidAlive } from "./process.mjs";
+export { createRunHelper } from "./run-helper.mjs";
+export { debug, isDebug, log, envFlag } from "./debug.mjs";
+export { progress, isQuiet, isCi, isProgressEnabled, progressIo, withQuietLogger } from "./progress.mjs";
+export { computeIdentity, assertUniqueRecipeBinding, resetRecipeBindings } from "./identity.mjs";
+export { defineDriver } from "./drivers/define-driver.mjs";
+export { command } from "./drivers/command.mjs";
+export { staticDir } from "./drivers/static-dir.mjs";
+export { nodeEntry } from "./drivers/node-entry.mjs";
+export { host } from "./drivers/host.mjs";
+export { resolveBin, assertAppRoot, cliFrameworkRecipe, frameworkRoots, _cliInternals } from "./drivers/cli-framework.mjs";

package/dist/lock.d.mts

@@ -0,0 +1,26 @@
+export interface LockInfo {
+	pid: number;
+	startedAt: number;
+	heartbeatAt: number;
+	identity: string;
+}
+export declare class FileLock {
+	private readonly lockPath;
+	private readonly identity;
+	private readonly staleMs;
+	private heartbeat?;
+	private held;
+	constructor(lockPath: string, identity: string, staleMs?: number);
+	acquire(timeoutMs?: number): Promise<void>;
+	release(): Promise<void>;
+	private startHeartbeat;
+	private stopHeartbeat;
+	private beat;
+	private tryStealStale;
+}
+export declare function atomicWriteJson(path: string, data: unknown): Promise<void>;
+export declare function atomicWriteText(path: string, content: string): Promise<void>;
+export declare function markReady(readyPath: string): Promise<void>;
+export declare function isReady(readyPath: string): Promise<boolean>;
+export declare function removePath(path: string): Promise<void>;
+export declare function lockPathFor(artifactsRoot: string, identity: string): string;

package/dist/lock.d.ts

@@ -0,0 +1,27 @@
+export interface LockInfo {
+    pid: number;
+    startedAt: number;
+    heartbeatAt: number;
+    identity: string;
+}
+export declare class FileLock {
+    private readonly lockPath;
+    private readonly identity;
+    private readonly staleMs;
+    private heartbeat?;
+    private held;
+    constructor(lockPath: string, identity: string, staleMs?: number);
+    acquire(timeoutMs?: number): Promise<void>;
+    release(): Promise<void>;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private beat;
+    private tryStealStale;
+}
+export declare function atomicWriteJson(path: string, data: unknown): Promise<void>;
+export declare function atomicWriteText(path: string, content: string): Promise<void>;
+export declare function markReady(readyPath: string): Promise<void>;
+export declare function isReady(readyPath: string): Promise<boolean>;
+export declare function removePath(path: string): Promise<void>;
+export declare function lockPathFor(artifactsRoot: string, identity: string): string;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAcD,qBAAa,QAAQ;IAKjB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,IAAI,CAAS;gBAGF,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,MAAyB;IAG/C,OAAO,CAAC,SAAS,GAAE,MAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;YAKP,IAAI;YAqBJ,aAAa;CAwB5B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlF;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5D;AAMD,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E"}