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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1575) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +389 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
  5. package/dist/_chunks/actions-CYjRMpZI.js.map +1 -0
  6. package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
  7. package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
  8. package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
  9. package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
  10. package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
  11. package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
  12. package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
  13. package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
  14. package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
  15. package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
  16. package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
  17. package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
  18. package/dist/_chunks/chains-D-RRc7CM.js +266 -0
  19. package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
  20. package/dist/_chunks/chains-KblEfYzm.js +1 -0
  21. package/dist/_chunks/classify-_W0RWa5w.js +146 -0
  22. package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
  23. package/dist/_chunks/cli-check-BAKOSTkg.js +251 -0
  24. package/dist/_chunks/cli-check-BAKOSTkg.js.map +1 -0
  25. package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
  26. package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
  27. package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
  28. package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
  29. package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
  30. package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
  31. package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
  32. package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
  33. package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
  34. package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
  35. package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
  36. package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
  37. package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
  38. package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
  39. package/dist/_chunks/codec-registry-C8hOGmZo.js +13 -0
  40. package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
  41. package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
  42. package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
  43. package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
  44. package/dist/_chunks/convention-lint-D54k6uUM.js.map +1 -0
  45. package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
  46. package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
  47. package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
  48. package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
  49. package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
  50. package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
  51. package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
  52. package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
  53. package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
  54. package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
  55. package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
  56. package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
  57. package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
  58. package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
  59. package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
  60. package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
  61. package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
  62. package/dist/_chunks/format-DuPOoXUP.js +13 -0
  63. package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
  64. package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
  65. package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
  66. package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
  67. package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
  68. package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
  69. package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
  70. package/dist/_chunks/href-BtspoNc9.js +164 -0
  71. package/dist/_chunks/href-BtspoNc9.js.map +1 -0
  72. package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
  73. package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
  74. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  75. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  76. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  77. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  78. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  79. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  80. package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
  81. package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
  82. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  83. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  84. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  85. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  86. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  87. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  88. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  89. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  90. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  91. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  92. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  93. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  94. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  95. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  96. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  97. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  98. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  99. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  100. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  101. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  102. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  103. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  104. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  105. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  106. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  107. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  108. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  109. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  110. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  111. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  112. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  113. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  114. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  115. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  116. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  117. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  118. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  119. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  120. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  121. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  122. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  123. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  124. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  125. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  126. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  127. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  128. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  129. package/dist/_chunks/state-B-EBjeER.js +49 -0
  130. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  131. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  132. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  133. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  134. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  135. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  136. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  137. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  138. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  139. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  140. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  141. package/dist/adapters/build-output-helper.d.ts +81 -0
  142. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  143. package/dist/adapters/canonicalize-module.d.ts +8 -0
  144. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  145. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  146. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-dev.js +73 -0
  148. package/dist/adapters/cloudflare-dev.js.map +1 -0
  149. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  150. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  151. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  152. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  153. package/dist/adapters/cloudflare.d.ts +217 -24
  154. package/dist/adapters/cloudflare.d.ts.map +1 -1
  155. package/dist/adapters/cloudflare.js +1 -188
  156. package/dist/adapters/compress-module.d.ts +25 -4
  157. package/dist/adapters/compress-module.d.ts.map +1 -1
  158. package/dist/adapters/fs-identity.d.ts +63 -0
  159. package/dist/adapters/fs-identity.d.ts.map +1 -0
  160. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  161. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  162. package/dist/adapters/nitro-presets.d.ts +37 -0
  163. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  164. package/dist/adapters/nitro-preview.d.ts +65 -0
  165. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  166. package/dist/adapters/nitro.d.ts +69 -38
  167. package/dist/adapters/nitro.d.ts.map +1 -1
  168. package/dist/adapters/nitro.js +837 -347
  169. package/dist/adapters/nitro.js.map +1 -1
  170. package/dist/adapters/shared.d.ts +85 -0
  171. package/dist/adapters/shared.d.ts.map +1 -0
  172. package/dist/adapters/types.d.ts +124 -16
  173. package/dist/adapters/types.d.ts.map +1 -1
  174. package/dist/adapters/types.js +0 -0
  175. package/dist/analyze/chains.d.ts +124 -0
  176. package/dist/analyze/chains.d.ts.map +1 -0
  177. package/dist/analyze/classify.d.ts +153 -0
  178. package/dist/analyze/classify.d.ts.map +1 -0
  179. package/dist/analyze/crawl-entry.d.ts +17 -0
  180. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  181. package/dist/analyze/crawl-entry.js +312 -0
  182. package/dist/analyze/crawl-entry.js.map +1 -0
  183. package/dist/analyze/crawl.d.ts +134 -0
  184. package/dist/analyze/crawl.d.ts.map +1 -0
  185. package/dist/analyze/graph-cache.d.ts +104 -0
  186. package/dist/analyze/graph-cache.d.ts.map +1 -0
  187. package/dist/analyze/graph-command.d.ts +43 -0
  188. package/dist/analyze/graph-command.d.ts.map +1 -0
  189. package/dist/analyze/graph-command.js +386 -0
  190. package/dist/analyze/graph-command.js.map +1 -0
  191. package/dist/analyze/live-graph.d.ts +81 -0
  192. package/dist/analyze/live-graph.d.ts.map +1 -0
  193. package/dist/analyze/poison-rules.d.ts +72 -0
  194. package/dist/analyze/poison-rules.d.ts.map +1 -0
  195. package/dist/analyze/poison-scan.d.ts +48 -0
  196. package/dist/analyze/poison-scan.d.ts.map +1 -0
  197. package/dist/analyze/scan.d.ts +73 -0
  198. package/dist/analyze/scan.d.ts.map +1 -0
  199. package/dist/cache/cache-api.d.ts +48 -0
  200. package/dist/cache/cache-api.d.ts.map +1 -0
  201. package/dist/cache/fast-hash.d.ts +5 -0
  202. package/dist/cache/fast-hash.d.ts.map +1 -1
  203. package/dist/cache/guarded-read.d.ts +29 -0
  204. package/dist/cache/guarded-read.d.ts.map +1 -0
  205. package/dist/cache/handler-store.d.ts +45 -0
  206. package/dist/cache/handler-store.d.ts.map +1 -0
  207. package/dist/cache/index.d.ts +32 -9
  208. package/dist/cache/index.d.ts.map +1 -1
  209. package/dist/cache/index.js +4 -326
  210. package/dist/cache/invalidation-epoch.d.ts +50 -0
  211. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  212. package/dist/cache/json-lossy-check.d.ts +11 -0
  213. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  214. package/dist/cache/key-discipline.d.ts +61 -0
  215. package/dist/cache/key-discipline.d.ts.map +1 -0
  216. package/dist/cache/redis-handler.d.ts +140 -9
  217. package/dist/cache/redis-handler.d.ts.map +1 -1
  218. package/dist/cache/singleflight.d.ts +31 -2
  219. package/dist/cache/singleflight.d.ts.map +1 -1
  220. package/dist/cache/sizeof.d.ts +22 -0
  221. package/dist/cache/sizeof.d.ts.map +1 -0
  222. package/dist/cache/stable-stringify.d.ts +15 -0
  223. package/dist/cache/stable-stringify.d.ts.map +1 -1
  224. package/dist/cache/store.d.ts +53 -0
  225. package/dist/cache/store.d.ts.map +1 -0
  226. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  227. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  228. package/dist/cache/stores/cloudflare-kv.js +28 -0
  229. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  230. package/dist/cache/stores/memory.d.ts +42 -0
  231. package/dist/cache/stores/memory.d.ts.map +1 -0
  232. package/dist/cache/stores/memory.js +89 -0
  233. package/dist/cache/stores/memory.js.map +1 -0
  234. package/dist/cache/stores/redis.d.ts +69 -0
  235. package/dist/cache/stores/redis.d.ts.map +1 -0
  236. package/dist/cache/stores/redis.js +34 -0
  237. package/dist/cache/stores/redis.js.map +1 -0
  238. package/dist/cache/stores/vercel.d.ts +36 -0
  239. package/dist/cache/stores/vercel.d.ts.map +1 -0
  240. package/dist/cache/stores/vercel.js +32 -0
  241. package/dist/cache/stores/vercel.js.map +1 -0
  242. package/dist/cache/tag-aware-handler.d.ts +51 -0
  243. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  244. package/dist/cache/timber-cache.d.ts +25 -11
  245. package/dist/cache/timber-cache.d.ts.map +1 -1
  246. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  247. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  248. package/dist/cdn/cloudflare-purge.js +29 -0
  249. package/dist/cdn/cloudflare-purge.js.map +1 -0
  250. package/dist/cdn/fastly-purge.d.ts +25 -0
  251. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  252. package/dist/cdn/fastly-purge.js +32 -0
  253. package/dist/cdn/fastly-purge.js.map +1 -0
  254. package/dist/cdn/headers.d.ts +97 -0
  255. package/dist/cdn/headers.d.ts.map +1 -0
  256. package/dist/cdn/index.d.ts +5 -0
  257. package/dist/cdn/index.d.ts.map +1 -0
  258. package/dist/cdn/index.js +93 -0
  259. package/dist/cdn/index.js.map +1 -0
  260. package/dist/cdn/purge-store.d.ts +32 -0
  261. package/dist/cdn/purge-store.d.ts.map +1 -0
  262. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  263. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  264. package/dist/cdn/workers-cache-purge.js +33 -0
  265. package/dist/cdn/workers-cache-purge.js.map +1 -0
  266. package/dist/cli-check.d.ts +133 -0
  267. package/dist/cli-check.d.ts.map +1 -0
  268. package/dist/cli-context.d.ts +62 -0
  269. package/dist/cli-context.d.ts.map +1 -0
  270. package/dist/cli-dev-status.d.ts +75 -0
  271. package/dist/cli-dev-status.d.ts.map +1 -0
  272. package/dist/cli-init.d.ts +72 -0
  273. package/dist/cli-init.d.ts.map +1 -0
  274. package/dist/cli-schema-sync.d.ts +59 -0
  275. package/dist/cli-schema-sync.d.ts.map +1 -0
  276. package/dist/cli.d.ts +80 -16
  277. package/dist/cli.d.ts.map +1 -1
  278. package/dist/cli.js +210 -69
  279. package/dist/cli.js.map +1 -1
  280. package/dist/client/browser-dev.d.ts +42 -2
  281. package/dist/client/browser-dev.d.ts.map +1 -1
  282. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  283. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  284. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  285. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  286. package/dist/client/browser-entry/form-state.d.ts +22 -0
  287. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  288. package/dist/client/browser-entry/hmr.d.ts +27 -0
  289. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  290. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  291. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  292. package/dist/client/browser-entry/index.d.ts +32 -0
  293. package/dist/client/browser-entry/index.d.ts.map +1 -0
  294. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  295. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  296. package/dist/client/browser-entry/router-init.d.ts +41 -0
  297. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  298. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  299. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  300. package/dist/client/browser-entry/scroll.d.ts +28 -0
  301. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  302. package/dist/client/deny-last-resort.d.ts +29 -0
  303. package/dist/client/deny-last-resort.d.ts.map +1 -0
  304. package/dist/client/dev-pill/index.d.ts +32 -0
  305. package/dist/client/dev-pill/index.d.ts.map +1 -0
  306. package/dist/client/dev-pill/store.d.ts +105 -0
  307. package/dist/client/dev-pill/store.d.ts.map +1 -0
  308. package/dist/client/dev-pill/view.d.ts +9 -0
  309. package/dist/client/dev-pill/view.d.ts.map +1 -0
  310. package/dist/client/error-boundary.d.ts +58 -9
  311. package/dist/client/error-boundary.d.ts.map +1 -1
  312. package/dist/client/error-boundary.js +1 -126
  313. package/dist/client/error-reconstituter.d.ts +55 -0
  314. package/dist/client/error-reconstituter.d.ts.map +1 -0
  315. package/dist/client/form.d.ts +38 -99
  316. package/dist/client/form.d.ts.map +1 -1
  317. package/dist/client/global-context.d.ts +35 -0
  318. package/dist/client/global-context.d.ts.map +1 -0
  319. package/dist/client/history.d.ts +50 -9
  320. package/dist/client/history.d.ts.map +1 -1
  321. package/dist/client/index.d.ts +23 -33
  322. package/dist/client/index.d.ts.map +1 -1
  323. package/dist/client/index.js +330 -1273
  324. package/dist/client/index.js.map +1 -1
  325. package/dist/client/internal.d.ts +20 -0
  326. package/dist/client/internal.d.ts.map +1 -0
  327. package/dist/client/internal.js +785 -0
  328. package/dist/client/internal.js.map +1 -0
  329. package/dist/client/link.d.ts +75 -71
  330. package/dist/client/link.d.ts.map +1 -1
  331. package/dist/client/location-search.d.ts +12 -0
  332. package/dist/client/location-search.d.ts.map +1 -0
  333. package/dist/client/navigation-api.d.ts +95 -0
  334. package/dist/client/navigation-api.d.ts.map +1 -0
  335. package/dist/client/navigation-commit.d.ts +111 -0
  336. package/dist/client/navigation-commit.d.ts.map +1 -0
  337. package/dist/client/navigation-context.d.ts +75 -37
  338. package/dist/client/navigation-context.d.ts.map +1 -1
  339. package/dist/client/navigation-root.d.ts +106 -0
  340. package/dist/client/navigation-root.d.ts.map +1 -0
  341. package/dist/client/navigation-transition.d.ts +255 -0
  342. package/dist/client/navigation-transition.d.ts.map +1 -0
  343. package/dist/client/nuqs-adapter.d.ts +5 -2
  344. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  345. package/dist/client/params-context.d.ts +81 -0
  346. package/dist/client/params-context.d.ts.map +1 -0
  347. package/dist/client/react-root.d.ts +51 -0
  348. package/dist/client/react-root.d.ts.map +1 -0
  349. package/dist/client/router-effects.d.ts +203 -0
  350. package/dist/client/router-effects.d.ts.map +1 -0
  351. package/dist/client/router-lifecycle.d.ts +107 -0
  352. package/dist/client/router-lifecycle.d.ts.map +1 -0
  353. package/dist/client/router-pipeline.d.ts +81 -0
  354. package/dist/client/router-pipeline.d.ts.map +1 -0
  355. package/dist/client/router-ref.d.ts +2 -2
  356. package/dist/client/router-ref.d.ts.map +1 -1
  357. package/dist/client/router-skew.d.ts +21 -0
  358. package/dist/client/router-skew.d.ts.map +1 -0
  359. package/dist/client/router-types.d.ts +294 -0
  360. package/dist/client/router-types.d.ts.map +1 -0
  361. package/dist/client/router-url.d.ts +24 -0
  362. package/dist/client/router-url.d.ts.map +1 -0
  363. package/dist/client/router.d.ts +1 -97
  364. package/dist/client/router.d.ts.map +1 -1
  365. package/dist/client/rsc-fetch.d.ts +110 -28
  366. package/dist/client/rsc-fetch.d.ts.map +1 -1
  367. package/dist/client/segment-cache.d.ts +186 -25
  368. package/dist/client/segment-cache.d.ts.map +1 -1
  369. package/dist/client/segment-context.d.ts.map +1 -1
  370. package/dist/client/segment-outlet.d.ts +68 -0
  371. package/dist/client/segment-outlet.d.ts.map +1 -0
  372. package/dist/client/segment-update-context.d.ts +15 -0
  373. package/dist/client/segment-update-context.d.ts.map +1 -0
  374. package/dist/client/shallow-url.d.ts +10 -0
  375. package/dist/client/shallow-url.d.ts.map +1 -0
  376. package/dist/client/slot-content-cache-context.d.ts +35 -0
  377. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  378. package/dist/client/slot-context.d.ts +31 -0
  379. package/dist/client/slot-context.d.ts.map +1 -0
  380. package/dist/client/slot-outlet.d.ts +16 -0
  381. package/dist/client/slot-outlet.d.ts.map +1 -0
  382. package/dist/client/slot-provider.d.ts +25 -0
  383. package/dist/client/slot-provider.d.ts.map +1 -0
  384. package/dist/client/ssr-data.d.ts +26 -50
  385. package/dist/client/ssr-data.d.ts.map +1 -1
  386. package/dist/client/stale-client.d.ts +69 -0
  387. package/dist/client/stale-client.d.ts.map +1 -0
  388. package/dist/client/state.d.ts +21 -13
  389. package/dist/client/state.d.ts.map +1 -1
  390. package/dist/client/status-page-marker.d.ts +25 -0
  391. package/dist/client/status-page-marker.d.ts.map +1 -0
  392. package/dist/client/top-loader.d.ts +7 -6
  393. package/dist/client/top-loader.d.ts.map +1 -1
  394. package/dist/client/unload-guard.d.ts +5 -0
  395. package/dist/client/unload-guard.d.ts.map +1 -1
  396. package/dist/client/use-cookie.d.ts +25 -0
  397. package/dist/client/use-cookie.d.ts.map +1 -1
  398. package/dist/client/use-field-state.d.ts +42 -0
  399. package/dist/client/use-field-state.d.ts.map +1 -0
  400. package/dist/client/use-link-status.d.ts +5 -5
  401. package/dist/client/use-link-status.d.ts.map +1 -1
  402. package/dist/client/use-pathname.d.ts +13 -11
  403. package/dist/client/use-pathname.d.ts.map +1 -1
  404. package/dist/client/use-pending-navigation.d.ts +47 -0
  405. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  406. package/dist/client/use-query-states.d.ts +10 -4
  407. package/dist/client/use-query-states.d.ts.map +1 -1
  408. package/dist/client/use-router.d.ts +15 -8
  409. package/dist/client/use-router.d.ts.map +1 -1
  410. package/dist/client/use-search-params.d.ts +15 -8
  411. package/dist/client/use-search-params.d.ts.map +1 -1
  412. package/dist/client/use-segment-params.d.ts +55 -0
  413. package/dist/client/use-segment-params.d.ts.map +1 -0
  414. package/dist/codec.d.ts +69 -0
  415. package/dist/codec.d.ts.map +1 -0
  416. package/dist/codec.js +75 -0
  417. package/dist/codec.js.map +1 -0
  418. package/dist/config-types.d.ts +366 -0
  419. package/dist/config-types.d.ts.map +1 -0
  420. package/dist/config-validation.d.ts +68 -0
  421. package/dist/config-validation.d.ts.map +1 -0
  422. package/dist/cookies/define-cookie.d.ts +58 -25
  423. package/dist/cookies/define-cookie.d.ts.map +1 -1
  424. package/dist/cookies/index.d.ts +3 -2
  425. package/dist/cookies/index.d.ts.map +1 -1
  426. package/dist/cookies/index.js +230 -37
  427. package/dist/cookies/index.js.map +1 -1
  428. package/dist/cookies/json-cookie.d.ts +64 -0
  429. package/dist/cookies/json-cookie.d.ts.map +1 -0
  430. package/dist/cookies/validation.d.ts +34 -0
  431. package/dist/cookies/validation.d.ts.map +1 -0
  432. package/dist/dev-tools/404-page.d.ts +50 -0
  433. package/dist/dev-tools/404-page.d.ts.map +1 -0
  434. package/dist/dev-tools/await-span.d.ts +17 -0
  435. package/dist/dev-tools/await-span.d.ts.map +1 -0
  436. package/dist/dev-tools/browser-logs.d.ts +40 -0
  437. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  438. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  439. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  440. package/dist/dev-tools/error-page.d.ts +32 -0
  441. package/dist/dev-tools/error-page.d.ts.map +1 -0
  442. package/dist/dev-tools/holding-server.d.ts +46 -0
  443. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  444. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  445. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  446. package/dist/dev-tools/index.d.ts +31 -0
  447. package/dist/dev-tools/index.d.ts.map +1 -0
  448. package/dist/dev-tools/instrumentation.d.ts +74 -0
  449. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  450. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  451. package/dist/dev-tools/logger.d.ts.map +1 -0
  452. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  453. package/dist/dev-tools/logs.d.ts.map +1 -0
  454. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  455. package/dist/dev-tools/overlay.d.ts.map +1 -0
  456. package/dist/dev-tools/span-sink.d.ts +42 -0
  457. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  458. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  459. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  460. package/dist/dev-tools/terminal.d.ts +28 -0
  461. package/dist/dev-tools/terminal.d.ts.map +1 -0
  462. package/dist/fonts/ast-walk.d.ts +68 -0
  463. package/dist/fonts/ast-walk.d.ts.map +1 -0
  464. package/dist/fonts/ast.d.ts +112 -8
  465. package/dist/fonts/ast.d.ts.map +1 -1
  466. package/dist/fonts/bundle.d.ts +50 -0
  467. package/dist/fonts/bundle.d.ts.map +1 -0
  468. package/dist/fonts/css.d.ts +1 -1
  469. package/dist/fonts/dev-middleware.d.ts +22 -0
  470. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  471. package/dist/fonts/fallbacks.d.ts +0 -7
  472. package/dist/fonts/fallbacks.d.ts.map +1 -1
  473. package/dist/fonts/google.d.ts +5 -3
  474. package/dist/fonts/google.d.ts.map +1 -1
  475. package/dist/fonts/local.d.ts +5 -5
  476. package/dist/fonts/local.d.ts.map +1 -1
  477. package/dist/fonts/paths.d.ts +43 -0
  478. package/dist/fonts/paths.d.ts.map +1 -0
  479. package/dist/fonts/pipeline.d.ts +177 -0
  480. package/dist/fonts/pipeline.d.ts.map +1 -0
  481. package/dist/fonts/transform.d.ts +82 -0
  482. package/dist/fonts/transform.d.ts.map +1 -0
  483. package/dist/fonts/types.d.ts +47 -1
  484. package/dist/fonts/types.d.ts.map +1 -1
  485. package/dist/fonts/virtual-modules.d.ts +77 -0
  486. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  487. package/dist/index.d.ts +37 -181
  488. package/dist/index.d.ts.map +1 -1
  489. package/dist/index.js +9952 -14264
  490. package/dist/index.js.map +1 -1
  491. package/dist/params/codec-registry.d.ts +36 -0
  492. package/dist/params/codec-registry.d.ts.map +1 -0
  493. package/dist/params/define-schema.d.ts +81 -0
  494. package/dist/params/define-schema.d.ts.map +1 -0
  495. package/dist/params/index.d.ts +4 -0
  496. package/dist/params/index.d.ts.map +1 -0
  497. package/dist/params/index.js +32 -0
  498. package/dist/params/index.js.map +1 -0
  499. package/dist/params/resolve-schema.d.ts +34 -0
  500. package/dist/params/resolve-schema.d.ts.map +1 -0
  501. package/dist/plugin-context.d.ts +269 -0
  502. package/dist/plugin-context.d.ts.map +1 -0
  503. package/dist/plugins/build-manifest.d.ts +7 -3
  504. package/dist/plugins/build-manifest.d.ts.map +1 -1
  505. package/dist/plugins/build-report.d.ts +61 -11
  506. package/dist/plugins/build-report.d.ts.map +1 -1
  507. package/dist/plugins/cache.d.ts +64 -0
  508. package/dist/plugins/cache.d.ts.map +1 -0
  509. package/dist/plugins/callsite-ast.d.ts +117 -0
  510. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  511. package/dist/plugins/callsite-jsx.d.ts +35 -0
  512. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  513. package/dist/plugins/chunks.d.ts +11 -4
  514. package/dist/plugins/chunks.d.ts.map +1 -1
  515. package/dist/plugins/client-chunks.d.ts +40 -0
  516. package/dist/plugins/client-chunks.d.ts.map +1 -0
  517. package/dist/plugins/client-dep-entries.d.ts +80 -0
  518. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  519. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  520. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  521. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  522. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  523. package/dist/plugins/content.d.ts +1 -1
  524. package/dist/plugins/content.d.ts.map +1 -1
  525. package/dist/plugins/dev-await.d.ts +81 -0
  526. package/dist/plugins/dev-await.d.ts.map +1 -0
  527. package/dist/plugins/dev-discovery.d.ts +187 -0
  528. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  529. package/dist/plugins/dev-hostname.d.ts +152 -0
  530. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  531. package/dist/plugins/dev-server.d.ts +29 -2
  532. package/dist/plugins/dev-server.d.ts.map +1 -1
  533. package/dist/plugins/dev-store-clear.d.ts +83 -0
  534. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  535. package/dist/plugins/encryption-runtime.d.ts +13 -0
  536. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  537. package/dist/plugins/entries.d.ts +40 -4
  538. package/dist/plugins/entries.d.ts.map +1 -1
  539. package/dist/plugins/fonts.d.ts +35 -74
  540. package/dist/plugins/fonts.d.ts.map +1 -1
  541. package/dist/plugins/graph-endpoint.d.ts +114 -0
  542. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  543. package/dist/plugins/mdx.d.ts +18 -5
  544. package/dist/plugins/mdx.d.ts.map +1 -1
  545. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  546. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  547. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  548. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  549. package/dist/plugins/orphaned-modules.d.ts +57 -0
  550. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  551. package/dist/plugins/post-build.d.ts +110 -0
  552. package/dist/plugins/post-build.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  554. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  555. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  556. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  557. package/dist/plugins/prebuilt.d.ts +98 -0
  558. package/dist/plugins/prebuilt.d.ts.map +1 -0
  559. package/dist/plugins/prerender-sugar.d.ts +39 -0
  560. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  561. package/dist/plugins/react-resolve.d.ts +49 -0
  562. package/dist/plugins/react-resolve.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  564. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  565. package/dist/plugins/request-dep/index.d.ts +75 -0
  566. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  567. package/dist/plugins/request-dep/origin.d.ts +61 -0
  568. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  569. package/dist/plugins/routing.d.ts +2 -2
  570. package/dist/plugins/routing.d.ts.map +1 -1
  571. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  572. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  573. package/dist/plugins/server-bundle.d.ts +1 -1
  574. package/dist/plugins/server-bundle.d.ts.map +1 -1
  575. package/dist/plugins/shims.d.ts +29 -5
  576. package/dist/plugins/shims.d.ts.map +1 -1
  577. package/dist/plugins/static-build.d.ts +246 -26
  578. package/dist/plugins/static-build.d.ts.map +1 -1
  579. package/dist/routes/href.d.ts +124 -0
  580. package/dist/routes/href.d.ts.map +1 -0
  581. package/dist/routes/index.d.ts +4 -0
  582. package/dist/routes/index.d.ts.map +1 -0
  583. package/dist/routes/index.js +8 -0
  584. package/dist/routes/index.js.map +1 -0
  585. package/dist/routing/codegen-shared.d.ts +26 -0
  586. package/dist/routing/codegen-shared.d.ts.map +1 -0
  587. package/dist/routing/codegen-types.d.ts +61 -0
  588. package/dist/routing/codegen-types.d.ts.map +1 -0
  589. package/dist/routing/codegen-write.d.ts +42 -0
  590. package/dist/routing/codegen-write.d.ts.map +1 -0
  591. package/dist/routing/codegen.d.ts +8 -3
  592. package/dist/routing/codegen.d.ts.map +1 -1
  593. package/dist/routing/collision-probe.d.ts +104 -0
  594. package/dist/routing/collision-probe.d.ts.map +1 -0
  595. package/dist/routing/collision-spaces.d.ts +26 -0
  596. package/dist/routing/collision-spaces.d.ts.map +1 -0
  597. package/dist/routing/convention-lint.d.ts +55 -0
  598. package/dist/routing/convention-lint.d.ts.map +1 -0
  599. package/dist/routing/export-detect.d.ts +91 -0
  600. package/dist/routing/export-detect.d.ts.map +1 -0
  601. package/dist/routing/file-cache.d.ts +8 -0
  602. package/dist/routing/file-cache.d.ts.map +1 -0
  603. package/dist/routing/index.d.ts +13 -7
  604. package/dist/routing/index.d.ts.map +1 -1
  605. package/dist/routing/index.js +5 -2
  606. package/dist/routing/interception-overlap.d.ts +35 -0
  607. package/dist/routing/interception-overlap.d.ts.map +1 -0
  608. package/dist/routing/interception.d.ts +234 -10
  609. package/dist/routing/interception.d.ts.map +1 -1
  610. package/dist/routing/link-codegen.d.ts +136 -0
  611. package/dist/routing/link-codegen.d.ts.map +1 -0
  612. package/dist/routing/manifest-codegen.d.ts +26 -0
  613. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  614. package/dist/routing/scanner.d.ts +14 -10
  615. package/dist/routing/scanner.d.ts.map +1 -1
  616. package/dist/routing/schema-validation.d.ts +35 -0
  617. package/dist/routing/schema-validation.d.ts.map +1 -0
  618. package/dist/routing/segment-classify.d.ts +114 -0
  619. package/dist/routing/segment-classify.d.ts.map +1 -0
  620. package/dist/routing/segment-codegen.d.ts +38 -0
  621. package/dist/routing/segment-codegen.d.ts.map +1 -0
  622. package/dist/routing/segment-keys.d.ts +118 -0
  623. package/dist/routing/segment-keys.d.ts.map +1 -0
  624. package/dist/routing/slot-placement.d.ts +48 -0
  625. package/dist/routing/slot-placement.d.ts.map +1 -0
  626. package/dist/routing/types.d.ts +81 -26
  627. package/dist/routing/types.d.ts.map +1 -1
  628. package/dist/routing/walkers.d.ts +57 -0
  629. package/dist/routing/walkers.d.ts.map +1 -0
  630. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  631. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  632. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  633. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  634. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  635. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  636. package/dist/rsc-runtime/rsc.d.ts +3 -13
  637. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  638. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  639. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  640. package/dist/rsc-runtime/server-references.d.ts +19 -0
  641. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  642. package/dist/rsc-runtime/ssr.d.ts +7 -10
  643. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  644. package/dist/rsc-runtime/transforms.d.ts +13 -0
  645. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  646. package/dist/schema-bridge.d.ts +154 -0
  647. package/dist/schema-bridge.d.ts.map +1 -0
  648. package/dist/search-params/define.d.ts +262 -0
  649. package/dist/search-params/define.d.ts.map +1 -0
  650. package/dist/search-params/index.d.ts +3 -7
  651. package/dist/search-params/index.d.ts.map +1 -1
  652. package/dist/search-params/index.js +178 -362
  653. package/dist/search-params/index.js.map +1 -1
  654. package/dist/search-params/parse-total.d.ts +81 -0
  655. package/dist/search-params/parse-total.d.ts.map +1 -0
  656. package/dist/search-params/serialize-equal.d.ts +9 -0
  657. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  658. package/dist/search-params/wrappers.d.ts +76 -0
  659. package/dist/search-params/wrappers.d.ts.map +1 -0
  660. package/dist/server/abort-scope.d.ts +27 -0
  661. package/dist/server/abort-scope.d.ts.map +1 -0
  662. package/dist/server/access-gate.d.ts +110 -10
  663. package/dist/server/access-gate.d.ts.map +1 -1
  664. package/dist/server/action-client.d.ts +20 -133
  665. package/dist/server/action-client.d.ts.map +1 -1
  666. package/dist/server/action-encryption.d.ts +76 -0
  667. package/dist/server/action-encryption.d.ts.map +1 -0
  668. package/dist/server/action-handler.d.ts +60 -11
  669. package/dist/server/action-handler.d.ts.map +1 -1
  670. package/dist/server/action-schema.d.ts +126 -0
  671. package/dist/server/action-schema.d.ts.map +1 -0
  672. package/dist/server/action-types.d.ts +108 -0
  673. package/dist/server/action-types.d.ts.map +1 -0
  674. package/dist/server/actions.d.ts +78 -40
  675. package/dist/server/actions.d.ts.map +1 -1
  676. package/dist/server/als-registry.d.ts +189 -17
  677. package/dist/server/als-registry.d.ts.map +1 -1
  678. package/dist/server/body-limits.d.ts.map +1 -1
  679. package/dist/server/build-manifest.d.ts +25 -30
  680. package/dist/server/build-manifest.d.ts.map +1 -1
  681. package/dist/server/canonicalize.d.ts +53 -0
  682. package/dist/server/canonicalize.d.ts.map +1 -1
  683. package/dist/server/chain-url-parts.d.ts +82 -0
  684. package/dist/server/chain-url-parts.d.ts.map +1 -0
  685. package/dist/server/children-interception.d.ts +49 -0
  686. package/dist/server/children-interception.d.ts.map +1 -0
  687. package/dist/server/client-error-message.d.ts +12 -0
  688. package/dist/server/client-error-message.d.ts.map +1 -0
  689. package/dist/server/coalesce-tick.d.ts +40 -0
  690. package/dist/server/coalesce-tick.d.ts.map +1 -0
  691. package/dist/server/compress.d.ts +2 -0
  692. package/dist/server/compress.d.ts.map +1 -1
  693. package/dist/server/cookie-context.d.ts +156 -0
  694. package/dist/server/cookie-context.d.ts.map +1 -0
  695. package/dist/server/cookie-parsing.d.ts +65 -0
  696. package/dist/server/cookie-parsing.d.ts.map +1 -0
  697. package/dist/server/csp-nonce.d.ts +36 -0
  698. package/dist/server/csp-nonce.d.ts.map +1 -0
  699. package/dist/server/csrf.d.ts +58 -15
  700. package/dist/server/csrf.d.ts.map +1 -1
  701. package/dist/server/debug.d.ts +0 -1
  702. package/dist/server/debug.d.ts.map +1 -1
  703. package/dist/server/default-logger.d.ts +23 -0
  704. package/dist/server/default-logger.d.ts.map +1 -0
  705. package/dist/server/default-status-page.d.ts +45 -0
  706. package/dist/server/default-status-page.d.ts.map +1 -0
  707. package/dist/server/deny-boundary.d.ts +257 -0
  708. package/dist/server/deny-boundary.d.ts.map +1 -0
  709. package/dist/server/deny-renderer.d.ts +22 -15
  710. package/dist/server/deny-renderer.d.ts.map +1 -1
  711. package/dist/server/early-hints-sender.d.ts.map +1 -1
  712. package/dist/server/early-hints.d.ts +14 -12
  713. package/dist/server/early-hints.d.ts.map +1 -1
  714. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  715. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  716. package/dist/server/error-response-headers.d.ts +3 -0
  717. package/dist/server/error-response-headers.d.ts.map +1 -0
  718. package/dist/server/fallback-error.d.ts +19 -7
  719. package/dist/server/fallback-error.d.ts.map +1 -1
  720. package/dist/server/flight-injection-state.d.ts +66 -0
  721. package/dist/server/flight-injection-state.d.ts.map +1 -0
  722. package/dist/server/flight-injector-core.d.ts +125 -0
  723. package/dist/server/flight-injector-core.d.ts.map +1 -0
  724. package/dist/server/flight-scripts.d.ts +63 -0
  725. package/dist/server/flight-scripts.d.ts.map +1 -0
  726. package/dist/server/flight-source-node.d.ts +105 -0
  727. package/dist/server/flight-source-node.d.ts.map +1 -0
  728. package/dist/server/flight-source.d.ts +136 -0
  729. package/dist/server/flight-source.d.ts.map +1 -0
  730. package/dist/server/form-data.d.ts +59 -2
  731. package/dist/server/form-data.d.ts.map +1 -1
  732. package/dist/server/form-state-flight.d.ts +32 -0
  733. package/dist/server/form-state-flight.d.ts.map +1 -0
  734. package/dist/server/head-response.d.ts +35 -0
  735. package/dist/server/head-response.d.ts.map +1 -0
  736. package/dist/server/html-injector-core.d.ts +169 -0
  737. package/dist/server/html-injector-core.d.ts.map +1 -0
  738. package/dist/server/html-injectors.d.ts +77 -47
  739. package/dist/server/html-injectors.d.ts.map +1 -1
  740. package/dist/server/index.d.ts +16 -54
  741. package/dist/server/index.d.ts.map +1 -1
  742. package/dist/server/index.js +621 -3009
  743. package/dist/server/index.js.map +1 -1
  744. package/dist/server/instrumentation.d.ts +13 -5
  745. package/dist/server/instrumentation.d.ts.map +1 -1
  746. package/dist/server/interception-gates.d.ts +49 -0
  747. package/dist/server/interception-gates.d.ts.map +1 -0
  748. package/dist/server/internal.d.ts +48 -0
  749. package/dist/server/internal.d.ts.map +1 -0
  750. package/dist/server/internal.js +5092 -0
  751. package/dist/server/internal.js.map +1 -0
  752. package/dist/server/json-status-response.d.ts +34 -0
  753. package/dist/server/json-status-response.d.ts.map +1 -0
  754. package/dist/server/logger.d.ts +105 -7
  755. package/dist/server/logger.d.ts.map +1 -1
  756. package/dist/server/metadata-collector.d.ts +75 -0
  757. package/dist/server/metadata-collector.d.ts.map +1 -0
  758. package/dist/server/metadata-platform.d.ts +2 -2
  759. package/dist/server/metadata-render.d.ts +2 -2
  760. package/dist/server/metadata-render.d.ts.map +1 -1
  761. package/dist/server/metadata-route-links.d.ts +70 -0
  762. package/dist/server/metadata-route-links.d.ts.map +1 -0
  763. package/dist/server/metadata-routes.d.ts +47 -11
  764. package/dist/server/metadata-routes.d.ts.map +1 -1
  765. package/dist/server/metadata-social.d.ts +2 -2
  766. package/dist/server/metadata.d.ts +10 -2
  767. package/dist/server/metadata.d.ts.map +1 -1
  768. package/dist/server/middleware-runner.d.ts +20 -5
  769. package/dist/server/middleware-runner.d.ts.map +1 -1
  770. package/dist/server/node-body-response.d.ts +55 -0
  771. package/dist/server/node-body-response.d.ts.map +1 -0
  772. package/dist/server/node-response.d.ts +62 -0
  773. package/dist/server/node-response.d.ts.map +1 -0
  774. package/dist/server/node-stream-transforms.d.ts +108 -0
  775. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  776. package/dist/server/node-streams-platform.d.ts +21 -0
  777. package/dist/server/node-streams-platform.d.ts.map +1 -0
  778. package/dist/server/param-coercion.d.ts +84 -0
  779. package/dist/server/param-coercion.d.ts.map +1 -0
  780. package/dist/server/pipeline-helpers.d.ts +227 -0
  781. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  782. package/dist/server/pipeline-interception.d.ts +100 -9
  783. package/dist/server/pipeline-interception.d.ts.map +1 -1
  784. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  785. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  786. package/dist/server/pipeline-metadata.d.ts +18 -2
  787. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  788. package/dist/server/pipeline-outcome.d.ts +59 -0
  789. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  790. package/dist/server/pipeline-phases.d.ts +76 -0
  791. package/dist/server/pipeline-phases.d.ts.map +1 -0
  792. package/dist/server/pipeline.d.ts +190 -23
  793. package/dist/server/pipeline.d.ts.map +1 -1
  794. package/dist/server/port-resolution.d.ts +22 -0
  795. package/dist/server/port-resolution.d.ts.map +1 -0
  796. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  797. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  798. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  799. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  800. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  801. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  802. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  803. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  804. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  805. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  806. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  807. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  808. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  809. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  810. package/dist/server/prebuilt/overlay.d.ts +119 -0
  811. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  812. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  813. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  814. package/dist/server/prebuilt/slots.d.ts +105 -0
  815. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  816. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  817. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  818. package/dist/server/prebuilt-builder.d.ts +121 -0
  819. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  820. package/dist/server/prebuilt-runtime.d.ts +105 -0
  821. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  822. package/dist/server/primitives.d.ts +114 -90
  823. package/dist/server/primitives.d.ts.map +1 -1
  824. package/dist/server/publish-params.d.ts +33 -0
  825. package/dist/server/publish-params.d.ts.map +1 -0
  826. package/dist/server/react-cache-bridge.d.ts +59 -0
  827. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  828. package/dist/server/react-cache-scope.d.ts +49 -0
  829. package/dist/server/react-cache-scope.d.ts.map +1 -0
  830. package/dist/server/render-timeout.d.ts +66 -0
  831. package/dist/server/render-timeout.d.ts.map +1 -0
  832. package/dist/server/render-utils.d.ts +56 -0
  833. package/dist/server/render-utils.d.ts.map +1 -0
  834. package/dist/server/request-context.d.ts +167 -103
  835. package/dist/server/request-context.d.ts.map +1 -1
  836. package/dist/server/request-dep.d.ts +15 -0
  837. package/dist/server/request-dep.d.ts.map +1 -0
  838. package/dist/server/response-cache-policy.d.ts +3 -0
  839. package/dist/server/response-cache-policy.d.ts.map +1 -0
  840. package/dist/server/response-framing.d.ts +43 -0
  841. package/dist/server/response-framing.d.ts.map +1 -0
  842. package/dist/server/route-element-builder.d.ts +57 -30
  843. package/dist/server/route-element-builder.d.ts.map +1 -1
  844. package/dist/server/route-element-helpers.d.ts +12 -0
  845. package/dist/server/route-element-helpers.d.ts.map +1 -0
  846. package/dist/server/route-handler.d.ts +9 -3
  847. package/dist/server/route-handler.d.ts.map +1 -1
  848. package/dist/server/route-matcher.d.ts +75 -40
  849. package/dist/server/route-matcher.d.ts.map +1 -1
  850. package/dist/server/route-methods.d.ts +23 -0
  851. package/dist/server/route-methods.d.ts.map +1 -0
  852. package/dist/server/route-module-loader.d.ts +37 -0
  853. package/dist/server/route-module-loader.d.ts.map +1 -0
  854. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  855. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  856. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  857. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  858. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  859. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  860. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  861. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  862. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  863. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  865. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  866. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  867. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/index.d.ts +30 -6
  869. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  871. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  872. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  873. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  874. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  875. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  876. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  877. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  878. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  879. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  880. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  881. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  882. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  883. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  884. package/dist/server/rsc-error-envelope.d.ts +11 -0
  885. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  886. package/dist/server/safe-load.d.ts +39 -0
  887. package/dist/server/safe-load.d.ts.map +1 -0
  888. package/dist/server/schema-introspection.d.ts +68 -0
  889. package/dist/server/schema-introspection.d.ts.map +1 -0
  890. package/dist/server/sensitive-fields.d.ts +88 -0
  891. package/dist/server/sensitive-fields.d.ts.map +1 -0
  892. package/dist/server/signal-identity.d.ts +49 -0
  893. package/dist/server/signal-identity.d.ts.map +1 -0
  894. package/dist/server/sitemap-generator.d.ts +130 -0
  895. package/dist/server/sitemap-generator.d.ts.map +1 -0
  896. package/dist/server/sitemap-handler.d.ts +22 -0
  897. package/dist/server/sitemap-handler.d.ts.map +1 -0
  898. package/dist/server/skippable-prefix.d.ts +29 -0
  899. package/dist/server/skippable-prefix.d.ts.map +1 -0
  900. package/dist/server/slot-interception.d.ts +80 -0
  901. package/dist/server/slot-interception.d.ts.map +1 -0
  902. package/dist/server/slot-resolver.d.ts +138 -7
  903. package/dist/server/slot-resolver.d.ts.map +1 -1
  904. package/dist/server/slot-subtree-contain.d.ts +54 -0
  905. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  906. package/dist/server/ssr-bridge-types.d.ts +213 -0
  907. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  908. package/dist/server/ssr-entry.d.ts +15 -51
  909. package/dist/server/ssr-entry.d.ts.map +1 -1
  910. package/dist/server/ssr-form-state.d.ts +30 -0
  911. package/dist/server/ssr-form-state.d.ts.map +1 -0
  912. package/dist/server/ssr-render.d.ts +42 -12
  913. package/dist/server/ssr-render.d.ts.map +1 -1
  914. package/dist/server/ssr-wrappers.d.ts +92 -0
  915. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  916. package/dist/server/state-tree-diff.d.ts +44 -9
  917. package/dist/server/state-tree-diff.d.ts.map +1 -1
  918. package/dist/server/static-generator.d.ts +112 -0
  919. package/dist/server/static-generator.d.ts.map +1 -0
  920. package/dist/server/static-not-found.d.ts +52 -0
  921. package/dist/server/static-not-found.d.ts.map +1 -0
  922. package/dist/server/status-code-resolver.d.ts +26 -15
  923. package/dist/server/status-code-resolver.d.ts.map +1 -1
  924. package/dist/server/stream-utils.d.ts +93 -0
  925. package/dist/server/stream-utils.d.ts.map +1 -0
  926. package/dist/server/traced-access.d.ts +18 -0
  927. package/dist/server/traced-access.d.ts.map +1 -0
  928. package/dist/server/tracing.d.ts +72 -31
  929. package/dist/server/tracing.d.ts.map +1 -1
  930. package/dist/server/tree-match.d.ts +59 -0
  931. package/dist/server/tree-match.d.ts.map +1 -0
  932. package/dist/server/types.d.ts +90 -8
  933. package/dist/server/types.d.ts.map +1 -1
  934. package/dist/server/utils/element-type.d.ts +50 -0
  935. package/dist/server/utils/element-type.d.ts.map +1 -0
  936. package/dist/server/utils/escape-html.d.ts +14 -0
  937. package/dist/server/utils/escape-html.d.ts.map +1 -0
  938. package/dist/server/version-skew.d.ts +61 -0
  939. package/dist/server/version-skew.d.ts.map +1 -0
  940. package/dist/server/workers-cache-bridge.d.ts +26 -0
  941. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  942. package/dist/shared/als-slots.d.ts +42 -0
  943. package/dist/shared/als-slots.d.ts.map +1 -0
  944. package/dist/shared/base-path.d.ts +56 -0
  945. package/dist/shared/base-path.d.ts.map +1 -0
  946. package/dist/shared/csrf-reject.d.ts +16 -0
  947. package/dist/shared/csrf-reject.d.ts.map +1 -0
  948. package/dist/shared/dev-span.d.ts +99 -0
  949. package/dist/shared/dev-span.d.ts.map +1 -0
  950. package/dist/shared/error-digest.d.ts +28 -0
  951. package/dist/shared/error-digest.d.ts.map +1 -0
  952. package/dist/shared/flight-base64.d.ts +13 -0
  953. package/dist/shared/flight-base64.d.ts.map +1 -0
  954. package/dist/shared/flight-segment.d.ts +18 -0
  955. package/dist/shared/flight-segment.d.ts.map +1 -0
  956. package/dist/shared/form-state-flight.d.ts +32 -0
  957. package/dist/shared/form-state-flight.d.ts.map +1 -0
  958. package/dist/shared/href-validation.d.ts +49 -0
  959. package/dist/shared/href-validation.d.ts.map +1 -0
  960. package/dist/shared/href.d.ts +88 -0
  961. package/dist/shared/href.d.ts.map +1 -0
  962. package/dist/shared/merge-search-params.d.ts +22 -0
  963. package/dist/shared/merge-search-params.d.ts.map +1 -0
  964. package/dist/shared/param-value.d.ts +104 -0
  965. package/dist/shared/param-value.d.ts.map +1 -0
  966. package/dist/shared/payload-root.d.ts +110 -0
  967. package/dist/shared/payload-root.d.ts.map +1 -0
  968. package/dist/shared/redirect-type.d.ts +17 -0
  969. package/dist/shared/redirect-type.d.ts.map +1 -0
  970. package/dist/shared/rsc-cache-key.d.ts +163 -0
  971. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  972. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  973. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  974. package/dist/shared/rsc-manifest.d.ts +28 -0
  975. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  976. package/dist/shared/rsc-media-type.d.ts +52 -0
  977. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  978. package/dist/shared/rsc-payload-path.d.ts +48 -0
  979. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  980. package/dist/shared/segment-info.d.ts +66 -0
  981. package/dist/shared/segment-info.d.ts.map +1 -0
  982. package/dist/shared/slot-params.d.ts +52 -0
  983. package/dist/shared/slot-params.d.ts.map +1 -0
  984. package/dist/shared/static-platform-files.d.ts +71 -0
  985. package/dist/shared/static-platform-files.d.ts.map +1 -0
  986. package/dist/shared/status-reason-phrase.d.ts +26 -0
  987. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  988. package/dist/shims/font-google.d.ts +1 -1
  989. package/dist/shims/font-google.d.ts.map +1 -1
  990. package/dist/shims/font-google.js +41 -0
  991. package/dist/shims/font-google.js.map +1 -0
  992. package/dist/shims/font-local.d.ts +26 -0
  993. package/dist/shims/font-local.d.ts.map +1 -0
  994. package/dist/shims/font-local.js +19 -0
  995. package/dist/shims/font-local.js.map +1 -0
  996. package/dist/shims/headers.d.ts +60 -1
  997. package/dist/shims/headers.d.ts.map +1 -1
  998. package/dist/shims/image.d.ts +120 -120
  999. package/dist/shims/image.d.ts.map +1 -1
  1000. package/dist/shims/navigation-client.d.ts +25 -12
  1001. package/dist/shims/navigation-client.d.ts.map +1 -1
  1002. package/dist/shims/navigation-rsc.d.ts +21 -0
  1003. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  1004. package/dist/shims/navigation.d.ts +10 -5
  1005. package/dist/shims/navigation.d.ts.map +1 -1
  1006. package/dist/utils/state-machine.d.ts +80 -0
  1007. package/dist/utils/state-machine.d.ts.map +1 -0
  1008. package/dist/utils/write-file-atomic.d.ts +17 -0
  1009. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  1010. package/docs/api/30-api-server.mdx +241 -0
  1011. package/docs/api/31-api-client.mdx +225 -0
  1012. package/docs/api/32-api-cache.mdx +341 -0
  1013. package/docs/api/33-api-search-params.mdx +178 -0
  1014. package/docs/api/34-api-config.mdx +421 -0
  1015. package/docs/api/35-api-typescript.mdx +123 -0
  1016. package/docs/api/36-cli.mdx +272 -0
  1017. package/docs/learn/00-introduction.mdx +109 -0
  1018. package/docs/learn/01-quick-start.mdx +94 -0
  1019. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1020. package/docs/learn/03-fetching-data.mdx +227 -0
  1021. package/docs/learn/04-access-control.mdx +115 -0
  1022. package/docs/learn/05-the-flush-point.mdx +175 -0
  1023. package/docs/learn/06-typed-params.mdx +275 -0
  1024. package/docs/learn/07-typed-routes.mdx +173 -0
  1025. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1026. package/docs/learn/09-streaming.mdx +146 -0
  1027. package/docs/learn/10-caching.mdx +303 -0
  1028. package/docs/learn/11-middleware.mdx +166 -0
  1029. package/docs/learn/12-error-handling.mdx +192 -0
  1030. package/docs/learn/13-deploying.mdx +289 -0
  1031. package/llms.txt +55 -0
  1032. package/package.json +124 -29
  1033. package/src/adapters/build-output-helper.ts +375 -0
  1034. package/src/adapters/canonicalize-module.ts +29 -0
  1035. package/src/adapters/cloudflare-dev.ts +183 -0
  1036. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1037. package/src/adapters/cloudflare.ts +799 -151
  1038. package/src/adapters/compress-module.ts +110 -86
  1039. package/src/adapters/fs-identity.ts +155 -0
  1040. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1041. package/src/adapters/nitro-presets.ts +139 -0
  1042. package/src/adapters/nitro-preview.ts +565 -0
  1043. package/src/adapters/nitro.ts +349 -448
  1044. package/src/adapters/raw-imports.d.ts +5 -0
  1045. package/src/adapters/shared.ts +314 -0
  1046. package/src/adapters/types.ts +129 -17
  1047. package/src/adapters/wrangler.d.ts +7 -0
  1048. package/src/analyze/chains.ts +411 -0
  1049. package/src/analyze/classify.ts +259 -0
  1050. package/src/analyze/crawl-entry.ts +68 -0
  1051. package/src/analyze/crawl.ts +500 -0
  1052. package/src/analyze/graph-cache.ts +331 -0
  1053. package/src/analyze/graph-command.ts +654 -0
  1054. package/src/analyze/live-graph.ts +232 -0
  1055. package/src/analyze/poison-rules.ts +165 -0
  1056. package/src/analyze/poison-scan.ts +159 -0
  1057. package/src/analyze/scan.ts +149 -0
  1058. package/src/cache/cache-api.ts +113 -0
  1059. package/src/cache/fast-hash.ts +5 -0
  1060. package/src/cache/guarded-read.ts +44 -0
  1061. package/src/cache/handler-store.ts +113 -0
  1062. package/src/cache/index.ts +93 -20
  1063. package/src/cache/invalidation-epoch.ts +105 -0
  1064. package/src/cache/json-lossy-check.ts +69 -0
  1065. package/src/cache/key-discipline.ts +218 -0
  1066. package/src/cache/redis-handler.ts +193 -19
  1067. package/src/cache/singleflight.ts +85 -7
  1068. package/src/cache/sizeof.ts +35 -0
  1069. package/src/cache/stable-stringify.ts +118 -2
  1070. package/src/cache/store.ts +71 -0
  1071. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1072. package/src/cache/stores/memory.ts +125 -0
  1073. package/src/cache/stores/redis.ts +97 -0
  1074. package/src/cache/stores/vercel.ts +59 -0
  1075. package/src/cache/tag-aware-handler.ts +250 -0
  1076. package/src/cache/timber-cache.ts +218 -47
  1077. package/src/cdn/cloudflare-purge.ts +50 -0
  1078. package/src/cdn/fastly-purge.ts +63 -0
  1079. package/src/cdn/headers.ts +153 -0
  1080. package/src/cdn/index.ts +23 -0
  1081. package/src/cdn/purge-store.ts +62 -0
  1082. package/src/cdn/workers-cache-purge.ts +34 -0
  1083. package/src/cli-check.ts +417 -0
  1084. package/src/cli-context.ts +128 -0
  1085. package/src/cli-dev-status.ts +196 -0
  1086. package/src/cli-init.ts +278 -0
  1087. package/src/cli-schema-sync.ts +401 -0
  1088. package/src/cli.ts +308 -84
  1089. package/src/client/browser-dev.ts +192 -5
  1090. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1091. package/src/client/browser-entry/action-queue.ts +152 -0
  1092. package/src/client/browser-entry/form-state.ts +49 -0
  1093. package/src/client/browser-entry/hmr.ts +82 -0
  1094. package/src/client/browser-entry/hydrate.ts +152 -0
  1095. package/src/client/browser-entry/index.ts +153 -0
  1096. package/src/client/browser-entry/post-hydration.ts +99 -0
  1097. package/src/client/browser-entry/router-init.ts +391 -0
  1098. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1099. package/src/client/browser-entry/scroll.ts +50 -0
  1100. package/src/client/deny-last-resort.tsx +54 -0
  1101. package/src/client/dev-pill/index.ts +128 -0
  1102. package/src/client/dev-pill/store.ts +254 -0
  1103. package/src/client/dev-pill/view.ts +326 -0
  1104. package/src/client/error-boundary.tsx +296 -61
  1105. package/src/client/error-reconstituter.tsx +84 -0
  1106. package/src/client/form.tsx +61 -173
  1107. package/src/client/global-context.ts +59 -0
  1108. package/src/client/history.ts +74 -11
  1109. package/src/client/index.ts +93 -53
  1110. package/src/client/internal.ts +54 -0
  1111. package/src/client/link.tsx +284 -204
  1112. package/src/client/location-search.ts +15 -0
  1113. package/src/client/navigation-api.ts +254 -0
  1114. package/src/client/navigation-commit.ts +318 -0
  1115. package/src/client/navigation-context.ts +71 -142
  1116. package/src/client/navigation-root.tsx +237 -0
  1117. package/src/client/navigation-transition.ts +401 -0
  1118. package/src/client/nuqs-adapter.tsx +62 -32
  1119. package/src/client/params-context.ts +175 -0
  1120. package/src/client/react-root.ts +105 -0
  1121. package/src/client/router-effects.ts +349 -0
  1122. package/src/client/router-lifecycle.ts +394 -0
  1123. package/src/client/router-pipeline.ts +443 -0
  1124. package/src/client/router-ref.ts +3 -3
  1125. package/src/client/router-skew.ts +30 -0
  1126. package/src/client/router-types.ts +326 -0
  1127. package/src/client/router-url.ts +32 -0
  1128. package/src/client/router.ts +491 -421
  1129. package/src/client/rsc-fetch.ts +510 -109
  1130. package/src/client/segment-cache.ts +362 -41
  1131. package/src/client/segment-context.ts +7 -4
  1132. package/src/client/segment-outlet.tsx +96 -0
  1133. package/src/client/segment-update-context.ts +23 -0
  1134. package/src/client/shallow-url.ts +22 -0
  1135. package/src/client/slot-content-cache-context.ts +43 -0
  1136. package/src/client/slot-context.ts +39 -0
  1137. package/src/client/slot-outlet.tsx +22 -0
  1138. package/src/client/slot-provider.tsx +32 -0
  1139. package/src/client/ssr-data.ts +27 -67
  1140. package/src/client/stale-client.ts +191 -0
  1141. package/src/client/state.ts +31 -24
  1142. package/src/client/status-page-marker.tsx +32 -0
  1143. package/src/client/top-loader.tsx +13 -10
  1144. package/src/client/unload-guard.ts +35 -3
  1145. package/src/client/use-cookie.ts +93 -29
  1146. package/src/client/use-field-state.ts +144 -0
  1147. package/src/client/use-link-status.ts +7 -7
  1148. package/src/client/use-pathname.ts +22 -31
  1149. package/src/client/use-pending-navigation.ts +119 -0
  1150. package/src/client/use-query-states.ts +206 -36
  1151. package/src/client/use-router.ts +31 -9
  1152. package/src/client/use-search-params.ts +38 -49
  1153. package/src/client/use-segment-params.ts +69 -0
  1154. package/src/client/use-selected-layout-segment.ts +2 -2
  1155. package/src/codec.ts +149 -0
  1156. package/src/config-types.ts +366 -0
  1157. package/src/config-validation.ts +511 -0
  1158. package/src/cookies/define-cookie.ts +186 -53
  1159. package/src/cookies/index.ts +13 -2
  1160. package/src/cookies/json-cookie.ts +105 -0
  1161. package/src/cookies/validation.ts +192 -0
  1162. package/src/dev-tools/404-page.ts +286 -0
  1163. package/src/dev-tools/await-span.ts +69 -0
  1164. package/src/dev-tools/browser-logs.ts +55 -0
  1165. package/src/dev-tools/dev-page-shell.ts +278 -0
  1166. package/src/dev-tools/error-page.ts +331 -0
  1167. package/src/dev-tools/holding-server.ts +185 -0
  1168. package/src/dev-tools/hydration-overlay.ts +158 -0
  1169. package/src/dev-tools/index.ts +79 -0
  1170. package/src/dev-tools/instrumentation.ts +281 -0
  1171. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1172. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1173. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1174. package/src/dev-tools/span-sink.ts +132 -0
  1175. package/src/dev-tools/stack-classifier.ts +75 -0
  1176. package/src/dev-tools/terminal.ts +182 -0
  1177. package/src/fonts/ast-walk.ts +235 -0
  1178. package/src/fonts/ast.ts +479 -128
  1179. package/src/fonts/bundle.ts +138 -0
  1180. package/src/fonts/css.ts +1 -1
  1181. package/src/fonts/dev-middleware.ts +85 -0
  1182. package/src/fonts/fallbacks.ts +0 -23
  1183. package/src/fonts/google.ts +101 -19
  1184. package/src/fonts/local.ts +12 -11
  1185. package/src/fonts/paths.ts +58 -0
  1186. package/src/fonts/pipeline.ts +348 -0
  1187. package/src/fonts/transform.ts +311 -0
  1188. package/src/fonts/types.ts +52 -1
  1189. package/src/fonts/virtual-modules.ts +179 -0
  1190. package/src/index.ts +501 -380
  1191. package/src/params/codec-registry.ts +47 -0
  1192. package/src/params/define-schema.ts +115 -0
  1193. package/src/params/index.ts +16 -0
  1194. package/src/params/resolve-schema.ts +84 -0
  1195. package/src/plugin-context.ts +509 -0
  1196. package/src/plugins/build-manifest.ts +189 -36
  1197. package/src/plugins/build-report.ts +299 -87
  1198. package/src/plugins/cache.ts +243 -0
  1199. package/src/plugins/callsite-ast.ts +472 -0
  1200. package/src/plugins/callsite-jsx.ts +243 -0
  1201. package/src/plugins/chunks.ts +74 -5
  1202. package/src/plugins/client-chunks.ts +185 -0
  1203. package/src/plugins/client-dep-entries.ts +124 -0
  1204. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1205. package/src/plugins/cloudflare-wasm.ts +141 -0
  1206. package/src/plugins/content.ts +31 -2
  1207. package/src/plugins/dev-await.ts +415 -0
  1208. package/src/plugins/dev-discovery.ts +428 -0
  1209. package/src/plugins/dev-hostname.ts +322 -0
  1210. package/src/plugins/dev-server.ts +471 -100
  1211. package/src/plugins/dev-store-clear.ts +145 -0
  1212. package/src/plugins/encryption-runtime.ts +31 -0
  1213. package/src/plugins/entries.ts +158 -17
  1214. package/src/plugins/fonts.ts +260 -657
  1215. package/src/plugins/graph-endpoint.ts +544 -0
  1216. package/src/plugins/mdx.ts +108 -35
  1217. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1218. package/src/plugins/optimize-package-imports.ts +439 -0
  1219. package/src/plugins/orphaned-modules.ts +78 -0
  1220. package/src/plugins/post-build.ts +327 -0
  1221. package/src/plugins/prebuilt-capture.ts +213 -0
  1222. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1223. package/src/plugins/prebuilt.ts +679 -0
  1224. package/src/plugins/prerender-sugar.ts +348 -0
  1225. package/src/plugins/react-resolve.ts +149 -0
  1226. package/src/plugins/request-dep/analysis.ts +447 -0
  1227. package/src/plugins/request-dep/index.ts +376 -0
  1228. package/src/plugins/request-dep/origin.ts +310 -0
  1229. package/src/plugins/routing.ts +296 -278
  1230. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1231. package/src/plugins/server-bundle.ts +115 -15
  1232. package/src/plugins/shims.ts +267 -97
  1233. package/src/plugins/static-build.ts +681 -71
  1234. package/src/react-canary.d.ts +2 -0
  1235. package/src/routes/href.ts +171 -0
  1236. package/src/routes/index.ts +10 -0
  1237. package/src/routing/codegen-shared.ts +39 -0
  1238. package/src/routing/codegen-types.ts +62 -0
  1239. package/src/routing/codegen-write.ts +163 -0
  1240. package/src/routing/codegen.ts +356 -232
  1241. package/src/routing/collision-probe.ts +438 -0
  1242. package/src/routing/collision-spaces.ts +281 -0
  1243. package/src/routing/convention-lint.ts +649 -0
  1244. package/src/routing/export-detect.ts +536 -0
  1245. package/src/routing/file-cache.ts +23 -0
  1246. package/src/routing/index.ts +16 -7
  1247. package/src/routing/interception-overlap.ts +141 -0
  1248. package/src/routing/interception.ts +1044 -67
  1249. package/src/routing/link-codegen.ts +346 -0
  1250. package/src/routing/manifest-codegen.ts +232 -0
  1251. package/src/routing/scanner.ts +417 -223
  1252. package/src/routing/schema-validation.ts +155 -0
  1253. package/src/routing/segment-classify.ts +280 -0
  1254. package/src/routing/segment-codegen.ts +99 -0
  1255. package/src/routing/segment-keys.ts +186 -0
  1256. package/src/routing/slot-placement.ts +97 -0
  1257. package/src/routing/types.ts +82 -26
  1258. package/src/routing/walkers.ts +98 -0
  1259. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1260. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1261. package/src/rsc-runtime/render-flight.ts +26 -0
  1262. package/src/rsc-runtime/rsc.ts +35 -5
  1263. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1264. package/src/rsc-runtime/server-references.ts +135 -0
  1265. package/src/rsc-runtime/ssr.ts +23 -0
  1266. package/src/rsc-runtime/transforms.ts +13 -0
  1267. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1268. package/src/schema-bridge.ts +437 -0
  1269. package/src/search-params/define.ts +676 -0
  1270. package/src/search-params/index.ts +14 -20
  1271. package/src/search-params/parse-total.ts +91 -0
  1272. package/src/search-params/serialize-equal.ts +14 -0
  1273. package/src/search-params/wrappers.ts +150 -0
  1274. package/src/server/abort-scope.ts +49 -0
  1275. package/src/server/access-gate.tsx +208 -57
  1276. package/src/server/action-client.ts +175 -294
  1277. package/src/server/action-encryption.ts +144 -0
  1278. package/src/server/action-handler.ts +533 -150
  1279. package/src/server/action-schema.ts +203 -0
  1280. package/src/server/action-types.ts +145 -0
  1281. package/src/server/actions.ts +172 -85
  1282. package/src/server/als-registry.ts +245 -30
  1283. package/src/server/body-limits.ts +10 -2
  1284. package/src/server/build-manifest.ts +33 -57
  1285. package/src/server/canonicalize.ts +62 -3
  1286. package/src/server/chain-url-parts.ts +163 -0
  1287. package/src/server/children-interception.ts +116 -0
  1288. package/src/server/client-error-message.ts +18 -0
  1289. package/src/server/coalesce-tick.ts +75 -0
  1290. package/src/server/compress.ts +91 -19
  1291. package/src/server/cookie-context.ts +462 -0
  1292. package/src/server/cookie-parsing.ts +163 -0
  1293. package/src/server/csp-nonce.ts +58 -0
  1294. package/src/server/csrf.ts +238 -37
  1295. package/src/server/debug.ts +0 -1
  1296. package/src/server/default-logger.ts +100 -0
  1297. package/src/server/default-status-page.ts +88 -0
  1298. package/src/server/deny-boundary.ts +527 -0
  1299. package/src/server/deny-renderer.ts +210 -181
  1300. package/src/server/early-hints-sender.ts +4 -3
  1301. package/src/server/early-hints.ts +39 -29
  1302. package/src/server/error-boundary-wrapper.ts +160 -44
  1303. package/src/server/error-response-headers.ts +18 -0
  1304. package/src/server/fallback-error.ts +88 -104
  1305. package/src/server/flight-injection-state.ts +113 -0
  1306. package/src/server/flight-injector-core.ts +332 -0
  1307. package/src/server/flight-scripts.ts +92 -0
  1308. package/src/server/flight-source-node.ts +434 -0
  1309. package/src/server/flight-source.ts +289 -0
  1310. package/src/server/form-data.ts +191 -20
  1311. package/src/server/form-state-flight.ts +67 -0
  1312. package/src/server/head-response.ts +50 -0
  1313. package/src/server/html-injector-core.ts +320 -0
  1314. package/src/server/html-injectors.ts +241 -285
  1315. package/src/server/index.ts +42 -195
  1316. package/src/server/instrumentation.ts +42 -11
  1317. package/src/server/interception-gates.ts +94 -0
  1318. package/src/server/internal.ts +164 -0
  1319. package/src/server/json-status-response.ts +105 -0
  1320. package/src/server/logger.ts +163 -38
  1321. package/src/server/metadata-collector.ts +175 -0
  1322. package/src/server/metadata-platform.ts +2 -2
  1323. package/src/server/metadata-render.ts +30 -8
  1324. package/src/server/metadata-route-links.ts +200 -0
  1325. package/src/server/metadata-routes.ts +114 -24
  1326. package/src/server/metadata-social.ts +2 -2
  1327. package/src/server/metadata.ts +23 -2
  1328. package/src/server/middleware-runner.ts +32 -5
  1329. package/src/server/node-body-response.ts +236 -0
  1330. package/src/server/node-response.ts +93 -0
  1331. package/src/server/node-stream-transforms.ts +340 -0
  1332. package/src/server/node-streams-platform.ts +23 -0
  1333. package/src/server/param-coercion.ts +205 -0
  1334. package/src/server/pipeline-helpers.ts +554 -0
  1335. package/src/server/pipeline-interception.ts +301 -32
  1336. package/src/server/pipeline-metadata-route.ts +242 -0
  1337. package/src/server/pipeline-metadata.ts +30 -4
  1338. package/src/server/pipeline-outcome.ts +290 -0
  1339. package/src/server/pipeline-phases.ts +443 -0
  1340. package/src/server/pipeline.ts +474 -427
  1341. package/src/server/port-resolution.ts +43 -0
  1342. package/src/server/prebuilt/cache-key.ts +340 -0
  1343. package/src/server/prebuilt/capture-render.ts +122 -0
  1344. package/src/server/prebuilt/capture-routes.ts +104 -0
  1345. package/src/server/prebuilt/capture-state.ts +196 -0
  1346. package/src/server/prebuilt/dev-store.ts +252 -0
  1347. package/src/server/prebuilt/lifetime.ts +151 -0
  1348. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1349. package/src/server/prebuilt/overlay.ts +290 -0
  1350. package/src/server/prebuilt/payload-source.ts +221 -0
  1351. package/src/server/prebuilt/slots.ts +201 -0
  1352. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1353. package/src/server/prebuilt-builder.ts +515 -0
  1354. package/src/server/prebuilt-runtime.ts +830 -0
  1355. package/src/server/primitives.ts +167 -171
  1356. package/src/server/publish-params.ts +42 -0
  1357. package/src/server/react-cache-bridge.ts +124 -0
  1358. package/src/server/react-cache-scope.ts +104 -0
  1359. package/src/server/render-timeout.ts +123 -0
  1360. package/src/server/render-utils.ts +70 -0
  1361. package/src/server/request-context.ts +321 -323
  1362. package/src/server/request-dep.ts +37 -0
  1363. package/src/server/response-cache-policy.ts +45 -0
  1364. package/src/server/response-framing.ts +59 -0
  1365. package/src/server/route-element-builder.ts +539 -355
  1366. package/src/server/route-element-helpers.ts +37 -0
  1367. package/src/server/route-handler.ts +78 -48
  1368. package/src/server/route-matcher.ts +251 -265
  1369. package/src/server/route-methods.ts +37 -0
  1370. package/src/server/route-module-loader.ts +161 -0
  1371. package/src/server/rsc-cache-key-guard.ts +122 -0
  1372. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1373. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1374. package/src/server/rsc-entry/api-handler.ts +30 -93
  1375. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1376. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1377. package/src/server/rsc-entry/helpers.ts +90 -115
  1378. package/src/server/rsc-entry/index.ts +420 -350
  1379. package/src/server/rsc-entry/render-route.ts +248 -0
  1380. package/src/server/rsc-entry/render-signals.ts +108 -0
  1381. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1382. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1383. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1384. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1385. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1386. package/src/server/rsc-error-envelope.ts +18 -0
  1387. package/src/server/rsc-prop-warnings.ts +1 -1
  1388. package/src/server/safe-load.ts +53 -0
  1389. package/src/server/schema-introspection.ts +393 -0
  1390. package/src/server/sensitive-fields.ts +287 -0
  1391. package/src/server/server-only-guard-noop.js +3 -0
  1392. package/src/server/server-timing.ts +1 -1
  1393. package/src/server/signal-identity.ts +130 -0
  1394. package/src/server/sitemap-generator.ts +337 -0
  1395. package/src/server/sitemap-handler.ts +150 -0
  1396. package/src/server/skippable-prefix.ts +172 -0
  1397. package/src/server/slot-interception.ts +168 -0
  1398. package/src/server/slot-resolver.ts +747 -300
  1399. package/src/server/slot-subtree-contain.ts +273 -0
  1400. package/src/server/ssr-bridge-types.ts +217 -0
  1401. package/src/server/ssr-entry.ts +246 -109
  1402. package/src/server/ssr-form-state.ts +58 -0
  1403. package/src/server/ssr-render.ts +253 -113
  1404. package/src/server/ssr-wrappers.tsx +152 -0
  1405. package/src/server/state-tree-diff.ts +85 -30
  1406. package/src/server/static-generator.ts +680 -0
  1407. package/src/server/static-not-found.ts +134 -0
  1408. package/src/server/status-code-resolver.ts +107 -148
  1409. package/src/server/stream-utils.ts +398 -0
  1410. package/src/server/traced-access.ts +50 -0
  1411. package/src/server/tracing.ts +274 -128
  1412. package/src/server/tree-match.ts +494 -0
  1413. package/src/server/types.ts +97 -11
  1414. package/src/server/utils/element-type.ts +88 -0
  1415. package/src/server/utils/escape-html.ts +20 -0
  1416. package/src/server/version-skew.ts +104 -0
  1417. package/src/server/waituntil-bridge.ts +1 -1
  1418. package/src/server/workers-cache-bridge.ts +33 -0
  1419. package/src/shared/als-slots.ts +74 -0
  1420. package/src/shared/base-path.ts +80 -0
  1421. package/src/shared/csrf-reject.ts +15 -0
  1422. package/src/shared/dev-span.ts +188 -0
  1423. package/src/shared/error-digest.ts +46 -0
  1424. package/src/shared/flight-base64.ts +23 -0
  1425. package/src/shared/flight-segment.ts +35 -0
  1426. package/src/shared/form-state-flight.ts +59 -0
  1427. package/src/shared/href-validation.ts +159 -0
  1428. package/src/shared/href.ts +257 -0
  1429. package/src/shared/merge-search-params.ts +55 -0
  1430. package/src/shared/param-value.ts +281 -0
  1431. package/src/shared/payload-root.ts +153 -0
  1432. package/src/shared/redirect-type.ts +17 -0
  1433. package/src/shared/rsc-cache-key.ts +269 -0
  1434. package/src/shared/rsc-error-envelope.ts +16 -0
  1435. package/src/shared/rsc-manifest.ts +29 -0
  1436. package/src/shared/rsc-media-type.ts +59 -0
  1437. package/src/shared/rsc-payload-path.ts +52 -0
  1438. package/src/shared/segment-info.ts +67 -0
  1439. package/src/shared/slot-params.ts +109 -0
  1440. package/src/shared/static-platform-files.ts +75 -0
  1441. package/src/shared/status-reason-phrase.ts +61 -0
  1442. package/src/shims/font-google.ts +1 -1
  1443. package/src/shims/font-local.ts +34 -0
  1444. package/src/shims/headers.ts +130 -1
  1445. package/src/shims/navigation-client.ts +36 -32
  1446. package/src/shims/navigation-rsc.ts +47 -0
  1447. package/src/shims/navigation.ts +10 -7
  1448. package/src/utils/state-machine.ts +111 -0
  1449. package/src/utils/write-file-atomic.ts +32 -0
  1450. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1451. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1452. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1453. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1454. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1455. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1456. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1457. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1458. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1459. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1460. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1461. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1462. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1463. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1464. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1465. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1466. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1467. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1468. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1469. package/dist/adapters/cloudflare.js.map +0 -1
  1470. package/dist/cache/index.js.map +0 -1
  1471. package/dist/cache/register-cached-function.d.ts +0 -17
  1472. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1473. package/dist/client/browser-entry.d.ts +0 -21
  1474. package/dist/client/browser-entry.d.ts.map +0 -1
  1475. package/dist/client/error-boundary.js.map +0 -1
  1476. package/dist/client/head.d.ts +0 -16
  1477. package/dist/client/head.d.ts.map +0 -1
  1478. package/dist/client/link-status-provider.d.ts +0 -11
  1479. package/dist/client/link-status-provider.d.ts.map +0 -1
  1480. package/dist/client/segment-merger.d.ts +0 -119
  1481. package/dist/client/segment-merger.d.ts.map +0 -1
  1482. package/dist/client/stale-reload.d.ts +0 -44
  1483. package/dist/client/stale-reload.d.ts.map +0 -1
  1484. package/dist/client/transition-root.d.ts +0 -74
  1485. package/dist/client/transition-root.d.ts.map +0 -1
  1486. package/dist/client/types.d.ts +0 -14
  1487. package/dist/client/types.d.ts.map +0 -1
  1488. package/dist/client/use-navigation-pending.d.ts +0 -26
  1489. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1490. package/dist/client/use-params.d.ts +0 -92
  1491. package/dist/client/use-params.d.ts.map +0 -1
  1492. package/dist/content/index.d.ts +0 -11
  1493. package/dist/content/index.d.ts.map +0 -1
  1494. package/dist/content/index.js +0 -2
  1495. package/dist/plugins/adapter-build.d.ts +0 -18
  1496. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1497. package/dist/plugins/cache-transform.d.ts +0 -36
  1498. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1499. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1500. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1501. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1502. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1503. package/dist/plugins/server-action-exports.d.ts +0 -26
  1504. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1505. package/dist/routing/status-file-lint.d.ts +0 -33
  1506. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1507. package/dist/search-params/analyze.d.ts +0 -54
  1508. package/dist/search-params/analyze.d.ts.map +0 -1
  1509. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1510. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1511. package/dist/search-params/codecs.d.ts +0 -53
  1512. package/dist/search-params/codecs.d.ts.map +0 -1
  1513. package/dist/search-params/create.d.ts +0 -106
  1514. package/dist/search-params/create.d.ts.map +0 -1
  1515. package/dist/search-params/registry.d.ts +0 -20
  1516. package/dist/search-params/registry.d.ts.map +0 -1
  1517. package/dist/server/asset-headers.d.ts +0 -42
  1518. package/dist/server/asset-headers.d.ts.map +0 -1
  1519. package/dist/server/client-module-map.d.ts +0 -47
  1520. package/dist/server/client-module-map.d.ts.map +0 -1
  1521. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1522. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1523. package/dist/server/dev-logger.d.ts.map +0 -1
  1524. package/dist/server/dev-span-processor.d.ts +0 -29
  1525. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1526. package/dist/server/dev-warnings.d.ts +0 -129
  1527. package/dist/server/dev-warnings.d.ts.map +0 -1
  1528. package/dist/server/flush.d.ts +0 -74
  1529. package/dist/server/flush.d.ts.map +0 -1
  1530. package/dist/server/form-flash.d.ts +0 -78
  1531. package/dist/server/form-flash.d.ts.map +0 -1
  1532. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1533. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1534. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1535. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1536. package/dist/server/prerender.d.ts +0 -77
  1537. package/dist/server/prerender.d.ts.map +0 -1
  1538. package/dist/server/tree-builder.d.ts +0 -126
  1539. package/dist/server/tree-builder.d.ts.map +0 -1
  1540. package/dist/utils/directive-parser.d.ts +0 -70
  1541. package/dist/utils/directive-parser.d.ts.map +0 -1
  1542. package/src/cache/register-cached-function.ts +0 -103
  1543. package/src/client/browser-entry.ts +0 -678
  1544. package/src/client/head.ts +0 -61
  1545. package/src/client/link-status-provider.tsx +0 -30
  1546. package/src/client/segment-merger.ts +0 -339
  1547. package/src/client/stale-reload.ts +0 -87
  1548. package/src/client/transition-root.tsx +0 -166
  1549. package/src/client/types.ts +0 -21
  1550. package/src/client/use-navigation-pending.ts +0 -38
  1551. package/src/client/use-params.ts +0 -141
  1552. package/src/content/index.ts +0 -13
  1553. package/src/plugins/adapter-build.ts +0 -118
  1554. package/src/plugins/cache-transform.ts +0 -199
  1555. package/src/plugins/dynamic-transform.ts +0 -161
  1556. package/src/plugins/server-action-exports.ts +0 -220
  1557. package/src/routing/status-file-lint.ts +0 -112
  1558. package/src/search-params/analyze.ts +0 -192
  1559. package/src/search-params/builtin-codecs.ts +0 -228
  1560. package/src/search-params/codecs.ts +0 -153
  1561. package/src/search-params/create.ts +0 -321
  1562. package/src/search-params/registry.ts +0 -31
  1563. package/src/server/asset-headers.ts +0 -81
  1564. package/src/server/client-module-map.ts +0 -58
  1565. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1566. package/src/server/dev-span-processor.ts +0 -78
  1567. package/src/server/dev-warnings.ts +0 -283
  1568. package/src/server/flush.ts +0 -182
  1569. package/src/server/form-flash.ts +0 -89
  1570. package/src/server/manifest-status-resolver.ts +0 -215
  1571. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1572. package/src/server/prerender.ts +0 -139
  1573. package/src/server/tree-builder.ts +0 -382
  1574. package/src/shims/server-only-noop.js +0 -6
  1575. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,1282 @@
1
+ import { a as withTimeout$1 } from "./render-timeout-MrrqD1wd.js";
2
+ import { _ as wasInvalidatedSince, g as recordInvalidation, h as lastInvalidationEpochFor, i as devDataCacheKey, l as invalidateDevSeedsByTag, m as currentInvalidationEpoch, o as devOverlayNamespace, v as getCacheHandler, y as isCacheHandlerConfigured } from "./dev-store-BvdqtHvK.js";
3
+ import { c as waitUntilAls, i as requestContextAls } from "./als-registry-DpygwCp0.js";
4
+ import { a as logKeyDisciplineViolation, b as swallow, g as logSwrRefetchFailed, n as logCacheMiss, r as logCacheReadFailed, w as addSpanEventSync } from "./logger-YtMSKfft.js";
5
+ import { t as fnv1aHash } from "./fast-hash-DddxkU5Y.js";
6
+ import { n as createSingleflight } from "./singleflight-CzoOVB9Y.js";
7
+ import { t as estimateByteSize } from "./sizeof-Cmx6Fs-Y.js";
8
+ import { t as warnLossyJsonValue } from "./json-lossy-check-BXM45k8p.js";
9
+ import { t as getCdnPurgeHandler } from "./purge-store-8BqLAYZ1.js";
10
+ // src/server/waituntil-bridge.ts
11
+ /**
12
+ * Per-request waitUntil bridge — ALS bridge for platform adapters.
13
+ *
14
+ * The generated entry point (Nitro, Cloudflare) wraps the handler with
15
+ * `runWithWaitUntil`, binding the platform's lifecycle extension function
16
+ * (e.g., h3's `event.waitUntil()` or CF's `ctx.waitUntil()`) for the
17
+ * request duration. The `waitUntil()` primitive reads from this ALS to
18
+ * dispatch background work to the correct platform API.
19
+ *
20
+ * Design doc: design/11-platform.md §"waitUntil()"
21
+ */
22
+ /**
23
+ * Get the current request's waitUntil function, if available.
24
+ *
25
+ * Returns undefined when no platform adapter has installed a waitUntil
26
+ * handler for the current request (e.g., on platforms that don't support
27
+ * lifecycle extension, or outside a request context).
28
+ */
29
+ function getWaitUntil() {
30
+ return waitUntilAls.getStore();
31
+ }
32
+ // src/cache/stable-stringify.ts
33
+ /**
34
+ * Deterministic JSON serialization with sorted object keys.
35
+ * Used for cache key generation — ensures { a: 1, b: 2 } and { b: 2, a: 1 }
36
+ * produce the same string.
37
+ *
38
+ * Matches JSON.stringify semantics for toJSON: Date serializes to its ISO
39
+ * string, URL to its href, and class instances with a custom toJSON use it.
40
+ * Map and Set serialize their entries explicitly (insertion-order
41
+ * independent). Values that would serialize lossily — functions, symbols,
42
+ * and non-plain objects with no enumerable own state (RegExp, class
43
+ * instances holding data behind getters or internal slots) — throw instead:
44
+ * every such value would collapse to the same cache key, silently returning
45
+ * one argument's cached data for another (TIM-1020).
46
+ *
47
+ * The same rule covers what JSON.stringify flattens: NaN, Infinity and
48
+ * -Infinity all become `null` there and -0 becomes `0`, and a typed array
49
+ * becomes a plain index object, so `Uint8Array`, `Int8Array` and
50
+ * `{ "0": 1 }` with the same values would share an entry. Both get a
51
+ * representation of their own (GHSA-rhh4-g77r-r9qj class).
52
+ */
53
+ function stableStringify(value) {
54
+ if (value === null || value === void 0) return String(value);
55
+ const type = typeof value;
56
+ if (type === "function" || type === "symbol") throw new TypeError(`stableStringify: cannot serialize a ${type} into a stable cache key — all such values would collide. Provide an explicit \`key\` option to cache().`);
57
+ if (type === "number") return stringifyNumber(value);
58
+ if (type !== "object") return JSON.stringify(value);
59
+ if (Array.isArray(value)) return "[" + value.map((item) => stableStringify(item)).join(",") + "]";
60
+ const withToJSON = value;
61
+ if (typeof withToJSON.toJSON === "function") {
62
+ const json = withToJSON.toJSON();
63
+ if (json !== value) return stableStringify(json);
64
+ }
65
+ const typed = asTypedArray(value);
66
+ if (typed) {
67
+ const elements = Array.from(typed.view, (element) => typeof element === "bigint" ? `${element}n` : stringifyNumber(element));
68
+ return `${typed.name}(${elements.join(",")})`;
69
+ }
70
+ if (value instanceof Map) return "Map(" + [...value.entries()].map(([k, v]) => stableStringify(k) + "=>" + stableStringify(v)).sort().join(",") + ")";
71
+ if (value instanceof Set) return "Set(" + [...value].map((member) => stableStringify(member)).sort().join(",") + ")";
72
+ const obj = value;
73
+ const keys = Object.keys(obj).sort();
74
+ const pairs = [];
75
+ for (const key of keys) {
76
+ if (obj[key] === void 0) continue;
77
+ if (key === "toJSON" && typeof obj[key] === "function") continue;
78
+ pairs.push(JSON.stringify(key) + ":" + stableStringify(obj[key]));
79
+ }
80
+ if (pairs.length === 0) {
81
+ const proto = Object.getPrototypeOf(value);
82
+ if (proto !== Object.prototype && proto !== null) {
83
+ const name = value.constructor?.name || "Object";
84
+ throw new TypeError(`stableStringify: ${name} instance has no serializable own state — all instances would share one cache key. Provide an explicit \`key\` option to cache(), or add a toJSON() method.`);
85
+ }
86
+ }
87
+ return "{" + pairs.join(",") + "}";
88
+ }
89
+ /**
90
+ * JSON.stringify for a number, except the values it maps onto another
91
+ * value's output: NaN, ±Infinity (all `null`) and -0 (`0`). Their bare
92
+ * tokens cannot be produced by JSON output, so they cannot collide.
93
+ */
94
+ function stringifyNumber(value) {
95
+ if (Number.isFinite(value)) return Object.is(value, -0) ? "-0" : JSON.stringify(value);
96
+ return String(value);
97
+ }
98
+ /**
99
+ * The %TypedArray%.prototype[Symbol.toStringTag] getter returns the
100
+ * element type name for a real typed array and undefined for anything else
101
+ * (spec §23.2.3.38). It reads an internal slot, so it holds across realms —
102
+ * unlike `instanceof`, which sent a DataView from a `vm` context into the
103
+ * typed-array branch, where it serialized as an empty, shared key — and it
104
+ * cannot be spoofed by an own `Symbol.toStringTag`.
105
+ */
106
+ var typedArrayTag = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), Symbol.toStringTag)?.get;
107
+ function asTypedArray(value) {
108
+ const name = typedArrayTag?.call(value);
109
+ if (typeof name !== "string") return void 0;
110
+ return {
111
+ name,
112
+ view: value
113
+ };
114
+ }
115
+ // src/cache/guarded-read.ts
116
+ /**
117
+ * Cache reads never fail a request.
118
+ *
119
+ * A cache is an optimization: when the store is down, slow, or returns
120
+ * garbage, the request must still succeed by doing the work the cache would
121
+ * have skipped. Writes already follow this rule (timber-cache.ts swallows a
122
+ * failed handler.set, TIM-1046); reads go through here so a throwing or hung
123
+ * handler.get costs a live fetch or render, never a failed or stalled request.
124
+ *
125
+ * The timeout matters as much as the catch. Shared-store clients often queue
126
+ * commands while disconnected (ioredis retries each one up to 20 times by
127
+ * default), so an outage shows up as a read that never settles, not an error.
128
+ *
129
+ * Invalidation is deliberately NOT guarded: a failed invalidate that looked
130
+ * like success would leave stale data in place silently.
131
+ *
132
+ * See design/06-caching.md §"Store failures".
133
+ */
134
+ /** Ceiling for a single cache read. A healthy store answers in milliseconds. */
135
+ var CACHE_READ_TIMEOUT_MS = 1e3;
136
+ /**
137
+ * Run a cache read. A throw, a rejection, or no answer within
138
+ * CACHE_READ_TIMEOUT_MS logs a warning and resolves to `onFailure`, which the
139
+ * caller picks: `null` where a failed read means "miss", a distinct value
140
+ * where a miss would fall back to something the failed read might have
141
+ * overridden (an invalidated build seed — server/prebuilt/overlay.ts).
142
+ */
143
+ async function guardedRead(cacheKey, read, onFailure) {
144
+ try {
145
+ return await withTimeout$1(read(), CACHE_READ_TIMEOUT_MS, `cache read for "${cacheKey}"`);
146
+ } catch (error) {
147
+ logCacheReadFailed({
148
+ cacheKey,
149
+ error
150
+ });
151
+ return onFailure;
152
+ }
153
+ }
154
+ // src/cache/key-discipline.ts
155
+ /**
156
+ * Key-discipline diagnostic for both cache tiers (design/45 §Enforcement).
157
+ *
158
+ * A cached value is stored under a key computed from declared inputs only —
159
+ * props and segment params for `cache.component`, the function's arguments
160
+ * for `cache.data`. A request-context read while the value is being computed
161
+ * is the data-leak danger zone (design/06 security note): the result varies
162
+ * by user but the key does not. While the cached work runs, the ALS store is
163
+ * wrapped in a transparent observing proxy; any request-context read
164
+ * produces a structured, rate-limited production diagnostic.
165
+ *
166
+ * The diagnostic fires per offending callsite, rate-limited to once per
167
+ * interval (default 60 s) — not once per process. This ensures the
168
+ * signal stays visible in log aggregators across restarts and deploys.
169
+ *
170
+ * When `strictKeyDiscipline` is enabled (via timber.config.ts
171
+ * `cache.strictKeyDiscipline: true`), the diagnostic is promoted to a
172
+ * thrown error that prevents the tainted value from being cached.
173
+ */
174
+ /** Store fields every tier's key leaves out, by the API that reads them. */
175
+ var REQUEST_FIELDS = /* @__PURE__ */ new Map([
176
+ ["headers", "headers()"],
177
+ ["parsedCookies", "cookies()"],
178
+ ["searchParams", "searchParams"]
179
+ ]);
180
+ /**
181
+ * The data tier also leaves out segment params: a cache.component key
182
+ * includes them, a cache.data key holds only the function's arguments.
183
+ */
184
+ var DATA_TIER_FIELDS = new Map([
185
+ ...REQUEST_FIELDS,
186
+ ["segmentParams", "segment params"],
187
+ ["slotParams", "segment params"]
188
+ ]);
189
+ var TIERS = {
190
+ "cache.component": {
191
+ observed: REQUEST_FIELDS,
192
+ keyedBy: "props and segment params",
193
+ passAs: "as props",
194
+ work: "a cache capture render"
195
+ },
196
+ "cache.data": {
197
+ observed: DATA_TIER_FIELDS,
198
+ keyedBy: "the function's arguments",
199
+ passAs: "as an argument",
200
+ work: "a cached call"
201
+ }
202
+ };
203
+ /** Rate-limit interval: one diagnostic per callsite per 60 seconds. */
204
+ var RATE_LIMIT_MS = 6e4;
205
+ /**
206
+ * Last emission timestamp per `${tier}:${id}`. Past this many entries,
207
+ * ones whose window has elapsed are pruned — an untransformed callsite
208
+ * re-created per request gets a fresh fallback id each time.
209
+ */
210
+ var lastEmitted = /* @__PURE__ */ new Map();
211
+ var PRUNE_AT = 1e3;
212
+ /**
213
+ * Thrown in strict mode. A distinct class so a caller holding an earlier
214
+ * result computed by the same fn (a stale SWR entry) can drop it.
215
+ */
216
+ var KeyDisciplineViolation = class extends Error {
217
+ name = "KeyDisciplineViolation";
218
+ };
219
+ var strict = false;
220
+ /**
221
+ * Run a cached callsite's work under the observing proxy, then report any
222
+ * request-context read it made. The proxy is transparent — it forwards all
223
+ * reads and writes; it only observes.
224
+ *
225
+ * Outside a request context `run` executes as-is: there is nothing to read,
226
+ * and cache.data must keep working there. In default mode a callsite that
227
+ * reported within the rate-limit window is not observed at all. In strict
228
+ * mode a violation rejects after `run` resolves, so the caller never stores
229
+ * the value.
230
+ */
231
+ async function observeKeyDiscipline(site, run) {
232
+ const store = requestContextAls.getStore();
233
+ if (!store || !shouldCheck(site)) return run();
234
+ const { proxy, accessedApis } = createObservingProxy(store, TIERS[site.tier].observed);
235
+ const result = await requestContextAls.run(proxy, run);
236
+ if (accessedApis.size > 0) reportViolation(site, accessedApis);
237
+ return result;
238
+ }
239
+ function rateLimitKey(site) {
240
+ return `${site.tier}:${site.id}`;
241
+ }
242
+ /**
243
+ * Whether to observe this callsite on this call. Always in strict mode;
244
+ * otherwise only once the rate-limit window since its last report elapsed.
245
+ */
246
+ function shouldCheck(site) {
247
+ if (strict) return true;
248
+ const last = lastEmitted.get(rateLimitKey(site));
249
+ if (last === void 0) return true;
250
+ return Date.now() - last >= RATE_LIMIT_MS;
251
+ }
252
+ function createObservingProxy(store, observed) {
253
+ const accessedApis = /* @__PURE__ */ new Set();
254
+ return {
255
+ proxy: new Proxy(store, { get(target, prop, receiver) {
256
+ const api = observed.get(prop);
257
+ if (api) accessedApis.add(api);
258
+ return Reflect.get(target, prop, receiver);
259
+ } }),
260
+ accessedApis
261
+ };
262
+ }
263
+ /**
264
+ * Throw in strict mode; otherwise emit a structured error-level diagnostic
265
+ * through the logger (same path as render errors), rate-limited per callsite.
266
+ */
267
+ function reportViolation(site, apis) {
268
+ const { tier, id } = site;
269
+ const name = site.label ?? id;
270
+ const apiList = Array.from(apis).join(", ");
271
+ const wording = TIERS[tier];
272
+ const remedy = `Either pass request-derived values ${wording.passAs} (included in the cache key) or remove the ${apiList} call.`;
273
+ if (strict) throw new KeyDisciplineViolation(`[timber] ${tier} key-discipline violation: "${name}" reads ${apiList} during ${wording.work}. The cache key is computed from ${wording.keyedBy} only — caching this result would serve one user's data to another. ${remedy} To downgrade this to a warning, set cache.strictKeyDiscipline: false in timber.config.ts.`);
274
+ const now = Date.now();
275
+ const key = rateLimitKey(site);
276
+ const last = lastEmitted.get(key);
277
+ if (last !== void 0 && now - last < RATE_LIMIT_MS) return;
278
+ if (lastEmitted.size >= PRUNE_AT) {
279
+ for (const [k, t] of lastEmitted) if (now - t >= RATE_LIMIT_MS) lastEmitted.delete(k);
280
+ }
281
+ lastEmitted.set(key, now);
282
+ logKeyDisciplineViolation(`${tier} cross-user data leak risk`, {
283
+ ...tier === "cache.component" ? { component: name } : {
284
+ fn: name,
285
+ id,
286
+ cacheKey: site.cacheKey
287
+ },
288
+ accessedApis: Array.from(apis),
289
+ message: `${tier} "${name}" reads ${apiList} but the cache key is computed from ${wording.keyedBy} only. If the result varies by ${apiList}, different users may see each other's cached data. ${remedy}`
290
+ });
291
+ }
292
+ // src/cache/timber-cache.ts
293
+ /**
294
+ * The one flight keyspace for every cache() wrapper. A wrapper with its own
295
+ * `timeoutMs` passes it per call rather than getting a private instance:
296
+ * two wrappers that share an explicit key must coalesce, or an older,
297
+ * slower execution can overwrite a newer result — there is no write
298
+ * ordering in the CacheHandler contract to stop it (TIM-1447).
299
+ */
300
+ var flights = createSingleflight();
301
+ /** Timeout for calls without a per-wrapper `timeoutMs`; set at boot. */
302
+ var defaultTimeoutMs;
303
+ /**
304
+ * Set the timeout for cache calls without a per-call timeoutMs.
305
+ * Called at framework boot with renderTimeoutMs from timber.config.ts so that
306
+ * cache calls without a per-call timeoutMs still get deadlock protection.
307
+ * See design/06-caching.md §"Singleflight Timeout — Deadlock Risk".
308
+ */
309
+ function setDefaultSingleflightTimeout(timeoutMs) {
310
+ defaultTimeoutMs = timeoutMs;
311
+ }
312
+ /**
313
+ * Generate a cache key from function identity and serialized args.
314
+ *
315
+ * Uses FNV-1a (fast non-crypto hash) instead of SHA-256. Cache keys don't
316
+ * need collision resistance — they need speed. The fnId prefix provides
317
+ * namespace isolation; the hash covers the args.
318
+ *
319
+ * See TIM-370 for perf motivation.
320
+ */
321
+ function defaultKeyGenerator(fnId, args) {
322
+ const raw = fnId + ":" + stableStringify(args);
323
+ return fnId + ":" + fnv1aHash(raw);
324
+ }
325
+ /**
326
+ * Resolve tags from the options — supports static array or function form.
327
+ */
328
+ function resolveTags(opts, args) {
329
+ if (!opts.tags) return [];
330
+ if (Array.isArray(opts.tags)) return opts.tags;
331
+ return opts.tags(...args);
332
+ }
333
+ /** Per-process count of byte-identical fn sources seen by deriveFallbackFnId. */
334
+ var fallbackIdOccurrences = /* @__PURE__ */ new Map();
335
+ var hasWarnedFallbackId = false;
336
+ /**
337
+ * Derive a fallback fnId for callsites the timber-cache-transform Vite plugin
338
+ * could not statically detect (aliased bindings, user re-export wrappers).
339
+ *
340
+ * The base is fnv1a(fn.toString()) — deterministic across instances and cold
341
+ * starts of the same build, so two *different* functions can never swap fnIds
342
+ * by module-evaluation order (the TIM-997 poisoning scenario that the old
343
+ * process-local counter allowed; see TIM-1054). A per-process occurrence
344
+ * suffix disambiguates byte-identical duplicate sources. That residue is the
345
+ * one remaining hazard: closures produced by the same factory share source
346
+ * text but capture different values, and their occurrence order may differ
347
+ * across instances — such callsites need an explicit `key` option.
348
+ */
349
+ function deriveFallbackFnId(fn) {
350
+ const sourceHash = fnv1aHash(fn.toString());
351
+ const occurrence = fallbackIdOccurrences.get(sourceHash) ?? 0;
352
+ fallbackIdOccurrences.set(sourceHash, occurrence + 1);
353
+ if (!hasWarnedFallbackId && typeof process !== "undefined" && process.env.NODE_ENV !== "test") {
354
+ hasWarnedFallbackId = true;
355
+ console.warn("[timber] cache() callsite has no build-time stable ID and no explicit `key` option — the call is not statically visible to the timber Vite plugin (e.g. an aliased binding like `const c = cache` or a re-export wrapper module). Falling back to a function-source hash for the cache key. With a shared CacheHandler (Redis/KV) this is safe for distinct functions, but byte-identical closures from a factory can swap cache entries across instances. Provide an explicit `key` option to make the cache key contract stable and auditable.");
356
+ }
357
+ return `timber-cache:fn:${sourceHash}:${occurrence}`;
358
+ }
359
+ /**
360
+ * Creates a cached wrapper around an async function.
361
+ *
362
+ * - FNV-1a default keys with normalized JSON args
363
+ * - Singleflight: concurrent misses → single execution AND single
364
+ * handler.set — the write happens inside the coalesced callback (TIM-1028)
365
+ * - Writes are skipped when the key/tags were invalidated while fn was in
366
+ * flight, so explicit invalidation is never silently undone (TIM-1028)
367
+ * - SWR: serve stale immediately, background refetch
368
+ * - Tags as string[] or function of args
369
+ * - The handler is resolved per invocation via `getHandler`, never captured
370
+ * at wrapper-creation time — module-scope cache() wrappers created before
371
+ * the framework's boot wiring calls setCacheHandler() still use the
372
+ * configured handler once it arrives (TIM-1029)
373
+ * - No ALS dependency for correctness — cache() works outside a request
374
+ * context. The waitUntil ALS bridge is read optionally so the SWR
375
+ * background refetch survives handler return on Workers/Lambda, and
376
+ * inside one, fn runs under the key-discipline observer (design/45
377
+ * §Enforcement): the key comes from the arguments only, so a
378
+ * request-context read in fn is reported, or rejected in strict mode
379
+ * before the result is stored.
380
+ *
381
+ * Cache hits/misses are recorded as OTEL span events on the enclosing
382
+ * span (not child spans). The DevSpanProcessor reads these for dev log output.
383
+ */
384
+ function createCache(fn, opts, getHandler, stableId) {
385
+ const fnId = stableId ?? (opts.key ? void 0 : deriveFallbackFnId(fn));
386
+ const disciplineId = fnId ?? `key-fn:${fnv1aHash(fn.toString())}`;
387
+ return (async (...args) => {
388
+ const timeoutMs = opts.timeoutMs ?? defaultTimeoutMs;
389
+ const key = opts.key ? opts.key(...args) : defaultKeyGenerator(fnId, args);
390
+ const storeKey = devDataCacheKey(key);
391
+ const cacheStart = performance.now();
392
+ const cached = await guardedRead(key, () => getHandler().get(storeKey), null);
393
+ if (cached && !cached.stale) {
394
+ addSpanEventSync("timber.cache.hit", {
395
+ key,
396
+ duration_ms: Math.round(performance.now() - cacheStart)
397
+ });
398
+ return cached.value;
399
+ }
400
+ const tags = resolveTags(opts, args);
401
+ const flightKey = `${storeKey}\u0000${lastInvalidationEpochFor(key, tags)}`;
402
+ /**
403
+ * Run fn and store the result — exactly once per coalesced execution,
404
+ * inside the singleflight callback. The write is skipped when:
405
+ * - the key/tags were invalidated after fn started (TIM-1028), or
406
+ * - the singleflight timed out (signal aborted) — the timed-out
407
+ * flight's write could overwrite a newer value from a subsequent
408
+ * flight (TIM-1092).
409
+ * Those two guards plus the shared flight keyspace leave no second
410
+ * in-process execution for the key to race, as long as every wrapper
411
+ * using the key agrees on its tags (design/06 §Residual write races). A set issued just before
412
+ * a timeout can still land after the next flight's set; that, and
413
+ * writes from other processes, are last-write-wins and self-heal on
414
+ * the next miss (design/06 §Residual write races).
415
+ */
416
+ const executeAndStore = async (signal) => {
417
+ const startEpoch = currentInvalidationEpoch();
418
+ let result;
419
+ try {
420
+ result = await observeKeyDiscipline({
421
+ tier: "cache.data",
422
+ id: disciplineId,
423
+ label: fn.name || void 0,
424
+ cacheKey: key
425
+ }, () => fn(...args));
426
+ } catch (err) {
427
+ if (err instanceof KeyDisciplineViolation && !signal.aborted) await getHandler().invalidate({ key: storeKey }).catch((e) => swallow(e, `cache invalidate failed for key "${key}"`));
428
+ throw err;
429
+ }
430
+ if (!signal.aborted && !wasInvalidatedSince(startEpoch, key, tags)) try {
431
+ await getHandler().set(storeKey, result, {
432
+ ttl: opts.ttl,
433
+ tags
434
+ });
435
+ } catch (err) {
436
+ swallow(err, `cache set failed for key "${key}"`);
437
+ }
438
+ return result;
439
+ };
440
+ if (cached && cached.stale && opts.staleWhileRevalidate) {
441
+ addSpanEventSync("timber.cache.hit", {
442
+ key,
443
+ duration_ms: Math.round(performance.now() - cacheStart),
444
+ stale: true
445
+ });
446
+ const refetch = flights.do(flightKey, (signal) => executeAndStore(signal).catch((err) => {
447
+ logSwrRefetchFailed({
448
+ cacheKey: key,
449
+ error: err
450
+ });
451
+ throw err;
452
+ }), timeoutMs).then(() => {}, () => {});
453
+ getWaitUntil()?.(refetch);
454
+ return cached.value;
455
+ }
456
+ const result = await flights.do(flightKey, executeAndStore, timeoutMs);
457
+ addSpanEventSync("timber.cache.miss", {
458
+ key,
459
+ duration_ms: Math.round(performance.now() - cacheStart)
460
+ });
461
+ logCacheMiss({ cacheKey: key });
462
+ return result;
463
+ });
464
+ }
465
+ // src/cache/redis-handler.ts
466
+ var KEY_PREFIX = "timber:cache:";
467
+ var TAG_PREFIX = "timber:tag:";
468
+ /**
469
+ * Redis-backed CacheHandler for distributed caching.
470
+ *
471
+ * All instances sharing the same Redis see each other's cache entries and
472
+ * invalidations. Tag-based invalidation uses Redis Sets to track which keys
473
+ * belong to which tags.
474
+ *
475
+ * Bring your own Redis client wrapped to the {@link RedisClient} contract —
476
+ * see the adapter examples on the interface for ioredis, node-redis v4, and
477
+ * @upstash/redis.
478
+ */
479
+ var RedisCacheHandler = class {
480
+ client;
481
+ prefix;
482
+ constructor(client, opts) {
483
+ this.client = client;
484
+ this.prefix = opts?.prefix ?? "";
485
+ }
486
+ cacheKey(key) {
487
+ return `${this.prefix}${KEY_PREFIX}${key}`;
488
+ }
489
+ tagKey(tag) {
490
+ return `${this.prefix}${TAG_PREFIX}${tag}`;
491
+ }
492
+ async get(key) {
493
+ const raw = await this.client.get(this.cacheKey(key));
494
+ if (raw === null) return null;
495
+ const entry = JSON.parse(raw);
496
+ const stale = Date.now() > entry.expiresAt;
497
+ return {
498
+ value: entry.value,
499
+ stale
500
+ };
501
+ }
502
+ async set(key, value, opts) {
503
+ warnLossyJsonValue(value, key);
504
+ const ck = this.cacheKey(key);
505
+ const expiresAt = Date.now() + opts.ttl * 1e3;
506
+ const payload = JSON.stringify({
507
+ value,
508
+ expiresAt,
509
+ tags: opts.tags
510
+ });
511
+ const redisTtlSeconds = Math.max(opts.ttl * 2 + 60, 120);
512
+ const writeOps = [];
513
+ for (const tag of opts.tags) {
514
+ writeOps.push({
515
+ op: "sadd",
516
+ key: this.tagKey(tag),
517
+ members: [key]
518
+ });
519
+ writeOps.push({
520
+ op: "expireNX",
521
+ key: this.tagKey(tag),
522
+ seconds: redisTtlSeconds
523
+ });
524
+ writeOps.push({
525
+ op: "expireGT",
526
+ key: this.tagKey(tag),
527
+ seconds: redisTtlSeconds
528
+ });
529
+ }
530
+ writeOps.push({
531
+ op: "set",
532
+ key: ck,
533
+ value: payload,
534
+ ttlSeconds: redisTtlSeconds
535
+ });
536
+ if (this.client.execMulti) await this.client.execMulti(writeOps);
537
+ else for (const op of writeOps) await this.execOp(op);
538
+ }
539
+ async execOp(op) {
540
+ switch (op.op) {
541
+ case "set":
542
+ await this.client.set(op.key, op.value, op.ttlSeconds);
543
+ break;
544
+ case "sadd":
545
+ await this.client.sadd(op.key, ...op.members);
546
+ break;
547
+ case "expireNX":
548
+ await this.client.expireNX(op.key, op.seconds);
549
+ break;
550
+ case "expireGT":
551
+ await this.client.expireGT(op.key, op.seconds);
552
+ break;
553
+ case "del": await this.client.del(op.key);
554
+ }
555
+ }
556
+ async invalidate(opts) {
557
+ if (opts.key) {
558
+ const raw = await this.client.get(this.cacheKey(opts.key));
559
+ if (raw !== null) {
560
+ const entry = JSON.parse(raw);
561
+ if (entry.tags) await Promise.all(entry.tags.map((tag) => this.client.srem(this.tagKey(tag), opts.key)));
562
+ }
563
+ await this.client.del(this.cacheKey(opts.key));
564
+ }
565
+ if (opts.tag) {
566
+ const tk = this.tagKey(opts.tag);
567
+ const keys = await this.client.smembers(tk);
568
+ await Promise.all(keys.map(async (k) => {
569
+ const raw = await this.client.get(this.cacheKey(k));
570
+ if (raw === null) {
571
+ await this.client.srem(tk, k);
572
+ return;
573
+ }
574
+ if (JSON.parse(raw).tags?.includes(opts.tag)) await this.client.del(this.cacheKey(k));
575
+ await this.client.srem(tk, k);
576
+ }));
577
+ if ((await this.client.smembers(tk)).length === 0) await this.client.del(tk);
578
+ }
579
+ }
580
+ };
581
+ // src/cache/tag-aware-handler.ts
582
+ var DATA_PREFIX = "d:";
583
+ var TAG_SET_PREFIX = "ts:";
584
+ var TAG_VERSION_PREFIX = "tv:";
585
+ function isNativeStore(store) {
586
+ return !!(store.setWithTags && store.invalidateTag);
587
+ }
588
+ function isEagerStore(store) {
589
+ return !!(store.sadd && store.smembers && store.srem && store.sdel);
590
+ }
591
+ function detectStrategy(store) {
592
+ if (isNativeStore(store)) return {
593
+ kind: "native",
594
+ store
595
+ };
596
+ if (isEagerStore(store)) return {
597
+ kind: "eager",
598
+ store
599
+ };
600
+ return { kind: "lazy" };
601
+ }
602
+ var TagAwareCacheHandler = class {
603
+ store;
604
+ prefix;
605
+ strategy;
606
+ constructor(store, opts) {
607
+ this.store = store;
608
+ this.prefix = opts?.prefix ?? "timber:";
609
+ this.strategy = detectStrategy(store);
610
+ }
611
+ get consistency() {
612
+ return this.store.consistency;
613
+ }
614
+ dataKey(key) {
615
+ return `${this.prefix}${DATA_PREFIX}${key}`;
616
+ }
617
+ /** Namespace tags for native stores so prefix isolates shared stores. */
618
+ prefixTags(tags) {
619
+ return tags.map((t) => `${this.prefix}${t}`);
620
+ }
621
+ tagSetKey(tag) {
622
+ return `${this.prefix}${TAG_SET_PREFIX}${tag}`;
623
+ }
624
+ tagVersionKey(tag) {
625
+ return `${this.prefix}${TAG_VERSION_PREFIX}${tag}`;
626
+ }
627
+ async get(key) {
628
+ const raw = await this.store.get(this.dataKey(key));
629
+ if (raw === null) return null;
630
+ if (this.strategy.kind !== "lazy") {
631
+ const entry = JSON.parse(raw);
632
+ const stale = Date.now() > entry.expiresAt;
633
+ return {
634
+ value: entry.value,
635
+ stale
636
+ };
637
+ }
638
+ const entry = JSON.parse(raw);
639
+ if (entry.tags.length > 0) {
640
+ const currentVersions = await this.getTagVersions(entry.tags);
641
+ for (const tag of entry.tags) {
642
+ const stored = entry.tagVersions[tag] ?? 0;
643
+ if ((currentVersions[tag] ?? 0) > stored) return null;
644
+ }
645
+ }
646
+ const stale = Date.now() > entry.expiresAt;
647
+ return {
648
+ value: entry.value,
649
+ stale
650
+ };
651
+ }
652
+ async set(key, value, opts) {
653
+ const physicalTtl = Math.max(opts.ttl * 2 + 60, 120);
654
+ const strategy = this.strategy;
655
+ if (strategy.kind === "native") {
656
+ const entry = {
657
+ value,
658
+ expiresAt: Date.now() + opts.ttl * 1e3,
659
+ tags: opts.tags
660
+ };
661
+ const payload = JSON.stringify(entry);
662
+ if (opts.tags.length > 0) await strategy.store.setWithTags(this.dataKey(key), payload, physicalTtl, this.prefixTags(opts.tags));
663
+ else await this.store.set(this.dataKey(key), payload, physicalTtl);
664
+ return;
665
+ }
666
+ if (strategy.kind === "eager") {
667
+ const entry = {
668
+ value,
669
+ expiresAt: Date.now() + opts.ttl * 1e3,
670
+ tags: opts.tags
671
+ };
672
+ await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
673
+ if (opts.tags.length > 0) await Promise.all(opts.tags.map((tag) => strategy.store.sadd(this.tagSetKey(tag), [key], physicalTtl)));
674
+ return;
675
+ }
676
+ const tagVersions = opts.tags.length > 0 ? await this.getTagVersions(opts.tags) : {};
677
+ const entry = {
678
+ value,
679
+ expiresAt: Date.now() + opts.ttl * 1e3,
680
+ tags: opts.tags,
681
+ tagVersions
682
+ };
683
+ await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
684
+ }
685
+ async invalidate(opts) {
686
+ const strategy = this.strategy;
687
+ if (opts.key) {
688
+ const key = opts.key;
689
+ if (strategy.kind === "eager") {
690
+ const raw = await this.store.get(this.dataKey(key));
691
+ if (raw !== null) {
692
+ const entry = JSON.parse(raw);
693
+ if (entry.tags.length > 0) await Promise.all(entry.tags.map((tag) => strategy.store.srem(this.tagSetKey(tag), [key])));
694
+ }
695
+ }
696
+ await this.store.del(this.dataKey(key));
697
+ }
698
+ if (opts.tag) {
699
+ const tag = opts.tag;
700
+ if (strategy.kind === "native") await strategy.store.invalidateTag(`${this.prefix}${tag}`);
701
+ else if (strategy.kind === "eager") {
702
+ const members = await strategy.store.smembers(this.tagSetKey(tag));
703
+ await Promise.all(members.map(async (k) => {
704
+ const raw = await this.store.get(this.dataKey(k));
705
+ if (raw !== null && JSON.parse(raw).tags.includes(tag)) await this.store.del(this.dataKey(k));
706
+ await strategy.store.srem(this.tagSetKey(tag), [k]);
707
+ }));
708
+ } else await this.bumpTagVersion(opts.tag);
709
+ }
710
+ }
711
+ async getTagVersions(tags) {
712
+ const versions = {};
713
+ await Promise.all(tags.map(async (tag) => {
714
+ const raw = await this.store.get(this.tagVersionKey(tag));
715
+ versions[tag] = raw !== null ? parseInt(raw, 10) : 0;
716
+ }));
717
+ return versions;
718
+ }
719
+ async bumpTagVersion(tag) {
720
+ const key = this.tagVersionKey(tag);
721
+ const raw = await this.store.get(key);
722
+ const version = Math.max(raw !== null ? parseInt(raw, 10) : 0, Date.now()) + 1;
723
+ await this.store.set(key, String(version), 31536e3);
724
+ }
725
+ };
726
+ // src/cache/index.ts
727
+ var MemoryCacheHandler = class {
728
+ store = /* @__PURE__ */ new Map();
729
+ maxEntries;
730
+ maxBytes;
731
+ maxEntryBytes;
732
+ currentBytes = 0;
733
+ _trackBytes;
734
+ constructor(opts) {
735
+ this.maxEntries = opts?.maxEntries ?? opts?.maxSize ?? 1e3;
736
+ this.maxBytes = opts?.maxBytes;
737
+ this.maxEntryBytes = opts?.maxEntryBytes;
738
+ this._trackBytes = this.maxBytes !== void 0 || this.maxEntryBytes !== void 0;
739
+ }
740
+ async get(key) {
741
+ const entry = this.store.get(key);
742
+ if (!entry) return null;
743
+ this.store.delete(key);
744
+ this.store.set(key, entry);
745
+ const stale = Date.now() > entry.expiresAt;
746
+ return {
747
+ value: entry.value,
748
+ stale
749
+ };
750
+ }
751
+ async set(key, value, opts) {
752
+ const byteSize = this._trackBytes ? estimateByteSize(value) : 0;
753
+ if (this.maxEntryBytes !== void 0 && byteSize > this.maxEntryBytes) return;
754
+ if (this.store.has(key)) {
755
+ const existing = this.store.get(key);
756
+ this.currentBytes -= existing.byteSize;
757
+ this.store.delete(key);
758
+ }
759
+ while (this.store.size >= this.maxEntries) this.evictOldest();
760
+ if (this.maxBytes !== void 0) {
761
+ while (this.currentBytes + byteSize > this.maxBytes && this.store.size > 0) this.evictOldest();
762
+ if (this.currentBytes + byteSize > this.maxBytes) return;
763
+ }
764
+ this.store.set(key, {
765
+ value,
766
+ expiresAt: Date.now() + opts.ttl * 1e3,
767
+ tags: opts.tags,
768
+ byteSize
769
+ });
770
+ this.currentBytes += byteSize;
771
+ }
772
+ async invalidate(opts) {
773
+ if (opts.key) {
774
+ const entry = this.store.get(opts.key);
775
+ if (entry) {
776
+ this.currentBytes -= entry.byteSize;
777
+ this.store.delete(opts.key);
778
+ }
779
+ }
780
+ if (opts.tag) {
781
+ for (const [key, entry] of this.store) if (entry.tags.includes(opts.tag)) {
782
+ this.currentBytes -= entry.byteSize;
783
+ this.store.delete(key);
784
+ }
785
+ }
786
+ }
787
+ /** Number of entries currently in the cache. */
788
+ get size() {
789
+ return this.store.size;
790
+ }
791
+ /** Estimated total byte size of all cached values. Only tracked when maxBytes or maxEntryBytes is configured; returns 0 otherwise. */
792
+ get bytes() {
793
+ return this.currentBytes;
794
+ }
795
+ /** Evict the oldest entry (front of Map). */
796
+ evictOldest() {
797
+ const oldest = this.store.keys().next().value;
798
+ if (oldest !== void 0) {
799
+ const entry = this.store.get(oldest);
800
+ this.currentBytes -= entry.byteSize;
801
+ this.store.delete(oldest);
802
+ }
803
+ }
804
+ };
805
+ // src/server/version-skew.ts
806
+ /**
807
+ * Version Skew Detection — graceful recovery when stale clients hit new deployments.
808
+ *
809
+ * When a new version of the app is deployed, clients with open tabs still have
810
+ * the old JavaScript bundle. Without version skew handling, these stale clients
811
+ * will experience:
812
+ *
813
+ * 1. Server action calls that crash (action IDs are content-hashed)
814
+ * 2. Chunk load failures (old filenames gone from CDN)
815
+ * 3. RSC payload mismatches (component references differ between builds)
816
+ *
817
+ * This module implements deployment ID comparison:
818
+ * - A per-build deployment ID is generated at build time (see build-manifest.ts)
819
+ * - The client sends it via `X-Timber-Deployment-Id` header on every RSC/action request
820
+ * - The server compares it against the current build's ID
821
+ * - On mismatch: signal the client to reload (not crash)
822
+ *
823
+ * The deployment ID is always-on in production. Dev mode skips the check
824
+ * (HMR handles code updates without full reloads).
825
+ *
826
+ * See design/25-production-deployments.md, TIM-446
827
+ */
828
+ /** Header sent by the client with every RSC/action request. */
829
+ var DEPLOYMENT_ID_HEADER = "X-Timber-Deployment-Id";
830
+ /** Response header that signals the client to do a full page reload. */
831
+ var RELOAD_HEADER = "X-Timber-Reload";
832
+ /**
833
+ * The current build's deployment ID. Set at startup from the runtime config
834
+ * (`virtual:timber-config`'s `deploymentId`). Null in dev mode.
835
+ */
836
+ var currentDeploymentId = null;
837
+ /**
838
+ * Get the current deployment ID. Returns null in dev mode.
839
+ */
840
+ function getDeploymentId() {
841
+ return currentDeploymentId;
842
+ }
843
+ /**
844
+ * Check if a request's deployment ID matches the current build.
845
+ *
846
+ * Returns `{ ok: true }` when:
847
+ * - Dev mode (no deployment ID set — HMR handles updates)
848
+ * - No deployment ID header (initial page load, non-RSC request)
849
+ * - Deployment IDs match
850
+ *
851
+ * Returns `{ ok: false }` when:
852
+ * - Client sends a deployment ID that differs from the current build
853
+ */
854
+ function checkVersionSkew(req) {
855
+ if (!currentDeploymentId) return {
856
+ ok: true,
857
+ clientId: null
858
+ };
859
+ const clientId = req.headers.get(DEPLOYMENT_ID_HEADER);
860
+ if (!clientId) return {
861
+ ok: true,
862
+ clientId: null
863
+ };
864
+ if (clientId === currentDeploymentId) return {
865
+ ok: true,
866
+ clientId
867
+ };
868
+ return {
869
+ ok: false,
870
+ clientId
871
+ };
872
+ }
873
+ /**
874
+ * Apply version skew reload headers to a response.
875
+ * Sets X-Timber-Reload: 1 to signal the client to do a full page reload.
876
+ */
877
+ function applyReloadHeaders(headers) {
878
+ headers.set(RELOAD_HEADER, "1");
879
+ }
880
+ // src/server/prebuilt/manifest-tag-index.ts
881
+ /**
882
+ * Build the inverted tag → seed key index from the manifest.
883
+ *
884
+ * Returns a Map where each tag maps to the set of (componentId, cacheKey)
885
+ * pairs whose manifest entries carry that tag. Only entries with non-empty
886
+ * `tags` arrays participate.
887
+ */
888
+ function buildTagIndex(manifest) {
889
+ const index = /* @__PURE__ */ new Map();
890
+ for (const [componentId, component] of Object.entries(manifest)) {
891
+ if (!component || typeof component !== "object" || !("entries" in component)) continue;
892
+ for (const [cacheKey, entry] of Object.entries(component.entries)) {
893
+ if (!entry.tags || entry.tags.length === 0) continue;
894
+ for (const tag of entry.tags) {
895
+ let list = index.get(tag);
896
+ if (!list) {
897
+ list = [];
898
+ index.set(tag, list);
899
+ }
900
+ list.push({
901
+ componentId,
902
+ cacheKey
903
+ });
904
+ }
905
+ }
906
+ }
907
+ return index;
908
+ }
909
+ // src/server/prebuilt/payload-source.ts
910
+ /**
911
+ * Prebuilt payload source — the adapter seam through which the runtime
912
+ * reads build-time flight artifacts (`.timber/dist/prebuilt/`).
913
+ *
914
+ * The runtime never touches the filesystem directly: adapters register a
915
+ * source at startup (Node: fs reads; Cloudflare: the assets binding —
916
+ * design/44-render-at-build-time.md §Adapter Integration). Artifacts are
917
+ * produced by the post-build capture pass (TIM-1119, prebuilt-builder.ts);
918
+ * adapter registration of the source is TIM-1122. Until a source is
919
+ * registered (adapter not wired yet, dev mode, no artifacts built), every
920
+ * lookup misses and cache.component wrappers render live — the designed
921
+ * dynamic-fallback behavior.
922
+ *
923
+ * Phase 3 (design/45 runtime tier) inserts the CacheHandler overlay lookup
924
+ * in front of `lookupPrebuiltPayload` — overlay first, then artifact. The
925
+ * single-lookup-function shape here is that seam.
926
+ */
927
+ var source = null;
928
+ var manifestPromise = null;
929
+ /**
930
+ * Ceiling on the memoized manifest load. Without it, a stalled
931
+ * `loadManifest()` would leave `manifestPromise` pending forever and every
932
+ * subsequent cache.component render would await the same hung promise —
933
+ * the coalesced-promise deadlock class from design/13-security.md (A5).
934
+ * On expiry the load memoizes as null (permanent dynamic fallback, same
935
+ * policy as a failed load) and callers proceed immediately.
936
+ */
937
+ var MANIFEST_LOAD_TIMEOUT_MS = 5e3;
938
+ /**
939
+ * Per-read ceiling on payload reads. The read is awaited inside a server
940
+ * component render — a stalled adapter promise would otherwise hang the
941
+ * RSC stream until the render timeout kills the whole page, when the
942
+ * correct degradation is a miss → live render (codex review round 4 on
943
+ * PR #835).
944
+ */
945
+ var PAYLOAD_READ_TIMEOUT_MS = 5e3;
946
+ /** Race a source promise against a timeout that resolves to `fallback`. */
947
+ async function withTimeout(work, timeoutMs, fallback, onTimeout) {
948
+ let timer;
949
+ try {
950
+ return await Promise.race([work, new Promise((resolve) => {
951
+ timer = setTimeout(() => {
952
+ onTimeout();
953
+ resolve(fallback);
954
+ }, timeoutMs);
955
+ })]);
956
+ } finally {
957
+ clearTimeout(timer);
958
+ }
959
+ }
960
+ async function loadManifestWithTimeout(src) {
961
+ let manifest;
962
+ try {
963
+ manifest = await withTimeout(src.loadManifest(), MANIFEST_LOAD_TIMEOUT_MS, null, () => {
964
+ console.error(`[timber] prebuilt manifest load exceeded ${MANIFEST_LOAD_TIMEOUT_MS}ms — all cache.component lookups will render dynamically`);
965
+ });
966
+ } catch (error) {
967
+ console.error("[timber] failed to load prebuilt manifest — all cache.component lookups will miss:", error);
968
+ return null;
969
+ }
970
+ if (manifest) initTagIndex(manifest);
971
+ return manifest;
972
+ }
973
+ /**
974
+ * Register the payload source. Called once at server startup by the
975
+ * adapter/entry wiring (TIM-1122); tests inject fakes. Passing null
976
+ * unregisters (and drops the memoized manifest).
977
+ */
978
+ function setPrebuiltPayloadSource(next) {
979
+ source = next;
980
+ manifestPromise = null;
981
+ if (!next) resetTagIndex();
982
+ }
983
+ /**
984
+ * Whether a source is registered — the gate for both marker emission and
985
+ * splice-transform installation. False means zero prebuilt overhead.
986
+ */
987
+ function hasPrebuiltPayloadSource() {
988
+ return source !== null;
989
+ }
990
+ /**
991
+ * Ensure the manifest is loaded (and the tag index initialized). No-op
992
+ * when no source is registered. Used by the tombstone path to avoid
993
+ * skipping tombstones on cold processes where the first request is an
994
+ * action rather than a page render.
995
+ */
996
+ async function ensureManifestLoaded() {
997
+ if (source === null) return;
998
+ manifestPromise ??= loadManifestWithTimeout(source);
999
+ await manifestPromise;
1000
+ }
1001
+ /**
1002
+ * Look up a manifest entry (metadata only, no payload read).
1003
+ * Used by the overlay to check seed existence and freshness.
1004
+ */
1005
+ async function isParamIndependent(componentId) {
1006
+ if (source === null) return false;
1007
+ manifestPromise ??= loadManifestWithTimeout(source);
1008
+ return (await manifestPromise)?.[componentId]?.paramIndependent === true;
1009
+ }
1010
+ async function getManifestEntry(componentId, cacheKey) {
1011
+ if (source === null) return null;
1012
+ manifestPromise ??= loadManifestWithTimeout(source);
1013
+ return (await manifestPromise)?.[componentId]?.entries?.[cacheKey] ?? null;
1014
+ }
1015
+ /**
1016
+ * Look up a cached payload: manifest entry → payload bytes.
1017
+ * Null on any miss or read failure — callers fall back to live render.
1018
+ *
1019
+ * The manifest is loaded once and memoized (design/44 §manifest.json:
1020
+ * loaded at startup, held in memory; payloads read on demand). A failed
1021
+ * manifest load is memoized as null rather than retried per-request — a
1022
+ * broken artifact should degrade to dynamic rendering, not add a failing
1023
+ * read to every request.
1024
+ */
1025
+ async function lookupPrebuiltPayload(componentId, cacheKey) {
1026
+ if (source === null) return null;
1027
+ manifestPromise ??= loadManifestWithTimeout(source);
1028
+ const entry = (await manifestPromise)?.[componentId]?.entries?.[cacheKey];
1029
+ if (!entry) return null;
1030
+ try {
1031
+ return await withTimeout(source.readPayload(entry.file), PAYLOAD_READ_TIMEOUT_MS, null, () => {
1032
+ console.error(`[timber] prebuilt payload read for "${entry.file}" exceeded ${PAYLOAD_READ_TIMEOUT_MS}ms — rendering dynamically`);
1033
+ });
1034
+ } catch (error) {
1035
+ console.error(`[timber] failed to read prebuilt payload "${entry.file}" for ${componentId} — rendering dynamically:`, error);
1036
+ return null;
1037
+ }
1038
+ }
1039
+ /** The build-artifact seed for an entry, or null if the build has none. */
1040
+ async function lookupArtifactSeed(id, cacheKey, needsTimestamp) {
1041
+ const payload = await lookupPrebuiltPayload(id, cacheKey);
1042
+ if (payload === null) return null;
1043
+ return {
1044
+ payload,
1045
+ capturedAt: (needsTimestamp ? await getManifestEntry(id, cacheKey) : null)?.buildTimestamp ?? 0
1046
+ };
1047
+ }
1048
+ // src/server/prebuilt/overlay.ts
1049
+ /**
1050
+ * Component cache overlay — runtime CacheHandler layer for ISR.
1051
+ *
1052
+ * Sits in front of the immutable build artifact (`.flight` files) and
1053
+ * stores replacement payloads and tombstones via the configured
1054
+ * CacheHandler. Overlay entries are per-deploy namespaced:
1055
+ * `timber:c:{deploymentId}:{componentId}:{hash}`
1056
+ *
1057
+ * The CacheHandler contract is untouched — tombstones and the tag index
1058
+ * live above the interface as value conventions. Redis, KV, and custom
1059
+ * handlers work unmodified.
1060
+ *
1061
+ * See design/45-cache-lifetimes.md §ISR mechanics.
1062
+ */
1063
+ /** Default ceiling TTL for tag-only entries (24 hours), in seconds. */
1064
+ var CEILING_TTL_SECONDS = 86400;
1065
+ /** Deploy-long physical TTL for seed-backed overlay records (90 days). */
1066
+ var DEPLOY_LONG_TTL_SECONDS = 7776e3;
1067
+ function isOverlayRecord(v) {
1068
+ return v !== null && typeof v === "object" && v._t === "co";
1069
+ }
1070
+ function isTombstone(v) {
1071
+ return v !== null && typeof v === "object" && v._t === "ct";
1072
+ }
1073
+ /**
1074
+ * In dev the deployment ID is null; the dev store namespace stands in for
1075
+ * it and changes on every source change, so entries stored before a save
1076
+ * become unreachable (server/prebuilt/dev-store.ts).
1077
+ */
1078
+ function overlayKey(componentId, cacheKey) {
1079
+ return `timber:c:${getDeploymentId() ?? devOverlayNamespace() ?? "dev"}:${componentId}:${cacheKey}`;
1080
+ }
1081
+ /**
1082
+ * Whether a re-render that started at `startEpoch` may store its capture
1083
+ * under `oKey`: nothing invalidated the key or its tags meanwhile
1084
+ * (TIM-1028), and the overlay key has not moved on. In dev a save moves it
1085
+ * to a new namespace, and the bytes may come from the pre-save code: stored,
1086
+ * they would answer every request after the save.
1087
+ */
1088
+ function mayStoreRerender(startEpoch, componentId, cacheKey, oKey, tags) {
1089
+ return !wasInvalidatedSince(startEpoch, oKey, tags) && overlayKey(componentId, cacheKey) === oKey;
1090
+ }
1091
+ var READ_FAILED = Symbol("overlay read failed");
1092
+ /**
1093
+ * Look up an overlay entry in the cache handler.
1094
+ * Returns null on a clean miss (no overlay entry at all).
1095
+ */
1096
+ async function lookupOverlay(componentId, cacheKey) {
1097
+ const handler = getCacheHandler();
1098
+ const key = overlayKey(componentId, cacheKey);
1099
+ const result = await guardedRead(key, () => handler.get(key), READ_FAILED);
1100
+ if (result === READ_FAILED) return {
1101
+ kind: "unreadable",
1102
+ record: null,
1103
+ payload: null
1104
+ };
1105
+ if (!result) return null;
1106
+ const value = result.value;
1107
+ if (isTombstone(value)) return {
1108
+ kind: "tombstone",
1109
+ record: null,
1110
+ payload: null
1111
+ };
1112
+ if (isOverlayRecord(value)) return {
1113
+ kind: Date.now() > value.fu ? "stale" : "fresh",
1114
+ record: value,
1115
+ payload: base64ToBytes(value.p)
1116
+ };
1117
+ return null;
1118
+ }
1119
+ /**
1120
+ * Resolve the effective TTL for a component's runtime lifetime.
1121
+ * Tag-only entries (no explicit ttl) get the ceiling TTL (design/45
1122
+ * §Tag-only entries carry a ceiling TTL).
1123
+ */
1124
+ function effectiveTtl(ttl) {
1125
+ return ttl ?? CEILING_TTL_SECONDS;
1126
+ }
1127
+ /**
1128
+ * Store a component flight payload in the overlay.
1129
+ */
1130
+ async function storeOverlayEntry(componentId, cacheKey, payloadBytes, opts) {
1131
+ const handler = getCacheHandler();
1132
+ const key = overlayKey(componentId, cacheKey);
1133
+ const logicalTtl = effectiveTtl(opts.ttl);
1134
+ const physicalTtl = opts.hasSeed ? DEPLOY_LONG_TTL_SECONDS : logicalTtl;
1135
+ const record = {
1136
+ _t: "co",
1137
+ p: bytesToBase64(payloadBytes),
1138
+ fu: Date.now() + logicalTtl * 1e3,
1139
+ s: opts.hasSeed
1140
+ };
1141
+ await handler.set(key, record, {
1142
+ ttl: physicalTtl,
1143
+ tags: opts.tags
1144
+ });
1145
+ }
1146
+ var tagIndex = null;
1147
+ /**
1148
+ * Initialize the tag index from the prebuilt manifest. Called once when the
1149
+ * manifest is loaded. Without a manifest (no prebuilt components), this is
1150
+ * never called and revalidateTag skips the tombstone path entirely.
1151
+ */
1152
+ function initTagIndex(manifest) {
1153
+ tagIndex = buildTagIndex(manifest);
1154
+ emitIsrDiagnosticIfNeeded(manifest);
1155
+ }
1156
+ /**
1157
+ * Reset the tag index (for tests).
1158
+ * @internal
1159
+ */
1160
+ function resetTagIndex() {
1161
+ tagIndex = null;
1162
+ }
1163
+ /**
1164
+ * Write tombstones for all seed entries carrying the given tag.
1165
+ * Called from cache.invalidate (cache-api.ts) AFTER the handler's own
1166
+ * invalidation clears overlay entries.
1167
+ *
1168
+ * The tombstone prevents the immutable seed from being served after
1169
+ * invalidation — without it, a handler.invalidate that clears the overlay
1170
+ * would expose the (now-stale) build artifact on the next request.
1171
+ *
1172
+ * Ensures the manifest is loaded first so cold-process actions that
1173
+ * invalidate before any page render still write tombstones.
1174
+ */
1175
+ async function writeTombstonesForTag(tag) {
1176
+ if (!tagIndex) await ensureManifestLoaded();
1177
+ if (!tagIndex) return;
1178
+ const seeds = tagIndex.get(tag);
1179
+ if (!seeds || seeds.length === 0) return;
1180
+ const handler = getCacheHandler();
1181
+ const tombstone = { _t: "ct" };
1182
+ await Promise.all(seeds.map((seed) => {
1183
+ const key = overlayKey(seed.componentId, seed.cacheKey);
1184
+ return handler.set(key, tombstone, {
1185
+ ttl: DEPLOY_LONG_TTL_SECONDS,
1186
+ tags: [tag]
1187
+ });
1188
+ }));
1189
+ }
1190
+ var isrDiagnosticEmitted = false;
1191
+ function emitIsrDiagnosticIfNeeded(manifest) {
1192
+ if (isrDiagnosticEmitted) return;
1193
+ if (!(getCacheHandler() instanceof MemoryCacheHandler || !isCacheHandlerConfigured())) return;
1194
+ for (const [, component] of Object.entries(manifest)) {
1195
+ if (!component || typeof component !== "object" || !("entries" in component)) continue;
1196
+ for (const [, entry] of Object.entries(component.entries)) if (entry.tags && entry.tags.length > 0) {
1197
+ isrDiagnosticEmitted = true;
1198
+ console.warn("[timber] tag revalidation of prerendered components requires a shared cache handler in multi-instance deployments. The current MemoryCacheHandler is per-process — revalidateTag on one instance will not purge the build seed on others. Configure a shared handler (Redis, KV) for production ISR.");
1199
+ return;
1200
+ }
1201
+ }
1202
+ }
1203
+ function bytesToBase64(bytes) {
1204
+ return Buffer.from(bytes).toString("base64");
1205
+ }
1206
+ function base64ToBytes(b64) {
1207
+ return new Uint8Array(Buffer.from(b64, "base64"));
1208
+ }
1209
+ // src/cache/cache-api.ts
1210
+ var componentFallbackWarned = /* @__PURE__ */ new WeakSet();
1211
+ /**
1212
+ * Cache namespace — `cache.data`, `cache.component`, `cache.invalidate`.
1213
+ *
1214
+ * ```ts
1215
+ * import { cache } from '@timber-js/app/cache';
1216
+ *
1217
+ * const getUser = cache.data(
1218
+ * async (id: string) => db.users.findUnique({ where: { id } }),
1219
+ * { ttl: 60, tags: (id) => [`user:${id}`] }
1220
+ * );
1221
+ * ```
1222
+ */
1223
+ var cache = {
1224
+ /**
1225
+ * Wrap an async function with cross-request caching.
1226
+ *
1227
+ * The configured cache handler (defaults to MemoryCacheHandler, overridable
1228
+ * via timber.config.ts) is re-resolved on every call, so module-scope
1229
+ * wrappers created before `setCacheHandler()` still pick up the configured
1230
+ * handler (TIM-1029).
1231
+ */
1232
+ data(fn, opts, stableId) {
1233
+ return createCache(fn, opts, getCacheHandler, stableId);
1234
+ },
1235
+ /**
1236
+ * Invalidate cache entries by tag or key.
1237
+ *
1238
+ * ```ts
1239
+ * cache.invalidate({ tag: 'products' });
1240
+ * cache.invalidate({ key: 'user:abc' });
1241
+ * ```
1242
+ */
1243
+ async invalidate(opts) {
1244
+ recordInvalidation(opts);
1245
+ await getCacheHandler().invalidate(opts.key === void 0 ? opts : {
1246
+ ...opts,
1247
+ key: devDataCacheKey(opts.key)
1248
+ });
1249
+ if (opts.tag) {
1250
+ await writeTombstonesForTag(opts.tag);
1251
+ invalidateDevSeedsByTag(opts.tag);
1252
+ }
1253
+ if (opts.tag) {
1254
+ const purgeHandler = getCdnPurgeHandler();
1255
+ if (purgeHandler) try {
1256
+ await Promise.race([purgeHandler.purgeTags([opts.tag]), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("CDN purge timed out (10s)")), 1e4))]);
1257
+ } catch (err) {
1258
+ console.error("[timber] CDN purge failed for tag:", err);
1259
+ }
1260
+ }
1261
+ },
1262
+ /**
1263
+ * Runtime fallback for `cache.component(...)` callsites the timber-prebuilt
1264
+ * transform does not rewrite — nested/computed/argument-position forms (see
1265
+ * plugins/prebuilt.ts). Only module-scope `const X = cache.component(...)`
1266
+ * declarations are transformed and eligible for prebuilding; everything else
1267
+ * lands here, warns once per component, and renders dynamically. Same
1268
+ * safety-net pattern as the data cache's runtime fnId fallback (TIM-1054):
1269
+ * an untraceable callsite degrades in performance, never in correctness.
1270
+ */
1271
+ component(componentFn, _options) {
1272
+ if (!componentFallbackWarned.has(componentFn)) {
1273
+ componentFallbackWarned.add(componentFn);
1274
+ const name = componentFn.name || "anonymous component";
1275
+ console.warn(`[timber] cache.component: "${name}" was not transformed at build time — rendering dynamically. Only module-scope declarations (const X = cache.component(...)) are prebuilt.`);
1276
+ }
1277
+ return componentFn;
1278
+ }
1279
+ };
1280
+ export { getWaitUntil as _, storeOverlayEntry as a, lookupArtifactSeed as c, checkVersionSkew as d, MemoryCacheHandler as f, observeKeyDiscipline as g, setDefaultSingleflightTimeout as h, overlayKey as i, setPrebuiltPayloadSource as l, RedisCacheHandler as m, lookupOverlay as n, hasPrebuiltPayloadSource as o, TagAwareCacheHandler as p, mayStoreRerender as r, isParamIndependent as s, cache as t, applyReloadHeaders as u };
1281
+
1282
+ //# sourceMappingURL=cache-api-BZJNt01a.js.map