@reportforge/playwright-pdf 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 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.17.0] - 2026-07-09
+
+### Added
+
+- **The reporter now tells you when a newer version is available.** Each run ends with one info line naming the current and latest version and the update command, e.g. `Update available: 0.16.1 -> 0.17.0. Run: npm i -D @reportforge/playwright-pdf@latest`. The latest published version is piggybacked on the existing license activate/refresh call, so there are no extra network calls; the notice never blocks or fails a run and disappears once you update.
+- **Admins can send release announcement emails.** A new `/admin/announce` panel builds the email body from the changelog entry for a chosen version and sends it to a selected audience (active subscribers, all subscribers, or active plus recently churned within 90 days), with a preview step and idempotency protection against duplicate sends.
+
+---
+
+## [0.16.1] - 2026-07-09
+
+### Changed
+
+- **Relicensed from MIT to the Elastic License 2.0** (source-available). The source stays readable, copyable, and modifiable; the license does not allow offering the software as a hosted service, bypassing or removing the license-key check, or stripping license/copyright notices. Surfaces updated together: `LICENSE`, `package.json` license metadata, README badge + License section, docs badge, marketing footer, pricing FAQ, and legal terms (§2 License grant, §7 IP, `lastUpdated`).
+
+---
+
 ## [0.16.0] - 2026-07-07
 
 ### Added

package/LICENSE

@@ -1,21 +1,95 @@
-MIT License
-
 Copyright (c) 2026 ReportForge
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor’s trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/README.md

@@ -6,7 +6,7 @@ Drop it into any Playwright project and get a PDF report on every CI run. No cha
 
 [![npm](https://img.shields.io/npm/v/@reportforge/playwright-pdf.svg)](https://www.npmjs.com/package/@reportforge/playwright-pdf)
 [![Node](https://img.shields.io/node/v/@reportforge/playwright-pdf.svg)](https://nodejs.org/)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![License](https://img.shields.io/badge/license-Elastic--2.0-blue.svg)](./LICENSE)
 
 <p align="center">
   <a href="https://reportforge.org/pricing">
@@ -47,7 +47,7 @@ Three templates, one reporter. Every PDF is fully offline: fonts, charts, and sc
 
 - **3 templates**: `minimal` (developer), `detailed` (QA team), `executive` (stakeholders)
 - **Detailed reports**: KPI dashboard, suite breakdown with inline failure detail (error, screenshot, root-cause chip) under each failed test, CI/CD environment
-- **Embedded Chart.js**: pass-rate doughnut + per-suite bar chart, bundled inline (no CDN); every suite gets its own bar — large runs switch to full-width suite charts that continue across pages, so per-suite coverage and failures stay visible run-wide
+- **Embedded Chart.js**: pass-rate doughnut + per-suite bar chart, bundled inline (no CDN); every suite gets its own bar, and large runs switch to full-width suite charts that continue across pages, so per-suite coverage and failures stay visible run-wide
 - **Self-contained PDFs**: screenshots, fonts, logos all embedded; share or archive with confidence
 - **Custom branding**: logo, primary/accent colours, watermark, PDF password encryption
 - **Dynamic filenames**: `{date}`, `{branch}`, `{status}` tokens in the output path
@@ -63,6 +63,7 @@ Three templates, one reporter. Every PDF is fully offline: fonts, charts, and sc
 - **Configurable sections**: add or remove any report section per template via `sections`.
 - **Executive report brief band**: leads with a plain-language brief (trend + root causes) and one hero pass-rate number instead of a flat KPI grid
 - **Hybrid licensing**: one short key unlocks it; reports keep rendering offline via a cached JWT between refreshes
+- **Update notice**: when a newer reporter version is published, each run ends with one info line naming it and the update command; delivered over the existing license refresh, no extra network calls
 
 ---
 
@@ -97,7 +98,7 @@ npx playwright test
 
 > **See it first.** Run `npx @reportforge/playwright-pdf demo` to generate a realistic sample PDF in under 60 seconds, no license key required. Supports `--template=minimal|detailed|executive` and `--output=<path>`.
 
-> **License required.** Start a **[7-day free trial at reportforge.org/pricing](https://reportforge.org/pricing)**: card required, no charge until day 8. Paste the resulting `RFSU-…` key into `RF_LICENSE_KEY`. Without a valid license the reporter logs a warning and skips PDF generation; your Playwright tests still run normally.
+> **License required.** Start a **[7-day free trial at reportforge.org/pricing](https://reportforge.org/pricing)**: card required, no charge until day 8. Paste the resulting `RFSU-…` key into `RF_LICENSE_KEY`. Without a valid license the reporter logs a warning and skips PDF generation; your Playwright tests still run normally. When a newer reporter version exists, runs end with a one-line update notice.
 
 ---
 
@@ -157,7 +158,7 @@ reporter: [['@reportforge/playwright-pdf', {
 | Plan | INR | USD | Includes |
 |---|---|---|---|
 | **Monthly** | **₹999 / month** | **$12 / month** | All three templates · custom branding · PDF encryption · up to 25 active machines · priority email support |
-| **Yearly** | **₹8,499 / year** | **$99 / year** | Everything in Monthly · ~29–31% saving vs monthly |
+| **Yearly** | **₹8,499 / year** | **$99 / year** | Everything in Monthly · ~29-31% saving vs monthly |
 
 Currency is auto-detected by region; toggle on the pricing page.
 
@@ -198,7 +199,7 @@ All options are the second element of the reporter tuple.
 | `notify` | `object` | n/a | Notification channels: `slack`, `teams` (each `{ url, enabled, on }`), `discord` (`{ url, enabled, on, attachPdf }`), `email` (`{ to, enabled, on, attachPdf }`). See the Notifications docs. |
 | `failureAnalysis` | `object` | `{ enabled: true }` | Offline failure root-cause analysis (embedded Naive Bayes; no runtime network). Fields: `enabled` (default `true`), `maxClusters` (default `10`), `minStrength` (`weak`\|`moderate`\|`strong`, default `weak`), `maxFailuresToAnalyse` (default `500`), `collectUnclassified` (default `true`), `autoUpdateModel` (default `true`). See the Failure Analysis docs. |
 | `capture` | `object` | `{}` (off) | Opt-in rich execution capture for the defect log (reporter-side; no fixtures, no test-code changes). Fields: `steps` (a copy-pasteable "Steps to Reproduce" outline built from the Playwright step tree; each row is a Markdown list line indented under its parent `test.step`, default `false`), `apiSteps` (include every top-level `pw:api` action (click/fill/check/goto) in the outline for a full action trail; without it the outline shows only `test.step` intent + `expect` assertions, default `false`), `console` (Node stdout/stderr tail, default `false`), `evidence` (trace/video file links, default `false`), `maxSteps` (default `50`), `maxConsoleLines` (default `50`). Renders in the Defect Log section of the `detailed` template. |
-| `live` | `object` | `{}` (off) | Opt-in live test-execution streaming. When `enabled`, the reporter prints an unguessable watch link to the CI logs at run start and streams per-test progress to the hosted dashboard while tests run; all shards of one CI run converge on a single live view. Fields: `enabled` (default `false`), `runId` (override the auto-derived run id), `serverUrl` (override the streaming server), `steps` (`none`\|`failed`\|`intent`\|`all`, default `failed`; `intent` shows only your `test.step` names plus any failing step), `console` (stream stdout/stderr tails, default `false`), `flushMs` (batch debounce 500–10000, default `2000`). The PDF at the end of the run is unaffected. Requires an active subscription with the `live` entitlement. See the Live Runs docs. |
+| `live` | `object` | `{}` (off) | Opt-in live test-execution streaming. When `enabled`, the reporter prints an unguessable watch link to the CI logs at run start and streams per-test progress to the hosted dashboard while tests run; all shards of one CI run converge on a single live view. Fields: `enabled` (default `false`), `runId` (override the auto-derived run id), `serverUrl` (override the streaming server), `steps` (`none`\|`failed`\|`intent`\|`all`, default `failed`; `intent` shows only your `test.step` names plus any failing step), `console` (stream stdout/stderr tails, default `false`), `flushMs` (batch debounce 500-10000, default `2000`). The PDF at the end of the run is unaffected. Requires an active subscription with the `live` entitlement. See the Live Runs docs. |
 | `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. |
@@ -225,7 +226,7 @@ reporter: [
       enabled: true,
       steps: 'failed',   // 'none' | 'failed' | 'intent' | 'all'
       // console: false,  // stream stdout/stderr tails (off by default; see note)
-      // flushMs: 2000,   // batch debounce (500–10000)
+      // flushMs: 2000,   // batch debounce (500-10000)
     },
   }],
 ],
@@ -678,4 +679,4 @@ Questions and bug reports: email [support@reportforge.org](mailto:support@report
 
 ## License
 
-MIT. See [LICENSE](./LICENSE).
+[Elastic License 2.0](./LICENSE), source-available. Read, copy, and modify the source freely. Three things the license does not allow: offering the software as a hosted service, bypassing or removing the license-key check, and stripping license or copyright notices. Generating PDF reports requires an active subscription.

package/dist/index.d.mts

@@ -379,6 +379,13 @@ interface LicenseInfo {
      * field was persisted — treat absence as "no extra features".
      */
     features?: string[];
+    /**
+     * Latest published npm version of the reporter, as last reported by the
+     * license server (activate/refresh piggyback). Absent when the server
+     * could not reach the registry or the cache predates this field. Used
+     * only for the non-blocking run-end update notice.
+     */
+    latestVersion?: string;
 }
 
 /**
@@ -417,6 +424,7 @@ interface LicenseInfo {
 declare class PdfReporter implements Reporter {
     private readonly options;
     private readonly cwd;
+    private readonly version;
     private readonly licenseClient;
     private readonly dataCollector;
     private readonly pdfGenerator;

package/dist/index.d.ts

@@ -379,6 +379,13 @@ interface LicenseInfo {
      * field was persisted — treat absence as "no extra features".
      */
     features?: string[];
+    /**
+     * Latest published npm version of the reporter, as last reported by the
+     * license server (activate/refresh piggyback). Absent when the server
+     * could not reach the registry or the cache predates this field. Used
+     * only for the non-blocking run-end update notice.
+     */
+    latestVersion?: string;
 }
 
 /**
@@ -417,6 +424,7 @@ interface LicenseInfo {
 declare class PdfReporter implements Reporter {
     private readonly options;
     private readonly cwd;
+    private readonly version;
     private readonly licenseClient;
     private readonly dataCollector;
     private readonly pdfGenerator;

package/dist/index.js

@@ -10995,7 +10995,8 @@ var LicenseClient = class {
         fingerprintHash: this.fingerprint.hash,
         machinesUsed: result.machinesUsed,
         machineLimit: result.machineLimit,
-        features: payload.features
+        features: payload.features,
+        latestVersion: result.latestVersion
       };
       writeCache(entry);
       logger.debug(`license path=${cached ? "refresh" : "activate"} response`, {
@@ -11014,7 +11015,8 @@ var LicenseClient = class {
         expiry: new Date(payload.exp * 1e3),
         machinesUsed: result.machinesUsed,
         machineLimit: result.machineLimit,
-        features: payload.features
+        features: payload.features,
+        latestVersion: result.latestVersion
       };
     } catch (err) {
       const msg = err.message;
@@ -11111,13 +11113,47 @@ function toLicenseInfo(payload, cached, normalizedKey, source) {
     // Prefer the signed `features` claim (authenticated) over the unauthenticated
     // sidecar — falls back to the sidecar only for caches written before the
     // payload was threaded through here.
-    features: payload.features ?? cached.features
+    features: payload.features ?? cached.features,
+    latestVersion: cached.latestVersion
   };
 }
 function normalizeUrl(url) {
   return url.endsWith("/") ? url.slice(0, -1) : url;
 }
 
+// src/license/update-notice.ts
+init_cjs_shims();
+
+// src/license/version.ts
+init_cjs_shims();
+function parseTriple(v) {
+  if (!v) return null;
+  const m = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(v.trim());
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function isNewer(latest, current) {
+  const l = parseTriple(latest);
+  const c = parseTriple(current);
+  if (!l || !c) return false;
+  if (l[0] !== c[0]) return l[0] > c[0];
+  if (l[1] !== c[1]) return l[1] > c[1];
+  return l[2] > c[2];
+}
+
+// src/license/update-notice.ts
+function maybePrintUpdateNotice(licenseInfo, currentVersion) {
+  try {
+    const latest = licenseInfo?.latestVersion;
+    if (!latest || !isNewer(latest, currentVersion)) return;
+    const shown = latest.replace(/[^\w.+-]/g, "");
+    logger.info(
+      `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
+    );
+  } catch {
+  }
+}
+
 // src/analysis/index.ts
 init_cjs_shims();
 
@@ -14119,8 +14155,8 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.16.0" : "0.x";
-    logger.info(`@reportforge/playwright-pdf v${version} initialised`);
+    this.version = true ? "0.17.0" : "0.x";
+    logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
       serverUrl: this.options.serverUrl,
@@ -14193,7 +14229,10 @@ var PdfReporter = class {
     const licenseInfo = await this.license();
     if (!licenseInfo) return;
     const collected = this._collectData(result);
-    if (!collected) return;
+    if (!collected) {
+      maybePrintUpdateNotice(licenseInfo, this.version);
+      return;
+    }
     if (this.options.showTrend && collected.stats.total > 0) {
       try {
         this._appendTrend(collected);
@@ -14218,6 +14257,7 @@ var PdfReporter = class {
       const sender = new NotificationSender();
       await sender.sendAll(reportData, this.options.notify, pdfPaths);
     }
+    maybePrintUpdateNotice(licenseInfo, this.version);
   }
   _collectData(result) {
     if (this.options.shardResults && this.options.shardResults.length > 0) {

package/dist/index.mjs

@@ -10996,7 +10996,8 @@ var LicenseClient = class {
         fingerprintHash: this.fingerprint.hash,
         machinesUsed: result.machinesUsed,
         machineLimit: result.machineLimit,
-        features: payload.features
+        features: payload.features,
+        latestVersion: result.latestVersion
       };
       writeCache(entry);
       logger.debug(`license path=${cached ? "refresh" : "activate"} response`, {
@@ -11015,7 +11016,8 @@ var LicenseClient = class {
         expiry: new Date(payload.exp * 1e3),
         machinesUsed: result.machinesUsed,
         machineLimit: result.machineLimit,
-        features: payload.features
+        features: payload.features,
+        latestVersion: result.latestVersion
       };
     } catch (err) {
       const msg = err.message;
@@ -11112,13 +11114,47 @@ function toLicenseInfo(payload, cached, normalizedKey, source) {
     // Prefer the signed `features` claim (authenticated) over the unauthenticated
     // sidecar — falls back to the sidecar only for caches written before the
     // payload was threaded through here.
-    features: payload.features ?? cached.features
+    features: payload.features ?? cached.features,
+    latestVersion: cached.latestVersion
   };
 }
 function normalizeUrl(url) {
   return url.endsWith("/") ? url.slice(0, -1) : url;
 }
 
+// src/license/update-notice.ts
+init_esm_shims();
+
+// src/license/version.ts
+init_esm_shims();
+function parseTriple(v) {
+  if (!v) return null;
+  const m = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(v.trim());
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+function isNewer(latest, current) {
+  const l = parseTriple(latest);
+  const c = parseTriple(current);
+  if (!l || !c) return false;
+  if (l[0] !== c[0]) return l[0] > c[0];
+  if (l[1] !== c[1]) return l[1] > c[1];
+  return l[2] > c[2];
+}
+
+// src/license/update-notice.ts
+function maybePrintUpdateNotice(licenseInfo, currentVersion) {
+  try {
+    const latest = licenseInfo?.latestVersion;
+    if (!latest || !isNewer(latest, currentVersion)) return;
+    const shown = latest.replace(/[^\w.+-]/g, "");
+    logger.info(
+      `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
+    );
+  } catch {
+  }
+}
+
 // src/analysis/index.ts
 init_esm_shims();
 
@@ -14120,8 +14156,8 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.16.0" : "0.x";
-    logger.info(`@reportforge/playwright-pdf v${version} initialised`);
+    this.version = true ? "0.17.0" : "0.x";
+    logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
       serverUrl: this.options.serverUrl,
@@ -14194,7 +14230,10 @@ var PdfReporter = class {
     const licenseInfo = await this.license();
     if (!licenseInfo) return;
     const collected = this._collectData(result);
-    if (!collected) return;
+    if (!collected) {
+      maybePrintUpdateNotice(licenseInfo, this.version);
+      return;
+    }
     if (this.options.showTrend && collected.stats.total > 0) {
       try {
         this._appendTrend(collected);
@@ -14219,6 +14258,7 @@ var PdfReporter = class {
       const sender = new NotificationSender();
       await sender.sendAll(reportData, this.options.notify, pdfPaths);
     }
+    maybePrintUpdateNotice(licenseInfo, this.version);
   }
   _collectData(result) {
     if (this.options.shardResults && this.options.shardResults.length > 0) {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Playwright Test reporter that generates designed PDF reports: minimal, detailed, and executive templates with CI/CD integrations",
-  "license": "MIT",
+  "license": "Elastic-2.0",
   "author": "ReportForge",
   "homepage": "https://reportforge.org",
   "repository": {