@timber-js/app 0.2.0-alpha.236 → 0.2.0-alpha.237

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/dist/_chunks/{flight-source-node-BO_xD9jC.js → flight-source-node-BsrlUjMO.js} +7 -3
  2. package/dist/_chunks/flight-source-node-BsrlUjMO.js.map +1 -0
  3. package/dist/_chunks/{node-response-DNNnKnoS.js → node-response-omewa8e6.js} +20 -3
  4. package/dist/_chunks/node-response-omewa8e6.js.map +1 -0
  5. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -1
  6. package/dist/native/rsc/server/abort-scope.js +6 -2
  7. package/dist/native/rsc/server/abort-scope.js.map +1 -1
  8. package/dist/native/rsc/server/flight-source-node.js +6 -2
  9. package/dist/native/rsc/server/flight-source-node.js.map +1 -1
  10. package/dist/native/rsc/server/pipeline-helpers.js +2 -2
  11. package/dist/native/rsc/server/pipeline-helpers.js.map +1 -1
  12. package/dist/native/rsc/server/pipeline-metadata-route.js +2 -2
  13. package/dist/native/rsc/server/pipeline-metadata-route.js.map +1 -1
  14. package/dist/native/rsc/server/render-timeout.js.map +1 -1
  15. package/dist/native/rsc/server/safe-load.js +14 -2
  16. package/dist/native/rsc/server/safe-load.js.map +1 -1
  17. package/dist/native/ssr/server/abort-scope.js +6 -2
  18. package/dist/native/ssr/server/abort-scope.js.map +1 -1
  19. package/dist/native/ssr/server/flight-source-node.js +6 -2
  20. package/dist/native/ssr/server/flight-source-node.js.map +1 -1
  21. package/dist/native/ssr/server/pipeline-helpers.js +2 -2
  22. package/dist/native/ssr/server/pipeline-helpers.js.map +1 -1
  23. package/dist/native/ssr/server/pipeline-metadata-route.js +2 -2
  24. package/dist/native/ssr/server/pipeline-metadata-route.js.map +1 -1
  25. package/dist/native/ssr/server/render-timeout.js +3 -4
  26. package/dist/native/ssr/server/render-timeout.js.map +1 -1
  27. package/dist/native/ssr/server/safe-load.js +10 -1
  28. package/dist/native/ssr/server/safe-load.js.map +1 -1
  29. package/dist/server/abort-scope.d.ts +7 -0
  30. package/dist/server/abort-scope.d.ts.map +1 -1
  31. package/dist/server/flight-source-node.d.ts.map +1 -1
  32. package/dist/server/internal.js +45 -5
  33. package/dist/server/internal.js.map +1 -1
  34. package/dist/server/render-timeout.d.ts.map +1 -1
  35. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  36. package/dist/server/safe-load.d.ts +22 -0
  37. package/dist/server/safe-load.d.ts.map +1 -1
  38. package/package.json +1 -1
  39. package/src/server/abort-scope.ts +20 -1
  40. package/src/server/flight-source-node.ts +11 -2
  41. package/src/server/pipeline-helpers.ts +2 -2
  42. package/src/server/pipeline-metadata-route.ts +2 -2
  43. package/src/server/render-timeout.ts +8 -5
  44. package/src/server/rsc-entry/index.ts +5 -0
  45. package/src/server/safe-load.ts +53 -1
  46. package/dist/_chunks/flight-source-node-BO_xD9jC.js.map +0 -1
  47. package/dist/_chunks/node-response-DNNnKnoS.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"render-timeout.d.ts","sourceRoot":"","sources":["../../src/server/render-timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE7E;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAO9C;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,aAAa,CAwBhG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAWZ"}
1
+ {"version":3,"file":"render-timeout.d.ts","sourceRoot":"","sources":["../../src/server/render-timeout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE7E;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,YAAY,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAO9C;CACF;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,aAAa,CA2BhG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,CAAC,CAWZ"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/index.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AA4FlE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAkWD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,wBAAwB,EAAE,cAAc,GACvD,OAAO,CAAC,OAAO,wBAAwB,EAAE,cAAc,CAAC,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,wBAAwB,EAAE,uBAAuB,GAChE,OAAO,CAAC,OAAO,wBAAwB,EAAE,uBAAuB,CAAC,CAQnE;8BA4CoB,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/index.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AA6FlE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAkWD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAInE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAItE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,wBAAwB,EAAE,cAAc,GACvD,OAAO,CAAC,OAAO,wBAAwB,EAAE,cAAc,CAAC,CAE1D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,wBAAwB,EAAE,uBAAuB,GAChE,OAAO,CAAC,OAAO,wBAAwB,EAAE,uBAAuB,CAAC,CAQnE;8BA4CoB,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC"}
@@ -27,12 +27,34 @@ export declare class ModuleLoadError extends Error {
27
27
  readonly filePath: string;
28
28
  constructor(filePath: string, cause: unknown);
29
29
  }
30
+ /**
31
+ * Declare that route modules cannot change for the life of the process: no
32
+ * dev server's HMR can swap them. Called by the RSC entry when
33
+ * `import.meta.hot` is unset (a built server). Never call it under a dev
34
+ * server, whatever NODE_ENV says.
35
+ */
36
+ export declare function markRouteModulesImmutable(): void;
30
37
  /**
31
38
  * Load a route manifest module with enriched error context.
32
39
  *
33
40
  * On success: returns the module object (same as `loader.load()`).
34
41
  * On failure: throws `ModuleLoadError` with file path and original cause.
35
42
  *
43
+ * Production builds cache the module per loader. A dev server never does,
44
+ * whatever NODE_ENV says: HMR depends on each request re-importing, so an
45
+ * edited file is picked up, and the manifest (with its loader objects) is
46
+ * not re-evaluated when a route file changes. Both must hold:
47
+ *
48
+ * - `process.env.NODE_ENV === 'production'`, which the server build defines
49
+ * for every adapter, Workers included (plugins/server-bundle.ts). It also
50
+ * keeps vitest (`test`) from caching.
51
+ * - {@link markRouteModulesImmutable} was called. `import.meta.hot` is what
52
+ * says HMR can swap modules, and a dev server started with
53
+ * NODE_ENV=production still has it, but runtime modules cannot read it
54
+ * (they may load outside Vite's module runner, design/51 §"Boundary"), so
55
+ * the RSC entry reads it and calls this, as rsc-entry/ssr-bridge.ts gates
56
+ * the SSR entry.
57
+ *
36
58
  * Error rendering paths that need fallthrough use `loadFallbackModule()`.
37
59
  */
38
60
  export declare function loadModule<T = Record<string, unknown>>(loader: ManifestLoader): Promise<T>;
@@ -1 +1 @@
1
- {"version":3,"file":"safe-load.d.ts","sourceRoot":"","sources":["../../src/server/safe-load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAK3C;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAMhG"}
1
+ {"version":3,"file":"safe-load.d.ts","sourceRoot":"","sources":["../../src/server/safe-load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAK3C;CACF;AAsBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAahG"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@timber-js/app",
3
- "version": "0.2.0-alpha.236",
3
+ "version": "0.2.0-alpha.237",
4
4
  "description": "Vite-native React framework built for Servers and Serverless Platforms — correct HTTP semantics, real status codes, pages that work without JavaScript",
5
5
  "keywords": [
6
6
  "cloudflare-workers",
@@ -39,7 +39,7 @@ export function onAbortUntil(
39
39
  scope = until;
40
40
  } else {
41
41
  const ended = new AbortController();
42
- const end = (): void => ended.abort();
42
+ const end = (): void => endScope(ended);
43
43
  until.then(end, end);
44
44
  scope = ended.signal;
45
45
  }
@@ -47,3 +47,22 @@ export function onAbortUntil(
47
47
  // scope aborts: the platform's one-step removal, no handle to keep.
48
48
  signal.addEventListener('abort', onAbort, { once: true, signal: scope });
49
49
  }
50
+
51
+ /**
52
+ * The reason every scope controller aborts with. Nothing reads a scope
53
+ * signal's reason (it only removes listeners, through addEventListener's
54
+ * `signal` option), and `abort()` with no reason builds a DOMException, stack
55
+ * trace included, on every call: several per request, ~1.8% of an HTML
56
+ * request's CPU (TIM-1626).
57
+ */
58
+ const SCOPE_ENDED: unique symbol = Symbol('timber.scope-ended');
59
+
60
+ /**
61
+ * End a scope: abort a server-private controller whose signal only bounds
62
+ * listeners (an `onAbortUntil` `until`). Never use it on a signal anything
63
+ * reads a reason from — a render, fetch or stream would see this symbol
64
+ * instead of an AbortError.
65
+ */
66
+ export function endScope(scope: AbortController): void {
67
+ scope.abort(SCOPE_ENDED);
68
+ }
@@ -19,7 +19,7 @@
19
19
  import { Readable, Transform } from 'node:stream';
20
20
  import { NodeBodyResponse } from './node-body-response.ts';
21
21
  import { DEFAULT_MAX_BUFFER_BYTES, teeBufferExceeded } from './stream-utils.ts';
22
- import { onAbortUntil } from './abort-scope.ts';
22
+ import { endScope, onAbortUntil } from './abort-scope.ts';
23
23
  import { RenderTimeoutError } from './render-timeout.ts';
24
24
  import { releaseReason } from './render-utils.ts';
25
25
 
@@ -109,8 +109,17 @@ export function pipeFlightToNode(
109
109
  callback(null, typeof chunk === 'string' ? chunk.toWellFormed() : chunk);
110
110
  },
111
111
  destroy(error, callback) {
112
- scope.abort();
112
+ endScope(scope);
113
113
  clearTimeout(timer);
114
+ // Flight ended the stream (React calls `end()` once the render is
115
+ // complete) and nothing failed: the render is over, so there is
116
+ // nothing to release. Every normally finished render takes this path,
117
+ // and `releaseReason()` would build a DOMException just for React to
118
+ // ignore it (TIM-1626).
119
+ if (error == null && stream.writableEnded) {
120
+ callback(error);
121
+ return;
122
+ }
114
123
  // A no-op once Flight has finished (it ignores abort after close). A
115
124
  // release without a reason aborts with an AbortError, so the render's
116
125
  // onError does not log the abort (releaseReason, TIM-1597).
@@ -18,7 +18,7 @@ import {
18
18
  } from './instrumentation.ts';
19
19
  import { getTraceId } from './tracing.ts';
20
20
  import { requestContextAls } from './als-registry.ts';
21
- import { onAbortUntil } from './abort-scope.ts';
21
+ import { endScope, onAbortUntil } from './abort-scope.ts';
22
22
  import { RedirectSignal } from './primitives.ts';
23
23
  import { isControlFlowSignal } from './signal-identity.ts';
24
24
  import { logRenderError, logSkippedModule, swallow } from './logger.ts';
@@ -535,7 +535,7 @@ export async function runBackgroundFlight<T>(
535
535
  if (!signal.aborted) failed(error);
536
536
  throw error;
537
537
  } finally {
538
- settled.abort();
538
+ endScope(settled);
539
539
  }
540
540
  }
541
541
 
@@ -52,7 +52,7 @@ import { logRenderError, logRouteSetupError } from './logger.ts';
52
52
  import { isDebug } from './debug.ts';
53
53
  import { resolveRenderTimeoutMs } from './render-timeout.ts';
54
54
  import { concatBytes, drainWithDeadline } from './stream-utils.ts';
55
- import { onAbortUntil } from './abort-scope.ts';
55
+ import { endScope, onAbortUntil } from './abort-scope.ts';
56
56
  import type { PipelineConfig, RouteMatch } from './pipeline.ts';
57
57
  import type { MetadataHandler, MetadataRoute } from './types.ts';
58
58
 
@@ -229,7 +229,7 @@ async function bufferResponse(
229
229
  'Metadata route body'
230
230
  );
231
231
  } finally {
232
- readDone.abort();
232
+ endScope(readDone);
233
233
  }
234
234
  const bytes = concatBytes(chunks);
235
235
  const headers = new Headers(response.headers);
@@ -8,7 +8,7 @@
8
8
  * Design doc: 02-rendering-pipeline.md §"Streaming Constraints"
9
9
  */
10
10
 
11
- import { onAbortUntil } from './abort-scope.ts';
11
+ import { endScope, onAbortUntil } from './abort-scope.ts';
12
12
 
13
13
  /** `renderTimeoutMs` when timber.config.ts leaves it unset. */
14
14
  export const DEFAULT_RENDER_TIMEOUT_MS = 30_000;
@@ -75,9 +75,12 @@ export interface RenderTimeout {
75
75
  */
76
76
  export function createRenderTimeout(timeoutMs: number, parentSignal?: AbortSignal): RenderTimeout {
77
77
  const controller = new AbortController();
78
- const reason = new RenderTimeoutError(timeoutMs, 'RSC stream read timed out');
79
-
80
- const timer = setTimeout(() => controller.abort(reason), timeoutMs);
78
+ // The error is built when the timer fires, not up front: almost every
79
+ // render finishes in time, and an Error captures a stack trace.
80
+ const timer = setTimeout(
81
+ () => controller.abort(new RenderTimeoutError(timeoutMs, 'RSC stream read timed out')),
82
+ timeoutMs
83
+ );
81
84
  const scope = new AbortController();
82
85
 
83
86
  // The parent listener lasts until cancel() (server/abort-scope.ts).
@@ -94,7 +97,7 @@ export function createRenderTimeout(timeoutMs: number, parentSignal?: AbortSigna
94
97
  signal: controller.signal,
95
98
  cancel: () => {
96
99
  clearTimeout(timer);
97
- scope.abort();
100
+ endScope(scope);
98
101
  },
99
102
  };
100
103
  }
@@ -88,6 +88,7 @@ import { SlotOutlet } from '../../client/slot-outlet.tsx';
88
88
  import { SlotsProvider } from '../../client/slot-provider.tsx';
89
89
  import { DenyLastResort } from '../../client/deny-last-resort.tsx';
90
90
  import { provideRscViteHandoff } from '../vite-handoff-rsc.ts';
91
+ import { markRouteModulesImmutable } from '../safe-load.ts';
91
92
 
92
93
  // Before anything can render: the runtime reads these at call and render
93
94
  // time through server/vite-handoff-rsc.ts (design/51-native-dev-runtime.md).
@@ -606,4 +607,8 @@ export default _handler!;
606
607
  // This is the boundary @vitejs/plugin-rsc documents for the RSC entry.
607
608
  if (import.meta.hot) {
608
609
  import.meta.hot.accept();
610
+ } else {
611
+ // No dev server can swap route modules: loadModule() may keep them
612
+ // (server/safe-load.ts, TIM-1626).
613
+ markRouteModulesImmutable();
609
614
  }
@@ -36,17 +36,69 @@ export class ModuleLoadError extends Error {
36
36
  }
37
37
  }
38
38
 
39
+ /**
40
+ * Modules already loaded in production, keyed by their manifest loader.
41
+ *
42
+ * Manifest loaders are static objects in the generated manifest module
43
+ * (routing/manifest-codegen.ts), so one loader is one file for the life of
44
+ * the process. A caller that wraps a loader in a fresh object (the sitemap
45
+ * generator does, once per generation) only misses the cache. Node hands back the same namespace on every `import()`, but
46
+ * the round-trip through the loader costs ~2.7µs, and a request loads every
47
+ * layout, page and slot on its path (16 loads on a parallel-routes page):
48
+ * caching measured −4.65% CPU on an HTML page and up to −12.5% on RSC
49
+ * navigation (TIM-1626). A WeakMap hit is ~0.09µs.
50
+ *
51
+ * Only successful loads are stored, so a failed load is retried on the next
52
+ * request and keeps reporting `ModuleLoadError`.
53
+ */
54
+ const loaded = new WeakMap<ManifestLoader, unknown>();
55
+
56
+ /** Set once no dev server can swap route modules; see {@link loadModule}. */
57
+ let routeModulesImmutable = false;
58
+
59
+ /**
60
+ * Declare that route modules cannot change for the life of the process: no
61
+ * dev server's HMR can swap them. Called by the RSC entry when
62
+ * `import.meta.hot` is unset (a built server). Never call it under a dev
63
+ * server, whatever NODE_ENV says.
64
+ */
65
+ export function markRouteModulesImmutable(): void {
66
+ routeModulesImmutable = true;
67
+ }
68
+
39
69
  /**
40
70
  * Load a route manifest module with enriched error context.
41
71
  *
42
72
  * On success: returns the module object (same as `loader.load()`).
43
73
  * On failure: throws `ModuleLoadError` with file path and original cause.
44
74
  *
75
+ * Production builds cache the module per loader. A dev server never does,
76
+ * whatever NODE_ENV says: HMR depends on each request re-importing, so an
77
+ * edited file is picked up, and the manifest (with its loader objects) is
78
+ * not re-evaluated when a route file changes. Both must hold:
79
+ *
80
+ * - `process.env.NODE_ENV === 'production'`, which the server build defines
81
+ * for every adapter, Workers included (plugins/server-bundle.ts). It also
82
+ * keeps vitest (`test`) from caching.
83
+ * - {@link markRouteModulesImmutable} was called. `import.meta.hot` is what
84
+ * says HMR can swap modules, and a dev server started with
85
+ * NODE_ENV=production still has it, but runtime modules cannot read it
86
+ * (they may load outside Vite's module runner, design/51 §"Boundary"), so
87
+ * the RSC entry reads it and calls this, as rsc-entry/ssr-bridge.ts gates
88
+ * the SSR entry.
89
+ *
45
90
  * Error rendering paths that need fallthrough use `loadFallbackModule()`.
46
91
  */
47
92
  export async function loadModule<T = Record<string, unknown>>(loader: ManifestLoader): Promise<T> {
93
+ const cache = process.env.NODE_ENV === 'production' && routeModulesImmutable;
94
+ if (cache) {
95
+ const hit = loaded.get(loader);
96
+ if (hit !== undefined) return hit as T;
97
+ }
48
98
  try {
49
- return (await loader.load()) as T;
99
+ const mod = await loader.load();
100
+ if (cache) loaded.set(loader, mod);
101
+ return mod as T;
50
102
  } catch (error) {
51
103
  throw new ModuleLoadError(loader.filePath, error);
52
104
  }
@@ -1 +0,0 @@
1
- {"version":3,"file":"flight-source-node-BO_xD9jC.js","names":["ignoreError"],"sources":["../../src/server/node-body-response.ts","../../src/server/flight-source-node.ts"],"sourcesContent":["/**\n * `NodeBodyResponse` — a `Response` whose body is a Node `Readable`, so a\n * response built on Node streams reaches the socket without a Web Streams\n * round trip (LOCAL-1475). Node only: loaded behind `nodeStreamsPlatform`.\n *\n * The status and headers are an ordinary `Response`'s. The body stays a Node\n * stream until one of two things takes it:\n *\n * - **An adapter**, through `_toNodeResponse()` — srvx's protocol (nitro and\n * the dev server send with srvx; nitro-preview's sender speaks it too). The\n * stream is piped straight into `ServerResponse`.\n * - **Web-API code** reading `body`, `text()`, `arrayBuffer()`, `clone()`, …\n * The response then converts its body once, with `Readable.toWeb`, and\n * behaves as a native `Response` from then on. Correct anywhere, so code\n * that does not know about Node bodies keeps working; pipeline code on the\n * hot path goes through `node-response.ts` instead, which never converts.\n *\n * Pattern from srvx's `NodeResponse` (`FastResponse`).\n *\n * Design doc: 02-rendering-pipeline.md §\"Response Bodies on Node\"\n */\n\nimport { Readable, Transform, pipeline, type Duplex } from 'node:stream';\nimport { NODE_BODY, type NodeBodyOps } from './node-response.ts';\nimport { createStreamTimingRecorder, wrapResponseWithStreamTiming } from './stream-utils.ts';\n\n/** Statuses whose responses carry no body (Fetch \"null body status\"). */\nconst NULL_BODY_STATUSES = new Set([101, 103, 204, 205, 304]);\n\nfunction ignoreError(): void {}\n\n/** Destroy a body nothing will read, without an unhandled `'error'`. */\nfunction destroyBody(body: Readable): void {\n if (!body.listeners('error').includes(ignoreError)) body.on('error', ignoreError);\n body.destroy();\n}\n\nexport class NodeBodyResponse extends Response {\n #body: Readable | null;\n #native: Response | null = null;\n /** An adapter or a pipeline op took the body: it is used, as a read one is. */\n #taken = false;\n\n constructor(body: Readable, init?: ResponseInit) {\n super(null, init);\n if (NULL_BODY_STATUSES.has(this.status)) {\n destroyBody(body);\n this.#body = null;\n } else {\n this.#body = body;\n }\n }\n\n /** Take the Node body; this response no longer has it. */\n #take(): Readable | null {\n const body = this.#body;\n if (body) this.#taken = true;\n this.#body = null;\n return body;\n }\n\n /**\n * This response as a native one, converting the Node body once. Throws, as\n * a native Response whose body was read does, if something already took\n * the body (an adapter, a re-wrap), rather than reading as empty.\n */\n #toNative(): Response {\n if (!this.#native) {\n if (this.#taken) throw new TypeError('Body is unusable: Body has already been read');\n const body = this.#body;\n this.#body = null;\n this.#native = new Response(\n body ? (Readable.toWeb(body) as ReadableStream<Uint8Array>) : null,\n {\n status: this.status,\n statusText: this.statusText,\n headers: this.headers,\n }\n );\n }\n return this.#native;\n }\n\n get [NODE_BODY](): NodeBodyOps {\n return {\n hasBody: this.#native ? this.#native.body !== null : this.#body !== null,\n rewrap: (init) => {\n if (this.#native) return new Response(this.#native.body, init);\n const body = this.#take();\n return body ? new NodeBodyResponse(body, init) : new Response(null, init);\n },\n discard: () => {\n if (this.#native) {\n this.#native.body?.cancel().catch(() => {});\n return;\n }\n const body = this.#take();\n if (body) destroyBody(body);\n },\n through: (stream, init) => {\n const body = this.#native\n ? this.#native.body && webToNode(this.#native.body)\n : this.#take();\n return body\n ? new NodeBodyResponse(pipeThrough(body, stream), init)\n : new Response(null, init);\n },\n timed: (startTime) => {\n const init = { status: this.status, statusText: this.statusText, headers: this.headers };\n if (this.#native) {\n const native = this.#native.body;\n return new Response(\n native ? wrapResponseWithStreamTiming(native, startTime) : null,\n init\n );\n }\n const body = this.#take();\n return body ? new NodeBodyResponse(timeBody(body, startTime), init) : this;\n },\n };\n }\n\n /**\n * srvx's protocol for a response with a Node body: srvx pipes `body` into\n * `ServerResponse` with `pipeline()`. Headers as a flat `[name, value, …]`\n * list, as srvx's own `NodeResponse` returns them.\n */\n _toNodeResponse(): {\n status: number;\n statusText: string;\n headers: string[];\n body: Readable | ReadableStream<Uint8Array> | null;\n } {\n const headers: string[] = [];\n for (const [name, value] of this.headers) headers.push(name, value);\n return {\n status: this.status,\n statusText: this.statusText,\n headers,\n body: this.#native ? this.#native.body : this.#take(),\n };\n }\n\n // ─── Web API: convert once, then behave natively ─────────────────────────\n\n get body(): Response['body'] {\n return this.#toNative().body;\n }\n\n get bodyUsed(): boolean {\n return this.#native ? this.#native.bodyUsed : this.#taken;\n }\n\n /**\n * The other half of srvx's protocol: srvx/bun and srvx/deno send\n * `res._response` for anything with `_toNodeResponse` (`toNativeResponse`),\n * and their runtimes stream Web bodies natively. Converts once.\n */\n get _response(): Response {\n return this.#toNative();\n }\n\n arrayBuffer(): Promise<ArrayBuffer> {\n return this.#toNative().arrayBuffer();\n }\n\n blob(): Promise<Blob> {\n return this.#toNative().blob();\n }\n\n // Built from arrayBuffer(): its type satisfies both lib.dom's `bytes()` and\n // the Workers types', which some importers (the website) merge in.\n bytes(): Promise<Uint8Array<ArrayBuffer>> {\n return this.#toNative()\n .arrayBuffer()\n .then((buffer) => new Uint8Array(buffer));\n }\n\n formData(): Promise<FormData> {\n return this.#toNative().formData();\n }\n\n json(): Promise<unknown> {\n return this.#toNative().json();\n }\n\n text(): Promise<string> {\n return this.#toNative().text();\n }\n\n clone(): Response {\n return this.#toNative().clone();\n }\n}\n\n/** `body` piped through `stream`; an error or destroy on either end tears down both. */\nfunction pipeThrough(body: Readable, stream: Duplex): Duplex {\n stream.on('error', ignoreError);\n pipeline(body, stream, ignoreError);\n return stream;\n}\n\n/** A Web body already taken out of this response, back as a Node stream. */\nfunction webToNode(body: ReadableStream<Uint8Array>): Readable {\n return Readable.fromWeb(body as import('node:stream/web').ReadableStream<Uint8Array>);\n}\n\n/** A body that reports stream-lifecycle timing ({@link createStreamTimingRecorder}). */\nfunction timeBody(body: Readable, startTime: number): Readable {\n const timing = createStreamTimingRecorder(startTime);\n const timed = new Transform({\n transform(chunk: Uint8Array, _encoding, callback) {\n timing.chunk(chunk.byteLength);\n callback(null, chunk);\n },\n flush(callback) {\n timing.end(false);\n callback();\n },\n // Reached by the consumer leaving early (a cancellation) and by the\n // producer failing; the producer path records itself first, below, so a\n // render error is not logged as a disconnect — as the Web wrapper logs it.\n destroy(error, callback) {\n timing.end(true);\n body.destroy(error ?? undefined);\n callback(error);\n },\n });\n timed.on('error', ignoreError);\n body.on('error', (error) => {\n timing.end(false);\n timed.destroy(error);\n });\n body.pipe(timed);\n return timed;\n}\n","/**\n * Node halves of the Flight source helpers in `flight-source.ts`.\n *\n * Only loaded on Node (`flight-source.ts` imports it behind\n * `nodeStreamsPlatform`), so Workers never evaluate it.\n *\n * A Node Flight source is an object-mode `Readable` whose chunks are exactly\n * what React's `renderToPipeableStream` wrote: `Uint8Array` views for short\n * rows, and JS strings for long rows (≥ ~1365 chars) and text row bodies.\n * The Node Flight client (`createFromNodeStream`) requires every string chunk\n * in its original shape — it throws \"String chunks need to be passed in their\n * original shape\" if one is split or merged — so nothing here splits or\n * concatenates a chunk on its way to a consumer.\n *\n * Design doc: 02-rendering-pipeline.md §\"RSC → SSR → Client Hydration\",\n * §\"Stream Tee\"\n */\n\nimport { Readable, Transform } from 'node:stream';\nimport { NodeBodyResponse } from './node-body-response.ts';\nimport { DEFAULT_MAX_BUFFER_BYTES, teeBufferExceeded } from './stream-utils.ts';\nimport { onAbortUntil } from './abort-scope.ts';\nimport { RenderTimeoutError } from './render-timeout.ts';\nimport { releaseReason } from './render-utils.ts';\n\n// `String.prototype.toWellFormed` ships in every Node timber supports\n// (engines: >=22.18) but is ES2024, past the project's ES2022 lib; this file\n// only runs on Node.\ndeclare global {\n interface String {\n toWellFormed(): string;\n }\n}\n\n/** A chunk of a Node Flight source. */\nexport type NodeFlightChunk = string | Uint8Array;\n\n/** The part of React's `PipeableStream` a Flight render hands us. */\nexport interface PipeableFlight {\n pipe<T extends NodeJS.WritableStream>(destination: T): T;\n abort(reason?: unknown): void;\n}\n\n/**\n * Every stream here carries one no-op `'error'` listener. `destroy(err)` emits\n * `'error'`, and a stream whose consumer already detached (an iterator that\n * returned, a pipeline that finished) or has not attached yet would otherwise\n * turn a cancel into an uncaught exception. Real consumers attach their own\n * listeners, which still see every error.\n */\nfunction ignoreError(): void {}\n\n/**\n * Release a Node Flight source: destroy it with `reason`, which aborts the\n * render behind it. Cancellation reasons in the pipeline are `unknown` (a Web\n * `cancel(reason)` takes anything); `destroy` takes an `Error`. Never throws\n * and never leaves an unhandled `'error'` event, whoever is listening.\n */\nexport function destroyNodeFlight(stream: Readable, reason: unknown): void {\n if (!stream.listeners('error').includes(ignoreError)) stream.on('error', ignoreError);\n const error =\n reason === undefined || reason === null\n ? undefined\n : reason instanceof Error\n ? reason\n : new Error(String(reason));\n stream.destroy(error);\n}\n\n/** When a Node Flight render is aborted, besides its consumer cancelling. */\nexport interface NodeFlightAbort {\n /** The request's signal (client disconnect). */\n signal?: AbortSignal;\n /** Abort with a `RenderTimeoutError` after this long, if still rendering. */\n timeoutMs?: number;\n}\n\n/**\n * Pipe a Flight render into an object-mode Node source.\n *\n * - Strings pass through `toWellFormed()`, as Next does\n * (`renderToNodeFlightStream`): SSR decodes the raw string while the inline\n * copy round-trips through JSON + `TextEncoder`, which turns a lone\n * surrogate into U+FFFD, so without it SSR and hydration see different\n * text. Length in UTF-16 units is unchanged, so a text row's length header\n * still holds.\n * - `renderToPipeableStream` takes no `signal`. `abort()` is called when the\n * request signal fires, when `timeoutMs` passes (design/02 §\"Always Wire\n * abort() to Both Request Signal AND Timeout\"), and when the source is\n * destroyed (a consumer cancelling), with the destroy reason — the reason a\n * Web `cancel(reason)` hands Flight. The listener and the timer are\n * released when the source closes.\n */\nexport function pipeFlightToNode(\n flight: PipeableFlight,\n { signal, timeoutMs }: NodeFlightAbort\n): Readable {\n const scope = new AbortController();\n const timer =\n timeoutMs === undefined\n ? undefined\n : setTimeout(\n () => flight.abort(new RenderTimeoutError(timeoutMs, 'Flight render')),\n timeoutMs\n );\n const stream = new Transform({\n objectMode: true,\n transform(chunk: NodeFlightChunk, _encoding, callback) {\n callback(null, typeof chunk === 'string' ? chunk.toWellFormed() : chunk);\n },\n destroy(error, callback) {\n scope.abort();\n clearTimeout(timer);\n // A no-op once Flight has finished (it ignores abort after close). A\n // release without a reason aborts with an AbortError, so the render's\n // onError does not log the abort (releaseReason, TIM-1597).\n flight.abort(releaseReason(error));\n callback(error);\n },\n });\n stream.on('error', ignoreError);\n // The listener lasts until the stream is destroyed (server/abort-scope.ts).\n onAbortUntil(signal, () => flight.abort(signal?.reason), scope.signal);\n flight.pipe(stream);\n return stream;\n}\n\n/** Bytes a chunk occupies, for the tee's divergence guard. */\nfunction chunkByteLength(chunk: NodeFlightChunk): number {\n return typeof chunk === 'string' ? Buffer.byteLength(chunk) : chunk.byteLength;\n}\n\n/**\n * Tee a Node Flight source into two object-mode branches, with the contract\n * of `teeWithErrorPropagation` (`stream-utils.ts`):\n *\n * - Each branch has its own queue, so the lagging branch buffers without\n * bound until the divergence guard (`maxBufferBytes`, default 5MB, counted\n * in UTF-8 bytes) cancels both. Nothing couples the branches' backpressure:\n * the inline branch is not read until Fizz emits its first HTML chunk, and\n * Fizz needs SSR to consume Flight first, so a `pipe()` into two\n * PassThroughs would deadlock once the inline one filled.\n * - The source is read at the pace of the faster branch (paused only while\n * neither branch wants data), like a Web `tee()`.\n * - An error on the source, or a branch destroyed before it ended, destroys\n * the other branch with an error and destroys the source — which aborts the\n * render — so neither consumer hangs and both are released.\n */\nexport function teeNodeFlight(\n source: Readable,\n maxBufferBytes: number = DEFAULT_MAX_BUFFER_BYTES\n): [Readable, Readable] {\n interface Branch {\n readable: Readable;\n queue: Array<NodeFlightChunk | null>;\n /**\n * Bytes this branch holds that its consumer has not read: the queue, plus\n * chunks pushed into the readable and still in its buffer.\n */\n heldBytes: number;\n /**\n * Sizes of the chunks pushed into the readable, oldest first, until the\n * consumer reads them. In object mode `readableLength` counts buffered\n * chunks, so any beyond it at the front have been consumed.\n */\n pushedSizes: number[];\n /** `_read` was called and nothing has been pushed since. */\n wanting: boolean;\n }\n\n let tornDown = false;\n const branches: [Branch, Branch] = [createBranch(), createBranch()];\n\n function createBranch(): Branch {\n const branch: Branch = {\n readable: new Readable({\n objectMode: true,\n read() {\n settle(branch);\n branch.wanting = true;\n drain(branch);\n },\n destroy(error, callback) {\n // A branch that ended normally releases nothing; one destroyed\n // early (its consumer cancelled, or teardown) takes the rest down.\n if (!branch.readable.readableEnded) {\n teardown(error ?? new Error('RSC stream tee branch cancelled'), error);\n }\n callback(error);\n },\n }),\n queue: [],\n heldBytes: 0,\n pushedSizes: [],\n wanting: false,\n };\n branch.readable.on('error', ignoreError);\n return branch;\n }\n\n /** Stop counting the pushed chunks the consumer has read. */\n function settle(branch: Branch): void {\n while (branch.pushedSizes.length > branch.readable.readableLength) {\n branch.heldBytes -= branch.pushedSizes.shift() ?? 0;\n }\n }\n\n function drain(branch: Branch): void {\n while (branch.wanting) {\n const chunk = branch.queue.shift();\n if (chunk === undefined) break;\n if (chunk === null) {\n branch.wanting = false;\n branch.readable.push(null);\n return;\n }\n branch.pushedSizes.push(chunkByteLength(chunk));\n branch.wanting = branch.readable.push(chunk);\n }\n if (branch.wanting && source.isPaused()) source.resume();\n }\n\n /**\n * Destroy both branches and the source. `branchError` is what the branches'\n * consumers see; `sourceReason` is what Flight is aborted with — the\n * consumer's own cancel reason, which may be `undefined`, as with a Web tee.\n */\n function teardown(branchError: Error, sourceReason: Error | null | undefined): void {\n if (tornDown) return;\n tornDown = true;\n source.off('data', onData);\n for (const branch of branches) {\n branch.queue.length = 0;\n branch.heldBytes = 0;\n branch.pushedSizes.length = 0;\n if (!branch.readable.destroyed) branch.readable.destroy(branchError);\n }\n source.destroy(sourceReason ?? undefined);\n }\n\n function onData(chunk: NodeFlightChunk): void {\n const bytes = chunkByteLength(chunk);\n for (const branch of branches) {\n branch.queue.push(chunk);\n branch.heldBytes += bytes;\n drain(branch);\n }\n // What the lagging branch holds is the divergence between the two.\n for (const branch of branches) settle(branch);\n const divergence = Math.max(branches[0].heldBytes, branches[1].heldBytes);\n if (divergence > maxBufferBytes) {\n const error = teeBufferExceeded(maxBufferBytes, divergence);\n teardown(error, error);\n return;\n }\n if (!branches[0].wanting && !branches[1].wanting) source.pause();\n }\n\n const finished = finishedState(source);\n if (finished) {\n if ('error' in finished) teardown(finished.error, finished.error);\n else for (const branch of branches) branch.readable.push(null);\n return [branches[0].readable, branches[1].readable];\n }\n\n source.on('data', onData);\n source.on('end', () => {\n for (const branch of branches) {\n branch.queue.push(null);\n drain(branch);\n }\n });\n source.on('error', (error: Error) => teardown(error, error));\n source.on('close', () => {\n if (!source.readableEnded) {\n teardown(new Error('RSC stream closed before it ended'), undefined);\n }\n });\n\n return [branches[0].readable, branches[1].readable];\n}\n\n/**\n * A Node Flight source as a `Response` (`NodeBodyResponse`): its body stays a\n * Node stream all the way to the adapter, which pipes it to the socket\n * (LOCAL-1475). Nothing in the Flight path converts it to a Web stream.\n *\n * Every chunk that arrives in one tick goes out as one buffer, with string\n * chunks encoded straight into it. React writes a flush synchronously, and\n * its Node build passes each long row as its own string: a heavy payload\n * arrives as ~4x the chunks of the Web build's 4KB views, and the socket pays\n * per write. The body pauses the source while the client is slow (a payload\n * never piles up in memory), destroying it early destroys the source (which\n * aborts the render), and an error or early close on the source ends it.\n * Wired by hand rather than with `pipeline()`, which allocates an\n * AbortController and an error on every finish.\n */\nexport function nodeFlightResponse(source: Readable, init: ResponseInit): Response {\n return new NodeBodyResponse(batchFlightBytes(source), init);\n}\n\n/** Largest batch the payload body coalesces before pushing (and checking backpressure). */\nconst MAX_BATCH_BYTES = 64 * 1024;\n\nfunction batchFlightBytes(source: Readable): Readable {\n let batch: NodeFlightChunk[] = [];\n let batchBytes = 0;\n let scheduled = false;\n // Assigned once the source listeners exist; a body destroyed before then\n // (an already-finished source) has none to remove.\n let detach = (): void => {};\n\n // One allocation per batch: strings are encoded straight into it, at their\n // offset, rather than each into its own array and then copied.\n const emit = (): void => {\n scheduled = false;\n if (batch.length === 0 || bytes.destroyed) return;\n const merged = Buffer.allocUnsafe(batchBytes);\n let offset = 0;\n for (const chunk of batch) {\n if (typeof chunk === 'string') {\n offset += merged.write(chunk, offset);\n } else {\n merged.set(chunk, offset);\n offset += chunk.byteLength;\n }\n }\n batch = [];\n batchBytes = 0;\n // Backpressure: a slow client stops the render's output here instead of\n // the whole payload piling up in memory. read() resumes it.\n if (!bytes.push(merged)) source.pause();\n };\n\n const bytes = new Readable({\n read() {\n if (source.isPaused()) source.resume();\n },\n destroy(error, callback) {\n // A batch still queued is dropped, so its microtask pushes nothing.\n batch = [];\n batchBytes = 0;\n detach();\n // The client left early: release the render.\n if (!source.readableEnded) destroyNodeFlight(source, error ?? undefined);\n callback(error);\n },\n });\n bytes.on('error', ignoreError);\n\n const finished = finishedState(source);\n if (finished) {\n // A finished source emits no more events for the wiring below to see.\n if ('error' in finished) bytes.destroy(finished.error);\n else bytes.push(null);\n return bytes;\n }\n\n const onData = (chunk: NodeFlightChunk): void => {\n batch.push(chunk);\n batchBytes += chunkByteLength(chunk);\n // A flush that writes a lot in one tick goes out in capped batches, so\n // backpressure can pause the source mid-flush instead of after it.\n if (batchBytes >= MAX_BATCH_BYTES) {\n emit();\n } else if (!scheduled) {\n scheduled = true;\n queueMicrotask(emit);\n }\n };\n const onEnd = (): void => {\n emit();\n bytes.push(null);\n };\n const onError = (error: Error): void => {\n bytes.destroy(error);\n };\n const onClose = (): void => {\n if (!source.readableEnded) {\n bytes.destroy(source.errored ?? new Error('RSC stream closed before it ended'));\n }\n };\n detach = (): void => {\n source.off('data', onData);\n source.off('end', onEnd);\n source.off('error', onError);\n source.off('close', onClose);\n };\n source.on('data', onData);\n source.on('end', onEnd);\n source.on('error', onError);\n source.on('close', onClose);\n return bytes;\n}\n\n/**\n * Why `source` will never emit again, if it was destroyed or ended before a\n * consumer attached: `'end'`, `'error'` and `'close'` have already fired,\n * so a consumer that only listens would wait forever. `null` while live.\n */\nfunction finishedState(source: Readable): { ended: true } | { error: Error } | null {\n if (source.readableEnded) return { ended: true };\n if (!source.destroyed) return null;\n return { error: source.errored ?? new Error('RSC stream closed before it ended') };\n}\n\n/**\n * Settles once a chunk (or the end) can be read from `source`, without\n * consuming it: the chunk stays in the source for whatever reads it next.\n * Rejects if the source errors first.\n *\n * The `'readable'` listener is removed on settle; Node restores the stream's\n * flowing state on the next tick, so a consumer attached afterwards (a pipe,\n * a `'data'` listener) still starts it.\n */\nexport function whenNodeFlightReadable(source: Readable): Promise<void> {\n if (source.readableLength > 0) return Promise.resolve();\n const finished = finishedState(source);\n if (finished) return 'error' in finished ? Promise.reject(finished.error) : Promise.resolve();\n return new Promise<void>((resolve, reject) => {\n const settle = (error?: Error): void => {\n source.off('readable', onReadable);\n source.off('error', settle);\n source.off('close', onClose);\n if (error) reject(error);\n else resolve();\n };\n const onReadable = (): void => settle();\n const onClose = (): void => settle(source.errored ?? undefined);\n source.on('readable', onReadable);\n source.on('error', settle);\n source.on('close', onClose);\n });\n}\n"],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"node-response-DNNnKnoS.js","names":[],"sources":["../../src/server/abort-scope.ts","../../src/server/render-utils.ts","../../src/server/stream-utils.ts","../../src/server/node-response.ts"],"sourcesContent":["/**\n * Abort listeners scoped to the work they guard.\n *\n * A request's signal outlives the render, stream, or timer that listens to\n * it, and a listener left on it keeps everything its closure holds reachable\n * from the request. In production that only delays collection until the\n * request is garbage. In dev it pins the request forever: React's dev Flight\n * server tracks every live promise in an async-hook Map whose debug chains\n * reach the request, so any promise reachable from the request is never\n * collected and never leaves that Map (TIM-1589).\n *\n * So server code never calls `signal.addEventListener('abort', …)` itself\n * (tests/abort-listener-discipline.test.ts enforces it): {@link onAbortUntil}\n * takes the end of the listener's scope as a required argument, which makes\n * a listener without a removal unwritable.\n */\n\n/**\n * Call `onAbort` if `signal` aborts before the scope `until` ends. If\n * `signal` has already aborted, `onAbort` runs now.\n *\n * `until` is the scope: a promise (the listener is removed when it fulfills\n * or rejects, a microtask later) or an `AbortSignal` (removed synchronously\n * when it aborts; use one when an abort later in the same tick must not\n * fire, as after a timeout's `cancel()`).\n */\nexport function onAbortUntil(\n signal: AbortSignal | undefined,\n onAbort: () => void,\n until: PromiseLike<unknown> | AbortSignal\n): void {\n if (!signal) return;\n if (signal.aborted) {\n onAbort();\n return;\n }\n let scope: AbortSignal;\n if (until instanceof AbortSignal) {\n scope = until;\n } else {\n const ended = new AbortController();\n const end = (): void => ended.abort();\n until.then(end, end);\n scope = ended.signal;\n }\n // addEventListener's own `signal` option removes the listener when the\n // scope aborts: the platform's one-step removal, no handle to keep.\n signal.addEventListener('abort', onAbort, { once: true, signal: scope });\n}\n","/**\n * Shared render-phase utilities — used by both the Node.js and Web\n * stream wrappers. Pure functions only; no stream-shape dependencies.\n *\n * Consolidated from duplicated copies in node-stream-transforms.ts,\n * ssr-render.ts, and rsc-entry/helpers.ts. See TIM-1071 item 1.\n */\n\n/**\n * The ` nonce=\"…\"` attribute fragment for a timber-generated `<script>` tag,\n * or `''` when the request has no nonce. Callers interpolate it directly\n * after the tag name: `` `<script${nonceAttr(nonce)}>` ``.\n *\n * The value comes from `generateNonce` in csp-nonce.ts and is base64, so no attribute\n * escaping is required.\n */\nexport function nonceAttr(nonce: string | undefined): string {\n return nonce ? ` nonce=\"${nonce}\"` : '';\n}\n\n/**\n * The reason to abort a render with when its consumer releases it.\n *\n * The framework releases a Flight render it no longer needs — the renderer\n * once a deny or redirect is captured, a tee once either branch is done —\n * usually without a reason. React then reports the abort to the render's\n * `onError` as a plain `Error(\"The render was aborted by the server without a\n * reason.\")`, which reads as an application failure: a `metadata()` that\n * denies while the page is still fetching logged an unhandled render error\n * (TIM-1597). An `AbortError` is what {@link isAbortError} already treats as\n * not-an-error. A reason the caller did pass (a timeout, the tee's divergence\n * guard) is kept, so those still reach the log.\n */\nexport function releaseReason(reason: unknown): unknown {\n return reason ?? new DOMException('The render was released by its consumer.', 'AbortError');\n}\n\n/**\n * Check if an error is an abort error (connection closed by client).\n *\n * When the browser aborts a request (page refresh, navigation away),\n * the AbortSignal fires and React/streams throw an AbortError. This\n * is not an application error — suppress it from error boundaries and logs.\n *\n * A native `ReadableStream.tee()` cancels its source with an array of both\n * branches' reasons (Streams spec, ReadableStreamDefaultTee), so a Web\n * render released through a tee is aborted with `[reason1, reason2]`. That is\n * an abort when every entry is — a tee whose branches were both released\n * ({@link releaseReason}) — and an error when any entry is, such as the\n * divergence guard's.\n */\nexport function isAbortError(error: unknown): boolean {\n if (Array.isArray(error)) return error.length > 0 && error.every(isAbortError);\n if (error instanceof DOMException && error.name === 'AbortError') return true;\n if (error instanceof Error && error.name === 'AbortError') return true;\n return false;\n}\n\n/**\n * Inline script that adds `<meta name=\"robots\" content=\"noindex\">` to the\n * document head. Injected when a render-phase error replaces the shell so\n * search engines don't index error pages.\n *\n * MUST be byte-identical across all stream wrappers (Node and Web) for a\n * given nonce to ensure consistent Content-Length headers — which is why\n * both wrappers call this one function rather than inlining the string.\n */\nexport function noindexScript(nonce?: string): string {\n return `<script${nonceAttr(nonce)}>document.head.appendChild(Object.assign(document.createElement(\"meta\"),{name:\"robots\",content:\"noindex\"}))</script>`;\n}\n","/**\n * Stream utilities for the RSC rendering pipeline.\n *\n * teeWithErrorPropagation — wraps native ReadableStream.tee() with:\n * 1. Cross-branch error propagation (error on one branch cancels the other)\n * 2. Buffer divergence monitoring (warns + cancels when threshold exceeded)\n *\n * This prevents two classes of bugs:\n * - Silent stalls when one tee branch errors and the other hangs indefinitely\n * - Unbounded memory growth when one consumer (SSR) is much slower than the other\n *\n * Design doc: 02-rendering-pipeline.md §\"RSC → SSR → Client Hydration\"\n */\n\nimport { getLogger } from './logger.ts';\n\n/** Default maximum buffer divergence before cancellation (5MB). */\nexport const DEFAULT_MAX_BUFFER_BYTES = 5 * 1024 * 1024;\n\nexport interface TeeOptions {\n /**\n * Maximum byte divergence between the two branches before both are\n * cancelled. When one branch has consumed this many more bytes than\n * the other, the tee's internal buffer is at least this large.\n *\n * Default: 5MB.\n */\n maxBufferBytes?: number;\n}\n\n/**\n * Tee a ReadableStream with error propagation and buffer monitoring.\n *\n * Delegates to the native `stream.tee()` for the actual forking, then wraps\n * each branch in a ReadableStream that:\n * - Tracks bytes consumed per branch\n * - Cancels both branches if byte divergence exceeds `maxBufferBytes`\n * - Cancels the other branch if either branch is cancelled or errors\n *\n * The returned streams are drop-in replacements for the native tee branches.\n */\nexport function teeWithErrorPropagation(\n stream: ReadableStream<Uint8Array>,\n options?: TeeOptions\n): [ReadableStream<Uint8Array>, ReadableStream<Uint8Array>] {\n const maxBuffer = options?.maxBufferBytes ?? DEFAULT_MAX_BUFFER_BYTES;\n const [rawBranch1, rawBranch2] = stream.tee();\n\n // Shared state for cross-branch coordination\n let consumed1 = 0;\n let consumed2 = 0;\n let cancelled = false;\n\n // Readers and controllers are assigned when wrapBranch creates the wrapped\n // streams. We store them so cancelBoth can cancel raw tee branches AND\n // error the wrapped stream controllers for cross-branch propagation.\n let rawReader1: ReadableStreamDefaultReader<Uint8Array> | undefined;\n let rawReader2: ReadableStreamDefaultReader<Uint8Array> | undefined;\n let controller1: ReadableStreamDefaultController<Uint8Array> | undefined;\n let controller2: ReadableStreamDefaultController<Uint8Array> | undefined;\n\n /**\n * Cancel both tee branches. `initiator` is the branch index (0 or 1)\n * that triggered the cancellation — its controller is already being\n * closed/errored by the pull/cancel that triggered this, so we skip it.\n * Pass -1 to cancel+error both (e.g., from the buffer divergence guard).\n *\n * Both raw readers are always canceled regardless of initiator, because\n * the tee source stream is only released when both branches are canceled.\n * ReadableStreamDefaultReader.cancel() is idempotent, so double-cancel\n * is safe.\n */\n function cancelBoth(reason: unknown, initiator: number = -1): void {\n if (cancelled) return;\n cancelled = true;\n // Cancel both raw readers — tee source requires both branches canceled.\n rawReader1?.cancel(reason).catch(() => {});\n rawReader2?.cancel(reason).catch(() => {});\n // Error wrapped controllers so consumers see the failure.\n // Skip the initiator's controller — it's already being closed/errored.\n if (initiator !== 0) {\n try {\n controller1?.error(reason);\n } catch {\n /* already closed/errored */\n }\n }\n if (initiator !== 1) {\n try {\n controller2?.error(reason);\n } catch {\n /* already closed/errored */\n }\n }\n }\n\n function wrapBranch(\n branchIndex: number,\n rawBranch: ReadableStream<Uint8Array>,\n assignReader: (r: ReadableStreamDefaultReader<Uint8Array>) => void,\n assignController: (c: ReadableStreamDefaultController<Uint8Array>) => void,\n addConsumed: (n: number) => void,\n getSelfConsumed: () => number,\n getOtherConsumed: () => number\n ): ReadableStream<Uint8Array> {\n const reader = rawBranch.getReader();\n assignReader(reader);\n\n return new ReadableStream<Uint8Array>({\n start(controller) {\n assignController(controller);\n },\n\n async pull(controller) {\n if (cancelled) {\n return;\n }\n\n try {\n const { done, value } = await reader.read();\n\n // Re-check after await — cancelBoth may have fired while we\n // were waiting on the raw reader.\n if (cancelled) return;\n\n if (done) {\n try {\n controller.close();\n } catch {\n /* controller already errored by cancelBoth */\n }\n return;\n }\n\n addConsumed(value.byteLength);\n\n // Check buffer divergence: the difference in consumed bytes\n // approximates the tee's internal buffer size.\n const divergence = getSelfConsumed() - getOtherConsumed();\n if (divergence > maxBuffer) {\n cancelBoth(teeBufferExceeded(maxBuffer, divergence));\n return;\n }\n\n controller.enqueue(value);\n } catch (err) {\n if (!cancelled) {\n // Source stream errored — propagate to both branches.\n // cancelBoth with initiator skips our own controller,\n // so we error it explicitly here.\n cancelBoth(err, branchIndex);\n try {\n controller.error(err);\n } catch {\n /* already closed/errored */\n }\n }\n }\n },\n\n cancel(reason) {\n // Consumer cancelled this branch — propagate to the other\n cancelBoth(reason, branchIndex);\n },\n });\n }\n\n const wrapped1 = wrapBranch(\n 0,\n rawBranch1,\n (r) => {\n rawReader1 = r;\n },\n (c) => {\n controller1 = c;\n },\n (n) => {\n consumed1 += n;\n },\n () => consumed1,\n () => consumed2\n );\n\n const wrapped2 = wrapBranch(\n 1,\n rawBranch2,\n (r) => {\n rawReader2 = r;\n },\n (c) => {\n controller2 = c;\n },\n (n) => {\n consumed2 += n;\n },\n () => consumed2,\n () => consumed1\n );\n\n return [wrapped1, wrapped2];\n}\n\n/**\n * Stream-lifecycle timing for one response body: firstChunk, lastChunk,\n * close, maxGap (largest inter-chunk gap), chunk count, and byte count,\n * logged once when the stream terminates (clean close OR\n * cancellation/disconnect). Gated behind `serverTiming: 'detailed'`. The\n * Web body wrapper below and the Node body (`node-body-response.ts`) feed\n * the same recorder, so the two report identically.\n */\nexport interface StreamTimingRecorder {\n chunk(byteLength: number): void;\n end(cancelled: boolean): void;\n}\n\nexport function createStreamTimingRecorder(startTime: number): StreamTimingRecorder {\n let firstChunkMs = 0;\n let lastChunkMs = 0;\n let maxGapMs = 0;\n let prevChunkTime = 0;\n let chunks = 0;\n let bytes = 0;\n let ended = false;\n\n return {\n chunk(byteLength) {\n const now = performance.now();\n const relativeMs = Math.round(now - startTime);\n if (chunks === 0) {\n firstChunkMs = relativeMs;\n } else {\n const gap = Math.round(now - prevChunkTime);\n if (gap > maxGapMs) maxGapMs = gap;\n }\n prevChunkTime = now;\n lastChunkMs = relativeMs;\n chunks++;\n bytes += byteLength;\n },\n end(cancelled) {\n if (ended) return;\n ended = true;\n const closeMs = Math.round(performance.now() - startTime);\n getLogger().debug('stream-lifecycle', {\n firstChunkMs,\n lastChunkMs,\n closeMs,\n maxGapMs,\n chunks,\n bytes,\n ...(cancelled ? { cancelled: true } : {}),\n });\n },\n };\n}\n\n/**\n * Wrap a Web response body with stream-lifecycle timing instrumentation\n * ({@link createStreamTimingRecorder}).\n *\n * Uses a manual reader pump to guarantee logging on all termination\n * paths — TransformStream.flush() is not called on cancellation.\n */\nexport function wrapResponseWithStreamTiming(\n body: ReadableStream<Uint8Array>,\n startTime: number\n): ReadableStream<Uint8Array> {\n const timing = createStreamTimingRecorder(startTime);\n const reader = body.getReader();\n\n return new ReadableStream<Uint8Array>({\n async pull(controller) {\n try {\n const { done, value } = await reader.read();\n if (done) {\n timing.end(false);\n controller.close();\n return;\n }\n timing.chunk(value.byteLength);\n controller.enqueue(value);\n } catch (err) {\n timing.end(false);\n controller.error(err);\n }\n },\n\n cancel(reason) {\n timing.end(true);\n reader.cancel(reason).catch(() => {});\n },\n });\n}\n\n/** Format bytes as human-readable string (e.g., \"5.00 MB\"). */\nfunction formatBytes(bytes: number): string {\n if (bytes < 1024) return `${bytes} B`;\n if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(2)} KB`;\n return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;\n}\n\n/**\n * The error both tee implementations (this Web one and the Node one in\n * `flight-source-node.ts`) cancel with when one branch lags the other by more\n * than `maxBuffer` bytes. Warns once, here, so the two cannot drift.\n */\nexport function teeBufferExceeded(maxBuffer: number, divergence: number): Error {\n const error = new Error(\n `RSC stream tee buffer exceeded ${formatBytes(maxBuffer)} ` +\n `(divergence: ${formatBytes(divergence)}). ` +\n `This usually means SSR is much slower than the inline stream consumer. ` +\n `Consider reducing RSC payload size or increasing the tee buffer limit.`\n );\n console.warn(`[timber] ${error.message}`);\n return error;\n}\n\n/**\n * A pull reader over any chunk stream: a Web reader, or the Flight reader in\n * `flight-source.ts`, which reads a Node or Web Flight source.\n */\nexport interface ChunkReader<T> {\n read(): Promise<ReadableStreamReadResult<T>>;\n cancel(reason?: unknown): void;\n}\n\n/**\n * Read a chunk stream to completion under one overall deadline. Every read\n * is raced against the time remaining, and the reader is cancelled on every\n * exit, so a stalled upstream never outlives the deadline. See\n * design/02-rendering-pipeline.md §\"Always Timeout-Guard Stream Reads\".\n *\n * @param label - Prefix for the timeout error message. Both ways the deadline\n * can pass (between reads, or while a read is pending) reject with the same\n * `${label} did not complete within ${timeoutMs}ms`.\n */\nexport async function drainWithDeadline<T>(\n reader: ChunkReader<T>,\n timeoutMs: number,\n label: string\n): Promise<T[]> {\n const chunks: T[] = [];\n const deadline = Date.now() + timeoutMs;\n const deadlineError = () => new Error(`${label} did not complete within ${timeoutMs}ms`);\n try {\n for (;;) {\n const remaining = deadline - Date.now();\n if (remaining <= 0) throw deadlineError();\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeout = new Promise<never>((_, reject) => {\n timer = setTimeout(() => reject(deadlineError()), remaining);\n });\n let result: Awaited<ReturnType<ChunkReader<T>['read']>>;\n try {\n result = await Promise.race([reader.read(), timeout]);\n } finally {\n clearTimeout(timer);\n }\n if (result.done) return chunks;\n chunks.push(result.value);\n }\n } finally {\n reader.cancel();\n }\n}\n\n/** Concatenate byte chunks into one array. */\nexport function concatBytes(chunks: readonly Uint8Array[]): Uint8Array<ArrayBuffer> {\n let total = 0;\n for (const chunk of chunks) total += chunk.byteLength;\n const bytes = new Uint8Array(total);\n let offset = 0;\n for (const chunk of chunks) {\n bytes.set(chunk, offset);\n offset += chunk.byteLength;\n }\n return bytes;\n}\n\n/**\n * Read a byte stream to completion under one overall deadline and return\n * the concatenated bytes ({@link drainWithDeadline}). The static generator's\n * body drain uses it; Flight renders use `collectFlightBytes`\n * (`flight-source.ts`), which reads either source kind the same way.\n */\nexport async function readAllBytesWithDeadline(\n stream: ReadableStream<Uint8Array>,\n timeoutMs: number,\n label: string\n): Promise<Uint8Array> {\n const reader = stream.getReader();\n const chunks = await drainWithDeadline(\n { read: () => reader.read(), cancel: (reason) => void reader.cancel(reason).catch(() => {}) },\n timeoutMs,\n label\n );\n return concatBytes(chunks);\n}\n","/**\n * Responses with a Node body — the platform-neutral half.\n *\n * On Node, SSR's HTML and Flight payload bodies are Node `Readable`s. They\n * travel the pipeline as a `NodeBodyResponse` (`node-body-response.ts`, Node\n * only): a real `Response` whose body stays a Node stream until the adapter\n * pipes it to the socket, so a response is never converted Node → Web → Node\n * (LOCAL-1475). srvx (nitro, the dev server) and nitro-preview's sender take\n * the Node body through `_toNodeResponse()`. Any code that reads the body\n * through the Web API still works: the response then converts once.\n *\n * Pipeline code shared with Workers re-wraps, strips, or times a response\n * through the helpers here, which ask the response itself to do the Node\n * work, so this module never imports `node:stream`. A response is recognised\n * by a `Symbol.for` brand, not `instanceof`: the RSC and SSR environments\n * load separate copies of the class.\n *\n * Design doc: 02-rendering-pipeline.md §\"Response Bodies on Node\"\n */\n\nimport type { Duplex } from 'node:stream';\n\n/** The brand a Node-body response carries, keyed by a registry symbol. */\nexport const NODE_BODY = Symbol.for('timber.response.nodeBody');\n\n/**\n * What a Node-body response can do with its body, for code that cannot import\n * the class: platform-neutral modules, and the standalone `_compress.mjs`,\n * which reaches these through the same registry symbol. Each one takes the\n * body: the response it was called on no longer has one.\n */\nexport interface NodeBodyOps {\n /**\n * Whether the response still owns a body. False for a null-body status\n * (204, 205, 304, …) and once the body was taken. Being branded says\n * nothing about this — ask here instead of reading `.body`, which would\n * convert it.\n */\n readonly hasBody: boolean;\n /** The same body under a new status and headers. */\n rewrap(init: ResponseInit): Response;\n /** Release the body unread (HEAD, a discarded document), aborting its producer. */\n discard(): void;\n /** The same body, reporting stream timing when it ends (detailed Server-Timing). */\n timed(startTime: number): Response;\n /**\n * The body piped through `stream` (gzip), as a Node-body response under\n * `init`. An error or destroy on either end tears down both.\n */\n through(stream: Duplex, init: ResponseInit): Response;\n}\n\ninterface NodeBodyBranded {\n [NODE_BODY]: NodeBodyOps;\n}\n\nfunction isNodeBodyBranded(response: Response): response is Response & NodeBodyBranded {\n return NODE_BODY in response;\n}\n\n/** The Node-body operations of `response`, or `null` for a Web-body response. */\nexport function nodeBodyOps(response: Response): NodeBodyOps | null {\n return isNodeBodyBranded(response) ? response[NODE_BODY] : null;\n}\n\n/**\n * `response`'s body under a new status and headers. A Node body moves to the\n * new response without converting; a Web body is reused as is.\n */\nexport function withResponseInit(response: Response, init: ResponseInit): Response {\n return nodeBodyOps(response)?.rewrap(init) ?? new Response(response.body, init);\n}\n\n/**\n * Release a response's body unread. A live producer (an SSR render, a Flight\n * render) is behind it; dropping the reference without this leaks it for the\n * lifetime of the render (design/13-security.md A4).\n */\nexport function discardResponseBody(response: Response): void {\n const ops = nodeBodyOps(response);\n if (ops) {\n ops.discard();\n return;\n }\n // `cancel()` rejects if the stream is already errored and throws\n // synchronously if it is locked — neither is actionable, the body is being\n // discarded either way.\n try {\n response.body?.cancel().catch(() => {});\n } catch {\n /* stream already locked or disturbed */\n }\n}\n"],"mappings":"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"}