@djangocfg/devtools 2.1.569 → 2.1.570

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/devtools",
-  "version": "2.1.569",
+  "version": "2.1.570",
   "description": "Frontend devtools for django-cfg apps: error/console capture with backend ingest, plus a floating debug panel. One package, one event stream.",
   "keywords": [
     "django",
@@ -51,16 +51,16 @@
     "test:watch": "vitest"
   },
   "peerDependencies": {
-    "@djangocfg/ui-core": "^2.1.569",
+    "@djangocfg/ui-core": "^2.1.570",
     "lucide-react": ">=0.400.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zustand": "^5.0.0"
   },
   "devDependencies": {
-    "@djangocfg/eslint-config": "^2.1.569",
-    "@djangocfg/typescript-config": "^2.1.569",
-    "@djangocfg/ui-core": "^2.1.569",
+    "@djangocfg/eslint-config": "^2.1.570",
+    "@djangocfg/typescript-config": "^2.1.570",
+    "@djangocfg/ui-core": "^2.1.570",
     "@storybook/react-vite": "^10.5.0",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",

package/src/__tests__/isStreamingRuntimeNoise.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+
+import { isStreamingRuntimeNoise } from '../capture';
+
+/**
+ * React's inline streaming scripts fail only when something outside the app
+ * removed the hidden segment first. The stacks below are verbatim from
+ * carapis.com's monitor log, 2026-09-23.
+ */
+describe('isStreamingRuntimeNoise', () => {
+  it('drops a $RS failure', () => {
+    const stack =
+      "TypeError: Cannot read properties of null (reading 'parentNode')\n" +
+      '    at $RS (https://carapis.com/catalog/genesis/eq900/c2d25771/:2:3330)\n' +
+      '    at https://carapis.com/catalog/genesis/eq900/c2d25771/:3:77605';
+    expect(isStreamingRuntimeNoise(stack)).toBe(true);
+  });
+
+  it('drops a $RC failure', () => {
+    expect(
+      isStreamingRuntimeNoise("TypeError: x\n    at $RC (https://a.test/:2:10)\n    at https://a.test/:9:1"),
+    ).toBe(true);
+  });
+
+  it('keeps an app error whose top frame is the app', () => {
+    const stack =
+      "TypeError: Cannot read properties of null (reading 'parentNode')\n" +
+      '    at Gallery (https://carapis.com/_next/static/chunks/abc.js:1:200)\n' +
+      '    at $RS (https://carapis.com/x/:2:3330)';
+    expect(isStreamingRuntimeNoise(stack)).toBe(false);
+  });
+
+  it('keeps an app function that merely starts with $R', () => {
+    expect(isStreamingRuntimeNoise('Error\n    at $Router (https://a.test/app.js:1:1)')).toBe(false);
+  });
+
+  it('keeps an event with no stack', () => {
+    expect(isStreamingRuntimeNoise(undefined)).toBe(false);
+    expect(isStreamingRuntimeNoise('')).toBe(false);
+  });
+});

package/src/capture.ts

@@ -31,9 +31,31 @@ const LIBRARY_NOISE: RegExp[] = [
   /input-otp could not insert CSS rule/i,
 ]
 
+// React's streaming-SSR runtime: the inline `$RS` (reveal segment), `$RC`
+// (complete boundary) and kin that the server writes into the HTML to move
+// each late chunk from its `<div hidden id="S:n">` into its placeholder.
+// They throw only when that hidden element is already gone — something
+// outside the app rewrote the document before the stream finished (a
+// headless scraper stripping hidden nodes, a reader-mode or translation
+// rewrite). The frame is React's, never the app's, and nothing on the page
+// can fix it. Measured on carapis.com, 2026-09-23: 19,381 events in a day,
+// 99.9% from one fixed "Chrome/145" user agent, each page load failing all
+// 19 of its `$RS` calls at once — while a real browser on the same URL
+// raised none.
+const STREAMING_RUNTIME_FRAME = /^\s*at \$R[A-Z]{1,2} \(/m
+
+export function isStreamingRuntimeNoise(stack?: string): boolean {
+  if (!stack) return false
+  // The TOP frame only: an app error that merely passed through a streamed
+  // chunk still has its own frame first, and must still be reported.
+  const firstFrame = stack.split('\n').find((line) => /^\s*at /.test(line))
+  return firstFrame !== undefined && STREAMING_RUNTIME_FRAME.test(firstFrame)
+}
+
 function isNoise(msg: string, stack?: string): boolean {
   if (HYDRATION_NOISE.some((p) => p.test(msg))) return true
   if (LIBRARY_NOISE.some((p) => p.test(msg))) return true
+  if (isStreamingRuntimeNoise(stack)) return true
   // Our own transport failing must never loop back into capture.
   return INGEST_PATTERN.test(msg) || INGEST_PATTERN.test(stack ?? '')
 }