@rangojs/router 0.0.0-experimental.preview.1774284415 → 0.0.0-experimental.preview.1774295099

package/dist/vite/index.js

@@ -1745,7 +1745,7 @@ import { resolve } from "node:path";
 // package.json
 var package_default = {
   name: "@rangojs/router",
-  version: "0.0.0-experimental.preview.1774284415",
+  version: "0.0.0-experimental.preview.1774295099",
   description: "Django-inspired RSC router with composable URL patterns",
   keywords: [
     "react",
@@ -2895,7 +2895,8 @@ function performanceTracksPlugin() {
       const flushBrowserDoneIfReady = (debugId, session) => {
         if (!session.ended || !session.ready || session.browserDoneSent) return;
         session.browserDoneSent = true;
-        sendBatch(debugId, [], true);
+        const chunks = session.pendingClientChunks.splice(0);
+        sendBatch(debugId, chunks, true);
       };
       const closeRuntimeWaiters = (session) => {
         const waiters = session.waiters.splice(0);
@@ -2944,20 +2945,7 @@ function performanceTracksPlugin() {
             return;
           }
           const chunk = await readRequestBody(req);
-          if (chunk.byteLength <= 3) {
-            console.log(
-              "[perf-tracks] writable: chunk size:",
-              chunk.byteLength,
-              "for",
-              debugId.slice(0, 8),
-              session.ready ? "(sent)" : "(buffered)"
-            );
-          }
-          if (session.ready) {
-            sendChunk(debugId, chunk);
-          } else {
-            session.pendingClientChunks.push(chunk);
-          }
+          session.pendingClientChunks.push(chunk);
           res.statusCode = 204;
           res.end();
           return;
@@ -3047,13 +3035,7 @@ function performanceTracksPlugin() {
           "ended:",
           ended
         );
-        if (pending > 0 || ended) {
-          const chunks = session.pendingClientChunks.splice(0);
-          if (ended) {
-            session.browserDoneSent = true;
-          }
-          sendBatch(payload.i, chunks, ended);
-        }
+        flushBrowserDoneIfReady(payload.i, session);
         cleanupIfSettled(payload.i, session);
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rangojs/router",
-  "version": "0.0.0-experimental.preview.1774284415",
+  "version": "0.0.0-experimental.preview.1774295099",
   "description": "Django-inspired RSC router with composable URL patterns",
   "keywords": [
     "react",

package/src/browser/rsc-router.tsx

@@ -141,24 +141,15 @@ export async function initBrowserApp(
     initialTheme,
   } = options;
 
-  // Dev-only: create debug channel for React Performance Tracks.
-  // The debugId was injected into the HTML bootstrap by the SSR handler.
-  // The client sends a "ready" signal so the server flushes buffered data.
-  const ssrDebugId = (globalThis as any).__RANGO_DEBUG_ID__ as
-    | string
-    | undefined;
-  const ssrDebugChannel =
-    ssrDebugId && (import.meta as any).hot
-      ? createClientDebugChannel(ssrDebugId)
-      : undefined;
-
   // Load initial payload from SSR-injected __FLIGHT_DATA__
-  const initialPayload = await deps.createFromReadableStream<RscPayload>(
-    rscStream,
-    ssrDebugChannel
-      ? { debugChannel: ssrDebugChannel, findSourceMapURL }
-      : undefined,
-  );
+  // Note: debug channel is NOT used for hydration. The WS transport is
+  // unreliable during initial page load (JS loads after server finishes
+  // rendering, so the "ready" signal arrives too late and chunks are dropped).
+  // If createFromReadableStream hangs on a stalled debug stream, the entire
+  // app never initializes — blocking all subsequent SPA navigations.
+  // Server Component tracks are available for SPA navigations instead.
+  const initialPayload =
+    await deps.createFromReadableStream<RscPayload>(rscStream);
 
   // Extract themeConfig and initialTheme from payload if not explicitly provided
   // This allows virtual entries to work without importing the router

package/src/vite/plugins/performance-tracks.ts

@@ -316,8 +316,9 @@ export function performanceTracksPlugin(): Plugin {
       ) => {
         if (!session.ended || !session.ready || session.browserDoneSent) return;
         session.browserDoneSent = true;
-        // Send empty batch with done flag
-        sendBatch(debugId, [], true);
+        // Send ALL buffered chunks + done in one WS message
+        const chunks = session.pendingClientChunks.splice(0);
+        sendBatch(debugId, chunks, true);
       };
 
       const closeRuntimeWaiters = (session: DebugSession) => {
@@ -378,21 +379,10 @@ export function performanceTracksPlugin(): Plugin {
             return;
           }
 
+          // Always buffer — we flush everything as one batch when "done" arrives.
+          // Individual hot.send calls during request handling are unreliable.
           const chunk = await readRequestBody(req);
-          if (chunk.byteLength <= 3) {
-            console.log(
-              "[perf-tracks] writable: chunk size:",
-              chunk.byteLength,
-              "for",
-              debugId.slice(0, 8),
-              session.ready ? "(sent)" : "(buffered)",
-            );
-          }
-          if (session.ready) {
-            sendChunk(debugId, chunk);
-          } else {
-            session.pendingClientChunks.push(chunk);
-          }
+          session.pendingClientChunks.push(chunk);
           res.statusCode = 204;
           res.end();
           return;
@@ -488,7 +478,9 @@ export function performanceTracksPlugin(): Plugin {
           return;
         }
 
-        // Ready signal — flush all pending chunks as one batch
+        // Ready signal — mark session as ready.
+        // Chunks are NOT flushed here. We wait for "done" from the server
+        // and send everything in one reliable batch.
         session.ready = true;
         const pending = session.pendingClientChunks.length;
         const ended = session.ended;
@@ -500,14 +492,8 @@ export function performanceTracksPlugin(): Plugin {
           "ended:",
           ended,
         );
-        if (pending > 0 || ended) {
-          // Send everything in one WS message
-          const chunks = session.pendingClientChunks.splice(0);
-          if (ended) {
-            session.browserDoneSent = true;
-          }
-          sendBatch(payload.i, chunks, ended);
-        }
+        // If server already finished, flush now
+        flushBrowserDoneIfReady(payload.i, session);
         cleanupIfSettled(payload.i, session);
       });
     },