@reportforge/playwright-pdf 0.17.0 → 0.19.0

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 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.19.0] - 2026-07-11
+
+### Added
+
+- **New `logLevel` option** (`'silent' | 'error' | 'warn' | 'info' | 'debug'`, default `'info'`) controls how chatty the reporter's `[reportforge]` console lines are. `'debug'` prints the same diagnostics as `RF_DEBUG=1` (useful in CI where env vars are awkward to set); `'silent'` suppresses everything, including error lines. `RF_DEBUG=1` always forces debug output, overriding the option, so "set `RF_DEBUG=1` and send the log" keeps working regardless of config.
+- **`RF_DEBUG=1` now explains previously silent failure paths**: license cache reads/writes, cached-token rejection (including exactly why the reporter re-activated instead of serving from cache), device-id persistence, Chrome discovery, and the qpdf availability probe.
+
+### Changed
+
+- A failed write of `~/.reportforge/device.json` now logs a warning, because it means this machine may register a new license seat on every run.
+- The live watch URL is printed once instead of twice; the banner link line now carries the `[reportforge]` prefix so it stays greppable in CI logs.
+- CLI output prefixes are consistent: the `demo` and `export-feedback` commands use the same `[reportforge]` prefix as the reporter.
+
+---
+
+## [0.18.0] - 2026-07-11
+
+### Changed
+
+- **Node 20 is now the minimum supported version** (was Node 18). Node 18 reached end-of-life in April 2025 and no longer receives security patches, and dependencies have begun dropping support for it. If you are still on Node 18, upgrade to Node 20 or later before taking this release. CI now tests against Node 20, 22, and 24.
+- `puppeteer-core` is now supported up to v25 (peer range widened to `>=21 <26`). Existing v21 to v24 installs keep working, so no action is needed unless you want to upgrade.
+- Internal dependency updates: `sharp` 0.35 (which requires Node 20), and `@types/node` 26.
+
+---
+
 ## [0.17.0] - 2026-07-09
 
 ### Added

package/README.md

@@ -189,6 +189,7 @@ All options are the second element of the reporter tuple.
 | `reportTitle` | `string` | `'Playwright Test Report'` | Custom title for the report cover page and running header. |
 | `projectName` | `string` | from `package.json` | Project or application name. Inferred from the `package.json` `name` field if absent. |
 | `open` | `boolean` | `false` | Open the generated PDF automatically after generation. For local use only; ignored in CI. |
+| `logLevel` | `'silent' \| 'error' \| 'warn' \| 'info' \| 'debug'` | `'info'` | Console verbosity for `[reportforge]` log lines. `'silent'` suppresses everything including errors; `'debug'` adds diagnostics. The `RF_DEBUG=1` env var always forces debug, overriding this option. |
 | `puppeteerExecutablePath` | `string` | auto-detect | Full path to a Chrome or Chromium binary. Falls back to `PUPPETEER_EXECUTABLE_PATH` env, then system Chrome discovery. |
 | `serverUrl` | `string` | `'https://reportforge.org'` | Base URL for the ReportForge licensing server. Override only for self-hosting or local development. |
 | `compressionLevel` | `'auto' \| 'none' \| 'balanced' \| 'max'` | `'auto'` | Screenshot JPEG quality preset. `'auto'` picks based on failure volume; `'none'` keeps original PNGs; `'balanced'` uses JPEG q85; `'max'` uses JPEG q70. |
@@ -644,6 +645,18 @@ Set `RF_DEBUG=1` to log the full activation flow and error stack traces:
 RF_DEBUG=1 npx playwright test 2>&1 | grep '\[reportforge\]'
 ```
 
+### Controlling log output
+
+The `logLevel` option sets how chatty the reporter's `[reportforge]` console lines are:
+
+```ts
+['@reportforge/playwright-pdf', { logLevel: 'warn' }]  // warnings and errors only
+```
+
+- `'debug'` prints the same diagnostics as `RF_DEBUG=1` — useful in CI where env vars are awkward to set.
+- `'silent'` suppresses everything, **including error lines**: a failed PDF then surfaces only as a missing file, because the reporter never fails your test run.
+- `RF_DEBUG=1` always forces debug output, overriding `logLevel` — it is the support escape hatch, so "set `RF_DEBUG=1` and send the log" works no matter what the config says.
+
 Common issues:
 
 - **`Chrome/Chromium not found`** → install Google Chrome Stable; don't use the Ubuntu `chromium-browser` snap.
@@ -677,6 +690,10 @@ Full documentation at [reportforge.org/docs](https://reportforge.org/docs):
 
 Questions and bug reports: email [support@reportforge.org](mailto:support@reportforge.org).
 
+## Security
+
+Found a vulnerability? Email [support@reportforge.org](mailto:support@reportforge.org) with a subject starting with `[SECURITY]` — please don't open a public issue. Details, scope, and response timelines are in [SECURITY.md](./SECURITY.md); machine-readable contact data is at [reportforge.org/.well-known/security.txt](https://reportforge.org/.well-known/security.txt).
+
 ## 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.
+[Elastic License 2.0](./LICENSE). The license does not allow offering the software as a hosted service, bypassing or removing the license-key check, or stripping license or copyright notices. Generating PDF reports requires an active subscription.

package/SECURITY.md

@@ -0,0 +1,50 @@
+# Security Policy
+
+ReportForge handles license keys, payment webhooks, and customer data. We take
+vulnerability reports seriously and appreciate coordinated disclosure.
+
+## Reporting a vulnerability
+
+Email **[support@reportforge.org](mailto:support@reportforge.org)** with the
+subject line starting with `[SECURITY]`.
+
+Please include:
+
+- A description of the issue and where it lives (npm package
+  `@reportforge/playwright-pdf`, the `reportforge.org` service, or both).
+- Steps to reproduce, or a proof of concept.
+- The version(s) affected, if known.
+
+Please do **not** open a public GitHub issue for security reports, and do not
+test against production customer data — a trial subscription gives you a full
+legitimate environment to test the license flow.
+
+## What to expect
+
+- **Acknowledgement within 48 hours** of your report.
+- A triage verdict (accepted / not a vulnerability / duplicate) within 7 days.
+- If accepted: a fix or mitigation timeline, and credit in the release notes
+  if you want it. We ask for up to **90 days** of coordinated disclosure
+  before you publish details.
+- We do not currently run a paid bounty program.
+
+## Scope
+
+In scope:
+
+- The npm package `@reportforge/playwright-pdf` (report generation, license
+  client, bundled assets).
+- The `reportforge.org` service: license API, dashboard, checkout, webhooks.
+
+Out of scope:
+
+- Denial of service / volumetric attacks.
+- Reports about the 25-machine licensing cap working as documented.
+- Vulnerabilities exclusively in third-party services we integrate
+  (Razorpay, Clerk, Vercel, Resend) — report those upstream.
+
+## Supported versions
+
+Only the latest published version of `@reportforge/playwright-pdf` receives
+security fixes. Machine-readable contact data is published at
+[`https://reportforge.org/.well-known/security.txt`](https://reportforge.org/.well-known/security.txt).

package/dist/cli/index.js

@@ -42,24 +42,32 @@ var init_cjs_shims = __esm({
 });
 
 // src/utils/logger.ts
-var PREFIX, logger;
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var PREFIX, LEVELS, threshold, logger;
 var init_logger = __esm({
   "src/utils/logger.ts"() {
     "use strict";
     init_cjs_shims();
     PREFIX = "[reportforge]";
+    LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+    threshold = LEVELS.info;
     logger = {
       info(msg) {
+        if (!isLevelEnabled("info")) return;
         console.log(`${PREFIX} ${msg}`);
       },
       warn(msg) {
+        if (!isLevelEnabled("warn")) return;
         console.warn(`${PREFIX} WARN: ${msg}`);
       },
       error(msg) {
+        if (!isLevelEnabled("error")) return;
         console.error(`${PREFIX} ERROR: ${msg}`);
       },
       debug(msg, data) {
-        if (!process.env.RF_DEBUG) return;
+        if (!isLevelEnabled("debug")) return;
         const suffix = data !== void 0 ? `
 ${JSON.stringify(data, null, 2)}` : "";
         console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
@@ -7257,8 +7265,7 @@ var init_BrowserManager = __esm({
       }
       async close() {
         if (this.browser) {
-          await this.browser.close().catch(() => {
-          });
+          await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
           this.browser = void 0;
         }
       }
@@ -7270,7 +7277,8 @@ var init_BrowserManager = __esm({
           const chromeFinder = require_lib2();
           const found = chromeFinder();
           if (found && import_fs3.default.existsSync(found)) return found;
-        } catch {
+        } catch (err) {
+          logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
         }
         const linuxPaths = [
           "/usr/bin/google-chrome",
@@ -7288,12 +7296,14 @@ var init_BrowserManager = __esm({
           }).toString().trim().split("\n")[0];
           if (found && import_fs3.default.existsSync(found)) return found;
         } catch {
+          logger.debug("chrome discovery: which lookup found nothing");
         }
         if (puppeteer.executablePath) {
           try {
             const bundled = puppeteer.executablePath();
             if (bundled && import_fs3.default.existsSync(bundled)) return bundled;
-          } catch {
+          } catch (err) {
+            logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
           }
         }
         logger.warn(
@@ -7315,6 +7325,7 @@ var init_HtmlWriter = __esm({
     import_os = __toESM(require("os"));
     import_path2 = __toESM(require("path"));
     import_crypto = __toESM(require("crypto"));
+    init_logger();
     HtmlWriter = class {
       async write(html) {
         const tmpDir = import_os.default.tmpdir();
@@ -7325,8 +7336,10 @@ var init_HtmlWriter = __esm({
       }
       async cleanup() {
         if (this.tempPath) {
-          await import_fs4.default.promises.unlink(this.tempPath).catch(() => {
-          });
+          const tempPath = this.tempPath;
+          await import_fs4.default.promises.unlink(tempPath).catch(
+            (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+          );
           this.tempPath = void 0;
         }
       }
@@ -7405,7 +7418,8 @@ var init_PdfEncryptor = __esm({
         try {
           (0, import_child_process2.execFileSync)("qpdf", ["--version"], { stdio: "pipe" });
           return true;
-        } catch {
+        } catch (err) {
+          logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
           return false;
         }
       }
@@ -7638,7 +7652,8 @@ var init_PdfGenerator = __esm({
           if (CHARTJS_BUNDLE2) {
             this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
           }
-        } catch {
+        } catch (err) {
+          logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
         }
       }
       /**
@@ -12085,6 +12100,7 @@ var init_schema = __esm({
       reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
       projectName: external_exports.string().optional(),
       open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+      logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
       puppeteerExecutablePath: external_exports.string().optional(),
       serverUrl: external_exports.string().url().optional(),
       compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -12549,7 +12565,7 @@ function parseArgs() {
   const rawTemplate = templateArg?.slice("--template=".length);
   const rawOutput = outputArg?.slice("--output=".length);
   if (rawTemplate && !VALID_TEMPLATES.has(rawTemplate)) {
-    console.warn(`[ReportForge] Unknown template '${rawTemplate}', using 'detailed'. Valid: ${TEMPLATE_IDS.join(", ")}`);
+    console.warn(`[reportforge] Unknown template '${rawTemplate}', using 'detailed'. Valid: ${TEMPLATE_IDS.join(", ")}`);
   }
   const template = rawTemplate && VALID_TEMPLATES.has(rawTemplate) ? rawTemplate : "detailed";
   const outputFile = rawOutput ?? import_path7.default.join("playwright-report", "demo-report.pdf");
@@ -12557,7 +12573,7 @@ function parseArgs() {
 }
 async function run() {
   const { template, outputFile } = parseArgs();
-  console.log("[ReportForge] Generating demo report...");
+  console.log("[reportforge] Generating demo report...");
   console.log(`  Template : ${template}`);
   console.log(`  Output   : ${outputFile}`);
   const reportData = buildDemoReportData(template);
@@ -12568,10 +12584,10 @@ async function run() {
   const paths = await generator.generateAll(reportData, options, DEMO_LICENSE_INFO2);
   if (paths.length > 0) {
     console.log(`
-[ReportForge] Demo report written: ${paths[0]}`);
+[reportforge] Demo report written: ${paths[0]}`);
     console.log("  Open the PDF to preview exactly what ReportForge generates for your Playwright runs.");
   } else {
-    console.warn("\n[ReportForge] Warning: no PDF was written \u2014 check that Chrome is available.");
+    console.warn("\n[reportforge] Warning: no PDF was written \u2014 check that Chrome is available.");
     process.exit(1);
   }
 }
@@ -12581,14 +12597,14 @@ async function runDemo() {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (/chrome|chromium|executable|browser|launcher/i.test(msg)) {
-      console.error("\n[ReportForge] Chrome not found.\n");
+      console.error("\n[reportforge] Chrome not found.\n");
       console.error("  Fix: set PUPPETEER_EXECUTABLE_PATH, e.g.:");
       console.error("    PUPPETEER_EXECUTABLE_PATH=/usr/bin/google-chrome-stable \\");
       console.error("    npx @reportforge/playwright-pdf demo\n");
       console.error(`  Original error: ${msg}`);
     } else {
       console.error(`
-[ReportForge] Demo generation failed: ${msg}`);
+[reportforge] Demo generation failed: ${msg}`);
       if (process.env.RF_DEBUG) console.error(err);
     }
     process.exit(1);
@@ -12648,10 +12664,10 @@ ${rows.join("\n")}
 function exportFeedbackCli() {
   const res = exportFeedback();
   if (res.rowCount === 0) {
-    process.stdout.write("No locally collected failures found (~/.reportforge/*/unclassified.csv).\n");
+    process.stdout.write("[reportforge] No locally collected failures found (~/.reportforge/*/unclassified.csv).\n");
   } else {
     process.stdout.write(
-      `Saved ${res.rowCount} row(s) to ${res.outFile} - tokenized + redacted, LOCAL only.
+      `[reportforge] Saved ${res.rowCount} row(s) to ${res.outFile} - tokenized + redacted, LOCAL only.
 Review it before sharing; there is no upload.
 `
     );

package/dist/index.d.mts

@@ -91,6 +91,16 @@ interface ReporterOptions {
      * @default false
      */
     open?: boolean;
+    /**
+     * Console verbosity for reporter log lines (the `[reportforge]` prefix).
+     * `'silent'` suppresses everything, including error lines — a PDF failure
+     * then surfaces only as a missing file (the reporter never fails the test
+     * run). `'debug'` adds diagnostic detail. The `RF_DEBUG=1` environment
+     * variable always forces `'debug'`, overriding this option (support
+     * escape hatch).
+     * @default 'info'
+     */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
     /**
      * Full path to a Chrome/Chromium executable.
      * Falls back to PUPPETEER_EXECUTABLE_PATH env, then system Chrome discovery.

package/dist/index.d.ts

@@ -91,6 +91,16 @@ interface ReporterOptions {
      * @default false
      */
     open?: boolean;
+    /**
+     * Console verbosity for reporter log lines (the `[reportforge]` prefix).
+     * `'silent'` suppresses everything, including error lines — a PDF failure
+     * then surfaces only as a missing file (the reporter never fails the test
+     * run). `'debug'` adds diagnostic detail. The `RF_DEBUG=1` environment
+     * variable always forces `'debug'`, overriding this option (support
+     * escape hatch).
+     * @default 'info'
+     */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
     /**
      * Full path to a Chrome/Chromium executable.
      * Falls back to PUPPETEER_EXECUTABLE_PATH env, then system Chrome discovery.

package/dist/index.js

@@ -10532,6 +10532,7 @@ var ReporterOptionsSchema = external_exports.object({
   reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
   projectName: external_exports.string().optional(),
   open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+  logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
   puppeteerExecutablePath: external_exports.string().optional(),
   serverUrl: external_exports.string().url().optional(),
   compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -10668,13 +10669,48 @@ var import_fs = __toESM(require("fs"));
 var import_path = __toESM(require("path"));
 var import_os = __toESM(require("os"));
 var import_crypto3 = require("crypto");
+
+// src/utils/logger.ts
+init_cjs_shims();
+var PREFIX = "[reportforge]";
+var LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+var threshold = LEVELS.info;
+function setLogLevel(level) {
+  threshold = LEVELS[level];
+}
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var logger = {
+  info(msg) {
+    if (!isLevelEnabled("info")) return;
+    console.log(`${PREFIX} ${msg}`);
+  },
+  warn(msg) {
+    if (!isLevelEnabled("warn")) return;
+    console.warn(`${PREFIX} WARN: ${msg}`);
+  },
+  error(msg) {
+    if (!isLevelEnabled("error")) return;
+    console.error(`${PREFIX} ERROR: ${msg}`);
+  },
+  debug(msg, data) {
+    if (!isLevelEnabled("debug")) return;
+    const suffix = data !== void 0 ? `
+${JSON.stringify(data, null, 2)}` : "";
+    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
+  }
+};
+
+// src/license/DeviceId.ts
 var DEVICE_FILE = import_path.default.join(import_os.default.homedir(), ".reportforge", "device.json");
 function getStableDeviceId() {
   try {
     const raw = import_fs.default.readFileSync(DEVICE_FILE, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.id && /^[0-9a-f-]{36}$/i.test(parsed.id)) return parsed.id;
-  } catch {
+  } catch (err) {
+    logger.debug("device id: no readable device.json \u2014 creating new id", { error: err.message });
   }
   const id = (0, import_crypto3.randomUUID)();
   try {
@@ -10682,7 +10718,10 @@ function getStableDeviceId() {
     import_fs.default.writeFileSync(DEVICE_FILE, JSON.stringify({ id, createdAt: Date.now() }), {
       mode: 384
     });
-  } catch {
+  } catch (err) {
+    logger.warn(
+      `Could not persist device id (~/.reportforge/device.json) \u2014 this machine may register a new seat on every run: ${err.message}`
+    );
   }
   return id;
 }
@@ -10709,10 +10748,13 @@ function getMachineFingerprint() {
       label: `${ci.provider}/${ci.repo} (CI)`
     };
   }
-  const hostname = safe(() => import_os2.default.hostname()) ?? "unknown-host";
+  const hostname = safe(() => import_os2.default.hostname());
+  if (hostname === void 0) {
+    logger.debug("fingerprint: os.hostname() failed \u2014 label falls back to unknown-host");
+  }
   return {
     hash: sha256Hex(`dev:${getStableDeviceId()}`),
-    label: `${hostname} (dev)`
+    label: `${hostname ?? "unknown-host"} (dev)`
   };
 }
 function detectCiRepo() {
@@ -10754,19 +10796,25 @@ function readCache() {
       if (f.endsWith(".tmp")) {
         try {
           import_fs2.default.unlinkSync(import_path2.default.join(CACHE_DIR, f));
-        } catch {
+        } catch (err) {
+          logger.debug("license cache: stale tmp cleanup failed", { file: f, error: err.message });
         }
       }
     }
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: cache dir not readable (first run?)", { error: err.message });
   }
   try {
     if (!import_fs2.default.existsSync(CACHE_FILE)) return null;
     const raw = import_fs2.default.readFileSync(CACHE_FILE, "utf8");
     const parsed = JSON.parse(raw);
-    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") return null;
+    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") {
+      logger.debug("license cache: malformed entry \u2014 ignoring");
+      return null;
+    }
     return parsed;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: read failed \u2014 treating as no cache", { error: err.message });
     return null;
   }
 }
@@ -10776,13 +10824,15 @@ function writeCache(entry) {
     const tmp = `${CACHE_FILE}.${process.pid}.tmp`;
     import_fs2.default.writeFileSync(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
     import_fs2.default.renameSync(tmp, CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: write failed \u2014 will re-activate next run", { error: err.message });
   }
 }
 function clearCache() {
   try {
     import_fs2.default.unlinkSync(CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: clear failed", { error: err.message });
   }
 }
 
@@ -10801,27 +10851,6 @@ var import_node_crypto = require("crypto");
 init_cjs_shims();
 var MODEL = { "alpha": 1, "labels": ["assertion", "env-config", "flaky-by-retry", "locator-not-found", "navigation", "network", "timeout"], "logLikelihoods": { "assertion": { "NUM": -4.574710978503383, "assertionerror": -4.980176086611547, "be": -4.980176086611547, "cart": -4.980176086611547, "checkout": -4.980176086611547, "com": -4.980176086611547, "dashboard": -4.980176086611547, "deep": -4.980176086611547, "equal": -4.980176086611547, "equality": -4.980176086611547, "error": -4.980176086611547, "expect": -3.5938817254916566, "expected": -3.1083739097099556, "failed": -4.980176086611547, "false": -4.980176086611547, "got": -4.980176086611547, "id": -4.574710978503383, "john": -4.980176086611547, "locator": -4.574710978503383, "login": -4.980176086611547, "must": -4.980176086611547, "page": -4.980176086611547, "pattern": -4.980176086611547, "received": -3.275427994373122, "string": -4.980176086611547, "to": -4.980176086611547, "tobe": -4.980176086611547, "tobetruthy": -4.980176086611547, "toequal": -4.980176086611547, "tohavecount": -4.980176086611547, "tohavetext": -4.980176086611547, "tohavetitle": -4.980176086611547, "tohavevalue": -4.980176086611547, "truthy": -4.980176086611547, "value": -4.980176086611547 }, "env-config": { "NUM": -4.997212273764115, "api": -4.997212273764115, "at": -4.997212273764115, "back": -4.997212273764115, "base": -4.997212273764115, "baseurl": -4.997212273764115, "browsers": -4.997212273764115, "cannot": -4.997212273764115, "ci": -4.997212273764115, "config": -4.304065093204169, "directory": -4.591747165655951, "dotenv": -4.997212273764115, "enoent": -4.997212273764115, "env": -4.591747165655951, "environment": -4.591747165655951, "error": -4.08092154188996, "existent": -4.997212273764115, "failed": -4.997212273764115, "falling": -4.997212273764115, "file": -4.997212273764115, "find": -4.997212273764115, "from": -4.997212273764115, "in": -4.591747165655951, "invalid": -4.997212273764115, "is": -4.997212273764115, "json": -4.591747165655951, "key": -4.997212273764115, "load": -4.997212273764115, "missing": -4.997212273764115, "module": -4.997212273764115, "no": -4.997212273764115, "non": -4.997212273764115, "not": -4.997212273764115, "open": -4.997212273764115, "or": -4.997212273764115, "path": -4.997212273764115, "playwright": -4.591747165655951, "points": -4.997212273764115, "position": -4.997212273764115, "required": -4.997212273764115, "set": -4.997212273764115, "spec": -4.997212273764115, "such": -4.997212273764115, "syntaxerror": -4.997212273764115, "test": -4.997212273764115, "to": -4.304065093204169, "token": -4.997212273764115, "ts": -4.997212273764115, "tsconfig": -4.997212273764115, "undefined": -4.591747165655951, "unexpected": -4.997212273764115, "url": -4.997212273764115, "values": -4.997212273764115, "variable": -4.591747165655951 }, "flaky-by-retry": { "after": -4.58836306767171, "and": -4.993828175779875, "animation": -4.993828175779875, "attempt": -4.07753744390572, "between": -4.993828175779875, "blip": -4.993828175779875, "cause": -4.993828175779875, "change": -4.993828175779875, "click": -4.993828175779875, "code": -4.993828175779875, "commit": -4.993828175779875, "condition": -4.993828175779875, "dependency": -4.993828175779875, "detached": -4.993828175779875, "deterministic": -4.993828175779875, "element": -4.993828175779875, "failed": -4.300680995219929, "fails": -4.993828175779875, "flaky": -4.07753744390572, "green": -4.993828175779875, "in": -4.993828175779875, "intermittent": -4.993828175779875, "locator": -4.993828175779875, "marked": -4.993828175779875, "network": -4.993828175779875, "no": -4.993828175779875, "non": -4.993828175779875, "on": -3.895215887111765, "order": -4.993828175779875, "passed": -3.895215887111765, "quarantined": -4.993828175779875, "race": -4.993828175779875, "reproducible": -4.993828175779875, "rerun": -4.993828175779875, "retry": -4.07753744390572, "runs": -4.993828175779875, "same": -4.993828175779875, "second": -4.993828175779875, "stale": -4.993828175779875, "succeeded": -4.993828175779875, "test": -4.58836306767171, "the": -4.993828175779875, "then": -4.993828175779875, "timeout": -4.993828175779875, "unstable": -4.993828175779875, "with": -4.993828175779875, "without": -4.993828175779875 }, "locator-not-found": { "an": -4.993828175779875, "attached": -4.993828175779875, "btn": -4.993828175779875, "button": -4.58836306767171, "cart": -4.993828175779875, "checkout": -4.993828175779875, "click": -4.993828175779875, "data": -4.993828175779875, "div": -4.993828175779875, "dom": -4.993828175779875, "element": -4.07753744390572, "elements": -4.300680995219929, "error": -4.58836306767171, "find": -4.993828175779875, "for": -4.58836306767171, "found": -4.58836306767171, "getbyrole": -4.993828175779875, "getbytext": -4.993828175779875, "icon": -4.993828175779875, "id": -4.993828175779875, "is": -4.993828175779875, "locator": -4.07753744390572, "matched": -4.993828175779875, "matches": -4.993828175779875, "missing": -4.993828175779875, "mode": -4.58836306767171, "name": -4.993828175779875, "no": -4.58836306767171, "node": -4.993828175779875, "not": -4.58836306767171, "resolved": -4.58836306767171, "save": -4.993828175779875, "selector": -4.58836306767171, "strict": -4.58836306767171, "submit": -4.993828175779875, "testid": -4.993828175779875, "textcontent": -4.993828175779875, "the": -4.58836306767171, "to": -4.07753744390572, "total": -4.993828175779875, "unable": -4.993828175779875, "violation": -4.58836306767171, "waiting": -4.993828175779875, "with": -4.993828175779875, "xpath": -4.993828175779875 }, "navigation": { "NUM": -4.983606621708336, "aborted": -4.983606621708336, "another": -4.983606621708336, "back": -4.983606621708336, "because": -4.578141513600172, "by": -4.578141513600172, "checkout": -4.983606621708336, "context": -4.983606621708336, "crashed": -4.983606621708336, "dashboard": -4.983606621708336, "destroyed": -4.983606621708336, "detached": -4.983606621708336, "entry": -4.983606621708336, "err": -4.578141513600172, "exceeded": -4.983606621708336, "execution": -4.983606621708336, "failed": -4.983606621708336, "frame": -4.578141513600172, "goback": -4.983606621708336, "goto": -4.290459441148391, "history": -4.983606621708336, "home": -4.983606621708336, "interrupted": -4.578141513600172, "is": -4.983606621708336, "likely": -4.983606621708336, "login": -4.983606621708336, "many": -4.983606621708336, "maybe": -4.983606621708336, "most": -4.983606621708336, "navigate": -4.983606621708336, "navigating": -4.983606621708336, "navigation": -3.7308436532129683, "net": -4.578141513600172, "no": -4.983606621708336, "of": -4.983606621708336, "page": -3.884994333040227, "redirects": -4.983606621708336, "timeout": -4.983606621708336, "to": -3.7308436532129683, "too": -4.983606621708336, "waitforurl": -4.983606621708336, "was": -4.578141513600172 }, "network": { "NUM": -4.57126863431241, "URL": -4.283586561860629, "again": -4.976733742420574, "api": -4.976733742420574, "apirequestcontext": -4.976733742420574, "at": -4.976733742420574, "body": -4.976733742420574, "connect": -4.976733742420574, "connection": -4.57126863431241, "disconnected": -4.976733742420574, "eai": -4.976733742420574, "econnrefused": -4.976733742420574, "err": -3.8781214537524646, "error": -4.976733742420574, "failed": -4.283586561860629, "fetch": -4.976733742420574, "fetching": -4.976733742420574, "from": -4.976733742420574, "get": -4.976733742420574, "getaddrinfo": -4.976733742420574, "goto": -4.976733742420574, "hang": -4.976733742420574, "internet": -4.976733742420574, "loading": -4.976733742420574, "name": -4.976733742420574, "net": -3.8781214537524646, "not": -4.976733742420574, "on": -4.976733742420574, "out": -4.976733742420574, "page": -4.57126863431241, "products": -4.976733742420574, "protocol": -4.976733742420574, "reading": -4.976733742420574, "reason": -4.976733742420574, "refused": -4.976733742420574, "request": -4.57126863431241, "resolved": -4.976733742420574, "resource": -4.976733742420574, "response": -4.976733742420574, "route": -4.976733742420574, "socket": -4.976733742420574, "ssl": -4.976733742420574, "timed": -4.976733742420574, "to": -4.976733742420574, "up": -4.976733742420574, "upstream": -4.976733742420574, "while": -4.976733742420574 }, "timeout": { "NUM": -3.4965075614664802, "after": -5.000584958242754, "be": -4.59511985013459, "cart": -5.000584958242754, "click": -5.000584958242754, "element": -5.000584958242754, "event": -5.000584958242754, "exceeded": -3.6142905971228636, "expect": -5.000584958242754, "fill": -5.000584958242754, "for": -3.7478219897473863, "function": -5.000584958242754, "load": -5.000584958242754, "locator": -4.084294226368599, "navigation": -5.000584958242754, "of": -5.000584958242754, "out": -5.000584958242754, "page": -4.59511985013459, "running": -5.000584958242754, "selector": -5.000584958242754, "submit": -5.000584958242754, "test": -4.59511985013459, "timed": -5.000584958242754, "timeout": -3.6142905971228636, "timeouterror": -4.59511985013459, "to": -4.59511985013459, "tobevisible": -5.000584958242754, "visible": -4.59511985013459, "waitforloadstate": -5.000584958242754, "waitforselector": -5.000584958242754, "waiting": -3.7478219897473863, "while": -5.000584958242754 } }, "playwrightVersion": "1.59.1", "priors": { "assertion": -1.9636097261547143, "env-config": -1.9636097261547143, "flaky-by-retry": -1.9636097261547143, "locator-not-found": -1.9636097261547143, "navigation": -1.9636097261547143, "network": -1.9636097261547143, "timeout": -1.845826690498331 }, "totals": { "assertion": 64, "env-config": 69, "flaky-by-retry": 68, "locator-not-found": 68, "navigation": 65, "network": 63, "timeout": 70 }, "version": 1, "vocabSize": 227 };
 
-// src/utils/logger.ts
-init_cjs_shims();
-var PREFIX = "[reportforge]";
-var logger = {
-  info(msg) {
-    console.log(`${PREFIX} ${msg}`);
-  },
-  warn(msg) {
-    console.warn(`${PREFIX} WARN: ${msg}`);
-  },
-  error(msg) {
-    console.error(`${PREFIX} ERROR: ${msg}`);
-  },
-  debug(msg, data) {
-    if (!process.env.RF_DEBUG) return;
-    const suffix = data !== void 0 ? `
-${JSON.stringify(data, null, 2)}` : "";
-    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
-  }
-};
-
 // src/analysis/ModelStore.ts
 var MODEL_SIG_DOMAIN = "reportforge-model-sig:v1\n";
 var testDeps = null;
@@ -11092,9 +11121,16 @@ var LicenseClient = class {
 function verifyCache(verifier, cached, expectedFp) {
   try {
     const payload = verifier.verify(cached.jwt);
-    if (payload.fp !== expectedFp) return null;
+    if (payload.fp !== expectedFp) {
+      logger.debug("license cache rejected: fingerprint mismatch", {
+        cachedFp: payload.fp.slice(0, 12),
+        expectedFp: expectedFp.slice(0, 12)
+      });
+      return null;
+    }
     return payload;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache rejected: JWT verify failed", { error: err.message });
     return null;
   }
 }
@@ -11150,7 +11186,8 @@ function maybePrintUpdateNotice(licenseInfo, currentVersion) {
     logger.info(
       `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
     );
-  } catch {
+  } catch (err) {
+    logger.debug("update notice failed (ignored)", { error: err.message });
   }
 }
 
@@ -12847,8 +12884,7 @@ var BrowserManager = class {
   }
   async close() {
     if (this.browser) {
-      await this.browser.close().catch(() => {
-      });
+      await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
       this.browser = void 0;
     }
   }
@@ -12860,7 +12896,8 @@ var BrowserManager = class {
       const chromeFinder = require_lib2();
       const found = chromeFinder();
       if (found && import_fs6.default.existsSync(found)) return found;
-    } catch {
+    } catch (err) {
+      logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
     }
     const linuxPaths = [
       "/usr/bin/google-chrome",
@@ -12878,12 +12915,14 @@ var BrowserManager = class {
       }).toString().trim().split("\n")[0];
       if (found && import_fs6.default.existsSync(found)) return found;
     } catch {
+      logger.debug("chrome discovery: which lookup found nothing");
     }
     if (puppeteer.executablePath) {
       try {
         const bundled = puppeteer.executablePath();
         if (bundled && import_fs6.default.existsSync(bundled)) return bundled;
-      } catch {
+      } catch (err) {
+        logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
       }
     }
     logger.warn(
@@ -12909,8 +12948,10 @@ var HtmlWriter = class {
   }
   async cleanup() {
     if (this.tempPath) {
-      await import_fs7.default.promises.unlink(this.tempPath).catch(() => {
-      });
+      const tempPath = this.tempPath;
+      await import_fs7.default.promises.unlink(tempPath).catch(
+        (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+      );
       this.tempPath = void 0;
     }
   }
@@ -12975,7 +13016,8 @@ var PdfEncryptor = class {
     try {
       (0, import_child_process3.execFileSync)("qpdf", ["--version"], { stdio: "pipe" });
       return true;
-    } catch {
+    } catch (err) {
+      logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
       return false;
     }
   }
@@ -13132,7 +13174,8 @@ var PdfGenerator = class {
       if (CHARTJS_BUNDLE2) {
         this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
       }
-    } catch {
+    } catch (err) {
+      logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
     }
   }
   /**
@@ -14048,7 +14091,7 @@ function buildWatchUrl(serverUrl, runId, token) {
 }
 function formatLiveBanner(url) {
   const label = "Live Tracker";
-  const link = `Watch live: ${url}`;
+  const link = `[reportforge] Watch live: ${url}`;
   const width = Math.max(label.length, link.length);
   const rule = "\u2500".repeat(width + 2);
   return [rule, ` ${label.padEnd(width)} `, ` ${link.padEnd(width)} `, rule].join("\n");
@@ -14154,8 +14197,9 @@ var PdfReporter = class {
     this.liveSteps = "failed";
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
+    setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.17.0" : "0.x";
+    this.version = true ? "0.19.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14418,8 +14462,9 @@ var PdfReporter = class {
       );
       return;
     }
-    logger.info(`Live Tracker: ${watchUrl}`);
-    console.log(formatLiveBanner(watchUrl));
+    if (isLevelEnabled("info")) {
+      console.log(formatLiveBanner(watchUrl));
+    }
     const isPrimaryShard = !shard || shard.current === 1;
     const notify = this.options.notify;
     if (isPrimaryShard && notify) {

package/dist/index.mjs

@@ -10533,6 +10533,7 @@ var ReporterOptionsSchema = external_exports.object({
   reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
   projectName: external_exports.string().optional(),
   open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
+  logLevel: external_exports.enum(["silent", "error", "warn", "info", "debug"]).optional().default("info"),
   puppeteerExecutablePath: external_exports.string().optional(),
   serverUrl: external_exports.string().url().optional(),
   compressionLevel: external_exports.enum(["auto", "none", "balanced", "max"]).optional().default(DEFAULT_OPTIONS.compressionLevel),
@@ -10669,13 +10670,48 @@ import fs from "fs";
 import path2 from "path";
 import os from "os";
 import { randomUUID } from "crypto";
+
+// src/utils/logger.ts
+init_esm_shims();
+var PREFIX = "[reportforge]";
+var LEVELS = { debug: 10, info: 20, warn: 30, error: 40, silent: 99 };
+var threshold = LEVELS.info;
+function setLogLevel(level) {
+  threshold = LEVELS[level];
+}
+function isLevelEnabled(level) {
+  return LEVELS[level] >= (process.env.RF_DEBUG ? LEVELS.debug : threshold);
+}
+var logger = {
+  info(msg) {
+    if (!isLevelEnabled("info")) return;
+    console.log(`${PREFIX} ${msg}`);
+  },
+  warn(msg) {
+    if (!isLevelEnabled("warn")) return;
+    console.warn(`${PREFIX} WARN: ${msg}`);
+  },
+  error(msg) {
+    if (!isLevelEnabled("error")) return;
+    console.error(`${PREFIX} ERROR: ${msg}`);
+  },
+  debug(msg, data) {
+    if (!isLevelEnabled("debug")) return;
+    const suffix = data !== void 0 ? `
+${JSON.stringify(data, null, 2)}` : "";
+    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
+  }
+};
+
+// src/license/DeviceId.ts
 var DEVICE_FILE = path2.join(os.homedir(), ".reportforge", "device.json");
 function getStableDeviceId() {
   try {
     const raw = fs.readFileSync(DEVICE_FILE, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.id && /^[0-9a-f-]{36}$/i.test(parsed.id)) return parsed.id;
-  } catch {
+  } catch (err) {
+    logger.debug("device id: no readable device.json \u2014 creating new id", { error: err.message });
   }
   const id = randomUUID();
   try {
@@ -10683,7 +10719,10 @@ function getStableDeviceId() {
     fs.writeFileSync(DEVICE_FILE, JSON.stringify({ id, createdAt: Date.now() }), {
       mode: 384
     });
-  } catch {
+  } catch (err) {
+    logger.warn(
+      `Could not persist device id (~/.reportforge/device.json) \u2014 this machine may register a new seat on every run: ${err.message}`
+    );
   }
   return id;
 }
@@ -10710,10 +10749,13 @@ function getMachineFingerprint() {
       label: `${ci.provider}/${ci.repo} (CI)`
     };
   }
-  const hostname = safe(() => os2.hostname()) ?? "unknown-host";
+  const hostname = safe(() => os2.hostname());
+  if (hostname === void 0) {
+    logger.debug("fingerprint: os.hostname() failed \u2014 label falls back to unknown-host");
+  }
   return {
     hash: sha256Hex(`dev:${getStableDeviceId()}`),
-    label: `${hostname} (dev)`
+    label: `${hostname ?? "unknown-host"} (dev)`
   };
 }
 function detectCiRepo() {
@@ -10755,19 +10797,25 @@ function readCache() {
       if (f.endsWith(".tmp")) {
         try {
           fs2.unlinkSync(path3.join(CACHE_DIR, f));
-        } catch {
+        } catch (err) {
+          logger.debug("license cache: stale tmp cleanup failed", { file: f, error: err.message });
         }
       }
     }
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: cache dir not readable (first run?)", { error: err.message });
   }
   try {
     if (!fs2.existsSync(CACHE_FILE)) return null;
     const raw = fs2.readFileSync(CACHE_FILE, "utf8");
     const parsed = JSON.parse(raw);
-    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") return null;
+    if (typeof parsed.jwt !== "string" || typeof parsed.expiresAt !== "number") {
+      logger.debug("license cache: malformed entry \u2014 ignoring");
+      return null;
+    }
     return parsed;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: read failed \u2014 treating as no cache", { error: err.message });
     return null;
   }
 }
@@ -10777,13 +10825,15 @@ function writeCache(entry) {
     const tmp = `${CACHE_FILE}.${process.pid}.tmp`;
     fs2.writeFileSync(tmp, JSON.stringify(entry, null, 2), { mode: 384 });
     fs2.renameSync(tmp, CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: write failed \u2014 will re-activate next run", { error: err.message });
   }
 }
 function clearCache() {
   try {
     fs2.unlinkSync(CACHE_FILE);
-  } catch {
+  } catch (err) {
+    logger.debug("license cache: clear failed", { error: err.message });
   }
 }
 
@@ -10802,27 +10852,6 @@ import { createPublicKey as createPublicKey2, verify as verify2 } from "crypto";
 init_esm_shims();
 var MODEL = { "alpha": 1, "labels": ["assertion", "env-config", "flaky-by-retry", "locator-not-found", "navigation", "network", "timeout"], "logLikelihoods": { "assertion": { "NUM": -4.574710978503383, "assertionerror": -4.980176086611547, "be": -4.980176086611547, "cart": -4.980176086611547, "checkout": -4.980176086611547, "com": -4.980176086611547, "dashboard": -4.980176086611547, "deep": -4.980176086611547, "equal": -4.980176086611547, "equality": -4.980176086611547, "error": -4.980176086611547, "expect": -3.5938817254916566, "expected": -3.1083739097099556, "failed": -4.980176086611547, "false": -4.980176086611547, "got": -4.980176086611547, "id": -4.574710978503383, "john": -4.980176086611547, "locator": -4.574710978503383, "login": -4.980176086611547, "must": -4.980176086611547, "page": -4.980176086611547, "pattern": -4.980176086611547, "received": -3.275427994373122, "string": -4.980176086611547, "to": -4.980176086611547, "tobe": -4.980176086611547, "tobetruthy": -4.980176086611547, "toequal": -4.980176086611547, "tohavecount": -4.980176086611547, "tohavetext": -4.980176086611547, "tohavetitle": -4.980176086611547, "tohavevalue": -4.980176086611547, "truthy": -4.980176086611547, "value": -4.980176086611547 }, "env-config": { "NUM": -4.997212273764115, "api": -4.997212273764115, "at": -4.997212273764115, "back": -4.997212273764115, "base": -4.997212273764115, "baseurl": -4.997212273764115, "browsers": -4.997212273764115, "cannot": -4.997212273764115, "ci": -4.997212273764115, "config": -4.304065093204169, "directory": -4.591747165655951, "dotenv": -4.997212273764115, "enoent": -4.997212273764115, "env": -4.591747165655951, "environment": -4.591747165655951, "error": -4.08092154188996, "existent": -4.997212273764115, "failed": -4.997212273764115, "falling": -4.997212273764115, "file": -4.997212273764115, "find": -4.997212273764115, "from": -4.997212273764115, "in": -4.591747165655951, "invalid": -4.997212273764115, "is": -4.997212273764115, "json": -4.591747165655951, "key": -4.997212273764115, "load": -4.997212273764115, "missing": -4.997212273764115, "module": -4.997212273764115, "no": -4.997212273764115, "non": -4.997212273764115, "not": -4.997212273764115, "open": -4.997212273764115, "or": -4.997212273764115, "path": -4.997212273764115, "playwright": -4.591747165655951, "points": -4.997212273764115, "position": -4.997212273764115, "required": -4.997212273764115, "set": -4.997212273764115, "spec": -4.997212273764115, "such": -4.997212273764115, "syntaxerror": -4.997212273764115, "test": -4.997212273764115, "to": -4.304065093204169, "token": -4.997212273764115, "ts": -4.997212273764115, "tsconfig": -4.997212273764115, "undefined": -4.591747165655951, "unexpected": -4.997212273764115, "url": -4.997212273764115, "values": -4.997212273764115, "variable": -4.591747165655951 }, "flaky-by-retry": { "after": -4.58836306767171, "and": -4.993828175779875, "animation": -4.993828175779875, "attempt": -4.07753744390572, "between": -4.993828175779875, "blip": -4.993828175779875, "cause": -4.993828175779875, "change": -4.993828175779875, "click": -4.993828175779875, "code": -4.993828175779875, "commit": -4.993828175779875, "condition": -4.993828175779875, "dependency": -4.993828175779875, "detached": -4.993828175779875, "deterministic": -4.993828175779875, "element": -4.993828175779875, "failed": -4.300680995219929, "fails": -4.993828175779875, "flaky": -4.07753744390572, "green": -4.993828175779875, "in": -4.993828175779875, "intermittent": -4.993828175779875, "locator": -4.993828175779875, "marked": -4.993828175779875, "network": -4.993828175779875, "no": -4.993828175779875, "non": -4.993828175779875, "on": -3.895215887111765, "order": -4.993828175779875, "passed": -3.895215887111765, "quarantined": -4.993828175779875, "race": -4.993828175779875, "reproducible": -4.993828175779875, "rerun": -4.993828175779875, "retry": -4.07753744390572, "runs": -4.993828175779875, "same": -4.993828175779875, "second": -4.993828175779875, "stale": -4.993828175779875, "succeeded": -4.993828175779875, "test": -4.58836306767171, "the": -4.993828175779875, "then": -4.993828175779875, "timeout": -4.993828175779875, "unstable": -4.993828175779875, "with": -4.993828175779875, "without": -4.993828175779875 }, "locator-not-found": { "an": -4.993828175779875, "attached": -4.993828175779875, "btn": -4.993828175779875, "button": -4.58836306767171, "cart": -4.993828175779875, "checkout": -4.993828175779875, "click": -4.993828175779875, "data": -4.993828175779875, "div": -4.993828175779875, "dom": -4.993828175779875, "element": -4.07753744390572, "elements": -4.300680995219929, "error": -4.58836306767171, "find": -4.993828175779875, "for": -4.58836306767171, "found": -4.58836306767171, "getbyrole": -4.993828175779875, "getbytext": -4.993828175779875, "icon": -4.993828175779875, "id": -4.993828175779875, "is": -4.993828175779875, "locator": -4.07753744390572, "matched": -4.993828175779875, "matches": -4.993828175779875, "missing": -4.993828175779875, "mode": -4.58836306767171, "name": -4.993828175779875, "no": -4.58836306767171, "node": -4.993828175779875, "not": -4.58836306767171, "resolved": -4.58836306767171, "save": -4.993828175779875, "selector": -4.58836306767171, "strict": -4.58836306767171, "submit": -4.993828175779875, "testid": -4.993828175779875, "textcontent": -4.993828175779875, "the": -4.58836306767171, "to": -4.07753744390572, "total": -4.993828175779875, "unable": -4.993828175779875, "violation": -4.58836306767171, "waiting": -4.993828175779875, "with": -4.993828175779875, "xpath": -4.993828175779875 }, "navigation": { "NUM": -4.983606621708336, "aborted": -4.983606621708336, "another": -4.983606621708336, "back": -4.983606621708336, "because": -4.578141513600172, "by": -4.578141513600172, "checkout": -4.983606621708336, "context": -4.983606621708336, "crashed": -4.983606621708336, "dashboard": -4.983606621708336, "destroyed": -4.983606621708336, "detached": -4.983606621708336, "entry": -4.983606621708336, "err": -4.578141513600172, "exceeded": -4.983606621708336, "execution": -4.983606621708336, "failed": -4.983606621708336, "frame": -4.578141513600172, "goback": -4.983606621708336, "goto": -4.290459441148391, "history": -4.983606621708336, "home": -4.983606621708336, "interrupted": -4.578141513600172, "is": -4.983606621708336, "likely": -4.983606621708336, "login": -4.983606621708336, "many": -4.983606621708336, "maybe": -4.983606621708336, "most": -4.983606621708336, "navigate": -4.983606621708336, "navigating": -4.983606621708336, "navigation": -3.7308436532129683, "net": -4.578141513600172, "no": -4.983606621708336, "of": -4.983606621708336, "page": -3.884994333040227, "redirects": -4.983606621708336, "timeout": -4.983606621708336, "to": -3.7308436532129683, "too": -4.983606621708336, "waitforurl": -4.983606621708336, "was": -4.578141513600172 }, "network": { "NUM": -4.57126863431241, "URL": -4.283586561860629, "again": -4.976733742420574, "api": -4.976733742420574, "apirequestcontext": -4.976733742420574, "at": -4.976733742420574, "body": -4.976733742420574, "connect": -4.976733742420574, "connection": -4.57126863431241, "disconnected": -4.976733742420574, "eai": -4.976733742420574, "econnrefused": -4.976733742420574, "err": -3.8781214537524646, "error": -4.976733742420574, "failed": -4.283586561860629, "fetch": -4.976733742420574, "fetching": -4.976733742420574, "from": -4.976733742420574, "get": -4.976733742420574, "getaddrinfo": -4.976733742420574, "goto": -4.976733742420574, "hang": -4.976733742420574, "internet": -4.976733742420574, "loading": -4.976733742420574, "name": -4.976733742420574, "net": -3.8781214537524646, "not": -4.976733742420574, "on": -4.976733742420574, "out": -4.976733742420574, "page": -4.57126863431241, "products": -4.976733742420574, "protocol": -4.976733742420574, "reading": -4.976733742420574, "reason": -4.976733742420574, "refused": -4.976733742420574, "request": -4.57126863431241, "resolved": -4.976733742420574, "resource": -4.976733742420574, "response": -4.976733742420574, "route": -4.976733742420574, "socket": -4.976733742420574, "ssl": -4.976733742420574, "timed": -4.976733742420574, "to": -4.976733742420574, "up": -4.976733742420574, "upstream": -4.976733742420574, "while": -4.976733742420574 }, "timeout": { "NUM": -3.4965075614664802, "after": -5.000584958242754, "be": -4.59511985013459, "cart": -5.000584958242754, "click": -5.000584958242754, "element": -5.000584958242754, "event": -5.000584958242754, "exceeded": -3.6142905971228636, "expect": -5.000584958242754, "fill": -5.000584958242754, "for": -3.7478219897473863, "function": -5.000584958242754, "load": -5.000584958242754, "locator": -4.084294226368599, "navigation": -5.000584958242754, "of": -5.000584958242754, "out": -5.000584958242754, "page": -4.59511985013459, "running": -5.000584958242754, "selector": -5.000584958242754, "submit": -5.000584958242754, "test": -4.59511985013459, "timed": -5.000584958242754, "timeout": -3.6142905971228636, "timeouterror": -4.59511985013459, "to": -4.59511985013459, "tobevisible": -5.000584958242754, "visible": -4.59511985013459, "waitforloadstate": -5.000584958242754, "waitforselector": -5.000584958242754, "waiting": -3.7478219897473863, "while": -5.000584958242754 } }, "playwrightVersion": "1.59.1", "priors": { "assertion": -1.9636097261547143, "env-config": -1.9636097261547143, "flaky-by-retry": -1.9636097261547143, "locator-not-found": -1.9636097261547143, "navigation": -1.9636097261547143, "network": -1.9636097261547143, "timeout": -1.845826690498331 }, "totals": { "assertion": 64, "env-config": 69, "flaky-by-retry": 68, "locator-not-found": 68, "navigation": 65, "network": 63, "timeout": 70 }, "version": 1, "vocabSize": 227 };
 
-// src/utils/logger.ts
-init_esm_shims();
-var PREFIX = "[reportforge]";
-var logger = {
-  info(msg) {
-    console.log(`${PREFIX} ${msg}`);
-  },
-  warn(msg) {
-    console.warn(`${PREFIX} WARN: ${msg}`);
-  },
-  error(msg) {
-    console.error(`${PREFIX} ERROR: ${msg}`);
-  },
-  debug(msg, data) {
-    if (!process.env.RF_DEBUG) return;
-    const suffix = data !== void 0 ? `
-${JSON.stringify(data, null, 2)}` : "";
-    console.log(`${PREFIX} DEBUG: ${msg}${suffix}`);
-  }
-};
-
 // src/analysis/ModelStore.ts
 var MODEL_SIG_DOMAIN = "reportforge-model-sig:v1\n";
 var testDeps = null;
@@ -11093,9 +11122,16 @@ var LicenseClient = class {
 function verifyCache(verifier, cached, expectedFp) {
   try {
     const payload = verifier.verify(cached.jwt);
-    if (payload.fp !== expectedFp) return null;
+    if (payload.fp !== expectedFp) {
+      logger.debug("license cache rejected: fingerprint mismatch", {
+        cachedFp: payload.fp.slice(0, 12),
+        expectedFp: expectedFp.slice(0, 12)
+      });
+      return null;
+    }
     return payload;
-  } catch {
+  } catch (err) {
+    logger.debug("license cache rejected: JWT verify failed", { error: err.message });
     return null;
   }
 }
@@ -11151,7 +11187,8 @@ function maybePrintUpdateNotice(licenseInfo, currentVersion) {
     logger.info(
       `Update available: ${currentVersion} -> ${shown}. Run: npm i -D @reportforge/playwright-pdf@latest`
     );
-  } catch {
+  } catch (err) {
+    logger.debug("update notice failed (ignored)", { error: err.message });
   }
 }
 
@@ -12848,8 +12885,7 @@ var BrowserManager = class {
   }
   async close() {
     if (this.browser) {
-      await this.browser.close().catch(() => {
-      });
+      await this.browser.close().catch((err) => logger.debug("browser close failed (ignored)", { error: err.message }));
       this.browser = void 0;
     }
   }
@@ -12861,7 +12897,8 @@ var BrowserManager = class {
       const chromeFinder = require_lib2();
       const found = chromeFinder();
       if (found && fs7.existsSync(found)) return found;
-    } catch {
+    } catch (err) {
+      logger.debug("chrome discovery: chrome-finder failed", { error: err.message });
     }
     const linuxPaths = [
       "/usr/bin/google-chrome",
@@ -12879,12 +12916,14 @@ var BrowserManager = class {
       }).toString().trim().split("\n")[0];
       if (found && fs7.existsSync(found)) return found;
     } catch {
+      logger.debug("chrome discovery: which lookup found nothing");
     }
     if (puppeteer.executablePath) {
       try {
         const bundled = puppeteer.executablePath();
         if (bundled && fs7.existsSync(bundled)) return bundled;
-      } catch {
+      } catch (err) {
+        logger.debug("chrome discovery: no puppeteer bundled executable", { error: err.message });
       }
     }
     logger.warn(
@@ -12910,8 +12949,10 @@ var HtmlWriter = class {
   }
   async cleanup() {
     if (this.tempPath) {
-      await fs8.promises.unlink(this.tempPath).catch(() => {
-      });
+      const tempPath = this.tempPath;
+      await fs8.promises.unlink(tempPath).catch(
+        (err) => logger.debug("temp HTML cleanup failed (ignored)", { path: tempPath, error: err.message })
+      );
       this.tempPath = void 0;
     }
   }
@@ -12976,7 +13017,8 @@ var PdfEncryptor = class {
     try {
       execFileSync("qpdf", ["--version"], { stdio: "pipe" });
       return true;
-    } catch {
+    } catch (err) {
+      logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
       return false;
     }
   }
@@ -13133,7 +13175,8 @@ var PdfGenerator = class {
       if (CHARTJS_BUNDLE2) {
         this.templateEngine.setChartjsBundle(CHARTJS_BUNDLE2);
       }
-    } catch {
+    } catch (err) {
+      logger.debug("chartjs bundle not available \u2014 charts disabled", { error: err.message });
     }
   }
   /**
@@ -14049,7 +14092,7 @@ function buildWatchUrl(serverUrl, runId, token) {
 }
 function formatLiveBanner(url) {
   const label = "Live Tracker";
-  const link = `Watch live: ${url}`;
+  const link = `[reportforge] Watch live: ${url}`;
   const width = Math.max(label.length, link.length);
   const rule = "\u2500".repeat(width + 2);
   return [rule, ` ${label.padEnd(width)} `, ` ${link.padEnd(width)} `, rule].join("\n");
@@ -14155,8 +14198,9 @@ var PdfReporter = class {
     this.liveSteps = "failed";
     this.liveConsole = false;
     this.options = parseOptions(rawOptions);
+    setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.17.0" : "0.x";
+    this.version = true ? "0.19.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14419,8 +14463,9 @@ var PdfReporter = class {
       );
       return;
     }
-    logger.info(`Live Tracker: ${watchUrl}`);
-    console.log(formatLiveBanner(watchUrl));
+    if (isLevelEnabled("info")) {
+      console.log(formatLiveBanner(watchUrl));
+    }
     const isPrimaryShard = !shard || shard.current === 1;
     const notify = this.options.notify;
     if (isPrimaryShard && notify) {

package/package.json

@@ -1,16 +1,11 @@
 {
   "name": "@reportforge/playwright-pdf",
-  "version": "0.17.0",
+  "version": "0.19.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",
   "homepage": "https://reportforge.org",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/muralidharan92/reportforge"
-  },
   "bugs": {
-    "url": "https://github.com/muralidharan92/reportforge/issues",
     "email": "support@reportforge.org"
   },
   "keywords": [
@@ -30,7 +25,11 @@
     "pdf-generator",
     "ci",
     "puppeteer",
-    "html-to-pdf"
+    "html-to-pdf",
+    "reportforge",
+    "reportforge-playwright-pdf",
+    "report",
+    "forge"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -53,7 +52,8 @@
     "ci-templates",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "SECURITY.md"
   ],
   "scripts": {
     "prebuild": "npm run bundle-chartjs && npm run bundle-fonts && npm run bundle-pubkey && npm run bundle-model && npm run precompile-templates",
@@ -82,14 +82,14 @@
   },
   "peerDependencies": {
     "@playwright/test": ">=1.40.0",
-    "puppeteer-core": ">=21.0.0 <25.0.0"
+    "puppeteer-core": ">=21.0.0 <26.0.0"
   },
   "dependencies": {
     "chrome-finder": "^1.0.7",
     "framer-motion": "^12.40.0",
     "glob": "^13.0.6",
     "handlebars": "^4.7.8",
-    "sharp": "^0.34.5",
+    "sharp": "^0.35.3",
     "zod": "^3.23.8"
   },
   "devDependencies": {
@@ -98,20 +98,20 @@
     "@fontsource/source-serif-pro": "^5.2.5",
     "@playwright/test": "^1.49.0",
     "@types/handlebars": "^4.1.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "^26.1.1",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
-    "@vitest/coverage-v8": "^2.1.0",
+    "@vitest/coverage-v8": "^4.1.10",
     "chart.js": "^4.4.0",
     "eslint": "^9.0.0",
     "prettier": "^3.3.0",
-    "puppeteer-core": "^23.0.0",
+    "puppeteer-core": "^25.3.0",
     "tsup": "^8.3.0",
     "tsx": "^4.19.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.1.0"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   }
 }