@probolabs/playwright 1.0.6 → 1.0.10

package/dist/index.d.ts

@@ -100,7 +100,6 @@ interface RunStepParams extends Partial<PlaywrightTimeoutConfig> {
 declare class ProboPlaywright {
     private readonly config;
     private page;
-    private lastNavigationTime;
     constructor(config?: PlaywrightTimeoutConfig, page?: Page$1 | null);
     /**
      * Sets the Playwright page instance for this ProboPlaywright instance.
@@ -109,7 +108,6 @@ declare class ProboPlaywright {
      * @param page - The Playwright Page instance to use, or null to unset.
      */
     setPage(page: Page$1 | null): void;
-    private onFrameNav;
     /**
      * Executes a single step in the test scenario with the specified action on the target element.
      * Handles iframe navigation, element highlighting, and various Playwright actions like click, fill, validate, etc.
@@ -159,14 +157,21 @@ declare class ProboPlaywright {
      * @returns Normalized text content with consistent whitespace handling
      */
     private getTextValue;
+    private setSliderValue;
 }
 
 interface NavTrackerOptions {
-    stabilizationTimeout?: number;
+    waitForStabilityQuietTimeout?: number;
+    waitForStabilityInitialDelay?: number;
+    waitForStabilityGlobalTimeout?: number;
+    pollMs?: number;
+    maxInflight?: number;
+    inflightGraceMs?: number;
+    waitForStabilityVerbose?: boolean;
 }
 /**
- * Global navigation tracker that monitors page navigation events
- * and provides methods to check if navigation has stabilized
+ * Global navigation tracker that monitors page navigation events and network activity
+ * using CDP (Chrome DevTools Protocol) for comprehensive network monitoring
  *
  * This is a singleton class - only one instance can exist at a time
  */
@@ -175,30 +180,51 @@ declare class NavTracker {
     private page;
     private navigationCount;
     private lastNavTime;
-    private stabilizationTimeout;
+    private waitForStabilityQuietTimeout;
+    private waitForStabilityInitialDelay;
+    private waitForStabilityGlobalTimeout;
+    private pollMs;
+    private maxInflight;
+    private inflightGraceMs;
+    private waitForStabilityVerbose;
     private isListening;
-    private onFrameNavHandler;
     private instanceId;
+    private client;
+    private inflight;
+    private lastHardNavAt;
+    private lastSoftNavAt;
+    private lastNetworkActivityAt;
+    private totalRequestsTracked;
+    private readonly RELEVANT_RESOURCE_TYPES;
+    private readonly RELEVANT_CONTENT_TYPES;
+    private readonly IGNORED_URL_PATTERNS;
     /**
      * Private constructor - use getInstance() to get the singleton instance
      */
     private constructor();
     /**
-     * Start listening for navigation events (private method)
+     * Start listening for navigation and network events using CDP (private method)
      */
     private start;
     /**
-     * Stop listening for navigation events (private method)
+     * Stop listening for navigation and network events (private method)
      */
     private stop;
     /**
-     * Check if navigation has stabilized (no navigation for stabilizationTimeout ms) (private method)
+     * Handle network request events
+     */
+    private onNetworkRequest;
+    /**
+     * Handle network response events
+     */
+    private onNetworkResponse;
+    /**
+     * Check if navigation and network activity has stabilized
      */
     private hasNavigationStabilized;
     /**
-     * Wait for navigation to stabilize
-     * Waits a short time to catch any missed navigation events, then ensures
-     * the latest navigation happened at least stabilizationTimeout ms ago
+     * Wait for navigation and network activity to stabilize
+     * Uses CDP-based monitoring for comprehensive network activity tracking
      */
     waitForNavigationToStabilize(): Promise<void>;
     /**
@@ -207,7 +233,76 @@ declare class NavTracker {
      * @param options Optional configuration
      * @returns The singleton NavTracker instance
      */
-    static getInstance(page?: Page, options?: NavTrackerOptions): NavTracker;
+    static getInstance(page?: Page, options?: NavTrackerOptions): Promise<NavTracker>;
+    /**
+     * Reset the singleton instance (useful for testing or page changes)
+     */
+    static resetInstance(): void;
+}
+
+interface MailinatorMessage {
+    id: string;
+    subject: string;
+    from: string;
+    origfrom?: string;
+    to: string;
+    time: number;
+    seconds_ago: number;
+    domain?: string;
+    source?: string;
+    parts?: Array<{
+        headers: Record<string, string>;
+        body: string;
+    }>;
+    textBody?: string;
+    htmlBody?: string;
+}
+/**
+ * OTP utility class for working with Mailinator API
+ */
+declare class OTP {
+    /**
+     * Fetches the last messages from Mailinator for a specific inbox
+     * @param inbox - The inbox name to check (without @domain)
+     * @param since - Unix timestamp to fetch messages since (optional)
+     * @returns Promise<MailinatorMessage[]> - Array of messages
+     */
+    static fetchLastMessages(inbox: string, since?: number): Promise<MailinatorMessage[]>;
+    /**
+     * Fetches a specific message by ID
+     * @param messageId - The message ID
+     * @returns Promise<MailinatorMessage> - The message details
+     */
+    static fetchMessage(messageId: string): Promise<MailinatorMessage>;
+    /**
+     * Extracts OTP codes from message content
+     * @param message - The message to extract OTP from
+     * @returns string | null - The OTP code or null if not found
+     */
+    static extractOTPFromMessage(message: MailinatorMessage): string | null;
+    /**
+     * Gets the text content from a message for debugging/display purposes
+     * @param message - The message to extract text from
+     * @returns string - The text content of the message
+     */
+    static getMessageTextContent(message: MailinatorMessage): string;
+    /**
+     * Fetches messages from all inboxes in the domain
+     * @param limit - Number of messages to fetch (default: 50)
+     * @param sort - Sort order: 'ascending' or 'descending' (default: 'descending')
+     * @param full - Whether to fetch full message content (default: false)
+     * @returns Promise<MailinatorMessage[]> - Array of messages from all inboxes
+     */
+    static fetchAllInboxMessages(limit?: number, sort?: 'ascending' | 'descending', full?: boolean): Promise<MailinatorMessage[]>;
+    /**
+     * Waits for an OTP to arrive in the inbox and extracts it
+     * @param inbox - The inbox name to monitor (optional - if not provided, searches all inboxes)
+     * @param timeout - Maximum time to wait in milliseconds (default: 30000)
+     * @param checkInterval - How often to check in milliseconds (default: 1000)
+     * @param checkRecentMessagesSinceMs - When > 0, check messages from the last X milliseconds and return the most recent OTP (default: 0)
+     * @returns Promise<string | null> - The extracted OTP code or null if timeout/no OTP found
+     */
+    static waitForOTP(inbox?: string, timeout?: number, checkInterval?: number, checkRecentMessagesSinceMs?: number): Promise<string | null>;
 }
 
 /**
@@ -222,7 +317,7 @@ interface ProboConfig {
     logToFile?: boolean;
     debugLevel?: ProboLogLevel;
     aiModel?: AIModel;
-    timeoutConfig?: PlaywrightTimeoutConfig;
+    timeoutConfig?: Partial<PlaywrightTimeoutConfig>;
 }
 interface RunStepOptions {
     useCache: boolean;
@@ -254,5 +349,5 @@ declare class Probo {
     askAIHelper(page: Page, question: string): Promise<ServerResponse>;
 }
 
-export { Highlighter, NavTracker, Probo, ProboPlaywright, findClosestVisibleElement };
-export type { ElementTagType, RunStepOptions };
+export { Highlighter, NavTracker, OTP, Probo, ProboPlaywright, findClosestVisibleElement };
+export type { ElementTagType, MailinatorMessage, RunStepOptions };