@orkestrel/probe 0.0.15 → 0.0.17

package/dist/src/server/index.cjs

@@ -61,11 +61,11 @@ function normalizePath(path) {
 * ```
 */
 function readFaultCode(error) {
-	if (typeof error !== "object" || error === null) return void 0;
+	if (!(0, _orkestrel_contract.isObject)(error)) return void 0;
 	const fault = error;
 	const reading = (0, _orkestrel_contract.attempt)(() => "code" in fault ? fault.code : void 0);
 	if (!reading.success) return void 0;
-	return typeof reading.value === "string" ? reading.value : void 0;
+	return (0, _orkestrel_contract.isString)(reading.value) ? reading.value : void 0;
 }
 /**
 * Reports whether one path resolves outside the root it is read against.
@@ -152,7 +152,7 @@ function resolveWorkspaceFile(workspace, target, mutate = false) {
 			});
 		}
 	} catch (error) {
-		if (error instanceof _src_core.ProbeError) throw error;
+		if ((0, _src_core.isProbeError)(error)) throw error;
 		const code = readFaultCode(error);
 		const claimant = code === "ENAMETOOLONG" || code === "ERR_INVALID_ARG_VALUE";
 		throw new _src_core.ProbeError(`The workspace path cannot be inspected: ${target}`, {
@@ -196,7 +196,7 @@ function resolveWorkspaceFile(workspace, target, mutate = false) {
 *
 * @example
 * ```ts
-* const file = resolveWorkspaceFile('/srv/checkout', 'tmp/probe/arm-type.ts', true)
+* const file = resolveWorkspaceFile('/srv/checkout', 'tmp/probes/arm-type.ts', true)
 * writeFileSync(file, 'export type Signal = string\n', { encoding: 'utf8', flag: 'wx' })
 * overwriteFile(file, 'export type Signal = number\n')
 * readFileSync(file, 'utf8') // 'export type Signal = number\n'
@@ -239,11 +239,11 @@ function overwriteFile(file, text) {
 * @example
 * ```ts
 * try {
-* 	writeFileSync('tmp/probe/greeting\0.test.ts', '')
+* 	writeFileSync('tmp/probes/greeting\0.test.ts', '')
 * } catch (error) {
-* 	isRefusedName('tmp/probe/greeting\0.test.ts', error) // true
+* 	isRefusedName('tmp/probes/greeting\0.test.ts', error) // true
 * }
-* isRefusedName('tmp/probe/greeting.test.ts', new Error('the runtime stage was destroyed')) // false
+* isRefusedName('tmp/probes/greeting.test.ts', new Error('the runtime stage was destroyed')) // false
 * ```
 */
 function isRefusedName(file, error) {
@@ -460,7 +460,7 @@ function readWorkspaceManifest(workspace, name) {
 	try {
 		path = resolveWorkspaceModule(workspace, `${name}/package.json`);
 	} catch (error) {
-		if (!(error instanceof _src_core.ProbeError)) throw error;
+		if (!(0, _src_core.isProbeError)(error)) throw error;
 		throw new _src_core.ProbeError(`${name} does not publish a readable manifest`, {
 			origin: "workspace",
 			code: error.code,
@@ -537,14 +537,14 @@ function resolveWorkspaceBinary(workspace, name, command = name) {
 		code: "missing",
 		context: { name }
 	});
-	if (typeof bin === "string") return (0, node_path.resolve)(manifest.path, "..", bin);
+	if ((0, _orkestrel_contract.isString)(bin)) return (0, node_path.resolve)(manifest.path, "..", bin);
 	if (!(0, _orkestrel_contract.isRecord)(bin) || !(command in bin)) throw new _src_core.ProbeError(`${name} does not publish the ${command} binary`, {
 		origin: "workspace",
 		code: "missing",
 		context: { name }
 	});
 	const entry = bin[command];
-	if (typeof entry !== "string") throw new _src_core.ProbeError(`${name} publishes an invalid ${command} binary`, {
+	if (!(0, _orkestrel_contract.isString)(entry)) throw new _src_core.ProbeError(`${name} publishes an invalid ${command} binary`, {
 		origin: "workspace",
 		code: "malformed",
 		context: {
@@ -590,14 +590,14 @@ function inferTypeProject(path) {
 *
 * @example
 * ```ts
-* inferTestProject('tmp/probe/greeting.test.ts') // 'probe'
+* inferTestProject('tmp/probes/greeting.test.ts') // 'probe'
 * inferTestProject('tests/src/server/helpers.test.ts') // 'src:server'
 * inferTestProject('tests/config.test.ts') // undefined
 * ```
 */
 function inferTestProject(path) {
 	const [root, axis, environment] = normalizePath(path).split("/");
-	if (root === "tmp" && axis === "probe") return "probe";
+	if (root === "tmp" && axis === "probes") return "probe";
 	if (root !== "tests" || axis === void 0 || environment === void 0) return void 0;
 	if (axis !== "src" && axis !== "app") return void 0;
 	return `${axis}:${environment}`;
@@ -634,9 +634,9 @@ function inferDocumentLanguage(path) {
 * ```ts
 * relativeWorkspaceFile(
 * 	'/srv/checkout',
-* 	buildRevisionPath('/srv/checkout', 'tmp/probe/greeting.test.ts', '4821-9f0c'),
+* 	buildRevisionPath('/srv/checkout', 'tmp/probes/greeting.test.ts', '4821-9f0c'),
 * )
-* // 'tmp/probe/greeting.test.probe-4821-9f0c.ts'
+* // 'tmp/probes/greeting.test.probe-4821-9f0c.ts'
 * ```
 */
 function buildRevisionPath(workspace, path, revision) {
@@ -711,7 +711,7 @@ function matchesWorkspaceModule(path) {
 * ```
 */
 function matchesLiveProcess(id) {
-	if (!Number.isSafeInteger(id) || id <= 0) return true;
+	if (!(0, _orkestrel_contract.isNumber)(id) || !Number.isSafeInteger(id) || id <= 0) return true;
 	try {
 		process.kill(id, 0);
 		return true;
@@ -775,8 +775,8 @@ function collectWorkspaceFiles(workspace) {
 * ```
 */
 function describeUnknown(value) {
-	if (value instanceof Error) return value.message;
-	if (typeof value === "object" && value !== null && "message" in value && typeof value.message === "string") return value.message;
+	if ((0, _orkestrel_contract.isError)(value)) return value.message;
+	if ((0, _orkestrel_contract.isObject)(value) && "message" in value && (0, _orkestrel_contract.isString)(value.message)) return value.message;
 	return String(value);
 }
 /**
@@ -796,7 +796,7 @@ async function guardStage(stage, operation) {
 	try {
 		return await operation;
 	} catch (error) {
-		if (error instanceof _src_core.ProbeError) throw error;
+		if ((0, _src_core.isProbeError)(error)) throw error;
 		throw new _src_core.ProbeError(`The ${stage} stage could not serve (${describeUnknown(error)})`, {
 			origin: "instrument",
 			code: "malformed",
@@ -826,7 +826,7 @@ async function guardStage(stage, operation) {
 *
 * @example
 * ```ts
-* const test = { path: 'tmp/probe/greeting.test.ts', text: '' }
+* const test = { path: 'tmp/probes/greeting.test.ts', text: '' }
 * findRefusedPaths({
 * 	project: 'tsconfig.json',
 * 	case: { files: [{ path: '../../etc/hosts', text: '' }], test },
@@ -873,7 +873,7 @@ function findRefusedPaths(value) {
 */
 function normalizeValue(workspace, value) {
 	const root = (0, node_path.resolve)(workspace);
-	if (typeof value === "string") {
+	if ((0, _orkestrel_contract.isString)(value)) {
 		if (!(0, node_path.isAbsolute)(value)) return value;
 		const path = (0, node_path.relative)(root, (0, node_path.resolve)(value));
 		if (path === "") return ".";
@@ -983,14 +983,14 @@ function releaseListeners(emitter, capture) {
 * ```
 */
 function parseProjectConfig(text) {
-	const parsed = (0, _orkestrel_contract.attempt)(() => JSON.parse(text));
-	if (!parsed.success || !(0, _orkestrel_contract.isRecord)(parsed.value)) return void 0;
-	const files = parsed.value.files;
-	const include = parsed.value.include;
+	const parsed = (0, _orkestrel_contract.parseJSON)(text);
+	if (!(0, _orkestrel_contract.isRecord)(parsed)) return void 0;
+	const files = parsed.files;
+	const include = parsed.include;
 	return {
-		compilerOptions: parsed.value.compilerOptions,
-		...(0, _orkestrel_contract.isArray)(files) && files.every((entry) => typeof entry === "string") ? { files } : {},
-		...(0, _orkestrel_contract.isArray)(include) && include.every((entry) => typeof entry === "string") ? { include } : {}
+		compilerOptions: parsed.compilerOptions,
+		...(0, _orkestrel_contract.isArray)(files) && files.every(_orkestrel_contract.isString) ? { files } : {},
+		...(0, _orkestrel_contract.isArray)(include) && include.every(_orkestrel_contract.isString) ? { include } : {}
 	};
 }
 /**
@@ -1104,9 +1104,9 @@ var Overlay = class {
 };
 //#endregion
 //#region package.json
-var version = "0.0.15";
+var version = "0.0.17";
 var peerDependencies = {
-	"oxlint": "^1.82.0",
+	"oxlint": "^1.86.0",
 	"typescript": "^6.0.3",
 	"vitest": "^4.1.11"
 };
@@ -1279,7 +1279,7 @@ var LintStage = class {
 		if (this.#closing !== void 0) return (0, _src_core.createDestroyedError)("lint stage");
 		const ending = this.#ending;
 		if (ending !== void 0) return this.#fault(`The Oxlint language server exited with ${ending}`, error, path);
-		if (error instanceof Error) return error;
+		if ((0, _orkestrel_contract.isError)(error)) return error;
 		return this.#fault(describeUnknown(error), error, path);
 	}
 	#fault(message, cause, path) {
@@ -1450,7 +1450,7 @@ var RuntimeStage = class {
 			for (const draft of subject.files) overlay.set(resolveWorkspaceFile(this.#workspace, draft.path), draft.text);
 			this.#revalidate(vitest);
 			const specification = this.#specification(subject.test);
-			if (typeof specification !== "string") return {
+			if (!(0, _orkestrel_contract.isString)(specification)) return {
 				stage: this.stage,
 				elapsed: Math.round(performance.now() - started),
 				issues: [specification]
@@ -1467,7 +1467,7 @@ var RuntimeStage = class {
 					const result = await vitest.runTestSpecifications([task], false);
 					issues = [...this.#issues(result, file, subject.test.path), ...this.#misses(project, file)];
 				} catch (error) {
-					if (error instanceof _src_core.ProbeError) throw error;
+					if ((0, _src_core.isProbeError)(error)) throw error;
 					throw new _src_core.ProbeError(`The runtime stage could not run the generated specification (${describeUnknown(error)})`, {
 						origin: "instrument",
 						code: "malformed",
@@ -1488,7 +1488,7 @@ var RuntimeStage = class {
 					if ((0, node_fs.existsSync)(contained)) (0, node_fs.unlinkSync)(contained);
 				} catch (error) {
 					cleanup = [...cleanup, {
-						origin: error instanceof _src_core.ProbeError && error.origin === "workspace" ? "workspace" : "instrument",
+						origin: (0, _src_core.isProbeError)(error) && error.origin === "workspace" ? "workspace" : "instrument",
 						path: relativeWorkspaceFile(this.#workspace, file),
 						message: `The runtime stage could not delete the generated specification (${describeUnknown(error)})`
 					}];
@@ -1567,7 +1567,7 @@ var RuntimeStage = class {
 		test.projects = test.projects.map((project) => this.#augment(project));
 	}
 	#augment(project) {
-		if (typeof project === "string") return project;
+		if ((0, _orkestrel_contract.isString)(project)) return project;
 		if (typeof project === "function") return this.#wrap(project);
 		return Promise.resolve(project).then(this.#instrument.bind(this));
 	}
@@ -1635,7 +1635,7 @@ var RuntimeStage = class {
 			return file;
 		});
 		if (outcome.success) return outcome.value;
-		if (outcome.error instanceof _src_core.ProbeError && outcome.error.origin === "claimant") throw new _src_core.ProbeError(outcome.error.message, {
+		if ((0, _src_core.isProbeError)(outcome.error) && outcome.error.origin === "claimant") throw new _src_core.ProbeError(outcome.error.message, {
 			origin: outcome.error.origin,
 			code: outcome.error.code,
 			context: {
@@ -1654,7 +1654,7 @@ var RuntimeStage = class {
 			cause: outcome.error
 		});
 		return {
-			origin: outcome.error instanceof _src_core.ProbeError && outcome.error.origin === "workspace" || creating ? "workspace" : "instrument",
+			origin: (0, _src_core.isProbeError)(outcome.error) && outcome.error.origin === "workspace" || creating ? "workspace" : "instrument",
 			path: test.path,
 			message: `The runtime stage could not write the generated specification (${describeUnknown(outcome.error)})`
 		};
@@ -1914,29 +1914,29 @@ var RuntimeStage = class {
 	}
 	#issue(error, specification, original) {
 		const message = relativeWorkspaceMessage(this.#workspace, describeUnknown(error)).replaceAll((0, node_path.basename)(specification), (0, node_path.basename)(original));
-		if (typeof error !== "object" || error === null || !("stacks" in error)) return {
+		if (!(0, _orkestrel_contract.isObject)(error) || !("stacks" in error)) return {
 			origin: "claimant",
 			path: original,
 			message
 		};
 		const stacks = error.stacks;
-		if (!Array.isArray(stacks)) return {
+		if (!(0, _orkestrel_contract.isArray)(stacks)) return {
 			origin: "claimant",
 			path: original,
 			message
 		};
 		for (const stack of stacks) {
-			if (typeof stack !== "object" || stack === null) continue;
-			if (!("file" in stack) || typeof stack.file !== "string") continue;
+			if (!(0, _orkestrel_contract.isObject)(stack)) continue;
+			if (!("file" in stack) || !(0, _orkestrel_contract.isString)(stack.file)) continue;
 			const declared = stack.file.startsWith("file:") ? (0, node_url.fileURLToPath)(stack.file) : (0, node_path.isAbsolute)(stack.file) ? stack.file : (0, node_path.resolve)(this.#workspace, stack.file);
 			const reported = this.#real(declared);
 			const path = reported === specification ? original : relativeWorkspaceFile(this.#real(this.#workspace), reported);
-			if (!("line" in stack) || typeof stack.line !== "number") return {
+			if (!("line" in stack) || !(0, _orkestrel_contract.isNumber)(stack.line)) return {
 				origin: "claimant",
 				path,
 				message
 			};
-			const character = "column" in stack && typeof stack.column === "number" ? stack.column - 1 : 0;
+			const character = "column" in stack && (0, _orkestrel_contract.isNumber)(stack.column) ? stack.column - 1 : 0;
 			const position = {
 				line: stack.line - 1,
 				character
@@ -2462,7 +2462,7 @@ var TypeStage = class {
 * 			},
 * 		],
 * 		test: {
-* 			path: 'tmp/probe/greeting.test.ts',
+* 			path: 'tmp/probes/greeting.test.ts',
 * 			text: "import { expect, test } from 'vitest'\nimport { createGreeting } from '../../src/core/factories.js'\ntest('greets', () => expect(createGreeting()).toBe('hi'))\n",
 * 		},
 * 	},
@@ -2474,7 +2474,7 @@ var TypeStage = class {
 * 			},
 * 		],
 * 		test: {
-* 			path: 'tmp/probe/greeting.test.ts',
+* 			path: 'tmp/probes/greeting.test.ts',
 * 			text: "import { expect, test } from 'vitest'\nimport { createGreeting } from '../../src/core/factories.js'\ntest('greets', () => expect(createGreeting()).toBe('hi'))\n",
 * 		},
 * 		stage: 'type',
@@ -2484,8 +2484,8 @@ var TypeStage = class {
 *
 * const probe = new Probe({ workspace: process.cwd() })
 * const verdict = await probe.prove(claim)
-* verdict.digest // 'fcb88a2dee987b8673c1fc7107979470'
-* verdict.receipt // 'probe:fcb88a2dee987b8673c1fc7107979470:type:typescript@6.0.3:oxlint@1.83.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
+* verdict.digest // 'bdf03e5dfd6bd413ead671c7a2940fcf'
+* verdict.receipt // 'probe:bdf03e5dfd6bd413ead671c7a2940fcf:type:typescript@6.0.3:oxlint@1.86.0:vitest@4.1.11:configs/src/tsconfig.core.json@434f59254d58cf2683d453a26bd0d837'
 * await probe.destroy()
 * ```
 */
@@ -2582,7 +2582,7 @@ var Probe = class {
 			this.#emitter.emit("prove", verdict);
 			return verdict;
 		} catch (error) {
-			if (!(error instanceof _src_core.ProbeError) || !this.#surfaced.has(error)) this.#emitter.emit("error", error);
+			if (!(0, _src_core.isProbeError)(error) || !this.#surfaced.has(error)) this.#emitter.emit("error", error);
 			throw error;
 		}
 	}
@@ -2627,17 +2627,17 @@ var Probe = class {
 		this.#emitter.emit("arm", this.#toolchain);
 	}
 	#surface(error) {
-		if (error instanceof _src_core.ProbeError) this.#surfaced.add(error);
+		if ((0, _src_core.isProbeError)(error)) this.#surfaced.add(error);
 		this.#emitter.emit("error", error);
 	}
 	#workbench() {
-		const path = "tmp/probe";
+		const path = "tmp/probes";
 		const directory = resolveWorkspaceFile(this.#workspace, path);
 		const created = !(0, node_fs.existsSync)(directory);
 		try {
 			(0, node_fs.mkdirSync)(resolveWorkspaceFile(this.#workspace, path, true), { recursive: true });
 		} catch (error) {
-			const code = error instanceof _src_core.ProbeError && error.origin === "workspace" ? error.code : "malformed";
+			const code = (0, _src_core.isProbeError)(error) && error.origin === "workspace" ? error.code : "malformed";
 			throw new _src_core.ProbeError(`The probe could not create the boot workbench (${describeUnknown(error)})`, {
 				origin: "workspace",
 				code,
@@ -2649,16 +2649,16 @@ var Probe = class {
 	}
 	async #boot(created) {
 		const revision = `${process.pid}-${(0, node_crypto.randomUUID)()}`;
-		const typeDependency = buildRevisionPath(this.#workspace, "tmp/probe/arm-type.ts", revision);
-		const runtimeDependency = buildRevisionPath(this.#workspace, "tmp/probe/arm-runtime.ts", revision);
+		const typeDependency = buildRevisionPath(this.#workspace, "tmp/probes/arm-type.ts", revision);
+		const runtimeDependency = buildRevisionPath(this.#workspace, "tmp/probes/arm-runtime.ts", revision);
 		const typeModule = (0, node_path.basename)(typeDependency, ".ts");
 		const runtimeModule = (0, node_path.basename)(runtimeDependency, ".ts");
 		const typeTest = {
-			path: `tmp/probe/${typeModule}.test.ts`,
+			path: `tmp/probes/${typeModule}.test.ts`,
 			text: `import type { Signal } from './${typeModule}.js'\nimport { expect, test } from 'vitest'\nconst SIGNAL: Signal = 'before'\ntest('revalidates a mutated type', () => {\n\texpect(SIGNAL).toBe('before')\n})\n`
 		};
 		const runtimeTest = {
-			path: `tmp/probe/${runtimeModule}.test.ts`,
+			path: `tmp/probes/${runtimeModule}.test.ts`,
 			text: `import { SIGNAL } from './${runtimeModule}.js'\nimport { expect, test } from 'vitest'\ntest('revalidates a mutated value', () => {\n\texpect(SIGNAL).toBe('before')\n})\n`
 		};
 		const typeClaim = {
@@ -2733,7 +2733,7 @@ var Probe = class {
 			(0, node_fs.rmSync)(resolveWorkspaceFile(this.#workspace, (0, node_path.relative)(this.#workspace, typeDependency), true), { force: true });
 			(0, node_fs.rmSync)(resolveWorkspaceFile(this.#workspace, (0, node_path.relative)(this.#workspace, runtimeDependency), true), { force: true });
 			if (created) try {
-				(0, node_fs.rmdirSync)(resolveWorkspaceFile(this.#workspace, "tmp/probe", true));
+				(0, node_fs.rmdirSync)(resolveWorkspaceFile(this.#workspace, "tmp/probes", true));
 			} catch {}
 		}
 	}
@@ -2873,12 +2873,12 @@ var Probe = class {
 		try {
 			await this.#bound(() => stage.destroy(), `The ${stage.stage} stage teardown exceeded ${this.#deadline} ms`, stage, stage.progress);
 		} catch (error) {
-			if (!(error instanceof _src_core.ProbeError) || !this.#deadlines.has(error)) throw error;
+			if (!(0, _src_core.isProbeError)(error) || !this.#deadlines.has(error)) throw error;
 		}
 	}
 	#version(name) {
 		const version = readWorkspaceManifest(this.#workspace, name).contents.version;
-		if (typeof version !== "string") throw new _src_core.ProbeError(`${name} publishes no readable version`, {
+		if (!(0, _orkestrel_contract.isString)(version)) throw new _src_core.ProbeError(`${name} publishes no readable version`, {
 			origin: "workspace",
 			code: "malformed",
 			context: { name }