@seontechnologies/playwright-utils 3.10.0

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

@@ -0,0 +1,192 @@
+/**
+ * Type definitions for network traffic recording and playback operations
+ *
+ * This file contains shared type definitions used by the network recorder:
+ * - har-manager.ts
+ * - mode-detector.ts
+ * - network-recorder.ts
+ */
+/**
+ * Supported network recording modes
+ */
+export type NetworkMode = 'record' | 'playback' | 'disabled';
+/**
+ * Environment variable name for network mode
+ */
+export declare const NETWORK_MODE_ENV_VAR: "PW_NET_MODE";
+/**
+ * HAR file configuration options
+ */
+export type HarFileOptions = {
+    /**
+     * Directory where HAR files are stored
+     * @default 'har-files'
+     */
+    harDir?: string;
+    /**
+     * Base name for HAR files (test name will be appended)
+     */
+    baseName?: string;
+    /**
+     * Whether to create subdirectories by test file
+     * @default true
+     */
+    organizeByTestFile?: boolean;
+};
+/**
+ * HAR recording options
+ */
+export type HarRecordingOptions = {
+    /**
+     * Whether to record response content
+     * @default true
+     */
+    content?: 'embed' | 'attach';
+    /**
+     * Mode for recording
+     * @default 'minimal'
+     */
+    mode?: 'full' | 'minimal';
+    /**
+     * URL patterns to include in recording
+     */
+    urlFilter?: string | RegExp;
+    /**
+     * Whether to update existing HAR files
+     * @default false
+     */
+    update?: boolean;
+};
+/**
+ * HAR playback options
+ */
+export type HarPlaybackOptions = {
+    /**
+     * Whether to fall back to live requests if HAR entry not found
+     * @default false
+     */
+    fallback?: boolean;
+    /**
+     * URL patterns to include in playback
+     */
+    urlFilter?: string | RegExp;
+    /**
+     * Whether to update HAR files during playback for missing entries
+     * @default false
+     */
+    updateMode?: boolean;
+    /**
+     * URL mapping configuration for cross-environment playback
+     */
+    urlMapping?: {
+        /**
+         * Custom function to map URLs from current environment to recorded environment
+         * @example
+         * ```typescript
+         * urlMapping: {
+         *   mapUrl: (url) => url.replace('preview.example.com', 'dev.example.com')
+         * }
+         * ```
+         */
+        mapUrl?: (url: string) => string;
+        /**
+         * Simple hostname mapping
+         * @example
+         * ```typescript
+         * urlMapping: {
+         *   hostMapping: {
+         *     'preview.example.com': 'dev.example.com',
+         *     'staging.example.com': 'dev.example.com'
+         *   }
+         * }
+         * ```
+         */
+        hostMapping?: Record<string, string>;
+        /**
+         * Regex-based URL transformations
+         * @example
+         * ```typescript
+         * urlMapping: {
+         *   patterns: [
+         *     { match: /admin-\d+\.seondev\.space/, replace: 'admin.seondev.space' }
+         *   ]
+         * }
+         * ```
+         */
+        patterns?: Array<{
+            match: RegExp;
+            replace: string | ((match: string) => string);
+        }>;
+    };
+};
+/**
+ * Network recorder configuration
+ */
+export type NetworkRecorderConfig = {
+    /**
+     * HAR file options
+     */
+    harFile?: HarFileOptions;
+    /**
+     * Recording options (used in record mode)
+     */
+    recording?: HarRecordingOptions;
+    /**
+     * Playback options (used in playback mode)
+     */
+    playback?: HarPlaybackOptions;
+    /**
+     * Force a specific mode regardless of environment
+     */
+    forceMode?: NetworkMode;
+    /**
+     * Automatically switch to record mode when HAR file is missing in playback mode
+     * @default true
+     */
+    autoRecordFallback?: boolean;
+};
+/**
+ * Network recorder context passed to tests
+ */
+export type NetworkRecorderContext = {
+    /**
+     * Current network mode
+     */
+    mode: NetworkMode;
+    /**
+     * Path to HAR file for this test
+     */
+    harFilePath: string;
+    /**
+     * Whether recording/playback is active for this test
+     */
+    isActive: boolean;
+    /**
+     * Configuration used for this test
+     */
+    config: NetworkRecorderConfig;
+};
+/**
+ * Custom error for network recording operations
+ */
+export declare class NetworkRecorderError extends Error {
+    readonly operation?: "record" | "playback" | "setup" | undefined;
+    readonly harFilePath?: string | undefined;
+    constructor(message: string, operation?: "record" | "playback" | "setup" | undefined, harFilePath?: string | undefined);
+}
+/**
+ * Custom error for HAR file operations
+ */
+export declare class HarFileError extends Error {
+    readonly filePath?: string | undefined;
+    readonly operation?: "read" | "write" | "validate" | undefined;
+    constructor(message: string, filePath?: string | undefined, operation?: "read" | "write" | "validate" | undefined);
+}
+/**
+ * Custom error for mode detection
+ */
+export declare class ModeDetectionError extends Error {
+    readonly envValue?: string | undefined;
+    constructor(message: string, envValue?: string | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/esm/network-recorder/core/types.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Type definitions for network traffic recording and playback operations
+ *
+ * This file contains shared type definitions used by the network recorder:
+ * - har-manager.ts
+ * - mode-detector.ts
+ * - network-recorder.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModeDetectionError = exports.HarFileError = exports.NetworkRecorderError = exports.NETWORK_MODE_ENV_VAR = void 0;
+/**
+ * Environment variable name for network mode
+ */
+exports.NETWORK_MODE_ENV_VAR = 'PW_NET_MODE';
+// =========================================================================
+// Error Types
+// =========================================================================
+/**
+ * Custom error for network recording operations
+ */
+class NetworkRecorderError extends Error {
+    constructor(message, operation, harFilePath) {
+        super(message);
+        this.operation = operation;
+        this.harFilePath = harFilePath;
+        this.name = 'NetworkRecorderError';
+    }
+}
+exports.NetworkRecorderError = NetworkRecorderError;
+/**
+ * Custom error for HAR file operations
+ */
+class HarFileError extends Error {
+    constructor(message, filePath, operation) {
+        super(message);
+        this.filePath = filePath;
+        this.operation = operation;
+        this.name = 'HarFileError';
+    }
+}
+exports.HarFileError = HarFileError;
+/**
+ * Custom error for mode detection
+ */
+class ModeDetectionError extends Error {
+    constructor(message, envValue) {
+        super(message);
+        this.envValue = envValue;
+        this.name = 'ModeDetectionError';
+    }
+}
+exports.ModeDetectionError = ModeDetectionError;
+//# sourceMappingURL=types.js.map

package/dist/esm/network-recorder/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/network-recorder/core/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAWH;;GAEG;AACU,QAAA,oBAAoB,GAAG,aAAsB,CAAA;AA2K1D,4EAA4E;AAC5E,cAAc;AACd,4EAA4E;AAE5E;;GAEG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YACE,OAAe,EACC,SAA2C,EAC3C,WAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,cAAS,GAAT,SAAS,CAAkC;QAC3C,gBAAW,GAAX,WAAW,CAAS;QAGpC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AATD,oDASC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YACE,OAAe,EACC,QAAiB,EACjB,SAAyC;QAEzD,KAAK,CAAC,OAAO,CAAC,CAAA;QAHE,aAAQ,GAAR,QAAQ,CAAS;QACjB,cAAS,GAAT,SAAS,CAAgC;QAGzD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AATD,oCASC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YACE,OAAe,EACC,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AARD,gDAQC"}

package/dist/esm/network-recorder/fixtures.d.ts

@@ -0,0 +1,2 @@
+export { test } from './network-recorder-fixture';
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/esm/network-recorder/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/network-recorder/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/esm/network-recorder/fixtures.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+var network_recorder_fixture_1 = require("./network-recorder-fixture");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return network_recorder_fixture_1.test; } });
+//# sourceMappingURL=fixtures.js.map

package/dist/esm/network-recorder/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/network-recorder/fixtures.ts"],"names":[],"mappings":";;;AAAA,uEAAiD;AAAxC,gHAAA,IAAI,OAAA"}

package/dist/esm/network-recorder/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Network recorder module - exports for direct usage and fixtures
+ */
+export * from './network-recorder';
+export * from './fixtures';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/network-recorder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/network-recorder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA"}

package/dist/esm/network-recorder/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Network recorder module - exports for direct usage and fixtures
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./network-recorder"), exports);
+__exportStar(require("./fixtures"), exports);
+//# sourceMappingURL=index.js.map

package/dist/esm/network-recorder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/network-recorder/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,qDAAkC;AAClC,6CAA0B"}

package/dist/esm/network-recorder/network-recorder-fixture.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Network recorder Playwright fixture
+ *
+ * This fixture provides seamless integration with Playwright tests by:
+ * - Automatically detecting network mode from environment
+ * - Setting up recording/playback on browser context
+ * - Handling cleanup automatically
+ * - Being authentication-agnostic (works with pre-authenticated contexts)
+ */
+import type { BrowserContext } from '@playwright/test';
+import { NetworkRecorder } from './core';
+import type { NetworkRecorderConfig, NetworkRecorderContext } from './core';
+/**
+ * Network recorder fixture type
+ */
+export type NetworkRecorderFixtures = {
+    networkRecorder: {
+        /**
+         * Sets up network recording/playback on the browser context
+         *
+         * @param context - Playwright browser context (should be pre-authenticated if needed)
+         * @param config - Optional configuration override
+         * @returns Network recorder context
+         */
+        setup: (context: BrowserContext, config?: NetworkRecorderConfig) => Promise<NetworkRecorderContext>;
+        /**
+         * Gets the current network recorder context without setup
+         *
+         * @param config - Optional configuration override
+         * @returns Network recorder context
+         */
+        getContext: (config?: NetworkRecorderConfig) => NetworkRecorderContext;
+        /**
+         * Creates a network recorder instance
+         *
+         * @param config - Optional configuration override
+         * @returns NetworkRecorder instance
+         */
+        create: (config?: NetworkRecorderConfig) => NetworkRecorder;
+        /**
+         * Gets the status message for the current recorder
+         *
+         * @returns Human-readable status message
+         */
+        getStatus: () => string;
+        /**
+         * Manually cleanup the active recorder
+         *
+         * Flushes recorded data to disk and clears memory/state.
+         * Note: This is automatically called after the test completes.
+         * Does NOT delete HAR files - only cleans up memory.
+         *
+         * @returns Promise that resolves when cleanup is complete
+         */
+        cleanup: () => Promise<void>;
+        /**
+         * Gets HAR file statistics
+         *
+         * @returns Promise with HAR file stats
+         */
+        getHarStats: () => Promise<{
+            exists: boolean;
+            size: number;
+            entriesCount: number;
+            modified: Date | null;
+            version: string;
+            error?: string;
+        }>;
+        /**
+         * Gets the status message for the current recorder
+         *
+         * @returns Human-readable status message
+         */
+        getStatusMessage: () => string;
+    };
+};
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & NetworkRecorderFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+//# sourceMappingURL=network-recorder-fixture.d.ts.map

package/dist/esm/network-recorder/network-recorder-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-recorder-fixture.d.ts","sourceRoot":"","sources":["../../../src/network-recorder/network-recorder-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AAE3E;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE;QACf;;;;;;WAMG;QACH,KAAK,EAAE,CACL,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,qBAAqB,KAC3B,OAAO,CAAC,sBAAsB,CAAC,CAAA;QAEpC;;;;;WAKG;QACH,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,qBAAqB,KAAK,sBAAsB,CAAA;QAEtE;;;;;WAKG;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,qBAAqB,KAAK,eAAe,CAAA;QAE3D;;;;WAIG;QACH,SAAS,EAAE,MAAM,MAAM,CAAA;QAEvB;;;;;;;;WAQG;QACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAE5B;;;;WAIG;QACH,WAAW,EAAE,MAAM,OAAO,CAAC;YACzB,MAAM,EAAE,OAAO,CAAA;YACf,IAAI,EAAE,MAAM,CAAA;YACZ,YAAY,EAAE,MAAM,CAAA;YACpB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;YACrB,OAAO,EAAE,MAAM,CAAA;YACf,KAAK,CAAC,EAAE,MAAM,CAAA;SACf,CAAC,CAAA;QAEF;;;;WAIG;QACH,gBAAgB,EAAE,MAAM,MAAM,CAAA;KAC/B,CAAA;CACF,CAAA;AAED,eAAO,MAAM,IAAI,uQAsFf,CAAA"}

package/dist/esm/network-recorder/network-recorder-fixture.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Network recorder Playwright fixture
+ *
+ * This fixture provides seamless integration with Playwright tests by:
+ * - Automatically detecting network mode from environment
+ * - Setting up recording/playback on browser context
+ * - Handling cleanup automatically
+ * - Being authentication-agnostic (works with pre-authenticated contexts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+const test_1 = require("@playwright/test");
+const core_1 = require("./core");
+exports.test = test_1.test.extend({
+    networkRecorder: async ({}, use, testInfo) => {
+        let activeRecorder;
+        const fixture = {
+            async setup(context, config) {
+                // Clean up any existing recorder
+                if (activeRecorder) {
+                    await activeRecorder.cleanup();
+                }
+                // Create new recorder
+                activeRecorder = new core_1.NetworkRecorder(testInfo, config);
+                // Set up recording/playback on the context
+                await activeRecorder.setup(context);
+                return activeRecorder.getContext();
+            },
+            getContext(config) {
+                if (activeRecorder) {
+                    return activeRecorder.getContext();
+                }
+                // Create temporary recorder just to get context
+                const tempRecorder = new core_1.NetworkRecorder(testInfo, config);
+                return tempRecorder.getContext();
+            },
+            create(config) {
+                return new core_1.NetworkRecorder(testInfo, config);
+            },
+            getStatus() {
+                if (activeRecorder) {
+                    return activeRecorder.getStatusMessage();
+                }
+                return 'Network recorder: not initialized';
+            },
+            async cleanup() {
+                if (activeRecorder) {
+                    await activeRecorder.cleanup();
+                }
+            },
+            async getHarStats() {
+                if (activeRecorder) {
+                    return activeRecorder.getHarStats();
+                }
+                return {
+                    exists: false,
+                    size: 0,
+                    entriesCount: 0,
+                    modified: null,
+                    version: 'unknown',
+                    error: 'No active recorder'
+                };
+            },
+            getStatusMessage() {
+                if (activeRecorder) {
+                    return activeRecorder.getStatusMessage();
+                }
+                return 'Network recorder: not initialized';
+            }
+        };
+        await use(fixture);
+        // Cleanup after test
+        if (activeRecorder) {
+            await activeRecorder.cleanup();
+        }
+    }
+});
+//# sourceMappingURL=network-recorder-fixture.js.map

package/dist/esm/network-recorder/network-recorder-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-recorder-fixture.js","sourceRoot":"","sources":["../../../src/network-recorder/network-recorder-fixture.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,2CAA+C;AAE/C,iCAAwC;AA6E3B,QAAA,IAAI,GAAG,WAAI,CAAC,MAAM,CAA0B;IACvD,eAAe,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;QAC3C,IAAI,cAA2C,CAAA;QAE/C,MAAM,OAAO,GAAG;YACd,KAAK,CAAC,KAAK,CACT,OAAuB,EACvB,MAA8B;gBAE9B,iCAAiC;gBACjC,IAAI,cAAc,EAAE,CAAC;oBACnB,MAAM,cAAc,CAAC,OAAO,EAAE,CAAA;gBAChC,CAAC;gBAED,sBAAsB;gBACtB,cAAc,GAAG,IAAI,sBAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;gBAEtD,2CAA2C;gBAC3C,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;gBAEnC,OAAO,cAAc,CAAC,UAAU,EAAE,CAAA;YACpC,CAAC;YAED,UAAU,CAAC,MAA8B;gBACvC,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,cAAc,CAAC,UAAU,EAAE,CAAA;gBACpC,CAAC;gBAED,gDAAgD;gBAChD,MAAM,YAAY,GAAG,IAAI,sBAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;gBAC1D,OAAO,YAAY,CAAC,UAAU,EAAE,CAAA;YAClC,CAAC;YAED,MAAM,CAAC,MAA8B;gBACnC,OAAO,IAAI,sBAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAC9C,CAAC;YAED,SAAS;gBACP,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,cAAc,CAAC,gBAAgB,EAAE,CAAA;gBAC1C,CAAC;gBACD,OAAO,mCAAmC,CAAA;YAC5C,CAAC;YAED,KAAK,CAAC,OAAO;gBACX,IAAI,cAAc,EAAE,CAAC;oBACnB,MAAM,cAAc,CAAC,OAAO,EAAE,CAAA;gBAChC,CAAC;YACH,CAAC;YAED,KAAK,CAAC,WAAW;gBAQf,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,cAAc,CAAC,WAAW,EAAE,CAAA;gBACrC,CAAC;gBACD,OAAO;oBACL,MAAM,EAAE,KAAK;oBACb,IAAI,EAAE,CAAC;oBACP,YAAY,EAAE,CAAC;oBACf,QAAQ,EAAE,IAAI;oBACd,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE,oBAAoB;iBAC5B,CAAA;YACH,CAAC;YAED,gBAAgB;gBACd,IAAI,cAAc,EAAE,CAAC;oBACnB,OAAO,cAAc,CAAC,gBAAgB,EAAE,CAAA;gBAC1C,CAAC;gBACD,OAAO,mCAAmC,CAAA;YAC5C,CAAC;SACF,CAAA;QAED,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;QAElB,qBAAqB;QACrB,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,cAAc,CAAC,OAAO,EAAE,CAAA;QAChC,CAAC;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/esm/network-recorder/network-recorder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Network recorder main export - provides direct function access
+ *
+ * This module provides functional access to network recording capabilities
+ * for users who prefer direct function calls over fixtures.
+ */
+export { NetworkRecorder, createNetworkRecorder } from './core';
+export { generateHarFilePath, ensureHarDirectory, validateHarFileForPlayback, acquireHarFileLock, removeHarFile, createUniqueHarFilePath, getHarFileStats } from './core';
+export { detectNetworkMode, isValidNetworkMode, getEffectiveNetworkMode, isNetworkModeActive, getModeDefaults, validateModeConfiguration, getModeDescription } from './core';
+export type { NetworkMode, NETWORK_MODE_ENV_VAR, HarFileOptions, HarRecordingOptions, HarPlaybackOptions, NetworkRecorderConfig, NetworkRecorderContext, NetworkRecorderError, HarFileError, ModeDetectionError } from './core';
+//# sourceMappingURL=network-recorder.d.ts.map

package/dist/esm/network-recorder/network-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-recorder.d.ts","sourceRoot":"","sources":["../../../src/network-recorder/network-recorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAA;AAG/D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,eAAe,EAChB,MAAM,QAAQ,CAAA;AAGf,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,QAAQ,CAAA;AAGf,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EACnB,MAAM,QAAQ,CAAA"}

package/dist/esm/network-recorder/network-recorder.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Network recorder main export - provides direct function access
+ *
+ * This module provides functional access to network recording capabilities
+ * for users who prefer direct function calls over fixtures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getModeDescription = exports.validateModeConfiguration = exports.getModeDefaults = exports.isNetworkModeActive = exports.getEffectiveNetworkMode = exports.isValidNetworkMode = exports.detectNetworkMode = exports.getHarFileStats = exports.createUniqueHarFilePath = exports.removeHarFile = exports.acquireHarFileLock = exports.validateHarFileForPlayback = exports.ensureHarDirectory = exports.generateHarFilePath = exports.createNetworkRecorder = exports.NetworkRecorder = void 0;
+// Re-export main functionality
+var core_1 = require("./core");
+Object.defineProperty(exports, "NetworkRecorder", { enumerable: true, get: function () { return core_1.NetworkRecorder; } });
+Object.defineProperty(exports, "createNetworkRecorder", { enumerable: true, get: function () { return core_1.createNetworkRecorder; } });
+// Re-export utility functions
+var core_2 = require("./core");
+Object.defineProperty(exports, "generateHarFilePath", { enumerable: true, get: function () { return core_2.generateHarFilePath; } });
+Object.defineProperty(exports, "ensureHarDirectory", { enumerable: true, get: function () { return core_2.ensureHarDirectory; } });
+Object.defineProperty(exports, "validateHarFileForPlayback", { enumerable: true, get: function () { return core_2.validateHarFileForPlayback; } });
+Object.defineProperty(exports, "acquireHarFileLock", { enumerable: true, get: function () { return core_2.acquireHarFileLock; } });
+Object.defineProperty(exports, "removeHarFile", { enumerable: true, get: function () { return core_2.removeHarFile; } });
+Object.defineProperty(exports, "createUniqueHarFilePath", { enumerable: true, get: function () { return core_2.createUniqueHarFilePath; } });
+Object.defineProperty(exports, "getHarFileStats", { enumerable: true, get: function () { return core_2.getHarFileStats; } });
+// Re-export mode detection functions
+var core_3 = require("./core");
+Object.defineProperty(exports, "detectNetworkMode", { enumerable: true, get: function () { return core_3.detectNetworkMode; } });
+Object.defineProperty(exports, "isValidNetworkMode", { enumerable: true, get: function () { return core_3.isValidNetworkMode; } });
+Object.defineProperty(exports, "getEffectiveNetworkMode", { enumerable: true, get: function () { return core_3.getEffectiveNetworkMode; } });
+Object.defineProperty(exports, "isNetworkModeActive", { enumerable: true, get: function () { return core_3.isNetworkModeActive; } });
+Object.defineProperty(exports, "getModeDefaults", { enumerable: true, get: function () { return core_3.getModeDefaults; } });
+Object.defineProperty(exports, "validateModeConfiguration", { enumerable: true, get: function () { return core_3.validateModeConfiguration; } });
+Object.defineProperty(exports, "getModeDescription", { enumerable: true, get: function () { return core_3.getModeDescription; } });
+//# sourceMappingURL=network-recorder.js.map

package/dist/esm/network-recorder/network-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-recorder.js","sourceRoot":"","sources":["../../../src/network-recorder/network-recorder.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+BAA+B;AAC/B,+BAA+D;AAAtD,uGAAA,eAAe,OAAA;AAAE,6GAAA,qBAAqB,OAAA;AAE/C,8BAA8B;AAC9B,+BAQe;AAPb,2GAAA,mBAAmB,OAAA;AACnB,0GAAA,kBAAkB,OAAA;AAClB,kHAAA,0BAA0B,OAAA;AAC1B,0GAAA,kBAAkB,OAAA;AAClB,qGAAA,aAAa,OAAA;AACb,+GAAA,uBAAuB,OAAA;AACvB,uGAAA,eAAe,OAAA;AAGjB,qCAAqC;AACrC,+BAQe;AAPb,yGAAA,iBAAiB,OAAA;AACjB,0GAAA,kBAAkB,OAAA;AAClB,+GAAA,uBAAuB,OAAA;AACvB,2GAAA,mBAAmB,OAAA;AACnB,uGAAA,eAAe,OAAA;AACf,iHAAA,yBAAyB,OAAA;AACzB,0GAAA,kBAAkB,OAAA"}

package/dist/esm/recurse/fixtures.d.ts

@@ -0,0 +1,2 @@
+export { test } from './recurse-fixture';
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/esm/recurse/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/recurse/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/esm/recurse/fixtures.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+var recurse_fixture_1 = require("./recurse-fixture");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return recurse_fixture_1.test; } });
+//# sourceMappingURL=fixtures.js.map

package/dist/esm/recurse/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../../src/recurse/fixtures.ts"],"names":[],"mappings":";;;AAAA,qDAAwC;AAA/B,uGAAA,IAAI,OAAA"}

package/dist/esm/recurse/index.d.ts

@@ -0,0 +1,2 @@
+export * from './recurse';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/recurse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recurse/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/dist/esm/recurse/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./recurse"), exports);
+//# sourceMappingURL=index.js.map

package/dist/esm/recurse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recurse/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAAyB"}

package/dist/esm/recurse/recurse-fixture.d.ts

@@ -0,0 +1,35 @@
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    /**
+     * Re-runs a function until the predicate returns true or timeout is reached.
+     * This fixture version provides the same functionality as the direct import
+     * but can be used within test fixtures.
+     *
+     * @example
+     * // Poll until session becomes active
+     * test('wait for activation', async ({ recurse }) => {
+     *   const session = await recurse(
+     *     () => apiRequest({ method: 'GET', url: '/session' }),
+     *     (response) => response.body.status === 'ACTIVE',
+     *     { timeout: 60000, interval: 2000 }
+     *   );
+     *
+     *   expect(session.body.id).toBeDefined();
+     * });
+     *
+     * @example
+     * // Poll with custom logging
+     * test('custom logging', async ({ recurse }) => {
+     *   await recurse(
+     *     () => fetchData(),
+     *     (data) => data.isReady,
+     *     {
+     *       log: 'Waiting for data to be ready',
+     *       timeout: 15000
+     *     }
+     *   );
+     * });
+     */
+    recurse: <T>(command: () => Promise<T>, predicate: (value: T) => boolean, options?: Record<string, unknown>) => Promise<T>;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from '@playwright/test';
+//# sourceMappingURL=recurse-fixture.d.ts.map

package/dist/esm/recurse/recurse-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurse-fixture.d.ts","sourceRoot":"","sources":["../../../src/recurse/recurse-fixture.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI;IACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;aACM,CAAC,CAAC,EACT,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,CAAC,CAAC;wGAWf,CAAA;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/esm/recurse/recurse-fixture.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expect = exports.test = void 0;
+const test_1 = require("@playwright/test");
+const recurse_1 = require("./recurse");
+exports.test = test_1.test.extend({
+    recurse: async ({}, use) => {
+        const recurse = async (command, predicate, options = {}) => (0, recurse_1.recurse)(command, predicate, options);
+        await use(recurse);
+    }
+});
+var test_2 = require("@playwright/test");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return test_2.expect; } });
+//# sourceMappingURL=recurse-fixture.js.map

package/dist/esm/recurse/recurse-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurse-fixture.js","sourceRoot":"","sources":["../../../src/recurse/recurse-fixture.ts"],"names":[],"mappings":";;;AAAA,2CAA+C;AAC/C,uCAAsD;AAEzC,QAAA,IAAI,GAAG,WAAI,CAAC,MAAM,CAoC5B;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,KAAK,EACnB,OAAyB,EACzB,SAAgC,EAChC,UAAmC,EAAE,EACzB,EAAE,CAAC,IAAA,iBAAe,EAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;QAE7D,MAAM,GAAG,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;CACF,CAAC,CAAA;AAEF,yCAAyC;AAAhC,8FAAA,MAAM,OAAA"}