@timber-js/app 0.2.0-alpha.239 → 0.2.0-alpha.240

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 (332) hide show
  1. package/dist/_chunks/{actions-Top9GftB.js → actions-DIgnvDrG.js} +4 -4
  2. package/dist/_chunks/{actions-Top9GftB.js.map → actions-DIgnvDrG.js.map} +1 -1
  3. package/dist/_chunks/{als-registry-DpygwCp0.js → als-registry-PPYstxK0.js} +2 -1
  4. package/dist/_chunks/{als-registry-DpygwCp0.js.map → als-registry-PPYstxK0.js.map} +1 -1
  5. package/dist/_chunks/{cache-api-Bo8c7XVF.js → cache-api-uWQwuxWb.js} +5 -5
  6. package/dist/_chunks/{cache-api-Bo8c7XVF.js.map → cache-api-uWQwuxWb.js.map} +1 -1
  7. package/dist/_chunks/{chains-DMoHX4yH.js → chains-C7CExrUI.js} +2 -2
  8. package/dist/_chunks/{chains-DMoHX4yH.js.map → chains-C7CExrUI.js.map} +1 -1
  9. package/dist/_chunks/chains-CSslTUdI.js +1 -0
  10. package/dist/_chunks/{classify-BwyAd-dZ.js → classify-Cj9EeZoL.js} +2 -2
  11. package/dist/_chunks/{classify-BwyAd-dZ.js.map → classify-Cj9EeZoL.js.map} +1 -1
  12. package/dist/_chunks/{cli-check-DQAD9MLo.js → cli-check-C3QOAru7.js} +3 -3
  13. package/dist/_chunks/{cli-check-DQAD9MLo.js.map → cli-check-C3QOAru7.js.map} +1 -1
  14. package/dist/_chunks/{cli-schema-sync-C_xNLqBj.js → cli-schema-sync-BRxZz66D.js} +1 -1
  15. package/dist/_chunks/{cli-schema-sync-CmGls3dc.js → cli-schema-sync-DQUS_o3V.js} +2 -2
  16. package/dist/_chunks/{cli-schema-sync-CmGls3dc.js.map → cli-schema-sync-DQUS_o3V.js.map} +1 -1
  17. package/dist/_chunks/{client-dep-entries-C5BTQtFS.js → client-dep-entries-ZETBdLgv.js} +2 -2
  18. package/dist/_chunks/{client-dep-entries-C5BTQtFS.js.map → client-dep-entries-ZETBdLgv.js.map} +1 -1
  19. package/dist/_chunks/{convention-lint-GQA6WTRo.js → convention-lint-BoVISNS6.js} +3 -3
  20. package/dist/_chunks/{convention-lint-GQA6WTRo.js.map → convention-lint-BoVISNS6.js.map} +1 -1
  21. package/dist/_chunks/dev-server-B8roKA3Q.js +1 -0
  22. package/dist/_chunks/{dev-server-Cr3_Fu5A.js → dev-server-C5R6jx8Q.js} +2 -2
  23. package/dist/_chunks/{dev-server-Cr3_Fu5A.js.map → dev-server-C5R6jx8Q.js.map} +1 -1
  24. package/dist/_chunks/{dev-span-RsVeYYc_.js → dev-span-0aG7Q_Ph.js} +3 -7
  25. package/dist/_chunks/dev-span-0aG7Q_Ph.js.map +1 -0
  26. package/dist/_chunks/{error-boundary-Bh-egWUI.js → error-boundary-DB51f9ih.js} +98 -419
  27. package/dist/_chunks/error-boundary-DB51f9ih.js.map +1 -0
  28. package/dist/_chunks/{flight-source-node-BsrlUjMO.js → flight-source-node-D9cHBhjP.js} +7 -4
  29. package/dist/_chunks/flight-source-node-D9cHBhjP.js.map +1 -0
  30. package/dist/_chunks/{json-lossy-check-D47R9Fp5.js → json-lossy-check-Y1GxqVX_.js} +2 -2
  31. package/dist/_chunks/{json-lossy-check-D47R9Fp5.js.map → json-lossy-check-Y1GxqVX_.js.map} +1 -1
  32. package/dist/_chunks/{live-graph-HcLScfiV.js → live-graph-BDQWvnMm.js} +4 -4
  33. package/dist/_chunks/{live-graph-HcLScfiV.js.map → live-graph-BDQWvnMm.js.map} +1 -1
  34. package/dist/_chunks/{logger-DDLtp5e-.js → logger-DmRR9tmZ.js} +2 -2
  35. package/dist/_chunks/{logger-DDLtp5e-.js.map → logger-DmRR9tmZ.js.map} +1 -1
  36. package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
  37. package/dist/_chunks/{node-response-omewa8e6.js → node-response-yp8zdyRp.js} +2 -2
  38. package/dist/_chunks/{node-response-omewa8e6.js.map → node-response-yp8zdyRp.js.map} +1 -1
  39. package/dist/_chunks/plugin-context-BtaQcMuh.js.map +1 -1
  40. package/dist/_chunks/{poison-scan-DONdiCGX.js → poison-scan-WQgUydF_.js} +2 -2
  41. package/dist/_chunks/{poison-scan-DONdiCGX.js.map → poison-scan-WQgUydF_.js.map} +1 -1
  42. package/dist/_chunks/{scanner-DSAJjH0x.js → scanner-C9Lrf77z.js} +3 -2
  43. package/dist/_chunks/{scanner-DSAJjH0x.js.map → scanner-C9Lrf77z.js.map} +1 -1
  44. package/dist/_chunks/{sizeof-DVhEVN_y.js → sizeof-BISkSaU0.js} +2 -2
  45. package/dist/_chunks/{sizeof-DVhEVN_y.js.map → sizeof-BISkSaU0.js.map} +1 -1
  46. package/dist/_chunks/{walkers-96YopJds.js → walkers-Bxv4v7tX.js} +3 -3
  47. package/dist/_chunks/{walkers-96YopJds.js.map → walkers-Bxv4v7tX.js.map} +1 -1
  48. package/dist/adapters/cloudflare-kv-cache.js +1 -1
  49. package/dist/analyze/crawl-entry.js +3 -3
  50. package/dist/analyze/graph-command.js +2 -2
  51. package/dist/cache/index.js +2 -2
  52. package/dist/cache/stores/memory.js +1 -1
  53. package/dist/cdn/workers-cache-purge.js +1 -1
  54. package/dist/cli.js +3 -3
  55. package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -1
  56. package/dist/client/browser-entry/hydrate.d.ts +1 -1
  57. package/dist/client/browser-entry/router-init.d.ts.map +1 -1
  58. package/dist/client/error-boundary.d.ts +1 -0
  59. package/dist/client/error-boundary.d.ts.map +1 -1
  60. package/dist/client/error-boundary.js +1 -1
  61. package/dist/client/history.d.ts +4 -5
  62. package/dist/client/history.d.ts.map +1 -1
  63. package/dist/client/index.js +6 -7
  64. package/dist/client/index.js.map +1 -1
  65. package/dist/client/internal.d.ts +1 -1
  66. package/dist/client/internal.d.ts.map +1 -1
  67. package/dist/client/internal.js +194 -55
  68. package/dist/client/internal.js.map +1 -1
  69. package/dist/client/navigation-commit.d.ts +6 -25
  70. package/dist/client/navigation-commit.d.ts.map +1 -1
  71. package/dist/client/outlet-content-cache.d.ts +59 -0
  72. package/dist/client/outlet-content-cache.d.ts.map +1 -0
  73. package/dist/client/outlet-scope-context.d.ts +30 -0
  74. package/dist/client/outlet-scope-context.d.ts.map +1 -0
  75. package/dist/client/params-context.d.ts +10 -11
  76. package/dist/client/params-context.d.ts.map +1 -1
  77. package/dist/client/router-pipeline.d.ts +5 -5
  78. package/dist/client/router-pipeline.d.ts.map +1 -1
  79. package/dist/client/router-types.d.ts +10 -24
  80. package/dist/client/router-types.d.ts.map +1 -1
  81. package/dist/client/router.d.ts.map +1 -1
  82. package/dist/client/rsc-fetch.d.ts +4 -17
  83. package/dist/client/rsc-fetch.d.ts.map +1 -1
  84. package/dist/client/segment-cache.d.ts +15 -103
  85. package/dist/client/segment-cache.d.ts.map +1 -1
  86. package/dist/client/segment-outlet.d.ts +28 -52
  87. package/dist/client/segment-outlet.d.ts.map +1 -1
  88. package/dist/client/stale-segment.d.ts +39 -0
  89. package/dist/client/stale-segment.d.ts.map +1 -0
  90. package/dist/client/use-segment-params.d.ts +1 -1
  91. package/dist/config-types.d.ts +7 -6
  92. package/dist/config-types.d.ts.map +1 -1
  93. package/dist/index.d.ts.map +1 -1
  94. package/dist/index.js +9 -732
  95. package/dist/index.js.map +1 -1
  96. package/dist/native/rsc/manifest.json +6 -4
  97. package/dist/native/rsc/routing/segment-keys.js +3 -11
  98. package/dist/native/rsc/routing/segment-keys.js.map +1 -1
  99. package/dist/native/rsc/server/access-gate.js +3 -7
  100. package/dist/native/rsc/server/access-gate.js.map +1 -1
  101. package/dist/native/rsc/server/als-registry.js +2 -1
  102. package/dist/native/rsc/server/als-registry.js.map +1 -1
  103. package/dist/native/rsc/server/build-manifest.js.map +1 -1
  104. package/dist/native/rsc/server/chain-url-parts.js +1 -6
  105. package/dist/native/rsc/server/chain-url-parts.js.map +1 -1
  106. package/dist/native/rsc/server/client-state-tree.js +33 -0
  107. package/dist/native/rsc/server/client-state-tree.js.map +1 -0
  108. package/dist/native/rsc/server/flight-source-node.js +5 -2
  109. package/dist/native/rsc/server/flight-source-node.js.map +1 -1
  110. package/dist/native/rsc/server/flight-source.js +46 -7
  111. package/dist/native/rsc/server/flight-source.js.map +1 -1
  112. package/dist/native/rsc/server/pipeline-interception.js +1 -1
  113. package/dist/native/rsc/server/publish-params.js.map +1 -1
  114. package/dist/native/rsc/server/route-element-builder.js +43 -61
  115. package/dist/native/rsc/server/route-element-builder.js.map +1 -1
  116. package/dist/native/rsc/server/rsc-entry/helpers.js +5 -28
  117. package/dist/native/rsc/server/rsc-entry/helpers.js.map +1 -1
  118. package/dist/native/rsc/server/rsc-entry/render-route.js +33 -7
  119. package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
  120. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +2 -1
  121. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
  122. package/dist/native/rsc/server/rsc-entry/rsc-payload.js +2 -5
  123. package/dist/native/rsc/server/rsc-entry/rsc-payload.js.map +1 -1
  124. package/dist/native/rsc/server/rsc-entry/rsc-stream.js +44 -40
  125. package/dist/native/rsc/server/rsc-entry/rsc-stream.js.map +1 -1
  126. package/dist/native/rsc/server/rsc-entry/ssr-renderer.js +1 -1
  127. package/dist/native/rsc/server/rsc-entry/ssr-renderer.js.map +1 -1
  128. package/dist/native/rsc/server/segment-hash/capture.js +107 -0
  129. package/dist/native/rsc/server/segment-hash/capture.js.map +1 -0
  130. package/dist/native/rsc/server/segment-hash/outlet.js +81 -0
  131. package/dist/native/rsc/server/segment-hash/outlet.js.map +1 -0
  132. package/dist/native/rsc/server/segment-hash/stream-tap.js +139 -0
  133. package/dist/native/rsc/server/segment-hash/stream-tap.js.map +1 -0
  134. package/dist/native/rsc/server/segment-hash/value-hash.js +171 -0
  135. package/dist/native/rsc/server/segment-hash/value-hash.js.map +1 -0
  136. package/dist/native/rsc/server/slot-resolver.js +20 -124
  137. package/dist/native/rsc/server/slot-resolver.js.map +1 -1
  138. package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
  139. package/dist/native/rsc/shared/outlet-decision.js +5 -0
  140. package/dist/native/rsc/shared/outlet-decision.js.map +1 -0
  141. package/dist/native/ssr/client/error-boundary.js +16 -3
  142. package/dist/native/ssr/client/error-boundary.js.map +1 -1
  143. package/dist/native/ssr/client/navigation-commit.js +1 -5
  144. package/dist/native/ssr/client/navigation-commit.js.map +1 -1
  145. package/dist/native/ssr/client/outlet-content-cache.js +53 -0
  146. package/dist/native/ssr/client/outlet-content-cache.js.map +1 -0
  147. package/dist/native/ssr/client/outlet-scope-context.js +12 -0
  148. package/dist/native/ssr/client/outlet-scope-context.js.map +1 -0
  149. package/dist/native/ssr/client/params-context.js.map +1 -1
  150. package/dist/native/ssr/client/rsc-fetch.js +1 -12
  151. package/dist/native/ssr/client/rsc-fetch.js.map +1 -1
  152. package/dist/native/ssr/client/segment-outlet.js +34 -13
  153. package/dist/native/ssr/client/segment-outlet.js.map +1 -1
  154. package/dist/native/ssr/client/stale-segment.js +29 -0
  155. package/dist/native/ssr/client/stale-segment.js.map +1 -0
  156. package/dist/native/ssr/manifest.json +5 -4
  157. package/dist/native/ssr/routing/segment-keys.js +5 -1
  158. package/dist/native/ssr/routing/segment-keys.js.map +1 -1
  159. package/dist/native/ssr/server/access-gate.js +3 -7
  160. package/dist/native/ssr/server/access-gate.js.map +1 -1
  161. package/dist/native/ssr/server/als-registry.js +1 -0
  162. package/dist/native/ssr/server/als-registry.js.map +1 -1
  163. package/dist/native/ssr/server/build-manifest.js.map +1 -1
  164. package/dist/native/ssr/server/client-state-tree.js +33 -0
  165. package/dist/native/ssr/server/client-state-tree.js.map +1 -0
  166. package/dist/native/ssr/server/flight-source-node.js +5 -2
  167. package/dist/native/ssr/server/flight-source-node.js.map +1 -1
  168. package/dist/native/ssr/server/flight-source.js +1 -0
  169. package/dist/native/ssr/server/flight-source.js.map +1 -1
  170. package/dist/native/ssr/server/pipeline-interception.js +1 -1
  171. package/dist/native/ssr/server/segment-hash/value-hash.js +162 -0
  172. package/dist/native/ssr/server/segment-hash/value-hash.js.map +1 -0
  173. package/dist/native/ssr/server/ssr-wrappers.js.map +1 -1
  174. package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
  175. package/dist/native/ssr/shared/payload-root.js.map +1 -1
  176. package/dist/plugin-context.d.ts +0 -16
  177. package/dist/plugin-context.d.ts.map +1 -1
  178. package/dist/plugins/build-manifest.d.ts.map +1 -1
  179. package/dist/routing/index.js +2 -2
  180. package/dist/routing/segment-keys.d.ts +8 -21
  181. package/dist/routing/segment-keys.d.ts.map +1 -1
  182. package/dist/server/access-gate.d.ts +0 -14
  183. package/dist/server/access-gate.d.ts.map +1 -1
  184. package/dist/server/als-registry.d.ts +16 -0
  185. package/dist/server/als-registry.d.ts.map +1 -1
  186. package/dist/server/build-manifest.d.ts +1 -10
  187. package/dist/server/build-manifest.d.ts.map +1 -1
  188. package/dist/server/chain-url-parts.d.ts +3 -13
  189. package/dist/server/chain-url-parts.d.ts.map +1 -1
  190. package/dist/server/client-state-tree.d.ts +31 -0
  191. package/dist/server/client-state-tree.d.ts.map +1 -0
  192. package/dist/server/flight-source-node.d.ts +6 -1
  193. package/dist/server/flight-source-node.d.ts.map +1 -1
  194. package/dist/server/flight-source.d.ts +27 -0
  195. package/dist/server/flight-source.d.ts.map +1 -1
  196. package/dist/server/index.js +2 -2
  197. package/dist/server/internal.js +48 -47
  198. package/dist/server/internal.js.map +1 -1
  199. package/dist/server/publish-params.d.ts +5 -4
  200. package/dist/server/publish-params.d.ts.map +1 -1
  201. package/dist/server/route-element-builder.d.ts +4 -19
  202. package/dist/server/route-element-builder.d.ts.map +1 -1
  203. package/dist/server/rsc-entry/helpers.d.ts +7 -13
  204. package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
  205. package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
  206. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
  207. package/dist/server/rsc-entry/rsc-payload.d.ts +1 -2
  208. package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
  209. package/dist/server/rsc-entry/rsc-stream.d.ts +11 -2
  210. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  211. package/dist/server/rsc-entry/ssr-renderer.d.ts +0 -2
  212. package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
  213. package/dist/server/segment-hash/capture.d.ts +77 -0
  214. package/dist/server/segment-hash/capture.d.ts.map +1 -0
  215. package/dist/server/segment-hash/outlet.d.ts +65 -0
  216. package/dist/server/segment-hash/outlet.d.ts.map +1 -0
  217. package/dist/server/segment-hash/stream-tap.d.ts +49 -0
  218. package/dist/server/segment-hash/stream-tap.d.ts.map +1 -0
  219. package/dist/server/segment-hash/value-hash.d.ts +70 -0
  220. package/dist/server/segment-hash/value-hash.d.ts.map +1 -0
  221. package/dist/server/slot-resolver.d.ts +13 -78
  222. package/dist/server/slot-resolver.d.ts.map +1 -1
  223. package/dist/server/ssr-wrappers.d.ts +7 -9
  224. package/dist/server/ssr-wrappers.d.ts.map +1 -1
  225. package/dist/server/vite-handoff-rsc.d.ts +10 -1
  226. package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
  227. package/dist/shared/outlet-decision.d.ts +48 -0
  228. package/dist/shared/outlet-decision.d.ts.map +1 -0
  229. package/dist/shared/payload-root.d.ts +5 -8
  230. package/dist/shared/payload-root.d.ts.map +1 -1
  231. package/dist/shared/segment-info.d.ts +13 -28
  232. package/dist/shared/segment-info.d.ts.map +1 -1
  233. package/package.json +1 -1
  234. package/src/client/browser-entry/action-dispatch.ts +1 -15
  235. package/src/client/browser-entry/hydrate.ts +3 -3
  236. package/src/client/browser-entry/router-init.ts +28 -47
  237. package/src/client/error-boundary.tsx +49 -9
  238. package/src/client/history.ts +4 -5
  239. package/src/client/internal.ts +1 -1
  240. package/src/client/navigation-commit.ts +25 -83
  241. package/src/client/outlet-content-cache.ts +119 -0
  242. package/src/client/outlet-scope-context.ts +42 -0
  243. package/src/client/params-context.ts +11 -12
  244. package/src/client/router-pipeline.ts +10 -74
  245. package/src/client/router-types.ts +11 -26
  246. package/src/client/router.ts +7 -22
  247. package/src/client/rsc-fetch.ts +5 -30
  248. package/src/client/segment-cache.ts +19 -264
  249. package/src/client/segment-outlet.tsx +80 -72
  250. package/src/client/stale-segment.ts +60 -0
  251. package/src/client/use-segment-params.ts +1 -1
  252. package/src/config-types.ts +7 -6
  253. package/src/index.ts +0 -2
  254. package/src/plugin-context.ts +0 -16
  255. package/src/plugins/build-manifest.ts +1 -22
  256. package/src/routing/scanner.ts +12 -0
  257. package/src/routing/segment-keys.ts +9 -35
  258. package/src/rsc-runtime/vendor-types.d.ts +8 -0
  259. package/src/server/access-gate.tsx +3 -32
  260. package/src/server/als-registry.ts +23 -0
  261. package/src/server/build-manifest.ts +1 -11
  262. package/src/server/chain-url-parts.ts +3 -21
  263. package/src/server/client-state-tree.ts +75 -0
  264. package/src/server/flight-source-node.ts +7 -2
  265. package/src/server/flight-source.ts +102 -9
  266. package/src/server/pipeline-interception.ts +1 -1
  267. package/src/server/publish-params.ts +5 -4
  268. package/src/server/route-element-builder.ts +77 -206
  269. package/src/server/rsc-entry/helpers.ts +11 -65
  270. package/src/server/rsc-entry/render-route.ts +54 -28
  271. package/src/server/rsc-entry/revalidate-renderer.ts +2 -1
  272. package/src/server/rsc-entry/rsc-payload.ts +11 -39
  273. package/src/server/rsc-entry/rsc-stream.ts +123 -101
  274. package/src/server/rsc-entry/ssr-renderer.ts +1 -3
  275. package/src/server/segment-hash/capture.ts +232 -0
  276. package/src/server/segment-hash/outlet.ts +185 -0
  277. package/src/server/segment-hash/stream-tap.ts +244 -0
  278. package/src/server/segment-hash/value-hash.ts +338 -0
  279. package/src/server/slot-resolver.ts +37 -323
  280. package/src/server/ssr-wrappers.tsx +7 -9
  281. package/src/server/vite-handoff-rsc.ts +12 -1
  282. package/src/shared/outlet-decision.ts +54 -0
  283. package/src/shared/payload-root.ts +5 -8
  284. package/src/shared/segment-info.ts +13 -28
  285. package/dist/_chunks/chains-CmzbpG-6.js +0 -1
  286. package/dist/_chunks/dev-server--4_Ogy_6.js +0 -1
  287. package/dist/_chunks/dev-span-RsVeYYc_.js.map +0 -1
  288. package/dist/_chunks/error-boundary-Bh-egWUI.js.map +0 -1
  289. package/dist/_chunks/flight-source-node-BsrlUjMO.js.map +0 -1
  290. package/dist/client/segment-update-context.d.ts +0 -15
  291. package/dist/client/segment-update-context.d.ts.map +0 -1
  292. package/dist/client/slot-content-cache-context.d.ts +0 -35
  293. package/dist/client/slot-content-cache-context.d.ts.map +0 -1
  294. package/dist/native/rsc/server/request-dep.js +0 -12
  295. package/dist/native/rsc/server/request-dep.js.map +0 -1
  296. package/dist/native/rsc/server/route-element-helpers.js +0 -20
  297. package/dist/native/rsc/server/route-element-helpers.js.map +0 -1
  298. package/dist/native/rsc/server/skippable-prefix.js +0 -72
  299. package/dist/native/rsc/server/skippable-prefix.js.map +0 -1
  300. package/dist/native/rsc/server/state-tree-diff.js +0 -35
  301. package/dist/native/rsc/server/state-tree-diff.js.map +0 -1
  302. package/dist/native/ssr/client/segment-cache.js +0 -119
  303. package/dist/native/ssr/client/segment-cache.js.map +0 -1
  304. package/dist/native/ssr/client/segment-update-context.js +0 -9
  305. package/dist/native/ssr/client/segment-update-context.js.map +0 -1
  306. package/dist/native/ssr/client/slot-content-cache-context.js +0 -8
  307. package/dist/native/ssr/client/slot-content-cache-context.js.map +0 -1
  308. package/dist/native/ssr/server/state-tree-diff.js +0 -23
  309. package/dist/native/ssr/server/state-tree-diff.js.map +0 -1
  310. package/dist/plugins/request-dep/analysis.d.ts +0 -106
  311. package/dist/plugins/request-dep/analysis.d.ts.map +0 -1
  312. package/dist/plugins/request-dep/index.d.ts +0 -75
  313. package/dist/plugins/request-dep/index.d.ts.map +0 -1
  314. package/dist/plugins/request-dep/origin.d.ts +0 -61
  315. package/dist/plugins/request-dep/origin.d.ts.map +0 -1
  316. package/dist/server/request-dep.d.ts +0 -15
  317. package/dist/server/request-dep.d.ts.map +0 -1
  318. package/dist/server/route-element-helpers.d.ts +0 -12
  319. package/dist/server/route-element-helpers.d.ts.map +0 -1
  320. package/dist/server/skippable-prefix.d.ts +0 -29
  321. package/dist/server/skippable-prefix.d.ts.map +0 -1
  322. package/dist/server/state-tree-diff.d.ts +0 -78
  323. package/dist/server/state-tree-diff.d.ts.map +0 -1
  324. package/src/client/segment-update-context.ts +0 -23
  325. package/src/client/slot-content-cache-context.ts +0 -43
  326. package/src/plugins/request-dep/analysis.ts +0 -447
  327. package/src/plugins/request-dep/index.ts +0 -376
  328. package/src/plugins/request-dep/origin.ts +0 -310
  329. package/src/server/request-dep.ts +0 -37
  330. package/src/server/route-element-helpers.ts +0 -37
  331. package/src/server/skippable-prefix.ts +0 -172
  332. package/src/server/state-tree-diff.ts +0 -132
@@ -0,0 +1,75 @@
1
+ /**
2
+ * Parsing of the client's `X-Timber-State-Tree` request header.
3
+ *
4
+ * The header carries two unrelated things:
5
+ *
6
+ * - `hashes` — the segment hashes the client holds content for, by outlet
7
+ * path. The outlet gates compare them with a capture of each segment and
8
+ * skip the ones that match (design/52-segment-hash-dedupe.md). Read only
9
+ * when the app opted into `clientSegmentCache`.
10
+ * - `treePaths` — the `app/` directory paths of the segments mounted right
11
+ * now, for interception scoping (design/07-routing.md §"Intercepting
12
+ * Routes", TIM-1282).
13
+ *
14
+ * Neither is a security input. A forged hash can only make the server send a
15
+ * skip for content the client claims to hold; the client checks every skip
16
+ * against the hash of what it actually holds, and every `access.ts` runs
17
+ * regardless. See design/13-security.md §"State tree manipulation".
18
+ */
19
+
20
+ import { SEGMENT_HASH_LENGTH } from './segment-hash/value-hash.ts';
21
+ import { swallow } from './logger.ts';
22
+
23
+ /** The parsed header. */
24
+ export interface ClientStateTree {
25
+ /** Segment hashes by outlet path, or null when none were sent. */
26
+ hashes: ReadonlyMap<string, string> | null;
27
+ /** Directory paths of the mounted segments, or null when none were sent. */
28
+ treePaths: ReadonlySet<string> | null;
29
+ }
30
+
31
+ /**
32
+ * More hashes than any route renders outlets. A header past it is not a
33
+ * client's: it is ignored rather than walked.
34
+ */
35
+ const MAX_HASHES = 512;
36
+
37
+ const HASH_SHAPE = new RegExp(`^[A-Za-z0-9_-]{${SEGMENT_HASH_LENGTH}}$`);
38
+
39
+ /**
40
+ * Parse `X-Timber-State-Tree`. Null when the header is missing, malformed, or
41
+ * says nothing. Entries of the wrong shape are dropped, not trusted.
42
+ */
43
+ export function parseClientStateTree(req: Request): ClientStateTree | null {
44
+ const header = req.headers.get('X-Timber-State-Tree');
45
+ if (!header) return null;
46
+
47
+ let parsed: { hashes?: unknown; treePaths?: unknown };
48
+ try {
49
+ parsed = JSON.parse(header) as typeof parsed;
50
+ } catch (err) {
51
+ swallow(err, 'malformed X-Timber-State-Tree header');
52
+ return null;
53
+ }
54
+ if (!parsed || typeof parsed !== 'object') return null;
55
+
56
+ const hashes = new Map<string, string>();
57
+ if (parsed.hashes && typeof parsed.hashes === 'object' && !Array.isArray(parsed.hashes)) {
58
+ const entries = Object.entries(parsed.hashes as Record<string, unknown>);
59
+ if (entries.length <= MAX_HASHES) {
60
+ for (const [path, hash] of entries) {
61
+ if (typeof hash === 'string' && HASH_SHAPE.test(hash)) hashes.set(path, hash);
62
+ }
63
+ }
64
+ }
65
+
66
+ const treePaths = Array.isArray(parsed.treePaths)
67
+ ? new Set(parsed.treePaths.filter((p): p is string => typeof p === 'string'))
68
+ : new Set<string>();
69
+
70
+ if (hashes.size === 0 && treePaths.size === 0) return null;
71
+ return {
72
+ hashes: hashes.size > 0 ? hashes : null,
73
+ treePaths: treePaths.size > 0 ? treePaths : null,
74
+ };
75
+ }
@@ -73,6 +73,8 @@ export interface NodeFlightAbort {
73
73
  signal?: AbortSignal;
74
74
  /** Abort with a `RenderTimeoutError` after this long, if still rendering. */
75
75
  timeoutMs?: number;
76
+ /** Shown every chunk, and the end (`FlightRenderOptions.tap`). */
77
+ tap?: { observe(chunk: Uint8Array): void; end(): void };
76
78
  }
77
79
 
78
80
  /**
@@ -93,7 +95,7 @@ export interface NodeFlightAbort {
93
95
  */
94
96
  export function pipeFlightToNode(
95
97
  flight: PipeableFlight,
96
- { signal, timeoutMs }: NodeFlightAbort
98
+ { signal, timeoutMs, tap }: NodeFlightAbort
97
99
  ): Readable {
98
100
  const scope = new AbortController();
99
101
  const timer =
@@ -106,9 +108,12 @@ export function pipeFlightToNode(
106
108
  const stream = new Transform({
107
109
  objectMode: true,
108
110
  transform(chunk: NodeFlightChunk, _encoding, callback) {
109
- callback(null, typeof chunk === 'string' ? chunk.toWellFormed() : chunk);
111
+ const out = typeof chunk === 'string' ? chunk.toWellFormed() : chunk;
112
+ tap?.observe(typeof out === 'string' ? Buffer.from(out) : out);
113
+ callback(null, out);
110
114
  },
111
115
  destroy(error, callback) {
116
+ tap?.end();
112
117
  endScope(scope);
113
118
  clearTimeout(timer);
114
119
  // Flight ended the stream (React calls `end()` once the render is
@@ -24,6 +24,7 @@
24
24
  import type { Readable } from 'node:stream';
25
25
  import { nodeStreamsPlatform } from './node-streams-platform.ts';
26
26
  import { releaseReason } from './render-utils.ts';
27
+ import { withTimeout } from './render-timeout.ts';
27
28
  import {
28
29
  concatBytes,
29
30
  drainWithDeadline,
@@ -74,6 +75,30 @@ export interface FlightRenderOptions {
74
75
  * themselves.
75
76
  */
76
77
  timeoutMs?: number;
78
+ /**
79
+ * Observes every chunk the render writes, and its end — the segment hash
80
+ * tap (segment-hash/stream-tap.ts). Chunks pass through unchanged.
81
+ */
82
+ tap?: FlightTap;
83
+ /**
84
+ * Values to write as opaque references (`$T<id>`) instead of serializing —
85
+ * Flight's temporary references, keyed by the value. A segment-hash capture
86
+ * writes its nested outlets this way so decoding it can put the live outlet
87
+ * back (segment-hash/capture.ts).
88
+ */
89
+ temporaryReferences?: WeakMap<object, string>;
90
+ /**
91
+ * Prefix for the ids `useId()` returns in server components. Each render
92
+ * counts from zero, so two renders whose output shares one document — the
93
+ * main render and a segment-hash capture — need different prefixes.
94
+ */
95
+ identifierPrefix?: string;
96
+ }
97
+
98
+ /** An observer of a Flight render's output. */
99
+ export interface FlightTap {
100
+ observe(chunk: Uint8Array): void;
101
+ end(): void;
77
102
  }
78
103
 
79
104
  /**
@@ -96,13 +121,22 @@ export type RenderFlight = (model: unknown, options?: FlightRenderOptions) => Fl
96
121
  /** plugin-rsc's `renderToReadableStream`, with the options timber passes. */
97
122
  export type WebFlightRenderer = (
98
123
  model: unknown,
99
- options?: { onError?: (error: unknown) => string | void; signal?: AbortSignal }
124
+ options?: {
125
+ onError?: (error: unknown) => string | void;
126
+ signal?: AbortSignal;
127
+ temporaryReferences?: WeakMap<object, string>;
128
+ identifierPrefix?: string;
129
+ }
100
130
  ) => ReadableStream<Uint8Array>;
101
131
 
102
132
  /** plugin-rsc's `renderToPipeableStream` (`rsc.node`), with the options timber passes. */
103
133
  export type NodeFlightRenderer = (
104
134
  model: unknown,
105
- options?: { onError?: (error: unknown) => string | void }
135
+ options?: {
136
+ onError?: (error: unknown) => string | void;
137
+ temporaryReferences?: WeakMap<object, string>;
138
+ identifierPrefix?: string;
139
+ }
106
140
  ) => import('./flight-source-node.ts').PipeableFlight;
107
141
 
108
142
  /**
@@ -123,15 +157,74 @@ export function createRenderFlight(
123
157
  const { pipeFlightToNode } = requireNodeFlight();
124
158
  return (model, options = {}) => ({
125
159
  kind: 'node',
126
- stream: pipeFlightToNode(node(model, { onError: options.onError }), {
127
- signal: options.signal,
128
- timeoutMs: options.timeoutMs ?? defaultRenderTimeoutMs,
129
- }),
160
+ stream: pipeFlightToNode(
161
+ node(model, {
162
+ onError: options.onError,
163
+ temporaryReferences: options.temporaryReferences,
164
+ identifierPrefix: options.identifierPrefix,
165
+ }),
166
+ {
167
+ signal: options.signal,
168
+ timeoutMs: options.timeoutMs ?? defaultRenderTimeoutMs,
169
+ tap: options.tap,
170
+ }
171
+ ),
130
172
  });
131
173
  }
132
- return (model, options = {}) => ({
133
- kind: 'web',
134
- stream: web(model, { onError: options.onError, signal: options.signal }),
174
+ return (model, options = {}) => {
175
+ const stream = web(model, {
176
+ onError: options.onError,
177
+ signal: options.signal,
178
+ temporaryReferences: options.temporaryReferences,
179
+ identifierPrefix: options.identifierPrefix,
180
+ });
181
+ const timeoutMs = options.timeoutMs ?? defaultRenderTimeoutMs;
182
+ return {
183
+ kind: 'web',
184
+ stream: options.tap ? tapWebFlight(stream, options.tap, timeoutMs) : stream,
185
+ };
186
+ };
187
+ }
188
+
189
+ /**
190
+ * Pass a Web Flight stream through unchanged, showing each chunk to `tap`,
191
+ * and its end — whether it finished, failed, or was cancelled.
192
+ */
193
+ function tapWebFlight(
194
+ source: ReadableStream<Uint8Array>,
195
+ tap: FlightTap,
196
+ timeoutMs: number | undefined
197
+ ): ReadableStream<Uint8Array> {
198
+ const reader = source.getReader();
199
+ // The wrapper reads upstream, so its reads are guarded like every stream
200
+ // read (design/02 §"Always Timeout-Guard Stream Reads"): one deadline for
201
+ // the whole render, after which the upstream is cancelled.
202
+ const deadline = timeoutMs === undefined ? undefined : Date.now() + timeoutMs;
203
+ return new ReadableStream<Uint8Array>({
204
+ async pull(controller) {
205
+ try {
206
+ const read = reader.read();
207
+ const result =
208
+ deadline === undefined
209
+ ? await read
210
+ : await withTimeout(read, Math.max(0, deadline - Date.now()), 'Flight render');
211
+ if (result.done) {
212
+ tap.end();
213
+ controller.close();
214
+ return;
215
+ }
216
+ tap.observe(result.value);
217
+ controller.enqueue(result.value);
218
+ } catch (error) {
219
+ tap.end();
220
+ reader.cancel(releaseReason(error)).catch(() => {});
221
+ controller.error(error);
222
+ }
223
+ },
224
+ cancel(reason) {
225
+ tap.end();
226
+ return reader.cancel(releaseReason(reason));
227
+ },
135
228
  });
136
229
  }
137
230
 
@@ -14,7 +14,7 @@ import type { InterceptionRewrite } from '../routing/interception.ts';
14
14
  import { computeSegmentTreePaths } from '../routing/segment-keys.ts';
15
15
  import { isRscRequest } from '../shared/rsc-media-type.ts';
16
16
  import { canonicalize } from './canonicalize.ts';
17
- import { parseClientStateTree } from './state-tree-diff.ts';
17
+ import { parseClientStateTree } from './client-state-tree.ts';
18
18
  import type { InterceptionContext, PipelineConfig, RouteMatch } from './pipeline.ts';
19
19
  import type { MiddlewareFn } from './middleware-runner.ts';
20
20
  import { collectMiddlewareChain, matchedSegmentPath } from './route-matcher.ts';
@@ -21,10 +21,11 @@ import { getSegmentParamsForClient, getSlotParamsForClient } from './request-con
21
21
  * Build the payload root: the tree, and the params it rendered with beside it.
22
22
  *
23
23
  * The params are a *sibling* of the tree, not a provider around it. A provider
24
- * inside the payload is shadowed by the retained tree's own provider on a
25
- * partial navigation, and its props are not readable at the instant the root
26
- * row resolves — see `shared/payload-root.ts` for both, and TIM-1297. The
27
- * client renders the one provider readers see, above the merge point.
24
+ * inside the payload would not reach a segment the server skipped — the
25
+ * client renders its cached copy, which carries no such provider — and its
26
+ * props are not readable at the instant the root row resolves — see
27
+ * `shared/payload-root.ts` for both, and TIM-1297. The client renders the one
28
+ * provider readers see, above the payload root.
28
29
  *
29
30
  * The records are flattened to plain objects on the way out. Every param
30
31
  * record the framework builds is `Object.create(null)` (design/13-security.md