trickle-observe 0.2.83 → 0.2.85

package/dist/trace-var.js

@@ -59,6 +59,9 @@ let varsFilePath = '';
 let debugMode = false;
 /** Cache: "file:line:varName" → { fingerprint, timestamp } for value-aware dedup */
 const varCache = new Map();
+/** Per-line sample count to avoid loop variable spam */
+const sampleCount = new Map();
+const MAX_SAMPLES_PER_LINE = 5;
 /** Batch buffer for writing — avoids one fs.appendFileSync per variable */
 let varBuffer = [];
 let flushTimer = null;
@@ -105,8 +108,12 @@ function traceVar(value, varName, line, moduleName, filePath) {
         // Create a stable hash for dedup
         const dummyArgs = { kind: 'tuple', elements: [] };
         const typeHash = (0, type_hash_1.hashType)(dummyArgs, type);
-        // Value-aware dedup: re-send if value changed or 10s elapsed
+        // Per-line sample count limit: stop after N samples to avoid loop spam
         const cacheKey = `${filePath}:${line}:${varName}`;
+        const cnt = sampleCount.get(cacheKey) || 0;
+        if (cnt >= MAX_SAMPLES_PER_LINE)
+            return;
+        // Value-aware dedup: re-send if value changed or 10s elapsed
         const t = typeof value;
         const fp = (t === 'string' || t === 'number' || t === 'boolean' || value === null || value === undefined)
             ? String(value).substring(0, 60)
@@ -116,6 +123,7 @@ function traceVar(value, varName, line, moduleName, filePath) {
         if (prev && prev.fp === fp && (now - prev.ts) < 10000)
             return;
         varCache.set(cacheKey, { fp, ts: now });
+        sampleCount.set(cacheKey, cnt + 1);
         const sample = sanitizeVarSample(value);
         const observation = {
             kind: 'variable',

package/dist/vite-plugin.d.ts

@@ -47,6 +47,13 @@ export declare function tricklePlugin(options?: TricklePluginOptions): {
  * Returns -1 if not found.
  */
 export declare function findFunctionBodyBrace(source: string, afterOpenParen: number): number;
+/**
+ * Find class body ranges in source code. Handles both:
+ *   class Foo { ... }
+ *   var Foo = class { ... }
+ * Returns an array of [start, end] positions (inclusive of braces).
+ */
+export declare function findClassBodyRanges(source: string): Array<[number, number]>;
 /**
  * Find variable reassignments (not declarations) and return insertions for tracing.
  * Handles: x = newValue; x += 1; x ||= fallback; etc.

package/dist/vite-plugin.js

@@ -24,6 +24,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tricklePlugin = tricklePlugin;
 exports.findFunctionBodyBrace = findFunctionBodyBrace;
+exports.findClassBodyRanges = findClassBodyRanges;
 exports.findReassignments = findReassignments;
 exports.findCatchVars = findCatchVars;
 exports.findForLoopVars = findForLoopVars;
@@ -504,6 +505,73 @@ function extractDestructuredNames(pattern) {
     }
     return names;
 }
+/**
+ * Find class body ranges in source code. Handles both:
+ *   class Foo { ... }
+ *   var Foo = class { ... }
+ * Returns an array of [start, end] positions (inclusive of braces).
+ */
+function findClassBodyRanges(source) {
+    const ranges = [];
+    // Match both class declarations and class expressions
+    const classRegex = /\bclass\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*)?\s*(?:extends\s+[a-zA-Z_$.[\]]+\s*)?\{/g;
+    let m;
+    while ((m = classRegex.exec(source)) !== null) {
+        const openBrace = source.indexOf('{', m.index + 5); // skip past 'class'
+        if (openBrace === -1)
+            continue;
+        // Find matching close brace
+        let depth = 1;
+        let pos = openBrace + 1;
+        while (pos < source.length && depth > 0) {
+            const ch = source[pos];
+            if (ch === '{')
+                depth++;
+            else if (ch === '}') {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+            else if (ch === '"' || ch === "'" || ch === '`') {
+                const q = ch;
+                pos++;
+                while (pos < source.length) {
+                    if (source[pos] === '\\')
+                        pos++;
+                    else if (source[pos] === q)
+                        break;
+                    else if (q === '`' && source[pos] === '$' && source[pos + 1] === '{') {
+                        pos += 2;
+                        let td = 1;
+                        while (pos < source.length && td > 0) {
+                            if (source[pos] === '{')
+                                td++;
+                            else if (source[pos] === '}')
+                                td--;
+                            pos++;
+                        }
+                        continue;
+                    }
+                    pos++;
+                }
+            }
+            else if (ch === '/' && source[pos + 1] === '/') {
+                while (pos < source.length && source[pos] !== '\n')
+                    pos++;
+            }
+            else if (ch === '/' && source[pos + 1] === '*') {
+                pos += 2;
+                while (pos < source.length - 1 && !(source[pos] === '*' && source[pos + 1] === '/'))
+                    pos++;
+                pos++;
+            }
+            pos++;
+        }
+        if (depth === 0)
+            ranges.push([openBrace, pos]);
+    }
+    return ranges;
+}
 /**
  * Find variable reassignments (not declarations) and return insertions for tracing.
  * Handles: x = newValue; x += 1; x ||= fallback; etc.
@@ -513,6 +581,8 @@ function extractDestructuredNames(pattern) {
  */
 function findReassignments(source) {
     const results = [];
+    // Pre-compute class body ranges to skip class field declarations
+    const classRanges = findClassBodyRanges(source);
     // Match: <identifier> <assignOp>= <value> at the start of a line
     // Compound operators: +=, -=, *=, /=, %=, **=, &&=, ||=, ??=, <<=, >>=, >>>=, &=, |=, ^=
     // Plain: = (but not ==, ===, =>, !=)
@@ -548,6 +618,10 @@ function findReassignments(source) {
         const linePrefix = source.slice(lineStart, match.index + match[1].length).trim();
         if (/^(export\s+)?(const|let|var)\s/.test(source.slice(lineStart).trimStart()))
             continue;
+        // Skip class field declarations (e.g., `tasks = []` inside a class body)
+        // Inserting trace calls inside class bodies causes SyntaxError
+        if (classRanges.some(([start, end]) => match.index > start && match.index < end))
+            continue;
         // Skip if this looks like a property in an object literal (preceded by a key: pattern on same line)
         // or if it's a label (label: ...)
         const beforeOnLine = source.slice(lineStart, match.index).trim();
@@ -1530,7 +1604,7 @@ ingestUrl) {
     }
     // 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 || catchInsertions.length > 0 || funcParamInsertions.length > 0 || jsxExprInsertions.length > 0) {
-        prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Map();`, `  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 sample = _sanitize(v, 2);`, `      const sv = typeof v === 'object' && v !== null ? JSON.stringify(sample).substring(0, 60) : String(v).substring(0, 60);`, `      const ck = file + ':' + l + ':' + n;`, `      const prev = _cache.get(ck);`, `      const now = Date.now();`, `      if (prev && prev.sv === sv && now - prev.ts < 5000) return;`, `      _cache.set(ck, { sv: sv, ts: now });`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: sample }));`, `    } catch(e) {}`, `  };`, `}`, `function __trickle_tv(v, n, l) { try { globalThis.__trickle_var_tracer(v, n, l, ${JSON.stringify(moduleName)}, ${JSON.stringify(filename)}); } catch(e) {} }`);
+        prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Map();`, `  const _sampleCount = new Map();`, `  const _MAX_SAMPLES = 5;`, `  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 sample = _sanitize(v, 2);`, `      const sv = typeof v === 'object' && v !== null ? JSON.stringify(sample).substring(0, 60) : String(v).substring(0, 60);`, `      const ck = file + ':' + l + ':' + n;`, `      const cnt = _sampleCount.get(ck) || 0;`, `      if (cnt >= _MAX_SAMPLES) return;`, `      const prev = _cache.get(ck);`, `      const now = Date.now();`, `      if (prev && prev.sv === sv && now - prev.ts < 5000) return;`, `      _cache.set(ck, { sv: sv, ts: now });`, `      _sampleCount.set(ck, cnt + 1);`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: sample }));`, `    } 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
     if (bodyInsertions.length > 0 || conciseBodyInsertions.length > 0) {

package/dist-esm/vite-plugin.js

@@ -492,6 +492,73 @@ function extractDestructuredNames(pattern) {
     }
     return names;
 }
+/**
+ * Find class body ranges in source code. Handles both:
+ *   class Foo { ... }
+ *   var Foo = class { ... }
+ * Returns an array of [start, end] positions (inclusive of braces).
+ */
+export function findClassBodyRanges(source) {
+    const ranges = [];
+    // Match both class declarations and class expressions
+    const classRegex = /\bclass\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*)?\s*(?:extends\s+[a-zA-Z_$.[\]]+\s*)?\{/g;
+    let m;
+    while ((m = classRegex.exec(source)) !== null) {
+        const openBrace = source.indexOf('{', m.index + 5); // skip past 'class'
+        if (openBrace === -1)
+            continue;
+        // Find matching close brace
+        let depth = 1;
+        let pos = openBrace + 1;
+        while (pos < source.length && depth > 0) {
+            const ch = source[pos];
+            if (ch === '{')
+                depth++;
+            else if (ch === '}') {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+            else if (ch === '"' || ch === "'" || ch === '`') {
+                const q = ch;
+                pos++;
+                while (pos < source.length) {
+                    if (source[pos] === '\\')
+                        pos++;
+                    else if (source[pos] === q)
+                        break;
+                    else if (q === '`' && source[pos] === '$' && source[pos + 1] === '{') {
+                        pos += 2;
+                        let td = 1;
+                        while (pos < source.length && td > 0) {
+                            if (source[pos] === '{')
+                                td++;
+                            else if (source[pos] === '}')
+                                td--;
+                            pos++;
+                        }
+                        continue;
+                    }
+                    pos++;
+                }
+            }
+            else if (ch === '/' && source[pos + 1] === '/') {
+                while (pos < source.length && source[pos] !== '\n')
+                    pos++;
+            }
+            else if (ch === '/' && source[pos + 1] === '*') {
+                pos += 2;
+                while (pos < source.length - 1 && !(source[pos] === '*' && source[pos + 1] === '/'))
+                    pos++;
+                pos++;
+            }
+            pos++;
+        }
+        if (depth === 0)
+            ranges.push([openBrace, pos]);
+    }
+    return ranges;
+}
 /**
  * Find variable reassignments (not declarations) and return insertions for tracing.
  * Handles: x = newValue; x += 1; x ||= fallback; etc.
@@ -501,6 +568,8 @@ function extractDestructuredNames(pattern) {
  */
 export function findReassignments(source) {
     const results = [];
+    // Pre-compute class body ranges to skip class field declarations
+    const classRanges = findClassBodyRanges(source);
     // Match: <identifier> <assignOp>= <value> at the start of a line
     // Compound operators: +=, -=, *=, /=, %=, **=, &&=, ||=, ??=, <<=, >>=, >>>=, &=, |=, ^=
     // Plain: = (but not ==, ===, =>, !=)
@@ -536,6 +605,10 @@ export function findReassignments(source) {
         const linePrefix = source.slice(lineStart, match.index + match[1].length).trim();
         if (/^(export\s+)?(const|let|var)\s/.test(source.slice(lineStart).trimStart()))
             continue;
+        // Skip class field declarations (e.g., `tasks = []` inside a class body)
+        // Inserting trace calls inside class bodies causes SyntaxError
+        if (classRanges.some(([start, end]) => match.index > start && match.index < end))
+            continue;
         // Skip if this looks like a property in an object literal (preceded by a key: pattern on same line)
         // or if it's a label (label: ...)
         const beforeOnLine = source.slice(lineStart, match.index).trim();
@@ -1518,7 +1591,7 @@ ingestUrl) {
     }
     // 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 || catchInsertions.length > 0 || funcParamInsertions.length > 0 || jsxExprInsertions.length > 0) {
-        prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Map();`, `  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 sample = _sanitize(v, 2);`, `      const sv = typeof v === 'object' && v !== null ? JSON.stringify(sample).substring(0, 60) : String(v).substring(0, 60);`, `      const ck = file + ':' + l + ':' + n;`, `      const prev = _cache.get(ck);`, `      const now = Date.now();`, `      if (prev && prev.sv === sv && now - prev.ts < 5000) return;`, `      _cache.set(ck, { sv: sv, ts: now });`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: sample }));`, `    } catch(e) {}`, `  };`, `}`, `function __trickle_tv(v, n, l) { try { globalThis.__trickle_var_tracer(v, n, l, ${JSON.stringify(moduleName)}, ${JSON.stringify(filename)}); } catch(e) {} }`);
+        prefixLines.push(`if (!globalThis.__trickle_var_tracer) {`, `  const _cache = new Map();`, `  const _sampleCount = new Map();`, `  const _MAX_SAMPLES = 5;`, `  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 sample = _sanitize(v, 2);`, `      const sv = typeof v === 'object' && v !== null ? JSON.stringify(sample).substring(0, 60) : String(v).substring(0, 60);`, `      const ck = file + ':' + l + ':' + n;`, `      const cnt = _sampleCount.get(ck) || 0;`, `      if (cnt >= _MAX_SAMPLES) return;`, `      const prev = _cache.get(ck);`, `      const now = Date.now();`, `      if (prev && prev.sv === sv && now - prev.ts < 5000) return;`, `      _cache.set(ck, { sv: sv, ts: now });`, `      _sampleCount.set(ck, cnt + 1);`, `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: sample }));`, `    } 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
     if (bodyInsertions.length > 0 || conciseBodyInsertions.length > 0) {

package/package.json

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

package/src/trace-var.ts

@@ -26,6 +26,9 @@ let debugMode = false;
 
 /** Cache: "file:line:varName" → { fingerprint, timestamp } for value-aware dedup */
 const varCache = new Map<string, { fp: string; ts: number }>();
+/** Per-line sample count to avoid loop variable spam */
+const sampleCount = new Map<string, number>();
+const MAX_SAMPLES_PER_LINE = 5;
 
 /** Batch buffer for writing — avoids one fs.appendFileSync per variable */
 let varBuffer: string[] = [];
@@ -92,8 +95,12 @@ export function traceVar(
     const dummyArgs: TypeNode = { kind: 'tuple', elements: [] };
     const typeHash = hashType(dummyArgs, type);
 
-    // Value-aware dedup: re-send if value changed or 10s elapsed
+    // Per-line sample count limit: stop after N samples to avoid loop spam
     const cacheKey = `${filePath}:${line}:${varName}`;
+    const cnt = sampleCount.get(cacheKey) || 0;
+    if (cnt >= MAX_SAMPLES_PER_LINE) return;
+
+    // Value-aware dedup: re-send if value changed or 10s elapsed
     const t = typeof value;
     const fp = (t === 'string' || t === 'number' || t === 'boolean' || value === null || value === undefined)
       ? String(value).substring(0, 60)
@@ -102,6 +109,7 @@ export function traceVar(
     const prev = varCache.get(cacheKey);
     if (prev && prev.fp === fp && (now - prev.ts) < 10000) return;
     varCache.set(cacheKey, { fp, ts: now });
+    sampleCount.set(cacheKey, cnt + 1);
 
     const sample = sanitizeVarSample(value);
 

package/src/vite-plugin.ts

@@ -472,6 +472,57 @@ function extractDestructuredNames(pattern: string): string[] {
   return names;
 }
 
+/**
+ * Find class body ranges in source code. Handles both:
+ *   class Foo { ... }
+ *   var Foo = class { ... }
+ * Returns an array of [start, end] positions (inclusive of braces).
+ */
+export function findClassBodyRanges(source: string): Array<[number, number]> {
+  const ranges: Array<[number, number]> = [];
+  // Match both class declarations and class expressions
+  const classRegex = /\bclass\s*(?:[a-zA-Z_$][a-zA-Z0-9_$]*)?\s*(?:extends\s+[a-zA-Z_$.[\]]+\s*)?\{/g;
+  let m;
+  while ((m = classRegex.exec(source)) !== null) {
+    const openBrace = source.indexOf('{', m.index + 5); // skip past 'class'
+    if (openBrace === -1) continue;
+    // Find matching close brace
+    let depth = 1;
+    let pos = openBrace + 1;
+    while (pos < source.length && depth > 0) {
+      const ch = source[pos];
+      if (ch === '{') depth++;
+      else if (ch === '}') { depth--; if (depth === 0) break; }
+      else if (ch === '"' || ch === "'" || ch === '`') {
+        const q = ch; pos++;
+        while (pos < source.length) {
+          if (source[pos] === '\\') pos++;
+          else if (source[pos] === q) break;
+          else if (q === '`' && source[pos] === '$' && source[pos + 1] === '{') {
+            pos += 2; let td = 1;
+            while (pos < source.length && td > 0) {
+              if (source[pos] === '{') td++;
+              else if (source[pos] === '}') td--;
+              pos++;
+            }
+            continue;
+          }
+          pos++;
+        }
+      } else if (ch === '/' && source[pos + 1] === '/') {
+        while (pos < source.length && source[pos] !== '\n') pos++;
+      } else if (ch === '/' && source[pos + 1] === '*') {
+        pos += 2;
+        while (pos < source.length - 1 && !(source[pos] === '*' && source[pos + 1] === '/')) pos++;
+        pos++;
+      }
+      pos++;
+    }
+    if (depth === 0) ranges.push([openBrace, pos]);
+  }
+  return ranges;
+}
+
 /**
  * Find variable reassignments (not declarations) and return insertions for tracing.
  * Handles: x = newValue; x += 1; x ||= fallback; etc.
@@ -481,6 +532,8 @@ function extractDestructuredNames(pattern: string): string[] {
  */
 export function findReassignments(source: string): Array<{ lineEnd: number; varName: string; lineNo: number }> {
   const results: Array<{ lineEnd: number; varName: string; lineNo: number }> = [];
+  // Pre-compute class body ranges to skip class field declarations
+  const classRanges = findClassBodyRanges(source);
 
   // Match: <identifier> <assignOp>= <value> at the start of a line
   // Compound operators: +=, -=, *=, /=, %=, **=, &&=, ||=, ??=, <<=, >>=, >>>=, &=, |=, ^=
@@ -513,6 +566,10 @@ export function findReassignments(source: string): Array<{ lineEnd: number; varN
     const linePrefix = source.slice(lineStart, match.index + match[1].length).trim();
     if (/^(export\s+)?(const|let|var)\s/.test(source.slice(lineStart).trimStart())) continue;
 
+    // Skip class field declarations (e.g., `tasks = []` inside a class body)
+    // Inserting trace calls inside class bodies causes SyntaxError
+    if (classRanges.some(([start, end]) => match!.index > start && match!.index < end)) continue;
+
     // Skip if this looks like a property in an object literal (preceded by a key: pattern on same line)
     // or if it's a label (label: ...)
     const beforeOnLine = source.slice(lineStart, match.index).trim();
@@ -1567,6 +1624,8 @@ export function transformEsmSource(
     prefixLines.push(
       `if (!globalThis.__trickle_var_tracer) {`,
       `  const _cache = new Map();`,
+      `  const _sampleCount = new Map();`,
+      `  const _MAX_SAMPLES = 5;`,
       `  function _inferType(v, d) {`,
       `    if (d <= 0) return { kind: 'primitive', name: 'unknown' };`,
       `    if (v === null) return { kind: 'primitive', name: 'null' };`,
@@ -1603,10 +1662,13 @@ export function transformEsmSource(
       `      const sample = _sanitize(v, 2);`,
       `      const sv = typeof v === 'object' && v !== null ? JSON.stringify(sample).substring(0, 60) : String(v).substring(0, 60);`,
       `      const ck = file + ':' + l + ':' + n;`,
+      `      const cnt = _sampleCount.get(ck) || 0;`,
+      `      if (cnt >= _MAX_SAMPLES) return;`,
       `      const prev = _cache.get(ck);`,
       `      const now = Date.now();`,
       `      if (prev && prev.sv === sv && now - prev.ts < 5000) return;`,
       `      _cache.set(ck, { sv: sv, ts: now });`,
+      `      _sampleCount.set(ck, cnt + 1);`,
       `      __trickle_send(JSON.stringify({ kind: 'variable', varName: n, line: l, module: mod, file: file, type: type, typeHash: th, sample: sample }));`,
       `    } catch(e) {}`,
       `  };`,