@lensmcp/bridge 1.16.30 → 1.16.31

package/lib/env-sink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-sink.d.ts","sourceRoot":"","sources":["../../src/lib/env-sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAa1C,wBAAgB,cAAc,IAAI,OAAO,GAAG,IAAI,CAsC/C;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDhD"}
+{"version":3,"file":"env-sink.d.ts","sourceRoot":"","sources":["../../src/lib/env-sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAwF1C,wBAAgB,cAAc,IAAI,OAAO,GAAG,IAAI,CA6C/C;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgDhD"}

package/lib/env-sink.js

@@ -1,6 +1,92 @@
 import { connect } from 'node:net';
 import { createSocket } from 'node:dgram';
-import { appendFileSync } from 'node:fs';
+import { appendFileSync, renameSync, statSync, unlinkSync } from 'node:fs';
+// ---- file-sink hygiene — mirrors @lensmcp/node-instrumentation's emit.ts contract ------------------
+// (bridge deliberately has no dep on node-instrumentation, so the ~40 lines are mirrored, same env
+// vars.) Browser producers are the highest-volume writers on the bus — a valtio store churning per
+// frame or a fetch retry loop must not grow events.jsonl unboundedly (2026-07-28: ~680 ev/s, 254 MB
+// in 2h, every ingesting consumer OOM-crash-looped). Per-fingerprint token bucket + round-robin
+// rotation: live file caps at MAX_EVENT_BYTES, history kept as `.1` … `.N`, oldest dropped.
+/** Same cap contract as emit.ts: `LENSMCP_EVENT_MAX_BYTES` (default 50 MB) per generation. */
+const MAX_EVENT_BYTES = (() => {
+    const n = Number(process.env['LENSMCP_EVENT_MAX_BYTES']);
+    return Number.isFinite(n) && n > 0 ? n : 50 * 1024 * 1024;
+})();
+/** Same history contract as emit.ts: `LENSMCP_EVENT_MAX_FILES` rotated generations (default 5). */
+const MAX_EVENT_FILES = (() => {
+    const n = Number(process.env['LENSMCP_EVENT_MAX_FILES']);
+    return Number.isFinite(n) && n >= 1 && n <= 20 ? Math.floor(n) : 5;
+})();
+const ROTATE_CHECK_BYTES = 1024 * 1024; // stat at most ~once per MB appended
+let bytesSinceCheck = 0;
+function rotateIfLarge(file, addedBytes) {
+    bytesSinceCheck += addedBytes;
+    if (bytesSinceCheck < ROTATE_CHECK_BYTES)
+        return;
+    bytesSinceCheck = 0;
+    try {
+        if (statSync(file).size <= MAX_EVENT_BYTES)
+            return;
+    }
+    catch {
+        return; /* missing / already rotated by a concurrent writer — fine */
+    }
+    try {
+        unlinkSync(`${file}.${MAX_EVENT_FILES}`); // drop the oldest generation
+    }
+    catch { /* none to drop */ }
+    for (let gen = MAX_EVENT_FILES - 1; gen >= 1; gen--) {
+        try {
+            renameSync(`${file}.${gen}`, `${file}.${gen + 1}`);
+        }
+        catch { /* gap in history */ }
+    }
+    try {
+        renameSync(file, `${file}.1`);
+    }
+    catch { /* lost the rotate race — a concurrent cascade ran */ }
+}
+/** Per-fingerprint token bucket (burst 30, then 5/s; `LENSMCP_EVENT_MAX_EPS` overrides, 0/'off' disables). */
+const FLOOD_PER_SEC = (() => {
+    const raw = process.env['LENSMCP_EVENT_MAX_EPS'];
+    if (raw === 'off')
+        return Infinity;
+    const n = Number(raw);
+    if (raw !== undefined && raw !== '' && Number.isFinite(n))
+        return n <= 0 ? Infinity : n;
+    return 5;
+})();
+const FLOOD_BURST = Math.max(30, FLOOD_PER_SEC === Infinity ? 0 : FLOOD_PER_SEC * 4);
+const floodBuckets = new Map();
+/** Returns `-1` to drop, else the suppressed-since-last-admit count to annotate (0 normally). */
+function floodAdmit(fingerprint) {
+    if (FLOOD_PER_SEC === Infinity)
+        return 0;
+    const now = Date.now();
+    let b = floodBuckets.get(fingerprint);
+    if (!b) {
+        if (floodBuckets.size >= 2048) {
+            for (const [k, v] of floodBuckets)
+                if (now - v.lastSeenAt > 60_000)
+                    floodBuckets.delete(k);
+            if (floodBuckets.size >= 2048)
+                floodBuckets.clear();
+        }
+        b = { tokens: FLOOD_BURST, lastRefillAt: now, suppressed: 0, lastSeenAt: now };
+        floodBuckets.set(fingerprint, b);
+    }
+    b.lastSeenAt = now;
+    b.tokens = Math.min(FLOOD_BURST, b.tokens + ((now - b.lastRefillAt) / 1000) * FLOOD_PER_SEC);
+    b.lastRefillAt = now;
+    if (b.tokens >= 1) {
+        b.tokens -= 1;
+        const suppressed = b.suppressed;
+        b.suppressed = 0;
+        return suppressed;
+    }
+    b.suppressed += 1;
+    return -1;
+}
 /**
  * Resolve a cross-process event sink from env, mirroring
  * `@lensmcp/nest-instrumentation`'s `defaultEventSink` so every producer
@@ -18,7 +104,12 @@ export function resolveEnvSink() {
     if (filePath) {
         cachedEnvSink = (event) => {
             try {
-                appendFileSync(filePath, JSON.stringify(event) + '\n');
+                const suppressed = floodAdmit(event.fingerprint);
+                if (suppressed < 0)
+                    return; // flood-guarded — next admitted event carries the count
+                const line = JSON.stringify(suppressed > 0 ? { ...event, raw: { ...(event.raw ?? {}), floodSuppressed: suppressed } } : event) + '\n';
+                rotateIfLarge(filePath, line.length);
+                appendFileSync(filePath, line);
             }
             catch {
                 /* swallow */

package/package.json

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