@jshookmcp/jshook 0.1.7 → 0.1.8

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

@@ -23,7 +23,6 @@ export class PageNavigationHandlers {
                         text: JSON.stringify({
                             success: true,
                             driver: 'camoufox',
-                            captcha_detected: false,
                             url: page.url(),
                             title: await page.title(),
                             network_monitoring: {
@@ -51,7 +50,6 @@ export class PageNavigationHandlers {
                     type: 'text',
                     text: JSON.stringify({
                         success: true,
-                        captcha_detected: false,
                         url: currentUrl,
                         title,
                         network_monitoring: {

package/dist/server/domains/browser/handlers.impl.d.ts

@@ -394,6 +394,6 @@ export declare class BrowserToolHandlers {
     handleHumanScroll(args: Record<string, unknown>): Promise<unknown>;
     handleHumanTyping(args: Record<string, unknown>): Promise<unknown>;
     handleCaptchaVisionSolve(args: Record<string, unknown>): Promise<unknown>;
-    handleTurnstileSolve(args: Record<string, unknown>): Promise<unknown>;
+    handleWidgetChallengeSolve(args: Record<string, unknown>): Promise<unknown>;
 }
 export { BrowserControlHandlers, CamoufoxBrowserHandlers, PageNavigationHandlers, PageInteractionHandlers, PageEvaluationHandlers, PageDataHandlers, DOMQueryHandlers, DOMStyleHandlers, DOMSearchHandlers, ConsoleHandlers, ScriptManagementHandlers, CaptchaHandlers, StealthInjectionHandlers, FrameworkStateHandlers, IndexedDBDumpHandlers, DetailedDataHandlers };

package/dist/server/domains/browser/handlers.impl.js

@@ -20,7 +20,7 @@ import { IndexedDBDumpHandlers } from '../../domains/browser/handlers/indexeddb-
 import { DetailedDataHandlers } from '../../domains/browser/handlers/detailed-data.js';
 import { initializeBrowserHandlerModules } from '../../domains/browser/handlers/facade-initializer.js';
 import { handleHumanMouse, handleHumanScroll, handleHumanTyping, } from '../../domains/browser/handlers/human-behavior.js';
-import { handleCaptchaVisionSolve, handleTurnstileSolve, } from '../../domains/browser/handlers/captcha-solver.js';
+import { handleCaptchaVisionSolve, handleWidgetChallengeSolve, } from '../../domains/browser/handlers/captcha-solver.js';
 import { handleCamoufoxLaunchFlow, handleCamoufoxNavigateFlow, } from '../../domains/browser/handlers/camoufox-flow.js';
 export class BrowserToolHandlers {
     collector;
@@ -381,8 +381,8 @@ export class BrowserToolHandlers {
     async handleCaptchaVisionSolve(args) {
         return handleCaptchaVisionSolve(args, this.collector);
     }
-    async handleTurnstileSolve(args) {
-        return handleTurnstileSolve(args, this.collector);
+    async handleWidgetChallengeSolve(args) {
+        return handleWidgetChallengeSolve(args, this.collector);
     }
 }
 export { BrowserControlHandlers, CamoufoxBrowserHandlers, PageNavigationHandlers, PageInteractionHandlers, PageEvaluationHandlers, PageDataHandlers, DOMQueryHandlers, DOMStyleHandlers, DOMSearchHandlers, ConsoleHandlers, ScriptManagementHandlers, CaptchaHandlers, StealthInjectionHandlers, FrameworkStateHandlers, IndexedDBDumpHandlers, DetailedDataHandlers };

package/dist/server/domains/browser/manifest.js

@@ -79,7 +79,7 @@ const manifest = {
         { tool: t('human_scroll'), domain: DOMAIN, bind: b((h, a) => h.handleHumanScroll(a)) },
         { tool: t('human_typing'), domain: DOMAIN, bind: b((h, a) => h.handleHumanTyping(a)) },
         { tool: t('captcha_vision_solve'), domain: DOMAIN, bind: b((h, a) => h.handleCaptchaVisionSolve(a)) },
-        { tool: t('turnstile_solve'), domain: DOMAIN, bind: b((h, a) => h.handleTurnstileSolve(a)) },
+        { tool: t('widget_challenge_solve'), domain: DOMAIN, bind: b((h, a) => h.handleWidgetChallengeSolve(a)) },
     ],
 };
 export default manifest;

package/dist/server/domains/shared/modules.d.ts

@@ -1,6 +1,7 @@
 export { CodeAnalyzer } from '../../../modules/analyzer/CodeAnalyzer.js';
 export { CamoufoxBrowserManager } from '../../../modules/browser/CamoufoxBrowserManager.js';
 export { AICaptchaDetector } from '../../../modules/captcha/AICaptchaDetector.js';
+export type { CaptchaType, CaptchaProviderHint, CaptchaDetectionResult, AICaptchaDetectionResult, CaptchaDetectionConfig, } from '../../../modules/captcha/types.js';
 export { CodeCollector } from '../../../modules/collector/CodeCollector.js';
 export { DOMInspector } from '../../../modules/collector/DOMInspector.js';
 export { PageController } from '../../../modules/collector/PageController.js';

package/dist/types/deobfuscator.d.ts

@@ -1,4 +1,4 @@
-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';
+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;
@@ -11,6 +11,42 @@ export interface DeobfuscateOptions {
     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;
@@ -19,4 +55,10 @@ export interface DeobfuscateResult {
     obfuscationType: ObfuscationType[];
     transformations: Transformation[];
     analysis: string;
+    bundle?: DeobfuscateBundleSummary;
+    savedTo?: string;
+    savedArtifacts?: DeobfuscateSavedArtifact[];
+    warnings?: string[];
+    engine?: 'legacy' | 'webcrack' | 'hybrid';
+    webcrackApplied?: boolean;
 }

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export type { CodeLocation, Result } from './common.js';
 export type { Config, LLMConfig, PuppeteerConfig, MCPConfig, CacheConfig, PerformanceConfig, } 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, } from './deobfuscator.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';

package/dist/utils/config.js

@@ -6,14 +6,22 @@ const currentFilename = fileURLToPath(import.meta.url);
 const currentDirname = dirname(currentFilename);
 export const projectRoot = join(currentDirname, '..', '..');
 const envPath = join(projectRoot, '.env');
-const result = dotenvConfig({ path: envPath, quiet: true });
-if (result.error) {
-    console.error('[Config] Warning: Failed to load .env file from configured path');
-    console.error(`[Config] Error: ${result.error.message}`);
-    console.error('[Config] Will use environment variables or defaults');
-}
-else if (process.env.DEBUG === 'true') {
-    console.info('[Config] .env file loaded (debug mode)');
+let envLoaded = false;
+function loadEnvIfNeeded() {
+    if (envLoaded) {
+        return;
+    }
+    envLoaded = true;
+    const result = dotenvConfig({ path: envPath, quiet: true });
+    const errorCode = result.error?.code;
+    if (result.error && errorCode !== 'ENOENT') {
+        console.error('[Config] Warning: Failed to load .env file from configured path');
+        console.error(`[Config] Error: ${result.error.message}`);
+        console.error('[Config] Will use environment variables or defaults');
+    }
+    else if (!result.error && process.env.DEBUG === 'true') {
+        console.info('[Config] .env file loaded (debug mode)');
+    }
 }
 const envInt = (fallback) => z.string().optional()
     .transform((v) => (v ? parseInt(v, 10) : fallback))
@@ -34,7 +42,7 @@ const ConfigSchema = z.object({
     CHROME_PATH: z.string().optional(),
     BROWSER_EXECUTABLE_PATH: z.string().optional(),
     MCP_SERVER_NAME: z.string().optional().default('jshookmcp'),
-    MCP_SERVER_VERSION: z.string().optional().default('0.1.0'),
+    MCP_SERVER_VERSION: z.string().optional().default('0.1.8'),
     ENABLE_CACHE: envBool(false),
     CACHE_DIR: z.string().optional().default('.cache'),
     CACHE_TTL: envInt(3600).pipe(z.number().min(0)),
@@ -42,6 +50,7 @@ const ConfigSchema = z.object({
     MAX_CODE_SIZE_MB: envInt(10).pipe(z.number().min(1).max(500)),
 });
 export function getConfig() {
+    loadEnvIfNeeded();
     const parsed = ConfigSchema.safeParse(process.env);
     if (!parsed.success) {
         const issues = parsed.error.issues.map((i) => `  ${i.path.join('.')}: ${i.message}`);
@@ -77,7 +86,7 @@ export function getConfig() {
         },
         mcp: {
             name: env.MCP_SERVER_NAME || 'jshookmcp',
-            version: env.MCP_SERVER_VERSION || '0.1.0',
+            version: env.MCP_SERVER_VERSION || '0.1.8',
         },
         cache: {
             enabled: parsed.success ? env.ENABLE_CACHE : process.env.ENABLE_CACHE === 'true',

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@jshookmcp/jshook",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "MCP server with 244 built-in tools (236 domain tools across 16 domains) for AI-assisted JavaScript analysis and security analysis — browser automation, CDP debugging, network monitoring, JS hooks, code analysis, and workflow orchestration",
   "mcpName": "io.github.vmoranv/jshookmcp",
   "main": "dist/index.js",
   "type": "module",
   "files": [
     "dist",
-    "src/native/scripts"
+    "src/native/scripts",
+    "scripts/postinstall.cjs"
   ],
   "bin": {
     "jshook": "dist/index.js",
@@ -68,6 +69,7 @@
     "openai": "^6.25.0",
     "ora": "^9.3.0",
     "rebrowser-puppeteer-core": "^24.8.1",
+    "webcrack": "^2.15.1",
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
@@ -113,10 +115,11 @@
     "test": "vitest run",
     "test:coverage": "cross-env ENABLE_INJECTION_TOOLS=true vitest run --coverage",
     "package:verify-bin": "node scripts/verify-packed-bin.mjs",
+    "package:verify-install": "node scripts/verify-packed-install.mjs",
     "audit:tools": "node scripts/audit-tools.mjs",
     "check": "pnpm run lint && pnpm run typecheck && pnpm run test",
     "package": "pnpm pack",
-    "postinstall": "lefthook install",
+    "postinstall": "node scripts/postinstall.cjs",
     "install:full": "pnpm install && pnpm exec camoufox-js fetch"
   }
 }

package/scripts/postinstall.cjs

@@ -0,0 +1,37 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const repoGitDir = path.join(process.cwd(), '.git');
+const localBin = path.join(
+  process.cwd(),
+  'node_modules',
+  '.bin',
+  process.platform === 'win32' ? 'lefthook.cmd' : 'lefthook'
+);
+
+if (!fs.existsSync(repoGitDir)) {
+  process.exit(0);
+}
+
+if (!fs.existsSync(localBin)) {
+  console.warn('[postinstall] lefthook not found locally; skipping git hook installation.');
+  process.exit(0);
+}
+
+const result = spawnSync(localBin, ['install'], {
+  stdio: 'inherit',
+  shell: process.platform === 'win32',
+});
+
+if (result.error) {
+  console.warn(
+    `[postinstall] lefthook install failed to spawn: ${result.error.message}; skipping git hook installation.`
+  );
+} else if (result.status !== 0) {
+  console.warn(
+    `[postinstall] lefthook install exited with status ${result.status}; skipping git hook installation.`
+  );
+}
+
+process.exit(0);