@timber-js/app 0.2.0-alpha.241 → 0.2.0-alpha.243

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 (331) hide show
  1. package/dist/_chunks/{actions-BCYVyoFl.js → actions-DoTj0Jd3.js} +78 -32
  2. package/dist/_chunks/actions-DoTj0Jd3.js.map +1 -0
  3. package/dist/_chunks/{als-registry-fabsRnPY.js → als-registry-C-iwbtvI.js} +1 -2
  4. package/dist/_chunks/{als-registry-fabsRnPY.js.map → als-registry-C-iwbtvI.js.map} +1 -1
  5. package/dist/_chunks/{cache-api-n5FL4wFs.js → cache-api-D3HmgsFh.js} +5 -5
  6. package/dist/_chunks/{cache-api-n5FL4wFs.js.map → cache-api-D3HmgsFh.js.map} +1 -1
  7. package/dist/_chunks/{chains-IswOWMnq.js → chains-BpvDwp08.js} +2 -2
  8. package/dist/_chunks/{chains-IswOWMnq.js.map → chains-BpvDwp08.js.map} +1 -1
  9. package/dist/_chunks/chains-CjlZZ5ad.js +1 -0
  10. package/dist/_chunks/{classify-B08RCF6s.js → classify-Bbb_lKjH.js} +2 -2
  11. package/dist/_chunks/{classify-B08RCF6s.js.map → classify-Bbb_lKjH.js.map} +1 -1
  12. package/dist/_chunks/{cli-check-tpFb6pBU.js → cli-check-DlQBSKIN.js} +3 -3
  13. package/dist/_chunks/{cli-check-tpFb6pBU.js.map → cli-check-DlQBSKIN.js.map} +1 -1
  14. package/dist/_chunks/{cli-schema-sync-DRNJutey.js → cli-schema-sync-CWkGFlYu.js} +2 -2
  15. package/dist/_chunks/{cli-schema-sync-DRNJutey.js.map → cli-schema-sync-CWkGFlYu.js.map} +1 -1
  16. package/dist/_chunks/{cli-schema-sync-C0pXBtzG.js → cli-schema-sync-Dyvdkv_I.js} +1 -1
  17. package/dist/_chunks/{client-dep-entries-Dw5Dvatr.js → client-dep-entries-Dka67elj.js} +2 -2
  18. package/dist/_chunks/{client-dep-entries-Dw5Dvatr.js.map → client-dep-entries-Dka67elj.js.map} +1 -1
  19. package/dist/_chunks/{convention-lint-BfC_dAhZ.js → convention-lint-CGGcseNn.js} +19 -5
  20. package/dist/_chunks/convention-lint-CGGcseNn.js.map +1 -0
  21. package/dist/_chunks/dev-server-DrjLscqT.js +1 -0
  22. package/dist/_chunks/{dev-server-3R6Bl9_R.js → dev-server-LO4McfQi.js} +3 -4
  23. package/dist/_chunks/dev-server-LO4McfQi.js.map +1 -0
  24. package/dist/_chunks/{error-boundary-Dfhxigko.js → error-boundary-wuNvAJ4n.js} +8 -15
  25. package/dist/_chunks/error-boundary-wuNvAJ4n.js.map +1 -0
  26. package/dist/_chunks/{flight-source-node-QOpWZATb.js → flight-source-node-BeF00Wo_.js} +4 -7
  27. package/dist/_chunks/flight-source-node-BeF00Wo_.js.map +1 -0
  28. package/dist/_chunks/{interception-CtNt9jPt.js → interception-D1dCGNmQ.js} +6 -6
  29. package/dist/_chunks/{interception-CtNt9jPt.js.map → interception-D1dCGNmQ.js.map} +1 -1
  30. package/dist/_chunks/{json-lossy-check-5KFcC1yt.js → json-lossy-check-DpXneTBm.js} +2 -2
  31. package/dist/_chunks/{json-lossy-check-5KFcC1yt.js.map → json-lossy-check-DpXneTBm.js.map} +1 -1
  32. package/dist/_chunks/key-headers-uIig1_mU.js +40 -0
  33. package/dist/_chunks/key-headers-uIig1_mU.js.map +1 -0
  34. package/dist/_chunks/{live-graph-D1dfVqoT.js → live-graph-DXhz6A_X.js} +4 -4
  35. package/dist/_chunks/{live-graph-D1dfVqoT.js.map → live-graph-DXhz6A_X.js.map} +1 -1
  36. package/dist/_chunks/{logger-BvGxPd1e.js → logger-D1sWX2I0.js} +18 -3
  37. package/dist/_chunks/logger-D1sWX2I0.js.map +1 -0
  38. package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
  39. package/dist/_chunks/{node-response-D5cfiyWP.js → node-response-Cp62CtH1.js} +2 -2
  40. package/dist/_chunks/{node-response-D5cfiyWP.js.map → node-response-Cp62CtH1.js.map} +1 -1
  41. package/dist/_chunks/{poison-scan-CX02ilxN.js → poison-scan-DdkJoHvP.js} +2 -2
  42. package/dist/_chunks/{poison-scan-CX02ilxN.js.map → poison-scan-DdkJoHvP.js.map} +1 -1
  43. package/dist/_chunks/{scanner-DneYxQoY.js → scanner-B6V2RqqF.js} +20 -3
  44. package/dist/_chunks/scanner-B6V2RqqF.js.map +1 -0
  45. package/dist/_chunks/{sizeof-BtQ3ErLf.js → sizeof-BKA6qOZq.js} +2 -2
  46. package/dist/_chunks/{sizeof-BtQ3ErLf.js.map → sizeof-BKA6qOZq.js.map} +1 -1
  47. package/dist/_chunks/{walkers-C9R2A4jN.js → walkers-BAZoAlfI.js} +3 -3
  48. package/dist/_chunks/{walkers-C9R2A4jN.js.map → walkers-BAZoAlfI.js.map} +1 -1
  49. package/dist/adapters/cloudflare-kv-cache.js +1 -1
  50. package/dist/analyze/crawl-entry.js +3 -3
  51. package/dist/analyze/graph-command.js +2 -2
  52. package/dist/cache/index.js +2 -2
  53. package/dist/cache/stores/memory.js +1 -1
  54. package/dist/cdn/workers-cache-purge.js +1 -1
  55. package/dist/cli.js +3 -3
  56. package/dist/client/browser-entry/router-init.d.ts +0 -1
  57. package/dist/client/browser-entry/router-init.d.ts.map +1 -1
  58. package/dist/client/document-withdrawal.d.ts +2 -0
  59. package/dist/client/document-withdrawal.d.ts.map +1 -0
  60. package/dist/client/error-boundary.js +1 -1
  61. package/dist/client/index.js +1 -1
  62. package/dist/client/index.js.map +1 -1
  63. package/dist/client/internal.js +3 -5
  64. package/dist/client/internal.js.map +1 -1
  65. package/dist/client/navigation-commit.d.ts +0 -7
  66. package/dist/client/navigation-commit.d.ts.map +1 -1
  67. package/dist/client/outlet-content-cache.d.ts +28 -42
  68. package/dist/client/outlet-content-cache.d.ts.map +1 -1
  69. package/dist/client/outlet-scope-context.d.ts +9 -4
  70. package/dist/client/outlet-scope-context.d.ts.map +1 -1
  71. package/dist/client/params-context.d.ts +1 -1
  72. package/dist/client/router-types.d.ts +3 -13
  73. package/dist/client/router-types.d.ts.map +1 -1
  74. package/dist/client/router.d.ts.map +1 -1
  75. package/dist/client/segment-cache.d.ts +2 -2
  76. package/dist/client/segment-outlet.d.ts +12 -15
  77. package/dist/client/segment-outlet.d.ts.map +1 -1
  78. package/dist/client/stale-segment.d.ts +2 -2
  79. package/dist/config-types.d.ts +2 -18
  80. package/dist/config-types.d.ts.map +1 -1
  81. package/dist/config-validation.d.ts.map +1 -1
  82. package/dist/index.js +7 -8
  83. package/dist/index.js.map +1 -1
  84. package/dist/native/rsc/manifest.json +3 -4
  85. package/dist/native/rsc/routing/segment-keys.js.map +1 -1
  86. package/dist/native/rsc/server/als-registry.js +1 -2
  87. package/dist/native/rsc/server/als-registry.js.map +1 -1
  88. package/dist/native/rsc/server/client-state-tree.js +1 -5
  89. package/dist/native/rsc/server/client-state-tree.js.map +1 -1
  90. package/dist/native/rsc/server/cookie-context.js +7 -7
  91. package/dist/native/rsc/server/cookie-context.js.map +1 -1
  92. package/dist/native/rsc/server/deny-boundary.js +2 -1
  93. package/dist/native/rsc/server/deny-boundary.js.map +1 -1
  94. package/dist/native/rsc/server/dev-overlay-report.js +13 -0
  95. package/dist/native/rsc/server/dev-overlay-report.js.map +1 -0
  96. package/dist/native/rsc/server/flight-source-node.js +2 -5
  97. package/dist/native/rsc/server/flight-source-node.js.map +1 -1
  98. package/dist/native/rsc/server/flight-source.js +6 -41
  99. package/dist/native/rsc/server/flight-source.js.map +1 -1
  100. package/dist/native/rsc/server/framework-stack-frames.js.map +1 -1
  101. package/dist/native/rsc/server/logger.js +6 -1
  102. package/dist/native/rsc/server/logger.js.map +1 -1
  103. package/dist/native/rsc/server/pipeline-interception.js +4 -1
  104. package/dist/native/rsc/server/pipeline-interception.js.map +1 -1
  105. package/dist/native/rsc/server/pipeline.js.map +1 -1
  106. package/dist/native/rsc/server/request-context.js +6 -6
  107. package/dist/native/rsc/server/request-context.js.map +1 -1
  108. package/dist/native/rsc/server/route-element-builder.js +5 -5
  109. package/dist/native/rsc/server/route-element-builder.js.map +1 -1
  110. package/dist/native/rsc/server/rsc-entry/render-route.js +4 -30
  111. package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
  112. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +0 -2
  113. package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
  114. package/dist/native/rsc/server/rsc-entry/rsc-stream.js +2 -5
  115. package/dist/native/rsc/server/rsc-entry/rsc-stream.js.map +1 -1
  116. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js +44 -0
  117. package/dist/native/rsc/server/segment-lifetime/outlet-gate.js.map +1 -0
  118. package/dist/native/rsc/server/segment-lifetime/read-rule.js +45 -12
  119. package/dist/native/rsc/server/segment-lifetime/read-rule.js.map +1 -1
  120. package/dist/native/rsc/server/segment-lifetime/read-scope.js +50 -8
  121. package/dist/native/rsc/server/segment-lifetime/read-scope.js.map +1 -1
  122. package/dist/native/rsc/server/segment-lifetime/segment-key.js +17 -3
  123. package/dist/native/rsc/server/segment-lifetime/segment-key.js.map +1 -1
  124. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js +4 -4
  125. package/dist/native/rsc/server/segment-lifetime/slot-outlets.js.map +1 -1
  126. package/dist/native/rsc/server/slot-resolver.js +8 -7
  127. package/dist/native/rsc/server/slot-resolver.js.map +1 -1
  128. package/dist/native/rsc/server/slot-subtree-contain.js +2 -1
  129. package/dist/native/rsc/server/slot-subtree-contain.js.map +1 -1
  130. package/dist/native/rsc/server/subtree-walk.js +14 -5
  131. package/dist/native/rsc/server/subtree-walk.js.map +1 -1
  132. package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
  133. package/dist/native/rsc/shared/key-headers.js +20 -0
  134. package/dist/native/rsc/shared/key-headers.js.map +1 -0
  135. package/dist/native/rsc/shared/outlet-decision.js.map +1 -1
  136. package/dist/native/ssr/client/document-withdrawal.js +17 -0
  137. package/dist/native/ssr/client/document-withdrawal.js.map +1 -0
  138. package/dist/native/ssr/client/outlet-content-cache.js +10 -25
  139. package/dist/native/ssr/client/outlet-content-cache.js.map +1 -1
  140. package/dist/native/ssr/client/outlet-scope-context.js.map +1 -1
  141. package/dist/native/ssr/client/segment-outlet.js +17 -21
  142. package/dist/native/ssr/client/segment-outlet.js.map +1 -1
  143. package/dist/native/ssr/manifest.json +6 -1
  144. package/dist/native/ssr/server/als-registry.js +0 -1
  145. package/dist/native/ssr/server/als-registry.js.map +1 -1
  146. package/dist/native/ssr/server/client-state-tree.js +1 -5
  147. package/dist/native/ssr/server/client-state-tree.js.map +1 -1
  148. package/dist/native/ssr/server/cookie-context.js +7 -7
  149. package/dist/native/ssr/server/cookie-context.js.map +1 -1
  150. package/dist/native/ssr/server/deny-boundary.js +2 -1
  151. package/dist/native/ssr/server/deny-boundary.js.map +1 -1
  152. package/dist/native/ssr/server/dev-overlay-report.js +6 -0
  153. package/dist/native/ssr/server/dev-overlay-report.js.map +1 -0
  154. package/dist/native/ssr/server/flight-source-node.js +2 -5
  155. package/dist/native/ssr/server/flight-source-node.js.map +1 -1
  156. package/dist/native/ssr/server/flight-source.js +0 -1
  157. package/dist/native/ssr/server/flight-source.js.map +1 -1
  158. package/dist/native/ssr/server/framework-stack-frames.js.map +1 -1
  159. package/dist/native/ssr/server/logger.js +6 -1
  160. package/dist/native/ssr/server/logger.js.map +1 -1
  161. package/dist/native/ssr/server/pipeline-interception.js +4 -1
  162. package/dist/native/ssr/server/pipeline-interception.js.map +1 -1
  163. package/dist/native/ssr/server/pipeline.js.map +1 -1
  164. package/dist/native/ssr/server/request-context.js +6 -6
  165. package/dist/native/ssr/server/request-context.js.map +1 -1
  166. package/dist/native/ssr/server/segment-lifetime/outlet-gate.js +11 -0
  167. package/dist/native/ssr/server/segment-lifetime/outlet-gate.js.map +1 -0
  168. package/dist/native/ssr/server/segment-lifetime/read-rule.js +45 -12
  169. package/dist/native/ssr/server/segment-lifetime/read-rule.js.map +1 -1
  170. package/dist/native/ssr/server/segment-lifetime/read-scope.js +16 -0
  171. package/dist/native/ssr/server/segment-lifetime/read-scope.js.map +1 -0
  172. package/dist/native/ssr/server/subtree-walk.js +149 -0
  173. package/dist/native/ssr/server/subtree-walk.js.map +1 -0
  174. package/dist/native/ssr/server/utils/element-type.js +21 -9
  175. package/dist/native/ssr/server/utils/element-type.js.map +1 -1
  176. package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
  177. package/dist/native/ssr/shared/key-headers.js +13 -0
  178. package/dist/native/ssr/shared/key-headers.js.map +1 -0
  179. package/dist/plugins/entries.d.ts.map +1 -1
  180. package/dist/routing/index.js +3 -3
  181. package/dist/routing/route-options.d.ts.map +1 -1
  182. package/dist/routing/segment-keys.d.ts +3 -4
  183. package/dist/routing/segment-keys.d.ts.map +1 -1
  184. package/dist/routing/slot-placement.d.ts +23 -4
  185. package/dist/routing/slot-placement.d.ts.map +1 -1
  186. package/dist/server/als-registry.d.ts +20 -16
  187. package/dist/server/als-registry.d.ts.map +1 -1
  188. package/dist/server/client-state-tree.d.ts +5 -11
  189. package/dist/server/client-state-tree.d.ts.map +1 -1
  190. package/dist/server/deny-boundary.d.ts.map +1 -1
  191. package/dist/server/dev-overlay-report.d.ts +13 -0
  192. package/dist/server/dev-overlay-report.d.ts.map +1 -0
  193. package/dist/server/flight-source-node.d.ts +1 -6
  194. package/dist/server/flight-source-node.d.ts.map +1 -1
  195. package/dist/server/flight-source.d.ts +0 -27
  196. package/dist/server/flight-source.d.ts.map +1 -1
  197. package/dist/server/framework-stack-frames.d.ts +1 -4
  198. package/dist/server/framework-stack-frames.d.ts.map +1 -1
  199. package/dist/server/index.js +2 -2
  200. package/dist/server/internal.js +105 -26
  201. package/dist/server/internal.js.map +1 -1
  202. package/dist/server/logger.d.ts +10 -0
  203. package/dist/server/logger.d.ts.map +1 -1
  204. package/dist/server/pipeline-interception.d.ts.map +1 -1
  205. package/dist/server/pipeline.d.ts +13 -1
  206. package/dist/server/pipeline.d.ts.map +1 -1
  207. package/dist/server/request-context.d.ts.map +1 -1
  208. package/dist/server/route-element-builder.d.ts +2 -2
  209. package/dist/server/route-element-builder.d.ts.map +1 -1
  210. package/dist/server/rsc-entry/helpers.d.ts +1 -1
  211. package/dist/server/rsc-entry/index.d.ts.map +1 -1
  212. package/dist/server/rsc-entry/render-route.d.ts +0 -1
  213. package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
  214. package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
  215. package/dist/server/rsc-entry/rsc-stream.d.ts +2 -11
  216. package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
  217. package/dist/server/segment-lifetime/outlet-gate.d.ts +58 -0
  218. package/dist/server/segment-lifetime/outlet-gate.d.ts.map +1 -0
  219. package/dist/server/segment-lifetime/read-rule.d.ts +19 -13
  220. package/dist/server/segment-lifetime/read-rule.d.ts.map +1 -1
  221. package/dist/server/segment-lifetime/read-scope.d.ts +48 -6
  222. package/dist/server/segment-lifetime/read-scope.d.ts.map +1 -1
  223. package/dist/server/segment-lifetime/segment-key.d.ts +3 -0
  224. package/dist/server/segment-lifetime/segment-key.d.ts.map +1 -1
  225. package/dist/server/segment-lifetime/slot-outlets.d.ts +3 -3
  226. package/dist/server/segment-lifetime/slot-outlets.d.ts.map +1 -1
  227. package/dist/server/slot-resolver.d.ts +5 -5
  228. package/dist/server/slot-resolver.d.ts.map +1 -1
  229. package/dist/server/slot-subtree-contain.d.ts.map +1 -1
  230. package/dist/server/subtree-walk.d.ts +17 -3
  231. package/dist/server/subtree-walk.d.ts.map +1 -1
  232. package/dist/server/types.d.ts +8 -2
  233. package/dist/server/types.d.ts.map +1 -1
  234. package/dist/server/vite-handoff-rsc.d.ts +3 -10
  235. package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
  236. package/dist/shared/key-headers.d.ts +13 -0
  237. package/dist/shared/key-headers.d.ts.map +1 -0
  238. package/dist/shared/outlet-decision.d.ts +13 -44
  239. package/dist/shared/outlet-decision.d.ts.map +1 -1
  240. package/dist/shared/payload-root.d.ts +1 -1
  241. package/dist/shared/segment-info.d.ts +3 -7
  242. package/dist/shared/segment-info.d.ts.map +1 -1
  243. package/docs/api/30-api-server.mdx +1 -1
  244. package/docs/api/34-api-config.mdx +1 -1
  245. package/package.json +1 -1
  246. package/src/client/browser-entry/index.ts +0 -2
  247. package/src/client/browser-entry/router-init.ts +2 -4
  248. package/src/client/document-withdrawal.tsx +41 -0
  249. package/src/client/error-boundary.tsx +1 -1
  250. package/src/client/navigation-commit.ts +4 -18
  251. package/src/client/outlet-content-cache.ts +38 -60
  252. package/src/client/outlet-scope-context.ts +10 -5
  253. package/src/client/params-context.ts +1 -1
  254. package/src/client/router-types.ts +3 -14
  255. package/src/client/router.ts +0 -2
  256. package/src/client/rsc-fetch.ts +1 -1
  257. package/src/client/segment-cache.ts +2 -2
  258. package/src/client/segment-outlet.tsx +28 -54
  259. package/src/client/stale-segment.ts +2 -2
  260. package/src/config-types.ts +2 -18
  261. package/src/config-validation.ts +0 -1
  262. package/src/plugins/entries.ts +0 -1
  263. package/src/routing/interception.ts +5 -5
  264. package/src/routing/route-options.ts +20 -4
  265. package/src/routing/scanner.ts +1 -1
  266. package/src/routing/segment-keys.ts +3 -4
  267. package/src/routing/slot-placement.ts +41 -4
  268. package/src/rsc-runtime/vendor-types.d.ts +1 -1
  269. package/src/server/als-registry.ts +16 -23
  270. package/src/server/client-state-tree.ts +7 -18
  271. package/src/server/cookie-context.ts +7 -7
  272. package/src/server/deny-boundary.ts +4 -1
  273. package/src/server/dev-overlay-report.ts +22 -0
  274. package/src/server/flight-source-node.ts +1 -5
  275. package/src/server/flight-source.ts +1 -81
  276. package/src/server/framework-stack-frames.ts +1 -4
  277. package/src/server/logger.ts +13 -0
  278. package/src/server/pipeline-interception.ts +11 -2
  279. package/src/server/pipeline.ts +13 -1
  280. package/src/server/request-context.ts +12 -11
  281. package/src/server/route-element-builder.ts +15 -16
  282. package/src/server/rsc-entry/helpers.ts +1 -1
  283. package/src/server/rsc-entry/index.ts +7 -3
  284. package/src/server/rsc-entry/render-route.ts +7 -54
  285. package/src/server/rsc-entry/revalidate-renderer.ts +0 -2
  286. package/src/server/rsc-entry/rsc-stream.ts +3 -23
  287. package/src/server/segment-lifetime/outlet-gate.ts +102 -0
  288. package/src/server/segment-lifetime/read-rule.ts +110 -22
  289. package/src/server/segment-lifetime/read-scope.ts +131 -15
  290. package/src/server/segment-lifetime/segment-key.ts +31 -3
  291. package/src/server/segment-lifetime/slot-outlets.ts +6 -6
  292. package/src/server/slot-resolver.ts +30 -18
  293. package/src/server/slot-subtree-contain.ts +2 -1
  294. package/src/server/subtree-walk.ts +34 -9
  295. package/src/server/types.ts +8 -2
  296. package/src/server/vite-handoff-rsc.ts +3 -12
  297. package/src/shared/key-headers.ts +42 -0
  298. package/src/shared/outlet-decision.ts +13 -48
  299. package/src/shared/payload-root.ts +1 -1
  300. package/src/shared/segment-info.ts +3 -7
  301. package/dist/_chunks/actions-BCYVyoFl.js.map +0 -1
  302. package/dist/_chunks/chains-DPZAMMav.js +0 -1
  303. package/dist/_chunks/convention-lint-BfC_dAhZ.js.map +0 -1
  304. package/dist/_chunks/dev-server-3DNTXQV-.js +0 -1
  305. package/dist/_chunks/dev-server-3R6Bl9_R.js.map +0 -1
  306. package/dist/_chunks/error-boundary-Dfhxigko.js.map +0 -1
  307. package/dist/_chunks/flight-source-node-QOpWZATb.js.map +0 -1
  308. package/dist/_chunks/logger-BvGxPd1e.js.map +0 -1
  309. package/dist/_chunks/scanner-DneYxQoY.js.map +0 -1
  310. package/dist/native/rsc/server/segment-hash/capture.js +0 -107
  311. package/dist/native/rsc/server/segment-hash/capture.js.map +0 -1
  312. package/dist/native/rsc/server/segment-hash/outlet.js +0 -101
  313. package/dist/native/rsc/server/segment-hash/outlet.js.map +0 -1
  314. package/dist/native/rsc/server/segment-hash/stream-tap.js +0 -139
  315. package/dist/native/rsc/server/segment-hash/stream-tap.js.map +0 -1
  316. package/dist/native/rsc/server/segment-hash/value-hash.js +0 -171
  317. package/dist/native/rsc/server/segment-hash/value-hash.js.map +0 -1
  318. package/dist/native/ssr/server/segment-hash/value-hash.js +0 -162
  319. package/dist/native/ssr/server/segment-hash/value-hash.js.map +0 -1
  320. package/dist/server/segment-hash/capture.d.ts +0 -77
  321. package/dist/server/segment-hash/capture.d.ts.map +0 -1
  322. package/dist/server/segment-hash/outlet.d.ts +0 -93
  323. package/dist/server/segment-hash/outlet.d.ts.map +0 -1
  324. package/dist/server/segment-hash/stream-tap.d.ts +0 -49
  325. package/dist/server/segment-hash/stream-tap.d.ts.map +0 -1
  326. package/dist/server/segment-hash/value-hash.d.ts +0 -70
  327. package/dist/server/segment-hash/value-hash.d.ts.map +0 -1
  328. package/src/server/segment-hash/capture.ts +0 -232
  329. package/src/server/segment-hash/outlet.ts +0 -229
  330. package/src/server/segment-hash/stream-tap.ts +0 -244
  331. package/src/server/segment-hash/value-hash.ts +0 -338
@@ -1,171 +0,0 @@
1
- import { createHash } from "node:crypto";
2
- var ELEMENT = new Set([Symbol.for("react.transitional.element"), Symbol.for("react.element")]);
3
- var LAZY = Symbol.for("react.lazy");
4
- var CLIENT_REFERENCE = Symbol.for("react.client.reference");
5
- var SERVER_REFERENCE = Symbol.for("react.server.reference");
6
- var SUSPENSE = Symbol.for("react.suspense");
7
- var UNHASHABLE = Symbol("unhashable");
8
- var BUDGET = 33554432;
9
- var MAX_DEPTH = 1e3;
10
- function hashCanonical(canonical) {
11
- return createHash("sha256").update(canonical).digest("base64url").slice(0, 22);
12
- }
13
- function stripReferenceCacheTag(id) {
14
- return id.replace(/\$\$cache=[^#]*/, "");
15
- }
16
- function isThenable(value) {
17
- return typeof value.then === "function";
18
- }
19
- function hashValue(root, options) {
20
- const nodes = new Map();
21
- const waitFor = [];
22
- let size = 0;
23
- let depth = 0;
24
- let streaming = false;
25
- const emit = (text) => {
26
- size += text.length;
27
- if (size > BUDGET) throw UNHASHABLE;
28
- return text;
29
- };
30
- const node = (object, write) => {
31
- const seen = nodes.get(object);
32
- if (seen !== void 0) return emit("alias(" + seen + ")");
33
- nodes.set(object, nodes.size);
34
- if (++depth > MAX_DEPTH) throw UNHASHABLE;
35
- const out = write();
36
- depth--;
37
- return out;
38
- };
39
- const settled = (thenable) => {
40
- if (thenable.status === "fulfilled") return { value: thenable.value };
41
- if (thenable.status === "rejected") return { error: thenable.reason };
42
- waitFor.push(thenable);
43
- return null;
44
- };
45
- const value = (v) => {
46
- switch (typeof v) {
47
- case "undefined": return emit("u");
48
- case "boolean": return emit(v ? "t" : "f");
49
- case "number": return emit(Object.is(v, -0) ? "n(-0)" : "n(" + String(v) + ")");
50
- case "bigint": return emit("big(" + v.toString() + ")");
51
- case "string": return emit(JSON.stringify(v));
52
- case "symbol": {
53
- const key = Symbol.keyFor(v);
54
- if (key === void 0) throw UNHASHABLE;
55
- if (v === SUSPENSE) streaming = true;
56
- return emit("sym(" + JSON.stringify(key) + ")");
57
- }
58
- case "function": return reference(v);
59
- case "object": return v === null ? emit("null") : object(v);
60
- }
61
- throw UNHASHABLE;
62
- };
63
- const reference = (fn) => {
64
- const ref = fn;
65
- const id = ref.$$id;
66
- if (typeof id !== "string") throw UNHASHABLE;
67
- if (ref.$$typeof === CLIENT_REFERENCE) return emit("client(" + JSON.stringify(stripReferenceCacheTag(id)) + ")");
68
- if (ref.$$typeof === SERVER_REFERENCE) return node(fn, () => emit("server(" + JSON.stringify(stripReferenceCacheTag(id)) + ",") + value(ref.$$bound ?? null) + emit(")"));
69
- throw UNHASHABLE;
70
- };
71
- const object = (o) => {
72
- const tagged = o;
73
- if (tagged.$$typeof !== void 0 && ELEMENT.has(tagged.$$typeof)) return element(o);
74
- if (tagged.$$typeof === LAZY) {
75
- const payload = o._payload;
76
- if (!payload || typeof payload !== "object" || !isThenable(payload)) throw UNHASHABLE;
77
- return node(o, () => {
78
- const result = settled(payload);
79
- if (result === null) return emit("pending");
80
- return "error" in result ? error(result.error) : value(result.value);
81
- });
82
- }
83
- if (tagged.$$typeof === CLIENT_REFERENCE || tagged.$$typeof === SERVER_REFERENCE) return reference(o);
84
- if (isThenable(o)) {
85
- streaming = true;
86
- return node(o, () => {
87
- const result = settled(o);
88
- if (result === null) return emit("promise(pending)");
89
- return "error" in result ? emit("promise(") + error(result.error) + emit(")") : emit("promise(") + value(result.value) + emit(")");
90
- });
91
- }
92
- if (Array.isArray(o)) return node(o, () => emit("[") + o.map((item) => value(item)).join(",") + emit("]"));
93
- if (o instanceof Date) return node(o, () => emit("date(" + String(o.getTime()) + ")"));
94
- if (o instanceof Map) return node(o, () => emit("map(") + [...o].map(([k, item]) => value(k) + emit(":") + value(item)).join(",") + emit(")"));
95
- if (o instanceof Set) return node(o, () => emit("set(") + [...o].map((item) => value(item)).join(",") + emit(")"));
96
- if (o instanceof ArrayBuffer) return node(o, () => emit("buffer(" + bytes(new Uint8Array(o)) + ")"));
97
- if (ArrayBuffer.isView(o)) {
98
- const view = new Uint8Array(o.buffer, o.byteOffset, o.byteLength);
99
- return node(o, () => emit("view(" + o.constructor.name + "," + bytes(view) + ")"));
100
- }
101
- if (o instanceof Error) return node(o, () => error(o));
102
- const proto = Object.getPrototypeOf(o);
103
- if (proto !== Object.prototype && proto !== null) throw UNHASHABLE;
104
- return node(o, () => emit("{") + Object.keys(o).map((k) => emit(JSON.stringify(k) + ":") + value(o[k])).join(",") + emit("}"));
105
- };
106
- const element = (el) => {
107
- const { key, props } = el;
108
- let type = el.type;
109
- const lazyType = type;
110
- if (lazyType && typeof lazyType === "object" && lazyType.$$typeof === LAZY) {
111
- const payload = lazyType._payload;
112
- if (!payload || typeof payload !== "object" || !isThenable(payload)) throw UNHASHABLE;
113
- const result = settled(payload);
114
- if (result === null) return emit("pending");
115
- if ("error" in result) return error(result.error);
116
- type = result.value;
117
- }
118
- if (options.isOutlet(type)) {
119
- const segmentPath = props && typeof props === "object" ? props.segmentPath : void 0;
120
- return emit("hole(" + JSON.stringify(segmentPath ?? null) + "," + JSON.stringify(key ?? null) + ")");
121
- }
122
- return node(el, () => emit("el(") + value(type) + emit("," + JSON.stringify(key ?? null) + ",") + value(props) + emit(")"));
123
- };
124
- const error = (e) => {
125
- if (!(e instanceof Error)) return emit("error(") + value(e) + emit(")");
126
- const fields = e;
127
- let out = emit("error(" + JSON.stringify([
128
- e.name,
129
- e.message,
130
- typeof fields.digest === "string" ? fields.digest : null,
131
- typeof e.stack === "string" ? e.stack : null,
132
- typeof fields.environmentName === "string" ? fields.environmentName : null
133
- ]));
134
- if ("cause" in e) out += emit(",cause:") + value(e.cause);
135
- if (Array.isArray(fields.errors)) out += emit(",errors:") + value(fields.errors);
136
- return out + emit(")");
137
- };
138
- try {
139
- const canonical = value(root);
140
- if (waitFor.length > 0) return {
141
- status: "pending",
142
- streaming,
143
- waitFor
144
- };
145
- return {
146
- status: "complete",
147
- hash: hashCanonical(canonical),
148
- streaming
149
- };
150
- } catch (thrown) {
151
- if (thrown === UNHASHABLE) return { status: "unhashable" };
152
- throw thrown;
153
- }
154
- }
155
- function bytes(view) {
156
- let binary = "";
157
- for (let i = 0; i < view.length; i++) binary += String.fromCharCode(view[i]);
158
- return btoa(binary);
159
- }
160
- async function hashSettledValue(root, options, signal) {
161
- for (;;) {
162
- if (signal.aborted) return null;
163
- const outcome = hashValue(root, options);
164
- if (outcome.status === "complete") return outcome.hash;
165
- if (outcome.status === "unhashable") return null;
166
- await Promise.allSettled(outcome.waitFor.map((t) => Promise.resolve(t)));
167
- }
168
- }
169
- export { hashCanonical, hashSettledValue, hashValue, stripReferenceCacheTag };
170
-
171
- //# sourceMappingURL=value-hash.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"value-hash.js","names":[],"sources":["../../../../../src/server/segment-hash/value-hash.ts"],"mappings":";AAgDA,IAAM,UAAU,IAAI,IAAI,CAAC,OAAO,IAAI,4BAA4B,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC;AAC/F,IAAM,OAAO,OAAO,IAAI,YAAY;AACpC,IAAM,mBAAmB,OAAO,IAAI,wBAAwB;AAC5D,IAAM,mBAAmB,OAAO,IAAI,wBAAwB;AAC5D,IAAM,WAAW,OAAO,IAAI,gBAAgB;AAG5C,IAAM,aAAa,OAAO,YAAY;AAOtC,IAAM,SAAS;AAQf,IAAM,YAAY;AAElB,SAAgB,cAAc,WAA2B;CACvD,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,GAAA,EAAsB;AAChG;AAQA,SAAgB,uBAAuB,IAAoB;CACzD,OAAO,GAAG,QAAQ,mBAAmB,EAAE;AACzC;AAUA,SAAS,WAAW,OAAkC;CACpD,OAAO,OAAQ,MAA6B,SAAS;AACvD;AAGA,SAAgB,UAAU,MAAe,SAA6C;CACpF,MAAM,QAAQ,IAAI,IAAoB;CACtC,MAAM,UAAkC,CAAC;CACzC,IAAI,OAAO;CACX,IAAI,QAAQ;CACZ,IAAI,YAAY;CAEhB,MAAM,QAAQ,SAAyB;EACrC,QAAQ,KAAK;EACb,IAAI,OAAO,QAAQ,MAAM;EACzB,OAAO;CACT;CAEA,MAAM,QAAQ,QAAgB,UAAgC;EAC5D,MAAM,OAAO,MAAM,IAAI,MAAM;EAC7B,IAAI,SAAS,QAAW,OAAO,KAAK,WAAW,OAAO,GAAG;EACzD,MAAM,IAAI,QAAQ,MAAM,IAAI;EAC5B,IAAI,EAAE,QAAQ,WAAW,MAAM;EAC/B,MAAM,MAAM,MAAM;EAClB;EACA,OAAO;CACT;CAGA,MAAM,WAAW,aAAuE;EACtF,IAAI,SAAS,WAAW,aAAa,OAAO,EAAE,OAAO,SAAS,MAAM;EACpE,IAAI,SAAS,WAAW,YAAY,OAAO,EAAE,OAAO,SAAS,OAAO;EACpE,QAAQ,KAAK,QAAgC;EAC7C,OAAO;CACT;CAEA,MAAM,SAAS,MAAuB;EACpC,QAAQ,OAAO,GAAf;GACE,KAAK,aACH,OAAO,KAAK,GAAG;GACjB,KAAK,WACH,OAAO,KAAK,IAAI,MAAM,GAAG;GAC3B,KAAK,UACH,OAAO,KAAK,OAAO,GAAG,GAAG,EAAE,IAAI,UAAU,OAAO,OAAO,CAAC,IAAI,GAAG;GACjE,KAAK,UACH,OAAO,KAAK,SAAS,EAAE,SAAS,IAAI,GAAG;GACzC,KAAK,UACH,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC;GAC/B,KAAK,UAAU;IACb,MAAM,MAAM,OAAO,OAAO,CAAC;IAC3B,IAAI,QAAQ,QAAW,MAAM;IAC7B,IAAI,MAAM,UAAU,YAAY;IAChC,OAAO,KAAK,SAAS,KAAK,UAAU,GAAG,IAAI,GAAG;GAChD;GACA,KAAK,YACH,OAAO,UAAU,CAAC;GACpB,KAAK,UACH,OAAO,MAAM,OAAO,KAAK,MAAM,IAAI,OAAO,CAAC;EAC/C;EACA,MAAM;CACR;CAEA,MAAM,aAAa,OAAuB;EACxC,MAAM,MAAM;EACZ,MAAM,KAAK,IAAI;EACf,IAAI,OAAO,OAAO,UAAU,MAAM;EAClC,IAAI,IAAI,aAAa,kBACnB,OAAO,KAAK,YAAY,KAAK,UAAU,uBAAuB,EAAE,CAAC,IAAI,GAAG;EAE1E,IAAI,IAAI,aAAa,kBACnB,OAAO,KACL,UAEE,KAAK,YAAY,KAAK,UAAU,uBAAuB,EAAE,CAAC,IAAI,GAAG,IACjE,MAAM,IAAI,WAAW,IAAI,IACzB,KAAK,GAAG,CACZ;EAEF,MAAM;CACR;CAEA,MAAM,UAAU,MAAsB;EACpC,MAAM,SAAS;EACf,IAAI,OAAO,aAAa,UAAa,QAAQ,IAAI,OAAO,QAAkB,GAAG,OAAO,QAAQ,CAAC;EAC7F,IAAI,OAAO,aAAa,MAAM;GAC5B,MAAM,UAAW,EAA6B;GAC9C,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,CAAC,WAAW,OAAO,GAAG,MAAM;GAE3E,OAAO,KAAK,SAAS;IACnB,MAAM,SAAS,QAAQ,OAAO;IAC9B,IAAI,WAAW,MAAM,OAAO,KAAK,SAAS;IAC1C,OAAO,WAAW,SAAS,MAAM,OAAO,KAAK,IAAI,MAAM,OAAO,KAAK;GACrE,CAAC;EACH;EACA,IAAI,OAAO,aAAa,oBAAoB,OAAO,aAAa,kBAC9D,OAAO,UAAU,CAAC;EAEpB,IAAI,WAAW,CAAC,GAAG;GAGjB,YAAY;GACZ,OAAO,KAAK,SAAS;IACnB,MAAM,SAAS,QAAQ,CAAC;IACxB,IAAI,WAAW,MAAM,OAAO,KAAK,kBAAkB;IACnD,OAAO,WAAW,SACd,KAAK,UAAU,IAAI,MAAM,OAAO,KAAK,IAAI,KAAK,GAAG,IACjD,KAAK,UAAU,IAAI,MAAM,OAAO,KAAK,IAAI,KAAK,GAAG;GACvD,CAAC;EACH;EACA,IAAI,MAAM,QAAQ,CAAC,GACjB,OAAO,KAAK,SAAS,KAAK,GAAG,IAAI,EAAE,KAAK,SAAS,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;EAErF,IAAI,aAAa,MAAM,OAAO,KAAK,SAAS,KAAK,UAAU,OAAO,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC;EACrF,IAAI,aAAa,KACf,OAAO,KACL,SAEE,KAAK,MAAM,IACX,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,UAAU,MAAM,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IACtE,KAAK,GAAG,CACZ;EAEF,IAAI,aAAa,KACf,OAAO,KAAK,SAAS,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;EAE7F,IAAI,aAAa,aACf,OAAO,KAAK,SAAS,KAAK,YAAY,MAAM,IAAI,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC;EAEvE,IAAI,YAAY,OAAO,CAAC,GAAG;GACzB,MAAM,OAAO,IAAI,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU;GAChE,OAAO,KAAK,SAAS,KAAK,UAAU,EAAE,YAAY,OAAO,MAAM,MAAM,IAAI,IAAI,GAAG,CAAC;EACnF;EACA,IAAI,aAAa,OAAO,OAAO,KAAK,SAAS,MAAM,CAAC,CAAC;EACrD,MAAM,QAAQ,OAAO,eAAe,CAAC;EACrC,IAAI,UAAU,OAAO,aAAa,UAAU,MAAM,MAAM;EAIxD,OAAO,KACL,SAEE,KAAK,GAAG,IACR,OAAO,KAAK,CAAC,CAAC,CACX,KAAK,MAAM,KAAK,KAAK,UAAU,CAAC,IAAI,GAAG,IAAI,MAAO,EAA8B,EAAE,CAAC,CAAC,CACpF,KAAK,GAAG,IACX,KAAK,GAAG,CACZ;CACF;CAEA,MAAM,WAAW,OAAuB;EACtC,MAAM,EAAE,KAAK,UAAU;EAGvB,IAAI,OAAQ,GAAyB;EACrC,MAAM,WAAW;EACjB,IAAI,YAAY,OAAO,aAAa,YAAY,SAAS,aAAa,MAAM;GAC1E,MAAM,UAAU,SAAS;GACzB,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,CAAC,WAAW,OAAO,GAAG,MAAM;GAC3E,MAAM,SAAS,QAAQ,OAAO;GAC9B,IAAI,WAAW,MAAM,OAAO,KAAK,SAAS;GAC1C,IAAI,WAAW,QAAQ,OAAO,MAAM,OAAO,KAAK;GAChD,OAAO,OAAO;EAChB;EACA,IAAI,QAAQ,SAAS,IAAI,GAAG;GAC1B,MAAM,cACJ,SAAS,OAAO,UAAU,WACrB,MAAoC,cACrC;GAGN,OAAO,KACL,UAAU,KAAK,UAAU,eAAe,IAAI,IAAI,MAAM,KAAK,UAAU,OAAO,IAAI,IAAI,GACtF;EACF;EACA,OAAO,KACL,UAEE,KAAK,KAAK,IACV,MAAM,IAAI,IACV,KAAK,MAAM,KAAK,UAAU,OAAO,IAAI,IAAI,GAAG,IAC5C,MAAM,KAAK,IACX,KAAK,GAAG,CACZ;CACF;CASA,MAAM,SAAS,MAAuB;EACpC,IAAI,EAAE,aAAa,QAAQ,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG;EACtE,MAAM,SAAS;EACf,IAAI,MAAM,KACR,WACE,KAAK,UAAU;GACb,EAAE;GACF,EAAE;GACF,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS;GACpD,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ;GACxC,OAAO,OAAO,oBAAoB,WAAW,OAAO,kBAAkB;EACxE,CAAC,CACL;EACA,IAAI,WAAW,GAAG,OAAO,KAAK,SAAS,IAAI,MAAM,EAAE,KAAK;EACxD,IAAI,MAAM,QAAQ,OAAO,MAAM,GAAG,OAAO,KAAK,UAAU,IAAI,MAAM,OAAO,MAAM;EAC/E,OAAO,MAAM,KAAK,GAAG;CACvB;CAEA,IAAI;EACF,MAAM,YAAY,MAAM,IAAI;EAC5B,IAAI,QAAQ,SAAS,GAAG,OAAO;GAAE,QAAQ;GAAW;GAAW;EAAQ;EACvE,OAAO;GAAE,QAAQ;GAAY,MAAM,cAAc,SAAS;GAAG;EAAU;CACzE,SAAS,QAAQ;EACf,IAAI,WAAW,YAAY,OAAO,EAAE,QAAQ,aAAa;EACzD,MAAM;CACR;AACF;AAEA,SAAS,MAAM,MAA0B;CACvC,IAAI,SAAS;CACb,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK,UAAU,OAAO,aAAa,KAAK,EAAE;CAC3E,OAAO,KAAK,MAAM;AACpB;AAMA,eAAsB,iBACpB,MACA,SACA,QACwB;CACxB,SAAS;EACP,IAAI,OAAO,SAAS,OAAO;EAC3B,MAAM,UAAU,UAAU,MAAM,OAAO;EACvC,IAAI,QAAQ,WAAW,YAAY,OAAO,QAAQ;EAClD,IAAI,QAAQ,WAAW,cAAc,OAAO;EAE5C,MAAM,QAAQ,WAAW,QAAQ,QAAQ,KAAK,MAAM,QAAQ,QAAQ,CAAC,CAAC,CAAC;CACzE;AACF"}
@@ -1,162 +0,0 @@
1
- import { createHash } from "node:crypto";
2
- var ELEMENT = new Set([Symbol.for("react.transitional.element"), Symbol.for("react.element")]);
3
- var LAZY = Symbol.for("react.lazy");
4
- var CLIENT_REFERENCE = Symbol.for("react.client.reference");
5
- var SERVER_REFERENCE = Symbol.for("react.server.reference");
6
- var SUSPENSE = Symbol.for("react.suspense");
7
- var UNHASHABLE = Symbol("unhashable");
8
- var BUDGET = 33554432;
9
- var MAX_DEPTH = 1e3;
10
- function hashCanonical(canonical) {
11
- return createHash("sha256").update(canonical).digest("base64url").slice(0, 22);
12
- }
13
- function stripReferenceCacheTag(id) {
14
- return id.replace(/\$\$cache=[^#]*/, "");
15
- }
16
- function isThenable(value) {
17
- return typeof value.then === "function";
18
- }
19
- function hashValue(root, options) {
20
- const nodes = new Map();
21
- const waitFor = [];
22
- let size = 0;
23
- let depth = 0;
24
- let streaming = false;
25
- const emit = (text) => {
26
- size += text.length;
27
- if (size > BUDGET) throw UNHASHABLE;
28
- return text;
29
- };
30
- const node = (object, write) => {
31
- const seen = nodes.get(object);
32
- if (seen !== void 0) return emit("alias(" + seen + ")");
33
- nodes.set(object, nodes.size);
34
- if (++depth > MAX_DEPTH) throw UNHASHABLE;
35
- const out = write();
36
- depth--;
37
- return out;
38
- };
39
- const settled = (thenable) => {
40
- if (thenable.status === "fulfilled") return { value: thenable.value };
41
- if (thenable.status === "rejected") return { error: thenable.reason };
42
- waitFor.push(thenable);
43
- return null;
44
- };
45
- const value = (v) => {
46
- switch (typeof v) {
47
- case "undefined": return emit("u");
48
- case "boolean": return emit(v ? "t" : "f");
49
- case "number": return emit(Object.is(v, -0) ? "n(-0)" : "n(" + String(v) + ")");
50
- case "bigint": return emit("big(" + v.toString() + ")");
51
- case "string": return emit(JSON.stringify(v));
52
- case "symbol": {
53
- const key = Symbol.keyFor(v);
54
- if (key === void 0) throw UNHASHABLE;
55
- if (v === SUSPENSE) streaming = true;
56
- return emit("sym(" + JSON.stringify(key) + ")");
57
- }
58
- case "function": return reference(v);
59
- case "object": return v === null ? emit("null") : object(v);
60
- }
61
- throw UNHASHABLE;
62
- };
63
- const reference = (fn) => {
64
- const ref = fn;
65
- const id = ref.$$id;
66
- if (typeof id !== "string") throw UNHASHABLE;
67
- if (ref.$$typeof === CLIENT_REFERENCE) return emit("client(" + JSON.stringify(stripReferenceCacheTag(id)) + ")");
68
- if (ref.$$typeof === SERVER_REFERENCE) return node(fn, () => emit("server(" + JSON.stringify(stripReferenceCacheTag(id)) + ",") + value(ref.$$bound ?? null) + emit(")"));
69
- throw UNHASHABLE;
70
- };
71
- const object = (o) => {
72
- const tagged = o;
73
- if (tagged.$$typeof !== void 0 && ELEMENT.has(tagged.$$typeof)) return element(o);
74
- if (tagged.$$typeof === LAZY) {
75
- const payload = o._payload;
76
- if (!payload || typeof payload !== "object" || !isThenable(payload)) throw UNHASHABLE;
77
- return node(o, () => {
78
- const result = settled(payload);
79
- if (result === null) return emit("pending");
80
- return "error" in result ? error(result.error) : value(result.value);
81
- });
82
- }
83
- if (tagged.$$typeof === CLIENT_REFERENCE || tagged.$$typeof === SERVER_REFERENCE) return reference(o);
84
- if (isThenable(o)) {
85
- streaming = true;
86
- return node(o, () => {
87
- const result = settled(o);
88
- if (result === null) return emit("promise(pending)");
89
- return "error" in result ? emit("promise(") + error(result.error) + emit(")") : emit("promise(") + value(result.value) + emit(")");
90
- });
91
- }
92
- if (Array.isArray(o)) return node(o, () => emit("[") + o.map((item) => value(item)).join(",") + emit("]"));
93
- if (o instanceof Date) return node(o, () => emit("date(" + String(o.getTime()) + ")"));
94
- if (o instanceof Map) return node(o, () => emit("map(") + [...o].map(([k, item]) => value(k) + emit(":") + value(item)).join(",") + emit(")"));
95
- if (o instanceof Set) return node(o, () => emit("set(") + [...o].map((item) => value(item)).join(",") + emit(")"));
96
- if (o instanceof ArrayBuffer) return node(o, () => emit("buffer(" + bytes(new Uint8Array(o)) + ")"));
97
- if (ArrayBuffer.isView(o)) {
98
- const view = new Uint8Array(o.buffer, o.byteOffset, o.byteLength);
99
- return node(o, () => emit("view(" + o.constructor.name + "," + bytes(view) + ")"));
100
- }
101
- if (o instanceof Error) return node(o, () => error(o));
102
- const proto = Object.getPrototypeOf(o);
103
- if (proto !== Object.prototype && proto !== null) throw UNHASHABLE;
104
- return node(o, () => emit("{") + Object.keys(o).map((k) => emit(JSON.stringify(k) + ":") + value(o[k])).join(",") + emit("}"));
105
- };
106
- const element = (el) => {
107
- const { key, props } = el;
108
- let type = el.type;
109
- const lazyType = type;
110
- if (lazyType && typeof lazyType === "object" && lazyType.$$typeof === LAZY) {
111
- const payload = lazyType._payload;
112
- if (!payload || typeof payload !== "object" || !isThenable(payload)) throw UNHASHABLE;
113
- const result = settled(payload);
114
- if (result === null) return emit("pending");
115
- if ("error" in result) return error(result.error);
116
- type = result.value;
117
- }
118
- if (options.isOutlet(type)) {
119
- const segmentPath = props && typeof props === "object" ? props.segmentPath : void 0;
120
- return emit("hole(" + JSON.stringify(segmentPath ?? null) + "," + JSON.stringify(key ?? null) + ")");
121
- }
122
- return node(el, () => emit("el(") + value(type) + emit("," + JSON.stringify(key ?? null) + ",") + value(props) + emit(")"));
123
- };
124
- const error = (e) => {
125
- if (!(e instanceof Error)) return emit("error(") + value(e) + emit(")");
126
- const fields = e;
127
- let out = emit("error(" + JSON.stringify([
128
- e.name,
129
- e.message,
130
- typeof fields.digest === "string" ? fields.digest : null,
131
- typeof e.stack === "string" ? e.stack : null,
132
- typeof fields.environmentName === "string" ? fields.environmentName : null
133
- ]));
134
- if ("cause" in e) out += emit(",cause:") + value(e.cause);
135
- if (Array.isArray(fields.errors)) out += emit(",errors:") + value(fields.errors);
136
- return out + emit(")");
137
- };
138
- try {
139
- const canonical = value(root);
140
- if (waitFor.length > 0) return {
141
- status: "pending",
142
- streaming,
143
- waitFor
144
- };
145
- return {
146
- status: "complete",
147
- hash: hashCanonical(canonical),
148
- streaming
149
- };
150
- } catch (thrown) {
151
- if (thrown === UNHASHABLE) return { status: "unhashable" };
152
- throw thrown;
153
- }
154
- }
155
- function bytes(view) {
156
- let binary = "";
157
- for (let i = 0; i < view.length; i++) binary += String.fromCharCode(view[i]);
158
- return btoa(binary);
159
- }
160
- export { hashCanonical, hashValue, stripReferenceCacheTag };
161
-
162
- //# sourceMappingURL=value-hash.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"value-hash.js","names":[],"sources":["../../../../../src/server/segment-hash/value-hash.ts"],"mappings":"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"}
@@ -1,77 +0,0 @@
1
- /**
2
- * The capture: a segment rendered on its own Flight stream, inside the current
3
- * request — the segment's one and only render.
4
- *
5
- * The outlet gate captures a segment when the client advertised a hash for it.
6
- * The capture is decoded as it streams by React's own Flight client in the
7
- * RSC environment, and the decoded value graph is hashed (value-hash.ts):
8
- *
9
- * - its hash equals the client's → a skip, and the decoded tree is dropped;
10
- * - it differs → the decoded tree is emitted as the segment's live content.
11
- * Nothing is rendered a second time: server components already ran, and the
12
- * main render only serializes what they produced.
13
- *
14
- * A capture that reaches a Suspense boundary or a promise prop still pending
15
- * is not waited on (the shell rule is not built): its decoded tree is emitted
16
- * live at once and the pending content streams when it would have anyway.
17
- *
18
- * Nested outlets are holes. Each renders as a `SegmentOutlet` whose decision is
19
- * an opaque marker, written as a Flight temporary reference. Decoding
20
- * replaces it with a lazy decision for the nested segment, made only if the
21
- * decoded tree is sent — a skip decides the nested segments itself.
22
- *
23
- * Because the capture is the render, it writes request state (metadata
24
- * entries, deny status) directly, and reports errors through the main
25
- * render's error handler. An error decoded into the live content keeps its
26
- * digest: the main render passes it through rather than reporting it again.
27
- *
28
- * See design/52-segment-hash-dedupe.md §"Capture".
29
- */
30
- import { type ReactNode } from 'react';
31
- import type { CaptureHole, OutletDecisionValue } from '../../shared/outlet-decision.ts';
32
- /**
33
- * Inside a capture render, the marker a nested outlet renders with in place of
34
- * its decision; undefined outside one.
35
- */
36
- export declare function captureHoleMarker(segmentPath: string): CaptureHole | undefined;
37
- export interface CaptureOptions {
38
- /** The segment captured — its `useId()` prefix derives from it. */
39
- segmentPath: string;
40
- /** Upper bound on the whole capture stream. */
41
- timeoutMs: number;
42
- /** The request's signal — a disconnect abandons the capture. */
43
- signal?: AbortSignal;
44
- /** Subscribes to the main render's end — a capture never outlives it. */
45
- onRenderEnd?: (cancel: () => void) => () => void;
46
- /** The main render's error handler: its digests, signals and reports. */
47
- onError?: (error: unknown) => string | void;
48
- /** Whether a decoded element type is timber's `SegmentOutlet`. */
49
- isOutlet: (type: unknown) => boolean;
50
- /** The decision for a nested outlet, made only if the capture is sent live. */
51
- decideHole: (segmentPath: string) => OutletDecisionValue | undefined;
52
- }
53
- /** What a capture found, as soon as it can say. */
54
- export type SegmentCapture =
55
- /** Everything the segment reaches settled: its hash is known. */
56
- {
57
- kind: 'complete';
58
- hash: string;
59
- /**
60
- * The nested outlets that rendered as holes. One missing here was not
61
- * rendered — an access gate above it denied — and a skip must not decide
62
- * it: deciding renders its content.
63
- */
64
- holes: ReadonlySet<string>;
65
- /** The decoded content, to send if the segment is not skipped. */
66
- content: ReactNode;
67
- /** The segment is skipped: stop reading the capture. */
68
- discard(): void;
69
- }
70
- /** Not waited for — still streaming, or not hashable. Send it live. */
71
- | {
72
- kind: 'live';
73
- content: ReactNode;
74
- };
75
- /** Render `content` as a capture. Settles once its hash is known or not waited for. */
76
- export declare function captureSegment(content: ReactNode, options: CaptureOptions): Promise<SegmentCapture>;
77
- //# sourceMappingURL=capture.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/server/segment-hash/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKtD,OAAO,KAAK,EACV,WAAW,EAEX,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAGzC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE9E;AAOD,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yEAAyE;IACzE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACjD,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,+EAA+E;IAC/E,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,mBAAmB,GAAG,SAAS,CAAC;CACtE;AAED,mDAAmD;AACnD,MAAM,MAAM,cAAc;AACxB,iEAAiE;AAC/D;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,kEAAkE;IAClE,OAAO,EAAE,SAAS,CAAC;IACnB,wDAAwD;IACxD,OAAO,IAAI,IAAI,CAAC;CACjB;AACH,uEAAuE;GACrE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAsBzC,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,CAAC,CAkHzB"}
@@ -1,93 +0,0 @@
1
- /**
2
- * The outlet gate: renders one segment as a `SegmentOutlet` whose decision is
3
- * either its live content or a skip.
4
- *
5
- * Every segment renders on every navigation; access runs for every one. What
6
- * hash dedupe saves is bytes: when the client advertised a hash for a segment,
7
- * the gate captures the segment (capture.ts), and if the capture's hash
8
- * equals the client's, the segment is sent as a skip — the client keeps the
9
- * content it holds. Otherwise the live content is sent with a hash the client
10
- * stores beside it (stream-tap.ts). Nothing is predicted: a skip happens only
11
- * when a render the server just ran produced exactly what the client holds.
12
- *
13
- * A skip carries the decisions of the segments nested directly inside it —
14
- * only those the capture rendered as holes. Their access gates ran in the
15
- * capture; a nested gate that denied rendered its deny page instead of the
16
- * hole, so its segment is never decided, never rendered, never sent.
17
- *
18
- * A `'document'` segment (design/53-segment-lifetime.md) is decided before
19
- * any of that, and never captured: when the client holds content rendered
20
- * under the current key digest, the segment is skipped **without rendering**,
21
- * and its nested outlets are decided as if it had rendered — lifetime does
22
- * not cascade. Otherwise it is sent live with the digest it rendered under.
23
- *
24
- * See design/52-segment-hash-dedupe.md §"Mechanism".
25
- */
26
- import { type ReactElement, type ReactNode } from 'react';
27
- import type { SegmentHashTap } from './stream-tap.ts';
28
- import type { DocumentKeys, DocumentOutlet } from '../segment-lifetime/document-outlet.ts';
29
- import type { SegmentLifetime } from '../types.ts';
30
- /** One outlet in the element tree, and the outlets directly inside it. */
31
- export interface OutletSpec {
32
- segmentPath: string;
33
- content: ReactNode;
34
- nested: OutletSpec[];
35
- /** Set on a `'document'` segment's outlet when the render can issue digests. */
36
- document?: DocumentOutlet;
37
- }
38
- /** Per-request inputs to every gate in one render. */
39
- export interface SegmentHashRender {
40
- /** The hashes the client advertised (`X-Timber-State-Tree`), by path. */
41
- clientHashes: ReadonlyMap<string, string> | null;
42
- /** Hashes the outgoing stream; null when `clientSegmentCache` is off. */
43
- tap: SegmentHashTap | null;
44
- /**
45
- * Bounds each capture's stream. A capture also ends with the main render
46
- * (`tap.onEnd`), which usually comes first.
47
- */
48
- captureTimeoutMs: number;
49
- /**
50
- * The main render's error handler. A capture is a segment's render, so its
51
- * errors are the render's: reported, digested and signalled once, there.
52
- */
53
- onCaptureError?: (error: unknown) => string | void;
54
- signal?: AbortSignal;
55
- /**
56
- * Key digests for `'document'` segments: the client's, and the signer that
57
- * issues and checks them. Null when no client router can hold a segment.
58
- */
59
- documents: DocumentKeys | null;
60
- /**
61
- * The lifetime of a layout that declares none: the app's
62
- * `defaultLayoutLifetime` (design/53 §"App-wide default"). Pages always
63
- * default to `'request'`.
64
- */
65
- defaultLayoutLifetime: SegmentLifetime;
66
- }
67
- /** A render with dedupe off: every segment live, no hashes. */
68
- export declare const NO_SEGMENT_HASHING: SegmentHashRender;
69
- /**
70
- * Whether a decoded element type is timber's `SegmentOutlet` client
71
- * reference. Matched by reference id — module and export — so an app
72
- * component that happened to be exported as `SegmentOutlet` is not read as a
73
- * hole, which would keep changes inside it out of its segment's hash.
74
- */
75
- export declare function isOutletType(type: unknown): boolean;
76
- /**
77
- * The element for an outlet: a server component that decides when it renders
78
- * — after every access gate above it — and inside a capture renders a bare
79
- * hole, since the nested segment's content belongs to its own hash.
80
- *
81
- * A closure with no props rather than a component taking `{ spec, render }`:
82
- * dev Flight serializes a server component's props as debug info, and these
83
- * would repeat the whole subtree in every dev payload.
84
- */
85
- export declare function outletGate(spec: OutletSpec, render: SegmentHashRender): ReactElement;
86
- /**
87
- * Whether `node` is an outlet gate element — the boundary of the segment
88
- * whose content contains it. A walk over one segment's output (a
89
- * 'document' segment's read scope) stops here: what renders inside belongs
90
- * to the nested segment and its own rules.
91
- */
92
- export declare function isOutletGateElement(node: unknown): boolean;
93
- //# sourceMappingURL=outlet.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../../src/server/segment-hash/outlet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAiB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD,yEAAyE;IACzE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,qBAAqB,EAAE,eAAe,CAAC;CACxC;AAED,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,EAAE,iBAMhC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CASnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAapF;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAI1D"}
@@ -1,49 +0,0 @@
1
- /**
2
- * The advertised hash: each live segment's hash, computed from what the main
3
- * Flight stream actually sent.
4
- *
5
- * A live `SegmentOutlet` carries `decision.hash` as a promise. The tap feeds
6
- * the outgoing stream to React's own Flight client in the RSC environment,
7
- * finds each live outlet in the decoded tree, and once everything the
8
- * decision's `children` reach has settled, resolves that promise with the
9
- * hash of those decoded values (value-hash.ts). Flight then writes the hash
10
- * as one more row. The client stores it beside the content it committed, so
11
- * the hash it later advertises describes exactly what it received
12
- * (design/52 §"Two hashes, two jobs").
13
- *
14
- * Nothing about this can stall the response: a hash the tap cannot compute
15
- * resolves to null once the decoded payload has been explored without
16
- * finding its outlet, or when the stream ends, and every pending hash
17
- * resolves to null once `timeoutMs` passes — a pending promise would otherwise hold the
18
- * Flight stream open.
19
- *
20
- * See design/52-segment-hash-dedupe.md §"Wire format".
21
- */
22
- export interface SegmentHashTap {
23
- /**
24
- * The hash of live segment `segmentPath`'s content in this stream, once it
25
- * has all arrived. Null when it cannot be computed.
26
- */
27
- advertise(segmentPath: string): Promise<string | null>;
28
- /** Feed one chunk of the outgoing stream. */
29
- observe(chunk: Uint8Array): void;
30
- /** The stream ended or was cancelled: give up on everything pending. */
31
- end(): void;
32
- /**
33
- * Run `cancel` once the stream ends, however it ends; returns the
34
- * unsubscribe. Captures started for this render stop with it (capture.ts) —
35
- * nothing waits on them any more. A callback list rather than an
36
- * AbortSignal: aborting a signal from the stream's teardown kept every
37
- * finished request reachable in dev (tests/e2e/dev-request-retention.test.ts).
38
- */
39
- onEnd(cancel: () => void): () => void;
40
- }
41
- export interface SegmentHashTapOptions {
42
- timeoutMs: number;
43
- /** Whether a decoded element type is timber's `SegmentOutlet`. */
44
- isOutlet: (type: unknown) => boolean;
45
- /** React's Flight client in the RSC environment. */
46
- decode: (stream: ReadableStream<Uint8Array>) => PromiseLike<unknown>;
47
- }
48
- export declare function createSegmentHashTap(options: SegmentHashTapOptions): SegmentHashTap;
49
- //# sourceMappingURL=stream-tap.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"stream-tap.d.ts","sourceRoot":"","sources":["../../../src/server/segment-hash/stream-tap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,6CAA6C;IAC7C,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,wEAAwE;IACxE,GAAG,IAAI,IAAI,CAAC;IACZ;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,oDAAoD;IACpD,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,WAAW,CAAC,OAAO,CAAC,CAAC;CACtE;AAsBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA2KnF"}