pw-sanitizer 0.1.0

package/dist/config/validator.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfig = validateConfig;
+exports.validatePattern = validatePattern;
+exports.validateRule = validateRule;
+const logger_js_1 = require("../logger.js");
+/**
+ * Validates that the config is structurally correct and has meaningful content.
+ *
+ * Checks that at least one of `redact` or `remove` contains actionable
+ * patterns / rules, then validates each pattern and rule individually.
+ * Any violation calls `logger.fatal` which throws immediately.
+ *
+ * @param config - The {@link SanitizerConfig} to validate.
+ * @throws Calls `logger.fatal` (which throws) for any validation failure.
+ */
+function validateConfig(config) {
+    const hasRedact = hasRedactContent(config);
+    const hasRemove = hasRemoveContent(config);
+    if (!hasRedact && !hasRemove) {
+        logger_js_1.logger.fatal('Config has no redact or remove rules. Nothing to do.');
+    }
+    if (config.redact?.patterns) {
+        for (const pattern of config.redact.patterns) {
+            validatePattern(pattern);
+        }
+    }
+    if (config.remove?.rules) {
+        for (const rule of config.remove.rules) {
+            validateRule(rule);
+        }
+    }
+}
+/**
+ * Returns `true` if the config's `redact` section contains at least one
+ * inline pattern or a reference to an external pattern file.
+ *
+ * @param config - The config to inspect.
+ */
+function hasRedactContent(config) {
+    if (!config.redact)
+        return false;
+    const hasInlinePatterns = Array.isArray(config.redact.patterns) && config.redact.patterns.length > 0;
+    const hasPatternFiles = config.redact.patternFiles !== undefined &&
+        (typeof config.redact.patternFiles === 'string'
+            ? config.redact.patternFiles.length > 0
+            : config.redact.patternFiles.length > 0);
+    return hasInlinePatterns || hasPatternFiles;
+}
+/**
+ * Returns `true` if the config's `remove` section contains at least one
+ * inline rule or a reference to an external rule file.
+ *
+ * @param config - The config to inspect.
+ */
+function hasRemoveContent(config) {
+    if (!config.remove)
+        return false;
+    const hasInlineRules = Array.isArray(config.remove.rules) && config.remove.rules.length > 0;
+    const hasRuleFiles = config.remove.ruleFiles !== undefined &&
+        (typeof config.remove.ruleFiles === 'string'
+            ? config.remove.ruleFiles.length > 0
+            : config.remove.ruleFiles.length > 0);
+    return hasInlineRules || hasRuleFiles;
+}
+/**
+ * Validates a single {@link RedactPattern}.
+ *
+ * Ensures that at least one of `key` or `valuePattern` is defined — a pattern
+ * with neither matcher would match nothing and is almost certainly a mistake.
+ *
+ * @param pattern - The pattern to validate.
+ * @throws Calls `logger.fatal` (which throws) if the pattern has no matchers.
+ */
+function validatePattern(pattern) {
+    if (!pattern.key && !pattern.valuePattern) {
+        logger_js_1.logger.fatal(`Pattern "${pattern.id}" must define at least one of: key, valuePattern`);
+    }
+}
+/**
+ * Validates a single {@link RemoveRule}.
+ *
+ * Ensures that at least one matcher field (`stepName`, `selector`, `url`, or
+ * `actionType`) is defined — a rule with no matchers would match every step,
+ * which is almost certainly unintentional.
+ *
+ * @param rule - The rule to validate.
+ * @throws Calls `logger.fatal` (which throws) if the rule has no matchers.
+ */
+function validateRule(rule) {
+    if (!rule.stepName && !rule.selector && !rule.url && !rule.actionType) {
+        logger_js_1.logger.fatal(`Rule "${rule.label}" must define at least one matcher: stepName, selector, url, or actionType`);
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/config/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/config/validator.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import type { SanitizerConfig, ProcessResult } from './config/types.js';
+export type { SanitizerConfig, RedactConfig, RemoveConfig, OutputConfig, ReportingConfig, RedactPattern, RemoveRule, ProcessResult, SanitizationSummary, TraceEvent, TimestampStrategy, RedactionResult, RedactionMatch, WalkResult, StepMatch, RemovalSet, } from './config/types.js';
+export { loadPatternFile } from './redact/pattern-loader.js';
+export { loadRuleFile } from './remove/rule-loader.js';
+/**
+ * Main programmatic entry point for `playwright-sanitizer`.
+ *
+ * Discovers (or uses the provided) configuration, then processes all matching
+ * HTML reports and trace `.zip` files found in the configured directories.
+ *
+ * Typical usage — run after a Playwright test suite from your own script:
+ * ```ts
+ * import { sanitize } from 'playwright-sanitizer';
+ *
+ * await sanitize({
+ *   redact: { patterns: [{ id: 'token', key: 'authorization' }] },
+ *   output: { mode: 'in-place' },
+ * });
+ * ```
+ *
+ * Config resolution (when `configOverride` is omitted):
+ * - Delegates to {@link loadConfig} which auto-discovers `playwright-sanitizer.config.ts`
+ *   (or the `sanitizer` key in `playwright.config.ts`).
+ *
+ * @param configOverride - Optional config object. When provided, skips file-based
+ *   config discovery entirely and uses this object directly.
+ * @returns Array of {@link ProcessResult}s — one entry per file processed.
+ */
+export declare function sanitize(configOverride?: SanitizerConfig): Promise<ProcessResult[]>;
+/**
+ * Sanitizes a single Playwright HTML report file.
+ *
+ * Convenience wrapper around {@link processHtmlReport} for cases where you
+ * need to process one specific file rather than an entire directory.
+ *
+ * @param reportPath - Absolute or relative path to the HTML report file.
+ * @param config     - The full sanitizer configuration to apply.
+ * @returns A {@link ProcessResult} with counts and match details for this file.
+ *
+ * @example
+ * ```ts
+ * import { redactReport } from 'playwright-sanitizer';
+ *
+ * const result = await redactReport('./playwright-report/index.html', {
+ *   redact: { patterns: [{ id: 'auth', key: 'authorization' }] },
+ *   output: { mode: 'copy', dir: './sanitized' },
+ * });
+ * console.log(`Redacted ${result.redactionsApplied} values`);
+ * ```
+ */
+export declare function redactReport(reportPath: string, config: SanitizerConfig): Promise<ProcessResult>;
+/**
+ * Sanitizes a single Playwright trace `.zip` file.
+ *
+ * Convenience wrapper around {@link processTraceFile} for cases where you
+ * need to process one specific file rather than an entire directory.
+ *
+ * @param tracePath - Absolute or relative path to the trace `.zip` file.
+ * @param config    - The full sanitizer configuration to apply.
+ * @returns A {@link ProcessResult} with counts and match details for this file.
+ *
+ * @example
+ * ```ts
+ * import { redactTrace } from 'playwright-sanitizer';
+ *
+ * const result = await redactTrace('./test-results/my-test/trace.zip', {
+ *   redact: { patterns: [{ id: 'cookie', key: /^cookie$/i }] },
+ *   output: { mode: 'side-by-side' },
+ * });
+ * console.log(`Removed ${result.stepsRemoved} steps`);
+ * ```
+ */
+export declare function redactTrace(tracePath: string, config: SanitizerConfig): Promise<ProcessResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAexE,YAAY,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,QAAQ,CAC5B,cAAc,CAAC,EAAE,eAAe,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC,CA8E1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,aAAa,CAAC,CAiBxB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/index.js

@@ -0,0 +1,190 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadRuleFile = exports.loadPatternFile = void 0;
+exports.sanitize = sanitize;
+exports.redactReport = redactReport;
+exports.redactTrace = redactTrace;
+const path = __importStar(require("node:path"));
+const utils_js_1 = require("./utils.js");
+const loader_js_1 = require("./config/loader.js");
+const validator_js_1 = require("./config/validator.js");
+const pattern_registry_js_1 = require("./redact/pattern-registry.js");
+const rule_registry_js_1 = require("./remove/rule-registry.js");
+const html_report_js_1 = require("./processors/html-report.js");
+const trace_file_js_1 = require("./processors/trace-file.js");
+const reporter_js_1 = require("./reporter.js");
+const logger_js_1 = require("./logger.js");
+// Re-export loaders
+var pattern_loader_js_1 = require("./redact/pattern-loader.js");
+Object.defineProperty(exports, "loadPatternFile", { enumerable: true, get: function () { return pattern_loader_js_1.loadPatternFile; } });
+var rule_loader_js_1 = require("./remove/rule-loader.js");
+Object.defineProperty(exports, "loadRuleFile", { enumerable: true, get: function () { return rule_loader_js_1.loadRuleFile; } });
+/**
+ * Main programmatic entry point for `playwright-sanitizer`.
+ *
+ * Discovers (or uses the provided) configuration, then processes all matching
+ * HTML reports and trace `.zip` files found in the configured directories.
+ *
+ * Typical usage — run after a Playwright test suite from your own script:
+ * ```ts
+ * import { sanitize } from 'playwright-sanitizer';
+ *
+ * await sanitize({
+ *   redact: { patterns: [{ id: 'token', key: 'authorization' }] },
+ *   output: { mode: 'in-place' },
+ * });
+ * ```
+ *
+ * Config resolution (when `configOverride` is omitted):
+ * - Delegates to {@link loadConfig} which auto-discovers `playwright-sanitizer.config.ts`
+ *   (or the `sanitizer` key in `playwright.config.ts`).
+ *
+ * @param configOverride - Optional config object. When provided, skips file-based
+ *   config discovery entirely and uses this object directly.
+ * @returns Array of {@link ProcessResult}s — one entry per file processed.
+ */
+async function sanitize(configOverride) {
+    const config = configOverride ?? (await (0, loader_js_1.loadConfig)());
+    (0, logger_js_1.configureLogger)(config.reporting);
+    (0, validator_js_1.validateConfig)(config);
+    if (config.output?.mode === 'in-place') {
+        logger_js_1.logger.warn('in-place mode overwrites originals — ensure files are version-controlled.');
+    }
+    const patterns = config.redact
+        ? await (0, pattern_registry_js_1.buildPatternRegistry)(config.redact)
+        : [];
+    const rules = config.remove
+        ? await (0, rule_registry_js_1.buildRuleRegistry)(config.remove)
+        : [];
+    const results = [];
+    // Process HTML reports
+    if (config.output?.processReports !== false) {
+        const reportDir = config.output?.reportDir ?? './playwright-report';
+        const reportFiles = await (0, utils_js_1.findFiles)(reportDir, '**/*.html');
+        for (const file of reportFiles) {
+            const outputPath = (0, utils_js_1.computeOutputPath)(file, reportDir, config);
+            const result = await (0, html_report_js_1.processHtmlReport)(file, outputPath, config, patterns, rules);
+            results.push(result);
+        }
+    }
+    // Process trace files
+    if (config.output?.processTraces !== false) {
+        const traceDir = config.output?.traceDir ?? './test-results';
+        const traceFiles = await (0, utils_js_1.findFiles)(traceDir, '**/*.zip');
+        for (const file of traceFiles) {
+            const outputPath = (0, utils_js_1.computeOutputPath)(file, traceDir, config);
+            const result = await (0, trace_file_js_1.processTraceFile)(file, outputPath, config, patterns, rules);
+            results.push(result);
+        }
+    }
+    // Summary
+    const showSummary = config.reporting?.summary !== false;
+    if (showSummary || config.reporting?.summaryFile) {
+        const summary = (0, reporter_js_1.generateSummary)(results, config, patterns.length, rules.length, []);
+        if (showSummary) {
+            (0, reporter_js_1.printSummary)(summary);
+        }
+        if (config.reporting?.summaryFile) {
+            (0, reporter_js_1.writeSummaryFile)(summary, config.reporting.summaryFile);
+        }
+    }
+    return results;
+}
+/**
+ * Sanitizes a single Playwright HTML report file.
+ *
+ * Convenience wrapper around {@link processHtmlReport} for cases where you
+ * need to process one specific file rather than an entire directory.
+ *
+ * @param reportPath - Absolute or relative path to the HTML report file.
+ * @param config     - The full sanitizer configuration to apply.
+ * @returns A {@link ProcessResult} with counts and match details for this file.
+ *
+ * @example
+ * ```ts
+ * import { redactReport } from 'playwright-sanitizer';
+ *
+ * const result = await redactReport('./playwright-report/index.html', {
+ *   redact: { patterns: [{ id: 'auth', key: 'authorization' }] },
+ *   output: { mode: 'copy', dir: './sanitized' },
+ * });
+ * console.log(`Redacted ${result.redactionsApplied} values`);
+ * ```
+ */
+async function redactReport(reportPath, config) {
+    (0, logger_js_1.configureLogger)(config.reporting);
+    const patterns = config.redact
+        ? await (0, pattern_registry_js_1.buildPatternRegistry)(config.redact)
+        : [];
+    const rules = config.remove
+        ? await (0, rule_registry_js_1.buildRuleRegistry)(config.remove)
+        : [];
+    const outputPath = (0, utils_js_1.computeOutputPath)(reportPath, path.dirname(reportPath), config);
+    return (0, html_report_js_1.processHtmlReport)(reportPath, outputPath, config, patterns, rules);
+}
+/**
+ * Sanitizes a single Playwright trace `.zip` file.
+ *
+ * Convenience wrapper around {@link processTraceFile} for cases where you
+ * need to process one specific file rather than an entire directory.
+ *
+ * @param tracePath - Absolute or relative path to the trace `.zip` file.
+ * @param config    - The full sanitizer configuration to apply.
+ * @returns A {@link ProcessResult} with counts and match details for this file.
+ *
+ * @example
+ * ```ts
+ * import { redactTrace } from 'playwright-sanitizer';
+ *
+ * const result = await redactTrace('./test-results/my-test/trace.zip', {
+ *   redact: { patterns: [{ id: 'cookie', key: /^cookie$/i }] },
+ *   output: { mode: 'side-by-side' },
+ * });
+ * console.log(`Removed ${result.stepsRemoved} steps`);
+ * ```
+ */
+async function redactTrace(tracePath, config) {
+    (0, logger_js_1.configureLogger)(config.reporting);
+    const patterns = config.redact
+        ? await (0, pattern_registry_js_1.buildPatternRegistry)(config.redact)
+        : [];
+    const rules = config.remove
+        ? await (0, rule_registry_js_1.buildRuleRegistry)(config.remove)
+        : [];
+    const outputPath = (0, utils_js_1.computeOutputPath)(tracePath, path.dirname(tracePath), config);
+    return (0, trace_file_js_1.processTraceFile)(tracePath, outputPath, config, patterns, rules);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,82 @@
+import type { ReportingConfig } from './config/types.js';
+/**
+ * Supported log verbosity levels.
+ *
+ * - `silent` — suppresses all output, including errors
+ * - `normal`  — shows info, warnings, and errors (default)
+ * - `verbose` — shows everything including detailed step-level traces
+ */
+export type LogLevel = 'silent' | 'normal' | 'verbose';
+/**
+ * Overrides the active log level at runtime.
+ *
+ * @param level - The new log level to apply.
+ */
+export declare function setLogLevel(level: LogLevel): void;
+/**
+ * Returns the currently active log level.
+ *
+ * @returns The active {@link LogLevel}.
+ */
+export declare function getLogLevel(): LogLevel;
+/**
+ * Configures the logger from a {@link ReportingConfig} object.
+ * If `config.logLevel` is set, it overrides the current level.
+ *
+ * @param config - Optional reporting configuration. Safe to call with `undefined`.
+ */
+export declare function configureLogger(config?: ReportingConfig): void;
+/**
+ * Singleton logger used throughout the sanitizer.
+ *
+ * All methods are no-ops when the active log level is below the required threshold.
+ * The `fatal` method always emits and then throws — it never returns.
+ *
+ * @example
+ * ```ts
+ * import { logger } from './logger.js';
+ * logger.info('Processing file...');
+ * logger.verbose('Parsed 42 events from trace.json');
+ * logger.warn('Duplicate pattern id "token" — last definition wins');
+ * logger.error('Unexpected structure in report data');
+ * logger.fatal('Config not found'); // throws Error
+ * ```
+ */
+export declare const logger: {
+    /**
+     * Logs an informational message at `normal` level.
+     *
+     * @param message - The message to log, prefixed with `[INFO]`.
+     */
+    info(message: string): void;
+    /**
+     * Logs a warning at `normal` level.
+     *
+     * @param message - The message to log, prefixed with `[WARN]`.
+     */
+    warn(message: string): void;
+    /**
+     * Logs an error at `normal` level.
+     * Suppressed only when log level is `silent`.
+     *
+     * @param message - The message to log, prefixed with `[ERROR]`.
+     */
+    error(message: string): void;
+    /**
+     * Logs a detailed diagnostic message at `verbose` level.
+     * No-op unless the active log level is `verbose`.
+     *
+     * @param message - The message to log, prefixed with `[VERBOSE]`.
+     */
+    verbose(message: string): void;
+    /**
+     * Logs a fatal error and immediately throws an `Error`.
+     * This method **never returns** — the `never` return type is intentional
+     * so TypeScript treats call sites as unreachable.
+     *
+     * @param message - The message to log, prefixed with `[FATAL]`, and used as the thrown error's message.
+     * @throws {Error} Always — the provided message is used as the error message.
+     */
+    fatal(message: string): never;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAIvD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAI9D;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM;IACjB;;;;OAIG;kBACW,MAAM,GAAG,IAAI;IAM3B;;;;OAIG;kBACW,MAAM,GAAG,IAAI;IAM3B;;;;;OAKG;mBACY,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;qBACc,MAAM,GAAG,IAAI;IAM9B;;;;;;;OAOG;mBACY,MAAM,GAAG,KAAK;CAI9B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setLogLevel = setLogLevel;
+exports.getLogLevel = getLogLevel;
+exports.configureLogger = configureLogger;
+let currentLevel = 'normal';
+/**
+ * Overrides the active log level at runtime.
+ *
+ * @param level - The new log level to apply.
+ */
+function setLogLevel(level) {
+    currentLevel = level;
+}
+/**
+ * Returns the currently active log level.
+ *
+ * @returns The active {@link LogLevel}.
+ */
+function getLogLevel() {
+    return currentLevel;
+}
+/**
+ * Configures the logger from a {@link ReportingConfig} object.
+ * If `config.logLevel` is set, it overrides the current level.
+ *
+ * @param config - Optional reporting configuration. Safe to call with `undefined`.
+ */
+function configureLogger(config) {
+    if (config?.logLevel) {
+        currentLevel = config.logLevel;
+    }
+}
+/** Numeric priority for each log level — higher means more verbose. */
+const LEVEL_PRIORITY = {
+    silent: 0,
+    normal: 1,
+    verbose: 2,
+};
+/**
+ * Returns `true` if the current log level is at least as verbose as `requiredLevel`.
+ *
+ * @param requiredLevel - The minimum level needed to emit a message.
+ */
+function shouldLog(requiredLevel) {
+    return LEVEL_PRIORITY[currentLevel] >= LEVEL_PRIORITY[requiredLevel];
+}
+/**
+ * Singleton logger used throughout the sanitizer.
+ *
+ * All methods are no-ops when the active log level is below the required threshold.
+ * The `fatal` method always emits and then throws — it never returns.
+ *
+ * @example
+ * ```ts
+ * import { logger } from './logger.js';
+ * logger.info('Processing file...');
+ * logger.verbose('Parsed 42 events from trace.json');
+ * logger.warn('Duplicate pattern id "token" — last definition wins');
+ * logger.error('Unexpected structure in report data');
+ * logger.fatal('Config not found'); // throws Error
+ * ```
+ */
+exports.logger = {
+    /**
+     * Logs an informational message at `normal` level.
+     *
+     * @param message - The message to log, prefixed with `[INFO]`.
+     */
+    info(message) {
+        if (shouldLog('normal')) {
+            console.log(`[INFO] ${message}`);
+        }
+    },
+    /**
+     * Logs a warning at `normal` level.
+     *
+     * @param message - The message to log, prefixed with `[WARN]`.
+     */
+    warn(message) {
+        if (shouldLog('normal')) {
+            console.warn(`[WARN] ${message}`);
+        }
+    },
+    /**
+     * Logs an error at `normal` level.
+     * Suppressed only when log level is `silent`.
+     *
+     * @param message - The message to log, prefixed with `[ERROR]`.
+     */
+    error(message) {
+        // Errors always print unless silent
+        if (shouldLog('normal')) {
+            console.error(`[ERROR] ${message}`);
+        }
+    },
+    /**
+     * Logs a detailed diagnostic message at `verbose` level.
+     * No-op unless the active log level is `verbose`.
+     *
+     * @param message - The message to log, prefixed with `[VERBOSE]`.
+     */
+    verbose(message) {
+        if (shouldLog('verbose')) {
+            console.log(`[VERBOSE] ${message}`);
+        }
+    },
+    /**
+     * Logs a fatal error and immediately throws an `Error`.
+     * This method **never returns** — the `never` return type is intentional
+     * so TypeScript treats call sites as unreachable.
+     *
+     * @param message - The message to log, prefixed with `[FATAL]`, and used as the thrown error's message.
+     * @throws {Error} Always — the provided message is used as the error message.
+     */
+    fatal(message) {
+        console.error(`[FATAL] ${message}`);
+        throw new Error(message);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";;;AAkBA,kCAEC;AAOD,kCAEC;AAQD,0CAIC;AA9BD,IAAI,YAAY,GAAa,QAAQ,CAAC;AAEtC;;;;GAIG;AACH,SAAgB,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW;IACzB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAwB;IACtD,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrB,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,cAAc,GAA6B;IAC/C,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;CACX,CAAC;AAEF;;;;GAIG;AACH,SAAS,SAAS,CAAC,aAAuB;IACxC,OAAO,cAAc,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,aAAa,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACU,QAAA,MAAM,GAAG;IACpB;;;;OAIG;IACH,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAe;QACnB,oCAAoC;QACpC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAe;QACrB,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF,CAAC"}

package/dist/processors/html-report.d.ts

@@ -0,0 +1,27 @@
+import type { SanitizerConfig, RedactPattern, RemoveRule, ProcessResult } from '../config/types.js';
+/**
+ * Sanitizes a single Playwright HTML report file.
+ *
+ * Processing pipeline:
+ * 1. Read the HTML file from disk.
+ * 2. Extract the embedded `window.__pw_report_data__` JSON blob via regex.
+ * 3. **Redact phase** (if `config.redact` is set and patterns are loaded):
+ *    walk the JSON tree with {@link walkAndRedact} and replace matched values.
+ * 4. **Remove phase** (if `config.remove` is set and rules are loaded):
+ *    extract step events, run {@link findStepsToRemove}, then
+ *    {@link removeSteps} and {@link repairTimestamps}.
+ * 5. Re-serialise the JSON and splice it back into the original HTML.
+ * 6. Write the output according to `config.output.mode`.
+ *
+ * On any unrecoverable parse error, the function logs a warning and returns
+ * an empty {@link ProcessResult} rather than throwing.
+ *
+ * @param inputPath  - Absolute path to the source HTML report file.
+ * @param outputPath - Destination path for the sanitized output.
+ * @param config     - The full sanitizer configuration.
+ * @param patterns   - Pre-built list of redact patterns (from {@link buildPatternRegistry}).
+ * @param rules      - Pre-built list of removal rules (from {@link buildRuleRegistry}).
+ * @returns A {@link ProcessResult} with counts and match details for this file.
+ */
+export declare function processHtmlReport(inputPath: string, outputPath: string, config: SanitizerConfig, patterns: RedactPattern[], rules: RemoveRule[]): Promise<ProcessResult>;
+//# sourceMappingURL=html-report.d.ts.map

package/dist/processors/html-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-report.d.ts","sourceRoot":"","sources":["../../src/processors/html-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,UAAU,EACV,aAAa,EAEd,MAAM,oBAAoB,CAAC;AAoB5B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,aAAa,CAAC,CAgGxB"}