browser-debugger-cli 0.5.1 → 0.6.1

package/dist/connection/tabs.js

@@ -1,227 +0,0 @@
-import { normalizeUrl } from '../utils/url.js';
-/**
- * Score how well a tab matches the search URL.
- * Higher score = better match.
- *
- * @param tab - Target to score
- * @param searchUrl - Normalized URL to match against
- * @returns Match score (0-100)
- */
-function scoreTabMatch(tab, searchUrl) {
-    // Exact match = best score
-    if (tab.url === searchUrl) {
-        return 100;
-    }
-    // Try URL-based matching
-    try {
-        const tabUrlObj = new URL(tab.url);
-        const searchUrlObj = new URL(searchUrl);
-        // Same host + path = excellent score
-        if (tabUrlObj.host === searchUrlObj.host && tabUrlObj.pathname === searchUrlObj.pathname) {
-            return 90;
-        }
-        // Same host + path prefix = good score
-        if (tabUrlObj.host === searchUrlObj.host &&
-            tabUrlObj.pathname.startsWith(searchUrlObj.pathname)) {
-            return 70;
-        }
-        // Same host = decent score
-        if (tabUrlObj.host === searchUrlObj.host) {
-            return 50;
-        }
-    }
-    catch {
-        // URL parsing failed, fall back to substring matching
-    }
-    // Substring match = weak score
-    if (tab.url.includes(searchUrl)) {
-        return 30;
-    }
-    return 0; // No match
-}
-/**
- * Find the best matching target from a list of tabs.
- *
- * @param normalizedUrl - Target URL to find (must be pre-normalized)
- * @param targets - List of available targets
- * @returns Best matching target or null if no match found
- */
-export function findBestTarget(normalizedUrl, targets) {
-    const searchUrl = normalizedUrl;
-    // Filter for page targets only
-    const pageTargets = targets.filter((t) => t.type === 'page');
-    if (pageTargets.length === 0) {
-        return null;
-    }
-    // Score all targets
-    const scored = pageTargets
-        .map((t) => ({ target: t, score: scoreTabMatch(t, searchUrl) }))
-        .filter(({ score }) => score > 0)
-        .sort((a, b) => b.score - a.score);
-    if (scored.length === 0) {
-        return null;
-    }
-    // Warn if multiple tabs have same score
-    const first = scored[0];
-    const second = scored[1];
-    if (scored.length > 1 && first && second && first.score === second.score && first.score < 100) {
-        console.error(`Warning: Multiple tabs match equally (score ${first.score}), using: ${first.target.url}`);
-    }
-    return first ? first.target : null;
-}
-/**
- * Create a new tab with the specified URL using CDP.
- *
- * @param normalizedUrl - URL to open in the new tab (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @returns Target information for the new tab
- * @throws Error if tab creation fails via both CDP and HTTP fallback methods
- */
-export async function createNewTab(normalizedUrl, cdp) {
-    const port = cdp.getPort();
-    let createdTargetId = null;
-    try {
-        const response = (await cdp.send('Target.createTarget', {
-            url: normalizedUrl,
-            newWindow: false, // Open as tab, not window
-        }));
-        createdTargetId = response.targetId;
-    }
-    catch (error) {
-        console.error('CDP Target.createTarget failed, attempting HTTP fallback...', error);
-    }
-    if (createdTargetId) {
-        try {
-            const listResponse = await fetch(`http://127.0.0.1:${port}/json/list`);
-            if (!listResponse.ok) {
-                throw new Error(`Failed to list targets: ${listResponse.status} ${listResponse.statusText}`);
-            }
-            const targets = (await listResponse.json());
-            const target = targets.find((t) => t.id === createdTargetId);
-            if (!target) {
-                throw new Error(`Created target ${createdTargetId} not found in Chrome target list`);
-            }
-            return target;
-        }
-        catch (resolveError) {
-            throw new Error(`Failed to resolve created tab: ${resolveError instanceof Error ? resolveError.message : String(resolveError)}`);
-        }
-    }
-    // Fallback to HTTP endpoint method
-    try {
-        const createResponse = await fetch(`http://127.0.0.1:${port}/json/new?${encodeURIComponent(normalizedUrl)}`);
-        if (!createResponse.ok) {
-            throw new Error(`HTTP /json/new failed: ${createResponse.statusText}`);
-        }
-        const target = (await createResponse.json());
-        return target;
-    }
-    catch (httpError) {
-        throw new Error(`Failed to create new tab: ${httpError instanceof Error ? httpError.message : String(httpError)}`);
-    }
-}
-/**
- * Navigate an existing tab to a new URL using CDP.
- *
- * @param targetId - CDP target ID to navigate
- * @param normalizedUrl - URL to navigate to (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @throws Error if navigation fails (e.g., network error, invalid URL, blocked by browser)
- */
-export async function navigateToUrl(targetId, normalizedUrl, cdp) {
-    // Attach to target
-    const sessionResponse = (await cdp.send('Target.attachToTarget', {
-        targetId,
-        flatten: true,
-    }));
-    // Navigate
-    const navResponse = (await cdp.send('Page.navigate', { url: normalizedUrl }, sessionResponse.sessionId));
-    if (navResponse.errorText) {
-        throw new Error(`Navigation failed: ${navResponse.errorText}`);
-    }
-}
-/**
- * Wait for a target to be ready (URL matches expected).
- *
- * @param targetId - CDP target ID to wait for
- * @param normalizedUrl - Expected URL (must be pre-normalized)
- * @param cdp - CDP connection instance
- * @param maxWaitMs - Maximum time to wait in milliseconds
- * @throws Error if target doesn't become ready within maxWaitMs timeout
- */
-export async function waitForTargetReady(targetId, normalizedUrl, cdp, maxWaitMs = 15000) {
-    const startTime = Date.now();
-    while (Date.now() - startTime < maxWaitMs) {
-        try {
-            // Fetch current targets
-            const response = await fetch(`http://127.0.0.1:${cdp.getPort()}/json/list`);
-            const targets = (await response.json());
-            const target = targets.find((t) => t.id === targetId);
-            if (target) {
-                // Check if URL matches or is loading
-                if (target.url === normalizedUrl ||
-                    target.url.startsWith(normalizedUrl) ||
-                    target.url === 'about:blank' // Still loading
-                ) {
-                    // Wait a bit more if still on about:blank
-                    if (target.url === 'about:blank') {
-                        await new Promise((resolve) => setTimeout(resolve, 500));
-                        continue;
-                    }
-                    return; // Target is ready!
-                }
-            }
-        }
-        catch {
-            // Target doesn't exist yet or fetch failed, keep waiting
-        }
-        await new Promise((resolve) => setTimeout(resolve, 200));
-    }
-    throw new Error(`Target did not become ready within ${maxWaitMs}ms`);
-}
-/**
- * Create a new tab or find existing tab with the target URL.
- *
- * This is the main entry point for tab management.
- * It tries to find an existing tab first, and if not found,
- * creates a new one.
- *
- * @param url - Target URL (will be normalized once at entry)
- * @param cdp - CDP connection instance
- * @param reuseTab - If true, navigate existing tab instead of creating new one
- * @returns Target information
- */
-export async function createOrFindTarget(url, cdp, reuseTab = false) {
-    // Normalize URL once at entry point
-    const normalizedUrl = normalizeUrl(url);
-    // Only look for existing tabs if reuseTab is true
-    if (reuseTab) {
-        // Try to find existing target via CDP
-        const targetsResponse = (await cdp.send('Target.getTargets'));
-        const targets = targetsResponse.targetInfos.map((info) => ({
-            id: info.targetId,
-            type: info.type,
-            url: info.url,
-            title: info.title,
-            webSocketDebuggerUrl: '', // Not needed for this operation
-        }));
-        const existingTarget = findBestTarget(normalizedUrl, targets);
-        if (existingTarget) {
-            console.error(`Found existing tab: ${existingTarget.url}`);
-            // If URLs don't match exactly, navigate
-            if (existingTarget.url !== normalizedUrl) {
-                console.error(`Navigating tab to: ${normalizedUrl}`);
-                await navigateToUrl(existingTarget.id, normalizedUrl, cdp);
-                await waitForTargetReady(existingTarget.id, normalizedUrl, cdp);
-            }
-            return existingTarget;
-        }
-    }
-    // No matching tab found (or reuseTab=false), create new one
-    console.error(`Creating new tab for: ${normalizedUrl}`);
-    const newTarget = await createNewTab(normalizedUrl, cdp);
-    // Wait for tab to start loading
-    await waitForTargetReady(newTarget.id, normalizedUrl, cdp);
-    return newTarget;
-}
-//# sourceMappingURL=tabs.js.map

package/dist/connection/tabs.js.map

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

package/dist/help/machineReadableHelp.d.ts

@@ -1,100 +0,0 @@
-/**
- * Machine-readable help generation using Commander.js introspection API.
- *
- * @module help/machineReadableHelp
- */
-import type { Command } from 'commander';
-/**
- * Option metadata for machine-readable help.
- */
-export interface OptionMetadata {
-    /** Option flags (e.g., "-j, --json") */
-    flags: string;
-    /** Option description */
-    description: string;
-    /** Whether option is required */
-    required: boolean;
-    /** Whether option has an optional value */
-    optional: boolean;
-    /** Default value if any */
-    defaultValue?: unknown;
-    /** Description of default value */
-    defaultValueDescription?: string;
-    /** Allowed choices if restricted */
-    choices?: readonly string[];
-}
-/**
- * Argument metadata for machine-readable help.
- */
-export interface ArgumentMetadata {
-    /** Argument name */
-    name: string;
-    /** Argument description */
-    description: string;
-    /** Whether argument is required */
-    required: boolean;
-    /** Whether argument accepts multiple values */
-    variadic: boolean;
-    /** Default value if any */
-    defaultValue?: unknown;
-    /** Allowed choices if restricted */
-    choices?: readonly string[];
-}
-/**
- * Command metadata for machine-readable help.
- */
-export interface CommandMetadata {
-    /** Command name */
-    name: string;
-    /** Command aliases */
-    aliases: readonly string[];
-    /** Command description */
-    description: string;
-    /** Command usage string */
-    usage: string;
-    /** Command arguments */
-    arguments: ArgumentMetadata[];
-    /** Command options */
-    options: OptionMetadata[];
-    /** Subcommands */
-    subcommands: CommandMetadata[];
-}
-/**
- * Root machine-readable help structure.
- */
-export interface MachineReadableHelp {
-    /** CLI name */
-    name: string;
-    /** CLI version */
-    version: string;
-    /** CLI description */
-    description: string;
-    /** Root command metadata */
-    command: CommandMetadata;
-    /** Exit code documentation */
-    exitCodes: {
-        /** Exit code value */
-        code: number;
-        /** Exit code name */
-        name: string;
-        /** Exit code description */
-        description: string;
-    }[];
-}
-/**
- * Generates machine-readable help from a Commander program.
- *
- * @param program - Commander program instance
- * @returns Machine-readable help structure
- *
- * @example
- * ```typescript
- * import { program } from 'commander';
- * import { generateMachineReadableHelp } from './help/machineReadableHelp.js';
- *
- * const help = generateMachineReadableHelp(program);
- * console.log(JSON.stringify(help, null, 2));
- * ```
- */
-export declare function generateMachineReadableHelp(program: Command): MachineReadableHelp;
-//# sourceMappingURL=machineReadableHelp.d.ts.map

package/dist/help/machineReadableHelp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"machineReadableHelp.d.ts","sourceRoot":"","sources":["../../src/help/machineReadableHelp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,sBAAsB;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,kBAAkB;IAClB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,8BAA8B;IAC9B,SAAS,EAAE;QACT,sBAAsB;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,4BAA4B;QAC5B,WAAW,EAAE,MAAM,CAAC;KACrB,EAAE,CAAC;CACL;AAuDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAkEjF"}

package/dist/help/machineReadableHelp.js

@@ -1,139 +0,0 @@
-/**
- * Machine-readable help generation using Commander.js introspection API.
- *
- * @module help/machineReadableHelp
- */
-import { filterDefined } from '../utils/objects.js';
-/**
- * Converts a Commander Option to OptionMetadata.
- *
- * @param option - Commander option instance
- * @returns Option metadata
- */
-function convertOption(option) {
-    return filterDefined({
-        flags: option.flags,
-        description: option.description,
-        required: option.required,
-        optional: option.optional,
-        defaultValue: option.defaultValue,
-        defaultValueDescription: option.defaultValueDescription,
-        choices: option.argChoices,
-    });
-}
-/**
- * Converts a Commander Argument to ArgumentMetadata.
- *
- * @param argument - Commander argument instance
- * @returns Argument metadata
- */
-function convertArgument(argument) {
-    return filterDefined({
-        name: argument.name(),
-        description: argument.description,
-        required: argument.required,
-        variadic: argument.variadic,
-        defaultValue: argument.defaultValue,
-        choices: argument.argChoices,
-    });
-}
-/**
- * Recursively converts a Commander Command to CommandMetadata.
- *
- * @param command - Commander command instance
- * @returns Command metadata
- */
-function convertCommand(command) {
-    return {
-        name: command.name(),
-        aliases: command.aliases(),
-        description: command.description(),
-        usage: command.usage(),
-        arguments: command.registeredArguments.map(convertArgument),
-        options: command.options.map(convertOption),
-        subcommands: command.commands.map(convertCommand),
-    };
-}
-/**
- * Generates machine-readable help from a Commander program.
- *
- * @param program - Commander program instance
- * @returns Machine-readable help structure
- *
- * @example
- * ```typescript
- * import { program } from 'commander';
- * import { generateMachineReadableHelp } from './help/machineReadableHelp.js';
- *
- * const help = generateMachineReadableHelp(program);
- * console.log(JSON.stringify(help, null, 2));
- * ```
- */
-export function generateMachineReadableHelp(program) {
-    return {
-        name: program.name(),
-        version: program.version() ?? 'unknown',
-        description: program.description(),
-        command: convertCommand(program),
-        exitCodes: [
-            { code: 0, name: 'SUCCESS', description: 'Operation completed successfully' },
-            { code: 1, name: 'GENERIC_FAILURE', description: 'Generic failure' },
-            {
-                code: 80,
-                name: 'INVALID_URL',
-                description: 'Invalid URL format provided',
-            },
-            {
-                code: 81,
-                name: 'INVALID_ARGUMENTS',
-                description: 'Invalid command arguments',
-            },
-            {
-                code: 82,
-                name: 'PERMISSION_DENIED',
-                description: 'Insufficient permissions',
-            },
-            {
-                code: 83,
-                name: 'RESOURCE_NOT_FOUND',
-                description: 'Required resource not found',
-            },
-            {
-                code: 84,
-                name: 'RESOURCE_BUSY',
-                description: 'Resource is currently in use',
-            },
-            {
-                code: 85,
-                name: 'OPERATION_NOT_PERMITTED',
-                description: 'Operation not permitted in current state',
-            },
-            {
-                code: 86,
-                name: 'DAEMON_ALREADY_RUNNING',
-                description: 'Daemon is already running',
-            },
-            {
-                code: 100,
-                name: 'CHROME_LAUNCH_FAILURE',
-                description: 'Failed to launch Chrome browser',
-            },
-            {
-                code: 101,
-                name: 'CDP_CONNECTION_FAILURE',
-                description: 'Failed to connect to Chrome DevTools Protocol',
-            },
-            {
-                code: 102,
-                name: 'CDP_TIMEOUT',
-                description: 'CDP operation timed out',
-            },
-            {
-                code: 110,
-                name: 'IPC_ERROR',
-                description: 'Inter-process communication error',
-            },
-        ],
-    };
-}
-//# sourceMappingURL=machineReadableHelp.js.map

package/dist/help/machineReadableHelp.js.map

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