@jshookmcp/jshook 0.2.5 → 0.2.7

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.script-replace.d.ts

@@ -1 +0,0 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersScriptReplace } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.script-replace.js

@@ -1 +0,0 @@
-export { GraphQLToolHandlersRuntime as GraphQLToolHandlersScriptReplace } from '../../domains/graphql/handlers.impl.core.runtime.replay.js';

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.shared.d.ts

@@ -1,57 +0,0 @@
-export type ScriptMatchType = 'exact' | 'contains' | 'regex';
-export interface ScriptReplaceRule {
-    id: string;
-    url: string;
-    replacement: string;
-    matchType: ScriptMatchType;
-    createdAt: number;
-    hits: number;
-}
-export interface InterceptRequest {
-    url(): string;
-    resourceType(): string;
-    continue(overrides?: Record<string, unknown>): Promise<void>;
-    respond(response: {
-        status: number;
-        contentType?: string;
-        headers?: Record<string, string>;
-        body: string;
-    }): Promise<void>;
-    isInterceptResolutionHandled?: () => boolean;
-}
-export interface PreviewPayload {
-    preview: string;
-    truncated: boolean;
-    totalLength: number;
-}
-export interface CallGraphNode {
-    id: string;
-    name: string;
-    callCount: number;
-}
-export interface CallGraphEdge {
-    source: string;
-    target: string;
-    count: number;
-}
-export interface BrowserFetchResult {
-    ok: boolean;
-    status: number;
-    statusText: string;
-    responseText: string;
-    responseJson: unknown | null;
-    responseHeaders?: Record<string, string>;
-    error?: string;
-}
-export interface ExtractedGraphQLQuery {
-    source: string;
-    url: string;
-    method: string;
-    operationName: string | null;
-    query: string;
-    variables: unknown;
-    timestamp: number | null;
-    contentType: string;
-}
-export { GRAPHQL_MAX_PREVIEW_CHARS, GRAPHQL_MAX_SCHEMA_CHARS, GRAPHQL_MAX_QUERY_CHARS, GRAPHQL_MAX_GRAPH_NODES, GRAPHQL_MAX_GRAPH_EDGES, } from '../../../constants.js';
-export declare const INTROSPECTION_QUERY: string;

package/dist/src/server/domains/graphql/handlers.impl.core.runtime.shared.js

@@ -1,79 +0,0 @@
-export { GRAPHQL_MAX_PREVIEW_CHARS, GRAPHQL_MAX_SCHEMA_CHARS, GRAPHQL_MAX_QUERY_CHARS, GRAPHQL_MAX_GRAPH_NODES, GRAPHQL_MAX_GRAPH_EDGES, } from '../../../constants.js';
-export const INTROSPECTION_QUERY = `
-query IntrospectionQuery {
-  __schema {
-    queryType { name }
-    mutationType { name }
-    subscriptionType { name }
-    types { ...FullType }
-    directives {
-      name
-      description
-      locations
-      args(includeDeprecated: true) { ...InputValue }
-    }
-  }
-}
-fragment FullType on __Type {
-  kind
-  name
-  description
-  fields(includeDeprecated: true) {
-    name
-    description
-    args(includeDeprecated: true) { ...InputValue }
-    type { ...TypeRef }
-    isDeprecated
-    deprecationReason
-  }
-  inputFields(includeDeprecated: true) { ...InputValue }
-  interfaces { ...TypeRef }
-  enumValues(includeDeprecated: true) {
-    name
-    description
-    isDeprecated
-    deprecationReason
-  }
-  possibleTypes { ...TypeRef }
-}
-fragment InputValue on __InputValue {
-  name
-  description
-  type { ...TypeRef }
-  defaultValue
-  isDeprecated
-  deprecationReason
-}
-fragment TypeRef on __Type {
-  kind
-  name
-  ofType {
-    kind
-    name
-    ofType {
-      kind
-      name
-      ofType {
-        kind
-        name
-        ofType {
-          kind
-          name
-          ofType {
-            kind
-            name
-            ofType {
-              kind
-              name
-              ofType {
-                kind
-                name
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
-`.trim();

package/dist/src/server/domains/graphql/handlers.impl.d.ts

@@ -1 +0,0 @@
-export { GraphQLToolHandlers } from '../../domains/graphql/handlers.impl.core.js';

package/dist/src/server/domains/graphql/handlers.impl.js

@@ -1 +0,0 @@
-export { GraphQLToolHandlers } from '../../domains/graphql/handlers.impl.core.js';

package/dist/src/server/domains/graphql/handlers.js

@@ -1 +0,0 @@
-export { GraphQLToolHandlers } from '../../domains/graphql/handlers.impl.js';

package/dist/src/server/domains/graphql/index.d.ts

@@ -1,2 +0,0 @@
-export { graphqlTools } from '../../domains/graphql/definitions.js';
-export { GraphQLToolHandlers } from '../../domains/graphql/handlers.js';

package/dist/src/server/domains/graphql/index.js

@@ -1,2 +0,0 @@
-export { graphqlTools } from '../../domains/graphql/definitions.js';
-export { GraphQLToolHandlers } from '../../domains/graphql/handlers.js';

package/dist/src/server/domains/graphql/manifest.d.ts

@@ -1,7 +0,0 @@
-import type { DomainManifest } from '../../domains/shared/registry.js';
-import { GraphQLToolHandlers } from '../../domains/graphql/index.js';
-declare const DOMAIN: "graphql";
-declare const DEP_KEY: "graphqlHandlers";
-type H = GraphQLToolHandlers;
-declare const manifest: DomainManifest<typeof DEP_KEY, H, typeof DOMAIN>;
-export default manifest;

package/dist/src/server/domains/graphql/manifest.js

@@ -1,49 +0,0 @@
-import { bindByDepKey, toolLookup } from '../../domains/shared/registry.js';
-import { graphqlTools } from '../../domains/graphql/definitions.js';
-import { GraphQLToolHandlers } from '../../domains/graphql/index.js';
-import { CodeCollector } from '../../domains/shared/modules.js';
-const DOMAIN = 'graphql';
-const DEP_KEY = 'graphqlHandlers';
-const t = toolLookup(graphqlTools);
-const b = (invoke) => bindByDepKey(DEP_KEY, invoke);
-function ensure(ctx) {
-    if (!ctx.collector) {
-        ctx.collector = new CodeCollector(ctx.config.puppeteer);
-        void ctx.registerCaches();
-    }
-    if (!ctx.graphqlHandlers)
-        ctx.graphqlHandlers = new GraphQLToolHandlers(ctx.collector);
-    return ctx.graphqlHandlers;
-}
-const manifest = {
-    kind: 'domain-manifest',
-    version: 1,
-    domain: DOMAIN,
-    depKey: DEP_KEY,
-    profiles: ['workflow', 'full'],
-    ensure,
-    registrations: [
-        {
-            tool: t('call_graph_analyze'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleCallGraphAnalyze(a)),
-        },
-        {
-            tool: t('script_replace_persist'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleScriptReplacePersist(a)),
-        },
-        {
-            tool: t('graphql_introspect'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleGraphqlIntrospect(a)),
-        },
-        {
-            tool: t('graphql_extract_queries'),
-            domain: DOMAIN,
-            bind: b((h, a) => h.handleGraphqlExtractQueries(a)),
-        },
-        { tool: t('graphql_replay'), domain: DOMAIN, bind: b((h, a) => h.handleGraphqlReplay(a)) },
-    ],
-};
-export default manifest;

package/dist/src/server/domains/hooks/ai-handlers.d.ts

@@ -1,42 +0,0 @@
-import type { PageController } from '../../domains/shared/modules.js';
-export declare class AIHookToolHandlers {
-    private pageController;
-    private injectedHooks;
-    constructor(pageController: PageController);
-    handleAIHookInject(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleAIHookGetData(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleAIHookList(_args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleAIHookClear(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleAIHookToggle(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-    handleAIHookExport(args: Record<string, unknown>): Promise<{
-        content: {
-            type: string;
-            text: string;
-        }[];
-    }>;
-}

package/dist/src/server/domains/hooks/ai-handlers.js

@@ -1,299 +0,0 @@
-import { evaluateWithTimeout, evaluateOnNewDocumentWithTimeout, } from '../../../modules/collector/PageController.js';
-import { logger } from '../../../utils/logger.js';
-import { argString, argStringRequired, argBool } from '../../domains/shared/parse-args.js';
-export class AIHookToolHandlers {
-    pageController;
-    injectedHooks = new Map();
-    constructor(pageController) {
-        this.pageController = pageController;
-    }
-    async handleAIHookInject(args) {
-        try {
-            const hookId = argStringRequired(args, 'hookId');
-            const code = argStringRequired(args, 'code');
-            const method = argString(args, 'method', 'evaluate');
-            const page = await this.pageController.getPage();
-            if (method === 'evaluateOnNewDocument') {
-                await evaluateOnNewDocumentWithTimeout(page, code);
-                logger.info(`Hook injected (evaluateOnNewDocument): ${hookId}`);
-            }
-            else {
-                await evaluateWithTimeout(page, code);
-                logger.info(`Hook injected (evaluate): ${hookId}`);
-            }
-            this.injectedHooks.set(hookId, {
-                code,
-                injectionTime: Date.now(),
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            hookId,
-                            message: `Hook (: ${method})`,
-                            injectionTime: new Date().toISOString(),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Hook injection failed', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleAIHookGetData(args) {
-        try {
-            const hookId = argStringRequired(args, 'hookId');
-            const page = await this.pageController.getPage();
-            const hookData = await evaluateWithTimeout(page, (id) => {
-                if (!window.__aiHooks?.[id]) {
-                    return null;
-                }
-                return {
-                    hookId: id,
-                    metadata: window.__aiHookMetadata?.[id],
-                    records: window.__aiHooks[id],
-                    totalRecords: window.__aiHooks[id].length,
-                };
-            }, hookId);
-            if (!hookData) {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: false,
-                                message: `Hook: ${hookId}`,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            ...hookData,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Failed to get hook data', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleAIHookList(_args) {
-        try {
-            const page = await this.pageController.getPage();
-            const allHooks = await evaluateWithTimeout(page, () => {
-                if (!window.__aiHookMetadata) {
-                    return [];
-                }
-                return Object.keys(window.__aiHookMetadata).map((hookId) => ({
-                    hookId,
-                    metadata: window.__aiHookMetadata[hookId],
-                    recordCount: window.__aiHooks?.[hookId]?.length || 0,
-                }));
-            });
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            totalHooks: allHooks.length,
-                            hooks: allHooks,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Failed to list hooks', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleAIHookClear(args) {
-        try {
-            const hookId = argString(args, 'hookId');
-            const page = await this.pageController.getPage();
-            if (hookId) {
-                await evaluateWithTimeout(page, (id) => {
-                    if (window.__aiHooks?.[id]) {
-                        window.__aiHooks[id] = [];
-                    }
-                }, hookId);
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: true,
-                                message: `Hook: ${hookId}`,
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-            else {
-                await evaluateWithTimeout(page, () => {
-                    if (window.__aiHooks) {
-                        for (const key in window.__aiHooks) {
-                            window.__aiHooks[key] = [];
-                        }
-                    }
-                });
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: JSON.stringify({
-                                success: true,
-                                message: 'Hook',
-                            }, null, 2),
-                        },
-                    ],
-                };
-            }
-        }
-        catch (error) {
-            logger.error('Failed to clear hook data', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleAIHookToggle(args) {
-        try {
-            const hookId = argStringRequired(args, 'hookId');
-            const enabled = argBool(args, 'enabled');
-            const page = await this.pageController.getPage();
-            await evaluateWithTimeout(page, (id, enable) => {
-                if (window.__aiHookMetadata?.[id]) {
-                    window.__aiHookMetadata[id].enabled = enable;
-                }
-            }, hookId, enabled);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            hookId,
-                            enabled,
-                            message: `Hook${enabled ? '' : ''}`,
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Failed to toggle hook', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-    async handleAIHookExport(args) {
-        try {
-            const hookId = argString(args, 'hookId');
-            const format = argString(args, 'format', 'json');
-            const page = await this.pageController.getPage();
-            const exportData = await evaluateWithTimeout(page, (id) => {
-                if (id) {
-                    return {
-                        hookId: id,
-                        metadata: window.__aiHookMetadata?.[id],
-                        records: window.__aiHooks?.[id] || [],
-                    };
-                }
-                else {
-                    return {
-                        metadata: window.__aiHookMetadata || {},
-                        records: window.__aiHooks || {},
-                    };
-                }
-            }, hookId);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            format,
-                            data: exportData,
-                            exportTime: new Date().toISOString(),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            logger.error('Failed to export hook data', error);
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: false,
-                            error: error instanceof Error ? error.message : String(error),
-                        }, null, 2),
-                    },
-                ],
-            };
-        }
-    }
-}

package/dist/src/server/domains/hooks/definitions.d.ts

@@ -1,3 +0,0 @@
-import type { Tool } from '@modelcontextprotocol/sdk/types.js';
-export declare const aiHookTools: Tool[];
-export declare const hookPresetTools: Tool[];

package/dist/src/server/domains/hooks/definitions.js

@@ -1,77 +0,0 @@
-import { tool } from '../../registry/tool-builder.js';
-export const aiHookTools = [
-    tool('ai_hook_inject')
-        .desc('Inject a generated hook into the page.\n\nMethods:\n- evaluateOnNewDocument: Runs before page scripts (use for API hooks like fetch/XHR)\n- evaluate: Runs in current page context (use for hooking already-loaded code)')
-        .string('hookId', 'Hook ID for injection')
-        .string('code', 'Hook code to inject')
-        .enum('method', ['evaluateOnNewDocument', 'evaluate'], 'Injection method', {
-        default: 'evaluate',
-    })
-        .required('hookId', 'code')
-        .build(),
-    tool('ai_hook_get_data')
-        .desc('Retrieve captured data from an active hook (arguments, return values, timestamps, call count)')
-        .string('hookId', 'Hook ID')
-        .required('hookId')
-        .build(),
-    tool('ai_hook_list')
-        .desc('List all active hooks with their IDs, types, creation time, and call counts')
-        .build(),
-    tool('ai_hook_clear')
-        .desc('Remove one hook by ID or clear all hooks and their captured data')
-        .string('hookId', 'Hook ID to clear (omit to clear all hooks)')
-        .build(),
-    tool('ai_hook_toggle')
-        .desc('Enable or disable a hook without removing it')
-        .string('hookId', 'Hook ID')
-        .boolean('enabled', 'true to enable, false to disable')
-        .required('hookId', 'enabled')
-        .build(),
-    tool('ai_hook_export')
-        .desc('Export captured hook data in JSON or CSV format')
-        .string('hookId', 'Hook ID to export (omit to export all hooks)')
-        .enum('format', ['json', 'csv'], 'Export format', { default: 'json' })
-        .build(),
-];
-export const hookPresetTools = [
-    tool('hook_preset')
-        .desc('Install a pre-built JavaScript hook from 20+ built-in presets (eval, atob/btoa, Proxy, Reflect, Object.defineProperty, etc.), or provide customTemplate/customTemplates to install your own reusable hook bodies. Use listPresets=true to see all available preset descriptions.')
-        .string('preset', 'Single preset name to install. Accepts built-in preset ids or ids provided by customTemplate/customTemplates.')
-        .array('presets', { type: 'string' }, 'List of preset names to install simultaneously. Accepts built-in ids and custom template ids.')
-        .prop('customTemplate', {
-        type: 'object',
-        properties: {
-            id: { type: 'string', description: 'Stable preset id, for example deobfuscation-sinks' },
-            description: {
-                type: 'string',
-                description: 'Human-readable description for listPresets output.',
-            },
-            body: {
-                type: 'string',
-                description: 'Hook body snippet inserted into the preset wrapper.',
-            },
-        },
-        required: ['id', 'body'],
-        description: 'Inline custom template. body should contain the hook body inserted into the standard buildHookCode wrapper. Use {{STACK_CODE}} and {{LOG_FN}} placeholders when needed.',
-    })
-        .prop('customTemplates', {
-        type: 'array',
-        items: {
-            type: 'object',
-            properties: {
-                id: { type: 'string' },
-                description: { type: 'string' },
-                body: { type: 'string' },
-            },
-            required: ['id', 'body'],
-        },
-        description: 'List of inline custom templates to register for this invocation.',
-    })
-        .boolean('captureStack', 'Include call stack in captured data (has performance impact)', {
-        default: false,
-    })
-        .boolean('logToConsole', 'Log hook events to browser console', { default: true })
-        .enum('method', ['evaluate', 'evaluateOnNewDocument'], 'Injection method: evaluate=current page, evaluateOnNewDocument=before page scripts', { default: 'evaluate' })
-        .boolean('listPresets', 'Set to true to list all available presets with descriptions instead of installing.', { default: false })
-        .build(),
-];

package/dist/src/server/domains/hooks/index.d.ts

@@ -1,3 +0,0 @@
-export { aiHookTools, hookPresetTools } from '../../domains/hooks/definitions.js';
-export { AIHookToolHandlers } from '../../domains/hooks/ai-handlers.js';
-export { HookPresetToolHandlers } from '../../domains/hooks/preset-handlers.js';

package/dist/src/server/domains/hooks/index.js

@@ -1,3 +0,0 @@
-export { aiHookTools, hookPresetTools } from '../../domains/hooks/definitions.js';
-export { AIHookToolHandlers } from '../../domains/hooks/ai-handlers.js';
-export { HookPresetToolHandlers } from '../../domains/hooks/preset-handlers.js';