@untestutils/perf 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 s00d
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/average.d.mts

@@ -0,0 +1,4 @@
+import type { BuildMetrics, LoadMetrics, PerfTargetResult } from "./types.mjs";
+export declare function averageBuildMetrics(results: BuildMetrics[]): BuildMetrics;
+export declare function averageLoadMetrics(results: LoadMetrics[]): LoadMetrics;
+export declare function averageTargetResults(results: PerfTargetResult[]): PerfTargetResult;

package/dist/average.d.ts

@@ -0,0 +1,5 @@
+import type { BuildMetrics, LoadMetrics, PerfTargetResult } from './types';
+export declare function averageBuildMetrics(results: BuildMetrics[]): BuildMetrics;
+export declare function averageLoadMetrics(results: LoadMetrics[]): LoadMetrics;
+export declare function averageTargetResults(results: PerfTargetResult[]): PerfTargetResult;
+//# sourceMappingURL=average.d.ts.map

package/dist/average.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"average.d.ts","sourceRoot":"","sources":["../src/average.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEZ,WAAW,EACX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAoDjB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,CAYzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAsBtE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAUlF"}

package/dist/average.mjs

@@ -0,0 +1,92 @@
+function avg(values) {
+	const nums = values.filter((v) => typeof v === "number" && Number.isFinite(v));
+	if (!nums.length) return undefined;
+	return nums.reduce((a, b) => a + b, 0) / nums.length;
+}
+function averageBundle(sizes) {
+	const present = sizes.filter((s) => Boolean(s));
+	if (!present.length) return undefined;
+	const byDir = {};
+	for (const s of present) {
+		for (const [k, v] of Object.entries(s.byDir)) {
+			byDir[k] = (byDir[k] ?? 0) + v;
+		}
+	}
+	for (const k of Object.keys(byDir)) byDir[k] /= present.length;
+	return {
+		total: avg(present.map((s) => s.total)) ?? 0,
+		code: avg(present.map((s) => s.code)) ?? 0,
+		asset: avg(present.map((s) => s.asset)) ?? 0,
+		other: avg(present.map((s) => s.other)) ?? 0,
+		byDir
+	};
+}
+function averageAutocannon(items) {
+	const present = items.filter((a) => Boolean(a));
+	if (!present.length) return undefined;
+	return {
+		requests: {
+			average: avg(present.map((a) => a.requests.average)) ?? 0,
+			mean: avg(present.map((a) => a.requests.mean)) ?? 0,
+			total: avg(present.map((a) => a.requests.total)) ?? 0
+		},
+		latency: {
+			average: avg(present.map((a) => a.latency.average)) ?? 0,
+			mean: avg(present.map((a) => a.latency.mean)) ?? 0,
+			min: avg(present.map((a) => a.latency.min)) ?? 0,
+			max: avg(present.map((a) => a.latency.max)) ?? 0,
+			p50: avg(present.map((a) => a.latency.p50)) ?? 0,
+			p97_5: avg(present.map((a) => a.latency.p97_5)) ?? 0,
+			p99: avg(present.map((a) => a.latency.p99)) ?? 0
+		},
+		throughput: { average: avg(present.map((a) => a.throughput.average)) ?? 0 },
+		errors: avg(present.map((a) => a.errors)) ?? 0
+	};
+}
+export function averageBuildMetrics(results) {
+	if (!results.length) throw new Error("cannot average empty build metrics");
+	return {
+		buildTimeSec: avg(results.map((r) => r.buildTimeSec)) ?? 0,
+		maxMemoryMb: avg(results.map((r) => r.maxMemoryMb)) ?? 0,
+		minMemoryMb: avg(results.map((r) => r.minMemoryMb)) ?? 0,
+		avgMemoryMb: avg(results.map((r) => r.avgMemoryMb)) ?? 0,
+		maxCpuPct: avg(results.map((r) => r.maxCpuPct)) ?? 0,
+		minCpuPct: avg(results.map((r) => r.minCpuPct)) ?? 0,
+		avgCpuPct: avg(results.map((r) => r.avgCpuPct)) ?? 0,
+		bundle: averageBundle(results.map((r) => r.bundle))
+	};
+}
+export function averageLoadMetrics(results) {
+	if (!results.length) throw new Error("cannot average empty load metrics");
+	const last = results[results.length - 1];
+	return {
+		maxMemoryMb: avg(results.map((r) => r.maxMemoryMb)) ?? 0,
+		minMemoryMb: avg(results.map((r) => r.minMemoryMb)) ?? 0,
+		avgMemoryMb: avg(results.map((r) => r.avgMemoryMb)) ?? 0,
+		maxCpuPct: avg(results.map((r) => r.maxCpuPct)) ?? 0,
+		minCpuPct: avg(results.map((r) => r.minCpuPct)) ?? 0,
+		avgCpuPct: avg(results.map((r) => r.avgCpuPct)) ?? 0,
+		durationSec: avg(results.map((r) => r.durationSec)),
+		responseTimeAvg: avg(results.map((r) => r.responseTimeAvg)),
+		responseTimeMin: avg(results.map((r) => r.responseTimeMin)),
+		responseTimeMax: avg(results.map((r) => r.responseTimeMax)),
+		responseTimeP50: avg(results.map((r) => r.responseTimeP50)),
+		responseTimeP95: avg(results.map((r) => r.responseTimeP95)),
+		responseTimeP99: avg(results.map((r) => r.responseTimeP99)),
+		requestsPerSecond: avg(results.map((r) => r.requestsPerSecond)),
+		errorRate: avg(results.map((r) => r.errorRate)),
+		autocannon: averageAutocannon(results.map((r) => r.autocannon)),
+		artillery: last.artillery
+	};
+}
+export function averageTargetResults(results) {
+	if (!results.length) throw new Error("cannot average empty target results");
+	const first = results[0];
+	const loads = results.map((r) => r.load).filter((l) => Boolean(l));
+	return {
+		id: first.id,
+		label: first.label,
+		build: averageBuildMetrics(results.map((r) => r.build)),
+		load: loads.length === results.length ? averageLoadMetrics(loads) : undefined
+	};
+}

package/dist/build.d.mts

@@ -0,0 +1,2 @@
+import type { BuildMetrics, PerfTarget } from "./types.mjs";
+export declare function measureBuild(target: PerfTarget): Promise<BuildMetrics>;

package/dist/build.d.ts

@@ -0,0 +1,3 @@
+import type { BuildMetrics, PerfTarget } from './types';
+export declare function measureBuild(target: PerfTarget): Promise<BuildMetrics>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKxD,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAiE5E"}

package/dist/build.mjs

@@ -0,0 +1,69 @@
+import { spawn } from "node:child_process";
+import { performance } from "node:perf_hooks";
+import { resolve } from "pathe";
+import { measureBundle } from "./bundle.mjs";
+import { finalizeSamples, startProcessMonitor } from "./process-sample.mjs";
+const defaultLogFilter = (line) => /Building|built|ERROR|WARN|preset|complete|Nitro|Client|Server|✓|✔/i.test(line);
+export async function measureBuild(target) {
+	const cwd = resolve(target.build.cwd ?? target.root);
+	const args = target.build.args ?? [];
+	const env = {
+		PATH: process.env.PATH,
+		HOME: process.env.HOME,
+		USER: process.env.USER,
+		SHELL: process.env.SHELL,
+		NODE_ENV: "production",
+		...target.build.env
+	};
+	const started = performance.now();
+	const child = spawn(target.build.command, args, {
+		cwd,
+		env,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+	const filter = target.build.logFilter ?? defaultLogFilter;
+	child.stdout?.on("data", (buf) => {
+		for (const line of buf.toString().split("\n")) {
+			const t = line.trim();
+			if (t && filter(t)) console.log(`  [build] ${t.slice(0, 200)}`);
+		}
+	});
+	child.stderr?.on("data", (buf) => {
+		const t = buf.toString().trim();
+		if (t) console.error(`  [build stderr] ${t.slice(0, 240)}`);
+	});
+	const monitor = child.pid ? startProcessMonitor(child.pid, 1e3, (s) => {
+		
+		void s;
+	}) : undefined;
+	try {
+		await new Promise((resolvePromise, reject) => {
+			child.on("close", (code) => {
+				if (code === 0) resolvePromise();
+				else reject(new Error(`Build exited with code ${code}`));
+			});
+			child.on("error", reject);
+		});
+	} finally {
+		monitor?.stop();
+	}
+	const buildTimeSec = (performance.now() - started) / 1e3;
+	const processMetrics = monitor ? finalizeSamples(monitor.acc) : {
+		maxMemoryMb: 0,
+		minMemoryMb: 0,
+		avgMemoryMb: 0,
+		maxCpuPct: 0,
+		minCpuPct: 0,
+		avgCpuPct: 0
+	};
+	const bundle = target.bundle ? measureBundle(resolve(target.root), target.bundle) : undefined;
+	return {
+		buildTimeSec,
+		...processMetrics,
+		bundle
+	};
+}

package/dist/bundle.d.mts

@@ -0,0 +1,2 @@
+import type { BundleSize, PerfTargetBundle } from "./types.mjs";
+export declare function measureBundle(root: string, opts: PerfTargetBundle): BundleSize;

package/dist/bundle.d.ts

@@ -0,0 +1,3 @@
+import type { BundleSize, PerfTargetBundle } from './types';
+export declare function measureBundle(root: string, opts: PerfTargetBundle): BundleSize;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAmBzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CAyB9E"}

package/dist/bundle.mjs

@@ -0,0 +1,42 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { basename, join } from "pathe";
+function walk(dir, classify, into) {
+	if (!existsSync(dir)) return;
+	for (const entry of readdirSync(dir, { withFileTypes: true })) {
+		const full = join(dir, entry.name);
+		if (entry.isDirectory()) walk(full, classify, into);
+		else {
+			const size = statSync(full).size;
+			const kind = classify(full);
+			into[kind] += size;
+		}
+	}
+}
+export function measureBundle(root, opts) {
+	const classify = opts.classify ?? (() => "code");
+	const byDir = {};
+	let code = 0;
+	let asset = 0;
+	let other = 0;
+	for (const rel of opts.dirs) {
+		const dir = rel.startsWith("/") ? rel : join(root, rel);
+		const bucket = {
+			code: 0,
+			asset: 0,
+			other: 0
+		};
+		walk(dir, classify, bucket);
+		const name = basename(dir);
+		byDir[name] = bucket.code + bucket.asset + bucket.other;
+		code += bucket.code;
+		asset += bucket.asset;
+		other += bucket.other;
+	}
+	return {
+		total: code + asset + other,
+		code,
+		asset,
+		other,
+		byDir
+	};
+}

package/dist/define.d.mts

@@ -0,0 +1,2 @@
+import type { PerfSuite } from "./types.mjs";
+export declare function definePerfSuite(suite: PerfSuite): PerfSuite;

package/dist/define.d.ts

@@ -0,0 +1,3 @@
+import type { PerfSuite } from './types';
+export declare function definePerfSuite(suite: PerfSuite): PerfSuite;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAE3D"}

package/dist/define.mjs

@@ -0,0 +1,3 @@
+export function definePerfSuite(suite) {
+	return suite;
+}

package/dist/format.d.mts

@@ -0,0 +1,2 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatSec(sec: number): string;

package/dist/format.d.ts

@@ -0,0 +1,3 @@
+export declare function formatBytes(bytes: number): string;
+export declare function formatSec(sec: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/format.mjs

@@ -0,0 +1,15 @@
+export function formatBytes(bytes) {
+	if (bytes === 0) return "0 B";
+	const k = 1024;
+	const sizes = [
+		"B",
+		"KB",
+		"MB",
+		"GB"
+	];
+	const i = Math.floor(Math.log(bytes) / Math.log(k));
+	return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+export function formatSec(sec) {
+	return `${sec.toFixed(2)}s`;
+}

package/dist/index.d.mts

@@ -0,0 +1,17 @@
+export { definePerfSuite } from "./define.mjs";
+export { runPerfSuite } from "./run.mjs";
+export { measureBuild } from "./build.mjs";
+export { measureBundle } from "./bundle.mjs";
+export { startTarget, isPortFree } from "./start.mjs";
+export type { StartedTarget } from "./start.mjs";
+export { runLoadPhase } from "./load/index.mjs";
+export { runAutocannon } from "./load/autocannon.mjs";
+export { runArtillery } from "./load/artillery.mjs";
+export { parseAutocannonJson, parseArtilleryJson } from "./load/parse.mjs";
+export { averageTargetResults, averageBuildMetrics, averageLoadMetrics } from "./average.mjs";
+export { checkThresholds } from "./thresholds.mjs";
+export { formatBytes, formatSec } from "./format.mjs";
+export { sampleProcess, startProcessMonitor } from "./process-sample.mjs";
+export { consoleReporter } from "./report/console.mjs";
+export { jsonReporter } from "./report/json.mjs";
+export type * from "./types.mjs";

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { definePerfSuite } from './define';
+export { runPerfSuite } from './run';
+export { measureBuild } from './build';
+export { measureBundle } from './bundle';
+export { startTarget, isPortFree } from './start';
+export type { StartedTarget } from './start';
+export { runLoadPhase } from './load';
+export { runAutocannon } from './load/autocannon';
+export { runArtillery } from './load/artillery';
+export { parseAutocannonJson, parseArtilleryJson } from './load/parse';
+export { averageTargetResults, averageBuildMetrics, averageLoadMetrics } from './average';
+export { checkThresholds } from './thresholds';
+export { formatBytes, formatSec } from './format';
+export { sampleProcess, startProcessMonitor } from './process-sample';
+export { consoleReporter } from './report/console';
+export { jsonReporter } from './report/json';
+export type * from './types';
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,mBAAmB,SAAS,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,15 @@
+export { definePerfSuite } from "./define.mjs";
+export { runPerfSuite } from "./run.mjs";
+export { measureBuild } from "./build.mjs";
+export { measureBundle } from "./bundle.mjs";
+export { startTarget, isPortFree } from "./start.mjs";
+export { runLoadPhase } from "./load/index.mjs";
+export { runAutocannon } from "./load/autocannon.mjs";
+export { runArtillery } from "./load/artillery.mjs";
+export { parseAutocannonJson, parseArtilleryJson } from "./load/parse.mjs";
+export { averageTargetResults, averageBuildMetrics, averageLoadMetrics } from "./average.mjs";
+export { checkThresholds } from "./thresholds.mjs";
+export { formatBytes, formatSec } from "./format.mjs";
+export { sampleProcess, startProcessMonitor } from "./process-sample.mjs";
+export { consoleReporter } from "./report/console.mjs";
+export { jsonReporter } from "./report/json.mjs";

package/dist/load/artillery.d.mts

@@ -0,0 +1,10 @@
+import type { ArtilleryResult } from "../types.mjs";
+/** Prefer local artillery bin; fall back to `npx artillery`. */
+export declare function runArtillery(opts: {
+	configPath: string;
+	artifactsDir: string;
+	name: string;
+	cwd?: string;
+	/** Overrides `config.target` (needed when the suite picks a free port). */
+	targetUrl?: string;
+}): Promise<ArtilleryResult>;

package/dist/load/artillery.d.ts

@@ -0,0 +1,11 @@
+import type { ArtilleryResult } from '../types';
+/** Prefer local artillery bin; fall back to `npx artillery`. */
+export declare function runArtillery(opts: {
+    configPath: string;
+    artifactsDir: string;
+    name: string;
+    cwd?: string;
+    /** Overrides `config.target` (needed when the suite picks a free port). */
+    targetUrl?: string;
+}): Promise<ArtilleryResult>;
+//# sourceMappingURL=artillery.d.ts.map

package/dist/load/artillery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artillery.d.ts","sourceRoot":"","sources":["../../src/load/artillery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAoDhD,gEAAgE;AAChE,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,CAAC,CAW3B"}

package/dist/load/artillery.mjs

@@ -0,0 +1,77 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "pathe";
+function resolveArtilleryBin() {
+	try {
+		const pkg = createRequire(import.meta.url).resolve("artillery/package.json");
+		const bin = join(dirname(pkg), "bin", "run");
+		return existsSync(bin) ? bin : null;
+	} catch {
+		return null;
+	}
+}
+function spawnArtillery(args, opts) {
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(args[0], args.slice(1), {
+			cwd: opts.cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		child.stdout?.on("data", (chunk) => {
+			const line = chunk.toString().trim();
+			if (line.includes("Phase started") || line.includes("Summary report") || line.includes("All VUs finished")) {
+				console.log(`  [artillery] ${line.split("\n")[0]}`);
+			}
+		});
+		child.stderr?.on("data", (chunk) => {
+			const line = chunk.toString().trim();
+			if (line) console.error(`  [artillery stderr] ${line.slice(0, 200)}`);
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code !== 0) {
+				reject(new Error(`Artillery exited with code ${code}`));
+				return;
+			}
+			try {
+				resolvePromise(JSON.parse(readFileSync(opts.outputFile, "utf8")));
+			} catch (err) {
+				reject(err);
+			}
+		});
+	});
+}
+
+export async function runArtillery(opts) {
+	mkdirSync(opts.artifactsDir, { recursive: true });
+	const outputFile = join(opts.artifactsDir, `artillery-${opts.name}.json`);
+	const config = resolve(opts.configPath);
+	const bin = resolveArtilleryBin();
+	const targetArgs = opts.targetUrl ? ["--target", opts.targetUrl.replace(/\/$/, "")] : [];
+	const args = bin ? [
+		process.execPath,
+		bin,
+		"run",
+		...targetArgs,
+		config,
+		"--output",
+		outputFile
+	] : [
+		"npx",
+		"--yes",
+		"artillery",
+		"run",
+		...targetArgs,
+		config,
+		"--output",
+		outputFile
+	];
+	return spawnArtillery(args, {
+		cwd: opts.cwd,
+		outputFile
+	});
+}

package/dist/load/autocannon.d.mts

@@ -0,0 +1,9 @@
+import type { AutocannonResult } from "../types.mjs";
+/** Prefer programmatic peer; fall back to `npx autocannon`. */
+export declare function runAutocannon(opts: {
+	url: string;
+	connections?: number;
+	durationSec?: number;
+	artifactsDir: string;
+	name: string;
+}): Promise<AutocannonResult>;

package/dist/load/autocannon.d.ts

@@ -0,0 +1,10 @@
+import type { AutocannonResult } from '../types';
+/** Prefer programmatic peer; fall back to `npx autocannon`. */
+export declare function runAutocannon(opts: {
+    url: string;
+    connections?: number;
+    durationSec?: number;
+    artifactsDir: string;
+    name: string;
+}): Promise<AutocannonResult>;
+//# sourceMappingURL=autocannon.d.ts.map

package/dist/load/autocannon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocannon.d.ts","sourceRoot":"","sources":["../../src/load/autocannon.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAiHjD,+DAA+D;AAC/D,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc5B"}

package/dist/load/autocannon.mjs

@@ -0,0 +1,96 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "pathe";
+function normalize(raw) {
+	return {
+		requests: {
+			average: raw.requests.average,
+			mean: raw.requests.mean ?? raw.requests.average,
+			total: raw.requests.total ?? raw.totalCompletedRequests ?? raw.totalRequests ?? 0
+		},
+		latency: {
+			average: raw.latency.average,
+			mean: raw.latency.mean ?? raw.latency.average,
+			min: raw.latency.min,
+			max: raw.latency.max,
+			p50: raw.latency.p50 ?? raw.latency.average,
+			p97_5: raw.latency.p97_5 ?? raw.latency.p99 ?? raw.latency.max,
+			p99: raw.latency.p99 ?? raw.latency.max
+		},
+		throughput: { average: raw.throughput.average },
+		errors: raw.errors ?? 0
+	};
+}
+async function viaApi(opts) {
+	try {
+		// @ts-expect-error optional peer
+		const mod = await import("autocannon");
+		const run = mod.default ?? mod;
+		const raw = await run({
+			url: opts.url,
+			connections: opts.connections,
+			duration: opts.duration,
+			renderProgressBar: false,
+			renderResultsTable: false,
+			renderLatencyTable: false
+		});
+		return normalize(raw);
+	} catch {
+		return null;
+	}
+}
+function viaNpx(opts) {
+	return new Promise((resolve, reject) => {
+		const child = spawn("npx", [
+			"--yes",
+			"autocannon",
+			"-c",
+			String(opts.connections),
+			"-d",
+			String(opts.duration),
+			"-j",
+			opts.url
+		], { stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		] });
+		let stdout = "";
+		let stderr = "";
+		child.stdout?.on("data", (c) => {
+			stdout += c.toString();
+		});
+		child.stderr?.on("data", (c) => {
+			stderr += c.toString();
+		});
+		child.on("error", reject);
+		child.on("close", (code) => {
+			if (code !== 0 && !stdout) {
+				reject(new Error(`autocannon exited ${code}: ${stderr.slice(0, 400)}`));
+				return;
+			}
+			try {
+				resolve(normalize(JSON.parse(stdout)));
+			} catch (e) {
+				reject(e);
+			}
+		});
+	});
+}
+
+export async function runAutocannon(opts) {
+	const connections = opts.connections ?? 10;
+	const duration = opts.durationSec ?? 10;
+	mkdirSync(opts.artifactsDir, { recursive: true });
+	const result = await viaApi({
+		url: opts.url,
+		connections,
+		duration
+	}) ?? await viaNpx({
+		url: opts.url,
+		connections,
+		duration
+	});
+	writeFileSync(join(opts.artifactsDir, `autocannon-${opts.name}.json`), JSON.stringify(result, null, 2));
+	return result;
+}

package/dist/load/index.d.mts

@@ -0,0 +1,7 @@
+import type { StartedTarget } from "../start.mjs";
+import type { LoadMetrics, PerfTarget } from "../types.mjs";
+export declare function runLoadPhase(opts: {
+	target: PerfTarget;
+	started: StartedTarget;
+	artifactsDir: string;
+}): Promise<LoadMetrics>;

package/dist/load/index.d.ts

@@ -0,0 +1,8 @@
+import type { StartedTarget } from '../start';
+import type { LoadMetrics, PerfTarget } from '../types';
+export declare function runLoadPhase(opts: {
+    target: PerfTarget;
+    started: StartedTarget;
+    artifactsDir: string;
+}): Promise<LoadMetrics>;
+//# sourceMappingURL=index.d.ts.map

package/dist/load/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/load/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAIxD,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CA0DvB"}