@venn-lang/contracts 0.1.0

package/dist/node.mjs

@@ -0,0 +1,387 @@
+import { mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join } from "node:path";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+import { constants } from "node:os";
+import process$1 from "node:process";
+//#region src/capabilities/host-capability.ts
+/**
+* Every capability a Host may expose. A port or plugin declares which it
+* requires, a host advertises which it provides, and negotiation compares the
+* two before anything binds.
+*/
+const ALL_CAPABILITIES = [
+	"fs",
+	"process",
+	"net",
+	"clock",
+	"random",
+	"secrets",
+	"log",
+	"io"
+];
+//#endregion
+//#region src/logger/console-logger.ts
+/** Logger backed by the global console, so it works in a Worker and in Node. */
+function createConsoleLogger() {
+	return { log(entry) {
+		const line = `[${entry.level}] ${entry.message}`;
+		if (entry.level === "error") console.error(line);
+		else console.log(line);
+	} };
+}
+//#endregion
+//#region src/ports/clock/system-clock.ts
+/** Wall-clock time, on the `Date` and `setTimeout` globals. */
+function createSystemClock() {
+	return {
+		now: () => Date.now(),
+		sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+	};
+}
+//#endregion
+//#region src/errors/venn-error.ts
+/**
+* The single error type that crosses a contracts boundary.
+*
+* Every failure carries a stable `VNxxxx` code, so conformance suites assert on
+* `.code` and never on prose. Messages stay free to improve.
+*/
+var VennError = class extends Error {
+	code;
+	detail;
+	constructor(args) {
+		super(args.message);
+		this.name = "VennError";
+		this.code = args.code;
+		this.detail = args.detail;
+	}
+};
+//#endregion
+//#region src/ports/file-system/file-system.errors.ts
+/** VN8010: a read or a remove targeted a path that does not exist. */
+function fsNotFound(args) {
+	return new VennError({
+		code: "VN8010",
+		message: `File not found: "${args.path}".`,
+		detail: { path: args.path }
+	});
+}
+//#endregion
+//#region src/ports/file-system/node-fs.ts
+/**
+* The real file system, rooted at `root`.
+*
+* @param args.root - where relative paths resolve. Defaults to ".".
+* @returns a {@link FileSystem} that reports a missing path as VN8010 and any
+* other failure as VN8019.
+*/
+function createNodeFs(args = {}) {
+	const root = args.root ?? ".";
+	const at = (path) => isAbsolute(path) ? path : join(root, path);
+	return {
+		read: (path) => readBytes(at(path)),
+		write: (path, bytes) => writeBytes(at(path), bytes),
+		exists: (path) => pathExists(at(path)),
+		remove: (path) => removePath(at(path)),
+		list: (path) => listPath(at(path))
+	};
+}
+async function listPath(directory) {
+	const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+	const found = [];
+	for (const entry of entries) found.push({
+		name: entry.name,
+		directory: await holdsMore(directory, entry)
+	});
+	return found;
+}
+/**
+* Whether an entry holds more, following a link if it is one.
+*
+* `readdir` reports a symlink as a symlink and not as what it points at, and
+* whole directory trees are built out of them: pnpm links every installed
+* package into place, so `node_modules/zod` is a link. Trusting the first
+* answer finds no packages at all in a full `node_modules`.
+*/
+async function holdsMore(directory, entry) {
+	if (entry.isDirectory()) return true;
+	if (!entry.isSymbolicLink()) return false;
+	return (await stat(join(directory, entry.name)).catch(() => void 0))?.isDirectory() ?? false;
+}
+async function readBytes(file) {
+	try {
+		return new Uint8Array(await readFile(file));
+	} catch (err) {
+		throw mapMissing(err, file);
+	}
+}
+async function writeBytes(file, bytes) {
+	await mkdir(dirname(file), { recursive: true });
+	await writeFile(file, bytes);
+}
+async function pathExists(file) {
+	try {
+		await stat(file);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function removePath(file) {
+	try {
+		await rm(file);
+	} catch (err) {
+		throw mapMissing(err, file);
+	}
+}
+function mapMissing(err, file) {
+	if (isEnoent(err)) return fsNotFound({ path: file });
+	return new VennError({
+		code: "VN8019",
+		message: err instanceof Error ? err.message : String(err)
+	});
+}
+function isEnoent(err) {
+	return typeof err === "object" && err !== null && err.code === "ENOENT";
+}
+//#endregion
+//#region src/ports/lock-provider/in-process-lock.ts
+/**
+* The real one: a chained-promise mutex per name. Waiters are served in the
+* order they asked, and the chain lives only in this process.
+*/
+function createInProcessLock() {
+	const tails = /* @__PURE__ */ new Map();
+	return { acquire: (name) => acquire(tails, name) };
+}
+async function acquire(tails, name) {
+	const previous = tails.get(name) ?? Promise.resolve();
+	let release = () => {};
+	const held = new Promise((resolve) => {
+		release = resolve;
+	});
+	tails.set(name, previous.then(() => held));
+	await previous;
+	return release;
+}
+//#endregion
+//#region src/ports/process-provider/node-spawn.ts
+/**
+* The real one, on `node:child_process`.
+*
+* Output is streamed to whoever asked and kept at the same time: a package
+* manager needs watching while it works and reading once it is done, and only
+* one of the two would leave either a command that looks hung or a result
+* nobody can inspect.
+*/
+function createNodeSpawn() {
+	return { spawn: (args) => start(args) };
+}
+function start(args) {
+	const child = spawn(args.command, [...args.args ?? []], {
+		cwd: args.cwd,
+		env: args.env ? {
+			...process.env,
+			...args.env
+		} : process.env,
+		shell: args.shell ?? false
+	});
+	const chunks = [];
+	listen(child, chunks, args.onOutput);
+	return {
+		pid: child.pid ?? 0,
+		wait: () => ended(child, chunks),
+		kill: () => void child.kill()
+	};
+}
+function listen(child, into, onOutput) {
+	for (const stream of [child.stdout, child.stderr]) stream?.on("data", (chunk) => {
+		const text = chunk.toString("utf8");
+		into.push(text);
+		onOutput?.(text);
+	});
+}
+/**
+* A command that could never start reads as one that ran and failed, with the
+* reason as its output, because that is what a caller can act on. `127` is what
+* a shell says for "no such command", and it means the same here.
+*/
+function ended(child, chunks) {
+	return new Promise((resolve) => {
+		child.on("error", (err) => resolve({
+			code: 127,
+			output: `${chunks.join("")}${err.message}`
+		}));
+		child.on("close", (code) => resolve({
+			code: code ?? 0,
+			output: chunks.join("")
+		}));
+	});
+}
+//#endregion
+//#region src/ports/random/seeded-random.ts
+/**
+* The real one: a mulberry32 PRNG, seeded once per worker. Same seed, same
+* sequence, so a run reproduces.
+*/
+function createSeededRandom(args) {
+	let state = args.seed >>> 0;
+	const next = () => {
+		state = state + 1831565813 | 0;
+		let t = Math.imul(state ^ state >>> 15, 1 | state);
+		t = t + Math.imul(t ^ t >>> 7, 61 | t) ^ t;
+		return ((t ^ t >>> 14) >>> 0) / 4294967296;
+	};
+	return {
+		next,
+		int: (min, max) => min + Math.floor(next() * (max - min + 1))
+	};
+}
+//#endregion
+//#region src/ports/secret-provider/secret.ts
+/** What every serialised secret collapses to. */
+const REDACTED = "‹redigido›";
+/**
+* Wrap a raw value so it cannot leak through `toString` or `toJSON`.
+*
+* @param args.reveal - the raw value, reachable only via `Secret.reveal()`.
+*/
+function makeSecret(args) {
+	return {
+		reveal: () => args.reveal,
+		toString: () => REDACTED,
+		toJSON: () => REDACTED
+	};
+}
+//#endregion
+//#region src/ports/secret-provider/env-secrets.ts
+/**
+* The real one: secrets from `process.env`.
+*
+* The `process` global is probed rather than imported, so this file stays
+* neutral and reports every name as absent in a Worker instead of throwing.
+*/
+function createEnvSecrets() {
+	const env = typeof process === "undefined" ? {} : process.env;
+	return {
+		get: (name) => {
+			const value = env[name];
+			return value === void 0 ? void 0 : makeSecret({ reveal: value });
+		},
+		has: (name) => env[name] !== void 0
+	};
+}
+//#endregion
+//#region src/host/create-node-host.ts
+/**
+* Host for the CLI: the real file system, secrets from the environment, and
+* every capability.
+*
+* @param args.root - where relative paths resolve. Defaults to the process's
+* current directory.
+*/
+function createNodeHost(args = {}) {
+	return {
+		fs: createNodeFs({ root: args.root }),
+		proc: createNodeSpawn(),
+		clock: createSystemClock(),
+		random: createSeededRandom({ seed: 1 }),
+		secrets: createEnvSecrets(),
+		log: createConsoleLogger(),
+		lock: createInProcessLock(),
+		caps: ALL_CAPABILITIES
+	};
+}
+//#endregion
+//#region src/ports/console/node-console.ts
+/**
+* The real console: Node's own streams.
+*
+* stdin is opened lazily, on the first `readLine`. A script that never reads
+* input must not hold the process open waiting for a line that never comes.
+*
+* @param streams - overrides for stdin, stdout, stderr and argv. Each defaults
+* to the process's own.
+*/
+function createNodeConsole(streams = {}) {
+	const lines = createLineReader(streams.stdin ?? process.stdin);
+	const out = streams.stdout ?? process.stdout;
+	const err = streams.stderr ?? process.stderr;
+	return {
+		write: (text) => void out.write(text),
+		writeError: (text) => void err.write(text),
+		readLine: () => lines.next(),
+		args: () => streams.argv ?? []
+	};
+}
+function createLineReader(input) {
+	const state = {
+		buffered: [],
+		waiting: [],
+		done: false,
+		input
+	};
+	return { next: () => next(state) };
+}
+function next(state) {
+	open(state);
+	if (state.buffered.length > 0) return Promise.resolve(state.buffered.shift() ?? null);
+	if (state.done) return Promise.resolve(null);
+	return new Promise((resolve) => state.waiting.push(resolve));
+}
+/** Attach to stdin on the first read; a TTY with no piped input ends at once. */
+function open(state) {
+	if (state.reader || state.done) return;
+	if (state.input.isTTY) {
+		state.done = true;
+		return;
+	}
+	state.reader = createInterface({
+		input: state.input,
+		crlfDelay: Number.POSITIVE_INFINITY
+	});
+	state.reader.on("line", (line) => deliver(state, line));
+	state.reader.on("close", () => finish(state));
+}
+function deliver(state, line) {
+	const resolve = state.waiting.shift();
+	if (resolve) resolve(line);
+	else state.buffered.push(line);
+}
+function finish(state) {
+	state.done = true;
+	for (const resolve of state.waiting.splice(0)) resolve(null);
+}
+//#endregion
+//#region src/ports/signal-source/node-signals.ts
+/**
+* Whether this platform knows the signal.
+*
+* Not every name exists everywhere: `SIGBREAK` is Windows only, and subscribing
+* to an unknown one throws. Asking first turns a crash at start up into a
+* subscription that never fires.
+*/
+function isKnownSignal(signal) {
+	return signal in constants.signals;
+}
+/**
+* The real one: the signals this process receives.
+*
+* Lives behind `@venn-lang/contracts/node` because it touches `node:process`, so the
+* main entry stays neutral and still runs in the editor's worker.
+*/
+function createNodeSignals() {
+	return { on: (signal, handler) => {
+		if (!isKnownSignal(signal)) return () => {};
+		const listener = () => handler(signal);
+		process$1.on(signal, listener);
+		return () => {
+			process$1.off(signal, listener);
+		};
+	} };
+}
+//#endregion
+export { createNodeConsole, createNodeFs, createNodeHost, createNodeSignals, createNodeSpawn, isKnownSignal };
+
+//# sourceMappingURL=node.mjs.map

package/dist/node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.mjs","names":[],"sources":["../src/capabilities/host-capability.ts","../src/logger/console-logger.ts","../src/ports/clock/system-clock.ts","../src/errors/venn-error.ts","../src/ports/file-system/file-system.errors.ts","../src/ports/file-system/node-fs.ts","../src/ports/lock-provider/in-process-lock.ts","../src/ports/process-provider/node-spawn.ts","../src/ports/random/seeded-random.ts","../src/ports/secret-provider/secret.ts","../src/ports/secret-provider/env-secrets.ts","../src/host/create-node-host.ts","../src/ports/console/node-console.ts","../src/ports/signal-source/node-signals.ts"],"sourcesContent":["/**\n * Every capability a Host may expose. A port or plugin declares which it\n * requires, a host advertises which it provides, and negotiation compares the\n * two before anything binds.\n */\nexport const ALL_CAPABILITIES = [\n  \"fs\",\n  \"process\",\n  \"net\",\n  \"clock\",\n  \"random\",\n  \"secrets\",\n  \"log\",\n  \"io\",\n] as const;\n\n/** One capability name, drawn from {@link ALL_CAPABILITIES}. */\nexport type HostCapability = (typeof ALL_CAPABILITIES)[number];\n","import type { Logger } from \"./logger.types.js\";\n\n/** Logger backed by the global console, so it works in a Worker and in Node. */\nexport function createConsoleLogger(): Logger {\n  return {\n    log(entry) {\n      const line = `[${entry.level}] ${entry.message}`;\n      if (entry.level === \"error\") console.error(line);\n      else console.log(line);\n    },\n  };\n}\n","import type { Clock } from \"./clock.types.js\";\n\n/** Wall-clock time, on the `Date` and `setTimeout` globals. */\nexport function createSystemClock(): Clock {\n  return {\n    now: () => Date.now(),\n    sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),\n  };\n}\n","/** Structured, serializable, redaction-safe detail attached to a {@link VennError}. */\nexport type VennErrorDetail = Readonly<Record<string, unknown>>;\n\n/**\n * The single error type that crosses a contracts boundary.\n *\n * Every failure carries a stable `VNxxxx` code, so conformance suites assert on\n * `.code` and never on prose. Messages stay free to improve.\n */\nexport class VennError extends Error {\n  readonly code: string;\n  readonly detail: VennErrorDetail | undefined;\n\n  constructor(args: { code: string; message: string; detail?: VennErrorDetail }) {\n    super(args.message);\n    this.name = \"VennError\";\n    this.code = args.code;\n    this.detail = args.detail;\n  }\n}\n","import { VennError } from \"../../errors/index.js\";\n\n/** VN8010: a read or a remove targeted a path that does not exist. */\nexport function fsNotFound(args: { path: string }): VennError {\n  return new VennError({\n    code: \"VN8010\",\n    message: `File not found: \"${args.path}\".`,\n    detail: { path: args.path },\n  });\n}\n","import { mkdir, readdir, readFile, rm, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, isAbsolute, join } from \"node:path\";\nimport { VennError } from \"../../errors/index.js\";\nimport { fsNotFound } from \"./file-system.errors.js\";\nimport type { DirEntry, FileSystem } from \"./file-system.types.js\";\n\n/**\n * The real file system, rooted at `root`.\n *\n * @param args.root - where relative paths resolve. Defaults to \".\".\n * @returns a {@link FileSystem} that reports a missing path as VN8010 and any\n * other failure as VN8019.\n */\nexport function createNodeFs(args: { root?: string } = {}): FileSystem {\n  const root = args.root ?? \".\";\n  // A root is where *relative* paths resolve. Joining it onto an absolute path\n  // corrupts the path rather than relocating it: `join(\".\", \"C:/x\")` is\n  // `.\\C:\\x`, which cannot exist, and the failure surfaces far from here.\n  const at = (path: string): string => (isAbsolute(path) ? path : join(root, path));\n  return {\n    read: (path) => readBytes(at(path)),\n    write: (path, bytes) => writeBytes(at(path), bytes),\n    exists: (path) => pathExists(at(path)),\n    remove: (path) => removePath(at(path)),\n    list: (path) => listPath(at(path)),\n  };\n}\n\nasync function listPath(directory: string): Promise<DirEntry[]> {\n  const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);\n  const found: DirEntry[] = [];\n  for (const entry of entries) {\n    found.push({ name: entry.name, directory: await holdsMore(directory, entry) });\n  }\n  return found;\n}\n\ntype Entry = { name: string; isDirectory(): boolean; isSymbolicLink(): boolean };\n\n/**\n * Whether an entry holds more, following a link if it is one.\n *\n * `readdir` reports a symlink as a symlink and not as what it points at, and\n * whole directory trees are built out of them: pnpm links every installed\n * package into place, so `node_modules/zod` is a link. Trusting the first\n * answer finds no packages at all in a full `node_modules`.\n */\nasync function holdsMore(directory: string, entry: Entry): Promise<boolean> {\n  if (entry.isDirectory()) return true;\n  if (!entry.isSymbolicLink()) return false;\n  const target = await stat(join(directory, entry.name)).catch(() => undefined);\n  return target?.isDirectory() ?? false;\n}\n\nasync function readBytes(file: string): Promise<Uint8Array> {\n  try {\n    return new Uint8Array(await readFile(file));\n  } catch (err) {\n    throw mapMissing(err, file);\n  }\n}\n\nasync function writeBytes(file: string, bytes: Uint8Array): Promise<void> {\n  await mkdir(dirname(file), { recursive: true });\n  await writeFile(file, bytes);\n}\n\nasync function pathExists(file: string): Promise<boolean> {\n  try {\n    await stat(file);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function removePath(file: string): Promise<void> {\n  try {\n    await rm(file);\n  } catch (err) {\n    throw mapMissing(err, file);\n  }\n}\n\nfunction mapMissing(err: unknown, file: string): VennError {\n  if (isEnoent(err)) return fsNotFound({ path: file });\n  const message = err instanceof Error ? err.message : String(err);\n  return new VennError({ code: \"VN8019\", message });\n}\n\nfunction isEnoent(err: unknown): boolean {\n  return typeof err === \"object\" && err !== null && (err as { code?: string }).code === \"ENOENT\";\n}\n","import type { LockProvider, Release } from \"./lock-provider.types.js\";\n\n/**\n * The real one: a chained-promise mutex per name. Waiters are served in the\n * order they asked, and the chain lives only in this process.\n */\nexport function createInProcessLock(): LockProvider {\n  const tails = new Map<string, Promise<void>>();\n  return {\n    acquire: (name) => acquire(tails, name),\n  };\n}\n\nasync function acquire(tails: Map<string, Promise<void>>, name: string): Promise<Release> {\n  const previous = tails.get(name) ?? Promise.resolve();\n  let release: Release = () => {};\n  const held = new Promise<void>((resolve) => {\n    release = resolve;\n  });\n  tails.set(\n    name,\n    previous.then(() => held),\n  );\n  await previous;\n  return release;\n}\n","import { type ChildProcess, spawn } from \"node:child_process\";\nimport type {\n  ProcessHandle,\n  ProcessProvider,\n  ProcessResult,\n  SpawnArgs,\n} from \"./process-provider.types.js\";\n\n/**\n * The real one, on `node:child_process`.\n *\n * Output is streamed to whoever asked and kept at the same time: a package\n * manager needs watching while it works and reading once it is done, and only\n * one of the two would leave either a command that looks hung or a result\n * nobody can inspect.\n */\nexport function createNodeSpawn(): ProcessProvider {\n  return { spawn: (args) => start(args) };\n}\n\nfunction start(args: SpawnArgs): ProcessHandle {\n  const child = spawn(args.command, [...(args.args ?? [])], {\n    cwd: args.cwd,\n    env: args.env ? { ...process.env, ...args.env } : process.env,\n    shell: args.shell ?? false,\n  });\n  const chunks: string[] = [];\n  listen(child, chunks, args.onOutput);\n  return { pid: child.pid ?? 0, wait: () => ended(child, chunks), kill: () => void child.kill() };\n}\n\nfunction listen(child: ChildProcess, into: string[], onOutput?: (chunk: string) => void): void {\n  for (const stream of [child.stdout, child.stderr]) {\n    stream?.on(\"data\", (chunk: Buffer) => {\n      const text = chunk.toString(\"utf8\");\n      into.push(text);\n      onOutput?.(text);\n    });\n  }\n}\n\n/**\n * A command that could never start reads as one that ran and failed, with the\n * reason as its output, because that is what a caller can act on. `127` is what\n * a shell says for \"no such command\", and it means the same here.\n */\nfunction ended(child: ChildProcess, chunks: string[]): Promise<ProcessResult> {\n  return new Promise((resolve) => {\n    child.on(\"error\", (err) => resolve({ code: 127, output: `${chunks.join(\"\")}${err.message}` }));\n    child.on(\"close\", (code) => resolve({ code: code ?? 0, output: chunks.join(\"\") }));\n  });\n}\n","import type { Random } from \"./random.types.js\";\n\n/**\n * The real one: a mulberry32 PRNG, seeded once per worker. Same seed, same\n * sequence, so a run reproduces.\n */\nexport function createSeededRandom(args: { seed: number }): Random {\n  let state = args.seed >>> 0;\n  const next = (): number => {\n    state = (state + 0x6d2b79f5) | 0;\n    let t = Math.imul(state ^ (state >>> 15), 1 | state);\n    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;\n    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;\n  };\n  return {\n    next,\n    int: (min, max) => min + Math.floor(next() * (max - min + 1)),\n  };\n}\n","import type { Secret } from \"./secret-provider.types.js\";\n\n/** What every serialised secret collapses to. */\nexport const REDACTED = \"‹redigido›\";\n\n/**\n * Wrap a raw value so it cannot leak through `toString` or `toJSON`.\n *\n * @param args.reveal - the raw value, reachable only via `Secret.reveal()`.\n */\nexport function makeSecret(args: { reveal: string }): Secret {\n  return {\n    reveal: () => args.reveal,\n    toString: () => REDACTED,\n    toJSON: () => REDACTED,\n  };\n}\n","import { makeSecret } from \"./secret.js\";\nimport type { SecretProvider } from \"./secret-provider.types.js\";\n\n/**\n * The real one: secrets from `process.env`.\n *\n * The `process` global is probed rather than imported, so this file stays\n * neutral and reports every name as absent in a Worker instead of throwing.\n */\nexport function createEnvSecrets(): SecretProvider {\n  const env: Record<string, string | undefined> = typeof process === \"undefined\" ? {} : process.env;\n  return {\n    get: (name) => {\n      const value = env[name];\n      return value === undefined ? undefined : makeSecret({ reveal: value });\n    },\n    has: (name) => env[name] !== undefined,\n  };\n}\n","import { ALL_CAPABILITIES } from \"../capabilities/index.js\";\nimport { createConsoleLogger } from \"../logger/index.js\";\nimport { createSystemClock } from \"../ports/clock/index.js\";\nimport { createNodeFs } from \"../ports/file-system/node-fs.js\";\nimport { createInProcessLock } from \"../ports/lock-provider/index.js\";\nimport { createNodeSpawn } from \"../ports/process-provider/node-spawn.js\";\nimport { createSeededRandom } from \"../ports/random/index.js\";\nimport { createEnvSecrets } from \"../ports/secret-provider/index.js\";\nimport type { Host } from \"./host.types.js\";\n\n/**\n * Host for the CLI: the real file system, secrets from the environment, and\n * every capability.\n *\n * @param args.root - where relative paths resolve. Defaults to the process's\n * current directory.\n */\nexport function createNodeHost(args: { root?: string } = {}): Host {\n  return {\n    fs: createNodeFs({ root: args.root }),\n    proc: createNodeSpawn(),\n    clock: createSystemClock(),\n    random: createSeededRandom({ seed: 1 }),\n    secrets: createEnvSecrets(),\n    log: createConsoleLogger(),\n    lock: createInProcessLock(),\n    caps: ALL_CAPABILITIES,\n  };\n}\n","import { createInterface, type Interface } from \"node:readline\";\nimport type { Console } from \"./console.types.js\";\n\n/**\n * Where a node console reads and writes. Injectable, so a test can drive the\n * real implementation and read back what a script printed.\n */\nexport interface ConsoleStreams {\n  argv?: readonly string[];\n  stdout?: { write(text: string): unknown };\n  stderr?: { write(text: string): unknown };\n  /** Where lines are read from. Defaults to the process's own standard input. */\n  stdin?: NodeJS.ReadableStream & { isTTY?: boolean };\n}\n\n/**\n * The real console: Node's own streams.\n *\n * stdin is opened lazily, on the first `readLine`. A script that never reads\n * input must not hold the process open waiting for a line that never comes.\n *\n * @param streams - overrides for stdin, stdout, stderr and argv. Each defaults\n * to the process's own.\n */\nexport function createNodeConsole(streams: ConsoleStreams = {}): Console {\n  const lines = createLineReader(streams.stdin ?? process.stdin);\n  const out = streams.stdout ?? process.stdout;\n  const err = streams.stderr ?? process.stderr;\n  return {\n    write: (text) => void out.write(text),\n    writeError: (text) => void err.write(text),\n    readLine: () => lines.next(),\n    args: () => streams.argv ?? [],\n  };\n}\n\ninterface LineReaderState {\n  buffered: string[];\n  waiting: ((line: string | null) => void)[];\n  done: boolean;\n  input: NodeJS.ReadableStream & { isTTY?: boolean };\n  reader?: Interface;\n}\n\nfunction createLineReader(input: NodeJS.ReadableStream & { isTTY?: boolean }): {\n  next(): Promise<string | null>;\n} {\n  const state: LineReaderState = { buffered: [], waiting: [], done: false, input };\n  return { next: () => next(state) };\n}\n\nfunction next(state: LineReaderState): Promise<string | null> {\n  open(state);\n  if (state.buffered.length > 0) return Promise.resolve(state.buffered.shift() ?? null);\n  if (state.done) return Promise.resolve(null);\n  return new Promise((resolve) => state.waiting.push(resolve));\n}\n\n/** Attach to stdin on the first read; a TTY with no piped input ends at once. */\nfunction open(state: LineReaderState): void {\n  if (state.reader || state.done) return;\n  if (state.input.isTTY) {\n    state.done = true;\n    return;\n  }\n  state.reader = createInterface({ input: state.input, crlfDelay: Number.POSITIVE_INFINITY });\n  state.reader.on(\"line\", (line) => deliver(state, line));\n  state.reader.on(\"close\", () => finish(state));\n}\n\nfunction deliver(state: LineReaderState, line: string): void {\n  const resolve = state.waiting.shift();\n  if (resolve) resolve(line);\n  else state.buffered.push(line);\n}\n\nfunction finish(state: LineReaderState): void {\n  state.done = true;\n  for (const resolve of state.waiting.splice(0)) resolve(null);\n}\n","import { constants } from \"node:os\";\nimport process from \"node:process\";\nimport type { SignalSource, SystemSignal, Unsubscribe } from \"./signal-source.types.js\";\n\n/**\n * Whether this platform knows the signal.\n *\n * Not every name exists everywhere: `SIGBREAK` is Windows only, and subscribing\n * to an unknown one throws. Asking first turns a crash at start up into a\n * subscription that never fires.\n */\nexport function isKnownSignal(signal: SystemSignal): boolean {\n  return signal in constants.signals;\n}\n\n/**\n * The real one: the signals this process receives.\n *\n * Lives behind `@venn-lang/contracts/node` because it touches `node:process`, so the\n * main entry stays neutral and still runs in the editor's worker.\n */\nexport function createNodeSignals(): SignalSource {\n  return {\n    on: (signal, handler): Unsubscribe => {\n      if (!isKnownSignal(signal)) return () => {};\n      const listener = () => handler(signal);\n      process.on(signal, listener);\n      return () => {\n        process.off(signal, listener);\n      };\n    },\n  };\n}\n"],"mappings":"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"}