vinext 1.0.1 → 1.1.0

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 (159) hide show
  1. package/README.md +72 -1
  2. package/dist/build/app-page-static-eligibility.d.ts +15 -0
  3. package/dist/build/app-page-static-eligibility.js +82 -0
  4. package/dist/build/prerender-paths.js +3 -78
  5. package/dist/build/prerender.js +33 -8
  6. package/dist/build/server-manifest.d.ts +7 -0
  7. package/dist/build/server-manifest.js +11 -1
  8. package/dist/cache/cache-adapters-virtual.d.ts +7 -1
  9. package/dist/cache/cache-adapters-virtual.js +3 -3
  10. package/dist/client/navigation-runtime.d.ts +11 -0
  11. package/dist/client/navigation-runtime.js +1 -1
  12. package/dist/config/config-matchers.js +3 -1
  13. package/dist/config/next-config.d.ts +7 -0
  14. package/dist/config/next-config.js +18 -3
  15. package/dist/entries/app-rsc-entry.d.ts +2 -0
  16. package/dist/entries/app-rsc-entry.js +64 -43
  17. package/dist/index.d.ts +4 -1
  18. package/dist/index.js +59 -30
  19. package/dist/plugins/cache-flight-codec.d.ts +19 -0
  20. package/dist/plugins/cache-flight-codec.js +68 -0
  21. package/dist/plugins/commonjs-esm-facade.d.ts +35 -0
  22. package/dist/plugins/commonjs-esm-facade.js +80 -0
  23. package/dist/plugins/fonts.d.ts +8 -11
  24. package/dist/plugins/fonts.js +71 -34
  25. package/dist/routing/file-matcher.d.ts +1 -0
  26. package/dist/routing/file-matcher.js +1 -1
  27. package/dist/server/api-handler.js +17 -7
  28. package/dist/server/app-browser-entry.js +11 -7
  29. package/dist/server/app-browser-history-controller.d.ts +2 -0
  30. package/dist/server/app-browser-history-controller.js +8 -0
  31. package/dist/server/app-browser-interception-context.js +26 -2
  32. package/dist/server/app-browser-navigation-controller.d.ts +7 -1
  33. package/dist/server/app-browser-navigation-controller.js +93 -10
  34. package/dist/server/app-fallback-renderer.d.ts +2 -0
  35. package/dist/server/app-fallback-renderer.js +1 -0
  36. package/dist/server/app-history-state.d.ts +3 -0
  37. package/dist/server/app-history-state.js +7 -0
  38. package/dist/server/app-middleware.js +2 -1
  39. package/dist/server/app-optimistic-routing.js +1 -1
  40. package/dist/server/app-page-boundary-render.d.ts +5 -0
  41. package/dist/server/app-page-boundary-render.js +6 -4
  42. package/dist/server/app-page-cache-finalizer.d.ts +11 -0
  43. package/dist/server/app-page-cache-finalizer.js +41 -7
  44. package/dist/server/app-page-cache-render.d.ts +18 -0
  45. package/dist/server/app-page-cache-render.js +63 -43
  46. package/dist/server/app-page-cache.d.ts +5 -0
  47. package/dist/server/app-page-cache.js +27 -7
  48. package/dist/server/app-page-dispatch.d.ts +9 -1
  49. package/dist/server/app-page-dispatch.js +47 -30
  50. package/dist/server/app-page-element-builder.d.ts +7 -0
  51. package/dist/server/app-page-element-builder.js +27 -42
  52. package/dist/server/app-page-execution.d.ts +15 -12
  53. package/dist/server/app-page-execution.js +30 -40
  54. package/dist/server/app-page-head.d.ts +5 -0
  55. package/dist/server/app-page-head.js +9 -3
  56. package/dist/server/app-page-probe.d.ts +0 -109
  57. package/dist/server/app-page-probe.js +3 -136
  58. package/dist/server/app-page-render-identity.d.ts +0 -1
  59. package/dist/server/app-page-render-identity.js +1 -1
  60. package/dist/server/app-page-render-observation.js +2 -2
  61. package/dist/server/app-page-render.d.ts +13 -5
  62. package/dist/server/app-page-render.js +219 -119
  63. package/dist/server/app-page-request.d.ts +0 -1
  64. package/dist/server/app-page-request.js +1 -2
  65. package/dist/server/app-page-response.d.ts +4 -3
  66. package/dist/server/app-page-response.js +4 -3
  67. package/dist/server/app-page-route-wiring.d.ts +17 -5
  68. package/dist/server/app-page-route-wiring.js +55 -33
  69. package/dist/server/app-page-rsc-render-status.d.ts +48 -0
  70. package/dist/server/app-page-rsc-render-status.js +54 -0
  71. package/dist/server/app-page-stream.d.ts +15 -8
  72. package/dist/server/app-page-stream.js +6 -0
  73. package/dist/server/app-request-stage-dispatch.js +1 -1
  74. package/dist/server/app-request-stage-independent-entry.js +4 -4
  75. package/dist/server/app-response-header-provenance.d.ts +2 -0
  76. package/dist/server/app-response-header-provenance.js +10 -4
  77. package/dist/server/app-route-handler-dispatch.js +1 -1
  78. package/dist/server/app-router-entry.js +3 -3
  79. package/dist/server/app-rsc-handler.d.ts +4 -0
  80. package/dist/server/app-rsc-handler.js +212 -96
  81. package/dist/server/app-rsc-request-normalization.d.ts +3 -1
  82. package/dist/server/app-rsc-request-normalization.js +4 -2
  83. package/dist/server/app-rsc-response-stage.d.ts +1 -1
  84. package/dist/server/app-rsc-response-stage.js +6 -4
  85. package/dist/server/app-rsc-route-matching.d.ts +9 -1
  86. package/dist/server/app-rsc-route-matching.js +36 -19
  87. package/dist/server/app-server-action-execution.js +1 -1
  88. package/dist/server/app-ssr-entry.d.ts +3 -2
  89. package/dist/server/app-ssr-entry.js +6 -4
  90. package/dist/server/app-ssr-stream.d.ts +6 -1
  91. package/dist/server/app-ssr-stream.js +34 -15
  92. package/dist/server/app-worker-stages.d.ts +2 -2
  93. package/dist/server/app-worker-stages.js +3 -3
  94. package/dist/server/cacheability-request.js +9 -5
  95. package/dist/server/config-headers.js +2 -0
  96. package/dist/server/dev-server.js +12 -2
  97. package/dist/server/headers.d.ts +14 -0
  98. package/dist/server/headers.js +15 -1
  99. package/dist/server/image-optimization.d.ts +16 -0
  100. package/dist/server/image-optimization.js +26 -6
  101. package/dist/server/isr-cache.js +2 -2
  102. package/dist/server/middleware-matcher-pattern.js +8 -4
  103. package/dist/server/middleware-response-headers.js +2 -0
  104. package/dist/server/multi-stage.d.ts +8 -0
  105. package/dist/server/navigation-planner.js +1 -1
  106. package/dist/server/node-response-signal.d.ts +16 -0
  107. package/dist/server/node-response-signal.js +26 -0
  108. package/dist/server/open-redirect.d.ts +47 -0
  109. package/dist/server/open-redirect.js +74 -1
  110. package/dist/server/pages-page-handler.js +21 -4
  111. package/dist/server/pages-request-stage-entry.js +8 -4
  112. package/dist/server/prod-server.d.ts +8 -7
  113. package/dist/server/prod-server.js +153 -69
  114. package/dist/server/request-pipeline.d.ts +20 -8
  115. package/dist/server/request-pipeline.js +21 -7
  116. package/dist/server/response-compression.d.ts +43 -0
  117. package/dist/server/response-compression.js +111 -0
  118. package/dist/server/seed-cache.js +10 -7
  119. package/dist/server/socket-error-backstop.d.ts +14 -0
  120. package/dist/server/socket-error-backstop.js +27 -4
  121. package/dist/shims/cache-adapter-instantiate.d.ts +50 -0
  122. package/dist/shims/cache-adapter-instantiate.js +118 -0
  123. package/dist/shims/cache-callable-runtime.d.ts +2 -40
  124. package/dist/shims/cache-callable-runtime.js +50 -168
  125. package/dist/shims/cache-flight-arguments.d.ts +22 -0
  126. package/dist/shims/cache-flight-arguments.js +56 -0
  127. package/dist/shims/cache-request-state.d.ts +15 -0
  128. package/dist/shims/cache-request-state.js +31 -8
  129. package/dist/shims/cache-runtime.d.ts +6 -19
  130. package/dist/shims/cache-runtime.js +165 -225
  131. package/dist/shims/cache.d.ts +2 -2
  132. package/dist/shims/cache.js +5 -4
  133. package/dist/shims/cacheability-classification.d.ts +7 -0
  134. package/dist/shims/error-boundary-navigation.d.ts +7 -0
  135. package/dist/shims/error-boundary-navigation.js +19 -1
  136. package/dist/shims/error-boundary.d.ts +10 -10
  137. package/dist/shims/error-boundary.js +26 -7
  138. package/dist/shims/fetch-cache.d.ts +6 -0
  139. package/dist/shims/fetch-cache.js +19 -1
  140. package/dist/shims/form.js +1 -1
  141. package/dist/shims/headers.d.ts +13 -0
  142. package/dist/shims/headers.js +47 -4
  143. package/dist/shims/internal/app-page-props-cache-key.d.ts +5 -2
  144. package/dist/shims/internal/app-page-props-cache-key.js +24 -15
  145. package/dist/shims/internal/headers-state.d.ts +0 -1
  146. package/dist/shims/metadata.js +3 -3
  147. package/dist/shims/navigation-errors.d.ts +6 -0
  148. package/dist/shims/navigation-errors.js +11 -1
  149. package/dist/shims/navigation.d.ts +7 -0
  150. package/dist/shims/navigation.js +14 -4
  151. package/dist/shims/request-context.d.ts +9 -0
  152. package/dist/shims/thenable-params.d.ts +4 -0
  153. package/dist/shims/thenable-params.js +25 -3
  154. package/dist/shims/unified-request-context.js +1 -0
  155. package/dist/utils/mdx-scan.d.ts +5 -0
  156. package/dist/utils/mdx-scan.js +8 -1
  157. package/dist/utils/regex-safety.d.ts +10 -0
  158. package/dist/utils/regex-safety.js +70 -18
  159. package/package.json +3 -3
@@ -0,0 +1,43 @@
1
+ import { NegotiatedEncoding } from "./accept-encoding.js";
2
+ import { IncomingMessage } from "node:http";
3
+ //#region src/server/response-compression.d.ts
4
+ /**
5
+ * Whether a Content-Type is compressible, matching `compressible()`. This
6
+ * covers `text/x-component` (RSC payloads) through the `text/` rule.
7
+ */
8
+ export declare function isCompressibleContentType(contentType: string | null | undefined): boolean;
9
+ /** Whether a Cache-Control value forbids content codings (`no-transform`). */
10
+ export declare function hasNoTransform(cacheControl: string | null | undefined): boolean;
11
+ /** Responses whose known length is below this many bytes are sent uncompressed. */
12
+ export declare const COMPRESS_THRESHOLD = 1024;
13
+ export type ResponseCompressionHeaders = {
14
+ contentType: string | null | undefined;
15
+ cacheControl: string | null | undefined;
16
+ contentEncoding: string | null | undefined;
17
+ /**
18
+ * Body length in bytes when it is known before the headers are written (a
19
+ * Content-Length header, or a buffered or empty body). Undefined for
20
+ * streamed bodies, which are compressed regardless of size.
21
+ */
22
+ contentLength: number | undefined;
23
+ };
24
+ export type ResponseCompression = {
25
+ /** Whether the response must carry `Vary: Accept-Encoding`. */
26
+ varyAcceptEncoding: boolean;
27
+ /** The coding to apply. `identity` sends the body as is. */
28
+ encoding: NegotiatedEncoding;
29
+ };
30
+ /**
31
+ * Decide how to compress a response, in the middleware's order: the
32
+ * Content-Type filter and `Cache-Control: no-transform` skip compression
33
+ * without `Vary`; every other response gets `Vary: Accept-Encoding`, then is
34
+ * sent uncompressed when it is under the size threshold, already encoded, or
35
+ * a HEAD response, or when the client accepts no supported coding.
36
+ *
37
+ * Unlike the middleware, which offers only gzip and deflate, negotiation also
38
+ * offers zstd and br (see negotiateEncoding).
39
+ */
40
+ export declare function resolveResponseCompression(req: IncomingMessage, compress: boolean, headers: ResponseCompressionHeaders): ResponseCompression;
41
+ /** Parse a Content-Length header value the way the middleware compares it. */
42
+ export declare function parseContentLengthHeader(value: string | null | undefined): number | undefined;
43
+ //#endregion
@@ -0,0 +1,111 @@
1
+ import { negotiateEncoding } from "./accept-encoding.js";
2
+ //#region src/server/response-compression.ts
3
+ /**
4
+ * Response compression rules for the Node production server, ported from the
5
+ * `compression` middleware that `next start` installs for every response
6
+ * unless `compress: false` (next/dist/compiled/compression, see
7
+ * packages/next/src/server/lib/router-server.ts).
8
+ */
9
+ const EXTRACT_TYPE_REGEXP = /^\s*([^;\s]*)(?:;|\s|$)/;
10
+ const COMPRESSIBLE_TYPE_REGEXP = /^text\/|\+(?:json|text|xml)$/i;
11
+ /**
12
+ * mime-db entries marked `compressible: true` that COMPRESSIBLE_TYPE_REGEXP
13
+ * does not match, taken from the mime-db bundled with Next.js's compression
14
+ * middleware. That mime-db marks no type `compressible: false` that the
15
+ * regexp matches, so this set plus the regexp reproduces `compressible()`.
16
+ */
17
+ const MIME_DB_COMPRESSIBLE_TYPES = /* @__PURE__ */ new Set([
18
+ "application/dart",
19
+ "application/ecmascript",
20
+ "application/javascript",
21
+ "application/json",
22
+ "application/postscript",
23
+ "application/raml+yaml",
24
+ "application/rtf",
25
+ "application/tar",
26
+ "application/toml",
27
+ "application/vnd.dart",
28
+ "application/vnd.ms-fontobject",
29
+ "application/vnd.ms-opentype",
30
+ "application/wasm",
31
+ "application/x-httpd-php",
32
+ "application/x-javascript",
33
+ "application/x-ns-proxy-autoconfig",
34
+ "application/x-sh",
35
+ "application/x-tar",
36
+ "application/x-virtualbox-hdd",
37
+ "application/x-virtualbox-ova",
38
+ "application/x-virtualbox-ovf",
39
+ "application/x-virtualbox-vbox",
40
+ "application/x-virtualbox-vdi",
41
+ "application/x-virtualbox-vhd",
42
+ "application/x-virtualbox-vmdk",
43
+ "application/x-www-form-urlencoded",
44
+ "application/xml",
45
+ "application/xml-dtd",
46
+ "font/otf",
47
+ "font/ttf",
48
+ "image/bmp",
49
+ "image/vnd.adobe.photoshop",
50
+ "image/x-icon",
51
+ "image/x-ms-bmp",
52
+ "message/rfc822",
53
+ "model/gltf-binary",
54
+ "x-shader/x-fragment",
55
+ "x-shader/x-vertex"
56
+ ]);
57
+ /**
58
+ * Whether a Content-Type is compressible, matching `compressible()`. This
59
+ * covers `text/x-component` (RSC payloads) through the `text/` rule.
60
+ */
61
+ function isCompressibleContentType(contentType) {
62
+ if (!contentType) return false;
63
+ const match = EXTRACT_TYPE_REGEXP.exec(contentType);
64
+ const mime = match ? match[1].toLowerCase() : "";
65
+ return MIME_DB_COMPRESSIBLE_TYPES.has(mime) || COMPRESSIBLE_TYPE_REGEXP.test(mime);
66
+ }
67
+ const NO_TRANSFORM_REGEXP = /(?:^|,)\s*?no-transform\s*?(?:,|$)/;
68
+ /** Whether a Cache-Control value forbids content codings (`no-transform`). */
69
+ function hasNoTransform(cacheControl) {
70
+ return !!cacheControl && NO_TRANSFORM_REGEXP.test(cacheControl);
71
+ }
72
+ /** Responses whose known length is below this many bytes are sent uncompressed. */
73
+ const COMPRESS_THRESHOLD = 1024;
74
+ const NO_COMPRESSION = {
75
+ varyAcceptEncoding: false,
76
+ encoding: "identity"
77
+ };
78
+ /**
79
+ * Decide how to compress a response, in the middleware's order: the
80
+ * Content-Type filter and `Cache-Control: no-transform` skip compression
81
+ * without `Vary`; every other response gets `Vary: Accept-Encoding`, then is
82
+ * sent uncompressed when it is under the size threshold, already encoded, or
83
+ * a HEAD response, or when the client accepts no supported coding.
84
+ *
85
+ * Unlike the middleware, which offers only gzip and deflate, negotiation also
86
+ * offers zstd and br (see negotiateEncoding).
87
+ */
88
+ function resolveResponseCompression(req, compress, headers) {
89
+ if (!compress) return NO_COMPRESSION;
90
+ if (!isCompressibleContentType(headers.contentType)) return NO_COMPRESSION;
91
+ if (hasNoTransform(headers.cacheControl)) return NO_COMPRESSION;
92
+ const identity = {
93
+ varyAcceptEncoding: true,
94
+ encoding: "identity"
95
+ };
96
+ if (headers.contentLength !== void 0 && headers.contentLength < 1024) return identity;
97
+ if ((headers.contentEncoding || "identity") !== "identity") return identity;
98
+ if (req.method === "HEAD") return identity;
99
+ return {
100
+ varyAcceptEncoding: true,
101
+ encoding: negotiateEncoding(req)
102
+ };
103
+ }
104
+ /** Parse a Content-Length header value the way the middleware compares it. */
105
+ function parseContentLengthHeader(value) {
106
+ if (value === null || value === void 0) return void 0;
107
+ const length = Number(value);
108
+ return Number.isNaN(length) ? void 0 : length;
109
+ }
110
+ //#endregion
111
+ export { COMPRESS_THRESHOLD, hasNoTransform, isCompressibleContentType, parseContentLengthHeader, resolveResponseCompression };
@@ -70,8 +70,11 @@ async function seedMemoryCacheFromPrerender(serverDir, options) {
70
70
  const expireSeconds = typeof route.expire === "number" ? route.expire : void 0;
71
71
  const staleSeconds = typeof route.stale === "number" && route.stale >= 0 ? route.stale : void 0;
72
72
  const tags = buildAppPageCacheTags(cachePathname, route.tags ?? []);
73
- if (await seedHtml(writeAppPageEntry, prerenderDir, htmlKey, artifactPathname, trailingSlash, route.headers, revalidateSeconds, expireSeconds, staleSeconds, tags)) {
74
- await seedRsc(writeAppPageEntry, prerenderDir, rscKey, artifactPathname, revalidateSeconds, expireSeconds, staleSeconds, tags);
73
+ const status = route.responseStatus;
74
+ const location = route.headers?.location;
75
+ const rscHeaders = status !== void 0 && location !== void 0 ? { location } : void 0;
76
+ if (await seedHtml(writeAppPageEntry, prerenderDir, htmlKey, artifactPathname, trailingSlash, route.headers, status, revalidateSeconds, expireSeconds, staleSeconds, tags)) {
77
+ await seedRsc(writeAppPageEntry, prerenderDir, rscKey, artifactPathname, rscHeaders, status, revalidateSeconds, expireSeconds, staleSeconds, tags);
75
78
  seeded++;
76
79
  }
77
80
  }
@@ -107,7 +110,7 @@ function createDefaultAppPageEntryWriter() {
107
110
  * Seed the HTML cache entry for a single route.
108
111
  * Returns true if the file existed and was seeded.
109
112
  */
110
- async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailingSlash, headers, revalidateSeconds, expireSeconds, staleSeconds, tags) {
113
+ async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailingSlash, headers, status, revalidateSeconds, expireSeconds, staleSeconds, tags) {
111
114
  const relPath = getOutputPath(pathname, trailingSlash);
112
115
  const fullPath = path.join(prerenderDir, relPath);
113
116
  if (!fs.existsSync(fullPath)) return false;
@@ -117,7 +120,7 @@ async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailing
117
120
  rscData: void 0,
118
121
  headers,
119
122
  postponed: void 0,
120
- status: void 0
123
+ status
121
124
  }, {
122
125
  expireSeconds,
123
126
  revalidateSeconds,
@@ -130,7 +133,7 @@ async function seedHtml(writeAppPageEntry, prerenderDir, key, pathname, trailing
130
133
  * Seed the RSC cache entry for a single route.
131
134
  * No-op if the .rsc file doesn't exist on disk.
132
135
  */
133
- async function seedRsc(writeAppPageEntry, prerenderDir, key, pathname, revalidateSeconds, expireSeconds, staleSeconds, tags) {
136
+ async function seedRsc(writeAppPageEntry, prerenderDir, key, pathname, headers, status, revalidateSeconds, expireSeconds, staleSeconds, tags) {
134
137
  const relPath = getRscOutputPath(pathname);
135
138
  const fullPath = path.join(prerenderDir, relPath);
136
139
  if (!fs.existsSync(fullPath)) return;
@@ -139,9 +142,9 @@ async function seedRsc(writeAppPageEntry, prerenderDir, key, pathname, revalidat
139
142
  kind: "APP_PAGE",
140
143
  html: "",
141
144
  rscData: rscBuffer.buffer.slice(rscBuffer.byteOffset, rscBuffer.byteOffset + rscBuffer.byteLength),
142
- headers: void 0,
145
+ headers,
143
146
  postponed: void 0,
144
- status: void 0
147
+ status
145
148
  }, {
146
149
  expireSeconds,
147
150
  revalidateSeconds,
@@ -23,6 +23,20 @@ export declare function peerDisconnectCode(err: unknown): string | undefined;
23
23
  * Exported for unit testing in isolation.
24
24
  */
25
25
  export declare function isBenignAssetImportError(err: unknown): boolean;
26
+ /**
27
+ * Pure predicate: returns `true` when `err` is Node's
28
+ * `Readable.toWeb()` adapter enqueueing into a request body stream that was
29
+ * already cancelled. `pull()` calls `req.resume()`, which schedules `flow()`
30
+ * on `nextTick`; if the body is cancelled before that tick runs, `flow()`
31
+ * still emits the chunks already buffered in `req` and the adapter's
32
+ * `onData` throws inside the `nextTick` callback. srvx (used by
33
+ * `@vitejs/plugin-rsc` in dev) builds `request.body` this way, so any
34
+ * cancelled request body, e.g. an oversized Server Action, can crash the
35
+ * dev server. Node main drops that data instead (`if (wasCanceled) return;`
36
+ * in `onData`), so absorbing it matches upstream behaviour. Exported for
37
+ * unit testing in isolation.
38
+ */
39
+ export declare function isCancelledRequestBodyEnqueueError(err: unknown): boolean;
26
40
  /**
27
41
  * Test-only: returns whether the backstop has been installed in this
28
42
  * process. Used by the unit test to assert idempotent install via the
@@ -15,9 +15,10 @@
15
15
  * `uncaughtException`, where this listener filters it.
16
16
  *
17
17
  * Filters strictly on peer-disconnect codes (ECONNRESET / EPIPE /
18
- * ECONNABORTED) plus benign static-asset `import()` rejections (see
19
- * `isBenignAssetImportError`), and synchronously re-throws everything
20
- * else, preserving Node's default crash semantics for genuine bugs.
18
+ * ECONNABORTED), benign static-asset `import()` rejections (see
19
+ * `isBenignAssetImportError`) and Node's cancelled-request-body enqueue
20
+ * race (see `isCancelledRequestBodyEnqueueError`), and synchronously
21
+ * re-throws everything else, preserving Node's default crash semantics for genuine bugs.
21
22
  * This is more conservative than Next.js's equivalent
22
23
  * (`router-server.ts`'s log-only handler), which silently swallows
23
24
  * every uncaught — vinext keeps real bugs surfacing.
@@ -153,6 +154,24 @@ function isBenignAssetImportError(err) {
153
154
  return false;
154
155
  }
155
156
  /**
157
+ * Pure predicate: returns `true` when `err` is Node's
158
+ * `Readable.toWeb()` adapter enqueueing into a request body stream that was
159
+ * already cancelled. `pull()` calls `req.resume()`, which schedules `flow()`
160
+ * on `nextTick`; if the body is cancelled before that tick runs, `flow()`
161
+ * still emits the chunks already buffered in `req` and the adapter's
162
+ * `onData` throws inside the `nextTick` callback. srvx (used by
163
+ * `@vitejs/plugin-rsc` in dev) builds `request.body` this way, so any
164
+ * cancelled request body, e.g. an oversized Server Action, can crash the
165
+ * dev server. Node main drops that data instead (`if (wasCanceled) return;`
166
+ * in `onData`), so absorbing it matches upstream behaviour. Exported for
167
+ * unit testing in isolation.
168
+ */
169
+ function isCancelledRequestBodyEnqueueError(err) {
170
+ if (err === null || typeof err !== "object") return false;
171
+ const { code, message, stack } = err;
172
+ return code === "ERR_INVALID_STATE" && typeof message === "string" && message.includes("Controller is already closed") && typeof stack === "string" && /\.onData \(node:internal\/webstreams\/adapters:\d+/.test(stack);
173
+ }
174
+ /**
156
175
  * Test-only: returns whether the backstop has been installed in this
157
176
  * process. Used by the unit test to assert idempotent install via the
158
177
  * Symbol.for guard. Not part of the public API.
@@ -183,6 +202,10 @@ function installSocketErrorBackstop() {
183
202
  if (debug) console.warn(`[vinext] absorbed uncaughtException ${code}`);
184
203
  return;
185
204
  }
205
+ if (isCancelledRequestBodyEnqueueError(err)) {
206
+ if (debug) console.warn("[vinext] absorbed uncaughtException ERR_INVALID_STATE (cancelled request body)");
207
+ return;
208
+ }
186
209
  throw err;
187
210
  });
188
211
  process.on("unhandledRejection", (reason) => {
@@ -197,4 +220,4 @@ function installSocketErrorBackstop() {
197
220
  });
198
221
  }
199
222
  //#endregion
200
- export { installSocketErrorBackstop, isBenignAssetImportError, isSocketErrorBackstopInstalled, peerDisconnectCode };
223
+ export { installSocketErrorBackstop, isBenignAssetImportError, isCancelledRequestBodyEnqueueError, isSocketErrorBackstopInstalled, peerDisconnectCode };
@@ -0,0 +1,50 @@
1
+ //#region src/shims/cache-adapter-instantiate.d.ts
2
+ /**
3
+ * Instantiate a declaratively configured cache adapter from its module's
4
+ * default export. The generated `virtual:vinext-cache-adapters` module calls
5
+ * this for both the `cache.data` and `cache.cdn` slots, so every router and
6
+ * runtime (Node.js dev/prod server and Cloudflare Workers) uses the same rule.
7
+ *
8
+ * Contract: the default export must be a function, and it receives one
9
+ * `{ env, options }` argument.
10
+ *
11
+ * - A `class` (class syntax, as Vite and every current toolchain emit it) is
12
+ * invoked with `new`. It is recognised by the source text that
13
+ * `Function.prototype.toString` must return for class syntax, which starts
14
+ * with `class`, on a function that has [[Construct]].
15
+ * - Any other function is called as a factory, with plain-call semantics
16
+ * (`this`, `new.target` and bound receivers are what a call gives them).
17
+ * Existing factories therefore behave exactly as before, whatever their
18
+ * `prototype` looks like (frozen, decorated, or inherited).
19
+ * - A constructor that is not class syntax (an ES5-compiled class, or a
20
+ * bound or Proxy-wrapped class, whose source text is not observable) is
21
+ * structurally indistinguishable from a factory without invoking it, so the
22
+ * module states it explicitly by exporting a factory that constructs it:
23
+ * `export default (args) => new Adapter(args)`.
24
+ *
25
+ * Classification never invokes the export, matches no error messages and
26
+ * never retries, so the export runs exactly once.
27
+ *
28
+ * The produced value must be an adapter (an object or a function, not a
29
+ * Promise) with the slot's required members; anything else throws an error
30
+ * naming what is wrong.
31
+ */
32
+ export type CacheAdapterFactoryArgs = {
33
+ env: unknown;
34
+ options: unknown;
35
+ };
36
+ export type CacheAdapterSlot = "data" | "cdn";
37
+ /**
38
+ * Whether `value` has a [[Construct]] internal method. A Proxy is
39
+ * constructible exactly when its target is; its no-op `construct` trap
40
+ * answers without running the export or reading any of its properties.
41
+ */
42
+ export declare function isConstructor(value: unknown): boolean;
43
+ /**
44
+ * Whether an export is class syntax and must be invoked with `new`. The
45
+ * [[Construct]] check excludes methods named `class`, whose source text
46
+ * also starts with that word.
47
+ */
48
+ export declare function isClassExport(value: unknown): boolean;
49
+ export declare function instantiateCacheAdapter<T>(exported: unknown, args: CacheAdapterFactoryArgs, slot: CacheAdapterSlot): T;
50
+ //#endregion
@@ -0,0 +1,118 @@
1
+ //#region src/shims/cache-adapter-instantiate.ts
2
+ const REQUIREMENTS = {
3
+ data: {
4
+ methods: [
5
+ "get",
6
+ "set",
7
+ "revalidateTag"
8
+ ],
9
+ booleans: [],
10
+ description: "A data cache adapter implements get, set and revalidateTag."
11
+ },
12
+ cdn: {
13
+ methods: [
14
+ "get",
15
+ "set",
16
+ "revalidateTag",
17
+ "buildResponseHeaders"
18
+ ],
19
+ booleans: ["ownsBackgroundRevalidation"],
20
+ description: "A CDN cache adapter implements get, set, revalidateTag and buildResponseHeaders, and sets ownsBackgroundRevalidation to a boolean."
21
+ }
22
+ };
23
+ /**
24
+ * Whether `value` has a [[Construct]] internal method. A Proxy is
25
+ * constructible exactly when its target is; its no-op `construct` trap
26
+ * answers without running the export or reading any of its properties.
27
+ */
28
+ function isConstructor(value) {
29
+ if (typeof value !== "function") return false;
30
+ try {
31
+ new new Proxy(value, { construct: () => ({}) })();
32
+ return true;
33
+ } catch {
34
+ return false;
35
+ }
36
+ }
37
+ const CLASS_SOURCE = /^class\b/;
38
+ /**
39
+ * Whether an export is class syntax and must be invoked with `new`. The
40
+ * [[Construct]] check excludes methods named `class`, whose source text
41
+ * also starts with that word.
42
+ */
43
+ function isClassExport(value) {
44
+ if (!isConstructor(value)) return false;
45
+ try {
46
+ return CLASS_SOURCE.test(Function.prototype.toString.call(value));
47
+ } catch {
48
+ return false;
49
+ }
50
+ }
51
+ function describeValue(value) {
52
+ if (value === null) return "null";
53
+ if (Array.isArray(value)) return "an array";
54
+ if (typeof value === "object") return "an object";
55
+ return typeof value === "undefined" ? "undefined" : `a ${typeof value}`;
56
+ }
57
+ const ignore = () => {};
58
+ /**
59
+ * Attach a no-op rejection handler with the intrinsic `Promise.prototype.then`,
60
+ * which throws on a non-Promise before reading anything from it. Returns the
61
+ * derived promise, which a Promise subclass's species constructor chooses.
62
+ */
63
+ function handleRejection(promise) {
64
+ return Promise.prototype.then.call(promise, void 0, ignore);
65
+ }
66
+ /**
67
+ * Whether `value` is a Promise, judged by its internal slot or this realm's
68
+ * Promise prototype chain, never by a `then` member: adapter contracts are
69
+ * structural and do not reserve `then`, so an adapter's own `then` method is
70
+ * never read or invoked.
71
+ *
72
+ * A Promise from any realm passes the intrinsic `then`'s brand check, which
73
+ * also attaches a no-op rejection handler, so the discarded result cannot
74
+ * become an unhandled rejection. The derived promise that call returns is
75
+ * handled too, since a subclass's species constructor may return a rejected
76
+ * one.
77
+ *
78
+ * Known limitation: when a Promise subclass's `constructor` or
79
+ * `Symbol.species` lookup throws, that call fails after the brand check, and
80
+ * no handler can be attached (every way of observing a Promise goes through
81
+ * that lookup or its `then`). Such a Promise is still rejected when it comes
82
+ * from this realm, the one adapter modules are evaluated in; one from another
83
+ * realm is judged by its members like any other value.
84
+ */
85
+ function markHandledIfPromise(value) {
86
+ let derived;
87
+ try {
88
+ derived = handleRejection(value);
89
+ } catch {
90
+ try {
91
+ return value instanceof Promise;
92
+ } catch {
93
+ return false;
94
+ }
95
+ }
96
+ try {
97
+ handleRejection(derived);
98
+ } catch {}
99
+ return true;
100
+ }
101
+ function instantiateCacheAdapter(exported, args, slot) {
102
+ const label = `cache.${slot} adapter`;
103
+ const requirements = REQUIREMENTS[slot];
104
+ if (typeof exported !== "function") {
105
+ const hint = exported !== null && typeof exported === "object" ? " To use an adapter object directly, export a factory that returns it: `export default () => adapter`." : exported === void 0 ? " Check that the module has a default export." : "";
106
+ throw new TypeError(`${label}: the module's default export must be a factory function or a class that receives { env, options }, got ${describeValue(exported)}.${hint}`);
107
+ }
108
+ const adapter = isClassExport(exported) ? new exported(args) : exported(args);
109
+ const isObjectLike = adapter !== null && typeof adapter === "object" || typeof adapter === "function";
110
+ if (isObjectLike && markHandledIfPromise(adapter)) throw new TypeError(`${label}: the default export returned a Promise. Adapter factories must return the adapter synchronously; defer async setup to the adapter's methods.`);
111
+ if (!isObjectLike) throw new TypeError(`${label}: the default export must produce an adapter object, got ${describeValue(adapter)}. ${requirements.description}`);
112
+ const record = adapter;
113
+ const problems = [...requirements.methods.filter((method) => typeof record[method] !== "function").map((method) => `method ${method}`), ...requirements.booleans.filter((property) => typeof record[property] !== "boolean").map((property) => `boolean ${property}`)];
114
+ if (problems.length > 0) throw new TypeError(`${label}: the adapter produced by the default export is missing ${problems.join(", ")}. ${requirements.description}`);
115
+ return adapter;
116
+ }
117
+ //#endregion
118
+ export { instantiateCacheAdapter, isClassExport, isConstructor };
@@ -4,48 +4,10 @@ import { RegisterCachedFunctionOptions } from "./cache-runtime.js";
4
4
  declare const CACHE_CAPTURE_TYPE = "use-cache-captures";
5
5
  type CacheCaptureEnvelope = {
6
6
  type: typeof CACHE_CAPTURE_TYPE;
7
- encrypted: string | PromiseLike<string>;
8
- };
9
- /**
10
- * Flight serializes a promise as its resolved value and drops its own fields.
11
- * Next.js params are promises that also expose their resolved fields, and the
12
- * cache key is built from those fields, so the payload carries each such
13
- * promise's fields next to the arguments and decoding assigns them back.
14
- */
15
- type EncodedCacheArguments = {
16
- args: unknown[];
17
- thenableObjects: EncodedThenableObject[];
18
- };
19
- /**
20
- * Flight writes each object once, so `promise` decodes to the same promise as
21
- * every other reference to it, including ones inside resolved values, and the
22
- * fields share references with the arguments. The fields build the cache key;
23
- * the resolved value can differ: the params proxy hides params named like
24
- * promise or React fields (`value`, `status`) from its own keys but still
25
- * resolves to them.
26
- */
27
- type EncodedThenableObject = {
28
- fields: Record<string, unknown>;
29
- promise: PromiseLike<unknown>;
7
+ encrypted: Promise<string>;
30
8
  };
31
9
  export declare function encryptCacheCaptures(captures: unknown[]): CacheCaptureEnvelope;
32
- /**
33
- * What to do when a read would run a getter: `reject` throws
34
- * `UnreplayableCacheArgumentsError`, `skip` leaves the getter unread.
35
- */
36
- type GetterHandling = "reject" | "skip";
37
- /**
38
- * Collect the own fields of every promise-augmented object in the arguments,
39
- * including ones inside resolved promise values. The arguments are passed to
40
- * Flight as they are, so Flight keeps their shared references and cycles.
41
- * With `getters: "reject"`, throws `UnreplayableCacheArgumentsError` when the
42
- * arguments hold a getter; with `"skip"`, promise fields behind a getter are
43
- * not recorded.
44
- */
45
- export declare function encodeCacheArguments(args: unknown[], getters?: GetterHandling): Promise<EncodedCacheArguments>;
46
- /** Restore the promise fields that `encodeCacheArguments` captured before Flight encoding. */
47
- export declare function decodeCacheArguments(value: unknown): unknown[];
48
10
  export declare function registerCachedFunction<TArgs extends unknown[], TResult>(fn: (...args: TArgs) => Promise<TResult>, id: string, variant: string, options: RegisterCachedFunctionOptions): (...args: TArgs) => Promise<TResult>;
49
- /** Load and invoke one transformed cache function through its server-reference identity. */
11
+ /** Replay the persisted payload without re-reading or re-encoding caller objects. */
50
12
  export declare function invokeCacheFunction(invocation: VinextCacheFunctionInvocation, loadServerAction: (id: string) => Promise<unknown>): Promise<void>;
51
13
  //#endregion