@jshookmcp/jshook 0.2.6 → 0.2.7

package/dist/src/types/analysis.d.ts

@@ -1,135 +0,0 @@
-import type { CodeLocation } from './common.js';
-export interface UnderstandCodeOptions {
-    code: string;
-    context?: Record<string, unknown>;
-    focus?: 'structure' | 'business' | 'security' | 'all';
-}
-export interface UnderstandCodeResult {
-    structure: CodeStructure;
-    techStack: TechStack;
-    businessLogic: BusinessLogic;
-    dataFlow: DataFlow;
-    securityRisks: SecurityRisk[];
-    qualityScore: number;
-    codePatterns?: Array<{
-        name: string;
-        location: number;
-        description: string;
-    }>;
-    antiPatterns?: Array<{
-        name: string;
-        location: number;
-        severity: string;
-        recommendation: string;
-    }>;
-    complexityMetrics?: {
-        cyclomaticComplexity: number;
-        cognitiveComplexity: number;
-        maintainabilityIndex: number;
-        halsteadMetrics: {
-            vocabulary: number;
-            length: number;
-            difficulty: number;
-            effort: number;
-        };
-    };
-}
-export interface CodeStructure {
-    functions: FunctionInfo[];
-    classes: ClassInfo[];
-    modules: ModuleInfo[];
-    callGraph: CallGraph;
-}
-export interface FunctionInfo {
-    name: string;
-    params: string[];
-    returnType?: string;
-    location: CodeLocation;
-    complexity: number;
-}
-export interface ClassInfo {
-    name: string;
-    methods: FunctionInfo[];
-    properties: PropertyInfo[];
-    location: CodeLocation;
-}
-export interface PropertyInfo {
-    name: string;
-    type?: string;
-    value?: unknown;
-}
-export interface ModuleInfo {
-    name: string;
-    exports: string[];
-    imports: string[];
-}
-export interface CallGraph {
-    nodes: CallGraphNode[];
-    edges: CallGraphEdge[];
-}
-export interface CallGraphNode {
-    id: string;
-    name: string;
-    type: 'function' | 'method' | 'constructor';
-}
-export interface CallGraphEdge {
-    from: string;
-    to: string;
-    callCount?: number;
-}
-export interface TechStack {
-    framework?: string;
-    bundler?: string;
-    uiLibrary?: string;
-    stateManagement?: string;
-    cryptoLibrary?: string[];
-    other: string[];
-}
-export interface BusinessLogic {
-    mainFeatures: string[];
-    entities: string[];
-    rules: string[];
-    dataModel: Record<string, unknown>;
-}
-export interface DataFlow {
-    graph: DataFlowGraph;
-    sources: DataSource[];
-    sinks: DataSink[];
-    taintPaths: TaintPath[];
-}
-export interface DataFlowGraph {
-    nodes: DataFlowNode[];
-    edges: DataFlowEdge[];
-}
-export interface DataFlowNode {
-    id: string;
-    type: 'source' | 'sink' | 'transform';
-    name: string;
-    location: CodeLocation;
-}
-export interface DataFlowEdge {
-    from: string;
-    to: string;
-    data: string;
-}
-export interface DataSource {
-    type: 'user_input' | 'storage' | 'network' | 'other';
-    location: CodeLocation;
-}
-export interface DataSink {
-    type: 'dom' | 'network' | 'storage' | 'eval' | 'xss' | 'sql-injection' | 'other';
-    location: CodeLocation;
-}
-export interface TaintPath {
-    source: DataSource;
-    sink: DataSink;
-    path: CodeLocation[];
-    risk?: 'high' | 'medium' | 'low';
-}
-export interface SecurityRisk {
-    type: 'xss' | 'sql-injection' | 'csrf' | 'sensitive-data' | 'other';
-    severity: 'critical' | 'high' | 'medium' | 'low';
-    location: CodeLocation;
-    description: string;
-    recommendation: string;
-}

package/dist/src/types/analysis.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/browser.d.ts

@@ -1,16 +0,0 @@
-import type { Browser, Page } from 'rebrowser-puppeteer-core';
-export interface BrowserContext {
-    browser: Browser;
-    page: Page;
-    url: string;
-}
-declare global {
-    interface Window {
-        __aiHooks?: Record<string, unknown[]>;
-        __aiHookMetadata?: Record<string, {
-            id: string;
-            createdAt: number;
-            enabled: boolean;
-        }>;
-    }
-}

package/dist/src/types/browser.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/collector.d.ts

@@ -1,56 +0,0 @@
-export interface CollectCodeOptions {
-    url: string;
-    depth?: number;
-    timeout?: number;
-    includeInline?: boolean;
-    includeExternal?: boolean;
-    includeDynamic?: boolean;
-    includeServiceWorker?: boolean;
-    includeWebWorker?: boolean;
-    filterRules?: string[];
-    smartMode?: 'summary' | 'priority' | 'incremental' | 'full';
-    compress?: boolean;
-    streaming?: boolean;
-    maxTotalSize?: number;
-    maxFileSize?: number;
-    priorities?: string[];
-}
-export interface CodeFile {
-    url: string;
-    content: string;
-    size: number;
-    type: 'inline' | 'external' | 'dynamic' | 'service-worker' | 'web-worker';
-    loadTime?: number;
-    metadata?: Record<string, unknown>;
-}
-export interface CollectCodeResult {
-    files: CodeFile[];
-    dependencies: DependencyGraph;
-    totalSize: number;
-    collectTime: number;
-    summaries?: Array<{
-        url: string;
-        size: number;
-        type: string;
-        hasEncryption: boolean;
-        hasAPI: boolean;
-        hasObfuscation: boolean;
-        functions: string[];
-        imports: string[];
-        preview: string;
-    }>;
-}
-export interface DependencyGraph {
-    nodes: DependencyNode[];
-    edges: DependencyEdge[];
-}
-export interface DependencyNode {
-    id: string;
-    url: string;
-    type: string;
-}
-export interface DependencyEdge {
-    from: string;
-    to: string;
-    type: 'import' | 'require' | 'script';
-}

package/dist/src/types/collector.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/common.d.ts

@@ -1,11 +0,0 @@
-export interface CodeLocation {
-    file: string;
-    line: number;
-    column?: number;
-}
-export interface Result<T> {
-    success: boolean;
-    data?: T;
-    error?: string;
-    message?: string;
-}

package/dist/src/types/common.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/config.d.ts

@@ -1,65 +0,0 @@
-export interface Config {
-    puppeteer: PuppeteerConfig;
-    mcp: MCPConfig;
-    cache: CacheConfig;
-    performance: PerformanceConfig;
-    search: SearchConfig;
-}
-export interface PuppeteerConfig {
-    headless: boolean;
-    timeout: number;
-    executablePath?: string;
-    args?: string[];
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    userAgent?: string;
-    maxCollectedUrls?: number;
-    maxFilesPerCollect?: number;
-    maxTotalContentSize?: number;
-    maxSingleFileSize?: number;
-}
-export interface MCPConfig {
-    name: string;
-    version: string;
-}
-export interface CacheConfig {
-    enabled: boolean;
-    dir: string;
-    ttl: number;
-}
-export interface PerformanceConfig {
-    maxConcurrentAnalysis: number;
-    maxCodeSizeMB: number;
-}
-export interface SearchConfig {
-    queryCategoryProfiles: SearchQueryCategoryProfileConfig[];
-    cjkQueryAliases: SearchCjkQueryAliasConfig[];
-    intentToolBoostRules: SearchIntentToolBoostRuleConfig[];
-    vectorEnabled?: boolean;
-    vectorModelId?: string;
-    vectorCosineWeight?: number;
-    vectorDynamicWeight?: boolean;
-}
-export interface SearchQueryCategoryProfileConfig {
-    pattern: string;
-    flags?: string;
-    domainBoosts: Array<{
-        domain: string;
-        weight: number;
-    }>;
-}
-export interface SearchCjkQueryAliasConfig {
-    pattern: string;
-    flags?: string;
-    tokens: string[];
-}
-export interface SearchIntentToolBoostRuleConfig {
-    pattern: string;
-    flags?: string;
-    boosts: Array<{
-        tool: string;
-        bonus: number;
-    }>;
-}

package/dist/src/types/config.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/crypto.d.ts

@@ -1,29 +0,0 @@
-import type { CodeLocation } from './common.js';
-export interface DetectCryptoOptions {
-    code: string;
-    testData?: unknown;
-}
-export interface DetectCryptoResult {
-    algorithms: CryptoAlgorithm[];
-    libraries: CryptoLibrary[];
-    confidence: number;
-}
-export interface CryptoAlgorithm {
-    name: string;
-    type: 'symmetric' | 'asymmetric' | 'hash' | 'encoding';
-    confidence: number;
-    location: CodeLocation;
-    parameters?: CryptoParameters;
-    usage: string;
-}
-export interface CryptoParameters {
-    key?: string;
-    iv?: string;
-    mode?: string;
-    padding?: string;
-}
-export interface CryptoLibrary {
-    name: string;
-    version?: string;
-    confidence: number;
-}

package/dist/src/types/crypto.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/debugger.d.ts

@@ -1,86 +0,0 @@
-import type { CollectCodeResult } from './collector.js';
-import type { DeobfuscateResult } from './deobfuscator.js';
-import type { UnderstandCodeResult } from './analysis.js';
-import type { DetectCryptoResult } from './crypto.js';
-import type { HookRecord } from './hook.js';
-export interface ScopeVariable {
-    name: string;
-    value: unknown;
-    type: string;
-    scope: 'global' | 'local' | 'with' | 'closure' | 'catch' | 'block' | 'script' | 'eval' | 'module';
-    writable?: boolean;
-    configurable?: boolean;
-    enumerable?: boolean;
-    objectId?: string;
-}
-export interface BreakpointHitEvent {
-    breakpointId: string;
-    breakpointInfo?: unknown;
-    location: {
-        scriptId: string;
-        lineNumber: number;
-        columnNumber: number;
-        url?: string;
-    };
-    callFrames: unknown[];
-    timestamp: number;
-    variables?: ScopeVariable[];
-    reason: string;
-}
-export type BreakpointHitCallback = (event: BreakpointHitEvent) => void | Promise<void>;
-export interface DebuggerSession {
-    version: string;
-    timestamp: number;
-    breakpoints: Array<{
-        location: {
-            scriptId?: string;
-            url?: string;
-            lineNumber: number;
-            columnNumber?: number;
-        };
-        condition?: string;
-        enabled: boolean;
-    }>;
-    pauseOnExceptions: 'none' | 'uncaught' | 'all';
-    metadata?: {
-        url?: string;
-        description?: string;
-        tags?: string[];
-        [key: string]: unknown;
-    };
-}
-export interface GetScopeVariablesOptions {
-    callFrameId?: string;
-    includeObjectProperties?: boolean;
-    maxDepth?: number;
-    skipErrors?: boolean;
-}
-export interface GetScopeVariablesResult {
-    success: boolean;
-    variables: ScopeVariable[];
-    callFrameId: string;
-    callFrameInfo?: {
-        functionName: string;
-        location: string;
-    };
-    errors?: Array<{
-        scope: string;
-        error: string;
-    }>;
-    totalScopes: number;
-    successfulScopes: number;
-}
-export interface Session {
-    id: string;
-    url: string;
-    createdAt: number;
-    updatedAt: number;
-    data: SessionData;
-}
-export interface SessionData {
-    code?: CollectCodeResult;
-    deobfuscated?: DeobfuscateResult;
-    analysis?: UnderstandCodeResult;
-    crypto?: DetectCryptoResult;
-    hooks?: HookRecord[];
-}

package/dist/src/types/debugger.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/deobfuscator.d.ts

@@ -1,64 +0,0 @@
-export type ObfuscationType = 'javascript-obfuscator' | 'webpack' | 'uglify' | 'vm-protection' | 'self-modifying' | 'invisible-unicode' | 'control-flow-flattening' | 'string-array-rotation' | 'dead-code-injection' | 'opaque-predicates' | 'jsfuck' | 'aaencode' | 'jjencode' | 'packer' | 'eval-obfuscation' | 'base64-encoding' | 'hex-encoding' | 'jscrambler' | 'urlencoded' | 'custom' | 'unknown' | 'bundle-unpack' | 'unminify' | 'jsx-decompile' | 'mangle' | 'webcrack';
-export interface Transformation {
-    type: string;
-    description: string;
-    success: boolean;
-}
-export interface DeobfuscateOptions {
-    code: string;
-    aggressive?: boolean;
-    preserveLogic?: boolean;
-    renameVariables?: boolean;
-    inlineFunctions?: boolean;
-    unpack?: boolean;
-    unminify?: boolean;
-    jsx?: boolean;
-    mangle?: boolean;
-    outputDir?: string;
-    forceOutput?: boolean;
-    includeModuleCode?: boolean;
-    maxBundleModules?: number;
-    mappings?: DeobfuscateMappingRule[];
-}
-export interface DeobfuscateMappingRule {
-    path: string;
-    pattern: string;
-    matchType?: 'includes' | 'regex' | 'exact';
-    target?: 'code' | 'path';
-}
-export interface DeobfuscateSavedArtifact {
-    path: string;
-    size: number;
-    type: 'file';
-}
-export interface DeobfuscateBundleModuleSummary {
-    id: string;
-    path: string;
-    isEntry: boolean;
-    size: number;
-    code?: string;
-    mappedPathFrom?: string;
-}
-export interface DeobfuscateBundleSummary {
-    type: 'webpack' | 'browserify';
-    entryId: string;
-    moduleCount: number;
-    truncated: boolean;
-    mappingsApplied?: number;
-    modules: DeobfuscateBundleModuleSummary[];
-}
-export interface DeobfuscateResult {
-    code: string;
-    readabilityScore: number;
-    confidence: number;
-    obfuscationType: ObfuscationType[];
-    transformations: Transformation[];
-    analysis: string;
-    bundle?: DeobfuscateBundleSummary;
-    savedTo?: string;
-    savedArtifacts?: DeobfuscateSavedArtifact[];
-    warnings?: string[];
-    engine?: 'legacy' | 'webcrack' | 'hybrid';
-    webcrackApplied?: boolean;
-    cached?: boolean;
-}

package/dist/src/types/deobfuscator.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/emulator.d.ts

@@ -1,41 +0,0 @@
-export interface DetectedEnvironmentVariables {
-    window: string[];
-    document: string[];
-    navigator: string[];
-    location: string[];
-    screen: string[];
-    other: string[];
-}
-export interface MissingAPI {
-    name: string;
-    type: 'function' | 'object' | 'property';
-    path: string;
-    suggestion: string;
-}
-export interface EmulationCode {
-    nodejs: string;
-    python: string;
-}
-export interface EnvironmentEmulatorOptions {
-    code: string;
-    targetRuntime?: 'nodejs' | 'python' | 'both';
-    autoFetch?: boolean;
-    browserUrl?: string;
-    browserType?: 'chrome' | 'firefox' | 'safari';
-    includeComments?: boolean;
-    extractDepth?: number;
-    useAI?: boolean;
-}
-export interface EnvironmentEmulatorResult {
-    detectedVariables: DetectedEnvironmentVariables;
-    emulationCode: EmulationCode;
-    missingAPIs: MissingAPI[];
-    variableManifest: Record<string, unknown>;
-    recommendations: string[];
-    stats: {
-        totalVariables: number;
-        autoFilledVariables: number;
-        manualRequiredVariables: number;
-    };
-    aiAnalysis?: unknown;
-}

package/dist/src/types/emulator.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/hook.d.ts

@@ -1,42 +0,0 @@
-export interface HookOptions {
-    target: string;
-    type: 'function' | 'xhr' | 'fetch' | 'websocket' | 'localstorage' | 'cookie' | 'eval' | 'object-method';
-    action?: 'log' | 'block' | 'modify';
-    customCode?: string;
-    condition?: HookCondition;
-    performance?: boolean;
-    regex?: boolean;
-}
-export interface HookCondition {
-    argumentFilter?: (args: unknown[]) => boolean;
-    returnFilter?: (result: unknown) => boolean;
-    maxCalls?: number;
-    minInterval?: number;
-    params?: unknown[];
-    returnValue?: unknown;
-    callCount?: number;
-}
-export type HookHandler = (context: HookContext) => void | Promise<void>;
-export interface HookContext {
-    target: string;
-    args: unknown[];
-    returnValue?: unknown;
-    callStack: CallStackFrame[];
-    timestamp: number;
-}
-export interface CallStackFrame {
-    functionName: string;
-    fileName: string;
-    lineNumber: number;
-    columnNumber: number;
-}
-export interface HookResult {
-    hookId: string;
-    script: string;
-    instructions: string;
-}
-export interface HookRecord {
-    hookId: string;
-    timestamp: number;
-    context: HookContext;
-}

package/dist/src/types/hook.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/index.d.ts

@@ -1,11 +0,0 @@
-export type { CodeLocation, Result } from './common.js';
-export type { Config, PuppeteerConfig, MCPConfig, CacheConfig, PerformanceConfig, SearchConfig, SearchQueryCategoryProfileConfig, SearchCjkQueryAliasConfig, SearchIntentToolBoostRuleConfig, } from './config.js';
-export type { BrowserContext } from './browser.js';
-export type { CollectCodeOptions, CodeFile, CollectCodeResult, DependencyGraph, DependencyNode, DependencyEdge, } from './collector.js';
-export type { ObfuscationType, Transformation, DeobfuscateOptions, DeobfuscateResult, DeobfuscateMappingRule, DeobfuscateSavedArtifact, DeobfuscateBundleModuleSummary, DeobfuscateBundleSummary, } from './deobfuscator.js';
-export type { UnderstandCodeOptions, UnderstandCodeResult, CodeStructure, TechStack, BusinessLogic, DataFlow, DataFlowGraph, DataFlowNode, DataFlowEdge, DataSource, DataSink, TaintPath, SecurityRisk, FunctionInfo, ClassInfo, PropertyInfo, ModuleInfo, CallGraph, CallGraphNode, CallGraphEdge, } from './analysis.js';
-export type { DetectCryptoOptions, DetectCryptoResult, CryptoAlgorithm, CryptoParameters, CryptoLibrary, } from './crypto.js';
-export type { HookOptions, HookCondition, HookHandler, HookContext, CallStackFrame, HookResult, HookRecord, } from './hook.js';
-export type { ScopeVariable, BreakpointHitEvent, BreakpointHitCallback, DebuggerSession, GetScopeVariablesOptions, GetScopeVariablesResult, Session, SessionData, } from './debugger.js';
-export type { DetectedEnvironmentVariables, MissingAPI, EmulationCode, EnvironmentEmulatorOptions, EnvironmentEmulatorResult, } from './emulator.js';
-export type { VMType, InstructionType, ComplexityLevel, VMInstruction, VMFeatures, UnresolvedPart, JSVMPDeobfuscatorOptions, JSVMPDeobfuscatorResult, } from './vm.js';

package/dist/src/types/index.js

@@ -1 +0,0 @@
-export {};

package/dist/src/types/vm.d.ts

@@ -1,46 +0,0 @@
-export type VMType = 'custom' | 'obfuscator.io' | 'jsfuck' | 'jjencode' | 'unknown';
-export type InstructionType = 'load' | 'store' | 'arithmetic' | 'control' | 'call' | 'unknown';
-export type ComplexityLevel = 'low' | 'medium' | 'high';
-export interface VMInstruction {
-    opcode: number | string;
-    name: string;
-    type: InstructionType;
-    description: string;
-    args?: number;
-}
-export interface VMFeatures {
-    instructionCount: number;
-    interpreterLocation: string;
-    complexity: ComplexityLevel;
-    hasSwitch: boolean;
-    hasInstructionArray: boolean;
-    hasProgramCounter: boolean;
-}
-export interface UnresolvedPart {
-    location: string;
-    reason: string;
-    suggestion?: string;
-}
-export interface JSVMPDeobfuscatorOptions {
-    code: string;
-    aggressive?: boolean;
-    extractInstructions?: boolean;
-    timeout?: number;
-    maxIterations?: number;
-}
-export interface JSVMPDeobfuscatorResult {
-    isJSVMP: boolean;
-    vmType?: VMType;
-    vmFeatures?: VMFeatures;
-    instructions?: VMInstruction[];
-    deobfuscatedCode: string;
-    confidence: number;
-    warnings: string[];
-    unresolvedParts?: UnresolvedPart[];
-    stats?: {
-        originalSize: number;
-        deobfuscatedSize: number;
-        reductionRate: number;
-        processingTime: number;
-    };
-}

package/dist/src/types/vm.js

@@ -1 +0,0 @@
-export {};

package/dist/src/utils/AdaptiveDataSerializer.d.ts

@@ -1,29 +0,0 @@
-export interface SerializationContext {
-    maxDepth?: number;
-    maxArrayLength?: number;
-    maxStringLength?: number;
-    maxObjectKeys?: number;
-    threshold?: number;
-}
-export declare class AdaptiveDataSerializer {
-    private readonly DEFAULT_CONTEXT;
-    serialize(data: unknown, context?: SerializationContext): string;
-    private detectType;
-    private serializeLargeArray;
-    private serializeDeepObject;
-    private serializeCodeString;
-    private serializeNetworkRequests;
-    private serializeDOMStructure;
-    private serializeFunctionTree;
-    private serializeDefault;
-    private isCodeString;
-    private isRecord;
-    private isNetworkRequest;
-    private isNetworkRequestArray;
-    private isDOMStructure;
-    private isFunctionTree;
-    private getDepth;
-    private limitDepth;
-    private getFunctionTreeName;
-    private simplifyFunctionTree;
-}