@lensmcp/client-runtime 1.23.12 → 1.24.0

package/README.md

@@ -34,12 +34,24 @@ Run the bridge alongside your dev server:
 lensmcp bridge            # ws://127.0.0.1:5747, forwards to .lensmcp/events.jsonl
 ```
 
+The bridge admits pages by **origin**: loopback dev servers (`localhost`,
+`127.0.0.1`, `*.localhost`) work as-is; a page served from any other host — a
+custom `/etc/hosts` name, a LAN address — needs its origin in
+`LENSMCP_BRIDGE_ALLOWED_ORIGINS` where the bridge runs. If the bridge was
+started with `LENSMCP_BRIDGE_TOKEN`, give the page the same value:
+
+```html
+<meta name="lensmcp-ws-token" content="…">
+<!-- or: <script>window.__LENSMCP_WS_TOKEN__ = '…'</script> before the runtime loads -->
+```
+
 For explicit control, call the installer yourself instead of importing `/auto`:
 
 ```ts
 import { installLensmcp } from '@lensmcp/client-runtime';
 
 installLensmcp({ wsUrl: 'ws://127.0.0.1:5747' });
+// against a bridge started with LENSMCP_BRIDGE_TOKEN: installLensmcp({ wsUrl: '…', wsToken: '…' })
 ```
 
 ## With a build plugin

package/auto.d.ts

@@ -1 +1 @@
-export { installLensmcp, resolveLensmcpWsUrl, type AutoInstallOptions } from './lib/auto.js';
+export { installLensmcp, resolveLensmcpWsUrl, resolveLensmcpWsToken, type AutoInstallOptions } from './lib/auto.js';

package/auto.js

@@ -1 +1 @@
-"use strict";import{installLensmcp as s}from"./lib/auto.js";s();export{installLensmcp,resolveLensmcpWsUrl}from"./lib/auto.js";
+"use strict";import{installLensmcp as s}from"./lib/auto.js";s();export{installLensmcp,resolveLensmcpWsUrl,resolveLensmcpWsToken}from"./lib/auto.js";

package/index.d.ts

@@ -1,2 +1,2 @@
 export { installClientRuntime, type InstallOptions } from './lib/install.js';
-export { installLensmcp, resolveLensmcpWsUrl, type AutoInstallOptions, } from './lib/auto.js';
+export { installLensmcp, resolveLensmcpWsUrl, resolveLensmcpWsToken, type AutoInstallOptions, } from './lib/auto.js';

package/index.js

@@ -1 +1 @@
-"use strict";export{installClientRuntime}from"./lib/install.js";export{installLensmcp,resolveLensmcpWsUrl}from"./lib/auto.js";
+"use strict";export{installClientRuntime}from"./lib/install.js";export{installLensmcp,resolveLensmcpWsUrl,resolveLensmcpWsToken}from"./lib/auto.js";

package/lib/auto.d.ts

@@ -1,11 +1,15 @@
 export interface AutoInstallOptions {
     /** Full WS URL override. Wins over every other resolution source. */
     wsUrl?: string;
+    /** Bridge token override. Wins over `__LENSMCP_WS_TOKEN__` and `<meta name="lensmcp-ws-token">`. */
+    wsToken?: string;
     /** Reconnect interval after a previously-good connection drops. */
     reconnectIntervalMs?: number;
 }
 /** Resolve the bridge WebSocket URL from the runtime environment. */
 export declare function resolveLensmcpWsUrl(override?: string): string;
+/** Resolve the bridge token, if the page was given one: argument → global → `<meta>`. */
+export declare function resolveLensmcpWsToken(override?: string): string | undefined;
 /**
  * Resolve the bridge WS endpoint and install the capture layer. The no-build
  * seam: any app can call this (or `import '@lensmcp/client-runtime/auto'`)

package/lib/auto.js

@@ -1 +1 @@
-"use strict";var u=Object.defineProperty;var n=(e,t)=>u(e,"name",{value:t,configurable:!0});var f=Object.defineProperty,i=n((e,t)=>f(e,"name",{value:t,configurable:!0}),"o");import{installClientRuntime as p}from"./install.js";const _=5747,m="127.0.0.1";export function resolveLensmcpWsUrl(e){if(e)return e;const t=globalThis,o=t.__LENSMCP_WS_URL__;if(typeof o=="string"&&o.length>0)return o;const l=r("lensmcp-ws");if(l)return l;const s=t.__LENSMCP_WS_PORT__,a=typeof s=="number"||typeof s=="string"?String(s):r("lensmcp-ws-port")??String(_),c=t.__LENSMCP_WS_HOST__;return`ws://${typeof c=="string"&&c.length>0?c:r("lensmcp-ws-host")??(typeof location<"u"&&location.hostname?location.hostname:m)}:${a}`}n(resolveLensmcpWsUrl,"resolveLensmcpWsUrl"),i(resolveLensmcpWsUrl,"resolveLensmcpWsUrl");export function installLensmcp(e={}){if(typeof window>"u")return;const t={wsUrl:resolveLensmcpWsUrl(e.wsUrl)};e.reconnectIntervalMs!==void 0&&(t.reconnectIntervalMs=e.reconnectIntervalMs),p(t)}n(installLensmcp,"installLensmcp"),i(installLensmcp,"installLensmcp");function r(e){if(!(typeof document>"u"))try{const t=document.querySelector(`meta[name="${e}"]`)?.getAttribute("content");return t&&t.length>0?t:void 0}catch{return}}n(r,"c"),i(r,"readMeta");
+"use strict";var a=Object.defineProperty;var o=(t,e)=>a(t,"name",{value:e,configurable:!0});var _=Object.defineProperty,s=o((t,e)=>_(t,"name",{value:e,configurable:!0}),"o");import{installClientRuntime as p}from"./install.js";const f=5747,m="127.0.0.1";export function resolveLensmcpWsUrl(t){if(t)return t;const e=globalThis,n=e.__LENSMCP_WS_URL__;if(typeof n=="string"&&n.length>0)return n;const i=r("lensmcp-ws");if(i)return i;const c=e.__LENSMCP_WS_PORT__,u=typeof c=="number"||typeof c=="string"?String(c):r("lensmcp-ws-port")??String(f),l=e.__LENSMCP_WS_HOST__;return`ws://${typeof l=="string"&&l.length>0?l:r("lensmcp-ws-host")??(typeof location<"u"&&location.hostname?location.hostname:m)}:${u}`}o(resolveLensmcpWsUrl,"resolveLensmcpWsUrl"),s(resolveLensmcpWsUrl,"resolveLensmcpWsUrl");export function resolveLensmcpWsToken(t){if(t)return t;const e=globalThis.__LENSMCP_WS_TOKEN__;return typeof e=="string"&&e.length>0?e:r("lensmcp-ws-token")}o(resolveLensmcpWsToken,"resolveLensmcpWsToken"),s(resolveLensmcpWsToken,"resolveLensmcpWsToken");export function installLensmcp(t={}){if(typeof window>"u")return;const e={wsUrl:resolveLensmcpWsUrl(t.wsUrl)},n=resolveLensmcpWsToken(t.wsToken);n!==void 0&&(e.wsToken=n),t.reconnectIntervalMs!==void 0&&(e.reconnectIntervalMs=t.reconnectIntervalMs),p(e)}o(installLensmcp,"installLensmcp"),s(installLensmcp,"installLensmcp");function r(t){if(!(typeof document>"u"))try{const e=document.querySelector(`meta[name="${t}"]`)?.getAttribute("content");return e&&e.length>0?e:void 0}catch{return}}o(r,"r"),s(r,"readMeta");

package/lib/install.d.ts

@@ -21,6 +21,11 @@
 export interface InstallOptions {
     /** WebSocket URL the plugin opened on the dev server. */
     wsUrl: string;
+    /**
+     * The bridge's token, when it requires one (`LENSMCP_BRIDGE_TOKEN` on a standalone bridge). Sent as
+     * `?token=` on the upgrade unless `wsUrl` already carries one.
+     */
+    wsToken?: string;
     /** Reconnect interval after a previously-good connection drops. */
     reconnectIntervalMs?: number;
 }

package/lib/install.js

@@ -1 +1 @@
-"use strict";var O=Object.defineProperty;var u=(t,o)=>O(t,"name",{value:o,configurable:!0});var T=Object.defineProperty,c=u((t,o)=>T(t,"name",{value:o,configurable:!0}),"l");const L="__LENSMCP_CLIENT__";export function installClientRuntime(t){if(typeof window>"u"||window[L])return;window[L]=!0;const o=t.wsUrl,S=t.reconnectIntervalMs??1e3;let a=null,k=!1;const g=[];let f=[],w=!1;const v=c(()=>{if(w=!1,!f.length)return;const n=f;if(f=[],a&&a.readyState===1)try{let e=0;for(;e<n.length;){const r=[];let d=0;for(;e<n.length&&r.length<200;){let i=JSON.stringify(n[e]);if(i.length>3e5&&(i=JSON.stringify({kind:"console",level:"warn",at:Date.now(),truncated:!0,args:[`[lensmcp] dropped an oversized ${String(n[e]?.kind)} event (${i.length} chars)`]})),r.length&&d+i.length>3e5)break;r.push(i),d+=i.length+1,e+=1}a.send(r.length===1?r[0]:`{"kind":"batch","at":${Date.now()},"events":[${r.join(",")}]}`)}return}catch{}for(const e of n)g.push(e)},"flushBatch"),s=c(n=>{n.at=Date.now(),f.push(n),w||(w=!0,setTimeout(v,0))},"send");window.addEventListener("pagehide",v);const p=c(()=>{try{a=new WebSocket(o)}catch{setTimeout(p,S);return}a.addEventListener("open",()=>{for(k=!0;g.length;){const n=g.splice(0,200);try{a.send(JSON.stringify(n.length===1?n[0]:{kind:"batch",at:Date.now(),events:n}))}catch{}}s({kind:"ready",userAgent:navigator.userAgent,url:location.href})}),a.addEventListener("close",()=>{k&&setTimeout(p,S)}),a.addEventListener("error",()=>{})},"open");p(),window.__LENSMCP_PUBLISH__=n=>{s({kind:"publish",...n})},window.addEventListener("error",n=>{const e=n.target;if(e&&e!==window&&e.tagName&&!n.message){s({kind:"resource-error",tagName:e.tagName.toLowerCase(),url:e.currentSrc||e.src||e.href||void 0});return}const r=n.error;s({kind:"error",message:n.message,name:r?.name,stack:h(r?.stack),source:n.filename,lineno:n.lineno,colno:n.colno})},!0),window.addEventListener("unhandledrejection",n=>{const e=n.reason;s({kind:"unhandledrejection",reason:h(N(e)),name:typeof e=="object"&&e?e.name:void 0,stack:typeof e=="object"&&e?h(e.stack):void 0})});const _=["log","info","warn","error","debug"];for(const n of _){const e=console[n];console[n]=function(...r){try{s({kind:"console",level:n,args:r.map(E)})}catch{}e.apply(console,r)}}const j=window.fetch.bind(window);window.fetch=async function(n,e){const r=e?.method??(typeof n=="object"&&n&&"method"in n?n.method:"GET"),d=typeof n=="string"?n:n instanceof URL?n.toString():n.url,i=Date.now();try{const l=await j(n,e);return s({kind:"fetch",method:r,url:d,status:l.status,statusText:l.statusText,ok:l.ok,durationMs:Date.now()-i}),l}catch(l){const b=l;throw s({kind:"fetch",method:r,url:d,error:b.message??String(b),durationMs:Date.now()-i}),l}};const C=history.pushState.bind(history),D=history.replaceState.bind(history),m=c(n=>s({kind:"route",url:location.href,from:n}),"notify");history.pushState=function(...n){const e=location.href,r=C(...n);return m(e),r},history.replaceState=function(...n){const e=location.href,r=D(...n);return m(e),r},window.addEventListener("popstate",()=>m())}u(installClientRuntime,"installClientRuntime"),c(installClientRuntime,"installClientRuntime");const y=4096;function h(t){return t===void 0||t.length<=y?t:`${t.slice(0,y)}\u2026[lensmcp truncated: ${t.length-y} more chars]`}u(h,"m"),c(h,"clipStack");function N(t){if(t==null)return String(t);if(typeof t=="string")return t;if(typeof t.message=="string"&&t.message)return t.message;try{const o=JSON.stringify(t);if(o&&o!=="{}"&&o!=="null")return o}catch{}return String(t)}u(N,"M"),c(N,"describeReason");function E(t){if(t===null)return null;const o=typeof t;if(o==="string"||o==="number"||o==="boolean")return t;try{return JSON.parse(JSON.stringify(t))}catch{return String(t)}}u(E,"C"),c(E,"safe");
+"use strict";var O=Object.defineProperty;var u=(e,o)=>O(e,"name",{value:o,configurable:!0});var J=Object.defineProperty,a=u((e,o)=>J(e,"name",{value:o,configurable:!0}),"i");const L="__LENSMCP_CLIENT__";export function installClientRuntime(e){if(typeof window>"u"||window[L])return;window[L]=!0;const o=N(e.wsUrl,e.wsToken),d=e.reconnectIntervalMs??1e3;let c=null,S=!1;const w=[];let f=[],m=!1;const v=a(()=>{if(m=!1,!f.length)return;const n=f;if(f=[],c&&c.readyState===1)try{let t=0;for(;t<n.length;){const r=[];let h=0;for(;t<n.length&&r.length<200;){let i=JSON.stringify(n[t]);if(i.length>3e5&&(i=JSON.stringify({kind:"console",level:"warn",at:Date.now(),truncated:!0,args:[`[lensmcp] dropped an oversized ${String(n[t]?.kind)} event (${i.length} chars)`]})),r.length&&h+i.length>3e5)break;r.push(i),h+=i.length+1,t+=1}c.send(r.length===1?r[0]:`{"kind":"batch","at":${Date.now()},"events":[${r.join(",")}]}`)}return}catch{}for(const t of n)w.push(t)},"flushBatch"),s=a(n=>{n.at=Date.now(),f.push(n),m||(m=!0,setTimeout(v,0))},"send");window.addEventListener("pagehide",v);const p=a(()=>{try{c=new WebSocket(o)}catch{setTimeout(p,d);return}c.addEventListener("open",()=>{for(S=!0;w.length;){const n=w.splice(0,200);try{c.send(JSON.stringify(n.length===1?n[0]:{kind:"batch",at:Date.now(),events:n}))}catch{}}s({kind:"ready",userAgent:navigator.userAgent,url:location.href})}),c.addEventListener("close",()=>{S&&setTimeout(p,d)}),c.addEventListener("error",()=>{})},"open");p(),window.__LENSMCP_PUBLISH__=n=>{s({...n,kind:"publish"})},window.addEventListener("error",n=>{const t=n.target;if(t&&t!==window&&t.tagName&&!n.message){s({kind:"resource-error",tagName:t.tagName.toLowerCase(),url:t.currentSrc||t.src||t.href||void 0});return}const r=n.error;s({kind:"error",message:n.message,name:r?.name,stack:g(r?.stack),source:n.filename,lineno:n.lineno,colno:n.colno})},!0),window.addEventListener("unhandledrejection",n=>{const t=n.reason;s({kind:"unhandledrejection",reason:g(E(t)),name:typeof t=="object"&&t?t.name:void 0,stack:typeof t=="object"&&t?g(t.stack):void 0})});const T=["log","info","warn","error","debug"];for(const n of T){const t=console[n];console[n]=function(...r){try{s({kind:"console",level:n,args:r.map(_)})}catch{}t.apply(console,r)}}const j=window.fetch.bind(window);window.fetch=async function(n,t){const r=t?.method??(typeof n=="object"&&n&&"method"in n?n.method:"GET"),h=typeof n=="string"?n:n instanceof URL?n.toString():n.url,i=Date.now();try{const l=await j(n,t);return s({kind:"fetch",method:r,url:h,status:l.status,statusText:l.statusText,ok:l.ok,durationMs:Date.now()-i}),l}catch(l){const b=l;throw s({kind:"fetch",method:r,url:h,error:b.message??String(b),durationMs:Date.now()-i}),l}};const C=history.pushState.bind(history),D=history.replaceState.bind(history),y=a(n=>s({kind:"route",url:location.href,from:n}),"notify");history.pushState=function(...n){const t=location.href,r=C(...n);return y(t),r},history.replaceState=function(...n){const t=location.href,r=D(...n);return y(t),r},window.addEventListener("popstate",()=>y())}u(installClientRuntime,"installClientRuntime"),a(installClientRuntime,"installClientRuntime");function N(e,o){if(!o)return e;try{const d=new URL(e);return d.searchParams.has("token")||d.searchParams.set("token",o),d.toString()}catch{return e}}u(N,"T"),a(N,"withToken");const k=4096;function g(e){return e===void 0||e.length<=k?e:`${e.slice(0,k)}\u2026[lensmcp truncated: ${e.length-k} more chars]`}u(g,"k"),a(g,"clipStack");function E(e){if(e==null)return String(e);if(typeof e=="string")return e;if(typeof e.message=="string"&&e.message)return e.message;try{const o=JSON.stringify(e);if(o&&o!=="{}"&&o!=="null")return o}catch{}return String(e)}u(E,"M"),a(E,"describeReason");function _(e){if(e===null)return null;const o=typeof e;if(o==="string"||o==="number"||o==="boolean")return e;try{return JSON.parse(JSON.stringify(e))}catch{return String(e)}}u(_,"C"),a(_,"safe");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/client-runtime",
-  "version": "1.23.12",
+  "version": "1.24.0",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",