@seontechnologies/playwright-utils 3.10.0

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

@@ -0,0 +1,90 @@
+/**
+ * Core network recorder implementation
+ *
+ * This module provides the main NetworkRecorder class that:
+ * - Manages HAR recording and playback based on detected mode
+ * - Integrates with Playwright's browser context
+ * - Handles authentication-agnostic setup
+ * - Provides concurrent test safety
+ */
+import type { BrowserContext, TestInfo } from '@playwright/test';
+import type { NetworkRecorderConfig, NetworkRecorderContext } from './types';
+/**
+ * Main network recorder class
+ */
+export declare class NetworkRecorder {
+    private testInfo;
+    private mode;
+    private config;
+    private harFilePath;
+    private releaseLock?;
+    private isSetup;
+    private harData?;
+    private recordedRequests;
+    constructor(testInfo: TestInfo, config?: NetworkRecorderConfig);
+    /**
+     * Gets the current network recorder context
+     */
+    getContext(): NetworkRecorderContext;
+    /**
+     * Sets up network recording/playback on the browser context
+     *
+     * @param context - Playwright browser context (must be authenticated if needed)
+     */
+    setup(context: BrowserContext): Promise<void>;
+    /**
+     * Cleans up network recorder resources
+     *
+     * Flushes recorded network data to disk and cleans up memory:
+     * - Writes HAR file (if recording mode with entries)
+     * - Releases file locks for concurrent safety
+     * - Clears in-memory HAR data and recorded requests
+     * - Resets internal state flags
+     *
+     * Note: This does NOT delete HAR files - only cleans up memory/state
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Gets HAR file statistics
+     */
+    getHarStats(): 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;
+    }>;
+    /**
+     * Gets a human-readable status message
+     */
+    getStatusMessage(): string;
+    /**
+     * Sets up HAR recording on the browser context
+     */
+    private setupRecording;
+    /**
+     * Sets up HAR playback on the browser context
+     */
+    private setupPlayback;
+    /**
+     * Check if HAR file contains CRUD operations that need stateful handling
+     */
+    private checkIfNeedsStatefulHandling;
+}
+/**
+ * Creates a network recorder instance for the given test
+ *
+ * @param testInfo - Playwright test info
+ * @param config - Network recorder configuration
+ * @returns NetworkRecorder instance
+ */
+export declare function createNetworkRecorder(testInfo: TestInfo, config?: NetworkRecorderConfig): NetworkRecorder;
+//# sourceMappingURL=network-recorder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network-recorder.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/network-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAwBhE,OAAO,KAAK,EAIV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAIhB;;GAEG;AACH,qBAAa,eAAe;IAUxB,OAAO,CAAC,QAAQ;IATlB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAqB;IACzC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAgD;gBAG9D,QAAQ,EAAE,QAAQ,EAC1B,MAAM,GAAE,qBAA0B;IAoBpC;;OAEG;IACH,UAAU,IAAI,sBAAsB;IASpC;;;;OAIG;IACG,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CnD;;;;;;;;;;OAUG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B;;OAEG;IACG,WAAW;;;;;;;;;;;;;;;IAIjB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAW1B;;OAEG;YACW,cAAc;IAmE5B;;OAEG;YACW,aAAa;IAsD3B;;OAEG;YACW,4BAA4B;CA2B3C;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,MAAM,GAAE,qBAA0B,GACjC,eAAe,CAEjB"}

package/dist/types/network-recorder/core/stateful-api-mock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Stateful API mock for CRUD operations
+ *
+ * This replaces HAR-based playback with a smarter approach that understands
+ * API semantics and maintains state across requests.
+ */
+import type { BrowserContext } from '@playwright/test';
+export declare class StatefulApiMock {
+    private state;
+    /**
+     * Reset state to initial conditions
+     */
+    reset(): void;
+    /**
+     * Set up route handlers on the browser context
+     */
+    setup(context: BrowserContext): Promise<void>;
+    private handleRoute;
+    private handleGetMovies;
+    private handlePostMovie;
+    private handleGetMovie;
+    private handlePutMovie;
+    private handleDeleteMovie;
+    private extractId;
+    private respond;
+}
+/**
+ * Create a stateful API mock instance
+ */
+export declare function createStatefulApiMock(): StatefulApiMock;
+//# sourceMappingURL=stateful-api-mock.d.ts.map

package/dist/types/network-recorder/core/stateful-api-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateful-api-mock.d.ts","sourceRoot":"","sources":["../../../../src/network-recorder/core/stateful-api-mock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,kBAAkB,CAAA;AAgB7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAGZ;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAUrC,WAAW;YAgCX,eAAe;YAQf,eAAe;YAef,cAAc;YAad,cAAc;YAed,iBAAiB;IAc/B,OAAO,CAAC,SAAS;YAKH,OAAO;CAyBtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/types/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/types/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/types/network-recorder/fixtures.d.ts

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

package/dist/types/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/types/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/types/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/types/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/types/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/types/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/types/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/types/recurse/fixtures.d.ts

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

package/dist/types/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/types/recurse/index.d.ts

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

package/dist/types/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/types/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/types/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/types/recurse/recurse.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Custom error for timeout scenarios during polling
+ */
+export declare class RecurseTimeoutError extends Error {
+    readonly timeout: number;
+    readonly iterations: number;
+    readonly lastValue?: unknown | undefined;
+    constructor(message: string, timeout: number, iterations: number, lastValue?: unknown | undefined);
+}
+/**
+ * Custom error for command execution failures during polling
+ */
+export declare class RecurseCommandError extends Error {
+    readonly iteration: number;
+    readonly originalError?: Error | undefined;
+    constructor(message: string, iteration: number, originalError?: Error | undefined);
+}
+/**
+ * Custom error for predicate evaluation failures
+ */
+export declare class RecursePredicateError extends Error {
+    readonly iteration: number;
+    readonly value?: unknown | undefined;
+    readonly originalError?: Error | undefined;
+    constructor(message: string, iteration: number, value?: unknown | undefined, originalError?: Error | undefined);
+}
+/**
+ * Custom error for internal state violations or programming bugs
+ */
+export declare class RecurseInternalError extends Error {
+    readonly iteration: number;
+    readonly context?: string | undefined;
+    constructor(message: string, iteration: number, context?: string | undefined);
+}
+/** data passed to log function */
+type RecurseLogData = {
+    value: any;
+    iteration: number;
+    elapsed: number;
+    timeout: number;
+    successful: boolean;
+};
+/** data passed to post function */
+type RecursePostData<T> = {
+    value: T;
+    iteration: number;
+    elapsed: number;
+    timeout: number;
+    successful: boolean;
+};
+type RecurseOptions = {
+    timeout?: number;
+    interval?: number;
+    log?: boolean | string | ((value: any, data: RecurseLogData) => void);
+    error?: string;
+    post?: (data: RecursePostData<any>) => void | Promise<void>;
+};
+export type RecurseParams<T> = {
+    command: () => Promise<T>;
+    predicate: (value: T) => boolean | void;
+    options?: RecurseOptions;
+};
+/**
+ * Re-runs a function until the predicate returns true or timeout is reached
+ * Similar to cypress-recurse API but using Playwright's expect.poll
+ *
+ * @param command Function that returns a value to test
+ * @param predicate Function that tests the value and returns true when the condition is met
+ * @param options Configuration options
+ * @returns The value from the command function when predicate returns true
+ *
+ * @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
+ *     }
+ *   );
+ * });
+ */
+/**
+ * Re-runs a function until the predicate returns true or timeout is reached
+ * This follows the cypress-recurse API but uses Playwright's expect.poll
+ *
+ * @param command Function that returns a value to test
+ * @param predicate Function that tests the value and returns true when the condition is met
+ * @param options Configuration options
+ * @returns The value from the command function when predicate returns true
+ */
+export declare function recurse<T>(command: () => Promise<T>, predicate: (value: T) => boolean | void, options?: RecurseOptions): Promise<T>;
+export {};
+//# sourceMappingURL=recurse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recurse.d.ts","sourceRoot":"","sources":["../../../src/recurse/recurse.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,OAAO,EAAE,MAAM;aACf,UAAU,EAAE,MAAM;aAClB,SAAS,CAAC,EAAE,OAAO;gBAHnC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,OAAO,YAAA;CAKtC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,SAAS,EAAE,MAAM;aACjB,aAAa,CAAC,EAAE,KAAK;gBAFrC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,KAAK,YAAA;CAKxC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAG5B,SAAS,EAAE,MAAM;aACjB,KAAK,CAAC,EAAE,OAAO;aACf,aAAa,CAAC,EAAE,KAAK;gBAHrC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,OAAO,YAAA,EACf,aAAa,CAAC,EAAE,KAAK,YAAA;CAKxC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAG3B,SAAS,EAAE,MAAM;aACjB,OAAO,CAAC,EAAE,MAAM;gBAFhC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AASD,kCAAkC;AAClC,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,GAAG,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,mCAAmC;AACnC,KAAK,eAAe,CAAC,CAAC,IAAI;IACxB,KAAK,EAAE,CAAC,CAAA;IACR,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC,CAAA;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D,CAAA;AAiPD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAA;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,CAAA;IACvC,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,IAAI,EACvC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAsBZ"}