@seontechnologies/playwright-utils 3.10.0

package/dist/types/log/outputs/log-to-file.d.ts

@@ -0,0 +1,23 @@
+import type { LogLevel, LoggingConfig } from '../types';
+/**
+ * Logs a message to the file system, handling both organized and consolidated logging modes.
+ *
+ * This function manages the complete file logging process:
+ * 1. Prepares the message by stripping ANSI codes
+ * 2. Resolves test context information and adds appropriate headers
+ * 3. Determines the proper file path based on logging configuration
+ *    - For organized logs: Creates test-specific log files in dated folders
+ *    - For consolidated logs: Writes to a single shared log file
+ * 4. Formats and writes the message with proper timestamps and context
+ *
+ * The behavior is controlled by the global logging configuration and per-call options.
+ *
+ * @param message - The message content to log to the file
+ * @param _level - The log level (info, debug, etc.) - reserved for future filtering capabilities
+ * @param options - Configuration options that can override global settings:
+ *                  Can use boolean or detailed object configuration for flexibility
+ * @returns Promise<boolean> - Resolves to true if logging was successful, false otherwise
+ */
+export declare function logToFile(message: string, _level?: LogLevel, // not being used at the moment, but for consistent api with console and future proofing
+options?: LoggingConfig): Promise<boolean>;
+//# sourceMappingURL=log-to-file.d.ts.map

package/dist/types/log/outputs/log-to-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-to-file.d.ts","sourceRoot":"","sources":["../../../../src/log/outputs/log-to-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AA8InE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,QAAiB,EAAE,wFAAwF;AACnH,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAoClB"}

package/dist/types/log/test-step.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Method decorator for class methods to wrap them in a test.step with logging
+ *
+ * @param stepName - Optional name for the step, defaults to method name
+ *
+ * @example
+ * // Page object with decorated methods
+ * class MyPage {
+ *   // Uses method name as step name
+ *   @methodTestStep()
+ *   async login() {
+ *     // Method implementation
+ *   }
+ *
+ *   // Custom step name
+ *   @methodTestStep("Search for products")
+ *   async search(term: string) {
+ *     // Method implementation
+ *   }
+ * }
+ *
+ */
+export declare function methodTestStep(stepName?: string): (target: any, // The original method being decorated
+context: ClassMethodDecoratorContext) => (this: any, ...args: any[]) => Promise<any>;
+/**
+ * Function decorator to wrap any function in a test.step with logging
+ *
+ * @param stepName - Name for the step
+ * @param fn - The function to wrap
+ *
+ * @example
+ * // Define a function with the decorator
+ * const searchProducts = functionTestStep("Search for products", async (term: string) => {
+ *   // Function implementation
+ * })
+ *
+ * // Call it normally
+ * const results = await searchProducts("laptop")
+ */
+export declare function functionTestStep<T extends any[], R>(stepName: string, // Unlike methodTestStep, this is required (no method name to fall back to)
+fn: (...args: T) => Promise<R> | R): (...args: T) => Promise<R>;
+//# sourceMappingURL=test-step.d.ts.map

package/dist/types/log/test-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-step.d.ts","sourceRoot":"","sources":["../../../src/log/test-step.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,IAI5C,QAAQ,GAAG,EAAE,sCAAsC;AACnD,SAAS,2BAA2B,MAOI,MAAM,GAAG,EAAE,GAAG,MAAM,GAAG,EAAE,kBA8BpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EACjD,QAAQ,EAAE,MAAM,EAAE,2EAA2E;AAC7F,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAoB5B"}

package/dist/types/log/types.d.ts

@@ -0,0 +1,81 @@
+/** Log level types for different severity of messages */
+export type LogLevel = 'info' | 'step' | 'success' | 'warning' | 'error' | 'debug';
+/** Log level hierarchy for filtering (lowest to highest priority) */
+export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
+/** Options for formatting log messages */
+export type FormatOptions = {
+    timestamps: boolean;
+    colorize: boolean;
+    maxLineLength: number;
+    prefix?: string;
+    addNewLine?: boolean;
+};
+/** Global Configuration options for the logging utility
+ * Supports both simple boolean values and detailed configuration objects */
+export type LoggingConfig = {
+    console?: boolean | {
+        enabled: boolean;
+        colorize?: boolean;
+        timestamps?: boolean;
+    };
+    fileLogging?: boolean | {
+        enabled: boolean;
+        outputDir?: string;
+        defaultTestFolder?: string;
+        stripAnsiCodes?: boolean;
+        timestamp?: boolean;
+        prependTestFile?: boolean;
+        forceConsolidated?: boolean;
+    };
+    workerID?: boolean | {
+        enabled: boolean;
+        format?: string;
+    };
+    sourceFileTracking?: boolean | {
+        enabled: boolean;
+        showInLogs?: boolean;
+    };
+    format?: {
+        prefix?: string;
+        addNewLine?: boolean;
+        maxLineLength?: number;
+    };
+    context?: Record<string, unknown>;
+    testFile?: string;
+    testName?: string;
+    level?: LogLevel;
+    testStep?: boolean | string;
+};
+/** Parameters for the log fixture */
+export type LogParams = {
+    /** Log level to use (info, step, success, warning, error, debug) */
+    level?: LogLevel;
+    /** Message to log */
+    message: string;
+    /** Whether to log to console (simplified boolean option for backward compatibility) */
+    console?: boolean;
+    /** Additional options for more complex logging configuration */
+    options?: Partial<LoggingConfig>;
+    /** Test file name for file logging context */
+    testFile?: string;
+    /** Test name for file logging context */
+    testName?: string;
+};
+export type LogContext = {
+    config: LoggingConfig;
+    options: LoggingConfig;
+    testFile?: string;
+    testName?: string;
+    workerIDEnabled: boolean;
+    workerIDFormat: string;
+};
+/** Configuration for formatting messages based on log level */
+type FormatConfig = {
+    prefix: string;
+    suffix: string;
+    color: string;
+};
+/** Map of log levels to their formatting configuration */
+export type FormatConfigMap = Record<LogLevel, FormatConfig>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/log/types.d.ts.map

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

package/dist/types/log/utils/async.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wraps a synchronous function in a Promise and resolves after I/O processing
+ * Used for asynchronous console logging
+ */
+export declare const asPromise: (fn: () => void) => Promise<void>;
+//# sourceMappingURL=async.d.ts.map

package/dist/types/log/utils/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../../src/log/utils/async.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAMnD,CAAA"}

package/dist/types/log/utils/flag.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Utility function to extract boolean flag values from various formats.
+ * Used to standardize how boolean flags are handled across the logging system.
+ *
+ * @param flag - The flag value which can be a boolean, an object with an enabled property, or undefined
+ * @param defaultValue - The default value to use if flag is undefined or doesn't have an enabled property
+ * @returns A single boolean value
+ */
+export declare function isEnabled(flag: boolean | {
+    enabled?: boolean;
+} | undefined, defaultValue?: boolean): boolean;
+//# sourceMappingURL=flag.d.ts.map

package/dist/types/log/utils/flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flag.d.ts","sourceRoot":"","sources":["../../../../src/log/utils/flag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EACjD,YAAY,UAAO,GAClB,OAAO,CAIT"}

package/dist/types/log/utils/options.d.ts

@@ -0,0 +1,14 @@
+/** Options handling for the logging system */
+import type { LogLevel, LoggingConfig } from '../types';
+export declare const defaultLoggingConfig: LoggingConfig;
+/** Get level-specific formatting options */
+export declare const getLevelFormatOptions: (level: LogLevel) => Record<string, unknown>;
+/** Merge default options with per-call options and format options for the specific log level */
+export declare const mergeOptions: (options: Partial<LoggingConfig> | undefined, level: LogLevel) => LoggingConfig;
+/** Convert a unified configuration to LoggingConfig format
+ * This ensures we can still use the simple LoggingConfig interface with booleans */
+export declare const toLoggingConfig: (config: Partial<LoggingConfig>) => Partial<LoggingConfig>;
+/** Unified configuration function that handles both global and local settings
+ * Always uses global scope by default, regardless of context */
+export declare const configure: (options: Partial<LoggingConfig>, scope?: "global" | "local") => void;
+//# sourceMappingURL=options.d.ts.map

package/dist/types/log/utils/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/log/utils/options.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAIvD,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAA;AAED,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,GAChC,OAAO,QAAQ,KACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAWxB,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,YAAY,GACvB,SAAS,OAAO,CAAC,aAAa,CAAC,YAAK,EACpC,OAAO,QAAQ,KACd,aAaF,CAAA;AAED;oFACoF;AACpF,eAAO,MAAM,eAAe,GAC1B,QAAQ,OAAO,CAAC,aAAa,CAAC,KAC7B,OAAO,CAAC,aAAa,CA2BvB,CAAA;AAED;gEACgE;AAChE,eAAO,MAAM,SAAS,GACpB,SAAS,OAAO,CAAC,aAAa,CAAC,EAC/B,QAAO,QAAQ,GAAG,OAAkB,KACnC,IAeF,CAAA"}

package/dist/types/log/utils/playwright-step-utils.d.ts

@@ -0,0 +1,5 @@
+/** The main purpose is to make it possible to use Playwright's step reporting
+ * in both test and non-test contexts without causing errors. */
+/** Attempts to execute a Playwright test step if the test API is available */
+export declare const tryPlaywrightStep: (stepMessage: string) => Promise<void>;
+//# sourceMappingURL=playwright-step-utils.d.ts.map

package/dist/types/log/utils/playwright-step-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-step-utils.d.ts","sourceRoot":"","sources":["../../../../src/log/utils/playwright-step-utils.ts"],"names":[],"mappings":"AAAA;gEACgE;AA2ChE,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,GAAU,aAAa,MAAM,KAAG,OAAO,CAAC,IAAI,CAIzE,CAAA"}

package/dist/types/network-error-monitor/fixtures.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Network error monitoring fixture for Playwright tests.
+ *
+ * Automatically monitors all network responses during test execution and fails
+ * the test if any HTTP 4xx/5xx errors are detected (with configurable exclusions).
+ *
+ * This fixture is auto-enabled for all tests that use merged-fixtures.ts.
+ * Inspired by Checkly's network monitoring pattern with SEON-specific enhancements.
+ *
+ * @see https://github.com/checkly/checkly-playwright-examples/tree/main/network-monitoring
+ */
+import type { Page, TestInfo } from '@playwright/test';
+type NetworkErrorMonitorFixture = {
+    /** Automatically monitors network responses for errors */
+    networkErrorMonitor: void;
+};
+type NetworkErrorMonitorConfig = {
+    /** Regex patterns for URLs to exclude from error monitoring */
+    excludePatterns?: RegExp[];
+    /**
+     * Maximum number of tests that can fail per unique error pattern.
+     * Once this limit is reached, subsequent tests just log the error without failing.
+     * Default: Infinity (all tests fail)
+     * @example maxTestsPerError: 1 // Only first test fails, rest just log
+     */
+    maxTestsPerError?: number;
+};
+/**
+ * Creates a network error monitoring fixture with configurable exclusion patterns and fail-fast behavior.
+ *
+ * @param config - Configuration options
+ * @param config.excludePatterns - Regex patterns for URLs to exclude from monitoring
+ * @param config.maxTestsPerError - Maximum tests that can fail per error pattern (prevents domino effect). Default: Infinity
+ * @returns Fixture configuration object
+ *
+ * @example
+ * ```typescript
+ * // With custom exclusions
+ * import { test as base } from '@playwright/test';
+ * import { createNetworkErrorMonitorFixture } from '@seontechnologies/playwright-utils/network-error-monitor/fixtures';
+ *
+ * export const test = base.extend(
+ *   createNetworkErrorMonitorFixture({
+ *     excludePatterns: [
+ *       /sentry\.io\/api/,
+ *       /analytics/,
+ *     ],
+ *     maxTestsPerError: 1  // Only first test fails per error pattern, rest just log
+ *   })
+ * );
+ * ```
+ */
+export declare function createNetworkErrorMonitorFixture(config?: NetworkErrorMonitorConfig): {
+    networkErrorMonitor: ((({ page }: {
+        page: Page;
+    }, use: (r?: void) => Promise<void>, testInfo: TestInfo) => Promise<void>) | {
+        auto: boolean;
+    })[];
+};
+/**
+ * Default network error monitoring fixture with no exclusions.
+ *
+ * Features:
+ * - Automatic activation (auto: true) - no test changes required
+ * - Captures all HTTP 4xx/5xx responses during test execution
+ * - Deduplicates errors (same status + URL reported once)
+ * - Attaches structured JSON artifact to test report on failure
+ * - Fails test with clear error message if network errors detected
+ * - Uses try/finally to ensure error checking runs even if test fails early
+ *
+ * @example
+ * ```typescript
+ * import { test } from '@seontechnologies/playwright-utils/network-error-monitor/fixtures';
+ *
+ * // Normal test - network monitoring happens automatically
+ * test('my test', async ({ page }) => {
+ *   await page.goto('/dashboard');
+ * });
+ *
+ * // Opt out for tests that expect 4xx/5xx errors (e.g., validation testing)
+ * test('validation returns 400',
+ *   { annotation: [{ type: 'skipNetworkMonitoring' }] },
+ *   async ({ page }) => {
+ *     // Test can now expect 400/500 responses without failing
+ *   }
+ * );
+ * ```
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & NetworkErrorMonitorFixture, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from '@playwright/test';
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/types/network-error-monitor/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/network-error-monitor/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAY,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAmBhE,KAAK,0BAA0B,GAAG;IAChC,0DAA0D;IAC1D,mBAAmB,EAAE,IAAI,CAAA;CAC1B,CAAA;AAED,KAAK,yBAAyB,GAAG;IAC/B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAoMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,GAAE,yBAA8B;sCAOtB;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,OACnB,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,YACtB,QAAQ;;;EAoFzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,eAAO,MAAM,IAAI,0QAGhB,CAAA;AAED,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/types/network-recorder/core/har-builder.d.ts

@@ -0,0 +1,122 @@
+/**
+ * HAR format builder for manual network recording
+ *
+ * This module creates HAR (HTTP Archive) format data from intercepted network requests
+ * following the HAR 1.2 specification
+ */
+import type { APIResponse, Request, Response } from '@playwright/test';
+export interface HarEntry {
+    startedDateTime: string;
+    time: number;
+    request: {
+        method: string;
+        url: string;
+        httpVersion: string;
+        cookies: Array<{
+            name: string;
+            value: string;
+        }>;
+        headers: Array<{
+            name: string;
+            value: string;
+        }>;
+        queryString: Array<{
+            name: string;
+            value: string;
+        }>;
+        postData?: {
+            mimeType: string;
+            text?: string;
+            params?: Array<{
+                name: string;
+                value: string;
+            }>;
+        };
+        headersSize: number;
+        bodySize: number;
+    };
+    response: {
+        status: number;
+        statusText: string;
+        httpVersion: string;
+        cookies: Array<{
+            name: string;
+            value: string;
+        }>;
+        headers: Array<{
+            name: string;
+            value: string;
+        }>;
+        content: {
+            size: number;
+            mimeType: string;
+            text?: string;
+            encoding?: string;
+        };
+        redirectURL: string;
+        headersSize: number;
+        bodySize: number;
+    };
+    cache: {
+        beforeRequest?: {
+            lastAccess: string;
+            eTag: string;
+            hitCount: number;
+        };
+        afterRequest?: {
+            lastAccess: string;
+            eTag: string;
+            hitCount: number;
+        };
+    };
+    timings: {
+        blocked: number;
+        dns: number;
+        connect: number;
+        send: number;
+        wait: number;
+        receive: number;
+        ssl: number;
+    };
+}
+export interface HarLog {
+    version: string;
+    creator: {
+        name: string;
+        version: string;
+    };
+    browser?: {
+        name: string;
+        version: string;
+    };
+    pages: Array<{
+        startedDateTime: string;
+        id: string;
+        title: string;
+        pageTimings: {
+            onContentLoad?: number;
+            onLoad?: number;
+        };
+    }>;
+    entries: HarEntry[];
+}
+export interface HarFile {
+    log: HarLog;
+}
+/**
+ * Creates an empty HAR file structure
+ */
+export declare function createHarFile(): HarFile;
+/**
+ * Converts a Playwright request to HAR format
+ */
+export declare function requestToHarEntry(request: Request, response: Response | APIResponse | null, startTime: number, endTime: number): Promise<HarEntry>;
+/**
+ * Adds a page entry to the HAR file
+ */
+export declare function addPageToHar(har: HarFile, pageId: string, title: string): void;
+/**
+ * Adds an entry to the HAR file
+ */
+export declare function addEntryToHar(har: HarFile, entry: HarEntry): void;
+//# sourceMappingURL=har-builder.d.ts.map

package/dist/types/network-recorder/core/har-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-builder.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/har-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEtE,MAAM,WAAW,QAAQ;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,EAAE,MAAM,CAAA;QACX,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC/C,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC/C,WAAW,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QACnD,QAAQ,CAAC,EAAE;YACT,QAAQ,EAAE,MAAM,CAAA;YAChB,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,MAAM,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAChD,CAAA;QACD,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC/C,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;QAC/C,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAA;YACZ,QAAQ,EAAE,MAAM,CAAA;YAChB,IAAI,CAAC,EAAE,MAAM,CAAA;YACb,QAAQ,CAAC,EAAE,MAAM,CAAA;SAClB,CAAA;QACD,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,KAAK,EAAE;QACL,aAAa,CAAC,EAAE;YACd,UAAU,EAAE,MAAM,CAAA;YAClB,IAAI,EAAE,MAAM,CAAA;YACZ,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAA;QACD,YAAY,CAAC,EAAE;YACb,UAAU,EAAE,MAAM,CAAA;YAClB,IAAI,EAAE,MAAM,CAAA;YACZ,QAAQ,EAAE,MAAM,CAAA;SACjB,CAAA;KACF,CAAA;IACD,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,EAAE,MAAM,CAAA;QACX,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,EAAE,MAAM,CAAA;KACZ,CAAA;CACF;AAED,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,KAAK,EAAE,KAAK,CAAC;QACX,eAAe,EAAE,MAAM,CAAA;QACvB,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE;YACX,aAAa,CAAC,EAAE,MAAM,CAAA;YACtB,MAAM,CAAC,EAAE,MAAM,CAAA;SAChB,CAAA;KACF,CAAC,CAAA;IACF,OAAO,EAAE,QAAQ,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAYvC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,EACvC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CAwHnB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjE"}

package/dist/types/network-recorder/core/har-manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * HAR file management utilities for network traffic recording and playback
+ *
+ * This module provides utilities for:
+ * - Generating HAR file paths based on test context
+ * - Creating HAR directories
+ * - Validating HAR files for playback
+ * - Managing concurrent test safety with file locking
+ */
+import type { TestInfo } from '@playwright/test';
+import type { HarFileOptions } from './types';
+/**
+ * Generates a HAR file path for a given test
+ *
+ * @param testInfo - Playwright test info
+ * @param options - HAR file options
+ * @returns HAR file path
+ */
+export declare function generateHarFilePath(testInfo: TestInfo, options?: HarFileOptions): string;
+/**
+ * Ensures HAR directory exists for the given file path
+ *
+ * @param harFilePath - HAR file path
+ */
+export declare function ensureHarDirectory(harFilePath: string): Promise<void>;
+/**
+ * Validates that a HAR file exists and is readable for playback
+ *
+ * @param harFilePath - HAR file path
+ * @returns true if HAR file is valid for playback
+ */
+export declare function validateHarFileForPlayback(harFilePath: string): Promise<boolean>;
+/**
+ * Acquires a lock for HAR file operations to ensure concurrent test safety
+ *
+ * @param harFilePath - HAR file path
+ * @returns Promise that resolves to a release function
+ */
+export declare function acquireHarFileLock(harFilePath: string): Promise<() => Promise<void>>;
+/**
+ * Removes a HAR file and its lock file
+ *
+ * @param harFilePath - HAR file path
+ */
+export declare function removeHarFile(harFilePath: string): Promise<void>;
+/**
+ * Creates a unique HAR file path to avoid conflicts
+ *
+ * @param basePath - Base HAR file path
+ * @returns Unique HAR file path
+ */
+export declare function createUniqueHarFilePath(basePath: string): string;
+/**
+ * Gets HAR file stats and metadata
+ *
+ * @param harFilePath - HAR file path
+ * @returns HAR file metadata
+ */
+export declare function getHarFileStats(harFilePath: string): Promise<{
+    exists: boolean;
+    size: number;
+    modified: Date;
+    entriesCount: any;
+    version: any;
+    error?: undefined;
+} | {
+    exists: boolean;
+    size: number;
+    modified: null;
+    entriesCount: number;
+    version: string;
+    error: string;
+}>;
+//# sourceMappingURL=har-manager.d.ts.map

package/dist/types/network-recorder/core/har-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-manager.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/har-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAW7C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,cAAmB,GAC3B,MAAM,CAwBR;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB3E;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAoBlB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAiC9B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BtE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMhE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;GAuBxD"}

package/dist/types/network-recorder/core/har-playback-handler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Custom HAR playback handler that ignores authorization headers
+ */
+import type { BrowserContext } from '@playwright/test';
+import type { HarPlaybackOptions } from './types';
+/**
+ * Main setup function for custom HAR playback
+ */
+export declare function setupCustomHarPlayback(context: BrowserContext, harFilePath: string, options?: HarPlaybackOptions): Promise<void>;
+//# sourceMappingURL=har-playback-handler.d.ts.map

package/dist/types/network-recorder/core/har-playback-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-playback-handler.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/har-playback-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,kBAAkB,CAAA;AAG7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AA0XjD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/types/network-recorder/core/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core network recorder exports
+ */
+export { NetworkRecorder, createNetworkRecorder } from './network-recorder';
+export { generateHarFilePath, ensureHarDirectory, validateHarFileForPlayback, acquireHarFileLock, removeHarFile, createUniqueHarFilePath, getHarFileStats } from './har-manager';
+export { detectNetworkMode, isValidNetworkMode, getEffectiveNetworkMode, isNetworkModeActive, getModeDefaults, validateModeConfiguration, getModeDescription } from './mode-detector';
+export { createHarFile, requestToHarEntry, addPageToHar, addEntryToHar } from './har-builder';
+export type * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/network-recorder/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,eAAe,EAChB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACd,MAAM,eAAe,CAAA;AAGtB,mBAAmB,SAAS,CAAA"}

package/dist/types/network-recorder/core/mode-detector.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Network mode detection utilities
+ *
+ * This module provides utilities for:
+ * - Detecting network recording mode from environment variables
+ * - Validating mode configuration
+ * - Providing mode-specific defaults
+ */
+import type { NetworkMode, NetworkRecorderConfig } from './types';
+/**
+ * Detects network mode from environment variable
+ *
+ * @param envVar - Environment variable name (defaults to PW_NET_MODE)
+ * @returns Detected network mode
+ */
+export declare function detectNetworkMode(envVar?: string): NetworkMode;
+/**
+ * Type guard to check if a string is a valid network mode
+ *
+ * @param mode - Mode string to validate
+ * @returns true if mode is valid
+ */
+export declare function isValidNetworkMode(mode: string): mode is NetworkMode;
+/**
+ * Gets the effective network mode considering config overrides
+ *
+ * @param config - Network recorder configuration
+ * @param envVar - Environment variable name
+ * @returns Effective network mode
+ */
+export declare function getEffectiveNetworkMode(config?: NetworkRecorderConfig, envVar?: string): NetworkMode;
+/**
+ * Checks if network recording/playback should be active
+ *
+ * @param mode - Network mode
+ * @returns true if network operations should be active
+ */
+export declare function isNetworkModeActive(mode: NetworkMode): boolean;
+/**
+ * Gets mode-specific default configuration
+ *
+ * @param mode - Network mode
+ * @returns Mode-specific configuration defaults
+ */
+export declare function getModeDefaults(mode: NetworkMode): Partial<NetworkRecorderConfig>;
+/**
+ * Validates network recorder configuration for the given mode
+ *
+ * @param config - Network recorder configuration
+ * @param mode - Network mode
+ * @returns Validation result with any issues
+ */
+export declare function validateModeConfiguration(config: NetworkRecorderConfig, mode: NetworkMode): {
+    isValid: boolean;
+    issues: string[];
+};
+/**
+ * Gets a human-readable description of the current mode
+ *
+ * @param mode - Network mode
+ * @returns Human-readable mode description
+ */
+export declare function getModeDescription(mode: NetworkMode): string;
+//# sourceMappingURL=mode-detector.d.ts.map

package/dist/types/network-recorder/core/mode-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detector.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/mode-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAWjE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,MAAsB,GAAG,WAAW,CAe7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,WAAW,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,GAAE,qBAA0B,EAClC,MAAM,GAAE,MAAsB,GAC7B,WAAW,CAQb;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAiChC;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,WAAW,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAwCxC;AAmCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAW5D"}