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

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 (1560) hide show
  1. package/LICENSE +8 -0
  2. package/agent-skill.md +376 -0
  3. package/bin/timber.mjs +15 -1
  4. package/dist/_chunks/actions-DHum77eH.js +1272 -0
  5. package/dist/_chunks/actions-DHum77eH.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-B-JZkpBD.js +251 -0
  24. package/dist/_chunks/cli-check-B-JZkpBD.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-CPc6bjVl.js +20 -0
  40. package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
  41. package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
  42. package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
  43. package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
  44. package/dist/_chunks/convention-lint-CrDKERHg.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-validation-CEZy1V-k.js +210 -0
  71. package/dist/_chunks/href-validation-CEZy1V-k.js.map +1 -0
  72. package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
  73. package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
  74. package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
  75. package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
  76. package/dist/_chunks/logger-YtMSKfft.js +755 -0
  77. package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
  78. package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
  79. package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
  80. package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
  81. package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
  82. package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
  83. package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
  84. package/dist/_chunks/param-value-DqlGfF57.js +65 -0
  85. package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
  86. package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
  87. package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
  88. package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
  89. package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
  90. package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
  91. package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
  92. package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
  93. package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
  94. package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
  95. package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
  96. package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
  97. package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
  98. package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
  99. package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
  100. package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
  101. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
  102. package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
  103. package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
  104. package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
  105. package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
  106. package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
  107. package/dist/_chunks/scan-CyizcBiX.js +139 -0
  108. package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
  109. package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
  110. package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
  111. package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
  112. package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
  113. package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
  114. package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
  115. package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
  116. package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
  117. package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
  118. package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
  119. package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
  120. package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
  121. package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
  122. package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
  123. package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
  124. package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
  125. package/dist/_chunks/state-B-EBjeER.js +49 -0
  126. package/dist/_chunks/state-B-EBjeER.js.map +1 -0
  127. package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
  128. package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
  129. package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
  130. package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
  131. package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
  132. package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
  133. package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
  134. package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
  135. package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
  136. package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
  137. package/dist/adapters/build-output-helper.d.ts +81 -0
  138. package/dist/adapters/build-output-helper.d.ts.map +1 -0
  139. package/dist/adapters/canonicalize-module.d.ts +8 -0
  140. package/dist/adapters/canonicalize-module.d.ts.map +1 -0
  141. package/dist/adapters/cloudflare-dev.d.ts +109 -0
  142. package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
  143. package/dist/adapters/cloudflare-dev.js +73 -0
  144. package/dist/adapters/cloudflare-dev.js.map +1 -0
  145. package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
  146. package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
  147. package/dist/adapters/cloudflare-kv-cache.js +122 -0
  148. package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
  149. package/dist/adapters/cloudflare.d.ts +217 -24
  150. package/dist/adapters/cloudflare.d.ts.map +1 -1
  151. package/dist/adapters/cloudflare.js +1 -188
  152. package/dist/adapters/compress-module.d.ts +25 -4
  153. package/dist/adapters/compress-module.d.ts.map +1 -1
  154. package/dist/adapters/fs-identity.d.ts +63 -0
  155. package/dist/adapters/fs-identity.d.ts.map +1 -0
  156. package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
  157. package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
  158. package/dist/adapters/nitro-presets.d.ts +37 -0
  159. package/dist/adapters/nitro-presets.d.ts.map +1 -0
  160. package/dist/adapters/nitro-preview.d.ts +65 -0
  161. package/dist/adapters/nitro-preview.d.ts.map +1 -0
  162. package/dist/adapters/nitro.d.ts +69 -38
  163. package/dist/adapters/nitro.d.ts.map +1 -1
  164. package/dist/adapters/nitro.js +837 -347
  165. package/dist/adapters/nitro.js.map +1 -1
  166. package/dist/adapters/shared.d.ts +85 -0
  167. package/dist/adapters/shared.d.ts.map +1 -0
  168. package/dist/adapters/types.d.ts +124 -16
  169. package/dist/adapters/types.d.ts.map +1 -1
  170. package/dist/adapters/types.js +0 -0
  171. package/dist/analyze/chains.d.ts +124 -0
  172. package/dist/analyze/chains.d.ts.map +1 -0
  173. package/dist/analyze/classify.d.ts +153 -0
  174. package/dist/analyze/classify.d.ts.map +1 -0
  175. package/dist/analyze/crawl-entry.d.ts +17 -0
  176. package/dist/analyze/crawl-entry.d.ts.map +1 -0
  177. package/dist/analyze/crawl-entry.js +312 -0
  178. package/dist/analyze/crawl-entry.js.map +1 -0
  179. package/dist/analyze/crawl.d.ts +134 -0
  180. package/dist/analyze/crawl.d.ts.map +1 -0
  181. package/dist/analyze/graph-cache.d.ts +104 -0
  182. package/dist/analyze/graph-cache.d.ts.map +1 -0
  183. package/dist/analyze/graph-command.d.ts +43 -0
  184. package/dist/analyze/graph-command.d.ts.map +1 -0
  185. package/dist/analyze/graph-command.js +386 -0
  186. package/dist/analyze/graph-command.js.map +1 -0
  187. package/dist/analyze/live-graph.d.ts +81 -0
  188. package/dist/analyze/live-graph.d.ts.map +1 -0
  189. package/dist/analyze/poison-rules.d.ts +72 -0
  190. package/dist/analyze/poison-rules.d.ts.map +1 -0
  191. package/dist/analyze/poison-scan.d.ts +48 -0
  192. package/dist/analyze/poison-scan.d.ts.map +1 -0
  193. package/dist/analyze/scan.d.ts +73 -0
  194. package/dist/analyze/scan.d.ts.map +1 -0
  195. package/dist/cache/cache-api.d.ts +48 -0
  196. package/dist/cache/cache-api.d.ts.map +1 -0
  197. package/dist/cache/fast-hash.d.ts +5 -0
  198. package/dist/cache/fast-hash.d.ts.map +1 -1
  199. package/dist/cache/guarded-read.d.ts +29 -0
  200. package/dist/cache/guarded-read.d.ts.map +1 -0
  201. package/dist/cache/handler-store.d.ts +45 -0
  202. package/dist/cache/handler-store.d.ts.map +1 -0
  203. package/dist/cache/index.d.ts +32 -9
  204. package/dist/cache/index.d.ts.map +1 -1
  205. package/dist/cache/index.js +4 -326
  206. package/dist/cache/invalidation-epoch.d.ts +50 -0
  207. package/dist/cache/invalidation-epoch.d.ts.map +1 -0
  208. package/dist/cache/json-lossy-check.d.ts +11 -0
  209. package/dist/cache/json-lossy-check.d.ts.map +1 -0
  210. package/dist/cache/key-discipline.d.ts +61 -0
  211. package/dist/cache/key-discipline.d.ts.map +1 -0
  212. package/dist/cache/redis-handler.d.ts +140 -9
  213. package/dist/cache/redis-handler.d.ts.map +1 -1
  214. package/dist/cache/singleflight.d.ts +31 -2
  215. package/dist/cache/singleflight.d.ts.map +1 -1
  216. package/dist/cache/sizeof.d.ts +22 -0
  217. package/dist/cache/sizeof.d.ts.map +1 -0
  218. package/dist/cache/stable-stringify.d.ts +15 -0
  219. package/dist/cache/stable-stringify.d.ts.map +1 -1
  220. package/dist/cache/store.d.ts +53 -0
  221. package/dist/cache/store.d.ts.map +1 -0
  222. package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
  223. package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
  224. package/dist/cache/stores/cloudflare-kv.js +28 -0
  225. package/dist/cache/stores/cloudflare-kv.js.map +1 -0
  226. package/dist/cache/stores/memory.d.ts +42 -0
  227. package/dist/cache/stores/memory.d.ts.map +1 -0
  228. package/dist/cache/stores/memory.js +89 -0
  229. package/dist/cache/stores/memory.js.map +1 -0
  230. package/dist/cache/stores/redis.d.ts +69 -0
  231. package/dist/cache/stores/redis.d.ts.map +1 -0
  232. package/dist/cache/stores/redis.js +34 -0
  233. package/dist/cache/stores/redis.js.map +1 -0
  234. package/dist/cache/stores/vercel.d.ts +36 -0
  235. package/dist/cache/stores/vercel.d.ts.map +1 -0
  236. package/dist/cache/stores/vercel.js +32 -0
  237. package/dist/cache/stores/vercel.js.map +1 -0
  238. package/dist/cache/tag-aware-handler.d.ts +51 -0
  239. package/dist/cache/tag-aware-handler.d.ts.map +1 -0
  240. package/dist/cache/timber-cache.d.ts +25 -11
  241. package/dist/cache/timber-cache.d.ts.map +1 -1
  242. package/dist/cdn/cloudflare-purge.d.ts +23 -0
  243. package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
  244. package/dist/cdn/cloudflare-purge.js +29 -0
  245. package/dist/cdn/cloudflare-purge.js.map +1 -0
  246. package/dist/cdn/fastly-purge.d.ts +25 -0
  247. package/dist/cdn/fastly-purge.d.ts.map +1 -0
  248. package/dist/cdn/fastly-purge.js +32 -0
  249. package/dist/cdn/fastly-purge.js.map +1 -0
  250. package/dist/cdn/headers.d.ts +97 -0
  251. package/dist/cdn/headers.d.ts.map +1 -0
  252. package/dist/cdn/index.d.ts +5 -0
  253. package/dist/cdn/index.d.ts.map +1 -0
  254. package/dist/cdn/index.js +93 -0
  255. package/dist/cdn/index.js.map +1 -0
  256. package/dist/cdn/purge-store.d.ts +32 -0
  257. package/dist/cdn/purge-store.d.ts.map +1 -0
  258. package/dist/cdn/workers-cache-purge.d.ts +20 -0
  259. package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
  260. package/dist/cdn/workers-cache-purge.js +33 -0
  261. package/dist/cdn/workers-cache-purge.js.map +1 -0
  262. package/dist/cli-check.d.ts +133 -0
  263. package/dist/cli-check.d.ts.map +1 -0
  264. package/dist/cli-context.d.ts +62 -0
  265. package/dist/cli-context.d.ts.map +1 -0
  266. package/dist/cli-dev-status.d.ts +75 -0
  267. package/dist/cli-dev-status.d.ts.map +1 -0
  268. package/dist/cli-init.d.ts +72 -0
  269. package/dist/cli-init.d.ts.map +1 -0
  270. package/dist/cli-schema-sync.d.ts +59 -0
  271. package/dist/cli-schema-sync.d.ts.map +1 -0
  272. package/dist/cli.d.ts +80 -16
  273. package/dist/cli.d.ts.map +1 -1
  274. package/dist/cli.js +210 -69
  275. package/dist/cli.js.map +1 -1
  276. package/dist/client/browser-dev.d.ts +42 -2
  277. package/dist/client/browser-dev.d.ts.map +1 -1
  278. package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
  279. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
  280. package/dist/client/browser-entry/action-queue.d.ts +64 -0
  281. package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
  282. package/dist/client/browser-entry/form-state.d.ts +22 -0
  283. package/dist/client/browser-entry/form-state.d.ts.map +1 -0
  284. package/dist/client/browser-entry/hmr.d.ts +27 -0
  285. package/dist/client/browser-entry/hmr.d.ts.map +1 -0
  286. package/dist/client/browser-entry/hydrate.d.ts +61 -0
  287. package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
  288. package/dist/client/browser-entry/index.d.ts +32 -0
  289. package/dist/client/browser-entry/index.d.ts.map +1 -0
  290. package/dist/client/browser-entry/post-hydration.d.ts +26 -0
  291. package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
  292. package/dist/client/browser-entry/router-init.d.ts +41 -0
  293. package/dist/client/browser-entry/router-init.d.ts.map +1 -0
  294. package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
  295. package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
  296. package/dist/client/browser-entry/scroll.d.ts +28 -0
  297. package/dist/client/browser-entry/scroll.d.ts.map +1 -0
  298. package/dist/client/deny-last-resort.d.ts +29 -0
  299. package/dist/client/deny-last-resort.d.ts.map +1 -0
  300. package/dist/client/dev-pill/index.d.ts +32 -0
  301. package/dist/client/dev-pill/index.d.ts.map +1 -0
  302. package/dist/client/dev-pill/store.d.ts +105 -0
  303. package/dist/client/dev-pill/store.d.ts.map +1 -0
  304. package/dist/client/dev-pill/view.d.ts +9 -0
  305. package/dist/client/dev-pill/view.d.ts.map +1 -0
  306. package/dist/client/error-boundary.d.ts +58 -9
  307. package/dist/client/error-boundary.d.ts.map +1 -1
  308. package/dist/client/error-boundary.js +1 -126
  309. package/dist/client/error-reconstituter.d.ts +55 -0
  310. package/dist/client/error-reconstituter.d.ts.map +1 -0
  311. package/dist/client/form.d.ts +38 -99
  312. package/dist/client/form.d.ts.map +1 -1
  313. package/dist/client/global-context.d.ts +35 -0
  314. package/dist/client/global-context.d.ts.map +1 -0
  315. package/dist/client/history.d.ts +50 -9
  316. package/dist/client/history.d.ts.map +1 -1
  317. package/dist/client/index.d.ts +22 -33
  318. package/dist/client/index.d.ts.map +1 -1
  319. package/dist/client/index.js +416 -1241
  320. package/dist/client/index.js.map +1 -1
  321. package/dist/client/internal.d.ts +20 -0
  322. package/dist/client/internal.d.ts.map +1 -0
  323. package/dist/client/internal.js +785 -0
  324. package/dist/client/internal.js.map +1 -0
  325. package/dist/client/link.d.ts +85 -60
  326. package/dist/client/link.d.ts.map +1 -1
  327. package/dist/client/location-search.d.ts +12 -0
  328. package/dist/client/location-search.d.ts.map +1 -0
  329. package/dist/client/navigation-api.d.ts +95 -0
  330. package/dist/client/navigation-api.d.ts.map +1 -0
  331. package/dist/client/navigation-commit.d.ts +111 -0
  332. package/dist/client/navigation-commit.d.ts.map +1 -0
  333. package/dist/client/navigation-context.d.ts +75 -37
  334. package/dist/client/navigation-context.d.ts.map +1 -1
  335. package/dist/client/navigation-root.d.ts +106 -0
  336. package/dist/client/navigation-root.d.ts.map +1 -0
  337. package/dist/client/navigation-transition.d.ts +255 -0
  338. package/dist/client/navigation-transition.d.ts.map +1 -0
  339. package/dist/client/nuqs-adapter.d.ts +5 -2
  340. package/dist/client/nuqs-adapter.d.ts.map +1 -1
  341. package/dist/client/params-context.d.ts +81 -0
  342. package/dist/client/params-context.d.ts.map +1 -0
  343. package/dist/client/react-root.d.ts +51 -0
  344. package/dist/client/react-root.d.ts.map +1 -0
  345. package/dist/client/router-effects.d.ts +203 -0
  346. package/dist/client/router-effects.d.ts.map +1 -0
  347. package/dist/client/router-lifecycle.d.ts +107 -0
  348. package/dist/client/router-lifecycle.d.ts.map +1 -0
  349. package/dist/client/router-pipeline.d.ts +81 -0
  350. package/dist/client/router-pipeline.d.ts.map +1 -0
  351. package/dist/client/router-ref.d.ts +2 -2
  352. package/dist/client/router-ref.d.ts.map +1 -1
  353. package/dist/client/router-skew.d.ts +21 -0
  354. package/dist/client/router-skew.d.ts.map +1 -0
  355. package/dist/client/router-types.d.ts +294 -0
  356. package/dist/client/router-types.d.ts.map +1 -0
  357. package/dist/client/router-url.d.ts +24 -0
  358. package/dist/client/router-url.d.ts.map +1 -0
  359. package/dist/client/router.d.ts +1 -97
  360. package/dist/client/router.d.ts.map +1 -1
  361. package/dist/client/rsc-fetch.d.ts +110 -28
  362. package/dist/client/rsc-fetch.d.ts.map +1 -1
  363. package/dist/client/segment-cache.d.ts +186 -25
  364. package/dist/client/segment-cache.d.ts.map +1 -1
  365. package/dist/client/segment-context.d.ts.map +1 -1
  366. package/dist/client/segment-outlet.d.ts +68 -0
  367. package/dist/client/segment-outlet.d.ts.map +1 -0
  368. package/dist/client/segment-update-context.d.ts +15 -0
  369. package/dist/client/segment-update-context.d.ts.map +1 -0
  370. package/dist/client/shallow-url.d.ts +10 -0
  371. package/dist/client/shallow-url.d.ts.map +1 -0
  372. package/dist/client/slot-content-cache-context.d.ts +35 -0
  373. package/dist/client/slot-content-cache-context.d.ts.map +1 -0
  374. package/dist/client/slot-context.d.ts +31 -0
  375. package/dist/client/slot-context.d.ts.map +1 -0
  376. package/dist/client/slot-outlet.d.ts +16 -0
  377. package/dist/client/slot-outlet.d.ts.map +1 -0
  378. package/dist/client/slot-provider.d.ts +25 -0
  379. package/dist/client/slot-provider.d.ts.map +1 -0
  380. package/dist/client/ssr-data.d.ts +26 -50
  381. package/dist/client/ssr-data.d.ts.map +1 -1
  382. package/dist/client/stale-client.d.ts +69 -0
  383. package/dist/client/stale-client.d.ts.map +1 -0
  384. package/dist/client/state.d.ts +21 -13
  385. package/dist/client/state.d.ts.map +1 -1
  386. package/dist/client/status-page-marker.d.ts +25 -0
  387. package/dist/client/status-page-marker.d.ts.map +1 -0
  388. package/dist/client/top-loader.d.ts +7 -6
  389. package/dist/client/top-loader.d.ts.map +1 -1
  390. package/dist/client/unload-guard.d.ts +5 -0
  391. package/dist/client/unload-guard.d.ts.map +1 -1
  392. package/dist/client/use-cookie.d.ts +25 -0
  393. package/dist/client/use-cookie.d.ts.map +1 -1
  394. package/dist/client/use-field-state.d.ts +42 -0
  395. package/dist/client/use-field-state.d.ts.map +1 -0
  396. package/dist/client/use-link-status.d.ts +5 -5
  397. package/dist/client/use-link-status.d.ts.map +1 -1
  398. package/dist/client/use-pathname.d.ts +13 -11
  399. package/dist/client/use-pathname.d.ts.map +1 -1
  400. package/dist/client/use-pending-navigation.d.ts +47 -0
  401. package/dist/client/use-pending-navigation.d.ts.map +1 -0
  402. package/dist/client/use-query-states.d.ts +10 -4
  403. package/dist/client/use-query-states.d.ts.map +1 -1
  404. package/dist/client/use-router.d.ts +15 -8
  405. package/dist/client/use-router.d.ts.map +1 -1
  406. package/dist/client/use-search-params.d.ts +15 -8
  407. package/dist/client/use-search-params.d.ts.map +1 -1
  408. package/dist/client/use-segment-params.d.ts +55 -0
  409. package/dist/client/use-segment-params.d.ts.map +1 -0
  410. package/dist/codec.d.ts +69 -0
  411. package/dist/codec.d.ts.map +1 -0
  412. package/dist/codec.js +75 -0
  413. package/dist/codec.js.map +1 -0
  414. package/dist/config-types.d.ts +366 -0
  415. package/dist/config-types.d.ts.map +1 -0
  416. package/dist/config-validation.d.ts +68 -0
  417. package/dist/config-validation.d.ts.map +1 -0
  418. package/dist/cookies/define-cookie.d.ts +58 -25
  419. package/dist/cookies/define-cookie.d.ts.map +1 -1
  420. package/dist/cookies/index.d.ts +3 -2
  421. package/dist/cookies/index.d.ts.map +1 -1
  422. package/dist/cookies/index.js +230 -37
  423. package/dist/cookies/index.js.map +1 -1
  424. package/dist/cookies/json-cookie.d.ts +64 -0
  425. package/dist/cookies/json-cookie.d.ts.map +1 -0
  426. package/dist/cookies/validation.d.ts +34 -0
  427. package/dist/cookies/validation.d.ts.map +1 -0
  428. package/dist/dev-tools/404-page.d.ts +50 -0
  429. package/dist/dev-tools/404-page.d.ts.map +1 -0
  430. package/dist/dev-tools/await-span.d.ts +17 -0
  431. package/dist/dev-tools/await-span.d.ts.map +1 -0
  432. package/dist/dev-tools/browser-logs.d.ts +40 -0
  433. package/dist/dev-tools/browser-logs.d.ts.map +1 -0
  434. package/dist/dev-tools/dev-page-shell.d.ts +95 -0
  435. package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
  436. package/dist/dev-tools/error-page.d.ts +32 -0
  437. package/dist/dev-tools/error-page.d.ts.map +1 -0
  438. package/dist/dev-tools/holding-server.d.ts +46 -0
  439. package/dist/dev-tools/holding-server.d.ts.map +1 -0
  440. package/dist/dev-tools/hydration-overlay.d.ts +11 -0
  441. package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
  442. package/dist/dev-tools/index.d.ts +31 -0
  443. package/dist/dev-tools/index.d.ts.map +1 -0
  444. package/dist/dev-tools/instrumentation.d.ts +74 -0
  445. package/dist/dev-tools/instrumentation.d.ts.map +1 -0
  446. package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
  447. package/dist/dev-tools/logger.d.ts.map +1 -0
  448. package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
  449. package/dist/dev-tools/logs.d.ts.map +1 -0
  450. package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
  451. package/dist/dev-tools/overlay.d.ts.map +1 -0
  452. package/dist/dev-tools/span-sink.d.ts +42 -0
  453. package/dist/dev-tools/span-sink.d.ts.map +1 -0
  454. package/dist/dev-tools/stack-classifier.d.ts +34 -0
  455. package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
  456. package/dist/dev-tools/terminal.d.ts +28 -0
  457. package/dist/dev-tools/terminal.d.ts.map +1 -0
  458. package/dist/fonts/ast-walk.d.ts +68 -0
  459. package/dist/fonts/ast-walk.d.ts.map +1 -0
  460. package/dist/fonts/ast.d.ts +112 -8
  461. package/dist/fonts/ast.d.ts.map +1 -1
  462. package/dist/fonts/bundle.d.ts +50 -0
  463. package/dist/fonts/bundle.d.ts.map +1 -0
  464. package/dist/fonts/css.d.ts +1 -1
  465. package/dist/fonts/dev-middleware.d.ts +22 -0
  466. package/dist/fonts/dev-middleware.d.ts.map +1 -0
  467. package/dist/fonts/fallbacks.d.ts +0 -7
  468. package/dist/fonts/fallbacks.d.ts.map +1 -1
  469. package/dist/fonts/google.d.ts +5 -3
  470. package/dist/fonts/google.d.ts.map +1 -1
  471. package/dist/fonts/local.d.ts +5 -5
  472. package/dist/fonts/local.d.ts.map +1 -1
  473. package/dist/fonts/paths.d.ts +43 -0
  474. package/dist/fonts/paths.d.ts.map +1 -0
  475. package/dist/fonts/pipeline.d.ts +177 -0
  476. package/dist/fonts/pipeline.d.ts.map +1 -0
  477. package/dist/fonts/transform.d.ts +82 -0
  478. package/dist/fonts/transform.d.ts.map +1 -0
  479. package/dist/fonts/types.d.ts +47 -1
  480. package/dist/fonts/types.d.ts.map +1 -1
  481. package/dist/fonts/virtual-modules.d.ts +77 -0
  482. package/dist/fonts/virtual-modules.d.ts.map +1 -0
  483. package/dist/index.d.ts +35 -181
  484. package/dist/index.d.ts.map +1 -1
  485. package/dist/index.js +9949 -14264
  486. package/dist/index.js.map +1 -1
  487. package/dist/params/codec-registry.d.ts +26 -0
  488. package/dist/params/codec-registry.d.ts.map +1 -0
  489. package/dist/params/define-schema.d.ts +81 -0
  490. package/dist/params/define-schema.d.ts.map +1 -0
  491. package/dist/params/index.d.ts +5 -0
  492. package/dist/params/index.d.ts.map +1 -0
  493. package/dist/params/index.js +33 -0
  494. package/dist/params/index.js.map +1 -0
  495. package/dist/params/resolve-schema.d.ts +34 -0
  496. package/dist/params/resolve-schema.d.ts.map +1 -0
  497. package/dist/plugin-context.d.ts +269 -0
  498. package/dist/plugin-context.d.ts.map +1 -0
  499. package/dist/plugins/build-manifest.d.ts +7 -3
  500. package/dist/plugins/build-manifest.d.ts.map +1 -1
  501. package/dist/plugins/build-report.d.ts +61 -11
  502. package/dist/plugins/build-report.d.ts.map +1 -1
  503. package/dist/plugins/cache.d.ts +64 -0
  504. package/dist/plugins/cache.d.ts.map +1 -0
  505. package/dist/plugins/callsite-ast.d.ts +117 -0
  506. package/dist/plugins/callsite-ast.d.ts.map +1 -0
  507. package/dist/plugins/callsite-jsx.d.ts +35 -0
  508. package/dist/plugins/callsite-jsx.d.ts.map +1 -0
  509. package/dist/plugins/chunks.d.ts +11 -4
  510. package/dist/plugins/chunks.d.ts.map +1 -1
  511. package/dist/plugins/client-chunks.d.ts +40 -0
  512. package/dist/plugins/client-chunks.d.ts.map +1 -0
  513. package/dist/plugins/client-dep-entries.d.ts +80 -0
  514. package/dist/plugins/client-dep-entries.d.ts.map +1 -0
  515. package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
  516. package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
  517. package/dist/plugins/cloudflare-wasm.d.ts +21 -0
  518. package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
  519. package/dist/plugins/content.d.ts +1 -1
  520. package/dist/plugins/content.d.ts.map +1 -1
  521. package/dist/plugins/dev-await.d.ts +81 -0
  522. package/dist/plugins/dev-await.d.ts.map +1 -0
  523. package/dist/plugins/dev-discovery.d.ts +187 -0
  524. package/dist/plugins/dev-discovery.d.ts.map +1 -0
  525. package/dist/plugins/dev-hostname.d.ts +152 -0
  526. package/dist/plugins/dev-hostname.d.ts.map +1 -0
  527. package/dist/plugins/dev-server.d.ts +29 -2
  528. package/dist/plugins/dev-server.d.ts.map +1 -1
  529. package/dist/plugins/dev-store-clear.d.ts +83 -0
  530. package/dist/plugins/dev-store-clear.d.ts.map +1 -0
  531. package/dist/plugins/encryption-runtime.d.ts +13 -0
  532. package/dist/plugins/encryption-runtime.d.ts.map +1 -0
  533. package/dist/plugins/entries.d.ts +40 -4
  534. package/dist/plugins/entries.d.ts.map +1 -1
  535. package/dist/plugins/fonts.d.ts +35 -74
  536. package/dist/plugins/fonts.d.ts.map +1 -1
  537. package/dist/plugins/graph-endpoint.d.ts +114 -0
  538. package/dist/plugins/graph-endpoint.d.ts.map +1 -0
  539. package/dist/plugins/mdx.d.ts +18 -5
  540. package/dist/plugins/mdx.d.ts.map +1 -1
  541. package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
  542. package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
  543. package/dist/plugins/optimize-package-imports.d.ts +124 -0
  544. package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
  545. package/dist/plugins/orphaned-modules.d.ts +57 -0
  546. package/dist/plugins/orphaned-modules.d.ts.map +1 -0
  547. package/dist/plugins/post-build.d.ts +110 -0
  548. package/dist/plugins/post-build.d.ts.map +1 -0
  549. package/dist/plugins/prebuilt-capture.d.ts +67 -0
  550. package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
  551. package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
  552. package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
  553. package/dist/plugins/prebuilt.d.ts +98 -0
  554. package/dist/plugins/prebuilt.d.ts.map +1 -0
  555. package/dist/plugins/prerender-sugar.d.ts +39 -0
  556. package/dist/plugins/prerender-sugar.d.ts.map +1 -0
  557. package/dist/plugins/react-resolve.d.ts +49 -0
  558. package/dist/plugins/react-resolve.d.ts.map +1 -0
  559. package/dist/plugins/request-dep/analysis.d.ts +106 -0
  560. package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
  561. package/dist/plugins/request-dep/index.d.ts +75 -0
  562. package/dist/plugins/request-dep/index.d.ts.map +1 -0
  563. package/dist/plugins/request-dep/origin.d.ts +61 -0
  564. package/dist/plugins/request-dep/origin.d.ts.map +1 -0
  565. package/dist/plugins/routing.d.ts +2 -2
  566. package/dist/plugins/routing.d.ts.map +1 -1
  567. package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
  568. package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
  569. package/dist/plugins/server-bundle.d.ts +1 -1
  570. package/dist/plugins/server-bundle.d.ts.map +1 -1
  571. package/dist/plugins/shims.d.ts +29 -5
  572. package/dist/plugins/shims.d.ts.map +1 -1
  573. package/dist/plugins/static-build.d.ts +246 -26
  574. package/dist/plugins/static-build.d.ts.map +1 -1
  575. package/dist/routing/codegen-shared.d.ts +26 -0
  576. package/dist/routing/codegen-shared.d.ts.map +1 -0
  577. package/dist/routing/codegen-types.d.ts +61 -0
  578. package/dist/routing/codegen-types.d.ts.map +1 -0
  579. package/dist/routing/codegen-write.d.ts +42 -0
  580. package/dist/routing/codegen-write.d.ts.map +1 -0
  581. package/dist/routing/codegen.d.ts +8 -3
  582. package/dist/routing/codegen.d.ts.map +1 -1
  583. package/dist/routing/collision-probe.d.ts +104 -0
  584. package/dist/routing/collision-probe.d.ts.map +1 -0
  585. package/dist/routing/collision-spaces.d.ts +26 -0
  586. package/dist/routing/collision-spaces.d.ts.map +1 -0
  587. package/dist/routing/convention-lint.d.ts +55 -0
  588. package/dist/routing/convention-lint.d.ts.map +1 -0
  589. package/dist/routing/export-detect.d.ts +91 -0
  590. package/dist/routing/export-detect.d.ts.map +1 -0
  591. package/dist/routing/file-cache.d.ts +8 -0
  592. package/dist/routing/file-cache.d.ts.map +1 -0
  593. package/dist/routing/index.d.ts +13 -7
  594. package/dist/routing/index.d.ts.map +1 -1
  595. package/dist/routing/index.js +5 -2
  596. package/dist/routing/interception-overlap.d.ts +35 -0
  597. package/dist/routing/interception-overlap.d.ts.map +1 -0
  598. package/dist/routing/interception.d.ts +234 -10
  599. package/dist/routing/interception.d.ts.map +1 -1
  600. package/dist/routing/link-codegen.d.ts +105 -0
  601. package/dist/routing/link-codegen.d.ts.map +1 -0
  602. package/dist/routing/manifest-codegen.d.ts +26 -0
  603. package/dist/routing/manifest-codegen.d.ts.map +1 -0
  604. package/dist/routing/scanner.d.ts +14 -10
  605. package/dist/routing/scanner.d.ts.map +1 -1
  606. package/dist/routing/schema-validation.d.ts +35 -0
  607. package/dist/routing/schema-validation.d.ts.map +1 -0
  608. package/dist/routing/segment-classify.d.ts +114 -0
  609. package/dist/routing/segment-classify.d.ts.map +1 -0
  610. package/dist/routing/segment-codegen.d.ts +38 -0
  611. package/dist/routing/segment-codegen.d.ts.map +1 -0
  612. package/dist/routing/segment-keys.d.ts +118 -0
  613. package/dist/routing/segment-keys.d.ts.map +1 -0
  614. package/dist/routing/slot-placement.d.ts +48 -0
  615. package/dist/routing/slot-placement.d.ts.map +1 -0
  616. package/dist/routing/types.d.ts +81 -26
  617. package/dist/routing/types.d.ts.map +1 -1
  618. package/dist/routing/walkers.d.ts +57 -0
  619. package/dist/routing/walkers.d.ts.map +1 -0
  620. package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
  621. package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
  622. package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
  623. package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
  624. package/dist/rsc-runtime/render-flight.d.ts +14 -0
  625. package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
  626. package/dist/rsc-runtime/rsc.d.ts +3 -13
  627. package/dist/rsc-runtime/rsc.d.ts.map +1 -1
  628. package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
  629. package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
  630. package/dist/rsc-runtime/server-references.d.ts +19 -0
  631. package/dist/rsc-runtime/server-references.d.ts.map +1 -0
  632. package/dist/rsc-runtime/ssr.d.ts +7 -10
  633. package/dist/rsc-runtime/ssr.d.ts.map +1 -1
  634. package/dist/rsc-runtime/transforms.d.ts +13 -0
  635. package/dist/rsc-runtime/transforms.d.ts.map +1 -0
  636. package/dist/schema-bridge.d.ts +154 -0
  637. package/dist/schema-bridge.d.ts.map +1 -0
  638. package/dist/search-params/define.d.ts +262 -0
  639. package/dist/search-params/define.d.ts.map +1 -0
  640. package/dist/search-params/index.d.ts +3 -7
  641. package/dist/search-params/index.d.ts.map +1 -1
  642. package/dist/search-params/index.js +178 -362
  643. package/dist/search-params/index.js.map +1 -1
  644. package/dist/search-params/parse-total.d.ts +81 -0
  645. package/dist/search-params/parse-total.d.ts.map +1 -0
  646. package/dist/search-params/serialize-equal.d.ts +9 -0
  647. package/dist/search-params/serialize-equal.d.ts.map +1 -0
  648. package/dist/search-params/wrappers.d.ts +76 -0
  649. package/dist/search-params/wrappers.d.ts.map +1 -0
  650. package/dist/server/abort-scope.d.ts +27 -0
  651. package/dist/server/abort-scope.d.ts.map +1 -0
  652. package/dist/server/access-gate.d.ts +110 -10
  653. package/dist/server/access-gate.d.ts.map +1 -1
  654. package/dist/server/action-client.d.ts +20 -133
  655. package/dist/server/action-client.d.ts.map +1 -1
  656. package/dist/server/action-encryption.d.ts +76 -0
  657. package/dist/server/action-encryption.d.ts.map +1 -0
  658. package/dist/server/action-handler.d.ts +60 -11
  659. package/dist/server/action-handler.d.ts.map +1 -1
  660. package/dist/server/action-schema.d.ts +126 -0
  661. package/dist/server/action-schema.d.ts.map +1 -0
  662. package/dist/server/action-types.d.ts +108 -0
  663. package/dist/server/action-types.d.ts.map +1 -0
  664. package/dist/server/actions.d.ts +78 -40
  665. package/dist/server/actions.d.ts.map +1 -1
  666. package/dist/server/als-registry.d.ts +189 -17
  667. package/dist/server/als-registry.d.ts.map +1 -1
  668. package/dist/server/body-limits.d.ts.map +1 -1
  669. package/dist/server/build-manifest.d.ts +25 -30
  670. package/dist/server/build-manifest.d.ts.map +1 -1
  671. package/dist/server/canonicalize.d.ts +53 -0
  672. package/dist/server/canonicalize.d.ts.map +1 -1
  673. package/dist/server/chain-url-parts.d.ts +82 -0
  674. package/dist/server/chain-url-parts.d.ts.map +1 -0
  675. package/dist/server/children-interception.d.ts +49 -0
  676. package/dist/server/children-interception.d.ts.map +1 -0
  677. package/dist/server/client-error-message.d.ts +12 -0
  678. package/dist/server/client-error-message.d.ts.map +1 -0
  679. package/dist/server/coalesce-tick.d.ts +40 -0
  680. package/dist/server/coalesce-tick.d.ts.map +1 -0
  681. package/dist/server/compress.d.ts +2 -0
  682. package/dist/server/compress.d.ts.map +1 -1
  683. package/dist/server/cookie-context.d.ts +156 -0
  684. package/dist/server/cookie-context.d.ts.map +1 -0
  685. package/dist/server/cookie-parsing.d.ts +65 -0
  686. package/dist/server/cookie-parsing.d.ts.map +1 -0
  687. package/dist/server/csp-nonce.d.ts +36 -0
  688. package/dist/server/csp-nonce.d.ts.map +1 -0
  689. package/dist/server/csrf.d.ts +58 -15
  690. package/dist/server/csrf.d.ts.map +1 -1
  691. package/dist/server/debug.d.ts +0 -1
  692. package/dist/server/debug.d.ts.map +1 -1
  693. package/dist/server/default-logger.d.ts +23 -0
  694. package/dist/server/default-logger.d.ts.map +1 -0
  695. package/dist/server/default-status-page.d.ts +45 -0
  696. package/dist/server/default-status-page.d.ts.map +1 -0
  697. package/dist/server/deny-boundary.d.ts +257 -0
  698. package/dist/server/deny-boundary.d.ts.map +1 -0
  699. package/dist/server/deny-renderer.d.ts +22 -15
  700. package/dist/server/deny-renderer.d.ts.map +1 -1
  701. package/dist/server/early-hints-sender.d.ts.map +1 -1
  702. package/dist/server/early-hints.d.ts +14 -12
  703. package/dist/server/early-hints.d.ts.map +1 -1
  704. package/dist/server/error-boundary-wrapper.d.ts +102 -10
  705. package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
  706. package/dist/server/error-response-headers.d.ts +3 -0
  707. package/dist/server/error-response-headers.d.ts.map +1 -0
  708. package/dist/server/fallback-error.d.ts +19 -7
  709. package/dist/server/fallback-error.d.ts.map +1 -1
  710. package/dist/server/flight-injection-state.d.ts +66 -0
  711. package/dist/server/flight-injection-state.d.ts.map +1 -0
  712. package/dist/server/flight-injector-core.d.ts +125 -0
  713. package/dist/server/flight-injector-core.d.ts.map +1 -0
  714. package/dist/server/flight-scripts.d.ts +63 -0
  715. package/dist/server/flight-scripts.d.ts.map +1 -0
  716. package/dist/server/flight-source-node.d.ts +105 -0
  717. package/dist/server/flight-source-node.d.ts.map +1 -0
  718. package/dist/server/flight-source.d.ts +136 -0
  719. package/dist/server/flight-source.d.ts.map +1 -0
  720. package/dist/server/form-data.d.ts +59 -2
  721. package/dist/server/form-data.d.ts.map +1 -1
  722. package/dist/server/form-state-flight.d.ts +32 -0
  723. package/dist/server/form-state-flight.d.ts.map +1 -0
  724. package/dist/server/head-response.d.ts +35 -0
  725. package/dist/server/head-response.d.ts.map +1 -0
  726. package/dist/server/html-injector-core.d.ts +169 -0
  727. package/dist/server/html-injector-core.d.ts.map +1 -0
  728. package/dist/server/html-injectors.d.ts +77 -47
  729. package/dist/server/html-injectors.d.ts.map +1 -1
  730. package/dist/server/index.d.ts +16 -54
  731. package/dist/server/index.d.ts.map +1 -1
  732. package/dist/server/index.js +621 -3009
  733. package/dist/server/index.js.map +1 -1
  734. package/dist/server/instrumentation.d.ts +13 -5
  735. package/dist/server/instrumentation.d.ts.map +1 -1
  736. package/dist/server/interception-gates.d.ts +49 -0
  737. package/dist/server/interception-gates.d.ts.map +1 -0
  738. package/dist/server/internal.d.ts +48 -0
  739. package/dist/server/internal.d.ts.map +1 -0
  740. package/dist/server/internal.js +5094 -0
  741. package/dist/server/internal.js.map +1 -0
  742. package/dist/server/json-status-response.d.ts +34 -0
  743. package/dist/server/json-status-response.d.ts.map +1 -0
  744. package/dist/server/logger.d.ts +105 -7
  745. package/dist/server/logger.d.ts.map +1 -1
  746. package/dist/server/metadata-collector.d.ts +75 -0
  747. package/dist/server/metadata-collector.d.ts.map +1 -0
  748. package/dist/server/metadata-platform.d.ts +2 -2
  749. package/dist/server/metadata-render.d.ts +2 -2
  750. package/dist/server/metadata-render.d.ts.map +1 -1
  751. package/dist/server/metadata-route-links.d.ts +70 -0
  752. package/dist/server/metadata-route-links.d.ts.map +1 -0
  753. package/dist/server/metadata-routes.d.ts +47 -11
  754. package/dist/server/metadata-routes.d.ts.map +1 -1
  755. package/dist/server/metadata-social.d.ts +2 -2
  756. package/dist/server/metadata.d.ts +10 -2
  757. package/dist/server/metadata.d.ts.map +1 -1
  758. package/dist/server/middleware-runner.d.ts +20 -5
  759. package/dist/server/middleware-runner.d.ts.map +1 -1
  760. package/dist/server/node-body-response.d.ts +55 -0
  761. package/dist/server/node-body-response.d.ts.map +1 -0
  762. package/dist/server/node-response.d.ts +62 -0
  763. package/dist/server/node-response.d.ts.map +1 -0
  764. package/dist/server/node-stream-transforms.d.ts +108 -0
  765. package/dist/server/node-stream-transforms.d.ts.map +1 -0
  766. package/dist/server/node-streams-platform.d.ts +21 -0
  767. package/dist/server/node-streams-platform.d.ts.map +1 -0
  768. package/dist/server/param-coercion.d.ts +91 -0
  769. package/dist/server/param-coercion.d.ts.map +1 -0
  770. package/dist/server/pipeline-helpers.d.ts +227 -0
  771. package/dist/server/pipeline-helpers.d.ts.map +1 -0
  772. package/dist/server/pipeline-interception.d.ts +100 -9
  773. package/dist/server/pipeline-interception.d.ts.map +1 -1
  774. package/dist/server/pipeline-metadata-route.d.ts +24 -0
  775. package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
  776. package/dist/server/pipeline-metadata.d.ts +18 -2
  777. package/dist/server/pipeline-metadata.d.ts.map +1 -1
  778. package/dist/server/pipeline-outcome.d.ts +59 -0
  779. package/dist/server/pipeline-outcome.d.ts.map +1 -0
  780. package/dist/server/pipeline-phases.d.ts +76 -0
  781. package/dist/server/pipeline-phases.d.ts.map +1 -0
  782. package/dist/server/pipeline.d.ts +190 -23
  783. package/dist/server/pipeline.d.ts.map +1 -1
  784. package/dist/server/port-resolution.d.ts +22 -0
  785. package/dist/server/port-resolution.d.ts.map +1 -0
  786. package/dist/server/prebuilt/cache-key.d.ts +89 -0
  787. package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
  788. package/dist/server/prebuilt/capture-render.d.ts +30 -0
  789. package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
  790. package/dist/server/prebuilt/capture-routes.d.ts +37 -0
  791. package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
  792. package/dist/server/prebuilt/capture-state.d.ts +101 -0
  793. package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
  794. package/dist/server/prebuilt/dev-store.d.ts +149 -0
  795. package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
  796. package/dist/server/prebuilt/lifetime.d.ts +38 -0
  797. package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
  798. package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
  799. package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
  800. package/dist/server/prebuilt/overlay.d.ts +119 -0
  801. package/dist/server/prebuilt/overlay.d.ts.map +1 -0
  802. package/dist/server/prebuilt/payload-source.d.ts +87 -0
  803. package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
  804. package/dist/server/prebuilt/slots.d.ts +105 -0
  805. package/dist/server/prebuilt/slots.d.ts.map +1 -0
  806. package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
  807. package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
  808. package/dist/server/prebuilt-builder.d.ts +121 -0
  809. package/dist/server/prebuilt-builder.d.ts.map +1 -0
  810. package/dist/server/prebuilt-runtime.d.ts +105 -0
  811. package/dist/server/prebuilt-runtime.d.ts.map +1 -0
  812. package/dist/server/primitives.d.ts +114 -90
  813. package/dist/server/primitives.d.ts.map +1 -1
  814. package/dist/server/publish-params.d.ts +33 -0
  815. package/dist/server/publish-params.d.ts.map +1 -0
  816. package/dist/server/react-cache-bridge.d.ts +59 -0
  817. package/dist/server/react-cache-bridge.d.ts.map +1 -0
  818. package/dist/server/react-cache-scope.d.ts +49 -0
  819. package/dist/server/react-cache-scope.d.ts.map +1 -0
  820. package/dist/server/render-timeout.d.ts +66 -0
  821. package/dist/server/render-timeout.d.ts.map +1 -0
  822. package/dist/server/render-utils.d.ts +56 -0
  823. package/dist/server/render-utils.d.ts.map +1 -0
  824. package/dist/server/request-context.d.ts +167 -103
  825. package/dist/server/request-context.d.ts.map +1 -1
  826. package/dist/server/request-dep.d.ts +15 -0
  827. package/dist/server/request-dep.d.ts.map +1 -0
  828. package/dist/server/response-cache-policy.d.ts +3 -0
  829. package/dist/server/response-cache-policy.d.ts.map +1 -0
  830. package/dist/server/response-framing.d.ts +43 -0
  831. package/dist/server/response-framing.d.ts.map +1 -0
  832. package/dist/server/route-element-builder.d.ts +57 -30
  833. package/dist/server/route-element-builder.d.ts.map +1 -1
  834. package/dist/server/route-element-helpers.d.ts +12 -0
  835. package/dist/server/route-element-helpers.d.ts.map +1 -0
  836. package/dist/server/route-handler.d.ts +9 -3
  837. package/dist/server/route-handler.d.ts.map +1 -1
  838. package/dist/server/route-matcher.d.ts +75 -40
  839. package/dist/server/route-matcher.d.ts.map +1 -1
  840. package/dist/server/route-methods.d.ts +23 -0
  841. package/dist/server/route-methods.d.ts.map +1 -0
  842. package/dist/server/route-module-loader.d.ts +37 -0
  843. package/dist/server/route-module-loader.d.ts.map +1 -0
  844. package/dist/server/rsc-cache-key-guard.d.ts +78 -0
  845. package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
  846. package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
  847. package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
  848. package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
  849. package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
  850. package/dist/server/rsc-entry/api-handler.d.ts +19 -3
  851. package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
  852. package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
  853. package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
  854. package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
  855. package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
  856. package/dist/server/rsc-entry/helpers.d.ts +14 -59
  857. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  858. package/dist/server/rsc-entry/index.d.ts +30 -6
  859. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  860. package/dist/server/rsc-entry/render-route.d.ts +55 -0
  861. package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
  862. package/dist/server/rsc-entry/render-signals.d.ts +65 -0
  863. package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
  864. package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
  865. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
  866. package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
  867. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  868. package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
  869. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  870. package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
  871. package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
  872. package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
  873. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  874. package/dist/server/rsc-error-envelope.d.ts +11 -0
  875. package/dist/server/rsc-error-envelope.d.ts.map +1 -0
  876. package/dist/server/safe-load.d.ts +39 -0
  877. package/dist/server/safe-load.d.ts.map +1 -0
  878. package/dist/server/schema-introspection.d.ts +68 -0
  879. package/dist/server/schema-introspection.d.ts.map +1 -0
  880. package/dist/server/sensitive-fields.d.ts +88 -0
  881. package/dist/server/sensitive-fields.d.ts.map +1 -0
  882. package/dist/server/signal-identity.d.ts +49 -0
  883. package/dist/server/signal-identity.d.ts.map +1 -0
  884. package/dist/server/sitemap-generator.d.ts +130 -0
  885. package/dist/server/sitemap-generator.d.ts.map +1 -0
  886. package/dist/server/sitemap-handler.d.ts +22 -0
  887. package/dist/server/sitemap-handler.d.ts.map +1 -0
  888. package/dist/server/skippable-prefix.d.ts +29 -0
  889. package/dist/server/skippable-prefix.d.ts.map +1 -0
  890. package/dist/server/slot-interception.d.ts +80 -0
  891. package/dist/server/slot-interception.d.ts.map +1 -0
  892. package/dist/server/slot-resolver.d.ts +138 -7
  893. package/dist/server/slot-resolver.d.ts.map +1 -1
  894. package/dist/server/slot-subtree-contain.d.ts +54 -0
  895. package/dist/server/slot-subtree-contain.d.ts.map +1 -0
  896. package/dist/server/ssr-bridge-types.d.ts +213 -0
  897. package/dist/server/ssr-bridge-types.d.ts.map +1 -0
  898. package/dist/server/ssr-entry.d.ts +15 -51
  899. package/dist/server/ssr-entry.d.ts.map +1 -1
  900. package/dist/server/ssr-form-state.d.ts +30 -0
  901. package/dist/server/ssr-form-state.d.ts.map +1 -0
  902. package/dist/server/ssr-render.d.ts +42 -12
  903. package/dist/server/ssr-render.d.ts.map +1 -1
  904. package/dist/server/ssr-wrappers.d.ts +92 -0
  905. package/dist/server/ssr-wrappers.d.ts.map +1 -0
  906. package/dist/server/state-tree-diff.d.ts +44 -9
  907. package/dist/server/state-tree-diff.d.ts.map +1 -1
  908. package/dist/server/static-generator.d.ts +112 -0
  909. package/dist/server/static-generator.d.ts.map +1 -0
  910. package/dist/server/static-not-found.d.ts +52 -0
  911. package/dist/server/static-not-found.d.ts.map +1 -0
  912. package/dist/server/status-code-resolver.d.ts +26 -15
  913. package/dist/server/status-code-resolver.d.ts.map +1 -1
  914. package/dist/server/stream-utils.d.ts +93 -0
  915. package/dist/server/stream-utils.d.ts.map +1 -0
  916. package/dist/server/traced-access.d.ts +18 -0
  917. package/dist/server/traced-access.d.ts.map +1 -0
  918. package/dist/server/tracing.d.ts +72 -31
  919. package/dist/server/tracing.d.ts.map +1 -1
  920. package/dist/server/tree-match.d.ts +59 -0
  921. package/dist/server/tree-match.d.ts.map +1 -0
  922. package/dist/server/types.d.ts +90 -8
  923. package/dist/server/types.d.ts.map +1 -1
  924. package/dist/server/utils/element-type.d.ts +50 -0
  925. package/dist/server/utils/element-type.d.ts.map +1 -0
  926. package/dist/server/utils/escape-html.d.ts +14 -0
  927. package/dist/server/utils/escape-html.d.ts.map +1 -0
  928. package/dist/server/version-skew.d.ts +61 -0
  929. package/dist/server/version-skew.d.ts.map +1 -0
  930. package/dist/server/workers-cache-bridge.d.ts +26 -0
  931. package/dist/server/workers-cache-bridge.d.ts.map +1 -0
  932. package/dist/shared/als-slots.d.ts +42 -0
  933. package/dist/shared/als-slots.d.ts.map +1 -0
  934. package/dist/shared/base-path.d.ts +56 -0
  935. package/dist/shared/base-path.d.ts.map +1 -0
  936. package/dist/shared/csrf-reject.d.ts +16 -0
  937. package/dist/shared/csrf-reject.d.ts.map +1 -0
  938. package/dist/shared/dev-span.d.ts +99 -0
  939. package/dist/shared/dev-span.d.ts.map +1 -0
  940. package/dist/shared/error-digest.d.ts +28 -0
  941. package/dist/shared/error-digest.d.ts.map +1 -0
  942. package/dist/shared/flight-base64.d.ts +13 -0
  943. package/dist/shared/flight-base64.d.ts.map +1 -0
  944. package/dist/shared/flight-segment.d.ts +18 -0
  945. package/dist/shared/flight-segment.d.ts.map +1 -0
  946. package/dist/shared/form-state-flight.d.ts +32 -0
  947. package/dist/shared/form-state-flight.d.ts.map +1 -0
  948. package/dist/shared/href-validation.d.ts +49 -0
  949. package/dist/shared/href-validation.d.ts.map +1 -0
  950. package/dist/shared/merge-search-params.d.ts +22 -0
  951. package/dist/shared/merge-search-params.d.ts.map +1 -0
  952. package/dist/shared/param-value.d.ts +104 -0
  953. package/dist/shared/param-value.d.ts.map +1 -0
  954. package/dist/shared/payload-root.d.ts +110 -0
  955. package/dist/shared/payload-root.d.ts.map +1 -0
  956. package/dist/shared/redirect-type.d.ts +17 -0
  957. package/dist/shared/redirect-type.d.ts.map +1 -0
  958. package/dist/shared/rsc-cache-key.d.ts +163 -0
  959. package/dist/shared/rsc-cache-key.d.ts.map +1 -0
  960. package/dist/shared/rsc-error-envelope.d.ts +16 -0
  961. package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
  962. package/dist/shared/rsc-manifest.d.ts +28 -0
  963. package/dist/shared/rsc-manifest.d.ts.map +1 -0
  964. package/dist/shared/rsc-media-type.d.ts +52 -0
  965. package/dist/shared/rsc-media-type.d.ts.map +1 -0
  966. package/dist/shared/rsc-payload-path.d.ts +48 -0
  967. package/dist/shared/rsc-payload-path.d.ts.map +1 -0
  968. package/dist/shared/segment-info.d.ts +66 -0
  969. package/dist/shared/segment-info.d.ts.map +1 -0
  970. package/dist/shared/slot-params.d.ts +52 -0
  971. package/dist/shared/slot-params.d.ts.map +1 -0
  972. package/dist/shared/static-platform-files.d.ts +71 -0
  973. package/dist/shared/static-platform-files.d.ts.map +1 -0
  974. package/dist/shared/status-reason-phrase.d.ts +26 -0
  975. package/dist/shared/status-reason-phrase.d.ts.map +1 -0
  976. package/dist/shims/font-google.d.ts +1 -1
  977. package/dist/shims/font-google.d.ts.map +1 -1
  978. package/dist/shims/font-google.js +41 -0
  979. package/dist/shims/font-google.js.map +1 -0
  980. package/dist/shims/font-local.d.ts +26 -0
  981. package/dist/shims/font-local.d.ts.map +1 -0
  982. package/dist/shims/font-local.js +19 -0
  983. package/dist/shims/font-local.js.map +1 -0
  984. package/dist/shims/headers.d.ts +60 -1
  985. package/dist/shims/headers.d.ts.map +1 -1
  986. package/dist/shims/image.d.ts +120 -120
  987. package/dist/shims/image.d.ts.map +1 -1
  988. package/dist/shims/navigation-client.d.ts +25 -12
  989. package/dist/shims/navigation-client.d.ts.map +1 -1
  990. package/dist/shims/navigation-rsc.d.ts +21 -0
  991. package/dist/shims/navigation-rsc.d.ts.map +1 -0
  992. package/dist/shims/navigation.d.ts +10 -5
  993. package/dist/shims/navigation.d.ts.map +1 -1
  994. package/dist/utils/state-machine.d.ts +80 -0
  995. package/dist/utils/state-machine.d.ts.map +1 -0
  996. package/dist/utils/write-file-atomic.d.ts +17 -0
  997. package/dist/utils/write-file-atomic.d.ts.map +1 -0
  998. package/docs/api/30-api-server.mdx +241 -0
  999. package/docs/api/31-api-client.mdx +225 -0
  1000. package/docs/api/32-api-cache.mdx +341 -0
  1001. package/docs/api/33-api-search-params.mdx +178 -0
  1002. package/docs/api/34-api-config.mdx +421 -0
  1003. package/docs/api/35-api-typescript.mdx +91 -0
  1004. package/docs/api/36-cli.mdx +272 -0
  1005. package/docs/learn/00-introduction.mdx +109 -0
  1006. package/docs/learn/01-quick-start.mdx +94 -0
  1007. package/docs/learn/02-pages-and-layouts.mdx +147 -0
  1008. package/docs/learn/03-fetching-data.mdx +227 -0
  1009. package/docs/learn/04-access-control.mdx +115 -0
  1010. package/docs/learn/05-the-flush-point.mdx +175 -0
  1011. package/docs/learn/06-typed-params.mdx +275 -0
  1012. package/docs/learn/07-typed-routes.mdx +108 -0
  1013. package/docs/learn/08-forms-and-actions.mdx +260 -0
  1014. package/docs/learn/09-streaming.mdx +146 -0
  1015. package/docs/learn/10-caching.mdx +303 -0
  1016. package/docs/learn/11-middleware.mdx +166 -0
  1017. package/docs/learn/12-error-handling.mdx +192 -0
  1018. package/docs/learn/13-deploying.mdx +289 -0
  1019. package/llms.txt +55 -0
  1020. package/package.json +120 -29
  1021. package/src/adapters/build-output-helper.ts +375 -0
  1022. package/src/adapters/canonicalize-module.ts +29 -0
  1023. package/src/adapters/cloudflare-dev.ts +183 -0
  1024. package/src/adapters/cloudflare-kv-cache.ts +203 -0
  1025. package/src/adapters/cloudflare.ts +799 -151
  1026. package/src/adapters/compress-module.ts +110 -86
  1027. package/src/adapters/fs-identity.ts +155 -0
  1028. package/src/adapters/nitro-immutable-assets.ts +142 -0
  1029. package/src/adapters/nitro-presets.ts +139 -0
  1030. package/src/adapters/nitro-preview.ts +565 -0
  1031. package/src/adapters/nitro.ts +349 -448
  1032. package/src/adapters/raw-imports.d.ts +5 -0
  1033. package/src/adapters/shared.ts +314 -0
  1034. package/src/adapters/types.ts +129 -17
  1035. package/src/adapters/wrangler.d.ts +7 -0
  1036. package/src/analyze/chains.ts +411 -0
  1037. package/src/analyze/classify.ts +259 -0
  1038. package/src/analyze/crawl-entry.ts +68 -0
  1039. package/src/analyze/crawl.ts +500 -0
  1040. package/src/analyze/graph-cache.ts +331 -0
  1041. package/src/analyze/graph-command.ts +654 -0
  1042. package/src/analyze/live-graph.ts +232 -0
  1043. package/src/analyze/poison-rules.ts +165 -0
  1044. package/src/analyze/poison-scan.ts +159 -0
  1045. package/src/analyze/scan.ts +149 -0
  1046. package/src/cache/cache-api.ts +113 -0
  1047. package/src/cache/fast-hash.ts +5 -0
  1048. package/src/cache/guarded-read.ts +44 -0
  1049. package/src/cache/handler-store.ts +113 -0
  1050. package/src/cache/index.ts +93 -20
  1051. package/src/cache/invalidation-epoch.ts +105 -0
  1052. package/src/cache/json-lossy-check.ts +69 -0
  1053. package/src/cache/key-discipline.ts +218 -0
  1054. package/src/cache/redis-handler.ts +193 -19
  1055. package/src/cache/singleflight.ts +85 -7
  1056. package/src/cache/sizeof.ts +35 -0
  1057. package/src/cache/stable-stringify.ts +118 -2
  1058. package/src/cache/store.ts +71 -0
  1059. package/src/cache/stores/cloudflare-kv.ts +52 -0
  1060. package/src/cache/stores/memory.ts +125 -0
  1061. package/src/cache/stores/redis.ts +97 -0
  1062. package/src/cache/stores/vercel.ts +59 -0
  1063. package/src/cache/tag-aware-handler.ts +250 -0
  1064. package/src/cache/timber-cache.ts +218 -47
  1065. package/src/cdn/cloudflare-purge.ts +50 -0
  1066. package/src/cdn/fastly-purge.ts +63 -0
  1067. package/src/cdn/headers.ts +153 -0
  1068. package/src/cdn/index.ts +23 -0
  1069. package/src/cdn/purge-store.ts +62 -0
  1070. package/src/cdn/workers-cache-purge.ts +34 -0
  1071. package/src/cli-check.ts +417 -0
  1072. package/src/cli-context.ts +128 -0
  1073. package/src/cli-dev-status.ts +196 -0
  1074. package/src/cli-init.ts +278 -0
  1075. package/src/cli-schema-sync.ts +401 -0
  1076. package/src/cli.ts +308 -84
  1077. package/src/client/browser-dev.ts +192 -5
  1078. package/src/client/browser-entry/action-dispatch.ts +317 -0
  1079. package/src/client/browser-entry/action-queue.ts +152 -0
  1080. package/src/client/browser-entry/form-state.ts +49 -0
  1081. package/src/client/browser-entry/hmr.ts +82 -0
  1082. package/src/client/browser-entry/hydrate.ts +152 -0
  1083. package/src/client/browser-entry/index.ts +153 -0
  1084. package/src/client/browser-entry/post-hydration.ts +99 -0
  1085. package/src/client/browser-entry/router-init.ts +391 -0
  1086. package/src/client/browser-entry/rsc-stream.ts +145 -0
  1087. package/src/client/browser-entry/scroll.ts +50 -0
  1088. package/src/client/deny-last-resort.tsx +54 -0
  1089. package/src/client/dev-pill/index.ts +128 -0
  1090. package/src/client/dev-pill/store.ts +254 -0
  1091. package/src/client/dev-pill/view.ts +326 -0
  1092. package/src/client/error-boundary.tsx +296 -61
  1093. package/src/client/error-reconstituter.tsx +84 -0
  1094. package/src/client/form.tsx +61 -173
  1095. package/src/client/global-context.ts +59 -0
  1096. package/src/client/history.ts +74 -11
  1097. package/src/client/index.ts +91 -53
  1098. package/src/client/internal.ts +54 -0
  1099. package/src/client/link.tsx +464 -151
  1100. package/src/client/location-search.ts +15 -0
  1101. package/src/client/navigation-api.ts +254 -0
  1102. package/src/client/navigation-commit.ts +318 -0
  1103. package/src/client/navigation-context.ts +71 -142
  1104. package/src/client/navigation-root.tsx +237 -0
  1105. package/src/client/navigation-transition.ts +401 -0
  1106. package/src/client/nuqs-adapter.tsx +62 -32
  1107. package/src/client/params-context.ts +175 -0
  1108. package/src/client/react-root.ts +105 -0
  1109. package/src/client/router-effects.ts +349 -0
  1110. package/src/client/router-lifecycle.ts +394 -0
  1111. package/src/client/router-pipeline.ts +443 -0
  1112. package/src/client/router-ref.ts +3 -3
  1113. package/src/client/router-skew.ts +30 -0
  1114. package/src/client/router-types.ts +326 -0
  1115. package/src/client/router-url.ts +32 -0
  1116. package/src/client/router.ts +491 -421
  1117. package/src/client/rsc-fetch.ts +510 -109
  1118. package/src/client/segment-cache.ts +362 -41
  1119. package/src/client/segment-context.ts +7 -4
  1120. package/src/client/segment-outlet.tsx +96 -0
  1121. package/src/client/segment-update-context.ts +23 -0
  1122. package/src/client/shallow-url.ts +22 -0
  1123. package/src/client/slot-content-cache-context.ts +43 -0
  1124. package/src/client/slot-context.ts +39 -0
  1125. package/src/client/slot-outlet.tsx +22 -0
  1126. package/src/client/slot-provider.tsx +32 -0
  1127. package/src/client/ssr-data.ts +27 -67
  1128. package/src/client/stale-client.ts +191 -0
  1129. package/src/client/state.ts +31 -24
  1130. package/src/client/status-page-marker.tsx +32 -0
  1131. package/src/client/top-loader.tsx +13 -10
  1132. package/src/client/unload-guard.ts +35 -3
  1133. package/src/client/use-cookie.ts +93 -29
  1134. package/src/client/use-field-state.ts +144 -0
  1135. package/src/client/use-link-status.ts +7 -7
  1136. package/src/client/use-pathname.ts +22 -31
  1137. package/src/client/use-pending-navigation.ts +119 -0
  1138. package/src/client/use-query-states.ts +206 -36
  1139. package/src/client/use-router.ts +31 -9
  1140. package/src/client/use-search-params.ts +38 -49
  1141. package/src/client/use-segment-params.ts +69 -0
  1142. package/src/client/use-selected-layout-segment.ts +2 -2
  1143. package/src/codec.ts +149 -0
  1144. package/src/config-types.ts +366 -0
  1145. package/src/config-validation.ts +511 -0
  1146. package/src/cookies/define-cookie.ts +186 -53
  1147. package/src/cookies/index.ts +13 -2
  1148. package/src/cookies/json-cookie.ts +105 -0
  1149. package/src/cookies/validation.ts +192 -0
  1150. package/src/dev-tools/404-page.ts +286 -0
  1151. package/src/dev-tools/await-span.ts +69 -0
  1152. package/src/dev-tools/browser-logs.ts +55 -0
  1153. package/src/dev-tools/dev-page-shell.ts +278 -0
  1154. package/src/dev-tools/error-page.ts +331 -0
  1155. package/src/dev-tools/holding-server.ts +185 -0
  1156. package/src/dev-tools/hydration-overlay.ts +158 -0
  1157. package/src/dev-tools/index.ts +79 -0
  1158. package/src/dev-tools/instrumentation.ts +281 -0
  1159. package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
  1160. package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
  1161. package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
  1162. package/src/dev-tools/span-sink.ts +132 -0
  1163. package/src/dev-tools/stack-classifier.ts +75 -0
  1164. package/src/dev-tools/terminal.ts +182 -0
  1165. package/src/fonts/ast-walk.ts +235 -0
  1166. package/src/fonts/ast.ts +479 -128
  1167. package/src/fonts/bundle.ts +138 -0
  1168. package/src/fonts/css.ts +1 -1
  1169. package/src/fonts/dev-middleware.ts +85 -0
  1170. package/src/fonts/fallbacks.ts +0 -23
  1171. package/src/fonts/google.ts +101 -19
  1172. package/src/fonts/local.ts +12 -11
  1173. package/src/fonts/paths.ts +58 -0
  1174. package/src/fonts/pipeline.ts +348 -0
  1175. package/src/fonts/transform.ts +311 -0
  1176. package/src/fonts/types.ts +52 -1
  1177. package/src/fonts/virtual-modules.ts +179 -0
  1178. package/src/index.ts +498 -380
  1179. package/src/params/codec-registry.ts +34 -0
  1180. package/src/params/define-schema.ts +115 -0
  1181. package/src/params/index.ts +17 -0
  1182. package/src/params/resolve-schema.ts +84 -0
  1183. package/src/plugin-context.ts +509 -0
  1184. package/src/plugins/build-manifest.ts +189 -36
  1185. package/src/plugins/build-report.ts +299 -87
  1186. package/src/plugins/cache.ts +243 -0
  1187. package/src/plugins/callsite-ast.ts +472 -0
  1188. package/src/plugins/callsite-jsx.ts +243 -0
  1189. package/src/plugins/chunks.ts +74 -5
  1190. package/src/plugins/client-chunks.ts +185 -0
  1191. package/src/plugins/client-dep-entries.ts +124 -0
  1192. package/src/plugins/client-in-server-package-deps.ts +139 -0
  1193. package/src/plugins/cloudflare-wasm.ts +141 -0
  1194. package/src/plugins/content.ts +31 -2
  1195. package/src/plugins/dev-await.ts +415 -0
  1196. package/src/plugins/dev-discovery.ts +428 -0
  1197. package/src/plugins/dev-hostname.ts +322 -0
  1198. package/src/plugins/dev-server.ts +471 -100
  1199. package/src/plugins/dev-store-clear.ts +145 -0
  1200. package/src/plugins/encryption-runtime.ts +31 -0
  1201. package/src/plugins/entries.ts +158 -17
  1202. package/src/plugins/fonts.ts +260 -657
  1203. package/src/plugins/graph-endpoint.ts +544 -0
  1204. package/src/plugins/mdx.ts +108 -35
  1205. package/src/plugins/optimize-package-imports-defaults.ts +88 -0
  1206. package/src/plugins/optimize-package-imports.ts +439 -0
  1207. package/src/plugins/orphaned-modules.ts +78 -0
  1208. package/src/plugins/post-build.ts +327 -0
  1209. package/src/plugins/prebuilt-capture.ts +213 -0
  1210. package/src/plugins/prebuilt-options-analysis.ts +175 -0
  1211. package/src/plugins/prebuilt.ts +679 -0
  1212. package/src/plugins/prerender-sugar.ts +348 -0
  1213. package/src/plugins/react-resolve.ts +149 -0
  1214. package/src/plugins/request-dep/analysis.ts +447 -0
  1215. package/src/plugins/request-dep/index.ts +376 -0
  1216. package/src/plugins/request-dep/origin.ts +310 -0
  1217. package/src/plugins/routing.ts +296 -278
  1218. package/src/plugins/rsc-assets-manifest.ts +251 -0
  1219. package/src/plugins/server-bundle.ts +115 -15
  1220. package/src/plugins/shims.ts +257 -97
  1221. package/src/plugins/static-build.ts +681 -71
  1222. package/src/react-canary.d.ts +2 -0
  1223. package/src/routing/codegen-shared.ts +39 -0
  1224. package/src/routing/codegen-types.ts +62 -0
  1225. package/src/routing/codegen-write.ts +163 -0
  1226. package/src/routing/codegen.ts +349 -232
  1227. package/src/routing/collision-probe.ts +438 -0
  1228. package/src/routing/collision-spaces.ts +281 -0
  1229. package/src/routing/convention-lint.ts +649 -0
  1230. package/src/routing/export-detect.ts +536 -0
  1231. package/src/routing/file-cache.ts +23 -0
  1232. package/src/routing/index.ts +16 -7
  1233. package/src/routing/interception-overlap.ts +141 -0
  1234. package/src/routing/interception.ts +1044 -67
  1235. package/src/routing/link-codegen.ts +280 -0
  1236. package/src/routing/manifest-codegen.ts +232 -0
  1237. package/src/routing/scanner.ts +417 -223
  1238. package/src/routing/schema-validation.ts +155 -0
  1239. package/src/routing/segment-classify.ts +280 -0
  1240. package/src/routing/segment-codegen.ts +99 -0
  1241. package/src/routing/segment-keys.ts +186 -0
  1242. package/src/routing/slot-placement.ts +97 -0
  1243. package/src/routing/types.ts +82 -26
  1244. package/src/routing/walkers.ts +98 -0
  1245. package/src/rsc-runtime/dev-reference-cache.ts +115 -0
  1246. package/src/rsc-runtime/encryption-runtime.ts +78 -0
  1247. package/src/rsc-runtime/render-flight.ts +26 -0
  1248. package/src/rsc-runtime/rsc.ts +35 -5
  1249. package/src/rsc-runtime/server-reference-load-error.ts +16 -0
  1250. package/src/rsc-runtime/server-references.ts +135 -0
  1251. package/src/rsc-runtime/ssr.ts +23 -0
  1252. package/src/rsc-runtime/transforms.ts +13 -0
  1253. package/src/rsc-runtime/vendor-types.d.ts +87 -0
  1254. package/src/schema-bridge.ts +437 -0
  1255. package/src/search-params/define.ts +676 -0
  1256. package/src/search-params/index.ts +14 -20
  1257. package/src/search-params/parse-total.ts +91 -0
  1258. package/src/search-params/serialize-equal.ts +14 -0
  1259. package/src/search-params/wrappers.ts +150 -0
  1260. package/src/server/abort-scope.ts +49 -0
  1261. package/src/server/access-gate.tsx +208 -57
  1262. package/src/server/action-client.ts +175 -294
  1263. package/src/server/action-encryption.ts +144 -0
  1264. package/src/server/action-handler.ts +533 -150
  1265. package/src/server/action-schema.ts +203 -0
  1266. package/src/server/action-types.ts +145 -0
  1267. package/src/server/actions.ts +172 -85
  1268. package/src/server/als-registry.ts +245 -30
  1269. package/src/server/body-limits.ts +10 -2
  1270. package/src/server/build-manifest.ts +33 -57
  1271. package/src/server/canonicalize.ts +62 -3
  1272. package/src/server/chain-url-parts.ts +163 -0
  1273. package/src/server/children-interception.ts +116 -0
  1274. package/src/server/client-error-message.ts +18 -0
  1275. package/src/server/coalesce-tick.ts +75 -0
  1276. package/src/server/compress.ts +91 -19
  1277. package/src/server/cookie-context.ts +462 -0
  1278. package/src/server/cookie-parsing.ts +163 -0
  1279. package/src/server/csp-nonce.ts +58 -0
  1280. package/src/server/csrf.ts +238 -37
  1281. package/src/server/debug.ts +0 -1
  1282. package/src/server/default-logger.ts +100 -0
  1283. package/src/server/default-status-page.ts +88 -0
  1284. package/src/server/deny-boundary.ts +527 -0
  1285. package/src/server/deny-renderer.ts +210 -181
  1286. package/src/server/early-hints-sender.ts +4 -3
  1287. package/src/server/early-hints.ts +39 -29
  1288. package/src/server/error-boundary-wrapper.ts +160 -44
  1289. package/src/server/error-response-headers.ts +18 -0
  1290. package/src/server/fallback-error.ts +88 -104
  1291. package/src/server/flight-injection-state.ts +113 -0
  1292. package/src/server/flight-injector-core.ts +332 -0
  1293. package/src/server/flight-scripts.ts +92 -0
  1294. package/src/server/flight-source-node.ts +434 -0
  1295. package/src/server/flight-source.ts +289 -0
  1296. package/src/server/form-data.ts +191 -20
  1297. package/src/server/form-state-flight.ts +67 -0
  1298. package/src/server/head-response.ts +50 -0
  1299. package/src/server/html-injector-core.ts +320 -0
  1300. package/src/server/html-injectors.ts +241 -285
  1301. package/src/server/index.ts +42 -195
  1302. package/src/server/instrumentation.ts +42 -11
  1303. package/src/server/interception-gates.ts +94 -0
  1304. package/src/server/internal.ts +164 -0
  1305. package/src/server/json-status-response.ts +105 -0
  1306. package/src/server/logger.ts +163 -38
  1307. package/src/server/metadata-collector.ts +175 -0
  1308. package/src/server/metadata-platform.ts +2 -2
  1309. package/src/server/metadata-render.ts +30 -8
  1310. package/src/server/metadata-route-links.ts +200 -0
  1311. package/src/server/metadata-routes.ts +114 -24
  1312. package/src/server/metadata-social.ts +2 -2
  1313. package/src/server/metadata.ts +23 -2
  1314. package/src/server/middleware-runner.ts +32 -5
  1315. package/src/server/node-body-response.ts +236 -0
  1316. package/src/server/node-response.ts +93 -0
  1317. package/src/server/node-stream-transforms.ts +340 -0
  1318. package/src/server/node-streams-platform.ts +23 -0
  1319. package/src/server/param-coercion.ts +223 -0
  1320. package/src/server/pipeline-helpers.ts +554 -0
  1321. package/src/server/pipeline-interception.ts +301 -32
  1322. package/src/server/pipeline-metadata-route.ts +242 -0
  1323. package/src/server/pipeline-metadata.ts +30 -4
  1324. package/src/server/pipeline-outcome.ts +290 -0
  1325. package/src/server/pipeline-phases.ts +443 -0
  1326. package/src/server/pipeline.ts +474 -427
  1327. package/src/server/port-resolution.ts +43 -0
  1328. package/src/server/prebuilt/cache-key.ts +340 -0
  1329. package/src/server/prebuilt/capture-render.ts +122 -0
  1330. package/src/server/prebuilt/capture-routes.ts +104 -0
  1331. package/src/server/prebuilt/capture-state.ts +196 -0
  1332. package/src/server/prebuilt/dev-store.ts +252 -0
  1333. package/src/server/prebuilt/lifetime.ts +151 -0
  1334. package/src/server/prebuilt/manifest-tag-index.ts +46 -0
  1335. package/src/server/prebuilt/overlay.ts +290 -0
  1336. package/src/server/prebuilt/payload-source.ts +221 -0
  1337. package/src/server/prebuilt/slots.ts +201 -0
  1338. package/src/server/prebuilt/synthetic-store.ts +125 -0
  1339. package/src/server/prebuilt-builder.ts +515 -0
  1340. package/src/server/prebuilt-runtime.ts +830 -0
  1341. package/src/server/primitives.ts +167 -171
  1342. package/src/server/publish-params.ts +42 -0
  1343. package/src/server/react-cache-bridge.ts +124 -0
  1344. package/src/server/react-cache-scope.ts +104 -0
  1345. package/src/server/render-timeout.ts +123 -0
  1346. package/src/server/render-utils.ts +70 -0
  1347. package/src/server/request-context.ts +321 -323
  1348. package/src/server/request-dep.ts +37 -0
  1349. package/src/server/response-cache-policy.ts +45 -0
  1350. package/src/server/response-framing.ts +59 -0
  1351. package/src/server/route-element-builder.ts +539 -355
  1352. package/src/server/route-element-helpers.ts +37 -0
  1353. package/src/server/route-handler.ts +78 -48
  1354. package/src/server/route-matcher.ts +251 -265
  1355. package/src/server/route-methods.ts +37 -0
  1356. package/src/server/route-module-loader.ts +161 -0
  1357. package/src/server/rsc-cache-key-guard.ts +122 -0
  1358. package/src/server/rsc-entry/action-dispatcher.ts +146 -0
  1359. package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
  1360. package/src/server/rsc-entry/api-handler.ts +30 -93
  1361. package/src/server/rsc-entry/deny-fallback.ts +151 -0
  1362. package/src/server/rsc-entry/error-renderer.ts +306 -113
  1363. package/src/server/rsc-entry/helpers.ts +90 -115
  1364. package/src/server/rsc-entry/index.ts +417 -350
  1365. package/src/server/rsc-entry/render-route.ts +248 -0
  1366. package/src/server/rsc-entry/render-signals.ts +108 -0
  1367. package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
  1368. package/src/server/rsc-entry/rsc-payload.ts +212 -113
  1369. package/src/server/rsc-entry/rsc-stream.ts +143 -135
  1370. package/src/server/rsc-entry/ssr-bridge.ts +43 -8
  1371. package/src/server/rsc-entry/ssr-renderer.ts +311 -140
  1372. package/src/server/rsc-error-envelope.ts +18 -0
  1373. package/src/server/rsc-prop-warnings.ts +1 -1
  1374. package/src/server/safe-load.ts +53 -0
  1375. package/src/server/schema-introspection.ts +393 -0
  1376. package/src/server/sensitive-fields.ts +287 -0
  1377. package/src/server/server-only-guard-noop.js +3 -0
  1378. package/src/server/server-timing.ts +1 -1
  1379. package/src/server/signal-identity.ts +130 -0
  1380. package/src/server/sitemap-generator.ts +337 -0
  1381. package/src/server/sitemap-handler.ts +150 -0
  1382. package/src/server/skippable-prefix.ts +172 -0
  1383. package/src/server/slot-interception.ts +168 -0
  1384. package/src/server/slot-resolver.ts +747 -300
  1385. package/src/server/slot-subtree-contain.ts +273 -0
  1386. package/src/server/ssr-bridge-types.ts +217 -0
  1387. package/src/server/ssr-entry.ts +246 -109
  1388. package/src/server/ssr-form-state.ts +58 -0
  1389. package/src/server/ssr-render.ts +253 -113
  1390. package/src/server/ssr-wrappers.tsx +152 -0
  1391. package/src/server/state-tree-diff.ts +85 -30
  1392. package/src/server/static-generator.ts +680 -0
  1393. package/src/server/static-not-found.ts +134 -0
  1394. package/src/server/status-code-resolver.ts +107 -148
  1395. package/src/server/stream-utils.ts +398 -0
  1396. package/src/server/traced-access.ts +50 -0
  1397. package/src/server/tracing.ts +274 -128
  1398. package/src/server/tree-match.ts +494 -0
  1399. package/src/server/types.ts +97 -11
  1400. package/src/server/utils/element-type.ts +88 -0
  1401. package/src/server/utils/escape-html.ts +20 -0
  1402. package/src/server/version-skew.ts +104 -0
  1403. package/src/server/waituntil-bridge.ts +1 -1
  1404. package/src/server/workers-cache-bridge.ts +33 -0
  1405. package/src/shared/als-slots.ts +74 -0
  1406. package/src/shared/base-path.ts +80 -0
  1407. package/src/shared/csrf-reject.ts +15 -0
  1408. package/src/shared/dev-span.ts +188 -0
  1409. package/src/shared/error-digest.ts +46 -0
  1410. package/src/shared/flight-base64.ts +23 -0
  1411. package/src/shared/flight-segment.ts +35 -0
  1412. package/src/shared/form-state-flight.ts +59 -0
  1413. package/src/shared/href-validation.ts +159 -0
  1414. package/src/shared/merge-search-params.ts +55 -0
  1415. package/src/shared/param-value.ts +281 -0
  1416. package/src/shared/payload-root.ts +153 -0
  1417. package/src/shared/redirect-type.ts +17 -0
  1418. package/src/shared/rsc-cache-key.ts +269 -0
  1419. package/src/shared/rsc-error-envelope.ts +16 -0
  1420. package/src/shared/rsc-manifest.ts +29 -0
  1421. package/src/shared/rsc-media-type.ts +59 -0
  1422. package/src/shared/rsc-payload-path.ts +52 -0
  1423. package/src/shared/segment-info.ts +67 -0
  1424. package/src/shared/slot-params.ts +109 -0
  1425. package/src/shared/static-platform-files.ts +75 -0
  1426. package/src/shared/status-reason-phrase.ts +61 -0
  1427. package/src/shims/font-google.ts +1 -1
  1428. package/src/shims/font-local.ts +34 -0
  1429. package/src/shims/headers.ts +130 -1
  1430. package/src/shims/navigation-client.ts +36 -32
  1431. package/src/shims/navigation-rsc.ts +47 -0
  1432. package/src/shims/navigation.ts +10 -7
  1433. package/src/utils/state-machine.ts +111 -0
  1434. package/src/utils/write-file-atomic.ts +32 -0
  1435. package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
  1436. package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
  1437. package/dist/_chunks/debug-B3Gypr3D.js +0 -108
  1438. package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
  1439. package/dist/_chunks/format-RyoGQL74.js +0 -164
  1440. package/dist/_chunks/format-RyoGQL74.js.map +0 -1
  1441. package/dist/_chunks/interception-BOoWmLUA.js +0 -676
  1442. package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
  1443. package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
  1444. package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
  1445. package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
  1446. package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
  1447. package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
  1448. package/dist/_chunks/tracing-CemImE6h.js +0 -187
  1449. package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
  1450. package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
  1451. package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
  1452. package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
  1453. package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
  1454. package/dist/adapters/cloudflare.js.map +0 -1
  1455. package/dist/cache/index.js.map +0 -1
  1456. package/dist/cache/register-cached-function.d.ts +0 -17
  1457. package/dist/cache/register-cached-function.d.ts.map +0 -1
  1458. package/dist/client/browser-entry.d.ts +0 -21
  1459. package/dist/client/browser-entry.d.ts.map +0 -1
  1460. package/dist/client/error-boundary.js.map +0 -1
  1461. package/dist/client/head.d.ts +0 -16
  1462. package/dist/client/head.d.ts.map +0 -1
  1463. package/dist/client/link-status-provider.d.ts +0 -11
  1464. package/dist/client/link-status-provider.d.ts.map +0 -1
  1465. package/dist/client/segment-merger.d.ts +0 -119
  1466. package/dist/client/segment-merger.d.ts.map +0 -1
  1467. package/dist/client/stale-reload.d.ts +0 -44
  1468. package/dist/client/stale-reload.d.ts.map +0 -1
  1469. package/dist/client/transition-root.d.ts +0 -74
  1470. package/dist/client/transition-root.d.ts.map +0 -1
  1471. package/dist/client/types.d.ts +0 -14
  1472. package/dist/client/types.d.ts.map +0 -1
  1473. package/dist/client/use-navigation-pending.d.ts +0 -26
  1474. package/dist/client/use-navigation-pending.d.ts.map +0 -1
  1475. package/dist/client/use-params.d.ts +0 -92
  1476. package/dist/client/use-params.d.ts.map +0 -1
  1477. package/dist/content/index.d.ts +0 -11
  1478. package/dist/content/index.d.ts.map +0 -1
  1479. package/dist/content/index.js +0 -2
  1480. package/dist/plugins/adapter-build.d.ts +0 -18
  1481. package/dist/plugins/adapter-build.d.ts.map +0 -1
  1482. package/dist/plugins/cache-transform.d.ts +0 -36
  1483. package/dist/plugins/cache-transform.d.ts.map +0 -1
  1484. package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
  1485. package/dist/plugins/dev-logs.d.ts.map +0 -1
  1486. package/dist/plugins/dynamic-transform.d.ts +0 -72
  1487. package/dist/plugins/dynamic-transform.d.ts.map +0 -1
  1488. package/dist/plugins/server-action-exports.d.ts +0 -26
  1489. package/dist/plugins/server-action-exports.d.ts.map +0 -1
  1490. package/dist/routing/status-file-lint.d.ts +0 -33
  1491. package/dist/routing/status-file-lint.d.ts.map +0 -1
  1492. package/dist/search-params/analyze.d.ts +0 -54
  1493. package/dist/search-params/analyze.d.ts.map +0 -1
  1494. package/dist/search-params/builtin-codecs.d.ts +0 -105
  1495. package/dist/search-params/builtin-codecs.d.ts.map +0 -1
  1496. package/dist/search-params/codecs.d.ts +0 -53
  1497. package/dist/search-params/codecs.d.ts.map +0 -1
  1498. package/dist/search-params/create.d.ts +0 -106
  1499. package/dist/search-params/create.d.ts.map +0 -1
  1500. package/dist/search-params/registry.d.ts +0 -20
  1501. package/dist/search-params/registry.d.ts.map +0 -1
  1502. package/dist/server/asset-headers.d.ts +0 -42
  1503. package/dist/server/asset-headers.d.ts.map +0 -1
  1504. package/dist/server/client-module-map.d.ts +0 -47
  1505. package/dist/server/client-module-map.d.ts.map +0 -1
  1506. package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
  1507. package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
  1508. package/dist/server/dev-logger.d.ts.map +0 -1
  1509. package/dist/server/dev-span-processor.d.ts +0 -29
  1510. package/dist/server/dev-span-processor.d.ts.map +0 -1
  1511. package/dist/server/dev-warnings.d.ts +0 -129
  1512. package/dist/server/dev-warnings.d.ts.map +0 -1
  1513. package/dist/server/flush.d.ts +0 -74
  1514. package/dist/server/flush.d.ts.map +0 -1
  1515. package/dist/server/form-flash.d.ts +0 -78
  1516. package/dist/server/form-flash.d.ts.map +0 -1
  1517. package/dist/server/manifest-status-resolver.d.ts +0 -58
  1518. package/dist/server/manifest-status-resolver.d.ts.map +0 -1
  1519. package/dist/server/nuqs-ssr-provider.d.ts +0 -28
  1520. package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
  1521. package/dist/server/prerender.d.ts +0 -77
  1522. package/dist/server/prerender.d.ts.map +0 -1
  1523. package/dist/server/tree-builder.d.ts +0 -126
  1524. package/dist/server/tree-builder.d.ts.map +0 -1
  1525. package/dist/utils/directive-parser.d.ts +0 -70
  1526. package/dist/utils/directive-parser.d.ts.map +0 -1
  1527. package/src/cache/register-cached-function.ts +0 -103
  1528. package/src/client/browser-entry.ts +0 -678
  1529. package/src/client/head.ts +0 -61
  1530. package/src/client/link-status-provider.tsx +0 -30
  1531. package/src/client/segment-merger.ts +0 -339
  1532. package/src/client/stale-reload.ts +0 -87
  1533. package/src/client/transition-root.tsx +0 -166
  1534. package/src/client/types.ts +0 -21
  1535. package/src/client/use-navigation-pending.ts +0 -38
  1536. package/src/client/use-params.ts +0 -141
  1537. package/src/content/index.ts +0 -13
  1538. package/src/plugins/adapter-build.ts +0 -118
  1539. package/src/plugins/cache-transform.ts +0 -199
  1540. package/src/plugins/dynamic-transform.ts +0 -161
  1541. package/src/plugins/server-action-exports.ts +0 -220
  1542. package/src/routing/status-file-lint.ts +0 -112
  1543. package/src/search-params/analyze.ts +0 -192
  1544. package/src/search-params/builtin-codecs.ts +0 -228
  1545. package/src/search-params/codecs.ts +0 -153
  1546. package/src/search-params/create.ts +0 -321
  1547. package/src/search-params/registry.ts +0 -31
  1548. package/src/server/asset-headers.ts +0 -81
  1549. package/src/server/client-module-map.ts +0 -58
  1550. package/src/server/dev-fetch-instrumentation.ts +0 -96
  1551. package/src/server/dev-span-processor.ts +0 -78
  1552. package/src/server/dev-warnings.ts +0 -283
  1553. package/src/server/flush.ts +0 -182
  1554. package/src/server/form-flash.ts +0 -89
  1555. package/src/server/manifest-status-resolver.ts +0 -215
  1556. package/src/server/nuqs-ssr-provider.tsx +0 -63
  1557. package/src/server/prerender.ts +0 -139
  1558. package/src/server/tree-builder.ts +0 -382
  1559. package/src/shims/server-only-noop.js +0 -6
  1560. package/src/utils/directive-parser.ts +0 -529
@@ -0,0 +1,250 @@
1
+ /**
2
+ * TagAwareCacheHandler — wraps any CacheStore and adds tag-based invalidation.
3
+ *
4
+ * Three strategies, selected by store capabilities (best available wins):
5
+ *
6
+ * 1. **Native** (store has setWithTags + invalidateTag): Delegates entirely.
7
+ * The store owns tag indexing. Used for Vercel Runtime Cache, DO-backed
8
+ * stores, or any platform with first-class tag support.
9
+ *
10
+ * 2. **Eager** (store has sadd/smembers/srem/sdel): Maintains an inverted
11
+ * index via atomic set operations. Invalidation enumerates the set and
12
+ * deletes entries. Used for Redis.
13
+ *
14
+ * 3. **Lazy** (bare get/set/del only): Version-stamps entries with tag
15
+ * counters. Invalidation bumps a counter (O(1)). Reads validate stored
16
+ * versions against current. Race-free, correct under eventual consistency.
17
+ * Used for Cloudflare KV.
18
+ *
19
+ * Implements the CacheHandler interface consumed by timber-cache.ts.
20
+ */
21
+
22
+ import type { CacheHandler } from './index.ts';
23
+ import type { CacheStore } from './store.ts';
24
+
25
+ const DATA_PREFIX = 'd:';
26
+ const TAG_SET_PREFIX = 'ts:';
27
+ const TAG_VERSION_PREFIX = 'tv:';
28
+
29
+ /** A store whose optional capability methods are known to be present. */
30
+ type StoreWith<K extends keyof CacheStore> = CacheStore & Required<Pick<CacheStore, K>>;
31
+ type NativeStore = StoreWith<'setWithTags' | 'invalidateTag'>;
32
+ type EagerStore = StoreWith<'sadd' | 'smembers' | 'srem' | 'sdel'>;
33
+
34
+ /**
35
+ * The detected strategy carries the store narrowed to the capabilities that
36
+ * strategy relies on, so each branch calls those methods without assertions.
37
+ */
38
+ type Strategy =
39
+ | { kind: 'native'; store: NativeStore }
40
+ | { kind: 'eager'; store: EagerStore }
41
+ | { kind: 'lazy' };
42
+
43
+ /** Stored entry format for eager strategy. */
44
+ interface EagerEntry {
45
+ value: unknown;
46
+ expiresAt: number;
47
+ tags: string[];
48
+ }
49
+
50
+ /** Stored entry format for lazy (version-stamp) strategy. */
51
+ interface LazyEntry {
52
+ value: unknown;
53
+ expiresAt: number;
54
+ tags: string[];
55
+ tagVersions: Record<string, number>;
56
+ }
57
+
58
+ function isNativeStore(store: CacheStore): store is NativeStore {
59
+ return !!(store.setWithTags && store.invalidateTag);
60
+ }
61
+
62
+ function isEagerStore(store: CacheStore): store is EagerStore {
63
+ return !!(store.sadd && store.smembers && store.srem && store.sdel);
64
+ }
65
+
66
+ function detectStrategy(store: CacheStore): Strategy {
67
+ if (isNativeStore(store)) return { kind: 'native', store };
68
+ if (isEagerStore(store)) return { kind: 'eager', store };
69
+ return { kind: 'lazy' };
70
+ }
71
+
72
+ export class TagAwareCacheHandler implements CacheHandler {
73
+ private store: CacheStore;
74
+ private prefix: string;
75
+ private strategy: Strategy;
76
+
77
+ constructor(store: CacheStore, opts?: { prefix?: string }) {
78
+ this.store = store;
79
+ this.prefix = opts?.prefix ?? 'timber:';
80
+ this.strategy = detectStrategy(store);
81
+ }
82
+
83
+ get consistency(): 'strong' | 'eventual' | 'local' {
84
+ return this.store.consistency;
85
+ }
86
+
87
+ private dataKey(key: string): string {
88
+ return `${this.prefix}${DATA_PREFIX}${key}`;
89
+ }
90
+
91
+ /** Namespace tags for native stores so prefix isolates shared stores. */
92
+ private prefixTags(tags: string[]): string[] {
93
+ return tags.map((t) => `${this.prefix}${t}`);
94
+ }
95
+
96
+ private tagSetKey(tag: string): string {
97
+ return `${this.prefix}${TAG_SET_PREFIX}${tag}`;
98
+ }
99
+
100
+ private tagVersionKey(tag: string): string {
101
+ return `${this.prefix}${TAG_VERSION_PREFIX}${tag}`;
102
+ }
103
+
104
+ async get(key: string): Promise<{ value: unknown; stale: boolean } | null> {
105
+ const raw = await this.store.get(this.dataKey(key));
106
+ if (raw === null) return null;
107
+
108
+ if (this.strategy.kind !== 'lazy') {
109
+ const entry = JSON.parse(raw) as EagerEntry;
110
+ const stale = Date.now() > entry.expiresAt;
111
+ return { value: entry.value, stale };
112
+ }
113
+
114
+ // Lazy: validate tag versions before returning
115
+ const entry = JSON.parse(raw) as LazyEntry;
116
+ if (entry.tags.length > 0) {
117
+ const currentVersions = await this.getTagVersions(entry.tags);
118
+ for (const tag of entry.tags) {
119
+ const stored = entry.tagVersions[tag] ?? 0;
120
+ const current = currentVersions[tag] ?? 0;
121
+ if (current > stored) return null;
122
+ }
123
+ }
124
+ const stale = Date.now() > entry.expiresAt;
125
+ return { value: entry.value, stale };
126
+ }
127
+
128
+ async set(key: string, value: unknown, opts: { ttl: number; tags: string[] }): Promise<void> {
129
+ const physicalTtl = Math.max(opts.ttl * 2 + 60, 120);
130
+ const strategy = this.strategy;
131
+
132
+ if (strategy.kind === 'native') {
133
+ const entry: EagerEntry = {
134
+ value,
135
+ expiresAt: Date.now() + opts.ttl * 1000,
136
+ tags: opts.tags,
137
+ };
138
+ const payload = JSON.stringify(entry);
139
+ if (opts.tags.length > 0) {
140
+ await strategy.store.setWithTags(
141
+ this.dataKey(key),
142
+ payload,
143
+ physicalTtl,
144
+ this.prefixTags(opts.tags)
145
+ );
146
+ } else {
147
+ await this.store.set(this.dataKey(key), payload, physicalTtl);
148
+ }
149
+ return;
150
+ }
151
+
152
+ if (strategy.kind === 'eager') {
153
+ const entry: EagerEntry = {
154
+ value,
155
+ expiresAt: Date.now() + opts.ttl * 1000,
156
+ tags: opts.tags,
157
+ };
158
+ await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
159
+ if (opts.tags.length > 0) {
160
+ await Promise.all(
161
+ opts.tags.map((tag) => strategy.store.sadd(this.tagSetKey(tag), [key], physicalTtl))
162
+ );
163
+ }
164
+ return;
165
+ }
166
+
167
+ // Lazy: snapshot current tag versions into the entry
168
+ const tagVersions = opts.tags.length > 0 ? await this.getTagVersions(opts.tags) : {};
169
+ const entry: LazyEntry = {
170
+ value,
171
+ expiresAt: Date.now() + opts.ttl * 1000,
172
+ tags: opts.tags,
173
+ tagVersions,
174
+ };
175
+ await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
176
+ }
177
+
178
+ async invalidate(opts: { key?: string; tag?: string }): Promise<void> {
179
+ const strategy = this.strategy;
180
+
181
+ if (opts.key) {
182
+ const key = opts.key;
183
+ if (strategy.kind === 'eager') {
184
+ const raw = await this.store.get(this.dataKey(key));
185
+ if (raw !== null) {
186
+ const entry = JSON.parse(raw) as EagerEntry;
187
+ if (entry.tags.length > 0) {
188
+ await Promise.all(
189
+ entry.tags.map((tag) => strategy.store.srem(this.tagSetKey(tag), [key]))
190
+ );
191
+ }
192
+ }
193
+ }
194
+ await this.store.del(this.dataKey(key));
195
+ }
196
+
197
+ if (opts.tag) {
198
+ const tag = opts.tag;
199
+ if (strategy.kind === 'native') {
200
+ await strategy.store.invalidateTag(`${this.prefix}${tag}`);
201
+ } else if (strategy.kind === 'eager') {
202
+ const members = await strategy.store.smembers(this.tagSetKey(tag));
203
+ // Verify each member still carries the tag before deleting — the set
204
+ // can contain stale memberships from overwritten entries or LRU eviction.
205
+ // Remove only the snapshot members (via srem, not sdel) so concurrent
206
+ // writes that add new members between smembers() and cleanup are preserved.
207
+ await Promise.all(
208
+ members.map(async (k) => {
209
+ const raw = await this.store.get(this.dataKey(k));
210
+ if (raw !== null && (JSON.parse(raw) as EagerEntry).tags.includes(tag)) {
211
+ await this.store.del(this.dataKey(k));
212
+ }
213
+ await strategy.store.srem(this.tagSetKey(tag), [k]);
214
+ })
215
+ );
216
+ } else {
217
+ await this.bumpTagVersion(opts.tag);
218
+ }
219
+ }
220
+ }
221
+
222
+ // --- Lazy strategy helpers ---
223
+
224
+ private async getTagVersions(tags: string[]): Promise<Record<string, number>> {
225
+ const versions: Record<string, number> = {};
226
+ await Promise.all(
227
+ tags.map(async (tag) => {
228
+ const raw = await this.store.get(this.tagVersionKey(tag));
229
+ versions[tag] = raw !== null ? parseInt(raw, 10) : 0;
230
+ })
231
+ );
232
+ return versions;
233
+ }
234
+
235
+ private async bumpTagVersion(tag: string): Promise<void> {
236
+ const key = this.tagVersionKey(tag);
237
+ const raw = await this.store.get(key);
238
+ const stored = raw !== null ? parseInt(raw, 10) : 0;
239
+ // max(stored, now) + 1: strictly advancing even within the same
240
+ // millisecond (two bumps in 1ms produce N, N+1 not N, N). On
241
+ // eventually-consistent stores the read can be stale, but Date.now()
242
+ // provides a floor — regression only if BOTH the read is stale AND the
243
+ // clock is behind, bounded by the store's propagation window (~60s).
244
+ const version = Math.max(stored, Date.now()) + 1;
245
+ // Version keys must outlive all data entries stamped with them. Data
246
+ // entries use physical TTL of max(ttl*2+60, 120); 365 days exceeds any
247
+ // practical cache lifetime.
248
+ await this.store.set(key, String(version), 365 * 86400);
249
+ }
250
+ }
@@ -1,10 +1,40 @@
1
- import type { CacheHandler, CacheOptions } from './index';
2
- import { stableStringify } from './stable-stringify';
3
- import { createSingleflight } from './singleflight';
4
- import { addSpanEventSync } from '#/server/tracing.js';
5
- import { fnv1aHash } from './fast-hash.js';
1
+ import type { CacheHandler, CacheOptions } from './index.ts';
2
+ import { stableStringify } from './stable-stringify.ts';
3
+ import { createSingleflight } from './singleflight.ts';
4
+ import {
5
+ currentInvalidationEpoch,
6
+ lastInvalidationEpochFor,
7
+ wasInvalidatedSince,
8
+ } from './invalidation-epoch.ts';
9
+ import { addSpanEventSync } from '../server/tracing.ts';
10
+ import { logCacheMiss, logSwrRefetchFailed, swallow } from '../server/logger.ts';
11
+ import { guardedRead } from './guarded-read.ts';
12
+ import { getWaitUntil } from '../server/waituntil-bridge.ts';
13
+ import { fnv1aHash } from './fast-hash.ts';
14
+ import { devDataCacheKey } from '../server/prebuilt/dev-store.ts';
15
+ import { KeyDisciplineViolation, observeKeyDiscipline } from './key-discipline.ts';
6
16
 
7
- const singleflight = createSingleflight();
17
+ /**
18
+ * The one flight keyspace for every cache() wrapper. A wrapper with its own
19
+ * `timeoutMs` passes it per call rather than getting a private instance:
20
+ * two wrappers that share an explicit key must coalesce, or an older,
21
+ * slower execution can overwrite a newer result — there is no write
22
+ * ordering in the CacheHandler contract to stop it (TIM-1447).
23
+ */
24
+ const flights = createSingleflight();
25
+
26
+ /** Timeout for calls without a per-wrapper `timeoutMs`; set at boot. */
27
+ let defaultTimeoutMs: number | undefined;
28
+
29
+ /**
30
+ * Set the timeout for cache calls without a per-call timeoutMs.
31
+ * Called at framework boot with renderTimeoutMs from timber.config.ts so that
32
+ * cache calls without a per-call timeoutMs still get deadlock protection.
33
+ * See design/06-caching.md §"Singleflight Timeout — Deadlock Risk".
34
+ */
35
+ export function setDefaultSingleflightTimeout(timeoutMs: number): void {
36
+ defaultTimeoutMs = timeoutMs;
37
+ }
8
38
 
9
39
  /**
10
40
  * Generate a cache key from function identity and serialized args.
@@ -33,17 +63,66 @@ function resolveTags<Fn extends (...args: any[]) => any>(
33
63
  return opts.tags(...args);
34
64
  }
35
65
 
36
- // Counter for generating unique function IDs when no explicit key is provided.
37
- let fnIdCounter = 0;
66
+ /** Per-process count of byte-identical fn sources seen by deriveFallbackFnId. */
67
+ const fallbackIdOccurrences = new Map<string, number>();
68
+ let hasWarnedFallbackId = false;
69
+
70
+ /**
71
+ * Derive a fallback fnId for callsites the timber-cache-transform Vite plugin
72
+ * could not statically detect (aliased bindings, user re-export wrappers).
73
+ *
74
+ * The base is fnv1a(fn.toString()) — deterministic across instances and cold
75
+ * starts of the same build, so two *different* functions can never swap fnIds
76
+ * by module-evaluation order (the TIM-997 poisoning scenario that the old
77
+ * process-local counter allowed; see TIM-1054). A per-process occurrence
78
+ * suffix disambiguates byte-identical duplicate sources. That residue is the
79
+ * one remaining hazard: closures produced by the same factory share source
80
+ * text but capture different values, and their occurrence order may differ
81
+ * across instances — such callsites need an explicit `key` option.
82
+ */
83
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
84
+ function deriveFallbackFnId(fn: (...args: any[]) => any): string {
85
+ const sourceHash = fnv1aHash(fn.toString());
86
+ const occurrence = fallbackIdOccurrences.get(sourceHash) ?? 0;
87
+ fallbackIdOccurrences.set(sourceHash, occurrence + 1);
88
+
89
+ if (!hasWarnedFallbackId && typeof process !== 'undefined' && process.env?.NODE_ENV !== 'test') {
90
+ hasWarnedFallbackId = true;
91
+ console.warn(
92
+ '[timber] cache() callsite has no build-time stable ID and no explicit `key` option — ' +
93
+ 'the call is not statically visible to the timber Vite plugin (e.g. an aliased ' +
94
+ 'binding like `const c = cache` or a re-export wrapper module). Falling back to a ' +
95
+ 'function-source hash for the cache key. With a shared CacheHandler (Redis/KV) this ' +
96
+ 'is safe for distinct functions, but byte-identical closures from a factory can swap ' +
97
+ 'cache entries across instances. Provide an explicit `key` option to make the cache ' +
98
+ 'key contract stable and auditable.'
99
+ );
100
+ }
101
+
102
+ return `timber-cache:fn:${sourceHash}:${occurrence}`;
103
+ }
38
104
 
39
105
  /**
40
106
  * Creates a cached wrapper around an async function.
41
107
  *
42
- * - SHA-256 default keys with normalized JSON args
43
- * - Singleflight: concurrent misses → single execution
108
+ * - FNV-1a default keys with normalized JSON args
109
+ * - Singleflight: concurrent misses → single execution AND single
110
+ * handler.set — the write happens inside the coalesced callback (TIM-1028)
111
+ * - Writes are skipped when the key/tags were invalidated while fn was in
112
+ * flight, so explicit invalidation is never silently undone (TIM-1028)
44
113
  * - SWR: serve stale immediately, background refetch
45
114
  * - Tags as string[] or function of args
46
- * - No ALS dependency
115
+ * - The handler is resolved per invocation via `getHandler`, never captured
116
+ * at wrapper-creation time — module-scope cache() wrappers created before
117
+ * the framework's boot wiring calls setCacheHandler() still use the
118
+ * configured handler once it arrives (TIM-1029)
119
+ * - No ALS dependency for correctness — cache() works outside a request
120
+ * context. The waitUntil ALS bridge is read optionally so the SWR
121
+ * background refetch survives handler return on Workers/Lambda, and
122
+ * inside one, fn runs under the key-discipline observer (design/45
123
+ * §Enforcement): the key comes from the arguments only, so a
124
+ * request-context read in fn is reported, or rejected in strict mode
125
+ * before the result is stored.
47
126
  *
48
127
  * Cache hits/misses are recorded as OTEL span events on the enclosing
49
128
  * span (not child spans). The DevSpanProcessor reads these for dev log output.
@@ -52,15 +131,33 @@ let fnIdCounter = 0;
52
131
  export function createCache<Fn extends (...args: any[]) => Promise<any>>(
53
132
  fn: Fn,
54
133
  opts: CacheOptions<Fn>,
55
- handler: CacheHandler
56
- ): (...args: Parameters<Fn>) => Promise<Awaited<ReturnType<Fn>>> {
57
- const fnId = `timber-cache:${fnIdCounter++}`;
134
+ getHandler: () => CacheHandler,
135
+ stableId?: string
136
+ ): Fn {
137
+ // With an explicit `key` option the fnId never reaches key generation, so
138
+ // no fallback derivation (or warning) is needed in that case.
139
+ const fnId = stableId ?? (opts.key ? undefined : deriveFallbackFnId(fn));
140
+ // Key-discipline rate-limit id. An explicit-key callsite without a
141
+ // build-time ID has no fnId; its source hash is stable enough for a
142
+ // rate limit and, unlike deriveFallbackFnId, never warns.
143
+ const disciplineId = fnId ?? `key-fn:${fnv1aHash(fn.toString())}`;
58
144
 
59
- return async (...args: Parameters<Fn>): Promise<Awaited<ReturnType<Fn>>> => {
60
- const key = opts.key ? opts.key(...args) : defaultKeyGenerator(fnId, args);
145
+ // Cast to Fn to preserve the original function's generic call signature.
146
+ // Without this, generic type parameters (e.g. <T> in apiFetch<T>) are
147
+ // erased and callers lose type safety on the return type.
148
+ return (async (...args: Parameters<Fn>): Promise<Awaited<ReturnType<Fn>>> => {
149
+ // Resolve the default per invocation (not captured at creation time)
150
+ // so wrappers created before boot pick up the timeout once
151
+ // setDefaultSingleflightTimeout is called (TIM-1032, same rationale as
152
+ // getCacheHandler for TIM-1029).
153
+ const timeoutMs = opts.timeoutMs ?? defaultTimeoutMs;
154
+ const key = opts.key ? opts.key(...args) : defaultKeyGenerator(fnId as string, args);
155
+
156
+ // The key the handler sees: in dev, scoped to the source generation.
157
+ const storeKey = devDataCacheKey(key);
61
158
 
62
159
  const cacheStart = performance.now();
63
- const cached = await handler.get(key);
160
+ const cached = await guardedRead(key, () => getHandler().get(storeKey), null);
64
161
 
65
162
  if (cached && !cached.stale) {
66
163
  // Record as OTEL span event on enclosing span (not a child span).
@@ -72,6 +169,73 @@ export function createCache<Fn extends (...args: any[]) => Promise<any>>(
72
169
  return cached.value as Awaited<ReturnType<Fn>>;
73
170
  }
74
171
 
172
+ // From here fn() will execute (SWR refetch or miss). Scope the
173
+ // singleflight key by the last invalidation epoch affecting this
174
+ // key/tags: a caller arriving after an invalidation must not coalesce
175
+ // onto a flight that started before it — it would receive the
176
+ // pre-invalidation result the invalidation was issued to discard.
177
+ // NUL separator: cannot collide with user-provided key strings. The
178
+ // store key, not the logical key: in dev it carries the source
179
+ // generation, so a caller after a save never joins a pre-save flight.
180
+ // One flight keyspace for the SWR refetch and the miss: a caller that
181
+ // misses while a refetch is running joins it rather than racing a
182
+ // second execution whose write could land under the first (TIM-1447).
183
+ const tags = resolveTags(opts, args);
184
+ const flightKey = `${storeKey}\u0000${lastInvalidationEpochFor(key, tags)}`;
185
+
186
+ /**
187
+ * Run fn and store the result — exactly once per coalesced execution,
188
+ * inside the singleflight callback. The write is skipped when:
189
+ * - the key/tags were invalidated after fn started (TIM-1028), or
190
+ * - the singleflight timed out (signal aborted) — the timed-out
191
+ * flight's write could overwrite a newer value from a subsequent
192
+ * flight (TIM-1092).
193
+ * Those two guards plus the shared flight keyspace leave no second
194
+ * in-process execution for the key to race, as long as every wrapper
195
+ * using the key agrees on its tags (design/06 §Residual write races). A set issued just before
196
+ * a timeout can still land after the next flight's set; that, and
197
+ * writes from other processes, are last-write-wins and self-heal on
198
+ * the next miss (design/06 §Residual write races).
199
+ */
200
+ const executeAndStore = async (signal: AbortSignal): Promise<Awaited<ReturnType<Fn>>> => {
201
+ const startEpoch = currentInvalidationEpoch();
202
+ // Observed on every execution — the miss path and the SWR refetch,
203
+ // which runs in the triggering request's context. Never on a hit:
204
+ // a hit runs no fn, so it reads nothing.
205
+ let result: Awaited<ReturnType<Fn>>;
206
+ try {
207
+ result = await observeKeyDiscipline(
208
+ { tier: 'cache.data', id: disciplineId, label: fn.name || undefined, cacheKey: key },
209
+ () => fn(...args)
210
+ );
211
+ } catch (err) {
212
+ // Strict key discipline rejected this fn, so any entry already
213
+ // under the key was computed by the same request-reading fn (stored
214
+ // before strict mode was on). Drop it rather than serve it to
215
+ // everyone as stale — unless the flight timed out: a newer flight
216
+ // may already have replaced the entry. (A delete is never wrong,
217
+ // only a miss; this just avoids a needless one.)
218
+ if (err instanceof KeyDisciplineViolation && !signal.aborted) {
219
+ await getHandler()
220
+ .invalidate({ key: storeKey })
221
+ .catch((e: unknown) => swallow(e, `cache invalidate failed for key "${key}"`));
222
+ }
223
+ throw err;
224
+ }
225
+ if (!signal.aborted && !wasInvalidatedSince(startEpoch, key, tags)) {
226
+ try {
227
+ await getHandler().set(storeKey, result, { ttl: opts.ttl, tags });
228
+ } catch (err) {
229
+ // Cache-write failure must not fail the request (TIM-1046).
230
+ // JSON-serializing handlers (Redis, KV) throw on BigInt; network
231
+ // errors can surface from any shared handler. The result is valid
232
+ // — serve it uncached rather than rejecting a successful fn().
233
+ swallow(err, `cache set failed for key "${key}"`);
234
+ }
235
+ }
236
+ return result;
237
+ };
238
+
75
239
  if (cached && cached.stale && opts.staleWhileRevalidate) {
76
240
  // Record stale cache hit as OTEL span event (fire-and-forget).
77
241
  addSpanEventSync('timber.cache.hit', {
@@ -79,45 +243,52 @@ export function createCache<Fn extends (...args: any[]) => Promise<any>>(
79
243
  duration_ms: Math.round(performance.now() - cacheStart),
80
244
  stale: true,
81
245
  });
82
- // Serve stale immediately, trigger background refetch
83
- singleflight
84
- .do(`swr:${key}`, async () => {
85
- try {
86
- const fresh = await fn(...args);
87
- const tags = resolveTags(opts, args);
88
- await handler.set(key, fresh, { ttl: opts.ttl, tags });
89
- } catch {
90
- // Failed refetch — stale entry continues to be served.
91
- // Error is swallowed per design doc: "Error is logged."
246
+ // Serve stale immediately, trigger background refetch. The flight
247
+ // settles with fn's own outcome, so a miss that joins it gets the
248
+ // value or the error; only this background handle swallows it.
249
+ const refetch = flights
250
+ .do(
251
+ flightKey,
252
+ (signal) =>
253
+ executeAndStore(signal).catch((err: unknown) => {
254
+ // Failed refetch — stale entry continues to be served (unless
255
+ // executeAndStore dropped it for a key-discipline violation).
256
+ // Logged inside the flight so a rejection that arrives after
257
+ // the singleflight timeout is still reported.
258
+ logSwrRefetchFailed({ cacheKey: key, error: err });
259
+ throw err;
260
+ }),
261
+ timeoutMs
262
+ )
263
+ .then(
264
+ () => {},
265
+ () => {
266
+ // Logged above; the timeout rejection itself stays silent, as
267
+ // the stale entry continues to be served.
92
268
  }
93
- })
94
- .catch(() => {
95
- // Singleflight promise rejection handled — stale continues.
96
- });
269
+ );
270
+ // Platforms that cancel work when the handler returns (Cloudflare
271
+ // Workers, Lambda) would otherwise kill the refetch mid-flight —
272
+ // stale data re-served forever. Register the (never-rejecting)
273
+ // refetch with the request's waitUntil; undefined outside a request
274
+ // context or on platforms without lifecycle extension (Node servers
275
+ // keep floating promises alive, so behavior there is unchanged).
276
+ getWaitUntil()?.(refetch);
97
277
  return cached.value as Awaited<ReturnType<Fn>>;
98
278
  }
99
279
 
100
- // Cache miss (or stale without SWR) — execute with singleflight
101
- const result = await singleflight.do(key, () => fn(...args));
102
- const tags = resolveTags(opts, args);
103
- await handler.set(key, result, { ttl: opts.ttl, tags });
280
+ // Cache miss (or stale without SWR) — execute with singleflight.
281
+ // The handler.set lives inside the coalesced callback, so N concurrent
282
+ // misses produce exactly one write (TIM-1028).
283
+ const result = await flights.do(flightKey, executeAndStore, timeoutMs);
104
284
 
105
285
  // Record cache miss as OTEL span event (fire-and-forget).
106
286
  addSpanEventSync('timber.cache.miss', {
107
287
  key,
108
288
  duration_ms: Math.round(performance.now() - cacheStart),
109
289
  });
290
+ logCacheMiss({ cacheKey: key });
110
291
 
111
- return result as Awaited<ReturnType<Fn>>;
112
- };
292
+ return result;
293
+ }) as unknown as Fn;
113
294
  }
114
-
115
- /**
116
- * Invalidate cache entries by tag or key.
117
- */
118
- createCache.invalidate = async function invalidate(
119
- handler: CacheHandler,
120
- opts: { key?: string; tag?: string }
121
- ): Promise<void> {
122
- await handler.invalidate(opts);
123
- };
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Cloudflare CDN purge handler — purges by cache tag via the Cloudflare API.
3
+ *
4
+ * Requires Cloudflare Enterprise for tag-based purging.
5
+ * See https://developers.cloudflare.com/cache/how-to/purge-cache/purge-by-tags/
6
+ */
7
+
8
+ import type { CdnPurgeHandler } from './purge-store.ts';
9
+
10
+ export interface CloudflarePurgeOptions {
11
+ /** Cloudflare zone ID. */
12
+ zoneId: string;
13
+ /** API token with Cache Purge permission. */
14
+ apiToken: string;
15
+ /** Override fetch for testing. */
16
+ fetch?: typeof globalThis.fetch;
17
+ }
18
+
19
+ export class CloudflarePurge implements CdnPurgeHandler {
20
+ private readonly zoneId: string;
21
+ private readonly apiToken: string;
22
+ private readonly _fetch: typeof globalThis.fetch;
23
+
24
+ constructor(opts: CloudflarePurgeOptions) {
25
+ this.zoneId = opts.zoneId;
26
+ this.apiToken = opts.apiToken;
27
+ this._fetch = opts.fetch ?? globalThis.fetch;
28
+ }
29
+
30
+ async purgeTags(tags: string[]): Promise<void> {
31
+ if (tags.length === 0) return;
32
+
33
+ const res = await this._fetch(
34
+ `https://api.cloudflare.com/client/v4/zones/${this.zoneId}/purge_cache`,
35
+ {
36
+ method: 'POST',
37
+ headers: {
38
+ 'Authorization': `Bearer ${this.apiToken}`,
39
+ 'Content-Type': 'application/json',
40
+ },
41
+ body: JSON.stringify({ tags }),
42
+ }
43
+ );
44
+
45
+ if (!res.ok) {
46
+ const body = await res.text();
47
+ throw new Error(`Cloudflare purge failed (${res.status}): ${body}`);
48
+ }
49
+ }
50
+ }
@@ -0,0 +1,63 @@
1
+ /**
2
+ * Fastly CDN purge handler — purges by surrogate key via the Fastly API.
3
+ *
4
+ * See https://www.fastly.com/documentation/reference/api/purging/
5
+ */
6
+
7
+ import type { CdnPurgeHandler } from './purge-store.ts';
8
+
9
+ export interface FastlyPurgeOptions {
10
+ /** Fastly service ID. */
11
+ serviceId: string;
12
+ /** Fastly API token with purge permission. */
13
+ apiToken: string;
14
+ /** Use soft purge (marks as stale instead of immediate delete). Default: false. */
15
+ softPurge?: boolean;
16
+ /** Override fetch for testing. */
17
+ fetch?: typeof globalThis.fetch;
18
+ }
19
+
20
+ export class FastlyPurge implements CdnPurgeHandler {
21
+ private readonly serviceId: string;
22
+ private readonly apiToken: string;
23
+ private readonly softPurge: boolean;
24
+ private readonly _fetch: typeof globalThis.fetch;
25
+
26
+ constructor(opts: FastlyPurgeOptions) {
27
+ this.serviceId = opts.serviceId;
28
+ this.apiToken = opts.apiToken;
29
+ this.softPurge = opts.softPurge ?? false;
30
+ this._fetch = opts.fetch ?? globalThis.fetch;
31
+ }
32
+
33
+ async purgeTags(tags: string[]): Promise<void> {
34
+ if (tags.length === 0) return;
35
+
36
+ const results = await Promise.allSettled(
37
+ tags.map((tag) =>
38
+ this._fetch(
39
+ `https://api.fastly.com/service/${this.serviceId}/purge/${encodeURIComponent(tag)}`,
40
+ {
41
+ method: 'POST',
42
+ headers: {
43
+ 'Fastly-Key': this.apiToken,
44
+ ...(this.softPurge ? { 'Fastly-Soft-Purge': '1' } : {}),
45
+ },
46
+ }
47
+ ).then(async (res) => {
48
+ if (!res.ok) {
49
+ const body = await res.text();
50
+ throw new Error(`Fastly purge failed for tag "${tag}" (${res.status}): ${body}`);
51
+ }
52
+ })
53
+ )
54
+ );
55
+
56
+ const failures = results.filter((r): r is PromiseRejectedResult => r.status === 'rejected');
57
+ if (failures.length > 0) {
58
+ throw new Error(
59
+ `Fastly purge failed for ${failures.length}/${tags.length} tags: ${failures.map((f) => f.reason?.message).join('; ')}`
60
+ );
61
+ }
62
+ }
63
+ }