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

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 (1484) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +351 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-BDqn4Oxj.js +1243 -0
  5. package/dist/_chunks/actions-BDqn4Oxj.js.map +1 -0
  6. package/dist/_chunks/als-registry-BZqHCtq-.js +43 -0
  7. package/dist/_chunks/als-registry-BZqHCtq-.js.map +1 -0
  8. package/dist/_chunks/als-slots-BEEIPKYm.js +26 -0
  9. package/dist/_chunks/als-slots-BEEIPKYm.js.map +1 -0
  10. package/dist/_chunks/base-path-DaQrzbez.js +80 -0
  11. package/dist/_chunks/base-path-DaQrzbez.js.map +1 -0
  12. package/dist/_chunks/build-manifest-DWppEdLB.js +86 -0
  13. package/dist/_chunks/build-manifest-DWppEdLB.js.map +1 -0
  14. package/dist/_chunks/build-output-helper-RV_BRcF1.js +367 -0
  15. package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +1 -0
  16. package/dist/_chunks/cache-api-GE4AOe2H.js +1061 -0
  17. package/dist/_chunks/cache-api-GE4AOe2H.js.map +1 -0
  18. package/dist/_chunks/canonicalize-BAWkWiKK.js +92 -0
  19. package/dist/_chunks/canonicalize-BAWkWiKK.js.map +1 -0
  20. package/dist/_chunks/chains-CDK1AWZQ.js +1 -0
  21. package/dist/_chunks/chains-e_Buf9vg.js +267 -0
  22. package/dist/_chunks/chains-e_Buf9vg.js.map +1 -0
  23. package/dist/_chunks/classify-2Yp3xJY1.js +147 -0
  24. package/dist/_chunks/classify-2Yp3xJY1.js.map +1 -0
  25. package/dist/_chunks/cli-check-DDwCkeDY.js +252 -0
  26. package/dist/_chunks/cli-check-DDwCkeDY.js.map +1 -0
  27. package/dist/_chunks/cli-context-BJQB6rtF.js +1 -0
  28. package/dist/_chunks/cli-context-_mPttGGY.js +70 -0
  29. package/dist/_chunks/cli-context-_mPttGGY.js.map +1 -0
  30. package/dist/_chunks/cli-schema-sync-BdIebmk3.js +290 -0
  31. package/dist/_chunks/cli-schema-sync-BdIebmk3.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CLNfXQDK.js +1 -0
  33. package/dist/_chunks/client-dep-entries-BOkpKjj1.js +110 -0
  34. package/dist/_chunks/client-dep-entries-BOkpKjj1.js.map +1 -0
  35. package/dist/_chunks/cloudflare-Byxl8FWP.js +1333 -0
  36. package/dist/_chunks/cloudflare-Byxl8FWP.js.map +1 -0
  37. package/dist/_chunks/codec-registry-oOUxugz3.js +21 -0
  38. package/dist/_chunks/codec-registry-oOUxugz3.js.map +1 -0
  39. package/dist/_chunks/codegen-Bps1sLKJ.js +432 -0
  40. package/dist/_chunks/codegen-Bps1sLKJ.js.map +1 -0
  41. package/dist/_chunks/convention-lint-ByKJ6aqD.js +590 -0
  42. package/dist/_chunks/convention-lint-ByKJ6aqD.js.map +1 -0
  43. package/dist/_chunks/dev-server-BiWNMBVU.js +1 -0
  44. package/dist/_chunks/dev-server-DIy-SY-J.js +2061 -0
  45. package/dist/_chunks/dev-server-DIy-SY-J.js.map +1 -0
  46. package/dist/_chunks/dev-store-BOa304m_.js +283 -0
  47. package/dist/_chunks/dev-store-BOa304m_.js.map +1 -0
  48. package/dist/_chunks/dist-DtrJyBbw.js +386 -0
  49. package/dist/_chunks/dist-DtrJyBbw.js.map +1 -0
  50. package/dist/_chunks/error-boundary-Bc8QPZuq.js +1107 -0
  51. package/dist/_chunks/error-boundary-Bc8QPZuq.js.map +1 -0
  52. package/dist/_chunks/fast-hash-C-tVYrLb.js +41 -0
  53. package/dist/_chunks/fast-hash-C-tVYrLb.js.map +1 -0
  54. package/dist/_chunks/flight-source-node-HptmGMT8.js +518 -0
  55. package/dist/_chunks/flight-source-node-HptmGMT8.js.map +1 -0
  56. package/dist/_chunks/format-BKclgVbk.js +14 -0
  57. package/dist/_chunks/format-BKclgVbk.js.map +1 -0
  58. package/dist/_chunks/fs-identity-BRKuL215.js +207 -0
  59. package/dist/_chunks/fs-identity-BRKuL215.js.map +1 -0
  60. package/dist/_chunks/graph-cache-CYiUS2aS.js +303 -0
  61. package/dist/_chunks/graph-cache-CYiUS2aS.js.map +1 -0
  62. package/dist/_chunks/href-validation-BIrxavIy.js +213 -0
  63. package/dist/_chunks/href-validation-BIrxavIy.js.map +1 -0
  64. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js +66 -0
  65. package/dist/_chunks/json-lossy-check-C8zBY2uZ.js.map +1 -0
  66. package/dist/_chunks/live-graph-tSWrv8eH.js +151 -0
  67. package/dist/_chunks/live-graph-tSWrv8eH.js.map +1 -0
  68. package/dist/_chunks/logger-CbLdcy-W.js +662 -0
  69. package/dist/_chunks/logger-CbLdcy-W.js.map +1 -0
  70. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-B3XJNyIH.js} +70 -27
  71. package/dist/_chunks/metadata-routes-B3XJNyIH.js.map +1 -0
  72. package/dist/_chunks/navigation-root-BQfo1-kG.js +126 -0
  73. package/dist/_chunks/navigation-root-BQfo1-kG.js.map +1 -0
  74. package/dist/_chunks/node-response-rkQqcFGq.js +233 -0
  75. package/dist/_chunks/node-response-rkQqcFGq.js.map +1 -0
  76. package/dist/_chunks/param-value-C8TNYchQ.js +66 -0
  77. package/dist/_chunks/param-value-C8TNYchQ.js.map +1 -0
  78. package/dist/_chunks/plugin-context-DxMMvjUt.js +329 -0
  79. package/dist/_chunks/plugin-context-DxMMvjUt.js.map +1 -0
  80. package/dist/_chunks/plugin-context-uDHFqHHJ.js +1 -0
  81. package/dist/_chunks/poison-rules-DoEhbqaY.js +110 -0
  82. package/dist/_chunks/poison-rules-DoEhbqaY.js.map +1 -0
  83. package/dist/_chunks/poison-scan-C4FgMxFl.js +99 -0
  84. package/dist/_chunks/poison-scan-C4FgMxFl.js.map +1 -0
  85. package/dist/_chunks/purge-store-WZaxu-3m.js +14 -0
  86. package/dist/_chunks/purge-store-WZaxu-3m.js.map +1 -0
  87. package/dist/_chunks/render-timeout-joFhz4KH.js +37 -0
  88. package/dist/_chunks/render-timeout-joFhz4KH.js.map +1 -0
  89. package/dist/_chunks/resolve-schema-CBR6Lm4i.js +50 -0
  90. package/dist/_chunks/resolve-schema-CBR6Lm4i.js.map +1 -0
  91. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js +243 -0
  92. package/dist/_chunks/rsc-cache-key-ClUiXQnK.js.map +1 -0
  93. package/dist/_chunks/rsc-media-type-DDc7duTD.js +61 -0
  94. package/dist/_chunks/rsc-media-type-DDc7duTD.js.map +1 -0
  95. package/dist/_chunks/rsc-payload-path-dffcs4jp.js +54 -0
  96. package/dist/_chunks/rsc-payload-path-dffcs4jp.js.map +1 -0
  97. package/dist/_chunks/scan-BoP17W3w.js +140 -0
  98. package/dist/_chunks/scan-BoP17W3w.js.map +1 -0
  99. package/dist/_chunks/scanner-Cb3fSjAC.js +2056 -0
  100. package/dist/_chunks/scanner-Cb3fSjAC.js.map +1 -0
  101. package/dist/_chunks/schema-bridge-C83xa9lT.js +199 -0
  102. package/dist/_chunks/schema-bridge-C83xa9lT.js.map +1 -0
  103. package/dist/_chunks/segment-classify-C539Pa2O.js +197 -0
  104. package/dist/_chunks/segment-classify-C539Pa2O.js.map +1 -0
  105. package/dist/_chunks/segment-context-xtPUGfdq.js +137 -0
  106. package/dist/_chunks/segment-context-xtPUGfdq.js.map +1 -0
  107. package/dist/_chunks/segment-keys-D5hu1hz4.js +62 -0
  108. package/dist/_chunks/segment-keys-D5hu1hz4.js.map +1 -0
  109. package/dist/_chunks/singleflight-BeVMMKi0.js +55 -0
  110. package/dist/_chunks/singleflight-BeVMMKi0.js.map +1 -0
  111. package/dist/_chunks/sizeof-QPE5nd3u.js +36 -0
  112. package/dist/_chunks/sizeof-QPE5nd3u.js.map +1 -0
  113. package/dist/_chunks/ssr-data-nA3I70_n.js +49 -0
  114. package/dist/_chunks/ssr-data-nA3I70_n.js.map +1 -0
  115. package/dist/_chunks/state-BhNGPsdi.js +50 -0
  116. package/dist/_chunks/state-BhNGPsdi.js.map +1 -0
  117. package/dist/_chunks/status-page-marker-BRX9Ib-d.js +564 -0
  118. package/dist/_chunks/status-page-marker-BRX9Ib-d.js.map +1 -0
  119. package/dist/_chunks/tree-match-6yihorhk.js +169 -0
  120. package/dist/_chunks/tree-match-6yihorhk.js.map +1 -0
  121. package/dist/_chunks/use-query-states-I3JMng6J.js +226 -0
  122. package/dist/_chunks/use-query-states-I3JMng6J.js.map +1 -0
  123. package/dist/_chunks/walkers-qu8TpiLh.js +144 -0
  124. package/dist/_chunks/walkers-qu8TpiLh.js.map +1 -0
  125. package/dist/_chunks/write-file-atomic-D1qWqHb4.js +32 -0
  126. package/dist/_chunks/write-file-atomic-D1qWqHb4.js.map +1 -0
  127. package/dist/adapters/build-output-helper.d.ts +72 -0
  128. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  129. package/dist/adapters/canonicalize-module.d.ts +8 -0
  130. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  131. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  132. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  133. package/dist/adapters/cloudflare-dev.js +74 -0
  134. package/dist/adapters/cloudflare-dev.js.map +1 -0
  135. package/dist/adapters/cloudflare-kv-cache.d.ts +65 -0
  136. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  137. package/dist/adapters/cloudflare-kv-cache.js +123 -0
  138. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  139. package/dist/adapters/cloudflare.d.ts +224 -24
  140. package/dist/adapters/cloudflare.d.ts.map +1 -1
  141. package/dist/adapters/cloudflare.js +1 -188
  142. package/dist/adapters/compress-module.d.ts +25 -4
  143. package/dist/adapters/compress-module.d.ts.map +1 -1
  144. package/dist/adapters/fs-identity.d.ts +63 -0
  145. package/dist/adapters/fs-identity.d.ts.map +1 -0
  146. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  147. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  148. package/dist/adapters/nitro-presets.d.ts +31 -0
  149. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  150. package/dist/adapters/nitro-preview.d.ts +65 -0
  151. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  152. package/dist/adapters/nitro.d.ts +69 -38
  153. package/dist/adapters/nitro.d.ts.map +1 -1
  154. package/dist/adapters/nitro.js +793 -341
  155. package/dist/adapters/nitro.js.map +1 -1
  156. package/dist/adapters/shared.d.ts +67 -0
  157. package/dist/adapters/shared.d.ts.map +1 -0
  158. package/dist/adapters/types.d.ts +124 -16
  159. package/dist/adapters/types.d.ts.map +1 -1
  160. package/dist/adapters/types.js +0 -0
  161. package/dist/analyze/chains.d.ts +124 -0
  162. package/dist/analyze/chains.d.ts.map +1 -0
  163. package/dist/analyze/classify.d.ts +153 -0
  164. package/dist/analyze/classify.d.ts.map +1 -0
  165. package/dist/analyze/crawl-entry.d.ts +17 -0
  166. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  167. package/dist/analyze/crawl-entry.js +314 -0
  168. package/dist/analyze/crawl-entry.js.map +1 -0
  169. package/dist/analyze/crawl.d.ts +134 -0
  170. package/dist/analyze/crawl.d.ts.map +1 -0
  171. package/dist/analyze/graph-cache.d.ts +104 -0
  172. package/dist/analyze/graph-cache.d.ts.map +1 -0
  173. package/dist/analyze/graph-command.d.ts +43 -0
  174. package/dist/analyze/graph-command.d.ts.map +1 -0
  175. package/dist/analyze/graph-command.js +472 -0
  176. package/dist/analyze/graph-command.js.map +1 -0
  177. package/dist/analyze/live-graph.d.ts +81 -0
  178. package/dist/analyze/live-graph.d.ts.map +1 -0
  179. package/dist/analyze/poison-rules.d.ts +72 -0
  180. package/dist/analyze/poison-rules.d.ts.map +1 -0
  181. package/dist/analyze/poison-scan.d.ts +48 -0
  182. package/dist/analyze/poison-scan.d.ts.map +1 -0
  183. package/dist/analyze/scan.d.ts +73 -0
  184. package/dist/analyze/scan.d.ts.map +1 -0
  185. package/dist/cache/cache-api.d.ts +48 -0
  186. package/dist/cache/cache-api.d.ts.map +1 -0
  187. package/dist/cache/fast-hash.d.ts +5 -0
  188. package/dist/cache/fast-hash.d.ts.map +1 -1
  189. package/dist/cache/handler-store.d.ts +45 -0
  190. package/dist/cache/handler-store.d.ts.map +1 -0
  191. package/dist/cache/index.d.ts +32 -9
  192. package/dist/cache/index.d.ts.map +1 -1
  193. package/dist/cache/index.js +4 -326
  194. package/dist/cache/invalidation-epoch.d.ts +50 -0
  195. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  196. package/dist/cache/json-lossy-check.d.ts +11 -0
  197. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  198. package/dist/cache/redis-handler.d.ts +141 -9
  199. package/dist/cache/redis-handler.d.ts.map +1 -1
  200. package/dist/cache/singleflight.d.ts +21 -2
  201. package/dist/cache/singleflight.d.ts.map +1 -1
  202. package/dist/cache/sizeof.d.ts +22 -0
  203. package/dist/cache/sizeof.d.ts.map +1 -0
  204. package/dist/cache/stable-stringify.d.ts +9 -0
  205. package/dist/cache/stable-stringify.d.ts.map +1 -1
  206. package/dist/cache/store.d.ts +53 -0
  207. package/dist/cache/store.d.ts.map +1 -0
  208. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  209. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  210. package/dist/cache/stores/cloudflare-kv.js +29 -0
  211. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  212. package/dist/cache/stores/memory.d.ts +42 -0
  213. package/dist/cache/stores/memory.d.ts.map +1 -0
  214. package/dist/cache/stores/memory.js +90 -0
  215. package/dist/cache/stores/memory.js.map +1 -0
  216. package/dist/cache/stores/redis.d.ts +69 -0
  217. package/dist/cache/stores/redis.d.ts.map +1 -0
  218. package/dist/cache/stores/redis.js +35 -0
  219. package/dist/cache/stores/redis.js.map +1 -0
  220. package/dist/cache/stores/vercel.d.ts +36 -0
  221. package/dist/cache/stores/vercel.d.ts.map +1 -0
  222. package/dist/cache/stores/vercel.js +33 -0
  223. package/dist/cache/stores/vercel.js.map +1 -0
  224. package/dist/cache/tag-aware-handler.d.ts +52 -0
  225. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  226. package/dist/cache/timber-cache.d.ts +21 -11
  227. package/dist/cache/timber-cache.d.ts.map +1 -1
  228. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  229. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  230. package/dist/cdn/cloudflare-purge.js +30 -0
  231. package/dist/cdn/cloudflare-purge.js.map +1 -0
  232. package/dist/cdn/fastly-purge.d.ts +25 -0
  233. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  234. package/dist/cdn/fastly-purge.js +33 -0
  235. package/dist/cdn/fastly-purge.js.map +1 -0
  236. package/dist/cdn/headers.d.ts +97 -0
  237. package/dist/cdn/headers.d.ts.map +1 -0
  238. package/dist/cdn/index.d.ts +5 -0
  239. package/dist/cdn/index.d.ts.map +1 -0
  240. package/dist/cdn/index.js +94 -0
  241. package/dist/cdn/index.js.map +1 -0
  242. package/dist/cdn/purge-store.d.ts +32 -0
  243. package/dist/cdn/purge-store.d.ts.map +1 -0
  244. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  245. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  246. package/dist/cdn/workers-cache-purge.js +35 -0
  247. package/dist/cdn/workers-cache-purge.js.map +1 -0
  248. package/dist/cli-check.d.ts +133 -0
  249. package/dist/cli-check.d.ts.map +1 -0
  250. package/dist/cli-context.d.ts +54 -0
  251. package/dist/cli-context.d.ts.map +1 -0
  252. package/dist/cli-schema-sync.d.ts +59 -0
  253. package/dist/cli-schema-sync.d.ts.map +1 -0
  254. package/dist/cli.d.ts +88 -16
  255. package/dist/cli.d.ts.map +1 -1
  256. package/dist/cli.js +225 -63
  257. package/dist/cli.js.map +1 -1
  258. package/dist/client/browser-dev.d.ts +42 -2
  259. package/dist/client/browser-dev.d.ts.map +1 -1
  260. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  261. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  262. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  263. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  264. package/dist/client/browser-entry/form-state.d.ts +22 -0
  265. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  266. package/dist/client/browser-entry/hmr.d.ts +21 -0
  267. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  268. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  269. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  270. package/dist/client/browser-entry/index.d.ts +32 -0
  271. package/dist/client/browser-entry/index.d.ts.map +1 -0
  272. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  273. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  274. package/dist/client/browser-entry/router-init.d.ts +41 -0
  275. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  276. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  277. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  278. package/dist/client/browser-entry/scroll.d.ts +28 -0
  279. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  280. package/dist/client/deny-last-resort.d.ts +29 -0
  281. package/dist/client/deny-last-resort.d.ts.map +1 -0
  282. package/dist/client/error-boundary.d.ts +58 -9
  283. package/dist/client/error-boundary.d.ts.map +1 -1
  284. package/dist/client/error-boundary.js +1 -126
  285. package/dist/client/error-reconstituter.d.ts +55 -0
  286. package/dist/client/error-reconstituter.d.ts.map +1 -0
  287. package/dist/client/form.d.ts +38 -99
  288. package/dist/client/form.d.ts.map +1 -1
  289. package/dist/client/global-context.d.ts +15 -0
  290. package/dist/client/global-context.d.ts.map +1 -0
  291. package/dist/client/history.d.ts +50 -9
  292. package/dist/client/history.d.ts.map +1 -1
  293. package/dist/client/index.d.ts +21 -33
  294. package/dist/client/index.d.ts.map +1 -1
  295. package/dist/client/index.js +423 -1227
  296. package/dist/client/index.js.map +1 -1
  297. package/dist/client/internal.d.ts +20 -0
  298. package/dist/client/internal.d.ts.map +1 -0
  299. package/dist/client/internal.js +781 -0
  300. package/dist/client/internal.js.map +1 -0
  301. package/dist/client/link.d.ts +85 -60
  302. package/dist/client/link.d.ts.map +1 -1
  303. package/dist/client/location-search.d.ts +12 -0
  304. package/dist/client/location-search.d.ts.map +1 -0
  305. package/dist/client/navigation-api.d.ts +95 -0
  306. package/dist/client/navigation-api.d.ts.map +1 -0
  307. package/dist/client/navigation-commit.d.ts +111 -0
  308. package/dist/client/navigation-commit.d.ts.map +1 -0
  309. package/dist/client/navigation-context.d.ts +54 -36
  310. package/dist/client/navigation-context.d.ts.map +1 -1
  311. package/dist/client/navigation-root.d.ts +106 -0
  312. package/dist/client/navigation-root.d.ts.map +1 -0
  313. package/dist/client/navigation-transition.d.ts +255 -0
  314. package/dist/client/navigation-transition.d.ts.map +1 -0
  315. package/dist/client/nuqs-adapter.d.ts +1 -1
  316. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  317. package/dist/client/params-context.d.ts +81 -0
  318. package/dist/client/params-context.d.ts.map +1 -0
  319. package/dist/client/react-root.d.ts +51 -0
  320. package/dist/client/react-root.d.ts.map +1 -0
  321. package/dist/client/router-effects.d.ts +203 -0
  322. package/dist/client/router-effects.d.ts.map +1 -0
  323. package/dist/client/router-lifecycle.d.ts +104 -0
  324. package/dist/client/router-lifecycle.d.ts.map +1 -0
  325. package/dist/client/router-pipeline.d.ts +81 -0
  326. package/dist/client/router-pipeline.d.ts.map +1 -0
  327. package/dist/client/router-ref.d.ts +2 -2
  328. package/dist/client/router-ref.d.ts.map +1 -1
  329. package/dist/client/router-skew.d.ts +21 -0
  330. package/dist/client/router-skew.d.ts.map +1 -0
  331. package/dist/client/router-types.d.ts +294 -0
  332. package/dist/client/router-types.d.ts.map +1 -0
  333. package/dist/client/router-url.d.ts +24 -0
  334. package/dist/client/router-url.d.ts.map +1 -0
  335. package/dist/client/router.d.ts +1 -97
  336. package/dist/client/router.d.ts.map +1 -1
  337. package/dist/client/rsc-fetch.d.ts +110 -28
  338. package/dist/client/rsc-fetch.d.ts.map +1 -1
  339. package/dist/client/segment-cache.d.ts +186 -25
  340. package/dist/client/segment-cache.d.ts.map +1 -1
  341. package/dist/client/segment-context.d.ts.map +1 -1
  342. package/dist/client/segment-outlet.d.ts +68 -0
  343. package/dist/client/segment-outlet.d.ts.map +1 -0
  344. package/dist/client/segment-update-context.d.ts +15 -0
  345. package/dist/client/segment-update-context.d.ts.map +1 -0
  346. package/dist/client/shallow-url.d.ts +10 -0
  347. package/dist/client/shallow-url.d.ts.map +1 -0
  348. package/dist/client/slot-content-cache-context.d.ts +35 -0
  349. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  350. package/dist/client/slot-context.d.ts +31 -0
  351. package/dist/client/slot-context.d.ts.map +1 -0
  352. package/dist/client/slot-outlet.d.ts +16 -0
  353. package/dist/client/slot-outlet.d.ts.map +1 -0
  354. package/dist/client/slot-provider.d.ts +25 -0
  355. package/dist/client/slot-provider.d.ts.map +1 -0
  356. package/dist/client/ssr-data.d.ts +26 -50
  357. package/dist/client/ssr-data.d.ts.map +1 -1
  358. package/dist/client/stale-client.d.ts +69 -0
  359. package/dist/client/stale-client.d.ts.map +1 -0
  360. package/dist/client/state.d.ts +21 -13
  361. package/dist/client/state.d.ts.map +1 -1
  362. package/dist/client/status-page-marker.d.ts +25 -0
  363. package/dist/client/status-page-marker.d.ts.map +1 -0
  364. package/dist/client/top-loader.d.ts +7 -6
  365. package/dist/client/top-loader.d.ts.map +1 -1
  366. package/dist/client/unload-guard.d.ts +5 -0
  367. package/dist/client/unload-guard.d.ts.map +1 -1
  368. package/dist/client/use-cookie.d.ts +12 -0
  369. package/dist/client/use-cookie.d.ts.map +1 -1
  370. package/dist/client/use-field-state.d.ts +42 -0
  371. package/dist/client/use-field-state.d.ts.map +1 -0
  372. package/dist/client/use-link-status.d.ts +5 -5
  373. package/dist/client/use-link-status.d.ts.map +1 -1
  374. package/dist/client/use-pathname.d.ts +13 -11
  375. package/dist/client/use-pathname.d.ts.map +1 -1
  376. package/dist/client/use-pending-navigation.d.ts +23 -0
  377. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  378. package/dist/client/use-query-states.d.ts +10 -4
  379. package/dist/client/use-query-states.d.ts.map +1 -1
  380. package/dist/client/use-router.d.ts +15 -8
  381. package/dist/client/use-router.d.ts.map +1 -1
  382. package/dist/client/use-search-params.d.ts +15 -8
  383. package/dist/client/use-search-params.d.ts.map +1 -1
  384. package/dist/client/use-segment-params.d.ts +55 -0
  385. package/dist/client/use-segment-params.d.ts.map +1 -0
  386. package/dist/codec.d.ts +69 -0
  387. package/dist/codec.d.ts.map +1 -0
  388. package/dist/codec.js +76 -0
  389. package/dist/codec.js.map +1 -0
  390. package/dist/config-types.d.ts +321 -0
  391. package/dist/config-types.d.ts.map +1 -0
  392. package/dist/config-validation.d.ts +68 -0
  393. package/dist/config-validation.d.ts.map +1 -0
  394. package/dist/cookies/define-cookie.d.ts +58 -25
  395. package/dist/cookies/define-cookie.d.ts.map +1 -1
  396. package/dist/cookies/index.d.ts +3 -2
  397. package/dist/cookies/index.d.ts.map +1 -1
  398. package/dist/cookies/index.js +256 -36
  399. package/dist/cookies/index.js.map +1 -1
  400. package/dist/cookies/json-cookie.d.ts +64 -0
  401. package/dist/cookies/json-cookie.d.ts.map +1 -0
  402. package/dist/cookies/validation.d.ts +34 -0
  403. package/dist/cookies/validation.d.ts.map +1 -0
  404. package/dist/dev-tools/404-page.d.ts +50 -0
  405. package/dist/dev-tools/404-page.d.ts.map +1 -0
  406. package/dist/dev-tools/browser-logs.d.ts +40 -0
  407. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  408. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  409. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  410. package/dist/dev-tools/error-page.d.ts +32 -0
  411. package/dist/dev-tools/error-page.d.ts.map +1 -0
  412. package/dist/dev-tools/holding-server.d.ts +46 -0
  413. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  414. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  415. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  416. package/dist/dev-tools/index.d.ts +31 -0
  417. package/dist/dev-tools/index.d.ts.map +1 -0
  418. package/dist/dev-tools/instrumentation.d.ts +74 -0
  419. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  420. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  421. package/dist/dev-tools/logger.d.ts.map +1 -0
  422. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  423. package/dist/dev-tools/logs.d.ts.map +1 -0
  424. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  425. package/dist/dev-tools/overlay.d.ts.map +1 -0
  426. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  427. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  428. package/dist/dev-tools/terminal.d.ts +28 -0
  429. package/dist/dev-tools/terminal.d.ts.map +1 -0
  430. package/dist/fonts/ast-walk.d.ts +68 -0
  431. package/dist/fonts/ast-walk.d.ts.map +1 -0
  432. package/dist/fonts/ast.d.ts +112 -8
  433. package/dist/fonts/ast.d.ts.map +1 -1
  434. package/dist/fonts/bundle.d.ts +50 -0
  435. package/dist/fonts/bundle.d.ts.map +1 -0
  436. package/dist/fonts/css.d.ts +1 -1
  437. package/dist/fonts/dev-middleware.d.ts +22 -0
  438. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  439. package/dist/fonts/fallbacks.d.ts +0 -7
  440. package/dist/fonts/fallbacks.d.ts.map +1 -1
  441. package/dist/fonts/google.d.ts +5 -3
  442. package/dist/fonts/google.d.ts.map +1 -1
  443. package/dist/fonts/local.d.ts +5 -5
  444. package/dist/fonts/local.d.ts.map +1 -1
  445. package/dist/fonts/paths.d.ts +43 -0
  446. package/dist/fonts/paths.d.ts.map +1 -0
  447. package/dist/fonts/pipeline.d.ts +177 -0
  448. package/dist/fonts/pipeline.d.ts.map +1 -0
  449. package/dist/fonts/transform.d.ts +82 -0
  450. package/dist/fonts/transform.d.ts.map +1 -0
  451. package/dist/fonts/types.d.ts +47 -1
  452. package/dist/fonts/types.d.ts.map +1 -1
  453. package/dist/fonts/virtual-modules.d.ts +77 -0
  454. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  455. package/dist/index.d.ts +35 -181
  456. package/dist/index.d.ts.map +1 -1
  457. package/dist/index.js +8972 -14234
  458. package/dist/index.js.map +1 -1
  459. package/dist/params/codec-registry.d.ts +26 -0
  460. package/dist/params/codec-registry.d.ts.map +1 -0
  461. package/dist/params/define-schema.d.ts +81 -0
  462. package/dist/params/define-schema.d.ts.map +1 -0
  463. package/dist/params/index.d.ts +5 -0
  464. package/dist/params/index.d.ts.map +1 -0
  465. package/dist/params/index.js +34 -0
  466. package/dist/params/index.js.map +1 -0
  467. package/dist/params/resolve-schema.d.ts +34 -0
  468. package/dist/params/resolve-schema.d.ts.map +1 -0
  469. package/dist/plugin-context.d.ts +262 -0
  470. package/dist/plugin-context.d.ts.map +1 -0
  471. package/dist/plugins/build-manifest.d.ts +7 -3
  472. package/dist/plugins/build-manifest.d.ts.map +1 -1
  473. package/dist/plugins/build-report.d.ts +61 -11
  474. package/dist/plugins/build-report.d.ts.map +1 -1
  475. package/dist/plugins/cache.d.ts +64 -0
  476. package/dist/plugins/cache.d.ts.map +1 -0
  477. package/dist/plugins/callsite-ast.d.ts +117 -0
  478. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  479. package/dist/plugins/callsite-jsx.d.ts +35 -0
  480. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  481. package/dist/plugins/chunks.d.ts +11 -4
  482. package/dist/plugins/chunks.d.ts.map +1 -1
  483. package/dist/plugins/client-chunks.d.ts +40 -0
  484. package/dist/plugins/client-chunks.d.ts.map +1 -0
  485. package/dist/plugins/client-dep-entries.d.ts +80 -0
  486. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  487. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  488. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  489. package/dist/plugins/content.d.ts +1 -1
  490. package/dist/plugins/content.d.ts.map +1 -1
  491. package/dist/plugins/dev-discovery.d.ts +123 -0
  492. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  493. package/dist/plugins/dev-server.d.ts +24 -1
  494. package/dist/plugins/dev-server.d.ts.map +1 -1
  495. package/dist/plugins/encryption-runtime.d.ts +13 -0
  496. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  497. package/dist/plugins/entries.d.ts +40 -4
  498. package/dist/plugins/entries.d.ts.map +1 -1
  499. package/dist/plugins/fonts.d.ts +35 -74
  500. package/dist/plugins/fonts.d.ts.map +1 -1
  501. package/dist/plugins/graph-endpoint.d.ts +112 -0
  502. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  503. package/dist/plugins/mdx.d.ts +18 -5
  504. package/dist/plugins/mdx.d.ts.map +1 -1
  505. package/dist/plugins/orphaned-modules.d.ts +57 -0
  506. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  507. package/dist/plugins/post-build.d.ts +110 -0
  508. package/dist/plugins/post-build.d.ts.map +1 -0
  509. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  510. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  511. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  512. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  513. package/dist/plugins/prebuilt.d.ts +98 -0
  514. package/dist/plugins/prebuilt.d.ts.map +1 -0
  515. package/dist/plugins/prerender-sugar.d.ts +39 -0
  516. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  517. package/dist/plugins/react-resolve.d.ts +49 -0
  518. package/dist/plugins/react-resolve.d.ts.map +1 -0
  519. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  520. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  521. package/dist/plugins/request-dep/index.d.ts +75 -0
  522. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  523. package/dist/plugins/request-dep/origin.d.ts +61 -0
  524. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  525. package/dist/plugins/routing.d.ts +2 -2
  526. package/dist/plugins/routing.d.ts.map +1 -1
  527. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  528. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  529. package/dist/plugins/server-bundle.d.ts +1 -1
  530. package/dist/plugins/server-bundle.d.ts.map +1 -1
  531. package/dist/plugins/shims.d.ts +29 -5
  532. package/dist/plugins/shims.d.ts.map +1 -1
  533. package/dist/plugins/static-build.d.ts +246 -26
  534. package/dist/plugins/static-build.d.ts.map +1 -1
  535. package/dist/routing/codegen-shared.d.ts +26 -0
  536. package/dist/routing/codegen-shared.d.ts.map +1 -0
  537. package/dist/routing/codegen-types.d.ts +61 -0
  538. package/dist/routing/codegen-types.d.ts.map +1 -0
  539. package/dist/routing/codegen-write.d.ts +42 -0
  540. package/dist/routing/codegen-write.d.ts.map +1 -0
  541. package/dist/routing/codegen.d.ts +8 -3
  542. package/dist/routing/codegen.d.ts.map +1 -1
  543. package/dist/routing/collision-probe.d.ts +104 -0
  544. package/dist/routing/collision-probe.d.ts.map +1 -0
  545. package/dist/routing/collision-spaces.d.ts +26 -0
  546. package/dist/routing/collision-spaces.d.ts.map +1 -0
  547. package/dist/routing/convention-lint.d.ts +55 -0
  548. package/dist/routing/convention-lint.d.ts.map +1 -0
  549. package/dist/routing/export-detect.d.ts +91 -0
  550. package/dist/routing/export-detect.d.ts.map +1 -0
  551. package/dist/routing/file-cache.d.ts +8 -0
  552. package/dist/routing/file-cache.d.ts.map +1 -0
  553. package/dist/routing/index.d.ts +13 -7
  554. package/dist/routing/index.d.ts.map +1 -1
  555. package/dist/routing/index.js +5 -2
  556. package/dist/routing/interception-overlap.d.ts +35 -0
  557. package/dist/routing/interception-overlap.d.ts.map +1 -0
  558. package/dist/routing/interception.d.ts +234 -10
  559. package/dist/routing/interception.d.ts.map +1 -1
  560. package/dist/routing/link-codegen.d.ts +105 -0
  561. package/dist/routing/link-codegen.d.ts.map +1 -0
  562. package/dist/routing/manifest-codegen.d.ts +26 -0
  563. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  564. package/dist/routing/scanner.d.ts +14 -10
  565. package/dist/routing/scanner.d.ts.map +1 -1
  566. package/dist/routing/schema-validation.d.ts +35 -0
  567. package/dist/routing/schema-validation.d.ts.map +1 -0
  568. package/dist/routing/segment-classify.d.ts +114 -0
  569. package/dist/routing/segment-classify.d.ts.map +1 -0
  570. package/dist/routing/segment-codegen.d.ts +38 -0
  571. package/dist/routing/segment-codegen.d.ts.map +1 -0
  572. package/dist/routing/segment-keys.d.ts +118 -0
  573. package/dist/routing/segment-keys.d.ts.map +1 -0
  574. package/dist/routing/slot-placement.d.ts +48 -0
  575. package/dist/routing/slot-placement.d.ts.map +1 -0
  576. package/dist/routing/types.d.ts +81 -26
  577. package/dist/routing/types.d.ts.map +1 -1
  578. package/dist/routing/walkers.d.ts +57 -0
  579. package/dist/routing/walkers.d.ts.map +1 -0
  580. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  581. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  582. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  583. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  584. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  585. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  586. package/dist/rsc-runtime/rsc.d.ts +2 -13
  587. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  588. package/dist/rsc-runtime/ssr.d.ts +7 -10
  589. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  590. package/dist/rsc-runtime/transforms.d.ts +13 -0
  591. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  592. package/dist/schema-bridge.d.ts +145 -0
  593. package/dist/schema-bridge.d.ts.map +1 -0
  594. package/dist/search-params/define.d.ts +262 -0
  595. package/dist/search-params/define.d.ts.map +1 -0
  596. package/dist/search-params/index.d.ts +3 -7
  597. package/dist/search-params/index.d.ts.map +1 -1
  598. package/dist/search-params/index.js +179 -360
  599. package/dist/search-params/index.js.map +1 -1
  600. package/dist/search-params/parse-total.d.ts +81 -0
  601. package/dist/search-params/parse-total.d.ts.map +1 -0
  602. package/dist/search-params/serialize-equal.d.ts +9 -0
  603. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  604. package/dist/search-params/wrappers.d.ts +76 -0
  605. package/dist/search-params/wrappers.d.ts.map +1 -0
  606. package/dist/server/abort-scope.d.ts +27 -0
  607. package/dist/server/abort-scope.d.ts.map +1 -0
  608. package/dist/server/access-gate.d.ts +98 -10
  609. package/dist/server/access-gate.d.ts.map +1 -1
  610. package/dist/server/action-client.d.ts +20 -133
  611. package/dist/server/action-client.d.ts.map +1 -1
  612. package/dist/server/action-encryption.d.ts +76 -0
  613. package/dist/server/action-encryption.d.ts.map +1 -0
  614. package/dist/server/action-handler.d.ts +58 -11
  615. package/dist/server/action-handler.d.ts.map +1 -1
  616. package/dist/server/action-schema.d.ts +126 -0
  617. package/dist/server/action-schema.d.ts.map +1 -0
  618. package/dist/server/action-types.d.ts +108 -0
  619. package/dist/server/action-types.d.ts.map +1 -0
  620. package/dist/server/actions.d.ts +78 -40
  621. package/dist/server/actions.d.ts.map +1 -1
  622. package/dist/server/als-registry.d.ts +189 -17
  623. package/dist/server/als-registry.d.ts.map +1 -1
  624. package/dist/server/body-limits.d.ts.map +1 -1
  625. package/dist/server/build-manifest.d.ts +25 -30
  626. package/dist/server/build-manifest.d.ts.map +1 -1
  627. package/dist/server/canonicalize.d.ts +32 -0
  628. package/dist/server/canonicalize.d.ts.map +1 -1
  629. package/dist/server/chain-url-parts.d.ts +82 -0
  630. package/dist/server/chain-url-parts.d.ts.map +1 -0
  631. package/dist/server/children-interception.d.ts +49 -0
  632. package/dist/server/children-interception.d.ts.map +1 -0
  633. package/dist/server/client-error-message.d.ts +12 -0
  634. package/dist/server/client-error-message.d.ts.map +1 -0
  635. package/dist/server/coalesce-tick.d.ts +40 -0
  636. package/dist/server/coalesce-tick.d.ts.map +1 -0
  637. package/dist/server/compress.d.ts +2 -0
  638. package/dist/server/compress.d.ts.map +1 -1
  639. package/dist/server/cookie-context.d.ts +149 -0
  640. package/dist/server/cookie-context.d.ts.map +1 -0
  641. package/dist/server/cookie-parsing.d.ts +65 -0
  642. package/dist/server/cookie-parsing.d.ts.map +1 -0
  643. package/dist/server/csp-nonce.d.ts +36 -0
  644. package/dist/server/csp-nonce.d.ts.map +1 -0
  645. package/dist/server/csrf.d.ts +58 -15
  646. package/dist/server/csrf.d.ts.map +1 -1
  647. package/dist/server/debug.d.ts +0 -1
  648. package/dist/server/debug.d.ts.map +1 -1
  649. package/dist/server/default-logger.d.ts +23 -0
  650. package/dist/server/default-logger.d.ts.map +1 -0
  651. package/dist/server/default-status-page.d.ts +45 -0
  652. package/dist/server/default-status-page.d.ts.map +1 -0
  653. package/dist/server/deny-boundary.d.ts +257 -0
  654. package/dist/server/deny-boundary.d.ts.map +1 -0
  655. package/dist/server/deny-renderer.d.ts +22 -15
  656. package/dist/server/deny-renderer.d.ts.map +1 -1
  657. package/dist/server/early-hints-sender.d.ts.map +1 -1
  658. package/dist/server/early-hints.d.ts +14 -12
  659. package/dist/server/early-hints.d.ts.map +1 -1
  660. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  661. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  662. package/dist/server/error-response-headers.d.ts +3 -0
  663. package/dist/server/error-response-headers.d.ts.map +1 -0
  664. package/dist/server/fallback-error.d.ts +19 -7
  665. package/dist/server/fallback-error.d.ts.map +1 -1
  666. package/dist/server/flight-injection-state.d.ts +66 -0
  667. package/dist/server/flight-injection-state.d.ts.map +1 -0
  668. package/dist/server/flight-injector-core.d.ts +125 -0
  669. package/dist/server/flight-injector-core.d.ts.map +1 -0
  670. package/dist/server/flight-scripts.d.ts +63 -0
  671. package/dist/server/flight-scripts.d.ts.map +1 -0
  672. package/dist/server/flight-source-node.d.ts +105 -0
  673. package/dist/server/flight-source-node.d.ts.map +1 -0
  674. package/dist/server/flight-source.d.ts +136 -0
  675. package/dist/server/flight-source.d.ts.map +1 -0
  676. package/dist/server/form-data.d.ts +59 -2
  677. package/dist/server/form-data.d.ts.map +1 -1
  678. package/dist/server/form-state-flight.d.ts +32 -0
  679. package/dist/server/form-state-flight.d.ts.map +1 -0
  680. package/dist/server/head-response.d.ts +35 -0
  681. package/dist/server/head-response.d.ts.map +1 -0
  682. package/dist/server/html-injector-core.d.ts +169 -0
  683. package/dist/server/html-injector-core.d.ts.map +1 -0
  684. package/dist/server/html-injectors.d.ts +77 -47
  685. package/dist/server/html-injectors.d.ts.map +1 -1
  686. package/dist/server/index.d.ts +16 -54
  687. package/dist/server/index.d.ts.map +1 -1
  688. package/dist/server/index.js +638 -3021
  689. package/dist/server/index.js.map +1 -1
  690. package/dist/server/instrumentation.d.ts +13 -5
  691. package/dist/server/instrumentation.d.ts.map +1 -1
  692. package/dist/server/internal.d.ts +47 -0
  693. package/dist/server/internal.d.ts.map +1 -0
  694. package/dist/server/internal.js +4845 -0
  695. package/dist/server/internal.js.map +1 -0
  696. package/dist/server/json-status-response.d.ts +34 -0
  697. package/dist/server/json-status-response.d.ts.map +1 -0
  698. package/dist/server/logger.d.ts +79 -7
  699. package/dist/server/logger.d.ts.map +1 -1
  700. package/dist/server/metadata-collector.d.ts +75 -0
  701. package/dist/server/metadata-collector.d.ts.map +1 -0
  702. package/dist/server/metadata-platform.d.ts +2 -2
  703. package/dist/server/metadata-render.d.ts +2 -2
  704. package/dist/server/metadata-render.d.ts.map +1 -1
  705. package/dist/server/metadata-route-links.d.ts +70 -0
  706. package/dist/server/metadata-route-links.d.ts.map +1 -0
  707. package/dist/server/metadata-routes.d.ts +47 -11
  708. package/dist/server/metadata-routes.d.ts.map +1 -1
  709. package/dist/server/metadata-social.d.ts +2 -2
  710. package/dist/server/metadata.d.ts +10 -2
  711. package/dist/server/metadata.d.ts.map +1 -1
  712. package/dist/server/middleware-runner.d.ts +20 -5
  713. package/dist/server/middleware-runner.d.ts.map +1 -1
  714. package/dist/server/node-body-response.d.ts +55 -0
  715. package/dist/server/node-body-response.d.ts.map +1 -0
  716. package/dist/server/node-response.d.ts +62 -0
  717. package/dist/server/node-response.d.ts.map +1 -0
  718. package/dist/server/node-stream-transforms.d.ts +108 -0
  719. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  720. package/dist/server/node-streams-platform.d.ts +21 -0
  721. package/dist/server/node-streams-platform.d.ts.map +1 -0
  722. package/dist/server/nuqs-ssr-provider.d.ts +7 -3
  723. package/dist/server/nuqs-ssr-provider.d.ts.map +1 -1
  724. package/dist/server/param-coercion.d.ts +83 -0
  725. package/dist/server/param-coercion.d.ts.map +1 -0
  726. package/dist/server/pipeline-helpers.d.ts +224 -0
  727. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  728. package/dist/server/pipeline-interception.d.ts +70 -9
  729. package/dist/server/pipeline-interception.d.ts.map +1 -1
  730. package/dist/server/pipeline-metadata.d.ts +16 -1
  731. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  732. package/dist/server/pipeline-outcome.d.ts +59 -0
  733. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  734. package/dist/server/pipeline-phases.d.ts +70 -0
  735. package/dist/server/pipeline-phases.d.ts.map +1 -0
  736. package/dist/server/pipeline.d.ts +164 -23
  737. package/dist/server/pipeline.d.ts.map +1 -1
  738. package/dist/server/port-resolution.d.ts +22 -0
  739. package/dist/server/port-resolution.d.ts.map +1 -0
  740. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  741. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  742. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  743. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  744. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  745. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  746. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  747. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  748. package/dist/server/prebuilt/dev-store.d.ts +103 -0
  749. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  750. package/dist/server/prebuilt/key-discipline.d.ts +52 -0
  751. package/dist/server/prebuilt/key-discipline.d.ts.map +1 -0
  752. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  753. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  754. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  755. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  756. package/dist/server/prebuilt/overlay.d.ts +105 -0
  757. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  758. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  759. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  760. package/dist/server/prebuilt/slots.d.ts +105 -0
  761. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  762. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  763. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  764. package/dist/server/prebuilt-builder.d.ts +121 -0
  765. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  766. package/dist/server/prebuilt-runtime.d.ts +105 -0
  767. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  768. package/dist/server/primitives.d.ts +101 -90
  769. package/dist/server/primitives.d.ts.map +1 -1
  770. package/dist/server/publish-params.d.ts +33 -0
  771. package/dist/server/publish-params.d.ts.map +1 -0
  772. package/dist/server/react-cache-bridge.d.ts +59 -0
  773. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  774. package/dist/server/react-cache-scope.d.ts +49 -0
  775. package/dist/server/react-cache-scope.d.ts.map +1 -0
  776. package/dist/server/render-timeout.d.ts +66 -0
  777. package/dist/server/render-timeout.d.ts.map +1 -0
  778. package/dist/server/render-utils.d.ts +35 -0
  779. package/dist/server/render-utils.d.ts.map +1 -0
  780. package/dist/server/request-context.d.ts +153 -103
  781. package/dist/server/request-context.d.ts.map +1 -1
  782. package/dist/server/request-dep.d.ts +15 -0
  783. package/dist/server/request-dep.d.ts.map +1 -0
  784. package/dist/server/response-cache-policy.d.ts +3 -0
  785. package/dist/server/response-cache-policy.d.ts.map +1 -0
  786. package/dist/server/route-element-builder.d.ts +57 -30
  787. package/dist/server/route-element-builder.d.ts.map +1 -1
  788. package/dist/server/route-element-helpers.d.ts +12 -0
  789. package/dist/server/route-element-helpers.d.ts.map +1 -0
  790. package/dist/server/route-handler.d.ts +1 -1
  791. package/dist/server/route-handler.d.ts.map +1 -1
  792. package/dist/server/route-matcher.d.ts +62 -38
  793. package/dist/server/route-matcher.d.ts.map +1 -1
  794. package/dist/server/route-module-loader.d.ts +37 -0
  795. package/dist/server/route-module-loader.d.ts.map +1 -0
  796. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  797. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  798. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  799. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  800. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  801. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  802. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  803. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  804. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  805. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  806. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  807. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  808. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  809. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  810. package/dist/server/rsc-entry/index.d.ts +30 -6
  811. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  812. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  813. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  814. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  815. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  816. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  817. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  818. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  819. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  820. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  821. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  822. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  823. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  824. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  825. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  826. package/dist/server/rsc-error-envelope.d.ts +11 -0
  827. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  828. package/dist/server/safe-load.d.ts +39 -0
  829. package/dist/server/safe-load.d.ts.map +1 -0
  830. package/dist/server/schema-introspection.d.ts +68 -0
  831. package/dist/server/schema-introspection.d.ts.map +1 -0
  832. package/dist/server/sensitive-fields.d.ts +88 -0
  833. package/dist/server/sensitive-fields.d.ts.map +1 -0
  834. package/dist/server/signal-identity.d.ts +43 -0
  835. package/dist/server/signal-identity.d.ts.map +1 -0
  836. package/dist/server/sitemap-generator.d.ts +130 -0
  837. package/dist/server/sitemap-generator.d.ts.map +1 -0
  838. package/dist/server/sitemap-handler.d.ts +22 -0
  839. package/dist/server/sitemap-handler.d.ts.map +1 -0
  840. package/dist/server/skippable-prefix.d.ts +29 -0
  841. package/dist/server/skippable-prefix.d.ts.map +1 -0
  842. package/dist/server/slot-interception.d.ts +80 -0
  843. package/dist/server/slot-interception.d.ts.map +1 -0
  844. package/dist/server/slot-resolver.d.ts +138 -7
  845. package/dist/server/slot-resolver.d.ts.map +1 -1
  846. package/dist/server/slot-subtree-contain.d.ts +54 -0
  847. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  848. package/dist/server/ssr-bridge-types.d.ts +213 -0
  849. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  850. package/dist/server/ssr-entry.d.ts +15 -51
  851. package/dist/server/ssr-entry.d.ts.map +1 -1
  852. package/dist/server/ssr-form-state.d.ts +30 -0
  853. package/dist/server/ssr-form-state.d.ts.map +1 -0
  854. package/dist/server/ssr-render.d.ts +59 -32
  855. package/dist/server/ssr-render.d.ts.map +1 -1
  856. package/dist/server/ssr-wrappers.d.ts +93 -0
  857. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  858. package/dist/server/state-tree-diff.d.ts +44 -9
  859. package/dist/server/state-tree-diff.d.ts.map +1 -1
  860. package/dist/server/static-generator.d.ts +112 -0
  861. package/dist/server/static-generator.d.ts.map +1 -0
  862. package/dist/server/static-not-found.d.ts +52 -0
  863. package/dist/server/static-not-found.d.ts.map +1 -0
  864. package/dist/server/status-code-resolver.d.ts +26 -15
  865. package/dist/server/status-code-resolver.d.ts.map +1 -1
  866. package/dist/server/stream-utils.d.ts +93 -0
  867. package/dist/server/stream-utils.d.ts.map +1 -0
  868. package/dist/server/tracing.d.ts +57 -26
  869. package/dist/server/tracing.d.ts.map +1 -1
  870. package/dist/server/tree-match.d.ts +59 -0
  871. package/dist/server/tree-match.d.ts.map +1 -0
  872. package/dist/server/types.d.ts +89 -8
  873. package/dist/server/types.d.ts.map +1 -1
  874. package/dist/server/utils/element-type.d.ts +50 -0
  875. package/dist/server/utils/element-type.d.ts.map +1 -0
  876. package/dist/server/utils/escape-html.d.ts +14 -0
  877. package/dist/server/utils/escape-html.d.ts.map +1 -0
  878. package/dist/server/version-skew.d.ts +61 -0
  879. package/dist/server/version-skew.d.ts.map +1 -0
  880. package/dist/server/workers-cache-bridge.d.ts +26 -0
  881. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  882. package/dist/shared/als-slots.d.ts +42 -0
  883. package/dist/shared/als-slots.d.ts.map +1 -0
  884. package/dist/shared/base-path.d.ts +56 -0
  885. package/dist/shared/base-path.d.ts.map +1 -0
  886. package/dist/shared/csrf-reject.d.ts +16 -0
  887. package/dist/shared/csrf-reject.d.ts.map +1 -0
  888. package/dist/shared/error-digest.d.ts +28 -0
  889. package/dist/shared/error-digest.d.ts.map +1 -0
  890. package/dist/shared/flight-base64.d.ts +13 -0
  891. package/dist/shared/flight-base64.d.ts.map +1 -0
  892. package/dist/shared/flight-segment.d.ts +18 -0
  893. package/dist/shared/flight-segment.d.ts.map +1 -0
  894. package/dist/shared/form-state-flight.d.ts +32 -0
  895. package/dist/shared/form-state-flight.d.ts.map +1 -0
  896. package/dist/shared/href-validation.d.ts +49 -0
  897. package/dist/shared/href-validation.d.ts.map +1 -0
  898. package/dist/shared/merge-search-params.d.ts +22 -0
  899. package/dist/shared/merge-search-params.d.ts.map +1 -0
  900. package/dist/shared/param-value.d.ts +104 -0
  901. package/dist/shared/param-value.d.ts.map +1 -0
  902. package/dist/shared/payload-root.d.ts +110 -0
  903. package/dist/shared/payload-root.d.ts.map +1 -0
  904. package/dist/shared/redirect-type.d.ts +17 -0
  905. package/dist/shared/redirect-type.d.ts.map +1 -0
  906. package/dist/shared/rsc-cache-key.d.ts +163 -0
  907. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  908. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  909. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  910. package/dist/shared/rsc-manifest.d.ts +28 -0
  911. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  912. package/dist/shared/rsc-media-type.d.ts +52 -0
  913. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  914. package/dist/shared/rsc-payload-path.d.ts +48 -0
  915. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  916. package/dist/shared/segment-info.d.ts +66 -0
  917. package/dist/shared/segment-info.d.ts.map +1 -0
  918. package/dist/shared/slot-params.d.ts +52 -0
  919. package/dist/shared/slot-params.d.ts.map +1 -0
  920. package/dist/shared/static-platform-files.d.ts +71 -0
  921. package/dist/shared/static-platform-files.d.ts.map +1 -0
  922. package/dist/shared/status-reason-phrase.d.ts +26 -0
  923. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  924. package/dist/shims/font-google.d.ts +1 -1
  925. package/dist/shims/font-google.d.ts.map +1 -1
  926. package/dist/shims/font-google.js +42 -0
  927. package/dist/shims/font-google.js.map +1 -0
  928. package/dist/shims/font-local.d.ts +26 -0
  929. package/dist/shims/font-local.d.ts.map +1 -0
  930. package/dist/shims/font-local.js +20 -0
  931. package/dist/shims/font-local.js.map +1 -0
  932. package/dist/shims/headers.d.ts +53 -1
  933. package/dist/shims/headers.d.ts.map +1 -1
  934. package/dist/shims/image.d.ts +120 -120
  935. package/dist/shims/image.d.ts.map +1 -1
  936. package/dist/shims/navigation-client.d.ts +25 -12
  937. package/dist/shims/navigation-client.d.ts.map +1 -1
  938. package/dist/shims/navigation-rsc.d.ts +21 -0
  939. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  940. package/dist/shims/navigation.d.ts +10 -5
  941. package/dist/shims/navigation.d.ts.map +1 -1
  942. package/dist/utils/state-machine.d.ts +80 -0
  943. package/dist/utils/state-machine.d.ts.map +1 -0
  944. package/dist/utils/write-file-atomic.d.ts +17 -0
  945. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  946. package/docs/api/30-api-server.mdx +239 -0
  947. package/docs/api/31-api-client.mdx +199 -0
  948. package/docs/api/32-api-cache.mdx +341 -0
  949. package/docs/api/33-api-search-params.mdx +176 -0
  950. package/docs/api/34-api-config.mdx +359 -0
  951. package/docs/api/35-api-typescript.mdx +91 -0
  952. package/docs/api/36-cli.mdx +206 -0
  953. package/docs/learn/00-introduction.mdx +109 -0
  954. package/docs/learn/01-quick-start.mdx +94 -0
  955. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  956. package/docs/learn/03-fetching-data.mdx +227 -0
  957. package/docs/learn/04-access-control.mdx +115 -0
  958. package/docs/learn/05-the-flush-point.mdx +175 -0
  959. package/docs/learn/06-typed-params.mdx +275 -0
  960. package/docs/learn/07-typed-routes.mdx +108 -0
  961. package/docs/learn/08-forms-and-actions.mdx +260 -0
  962. package/docs/learn/09-streaming.mdx +140 -0
  963. package/docs/learn/10-caching.mdx +282 -0
  964. package/docs/learn/11-middleware.mdx +166 -0
  965. package/docs/learn/12-error-handling.mdx +192 -0
  966. package/docs/learn/13-deploying.mdx +289 -0
  967. package/llms.txt +55 -0
  968. package/package.json +120 -29
  969. package/src/adapters/build-output-helper.ts +353 -0
  970. package/src/adapters/canonicalize-module.ts +29 -0
  971. package/src/adapters/cloudflare-dev.ts +183 -0
  972. package/src/adapters/cloudflare-kv-cache.ts +207 -0
  973. package/src/adapters/cloudflare.ts +809 -150
  974. package/src/adapters/compress-module.ts +110 -86
  975. package/src/adapters/fs-identity.ts +155 -0
  976. package/src/adapters/nitro-immutable-assets.ts +142 -0
  977. package/src/adapters/nitro-presets.ts +124 -0
  978. package/src/adapters/nitro-preview.ts +533 -0
  979. package/src/adapters/nitro.ts +331 -445
  980. package/src/adapters/raw-imports.d.ts +5 -0
  981. package/src/adapters/shared.ts +283 -0
  982. package/src/adapters/types.ts +129 -17
  983. package/src/adapters/wrangler.d.ts +7 -0
  984. package/src/analyze/chains.ts +411 -0
  985. package/src/analyze/classify.ts +259 -0
  986. package/src/analyze/crawl-entry.ts +68 -0
  987. package/src/analyze/crawl.ts +500 -0
  988. package/src/analyze/graph-cache.ts +331 -0
  989. package/src/analyze/graph-command.ts +762 -0
  990. package/src/analyze/live-graph.ts +232 -0
  991. package/src/analyze/poison-rules.ts +165 -0
  992. package/src/analyze/poison-scan.ts +159 -0
  993. package/src/analyze/scan.ts +149 -0
  994. package/src/cache/cache-api.ts +113 -0
  995. package/src/cache/fast-hash.ts +5 -0
  996. package/src/cache/handler-store.ts +113 -0
  997. package/src/cache/index.ts +115 -22
  998. package/src/cache/invalidation-epoch.ts +105 -0
  999. package/src/cache/json-lossy-check.ts +69 -0
  1000. package/src/cache/redis-handler.ts +198 -20
  1001. package/src/cache/singleflight.ts +72 -6
  1002. package/src/cache/sizeof.ts +35 -0
  1003. package/src/cache/stable-stringify.ts +65 -2
  1004. package/src/cache/store.ts +71 -0
  1005. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1006. package/src/cache/stores/memory.ts +125 -0
  1007. package/src/cache/stores/redis.ts +97 -0
  1008. package/src/cache/stores/vercel.ts +59 -0
  1009. package/src/cache/tag-aware-handler.ts +254 -0
  1010. package/src/cache/timber-cache.ts +169 -40
  1011. package/src/cdn/cloudflare-purge.ts +50 -0
  1012. package/src/cdn/fastly-purge.ts +63 -0
  1013. package/src/cdn/headers.ts +153 -0
  1014. package/src/cdn/index.ts +23 -0
  1015. package/src/cdn/purge-store.ts +62 -0
  1016. package/src/cdn/workers-cache-purge.ts +34 -0
  1017. package/src/cli-check.ts +417 -0
  1018. package/src/cli-context.ts +119 -0
  1019. package/src/cli-schema-sync.ts +401 -0
  1020. package/src/cli.ts +334 -80
  1021. package/src/client/browser-dev.ts +192 -5
  1022. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1023. package/src/client/browser-entry/action-queue.ts +152 -0
  1024. package/src/client/browser-entry/form-state.ts +49 -0
  1025. package/src/client/browser-entry/hmr.ts +70 -0
  1026. package/src/client/browser-entry/hydrate.ts +152 -0
  1027. package/src/client/browser-entry/index.ts +150 -0
  1028. package/src/client/browser-entry/post-hydration.ts +99 -0
  1029. package/src/client/browser-entry/router-init.ts +391 -0
  1030. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1031. package/src/client/browser-entry/scroll.ts +50 -0
  1032. package/src/client/deny-last-resort.tsx +54 -0
  1033. package/src/client/error-boundary.tsx +279 -61
  1034. package/src/client/error-reconstituter.tsx +84 -0
  1035. package/src/client/form.tsx +61 -173
  1036. package/src/client/global-context.ts +31 -0
  1037. package/src/client/history.ts +74 -11
  1038. package/src/client/index.ts +90 -53
  1039. package/src/client/internal.ts +54 -0
  1040. package/src/client/link.tsx +464 -151
  1041. package/src/client/location-search.ts +15 -0
  1042. package/src/client/navigation-api.ts +254 -0
  1043. package/src/client/navigation-commit.ts +318 -0
  1044. package/src/client/navigation-context.ts +67 -134
  1045. package/src/client/navigation-root.tsx +236 -0
  1046. package/src/client/navigation-transition.ts +401 -0
  1047. package/src/client/nuqs-adapter.tsx +21 -9
  1048. package/src/client/params-context.ts +187 -0
  1049. package/src/client/react-root.ts +105 -0
  1050. package/src/client/router-effects.ts +349 -0
  1051. package/src/client/router-lifecycle.ts +374 -0
  1052. package/src/client/router-pipeline.ts +443 -0
  1053. package/src/client/router-ref.ts +3 -3
  1054. package/src/client/router-skew.ts +30 -0
  1055. package/src/client/router-types.ts +326 -0
  1056. package/src/client/router-url.ts +32 -0
  1057. package/src/client/router.ts +491 -421
  1058. package/src/client/rsc-fetch.ts +510 -109
  1059. package/src/client/segment-cache.ts +362 -41
  1060. package/src/client/segment-context.ts +7 -4
  1061. package/src/client/segment-outlet.tsx +96 -0
  1062. package/src/client/segment-update-context.ts +23 -0
  1063. package/src/client/shallow-url.ts +22 -0
  1064. package/src/client/slot-content-cache-context.ts +43 -0
  1065. package/src/client/slot-context.ts +50 -0
  1066. package/src/client/slot-outlet.tsx +22 -0
  1067. package/src/client/slot-provider.tsx +32 -0
  1068. package/src/client/ssr-data.ts +27 -67
  1069. package/src/client/stale-client.ts +191 -0
  1070. package/src/client/state.ts +31 -24
  1071. package/src/client/status-page-marker.tsx +32 -0
  1072. package/src/client/top-loader.tsx +13 -10
  1073. package/src/client/unload-guard.ts +35 -3
  1074. package/src/client/use-cookie.ts +70 -18
  1075. package/src/client/use-field-state.ts +144 -0
  1076. package/src/client/use-link-status.ts +7 -7
  1077. package/src/client/use-pathname.ts +22 -31
  1078. package/src/client/use-pending-navigation.ts +40 -0
  1079. package/src/client/use-query-states.ts +206 -36
  1080. package/src/client/use-router.ts +31 -9
  1081. package/src/client/use-search-params.ts +38 -49
  1082. package/src/client/use-segment-params.ts +69 -0
  1083. package/src/client/use-selected-layout-segment.ts +2 -2
  1084. package/src/codec.ts +149 -0
  1085. package/src/config-types.ts +321 -0
  1086. package/src/config-validation.ts +464 -0
  1087. package/src/cookies/define-cookie.ts +222 -53
  1088. package/src/cookies/index.ts +13 -2
  1089. package/src/cookies/json-cookie.ts +105 -0
  1090. package/src/cookies/validation.ts +192 -0
  1091. package/src/dev-tools/404-page.ts +286 -0
  1092. package/src/dev-tools/browser-logs.ts +55 -0
  1093. package/src/dev-tools/dev-page-shell.ts +278 -0
  1094. package/src/dev-tools/error-page.ts +331 -0
  1095. package/src/dev-tools/holding-server.ts +185 -0
  1096. package/src/dev-tools/hydration-overlay.ts +158 -0
  1097. package/src/dev-tools/index.ts +79 -0
  1098. package/src/dev-tools/instrumentation.ts +261 -0
  1099. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +33 -51
  1100. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +147 -25
  1101. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1102. package/src/dev-tools/stack-classifier.ts +75 -0
  1103. package/src/dev-tools/terminal.ts +182 -0
  1104. package/src/fonts/ast-walk.ts +235 -0
  1105. package/src/fonts/ast.ts +479 -128
  1106. package/src/fonts/bundle.ts +138 -0
  1107. package/src/fonts/css.ts +1 -1
  1108. package/src/fonts/dev-middleware.ts +85 -0
  1109. package/src/fonts/fallbacks.ts +0 -23
  1110. package/src/fonts/google.ts +101 -19
  1111. package/src/fonts/local.ts +12 -11
  1112. package/src/fonts/paths.ts +58 -0
  1113. package/src/fonts/pipeline.ts +348 -0
  1114. package/src/fonts/transform.ts +311 -0
  1115. package/src/fonts/types.ts +52 -1
  1116. package/src/fonts/virtual-modules.ts +179 -0
  1117. package/src/index.ts +492 -380
  1118. package/src/params/codec-registry.ts +34 -0
  1119. package/src/params/define-schema.ts +115 -0
  1120. package/src/params/index.ts +17 -0
  1121. package/src/params/resolve-schema.ts +84 -0
  1122. package/src/plugin-context.ts +502 -0
  1123. package/src/plugins/build-manifest.ts +189 -36
  1124. package/src/plugins/build-report.ts +299 -87
  1125. package/src/plugins/cache.ts +243 -0
  1126. package/src/plugins/callsite-ast.ts +472 -0
  1127. package/src/plugins/callsite-jsx.ts +243 -0
  1128. package/src/plugins/chunks.ts +74 -5
  1129. package/src/plugins/client-chunks.ts +185 -0
  1130. package/src/plugins/client-dep-entries.ts +124 -0
  1131. package/src/plugins/cloudflare-wasm.ts +141 -0
  1132. package/src/plugins/content.ts +31 -2
  1133. package/src/plugins/dev-discovery.ts +218 -0
  1134. package/src/plugins/dev-server.ts +376 -98
  1135. package/src/plugins/encryption-runtime.ts +31 -0
  1136. package/src/plugins/entries.ts +156 -17
  1137. package/src/plugins/fonts.ts +260 -657
  1138. package/src/plugins/graph-endpoint.ts +532 -0
  1139. package/src/plugins/mdx.ts +108 -35
  1140. package/src/plugins/orphaned-modules.ts +78 -0
  1141. package/src/plugins/post-build.ts +327 -0
  1142. package/src/plugins/prebuilt-capture.ts +213 -0
  1143. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1144. package/src/plugins/prebuilt.ts +670 -0
  1145. package/src/plugins/prerender-sugar.ts +348 -0
  1146. package/src/plugins/react-resolve.ts +149 -0
  1147. package/src/plugins/request-dep/analysis.ts +447 -0
  1148. package/src/plugins/request-dep/index.ts +376 -0
  1149. package/src/plugins/request-dep/origin.ts +310 -0
  1150. package/src/plugins/routing.ts +296 -278
  1151. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1152. package/src/plugins/server-bundle.ts +115 -15
  1153. package/src/plugins/shims.ts +257 -97
  1154. package/src/plugins/static-build.ts +681 -71
  1155. package/src/react-canary.d.ts +2 -0
  1156. package/src/routing/codegen-shared.ts +39 -0
  1157. package/src/routing/codegen-types.ts +62 -0
  1158. package/src/routing/codegen-write.ts +163 -0
  1159. package/src/routing/codegen.ts +349 -232
  1160. package/src/routing/collision-probe.ts +438 -0
  1161. package/src/routing/collision-spaces.ts +281 -0
  1162. package/src/routing/convention-lint.ts +651 -0
  1163. package/src/routing/export-detect.ts +536 -0
  1164. package/src/routing/file-cache.ts +23 -0
  1165. package/src/routing/index.ts +16 -7
  1166. package/src/routing/interception-overlap.ts +141 -0
  1167. package/src/routing/interception.ts +1044 -67
  1168. package/src/routing/link-codegen.ts +280 -0
  1169. package/src/routing/manifest-codegen.ts +232 -0
  1170. package/src/routing/scanner.ts +417 -223
  1171. package/src/routing/schema-validation.ts +155 -0
  1172. package/src/routing/segment-classify.ts +280 -0
  1173. package/src/routing/segment-codegen.ts +99 -0
  1174. package/src/routing/segment-keys.ts +186 -0
  1175. package/src/routing/slot-placement.ts +97 -0
  1176. package/src/routing/types.ts +82 -26
  1177. package/src/routing/walkers.ts +98 -0
  1178. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1179. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1180. package/src/rsc-runtime/render-flight.ts +26 -0
  1181. package/src/rsc-runtime/rsc.ts +27 -2
  1182. package/src/rsc-runtime/ssr.ts +23 -0
  1183. package/src/rsc-runtime/transforms.ts +13 -0
  1184. package/src/rsc-runtime/vendor-types.d.ts +70 -0
  1185. package/src/schema-bridge.ts +382 -0
  1186. package/src/search-params/define.ts +677 -0
  1187. package/src/search-params/index.ts +14 -20
  1188. package/src/search-params/parse-total.ts +91 -0
  1189. package/src/search-params/serialize-equal.ts +14 -0
  1190. package/src/search-params/wrappers.ts +150 -0
  1191. package/src/server/abort-scope.ts +49 -0
  1192. package/src/server/access-gate.tsx +195 -56
  1193. package/src/server/action-client.ts +175 -294
  1194. package/src/server/action-encryption.ts +144 -0
  1195. package/src/server/action-handler.ts +492 -150
  1196. package/src/server/action-schema.ts +203 -0
  1197. package/src/server/action-types.ts +145 -0
  1198. package/src/server/actions.ts +172 -85
  1199. package/src/server/als-registry.ts +245 -30
  1200. package/src/server/body-limits.ts +10 -2
  1201. package/src/server/build-manifest.ts +33 -57
  1202. package/src/server/canonicalize.ts +35 -3
  1203. package/src/server/chain-url-parts.ts +163 -0
  1204. package/src/server/children-interception.ts +116 -0
  1205. package/src/server/client-error-message.ts +18 -0
  1206. package/src/server/coalesce-tick.ts +75 -0
  1207. package/src/server/compress.ts +91 -19
  1208. package/src/server/cookie-context.ts +454 -0
  1209. package/src/server/cookie-parsing.ts +163 -0
  1210. package/src/server/csp-nonce.ts +58 -0
  1211. package/src/server/csrf.ts +228 -35
  1212. package/src/server/debug.ts +0 -1
  1213. package/src/server/default-logger.ts +100 -0
  1214. package/src/server/default-status-page.ts +88 -0
  1215. package/src/server/deny-boundary.ts +527 -0
  1216. package/src/server/deny-renderer.ts +210 -181
  1217. package/src/server/early-hints-sender.ts +4 -3
  1218. package/src/server/early-hints.ts +39 -29
  1219. package/src/server/error-boundary-wrapper.ts +160 -44
  1220. package/src/server/error-response-headers.ts +18 -0
  1221. package/src/server/fallback-error.ts +88 -104
  1222. package/src/server/flight-injection-state.ts +113 -0
  1223. package/src/server/flight-injector-core.ts +328 -0
  1224. package/src/server/flight-scripts.ts +92 -0
  1225. package/src/server/flight-source-node.ts +431 -0
  1226. package/src/server/flight-source.ts +288 -0
  1227. package/src/server/form-data.ts +191 -20
  1228. package/src/server/form-state-flight.ts +67 -0
  1229. package/src/server/head-response.ts +50 -0
  1230. package/src/server/html-injector-core.ts +320 -0
  1231. package/src/server/html-injectors.ts +241 -285
  1232. package/src/server/index.ts +37 -195
  1233. package/src/server/instrumentation.ts +42 -11
  1234. package/src/server/internal.ts +163 -0
  1235. package/src/server/json-status-response.ts +105 -0
  1236. package/src/server/logger.ts +131 -38
  1237. package/src/server/metadata-collector.ts +175 -0
  1238. package/src/server/metadata-platform.ts +2 -2
  1239. package/src/server/metadata-render.ts +30 -8
  1240. package/src/server/metadata-route-links.ts +200 -0
  1241. package/src/server/metadata-routes.ts +114 -24
  1242. package/src/server/metadata-social.ts +2 -2
  1243. package/src/server/metadata.ts +23 -2
  1244. package/src/server/middleware-runner.ts +32 -5
  1245. package/src/server/node-body-response.ts +236 -0
  1246. package/src/server/node-response.ts +93 -0
  1247. package/src/server/node-stream-transforms.ts +340 -0
  1248. package/src/server/node-streams-platform.ts +23 -0
  1249. package/src/server/nuqs-ssr-provider.tsx +8 -7
  1250. package/src/server/param-coercion.ts +201 -0
  1251. package/src/server/pipeline-helpers.ts +550 -0
  1252. package/src/server/pipeline-interception.ts +241 -32
  1253. package/src/server/pipeline-metadata.ts +25 -1
  1254. package/src/server/pipeline-outcome.ts +290 -0
  1255. package/src/server/pipeline-phases.ts +503 -0
  1256. package/src/server/pipeline.ts +435 -427
  1257. package/src/server/port-resolution.ts +43 -0
  1258. package/src/server/prebuilt/cache-key.ts +340 -0
  1259. package/src/server/prebuilt/capture-render.ts +122 -0
  1260. package/src/server/prebuilt/capture-routes.ts +104 -0
  1261. package/src/server/prebuilt/capture-state.ts +196 -0
  1262. package/src/server/prebuilt/dev-store.ts +173 -0
  1263. package/src/server/prebuilt/key-discipline.ts +122 -0
  1264. package/src/server/prebuilt/lifetime.ts +151 -0
  1265. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1266. package/src/server/prebuilt/overlay.ts +262 -0
  1267. package/src/server/prebuilt/payload-source.ts +221 -0
  1268. package/src/server/prebuilt/slots.ts +201 -0
  1269. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1270. package/src/server/prebuilt-builder.ts +515 -0
  1271. package/src/server/prebuilt-runtime.ts +808 -0
  1272. package/src/server/primitives.ts +153 -171
  1273. package/src/server/publish-params.ts +42 -0
  1274. package/src/server/react-cache-bridge.ts +124 -0
  1275. package/src/server/react-cache-scope.ts +104 -0
  1276. package/src/server/render-timeout.ts +123 -0
  1277. package/src/server/render-utils.ts +45 -0
  1278. package/src/server/request-context.ts +298 -324
  1279. package/src/server/request-dep.ts +37 -0
  1280. package/src/server/response-cache-policy.ts +45 -0
  1281. package/src/server/route-element-builder.ts +526 -355
  1282. package/src/server/route-element-helpers.ts +37 -0
  1283. package/src/server/route-handler.ts +67 -27
  1284. package/src/server/route-matcher.ts +238 -267
  1285. package/src/server/route-module-loader.ts +161 -0
  1286. package/src/server/rsc-cache-key-guard.ts +122 -0
  1287. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1288. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1289. package/src/server/rsc-entry/api-handler.ts +49 -81
  1290. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1291. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1292. package/src/server/rsc-entry/helpers.ts +90 -115
  1293. package/src/server/rsc-entry/index.ts +405 -349
  1294. package/src/server/rsc-entry/render-route.ts +248 -0
  1295. package/src/server/rsc-entry/render-signals.ts +108 -0
  1296. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1297. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1298. package/src/server/rsc-entry/rsc-stream.ts +137 -135
  1299. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1300. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1301. package/src/server/rsc-error-envelope.ts +18 -0
  1302. package/src/server/rsc-prop-warnings.ts +1 -1
  1303. package/src/server/safe-load.ts +53 -0
  1304. package/src/server/schema-introspection.ts +393 -0
  1305. package/src/server/sensitive-fields.ts +287 -0
  1306. package/src/server/server-only-guard-noop.js +3 -0
  1307. package/src/server/server-timing.ts +1 -1
  1308. package/src/server/signal-identity.ts +112 -0
  1309. package/src/server/sitemap-generator.ts +337 -0
  1310. package/src/server/sitemap-handler.ts +150 -0
  1311. package/src/server/skippable-prefix.ts +172 -0
  1312. package/src/server/slot-interception.ts +168 -0
  1313. package/src/server/slot-resolver.ts +707 -300
  1314. package/src/server/slot-subtree-contain.ts +273 -0
  1315. package/src/server/ssr-bridge-types.ts +217 -0
  1316. package/src/server/ssr-entry.ts +248 -109
  1317. package/src/server/ssr-form-state.ts +58 -0
  1318. package/src/server/ssr-render.ts +332 -101
  1319. package/src/server/ssr-wrappers.tsx +162 -0
  1320. package/src/server/state-tree-diff.ts +85 -30
  1321. package/src/server/static-generator.ts +680 -0
  1322. package/src/server/static-not-found.ts +134 -0
  1323. package/src/server/status-code-resolver.ts +107 -148
  1324. package/src/server/stream-utils.ts +398 -0
  1325. package/src/server/tracing.ts +163 -68
  1326. package/src/server/tree-match.ts +494 -0
  1327. package/src/server/types.ts +96 -11
  1328. package/src/server/utils/element-type.ts +88 -0
  1329. package/src/server/utils/escape-html.ts +20 -0
  1330. package/src/server/version-skew.ts +104 -0
  1331. package/src/server/waituntil-bridge.ts +1 -1
  1332. package/src/server/workers-cache-bridge.ts +33 -0
  1333. package/src/shared/als-slots.ts +74 -0
  1334. package/src/shared/base-path.ts +80 -0
  1335. package/src/shared/csrf-reject.ts +15 -0
  1336. package/src/shared/error-digest.ts +46 -0
  1337. package/src/shared/flight-base64.ts +23 -0
  1338. package/src/shared/flight-segment.ts +35 -0
  1339. package/src/shared/form-state-flight.ts +59 -0
  1340. package/src/shared/href-validation.ts +159 -0
  1341. package/src/shared/merge-search-params.ts +55 -0
  1342. package/src/shared/param-value.ts +281 -0
  1343. package/src/shared/payload-root.ts +153 -0
  1344. package/src/shared/redirect-type.ts +17 -0
  1345. package/src/shared/rsc-cache-key.ts +269 -0
  1346. package/src/shared/rsc-error-envelope.ts +16 -0
  1347. package/src/shared/rsc-manifest.ts +29 -0
  1348. package/src/shared/rsc-media-type.ts +59 -0
  1349. package/src/shared/rsc-payload-path.ts +52 -0
  1350. package/src/shared/segment-info.ts +67 -0
  1351. package/src/shared/slot-params.ts +109 -0
  1352. package/src/shared/static-platform-files.ts +75 -0
  1353. package/src/shared/status-reason-phrase.ts +61 -0
  1354. package/src/shims/font-google.ts +1 -1
  1355. package/src/shims/font-local.ts +34 -0
  1356. package/src/shims/headers.ts +122 -1
  1357. package/src/shims/navigation-client.ts +36 -32
  1358. package/src/shims/navigation-rsc.ts +47 -0
  1359. package/src/shims/navigation.ts +10 -7
  1360. package/src/utils/state-machine.ts +111 -0
  1361. package/src/utils/write-file-atomic.ts +32 -0
  1362. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1363. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1364. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1365. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1366. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1367. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1368. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1369. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1370. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1371. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1372. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1373. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1374. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1375. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1376. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1377. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1378. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1379. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1380. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1381. package/dist/adapters/cloudflare.js.map +0 -1
  1382. package/dist/cache/index.js.map +0 -1
  1383. package/dist/cache/register-cached-function.d.ts +0 -17
  1384. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1385. package/dist/client/browser-entry.d.ts +0 -21
  1386. package/dist/client/browser-entry.d.ts.map +0 -1
  1387. package/dist/client/error-boundary.js.map +0 -1
  1388. package/dist/client/head.d.ts +0 -16
  1389. package/dist/client/head.d.ts.map +0 -1
  1390. package/dist/client/link-status-provider.d.ts +0 -11
  1391. package/dist/client/link-status-provider.d.ts.map +0 -1
  1392. package/dist/client/segment-merger.d.ts +0 -119
  1393. package/dist/client/segment-merger.d.ts.map +0 -1
  1394. package/dist/client/stale-reload.d.ts +0 -44
  1395. package/dist/client/stale-reload.d.ts.map +0 -1
  1396. package/dist/client/transition-root.d.ts +0 -74
  1397. package/dist/client/transition-root.d.ts.map +0 -1
  1398. package/dist/client/types.d.ts +0 -14
  1399. package/dist/client/types.d.ts.map +0 -1
  1400. package/dist/client/use-navigation-pending.d.ts +0 -26
  1401. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1402. package/dist/client/use-params.d.ts +0 -92
  1403. package/dist/client/use-params.d.ts.map +0 -1
  1404. package/dist/content/index.d.ts +0 -11
  1405. package/dist/content/index.d.ts.map +0 -1
  1406. package/dist/content/index.js +0 -2
  1407. package/dist/plugins/adapter-build.d.ts +0 -18
  1408. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1409. package/dist/plugins/cache-transform.d.ts +0 -36
  1410. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1411. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1412. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1413. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1414. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1415. package/dist/plugins/server-action-exports.d.ts +0 -26
  1416. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1417. package/dist/routing/status-file-lint.d.ts +0 -33
  1418. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1419. package/dist/search-params/analyze.d.ts +0 -54
  1420. package/dist/search-params/analyze.d.ts.map +0 -1
  1421. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1422. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1423. package/dist/search-params/codecs.d.ts +0 -53
  1424. package/dist/search-params/codecs.d.ts.map +0 -1
  1425. package/dist/search-params/create.d.ts +0 -106
  1426. package/dist/search-params/create.d.ts.map +0 -1
  1427. package/dist/search-params/registry.d.ts +0 -20
  1428. package/dist/search-params/registry.d.ts.map +0 -1
  1429. package/dist/server/asset-headers.d.ts +0 -42
  1430. package/dist/server/asset-headers.d.ts.map +0 -1
  1431. package/dist/server/client-module-map.d.ts +0 -47
  1432. package/dist/server/client-module-map.d.ts.map +0 -1
  1433. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1434. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1435. package/dist/server/dev-logger.d.ts.map +0 -1
  1436. package/dist/server/dev-span-processor.d.ts +0 -29
  1437. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1438. package/dist/server/dev-warnings.d.ts +0 -129
  1439. package/dist/server/dev-warnings.d.ts.map +0 -1
  1440. package/dist/server/flush.d.ts +0 -74
  1441. package/dist/server/flush.d.ts.map +0 -1
  1442. package/dist/server/form-flash.d.ts +0 -78
  1443. package/dist/server/form-flash.d.ts.map +0 -1
  1444. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1445. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1446. package/dist/server/prerender.d.ts +0 -77
  1447. package/dist/server/prerender.d.ts.map +0 -1
  1448. package/dist/server/tree-builder.d.ts +0 -126
  1449. package/dist/server/tree-builder.d.ts.map +0 -1
  1450. package/dist/utils/directive-parser.d.ts +0 -70
  1451. package/dist/utils/directive-parser.d.ts.map +0 -1
  1452. package/src/cache/register-cached-function.ts +0 -103
  1453. package/src/client/browser-entry.ts +0 -678
  1454. package/src/client/head.ts +0 -61
  1455. package/src/client/link-status-provider.tsx +0 -30
  1456. package/src/client/segment-merger.ts +0 -339
  1457. package/src/client/stale-reload.ts +0 -87
  1458. package/src/client/transition-root.tsx +0 -166
  1459. package/src/client/types.ts +0 -21
  1460. package/src/client/use-navigation-pending.ts +0 -38
  1461. package/src/client/use-params.ts +0 -141
  1462. package/src/content/index.ts +0 -13
  1463. package/src/plugins/adapter-build.ts +0 -118
  1464. package/src/plugins/cache-transform.ts +0 -199
  1465. package/src/plugins/dynamic-transform.ts +0 -161
  1466. package/src/plugins/server-action-exports.ts +0 -220
  1467. package/src/routing/status-file-lint.ts +0 -112
  1468. package/src/search-params/analyze.ts +0 -192
  1469. package/src/search-params/builtin-codecs.ts +0 -228
  1470. package/src/search-params/codecs.ts +0 -153
  1471. package/src/search-params/create.ts +0 -321
  1472. package/src/search-params/registry.ts +0 -31
  1473. package/src/server/asset-headers.ts +0 -81
  1474. package/src/server/client-module-map.ts +0 -58
  1475. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1476. package/src/server/dev-span-processor.ts +0 -78
  1477. package/src/server/dev-warnings.ts +0 -283
  1478. package/src/server/flush.ts +0 -182
  1479. package/src/server/form-flash.ts +0 -89
  1480. package/src/server/manifest-status-resolver.ts +0 -215
  1481. package/src/server/prerender.ts +0 -139
  1482. package/src/server/tree-builder.ts +0 -382
  1483. package/src/shims/server-only-noop.js +0 -6
  1484. package/src/utils/directive-parser.ts +0 -529
@@ -1,110 +1,203 @@
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-DDc7duTD.js";
2
+ import { a as STATIC_CACHE, i as IMMUTABLE_CACHE, n as runSharedBuildSteps, o as adapterBase, r as writeHeadersFile, t as buildStaticDirectoryOutput } from "../_chunks/build-output-helper-RV_BRcF1.js";
3
+ import { transformWithOxc } from "vite";
4
+ import { basename, dirname, join, relative, sep } from "node:path";
5
+ import { existsSync } from "node:fs";
6
+ import { cp, glob, readFile, writeFile } from "node:fs/promises";
3
7
  import { execFile } from "node:child_process";
8
+ //#region src/server/compress.ts?raw
9
+ 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";
10
+ //#endregion
4
11
  //#region 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.
15
+ *
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`.
7
48
  *
8
- * Written to `_compress.mjs` during buildOutput. Imported by the Nitro entry
9
- * and preview server.
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
+ //#endregion
86
+ //#region src/server/canonicalize.ts?raw
87
+ 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";
88
+ //#endregion
89
+ //#region src/adapters/canonicalize-module.ts
90
+ /**
91
+ * Compile server/canonicalize.ts into a standalone ESM module exporting
92
+ * `canonicalize`.
93
+ *
94
+ * @internal Exported for testing.
95
+ */
96
+ async function generateCanonicalizeModule() {
97
+ const result = await transformWithOxc(canonicalize_default, "canonicalize.ts", { lang: "ts" });
98
+ assertStandalone(result.code, "server/canonicalize.ts", "_canonicalize.mjs");
99
+ 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;
100
+ }
101
+ //#endregion
102
+ //#region src/adapters/nitro-immutable-assets.ts
103
+ /** The generated module, written beside the Nitro entry that imports it. */
104
+ var IMMUTABLE_ASSETS_MODULE = "_immutable-assets.mjs";
105
+ /**
106
+ * Write the generated module into `nitroDir` and return the Nitro config that
107
+ * serves the build's content-hashed directories from `<nitroDir>/public`.
108
+ *
109
+ * No `maxAge`: Nitro would turn it into a route rule (see the module header),
110
+ * and Vercel already gives a non-fallthrough directory a one-year immutable
111
+ * header on hits and `no-store` on misses by default.
112
+ */
113
+ async function prepareImmutableAssets(nitroDir, immutableDirs) {
114
+ if (immutableDirs.length === 0) return {
115
+ publicAssets: [],
116
+ plugins: []
117
+ };
118
+ const plugin = join(nitroDir, IMMUTABLE_ASSETS_MODULE);
119
+ await writeFile(plugin, generateImmutableAssetsModule(immutableDirs));
120
+ return {
121
+ publicAssets: immutableDirs.map((dir) => ({
122
+ dir: join(nitroDir, "public", dir),
123
+ baseURL: `/${dir}`,
124
+ fallthrough: false
125
+ })),
126
+ plugins: [plugin]
127
+ };
128
+ }
129
+ /**
130
+ * The lines timber's Nitro entry needs to answer a request under the
131
+ * content-hashed directories itself: an import, and a guard to run before
132
+ * the handler, with the h3 event in scope as `event`. Empty when the build
133
+ * has no such directories, which also means `prepareImmutableAssets()`
134
+ * writes no module to import.
135
+ */
136
+ function immutableAssetsEntryGuard(immutableDirs) {
137
+ if (immutableDirs.length === 0) return {
138
+ imports: "",
139
+ guard: ""
140
+ };
141
+ return {
142
+ imports: `import { isImmutableAssetPath } from './${IMMUTABLE_ASSETS_MODULE}'\n`,
143
+ guard: ` // Under a content-hashed directory only a served file may answer; the
144
+ // static handler already sent any file there is. A no-store 404, never a
145
+ // page — see _immutable-assets.mjs.
146
+ if (isImmutableAssetPath(event.url.pathname)) {
147
+ return new Response('Not Found', {
148
+ status: 404,
149
+ headers: { 'content-type': 'text/plain; charset=utf-8', 'cache-control': 'no-store' },
150
+ })
49
151
  }
50
- return null;
152
+ `
153
+ };
51
154
  }
155
+ /**
156
+ * Generate the module shared by the Nitro entry and runtime: the path matcher
157
+ * for the content-hashed directories, and the runtime plugin that owns
158
+ * Cache-Control under them — `IMMUTABLE_CACHE` on a GET or HEAD that served
159
+ * the file (200, or 304 revalidating it), `no-store` on everything else.
160
+ *
161
+ * Status is a sound signal only because the entry answers everything else
162
+ * under these directories with a 404 (see `immutableAssetsEntryGuard`). The
163
+ * prefixes are matched against the decoded path, the one Nitro's static
164
+ * handler looks the file up by.
165
+ *
166
+ * @internal Exported for testing.
167
+ */
168
+ function generateImmutableAssetsModule(immutableDirs) {
169
+ const prefixes = immutableDirs.map((dir) => `/${dir}/`);
170
+ return `// Generated by @timber-js/app — Cache-Control for content-hashed directories.
171
+ // Do not edit — this file is regenerated on each build.
52
172
 
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
- }
173
+ const PREFIXES = ${JSON.stringify(prefixes)};
174
+ const IMMUTABLE_CACHE = ${JSON.stringify(IMMUTABLE_CACHE)};
63
175
 
64
- function compressWithGzip(body) {
65
- return body.pipeThrough(new CompressionStream('gzip'));
176
+ export function isImmutableAssetPath(pathname) {
177
+ let path = pathname;
178
+ try {
179
+ path = decodeURI(pathname);
180
+ } catch {
181
+ // Malformed escapes: match the path as received.
182
+ }
183
+ return PREFIXES.some((prefix) => path.startsWith(prefix));
66
184
  }
67
185
 
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,
186
+ export default function immutableAssets(nitroApp) {
187
+ // Hooks are off only if a user's nitroConfig disables them; files then go
188
+ // without the long-lived header rather than failing every request.
189
+ nitroApp.hooks?.hook('response', (res, event) => {
190
+ if (!isImmutableAssetPath(event.url.pathname)) return;
191
+ const method = event.req.method;
192
+ const served =
193
+ (method === 'GET' || method === 'HEAD') && (res.status === 200 || res.status === 304);
194
+ res.headers.set('Cache-Control', served ? IMMUTABLE_CACHE : 'no-store');
89
195
  });
90
196
  }
91
197
  `;
92
198
  }
93
199
  //#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
- }
200
+ //#region src/adapters/nitro-presets.ts
108
201
  var PRESET_CONFIGS = {
109
202
  "vercel": {
110
203
  nitroPreset: "vercel",
@@ -171,6 +264,465 @@ var PRESET_CONFIGS = {
171
264
  runtimeName: "bun"
172
265
  }
173
266
  };
267
+ /** Presets that produce a locally-runnable server entry. */
268
+ var LOCALLY_PREVIEWABLE = /* @__PURE__ */ new Set(["node-server", "bun"]);
269
+ //#endregion
270
+ //#region src/adapters/nitro-preview.ts
271
+ /**
272
+ * Content-Type by file extension for the preview server. Static hosts decide
273
+ * this themselves; the table covers the file types a web build ships so the
274
+ * preview does not turn ordinary files into downloads. An extension missing
275
+ * here is served as `application/octet-stream`.
276
+ */
277
+ var PREVIEW_MIME_TYPES = {
278
+ ".html": "text/html; charset=utf-8",
279
+ ".htm": "text/html; charset=utf-8",
280
+ ".css": "text/css; charset=utf-8",
281
+ ".js": "text/javascript; charset=utf-8",
282
+ ".mjs": "text/javascript; charset=utf-8",
283
+ ".cjs": "text/javascript; charset=utf-8",
284
+ ".map": "application/json; charset=utf-8",
285
+ ".json": "application/json; charset=utf-8",
286
+ ".jsonld": "application/ld+json",
287
+ ".webmanifest": "application/manifest+json",
288
+ ".xml": "application/xml",
289
+ ".rss": "application/rss+xml",
290
+ ".atom": "application/atom+xml",
291
+ ".txt": "text/plain; charset=utf-8",
292
+ ".md": "text/markdown; charset=utf-8",
293
+ ".csv": "text/csv; charset=utf-8",
294
+ ".ics": "text/calendar; charset=utf-8",
295
+ ".vtt": "text/vtt; charset=utf-8",
296
+ ".pdf": "application/pdf",
297
+ ".wasm": "application/wasm",
298
+ ".zip": "application/zip",
299
+ ".gz": "application/gzip",
300
+ ".png": "image/png",
301
+ ".apng": "image/apng",
302
+ ".jpg": "image/jpeg",
303
+ ".jpeg": "image/jpeg",
304
+ ".gif": "image/gif",
305
+ ".svg": "image/svg+xml",
306
+ ".ico": "image/x-icon",
307
+ ".webp": "image/webp",
308
+ ".avif": "image/avif",
309
+ ".bmp": "image/bmp",
310
+ ".tif": "image/tiff",
311
+ ".tiff": "image/tiff",
312
+ ".woff": "font/woff",
313
+ ".woff2": "font/woff2",
314
+ ".ttf": "font/ttf",
315
+ ".otf": "font/otf",
316
+ ".mp3": "audio/mpeg",
317
+ ".wav": "audio/wav",
318
+ ".ogg": "audio/ogg",
319
+ ".oga": "audio/ogg",
320
+ ".m4a": "audio/mp4",
321
+ ".flac": "audio/flac",
322
+ ".mp4": "video/mp4",
323
+ ".webm": "video/webm",
324
+ ".ogv": "video/ogg",
325
+ ".mov": "video/quicktime"
326
+ };
327
+ /**
328
+ * Generate a standalone preview server script that uses Node's built-in
329
+ * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
330
+ * h3 which isn't available outside a Nitro build. For local preview we
331
+ * just need to serve static files and, in a server build, route requests
332
+ * to the RSC handler.
333
+ *
334
+ * Generated at build time rather than at preview time, so everything it
335
+ * serves comes from the build's artifacts instead of guesses about the
336
+ * directory it runs in.
337
+ *
338
+ * @internal Exported for testing.
339
+ */
340
+ function generatePreviewScript(options) {
341
+ const immutablePrefixes = options.immutableDirs.map((dir) => `/${dir}/`);
342
+ const contentTypes = options.output === "static" ? options.contentTypes : {};
343
+ const handlerSetup = options.output === "server" ? `// Set runtime before importing the handler.
344
+ process.env.TIMBER_RUNTIME = ${JSON.stringify(options.runtimeName)};
345
+ ${options.hasManifestInit ? `
346
+ // Load the build manifest before the handler reads it.
347
+ await import('./_timber-manifest-init.js');
348
+ ` : ""}
349
+ // Import the RSC handler (default export is the fetch-like handler).
350
+ const { default: handler, runWithEarlyHintsSender } = await import(${JSON.stringify(options.rscEntry)});
351
+
352
+ // Import compression helper for self-hosted response compression.
353
+ const { compressResponse } = await import('./_compress.mjs');
354
+
355
+ // Web→Node response bridge with backpressure (TIM-1154).
356
+ const { sendNodeResponse } = await import('./_send-response.mjs');
357
+ ` : "";
358
+ const fallback = options.output === "static" ? ` if (badPath) {
359
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
360
+ res.end('Bad Request');
361
+ return;
362
+ }
363
+ const notFound = await findFile('/404.html');
364
+ if (notFound) {
365
+ await sendFile(req, res, notFound, 404, 'text/html', 'public, max-age=0, must-revalidate');
366
+ return;
367
+ }
368
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
369
+ res.end('Not Found');
370
+ ` : ` // A request under a content-hashed directory that names no file is a
371
+ // plain no-store 404, never a render of the app — as timber's Nitro entry
372
+ // answers it in production (TIM-1578).
373
+ if (pathname !== null && IMMUTABLE_PREFIXES.some((prefix) => pathname.startsWith(prefix))) {
374
+ res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8', 'Cache-Control': 'no-store' });
375
+ res.end('Not Found');
376
+ return;
377
+ }
378
+ await handleDynamic(req, res, url);
379
+ `;
380
+ const dynamicHandler = options.output === "server" ? `
381
+ async function handleDynamic(req, res, url) {
382
+ // Convert Node request to Web Request.
383
+ const headers = new Headers();
384
+ for (const [key, value] of Object.entries(req.headers)) {
385
+ if (value) {
386
+ if (Array.isArray(value)) {
387
+ for (const v of value) headers.append(key, v);
388
+ } else {
389
+ headers.set(key, value);
390
+ }
391
+ }
392
+ }
393
+
394
+ let body = undefined;
395
+ if (req.method !== 'GET' && req.method !== 'HEAD') {
396
+ body = await new Promise((resolve) => {
397
+ const chunks = [];
398
+ req.on('data', (chunk) => chunks.push(chunk));
399
+ req.on('end', () => resolve(Buffer.concat(chunks)));
400
+ });
401
+ }
402
+
403
+ const webRequest = new Request(url.href, {
404
+ method: req.method,
405
+ headers,
406
+ body,
407
+ duplex: body ? 'half' : undefined,
408
+ });
409
+
410
+ try {
411
+ // Support 103 Early Hints when available.
412
+ const earlyHintsSender = (typeof res.writeEarlyHints === 'function')
413
+ ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }
414
+ : undefined;
415
+
416
+ const rawResponse = earlyHintsSender && runWithEarlyHintsSender
417
+ ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))
418
+ : await handler(webRequest);
419
+
420
+ // Compress the response for self-hosted deployments.
421
+ const webResponse = compressResponse(webRequest, rawResponse);
422
+
423
+ // Write the response to Node's ServerResponse. sendNodeResponse handles
424
+ // status, headers (including Set-Cookie splitting via [...headers]),
425
+ // body streaming with backpressure, and client disconnect cleanup.
426
+ // See TIM-1154.
427
+ await sendNodeResponse(res, webResponse);
428
+ } catch (err) {
429
+ console.error('[timber preview] Request error:', err);
430
+ if (!res.headersSent) {
431
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
432
+ }
433
+ res.end('Internal Server Error');
434
+ }
435
+ }
436
+ ` : "";
437
+ return `// Generated by @timber-js/app — standalone preview server.
438
+ // Do not edit — this file is regenerated on each build.
439
+ // 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.
440
+
441
+ import { createServer } from 'node:http';
442
+ import { readFile, stat } from 'node:fs/promises';
443
+ import { join, extname, sep } from 'node:path';
444
+ import { fileURLToPath } from 'node:url';
445
+ import { canonicalize } from './_canonicalize.mjs';
446
+
447
+ const __dirname = fileURLToPath(new URL('.', import.meta.url));
448
+
449
+ ${handlerSetup}
450
+ const MIME_TYPES = ${JSON.stringify(PREVIEW_MIME_TYPES, null, 2)};
451
+
452
+ // Recorded by the build: content-hashed directories, and the Content-Type of
453
+ // each extensionless API route output (a file name cannot say it). Both are
454
+ // decoded route-space paths, matched against the decoded request path.
455
+ const IMMUTABLE_PREFIXES = ${JSON.stringify(immutablePrefixes)};
456
+ const BASE = ${JSON.stringify(options.base)};
457
+ const CONTENT_TYPES = ${JSON.stringify(contentTypes)};
458
+ const SERVE_DIRECTORY_INDEX = ${options.output === "static"};
459
+
460
+ const publicDir = join(__dirname, 'public');
461
+
462
+ /**
463
+ * The file under publicDir that a decoded URL path names, or null. A static
464
+ * build lays its pages out as <path>/index.html, so a directory serves its
465
+ * index there.
466
+ */
467
+ async function findFile(pathname) {
468
+ const filePath = join(publicDir, pathname);
469
+ // Prevent path traversal (and a sibling like public-other/ passing a bare
470
+ // prefix check).
471
+ if (!filePath.startsWith(publicDir + sep)) return null;
472
+ try {
473
+ const fileStat = await stat(filePath);
474
+ if (fileStat.isFile()) return filePath;
475
+ if (SERVE_DIRECTORY_INDEX && fileStat.isDirectory()) {
476
+ const index = join(filePath, 'index.html');
477
+ if ((await stat(index)).isFile()) return index;
478
+ }
479
+ } catch {
480
+ // Not found.
481
+ }
482
+ return null;
483
+ }
484
+
485
+ /**
486
+ * The route-space path for a request path, or null when the request is
487
+ * outside the deployment base (it names no file of this build).
488
+ */
489
+ function stripBase(pathname) {
490
+ if (BASE === '/') return pathname;
491
+ if (pathname === BASE.slice(0, -1)) return '/';
492
+ if (!pathname.startsWith(BASE)) return null;
493
+ return pathname.slice(BASE.length - 1);
494
+ }
495
+
496
+ async function sendFile(req, res, filePath, status, contentType, cacheControl) {
497
+ const body = await readFile(filePath);
498
+ res.writeHead(status, {
499
+ 'Content-Type': contentType,
500
+ 'Content-Length': body.length,
501
+ 'Cache-Control': cacheControl,
502
+ });
503
+ res.end(req.method === 'HEAD' ? undefined : body);
504
+ }
505
+ ${dynamicHandler}
506
+ // Port resolution (TIM-842):
507
+ // - Default to 3000
508
+ // - If PORT env var is set, honor it strictly (fail loudly on conflict)
509
+ // - Otherwise auto-bump from 3000 until a free port is found
510
+ // Mirrors the dev server behavior so timber dev/preview/production all
511
+ // behave the same way around port selection.
512
+ const envPort = process.env.PORT ? parseInt(process.env.PORT, 10) : null;
513
+ const portIsExplicit = envPort != null && Number.isFinite(envPort) && envPort > 0;
514
+ const startPort = portIsExplicit ? envPort : 3000;
515
+ const host = process.env.HOST || 'localhost';
516
+
517
+ // Set after listenWithBump() resolves so request handlers can build
518
+ // absolute URLs from the actual bound port (which may differ from
519
+ // startPort after an auto-bump).
520
+ let boundPort = startPort;
521
+
522
+ const server = createServer(async (req, res) => {
523
+ // Scheme from the socket's TLS state — a hardcoded http:// breaks CSRF
524
+ // origin comparison and absolute-URL construction when TLS is terminated
525
+ // at this server (TIM-1073; mirrors the dev-server fix in TIM-1067).
526
+ // X-Forwarded-Proto is intentionally not consulted here: on a direct
527
+ // connection it would be attacker-controlled. The CSRF layer honors it
528
+ // separately for reverse-proxy deployments.
529
+ const scheme = req.socket?.encrypted ? 'https' : 'http';
530
+ // An origin-form target ('/path') is concatenated, not resolved against
531
+ // the base: resolved as a relative reference, '//evil.com/' names another
532
+ // host, and the pipeline would see '/' instead of the path it must
533
+ // redirect to '/evil.com' (TIM-1571). Any other form — 'OPTIONS *', an
534
+ // absolute-form target — is resolved as before: concatenating '*' makes
535
+ // an invalid URL, and this callback has no catch around it, so the
536
+ // rejection would take the preview process down.
537
+ const origin = \`\${scheme}://\${host}:\${boundPort}\`;
538
+ const target = req.url || '/';
539
+ const url = target.startsWith('/') ? new URL(origin + target) : new URL(target, origin);
540
+
541
+ // The runtime's own request-boundary canonicalizer (_canonicalize.mjs,
542
+ // compiled from server/canonicalize.ts): one decode, and the same 400s for
543
+ // encoded separators, null bytes, malformed encoding, and escaping the root
544
+ // (design/13-security.md). The base is stripped from its canonical result,
545
+ // so an encoded spelling of the base is the same path. What remains, in
546
+ // route space, is looked up in public/; null names no file.
547
+ const canonical = canonicalize(url.pathname, false);
548
+ const badPath = !canonical.ok;
549
+ const pathname = canonical.ok ? stripBase(canonical.pathname) : null;
550
+ const filePath = pathname === null ? null : await findFile(pathname);
551
+ if (filePath) {
552
+ const contentType =
553
+ CONTENT_TYPES[pathname] || MIME_TYPES[extname(filePath).toLowerCase()] || 'application/octet-stream';
554
+ // Hashed assets get immutable cache, others get short cache.
555
+ const isImmutable = IMMUTABLE_PREFIXES.some((prefix) => pathname.startsWith(prefix));
556
+ const cacheControl = isImmutable ? ${JSON.stringify(IMMUTABLE_CACHE)} : ${JSON.stringify(STATIC_CACHE)};
557
+ await sendFile(req, res, filePath, 200, contentType, cacheControl);
558
+ return;
559
+ }
560
+
561
+ ${fallback}});
562
+
563
+ function listenWithBump(port, attempt = 0) {
564
+ return new Promise((resolveListen, rejectListen) => {
565
+ const onError = (err) => {
566
+ server.removeListener('listening', onListening);
567
+ if (err && err.code === 'EADDRINUSE' && !portIsExplicit && attempt < 100) {
568
+ if (attempt === 0) {
569
+ console.log(\` [timber] Port \${port} in use, trying \${port + 1}...\`);
570
+ }
571
+ listenWithBump(port + 1, attempt + 1).then(resolveListen, rejectListen);
572
+ return;
573
+ }
574
+ rejectListen(err);
575
+ };
576
+ const onListening = () => {
577
+ server.removeListener('error', onError);
578
+ resolveListen(port);
579
+ };
580
+ server.once('error', onError);
581
+ server.once('listening', onListening);
582
+ server.listen(port, host);
583
+ });
584
+ }
585
+
586
+ try {
587
+ boundPort = await listenWithBump(startPort);
588
+ if (boundPort !== startPort) {
589
+ console.log();
590
+ console.log(\` [timber] Port \${startPort} in use, using \${boundPort}\`);
591
+ }
592
+ console.log();
593
+ console.log(' ⚡ timber preview server running at:');
594
+ console.log();
595
+ console.log(\` ➜ http://\${host}:\${boundPort}\`);
596
+ console.log();
597
+ } catch (err) {
598
+ if (err && err.code === 'EADDRINUSE') {
599
+ console.error(\`[timber] Port \${startPort} is already in use. \` +
600
+ 'Set PORT to a free port, or unset PORT to auto-pick.');
601
+ } else {
602
+ console.error('[timber] Failed to start preview server:', err);
603
+ }
604
+ process.exit(1);
605
+ }
606
+ `;
607
+ }
608
+ /** Spawn a Nitro preview process and pipe stdio. */
609
+ function spawnNitroPreview(command, args, cwd) {
610
+ return new Promise((resolve, reject) => {
611
+ const child = execFile(command, args, { cwd }, (err) => {
612
+ if (err) reject(err);
613
+ else resolve();
614
+ });
615
+ child.stdout?.pipe(process.stdout);
616
+ child.stderr?.pipe(process.stderr);
617
+ });
618
+ }
619
+ /**
620
+ * Generate a standalone ESM module that exports sendNodeResponse.
621
+ *
622
+ * Mirrors srvx/node's sendNodeResponse: status + headers via writeHead,
623
+ * body streaming with backpressure (waits for drain on write() === false),
624
+ * and client disconnect cleanup. Written to `_send-response.mjs` during
625
+ * buildOutput for use by the preview server script. See TIM-1154.
626
+ *
627
+ * @internal Exported for testing.
628
+ */
629
+ function generateSendResponseModule() {
630
+ return `// Generated by @timber-js/app — Web→Node response bridge.
631
+ // Do not edit — this file is regenerated on each build.
632
+ // Mirrors srvx/node's sendNodeResponse with backpressure support.
633
+
634
+ export function sendNodeResponse(nodeRes, webRes) {
635
+ if (!webRes) {
636
+ nodeRes.statusCode = 500;
637
+ return new Promise((resolve) => nodeRes.end(resolve));
638
+ }
639
+ // A response with a Node body (timber's NodeBodyResponse, srvx's protocol):
640
+ // pipe it straight to the socket, no Web Streams round trip. pipe() rather
641
+ // than pipeline(), which allocates an AbortController and an error on every
642
+ // finish; a client that disconnects early destroys the body (aborting the
643
+ // render), and a body that errors destroys the socket.
644
+ if (typeof webRes._toNodeResponse === 'function') {
645
+ const res = webRes._toNodeResponse();
646
+ if (res.body && typeof res.body.pipe === 'function') {
647
+ if (!nodeRes.headersSent) {
648
+ if (nodeRes.req?.httpVersion === '2.0') {
649
+ nodeRes.writeHead(res.status, res.headers);
650
+ } else {
651
+ nodeRes.writeHead(res.status, res.statusText, res.headers);
652
+ }
653
+ }
654
+ const body = res.body;
655
+ // The client already left: 'close' has fired and will not again.
656
+ if (nodeRes.destroyed) {
657
+ body.destroy();
658
+ return;
659
+ }
660
+ return new Promise((resolve) => {
661
+ nodeRes.once('close', () => {
662
+ if (!body.readableEnded) body.destroy();
663
+ resolve();
664
+ });
665
+ nodeRes.on('error', () => body.destroy());
666
+ body.once('error', (error) => nodeRes.destroy(error));
667
+ body.pipe(nodeRes);
668
+ });
669
+ }
670
+ webRes = new Response(res.body, { status: res.status, statusText: res.statusText, headers: pairs(res.headers) });
671
+ }
672
+ const rawHeaders = [...webRes.headers];
673
+ const writeHeaders = rawHeaders.flat();
674
+ if (!nodeRes.headersSent) {
675
+ if (nodeRes.req?.httpVersion === '2.0') {
676
+ nodeRes.writeHead(webRes.status, writeHeaders);
677
+ } else {
678
+ nodeRes.writeHead(webRes.status, webRes.statusText, writeHeaders);
679
+ }
680
+ }
681
+ if (!webRes.body) {
682
+ return new Promise((resolve) => nodeRes.end(resolve));
683
+ }
684
+ // Stream with backpressure: pause reading when the kernel buffer is
685
+ // full (write() returns false) and resume on 'drain'.
686
+ if (nodeRes.destroyed) {
687
+ webRes.body.cancel();
688
+ return;
689
+ }
690
+ const reader = webRes.body.getReader();
691
+ function streamCancel(error) {
692
+ reader.cancel(error).catch(() => {});
693
+ if (error) nodeRes.destroy(error);
694
+ }
695
+ function streamHandle({ done, value }) {
696
+ try {
697
+ if (done) {
698
+ nodeRes.end();
699
+ } else if (nodeRes.write(value)) {
700
+ reader.read().then(streamHandle, streamCancel);
701
+ } else {
702
+ nodeRes.once('drain', () => reader.read().then(streamHandle, streamCancel));
703
+ }
704
+ } catch (error) {
705
+ streamCancel(error instanceof Error ? error : undefined);
706
+ }
707
+ }
708
+ nodeRes.on('close', streamCancel);
709
+ nodeRes.on('error', streamCancel);
710
+ reader.read().then(streamHandle, streamCancel);
711
+ return reader.closed.catch(streamCancel).finally(() => {
712
+ nodeRes.off('close', streamCancel);
713
+ nodeRes.off('error', streamCancel);
714
+ });
715
+ }
716
+
717
+ function pairs(flat) {
718
+ const out = [];
719
+ for (let i = 0; i < flat.length; i += 2) out.push([flat[i], flat[i + 1]]);
720
+ return out;
721
+ }
722
+ `;
723
+ }
724
+ //#endregion
725
+ //#region src/adapters/nitro.ts
174
726
  /**
175
727
  * Create a Nitro-based adapter for multi-platform deployment.
176
728
  *
@@ -190,50 +742,82 @@ var PRESET_CONFIGS = {
190
742
  function nitro(options = {}) {
191
743
  const preset = options.preset ?? "node-server";
192
744
  const compress = options.compress ?? true;
193
- const presetConfig = PRESET_CONFIGS[preset];
194
- const pendingPromises = [];
195
745
  return {
196
746
  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) {
747
+ async buildOutput(config, artifacts) {
748
+ const outDir = join(artifacts.outputDir, "nitro");
749
+ if (artifacts.output === "static") {
750
+ await buildStaticDirectoryOutput(config, artifacts, outDir, "public");
751
+ const publicDir = join(outDir, "public");
752
+ await writeHeadersFile(publicDir, config, artifacts);
753
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
754
+ await writeFile(join(outDir, PREVIEW_SCRIPT), generatePreviewScript({
755
+ output: "static",
756
+ immutableDirs: artifacts.immutableDirs,
757
+ base: adapterBase(config),
758
+ contentTypes: artifacts.contentTypes
759
+ }));
760
+ if ((options.staticTarget ?? "generic") === "github-pages") {
761
+ await writeFile(join(publicDir, ".nojekyll"), "");
762
+ try {
763
+ 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.");
764
+ } catch {}
765
+ }
766
+ return;
767
+ }
768
+ await runSharedBuildSteps({
769
+ config,
770
+ artifacts,
771
+ outDir,
772
+ publicDirName: "public"
773
+ });
774
+ await writeFile(join(outDir, "_compress.mjs"), await generateCompressModule());
775
+ await writeFile(join(outDir, "_send-response.mjs"), generateSendResponseModule());
776
+ if (LOCALLY_PREVIEWABLE.has(preset)) {
777
+ await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());
778
+ await writeFile(join(outDir, PREVIEW_SCRIPT), generatePreviewScript({
779
+ output: "server",
780
+ runtimeName: PRESET_CONFIGS[preset].runtimeName,
781
+ rscEntry: importSpecifier(outDir, join(artifacts.rsc.path, "index.js")),
782
+ hasManifestInit: !!artifacts.manifestInit,
783
+ immutableDirs: artifacts.immutableDirs,
784
+ base: adapterBase(config)
785
+ }));
786
+ }
787
+ if (artifacts.manifestInit) {
213
788
  const rscEntry = join(outDir, "rsc", "index.js");
214
789
  const rscContent = await readFile(rscEntry, "utf-8");
215
- await writeFile(rscEntry, `${config.manifestInit}\n${rscContent}`);
790
+ await writeFile(rscEntry, `${artifacts.manifestInit}\n${rscContent}`);
216
791
  }
217
- const entry = generateNitroEntry(buildDir, outDir, preset, compress);
792
+ const entry = generateNitroEntry(preset, compress, artifacts.immutableDirs);
218
793
  await writeFile(join(outDir, "entry.ts"), entry);
219
- await runNitroBuild(outDir, preset, options.nitroConfig);
794
+ const { serverDir } = await runNitroBuild(outDir, preset, artifacts.immutableDirs, options.nitroConfig);
795
+ if (artifacts.prebuilt) {
796
+ const prebuiltSrc = artifacts.prebuilt.path;
797
+ await cp(prebuiltSrc, join(serverDir, "prebuilt"), { recursive: true });
798
+ if (preset === "vercel" || preset === "vercel-edge") await copyPrebuiltToVercelFuncClones(dirname(serverDir), prebuiltSrc, basename(serverDir));
799
+ }
220
800
  },
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
801
+ async preview(_config, { output, outputDir }) {
802
+ 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.`);
803
+ const nitroDir = join(outputDir, "nitro");
804
+ const script = join(nitroDir, PREVIEW_SCRIPT);
805
+ if (!existsSync(script)) throw new Error(`[timber] No preview server at ${script}. Run \`timber build\` before \`timber preview\`.`);
806
+ await spawnNitroPreview(output === "server" && preset === "bun" ? "bun" : process.execPath, [script], nitroDir);
807
+ }
233
808
  };
234
809
  }
810
+ /** The preview server buildOutput writes into the Nitro output directory. */
811
+ var PREVIEW_SCRIPT = "_preview-server.mjs";
812
+ /** The request-path canonicalizer the preview server imports beside it. */
813
+ var CANONICALIZE_MODULE = "_canonicalize.mjs";
814
+ /** A relative ESM import specifier for `file`, as imported from a module in `fromDir`. */
815
+ function importSpecifier(fromDir, file) {
816
+ const path = relative(fromDir, file).split(sep).join("/");
817
+ return path.startsWith("../") ? path : "./" + path;
818
+ }
235
819
  /** @internal Exported for testing. */
236
- function generateNitroEntry(buildDir, outDir, preset, compress = true, hasManifestInit = false) {
820
+ function generateNitroEntry(preset, compress = true, immutableDirs = []) {
237
821
  const serverEntryRelative = "./rsc/index.js";
238
822
  const runtimeName = PRESET_CONFIGS[preset].runtimeName;
239
823
  const earlyHints = PRESET_CONFIGS[preset].supportsEarlyHints;
@@ -271,11 +855,15 @@ function generateNitroEntry(buildDir, outDir, preset, compress = true, hasManife
271
855
  ? await runWithWaitUntil(waitUntilFn, () => handler(webRequest))
272
856
  : await handler(webRequest)`;
273
857
  else handlerCall = ` const webResponse = await handler(webRequest)`;
858
+ const waitUntilImport = supportsWaitUntil ? ", runWithWaitUntil" : "";
859
+ const compressImport = compress ? "import { compressResponse } from './_compress.mjs'\n" : "";
860
+ const compressCall = compress ? "compressResponse(webRequest, webResponse)" : "webResponse";
861
+ const immutableAssets = immutableAssetsEntryGuard(immutableDirs);
274
862
  return `// Generated by @timber-js/app/adapters/nitro
275
863
  // Do not edit — this file is regenerated on each build.
276
864
 
277
- ${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler, { runWithEarlyHintsSender${supportsWaitUntil ? ", runWithWaitUntil" : ""} } from '${serverEntryRelative}'
278
- ${compress ? "import { compressResponse } from './_compress.mjs'\n" : ""}
865
+ import handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'
866
+ ${compressImport}${immutableAssets.imports}
279
867
  // Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
280
868
  // See design/25-production-deployments.md §"TIMBER_RUNTIME".
281
869
  process.env.TIMBER_RUNTIME = '${runtimeName}'
@@ -286,261 +874,125 @@ process.env.TIMBER_RUNTIME = '${runtimeName}'
286
874
  // Nitro bundles h3 into its internal _libs/ directory but doesn't make
287
875
  // it available as a bare specifier in the output's node_modules.
288
876
  export default async function timberHandler(event) {
289
- // h3 v2: event.req is the Web Request
877
+ ${immutableAssets.guard} // h3 v2: event.req is the Web Request
290
878
  const webRequest = event.req
291
879
  ${handlerCall}
292
- return ${compress ? "compressResponse(webRequest, webResponse)" : "webResponse"}
880
+ return ${compressCall}
293
881
  }
294
882
  `;
295
883
  }
884
+ /**
885
+ * Prefixes of nitro build-output lines that give wrong advice for timber
886
+ * builds. Every nitro bundler path emits these hints via `logger.success` —
887
+ * the rollup path hardcodes `npx nitro preview`; rolldown and vite default
888
+ * to it. That command resolves `.output/nitro.json` relative to cwd, but
889
+ * timber's nitro build lives at `.timber/dist/nitro/.output`, so the
890
+ * suggested command can never work from the project root.
891
+ * Prefix matching degrades gracefully: if upstream rewords the line
892
+ * entirely, it passes through rather than being silently eaten.
893
+ */
894
+ var NITRO_PREVIEW_HINT_PREFIX = "You can preview this build using";
895
+ var NITRO_DEPLOY_HINT_PREFIX = "You can deploy this build using";
896
+ var SUPPRESSED_NITRO_HINT_PREFIXES = [NITRO_PREVIEW_HINT_PREFIX, NITRO_DEPLOY_HINT_PREFIX];
296
897
  /** @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
- `;
898
+ function isSuppressedNitroHint(message, prefixes = SUPPRESSED_NITRO_HINT_PREFIXES) {
899
+ return typeof message === "string" && prefixes.some((prefix) => message.startsWith(prefix));
314
900
  }
315
- /** Presets that produce a locally-runnable server entry. */
316
- var LOCALLY_PREVIEWABLE = new Set(["node-server", "bun"]);
317
901
  /**
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.
902
+ * Nitro's rolldown and vite builders render `framework.previewCommand` /
903
+ * `framework.deployCommand` into these hints. A user who explicitly set one
904
+ * via `nitroConfig` has provided valid guidance — only suppress the hints
905
+ * whose command is still nitro's broken default.
322
906
  *
323
907
  * @internal Exported for testing.
324
908
  */
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}');
348
- }
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
- `;
909
+ function selectSuppressedHintPrefixes(framework) {
910
+ return [...framework?.previewCommand ? [] : [NITRO_PREVIEW_HINT_PREFIX], ...framework?.deployCommand ? [] : [NITRO_DEPLOY_HINT_PREFIX]];
489
911
  }
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
912
+ /**
913
+ * Wrap a nitro logger's `success` so hardcoded preview/deploy hints are
914
+ * dropped for this programmatic build only. Returns the original
915
+ * (unfiltered) success fn so timber can print its own hint — which shares
916
+ * the suppressed prefix on purpose, replacing nitro's wording.
917
+ *
918
+ * @internal Exported for testing.
919
+ */
920
+ function wrapNitroLoggerForBuild(logger, prefixes = SUPPRESSED_NITRO_HINT_PREFIXES) {
921
+ const originalSuccess = logger.success.bind(logger);
922
+ const wrapped = (message, ...args) => {
923
+ if (isSuppressedNitroHint(message, prefixes)) return;
924
+ originalSuccess(message, ...args);
499
925
  };
926
+ logger.success = Object.assign(wrapped, logger.success);
927
+ return originalSuccess;
928
+ }
929
+ /**
930
+ * Timber's own post-build hint. Locally-runnable presets are previewed via
931
+ * `timber preview`, which invokes this adapter's `preview()` to run the
932
+ * generated `_preview-server.mjs`. Serverless presets get no hint — their
933
+ * output lives under `.timber/dist/nitro/`, so any cwd-relative deploy
934
+ * command would be as wrong as the nitro hint this replaces.
935
+ *
936
+ * @internal Exported for testing.
937
+ */
938
+ function getPostBuildHint(preset) {
939
+ return LOCALLY_PREVIEWABLE.has(preset) ? "You can preview this build using `timber preview`" : null;
500
940
  }
501
941
  /**
502
942
  * Run the Nitro production build using the programmatic API.
503
943
  * Uses dynamic import so nitro is only loaded at build time.
504
944
  * Externalizes the timber RSC/SSR output — those files are pre-built
505
945
  * by timber and have internal references that nitro's bundler can't follow.
946
+ *
947
+ * @internal Exported for testing.
506
948
  */
507
- async function runNitroBuild(nitroDir, preset, userConfig) {
949
+ async function runNitroBuild(nitroDir, preset, immutableDirs, userConfig) {
508
950
  const presetConfig = PRESET_CONFIGS[preset];
951
+ const immutableAssets = await prepareImmutableAssets(nitroDir, immutableDirs);
509
952
  const { createNitro, build: nitroBuild, prepare, copyPublicAssets } = await import("nitro/builder");
510
953
  const nitro = await createNitro({
511
954
  rootDir: nitroDir,
512
955
  preset: presetConfig.nitroPreset,
513
956
  renderer: { handler: join(nitroDir, "entry.ts") },
514
957
  output: { dir: join(nitroDir, presetConfig.outputDir) },
515
- routeRules: { "/assets/**": { headers: { "Cache-Control": IMMUTABLE_CACHE } } },
516
958
  rollupConfig: { external: [/\.\.\/rsc\//] },
517
959
  ...presetConfig.extraConfig,
518
- ...userConfig
960
+ ...userConfig,
961
+ publicAssets: [...immutableAssets.publicAssets, ...userConfig?.publicAssets ?? []],
962
+ plugins: [...immutableAssets.plugins, ...userConfig?.plugins ?? []]
519
963
  });
964
+ const framework = nitro.options.builder === "rollup" ? void 0 : nitro.options.framework;
965
+ const logSuccess = wrapNitroLoggerForBuild(nitro.logger, selectSuppressedHintPrefixes(framework));
966
+ const raw = nitro.options.output.serverDir;
967
+ const serverDir = raw.endsWith("/") ? raw.slice(0, -1) : raw;
520
968
  await prepare(nitro);
521
969
  await copyPublicAssets(nitro);
522
970
  await nitroBuild(nitro);
523
971
  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
- });
972
+ const hint = framework?.previewCommand ? null : getPostBuildHint(preset);
973
+ if (hint) logSuccess(hint);
974
+ return { serverDir };
535
975
  }
536
976
  /**
537
- * Get the preset configuration for a given preset name.
977
+ * Copy prebuilt payloads into cloned Vercel function directories.
978
+ *
979
+ * When users configure `vercel.functionRules`, Nitro's compiled hook clones
980
+ * the base __server.func to per-route .func directories. These clones are
981
+ * created during `runNitroBuild()` — before our post-build prebuilt copy.
982
+ * Each clone resolves `../prebuilt` independently, so they each need a copy.
983
+ *
538
984
  * @internal Exported for testing.
539
985
  */
540
- function getPresetConfig(preset) {
541
- return PRESET_CONFIGS[preset];
986
+ async function copyPrebuiltToVercelFuncClones(functionsDir, prebuiltSrc, baseFuncName) {
987
+ const funcDirs = [];
988
+ try {
989
+ for await (const match of glob("**/*.func", { cwd: functionsDir })) if (!match.endsWith(baseFuncName)) funcDirs.push(join(functionsDir, match));
990
+ } catch {
991
+ return;
992
+ }
993
+ await Promise.all(funcDirs.map((dir) => cp(prebuiltSrc, join(dir, "prebuilt"), { recursive: true })));
542
994
  }
543
995
  //#endregion
544
- export { generateNitroConfig, generateNitroEntry, generateNitroPreviewCommand, generatePreviewScript, getPresetConfig, nitro };
996
+ export { copyPrebuiltToVercelFuncClones, generateNitroEntry, getPostBuildHint, isSuppressedNitroHint, nitro, runNitroBuild, selectSuppressedHintPrefixes, wrapNitroLoggerForBuild };
545
997
 
546
998
  //# sourceMappingURL=nitro.js.map