@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.231

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 (1575) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +389 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
  5. package/dist/_chunks/actions-CYjRMpZI.js.map +1 -0
  6. package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
  7. package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
  8. package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
  9. package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
  10. package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
  11. package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
  12. package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
  13. package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
  14. package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
  15. package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
  16. package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
  17. package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
  18. package/dist/_chunks/chains-D-RRc7CM.js +266 -0
  19. package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
  20. package/dist/_chunks/chains-KblEfYzm.js +1 -0
  21. package/dist/_chunks/classify-_W0RWa5w.js +146 -0
  22. package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
  23. package/dist/_chunks/cli-check-BAKOSTkg.js +251 -0
  24. package/dist/_chunks/cli-check-BAKOSTkg.js.map +1 -0
  25. package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
  26. package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
  27. package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
  28. package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
  29. package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
  30. package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
  31. package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
  33. package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
  34. package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
  35. package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
  36. package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
  37. package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
  38. package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
  39. package/dist/_chunks/codec-registry-C8hOGmZo.js +13 -0
  40. package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
  41. package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
  42. package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
  43. package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
  44. package/dist/_chunks/convention-lint-D54k6uUM.js.map +1 -0
  45. package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
  46. package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
  47. package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
  48. package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
  49. package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
  50. package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
  51. package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
  52. package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
  53. package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
  54. package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
  55. package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
  56. package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
  57. package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
  58. package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
  59. package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
  60. package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
  61. package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
  62. package/dist/_chunks/format-DuPOoXUP.js +13 -0
  63. package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
  64. package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
  65. package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
  66. package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
  67. package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
  68. package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
  69. package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
  70. package/dist/_chunks/href-BtspoNc9.js +164 -0
  71. package/dist/_chunks/href-BtspoNc9.js.map +1 -0
  72. package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
  73. package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
  74. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  75. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  76. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  77. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  78. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  79. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  80. package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
  81. package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
  82. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  83. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  84. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  85. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  86. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  87. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  88. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  89. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  90. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  91. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  92. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  93. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  94. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  95. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  96. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  97. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  98. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  99. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  100. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  101. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  102. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  103. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  104. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  105. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  106. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  107. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  108. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  109. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  110. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  111. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  112. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  113. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  114. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  115. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  116. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  117. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  118. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  119. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  120. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  121. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  122. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  123. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  124. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  125. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  126. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  127. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  128. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  129. package/dist/_chunks/state-B-EBjeER.js +49 -0
  130. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  131. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  132. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  133. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  134. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  135. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  136. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  137. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  138. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  139. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  140. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  141. package/dist/adapters/build-output-helper.d.ts +81 -0
  142. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  143. package/dist/adapters/canonicalize-module.d.ts +8 -0
  144. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  145. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  146. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-dev.js +73 -0
  148. package/dist/adapters/cloudflare-dev.js.map +1 -0
  149. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  150. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  151. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  152. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  153. package/dist/adapters/cloudflare.d.ts +217 -24
  154. package/dist/adapters/cloudflare.d.ts.map +1 -1
  155. package/dist/adapters/cloudflare.js +1 -188
  156. package/dist/adapters/compress-module.d.ts +25 -4
  157. package/dist/adapters/compress-module.d.ts.map +1 -1
  158. package/dist/adapters/fs-identity.d.ts +63 -0
  159. package/dist/adapters/fs-identity.d.ts.map +1 -0
  160. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  161. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  162. package/dist/adapters/nitro-presets.d.ts +37 -0
  163. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  164. package/dist/adapters/nitro-preview.d.ts +65 -0
  165. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  166. package/dist/adapters/nitro.d.ts +69 -38
  167. package/dist/adapters/nitro.d.ts.map +1 -1
  168. package/dist/adapters/nitro.js +837 -347
  169. package/dist/adapters/nitro.js.map +1 -1
  170. package/dist/adapters/shared.d.ts +85 -0
  171. package/dist/adapters/shared.d.ts.map +1 -0
  172. package/dist/adapters/types.d.ts +124 -16
  173. package/dist/adapters/types.d.ts.map +1 -1
  174. package/dist/adapters/types.js +0 -0
  175. package/dist/analyze/chains.d.ts +124 -0
  176. package/dist/analyze/chains.d.ts.map +1 -0
  177. package/dist/analyze/classify.d.ts +153 -0
  178. package/dist/analyze/classify.d.ts.map +1 -0
  179. package/dist/analyze/crawl-entry.d.ts +17 -0
  180. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  181. package/dist/analyze/crawl-entry.js +312 -0
  182. package/dist/analyze/crawl-entry.js.map +1 -0
  183. package/dist/analyze/crawl.d.ts +134 -0
  184. package/dist/analyze/crawl.d.ts.map +1 -0
  185. package/dist/analyze/graph-cache.d.ts +104 -0
  186. package/dist/analyze/graph-cache.d.ts.map +1 -0
  187. package/dist/analyze/graph-command.d.ts +43 -0
  188. package/dist/analyze/graph-command.d.ts.map +1 -0
  189. package/dist/analyze/graph-command.js +386 -0
  190. package/dist/analyze/graph-command.js.map +1 -0
  191. package/dist/analyze/live-graph.d.ts +81 -0
  192. package/dist/analyze/live-graph.d.ts.map +1 -0
  193. package/dist/analyze/poison-rules.d.ts +72 -0
  194. package/dist/analyze/poison-rules.d.ts.map +1 -0
  195. package/dist/analyze/poison-scan.d.ts +48 -0
  196. package/dist/analyze/poison-scan.d.ts.map +1 -0
  197. package/dist/analyze/scan.d.ts +73 -0
  198. package/dist/analyze/scan.d.ts.map +1 -0
  199. package/dist/cache/cache-api.d.ts +48 -0
  200. package/dist/cache/cache-api.d.ts.map +1 -0
  201. package/dist/cache/fast-hash.d.ts +5 -0
  202. package/dist/cache/fast-hash.d.ts.map +1 -1
  203. package/dist/cache/guarded-read.d.ts +29 -0
  204. package/dist/cache/guarded-read.d.ts.map +1 -0
  205. package/dist/cache/handler-store.d.ts +45 -0
  206. package/dist/cache/handler-store.d.ts.map +1 -0
  207. package/dist/cache/index.d.ts +32 -9
  208. package/dist/cache/index.d.ts.map +1 -1
  209. package/dist/cache/index.js +4 -326
  210. package/dist/cache/invalidation-epoch.d.ts +50 -0
  211. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  212. package/dist/cache/json-lossy-check.d.ts +11 -0
  213. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  214. package/dist/cache/key-discipline.d.ts +61 -0
  215. package/dist/cache/key-discipline.d.ts.map +1 -0
  216. package/dist/cache/redis-handler.d.ts +140 -9
  217. package/dist/cache/redis-handler.d.ts.map +1 -1
  218. package/dist/cache/singleflight.d.ts +31 -2
  219. package/dist/cache/singleflight.d.ts.map +1 -1
  220. package/dist/cache/sizeof.d.ts +22 -0
  221. package/dist/cache/sizeof.d.ts.map +1 -0
  222. package/dist/cache/stable-stringify.d.ts +15 -0
  223. package/dist/cache/stable-stringify.d.ts.map +1 -1
  224. package/dist/cache/store.d.ts +53 -0
  225. package/dist/cache/store.d.ts.map +1 -0
  226. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  227. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  228. package/dist/cache/stores/cloudflare-kv.js +28 -0
  229. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  230. package/dist/cache/stores/memory.d.ts +42 -0
  231. package/dist/cache/stores/memory.d.ts.map +1 -0
  232. package/dist/cache/stores/memory.js +89 -0
  233. package/dist/cache/stores/memory.js.map +1 -0
  234. package/dist/cache/stores/redis.d.ts +69 -0
  235. package/dist/cache/stores/redis.d.ts.map +1 -0
  236. package/dist/cache/stores/redis.js +34 -0
  237. package/dist/cache/stores/redis.js.map +1 -0
  238. package/dist/cache/stores/vercel.d.ts +36 -0
  239. package/dist/cache/stores/vercel.d.ts.map +1 -0
  240. package/dist/cache/stores/vercel.js +32 -0
  241. package/dist/cache/stores/vercel.js.map +1 -0
  242. package/dist/cache/tag-aware-handler.d.ts +51 -0
  243. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  244. package/dist/cache/timber-cache.d.ts +25 -11
  245. package/dist/cache/timber-cache.d.ts.map +1 -1
  246. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  247. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  248. package/dist/cdn/cloudflare-purge.js +29 -0
  249. package/dist/cdn/cloudflare-purge.js.map +1 -0
  250. package/dist/cdn/fastly-purge.d.ts +25 -0
  251. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  252. package/dist/cdn/fastly-purge.js +32 -0
  253. package/dist/cdn/fastly-purge.js.map +1 -0
  254. package/dist/cdn/headers.d.ts +97 -0
  255. package/dist/cdn/headers.d.ts.map +1 -0
  256. package/dist/cdn/index.d.ts +5 -0
  257. package/dist/cdn/index.d.ts.map +1 -0
  258. package/dist/cdn/index.js +93 -0
  259. package/dist/cdn/index.js.map +1 -0
  260. package/dist/cdn/purge-store.d.ts +32 -0
  261. package/dist/cdn/purge-store.d.ts.map +1 -0
  262. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  263. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  264. package/dist/cdn/workers-cache-purge.js +33 -0
  265. package/dist/cdn/workers-cache-purge.js.map +1 -0
  266. package/dist/cli-check.d.ts +133 -0
  267. package/dist/cli-check.d.ts.map +1 -0
  268. package/dist/cli-context.d.ts +62 -0
  269. package/dist/cli-context.d.ts.map +1 -0
  270. package/dist/cli-dev-status.d.ts +75 -0
  271. package/dist/cli-dev-status.d.ts.map +1 -0
  272. package/dist/cli-init.d.ts +72 -0
  273. package/dist/cli-init.d.ts.map +1 -0
  274. package/dist/cli-schema-sync.d.ts +59 -0
  275. package/dist/cli-schema-sync.d.ts.map +1 -0
  276. package/dist/cli.d.ts +80 -16
  277. package/dist/cli.d.ts.map +1 -1
  278. package/dist/cli.js +210 -69
  279. package/dist/cli.js.map +1 -1
  280. package/dist/client/browser-dev.d.ts +42 -2
  281. package/dist/client/browser-dev.d.ts.map +1 -1
  282. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  283. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  284. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  285. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  286. package/dist/client/browser-entry/form-state.d.ts +22 -0
  287. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  288. package/dist/client/browser-entry/hmr.d.ts +27 -0
  289. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  290. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  291. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  292. package/dist/client/browser-entry/index.d.ts +32 -0
  293. package/dist/client/browser-entry/index.d.ts.map +1 -0
  294. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  295. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  296. package/dist/client/browser-entry/router-init.d.ts +41 -0
  297. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  298. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  299. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  300. package/dist/client/browser-entry/scroll.d.ts +28 -0
  301. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  302. package/dist/client/deny-last-resort.d.ts +29 -0
  303. package/dist/client/deny-last-resort.d.ts.map +1 -0
  304. package/dist/client/dev-pill/index.d.ts +32 -0
  305. package/dist/client/dev-pill/index.d.ts.map +1 -0
  306. package/dist/client/dev-pill/store.d.ts +105 -0
  307. package/dist/client/dev-pill/store.d.ts.map +1 -0
  308. package/dist/client/dev-pill/view.d.ts +9 -0
  309. package/dist/client/dev-pill/view.d.ts.map +1 -0
  310. package/dist/client/error-boundary.d.ts +58 -9
  311. package/dist/client/error-boundary.d.ts.map +1 -1
  312. package/dist/client/error-boundary.js +1 -126
  313. package/dist/client/error-reconstituter.d.ts +55 -0
  314. package/dist/client/error-reconstituter.d.ts.map +1 -0
  315. package/dist/client/form.d.ts +38 -99
  316. package/dist/client/form.d.ts.map +1 -1
  317. package/dist/client/global-context.d.ts +35 -0
  318. package/dist/client/global-context.d.ts.map +1 -0
  319. package/dist/client/history.d.ts +50 -9
  320. package/dist/client/history.d.ts.map +1 -1
  321. package/dist/client/index.d.ts +23 -33
  322. package/dist/client/index.d.ts.map +1 -1
  323. package/dist/client/index.js +330 -1273
  324. package/dist/client/index.js.map +1 -1
  325. package/dist/client/internal.d.ts +20 -0
  326. package/dist/client/internal.d.ts.map +1 -0
  327. package/dist/client/internal.js +785 -0
  328. package/dist/client/internal.js.map +1 -0
  329. package/dist/client/link.d.ts +75 -71
  330. package/dist/client/link.d.ts.map +1 -1
  331. package/dist/client/location-search.d.ts +12 -0
  332. package/dist/client/location-search.d.ts.map +1 -0
  333. package/dist/client/navigation-api.d.ts +95 -0
  334. package/dist/client/navigation-api.d.ts.map +1 -0
  335. package/dist/client/navigation-commit.d.ts +111 -0
  336. package/dist/client/navigation-commit.d.ts.map +1 -0
  337. package/dist/client/navigation-context.d.ts +75 -37
  338. package/dist/client/navigation-context.d.ts.map +1 -1
  339. package/dist/client/navigation-root.d.ts +106 -0
  340. package/dist/client/navigation-root.d.ts.map +1 -0
  341. package/dist/client/navigation-transition.d.ts +255 -0
  342. package/dist/client/navigation-transition.d.ts.map +1 -0
  343. package/dist/client/nuqs-adapter.d.ts +5 -2
  344. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  345. package/dist/client/params-context.d.ts +81 -0
  346. package/dist/client/params-context.d.ts.map +1 -0
  347. package/dist/client/react-root.d.ts +51 -0
  348. package/dist/client/react-root.d.ts.map +1 -0
  349. package/dist/client/router-effects.d.ts +203 -0
  350. package/dist/client/router-effects.d.ts.map +1 -0
  351. package/dist/client/router-lifecycle.d.ts +107 -0
  352. package/dist/client/router-lifecycle.d.ts.map +1 -0
  353. package/dist/client/router-pipeline.d.ts +81 -0
  354. package/dist/client/router-pipeline.d.ts.map +1 -0
  355. package/dist/client/router-ref.d.ts +2 -2
  356. package/dist/client/router-ref.d.ts.map +1 -1
  357. package/dist/client/router-skew.d.ts +21 -0
  358. package/dist/client/router-skew.d.ts.map +1 -0
  359. package/dist/client/router-types.d.ts +294 -0
  360. package/dist/client/router-types.d.ts.map +1 -0
  361. package/dist/client/router-url.d.ts +24 -0
  362. package/dist/client/router-url.d.ts.map +1 -0
  363. package/dist/client/router.d.ts +1 -97
  364. package/dist/client/router.d.ts.map +1 -1
  365. package/dist/client/rsc-fetch.d.ts +110 -28
  366. package/dist/client/rsc-fetch.d.ts.map +1 -1
  367. package/dist/client/segment-cache.d.ts +186 -25
  368. package/dist/client/segment-cache.d.ts.map +1 -1
  369. package/dist/client/segment-context.d.ts.map +1 -1
  370. package/dist/client/segment-outlet.d.ts +68 -0
  371. package/dist/client/segment-outlet.d.ts.map +1 -0
  372. package/dist/client/segment-update-context.d.ts +15 -0
  373. package/dist/client/segment-update-context.d.ts.map +1 -0
  374. package/dist/client/shallow-url.d.ts +10 -0
  375. package/dist/client/shallow-url.d.ts.map +1 -0
  376. package/dist/client/slot-content-cache-context.d.ts +35 -0
  377. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  378. package/dist/client/slot-context.d.ts +31 -0
  379. package/dist/client/slot-context.d.ts.map +1 -0
  380. package/dist/client/slot-outlet.d.ts +16 -0
  381. package/dist/client/slot-outlet.d.ts.map +1 -0
  382. package/dist/client/slot-provider.d.ts +25 -0
  383. package/dist/client/slot-provider.d.ts.map +1 -0
  384. package/dist/client/ssr-data.d.ts +26 -50
  385. package/dist/client/ssr-data.d.ts.map +1 -1
  386. package/dist/client/stale-client.d.ts +69 -0
  387. package/dist/client/stale-client.d.ts.map +1 -0
  388. package/dist/client/state.d.ts +21 -13
  389. package/dist/client/state.d.ts.map +1 -1
  390. package/dist/client/status-page-marker.d.ts +25 -0
  391. package/dist/client/status-page-marker.d.ts.map +1 -0
  392. package/dist/client/top-loader.d.ts +7 -6
  393. package/dist/client/top-loader.d.ts.map +1 -1
  394. package/dist/client/unload-guard.d.ts +5 -0
  395. package/dist/client/unload-guard.d.ts.map +1 -1
  396. package/dist/client/use-cookie.d.ts +25 -0
  397. package/dist/client/use-cookie.d.ts.map +1 -1
  398. package/dist/client/use-field-state.d.ts +42 -0
  399. package/dist/client/use-field-state.d.ts.map +1 -0
  400. package/dist/client/use-link-status.d.ts +5 -5
  401. package/dist/client/use-link-status.d.ts.map +1 -1
  402. package/dist/client/use-pathname.d.ts +13 -11
  403. package/dist/client/use-pathname.d.ts.map +1 -1
  404. package/dist/client/use-pending-navigation.d.ts +47 -0
  405. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  406. package/dist/client/use-query-states.d.ts +10 -4
  407. package/dist/client/use-query-states.d.ts.map +1 -1
  408. package/dist/client/use-router.d.ts +15 -8
  409. package/dist/client/use-router.d.ts.map +1 -1
  410. package/dist/client/use-search-params.d.ts +15 -8
  411. package/dist/client/use-search-params.d.ts.map +1 -1
  412. package/dist/client/use-segment-params.d.ts +55 -0
  413. package/dist/client/use-segment-params.d.ts.map +1 -0
  414. package/dist/codec.d.ts +69 -0
  415. package/dist/codec.d.ts.map +1 -0
  416. package/dist/codec.js +75 -0
  417. package/dist/codec.js.map +1 -0
  418. package/dist/config-types.d.ts +366 -0
  419. package/dist/config-types.d.ts.map +1 -0
  420. package/dist/config-validation.d.ts +68 -0
  421. package/dist/config-validation.d.ts.map +1 -0
  422. package/dist/cookies/define-cookie.d.ts +58 -25
  423. package/dist/cookies/define-cookie.d.ts.map +1 -1
  424. package/dist/cookies/index.d.ts +3 -2
  425. package/dist/cookies/index.d.ts.map +1 -1
  426. package/dist/cookies/index.js +230 -37
  427. package/dist/cookies/index.js.map +1 -1
  428. package/dist/cookies/json-cookie.d.ts +64 -0
  429. package/dist/cookies/json-cookie.d.ts.map +1 -0
  430. package/dist/cookies/validation.d.ts +34 -0
  431. package/dist/cookies/validation.d.ts.map +1 -0
  432. package/dist/dev-tools/404-page.d.ts +50 -0
  433. package/dist/dev-tools/404-page.d.ts.map +1 -0
  434. package/dist/dev-tools/await-span.d.ts +17 -0
  435. package/dist/dev-tools/await-span.d.ts.map +1 -0
  436. package/dist/dev-tools/browser-logs.d.ts +40 -0
  437. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  438. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  439. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  440. package/dist/dev-tools/error-page.d.ts +32 -0
  441. package/dist/dev-tools/error-page.d.ts.map +1 -0
  442. package/dist/dev-tools/holding-server.d.ts +46 -0
  443. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  444. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  445. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  446. package/dist/dev-tools/index.d.ts +31 -0
  447. package/dist/dev-tools/index.d.ts.map +1 -0
  448. package/dist/dev-tools/instrumentation.d.ts +74 -0
  449. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  450. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  451. package/dist/dev-tools/logger.d.ts.map +1 -0
  452. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  453. package/dist/dev-tools/logs.d.ts.map +1 -0
  454. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  455. package/dist/dev-tools/overlay.d.ts.map +1 -0
  456. package/dist/dev-tools/span-sink.d.ts +42 -0
  457. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  458. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  459. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  460. package/dist/dev-tools/terminal.d.ts +28 -0
  461. package/dist/dev-tools/terminal.d.ts.map +1 -0
  462. package/dist/fonts/ast-walk.d.ts +68 -0
  463. package/dist/fonts/ast-walk.d.ts.map +1 -0
  464. package/dist/fonts/ast.d.ts +112 -8
  465. package/dist/fonts/ast.d.ts.map +1 -1
  466. package/dist/fonts/bundle.d.ts +50 -0
  467. package/dist/fonts/bundle.d.ts.map +1 -0
  468. package/dist/fonts/css.d.ts +1 -1
  469. package/dist/fonts/dev-middleware.d.ts +22 -0
  470. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  471. package/dist/fonts/fallbacks.d.ts +0 -7
  472. package/dist/fonts/fallbacks.d.ts.map +1 -1
  473. package/dist/fonts/google.d.ts +5 -3
  474. package/dist/fonts/google.d.ts.map +1 -1
  475. package/dist/fonts/local.d.ts +5 -5
  476. package/dist/fonts/local.d.ts.map +1 -1
  477. package/dist/fonts/paths.d.ts +43 -0
  478. package/dist/fonts/paths.d.ts.map +1 -0
  479. package/dist/fonts/pipeline.d.ts +177 -0
  480. package/dist/fonts/pipeline.d.ts.map +1 -0
  481. package/dist/fonts/transform.d.ts +82 -0
  482. package/dist/fonts/transform.d.ts.map +1 -0
  483. package/dist/fonts/types.d.ts +47 -1
  484. package/dist/fonts/types.d.ts.map +1 -1
  485. package/dist/fonts/virtual-modules.d.ts +77 -0
  486. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  487. package/dist/index.d.ts +37 -181
  488. package/dist/index.d.ts.map +1 -1
  489. package/dist/index.js +9952 -14264
  490. package/dist/index.js.map +1 -1
  491. package/dist/params/codec-registry.d.ts +36 -0
  492. package/dist/params/codec-registry.d.ts.map +1 -0
  493. package/dist/params/define-schema.d.ts +81 -0
  494. package/dist/params/define-schema.d.ts.map +1 -0
  495. package/dist/params/index.d.ts +4 -0
  496. package/dist/params/index.d.ts.map +1 -0
  497. package/dist/params/index.js +32 -0
  498. package/dist/params/index.js.map +1 -0
  499. package/dist/params/resolve-schema.d.ts +34 -0
  500. package/dist/params/resolve-schema.d.ts.map +1 -0
  501. package/dist/plugin-context.d.ts +269 -0
  502. package/dist/plugin-context.d.ts.map +1 -0
  503. package/dist/plugins/build-manifest.d.ts +7 -3
  504. package/dist/plugins/build-manifest.d.ts.map +1 -1
  505. package/dist/plugins/build-report.d.ts +61 -11
  506. package/dist/plugins/build-report.d.ts.map +1 -1
  507. package/dist/plugins/cache.d.ts +64 -0
  508. package/dist/plugins/cache.d.ts.map +1 -0
  509. package/dist/plugins/callsite-ast.d.ts +117 -0
  510. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  511. package/dist/plugins/callsite-jsx.d.ts +35 -0
  512. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  513. package/dist/plugins/chunks.d.ts +11 -4
  514. package/dist/plugins/chunks.d.ts.map +1 -1
  515. package/dist/plugins/client-chunks.d.ts +40 -0
  516. package/dist/plugins/client-chunks.d.ts.map +1 -0
  517. package/dist/plugins/client-dep-entries.d.ts +80 -0
  518. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  519. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  520. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  521. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  522. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  523. package/dist/plugins/content.d.ts +1 -1
  524. package/dist/plugins/content.d.ts.map +1 -1
  525. package/dist/plugins/dev-await.d.ts +81 -0
  526. package/dist/plugins/dev-await.d.ts.map +1 -0
  527. package/dist/plugins/dev-discovery.d.ts +187 -0
  528. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  529. package/dist/plugins/dev-hostname.d.ts +152 -0
  530. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  531. package/dist/plugins/dev-server.d.ts +29 -2
  532. package/dist/plugins/dev-server.d.ts.map +1 -1
  533. package/dist/plugins/dev-store-clear.d.ts +83 -0
  534. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  535. package/dist/plugins/encryption-runtime.d.ts +13 -0
  536. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  537. package/dist/plugins/entries.d.ts +40 -4
  538. package/dist/plugins/entries.d.ts.map +1 -1
  539. package/dist/plugins/fonts.d.ts +35 -74
  540. package/dist/plugins/fonts.d.ts.map +1 -1
  541. package/dist/plugins/graph-endpoint.d.ts +114 -0
  542. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  543. package/dist/plugins/mdx.d.ts +18 -5
  544. package/dist/plugins/mdx.d.ts.map +1 -1
  545. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  546. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  547. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  548. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  549. package/dist/plugins/orphaned-modules.d.ts +57 -0
  550. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  551. package/dist/plugins/post-build.d.ts +110 -0
  552. package/dist/plugins/post-build.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  554. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  555. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  556. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  557. package/dist/plugins/prebuilt.d.ts +98 -0
  558. package/dist/plugins/prebuilt.d.ts.map +1 -0
  559. package/dist/plugins/prerender-sugar.d.ts +39 -0
  560. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  561. package/dist/plugins/react-resolve.d.ts +49 -0
  562. package/dist/plugins/react-resolve.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  564. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  565. package/dist/plugins/request-dep/index.d.ts +75 -0
  566. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  567. package/dist/plugins/request-dep/origin.d.ts +61 -0
  568. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  569. package/dist/plugins/routing.d.ts +2 -2
  570. package/dist/plugins/routing.d.ts.map +1 -1
  571. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  572. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  573. package/dist/plugins/server-bundle.d.ts +1 -1
  574. package/dist/plugins/server-bundle.d.ts.map +1 -1
  575. package/dist/plugins/shims.d.ts +29 -5
  576. package/dist/plugins/shims.d.ts.map +1 -1
  577. package/dist/plugins/static-build.d.ts +246 -26
  578. package/dist/plugins/static-build.d.ts.map +1 -1
  579. package/dist/routes/href.d.ts +124 -0
  580. package/dist/routes/href.d.ts.map +1 -0
  581. package/dist/routes/index.d.ts +4 -0
  582. package/dist/routes/index.d.ts.map +1 -0
  583. package/dist/routes/index.js +8 -0
  584. package/dist/routes/index.js.map +1 -0
  585. package/dist/routing/codegen-shared.d.ts +26 -0
  586. package/dist/routing/codegen-shared.d.ts.map +1 -0
  587. package/dist/routing/codegen-types.d.ts +61 -0
  588. package/dist/routing/codegen-types.d.ts.map +1 -0
  589. package/dist/routing/codegen-write.d.ts +42 -0
  590. package/dist/routing/codegen-write.d.ts.map +1 -0
  591. package/dist/routing/codegen.d.ts +8 -3
  592. package/dist/routing/codegen.d.ts.map +1 -1
  593. package/dist/routing/collision-probe.d.ts +104 -0
  594. package/dist/routing/collision-probe.d.ts.map +1 -0
  595. package/dist/routing/collision-spaces.d.ts +26 -0
  596. package/dist/routing/collision-spaces.d.ts.map +1 -0
  597. package/dist/routing/convention-lint.d.ts +55 -0
  598. package/dist/routing/convention-lint.d.ts.map +1 -0
  599. package/dist/routing/export-detect.d.ts +91 -0
  600. package/dist/routing/export-detect.d.ts.map +1 -0
  601. package/dist/routing/file-cache.d.ts +8 -0
  602. package/dist/routing/file-cache.d.ts.map +1 -0
  603. package/dist/routing/index.d.ts +13 -7
  604. package/dist/routing/index.d.ts.map +1 -1
  605. package/dist/routing/index.js +5 -2
  606. package/dist/routing/interception-overlap.d.ts +35 -0
  607. package/dist/routing/interception-overlap.d.ts.map +1 -0
  608. package/dist/routing/interception.d.ts +234 -10
  609. package/dist/routing/interception.d.ts.map +1 -1
  610. package/dist/routing/link-codegen.d.ts +136 -0
  611. package/dist/routing/link-codegen.d.ts.map +1 -0
  612. package/dist/routing/manifest-codegen.d.ts +26 -0
  613. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  614. package/dist/routing/scanner.d.ts +14 -10
  615. package/dist/routing/scanner.d.ts.map +1 -1
  616. package/dist/routing/schema-validation.d.ts +35 -0
  617. package/dist/routing/schema-validation.d.ts.map +1 -0
  618. package/dist/routing/segment-classify.d.ts +114 -0
  619. package/dist/routing/segment-classify.d.ts.map +1 -0
  620. package/dist/routing/segment-codegen.d.ts +38 -0
  621. package/dist/routing/segment-codegen.d.ts.map +1 -0
  622. package/dist/routing/segment-keys.d.ts +118 -0
  623. package/dist/routing/segment-keys.d.ts.map +1 -0
  624. package/dist/routing/slot-placement.d.ts +48 -0
  625. package/dist/routing/slot-placement.d.ts.map +1 -0
  626. package/dist/routing/types.d.ts +81 -26
  627. package/dist/routing/types.d.ts.map +1 -1
  628. package/dist/routing/walkers.d.ts +57 -0
  629. package/dist/routing/walkers.d.ts.map +1 -0
  630. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  631. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  632. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  633. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  634. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  635. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  636. package/dist/rsc-runtime/rsc.d.ts +3 -13
  637. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  638. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  639. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  640. package/dist/rsc-runtime/server-references.d.ts +19 -0
  641. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  642. package/dist/rsc-runtime/ssr.d.ts +7 -10
  643. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  644. package/dist/rsc-runtime/transforms.d.ts +13 -0
  645. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  646. package/dist/schema-bridge.d.ts +154 -0
  647. package/dist/schema-bridge.d.ts.map +1 -0
  648. package/dist/search-params/define.d.ts +262 -0
  649. package/dist/search-params/define.d.ts.map +1 -0
  650. package/dist/search-params/index.d.ts +3 -7
  651. package/dist/search-params/index.d.ts.map +1 -1
  652. package/dist/search-params/index.js +178 -362
  653. package/dist/search-params/index.js.map +1 -1
  654. package/dist/search-params/parse-total.d.ts +81 -0
  655. package/dist/search-params/parse-total.d.ts.map +1 -0
  656. package/dist/search-params/serialize-equal.d.ts +9 -0
  657. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  658. package/dist/search-params/wrappers.d.ts +76 -0
  659. package/dist/search-params/wrappers.d.ts.map +1 -0
  660. package/dist/server/abort-scope.d.ts +27 -0
  661. package/dist/server/abort-scope.d.ts.map +1 -0
  662. package/dist/server/access-gate.d.ts +110 -10
  663. package/dist/server/access-gate.d.ts.map +1 -1
  664. package/dist/server/action-client.d.ts +20 -133
  665. package/dist/server/action-client.d.ts.map +1 -1
  666. package/dist/server/action-encryption.d.ts +76 -0
  667. package/dist/server/action-encryption.d.ts.map +1 -0
  668. package/dist/server/action-handler.d.ts +60 -11
  669. package/dist/server/action-handler.d.ts.map +1 -1
  670. package/dist/server/action-schema.d.ts +126 -0
  671. package/dist/server/action-schema.d.ts.map +1 -0
  672. package/dist/server/action-types.d.ts +108 -0
  673. package/dist/server/action-types.d.ts.map +1 -0
  674. package/dist/server/actions.d.ts +78 -40
  675. package/dist/server/actions.d.ts.map +1 -1
  676. package/dist/server/als-registry.d.ts +189 -17
  677. package/dist/server/als-registry.d.ts.map +1 -1
  678. package/dist/server/body-limits.d.ts.map +1 -1
  679. package/dist/server/build-manifest.d.ts +25 -30
  680. package/dist/server/build-manifest.d.ts.map +1 -1
  681. package/dist/server/canonicalize.d.ts +53 -0
  682. package/dist/server/canonicalize.d.ts.map +1 -1
  683. package/dist/server/chain-url-parts.d.ts +82 -0
  684. package/dist/server/chain-url-parts.d.ts.map +1 -0
  685. package/dist/server/children-interception.d.ts +49 -0
  686. package/dist/server/children-interception.d.ts.map +1 -0
  687. package/dist/server/client-error-message.d.ts +12 -0
  688. package/dist/server/client-error-message.d.ts.map +1 -0
  689. package/dist/server/coalesce-tick.d.ts +40 -0
  690. package/dist/server/coalesce-tick.d.ts.map +1 -0
  691. package/dist/server/compress.d.ts +2 -0
  692. package/dist/server/compress.d.ts.map +1 -1
  693. package/dist/server/cookie-context.d.ts +156 -0
  694. package/dist/server/cookie-context.d.ts.map +1 -0
  695. package/dist/server/cookie-parsing.d.ts +65 -0
  696. package/dist/server/cookie-parsing.d.ts.map +1 -0
  697. package/dist/server/csp-nonce.d.ts +36 -0
  698. package/dist/server/csp-nonce.d.ts.map +1 -0
  699. package/dist/server/csrf.d.ts +58 -15
  700. package/dist/server/csrf.d.ts.map +1 -1
  701. package/dist/server/debug.d.ts +0 -1
  702. package/dist/server/debug.d.ts.map +1 -1
  703. package/dist/server/default-logger.d.ts +23 -0
  704. package/dist/server/default-logger.d.ts.map +1 -0
  705. package/dist/server/default-status-page.d.ts +45 -0
  706. package/dist/server/default-status-page.d.ts.map +1 -0
  707. package/dist/server/deny-boundary.d.ts +257 -0
  708. package/dist/server/deny-boundary.d.ts.map +1 -0
  709. package/dist/server/deny-renderer.d.ts +22 -15
  710. package/dist/server/deny-renderer.d.ts.map +1 -1
  711. package/dist/server/early-hints-sender.d.ts.map +1 -1
  712. package/dist/server/early-hints.d.ts +14 -12
  713. package/dist/server/early-hints.d.ts.map +1 -1
  714. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  715. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  716. package/dist/server/error-response-headers.d.ts +3 -0
  717. package/dist/server/error-response-headers.d.ts.map +1 -0
  718. package/dist/server/fallback-error.d.ts +19 -7
  719. package/dist/server/fallback-error.d.ts.map +1 -1
  720. package/dist/server/flight-injection-state.d.ts +66 -0
  721. package/dist/server/flight-injection-state.d.ts.map +1 -0
  722. package/dist/server/flight-injector-core.d.ts +125 -0
  723. package/dist/server/flight-injector-core.d.ts.map +1 -0
  724. package/dist/server/flight-scripts.d.ts +63 -0
  725. package/dist/server/flight-scripts.d.ts.map +1 -0
  726. package/dist/server/flight-source-node.d.ts +105 -0
  727. package/dist/server/flight-source-node.d.ts.map +1 -0
  728. package/dist/server/flight-source.d.ts +136 -0
  729. package/dist/server/flight-source.d.ts.map +1 -0
  730. package/dist/server/form-data.d.ts +59 -2
  731. package/dist/server/form-data.d.ts.map +1 -1
  732. package/dist/server/form-state-flight.d.ts +32 -0
  733. package/dist/server/form-state-flight.d.ts.map +1 -0
  734. package/dist/server/head-response.d.ts +35 -0
  735. package/dist/server/head-response.d.ts.map +1 -0
  736. package/dist/server/html-injector-core.d.ts +169 -0
  737. package/dist/server/html-injector-core.d.ts.map +1 -0
  738. package/dist/server/html-injectors.d.ts +77 -47
  739. package/dist/server/html-injectors.d.ts.map +1 -1
  740. package/dist/server/index.d.ts +16 -54
  741. package/dist/server/index.d.ts.map +1 -1
  742. package/dist/server/index.js +621 -3009
  743. package/dist/server/index.js.map +1 -1
  744. package/dist/server/instrumentation.d.ts +13 -5
  745. package/dist/server/instrumentation.d.ts.map +1 -1
  746. package/dist/server/interception-gates.d.ts +49 -0
  747. package/dist/server/interception-gates.d.ts.map +1 -0
  748. package/dist/server/internal.d.ts +48 -0
  749. package/dist/server/internal.d.ts.map +1 -0
  750. package/dist/server/internal.js +5092 -0
  751. package/dist/server/internal.js.map +1 -0
  752. package/dist/server/json-status-response.d.ts +34 -0
  753. package/dist/server/json-status-response.d.ts.map +1 -0
  754. package/dist/server/logger.d.ts +105 -7
  755. package/dist/server/logger.d.ts.map +1 -1
  756. package/dist/server/metadata-collector.d.ts +75 -0
  757. package/dist/server/metadata-collector.d.ts.map +1 -0
  758. package/dist/server/metadata-platform.d.ts +2 -2
  759. package/dist/server/metadata-render.d.ts +2 -2
  760. package/dist/server/metadata-render.d.ts.map +1 -1
  761. package/dist/server/metadata-route-links.d.ts +70 -0
  762. package/dist/server/metadata-route-links.d.ts.map +1 -0
  763. package/dist/server/metadata-routes.d.ts +47 -11
  764. package/dist/server/metadata-routes.d.ts.map +1 -1
  765. package/dist/server/metadata-social.d.ts +2 -2
  766. package/dist/server/metadata.d.ts +10 -2
  767. package/dist/server/metadata.d.ts.map +1 -1
  768. package/dist/server/middleware-runner.d.ts +20 -5
  769. package/dist/server/middleware-runner.d.ts.map +1 -1
  770. package/dist/server/node-body-response.d.ts +55 -0
  771. package/dist/server/node-body-response.d.ts.map +1 -0
  772. package/dist/server/node-response.d.ts +62 -0
  773. package/dist/server/node-response.d.ts.map +1 -0
  774. package/dist/server/node-stream-transforms.d.ts +108 -0
  775. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  776. package/dist/server/node-streams-platform.d.ts +21 -0
  777. package/dist/server/node-streams-platform.d.ts.map +1 -0
  778. package/dist/server/param-coercion.d.ts +84 -0
  779. package/dist/server/param-coercion.d.ts.map +1 -0
  780. package/dist/server/pipeline-helpers.d.ts +227 -0
  781. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  782. package/dist/server/pipeline-interception.d.ts +100 -9
  783. package/dist/server/pipeline-interception.d.ts.map +1 -1
  784. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  785. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  786. package/dist/server/pipeline-metadata.d.ts +18 -2
  787. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  788. package/dist/server/pipeline-outcome.d.ts +59 -0
  789. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  790. package/dist/server/pipeline-phases.d.ts +76 -0
  791. package/dist/server/pipeline-phases.d.ts.map +1 -0
  792. package/dist/server/pipeline.d.ts +190 -23
  793. package/dist/server/pipeline.d.ts.map +1 -1
  794. package/dist/server/port-resolution.d.ts +22 -0
  795. package/dist/server/port-resolution.d.ts.map +1 -0
  796. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  797. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  798. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  799. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  800. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  801. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  802. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  803. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  804. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  805. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  806. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  807. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  808. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  809. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  810. package/dist/server/prebuilt/overlay.d.ts +119 -0
  811. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  812. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  813. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  814. package/dist/server/prebuilt/slots.d.ts +105 -0
  815. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  816. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  817. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  818. package/dist/server/prebuilt-builder.d.ts +121 -0
  819. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  820. package/dist/server/prebuilt-runtime.d.ts +105 -0
  821. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  822. package/dist/server/primitives.d.ts +114 -90
  823. package/dist/server/primitives.d.ts.map +1 -1
  824. package/dist/server/publish-params.d.ts +33 -0
  825. package/dist/server/publish-params.d.ts.map +1 -0
  826. package/dist/server/react-cache-bridge.d.ts +59 -0
  827. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  828. package/dist/server/react-cache-scope.d.ts +49 -0
  829. package/dist/server/react-cache-scope.d.ts.map +1 -0
  830. package/dist/server/render-timeout.d.ts +66 -0
  831. package/dist/server/render-timeout.d.ts.map +1 -0
  832. package/dist/server/render-utils.d.ts +56 -0
  833. package/dist/server/render-utils.d.ts.map +1 -0
  834. package/dist/server/request-context.d.ts +167 -103
  835. package/dist/server/request-context.d.ts.map +1 -1
  836. package/dist/server/request-dep.d.ts +15 -0
  837. package/dist/server/request-dep.d.ts.map +1 -0
  838. package/dist/server/response-cache-policy.d.ts +3 -0
  839. package/dist/server/response-cache-policy.d.ts.map +1 -0
  840. package/dist/server/response-framing.d.ts +43 -0
  841. package/dist/server/response-framing.d.ts.map +1 -0
  842. package/dist/server/route-element-builder.d.ts +57 -30
  843. package/dist/server/route-element-builder.d.ts.map +1 -1
  844. package/dist/server/route-element-helpers.d.ts +12 -0
  845. package/dist/server/route-element-helpers.d.ts.map +1 -0
  846. package/dist/server/route-handler.d.ts +9 -3
  847. package/dist/server/route-handler.d.ts.map +1 -1
  848. package/dist/server/route-matcher.d.ts +75 -40
  849. package/dist/server/route-matcher.d.ts.map +1 -1
  850. package/dist/server/route-methods.d.ts +23 -0
  851. package/dist/server/route-methods.d.ts.map +1 -0
  852. package/dist/server/route-module-loader.d.ts +37 -0
  853. package/dist/server/route-module-loader.d.ts.map +1 -0
  854. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  855. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  856. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  857. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  858. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  859. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  860. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  861. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  862. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  863. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  865. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  866. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  867. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/index.d.ts +30 -6
  869. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  871. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  872. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  873. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  874. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  875. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  876. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  877. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  878. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  879. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  880. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  881. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  882. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  883. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  884. package/dist/server/rsc-error-envelope.d.ts +11 -0
  885. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  886. package/dist/server/safe-load.d.ts +39 -0
  887. package/dist/server/safe-load.d.ts.map +1 -0
  888. package/dist/server/schema-introspection.d.ts +68 -0
  889. package/dist/server/schema-introspection.d.ts.map +1 -0
  890. package/dist/server/sensitive-fields.d.ts +88 -0
  891. package/dist/server/sensitive-fields.d.ts.map +1 -0
  892. package/dist/server/signal-identity.d.ts +49 -0
  893. package/dist/server/signal-identity.d.ts.map +1 -0
  894. package/dist/server/sitemap-generator.d.ts +130 -0
  895. package/dist/server/sitemap-generator.d.ts.map +1 -0
  896. package/dist/server/sitemap-handler.d.ts +22 -0
  897. package/dist/server/sitemap-handler.d.ts.map +1 -0
  898. package/dist/server/skippable-prefix.d.ts +29 -0
  899. package/dist/server/skippable-prefix.d.ts.map +1 -0
  900. package/dist/server/slot-interception.d.ts +80 -0
  901. package/dist/server/slot-interception.d.ts.map +1 -0
  902. package/dist/server/slot-resolver.d.ts +138 -7
  903. package/dist/server/slot-resolver.d.ts.map +1 -1
  904. package/dist/server/slot-subtree-contain.d.ts +54 -0
  905. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  906. package/dist/server/ssr-bridge-types.d.ts +213 -0
  907. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  908. package/dist/server/ssr-entry.d.ts +15 -51
  909. package/dist/server/ssr-entry.d.ts.map +1 -1
  910. package/dist/server/ssr-form-state.d.ts +30 -0
  911. package/dist/server/ssr-form-state.d.ts.map +1 -0
  912. package/dist/server/ssr-render.d.ts +42 -12
  913. package/dist/server/ssr-render.d.ts.map +1 -1
  914. package/dist/server/ssr-wrappers.d.ts +92 -0
  915. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  916. package/dist/server/state-tree-diff.d.ts +44 -9
  917. package/dist/server/state-tree-diff.d.ts.map +1 -1
  918. package/dist/server/static-generator.d.ts +112 -0
  919. package/dist/server/static-generator.d.ts.map +1 -0
  920. package/dist/server/static-not-found.d.ts +52 -0
  921. package/dist/server/static-not-found.d.ts.map +1 -0
  922. package/dist/server/status-code-resolver.d.ts +26 -15
  923. package/dist/server/status-code-resolver.d.ts.map +1 -1
  924. package/dist/server/stream-utils.d.ts +93 -0
  925. package/dist/server/stream-utils.d.ts.map +1 -0
  926. package/dist/server/traced-access.d.ts +18 -0
  927. package/dist/server/traced-access.d.ts.map +1 -0
  928. package/dist/server/tracing.d.ts +72 -31
  929. package/dist/server/tracing.d.ts.map +1 -1
  930. package/dist/server/tree-match.d.ts +59 -0
  931. package/dist/server/tree-match.d.ts.map +1 -0
  932. package/dist/server/types.d.ts +90 -8
  933. package/dist/server/types.d.ts.map +1 -1
  934. package/dist/server/utils/element-type.d.ts +50 -0
  935. package/dist/server/utils/element-type.d.ts.map +1 -0
  936. package/dist/server/utils/escape-html.d.ts +14 -0
  937. package/dist/server/utils/escape-html.d.ts.map +1 -0
  938. package/dist/server/version-skew.d.ts +61 -0
  939. package/dist/server/version-skew.d.ts.map +1 -0
  940. package/dist/server/workers-cache-bridge.d.ts +26 -0
  941. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  942. package/dist/shared/als-slots.d.ts +42 -0
  943. package/dist/shared/als-slots.d.ts.map +1 -0
  944. package/dist/shared/base-path.d.ts +56 -0
  945. package/dist/shared/base-path.d.ts.map +1 -0
  946. package/dist/shared/csrf-reject.d.ts +16 -0
  947. package/dist/shared/csrf-reject.d.ts.map +1 -0
  948. package/dist/shared/dev-span.d.ts +99 -0
  949. package/dist/shared/dev-span.d.ts.map +1 -0
  950. package/dist/shared/error-digest.d.ts +28 -0
  951. package/dist/shared/error-digest.d.ts.map +1 -0
  952. package/dist/shared/flight-base64.d.ts +13 -0
  953. package/dist/shared/flight-base64.d.ts.map +1 -0
  954. package/dist/shared/flight-segment.d.ts +18 -0
  955. package/dist/shared/flight-segment.d.ts.map +1 -0
  956. package/dist/shared/form-state-flight.d.ts +32 -0
  957. package/dist/shared/form-state-flight.d.ts.map +1 -0
  958. package/dist/shared/href-validation.d.ts +49 -0
  959. package/dist/shared/href-validation.d.ts.map +1 -0
  960. package/dist/shared/href.d.ts +88 -0
  961. package/dist/shared/href.d.ts.map +1 -0
  962. package/dist/shared/merge-search-params.d.ts +22 -0
  963. package/dist/shared/merge-search-params.d.ts.map +1 -0
  964. package/dist/shared/param-value.d.ts +104 -0
  965. package/dist/shared/param-value.d.ts.map +1 -0
  966. package/dist/shared/payload-root.d.ts +110 -0
  967. package/dist/shared/payload-root.d.ts.map +1 -0
  968. package/dist/shared/redirect-type.d.ts +17 -0
  969. package/dist/shared/redirect-type.d.ts.map +1 -0
  970. package/dist/shared/rsc-cache-key.d.ts +163 -0
  971. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  972. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  973. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  974. package/dist/shared/rsc-manifest.d.ts +28 -0
  975. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  976. package/dist/shared/rsc-media-type.d.ts +52 -0
  977. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  978. package/dist/shared/rsc-payload-path.d.ts +48 -0
  979. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  980. package/dist/shared/segment-info.d.ts +66 -0
  981. package/dist/shared/segment-info.d.ts.map +1 -0
  982. package/dist/shared/slot-params.d.ts +52 -0
  983. package/dist/shared/slot-params.d.ts.map +1 -0
  984. package/dist/shared/static-platform-files.d.ts +71 -0
  985. package/dist/shared/static-platform-files.d.ts.map +1 -0
  986. package/dist/shared/status-reason-phrase.d.ts +26 -0
  987. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  988. package/dist/shims/font-google.d.ts +1 -1
  989. package/dist/shims/font-google.d.ts.map +1 -1
  990. package/dist/shims/font-google.js +41 -0
  991. package/dist/shims/font-google.js.map +1 -0
  992. package/dist/shims/font-local.d.ts +26 -0
  993. package/dist/shims/font-local.d.ts.map +1 -0
  994. package/dist/shims/font-local.js +19 -0
  995. package/dist/shims/font-local.js.map +1 -0
  996. package/dist/shims/headers.d.ts +60 -1
  997. package/dist/shims/headers.d.ts.map +1 -1
  998. package/dist/shims/image.d.ts +120 -120
  999. package/dist/shims/image.d.ts.map +1 -1
  1000. package/dist/shims/navigation-client.d.ts +25 -12
  1001. package/dist/shims/navigation-client.d.ts.map +1 -1
  1002. package/dist/shims/navigation-rsc.d.ts +21 -0
  1003. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  1004. package/dist/shims/navigation.d.ts +10 -5
  1005. package/dist/shims/navigation.d.ts.map +1 -1
  1006. package/dist/utils/state-machine.d.ts +80 -0
  1007. package/dist/utils/state-machine.d.ts.map +1 -0
  1008. package/dist/utils/write-file-atomic.d.ts +17 -0
  1009. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  1010. package/docs/api/30-api-server.mdx +241 -0
  1011. package/docs/api/31-api-client.mdx +225 -0
  1012. package/docs/api/32-api-cache.mdx +341 -0
  1013. package/docs/api/33-api-search-params.mdx +178 -0
  1014. package/docs/api/34-api-config.mdx +421 -0
  1015. package/docs/api/35-api-typescript.mdx +123 -0
  1016. package/docs/api/36-cli.mdx +272 -0
  1017. package/docs/learn/00-introduction.mdx +109 -0
  1018. package/docs/learn/01-quick-start.mdx +94 -0
  1019. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1020. package/docs/learn/03-fetching-data.mdx +227 -0
  1021. package/docs/learn/04-access-control.mdx +115 -0
  1022. package/docs/learn/05-the-flush-point.mdx +175 -0
  1023. package/docs/learn/06-typed-params.mdx +275 -0
  1024. package/docs/learn/07-typed-routes.mdx +173 -0
  1025. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1026. package/docs/learn/09-streaming.mdx +146 -0
  1027. package/docs/learn/10-caching.mdx +303 -0
  1028. package/docs/learn/11-middleware.mdx +166 -0
  1029. package/docs/learn/12-error-handling.mdx +192 -0
  1030. package/docs/learn/13-deploying.mdx +289 -0
  1031. package/llms.txt +55 -0
  1032. package/package.json +124 -29
  1033. package/src/adapters/build-output-helper.ts +375 -0
  1034. package/src/adapters/canonicalize-module.ts +29 -0
  1035. package/src/adapters/cloudflare-dev.ts +183 -0
  1036. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1037. package/src/adapters/cloudflare.ts +799 -151
  1038. package/src/adapters/compress-module.ts +110 -86
  1039. package/src/adapters/fs-identity.ts +155 -0
  1040. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1041. package/src/adapters/nitro-presets.ts +139 -0
  1042. package/src/adapters/nitro-preview.ts +565 -0
  1043. package/src/adapters/nitro.ts +349 -448
  1044. package/src/adapters/raw-imports.d.ts +5 -0
  1045. package/src/adapters/shared.ts +314 -0
  1046. package/src/adapters/types.ts +129 -17
  1047. package/src/adapters/wrangler.d.ts +7 -0
  1048. package/src/analyze/chains.ts +411 -0
  1049. package/src/analyze/classify.ts +259 -0
  1050. package/src/analyze/crawl-entry.ts +68 -0
  1051. package/src/analyze/crawl.ts +500 -0
  1052. package/src/analyze/graph-cache.ts +331 -0
  1053. package/src/analyze/graph-command.ts +654 -0
  1054. package/src/analyze/live-graph.ts +232 -0
  1055. package/src/analyze/poison-rules.ts +165 -0
  1056. package/src/analyze/poison-scan.ts +159 -0
  1057. package/src/analyze/scan.ts +149 -0
  1058. package/src/cache/cache-api.ts +113 -0
  1059. package/src/cache/fast-hash.ts +5 -0
  1060. package/src/cache/guarded-read.ts +44 -0
  1061. package/src/cache/handler-store.ts +113 -0
  1062. package/src/cache/index.ts +93 -20
  1063. package/src/cache/invalidation-epoch.ts +105 -0
  1064. package/src/cache/json-lossy-check.ts +69 -0
  1065. package/src/cache/key-discipline.ts +218 -0
  1066. package/src/cache/redis-handler.ts +193 -19
  1067. package/src/cache/singleflight.ts +85 -7
  1068. package/src/cache/sizeof.ts +35 -0
  1069. package/src/cache/stable-stringify.ts +118 -2
  1070. package/src/cache/store.ts +71 -0
  1071. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1072. package/src/cache/stores/memory.ts +125 -0
  1073. package/src/cache/stores/redis.ts +97 -0
  1074. package/src/cache/stores/vercel.ts +59 -0
  1075. package/src/cache/tag-aware-handler.ts +250 -0
  1076. package/src/cache/timber-cache.ts +218 -47
  1077. package/src/cdn/cloudflare-purge.ts +50 -0
  1078. package/src/cdn/fastly-purge.ts +63 -0
  1079. package/src/cdn/headers.ts +153 -0
  1080. package/src/cdn/index.ts +23 -0
  1081. package/src/cdn/purge-store.ts +62 -0
  1082. package/src/cdn/workers-cache-purge.ts +34 -0
  1083. package/src/cli-check.ts +417 -0
  1084. package/src/cli-context.ts +128 -0
  1085. package/src/cli-dev-status.ts +196 -0
  1086. package/src/cli-init.ts +278 -0
  1087. package/src/cli-schema-sync.ts +401 -0
  1088. package/src/cli.ts +308 -84
  1089. package/src/client/browser-dev.ts +192 -5
  1090. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1091. package/src/client/browser-entry/action-queue.ts +152 -0
  1092. package/src/client/browser-entry/form-state.ts +49 -0
  1093. package/src/client/browser-entry/hmr.ts +82 -0
  1094. package/src/client/browser-entry/hydrate.ts +152 -0
  1095. package/src/client/browser-entry/index.ts +153 -0
  1096. package/src/client/browser-entry/post-hydration.ts +99 -0
  1097. package/src/client/browser-entry/router-init.ts +391 -0
  1098. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1099. package/src/client/browser-entry/scroll.ts +50 -0
  1100. package/src/client/deny-last-resort.tsx +54 -0
  1101. package/src/client/dev-pill/index.ts +128 -0
  1102. package/src/client/dev-pill/store.ts +254 -0
  1103. package/src/client/dev-pill/view.ts +326 -0
  1104. package/src/client/error-boundary.tsx +296 -61
  1105. package/src/client/error-reconstituter.tsx +84 -0
  1106. package/src/client/form.tsx +61 -173
  1107. package/src/client/global-context.ts +59 -0
  1108. package/src/client/history.ts +74 -11
  1109. package/src/client/index.ts +93 -53
  1110. package/src/client/internal.ts +54 -0
  1111. package/src/client/link.tsx +284 -204
  1112. package/src/client/location-search.ts +15 -0
  1113. package/src/client/navigation-api.ts +254 -0
  1114. package/src/client/navigation-commit.ts +318 -0
  1115. package/src/client/navigation-context.ts +71 -142
  1116. package/src/client/navigation-root.tsx +237 -0
  1117. package/src/client/navigation-transition.ts +401 -0
  1118. package/src/client/nuqs-adapter.tsx +62 -32
  1119. package/src/client/params-context.ts +175 -0
  1120. package/src/client/react-root.ts +105 -0
  1121. package/src/client/router-effects.ts +349 -0
  1122. package/src/client/router-lifecycle.ts +394 -0
  1123. package/src/client/router-pipeline.ts +443 -0
  1124. package/src/client/router-ref.ts +3 -3
  1125. package/src/client/router-skew.ts +30 -0
  1126. package/src/client/router-types.ts +326 -0
  1127. package/src/client/router-url.ts +32 -0
  1128. package/src/client/router.ts +491 -421
  1129. package/src/client/rsc-fetch.ts +510 -109
  1130. package/src/client/segment-cache.ts +362 -41
  1131. package/src/client/segment-context.ts +7 -4
  1132. package/src/client/segment-outlet.tsx +96 -0
  1133. package/src/client/segment-update-context.ts +23 -0
  1134. package/src/client/shallow-url.ts +22 -0
  1135. package/src/client/slot-content-cache-context.ts +43 -0
  1136. package/src/client/slot-context.ts +39 -0
  1137. package/src/client/slot-outlet.tsx +22 -0
  1138. package/src/client/slot-provider.tsx +32 -0
  1139. package/src/client/ssr-data.ts +27 -67
  1140. package/src/client/stale-client.ts +191 -0
  1141. package/src/client/state.ts +31 -24
  1142. package/src/client/status-page-marker.tsx +32 -0
  1143. package/src/client/top-loader.tsx +13 -10
  1144. package/src/client/unload-guard.ts +35 -3
  1145. package/src/client/use-cookie.ts +93 -29
  1146. package/src/client/use-field-state.ts +144 -0
  1147. package/src/client/use-link-status.ts +7 -7
  1148. package/src/client/use-pathname.ts +22 -31
  1149. package/src/client/use-pending-navigation.ts +119 -0
  1150. package/src/client/use-query-states.ts +206 -36
  1151. package/src/client/use-router.ts +31 -9
  1152. package/src/client/use-search-params.ts +38 -49
  1153. package/src/client/use-segment-params.ts +69 -0
  1154. package/src/client/use-selected-layout-segment.ts +2 -2
  1155. package/src/codec.ts +149 -0
  1156. package/src/config-types.ts +366 -0
  1157. package/src/config-validation.ts +511 -0
  1158. package/src/cookies/define-cookie.ts +186 -53
  1159. package/src/cookies/index.ts +13 -2
  1160. package/src/cookies/json-cookie.ts +105 -0
  1161. package/src/cookies/validation.ts +192 -0
  1162. package/src/dev-tools/404-page.ts +286 -0
  1163. package/src/dev-tools/await-span.ts +69 -0
  1164. package/src/dev-tools/browser-logs.ts +55 -0
  1165. package/src/dev-tools/dev-page-shell.ts +278 -0
  1166. package/src/dev-tools/error-page.ts +331 -0
  1167. package/src/dev-tools/holding-server.ts +185 -0
  1168. package/src/dev-tools/hydration-overlay.ts +158 -0
  1169. package/src/dev-tools/index.ts +79 -0
  1170. package/src/dev-tools/instrumentation.ts +281 -0
  1171. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1172. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1173. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1174. package/src/dev-tools/span-sink.ts +132 -0
  1175. package/src/dev-tools/stack-classifier.ts +75 -0
  1176. package/src/dev-tools/terminal.ts +182 -0
  1177. package/src/fonts/ast-walk.ts +235 -0
  1178. package/src/fonts/ast.ts +479 -128
  1179. package/src/fonts/bundle.ts +138 -0
  1180. package/src/fonts/css.ts +1 -1
  1181. package/src/fonts/dev-middleware.ts +85 -0
  1182. package/src/fonts/fallbacks.ts +0 -23
  1183. package/src/fonts/google.ts +101 -19
  1184. package/src/fonts/local.ts +12 -11
  1185. package/src/fonts/paths.ts +58 -0
  1186. package/src/fonts/pipeline.ts +348 -0
  1187. package/src/fonts/transform.ts +311 -0
  1188. package/src/fonts/types.ts +52 -1
  1189. package/src/fonts/virtual-modules.ts +179 -0
  1190. package/src/index.ts +501 -380
  1191. package/src/params/codec-registry.ts +47 -0
  1192. package/src/params/define-schema.ts +115 -0
  1193. package/src/params/index.ts +16 -0
  1194. package/src/params/resolve-schema.ts +84 -0
  1195. package/src/plugin-context.ts +509 -0
  1196. package/src/plugins/build-manifest.ts +189 -36
  1197. package/src/plugins/build-report.ts +299 -87
  1198. package/src/plugins/cache.ts +243 -0
  1199. package/src/plugins/callsite-ast.ts +472 -0
  1200. package/src/plugins/callsite-jsx.ts +243 -0
  1201. package/src/plugins/chunks.ts +74 -5
  1202. package/src/plugins/client-chunks.ts +185 -0
  1203. package/src/plugins/client-dep-entries.ts +124 -0
  1204. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1205. package/src/plugins/cloudflare-wasm.ts +141 -0
  1206. package/src/plugins/content.ts +31 -2
  1207. package/src/plugins/dev-await.ts +415 -0
  1208. package/src/plugins/dev-discovery.ts +428 -0
  1209. package/src/plugins/dev-hostname.ts +322 -0
  1210. package/src/plugins/dev-server.ts +471 -100
  1211. package/src/plugins/dev-store-clear.ts +145 -0
  1212. package/src/plugins/encryption-runtime.ts +31 -0
  1213. package/src/plugins/entries.ts +158 -17
  1214. package/src/plugins/fonts.ts +260 -657
  1215. package/src/plugins/graph-endpoint.ts +544 -0
  1216. package/src/plugins/mdx.ts +108 -35
  1217. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1218. package/src/plugins/optimize-package-imports.ts +439 -0
  1219. package/src/plugins/orphaned-modules.ts +78 -0
  1220. package/src/plugins/post-build.ts +327 -0
  1221. package/src/plugins/prebuilt-capture.ts +213 -0
  1222. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1223. package/src/plugins/prebuilt.ts +679 -0
  1224. package/src/plugins/prerender-sugar.ts +348 -0
  1225. package/src/plugins/react-resolve.ts +149 -0
  1226. package/src/plugins/request-dep/analysis.ts +447 -0
  1227. package/src/plugins/request-dep/index.ts +376 -0
  1228. package/src/plugins/request-dep/origin.ts +310 -0
  1229. package/src/plugins/routing.ts +296 -278
  1230. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1231. package/src/plugins/server-bundle.ts +115 -15
  1232. package/src/plugins/shims.ts +267 -97
  1233. package/src/plugins/static-build.ts +681 -71
  1234. package/src/react-canary.d.ts +2 -0
  1235. package/src/routes/href.ts +171 -0
  1236. package/src/routes/index.ts +10 -0
  1237. package/src/routing/codegen-shared.ts +39 -0
  1238. package/src/routing/codegen-types.ts +62 -0
  1239. package/src/routing/codegen-write.ts +163 -0
  1240. package/src/routing/codegen.ts +356 -232
  1241. package/src/routing/collision-probe.ts +438 -0
  1242. package/src/routing/collision-spaces.ts +281 -0
  1243. package/src/routing/convention-lint.ts +649 -0
  1244. package/src/routing/export-detect.ts +536 -0
  1245. package/src/routing/file-cache.ts +23 -0
  1246. package/src/routing/index.ts +16 -7
  1247. package/src/routing/interception-overlap.ts +141 -0
  1248. package/src/routing/interception.ts +1044 -67
  1249. package/src/routing/link-codegen.ts +346 -0
  1250. package/src/routing/manifest-codegen.ts +232 -0
  1251. package/src/routing/scanner.ts +417 -223
  1252. package/src/routing/schema-validation.ts +155 -0
  1253. package/src/routing/segment-classify.ts +280 -0
  1254. package/src/routing/segment-codegen.ts +99 -0
  1255. package/src/routing/segment-keys.ts +186 -0
  1256. package/src/routing/slot-placement.ts +97 -0
  1257. package/src/routing/types.ts +82 -26
  1258. package/src/routing/walkers.ts +98 -0
  1259. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1260. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1261. package/src/rsc-runtime/render-flight.ts +26 -0
  1262. package/src/rsc-runtime/rsc.ts +35 -5
  1263. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1264. package/src/rsc-runtime/server-references.ts +135 -0
  1265. package/src/rsc-runtime/ssr.ts +23 -0
  1266. package/src/rsc-runtime/transforms.ts +13 -0
  1267. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1268. package/src/schema-bridge.ts +437 -0
  1269. package/src/search-params/define.ts +676 -0
  1270. package/src/search-params/index.ts +14 -20
  1271. package/src/search-params/parse-total.ts +91 -0
  1272. package/src/search-params/serialize-equal.ts +14 -0
  1273. package/src/search-params/wrappers.ts +150 -0
  1274. package/src/server/abort-scope.ts +49 -0
  1275. package/src/server/access-gate.tsx +208 -57
  1276. package/src/server/action-client.ts +175 -294
  1277. package/src/server/action-encryption.ts +144 -0
  1278. package/src/server/action-handler.ts +533 -150
  1279. package/src/server/action-schema.ts +203 -0
  1280. package/src/server/action-types.ts +145 -0
  1281. package/src/server/actions.ts +172 -85
  1282. package/src/server/als-registry.ts +245 -30
  1283. package/src/server/body-limits.ts +10 -2
  1284. package/src/server/build-manifest.ts +33 -57
  1285. package/src/server/canonicalize.ts +62 -3
  1286. package/src/server/chain-url-parts.ts +163 -0
  1287. package/src/server/children-interception.ts +116 -0
  1288. package/src/server/client-error-message.ts +18 -0
  1289. package/src/server/coalesce-tick.ts +75 -0
  1290. package/src/server/compress.ts +91 -19
  1291. package/src/server/cookie-context.ts +462 -0
  1292. package/src/server/cookie-parsing.ts +163 -0
  1293. package/src/server/csp-nonce.ts +58 -0
  1294. package/src/server/csrf.ts +238 -37
  1295. package/src/server/debug.ts +0 -1
  1296. package/src/server/default-logger.ts +100 -0
  1297. package/src/server/default-status-page.ts +88 -0
  1298. package/src/server/deny-boundary.ts +527 -0
  1299. package/src/server/deny-renderer.ts +210 -181
  1300. package/src/server/early-hints-sender.ts +4 -3
  1301. package/src/server/early-hints.ts +39 -29
  1302. package/src/server/error-boundary-wrapper.ts +160 -44
  1303. package/src/server/error-response-headers.ts +18 -0
  1304. package/src/server/fallback-error.ts +88 -104
  1305. package/src/server/flight-injection-state.ts +113 -0
  1306. package/src/server/flight-injector-core.ts +332 -0
  1307. package/src/server/flight-scripts.ts +92 -0
  1308. package/src/server/flight-source-node.ts +434 -0
  1309. package/src/server/flight-source.ts +289 -0
  1310. package/src/server/form-data.ts +191 -20
  1311. package/src/server/form-state-flight.ts +67 -0
  1312. package/src/server/head-response.ts +50 -0
  1313. package/src/server/html-injector-core.ts +320 -0
  1314. package/src/server/html-injectors.ts +241 -285
  1315. package/src/server/index.ts +42 -195
  1316. package/src/server/instrumentation.ts +42 -11
  1317. package/src/server/interception-gates.ts +94 -0
  1318. package/src/server/internal.ts +164 -0
  1319. package/src/server/json-status-response.ts +105 -0
  1320. package/src/server/logger.ts +163 -38
  1321. package/src/server/metadata-collector.ts +175 -0
  1322. package/src/server/metadata-platform.ts +2 -2
  1323. package/src/server/metadata-render.ts +30 -8
  1324. package/src/server/metadata-route-links.ts +200 -0
  1325. package/src/server/metadata-routes.ts +114 -24
  1326. package/src/server/metadata-social.ts +2 -2
  1327. package/src/server/metadata.ts +23 -2
  1328. package/src/server/middleware-runner.ts +32 -5
  1329. package/src/server/node-body-response.ts +236 -0
  1330. package/src/server/node-response.ts +93 -0
  1331. package/src/server/node-stream-transforms.ts +340 -0
  1332. package/src/server/node-streams-platform.ts +23 -0
  1333. package/src/server/param-coercion.ts +205 -0
  1334. package/src/server/pipeline-helpers.ts +554 -0
  1335. package/src/server/pipeline-interception.ts +301 -32
  1336. package/src/server/pipeline-metadata-route.ts +242 -0
  1337. package/src/server/pipeline-metadata.ts +30 -4
  1338. package/src/server/pipeline-outcome.ts +290 -0
  1339. package/src/server/pipeline-phases.ts +443 -0
  1340. package/src/server/pipeline.ts +474 -427
  1341. package/src/server/port-resolution.ts +43 -0
  1342. package/src/server/prebuilt/cache-key.ts +340 -0
  1343. package/src/server/prebuilt/capture-render.ts +122 -0
  1344. package/src/server/prebuilt/capture-routes.ts +104 -0
  1345. package/src/server/prebuilt/capture-state.ts +196 -0
  1346. package/src/server/prebuilt/dev-store.ts +252 -0
  1347. package/src/server/prebuilt/lifetime.ts +151 -0
  1348. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1349. package/src/server/prebuilt/overlay.ts +290 -0
  1350. package/src/server/prebuilt/payload-source.ts +221 -0
  1351. package/src/server/prebuilt/slots.ts +201 -0
  1352. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1353. package/src/server/prebuilt-builder.ts +515 -0
  1354. package/src/server/prebuilt-runtime.ts +830 -0
  1355. package/src/server/primitives.ts +167 -171
  1356. package/src/server/publish-params.ts +42 -0
  1357. package/src/server/react-cache-bridge.ts +124 -0
  1358. package/src/server/react-cache-scope.ts +104 -0
  1359. package/src/server/render-timeout.ts +123 -0
  1360. package/src/server/render-utils.ts +70 -0
  1361. package/src/server/request-context.ts +321 -323
  1362. package/src/server/request-dep.ts +37 -0
  1363. package/src/server/response-cache-policy.ts +45 -0
  1364. package/src/server/response-framing.ts +59 -0
  1365. package/src/server/route-element-builder.ts +539 -355
  1366. package/src/server/route-element-helpers.ts +37 -0
  1367. package/src/server/route-handler.ts +78 -48
  1368. package/src/server/route-matcher.ts +251 -265
  1369. package/src/server/route-methods.ts +37 -0
  1370. package/src/server/route-module-loader.ts +161 -0
  1371. package/src/server/rsc-cache-key-guard.ts +122 -0
  1372. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1373. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1374. package/src/server/rsc-entry/api-handler.ts +30 -93
  1375. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1376. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1377. package/src/server/rsc-entry/helpers.ts +90 -115
  1378. package/src/server/rsc-entry/index.ts +420 -350
  1379. package/src/server/rsc-entry/render-route.ts +248 -0
  1380. package/src/server/rsc-entry/render-signals.ts +108 -0
  1381. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1382. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1383. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1384. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1385. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1386. package/src/server/rsc-error-envelope.ts +18 -0
  1387. package/src/server/rsc-prop-warnings.ts +1 -1
  1388. package/src/server/safe-load.ts +53 -0
  1389. package/src/server/schema-introspection.ts +393 -0
  1390. package/src/server/sensitive-fields.ts +287 -0
  1391. package/src/server/server-only-guard-noop.js +3 -0
  1392. package/src/server/server-timing.ts +1 -1
  1393. package/src/server/signal-identity.ts +130 -0
  1394. package/src/server/sitemap-generator.ts +337 -0
  1395. package/src/server/sitemap-handler.ts +150 -0
  1396. package/src/server/skippable-prefix.ts +172 -0
  1397. package/src/server/slot-interception.ts +168 -0
  1398. package/src/server/slot-resolver.ts +747 -300
  1399. package/src/server/slot-subtree-contain.ts +273 -0
  1400. package/src/server/ssr-bridge-types.ts +217 -0
  1401. package/src/server/ssr-entry.ts +246 -109
  1402. package/src/server/ssr-form-state.ts +58 -0
  1403. package/src/server/ssr-render.ts +253 -113
  1404. package/src/server/ssr-wrappers.tsx +152 -0
  1405. package/src/server/state-tree-diff.ts +85 -30
  1406. package/src/server/static-generator.ts +680 -0
  1407. package/src/server/static-not-found.ts +134 -0
  1408. package/src/server/status-code-resolver.ts +107 -148
  1409. package/src/server/stream-utils.ts +398 -0
  1410. package/src/server/traced-access.ts +50 -0
  1411. package/src/server/tracing.ts +274 -128
  1412. package/src/server/tree-match.ts +494 -0
  1413. package/src/server/types.ts +97 -11
  1414. package/src/server/utils/element-type.ts +88 -0
  1415. package/src/server/utils/escape-html.ts +20 -0
  1416. package/src/server/version-skew.ts +104 -0
  1417. package/src/server/waituntil-bridge.ts +1 -1
  1418. package/src/server/workers-cache-bridge.ts +33 -0
  1419. package/src/shared/als-slots.ts +74 -0
  1420. package/src/shared/base-path.ts +80 -0
  1421. package/src/shared/csrf-reject.ts +15 -0
  1422. package/src/shared/dev-span.ts +188 -0
  1423. package/src/shared/error-digest.ts +46 -0
  1424. package/src/shared/flight-base64.ts +23 -0
  1425. package/src/shared/flight-segment.ts +35 -0
  1426. package/src/shared/form-state-flight.ts +59 -0
  1427. package/src/shared/href-validation.ts +159 -0
  1428. package/src/shared/href.ts +257 -0
  1429. package/src/shared/merge-search-params.ts +55 -0
  1430. package/src/shared/param-value.ts +281 -0
  1431. package/src/shared/payload-root.ts +153 -0
  1432. package/src/shared/redirect-type.ts +17 -0
  1433. package/src/shared/rsc-cache-key.ts +269 -0
  1434. package/src/shared/rsc-error-envelope.ts +16 -0
  1435. package/src/shared/rsc-manifest.ts +29 -0
  1436. package/src/shared/rsc-media-type.ts +59 -0
  1437. package/src/shared/rsc-payload-path.ts +52 -0
  1438. package/src/shared/segment-info.ts +67 -0
  1439. package/src/shared/slot-params.ts +109 -0
  1440. package/src/shared/static-platform-files.ts +75 -0
  1441. package/src/shared/status-reason-phrase.ts +61 -0
  1442. package/src/shims/font-google.ts +1 -1
  1443. package/src/shims/font-local.ts +34 -0
  1444. package/src/shims/headers.ts +130 -1
  1445. package/src/shims/navigation-client.ts +36 -32
  1446. package/src/shims/navigation-rsc.ts +47 -0
  1447. package/src/shims/navigation.ts +10 -7
  1448. package/src/utils/state-machine.ts +111 -0
  1449. package/src/utils/write-file-atomic.ts +32 -0
  1450. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1451. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1452. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1453. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1454. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1455. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1456. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1457. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1458. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1459. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1460. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1461. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1462. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1463. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1464. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1465. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1466. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1467. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1468. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1469. package/dist/adapters/cloudflare.js.map +0 -1
  1470. package/dist/cache/index.js.map +0 -1
  1471. package/dist/cache/register-cached-function.d.ts +0 -17
  1472. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1473. package/dist/client/browser-entry.d.ts +0 -21
  1474. package/dist/client/browser-entry.d.ts.map +0 -1
  1475. package/dist/client/error-boundary.js.map +0 -1
  1476. package/dist/client/head.d.ts +0 -16
  1477. package/dist/client/head.d.ts.map +0 -1
  1478. package/dist/client/link-status-provider.d.ts +0 -11
  1479. package/dist/client/link-status-provider.d.ts.map +0 -1
  1480. package/dist/client/segment-merger.d.ts +0 -119
  1481. package/dist/client/segment-merger.d.ts.map +0 -1
  1482. package/dist/client/stale-reload.d.ts +0 -44
  1483. package/dist/client/stale-reload.d.ts.map +0 -1
  1484. package/dist/client/transition-root.d.ts +0 -74
  1485. package/dist/client/transition-root.d.ts.map +0 -1
  1486. package/dist/client/types.d.ts +0 -14
  1487. package/dist/client/types.d.ts.map +0 -1
  1488. package/dist/client/use-navigation-pending.d.ts +0 -26
  1489. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1490. package/dist/client/use-params.d.ts +0 -92
  1491. package/dist/client/use-params.d.ts.map +0 -1
  1492. package/dist/content/index.d.ts +0 -11
  1493. package/dist/content/index.d.ts.map +0 -1
  1494. package/dist/content/index.js +0 -2
  1495. package/dist/plugins/adapter-build.d.ts +0 -18
  1496. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1497. package/dist/plugins/cache-transform.d.ts +0 -36
  1498. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1499. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1500. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1501. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1502. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1503. package/dist/plugins/server-action-exports.d.ts +0 -26
  1504. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1505. package/dist/routing/status-file-lint.d.ts +0 -33
  1506. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1507. package/dist/search-params/analyze.d.ts +0 -54
  1508. package/dist/search-params/analyze.d.ts.map +0 -1
  1509. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1510. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1511. package/dist/search-params/codecs.d.ts +0 -53
  1512. package/dist/search-params/codecs.d.ts.map +0 -1
  1513. package/dist/search-params/create.d.ts +0 -106
  1514. package/dist/search-params/create.d.ts.map +0 -1
  1515. package/dist/search-params/registry.d.ts +0 -20
  1516. package/dist/search-params/registry.d.ts.map +0 -1
  1517. package/dist/server/asset-headers.d.ts +0 -42
  1518. package/dist/server/asset-headers.d.ts.map +0 -1
  1519. package/dist/server/client-module-map.d.ts +0 -47
  1520. package/dist/server/client-module-map.d.ts.map +0 -1
  1521. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1522. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1523. package/dist/server/dev-logger.d.ts.map +0 -1
  1524. package/dist/server/dev-span-processor.d.ts +0 -29
  1525. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1526. package/dist/server/dev-warnings.d.ts +0 -129
  1527. package/dist/server/dev-warnings.d.ts.map +0 -1
  1528. package/dist/server/flush.d.ts +0 -74
  1529. package/dist/server/flush.d.ts.map +0 -1
  1530. package/dist/server/form-flash.d.ts +0 -78
  1531. package/dist/server/form-flash.d.ts.map +0 -1
  1532. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1533. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1534. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1535. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1536. package/dist/server/prerender.d.ts +0 -77
  1537. package/dist/server/prerender.d.ts.map +0 -1
  1538. package/dist/server/tree-builder.d.ts +0 -126
  1539. package/dist/server/tree-builder.d.ts.map +0 -1
  1540. package/dist/utils/directive-parser.d.ts +0 -70
  1541. package/dist/utils/directive-parser.d.ts.map +0 -1
  1542. package/src/cache/register-cached-function.ts +0 -103
  1543. package/src/client/browser-entry.ts +0 -678
  1544. package/src/client/head.ts +0 -61
  1545. package/src/client/link-status-provider.tsx +0 -30
  1546. package/src/client/segment-merger.ts +0 -339
  1547. package/src/client/stale-reload.ts +0 -87
  1548. package/src/client/transition-root.tsx +0 -166
  1549. package/src/client/types.ts +0 -21
  1550. package/src/client/use-navigation-pending.ts +0 -38
  1551. package/src/client/use-params.ts +0 -141
  1552. package/src/content/index.ts +0 -13
  1553. package/src/plugins/adapter-build.ts +0 -118
  1554. package/src/plugins/cache-transform.ts +0 -199
  1555. package/src/plugins/dynamic-transform.ts +0 -161
  1556. package/src/plugins/server-action-exports.ts +0 -220
  1557. package/src/routing/status-file-lint.ts +0 -112
  1558. package/src/search-params/analyze.ts +0 -192
  1559. package/src/search-params/builtin-codecs.ts +0 -228
  1560. package/src/search-params/codecs.ts +0 -153
  1561. package/src/search-params/create.ts +0 -321
  1562. package/src/search-params/registry.ts +0 -31
  1563. package/src/server/asset-headers.ts +0 -81
  1564. package/src/server/client-module-map.ts +0 -58
  1565. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1566. package/src/server/dev-span-processor.ts +0 -78
  1567. package/src/server/dev-warnings.ts +0 -283
  1568. package/src/server/flush.ts +0 -182
  1569. package/src/server/form-flash.ts +0 -89
  1570. package/src/server/manifest-status-resolver.ts +0 -215
  1571. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1572. package/src/server/prerender.ts +0 -139
  1573. package/src/server/tree-builder.ts +0 -382
  1574. package/src/shims/server-only-noop.js +0 -6
  1575. package/src/utils/directive-parser.ts +0 -529
@@ -1,116 +1,206 @@
1
- import { join, relative } from "node:path";
2
- import { cp, mkdir, readFile, writeFile } from "node:fs/promises";
1
+ import { t as RSC_CONTENT_TYPE } from "../_chunks/rsc-media-type-m8jz9u6_.js";
2
+ import { a as REDIRECTS_FILE, i as HEADERS_FILE } from "../_chunks/fs-identity-BmQ_Agg-.js";
3
+ import { a as RUNTIME_INIT_MODULE, c as generateRuntimeInitModule, i as IMMUTABLE_CACHE, n as runSharedBuildSteps, o as STATIC_CACHE, r as writeHeadersFile, s as adapterBase, t as buildStaticDirectoryOutput } from "../_chunks/build-output-helper-5UsltK-S.js";
4
+ import { transformWithOxc } from "vite";
5
+ import { basename, dirname, join, relative, sep } from "node:path";
6
+ import { existsSync } from "node:fs";
7
+ import { cp, glob, readFile, rm, writeFile } from "node:fs/promises";
3
8
  import { execFile } from "node:child_process";
4
- //#region src/adapters/compress-module.ts
9
+ // src/server/compress.ts?raw
10
+ var compress_default = "// Response compression for self-hosted deployments (dev server, Nitro preview).\n//\n// Gzips with node:zlib, flushing per chunk; a Node body stays a Node stream. Brotli is intentionally\n// left to CDNs and reverse proxies — at streaming-friendly quality levels its\n// ratio advantage is marginal, and node:zlib's brotli transform buffers output\n// internally, breaking streaming. Cloudflare Workers auto-compress at the edge —\n// this module is only used on Node.js/Bun.\n//\n// See design/25-production-deployments.md.\n//\n// This module is also emitted standalone as `_compress.mjs` by\n// `adapters/compress-module.ts`, which strips types but does not bundle. Its\n// imports must therefore be interpolated there — a new import that is not\n// fails the build with an explanatory error rather than resolving to nothing\n// on the deployed server.\n\nimport { RSC_CONTENT_TYPE } from '../shared/rsc-media-type.ts';\n\n// ─── Constants ────────────────────────────────────────────────────────────\n\n/**\n * MIME types that benefit from compression.\n * text/* is handled via prefix matching; these are the specific\n * application/* and image/* types that are compressible.\n */\nexport const COMPRESSIBLE_TYPES = new Set([\n 'text/html',\n 'text/css',\n 'text/plain',\n 'text/xml',\n 'text/javascript',\n RSC_CONTENT_TYPE,\n 'application/json',\n 'application/javascript',\n 'application/xml',\n 'application/xhtml+xml',\n 'application/rss+xml',\n 'application/atom+xml',\n 'image/svg+xml',\n]);\n\n/**\n * Status codes that should never be compressed (no body or special semantics).\n */\nconst NO_COMPRESS_STATUSES = new Set([204, 304]);\n\n// ─── Encoding Negotiation ─────────────────────────────────────────────────\n\n/**\n * Parse Accept-Encoding and return the best supported encoding.\n * Returns 'gzip' if the client accepts it, null otherwise.\n *\n * Brotli (br) is intentionally not handled at the application level.\n * At the streaming-friendly quality levels (0–4), brotli's compression\n * ratio advantage over gzip is marginal, and node:zlib's brotli transform\n * buffers output internally — turning smooth streaming responses into\n * large infrequent bursts. Brotli's real wins come from offline/static\n * compression at higher quality levels (5–11), which CDNs and reverse\n * proxies (Cloudflare, nginx, Caddy) apply on cached responses.\n *\n * See design/25-production-deployments.md.\n */\nexport function negotiateEncoding(acceptEncoding: string): 'gzip' | null {\n if (!acceptEncoding) return null;\n\n // Parse tokens with quality values from the Accept-Encoding header.\n // Per RFC 9110 §12.5.3, q=0 means \"not acceptable\" — the client explicitly\n // rejects that encoding. Tokens without a q-value default to q=1.\n // e.g. \"gzip;q=1.0, br;q=0\" → gzip is acceptable, br is rejected.\n const parts = acceptEncoding.split(',');\n for (const part of parts) {\n const [token, ...params] = part.split(';');\n const name = token.trim().toLowerCase();\n if (name !== 'gzip') continue;\n\n // Check for q=0 (explicitly disabled)\n let qValue = 1; // default quality is 1\n for (const param of params) {\n const trimmed = param.trim().toLowerCase();\n if (trimmed.startsWith('q=')) {\n qValue = parseFloat(trimmed.slice(2));\n if (Number.isNaN(qValue)) qValue = 1;\n break;\n }\n }\n\n if (qValue > 0) return 'gzip';\n }\n\n return null;\n}\n\n// ─── Compressibility Check ────────────────────────────────────────────────\n\n/**\n * Determine if a response should be compressed.\n *\n * Returns false for:\n * - Responses without a body (204, 304, null body)\n * - Already-encoded responses (Content-Encoding set)\n * - Non-compressible content types (images, binary)\n * - SSE streams (text/event-stream — must not be buffered)\n */\nexport function shouldCompress(response: Response): boolean {\n // No body to compress. A Node-body response is asked whether it owns one\n // (a null-body status does not) without reading `.body`, which would\n // convert it to a Web stream.\n const nodeBody = nodeBodyThrough(response);\n if (nodeBody ? !nodeBody.hasBody : !response.body) return false;\n if (NO_COMPRESS_STATUSES.has(response.status)) return false;\n\n // Already compressed\n if (response.headers.has('Content-Encoding')) return false;\n\n // Check content type\n const contentType = response.headers.get('Content-Type');\n if (!contentType) return false;\n\n // Extract the MIME type (strip charset and other parameters)\n const mimeType = contentType.split(';')[0].trim().toLowerCase();\n\n // SSE must not be compressed — it relies on chunk-by-chunk delivery\n if (mimeType === 'text/event-stream') return false;\n\n return COMPRESSIBLE_TYPES.has(mimeType);\n}\n\n// ─── Compression ──────────────────────────────────────────────────────────\n\n/**\n * Compress a Web Response if the client supports it and the content is compressible.\n *\n * Returns the original response unchanged if compression is not applicable.\n * Returns a new Response with the compressed body, Content-Encoding, and Vary headers.\n *\n * The body is piped through a compression stream — no buffering of the full response.\n * This preserves streaming behavior for HTML shell + deferred Suspense chunks.\n */\nexport function compressResponse(request: Request, response: Response): Response {\n // Check if response is compressible\n if (!shouldCompress(response)) return response;\n\n // Negotiate encoding with the client\n const acceptEncoding = request.headers.get('Accept-Encoding') ?? '';\n const encoding = negotiateEncoding(acceptEncoding);\n if (!encoding) return response;\n\n // Build new headers: copy originals, add compression headers, remove Content-Length\n // (compressed size is unknown until streaming completes).\n const headers = new Headers(response.headers);\n headers.set('Content-Encoding', encoding);\n headers.delete('Content-Length');\n\n // Append to Vary header (preserve existing Vary values)\n const existingVary = headers.get('Vary');\n if (existingVary) {\n if (!existingVary.toLowerCase().includes('accept-encoding')) {\n headers.set('Vary', `${existingVary}, Accept-Encoding`);\n }\n } else {\n headers.set('Vary', 'Accept-Encoding');\n }\n\n const init = { status: response.status, statusText: response.statusText, headers };\n // A Node body is gzipped as a Node stream and stays one to the socket.\n const nodeBody = nodeBodyThrough(response);\n if (nodeBody) return nodeBody.through(createSyncFlushGzip(), init);\n return new Response(compressWithGzip(response.body!), init);\n}\n\n// ─── Node bodies ──────────────────────────────────────────────────────────\n//\n// A response with a Node body (SSR and Flight payloads on Node) carries its\n// operations under a registry symbol (server/node-response.ts). This module is\n// emitted standalone and cannot import that one, so it repeats the key;\n// tests/node-body-response.test.ts holds the two to the same string.\n\n/** Registry key of the Node-body brand; must equal `NODE_BODY` in node-response.ts. */\nexport const NODE_BODY_KEY = 'timber.response.nodeBody';\n\n/** The Node-body operations compression needs. */\ninterface NodeBodyThrough {\n readonly hasBody: boolean;\n through(stream: import('node:stream').Duplex, init: ResponseInit): Response;\n}\n\nfunction isNodeBodyThrough(value: unknown): value is NodeBodyThrough {\n return (\n typeof value === 'object' &&\n value !== null &&\n 'through' in value &&\n typeof value.through === 'function' &&\n 'hasBody' in value &&\n typeof value.hasBody === 'boolean'\n );\n}\n\nfunction nodeBodyThrough(response: Response): NodeBodyThrough | null {\n const ops: unknown = Reflect.get(response, Symbol.for(NODE_BODY_KEY));\n return isNodeBodyThrough(ops) ? ops : null;\n}\n\n// ─── Gzip (node:zlib with Z_SYNC_FLUSH) ──────────────────────────────────\n//\n// Uses node:zlib's createGzip with Z_SYNC_FLUSH so each chunk is flushed\n// to the output immediately. The Web Platform CompressionStream API buffers\n// internally and does NOT flush per-chunk — this kills streaming because\n// the browser doesn't receive the HTML shell until the gzip stream closes\n// (i.e. after all Suspense boundaries resolve).\n//\n// Z_SYNC_FLUSH adds ~2–5% size overhead vs Z_NO_FLUSH but preserves\n// correct streaming behavior: the shell renders instantly, Suspense\n// fallbacks are visible immediately, and streamed content appears\n// progressively.\n\nimport { createGzip, constants } from 'node:zlib';\nimport { Readable, pipeline } from 'node:stream';\n\n/** gzip that flushes every chunk as it arrives. */\nfunction createSyncFlushGzip(): ReturnType<typeof createGzip> {\n return createGzip({ flush: constants.Z_SYNC_FLUSH });\n}\n\n/**\n * Compress a ReadableStream with gzip, flushing each chunk immediately.\n *\n * Uses node:zlib's createGzip with Z_SYNC_FLUSH to ensure each HTML chunk\n * (shell, Suspense resolution, RSC payload) is delivered to the browser\n * as soon as it's available — preserving streaming semantics.\n */\nfunction compressWithGzip(body: ReadableStream<Uint8Array>): ReadableStream<Uint8Array> {\n const gzip = createSyncFlushGzip();\n const nodeInput = Readable.fromWeb(body as import('stream/web').ReadableStream);\n\n // pipeline() instead of bare pipe(): pipe() does not forward source errors,\n // so an erroring body (streaming route handler, dropped upstream fetch)\n // would emit an unhandled 'error' event and crash the process. pipeline()\n // destroys gzip on source error — the returned web stream rejects — and\n // tears down nodeInput when the consumer cancels the web stream, which\n // cancels the source body via fromWeb. The error reaches the consumer\n // through the web stream; the callback only marks it handled at the Node\n // layer.\n pipeline(nodeInput, gzip, () => {});\n\n return Readable.toWeb(gzip) as ReadableStream<Uint8Array>;\n}\n";
11
+ // src/adapters/compress-module.ts
5
12
  /**
6
- * Generate a standalone ESM module that exports compressResponse().
13
+ * The one import `server/compress.ts` is allowed to carry, and its inlined
14
+ * form.
7
15
  *
8
- * Written to `_compress.mjs` during buildOutput. Imported by the Nitro entry
9
- * and preview server.
16
+ * The binding list is matched exactly rather than as `{…}`. A second binding
17
+ * added to that import would otherwise be erased along with the statement and
18
+ * become a `ReferenceError` in the deployed `_compress.mjs` — the failure this
19
+ * whole module exists to make impossible. Matching exactly means such an
20
+ * import falls through to the rejection below instead.
21
+ */
22
+ var INLINED_IMPORTS = [{
23
+ pattern: /^import\s*\{\s*RSC_CONTENT_TYPE\s*,?\s*\}\s*from\s*["'][^"']*shared\/rsc-media-type\.(?:js|ts)["'];?[ \t]*$/m,
24
+ replacement: `const RSC_CONTENT_TYPE = ${JSON.stringify(RSC_CONTENT_TYPE)};`
25
+ }];
26
+ /**
27
+ * Every way a module specifier can reach the emitted file, minus Node
28
+ * builtins.
29
+ *
30
+ * `node:*` is exempt because it resolves on the deployed server exactly as it
31
+ * does here — `_compress.mjs` already imports `node:zlib` and `node:stream`,
32
+ * and self-hosted (Node/Bun) is the only place this file runs. Everything
33
+ * else — relative paths, bare packages — has no resolution target next to a
34
+ * lone `.mjs` in the build output.
35
+ *
36
+ * All three forms are listed rather than the one `server/compress.ts` happens
37
+ * to use, because a re-export or a lazy `await import()` fails in exactly the
38
+ * same place and is exactly as invisible until deploy.
39
+ */
40
+ var MODULE_SPECIFIERS = [
41
+ /^[ \t]*(?:import|export)\b[^\n]*\bfrom\s*["'](?!node:)[^"']+["']/m,
42
+ /^[ \t]*import\s*["'](?!node:)[^"']+["']/m,
43
+ /\bimport\s*\(\s*["'](?!node:)[^"']+["']/
44
+ ];
45
+ /**
46
+ * Replace the shared-module imports with their values and reject anything
47
+ * else that would leave a dangling specifier in `_compress.mjs`.
48
+ *
49
+ * Exported separately from `generateCompressModule` so both branches can be
50
+ * driven with fixtures: the source it normally compiles is fixed, so a test
51
+ * of the generator alone can only ever exercise whichever branch that source
52
+ * happens to take today.
10
53
  *
11
54
  * @internal Exported for testing.
12
55
  */
13
- function generateCompressModule() {
14
- return `// Generated by @timber-js/app — response compression for self-hosted deployments.
15
- // Do not edit — this file is regenerated on each build.
16
- // Uses CompressionStream (Web API) for gzip. Brotli is left to CDNs/reverse
17
- // proxies — at streaming quality levels its ratio advantage is marginal and
18
- // node:zlib buffers output internally, breaking streaming.
19
-
20
- const COMPRESSIBLE_TYPES = new Set([
21
- 'text/html', 'text/css', 'text/plain', 'text/xml', 'text/javascript',
22
- 'text/x-component', 'application/json', 'application/javascript',
23
- 'application/xml', 'application/xhtml+xml', 'application/rss+xml',
24
- 'application/atom+xml', 'image/svg+xml',
25
- ]);
26
-
27
- const NO_COMPRESS_STATUSES = new Set([204, 304]);
28
-
29
- function negotiateEncoding(acceptEncoding) {
30
- if (!acceptEncoding) return null;
31
- // Parse tokens with quality values. Per RFC 9110 §12.5.3, q=0 means
32
- // "not acceptable" — the client explicitly rejects that encoding.
33
- // Brotli (br) is intentionally not handled at the application level.
34
- const parts = acceptEncoding.split(',');
35
- for (const part of parts) {
36
- const [token, ...params] = part.split(';');
37
- const name = token.trim().toLowerCase();
38
- if (name !== 'gzip') continue;
39
- let qValue = 1;
40
- for (const param of params) {
41
- const trimmed = param.trim().toLowerCase();
42
- if (trimmed.startsWith('q=')) {
43
- qValue = parseFloat(trimmed.slice(2));
44
- if (Number.isNaN(qValue)) qValue = 1;
45
- break;
46
- }
47
- }
48
- if (qValue > 0) return 'gzip';
56
+ function inlineCompressImports(code) {
57
+ let out = code;
58
+ for (const { pattern, replacement } of INLINED_IMPORTS) out = out.replace(pattern, replacement);
59
+ assertStandalone(out, "server/compress.ts", "_compress.mjs");
60
+ return out;
61
+ }
62
+ /**
63
+ * Throw if type-stripped server source still imports anything but a Node
64
+ * builtin. Such a module is emitted alone into the build output, where no
65
+ * specifier has anything to resolve to.
66
+ *
67
+ * @internal Shared by the standalone-module generators.
68
+ */
69
+ function assertStandalone(code, source, emitted) {
70
+ const surviving = MODULE_SPECIFIERS.map((pattern) => pattern.exec(code)).find(Boolean);
71
+ if (surviving) throw new Error(`[timber] ${source} is emitted as a standalone ${emitted} (type-stripped, not bundled), so it cannot import anything at runtime. Found: ${surviving[0].trim()}\n Either inline the value in the generator in adapters/ or keep the dependency out of ${source}.`);
72
+ }
73
+ /**
74
+ * Compile server/compress.ts into a standalone ESM module.
75
+ *
76
+ * Uses Vite's OXC transform to strip TypeScript types from the
77
+ * embedded source. The result is written to `_compress.mjs` during
78
+ * buildOutput.
79
+ *
80
+ * @internal Exported for testing.
81
+ */
82
+ async function generateCompressModule() {
83
+ return "// Generated by @timber-js/app — compiled from server/compress.ts.\n// Do not edit — this file is regenerated on each build.\n" + inlineCompressImports((await transformWithOxc(compress_default, "compress.ts", { lang: "ts" })).code);
84
+ }
85
+ // src/server/canonicalize.ts?raw
86
+ var canonicalize_default = "/**\n * URL canonicalization — runs once at the request boundary.\n *\n * Every layer (proxy.ts, middleware.ts, access.ts, components) sees the same\n * canonical path. No re-decoding occurs at any later stage.\n *\n * See design/07-routing.md §\"URL Canonicalization & Security\"\n */\n\n/** Result of canonicalization — either a clean path or a rejection. */\nexport type CanonicalizeResult = { ok: true; pathname: string } | { ok: false; status: 400 };\n\n/**\n * Encoded separators that produce a 400 rejection.\n * %2f (/) and %5c (\\) cause path-confusion attacks.\n *\n * Shared between the runtime canonicalizer and the build-time route scanner\n * to ensure both enforce identical security rules. See design/13-security.md.\n */\nexport const ENCODED_SEPARATOR_RE = /%2f|%5c/i;\n\n/** Null byte — rejected. Shared with the route scanner. */\nexport const NULL_BYTE_RE = /%00/i;\n\n/**\n * Canonicalize a URL pathname.\n *\n * 1. Reject encoded separators (%2f, %5c) and null bytes (%00)\n * 2. Single percent-decode\n * 3. Collapse // → /\n * 4. Resolve .. segments (reject if escaping root)\n * 5. Strip trailing slash (except root \"/\")\n *\n * @param rawPathname - The raw pathname from the request URL (percent-encoded)\n * @param stripTrailingSlash - Whether to strip trailing slashes. Default: true.\n */\nexport function canonicalize(rawPathname: string, stripTrailingSlash = true): CanonicalizeResult {\n // Step 1: Reject dangerous encoded sequences BEFORE decoding.\n // This must happen on the raw input so %252f doesn't bypass after a single decode.\n if (ENCODED_SEPARATOR_RE.test(rawPathname)) {\n return { ok: false, status: 400 };\n }\n if (NULL_BYTE_RE.test(rawPathname)) {\n return { ok: false, status: 400 };\n }\n\n // Step 2: Single percent-decode.\n // Double-encoded input (%2561 → %61) stays as %61 — not decoded again.\n let decoded: string;\n try {\n decoded = decodeURIComponent(rawPathname);\n } catch {\n // Malformed percent-encoding → 400\n return { ok: false, status: 400 };\n }\n\n // Reject null bytes that appeared after decoding (from valid %00-like sequences\n // that weren't caught above — belt and suspenders).\n if (decoded.includes('\\0')) {\n return { ok: false, status: 400 };\n }\n\n // Backslash is NOT a path separator — keep as literal character.\n // But reject if it would create // after normalization (e.g., /\\evil.com).\n // We do NOT convert \\ to / — it stays as a literal.\n\n // Step 3: Collapse consecutive slashes.\n let pathname = decoded.replace(/\\/\\/+/g, '/');\n\n // Step 4: Resolve .. and . segments.\n const segments = pathname.split('/');\n const resolved: string[] = [];\n for (const seg of segments) {\n if (seg === '..') {\n if (resolved.length <= 1) {\n // Trying to escape root — 400\n return { ok: false, status: 400 };\n }\n resolved.pop();\n } else if (seg !== '.') {\n resolved.push(seg);\n }\n }\n\n pathname = resolved.join('/') || '/';\n\n // Step 5: Strip trailing slash (except root \"/\").\n if (stripTrailingSlash && pathname.length > 1 && pathname.endsWith('/')) {\n pathname = pathname.slice(0, -1);\n }\n\n return { ok: true, pathname };\n}\n\n/**\n * The path a safe request for `rawPathname` should be redirected to — or\n * `rawPathname` itself when it is already canonical.\n *\n * Applies the structural steps of `canonicalize()` — collapse `//` (step 3)\n * and strip the trailing slash (step 5) — to the **encoded** path, without\n * decoding. That is what the browser will send back, so the redirect is\n * idempotent: `/%61dmin` differs from its canonical form `/admin` only by\n * percent-encoding, and redirecting it to `/admin` would compare against the\n * decoded form forever. Decoding cannot introduce a `/` (`%2f` is rejected),\n * so the structure is the same before and after decoding.\n *\n * Dot segments are not handled here: the request URL is parsed by the WHATWG\n * URL parser, which has already resolved `.`, `..` and their encoded forms.\n *\n * Only meaningful for a path `canonicalize()` accepted. The collapse also\n * means the result can never start with `//`, so it is never a\n * protocol-relative redirect target.\n *\n * See design/07-routing.md §\"Non-Canonical URLs Redirect\"\n */\nexport function canonicalRequestPath(rawPathname: string, stripTrailingSlash = true): string {\n let pathname = rawPathname.replace(/\\/\\/+/g, '/');\n if (stripTrailingSlash && pathname.length > 1 && pathname.endsWith('/')) {\n pathname = pathname.slice(0, -1);\n }\n return pathname;\n}\n\n/**\n * Build a request's URL from its origin and its raw request target, or\n * return null when the result is not a URL (the caller answers 400).\n *\n * An origin-form target (`/path`) is concatenated, not resolved against the\n * origin: resolved as a relative reference, `//evil.com/` names another host,\n * and the pipeline would see `/` instead of the path it must redirect to\n * `/evil.com` (TIM-1571). Any other form is resolved against the origin:\n * the asterisk-form `OPTIONS *` becomes `/*`, and an absolute-form target\n * (`GET http://host/a`) keeps only its path and query. Its scheme and\n * authority are the client's word, not the connection's: they would stand in\n * for the Host that the dev server's allowedHosts check and CSRF read, and a\n * non-http scheme (`foo://x/`) makes an opaque origin the pipeline cannot\n * build URLs from, so that is null too.\n *\n * Shared by the dev server and the Nitro preview server (which ships this\n * file as `_canonicalize.mjs`), so the two cannot disagree about which path a\n * request target names. Production adapters build the URL in their own\n * runtime (srvx for Nitro).\n */\nexport function requestTargetUrl(origin: string, target: string): URL | null {\n if (target.startsWith('/')) return URL.parse(origin + target);\n const resolved = URL.parse(target, origin);\n if (resolved?.protocol !== 'http:' && resolved?.protocol !== 'https:') return null;\n return URL.parse(origin + resolved.pathname + resolved.search);\n}\n";
87
+ // src/adapters/canonicalize-module.ts
88
+ /**
89
+ * Compile server/canonicalize.ts into a standalone ESM module exporting
90
+ * `canonicalize`.
91
+ *
92
+ * @internal Exported for testing.
93
+ */
94
+ async function generateCanonicalizeModule() {
95
+ const result = await transformWithOxc(canonicalize_default, "canonicalize.ts", { lang: "ts" });
96
+ assertStandalone(result.code, "server/canonicalize.ts", "_canonicalize.mjs");
97
+ return "// Generated by @timber-js/app — compiled from server/canonicalize.ts.\n// Do not edit — this file is regenerated on each build.\n" + result.code;
98
+ }
99
+ // src/adapters/nitro-immutable-assets.ts
100
+ /** The generated module, written beside the Nitro entry that imports it. */
101
+ var IMMUTABLE_ASSETS_MODULE = "_immutable-assets.mjs";
102
+ /**
103
+ * Write the generated module into `nitroDir` and return the Nitro config that
104
+ * serves the build's content-hashed directories from `<nitroDir>/public`.
105
+ *
106
+ * No `maxAge`: Nitro would turn it into a route rule (see the module header),
107
+ * and Vercel already gives a non-fallthrough directory a one-year immutable
108
+ * header on hits and `no-store` on misses by default.
109
+ */
110
+ async function prepareImmutableAssets(nitroDir, immutableDirs) {
111
+ if (immutableDirs.length === 0) return {
112
+ publicAssets: [],
113
+ plugins: []
114
+ };
115
+ const plugin = join(nitroDir, IMMUTABLE_ASSETS_MODULE);
116
+ await writeFile(plugin, generateImmutableAssetsModule(immutableDirs));
117
+ return {
118
+ publicAssets: immutableDirs.map((dir) => ({
119
+ dir: join(nitroDir, "public", dir),
120
+ baseURL: `/${dir}`,
121
+ fallthrough: false
122
+ })),
123
+ plugins: [plugin]
124
+ };
125
+ }
126
+ /**
127
+ * The lines timber's Nitro entry needs to answer a request under the
128
+ * content-hashed directories itself: an import, and a guard to run before
129
+ * the handler, with the h3 event in scope as `event`. Empty when the build
130
+ * has no such directories, which also means `prepareImmutableAssets()`
131
+ * writes no module to import.
132
+ */
133
+ function immutableAssetsEntryGuard(immutableDirs) {
134
+ if (immutableDirs.length === 0) return {
135
+ imports: "",
136
+ guard: ""
137
+ };
138
+ return {
139
+ imports: `import { isImmutableAssetPath } from './${IMMUTABLE_ASSETS_MODULE}'\n`,
140
+ guard: ` // Under a content-hashed directory only a served file may answer; the
141
+ // static handler already sent any file there is. A no-store 404, never a
142
+ // page — see _immutable-assets.mjs.
143
+ if (isImmutableAssetPath(event.url.pathname)) {
144
+ return new Response('Not Found', {
145
+ status: 404,
146
+ headers: { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' },
147
+ })
49
148
  }
50
- return null;
149
+ `
150
+ };
51
151
  }
152
+ /**
153
+ * Generate the module shared by the Nitro entry and runtime: the path matcher
154
+ * for the content-hashed directories, and the runtime plugin that owns
155
+ * Cache-Control under them — `IMMUTABLE_CACHE` on a GET or HEAD that served
156
+ * the file (200, or 304 revalidating it), `no-store` on everything else.
157
+ *
158
+ * Status is a sound signal only because the entry answers everything else
159
+ * under these directories with a 404 (see `immutableAssetsEntryGuard`). The
160
+ * prefixes are matched against the decoded path, the one Nitro's static
161
+ * handler looks the file up by.
162
+ *
163
+ * @internal Exported for testing.
164
+ */
165
+ function generateImmutableAssetsModule(immutableDirs) {
166
+ const prefixes = immutableDirs.map((dir) => `/${dir}/`);
167
+ return `// Generated by @timber-js/app — Cache-Control for content-hashed directories.
168
+ // Do not edit — this file is regenerated on each build.
52
169
 
53
- function shouldCompress(response) {
54
- if (!response.body) return false;
55
- if (NO_COMPRESS_STATUSES.has(response.status)) return false;
56
- if (response.headers.has('Content-Encoding')) return false;
57
- const contentType = response.headers.get('Content-Type');
58
- if (!contentType) return false;
59
- const mimeType = contentType.split(';')[0].trim().toLowerCase();
60
- if (mimeType === 'text/event-stream') return false;
61
- return COMPRESSIBLE_TYPES.has(mimeType);
62
- }
170
+ const PREFIXES = ${JSON.stringify(prefixes)};
171
+ const IMMUTABLE_CACHE = ${JSON.stringify(IMMUTABLE_CACHE)};
63
172
 
64
- function compressWithGzip(body) {
65
- return body.pipeThrough(new CompressionStream('gzip'));
173
+ export function isImmutableAssetPath(pathname) {
174
+ let path = pathname;
175
+ try {
176
+ path = decodeURI(pathname);
177
+ } catch {
178
+ // Malformed escapes: match the path as received.
179
+ }
180
+ return PREFIXES.some((prefix) => path.startsWith(prefix));
66
181
  }
67
182
 
68
- export function compressResponse(request, response) {
69
- if (!shouldCompress(response)) return response;
70
- const acceptEncoding = request.headers.get('Accept-Encoding') || '';
71
- const encoding = negotiateEncoding(acceptEncoding);
72
- if (!encoding) return response;
73
- const compressedBody = compressWithGzip(response.body);
74
- const headers = new Headers(response.headers);
75
- headers.set('Content-Encoding', encoding);
76
- headers.delete('Content-Length');
77
- const existingVary = headers.get('Vary');
78
- if (existingVary) {
79
- if (!existingVary.toLowerCase().includes('accept-encoding')) {
80
- headers.set('Vary', existingVary + ', Accept-Encoding');
81
- }
82
- } else {
83
- headers.set('Vary', 'Accept-Encoding');
84
- }
85
- return new Response(compressedBody, {
86
- status: response.status,
87
- statusText: response.statusText,
88
- headers,
183
+ export default function immutableAssets(nitroApp) {
184
+ // Hooks are off only if a user's nitroConfig disables them; files then go
185
+ // without the long-lived header rather than failing every request.
186
+ nitroApp.hooks?.hook('response', (res, event) => {
187
+ if (!isImmutableAssetPath(event.url.pathname)) return;
188
+ const method = event.req.method;
189
+ const served =
190
+ (method === 'GET' || method === 'HEAD') && (res.status === 200 || res.status === 304);
191
+ res.headers.set('Cache-Control', served ? IMMUTABLE_CACHE : 'no-store');
89
192
  });
90
193
  }
91
194
  `;
92
195
  }
93
- //#endregion
94
- //#region src/adapters/nitro.ts
95
- var IMMUTABLE_CACHE = "public, max-age=31536000, immutable";
96
- var STATIC_CACHE = "public, max-age=3600, must-revalidate";
97
- function generateHeadersFile() {
98
- return `# Auto-generated by @timber-js/app — static asset cache headers.
99
- # See design/25-production-deployments.md §"CDN / Edge Cache"
100
-
101
- /assets/*
102
- Cache-Control: ${IMMUTABLE_CACHE}
103
-
104
- /*
105
- Cache-Control: ${STATIC_CACHE}
106
- `;
107
- }
196
+ // src/adapters/nitro-presets.ts
108
197
  var PRESET_CONFIGS = {
109
198
  "vercel": {
110
199
  nitroPreset: "vercel",
111
200
  outputDir: ".vercel/output",
112
201
  supportsWaitUntil: true,
113
202
  supportsEarlyHints: false,
203
+ readsPlatformFiles: false,
114
204
  runtimeName: "vercel",
115
205
  extraConfig: { vercel: { functions: { maxDuration: 30 } } }
116
206
  },
@@ -119,6 +209,7 @@ var PRESET_CONFIGS = {
119
209
  outputDir: ".vercel/output",
120
210
  supportsWaitUntil: true,
121
211
  supportsEarlyHints: false,
212
+ readsPlatformFiles: false,
122
213
  runtimeName: "vercel-edge"
123
214
  },
124
215
  "netlify": {
@@ -126,6 +217,7 @@ var PRESET_CONFIGS = {
126
217
  outputDir: ".netlify/functions-internal",
127
218
  supportsWaitUntil: false,
128
219
  supportsEarlyHints: false,
220
+ readsPlatformFiles: true,
129
221
  runtimeName: "netlify"
130
222
  },
131
223
  "netlify-edge": {
@@ -133,6 +225,7 @@ var PRESET_CONFIGS = {
133
225
  outputDir: ".netlify/edge-functions",
134
226
  supportsWaitUntil: true,
135
227
  supportsEarlyHints: false,
228
+ readsPlatformFiles: true,
136
229
  runtimeName: "netlify-edge"
137
230
  },
138
231
  "aws-lambda": {
@@ -140,6 +233,7 @@ var PRESET_CONFIGS = {
140
233
  outputDir: ".output",
141
234
  supportsWaitUntil: false,
142
235
  supportsEarlyHints: false,
236
+ readsPlatformFiles: false,
143
237
  runtimeName: "aws-lambda"
144
238
  },
145
239
  "deno-deploy": {
@@ -147,6 +241,7 @@ var PRESET_CONFIGS = {
147
241
  outputDir: ".output",
148
242
  supportsWaitUntil: true,
149
243
  supportsEarlyHints: false,
244
+ readsPlatformFiles: false,
150
245
  runtimeName: "deno-deploy"
151
246
  },
152
247
  "azure-functions": {
@@ -154,6 +249,7 @@ var PRESET_CONFIGS = {
154
249
  outputDir: ".output",
155
250
  supportsWaitUntil: false,
156
251
  supportsEarlyHints: false,
252
+ readsPlatformFiles: false,
157
253
  runtimeName: "azure-functions"
158
254
  },
159
255
  "node-server": {
@@ -161,6 +257,7 @@ var PRESET_CONFIGS = {
161
257
  outputDir: ".output",
162
258
  supportsWaitUntil: true,
163
259
  supportsEarlyHints: false,
260
+ readsPlatformFiles: false,
164
261
  runtimeName: "node-server"
165
262
  },
166
263
  "bun": {
@@ -168,9 +265,499 @@ var PRESET_CONFIGS = {
168
265
  outputDir: ".output",
169
266
  supportsWaitUntil: true,
170
267
  supportsEarlyHints: false,
268
+ readsPlatformFiles: false,
171
269
  runtimeName: "bun"
172
270
  }
173
271
  };
272
+ /** Presets that produce a locally-runnable server entry. */
273
+ var LOCALLY_PREVIEWABLE = /* @__PURE__ */ new Set(["node-server", "bun"]);
274
+ // src/adapters/nitro-preview.ts
275
+ /**
276
+ * Content-Type by file extension for the preview server. Static hosts decide
277
+ * this themselves; the table covers the file types a web build ships so the
278
+ * preview does not turn ordinary files into downloads. An extension missing
279
+ * here is served as `application/octet-stream`.
280
+ */
281
+ var PREVIEW_MIME_TYPES = {
282
+ ".html": "text/html; charset=utf-8",
283
+ ".htm": "text/html; charset=utf-8",
284
+ ".css": "text/css; charset=utf-8",
285
+ ".js": "text/javascript; charset=utf-8",
286
+ ".mjs": "text/javascript; charset=utf-8",
287
+ ".cjs": "text/javascript; charset=utf-8",
288
+ ".map": "application/json; charset=utf-8",
289
+ ".json": "application/json; charset=utf-8",
290
+ ".jsonld": "application/ld+json",
291
+ ".webmanifest": "application/manifest+json",
292
+ ".xml": "application/xml",
293
+ ".rss": "application/rss+xml",
294
+ ".atom": "application/atom+xml",
295
+ ".txt": "text/plain; charset=utf-8",
296
+ ".md": "text/markdown; charset=utf-8",
297
+ ".csv": "text/csv; charset=utf-8",
298
+ ".ics": "text/calendar; charset=utf-8",
299
+ ".vtt": "text/vtt; charset=utf-8",
300
+ ".pdf": "application/pdf",
301
+ ".wasm": "application/wasm",
302
+ ".zip": "application/zip",
303
+ ".gz": "application/gzip",
304
+ ".png": "image/png",
305
+ ".apng": "image/apng",
306
+ ".jpg": "image/jpeg",
307
+ ".jpeg": "image/jpeg",
308
+ ".gif": "image/gif",
309
+ ".svg": "image/svg+xml",
310
+ ".ico": "image/x-icon",
311
+ ".webp": "image/webp",
312
+ ".avif": "image/avif",
313
+ ".bmp": "image/bmp",
314
+ ".tif": "image/tiff",
315
+ ".tiff": "image/tiff",
316
+ ".woff": "font/woff",
317
+ ".woff2": "font/woff2",
318
+ ".ttf": "font/ttf",
319
+ ".otf": "font/otf",
320
+ ".mp3": "audio/mpeg",
321
+ ".wav": "audio/wav",
322
+ ".ogg": "audio/ogg",
323
+ ".oga": "audio/ogg",
324
+ ".m4a": "audio/mp4",
325
+ ".flac": "audio/flac",
326
+ ".mp4": "video/mp4",
327
+ ".webm": "video/webm",
328
+ ".ogv": "video/ogg",
329
+ ".mov": "video/quicktime"
330
+ };
331
+ /**
332
+ * Generate a standalone preview server script that uses Node's built-in
333
+ * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
334
+ * h3 which isn't available outside a Nitro build. For local preview we
335
+ * just need to serve static files and, in a server build, route requests
336
+ * to the RSC handler.
337
+ *
338
+ * Generated at build time rather than at preview time, so everything it
339
+ * serves comes from the build's artifacts instead of guesses about the
340
+ * directory it runs in.
341
+ *
342
+ * @internal Exported for testing.
343
+ */
344
+ function generatePreviewScript(options) {
345
+ const immutablePrefixes = options.immutableDirs.map((dir) => `/${dir}/`);
346
+ const contentTypes = options.output === "static" ? options.contentTypes : {};
347
+ const handlerSetup = options.output === "server" ? `// Set runtime before importing the handler.
348
+ process.env.TIMBER_RUNTIME = ${JSON.stringify(options.runtimeName)};
349
+ ${options.hasManifestInit ? `
350
+ // Load the build manifest before the handler reads it.
351
+ await import('./_timber-manifest-init.js');
352
+ ` : ""}
353
+ // Import the RSC handler (default export is the fetch-like handler).
354
+ const { default: handler, runWithEarlyHintsSender } = await import(${JSON.stringify(options.rscEntry)});
355
+
356
+ // Import compression helper for self-hosted response compression.
357
+ const { compressResponse } = await import('./_compress.mjs');
358
+
359
+ // Web→Node response bridge with backpressure (TIM-1154).
360
+ const { sendNodeResponse } = await import('./_send-response.mjs');
361
+ ` : "";
362
+ const fallback = options.output === "static" ? ` if (badPath) {
363
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
364
+ res.end('Bad Request');
365
+ return;
366
+ }
367
+ const notFound = await findFile('/404.html');
368
+ if (notFound) {
369
+ await sendFile(req, res, notFound, 404, 'text/html', 'public, max-age=0, must-revalidate');
370
+ return;
371
+ }
372
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
373
+ res.end('Not Found');
374
+ ` : ` // A request under a content-hashed directory that names no file is a
375
+ // plain no-store 404, never a render of the app — as timber's Nitro entry
376
+ // answers it in production (TIM-1578).
377
+ if (pathname !== null && IMMUTABLE_PREFIXES.some((prefix) => pathname.startsWith(prefix))) {
378
+ res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8', 'Cache-Control': 'no-store' });
379
+ res.end('Not Found');
380
+ return;
381
+ }
382
+ await handleDynamic(req, res, url);
383
+ `;
384
+ const dynamicHandler = options.output === "server" ? `
385
+ async function handleDynamic(req, res, url) {
386
+ // Convert Node request to Web Request.
387
+ const headers = new Headers();
388
+ for (const [key, value] of Object.entries(req.headers)) {
389
+ if (value) {
390
+ if (Array.isArray(value)) {
391
+ for (const v of value) headers.append(key, v);
392
+ } else {
393
+ headers.set(key, value);
394
+ }
395
+ }
396
+ }
397
+
398
+ let body = undefined;
399
+ if (req.method !== 'GET' && req.method !== 'HEAD') {
400
+ body = await new Promise((resolve) => {
401
+ const chunks = [];
402
+ req.on('data', (chunk) => chunks.push(chunk));
403
+ req.on('end', () => resolve(Buffer.concat(chunks)));
404
+ });
405
+ }
406
+
407
+ const webRequest = new Request(url.href, {
408
+ method: req.method,
409
+ headers,
410
+ body,
411
+ duplex: body ? 'half' : undefined,
412
+ });
413
+
414
+ try {
415
+ // Support 103 Early Hints when available.
416
+ const earlyHintsSender = (typeof res.writeEarlyHints === 'function')
417
+ ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }
418
+ : undefined;
419
+
420
+ const rawResponse = earlyHintsSender && runWithEarlyHintsSender
421
+ ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))
422
+ : await handler(webRequest);
423
+
424
+ // Compress the response for self-hosted deployments.
425
+ const webResponse = compressResponse(webRequest, rawResponse);
426
+
427
+ // Write the response to Node's ServerResponse. sendNodeResponse handles
428
+ // status, headers (including Set-Cookie splitting via [...headers]),
429
+ // body streaming with backpressure, and client disconnect cleanup.
430
+ // See TIM-1154.
431
+ await sendNodeResponse(res, webResponse);
432
+ } catch (err) {
433
+ console.error('[timber preview] Request error:', err);
434
+ if (!res.headersSent) {
435
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
436
+ }
437
+ res.end('Internal Server Error');
438
+ }
439
+ }
440
+ ` : "";
441
+ return `// Generated by @timber-js/app — standalone preview server.
442
+ // Do not edit — this file is regenerated on each build.
443
+ // Uses Node's built-in HTTP server to serve the build's files${options.output === "server" ? " and route\n// dynamic requests through the RSC handler" : ""}. No Nitro/h3 dependency.
444
+
445
+ import { createServer } from 'node:http';
446
+ import { readFile, stat } from 'node:fs/promises';
447
+ import { join, extname, sep } from 'node:path';
448
+ import { fileURLToPath } from 'node:url';
449
+ import { canonicalize, requestTargetUrl } from './_canonicalize.mjs';
450
+
451
+ const __dirname = fileURLToPath(new URL('.', import.meta.url));
452
+
453
+ ${handlerSetup}
454
+ const MIME_TYPES = ${JSON.stringify(PREVIEW_MIME_TYPES, null, 2)};
455
+
456
+ // Recorded by the build: content-hashed directories, and the Content-Type of
457
+ // each extensionless API route output (a file name cannot say it). Both are
458
+ // decoded route-space paths, matched against the decoded request path.
459
+ const IMMUTABLE_PREFIXES = ${JSON.stringify(immutablePrefixes)};
460
+ const BASE = ${JSON.stringify(options.base)};
461
+ const CONTENT_TYPES = ${JSON.stringify(contentTypes)};
462
+ const SERVE_DIRECTORY_INDEX = ${options.output === "static"};
463
+
464
+ const publicDir = join(__dirname, 'public');
465
+
466
+ /**
467
+ * The file under publicDir that a decoded URL path names, or null. A static
468
+ * build lays its pages out as <path>/index.html, so a directory serves its
469
+ * index there.
470
+ */
471
+ async function findFile(pathname) {
472
+ const filePath = join(publicDir, pathname);
473
+ // Prevent path traversal (and a sibling like public-other/ passing a bare
474
+ // prefix check).
475
+ if (!filePath.startsWith(publicDir + sep)) return null;
476
+ try {
477
+ const fileStat = await stat(filePath);
478
+ if (fileStat.isFile()) return filePath;
479
+ if (SERVE_DIRECTORY_INDEX && fileStat.isDirectory()) {
480
+ const index = join(filePath, 'index.html');
481
+ if ((await stat(index)).isFile()) return index;
482
+ }
483
+ } catch {
484
+ // Not found.
485
+ }
486
+ return null;
487
+ }
488
+
489
+ /**
490
+ * The route-space path for a request path, or null when the request is
491
+ * outside the deployment base (it names no file of this build).
492
+ */
493
+ function stripBase(pathname) {
494
+ if (BASE === '/') return pathname;
495
+ if (pathname === BASE.slice(0, -1)) return '/';
496
+ if (!pathname.startsWith(BASE)) return null;
497
+ return pathname.slice(BASE.length - 1);
498
+ }
499
+
500
+ async function sendFile(req, res, filePath, status, contentType, cacheControl) {
501
+ const body = await readFile(filePath);
502
+ res.writeHead(status, {
503
+ 'Content-Type': contentType,
504
+ 'Content-Length': body.length,
505
+ 'Cache-Control': cacheControl,
506
+ });
507
+ res.end(req.method === 'HEAD' ? undefined : body);
508
+ }
509
+ ${dynamicHandler}
510
+ // Port resolution (TIM-842):
511
+ // - Default to 3000
512
+ // - If PORT env var is set, honor it strictly (fail loudly on conflict)
513
+ // - Otherwise auto-bump from 3000 until a free port is found
514
+ // Mirrors the dev server behavior so timber dev/preview/production all
515
+ // behave the same way around port selection.
516
+ const envPort = process.env.PORT ? parseInt(process.env.PORT, 10) : null;
517
+ const portIsExplicit = envPort != null && Number.isFinite(envPort) && envPort > 0;
518
+ const startPort = portIsExplicit ? envPort : 3000;
519
+ const host = process.env.HOST || 'localhost';
520
+ // An IPv6 HOST ('::', '::1') binds as is but needs brackets in a URL;
521
+ // unbracketed, every request URL is unparseable and answered 400.
522
+ const urlHost = host.includes(':') && !host.startsWith('[') ? \`[\${host}]\` : host;
523
+
524
+ // Set after listenWithBump() resolves so request handlers can build
525
+ // absolute URLs from the actual bound port (which may differ from
526
+ // startPort after an auto-bump).
527
+ let boundPort = startPort;
528
+
529
+ const server = createServer(async (req, res) => {
530
+ // Scheme from the socket's TLS state — a hardcoded http:// breaks CSRF
531
+ // origin comparison and absolute-URL construction when TLS is terminated
532
+ // at this server (TIM-1073; mirrors the dev-server fix in TIM-1067).
533
+ // X-Forwarded-Proto is intentionally not consulted here: on a direct
534
+ // connection it would be attacker-controlled. The CSRF layer honors it
535
+ // separately for reverse-proxy deployments.
536
+ const scheme = req.socket?.encrypted ? 'https' : 'http';
537
+ // requestTargetUrl() (server/canonicalize.ts) concatenates an origin-form
538
+ // target and resolves any other form, so '//evil.com/' stays a path the
539
+ // pipeline redirects (TIM-1571) and 'OPTIONS *' is '/*'. A target that
540
+ // names no URL is answered here: thrown in this callback, which has no
541
+ // catch around it, the rejection would take the preview process down.
542
+ const url = requestTargetUrl(\`\${scheme}://\${urlHost}:\${boundPort}\`, req.url || '/');
543
+ if (!url) {
544
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
545
+ res.end('Bad Request');
546
+ return;
547
+ }
548
+
549
+ // The runtime's own request-boundary canonicalizer (_canonicalize.mjs,
550
+ // compiled from server/canonicalize.ts): one decode, and the same 400s for
551
+ // encoded separators, null bytes, malformed encoding, and escaping the root
552
+ // (design/13-security.md). The base is stripped from its canonical result,
553
+ // so an encoded spelling of the base is the same path. What remains, in
554
+ // route space, is looked up in public/; null names no file.
555
+ const canonical = canonicalize(url.pathname, false);
556
+ const badPath = !canonical.ok;
557
+ const pathname = canonical.ok ? stripBase(canonical.pathname) : null;
558
+ const filePath = pathname === null ? null : await findFile(pathname);
559
+ if (filePath) {
560
+ const contentType =
561
+ CONTENT_TYPES[pathname] || MIME_TYPES[extname(filePath).toLowerCase()] || 'application/octet-stream';
562
+ // Hashed assets get immutable cache, others get short cache.
563
+ const isImmutable = IMMUTABLE_PREFIXES.some((prefix) => pathname.startsWith(prefix));
564
+ const cacheControl = isImmutable ? ${JSON.stringify(IMMUTABLE_CACHE)} : ${JSON.stringify(STATIC_CACHE)};
565
+ await sendFile(req, res, filePath, 200, contentType, cacheControl);
566
+ return;
567
+ }
568
+
569
+ ${fallback}});
570
+
571
+ function listenWithBump(port, attempt = 0) {
572
+ return new Promise((resolveListen, rejectListen) => {
573
+ const onError = (err) => {
574
+ server.removeListener('listening', onListening);
575
+ if (err && err.code === 'EADDRINUSE' && !portIsExplicit && attempt < 100) {
576
+ if (attempt === 0) {
577
+ console.log(\` [timber] Port \${port} in use, trying \${port + 1}...\`);
578
+ }
579
+ listenWithBump(port + 1, attempt + 1).then(resolveListen, rejectListen);
580
+ return;
581
+ }
582
+ rejectListen(err);
583
+ };
584
+ const onListening = () => {
585
+ server.removeListener('error', onError);
586
+ resolveListen(port);
587
+ };
588
+ server.once('error', onError);
589
+ server.once('listening', onListening);
590
+ server.listen(port, host);
591
+ });
592
+ }
593
+
594
+ try {
595
+ boundPort = await listenWithBump(startPort);
596
+ if (boundPort !== startPort) {
597
+ console.log();
598
+ console.log(\` [timber] Port \${startPort} in use, using \${boundPort}\`);
599
+ }
600
+ console.log();
601
+ console.log(' ⚡ timber preview server running at:');
602
+ console.log();
603
+ console.log(\` ➜ http://\${host}:\${boundPort}\`);
604
+ console.log();
605
+ } catch (err) {
606
+ if (err && err.code === 'EADDRINUSE') {
607
+ console.error(\`[timber] Port \${startPort} is already in use. \` +
608
+ 'Set PORT to a free port, or unset PORT to auto-pick.');
609
+ } else {
610
+ console.error('[timber] Failed to start preview server:', err);
611
+ }
612
+ process.exit(1);
613
+ }
614
+ `;
615
+ }
616
+ /** Spawn a Nitro preview process and pipe stdio. */
617
+ function spawnNitroPreview(command, args, cwd) {
618
+ return new Promise((resolve, reject) => {
619
+ const child = execFile(command, args, { cwd }, (err) => {
620
+ if (err) reject(err);
621
+ else resolve();
622
+ });
623
+ child.stdout?.pipe(process.stdout);
624
+ child.stderr?.pipe(process.stderr);
625
+ });
626
+ }
627
+ /**
628
+ * Generate a standalone ESM module that exports sendNodeResponse.
629
+ *
630
+ * Mirrors srvx/node's sendNodeResponse: status + headers via writeHead,
631
+ * body streaming with backpressure (waits for drain on write() === false),
632
+ * and client disconnect cleanup. Written to `_send-response.mjs` during
633
+ * buildOutput for use by the preview server script. See TIM-1154.
634
+ *
635
+ * @internal Exported for testing.
636
+ */
637
+ function generateSendResponseModule() {
638
+ return `// Generated by @timber-js/app — Web→Node response bridge.
639
+ // Do not edit — this file is regenerated on each build.
640
+ // Mirrors srvx/node's sendNodeResponse with backpressure support.
641
+
642
+ export function sendNodeResponse(nodeRes, webRes) {
643
+ if (!webRes) {
644
+ nodeRes.statusCode = 500;
645
+ return new Promise((resolve) => nodeRes.end(resolve));
646
+ }
647
+ // A response with a Node body (timber's NodeBodyResponse, srvx's protocol):
648
+ // pipe it straight to the socket, no Web Streams round trip. pipe() rather
649
+ // than pipeline(), which allocates an AbortController and an error on every
650
+ // finish; a client that disconnects early destroys the body (aborting the
651
+ // render), and a body that errors mid-stream destroys the socket.
652
+ //
653
+ // As srvx's pipeBody does, the status line waits until the body is
654
+ // readable: a body that errors before its first chunk answers a bare 500
655
+ // instead of closing the socket with nothing written (TIM-1602).
656
+ if (typeof webRes._toNodeResponse === 'function') {
657
+ const res = webRes._toNodeResponse();
658
+ if (res.body && typeof res.body.pipe === 'function') {
659
+ const body = res.body;
660
+ // The client already left: 'close' has fired and will not again.
661
+ if (nodeRes.destroyed) {
662
+ body.destroy();
663
+ return;
664
+ }
665
+ // Already failed: its 'error' has fired and 'readable' never will.
666
+ if (body.destroyed) {
667
+ writeHead(nodeRes, 500, 'Internal Server Error', []);
668
+ return new Promise((resolve) => nodeRes.end(resolve));
669
+ }
670
+ return new Promise((resolve) => {
671
+ function cleanup() {
672
+ body.off('error', onEarlyError);
673
+ body.off('readable', onReadable);
674
+ nodeRes.off('close', onEarlyClose);
675
+ }
676
+ function onEarlyError() {
677
+ cleanup();
678
+ body.destroy();
679
+ writeHead(nodeRes, 500, 'Internal Server Error', []);
680
+ nodeRes.end(resolve);
681
+ }
682
+ function onEarlyClose() {
683
+ cleanup();
684
+ body.destroy();
685
+ resolve();
686
+ }
687
+ function onReadable() {
688
+ cleanup();
689
+ writeHead(nodeRes, res.status, res.statusText, res.headers);
690
+ nodeRes.once('close', () => {
691
+ if (!body.readableEnded) body.destroy();
692
+ resolve();
693
+ });
694
+ nodeRes.on('error', () => body.destroy());
695
+ body.once('error', (error) => nodeRes.destroy(error));
696
+ body.pipe(nodeRes);
697
+ }
698
+ body.once('error', onEarlyError);
699
+ body.once('readable', onReadable);
700
+ nodeRes.once('close', onEarlyClose);
701
+ });
702
+ }
703
+ webRes = new Response(res.body, { status: res.status, statusText: res.statusText, headers: pairs(res.headers) });
704
+ }
705
+ // A Web body's status line goes out before its first read, as in srvx:
706
+ // one that errors before its first chunk closes the socket unanswered.
707
+ writeHead(nodeRes, webRes.status, webRes.statusText, [...webRes.headers].flat());
708
+ if (!webRes.body) {
709
+ return new Promise((resolve) => nodeRes.end(resolve));
710
+ }
711
+ // Stream with backpressure: pause reading when the kernel buffer is
712
+ // full (write() returns false) and resume on 'drain'.
713
+ if (nodeRes.destroyed) {
714
+ webRes.body.cancel();
715
+ return;
716
+ }
717
+ const reader = webRes.body.getReader();
718
+ function streamCancel(error) {
719
+ reader.cancel(error).catch(() => {});
720
+ if (error) nodeRes.destroy(error);
721
+ }
722
+ function streamHandle({ done, value }) {
723
+ try {
724
+ if (done) {
725
+ nodeRes.end();
726
+ } else if (nodeRes.write(value)) {
727
+ reader.read().then(streamHandle, streamCancel);
728
+ } else {
729
+ nodeRes.once('drain', () => reader.read().then(streamHandle, streamCancel));
730
+ }
731
+ } catch (error) {
732
+ streamCancel(error instanceof Error ? error : undefined);
733
+ }
734
+ }
735
+ nodeRes.on('close', streamCancel);
736
+ nodeRes.on('error', streamCancel);
737
+ reader.read().then(streamHandle, streamCancel);
738
+ return reader.closed.catch(streamCancel).finally(() => {
739
+ nodeRes.off('close', streamCancel);
740
+ nodeRes.off('error', streamCancel);
741
+ });
742
+ }
743
+
744
+ function writeHead(nodeRes, status, statusText, headers) {
745
+ if (nodeRes.headersSent) return;
746
+ if (nodeRes.req?.httpVersion === '2.0') {
747
+ nodeRes.writeHead(status, headers);
748
+ } else {
749
+ nodeRes.writeHead(status, statusText, headers);
750
+ }
751
+ }
752
+
753
+ function pairs(flat) {
754
+ const out = [];
755
+ for (let i = 0; i < flat.length; i += 2) out.push([flat[i], flat[i + 1]]);
756
+ return out;
757
+ }
758
+ `;
759
+ }
760
+ // src/adapters/nitro.ts
174
761
  /**
175
762
  * Create a Nitro-based adapter for multi-platform deployment.
176
763
  *
@@ -190,52 +777,87 @@ var PRESET_CONFIGS = {
190
777
  function nitro(options = {}) {
191
778
  const preset = options.preset ?? "node-server";
192
779
  const compress = options.compress ?? true;
193
- const presetConfig = PRESET_CONFIGS[preset];
194
- const pendingPromises = [];
195
780
  return {
196
781
  name: `nitro-${preset}`,
197
- async buildOutput(config, buildDir) {
198
- const outDir = join(buildDir, "nitro");
199
- await mkdir(outDir, { recursive: true });
200
- const clientDir = join(buildDir, "client");
201
- const publicDir = join(outDir, "public");
202
- await mkdir(publicDir, { recursive: true });
203
- await cp(clientDir, publicDir, {
204
- recursive: true,
205
- filter: config.clientJavascriptDisabled ? (src) => !src.endsWith(".js") : void 0
206
- }).catch(() => {});
207
- await writeFile(join(publicDir, "_headers"), generateHeadersFile());
208
- if (config.manifestInit) await writeFile(join(outDir, "_timber-manifest-init.js"), config.manifestInit);
209
- await writeFile(join(outDir, "_compress.mjs"), generateCompressModule());
210
- await cp(join(buildDir, "rsc"), join(outDir, "rsc"), { recursive: true });
211
- await cp(join(buildDir, "ssr"), join(outDir, "ssr"), { recursive: true }).catch(() => {});
212
- if (config.manifestInit) {
782
+ async buildOutput(config, artifacts) {
783
+ const outDir = join(artifacts.outputDir, "nitro");
784
+ if (artifacts.output === "static") {
785
+ await buildStaticDirectoryOutput(config, artifacts, outDir, "public");
786
+ const publicDir = join(outDir, "public");
787
+ const target = options.staticTarget ?? "generic";
788
+ if (target !== "github-pages") await writeHeadersFile(publicDir, config, artifacts);
789
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
790
+ await writeFile(join(outDir, PREVIEW_SCRIPT), generatePreviewScript({
791
+ output: "static",
792
+ immutableDirs: artifacts.immutableDirs,
793
+ base: adapterBase(config),
794
+ contentTypes: artifacts.contentTypes
795
+ }));
796
+ if (target === "github-pages") {
797
+ await writeFile(join(publicDir, ".nojekyll"), "");
798
+ try {
799
+ if ((await readFile(join(publicDir, "_redirects"), "utf-8")).trim().length > 0) console.warn("[timber] Warning: GitHub Pages does not support _redirects files. Redirect rules from middleware/proxy will not work on this platform.");
800
+ } catch {}
801
+ for (const name of [HEADERS_FILE, REDIRECTS_FILE]) await rm(join(publicDir, name), { force: true });
802
+ }
803
+ return;
804
+ }
805
+ await runSharedBuildSteps({
806
+ config,
807
+ artifacts,
808
+ outDir,
809
+ publicDirName: "public",
810
+ platformFiles: PRESET_CONFIGS[preset].readsPlatformFiles
811
+ });
812
+ await writeFile(join(outDir, "_compress.mjs"), await generateCompressModule());
813
+ await writeFile(join(outDir, "_send-response.mjs"), generateSendResponseModule());
814
+ if (LOCALLY_PREVIEWABLE.has(preset)) {
815
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
816
+ await writeFile(join(outDir, PREVIEW_SCRIPT), generatePreviewScript({
817
+ output: "server",
818
+ runtimeName: PRESET_CONFIGS[preset].runtimeName,
819
+ rscEntry: importSpecifier(outDir, join(artifacts.rsc.path, "index.js")),
820
+ hasManifestInit: !!artifacts.manifestInit,
821
+ immutableDirs: artifacts.immutableDirs,
822
+ base: adapterBase(config)
823
+ }));
824
+ }
825
+ if (artifacts.manifestInit) {
213
826
  const rscEntry = join(outDir, "rsc", "index.js");
214
827
  const rscContent = await readFile(rscEntry, "utf-8");
215
- await writeFile(rscEntry, `${config.manifestInit}\n${rscContent}`);
828
+ await writeFile(rscEntry, `${artifacts.manifestInit}\n${rscContent}`);
216
829
  }
217
- const entry = generateNitroEntry(buildDir, outDir, preset, compress);
830
+ await writeFile(join(outDir, RUNTIME_INIT_MODULE), generateRuntimeInitModule(PRESET_CONFIGS[preset].runtimeName));
831
+ const entry = generateNitroEntry(preset, compress, artifacts.immutableDirs);
218
832
  await writeFile(join(outDir, "entry.ts"), entry);
219
- await runNitroBuild(outDir, preset, options.nitroConfig);
833
+ const { serverDir } = await runNitroBuild(outDir, preset, artifacts.immutableDirs, options.nitroConfig);
834
+ if (artifacts.prebuilt) {
835
+ const prebuiltSrc = artifacts.prebuilt.path;
836
+ await cp(prebuiltSrc, join(serverDir, "prebuilt"), { recursive: true });
837
+ if (preset === "vercel" || preset === "vercel-edge") await copyPrebuiltToVercelFuncClones(dirname(serverDir), prebuiltSrc, basename(serverDir));
838
+ }
220
839
  },
221
- preview: LOCALLY_PREVIEWABLE.has(preset) ? async (_config, buildDir) => {
222
- const previewScript = generatePreviewScript(buildDir, preset);
223
- const scriptPath = join(buildDir, "nitro", "_preview-server.mjs");
224
- await writeFile(scriptPath, previewScript);
225
- await spawnNitroPreview(preset === "bun" ? "bun" : "node", [scriptPath], join(buildDir, "nitro"));
226
- } : void 0,
227
- waitUntil: presetConfig.supportsWaitUntil ? (promise) => {
228
- const tracked = promise.catch((err) => {
229
- console.error("[timber] waitUntil promise rejected:", err);
230
- });
231
- pendingPromises.push(tracked);
232
- } : void 0
840
+ async preview(_config, { output, outputDir }) {
841
+ if (output === "server" && !LOCALLY_PREVIEWABLE.has(preset)) throw new Error(`[timber] The nitro '${preset}' preset has no local runtime, so \`timber preview\` cannot run its server build. Preview with a node-server build, or with the platform's own tooling.`);
842
+ const nitroDir = join(outputDir, "nitro");
843
+ const script = join(nitroDir, PREVIEW_SCRIPT);
844
+ if (!existsSync(script)) throw new Error(`[timber] No preview server at ${script}. Run \`timber build\` before \`timber preview\`.`);
845
+ await spawnNitroPreview(output === "server" && preset === "bun" ? "bun" : process.execPath, [script], nitroDir);
846
+ }
233
847
  };
234
848
  }
849
+ /** The preview server buildOutput writes into the Nitro output directory. */
850
+ var PREVIEW_SCRIPT = "_preview-server.mjs";
851
+ /** The request-path canonicalizer the preview server imports beside it. */
852
+ var CANONICALIZE_MODULE = "_canonicalize.mjs";
853
+ /** A relative ESM import specifier for `file`, as imported from a module in `fromDir`. */
854
+ function importSpecifier(fromDir, file) {
855
+ const path = relative(fromDir, file).split(sep).join("/");
856
+ return path.startsWith("../") ? path : "./" + path;
857
+ }
235
858
  /** @internal Exported for testing. */
236
- function generateNitroEntry(buildDir, outDir, preset, compress = true, hasManifestInit = false) {
859
+ function generateNitroEntry(preset, compress = true, immutableDirs = []) {
237
860
  const serverEntryRelative = "./rsc/index.js";
238
- const runtimeName = PRESET_CONFIGS[preset].runtimeName;
239
861
  const earlyHints = PRESET_CONFIGS[preset].supportsEarlyHints;
240
862
  const supportsWaitUntil = PRESET_CONFIGS[preset].supportsWaitUntil;
241
863
  let handlerCall;
@@ -271,14 +893,19 @@ function generateNitroEntry(buildDir, outDir, preset, compress = true, hasManife
271
893
  ? await runWithWaitUntil(waitUntilFn, () => handler(webRequest))
272
894
  : await handler(webRequest)`;
273
895
  else handlerCall = ` const webResponse = await handler(webRequest)`;
896
+ const waitUntilImport = supportsWaitUntil ? ", runWithWaitUntil" : "";
897
+ const compressImport = compress ? "import { compressResponse } from './_compress.mjs'\n" : "";
898
+ const compressCall = compress ? "compressResponse(webRequest, webResponse)" : "webResponse";
899
+ const immutableAssets = immutableAssetsEntryGuard(immutableDirs);
274
900
  return `// Generated by @timber-js/app/adapters/nitro
275
901
  // Do not edit — this file is regenerated on each build.
276
902
 
277
- ${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler, { runWithEarlyHintsSender${supportsWaitUntil ? ", runWithWaitUntil" : ""} } from '${serverEntryRelative}'
278
- ${compress ? "import { compressResponse } from './_compress.mjs'\n" : ""}
279
- // Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
903
+ // Side-effect import, first: sets TIMBER_RUNTIME before the RSC entry (and
904
+ // its top-level await of instrumentation register()) evaluates.
280
905
  // See design/25-production-deployments.md §"TIMBER_RUNTIME".
281
- process.env.TIMBER_RUNTIME = '${runtimeName}'
906
+ import './${RUNTIME_INIT_MODULE}'
907
+ import handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'
908
+ ${compressImport}${immutableAssets.imports}
282
909
 
283
910
  // Nitro's index.mjs wraps this import with defineLazyEventHandler, which
284
911
  // already handles the event handler protocol. We export a plain async
@@ -286,261 +913,124 @@ process.env.TIMBER_RUNTIME = '${runtimeName}'
286
913
  // Nitro bundles h3 into its internal _libs/ directory but doesn't make
287
914
  // it available as a bare specifier in the output's node_modules.
288
915
  export default async function timberHandler(event) {
289
- // h3 v2: event.req is the Web Request
916
+ ${immutableAssets.guard} // h3 v2: event.req is the Web Request
290
917
  const webRequest = event.req
291
918
  ${handlerCall}
292
- return ${compress ? "compressResponse(webRequest, webResponse)" : "webResponse"}
919
+ return ${compressCall}
293
920
  }
294
921
  `;
295
922
  }
923
+ /**
924
+ * Prefixes of nitro build-output lines that give wrong advice for timber
925
+ * builds. Every nitro bundler path emits these hints via `logger.success` —
926
+ * the rollup path hardcodes `npx nitro preview`; rolldown and vite default
927
+ * to it. That command resolves `.output/nitro.json` relative to cwd, but
928
+ * timber's nitro build lives at `.timber/dist/nitro/.output`, so the
929
+ * suggested command can never work from the project root.
930
+ * Prefix matching degrades gracefully: if upstream rewords the line
931
+ * entirely, it passes through rather than being silently eaten.
932
+ */
933
+ var NITRO_PREVIEW_HINT_PREFIX = "You can preview this build using";
934
+ var NITRO_DEPLOY_HINT_PREFIX = "You can deploy this build using";
935
+ var SUPPRESSED_NITRO_HINT_PREFIXES = [NITRO_PREVIEW_HINT_PREFIX, NITRO_DEPLOY_HINT_PREFIX];
296
936
  /** @internal Exported for testing. */
297
- function generateNitroConfig(preset, userConfig) {
298
- const presetConfig = PRESET_CONFIGS[preset];
299
- const config = {
300
- preset: presetConfig.nitroPreset,
301
- entry: "./entry.ts",
302
- output: { dir: presetConfig.outputDir },
303
- routeRules: { "/assets/**": { headers: { "Cache-Control": IMMUTABLE_CACHE } } },
304
- ...presetConfig.extraConfig,
305
- ...userConfig
306
- };
307
- return `// Generated by @timber-js/app/adapters/nitro
308
- // Do not edit — this file is regenerated on each build.
309
-
310
- import { defineNitroConfig } from 'nitro/config'
311
-
312
- export default defineNitroConfig(${JSON.stringify(config, null, 2)})
313
- `;
937
+ function isSuppressedNitroHint(message, prefixes = SUPPRESSED_NITRO_HINT_PREFIXES) {
938
+ return typeof message === "string" && prefixes.some((prefix) => message.startsWith(prefix));
314
939
  }
315
- /** Presets that produce a locally-runnable server entry. */
316
- var LOCALLY_PREVIEWABLE = new Set(["node-server", "bun"]);
317
940
  /**
318
- * Generate a standalone preview server script that uses Node's built-in
319
- * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
320
- * h3 which isn't available outside a Nitro build. For local preview we
321
- * just need to serve static files and route requests to the RSC handler.
941
+ * Nitro's rolldown and vite builders render `framework.previewCommand` /
942
+ * `framework.deployCommand` into these hints. A user who explicitly set one
943
+ * via `nitroConfig` has provided valid guidance — only suppress the hints
944
+ * whose command is still nitro's broken default.
322
945
  *
323
946
  * @internal Exported for testing.
324
947
  */
325
- function generatePreviewScript(buildDir, preset) {
326
- const rscEntryRelative = relative(join(buildDir, "nitro"), join(buildDir, "rsc", "index.js"));
327
- const rscEntry = rscEntryRelative.startsWith(".") ? rscEntryRelative : "./" + rscEntryRelative;
328
- const publicDir = "./public";
329
- const manifestInitPath = "./_timber-manifest-init.js";
330
- return `// Generated by @timber-js/app — standalone preview server.
331
- // Uses Node's built-in HTTP server to serve static assets and route
332
- // dynamic requests through the RSC handler. No Nitro/h3 dependency.
333
-
334
- import { createServer } from 'node:http';
335
- import { readFile, stat } from 'node:fs/promises';
336
- import { join, extname } from 'node:path';
337
- import { fileURLToPath } from 'node:url';
338
- import { existsSync } from 'node:fs';
339
-
340
- // Set runtime before importing the handler.
341
- process.env.TIMBER_RUNTIME = '${PRESET_CONFIGS[preset].runtimeName}';
342
-
343
- // Load the build manifest if it exists.
344
- const __dirname = fileURLToPath(new URL('.', import.meta.url));
345
- const manifestPath = join(__dirname, '${manifestInitPath}');
346
- if (existsSync(manifestPath)) {
347
- await import('${manifestInitPath}');
948
+ function selectSuppressedHintPrefixes(framework) {
949
+ return [...framework?.previewCommand ? [] : [NITRO_PREVIEW_HINT_PREFIX], ...framework?.deployCommand ? [] : [NITRO_DEPLOY_HINT_PREFIX]];
348
950
  }
349
-
350
- // Import the RSC handler (default export is the fetch-like handler).
351
- const { default: handler, runWithEarlyHintsSender } = await import('${rscEntry}');
352
-
353
- // Import compression helper for self-hosted response compression.
354
- const { compressResponse } = await import('./_compress.mjs');
355
-
356
- const MIME_TYPES = {
357
- '.html': 'text/html',
358
- '.js': 'application/javascript',
359
- '.mjs': 'application/javascript',
360
- '.css': 'text/css',
361
- '.json': 'application/json',
362
- '.png': 'image/png',
363
- '.jpg': 'image/jpeg',
364
- '.jpeg': 'image/jpeg',
365
- '.gif': 'image/gif',
366
- '.svg': 'image/svg+xml',
367
- '.ico': 'image/x-icon',
368
- '.woff': 'font/woff',
369
- '.woff2': 'font/woff2',
370
- '.ttf': 'font/ttf',
371
- '.otf': 'font/otf',
372
- '.webp': 'image/webp',
373
- '.avif': 'image/avif',
374
- '.webm': 'video/webm',
375
- '.mp4': 'video/mp4',
376
- '.txt': 'text/plain',
377
- '.xml': 'application/xml',
378
- '.wasm': 'application/wasm',
379
- };
380
-
381
- const publicDir = join(__dirname, '${publicDir}');
382
- const port = parseInt(process.env.PORT || '3000', 10);
383
- const host = process.env.HOST || process.env.HOSTNAME || 'localhost';
384
-
385
- const server = createServer(async (req, res) => {
386
- const url = new URL(req.url || '/', \`http://\${host}:\${port}\`);
387
-
388
- // Try serving static files from the public directory first.
389
- const filePath = join(publicDir, url.pathname);
390
- // Prevent path traversal.
391
- if (filePath.startsWith(publicDir)) {
392
- try {
393
- const fileStat = await stat(filePath);
394
- if (fileStat.isFile()) {
395
- const ext = extname(filePath);
396
- const contentType = MIME_TYPES[ext] || 'application/octet-stream';
397
- const body = await readFile(filePath);
398
- // Hashed assets get immutable cache, others get short cache.
399
- const cacheControl = url.pathname.startsWith('/assets/')
400
- ? 'public, max-age=31536000, immutable'
401
- : 'public, max-age=3600, must-revalidate';
402
- res.writeHead(200, {
403
- 'Content-Type': contentType,
404
- 'Content-Length': body.length,
405
- 'Cache-Control': cacheControl,
406
- });
407
- res.end(body);
408
- return;
409
- }
410
- } catch {
411
- // File not found — fall through to the RSC handler.
412
- }
413
- }
414
-
415
- // Convert Node request to Web Request.
416
- const headers = new Headers();
417
- for (const [key, value] of Object.entries(req.headers)) {
418
- if (value) {
419
- if (Array.isArray(value)) {
420
- for (const v of value) headers.append(key, v);
421
- } else {
422
- headers.set(key, value);
423
- }
424
- }
425
- }
426
-
427
- let body = undefined;
428
- if (req.method !== 'GET' && req.method !== 'HEAD') {
429
- body = await new Promise((resolve) => {
430
- const chunks = [];
431
- req.on('data', (chunk) => chunks.push(chunk));
432
- req.on('end', () => resolve(Buffer.concat(chunks)));
433
- });
434
- }
435
-
436
- const webRequest = new Request(url.href, {
437
- method: req.method,
438
- headers,
439
- body,
440
- duplex: body ? 'half' : undefined,
441
- });
442
-
443
- try {
444
- // Support 103 Early Hints when available.
445
- const earlyHintsSender = (typeof res.writeEarlyHints === 'function')
446
- ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }
447
- : undefined;
448
-
449
- const rawResponse = earlyHintsSender && runWithEarlyHintsSender
450
- ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))
451
- : await handler(webRequest);
452
-
453
- // Compress the response for self-hosted deployments.
454
- const webResponse = compressResponse(webRequest, rawResponse);
455
-
456
- // Write the response back to the Node response.
457
- res.writeHead(webResponse.status, Object.fromEntries(webResponse.headers.entries()));
458
-
459
- if (webResponse.body) {
460
- const reader = webResponse.body.getReader();
461
- const pump = async () => {
462
- while (true) {
463
- const { done, value } = await reader.read();
464
- if (done) { res.end(); return; }
465
- res.write(value);
466
- }
467
- };
468
- await pump();
469
- } else {
470
- res.end();
471
- }
472
- } catch (err) {
473
- console.error('[timber preview] Request error:', err);
474
- if (!res.headersSent) {
475
- res.writeHead(500, { 'Content-Type': 'text/plain' });
476
- }
477
- res.end('Internal Server Error');
478
- }
479
- });
480
-
481
- server.listen(port, host, () => {
482
- console.log();
483
- console.log(' ⚡ timber preview server running at:');
484
- console.log();
485
- console.log(\` ➜ http://\${host}:\${port}\`);
486
- console.log();
487
- });
488
- `;
489
- }
490
- /** @internal Exported for testing. */
491
- function generateNitroPreviewCommand(buildDir, preset) {
492
- if (!LOCALLY_PREVIEWABLE.has(preset)) return null;
493
- const nitroDir = join(buildDir, "nitro");
494
- const entryPath = join(nitroDir, "entry.ts");
495
- return {
496
- command: preset === "bun" ? "bun" : "node",
497
- args: [entryPath],
498
- cwd: nitroDir
951
+ /**
952
+ * Wrap a nitro logger's `success` so hardcoded preview/deploy hints are
953
+ * dropped for this programmatic build only. Returns the original
954
+ * (unfiltered) success fn so timber can print its own hint — which shares
955
+ * the suppressed prefix on purpose, replacing nitro's wording.
956
+ *
957
+ * @internal Exported for testing.
958
+ */
959
+ function wrapNitroLoggerForBuild(logger, prefixes = SUPPRESSED_NITRO_HINT_PREFIXES) {
960
+ const originalSuccess = logger.success.bind(logger);
961
+ const wrapped = (message, ...args) => {
962
+ if (isSuppressedNitroHint(message, prefixes)) return;
963
+ originalSuccess(message, ...args);
499
964
  };
965
+ logger.success = Object.assign(wrapped, logger.success);
966
+ return originalSuccess;
967
+ }
968
+ /**
969
+ * Timber's own post-build hint. Locally-runnable presets are previewed via
970
+ * `timber preview`, which invokes this adapter's `preview()` to run the
971
+ * generated `_preview-server.mjs`. Serverless presets get no hint — their
972
+ * output lives under `.timber/dist/nitro/`, so any cwd-relative deploy
973
+ * command would be as wrong as the nitro hint this replaces.
974
+ *
975
+ * @internal Exported for testing.
976
+ */
977
+ function getPostBuildHint(preset) {
978
+ return LOCALLY_PREVIEWABLE.has(preset) ? "You can preview this build using `timber preview`" : null;
500
979
  }
501
980
  /**
502
981
  * Run the Nitro production build using the programmatic API.
503
982
  * Uses dynamic import so nitro is only loaded at build time.
504
983
  * Externalizes the timber RSC/SSR output — those files are pre-built
505
984
  * by timber and have internal references that nitro's bundler can't follow.
985
+ *
986
+ * @internal Exported for testing.
506
987
  */
507
- async function runNitroBuild(nitroDir, preset, userConfig) {
988
+ async function runNitroBuild(nitroDir, preset, immutableDirs, userConfig) {
508
989
  const presetConfig = PRESET_CONFIGS[preset];
990
+ const immutableAssets = await prepareImmutableAssets(nitroDir, immutableDirs);
509
991
  const { createNitro, build: nitroBuild, prepare, copyPublicAssets } = await import("nitro/builder");
510
992
  const nitro = await createNitro({
511
993
  rootDir: nitroDir,
512
994
  preset: presetConfig.nitroPreset,
513
995
  renderer: { handler: join(nitroDir, "entry.ts") },
514
996
  output: { dir: join(nitroDir, presetConfig.outputDir) },
515
- routeRules: { "/assets/**": { headers: { "Cache-Control": IMMUTABLE_CACHE } } },
516
997
  rollupConfig: { external: [/\.\.\/rsc\//] },
517
998
  ...presetConfig.extraConfig,
518
- ...userConfig
999
+ ...userConfig,
1000
+ publicAssets: [...immutableAssets.publicAssets, ...userConfig?.publicAssets ?? []],
1001
+ plugins: [...immutableAssets.plugins, ...userConfig?.plugins ?? []]
519
1002
  });
1003
+ const framework = nitro.options.builder === "rollup" ? void 0 : nitro.options.framework;
1004
+ const logSuccess = wrapNitroLoggerForBuild(nitro.logger, selectSuppressedHintPrefixes(framework));
1005
+ const raw = nitro.options.output.serverDir;
1006
+ const serverDir = raw.endsWith("/") ? raw.slice(0, -1) : raw;
520
1007
  await prepare(nitro);
521
1008
  await copyPublicAssets(nitro);
522
1009
  await nitroBuild(nitro);
523
1010
  await nitro.close();
524
- }
525
- /** Spawn a Nitro preview process and pipe stdio. */
526
- function spawnNitroPreview(command, args, cwd) {
527
- return new Promise((resolve, reject) => {
528
- const child = execFile(command, args, { cwd }, (err) => {
529
- if (err) reject(err);
530
- else resolve();
531
- });
532
- child.stdout?.pipe(process.stdout);
533
- child.stderr?.pipe(process.stderr);
534
- });
1011
+ const hint = framework?.previewCommand ? null : getPostBuildHint(preset);
1012
+ if (hint) logSuccess(hint);
1013
+ return { serverDir };
535
1014
  }
536
1015
  /**
537
- * Get the preset configuration for a given preset name.
1016
+ * Copy prebuilt payloads into cloned Vercel function directories.
1017
+ *
1018
+ * When users configure `vercel.functionRules`, Nitro's compiled hook clones
1019
+ * the base __server.func to per-route .func directories. These clones are
1020
+ * created during `runNitroBuild()` — before our post-build prebuilt copy.
1021
+ * Each clone resolves `../prebuilt` independently, so they each need a copy.
1022
+ *
538
1023
  * @internal Exported for testing.
539
1024
  */
540
- function getPresetConfig(preset) {
541
- return PRESET_CONFIGS[preset];
1025
+ async function copyPrebuiltToVercelFuncClones(functionsDir, prebuiltSrc, baseFuncName) {
1026
+ const funcDirs = [];
1027
+ try {
1028
+ for await (const match of glob("**/*.func", { cwd: functionsDir })) if (!match.endsWith(baseFuncName)) funcDirs.push(join(functionsDir, match));
1029
+ } catch {
1030
+ return;
1031
+ }
1032
+ await Promise.all(funcDirs.map((dir) => cp(prebuiltSrc, join(dir, "prebuilt"), { recursive: true })));
542
1033
  }
543
- //#endregion
544
- export { generateNitroConfig, generateNitroEntry, generateNitroPreviewCommand, generatePreviewScript, getPresetConfig, nitro };
1034
+ export { copyPrebuiltToVercelFuncClones, generateNitroEntry, getPostBuildHint, isSuppressedNitroHint, nitro, runNitroBuild, selectSuppressedHintPrefixes, wrapNitroLoggerForBuild };
545
1035
 
546
1036
  //# sourceMappingURL=nitro.js.map