@orkestrel/terminal 0.0.19 → 0.0.21

package/dist/src/core/index.cjs

@@ -5,7 +5,7 @@ let _orkestrel_emitter = require("@orkestrel/emitter");
 let _orkestrel_form = require("@orkestrel/form");
 let _orkestrel_sse = require("@orkestrel/sse");
 let _orkestrel_database = require("@orkestrel/database");
-//#region src/core/constants.ts
+// src/core/constants.ts
 /** Names the carriage return byte (`\r`, U+000D) — Enter on most terminals. */
 var RETURN = String.fromCharCode(13);
 /** Names the line feed byte (`\n`, U+000A) — Enter on some terminals / pasted input. */
@@ -260,8 +260,7 @@ var ACCEPT_EVENT_STREAM = "text/event-stream";
 * or oversized `data:` field cannot grow the buffer without bound (a memory-exhaustion guard).
 */
 var SSE_BUFFER_LIMIT = 1048576;
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Represents the error the terminal surfaces for its own refusals: parking on a destroyed or full broker, an
 * unusable driver stream, a manager routing fault, or a ctrl-c cancellation. A parked form's own
@@ -287,6 +286,7 @@ var TerminalError = class extends Error {
 	*/
 	constructor(code, message, context) {
 		super(message);
+		_orkestrel_contract.INTRINSICS.define(this, Symbol.for("@orkestrel/terminal.TerminalError"), { value: this });
 		this.name = "TerminalError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -295,6 +295,9 @@ var TerminalError = class extends Error {
 /**
 * Narrows an unknown caught value to a {@link TerminalError}, so a caller can branch on its `code`.
 *
+* @remarks
+* Recognizes branded errors across package copies, including subclasses, and refuses transparent proxies.
+*
 * @param value - The value to test (typically a `catch` binding or a rejected prompt call)
 * @returns True if `value` is a {@link TerminalError}; false otherwise
 *
@@ -310,10 +313,17 @@ var TerminalError = class extends Error {
 * ```
 */
 function isTerminalError(value) {
-	return (0, _orkestrel_contract.isInstance)(value, TerminalError);
+	return (0, _orkestrel_contract.holds)(() => {
+		if (!(0, _orkestrel_contract.isError)(value) || _orkestrel_contract.INTRINSICS.prototype(value) === Error.prototype) return false;
+		const brand = _orkestrel_contract.INTRINSICS.describe(value, Symbol.for("@orkestrel/terminal.TerminalError"));
+		if (brand === void 0 || brand.value !== value) return false;
+		const code = _orkestrel_contract.INTRINSICS.reflect.read(value, "code");
+		if (code !== "EXPIRE" && code !== "CANCEL" && code !== "DRIVER" && code !== "DEADLOCK" && code !== "TARGET" && code !== "LIMIT" && code !== "DESTROYED") return false;
+		const context = _orkestrel_contract.INTRINSICS.reflect.read(value, "context");
+		return context === void 0 || (0, _orkestrel_contract.isObject)(context) || (0, _orkestrel_contract.isFunction)(context);
+	});
 }
-//#endregion
-//#region src/core/validators.ts
+// src/core/validators.ts
 /**
 * Narrows an unknown value to a {@link PendingFormStatus}.
 *
@@ -365,8 +375,7 @@ var isTerminalSnapshot = (0, _orkestrel_contract.recordOf)({
 	id: _orkestrel_contract.isNonEmptyString,
 	timeout: _orkestrel_contract.isNumber
 }, ["timeout"]);
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Decodes one keypress's bytes into a {@link KeyEvent} — total, never throws. A `Uint8Array` is
 * read as UTF-8; the resulting string is matched against the known control bytes and the CRLF pair
@@ -558,6 +567,7 @@ function sanitizeSchema(schema) {
 			case "datetime":
 			case "color":
 			case "confirm":
+			case "list":
 				fields.push({
 					...field,
 					...shared
@@ -843,11 +853,8 @@ function reduceConfirm(state, key) {
 		view: renderConfirmView(state),
 		status: "cancel"
 	};
-	let answer;
 	const choice = key.name?.toLowerCase();
-	if (key.name === "return") answer = state.default;
-	else if (choice === "y") answer = true;
-	else if (choice === "n") answer = false;
+	const answer = key.name === "return" ? state.default : choice === "y" ? true : choice === "n" ? false : void 0;
 	if (answer === void 0) return {
 		state,
 		view: renderConfirmView(state),
@@ -1286,8 +1293,7 @@ function serializeDestroy() {
 		data: ""
 	};
 }
-//#endregion
-//#region src/core/Prompt.ts
+// src/core/Prompt.ts
 /**
 * Implements the headless form broker. It parks live forms, exposes their serialized schemas,
 * applies remote answers to the authoritative form, and abandons a parked form on timeout, release,
@@ -1383,11 +1389,10 @@ var Prompt = class {
 			return;
 		}
 		if ((0, _orkestrel_contract.isArray)(ids)) {
-			let stopped = true;
-			for (const id of ids) {
+			const stopped = Iterator.from(ids).reduce((result, id) => {
 				const parked = this.#parked.get(id);
-				if (parked === void 0 || parked.pending.status !== "pending") stopped = false;
-			}
+				return parked !== void 0 && parked.pending.status === "pending" && result;
+			}, true);
 			for (const id of ids) this.#expire(id);
 			return stopped;
 		}
@@ -1478,8 +1483,23 @@ var Prompt = class {
 		return true;
 	}
 };
-//#endregion
-//#region src/core/PromptClient.ts
+// src/core/PromptAnswers.ts
+/** Holds the answer and refusal carried between attempts of one remote prompt. */
+var PromptAnswers = class {
+	#values;
+	#errors = [];
+	get values() {
+		return this.#values;
+	}
+	get errors() {
+		return this.#errors;
+	}
+	replace(values, errors) {
+		this.#values = values;
+		this.#errors = errors;
+	}
+};
+// src/core/PromptClient.ts
 /**
 * Implements the SSE form bridge. It ingests serialized forms from a remote broker without waiting
 * on a render, drives one form at a time through a local terminal, posts each answer back, and asks
@@ -1645,11 +1665,7 @@ var PromptClient = class {
 		this.#draining = true;
 		try {
 			while (!this.#destroyed) {
-				let queued;
-				for (const entry of this.#queue) {
-					queued = entry;
-					break;
-				}
+				const queued = this.#next();
 				if (queued === void 0) return;
 				const [id, schema] = queued;
 				this.#queue.delete(id);
@@ -1672,28 +1688,29 @@ var PromptClient = class {
 		}
 	}
 	async #render(id, schema) {
-		let values;
-		let errors = [];
+		const answers = new PromptAnswers();
 		while (this.#seen.has(id) && !this.#destroyed) {
-			const form = this.#createRenderingForm(schema, values);
+			const form = this.#createRenderingForm(schema, answers.values);
 			this.#active = {
 				id,
 				form,
 				stopped: false
 			};
-			for (const error of errors) form.invalidate(error.field, sanitizeDisplayText(error.message));
+			for (const error of answers.errors) form.invalidate(error.field, sanitizeDisplayText(error.message));
 			const submitted = await this.#terminal.ask(form);
 			const active = this.#active;
 			if (active?.id !== id || active.stopped) return;
 			const rejected = await this.#post(id, submitted);
 			const posted = this.#active;
 			if (posted?.id !== id || posted.stopped || rejected === void 0) return;
-			values = submitted;
-			errors = rejected;
+			answers.replace(submitted, rejected);
 			form.destroy();
 			this.#active = void 0;
 		}
 	}
+	#next() {
+		for (const entry of this.#queue) return entry;
+	}
 	#createRenderingForm(schema, values) {
 		const fields = schema.fields.map((field) => {
 			if (field.rule?.pattern === void 0) return field;
@@ -1785,8 +1802,7 @@ var PromptClient = class {
 		};
 	}
 };
-//#endregion
-//#region src/core/TerminalManager.ts
+// src/core/TerminalManager.ts
 /**
 * Registers named {@link PromptInterface} brokers, one per endpoint, so several parties can `ask`
 * forms of each other by name with a `from` → `to` attribution edge on every parked form, and
@@ -1952,11 +1968,7 @@ var TerminalManager = class {
 			for (const name of [...this.#terminals.keys()]) this.#removeOne(name);
 			return;
 		}
-		if ((0, _orkestrel_contract.isArray)(names)) {
-			let removed = true;
-			for (const name of names) if (!this.#removeOne(name)) removed = false;
-			return removed;
-		}
+		if ((0, _orkestrel_contract.isArray)(names)) return Iterator.from(names).reduce((result, name) => this.#removeOne(name) && result, true);
 		return this.#removeOne(names);
 	}
 	destroy() {
@@ -2028,8 +2040,7 @@ var TerminalManager = class {
 		}
 	}
 };
-//#endregion
-//#region src/core/stores/MemoryTerminalStore.ts
+// src/core/stores/MemoryTerminalStore.ts
 /**
 * Implements the in-memory {@link TerminalStoreInterface} — a process-lifetime `Map` of
 * {@link TerminalSnapshot} records keyed by endpoint id, the default store
@@ -2095,8 +2106,7 @@ var MemoryTerminalStore = class {
 		return Promise.resolve();
 	}
 };
-//#endregion
-//#region src/core/stores/DatabaseTerminalStore.ts
+// src/core/stores/DatabaseTerminalStore.ts
 /**
 * Implements a {@link TerminalStoreInterface} backed by one table of the `databases` layer — an
 * endpoint's durable config state is a row, so persistence reduces to keyed point-access (`get` /
@@ -2187,8 +2197,7 @@ var DatabaseTerminalStore = class {
 		await this.#table.remove(id);
 	}
 };
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Creates the headless {@link PromptInterface} broker. It parks live forms and applies remote
 * answers to the authoritative instances.
@@ -2303,7 +2312,6 @@ function createDatabaseTerminalStore(driver = (0, _orkestrel_database.createMemo
 		tables: { terminals: columns }
 	}).table("terminals"));
 }
-//#endregion
 exports.ACCEPT_EVENT_STREAM = ACCEPT_EVENT_STREAM;
 exports.BACKSPACE = BACKSPACE;
 exports.CONTROL_NAMES = CONTROL_NAMES;