@jshookmcp/jshook 0.2.6 → 0.2.7

package/dist/src/server/domains/browser/handlers/page-navigation.d.ts

@@ -1,37 +0,0 @@
-import type { PageController } from '../../../domains/shared/modules.js';
-import type { ConsoleMonitor } from '../../../domains/shared/modules.js';
-interface PageNavigationHandlersDeps {
-    pageController: PageController;
-    consoleMonitor: ConsoleMonitor;
-    getActiveDriver: () => 'chrome' | 'camoufox';
-    getCamoufoxPage: () => Promise<unknown>;
-}
-export declare class PageNavigationHandlers {
-    private deps;
-    constructor(deps: PageNavigationHandlersDeps);
-    handlePageNavigate(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handlePageReload(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handlePageBack(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handlePageForward(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export {};

package/dist/src/server/domains/browser/handlers/page-navigation.js

@@ -1,144 +0,0 @@
-import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
-export class PageNavigationHandlers {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async handlePageNavigate(args) {
-        const url = argString(args, 'url', '');
-        const rawWaitUntil = argString(args, 'waitUntil', 'networkidle');
-        const timeout = argNumber(args, 'timeout');
-        const enableNetworkMonitoring = argBool(args, 'enableNetworkMonitoring');
-        if (this.deps.getActiveDriver() === 'camoufox') {
-            const playwrightWaitUntil = rawWaitUntil === 'networkidle2' ? 'networkidle' : rawWaitUntil;
-            const page = (await this.deps.getCamoufoxPage());
-            await page.goto(url, { waitUntil: playwrightWaitUntil, timeout });
-            this.deps.consoleMonitor.setPlaywrightPage(page);
-            if (enableNetworkMonitoring) {
-                await this.deps.consoleMonitor.enable({ enableNetwork: true, enableExceptions: true });
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            driver: 'camoufox',
-                            url: page.url(),
-                            title: await page.title(),
-                            network_monitoring: {
-                                enabled: this.deps.consoleMonitor.isNetworkEnabled(),
-                            },
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        if (enableNetworkMonitoring) {
-            await this.deps.consoleMonitor.enable({ enableNetwork: true, enableExceptions: true });
-        }
-        const waitUntilMap = {
-            networkidle: 'networkidle2',
-            commit: 'load',
-        };
-        const waitUntil = (waitUntilMap[rawWaitUntil] || rawWaitUntil);
-        await this.deps.pageController.navigate(url, { waitUntil, timeout });
-        const currentUrl = await this.deps.pageController.getURL();
-        const title = await this.deps.pageController.getTitle();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        url: currentUrl,
-                        title,
-                        network_monitoring: {
-                            enabled: this.deps.consoleMonitor.isNetworkEnabled(),
-                        },
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePageReload(_args) {
-        if (this.deps.getActiveDriver() === 'camoufox') {
-            const page = (await this.deps.getCamoufoxPage());
-            await page.reload();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: true, message: 'Page reloaded', driver: 'camoufox' }, null, 2),
-                    },
-                ],
-            };
-        }
-        await this.deps.pageController.reload();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'Page reloaded',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePageBack(_args) {
-        if (this.deps.getActiveDriver() === 'camoufox') {
-            const page = (await this.deps.getCamoufoxPage());
-            await page.goBack();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: true, url: page.url(), driver: 'camoufox' }, null, 2),
-                    },
-                ],
-            };
-        }
-        await this.deps.pageController.goBack();
-        const url = await this.deps.pageController.getURL();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        url,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handlePageForward(_args) {
-        if (this.deps.getActiveDriver() === 'camoufox') {
-            const page = (await this.deps.getCamoufoxPage());
-            await page.goForward();
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({ success: true, url: page.url(), driver: 'camoufox' }, null, 2),
-                    },
-                ],
-            };
-        }
-        await this.deps.pageController.goForward();
-        const url = await this.deps.pageController.getURL();
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        url,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-}

package/dist/src/server/domains/browser/handlers/script-management.d.ts

@@ -1,23 +0,0 @@
-import type { ScriptManager } from '../../../domains/shared/modules.js';
-import type { DetailedDataManager } from '../../../../utils/DetailedDataManager.js';
-interface ScriptManagementHandlersDeps {
-    scriptManager: ScriptManager;
-    detailedDataManager: DetailedDataManager;
-}
-export declare class ScriptManagementHandlers {
-    private deps;
-    constructor(deps: ScriptManagementHandlersDeps);
-    handleGetAllScripts(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleGetScriptSource(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export {};

package/dist/src/server/domains/browser/handlers/script-management.js

@@ -1,96 +0,0 @@
-import { argString, argNumber, argBool } from '../../../domains/shared/parse-args.js';
-import { SCRIPTS_MAX_CAP } from '../../../../constants.js';
-export class ScriptManagementHandlers {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async handleGetAllScripts(args) {
-        const includeSource = argBool(args, 'includeSource', false);
-        const MAX_SCRIPTS_CAP = SCRIPTS_MAX_CAP;
-        const maxScripts = Math.min(argNumber(args, 'maxScripts', includeSource ? 200 : 1000), MAX_SCRIPTS_CAP);
-        const scripts = await this.deps.scriptManager.getAllScripts(includeSource, maxScripts);
-        const data = { count: scripts.length, scripts };
-        const processed = this.deps.detailedDataManager.smartHandle(data);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(processed, null, 2),
-                },
-            ],
-        };
-    }
-    async handleGetScriptSource(args) {
-        const scriptId = argString(args, 'scriptId');
-        const url = argString(args, 'url');
-        const preview = argBool(args, 'preview', true);
-        const maxLines = argNumber(args, 'maxLines', 100);
-        const startLine = argNumber(args, 'startLine');
-        const endLine = argNumber(args, 'endLine');
-        const script = await this.deps.scriptManager.getScriptSource(scriptId, url);
-        if (!script) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: 'Script not found',
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        if (preview || startLine !== undefined || endLine !== undefined) {
-            const source = script.source || '';
-            const lines = source.split('\n');
-            const totalLines = lines.length;
-            const size = source.length;
-            let previewContent;
-            let actualStartLine;
-            let actualEndLine;
-            if (startLine !== undefined && endLine !== undefined) {
-                actualStartLine = Math.max(1, startLine);
-                actualEndLine = Math.min(totalLines, endLine);
-                previewContent = lines.slice(actualStartLine - 1, actualEndLine).join('\n');
-            }
-            else {
-                actualStartLine = 1;
-                actualEndLine = Math.min(maxLines, totalLines);
-                previewContent = lines.slice(0, maxLines).join('\n');
-            }
-            const result = {
-                success: true,
-                scriptId: script.scriptId,
-                url: script.url,
-                preview: true,
-                totalLines,
-                size,
-                sizeKB: (size / 1024).toFixed(1) + 'KB',
-                showingLines: `${actualStartLine}-${actualEndLine}`,
-                content: previewContent,
-                hint: size > 51200
-                    ? `Script is large (${(size / 1024).toFixed(1)}KB). Use startLine/endLine to get specific sections, or set preview=false to get full source (will return detailId).`
-                    : 'Set preview=false to get full source',
-            };
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        const processedScript = this.deps.detailedDataManager.smartHandle(script, 51200);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify(processedScript, null, 2),
-                },
-            ],
-        };
-    }
-}

package/dist/src/server/domains/browser/handlers/stealth-injection.d.ts

@@ -1,49 +0,0 @@
-import type { PageController } from '../../../domains/shared/modules.js';
-import { CDPTimingProxy } from '../../../../modules/stealth/CDPTimingProxy.js';
-import type { CDPTimingOptions } from '../../../../modules/stealth/CDPTimingProxy.types.js';
-interface StealthInjectionHandlersDeps {
-    pageController: PageController;
-    getActiveDriver: () => 'chrome' | 'camoufox';
-}
-export declare function _resetFingerprintCacheForTesting(): void;
-export declare class StealthInjectionHandlers {
-    private deps;
-    constructor(deps: StealthInjectionHandlersDeps);
-    handleStealthInject(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleStealthSetUserAgent(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleStealthConfigureJitter(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleStealthGenerateFingerprint(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleStealthVerify(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}
-export declare function getJitterOptions(): CDPTimingOptions;
-export declare function createJitteredSession(session: {
-    send: (method: string, params?: Record<string, unknown>) => Promise<unknown>;
-    on: (event: string, handler: (params: unknown) => void) => void;
-    off: (event: string, handler: (params: unknown) => void) => void;
-}): CDPTimingProxy;
-export {};

package/dist/src/server/domains/browser/handlers/stealth-injection.js

@@ -1,188 +0,0 @@
-import { StealthScripts } from '../../../domains/shared/modules.js';
-import { argString } from '../../../domains/shared/parse-args.js';
-import { CDPTimingProxy } from '../../../../modules/stealth/CDPTimingProxy.js';
-import { DEFAULT_TIMING_OPTIONS } from '../../../../modules/stealth/CDPTimingProxy.types.js';
-import { logger } from '../../../../utils/logger.js';
-const jitterOptions = { ...DEFAULT_TIMING_OPTIONS };
-let fingerprintManagerInstance = null;
-async function getFingerprintManager() {
-    if (fingerprintManagerInstance)
-        return fingerprintManagerInstance;
-    try {
-        const mod = await import('../../../../modules/stealth/FingerprintManager.js');
-        fingerprintManagerInstance = mod.FingerprintManager.getInstance();
-        return fingerprintManagerInstance;
-    }
-    catch {
-        return null;
-    }
-}
-export function _resetFingerprintCacheForTesting() {
-    fingerprintManagerInstance = null;
-}
-export class StealthInjectionHandlers {
-    deps;
-    constructor(deps) {
-        this.deps = deps;
-    }
-    async handleStealthInject(_args) {
-        if (this.deps.getActiveDriver() === 'camoufox') {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            driver: 'camoufox',
-                            message: 'Camoufox uses C++ engine-level fingerprint spoofing — JS-layer stealth scripts are not needed and have been skipped.',
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        const page = await this.deps.pageController.getPage();
-        const fm = await getFingerprintManager();
-        let fingerprintApplied = false;
-        if (fm?.isAvailable()) {
-            try {
-                let profile = fm.getActiveProfile();
-                if (!profile) {
-                    profile = await fm.generateFingerprint();
-                }
-                if (profile) {
-                    await fm.injectFingerprint(page, profile);
-                    fingerprintApplied = true;
-                }
-            }
-            catch (err) {
-                logger.warn('Fingerprint injection failed, falling back to StealthScripts:', err);
-            }
-        }
-        await StealthScripts.injectAll(page);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        message: 'Stealth scripts injected successfully',
-                        fingerprintApplied,
-                        _nextStepHint: 'Stealth patches are now active. ' +
-                            'Next: navigate to your target URL with page_navigate. ' +
-                            'Do NOT call stealth_inject again — it only needs to run once per page.',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleStealthSetUserAgent(args) {
-        const platform = argString(args, 'platform', 'windows');
-        const page = await this.deps.pageController.getPage();
-        await StealthScripts.setRealisticUserAgent(page, platform);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        platform,
-                        message: `User-Agent set for ${platform}`,
-                        _nextStepHint: 'User-Agent is now configured. ' +
-                            'Next: call stealth_inject to apply all anti-detection patches, ' +
-                            'then page_navigate to your target URL.',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleStealthConfigureJitter(args) {
-        if (args.enabled !== undefined)
-            jitterOptions.enabled = Boolean(args.enabled);
-        if (typeof args.minDelayMs === 'number')
-            jitterOptions.minDelayMs = args.minDelayMs;
-        if (typeof args.maxDelayMs === 'number')
-            jitterOptions.maxDelayMs = args.maxDelayMs;
-        if (args.burstMode !== undefined)
-            jitterOptions.burstMode = Boolean(args.burstMode);
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        jitterOptions,
-                        message: `CDP timing jitter ${jitterOptions.enabled ? 'enabled' : 'disabled'}: ${jitterOptions.minDelayMs}-${jitterOptions.maxDelayMs}ms${jitterOptions.burstMode ? ' (burst mode)' : ''}`,
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleStealthGenerateFingerprint(args) {
-        const fm = await getFingerprintManager();
-        if (!fm?.isAvailable()) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: 'fingerprint-generator/fingerprint-injector packages are not installed. Install them with: pnpm add fingerprint-generator fingerprint-injector',
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        const profile = await fm.generateFingerprint({
-            os: args.os,
-            browser: args.browser ?? 'chrome',
-            locale: args.locale ?? 'en-US',
-        });
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: true,
-                        profile,
-                        message: 'Fingerprint generated and cached. It will be auto-applied on next stealth_inject.',
-                    }, null, 2),
-                },
-            ],
-        };
-    }
-    async handleStealthVerify(_args) {
-        const page = await this.deps.pageController.getPage();
-        try {
-            const mod = await import('../../../../modules/stealth/StealthVerifier.js');
-            const verifier = new mod.StealthVerifier();
-            const result = await verifier.verify(page);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify(result, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            message: `Stealth verification failed: ${err instanceof Error ? err.message : String(err)}`,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-}
-export function getJitterOptions() {
-    return { ...jitterOptions };
-}
-export function createJitteredSession(session) {
-    return new CDPTimingProxy(session, jitterOptions);
-}

package/dist/src/server/domains/browser/handlers/tab-workflow.d.ts

@@ -1,33 +0,0 @@
-import type { TabRegistry } from '../../../../modules/browser/TabRegistry.js';
-interface TabWorkflowDeps {
-    getActiveDriver: () => 'chrome' | 'camoufox';
-    getCamoufoxPage: () => Promise<unknown>;
-    getPageController: () => unknown;
-    getTabRegistry: () => TabRegistry;
-}
-export declare class TabWorkflowHandlers {
-    private deps;
-    constructor(deps: TabWorkflowDeps);
-    private get registry();
-    handleTabWorkflow(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    private listAliases;
-    private clearState;
-    private aliasBind;
-    private aliasOpen;
-    private navigateAlias;
-    private waitFor;
-    private contextSet;
-    private contextGet;
-    private transfer;
-    private getPageByAlias;
-    private reconcilePages;
-    private getBrowserFromController;
-    private ok;
-    private error;
-}
-export {};