trickle-observe 0.2.71 → 0.2.73

package/dist/vite-plugin.js

@@ -594,6 +594,28 @@ function findReassignments(source) {
  *   for (let i = 0; i < n; i++) { ... }        → trace i
  * Inserts trace calls at the start of the loop body.
  */
+/**
+ * Find catch clause variables and return insertions for tracing.
+ * Handles: catch (err) { ... } → trace err at start of catch body.
+ */
+function findCatchVars(source) {
+    const results = [];
+    const catchRegex = /\bcatch\s*\(\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*(?::\s*[^)]+?)?\s*\)\s*\{/g;
+    let match;
+    while ((match = catchRegex.exec(source)) !== null) {
+        const varName = match[1];
+        if (varName.startsWith('__trickle'))
+            continue;
+        const bodyBrace = match.index + match[0].length - 1;
+        let lineNo = 1;
+        for (let i = 0; i < match.index; i++) {
+            if (source[i] === '\n')
+                lineNo++;
+        }
+        results.push({ bodyStart: bodyBrace + 1, varNames: [varName], lineNo });
+    }
+    return results;
+}
 function findForLoopVars(source) {
     const results = [];
     // Match: for (const/let/var ...
@@ -1219,9 +1241,11 @@ function transformEsmSource(source, filename, moduleName, backendUrl, debug, tra
     const reassignInsertions = traceVars ? findReassignments(source) : [];
     // Find for-loop variable declarations for tracing
     const forLoopInsertions = traceVars ? findForLoopVars(source) : [];
+    // Find catch clause variables for tracing
+    const catchInsertions = traceVars ? findCatchVars(source) : [];
     // Find function parameter names for tracing
     const funcParamInsertions = traceVars ? findFunctionParams(source, isReactFile) : [];
-    if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0)
+    if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && catchInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0)
         return source;
     // Fix line numbers: Vite transforms (TypeScript stripping) may change line numbers.
     // Map transformed line numbers to original source line numbers.
@@ -1290,32 +1314,25 @@ function transformEsmSource(source, filename, moduleName, backendUrl, debug, tra
         }
     }
     // Build prefix — ALL imports first (ESM requires imports before any statements)
-    const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
-    const importLines = [
-        `import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`,
-    ];
-    if (needsTracing && isSSR) {
-        // SSR/Node.js — use file system for writing
-        importLines.push(`import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`, `import { join as __trickle_join } from 'node:path';`);
+    const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
+    const importLines = [];
+    if (isSSR) {
+        // SSR/Node.js — import trickle-observe for function wrapping + file system for writing
+        importLines.push(`import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`);
+        if (needsTracing) {
+            importLines.push(`import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`, `import { join as __trickle_join } from 'node:path';`);
+        }
+    }
+    // Browser mode: no imports needed — variable tracers are self-contained,
+    // function wrapping is a no-op, and transport uses import.meta.hot
+    const prefixLines = [...importLines];
+    if (isSSR) {
+        prefixLines.push(`__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`, `function __trickle_wrap(fn, name, paramNames) {`, `  const opts = {`, `    functionName: name,`, `    module: ${JSON.stringify(moduleName)},`, `    trackArgs: true,`, `    trackReturn: true,`, `    sampleRate: 1,`, `    maxDepth: 5,`, `    environment: 'node',`, `    enabled: true,`, `  };`, `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`, `  return __trickle_wrapFn(fn, opts);`, `}`);
+    }
+    else {
+        // Browser mode: __trickle_wrap is a no-op (function wrapping uses Node.js APIs)
+        prefixLines.push(`function __trickle_wrap(fn) { return fn; }`);
     }
-    const prefixLines = [
-        ...importLines,
-        `__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`,
-        `function __trickle_wrap(fn, name, paramNames) {`,
-        `  const opts = {`,
-        `    functionName: name,`,
-        `    module: ${JSON.stringify(moduleName)},`,
-        `    trackArgs: true,`,
-        `    trackReturn: true,`,
-        `    sampleRate: 1,`,
-        `    maxDepth: 5,`,
-        `    environment: 'node',`,
-        `    enabled: true,`,
-        `  };`,
-        `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`,
-        `  return __trickle_wrapFn(fn, opts);`,
-        `}`,
-    ];
     // Add unified __trickle_send() transport — browser uses HMR WebSocket, SSR uses fs
     if (needsTracing) {
         if (isSSR) {
@@ -1328,7 +1345,7 @@ function transformEsmSource(source, filename, moduleName, backendUrl, debug, tra
         }
     }
     // Add variable tracing if needed — inlined to avoid import resolution issues in Vite SSR.
-    if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0) {
+    if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0) {
         prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Set();`, `  function _inferType(v, d) {`, `    if (d <= 0) return { kind: 'primitive', name: 'unknown' };`, `    if (v === null) return { kind: 'primitive', name: 'null' };`, `    if (v === undefined) return { kind: 'primitive', name: 'undefined' };`, `    const t = typeof v;`, `    if (t === 'string' || t === 'number' || t === 'boolean' || t === 'bigint' || t === 'symbol') return { kind: 'primitive', name: t };`, `    if (t === 'function') return { kind: 'function' };`, `    if (Array.isArray(v)) { return v.length === 0 ? { kind: 'array', element: { kind: 'primitive', name: 'unknown' } } : { kind: 'array', element: _inferType(v[0], d-1) }; }`, `    if (t === 'object') {`, `      if (v instanceof Date) return { kind: 'object', properties: { __date: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof RegExp) return { kind: 'object', properties: { __regexp: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof Error) return { kind: 'object', properties: { __error: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof Promise) return { kind: 'promise', resolved: { kind: 'primitive', name: 'unknown' } };`, `      const props = {}; const keys = Object.keys(v).slice(0, 20);`, `      for (const k of keys) { try { props[k] = _inferType(v[k], d-1); } catch(e) { props[k] = { kind: 'primitive', name: 'unknown' }; } }`, `      return { kind: 'object', properties: props };`, `    }`, `    return { kind: 'primitive', name: 'unknown' };`, `  }`, `  function _sanitize(v, d) {`, `    if (d <= 0) return '[truncated]'; if (v === null || v === undefined) return v; const t = typeof v;`, `    if (t === 'string') return v.length > 100 ? v.substring(0, 100) + '...' : v;`, `    if (t === 'number' || t === 'boolean') return v; if (t === 'bigint') return String(v);`, `    if (t === 'function') return '[Function: ' + (v.name || 'anonymous') + ']';`, `    if (Array.isArray(v)) return v.slice(0, 3).map(i => _sanitize(i, d-1));`, `    if (t === 'object') { if (v instanceof Date) return v.toISOString(); if (v instanceof RegExp) return String(v); if (v instanceof Error) return { error: v.message }; if (v instanceof Promise) return '[Promise]';`, `      const r = {}; const keys = Object.keys(v).slice(0, 10); for (const k of keys) { try { r[k] = _sanitize(v[k], d-1); } catch(e) { r[k] = '[unreadable]'; } } return r; }`, `    return String(v);`, `  }`, `  globalThis.__trickle_var_tracer = function(v, n, l, mod, file) {`, `    try {`, `      const type = _inferType(v, 3);`, `      const th = JSON.stringify(type).substring(0, 32);`, `      const ck = file + ':' + l + ':' + n + ':' + th;`, `      if (_cache.has(ck)) return;`, `      _cache.add(ck);`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: _sanitize(v, 2) }));`, `    } catch(e) {}`, `  };`, `}`, `function __trickle_tv(v, n, l) { try { globalThis.__trickle_var_tracer(v, n, l, ${JSON.stringify(moduleName)}, ${JSON.stringify(filename)}); } catch(e) {} }`);
     }
     // Add React component render tracker if needed
@@ -1373,6 +1390,14 @@ function transformEsmSource(source, filename, moduleName, backendUrl, debug, tra
             code: `\n;try{__trickle_tv(${varName},${JSON.stringify(varName)},${lineNo})}catch(__e){}\n`,
         });
     }
+    // Catch clause insertions: insert trace at start of catch body
+    for (const { bodyStart, varNames, lineNo } of catchInsertions) {
+        const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');
+        allInsertions.push({
+            position: bodyStart,
+            code: `\ntry{${calls}}catch(__e2){}\n`,
+        });
+    }
     // For-loop variable insertions: insert trace at start of loop body
     for (const { bodyStart, varNames, lineNo } of forLoopInsertions) {
         const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');

package/dist-esm/vite-plugin.js

@@ -587,6 +587,28 @@ function findReassignments(source) {
  *   for (let i = 0; i < n; i++) { ... }        → trace i
  * Inserts trace calls at the start of the loop body.
  */
+/**
+ * Find catch clause variables and return insertions for tracing.
+ * Handles: catch (err) { ... } → trace err at start of catch body.
+ */
+function findCatchVars(source) {
+    const results = [];
+    const catchRegex = /\bcatch\s*\(\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*(?::\s*[^)]+?)?\s*\)\s*\{/g;
+    let match;
+    while ((match = catchRegex.exec(source)) !== null) {
+        const varName = match[1];
+        if (varName.startsWith('__trickle'))
+            continue;
+        const bodyBrace = match.index + match[0].length - 1;
+        let lineNo = 1;
+        for (let i = 0; i < match.index; i++) {
+            if (source[i] === '\n')
+                lineNo++;
+        }
+        results.push({ bodyStart: bodyBrace + 1, varNames: [varName], lineNo });
+    }
+    return results;
+}
 function findForLoopVars(source) {
     const results = [];
     // Match: for (const/let/var ...
@@ -1212,9 +1234,11 @@ export function transformEsmSource(source, filename, moduleName, backendUrl, deb
     const reassignInsertions = traceVars ? findReassignments(source) : [];
     // Find for-loop variable declarations for tracing
     const forLoopInsertions = traceVars ? findForLoopVars(source) : [];
+    // Find catch clause variables for tracing
+    const catchInsertions = traceVars ? findCatchVars(source) : [];
     // Find function parameter names for tracing
     const funcParamInsertions = traceVars ? findFunctionParams(source, isReactFile) : [];
-    if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0)
+    if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && catchInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0)
         return source;
     // Fix line numbers: Vite transforms (TypeScript stripping) may change line numbers.
     // Map transformed line numbers to original source line numbers.
@@ -1283,32 +1307,25 @@ export function transformEsmSource(source, filename, moduleName, backendUrl, deb
         }
     }
     // Build prefix — ALL imports first (ESM requires imports before any statements)
-    const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
-    const importLines = [
-        `import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`,
-    ];
-    if (needsTracing && isSSR) {
-        // SSR/Node.js — use file system for writing
-        importLines.push(`import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`, `import { join as __trickle_join } from 'node:path';`);
+    const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
+    const importLines = [];
+    if (isSSR) {
+        // SSR/Node.js — import trickle-observe for function wrapping + file system for writing
+        importLines.push(`import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`);
+        if (needsTracing) {
+            importLines.push(`import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`, `import { join as __trickle_join } from 'node:path';`);
+        }
+    }
+    // Browser mode: no imports needed — variable tracers are self-contained,
+    // function wrapping is a no-op, and transport uses import.meta.hot
+    const prefixLines = [...importLines];
+    if (isSSR) {
+        prefixLines.push(`__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`, `function __trickle_wrap(fn, name, paramNames) {`, `  const opts = {`, `    functionName: name,`, `    module: ${JSON.stringify(moduleName)},`, `    trackArgs: true,`, `    trackReturn: true,`, `    sampleRate: 1,`, `    maxDepth: 5,`, `    environment: 'node',`, `    enabled: true,`, `  };`, `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`, `  return __trickle_wrapFn(fn, opts);`, `}`);
+    }
+    else {
+        // Browser mode: __trickle_wrap is a no-op (function wrapping uses Node.js APIs)
+        prefixLines.push(`function __trickle_wrap(fn) { return fn; }`);
     }
-    const prefixLines = [
-        ...importLines,
-        `__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`,
-        `function __trickle_wrap(fn, name, paramNames) {`,
-        `  const opts = {`,
-        `    functionName: name,`,
-        `    module: ${JSON.stringify(moduleName)},`,
-        `    trackArgs: true,`,
-        `    trackReturn: true,`,
-        `    sampleRate: 1,`,
-        `    maxDepth: 5,`,
-        `    environment: 'node',`,
-        `    enabled: true,`,
-        `  };`,
-        `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`,
-        `  return __trickle_wrapFn(fn, opts);`,
-        `}`,
-    ];
     // Add unified __trickle_send() transport — browser uses HMR WebSocket, SSR uses fs
     if (needsTracing) {
         if (isSSR) {
@@ -1321,7 +1338,7 @@ export function transformEsmSource(source, filename, moduleName, backendUrl, deb
         }
     }
     // Add variable tracing if needed — inlined to avoid import resolution issues in Vite SSR.
-    if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0) {
+    if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0) {
         prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Set();`, `  function _inferType(v, d) {`, `    if (d <= 0) return { kind: 'primitive', name: 'unknown' };`, `    if (v === null) return { kind: 'primitive', name: 'null' };`, `    if (v === undefined) return { kind: 'primitive', name: 'undefined' };`, `    const t = typeof v;`, `    if (t === 'string' || t === 'number' || t === 'boolean' || t === 'bigint' || t === 'symbol') return { kind: 'primitive', name: t };`, `    if (t === 'function') return { kind: 'function' };`, `    if (Array.isArray(v)) { return v.length === 0 ? { kind: 'array', element: { kind: 'primitive', name: 'unknown' } } : { kind: 'array', element: _inferType(v[0], d-1) }; }`, `    if (t === 'object') {`, `      if (v instanceof Date) return { kind: 'object', properties: { __date: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof RegExp) return { kind: 'object', properties: { __regexp: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof Error) return { kind: 'object', properties: { __error: { kind: 'primitive', name: 'string' } } };`, `      if (v instanceof Promise) return { kind: 'promise', resolved: { kind: 'primitive', name: 'unknown' } };`, `      const props = {}; const keys = Object.keys(v).slice(0, 20);`, `      for (const k of keys) { try { props[k] = _inferType(v[k], d-1); } catch(e) { props[k] = { kind: 'primitive', name: 'unknown' }; } }`, `      return { kind: 'object', properties: props };`, `    }`, `    return { kind: 'primitive', name: 'unknown' };`, `  }`, `  function _sanitize(v, d) {`, `    if (d <= 0) return '[truncated]'; if (v === null || v === undefined) return v; const t = typeof v;`, `    if (t === 'string') return v.length > 100 ? v.substring(0, 100) + '...' : v;`, `    if (t === 'number' || t === 'boolean') return v; if (t === 'bigint') return String(v);`, `    if (t === 'function') return '[Function: ' + (v.name || 'anonymous') + ']';`, `    if (Array.isArray(v)) return v.slice(0, 3).map(i => _sanitize(i, d-1));`, `    if (t === 'object') { if (v instanceof Date) return v.toISOString(); if (v instanceof RegExp) return String(v); if (v instanceof Error) return { error: v.message }; if (v instanceof Promise) return '[Promise]';`, `      const r = {}; const keys = Object.keys(v).slice(0, 10); for (const k of keys) { try { r[k] = _sanitize(v[k], d-1); } catch(e) { r[k] = '[unreadable]'; } } return r; }`, `    return String(v);`, `  }`, `  globalThis.__trickle_var_tracer = function(v, n, l, mod, file) {`, `    try {`, `      const type = _inferType(v, 3);`, `      const th = JSON.stringify(type).substring(0, 32);`, `      const ck = file + ':' + l + ':' + n + ':' + th;`, `      if (_cache.has(ck)) return;`, `      _cache.add(ck);`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: _sanitize(v, 2) }));`, `    } catch(e) {}`, `  };`, `}`, `function __trickle_tv(v, n, l) { try { globalThis.__trickle_var_tracer(v, n, l, ${JSON.stringify(moduleName)}, ${JSON.stringify(filename)}); } catch(e) {} }`);
     }
     // Add React component render tracker if needed
@@ -1366,6 +1383,14 @@ export function transformEsmSource(source, filename, moduleName, backendUrl, deb
             code: `\n;try{__trickle_tv(${varName},${JSON.stringify(varName)},${lineNo})}catch(__e){}\n`,
         });
     }
+    // Catch clause insertions: insert trace at start of catch body
+    for (const { bodyStart, varNames, lineNo } of catchInsertions) {
+        const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');
+        allInsertions.push({
+            position: bodyStart,
+            code: `\ntry{${calls}}catch(__e2){}\n`,
+        });
+    }
     // For-loop variable insertions: insert trace at start of loop body
     for (const { bodyStart, varNames, lineNo } of forLoopInsertions) {
         const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trickle-observe",
-  "version": "0.2.71",
+  "version": "0.2.73",
   "description": "Runtime type observability for JavaScript applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/vite-plugin.ts

@@ -566,6 +566,31 @@ function findReassignments(source: string): Array<{ lineEnd: number; varName: st
  *   for (let i = 0; i < n; i++) { ... }        → trace i
  * Inserts trace calls at the start of the loop body.
  */
+/**
+ * Find catch clause variables and return insertions for tracing.
+ * Handles: catch (err) { ... } → trace err at start of catch body.
+ */
+function findCatchVars(source: string): Array<{ bodyStart: number; varNames: string[]; lineNo: number }> {
+  const results: Array<{ bodyStart: number; varNames: string[]; lineNo: number }> = [];
+  const catchRegex = /\bcatch\s*\(\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\s*(?::\s*[^)]+?)?\s*\)\s*\{/g;
+  let match;
+
+  while ((match = catchRegex.exec(source)) !== null) {
+    const varName = match[1];
+    if (varName.startsWith('__trickle')) continue;
+
+    const bodyBrace = match.index + match[0].length - 1;
+    let lineNo = 1;
+    for (let i = 0; i < match.index; i++) {
+      if (source[i] === '\n') lineNo++;
+    }
+
+    results.push({ bodyStart: bodyBrace + 1, varNames: [varName], lineNo });
+  }
+
+  return results;
+}
+
 function findForLoopVars(source: string): Array<{ bodyStart: number; varNames: string[]; lineNo: number }> {
   const results: Array<{ bodyStart: number; varNames: string[]; lineNo: number }> = [];
 
@@ -1209,10 +1234,13 @@ export function transformEsmSource(
   // Find for-loop variable declarations for tracing
   const forLoopInsertions = traceVars ? findForLoopVars(source) : [];
 
+  // Find catch clause variables for tracing
+  const catchInsertions = traceVars ? findCatchVars(source) : [];
+
   // Find function parameter names for tracing
   const funcParamInsertions = traceVars ? findFunctionParams(source, isReactFile) : [];
 
-  if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0) return source;
+  if (funcInsertions.length === 0 && varInsertions.length === 0 && destructInsertions.length === 0 && reassignInsertions.length === 0 && forLoopInsertions.length === 0 && catchInsertions.length === 0 && funcParamInsertions.length === 0 && bodyInsertions.length === 0 && hookInsertions.length === 0 && stateInsertions.length === 0 && conciseBodyInsertions.length === 0) return source;
 
   // Fix line numbers: Vite transforms (TypeScript stripping) may change line numbers.
   // Map transformed line numbers to original source line numbers.
@@ -1280,36 +1308,50 @@ export function transformEsmSource(
   }
 
   // Build prefix — ALL imports first (ESM requires imports before any statements)
-  const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
-  const importLines: string[] = [
-    `import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`,
-  ];
-  if (needsTracing && isSSR) {
-    // SSR/Node.js — use file system for writing
+  const needsTracing = varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0 || bodyInsertions.length > 0 || hookInsertions.length > 0 || stateInsertions.length > 0 || conciseBodyInsertions.length > 0;
+  const importLines: string[] = [];
+
+  if (isSSR) {
+    // SSR/Node.js — import trickle-observe for function wrapping + file system for writing
     importLines.push(
-      `import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`,
-      `import { join as __trickle_join } from 'node:path';`,
+      `import { wrapFunction as __trickle_wrapFn, configure as __trickle_configure } from 'trickle-observe';`,
     );
+    if (needsTracing) {
+      importLines.push(
+        `import { mkdirSync as __trickle_mkdirSync, appendFileSync as __trickle_appendFileSync } from 'node:fs';`,
+        `import { join as __trickle_join } from 'node:path';`,
+      );
+    }
   }
+  // Browser mode: no imports needed — variable tracers are self-contained,
+  // function wrapping is a no-op, and transport uses import.meta.hot
 
-  const prefixLines = [
-    ...importLines,
-    `__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`,
-    `function __trickle_wrap(fn, name, paramNames) {`,
-    `  const opts = {`,
-    `    functionName: name,`,
-    `    module: ${JSON.stringify(moduleName)},`,
-    `    trackArgs: true,`,
-    `    trackReturn: true,`,
-    `    sampleRate: 1,`,
-    `    maxDepth: 5,`,
-    `    environment: 'node',`,
-    `    enabled: true,`,
-    `  };`,
-    `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`,
-    `  return __trickle_wrapFn(fn, opts);`,
-    `}`,
-  ];
+  const prefixLines = [...importLines];
+
+  if (isSSR) {
+    prefixLines.push(
+      `__trickle_configure({ backendUrl: ${JSON.stringify(backendUrl)}, batchIntervalMs: 2000, debug: ${debug}, enabled: true, environment: 'node' });`,
+      `function __trickle_wrap(fn, name, paramNames) {`,
+      `  const opts = {`,
+      `    functionName: name,`,
+      `    module: ${JSON.stringify(moduleName)},`,
+      `    trackArgs: true,`,
+      `    trackReturn: true,`,
+      `    sampleRate: 1,`,
+      `    maxDepth: 5,`,
+      `    environment: 'node',`,
+      `    enabled: true,`,
+      `  };`,
+      `  if (paramNames && paramNames.length) opts.paramNames = paramNames;`,
+      `  return __trickle_wrapFn(fn, opts);`,
+      `}`,
+    );
+  } else {
+    // Browser mode: __trickle_wrap is a no-op (function wrapping uses Node.js APIs)
+    prefixLines.push(
+      `function __trickle_wrap(fn) { return fn; }`,
+    );
+  }
 
   // Add unified __trickle_send() transport — browser uses HMR WebSocket, SSR uses fs
   if (needsTracing) {
@@ -1350,7 +1392,7 @@ export function transformEsmSource(
   }
 
   // Add variable tracing if needed — inlined to avoid import resolution issues in Vite SSR.
-  if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || funcParamInsertions.length > 0) {
+  if (varInsertions.length > 0 || destructInsertions.length > 0 || reassignInsertions.length > 0 || forLoopInsertions.length > 0 || catchInsertions.length > 0 || funcParamInsertions.length > 0) {
     prefixLines.push(
       `if (!globalThis.__trickle_var_tracer) {`,
       `  const _cache = new Set();`,
@@ -1529,6 +1571,15 @@ export function transformEsmSource(
     });
   }
 
+  // Catch clause insertions: insert trace at start of catch body
+  for (const { bodyStart, varNames, lineNo } of catchInsertions) {
+    const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');
+    allInsertions.push({
+      position: bodyStart,
+      code: `\ntry{${calls}}catch(__e2){}\n`,
+    });
+  }
+
   // For-loop variable insertions: insert trace at start of loop body
   for (const { bodyStart, varNames, lineNo } of forLoopInsertions) {
     const calls = varNames.map(n => `__trickle_tv(${n},${JSON.stringify(n)},${lineNo})`).join(';');