@orkestrel/probe 0.0.14 → 0.0.16

package/dist/src/server/index.js

@@ -3,7 +3,7 @@ import { closeSync, constants, existsSync, ftruncateSync, lstatSync, mkdirSync,
 import { createHash, randomUUID } from "node:crypto";
 import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { attempt, compileGuard, compileSchema, isArray, isRecord, schemaToParameters } from "@orkestrel/contract";
+import { attempt, compileGuard, compileSchema, isArray, isError, isNumber, isObject, isRecord, isString, parseJSON, schemaToParameters } from "@orkestrel/contract";
 import { CLAIM_SHAPE, LINT_DEADLINE, PROBE_DEADLINE, PROBE_KEYS, PROBE_SPECIFICATIONS, ProbeError, RUNTIME_PLUGIN, TYPE_MIRROR, computeReceipt, createDestroyedError, formatCheck, formatReceipt, formatSpecification, formatVerdict, isClaim, isDraft, isProbeError, isVerdict, matchesSpecification } from "../core/index.js";
 import { Emitter } from "@orkestrel/emitter";
 import { createQueue } from "@orkestrel/queue";
@@ -60,11 +60,11 @@ function normalizePath(path) {
 * ```
 */
 function readFaultCode(error) {
-	if (typeof error !== "object" || error === null) return void 0;
+	if (!isObject(error)) return void 0;
 	const fault = error;
 	const reading = attempt(() => "code" in fault ? fault.code : void 0);
 	if (!reading.success) return void 0;
-	return typeof reading.value === "string" ? reading.value : void 0;
+	return isString(reading.value) ? reading.value : void 0;
 }
 /**
 * Reports whether one path resolves outside the root it is read against.
@@ -151,7 +151,7 @@ function resolveWorkspaceFile(workspace, target, mutate = false) {
 			});
 		}
 	} catch (error) {
-		if (error instanceof ProbeError) throw error;
+		if (isProbeError(error)) throw error;
 		const code = readFaultCode(error);
 		const claimant = code === "ENAMETOOLONG" || code === "ERR_INVALID_ARG_VALUE";
 		throw new ProbeError(`The workspace path cannot be inspected: ${target}`, {
@@ -459,7 +459,7 @@ function readWorkspaceManifest(workspace, name) {
 	try {
 		path = resolveWorkspaceModule(workspace, `${name}/package.json`);
 	} catch (error) {
-		if (!(error instanceof ProbeError)) throw error;
+		if (!isProbeError(error)) throw error;
 		throw new ProbeError(`${name} does not publish a readable manifest`, {
 			origin: "workspace",
 			code: error.code,
@@ -536,14 +536,14 @@ function resolveWorkspaceBinary(workspace, name, command = name) {
 		code: "missing",
 		context: { name }
 	});
-	if (typeof bin === "string") return resolve(manifest.path, "..", bin);
+	if (isString(bin)) return resolve(manifest.path, "..", bin);
 	if (!isRecord(bin) || !(command in bin)) throw new ProbeError(`${name} does not publish the ${command} binary`, {
 		origin: "workspace",
 		code: "missing",
 		context: { name }
 	});
 	const entry = bin[command];
-	if (typeof entry !== "string") throw new ProbeError(`${name} publishes an invalid ${command} binary`, {
+	if (!isString(entry)) throw new ProbeError(`${name} publishes an invalid ${command} binary`, {
 		origin: "workspace",
 		code: "malformed",
 		context: {
@@ -710,7 +710,7 @@ function matchesWorkspaceModule(path) {
 * ```
 */
 function matchesLiveProcess(id) {
-	if (!Number.isSafeInteger(id) || id <= 0) return true;
+	if (!isNumber(id) || !Number.isSafeInteger(id) || id <= 0) return true;
 	try {
 		process.kill(id, 0);
 		return true;
@@ -774,8 +774,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 (isError(value)) return value.message;
+	if (isObject(value) && "message" in value && isString(value.message)) return value.message;
 	return String(value);
 }
 /**
@@ -795,7 +795,7 @@ async function guardStage(stage, operation) {
 	try {
 		return await operation;
 	} catch (error) {
-		if (error instanceof ProbeError) throw error;
+		if (isProbeError(error)) throw error;
 		throw new ProbeError(`The ${stage} stage could not serve (${describeUnknown(error)})`, {
 			origin: "instrument",
 			code: "malformed",
@@ -872,7 +872,7 @@ function findRefusedPaths(value) {
 */
 function normalizeValue(workspace, value) {
 	const root = resolve(workspace);
-	if (typeof value === "string") {
+	if (isString(value)) {
 		if (!isAbsolute(value)) return value;
 		const path = relative(root, resolve(value));
 		if (path === "") return ".";
@@ -982,14 +982,14 @@ function releaseListeners(emitter, capture) {
 * ```
 */
 function parseProjectConfig(text) {
-	const parsed = attempt(() => JSON.parse(text));
-	if (!parsed.success || !isRecord(parsed.value)) return void 0;
-	const files = parsed.value.files;
-	const include = parsed.value.include;
+	const parsed = parseJSON(text);
+	if (!isRecord(parsed)) return void 0;
+	const files = parsed.files;
+	const include = parsed.include;
 	return {
-		compilerOptions: parsed.value.compilerOptions,
-		...isArray(files) && files.every((entry) => typeof entry === "string") ? { files } : {},
-		...isArray(include) && include.every((entry) => typeof entry === "string") ? { include } : {}
+		compilerOptions: parsed.compilerOptions,
+		...isArray(files) && files.every(isString) ? { files } : {},
+		...isArray(include) && include.every(isString) ? { include } : {}
 	};
 }
 /**
@@ -1103,7 +1103,7 @@ var Overlay = class {
 };
 //#endregion
 //#region package.json
-var version = "0.0.14";
+var version = "0.0.16";
 var peerDependencies = {
 	"oxlint": "^1.82.0",
 	"typescript": "^6.0.3",
@@ -1278,7 +1278,7 @@ var LintStage = class {
 		if (this.#closing !== void 0) return 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 (isError(error)) return error;
 		return this.#fault(describeUnknown(error), error, path);
 	}
 	#fault(message, cause, path) {
@@ -1449,7 +1449,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 (!isString(specification)) return {
 				stage: this.stage,
 				elapsed: Math.round(performance.now() - started),
 				issues: [specification]
@@ -1466,7 +1466,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 ProbeError) throw error;
+					if (isProbeError(error)) throw error;
 					throw new ProbeError(`The runtime stage could not run the generated specification (${describeUnknown(error)})`, {
 						origin: "instrument",
 						code: "malformed",
@@ -1487,7 +1487,7 @@ var RuntimeStage = class {
 					if (existsSync(contained)) unlinkSync(contained);
 				} catch (error) {
 					cleanup = [...cleanup, {
-						origin: error instanceof ProbeError && error.origin === "workspace" ? "workspace" : "instrument",
+						origin: isProbeError(error) && error.origin === "workspace" ? "workspace" : "instrument",
 						path: relativeWorkspaceFile(this.#workspace, file),
 						message: `The runtime stage could not delete the generated specification (${describeUnknown(error)})`
 					}];
@@ -1566,7 +1566,7 @@ var RuntimeStage = class {
 		test.projects = test.projects.map((project) => this.#augment(project));
 	}
 	#augment(project) {
-		if (typeof project === "string") return project;
+		if (isString(project)) return project;
 		if (typeof project === "function") return this.#wrap(project);
 		return Promise.resolve(project).then(this.#instrument.bind(this));
 	}
@@ -1634,7 +1634,7 @@ var RuntimeStage = class {
 			return file;
 		});
 		if (outcome.success) return outcome.value;
-		if (outcome.error instanceof ProbeError && outcome.error.origin === "claimant") throw new ProbeError(outcome.error.message, {
+		if (isProbeError(outcome.error) && outcome.error.origin === "claimant") throw new ProbeError(outcome.error.message, {
 			origin: outcome.error.origin,
 			code: outcome.error.code,
 			context: {
@@ -1653,7 +1653,7 @@ var RuntimeStage = class {
 			cause: outcome.error
 		});
 		return {
-			origin: outcome.error instanceof ProbeError && outcome.error.origin === "workspace" || creating ? "workspace" : "instrument",
+			origin: 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)})`
 		};
@@ -1913,29 +1913,29 @@ var RuntimeStage = class {
 	}
 	#issue(error, specification, original) {
 		const message = relativeWorkspaceMessage(this.#workspace, describeUnknown(error)).replaceAll(basename(specification), basename(original));
-		if (typeof error !== "object" || error === null || !("stacks" in error)) return {
+		if (!isObject(error) || !("stacks" in error)) return {
 			origin: "claimant",
 			path: original,
 			message
 		};
 		const stacks = error.stacks;
-		if (!Array.isArray(stacks)) return {
+		if (!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 (!isObject(stack)) continue;
+			if (!("file" in stack) || !isString(stack.file)) continue;
 			const declared = stack.file.startsWith("file:") ? fileURLToPath(stack.file) : isAbsolute(stack.file) ? stack.file : 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) || !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 && isNumber(stack.column) ? stack.column - 1 : 0;
 			const position = {
 				line: stack.line - 1,
 				character
@@ -2581,7 +2581,7 @@ var Probe = class {
 			this.#emitter.emit("prove", verdict);
 			return verdict;
 		} catch (error) {
-			if (!(error instanceof ProbeError) || !this.#surfaced.has(error)) this.#emitter.emit("error", error);
+			if (!isProbeError(error) || !this.#surfaced.has(error)) this.#emitter.emit("error", error);
 			throw error;
 		}
 	}
@@ -2626,7 +2626,7 @@ var Probe = class {
 		this.#emitter.emit("arm", this.#toolchain);
 	}
 	#surface(error) {
-		if (error instanceof ProbeError) this.#surfaced.add(error);
+		if (isProbeError(error)) this.#surfaced.add(error);
 		this.#emitter.emit("error", error);
 	}
 	#workbench() {
@@ -2636,7 +2636,7 @@ var Probe = class {
 		try {
 			mkdirSync(resolveWorkspaceFile(this.#workspace, path, true), { recursive: true });
 		} catch (error) {
-			const code = error instanceof ProbeError && error.origin === "workspace" ? error.code : "malformed";
+			const code = isProbeError(error) && error.origin === "workspace" ? error.code : "malformed";
 			throw new ProbeError(`The probe could not create the boot workbench (${describeUnknown(error)})`, {
 				origin: "workspace",
 				code,
@@ -2872,12 +2872,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 ProbeError) || !this.#deadlines.has(error)) throw error;
+			if (!isProbeError(error) || !this.#deadlines.has(error)) throw error;
 		}
 	}
 	#version(name) {
 		const version = readWorkspaceManifest(this.#workspace, name).contents.version;
-		if (typeof version !== "string") throw new ProbeError(`${name} publishes no readable version`, {
+		if (!isString(version)) throw new ProbeError(`${name} publishes no readable version`, {
 			origin: "workspace",
 			code: "malformed",
 			context: { name }