devharness 0.8.0

package/build/utils/modal-detector.js

@@ -0,0 +1,281 @@
+/**
+ * Modal detection utilities for Puppeteer pages
+ *
+ * This module provides functions to detect and classify modals on web pages.
+ * It uses the core detection logic from modal-detection-core.ts and executes
+ * it in the browser context via page.evaluate().
+ */
+import { debugLog } from '../debug-logger.js';
+import { MODAL_PATTERNS, COMMON_MODAL_SELECTORS, isElementBlockingViewport, isBasicVisible, isBlockingPosition, hasMinimumZIndex, coversMinimumViewport, isVisibleOnTop, classifyModal, getDismissStrategies, getUniqueSelector, } from './modal-detection-core.js';
+/**
+ * Detects modals and blocking overlays on the page
+ *
+ * This is the fixed implementation that uses elementFromPoint for reliable detection
+ */
+export async function detectModals(page, options = {}) {
+    const { minZIndex = 100, minViewportCoverage = 0.25, includeBackdrops = true, } = options;
+    const pageUrl = page.url();
+    await debugLog('ModalDetector', `Detecting modals on page: ${pageUrl}`);
+    await debugLog('ModalDetector', `Options: minZIndex=${minZIndex}, minViewportCoverage=${minViewportCoverage}, includeBackdrops=${includeBackdrops}`);
+    // Serialize RegExp patterns in MODAL_PATTERNS to strings
+    const serializedPatterns = {
+        cookieConsent: {
+            ...MODAL_PATTERNS.cookieConsent,
+            textPatterns: MODAL_PATTERNS.cookieConsent.textPatterns.source,
+            textPatternsFlags: MODAL_PATTERNS.cookieConsent.textPatterns.flags,
+        },
+        newsletter: {
+            ...MODAL_PATTERNS.newsletter,
+            textPatterns: MODAL_PATTERNS.newsletter.textPatterns.source,
+            textPatternsFlags: MODAL_PATTERNS.newsletter.textPatterns.flags,
+        },
+        ageVerification: {
+            ...MODAL_PATTERNS.ageVerification,
+            textPatterns: MODAL_PATTERNS.ageVerification.textPatterns.source,
+            textPatternsFlags: MODAL_PATTERNS.ageVerification.textPatterns.flags,
+        },
+        genericDialog: {
+            ...MODAL_PATTERNS.genericDialog,
+            textPatterns: null,
+            textPatternsFlags: null,
+        },
+    };
+    // Serialize functions and data to pass into browser context
+    const modals = await page.evaluate((opts) => {
+        const { minZIndex, minViewportCoverage, includeBackdrops, modalPatterns, commonSelectors, isBasicVisibleFn, isBlockingPositionFn, hasMinimumZIndexFn, coversMinimumViewportFn, isVisibleOnTopFn, isElementBlockingViewportFn, classifyModalFn, getDismissStrategiesFn, getUniqueSelectorFn, } = opts;
+        const global = globalThis;
+        // Reconstruct RegExp patterns from serialized strings
+        const reconstructedPatterns = {
+            cookieConsent: {
+                ...modalPatterns.cookieConsent,
+                textPatterns: new RegExp(modalPatterns.cookieConsent.textPatterns, modalPatterns.cookieConsent.textPatternsFlags),
+            },
+            newsletter: {
+                ...modalPatterns.newsletter,
+                textPatterns: new RegExp(modalPatterns.newsletter.textPatterns, modalPatterns.newsletter.textPatternsFlags),
+            },
+            ageVerification: {
+                ...modalPatterns.ageVerification,
+                textPatterns: new RegExp(modalPatterns.ageVerification.textPatterns, modalPatterns.ageVerification.textPatternsFlags),
+            },
+            genericDialog: {
+                ...modalPatterns.genericDialog,
+                textPatterns: null,
+            },
+        };
+        // Reconstruct helper functions first (needed by isElementBlockingViewport)
+        // Use eval without parentheses to define functions in scope
+        // eslint-disable-next-line no-eval
+        eval(isBasicVisibleFn);
+        // eslint-disable-next-line no-eval
+        eval(isBlockingPositionFn);
+        // eslint-disable-next-line no-eval
+        eval(hasMinimumZIndexFn);
+        // eslint-disable-next-line no-eval
+        eval(coversMinimumViewportFn);
+        // eslint-disable-next-line no-eval
+        eval(isVisibleOnTopFn);
+        // Now reconstruct main functions (these depend on the helpers above)
+        // eslint-disable-next-line no-eval
+        eval(isElementBlockingViewportFn);
+        // eslint-disable-next-line no-eval
+        eval(classifyModalFn);
+        // eslint-disable-next-line no-eval
+        eval(getDismissStrategiesFn);
+        // eslint-disable-next-line no-eval
+        eval(getUniqueSelectorFn);
+        // Reference the now-defined functions
+        // @ts-ignore - Functions are defined by eval above
+        const isElementBlockingViewportFunc = isElementBlockingViewport;
+        // @ts-ignore
+        const classifyModalFunc = classifyModal;
+        // @ts-ignore
+        const getDismissStrategiesFunc = getDismissStrategies;
+        // @ts-ignore
+        const getUniqueSelectorFunc = getUniqueSelector;
+        const detectedModals = [];
+        const candidateElements = [];
+        // Scan using common selectors
+        commonSelectors.forEach((selector) => {
+            try {
+                const elements = global.document.querySelectorAll(selector);
+                elements.forEach((el) => {
+                    if (!candidateElements.includes(el) &&
+                        isElementBlockingViewportFunc(el, minZIndex, minViewportCoverage)) {
+                        candidateElements.push(el);
+                    }
+                });
+            }
+            catch (e) {
+                // Ignore selector errors
+            }
+        });
+        // Fallback: scan all fixed/absolute positioned elements if no candidates found
+        if (candidateElements.length === 0) {
+            const allElements = global.document.querySelectorAll('*');
+            allElements.forEach((el) => {
+                const style = global.window.getComputedStyle(el);
+                if ((style.position === 'fixed' || style.position === 'absolute') &&
+                    isElementBlockingViewportFunc(el, minZIndex, minViewportCoverage)) {
+                    candidateElements.push(el);
+                }
+            });
+        }
+        // Process candidates
+        candidateElements.forEach((el, idx) => {
+            try {
+                const rect = el.getBoundingClientRect();
+                const style = global.window.getComputedStyle(el);
+                const zIndex = parseInt(style.zIndex, 10) || 0;
+                const classification = classifyModalFunc(el, reconstructedPatterns);
+                const strategies = getDismissStrategiesFunc(el, classification.type);
+                // Filter out backdrops if requested
+                if (!includeBackdrops && classification.type === 'blocking-overlay') {
+                    return;
+                }
+                const selector = getUniqueSelectorFunc(el);
+                detectedModals.push({
+                    selector: selector,
+                    type: classification.type,
+                    zIndex,
+                    boundingBox: {
+                        x: rect.left,
+                        y: rect.top,
+                        width: rect.width,
+                        height: rect.height,
+                    },
+                    dismissStrategies: strategies,
+                    confidence: classification.confidence,
+                    description: classification.description,
+                });
+            }
+            catch (e) {
+                // Ignore errors processing individual candidates
+            }
+        });
+        // Sort by z-index (highest first) and confidence
+        detectedModals.sort((a, b) => {
+            if (b.zIndex !== a.zIndex) {
+                return b.zIndex - a.zIndex;
+            }
+            return b.confidence - a.confidence;
+        });
+        return detectedModals;
+    }, {
+        minZIndex,
+        minViewportCoverage,
+        includeBackdrops,
+        modalPatterns: serializedPatterns,
+        commonSelectors: COMMON_MODAL_SELECTORS,
+        // Serialize helper functions first
+        isBasicVisibleFn: isBasicVisible.toString(),
+        isBlockingPositionFn: isBlockingPosition.toString(),
+        hasMinimumZIndexFn: hasMinimumZIndex.toString(),
+        coversMinimumViewportFn: coversMinimumViewport.toString(),
+        isVisibleOnTopFn: isVisibleOnTop.toString(),
+        // Then serialize main functions
+        isElementBlockingViewportFn: isElementBlockingViewport.toString(),
+        classifyModalFn: classifyModal.toString(),
+        getDismissStrategiesFn: getDismissStrategies.toString(),
+        getUniqueSelectorFn: getUniqueSelector.toString(),
+    });
+    await debugLog('ModalDetector', `Detected ${modals.length} modal(s)`);
+    return modals;
+}
+/**
+ * Checks if a specific element is blocked by a modal/overlay
+ *
+ * This uses the reverse approach (elementFromPoint) which is more reliable
+ * than proactive scanning
+ */
+export async function isElementBlocked(page, selector) {
+    await debugLog('ModalDetector', `Checking if element ${selector} is blocked`);
+    const result = await page.evaluate((sel) => {
+        const global = globalThis;
+        const element = global.document.querySelector(sel);
+        if (!element) {
+            return { blocked: false, error: 'Element not found' };
+        }
+        const rect = element.getBoundingClientRect();
+        const centerX = rect.left + rect.width / 2;
+        const centerY = rect.top + rect.height / 2;
+        // Check what element is at the target's center point
+        const topElement = global.document.elementFromPoint(centerX, centerY);
+        if (!topElement) {
+            return { blocked: false };
+        }
+        // If the top element is the target or a child, it's not blocked
+        if (topElement === element || element.contains(topElement)) {
+            return { blocked: false };
+        }
+        // Find the blocking element's topmost ancestor that's fixed/absolute
+        let blockingElement = topElement;
+        while (blockingElement && blockingElement !== global.document.body) {
+            const style = global.window.getComputedStyle(blockingElement);
+            const position = style.position;
+            if (position === 'fixed' || position === 'absolute') {
+                const zIndex = parseInt(style.zIndex, 10) || 0;
+                const blockingRect = blockingElement.getBoundingClientRect();
+                // Generate selector for blocking element
+                let blockingSelector;
+                if (blockingElement.id) {
+                    blockingSelector = `#${blockingElement.id}`;
+                }
+                else if (blockingElement.className && typeof blockingElement.className === 'string') {
+                    const classes = blockingElement.className.split(/\s+/).filter(Boolean);
+                    blockingSelector = classes.length > 0 ? `.${classes[0]}` : blockingElement.tagName.toLowerCase();
+                }
+                else {
+                    blockingSelector = blockingElement.tagName.toLowerCase();
+                }
+                return {
+                    blocked: true,
+                    blockingElement: {
+                        selector: blockingSelector,
+                        zIndex,
+                        boundingBox: {
+                            x: blockingRect.left,
+                            y: blockingRect.top,
+                            width: blockingRect.width,
+                            height: blockingRect.height,
+                        },
+                    },
+                };
+            }
+            blockingElement = blockingElement.parentElement;
+        }
+        return { blocked: true, blockingElement: null };
+    }, selector);
+    if (!result.blocked) {
+        await debugLog('ModalDetector', `Element ${selector} is not blocked`);
+        return { blocked: false };
+    }
+    // If we found a blocking element, try to classify it
+    if (result.blockingElement) {
+        const modals = await detectModals(page);
+        const matchingModal = modals.find(m => m.selector === result.blockingElement.selector);
+        if (matchingModal) {
+            await debugLog('ModalDetector', `Element ${selector} is blocked by modal: ${matchingModal.type}`);
+            return {
+                blocked: true,
+                blockingModal: matchingModal,
+            };
+        }
+        else {
+            await debugLog('ModalDetector', `Element ${selector} is blocked by unknown element`);
+            return {
+                blocked: true,
+                blockingModal: {
+                    ...result.blockingElement,
+                    type: 'unknown',
+                    dismissStrategies: ['remove'],
+                    confidence: 50,
+                    description: 'Unknown blocking element',
+                },
+            };
+        }
+    }
+    await debugLog('ModalDetector', `Element ${selector} is blocked (reason unknown)`);
+    return { blocked: true };
+}
+//# sourceMappingURL=modal-detector.js.map

package/build/utils/modal-detector.js.map

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

package/build/utils/modal-dismissal.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Modal dismissal utilities
+ *
+ * This module handles the logic for dismissing modals using various strategies.
+ * It was extracted from duplicate code in modal-tools.ts and input-tools.ts
+ */
+import type { Page } from 'puppeteer-core';
+import type { DetectedModalInfo as DetectedModal, DismissStrategy } from './modal-detection-core.js';
+export interface DismissalResult {
+    success: boolean;
+    method?: string;
+    error?: string;
+}
+/**
+ * Dismiss a modal using a specific strategy
+ *
+ * @param page - Puppeteer page instance
+ * @param modal - The detected modal to dismiss
+ * @param strategy - Dismissal strategy (accept, reject, close, remove)
+ * @param retryAttempts - Number of retry attempts when clicking buttons
+ * @returns Result indicating success or failure
+ */
+export declare function dismissModalByStrategy(page: Page, modal: DetectedModal, strategy: DismissStrategy, retryAttempts?: number): Promise<DismissalResult>;
+/**
+ * Select the best dismissal strategy based on modal type
+ *
+ * @param modal - The detected modal
+ * @param requestedStrategy - User-requested strategy or 'auto'
+ * @returns Effective strategy to use
+ */
+export declare function selectDismissalStrategy(modal: DetectedModal, requestedStrategy: DismissStrategy | 'auto'): DismissStrategy;
+//# sourceMappingURL=modal-dismissal.d.ts.map

package/build/utils/modal-dismissal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-dismissal.d.ts","sourceRoot":"","sources":["../../src/utils/modal-dismissal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,IAAI,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,eAAe,EACzB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,eAAe,CAAC,CA6I1B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,iBAAiB,EAAE,eAAe,GAAG,MAAM,GAC1C,eAAe,CAqCjB"}

package/build/utils/modal-dismissal.js

@@ -0,0 +1,190 @@
+/**
+ * Modal dismissal utilities
+ *
+ * This module handles the logic for dismissing modals using various strategies.
+ * It was extracted from duplicate code in modal-tools.ts and input-tools.ts
+ */
+/**
+ * Dismiss a modal using a specific strategy
+ *
+ * @param page - Puppeteer page instance
+ * @param modal - The detected modal to dismiss
+ * @param strategy - Dismissal strategy (accept, reject, close, remove)
+ * @param retryAttempts - Number of retry attempts when clicking buttons
+ * @returns Result indicating success or failure
+ */
+export async function dismissModalByStrategy(page, modal, strategy, retryAttempts = 3) {
+    // Remove strategy - just remove from DOM
+    if (strategy === 'remove') {
+        try {
+            await page.evaluate((sel) => {
+                const element = globalThis.document.querySelector(sel);
+                if (element) {
+                    element.remove();
+                    return true;
+                }
+                return false;
+            }, modal.selector);
+            // Verify removal
+            const stillExists = await page.$(modal.selector);
+            if (stillExists) {
+                return { success: false, error: 'Element still exists after removal attempt' };
+            }
+            return { success: true, method: 'DOM removal' };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    // Button click strategies - need to find appropriate button
+    const buttonSelectors = await page.evaluate((sel, strat) => {
+        const modal = globalThis.document.querySelector(sel);
+        if (!modal)
+            return [];
+        const selectors = [];
+        // Define button search patterns based on strategy
+        // TODO: These button text patterns are English-only. Non-English sites will fail button detection.
+        // Workaround: Use strategy: 'remove' for non-English sites.
+        // See KNOWN_LIMITATIONS.md "Language Limitations" section for details.
+        let textPatterns;
+        let classPatterns;
+        switch (strat) {
+            case 'accept':
+                textPatterns = /accept|agree|allow|enable|ok|got it|i accept|continue|yes/i;
+                classPatterns = ['accept', 'agree', 'allow', 'enable', 'ok', 'continue', 'yes'];
+                break;
+            case 'reject':
+                textPatterns = /reject|decline|deny|disable|no thanks|refuse|dismiss/i;
+                classPatterns = ['reject', 'decline', 'deny', 'refuse', 'no'];
+                break;
+            case 'close':
+                textPatterns = /close|dismiss|×|✕|✖|skip|no thanks/i;
+                classPatterns = ['close', 'dismiss', 'skip'];
+                break;
+            default:
+                return [];
+        }
+        // Find buttons within modal
+        const buttons = modal.querySelectorAll('button, [role="button"], a[href="#"], .button, .btn, [class*="button" i], [class*="btn" i]');
+        buttons.forEach((btn, idx) => {
+            const text = (btn.textContent || '').trim().toLowerCase();
+            const ariaLabel = (btn.getAttribute('aria-label') || '').toLowerCase();
+            const className = btn.className.toLowerCase();
+            const id = btn.id.toLowerCase();
+            const combined = `${text} ${ariaLabel} ${className} ${id}`;
+            // Check text pattern
+            if (textPatterns.test(combined)) {
+                // Try to create a unique selector
+                if (btn.id) {
+                    selectors.push(`#${btn.id}`);
+                }
+                else if (btn.className) {
+                    const classes = btn.className.split(/\s+/).filter(Boolean);
+                    if (classes.length > 0) {
+                        selectors.push(`${sel} .${classes.join('.')}`);
+                    }
+                }
+                else {
+                    // Fallback to nth-of-type
+                    selectors.push(`${sel} button:nth-of-type(${idx + 1})`);
+                }
+            }
+            // Check class patterns
+            classPatterns.forEach(pattern => {
+                if (className.includes(pattern.toLowerCase())) {
+                    if (btn.id) {
+                        selectors.push(`#${btn.id}`);
+                    }
+                    else if (btn.className) {
+                        const classes = btn.className.split(/\s+/).filter(Boolean);
+                        selectors.push(`${sel} .${classes.join('.')}`);
+                    }
+                }
+            });
+        });
+        return [...new Set(selectors)]; // Remove duplicates
+    }, modal.selector, strategy);
+    // Try each button selector
+    for (const btnSelector of buttonSelectors) {
+        for (let attempt = 0; attempt < retryAttempts; attempt++) {
+            try {
+                const button = await page.$(btnSelector);
+                if (!button)
+                    continue;
+                // Click the button
+                await button.click();
+                // Wait for modal to disappear (with timeout)
+                try {
+                    await page.waitForSelector(modal.selector, { hidden: true, timeout: 1000 });
+                    return { success: true, method: `Clicked button: ${btnSelector}` };
+                }
+                catch (e) {
+                    // Modal didn't disappear, try next button
+                    continue;
+                }
+            }
+            catch (error) {
+                // Try next button or retry
+                continue;
+            }
+        }
+    }
+    // If no buttons worked, fall back to DOM removal
+    if (buttonSelectors.length === 0) {
+        return {
+            success: false,
+            error: `No ${strategy} buttons found in modal. Use strategy "remove" to force removal.`,
+        };
+    }
+    return {
+        success: false,
+        error: `Found ${buttonSelectors.length} potential ${strategy} button(s) but none successfully dismissed the modal`,
+    };
+}
+/**
+ * Select the best dismissal strategy based on modal type
+ *
+ * @param modal - The detected modal
+ * @param requestedStrategy - User-requested strategy or 'auto'
+ * @returns Effective strategy to use
+ */
+export function selectDismissalStrategy(modal, requestedStrategy) {
+    if (requestedStrategy === 'auto') {
+        // Smart strategy selection based on modal type
+        switch (modal.type) {
+            case 'cookie-consent':
+                // Prefer accept for cookie consents (least friction)
+                return modal.dismissStrategies.includes('accept')
+                    ? 'accept'
+                    : modal.dismissStrategies.includes('close')
+                        ? 'close'
+                        : 'remove';
+            case 'newsletter-popup':
+                // Prefer close for newsletters (non-committal)
+                return modal.dismissStrategies.includes('close')
+                    ? 'close'
+                    : modal.dismissStrategies.includes('reject')
+                        ? 'reject'
+                        : 'remove';
+            case 'age-verification':
+                // Prefer accept for age gates (necessary)
+                return modal.dismissStrategies.includes('accept')
+                    ? 'accept'
+                    : 'remove';
+            default:
+                // For unknown modals, prefer close, then remove
+                return modal.dismissStrategies.includes('close')
+                    ? 'close'
+                    : 'remove';
+        }
+    }
+    else {
+        // Use requested strategy if available
+        if (!modal.dismissStrategies.includes(requestedStrategy)) {
+            // Fall back to remove if requested strategy not available
+            return 'remove';
+        }
+        return requestedStrategy;
+    }
+}
+//# sourceMappingURL=modal-dismissal.js.map

package/build/utils/modal-dismissal.js.map

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

package/build/utils/port-check.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Port Check Utility
+ * Check if a port is open before attempting to connect
+ */
+export interface PortCheckResult {
+    open: boolean;
+    host: string;
+    port: number;
+    error?: string;
+}
+/**
+ * Check if a port is open on a given host
+ * @param port The port number to check
+ * @param host The host to check (default: localhost)
+ * @param timeoutMs Timeout in milliseconds (default: 2000)
+ */
+export declare function checkPort(port: number, host?: string, timeoutMs?: number): Promise<PortCheckResult>;
+/**
+ * Parse a URL and extract host and port
+ * Returns null if URL is invalid or doesn't have a port
+ */
+export declare function parseUrlForPortCheck(url: string): {
+    host: string;
+    port: number;
+} | null;
+/**
+ * Check if a URL's server is reachable
+ * Only checks localhost/127.0.0.1 URLs (skips external URLs)
+ */
+export declare function checkUrlPort(url: string, timeoutMs?: number): Promise<PortCheckResult | null>;
+//# sourceMappingURL=port-check.d.ts.map

package/build/utils/port-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-check.d.ts","sourceRoot":"","sources":["../../src/utils/port-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAoB,EAC1B,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,eAAe,CAAC,CAkC1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBvF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAgBjC"}

package/build/utils/port-check.js

@@ -0,0 +1,87 @@
+/**
+ * Port Check Utility
+ * Check if a port is open before attempting to connect
+ */
+import * as net from 'net';
+/**
+ * Check if a port is open on a given host
+ * @param port The port number to check
+ * @param host The host to check (default: localhost)
+ * @param timeoutMs Timeout in milliseconds (default: 2000)
+ */
+export async function checkPort(port, host = 'localhost', timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        const socket = new net.Socket();
+        let resolved = false;
+        const cleanup = () => {
+            if (!resolved) {
+                resolved = true;
+                socket.destroy();
+            }
+        };
+        socket.setTimeout(timeoutMs);
+        socket.on('connect', () => {
+            cleanup();
+            resolve({ open: true, host, port });
+        });
+        socket.on('timeout', () => {
+            cleanup();
+            resolve({ open: false, host, port, error: 'Connection timed out' });
+        });
+        socket.on('error', (err) => {
+            cleanup();
+            const errorMessage = err.code === 'ECONNREFUSED'
+                ? 'Connection refused'
+                : err.message;
+            resolve({ open: false, host, port, error: errorMessage });
+        });
+        socket.connect(port, host);
+    });
+}
+/**
+ * Parse a URL and extract host and port
+ * Returns null if URL is invalid or doesn't have a port
+ */
+export function parseUrlForPortCheck(url) {
+    try {
+        const parsed = new URL(url);
+        const host = parsed.hostname;
+        // Get port from URL or use default based on protocol
+        let port;
+        if (parsed.port) {
+            port = parseInt(parsed.port, 10);
+        }
+        else if (parsed.protocol === 'https:') {
+            port = 443;
+        }
+        else if (parsed.protocol === 'http:') {
+            port = 80;
+        }
+        else {
+            return null;
+        }
+        return { host, port };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a URL's server is reachable
+ * Only checks localhost/127.0.0.1 URLs (skips external URLs)
+ */
+export async function checkUrlPort(url, timeoutMs = 2000) {
+    const parsed = parseUrlForPortCheck(url);
+    if (!parsed) {
+        return null;
+    }
+    // Only check localhost URLs - external sites may have firewalls, CDNs, etc.
+    const isLocalhost = parsed.host === 'localhost' ||
+        parsed.host === '127.0.0.1' ||
+        parsed.host === '0.0.0.0';
+    if (!isLocalhost) {
+        return null; // Skip check for non-localhost
+    }
+    return checkPort(parsed.port, parsed.host, timeoutMs);
+}
+//# sourceMappingURL=port-check.js.map

package/build/utils/port-check.js.map

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