@reportforge/playwright-pdf 0.10.0 → 0.10.1

package/README.md

@@ -211,7 +211,9 @@ Full reference: [reportforge.org/docs/configuration](https://reportforge.org/doc
 
 ### Live Runs
 
-Watch a run as it happens. With `live` enabled, the reporter prints an unguessable watch link — boxed under a `Live Tracker` heading — to your CI logs at run start and streams per-test progress to a hosted dashboard while tests execute. All shards of one CI run converge on a single live view, each running test shows the step it's currently executing, and the PDF is still generated at the end, unchanged.
+Watch a run as it happens. With `live` enabled, the reporter prints an unguessable watch link — boxed under a `Live Tracker` heading — to your CI logs at run start and streams per-test progress to a hosted dashboard while tests execute. All shards of one CI run converge on a single live view, each test shows its steps as sub-lines beneath its own row, and the PDF is still generated at the end, unchanged.
+
+> The watch link is entitlement-gated. If you enable `live` but see no `Live Tracker` line, the reporter logs why (missing `RF_LICENSE_KEY`, or a cached token without the `live` entitlement — delete `~/.reportforge/license.json` to force re-activation).
 
 ```typescript
 // playwright.config.ts

package/dist/index.js

@@ -13753,7 +13753,7 @@ var LiveStreamer = class {
       this.enabled = false;
       this.testBuffer = [];
       this.eventBuffer = [];
-      this.warn("Live streaming disabled \u2014 no active license or live entitlement.");
+      logger.debug("Live streaming disabled \u2014 no active license or live entitlement.");
       return false;
     }
     this.jwt = info.jwt;
@@ -13816,8 +13816,8 @@ function deriveRunId(opts) {
   if (fromEnv) return fromEnv;
   return detectCiRunId() ?? (0, import_crypto9.randomUUID)();
 }
-function computeWatchToken(runId) {
-  const secret = process.env.RF_LICENSE_KEY?.trim();
+function computeWatchToken(runId, key) {
+  const secret = key?.trim() || process.env.RF_LICENSE_KEY?.trim();
   if (!secret) return null;
   return (0, import_crypto8.createHmac)("sha256", secret).update(`live:${runId}`).digest("hex").slice(0, WATCH_TOKEN_HEX_LEN);
 }
@@ -13911,7 +13911,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.10.0" : "0.x";
+    const version = true ? "0.10.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14125,11 +14125,17 @@ var PdfReporter = class {
     this.liveSteps = live.steps;
     this.liveConsole = live.console;
     void this.license();
-    const token = computeWatchToken(runId);
+    const token = computeWatchToken(runId, this.options.licenseKey);
     const watchUrl = token ? buildWatchUrl(serverUrl, runId, token) : void 0;
     const env = detectCiEnv();
-    if (watchUrl) void this.announceLive(watchUrl, env, shard).catch(() => {
-    });
+    if (watchUrl) {
+      void this.announceLive(watchUrl, env, shard).catch(() => {
+      });
+    } else {
+      logger.warn(
+        "Live is enabled but no RF_LICENSE_KEY was found \u2014 cannot mint a watch link or stream. Set RF_LICENSE_KEY (or the `licenseKey` option)."
+      );
+    }
     this.liveStreamer = new LiveStreamer({
       serverUrl,
       runId,
@@ -14150,7 +14156,22 @@ var PdfReporter = class {
    */
   async announceLive(watchUrl, env, shard) {
     const info = await this.license();
-    if (!info?.jwt || !info.features?.includes("live")) return;
+    if (!info) {
+      logger.warn("Live is enabled but no active license resolved \u2014 no watch link or streaming.");
+      return;
+    }
+    if (!info.jwt) {
+      logger.warn(
+        "Live is enabled but the license has no signed token (offline with no cached token?) \u2014 no streaming."
+      );
+      return;
+    }
+    if (!info.features?.includes("live")) {
+      logger.warn(
+        "Live is enabled but your license token does not include the 'live' entitlement \u2014 no watch link or streaming. This usually means a cached token predates live streaming and could not be refreshed. Ensure network access on the next run, or delete ~/.reportforge/license.json to force re-activation. If it persists on an active subscription, contact support."
+      );
+      return;
+    }
     logger.info(`Live Tracker: ${watchUrl}`);
     console.log(formatLiveBanner(watchUrl));
     const isPrimaryShard = !shard || shard.current === 1;

package/dist/index.mjs

@@ -13754,7 +13754,7 @@ var LiveStreamer = class {
       this.enabled = false;
       this.testBuffer = [];
       this.eventBuffer = [];
-      this.warn("Live streaming disabled \u2014 no active license or live entitlement.");
+      logger.debug("Live streaming disabled \u2014 no active license or live entitlement.");
       return false;
     }
     this.jwt = info.jwt;
@@ -13817,8 +13817,8 @@ function deriveRunId(opts) {
   if (fromEnv) return fromEnv;
   return detectCiRunId() ?? randomUUID2();
 }
-function computeWatchToken(runId) {
-  const secret = process.env.RF_LICENSE_KEY?.trim();
+function computeWatchToken(runId, key) {
+  const secret = key?.trim() || process.env.RF_LICENSE_KEY?.trim();
   if (!secret) return null;
   return createHmac3("sha256", secret).update(`live:${runId}`).digest("hex").slice(0, WATCH_TOKEN_HEX_LEN);
 }
@@ -13912,7 +13912,7 @@ var PdfReporter = class {
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
     this.dataCollector = new DataCollector(this.options.capture);
-    const version = true ? "0.10.0" : "0.x";
+    const version = true ? "0.10.1" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14126,11 +14126,17 @@ var PdfReporter = class {
     this.liveSteps = live.steps;
     this.liveConsole = live.console;
     void this.license();
-    const token = computeWatchToken(runId);
+    const token = computeWatchToken(runId, this.options.licenseKey);
     const watchUrl = token ? buildWatchUrl(serverUrl, runId, token) : void 0;
     const env = detectCiEnv();
-    if (watchUrl) void this.announceLive(watchUrl, env, shard).catch(() => {
-    });
+    if (watchUrl) {
+      void this.announceLive(watchUrl, env, shard).catch(() => {
+      });
+    } else {
+      logger.warn(
+        "Live is enabled but no RF_LICENSE_KEY was found \u2014 cannot mint a watch link or stream. Set RF_LICENSE_KEY (or the `licenseKey` option)."
+      );
+    }
     this.liveStreamer = new LiveStreamer({
       serverUrl,
       runId,
@@ -14151,7 +14157,22 @@ var PdfReporter = class {
    */
   async announceLive(watchUrl, env, shard) {
     const info = await this.license();
-    if (!info?.jwt || !info.features?.includes("live")) return;
+    if (!info) {
+      logger.warn("Live is enabled but no active license resolved \u2014 no watch link or streaming.");
+      return;
+    }
+    if (!info.jwt) {
+      logger.warn(
+        "Live is enabled but the license has no signed token (offline with no cached token?) \u2014 no streaming."
+      );
+      return;
+    }
+    if (!info.features?.includes("live")) {
+      logger.warn(
+        "Live is enabled but your license token does not include the 'live' entitlement \u2014 no watch link or streaming. This usually means a cached token predates live streaming and could not be refreshed. Ensure network access on the next run, or delete ~/.reportforge/license.json to force re-activation. If it persists on an active subscription, contact support."
+      );
+      return;
+    }
     logger.info(`Live Tracker: ${watchUrl}`);
     console.log(formatLiveBanner(watchUrl));
     const isPrimaryShard = !shard || shard.current === 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Enterprise-ready PDF reports for Playwright Test — minimal, detailed, and executive templates with CI/CD integrations",
   "license": "MIT",
   "author": "ReportForge",