@reportforge/playwright-pdf 0.22.0 → 0.23.0

package/dist/index.js

@@ -1221,13 +1221,13 @@ var require_ast = __commonJS({
         helperExpression: function helperExpression(node) {
           return node.type === "SubExpression" || (node.type === "MustacheStatement" || node.type === "BlockStatement") && !!(node.params && node.params.length || node.hash);
         },
-        scopedId: function scopedId(path16) {
-          return /^\.|this\b/.test(path16.original);
+        scopedId: function scopedId(path15) {
+          return /^\.|this\b/.test(path15.original);
         },
         // an ID is simple if it only has one part, and that part is not
         // `..` or `this`.
-        simpleId: function simpleId(path16) {
-          return path16.parts.length === 1 && !AST.helpers.scopedId(path16) && !path16.depth;
+        simpleId: function simpleId(path15) {
+          return path15.parts.length === 1 && !AST.helpers.scopedId(path15) && !path15.depth;
         }
       }
     };
@@ -2301,12 +2301,12 @@ var require_helpers2 = __commonJS({
         loc
       };
     }
-    function prepareMustache(path16, params, hash, open, strip, locInfo) {
+    function prepareMustache(path15, params, hash, open, strip, locInfo) {
       var escapeFlag = open.charAt(3) || open.charAt(2), escaped = escapeFlag !== "{" && escapeFlag !== "&";
       var decorator = /\*/.test(open);
       return {
         type: decorator ? "Decorator" : "MustacheStatement",
-        path: path16,
+        path: path15,
         params,
         hash,
         escaped,
@@ -2626,9 +2626,9 @@ var require_compiler = __commonJS({
       },
       DecoratorBlock: function DecoratorBlock(decorator) {
         var program = decorator.program && this.compileProgram(decorator.program);
-        var params = this.setupFullMustacheParams(decorator, program, void 0), path16 = decorator.path;
+        var params = this.setupFullMustacheParams(decorator, program, void 0), path15 = decorator.path;
         this.useDecorators = true;
-        this.opcode("registerDecorator", params.length, path16.original);
+        this.opcode("registerDecorator", params.length, path15.original);
       },
       PartialStatement: function PartialStatement(partial) {
         this.usePartial = true;
@@ -2692,46 +2692,46 @@ var require_compiler = __commonJS({
         }
       },
       ambiguousSexpr: function ambiguousSexpr(sexpr, program, inverse) {
-        var path16 = sexpr.path, name = path16.parts[0], isBlock = program != null || inverse != null;
-        this.opcode("getContext", path16.depth);
+        var path15 = sexpr.path, name = path15.parts[0], isBlock = program != null || inverse != null;
+        this.opcode("getContext", path15.depth);
         this.opcode("pushProgram", program);
         this.opcode("pushProgram", inverse);
-        path16.strict = true;
-        this.accept(path16);
+        path15.strict = true;
+        this.accept(path15);
         this.opcode("invokeAmbiguous", name, isBlock);
       },
       simpleSexpr: function simpleSexpr(sexpr) {
-        var path16 = sexpr.path;
-        path16.strict = true;
-        this.accept(path16);
+        var path15 = sexpr.path;
+        path15.strict = true;
+        this.accept(path15);
         this.opcode("resolvePossibleLambda");
       },
       helperSexpr: function helperSexpr(sexpr, program, inverse) {
-        var params = this.setupFullMustacheParams(sexpr, program, inverse), path16 = sexpr.path, name = path16.parts[0];
+        var params = this.setupFullMustacheParams(sexpr, program, inverse), path15 = sexpr.path, name = path15.parts[0];
         if (this.options.knownHelpers[name]) {
           this.opcode("invokeKnownHelper", params.length, name);
         } else if (this.options.knownHelpersOnly) {
           throw new _exception2["default"]("You specified knownHelpersOnly, but used the unknown helper " + name, sexpr);
         } else {
-          path16.strict = true;
-          path16.falsy = true;
-          this.accept(path16);
-          this.opcode("invokeHelper", params.length, path16.original, _ast2["default"].helpers.simpleId(path16));
+          path15.strict = true;
+          path15.falsy = true;
+          this.accept(path15);
+          this.opcode("invokeHelper", params.length, path15.original, _ast2["default"].helpers.simpleId(path15));
         }
       },
-      PathExpression: function PathExpression(path16) {
-        this.addDepth(path16.depth);
-        this.opcode("getContext", path16.depth);
-        var name = path16.parts[0], scoped = _ast2["default"].helpers.scopedId(path16), blockParamId = !path16.depth && !scoped && this.blockParamIndex(name);
+      PathExpression: function PathExpression(path15) {
+        this.addDepth(path15.depth);
+        this.opcode("getContext", path15.depth);
+        var name = path15.parts[0], scoped = _ast2["default"].helpers.scopedId(path15), blockParamId = !path15.depth && !scoped && this.blockParamIndex(name);
         if (blockParamId) {
-          this.opcode("lookupBlockParam", blockParamId, path16.parts);
+          this.opcode("lookupBlockParam", blockParamId, path15.parts);
         } else if (!name) {
           this.opcode("pushContext");
-        } else if (path16.data) {
+        } else if (path15.data) {
           this.options.data = true;
-          this.opcode("lookupData", path16.depth, path16.parts, path16.strict);
+          this.opcode("lookupData", path15.depth, path15.parts, path15.strict);
         } else {
-          this.opcode("lookupOnContext", path16.parts, path16.falsy, path16.strict, scoped);
+          this.opcode("lookupOnContext", path15.parts, path15.falsy, path15.strict, scoped);
         }
       },
       StringLiteral: function StringLiteral(string) {
@@ -3087,16 +3087,16 @@ var require_util = __commonJS({
     }
     exports2.urlGenerate = urlGenerate;
     function normalize(aPath) {
-      var path16 = aPath;
+      var path15 = aPath;
       var url = urlParse(aPath);
       if (url) {
         if (!url.path) {
           return aPath;
         }
-        path16 = url.path;
+        path15 = url.path;
       }
-      var isAbsolute = exports2.isAbsolute(path16);
-      var parts = path16.split(/\/+/);
+      var isAbsolute = exports2.isAbsolute(path15);
+      var parts = path15.split(/\/+/);
       for (var part, up = 0, i = parts.length - 1; i >= 0; i--) {
         part = parts[i];
         if (part === ".") {
@@ -3113,15 +3113,15 @@ var require_util = __commonJS({
           }
         }
       }
-      path16 = parts.join("/");
-      if (path16 === "") {
-        path16 = isAbsolute ? "/" : ".";
+      path15 = parts.join("/");
+      if (path15 === "") {
+        path15 = isAbsolute ? "/" : ".";
       }
       if (url) {
-        url.path = path16;
+        url.path = path15;
         return urlGenerate(url);
       }
-      return path16;
+      return path15;
     }
     exports2.normalize = normalize;
     function join(aRoot, aPath) {
@@ -5924,8 +5924,8 @@ var require_printer = __commonJS({
       return this.accept(sexpr.path) + " " + params + hash;
     };
     PrintVisitor.prototype.PathExpression = function(id) {
-      var path16 = id.parts.join("/");
-      return (id.data ? "@" : "") + "PATH:" + path16;
+      var path15 = id.parts.join("/");
+      return (id.data ? "@" : "") + "PATH:" + path15;
     };
     PrintVisitor.prototype.StringLiteral = function(string) {
       return '"' + string.value + '"';
@@ -6045,7 +6045,7 @@ var require_win32 = __commonJS({
   "node_modules/chrome-finder/lib/win32.js"(exports2, module2) {
     "use strict";
     init_cjs_shims();
-    var path16 = require("path");
+    var path15 = require("path");
     var { canAccess } = require_util2();
     function win32() {
       const installations = [];
@@ -6059,7 +6059,7 @@ var require_win32 = __commonJS({
       const prefixes = [process.env.LOCALAPPDATA, process.env.PROGRAMFILES, process.env["PROGRAMFILES(X86)"]];
       prefixes.forEach((prefix) => suffixes.forEach((suffix) => {
         if (prefix) {
-          const chromePath = path16.join(prefix, suffix);
+          const chromePath = path15.join(prefix, suffix);
           if (canAccess(chromePath)) {
             installations.push(chromePath);
           }
@@ -6077,7 +6077,7 @@ var require_darwin = __commonJS({
     "use strict";
     init_cjs_shims();
     var { execSync: execSync3 } = require("child_process");
-    var path16 = require("path");
+    var path15 = require("path");
     var { canAccess, newLineRegex, sort } = require_util2();
     function darwin() {
       const suffixes = ["/Contents/MacOS/Google Chrome Canary", "/Contents/MacOS/Google Chrome", "/Contents/MacOS/Chromium"];
@@ -6087,7 +6087,7 @@ var require_darwin = __commonJS({
     ${LSREGISTER} -dump | grep -E -i -o '/.+(google chrome( canary)?|chromium)\\.app(\\s|$)' | grep -E -v 'Caches|TimeMachine|Temporary|/Volumes|\\.Trash'
   `).toString().split(newLineRegex).forEach((inst) => {
         suffixes.forEach((suffix) => {
-          const execPath = path16.join(inst.trim(), suffix);
+          const execPath = path15.join(inst.trim(), suffix);
           if (canAccess(execPath)) {
             installations.push(execPath);
           }
@@ -6115,8 +6115,8 @@ var require_linux = __commonJS({
   "node_modules/chrome-finder/lib/linux.js"(exports2, module2) {
     "use strict";
     init_cjs_shims();
-    var { execSync: execSync3, execFileSync: execFileSync2 } = require("child_process");
-    var path16 = require("path");
+    var { execSync: execSync3, execFileSync } = require("child_process");
+    var path15 = require("path");
     var fs16 = require("fs");
     var { canAccess, sort, isExecutable, newLineRegex } = require_util2();
     function findChromeExecutablesForLinuxDesktop(folder) {
@@ -6134,7 +6134,7 @@ var require_linux = __commonJS({
     function linux() {
       let installations = [];
       const desktopInstallationFolders = [
-        path16.join(require("os").homedir(), ".local/share/applications/"),
+        path15.join(require("os").homedir(), ".local/share/applications/"),
         "/usr/share/applications/"
       ];
       desktopInstallationFolders.forEach((folder) => {
@@ -6172,7 +6172,7 @@ var require_linux = __commonJS({
           return;
         }
         try {
-          const chromePath = execFileSync2("which", [executable]).toString().split(newLineRegex)[0];
+          const chromePath = execFileSync("which", [executable]).toString().split(newLineRegex)[0];
           if (canAccess(chromePath)) {
             installations.push(chromePath);
           }
@@ -6749,8 +6749,8 @@ function getErrorMap() {
 // node_modules/zod/v3/helpers/parseUtil.js
 init_cjs_shims();
 var makeIssue = (params) => {
-  const { data, path: path16, errorMaps, issueData } = params;
-  const fullPath = [...path16, ...issueData.path || []];
+  const { data, path: path15, errorMaps, issueData } = params;
+  const fullPath = [...path15, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -6870,11 +6870,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path16, key) {
+  constructor(parent, value, path15, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path16;
+    this._path = path15;
     this._key = key;
   }
   get path() {
@@ -10519,6 +10519,21 @@ var liveConfigSchema = external_exports.object({
   // Debounce window for batched flushes (ms).
   flushMs: external_exports.number().int().min(500).max(1e4).default(2e3)
 }).default({});
+var redactConfigSchema = external_exports.object({
+  enabled: external_exports.boolean().default(false),
+  builtins: external_exports.boolean().default(true),
+  patterns: external_exports.array(
+    external_exports.string().refine((v) => {
+      try {
+        new RegExp(v);
+        return true;
+      } catch {
+        return false;
+      }
+    }, "Each redact.patterns entry must be a valid regular expression")
+  ).default([]),
+  mask: external_exports.string().default("[REDACTED]")
+}).default({});
 var sectionFlagsShape = Object.fromEntries(
   SECTION_KEYS.map((k) => [k, external_exports.boolean().optional()])
 );
@@ -10539,7 +10554,7 @@ var ReporterOptionsSchema = external_exports.object({
   primaryColor: hexColor.optional().default(DEFAULT_OPTIONS.primaryColor),
   accentColor: hexColor.optional().default(DEFAULT_OPTIONS.accentColor),
   watermark: external_exports.string().optional(),
-  pdfPassword: external_exports.string().optional(),
+  pdfPassword: external_exports.string().min(1, "pdfPassword must not be empty. Omit the option (or leave the env var unset) to disable encryption.").optional(),
   reportTitle: external_exports.string().optional().default(DEFAULT_OPTIONS.reportTitle),
   projectName: external_exports.string().optional(),
   open: external_exports.boolean().optional().default(DEFAULT_OPTIONS.open),
@@ -10572,6 +10587,7 @@ var ReporterOptionsSchema = external_exports.object({
   }, "requirementTagPattern must be a valid regular expression").optional().default(DEFAULT_OPTIONS.requirementTagPattern),
   failureAnalysis: failureAnalysisConfigSchema,
   capture: captureConfigSchema,
+  redact: redactConfigSchema,
   live: liveConfigSchema,
   templatePath: external_exports.union([
     external_exports.string().regex(/\.hbs$/, "templatePath must end with .hbs").refine((v) => v.slice(0, -4).trim().length > 0, "templatePath basename must not be empty"),
@@ -12614,7 +12630,7 @@ var ShardMerger = class {
 // src/pdf/PdfGenerator.ts
 init_cjs_shims();
 var import_fs11 = __toESM(require("fs"));
-var import_path8 = __toESM(require("path"));
+var import_path7 = __toESM(require("path"));
 
 // src/templates/engine.ts
 init_cjs_shims();
@@ -13149,49 +13165,38 @@ var ChartRenderer = class {
 
 // src/pdf/PdfEncryptor.ts
 init_cjs_shims();
-var import_child_process3 = require("child_process");
 var import_fs8 = __toESM(require("fs"));
-var import_path5 = __toESM(require("path"));
-var import_os5 = __toESM(require("os"));
-var import_crypto7 = __toESM(require("crypto"));
+var import_pdf_lib = require("@cantoo/pdf-lib");
+var AES256_HEADER_MINOR = "7ext3";
 var PdfEncryptor = class {
   async encrypt(pdfPath, password) {
     if (!password) return;
-    if (!this.isQpdfAvailable()) {
-      logger.warn(
-        "pdfPassword is set but qpdf is not installed \u2014 PDF will NOT be encrypted. Install qpdf: https://qpdf.readthedocs.io/en/stable/installation.html"
-      );
-      return;
-    }
-    const tmpPath = import_path5.default.join(import_os5.default.tmpdir(), `rf-encrypted-${Date.now()}.pdf`);
-    const argFile = import_path5.default.join(import_os5.default.tmpdir(), `rf-qpdf-args-${import_crypto7.default.randomBytes(8).toString("hex")}`);
     try {
-      const args = ["--encrypt", password, password, "256", "--", pdfPath, tmpPath];
-      import_fs8.default.writeFileSync(argFile, args.join("\n"), { mode: 384 });
-      (0, import_child_process3.execFileSync)("qpdf", [`@${argFile}`], { stdio: "pipe" });
-      import_fs8.default.renameSync(tmpPath, pdfPath);
-      logger.info(`PDF encrypted with password.`);
+      const doc = await import_pdf_lib.PDFDocument.load(await import_fs8.default.promises.readFile(pdfPath));
+      doc.context.header = import_pdf_lib.PDFHeader.forVersion(1, AES256_HEADER_MINOR);
+      doc.encrypt({
+        userPassword: password,
+        ownerPassword: password,
+        permissions: { printing: "highResolution", copying: false, modifying: false }
+      });
+      const encryptedBytes = await doc.save();
+      const tmpPath = `${pdfPath}.rf-enc-tmp`;
+      try {
+        await import_fs8.default.promises.writeFile(tmpPath, encryptedBytes);
+        await import_fs8.default.promises.rename(tmpPath, pdfPath);
+      } finally {
+        import_fs8.default.rmSync(tmpPath, { force: true });
+      }
+      logger.info("PDF encrypted with password (AES-256).");
     } catch (e) {
-      throw new Error(`qpdf encryption failed: ${e.message}`);
-    } finally {
-      if (import_fs8.default.existsSync(tmpPath)) import_fs8.default.unlinkSync(tmpPath);
-      import_fs8.default.rmSync(argFile, { force: true });
-    }
-  }
-  isQpdfAvailable() {
-    try {
-      (0, import_child_process3.execFileSync)("qpdf", ["--version"], { stdio: "pipe" });
-      return true;
-    } catch (err) {
-      logger.debug("qpdf probe failed \u2014 treating as not installed", { error: err.message });
-      return false;
+      throw new Error(`PDF encryption failed: ${e.message}`);
     }
   }
 };
 
 // src/filename/FilenameResolver.ts
 init_cjs_shims();
-var import_path6 = __toESM(require("path"));
+var import_path5 = __toESM(require("path"));
 var import_fs9 = __toESM(require("fs"));
 var MAX_BRANCH_LENGTH = 50;
 var FilenameResolver = class {
@@ -13209,8 +13214,8 @@ var FilenameResolver = class {
     const branch = this.sanitiseBranch(ctx.branch);
     const status = ctx.status;
     const resolved = template.replace(/\{date\}/g, date).replace(/\{branch\}/g, branch).replace(/\{status\}/g, status);
-    const absolute = import_path6.default.isAbsolute(resolved) ? resolved : import_path6.default.resolve(process.cwd(), resolved);
-    import_fs9.default.mkdirSync(import_path6.default.dirname(absolute), { recursive: true });
+    const absolute = import_path5.default.isAbsolute(resolved) ? resolved : import_path5.default.resolve(process.cwd(), resolved);
+    import_fs9.default.mkdirSync(import_path5.default.dirname(absolute), { recursive: true });
     return absolute;
   }
   /**
@@ -13222,7 +13227,7 @@ var FilenameResolver = class {
    * // → '/out/2026-report-executive.pdf'
    */
   injectTemplateSuffix(outputPath, suffix) {
-    const ext = import_path6.default.extname(outputPath);
+    const ext = import_path5.default.extname(outputPath);
     const base = outputPath.slice(0, outputPath.length - ext.length);
     return `${base}-${suffix}${ext}`;
   }
@@ -13281,7 +13286,12 @@ var PRESETS = {
 // src/pdf/FailurePaginator.ts
 init_cjs_shims();
 var import_fs10 = __toESM(require("fs"));
-var import_path7 = __toESM(require("path"));
+var import_path6 = __toESM(require("path"));
+function sidecarPathFor(pdfPath) {
+  const dir = import_path6.default.dirname(pdfPath);
+  const base = import_path6.default.basename(pdfPath, import_path6.default.extname(pdfPath));
+  return import_path6.default.join(dir, `${base}-failures.json`);
+}
 var FailurePaginator = class {
   async paginate(failures, maxInline, pdfOutputPath) {
     if (failures.length <= maxInline) {
@@ -13289,7 +13299,7 @@ var FailurePaginator = class {
     }
     const inline = failures.slice(0, maxInline);
     const overflow = failures.slice(maxInline);
-    const sidecarPath = this.sidecarPathFor(pdfOutputPath);
+    const sidecarPath = sidecarPathFor(pdfOutputPath);
     try {
       await import_fs10.default.promises.writeFile(
         sidecarPath,
@@ -13297,7 +13307,7 @@ var FailurePaginator = class {
         "utf8"
       );
       logger.info(
-        `Emitted ${overflow.length} overflow failures \u2192 ${import_path7.default.basename(sidecarPath)}`
+        `Emitted ${overflow.length} overflow failures \u2192 ${import_path6.default.basename(sidecarPath)}`
       );
     } catch (e) {
       logger.warn(`Could not write failure sidecar: ${e.message}`);
@@ -13305,11 +13315,6 @@ var FailurePaginator = class {
     }
     return { inline, overflowCount: overflow.length, sidecarPath };
   }
-  sidecarPathFor(pdfPath) {
-    const dir = import_path7.default.dirname(pdfPath);
-    const base = import_path7.default.basename(pdfPath, import_path7.default.extname(pdfPath));
-    return import_path7.default.join(dir, `${base}-failures.json`);
-  }
   /**
    * Drops the inlined image bytes — a 150-entry overflow would otherwise
    * produce a 40 MB JSON. The path still references the on-disk screenshot
@@ -13324,6 +13329,21 @@ var FailurePaginator = class {
   }
 };
 
+// src/pdf/sidecar-crypto.ts
+init_cjs_shims();
+var import_crypto7 = __toESM(require("crypto"));
+var MAGIC = Buffer.from("RFENC1");
+var SALT_LEN = 16;
+var IV_LEN = 12;
+function encryptSidecar(plain, password) {
+  const salt = import_crypto7.default.randomBytes(SALT_LEN);
+  const key = import_crypto7.default.scryptSync(password, salt, 32, { N: 16384, r: 8, p: 1 });
+  const iv = import_crypto7.default.randomBytes(IV_LEN);
+  const cipher = import_crypto7.default.createCipheriv("aes-256-gcm", key, iv);
+  const enc = Buffer.concat([cipher.update(plain), cipher.final()]);
+  return Buffer.concat([MAGIC, salt, iv, cipher.getAuthTag(), enc]);
+}
+
 // src/pdf/PdfGenerator.ts
 var PdfGenerator = class {
   constructor() {
@@ -13421,7 +13441,7 @@ var PdfGenerator = class {
         const templateId = source.kind === "builtin" ? source.id : "detailed";
         const templateData = { ...data, meta: { ...data.meta, template: templateId } };
         const templateOptions = { ...options, template: templateId };
-        await this.renderPdf(templateData, templateOptions, source, compression, outputPath, page);
+        let { sidecarPath } = await this.renderPdf(templateData, templateOptions, source, compression, outputPath, page);
         const capBytes = (options.maxFileSizeMb ?? 0) * 1024 * 1024;
         if (capBytes > 0) {
           const sizeBytes = (await import_fs11.default.promises.stat(outputPath)).size;
@@ -13431,7 +13451,8 @@ var PdfGenerator = class {
             logger.warn(
               `PDF size ${fmtMb(sizeBytes)} exceeds cap ${fmtMb(capBytes)} \u2014 re-rendering (jpeg-q=${tighter.quality}, max-w=${tighter.maxWidth}px, inline-failures\u2264${tighter.maxInlineFailures}).`
             );
-            await this.renderPdf(templateData, templateOptions, source, tighter, outputPath, page);
+            const retuned = await this.renderPdf(templateData, templateOptions, source, tighter, outputPath, page);
+            sidecarPath = retuned.sidecarPath ?? sidecarPath;
             const finalSize = (await import_fs11.default.promises.stat(outputPath)).size;
             if (finalSize > capBytes) {
               logger.warn(
@@ -13443,7 +13464,36 @@ var PdfGenerator = class {
           }
         }
         if (options.pdfPassword) {
-          await this.pdfEncryptor.encrypt(outputPath, options.pdfPassword);
+          let pdfEncrypted = false;
+          try {
+            await this.pdfEncryptor.encrypt(outputPath, options.pdfPassword);
+            pdfEncrypted = true;
+            if (sidecarPath && import_fs11.default.existsSync(sidecarPath)) {
+              const blob = encryptSidecar(await import_fs11.default.promises.readFile(sidecarPath), options.pdfPassword);
+              await import_fs11.default.promises.writeFile(`${sidecarPath}.enc`, blob);
+              await import_fs11.default.promises.unlink(sidecarPath);
+              logger.info(`Overflow sidecar encrypted \u2192 ${import_path7.default.basename(sidecarPath)}.enc`);
+            } else {
+              const staleSidecarPath = sidecarPathFor(outputPath);
+              if (import_fs11.default.existsSync(staleSidecarPath)) {
+                import_fs11.default.rmSync(staleSidecarPath, { force: true });
+                logger.info(`Removed stale plaintext sidecar: ${import_path7.default.basename(staleSidecarPath)}`);
+              }
+            }
+          } catch (err) {
+            const sidecarTargets = sidecarPath ? [sidecarPath, `${sidecarPath}.enc`] : [];
+            const cleanupTargets = pdfEncrypted ? sidecarTargets : [outputPath, ...sidecarTargets];
+            for (const target of cleanupTargets) {
+              try {
+                import_fs11.default.rmSync(target, { force: true });
+              } catch (cleanupErr) {
+                logger.warn(
+                  `Could not remove leftover file after encryption failure: ${target} (${cleanupErr.message})`
+                );
+              }
+            }
+            throw err;
+          }
         }
         const finalSizeMb = fmtMb((await import_fs11.default.promises.stat(outputPath)).size);
         logger.info(`PDF report generated: ${outputPath} (${finalSizeMb})`);
@@ -13458,17 +13508,17 @@ var PdfGenerator = class {
     if (options.templatePath && options.templatePath.length > 0) {
       const byAbsolutePath = /* @__PURE__ */ new Map();
       for (const p of options.templatePath) {
-        const absolutePath = import_path8.default.isAbsolute(p) ? p : import_path8.default.resolve(process.cwd(), p);
+        const absolutePath = import_path7.default.isAbsolute(p) ? p : import_path7.default.resolve(process.cwd(), p);
         if (!byAbsolutePath.has(absolutePath)) byAbsolutePath.set(absolutePath, p);
       }
       const labelCounts = /* @__PURE__ */ new Map();
       for (const rawPath of byAbsolutePath.values()) {
-        const label = import_path8.default.basename(rawPath, ".hbs");
+        const label = import_path7.default.basename(rawPath, ".hbs");
         labelCounts.set(label, (labelCounts.get(label) ?? 0) + 1);
       }
       const seenPerLabel = /* @__PURE__ */ new Map();
       return Array.from(byAbsolutePath.entries()).map(([absolutePath, rawPath]) => {
-        const baseLabel = import_path8.default.basename(rawPath, ".hbs");
+        const baseLabel = import_path7.default.basename(rawPath, ".hbs");
         let label = baseLabel;
         if ((labelCounts.get(baseLabel) ?? 0) > 1) {
           const n = (seenPerLabel.get(baseLabel) ?? 0) + 1;
@@ -13528,7 +13578,7 @@ var PdfGenerator = class {
       ...data,
       failures: paginated.inline,
       overflowFailureCount: paginated.overflowCount,
-      overflowSidecarName: paginated.sidecarPath ? import_path8.default.basename(paginated.sidecarPath) : void 0
+      overflowSidecarName: paginated.sidecarPath ? import_path7.default.basename(paginated.sidecarPath) + (options.pdfPassword ? ".enc" : "") : void 0
     };
     for (const f of renderData.failures) f.screenshotBase64 = void 0;
     if (options.includeScreenshots !== false) {
@@ -13553,7 +13603,7 @@ var PdfGenerator = class {
       await page.goto(fileUrl, { waitUntil: "domcontentloaded", timeout: 6e4 });
       const showCharts = source.kind === "builtin" ? resolveSections(source.id, options.sections).charts : true;
       await this.chartRenderer.waitForCharts(page, showCharts);
-      logger.info(`Generating PDF \u2192 ${import_path8.default.relative(process.cwd(), outputPath)}`);
+      logger.info(`Generating PDF \u2192 ${import_path7.default.relative(process.cwd(), outputPath)}`);
       await page.pdf({
         path: outputPath,
         format: "A4",
@@ -13563,19 +13613,129 @@ var PdfGenerator = class {
     } finally {
       await this.htmlWriter.cleanup();
     }
+    return { sidecarPath: paginated.overflowCount > 0 ? paginated.sidecarPath : void 0 };
   }
 };
 function fmtMb(bytes) {
   return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
 }
 
+// src/redact/Redactor.ts
+init_cjs_shims();
+var Redactor = class {
+  constructor(opts) {
+    /** Indexes of user patterns disabled after throwing (warned once each). */
+    this.disabled = /* @__PURE__ */ new Set();
+    this.maskRaw = opts.mask;
+    this.maskReplacement = opts.mask.replace(/\$/g, "$$$$");
+    this.useBuiltins = opts.builtins;
+    this.userPatterns = opts.patterns.map((p) => new RegExp(p, "g"));
+  }
+  redactText(s) {
+    if (!s) return s;
+    let out = s;
+    if (this.useBuiltins) out = this.applyBuiltins(out);
+    for (let i = 0; i < this.userPatterns.length; i++) {
+      if (this.disabled.has(i)) continue;
+      try {
+        out = out.replace(this.userPatterns[i], this.maskReplacement);
+      } catch (err) {
+        this.disabled.add(i);
+        logger.warn(
+          `redact: custom pattern #${i + 1} threw and is disabled for this run: ${err.message}`
+        );
+      }
+    }
+    return out;
+  }
+  applyBuiltins(s) {
+    const M = this.maskRaw;
+    const MR = this.maskReplacement;
+    return s.replace(/(\b[a-z][\w+.-]{0,63}:\/\/[^/\s:@]{1,512}:)([^@\s/]{1,512})(?=@)/gi, `$1${MR}`).replace(
+      /\b(?:(authorization\s*[:=]\s*basic\s+)([A-Za-z0-9._~+/=-]{8,})|((?:authorization\s*[:=]\s*)?bearer\s+)([A-Za-z0-9._~+/=-]{8,}))/gi,
+      (fullMatch, basicPrefix, _basicToken, bearerPrefix, bearerToken) => {
+        if (basicPrefix) return `${basicPrefix}${M}`;
+        if (bearerToken && /[^a-z]/.test(bearerToken)) return `${bearerPrefix}${M}`;
+        return fullMatch;
+      }
+    ).replace(/\beyJ[A-Za-z0-9_-]{4,}\.[A-Za-z0-9_-]{4,}\.[A-Za-z0-9_-]{4,}\b/g, MR).replace(
+      /\b(?:AKIA[0-9A-Z]{16}|ghp_[A-Za-z0-9]{16,}|gho_[A-Za-z0-9]{16,}|github_pat_[A-Za-z0-9_]{20,}|xox[baprs]-[A-Za-z0-9-]{10,}|sk-[A-Za-z0-9_-]{16,}|rzp_(?:live|test)_[A-Za-z0-9]{8,}|AIza[A-Za-z0-9_-]{30,})\b/g,
+      MR
+    ).replace(
+      /\b((?:[A-Za-z0-9]{1,32}[_-]){0,8}(?:password|passwd|passcode|pwd|secret|token|api[_-]?key|apikey|auth|authorization|credential|private[_-]?key|access[_-]?key|client[_-]?secret))\b(["']?\s*[=:]\s*)(?!(?:bearer|basic)\b)(?:(["'])((?:(?!\3).){1,512})\3|([^\s"',;&]{1,512}))/gi,
+      (_m, key, sep, q, _quotedVal, _plainVal) => q ? `${key}${sep}${q}${M}${q}` : `${key}${sep}${M}`
+    ).replace(
+      /\b(fill|type|press)\b([^\n]{0,80}?\b(?:password|secret|token|pass|passcode|pin|otp)\b[^\n]{0,80}?\s)(["'])((?:(?!\3).)+)\3/gi,
+      (_m, action, mid, q) => `${action}${mid}${q}${M}${q}`
+    ).replace(/\b([A-Za-z0-9._%+-])[A-Za-z0-9._%+-]{0,63}@([A-Za-z0-9.-]{1,255}\.[A-Za-z]{2,})\b/g, "$1***@$2").replace(/[A-Za-z0-9_+/=-]{20,}/g, (m, offset, str) => {
+      const before = offset > 0 ? str[offset - 1] : " ";
+      const after = offset + m.length < str.length ? str[offset + m.length] : " ";
+      const beforeIsWord = /[A-Za-z0-9_]/.test(before);
+      const afterIsWord = /[A-Za-z0-9_]/.test(after);
+      if (!beforeIsWord && !afterIsWord && /\d/.test(m) && /[A-Za-z]/.test(m)) {
+        return M;
+      }
+      return m;
+    });
+  }
+};
+
+// src/redact/redact-report.ts
+init_cjs_shims();
+function redactReportData(data, r) {
+  const rd = (s) => s === void 0 ? void 0 : r.redactText(s);
+  for (const f of data.failures) {
+    f.testTitle = r.redactText(f.testTitle);
+    f.suitePath = f.suitePath.map((s) => r.redactText(s));
+    f.error.message = r.redactText(f.error.message);
+    f.error.stack = rd(f.error.stack);
+    if (f.execution) {
+      f.execution.steps?.forEach((s) => redactStep(s, r));
+      if (f.execution.failingStep) redactStep(f.execution.failingStep, r);
+      if (f.execution.console) {
+        f.execution.console.stdout = f.execution.console.stdout.map((l) => r.redactText(l));
+        f.execution.console.stderr = f.execution.console.stderr.map((l) => r.redactText(l));
+      }
+    }
+  }
+  for (const p of data.projects) p.suites.forEach((s) => redactSuite(s, r));
+  if (data.analysis) {
+    for (const c of data.analysis.clusters) {
+      c.representativeMessage = r.redactText(c.representativeMessage);
+      c.tests = c.tests.map((t) => r.redactText(t));
+    }
+    data.analysis.oneLiner = r.redactText(data.analysis.oneLiner);
+  }
+  data.classifications?.forEach((c) => c.message = r.redactText(c.message));
+  data.briefSentence = rd(data.briefSentence);
+  data.charts.suiteResults.forEach((s) => s.label = r.redactText(s.label));
+  data.charts.flakinessTable?.forEach((row) => row.title = r.redactText(row.title));
+  data.environment.buildUrl = r.redactText(data.environment.buildUrl);
+}
+function redactStep(s, r) {
+  s.title = r.redactText(s.title);
+  if (s.errorMessage !== void 0) s.errorMessage = r.redactText(s.errorMessage);
+}
+function redactSuite(s, r) {
+  s.title = r.redactText(s.title);
+  for (const t of s.tests) {
+    t.title = r.redactText(t.title);
+    t.fullTitle = r.redactText(t.fullTitle);
+    t.tags = t.tags.map((tag) => r.redactText(tag));
+    t.annotations.forEach((a) => {
+      if (a.description !== void 0) a.description = r.redactText(a.description);
+    });
+  }
+  s.suites.forEach((child) => redactSuite(child, r));
+}
+
 // src/reporter.ts
-var import_path13 = __toESM(require("path"));
+var import_path12 = __toESM(require("path"));
 
 // src/history/HistoryManager.ts
 init_cjs_shims();
 var import_fs12 = __toESM(require("fs"));
-var import_path9 = __toESM(require("path"));
+var import_path8 = __toESM(require("path"));
 var HistoryManager = class {
   constructor(filePath) {
     this.filePath = filePath;
@@ -13596,7 +13756,7 @@ var HistoryManager = class {
   }
   append(entry, maxSize) {
     try {
-      import_fs12.default.mkdirSync(import_path9.default.dirname(this.filePath), { recursive: true });
+      import_fs12.default.mkdirSync(import_path8.default.dirname(this.filePath), { recursive: true });
       const next = {
         version: 1,
         entries: [entry, ...this.read()].slice(0, maxSize)
@@ -13694,14 +13854,14 @@ init_cjs_shims();
 // src/notify/NotificationSender.ts
 init_cjs_shims();
 var import_promises2 = require("fs/promises");
-var import_path12 = require("path");
+var import_path11 = require("path");
 
 // src/notify/formatters/slack.ts
 init_cjs_shims();
 
 // src/notify/formatters/shared.ts
 init_cjs_shims();
-var import_path10 = require("path");
+var import_path9 = require("path");
 function statusLabel(verdict) {
   switch (verdict) {
     case "passed":
@@ -13725,7 +13885,7 @@ function countsLine(stats) {
   return parts.join(" \xB7 ");
 }
 function reportName(pdfPaths, reportTitle) {
-  if (pdfPaths.length > 0) return (0, import_path10.basename)(pdfPaths[0]);
+  if (pdfPaths.length > 0) return (0, import_path9.basename)(pdfPaths[0]);
   return reportTitle || "ReportForge";
 }
 
@@ -13825,7 +13985,7 @@ ${name}`,
 // src/notify/EmailSender.ts
 init_cjs_shims();
 var import_promises = require("fs/promises");
-var import_path11 = require("path");
+var import_path10 = require("path");
 
 // src/notify/formatters/email.ts
 init_cjs_shims();
@@ -13899,7 +14059,7 @@ var EmailSender = class {
       const pdfPath = pdfPaths[0];
       try {
         const content = await (0, import_promises.readFile)(pdfPath);
-        body["attachments"] = [{ filename: (0, import_path11.basename)(pdfPath), content: content.toString("base64") }];
+        body["attachments"] = [{ filename: (0, import_path10.basename)(pdfPath), content: content.toString("base64") }];
       } catch (err) {
         logger.warn(`[notify] email: could not read PDF for attachment: ${err instanceof Error ? err.message : String(err)}`);
       }
@@ -14025,7 +14185,7 @@ var NotificationSender = class {
     }
     const form = new FormData();
     form.append("payload_json", JSON.stringify(payload));
-    form.append("files[0]", new Blob([new Uint8Array(file)], { type: "application/pdf" }), (0, import_path12.basename)(pdfPath));
+    form.append("files[0]", new Blob([new Uint8Array(file)], { type: "application/pdf" }), (0, import_path11.basename)(pdfPath));
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), 3e4);
     try {
@@ -14099,6 +14259,10 @@ var LiveStreamer = class {
   }
   enqueueTest(update) {
     if (!this.enabled) return;
+    if (this.config.redact) {
+      if (update.title !== void 0) update.title = this.config.redact(update.title);
+      if (update.currentStep !== void 0) update.currentStep = this.config.redact(update.currentStep);
+    }
     const prevRetry = this.testStates.get(update.id)?.retry;
     this.testStates.set(update.id, { status: update.status, retry: update.retry ?? prevRetry });
     this.testBuffer.push(update);
@@ -14107,6 +14271,10 @@ var LiveStreamer = class {
   }
   enqueueEvent(event) {
     if (!this.enabled) return;
+    if (this.config.redact) {
+      if (event.title !== void 0) event.title = this.config.redact(event.title);
+      if (event.text !== void 0) event.text = this.config.redact(event.text);
+    }
     event.id = `${this.config.shardKey}:${this.eventSeq++}`;
     this.eventBuffer.push(event);
     this.capPreLicenseBuffer();
@@ -14413,7 +14581,10 @@ var PdfReporter = class {
     this.options = parseOptions(rawOptions);
     setLogLevel(this.options.logLevel);
     this.dataCollector = new DataCollector(this.options.capture);
-    this.version = true ? "0.22.0" : "0.x";
+    if (this.options.redact.enabled) {
+      this.redactor = new Redactor(this.options.redact);
+    }
+    this.version = true ? "0.23.0" : "0.x";
     logger.info(`@reportforge/playwright-pdf v${this.version} initialised`);
     this.licenseClient = new LicenseClient({
       licenseKey: this.options.licenseKey,
@@ -14504,6 +14675,9 @@ var PdfReporter = class {
     const reportData = this._buildReportData(collected, licenseInfo);
     runFailureAnalysis(reportData, this.options, this.cwd);
     reportData.briefSentence = buildBriefSentence(reportData.stats, reportData.analysis, reportData.charts.trend);
+    if (this.redactor) {
+      redactReportData(reportData, this.redactor);
+    }
     let pdfPaths = [];
     try {
       pdfPaths = await this.pdfGenerator.generateAll(reportData, this.options, licenseInfo);
@@ -14535,7 +14709,10 @@ var PdfReporter = class {
     const historyPath = resolveHistoryPath(this.options, this.cwd);
     const hm = new HistoryManager(historyPath);
     const suffix = Math.random().toString(36).padEnd(8, "0").slice(2, 6);
-    const flakyTests = collectFlakyTests(collected.projects);
+    const redactor = this.redactor;
+    const flakyTests = collectFlakyTests(collected.projects).map(
+      (t) => redactor ? { ...t, title: redactor.redactText(t.title) } : t
+    );
     const entry = {
       runId: `${(/* @__PURE__ */ new Date()).toISOString()}-${suffix}`,
       timestamp: Date.now(),
@@ -14675,6 +14852,7 @@ var PdfReporter = class {
     const token = computeWatchToken(runId, this.options.licenseKey);
     const watchUrl = token ? buildWatchUrl(serverUrl, runId, token) : void 0;
     const env = detectCiEnv();
+    if (this.redactor && env?.buildUrl) env.buildUrl = this.redactor.redactText(env.buildUrl);
     if (watchUrl) {
       void this.announceLive(watchUrl, env, shard).catch(() => {
       });
@@ -14689,6 +14867,7 @@ var PdfReporter = class {
       shardKey: this.liveShardKey,
       shardTotal: shard?.total ?? null,
       license: () => this.license(),
+      redact: this.redactor ? (s) => this.redactor.redactText(s) : void 0,
       env,
       flushMs: live.flushMs
     });
@@ -14730,7 +14909,7 @@ var PdfReporter = class {
   }
   resolveProjectName() {
     try {
-      const pkgPath = import_path13.default.resolve(process.cwd(), "package.json");
+      const pkgPath = import_path12.default.resolve(process.cwd(), "package.json");
       const pkg = require(pkgPath);
       return pkg.name ?? "Playwright Tests";
     } catch {
@@ -14780,9 +14959,9 @@ function deriveVerdict(stats) {
 }
 function resolveHistoryPath(options, cwd) {
   if (options.historyFile) {
-    return import_path13.default.isAbsolute(options.historyFile) ? options.historyFile : import_path13.default.resolve(cwd, options.historyFile);
+    return import_path12.default.isAbsolute(options.historyFile) ? options.historyFile : import_path12.default.resolve(cwd, options.historyFile);
   }
-  return import_path13.default.join(resolveProjectDir(options, cwd), "history.json");
+  return import_path12.default.join(resolveProjectDir(options, cwd), "history.json");
 }
 function flattenSuiteNodes(suites) {
   return suites.flatMap((s) => [s, ...flattenSuiteNodes(s.suites)]);