build-start-rebuild-perf 0.1.0 → 0.2.0

package/.release-plan.json

@@ -2,8 +2,8 @@
   "solution": {
     "build-start-rebuild-perf": {
       "impact": "minor",
-      "oldVersion": "0.0.1",
-      "newVersion": "0.1.0",
+      "oldVersion": "0.1.0",
+      "newVersion": "0.2.0",
       "tagName": "latest",
       "constraints": [
         {
@@ -14,5 +14,5 @@
       "pkgJSONPath": "./package.json"
     }
   },
-  "description": "## Release (2025-08-08)\n\n* build-start-rebuild-perf 0.1.0 (minor)\n\n#### :rocket: Enhancement\n* `build-start-rebuild-perf`\n  * [#21](https://github.com/mainmatter/build-start-rebuild-perf/pull/21) Show stack on error. ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### Committers: 1\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
+  "description": "## Release (2025-08-09)\n\n* build-start-rebuild-perf 0.2.0 (minor)\n\n#### :rocket: Enhancement\n* `build-start-rebuild-perf`\n  * [#23](https://github.com/mainmatter/build-start-rebuild-perf/pull/23) Configurable timeout ([@NullVoxPopuli](https://github.com/NullVoxPopuli))\n\n#### Committers: 1\n- [@NullVoxPopuli](https://github.com/NullVoxPopuli)\n"
 }

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## Release (2025-08-09)
+
+* build-start-rebuild-perf 0.2.0 (minor)
+
+#### :rocket: Enhancement
+* `build-start-rebuild-perf`
+  * [#23](https://github.com/mainmatter/build-start-rebuild-perf/pull/23) Configurable timeout ([@NullVoxPopuli](https://github.com/NullVoxPopuli))
+
+#### Committers: 1
+- [@NullVoxPopuli](https://github.com/NullVoxPopuli)
+
 ## Release (2025-08-08)
 
 * build-start-rebuild-perf 0.1.0 (minor)

package/lib/program.js

@@ -9,6 +9,11 @@ program
   .option("-f, --file <path>", "File to touch to trigger a reload")
   .option("-c, --command <cmd>", "Command to start dev server", "pnpm start")
   .option("-w, --wait-for <selector>", "Element selector to wait for", "body")
+  .option(
+    "-t, --timeout <timeout ms>",
+    "number of ms to wait for the server to become ready",
+    "120000",
+  )
   .addOption(
     new Option("-l, --log-level <level>", "Set the log level", "warn").choices([
       "log",

package/lib/server.js

@@ -1,7 +1,7 @@
 import { execa } from "execa";
 import stripAnsi from "strip-ansi";
 import { log, warn } from "./log.js";
-import { PrefixedTransform } from "./utils.js";
+import { PrefixedTransform, parseNumber } from "./utils.js";
 
 let server = null;
 
@@ -30,11 +30,13 @@ export async function startServer(options, extraArgs = "") {
 
   log("Waiting for server to start...");
 
+  let timeout = parseNumber(options.timeout);
+
   // Wait for server to be ready by watching output
   await new Promise((resolve, reject) => {
     const timeoutId = setTimeout(() => {
-      reject(new Error("Server start timeout"));
-    }, 120_000);
+      reject(new Error(`Server start timeout ( waited ${timeout}ms )`));
+    }, timeout);
 
     const urlToMatch = `//${new URL(options.url).host}`;
     const checkOutput = (line) => {

package/lib/utils.js

@@ -43,3 +43,15 @@ const formatter = Intl.NumberFormat("en-US", {
 export function formatMs(timeMs) {
   return formatter.format(Math.round(timeMs));
 }
+
+export function parseNumber(maybeNum) {
+  if (!maybeNum) return fallback;
+
+  let result = parseInt(maybeNum, 10);
+
+  if (Number.isNaN(result)) {
+    throw new Error(`Expected ${maybeNum} to be parsable to an integer. Instead received NaN.`);
+  }
+
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "build-start-rebuild-perf",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "",
   "keywords": [],
   "repository": {