@jshookmcp/jshook 0.2.3 → 0.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (385) hide show
  1. package/README.md +14 -5
  2. package/README.zh.md +18 -3
  3. package/dist/packages/extension-sdk/src/bridges/shared.js +2 -2
  4. package/dist/packages/extension-sdk/src/plugin.d.ts +5 -0
  5. package/dist/packages/extension-sdk/src/plugin.js +119 -33
  6. package/dist/packages/extension-sdk/src/workflow.d.ts +156 -0
  7. package/dist/packages/extension-sdk/src/workflow.js +236 -0
  8. package/dist/src/config/search-defaults.js +161 -0
  9. package/dist/src/constants.d.ts +3 -0
  10. package/dist/src/constants.js +4 -1
  11. package/dist/src/index.d.ts +1 -1
  12. package/dist/src/index.js +13 -17
  13. package/dist/src/modules/analyzer/CodeAnalyzer.d.ts +1 -3
  14. package/dist/src/modules/analyzer/CodeAnalyzer.js +16 -28
  15. package/dist/src/modules/analyzer/CodeAnalyzerDataFlow.d.ts +1 -2
  16. package/dist/src/modules/analyzer/CodeAnalyzerDataFlow.js +1 -45
  17. package/dist/src/modules/analyzer/IntelligentAnalyzer.d.ts +1 -37
  18. package/dist/src/modules/analyzer/IntelligentAnalyzer.js +9 -142
  19. package/dist/src/modules/analyzer/PatternDetector.js +3 -3
  20. package/dist/src/modules/analyzer/PatternDetectorAuthPatterns.js +1 -1
  21. package/dist/src/modules/browser/BrowserDiscovery.js +2 -2
  22. package/dist/src/modules/browser/BrowserModeManager.js +11 -10
  23. package/dist/src/modules/browser/TabRegistry.js +2 -2
  24. package/dist/src/modules/browser/UnifiedBrowserManager.d.ts +1 -0
  25. package/dist/src/modules/browser/UnifiedBrowserManager.js +18 -3
  26. package/dist/src/modules/captcha/AICaptchaDetector.d.ts +1 -10
  27. package/dist/src/modules/captcha/AICaptchaDetector.js +7 -201
  28. package/dist/src/modules/collector/CodeCollector.js +4 -5
  29. package/dist/src/modules/collector/DOMInspector.js +48 -58
  30. package/dist/src/modules/collector/PageController.d.ts +17 -4
  31. package/dist/src/modules/collector/PageController.js +2 -5
  32. package/dist/src/modules/collector/PageScriptCollectors.js +3 -3
  33. package/dist/src/modules/crypto/CryptoDetector.d.ts +1 -4
  34. package/dist/src/modules/crypto/CryptoDetector.js +2 -42
  35. package/dist/src/modules/crypto/CryptoRules.js +1 -1
  36. package/dist/src/modules/debugger/BlackboxManager.js +1 -1
  37. package/dist/src/modules/debugger/DebuggerManager.impl.core.scope.js +1 -1
  38. package/dist/src/modules/debugger/ScriptManager.impl.extract-function-tree.js +4 -2
  39. package/dist/src/modules/debugger/WatchExpressionManager.js +1 -1
  40. package/dist/src/modules/deobfuscator/Deobfuscator.d.ts +1 -4
  41. package/dist/src/modules/deobfuscator/Deobfuscator.js +4 -39
  42. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.d.ts +0 -3
  43. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.js +2 -8
  44. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.restore.d.ts +1 -2
  45. package/dist/src/modules/deobfuscator/JSVMPDeobfuscator.restore.js +3 -55
  46. package/dist/src/modules/deobfuscator/JScramblerDeobfuscator.js +3 -4
  47. package/dist/src/modules/deobfuscator/VMDeobfuscator.d.ts +2 -10
  48. package/dist/src/modules/deobfuscator/VMDeobfuscator.js +3 -128
  49. package/dist/src/modules/deobfuscator/webcrack.js +15 -2
  50. package/dist/src/modules/emulator/AIEnvironmentAnalyzer.d.ts +5 -8
  51. package/dist/src/modules/emulator/AIEnvironmentAnalyzer.js +10 -102
  52. package/dist/src/modules/emulator/EnvironmentEmulator.d.ts +1 -5
  53. package/dist/src/modules/emulator/EnvironmentEmulator.js +7 -91
  54. package/dist/src/modules/emulator/EnvironmentEmulatorFetch.js +58 -61
  55. package/dist/src/modules/emulator/templates/chrome-env.d.ts +17 -7
  56. package/dist/src/modules/emulator/templates/chrome-env.js +14 -7
  57. package/dist/src/modules/external/ExternalToolRunner.js +25 -22
  58. package/dist/src/modules/hook/HookGeneratorBuilders.core.generators.compose.js +5 -5
  59. package/dist/src/modules/hook/HookGeneratorBuilders.core.generators.network.js +311 -311
  60. package/dist/src/modules/hook/HookGeneratorBuilders.core.generators.runtime.js +410 -410
  61. package/dist/src/modules/hook/HookGeneratorBuilders.core.generators.storage.js +122 -122
  62. package/dist/src/modules/monitor/ConsoleMonitor.impl.core.class.d.ts +13 -0
  63. package/dist/src/modules/monitor/ConsoleMonitor.impl.core.class.js +42 -0
  64. package/dist/src/modules/monitor/ConsoleMonitor.impl.core.dynamic.js +194 -194
  65. package/dist/src/modules/monitor/FetchInterceptor.d.ts +46 -0
  66. package/dist/src/modules/monitor/FetchInterceptor.js +191 -0
  67. package/dist/src/modules/monitor/PerformanceMonitor.js +8 -7
  68. package/dist/src/modules/monitor/PlaywrightNetworkMonitor.js +62 -62
  69. package/dist/src/modules/process/BaseMemoryManager.d.ts +1 -1
  70. package/dist/src/modules/process/LinuxProcessManager.js +2 -0
  71. package/dist/src/modules/process/MacProcessManager.js +25 -25
  72. package/dist/src/modules/process/MemoryManager.d.ts +1 -1
  73. package/dist/src/modules/process/MemoryManager.js +2 -2
  74. package/dist/src/modules/process/memory/AuditTrail.js +1 -1
  75. package/dist/src/modules/process/memory/availability.js +49 -49
  76. package/dist/src/modules/process/memory/injector.js +185 -185
  77. package/dist/src/modules/process/memory/reader.js +85 -53
  78. package/dist/src/modules/process/memory/regions.dump.js +51 -51
  79. package/dist/src/modules/process/memory/regions.enumerate.js +108 -108
  80. package/dist/src/modules/process/memory/regions.modules.js +80 -80
  81. package/dist/src/modules/process/memory/regions.protection.js +148 -115
  82. package/dist/src/modules/process/memory/scanner.d.ts +5 -1
  83. package/dist/src/modules/process/memory/scanner.darwin.js +98 -41
  84. package/dist/src/modules/process/memory/scanner.js +88 -4
  85. package/dist/src/modules/process/memory/scanner.windows.js +124 -124
  86. package/dist/src/modules/process/memory/writer.js +98 -58
  87. package/dist/src/modules/security/ExecutionSandbox.js +51 -52
  88. package/dist/src/modules/stealth/FingerprintManager.js +1 -1
  89. package/dist/src/modules/stealth/StealthScripts.d.ts +1 -0
  90. package/dist/src/modules/stealth/StealthScripts.js +18 -13
  91. package/dist/src/modules/stealth/StealthVerifier.js +1 -3
  92. package/dist/src/modules/symbolic/JSVMPSymbolicExecutor.d.ts +14 -0
  93. package/dist/src/modules/symbolic/JSVMPSymbolicExecutor.js +181 -2
  94. package/dist/src/modules/trace/TraceDB.js +75 -69
  95. package/dist/src/modules/trace/TraceRecorder.js +1 -5
  96. package/dist/src/native/AntiCheatDetector.js +67 -16
  97. package/dist/src/native/CodeInjector.js +3 -3
  98. package/dist/src/native/HardwareBreakpoint.js +24 -15
  99. package/dist/src/native/HeapAnalyzer.js +2 -2
  100. package/dist/src/native/MemoryController.js +1 -1
  101. package/dist/src/native/MemoryScanSession.js +2 -2
  102. package/dist/src/native/MemoryScanner.js +4 -8
  103. package/dist/src/native/NativeMemoryManager.impl.js +2 -2
  104. package/dist/src/native/PEAnalyzer.js +14 -15
  105. package/dist/src/native/PointerChainEngine.js +2 -4
  106. package/dist/src/native/ScriptLoader.js +4 -9
  107. package/dist/src/native/Speedhack.js +1 -1
  108. package/dist/src/native/StructureAnalyzer.js +52 -33
  109. package/dist/src/native/Win32API.d.ts +1 -0
  110. package/dist/src/native/Win32API.js +13 -0
  111. package/dist/src/native/Win32Debug.js +19 -19
  112. package/dist/src/native/platform/darwin/DarwinAPI.d.ts +2 -0
  113. package/dist/src/native/platform/darwin/DarwinAPI.js +8 -0
  114. package/dist/src/native/platform/darwin/DarwinMemoryProvider.js +6 -1
  115. package/dist/src/server/MCPServer.context.d.ts +2 -1
  116. package/dist/src/server/MCPServer.d.ts +2 -1
  117. package/dist/src/server/MCPServer.domain.d.ts +1 -1
  118. package/dist/src/server/MCPServer.domain.js +81 -16
  119. package/dist/src/server/MCPServer.js +41 -14
  120. package/dist/src/server/MCPServer.resources.d.ts +2 -0
  121. package/dist/src/server/MCPServer.resources.js +91 -0
  122. package/dist/src/server/MCPServer.search.handlers.call.js +2 -1
  123. package/dist/src/server/MCPServer.search.helpers.js +1 -1
  124. package/dist/src/server/MCPServer.transport.js +12 -0
  125. package/dist/src/server/ToolCallContextGuard.js +8 -0
  126. package/dist/src/server/ToolRouter.d.ts +25 -9
  127. package/dist/src/server/ToolRouter.intent.d.ts +26 -0
  128. package/dist/src/server/ToolRouter.intent.js +77 -0
  129. package/dist/src/server/ToolRouter.js +103 -284
  130. package/dist/src/server/ToolRouter.policy.d.ts +22 -0
  131. package/dist/src/server/ToolRouter.policy.js +163 -0
  132. package/dist/src/server/ToolRouter.probe.d.ts +17 -0
  133. package/dist/src/server/ToolRouter.probe.js +103 -0
  134. package/dist/src/server/ToolRouter.renderer.d.ts +9 -0
  135. package/dist/src/server/ToolRouter.renderer.js +52 -0
  136. package/dist/src/server/activation/ActivationController.js +15 -12
  137. package/dist/src/server/activation/CompoundConditionEngine.js +1 -1
  138. package/dist/src/server/activation/PredictiveBooster.js +1 -3
  139. package/dist/src/server/domains/analysis/definitions.js +155 -655
  140. package/dist/src/server/domains/analysis/handlers.impl.js +26 -20
  141. package/dist/src/server/domains/analysis/handlers.web-tools.js +2 -1
  142. package/dist/src/server/domains/analysis/manifest.js +6 -4
  143. package/dist/src/server/domains/antidebug/definitions.js +25 -111
  144. package/dist/src/server/domains/browser/definitions.tools.advanced.js +59 -88
  145. package/dist/src/server/domains/browser/definitions.tools.behavior.js +120 -227
  146. package/dist/src/server/domains/browser/definitions.tools.page-core.js +210 -439
  147. package/dist/src/server/domains/browser/definitions.tools.page-system.js +108 -250
  148. package/dist/src/server/domains/browser/definitions.tools.runtime.js +98 -211
  149. package/dist/src/server/domains/browser/definitions.tools.security.js +194 -339
  150. package/dist/src/server/domains/browser/handlers/camoufox-browser.js +3 -2
  151. package/dist/src/server/domains/browser/handlers/captcha-solver.js +3 -3
  152. package/dist/src/server/domains/browser/handlers/dom-query.js +2 -1
  153. package/dist/src/server/domains/browser/handlers/framework-state.js +27 -9
  154. package/dist/src/server/domains/browser/handlers/indexeddb-dump.js +21 -20
  155. package/dist/src/server/domains/browser/handlers/script-management.js +1 -1
  156. package/dist/src/server/domains/browser/handlers.impl.d.ts +1 -2
  157. package/dist/src/server/domains/browser/handlers.impl.js +2 -3
  158. package/dist/src/server/domains/browser/manifest.js +37 -13
  159. package/dist/src/server/domains/coordination/definitions.js +50 -216
  160. package/dist/src/server/domains/coordination/index.d.ts +2 -1
  161. package/dist/src/server/domains/coordination/index.js +1 -0
  162. package/dist/src/server/domains/debugger/definitions.tools.advanced.js +72 -189
  163. package/dist/src/server/domains/debugger/definitions.tools.core.js +114 -288
  164. package/dist/src/server/domains/debugger/manifest.js +9 -2
  165. package/dist/src/server/domains/encoding/definitions.js +43 -153
  166. package/dist/src/server/domains/encoding/handlers.base.js +2 -2
  167. package/dist/src/server/domains/evidence/definitions.d.ts +2 -0
  168. package/dist/src/server/domains/evidence/definitions.js +42 -0
  169. package/dist/src/server/domains/evidence/handlers.d.ts +582 -0
  170. package/dist/src/server/domains/evidence/handlers.js +60 -0
  171. package/dist/src/server/domains/evidence/index.d.ts +2 -0
  172. package/dist/src/server/domains/evidence/index.js +2 -0
  173. package/dist/src/server/domains/evidence/manifest.d.ts +63 -0
  174. package/dist/src/server/domains/evidence/manifest.js +78 -0
  175. package/dist/src/server/domains/graphql/definitions.js +53 -141
  176. package/dist/src/server/domains/graphql/handlers.impl.core.runtime.replay.js +92 -114
  177. package/dist/src/server/domains/graphql/handlers.impl.core.runtime.shared.js +77 -77
  178. package/dist/src/server/domains/hooks/ai-handlers.d.ts +0 -7
  179. package/dist/src/server/domains/hooks/ai-handlers.js +1 -67
  180. package/dist/src/server/domains/hooks/definitions.js +69 -335
  181. package/dist/src/server/domains/hooks/manifest.d.ts +1 -1
  182. package/dist/src/server/domains/hooks/manifest.js +1 -2
  183. package/dist/src/server/domains/instrumentation/definitions.d.ts +2 -0
  184. package/dist/src/server/domains/instrumentation/definitions.js +99 -0
  185. package/dist/src/server/domains/instrumentation/handlers.d.ts +78 -0
  186. package/dist/src/server/domains/instrumentation/handlers.js +206 -0
  187. package/dist/src/server/domains/instrumentation/index.d.ts +2 -0
  188. package/dist/src/server/domains/instrumentation/index.js +2 -0
  189. package/dist/src/server/domains/instrumentation/manifest.d.ts +63 -0
  190. package/dist/src/server/domains/instrumentation/manifest.js +114 -0
  191. package/dist/src/server/domains/macro/definitions.js +16 -43
  192. package/dist/src/server/domains/maintenance/definitions.js +60 -219
  193. package/dist/src/server/domains/maintenance/handlers.extensions.js +78 -20
  194. package/dist/src/server/domains/memory/definitions.js +387 -559
  195. package/dist/src/server/domains/memory/handlers/hooks.d.ts +55 -0
  196. package/dist/src/server/domains/memory/handlers/hooks.js +115 -0
  197. package/dist/src/server/domains/memory/handlers/integrity.d.ts +77 -0
  198. package/dist/src/server/domains/memory/handlers/integrity.js +180 -0
  199. package/dist/src/server/domains/memory/handlers/pointer-chain.d.ts +29 -0
  200. package/dist/src/server/domains/memory/handlers/pointer-chain.js +82 -0
  201. package/dist/src/server/domains/memory/handlers/readwrite.d.ts +41 -0
  202. package/dist/src/server/domains/memory/handlers/readwrite.js +78 -0
  203. package/dist/src/server/domains/memory/handlers/scan.d.ts +35 -0
  204. package/dist/src/server/domains/memory/handlers/scan.js +97 -0
  205. package/dist/src/server/domains/memory/handlers/session.d.ts +23 -0
  206. package/dist/src/server/domains/memory/handlers/session.js +49 -0
  207. package/dist/src/server/domains/memory/handlers/structure.d.ts +29 -0
  208. package/dist/src/server/domains/memory/handlers/structure.js +74 -0
  209. package/dist/src/server/domains/memory/handlers.impl.d.ts +49 -54
  210. package/dist/src/server/domains/memory/handlers.impl.js +63 -494
  211. package/dist/src/server/domains/memory/manifest.js +236 -64
  212. package/dist/src/server/domains/native-bridge/definitions.js +54 -192
  213. package/dist/src/server/domains/native-bridge/index.d.ts +1 -0
  214. package/dist/src/server/domains/native-bridge/index.js +2 -1
  215. package/dist/src/server/domains/network/auth-extractor.js +1 -1
  216. package/dist/src/server/domains/network/definitions.js +175 -578
  217. package/dist/src/server/domains/network/handlers.base.core.d.ts +64 -0
  218. package/dist/src/server/domains/network/handlers.base.core.js +623 -0
  219. package/dist/src/server/domains/network/handlers.base.d.ts +2 -124
  220. package/dist/src/server/domains/network/handlers.base.js +3 -878
  221. package/dist/src/server/domains/network/handlers.base.performance.d.ts +63 -0
  222. package/dist/src/server/domains/network/handlers.base.performance.js +193 -0
  223. package/dist/src/server/domains/network/handlers.base.types.d.ts +42 -0
  224. package/dist/src/server/domains/network/handlers.base.types.js +89 -0
  225. package/dist/src/server/domains/network/handlers.impl.core.runtime.d.ts +1 -1
  226. package/dist/src/server/domains/network/handlers.impl.core.runtime.intercept.d.ts +21 -0
  227. package/dist/src/server/domains/network/handlers.impl.core.runtime.intercept.js +186 -0
  228. package/dist/src/server/domains/network/handlers.impl.core.runtime.js +1 -1
  229. package/dist/src/server/domains/network/manifest.js +15 -0
  230. package/dist/src/server/domains/network/replay.js +1 -4
  231. package/dist/src/server/domains/platform/definitions.js +121 -112
  232. package/dist/src/server/domains/platform/handlers/bridge-handlers.d.ts +4 -0
  233. package/dist/src/server/domains/platform/handlers/bridge-handlers.js +193 -4
  234. package/dist/src/server/domains/platform/handlers/electron-asar-helpers.js +26 -6
  235. package/dist/src/server/domains/platform/handlers/electron-dual-cdp.d.ts +3 -0
  236. package/dist/src/server/domains/platform/handlers/electron-dual-cdp.js +170 -0
  237. package/dist/src/server/domains/platform/handlers/electron-fuse-handler.d.ts +3 -0
  238. package/dist/src/server/domains/platform/handlers/electron-fuse-handler.js +193 -0
  239. package/dist/src/server/domains/platform/handlers/electron-handlers.d.ts +6 -0
  240. package/dist/src/server/domains/platform/handlers/electron-handlers.js +95 -2
  241. package/dist/src/server/domains/platform/handlers/electron-ipc-sniffer.d.ts +2 -0
  242. package/dist/src/server/domains/platform/handlers/electron-ipc-sniffer.js +370 -0
  243. package/dist/src/server/domains/platform/handlers/electron-userdata-handler.d.ts +2 -0
  244. package/dist/src/server/domains/platform/handlers/electron-userdata-handler.js +78 -0
  245. package/dist/src/server/domains/platform/handlers/miniapp-handlers.js +3 -3
  246. package/dist/src/server/domains/platform/handlers/v8-bytecode-handler.d.ts +2 -0
  247. package/dist/src/server/domains/platform/handlers/v8-bytecode-handler.js +207 -0
  248. package/dist/src/server/domains/platform/handlers.d.ts +48 -0
  249. package/dist/src/server/domains/platform/handlers.js +29 -0
  250. package/dist/src/server/domains/platform/manifest.js +38 -0
  251. package/dist/src/server/domains/process/definitions.js +163 -647
  252. package/dist/src/server/domains/process/handlers.base.d.ts +3 -95
  253. package/dist/src/server/domains/process/handlers.base.js +7 -462
  254. package/dist/src/server/domains/process/handlers.base.process.d.ts +61 -0
  255. package/dist/src/server/domains/process/handlers.base.process.js +417 -0
  256. package/dist/src/server/domains/process/handlers.base.types.d.ts +57 -0
  257. package/dist/src/server/domains/process/handlers.base.types.js +50 -0
  258. package/dist/src/server/domains/process/handlers.impl.core.runtime.inject.js +18 -16
  259. package/dist/src/server/domains/process/manifest.js +6 -1
  260. package/dist/src/server/domains/sandbox/definitions.js +11 -33
  261. package/dist/src/server/domains/sandbox/handlers.js +8 -3
  262. package/dist/src/server/domains/shared/ResponseBuilder.d.ts +209 -0
  263. package/dist/src/server/domains/shared/ResponseBuilder.js +48 -0
  264. package/dist/src/server/domains/shared/modules.d.ts +0 -2
  265. package/dist/src/server/domains/shared/modules.js +0 -1
  266. package/dist/src/server/domains/sourcemap/definitions.js +27 -111
  267. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-common.js +7 -2
  268. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-main.js +1 -1
  269. package/dist/src/server/domains/sourcemap/handlers.impl.sourcemap-parse-base.js +1 -1
  270. package/dist/src/server/domains/sourcemap/manifest.d.ts +1 -1
  271. package/dist/src/server/domains/sourcemap/manifest.js +1 -1
  272. package/dist/src/server/domains/streaming/definitions.js +36 -148
  273. package/dist/src/server/domains/streaming/handlers.impl.streaming-sse.js +163 -164
  274. package/dist/src/server/domains/streaming/handlers.impl.streaming-ws.js +1 -1
  275. package/dist/src/server/domains/trace/TraceSummarizer.js +8 -5
  276. package/dist/src/server/domains/trace/definitions.tools.js +51 -206
  277. package/dist/src/server/domains/trace/handlers.js +10 -12
  278. package/dist/src/server/domains/trace/index.d.ts +2 -1
  279. package/dist/src/server/domains/trace/index.js +2 -1
  280. package/dist/src/server/domains/trace/manifest.js +15 -3
  281. package/dist/src/server/domains/transform/definitions.js +50 -210
  282. package/dist/src/server/domains/transform/handlers.impl.transform-base.js +108 -108
  283. package/dist/src/server/domains/transform/handlers.impl.transform-crypto.js +18 -19
  284. package/dist/src/server/domains/transform/manifest.d.ts +1 -1
  285. package/dist/src/server/domains/transform/manifest.js +1 -1
  286. package/dist/src/server/domains/wasm/definitions.js +55 -232
  287. package/dist/src/server/domains/wasm/handlers.js +1 -1
  288. package/dist/src/server/domains/workflow/definitions.js +144 -414
  289. package/dist/src/server/domains/workflow/handlers.impl.workflow-account-bundle.js +1 -1
  290. package/dist/src/server/domains/workflow/handlers.impl.workflow-api.js +51 -51
  291. package/dist/src/server/domains/workflow/handlers.impl.workflow-base.d.ts +2 -0
  292. package/dist/src/server/domains/workflow/handlers.impl.workflow-base.js +126 -87
  293. package/dist/src/server/domains/workflow/handlers.impl.workflow-batch.js +5 -5
  294. package/dist/src/server/evidence/ReverseEvidenceGraph.d.ts +20 -0
  295. package/dist/src/server/evidence/ReverseEvidenceGraph.js +208 -0
  296. package/dist/src/server/evidence/index.d.ts +2 -0
  297. package/dist/src/server/evidence/index.js +1 -0
  298. package/dist/src/server/evidence/types.d.ts +22 -0
  299. package/dist/src/server/evidence/types.js +1 -0
  300. package/dist/src/server/extensions/ExtensionManager.d.ts +1 -0
  301. package/dist/src/server/extensions/ExtensionManager.discovery.js +72 -9
  302. package/dist/src/server/extensions/ExtensionManager.integrity.js +1 -1
  303. package/dist/src/server/extensions/ExtensionManager.js +193 -40
  304. package/dist/src/server/extensions/ExtensionManager.roots.d.ts +1 -1
  305. package/dist/src/server/extensions/ExtensionManager.roots.js +4 -4
  306. package/dist/src/server/extensions/plugin-config.js +1 -1
  307. package/dist/src/server/extensions/plugin-env.d.ts +1 -1
  308. package/dist/src/server/extensions/plugin-env.js +10 -4
  309. package/dist/src/server/extensions/types.d.ts +17 -0
  310. package/dist/src/server/extensions/types.js +1 -1
  311. package/dist/src/server/instrumentation/EvidenceGraphBridge.d.ts +13 -0
  312. package/dist/src/server/instrumentation/EvidenceGraphBridge.js +150 -0
  313. package/dist/src/server/instrumentation/InstrumentationSession.d.ts +60 -0
  314. package/dist/src/server/instrumentation/InstrumentationSession.js +269 -0
  315. package/dist/src/server/instrumentation/index.d.ts +2 -0
  316. package/dist/src/server/instrumentation/index.js +2 -0
  317. package/dist/src/server/instrumentation/types.d.ts +62 -0
  318. package/dist/src/server/instrumentation/types.js +7 -0
  319. package/dist/src/server/macros/MacroConfigLoader.d.ts +6 -5
  320. package/dist/src/server/macros/MacroConfigLoader.js +61 -59
  321. package/dist/src/server/macros/MacroRunner.js +6 -2
  322. package/dist/src/server/macros/builtins/index.d.ts +2 -3
  323. package/dist/src/server/macros/builtins/index.js +51 -7
  324. package/dist/src/server/plugins/PluginContract.d.ts +1 -1
  325. package/dist/src/server/registry/contracts.d.ts +1 -1
  326. package/dist/src/server/registry/discovery.js +5 -4
  327. package/dist/src/server/registry/ensure-browser-core.js +0 -3
  328. package/dist/src/server/registry/index.js +4 -4
  329. package/dist/src/server/registry/tool-builder.d.ts +46 -0
  330. package/dist/src/server/registry/tool-builder.js +105 -0
  331. package/dist/src/server/sandbox/QuickJSSandbox.js +16 -5
  332. package/dist/src/server/sandbox/SandboxHelpers.js +250 -250
  333. package/dist/src/server/search/EmbeddingWorker.js +5 -3
  334. package/dist/src/server/search/FeedbackTracker.d.ts +9 -0
  335. package/dist/src/server/search/FeedbackTracker.js +26 -0
  336. package/dist/src/server/search/QueryNormalizer.d.ts +6 -0
  337. package/dist/src/server/search/QueryNormalizer.js +94 -0
  338. package/dist/src/server/search/ToolSearchEngineImpl.d.ts +2 -3
  339. package/dist/src/server/search/ToolSearchEngineImpl.js +38 -88
  340. package/dist/src/server/workflows/WorkflowContract.d.ts +24 -0
  341. package/dist/src/server/workflows/WorkflowContract.js +12 -0
  342. package/dist/src/server/workflows/WorkflowEngine.d.ts +1 -0
  343. package/dist/src/server/workflows/WorkflowEngine.js +136 -3
  344. package/dist/src/types/config.d.ts +0 -14
  345. package/dist/src/types/deobfuscator.d.ts +0 -1
  346. package/dist/src/types/index.d.ts +1 -1
  347. package/dist/src/utils/DetailedDataManager.js +2 -0
  348. package/dist/src/utils/RingBuffer.js +5 -5
  349. package/dist/src/utils/TokenBudgetManager.js +1 -1
  350. package/dist/src/utils/UnifiedCacheManager.js +1 -1
  351. package/dist/src/utils/artifactRetention.js +2 -2
  352. package/dist/src/utils/betterSqlite3.d.ts +11 -0
  353. package/dist/src/utils/betterSqlite3.js +88 -0
  354. package/dist/src/utils/browserExecutable.js +2 -2
  355. package/dist/src/utils/cliFastPath.js +5 -8
  356. package/dist/src/utils/config.js +4 -26
  357. package/dist/src/utils/environmentDoctor.js +138 -11
  358. package/dist/src/utils/outputPaths.js +16 -9
  359. package/dist/src/utils/parallel.js +1 -3
  360. package/package.json +74 -72
  361. package/workflows/.gitkeep +0 -0
  362. package/dist/src/modules/analyzer/AISummarizer.d.ts +0 -39
  363. package/dist/src/modules/analyzer/AISummarizer.js +0 -122
  364. package/dist/src/modules/hook/AIHookGenerator.d.ts +0 -52
  365. package/dist/src/modules/hook/AIHookGenerator.js +0 -360
  366. package/dist/src/modules/hook/AIHookGeneratorTemplates.d.ts +0 -9
  367. package/dist/src/modules/hook/AIHookGeneratorTemplates.js +0 -157
  368. package/dist/src/server/macros/builtins/deobfuscate-ast-flow.d.ts +0 -2
  369. package/dist/src/server/macros/builtins/deobfuscate-ast-flow.js +0 -25
  370. package/dist/src/server/macros/builtins/unpacker-flow.d.ts +0 -2
  371. package/dist/src/server/macros/builtins/unpacker-flow.js +0 -25
  372. package/dist/src/services/LLMService.d.ts +0 -37
  373. package/dist/src/services/LLMService.js +0 -233
  374. package/dist/src/services/prompts/analysis.d.ts +0 -9
  375. package/dist/src/services/prompts/analysis.js +0 -158
  376. package/dist/src/services/prompts/crypto.d.ts +0 -2
  377. package/dist/src/services/prompts/crypto.js +0 -108
  378. package/dist/src/services/prompts/deobfuscation.d.ts +0 -6
  379. package/dist/src/services/prompts/deobfuscation.js +0 -300
  380. package/dist/src/services/prompts/environment.d.ts +0 -16
  381. package/dist/src/services/prompts/environment.js +0 -372
  382. package/dist/src/services/prompts/intelligence.d.ts +0 -4
  383. package/dist/src/services/prompts/intelligence.js +0 -250
  384. package/dist/src/services/prompts/taint.d.ts +0 -2
  385. package/dist/src/services/prompts/taint.js +0 -54
@@ -9,93 +9,93 @@ export async function enableDynamicScriptMonitoringCore(ctx, options) {
9
9
  if (!coreCtx.cdpSession) {
10
10
  throw new PrerequisiteError('CDP session not available after reconnect attempt');
11
11
  }
12
- const monitorCode = `
13
- (function() {
14
- if (window.__dynamicScriptMonitorInstalled) {
15
- console.log('[ScriptMonitor] Already installed');
16
- return;
17
- }
18
- window.__dynamicScriptMonitorInstalled = true;
19
-
20
- const maxRecords = ${coreCtx.MAX_INJECTED_DYNAMIC_SCRIPTS};
21
- if (!window.__dynamicScripts) {
22
- window.__dynamicScripts = [];
23
- }
24
- const dynamicScripts = window.__dynamicScripts;
25
- const state = window.__dynamicScriptMonitorState || {};
26
- if (!state.originalCreateElement) state.originalCreateElement = document.createElement;
27
- if (!state.originalEval) state.originalEval = window.eval;
28
- if (!state.originalFunction) state.originalFunction = window.Function;
29
- window.__dynamicScriptMonitorState = state;
30
-
31
- const observer = new MutationObserver((mutations) => {
32
- mutations.forEach((mutation) => {
33
- mutation.addedNodes.forEach((node) => {
34
- if (node.nodeName === 'SCRIPT') {
35
- const script = node;
36
- const info = {
37
- type: 'dynamic',
38
- src: script.src || '(inline)',
39
- content: script.src ? null : script.textContent,
40
- timestamp: Date.now(),
41
- async: script.async,
42
- defer: script.defer,
43
- };
44
-
45
- dynamicScripts.push(info);
46
- if (dynamicScripts.length > maxRecords) {
47
- dynamicScripts.splice(0, dynamicScripts.length - maxRecords);
48
- }
49
- console.log('[ScriptMonitor] Dynamic script added:', info);
50
- }
51
- });
52
- });
53
- });
54
-
55
- observer.observe(document.documentElement, {
56
- childList: true,
57
- subtree: true,
58
- });
59
- state.observer = observer;
60
-
61
- const originalCreateElement = state.originalCreateElement;
62
- document.createElement = function(tagName) {
63
- const element = originalCreateElement.call(document, tagName);
64
-
65
- if (tagName.toLowerCase() === 'script') {
66
- console.log('[ScriptMonitor] Script element created via createElement');
67
-
68
- const originalSetAttribute = element.setAttribute;
69
- element.setAttribute = function(name, value) {
70
- if (name === 'src') {
71
- console.log('[ScriptMonitor] Script src set to:', value);
72
- }
73
- return originalSetAttribute.call(element, name, value);
74
- };
75
- }
76
-
77
- return element;
78
- };
79
-
80
- const originalEval = state.originalEval;
81
- window.eval = function(code) {
82
- console.log('[ScriptMonitor] eval() called with code:',
83
- typeof code === 'string' ? code.substring(0, 100) + '...' : code);
84
- return originalEval.call(window, code);
85
- };
86
-
87
- const originalFunction = state.originalFunction;
88
- window.Function = function(...args) {
89
- console.log('[ScriptMonitor] Function() constructor called with args:', args);
90
- return originalFunction.apply(this, args);
91
- };
92
-
93
- window.__getDynamicScripts = function() {
94
- return dynamicScripts;
95
- };
96
-
97
- console.log('[ScriptMonitor] Dynamic script monitoring enabled');
98
- })();
12
+ const monitorCode = `
13
+ (function() {
14
+ if (window.__dynamicScriptMonitorInstalled) {
15
+ console.log('[ScriptMonitor] Already installed');
16
+ return;
17
+ }
18
+ window.__dynamicScriptMonitorInstalled = true;
19
+
20
+ const maxRecords = ${coreCtx.MAX_INJECTED_DYNAMIC_SCRIPTS};
21
+ if (!window.__dynamicScripts) {
22
+ window.__dynamicScripts = [];
23
+ }
24
+ const dynamicScripts = window.__dynamicScripts;
25
+ const state = window.__dynamicScriptMonitorState || {};
26
+ if (!state.originalCreateElement) state.originalCreateElement = document.createElement;
27
+ if (!state.originalEval) state.originalEval = window.eval;
28
+ if (!state.originalFunction) state.originalFunction = window.Function;
29
+ window.__dynamicScriptMonitorState = state;
30
+
31
+ const observer = new MutationObserver((mutations) => {
32
+ mutations.forEach((mutation) => {
33
+ mutation.addedNodes.forEach((node) => {
34
+ if (node.nodeName === 'SCRIPT') {
35
+ const script = node;
36
+ const info = {
37
+ type: 'dynamic',
38
+ src: script.src || '(inline)',
39
+ content: script.src ? null : script.textContent,
40
+ timestamp: Date.now(),
41
+ async: script.async,
42
+ defer: script.defer,
43
+ };
44
+
45
+ dynamicScripts.push(info);
46
+ if (dynamicScripts.length > maxRecords) {
47
+ dynamicScripts.splice(0, dynamicScripts.length - maxRecords);
48
+ }
49
+ console.log('[ScriptMonitor] Dynamic script added:', info);
50
+ }
51
+ });
52
+ });
53
+ });
54
+
55
+ observer.observe(document.documentElement, {
56
+ childList: true,
57
+ subtree: true,
58
+ });
59
+ state.observer = observer;
60
+
61
+ const originalCreateElement = state.originalCreateElement;
62
+ document.createElement = function(tagName) {
63
+ const element = originalCreateElement.call(document, tagName);
64
+
65
+ if (tagName.toLowerCase() === 'script') {
66
+ console.log('[ScriptMonitor] Script element created via createElement');
67
+
68
+ const originalSetAttribute = element.setAttribute;
69
+ element.setAttribute = function(name, value) {
70
+ if (name === 'src') {
71
+ console.log('[ScriptMonitor] Script src set to:', value);
72
+ }
73
+ return originalSetAttribute.call(element, name, value);
74
+ };
75
+ }
76
+
77
+ return element;
78
+ };
79
+
80
+ const originalEval = state.originalEval;
81
+ window.eval = function(code) {
82
+ console.log('[ScriptMonitor] eval() called with code:',
83
+ typeof code === 'string' ? code.substring(0, 100) + '...' : code);
84
+ return originalEval.call(window, code);
85
+ };
86
+
87
+ const originalFunction = state.originalFunction;
88
+ window.Function = function(...args) {
89
+ console.log('[ScriptMonitor] Function() constructor called with args:', args);
90
+ return originalFunction.apply(this, args);
91
+ };
92
+
93
+ window.__getDynamicScripts = function() {
94
+ return dynamicScripts;
95
+ };
96
+
97
+ console.log('[ScriptMonitor] Dynamic script monitoring enabled');
98
+ })();
99
99
  `;
100
100
  if (options?.persistent) {
101
101
  await coreCtx.cdpSession.send('Page.addScriptToEvaluateOnNewDocument', {
@@ -117,19 +117,19 @@ export async function clearDynamicScriptBufferCore(ctx) {
117
117
  }
118
118
  try {
119
119
  const result = await coreCtx.cdpSession.send('Runtime.evaluate', {
120
- expression: `
121
- (() => {
122
- const store = Array.isArray(window.__dynamicScripts)
123
- ? window.__dynamicScripts
124
- : (typeof window.__getDynamicScripts === 'function'
125
- ? window.__getDynamicScripts()
126
- : null);
127
- const dynamicScriptsCleared = Array.isArray(store) ? store.length : 0;
128
- if (Array.isArray(store)) {
129
- store.length = 0;
130
- }
131
- return { dynamicScriptsCleared };
132
- })()
120
+ expression: `
121
+ (() => {
122
+ const store = Array.isArray(window.__dynamicScripts)
123
+ ? window.__dynamicScripts
124
+ : (typeof window.__getDynamicScripts === 'function'
125
+ ? window.__getDynamicScripts()
126
+ : null);
127
+ const dynamicScriptsCleared = Array.isArray(store) ? store.length : 0;
128
+ if (Array.isArray(store)) {
129
+ store.length = 0;
130
+ }
131
+ return { dynamicScriptsCleared };
132
+ })()
133
133
  `,
134
134
  returnByValue: true,
135
135
  });
@@ -154,48 +154,48 @@ export async function resetDynamicScriptMonitoringCore(ctx) {
154
154
  }
155
155
  try {
156
156
  const result = await coreCtx.cdpSession.send('Runtime.evaluate', {
157
- expression: `
158
- (() => {
159
- const state = window.__dynamicScriptMonitorState;
160
- let scriptMonitorReset = false;
161
-
162
- try {
163
- if (state && state.observer && typeof state.observer.disconnect === 'function') {
164
- state.observer.disconnect();
165
- state.observer = null;
166
- scriptMonitorReset = true;
167
- }
168
- } catch (_) {}
169
-
170
- try {
171
- if (state && state.originalCreateElement) {
172
- document.createElement = state.originalCreateElement;
173
- scriptMonitorReset = true;
174
- }
175
- } catch (_) {}
176
-
177
- try {
178
- if (state && state.originalEval) {
179
- window.eval = state.originalEval;
180
- scriptMonitorReset = true;
181
- }
182
- } catch (_) {}
183
-
184
- try {
185
- if (state && state.originalFunction) {
186
- window.Function = state.originalFunction;
187
- scriptMonitorReset = true;
188
- }
189
- } catch (_) {}
190
-
191
- if (Array.isArray(window.__dynamicScripts)) {
192
- window.__dynamicScripts.length = 0;
193
- }
194
- delete window.__getDynamicScripts;
195
- window.__dynamicScriptMonitorInstalled = false;
196
-
197
- return { scriptMonitorReset };
198
- })()
157
+ expression: `
158
+ (() => {
159
+ const state = window.__dynamicScriptMonitorState;
160
+ let scriptMonitorReset = false;
161
+
162
+ try {
163
+ if (state && state.observer && typeof state.observer.disconnect === 'function') {
164
+ state.observer.disconnect();
165
+ state.observer = null;
166
+ scriptMonitorReset = true;
167
+ }
168
+ } catch (_) {}
169
+
170
+ try {
171
+ if (state && state.originalCreateElement) {
172
+ document.createElement = state.originalCreateElement;
173
+ scriptMonitorReset = true;
174
+ }
175
+ } catch (_) {}
176
+
177
+ try {
178
+ if (state && state.originalEval) {
179
+ window.eval = state.originalEval;
180
+ scriptMonitorReset = true;
181
+ }
182
+ } catch (_) {}
183
+
184
+ try {
185
+ if (state && state.originalFunction) {
186
+ window.Function = state.originalFunction;
187
+ scriptMonitorReset = true;
188
+ }
189
+ } catch (_) {}
190
+
191
+ if (Array.isArray(window.__dynamicScripts)) {
192
+ window.__dynamicScripts.length = 0;
193
+ }
194
+ delete window.__getDynamicScripts;
195
+ window.__dynamicScriptMonitorInstalled = false;
196
+
197
+ return { scriptMonitorReset };
198
+ })()
199
199
  `,
200
200
  returnByValue: true,
201
201
  });
@@ -236,33 +236,33 @@ export async function injectFunctionTracerCore(ctx, functionName, options) {
236
236
  if (!coreCtx.cdpSession) {
237
237
  throw new PrerequisiteError('CDP session not initialized');
238
238
  }
239
- const tracerCode = `
240
- (function() {
241
- const originalFunc = window.${functionName};
242
- if (typeof originalFunc !== 'function') {
243
- console.error('[Tracer] ${functionName} is not a function');
244
- return;
245
- }
246
-
247
- window.${functionName} = new Proxy(originalFunc, {
248
- apply: function(target, thisArg, args) {
249
- console.log('[Tracer] ${functionName} called with args:', args);
250
- const startTime = performance.now();
251
-
252
- try {
253
- const result = target.apply(thisArg, args);
254
- const endTime = performance.now();
255
- console.log('[Tracer] ${functionName} returned:', result, 'Time:', (endTime - startTime).toFixed(2), 'ms');
256
- return result;
257
- } catch (error) {
258
- console.error('[Tracer] ${functionName} threw error:', error);
259
- throw error;
260
- }
261
- }
262
- });
263
-
264
- console.log('[Tracer] ${functionName} is now being traced');
265
- })();
239
+ const tracerCode = `
240
+ (function() {
241
+ const originalFunc = window.${functionName};
242
+ if (typeof originalFunc !== 'function') {
243
+ console.error('[Tracer] ${functionName} is not a function');
244
+ return;
245
+ }
246
+
247
+ window.${functionName} = new Proxy(originalFunc, {
248
+ apply: function(target, thisArg, args) {
249
+ console.log('[Tracer] ${functionName} called with args:', args);
250
+ const startTime = performance.now();
251
+
252
+ try {
253
+ const result = target.apply(thisArg, args);
254
+ const endTime = performance.now();
255
+ console.log('[Tracer] ${functionName} returned:', result, 'Time:', (endTime - startTime).toFixed(2), 'ms');
256
+ return result;
257
+ } catch (error) {
258
+ console.error('[Tracer] ${functionName} threw error:', error);
259
+ throw error;
260
+ }
261
+ }
262
+ });
263
+
264
+ console.log('[Tracer] ${functionName} is now being traced');
265
+ })();
266
266
  `;
267
267
  if (options?.persistent) {
268
268
  await coreCtx.cdpSession.send('Page.addScriptToEvaluateOnNewDocument', {
@@ -282,31 +282,31 @@ export async function injectPropertyWatcherCore(ctx, objectPath, propertyName, o
282
282
  if (!coreCtx.cdpSession) {
283
283
  throw new PrerequisiteError('CDP session not initialized');
284
284
  }
285
- const watcherCode = `
286
- (function() {
287
- const obj = ${objectPath};
288
- if (!obj) {
289
- console.error('[Watcher] Object not found: ${objectPath}');
290
- return;
291
- }
292
-
293
- let value = obj.${propertyName};
294
-
295
- Object.defineProperty(obj, '${propertyName}', {
296
- get: function() {
297
- console.log('[Watcher] ${objectPath}.${propertyName} accessed, value:', value);
298
- return value;
299
- },
300
- set: function(newValue) {
301
- console.log('[Watcher] ${objectPath}.${propertyName} changed from', value, 'to', newValue);
302
- value = newValue;
303
- },
304
- enumerable: true,
305
- configurable: true
306
- });
307
-
308
- console.log('[Watcher] Property watcher installed for ${objectPath}.${propertyName}');
309
- })();
285
+ const watcherCode = `
286
+ (function() {
287
+ const obj = ${objectPath};
288
+ if (!obj) {
289
+ console.error('[Watcher] Object not found: ${objectPath}');
290
+ return;
291
+ }
292
+
293
+ let value = obj.${propertyName};
294
+
295
+ Object.defineProperty(obj, '${propertyName}', {
296
+ get: function() {
297
+ console.log('[Watcher] ${objectPath}.${propertyName} accessed, value:', value);
298
+ return value;
299
+ },
300
+ set: function(newValue) {
301
+ console.log('[Watcher] ${objectPath}.${propertyName} changed from', value, 'to', newValue);
302
+ value = newValue;
303
+ },
304
+ enumerable: true,
305
+ configurable: true
306
+ });
307
+
308
+ console.log('[Watcher] Property watcher installed for ${objectPath}.${propertyName}');
309
+ })();
310
310
  `;
311
311
  if (options?.persistent) {
312
312
  await coreCtx.cdpSession.send('Page.addScriptToEvaluateOnNewDocument', {
@@ -0,0 +1,46 @@
1
+ import type { CDPSession } from 'rebrowser-puppeteer-core';
2
+ export interface FetchInterceptRule {
3
+ id: string;
4
+ urlPattern: string;
5
+ urlPatternType: 'glob' | 'regex';
6
+ stage: 'Request' | 'Response';
7
+ responseCode: number;
8
+ responseHeaders: Array<{
9
+ name: string;
10
+ value: string;
11
+ }>;
12
+ responseBody: string;
13
+ hitCount: number;
14
+ createdAt: number;
15
+ }
16
+ export interface FetchInterceptRuleInput {
17
+ urlPattern: string;
18
+ urlPatternType?: 'glob' | 'regex';
19
+ stage?: 'Request' | 'Response';
20
+ responseCode?: number;
21
+ responseHeaders?: Record<string, string>;
22
+ responseBody?: string;
23
+ }
24
+ export declare class FetchInterceptor {
25
+ private cdpSession;
26
+ private rules;
27
+ private enabled;
28
+ private eventHandler;
29
+ private compiledPatterns;
30
+ constructor(cdpSession: CDPSession);
31
+ enable(ruleInputs: FetchInterceptRuleInput[]): Promise<FetchInterceptRule[]>;
32
+ disable(): Promise<{
33
+ removedRules: number;
34
+ }>;
35
+ removeRule(ruleId: string): Promise<boolean>;
36
+ listRules(): {
37
+ enabled: boolean;
38
+ rules: FetchInterceptRule[];
39
+ totalHits: number;
40
+ };
41
+ isEnabled(): boolean;
42
+ private createRule;
43
+ private compilePattern;
44
+ private applyRules;
45
+ private handleRequestPaused;
46
+ }
@@ -0,0 +1,191 @@
1
+ import { logger } from '../../utils/logger.js';
2
+ import { randomUUID } from 'node:crypto';
3
+ export class FetchInterceptor {
4
+ cdpSession;
5
+ rules = new Map();
6
+ enabled = false;
7
+ eventHandler = null;
8
+ compiledPatterns = new Map();
9
+ constructor(cdpSession) {
10
+ this.cdpSession = cdpSession;
11
+ }
12
+ async enable(ruleInputs) {
13
+ const newRules = [];
14
+ for (const input of ruleInputs) {
15
+ const rule = this.createRule(input);
16
+ this.rules.set(rule.id, rule);
17
+ this.compiledPatterns.set(rule.id, this.compilePattern(rule));
18
+ newRules.push(rule);
19
+ }
20
+ await this.applyRules();
21
+ if (!this.eventHandler) {
22
+ this.eventHandler = (params) => {
23
+ void this.handleRequestPaused(params);
24
+ };
25
+ this.cdpSession.on('Fetch.requestPaused', this.eventHandler);
26
+ }
27
+ this.enabled = true;
28
+ logger.info(`FetchInterceptor enabled with ${this.rules.size} rule(s)`);
29
+ return newRules;
30
+ }
31
+ async disable() {
32
+ const count = this.rules.size;
33
+ if (this.eventHandler) {
34
+ try {
35
+ this.cdpSession.off('Fetch.requestPaused', this.eventHandler);
36
+ }
37
+ catch {
38
+ }
39
+ this.eventHandler = null;
40
+ }
41
+ try {
42
+ await this.cdpSession.send('Fetch.disable');
43
+ }
44
+ catch (error) {
45
+ logger.warn('Fetch.disable failed:', error);
46
+ }
47
+ this.rules.clear();
48
+ this.compiledPatterns.clear();
49
+ this.enabled = false;
50
+ logger.info(`FetchInterceptor disabled, removed ${count} rule(s)`);
51
+ return { removedRules: count };
52
+ }
53
+ async removeRule(ruleId) {
54
+ const removed = this.rules.delete(ruleId);
55
+ this.compiledPatterns.delete(ruleId);
56
+ if (removed) {
57
+ if (this.rules.size === 0) {
58
+ await this.disable();
59
+ }
60
+ else {
61
+ await this.applyRules();
62
+ }
63
+ }
64
+ return removed;
65
+ }
66
+ listRules() {
67
+ const rules = Array.from(this.rules.values());
68
+ return {
69
+ enabled: this.enabled,
70
+ rules,
71
+ totalHits: rules.reduce((sum, r) => sum + r.hitCount, 0),
72
+ };
73
+ }
74
+ isEnabled() {
75
+ return this.enabled;
76
+ }
77
+ createRule(input) {
78
+ const headers = [];
79
+ if (input.responseHeaders) {
80
+ for (const [name, value] of Object.entries(input.responseHeaders)) {
81
+ headers.push({ name, value });
82
+ }
83
+ }
84
+ return {
85
+ id: randomUUID().slice(0, 8),
86
+ urlPattern: input.urlPattern,
87
+ urlPatternType: input.urlPatternType ?? 'glob',
88
+ stage: input.stage ?? 'Response',
89
+ responseCode: input.responseCode ?? 200,
90
+ responseHeaders: headers,
91
+ responseBody: input.responseBody ?? '',
92
+ hitCount: 0,
93
+ createdAt: Date.now(),
94
+ };
95
+ }
96
+ compilePattern(rule) {
97
+ if (rule.urlPatternType === 'regex') {
98
+ try {
99
+ return new RegExp(rule.urlPattern, 'i');
100
+ }
101
+ catch {
102
+ return new RegExp(rule.urlPattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'i');
103
+ }
104
+ }
105
+ const escaped = rule.urlPattern
106
+ .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
107
+ .replace(/\*\*/g, '⟨GLOBSTAR⟩')
108
+ .replace(/\*/g, '[^/]*')
109
+ .replace(/⟨GLOBSTAR⟩/g, '.*');
110
+ return new RegExp(escaped, 'i');
111
+ }
112
+ async applyRules() {
113
+ const patterns = [];
114
+ for (const rule of this.rules.values()) {
115
+ patterns.push({
116
+ urlPattern: rule.urlPatternType === 'glob' ? rule.urlPattern : '*',
117
+ requestStage: rule.stage,
118
+ });
119
+ }
120
+ if (patterns.length === 0) {
121
+ return;
122
+ }
123
+ try {
124
+ try {
125
+ await this.cdpSession.send('Fetch.disable');
126
+ }
127
+ catch {
128
+ }
129
+ await this.cdpSession.send('Fetch.enable', {
130
+ patterns: patterns.length > 0 ? patterns : [{ urlPattern: '*', requestStage: 'Response' }],
131
+ handleAuthRequests: false,
132
+ });
133
+ }
134
+ catch (error) {
135
+ logger.error('Failed to apply Fetch interception rules:', error);
136
+ throw error;
137
+ }
138
+ }
139
+ async handleRequestPaused(params) {
140
+ const requestUrl = params.request.url;
141
+ for (const [ruleId, rule] of this.rules) {
142
+ const pattern = this.compiledPatterns.get(ruleId);
143
+ if (!pattern)
144
+ continue;
145
+ if (pattern.test(requestUrl)) {
146
+ rule.hitCount++;
147
+ logger.info(`[FetchInterceptor] Rule "${rule.urlPattern}" matched: ${requestUrl}`);
148
+ try {
149
+ const headers = [...rule.responseHeaders];
150
+ if (!headers.some((h) => h.name.toLowerCase() === 'content-type')) {
151
+ const body = rule.responseBody;
152
+ if (body.startsWith('{') || body.startsWith('[')) {
153
+ headers.push({ name: 'Content-Type', value: 'application/json' });
154
+ }
155
+ else {
156
+ headers.push({ name: 'Content-Type', value: 'text/plain' });
157
+ }
158
+ }
159
+ if (!headers.some((h) => h.name.toLowerCase() === 'access-control-allow-origin')) {
160
+ headers.push({ name: 'Access-Control-Allow-Origin', value: '*' });
161
+ }
162
+ await this.cdpSession.send('Fetch.fulfillRequest', {
163
+ requestId: params.requestId,
164
+ responseCode: rule.responseCode,
165
+ responseHeaders: headers,
166
+ body: Buffer.from(rule.responseBody, 'utf-8').toString('base64'),
167
+ });
168
+ return;
169
+ }
170
+ catch (error) {
171
+ logger.error(`[FetchInterceptor] fulfillRequest failed for ${requestUrl}:`, error);
172
+ }
173
+ }
174
+ }
175
+ try {
176
+ if (params.responseStatusCode !== undefined) {
177
+ await this.cdpSession.send('Fetch.continueResponse', {
178
+ requestId: params.requestId,
179
+ });
180
+ }
181
+ else {
182
+ await this.cdpSession.send('Fetch.continueRequest', {
183
+ requestId: params.requestId,
184
+ });
185
+ }
186
+ }
187
+ catch (error) {
188
+ logger.warn(`[FetchInterceptor] continue failed for ${requestUrl}:`, error);
189
+ }
190
+ }
191
+ }