@timber-js/app 0.2.0-alpha.22 → 0.2.0-alpha.220

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 (1470) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BwkmAYXq.js +1243 -0
  5. package/dist/_chunks/actions-BwkmAYXq.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-LA3sBpUS.js +1182 -0
  17. package/dist/_chunks/cache-api-LA3sBpUS.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-DkytOEG2.js +1 -0
  44. package/dist/_chunks/dev-server-DnODXuNM.js +2056 -0
  45. package/dist/_chunks/dev-server-DnODXuNM.js.map +1 -0
  46. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  47. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  48. package/dist/_chunks/error-boundary-xxxLtXt6.js +1057 -0
  49. package/dist/_chunks/error-boundary-xxxLtXt6.js.map +1 -0
  50. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  51. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  52. package/dist/_chunks/flight-source-node-0dE-t3kq.js +519 -0
  53. package/dist/_chunks/flight-source-node-0dE-t3kq.js.map +1 -0
  54. package/dist/_chunks/format-BKclgVbk.js +14 -0
  55. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  56. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  57. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  58. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  59. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  60. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  61. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  62. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  63. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  64. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  65. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  66. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  67. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  68. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  69. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  70. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  71. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  72. package/dist/_chunks/node-response-Dibufw_b.js +187 -0
  73. package/dist/_chunks/node-response-Dibufw_b.js.map +1 -0
  74. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  75. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  76. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  77. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  78. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  79. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  80. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  81. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  82. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  83. package/dist/_chunks/purge-store-Byr8XOjU.js +14 -0
  84. package/dist/_chunks/purge-store-Byr8XOjU.js.map +1 -0
  85. package/dist/_chunks/render-timeout-DOf_BBcO.js +46 -0
  86. package/dist/_chunks/render-timeout-DOf_BBcO.js.map +1 -0
  87. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  88. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  89. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  90. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  91. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  92. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  93. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  94. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  95. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  96. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  97. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  98. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  99. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  100. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  101. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  102. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  103. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  104. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  105. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  106. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  107. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  108. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  109. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  110. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  111. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  112. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  113. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  114. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  115. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  116. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  117. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  118. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  119. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  120. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  121. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  122. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  123. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  124. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  125. package/dist/adapters/build-output-helper.d.ts +72 -0
  126. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  127. package/dist/adapters/canonicalize-module.d.ts +8 -0
  128. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  129. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  130. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.js +74 -0
  132. package/dist/adapters/cloudflare-dev.js.map +1 -0
  133. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  134. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  136. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  137. package/dist/adapters/cloudflare.d.ts +224 -24
  138. package/dist/adapters/cloudflare.d.ts.map +1 -1
  139. package/dist/adapters/cloudflare.js +1 -188
  140. package/dist/adapters/compress-module.d.ts +25 -4
  141. package/dist/adapters/compress-module.d.ts.map +1 -1
  142. package/dist/adapters/fs-identity.d.ts +63 -0
  143. package/dist/adapters/fs-identity.d.ts.map +1 -0
  144. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  145. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  146. package/dist/adapters/nitro-presets.d.ts +31 -0
  147. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-preview.d.ts +65 -0
  149. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  150. package/dist/adapters/nitro.d.ts +69 -38
  151. package/dist/adapters/nitro.d.ts.map +1 -1
  152. package/dist/adapters/nitro.js +793 -341
  153. package/dist/adapters/nitro.js.map +1 -1
  154. package/dist/adapters/shared.d.ts +67 -0
  155. package/dist/adapters/shared.d.ts.map +1 -0
  156. package/dist/adapters/types.d.ts +124 -16
  157. package/dist/adapters/types.d.ts.map +1 -1
  158. package/dist/adapters/types.js +0 -0
  159. package/dist/analyze/chains.d.ts +124 -0
  160. package/dist/analyze/chains.d.ts.map +1 -0
  161. package/dist/analyze/classify.d.ts +153 -0
  162. package/dist/analyze/classify.d.ts.map +1 -0
  163. package/dist/analyze/crawl-entry.d.ts +17 -0
  164. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.js +314 -0
  166. package/dist/analyze/crawl-entry.js.map +1 -0
  167. package/dist/analyze/crawl.d.ts +134 -0
  168. package/dist/analyze/crawl.d.ts.map +1 -0
  169. package/dist/analyze/graph-cache.d.ts +104 -0
  170. package/dist/analyze/graph-cache.d.ts.map +1 -0
  171. package/dist/analyze/graph-command.d.ts +43 -0
  172. package/dist/analyze/graph-command.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.js +472 -0
  174. package/dist/analyze/graph-command.js.map +1 -0
  175. package/dist/analyze/live-graph.d.ts +81 -0
  176. package/dist/analyze/live-graph.d.ts.map +1 -0
  177. package/dist/analyze/poison-rules.d.ts +72 -0
  178. package/dist/analyze/poison-rules.d.ts.map +1 -0
  179. package/dist/analyze/poison-scan.d.ts +48 -0
  180. package/dist/analyze/poison-scan.d.ts.map +1 -0
  181. package/dist/analyze/scan.d.ts +73 -0
  182. package/dist/analyze/scan.d.ts.map +1 -0
  183. package/dist/cache/cache-api.d.ts +48 -0
  184. package/dist/cache/cache-api.d.ts.map +1 -0
  185. package/dist/cache/fast-hash.d.ts +5 -0
  186. package/dist/cache/fast-hash.d.ts.map +1 -1
  187. package/dist/cache/handler-store.d.ts +33 -0
  188. package/dist/cache/handler-store.d.ts.map +1 -0
  189. package/dist/cache/index.d.ts +32 -9
  190. package/dist/cache/index.d.ts.map +1 -1
  191. package/dist/cache/index.js +3 -326
  192. package/dist/cache/invalidation-epoch.d.ts +43 -0
  193. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  194. package/dist/cache/json-lossy-check.d.ts +11 -0
  195. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  196. package/dist/cache/redis-handler.d.ts +141 -9
  197. package/dist/cache/redis-handler.d.ts.map +1 -1
  198. package/dist/cache/singleflight.d.ts +21 -2
  199. package/dist/cache/singleflight.d.ts.map +1 -1
  200. package/dist/cache/sizeof.d.ts +22 -0
  201. package/dist/cache/sizeof.d.ts.map +1 -0
  202. package/dist/cache/stable-stringify.d.ts +9 -0
  203. package/dist/cache/stable-stringify.d.ts.map +1 -1
  204. package/dist/cache/store.d.ts +53 -0
  205. package/dist/cache/store.d.ts.map +1 -0
  206. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  207. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.js +29 -0
  209. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  210. package/dist/cache/stores/memory.d.ts +42 -0
  211. package/dist/cache/stores/memory.d.ts.map +1 -0
  212. package/dist/cache/stores/memory.js +90 -0
  213. package/dist/cache/stores/memory.js.map +1 -0
  214. package/dist/cache/stores/redis.d.ts +69 -0
  215. package/dist/cache/stores/redis.d.ts.map +1 -0
  216. package/dist/cache/stores/redis.js +35 -0
  217. package/dist/cache/stores/redis.js.map +1 -0
  218. package/dist/cache/stores/vercel.d.ts +36 -0
  219. package/dist/cache/stores/vercel.d.ts.map +1 -0
  220. package/dist/cache/stores/vercel.js +33 -0
  221. package/dist/cache/stores/vercel.js.map +1 -0
  222. package/dist/cache/tag-aware-handler.d.ts +52 -0
  223. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  224. package/dist/cache/timber-cache.d.ts +21 -11
  225. package/dist/cache/timber-cache.d.ts.map +1 -1
  226. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  227. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  228. package/dist/cdn/cloudflare-purge.js +30 -0
  229. package/dist/cdn/cloudflare-purge.js.map +1 -0
  230. package/dist/cdn/fastly-purge.d.ts +25 -0
  231. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  232. package/dist/cdn/fastly-purge.js +33 -0
  233. package/dist/cdn/fastly-purge.js.map +1 -0
  234. package/dist/cdn/headers.d.ts +97 -0
  235. package/dist/cdn/headers.d.ts.map +1 -0
  236. package/dist/cdn/index.d.ts +5 -0
  237. package/dist/cdn/index.d.ts.map +1 -0
  238. package/dist/cdn/index.js +94 -0
  239. package/dist/cdn/index.js.map +1 -0
  240. package/dist/cdn/purge-store.d.ts +23 -0
  241. package/dist/cdn/purge-store.d.ts.map +1 -0
  242. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  243. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.js +35 -0
  245. package/dist/cdn/workers-cache-purge.js.map +1 -0
  246. package/dist/cli-check.d.ts +133 -0
  247. package/dist/cli-check.d.ts.map +1 -0
  248. package/dist/cli-context.d.ts +54 -0
  249. package/dist/cli-context.d.ts.map +1 -0
  250. package/dist/cli-schema-sync.d.ts +59 -0
  251. package/dist/cli-schema-sync.d.ts.map +1 -0
  252. package/dist/cli.d.ts +88 -16
  253. package/dist/cli.d.ts.map +1 -1
  254. package/dist/cli.js +225 -63
  255. package/dist/cli.js.map +1 -1
  256. package/dist/client/browser-dev.d.ts +42 -2
  257. package/dist/client/browser-dev.d.ts.map +1 -1
  258. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  259. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  260. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  261. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  262. package/dist/client/browser-entry/form-state.d.ts +22 -0
  263. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  264. package/dist/client/browser-entry/hmr.d.ts +21 -0
  265. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  267. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  268. package/dist/client/browser-entry/index.d.ts +32 -0
  269. package/dist/client/browser-entry/index.d.ts.map +1 -0
  270. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  271. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  272. package/dist/client/browser-entry/router-init.d.ts +41 -0
  273. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  274. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  275. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  276. package/dist/client/browser-entry/scroll.d.ts +28 -0
  277. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  278. package/dist/client/deny-last-resort.d.ts +29 -0
  279. package/dist/client/deny-last-resort.d.ts.map +1 -0
  280. package/dist/client/error-boundary.d.ts +58 -9
  281. package/dist/client/error-boundary.d.ts.map +1 -1
  282. package/dist/client/error-boundary.js +1 -126
  283. package/dist/client/error-reconstituter.d.ts +55 -0
  284. package/dist/client/error-reconstituter.d.ts.map +1 -0
  285. package/dist/client/form.d.ts +38 -99
  286. package/dist/client/form.d.ts.map +1 -1
  287. package/dist/client/global-context.d.ts +15 -0
  288. package/dist/client/global-context.d.ts.map +1 -0
  289. package/dist/client/history.d.ts +50 -9
  290. package/dist/client/history.d.ts.map +1 -1
  291. package/dist/client/index.d.ts +21 -33
  292. package/dist/client/index.d.ts.map +1 -1
  293. package/dist/client/index.js +432 -1227
  294. package/dist/client/index.js.map +1 -1
  295. package/dist/client/internal.d.ts +20 -0
  296. package/dist/client/internal.d.ts.map +1 -0
  297. package/dist/client/internal.js +808 -0
  298. package/dist/client/internal.js.map +1 -0
  299. package/dist/client/link.d.ts +85 -60
  300. package/dist/client/link.d.ts.map +1 -1
  301. package/dist/client/location-search.d.ts +12 -0
  302. package/dist/client/location-search.d.ts.map +1 -0
  303. package/dist/client/navigation-api.d.ts +95 -0
  304. package/dist/client/navigation-api.d.ts.map +1 -0
  305. package/dist/client/navigation-commit.d.ts +111 -0
  306. package/dist/client/navigation-commit.d.ts.map +1 -0
  307. package/dist/client/navigation-context.d.ts +54 -36
  308. package/dist/client/navigation-context.d.ts.map +1 -1
  309. package/dist/client/navigation-root.d.ts +106 -0
  310. package/dist/client/navigation-root.d.ts.map +1 -0
  311. package/dist/client/navigation-transition.d.ts +201 -0
  312. package/dist/client/navigation-transition.d.ts.map +1 -0
  313. package/dist/client/nuqs-adapter.d.ts +1 -1
  314. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  315. package/dist/client/params-context.d.ts +81 -0
  316. package/dist/client/params-context.d.ts.map +1 -0
  317. package/dist/client/react-root.d.ts +51 -0
  318. package/dist/client/react-root.d.ts.map +1 -0
  319. package/dist/client/router-effects.d.ts +199 -0
  320. package/dist/client/router-effects.d.ts.map +1 -0
  321. package/dist/client/router-lifecycle.d.ts +104 -0
  322. package/dist/client/router-lifecycle.d.ts.map +1 -0
  323. package/dist/client/router-pipeline.d.ts +85 -0
  324. package/dist/client/router-pipeline.d.ts.map +1 -0
  325. package/dist/client/router-ref.d.ts +2 -2
  326. package/dist/client/router-ref.d.ts.map +1 -1
  327. package/dist/client/router-skew.d.ts +21 -0
  328. package/dist/client/router-skew.d.ts.map +1 -0
  329. package/dist/client/router-types.d.ts +314 -0
  330. package/dist/client/router-types.d.ts.map +1 -0
  331. package/dist/client/router-url.d.ts +24 -0
  332. package/dist/client/router-url.d.ts.map +1 -0
  333. package/dist/client/router.d.ts +1 -97
  334. package/dist/client/router.d.ts.map +1 -1
  335. package/dist/client/rsc-fetch.d.ts +110 -28
  336. package/dist/client/rsc-fetch.d.ts.map +1 -1
  337. package/dist/client/segment-cache.d.ts +186 -25
  338. package/dist/client/segment-cache.d.ts.map +1 -1
  339. package/dist/client/segment-context.d.ts.map +1 -1
  340. package/dist/client/segment-outlet.d.ts +68 -0
  341. package/dist/client/segment-outlet.d.ts.map +1 -0
  342. package/dist/client/segment-update-context.d.ts +15 -0
  343. package/dist/client/segment-update-context.d.ts.map +1 -0
  344. package/dist/client/shallow-url.d.ts +10 -0
  345. package/dist/client/shallow-url.d.ts.map +1 -0
  346. package/dist/client/slot-content-cache-context.d.ts +35 -0
  347. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  348. package/dist/client/slot-context.d.ts +31 -0
  349. package/dist/client/slot-context.d.ts.map +1 -0
  350. package/dist/client/slot-outlet.d.ts +16 -0
  351. package/dist/client/slot-outlet.d.ts.map +1 -0
  352. package/dist/client/slot-provider.d.ts +25 -0
  353. package/dist/client/slot-provider.d.ts.map +1 -0
  354. package/dist/client/ssr-data.d.ts +26 -50
  355. package/dist/client/ssr-data.d.ts.map +1 -1
  356. package/dist/client/stale-client.d.ts +69 -0
  357. package/dist/client/stale-client.d.ts.map +1 -0
  358. package/dist/client/state.d.ts +21 -13
  359. package/dist/client/state.d.ts.map +1 -1
  360. package/dist/client/status-page-marker.d.ts +25 -0
  361. package/dist/client/status-page-marker.d.ts.map +1 -0
  362. package/dist/client/top-loader.d.ts +7 -6
  363. package/dist/client/top-loader.d.ts.map +1 -1
  364. package/dist/client/unload-guard.d.ts +5 -0
  365. package/dist/client/unload-guard.d.ts.map +1 -1
  366. package/dist/client/use-cookie.d.ts +12 -0
  367. package/dist/client/use-cookie.d.ts.map +1 -1
  368. package/dist/client/use-field-state.d.ts +42 -0
  369. package/dist/client/use-field-state.d.ts.map +1 -0
  370. package/dist/client/use-link-status.d.ts +5 -5
  371. package/dist/client/use-link-status.d.ts.map +1 -1
  372. package/dist/client/use-pathname.d.ts +13 -11
  373. package/dist/client/use-pathname.d.ts.map +1 -1
  374. package/dist/client/use-pending-navigation.d.ts +23 -0
  375. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  376. package/dist/client/use-query-states.d.ts +10 -4
  377. package/dist/client/use-query-states.d.ts.map +1 -1
  378. package/dist/client/use-router.d.ts +15 -8
  379. package/dist/client/use-router.d.ts.map +1 -1
  380. package/dist/client/use-search-params.d.ts +15 -8
  381. package/dist/client/use-search-params.d.ts.map +1 -1
  382. package/dist/client/use-segment-params.d.ts +55 -0
  383. package/dist/client/use-segment-params.d.ts.map +1 -0
  384. package/dist/codec.d.ts +69 -0
  385. package/dist/codec.d.ts.map +1 -0
  386. package/dist/codec.js +76 -0
  387. package/dist/codec.js.map +1 -0
  388. package/dist/config-types.d.ts +321 -0
  389. package/dist/config-types.d.ts.map +1 -0
  390. package/dist/config-validation.d.ts +68 -0
  391. package/dist/config-validation.d.ts.map +1 -0
  392. package/dist/cookies/define-cookie.d.ts +58 -25
  393. package/dist/cookies/define-cookie.d.ts.map +1 -1
  394. package/dist/cookies/index.d.ts +3 -2
  395. package/dist/cookies/index.d.ts.map +1 -1
  396. package/dist/cookies/index.js +256 -36
  397. package/dist/cookies/index.js.map +1 -1
  398. package/dist/cookies/json-cookie.d.ts +64 -0
  399. package/dist/cookies/json-cookie.d.ts.map +1 -0
  400. package/dist/cookies/validation.d.ts +34 -0
  401. package/dist/cookies/validation.d.ts.map +1 -0
  402. package/dist/dev-tools/404-page.d.ts +50 -0
  403. package/dist/dev-tools/404-page.d.ts.map +1 -0
  404. package/dist/dev-tools/browser-logs.d.ts +40 -0
  405. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  406. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  407. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  408. package/dist/dev-tools/error-page.d.ts +32 -0
  409. package/dist/dev-tools/error-page.d.ts.map +1 -0
  410. package/dist/dev-tools/holding-server.d.ts +46 -0
  411. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  412. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  413. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  414. package/dist/dev-tools/index.d.ts +31 -0
  415. package/dist/dev-tools/index.d.ts.map +1 -0
  416. package/dist/dev-tools/instrumentation.d.ts +74 -0
  417. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  418. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  419. package/dist/dev-tools/logger.d.ts.map +1 -0
  420. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
  421. package/dist/dev-tools/logs.d.ts.map +1 -0
  422. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  423. package/dist/dev-tools/overlay.d.ts.map +1 -0
  424. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  425. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  426. package/dist/dev-tools/terminal.d.ts +28 -0
  427. package/dist/dev-tools/terminal.d.ts.map +1 -0
  428. package/dist/fonts/ast-walk.d.ts +68 -0
  429. package/dist/fonts/ast-walk.d.ts.map +1 -0
  430. package/dist/fonts/ast.d.ts +112 -8
  431. package/dist/fonts/ast.d.ts.map +1 -1
  432. package/dist/fonts/bundle.d.ts +50 -0
  433. package/dist/fonts/bundle.d.ts.map +1 -0
  434. package/dist/fonts/css.d.ts +1 -1
  435. package/dist/fonts/dev-middleware.d.ts +22 -0
  436. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  437. package/dist/fonts/fallbacks.d.ts +0 -7
  438. package/dist/fonts/fallbacks.d.ts.map +1 -1
  439. package/dist/fonts/google.d.ts +5 -3
  440. package/dist/fonts/google.d.ts.map +1 -1
  441. package/dist/fonts/local.d.ts +5 -5
  442. package/dist/fonts/local.d.ts.map +1 -1
  443. package/dist/fonts/paths.d.ts +43 -0
  444. package/dist/fonts/paths.d.ts.map +1 -0
  445. package/dist/fonts/pipeline.d.ts +177 -0
  446. package/dist/fonts/pipeline.d.ts.map +1 -0
  447. package/dist/fonts/transform.d.ts +82 -0
  448. package/dist/fonts/transform.d.ts.map +1 -0
  449. package/dist/fonts/types.d.ts +47 -1
  450. package/dist/fonts/types.d.ts.map +1 -1
  451. package/dist/fonts/virtual-modules.d.ts +77 -0
  452. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  453. package/dist/index.d.ts +35 -181
  454. package/dist/index.d.ts.map +1 -1
  455. package/dist/index.js +8877 -14232
  456. package/dist/index.js.map +1 -1
  457. package/dist/params/codec-registry.d.ts +26 -0
  458. package/dist/params/codec-registry.d.ts.map +1 -0
  459. package/dist/params/define-schema.d.ts +81 -0
  460. package/dist/params/define-schema.d.ts.map +1 -0
  461. package/dist/params/index.d.ts +5 -0
  462. package/dist/params/index.d.ts.map +1 -0
  463. package/dist/params/index.js +34 -0
  464. package/dist/params/index.js.map +1 -0
  465. package/dist/params/resolve-schema.d.ts +34 -0
  466. package/dist/params/resolve-schema.d.ts.map +1 -0
  467. package/dist/plugin-context.d.ts +262 -0
  468. package/dist/plugin-context.d.ts.map +1 -0
  469. package/dist/plugins/build-manifest.d.ts +7 -3
  470. package/dist/plugins/build-manifest.d.ts.map +1 -1
  471. package/dist/plugins/build-report.d.ts +61 -11
  472. package/dist/plugins/build-report.d.ts.map +1 -1
  473. package/dist/plugins/cache.d.ts +64 -0
  474. package/dist/plugins/cache.d.ts.map +1 -0
  475. package/dist/plugins/callsite-ast.d.ts +117 -0
  476. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  477. package/dist/plugins/callsite-jsx.d.ts +35 -0
  478. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  479. package/dist/plugins/chunks.d.ts +11 -4
  480. package/dist/plugins/chunks.d.ts.map +1 -1
  481. package/dist/plugins/client-chunks.d.ts +40 -0
  482. package/dist/plugins/client-chunks.d.ts.map +1 -0
  483. package/dist/plugins/client-dep-entries.d.ts +80 -0
  484. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  485. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  486. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  487. package/dist/plugins/content.d.ts +1 -1
  488. package/dist/plugins/content.d.ts.map +1 -1
  489. package/dist/plugins/dev-discovery.d.ts +123 -0
  490. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  491. package/dist/plugins/dev-server.d.ts +24 -1
  492. package/dist/plugins/dev-server.d.ts.map +1 -1
  493. package/dist/plugins/encryption-runtime.d.ts +13 -0
  494. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  495. package/dist/plugins/entries.d.ts +35 -4
  496. package/dist/plugins/entries.d.ts.map +1 -1
  497. package/dist/plugins/fonts.d.ts +35 -74
  498. package/dist/plugins/fonts.d.ts.map +1 -1
  499. package/dist/plugins/graph-endpoint.d.ts +112 -0
  500. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  501. package/dist/plugins/mdx.d.ts +18 -5
  502. package/dist/plugins/mdx.d.ts.map +1 -1
  503. package/dist/plugins/post-build.d.ts +110 -0
  504. package/dist/plugins/post-build.d.ts.map +1 -0
  505. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  506. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  507. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  508. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt.d.ts +98 -0
  510. package/dist/plugins/prebuilt.d.ts.map +1 -0
  511. package/dist/plugins/prerender-sugar.d.ts +39 -0
  512. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  513. package/dist/plugins/react-resolve.d.ts +49 -0
  514. package/dist/plugins/react-resolve.d.ts.map +1 -0
  515. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  516. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  517. package/dist/plugins/request-dep/index.d.ts +75 -0
  518. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/origin.d.ts +61 -0
  520. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  521. package/dist/plugins/routing.d.ts +1 -1
  522. package/dist/plugins/routing.d.ts.map +1 -1
  523. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  524. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  525. package/dist/plugins/server-bundle.d.ts +1 -1
  526. package/dist/plugins/server-bundle.d.ts.map +1 -1
  527. package/dist/plugins/shims.d.ts +29 -5
  528. package/dist/plugins/shims.d.ts.map +1 -1
  529. package/dist/plugins/static-build.d.ts +246 -26
  530. package/dist/plugins/static-build.d.ts.map +1 -1
  531. package/dist/routing/codegen-shared.d.ts +26 -0
  532. package/dist/routing/codegen-shared.d.ts.map +1 -0
  533. package/dist/routing/codegen-types.d.ts +61 -0
  534. package/dist/routing/codegen-types.d.ts.map +1 -0
  535. package/dist/routing/codegen-write.d.ts +42 -0
  536. package/dist/routing/codegen-write.d.ts.map +1 -0
  537. package/dist/routing/codegen.d.ts +8 -3
  538. package/dist/routing/codegen.d.ts.map +1 -1
  539. package/dist/routing/collision-probe.d.ts +104 -0
  540. package/dist/routing/collision-probe.d.ts.map +1 -0
  541. package/dist/routing/collision-spaces.d.ts +26 -0
  542. package/dist/routing/collision-spaces.d.ts.map +1 -0
  543. package/dist/routing/convention-lint.d.ts +55 -0
  544. package/dist/routing/convention-lint.d.ts.map +1 -0
  545. package/dist/routing/export-detect.d.ts +91 -0
  546. package/dist/routing/export-detect.d.ts.map +1 -0
  547. package/dist/routing/file-cache.d.ts +8 -0
  548. package/dist/routing/file-cache.d.ts.map +1 -0
  549. package/dist/routing/index.d.ts +13 -7
  550. package/dist/routing/index.d.ts.map +1 -1
  551. package/dist/routing/index.js +5 -2
  552. package/dist/routing/interception-overlap.d.ts +35 -0
  553. package/dist/routing/interception-overlap.d.ts.map +1 -0
  554. package/dist/routing/interception.d.ts +234 -10
  555. package/dist/routing/interception.d.ts.map +1 -1
  556. package/dist/routing/link-codegen.d.ts +105 -0
  557. package/dist/routing/link-codegen.d.ts.map +1 -0
  558. package/dist/routing/manifest-codegen.d.ts +26 -0
  559. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  560. package/dist/routing/scanner.d.ts +14 -10
  561. package/dist/routing/scanner.d.ts.map +1 -1
  562. package/dist/routing/schema-validation.d.ts +35 -0
  563. package/dist/routing/schema-validation.d.ts.map +1 -0
  564. package/dist/routing/segment-classify.d.ts +114 -0
  565. package/dist/routing/segment-classify.d.ts.map +1 -0
  566. package/dist/routing/segment-codegen.d.ts +38 -0
  567. package/dist/routing/segment-codegen.d.ts.map +1 -0
  568. package/dist/routing/segment-keys.d.ts +118 -0
  569. package/dist/routing/segment-keys.d.ts.map +1 -0
  570. package/dist/routing/slot-placement.d.ts +48 -0
  571. package/dist/routing/slot-placement.d.ts.map +1 -0
  572. package/dist/routing/types.d.ts +81 -26
  573. package/dist/routing/types.d.ts.map +1 -1
  574. package/dist/routing/walkers.d.ts +57 -0
  575. package/dist/routing/walkers.d.ts.map +1 -0
  576. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  577. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  578. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  579. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  580. package/dist/rsc-runtime/rsc.d.ts +6 -2
  581. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  582. package/dist/rsc-runtime/ssr.d.ts +8 -0
  583. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  584. package/dist/rsc-runtime/transforms.d.ts +13 -0
  585. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  586. package/dist/schema-bridge.d.ts +145 -0
  587. package/dist/schema-bridge.d.ts.map +1 -0
  588. package/dist/search-params/define.d.ts +262 -0
  589. package/dist/search-params/define.d.ts.map +1 -0
  590. package/dist/search-params/index.d.ts +3 -7
  591. package/dist/search-params/index.d.ts.map +1 -1
  592. package/dist/search-params/index.js +179 -360
  593. package/dist/search-params/index.js.map +1 -1
  594. package/dist/search-params/parse-total.d.ts +81 -0
  595. package/dist/search-params/parse-total.d.ts.map +1 -0
  596. package/dist/search-params/serialize-equal.d.ts +9 -0
  597. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  598. package/dist/search-params/wrappers.d.ts +76 -0
  599. package/dist/search-params/wrappers.d.ts.map +1 -0
  600. package/dist/server/access-gate.d.ts +98 -10
  601. package/dist/server/access-gate.d.ts.map +1 -1
  602. package/dist/server/action-client.d.ts +20 -133
  603. package/dist/server/action-client.d.ts.map +1 -1
  604. package/dist/server/action-encryption.d.ts +76 -0
  605. package/dist/server/action-encryption.d.ts.map +1 -0
  606. package/dist/server/action-handler.d.ts +58 -11
  607. package/dist/server/action-handler.d.ts.map +1 -1
  608. package/dist/server/action-schema.d.ts +126 -0
  609. package/dist/server/action-schema.d.ts.map +1 -0
  610. package/dist/server/action-types.d.ts +108 -0
  611. package/dist/server/action-types.d.ts.map +1 -0
  612. package/dist/server/actions.d.ts +78 -40
  613. package/dist/server/actions.d.ts.map +1 -1
  614. package/dist/server/als-registry.d.ts +189 -17
  615. package/dist/server/als-registry.d.ts.map +1 -1
  616. package/dist/server/body-limits.d.ts.map +1 -1
  617. package/dist/server/build-manifest.d.ts +25 -30
  618. package/dist/server/build-manifest.d.ts.map +1 -1
  619. package/dist/server/canonicalize.d.ts +32 -0
  620. package/dist/server/canonicalize.d.ts.map +1 -1
  621. package/dist/server/chain-url-parts.d.ts +82 -0
  622. package/dist/server/chain-url-parts.d.ts.map +1 -0
  623. package/dist/server/children-interception.d.ts +49 -0
  624. package/dist/server/children-interception.d.ts.map +1 -0
  625. package/dist/server/client-error-message.d.ts +12 -0
  626. package/dist/server/client-error-message.d.ts.map +1 -0
  627. package/dist/server/coalesce-tick.d.ts +40 -0
  628. package/dist/server/coalesce-tick.d.ts.map +1 -0
  629. package/dist/server/compress.d.ts +2 -0
  630. package/dist/server/compress.d.ts.map +1 -1
  631. package/dist/server/cookie-context.d.ts +149 -0
  632. package/dist/server/cookie-context.d.ts.map +1 -0
  633. package/dist/server/cookie-parsing.d.ts +65 -0
  634. package/dist/server/cookie-parsing.d.ts.map +1 -0
  635. package/dist/server/csp-nonce.d.ts +36 -0
  636. package/dist/server/csp-nonce.d.ts.map +1 -0
  637. package/dist/server/csrf.d.ts +58 -15
  638. package/dist/server/csrf.d.ts.map +1 -1
  639. package/dist/server/debug.d.ts +0 -1
  640. package/dist/server/debug.d.ts.map +1 -1
  641. package/dist/server/default-logger.d.ts +23 -0
  642. package/dist/server/default-logger.d.ts.map +1 -0
  643. package/dist/server/default-status-page.d.ts +45 -0
  644. package/dist/server/default-status-page.d.ts.map +1 -0
  645. package/dist/server/deny-boundary.d.ts +257 -0
  646. package/dist/server/deny-boundary.d.ts.map +1 -0
  647. package/dist/server/deny-renderer.d.ts +22 -15
  648. package/dist/server/deny-renderer.d.ts.map +1 -1
  649. package/dist/server/early-hints-sender.d.ts.map +1 -1
  650. package/dist/server/early-hints.d.ts +14 -12
  651. package/dist/server/early-hints.d.ts.map +1 -1
  652. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  653. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  654. package/dist/server/error-response-headers.d.ts +3 -0
  655. package/dist/server/error-response-headers.d.ts.map +1 -0
  656. package/dist/server/fallback-error.d.ts +19 -7
  657. package/dist/server/fallback-error.d.ts.map +1 -1
  658. package/dist/server/flight-injection-state.d.ts +66 -0
  659. package/dist/server/flight-injection-state.d.ts.map +1 -0
  660. package/dist/server/flight-injector-core.d.ts +125 -0
  661. package/dist/server/flight-injector-core.d.ts.map +1 -0
  662. package/dist/server/flight-scripts.d.ts +63 -0
  663. package/dist/server/flight-scripts.d.ts.map +1 -0
  664. package/dist/server/flight-source-node.d.ts +105 -0
  665. package/dist/server/flight-source-node.d.ts.map +1 -0
  666. package/dist/server/flight-source.d.ts +136 -0
  667. package/dist/server/flight-source.d.ts.map +1 -0
  668. package/dist/server/form-data.d.ts +59 -2
  669. package/dist/server/form-data.d.ts.map +1 -1
  670. package/dist/server/form-state-flight.d.ts +32 -0
  671. package/dist/server/form-state-flight.d.ts.map +1 -0
  672. package/dist/server/head-response.d.ts +35 -0
  673. package/dist/server/head-response.d.ts.map +1 -0
  674. package/dist/server/html-injector-core.d.ts +169 -0
  675. package/dist/server/html-injector-core.d.ts.map +1 -0
  676. package/dist/server/html-injectors.d.ts +77 -47
  677. package/dist/server/html-injectors.d.ts.map +1 -1
  678. package/dist/server/index.d.ts +16 -54
  679. package/dist/server/index.d.ts.map +1 -1
  680. package/dist/server/index.js +638 -3021
  681. package/dist/server/index.js.map +1 -1
  682. package/dist/server/instrumentation.d.ts +11 -4
  683. package/dist/server/instrumentation.d.ts.map +1 -1
  684. package/dist/server/internal.d.ts +47 -0
  685. package/dist/server/internal.d.ts.map +1 -0
  686. package/dist/server/internal.js +4649 -0
  687. package/dist/server/internal.js.map +1 -0
  688. package/dist/server/json-status-response.d.ts +34 -0
  689. package/dist/server/json-status-response.d.ts.map +1 -0
  690. package/dist/server/logger.d.ts +79 -7
  691. package/dist/server/logger.d.ts.map +1 -1
  692. package/dist/server/metadata-collector.d.ts +75 -0
  693. package/dist/server/metadata-collector.d.ts.map +1 -0
  694. package/dist/server/metadata-platform.d.ts +2 -2
  695. package/dist/server/metadata-render.d.ts +2 -2
  696. package/dist/server/metadata-render.d.ts.map +1 -1
  697. package/dist/server/metadata-route-links.d.ts +70 -0
  698. package/dist/server/metadata-route-links.d.ts.map +1 -0
  699. package/dist/server/metadata-routes.d.ts +47 -11
  700. package/dist/server/metadata-routes.d.ts.map +1 -1
  701. package/dist/server/metadata-social.d.ts +2 -2
  702. package/dist/server/metadata.d.ts +10 -2
  703. package/dist/server/metadata.d.ts.map +1 -1
  704. package/dist/server/middleware-runner.d.ts +20 -5
  705. package/dist/server/middleware-runner.d.ts.map +1 -1
  706. package/dist/server/node-body-response.d.ts +55 -0
  707. package/dist/server/node-body-response.d.ts.map +1 -0
  708. package/dist/server/node-response.d.ts +62 -0
  709. package/dist/server/node-response.d.ts.map +1 -0
  710. package/dist/server/node-stream-transforms.d.ts +108 -0
  711. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  712. package/dist/server/node-streams-platform.d.ts +21 -0
  713. package/dist/server/node-streams-platform.d.ts.map +1 -0
  714. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  715. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  716. package/dist/server/param-coercion.d.ts +83 -0
  717. package/dist/server/param-coercion.d.ts.map +1 -0
  718. package/dist/server/pipeline-helpers.d.ts +224 -0
  719. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  720. package/dist/server/pipeline-interception.d.ts +70 -9
  721. package/dist/server/pipeline-interception.d.ts.map +1 -1
  722. package/dist/server/pipeline-metadata.d.ts +16 -1
  723. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  724. package/dist/server/pipeline-outcome.d.ts +59 -0
  725. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  726. package/dist/server/pipeline-phases.d.ts +70 -0
  727. package/dist/server/pipeline-phases.d.ts.map +1 -0
  728. package/dist/server/pipeline.d.ts +161 -23
  729. package/dist/server/pipeline.d.ts.map +1 -1
  730. package/dist/server/port-resolution.d.ts +22 -0
  731. package/dist/server/port-resolution.d.ts.map +1 -0
  732. package/dist/server/prebuilt/cache-key.d.ts +63 -0
  733. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  734. package/dist/server/prebuilt/capture-render.d.ts +25 -0
  735. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  736. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  737. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  738. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  739. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  740. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  741. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  742. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  743. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  744. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  745. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  746. package/dist/server/prebuilt/overlay.d.ts +100 -0
  747. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  748. package/dist/server/prebuilt/payload-source.d.ts +79 -0
  749. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  750. package/dist/server/prebuilt/slots.d.ts +106 -0
  751. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  752. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  753. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  754. package/dist/server/prebuilt-builder.d.ts +121 -0
  755. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  756. package/dist/server/prebuilt-runtime.d.ts +110 -0
  757. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  758. package/dist/server/primitives.d.ts +101 -90
  759. package/dist/server/primitives.d.ts.map +1 -1
  760. package/dist/server/publish-params.d.ts +33 -0
  761. package/dist/server/publish-params.d.ts.map +1 -0
  762. package/dist/server/react-cache-bridge.d.ts +59 -0
  763. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  764. package/dist/server/react-cache-scope.d.ts +49 -0
  765. package/dist/server/react-cache-scope.d.ts.map +1 -0
  766. package/dist/server/render-timeout.d.ts +66 -0
  767. package/dist/server/render-timeout.d.ts.map +1 -0
  768. package/dist/server/render-utils.d.ts +35 -0
  769. package/dist/server/render-utils.d.ts.map +1 -0
  770. package/dist/server/request-context.d.ts +153 -103
  771. package/dist/server/request-context.d.ts.map +1 -1
  772. package/dist/server/request-dep.d.ts +15 -0
  773. package/dist/server/request-dep.d.ts.map +1 -0
  774. package/dist/server/response-cache-policy.d.ts +3 -0
  775. package/dist/server/response-cache-policy.d.ts.map +1 -0
  776. package/dist/server/route-element-builder.d.ts +57 -30
  777. package/dist/server/route-element-builder.d.ts.map +1 -1
  778. package/dist/server/route-element-helpers.d.ts +12 -0
  779. package/dist/server/route-element-helpers.d.ts.map +1 -0
  780. package/dist/server/route-handler.d.ts +1 -1
  781. package/dist/server/route-handler.d.ts.map +1 -1
  782. package/dist/server/route-matcher.d.ts +62 -38
  783. package/dist/server/route-matcher.d.ts.map +1 -1
  784. package/dist/server/route-module-loader.d.ts +37 -0
  785. package/dist/server/route-module-loader.d.ts.map +1 -0
  786. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  787. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  788. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  789. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  790. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  791. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  792. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  793. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  794. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  795. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  796. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  797. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  798. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  799. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  800. package/dist/server/rsc-entry/index.d.ts +30 -6
  801. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  802. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  803. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  804. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  805. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  807. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  808. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  809. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  811. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  813. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  814. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  815. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  816. package/dist/server/rsc-error-envelope.d.ts +11 -0
  817. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  818. package/dist/server/safe-load.d.ts +39 -0
  819. package/dist/server/safe-load.d.ts.map +1 -0
  820. package/dist/server/schema-introspection.d.ts +68 -0
  821. package/dist/server/schema-introspection.d.ts.map +1 -0
  822. package/dist/server/sensitive-fields.d.ts +88 -0
  823. package/dist/server/sensitive-fields.d.ts.map +1 -0
  824. package/dist/server/signal-identity.d.ts +43 -0
  825. package/dist/server/signal-identity.d.ts.map +1 -0
  826. package/dist/server/sitemap-generator.d.ts +130 -0
  827. package/dist/server/sitemap-generator.d.ts.map +1 -0
  828. package/dist/server/sitemap-handler.d.ts +22 -0
  829. package/dist/server/sitemap-handler.d.ts.map +1 -0
  830. package/dist/server/skippable-prefix.d.ts +29 -0
  831. package/dist/server/skippable-prefix.d.ts.map +1 -0
  832. package/dist/server/slot-interception.d.ts +80 -0
  833. package/dist/server/slot-interception.d.ts.map +1 -0
  834. package/dist/server/slot-resolver.d.ts +138 -7
  835. package/dist/server/slot-resolver.d.ts.map +1 -1
  836. package/dist/server/slot-subtree-contain.d.ts +54 -0
  837. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  838. package/dist/server/ssr-bridge-types.d.ts +213 -0
  839. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  840. package/dist/server/ssr-entry.d.ts +15 -51
  841. package/dist/server/ssr-entry.d.ts.map +1 -1
  842. package/dist/server/ssr-form-state.d.ts +30 -0
  843. package/dist/server/ssr-form-state.d.ts.map +1 -0
  844. package/dist/server/ssr-render.d.ts +59 -32
  845. package/dist/server/ssr-render.d.ts.map +1 -1
  846. package/dist/server/ssr-wrappers.d.ts +93 -0
  847. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  848. package/dist/server/state-tree-diff.d.ts +44 -9
  849. package/dist/server/state-tree-diff.d.ts.map +1 -1
  850. package/dist/server/static-generator.d.ts +112 -0
  851. package/dist/server/static-generator.d.ts.map +1 -0
  852. package/dist/server/static-not-found.d.ts +52 -0
  853. package/dist/server/static-not-found.d.ts.map +1 -0
  854. package/dist/server/status-code-resolver.d.ts +26 -15
  855. package/dist/server/status-code-resolver.d.ts.map +1 -1
  856. package/dist/server/stream-utils.d.ts +93 -0
  857. package/dist/server/stream-utils.d.ts.map +1 -0
  858. package/dist/server/tracing.d.ts +57 -26
  859. package/dist/server/tracing.d.ts.map +1 -1
  860. package/dist/server/tree-match.d.ts +59 -0
  861. package/dist/server/tree-match.d.ts.map +1 -0
  862. package/dist/server/types.d.ts +89 -8
  863. package/dist/server/types.d.ts.map +1 -1
  864. package/dist/server/utils/element-type.d.ts +50 -0
  865. package/dist/server/utils/element-type.d.ts.map +1 -0
  866. package/dist/server/utils/escape-html.d.ts +14 -0
  867. package/dist/server/utils/escape-html.d.ts.map +1 -0
  868. package/dist/server/version-skew.d.ts +61 -0
  869. package/dist/server/version-skew.d.ts.map +1 -0
  870. package/dist/server/workers-cache-bridge.d.ts +26 -0
  871. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  872. package/dist/shared/als-slots.d.ts +42 -0
  873. package/dist/shared/als-slots.d.ts.map +1 -0
  874. package/dist/shared/base-path.d.ts +56 -0
  875. package/dist/shared/base-path.d.ts.map +1 -0
  876. package/dist/shared/csrf-reject.d.ts +16 -0
  877. package/dist/shared/csrf-reject.d.ts.map +1 -0
  878. package/dist/shared/error-digest.d.ts +28 -0
  879. package/dist/shared/error-digest.d.ts.map +1 -0
  880. package/dist/shared/flight-base64.d.ts +13 -0
  881. package/dist/shared/flight-base64.d.ts.map +1 -0
  882. package/dist/shared/flight-segment.d.ts +18 -0
  883. package/dist/shared/flight-segment.d.ts.map +1 -0
  884. package/dist/shared/form-state-flight.d.ts +32 -0
  885. package/dist/shared/form-state-flight.d.ts.map +1 -0
  886. package/dist/shared/href-validation.d.ts +49 -0
  887. package/dist/shared/href-validation.d.ts.map +1 -0
  888. package/dist/shared/merge-search-params.d.ts +22 -0
  889. package/dist/shared/merge-search-params.d.ts.map +1 -0
  890. package/dist/shared/param-value.d.ts +104 -0
  891. package/dist/shared/param-value.d.ts.map +1 -0
  892. package/dist/shared/payload-root.d.ts +110 -0
  893. package/dist/shared/payload-root.d.ts.map +1 -0
  894. package/dist/shared/redirect-type.d.ts +17 -0
  895. package/dist/shared/redirect-type.d.ts.map +1 -0
  896. package/dist/shared/rsc-cache-key.d.ts +163 -0
  897. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  898. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  899. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  900. package/dist/shared/rsc-manifest.d.ts +28 -0
  901. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  902. package/dist/shared/rsc-media-type.d.ts +52 -0
  903. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  904. package/dist/shared/rsc-payload-path.d.ts +48 -0
  905. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  906. package/dist/shared/segment-info.d.ts +66 -0
  907. package/dist/shared/segment-info.d.ts.map +1 -0
  908. package/dist/shared/slot-params.d.ts +52 -0
  909. package/dist/shared/slot-params.d.ts.map +1 -0
  910. package/dist/shared/static-platform-files.d.ts +71 -0
  911. package/dist/shared/static-platform-files.d.ts.map +1 -0
  912. package/dist/shared/status-reason-phrase.d.ts +26 -0
  913. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  914. package/dist/shims/font-google.d.ts +1 -1
  915. package/dist/shims/font-google.d.ts.map +1 -1
  916. package/dist/shims/font-google.js +42 -0
  917. package/dist/shims/font-google.js.map +1 -0
  918. package/dist/shims/font-local.d.ts +26 -0
  919. package/dist/shims/font-local.d.ts.map +1 -0
  920. package/dist/shims/font-local.js +20 -0
  921. package/dist/shims/font-local.js.map +1 -0
  922. package/dist/shims/headers.d.ts +53 -1
  923. package/dist/shims/headers.d.ts.map +1 -1
  924. package/dist/shims/image.d.ts +120 -120
  925. package/dist/shims/image.d.ts.map +1 -1
  926. package/dist/shims/navigation-client.d.ts +25 -12
  927. package/dist/shims/navigation-client.d.ts.map +1 -1
  928. package/dist/shims/navigation-rsc.d.ts +21 -0
  929. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  930. package/dist/shims/navigation.d.ts +10 -5
  931. package/dist/shims/navigation.d.ts.map +1 -1
  932. package/dist/utils/state-machine.d.ts +80 -0
  933. package/dist/utils/state-machine.d.ts.map +1 -0
  934. package/dist/utils/write-file-atomic.d.ts +17 -0
  935. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  936. package/docs/api/30-api-server.mdx +239 -0
  937. package/docs/api/31-api-client.mdx +199 -0
  938. package/docs/api/32-api-cache.mdx +339 -0
  939. package/docs/api/33-api-search-params.mdx +176 -0
  940. package/docs/api/34-api-config.mdx +359 -0
  941. package/docs/api/35-api-typescript.mdx +91 -0
  942. package/docs/api/36-cli.mdx +206 -0
  943. package/docs/learn/00-introduction.mdx +109 -0
  944. package/docs/learn/01-quick-start.mdx +94 -0
  945. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  946. package/docs/learn/03-fetching-data.mdx +227 -0
  947. package/docs/learn/04-access-control.mdx +115 -0
  948. package/docs/learn/05-the-flush-point.mdx +175 -0
  949. package/docs/learn/06-typed-params.mdx +275 -0
  950. package/docs/learn/07-typed-routes.mdx +108 -0
  951. package/docs/learn/08-forms-and-actions.mdx +260 -0
  952. package/docs/learn/09-streaming.mdx +140 -0
  953. package/docs/learn/10-caching.mdx +270 -0
  954. package/docs/learn/11-middleware.mdx +164 -0
  955. package/docs/learn/12-error-handling.mdx +192 -0
  956. package/docs/learn/13-deploying.mdx +289 -0
  957. package/llms.txt +55 -0
  958. package/package.json +120 -29
  959. package/src/adapters/build-output-helper.ts +353 -0
  960. package/src/adapters/canonicalize-module.ts +29 -0
  961. package/src/adapters/cloudflare-dev.ts +183 -0
  962. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  963. package/src/adapters/cloudflare.ts +809 -150
  964. package/src/adapters/compress-module.ts +110 -86
  965. package/src/adapters/fs-identity.ts +155 -0
  966. package/src/adapters/nitro-immutable-assets.ts +142 -0
  967. package/src/adapters/nitro-presets.ts +124 -0
  968. package/src/adapters/nitro-preview.ts +533 -0
  969. package/src/adapters/nitro.ts +331 -445
  970. package/src/adapters/raw-imports.d.ts +5 -0
  971. package/src/adapters/shared.ts +283 -0
  972. package/src/adapters/types.ts +129 -17
  973. package/src/adapters/wrangler.d.ts +7 -0
  974. package/src/analyze/chains.ts +411 -0
  975. package/src/analyze/classify.ts +259 -0
  976. package/src/analyze/crawl-entry.ts +68 -0
  977. package/src/analyze/crawl.ts +500 -0
  978. package/src/analyze/graph-cache.ts +331 -0
  979. package/src/analyze/graph-command.ts +762 -0
  980. package/src/analyze/live-graph.ts +232 -0
  981. package/src/analyze/poison-rules.ts +165 -0
  982. package/src/analyze/poison-scan.ts +159 -0
  983. package/src/analyze/scan.ts +149 -0
  984. package/src/cache/cache-api.ts +107 -0
  985. package/src/cache/fast-hash.ts +5 -0
  986. package/src/cache/handler-store.ts +76 -0
  987. package/src/cache/index.ts +115 -22
  988. package/src/cache/invalidation-epoch.ts +93 -0
  989. package/src/cache/json-lossy-check.ts +69 -0
  990. package/src/cache/redis-handler.ts +198 -20
  991. package/src/cache/singleflight.ts +72 -6
  992. package/src/cache/sizeof.ts +35 -0
  993. package/src/cache/stable-stringify.ts +65 -2
  994. package/src/cache/store.ts +71 -0
  995. package/src/cache/stores/cloudflare-kv.ts +52 -0
  996. package/src/cache/stores/memory.ts +125 -0
  997. package/src/cache/stores/redis.ts +97 -0
  998. package/src/cache/stores/vercel.ts +59 -0
  999. package/src/cache/tag-aware-handler.ts +254 -0
  1000. package/src/cache/timber-cache.ts +165 -40
  1001. package/src/cdn/cloudflare-purge.ts +50 -0
  1002. package/src/cdn/fastly-purge.ts +63 -0
  1003. package/src/cdn/headers.ts +153 -0
  1004. package/src/cdn/index.ts +23 -0
  1005. package/src/cdn/purge-store.ts +34 -0
  1006. package/src/cdn/workers-cache-purge.ts +34 -0
  1007. package/src/cli-check.ts +417 -0
  1008. package/src/cli-context.ts +119 -0
  1009. package/src/cli-schema-sync.ts +401 -0
  1010. package/src/cli.ts +334 -80
  1011. package/src/client/browser-dev.ts +192 -5
  1012. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1013. package/src/client/browser-entry/action-queue.ts +152 -0
  1014. package/src/client/browser-entry/form-state.ts +49 -0
  1015. package/src/client/browser-entry/hmr.ts +70 -0
  1016. package/src/client/browser-entry/hydrate.ts +152 -0
  1017. package/src/client/browser-entry/index.ts +150 -0
  1018. package/src/client/browser-entry/post-hydration.ts +99 -0
  1019. package/src/client/browser-entry/router-init.ts +393 -0
  1020. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1021. package/src/client/browser-entry/scroll.ts +50 -0
  1022. package/src/client/deny-last-resort.tsx +54 -0
  1023. package/src/client/error-boundary.tsx +279 -61
  1024. package/src/client/error-reconstituter.tsx +84 -0
  1025. package/src/client/form.tsx +61 -173
  1026. package/src/client/global-context.ts +31 -0
  1027. package/src/client/history.ts +74 -11
  1028. package/src/client/index.ts +90 -53
  1029. package/src/client/internal.ts +54 -0
  1030. package/src/client/link.tsx +468 -151
  1031. package/src/client/location-search.ts +15 -0
  1032. package/src/client/navigation-api.ts +254 -0
  1033. package/src/client/navigation-commit.ts +318 -0
  1034. package/src/client/navigation-context.ts +67 -134
  1035. package/src/client/navigation-root.tsx +236 -0
  1036. package/src/client/navigation-transition.ts +348 -0
  1037. package/src/client/nuqs-adapter.tsx +21 -9
  1038. package/src/client/params-context.ts +187 -0
  1039. package/src/client/react-root.ts +105 -0
  1040. package/src/client/router-effects.ts +324 -0
  1041. package/src/client/router-lifecycle.ts +374 -0
  1042. package/src/client/router-pipeline.ts +456 -0
  1043. package/src/client/router-ref.ts +3 -3
  1044. package/src/client/router-skew.ts +30 -0
  1045. package/src/client/router-types.ts +346 -0
  1046. package/src/client/router-url.ts +32 -0
  1047. package/src/client/router.ts +500 -424
  1048. package/src/client/rsc-fetch.ts +510 -109
  1049. package/src/client/segment-cache.ts +362 -41
  1050. package/src/client/segment-context.ts +7 -4
  1051. package/src/client/segment-outlet.tsx +96 -0
  1052. package/src/client/segment-update-context.ts +23 -0
  1053. package/src/client/shallow-url.ts +22 -0
  1054. package/src/client/slot-content-cache-context.ts +43 -0
  1055. package/src/client/slot-context.ts +50 -0
  1056. package/src/client/slot-outlet.tsx +22 -0
  1057. package/src/client/slot-provider.tsx +32 -0
  1058. package/src/client/ssr-data.ts +27 -67
  1059. package/src/client/stale-client.ts +191 -0
  1060. package/src/client/state.ts +31 -24
  1061. package/src/client/status-page-marker.tsx +32 -0
  1062. package/src/client/top-loader.tsx +13 -10
  1063. package/src/client/unload-guard.ts +35 -3
  1064. package/src/client/use-cookie.ts +70 -18
  1065. package/src/client/use-field-state.ts +144 -0
  1066. package/src/client/use-link-status.ts +7 -7
  1067. package/src/client/use-pathname.ts +22 -31
  1068. package/src/client/use-pending-navigation.ts +40 -0
  1069. package/src/client/use-query-states.ts +206 -36
  1070. package/src/client/use-router.ts +31 -9
  1071. package/src/client/use-search-params.ts +38 -49
  1072. package/src/client/use-segment-params.ts +69 -0
  1073. package/src/client/use-selected-layout-segment.ts +2 -2
  1074. package/src/codec.ts +149 -0
  1075. package/src/config-types.ts +321 -0
  1076. package/src/config-validation.ts +464 -0
  1077. package/src/cookies/define-cookie.ts +222 -53
  1078. package/src/cookies/index.ts +13 -2
  1079. package/src/cookies/json-cookie.ts +105 -0
  1080. package/src/cookies/validation.ts +192 -0
  1081. package/src/dev-tools/404-page.ts +286 -0
  1082. package/src/dev-tools/browser-logs.ts +55 -0
  1083. package/src/dev-tools/dev-page-shell.ts +278 -0
  1084. package/src/dev-tools/error-page.ts +331 -0
  1085. package/src/dev-tools/holding-server.ts +185 -0
  1086. package/src/dev-tools/hydration-overlay.ts +158 -0
  1087. package/src/dev-tools/index.ts +79 -0
  1088. package/src/dev-tools/instrumentation.ts +261 -0
  1089. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1090. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
  1091. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1092. package/src/dev-tools/stack-classifier.ts +75 -0
  1093. package/src/dev-tools/terminal.ts +182 -0
  1094. package/src/fonts/ast-walk.ts +235 -0
  1095. package/src/fonts/ast.ts +479 -128
  1096. package/src/fonts/bundle.ts +138 -0
  1097. package/src/fonts/css.ts +1 -1
  1098. package/src/fonts/dev-middleware.ts +85 -0
  1099. package/src/fonts/fallbacks.ts +0 -23
  1100. package/src/fonts/google.ts +101 -19
  1101. package/src/fonts/local.ts +12 -11
  1102. package/src/fonts/paths.ts +58 -0
  1103. package/src/fonts/pipeline.ts +348 -0
  1104. package/src/fonts/transform.ts +311 -0
  1105. package/src/fonts/types.ts +52 -1
  1106. package/src/fonts/virtual-modules.ts +179 -0
  1107. package/src/index.ts +492 -380
  1108. package/src/params/codec-registry.ts +34 -0
  1109. package/src/params/define-schema.ts +115 -0
  1110. package/src/params/index.ts +17 -0
  1111. package/src/params/resolve-schema.ts +84 -0
  1112. package/src/plugin-context.ts +502 -0
  1113. package/src/plugins/build-manifest.ts +189 -36
  1114. package/src/plugins/build-report.ts +299 -87
  1115. package/src/plugins/cache.ts +243 -0
  1116. package/src/plugins/callsite-ast.ts +472 -0
  1117. package/src/plugins/callsite-jsx.ts +243 -0
  1118. package/src/plugins/chunks.ts +74 -5
  1119. package/src/plugins/client-chunks.ts +185 -0
  1120. package/src/plugins/client-dep-entries.ts +124 -0
  1121. package/src/plugins/cloudflare-wasm.ts +141 -0
  1122. package/src/plugins/content.ts +31 -2
  1123. package/src/plugins/dev-discovery.ts +218 -0
  1124. package/src/plugins/dev-server.ts +360 -97
  1125. package/src/plugins/encryption-runtime.ts +31 -0
  1126. package/src/plugins/entries.ts +150 -17
  1127. package/src/plugins/fonts.ts +260 -657
  1128. package/src/plugins/graph-endpoint.ts +532 -0
  1129. package/src/plugins/mdx.ts +108 -35
  1130. package/src/plugins/post-build.ts +327 -0
  1131. package/src/plugins/prebuilt-capture.ts +213 -0
  1132. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1133. package/src/plugins/prebuilt.ts +670 -0
  1134. package/src/plugins/prerender-sugar.ts +316 -0
  1135. package/src/plugins/react-resolve.ts +149 -0
  1136. package/src/plugins/request-dep/analysis.ts +447 -0
  1137. package/src/plugins/request-dep/index.ts +376 -0
  1138. package/src/plugins/request-dep/origin.ts +310 -0
  1139. package/src/plugins/routing.ts +273 -277
  1140. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1141. package/src/plugins/server-bundle.ts +115 -15
  1142. package/src/plugins/shims.ts +257 -97
  1143. package/src/plugins/static-build.ts +681 -71
  1144. package/src/react-canary.d.ts +2 -0
  1145. package/src/routing/codegen-shared.ts +39 -0
  1146. package/src/routing/codegen-types.ts +62 -0
  1147. package/src/routing/codegen-write.ts +163 -0
  1148. package/src/routing/codegen.ts +349 -232
  1149. package/src/routing/collision-probe.ts +438 -0
  1150. package/src/routing/collision-spaces.ts +281 -0
  1151. package/src/routing/convention-lint.ts +651 -0
  1152. package/src/routing/export-detect.ts +536 -0
  1153. package/src/routing/file-cache.ts +23 -0
  1154. package/src/routing/index.ts +16 -7
  1155. package/src/routing/interception-overlap.ts +141 -0
  1156. package/src/routing/interception.ts +1044 -67
  1157. package/src/routing/link-codegen.ts +280 -0
  1158. package/src/routing/manifest-codegen.ts +232 -0
  1159. package/src/routing/scanner.ts +417 -223
  1160. package/src/routing/schema-validation.ts +155 -0
  1161. package/src/routing/segment-classify.ts +280 -0
  1162. package/src/routing/segment-codegen.ts +99 -0
  1163. package/src/routing/segment-keys.ts +186 -0
  1164. package/src/routing/slot-placement.ts +97 -0
  1165. package/src/routing/types.ts +82 -26
  1166. package/src/routing/walkers.ts +98 -0
  1167. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1168. package/src/rsc-runtime/render-flight.ts +26 -0
  1169. package/src/rsc-runtime/rsc.ts +17 -2
  1170. package/src/rsc-runtime/ssr.ts +13 -0
  1171. package/src/rsc-runtime/transforms.ts +13 -0
  1172. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1173. package/src/schema-bridge.ts +382 -0
  1174. package/src/search-params/define.ts +677 -0
  1175. package/src/search-params/index.ts +14 -20
  1176. package/src/search-params/parse-total.ts +91 -0
  1177. package/src/search-params/serialize-equal.ts +14 -0
  1178. package/src/search-params/wrappers.ts +150 -0
  1179. package/src/server/access-gate.tsx +195 -56
  1180. package/src/server/action-client.ts +175 -294
  1181. package/src/server/action-encryption.ts +144 -0
  1182. package/src/server/action-handler.ts +492 -150
  1183. package/src/server/action-schema.ts +203 -0
  1184. package/src/server/action-types.ts +145 -0
  1185. package/src/server/actions.ts +172 -85
  1186. package/src/server/als-registry.ts +245 -30
  1187. package/src/server/body-limits.ts +10 -2
  1188. package/src/server/build-manifest.ts +33 -57
  1189. package/src/server/canonicalize.ts +35 -3
  1190. package/src/server/chain-url-parts.ts +163 -0
  1191. package/src/server/children-interception.ts +116 -0
  1192. package/src/server/client-error-message.ts +18 -0
  1193. package/src/server/coalesce-tick.ts +75 -0
  1194. package/src/server/compress.ts +91 -19
  1195. package/src/server/cookie-context.ts +454 -0
  1196. package/src/server/cookie-parsing.ts +163 -0
  1197. package/src/server/csp-nonce.ts +58 -0
  1198. package/src/server/csrf.ts +228 -35
  1199. package/src/server/debug.ts +0 -1
  1200. package/src/server/default-logger.ts +100 -0
  1201. package/src/server/default-status-page.ts +88 -0
  1202. package/src/server/deny-boundary.ts +527 -0
  1203. package/src/server/deny-renderer.ts +210 -181
  1204. package/src/server/early-hints-sender.ts +4 -3
  1205. package/src/server/early-hints.ts +39 -29
  1206. package/src/server/error-boundary-wrapper.ts +160 -44
  1207. package/src/server/error-response-headers.ts +18 -0
  1208. package/src/server/fallback-error.ts +88 -104
  1209. package/src/server/flight-injection-state.ts +113 -0
  1210. package/src/server/flight-injector-core.ts +328 -0
  1211. package/src/server/flight-scripts.ts +92 -0
  1212. package/src/server/flight-source-node.ts +430 -0
  1213. package/src/server/flight-source.ts +288 -0
  1214. package/src/server/form-data.ts +191 -20
  1215. package/src/server/form-state-flight.ts +67 -0
  1216. package/src/server/head-response.ts +50 -0
  1217. package/src/server/html-injector-core.ts +320 -0
  1218. package/src/server/html-injectors.ts +241 -285
  1219. package/src/server/index.ts +37 -195
  1220. package/src/server/instrumentation.ts +11 -4
  1221. package/src/server/internal.ts +168 -0
  1222. package/src/server/json-status-response.ts +105 -0
  1223. package/src/server/logger.ts +131 -38
  1224. package/src/server/metadata-collector.ts +175 -0
  1225. package/src/server/metadata-platform.ts +2 -2
  1226. package/src/server/metadata-render.ts +30 -8
  1227. package/src/server/metadata-route-links.ts +200 -0
  1228. package/src/server/metadata-routes.ts +114 -24
  1229. package/src/server/metadata-social.ts +2 -2
  1230. package/src/server/metadata.ts +23 -2
  1231. package/src/server/middleware-runner.ts +32 -5
  1232. package/src/server/node-body-response.ts +236 -0
  1233. package/src/server/node-response.ts +93 -0
  1234. package/src/server/node-stream-transforms.ts +340 -0
  1235. package/src/server/node-streams-platform.ts +23 -0
  1236. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1237. package/src/server/param-coercion.ts +201 -0
  1238. package/src/server/pipeline-helpers.ts +548 -0
  1239. package/src/server/pipeline-interception.ts +241 -32
  1240. package/src/server/pipeline-metadata.ts +25 -1
  1241. package/src/server/pipeline-outcome.ts +290 -0
  1242. package/src/server/pipeline-phases.ts +503 -0
  1243. package/src/server/pipeline.ts +423 -426
  1244. package/src/server/port-resolution.ts +43 -0
  1245. package/src/server/prebuilt/cache-key.ts +299 -0
  1246. package/src/server/prebuilt/capture-render.ts +118 -0
  1247. package/src/server/prebuilt/capture-routes.ts +104 -0
  1248. package/src/server/prebuilt/capture-state.ts +196 -0
  1249. package/src/server/prebuilt/key-discipline.ts +122 -0
  1250. package/src/server/prebuilt/lifetime.ts +151 -0
  1251. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1252. package/src/server/prebuilt/overlay.ts +256 -0
  1253. package/src/server/prebuilt/payload-source.ts +202 -0
  1254. package/src/server/prebuilt/slots.ts +202 -0
  1255. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1256. package/src/server/prebuilt-builder.ts +514 -0
  1257. package/src/server/prebuilt-runtime.ts +810 -0
  1258. package/src/server/primitives.ts +153 -171
  1259. package/src/server/publish-params.ts +42 -0
  1260. package/src/server/react-cache-bridge.ts +124 -0
  1261. package/src/server/react-cache-scope.ts +104 -0
  1262. package/src/server/render-timeout.ts +128 -0
  1263. package/src/server/render-utils.ts +45 -0
  1264. package/src/server/request-context.ts +298 -324
  1265. package/src/server/request-dep.ts +37 -0
  1266. package/src/server/response-cache-policy.ts +45 -0
  1267. package/src/server/route-element-builder.ts +526 -355
  1268. package/src/server/route-element-helpers.ts +37 -0
  1269. package/src/server/route-handler.ts +67 -27
  1270. package/src/server/route-matcher.ts +238 -267
  1271. package/src/server/route-module-loader.ts +161 -0
  1272. package/src/server/rsc-cache-key-guard.ts +122 -0
  1273. package/src/server/rsc-entry/action-dispatcher.ts +144 -0
  1274. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1275. package/src/server/rsc-entry/api-handler.ts +49 -81
  1276. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1277. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1278. package/src/server/rsc-entry/helpers.ts +90 -115
  1279. package/src/server/rsc-entry/index.ts +372 -350
  1280. package/src/server/rsc-entry/render-route.ts +248 -0
  1281. package/src/server/rsc-entry/render-signals.ts +108 -0
  1282. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1283. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1284. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1285. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1286. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1287. package/src/server/rsc-error-envelope.ts +18 -0
  1288. package/src/server/rsc-prop-warnings.ts +1 -1
  1289. package/src/server/safe-load.ts +53 -0
  1290. package/src/server/schema-introspection.ts +393 -0
  1291. package/src/server/sensitive-fields.ts +287 -0
  1292. package/src/server/server-only-guard-noop.js +3 -0
  1293. package/src/server/server-timing.ts +1 -1
  1294. package/src/server/signal-identity.ts +112 -0
  1295. package/src/server/sitemap-generator.ts +337 -0
  1296. package/src/server/sitemap-handler.ts +150 -0
  1297. package/src/server/skippable-prefix.ts +172 -0
  1298. package/src/server/slot-interception.ts +168 -0
  1299. package/src/server/slot-resolver.ts +707 -300
  1300. package/src/server/slot-subtree-contain.ts +273 -0
  1301. package/src/server/ssr-bridge-types.ts +217 -0
  1302. package/src/server/ssr-entry.ts +248 -109
  1303. package/src/server/ssr-form-state.ts +58 -0
  1304. package/src/server/ssr-render.ts +334 -101
  1305. package/src/server/ssr-wrappers.tsx +162 -0
  1306. package/src/server/state-tree-diff.ts +85 -30
  1307. package/src/server/static-generator.ts +680 -0
  1308. package/src/server/static-not-found.ts +134 -0
  1309. package/src/server/status-code-resolver.ts +107 -148
  1310. package/src/server/stream-utils.ts +398 -0
  1311. package/src/server/tracing.ts +163 -68
  1312. package/src/server/tree-match.ts +494 -0
  1313. package/src/server/types.ts +96 -11
  1314. package/src/server/utils/element-type.ts +88 -0
  1315. package/src/server/utils/escape-html.ts +20 -0
  1316. package/src/server/version-skew.ts +104 -0
  1317. package/src/server/waituntil-bridge.ts +1 -1
  1318. package/src/server/workers-cache-bridge.ts +33 -0
  1319. package/src/shared/als-slots.ts +74 -0
  1320. package/src/shared/base-path.ts +80 -0
  1321. package/src/shared/csrf-reject.ts +15 -0
  1322. package/src/shared/error-digest.ts +46 -0
  1323. package/src/shared/flight-base64.ts +23 -0
  1324. package/src/shared/flight-segment.ts +35 -0
  1325. package/src/shared/form-state-flight.ts +59 -0
  1326. package/src/shared/href-validation.ts +159 -0
  1327. package/src/shared/merge-search-params.ts +55 -0
  1328. package/src/shared/param-value.ts +281 -0
  1329. package/src/shared/payload-root.ts +153 -0
  1330. package/src/shared/redirect-type.ts +17 -0
  1331. package/src/shared/rsc-cache-key.ts +269 -0
  1332. package/src/shared/rsc-error-envelope.ts +16 -0
  1333. package/src/shared/rsc-manifest.ts +29 -0
  1334. package/src/shared/rsc-media-type.ts +59 -0
  1335. package/src/shared/rsc-payload-path.ts +52 -0
  1336. package/src/shared/segment-info.ts +67 -0
  1337. package/src/shared/slot-params.ts +109 -0
  1338. package/src/shared/static-platform-files.ts +75 -0
  1339. package/src/shared/status-reason-phrase.ts +61 -0
  1340. package/src/shims/font-google.ts +1 -1
  1341. package/src/shims/font-local.ts +34 -0
  1342. package/src/shims/headers.ts +122 -1
  1343. package/src/shims/navigation-client.ts +36 -32
  1344. package/src/shims/navigation-rsc.ts +47 -0
  1345. package/src/shims/navigation.ts +10 -7
  1346. package/src/utils/state-machine.ts +111 -0
  1347. package/src/utils/write-file-atomic.ts +32 -0
  1348. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1349. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1350. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1351. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1352. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1353. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1354. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1355. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1356. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1357. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1358. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1359. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1360. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1361. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1362. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1363. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1364. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1365. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1366. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1367. package/dist/adapters/cloudflare.js.map +0 -1
  1368. package/dist/cache/index.js.map +0 -1
  1369. package/dist/cache/register-cached-function.d.ts +0 -17
  1370. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1371. package/dist/client/browser-entry.d.ts +0 -21
  1372. package/dist/client/browser-entry.d.ts.map +0 -1
  1373. package/dist/client/error-boundary.js.map +0 -1
  1374. package/dist/client/head.d.ts +0 -16
  1375. package/dist/client/head.d.ts.map +0 -1
  1376. package/dist/client/link-status-provider.d.ts +0 -11
  1377. package/dist/client/link-status-provider.d.ts.map +0 -1
  1378. package/dist/client/segment-merger.d.ts +0 -119
  1379. package/dist/client/segment-merger.d.ts.map +0 -1
  1380. package/dist/client/stale-reload.d.ts +0 -44
  1381. package/dist/client/stale-reload.d.ts.map +0 -1
  1382. package/dist/client/transition-root.d.ts +0 -74
  1383. package/dist/client/transition-root.d.ts.map +0 -1
  1384. package/dist/client/types.d.ts +0 -14
  1385. package/dist/client/types.d.ts.map +0 -1
  1386. package/dist/client/use-navigation-pending.d.ts +0 -26
  1387. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1388. package/dist/client/use-params.d.ts +0 -92
  1389. package/dist/client/use-params.d.ts.map +0 -1
  1390. package/dist/content/index.d.ts +0 -11
  1391. package/dist/content/index.d.ts.map +0 -1
  1392. package/dist/content/index.js +0 -2
  1393. package/dist/plugins/adapter-build.d.ts +0 -18
  1394. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1395. package/dist/plugins/cache-transform.d.ts +0 -36
  1396. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1397. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1398. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1399. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1400. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1401. package/dist/plugins/server-action-exports.d.ts +0 -26
  1402. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1403. package/dist/routing/status-file-lint.d.ts +0 -33
  1404. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1405. package/dist/search-params/analyze.d.ts +0 -54
  1406. package/dist/search-params/analyze.d.ts.map +0 -1
  1407. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1408. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1409. package/dist/search-params/codecs.d.ts +0 -53
  1410. package/dist/search-params/codecs.d.ts.map +0 -1
  1411. package/dist/search-params/create.d.ts +0 -106
  1412. package/dist/search-params/create.d.ts.map +0 -1
  1413. package/dist/search-params/registry.d.ts +0 -20
  1414. package/dist/search-params/registry.d.ts.map +0 -1
  1415. package/dist/server/asset-headers.d.ts +0 -42
  1416. package/dist/server/asset-headers.d.ts.map +0 -1
  1417. package/dist/server/client-module-map.d.ts +0 -47
  1418. package/dist/server/client-module-map.d.ts.map +0 -1
  1419. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1420. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1421. package/dist/server/dev-logger.d.ts.map +0 -1
  1422. package/dist/server/dev-span-processor.d.ts +0 -29
  1423. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1424. package/dist/server/dev-warnings.d.ts +0 -129
  1425. package/dist/server/dev-warnings.d.ts.map +0 -1
  1426. package/dist/server/flush.d.ts +0 -74
  1427. package/dist/server/flush.d.ts.map +0 -1
  1428. package/dist/server/form-flash.d.ts +0 -78
  1429. package/dist/server/form-flash.d.ts.map +0 -1
  1430. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1431. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1432. package/dist/server/prerender.d.ts +0 -77
  1433. package/dist/server/prerender.d.ts.map +0 -1
  1434. package/dist/server/tree-builder.d.ts +0 -126
  1435. package/dist/server/tree-builder.d.ts.map +0 -1
  1436. package/dist/utils/directive-parser.d.ts +0 -70
  1437. package/dist/utils/directive-parser.d.ts.map +0 -1
  1438. package/src/cache/register-cached-function.ts +0 -103
  1439. package/src/client/browser-entry.ts +0 -678
  1440. package/src/client/head.ts +0 -61
  1441. package/src/client/link-status-provider.tsx +0 -30
  1442. package/src/client/segment-merger.ts +0 -339
  1443. package/src/client/stale-reload.ts +0 -87
  1444. package/src/client/transition-root.tsx +0 -166
  1445. package/src/client/types.ts +0 -21
  1446. package/src/client/use-navigation-pending.ts +0 -38
  1447. package/src/client/use-params.ts +0 -141
  1448. package/src/content/index.ts +0 -13
  1449. package/src/plugins/adapter-build.ts +0 -118
  1450. package/src/plugins/cache-transform.ts +0 -199
  1451. package/src/plugins/dynamic-transform.ts +0 -161
  1452. package/src/plugins/server-action-exports.ts +0 -220
  1453. package/src/routing/status-file-lint.ts +0 -112
  1454. package/src/search-params/analyze.ts +0 -192
  1455. package/src/search-params/builtin-codecs.ts +0 -228
  1456. package/src/search-params/codecs.ts +0 -153
  1457. package/src/search-params/create.ts +0 -321
  1458. package/src/search-params/registry.ts +0 -31
  1459. package/src/server/asset-headers.ts +0 -81
  1460. package/src/server/client-module-map.ts +0 -58
  1461. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1462. package/src/server/dev-span-processor.ts +0 -78
  1463. package/src/server/dev-warnings.ts +0 -283
  1464. package/src/server/flush.ts +0 -182
  1465. package/src/server/form-flash.ts +0 -89
  1466. package/src/server/manifest-status-resolver.ts +0 -215
  1467. package/src/server/prerender.ts +0 -139
  1468. package/src/server/tree-builder.ts +0 -382
  1469. package/src/shims/server-only-noop.js +0 -6
  1470. package/src/utils/directive-parser.ts +0 -529
@@ -8,7 +8,8 @@
8
8
  * 1. Detect action request (POST with `x-rsc-action` header or form action fields)
9
9
  * 2. CSRF validation
10
10
  * 3. Load and execute the server action
11
- * 4. Return RSC stream (with-JS) or 302 redirect (no-JS)
11
+ * 4. Return RSC stream (with-JS), or on the no-JS path a redirect, a page
12
+ * rerender carrying React's form state, or the error page
12
13
  *
13
14
  * See design/08-forms-and-actions.md
14
15
  */
@@ -17,20 +18,30 @@ import {
17
18
  loadServerAction,
18
19
  decodeReply,
19
20
  decodeAction,
20
- renderToReadableStream,
21
- } from '#/rsc-runtime/rsc.js';
22
-
23
- import { validateCsrf, type CsrfConfig } from './csrf.js';
24
- import { executeAction, type RevalidateRenderer } from './actions.js';
25
- import {
26
- runWithRequestContext,
27
- setMutableCookieContext,
28
- getSetCookieHeaders,
29
- } from './request-context.js';
30
- import { handleActionError } from './action-client.js';
31
- import { enforceBodyLimits, enforceFieldLimit, type BodyLimitsConfig } from './body-limits.js';
32
- import { parseFormData } from './form-data.js';
33
- import type { FormFlashData } from './form-flash.js';
21
+ decodeFormState,
22
+ renderFlight,
23
+ } from '../rsc-runtime/rsc.ts';
24
+ import { flightChunkBytes, flightResponse, openFlightReader } from './flight-source.ts';
25
+ import { concatBytes } from './stream-utils.ts';
26
+
27
+ import { validateCsrf, csrfRejectionResponse, type CsrfConfig } from './csrf.ts';
28
+ import { isDenySignal, isRedirectSignal } from './signal-identity.ts';
29
+ import { executeAction, type RevalidateRenderer } from './actions.ts';
30
+ import { runWithRequestContext, setMutableCookieContext } from './request-context.ts';
31
+ import { runOutsideReactCacheScope, runWithReactCacheScope } from './react-cache-scope.ts';
32
+ import { getSetCookieHeaders, getCookiesForSsr } from './cookie-context.ts';
33
+ import { ActionError } from './action-client.ts';
34
+ import { enforceBodyLimits, enforceFieldLimit, type BodyLimitsConfig } from './body-limits.ts';
35
+ import { randomUUID } from 'node:crypto';
36
+ import type { ReactFormState } from 'react-dom/client';
37
+ import { encodeErrorDigest } from '../shared/error-digest.ts';
38
+ import { clientErrorMessage } from './client-error-message.ts';
39
+ import { checkVersionSkew, applyReloadHeaders } from './version-skew.ts';
40
+ import { logActionError, swallow } from './logger.ts';
41
+ import { fireOnRequestError } from './pipeline-helpers.ts';
42
+ import { withTimeout, RenderTimeoutError, DEFAULT_RENDER_TIMEOUT_MS } from './render-timeout.ts';
43
+ import { canonicalize } from './canonicalize.ts';
44
+ import { RSC_CONTENT_TYPE } from '../shared/rsc-media-type.ts';
34
45
 
35
46
  // ─── Types ────────────────────────────────────────────────────────────────
36
47
 
@@ -44,10 +55,6 @@ export interface ActionDispatchConfig {
44
55
  bodyLimits?: BodyLimitsConfig;
45
56
  }
46
57
 
47
- // ─── Constants ────────────────────────────────────────────────────────────
48
-
49
- const RSC_CONTENT_TYPE = 'text/x-component';
50
-
51
58
  // ─── Detection ────────────────────────────────────────────────────────────
52
59
 
53
60
  /**
@@ -57,6 +64,12 @@ const RSC_CONTENT_TYPE = 'text/x-component';
57
64
  * - With JS: POST with `x-rsc-action` header (client callServer dispatch)
58
65
  * - Without JS: POST with form data containing `$ACTION_REF` or `$ACTION_KEY`
59
66
  * (React's progressive enhancement hidden fields)
67
+ *
68
+ * **Important:** This function returns true for ANY POST with a form
69
+ * Content-Type, including non-action POSTs to route.ts API handlers.
70
+ * The caller (rsc-entry/action-dispatcher.ts) MUST check the matched route type
71
+ * before entering the action path — route.ts matches skip action detection
72
+ * entirely so their body is not pre-parsed. See TIM-870.
60
73
  */
61
74
  export function isActionRequest(req: Request): boolean {
62
75
  if (req.method !== 'POST') return false;
@@ -75,25 +88,97 @@ export function isActionRequest(req: Request): boolean {
75
88
 
76
89
  // ─── Handler ──────────────────────────────────────────────────────────────
77
90
 
78
- /** Signal from handleFormAction to re-render the page with flash data instead of redirecting. */
79
- export interface FormRerender {
80
- rerender: FormFlashData;
81
- }
91
+ /**
92
+ * How a no-JS action that did not redirect is answered. The dispatcher
93
+ * (`rsc-entry/action-dispatcher.ts`) turns it into the response:
94
+ *
95
+ * - `rerender`: the action returned. The page is rendered again as a GET,
96
+ * with `formState` — React's `decodeFormState` of the result, present
97
+ * only when the submitted form used `useActionState` — handed to SSR
98
+ * and hydration, where React gives it to the hook that submitted.
99
+ * - `error`: the action threw. The page is rendered again with the error
100
+ * in place of the page component, so the route's nearest error page
101
+ * answers, with the
102
+ * status the pipeline gives any unhandled error. The JS path rejects
103
+ * the action for the same throw, so both reach an error boundary.
104
+ *
105
+ * Carries two cookie-related snapshots taken before the action's ALS scope
106
+ * exits, so the rerender pipeline (which establishes its own fresh cookie
107
+ * jar from the original request) doesn't lose the action's mutations:
108
+ *
109
+ * - `setCookieHeaders`: serialized Set-Cookie headers to append to the
110
+ * final HTML response. Without this, cookies set inside the action are
111
+ * silently dropped from the response. See TIM-836 (LOCAL-740).
112
+ *
113
+ * - `cookies`: the post-action read-your-own-writes view of the cookie
114
+ * jar, as the same `Map<string, string>` shape used by the request
115
+ * context's `parsedCookies`. The rerender dispatcher passes this map to
116
+ * the pipeline's re-entry, which makes it the rerender request
117
+ * context's cookies, bypassing any string round-trip through a
118
+ * `Cookie:` header. The
119
+ * direct Map eliminates the value-smuggling primitive that the
120
+ * previous `cookieHeader: string` shape carried — see
121
+ * ONGOING_SECURITY.md H-3 (TIM-868) and TIM-837.
122
+ */
123
+ export type FormActionOutcome =
124
+ | {
125
+ kind: 'rerender';
126
+ formState: ReactFormState | undefined;
127
+ setCookieHeaders: string[];
128
+ cookies: Map<string, string>;
129
+ }
130
+ | {
131
+ kind: 'error';
132
+ error: unknown;
133
+ errorId: string;
134
+ setCookieHeaders: string[];
135
+ cookies: Map<string, string>;
136
+ };
137
+
138
+ /** What `handleFormAction` settles with, before the cookie snapshot. */
139
+ type FormActionSettled =
140
+ | { kind: 'rerender'; formState: ReactFormState | undefined }
141
+ | { kind: 'error'; error: unknown; errorId: string };
82
142
 
83
143
  /**
84
144
  * Handle a server action request.
85
145
  *
86
- * Returns a Response, a FormRerender signal (for no-JS validation failure re-render),
146
+ * Returns a Response, a FormActionOutcome (no-JS action that did not redirect),
87
147
  * or null if this isn't actually an action request (e.g., a regular form POST to an API route).
88
148
  */
89
149
  export async function handleActionRequest(
90
150
  req: Request,
91
151
  config: ActionDispatchConfig
92
- ): Promise<Response | FormRerender | null> {
152
+ ): Promise<Response | FormActionOutcome | null> {
153
+ // Version skew detection — reject actions from stale clients (TIM-446).
154
+ // On mismatch, return a structured RSC error response that the client
155
+ // handles by showing a brief "App updated" message and reloading.
156
+ const skewCheck = checkVersionSkew(req);
157
+ if (!skewCheck.ok) {
158
+ const reloadHeaders = new Headers({
159
+ 'Content-Type': RSC_CONTENT_TYPE,
160
+ });
161
+ applyReloadHeaders(reloadHeaders);
162
+ // Return the reload signal as an RSC stream so createFromFetch can
163
+ // decode it. The client checks X-Timber-Reload before processing.
164
+ return flightPayloadResponse(
165
+ req,
166
+ { _versionSkew: true },
167
+ { status: 200, headers: reloadHeaders }
168
+ );
169
+ }
170
+
93
171
  // CSRF validation — reject cross-origin mutation requests.
172
+ //
173
+ // Defense-in-depth: the pipeline's CSRF gate (`csrfGate`) already checks
174
+ // every unsafe-method request before dispatch reaches here, so this call
175
+ // is a no-op on the happy path. It is intentionally retained so that
176
+ // handleActionRequest remains safe to call from any entry point that
177
+ // bypasses the gate — and it never applies the per-route exemption, which
178
+ // is for route.ts only. See LOCAL-773, TIM-1543.
94
179
  const csrfResult = validateCsrf(req, config.csrf);
95
180
  if (!csrfResult.ok) {
96
- return new Response(null, { status: csrfResult.status });
181
+ return csrfRejectionResponse(req, csrfResult);
97
182
  }
98
183
 
99
184
  // Body size limits — reject oversized requests before parsing.
@@ -106,33 +191,187 @@ export async function handleActionRequest(
106
191
  return new Response(null, { status: limitsResult.status });
107
192
  }
108
193
 
109
- // Run inside request context so headers(), cookies() work in actions.
194
+ // Run inside request context so getHeaders(), getCookies() work in actions.
110
195
  // Actions are a mutable context — they can set cookies (design/29-cookies.md).
111
- return runWithRequestContext(req, async () => {
112
- setMutableCookieContext(true);
113
- const actionId = req.headers.get('x-rsc-action');
114
-
115
- let result: Response | FormRerender | null;
116
- if (actionId) {
117
- // With-JS path: client sent action ID in header, args in body
118
- result = await handleRscAction(req, actionId, config);
119
- } else {
120
- // No-JS path: form POST with React's hidden action fields
121
- result = await handleFormAction(req, config);
122
- }
123
-
124
- // Apply cookie jar to action responses
125
- if (result instanceof Response) {
126
- for (const value of getSetCookieHeaders()) {
127
- result.headers.append('Set-Cookie', value);
196
+ //
197
+ // ...and outside any React.cache scope: dispatch runs inside the pipeline's
198
+ // request scope (after proxy.ts), and runWithRequestContext would open
199
+ // another. An action reads, writes cookies, and mutates, so a memoized read
200
+ // would go stale mid-action — React.cache in an action does not dedupe,
201
+ // same as stock React and Next.js (TIM-1529 D2). The revalidation render
202
+ // below re-enters its own fresh scope explicitly.
203
+ return runWithRequestContext(req, () =>
204
+ runOutsideReactCacheScope(async () => {
205
+ setMutableCookieContext(true);
206
+ const actionId = req.headers.get('x-rsc-action');
207
+
208
+ // With-JS path: client sent action ID in header, args in body.
209
+ // No-JS path: form POST with React's hidden action fields.
210
+ const result = actionId
211
+ ? await handleRscAction(req, actionId, config)
212
+ : await handleFormAction(req, config);
213
+
214
+ // Apply cookie jar to action responses.
215
+ //
216
+ // For a Response we append Set-Cookie directly. For a no-JS outcome we
217
+ // snapshot the headers here, before this ALS scope exits, so the
218
+ // dispatcher can apply them to the response it builds (the rerender
219
+ // runs in its own request-context scope with a fresh cookie jar).
220
+ // See LOCAL-740 — without this snapshot, cookies set inside a no-JS
221
+ // form action are silently dropped.
222
+ if (result === null) return null;
223
+ if (result instanceof Response) {
224
+ for (const value of getSetCookieHeaders()) {
225
+ result.headers.append('Set-Cookie', value);
226
+ }
227
+ return result;
128
228
  }
129
- }
130
- return result;
131
- });
229
+ const setCookieHeaders = getSetCookieHeaders();
230
+ // Snapshot the post-action RYW cookie state as a Map so the rerender
231
+ // dispatcher can hand it to the rerender request context directly,
232
+ // with no string round-trip. See TIM-837
233
+ // and ONGOING_SECURITY.md H-3 (TIM-868). `getCookiesForSsr` already
234
+ // returns a defensive copy, so the rerender scope cannot mutate the
235
+ // snapshot through this reference.
236
+ return { ...result, setCookieHeaders, cookies: getCookiesForSsr() };
237
+ })
238
+ );
132
239
  }
133
240
 
134
241
  // ─── With-JS Action ───────────────────────────────────────────────────────
135
242
 
243
+ /**
244
+ * Log an action error and report it to `onRequestError` as phase
245
+ * `'action'`. An `ActionError` is not reported: it is an outcome the
246
+ * action chose to return, not an unhandled error.
247
+ */
248
+ async function reportActionError(req: Request, error: unknown, errorId?: string): Promise<void> {
249
+ logActionError({ method: req.method, path: new URL(req.url).pathname, error, errorId });
250
+ if (error instanceof ActionError) return;
251
+ await fireOnRequestError(error, req, 'action');
252
+ }
253
+
254
+ /**
255
+ * Report errors the action survived after its body returned — from
256
+ * `executeAction`'s revalidation, or from serializing the revalidated tree.
257
+ * Each is logged where it was caught; this is its one `onRequestError`
258
+ * report, as phase `'action'`. Errors that are not reportable (a
259
+ * signal a revalidated page threw, an abort) and anything
260
+ * after the request aborted are skipped by the same rule as a page render.
261
+ */
262
+ async function reportRevalidationErrors(req: Request, errors: readonly unknown[]): Promise<void> {
263
+ for (const error of errors) {
264
+ await fireOnRequestError(error, req, 'action').catch((hookError: unknown) =>
265
+ swallow(hookError, 'onRequestError could not be called')
266
+ );
267
+ }
268
+ }
269
+
270
+ /**
271
+ * Answer an action request that failed before the action ran with a bare
272
+ * status, never a 200 action-error payload: a fabricated action id must not
273
+ * look like an action that ran (tests/e2e/security.test.ts). Either way it
274
+ * is logged and reported to `onRequestError` as phase `'action'` (TIM-1537).
275
+ *
276
+ * The status is chosen by what failed, not by matching error messages:
277
+ * - **400**: the request is wrong in a way the handler can see for itself.
278
+ * The body will not parse or decode, or the reference resolves to
279
+ * something that is not a function.
280
+ * - **500**: loading the action module failed. plugin-rsc rejects the same
281
+ * way for an unknown reference and for a real module that fails to import
282
+ * or evaluate, and the second is a server fault, so the load failure keeps
283
+ * the 5xx it had before this change. The no-JS path cannot make this
284
+ * split (`decodeAction` decodes and loads in one call) and answers 400;
285
+ * see `handleFormAction`.
286
+ */
287
+ async function rejectActionRequest(
288
+ req: Request,
289
+ error: unknown,
290
+ status: 400 | 500
291
+ ): Promise<Response> {
292
+ await reportActionError(req, error);
293
+ return new Response(null, { status });
294
+ }
295
+
296
+ /**
297
+ * The with-JS answer to an action that threw: the action rejects on the
298
+ * client and the nearest error boundary renders, as React does for any
299
+ * server function that throws. The no-JS path answers the same throw with
300
+ * the error page, so both reach an error boundary and neither turns the
301
+ * throw into state the action never returned. `createActionClient`
302
+ * actions never get here: they catch into a `serverError` result.
303
+ *
304
+ * The error crosses as a rejected Flight root carrying the digest a render
305
+ * error carries (shared/error-digest.ts): its message in dev, a fixed one in
306
+ * production (design/13-security.md §"Errors don't leak"), and the
307
+ * correlation ID the server logged it with.
308
+ */
309
+ async function rejectedActionResponse(req: Request, error: unknown): Promise<Response> {
310
+ const errorId = randomUUID();
311
+ await reportActionError(req, error, errorId);
312
+ const rejection = Promise.reject(error);
313
+ // Flight subscribes when it renders the root, after this tick; the no-op
314
+ // handler keeps the rejection from being reported as unhandled first.
315
+ rejection.catch(() => {});
316
+ return flightPayloadResponse(
317
+ req,
318
+ rejection,
319
+ { status: 500, headers: { 'Content-Type': RSC_CONTENT_TYPE } },
320
+ { onError: () => encodeErrorDigest({ message: clientErrorMessage(error), errorId }) }
321
+ );
322
+ }
323
+
324
+ /**
325
+ * Load the action by reference ID and decode its args from the request body
326
+ * (RSC wire format). Returns a Response for a request that fails before the
327
+ * action can run: see `rejectActionRequest` for the status, and the field
328
+ * limit for its own.
329
+ */
330
+ async function decodeRscActionCall(
331
+ req: Request,
332
+ actionId: string,
333
+ config: ActionDispatchConfig
334
+ ): Promise<{ actionFn: (...args: unknown[]) => Promise<unknown>; args: unknown[] } | Response> {
335
+ let loaded: unknown;
336
+ try {
337
+ loaded = await loadServerAction(actionId);
338
+ } catch (error) {
339
+ return rejectActionRequest(req, error, 500);
340
+ }
341
+ if (typeof loaded !== 'function') {
342
+ // The module loaded but has no such export: a reference the client made up.
343
+ return rejectActionRequest(req, new Error(`Unknown server action "${actionId}"`), 400);
344
+ }
345
+ const actionFn = loaded as (...args: unknown[]) => Promise<unknown>;
346
+
347
+ let decoded: unknown;
348
+ try {
349
+ const contentType = req.headers.get('Content-Type') ?? '';
350
+ if (contentType.includes('multipart/form-data')) {
351
+ // FormData-based args (file uploads, etc.)
352
+ const formData = await req.formData();
353
+ // Enforce field count limit after parsing FormData.
354
+ const fieldResult = enforceFieldLimit(formData, config.bodyLimits ?? {});
355
+ if (!fieldResult.ok) {
356
+ return new Response(null, { status: fieldResult.status });
357
+ }
358
+ decoded = await decodeReply(formData);
359
+ } else {
360
+ // Text-based args
361
+ decoded = await decodeReply(await req.text());
362
+ }
363
+ } catch (error) {
364
+ return rejectActionRequest(req, error, 400);
365
+ }
366
+ // The client always encodes an argument list. Anything else would fail
367
+ // when `executeAction` spreads it, inside the action's own catch, and
368
+ // come back as a 200 INTERNAL_ERROR for what is the caller's mistake.
369
+ if (!Array.isArray(decoded)) {
370
+ return rejectActionRequest(req, new Error('Server action body is not an argument list'), 400);
371
+ }
372
+ return { actionFn, args: decoded };
373
+ }
374
+
136
375
  /**
137
376
  * Handle an RSC action request (JavaScript enabled).
138
377
  *
@@ -144,50 +383,30 @@ async function handleRscAction(
144
383
  actionId: string,
145
384
  config: ActionDispatchConfig
146
385
  ): Promise<Response> {
147
- // Load the server action function by reference ID
148
- const actionFn = (await loadServerAction(actionId)) as (...args: unknown[]) => Promise<unknown>;
149
-
150
- // Decode the args from the request body (RSC wire format)
151
- const contentType = req.headers.get('Content-Type') ?? '';
152
- let args: unknown[];
153
-
154
- if (contentType.includes('multipart/form-data')) {
155
- // FormData-based args (file uploads, etc.)
156
- const formData = await req.formData();
157
- // Enforce field count limit after parsing FormData.
158
- const fieldResult = enforceFieldLimit(formData, config.bodyLimits ?? {});
159
- if (!fieldResult.ok) {
160
- return new Response(null, { status: fieldResult.status });
161
- }
162
- args = (await decodeReply(formData)) as unknown[];
163
- } else {
164
- // Text-based args
165
- const body = await req.text();
166
- args = (await decodeReply(body)) as unknown[];
167
- }
386
+ // A request that fails before the action runs is answered here, not a
387
+ // rejection that escapes into the pipeline (TIM-1537).
388
+ const call = await decodeRscActionCall(req, actionId, config);
389
+ if (call instanceof Response) return call;
168
390
 
169
- // Execute the action with revalidation tracking.
170
- // Errors are caught here so raw 'use server' functions (not using
171
- // createActionClient) still return structured error responses instead
172
- // of leaking stack traces as 500s.
391
+ // Execute the action with revalidation tracking. A throw is answered
392
+ // with a rejected action (below), never a stack trace.
173
393
  let result;
174
394
  try {
175
- result = await executeAction(actionFn, args, {
395
+ const requestUrl = new URL(req.url);
396
+ // Canonicalize the request pathname so it matches the decoded form
397
+ // that revalidationPathMatches uses on the target side.
398
+ const canonical = canonicalize(requestUrl.pathname, true);
399
+ result = await executeAction(call.actionFn, call.args, {
176
400
  renderer: config.revalidateRenderer,
401
+ requestPathname: canonical.ok ? canonical.pathname : requestUrl.pathname,
402
+ requestSearch: requestUrl.search,
177
403
  });
178
404
  } catch (error) {
179
- // Log full error server-side for debugging
180
- console.error('[timber] server action error:', error);
181
-
182
- // Return structured error response — ActionError gets its code/data,
183
- // unexpected errors get sanitized { code: 'INTERNAL_ERROR' }
184
- const errorResult = handleActionError(error);
185
- const rscStream = renderToReadableStream(errorResult);
186
- return new Response(rscStream, {
187
- status: 200,
188
- headers: { 'Content-Type': RSC_CONTENT_TYPE },
189
- });
405
+ return rejectedActionResponse(req, error);
190
406
  }
407
+ // Outside the try: the action succeeded, and a failure to report its
408
+ // revalidation must not turn it into an action error.
409
+ await reportRevalidationErrors(req, result.revalidationErrors);
191
410
 
192
411
  // Handle redirect — encode in RSC stream for client-side SPA navigation.
193
412
  // The client detects X-Timber-Redirect and calls router.navigate() instead
@@ -197,47 +416,170 @@ async function handleRscAction(
197
416
  _redirect: result.redirectTo,
198
417
  _status: result.redirectStatus ?? 302,
199
418
  };
200
- const rscStream = renderToReadableStream(redirectPayload);
201
- return new Response(rscStream, {
202
- status: 200,
203
- headers: {
204
- 'Content-Type': RSC_CONTENT_TYPE,
205
- 'X-Timber-Redirect': result.redirectTo,
206
- },
207
- });
419
+ const redirectHeaders: Record<string, string> = {
420
+ 'Content-Type': RSC_CONTENT_TYPE,
421
+ 'X-Timber-Redirect': result.redirectTo,
422
+ };
423
+ if (result.onlyOtherPagesNamed) {
424
+ redirectHeaders['X-Timber-Invalidated'] = '1';
425
+ }
426
+ return flightPayloadResponse(req, redirectPayload, { status: 200, headers: redirectHeaders });
208
427
  }
209
428
 
210
429
  // Render the action result as an RSC stream.
211
430
  // When revalidatePath was called, piggyback the revalidated element tree
212
- // alongside the action result in a single renderToReadableStream call.
431
+ // alongside the action result in a single Flight render.
213
432
  // The client detects the X-Timber-Revalidation header and unpacks both.
214
433
  const headers: Record<string, string> = {
215
434
  'Content-Type': RSC_CONTENT_TYPE,
216
435
  };
217
436
 
218
- let payload: unknown;
437
+ // TIM-1454: Tell the client that revalidatePath named only other pages. A
438
+ // flag, not a path list: the client evicts every cached payload either
439
+ // way (TIM-1461).
440
+ if (result.onlyOtherPagesNamed) {
441
+ headers['X-Timber-Invalidated'] = '1';
442
+ }
443
+
219
444
  if (result.revalidation) {
220
445
  // Wrapper object — Next.js-style pattern: action result + element tree
221
446
  // serialized together so React Flight handles both in one stream.
222
- payload = {
447
+ const revalidationPayload = {
223
448
  _action: result.actionResult,
224
- _tree: result.revalidation.element,
449
+ // The payload root, not a bare tree: it carries the revalidated
450
+ // route's params too, and the client publishes them (TIM-1297).
451
+ _tree: result.revalidation.payload,
225
452
  };
226
- headers['X-Timber-Revalidation'] = '1';
227
- // Forward head elements as JSON so the client can update <head>.
228
- if (result.revalidation.headElements.length > 0) {
229
- headers['X-Timber-Head'] = JSON.stringify(result.revalidation.headElements);
453
+
454
+ // TIM-1366: access.ts deny signals fire during serialization (inside
455
+ // AccessGate during the Flight render), not during buildRouteElement.
456
+ // Buffer the stream and track errors so we can drop the revalidation
457
+ // cleanly instead of shipping a broken flight stream. Access runs
458
+ // exactly once — during the real render — preserving TIM-1363.
459
+ let serializationSignal:
460
+ | { kind: 'deny'; status: number }
461
+ | { kind: 'redirect'; location: string; status: number }
462
+ | { kind: 'error' }
463
+ | undefined;
464
+ const serializationErrors: unknown[] = [];
465
+ //
466
+ // Rendered in the scope the revalidation middleware ran in, not this
467
+ // request context's: the action body read through that one before it
468
+ // mutated, and the revalidated tree must see post-mutation values
469
+ // (TIM-1529).
470
+ const rscStream = runWithReactCacheScope(
471
+ () =>
472
+ renderFlight(revalidationPayload, {
473
+ signal: req.signal,
474
+ onError(error: unknown) {
475
+ // ??= keeps the first signal (shallowest AccessGate in top-down render).
476
+ if (isDenySignal(error)) {
477
+ serializationSignal ??= { kind: 'deny', status: error.status };
478
+ } else if (isRedirectSignal(error)) {
479
+ serializationSignal ??= {
480
+ kind: 'redirect',
481
+ location: error.location,
482
+ status: error.status,
483
+ };
484
+ } else {
485
+ console.error('[timber] revalidation serialization error:', error);
486
+ serializationErrors.push(error);
487
+ serializationSignal ??= { kind: 'error' };
488
+ }
489
+ },
490
+ }),
491
+ result.revalidation.reactCacheScope
492
+ );
493
+
494
+ // Drain the stream to detect any signals before committing the response.
495
+ // Timeout-guarded: the element tree may contain async server components
496
+ // with stalled fetches. 30s matches the default renderTimeoutMs.
497
+ // Not readAllBytesWithDeadline: this timeout is per read, not one
498
+ // overall deadline; the loop stops at the first chunk after onError
499
+ // records a signal (the payload is dropped then); and the catch below
500
+ // branches on RenderTimeoutError, which the helper does not throw.
501
+ const reader = openFlightReader(rscStream);
502
+ const chunks: Uint8Array[] = [];
503
+ const drainTimeoutMs = DEFAULT_RENDER_TIMEOUT_MS;
504
+ try {
505
+ for (;;) {
506
+ const result = await withTimeout(
507
+ reader.read(),
508
+ drainTimeoutMs,
509
+ 'revalidation stream drain timed out'
510
+ );
511
+ if (result.done) break;
512
+ chunks.push(flightChunkBytes(result.value));
513
+ if (serializationSignal) {
514
+ reader.cancel();
515
+ break;
516
+ }
517
+ }
518
+ } catch (drainError) {
519
+ reader.cancel();
520
+ if (drainError instanceof RenderTimeoutError) {
521
+ console.error('[timber] revalidatePath dropped — stream drain timed out');
522
+ // A revalidated tree that never finished rendering is a failure,
523
+ // even though the action result still ships.
524
+ await reportRevalidationErrors(req, [...serializationErrors, drainError]);
525
+ return flightPayloadResponse(req, result.actionResult, { status: 200, headers });
526
+ }
527
+ await reportRevalidationErrors(req, serializationErrors);
528
+ throw drainError;
230
529
  }
231
- } else {
232
- payload = result.actionResult;
530
+
531
+ await reportRevalidationErrors(req, serializationErrors);
532
+ if (serializationSignal) {
533
+ if (serializationSignal.kind === 'redirect') {
534
+ const redirectPayload = {
535
+ _redirect: serializationSignal.location,
536
+ _status: serializationSignal.status,
537
+ };
538
+ return flightPayloadResponse(req, redirectPayload, {
539
+ status: 200,
540
+ headers: {
541
+ 'Content-Type': RSC_CONTENT_TYPE,
542
+ 'X-Timber-Redirect': serializationSignal.location,
543
+ },
544
+ });
545
+ }
546
+ // Deny or render error: drop the revalidation tree, ship the action result alone.
547
+ if (serializationSignal.kind === 'deny') {
548
+ console.error(
549
+ `[timber] revalidatePath dropped — access denied during render (status ${serializationSignal.status})`
550
+ );
551
+ }
552
+ return flightPayloadResponse(req, result.actionResult, { status: 200, headers });
553
+ }
554
+
555
+ // Clean serialization — return the buffered bytes with revalidation header.
556
+ headers['X-Timber-Revalidation'] = '1';
557
+ const buffered = concatBytes(chunks);
558
+ return new Response(buffered.buffer as ArrayBuffer, {
559
+ status: 200,
560
+ headers,
561
+ });
233
562
  }
234
563
 
235
- const rscStream = renderToReadableStream(payload);
564
+ return flightPayloadResponse(req, result.actionResult, { status: 200, headers });
565
+ }
566
+
567
+ // ─── Helpers ─────────────────────────────────────────────────────────────
236
568
 
237
- return new Response(rscStream, {
238
- status: 200,
239
- headers,
240
- });
569
+ /**
570
+ * A Flight payload response: the model rendered by `renderFlight`, sent
571
+ * through `flightResponse` (a Node body on Node, to the socket as is). The render
572
+ * stops when the client disconnects (`req.signal`) or, on Node, at the
573
+ * render deadline: an action result holding a promise that never settles
574
+ * would otherwise stream for as long as the client stays connected.
575
+ */
576
+ function flightPayloadResponse(
577
+ req: Request,
578
+ model: unknown,
579
+ init: ResponseInit,
580
+ options?: { onError?: (error: unknown) => string | void }
581
+ ): Response {
582
+ return flightResponse(renderFlight(model, { ...options, signal: req.signal }), init);
241
583
  }
242
584
 
243
585
  // ─── No-JS Form Action ───────────────────────────────────────────────────
@@ -246,17 +588,24 @@ async function handleRscAction(
246
588
  * Handle a no-JS form action (progressive enhancement fallback).
247
589
  *
248
590
  * React embeds `$ACTION_REF` / `$ACTION_KEY` hidden fields in the form.
249
- * We use `decodeAction` to resolve the action function from the form data,
250
- * execute it, then redirect back to the form's page.
591
+ * We use `decodeAction` to resolve the action function from the form data
592
+ * and execute it. A redirect is answered here; anything else settles as a
593
+ * `FormActionSettled` for the dispatcher to render.
251
594
  */
252
595
  async function handleFormAction(
253
596
  req: Request,
254
597
  config: ActionDispatchConfig
255
- ): Promise<Response | FormRerender | null> {
598
+ ): Promise<Response | FormActionSettled | null> {
256
599
  // Clone before consuming — if this turns out not to be a server action form,
257
600
  // we return null and the original request body must remain readable for
258
601
  // downstream route handlers. Clone is cheap (shares the body buffer until read).
259
- const formData = await req.clone().formData();
602
+ // A body that will not parse is a bad request (TIM-1537).
603
+ let formData: FormData;
604
+ try {
605
+ formData = await req.clone().formData();
606
+ } catch (error) {
607
+ return rejectActionRequest(req, error, 400);
608
+ }
260
609
 
261
610
  // Enforce field count limit after parsing FormData.
262
611
  const fieldResult = enforceFieldLimit(formData, config.bodyLimits ?? {});
@@ -264,48 +613,40 @@ async function handleFormAction(
264
613
  return new Response(null, { status: fieldResult.status });
265
614
  }
266
615
 
267
- // Check if this is actually a React server action form.
268
- // If there's no $ACTION_REF_* or $ACTION_KEY, it's a regular form POST
269
- // that should be handled by the route's route handler, not here.
270
- // React uses `$ACTION_REF_` + identifierPrefix — since we don't set one,
271
- // the suffix is empty. Check for any key starting with $ACTION_REF_ or $ACTION_ID_.
272
- const allKeys = [...formData.keys()];
273
- const hasActionField = allKeys.some(
274
- (k) => k.startsWith('$ACTION_REF_') || k.startsWith('$ACTION_ID_')
275
- );
276
- if (!hasActionField && !formData.has('$ACTION_KEY')) {
277
- return null;
278
- }
279
-
280
- // Capture submitted values for re-render on validation failure.
281
- // Parse before decodeAction consumes the FormData.
282
- const submittedValues = parseFormData(formData);
283
-
284
616
  // decodeAction resolves the action function from the form data's hidden fields.
285
- // It returns a bound function with the form data already applied.
286
- const actionFn = (await decodeAction(formData)) as (...args: unknown[]) => Promise<unknown>;
287
-
617
+ // Returns null when no $ACTION_REF_/$ACTION_ID_ fields are present — meaning
618
+ // this is a regular form POST, not a React server action.
288
619
  // Execute the action — no additional args needed (form data is already bound).
289
620
  // Errors are caught to prevent stack traces from leaking in the response.
621
+ let actionFn: ((...args: unknown[]) => Promise<unknown>) | null;
622
+ try {
623
+ actionFn = (await decodeAction(formData)) as ((...args: unknown[]) => Promise<unknown>) | null;
624
+ } catch (error) {
625
+ // decodeAction both decodes the form's `$ACTION_REF_` metadata and loads
626
+ // the module, and React does not say which failed. On a no-JS POST that
627
+ // metadata is written by React into the form, so a failure is almost
628
+ // always a forged or truncated request: 400. A module that genuinely
629
+ // fails to import also breaks the RSC render of the page holding the
630
+ // form, which surfaces it as a 500 there.
631
+ return rejectActionRequest(req, error, 400);
632
+ }
633
+ if (!actionFn) {
634
+ return null;
635
+ }
636
+
290
637
  let result;
291
638
  try {
292
639
  result = await executeAction(actionFn, [], {
293
640
  renderer: config.revalidateRenderer,
294
641
  });
295
642
  } catch (error) {
296
- console.error('[timber] server action error:', error);
297
-
298
- // Return the error as flash data for re-render.
299
- // handleActionError produces { serverError } for ActionErrors
300
- // and { serverError: { code: 'INTERNAL_ERROR' } } for unexpected errors.
301
- const errorResult = handleActionError(error);
302
- return {
303
- rerender: {
304
- ...errorResult,
305
- submittedValues,
306
- },
307
- };
643
+ const errorId = randomUUID();
644
+ await reportActionError(req, error, errorId);
645
+ return { kind: 'error', error, errorId };
308
646
  }
647
+ // Outside the try: the action succeeded, and a failure to report its
648
+ // revalidation must not turn it into an action error.
649
+ await reportRevalidationErrors(req, result.revalidationErrors);
309
650
 
310
651
  // Handle redirect from the action (e.g. redirect() called in the action body)
311
652
  if (result.redirectTo) {
@@ -315,11 +656,12 @@ async function handleFormAction(
315
656
  });
316
657
  }
317
658
 
318
- // Re-render the page with the action result as flash data.
319
- // The server component reads the flash via getFormFlash() and passes it
320
- // to the client form component as the initial useActionState value.
321
- // This handles both success ({ data }) and validation failure
322
- // ({ validationErrors, submittedValues }) — the form is the single source of truth.
323
- const actionResult = result.actionResult as FormFlashData;
324
- return { rerender: actionResult };
659
+ // React keys the result to the hook that submitted: `$ACTION_KEY` names
660
+ // the useActionState instance, and Fizz hands the result to it as its
661
+ // initial state only when that key and the action match. A form with no
662
+ // useActionState has no key, so this is undefined and the page renders
663
+ // with no result, as the JS path discards the return value of a plain
664
+ // `<form action>`. Such forms should `redirect()` (post-redirect-get).
665
+ const formState = (await decodeFormState(result.actionResult, formData)) ?? undefined;
666
+ return { kind: 'rerender', formState };
325
667
  }