@lensmcp/client-runtime 1.18.4 → 1.18.7

package/auto.js

@@ -1,16 +1 @@
-/**
- * Side-effecting no-build entry.
- *
- *   import '@lensmcp/client-runtime/auto';
- *
- * Installs the browser capture layer immediately, resolving the bridge WS
- * endpoint at runtime (global → `<meta>` → `ws://<host>:5747`). Pair it with a
- * standalone bridge (`lensmcp bridge`) for hosts with no LensMCP build plugin:
- * webpack, Next.js, or no bundler at all.
- *
- * For explicit control over the URL or reconnect behaviour, import
- * `{ installLensmcp }` and call it yourself instead of importing this entry.
- */
-import { installLensmcp } from './lib/auto.js';
-installLensmcp();
-export { installLensmcp, resolveLensmcpWsUrl } from './lib/auto.js';
+"use strict";import{installLensmcp as s}from"./lib/auto.js";s();export{installLensmcp,resolveLensmcpWsUrl}from"./lib/auto.js";

package/index.js

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

package/lib/auto.js

@@ -1,72 +1 @@
-/**
- * Runtime WS-endpoint resolution for the no-build path.
- *
- * The Vite plugin bakes the bridge WS port into the injected runtime at
- * build/serve time. Without a bundler there's nothing to bake it in, so the
- * endpoint is resolved at runtime from (in order):
- *
- *   1. an explicit `wsUrl` argument,
- *   2. `globalThis.__LENSMCP_WS_URL__` (a full `ws://…` URL),
- *   3. `<meta name="lensmcp-ws" content="ws://…">`,
- *   4. `ws://<host>:<port>` assembled from
- *      `__LENSMCP_WS_HOST__` / `<meta name="lensmcp-ws-host">` / `location.hostname`
- *      and `__LENSMCP_WS_PORT__` / `<meta name="lensmcp-ws-port">` / the default.
- *
- * This is what lets `import '@lensmcp/client-runtime/auto'` work in any host
- * (webpack, Next.js, plain `<script type=module>`, no build at all).
- */
-import { installClientRuntime } from './install.js';
-// Must match `@lensmcp/bridge`'s DEFAULT_WS_PORT. The bridge is a Node-only
-// package (it imports `ws`/`node:net`) and can't be pulled into a browser
-// bundle, so the literal is duplicated here on purpose — keep them in sync.
-const DEFAULT_WS_PORT = 5747;
-const DEFAULT_WS_HOST = '127.0.0.1';
-/** Resolve the bridge WebSocket URL from the runtime environment. */
-export function resolveLensmcpWsUrl(override) {
-    if (override)
-        return override;
-    const g = globalThis;
-    const globalUrl = g['__LENSMCP_WS_URL__'];
-    if (typeof globalUrl === 'string' && globalUrl.length > 0)
-        return globalUrl;
-    const metaUrl = readMeta('lensmcp-ws');
-    if (metaUrl)
-        return metaUrl;
-    const globalPort = g['__LENSMCP_WS_PORT__'];
-    const port = typeof globalPort === 'number' || typeof globalPort === 'string'
-        ? String(globalPort)
-        : readMeta('lensmcp-ws-port') ?? String(DEFAULT_WS_PORT);
-    const globalHost = g['__LENSMCP_WS_HOST__'];
-    const host = typeof globalHost === 'string' && globalHost.length > 0
-        ? globalHost
-        : readMeta('lensmcp-ws-host') ??
-            (typeof location !== 'undefined' && location.hostname ? location.hostname : DEFAULT_WS_HOST);
-    return `ws://${host}:${port}`;
-}
-/**
- * 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'`)
- * without a bundler plugin. No-op outside a browser (SSR-safe), and
- * idempotent (the underlying runtime guards against double-install).
- */
-export function installLensmcp(opts = {}) {
-    if (typeof window === 'undefined')
-        return;
-    const options = { wsUrl: resolveLensmcpWsUrl(opts.wsUrl) };
-    if (opts.reconnectIntervalMs !== undefined) {
-        options.reconnectIntervalMs = opts.reconnectIntervalMs;
-    }
-    installClientRuntime(options);
-}
-function readMeta(name) {
-    if (typeof document === 'undefined')
-        return undefined;
-    try {
-        const el = document.querySelector(`meta[name="${name}"]`);
-        const content = el?.getAttribute('content');
-        return content && content.length > 0 ? content : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
+"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");

package/lib/install.js

@@ -1,218 +1 @@
-/**
- * @lensmcp/client-runtime — the browser-side capture layer.
- *
- * Vite (via `@lensmcp/vite-plugin`) injects this into served HTML. It
- * connects to a localhost WebSocket the plugin spawns, and emits one
- * `ClientEnvelope` per observed event. The runtime is **strictly
- * passive**: it never mutates app state, never swallows errors, never
- * changes scheduling.
- *
- * Phase 1 scope (mirror of the inline runtime in `@lensmcp/vite-plugin`,
- * promoted out so the plugin can resolve it as a real package import
- * in Phase 2):
- *   • `window.error` / `unhandledrejection`
- *   • `console.{log,info,warn,error,debug}` wrapping that preserves original
- *   • `fetch` wrapping (timing + status, no body inspection)
- *   • History API + popstate route changes
- *   • `ready` event on first connect
- *
- * Each envelope is timestamped on send.
- */
-const FLAG = '__LENSMCP_CLIENT__';
-export function installClientRuntime(opts) {
-    if (typeof window === 'undefined')
-        return;
-    if (window[FLAG])
-        return;
-    window[FLAG] = true;
-    const wsUrl = opts.wsUrl;
-    const reconnect = opts.reconnectIntervalMs ?? 1000;
-    let ws = null;
-    let openOnce = false;
-    const queue = [];
-    const send = (env) => {
-        env.at = Date.now();
-        if (ws && ws.readyState === 1 /* OPEN */) {
-            try {
-                ws.send(JSON.stringify(env));
-            }
-            catch { /* swallow */ }
-        }
-        else {
-            queue.push(env);
-        }
-    };
-    const open = () => {
-        try {
-            ws = new WebSocket(wsUrl);
-        }
-        catch {
-            setTimeout(open, reconnect);
-            return;
-        }
-        ws.addEventListener('open', () => {
-            openOnce = true;
-            while (queue.length) {
-                try {
-                    ws.send(JSON.stringify(queue.shift()));
-                }
-                catch { /* swallow */ }
-            }
-            send({ kind: 'ready', userAgent: navigator.userAgent, url: location.href });
-        });
-        ws.addEventListener('close', () => {
-            if (openOnce)
-                setTimeout(open, reconnect);
-        });
-        ws.addEventListener('error', () => { });
-    };
-    open();
-    // Bridge for in-page instrumentation (@lensmcp/react-instrumentation,
-    // @lensmcp/valtio-instrumentation): their publish() output rides the
-    // same WS as a `publish` envelope so React/Valtio events reach the bus.
-    window.__LENSMCP_PUBLISH__ = (envelope) => {
-        send({ kind: 'publish', ...envelope });
-    };
-    // Errors
-    window.addEventListener('error', (e) => {
-        // Registered in the CAPTURE phase, so this also receives subresource
-        // load failures (<img>, <script>, <link>, <video>). Those are a plain
-        // Event, not an ErrorEvent — no message, no filename, no lineno; the
-        // only identity is the target element and its URL. Reading just the
-        // ErrorEvent fields (as this did) reduced every one of them to a bare
-        // `{ kind: 'error', at, tabId }` with nothing to diagnose.
-        const target = e.target;
-        if (target && target !== window && target.tagName && !e.message) {
-            send({
-                kind: 'resource-error',
-                tagName: target.tagName.toLowerCase(),
-                url: target.currentSrc || target.src || target.href || undefined,
-            });
-            return;
-        }
-        const err = e.error;
-        send({
-            kind: 'error',
-            message: e.message,
-            name: err?.name,
-            stack: clipStack(err?.stack),
-            source: e.filename,
-            lineno: e.lineno,
-            colno: e.colno,
-        });
-    }, true);
-    window.addEventListener('unhandledrejection', (e) => {
-        const reason = e.reason;
-        send({
-            kind: 'unhandledrejection',
-            reason: clipStack(describeReason(reason)),
-            name: typeof reason === 'object' && reason ? reason.name : undefined,
-            stack: typeof reason === 'object' && reason ? clipStack(reason.stack) : undefined,
-        });
-    });
-    const levels = ['log', 'info', 'warn', 'error', 'debug'];
-    for (const level of levels) {
-        const orig = console[level];
-        console[level] = function (...args) {
-            try {
-                send({ kind: 'console', level, args: args.map(safe) });
-            }
-            catch { /* swallow */ }
-            orig.apply(console, args);
-        };
-    }
-    // Fetch
-    const origFetch = window.fetch.bind(window);
-    window.fetch = async function (input, init) {
-        const method = init?.method ??
-            (typeof input === 'object' && input && 'method' in input ? input.method : 'GET');
-        const url = typeof input === 'string'
-            ? input
-            : input instanceof URL
-                ? input.toString()
-                : input.url;
-        const start = Date.now();
-        try {
-            const res = await origFetch(input, init);
-            send({
-                kind: 'fetch',
-                method,
-                url,
-                status: res.status,
-                statusText: res.statusText,
-                ok: res.ok,
-                durationMs: Date.now() - start,
-            });
-            return res;
-        }
-        catch (err) {
-            const e = err;
-            send({ kind: 'fetch', method, url, error: e.message ?? String(e), durationMs: Date.now() - start });
-            throw err;
-        }
-    };
-    // History
-    const origPush = history.pushState.bind(history);
-    const origReplace = history.replaceState.bind(history);
-    const notify = (from) => send({ kind: 'route', url: location.href, from });
-    history.pushState = function (...args) {
-        const from = location.href;
-        const r = origPush(...args);
-        notify(from);
-        return r;
-    };
-    history.replaceState = function (...args) {
-        const from = location.href;
-        const r = origReplace(...args);
-        notify(from);
-        return r;
-    };
-    window.addEventListener('popstate', () => notify());
-}
-/**
- * Bound a stack at CAPTURE so a deep React tree can't push a multi-hundred-KB
- * frame down the socket. The bridge bounds again (it must — a hand-rolled
- * client is not obliged to do this), and the marker matches the one
- * `@lensmcp/storage` uses for `raw`, so both truncations read the same.
- */
-const MAX_STACK_CHARS = 4096;
-function clipStack(value) {
-    if (value === undefined || value.length <= MAX_STACK_CHARS)
-        return value;
-    return `${value.slice(0, MAX_STACK_CHARS)}…[lensmcp truncated: ${value.length - MAX_STACK_CHARS} more chars]`;
-}
-/**
- * A rejected non-Error — `{ status: 401 }`, a `Response` — used to be
- * flattened by `String(reason)` into `"[object Object]"`: captured, and
- * completely uninformative.
- */
-function describeReason(reason) {
-    if (reason === null || reason === undefined)
-        return String(reason);
-    if (typeof reason === 'string')
-        return reason;
-    if (typeof reason.message === 'string' && reason.message)
-        return reason.message;
-    try {
-        const json = JSON.stringify(reason);
-        if (json && json !== '{}' && json !== 'null')
-            return json;
-    }
-    catch {
-        /* circular / non-serialisable — fall through */
-    }
-    return String(reason);
-}
-function safe(v) {
-    if (v === null)
-        return null;
-    const t = typeof v;
-    if (t === 'string' || t === 'number' || t === 'boolean')
-        return v;
-    try {
-        return JSON.parse(JSON.stringify(v));
-    }
-    catch {
-        return String(v);
-    }
-}
+"use strict";var C=Object.defineProperty;var u=(t,r)=>C(t,"name",{value:r,configurable:!0});var j=Object.defineProperty,c=u((t,r)=>j(t,"name",{value:r,configurable:!0}),"c");const k="__LENSMCP_CLIENT__";export function installClientRuntime(t){if(typeof window>"u"||window[k])return;window[k]=!0;const r=t.wsUrl,w=t.reconnectIntervalMs??1e3;let i=null,y=!1;const l=[],s=c(n=>{if(n.at=Date.now(),i&&i.readyState===1)try{i.send(JSON.stringify(n))}catch{}else l.push(n)},"send"),f=c(()=>{try{i=new WebSocket(r)}catch{setTimeout(f,w);return}i.addEventListener("open",()=>{for(y=!0;l.length;)try{i.send(JSON.stringify(l.shift()))}catch{}s({kind:"ready",userAgent:navigator.userAgent,url:location.href})}),i.addEventListener("close",()=>{y&&setTimeout(f,w)}),i.addEventListener("error",()=>{})},"open");f(),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 o=n.error;s({kind:"error",message:n.message,name:o?.name,stack:d(o?.stack),source:n.filename,lineno:n.lineno,colno:n.colno})},!0),window.addEventListener("unhandledrejection",n=>{const e=n.reason;s({kind:"unhandledrejection",reason:d(v(e)),name:typeof e=="object"&&e?e.name:void 0,stack:typeof e=="object"&&e?d(e.stack):void 0})});const L=["log","info","warn","error","debug"];for(const n of L){const e=console[n];console[n]=function(...o){try{s({kind:"console",level:n,args:o.map(b)})}catch{}e.apply(console,o)}}const N=window.fetch.bind(window);window.fetch=async function(n,e){const o=e?.method??(typeof n=="object"&&n&&"method"in n?n.method:"GET"),m=typeof n=="string"?n:n instanceof URL?n.toString():n.url,p=Date.now();try{const a=await N(n,e);return s({kind:"fetch",method:o,url:m,status:a.status,statusText:a.statusText,ok:a.ok,durationMs:Date.now()-p}),a}catch(a){const S=a;throw s({kind:"fetch",method:o,url:m,error:S.message??String(S),durationMs:Date.now()-p}),a}};const E=history.pushState.bind(history),_=history.replaceState.bind(history),h=c(n=>s({kind:"route",url:location.href,from:n}),"notify");history.pushState=function(...n){const e=location.href,o=E(...n);return h(e),o},history.replaceState=function(...n){const e=location.href,o=_(...n);return h(e),o},window.addEventListener("popstate",()=>h())}u(installClientRuntime,"installClientRuntime"),c(installClientRuntime,"installClientRuntime");const g=4096;function d(t){return t===void 0||t.length<=g?t:`${t.slice(0,g)}\u2026[lensmcp truncated: ${t.length-g} more chars]`}u(d,"h"),c(d,"clipStack");function v(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 r=JSON.stringify(t);if(r&&r!=="{}"&&r!=="null")return r}catch{}return String(t)}u(v,"E"),c(v,"describeReason");function b(t){if(t===null)return null;const r=typeof t;if(r==="string"||r==="number"||r==="boolean")return t;try{return JSON.parse(JSON.stringify(t))}catch{return String(t)}}u(b,"C"),c(b,"safe");

package/package.json

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