@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.
- package/dist/_chunks/{actions-Top9GftB.js → actions-DIgnvDrG.js} +4 -4
- package/dist/_chunks/{actions-Top9GftB.js.map → actions-DIgnvDrG.js.map} +1 -1
- package/dist/_chunks/{als-registry-DpygwCp0.js → als-registry-PPYstxK0.js} +2 -1
- package/dist/_chunks/{als-registry-DpygwCp0.js.map → als-registry-PPYstxK0.js.map} +1 -1
- package/dist/_chunks/{cache-api-Bo8c7XVF.js → cache-api-uWQwuxWb.js} +5 -5
- package/dist/_chunks/{cache-api-Bo8c7XVF.js.map → cache-api-uWQwuxWb.js.map} +1 -1
- package/dist/_chunks/{chains-DMoHX4yH.js → chains-C7CExrUI.js} +2 -2
- package/dist/_chunks/{chains-DMoHX4yH.js.map → chains-C7CExrUI.js.map} +1 -1
- package/dist/_chunks/chains-CSslTUdI.js +1 -0
- package/dist/_chunks/{classify-BwyAd-dZ.js → classify-Cj9EeZoL.js} +2 -2
- package/dist/_chunks/{classify-BwyAd-dZ.js.map → classify-Cj9EeZoL.js.map} +1 -1
- package/dist/_chunks/{cli-check-DQAD9MLo.js → cli-check-C3QOAru7.js} +3 -3
- package/dist/_chunks/{cli-check-DQAD9MLo.js.map → cli-check-C3QOAru7.js.map} +1 -1
- package/dist/_chunks/{cli-schema-sync-C_xNLqBj.js → cli-schema-sync-BRxZz66D.js} +1 -1
- package/dist/_chunks/{cli-schema-sync-CmGls3dc.js → cli-schema-sync-DQUS_o3V.js} +2 -2
- package/dist/_chunks/{cli-schema-sync-CmGls3dc.js.map → cli-schema-sync-DQUS_o3V.js.map} +1 -1
- package/dist/_chunks/{client-dep-entries-C5BTQtFS.js → client-dep-entries-ZETBdLgv.js} +2 -2
- package/dist/_chunks/{client-dep-entries-C5BTQtFS.js.map → client-dep-entries-ZETBdLgv.js.map} +1 -1
- package/dist/_chunks/{convention-lint-GQA6WTRo.js → convention-lint-BoVISNS6.js} +3 -3
- package/dist/_chunks/{convention-lint-GQA6WTRo.js.map → convention-lint-BoVISNS6.js.map} +1 -1
- package/dist/_chunks/dev-server-B8roKA3Q.js +1 -0
- package/dist/_chunks/{dev-server-Cr3_Fu5A.js → dev-server-C5R6jx8Q.js} +2 -2
- package/dist/_chunks/{dev-server-Cr3_Fu5A.js.map → dev-server-C5R6jx8Q.js.map} +1 -1
- package/dist/_chunks/{dev-span-RsVeYYc_.js → dev-span-0aG7Q_Ph.js} +3 -7
- package/dist/_chunks/dev-span-0aG7Q_Ph.js.map +1 -0
- package/dist/_chunks/{error-boundary-Bh-egWUI.js → error-boundary-DB51f9ih.js} +98 -419
- package/dist/_chunks/error-boundary-DB51f9ih.js.map +1 -0
- package/dist/_chunks/{flight-source-node-BsrlUjMO.js → flight-source-node-D9cHBhjP.js} +7 -4
- package/dist/_chunks/flight-source-node-D9cHBhjP.js.map +1 -0
- package/dist/_chunks/{json-lossy-check-D47R9Fp5.js → json-lossy-check-Y1GxqVX_.js} +2 -2
- package/dist/_chunks/{json-lossy-check-D47R9Fp5.js.map → json-lossy-check-Y1GxqVX_.js.map} +1 -1
- package/dist/_chunks/{live-graph-HcLScfiV.js → live-graph-BDQWvnMm.js} +4 -4
- package/dist/_chunks/{live-graph-HcLScfiV.js.map → live-graph-BDQWvnMm.js.map} +1 -1
- package/dist/_chunks/{logger-DDLtp5e-.js → logger-DmRR9tmZ.js} +2 -2
- package/dist/_chunks/{logger-DDLtp5e-.js.map → logger-DmRR9tmZ.js.map} +1 -1
- package/dist/_chunks/metadata-routes-MXNjWOt5.js.map +1 -1
- package/dist/_chunks/{node-response-omewa8e6.js → node-response-yp8zdyRp.js} +2 -2
- package/dist/_chunks/{node-response-omewa8e6.js.map → node-response-yp8zdyRp.js.map} +1 -1
- package/dist/_chunks/plugin-context-BtaQcMuh.js.map +1 -1
- package/dist/_chunks/{poison-scan-DONdiCGX.js → poison-scan-WQgUydF_.js} +2 -2
- package/dist/_chunks/{poison-scan-DONdiCGX.js.map → poison-scan-WQgUydF_.js.map} +1 -1
- package/dist/_chunks/{scanner-DSAJjH0x.js → scanner-C9Lrf77z.js} +3 -2
- package/dist/_chunks/{scanner-DSAJjH0x.js.map → scanner-C9Lrf77z.js.map} +1 -1
- package/dist/_chunks/{sizeof-DVhEVN_y.js → sizeof-BISkSaU0.js} +2 -2
- package/dist/_chunks/{sizeof-DVhEVN_y.js.map → sizeof-BISkSaU0.js.map} +1 -1
- package/dist/_chunks/{walkers-96YopJds.js → walkers-Bxv4v7tX.js} +3 -3
- package/dist/_chunks/{walkers-96YopJds.js.map → walkers-Bxv4v7tX.js.map} +1 -1
- package/dist/adapters/cloudflare-kv-cache.js +1 -1
- package/dist/analyze/crawl-entry.js +3 -3
- package/dist/analyze/graph-command.js +2 -2
- package/dist/cache/index.js +2 -2
- package/dist/cache/stores/memory.js +1 -1
- package/dist/cdn/workers-cache-purge.js +1 -1
- package/dist/cli.js +3 -3
- package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -1
- package/dist/client/browser-entry/hydrate.d.ts +1 -1
- package/dist/client/browser-entry/router-init.d.ts.map +1 -1
- package/dist/client/error-boundary.d.ts +1 -0
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -1
- package/dist/client/history.d.ts +4 -5
- package/dist/client/history.d.ts.map +1 -1
- package/dist/client/index.js +6 -7
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.d.ts +1 -1
- package/dist/client/internal.d.ts.map +1 -1
- package/dist/client/internal.js +194 -55
- package/dist/client/internal.js.map +1 -1
- package/dist/client/navigation-commit.d.ts +6 -25
- package/dist/client/navigation-commit.d.ts.map +1 -1
- package/dist/client/outlet-content-cache.d.ts +59 -0
- package/dist/client/outlet-content-cache.d.ts.map +1 -0
- package/dist/client/outlet-scope-context.d.ts +30 -0
- package/dist/client/outlet-scope-context.d.ts.map +1 -0
- package/dist/client/params-context.d.ts +10 -11
- package/dist/client/params-context.d.ts.map +1 -1
- package/dist/client/router-pipeline.d.ts +5 -5
- package/dist/client/router-pipeline.d.ts.map +1 -1
- package/dist/client/router-types.d.ts +10 -24
- package/dist/client/router-types.d.ts.map +1 -1
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/rsc-fetch.d.ts +4 -17
- package/dist/client/rsc-fetch.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +15 -103
- package/dist/client/segment-cache.d.ts.map +1 -1
- package/dist/client/segment-outlet.d.ts +28 -52
- package/dist/client/segment-outlet.d.ts.map +1 -1
- package/dist/client/stale-segment.d.ts +39 -0
- package/dist/client/stale-segment.d.ts.map +1 -0
- package/dist/client/use-segment-params.d.ts +1 -1
- package/dist/config-types.d.ts +7 -6
- package/dist/config-types.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -732
- package/dist/index.js.map +1 -1
- package/dist/native/rsc/manifest.json +6 -4
- package/dist/native/rsc/routing/segment-keys.js +3 -11
- package/dist/native/rsc/routing/segment-keys.js.map +1 -1
- package/dist/native/rsc/server/access-gate.js +3 -7
- package/dist/native/rsc/server/access-gate.js.map +1 -1
- package/dist/native/rsc/server/als-registry.js +2 -1
- package/dist/native/rsc/server/als-registry.js.map +1 -1
- package/dist/native/rsc/server/build-manifest.js.map +1 -1
- package/dist/native/rsc/server/chain-url-parts.js +1 -6
- package/dist/native/rsc/server/chain-url-parts.js.map +1 -1
- package/dist/native/rsc/server/client-state-tree.js +33 -0
- package/dist/native/rsc/server/client-state-tree.js.map +1 -0
- package/dist/native/rsc/server/flight-source-node.js +5 -2
- package/dist/native/rsc/server/flight-source-node.js.map +1 -1
- package/dist/native/rsc/server/flight-source.js +46 -7
- package/dist/native/rsc/server/flight-source.js.map +1 -1
- package/dist/native/rsc/server/pipeline-interception.js +1 -1
- package/dist/native/rsc/server/publish-params.js.map +1 -1
- package/dist/native/rsc/server/route-element-builder.js +43 -61
- package/dist/native/rsc/server/route-element-builder.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/helpers.js +5 -28
- package/dist/native/rsc/server/rsc-entry/helpers.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/render-route.js +33 -7
- package/dist/native/rsc/server/rsc-entry/render-route.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js +2 -1
- package/dist/native/rsc/server/rsc-entry/revalidate-renderer.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/rsc-payload.js +2 -5
- package/dist/native/rsc/server/rsc-entry/rsc-payload.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/rsc-stream.js +44 -40
- package/dist/native/rsc/server/rsc-entry/rsc-stream.js.map +1 -1
- package/dist/native/rsc/server/rsc-entry/ssr-renderer.js +1 -1
- package/dist/native/rsc/server/rsc-entry/ssr-renderer.js.map +1 -1
- package/dist/native/rsc/server/segment-hash/capture.js +107 -0
- package/dist/native/rsc/server/segment-hash/capture.js.map +1 -0
- package/dist/native/rsc/server/segment-hash/outlet.js +81 -0
- package/dist/native/rsc/server/segment-hash/outlet.js.map +1 -0
- package/dist/native/rsc/server/segment-hash/stream-tap.js +139 -0
- package/dist/native/rsc/server/segment-hash/stream-tap.js.map +1 -0
- package/dist/native/rsc/server/segment-hash/value-hash.js +171 -0
- package/dist/native/rsc/server/segment-hash/value-hash.js.map +1 -0
- package/dist/native/rsc/server/slot-resolver.js +20 -124
- package/dist/native/rsc/server/slot-resolver.js.map +1 -1
- package/dist/native/rsc/server/vite-handoff-rsc.js.map +1 -1
- package/dist/native/rsc/shared/outlet-decision.js +5 -0
- package/dist/native/rsc/shared/outlet-decision.js.map +1 -0
- package/dist/native/ssr/client/error-boundary.js +16 -3
- package/dist/native/ssr/client/error-boundary.js.map +1 -1
- package/dist/native/ssr/client/navigation-commit.js +1 -5
- package/dist/native/ssr/client/navigation-commit.js.map +1 -1
- package/dist/native/ssr/client/outlet-content-cache.js +53 -0
- package/dist/native/ssr/client/outlet-content-cache.js.map +1 -0
- package/dist/native/ssr/client/outlet-scope-context.js +12 -0
- package/dist/native/ssr/client/outlet-scope-context.js.map +1 -0
- package/dist/native/ssr/client/params-context.js.map +1 -1
- package/dist/native/ssr/client/rsc-fetch.js +1 -12
- package/dist/native/ssr/client/rsc-fetch.js.map +1 -1
- package/dist/native/ssr/client/segment-outlet.js +34 -13
- package/dist/native/ssr/client/segment-outlet.js.map +1 -1
- package/dist/native/ssr/client/stale-segment.js +29 -0
- package/dist/native/ssr/client/stale-segment.js.map +1 -0
- package/dist/native/ssr/manifest.json +5 -4
- package/dist/native/ssr/routing/segment-keys.js +5 -1
- package/dist/native/ssr/routing/segment-keys.js.map +1 -1
- package/dist/native/ssr/server/access-gate.js +3 -7
- package/dist/native/ssr/server/access-gate.js.map +1 -1
- package/dist/native/ssr/server/als-registry.js +1 -0
- package/dist/native/ssr/server/als-registry.js.map +1 -1
- package/dist/native/ssr/server/build-manifest.js.map +1 -1
- package/dist/native/ssr/server/client-state-tree.js +33 -0
- package/dist/native/ssr/server/client-state-tree.js.map +1 -0
- package/dist/native/ssr/server/flight-source-node.js +5 -2
- package/dist/native/ssr/server/flight-source-node.js.map +1 -1
- package/dist/native/ssr/server/flight-source.js +1 -0
- package/dist/native/ssr/server/flight-source.js.map +1 -1
- package/dist/native/ssr/server/pipeline-interception.js +1 -1
- package/dist/native/ssr/server/segment-hash/value-hash.js +162 -0
- package/dist/native/ssr/server/segment-hash/value-hash.js.map +1 -0
- package/dist/native/ssr/server/ssr-wrappers.js.map +1 -1
- package/dist/native/ssr/server/vite-handoff-rsc.js.map +1 -1
- package/dist/native/ssr/shared/payload-root.js.map +1 -1
- package/dist/plugin-context.d.ts +0 -16
- package/dist/plugin-context.d.ts.map +1 -1
- package/dist/plugins/build-manifest.d.ts.map +1 -1
- package/dist/routing/index.js +2 -2
- package/dist/routing/segment-keys.d.ts +8 -21
- package/dist/routing/segment-keys.d.ts.map +1 -1
- package/dist/server/access-gate.d.ts +0 -14
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +16 -0
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/build-manifest.d.ts +1 -10
- package/dist/server/build-manifest.d.ts.map +1 -1
- package/dist/server/chain-url-parts.d.ts +3 -13
- package/dist/server/chain-url-parts.d.ts.map +1 -1
- package/dist/server/client-state-tree.d.ts +31 -0
- package/dist/server/client-state-tree.d.ts.map +1 -0
- package/dist/server/flight-source-node.d.ts +6 -1
- package/dist/server/flight-source-node.d.ts.map +1 -1
- package/dist/server/flight-source.d.ts +27 -0
- package/dist/server/flight-source.d.ts.map +1 -1
- package/dist/server/index.js +2 -2
- package/dist/server/internal.js +48 -47
- package/dist/server/internal.js.map +1 -1
- package/dist/server/publish-params.d.ts +5 -4
- package/dist/server/publish-params.d.ts.map +1 -1
- package/dist/server/route-element-builder.d.ts +4 -19
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +7 -13
- package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -1
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-payload.d.ts +1 -2
- package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +11 -2
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-renderer.d.ts +0 -2
- package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
- package/dist/server/segment-hash/capture.d.ts +77 -0
- package/dist/server/segment-hash/capture.d.ts.map +1 -0
- package/dist/server/segment-hash/outlet.d.ts +65 -0
- package/dist/server/segment-hash/outlet.d.ts.map +1 -0
- package/dist/server/segment-hash/stream-tap.d.ts +49 -0
- package/dist/server/segment-hash/stream-tap.d.ts.map +1 -0
- package/dist/server/segment-hash/value-hash.d.ts +70 -0
- package/dist/server/segment-hash/value-hash.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +13 -78
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +7 -9
- package/dist/server/ssr-wrappers.d.ts.map +1 -1
- package/dist/server/vite-handoff-rsc.d.ts +10 -1
- package/dist/server/vite-handoff-rsc.d.ts.map +1 -1
- package/dist/shared/outlet-decision.d.ts +48 -0
- package/dist/shared/outlet-decision.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +5 -8
- package/dist/shared/payload-root.d.ts.map +1 -1
- package/dist/shared/segment-info.d.ts +13 -28
- package/dist/shared/segment-info.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/client/browser-entry/action-dispatch.ts +1 -15
- package/src/client/browser-entry/hydrate.ts +3 -3
- package/src/client/browser-entry/router-init.ts +28 -47
- package/src/client/error-boundary.tsx +49 -9
- package/src/client/history.ts +4 -5
- package/src/client/internal.ts +1 -1
- package/src/client/navigation-commit.ts +25 -83
- package/src/client/outlet-content-cache.ts +119 -0
- package/src/client/outlet-scope-context.ts +42 -0
- package/src/client/params-context.ts +11 -12
- package/src/client/router-pipeline.ts +10 -74
- package/src/client/router-types.ts +11 -26
- package/src/client/router.ts +7 -22
- package/src/client/rsc-fetch.ts +5 -30
- package/src/client/segment-cache.ts +19 -264
- package/src/client/segment-outlet.tsx +80 -72
- package/src/client/stale-segment.ts +60 -0
- package/src/client/use-segment-params.ts +1 -1
- package/src/config-types.ts +7 -6
- package/src/index.ts +0 -2
- package/src/plugin-context.ts +0 -16
- package/src/plugins/build-manifest.ts +1 -22
- package/src/routing/scanner.ts +12 -0
- package/src/routing/segment-keys.ts +9 -35
- package/src/rsc-runtime/vendor-types.d.ts +8 -0
- package/src/server/access-gate.tsx +3 -32
- package/src/server/als-registry.ts +23 -0
- package/src/server/build-manifest.ts +1 -11
- package/src/server/chain-url-parts.ts +3 -21
- package/src/server/client-state-tree.ts +75 -0
- package/src/server/flight-source-node.ts +7 -2
- package/src/server/flight-source.ts +102 -9
- package/src/server/pipeline-interception.ts +1 -1
- package/src/server/publish-params.ts +5 -4
- package/src/server/route-element-builder.ts +77 -206
- package/src/server/rsc-entry/helpers.ts +11 -65
- package/src/server/rsc-entry/render-route.ts +54 -28
- package/src/server/rsc-entry/revalidate-renderer.ts +2 -1
- package/src/server/rsc-entry/rsc-payload.ts +11 -39
- package/src/server/rsc-entry/rsc-stream.ts +123 -101
- package/src/server/rsc-entry/ssr-renderer.ts +1 -3
- package/src/server/segment-hash/capture.ts +232 -0
- package/src/server/segment-hash/outlet.ts +185 -0
- package/src/server/segment-hash/stream-tap.ts +244 -0
- package/src/server/segment-hash/value-hash.ts +338 -0
- package/src/server/slot-resolver.ts +37 -323
- package/src/server/ssr-wrappers.tsx +7 -9
- package/src/server/vite-handoff-rsc.ts +12 -1
- package/src/shared/outlet-decision.ts +54 -0
- package/src/shared/payload-root.ts +5 -8
- package/src/shared/segment-info.ts +13 -28
- package/dist/_chunks/chains-CmzbpG-6.js +0 -1
- package/dist/_chunks/dev-server--4_Ogy_6.js +0 -1
- package/dist/_chunks/dev-span-RsVeYYc_.js.map +0 -1
- package/dist/_chunks/error-boundary-Bh-egWUI.js.map +0 -1
- package/dist/_chunks/flight-source-node-BsrlUjMO.js.map +0 -1
- package/dist/client/segment-update-context.d.ts +0 -15
- package/dist/client/segment-update-context.d.ts.map +0 -1
- package/dist/client/slot-content-cache-context.d.ts +0 -35
- package/dist/client/slot-content-cache-context.d.ts.map +0 -1
- package/dist/native/rsc/server/request-dep.js +0 -12
- package/dist/native/rsc/server/request-dep.js.map +0 -1
- package/dist/native/rsc/server/route-element-helpers.js +0 -20
- package/dist/native/rsc/server/route-element-helpers.js.map +0 -1
- package/dist/native/rsc/server/skippable-prefix.js +0 -72
- package/dist/native/rsc/server/skippable-prefix.js.map +0 -1
- package/dist/native/rsc/server/state-tree-diff.js +0 -35
- package/dist/native/rsc/server/state-tree-diff.js.map +0 -1
- package/dist/native/ssr/client/segment-cache.js +0 -119
- package/dist/native/ssr/client/segment-cache.js.map +0 -1
- package/dist/native/ssr/client/segment-update-context.js +0 -9
- package/dist/native/ssr/client/segment-update-context.js.map +0 -1
- package/dist/native/ssr/client/slot-content-cache-context.js +0 -8
- package/dist/native/ssr/client/slot-content-cache-context.js.map +0 -1
- package/dist/native/ssr/server/state-tree-diff.js +0 -23
- package/dist/native/ssr/server/state-tree-diff.js.map +0 -1
- package/dist/plugins/request-dep/analysis.d.ts +0 -106
- package/dist/plugins/request-dep/analysis.d.ts.map +0 -1
- package/dist/plugins/request-dep/index.d.ts +0 -75
- package/dist/plugins/request-dep/index.d.ts.map +0 -1
- package/dist/plugins/request-dep/origin.d.ts +0 -61
- package/dist/plugins/request-dep/origin.d.ts.map +0 -1
- package/dist/server/request-dep.d.ts +0 -15
- package/dist/server/request-dep.d.ts.map +0 -1
- package/dist/server/route-element-helpers.d.ts +0 -12
- package/dist/server/route-element-helpers.d.ts.map +0 -1
- package/dist/server/skippable-prefix.d.ts +0 -29
- package/dist/server/skippable-prefix.d.ts.map +0 -1
- package/dist/server/state-tree-diff.d.ts +0 -78
- package/dist/server/state-tree-diff.d.ts.map +0 -1
- package/src/client/segment-update-context.ts +0 -23
- package/src/client/slot-content-cache-context.ts +0 -43
- package/src/plugins/request-dep/analysis.ts +0 -447
- package/src/plugins/request-dep/index.ts +0 -376
- package/src/plugins/request-dep/origin.ts +0 -310
- package/src/server/request-dep.ts +0 -37
- package/src/server/route-element-helpers.ts +0 -37
- package/src/server/skippable-prefix.ts +0 -172
- 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
|
-
|
|
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?: {
|
|
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?: {
|
|
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(
|
|
127
|
-
|
|
128
|
-
|
|
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
|
-
|
|
134
|
-
|
|
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
|
|
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
|
|
25
|
-
*
|
|
26
|
-
*
|
|
27
|
-
*
|
|
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
|