@devframes/hub-ui-onboard 1.2.5 → 1.3.0

package/dist/index.d.mts

@@ -67,8 +67,9 @@ interface CreateOnboardingOptions {
    * Ask the developer to allow an install that the panel requested; the
    * dev server can be reachable from other devices. Return `true` to run
    * it. Only one call is open at a time: clicks meanwhile share its answer.
-   * Default: a `y/N` question in the terminal, or a refusal when stdin is
-   * not a TTY.
+   * Default: a `y/N` question in the terminal. It refuses at once when stdin
+   * is not a TTY or another reader holds it in raw mode, and after 5 minutes
+   * without an answer.
    */
   onConfirm?: (confirmation: OnboardingConfirmation) => boolean | Promise<boolean>;
 }

package/dist/index.mjs

@@ -40,12 +40,20 @@ const diagnostics = defineDiagnostics({
 			fix: "Make sure that `stateDir` is writable, or point it at another directory."
 		},
 		DF9005: {
-			why: (p) => `A browser asked to run \`${p.command}\`. Type y and press Enter to allow it.`,
+			why: (p) => `A browser asked to run \`${p.command}\`. Type y and press Enter within ${p.minutes} minutes to allow it.`,
 			fix: "If you did not click Install, press Enter to refuse. Another device can reach this dev server, so bind it to localhost."
 		},
 		DF9006: {
 			why: (p) => `A browser asked to run \`${p.command}\`, but no interactive terminal can confirm it. The install was refused.`,
 			fix: "Run the command yourself, or pass an `onConfirm` function to `createOnboarding()`."
+		},
+		DF9007: {
+			why: (p) => `A browser asked to run \`${p.command}\`, but another program reads this terminal key by key, so it cannot show the question. The install was refused.`,
+			fix: "Run the command yourself. If a CLI owns the terminal, pass an `onConfirm` function to `createOnboarding()` that asks through that CLI."
+		},
+		DF9008: {
+			why: (p) => `Nobody allowed \`${p.command}\` within ${p.minutes} minutes. The install was refused.`,
+			fix: "Click Install again and answer in the terminal that runs the dev server. If the answer does not arrive, another program reads that terminal: pass an `onConfirm` function to `createOnboarding()`."
 		}
 	}
 });
@@ -103,22 +111,42 @@ function packageName(spec) {
 }
 //#endregion
 //#region src/terminal-confirm.ts
+const ANSWER_MINUTES = 5;
 /**
 * The default `onConfirm`: a `y/N` question in the terminal that runs the dev
-* server. Without an interactive terminal nobody can answer, so it refuses.
+* server. When nobody can answer it, it refuses.
 */
 function confirmInTerminal(command, input = process.stdin) {
+	const line = command.join(" ");
 	if (!input.isTTY) {
-		diagnostics.DF9006({ command: command.join(" ") });
+		diagnostics.DF9006({ command: line });
+		return Promise.resolve(false);
+	}
+	if (input.isRaw) {
+		diagnostics.DF9007({ command: line });
 		return Promise.resolve(false);
 	}
-	diagnostics.DF9005({ command: command.join(" ") });
+	diagnostics.DF9005({
+		command: line,
+		minutes: ANSWER_MINUTES
+	});
 	const flowing = input.readableFlowing;
 	return new Promise((resolve) => {
-		input.once("data", (chunk) => {
+		const timer = setTimeout(() => {
+			diagnostics.DF9008({
+				command: line,
+				minutes: ANSWER_MINUTES
+			});
+			settle(false);
+		}, ANSWER_MINUTES * 6e4);
+		const onData = (chunk) => settle(/^y(?:es)?$/i.test(String(chunk).trim()));
+		function settle(allowed) {
+			clearTimeout(timer);
+			input.off("data", onData);
 			if (!flowing) input.pause();
-			resolve(/^y(?:es)?$/i.test(String(chunk).trim()));
-		});
+			resolve(allowed);
+		}
+		input.on("data", onData);
 	});
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub-ui-onboard",
   "type": "module",
-  "version": "1.2.5",
+  "version": "1.3.0",
   "description": "A tiny stand-in for the devframe hub UI: a floating button that installs it on demand.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,12 +33,12 @@
     "tinyexec": "^1.3.1"
   },
   "devDependencies": {
-    "@types/node": "^26.6.4",
-    "tsdown": "^0.23.0",
+    "@types/node": "^26.6.5",
+    "tsdown": "0.23.0",
     "tsx": "^4.23.15",
-    "unocss": "^66.10.5",
-    "vite": "^8.3.3",
-    "vitest": "^5.0.3"
+    "unocss": "^66.11.0",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.5"
   },
   "scripts": {
     "build": "pnpm run build:css && tsdown && vite build --config vite.client.config.ts",