@timber-js/app 0.2.0-alpha.17 → 0.2.0-alpha.171

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 (1026) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +344 -0
  3. package/dist/_chunks/actions-O_LsyCE4.js +317 -0
  4. package/dist/_chunks/actions-O_LsyCE4.js.map +1 -0
  5. package/dist/_chunks/build-output-helper-DF5uScqS.js +158 -0
  6. package/dist/_chunks/build-output-helper-DF5uScqS.js.map +1 -0
  7. package/dist/_chunks/cache-api-B-lhk9p4.js +1202 -0
  8. package/dist/_chunks/cache-api-B-lhk9p4.js.map +1 -0
  9. package/dist/_chunks/canonicalize-Du3o_ptW.js +247 -0
  10. package/dist/_chunks/canonicalize-Du3o_ptW.js.map +1 -0
  11. package/dist/_chunks/cli-schema-sync-B5FDplGI.js +688 -0
  12. package/dist/_chunks/cli-schema-sync-B5FDplGI.js.map +1 -0
  13. package/dist/_chunks/cloudflare-AHoWYTYr.js +1188 -0
  14. package/dist/_chunks/cloudflare-AHoWYTYr.js.map +1 -0
  15. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  16. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  17. package/dist/_chunks/define-COtkxMRT.js +191 -0
  18. package/dist/_chunks/define-COtkxMRT.js.map +1 -0
  19. package/dist/_chunks/define-c4au4I9R.js +82 -0
  20. package/dist/_chunks/define-c4au4I9R.js.map +1 -0
  21. package/dist/_chunks/dist-BA3u1z3W.js +423 -0
  22. package/dist/_chunks/dist-BA3u1z3W.js.map +1 -0
  23. package/dist/_chunks/fast-hash-D6hIVt1Y.js +36 -0
  24. package/dist/_chunks/fast-hash-D6hIVt1Y.js.map +1 -0
  25. package/dist/_chunks/format-CfwjgPz9.js +14 -0
  26. package/dist/_chunks/format-CfwjgPz9.js.map +1 -0
  27. package/dist/_chunks/href-validation-CMc5JRls.js +141 -0
  28. package/dist/_chunks/href-validation-CMc5JRls.js.map +1 -0
  29. package/dist/_chunks/json-lossy-check-ClNvBM_3.js +63 -0
  30. package/dist/_chunks/json-lossy-check-ClNvBM_3.js.map +1 -0
  31. package/dist/_chunks/logger-AWfuX-KJ.js +1468 -0
  32. package/dist/_chunks/logger-AWfuX-KJ.js.map +1 -0
  33. package/dist/_chunks/navigation-root-bUDZLw74.js +124 -0
  34. package/dist/_chunks/navigation-root-bUDZLw74.js.map +1 -0
  35. package/dist/_chunks/plugin-context---kTF5v8.js +315 -0
  36. package/dist/_chunks/plugin-context---kTF5v8.js.map +1 -0
  37. package/dist/_chunks/registry-DbJPKoBp.js +20 -0
  38. package/dist/_chunks/registry-DbJPKoBp.js.map +1 -0
  39. package/dist/_chunks/resolve-schema-Dz3fcFUo.js +50 -0
  40. package/dist/_chunks/resolve-schema-Dz3fcFUo.js.map +1 -0
  41. package/dist/_chunks/router-ref-CtmF-aPv.js +28 -0
  42. package/dist/_chunks/router-ref-CtmF-aPv.js.map +1 -0
  43. package/dist/_chunks/schema-bridge-DT_Tn0Xf.js +119 -0
  44. package/dist/_chunks/schema-bridge-DT_Tn0Xf.js.map +1 -0
  45. package/dist/_chunks/segment-classify-Byy425ng.js +176 -0
  46. package/dist/_chunks/segment-classify-Byy425ng.js.map +1 -0
  47. package/dist/_chunks/segment-context-ZDnXDkbz.js +34 -0
  48. package/dist/_chunks/segment-context-ZDnXDkbz.js.map +1 -0
  49. package/dist/_chunks/sizeof-lXffQ1Vr.js +35 -0
  50. package/dist/_chunks/sizeof-lXffQ1Vr.js.map +1 -0
  51. package/dist/_chunks/{ssr-data-MjmprTmO.js → ssr-data-BOWsq18U.js} +1 -1
  52. package/dist/_chunks/ssr-data-BOWsq18U.js.map +1 -0
  53. package/dist/_chunks/{use-query-states-D5KaffOK.js → use-query-states-DFvWd-EA.js} +71 -26
  54. package/dist/_chunks/use-query-states-DFvWd-EA.js.map +1 -0
  55. package/dist/_chunks/use-segment-params-D1CzlgBo.js +151 -0
  56. package/dist/_chunks/use-segment-params-D1CzlgBo.js.map +1 -0
  57. package/dist/_chunks/walkers-DCoE-LJf.js +1002 -0
  58. package/dist/_chunks/walkers-DCoE-LJf.js.map +1 -0
  59. package/dist/adapters/build-output-helper.d.ts +29 -0
  60. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  61. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  62. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  63. package/dist/adapters/cloudflare-dev.js +73 -0
  64. package/dist/adapters/cloudflare-dev.js.map +1 -0
  65. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  66. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  67. package/dist/adapters/cloudflare-kv-cache.js +124 -0
  68. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  69. package/dist/adapters/cloudflare.d.ts +189 -21
  70. package/dist/adapters/cloudflare.d.ts.map +1 -1
  71. package/dist/adapters/cloudflare.js +2 -188
  72. package/dist/adapters/compress-module.d.ts +5 -4
  73. package/dist/adapters/compress-module.d.ts.map +1 -1
  74. package/dist/adapters/nitro.d.ts +41 -3
  75. package/dist/adapters/nitro.d.ts.map +1 -1
  76. package/dist/adapters/nitro.js +224 -172
  77. package/dist/adapters/nitro.js.map +1 -1
  78. package/dist/adapters/shared.d.ts +6 -0
  79. package/dist/adapters/shared.d.ts.map +1 -0
  80. package/dist/adapters/types.d.ts +2 -6
  81. package/dist/adapters/types.d.ts.map +1 -1
  82. package/dist/cache/cache-api.d.ts +48 -0
  83. package/dist/cache/cache-api.d.ts.map +1 -0
  84. package/dist/cache/handler-store.d.ts +33 -0
  85. package/dist/cache/handler-store.d.ts.map +1 -0
  86. package/dist/cache/index.d.ts +31 -8
  87. package/dist/cache/index.d.ts.map +1 -1
  88. package/dist/cache/index.js +3 -326
  89. package/dist/cache/invalidation-epoch.d.ts +43 -0
  90. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  91. package/dist/cache/json-lossy-check.d.ts +11 -0
  92. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  93. package/dist/cache/redis-handler.d.ts +140 -8
  94. package/dist/cache/redis-handler.d.ts.map +1 -1
  95. package/dist/cache/singleflight.d.ts +19 -2
  96. package/dist/cache/singleflight.d.ts.map +1 -1
  97. package/dist/cache/sizeof.d.ts +22 -0
  98. package/dist/cache/sizeof.d.ts.map +1 -0
  99. package/dist/cache/stable-stringify.d.ts +9 -0
  100. package/dist/cache/stable-stringify.d.ts.map +1 -1
  101. package/dist/cache/store.d.ts +53 -0
  102. package/dist/cache/store.d.ts.map +1 -0
  103. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  104. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  105. package/dist/cache/stores/cloudflare-kv.js +29 -0
  106. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  107. package/dist/cache/stores/memory.d.ts +42 -0
  108. package/dist/cache/stores/memory.d.ts.map +1 -0
  109. package/dist/cache/stores/memory.js +90 -0
  110. package/dist/cache/stores/memory.js.map +1 -0
  111. package/dist/cache/stores/redis.d.ts +69 -0
  112. package/dist/cache/stores/redis.d.ts.map +1 -0
  113. package/dist/cache/stores/redis.js +35 -0
  114. package/dist/cache/stores/redis.js.map +1 -0
  115. package/dist/cache/stores/vercel.d.ts +36 -0
  116. package/dist/cache/stores/vercel.d.ts.map +1 -0
  117. package/dist/cache/stores/vercel.js +33 -0
  118. package/dist/cache/stores/vercel.js.map +1 -0
  119. package/dist/cache/tag-aware-handler.d.ts +52 -0
  120. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  121. package/dist/cache/timber-cache.d.ts +20 -10
  122. package/dist/cache/timber-cache.d.ts.map +1 -1
  123. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  124. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  125. package/dist/cdn/fastly-purge.d.ts +25 -0
  126. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  127. package/dist/cdn/headers.d.ts +97 -0
  128. package/dist/cdn/headers.d.ts.map +1 -0
  129. package/dist/cdn/index.d.ts +5 -0
  130. package/dist/cdn/index.d.ts.map +1 -0
  131. package/dist/cdn/purge-store.d.ts +23 -0
  132. package/dist/cdn/purge-store.d.ts.map +1 -0
  133. package/dist/cdn/workers-cache-purge.d.ts +16 -0
  134. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  135. package/dist/cli-schema-sync.d.ts +59 -0
  136. package/dist/cli-schema-sync.d.ts.map +1 -0
  137. package/dist/cli.d.ts +34 -2
  138. package/dist/cli.d.ts.map +1 -1
  139. package/dist/cli.js +109 -34
  140. package/dist/cli.js.map +1 -1
  141. package/dist/client/browser-dev.d.ts +37 -1
  142. package/dist/client/browser-dev.d.ts.map +1 -1
  143. package/dist/client/browser-entry/action-dispatch.d.ts +17 -0
  144. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  145. package/dist/client/browser-entry/hmr.d.ts +21 -0
  146. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  147. package/dist/client/browser-entry/hydrate.d.ts +46 -0
  148. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  149. package/dist/client/browser-entry/index.d.ts +29 -0
  150. package/dist/client/browser-entry/index.d.ts.map +1 -0
  151. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  152. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  153. package/dist/client/browser-entry/router-init.d.ts +27 -0
  154. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  155. package/dist/client/browser-entry/rsc-stream.d.ts +24 -0
  156. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  157. package/dist/client/browser-entry/scroll.d.ts +28 -0
  158. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  159. package/dist/client/child-segment-context.d.ts +22 -0
  160. package/dist/client/child-segment-context.d.ts.map +1 -0
  161. package/dist/client/child-segment-outlet.d.ts +18 -0
  162. package/dist/client/child-segment-outlet.d.ts.map +1 -0
  163. package/dist/client/child-segment-provider.d.ts +21 -0
  164. package/dist/client/child-segment-provider.d.ts.map +1 -0
  165. package/dist/client/error-boundary.d.ts +12 -5
  166. package/dist/client/error-boundary.d.ts.map +1 -1
  167. package/dist/client/error-boundary.js +47 -10
  168. package/dist/client/error-boundary.js.map +1 -1
  169. package/dist/client/error-reconstituter.d.ts +61 -0
  170. package/dist/client/error-reconstituter.d.ts.map +1 -0
  171. package/dist/client/form.d.ts +16 -27
  172. package/dist/client/form.d.ts.map +1 -1
  173. package/dist/client/history.d.ts +21 -6
  174. package/dist/client/history.d.ts.map +1 -1
  175. package/dist/client/index.d.ts +10 -24
  176. package/dist/client/index.d.ts.map +1 -1
  177. package/dist/client/index.js +185 -1134
  178. package/dist/client/index.js.map +1 -1
  179. package/dist/client/internal.d.ts +19 -0
  180. package/dist/client/internal.d.ts.map +1 -0
  181. package/dist/client/internal.js +849 -0
  182. package/dist/client/internal.js.map +1 -0
  183. package/dist/client/link.d.ts +69 -60
  184. package/dist/client/link.d.ts.map +1 -1
  185. package/dist/client/navigation-api.d.ts +120 -0
  186. package/dist/client/navigation-api.d.ts.map +1 -0
  187. package/dist/client/navigation-context.d.ts +3 -2
  188. package/dist/client/navigation-context.d.ts.map +1 -1
  189. package/dist/client/navigation-root.d.ts +119 -0
  190. package/dist/client/navigation-root.d.ts.map +1 -0
  191. package/dist/client/nuqs-adapter.d.ts +1 -1
  192. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  193. package/dist/client/router-ref.d.ts +1 -1
  194. package/dist/client/router.d.ts +93 -14
  195. package/dist/client/router.d.ts.map +1 -1
  196. package/dist/client/rsc-fetch.d.ts +47 -14
  197. package/dist/client/rsc-fetch.d.ts.map +1 -1
  198. package/dist/client/segment-cache.d.ts +4 -4
  199. package/dist/client/segment-cache.d.ts.map +1 -1
  200. package/dist/client/segment-outlet.d.ts +49 -0
  201. package/dist/client/segment-outlet.d.ts.map +1 -0
  202. package/dist/client/segment-update-context.d.ts +21 -0
  203. package/dist/client/segment-update-context.d.ts.map +1 -0
  204. package/dist/client/shallow-url.d.ts +10 -0
  205. package/dist/client/shallow-url.d.ts.map +1 -0
  206. package/dist/client/slot-context.d.ts +29 -0
  207. package/dist/client/slot-context.d.ts.map +1 -0
  208. package/dist/client/slot-outlet.d.ts +16 -0
  209. package/dist/client/slot-outlet.d.ts.map +1 -0
  210. package/dist/client/slot-provider.d.ts +20 -0
  211. package/dist/client/slot-provider.d.ts.map +1 -0
  212. package/dist/client/ssr-data.d.ts +13 -4
  213. package/dist/client/ssr-data.d.ts.map +1 -1
  214. package/dist/client/state.d.ts +1 -1
  215. package/dist/client/top-loader.d.ts +5 -5
  216. package/dist/client/top-loader.d.ts.map +1 -1
  217. package/dist/client/use-cookie.d.ts +12 -0
  218. package/dist/client/use-cookie.d.ts.map +1 -1
  219. package/dist/client/use-link-status.d.ts +5 -5
  220. package/dist/client/use-link-status.d.ts.map +1 -1
  221. package/dist/client/use-pathname.d.ts.map +1 -1
  222. package/dist/client/use-pending-navigation.d.ts +23 -0
  223. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  224. package/dist/client/use-query-states.d.ts +1 -1
  225. package/dist/client/use-query-states.d.ts.map +1 -1
  226. package/dist/client/use-router.d.ts +1 -1
  227. package/dist/client/use-router.d.ts.map +1 -1
  228. package/dist/client/use-search-params.d.ts +12 -5
  229. package/dist/client/use-search-params.d.ts.map +1 -1
  230. package/dist/client/{use-params.d.ts → use-segment-params.d.ts} +8 -6
  231. package/dist/client/use-segment-params.d.ts.map +1 -0
  232. package/dist/codec.d.ts +69 -0
  233. package/dist/codec.d.ts.map +1 -0
  234. package/dist/codec.js +76 -0
  235. package/dist/codec.js.map +1 -0
  236. package/dist/config-types.d.ts +284 -0
  237. package/dist/config-types.d.ts.map +1 -0
  238. package/dist/config-validation.d.ts +51 -0
  239. package/dist/config-validation.d.ts.map +1 -0
  240. package/dist/content/index.d.ts +1 -10
  241. package/dist/content/index.d.ts.map +1 -1
  242. package/dist/content/index.js +0 -2
  243. package/dist/cookies/define-cookie.d.ts +58 -25
  244. package/dist/cookies/define-cookie.d.ts.map +1 -1
  245. package/dist/cookies/index.d.ts +2 -1
  246. package/dist/cookies/index.d.ts.map +1 -1
  247. package/dist/cookies/index.js +257 -36
  248. package/dist/cookies/index.js.map +1 -1
  249. package/dist/cookies/json-cookie.d.ts +64 -0
  250. package/dist/cookies/json-cookie.d.ts.map +1 -0
  251. package/dist/cookies/validation.d.ts +34 -0
  252. package/dist/cookies/validation.d.ts.map +1 -0
  253. package/dist/dev-tools/404-page.d.ts +50 -0
  254. package/dist/dev-tools/404-page.d.ts.map +1 -0
  255. package/dist/dev-tools/browser-logs.d.ts +40 -0
  256. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  257. package/dist/dev-tools/dev-page-shell.d.ts +78 -0
  258. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  259. package/dist/dev-tools/error-page.d.ts +32 -0
  260. package/dist/dev-tools/error-page.d.ts.map +1 -0
  261. package/dist/dev-tools/holding-server.d.ts +54 -0
  262. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  263. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  264. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  265. package/dist/dev-tools/index.d.ts +31 -0
  266. package/dist/dev-tools/index.d.ts.map +1 -0
  267. package/dist/dev-tools/instrumentation.d.ts +59 -0
  268. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  269. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  270. package/dist/dev-tools/logger.d.ts.map +1 -0
  271. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +17 -3
  272. package/dist/dev-tools/logs.d.ts.map +1 -0
  273. package/dist/dev-tools/overlay.d.ts +91 -0
  274. package/dist/dev-tools/overlay.d.ts.map +1 -0
  275. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  276. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  277. package/dist/dev-tools/terminal.d.ts +28 -0
  278. package/dist/dev-tools/terminal.d.ts.map +1 -0
  279. package/dist/fonts/ast-walk.d.ts +68 -0
  280. package/dist/fonts/ast-walk.d.ts.map +1 -0
  281. package/dist/fonts/ast.d.ts +110 -6
  282. package/dist/fonts/ast.d.ts.map +1 -1
  283. package/dist/fonts/bundle.d.ts +50 -0
  284. package/dist/fonts/bundle.d.ts.map +1 -0
  285. package/dist/fonts/dev-middleware.d.ts +22 -0
  286. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  287. package/dist/fonts/fallbacks.d.ts +0 -7
  288. package/dist/fonts/fallbacks.d.ts.map +1 -1
  289. package/dist/fonts/google.d.ts +4 -2
  290. package/dist/fonts/google.d.ts.map +1 -1
  291. package/dist/fonts/local.d.ts +4 -4
  292. package/dist/fonts/local.d.ts.map +1 -1
  293. package/dist/fonts/paths.d.ts +43 -0
  294. package/dist/fonts/paths.d.ts.map +1 -0
  295. package/dist/fonts/pipeline.d.ts +177 -0
  296. package/dist/fonts/pipeline.d.ts.map +1 -0
  297. package/dist/fonts/transform.d.ts +82 -0
  298. package/dist/fonts/transform.d.ts.map +1 -0
  299. package/dist/fonts/types.d.ts +47 -1
  300. package/dist/fonts/types.d.ts.map +1 -1
  301. package/dist/fonts/virtual-modules.d.ts +77 -0
  302. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  303. package/dist/index.d.ts +46 -180
  304. package/dist/index.d.ts.map +1 -1
  305. package/dist/index.js +8542 -13615
  306. package/dist/index.js.map +1 -1
  307. package/dist/params/codec-registry.d.ts +26 -0
  308. package/dist/params/codec-registry.d.ts.map +1 -0
  309. package/dist/params/define-schema.d.ts +81 -0
  310. package/dist/params/define-schema.d.ts.map +1 -0
  311. package/dist/params/index.d.ts +5 -0
  312. package/dist/params/index.d.ts.map +1 -0
  313. package/dist/params/index.js +34 -0
  314. package/dist/params/index.js.map +1 -0
  315. package/dist/params/resolve-schema.d.ts +34 -0
  316. package/dist/params/resolve-schema.d.ts.map +1 -0
  317. package/dist/plugin-context.d.ts +217 -0
  318. package/dist/plugin-context.d.ts.map +1 -0
  319. package/dist/plugins/adapter-build.d.ts +21 -1
  320. package/dist/plugins/adapter-build.d.ts.map +1 -1
  321. package/dist/plugins/build-manifest.d.ts +7 -3
  322. package/dist/plugins/build-manifest.d.ts.map +1 -1
  323. package/dist/plugins/build-report.d.ts +43 -7
  324. package/dist/plugins/build-report.d.ts.map +1 -1
  325. package/dist/plugins/cache.d.ts +64 -0
  326. package/dist/plugins/cache.d.ts.map +1 -0
  327. package/dist/plugins/callsite-ast.d.ts +117 -0
  328. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  329. package/dist/plugins/callsite-jsx.d.ts +35 -0
  330. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  331. package/dist/plugins/chunks.d.ts +11 -4
  332. package/dist/plugins/chunks.d.ts.map +1 -1
  333. package/dist/plugins/client-chunks.d.ts +40 -0
  334. package/dist/plugins/client-chunks.d.ts.map +1 -0
  335. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  336. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  337. package/dist/plugins/content.d.ts +1 -1
  338. package/dist/plugins/content.d.ts.map +1 -1
  339. package/dist/plugins/dev-server.d.ts +17 -1
  340. package/dist/plugins/dev-server.d.ts.map +1 -1
  341. package/dist/plugins/entries.d.ts +28 -4
  342. package/dist/plugins/entries.d.ts.map +1 -1
  343. package/dist/plugins/fonts.d.ts +16 -73
  344. package/dist/plugins/fonts.d.ts.map +1 -1
  345. package/dist/plugins/mdx.d.ts +1 -1
  346. package/dist/plugins/mdx.d.ts.map +1 -1
  347. package/dist/plugins/prebuilt-capture.d.ts +60 -0
  348. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  349. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  350. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  351. package/dist/plugins/prebuilt.d.ts +82 -0
  352. package/dist/plugins/prebuilt.d.ts.map +1 -0
  353. package/dist/plugins/prerender-sugar.d.ts +42 -0
  354. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  355. package/dist/plugins/routing.d.ts +1 -1
  356. package/dist/plugins/routing.d.ts.map +1 -1
  357. package/dist/plugins/server-bundle.d.ts.map +1 -1
  358. package/dist/plugins/shims.d.ts +29 -5
  359. package/dist/plugins/shims.d.ts.map +1 -1
  360. package/dist/plugins/static-build.d.ts +5 -26
  361. package/dist/plugins/static-build.d.ts.map +1 -1
  362. package/dist/routing/codegen-shared.d.ts +67 -0
  363. package/dist/routing/codegen-shared.d.ts.map +1 -0
  364. package/dist/routing/codegen-types.d.ts +64 -0
  365. package/dist/routing/codegen-types.d.ts.map +1 -0
  366. package/dist/routing/codegen.d.ts +7 -2
  367. package/dist/routing/codegen.d.ts.map +1 -1
  368. package/dist/routing/convention-lint.d.ts +41 -0
  369. package/dist/routing/convention-lint.d.ts.map +1 -0
  370. package/dist/routing/export-detect.d.ts +56 -0
  371. package/dist/routing/export-detect.d.ts.map +1 -0
  372. package/dist/routing/file-cache.d.ts +8 -0
  373. package/dist/routing/file-cache.d.ts.map +1 -0
  374. package/dist/routing/index.d.ts +7 -1
  375. package/dist/routing/index.d.ts.map +1 -1
  376. package/dist/routing/index.js +4 -2
  377. package/dist/routing/interception.d.ts +0 -5
  378. package/dist/routing/interception.d.ts.map +1 -1
  379. package/dist/routing/link-codegen.d.ts +90 -0
  380. package/dist/routing/link-codegen.d.ts.map +1 -0
  381. package/dist/routing/manifest-codegen.d.ts +32 -0
  382. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  383. package/dist/routing/scanner.d.ts +1 -10
  384. package/dist/routing/scanner.d.ts.map +1 -1
  385. package/dist/routing/schema-validation.d.ts +35 -0
  386. package/dist/routing/schema-validation.d.ts.map +1 -0
  387. package/dist/routing/segment-classify.d.ts +81 -0
  388. package/dist/routing/segment-classify.d.ts.map +1 -0
  389. package/dist/routing/segment-codegen.d.ts +38 -0
  390. package/dist/routing/segment-codegen.d.ts.map +1 -0
  391. package/dist/routing/types.d.ts +81 -25
  392. package/dist/routing/types.d.ts.map +1 -1
  393. package/dist/routing/walkers.d.ts +51 -0
  394. package/dist/routing/walkers.d.ts.map +1 -0
  395. package/dist/rsc-runtime/rsc.d.ts +1 -1
  396. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  397. package/dist/rsc-runtime/ssr.d.ts +12 -0
  398. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  399. package/dist/schema-bridge.d.ts +91 -0
  400. package/dist/schema-bridge.d.ts.map +1 -0
  401. package/dist/search-params/define.d.ts +188 -0
  402. package/dist/search-params/define.d.ts.map +1 -0
  403. package/dist/search-params/index.d.ts +4 -7
  404. package/dist/search-params/index.d.ts.map +1 -1
  405. package/dist/search-params/index.js +34 -441
  406. package/dist/search-params/index.js.map +1 -1
  407. package/dist/search-params/registry.d.ts +2 -2
  408. package/dist/search-params/registry.d.ts.map +1 -1
  409. package/dist/search-params/wrappers.d.ts +53 -0
  410. package/dist/search-params/wrappers.d.ts.map +1 -0
  411. package/dist/segment-params/define.d.ts +89 -0
  412. package/dist/segment-params/define.d.ts.map +1 -0
  413. package/dist/segment-params/index.d.ts +3 -0
  414. package/dist/segment-params/index.d.ts.map +1 -0
  415. package/dist/segment-params/index.js +2 -0
  416. package/dist/server/access-gate.d.ts +8 -3
  417. package/dist/server/access-gate.d.ts.map +1 -1
  418. package/dist/server/action-client.d.ts +42 -7
  419. package/dist/server/action-client.d.ts.map +1 -1
  420. package/dist/server/action-encryption.d.ts +76 -0
  421. package/dist/server/action-encryption.d.ts.map +1 -0
  422. package/dist/server/action-handler.d.ts +35 -1
  423. package/dist/server/action-handler.d.ts.map +1 -1
  424. package/dist/server/actions.d.ts +6 -30
  425. package/dist/server/actions.d.ts.map +1 -1
  426. package/dist/server/als-registry.d.ts +93 -11
  427. package/dist/server/als-registry.d.ts.map +1 -1
  428. package/dist/server/asset-headers.d.ts +8 -18
  429. package/dist/server/asset-headers.d.ts.map +1 -1
  430. package/dist/server/body-limits.d.ts.map +1 -1
  431. package/dist/server/build-manifest.d.ts +6 -29
  432. package/dist/server/build-manifest.d.ts.map +1 -1
  433. package/dist/server/canonicalize.d.ts +10 -0
  434. package/dist/server/canonicalize.d.ts.map +1 -1
  435. package/dist/server/coalesce-tick.d.ts +40 -0
  436. package/dist/server/coalesce-tick.d.ts.map +1 -0
  437. package/dist/server/cookie-context.d.ts +170 -0
  438. package/dist/server/cookie-context.d.ts.map +1 -0
  439. package/dist/server/cookie-parsing.d.ts +65 -0
  440. package/dist/server/cookie-parsing.d.ts.map +1 -0
  441. package/dist/server/csrf.d.ts +3 -2
  442. package/dist/server/csrf.d.ts.map +1 -1
  443. package/dist/server/default-logger.d.ts +22 -0
  444. package/dist/server/default-logger.d.ts.map +1 -0
  445. package/dist/server/deny-boundary.d.ts +117 -0
  446. package/dist/server/deny-boundary.d.ts.map +1 -0
  447. package/dist/server/deny-renderer.d.ts +2 -2
  448. package/dist/server/deny-renderer.d.ts.map +1 -1
  449. package/dist/server/dev-source-map.d.ts +22 -0
  450. package/dist/server/dev-source-map.d.ts.map +1 -0
  451. package/dist/server/early-hints-sender.d.ts.map +1 -1
  452. package/dist/server/early-hints.d.ts +13 -11
  453. package/dist/server/early-hints.d.ts.map +1 -1
  454. package/dist/server/error-boundary-wrapper.d.ts +7 -1
  455. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  456. package/dist/server/fallback-error.d.ts +12 -7
  457. package/dist/server/fallback-error.d.ts.map +1 -1
  458. package/dist/server/flight-injection-state.d.ts +66 -0
  459. package/dist/server/flight-injection-state.d.ts.map +1 -0
  460. package/dist/server/flight-scripts.d.ts +42 -0
  461. package/dist/server/flight-scripts.d.ts.map +1 -0
  462. package/dist/server/form-data.d.ts +41 -0
  463. package/dist/server/form-data.d.ts.map +1 -1
  464. package/dist/server/html-injector-core.d.ts +242 -0
  465. package/dist/server/html-injector-core.d.ts.map +1 -0
  466. package/dist/server/html-injectors.d.ts +82 -41
  467. package/dist/server/html-injectors.d.ts.map +1 -1
  468. package/dist/server/index.d.ts +11 -47
  469. package/dist/server/index.d.ts.map +1 -1
  470. package/dist/server/index.js +182 -2906
  471. package/dist/server/index.js.map +1 -1
  472. package/dist/server/internal.d.ts +49 -0
  473. package/dist/server/internal.d.ts.map +1 -0
  474. package/dist/server/internal.js +3945 -0
  475. package/dist/server/internal.js.map +1 -0
  476. package/dist/server/logger.d.ts +39 -7
  477. package/dist/server/logger.d.ts.map +1 -1
  478. package/dist/server/metadata-routes.d.ts +47 -11
  479. package/dist/server/metadata-routes.d.ts.map +1 -1
  480. package/dist/server/middleware-runner.d.ts +19 -4
  481. package/dist/server/middleware-runner.d.ts.map +1 -1
  482. package/dist/server/node-stream-transforms.d.ts +119 -0
  483. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  484. package/dist/server/param-coercion.d.ts +54 -0
  485. package/dist/server/param-coercion.d.ts.map +1 -0
  486. package/dist/server/pipeline-helpers.d.ts +95 -0
  487. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  488. package/dist/server/pipeline-interception.d.ts +1 -1
  489. package/dist/server/pipeline-interception.d.ts.map +1 -1
  490. package/dist/server/pipeline-metadata.d.ts +6 -0
  491. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  492. package/dist/server/pipeline-outcome.d.ts +49 -0
  493. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  494. package/dist/server/pipeline-phases.d.ts +59 -0
  495. package/dist/server/pipeline-phases.d.ts.map +1 -0
  496. package/dist/server/pipeline.d.ts +140 -19
  497. package/dist/server/pipeline.d.ts.map +1 -1
  498. package/dist/server/port-resolution.d.ts +117 -0
  499. package/dist/server/port-resolution.d.ts.map +1 -0
  500. package/dist/server/prebuilt/cache-key.d.ts +62 -0
  501. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  502. package/dist/server/prebuilt/capture-state.d.ts +57 -0
  503. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  504. package/dist/server/prebuilt/key-discipline.d.ts +23 -0
  505. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  506. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  507. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  508. package/dist/server/prebuilt/overlay.d.ts +100 -0
  509. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  510. package/dist/server/prebuilt/payload-source.d.ts +78 -0
  511. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  512. package/dist/server/prebuilt/slots.d.ts +74 -0
  513. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  514. package/dist/server/prebuilt/synthetic-store.d.ts +66 -0
  515. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  516. package/dist/server/prebuilt-builder.d.ts +120 -0
  517. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  518. package/dist/server/prebuilt-runtime.d.ts +111 -0
  519. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  520. package/dist/server/primitives.d.ts +88 -43
  521. package/dist/server/primitives.d.ts.map +1 -1
  522. package/dist/server/render-timeout.d.ts +51 -0
  523. package/dist/server/render-timeout.d.ts.map +1 -0
  524. package/dist/server/render-utils.d.ts +25 -0
  525. package/dist/server/render-utils.d.ts.map +1 -0
  526. package/dist/server/request-context.d.ts +62 -107
  527. package/dist/server/request-context.d.ts.map +1 -1
  528. package/dist/server/route-element-builder.d.ts +55 -25
  529. package/dist/server/route-element-builder.d.ts.map +1 -1
  530. package/dist/server/route-handler.d.ts.map +1 -1
  531. package/dist/server/route-matcher.d.ts +25 -36
  532. package/dist/server/route-matcher.d.ts.map +1 -1
  533. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  534. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  535. package/dist/server/rsc-entry/api-handler.d.ts +12 -3
  536. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  537. package/dist/server/rsc-entry/deny-fallback.d.ts +29 -0
  538. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  539. package/dist/server/rsc-entry/error-renderer.d.ts +26 -13
  540. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  541. package/dist/server/rsc-entry/helpers.d.ts +51 -28
  542. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  543. package/dist/server/rsc-entry/index.d.ts +28 -6
  544. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  545. package/dist/server/rsc-entry/render-route.d.ts +51 -0
  546. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  547. package/dist/server/rsc-entry/revalidate-renderer.d.ts +108 -0
  548. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  549. package/dist/server/rsc-entry/rsc-payload.d.ts +5 -6
  550. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  551. package/dist/server/rsc-entry/rsc-stream.d.ts +25 -1
  552. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  553. package/dist/server/rsc-entry/ssr-bridge.d.ts +5 -1
  554. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  555. package/dist/server/rsc-entry/ssr-renderer.d.ts +34 -4
  556. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  557. package/dist/server/rsc-entry/wrap-action-dispatch.d.ts +89 -0
  558. package/dist/server/rsc-entry/wrap-action-dispatch.d.ts.map +1 -0
  559. package/dist/server/safe-load.d.ts +46 -0
  560. package/dist/server/safe-load.d.ts.map +1 -0
  561. package/dist/server/sensitive-fields.d.ts +74 -0
  562. package/dist/server/sensitive-fields.d.ts.map +1 -0
  563. package/dist/server/sitemap-generator.d.ts +129 -0
  564. package/dist/server/sitemap-generator.d.ts.map +1 -0
  565. package/dist/server/sitemap-handler.d.ts +22 -0
  566. package/dist/server/sitemap-handler.d.ts.map +1 -0
  567. package/dist/server/slot-resolver.d.ts +7 -5
  568. package/dist/server/slot-resolver.d.ts.map +1 -1
  569. package/dist/server/ssr-bridge-types.d.ts +121 -0
  570. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  571. package/dist/server/ssr-entry.d.ts +2 -43
  572. package/dist/server/ssr-entry.d.ts.map +1 -1
  573. package/dist/server/ssr-render.d.ts +64 -21
  574. package/dist/server/ssr-render.d.ts.map +1 -1
  575. package/dist/server/ssr-wrappers.d.ts +50 -0
  576. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  577. package/dist/server/state-tree-diff.d.ts +36 -6
  578. package/dist/server/state-tree-diff.d.ts.map +1 -1
  579. package/dist/server/status-code-resolver.d.ts +22 -11
  580. package/dist/server/status-code-resolver.d.ts.map +1 -1
  581. package/dist/server/stream-utils.d.ts +47 -0
  582. package/dist/server/stream-utils.d.ts.map +1 -0
  583. package/dist/server/tracing.d.ts +44 -9
  584. package/dist/server/tracing.d.ts.map +1 -1
  585. package/dist/server/tree-builder.d.ts +62 -30
  586. package/dist/server/tree-builder.d.ts.map +1 -1
  587. package/dist/server/tree-match.d.ts +49 -0
  588. package/dist/server/tree-match.d.ts.map +1 -0
  589. package/dist/server/types.d.ts +71 -6
  590. package/dist/server/types.d.ts.map +1 -1
  591. package/dist/server/utils/escape-html.d.ts +14 -0
  592. package/dist/server/utils/escape-html.d.ts.map +1 -0
  593. package/dist/server/utils/mdx-file.d.ts +15 -0
  594. package/dist/server/utils/mdx-file.d.ts.map +1 -0
  595. package/dist/server/version-skew.d.ts +61 -0
  596. package/dist/server/version-skew.d.ts.map +1 -0
  597. package/dist/server/workers-cache-bridge.d.ts +26 -0
  598. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  599. package/dist/shared/href-validation.d.ts +49 -0
  600. package/dist/shared/href-validation.d.ts.map +1 -0
  601. package/dist/shared/merge-search-params.d.ts +22 -0
  602. package/dist/shared/merge-search-params.d.ts.map +1 -0
  603. package/dist/shared/redirect-type.d.ts +17 -0
  604. package/dist/shared/redirect-type.d.ts.map +1 -0
  605. package/dist/shims/font-google.d.ts +1 -1
  606. package/dist/shims/font-google.d.ts.map +1 -1
  607. package/dist/shims/font-google.js +42 -0
  608. package/dist/shims/font-google.js.map +1 -0
  609. package/dist/shims/font-local.d.ts +26 -0
  610. package/dist/shims/font-local.d.ts.map +1 -0
  611. package/dist/shims/font-local.js +20 -0
  612. package/dist/shims/font-local.js.map +1 -0
  613. package/dist/shims/headers.d.ts +53 -1
  614. package/dist/shims/headers.d.ts.map +1 -1
  615. package/dist/shims/image.d.ts +120 -120
  616. package/dist/shims/image.d.ts.map +1 -1
  617. package/dist/shims/navigation-client.d.ts +35 -11
  618. package/dist/shims/navigation-client.d.ts.map +1 -1
  619. package/dist/shims/navigation.d.ts +11 -5
  620. package/dist/shims/navigation.d.ts.map +1 -1
  621. package/dist/utils/state-machine.d.ts +80 -0
  622. package/dist/utils/state-machine.d.ts.map +1 -0
  623. package/docs/api/30-api-server.mdx +233 -0
  624. package/docs/api/31-api-client.mdx +161 -0
  625. package/docs/api/32-api-cache.mdx +311 -0
  626. package/docs/api/33-api-search-params.mdx +154 -0
  627. package/docs/api/34-api-config.mdx +325 -0
  628. package/docs/api/35-api-typescript.mdx +170 -0
  629. package/docs/api/36-cli.mdx +143 -0
  630. package/docs/learn/00-introduction.mdx +109 -0
  631. package/docs/learn/01-quick-start.mdx +94 -0
  632. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  633. package/docs/learn/03-fetching-data.mdx +211 -0
  634. package/docs/learn/03b-access-control.mdx +130 -0
  635. package/docs/learn/04-loading-states.mdx +67 -0
  636. package/docs/learn/04b-the-flush-point.mdx +115 -0
  637. package/docs/learn/05-typed-params.mdx +275 -0
  638. package/docs/learn/06-forms-and-actions.mdx +146 -0
  639. package/docs/learn/07-typed-routes.mdx +127 -0
  640. package/docs/learn/08-streaming.mdx +146 -0
  641. package/docs/learn/09-caching.mdx +252 -0
  642. package/docs/learn/10-middleware.mdx +157 -0
  643. package/docs/learn/11-error-handling.mdx +156 -0
  644. package/docs/learn/12-client-navigation.mdx +176 -0
  645. package/docs/learn/13-configuration.mdx +162 -0
  646. package/docs/learn/14-deploying.mdx +264 -0
  647. package/docs/more/01-advanced-routing.mdx +173 -0
  648. package/docs/more/02-advanced-forms.mdx +137 -0
  649. package/docs/more/03-coming-from-nextjs.mdx +186 -0
  650. package/docs/more/04-metadata-and-fonts.mdx +193 -0
  651. package/docs/more/04b-mdx.mdx +209 -0
  652. package/docs/more/05-content-collections.mdx +90 -0
  653. package/docs/more/06-instrumentation.mdx +214 -0
  654. package/docs/more/07-security.mdx +129 -0
  655. package/docs/more/08-developer-experience.mdx +134 -0
  656. package/docs/more/40-why-timber.mdx +50 -0
  657. package/docs/more/41-timber-vs-nextjs.mdx +81 -0
  658. package/docs/more/42-timber-vs-others.mdx +68 -0
  659. package/docs/more/50-ai-agent-instructions.mdx +169 -0
  660. package/llms.txt +55 -0
  661. package/package.json +105 -26
  662. package/src/adapters/build-output-helper.ts +199 -0
  663. package/src/adapters/cloudflare-dev.ts +177 -0
  664. package/src/adapters/cloudflare-kv-cache.ts +204 -0
  665. package/src/adapters/cloudflare.ts +620 -129
  666. package/src/adapters/compress-module.ts +27 -92
  667. package/src/adapters/nitro.ts +266 -122
  668. package/src/adapters/raw-imports.d.ts +5 -0
  669. package/src/adapters/shared.ts +68 -0
  670. package/src/adapters/types.ts +2 -7
  671. package/src/adapters/wrangler.d.ts +7 -0
  672. package/src/cache/cache-api.ts +107 -0
  673. package/src/cache/handler-store.ts +76 -0
  674. package/src/cache/index.ts +114 -21
  675. package/src/cache/invalidation-epoch.ts +93 -0
  676. package/src/cache/json-lossy-check.ts +75 -0
  677. package/src/cache/redis-handler.ts +197 -19
  678. package/src/cache/singleflight.ts +64 -6
  679. package/src/cache/sizeof.ts +33 -0
  680. package/src/cache/stable-stringify.ts +65 -2
  681. package/src/cache/store.ts +71 -0
  682. package/src/cache/stores/cloudflare-kv.ts +52 -0
  683. package/src/cache/stores/memory.ts +125 -0
  684. package/src/cache/stores/redis.ts +97 -0
  685. package/src/cache/stores/vercel.ts +59 -0
  686. package/src/cache/tag-aware-handler.ts +237 -0
  687. package/src/cache/timber-cache.ts +161 -36
  688. package/src/cdn/cloudflare-purge.ts +50 -0
  689. package/src/cdn/fastly-purge.ts +63 -0
  690. package/src/cdn/headers.ts +153 -0
  691. package/src/cdn/index.ts +17 -0
  692. package/src/cdn/purge-store.ts +34 -0
  693. package/src/cdn/workers-cache-purge.ts +30 -0
  694. package/src/cli-schema-sync.ts +401 -0
  695. package/src/cli.ts +157 -34
  696. package/src/client/browser-dev.ts +156 -1
  697. package/src/client/browser-entry/action-dispatch.ts +124 -0
  698. package/src/client/browser-entry/hmr.ts +70 -0
  699. package/src/client/browser-entry/hydrate.ts +187 -0
  700. package/src/client/browser-entry/index.ts +113 -0
  701. package/src/client/browser-entry/post-hydration.ts +110 -0
  702. package/src/client/browser-entry/router-init.ts +289 -0
  703. package/src/client/browser-entry/rsc-stream.ts +157 -0
  704. package/src/client/browser-entry/scroll.ts +50 -0
  705. package/src/client/child-segment-context.ts +40 -0
  706. package/src/client/child-segment-outlet.tsx +25 -0
  707. package/src/client/child-segment-provider.tsx +27 -0
  708. package/src/client/error-boundary.tsx +127 -22
  709. package/src/client/error-reconstituter.tsx +79 -0
  710. package/src/client/form.tsx +31 -32
  711. package/src/client/history.ts +21 -6
  712. package/src/client/index.ts +67 -45
  713. package/src/client/internal.ts +58 -0
  714. package/src/client/link.tsx +349 -150
  715. package/src/client/navigation-api.ts +341 -0
  716. package/src/client/navigation-context.ts +15 -7
  717. package/src/client/navigation-root.tsx +355 -0
  718. package/src/client/nuqs-adapter.tsx +16 -3
  719. package/src/client/router-ref.ts +1 -1
  720. package/src/client/router.ts +538 -206
  721. package/src/client/rsc-fetch.ts +214 -33
  722. package/src/client/segment-cache.ts +11 -12
  723. package/src/client/segment-outlet.tsx +77 -0
  724. package/src/client/segment-update-context.ts +42 -0
  725. package/src/client/shallow-url.ts +22 -0
  726. package/src/client/slot-context.ts +48 -0
  727. package/src/client/slot-outlet.tsx +22 -0
  728. package/src/client/slot-provider.tsx +25 -0
  729. package/src/client/ssr-data.ts +13 -5
  730. package/src/client/state.ts +2 -2
  731. package/src/client/top-loader.tsx +11 -9
  732. package/src/client/use-cookie.ts +60 -15
  733. package/src/client/use-link-status.ts +7 -7
  734. package/src/client/use-pathname.ts +1 -0
  735. package/src/client/use-pending-navigation.ts +40 -0
  736. package/src/client/use-query-states.ts +108 -10
  737. package/src/client/use-router.ts +4 -1
  738. package/src/client/use-search-params.ts +31 -44
  739. package/src/client/{use-params.ts → use-segment-params.ts} +9 -6
  740. package/src/codec.ts +149 -0
  741. package/src/config-types.ts +282 -0
  742. package/src/config-validation.ts +330 -0
  743. package/src/content/index.ts +5 -13
  744. package/src/cookies/define-cookie.ts +217 -53
  745. package/src/cookies/index.ts +12 -1
  746. package/src/cookies/json-cookie.ts +105 -0
  747. package/src/cookies/validation.ts +192 -0
  748. package/src/dev-tools/404-page.ts +286 -0
  749. package/src/dev-tools/browser-logs.ts +55 -0
  750. package/src/dev-tools/dev-page-shell.ts +260 -0
  751. package/src/dev-tools/error-page.ts +331 -0
  752. package/src/dev-tools/holding-server.ts +187 -0
  753. package/src/dev-tools/hydration-overlay.ts +158 -0
  754. package/src/dev-tools/index.ts +83 -0
  755. package/src/dev-tools/instrumentation.ts +213 -0
  756. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  757. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +122 -26
  758. package/src/dev-tools/overlay.ts +469 -0
  759. package/src/dev-tools/stack-classifier.ts +75 -0
  760. package/src/dev-tools/terminal.ts +182 -0
  761. package/src/fonts/ast-walk.ts +235 -0
  762. package/src/fonts/ast.ts +477 -126
  763. package/src/fonts/bundle.ts +138 -0
  764. package/src/fonts/dev-middleware.ts +85 -0
  765. package/src/fonts/fallbacks.ts +0 -23
  766. package/src/fonts/google.ts +100 -18
  767. package/src/fonts/local.ts +9 -8
  768. package/src/fonts/paths.ts +58 -0
  769. package/src/fonts/pipeline.ts +348 -0
  770. package/src/fonts/transform.ts +311 -0
  771. package/src/fonts/types.ts +52 -1
  772. package/src/fonts/virtual-modules.ts +179 -0
  773. package/src/index.ts +444 -352
  774. package/src/params/codec-registry.ts +34 -0
  775. package/src/params/define-schema.ts +115 -0
  776. package/src/params/index.ts +17 -0
  777. package/src/params/resolve-schema.ts +84 -0
  778. package/src/plugin-context.ts +432 -0
  779. package/src/plugins/adapter-build.ts +220 -7
  780. package/src/plugins/build-manifest.ts +168 -23
  781. package/src/plugins/build-report.ts +253 -35
  782. package/src/plugins/cache.ts +243 -0
  783. package/src/plugins/callsite-ast.ts +472 -0
  784. package/src/plugins/callsite-jsx.ts +243 -0
  785. package/src/plugins/chunks.ts +74 -5
  786. package/src/plugins/client-chunks.ts +185 -0
  787. package/src/plugins/cloudflare-wasm.ts +141 -0
  788. package/src/plugins/content.ts +1 -1
  789. package/src/plugins/dev-server.ts +284 -94
  790. package/src/plugins/entries.ts +134 -16
  791. package/src/plugins/fonts.ts +225 -660
  792. package/src/plugins/mdx.ts +47 -10
  793. package/src/plugins/prebuilt-capture.ts +217 -0
  794. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  795. package/src/plugins/prebuilt.ts +655 -0
  796. package/src/plugins/prerender-sugar.ts +328 -0
  797. package/src/plugins/routing.ts +237 -241
  798. package/src/plugins/server-bundle.ts +89 -12
  799. package/src/plugins/shims.ts +241 -64
  800. package/src/plugins/static-build.ts +15 -90
  801. package/src/routing/codegen-shared.ts +115 -0
  802. package/src/routing/codegen-types.ts +65 -0
  803. package/src/routing/codegen.ts +372 -178
  804. package/src/routing/convention-lint.ts +394 -0
  805. package/src/routing/export-detect.ts +304 -0
  806. package/src/routing/file-cache.ts +23 -0
  807. package/src/routing/index.ts +10 -1
  808. package/src/routing/interception.ts +3 -22
  809. package/src/routing/link-codegen.ts +313 -0
  810. package/src/routing/manifest-codegen.ts +287 -0
  811. package/src/routing/scanner.ts +338 -189
  812. package/src/routing/schema-validation.ts +155 -0
  813. package/src/routing/segment-classify.ts +223 -0
  814. package/src/routing/segment-codegen.ts +98 -0
  815. package/src/routing/types.ts +82 -25
  816. package/src/routing/walkers.ts +90 -0
  817. package/src/rsc-runtime/rsc.ts +9 -0
  818. package/src/rsc-runtime/ssr.ts +50 -0
  819. package/src/rsc-runtime/vendor-types.d.ts +7 -0
  820. package/src/schema-bridge.ts +253 -0
  821. package/src/search-params/define.ts +576 -0
  822. package/src/search-params/index.ts +14 -20
  823. package/src/search-params/registry.ts +2 -2
  824. package/src/search-params/wrappers.ts +101 -0
  825. package/src/segment-params/define.ts +249 -0
  826. package/src/segment-params/index.ts +9 -0
  827. package/src/server/access-gate.tsx +84 -34
  828. package/src/server/action-client.ts +120 -29
  829. package/src/server/action-encryption.ts +144 -0
  830. package/src/server/action-handler.ts +123 -33
  831. package/src/server/actions.ts +48 -54
  832. package/src/server/als-registry.ts +137 -20
  833. package/src/server/asset-headers.ts +15 -37
  834. package/src/server/body-limits.ts +10 -2
  835. package/src/server/build-manifest.ts +13 -56
  836. package/src/server/canonicalize.ts +6 -3
  837. package/src/server/coalesce-tick.ts +75 -0
  838. package/src/server/compress.ts +34 -7
  839. package/src/server/cookie-context.ts +484 -0
  840. package/src/server/cookie-parsing.ts +163 -0
  841. package/src/server/csrf.ts +39 -6
  842. package/src/server/default-logger.ts +99 -0
  843. package/src/server/deny-boundary.ts +314 -0
  844. package/src/server/deny-renderer.ts +85 -77
  845. package/src/server/dev-source-map.ts +31 -0
  846. package/src/server/early-hints-sender.ts +3 -2
  847. package/src/server/early-hints.ts +37 -27
  848. package/src/server/error-boundary-wrapper.ts +61 -22
  849. package/src/server/fallback-error.ts +79 -102
  850. package/src/server/flight-injection-state.ts +113 -0
  851. package/src/server/flight-scripts.ts +62 -0
  852. package/src/server/form-data.ts +124 -12
  853. package/src/server/html-injector-core.ts +495 -0
  854. package/src/server/html-injectors.ts +271 -254
  855. package/src/server/index.ts +31 -185
  856. package/src/server/internal.ts +181 -0
  857. package/src/server/logger.ts +72 -36
  858. package/src/server/metadata-routes.ts +110 -24
  859. package/src/server/middleware-runner.ts +31 -4
  860. package/src/server/node-stream-transforms.ts +336 -0
  861. package/src/server/param-coercion.ts +207 -0
  862. package/src/server/pipeline-helpers.ts +204 -0
  863. package/src/server/pipeline-interception.ts +45 -18
  864. package/src/server/pipeline-metadata.ts +14 -0
  865. package/src/server/pipeline-outcome.ts +197 -0
  866. package/src/server/pipeline-phases.ts +545 -0
  867. package/src/server/pipeline.ts +274 -382
  868. package/src/server/port-resolution.ts +215 -0
  869. package/src/server/prebuilt/cache-key.ts +298 -0
  870. package/src/server/prebuilt/capture-state.ts +89 -0
  871. package/src/server/prebuilt/key-discipline.ts +53 -0
  872. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  873. package/src/server/prebuilt/overlay.ts +256 -0
  874. package/src/server/prebuilt/payload-source.ts +201 -0
  875. package/src/server/prebuilt/slots.ts +167 -0
  876. package/src/server/prebuilt/synthetic-store.ts +121 -0
  877. package/src/server/prebuilt-builder.ts +808 -0
  878. package/src/server/prebuilt-runtime.ts +815 -0
  879. package/src/server/primitives.ts +160 -83
  880. package/src/server/render-timeout.ts +108 -0
  881. package/src/server/render-utils.ts +31 -0
  882. package/src/server/request-context.ts +168 -337
  883. package/src/server/route-element-builder.ts +661 -278
  884. package/src/server/route-handler.ts +31 -4
  885. package/src/server/route-matcher.ts +158 -277
  886. package/src/server/rsc-entry/action-middleware-runner.ts +167 -0
  887. package/src/server/rsc-entry/api-handler.ts +69 -32
  888. package/src/server/rsc-entry/deny-fallback.ts +92 -0
  889. package/src/server/rsc-entry/error-renderer.ts +306 -89
  890. package/src/server/rsc-entry/helpers.ts +165 -79
  891. package/src/server/rsc-entry/index.ts +332 -341
  892. package/src/server/rsc-entry/render-route.ts +292 -0
  893. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  894. package/src/server/rsc-entry/rsc-payload.ts +95 -39
  895. package/src/server/rsc-entry/rsc-stream.ts +93 -13
  896. package/src/server/rsc-entry/ssr-bridge.ts +18 -5
  897. package/src/server/rsc-entry/ssr-renderer.ts +273 -43
  898. package/src/server/rsc-entry/wrap-action-dispatch.ts +186 -0
  899. package/src/server/safe-load.ts +60 -0
  900. package/src/server/sensitive-fields.ts +230 -0
  901. package/src/server/server-only-guard-noop.js +3 -0
  902. package/src/server/sitemap-generator.ts +345 -0
  903. package/src/server/sitemap-handler.ts +157 -0
  904. package/src/server/slot-resolver.ts +264 -257
  905. package/src/server/ssr-bridge-types.ts +124 -0
  906. package/src/server/ssr-entry.ts +206 -78
  907. package/src/server/ssr-render.ts +345 -82
  908. package/src/server/ssr-wrappers.tsx +141 -0
  909. package/src/server/state-tree-diff.ts +76 -24
  910. package/src/server/status-code-resolver.ts +115 -130
  911. package/src/server/stream-utils.ts +288 -0
  912. package/src/server/tracing.ts +126 -14
  913. package/src/server/tree-builder.ts +204 -90
  914. package/src/server/tree-match.ts +262 -0
  915. package/src/server/types.ts +78 -9
  916. package/src/server/utils/escape-html.ts +20 -0
  917. package/src/server/utils/mdx-file.ts +22 -0
  918. package/src/server/version-skew.ts +104 -0
  919. package/src/server/workers-cache-bridge.ts +33 -0
  920. package/src/shared/href-validation.ts +159 -0
  921. package/src/shared/merge-search-params.ts +55 -0
  922. package/src/shared/redirect-type.ts +17 -0
  923. package/src/shims/font-google.ts +1 -1
  924. package/src/shims/font-local.ts +34 -0
  925. package/src/shims/headers.ts +122 -1
  926. package/src/shims/navigation-client.ts +51 -29
  927. package/src/shims/navigation.ts +14 -7
  928. package/src/utils/state-machine.ts +111 -0
  929. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  930. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  931. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  932. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  933. package/dist/_chunks/format-RyoGQL74.js +0 -164
  934. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  935. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  936. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  937. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js +0 -153
  938. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  939. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  940. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  941. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  942. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  943. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  944. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  945. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  946. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  947. package/dist/adapters/cloudflare.js.map +0 -1
  948. package/dist/cache/index.js.map +0 -1
  949. package/dist/cache/register-cached-function.d.ts +0 -17
  950. package/dist/cache/register-cached-function.d.ts.map +0 -1
  951. package/dist/client/browser-entry.d.ts +0 -21
  952. package/dist/client/browser-entry.d.ts.map +0 -1
  953. package/dist/client/head.d.ts +0 -16
  954. package/dist/client/head.d.ts.map +0 -1
  955. package/dist/client/link-status-provider.d.ts +0 -11
  956. package/dist/client/link-status-provider.d.ts.map +0 -1
  957. package/dist/client/segment-merger.d.ts +0 -119
  958. package/dist/client/segment-merger.d.ts.map +0 -1
  959. package/dist/client/stale-reload.d.ts +0 -44
  960. package/dist/client/stale-reload.d.ts.map +0 -1
  961. package/dist/client/transition-root.d.ts +0 -74
  962. package/dist/client/transition-root.d.ts.map +0 -1
  963. package/dist/client/use-navigation-pending.d.ts +0 -26
  964. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  965. package/dist/client/use-params.d.ts.map +0 -1
  966. package/dist/plugins/cache-transform.d.ts +0 -36
  967. package/dist/plugins/cache-transform.d.ts.map +0 -1
  968. package/dist/plugins/dev-error-overlay.d.ts +0 -60
  969. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  970. package/dist/plugins/dev-logs.d.ts.map +0 -1
  971. package/dist/plugins/dynamic-transform.d.ts +0 -72
  972. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  973. package/dist/plugins/server-action-exports.d.ts +0 -26
  974. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  975. package/dist/routing/status-file-lint.d.ts +0 -33
  976. package/dist/routing/status-file-lint.d.ts.map +0 -1
  977. package/dist/search-params/analyze.d.ts +0 -54
  978. package/dist/search-params/analyze.d.ts.map +0 -1
  979. package/dist/search-params/builtin-codecs.d.ts +0 -105
  980. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  981. package/dist/search-params/codecs.d.ts +0 -53
  982. package/dist/search-params/codecs.d.ts.map +0 -1
  983. package/dist/search-params/create.d.ts +0 -106
  984. package/dist/search-params/create.d.ts.map +0 -1
  985. package/dist/server/client-module-map.d.ts +0 -47
  986. package/dist/server/client-module-map.d.ts.map +0 -1
  987. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  988. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  989. package/dist/server/dev-logger.d.ts.map +0 -1
  990. package/dist/server/dev-span-processor.d.ts +0 -29
  991. package/dist/server/dev-span-processor.d.ts.map +0 -1
  992. package/dist/server/dev-warnings.d.ts +0 -129
  993. package/dist/server/dev-warnings.d.ts.map +0 -1
  994. package/dist/server/flush.d.ts +0 -74
  995. package/dist/server/flush.d.ts.map +0 -1
  996. package/dist/server/manifest-status-resolver.d.ts +0 -58
  997. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  998. package/dist/server/prerender.d.ts +0 -77
  999. package/dist/server/prerender.d.ts.map +0 -1
  1000. package/dist/utils/directive-parser.d.ts +0 -70
  1001. package/dist/utils/directive-parser.d.ts.map +0 -1
  1002. package/src/cache/register-cached-function.ts +0 -103
  1003. package/src/client/browser-entry.ts +0 -678
  1004. package/src/client/head.ts +0 -61
  1005. package/src/client/link-status-provider.tsx +0 -30
  1006. package/src/client/segment-merger.ts +0 -339
  1007. package/src/client/stale-reload.ts +0 -87
  1008. package/src/client/transition-root.tsx +0 -166
  1009. package/src/client/use-navigation-pending.ts +0 -38
  1010. package/src/plugins/cache-transform.ts +0 -199
  1011. package/src/plugins/dev-error-overlay.ts +0 -230
  1012. package/src/plugins/dynamic-transform.ts +0 -161
  1013. package/src/plugins/server-action-exports.ts +0 -220
  1014. package/src/routing/status-file-lint.ts +0 -112
  1015. package/src/search-params/analyze.ts +0 -192
  1016. package/src/search-params/builtin-codecs.ts +0 -228
  1017. package/src/search-params/codecs.ts +0 -153
  1018. package/src/search-params/create.ts +0 -321
  1019. package/src/server/client-module-map.ts +0 -58
  1020. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1021. package/src/server/dev-span-processor.ts +0 -78
  1022. package/src/server/dev-warnings.ts +0 -283
  1023. package/src/server/flush.ts +0 -182
  1024. package/src/server/manifest-status-resolver.ts +0 -215
  1025. package/src/server/prerender.ts +0 -139
  1026. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,108 @@
1
+ /**
2
+ * Revalidation renderer — builds the React element tree for the target
3
+ * path requested by `revalidatePath()` from inside a server action, with
4
+ * the same security guarantees as a normal route render.
5
+ *
6
+ * Before this module existed, `revalidatePath()` matched the route, coerced
7
+ * params, and called `buildRouteElement()` directly. That bypassed the
8
+ * target route's `middleware.ts` chain entirely. An action that revalidated
9
+ * a higher-privilege or user-controlled path could leak an authenticated
10
+ * RSC tree to the action submitter even when middleware on that path
11
+ * would have denied them.
12
+ *
13
+ * The fix (TIM-996) is to run the target route's middleware chain inside
14
+ * a fresh `runWithRequestContext` scope BEFORE building the element tree,
15
+ * propagate `DenySignal` and `RedirectSignal` to `executeAction`, drop the
16
+ * revalidation when middleware returns a short-circuit `Response`, and
17
+ * lift the request-header overlay onto the action's ALS store so the
18
+ * revalidated component render sees middleware-injected headers via
19
+ * `getHeaders()`.
20
+ *
21
+ * The input `path` is also validated as a local root-relative pathname so
22
+ * `revalidatePath('//evil.com/admin')` and similar scheme/authority
23
+ * injections cannot smuggle a foreign host through `new URL(path, base)`.
24
+ *
25
+ * See design/08-forms-and-actions.md §"revalidatePath()" and
26
+ * design/13-security.md §"Server actions silently bypass middleware".
27
+ */
28
+ import type { BuildManifest } from '../build-manifest.js';
29
+ import type { RouteMatcher } from '../pipeline.js';
30
+ import type { RevalidateRenderer } from '../actions.js';
31
+ import { type CoerceSegmentParamsFn } from './action-middleware-runner.js';
32
+ /**
33
+ * Sentinel thrown when revalidation cannot proceed because middleware
34
+ * returned a short-circuit `Response` (a non-redirect HTTP response that
35
+ * we cannot translate back to an element tree). `executeAction` catches
36
+ * this and drops the revalidation — the action result is still delivered,
37
+ * but no `_tree` is piggybacked onto the response. The matching name
38
+ * `RevalidationDropped` is exported so callers can identify it via
39
+ * `instanceof` without leaking the message text to clients.
40
+ */
41
+ export declare class RevalidationDropped extends Error {
42
+ constructor(message: string);
43
+ }
44
+ /** Result of validating a `revalidatePath()` argument. */
45
+ type PathValidation = {
46
+ ok: true;
47
+ pathname: string;
48
+ search: string;
49
+ } | {
50
+ ok: false;
51
+ reason: string;
52
+ };
53
+ /**
54
+ * Validate a `revalidatePath()` argument.
55
+ *
56
+ * Accepts local root-relative pathnames only. Rejects anything that
57
+ * `new URL(path, base)` would resolve to a different host or scheme:
58
+ *
59
+ * - Empty / non-string input
60
+ * - Anything not starting with `/` (relative, scheme-bearing, etc.)
61
+ * - Protocol-relative `//evil.com/admin` — resolves to scheme://evil.com
62
+ * - Backslash-prefixed `/\evil.com` — some clients fold `\` into `/`
63
+ * - Control characters and null bytes
64
+ * - Paths that fail canonicalization (encoded separators, `..` escaping
65
+ * root, malformed percent-encoding)
66
+ *
67
+ * The pathname is canonicalized so the rest of the renderer matches the
68
+ * same shape the page pipeline matches.
69
+ */
70
+ export declare function validateRevalidatePath(path: unknown): PathValidation;
71
+ /** Dependencies for the revalidate renderer factory. */
72
+ export interface RevalidateRendererDeps {
73
+ matchRoute: RouteMatcher;
74
+ coerceSegmentParams: CoerceSegmentParamsFn;
75
+ buildManifest: BuildManifest;
76
+ }
77
+ /**
78
+ * Build a per-request `RevalidateRenderer`.
79
+ *
80
+ * The returned renderer:
81
+ * 1. Validates the requested path.
82
+ * 2. Matches the canonicalized path against the route tree.
83
+ * 3. Coerces segment params via the matched chain's `params.ts` codecs.
84
+ * 4. Runs the matched route's `middleware.ts` chain inside a fresh
85
+ * `runWithRequestContext` scope (via `runMiddlewareForAction`).
86
+ * Deny/redirect signals are re-thrown so `executeAction` can apply
87
+ * its existing redirect handling and the new deny-drop behavior.
88
+ * A short-circuit `Response` becomes `RevalidationDropped`.
89
+ * 5. Lifts the request-header overlay onto the OUTER action's ALS store
90
+ * so the revalidated component render (which happens later inside
91
+ * `renderToReadableStream` in the action's scope) observes
92
+ * middleware-injected headers via `getHeaders()`. Acceptable because
93
+ * revalidation runs after the action body has returned — the only
94
+ * remaining ALS readers are render-phase code that should see the
95
+ * same overlay a normal page render would see.
96
+ * 6. Builds and returns the route element tree, ready for the action
97
+ * handler to serialize alongside the action result.
98
+ *
99
+ * Cookies set inside the revalidation middleware are intentionally NOT
100
+ * propagated to the action response. The middleware on a *different* path
101
+ * setting cookies via the action's response is surprising semantics; the
102
+ * scoped cookie jar on the inner ALS run is discarded with the scope.
103
+ * The primary security boundary closed here is auth — `deny()` from the
104
+ * target's middleware now prevents the revalidated tree from leaking.
105
+ */
106
+ export declare function createRevalidateRendererFactory(deps: RevalidateRendererDeps): (req: Request) => RevalidateRenderer;
107
+ export {};
108
+ //# sourceMappingURL=revalidate-renderer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revalidate-renderer.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/revalidate-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK/D,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,eAAe,CAAC;AAE5E,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEnG;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,0DAA0D;AAC1D,KAAK,cAAc,GACf;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAiCpE;AAwBD,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,YAAY,CAAC;IACzB,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,sBAAsB,GAC3B,CAAC,GAAG,EAAE,OAAO,KAAK,kBAAkB,CA4KtC"}
@@ -5,12 +5,11 @@
5
5
  * returned directly without SSR HTML rendering. The client decodes it via
6
6
  * `createFromFetch` and renders into the hydrated React root.
7
7
  *
8
- * Design docs: 19-client-navigation.md §"RSC Payload Handling",
9
- * 16-metadata.md §"Head Elements"
8
+ * Design docs: 19-client-navigation.md §"RSC Payload Handling"
10
9
  */
11
- import type { RouteMatch } from '#/server/pipeline.js';
12
- import type { HeadElement, LayoutComponentEntry } from '#/server/route-element-builder.js';
13
- import type { ManifestSegmentNode } from '#/server/route-matcher.js';
10
+ import type { RouteMatch } from '../pipeline.js';
11
+ import type { LayoutComponentEntry } from '../route-element-builder.js';
12
+ import type { ManifestSegmentNode } from '../route-matcher.js';
14
13
  import type { RenderSignals } from './rsc-stream.js';
15
14
  /**
16
15
  * Build an RSC payload Response for a client-side navigation request.
@@ -21,5 +20,5 @@ import type { RenderSignals } from './rsc-stream.js';
21
20
  * initial component tree, allowing onError to capture DenySignal/
22
21
  * RedirectSignal before we commit the response. See TIM-344.
23
22
  */
24
- export declare function buildRscPayloadResponse(req: Request, rscStream: ReadableStream<Uint8Array>, signals: RenderSignals, segments: ManifestSegmentNode[], layoutComponents: LayoutComponentEntry[], headElements: HeadElement[], match: RouteMatch, responseHeaders: Headers, skippedSegments?: string[]): Promise<Response>;
23
+ export declare function buildRscPayloadResponse(req: Request, rscStream: ReadableStream<Uint8Array>, signals: RenderSignals, segments: ManifestSegmentNode[], layoutComponents: LayoutComponentEntry[], match: RouteMatch, responseHeaders: Headers, skippedSegments?: string[]): Promise<Response>;
25
24
  //# sourceMappingURL=rsc-payload.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rsc-payload.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAQrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,EAAE,oBAAoB,EAAE,EACxC,YAAY,EAAE,WAAW,EAAE,EAC3B,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,QAAQ,CAAC,CA0HnB"}
1
+ {"version":3,"file":"rsc-payload.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,gBAAgB,EAAE,oBAAoB,EAAE,EACxC,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,OAAO,EACxB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,QAAQ,CAAC,CAoLnB"}
@@ -9,7 +9,8 @@
9
9
  * Design docs: 02-rendering-pipeline.md §"Single-Pass Rendering",
10
10
  * 13-security.md §"Errors don't leak"
11
11
  */
12
- import { DenySignal, RedirectSignal } from '#/server/primitives.js';
12
+ import { DenySignal, RedirectSignal } from '../primitives.js';
13
+ import { type DebugComponentEntry } from './helpers.js';
13
14
  /**
14
15
  * Mutable signal state captured during RSC rendering.
15
16
  *
@@ -27,12 +28,35 @@ export interface RenderSignals {
27
28
  error: unknown;
28
29
  status: number;
29
30
  } | null;
31
+ /**
32
+ * The last unhandled error seen by RSC onError that isn't a signal.
33
+ * Used as a fallback when SSR fails (SsrStreamError) but no structured
34
+ * signal was captured — provides the original error for the error page
35
+ * instead of relying on SsrStreamError.cause extraction.
36
+ *
37
+ * NOT used for page-level error detection (that would break Suspense
38
+ * error isolation). Only consumed when SSR actually fails.
39
+ */
40
+ lastUnhandledError: unknown | null;
30
41
  /** Callback fired when a redirect or deny signal is captured in onError. */
31
42
  onSignal?: () => void;
43
+ /**
44
+ * Resolves when every deny-capable shell component (PageDenyBoundary +
45
+ * TracedLayouts with deny chains) has settled, OR immediately when any
46
+ * catches a DenySignal in-tree (status is known). Set by renderRoute
47
+ * after element-tree construction. Awaited by buildRscPayloadResponse
48
+ * before committing HTTP status. See TIM-1045, TIM-1208.
49
+ */
50
+ shellSettled?: Promise<void>;
51
+ /** Callback fired when an unhandled error (non-signal) is captured. Used
52
+ * to halt Flight data injection into the inline stream. */
53
+ onUnhandledError?: () => void;
32
54
  }
33
55
  export interface RscStreamResult {
34
56
  rscStream: ReadableStream<Uint8Array> | undefined;
35
57
  signals: RenderSignals;
58
+ /** Dev-only: server component debug info from the Flight debug channel. */
59
+ getDebugComponents?: () => DebugComponentEntry[];
36
60
  }
37
61
  /**
38
62
  * Render a React element tree to an RSC Flight stream.
@@ -1 +1 @@
1
- {"version":3,"file":"rsc-stream.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,wBAAwB,CAAC;AAMjF;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,eAAe,CA4G1F"}
1
+ {"version":3,"file":"rsc-stream.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/rsc-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAItB;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD;;;;;;;;OAQG;IACH,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B;gEAC4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAClD,OAAO,EAAE,aAAa,CAAC;IACvB,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,MAAM,mBAAmB,EAAE,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,eAAe,CA6J1F"}
@@ -1,6 +1,10 @@
1
1
  /**
2
2
  * SSR Bridge — loads the SSR entry and passes the RSC stream for HTML rendering.
3
+ *
4
+ * This is the RSC → SSR environment hop. The two environments are separate
5
+ * Vite module graphs; `NavContext` is the serializable contract that crosses
6
+ * the boundary. See `../ssr-bridge-types.ts` for the contract definition.
3
7
  */
4
- import type { NavContext } from '#/server/ssr-entry.js';
8
+ import type { NavContext } from '../ssr-bridge-types.js';
5
9
  export declare function callSsr(rscStream: ReadableStream<Uint8Array>, navContext: NavContext): Promise<Response>;
6
10
  //# sourceMappingURL=ssr-bridge.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ssr-bridge.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/ssr-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,wBAAsB,OAAO,CAC3B,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,QAAQ,CAAC,CAMnB"}
1
+ {"version":3,"file":"ssr-bridge.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/ssr-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,wBAAsB,OAAO,CAC3B,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,EACrC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,QAAQ,CAAC,CAenB"}
@@ -11,11 +11,39 @@
11
11
  * Design docs: 02-rendering-pipeline.md §"RSC → SSR → Client Hydration",
12
12
  * 05-streaming.md §"deferSuspenseFor and the Hold Window"
13
13
  */
14
- import type { ClientBootstrapConfig } from '#/server/html-injectors.js';
15
- import type { RouteMatch } from '#/server/pipeline.js';
16
- import type { LayoutComponentEntry } from '#/server/route-element-builder.js';
17
- import type { ManifestSegmentNode } from '#/server/route-matcher.js';
14
+ import type { ClientBootstrapConfig } from '../html-injectors.js';
15
+ import type { RouteMatch } from '../pipeline.js';
16
+ import type { LayoutComponentEntry } from '../route-element-builder.js';
17
+ import type { ManifestSegmentNode } from '../route-matcher.js';
18
+ import { type GlobalErrorFile } from './error-renderer.js';
18
19
  import type { RenderSignals } from './rsc-stream.js';
20
+ /**
21
+ * Test-only observable: records how many microtask yields were consumed
22
+ * during the last signal promotion check. Import this in tests to assert
23
+ * the actual rejection chain depth and detect regressions if wrappers
24
+ * add more async hops.
25
+ *
26
+ * Only populated when the object is imported and exists — production
27
+ * bundles that don't import it pay zero cost (the typeof check is free).
28
+ */
29
+ export declare const __test_only_signalPromotionDepth: {
30
+ value: number;
31
+ };
32
+ /**
33
+ * Test-only observable: true when the promotion loop hit the cap without
34
+ * capturing a signal (the silent-miss path — state 3 in TIM-970). False
35
+ * when the loop captured a signal at any depth, when it was skipped via
36
+ * `_fizzAllReadyResolved`, or when no signal was ever expected at a depth
37
+ * shallower than the cap.
38
+ *
39
+ * Pairs with `__test_only_signalPromotionDepth`: depth alone cannot
40
+ * distinguish "cap hit with signal captured on yield 5" from "cap hit with
41
+ * signal arriving on yield 6+" — both read `.value === 5`. This flag closes
42
+ * that gap. See TIM-970, design/05-streaming.md §"Signal Promotion".
43
+ */
44
+ export declare const __test_only_signalPromotionCapHit: {
45
+ value: boolean;
46
+ };
19
47
  interface SsrRenderOptions {
20
48
  req: Request;
21
49
  rscStream: ReadableStream<Uint8Array>;
@@ -28,6 +56,8 @@ interface SsrRenderOptions {
28
56
  clientJsDisabled: boolean;
29
57
  headHtml: string;
30
58
  deferSuspenseFor: number;
59
+ /** Tier 2 global-error.tsx file, if present in app/. */
60
+ globalError?: GlobalErrorFile;
31
61
  }
32
62
  /**
33
63
  * Render the RSC stream to HTML via SSR.
@@ -1 +1 @@
1
- {"version":3,"file":"ssr-renderer.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/ssr-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAYrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,UAAU,gBAAgB;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,qBAAqB,CAAC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsKjF"}
1
+ {"version":3,"file":"ssr-renderer.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/ssr-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAY/D,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA4BrD;;;;;;;;GAQG;AACH,eAAO,MAAM,gCAAgC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAiB,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAqB,CAAC;AAEtF,UAAU,gBAAgB;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,qBAAqB,CAAC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoVjF"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Action-dispatch wrapper around the route pipeline.
3
+ *
4
+ * Extracted from rsc-entry/index.ts so the wiring can be unit-tested in
5
+ * isolation from Vite's virtual modules.
6
+ *
7
+ * ## Architecture (TIM-1213)
8
+ *
9
+ * The wrapper is responsible for ONE thing:
10
+ *
11
+ * **Pipeline-boundary CSRF validation** — runs on EVERY unsafe-method
12
+ * request, before any dispatch decision. This is the only line of
13
+ * defense for `route.ts` API handlers and server actions. See LOCAL-773.
14
+ *
15
+ * Server action dispatch has moved INTO the pipeline (`PipelineConfig.
16
+ * dispatchAction`) so that `proxy.ts` runs on action POSTs — matching the
17
+ * design doc contract: "proxy.ts runs on every request, no exclusions."
18
+ *
19
+ * The `buildActionDispatcher` function constructs the `dispatchAction`
20
+ * callback that `createPipeline` calls after proxy.ts runs. It
21
+ * encapsulates action detection, route-type check, action handler
22
+ * dispatch, and the no-JS validation rerender path.
23
+ *
24
+ * Per-segment `middleware.ts` does NOT run on action POSTs (TIM-1134).
25
+ * Actions are dispatched by action ID, not by route segment. CSRF
26
+ * validation runs at the pipeline boundary. Per-action auth/validation
27
+ * belongs in `createActionClient({ middleware })`.
28
+ */
29
+ import type { BodyLimitsConfig } from '../body-limits.js';
30
+ import { type CsrfConfig } from '../csrf.js';
31
+ import type { RouteMatcher } from '../pipeline.js';
32
+ import type { SensitiveFieldsOption } from '../sensitive-fields.js';
33
+ import type { RevalidateRenderer } from '../actions.js';
34
+ /**
35
+ * Build a `RevalidateRenderer` for a specific request.
36
+ *
37
+ * The renderer needs to forward cookies/headers from the originating
38
+ * request when fetching the revalidated route. We pass the request in
39
+ * via a builder so the wrapper doesn't need to know about route matching,
40
+ * segment param coercion, or element building — those concerns stay in
41
+ * `rsc-entry/index.ts`.
42
+ */
43
+ export type RevalidateRendererFactory = (req: Request) => RevalidateRenderer;
44
+ /** Dependencies for the CSRF wrapper. */
45
+ export interface ActionDispatchDeps {
46
+ /** CSRF configuration (Origin allow-list, on/off switch). */
47
+ csrfConfig: CsrfConfig;
48
+ }
49
+ /** Dependencies for the action dispatcher (used inside the pipeline). */
50
+ export interface ActionDispatcherDeps {
51
+ /** CSRF configuration — defense-in-depth check inside the action handler. */
52
+ csrfConfig: CsrfConfig;
53
+ /** Body size limits forwarded to `handleActionRequest`. */
54
+ bodyLimits?: BodyLimitsConfig['limits'];
55
+ /** Sensitive-field deny-list forwarded to `handleActionRequest`. */
56
+ sensitiveFields?: SensitiveFieldsOption;
57
+ /** Per-request factory that builds a `RevalidateRenderer`. */
58
+ buildRevalidateRenderer: RevalidateRendererFactory;
59
+ /**
60
+ * Route matcher — used for the route-type check that skips action
61
+ * detection on `route.ts` API handlers (TIM-870).
62
+ */
63
+ matchRoute?: RouteMatcher;
64
+ }
65
+ /**
66
+ * Wrap a pipeline function with pipeline-boundary CSRF validation.
67
+ *
68
+ * The returned handler is the framework's outermost request entry point.
69
+ * It validates the `Origin` header on every unsafe-method request before
70
+ * any dispatch decision — this is the ONLY line of defense for `route.ts`
71
+ * API handlers, which never see the action handler.
72
+ *
73
+ * Action dispatch has moved inside the pipeline (TIM-1213) so proxy.ts
74
+ * runs on every request. This wrapper now only handles CSRF.
75
+ */
76
+ export declare function wrapPipelineWithActionDispatch(pipeline: (req: Request) => Promise<Response>, deps: ActionDispatchDeps): (req: Request) => Promise<Response>;
77
+ /**
78
+ * Build the `dispatchAction` callback for `PipelineConfig`.
79
+ *
80
+ * Called after proxy.ts runs (inside the pipeline) for every request.
81
+ * Checks if the request is a server action POST, handles the route-type
82
+ * check (TIM-870), dispatches to the action handler, and handles the
83
+ * no-JS validation rerender path.
84
+ *
85
+ * Returns `Response` if the request was handled as an action, `null` to
86
+ * fall through to normal routing.
87
+ */
88
+ export declare function buildActionDispatcher(deps: ActionDispatcherDeps): (req: Request, canonicalPath: string, reenter: (req: Request) => Promise<Response>) => Promise<Response | null>;
89
+ //# sourceMappingURL=wrap-action-dispatch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wrap-action-dispatch.d.ts","sourceRoot":"","sources":["../../../src/server/rsc-entry/wrap-action-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD;;;;;;;;GAQG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,kBAAkB,CAAC;AAE7E,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,UAAU,EAAE,UAAU,CAAC;IACvB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACxC,oEAAoE;IACpE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,8DAA8D;IAC9D,uBAAuB,EAAE,yBAAyB,CAAC;IACnD;;;OAGG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC;CAC3B;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,EAC7C,IAAI,EAAE,kBAAkB,GACvB,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAWrC;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,GACzB,CACD,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,KACzC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA8D5B"}
@@ -0,0 +1,46 @@
1
+ /**
2
+ * loadModule — enriched error context for route manifest .load() failures.
3
+ *
4
+ * Wraps the lazy `load()` functions from the route manifest with a
5
+ * try/catch that re-throws with the file path and original cause.
6
+ *
7
+ * Callers that need fallthrough behavior (error renderers) can use
8
+ * `.catch(() => null)` or try/catch — the decision stays at the call site.
9
+ *
10
+ * See design/spike-TIM-551-dynamic-import-audit.md §"Proposed Wrapping Strategy"
11
+ */
12
+ /** A manifest file reference with a lazy import function and file path. */
13
+ export interface ManifestLoader {
14
+ load: () => Promise<unknown>;
15
+ filePath: string;
16
+ }
17
+ /**
18
+ * Custom error class for module load failures.
19
+ *
20
+ * Preserves the original error as `cause` while providing a
21
+ * human-readable message with the file path.
22
+ */
23
+ export declare class ModuleLoadError extends Error {
24
+ /** The file path that failed to load. */
25
+ readonly filePath: string;
26
+ constructor(filePath: string, cause: unknown);
27
+ }
28
+ /**
29
+ * Load a route manifest module with enriched error context.
30
+ *
31
+ * On success: returns the module object (same as `loader.load()`).
32
+ * On failure: throws `ModuleLoadError` with file path and original cause.
33
+ *
34
+ * For error rendering paths that need fallthrough instead of throwing,
35
+ * callers should catch at the call site:
36
+ *
37
+ * ```ts
38
+ * // Throwing (default) — route-element-builder, api-handler, etc.
39
+ * const mod = await loadModule(segment.page);
40
+ *
41
+ * // Fallthrough — error-renderer, error-boundary-wrapper
42
+ * const mod = await loadModule(segment.error).catch(() => null);
43
+ * ```
44
+ */
45
+ export declare function loadModule<T = Record<string, unknown>>(loader: ManifestLoader): Promise<T>;
46
+ //# sourceMappingURL=safe-load.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-load.d.ts","sourceRoot":"","sources":["../../src/server/safe-load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAK3C;CACF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAMhG"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Sensitive field stripping — removes password/token/CVV-style fields
3
+ * from form values before they are echoed back to the client as
4
+ * `submittedValues` for form repopulation.
5
+ *
6
+ * Applied to both action paths:
7
+ * - With-JS action path: `createActionClient()` in `action-client.ts`
8
+ * - No-JS form POST path: `handleFormAction()` in `action-handler.ts`
9
+ *
10
+ * Why: on a validation failure, timber echoes submitted form values back so
11
+ * the user doesn't have to re-type everything. Without filtering, plaintext
12
+ * passwords / credit-card numbers / TOTP codes would travel through the RSC
13
+ * stream (with-JS) or land in the HTML as `defaultValue` attributes (no-JS)
14
+ * — ending up in browser history, proxy logs, disk caches, and the
15
+ * back-forward cache.
16
+ *
17
+ * Safe by default: the built-in deny-list is applied unconditionally unless
18
+ * the user explicitly opts out via `forms.stripSensitiveFields: false` in
19
+ * `timber.config.ts` or per-action via `createActionClient({ stripSensitiveFields: false })`.
20
+ *
21
+ * See design/08-forms-and-actions.md §"Validation errors"
22
+ * See design/13-security.md §"Sensitive field stripping"
23
+ * See TIM-816
24
+ */
25
+ /**
26
+ * How to strip sensitive fields from `submittedValues`.
27
+ *
28
+ * - `true` / `undefined` — use the built-in deny-list (default, safe).
29
+ * - `false` — do not strip anything (dev convenience; never do this in prod).
30
+ * - `string[]` — additional field names to strip, merged with the built-in list.
31
+ * - `(name) => boolean` — custom predicate, fully replaces the built-in list.
32
+ * Return `true` to strip, `false` to keep. The `name` argument is the raw
33
+ * (un-normalized) field name as it appeared in the submitted form.
34
+ */
35
+ export type SensitiveFieldsOption = boolean | readonly string[] | ((name: string) => boolean);
36
+ /**
37
+ * A resolved predicate: `null` means "don't strip anything" (the option was
38
+ * explicitly `false`). Otherwise a function from raw field name → boolean.
39
+ */
40
+ export type ResolvedSensitivePredicate = ((name: string) => boolean) | null;
41
+ /**
42
+ * Resolve a `SensitiveFieldsOption` into a concrete predicate.
43
+ * Precedence: per-action > global > built-in default.
44
+ *
45
+ * - Per-action `undefined` → fall back to global.
46
+ * - Global `undefined` → use built-in list.
47
+ * - Either level set to `false` → disable stripping entirely (returns `null`).
48
+ * - `true` → built-in list.
49
+ * - `string[]` → built-in ∪ extras.
50
+ * - function → custom, replaces the built-in list entirely.
51
+ */
52
+ export declare function resolveSensitivePredicate(perAction: SensitiveFieldsOption | undefined, global: SensitiveFieldsOption | undefined): ResolvedSensitivePredicate;
53
+ /**
54
+ * Set the global `forms.stripSensitiveFields` config from `timber.config.ts`.
55
+ * Called once at startup from `rsc-entry`.
56
+ */
57
+ export declare function setGlobalSensitiveFieldsConfig(option: SensitiveFieldsOption | undefined): void;
58
+ /** Read the global `forms.stripSensitiveFields` config. */
59
+ export declare function getGlobalSensitiveFieldsConfig(): SensitiveFieldsOption | undefined;
60
+ /**
61
+ * Walk an object (recursively) and return a copy with every key matching
62
+ * `predicate` removed. Nested objects like `{ user: { password: '...' } }`
63
+ * are handled — `user.password` is stripped while other `user.*` fields remain.
64
+ *
65
+ * - Arrays are walked element-wise (object entries inside arrays are cleaned).
66
+ * - Non-plain values (strings, numbers, Files, Dates, etc.) are returned as-is.
67
+ * - When a stripped key is encountered, it is omitted from the result entirely
68
+ * — we do NOT set it to an empty string, because that would overwrite a
69
+ * valid `defaultValue` the form author might have set.
70
+ */
71
+ export declare function stripSensitiveFields<T>(value: T, predicate: ResolvedSensitivePredicate): T;
72
+ /** Reset the "warned once" cache. Exposed for tests. */
73
+ export declare function __resetSensitiveFieldsWarnings(): void;
74
+ //# sourceMappingURL=sensitive-fields.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sensitive-fields.d.ts","sourceRoot":"","sources":["../../src/server/sensitive-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAoF9F;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,MAAM,EAAE,qBAAqB,GAAG,SAAS,GACxC,0BAA0B,CAa5B;AAMD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAE9F;AAED,2DAA2D;AAC3D,wBAAgB,8BAA8B,IAAI,qBAAqB,GAAG,SAAS,CAElF;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,0BAA0B,GAAG,CAAC,CAoB1F;AAID,wDAAwD;AACxD,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}
@@ -0,0 +1,129 @@
1
+ /**
2
+ * Auto-generate sitemap.xml from the route tree.
3
+ *
4
+ * When enabled via `sitemap: { enabled: true, baseUrl: '...' }` in timber.config.ts,
5
+ * this module walks the route tree and produces sitemap XML for all discoverable pages.
6
+ *
7
+ * Features:
8
+ * - Collects all static page routes automatically
9
+ * - Calls `generateStaticSegmentParams()` on dynamic routes to enumerate URLs
10
+ * - Skips API routes (route.ts), layout-only segments, slots, intercepting routes
11
+ * - Skips auth-protected routes (access.ts in segment chain) by default
12
+ * - Automatic pagination: sitemap index when > 50,000 URLs
13
+ *
14
+ * See design/16-metadata.md §"Auto-generated Sitemap"
15
+ */
16
+ import type { SegmentNode } from '../routing/types.js';
17
+ /** Configuration for sitemap generation from timber.config.ts. */
18
+ export interface SitemapConfig {
19
+ /** Must be explicitly true to enable auto-generation. */
20
+ enabled: boolean;
21
+ /** Base URL for absolute URLs in the sitemap. Required. e.g., 'https://example.com' */
22
+ baseUrl: string;
23
+ /** Default changefreq for all entries. Optional. */
24
+ defaultChangeFrequency?: string;
25
+ /** Default priority for all entries (0.0–1.0). Optional. */
26
+ defaultPriority?: number;
27
+ /** Include routes protected by access.ts. Default: false. */
28
+ includeProtected?: boolean;
29
+ }
30
+ /** A single sitemap entry ready for serialization. */
31
+ export interface SitemapEntry {
32
+ url: string;
33
+ changeFrequency?: string;
34
+ priority?: number;
35
+ }
36
+ /**
37
+ * A route discovered during tree walk that may need async resolution
38
+ * (dynamic routes with generateStaticSegmentParams).
39
+ */
40
+ export interface SitemapRoute {
41
+ /** The URL path pattern (e.g., '/products/[id]'). */
42
+ urlPath: string;
43
+ /** Whether this route has dynamic segments that need generateStaticSegmentParams. */
44
+ isDynamic: boolean;
45
+ /** Loader for the page module (from route manifest). */
46
+ pageLoader?: {
47
+ load: () => Promise<unknown>;
48
+ filePath: string;
49
+ };
50
+ }
51
+ /**
52
+ * Function signature for loading a page module.
53
+ * Takes the manifest loader and returns the module exports.
54
+ */
55
+ export type ModuleLoader = (loader: {
56
+ load: () => Promise<unknown>;
57
+ filePath: string;
58
+ }) => Promise<Record<string, unknown>>;
59
+ /** Result of sitemap generation. */
60
+ export type SitemapResult = {
61
+ type: 'single';
62
+ xml: string;
63
+ } | {
64
+ type: 'index';
65
+ indexXml: string;
66
+ pages: Map<number, string>;
67
+ };
68
+ /** Maximum URLs per sitemap file per the sitemap protocol. */
69
+ export declare const URLS_PER_SITEMAP = 50000;
70
+ /**
71
+ * Walk the route tree and collect all routes eligible for the sitemap.
72
+ *
73
+ * Pure synchronous function — no module loading. Returns routes that may
74
+ * need async resolution (dynamic routes with generateStaticSegmentParams).
75
+ *
76
+ * @param root - The root segment node from the route tree
77
+ * @param config - Sitemap configuration
78
+ * @returns Array of sitemap routes to resolve
79
+ */
80
+ export declare function collectSitemapRoutes(root: SegmentNode, config: SitemapConfig): SitemapRoute[];
81
+ /**
82
+ * Check if a URL path contains dynamic segments.
83
+ *
84
+ * Dynamic segments are enclosed in brackets: [param], [...param], [[...param]]
85
+ */
86
+ export declare function hasDynamicSegments(urlPath: string): boolean;
87
+ /**
88
+ * Resolve sitemap routes into concrete URLs.
89
+ *
90
+ * For static routes, the URL is derived directly from the path.
91
+ * For dynamic routes, calls `generateStaticSegmentParams()` from the page module.
92
+ *
93
+ * @param routes - Routes collected by collectSitemapRoutes
94
+ * @param config - Sitemap configuration
95
+ * @param loadModule - Async function to load a page module by file path
96
+ * @returns Array of sitemap entries with absolute URLs
97
+ */
98
+ export declare function resolveSitemapUrls(routes: SitemapRoute[], config: SitemapConfig, loadModule?: ModuleLoader): Promise<SitemapEntry[]>;
99
+ /**
100
+ * Replace dynamic segments in a URL path with concrete param values.
101
+ *
102
+ * Handles:
103
+ * - `[param]` → single value
104
+ * - `[...param]` → slash-joined values
105
+ * - `[[...param]]` → slash-joined values (or empty string if not provided)
106
+ *
107
+ * @returns The resolved path, or null if params are missing
108
+ */
109
+ export declare function resolvePathWithParams(urlPath: string, params: Record<string, string | string[]>): string | null;
110
+ /**
111
+ * Generate the complete sitemap result from a route tree.
112
+ *
113
+ * Orchestrates tree walking, URL resolution, and XML serialization.
114
+ * Returns either a single sitemap or a paginated sitemap index.
115
+ *
116
+ * @param root - The root segment node from the route tree
117
+ * @param config - Sitemap configuration
118
+ * @param loadModule - Optional async function to load page modules (for generateStaticSegmentParams)
119
+ * @returns The sitemap result (single or index with pages)
120
+ */
121
+ export declare function generateSitemap(root: SegmentNode, config: SitemapConfig, loadModule?: ModuleLoader): Promise<SitemapResult>;
122
+ /**
123
+ * Check if the route tree root has a user-authored sitemap metadata route.
124
+ *
125
+ * When a user-authored sitemap exists at the root, auto-generation is disabled
126
+ * to avoid conflicts — the user takes full control.
127
+ */
128
+ export declare function hasUserSitemap(root: SegmentNode): boolean;
129
+ //# sourceMappingURL=sitemap-generator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sitemap-generator.d.ts","sourceRoot":"","sources":["../../src/server/sitemap-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,SAAS,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEvC,oCAAoC;AACpC,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAIpE,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,EAAE,CAI7F;AAwDD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CAqDzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GACxC,MAAM,GAAG,IAAI,CA2Cf;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,YAAY,GACxB,OAAO,CAAC,aAAa,CAAC,CA+BxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAGzD"}