@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.231
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +8 -0
- package/agent-skill.md +389 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-CYjRMpZI.js +1273 -0
- package/dist/_chunks/actions-CYjRMpZI.js.map +1 -0
- package/dist/_chunks/als-registry-DpygwCp0.js +42 -0
- package/dist/_chunks/als-registry-DpygwCp0.js.map +1 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js +25 -0
- package/dist/_chunks/als-slots-kbQrHTzm.js.map +1 -0
- package/dist/_chunks/base-path-DDIx0FXe.js +79 -0
- package/dist/_chunks/base-path-DDIx0FXe.js.map +1 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js +398 -0
- package/dist/_chunks/build-output-helper-5UsltK-S.js.map +1 -0
- package/dist/_chunks/cache-api-BZJNt01a.js +1282 -0
- package/dist/_chunks/cache-api-BZJNt01a.js.map +1 -0
- package/dist/_chunks/canonicalize-CqK135BN.js +117 -0
- package/dist/_chunks/canonicalize-CqK135BN.js.map +1 -0
- package/dist/_chunks/chains-D-RRc7CM.js +266 -0
- package/dist/_chunks/chains-D-RRc7CM.js.map +1 -0
- package/dist/_chunks/chains-KblEfYzm.js +1 -0
- package/dist/_chunks/classify-_W0RWa5w.js +146 -0
- package/dist/_chunks/classify-_W0RWa5w.js.map +1 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js +251 -0
- package/dist/_chunks/cli-check-BAKOSTkg.js.map +1 -0
- package/dist/_chunks/cli-context-BPdyA7Fp.js +1 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js +77 -0
- package/dist/_chunks/cli-context-CwTKMjVe.js.map +1 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js +138 -0
- package/dist/_chunks/cli-dev-status-prPMLU8G.js.map +1 -0
- package/dist/_chunks/cli-init-BoXOYYil.js +196 -0
- package/dist/_chunks/cli-init-BoXOYYil.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js +289 -0
- package/dist/_chunks/cli-schema-sync-CAllbqRB.js.map +1 -0
- package/dist/_chunks/cli-schema-sync-y_8ijmzO.js +1 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js +109 -0
- package/dist/_chunks/client-dep-entries-C9hv-3k9.js.map +1 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js +1314 -0
- package/dist/_chunks/cloudflare-_2fhxQE8.js.map +1 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js +13 -0
- package/dist/_chunks/codec-registry-C8hOGmZo.js.map +1 -0
- package/dist/_chunks/codegen-vaCyFyVN.js +479 -0
- package/dist/_chunks/codegen-vaCyFyVN.js.map +1 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js +578 -0
- package/dist/_chunks/convention-lint-D54k6uUM.js.map +1 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
- package/dist/_chunks/dev-server-L8biS7Az.js +1 -0
- package/dist/_chunks/dev-server-Rq659RR1.js +2439 -0
- package/dist/_chunks/dev-server-Rq659RR1.js.map +1 -0
- package/dist/_chunks/dev-span-_NzMX-au.js +108 -0
- package/dist/_chunks/dev-span-_NzMX-au.js.map +1 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js +327 -0
- package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
- package/dist/_chunks/dist-C1Rjlo6s.js +384 -0
- package/dist/_chunks/dist-C1Rjlo6s.js.map +1 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js +1100 -0
- package/dist/_chunks/error-boundary-OHK1mI99.js.map +1 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js +40 -0
- package/dist/_chunks/fast-hash-DddxkU5Y.js.map +1 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js +516 -0
- package/dist/_chunks/flight-source-node-BGanuoSS.js.map +1 -0
- package/dist/_chunks/format-DuPOoXUP.js +13 -0
- package/dist/_chunks/format-DuPOoXUP.js.map +1 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js +205 -0
- package/dist/_chunks/fs-identity-BmQ_Agg-.js.map +1 -0
- package/dist/_chunks/global-context-CFSSysdJ.js +77 -0
- package/dist/_chunks/global-context-CFSSysdJ.js.map +1 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js +219 -0
- package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
- package/dist/_chunks/href-BtspoNc9.js +164 -0
- package/dist/_chunks/href-BtspoNc9.js.map +1 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js +102 -0
- package/dist/_chunks/href-validation-DNg-zV7u.js.map +1 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js +65 -0
- package/dist/_chunks/json-lossy-check-BXM45k8p.js.map +1 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js +150 -0
- package/dist/_chunks/live-graph-C7-yA8W9.js.map +1 -0
- package/dist/_chunks/logger-YtMSKfft.js +755 -0
- package/dist/_chunks/logger-YtMSKfft.js.map +1 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js +111 -0
- package/dist/_chunks/merge-search-params-7o_5yX0L.js.map +1 -0
- package/dist/_chunks/{metadata-routes-Cjmvi3rQ.js → metadata-routes-BL26HCDd.js} +71 -29
- package/dist/_chunks/metadata-routes-BL26HCDd.js.map +1 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js +239 -0
- package/dist/_chunks/navigation-root-CoGHIMiE.js.map +1 -0
- package/dist/_chunks/node-response-D3hXWb8y.js +267 -0
- package/dist/_chunks/node-response-D3hXWb8y.js.map +1 -0
- package/dist/_chunks/param-value-DqlGfF57.js +65 -0
- package/dist/_chunks/param-value-DqlGfF57.js.map +1 -0
- package/dist/_chunks/plugin-context-BfSRKJfz.js +1 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js +327 -0
- package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js +109 -0
- package/dist/_chunks/poison-rules-Bmz-lCPi.js.map +1 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js +98 -0
- package/dist/_chunks/poison-scan-CRSP06Es.js.map +1 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js +13 -0
- package/dist/_chunks/purge-store-8BqLAYZ1.js.map +1 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js +53 -0
- package/dist/_chunks/render-timeout-MrrqD1wd.js.map +1 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js +49 -0
- package/dist/_chunks/resolve-schema-B-aCuTu3.js.map +1 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js +36 -0
- package/dist/_chunks/route-methods-Dk2kZc0n.js.map +1 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js +242 -0
- package/dist/_chunks/rsc-cache-key-D0cb0Gmc.js.map +1 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js +60 -0
- package/dist/_chunks/rsc-media-type-m8jz9u6_.js.map +1 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js +53 -0
- package/dist/_chunks/rsc-payload-path-EphpDB-J.js.map +1 -0
- package/dist/_chunks/scan-CyizcBiX.js +139 -0
- package/dist/_chunks/scan-CyizcBiX.js.map +1 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js +2048 -0
- package/dist/_chunks/scanner-BNQ4qnLX.js.map +1 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js +235 -0
- package/dist/_chunks/schema-bridge-DyRs3cqy.js.map +1 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js +195 -0
- package/dist/_chunks/segment-classify-Ho8jXWeC.js.map +1 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js +33 -0
- package/dist/_chunks/segment-context-GAyTjjtS.js.map +1 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js +61 -0
- package/dist/_chunks/segment-keys-Y60KNc8C.js.map +1 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js +53 -0
- package/dist/_chunks/singleflight-CzoOVB9Y.js.map +1 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js +35 -0
- package/dist/_chunks/sizeof-Cmx6Fs-Y.js.map +1 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js +48 -0
- package/dist/_chunks/ssr-data-9hPtcNOr.js.map +1 -0
- package/dist/_chunks/state-B-EBjeER.js +49 -0
- package/dist/_chunks/state-B-EBjeER.js.map +1 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js +530 -0
- package/dist/_chunks/status-page-marker-U6B1aFMb.js.map +1 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js +168 -0
- package/dist/_chunks/tree-match-Bqdr9szG.js.map +1 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js +223 -0
- package/dist/_chunks/use-query-states-pkDV-jSg.js.map +1 -0
- package/dist/_chunks/walkers-D_QHR_nf.js +142 -0
- package/dist/_chunks/walkers-D_QHR_nf.js.map +1 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js +31 -0
- package/dist/_chunks/write-file-atomic-DW8m_Atv.js.map +1 -0
- package/dist/adapters/build-output-helper.d.ts +81 -0
- package/dist/adapters/build-output-helper.d.ts.map +1 -0
- package/dist/adapters/canonicalize-module.d.ts +8 -0
- package/dist/adapters/canonicalize-module.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.d.ts +109 -0
- package/dist/adapters/cloudflare-dev.d.ts.map +1 -0
- package/dist/adapters/cloudflare-dev.js +73 -0
- package/dist/adapters/cloudflare-dev.js.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts +64 -0
- package/dist/adapters/cloudflare-kv-cache.d.ts.map +1 -0
- package/dist/adapters/cloudflare-kv-cache.js +122 -0
- package/dist/adapters/cloudflare-kv-cache.js.map +1 -0
- package/dist/adapters/cloudflare.d.ts +217 -24
- package/dist/adapters/cloudflare.d.ts.map +1 -1
- package/dist/adapters/cloudflare.js +1 -188
- package/dist/adapters/compress-module.d.ts +25 -4
- package/dist/adapters/compress-module.d.ts.map +1 -1
- package/dist/adapters/fs-identity.d.ts +63 -0
- package/dist/adapters/fs-identity.d.ts.map +1 -0
- package/dist/adapters/nitro-immutable-assets.d.ts +47 -0
- package/dist/adapters/nitro-immutable-assets.d.ts.map +1 -0
- package/dist/adapters/nitro-presets.d.ts +37 -0
- package/dist/adapters/nitro-presets.d.ts.map +1 -0
- package/dist/adapters/nitro-preview.d.ts +65 -0
- package/dist/adapters/nitro-preview.d.ts.map +1 -0
- package/dist/adapters/nitro.d.ts +69 -38
- package/dist/adapters/nitro.d.ts.map +1 -1
- package/dist/adapters/nitro.js +837 -347
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/adapters/shared.d.ts +85 -0
- package/dist/adapters/shared.d.ts.map +1 -0
- package/dist/adapters/types.d.ts +124 -16
- package/dist/adapters/types.d.ts.map +1 -1
- package/dist/adapters/types.js +0 -0
- package/dist/analyze/chains.d.ts +124 -0
- package/dist/analyze/chains.d.ts.map +1 -0
- package/dist/analyze/classify.d.ts +153 -0
- package/dist/analyze/classify.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.d.ts +17 -0
- package/dist/analyze/crawl-entry.d.ts.map +1 -0
- package/dist/analyze/crawl-entry.js +312 -0
- package/dist/analyze/crawl-entry.js.map +1 -0
- package/dist/analyze/crawl.d.ts +134 -0
- package/dist/analyze/crawl.d.ts.map +1 -0
- package/dist/analyze/graph-cache.d.ts +104 -0
- package/dist/analyze/graph-cache.d.ts.map +1 -0
- package/dist/analyze/graph-command.d.ts +43 -0
- package/dist/analyze/graph-command.d.ts.map +1 -0
- package/dist/analyze/graph-command.js +386 -0
- package/dist/analyze/graph-command.js.map +1 -0
- package/dist/analyze/live-graph.d.ts +81 -0
- package/dist/analyze/live-graph.d.ts.map +1 -0
- package/dist/analyze/poison-rules.d.ts +72 -0
- package/dist/analyze/poison-rules.d.ts.map +1 -0
- package/dist/analyze/poison-scan.d.ts +48 -0
- package/dist/analyze/poison-scan.d.ts.map +1 -0
- package/dist/analyze/scan.d.ts +73 -0
- package/dist/analyze/scan.d.ts.map +1 -0
- package/dist/cache/cache-api.d.ts +48 -0
- package/dist/cache/cache-api.d.ts.map +1 -0
- package/dist/cache/fast-hash.d.ts +5 -0
- package/dist/cache/fast-hash.d.ts.map +1 -1
- package/dist/cache/guarded-read.d.ts +29 -0
- package/dist/cache/guarded-read.d.ts.map +1 -0
- package/dist/cache/handler-store.d.ts +45 -0
- package/dist/cache/handler-store.d.ts.map +1 -0
- package/dist/cache/index.d.ts +32 -9
- package/dist/cache/index.d.ts.map +1 -1
- package/dist/cache/index.js +4 -326
- package/dist/cache/invalidation-epoch.d.ts +50 -0
- package/dist/cache/invalidation-epoch.d.ts.map +1 -0
- package/dist/cache/json-lossy-check.d.ts +11 -0
- package/dist/cache/json-lossy-check.d.ts.map +1 -0
- package/dist/cache/key-discipline.d.ts +61 -0
- package/dist/cache/key-discipline.d.ts.map +1 -0
- package/dist/cache/redis-handler.d.ts +140 -9
- package/dist/cache/redis-handler.d.ts.map +1 -1
- package/dist/cache/singleflight.d.ts +31 -2
- package/dist/cache/singleflight.d.ts.map +1 -1
- package/dist/cache/sizeof.d.ts +22 -0
- package/dist/cache/sizeof.d.ts.map +1 -0
- package/dist/cache/stable-stringify.d.ts +15 -0
- package/dist/cache/stable-stringify.d.ts.map +1 -1
- package/dist/cache/store.d.ts +53 -0
- package/dist/cache/store.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.d.ts +38 -0
- package/dist/cache/stores/cloudflare-kv.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.js +28 -0
- package/dist/cache/stores/cloudflare-kv.js.map +1 -0
- package/dist/cache/stores/memory.d.ts +42 -0
- package/dist/cache/stores/memory.d.ts.map +1 -0
- package/dist/cache/stores/memory.js +89 -0
- package/dist/cache/stores/memory.js.map +1 -0
- package/dist/cache/stores/redis.d.ts +69 -0
- package/dist/cache/stores/redis.d.ts.map +1 -0
- package/dist/cache/stores/redis.js +34 -0
- package/dist/cache/stores/redis.js.map +1 -0
- package/dist/cache/stores/vercel.d.ts +36 -0
- package/dist/cache/stores/vercel.d.ts.map +1 -0
- package/dist/cache/stores/vercel.js +32 -0
- package/dist/cache/stores/vercel.js.map +1 -0
- package/dist/cache/tag-aware-handler.d.ts +51 -0
- package/dist/cache/tag-aware-handler.d.ts.map +1 -0
- package/dist/cache/timber-cache.d.ts +25 -11
- package/dist/cache/timber-cache.d.ts.map +1 -1
- package/dist/cdn/cloudflare-purge.d.ts +23 -0
- package/dist/cdn/cloudflare-purge.d.ts.map +1 -0
- package/dist/cdn/cloudflare-purge.js +29 -0
- package/dist/cdn/cloudflare-purge.js.map +1 -0
- package/dist/cdn/fastly-purge.d.ts +25 -0
- package/dist/cdn/fastly-purge.d.ts.map +1 -0
- package/dist/cdn/fastly-purge.js +32 -0
- package/dist/cdn/fastly-purge.js.map +1 -0
- package/dist/cdn/headers.d.ts +97 -0
- package/dist/cdn/headers.d.ts.map +1 -0
- package/dist/cdn/index.d.ts +5 -0
- package/dist/cdn/index.d.ts.map +1 -0
- package/dist/cdn/index.js +93 -0
- package/dist/cdn/index.js.map +1 -0
- package/dist/cdn/purge-store.d.ts +32 -0
- package/dist/cdn/purge-store.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.d.ts +20 -0
- package/dist/cdn/workers-cache-purge.d.ts.map +1 -0
- package/dist/cdn/workers-cache-purge.js +33 -0
- package/dist/cdn/workers-cache-purge.js.map +1 -0
- package/dist/cli-check.d.ts +133 -0
- package/dist/cli-check.d.ts.map +1 -0
- package/dist/cli-context.d.ts +62 -0
- package/dist/cli-context.d.ts.map +1 -0
- package/dist/cli-dev-status.d.ts +75 -0
- package/dist/cli-dev-status.d.ts.map +1 -0
- package/dist/cli-init.d.ts +72 -0
- package/dist/cli-init.d.ts.map +1 -0
- package/dist/cli-schema-sync.d.ts +59 -0
- package/dist/cli-schema-sync.d.ts.map +1 -0
- package/dist/cli.d.ts +80 -16
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +210 -69
- package/dist/cli.js.map +1 -1
- package/dist/client/browser-dev.d.ts +42 -2
- package/dist/client/browser-dev.d.ts.map +1 -1
- package/dist/client/browser-entry/action-dispatch.d.ts +19 -0
- package/dist/client/browser-entry/action-dispatch.d.ts.map +1 -0
- package/dist/client/browser-entry/action-queue.d.ts +64 -0
- package/dist/client/browser-entry/action-queue.d.ts.map +1 -0
- package/dist/client/browser-entry/form-state.d.ts +22 -0
- package/dist/client/browser-entry/form-state.d.ts.map +1 -0
- package/dist/client/browser-entry/hmr.d.ts +27 -0
- package/dist/client/browser-entry/hmr.d.ts.map +1 -0
- package/dist/client/browser-entry/hydrate.d.ts +61 -0
- package/dist/client/browser-entry/hydrate.d.ts.map +1 -0
- package/dist/client/browser-entry/index.d.ts +32 -0
- package/dist/client/browser-entry/index.d.ts.map +1 -0
- package/dist/client/browser-entry/post-hydration.d.ts +26 -0
- package/dist/client/browser-entry/post-hydration.d.ts.map +1 -0
- package/dist/client/browser-entry/router-init.d.ts +41 -0
- package/dist/client/browser-entry/router-init.d.ts.map +1 -0
- package/dist/client/browser-entry/rsc-stream.d.ts +35 -0
- package/dist/client/browser-entry/rsc-stream.d.ts.map +1 -0
- package/dist/client/browser-entry/scroll.d.ts +28 -0
- package/dist/client/browser-entry/scroll.d.ts.map +1 -0
- package/dist/client/deny-last-resort.d.ts +29 -0
- package/dist/client/deny-last-resort.d.ts.map +1 -0
- package/dist/client/dev-pill/index.d.ts +32 -0
- package/dist/client/dev-pill/index.d.ts.map +1 -0
- package/dist/client/dev-pill/store.d.ts +105 -0
- package/dist/client/dev-pill/store.d.ts.map +1 -0
- package/dist/client/dev-pill/view.d.ts +9 -0
- package/dist/client/dev-pill/view.d.ts.map +1 -0
- package/dist/client/error-boundary.d.ts +58 -9
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -126
- package/dist/client/error-reconstituter.d.ts +55 -0
- package/dist/client/error-reconstituter.d.ts.map +1 -0
- package/dist/client/form.d.ts +38 -99
- package/dist/client/form.d.ts.map +1 -1
- package/dist/client/global-context.d.ts +35 -0
- package/dist/client/global-context.d.ts.map +1 -0
- package/dist/client/history.d.ts +50 -9
- package/dist/client/history.d.ts.map +1 -1
- package/dist/client/index.d.ts +23 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +330 -1273
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.d.ts +20 -0
- package/dist/client/internal.d.ts.map +1 -0
- package/dist/client/internal.js +785 -0
- package/dist/client/internal.js.map +1 -0
- package/dist/client/link.d.ts +75 -71
- package/dist/client/link.d.ts.map +1 -1
- package/dist/client/location-search.d.ts +12 -0
- package/dist/client/location-search.d.ts.map +1 -0
- package/dist/client/navigation-api.d.ts +95 -0
- package/dist/client/navigation-api.d.ts.map +1 -0
- package/dist/client/navigation-commit.d.ts +111 -0
- package/dist/client/navigation-commit.d.ts.map +1 -0
- package/dist/client/navigation-context.d.ts +75 -37
- package/dist/client/navigation-context.d.ts.map +1 -1
- package/dist/client/navigation-root.d.ts +106 -0
- package/dist/client/navigation-root.d.ts.map +1 -0
- package/dist/client/navigation-transition.d.ts +255 -0
- package/dist/client/navigation-transition.d.ts.map +1 -0
- package/dist/client/nuqs-adapter.d.ts +5 -2
- package/dist/client/nuqs-adapter.d.ts.map +1 -1
- package/dist/client/params-context.d.ts +81 -0
- package/dist/client/params-context.d.ts.map +1 -0
- package/dist/client/react-root.d.ts +51 -0
- package/dist/client/react-root.d.ts.map +1 -0
- package/dist/client/router-effects.d.ts +203 -0
- package/dist/client/router-effects.d.ts.map +1 -0
- package/dist/client/router-lifecycle.d.ts +107 -0
- package/dist/client/router-lifecycle.d.ts.map +1 -0
- package/dist/client/router-pipeline.d.ts +81 -0
- package/dist/client/router-pipeline.d.ts.map +1 -0
- package/dist/client/router-ref.d.ts +2 -2
- package/dist/client/router-ref.d.ts.map +1 -1
- package/dist/client/router-skew.d.ts +21 -0
- package/dist/client/router-skew.d.ts.map +1 -0
- package/dist/client/router-types.d.ts +294 -0
- package/dist/client/router-types.d.ts.map +1 -0
- package/dist/client/router-url.d.ts +24 -0
- package/dist/client/router-url.d.ts.map +1 -0
- package/dist/client/router.d.ts +1 -97
- package/dist/client/router.d.ts.map +1 -1
- package/dist/client/rsc-fetch.d.ts +110 -28
- package/dist/client/rsc-fetch.d.ts.map +1 -1
- package/dist/client/segment-cache.d.ts +186 -25
- package/dist/client/segment-cache.d.ts.map +1 -1
- package/dist/client/segment-context.d.ts.map +1 -1
- package/dist/client/segment-outlet.d.ts +68 -0
- package/dist/client/segment-outlet.d.ts.map +1 -0
- package/dist/client/segment-update-context.d.ts +15 -0
- package/dist/client/segment-update-context.d.ts.map +1 -0
- package/dist/client/shallow-url.d.ts +10 -0
- package/dist/client/shallow-url.d.ts.map +1 -0
- package/dist/client/slot-content-cache-context.d.ts +35 -0
- package/dist/client/slot-content-cache-context.d.ts.map +1 -0
- package/dist/client/slot-context.d.ts +31 -0
- package/dist/client/slot-context.d.ts.map +1 -0
- package/dist/client/slot-outlet.d.ts +16 -0
- package/dist/client/slot-outlet.d.ts.map +1 -0
- package/dist/client/slot-provider.d.ts +25 -0
- package/dist/client/slot-provider.d.ts.map +1 -0
- package/dist/client/ssr-data.d.ts +26 -50
- package/dist/client/ssr-data.d.ts.map +1 -1
- package/dist/client/stale-client.d.ts +69 -0
- package/dist/client/stale-client.d.ts.map +1 -0
- package/dist/client/state.d.ts +21 -13
- package/dist/client/state.d.ts.map +1 -1
- package/dist/client/status-page-marker.d.ts +25 -0
- package/dist/client/status-page-marker.d.ts.map +1 -0
- package/dist/client/top-loader.d.ts +7 -6
- package/dist/client/top-loader.d.ts.map +1 -1
- package/dist/client/unload-guard.d.ts +5 -0
- package/dist/client/unload-guard.d.ts.map +1 -1
- package/dist/client/use-cookie.d.ts +25 -0
- package/dist/client/use-cookie.d.ts.map +1 -1
- package/dist/client/use-field-state.d.ts +42 -0
- package/dist/client/use-field-state.d.ts.map +1 -0
- package/dist/client/use-link-status.d.ts +5 -5
- package/dist/client/use-link-status.d.ts.map +1 -1
- package/dist/client/use-pathname.d.ts +13 -11
- package/dist/client/use-pathname.d.ts.map +1 -1
- package/dist/client/use-pending-navigation.d.ts +47 -0
- package/dist/client/use-pending-navigation.d.ts.map +1 -0
- package/dist/client/use-query-states.d.ts +10 -4
- package/dist/client/use-query-states.d.ts.map +1 -1
- package/dist/client/use-router.d.ts +15 -8
- package/dist/client/use-router.d.ts.map +1 -1
- package/dist/client/use-search-params.d.ts +15 -8
- package/dist/client/use-search-params.d.ts.map +1 -1
- package/dist/client/use-segment-params.d.ts +55 -0
- package/dist/client/use-segment-params.d.ts.map +1 -0
- package/dist/codec.d.ts +69 -0
- package/dist/codec.d.ts.map +1 -0
- package/dist/codec.js +75 -0
- package/dist/codec.js.map +1 -0
- package/dist/config-types.d.ts +366 -0
- package/dist/config-types.d.ts.map +1 -0
- package/dist/config-validation.d.ts +68 -0
- package/dist/config-validation.d.ts.map +1 -0
- package/dist/cookies/define-cookie.d.ts +58 -25
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.d.ts +3 -2
- package/dist/cookies/index.d.ts.map +1 -1
- package/dist/cookies/index.js +230 -37
- package/dist/cookies/index.js.map +1 -1
- package/dist/cookies/json-cookie.d.ts +64 -0
- package/dist/cookies/json-cookie.d.ts.map +1 -0
- package/dist/cookies/validation.d.ts +34 -0
- package/dist/cookies/validation.d.ts.map +1 -0
- package/dist/dev-tools/404-page.d.ts +50 -0
- package/dist/dev-tools/404-page.d.ts.map +1 -0
- package/dist/dev-tools/await-span.d.ts +17 -0
- package/dist/dev-tools/await-span.d.ts.map +1 -0
- package/dist/dev-tools/browser-logs.d.ts +40 -0
- package/dist/dev-tools/browser-logs.d.ts.map +1 -0
- package/dist/dev-tools/dev-page-shell.d.ts +95 -0
- package/dist/dev-tools/dev-page-shell.d.ts.map +1 -0
- package/dist/dev-tools/error-page.d.ts +32 -0
- package/dist/dev-tools/error-page.d.ts.map +1 -0
- package/dist/dev-tools/holding-server.d.ts +46 -0
- package/dist/dev-tools/holding-server.d.ts.map +1 -0
- package/dist/dev-tools/hydration-overlay.d.ts +11 -0
- package/dist/dev-tools/hydration-overlay.d.ts.map +1 -0
- package/dist/dev-tools/index.d.ts +31 -0
- package/dist/dev-tools/index.d.ts.map +1 -0
- package/dist/dev-tools/instrumentation.d.ts +74 -0
- package/dist/dev-tools/instrumentation.d.ts.map +1 -0
- package/dist/{server/dev-logger.d.ts → dev-tools/logger.d.ts} +1 -1
- package/dist/dev-tools/logger.d.ts.map +1 -0
- package/dist/{plugins/dev-logs.d.ts → dev-tools/logs.d.ts} +19 -5
- package/dist/dev-tools/logs.d.ts.map +1 -0
- package/dist/{plugins/dev-error-overlay.d.ts → dev-tools/overlay.d.ts} +15 -25
- package/dist/dev-tools/overlay.d.ts.map +1 -0
- package/dist/dev-tools/span-sink.d.ts +42 -0
- package/dist/dev-tools/span-sink.d.ts.map +1 -0
- package/dist/dev-tools/stack-classifier.d.ts +34 -0
- package/dist/dev-tools/stack-classifier.d.ts.map +1 -0
- package/dist/dev-tools/terminal.d.ts +28 -0
- package/dist/dev-tools/terminal.d.ts.map +1 -0
- package/dist/fonts/ast-walk.d.ts +68 -0
- package/dist/fonts/ast-walk.d.ts.map +1 -0
- package/dist/fonts/ast.d.ts +112 -8
- package/dist/fonts/ast.d.ts.map +1 -1
- package/dist/fonts/bundle.d.ts +50 -0
- package/dist/fonts/bundle.d.ts.map +1 -0
- package/dist/fonts/css.d.ts +1 -1
- package/dist/fonts/dev-middleware.d.ts +22 -0
- package/dist/fonts/dev-middleware.d.ts.map +1 -0
- package/dist/fonts/fallbacks.d.ts +0 -7
- package/dist/fonts/fallbacks.d.ts.map +1 -1
- package/dist/fonts/google.d.ts +5 -3
- package/dist/fonts/google.d.ts.map +1 -1
- package/dist/fonts/local.d.ts +5 -5
- package/dist/fonts/local.d.ts.map +1 -1
- package/dist/fonts/paths.d.ts +43 -0
- package/dist/fonts/paths.d.ts.map +1 -0
- package/dist/fonts/pipeline.d.ts +177 -0
- package/dist/fonts/pipeline.d.ts.map +1 -0
- package/dist/fonts/transform.d.ts +82 -0
- package/dist/fonts/transform.d.ts.map +1 -0
- package/dist/fonts/types.d.ts +47 -1
- package/dist/fonts/types.d.ts.map +1 -1
- package/dist/fonts/virtual-modules.d.ts +77 -0
- package/dist/fonts/virtual-modules.d.ts.map +1 -0
- package/dist/index.d.ts +37 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9952 -14264
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +36 -0
- package/dist/params/codec-registry.d.ts.map +1 -0
- package/dist/params/define-schema.d.ts +81 -0
- package/dist/params/define-schema.d.ts.map +1 -0
- package/dist/params/index.d.ts +4 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +32 -0
- package/dist/params/index.js.map +1 -0
- package/dist/params/resolve-schema.d.ts +34 -0
- package/dist/params/resolve-schema.d.ts.map +1 -0
- package/dist/plugin-context.d.ts +269 -0
- package/dist/plugin-context.d.ts.map +1 -0
- package/dist/plugins/build-manifest.d.ts +7 -3
- package/dist/plugins/build-manifest.d.ts.map +1 -1
- package/dist/plugins/build-report.d.ts +61 -11
- package/dist/plugins/build-report.d.ts.map +1 -1
- package/dist/plugins/cache.d.ts +64 -0
- package/dist/plugins/cache.d.ts.map +1 -0
- package/dist/plugins/callsite-ast.d.ts +117 -0
- package/dist/plugins/callsite-ast.d.ts.map +1 -0
- package/dist/plugins/callsite-jsx.d.ts +35 -0
- package/dist/plugins/callsite-jsx.d.ts.map +1 -0
- package/dist/plugins/chunks.d.ts +11 -4
- package/dist/plugins/chunks.d.ts.map +1 -1
- package/dist/plugins/client-chunks.d.ts +40 -0
- package/dist/plugins/client-chunks.d.ts.map +1 -0
- package/dist/plugins/client-dep-entries.d.ts +80 -0
- package/dist/plugins/client-dep-entries.d.ts.map +1 -0
- package/dist/plugins/client-in-server-package-deps.d.ts +63 -0
- package/dist/plugins/client-in-server-package-deps.d.ts.map +1 -0
- package/dist/plugins/cloudflare-wasm.d.ts +21 -0
- package/dist/plugins/cloudflare-wasm.d.ts.map +1 -0
- package/dist/plugins/content.d.ts +1 -1
- package/dist/plugins/content.d.ts.map +1 -1
- package/dist/plugins/dev-await.d.ts +81 -0
- package/dist/plugins/dev-await.d.ts.map +1 -0
- package/dist/plugins/dev-discovery.d.ts +187 -0
- package/dist/plugins/dev-discovery.d.ts.map +1 -0
- package/dist/plugins/dev-hostname.d.ts +152 -0
- package/dist/plugins/dev-hostname.d.ts.map +1 -0
- package/dist/plugins/dev-server.d.ts +29 -2
- package/dist/plugins/dev-server.d.ts.map +1 -1
- package/dist/plugins/dev-store-clear.d.ts +83 -0
- package/dist/plugins/dev-store-clear.d.ts.map +1 -0
- package/dist/plugins/encryption-runtime.d.ts +13 -0
- package/dist/plugins/encryption-runtime.d.ts.map +1 -0
- package/dist/plugins/entries.d.ts +40 -4
- package/dist/plugins/entries.d.ts.map +1 -1
- package/dist/plugins/fonts.d.ts +35 -74
- package/dist/plugins/fonts.d.ts.map +1 -1
- package/dist/plugins/graph-endpoint.d.ts +114 -0
- package/dist/plugins/graph-endpoint.d.ts.map +1 -0
- package/dist/plugins/mdx.d.ts +18 -5
- package/dist/plugins/mdx.d.ts.map +1 -1
- package/dist/plugins/optimize-package-imports-defaults.d.ts +13 -0
- package/dist/plugins/optimize-package-imports-defaults.d.ts.map +1 -0
- package/dist/plugins/optimize-package-imports.d.ts +124 -0
- package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
- package/dist/plugins/orphaned-modules.d.ts +57 -0
- package/dist/plugins/orphaned-modules.d.ts.map +1 -0
- package/dist/plugins/post-build.d.ts +110 -0
- package/dist/plugins/post-build.d.ts.map +1 -0
- package/dist/plugins/prebuilt-capture.d.ts +67 -0
- package/dist/plugins/prebuilt-capture.d.ts.map +1 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts +40 -0
- package/dist/plugins/prebuilt-options-analysis.d.ts.map +1 -0
- package/dist/plugins/prebuilt.d.ts +98 -0
- package/dist/plugins/prebuilt.d.ts.map +1 -0
- package/dist/plugins/prerender-sugar.d.ts +39 -0
- package/dist/plugins/prerender-sugar.d.ts.map +1 -0
- package/dist/plugins/react-resolve.d.ts +49 -0
- package/dist/plugins/react-resolve.d.ts.map +1 -0
- package/dist/plugins/request-dep/analysis.d.ts +106 -0
- package/dist/plugins/request-dep/analysis.d.ts.map +1 -0
- package/dist/plugins/request-dep/index.d.ts +75 -0
- package/dist/plugins/request-dep/index.d.ts.map +1 -0
- package/dist/plugins/request-dep/origin.d.ts +61 -0
- package/dist/plugins/request-dep/origin.d.ts.map +1 -0
- package/dist/plugins/routing.d.ts +2 -2
- package/dist/plugins/routing.d.ts.map +1 -1
- package/dist/plugins/rsc-assets-manifest.d.ts +33 -0
- package/dist/plugins/rsc-assets-manifest.d.ts.map +1 -0
- package/dist/plugins/server-bundle.d.ts +1 -1
- package/dist/plugins/server-bundle.d.ts.map +1 -1
- package/dist/plugins/shims.d.ts +29 -5
- package/dist/plugins/shims.d.ts.map +1 -1
- package/dist/plugins/static-build.d.ts +246 -26
- package/dist/plugins/static-build.d.ts.map +1 -1
- package/dist/routes/href.d.ts +124 -0
- package/dist/routes/href.d.ts.map +1 -0
- package/dist/routes/index.d.ts +4 -0
- package/dist/routes/index.d.ts.map +1 -0
- package/dist/routes/index.js +8 -0
- package/dist/routes/index.js.map +1 -0
- package/dist/routing/codegen-shared.d.ts +26 -0
- package/dist/routing/codegen-shared.d.ts.map +1 -0
- package/dist/routing/codegen-types.d.ts +61 -0
- package/dist/routing/codegen-types.d.ts.map +1 -0
- package/dist/routing/codegen-write.d.ts +42 -0
- package/dist/routing/codegen-write.d.ts.map +1 -0
- package/dist/routing/codegen.d.ts +8 -3
- package/dist/routing/codegen.d.ts.map +1 -1
- package/dist/routing/collision-probe.d.ts +104 -0
- package/dist/routing/collision-probe.d.ts.map +1 -0
- package/dist/routing/collision-spaces.d.ts +26 -0
- package/dist/routing/collision-spaces.d.ts.map +1 -0
- package/dist/routing/convention-lint.d.ts +55 -0
- package/dist/routing/convention-lint.d.ts.map +1 -0
- package/dist/routing/export-detect.d.ts +91 -0
- package/dist/routing/export-detect.d.ts.map +1 -0
- package/dist/routing/file-cache.d.ts +8 -0
- package/dist/routing/file-cache.d.ts.map +1 -0
- package/dist/routing/index.d.ts +13 -7
- package/dist/routing/index.d.ts.map +1 -1
- package/dist/routing/index.js +5 -2
- package/dist/routing/interception-overlap.d.ts +35 -0
- package/dist/routing/interception-overlap.d.ts.map +1 -0
- package/dist/routing/interception.d.ts +234 -10
- package/dist/routing/interception.d.ts.map +1 -1
- package/dist/routing/link-codegen.d.ts +136 -0
- package/dist/routing/link-codegen.d.ts.map +1 -0
- package/dist/routing/manifest-codegen.d.ts +26 -0
- package/dist/routing/manifest-codegen.d.ts.map +1 -0
- package/dist/routing/scanner.d.ts +14 -10
- package/dist/routing/scanner.d.ts.map +1 -1
- package/dist/routing/schema-validation.d.ts +35 -0
- package/dist/routing/schema-validation.d.ts.map +1 -0
- package/dist/routing/segment-classify.d.ts +114 -0
- package/dist/routing/segment-classify.d.ts.map +1 -0
- package/dist/routing/segment-codegen.d.ts +38 -0
- package/dist/routing/segment-codegen.d.ts.map +1 -0
- package/dist/routing/segment-keys.d.ts +118 -0
- package/dist/routing/segment-keys.d.ts.map +1 -0
- package/dist/routing/slot-placement.d.ts +48 -0
- package/dist/routing/slot-placement.d.ts.map +1 -0
- package/dist/routing/types.d.ts +81 -26
- package/dist/routing/types.d.ts.map +1 -1
- package/dist/routing/walkers.d.ts +57 -0
- package/dist/routing/walkers.d.ts.map +1 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts +47 -0
- package/dist/rsc-runtime/dev-reference-cache.d.ts.map +1 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts +25 -0
- package/dist/rsc-runtime/encryption-runtime.d.ts.map +1 -0
- package/dist/rsc-runtime/render-flight.d.ts +14 -0
- package/dist/rsc-runtime/render-flight.d.ts.map +1 -0
- package/dist/rsc-runtime/rsc.d.ts +3 -13
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/server-reference-load-error.d.ts +14 -0
- package/dist/rsc-runtime/server-reference-load-error.d.ts.map +1 -0
- package/dist/rsc-runtime/server-references.d.ts +19 -0
- package/dist/rsc-runtime/server-references.d.ts.map +1 -0
- package/dist/rsc-runtime/ssr.d.ts +7 -10
- package/dist/rsc-runtime/ssr.d.ts.map +1 -1
- package/dist/rsc-runtime/transforms.d.ts +13 -0
- package/dist/rsc-runtime/transforms.d.ts.map +1 -0
- package/dist/schema-bridge.d.ts +154 -0
- package/dist/schema-bridge.d.ts.map +1 -0
- package/dist/search-params/define.d.ts +262 -0
- package/dist/search-params/define.d.ts.map +1 -0
- package/dist/search-params/index.d.ts +3 -7
- package/dist/search-params/index.d.ts.map +1 -1
- package/dist/search-params/index.js +178 -362
- package/dist/search-params/index.js.map +1 -1
- package/dist/search-params/parse-total.d.ts +81 -0
- package/dist/search-params/parse-total.d.ts.map +1 -0
- package/dist/search-params/serialize-equal.d.ts +9 -0
- package/dist/search-params/serialize-equal.d.ts.map +1 -0
- package/dist/search-params/wrappers.d.ts +76 -0
- package/dist/search-params/wrappers.d.ts.map +1 -0
- package/dist/server/abort-scope.d.ts +27 -0
- package/dist/server/abort-scope.d.ts.map +1 -0
- package/dist/server/access-gate.d.ts +110 -10
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/action-client.d.ts +20 -133
- package/dist/server/action-client.d.ts.map +1 -1
- package/dist/server/action-encryption.d.ts +76 -0
- package/dist/server/action-encryption.d.ts.map +1 -0
- package/dist/server/action-handler.d.ts +60 -11
- package/dist/server/action-handler.d.ts.map +1 -1
- package/dist/server/action-schema.d.ts +126 -0
- package/dist/server/action-schema.d.ts.map +1 -0
- package/dist/server/action-types.d.ts +108 -0
- package/dist/server/action-types.d.ts.map +1 -0
- package/dist/server/actions.d.ts +78 -40
- package/dist/server/actions.d.ts.map +1 -1
- package/dist/server/als-registry.d.ts +189 -17
- package/dist/server/als-registry.d.ts.map +1 -1
- package/dist/server/body-limits.d.ts.map +1 -1
- package/dist/server/build-manifest.d.ts +25 -30
- package/dist/server/build-manifest.d.ts.map +1 -1
- package/dist/server/canonicalize.d.ts +53 -0
- package/dist/server/canonicalize.d.ts.map +1 -1
- package/dist/server/chain-url-parts.d.ts +82 -0
- package/dist/server/chain-url-parts.d.ts.map +1 -0
- package/dist/server/children-interception.d.ts +49 -0
- package/dist/server/children-interception.d.ts.map +1 -0
- package/dist/server/client-error-message.d.ts +12 -0
- package/dist/server/client-error-message.d.ts.map +1 -0
- package/dist/server/coalesce-tick.d.ts +40 -0
- package/dist/server/coalesce-tick.d.ts.map +1 -0
- package/dist/server/compress.d.ts +2 -0
- package/dist/server/compress.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +156 -0
- package/dist/server/cookie-context.d.ts.map +1 -0
- package/dist/server/cookie-parsing.d.ts +65 -0
- package/dist/server/cookie-parsing.d.ts.map +1 -0
- package/dist/server/csp-nonce.d.ts +36 -0
- package/dist/server/csp-nonce.d.ts.map +1 -0
- package/dist/server/csrf.d.ts +58 -15
- package/dist/server/csrf.d.ts.map +1 -1
- package/dist/server/debug.d.ts +0 -1
- package/dist/server/debug.d.ts.map +1 -1
- package/dist/server/default-logger.d.ts +23 -0
- package/dist/server/default-logger.d.ts.map +1 -0
- package/dist/server/default-status-page.d.ts +45 -0
- package/dist/server/default-status-page.d.ts.map +1 -0
- package/dist/server/deny-boundary.d.ts +257 -0
- package/dist/server/deny-boundary.d.ts.map +1 -0
- package/dist/server/deny-renderer.d.ts +22 -15
- package/dist/server/deny-renderer.d.ts.map +1 -1
- package/dist/server/early-hints-sender.d.ts.map +1 -1
- package/dist/server/early-hints.d.ts +14 -12
- package/dist/server/early-hints.d.ts.map +1 -1
- package/dist/server/error-boundary-wrapper.d.ts +102 -10
- package/dist/server/error-boundary-wrapper.d.ts.map +1 -1
- package/dist/server/error-response-headers.d.ts +3 -0
- package/dist/server/error-response-headers.d.ts.map +1 -0
- package/dist/server/fallback-error.d.ts +19 -7
- package/dist/server/fallback-error.d.ts.map +1 -1
- package/dist/server/flight-injection-state.d.ts +66 -0
- package/dist/server/flight-injection-state.d.ts.map +1 -0
- package/dist/server/flight-injector-core.d.ts +125 -0
- package/dist/server/flight-injector-core.d.ts.map +1 -0
- package/dist/server/flight-scripts.d.ts +63 -0
- package/dist/server/flight-scripts.d.ts.map +1 -0
- package/dist/server/flight-source-node.d.ts +105 -0
- package/dist/server/flight-source-node.d.ts.map +1 -0
- package/dist/server/flight-source.d.ts +136 -0
- package/dist/server/flight-source.d.ts.map +1 -0
- package/dist/server/form-data.d.ts +59 -2
- package/dist/server/form-data.d.ts.map +1 -1
- package/dist/server/form-state-flight.d.ts +32 -0
- package/dist/server/form-state-flight.d.ts.map +1 -0
- package/dist/server/head-response.d.ts +35 -0
- package/dist/server/head-response.d.ts.map +1 -0
- package/dist/server/html-injector-core.d.ts +169 -0
- package/dist/server/html-injector-core.d.ts.map +1 -0
- package/dist/server/html-injectors.d.ts +77 -47
- package/dist/server/html-injectors.d.ts.map +1 -1
- package/dist/server/index.d.ts +16 -54
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +621 -3009
- package/dist/server/index.js.map +1 -1
- package/dist/server/instrumentation.d.ts +13 -5
- package/dist/server/instrumentation.d.ts.map +1 -1
- package/dist/server/interception-gates.d.ts +49 -0
- package/dist/server/interception-gates.d.ts.map +1 -0
- package/dist/server/internal.d.ts +48 -0
- package/dist/server/internal.d.ts.map +1 -0
- package/dist/server/internal.js +5092 -0
- package/dist/server/internal.js.map +1 -0
- package/dist/server/json-status-response.d.ts +34 -0
- package/dist/server/json-status-response.d.ts.map +1 -0
- package/dist/server/logger.d.ts +105 -7
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/metadata-collector.d.ts +75 -0
- package/dist/server/metadata-collector.d.ts.map +1 -0
- package/dist/server/metadata-platform.d.ts +2 -2
- package/dist/server/metadata-render.d.ts +2 -2
- package/dist/server/metadata-render.d.ts.map +1 -1
- package/dist/server/metadata-route-links.d.ts +70 -0
- package/dist/server/metadata-route-links.d.ts.map +1 -0
- package/dist/server/metadata-routes.d.ts +47 -11
- package/dist/server/metadata-routes.d.ts.map +1 -1
- package/dist/server/metadata-social.d.ts +2 -2
- package/dist/server/metadata.d.ts +10 -2
- package/dist/server/metadata.d.ts.map +1 -1
- package/dist/server/middleware-runner.d.ts +20 -5
- package/dist/server/middleware-runner.d.ts.map +1 -1
- package/dist/server/node-body-response.d.ts +55 -0
- package/dist/server/node-body-response.d.ts.map +1 -0
- package/dist/server/node-response.d.ts +62 -0
- package/dist/server/node-response.d.ts.map +1 -0
- package/dist/server/node-stream-transforms.d.ts +108 -0
- package/dist/server/node-stream-transforms.d.ts.map +1 -0
- package/dist/server/node-streams-platform.d.ts +21 -0
- package/dist/server/node-streams-platform.d.ts.map +1 -0
- package/dist/server/param-coercion.d.ts +84 -0
- package/dist/server/param-coercion.d.ts.map +1 -0
- package/dist/server/pipeline-helpers.d.ts +227 -0
- package/dist/server/pipeline-helpers.d.ts.map +1 -0
- package/dist/server/pipeline-interception.d.ts +100 -9
- package/dist/server/pipeline-interception.d.ts.map +1 -1
- package/dist/server/pipeline-metadata-route.d.ts +24 -0
- package/dist/server/pipeline-metadata-route.d.ts.map +1 -0
- package/dist/server/pipeline-metadata.d.ts +18 -2
- package/dist/server/pipeline-metadata.d.ts.map +1 -1
- package/dist/server/pipeline-outcome.d.ts +59 -0
- package/dist/server/pipeline-outcome.d.ts.map +1 -0
- package/dist/server/pipeline-phases.d.ts +76 -0
- package/dist/server/pipeline-phases.d.ts.map +1 -0
- package/dist/server/pipeline.d.ts +190 -23
- package/dist/server/pipeline.d.ts.map +1 -1
- package/dist/server/port-resolution.d.ts +22 -0
- package/dist/server/port-resolution.d.ts.map +1 -0
- package/dist/server/prebuilt/cache-key.d.ts +89 -0
- package/dist/server/prebuilt/cache-key.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-render.d.ts +30 -0
- package/dist/server/prebuilt/capture-render.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-routes.d.ts +37 -0
- package/dist/server/prebuilt/capture-routes.d.ts.map +1 -0
- package/dist/server/prebuilt/capture-state.d.ts +101 -0
- package/dist/server/prebuilt/capture-state.d.ts.map +1 -0
- package/dist/server/prebuilt/dev-store.d.ts +149 -0
- package/dist/server/prebuilt/dev-store.d.ts.map +1 -0
- package/dist/server/prebuilt/lifetime.d.ts +38 -0
- package/dist/server/prebuilt/lifetime.d.ts.map +1 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts +27 -0
- package/dist/server/prebuilt/manifest-tag-index.d.ts.map +1 -0
- package/dist/server/prebuilt/overlay.d.ts +119 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -0
- package/dist/server/prebuilt/payload-source.d.ts +87 -0
- package/dist/server/prebuilt/payload-source.d.ts.map +1 -0
- package/dist/server/prebuilt/slots.d.ts +105 -0
- package/dist/server/prebuilt/slots.d.ts.map +1 -0
- package/dist/server/prebuilt/synthetic-store.d.ts +67 -0
- package/dist/server/prebuilt/synthetic-store.d.ts.map +1 -0
- package/dist/server/prebuilt-builder.d.ts +121 -0
- package/dist/server/prebuilt-builder.d.ts.map +1 -0
- package/dist/server/prebuilt-runtime.d.ts +105 -0
- package/dist/server/prebuilt-runtime.d.ts.map +1 -0
- package/dist/server/primitives.d.ts +114 -90
- package/dist/server/primitives.d.ts.map +1 -1
- package/dist/server/publish-params.d.ts +33 -0
- package/dist/server/publish-params.d.ts.map +1 -0
- package/dist/server/react-cache-bridge.d.ts +59 -0
- package/dist/server/react-cache-bridge.d.ts.map +1 -0
- package/dist/server/react-cache-scope.d.ts +49 -0
- package/dist/server/react-cache-scope.d.ts.map +1 -0
- package/dist/server/render-timeout.d.ts +66 -0
- package/dist/server/render-timeout.d.ts.map +1 -0
- package/dist/server/render-utils.d.ts +56 -0
- package/dist/server/render-utils.d.ts.map +1 -0
- package/dist/server/request-context.d.ts +167 -103
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/request-dep.d.ts +15 -0
- package/dist/server/request-dep.d.ts.map +1 -0
- package/dist/server/response-cache-policy.d.ts +3 -0
- package/dist/server/response-cache-policy.d.ts.map +1 -0
- package/dist/server/response-framing.d.ts +43 -0
- package/dist/server/response-framing.d.ts.map +1 -0
- package/dist/server/route-element-builder.d.ts +57 -30
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-element-helpers.d.ts +12 -0
- package/dist/server/route-element-helpers.d.ts.map +1 -0
- package/dist/server/route-handler.d.ts +9 -3
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +75 -40
- package/dist/server/route-matcher.d.ts.map +1 -1
- package/dist/server/route-methods.d.ts +23 -0
- package/dist/server/route-methods.d.ts.map +1 -0
- package/dist/server/route-module-loader.d.ts +37 -0
- package/dist/server/route-module-loader.d.ts.map +1 -0
- package/dist/server/rsc-cache-key-guard.d.ts +78 -0
- package/dist/server/rsc-cache-key-guard.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts +65 -0
- package/dist/server/rsc-entry/action-dispatcher.d.ts.map +1 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts +66 -0
- package/dist/server/rsc-entry/action-middleware-runner.d.ts.map +1 -0
- package/dist/server/rsc-entry/api-handler.d.ts +19 -3
- package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
- package/dist/server/rsc-entry/deny-fallback.d.ts +55 -0
- package/dist/server/rsc-entry/deny-fallback.d.ts.map +1 -0
- package/dist/server/rsc-entry/error-renderer.d.ts +35 -21
- package/dist/server/rsc-entry/error-renderer.d.ts.map +1 -1
- package/dist/server/rsc-entry/helpers.d.ts +14 -59
- package/dist/server/rsc-entry/helpers.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts +30 -6
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/render-route.d.ts +55 -0
- package/dist/server/rsc-entry/render-route.d.ts.map +1 -0
- package/dist/server/rsc-entry/render-signals.d.ts +65 -0
- package/dist/server/rsc-entry/render-signals.d.ts.map +1 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts +98 -0
- package/dist/server/rsc-entry/revalidate-renderer.d.ts.map +1 -0
- package/dist/server/rsc-entry/rsc-payload.d.ts +38 -11
- package/dist/server/rsc-entry/rsc-payload.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts +18 -31
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-bridge.d.ts +7 -2
- package/dist/server/rsc-entry/ssr-bridge.d.ts.map +1 -1
- package/dist/server/rsc-entry/ssr-renderer.d.ts +52 -8
- package/dist/server/rsc-entry/ssr-renderer.d.ts.map +1 -1
- package/dist/server/rsc-error-envelope.d.ts +11 -0
- package/dist/server/rsc-error-envelope.d.ts.map +1 -0
- package/dist/server/safe-load.d.ts +39 -0
- package/dist/server/safe-load.d.ts.map +1 -0
- package/dist/server/schema-introspection.d.ts +68 -0
- package/dist/server/schema-introspection.d.ts.map +1 -0
- package/dist/server/sensitive-fields.d.ts +88 -0
- package/dist/server/sensitive-fields.d.ts.map +1 -0
- package/dist/server/signal-identity.d.ts +49 -0
- package/dist/server/signal-identity.d.ts.map +1 -0
- package/dist/server/sitemap-generator.d.ts +130 -0
- package/dist/server/sitemap-generator.d.ts.map +1 -0
- package/dist/server/sitemap-handler.d.ts +22 -0
- package/dist/server/sitemap-handler.d.ts.map +1 -0
- package/dist/server/skippable-prefix.d.ts +29 -0
- package/dist/server/skippable-prefix.d.ts.map +1 -0
- package/dist/server/slot-interception.d.ts +80 -0
- package/dist/server/slot-interception.d.ts.map +1 -0
- package/dist/server/slot-resolver.d.ts +138 -7
- package/dist/server/slot-resolver.d.ts.map +1 -1
- package/dist/server/slot-subtree-contain.d.ts +54 -0
- package/dist/server/slot-subtree-contain.d.ts.map +1 -0
- package/dist/server/ssr-bridge-types.d.ts +213 -0
- package/dist/server/ssr-bridge-types.d.ts.map +1 -0
- package/dist/server/ssr-entry.d.ts +15 -51
- package/dist/server/ssr-entry.d.ts.map +1 -1
- package/dist/server/ssr-form-state.d.ts +30 -0
- package/dist/server/ssr-form-state.d.ts.map +1 -0
- package/dist/server/ssr-render.d.ts +42 -12
- package/dist/server/ssr-render.d.ts.map +1 -1
- package/dist/server/ssr-wrappers.d.ts +92 -0
- package/dist/server/ssr-wrappers.d.ts.map +1 -0
- package/dist/server/state-tree-diff.d.ts +44 -9
- package/dist/server/state-tree-diff.d.ts.map +1 -1
- package/dist/server/static-generator.d.ts +112 -0
- package/dist/server/static-generator.d.ts.map +1 -0
- package/dist/server/static-not-found.d.ts +52 -0
- package/dist/server/static-not-found.d.ts.map +1 -0
- package/dist/server/status-code-resolver.d.ts +26 -15
- package/dist/server/status-code-resolver.d.ts.map +1 -1
- package/dist/server/stream-utils.d.ts +93 -0
- package/dist/server/stream-utils.d.ts.map +1 -0
- package/dist/server/traced-access.d.ts +18 -0
- package/dist/server/traced-access.d.ts.map +1 -0
- package/dist/server/tracing.d.ts +72 -31
- package/dist/server/tracing.d.ts.map +1 -1
- package/dist/server/tree-match.d.ts +59 -0
- package/dist/server/tree-match.d.ts.map +1 -0
- package/dist/server/types.d.ts +90 -8
- package/dist/server/types.d.ts.map +1 -1
- package/dist/server/utils/element-type.d.ts +50 -0
- package/dist/server/utils/element-type.d.ts.map +1 -0
- package/dist/server/utils/escape-html.d.ts +14 -0
- package/dist/server/utils/escape-html.d.ts.map +1 -0
- package/dist/server/version-skew.d.ts +61 -0
- package/dist/server/version-skew.d.ts.map +1 -0
- package/dist/server/workers-cache-bridge.d.ts +26 -0
- package/dist/server/workers-cache-bridge.d.ts.map +1 -0
- package/dist/shared/als-slots.d.ts +42 -0
- package/dist/shared/als-slots.d.ts.map +1 -0
- package/dist/shared/base-path.d.ts +56 -0
- package/dist/shared/base-path.d.ts.map +1 -0
- package/dist/shared/csrf-reject.d.ts +16 -0
- package/dist/shared/csrf-reject.d.ts.map +1 -0
- package/dist/shared/dev-span.d.ts +99 -0
- package/dist/shared/dev-span.d.ts.map +1 -0
- package/dist/shared/error-digest.d.ts +28 -0
- package/dist/shared/error-digest.d.ts.map +1 -0
- package/dist/shared/flight-base64.d.ts +13 -0
- package/dist/shared/flight-base64.d.ts.map +1 -0
- package/dist/shared/flight-segment.d.ts +18 -0
- package/dist/shared/flight-segment.d.ts.map +1 -0
- package/dist/shared/form-state-flight.d.ts +32 -0
- package/dist/shared/form-state-flight.d.ts.map +1 -0
- package/dist/shared/href-validation.d.ts +49 -0
- package/dist/shared/href-validation.d.ts.map +1 -0
- package/dist/shared/href.d.ts +88 -0
- package/dist/shared/href.d.ts.map +1 -0
- package/dist/shared/merge-search-params.d.ts +22 -0
- package/dist/shared/merge-search-params.d.ts.map +1 -0
- package/dist/shared/param-value.d.ts +104 -0
- package/dist/shared/param-value.d.ts.map +1 -0
- package/dist/shared/payload-root.d.ts +110 -0
- package/dist/shared/payload-root.d.ts.map +1 -0
- package/dist/shared/redirect-type.d.ts +17 -0
- package/dist/shared/redirect-type.d.ts.map +1 -0
- package/dist/shared/rsc-cache-key.d.ts +163 -0
- package/dist/shared/rsc-cache-key.d.ts.map +1 -0
- package/dist/shared/rsc-error-envelope.d.ts +16 -0
- package/dist/shared/rsc-error-envelope.d.ts.map +1 -0
- package/dist/shared/rsc-manifest.d.ts +28 -0
- package/dist/shared/rsc-manifest.d.ts.map +1 -0
- package/dist/shared/rsc-media-type.d.ts +52 -0
- package/dist/shared/rsc-media-type.d.ts.map +1 -0
- package/dist/shared/rsc-payload-path.d.ts +48 -0
- package/dist/shared/rsc-payload-path.d.ts.map +1 -0
- package/dist/shared/segment-info.d.ts +66 -0
- package/dist/shared/segment-info.d.ts.map +1 -0
- package/dist/shared/slot-params.d.ts +52 -0
- package/dist/shared/slot-params.d.ts.map +1 -0
- package/dist/shared/static-platform-files.d.ts +71 -0
- package/dist/shared/static-platform-files.d.ts.map +1 -0
- package/dist/shared/status-reason-phrase.d.ts +26 -0
- package/dist/shared/status-reason-phrase.d.ts.map +1 -0
- package/dist/shims/font-google.d.ts +1 -1
- package/dist/shims/font-google.d.ts.map +1 -1
- package/dist/shims/font-google.js +41 -0
- package/dist/shims/font-google.js.map +1 -0
- package/dist/shims/font-local.d.ts +26 -0
- package/dist/shims/font-local.d.ts.map +1 -0
- package/dist/shims/font-local.js +19 -0
- package/dist/shims/font-local.js.map +1 -0
- package/dist/shims/headers.d.ts +60 -1
- package/dist/shims/headers.d.ts.map +1 -1
- package/dist/shims/image.d.ts +120 -120
- package/dist/shims/image.d.ts.map +1 -1
- package/dist/shims/navigation-client.d.ts +25 -12
- package/dist/shims/navigation-client.d.ts.map +1 -1
- package/dist/shims/navigation-rsc.d.ts +21 -0
- package/dist/shims/navigation-rsc.d.ts.map +1 -0
- package/dist/shims/navigation.d.ts +10 -5
- package/dist/shims/navigation.d.ts.map +1 -1
- package/dist/utils/state-machine.d.ts +80 -0
- package/dist/utils/state-machine.d.ts.map +1 -0
- package/dist/utils/write-file-atomic.d.ts +17 -0
- package/dist/utils/write-file-atomic.d.ts.map +1 -0
- package/docs/api/30-api-server.mdx +241 -0
- package/docs/api/31-api-client.mdx +225 -0
- package/docs/api/32-api-cache.mdx +341 -0
- package/docs/api/33-api-search-params.mdx +178 -0
- package/docs/api/34-api-config.mdx +421 -0
- package/docs/api/35-api-typescript.mdx +123 -0
- package/docs/api/36-cli.mdx +272 -0
- package/docs/learn/00-introduction.mdx +109 -0
- package/docs/learn/01-quick-start.mdx +94 -0
- package/docs/learn/02-pages-and-layouts.mdx +147 -0
- package/docs/learn/03-fetching-data.mdx +227 -0
- package/docs/learn/04-access-control.mdx +115 -0
- package/docs/learn/05-the-flush-point.mdx +175 -0
- package/docs/learn/06-typed-params.mdx +275 -0
- package/docs/learn/07-typed-routes.mdx +173 -0
- package/docs/learn/08-forms-and-actions.mdx +260 -0
- package/docs/learn/09-streaming.mdx +146 -0
- package/docs/learn/10-caching.mdx +303 -0
- package/docs/learn/11-middleware.mdx +166 -0
- package/docs/learn/12-error-handling.mdx +192 -0
- package/docs/learn/13-deploying.mdx +289 -0
- package/llms.txt +55 -0
- package/package.json +124 -29
- package/src/adapters/build-output-helper.ts +375 -0
- package/src/adapters/canonicalize-module.ts +29 -0
- package/src/adapters/cloudflare-dev.ts +183 -0
- package/src/adapters/cloudflare-kv-cache.ts +203 -0
- package/src/adapters/cloudflare.ts +799 -151
- package/src/adapters/compress-module.ts +110 -86
- package/src/adapters/fs-identity.ts +155 -0
- package/src/adapters/nitro-immutable-assets.ts +142 -0
- package/src/adapters/nitro-presets.ts +139 -0
- package/src/adapters/nitro-preview.ts +565 -0
- package/src/adapters/nitro.ts +349 -448
- package/src/adapters/raw-imports.d.ts +5 -0
- package/src/adapters/shared.ts +314 -0
- package/src/adapters/types.ts +129 -17
- package/src/adapters/wrangler.d.ts +7 -0
- package/src/analyze/chains.ts +411 -0
- package/src/analyze/classify.ts +259 -0
- package/src/analyze/crawl-entry.ts +68 -0
- package/src/analyze/crawl.ts +500 -0
- package/src/analyze/graph-cache.ts +331 -0
- package/src/analyze/graph-command.ts +654 -0
- package/src/analyze/live-graph.ts +232 -0
- package/src/analyze/poison-rules.ts +165 -0
- package/src/analyze/poison-scan.ts +159 -0
- package/src/analyze/scan.ts +149 -0
- package/src/cache/cache-api.ts +113 -0
- package/src/cache/fast-hash.ts +5 -0
- package/src/cache/guarded-read.ts +44 -0
- package/src/cache/handler-store.ts +113 -0
- package/src/cache/index.ts +93 -20
- package/src/cache/invalidation-epoch.ts +105 -0
- package/src/cache/json-lossy-check.ts +69 -0
- package/src/cache/key-discipline.ts +218 -0
- package/src/cache/redis-handler.ts +193 -19
- package/src/cache/singleflight.ts +85 -7
- package/src/cache/sizeof.ts +35 -0
- package/src/cache/stable-stringify.ts +118 -2
- package/src/cache/store.ts +71 -0
- package/src/cache/stores/cloudflare-kv.ts +52 -0
- package/src/cache/stores/memory.ts +125 -0
- package/src/cache/stores/redis.ts +97 -0
- package/src/cache/stores/vercel.ts +59 -0
- package/src/cache/tag-aware-handler.ts +250 -0
- package/src/cache/timber-cache.ts +218 -47
- package/src/cdn/cloudflare-purge.ts +50 -0
- package/src/cdn/fastly-purge.ts +63 -0
- package/src/cdn/headers.ts +153 -0
- package/src/cdn/index.ts +23 -0
- package/src/cdn/purge-store.ts +62 -0
- package/src/cdn/workers-cache-purge.ts +34 -0
- package/src/cli-check.ts +417 -0
- package/src/cli-context.ts +128 -0
- package/src/cli-dev-status.ts +196 -0
- package/src/cli-init.ts +278 -0
- package/src/cli-schema-sync.ts +401 -0
- package/src/cli.ts +308 -84
- package/src/client/browser-dev.ts +192 -5
- package/src/client/browser-entry/action-dispatch.ts +317 -0
- package/src/client/browser-entry/action-queue.ts +152 -0
- package/src/client/browser-entry/form-state.ts +49 -0
- package/src/client/browser-entry/hmr.ts +82 -0
- package/src/client/browser-entry/hydrate.ts +152 -0
- package/src/client/browser-entry/index.ts +153 -0
- package/src/client/browser-entry/post-hydration.ts +99 -0
- package/src/client/browser-entry/router-init.ts +391 -0
- package/src/client/browser-entry/rsc-stream.ts +145 -0
- package/src/client/browser-entry/scroll.ts +50 -0
- package/src/client/deny-last-resort.tsx +54 -0
- package/src/client/dev-pill/index.ts +128 -0
- package/src/client/dev-pill/store.ts +254 -0
- package/src/client/dev-pill/view.ts +326 -0
- package/src/client/error-boundary.tsx +296 -61
- package/src/client/error-reconstituter.tsx +84 -0
- package/src/client/form.tsx +61 -173
- package/src/client/global-context.ts +59 -0
- package/src/client/history.ts +74 -11
- package/src/client/index.ts +93 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +284 -204
- package/src/client/location-search.ts +15 -0
- package/src/client/navigation-api.ts +254 -0
- package/src/client/navigation-commit.ts +318 -0
- package/src/client/navigation-context.ts +71 -142
- package/src/client/navigation-root.tsx +237 -0
- package/src/client/navigation-transition.ts +401 -0
- package/src/client/nuqs-adapter.tsx +62 -32
- package/src/client/params-context.ts +175 -0
- package/src/client/react-root.ts +105 -0
- package/src/client/router-effects.ts +349 -0
- package/src/client/router-lifecycle.ts +394 -0
- package/src/client/router-pipeline.ts +443 -0
- package/src/client/router-ref.ts +3 -3
- package/src/client/router-skew.ts +30 -0
- package/src/client/router-types.ts +326 -0
- package/src/client/router-url.ts +32 -0
- package/src/client/router.ts +491 -421
- package/src/client/rsc-fetch.ts +510 -109
- package/src/client/segment-cache.ts +362 -41
- package/src/client/segment-context.ts +7 -4
- package/src/client/segment-outlet.tsx +96 -0
- package/src/client/segment-update-context.ts +23 -0
- package/src/client/shallow-url.ts +22 -0
- package/src/client/slot-content-cache-context.ts +43 -0
- package/src/client/slot-context.ts +39 -0
- package/src/client/slot-outlet.tsx +22 -0
- package/src/client/slot-provider.tsx +32 -0
- package/src/client/ssr-data.ts +27 -67
- package/src/client/stale-client.ts +191 -0
- package/src/client/state.ts +31 -24
- package/src/client/status-page-marker.tsx +32 -0
- package/src/client/top-loader.tsx +13 -10
- package/src/client/unload-guard.ts +35 -3
- package/src/client/use-cookie.ts +93 -29
- package/src/client/use-field-state.ts +144 -0
- package/src/client/use-link-status.ts +7 -7
- package/src/client/use-pathname.ts +22 -31
- package/src/client/use-pending-navigation.ts +119 -0
- package/src/client/use-query-states.ts +206 -36
- package/src/client/use-router.ts +31 -9
- package/src/client/use-search-params.ts +38 -49
- package/src/client/use-segment-params.ts +69 -0
- package/src/client/use-selected-layout-segment.ts +2 -2
- package/src/codec.ts +149 -0
- package/src/config-types.ts +366 -0
- package/src/config-validation.ts +511 -0
- package/src/cookies/define-cookie.ts +186 -53
- package/src/cookies/index.ts +13 -2
- package/src/cookies/json-cookie.ts +105 -0
- package/src/cookies/validation.ts +192 -0
- package/src/dev-tools/404-page.ts +286 -0
- package/src/dev-tools/await-span.ts +69 -0
- package/src/dev-tools/browser-logs.ts +55 -0
- package/src/dev-tools/dev-page-shell.ts +278 -0
- package/src/dev-tools/error-page.ts +331 -0
- package/src/dev-tools/holding-server.ts +185 -0
- package/src/dev-tools/hydration-overlay.ts +158 -0
- package/src/dev-tools/index.ts +79 -0
- package/src/dev-tools/instrumentation.ts +281 -0
- package/src/{server/dev-logger.ts → dev-tools/logger.ts} +36 -88
- package/src/{plugins/dev-logs.ts → dev-tools/logs.ts} +158 -27
- package/src/{plugins/dev-error-overlay.ts → dev-tools/overlay.ts} +25 -80
- package/src/dev-tools/span-sink.ts +132 -0
- package/src/dev-tools/stack-classifier.ts +75 -0
- package/src/dev-tools/terminal.ts +182 -0
- package/src/fonts/ast-walk.ts +235 -0
- package/src/fonts/ast.ts +479 -128
- package/src/fonts/bundle.ts +138 -0
- package/src/fonts/css.ts +1 -1
- package/src/fonts/dev-middleware.ts +85 -0
- package/src/fonts/fallbacks.ts +0 -23
- package/src/fonts/google.ts +101 -19
- package/src/fonts/local.ts +12 -11
- package/src/fonts/paths.ts +58 -0
- package/src/fonts/pipeline.ts +348 -0
- package/src/fonts/transform.ts +311 -0
- package/src/fonts/types.ts +52 -1
- package/src/fonts/virtual-modules.ts +179 -0
- package/src/index.ts +501 -380
- package/src/params/codec-registry.ts +47 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +16 -0
- package/src/params/resolve-schema.ts +84 -0
- package/src/plugin-context.ts +509 -0
- package/src/plugins/build-manifest.ts +189 -36
- package/src/plugins/build-report.ts +299 -87
- package/src/plugins/cache.ts +243 -0
- package/src/plugins/callsite-ast.ts +472 -0
- package/src/plugins/callsite-jsx.ts +243 -0
- package/src/plugins/chunks.ts +74 -5
- package/src/plugins/client-chunks.ts +185 -0
- package/src/plugins/client-dep-entries.ts +124 -0
- package/src/plugins/client-in-server-package-deps.ts +139 -0
- package/src/plugins/cloudflare-wasm.ts +141 -0
- package/src/plugins/content.ts +31 -2
- package/src/plugins/dev-await.ts +415 -0
- package/src/plugins/dev-discovery.ts +428 -0
- package/src/plugins/dev-hostname.ts +322 -0
- package/src/plugins/dev-server.ts +471 -100
- package/src/plugins/dev-store-clear.ts +145 -0
- package/src/plugins/encryption-runtime.ts +31 -0
- package/src/plugins/entries.ts +158 -17
- package/src/plugins/fonts.ts +260 -657
- package/src/plugins/graph-endpoint.ts +544 -0
- package/src/plugins/mdx.ts +108 -35
- package/src/plugins/optimize-package-imports-defaults.ts +88 -0
- package/src/plugins/optimize-package-imports.ts +439 -0
- package/src/plugins/orphaned-modules.ts +78 -0
- package/src/plugins/post-build.ts +327 -0
- package/src/plugins/prebuilt-capture.ts +213 -0
- package/src/plugins/prebuilt-options-analysis.ts +175 -0
- package/src/plugins/prebuilt.ts +679 -0
- package/src/plugins/prerender-sugar.ts +348 -0
- package/src/plugins/react-resolve.ts +149 -0
- package/src/plugins/request-dep/analysis.ts +447 -0
- package/src/plugins/request-dep/index.ts +376 -0
- package/src/plugins/request-dep/origin.ts +310 -0
- package/src/plugins/routing.ts +296 -278
- package/src/plugins/rsc-assets-manifest.ts +251 -0
- package/src/plugins/server-bundle.ts +115 -15
- package/src/plugins/shims.ts +267 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -0
- package/src/routes/href.ts +171 -0
- package/src/routes/index.ts +10 -0
- package/src/routing/codegen-shared.ts +39 -0
- package/src/routing/codegen-types.ts +62 -0
- package/src/routing/codegen-write.ts +163 -0
- package/src/routing/codegen.ts +356 -232
- package/src/routing/collision-probe.ts +438 -0
- package/src/routing/collision-spaces.ts +281 -0
- package/src/routing/convention-lint.ts +649 -0
- package/src/routing/export-detect.ts +536 -0
- package/src/routing/file-cache.ts +23 -0
- package/src/routing/index.ts +16 -7
- package/src/routing/interception-overlap.ts +141 -0
- package/src/routing/interception.ts +1044 -67
- package/src/routing/link-codegen.ts +346 -0
- package/src/routing/manifest-codegen.ts +232 -0
- package/src/routing/scanner.ts +417 -223
- package/src/routing/schema-validation.ts +155 -0
- package/src/routing/segment-classify.ts +280 -0
- package/src/routing/segment-codegen.ts +99 -0
- package/src/routing/segment-keys.ts +186 -0
- package/src/routing/slot-placement.ts +97 -0
- package/src/routing/types.ts +82 -26
- package/src/routing/walkers.ts +98 -0
- package/src/rsc-runtime/dev-reference-cache.ts +115 -0
- package/src/rsc-runtime/encryption-runtime.ts +78 -0
- package/src/rsc-runtime/render-flight.ts +26 -0
- package/src/rsc-runtime/rsc.ts +35 -5
- package/src/rsc-runtime/server-reference-load-error.ts +16 -0
- package/src/rsc-runtime/server-references.ts +135 -0
- package/src/rsc-runtime/ssr.ts +23 -0
- package/src/rsc-runtime/transforms.ts +13 -0
- package/src/rsc-runtime/vendor-types.d.ts +87 -0
- package/src/schema-bridge.ts +437 -0
- package/src/search-params/define.ts +676 -0
- package/src/search-params/index.ts +14 -20
- package/src/search-params/parse-total.ts +91 -0
- package/src/search-params/serialize-equal.ts +14 -0
- package/src/search-params/wrappers.ts +150 -0
- package/src/server/abort-scope.ts +49 -0
- package/src/server/access-gate.tsx +208 -57
- package/src/server/action-client.ts +175 -294
- package/src/server/action-encryption.ts +144 -0
- package/src/server/action-handler.ts +533 -150
- package/src/server/action-schema.ts +203 -0
- package/src/server/action-types.ts +145 -0
- package/src/server/actions.ts +172 -85
- package/src/server/als-registry.ts +245 -30
- package/src/server/body-limits.ts +10 -2
- package/src/server/build-manifest.ts +33 -57
- package/src/server/canonicalize.ts +62 -3
- package/src/server/chain-url-parts.ts +163 -0
- package/src/server/children-interception.ts +116 -0
- package/src/server/client-error-message.ts +18 -0
- package/src/server/coalesce-tick.ts +75 -0
- package/src/server/compress.ts +91 -19
- package/src/server/cookie-context.ts +462 -0
- package/src/server/cookie-parsing.ts +163 -0
- package/src/server/csp-nonce.ts +58 -0
- package/src/server/csrf.ts +238 -37
- package/src/server/debug.ts +0 -1
- package/src/server/default-logger.ts +100 -0
- package/src/server/default-status-page.ts +88 -0
- package/src/server/deny-boundary.ts +527 -0
- package/src/server/deny-renderer.ts +210 -181
- package/src/server/early-hints-sender.ts +4 -3
- package/src/server/early-hints.ts +39 -29
- package/src/server/error-boundary-wrapper.ts +160 -44
- package/src/server/error-response-headers.ts +18 -0
- package/src/server/fallback-error.ts +88 -104
- package/src/server/flight-injection-state.ts +113 -0
- package/src/server/flight-injector-core.ts +332 -0
- package/src/server/flight-scripts.ts +92 -0
- package/src/server/flight-source-node.ts +434 -0
- package/src/server/flight-source.ts +289 -0
- package/src/server/form-data.ts +191 -20
- package/src/server/form-state-flight.ts +67 -0
- package/src/server/head-response.ts +50 -0
- package/src/server/html-injector-core.ts +320 -0
- package/src/server/html-injectors.ts +241 -285
- package/src/server/index.ts +42 -195
- package/src/server/instrumentation.ts +42 -11
- package/src/server/interception-gates.ts +94 -0
- package/src/server/internal.ts +164 -0
- package/src/server/json-status-response.ts +105 -0
- package/src/server/logger.ts +163 -38
- package/src/server/metadata-collector.ts +175 -0
- package/src/server/metadata-platform.ts +2 -2
- package/src/server/metadata-render.ts +30 -8
- package/src/server/metadata-route-links.ts +200 -0
- package/src/server/metadata-routes.ts +114 -24
- package/src/server/metadata-social.ts +2 -2
- package/src/server/metadata.ts +23 -2
- package/src/server/middleware-runner.ts +32 -5
- package/src/server/node-body-response.ts +236 -0
- package/src/server/node-response.ts +93 -0
- package/src/server/node-stream-transforms.ts +340 -0
- package/src/server/node-streams-platform.ts +23 -0
- package/src/server/param-coercion.ts +205 -0
- package/src/server/pipeline-helpers.ts +554 -0
- package/src/server/pipeline-interception.ts +301 -32
- package/src/server/pipeline-metadata-route.ts +242 -0
- package/src/server/pipeline-metadata.ts +30 -4
- package/src/server/pipeline-outcome.ts +290 -0
- package/src/server/pipeline-phases.ts +443 -0
- package/src/server/pipeline.ts +474 -427
- package/src/server/port-resolution.ts +43 -0
- package/src/server/prebuilt/cache-key.ts +340 -0
- package/src/server/prebuilt/capture-render.ts +122 -0
- package/src/server/prebuilt/capture-routes.ts +104 -0
- package/src/server/prebuilt/capture-state.ts +196 -0
- package/src/server/prebuilt/dev-store.ts +252 -0
- package/src/server/prebuilt/lifetime.ts +151 -0
- package/src/server/prebuilt/manifest-tag-index.ts +46 -0
- package/src/server/prebuilt/overlay.ts +290 -0
- package/src/server/prebuilt/payload-source.ts +221 -0
- package/src/server/prebuilt/slots.ts +201 -0
- package/src/server/prebuilt/synthetic-store.ts +125 -0
- package/src/server/prebuilt-builder.ts +515 -0
- package/src/server/prebuilt-runtime.ts +830 -0
- package/src/server/primitives.ts +167 -171
- package/src/server/publish-params.ts +42 -0
- package/src/server/react-cache-bridge.ts +124 -0
- package/src/server/react-cache-scope.ts +104 -0
- package/src/server/render-timeout.ts +123 -0
- package/src/server/render-utils.ts +70 -0
- package/src/server/request-context.ts +321 -323
- package/src/server/request-dep.ts +37 -0
- package/src/server/response-cache-policy.ts +45 -0
- package/src/server/response-framing.ts +59 -0
- package/src/server/route-element-builder.ts +539 -355
- package/src/server/route-element-helpers.ts +37 -0
- package/src/server/route-handler.ts +78 -48
- package/src/server/route-matcher.ts +251 -265
- package/src/server/route-methods.ts +37 -0
- package/src/server/route-module-loader.ts +161 -0
- package/src/server/rsc-cache-key-guard.ts +122 -0
- package/src/server/rsc-entry/action-dispatcher.ts +146 -0
- package/src/server/rsc-entry/action-middleware-runner.ts +130 -0
- package/src/server/rsc-entry/api-handler.ts +30 -93
- package/src/server/rsc-entry/deny-fallback.ts +151 -0
- package/src/server/rsc-entry/error-renderer.ts +306 -113
- package/src/server/rsc-entry/helpers.ts +90 -115
- package/src/server/rsc-entry/index.ts +420 -350
- package/src/server/rsc-entry/render-route.ts +248 -0
- package/src/server/rsc-entry/render-signals.ts +108 -0
- package/src/server/rsc-entry/revalidate-renderer.ts +349 -0
- package/src/server/rsc-entry/rsc-payload.ts +212 -113
- package/src/server/rsc-entry/rsc-stream.ts +143 -135
- package/src/server/rsc-entry/ssr-bridge.ts +43 -8
- package/src/server/rsc-entry/ssr-renderer.ts +311 -140
- package/src/server/rsc-error-envelope.ts +18 -0
- package/src/server/rsc-prop-warnings.ts +1 -1
- package/src/server/safe-load.ts +53 -0
- package/src/server/schema-introspection.ts +393 -0
- package/src/server/sensitive-fields.ts +287 -0
- package/src/server/server-only-guard-noop.js +3 -0
- package/src/server/server-timing.ts +1 -1
- package/src/server/signal-identity.ts +130 -0
- package/src/server/sitemap-generator.ts +337 -0
- package/src/server/sitemap-handler.ts +150 -0
- package/src/server/skippable-prefix.ts +172 -0
- package/src/server/slot-interception.ts +168 -0
- package/src/server/slot-resolver.ts +747 -300
- package/src/server/slot-subtree-contain.ts +273 -0
- package/src/server/ssr-bridge-types.ts +217 -0
- package/src/server/ssr-entry.ts +246 -109
- package/src/server/ssr-form-state.ts +58 -0
- package/src/server/ssr-render.ts +253 -113
- package/src/server/ssr-wrappers.tsx +152 -0
- package/src/server/state-tree-diff.ts +85 -30
- package/src/server/static-generator.ts +680 -0
- package/src/server/static-not-found.ts +134 -0
- package/src/server/status-code-resolver.ts +107 -148
- package/src/server/stream-utils.ts +398 -0
- package/src/server/traced-access.ts +50 -0
- package/src/server/tracing.ts +274 -128
- package/src/server/tree-match.ts +494 -0
- package/src/server/types.ts +97 -11
- package/src/server/utils/element-type.ts +88 -0
- package/src/server/utils/escape-html.ts +20 -0
- package/src/server/version-skew.ts +104 -0
- package/src/server/waituntil-bridge.ts +1 -1
- package/src/server/workers-cache-bridge.ts +33 -0
- package/src/shared/als-slots.ts +74 -0
- package/src/shared/base-path.ts +80 -0
- package/src/shared/csrf-reject.ts +15 -0
- package/src/shared/dev-span.ts +188 -0
- package/src/shared/error-digest.ts +46 -0
- package/src/shared/flight-base64.ts +23 -0
- package/src/shared/flight-segment.ts +35 -0
- package/src/shared/form-state-flight.ts +59 -0
- package/src/shared/href-validation.ts +159 -0
- package/src/shared/href.ts +257 -0
- package/src/shared/merge-search-params.ts +55 -0
- package/src/shared/param-value.ts +281 -0
- package/src/shared/payload-root.ts +153 -0
- package/src/shared/redirect-type.ts +17 -0
- package/src/shared/rsc-cache-key.ts +269 -0
- package/src/shared/rsc-error-envelope.ts +16 -0
- package/src/shared/rsc-manifest.ts +29 -0
- package/src/shared/rsc-media-type.ts +59 -0
- package/src/shared/rsc-payload-path.ts +52 -0
- package/src/shared/segment-info.ts +67 -0
- package/src/shared/slot-params.ts +109 -0
- package/src/shared/static-platform-files.ts +75 -0
- package/src/shared/status-reason-phrase.ts +61 -0
- package/src/shims/font-google.ts +1 -1
- package/src/shims/font-local.ts +34 -0
- package/src/shims/headers.ts +130 -1
- package/src/shims/navigation-client.ts +36 -32
- package/src/shims/navigation-rsc.ts +47 -0
- package/src/shims/navigation.ts +10 -7
- package/src/utils/state-machine.ts +111 -0
- package/src/utils/write-file-atomic.ts +32 -0
- package/dist/_chunks/als-registry-B7DbZ2hS.js +0 -41
- package/dist/_chunks/als-registry-B7DbZ2hS.js.map +0 -1
- package/dist/_chunks/debug-B3Gypr3D.js +0 -108
- package/dist/_chunks/debug-B3Gypr3D.js.map +0 -1
- package/dist/_chunks/format-RyoGQL74.js +0 -164
- package/dist/_chunks/format-RyoGQL74.js.map +0 -1
- package/dist/_chunks/interception-BOoWmLUA.js +0 -676
- package/dist/_chunks/interception-BOoWmLUA.js.map +0 -1
- package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map +0 -1
- package/dist/_chunks/request-context-BQUC8PHn.js +0 -330
- package/dist/_chunks/request-context-BQUC8PHn.js.map +0 -1
- package/dist/_chunks/ssr-data-MjmprTmO.js +0 -88
- package/dist/_chunks/ssr-data-MjmprTmO.js.map +0 -1
- package/dist/_chunks/tracing-CemImE6h.js +0 -187
- package/dist/_chunks/tracing-CemImE6h.js.map +0 -1
- package/dist/_chunks/use-cookie-DX-l1_5E.js +0 -91
- package/dist/_chunks/use-cookie-DX-l1_5E.js.map +0 -1
- package/dist/_chunks/use-query-states-D5KaffOK.js +0 -109
- package/dist/_chunks/use-query-states-D5KaffOK.js.map +0 -1
- package/dist/adapters/cloudflare.js.map +0 -1
- package/dist/cache/index.js.map +0 -1
- package/dist/cache/register-cached-function.d.ts +0 -17
- package/dist/cache/register-cached-function.d.ts.map +0 -1
- package/dist/client/browser-entry.d.ts +0 -21
- package/dist/client/browser-entry.d.ts.map +0 -1
- package/dist/client/error-boundary.js.map +0 -1
- package/dist/client/head.d.ts +0 -16
- package/dist/client/head.d.ts.map +0 -1
- package/dist/client/link-status-provider.d.ts +0 -11
- package/dist/client/link-status-provider.d.ts.map +0 -1
- package/dist/client/segment-merger.d.ts +0 -119
- package/dist/client/segment-merger.d.ts.map +0 -1
- package/dist/client/stale-reload.d.ts +0 -44
- package/dist/client/stale-reload.d.ts.map +0 -1
- package/dist/client/transition-root.d.ts +0 -74
- package/dist/client/transition-root.d.ts.map +0 -1
- package/dist/client/types.d.ts +0 -14
- package/dist/client/types.d.ts.map +0 -1
- package/dist/client/use-navigation-pending.d.ts +0 -26
- package/dist/client/use-navigation-pending.d.ts.map +0 -1
- package/dist/client/use-params.d.ts +0 -92
- package/dist/client/use-params.d.ts.map +0 -1
- package/dist/content/index.d.ts +0 -11
- package/dist/content/index.d.ts.map +0 -1
- package/dist/content/index.js +0 -2
- package/dist/plugins/adapter-build.d.ts +0 -18
- package/dist/plugins/adapter-build.d.ts.map +0 -1
- package/dist/plugins/cache-transform.d.ts +0 -36
- package/dist/plugins/cache-transform.d.ts.map +0 -1
- package/dist/plugins/dev-error-overlay.d.ts.map +0 -1
- package/dist/plugins/dev-logs.d.ts.map +0 -1
- package/dist/plugins/dynamic-transform.d.ts +0 -72
- package/dist/plugins/dynamic-transform.d.ts.map +0 -1
- package/dist/plugins/server-action-exports.d.ts +0 -26
- package/dist/plugins/server-action-exports.d.ts.map +0 -1
- package/dist/routing/status-file-lint.d.ts +0 -33
- package/dist/routing/status-file-lint.d.ts.map +0 -1
- package/dist/search-params/analyze.d.ts +0 -54
- package/dist/search-params/analyze.d.ts.map +0 -1
- package/dist/search-params/builtin-codecs.d.ts +0 -105
- package/dist/search-params/builtin-codecs.d.ts.map +0 -1
- package/dist/search-params/codecs.d.ts +0 -53
- package/dist/search-params/codecs.d.ts.map +0 -1
- package/dist/search-params/create.d.ts +0 -106
- package/dist/search-params/create.d.ts.map +0 -1
- package/dist/search-params/registry.d.ts +0 -20
- package/dist/search-params/registry.d.ts.map +0 -1
- package/dist/server/asset-headers.d.ts +0 -42
- package/dist/server/asset-headers.d.ts.map +0 -1
- package/dist/server/client-module-map.d.ts +0 -47
- package/dist/server/client-module-map.d.ts.map +0 -1
- package/dist/server/dev-fetch-instrumentation.d.ts +0 -22
- package/dist/server/dev-fetch-instrumentation.d.ts.map +0 -1
- package/dist/server/dev-logger.d.ts.map +0 -1
- package/dist/server/dev-span-processor.d.ts +0 -29
- package/dist/server/dev-span-processor.d.ts.map +0 -1
- package/dist/server/dev-warnings.d.ts +0 -129
- package/dist/server/dev-warnings.d.ts.map +0 -1
- package/dist/server/flush.d.ts +0 -74
- package/dist/server/flush.d.ts.map +0 -1
- package/dist/server/form-flash.d.ts +0 -78
- package/dist/server/form-flash.d.ts.map +0 -1
- package/dist/server/manifest-status-resolver.d.ts +0 -58
- package/dist/server/manifest-status-resolver.d.ts.map +0 -1
- package/dist/server/nuqs-ssr-provider.d.ts +0 -28
- package/dist/server/nuqs-ssr-provider.d.ts.map +0 -1
- package/dist/server/prerender.d.ts +0 -77
- package/dist/server/prerender.d.ts.map +0 -1
- package/dist/server/tree-builder.d.ts +0 -126
- package/dist/server/tree-builder.d.ts.map +0 -1
- package/dist/utils/directive-parser.d.ts +0 -70
- package/dist/utils/directive-parser.d.ts.map +0 -1
- package/src/cache/register-cached-function.ts +0 -103
- package/src/client/browser-entry.ts +0 -678
- package/src/client/head.ts +0 -61
- package/src/client/link-status-provider.tsx +0 -30
- package/src/client/segment-merger.ts +0 -339
- package/src/client/stale-reload.ts +0 -87
- package/src/client/transition-root.tsx +0 -166
- package/src/client/types.ts +0 -21
- package/src/client/use-navigation-pending.ts +0 -38
- package/src/client/use-params.ts +0 -141
- package/src/content/index.ts +0 -13
- package/src/plugins/adapter-build.ts +0 -118
- package/src/plugins/cache-transform.ts +0 -199
- package/src/plugins/dynamic-transform.ts +0 -161
- package/src/plugins/server-action-exports.ts +0 -220
- package/src/routing/status-file-lint.ts +0 -112
- package/src/search-params/analyze.ts +0 -192
- package/src/search-params/builtin-codecs.ts +0 -228
- package/src/search-params/codecs.ts +0 -153
- package/src/search-params/create.ts +0 -321
- package/src/search-params/registry.ts +0 -31
- package/src/server/asset-headers.ts +0 -81
- package/src/server/client-module-map.ts +0 -58
- package/src/server/dev-fetch-instrumentation.ts +0 -96
- package/src/server/dev-span-processor.ts +0 -78
- package/src/server/dev-warnings.ts +0 -283
- package/src/server/flush.ts +0 -182
- package/src/server/form-flash.ts +0 -89
- package/src/server/manifest-status-resolver.ts +0 -215
- package/src/server/nuqs-ssr-provider.tsx +0 -63
- package/src/server/prerender.ts +0 -139
- package/src/server/tree-builder.ts +0 -382
- package/src/shims/server-only-noop.js +0 -6
- package/src/utils/directive-parser.ts +0 -529
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 'Fetching Data'
|
|
3
|
+
description: 'Async server components, deny(404), and dynamic segments.'
|
|
4
|
+
slug: 'fetching-data'
|
|
5
|
+
notAI: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Fetching Data
|
|
9
|
+
|
|
10
|
+
```ts title="app/schema.ts" id="schema" hidden
|
|
11
|
+
import { defineSchema } from '@timber-js/app/params';
|
|
12
|
+
import { codec } from '@timber-js/app/codec';
|
|
13
|
+
|
|
14
|
+
export default defineSchema({
|
|
15
|
+
segmentParams: {
|
|
16
|
+
'[id]': codec.string,
|
|
17
|
+
},
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
declare function fetchProducts(opts: { take: number }): Promise<{ id: string; name: string }[]>;
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Timber and RSCs do not prescribe _where you must_ fetch data. They only give you _more optionality_ as to where.
|
|
24
|
+
|
|
25
|
+
**You** (the developer) can decide where and when you want to fetch data (whether it be the server, or the client, or at build-time). Let's walk through each.
|
|
26
|
+
|
|
27
|
+
Server components are async — in general, this is the first place to reach for data fetching (or querying).
|
|
28
|
+
|
|
29
|
+
```tsx title="app/page.tsx"
|
|
30
|
+
export default async function HomePage() {
|
|
31
|
+
const products = await fetchProducts({ take: 10 });
|
|
32
|
+
|
|
33
|
+
return (
|
|
34
|
+
<ul>
|
|
35
|
+
{products.map((p) => (
|
|
36
|
+
<li key={p.id}>{p.name}</li>
|
|
37
|
+
))}
|
|
38
|
+
</ul>
|
|
39
|
+
);
|
|
40
|
+
}
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Though it might feel confusing at first, you'll find that it's *often* the best place to fetch your data. It fits cleanly into the request/response model, prevents client-side waterfalls, and is generally the _fastest_ round-trip. Though there _will_ be scenarios where data fetching in other places (i.e. the client) make more sense depending on each context. Don't be afraid to mix and match data fetching, this is the whole point of timber: optionality.
|
|
44
|
+
|
|
45
|
+
## Dynamic Segments
|
|
46
|
+
|
|
47
|
+
Wrap a directory name in brackets to create a dynamic segment that captures a URL parameter:
|
|
48
|
+
|
|
49
|
+
```
|
|
50
|
+
app/
|
|
51
|
+
products/
|
|
52
|
+
[id]/
|
|
53
|
+
page.tsx # /products/42, /products/abc
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Access the param with `getSegmentParams()`. Import `SEGMENT_PATH` from `$segment` for exact types:
|
|
57
|
+
|
|
58
|
+
```tsx title="app/products/[id]/page.tsx" use="schema"
|
|
59
|
+
import { SEGMENT_PATH } from './$segment';
|
|
60
|
+
import { deny, getSegmentParams } from '@timber-js/app/server';
|
|
61
|
+
|
|
62
|
+
declare function getProduct(id: string): Promise<{ name: string; description: string } | null>;
|
|
63
|
+
|
|
64
|
+
export default async function ProductPage() {
|
|
65
|
+
const { id } = getSegmentParams(SEGMENT_PATH);
|
|
66
|
+
const product = await getProduct(id);
|
|
67
|
+
|
|
68
|
+
if (!product) return deny(404);
|
|
69
|
+
|
|
70
|
+
return (
|
|
71
|
+
<div>
|
|
72
|
+
<h1>{product.name}</h1>
|
|
73
|
+
<p>{product.description}</p>
|
|
74
|
+
</div>
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`deny(404)` sends a real HTTP 404 — not a 200 with an error message. Search engines, CDNs, and `curl -f` all see the correct status code. Other status codes, status-code files, and error boundaries are covered in [Error Handling](/docs/error-handling).
|
|
80
|
+
|
|
81
|
+
For typed params (numbers, UUIDs, enums), define codecs in `app/schema.ts`. See [Typed Params](/docs/typed-params).
|
|
82
|
+
|
|
83
|
+
## Server Components Span Three Environments
|
|
84
|
+
|
|
85
|
+
React Server Components split your code into three worlds:
|
|
86
|
+
|
|
87
|
+
**Server components** (default) — run on the server only. Their code never reaches the client. You can `await` database queries, access secrets, import heavy libraries. Zero client-side JavaScript cost.
|
|
88
|
+
|
|
89
|
+
**Client components** (`'use client'`) — run in the browser (and on the server for the initial HTML render). Use them for `useState`, `useEffect`, event handlers, and browser APIs.
|
|
90
|
+
|
|
91
|
+
**Server actions** (`'use server'`) — functions that run on the server but are callable from the client. Used for mutations — form submissions, data updates.
|
|
92
|
+
|
|
93
|
+
These compose. A server component can render a client component as a child. Server actions wire the client back to the server for mutations:
|
|
94
|
+
|
|
95
|
+
```tsx title="app/products/[id]/page.tsx" use="schema"
|
|
96
|
+
import { SEGMENT_PATH } from './$segment';
|
|
97
|
+
import { deny, getSegmentParams } from '@timber-js/app/server';
|
|
98
|
+
import { AddToCartButton } from './add-to-cart';
|
|
99
|
+
|
|
100
|
+
declare function getProduct(id: string): Promise<{ id: string; name: string } | null>;
|
|
101
|
+
|
|
102
|
+
export default async function ProductPage() {
|
|
103
|
+
const { id } = getSegmentParams(SEGMENT_PATH);
|
|
104
|
+
const product = await getProduct(id);
|
|
105
|
+
if (!product) return deny(404);
|
|
106
|
+
|
|
107
|
+
return (
|
|
108
|
+
<div>
|
|
109
|
+
<h1>{product.name}</h1>
|
|
110
|
+
<AddToCartButton productId={product.id} />
|
|
111
|
+
</div>
|
|
112
|
+
);
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
```tsx title="app/products/[id]/add-to-cart.tsx"
|
|
117
|
+
'use client';
|
|
118
|
+
|
|
119
|
+
import { useState } from 'react';
|
|
120
|
+
|
|
121
|
+
export function AddToCartButton({ productId }: { productId: string }) {
|
|
122
|
+
const [added, setAdded] = useState(false);
|
|
123
|
+
return (
|
|
124
|
+
<button onClick={() => setAdded(true)}>
|
|
125
|
+
{added ? 'Added ✓' : 'Add to Cart'}
|
|
126
|
+
</button>
|
|
127
|
+
);
|
|
128
|
+
}
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
The product page renders on the server (zero JS cost). The button hydrates on the client for interactivity.
|
|
132
|
+
|
|
133
|
+
## No Implicit Caching
|
|
134
|
+
|
|
135
|
+
`fetch()` is never patched or cached. A bare `fetch()` call hits the network every time. If you want cross-request caching, use `timber.cache()` — see [Caching](/docs/caching). If you want single-request caching, use `React.cache`.
|
|
136
|
+
|
|
137
|
+
Timber will never try to optimize your code through _magic_. If you want to build an efficient website, you'll have to understand when and where to place your caching or optimizations.
|
|
138
|
+
|
|
139
|
+
## Parallel Data Fetching
|
|
140
|
+
|
|
141
|
+
Fetch multiple things concurrently with `Promise.all`:
|
|
142
|
+
|
|
143
|
+
```tsx title="app/dashboard/page.tsx"
|
|
144
|
+
declare function getUser(): Promise<{ name: string }>;
|
|
145
|
+
declare function getStats(): Promise<{ revenue: number }>;
|
|
146
|
+
declare function getNotifications(): Promise<{ id: string; text: string }[]>;
|
|
147
|
+
|
|
148
|
+
export default async function DashboardPage() {
|
|
149
|
+
const [user, stats, notifications] = await Promise.all([
|
|
150
|
+
getUser(),
|
|
151
|
+
getStats(),
|
|
152
|
+
getNotifications(),
|
|
153
|
+
]);
|
|
154
|
+
|
|
155
|
+
return (
|
|
156
|
+
<div>
|
|
157
|
+
<UserHeader user={user} />
|
|
158
|
+
<StatsGrid stats={stats} />
|
|
159
|
+
<NotificationList items={notifications} />
|
|
160
|
+
</div>
|
|
161
|
+
);
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
## `React.cache` for Request Deduplication
|
|
166
|
+
|
|
167
|
+
If multiple components in the same request need the same data, use `React.cache`:
|
|
168
|
+
|
|
169
|
+
```tsx title="lib/data.ts"
|
|
170
|
+
import { cache } from 'react';
|
|
171
|
+
|
|
172
|
+
declare function fetchUser(id: string): Promise<{ id: string; name: string; email: string }>;
|
|
173
|
+
|
|
174
|
+
export const getUser = cache(async (id: string) => {
|
|
175
|
+
return fetchUser(id);
|
|
176
|
+
});
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
This deduplicates within a single request — across `middleware.ts`, `access.ts`, layouts, pages, and `route.ts` handlers, which all share one scope. Inside a server action `React.cache` does not dedupe (an action writes, so cached reads would go stale). The page that `revalidatePath()` re-renders afterwards starts fresh, so it sees the data the action just wrote.
|
|
180
|
+
|
|
181
|
+
Pass request inputs in as arguments rather than reading them inside the cached function. A cached value doesn't see a cookie that middleware changes later in the same request, but a new argument is a new cache key:
|
|
182
|
+
|
|
183
|
+
```tsx title="lib/session.ts"
|
|
184
|
+
import { cache } from 'react';
|
|
185
|
+
import { getCookieJar } from '@timber-js/app/server';
|
|
186
|
+
|
|
187
|
+
declare function fetchUserBySession(token: string): Promise<{ id: string; name: string } | null>;
|
|
188
|
+
|
|
189
|
+
// ✓ keyed on the token — a rotated or deleted session cookie is a cache miss
|
|
190
|
+
export const getUserBySession = cache(async (token: string | undefined) =>
|
|
191
|
+
token ? fetchUserBySession(token) : null
|
|
192
|
+
);
|
|
193
|
+
|
|
194
|
+
export const getUser = () => getUserBySession(getCookieJar().get('session'));
|
|
195
|
+
``` For cross-request caching with TTL, use `timber.cache()` — see [Caching](/docs/caching).
|
|
196
|
+
|
|
197
|
+
## Streaming Secondary Content
|
|
198
|
+
|
|
199
|
+
Primary content fetches outside `<Suspense>` — it can affect the status code. Secondary content goes inside `<Suspense>` — it streams after the shell flushes.
|
|
200
|
+
|
|
201
|
+
```tsx title="app/products/[id]/page.tsx" use="schema"
|
|
202
|
+
import { Suspense } from 'react';
|
|
203
|
+
import { SEGMENT_PATH } from './$segment';
|
|
204
|
+
import { deny, getSegmentParams } from '@timber-js/app/server';
|
|
205
|
+
|
|
206
|
+
declare function getProduct(id: string): Promise<{ id: string; name: string } | null>;
|
|
207
|
+
declare function ProductHeader(props: { product: { name: string } }): React.ReactElement;
|
|
208
|
+
declare function ReviewsSkeleton(): React.ReactElement;
|
|
209
|
+
declare function ProductReviews(props: { productId: string }): React.ReactElement;
|
|
210
|
+
|
|
211
|
+
export default async function ProductPage() {
|
|
212
|
+
const { id } = getSegmentParams(SEGMENT_PATH);
|
|
213
|
+
const product = await getProduct(id);
|
|
214
|
+
if (!product) deny(404);
|
|
215
|
+
|
|
216
|
+
return (
|
|
217
|
+
<div>
|
|
218
|
+
<ProductHeader product={product} />
|
|
219
|
+
<Suspense fallback={<ReviewsSkeleton />}>
|
|
220
|
+
<ProductReviews productId={product.id} />
|
|
221
|
+
</Suspense>
|
|
222
|
+
</div>
|
|
223
|
+
);
|
|
224
|
+
}
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
`getProduct` runs before the flush — if it fails, you get a real 404. Reviews stream in after. More on this in [The Flush Point](/docs/the-flush-point).
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 'Access Control: access.ts'
|
|
3
|
+
description: 'Per-segment access control with access.ts, deny(), and graceful slot degradation.'
|
|
4
|
+
slug: 'access-control'
|
|
5
|
+
notAI: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Access Control
|
|
9
|
+
|
|
10
|
+
```ts title="app/schema.ts" id="schema" hidden
|
|
11
|
+
import { defineSchema } from '@timber-js/app/params';
|
|
12
|
+
import { codec } from '@timber-js/app/codec';
|
|
13
|
+
|
|
14
|
+
import { getCookieJar, redirect } from '@timber-js/app/server';
|
|
15
|
+
|
|
16
|
+
declare function getSessionFromCookie(jar: ReturnType<typeof getCookieJar>): { userId: string } | null;
|
|
17
|
+
declare function getUser(userId: string): Promise<{ id: string; name: string }>;
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
export default defineSchema({
|
|
21
|
+
segmentParams: {
|
|
22
|
+
'[projectId]': codec.string,
|
|
23
|
+
},
|
|
24
|
+
});
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Most websites use access control of some kind. Instead of DRY-ing your access control or duplicating checks across your codebase, timber provides a _composable_ form of access control: `access.ts`.
|
|
28
|
+
|
|
29
|
+
If you place an `access.ts` file anywhere in your route tree, every sub-route will execute every `access.ts` in its parental tree.
|
|
30
|
+
|
|
31
|
+
You can `redirect`, `deny`, or otherwise gate access to an entire route group.
|
|
32
|
+
|
|
33
|
+
## `access.ts`
|
|
34
|
+
|
|
35
|
+
```ts title="app/(authenticated)/access.ts"
|
|
36
|
+
import { getCookieJar, redirect } from '@timber-js/app/server';
|
|
37
|
+
|
|
38
|
+
export default async function access() {
|
|
39
|
+
const session = getSessionFromCookie(getCookieJar());
|
|
40
|
+
|
|
41
|
+
if (!session) return redirect('/login');
|
|
42
|
+
|
|
43
|
+
const user = await getUser(); // getUser is wrapped in React.cache
|
|
44
|
+
|
|
45
|
+
if (!user.isVerified) return deny(401);
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
`access.ts` is a gate — it passes or fails. Return values are discarded. If it doesn't throw or redirect, rendering proceeds.
|
|
50
|
+
|
|
51
|
+
`access` runs before a route's layout or page in sequence, so if it short-circuits, those components are never executed.
|
|
52
|
+
|
|
53
|
+
## Sharing Data Between Access and Layout
|
|
54
|
+
|
|
55
|
+
Access checks and layouts share the same `React.cache` scope. Call the same cached function in both — the layout gets a free cache hit:
|
|
56
|
+
|
|
57
|
+
```tsx title="app/(authenticated)/layout.tsx"
|
|
58
|
+
export default async function AuthLayout({ children }: { children: React.ReactNode }) {
|
|
59
|
+
const user = await getUser(); // Cache HIT — access.ts already resolved this
|
|
60
|
+
|
|
61
|
+
return (
|
|
62
|
+
<div>
|
|
63
|
+
<nav>{user.name}</nav>
|
|
64
|
+
<main>{children}</main>
|
|
65
|
+
</div>
|
|
66
|
+
);
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Nested Access Checks
|
|
71
|
+
|
|
72
|
+
Deeper segments add their own `access.ts` for additional authorization:
|
|
73
|
+
|
|
74
|
+
```ts title="app/(authenticated)/projects/[projectId]/access.ts" use="schema"
|
|
75
|
+
import { SEGMENT_PATH } from './$segment';
|
|
76
|
+
import { deny, getSegmentParams } from '@timber-js/app/server';
|
|
77
|
+
|
|
78
|
+
declare function requireUser(): Promise<{ id: string; orgId: string }>;
|
|
79
|
+
declare function getProject(id: string): Promise<{ orgId: string } | null>;
|
|
80
|
+
|
|
81
|
+
export default async function access() {
|
|
82
|
+
const user = await requireUser(); // Cache HIT from parent
|
|
83
|
+
const { projectId } = getSegmentParams(SEGMENT_PATH);
|
|
84
|
+
const project = await getProject(projectId);
|
|
85
|
+
if (!project) deny(404);
|
|
86
|
+
if (project.orgId !== user.orgId) deny(); // Default 403
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Access runs root-to-leaf. If the root gate fails, deeper gates never execute.
|
|
91
|
+
|
|
92
|
+
`deny()` defaults to `403`; pass a status code (`deny(404)`, `deny(401)`) to change it. How the status code becomes a rendered page is covered in [Error Handling](/docs/error-handling).
|
|
93
|
+
|
|
94
|
+
## Slot Degradation
|
|
95
|
+
|
|
96
|
+
When `access.ts` denies a parallel route (slot), only that slot degrades — the page continues rendering:
|
|
97
|
+
|
|
98
|
+
```
|
|
99
|
+
app/
|
|
100
|
+
dashboard/
|
|
101
|
+
layout.tsx # Receives { children, admin }
|
|
102
|
+
page.tsx
|
|
103
|
+
@admin/
|
|
104
|
+
access.ts # Checks admin role
|
|
105
|
+
page.tsx # Admin panel
|
|
106
|
+
denied.tsx # Shown when access fails
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
If the user isn't an admin, `@admin` renders `denied.tsx` while the rest of the dashboard loads normally.
|
|
110
|
+
|
|
111
|
+
When access denies, that segment's `layout.tsx` never runs — `denied.tsx` renders in its place, wrapped only by layouts above the denying `access.ts`. This holds at every level of a slot's tree: a nested `@admin/reports/access.ts` denial prevents `@admin/reports/layout.tsx` from executing (and from fetching data it would serialize into the response).
|
|
112
|
+
|
|
113
|
+
## Middleware vs Access
|
|
114
|
+
|
|
115
|
+
`access.ts` runs inside the React tree, so it gates each segment and supports slot degradation. `middleware.ts` runs before rendering, for headers, redirects, and cache warming. Both share the request's `React.cache` scope with your layouts and pages. The full comparison is in [Middleware](/docs/middleware).
|
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 'The Flush Point'
|
|
3
|
+
description: 'When timber commits the HTTP status code, why there is no loading.tsx, and how Early Hints keep it fast.'
|
|
4
|
+
slug: 'the-flush-point'
|
|
5
|
+
# notAI: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# The Flush Point
|
|
9
|
+
|
|
10
|
+
The flush point is when the framework sends the first byte of HTML to the browser and commits the HTTP status code. In a traditional PHP website, this happens all at once.
|
|
11
|
+
|
|
12
|
+
But modern web frameworks, and notably react server components, have embraced a streaming architecture. Allowing you to send content _after_ the flush point.
|
|
13
|
+
|
|
14
|
+
While this is ultimately incredibly powerful, it brings forth confusion because contextually, code can have different side effects depending on _when_ you call it.
|
|
15
|
+
|
|
16
|
+
On a next.js app, if I call `notFound()` inside of a `page.tsx` that has a sibling `loading.tsx` – my status code will return `200`. By obfuscating the flush point, we've actually just made developer clarity murky.
|
|
17
|
+
|
|
18
|
+
So timber works differently. At no point does timber flush early, unless _you_ (the developer), choose to place a `<Suspense>` boundary. Often this will end up being below your `page.tsx` level, so you'll still have access to controlling and sending proper status codes.
|
|
19
|
+
|
|
20
|
+
## You Might Not Need A `loading.tsx`
|
|
21
|
+
|
|
22
|
+
Most React frameworks push you towards building page-level skeletons or loading states. Though it's entirely trivial to build out that experience with timber, we nudge you away from that for several reasons.
|
|
23
|
+
|
|
24
|
+
This is not referring to loading states on things like mutations (like submitting a form) or other actions. This is referring to initial (server) or secondary (client) page loading.
|
|
25
|
+
|
|
26
|
+
This is how we as frontend engineers make browsing the web a less anxiety-inducing experience.
|
|
27
|
+
|
|
28
|
+
### Loading States Are an Extra Class of UI to Maintain
|
|
29
|
+
|
|
30
|
+
You have to design loading states. Decide between spinners and skeletons, and then mimic your UI in the skeleton.
|
|
31
|
+
|
|
32
|
+
### Loading States Cause Content Layout Shift
|
|
33
|
+
|
|
34
|
+
Loading states are fixed and content is most often dynamic both in size (think text length) and count (think number of rows). So even if you work incredibly hard to avoid major CLS, you'll invariably end up with CLS somewhere.
|
|
35
|
+
|
|
36
|
+
### Loading States Are a Flash of UI
|
|
37
|
+
|
|
38
|
+
Loading states are inherently temporary, so this adds flashes of content. This causes anxiety as the page spasms before finally reaching an undetermined final state. The user is left in a daze wondering if the page is finally ready.
|
|
39
|
+
|
|
40
|
+
Every possible "finite state" of UI is another that you and the user have to keep in context. You'll be _surprised_ how much simpler a website feels when a page has one major representation, vs several.
|
|
41
|
+
|
|
42
|
+
### Loading States Hide Prior Context
|
|
43
|
+
|
|
44
|
+
Go to an old PHP site and click a URL. The _browser_ shows a loading state, but the prior page remains visible. The new page only becomes visible once it is ready. There's little advantage to hiding the past context while the user waits for the new context to load.
|
|
45
|
+
|
|
46
|
+
### timber Includes a Global Route-Based Loading State
|
|
47
|
+
|
|
48
|
+
On every route change, timber triggers a global page-level toploader loading state. If you want to add a secondary loading state that dims the prior content, you can easily do so.
|
|
49
|
+
|
|
50
|
+
### Loading States Break JavaScript Disabled Requests
|
|
51
|
+
|
|
52
|
+
`curl` a page with a `loading.tsx` and you'll get back a shell, not the content. Though people downsell the cost, it genuinely does hinder both SEO and agentic requests.
|
|
53
|
+
|
|
54
|
+
Leaning on the web as intended is always better than assuming _all_ consumers have JavaScript enabled. Plus, sticking JavaScript in between your _hot_ rendering path is _inherently_ slower. It's just not necessary when you adopt a comprehensive web architecture like React Server Components.
|
|
55
|
+
|
|
56
|
+
### Loading States Break Status Codes
|
|
57
|
+
|
|
58
|
+
Loading states flush before the content is even fetched. This feels _faster_, but you are flushing before you know if the user is authenticated, the data exists, or any other class of issue. By flushing immediately, you are forced to send a 200 and lean on JavaScript-injected meta tags to signify errors.
|
|
59
|
+
|
|
60
|
+
This breaks the contract of the web for any consumer that isn't a human. Use real status codes, you will gain downstream benefits from doing so.
|
|
61
|
+
|
|
62
|
+
### Most Loading States Paper Over a Bad Data Architecture
|
|
63
|
+
|
|
64
|
+
People often use loading states because their database is poorly optimized, or 50ms away from their rendering server, or otherwise. With a well designed data infrastructure, you can often fetch your data plenty fast to render your entire page in < 100ms.
|
|
65
|
+
|
|
66
|
+
And when you can't, you can stream and flush those rare pages trivially.
|
|
67
|
+
|
|
68
|
+
### Loading States Still Have Value, but More-So as Opt-In Secondary or Tertiary Content
|
|
69
|
+
|
|
70
|
+
To add a loading state as a small sub-section of a page is trivial – just wrap your component in `<Suspense>` and you can defer slower, lower priority content.
|
|
71
|
+
|
|
72
|
+
If you decide you want a full page level loading state, you can wrap your layout or page in `<Suspense>` on a case by case basis. No `loading.tsx` needed.
|
|
73
|
+
|
|
74
|
+
--------
|
|
75
|
+
|
|
76
|
+
A `loading.tsx` forces your flush point up ever so slightly, but you give up all the things above. Instead, timber asks you to place `<Suspense>` boundaries yourself – thereby _explicitly_ opting into the flush point.
|
|
77
|
+
|
|
78
|
+
Now you get a calm, performant website that doesn't have immense content-layout-shift, doesn't hide prior content during loading, and can return proper status codes. The `loading.tsx` seems innocent enough, but its cost both cognitively and architecturally is high.
|
|
79
|
+
|
|
80
|
+
------
|
|
81
|
+
|
|
82
|
+
AI below..
|
|
83
|
+
|
|
84
|
+
## The Problem
|
|
85
|
+
|
|
86
|
+
Most streaming frameworks send a `200 OK` immediately and figure out the real outcome later:
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
Request → 200 OK → ... render ... → oh, it's a 404
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
By the time the server discovers the page doesn't exist, the status code is already sent. The client sees `200`. Search engines see `200`. CDNs cache it as `200`.
|
|
93
|
+
|
|
94
|
+
This breaks search engines (deleted pages never deindex), CDNs (404s get cached as successes), monitoring (zero errors while users see broken pages), and `curl`/scripts (`curl -f` won't detect the failure).
|
|
95
|
+
|
|
96
|
+
## timber's Solution
|
|
97
|
+
|
|
98
|
+
timber holds the response until it knows the real outcome:
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
Request arrives
|
|
102
|
+
→ Route matched
|
|
103
|
+
→ proxy.ts runs
|
|
104
|
+
→ middleware.ts runs
|
|
105
|
+
→ access.ts runs
|
|
106
|
+
→ React shell renders (onShellReady)
|
|
107
|
+
→ ✓ Status code committed ← flush point
|
|
108
|
+
→ Shell HTML sent to browser
|
|
109
|
+
→ Suspense boundaries stream in
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
The status code commits when **all three** conditions are met:
|
|
113
|
+
|
|
114
|
+
1. Middleware completed without returning a response
|
|
115
|
+
2. All access checks passed (or denied with a real status code)
|
|
116
|
+
3. React's `onShellReady` fired — the synchronous shell rendered without error
|
|
117
|
+
|
|
118
|
+
A missing page returns a real `404`. A failed auth check returns a real `403`. A redirect returns a real `302`. The HTTP layer tells the truth.
|
|
119
|
+
|
|
120
|
+
## Before and After the Flush
|
|
121
|
+
|
|
122
|
+
**Before the flush** (blocking):
|
|
123
|
+
|
|
124
|
+
- `proxy.ts` — global request processing
|
|
125
|
+
- `middleware.ts` — route-level request processing
|
|
126
|
+
- `access.ts` — authorization gates
|
|
127
|
+
- Synchronous component rendering (the shell)
|
|
128
|
+
|
|
129
|
+
**After the flush** (streaming):
|
|
130
|
+
|
|
131
|
+
- `<Suspense>` boundaries resolve and stream in
|
|
132
|
+
- Slow data loads complete
|
|
133
|
+
- The page progressively fills in
|
|
134
|
+
|
|
135
|
+
``` leading="none"
|
|
136
|
+
┌─────── flush point
|
|
137
|
+
│
|
|
138
|
+
▼
|
|
139
|
+
├────────┤──────────────────────────┤
|
|
140
|
+
blocking streaming
|
|
141
|
+
(shell) (suspense boundaries)
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
Everything before the flush determines the status code. Everything after streams progressively. You control the boundary by choosing what goes inside `<Suspense>` and what doesn't — see [Streaming](/docs/streaming) for how to place those boundaries.
|
|
145
|
+
|
|
146
|
+
## Pages Work Without JavaScript
|
|
147
|
+
|
|
148
|
+
Because timber holds the flush until the shell is complete, the browser receives a fully-formed HTML document. Content is visible, links work as standard `<a>` tags, and forms submit as standard POSTs. JavaScript adds client-side navigation, interactive components, and streaming updates — but the page works without it.
|
|
149
|
+
|
|
150
|
+
This isn't a special mode. It's how timber works by default.
|
|
151
|
+
|
|
152
|
+
## Early Hints
|
|
153
|
+
|
|
154
|
+
timber doesn't make you wait for assets while the shell renders. At route-match time — before middleware runs — timber sends `103 Early Hints` with CSS, JS, and font URLs based on the build manifest. The browser starts downloading assets while the server is still working:
|
|
155
|
+
|
|
156
|
+
```
|
|
157
|
+
103 Early Hints
|
|
158
|
+
Link: </styles/main.css>; rel=preload; as=style
|
|
159
|
+
Link: </chunks/page-abc.js>; rel=modulepreload
|
|
160
|
+
|
|
161
|
+
... middleware runs, shell renders ...
|
|
162
|
+
|
|
163
|
+
200 OK
|
|
164
|
+
<html>...
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
You get the correctness of a held flush with the performance of early resource loading.
|
|
168
|
+
|
|
169
|
+
## How to Think About It
|
|
170
|
+
|
|
171
|
+
Primary content — the data that defines whether a page exists, who can see it, and what it contains — should load before the flush. Put it in your components directly.
|
|
172
|
+
|
|
173
|
+
Secondary content — recommendations, activity feeds, analytics widgets — can load after the flush. Wrap it in `<Suspense>`.
|
|
174
|
+
|
|
175
|
+
The flush point is the dividing line between "what the page _is_" and "what the page _also shows_."
|