@devframes/hub-ui-onboard 1.3.2 → 1.3.3

package/dist/index.d.mts

@@ -53,6 +53,12 @@ interface CreateOnboardingOptions {
   stateDir?: string;
   /** Install as a devDependency. Default: `true`. */
   dev?: boolean;
+  /**
+   * Stop the install when it runs longer than this many milliseconds, and
+   * show an error that asks the user to run the command in a terminal.
+   * Default: `300_000` (5 minutes).
+   */
+  installTimeout?: number;
   branding?: OnboardingBranding;
   messages?: Partial<OnboardingMessages>;
   /**

package/dist/index.mjs

@@ -54,6 +54,10 @@ const diagnostics = defineDiagnostics({
 		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()`."
+		},
+		DF9009: {
+			why: (p) => `\`${p.command}\` did not finish within ${p.seconds} seconds, so it was stopped.`,
+			fix: "Run the command in a terminal to see where the package manager stops, then click Install again. If the install is only slow, raise `installTimeout`."
 		}
 	}
 });
@@ -66,18 +70,35 @@ async function resolveInstallCommand(plan) {
 }
 /**
 * Run the install and make sure that each named package landed in
-* `<cwd>/node_modules`. Throws a `DF9001` / `DF9002` diagnostic on failure.
+* `<cwd>/node_modules`. Throws a `DF9001` / `DF9002` / `DF9009` diagnostic on failure.
 */
 async function runInstall(plan, command) {
-	const result = await exec(command.command, command.args, { nodeOptions: {
+	const commandLine = [command.command, ...command.args].join(" ");
+	const child = exec(command.command, command.args, { nodeOptions: {
 		cwd: plan.cwd,
 		env: {
 			...process.env,
 			CI: "1"
 		}
 	} });
+	let timer;
+	let killed;
+	const timedOut = new Promise((resolve) => {
+		timer = setTimeout(() => {
+			killed = killTree(child);
+			killed.then(() => resolve(void 0));
+		}, plan.timeout);
+	});
+	const result = await Promise.race([child, timedOut]).finally(() => clearTimeout(timer));
+	if (killed || !result) {
+		await killed;
+		throw diagnostics.DF9009({
+			command: commandLine,
+			seconds: Math.round(plan.timeout / 1e3)
+		});
+	}
 	if (result.exitCode !== 0) throw diagnostics.DF9001({
-		command: [command.command, ...command.args].join(" "),
+		command: commandLine,
 		exitCode: result.exitCode,
 		stderr: result.stderr.trim().slice(-2048)
 	});
@@ -87,6 +108,23 @@ async function runInstall(plan, command) {
 	});
 }
 /**
+* Kill the install with everything it started. On Windows, tinyexec runs a
+* package manager's `.cmd` shim through `cmd.exe`, and a kill does not reach
+* child processes, so `taskkill /T /F` ends the whole tree.
+*/
+async function killTree(child) {
+	const pid = child.process?.pid;
+	if (process.platform === "win32" && pid !== void 0) {
+		if ((await exec("taskkill", [
+			"/pid",
+			String(pid),
+			"/T",
+			"/F"
+		]).then((r) => r, () => void 0))?.exitCode === 0) return;
+	}
+	child.kill();
+}
+/**
 * `true` when every named package is already in `<cwd>/node_modules`, so the
 * onboarding has nothing to install. Path, URL and alias specs cannot be
 * checked by name, so a plan made only of those is never "already installed".
@@ -149,6 +187,7 @@ function confirmInTerminal(command, input = process.stdin) {
 }
 // src/index.ts
 const STATE_FILE = "hub-ui-onboard.json";
+const DEFAULT_INSTALL_TIMEOUT = 3e5;
 /** `devframes` → `/devframes/`, same rule as `normalizeHubBase` in `@devframes/hub`. */
 function normalizeBase(base) {
 	return `/${base}/`.replace(/\/{2,}/g, "/");
@@ -242,7 +281,8 @@ function createOnboarding(options) {
 	const plan = {
 		cwd,
 		packages: options.packages,
-		dev: options.dev ?? true
+		dev: options.dev ?? true,
+		timeout: options.installTimeout ?? DEFAULT_INSTALL_TIMEOUT
 	};
 	const branding = options.branding ?? {};
 	const messages = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub-ui-onboard",
   "type": "module",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "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",
@@ -34,11 +34,11 @@
   },
   "devDependencies": {
     "@types/node": "^26.6.6",
-    "tsdown": "^0.23.4",
+    "tsdown": "^0.23.7",
     "tsx": "^4.23.15",
     "unocss": "^66.12.0",
-    "vite": "^8.3.5",
-    "vitest": "^5.0.5"
+    "vite": "^8.3.6",
+    "vitest": "^5.1.0"
   },
   "scripts": {
     "build": "pnpm run build:css && tsdown && vite build --config vite.client.config.ts",