@orkestrel/test 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orkestrel
+
+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/README.md

@@ -0,0 +1,123 @@
+# @orkestrel/test
+
+The test helpers every `@orkestrel` package had already written for itself, published once. A call
+recorder that is a real callback rather than a spy. A real host delay. A throw-to-value converter and
+a presence narrower, so `!` and `as` stay banned in tests. Two async collectors and a JSON copier. A
+scratch directory the test owns and destroys, and a symlink-refusing source-file walker. Add it as a
+devDependency; nothing here runs in production code. Part of the `@orkestrel` line.
+
+It has **zero runtime dependencies**, and no exported signature names an `@orkestrel/*` type. Both
+rules exist for one reason: a test helper hands its types straight into the consumer's assertions,
+and a second copy of a package inside its own repository makes the compiler read one type as two.
+
+## Install
+
+```sh
+npm install -D @orkestrel/test
+```
+
+## Requirements
+
+- Node.js >= 22.12.0
+- ESM and CommonJS
+
+## Usage
+
+`@orkestrel/test` is the host-independent core. `@orkestrel/test/server` is the Node face. Core
+touches neither `node:*` nor the DOM, so a browser test project imports it unchanged.
+
+```ts
+import { captureError, createRecorder, requireValue, waitForDelay } from '@orkestrel/test'
+import { createScratch } from '@orkestrel/test/server'
+
+// A temporary directory the test owns, seeded with the input under test.
+const scratch = createScratch({ prefix: 'loader-', files: { 'input.txt': 'hello' } })
+
+// A real callback, not a spy: hand `handler` to the code under test.
+const recorder = createRecorder<[path: string]>()
+loader.on('read', recorder.handler)
+
+loader.watch(scratch.path)
+await waitForDelay(10) // let a real host timer elapse
+
+recorder.count // how many reads arrived
+recorder.calls // the arguments of each, oldest first
+recorder.clear() // truncates in place, so a `calls` reference captured earlier empties too
+
+// A throw becomes a value; absence becomes a throw. The test still does the asserting.
+captureError(() => loader.read('missing.txt')) // the thrown value, or undefined
+requireValue(scratch.read('input.txt')) // 'hello' — narrows `string | undefined` without `!`
+
+scratch.destroy() // idempotent, and it removes only the directory it allocated
+```
+
+The rest of core is `collect` (drains an async iterable), `collectStream` (drains a
+`ReadableStream`), `roundTripJSON` (copies a `JSONValue`, and throws rather than turning a non-finite
+number into `null`), and `resolveRoot` (the directory above the calling module, from `import.meta`).
+
+The server face adds `readInventory`, which reads a checkout into a map of root-relative path to
+file text that a parity suite can assert against, plus `resolveContained`, the lexical check it
+refuses escapes with.
+
+```ts
+import { resolveRoot } from '@orkestrel/test'
+import { readInventory } from '@orkestrel/test/server'
+
+// A suite in tests/ is one directory below the workspace root, which is what `resolveRoot` returns.
+const root = resolveRoot(import.meta)
+
+// Nothing is walked by default, so the directories are a required argument rather than an option.
+const sources = readInventory(root, ['src/core', 'src/server'], { extensions: ['.ts'] })
+
+Object.keys(sources)
+// ['src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts', 'src/core/types.ts',
+//  'src/server/factories.ts', 'src/server/helpers.ts', 'src/server/index.ts', 'src/server/types.ts']
+
+// The keys are paths; the values are the file contents.
+sources['src/core/index.ts']
+// "export * from './types.js'\nexport * from './helpers.js'\nexport * from './factories.js'\n"
+
+// An `exclude` entry is a whole key. A file key drops that file.
+Object.keys(
+	readInventory(root, ['src/core'], { extensions: ['.ts'], exclude: ['src/core/index.ts'] }),
+)
+// ['src/core/factories.ts', 'src/core/helpers.ts', 'src/core/types.ts']
+
+// A directory key prunes its whole subtree.
+Object.keys(readInventory(root, ['src'], { extensions: ['.ts'], exclude: ['src/server'] }))
+// ['src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts', 'src/core/types.ts']
+```
+
+Keys are root-relative and `/`-separated whatever the host separator is, though this package's own
+suite runs on POSIX, where that conversion is an identity, so it proves the key shape and not the
+conversion. Keys are inserted in sorted order, and a plain object reads that order back for every
+key that is not integer-like.
+
+Two boundaries are worth stating up front, because the two filesystem helpers promise different
+things. `createScratch` allocates its own directory at POSIX mode `0700` and refuses a path that
+lexically escapes it. The suite asserts those bits on POSIX and proves nothing about a host that
+emulates them. The mode keeps another uid out, and neither a sibling test worker nor the code under
+test is another uid. It does not walk segments for symbolic links. A link inside its own allocation
+was created by the test process or by the code the test drives — handing that code `scratch.path`
+is the ordinary use of this helper — and `write` and `read` follow such a link, so either can reach
+outside the allocation through it. `readInventory` walks a directory you supply, usually a checkout
+the test did not create, so it throws on a symlinked root or requested directory and skips a
+symlink met while walking. Neither is a sandbox against hostile filesystem content:
+those refusals stop accidental escape, not an adversary who can create hard links where the test
+process already writes.
+
+## Guide
+
+For the full surface — every export, the behavioral contract each one holds to, and the measured
+rule deciding what ships and what stays in the package that owns it — see
+[`guides/test.md`](guides/test.md).
+
+## Package
+
+Published as two typed entry points per the `exports` field in `package.json`: `@orkestrel/test` for
+the host-independent core, `@orkestrel/test/server` for the Node helpers. Both ship ESM and
+CommonJS.
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).

package/dist/src/core/index.cjs

@@ -0,0 +1,137 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/core/helpers.ts
+/**
+* Waits for a host timer to elapse.
+*
+* @param ms - The delay in milliseconds.
+* @returns A promise that resolves after the timer fires.
+*/
+function waitForDelay(ms = 0) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+* Captures the value thrown by a thunk.
+*
+* @param thunk - The work whose thrown value to capture.
+* @returns The thrown value, or `undefined` when the thunk completes.
+*/
+function captureError(thunk) {
+	try {
+		thunk();
+	} catch (error) {
+		return error;
+	}
+}
+/**
+* Requires a value to be present.
+*
+* @typeParam T - The required value type.
+* @param value - The value to check.
+* @param message - The error message used when the value is absent.
+* @returns The present value.
+*/
+function requireValue(value, message = "Value is required") {
+	if (value === null || value === void 0) throw new Error(message);
+	return value;
+}
+/**
+* Collects every value from an async iterable.
+*
+* @typeParam T - The yielded value type.
+* @param source - The async iterable to drain.
+* @returns The yielded values in iteration order.
+*/
+async function collect(source) {
+	const values = [];
+	for await (const value of source) values.push(value);
+	return values;
+}
+/**
+* Collects every value from a readable stream.
+*
+* @typeParam T - The streamed value type.
+* @param stream - The readable stream to drain.
+* @returns The streamed values in read order.
+*/
+async function collectStream(stream) {
+	const reader = stream.getReader();
+	const values = [];
+	try {
+		while (true) {
+			const result = await reader.read();
+			if (result.done) return values;
+			values.push(result.value);
+		}
+	} finally {
+		reader.releaseLock();
+	}
+}
+/**
+* Copies a JSON value through serialization and parsing.
+*
+* @typeParam T - The JSON value type.
+* @param value - The value to copy.
+* @returns The parsed JSON copy.
+* @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is
+* normalized to zero by JSON serialization.
+*/
+function roundTripJSON(value) {
+	const serialized = JSON.stringify(value, (_key, current) => {
+		if (typeof current === "number" && !Number.isFinite(current)) throw new Error("JSON values must contain finite numbers");
+		return current;
+	});
+	const parsed = JSON.parse(serialized);
+	const pending = [parsed];
+	while (pending.length > 0) {
+		const current = pending.pop();
+		if (current === void 0) continue;
+		if (typeof current === "number" && !Number.isFinite(current)) throw new Error("JSON values must contain finite numbers");
+		if (Array.isArray(current)) for (const child of current) pending.push(child);
+		else if (typeof current === "object" && current !== null) for (const child of Object.values(current)) pending.push(child);
+	}
+	return parsed;
+}
+/**
+* Resolves the parent directory of a calling module, which is the workspace root when called from
+* the conventional `tests/setup.ts` location.
+*
+* @param meta - The calling module metadata.
+* @returns The root URL one directory above the calling file.
+*/
+function resolveRoot(meta) {
+	return new URL("../", meta.url);
+}
+//#endregion
+//#region src/core/factories.ts
+/**
+* Creates a recorder for callback arguments.
+*
+* @typeParam TArgs - The argument tuple to record.
+* @returns A recorder whose handler appends calls in order.
+*/
+function createRecorder() {
+	const calls = [];
+	return {
+		calls,
+		get count() {
+			return calls.length;
+		},
+		handler(...args) {
+			calls.push(args);
+		},
+		clear() {
+			calls.length = 0;
+		}
+	};
+}
+//#endregion
+exports.captureError = captureError;
+exports.collect = collect;
+exports.collectStream = collectStream;
+exports.createRecorder = createRecorder;
+exports.requireValue = requireValue;
+exports.resolveRoot = resolveRoot;
+exports.roundTripJSON = roundTripJSON;
+exports.waitForDelay = waitForDelay;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/core/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/core/helpers.ts","../../../src/core/factories.ts"],"sourcesContent":["import type { JSONValue } from './types.js'\n\n/**\n * Waits for a host timer to elapse.\n *\n * @param ms - The delay in milliseconds.\n * @returns A promise that resolves after the timer fires.\n */\nexport function waitForDelay(ms = 0): Promise<void> {\n\treturn new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Captures the value thrown by a thunk.\n *\n * @param thunk - The work whose thrown value to capture.\n * @returns The thrown value, or `undefined` when the thunk completes.\n */\nexport function captureError(thunk: () => unknown): unknown {\n\ttry {\n\t\tthunk()\n\t} catch (error) {\n\t\treturn error\n\t}\n\treturn undefined\n}\n\n/**\n * Requires a value to be present.\n *\n * @typeParam T - The required value type.\n * @param value - The value to check.\n * @param message - The error message used when the value is absent.\n * @returns The present value.\n */\nexport function requireValue<T>(value: T | null | undefined, message = 'Value is required'): T {\n\tif (value === null || value === undefined) throw new Error(message)\n\treturn value\n}\n\n/**\n * Collects every value from an async iterable.\n *\n * @typeParam T - The yielded value type.\n * @param source - The async iterable to drain.\n * @returns The yielded values in iteration order.\n */\nexport async function collect<T>(source: AsyncIterable<T>): Promise<readonly T[]> {\n\tconst values: T[] = []\n\tfor await (const value of source) values.push(value)\n\treturn values\n}\n\n/**\n * Collects every value from a readable stream.\n *\n * @typeParam T - The streamed value type.\n * @param stream - The readable stream to drain.\n * @returns The streamed values in read order.\n */\nexport async function collectStream<T>(stream: ReadableStream<T>): Promise<readonly T[]> {\n\tconst reader = stream.getReader()\n\tconst values: T[] = []\n\ttry {\n\t\twhile (true) {\n\t\t\tconst result = await reader.read()\n\t\t\tif (result.done) return values\n\t\t\tvalues.push(result.value)\n\t\t}\n\t} finally {\n\t\treader.releaseLock()\n\t}\n}\n\n/**\n * Copies a JSON value through serialization and parsing.\n *\n * @typeParam T - The JSON value type.\n * @param value - The value to copy.\n * @returns The parsed JSON copy.\n * @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is\n * normalized to zero by JSON serialization.\n */\nexport function roundTripJSON<T extends JSONValue>(value: T): T {\n\tconst serialized = JSON.stringify(value, (_key, current) => {\n\t\tif (typeof current === 'number' && !Number.isFinite(current)) {\n\t\t\tthrow new Error('JSON values must contain finite numbers')\n\t\t}\n\t\treturn current\n\t})\n\tconst parsed: T = JSON.parse(serialized)\n\tconst pending: JSONValue[] = [parsed]\n\twhile (pending.length > 0) {\n\t\tconst current = pending.pop()\n\t\tif (current === undefined) continue\n\t\tif (typeof current === 'number' && !Number.isFinite(current)) {\n\t\t\tthrow new Error('JSON values must contain finite numbers')\n\t\t}\n\t\tif (Array.isArray(current)) {\n\t\t\tfor (const child of current) pending.push(child)\n\t\t} else if (typeof current === 'object' && current !== null) {\n\t\t\tfor (const child of Object.values(current)) pending.push(child)\n\t\t}\n\t}\n\treturn parsed\n}\n\n/**\n * Resolves the parent directory of a calling module, which is the workspace root when called from\n * the conventional `tests/setup.ts` location.\n *\n * @param meta - The calling module metadata.\n * @returns The root URL one directory above the calling file.\n */\nexport function resolveRoot(meta: ImportMeta): URL {\n\treturn new URL('../', meta.url)\n}\n","import type { RecorderInterface } from './types.js'\n\n/**\n * Creates a recorder for callback arguments.\n *\n * @typeParam TArgs - The argument tuple to record.\n * @returns A recorder whose handler appends calls in order.\n */\nexport function createRecorder<TArgs extends readonly unknown[]>(): RecorderInterface<TArgs> {\n\tconst calls: TArgs[] = []\n\treturn {\n\t\tcalls,\n\t\tget count() {\n\t\t\treturn calls.length\n\t\t},\n\t\thandler(...args) {\n\t\t\tcalls.push(args)\n\t\t},\n\t\tclear() {\n\t\t\tcalls.length = 0\n\t\t},\n\t}\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,aAAa,KAAK,GAAkB;CACnD,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACxD;;;;;;;AAQA,SAAgB,aAAa,OAA+B;CAC3D,IAAI;EACH,MAAM;CACP,SAAS,OAAO;EACf,OAAO;CACR;AAED;;;;;;;;;AAUA,SAAgB,aAAgB,OAA6B,UAAU,qBAAwB;CAC9F,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,MAAM,IAAI,MAAM,OAAO;CAClE,OAAO;AACR;;;;;;;;AASA,eAAsB,QAAW,QAAiD;CACjF,MAAM,SAAc,CAAC;CACrB,WAAW,MAAM,SAAS,QAAQ,OAAO,KAAK,KAAK;CACnD,OAAO;AACR;;;;;;;;AASA,eAAsB,cAAiB,QAAkD;CACxF,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,SAAc,CAAC;CACrB,IAAI;EACH,OAAO,MAAM;GACZ,MAAM,SAAS,MAAM,OAAO,KAAK;GACjC,IAAI,OAAO,MAAM,OAAO;GACxB,OAAO,KAAK,OAAO,KAAK;EACzB;CACD,UAAU;EACT,OAAO,YAAY;CACpB;AACD;;;;;;;;;;AAWA,SAAgB,cAAmC,OAAa;CAC/D,MAAM,aAAa,KAAK,UAAU,QAAQ,MAAM,YAAY;EAC3D,IAAI,OAAO,YAAY,YAAY,CAAC,OAAO,SAAS,OAAO,GAC1D,MAAM,IAAI,MAAM,yCAAyC;EAE1D,OAAO;CACR,CAAC;CACD,MAAM,SAAY,KAAK,MAAM,UAAU;CACvC,MAAM,UAAuB,CAAC,MAAM;CACpC,OAAO,QAAQ,SAAS,GAAG;EAC1B,MAAM,UAAU,QAAQ,IAAI;EAC5B,IAAI,YAAY,KAAA,GAAW;EAC3B,IAAI,OAAO,YAAY,YAAY,CAAC,OAAO,SAAS,OAAO,GAC1D,MAAM,IAAI,MAAM,yCAAyC;EAE1D,IAAI,MAAM,QAAQ,OAAO,GACxB,KAAK,MAAM,SAAS,SAAS,QAAQ,KAAK,KAAK;OACzC,IAAI,OAAO,YAAY,YAAY,YAAY,MACrD,KAAK,MAAM,SAAS,OAAO,OAAO,OAAO,GAAG,QAAQ,KAAK,KAAK;CAEhE;CACA,OAAO;AACR;;;;;;;;AASA,SAAgB,YAAY,MAAuB;CAClD,OAAO,IAAI,IAAI,OAAO,KAAK,GAAG;AAC/B;;;;;;;;;AC5GA,SAAgB,iBAA6E;CAC5F,MAAM,QAAiB,CAAC;CACxB,OAAO;EACN;EACA,IAAI,QAAQ;GACX,OAAO,MAAM;EACd;EACA,QAAQ,GAAG,MAAM;GAChB,MAAM,KAAK,IAAI;EAChB;EACA,QAAQ;GACP,MAAM,SAAS;EAChB;CACD;AACD"}

package/dist/src/core/index.d.cts

@@ -0,0 +1,94 @@
+/**
+ * Captures the value thrown by a thunk.
+ *
+ * @param thunk - The work whose thrown value to capture.
+ * @returns The thrown value, or `undefined` when the thunk completes.
+ */
+export declare function captureError(thunk: () => unknown): unknown;
+
+/**
+ * Collects every value from an async iterable.
+ *
+ * @typeParam T - The yielded value type.
+ * @param source - The async iterable to drain.
+ * @returns The yielded values in iteration order.
+ */
+export declare function collect<T>(source: AsyncIterable<T>): Promise<readonly T[]>;
+
+/**
+ * Collects every value from a readable stream.
+ *
+ * @typeParam T - The streamed value type.
+ * @param stream - The readable stream to drain.
+ * @returns The streamed values in read order.
+ */
+export declare function collectStream<T>(stream: ReadableStream<T>): Promise<readonly T[]>;
+
+/**
+ * Creates a recorder for callback arguments.
+ *
+ * @typeParam TArgs - The argument tuple to record.
+ * @returns A recorder whose handler appends calls in order.
+ */
+export declare function createRecorder<TArgs extends readonly unknown[]>(): RecorderInterface<TArgs>;
+
+/** Any value JSON can represent, so a round trip through JSON preserves the type. */
+export declare type JSONValue = string | number | boolean | null | readonly JSONValue[] | {
+    readonly [key: string]: JSONValue;
+};
+
+/**
+ * Records every call made to its handler.
+ *
+ * @typeParam TArgs - The argument tuple the recorded handler accepts.
+ */
+export declare interface RecorderInterface<TArgs extends readonly unknown[]> {
+    /** Every recorded call, oldest first, each entry the arguments of one call. */
+    readonly calls: readonly TArgs[];
+    /** How many calls have been recorded. */
+    readonly count: number;
+    /** The callback to hand to the code under test. */
+    readonly handler: (...args: TArgs) => void;
+    /** Discards the recorded calls and keeps the recorder usable. */
+    clear(): void;
+}
+
+/**
+ * Requires a value to be present.
+ *
+ * @typeParam T - The required value type.
+ * @param value - The value to check.
+ * @param message - The error message used when the value is absent.
+ * @returns The present value.
+ */
+export declare function requireValue<T>(value: T | null | undefined, message?: string): T;
+
+/**
+ * Resolves the parent directory of a calling module, which is the workspace root when called from
+ * the conventional `tests/setup.ts` location.
+ *
+ * @param meta - The calling module metadata.
+ * @returns The root URL one directory above the calling file.
+ */
+export declare function resolveRoot(meta: ImportMeta): URL;
+
+/**
+ * Copies a JSON value through serialization and parsing.
+ *
+ * @typeParam T - The JSON value type.
+ * @param value - The value to copy.
+ * @returns The parsed JSON copy.
+ * @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is
+ * normalized to zero by JSON serialization.
+ */
+export declare function roundTripJSON<T extends JSONValue>(value: T): T;
+
+/**
+ * Waits for a host timer to elapse.
+ *
+ * @param ms - The delay in milliseconds.
+ * @returns A promise that resolves after the timer fires.
+ */
+export declare function waitForDelay(ms?: number): Promise<void>;
+
+export { }

package/dist/src/core/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Captures the value thrown by a thunk.
+ *
+ * @param thunk - The work whose thrown value to capture.
+ * @returns The thrown value, or `undefined` when the thunk completes.
+ */
+export declare function captureError(thunk: () => unknown): unknown;
+
+/**
+ * Collects every value from an async iterable.
+ *
+ * @typeParam T - The yielded value type.
+ * @param source - The async iterable to drain.
+ * @returns The yielded values in iteration order.
+ */
+export declare function collect<T>(source: AsyncIterable<T>): Promise<readonly T[]>;
+
+/**
+ * Collects every value from a readable stream.
+ *
+ * @typeParam T - The streamed value type.
+ * @param stream - The readable stream to drain.
+ * @returns The streamed values in read order.
+ */
+export declare function collectStream<T>(stream: ReadableStream<T>): Promise<readonly T[]>;
+
+/**
+ * Creates a recorder for callback arguments.
+ *
+ * @typeParam TArgs - The argument tuple to record.
+ * @returns A recorder whose handler appends calls in order.
+ */
+export declare function createRecorder<TArgs extends readonly unknown[]>(): RecorderInterface<TArgs>;
+
+/** Any value JSON can represent, so a round trip through JSON preserves the type. */
+export declare type JSONValue = string | number | boolean | null | readonly JSONValue[] | {
+    readonly [key: string]: JSONValue;
+};
+
+/**
+ * Records every call made to its handler.
+ *
+ * @typeParam TArgs - The argument tuple the recorded handler accepts.
+ */
+export declare interface RecorderInterface<TArgs extends readonly unknown[]> {
+    /** Every recorded call, oldest first, each entry the arguments of one call. */
+    readonly calls: readonly TArgs[];
+    /** How many calls have been recorded. */
+    readonly count: number;
+    /** The callback to hand to the code under test. */
+    readonly handler: (...args: TArgs) => void;
+    /** Discards the recorded calls and keeps the recorder usable. */
+    clear(): void;
+}
+
+/**
+ * Requires a value to be present.
+ *
+ * @typeParam T - The required value type.
+ * @param value - The value to check.
+ * @param message - The error message used when the value is absent.
+ * @returns The present value.
+ */
+export declare function requireValue<T>(value: T | null | undefined, message?: string): T;
+
+/**
+ * Resolves the parent directory of a calling module, which is the workspace root when called from
+ * the conventional `tests/setup.ts` location.
+ *
+ * @param meta - The calling module metadata.
+ * @returns The root URL one directory above the calling file.
+ */
+export declare function resolveRoot(meta: ImportMeta): URL;
+
+/**
+ * Copies a JSON value through serialization and parsing.
+ *
+ * @typeParam T - The JSON value type.
+ * @param value - The value to copy.
+ * @returns The parsed JSON copy.
+ * @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is
+ * normalized to zero by JSON serialization.
+ */
+export declare function roundTripJSON<T extends JSONValue>(value: T): T;
+
+/**
+ * Waits for a host timer to elapse.
+ *
+ * @param ms - The delay in milliseconds.
+ * @returns A promise that resolves after the timer fires.
+ */
+export declare function waitForDelay(ms?: number): Promise<void>;
+
+export { }

package/dist/src/core/index.js

@@ -0,0 +1,129 @@
+//#region src/core/helpers.ts
+/**
+* Waits for a host timer to elapse.
+*
+* @param ms - The delay in milliseconds.
+* @returns A promise that resolves after the timer fires.
+*/
+function waitForDelay(ms = 0) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+* Captures the value thrown by a thunk.
+*
+* @param thunk - The work whose thrown value to capture.
+* @returns The thrown value, or `undefined` when the thunk completes.
+*/
+function captureError(thunk) {
+	try {
+		thunk();
+	} catch (error) {
+		return error;
+	}
+}
+/**
+* Requires a value to be present.
+*
+* @typeParam T - The required value type.
+* @param value - The value to check.
+* @param message - The error message used when the value is absent.
+* @returns The present value.
+*/
+function requireValue(value, message = "Value is required") {
+	if (value === null || value === void 0) throw new Error(message);
+	return value;
+}
+/**
+* Collects every value from an async iterable.
+*
+* @typeParam T - The yielded value type.
+* @param source - The async iterable to drain.
+* @returns The yielded values in iteration order.
+*/
+async function collect(source) {
+	const values = [];
+	for await (const value of source) values.push(value);
+	return values;
+}
+/**
+* Collects every value from a readable stream.
+*
+* @typeParam T - The streamed value type.
+* @param stream - The readable stream to drain.
+* @returns The streamed values in read order.
+*/
+async function collectStream(stream) {
+	const reader = stream.getReader();
+	const values = [];
+	try {
+		while (true) {
+			const result = await reader.read();
+			if (result.done) return values;
+			values.push(result.value);
+		}
+	} finally {
+		reader.releaseLock();
+	}
+}
+/**
+* Copies a JSON value through serialization and parsing.
+*
+* @typeParam T - The JSON value type.
+* @param value - The value to copy.
+* @returns The parsed JSON copy.
+* @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is
+* normalized to zero by JSON serialization.
+*/
+function roundTripJSON(value) {
+	const serialized = JSON.stringify(value, (_key, current) => {
+		if (typeof current === "number" && !Number.isFinite(current)) throw new Error("JSON values must contain finite numbers");
+		return current;
+	});
+	const parsed = JSON.parse(serialized);
+	const pending = [parsed];
+	while (pending.length > 0) {
+		const current = pending.pop();
+		if (current === void 0) continue;
+		if (typeof current === "number" && !Number.isFinite(current)) throw new Error("JSON values must contain finite numbers");
+		if (Array.isArray(current)) for (const child of current) pending.push(child);
+		else if (typeof current === "object" && current !== null) for (const child of Object.values(current)) pending.push(child);
+	}
+	return parsed;
+}
+/**
+* Resolves the parent directory of a calling module, which is the workspace root when called from
+* the conventional `tests/setup.ts` location.
+*
+* @param meta - The calling module metadata.
+* @returns The root URL one directory above the calling file.
+*/
+function resolveRoot(meta) {
+	return new URL("../", meta.url);
+}
+//#endregion
+//#region src/core/factories.ts
+/**
+* Creates a recorder for callback arguments.
+*
+* @typeParam TArgs - The argument tuple to record.
+* @returns A recorder whose handler appends calls in order.
+*/
+function createRecorder() {
+	const calls = [];
+	return {
+		calls,
+		get count() {
+			return calls.length;
+		},
+		handler(...args) {
+			calls.push(args);
+		},
+		clear() {
+			calls.length = 0;
+		}
+	};
+}
+//#endregion
+export { captureError, collect, collectStream, createRecorder, requireValue, resolveRoot, roundTripJSON, waitForDelay };
+
+//# sourceMappingURL=index.js.map

package/dist/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/core/helpers.ts","../../../src/core/factories.ts"],"sourcesContent":["import type { JSONValue } from './types.js'\n\n/**\n * Waits for a host timer to elapse.\n *\n * @param ms - The delay in milliseconds.\n * @returns A promise that resolves after the timer fires.\n */\nexport function waitForDelay(ms = 0): Promise<void> {\n\treturn new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Captures the value thrown by a thunk.\n *\n * @param thunk - The work whose thrown value to capture.\n * @returns The thrown value, or `undefined` when the thunk completes.\n */\nexport function captureError(thunk: () => unknown): unknown {\n\ttry {\n\t\tthunk()\n\t} catch (error) {\n\t\treturn error\n\t}\n\treturn undefined\n}\n\n/**\n * Requires a value to be present.\n *\n * @typeParam T - The required value type.\n * @param value - The value to check.\n * @param message - The error message used when the value is absent.\n * @returns The present value.\n */\nexport function requireValue<T>(value: T | null | undefined, message = 'Value is required'): T {\n\tif (value === null || value === undefined) throw new Error(message)\n\treturn value\n}\n\n/**\n * Collects every value from an async iterable.\n *\n * @typeParam T - The yielded value type.\n * @param source - The async iterable to drain.\n * @returns The yielded values in iteration order.\n */\nexport async function collect<T>(source: AsyncIterable<T>): Promise<readonly T[]> {\n\tconst values: T[] = []\n\tfor await (const value of source) values.push(value)\n\treturn values\n}\n\n/**\n * Collects every value from a readable stream.\n *\n * @typeParam T - The streamed value type.\n * @param stream - The readable stream to drain.\n * @returns The streamed values in read order.\n */\nexport async function collectStream<T>(stream: ReadableStream<T>): Promise<readonly T[]> {\n\tconst reader = stream.getReader()\n\tconst values: T[] = []\n\ttry {\n\t\twhile (true) {\n\t\t\tconst result = await reader.read()\n\t\t\tif (result.done) return values\n\t\t\tvalues.push(result.value)\n\t\t}\n\t} finally {\n\t\treader.releaseLock()\n\t}\n}\n\n/**\n * Copies a JSON value through serialization and parsing.\n *\n * @typeParam T - The JSON value type.\n * @param value - The value to copy.\n * @returns The parsed JSON copy.\n * @remarks Non-finite numbers throw because JSON would replace them with `null`. Negative zero is\n * normalized to zero by JSON serialization.\n */\nexport function roundTripJSON<T extends JSONValue>(value: T): T {\n\tconst serialized = JSON.stringify(value, (_key, current) => {\n\t\tif (typeof current === 'number' && !Number.isFinite(current)) {\n\t\t\tthrow new Error('JSON values must contain finite numbers')\n\t\t}\n\t\treturn current\n\t})\n\tconst parsed: T = JSON.parse(serialized)\n\tconst pending: JSONValue[] = [parsed]\n\twhile (pending.length > 0) {\n\t\tconst current = pending.pop()\n\t\tif (current === undefined) continue\n\t\tif (typeof current === 'number' && !Number.isFinite(current)) {\n\t\t\tthrow new Error('JSON values must contain finite numbers')\n\t\t}\n\t\tif (Array.isArray(current)) {\n\t\t\tfor (const child of current) pending.push(child)\n\t\t} else if (typeof current === 'object' && current !== null) {\n\t\t\tfor (const child of Object.values(current)) pending.push(child)\n\t\t}\n\t}\n\treturn parsed\n}\n\n/**\n * Resolves the parent directory of a calling module, which is the workspace root when called from\n * the conventional `tests/setup.ts` location.\n *\n * @param meta - The calling module metadata.\n * @returns The root URL one directory above the calling file.\n */\nexport function resolveRoot(meta: ImportMeta): URL {\n\treturn new URL('../', meta.url)\n}\n","import type { RecorderInterface } from './types.js'\n\n/**\n * Creates a recorder for callback arguments.\n *\n * @typeParam TArgs - The argument tuple to record.\n * @returns A recorder whose handler appends calls in order.\n */\nexport function createRecorder<TArgs extends readonly unknown[]>(): RecorderInterface<TArgs> {\n\tconst calls: TArgs[] = []\n\treturn {\n\t\tcalls,\n\t\tget count() {\n\t\t\treturn calls.length\n\t\t},\n\t\thandler(...args) {\n\t\t\tcalls.push(args)\n\t\t},\n\t\tclear() {\n\t\t\tcalls.length = 0\n\t\t},\n\t}\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,aAAa,KAAK,GAAkB;CACnD,OAAO,IAAI,SAAS,YAAY,WAAW,SAAS,EAAE,CAAC;AACxD;;;;;;;AAQA,SAAgB,aAAa,OAA+B;CAC3D,IAAI;EACH,MAAM;CACP,SAAS,OAAO;EACf,OAAO;CACR;AAED;;;;;;;;;AAUA,SAAgB,aAAgB,OAA6B,UAAU,qBAAwB;CAC9F,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,MAAM,IAAI,MAAM,OAAO;CAClE,OAAO;AACR;;;;;;;;AASA,eAAsB,QAAW,QAAiD;CACjF,MAAM,SAAc,CAAC;CACrB,WAAW,MAAM,SAAS,QAAQ,OAAO,KAAK,KAAK;CACnD,OAAO;AACR;;;;;;;;AASA,eAAsB,cAAiB,QAAkD;CACxF,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,SAAc,CAAC;CACrB,IAAI;EACH,OAAO,MAAM;GACZ,MAAM,SAAS,MAAM,OAAO,KAAK;GACjC,IAAI,OAAO,MAAM,OAAO;GACxB,OAAO,KAAK,OAAO,KAAK;EACzB;CACD,UAAU;EACT,OAAO,YAAY;CACpB;AACD;;;;;;;;;;AAWA,SAAgB,cAAmC,OAAa;CAC/D,MAAM,aAAa,KAAK,UAAU,QAAQ,MAAM,YAAY;EAC3D,IAAI,OAAO,YAAY,YAAY,CAAC,OAAO,SAAS,OAAO,GAC1D,MAAM,IAAI,MAAM,yCAAyC;EAE1D,OAAO;CACR,CAAC;CACD,MAAM,SAAY,KAAK,MAAM,UAAU;CACvC,MAAM,UAAuB,CAAC,MAAM;CACpC,OAAO,QAAQ,SAAS,GAAG;EAC1B,MAAM,UAAU,QAAQ,IAAI;EAC5B,IAAI,YAAY,KAAA,GAAW;EAC3B,IAAI,OAAO,YAAY,YAAY,CAAC,OAAO,SAAS,OAAO,GAC1D,MAAM,IAAI,MAAM,yCAAyC;EAE1D,IAAI,MAAM,QAAQ,OAAO,GACxB,KAAK,MAAM,SAAS,SAAS,QAAQ,KAAK,KAAK;OACzC,IAAI,OAAO,YAAY,YAAY,YAAY,MACrD,KAAK,MAAM,SAAS,OAAO,OAAO,OAAO,GAAG,QAAQ,KAAK,KAAK;CAEhE;CACA,OAAO;AACR;;;;;;;;AASA,SAAgB,YAAY,MAAuB;CAClD,OAAO,IAAI,IAAI,OAAO,KAAK,GAAG;AAC/B;;;;;;;;;AC5GA,SAAgB,iBAA6E;CAC5F,MAAM,QAAiB,CAAC;CACxB,OAAO;EACN;EACA,IAAI,QAAQ;GACX,OAAO,MAAM;EACd;EACA,QAAQ,GAAG,MAAM;GAChB,MAAM,KAAK,IAAI;EAChB;EACA,QAAQ;GACP,MAAM,SAAS;EAChB;CACD;AACD"}

package/dist/src/server/index.cjs

@@ -0,0 +1,152 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let node_url = require("node:url");
+let node_os = require("node:os");
+//#region src/server/helpers.ts
+/**
+* Resolves a target that stays below a root directory.
+*
+* @param root - The absolute root directory.
+* @param target - The relative or absolute target to resolve.
+* @returns The absolute target, or `undefined` when the target escapes the root.
+*/
+function resolveContained(root, target) {
+	const candidate = (0, node_path.resolve)(root, target);
+	const contained = (0, node_path.relative)(root, candidate);
+	if (contained === ".." || contained.startsWith(`..${node_path.sep}`) || (0, node_path.isAbsolute)(contained)) return;
+	return candidate;
+}
+/**
+* Reads files from selected directories below a root directory.
+*
+* @param root - The root directory as a path or file URL.
+* @param directories - The directories to visit below the root.
+* @param options - Optional file extension and exact-path exclusions.
+* @returns File contents keyed by sorted root-relative paths.
+* @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.
+*/
+function readInventory(root, directories, options) {
+	const supplied = (0, node_path.resolve)(typeof root === "string" ? root : (0, node_url.fileURLToPath)(root));
+	const rootStatus = (0, node_fs.lstatSync)(supplied);
+	if (rootStatus.isSymbolicLink()) throw new Error("Root is a symbolic link");
+	if (!rootStatus.isDirectory()) throw new Error("Root is not a directory");
+	const base = node_fs.realpathSync.native(supplied);
+	if (directories.length === 0) return Object.fromEntries([]);
+	const excluded = new Set(options?.exclude);
+	const pending = [];
+	const queued = /* @__PURE__ */ new Set();
+	const contents = /* @__PURE__ */ new Map();
+	for (const directory of directories) {
+		const candidate = resolveContained(base, directory);
+		if (candidate === void 0) throw new Error(`Directory outside root: ${directory}`);
+		const status = (0, node_fs.lstatSync)(candidate);
+		if (status.isSymbolicLink()) throw new Error(`Directory is a symbolic link: ${directory}`);
+		if (!status.isDirectory()) throw new Error(`Not a directory: ${directory}`);
+		const physical = node_fs.realpathSync.native(candidate);
+		const resolved = resolveContained(base, (0, node_path.relative)(base, physical));
+		if (resolved === void 0) throw new Error(`Directory outside root: ${directory}`);
+		const key = (0, node_path.relative)(base, resolved).split(node_path.sep).join("/");
+		if (excluded.has(key) || queued.has(physical)) continue;
+		queued.add(physical);
+		pending.push(physical);
+	}
+	while (pending.length > 0) {
+		const directory = pending.pop();
+		if (directory === void 0) continue;
+		for (const entry of (0, node_fs.readdirSync)(directory, { withFileTypes: true })) {
+			const path = (0, node_path.resolve)(directory, entry.name);
+			const status = (0, node_fs.lstatSync)(path);
+			if (status.isSymbolicLink()) continue;
+			const key = (0, node_path.relative)(base, path).split(node_path.sep).join("/");
+			if (excluded.has(key)) continue;
+			if (status.isDirectory()) {
+				const physical = node_fs.realpathSync.native(path);
+				if (resolveContained(base, (0, node_path.relative)(base, physical)) === void 0 || queued.has(physical)) continue;
+				queued.add(physical);
+				pending.push(physical);
+				continue;
+			}
+			if (!status.isFile() || options?.extensions !== void 0 && !options.extensions.some((extension) => entry.name.endsWith(extension))) continue;
+			contents.set(key, (0, node_fs.readFileSync)(path, "utf8"));
+		}
+	}
+	return Object.fromEntries(Array.from(contents).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0));
+}
+//#endregion
+//#region src/server/factories.ts
+/**
+* Allocates an owned temporary directory with contained file operations.
+*
+* @param options - Optional directory prefix and initial files.
+* @returns The scratch directory and its file operations.
+* @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.
+*/
+function createScratch(options) {
+	const temporary = (0, node_path.resolve)((0, node_os.tmpdir)());
+	const prefix = (0, node_path.resolve)(temporary, options?.prefix ?? "orkestrel-test-");
+	if ((0, node_path.dirname)(prefix) !== temporary) throw new Error("Scratch prefix must stay within the temporary directory");
+	const path = (0, node_fs.mkdtempSync)(prefix);
+	const allocation = (0, node_fs.statSync)(path);
+	const outside = "Path outside scratch directory";
+	try {
+		for (const [target, text] of Object.entries(options?.files ?? {})) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			(0, node_fs.mkdirSync)((0, node_path.dirname)(candidate), { recursive: true });
+			(0, node_fs.writeFileSync)(candidate, text);
+		}
+	} catch (error) {
+		(0, node_fs.rmSync)(path, {
+			force: true,
+			recursive: true
+		});
+		throw error;
+	}
+	const scratch = {
+		path,
+		write(target, text) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			const rootStatus = (0, node_fs.lstatSync)(path, { throwIfNoEntry: false });
+			if (rootStatus === void 0) throw new Error("Scratch directory does not exist");
+			if (rootStatus.isSymbolicLink()) throw new Error("Scratch directory is a symbolic link");
+			if (!rootStatus.isDirectory()) throw new Error("Scratch path is not a directory");
+			(0, node_fs.mkdirSync)((0, node_path.dirname)(candidate), { recursive: true });
+			(0, node_fs.writeFileSync)(candidate, text);
+		},
+		read(target) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			if (!scratch.exists(target)) return void 0;
+			const status = (0, node_fs.statSync)(candidate, { throwIfNoEntry: false });
+			if (status === void 0) return void 0;
+			if (status.isDirectory()) throw new Error(`Scratch path is a directory: ${target}`);
+			return (0, node_fs.readFileSync)(candidate, "utf8");
+		},
+		exists(target) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			const rootStatus = (0, node_fs.lstatSync)(path, { throwIfNoEntry: false });
+			if (rootStatus === void 0) return false;
+			if (rootStatus.isSymbolicLink()) throw new Error("Scratch directory is a symbolic link");
+			if (!rootStatus.isDirectory()) throw new Error("Scratch path is not a directory");
+			return (0, node_fs.lstatSync)(candidate, { throwIfNoEntry: false }) !== void 0;
+		},
+		destroy() {
+			const status = (0, node_fs.lstatSync)(path, { throwIfNoEntry: false });
+			if (status === void 0 || status.dev !== allocation.dev || status.ino !== allocation.ino || status.birthtimeMs !== allocation.birthtimeMs) return;
+			(0, node_fs.rmSync)(path, {
+				force: true,
+				recursive: true
+			});
+		}
+	};
+	return scratch;
+}
+//#endregion
+exports.createScratch = createScratch;
+exports.readInventory = readInventory;
+exports.resolveContained = resolveContained;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/server/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/server/helpers.ts","../../../src/server/factories.ts"],"sourcesContent":["import type { InventoryOptions } from './types.js'\nimport { lstatSync, readdirSync, readFileSync, realpathSync } from 'node:fs'\nimport { isAbsolute, relative, resolve, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/**\n * Resolves a target that stays below a root directory.\n *\n * @param root - The absolute root directory.\n * @param target - The relative or absolute target to resolve.\n * @returns The absolute target, or `undefined` when the target escapes the root.\n */\nexport function resolveContained(root: string, target: string): string | undefined {\n\tconst candidate = resolve(root, target)\n\tconst contained = relative(root, candidate)\n\tif (contained === '..' || contained.startsWith(`..${sep}`) || isAbsolute(contained)) {\n\t\treturn undefined\n\t}\n\treturn candidate\n}\n\n/**\n * Reads files from selected directories below a root directory.\n *\n * @param root - The root directory as a path or file URL.\n * @param directories - The directories to visit below the root.\n * @param options - Optional file extension and exact-path exclusions.\n * @returns File contents keyed by sorted root-relative paths.\n * @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.\n */\nexport function readInventory(\n\troot: URL | string,\n\tdirectories: readonly string[],\n\toptions?: InventoryOptions,\n): Readonly<Record<string, string>> {\n\tconst supplied = resolve(typeof root === 'string' ? root : fileURLToPath(root))\n\tconst rootStatus = lstatSync(supplied)\n\tif (rootStatus.isSymbolicLink()) throw new Error('Root is a symbolic link')\n\tif (!rootStatus.isDirectory()) throw new Error('Root is not a directory')\n\n\tconst base = realpathSync.native(supplied)\n\tif (directories.length === 0) return Object.fromEntries([])\n\n\tconst excluded = new Set(options?.exclude)\n\tconst pending: string[] = []\n\tconst queued = new Set<string>()\n\tconst contents = new Map<string, string>()\n\n\tfor (const directory of directories) {\n\t\tconst candidate = resolveContained(base, directory)\n\t\tif (candidate === undefined) {\n\t\t\tthrow new Error(`Directory outside root: ${directory}`)\n\t\t}\n\n\t\tconst status = lstatSync(candidate)\n\t\tif (status.isSymbolicLink()) throw new Error(`Directory is a symbolic link: ${directory}`)\n\t\tif (!status.isDirectory()) throw new Error(`Not a directory: ${directory}`)\n\n\t\tconst physical = realpathSync.native(candidate)\n\t\tconst resolved = resolveContained(base, relative(base, physical))\n\t\tif (resolved === undefined) {\n\t\t\tthrow new Error(`Directory outside root: ${directory}`)\n\t\t}\n\n\t\tconst key = relative(base, resolved).split(sep).join('/')\n\t\tif (excluded.has(key) || queued.has(physical)) continue\n\t\tqueued.add(physical)\n\t\tpending.push(physical)\n\t}\n\n\twhile (pending.length > 0) {\n\t\tconst directory = pending.pop()\n\t\tif (directory === undefined) continue\n\n\t\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\t\tconst path = resolve(directory, entry.name)\n\t\t\tconst status = lstatSync(path)\n\t\t\tif (status.isSymbolicLink()) continue\n\n\t\t\tconst key = relative(base, path).split(sep).join('/')\n\t\t\tif (excluded.has(key)) continue\n\n\t\t\tif (status.isDirectory()) {\n\t\t\t\tconst physical = realpathSync.native(path)\n\t\t\t\tconst resolved = resolveContained(base, relative(base, physical))\n\t\t\t\tif (resolved === undefined || queued.has(physical)) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tqueued.add(physical)\n\t\t\t\tpending.push(physical)\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\tif (\n\t\t\t\t!status.isFile() ||\n\t\t\t\t(options?.extensions !== undefined &&\n\t\t\t\t\t!options.extensions.some((extension) => entry.name.endsWith(extension)))\n\t\t\t) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tcontents.set(key, readFileSync(path, 'utf8'))\n\t\t}\n\t}\n\n\treturn Object.fromEntries(\n\t\tArray.from(contents).sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)),\n\t)\n}\n","import type { ScratchInterface, ScratchOptions } from './types.js'\nimport {\n\tlstatSync,\n\tmkdirSync,\n\tmkdtempSync,\n\treadFileSync,\n\trmSync,\n\tstatSync,\n\twriteFileSync,\n} from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { dirname, resolve } from 'node:path'\nimport { resolveContained } from './helpers.js'\n\n/**\n * Allocates an owned temporary directory with contained file operations.\n *\n * @param options - Optional directory prefix and initial files.\n * @returns The scratch directory and its file operations.\n * @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.\n */\nexport function createScratch(options?: ScratchOptions): ScratchInterface {\n\tconst temporary = resolve(tmpdir())\n\tconst prefix = resolve(temporary, options?.prefix ?? 'orkestrel-test-')\n\tif (dirname(prefix) !== temporary)\n\t\tthrow new Error('Scratch prefix must stay within the temporary directory')\n\n\tconst path = mkdtempSync(prefix)\n\tconst allocation = statSync(path)\n\tconst outside = 'Path outside scratch directory'\n\ttry {\n\t\tfor (const [target, text] of Object.entries(options?.files ?? {})) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tmkdirSync(dirname(candidate), { recursive: true })\n\t\t\twriteFileSync(candidate, text)\n\t\t}\n\t} catch (error) {\n\t\trmSync(path, { force: true, recursive: true })\n\t\tthrow error\n\t}\n\n\tconst scratch: ScratchInterface = {\n\t\tpath,\n\t\twrite(target, text) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tconst rootStatus = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (rootStatus === undefined) throw new Error('Scratch directory does not exist')\n\t\t\tif (rootStatus.isSymbolicLink()) throw new Error('Scratch directory is a symbolic link')\n\t\t\tif (!rootStatus.isDirectory()) throw new Error('Scratch path is not a directory')\n\n\t\t\tmkdirSync(dirname(candidate), { recursive: true })\n\t\t\twriteFileSync(candidate, text)\n\t\t},\n\t\tread(target) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\t\t\tif (!scratch.exists(target)) return undefined\n\t\t\tconst status = statSync(candidate, { throwIfNoEntry: false })\n\t\t\tif (status === undefined) return undefined\n\t\t\tif (status.isDirectory()) {\n\t\t\t\tthrow new Error(`Scratch path is a directory: ${target}`)\n\t\t\t}\n\t\t\treturn readFileSync(candidate, 'utf8')\n\t\t},\n\t\texists(target) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tconst rootStatus = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (rootStatus === undefined) return false\n\t\t\tif (rootStatus.isSymbolicLink()) throw new Error('Scratch directory is a symbolic link')\n\t\t\tif (!rootStatus.isDirectory()) throw new Error('Scratch path is not a directory')\n\n\t\t\treturn lstatSync(candidate, { throwIfNoEntry: false }) !== undefined\n\t\t},\n\t\tdestroy() {\n\t\t\tconst status = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (\n\t\t\t\tstatus === undefined ||\n\t\t\t\tstatus.dev !== allocation.dev ||\n\t\t\t\tstatus.ino !== allocation.ino ||\n\t\t\t\tstatus.birthtimeMs !== allocation.birthtimeMs\n\t\t\t)\n\t\t\t\treturn\n\t\t\trmSync(path, { force: true, recursive: true })\n\t\t},\n\t}\n\treturn scratch\n}\n"],"mappings":"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"}

package/dist/src/server/index.d.cts

@@ -0,0 +1,80 @@
+/**
+ * Allocates an owned temporary directory with contained file operations.
+ *
+ * @param options - Optional directory prefix and initial files.
+ * @returns The scratch directory and its file operations.
+ * @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.
+ */
+export declare function createScratch(options?: ScratchOptions): ScratchInterface;
+
+/** Options for reading a source inventory. */
+export declare interface InventoryOptions {
+    /** The file extensions to include, each written with its leading dot. */
+    readonly extensions?: readonly string[];
+    /** The root-relative path keys to exclude. A directory key also excludes its descendants. */
+    readonly exclude?: readonly string[];
+}
+
+/**
+ * Reads files from selected directories below a root directory.
+ *
+ * @param root - The root directory as a path or file URL.
+ * @param directories - The directories to visit below the root.
+ * @param options - Optional file extension and exact-path exclusions.
+ * @returns File contents keyed by sorted root-relative paths.
+ * @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.
+ */
+export declare function readInventory(root: URL | string, directories: readonly string[], options?: InventoryOptions): Readonly<Record<string, string>>;
+
+/**
+ * Resolves a target that stays below a root directory.
+ *
+ * @param root - The absolute root directory.
+ * @param target - The relative or absolute target to resolve.
+ * @returns The absolute target, or `undefined` when the target escapes the root.
+ */
+export declare function resolveContained(root: string, target: string): string | undefined;
+
+/** A temporary directory a test owns, writes into, reads back, and removes when it is done. */
+export declare interface ScratchInterface {
+    /** The absolute path of the allocated directory. */
+    readonly path: string;
+    /**
+     * Writes a file, creating each parent directory that does not exist.
+     *
+     * @param target - A relative or absolute file path contained by the scratch directory.
+     * @param text - The file contents.
+     */
+    write(target: string, text: string): void;
+    /**
+     * Reads a file.
+     *
+     * @param target - A relative or absolute file path contained by the scratch directory.
+     * @returns The file contents, or `undefined` when no file can be read, including through a
+     * symbolic link whose target is missing.
+     * @throws When the path is a directory, escapes the scratch directory, or its root is a symbolic
+     * link or file. Reading follows links, so a link the host cannot resolve — a cycle, for one —
+     * surfaces the host's own error rather than `undefined`.
+     */
+    read(target: string): string | undefined;
+    /**
+     * Reports whether a path exists.
+     *
+     * @param target - A relative or absolute path contained by the scratch directory.
+     * @returns True when the entry exists, including a symbolic link whose target is missing.
+     * @throws When the path escapes the scratch directory or its root is a symbolic link or file.
+     */
+    exists(target: string): boolean;
+    /** Removes the directory and everything in it. */
+    destroy(): void;
+}
+
+/** Options for allocating a scratch directory. */
+export declare interface ScratchOptions {
+    /** The leading text of the generated directory name. */
+    readonly prefix?: string;
+    /** Files to write on allocation, keyed by path below the scratch directory. */
+    readonly files?: Readonly<Record<string, string>>;
+}
+
+export { }

package/dist/src/server/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Allocates an owned temporary directory with contained file operations.
+ *
+ * @param options - Optional directory prefix and initial files.
+ * @returns The scratch directory and its file operations.
+ * @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.
+ */
+export declare function createScratch(options?: ScratchOptions): ScratchInterface;
+
+/** Options for reading a source inventory. */
+export declare interface InventoryOptions {
+    /** The file extensions to include, each written with its leading dot. */
+    readonly extensions?: readonly string[];
+    /** The root-relative path keys to exclude. A directory key also excludes its descendants. */
+    readonly exclude?: readonly string[];
+}
+
+/**
+ * Reads files from selected directories below a root directory.
+ *
+ * @param root - The root directory as a path or file URL.
+ * @param directories - The directories to visit below the root.
+ * @param options - Optional file extension and exact-path exclusions.
+ * @returns File contents keyed by sorted root-relative paths.
+ * @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.
+ */
+export declare function readInventory(root: URL | string, directories: readonly string[], options?: InventoryOptions): Readonly<Record<string, string>>;
+
+/**
+ * Resolves a target that stays below a root directory.
+ *
+ * @param root - The absolute root directory.
+ * @param target - The relative or absolute target to resolve.
+ * @returns The absolute target, or `undefined` when the target escapes the root.
+ */
+export declare function resolveContained(root: string, target: string): string | undefined;
+
+/** A temporary directory a test owns, writes into, reads back, and removes when it is done. */
+export declare interface ScratchInterface {
+    /** The absolute path of the allocated directory. */
+    readonly path: string;
+    /**
+     * Writes a file, creating each parent directory that does not exist.
+     *
+     * @param target - A relative or absolute file path contained by the scratch directory.
+     * @param text - The file contents.
+     */
+    write(target: string, text: string): void;
+    /**
+     * Reads a file.
+     *
+     * @param target - A relative or absolute file path contained by the scratch directory.
+     * @returns The file contents, or `undefined` when no file can be read, including through a
+     * symbolic link whose target is missing.
+     * @throws When the path is a directory, escapes the scratch directory, or its root is a symbolic
+     * link or file. Reading follows links, so a link the host cannot resolve — a cycle, for one —
+     * surfaces the host's own error rather than `undefined`.
+     */
+    read(target: string): string | undefined;
+    /**
+     * Reports whether a path exists.
+     *
+     * @param target - A relative or absolute path contained by the scratch directory.
+     * @returns True when the entry exists, including a symbolic link whose target is missing.
+     * @throws When the path escapes the scratch directory or its root is a symbolic link or file.
+     */
+    exists(target: string): boolean;
+    /** Removes the directory and everything in it. */
+    destroy(): void;
+}
+
+/** Options for allocating a scratch directory. */
+export declare interface ScratchOptions {
+    /** The leading text of the generated directory name. */
+    readonly prefix?: string;
+    /** Files to write on allocation, keyed by path below the scratch directory. */
+    readonly files?: Readonly<Record<string, string>>;
+}
+
+export { }

package/dist/src/server/index.js

@@ -0,0 +1,149 @@
+import { lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+import { tmpdir } from "node:os";
+//#region src/server/helpers.ts
+/**
+* Resolves a target that stays below a root directory.
+*
+* @param root - The absolute root directory.
+* @param target - The relative or absolute target to resolve.
+* @returns The absolute target, or `undefined` when the target escapes the root.
+*/
+function resolveContained(root, target) {
+	const candidate = resolve(root, target);
+	const contained = relative(root, candidate);
+	if (contained === ".." || contained.startsWith(`..${sep}`) || isAbsolute(contained)) return;
+	return candidate;
+}
+/**
+* Reads files from selected directories below a root directory.
+*
+* @param root - The root directory as a path or file URL.
+* @param directories - The directories to visit below the root.
+* @param options - Optional file extension and exact-path exclusions.
+* @returns File contents keyed by sorted root-relative paths.
+* @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.
+*/
+function readInventory(root, directories, options) {
+	const supplied = resolve(typeof root === "string" ? root : fileURLToPath(root));
+	const rootStatus = lstatSync(supplied);
+	if (rootStatus.isSymbolicLink()) throw new Error("Root is a symbolic link");
+	if (!rootStatus.isDirectory()) throw new Error("Root is not a directory");
+	const base = realpathSync.native(supplied);
+	if (directories.length === 0) return Object.fromEntries([]);
+	const excluded = new Set(options?.exclude);
+	const pending = [];
+	const queued = /* @__PURE__ */ new Set();
+	const contents = /* @__PURE__ */ new Map();
+	for (const directory of directories) {
+		const candidate = resolveContained(base, directory);
+		if (candidate === void 0) throw new Error(`Directory outside root: ${directory}`);
+		const status = lstatSync(candidate);
+		if (status.isSymbolicLink()) throw new Error(`Directory is a symbolic link: ${directory}`);
+		if (!status.isDirectory()) throw new Error(`Not a directory: ${directory}`);
+		const physical = realpathSync.native(candidate);
+		const resolved = resolveContained(base, relative(base, physical));
+		if (resolved === void 0) throw new Error(`Directory outside root: ${directory}`);
+		const key = relative(base, resolved).split(sep).join("/");
+		if (excluded.has(key) || queued.has(physical)) continue;
+		queued.add(physical);
+		pending.push(physical);
+	}
+	while (pending.length > 0) {
+		const directory = pending.pop();
+		if (directory === void 0) continue;
+		for (const entry of readdirSync(directory, { withFileTypes: true })) {
+			const path = resolve(directory, entry.name);
+			const status = lstatSync(path);
+			if (status.isSymbolicLink()) continue;
+			const key = relative(base, path).split(sep).join("/");
+			if (excluded.has(key)) continue;
+			if (status.isDirectory()) {
+				const physical = realpathSync.native(path);
+				if (resolveContained(base, relative(base, physical)) === void 0 || queued.has(physical)) continue;
+				queued.add(physical);
+				pending.push(physical);
+				continue;
+			}
+			if (!status.isFile() || options?.extensions !== void 0 && !options.extensions.some((extension) => entry.name.endsWith(extension))) continue;
+			contents.set(key, readFileSync(path, "utf8"));
+		}
+	}
+	return Object.fromEntries(Array.from(contents).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0));
+}
+//#endregion
+//#region src/server/factories.ts
+/**
+* Allocates an owned temporary directory with contained file operations.
+*
+* @param options - Optional directory prefix and initial files.
+* @returns The scratch directory and its file operations.
+* @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.
+*/
+function createScratch(options) {
+	const temporary = resolve(tmpdir());
+	const prefix = resolve(temporary, options?.prefix ?? "orkestrel-test-");
+	if (dirname(prefix) !== temporary) throw new Error("Scratch prefix must stay within the temporary directory");
+	const path = mkdtempSync(prefix);
+	const allocation = statSync(path);
+	const outside = "Path outside scratch directory";
+	try {
+		for (const [target, text] of Object.entries(options?.files ?? {})) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			mkdirSync(dirname(candidate), { recursive: true });
+			writeFileSync(candidate, text);
+		}
+	} catch (error) {
+		rmSync(path, {
+			force: true,
+			recursive: true
+		});
+		throw error;
+	}
+	const scratch = {
+		path,
+		write(target, text) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			const rootStatus = lstatSync(path, { throwIfNoEntry: false });
+			if (rootStatus === void 0) throw new Error("Scratch directory does not exist");
+			if (rootStatus.isSymbolicLink()) throw new Error("Scratch directory is a symbolic link");
+			if (!rootStatus.isDirectory()) throw new Error("Scratch path is not a directory");
+			mkdirSync(dirname(candidate), { recursive: true });
+			writeFileSync(candidate, text);
+		},
+		read(target) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			if (!scratch.exists(target)) return void 0;
+			const status = statSync(candidate, { throwIfNoEntry: false });
+			if (status === void 0) return void 0;
+			if (status.isDirectory()) throw new Error(`Scratch path is a directory: ${target}`);
+			return readFileSync(candidate, "utf8");
+		},
+		exists(target) {
+			const candidate = resolveContained(path, target);
+			if (candidate === void 0) throw new Error(`${outside}: ${target}`);
+			const rootStatus = lstatSync(path, { throwIfNoEntry: false });
+			if (rootStatus === void 0) return false;
+			if (rootStatus.isSymbolicLink()) throw new Error("Scratch directory is a symbolic link");
+			if (!rootStatus.isDirectory()) throw new Error("Scratch path is not a directory");
+			return lstatSync(candidate, { throwIfNoEntry: false }) !== void 0;
+		},
+		destroy() {
+			const status = lstatSync(path, { throwIfNoEntry: false });
+			if (status === void 0 || status.dev !== allocation.dev || status.ino !== allocation.ino || status.birthtimeMs !== allocation.birthtimeMs) return;
+			rmSync(path, {
+				force: true,
+				recursive: true
+			});
+		}
+	};
+	return scratch;
+}
+//#endregion
+export { createScratch, readInventory, resolveContained };
+
+//# sourceMappingURL=index.js.map

package/dist/src/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/server/helpers.ts","../../../src/server/factories.ts"],"sourcesContent":["import type { InventoryOptions } from './types.js'\nimport { lstatSync, readdirSync, readFileSync, realpathSync } from 'node:fs'\nimport { isAbsolute, relative, resolve, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/**\n * Resolves a target that stays below a root directory.\n *\n * @param root - The absolute root directory.\n * @param target - The relative or absolute target to resolve.\n * @returns The absolute target, or `undefined` when the target escapes the root.\n */\nexport function resolveContained(root: string, target: string): string | undefined {\n\tconst candidate = resolve(root, target)\n\tconst contained = relative(root, candidate)\n\tif (contained === '..' || contained.startsWith(`..${sep}`) || isAbsolute(contained)) {\n\t\treturn undefined\n\t}\n\treturn candidate\n}\n\n/**\n * Reads files from selected directories below a root directory.\n *\n * @param root - The root directory as a path or file URL.\n * @param directories - The directories to visit below the root.\n * @param options - Optional file extension and exact-path exclusions.\n * @returns File contents keyed by sorted root-relative paths.\n * @remarks An absent extension filter includes every file. Exclusions match full root-relative keys.\n */\nexport function readInventory(\n\troot: URL | string,\n\tdirectories: readonly string[],\n\toptions?: InventoryOptions,\n): Readonly<Record<string, string>> {\n\tconst supplied = resolve(typeof root === 'string' ? root : fileURLToPath(root))\n\tconst rootStatus = lstatSync(supplied)\n\tif (rootStatus.isSymbolicLink()) throw new Error('Root is a symbolic link')\n\tif (!rootStatus.isDirectory()) throw new Error('Root is not a directory')\n\n\tconst base = realpathSync.native(supplied)\n\tif (directories.length === 0) return Object.fromEntries([])\n\n\tconst excluded = new Set(options?.exclude)\n\tconst pending: string[] = []\n\tconst queued = new Set<string>()\n\tconst contents = new Map<string, string>()\n\n\tfor (const directory of directories) {\n\t\tconst candidate = resolveContained(base, directory)\n\t\tif (candidate === undefined) {\n\t\t\tthrow new Error(`Directory outside root: ${directory}`)\n\t\t}\n\n\t\tconst status = lstatSync(candidate)\n\t\tif (status.isSymbolicLink()) throw new Error(`Directory is a symbolic link: ${directory}`)\n\t\tif (!status.isDirectory()) throw new Error(`Not a directory: ${directory}`)\n\n\t\tconst physical = realpathSync.native(candidate)\n\t\tconst resolved = resolveContained(base, relative(base, physical))\n\t\tif (resolved === undefined) {\n\t\t\tthrow new Error(`Directory outside root: ${directory}`)\n\t\t}\n\n\t\tconst key = relative(base, resolved).split(sep).join('/')\n\t\tif (excluded.has(key) || queued.has(physical)) continue\n\t\tqueued.add(physical)\n\t\tpending.push(physical)\n\t}\n\n\twhile (pending.length > 0) {\n\t\tconst directory = pending.pop()\n\t\tif (directory === undefined) continue\n\n\t\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\t\tconst path = resolve(directory, entry.name)\n\t\t\tconst status = lstatSync(path)\n\t\t\tif (status.isSymbolicLink()) continue\n\n\t\t\tconst key = relative(base, path).split(sep).join('/')\n\t\t\tif (excluded.has(key)) continue\n\n\t\t\tif (status.isDirectory()) {\n\t\t\t\tconst physical = realpathSync.native(path)\n\t\t\t\tconst resolved = resolveContained(base, relative(base, physical))\n\t\t\t\tif (resolved === undefined || queued.has(physical)) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\tqueued.add(physical)\n\t\t\t\tpending.push(physical)\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\tif (\n\t\t\t\t!status.isFile() ||\n\t\t\t\t(options?.extensions !== undefined &&\n\t\t\t\t\t!options.extensions.some((extension) => entry.name.endsWith(extension)))\n\t\t\t) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tcontents.set(key, readFileSync(path, 'utf8'))\n\t\t}\n\t}\n\n\treturn Object.fromEntries(\n\t\tArray.from(contents).sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)),\n\t)\n}\n","import type { ScratchInterface, ScratchOptions } from './types.js'\nimport {\n\tlstatSync,\n\tmkdirSync,\n\tmkdtempSync,\n\treadFileSync,\n\trmSync,\n\tstatSync,\n\twriteFileSync,\n} from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { dirname, resolve } from 'node:path'\nimport { resolveContained } from './helpers.js'\n\n/**\n * Allocates an owned temporary directory with contained file operations.\n *\n * @param options - Optional directory prefix and initial files.\n * @returns The scratch directory and its file operations.\n * @remarks The prefix defaults to `orkestrel-test-`. Seed keys use root-relative paths.\n */\nexport function createScratch(options?: ScratchOptions): ScratchInterface {\n\tconst temporary = resolve(tmpdir())\n\tconst prefix = resolve(temporary, options?.prefix ?? 'orkestrel-test-')\n\tif (dirname(prefix) !== temporary)\n\t\tthrow new Error('Scratch prefix must stay within the temporary directory')\n\n\tconst path = mkdtempSync(prefix)\n\tconst allocation = statSync(path)\n\tconst outside = 'Path outside scratch directory'\n\ttry {\n\t\tfor (const [target, text] of Object.entries(options?.files ?? {})) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tmkdirSync(dirname(candidate), { recursive: true })\n\t\t\twriteFileSync(candidate, text)\n\t\t}\n\t} catch (error) {\n\t\trmSync(path, { force: true, recursive: true })\n\t\tthrow error\n\t}\n\n\tconst scratch: ScratchInterface = {\n\t\tpath,\n\t\twrite(target, text) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tconst rootStatus = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (rootStatus === undefined) throw new Error('Scratch directory does not exist')\n\t\t\tif (rootStatus.isSymbolicLink()) throw new Error('Scratch directory is a symbolic link')\n\t\t\tif (!rootStatus.isDirectory()) throw new Error('Scratch path is not a directory')\n\n\t\t\tmkdirSync(dirname(candidate), { recursive: true })\n\t\t\twriteFileSync(candidate, text)\n\t\t},\n\t\tread(target) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\t\t\tif (!scratch.exists(target)) return undefined\n\t\t\tconst status = statSync(candidate, { throwIfNoEntry: false })\n\t\t\tif (status === undefined) return undefined\n\t\t\tif (status.isDirectory()) {\n\t\t\t\tthrow new Error(`Scratch path is a directory: ${target}`)\n\t\t\t}\n\t\t\treturn readFileSync(candidate, 'utf8')\n\t\t},\n\t\texists(target) {\n\t\t\tconst candidate = resolveContained(path, target)\n\t\t\tif (candidate === undefined) throw new Error(`${outside}: ${target}`)\n\n\t\t\tconst rootStatus = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (rootStatus === undefined) return false\n\t\t\tif (rootStatus.isSymbolicLink()) throw new Error('Scratch directory is a symbolic link')\n\t\t\tif (!rootStatus.isDirectory()) throw new Error('Scratch path is not a directory')\n\n\t\t\treturn lstatSync(candidate, { throwIfNoEntry: false }) !== undefined\n\t\t},\n\t\tdestroy() {\n\t\t\tconst status = lstatSync(path, { throwIfNoEntry: false })\n\t\t\tif (\n\t\t\t\tstatus === undefined ||\n\t\t\t\tstatus.dev !== allocation.dev ||\n\t\t\t\tstatus.ino !== allocation.ino ||\n\t\t\t\tstatus.birthtimeMs !== allocation.birthtimeMs\n\t\t\t)\n\t\t\t\treturn\n\t\t\trmSync(path, { force: true, recursive: true })\n\t\t},\n\t}\n\treturn scratch\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,iBAAiB,MAAc,QAAoC;CAClF,MAAM,YAAY,QAAQ,MAAM,MAAM;CACtC,MAAM,YAAY,SAAS,MAAM,SAAS;CAC1C,IAAI,cAAc,QAAQ,UAAU,WAAW,KAAK,KAAK,KAAK,WAAW,SAAS,GACjF;CAED,OAAO;AACR;;;;;;;;;;AAWA,SAAgB,cACf,MACA,aACA,SACmC;CACnC,MAAM,WAAW,QAAQ,OAAO,SAAS,WAAW,OAAO,cAAc,IAAI,CAAC;CAC9E,MAAM,aAAa,UAAU,QAAQ;CACrC,IAAI,WAAW,eAAe,GAAG,MAAM,IAAI,MAAM,yBAAyB;CAC1E,IAAI,CAAC,WAAW,YAAY,GAAG,MAAM,IAAI,MAAM,yBAAyB;CAExE,MAAM,OAAO,aAAa,OAAO,QAAQ;CACzC,IAAI,YAAY,WAAW,GAAG,OAAO,OAAO,YAAY,CAAC,CAAC;CAE1D,MAAM,WAAW,IAAI,IAAI,SAAS,OAAO;CACzC,MAAM,UAAoB,CAAC;CAC3B,MAAM,yBAAS,IAAI,IAAY;CAC/B,MAAM,2BAAW,IAAI,IAAoB;CAEzC,KAAK,MAAM,aAAa,aAAa;EACpC,MAAM,YAAY,iBAAiB,MAAM,SAAS;EAClD,IAAI,cAAc,KAAA,GACjB,MAAM,IAAI,MAAM,2BAA2B,WAAW;EAGvD,MAAM,SAAS,UAAU,SAAS;EAClC,IAAI,OAAO,eAAe,GAAG,MAAM,IAAI,MAAM,iCAAiC,WAAW;EACzF,IAAI,CAAC,OAAO,YAAY,GAAG,MAAM,IAAI,MAAM,oBAAoB,WAAW;EAE1E,MAAM,WAAW,aAAa,OAAO,SAAS;EAC9C,MAAM,WAAW,iBAAiB,MAAM,SAAS,MAAM,QAAQ,CAAC;EAChE,IAAI,aAAa,KAAA,GAChB,MAAM,IAAI,MAAM,2BAA2B,WAAW;EAGvD,MAAM,MAAM,SAAS,MAAM,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;EACxD,IAAI,SAAS,IAAI,GAAG,KAAK,OAAO,IAAI,QAAQ,GAAG;EAC/C,OAAO,IAAI,QAAQ;EACnB,QAAQ,KAAK,QAAQ;CACtB;CAEA,OAAO,QAAQ,SAAS,GAAG;EAC1B,MAAM,YAAY,QAAQ,IAAI;EAC9B,IAAI,cAAc,KAAA,GAAW;EAE7B,KAAK,MAAM,SAAS,YAAY,WAAW,EAAE,eAAe,KAAK,CAAC,GAAG;GACpE,MAAM,OAAO,QAAQ,WAAW,MAAM,IAAI;GAC1C,MAAM,SAAS,UAAU,IAAI;GAC7B,IAAI,OAAO,eAAe,GAAG;GAE7B,MAAM,MAAM,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG;GACpD,IAAI,SAAS,IAAI,GAAG,GAAG;GAEvB,IAAI,OAAO,YAAY,GAAG;IACzB,MAAM,WAAW,aAAa,OAAO,IAAI;IAEzC,IADiB,iBAAiB,MAAM,SAAS,MAAM,QAAQ,CAC3D,MAAa,KAAA,KAAa,OAAO,IAAI,QAAQ,GAChD;IAED,OAAO,IAAI,QAAQ;IACnB,QAAQ,KAAK,QAAQ;IACrB;GACD;GAEA,IACC,CAAC,OAAO,OAAO,KACd,SAAS,eAAe,KAAA,KACxB,CAAC,QAAQ,WAAW,MAAM,cAAc,MAAM,KAAK,SAAS,SAAS,CAAC,GAEvE;GAED,SAAS,IAAI,KAAK,aAAa,MAAM,MAAM,CAAC;EAC7C;CACD;CAEA,OAAO,OAAO,YACb,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAY,OAAO,QAAQ,KAAK,OAAO,QAAQ,IAAI,CAAE,CAC1F;AACD;;;;;;;;;;ACtFA,SAAgB,cAAc,SAA4C;CACzE,MAAM,YAAY,QAAQ,OAAO,CAAC;CAClC,MAAM,SAAS,QAAQ,WAAW,SAAS,UAAU,iBAAiB;CACtE,IAAI,QAAQ,MAAM,MAAM,WACvB,MAAM,IAAI,MAAM,yDAAyD;CAE1E,MAAM,OAAO,YAAY,MAAM;CAC/B,MAAM,aAAa,SAAS,IAAI;CAChC,MAAM,UAAU;CAChB,IAAI;EACH,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,SAAS,SAAS,CAAC,CAAC,GAAG;GAClE,MAAM,YAAY,iBAAiB,MAAM,MAAM;GAC/C,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ;GAEpE,UAAU,QAAQ,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;GACjD,cAAc,WAAW,IAAI;EAC9B;CACD,SAAS,OAAO;EACf,OAAO,MAAM;GAAE,OAAO;GAAM,WAAW;EAAK,CAAC;EAC7C,MAAM;CACP;CAEA,MAAM,UAA4B;EACjC;EACA,MAAM,QAAQ,MAAM;GACnB,MAAM,YAAY,iBAAiB,MAAM,MAAM;GAC/C,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ;GAEpE,MAAM,aAAa,UAAU,MAAM,EAAE,gBAAgB,MAAM,CAAC;GAC5D,IAAI,eAAe,KAAA,GAAW,MAAM,IAAI,MAAM,kCAAkC;GAChF,IAAI,WAAW,eAAe,GAAG,MAAM,IAAI,MAAM,sCAAsC;GACvF,IAAI,CAAC,WAAW,YAAY,GAAG,MAAM,IAAI,MAAM,iCAAiC;GAEhF,UAAU,QAAQ,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;GACjD,cAAc,WAAW,IAAI;EAC9B;EACA,KAAK,QAAQ;GACZ,MAAM,YAAY,iBAAiB,MAAM,MAAM;GAC/C,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ;GACpE,IAAI,CAAC,QAAQ,OAAO,MAAM,GAAG,OAAO,KAAA;GACpC,MAAM,SAAS,SAAS,WAAW,EAAE,gBAAgB,MAAM,CAAC;GAC5D,IAAI,WAAW,KAAA,GAAW,OAAO,KAAA;GACjC,IAAI,OAAO,YAAY,GACtB,MAAM,IAAI,MAAM,gCAAgC,QAAQ;GAEzD,OAAO,aAAa,WAAW,MAAM;EACtC;EACA,OAAO,QAAQ;GACd,MAAM,YAAY,iBAAiB,MAAM,MAAM;GAC/C,IAAI,cAAc,KAAA,GAAW,MAAM,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ;GAEpE,MAAM,aAAa,UAAU,MAAM,EAAE,gBAAgB,MAAM,CAAC;GAC5D,IAAI,eAAe,KAAA,GAAW,OAAO;GACrC,IAAI,WAAW,eAAe,GAAG,MAAM,IAAI,MAAM,sCAAsC;GACvF,IAAI,CAAC,WAAW,YAAY,GAAG,MAAM,IAAI,MAAM,iCAAiC;GAEhF,OAAO,UAAU,WAAW,EAAE,gBAAgB,MAAM,CAAC,MAAM,KAAA;EAC5D;EACA,UAAU;GACT,MAAM,SAAS,UAAU,MAAM,EAAE,gBAAgB,MAAM,CAAC;GACxD,IACC,WAAW,KAAA,KACX,OAAO,QAAQ,WAAW,OAC1B,OAAO,QAAQ,WAAW,OAC1B,OAAO,gBAAgB,WAAW,aAElC;GACD,OAAO,MAAM;IAAE,OAAO;IAAM,WAAW;GAAK,CAAC;EAC9C;CACD;CACA,OAAO;AACR"}

package/package.json

@@ -0,0 +1,88 @@
+{
+	"name": "@orkestrel/test",
+	"version": "0.0.1",
+	"description": "The test helpers the Orkestrel fleet repeats — a call recorder, a real delay, JSON and async collectors, and an owned scratch directory with a source-file walker. Zero runtime dependencies. Part of the @orkestrel line.",
+	"keywords": [],
+	"homepage": "https://github.com/orkestrel/test#readme",
+	"bugs": "https://github.com/orkestrel/test/issues",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/orkestrel/test.git"
+	},
+	"files": [
+		"dist/src",
+		"README.md"
+	],
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/src/core/index.cjs",
+	"module": "./dist/src/core/index.js",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/src/core/index.d.ts",
+				"default": "./dist/src/core/index.js"
+			},
+			"require": {
+				"types": "./dist/src/core/index.d.cts",
+				"default": "./dist/src/core/index.cjs"
+			}
+		},
+		"./server": {
+			"import": {
+				"types": "./dist/src/server/index.d.ts",
+				"default": "./dist/src/server/index.js"
+			},
+			"require": {
+				"types": "./dist/src/server/index.d.cts",
+				"default": "./dist/src/server/index.cjs"
+			}
+		},
+		"./package.json": "./package.json"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+		"copy": "node -e \"const fs=require('node:fs'),p=require('node:path'),a=process.argv[1],b=process.argv[2];fs.mkdirSync(p.dirname(b),{recursive:true});fs.cpSync(a,b,{force:true});console.log('Copied: '+a+' to '+b)\"",
+		"format": "oxfmt --config .oxfmtrc.json --write .",
+		"format:check": "oxfmt --config .oxfmtrc.json --check .",
+		"lint": "oxlint --config .oxlintrc.json --fix .",
+		"lint:check": "oxlint --config .oxlintrc.json --deny-warnings .",
+		"check": "tsc --noEmit --project tsconfig.json && npm run check:src",
+		"check:src": "npm run check:src:core && npm run check:src:server",
+		"check:src:core": "tsc --noEmit -p configs/src/tsconfig.core.json",
+		"check:src:server": "tsc --noEmit -p configs/src/tsconfig.server.json",
+		"test": "npm run test:src && npm run test:policy && npm run test:config && npm run test:guides",
+		"test:src": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:core --project src:server",
+		"test:src:core": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:core",
+		"test:src:server": "vitest run --config vite.config.ts --no-cache --reporter=dot --project src:server",
+		"test:policy": "vitest run --config vite.config.ts --no-cache --reporter=dot --project policy",
+		"test:config": "vitest run --config vite.config.ts --no-cache --reporter=dot --project config",
+		"test:guides": "vitest run --config vite.config.ts --no-cache --reporter=dot --project guides",
+		"test:probe": "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe",
+		"build": "npm run clean && npm run build:src",
+		"build:src": "npm run build:src:core && npm run build:src:server",
+		"build:src:core": "vite build --config configs/src/vite.core.config.ts && npm run copy dist/src/core/index.d.ts dist/src/core/index.d.cts",
+		"build:src:server": "vite build --config configs/src/vite.server.config.ts && npm run copy dist/src/server/index.d.ts dist/src/server/index.d.cts",
+		"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test"
+	},
+	"dependencies": {},
+	"devDependencies": {
+		"@microsoft/api-extractor": "^7.58.12",
+		"@orkestrel/guide": "^0.0.10",
+		"@orkestrel/scaffold": "^0.0.30",
+		"@types/node": "^26.2.0",
+		"oxfmt": "^0.62.0",
+		"oxlint": "^1.77.0",
+		"typescript": "^6.0.3",
+		"vite": "~8.2.0",
+		"vite-plugin-dts": "^5.0.3",
+		"vitest": "^4.1.10"
+	},
+	"engines": {
+		"node": ">=22.12.0"
+	}
+}