@orkestrel/terminal 0.0.9 → 0.0.11

package/dist/src/core/index.cjs

@@ -232,7 +232,7 @@ var DEFAULT_RECONNECT_DELAY_MS = 2e3;
 *
 * @remarks
 * - `pending` — a serialized {@link import('./types.js').PendingForm} to dispatch and answer.
-* - `expire` — an `{ id }` payload: the broker expired a parked prompt (the client drops it).
+* - `expire` — an `{ id }` payload: the broker expired or released a parked prompt (the client drops it).
 * - `shutdown` — the broker is going away; the client disconnects (no auto-reconnect) but stays reusable.
 */
 var SSE_EVENTS = Object.freeze({
@@ -562,13 +562,11 @@ function sanitizeSchema(schema) {
 					}))
 				});
 				break;
-			case "file":
-				fields.push({
-					...field,
-					...shared,
-					...field.accept !== void 0 ? { accept: field.accept.map(sanitizeDisplayText) } : {}
-				});
-				break;
+			case "file": fields.push({
+				...field,
+				...shared,
+				...field.accept !== void 0 ? { accept: field.accept.map(sanitizeDisplayText) } : {}
+			});
 		}
 	}
 	return {
@@ -1129,7 +1127,7 @@ function serializePending(form) {
 		id: form.id
 	};
 }
-/** Serialize a parked prompt's expiry into a {@link WireEvent} — event `'expire'`, `data` the JSON-stringified `{ id }` payload. */
+/** Serialize a parked prompt's expiry or release into a {@link WireEvent} — event `'expire'`, `data` the JSON-stringified `{ id }` payload. */
 function serializeExpire(id) {
 	return {
 		event: "expire",
@@ -1152,7 +1150,8 @@ function serializeShutdown() {
 * @remarks
 * A parked record carries one call to `serializeForm`. A failed fill or submit leaves the record
 * parked for another answer. A successful submit settles the form once, emits `answer`, and removes
-* the record. Timeout and teardown abandon every unsettled form through its own `destroy` method.
+* the record. Timeout, `stop`, and teardown abandon unsettled forms through their own `destroy`
+* method.
 *
 * @example
 * ```ts
@@ -1232,6 +1231,22 @@ var Prompt = class {
 			}
 		};
 	}
+	stop(ids) {
+		if (ids === void 0) {
+			for (const id of [...this.#parked.keys()]) this.#expire(id);
+			return;
+		}
+		if ((0, _orkestrel_contract.isArray)(ids)) {
+			let stopped = true;
+			for (const id of ids) {
+				const parked = this.#parked.get(id);
+				if (parked === void 0 || parked.pending.status !== "pending") stopped = false;
+			}
+			for (const id of ids) this.#expire(id);
+			return stopped;
+		}
+		return this.#expire(ids);
+	}
 	destroy() {
 		if (this.#destroyed) return;
 		this.#destroyed = true;
@@ -1301,7 +1316,7 @@ var Prompt = class {
 	}
 	#expire(id) {
 		const parked = this.#parked.get(id);
-		if (parked === void 0 || parked.pending.status !== "pending") return;
+		if (parked === void 0 || parked.pending.status !== "pending") return false;
 		parked.cancel();
 		const expired = {
 			...parked,
@@ -1314,6 +1329,7 @@ var Prompt = class {
 		parked.form.destroy();
 		this.#emitter.emit("expire", id);
 		this.#parked.delete(id);
+		return true;
 	}
 };
 //#endregion
@@ -1996,9 +2012,9 @@ var DatabaseTerminalStore = class {
 * @returns A {@link PromptInterface}
 *
 * @remarks
-* The caller awaits the parked form's own `answer`. Timeout or teardown destroys the form, so that
-* promise rejects with the Form package's `ABANDONED` error. Inject `options.timer` to drive
-* expiry without real time.
+* The caller awaits the parked form's own `answer`. Timeout, `stop`, or teardown destroys the form,
+* so that promise rejects with the Form package's `ABANDONED` error. Inject `options.timer` to
+* drive expiry without real time.
 *
 * @example
 * ```ts
@@ -2091,12 +2107,13 @@ function createMemoryTerminalStore() {
 * ```
 */
 function createDatabaseTerminalStore(driver = (0, _orkestrel_database.createMemoryDriver)()) {
+	const columns = {
+		id: (0, _orkestrel_contract.stringShape)(),
+		snapshot: (0, _orkestrel_contract.rawShape)({})
+	};
 	return new DatabaseTerminalStore((0, _orkestrel_database.createDatabase)({
 		driver,
-		tables: { terminals: {
-			id: (0, _orkestrel_contract.stringShape)(),
-			snapshot: (0, _orkestrel_contract.rawShape)({})
-		} }
+		tables: { terminals: columns }
 	}).table("terminals"));
 }
 //#endregion