@jshookmcp/jshook 0.3.2 → 0.3.4

package/dist/mojo-ipc-BhwsdVUW.mjs

@@ -1,9 +0,0 @@
-import{n as e}from"./chunk-C_pMuVsO.mjs";import{un as t}from"./constants-BYj8Xek8.mjs";import{a as n,r}from"./parse-args-Bw413PlW.mjs";import{n as i,t as a}from"./capabilities-CyXuKUl1.mjs";import"./manifest-CQH9FhwI.mjs";import{execFile as o,spawn as s}from"node:child_process";function c(){return[{name:`blink.mojom.WidgetHost`,version:1,pendingMessages:0},{name:`content.mojom.FrameHost`,version:2,pendingMessages:0},{name:`network.mojom.URLLoaderFactory`,version:3,pendingMessages:0}]}function l(){try{return e.resolve(`frida`),!0}catch{return!1}}async function u(){return new Promise(e=>{let n=s(`frida`,[`--version`],{timeout:t,windowsHide:!0}),r=``;n.stdout?.on(`data`,e=>{r+=e.toString()}),n.on(`close`,t=>{if(t===0&&r.trim().length>0){e(`frida`);return}e(null)}),n.on(`error`,()=>{e(null)})})}async function d(){let e=process.env.JSHOOK_ENABLE_MOJO_IPC,t=l(),n=await u(),r=t||n!==null;return e===`0`||e===`false`?{available:!1,fridaAvailable:r,fridaCliAvailable:n!==null,reason:`Mojo IPC disabled by JSHOOK_ENABLE_MOJO_IPC=0.`}:{available:r,fridaAvailable:r,fridaCliAvailable:n!==null,reason:r?void 0:`Mojo IPC backend is not connected. Install Frida for real IPC monitoring: https://frida.re/docs/installation/`}}function f(e,t){return!(t.interfaceName&&e.interfaceName!==t.interfaceName||t.messageType&&e.messageType!==t.messageType||typeof t.pid==`number`&&e.sourcePid!==t.pid&&e.targetPid!==t.pid)}function p(){return`
-const messages = [];
-recv('message', () => {});
-rpc.exports = {
-  flush() {
-    return messages;
-  },
-};
-`}var m=class{active=!1;simulationMode=!1;fridaProbeSucceeded=!1;deviceId;messages=[];interfaces=new Map;observedInterfaceNames=new Set;availability={available:!1,fridaAvailable:!1,fridaCliAvailable:!1,reason:`Not yet initialized. Call start() to probe availability.`};constructor(){this.resetInterfaces()}isAvailable(){return this.availability.available}getUnavailableReason(){return this.availability.reason}getAvailabilitySnapshot(){return{...this.availability}}async probeAvailability(){return this.availability=await d(),this.getAvailabilitySnapshot()}isSimulationMode(){return this.simulationMode}didFridaProbeSucceed(){return this.fridaProbeSucceeded}setSimulationMode(e){this.simulationMode=e}isActive(){return this.active}getDeviceId(){return this.deviceId}async start(e){if(this.deviceId=e,this.availability=await d(),this.resetInterfaces(),this.simulationMode=!1,this.fridaProbeSucceeded=!1,!this.availability.available){this.active=!1;return}this.active=!0,this.availability.fridaCliAvailable?await this.captureWithFrida(e):this.simulationMode=!0}async stop(){this.active=!1,this.deviceId=void 0,this.fridaProbeSucceeded=!1,this.resetInterfaces()}async captureMessages(e={}){if(!this.active)return[];let t=[],n=[];for(let r of this.messages)f(r,e)?t.push({...r}):n.push(r);return this.messages.length=0,this.messages.push(...n),this.recomputePendingCounts(),t}async listInterfaces(){return[...this.interfaces.values()].map(e=>({name:e.name,version:e.version,pendingMessages:e.pendingMessages})).toSorted((e,t)=>e.name.localeCompare(t.name))}hasObservedInterfaces(){return this.observedInterfaceNames.size>0}getObservedInterfaceCount(){return this.observedInterfaceNames.size}getInterfaceCatalogSource(){return this.observedInterfaceNames.size===0?`seeded-defaults`:this.observedInterfaceNames.size>=this.interfaces.size?`observed`:`mixed`}async getMessages(e){if(!this.active)return{messages:[],totalAvailable:0,filtered:!1,simulation:this.simulationMode};let t={};e?.interfaceName&&(t.interfaceName=e.interfaceName);let n=await this.captureMessages(t),r=e?.limit??100;return{messages:n.slice(0,r),totalAvailable:n.length,filtered:!!e?.interfaceName,simulation:this.simulationMode}}recordMessage(e,t=1){if(!this.active)return;this.messages.push({...e}),this.observedInterfaceNames.add(e.interfaceName);let n=this.interfaces.get(e.interfaceName);if(n){n.pendingMessages+=1;return}this.interfaces.set(e.interfaceName,{name:e.interfaceName,version:t,pendingMessages:1})}async captureWithFrida(e){let n=e??`chrome`,r=p();await new Promise((e,i)=>{o(`frida`,[`-q`,`-n`,n,`-l`,`-`,`--runtime=v8`],{timeout:t,windowsHide:!0},t=>{if(t){i(t);return}e()}).stdin?.end(r)}).then(()=>{this.fridaProbeSucceeded=!0}).catch(()=>{this.fridaProbeSucceeded=!1}),this.simulationMode=!0}recomputePendingCounts(){this.resetPendingCounts();for(let e of this.messages){this.observedInterfaceNames.add(e.interfaceName);let t=this.interfaces.get(e.interfaceName);t?t.pendingMessages+=1:this.interfaces.set(e.interfaceName,{name:e.interfaceName,version:1,pendingMessages:1})}}resetPendingCounts(){for(let e of this.interfaces.values())e.pendingMessages=0}resetInterfaces(){this.messages.length=0,this.interfaces.clear(),this.observedInterfaceNames.clear();for(let e of c())this.interfaces.set(e.name,{...e})}};function h(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function g(e){return h(e)?typeof e.handle==`number`:!1}function _(e){let t=e.replace(/\s+/g,``);return t.length%2==0?t.toLowerCase():`0${t.toLowerCase()}`}var v=class{decodePayload(e,t){let n=this.cleanHex(e),r=Buffer.from(n,`hex`),i=this.readUInt8(r,0),a=this.readUInt8(r,1),o=this.readUInt8(r,2),s=this.readUInt8(r,3),c=this.readUInt16LE(r,4),l={},u=[],d=6,f=0;for(let e=0;e<s;e+=1){if(d>=r.length){u.push(`payload ended before all fields were decoded`);break}let t=this.readUInt8(r,d);d+=1;let n=`field${e}`;if(t===1){if(!this.hasBytes(r,d,1)){u.push(`${n} truncated`);break}l[n]=this.readUInt8(r,d)!==0,d+=1;continue}if(t===6){if(!this.hasBytes(r,d,4)){u.push(`${n} truncated`);break}l[n]=r.readInt32LE(d),d+=4;continue}if(t===8){if(!this.hasBytes(r,d,4)){u.push(`${n} truncated`);break}l[n]=r.readUInt32LE(d),d+=4;continue}if(t===12){if(!this.hasBytes(r,d,2)){u.push(`${n} length prefix truncated`);break}let e=this.readUInt16LE(r,d);if(d+=2,!this.hasBytes(r,d,e)){u.push(`${n} string data truncated`);break}l[n]=r.subarray(d,d+e).toString(`utf8`),d+=e;continue}if(t===16){if(!this.hasBytes(r,d,4)){u.push(`${n} handle truncated`);break}l[n]={handle:r.readUInt32LE(d)},f+=1,d+=4;continue}u.push(`unknown field type 0x${t.toString(16).padStart(2,`0`)}`);break}let p=u.length>0?u.join(`; `):this.buildSummary(t,Object.keys(l).length,s,f);return{header:{version:i,flags:a,messageType:o,numFields:s,handles:c},fields:l,handles:f,raw:n,_raw_summary:p}}encodeMessage(e,t,n){let r=[],i=0;for(let e of n){if(typeof e==`boolean`){r.push(Buffer.from([1,+!!e]));continue}if(typeof e==`number`&&Number.isInteger(e)&&e>=0){let t=Buffer.alloc(5);t.writeUInt8(8,0),t.writeUInt32LE(e,1),r.push(t);continue}if(typeof e==`number`&&Number.isInteger(e)){let t=Buffer.alloc(5);t.writeUInt8(6,0),t.writeInt32LE(e,1),r.push(t);continue}if(g(e)){let t=Buffer.alloc(5);t.writeUInt8(16,0),t.writeUInt32LE(e.handle,1),r.push(t),i+=1;continue}let t=typeof e==`string`?e:JSON.stringify(e),n=Buffer.from(t,`utf8`),a=Buffer.alloc(3);a.writeUInt8(12,0),a.writeUInt16LE(n.length,1),r.push(a,n)}let a=this.resolveMessageType(e,t),o=Math.min(n.length,255),s=Buffer.alloc(6);return s.writeUInt8(1,0),s.writeUInt8(0,1),s.writeUInt8(a,2),s.writeUInt8(o,3),s.writeUInt16LE(i,4),Buffer.concat([s,...r]).toString(`hex`)}cleanHex(e){return _(e)}resolveMessageType(e,t){if(/^[0-9]+$/.test(t))return Number.parseInt(t,10)&255;if(/^0x[0-9a-f]+$/i.test(t))return Number.parseInt(t.slice(2),16)&255;let n=0,r=`${e}:${t}`;for(let e of r)n=n*31+e.charCodeAt(0)&255;return n}buildSummary(e,t,n,r){return`${e?`${e}: `:``}decoded ${t}/${n} fields, ${r} handle(s)`}readUInt8(e,t){return this.hasBytes(e,t,1)?e.readUInt8(t):0}readUInt16LE(e,t){return this.hasBytes(e,t,2)?e.readUInt16LE(t):0}hasBytes(e,t,n){return t>=0&&n>=0&&t+n<=e.length}};function y(e){return e.includes(`JSHOOK_ENABLE_MOJO_IPC`)?`Unset JSHOOK_ENABLE_MOJO_IPC or set it to 1, then retry.`:`Install Frida and ensure the Chromium target is running.`}function b(e,t){return{...a(t,`mojo_ipc_monitoring`,e,y(e)),error:e}}function x(e){let t=e;return typeof t.didFridaProbeSucceed==`function`?t.didFridaProbeSucceed():!1}var S=class{monitor;decoder;eventBus;constructor(e,t,n){this.monitor=e,this.decoder=t,this.eventBus=n}async handleMojoMonitorDispatch(e){return String(e.action??``)===`stop`?this.handleMojoMonitorStop():this.handleMojoMonitorStart(e)}async handleMojoIpcCapabilities(){let e=this.getMonitor(),t=x(e),n=typeof e.probeAvailability==`function`?await e.probeAvailability():{available:e.isAvailable(),reason:e.getUnavailableReason(),fridaAvailable:e.isAvailable(),fridaCliAvailable:!1};return i(`mojo_ipc_capabilities`,[{capability:`mojo_ipc_monitoring`,status:n.available?`available`:`unavailable`,reason:n.reason,fix:n.available?void 0:y(n.reason??``),details:{tools:[`mojo_monitor`,`mojo_list_interfaces`,`mojo_messages_get`],fridaAvailable:n.fridaAvailable,fridaCliAvailable:n.fridaCliAvailable,fridaProbeSucceeded:t,active:e.isActive(),simulationMode:e.isSimulationMode(),interfaceCatalogSource:e.getInterfaceCatalogSource(),observedInterfaceCount:e.getObservedInterfaceCount(),liveCaptureImplemented:!1}},{capability:`mojo_live_capture`,status:`unavailable`,reason:`Current Mojo IPC backend only exposes a seeded interface catalog and simulated capture. Live Chromium Mojo hooks are not implemented in this build.`,fix:`No user-side fix is available in this build. Treat mojo_monitor/mojo_list_interfaces/mojo_messages_get as simulation-only until real Frida hooks are implemented.`,details:{tools:[`mojo_monitor`,`mojo_list_interfaces`,`mojo_messages_get`],fridaAvailable:n.fridaAvailable,fridaCliAvailable:n.fridaCliAvailable,fridaProbeSucceeded:t,active:e.isActive(),simulationMode:e.isSimulationMode(),interfaceCatalogSource:e.getInterfaceCatalogSource(),observedInterfaceCount:e.getObservedInterfaceCount(),fallbackMode:n.available?`simulation`:`none`,liveCaptureImplemented:!1}},{capability:`mojo_payload_decode`,status:`available`,details:{tools:[`mojo_decode_message`]}}])}async handleMojoMonitorStart(e){let t=this.getMonitor(),r=n(e,`deviceId`);if(await t.start(r),!t.isAvailable())return b(t.getUnavailableReason()??`Mojo IPC monitoring is not available`,`mojo_monitor`);let i={success:!0,available:!0,started:t.isActive(),deviceId:t.getDeviceId()??null,simulation:t.isSimulationMode(),interfaceCatalogSource:t.getInterfaceCatalogSource(),observedInterfaceCount:t.getObservedInterfaceCount()};return t.isSimulationMode()&&(i.warningMessage=`Mojo IPC monitor is running in simulation mode. Real Frida-backed message capture is not active.`),i}async handleMojoMonitorStop(){let e=this.getMonitor();return e.isAvailable()?(await e.stop(),{success:!0,available:!0,started:!1,simulation:e.isSimulationMode()}):b(e.getUnavailableReason()??`Mojo IPC monitoring is not available`,`mojo_monitor`)}async handleMojoDecodeMessage(e){let t=n(e,`hexPayload`,``);return t.length===0?{success:!1,error:`hexPayload is required`}:{success:!0,decoded:this.getDecoder().decodePayload(t)}}async handleMojoListInterfaces(){let e=this.getMonitor();if(!e.isAvailable())return{...b(e.getUnavailableReason()??`Mojo IPC monitoring is not available`,`mojo_list_interfaces`),interfaces:[]};let t={success:!0,available:!0,active:e.isActive(),interfaces:await e.listInterfaces(),simulation:e.isSimulationMode(),interfaceCatalogSource:e.getInterfaceCatalogSource(),observedInterfaceCount:e.getObservedInterfaceCount()};return e.getInterfaceCatalogSource()===`seeded-defaults`?t.warningMessage=`Interface list currently comes from the seeded default catalog; no live observed Mojo interfaces have been captured yet.`:e.isSimulationMode()&&(t.warningMessage=`Mojo IPC monitor is running in simulation mode. Interface counts may not reflect live traffic.`),t}async handleMojoMessagesGet(e){let t=this.getMonitor();if(!t.isAvailable())return{...b(t.getUnavailableReason()??`Mojo IPC monitoring is not available`,`mojo_messages_get`),messages:[],totalAvailable:0,filtered:!1,simulation:!0};let i=r(e,`limit`),a=n(e,`interface`),o=await t.getMessages({limit:i===void 0?100:Math.min(i,1e4),interfaceName:a}),s={success:!0,available:!0,active:t.isActive(),messages:o.messages,totalAvailable:o.totalAvailable,filtered:o.filtered,simulation:o.simulation,interfaceCatalogSource:t.getInterfaceCatalogSource(),observedInterfaceCount:t.getObservedInterfaceCount()};return o.messages&&Array.isArray(o.messages)&&o.messages.length>0&&this.eventBus?.emit(`mojo:message_captured`,{messageCount:o.messages.length,timestamp:new Date().toISOString()}),t.isSimulationMode()&&(s.warningMessage=`Mojo IPC is operating in simulation mode. Messages are not captured from real Frida hooks. Install Frida for live IPC monitoring.`),s}getMonitor(){return this.monitor||=new m,this.monitor}getDecoder(){return this.decoder||=new v,this.decoder}};export{S as MojoIPCHandlers};