@jshookmcp/jshook 0.2.5 → 0.2.7

package/dist/src/modules/browser/CamoufoxBrowserManager.js

@@ -1,183 +0,0 @@
-import { logger } from '../../utils/logger.js';
-import { PrerequisiteError } from '../../errors/PrerequisiteError.js';
-export class CamoufoxBrowserManager {
-    browser = null;
-    browserServer = null;
-    config;
-    isClosing = false;
-    launchPromise;
-    constructor(config = {}) {
-        this.config = {
-            os: config.os ?? 'windows',
-            headless: config.headless ?? true,
-            geoip: config.geoip ?? false,
-            humanize: config.humanize ?? false,
-            blockImages: config.blockImages ?? false,
-            blockWebrtc: config.blockWebrtc ?? false,
-            proxy: config.proxy,
-        };
-    }
-    async launch() {
-        if (this.browser?.isConnected()) {
-            return this.browser;
-        }
-        if (this.isClosing) {
-            throw new Error('Cannot launch browser while closing');
-        }
-        if (this.launchPromise) {
-            return this.launchPromise;
-        }
-        this.launchPromise = this.doLaunch();
-        try {
-            return await this.launchPromise;
-        }
-        finally {
-            this.launchPromise = undefined;
-        }
-    }
-    async doLaunch() {
-        if (this.browser) {
-            logger.info('Closing existing Camoufox browser before relaunch');
-            await this.browser
-                .close()
-                .catch((err) => logger.warn('Failed to close previous browser:', err));
-            this.browser = null;
-        }
-        logger.info(`Launching Camoufox (Firefox) [os=${this.config.os}, headless=${this.config.headless}]...`);
-        let Camoufox;
-        try {
-            ({ Camoufox } = await import('camoufox-js'));
-        }
-        catch (error) {
-            throw new PrerequisiteError(`camoufox-js is not installed or its binaries are missing. Run \`pnpm run install:full\` or \`pnpm exec camoufox-js fetch\` before using the Camoufox driver. Root cause: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        this.browser = (await Camoufox({
-            os: this.config.os,
-            headless: this.config.headless,
-            geoip: this.config.geoip,
-            humanize: this.config.humanize,
-            proxy: this.config.proxy,
-            block_images: this.config.blockImages,
-            block_webrtc: this.config.blockWebrtc,
-        }));
-        if (this.isClosing) {
-            await this.browser.close().catch((error) => {
-                logger.warn('Failed to close Camoufox browser launched during shutdown:', error);
-            });
-            this.browser = null;
-            throw new Error('Camoufox launch aborted because close was requested');
-        }
-        logger.info('Camoufox browser launched');
-        return this.browser;
-    }
-    async newPage() {
-        if (!this.browser) {
-            await this.launch();
-        }
-        const page = await this.browser.newPage();
-        logger.info('New Camoufox page created');
-        return page;
-    }
-    async goto(url, page) {
-        const targetPage = page ?? (await this.newPage());
-        logger.info(`Navigating to: ${url}`);
-        await targetPage.goto(url, { waitUntil: 'networkidle' });
-        return targetPage;
-    }
-    async close() {
-        this.isClosing = true;
-        const pendingLaunch = this.launchPromise;
-        if (pendingLaunch) {
-            void pendingLaunch
-                .catch(() => undefined)
-                .finally(() => {
-                void this.finalizeClose();
-            });
-            return;
-        }
-        await this.finalizeClose();
-    }
-    static BROWSER_CLOSE_TIMEOUT_MS = 5000;
-    async finalizeClose() {
-        try {
-            const browser = this.browser;
-            this.browser = null;
-            if (browser) {
-                await Promise.race([
-                    browser.close(),
-                    new Promise((_, reject) => setTimeout(() => reject(new Error('camoufox browser.close() timed out')), CamoufoxBrowserManager.BROWSER_CLOSE_TIMEOUT_MS)),
-                ]);
-                logger.info('Camoufox browser closed');
-            }
-        }
-        finally {
-            this.isClosing = false;
-        }
-    }
-    async launchAsServer(port, ws_path) {
-        logger.info(`Launching Camoufox server [os=${this.config.os}, port=${port ?? 'auto'}]...`);
-        let launchServer;
-        try {
-            ({ launchServer } = await import('camoufox-js'));
-        }
-        catch (error) {
-            throw new PrerequisiteError(`camoufox-js server support is unavailable. Run \`pnpm run install:full\` or \`pnpm exec camoufox-js fetch\` before launching a Camoufox WebSocket server. Root cause: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        const serverOptions = {
-            os: this.config.os,
-            headless: this.config.headless,
-            geoip: this.config.geoip,
-            humanize: this.config.humanize,
-            proxy: this.config.proxy,
-            block_images: this.config.blockImages,
-            block_webrtc: this.config.blockWebrtc,
-            port,
-            ws_path,
-        };
-        if (this.browserServer) {
-            logger.info('Closing existing Camoufox server before relaunch');
-            await this.browserServer
-                .close()
-                .catch((err) => logger.warn('Failed to close previous server:', err));
-            this.browserServer = null;
-        }
-        const server = await launchServer(serverOptions);
-        this.browserServer = server;
-        const endpoint = server.wsEndpoint();
-        logger.info(`Camoufox server listening on: ${endpoint}`);
-        return endpoint;
-    }
-    async connectToServer(wsEndpoint) {
-        logger.info(`Connecting to Camoufox server: ${wsEndpoint}`);
-        if (this.browser) {
-            logger.info('Disconnecting existing browser before new connection');
-            await this.browser
-                .close()
-                .catch((err) => logger.warn('Failed to close previous browser:', err));
-            this.browser = null;
-        }
-        const playwrightModule = await import('playwright-core');
-        const firefox = playwrightModule.firefox;
-        this.browser = (await firefox.connect(wsEndpoint));
-        logger.info('Connected to Camoufox server');
-        return this.browser;
-    }
-    async closeBrowserServer() {
-        if (this.browserServer) {
-            await this.browserServer.close();
-            this.browserServer = null;
-            logger.info('Camoufox server closed');
-        }
-    }
-    getBrowserServerEndpoint() {
-        return this.browserServer ? this.browserServer.wsEndpoint() : null;
-    }
-    getBrowser() {
-        return this.browser;
-    }
-    async getCDPSession(page) {
-        logger.warn('CDP sessions on camoufox (Firefox) have limited support — consider using Chrome driver for CDP-heavy operations');
-        const context = page.context();
-        return context.newCDPSession(page);
-    }
-}

package/dist/src/modules/browser/HookHeartbeat.d.ts

@@ -1,38 +0,0 @@
-export interface HeartbeatScript {
-    id: string;
-    source: string;
-}
-export interface HeartbeatOptions {
-    debounceMs?: number;
-    mainFrameOnly?: boolean;
-}
-interface PageLike {
-    on(event: 'framenavigated', handler: (frame: FrameLike) => void): void;
-    off(event: 'framenavigated', handler: (frame: FrameLike) => void): void;
-    evaluate(fn: string): Promise<unknown>;
-    isClosed(): boolean;
-    mainFrame(): FrameLike;
-}
-interface FrameLike {
-    url(): string;
-    parentFrame(): FrameLike | null;
-}
-export declare class HookHeartbeat {
-    private readonly page;
-    private readonly scripts;
-    private readonly debounceMs;
-    private readonly mainFrameOnly;
-    private debounceTimer;
-    private running;
-    private readonly boundHandler;
-    constructor(page: PageLike, options?: HeartbeatOptions);
-    addScript(script: HeartbeatScript): this;
-    removeScript(id: string): this;
-    start(): this;
-    stop(): void;
-    get isRunning(): boolean;
-    get scriptCount(): number;
-    private onFrameNavigated;
-    private reinjectAll;
-}
-export {};

package/dist/src/modules/browser/HookHeartbeat.js

@@ -1,76 +0,0 @@
-import { logger } from '../../utils/logger.js';
-export class HookHeartbeat {
-    page;
-    scripts = new Map();
-    debounceMs;
-    mainFrameOnly;
-    debounceTimer = null;
-    running = false;
-    boundHandler;
-    constructor(page, options) {
-        this.page = page;
-        this.debounceMs = options?.debounceMs ?? 150;
-        this.mainFrameOnly = options?.mainFrameOnly ?? true;
-        this.boundHandler = this.onFrameNavigated.bind(this);
-    }
-    addScript(script) {
-        this.scripts.set(script.id, script);
-        return this;
-    }
-    removeScript(id) {
-        this.scripts.delete(id);
-        return this;
-    }
-    start() {
-        if (this.running)
-            return this;
-        this.running = true;
-        this.page.on('framenavigated', this.boundHandler);
-        logger.debug(`[HookHeartbeat] Started monitoring (${this.scripts.size} scripts, debounce=${this.debounceMs}ms)`);
-        return this;
-    }
-    stop() {
-        if (!this.running)
-            return;
-        this.running = false;
-        this.page.off('framenavigated', this.boundHandler);
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-            this.debounceTimer = null;
-        }
-        logger.debug('[HookHeartbeat] Stopped monitoring');
-    }
-    get isRunning() {
-        return this.running;
-    }
-    get scriptCount() {
-        return this.scripts.size;
-    }
-    onFrameNavigated(frame) {
-        if (this.mainFrameOnly && frame.parentFrame() !== null) {
-            return;
-        }
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-        }
-        this.debounceTimer = setTimeout(() => {
-            this.debounceTimer = null;
-            void this.reinjectAll(frame.url());
-        }, this.debounceMs);
-    }
-    async reinjectAll(url) {
-        if (!this.running || this.page.isClosed())
-            return;
-        if (this.scripts.size === 0)
-            return;
-        logger.debug(`[HookHeartbeat] Re-injecting ${this.scripts.size} scripts after navigation to ${url}`);
-        for (const [id, script] of this.scripts) {
-            try {
-                await this.page.evaluate(script.source);
-            }
-            catch (error) {
-                logger.warn(`[HookHeartbeat] Failed to re-inject script "${id}":`, error);
-            }
-        }
-    }
-}

package/dist/src/modules/browser/TabRegistry.d.ts

@@ -1,66 +0,0 @@
-export interface TabDescriptor<PageLike = unknown> {
-    pageId: string;
-    index: number;
-    url: string;
-    title: string;
-    page: PageLike;
-    aliases: string[];
-    stale: boolean;
-}
-export interface CurrentTabInfo {
-    driver: 'chrome' | 'camoufox';
-    currentPageId: string | null;
-    currentIndex: number | null;
-    url: string | null;
-    title: string | null;
-    aliases: Array<{
-        alias: string;
-        pageId: string;
-        index: number | null;
-        stale: boolean;
-    }>;
-    staleAliases: string[];
-}
-export interface PageMeta {
-    index: number;
-    url: string;
-    title: string;
-}
-export declare class TabRegistry<PageLike = unknown> {
-    private pageIdByHandle;
-    private tabsById;
-    private aliasToPageId;
-    private currentPageId;
-    private sharedContext;
-    registerPage(page: PageLike, meta: PageMeta): string;
-    reconcilePages(pages: PageLike[], metaList: PageMeta[]): TabDescriptor<PageLike>[];
-    bindAlias(alias: string, pageId: string): boolean;
-    bindAliasByIndex(alias: string, index: number): string | null;
-    unbindAlias(alias: string): boolean;
-    resolveAlias(alias: string): string | null;
-    getPageById(pageId: string): PageLike | null;
-    getTabById(pageId: string): TabDescriptor<PageLike> | null;
-    getTabByIndex(index: number): TabDescriptor<PageLike> | null;
-    findTab(predicate: (tab: TabDescriptor<PageLike>) => boolean): TabDescriptor<PageLike> | null;
-    setCurrentPageId(pageId: string): boolean;
-    setCurrentByIndex(index: number): TabDescriptor<PageLike> | null;
-    getCurrentPageId(): string | null;
-    getCurrentPage(): PageLike | null;
-    getCurrentTabInfo(driver: 'chrome' | 'camoufox'): CurrentTabInfo;
-    getContextMeta(): {
-        url: string | null;
-        title: string | null;
-        tabIndex: number | null;
-        pageId: string | null;
-    };
-    listTabs(): TabDescriptor<PageLike>[];
-    listAllTabs(): TabDescriptor<PageLike>[];
-    setSharedContext(key: string, value: unknown): void;
-    getSharedContext(key: string): {
-        value: unknown;
-        found: boolean;
-    };
-    getSharedContextMap(): Record<string, unknown>;
-    clear(): void;
-    private getAliasesForPageId;
-}

package/dist/src/modules/browser/TabRegistry.js

@@ -1,238 +0,0 @@
-import { logger } from '../../utils/logger.js';
-let globalIdCounter = 0;
-export class TabRegistry {
-    pageIdByHandle = new WeakMap();
-    tabsById = new Map();
-    aliasToPageId = new Map();
-    currentPageId = null;
-    sharedContext = new Map();
-    registerPage(page, meta) {
-        const handle = page;
-        const existingId = this.pageIdByHandle.get(handle);
-        if (existingId) {
-            const existing = this.tabsById.get(existingId);
-            if (existing) {
-                existing.meta = meta;
-                existing.stale = false;
-            }
-            else {
-                this.tabsById.set(existingId, { page, meta, stale: false });
-            }
-            return existingId;
-        }
-        globalIdCounter += 1;
-        const pageId = `tab-${globalIdCounter}`;
-        this.pageIdByHandle.set(handle, pageId);
-        this.tabsById.set(pageId, { page, meta, stale: false });
-        logger.debug(`[TabRegistry] Registered page ${pageId} (index=${meta.index}, url=${meta.url})`);
-        return pageId;
-    }
-    reconcilePages(pages, metaList) {
-        const activeIds = new Set();
-        for (let i = 0; i < pages.length; i++) {
-            const page = pages[i];
-            const meta = metaList[i] ?? { index: i, url: '', title: '' };
-            const pageId = this.registerPage(page, { ...meta, index: i });
-            activeIds.add(pageId);
-        }
-        for (const [pageId, entry] of this.tabsById) {
-            if (!activeIds.has(pageId) && !entry.stale) {
-                entry.stale = true;
-                logger.debug(`[TabRegistry] Page ${pageId} marked stale`);
-            }
-        }
-        if (this.currentPageId && !activeIds.has(this.currentPageId)) {
-            logger.debug(`[TabRegistry] Current page ${this.currentPageId} is stale, clearing`);
-            this.currentPageId = null;
-        }
-        return this.listTabs();
-    }
-    bindAlias(alias, pageId) {
-        if (!this.tabsById.has(pageId)) {
-            return false;
-        }
-        this.aliasToPageId.set(alias, pageId);
-        return true;
-    }
-    bindAliasByIndex(alias, index) {
-        for (const [pageId, entry] of this.tabsById) {
-            if (entry.meta.index === index && !entry.stale) {
-                this.aliasToPageId.set(alias, pageId);
-                return pageId;
-            }
-        }
-        return null;
-    }
-    unbindAlias(alias) {
-        return this.aliasToPageId.delete(alias);
-    }
-    resolveAlias(alias) {
-        const pageId = this.aliasToPageId.get(alias);
-        if (!pageId)
-            return null;
-        const entry = this.tabsById.get(pageId);
-        if (!entry || entry.stale)
-            return null;
-        return pageId;
-    }
-    getPageById(pageId) {
-        const entry = this.tabsById.get(pageId);
-        if (!entry || entry.stale)
-            return null;
-        return entry.page;
-    }
-    getTabById(pageId) {
-        const entry = this.tabsById.get(pageId);
-        if (!entry)
-            return null;
-        const aliases = this.getAliasesForPageId(pageId);
-        return {
-            pageId,
-            index: entry.meta.index,
-            url: entry.meta.url,
-            title: entry.meta.title,
-            page: entry.page,
-            aliases,
-            stale: entry.stale,
-        };
-    }
-    getTabByIndex(index) {
-        for (const [pageId, entry] of this.tabsById) {
-            if (entry.meta.index === index && !entry.stale) {
-                return this.getTabById(pageId);
-            }
-        }
-        return null;
-    }
-    findTab(predicate) {
-        for (const [pageId] of this.tabsById) {
-            const tab = this.getTabById(pageId);
-            if (tab && predicate(tab))
-                return tab;
-        }
-        return null;
-    }
-    setCurrentPageId(pageId) {
-        const entry = this.tabsById.get(pageId);
-        if (!entry || entry.stale)
-            return false;
-        this.currentPageId = pageId;
-        return true;
-    }
-    setCurrentByIndex(index) {
-        const tab = this.getTabByIndex(index);
-        if (tab) {
-            this.currentPageId = tab.pageId;
-        }
-        return tab;
-    }
-    getCurrentPageId() {
-        return this.currentPageId;
-    }
-    getCurrentPage() {
-        if (!this.currentPageId)
-            return null;
-        return this.getPageById(this.currentPageId);
-    }
-    getCurrentTabInfo(driver) {
-        const allAliases = [];
-        const staleAliases = [];
-        for (const [alias, pageId] of this.aliasToPageId) {
-            const entry = this.tabsById.get(pageId);
-            const stale = !entry || entry.stale;
-            allAliases.push({
-                alias,
-                pageId,
-                index: entry?.meta.index ?? null,
-                stale,
-            });
-            if (stale)
-                staleAliases.push(alias);
-        }
-        const currentEntry = this.currentPageId ? this.tabsById.get(this.currentPageId) : null;
-        const current = currentEntry && !currentEntry.stale ? currentEntry : null;
-        return {
-            driver,
-            currentPageId: current ? this.currentPageId : null,
-            currentIndex: current?.meta.index ?? null,
-            url: current?.meta.url ?? null,
-            title: current?.meta.title ?? null,
-            aliases: allAliases,
-            staleAliases,
-        };
-    }
-    getContextMeta() {
-        const currentEntry = this.currentPageId ? this.tabsById.get(this.currentPageId) : null;
-        const current = currentEntry && !currentEntry.stale ? currentEntry : null;
-        return {
-            url: current?.meta.url ?? null,
-            title: current?.meta.title ?? null,
-            tabIndex: current?.meta.index ?? null,
-            pageId: current ? this.currentPageId : null,
-        };
-    }
-    listTabs() {
-        const result = [];
-        for (const [pageId, entry] of this.tabsById) {
-            if (!entry.stale) {
-                const aliases = this.getAliasesForPageId(pageId);
-                result.push({
-                    pageId,
-                    index: entry.meta.index,
-                    url: entry.meta.url,
-                    title: entry.meta.title,
-                    page: entry.page,
-                    aliases,
-                    stale: false,
-                });
-            }
-        }
-        return result.toSorted((a, b) => a.index - b.index);
-    }
-    listAllTabs() {
-        const result = [];
-        for (const [pageId, entry] of this.tabsById) {
-            const aliases = this.getAliasesForPageId(pageId);
-            result.push({
-                pageId,
-                index: entry.meta.index,
-                url: entry.meta.url,
-                title: entry.meta.title,
-                page: entry.page,
-                aliases,
-                stale: entry.stale,
-            });
-        }
-        return result.toSorted((a, b) => a.index - b.index);
-    }
-    setSharedContext(key, value) {
-        this.sharedContext.set(key, value);
-    }
-    getSharedContext(key) {
-        return {
-            value: this.sharedContext.get(key) ?? null,
-            found: this.sharedContext.has(key),
-        };
-    }
-    getSharedContextMap() {
-        const result = {};
-        this.sharedContext.forEach((v, k) => {
-            result[k] = v;
-        });
-        return result;
-    }
-    clear() {
-        this.tabsById.clear();
-        this.aliasToPageId.clear();
-        this.sharedContext.clear();
-        this.currentPageId = null;
-    }
-    getAliasesForPageId(pageId) {
-        const aliases = [];
-        for (const [alias, pid] of this.aliasToPageId) {
-            if (pid === pageId)
-                aliases.push(alias);
-        }
-        return aliases;
-    }
-}

package/dist/src/modules/browser/UnifiedBrowserManager.d.ts

@@ -1,82 +0,0 @@
-import type { Browser as PuppeteerBrowser, Page as PuppeteerPage } from 'rebrowser-puppeteer-core';
-import { type CamoufoxBrowserLike, type CamoufoxPageLike } from '../browser/CamoufoxBrowserManager.js';
-import { type BrowserInfo } from '../browser/BrowserDiscovery.js';
-export type BrowserDriver = 'chrome' | 'camoufox';
-export type HeadlessMode = boolean | 'shell' | 'virtual';
-export interface ProxyConfig {
-    server: string;
-    username?: string;
-    password?: string;
-}
-export interface UnifiedBrowserConfig {
-    driver?: BrowserDriver;
-    headless?: HeadlessMode;
-    executablePath?: string;
-    debugPort?: number;
-    proxy?: ProxyConfig;
-    os?: 'windows' | 'macos' | 'linux';
-    geoip?: boolean;
-    humanize?: boolean | number;
-    blockImages?: boolean;
-    blockWebrtc?: boolean;
-    autoDetectCaptcha?: boolean;
-    autoSwitchHeadless?: boolean;
-    captchaTimeout?: number;
-    wsEndpoint?: string;
-    args?: string[];
-}
-export interface IBrowserManager {
-    launch(): Promise<PuppeteerBrowser | CamoufoxBrowserLike>;
-    newPage(): Promise<PuppeteerPage | CamoufoxPageLike>;
-    goto(url: string, page?: PuppeteerPage | CamoufoxPageLike): Promise<PuppeteerPage | CamoufoxPageLike>;
-    close(): Promise<void>;
-    getBrowser(): PuppeteerBrowser | CamoufoxBrowserLike | null;
-}
-export interface BrowserStatus {
-    driver: BrowserDriver;
-    running: boolean;
-    hasActivePage: boolean;
-    headless?: boolean | 'shell' | 'virtual';
-    debugPort?: number;
-}
-export declare class UnifiedBrowserManager implements IBrowserManager {
-    private driver;
-    private config;
-    private chromeManager;
-    private camoufoxManager;
-    private browserDiscovery;
-    private activePage;
-    private chromeLaunchPromise?;
-    private camoufoxLaunchPromise?;
-    private isClosing;
-    private _chromeIsAttached;
-    constructor(config?: UnifiedBrowserConfig);
-    launch(): Promise<PuppeteerBrowser | CamoufoxBrowserLike>;
-    private launchChrome;
-    private doLaunchChrome;
-    private launchCamoufox;
-    private doLaunchCamoufox;
-    connect(wsEndpoint: string): Promise<PuppeteerBrowser | CamoufoxBrowserLike>;
-    private connectChrome;
-    private connectCamoufox;
-    newPage(): Promise<PuppeteerPage | CamoufoxPageLike>;
-    goto(url: string, page?: PuppeteerPage | CamoufoxPageLike): Promise<PuppeteerPage | CamoufoxPageLike>;
-    close(): Promise<void>;
-    getBrowser(): PuppeteerBrowser | CamoufoxBrowserLike | null;
-    getActivePage(): PuppeteerPage | CamoufoxPageLike | null;
-    getDriver(): BrowserDriver;
-    setDriver(driver: BrowserDriver): void;
-    getStatus(): BrowserStatus;
-    discoverBrowsers(): Promise<BrowserInfo[]>;
-    findChromeWithDebugPort(preferredPorts?: number[]): Promise<BrowserInfo | null>;
-    attachToExistingChrome(preferredPorts?: number[]): Promise<PuppeteerBrowser | null>;
-    private normalizeChromeHeadless;
-    private normalizeCamoufoxHeadless;
-    private getHeadlessBoolean;
-}
-export { BrowserModeManager } from '../browser/BrowserModeManager.js';
-export type { BrowserModeConfig } from '../browser/BrowserModeManager.js';
-export { CamoufoxBrowserManager } from '../browser/CamoufoxBrowserManager.js';
-export type { CamoufoxBrowserConfig } from '../browser/CamoufoxBrowserManager.js';
-export { BrowserDiscovery } from '../browser/BrowserDiscovery.js';
-export type { BrowserInfo, BrowserSignature } from '../browser/BrowserDiscovery.js';