@lensmcp/bridge 1.21.3 → 1.21.4

package/lib/env-sink.js

@@ -1,3 +1,3 @@
-"use strict";var y=Object.defineProperty;var f=(n,t)=>y(n,"name",{value:t,configurable:!0});var k=Object.defineProperty,c=f((n,t)=>k(n,"name",{value:t,configurable:!0}),"i");import{connect as _}from"node:net";import{createSocket as M}from"node:dgram";import{appendFileSync as b,renameSync as S,statSync as A,unlinkSync as C}from"node:fs";const g=(()=>{const n=Number(process.env.LENSMCP_EVENT_MAX_BYTES);return Number.isFinite(n)&&n>0?n:50*1024*1024})(),E=(()=>{const n=Number(process.env.LENSMCP_EVENT_MAX_FILES);return Number.isFinite(n)&&n>=1&&n<=20?Math.floor(n):5})(),L=1024*1024;let p=0;function d(n,t){if(p+=t,!(p<L)){p=0;try{if(A(n).size<=g)return}catch{return}try{C(`${n}.${E}`)}catch{}for(let e=E-1;e>=1;e--)try{S(`${n}.${e}`,`${n}.${e+1}`)}catch{}try{S(n,`${n}.1`)}catch{}}}f(d,"C"),c(d,"rotateIfLarge");const a=(()=>{const n=process.env.LENSMCP_EVENT_MAX_EPS;if(n==="off")return 1/0;const t=Number(n);return n!==void 0&&n!==""&&Number.isFinite(t)?t<=0?1/0:t:5})(),h=Math.max(30,a===1/0?0:a*4),l=new Map;function v(n){if(a===1/0)return 0;const t=Date.now();let e=l.get(n);if(!e){if(l.size>=2048){for(const[r,s]of l)t-s.lastSeenAt>6e4&&l.delete(r);l.size>=2048&&l.clear()}e={tokens:h,lastRefillAt:t,suppressed:0,lastSeenAt:t},l.set(n,e)}if(e.lastSeenAt=t,e.tokens=Math.min(h,e.tokens+(t-e.lastRefillAt)/1e3*a),e.lastRefillAt=t,e.tokens>=1){e.tokens-=1;const r=e.suppressed;return e.suppressed=0,r}return e.suppressed+=1,-1}f(v,"T"),c(v,"floodAdmit");let i;export function resolveEnvSink(){if(i!==void 0)return i;const n=process.env.LENSMCP_EVENT_FILE;if(n)return i=c(r=>{try{const s=v(r.fingerprint);if(s<0)return;const u=JSON.stringify(s>0?{...r,raw:{...r.raw??{},floodSuppressed:s}}:r)+`
-`;d(n,u.length),b(n,u)}catch{}},"cachedEnvSink"),i;const t=process.env.LENSMCP_UDS;if(t)return i=udsEnvSink(t),i;const e=process.env.LENSMCP_IPC_SOCKET;if(e){const[r,s]=e.split(":"),u=Number(s);if(r&&Number.isFinite(u)){const o=M("udp4");return o.unref(),i=c(N=>{try{const m=Buffer.from(JSON.stringify(N));o.send(m,u,r,()=>{})}catch{}},"cachedEnvSink"),i}}return i=null,null}f(resolveEnvSink,"resolveEnvSink"),c(resolveEnvSink,"resolveEnvSink");export function resetEnvSinkCache(){i=void 0}f(resetEnvSinkCache,"resetEnvSinkCache"),c(resetEnvSinkCache,"resetEnvSinkCache");export function udsEnvSink(n){const t=[];let e=null,r=!1;const s=c(()=>{if(!(!e||!e.writable))for(;t.length>0;)e.write(t.shift())},"flush"),u=c(()=>{if(r||e)return;r=!0;const o=_(n);o.on("connect",()=>{r=!1,e=o,s()}),o.on("drain",s),o.on("error",()=>{r=!1,e=null}),o.on("close",()=>{e=null}),o.unref()},"open");return u(),o=>{for(t.push(JSON.stringify(o)+`
-`);t.length>1e4;)t.shift();if(e&&e.writable){s();return}if(e){try{e.destroy()}catch{}e=null}u()}}f(udsEnvSink,"udsEnvSink"),c(udsEnvSink,"udsEnvSink");
+"use strict";var y=Object.defineProperty;var f=(e,n)=>y(e,"name",{value:n,configurable:!0});var b=Object.defineProperty,l=f((e,n)=>b(e,"name",{value:n,configurable:!0}),"f"),_=Object.defineProperty,c=l((e,n)=>_(e,"name",{value:n,configurable:!0}),"i");import{connect as M}from"node:net";import{createSocket as C}from"node:dgram";import{appendFileSync as g,renameSync as d,statSync as A,unlinkSync as L}from"node:fs";const P=(()=>{const e=Number(process.env.LENSMCP_EVENT_MAX_BYTES);return Number.isFinite(e)&&e>0?e:50*1024*1024})(),h=(()=>{const e=Number(process.env.LENSMCP_EVENT_MAX_FILES);return Number.isFinite(e)&&e>=1&&e<=20?Math.floor(e):5})(),w=1024*1024;let p=0;function E(e,n){if(p+=n,!(p<w)){p=0;try{if(A(e).size<=P)return}catch{return}try{L(`${e}.${h}`)}catch{}for(let t=h-1;t>=1;t--)try{d(`${e}.${t}`,`${e}.${t+1}`)}catch{}try{d(e,`${e}.1`)}catch{}}}f(E,"d"),l(E,"C"),c(E,"rotateIfLarge");const S=(()=>{const e=process.env.LENSMCP_EVENT_MAX_EPS;if(e==="off")return 1/0;const n=Number(e);return e!==void 0&&e!==""&&Number.isFinite(n)?n<=0?1/0:n:5})(),m=Math.max(30,S===1/0?0:S*4),a=new Map;function v(e){if(S===1/0)return 0;const n=Date.now();let t=a.get(e);if(!t){if(a.size>=2048){for(const[r,s]of a)n-s.lastSeenAt>6e4&&a.delete(r);a.size>=2048&&a.clear()}t={tokens:m,lastRefillAt:n,suppressed:0,lastSeenAt:n},a.set(e,t)}if(t.lastSeenAt=n,t.tokens=Math.min(m,t.tokens+(n-t.lastRefillAt)/1e3*S),t.lastRefillAt=n,t.tokens>=1){t.tokens-=1;const r=t.suppressed;return t.suppressed=0,r}return t.suppressed+=1,-1}f(v,"v"),l(v,"T"),c(v,"floodAdmit");let o;export function resolveEnvSink(){if(o!==void 0)return o;const e=process.env.LENSMCP_EVENT_FILE;if(e)return o=c(r=>{try{const s=v(r.fingerprint);if(s<0)return;const u=JSON.stringify(s>0?{...r,raw:{...r.raw??{},floodSuppressed:s}}:r)+`
+`;E(e,u.length),g(e,u)}catch{}},"cachedEnvSink"),o;const n=process.env.LENSMCP_UDS;if(n)return o=udsEnvSink(n),o;const t=process.env.LENSMCP_IPC_SOCKET;if(t){const[r,s]=t.split(":"),u=Number(s);if(r&&Number.isFinite(u)){const i=C("udp4");return i.unref(),o=c(N=>{try{const k=Buffer.from(JSON.stringify(N));i.send(k,u,r,()=>{})}catch{}},"cachedEnvSink"),o}}return o=null,null}f(resolveEnvSink,"resolveEnvSink"),l(resolveEnvSink,"resolveEnvSink"),c(resolveEnvSink,"resolveEnvSink");export function resetEnvSinkCache(){o=void 0}f(resetEnvSinkCache,"resetEnvSinkCache"),l(resetEnvSinkCache,"resetEnvSinkCache"),c(resetEnvSinkCache,"resetEnvSinkCache");export function udsEnvSink(e){const n=[];let t=null,r=!1;const s=c(()=>{if(!(!t||!t.writable))for(;n.length>0;)t.write(n.shift())},"flush"),u=c(()=>{if(r||t)return;r=!0;const i=M(e);i.on("connect",()=>{r=!1,t=i,s()}),i.on("drain",s),i.on("error",()=>{r=!1,t=null}),i.on("close",()=>{t=null}),i.unref()},"open");return u(),i=>{for(n.push(JSON.stringify(i)+`
+`);n.length>1e4;)n.shift();if(t&&t.writable){s();return}if(t){try{t.destroy()}catch{}t=null}u()}}f(udsEnvSink,"udsEnvSink"),l(udsEnvSink,"udsEnvSink"),c(udsEnvSink,"udsEnvSink");

package/lib/event-mappers.js

@@ -1,3 +1,3 @@
-"use strict";var I=Object.defineProperty;var c=(e,n)=>I(e,"name",{value:n,configurable:!0});var h=Object.defineProperty,l=c((e,n)=>h(e,"name",{value:n,configurable:!0}),"s");import{fingerprint as o,ulid as a}from"@lensmcp/core";import{redactDeep as g,redactText as $,redactUrl as d,safeText as u,safeTitle as m}from"./redact.js";const x="pending";export function envelopeToEvent(e,n=x){const s=e.tabId?{tabId:e.tabId}:{};switch(e.kind){case"error":{const r=!e.stack&&!e.source&&(!e.message||e.message==="Script error."),i=e.name&&e.name!=="Error"?`${e.name}: `:"",t=r?"Uncaught cross-origin script error (no detail available \u2014 add crossorigin to the script tag)":e.message?`${i}${e.message}`:`Uncaught ${e.name??"error"}`;return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:n,...s},fingerprint:o({kind:"runtime",identity:`error:${v(e.stack)}`,file:e.source,detail:e.message??e.name}),title:m(t),message:u(e.stack??e.message),location:e.source?{file:d(e.source),line:e.lineno,column:e.colno}:void 0,raw:{...e,...e.message?{message:$(e.message)}:{},...e.stack?{stack:u(e.stack)}:{},...e.source?{source:d(e.source)}:{}}}}case"resource-error":{const r=e.url?d(e.url):void 0;return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:n,...s},fingerprint:o({kind:"runtime",identity:`resource-error:${e.tagName}:${p(e.url??"")}`}),title:m(`Failed to load <${e.tagName}>${r?` ${r}`:""}`),...r?{relatedUrls:[r]}:{},raw:{...e,...r?{url:r}:{}}}}case"unhandledrejection":{const r=e.name&&e.name!=="Error"?`${e.name}: `:"",i=e.reason.split(`
-`)[0]??e.reason;return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:n,...s},fingerprint:o({kind:"runtime",identity:`unhandledrejection:${e.reason.slice(0,80)}`}),title:m(`Unhandled promise rejection: ${r}${i}`),message:u(e.stack??e.reason),raw:{...e,reason:$(e.reason),...e.stack?{stack:u(e.stack)}:{}}}}case"console":{const r=e.level==="error"?"error":e.level==="warn"?"warning":"info",i=g(e.args),t=i.map(w).join(" ");return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:r,context:{sessionId:n,...s},fingerprint:o({kind:"runtime",identity:`console:${e.level}:${t.slice(0,80)}`}),title:`console.${e.level}`,message:u(t),raw:{...e,args:i}}}case"fetch":{const r=e.error!==void 0||e.status!==void 0&&e.status>=400,i=d(e.url),t=e.status!==void 0?` \u2192 ${e.status}${e.statusText?` ${e.statusText}`:""}`:"";return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"network",severity:r?"error":"info",context:{sessionId:n,...s},fingerprint:o({kind:"network",identity:`${e.method}:${p(e.url)}:${e.status??"err"}`}),title:m(`${e.method} ${i}${t}`),message:u(e.error),relatedUrls:[i],raw:{...e,url:i}}}case"route":return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:n,url:e.url,...s},fingerprint:o({kind:"runtime",identity:`route:${e.url}`}),title:`Route \u2192 ${e.url}`,raw:e};case"ready":return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:n,url:e.url,...s},fingerprint:o({kind:"runtime",identity:"client-ready"}),title:"Client runtime ready",message:e.userAgent,raw:e};case"gone":return{id:a(),sessionId:n,timestamp:e.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:n,...s},fingerprint:o({kind:"runtime",identity:"client-gone"}),title:"Client runtime gone",raw:e};case"publish":{const r=k(e.category,e.raw),i=r&&r.status!==void 0&&r.status>=400?"error":e.severity??"info",t=l(y=>r&&r.url!==r.redactedUrl?y.split(r.url).join(r.redactedUrl):y,"scrub"),f=t(e.title);return{id:a(),sessionId:n,timestamp:e.at,source:e.source,category:e.category,severity:i,context:{sessionId:n,...s,...e.context??{}},fingerprint:e.fingerprint?t(e.fingerprint):o({kind:"publish",identity:f}),title:m(f),message:u(e.message),...r?{relatedUrls:[r.redactedUrl]}:{},raw:r?{...g(e.raw),url:r.redactedUrl}:g(e.raw)}}}}c(envelopeToEvent,"envelopeToEvent"),l(envelopeToEvent,"envelopeToEvent");function k(e,n){if(e!=="network"||!n||typeof n!="object")return;const s=n;if(!(typeof s.url!="string"||s.url.length===0))return{url:s.url,redactedUrl:d(s.url),...typeof s.status=="number"?{status:s.status}:{}}}c(k,"w"),l(k,"networkDetails");function v(e){if(!e)return"unknown";const n=e.split(`
-`).slice(0,2);for(const s of n){const r=s.match(/at\s+(\S+)/);if(r&&r[1])return r[1]}return"unknown"}c(v,"h"),l(v,"normaliseStackTopFrame");function p(e){try{return`${new URL(e,"http://x").pathname}`}catch{return e}}c(p,"y"),l(p,"normaliseUrl");function w(e){if(typeof e=="string")return e;try{return JSON.stringify(e)}catch{return String(e)}}c(w,"x"),l(w,"stringify");
+"use strict";var I=Object.defineProperty;var c=(t,r)=>I(t,"name",{value:r,configurable:!0});var x=Object.defineProperty,m=c((t,r)=>x(t,"name",{value:r,configurable:!0}),"l"),b=Object.defineProperty,g=m((t,r)=>b(t,"name",{value:r,configurable:!0}),"l");import{fingerprint as a,ulid as o}from"@lensmcp/core";import{redactDeep as $,redactText as d,redactUrl as p,safeText as u,safeTitle as l}from"./redact.js";const U="pending";export function envelopeToEvent(t,r=U){const s=t.tabId?{tabId:t.tabId}:{};switch(t.kind){case"error":{const e=!t.stack&&!t.source&&(!t.message||t.message==="Script error."),i=t.name&&t.name!=="Error"?`${t.name}: `:"",n=e?"Uncaught cross-origin script error (no detail available \u2014 add crossorigin to the script tag)":t.message?`${i}${t.message}`:`Uncaught ${t.name??"error"}`;return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:r,...s},fingerprint:a({kind:"runtime",identity:`error:${h(t.stack)}`,file:t.source,detail:t.message??t.name}),title:l(n),message:u(t.stack??t.message),location:t.source?{file:p(t.source),line:t.lineno,column:t.colno}:void 0,raw:{...t,...t.message?{message:d(t.message)}:{},...t.stack?{stack:u(t.stack)}:{},...t.source?{source:p(t.source)}:{}}}}case"resource-error":{const e=t.url?p(t.url):void 0;return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:r,...s},fingerprint:a({kind:"runtime",identity:`resource-error:${t.tagName}:${v(t.url??"")}`}),title:l(`Failed to load <${t.tagName}>${e?` ${e}`:""}`),...e?{relatedUrls:[e]}:{},raw:{...t,...e?{url:e}:{}}}}case"unhandledrejection":{const e=t.name&&t.name!=="Error"?`${t.name}: `:"",i=t.reason.split(`
+`)[0]??t.reason;return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"error",context:{sessionId:r,...s},fingerprint:a({kind:"runtime",identity:`unhandledrejection:${t.reason.slice(0,80)}`}),title:l(`Unhandled promise rejection: ${e}${i}`),message:u(t.stack??t.reason),raw:{...t,reason:d(t.reason),...t.stack?{stack:u(t.stack)}:{}}}}case"console":{const e=t.level==="error"?"error":t.level==="warn"?"warning":"info",i=$(t.args),n=i.map(w).join(" ");return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:e,context:{sessionId:r,...s},fingerprint:a({kind:"runtime",identity:`console:${t.level}:${n.slice(0,80)}`}),title:`console.${t.level}`,message:u(n),raw:{...t,args:i}}}case"fetch":{const e=t.error!==void 0||t.status!==void 0&&t.status>=400,i=p(t.url),n=t.status!==void 0?` \u2192 ${t.status}${t.statusText?` ${t.statusText}`:""}`:"";return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"network",severity:e?"error":"info",context:{sessionId:r,...s},fingerprint:a({kind:"network",identity:`${t.method}:${v(t.url)}:${t.status??"err"}`}),title:l(`${t.method} ${i}${n}`),message:u(t.error),relatedUrls:[i],raw:{...t,url:i}}}case"route":return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:r,url:t.url,...s},fingerprint:a({kind:"runtime",identity:`route:${t.url}`}),title:`Route \u2192 ${t.url}`,raw:t};case"ready":return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:r,url:t.url,...s},fingerprint:a({kind:"runtime",identity:"client-ready"}),title:"Client runtime ready",message:t.reloadCause?`${t.userAgent} \u2014 after a Vite full reload${t.reloadCause.triggeredBy?` triggered by ${u(d(t.reloadCause.triggeredBy))}`:""}`:t.userAgent,raw:t};case"hmr":{const e=t.triggeredBy?d(t.triggeredBy):void 0,i=t.path?d(t.path):void 0,n=t.event==="full-reload"?`full-reload:${e??i??"?"}`:t.event==="invalidate"?`invalidate:${i??"?"}`:t.event,f=t.event==="full-reload"?`Vite full reload${e?` \u2014 ${l(e)} could not hot-update`:i?` \u2014 ${l(i)}`:""}`:t.event==="update"?`Vite HMR update (${t.count??t.updates?.length??0} module${(t.count??t.updates?.length??0)===1?"":"s"})`:t.event==="invalidate"?`Vite HMR invalidate \u2014 ${l(i??"?")}`:t.event==="ws-disconnect"?"Vite HMR socket lost \u2014 the page will poll and reload":"Vite HMR socket connected";return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"build",severity:t.event==="full-reload"||t.event==="ws-disconnect"?"warning":"info",context:{sessionId:r,...s},fingerprint:a({kind:"hmr",identity:n}),title:f,...t.message?{message:u(d(t.message))}:{},...e||i?{location:{file:e??i??""}}:{},...t.updates?.length?{relatedFiles:t.updates.map(y=>d(y))}:{},raw:{...t,...e?{triggeredBy:e}:{},...i?{path:i}:{}}}}case"gone":return{id:o(),sessionId:r,timestamp:t.at,source:"client-runtime",category:"runtime",severity:"info",context:{sessionId:r,...s},fingerprint:a({kind:"runtime",identity:"client-gone"}),title:"Client runtime gone",raw:t};case"publish":{const e=k(t.category,t.raw),i=e&&e.status!==void 0&&e.status>=400?"error":t.severity??"info",n=g(y=>e&&e.url!==e.redactedUrl?y.split(e.url).join(e.redactedUrl):y,"scrub"),f=n(t.title);return{id:o(),sessionId:r,timestamp:t.at,source:t.source,category:t.category,severity:i,context:{sessionId:r,...s,...t.context??{}},fingerprint:t.fingerprint?n(t.fingerprint):a({kind:"publish",identity:f}),title:l(f),message:u(t.message),...e?{relatedUrls:[e.redactedUrl]}:{},raw:e?{...$(t.raw),url:e.redactedUrl}:$(t.raw)}}}}c(envelopeToEvent,"envelopeToEvent"),m(envelopeToEvent,"envelopeToEvent"),g(envelopeToEvent,"envelopeToEvent");function k(t,r){if(t!=="network"||!r||typeof r!="object")return;const s=r;if(!(typeof s.url!="string"||s.url.length===0))return{url:s.url,redactedUrl:p(s.url),...typeof s.status=="number"?{status:s.status}:{}}}c(k,"$"),m(k,"h"),g(k,"networkDetails");function h(t){if(!t)return"unknown";const r=t.split(`
+`).slice(0,2);for(const s of r){const e=s.match(/at\s+(\S+)/);if(e&&e[1])return e[1]}return"unknown"}c(h,"k"),m(h,"w"),g(h,"normaliseStackTopFrame");function v(t){try{return`${new URL(t,"http://x").pathname}`}catch{return t}}c(v,"v"),m(v,"y"),g(v,"normaliseUrl");function w(t){if(typeof t=="string")return t;try{return JSON.stringify(t)}catch{return String(t)}}c(w,"h"),m(w,"x"),g(w,"stringify");

package/lib/server.js

@@ -1 +1 @@
-"use strict";var b=Object.defineProperty;var s=(r,e)=>b(r,"name",{value:e,configurable:!0});var v=Object.defineProperty,i=s((r,e)=>v(r,"name",{value:e,configurable:!0}),"i");import{createServer as m}from"node:net";import{WebSocketServer as g}from"ws";import{DEFAULT_WS_HOST as y,DEFAULT_WS_PORT as S}from"./constants.js";import{resolveEnvSink as h}from"./env-sink.js";import{envelopeToEvent as u}from"./event-mappers.js";export function makePublisher(r){let e;return t=>{if(r.bus){r.bus.publish(t);return}if(r.sink){r.sink(t);return}if(e===void 0&&(e=h()),e){e(t);return}(t.severity==="error"||t.severity==="fatal")&&console.debug(`[lensmcp-bridge] ${t.severity}: ${t.title}`)}}s(makePublisher,"makePublisher"),i(makePublisher,"makePublisher");export function handleClientEnvelope(r,e,t){let o;try{o=JSON.parse(r)}catch{return}if(!(!o||typeof o!="object"||!("kind"in o))){if(o.kind==="batch"){if(!Array.isArray(o.events))return;for(const n of o.events)!n||typeof n!="object"||!("kind"in n)||n.kind!=="batch"&&e(u(n,t));return}e(u(o,t))}}s(handleClientEnvelope,"handleClientEnvelope"),i(handleClientEnvelope,"handleClientEnvelope");export function readTabId(r){try{const e=JSON.parse(r);return typeof e?.tabId=="string"&&e.tabId?e.tabId:void 0}catch{return}}s(readTabId,"readTabId"),i(readTabId,"readTabId");export async function createBridgeServer(r={}){const e=r.host??y,t=r.port??S,o=t===0?await findFreePort():t,n=makePublisher(r),a=new g({host:e,port:o});return a.on("connection",c=>{let f;c.on("message",d=>{const l=d.toString();f??=readTabId(l),handleClientEnvelope(l,n,r.sessionId)}),c.on("close",()=>{f&&handleClientEnvelope(JSON.stringify({kind:"gone",at:Date.now(),tabId:f}),n,r.sessionId)})}),await new Promise((c,f)=>{const d=i(p=>{a.off("listening",l),f(p)},"onError"),l=i(()=>{a.off("error",d),c()},"onListening");a.once("error",d),a.once("listening",l)}),{port:o,host:e,close:i(()=>new Promise(c=>{a.close(()=>c())}),"close")}}s(createBridgeServer,"createBridgeServer"),i(createBridgeServer,"createBridgeServer");export function findFreePort(){return new Promise((r,e)=>{const t=m();t.unref(),t.on("error",e),t.listen(0,()=>{const o=t.address();if(!o){t.close(),e(new Error("Could not allocate free port"));return}const n=o.port;t.close(()=>r(n))})})}s(findFreePort,"findFreePort"),i(findFreePort,"findFreePort");
+"use strict";var v=Object.defineProperty;var s=(r,e)=>v(r,"name",{value:e,configurable:!0});var m=Object.defineProperty,l=s((r,e)=>m(r,"name",{value:e,configurable:!0}),"s"),g=Object.defineProperty,i=l((r,e)=>g(r,"name",{value:e,configurable:!0}),"i");import{createServer as h}from"node:net";import{WebSocketServer as y}from"ws";import{DEFAULT_WS_HOST as S,DEFAULT_WS_PORT as k}from"./constants.js";import{resolveEnvSink as P}from"./env-sink.js";import{envelopeToEvent as p}from"./event-mappers.js";export function makePublisher(r){let e;return n=>{if(r.bus){r.bus.publish(n);return}if(r.sink){r.sink(n);return}if(e===void 0&&(e=P()),e){e(n);return}(n.severity==="error"||n.severity==="fatal")&&console.debug(`[lensmcp-bridge] ${n.severity}: ${n.title}`)}}s(makePublisher,"makePublisher"),l(makePublisher,"makePublisher"),i(makePublisher,"makePublisher");export function handleClientEnvelope(r,e,n){let o;try{o=JSON.parse(r)}catch{return}if(!(!o||typeof o!="object"||!("kind"in o))){if(o.kind==="batch"){if(!Array.isArray(o.events))return;for(const t of o.events)!t||typeof t!="object"||!("kind"in t)||t.kind!=="batch"&&e(p(t,n));return}e(p(o,n))}}s(handleClientEnvelope,"handleClientEnvelope"),l(handleClientEnvelope,"handleClientEnvelope"),i(handleClientEnvelope,"handleClientEnvelope");export function readTabId(r){try{const e=JSON.parse(r);return typeof e?.tabId=="string"&&e.tabId?e.tabId:void 0}catch{return}}s(readTabId,"readTabId"),l(readTabId,"readTabId"),i(readTabId,"readTabId");export async function createBridgeServer(r={}){const e=r.host??S,n=r.port??k,o=n===0?await findFreePort():n,t=makePublisher(r),a=new y({host:e,port:o});return a.on("connection",c=>{let f;c.on("message",u=>{const d=u.toString();f??=readTabId(d),handleClientEnvelope(d,t,r.sessionId)}),c.on("close",()=>{f&&handleClientEnvelope(JSON.stringify({kind:"gone",at:Date.now(),tabId:f}),t,r.sessionId)})}),await new Promise((c,f)=>{const u=i(b=>{a.off("listening",d),f(b)},"onError"),d=i(()=>{a.off("error",u),c()},"onListening");a.once("error",u),a.once("listening",d)}),{port:o,host:e,close:i(()=>new Promise(c=>{a.close(()=>c())}),"close")}}s(createBridgeServer,"createBridgeServer"),l(createBridgeServer,"createBridgeServer"),i(createBridgeServer,"createBridgeServer");export function findFreePort(){return new Promise((r,e)=>{const n=h();n.unref(),n.on("error",e),n.listen(0,()=>{const o=n.address();if(!o){n.close(),e(new Error("Could not allocate free port"));return}const t=o.port;n.close(()=>r(t))})})}s(findFreePort,"findFreePort"),l(findFreePort,"findFreePort"),i(findFreePort,"findFreePort");

package/lib/types.d.ts

@@ -79,6 +79,40 @@ export type ClientEnvelope = (
     at: number;
     userAgent: string;
     url: string;
+    /**
+     * Why THIS document exists, when the previous one in the tab was thrown away by Vite: the
+     * `vite:beforeFullReload` the runtime saw just before the reload, parked in `sessionStorage`
+     * because the socket that saw it died with the page. Absent on a fresh navigation.
+     */
+    reloadCause?: {
+        path?: string;
+        triggeredBy?: string;
+        at: number;
+    };
+}
+/**
+ * Vite's HMR channel as the PAGE sees it — the client-side events Vite emits on `import.meta.hot`.
+ * This is what lets the lens answer "why did the page reload instead of hot-updating?" and "why
+ * did the tab lose its dev server?": `full-reload` names the file Vite could not hot-update
+ * (`triggeredBy`) and the path it reloaded for; `update` lists the modules that DID hot-update;
+ * `invalidate` is a module giving up on self-acceptance; `ws-disconnect` / `ws-connect` are the
+ * HMR socket itself — the "[vite] server connection lost" console line, as data. Without these the
+ * lens was blind to ~320 full reloads a day on one workspace (issues/dev-gateway/08).
+ */
+ | {
+    kind: 'hmr';
+    at: number;
+    event: 'full-reload' | 'update' | 'invalidate' | 'ws-disconnect' | 'ws-connect';
+    /** `full-reload`: the reload path; `invalidate`: the invalidated module. */
+    path?: string;
+    /** `full-reload`: the changed file Vite could not hot-update (Vite ≥ 5.1). */
+    triggeredBy?: string;
+    /** `update`: the hot-updated module paths (bounded). */
+    updates?: string[];
+    /** `update`: how many updates the payload carried (before bounding). */
+    count?: number;
+    /** `invalidate`: Vite's reason. */
+    message?: string;
 }
 /**
  * The tab's transport closed — its document is GONE.

package/main.js

@@ -1 +1 @@
-"use strict";var S=Object.defineProperty;var n=(s,e)=>S(s,"name",{value:e,configurable:!0});var d=Object.defineProperty,i=n((s,e)=>d(s,"name",{value:e,configurable:!0}),"n");import{DEFAULT_WS_HOST as _,DEFAULT_WS_PORT as g,ENV_SESSION_ID as v,ENV_WS_HOST as u,ENV_WS_PORT as a}from"./lib/constants.js";import{createBridgeServer as T}from"./lib/server.js";async function l(){const s=process.env[u]??_,e=process.env[a],o=e!==void 0&&e!==""?Number(e):g;(!Number.isFinite(o)||o<0)&&(console.error(`[lensmcp-bridge] invalid ${a}=${e}`),process.exit(2));const p=process.env[v];let r;try{r=await T({host:s,port:o,sessionId:p})}catch(m){console.error(`[lensmcp-bridge] failed to listen on ws://${s}:${o} \u2014 ${m.message}`),process.exit(1)}console.log(`[lensmcp-bridge] listening on ws://${r.host}:${r.port}`);let t=!1;const c=i(()=>{t||(t=!0,r.close().then(()=>process.exit(0)))},"shutdown");process.on("SIGINT",c),process.on("SIGTERM",c)}n(l,"g"),i(l,"main"),l();
+"use strict";var d=Object.defineProperty;var n=(s,e)=>d(s,"name",{value:e,configurable:!0});var v=Object.defineProperty,a=n((s,e)=>v(s,"name",{value:e,configurable:!0}),"n"),g=Object.defineProperty,l=a((s,e)=>g(s,"name",{value:e,configurable:!0}),"n");import{DEFAULT_WS_HOST as u,DEFAULT_WS_PORT as _,ENV_SESSION_ID as b,ENV_WS_HOST as T,ENV_WS_PORT as p}from"./lib/constants.js";import{createBridgeServer as f}from"./lib/server.js";async function t(){const s=process.env[T]??u,e=process.env[p],o=e!==void 0&&e!==""?Number(e):_;(!Number.isFinite(o)||o<0)&&(console.error(`[lensmcp-bridge] invalid ${p}=${e}`),process.exit(2));const m=process.env[b];let r;try{r=await f({host:s,port:o,sessionId:m})}catch(S){console.error(`[lensmcp-bridge] failed to listen on ws://${s}:${o} \u2014 ${S.message}`),process.exit(1)}console.log(`[lensmcp-bridge] listening on ws://${r.host}:${r.port}`);let c=!1;const i=l(()=>{c||(c=!0,r.close().then(()=>process.exit(0)))},"shutdown");process.on("SIGINT",i),process.on("SIGTERM",i)}n(t,"l"),a(t,"g"),l(t,"main"),t();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/bridge",
-  "version": "1.21.3",
+  "version": "1.21.4",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -19,8 +19,8 @@
     }
   },
   "dependencies": {
-    "@lensmcp/core": "1.21.3",
-    "@lensmcp/protocol-types": "1.21.3",
+    "@lensmcp/core": "1.21.4",
+    "@lensmcp/protocol-types": "1.21.4",
     "tslib": "^2.3.0",
     "ws": "^8.21.0"
   },