@reportforge/playwright-pdf 0.20.2 → 0.21.0

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.21.0] - 2026-07-12
+
+### Added
+
+- **`remoteHistory` option — the pass-rate trend now survives ephemeral CI runners.** The local history file is wiped with the CI workspace, so the trend chart never accumulated past one data point. With `remoteHistory: true`, the reporter sends one request per run over the existing license connection carrying **aggregate numbers only** (pass rate, counts, duration, verdict, an opaque run id — no test titles, no error text; the branch name is sent as a hash). The server keeps the last 100 runs per project + branch and returns them for the chart. Any failure falls back to the local file. The flakiness table stays local-only by design (it needs test titles, which never leave your machine).
+
+---
+
 ## [0.20.2] - 2026-07-12
 
 ### Fixed

package/README.md

@@ -205,6 +205,7 @@ All options are the second element of the reporter tuple.
 | `historyFile` | `string` | `~/.reportforge/{key}/history.json` | Path to the history JSON file. Relative paths resolve from `cwd`. Enables pass-rate trending charts in the `detailed` template. |
 | `historySize` | `number` | `10` | Maximum number of test runs to keep in the history file (integer ≥ 2). Older runs are pruned on append. |
 | `showTrend` | `boolean` | `true` | Show the pass-rate sparkline and delta badge in the `detailed` template. Set to `false` to disable history tracking entirely. |
+| `remoteHistory` | `boolean` | `false` | Opt-in server-side trend store so the pass-rate trend survives ephemeral CI runners (the local history file is wiped with the workspace, leaving the chart stuck at one data point). One request per run over the existing license connection carrying aggregate numbers only — no test titles, no error text; the branch name is sent as a hash. Falls back to the local history file on any failure. See the History docs. |
 | `flakinessTopN` | `number` | `5` | Maximum flaky tests to show in the flakiness table (`detailed` template). Set to `0` to disable the table entirely. |
 | `slowTestThreshold` | `number` | `10` | Minimum timed-test count before `SLOW` badges appear in the suite breakdown: below this, every test is trivially the "slowest" so badges stay hidden. On larger runs only genuine outliers (at least 2× the median test duration) are badged, so the badge stays rare. Set to `0` to drop the run-size gate (outliers still required). |
 | `templatePath` | `string \| string[]` | n/a | Path to a custom Handlebars (`.hbs`) template file. Takes precedence over `template`. Pass an array to generate one PDF per custom template. See the Custom Templates docs. |
@@ -319,7 +320,18 @@ After each run the reporter appends a summary entry to a local JSON file and ren
 
 **Local dev (zero config)**: history is written automatically to `~/.reportforge/{projectKey}/history.json`. The sparkline appears once two or more runs have been recorded.
 
-**CI with ephemeral runners**: set `historyFile` to a project-relative path and cache it between runs:
+**CI with ephemeral runners (recommended)**: enable the server-side trend store; the local file is wiped with the workspace, leaving the chart stuck at one data point:
+
+```typescript
+reporter: [['@reportforge/playwright-pdf', {
+  template: 'detailed',
+  remoteHistory: true,
+}]]
+```
+
+One request per run over the existing license connection, carrying aggregate numbers only (pass rate, counts, duration, verdict; no test titles, no error text — the branch name is sent as a hash). The server keeps the last 100 runs per project + branch and returns them for the chart; any failure falls back to the local file. The flakiness table stays local-only by design (it needs test titles, which never leave your machine). Bitbucket Pipelines users especially: Bitbucket caches are immutable once written, so `remoteHistory` is the practical path there.
+
+**CI caching alternative** (keeps even aggregate numbers off the server): set `historyFile` to a project-relative path and cache it between runs:
 
 ```typescript
 // playwright.config.ts

package/dist/cli/index.js

@@ -12128,6 +12128,9 @@ var init_schema = __esm({
       historyFile: external_exports.string().optional(),
       historySize: external_exports.number().int().min(2).optional().default(DEFAULT_OPTIONS.historySize),
       showTrend: external_exports.boolean().optional().default(DEFAULT_OPTIONS.showTrend),
+      // Opt-in server-side trend store: survives ephemeral CI runners where the
+      // local history file is wiped every run. Aggregate numbers only.
+      remoteHistory: external_exports.boolean().default(false),
       flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
       slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
       failureAnalysis: failureAnalysisConfigSchema,

package/dist/index.d.mts

@@ -332,6 +332,16 @@ interface ReporterOptions {
      * @default true
      */
     showTrend?: boolean;
+    /**
+     * Store the pass-rate trend on the ReportForge server so it survives
+     * ephemeral CI runners (where the local history file is wiped every run).
+     * One request per run over the existing license connection, carrying
+     * AGGREGATE NUMBERS ONLY — pass rate, counts, duration, verdict. No test
+     * titles, no error text; even the branch name is sent as a hash. Falls back
+     * to the local history file on any failure.
+     * @default false
+     */
+    remoteHistory?: boolean;
     /**
      * Number of flaky tests to display in the flakiness table (detailed template).
      * Set to 0 to disable. Must be a non-negative integer.

package/dist/index.d.ts

@@ -332,6 +332,16 @@ interface ReporterOptions {
      * @default true
      */
     showTrend?: boolean;
+    /**
+     * Store the pass-rate trend on the ReportForge server so it survives
+     * ephemeral CI runners (where the local history file is wiped every run).
+     * One request per run over the existing license connection, carrying
+     * AGGREGATE NUMBERS ONLY — pass rate, counts, duration, verdict. No test
+     * titles, no error text; even the branch name is sent as a hash. Falls back
+     * to the local history file on any failure.
+     * @default false
+     */
+    remoteHistory?: boolean;
     /**
      * Number of flaky tests to display in the flakiness table (detailed template).
      * Set to 0 to disable. Must be a non-negative integer.

package/dist/index.js

@@ -10554,6 +10554,9 @@ var ReporterOptionsSchema = external_exports.object({
   historyFile: external_exports.string().optional(),
   historySize: external_exports.number().int().min(2).optional().default(DEFAULT_OPTIONS.historySize),
   showTrend: external_exports.boolean().optional().default(DEFAULT_OPTIONS.showTrend),
+  // Opt-in server-side trend store: survives ephemeral CI runners where the
+  // local history file is wiped every run. Aggregate numbers only.
+  remoteHistory: external_exports.boolean().default(false),
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
   slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   failureAnalysis: failureAnalysisConfigSchema,
@@ -13595,6 +13598,48 @@ var HistoryManager = class {
   }
 };
 
+// src/history/RemoteHistory.ts
+init_cjs_shims();
+var import_node_crypto3 = __toESM(require("crypto"));
+var NETWORK_TIMEOUT_MS2 = 5e3;
+function buildProjectId(projectName, outputFile) {
+  return import_node_crypto3.default.createHash("sha256").update(`${projectName ?? ""}:${outputFile}`).digest("hex").slice(0, 16);
+}
+function buildBranchHash(branch) {
+  return import_node_crypto3.default.createHash("sha256").update(branch || "unknown").digest("hex").slice(0, 12);
+}
+async function appendRemoteHistory(opts) {
+  const numericEntry = { ...opts.entry };
+  delete numericEntry.flakyTests;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
+  try {
+    const res = await fetch(`${opts.serverUrl}/api/history/append`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${opts.jwt}`
+      },
+      body: JSON.stringify({ projectId: opts.projectId, branchHash: opts.branchHash, entry: numericEntry }),
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      await res.body?.cancel().catch(() => {
+      });
+      logger.debug(`remote history append failed: HTTP ${res.status} \u2014 using local history`);
+      return null;
+    }
+    const data = await res.json();
+    if (!Array.isArray(data.entries) || data.entries.length === 0) return null;
+    return data.entries;
+  } catch (err) {
+    logger.debug(`remote history append failed: ${err.message} \u2014 using local history`);
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 // src/history/FlakinessAnalyser.ts
 init_cjs_shims();
 function computeTopN(entries, topN) {
@@ -14009,7 +14054,7 @@ var NotificationSender = class {
 
 // src/live/LiveStreamer.ts
 init_cjs_shims();
-var NETWORK_TIMEOUT_MS2 = 8e3;
+var NETWORK_TIMEOUT_MS3 = 8e3;
 var LIVE_DRAIN_DEADLINE_MS = 1e4;
 var MAX_FLUSH_MS = 3e4;
 var WARN_THROTTLE_MS = 3e4;
@@ -14182,7 +14227,7 @@ var LiveStreamer = class {
   async send(body) {
     if (!this.jwt) return;
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
+    const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS3);
     try {
       const res = await fetch(`${this.serverUrl}/api/live/ingest`, {
         method: "POST",
@@ -14356,7 +14401,7 @@ var PdfReporter = class {
     this.options = parseOptions(rawOptions);
     setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.20.2" : "0.x";
+    this.version = true ? "0.21.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14439,7 +14484,7 @@ var PdfReporter = class {
     }
     if (this.options.showTrend && collected.stats.total > 0) {
       try {
-        this._appendTrend(collected);
+        await this._appendTrend(collected, licenseInfo);
       } catch (err) {
         logger.warn(`History write failed \u2014 trend data skipped: ${err.message}`);
       }
@@ -14474,7 +14519,7 @@ var PdfReporter = class {
     }
     return this.dataCollector.finalize(result);
   }
-  _appendTrend(collected) {
+  async _appendTrend(collected, licenseInfo) {
     const historyPath = resolveHistoryPath(this.options, this.cwd);
     const hm = new HistoryManager(historyPath);
     const suffix = Math.random().toString(36).padEnd(8, "0").slice(2, 6);
@@ -14491,13 +14536,28 @@ var PdfReporter = class {
       verdict: deriveVerdict(collected.stats),
       flakyTests
     };
-    const entries = hm.append(entry, this.options.historySize);
-    this._populateHistoryCharts(entries, collected);
+    const localEntries = hm.append(entry, this.options.historySize);
+    let trendEntries = localEntries;
+    if (this.options.remoteHistory && licenseInfo.jwt) {
+      const serverUrl = this.options.serverUrl ?? process.env.REPORTFORGE_SERVER_URL ?? DEFAULT_SERVER_URL2;
+      const remote = await appendRemoteHistory({
+        serverUrl,
+        jwt: licenseInfo.jwt,
+        projectId: buildProjectId(this.options.projectName, this.options.outputFile),
+        branchHash: buildBranchHash(collected.environment.branch),
+        entry
+      });
+      if (remote) {
+        trendEntries = remote;
+        logger.debug(`remote history: ${remote.length} entr${remote.length === 1 ? "y" : "ies"} for trend`);
+      }
+    }
+    this._populateHistoryCharts(trendEntries, localEntries, collected);
   }
-  _populateHistoryCharts(entries, collected) {
-    if (entries.length >= 2) {
+  _populateHistoryCharts(trendEntries, localEntries, collected) {
+    if (trendEntries.length >= 2) {
       collected.charts.trend = {
-        entries: entries.map((e) => ({
+        entries: trendEntries.map((e) => ({
           runId: e.runId,
           timestamp: e.timestamp,
           passRate: e.passRate,
@@ -14505,11 +14565,11 @@ var PdfReporter = class {
           duration: e.duration,
           verdict: e.verdict
         })),
-        delta: entries[0].passRate - entries[1].passRate
+        delta: trendEntries[0].passRate - trendEntries[1].passRate
       };
     }
     if (this.options.flakinessTopN > 0) {
-      const table = computeTopN(entries, this.options.flakinessTopN);
+      const table = computeTopN(localEntries, this.options.flakinessTopN);
       if (table.length > 0) {
         collected.charts.flakinessTable = table;
       }

package/dist/index.mjs

@@ -10555,6 +10555,9 @@ var ReporterOptionsSchema = external_exports.object({
   historyFile: external_exports.string().optional(),
   historySize: external_exports.number().int().min(2).optional().default(DEFAULT_OPTIONS.historySize),
   showTrend: external_exports.boolean().optional().default(DEFAULT_OPTIONS.showTrend),
+  // Opt-in server-side trend store: survives ephemeral CI runners where the
+  // local history file is wiped every run. Aggregate numbers only.
+  remoteHistory: external_exports.boolean().default(false),
   flakinessTopN: external_exports.number().int().min(0, "flakinessTopN must be 0 or greater").optional().default(DEFAULT_OPTIONS.flakinessTopN),
   slowTestThreshold: external_exports.number().int().min(0, "slowTestThreshold must be 0 or greater").optional().default(DEFAULT_OPTIONS.slowTestThreshold),
   failureAnalysis: failureAnalysisConfigSchema,
@@ -13596,6 +13599,48 @@ var HistoryManager = class {
   }
 };
 
+// src/history/RemoteHistory.ts
+init_esm_shims();
+import crypto4 from "crypto";
+var NETWORK_TIMEOUT_MS2 = 5e3;
+function buildProjectId(projectName, outputFile) {
+  return crypto4.createHash("sha256").update(`${projectName ?? ""}:${outputFile}`).digest("hex").slice(0, 16);
+}
+function buildBranchHash(branch) {
+  return crypto4.createHash("sha256").update(branch || "unknown").digest("hex").slice(0, 12);
+}
+async function appendRemoteHistory(opts) {
+  const numericEntry = { ...opts.entry };
+  delete numericEntry.flakyTests;
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
+  try {
+    const res = await fetch(`${opts.serverUrl}/api/history/append`, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        authorization: `Bearer ${opts.jwt}`
+      },
+      body: JSON.stringify({ projectId: opts.projectId, branchHash: opts.branchHash, entry: numericEntry }),
+      signal: controller.signal
+    });
+    if (!res.ok) {
+      await res.body?.cancel().catch(() => {
+      });
+      logger.debug(`remote history append failed: HTTP ${res.status} \u2014 using local history`);
+      return null;
+    }
+    const data = await res.json();
+    if (!Array.isArray(data.entries) || data.entries.length === 0) return null;
+    return data.entries;
+  } catch (err) {
+    logger.debug(`remote history append failed: ${err.message} \u2014 using local history`);
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 // src/history/FlakinessAnalyser.ts
 init_esm_shims();
 function computeTopN(entries, topN) {
@@ -14010,7 +14055,7 @@ var NotificationSender = class {
 
 // src/live/LiveStreamer.ts
 init_esm_shims();
-var NETWORK_TIMEOUT_MS2 = 8e3;
+var NETWORK_TIMEOUT_MS3 = 8e3;
 var LIVE_DRAIN_DEADLINE_MS = 1e4;
 var MAX_FLUSH_MS = 3e4;
 var WARN_THROTTLE_MS = 3e4;
@@ -14183,7 +14228,7 @@ var LiveStreamer = class {
   async send(body) {
     if (!this.jwt) return;
     const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS2);
+    const timeout = setTimeout(() => controller.abort(), NETWORK_TIMEOUT_MS3);
     try {
       const res = await fetch(`${this.serverUrl}/api/live/ingest`, {
         method: "POST",
@@ -14357,7 +14402,7 @@ var PdfReporter = class {
     this.options = parseOptions(rawOptions);
     setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.20.2" : "0.x";
+    this.version = true ? "0.21.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14440,7 +14485,7 @@ var PdfReporter = class {
     }
     if (this.options.showTrend && collected.stats.total > 0) {
       try {
-        this._appendTrend(collected);
+        await this._appendTrend(collected, licenseInfo);
       } catch (err) {
         logger.warn(`History write failed \u2014 trend data skipped: ${err.message}`);
       }
@@ -14475,7 +14520,7 @@ var PdfReporter = class {
     }
     return this.dataCollector.finalize(result);
   }
-  _appendTrend(collected) {
+  async _appendTrend(collected, licenseInfo) {
     const historyPath = resolveHistoryPath(this.options, this.cwd);
     const hm = new HistoryManager(historyPath);
     const suffix = Math.random().toString(36).padEnd(8, "0").slice(2, 6);
@@ -14492,13 +14537,28 @@ var PdfReporter = class {
       verdict: deriveVerdict(collected.stats),
       flakyTests
     };
-    const entries = hm.append(entry, this.options.historySize);
-    this._populateHistoryCharts(entries, collected);
+    const localEntries = hm.append(entry, this.options.historySize);
+    let trendEntries = localEntries;
+    if (this.options.remoteHistory && licenseInfo.jwt) {
+      const serverUrl = this.options.serverUrl ?? process.env.REPORTFORGE_SERVER_URL ?? DEFAULT_SERVER_URL2;
+      const remote = await appendRemoteHistory({
+        serverUrl,
+        jwt: licenseInfo.jwt,
+        projectId: buildProjectId(this.options.projectName, this.options.outputFile),
+        branchHash: buildBranchHash(collected.environment.branch),
+        entry
+      });
+      if (remote) {
+        trendEntries = remote;
+        logger.debug(`remote history: ${remote.length} entr${remote.length === 1 ? "y" : "ies"} for trend`);
+      }
+    }
+    this._populateHistoryCharts(trendEntries, localEntries, collected);
   }
-  _populateHistoryCharts(entries, collected) {
-    if (entries.length >= 2) {
+  _populateHistoryCharts(trendEntries, localEntries, collected) {
+    if (trendEntries.length >= 2) {
       collected.charts.trend = {
-        entries: entries.map((e) => ({
+        entries: trendEntries.map((e) => ({
           runId: e.runId,
           timestamp: e.timestamp,
           passRate: e.passRate,
@@ -14506,11 +14566,11 @@ var PdfReporter = class {
           duration: e.duration,
           verdict: e.verdict
         })),
-        delta: entries[0].passRate - entries[1].passRate
+        delta: trendEntries[0].passRate - trendEntries[1].passRate
       };
     }
     if (this.options.flakinessTopN > 0) {
-      const table = computeTopN(entries, this.options.flakinessTopN);
+      const table = computeTopN(localEntries, this.options.flakinessTopN);
       if (table.length > 0) {
         collected.charts.flakinessTable = table;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "Playwright Test reporter that generates designed PDF reports: minimal, detailed, and executive templates with CI/CD integrations",
   "license": "Elastic-2.0",
   "author": "ReportForge",