@crvy/rprtr 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.3] - 2026-07-03
+
+### Fixed
+
+- **server:** Persist report on interrupted runs and mid-run mutations
 ## [0.2.2] - 2026-07-03
 
 ### Miscellaneous

package/dist/{chunk-RFZGJSL3.js → chunk-473CWZ4V.js}

@@ -350,6 +350,7 @@ function handleArtifactRoute(ctx, req, pathname) {
 function handleTestBegin(ctx, data) {
   const test = applyTestBeginEvent(ctx, data);
   ctx.reportData.isRunning = true;
+  ctx.scheduleReportSave();
   console.log(`  \u25B6 [${test.browser ?? "?"}] ${test.title}`);
   const message = { type: "test-begin", data: test };
   broadcastToBrowsers(ctx.wsClients, message);
@@ -388,6 +389,7 @@ function handleTestEnd(ctx, data) {
   const errNote = data.error !== null && data.error !== void 0 ? `
     Error: ${data.error}` : "";
   console.log(`  ${icon} [${test.browser}] ${test.title}${dur}${diffNote}${errNote}`);
+  ctx.scheduleReportSave();
   const message = { type: "test-update", data: test };
   broadcastToBrowsers(ctx.wsClients, message);
 }
@@ -475,6 +477,61 @@ async function resolvePlaywrightConfig(cwd) {
   return matches.find((path) => path !== null) ?? null;
 }
 
+// src/server/report-persistence.ts
+function createDebouncedSaver(save, delayMs, setTimeoutFn = (fn, ms) => setTimeout(fn, ms), clearTimeoutFn = (handle) => {
+  if (handle !== null) clearTimeout(handle);
+}) {
+  let timer = null;
+  let dirty = false;
+  let inFlight = null;
+  const runSave = () => {
+    dirty = false;
+    inFlight = save();
+    return inFlight.finally(() => {
+      inFlight = null;
+    });
+  };
+  return {
+    schedule() {
+      dirty = true;
+      if (timer !== null) clearTimeoutFn(timer);
+      timer = setTimeoutFn(() => {
+        timer = null;
+        void runSave();
+      }, delayMs);
+    },
+    async flush() {
+      if (timer !== null) {
+        clearTimeoutFn(timer);
+        timer = null;
+      }
+      if (inFlight !== null) {
+        await inFlight;
+      }
+      if (dirty) {
+        await runSave();
+      }
+    },
+    cancel() {
+      if (timer !== null) {
+        clearTimeoutFn(timer);
+        timer = null;
+      }
+      dirty = false;
+    }
+  };
+}
+function createReportPersistence(reportFile, reportData) {
+  const reportSaver = createDebouncedSaver(() => writeJsonFile(reportFile, reportData), 250);
+  return {
+    saveReport: () => reportSaver.flush(),
+    scheduleReportSave: () => {
+      reportSaver.schedule();
+    },
+    dispose: () => reportSaver.flush()
+  };
+}
+
 // src/server/routes-context.ts
 function createRoutesContext(reportData, staticDir, saveReport, options) {
   const artifactRoots = [reportData.screenshotDir, options.outputDir, options.playwrightSnapshotDir].filter(
@@ -905,15 +962,14 @@ var RunController = class {
     }
     this.deps.setReportRunning(false);
     this.deps.broadcast({ type: "run-status", data: { running: false } });
+    void this.deps.saveReport?.();
   }
 };
 function createRealSpawn() {
   return (cmd, args, opts) => {
     const cp = spawn(cmd, args, opts);
     return {
-      on: (event, cb) => {
-        cp.on(event, cb);
-      },
+      on: (event, cb) => cp.on(event, cb),
       kill: (signal) => {
         const sig = KNOWN_SIGNALS[signal];
         if (sig !== void 0) cp.kill(sig);
@@ -1060,7 +1116,7 @@ async function seedRunContext(routesContext, options) {
     routesContext.runContext = { configFile, cwd: process.cwd() };
   }
 }
-function createServerRunController(routesContext, wsClients, reportData, port, setRunFiltered) {
+function createServerRunController(routesContext, wsClients, reportData, port, setRunFiltered, saveReport) {
   return new RunController({
     getRunContext: () => routesContext.runContext ?? null,
     port,
@@ -1071,6 +1127,7 @@ function createServerRunController(routesContext, wsClients, reportData, port, s
       reportData.isRunning = running;
     },
     setRunFiltered,
+    saveReport,
     spawn: createRealSpawn(),
     timers: createRealTimers()
   });
@@ -1083,19 +1140,27 @@ async function createServerApp(options = {}) {
   const staticDir = await resolveStaticDir(options.staticDir);
   const wsClients = /* @__PURE__ */ new Set();
   const currentRunIds = /* @__PURE__ */ new Set();
-  const saveReport = () => writeJsonFile(reportFile, reportData);
-  const routesContext = createRoutesContext(reportData, staticDir, saveReport, options);
+  const persistence = createReportPersistence(reportFile, reportData);
+  const routesContext = createRoutesContext(reportData, staticDir, persistence.saveReport, options);
   await seedRunContext(routesContext, options);
   let isFilteredRun = false;
-  const runController = createServerRunController(routesContext, wsClients, reportData, port, (filtered) => {
-    isFilteredRun = filtered;
-  });
+  const runController = createServerRunController(
+    routesContext,
+    wsClients,
+    reportData,
+    port,
+    (filtered) => {
+      isFilteredRun = filtered;
+    },
+    persistence.saveReport
+  );
   const getHandlerContext = () => ({
     reportData,
     wsClients,
     currentRunIds,
     isFilteredRun,
-    saveReport,
+    saveReport: persistence.saveReport,
+    scheduleReportSave: persistence.scheduleReportSave,
     approvalRouting: routesContext.approvalRouting,
     routesContext,
     runController
@@ -1107,13 +1172,17 @@ async function createServerApp(options = {}) {
   return {
     port,
     wsClients,
-    close: () => {
-      runController.dispose();
-    },
+    close: createCloseHandler(persistence, runController),
     handleRequest,
     handleWebSocketMessage
   };
 }
+function createCloseHandler(persistence, runController) {
+  return async () => {
+    await persistence.dispose();
+    runController.dispose();
+  };
+}
 
 // src/server/bun-adapter.ts
 function logWebSocketError(prefix, error) {
@@ -1311,9 +1380,37 @@ async function startNodeServer(app) {
   console.log(`Crvy Rprtr started at http://localhost:${app.port}`);
 }
 
+// src/server/shutdown.ts
+var EXIT_CODES = {
+  SIGINT: 130,
+  SIGTERM: 143,
+  SIGHUP: 129
+};
+function createSignalShutdown(deps) {
+  let shuttingDown = false;
+  return async function shutdown(signal) {
+    if (shuttingDown) {
+      deps.exit(EXIT_CODES[signal] ?? 1);
+      return;
+    }
+    shuttingDown = true;
+    try {
+      await deps.close();
+    } catch {
+    }
+    deps.exit(EXIT_CODES[signal] ?? 1);
+  };
+}
+
 // src/server.ts
 async function startServer(options = {}) {
   const app = await createServerApp(options);
+  const shutdown = createSignalShutdown({ close: () => app.close(), exit: (code) => process.exit(code) });
+  const onSignal = (signal) => {
+    void shutdown(signal);
+  };
+  process.on("SIGINT", onSignal);
+  process.on("SIGTERM", onSignal);
   if (typeof Bun !== "undefined" && typeof Bun.serve === "function") {
     startBunServer(app);
     return;

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startServer
-} from "./chunk-RFZGJSL3.js";
+} from "./chunk-473CWZ4V.js";
 import "./chunk-HAFWYUNO.js";
 
 // src/cli.ts

package/dist/index.js

@@ -20092,10 +20092,10 @@ function recalcSuiteStatuses(root10, testPath) {
   for (const parentPath of ancestorPaths) {
     const parentSuite = getSuiteByPath(root10, parentPath);
     if (parentSuite && !isTest(parentSuite)) {
-      parentSuite.status = getChildrenArray(parentSuite.children).map(({ status }) => status).reduce(calcStatus);
+      parentSuite.status = getChildrenArray(parentSuite.children).map(({ status }) => status).reduce(calcStatus, void 0);
     }
   }
-  root10.status = getChildrenArray(root10.children).map(({ status }) => status).reduce(calcStatus);
+  root10.status = getChildrenArray(root10.children).map(({ status }) => status).reduce(calcStatus, void 0);
 }
 function recalcAllSuiteStatuses(suite) {
   for (const child2 of getChildrenArray(suite.children)) {
@@ -20103,7 +20103,7 @@ function recalcAllSuiteStatuses(suite) {
       recalcAllSuiteStatuses(child2);
     }
   }
-  suite.status = getChildrenArray(suite.children).map(({ status }) => status).reduce(calcStatus);
+  suite.status = getChildrenArray(suite.children).map(({ status }) => status).reduce(calcStatus, void 0);
 }
 function markTestsPending(node) {
   if (isTest(node)) {

package/dist/server/app.d.ts

@@ -26,7 +26,8 @@ export interface ServerOptions {
 export interface ServerApp {
     port: number;
     wsClients: Set<RuntimeWebSocket>;
-    close: () => void;
+    /** Flushes pending report writes and disposes the run controller. */
+    close: () => Promise<void>;
     handleRequest: (req: Request) => Promise<Response>;
     handleWebSocketMessage: (message: string) => Promise<void>;
 }

package/dist/server/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,8BAA8B,CAAC,EAAE,MAAM,CAAA;IACvC,sCAAsC,CAAC,EAAE,MAAM,CAAA;CAChD;AAUD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClD,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAqKD,wBAAsB,eAAe,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CA8CrF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,8BAA8B,CAAC,EAAE,MAAM,CAAA;IACvC,sCAAsC,CAAC,EAAE,MAAM,CAAA;CAChD;AAUD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChC,qEAAqE;IACrE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAClD,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAuKD,wBAAsB,eAAe,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAgDrF"}

package/dist/server/handlers.d.ts

@@ -16,6 +16,9 @@ export interface HandlerContext {
     currentRunIds: Set<string>;
     isFilteredRun: boolean;
     saveReport: () => Promise<void>;
+    /** Debounced persistence; used after in-memory mutations so a crash or
+     * interrupted run (no `run-end`) still leaves the latest state on disk. */
+    scheduleReportSave: () => void;
     approvalRouting?: ApprovalRouting;
     routesContext: RoutesContext;
     runController: RunController;

package/dist/server/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,KAAK,EAA0B,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QACV,SAAS,EAAE,OAAO,CAAA;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,YAAY,EAAE,OAAO,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,SAAS,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAG1B,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAM9E;AAwBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAiB1E;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE;IAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAWpD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAyC5E"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/server/handlers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,KAAK,EAA0B,QAAQ,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE;QACV,SAAS,EAAE,OAAO,CAAA;QAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC/B,QAAQ,EAAE,MAAM,EAAE,CAAA;QAClB,YAAY,EAAE,OAAO,CAAA;QACrB,aAAa,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,SAAS,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAG1B,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B;+EAC2E;IAC3E,kBAAkB,EAAE,MAAM,IAAI,CAAA;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAO9E;AAwBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAkB1E;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE;IAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAWpD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAyC5E"}

package/dist/server/report-persistence.d.ts

@@ -0,0 +1,27 @@
+type TimerHandle = ReturnType<typeof setTimeout>;
+type SetTimer = (fn: () => void, ms?: number) => TimerHandle;
+type ClearTimer = (handle: TimerHandle | null) => void;
+export interface DebouncedSaver {
+    /** Schedules a save after the debounce window. Re-arms on each call. */
+    schedule(): void;
+    /** Cancels any pending timer; awaits an in-flight save; saves immediately if dirty. */
+    flush(): Promise<void>;
+    /** Cancels any pending timer and clears the dirty flag without saving. */
+    cancel(): void;
+}
+export interface ReportPersistence {
+    /** Flushes immediately; used by run-end, approvals, child exit, and signals. */
+    saveReport: () => Promise<void>;
+    /** Debounced; used after frequent in-memory mutations (test-begin/test-end). */
+    scheduleReportSave: () => void;
+    /** Flushes any pending debounced write; used during teardown. */
+    dispose: () => Promise<void>;
+}
+export declare function createDebouncedSaver(save: () => Promise<void>, delayMs: number, setTimeoutFn?: SetTimer, clearTimeoutFn?: ClearTimer): DebouncedSaver;
+/** Builds the debounced report-persistence facade shared by handlers, the run
+ * controller, and shutdown. `scheduleReportSave` coalesces frequent mutations;
+ * `saveReport` flushes immediately so an interrupted run (Ctrl+C before run-end,
+ * killed child, server restart) still lands its results on disk. */
+export declare function createReportPersistence<T>(reportFile: string, reportData: T): ReportPersistence;
+export {};
+//# sourceMappingURL=report-persistence.d.ts.map

package/dist/server/report-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-persistence.d.ts","sourceRoot":"","sources":["../../src/server/report-persistence.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;AAChD,KAAK,QAAQ,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,EAAE,MAAM,KAAK,WAAW,CAAA;AAC5D,KAAK,UAAU,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,IAAI,IAAI,CAAA;IAChB,uFAAuF;IACvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,0EAA0E;IAC1E,MAAM,IAAI,IAAI,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,gFAAgF;IAChF,kBAAkB,EAAE,MAAM,IAAI,CAAA;IAC9B,iEAAiE;IACjE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzB,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,QAAyC,EACvD,cAAc,GAAE,UAEf,GACA,cAAc,CA0ChB;AAED;;;oEAGoE;AACpE,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,iBAAiB,CAS/F"}

package/dist/server/run-controller.d.ts

@@ -34,6 +34,8 @@ export interface RunControllerDeps {
     setReportRunning(running: boolean): void;
     /** Records whether the in-progress run is filtered, so run-end can preserve unrelated tests. */
     setRunFiltered?(filtered: boolean): void;
+    /** Flushes pending report writes on child exit so an interrupted run still persists. */
+    saveReport?: () => Promise<void>;
     spawn: SpawnLike;
     timers: {
         setTimeout: (fn: () => void, ms?: number) => unknown;

package/dist/server/run-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-controller.d.ts","sourceRoot":"","sources":["../../src/server/run-controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-controller.d.ts","sourceRoot":"","sources":["../../src/server/run-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/shutdown.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Graceful shutdown handler for process signals (SIGINT/SIGTERM).
+ *
+ * On the first signal: flushes the report (via `close`) so the latest in-memory
+ * state lands on disk, then exits. This is the key path that prevents data loss
+ * when the user Ctrl+Cs the reporter server while a run is in progress or a
+ * debounced save is pending.
+ *
+ * On a second signal: exits immediately so a stuck flush can always be
+ * force-killed by the user.
+ */
+export interface ShutdownDeps {
+    close: () => Promise<void>;
+    exit: (code?: number) => void;
+}
+export declare function createSignalShutdown(deps: ShutdownDeps): (signal: NodeJS.Signals) => Promise<void>;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/server/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAQD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAgBlG"}

package/dist/server.cjs

@@ -954,6 +954,7 @@ function handleArtifactRoute(ctx, req, pathname) {
 function handleTestBegin(ctx, data) {
   const test = applyTestBeginEvent(ctx, data);
   ctx.reportData.isRunning = true;
+  ctx.scheduleReportSave();
   console.log(`  \u25B6 [${test.browser ?? "?"}] ${test.title}`);
   const message = { type: "test-begin", data: test };
   broadcastToBrowsers(ctx.wsClients, message);
@@ -992,6 +993,7 @@ function handleTestEnd(ctx, data) {
   const errNote = data.error !== null && data.error !== void 0 ? `
     Error: ${data.error}` : "";
   console.log(`  ${icon} [${test.browser}] ${test.title}${dur}${diffNote}${errNote}`);
+  ctx.scheduleReportSave();
   const message = { type: "test-update", data: test };
   broadcastToBrowsers(ctx.wsClients, message);
 }
@@ -1079,6 +1081,61 @@ async function resolvePlaywrightConfig(cwd) {
   return matches.find((path) => path !== null) ?? null;
 }
 
+// src/server/report-persistence.ts
+function createDebouncedSaver(save, delayMs, setTimeoutFn = (fn, ms) => setTimeout(fn, ms), clearTimeoutFn = (handle) => {
+  if (handle !== null) clearTimeout(handle);
+}) {
+  let timer = null;
+  let dirty = false;
+  let inFlight = null;
+  const runSave = () => {
+    dirty = false;
+    inFlight = save();
+    return inFlight.finally(() => {
+      inFlight = null;
+    });
+  };
+  return {
+    schedule() {
+      dirty = true;
+      if (timer !== null) clearTimeoutFn(timer);
+      timer = setTimeoutFn(() => {
+        timer = null;
+        void runSave();
+      }, delayMs);
+    },
+    async flush() {
+      if (timer !== null) {
+        clearTimeoutFn(timer);
+        timer = null;
+      }
+      if (inFlight !== null) {
+        await inFlight;
+      }
+      if (dirty) {
+        await runSave();
+      }
+    },
+    cancel() {
+      if (timer !== null) {
+        clearTimeoutFn(timer);
+        timer = null;
+      }
+      dirty = false;
+    }
+  };
+}
+function createReportPersistence(reportFile, reportData) {
+  const reportSaver = createDebouncedSaver(() => writeJsonFile(reportFile, reportData), 250);
+  return {
+    saveReport: () => reportSaver.flush(),
+    scheduleReportSave: () => {
+      reportSaver.schedule();
+    },
+    dispose: () => reportSaver.flush()
+  };
+}
+
 // src/server/routes-context.ts
 function createRoutesContext(reportData, staticDir, saveReport, options) {
   const artifactRoots = [reportData.screenshotDir, options.outputDir, options.playwrightSnapshotDir].filter(
@@ -1510,15 +1567,14 @@ var RunController = class {
     }
     this.deps.setReportRunning(false);
     this.deps.broadcast({ type: "run-status", data: { running: false } });
+    void this.deps.saveReport?.();
   }
 };
 function createRealSpawn() {
   return (cmd, args, opts) => {
     const cp = (0, import_child_process.spawn)(cmd, args, opts);
     return {
-      on: (event, cb) => {
-        cp.on(event, cb);
-      },
+      on: (event, cb) => cp.on(event, cb),
       kill: (signal) => {
         const sig = KNOWN_SIGNALS[signal];
         if (sig !== void 0) cp.kill(sig);
@@ -1666,7 +1722,7 @@ async function seedRunContext(routesContext, options) {
     routesContext.runContext = { configFile, cwd: process.cwd() };
   }
 }
-function createServerRunController(routesContext, wsClients, reportData, port, setRunFiltered) {
+function createServerRunController(routesContext, wsClients, reportData, port, setRunFiltered, saveReport) {
   return new RunController({
     getRunContext: () => routesContext.runContext ?? null,
     port,
@@ -1677,6 +1733,7 @@ function createServerRunController(routesContext, wsClients, reportData, port, s
       reportData.isRunning = running;
     },
     setRunFiltered,
+    saveReport,
     spawn: createRealSpawn(),
     timers: createRealTimers()
   });
@@ -1689,19 +1746,27 @@ async function createServerApp(options = {}) {
   const staticDir = await resolveStaticDir(options.staticDir);
   const wsClients = /* @__PURE__ */ new Set();
   const currentRunIds = /* @__PURE__ */ new Set();
-  const saveReport = () => writeJsonFile(reportFile, reportData);
-  const routesContext = createRoutesContext(reportData, staticDir, saveReport, options);
+  const persistence = createReportPersistence(reportFile, reportData);
+  const routesContext = createRoutesContext(reportData, staticDir, persistence.saveReport, options);
   await seedRunContext(routesContext, options);
   let isFilteredRun = false;
-  const runController = createServerRunController(routesContext, wsClients, reportData, port, (filtered) => {
-    isFilteredRun = filtered;
-  });
+  const runController = createServerRunController(
+    routesContext,
+    wsClients,
+    reportData,
+    port,
+    (filtered) => {
+      isFilteredRun = filtered;
+    },
+    persistence.saveReport
+  );
   const getHandlerContext = () => ({
     reportData,
     wsClients,
     currentRunIds,
     isFilteredRun,
-    saveReport,
+    saveReport: persistence.saveReport,
+    scheduleReportSave: persistence.scheduleReportSave,
     approvalRouting: routesContext.approvalRouting,
     routesContext,
     runController
@@ -1713,13 +1778,17 @@ async function createServerApp(options = {}) {
   return {
     port,
     wsClients,
-    close: () => {
-      runController.dispose();
-    },
+    close: createCloseHandler(persistence, runController),
     handleRequest,
     handleWebSocketMessage
   };
 }
+function createCloseHandler(persistence, runController) {
+  return async () => {
+    await persistence.dispose();
+    runController.dispose();
+  };
+}
 
 // src/server/bun-adapter.ts
 function logWebSocketError(prefix, error) {
@@ -1917,9 +1986,37 @@ async function startNodeServer(app) {
   console.log(`Crvy Rprtr started at http://localhost:${app.port}`);
 }
 
+// src/server/shutdown.ts
+var EXIT_CODES = {
+  SIGINT: 130,
+  SIGTERM: 143,
+  SIGHUP: 129
+};
+function createSignalShutdown(deps) {
+  let shuttingDown = false;
+  return async function shutdown(signal) {
+    if (shuttingDown) {
+      deps.exit(EXIT_CODES[signal] ?? 1);
+      return;
+    }
+    shuttingDown = true;
+    try {
+      await deps.close();
+    } catch {
+    }
+    deps.exit(EXIT_CODES[signal] ?? 1);
+  };
+}
+
 // src/server.ts
 async function startServer(options = {}) {
   const app = await createServerApp(options);
+  const shutdown = createSignalShutdown({ close: () => app.close(), exit: (code) => process.exit(code) });
+  const onSignal = (signal) => {
+    void shutdown(signal);
+  };
+  process.on("SIGINT", onSignal);
+  process.on("SIGTERM", onSignal);
   if (typeof Bun !== "undefined" && typeof Bun.serve === "function") {
     startBunServer(app);
     return;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAIrE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAKrE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5E"}

package/dist/server.js

@@ -1,6 +1,6 @@
 import {
   startServer
-} from "./chunk-RFZGJSL3.js";
+} from "./chunk-473CWZ4V.js";
 import "./chunk-HAFWYUNO.js";
 export {
   startServer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvy/rprtr",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Playwright reporter with visual regression UI for comparing and approving screenshot tests",
   "keywords": [
     "crvy",
@@ -76,7 +76,7 @@
   },
   "dependencies": {
     "p-limit": "^7.3.0",
-    "package-manager-detector": "^1.7.0",
+    "package-manager-detector": "^1.6.0",
     "ws": "^8.18.3",
     "zod": "^4.3.6"
   },