@timber-js/app 0.2.0-alpha.23 → 0.2.0-alpha.230
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +8 -0
- package/agent-skill.md +376 -0
- package/bin/timber.mjs +15 -1
- package/dist/_chunks/actions-DHum77eH.js +1272 -0
- package/dist/_chunks/actions-DHum77eH.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-B-JZkpBD.js +251 -0
- package/dist/_chunks/cli-check-B-JZkpBD.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-CPc6bjVl.js +20 -0
- package/dist/_chunks/codec-registry-CPc6bjVl.js.map +1 -0
- package/dist/_chunks/codegen-B9oWkWGf.js +429 -0
- package/dist/_chunks/codegen-B9oWkWGf.js.map +1 -0
- package/dist/_chunks/convention-lint-CrDKERHg.js +578 -0
- package/dist/_chunks/convention-lint-CrDKERHg.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-validation-CEZy1V-k.js +210 -0
- package/dist/_chunks/href-validation-CEZy1V-k.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/{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 +22 -33
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +416 -1241
- 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 +85 -60
- 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 +35 -181
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9949 -14264
- package/dist/index.js.map +1 -1
- package/dist/params/codec-registry.d.ts +26 -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 +5 -0
- package/dist/params/index.d.ts.map +1 -0
- package/dist/params/index.js +33 -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/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 +105 -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 +5094 -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 +91 -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/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 +91 -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 +108 -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 +120 -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 +91 -53
- package/src/client/internal.ts +54 -0
- package/src/client/link.tsx +464 -151
- 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 +498 -380
- package/src/params/codec-registry.ts +34 -0
- package/src/params/define-schema.ts +115 -0
- package/src/params/index.ts +17 -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 +257 -97
- package/src/plugins/static-build.ts +681 -71
- package/src/react-canary.d.ts +2 -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 +349 -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 +280 -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 +223 -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 +417 -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/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,1282 @@
|
|
|
1
|
+
import { a as withTimeout$1 } from "./render-timeout-MrrqD1wd.js";
|
|
2
|
+
import { _ as wasInvalidatedSince, g as recordInvalidation, h as lastInvalidationEpochFor, i as devDataCacheKey, l as invalidateDevSeedsByTag, m as currentInvalidationEpoch, o as devOverlayNamespace, v as getCacheHandler, y as isCacheHandlerConfigured } from "./dev-store-BvdqtHvK.js";
|
|
3
|
+
import { c as waitUntilAls, i as requestContextAls } from "./als-registry-DpygwCp0.js";
|
|
4
|
+
import { a as logKeyDisciplineViolation, b as swallow, g as logSwrRefetchFailed, n as logCacheMiss, r as logCacheReadFailed, w as addSpanEventSync } from "./logger-YtMSKfft.js";
|
|
5
|
+
import { t as fnv1aHash } from "./fast-hash-DddxkU5Y.js";
|
|
6
|
+
import { n as createSingleflight } from "./singleflight-CzoOVB9Y.js";
|
|
7
|
+
import { t as estimateByteSize } from "./sizeof-Cmx6Fs-Y.js";
|
|
8
|
+
import { t as warnLossyJsonValue } from "./json-lossy-check-BXM45k8p.js";
|
|
9
|
+
import { t as getCdnPurgeHandler } from "./purge-store-8BqLAYZ1.js";
|
|
10
|
+
// src/server/waituntil-bridge.ts
|
|
11
|
+
/**
|
|
12
|
+
* Per-request waitUntil bridge — ALS bridge for platform adapters.
|
|
13
|
+
*
|
|
14
|
+
* The generated entry point (Nitro, Cloudflare) wraps the handler with
|
|
15
|
+
* `runWithWaitUntil`, binding the platform's lifecycle extension function
|
|
16
|
+
* (e.g., h3's `event.waitUntil()` or CF's `ctx.waitUntil()`) for the
|
|
17
|
+
* request duration. The `waitUntil()` primitive reads from this ALS to
|
|
18
|
+
* dispatch background work to the correct platform API.
|
|
19
|
+
*
|
|
20
|
+
* Design doc: design/11-platform.md §"waitUntil()"
|
|
21
|
+
*/
|
|
22
|
+
/**
|
|
23
|
+
* Get the current request's waitUntil function, if available.
|
|
24
|
+
*
|
|
25
|
+
* Returns undefined when no platform adapter has installed a waitUntil
|
|
26
|
+
* handler for the current request (e.g., on platforms that don't support
|
|
27
|
+
* lifecycle extension, or outside a request context).
|
|
28
|
+
*/
|
|
29
|
+
function getWaitUntil() {
|
|
30
|
+
return waitUntilAls.getStore();
|
|
31
|
+
}
|
|
32
|
+
// src/cache/stable-stringify.ts
|
|
33
|
+
/**
|
|
34
|
+
* Deterministic JSON serialization with sorted object keys.
|
|
35
|
+
* Used for cache key generation — ensures { a: 1, b: 2 } and { b: 2, a: 1 }
|
|
36
|
+
* produce the same string.
|
|
37
|
+
*
|
|
38
|
+
* Matches JSON.stringify semantics for toJSON: Date serializes to its ISO
|
|
39
|
+
* string, URL to its href, and class instances with a custom toJSON use it.
|
|
40
|
+
* Map and Set serialize their entries explicitly (insertion-order
|
|
41
|
+
* independent). Values that would serialize lossily — functions, symbols,
|
|
42
|
+
* and non-plain objects with no enumerable own state (RegExp, class
|
|
43
|
+
* instances holding data behind getters or internal slots) — throw instead:
|
|
44
|
+
* every such value would collapse to the same cache key, silently returning
|
|
45
|
+
* one argument's cached data for another (TIM-1020).
|
|
46
|
+
*
|
|
47
|
+
* The same rule covers what JSON.stringify flattens: NaN, Infinity and
|
|
48
|
+
* -Infinity all become `null` there and -0 becomes `0`, and a typed array
|
|
49
|
+
* becomes a plain index object, so `Uint8Array`, `Int8Array` and
|
|
50
|
+
* `{ "0": 1 }` with the same values would share an entry. Both get a
|
|
51
|
+
* representation of their own (GHSA-rhh4-g77r-r9qj class).
|
|
52
|
+
*/
|
|
53
|
+
function stableStringify(value) {
|
|
54
|
+
if (value === null || value === void 0) return String(value);
|
|
55
|
+
const type = typeof value;
|
|
56
|
+
if (type === "function" || type === "symbol") throw new TypeError(`stableStringify: cannot serialize a ${type} into a stable cache key — all such values would collide. Provide an explicit \`key\` option to cache().`);
|
|
57
|
+
if (type === "number") return stringifyNumber(value);
|
|
58
|
+
if (type !== "object") return JSON.stringify(value);
|
|
59
|
+
if (Array.isArray(value)) return "[" + value.map((item) => stableStringify(item)).join(",") + "]";
|
|
60
|
+
const withToJSON = value;
|
|
61
|
+
if (typeof withToJSON.toJSON === "function") {
|
|
62
|
+
const json = withToJSON.toJSON();
|
|
63
|
+
if (json !== value) return stableStringify(json);
|
|
64
|
+
}
|
|
65
|
+
const typed = asTypedArray(value);
|
|
66
|
+
if (typed) {
|
|
67
|
+
const elements = Array.from(typed.view, (element) => typeof element === "bigint" ? `${element}n` : stringifyNumber(element));
|
|
68
|
+
return `${typed.name}(${elements.join(",")})`;
|
|
69
|
+
}
|
|
70
|
+
if (value instanceof Map) return "Map(" + [...value.entries()].map(([k, v]) => stableStringify(k) + "=>" + stableStringify(v)).sort().join(",") + ")";
|
|
71
|
+
if (value instanceof Set) return "Set(" + [...value].map((member) => stableStringify(member)).sort().join(",") + ")";
|
|
72
|
+
const obj = value;
|
|
73
|
+
const keys = Object.keys(obj).sort();
|
|
74
|
+
const pairs = [];
|
|
75
|
+
for (const key of keys) {
|
|
76
|
+
if (obj[key] === void 0) continue;
|
|
77
|
+
if (key === "toJSON" && typeof obj[key] === "function") continue;
|
|
78
|
+
pairs.push(JSON.stringify(key) + ":" + stableStringify(obj[key]));
|
|
79
|
+
}
|
|
80
|
+
if (pairs.length === 0) {
|
|
81
|
+
const proto = Object.getPrototypeOf(value);
|
|
82
|
+
if (proto !== Object.prototype && proto !== null) {
|
|
83
|
+
const name = value.constructor?.name || "Object";
|
|
84
|
+
throw new TypeError(`stableStringify: ${name} instance has no serializable own state — all instances would share one cache key. Provide an explicit \`key\` option to cache(), or add a toJSON() method.`);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return "{" + pairs.join(",") + "}";
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* JSON.stringify for a number, except the values it maps onto another
|
|
91
|
+
* value's output: NaN, ±Infinity (all `null`) and -0 (`0`). Their bare
|
|
92
|
+
* tokens cannot be produced by JSON output, so they cannot collide.
|
|
93
|
+
*/
|
|
94
|
+
function stringifyNumber(value) {
|
|
95
|
+
if (Number.isFinite(value)) return Object.is(value, -0) ? "-0" : JSON.stringify(value);
|
|
96
|
+
return String(value);
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* The %TypedArray%.prototype[Symbol.toStringTag] getter returns the
|
|
100
|
+
* element type name for a real typed array and undefined for anything else
|
|
101
|
+
* (spec §23.2.3.38). It reads an internal slot, so it holds across realms —
|
|
102
|
+
* unlike `instanceof`, which sent a DataView from a `vm` context into the
|
|
103
|
+
* typed-array branch, where it serialized as an empty, shared key — and it
|
|
104
|
+
* cannot be spoofed by an own `Symbol.toStringTag`.
|
|
105
|
+
*/
|
|
106
|
+
var typedArrayTag = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), Symbol.toStringTag)?.get;
|
|
107
|
+
function asTypedArray(value) {
|
|
108
|
+
const name = typedArrayTag?.call(value);
|
|
109
|
+
if (typeof name !== "string") return void 0;
|
|
110
|
+
return {
|
|
111
|
+
name,
|
|
112
|
+
view: value
|
|
113
|
+
};
|
|
114
|
+
}
|
|
115
|
+
// src/cache/guarded-read.ts
|
|
116
|
+
/**
|
|
117
|
+
* Cache reads never fail a request.
|
|
118
|
+
*
|
|
119
|
+
* A cache is an optimization: when the store is down, slow, or returns
|
|
120
|
+
* garbage, the request must still succeed by doing the work the cache would
|
|
121
|
+
* have skipped. Writes already follow this rule (timber-cache.ts swallows a
|
|
122
|
+
* failed handler.set, TIM-1046); reads go through here so a throwing or hung
|
|
123
|
+
* handler.get costs a live fetch or render, never a failed or stalled request.
|
|
124
|
+
*
|
|
125
|
+
* The timeout matters as much as the catch. Shared-store clients often queue
|
|
126
|
+
* commands while disconnected (ioredis retries each one up to 20 times by
|
|
127
|
+
* default), so an outage shows up as a read that never settles, not an error.
|
|
128
|
+
*
|
|
129
|
+
* Invalidation is deliberately NOT guarded: a failed invalidate that looked
|
|
130
|
+
* like success would leave stale data in place silently.
|
|
131
|
+
*
|
|
132
|
+
* See design/06-caching.md §"Store failures".
|
|
133
|
+
*/
|
|
134
|
+
/** Ceiling for a single cache read. A healthy store answers in milliseconds. */
|
|
135
|
+
var CACHE_READ_TIMEOUT_MS = 1e3;
|
|
136
|
+
/**
|
|
137
|
+
* Run a cache read. A throw, a rejection, or no answer within
|
|
138
|
+
* CACHE_READ_TIMEOUT_MS logs a warning and resolves to `onFailure`, which the
|
|
139
|
+
* caller picks: `null` where a failed read means "miss", a distinct value
|
|
140
|
+
* where a miss would fall back to something the failed read might have
|
|
141
|
+
* overridden (an invalidated build seed — server/prebuilt/overlay.ts).
|
|
142
|
+
*/
|
|
143
|
+
async function guardedRead(cacheKey, read, onFailure) {
|
|
144
|
+
try {
|
|
145
|
+
return await withTimeout$1(read(), CACHE_READ_TIMEOUT_MS, `cache read for "${cacheKey}"`);
|
|
146
|
+
} catch (error) {
|
|
147
|
+
logCacheReadFailed({
|
|
148
|
+
cacheKey,
|
|
149
|
+
error
|
|
150
|
+
});
|
|
151
|
+
return onFailure;
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
// src/cache/key-discipline.ts
|
|
155
|
+
/**
|
|
156
|
+
* Key-discipline diagnostic for both cache tiers (design/45 §Enforcement).
|
|
157
|
+
*
|
|
158
|
+
* A cached value is stored under a key computed from declared inputs only —
|
|
159
|
+
* props and segment params for `cache.component`, the function's arguments
|
|
160
|
+
* for `cache.data`. A request-context read while the value is being computed
|
|
161
|
+
* is the data-leak danger zone (design/06 security note): the result varies
|
|
162
|
+
* by user but the key does not. While the cached work runs, the ALS store is
|
|
163
|
+
* wrapped in a transparent observing proxy; any request-context read
|
|
164
|
+
* produces a structured, rate-limited production diagnostic.
|
|
165
|
+
*
|
|
166
|
+
* The diagnostic fires per offending callsite, rate-limited to once per
|
|
167
|
+
* interval (default 60 s) — not once per process. This ensures the
|
|
168
|
+
* signal stays visible in log aggregators across restarts and deploys.
|
|
169
|
+
*
|
|
170
|
+
* When `strictKeyDiscipline` is enabled (via timber.config.ts
|
|
171
|
+
* `cache.strictKeyDiscipline: true`), the diagnostic is promoted to a
|
|
172
|
+
* thrown error that prevents the tainted value from being cached.
|
|
173
|
+
*/
|
|
174
|
+
/** Store fields every tier's key leaves out, by the API that reads them. */
|
|
175
|
+
var REQUEST_FIELDS = /* @__PURE__ */ new Map([
|
|
176
|
+
["headers", "headers()"],
|
|
177
|
+
["parsedCookies", "cookies()"],
|
|
178
|
+
["searchParams", "searchParams"]
|
|
179
|
+
]);
|
|
180
|
+
/**
|
|
181
|
+
* The data tier also leaves out segment params: a cache.component key
|
|
182
|
+
* includes them, a cache.data key holds only the function's arguments.
|
|
183
|
+
*/
|
|
184
|
+
var DATA_TIER_FIELDS = new Map([
|
|
185
|
+
...REQUEST_FIELDS,
|
|
186
|
+
["segmentParams", "segment params"],
|
|
187
|
+
["slotParams", "segment params"]
|
|
188
|
+
]);
|
|
189
|
+
var TIERS = {
|
|
190
|
+
"cache.component": {
|
|
191
|
+
observed: REQUEST_FIELDS,
|
|
192
|
+
keyedBy: "props and segment params",
|
|
193
|
+
passAs: "as props",
|
|
194
|
+
work: "a cache capture render"
|
|
195
|
+
},
|
|
196
|
+
"cache.data": {
|
|
197
|
+
observed: DATA_TIER_FIELDS,
|
|
198
|
+
keyedBy: "the function's arguments",
|
|
199
|
+
passAs: "as an argument",
|
|
200
|
+
work: "a cached call"
|
|
201
|
+
}
|
|
202
|
+
};
|
|
203
|
+
/** Rate-limit interval: one diagnostic per callsite per 60 seconds. */
|
|
204
|
+
var RATE_LIMIT_MS = 6e4;
|
|
205
|
+
/**
|
|
206
|
+
* Last emission timestamp per `${tier}:${id}`. Past this many entries,
|
|
207
|
+
* ones whose window has elapsed are pruned — an untransformed callsite
|
|
208
|
+
* re-created per request gets a fresh fallback id each time.
|
|
209
|
+
*/
|
|
210
|
+
var lastEmitted = /* @__PURE__ */ new Map();
|
|
211
|
+
var PRUNE_AT = 1e3;
|
|
212
|
+
/**
|
|
213
|
+
* Thrown in strict mode. A distinct class so a caller holding an earlier
|
|
214
|
+
* result computed by the same fn (a stale SWR entry) can drop it.
|
|
215
|
+
*/
|
|
216
|
+
var KeyDisciplineViolation = class extends Error {
|
|
217
|
+
name = "KeyDisciplineViolation";
|
|
218
|
+
};
|
|
219
|
+
var strict = false;
|
|
220
|
+
/**
|
|
221
|
+
* Run a cached callsite's work under the observing proxy, then report any
|
|
222
|
+
* request-context read it made. The proxy is transparent — it forwards all
|
|
223
|
+
* reads and writes; it only observes.
|
|
224
|
+
*
|
|
225
|
+
* Outside a request context `run` executes as-is: there is nothing to read,
|
|
226
|
+
* and cache.data must keep working there. In default mode a callsite that
|
|
227
|
+
* reported within the rate-limit window is not observed at all. In strict
|
|
228
|
+
* mode a violation rejects after `run` resolves, so the caller never stores
|
|
229
|
+
* the value.
|
|
230
|
+
*/
|
|
231
|
+
async function observeKeyDiscipline(site, run) {
|
|
232
|
+
const store = requestContextAls.getStore();
|
|
233
|
+
if (!store || !shouldCheck(site)) return run();
|
|
234
|
+
const { proxy, accessedApis } = createObservingProxy(store, TIERS[site.tier].observed);
|
|
235
|
+
const result = await requestContextAls.run(proxy, run);
|
|
236
|
+
if (accessedApis.size > 0) reportViolation(site, accessedApis);
|
|
237
|
+
return result;
|
|
238
|
+
}
|
|
239
|
+
function rateLimitKey(site) {
|
|
240
|
+
return `${site.tier}:${site.id}`;
|
|
241
|
+
}
|
|
242
|
+
/**
|
|
243
|
+
* Whether to observe this callsite on this call. Always in strict mode;
|
|
244
|
+
* otherwise only once the rate-limit window since its last report elapsed.
|
|
245
|
+
*/
|
|
246
|
+
function shouldCheck(site) {
|
|
247
|
+
if (strict) return true;
|
|
248
|
+
const last = lastEmitted.get(rateLimitKey(site));
|
|
249
|
+
if (last === void 0) return true;
|
|
250
|
+
return Date.now() - last >= RATE_LIMIT_MS;
|
|
251
|
+
}
|
|
252
|
+
function createObservingProxy(store, observed) {
|
|
253
|
+
const accessedApis = /* @__PURE__ */ new Set();
|
|
254
|
+
return {
|
|
255
|
+
proxy: new Proxy(store, { get(target, prop, receiver) {
|
|
256
|
+
const api = observed.get(prop);
|
|
257
|
+
if (api) accessedApis.add(api);
|
|
258
|
+
return Reflect.get(target, prop, receiver);
|
|
259
|
+
} }),
|
|
260
|
+
accessedApis
|
|
261
|
+
};
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* Throw in strict mode; otherwise emit a structured error-level diagnostic
|
|
265
|
+
* through the logger (same path as render errors), rate-limited per callsite.
|
|
266
|
+
*/
|
|
267
|
+
function reportViolation(site, apis) {
|
|
268
|
+
const { tier, id } = site;
|
|
269
|
+
const name = site.label ?? id;
|
|
270
|
+
const apiList = Array.from(apis).join(", ");
|
|
271
|
+
const wording = TIERS[tier];
|
|
272
|
+
const remedy = `Either pass request-derived values ${wording.passAs} (included in the cache key) or remove the ${apiList} call.`;
|
|
273
|
+
if (strict) throw new KeyDisciplineViolation(`[timber] ${tier} key-discipline violation: "${name}" reads ${apiList} during ${wording.work}. The cache key is computed from ${wording.keyedBy} only — caching this result would serve one user's data to another. ${remedy} To downgrade this to a warning, set cache.strictKeyDiscipline: false in timber.config.ts.`);
|
|
274
|
+
const now = Date.now();
|
|
275
|
+
const key = rateLimitKey(site);
|
|
276
|
+
const last = lastEmitted.get(key);
|
|
277
|
+
if (last !== void 0 && now - last < RATE_LIMIT_MS) return;
|
|
278
|
+
if (lastEmitted.size >= PRUNE_AT) {
|
|
279
|
+
for (const [k, t] of lastEmitted) if (now - t >= RATE_LIMIT_MS) lastEmitted.delete(k);
|
|
280
|
+
}
|
|
281
|
+
lastEmitted.set(key, now);
|
|
282
|
+
logKeyDisciplineViolation(`${tier} cross-user data leak risk`, {
|
|
283
|
+
...tier === "cache.component" ? { component: name } : {
|
|
284
|
+
fn: name,
|
|
285
|
+
id,
|
|
286
|
+
cacheKey: site.cacheKey
|
|
287
|
+
},
|
|
288
|
+
accessedApis: Array.from(apis),
|
|
289
|
+
message: `${tier} "${name}" reads ${apiList} but the cache key is computed from ${wording.keyedBy} only. If the result varies by ${apiList}, different users may see each other's cached data. ${remedy}`
|
|
290
|
+
});
|
|
291
|
+
}
|
|
292
|
+
// src/cache/timber-cache.ts
|
|
293
|
+
/**
|
|
294
|
+
* The one flight keyspace for every cache() wrapper. A wrapper with its own
|
|
295
|
+
* `timeoutMs` passes it per call rather than getting a private instance:
|
|
296
|
+
* two wrappers that share an explicit key must coalesce, or an older,
|
|
297
|
+
* slower execution can overwrite a newer result — there is no write
|
|
298
|
+
* ordering in the CacheHandler contract to stop it (TIM-1447).
|
|
299
|
+
*/
|
|
300
|
+
var flights = createSingleflight();
|
|
301
|
+
/** Timeout for calls without a per-wrapper `timeoutMs`; set at boot. */
|
|
302
|
+
var defaultTimeoutMs;
|
|
303
|
+
/**
|
|
304
|
+
* Set the timeout for cache calls without a per-call timeoutMs.
|
|
305
|
+
* Called at framework boot with renderTimeoutMs from timber.config.ts so that
|
|
306
|
+
* cache calls without a per-call timeoutMs still get deadlock protection.
|
|
307
|
+
* See design/06-caching.md §"Singleflight Timeout — Deadlock Risk".
|
|
308
|
+
*/
|
|
309
|
+
function setDefaultSingleflightTimeout(timeoutMs) {
|
|
310
|
+
defaultTimeoutMs = timeoutMs;
|
|
311
|
+
}
|
|
312
|
+
/**
|
|
313
|
+
* Generate a cache key from function identity and serialized args.
|
|
314
|
+
*
|
|
315
|
+
* Uses FNV-1a (fast non-crypto hash) instead of SHA-256. Cache keys don't
|
|
316
|
+
* need collision resistance — they need speed. The fnId prefix provides
|
|
317
|
+
* namespace isolation; the hash covers the args.
|
|
318
|
+
*
|
|
319
|
+
* See TIM-370 for perf motivation.
|
|
320
|
+
*/
|
|
321
|
+
function defaultKeyGenerator(fnId, args) {
|
|
322
|
+
const raw = fnId + ":" + stableStringify(args);
|
|
323
|
+
return fnId + ":" + fnv1aHash(raw);
|
|
324
|
+
}
|
|
325
|
+
/**
|
|
326
|
+
* Resolve tags from the options — supports static array or function form.
|
|
327
|
+
*/
|
|
328
|
+
function resolveTags(opts, args) {
|
|
329
|
+
if (!opts.tags) return [];
|
|
330
|
+
if (Array.isArray(opts.tags)) return opts.tags;
|
|
331
|
+
return opts.tags(...args);
|
|
332
|
+
}
|
|
333
|
+
/** Per-process count of byte-identical fn sources seen by deriveFallbackFnId. */
|
|
334
|
+
var fallbackIdOccurrences = /* @__PURE__ */ new Map();
|
|
335
|
+
var hasWarnedFallbackId = false;
|
|
336
|
+
/**
|
|
337
|
+
* Derive a fallback fnId for callsites the timber-cache-transform Vite plugin
|
|
338
|
+
* could not statically detect (aliased bindings, user re-export wrappers).
|
|
339
|
+
*
|
|
340
|
+
* The base is fnv1a(fn.toString()) — deterministic across instances and cold
|
|
341
|
+
* starts of the same build, so two *different* functions can never swap fnIds
|
|
342
|
+
* by module-evaluation order (the TIM-997 poisoning scenario that the old
|
|
343
|
+
* process-local counter allowed; see TIM-1054). A per-process occurrence
|
|
344
|
+
* suffix disambiguates byte-identical duplicate sources. That residue is the
|
|
345
|
+
* one remaining hazard: closures produced by the same factory share source
|
|
346
|
+
* text but capture different values, and their occurrence order may differ
|
|
347
|
+
* across instances — such callsites need an explicit `key` option.
|
|
348
|
+
*/
|
|
349
|
+
function deriveFallbackFnId(fn) {
|
|
350
|
+
const sourceHash = fnv1aHash(fn.toString());
|
|
351
|
+
const occurrence = fallbackIdOccurrences.get(sourceHash) ?? 0;
|
|
352
|
+
fallbackIdOccurrences.set(sourceHash, occurrence + 1);
|
|
353
|
+
if (!hasWarnedFallbackId && typeof process !== "undefined" && process.env.NODE_ENV !== "test") {
|
|
354
|
+
hasWarnedFallbackId = true;
|
|
355
|
+
console.warn("[timber] cache() callsite has no build-time stable ID and no explicit `key` option — the call is not statically visible to the timber Vite plugin (e.g. an aliased binding like `const c = cache` or a re-export wrapper module). Falling back to a function-source hash for the cache key. With a shared CacheHandler (Redis/KV) this is safe for distinct functions, but byte-identical closures from a factory can swap cache entries across instances. Provide an explicit `key` option to make the cache key contract stable and auditable.");
|
|
356
|
+
}
|
|
357
|
+
return `timber-cache:fn:${sourceHash}:${occurrence}`;
|
|
358
|
+
}
|
|
359
|
+
/**
|
|
360
|
+
* Creates a cached wrapper around an async function.
|
|
361
|
+
*
|
|
362
|
+
* - FNV-1a default keys with normalized JSON args
|
|
363
|
+
* - Singleflight: concurrent misses → single execution AND single
|
|
364
|
+
* handler.set — the write happens inside the coalesced callback (TIM-1028)
|
|
365
|
+
* - Writes are skipped when the key/tags were invalidated while fn was in
|
|
366
|
+
* flight, so explicit invalidation is never silently undone (TIM-1028)
|
|
367
|
+
* - SWR: serve stale immediately, background refetch
|
|
368
|
+
* - Tags as string[] or function of args
|
|
369
|
+
* - The handler is resolved per invocation via `getHandler`, never captured
|
|
370
|
+
* at wrapper-creation time — module-scope cache() wrappers created before
|
|
371
|
+
* the framework's boot wiring calls setCacheHandler() still use the
|
|
372
|
+
* configured handler once it arrives (TIM-1029)
|
|
373
|
+
* - No ALS dependency for correctness — cache() works outside a request
|
|
374
|
+
* context. The waitUntil ALS bridge is read optionally so the SWR
|
|
375
|
+
* background refetch survives handler return on Workers/Lambda, and
|
|
376
|
+
* inside one, fn runs under the key-discipline observer (design/45
|
|
377
|
+
* §Enforcement): the key comes from the arguments only, so a
|
|
378
|
+
* request-context read in fn is reported, or rejected in strict mode
|
|
379
|
+
* before the result is stored.
|
|
380
|
+
*
|
|
381
|
+
* Cache hits/misses are recorded as OTEL span events on the enclosing
|
|
382
|
+
* span (not child spans). The DevSpanProcessor reads these for dev log output.
|
|
383
|
+
*/
|
|
384
|
+
function createCache(fn, opts, getHandler, stableId) {
|
|
385
|
+
const fnId = stableId ?? (opts.key ? void 0 : deriveFallbackFnId(fn));
|
|
386
|
+
const disciplineId = fnId ?? `key-fn:${fnv1aHash(fn.toString())}`;
|
|
387
|
+
return (async (...args) => {
|
|
388
|
+
const timeoutMs = opts.timeoutMs ?? defaultTimeoutMs;
|
|
389
|
+
const key = opts.key ? opts.key(...args) : defaultKeyGenerator(fnId, args);
|
|
390
|
+
const storeKey = devDataCacheKey(key);
|
|
391
|
+
const cacheStart = performance.now();
|
|
392
|
+
const cached = await guardedRead(key, () => getHandler().get(storeKey), null);
|
|
393
|
+
if (cached && !cached.stale) {
|
|
394
|
+
addSpanEventSync("timber.cache.hit", {
|
|
395
|
+
key,
|
|
396
|
+
duration_ms: Math.round(performance.now() - cacheStart)
|
|
397
|
+
});
|
|
398
|
+
return cached.value;
|
|
399
|
+
}
|
|
400
|
+
const tags = resolveTags(opts, args);
|
|
401
|
+
const flightKey = `${storeKey}\u0000${lastInvalidationEpochFor(key, tags)}`;
|
|
402
|
+
/**
|
|
403
|
+
* Run fn and store the result — exactly once per coalesced execution,
|
|
404
|
+
* inside the singleflight callback. The write is skipped when:
|
|
405
|
+
* - the key/tags were invalidated after fn started (TIM-1028), or
|
|
406
|
+
* - the singleflight timed out (signal aborted) — the timed-out
|
|
407
|
+
* flight's write could overwrite a newer value from a subsequent
|
|
408
|
+
* flight (TIM-1092).
|
|
409
|
+
* Those two guards plus the shared flight keyspace leave no second
|
|
410
|
+
* in-process execution for the key to race, as long as every wrapper
|
|
411
|
+
* using the key agrees on its tags (design/06 §Residual write races). A set issued just before
|
|
412
|
+
* a timeout can still land after the next flight's set; that, and
|
|
413
|
+
* writes from other processes, are last-write-wins and self-heal on
|
|
414
|
+
* the next miss (design/06 §Residual write races).
|
|
415
|
+
*/
|
|
416
|
+
const executeAndStore = async (signal) => {
|
|
417
|
+
const startEpoch = currentInvalidationEpoch();
|
|
418
|
+
let result;
|
|
419
|
+
try {
|
|
420
|
+
result = await observeKeyDiscipline({
|
|
421
|
+
tier: "cache.data",
|
|
422
|
+
id: disciplineId,
|
|
423
|
+
label: fn.name || void 0,
|
|
424
|
+
cacheKey: key
|
|
425
|
+
}, () => fn(...args));
|
|
426
|
+
} catch (err) {
|
|
427
|
+
if (err instanceof KeyDisciplineViolation && !signal.aborted) await getHandler().invalidate({ key: storeKey }).catch((e) => swallow(e, `cache invalidate failed for key "${key}"`));
|
|
428
|
+
throw err;
|
|
429
|
+
}
|
|
430
|
+
if (!signal.aborted && !wasInvalidatedSince(startEpoch, key, tags)) try {
|
|
431
|
+
await getHandler().set(storeKey, result, {
|
|
432
|
+
ttl: opts.ttl,
|
|
433
|
+
tags
|
|
434
|
+
});
|
|
435
|
+
} catch (err) {
|
|
436
|
+
swallow(err, `cache set failed for key "${key}"`);
|
|
437
|
+
}
|
|
438
|
+
return result;
|
|
439
|
+
};
|
|
440
|
+
if (cached && cached.stale && opts.staleWhileRevalidate) {
|
|
441
|
+
addSpanEventSync("timber.cache.hit", {
|
|
442
|
+
key,
|
|
443
|
+
duration_ms: Math.round(performance.now() - cacheStart),
|
|
444
|
+
stale: true
|
|
445
|
+
});
|
|
446
|
+
const refetch = flights.do(flightKey, (signal) => executeAndStore(signal).catch((err) => {
|
|
447
|
+
logSwrRefetchFailed({
|
|
448
|
+
cacheKey: key,
|
|
449
|
+
error: err
|
|
450
|
+
});
|
|
451
|
+
throw err;
|
|
452
|
+
}), timeoutMs).then(() => {}, () => {});
|
|
453
|
+
getWaitUntil()?.(refetch);
|
|
454
|
+
return cached.value;
|
|
455
|
+
}
|
|
456
|
+
const result = await flights.do(flightKey, executeAndStore, timeoutMs);
|
|
457
|
+
addSpanEventSync("timber.cache.miss", {
|
|
458
|
+
key,
|
|
459
|
+
duration_ms: Math.round(performance.now() - cacheStart)
|
|
460
|
+
});
|
|
461
|
+
logCacheMiss({ cacheKey: key });
|
|
462
|
+
return result;
|
|
463
|
+
});
|
|
464
|
+
}
|
|
465
|
+
// src/cache/redis-handler.ts
|
|
466
|
+
var KEY_PREFIX = "timber:cache:";
|
|
467
|
+
var TAG_PREFIX = "timber:tag:";
|
|
468
|
+
/**
|
|
469
|
+
* Redis-backed CacheHandler for distributed caching.
|
|
470
|
+
*
|
|
471
|
+
* All instances sharing the same Redis see each other's cache entries and
|
|
472
|
+
* invalidations. Tag-based invalidation uses Redis Sets to track which keys
|
|
473
|
+
* belong to which tags.
|
|
474
|
+
*
|
|
475
|
+
* Bring your own Redis client wrapped to the {@link RedisClient} contract —
|
|
476
|
+
* see the adapter examples on the interface for ioredis, node-redis v4, and
|
|
477
|
+
* @upstash/redis.
|
|
478
|
+
*/
|
|
479
|
+
var RedisCacheHandler = class {
|
|
480
|
+
client;
|
|
481
|
+
prefix;
|
|
482
|
+
constructor(client, opts) {
|
|
483
|
+
this.client = client;
|
|
484
|
+
this.prefix = opts?.prefix ?? "";
|
|
485
|
+
}
|
|
486
|
+
cacheKey(key) {
|
|
487
|
+
return `${this.prefix}${KEY_PREFIX}${key}`;
|
|
488
|
+
}
|
|
489
|
+
tagKey(tag) {
|
|
490
|
+
return `${this.prefix}${TAG_PREFIX}${tag}`;
|
|
491
|
+
}
|
|
492
|
+
async get(key) {
|
|
493
|
+
const raw = await this.client.get(this.cacheKey(key));
|
|
494
|
+
if (raw === null) return null;
|
|
495
|
+
const entry = JSON.parse(raw);
|
|
496
|
+
const stale = Date.now() > entry.expiresAt;
|
|
497
|
+
return {
|
|
498
|
+
value: entry.value,
|
|
499
|
+
stale
|
|
500
|
+
};
|
|
501
|
+
}
|
|
502
|
+
async set(key, value, opts) {
|
|
503
|
+
warnLossyJsonValue(value, key);
|
|
504
|
+
const ck = this.cacheKey(key);
|
|
505
|
+
const expiresAt = Date.now() + opts.ttl * 1e3;
|
|
506
|
+
const payload = JSON.stringify({
|
|
507
|
+
value,
|
|
508
|
+
expiresAt,
|
|
509
|
+
tags: opts.tags
|
|
510
|
+
});
|
|
511
|
+
const redisTtlSeconds = Math.max(opts.ttl * 2 + 60, 120);
|
|
512
|
+
const writeOps = [];
|
|
513
|
+
for (const tag of opts.tags) {
|
|
514
|
+
writeOps.push({
|
|
515
|
+
op: "sadd",
|
|
516
|
+
key: this.tagKey(tag),
|
|
517
|
+
members: [key]
|
|
518
|
+
});
|
|
519
|
+
writeOps.push({
|
|
520
|
+
op: "expireNX",
|
|
521
|
+
key: this.tagKey(tag),
|
|
522
|
+
seconds: redisTtlSeconds
|
|
523
|
+
});
|
|
524
|
+
writeOps.push({
|
|
525
|
+
op: "expireGT",
|
|
526
|
+
key: this.tagKey(tag),
|
|
527
|
+
seconds: redisTtlSeconds
|
|
528
|
+
});
|
|
529
|
+
}
|
|
530
|
+
writeOps.push({
|
|
531
|
+
op: "set",
|
|
532
|
+
key: ck,
|
|
533
|
+
value: payload,
|
|
534
|
+
ttlSeconds: redisTtlSeconds
|
|
535
|
+
});
|
|
536
|
+
if (this.client.execMulti) await this.client.execMulti(writeOps);
|
|
537
|
+
else for (const op of writeOps) await this.execOp(op);
|
|
538
|
+
}
|
|
539
|
+
async execOp(op) {
|
|
540
|
+
switch (op.op) {
|
|
541
|
+
case "set":
|
|
542
|
+
await this.client.set(op.key, op.value, op.ttlSeconds);
|
|
543
|
+
break;
|
|
544
|
+
case "sadd":
|
|
545
|
+
await this.client.sadd(op.key, ...op.members);
|
|
546
|
+
break;
|
|
547
|
+
case "expireNX":
|
|
548
|
+
await this.client.expireNX(op.key, op.seconds);
|
|
549
|
+
break;
|
|
550
|
+
case "expireGT":
|
|
551
|
+
await this.client.expireGT(op.key, op.seconds);
|
|
552
|
+
break;
|
|
553
|
+
case "del": await this.client.del(op.key);
|
|
554
|
+
}
|
|
555
|
+
}
|
|
556
|
+
async invalidate(opts) {
|
|
557
|
+
if (opts.key) {
|
|
558
|
+
const raw = await this.client.get(this.cacheKey(opts.key));
|
|
559
|
+
if (raw !== null) {
|
|
560
|
+
const entry = JSON.parse(raw);
|
|
561
|
+
if (entry.tags) await Promise.all(entry.tags.map((tag) => this.client.srem(this.tagKey(tag), opts.key)));
|
|
562
|
+
}
|
|
563
|
+
await this.client.del(this.cacheKey(opts.key));
|
|
564
|
+
}
|
|
565
|
+
if (opts.tag) {
|
|
566
|
+
const tk = this.tagKey(opts.tag);
|
|
567
|
+
const keys = await this.client.smembers(tk);
|
|
568
|
+
await Promise.all(keys.map(async (k) => {
|
|
569
|
+
const raw = await this.client.get(this.cacheKey(k));
|
|
570
|
+
if (raw === null) {
|
|
571
|
+
await this.client.srem(tk, k);
|
|
572
|
+
return;
|
|
573
|
+
}
|
|
574
|
+
if (JSON.parse(raw).tags?.includes(opts.tag)) await this.client.del(this.cacheKey(k));
|
|
575
|
+
await this.client.srem(tk, k);
|
|
576
|
+
}));
|
|
577
|
+
if ((await this.client.smembers(tk)).length === 0) await this.client.del(tk);
|
|
578
|
+
}
|
|
579
|
+
}
|
|
580
|
+
};
|
|
581
|
+
// src/cache/tag-aware-handler.ts
|
|
582
|
+
var DATA_PREFIX = "d:";
|
|
583
|
+
var TAG_SET_PREFIX = "ts:";
|
|
584
|
+
var TAG_VERSION_PREFIX = "tv:";
|
|
585
|
+
function isNativeStore(store) {
|
|
586
|
+
return !!(store.setWithTags && store.invalidateTag);
|
|
587
|
+
}
|
|
588
|
+
function isEagerStore(store) {
|
|
589
|
+
return !!(store.sadd && store.smembers && store.srem && store.sdel);
|
|
590
|
+
}
|
|
591
|
+
function detectStrategy(store) {
|
|
592
|
+
if (isNativeStore(store)) return {
|
|
593
|
+
kind: "native",
|
|
594
|
+
store
|
|
595
|
+
};
|
|
596
|
+
if (isEagerStore(store)) return {
|
|
597
|
+
kind: "eager",
|
|
598
|
+
store
|
|
599
|
+
};
|
|
600
|
+
return { kind: "lazy" };
|
|
601
|
+
}
|
|
602
|
+
var TagAwareCacheHandler = class {
|
|
603
|
+
store;
|
|
604
|
+
prefix;
|
|
605
|
+
strategy;
|
|
606
|
+
constructor(store, opts) {
|
|
607
|
+
this.store = store;
|
|
608
|
+
this.prefix = opts?.prefix ?? "timber:";
|
|
609
|
+
this.strategy = detectStrategy(store);
|
|
610
|
+
}
|
|
611
|
+
get consistency() {
|
|
612
|
+
return this.store.consistency;
|
|
613
|
+
}
|
|
614
|
+
dataKey(key) {
|
|
615
|
+
return `${this.prefix}${DATA_PREFIX}${key}`;
|
|
616
|
+
}
|
|
617
|
+
/** Namespace tags for native stores so prefix isolates shared stores. */
|
|
618
|
+
prefixTags(tags) {
|
|
619
|
+
return tags.map((t) => `${this.prefix}${t}`);
|
|
620
|
+
}
|
|
621
|
+
tagSetKey(tag) {
|
|
622
|
+
return `${this.prefix}${TAG_SET_PREFIX}${tag}`;
|
|
623
|
+
}
|
|
624
|
+
tagVersionKey(tag) {
|
|
625
|
+
return `${this.prefix}${TAG_VERSION_PREFIX}${tag}`;
|
|
626
|
+
}
|
|
627
|
+
async get(key) {
|
|
628
|
+
const raw = await this.store.get(this.dataKey(key));
|
|
629
|
+
if (raw === null) return null;
|
|
630
|
+
if (this.strategy.kind !== "lazy") {
|
|
631
|
+
const entry = JSON.parse(raw);
|
|
632
|
+
const stale = Date.now() > entry.expiresAt;
|
|
633
|
+
return {
|
|
634
|
+
value: entry.value,
|
|
635
|
+
stale
|
|
636
|
+
};
|
|
637
|
+
}
|
|
638
|
+
const entry = JSON.parse(raw);
|
|
639
|
+
if (entry.tags.length > 0) {
|
|
640
|
+
const currentVersions = await this.getTagVersions(entry.tags);
|
|
641
|
+
for (const tag of entry.tags) {
|
|
642
|
+
const stored = entry.tagVersions[tag] ?? 0;
|
|
643
|
+
if ((currentVersions[tag] ?? 0) > stored) return null;
|
|
644
|
+
}
|
|
645
|
+
}
|
|
646
|
+
const stale = Date.now() > entry.expiresAt;
|
|
647
|
+
return {
|
|
648
|
+
value: entry.value,
|
|
649
|
+
stale
|
|
650
|
+
};
|
|
651
|
+
}
|
|
652
|
+
async set(key, value, opts) {
|
|
653
|
+
const physicalTtl = Math.max(opts.ttl * 2 + 60, 120);
|
|
654
|
+
const strategy = this.strategy;
|
|
655
|
+
if (strategy.kind === "native") {
|
|
656
|
+
const entry = {
|
|
657
|
+
value,
|
|
658
|
+
expiresAt: Date.now() + opts.ttl * 1e3,
|
|
659
|
+
tags: opts.tags
|
|
660
|
+
};
|
|
661
|
+
const payload = JSON.stringify(entry);
|
|
662
|
+
if (opts.tags.length > 0) await strategy.store.setWithTags(this.dataKey(key), payload, physicalTtl, this.prefixTags(opts.tags));
|
|
663
|
+
else await this.store.set(this.dataKey(key), payload, physicalTtl);
|
|
664
|
+
return;
|
|
665
|
+
}
|
|
666
|
+
if (strategy.kind === "eager") {
|
|
667
|
+
const entry = {
|
|
668
|
+
value,
|
|
669
|
+
expiresAt: Date.now() + opts.ttl * 1e3,
|
|
670
|
+
tags: opts.tags
|
|
671
|
+
};
|
|
672
|
+
await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
|
|
673
|
+
if (opts.tags.length > 0) await Promise.all(opts.tags.map((tag) => strategy.store.sadd(this.tagSetKey(tag), [key], physicalTtl)));
|
|
674
|
+
return;
|
|
675
|
+
}
|
|
676
|
+
const tagVersions = opts.tags.length > 0 ? await this.getTagVersions(opts.tags) : {};
|
|
677
|
+
const entry = {
|
|
678
|
+
value,
|
|
679
|
+
expiresAt: Date.now() + opts.ttl * 1e3,
|
|
680
|
+
tags: opts.tags,
|
|
681
|
+
tagVersions
|
|
682
|
+
};
|
|
683
|
+
await this.store.set(this.dataKey(key), JSON.stringify(entry), physicalTtl);
|
|
684
|
+
}
|
|
685
|
+
async invalidate(opts) {
|
|
686
|
+
const strategy = this.strategy;
|
|
687
|
+
if (opts.key) {
|
|
688
|
+
const key = opts.key;
|
|
689
|
+
if (strategy.kind === "eager") {
|
|
690
|
+
const raw = await this.store.get(this.dataKey(key));
|
|
691
|
+
if (raw !== null) {
|
|
692
|
+
const entry = JSON.parse(raw);
|
|
693
|
+
if (entry.tags.length > 0) await Promise.all(entry.tags.map((tag) => strategy.store.srem(this.tagSetKey(tag), [key])));
|
|
694
|
+
}
|
|
695
|
+
}
|
|
696
|
+
await this.store.del(this.dataKey(key));
|
|
697
|
+
}
|
|
698
|
+
if (opts.tag) {
|
|
699
|
+
const tag = opts.tag;
|
|
700
|
+
if (strategy.kind === "native") await strategy.store.invalidateTag(`${this.prefix}${tag}`);
|
|
701
|
+
else if (strategy.kind === "eager") {
|
|
702
|
+
const members = await strategy.store.smembers(this.tagSetKey(tag));
|
|
703
|
+
await Promise.all(members.map(async (k) => {
|
|
704
|
+
const raw = await this.store.get(this.dataKey(k));
|
|
705
|
+
if (raw !== null && JSON.parse(raw).tags.includes(tag)) await this.store.del(this.dataKey(k));
|
|
706
|
+
await strategy.store.srem(this.tagSetKey(tag), [k]);
|
|
707
|
+
}));
|
|
708
|
+
} else await this.bumpTagVersion(opts.tag);
|
|
709
|
+
}
|
|
710
|
+
}
|
|
711
|
+
async getTagVersions(tags) {
|
|
712
|
+
const versions = {};
|
|
713
|
+
await Promise.all(tags.map(async (tag) => {
|
|
714
|
+
const raw = await this.store.get(this.tagVersionKey(tag));
|
|
715
|
+
versions[tag] = raw !== null ? parseInt(raw, 10) : 0;
|
|
716
|
+
}));
|
|
717
|
+
return versions;
|
|
718
|
+
}
|
|
719
|
+
async bumpTagVersion(tag) {
|
|
720
|
+
const key = this.tagVersionKey(tag);
|
|
721
|
+
const raw = await this.store.get(key);
|
|
722
|
+
const version = Math.max(raw !== null ? parseInt(raw, 10) : 0, Date.now()) + 1;
|
|
723
|
+
await this.store.set(key, String(version), 31536e3);
|
|
724
|
+
}
|
|
725
|
+
};
|
|
726
|
+
// src/cache/index.ts
|
|
727
|
+
var MemoryCacheHandler = class {
|
|
728
|
+
store = /* @__PURE__ */ new Map();
|
|
729
|
+
maxEntries;
|
|
730
|
+
maxBytes;
|
|
731
|
+
maxEntryBytes;
|
|
732
|
+
currentBytes = 0;
|
|
733
|
+
_trackBytes;
|
|
734
|
+
constructor(opts) {
|
|
735
|
+
this.maxEntries = opts?.maxEntries ?? opts?.maxSize ?? 1e3;
|
|
736
|
+
this.maxBytes = opts?.maxBytes;
|
|
737
|
+
this.maxEntryBytes = opts?.maxEntryBytes;
|
|
738
|
+
this._trackBytes = this.maxBytes !== void 0 || this.maxEntryBytes !== void 0;
|
|
739
|
+
}
|
|
740
|
+
async get(key) {
|
|
741
|
+
const entry = this.store.get(key);
|
|
742
|
+
if (!entry) return null;
|
|
743
|
+
this.store.delete(key);
|
|
744
|
+
this.store.set(key, entry);
|
|
745
|
+
const stale = Date.now() > entry.expiresAt;
|
|
746
|
+
return {
|
|
747
|
+
value: entry.value,
|
|
748
|
+
stale
|
|
749
|
+
};
|
|
750
|
+
}
|
|
751
|
+
async set(key, value, opts) {
|
|
752
|
+
const byteSize = this._trackBytes ? estimateByteSize(value) : 0;
|
|
753
|
+
if (this.maxEntryBytes !== void 0 && byteSize > this.maxEntryBytes) return;
|
|
754
|
+
if (this.store.has(key)) {
|
|
755
|
+
const existing = this.store.get(key);
|
|
756
|
+
this.currentBytes -= existing.byteSize;
|
|
757
|
+
this.store.delete(key);
|
|
758
|
+
}
|
|
759
|
+
while (this.store.size >= this.maxEntries) this.evictOldest();
|
|
760
|
+
if (this.maxBytes !== void 0) {
|
|
761
|
+
while (this.currentBytes + byteSize > this.maxBytes && this.store.size > 0) this.evictOldest();
|
|
762
|
+
if (this.currentBytes + byteSize > this.maxBytes) return;
|
|
763
|
+
}
|
|
764
|
+
this.store.set(key, {
|
|
765
|
+
value,
|
|
766
|
+
expiresAt: Date.now() + opts.ttl * 1e3,
|
|
767
|
+
tags: opts.tags,
|
|
768
|
+
byteSize
|
|
769
|
+
});
|
|
770
|
+
this.currentBytes += byteSize;
|
|
771
|
+
}
|
|
772
|
+
async invalidate(opts) {
|
|
773
|
+
if (opts.key) {
|
|
774
|
+
const entry = this.store.get(opts.key);
|
|
775
|
+
if (entry) {
|
|
776
|
+
this.currentBytes -= entry.byteSize;
|
|
777
|
+
this.store.delete(opts.key);
|
|
778
|
+
}
|
|
779
|
+
}
|
|
780
|
+
if (opts.tag) {
|
|
781
|
+
for (const [key, entry] of this.store) if (entry.tags.includes(opts.tag)) {
|
|
782
|
+
this.currentBytes -= entry.byteSize;
|
|
783
|
+
this.store.delete(key);
|
|
784
|
+
}
|
|
785
|
+
}
|
|
786
|
+
}
|
|
787
|
+
/** Number of entries currently in the cache. */
|
|
788
|
+
get size() {
|
|
789
|
+
return this.store.size;
|
|
790
|
+
}
|
|
791
|
+
/** Estimated total byte size of all cached values. Only tracked when maxBytes or maxEntryBytes is configured; returns 0 otherwise. */
|
|
792
|
+
get bytes() {
|
|
793
|
+
return this.currentBytes;
|
|
794
|
+
}
|
|
795
|
+
/** Evict the oldest entry (front of Map). */
|
|
796
|
+
evictOldest() {
|
|
797
|
+
const oldest = this.store.keys().next().value;
|
|
798
|
+
if (oldest !== void 0) {
|
|
799
|
+
const entry = this.store.get(oldest);
|
|
800
|
+
this.currentBytes -= entry.byteSize;
|
|
801
|
+
this.store.delete(oldest);
|
|
802
|
+
}
|
|
803
|
+
}
|
|
804
|
+
};
|
|
805
|
+
// src/server/version-skew.ts
|
|
806
|
+
/**
|
|
807
|
+
* Version Skew Detection — graceful recovery when stale clients hit new deployments.
|
|
808
|
+
*
|
|
809
|
+
* When a new version of the app is deployed, clients with open tabs still have
|
|
810
|
+
* the old JavaScript bundle. Without version skew handling, these stale clients
|
|
811
|
+
* will experience:
|
|
812
|
+
*
|
|
813
|
+
* 1. Server action calls that crash (action IDs are content-hashed)
|
|
814
|
+
* 2. Chunk load failures (old filenames gone from CDN)
|
|
815
|
+
* 3. RSC payload mismatches (component references differ between builds)
|
|
816
|
+
*
|
|
817
|
+
* This module implements deployment ID comparison:
|
|
818
|
+
* - A per-build deployment ID is generated at build time (see build-manifest.ts)
|
|
819
|
+
* - The client sends it via `X-Timber-Deployment-Id` header on every RSC/action request
|
|
820
|
+
* - The server compares it against the current build's ID
|
|
821
|
+
* - On mismatch: signal the client to reload (not crash)
|
|
822
|
+
*
|
|
823
|
+
* The deployment ID is always-on in production. Dev mode skips the check
|
|
824
|
+
* (HMR handles code updates without full reloads).
|
|
825
|
+
*
|
|
826
|
+
* See design/25-production-deployments.md, TIM-446
|
|
827
|
+
*/
|
|
828
|
+
/** Header sent by the client with every RSC/action request. */
|
|
829
|
+
var DEPLOYMENT_ID_HEADER = "X-Timber-Deployment-Id";
|
|
830
|
+
/** Response header that signals the client to do a full page reload. */
|
|
831
|
+
var RELOAD_HEADER = "X-Timber-Reload";
|
|
832
|
+
/**
|
|
833
|
+
* The current build's deployment ID. Set at startup from the runtime config
|
|
834
|
+
* (`virtual:timber-config`'s `deploymentId`). Null in dev mode.
|
|
835
|
+
*/
|
|
836
|
+
var currentDeploymentId = null;
|
|
837
|
+
/**
|
|
838
|
+
* Get the current deployment ID. Returns null in dev mode.
|
|
839
|
+
*/
|
|
840
|
+
function getDeploymentId() {
|
|
841
|
+
return currentDeploymentId;
|
|
842
|
+
}
|
|
843
|
+
/**
|
|
844
|
+
* Check if a request's deployment ID matches the current build.
|
|
845
|
+
*
|
|
846
|
+
* Returns `{ ok: true }` when:
|
|
847
|
+
* - Dev mode (no deployment ID set — HMR handles updates)
|
|
848
|
+
* - No deployment ID header (initial page load, non-RSC request)
|
|
849
|
+
* - Deployment IDs match
|
|
850
|
+
*
|
|
851
|
+
* Returns `{ ok: false }` when:
|
|
852
|
+
* - Client sends a deployment ID that differs from the current build
|
|
853
|
+
*/
|
|
854
|
+
function checkVersionSkew(req) {
|
|
855
|
+
if (!currentDeploymentId) return {
|
|
856
|
+
ok: true,
|
|
857
|
+
clientId: null
|
|
858
|
+
};
|
|
859
|
+
const clientId = req.headers.get(DEPLOYMENT_ID_HEADER);
|
|
860
|
+
if (!clientId) return {
|
|
861
|
+
ok: true,
|
|
862
|
+
clientId: null
|
|
863
|
+
};
|
|
864
|
+
if (clientId === currentDeploymentId) return {
|
|
865
|
+
ok: true,
|
|
866
|
+
clientId
|
|
867
|
+
};
|
|
868
|
+
return {
|
|
869
|
+
ok: false,
|
|
870
|
+
clientId
|
|
871
|
+
};
|
|
872
|
+
}
|
|
873
|
+
/**
|
|
874
|
+
* Apply version skew reload headers to a response.
|
|
875
|
+
* Sets X-Timber-Reload: 1 to signal the client to do a full page reload.
|
|
876
|
+
*/
|
|
877
|
+
function applyReloadHeaders(headers) {
|
|
878
|
+
headers.set(RELOAD_HEADER, "1");
|
|
879
|
+
}
|
|
880
|
+
// src/server/prebuilt/manifest-tag-index.ts
|
|
881
|
+
/**
|
|
882
|
+
* Build the inverted tag → seed key index from the manifest.
|
|
883
|
+
*
|
|
884
|
+
* Returns a Map where each tag maps to the set of (componentId, cacheKey)
|
|
885
|
+
* pairs whose manifest entries carry that tag. Only entries with non-empty
|
|
886
|
+
* `tags` arrays participate.
|
|
887
|
+
*/
|
|
888
|
+
function buildTagIndex(manifest) {
|
|
889
|
+
const index = /* @__PURE__ */ new Map();
|
|
890
|
+
for (const [componentId, component] of Object.entries(manifest)) {
|
|
891
|
+
if (!component || typeof component !== "object" || !("entries" in component)) continue;
|
|
892
|
+
for (const [cacheKey, entry] of Object.entries(component.entries)) {
|
|
893
|
+
if (!entry.tags || entry.tags.length === 0) continue;
|
|
894
|
+
for (const tag of entry.tags) {
|
|
895
|
+
let list = index.get(tag);
|
|
896
|
+
if (!list) {
|
|
897
|
+
list = [];
|
|
898
|
+
index.set(tag, list);
|
|
899
|
+
}
|
|
900
|
+
list.push({
|
|
901
|
+
componentId,
|
|
902
|
+
cacheKey
|
|
903
|
+
});
|
|
904
|
+
}
|
|
905
|
+
}
|
|
906
|
+
}
|
|
907
|
+
return index;
|
|
908
|
+
}
|
|
909
|
+
// src/server/prebuilt/payload-source.ts
|
|
910
|
+
/**
|
|
911
|
+
* Prebuilt payload source — the adapter seam through which the runtime
|
|
912
|
+
* reads build-time flight artifacts (`.timber/dist/prebuilt/`).
|
|
913
|
+
*
|
|
914
|
+
* The runtime never touches the filesystem directly: adapters register a
|
|
915
|
+
* source at startup (Node: fs reads; Cloudflare: the assets binding —
|
|
916
|
+
* design/44-render-at-build-time.md §Adapter Integration). Artifacts are
|
|
917
|
+
* produced by the post-build capture pass (TIM-1119, prebuilt-builder.ts);
|
|
918
|
+
* adapter registration of the source is TIM-1122. Until a source is
|
|
919
|
+
* registered (adapter not wired yet, dev mode, no artifacts built), every
|
|
920
|
+
* lookup misses and cache.component wrappers render live — the designed
|
|
921
|
+
* dynamic-fallback behavior.
|
|
922
|
+
*
|
|
923
|
+
* Phase 3 (design/45 runtime tier) inserts the CacheHandler overlay lookup
|
|
924
|
+
* in front of `lookupPrebuiltPayload` — overlay first, then artifact. The
|
|
925
|
+
* single-lookup-function shape here is that seam.
|
|
926
|
+
*/
|
|
927
|
+
var source = null;
|
|
928
|
+
var manifestPromise = null;
|
|
929
|
+
/**
|
|
930
|
+
* Ceiling on the memoized manifest load. Without it, a stalled
|
|
931
|
+
* `loadManifest()` would leave `manifestPromise` pending forever and every
|
|
932
|
+
* subsequent cache.component render would await the same hung promise —
|
|
933
|
+
* the coalesced-promise deadlock class from design/13-security.md (A5).
|
|
934
|
+
* On expiry the load memoizes as null (permanent dynamic fallback, same
|
|
935
|
+
* policy as a failed load) and callers proceed immediately.
|
|
936
|
+
*/
|
|
937
|
+
var MANIFEST_LOAD_TIMEOUT_MS = 5e3;
|
|
938
|
+
/**
|
|
939
|
+
* Per-read ceiling on payload reads. The read is awaited inside a server
|
|
940
|
+
* component render — a stalled adapter promise would otherwise hang the
|
|
941
|
+
* RSC stream until the render timeout kills the whole page, when the
|
|
942
|
+
* correct degradation is a miss → live render (codex review round 4 on
|
|
943
|
+
* PR #835).
|
|
944
|
+
*/
|
|
945
|
+
var PAYLOAD_READ_TIMEOUT_MS = 5e3;
|
|
946
|
+
/** Race a source promise against a timeout that resolves to `fallback`. */
|
|
947
|
+
async function withTimeout(work, timeoutMs, fallback, onTimeout) {
|
|
948
|
+
let timer;
|
|
949
|
+
try {
|
|
950
|
+
return await Promise.race([work, new Promise((resolve) => {
|
|
951
|
+
timer = setTimeout(() => {
|
|
952
|
+
onTimeout();
|
|
953
|
+
resolve(fallback);
|
|
954
|
+
}, timeoutMs);
|
|
955
|
+
})]);
|
|
956
|
+
} finally {
|
|
957
|
+
clearTimeout(timer);
|
|
958
|
+
}
|
|
959
|
+
}
|
|
960
|
+
async function loadManifestWithTimeout(src) {
|
|
961
|
+
let manifest;
|
|
962
|
+
try {
|
|
963
|
+
manifest = await withTimeout(src.loadManifest(), MANIFEST_LOAD_TIMEOUT_MS, null, () => {
|
|
964
|
+
console.error(`[timber] prebuilt manifest load exceeded ${MANIFEST_LOAD_TIMEOUT_MS}ms — all cache.component lookups will render dynamically`);
|
|
965
|
+
});
|
|
966
|
+
} catch (error) {
|
|
967
|
+
console.error("[timber] failed to load prebuilt manifest — all cache.component lookups will miss:", error);
|
|
968
|
+
return null;
|
|
969
|
+
}
|
|
970
|
+
if (manifest) initTagIndex(manifest);
|
|
971
|
+
return manifest;
|
|
972
|
+
}
|
|
973
|
+
/**
|
|
974
|
+
* Register the payload source. Called once at server startup by the
|
|
975
|
+
* adapter/entry wiring (TIM-1122); tests inject fakes. Passing null
|
|
976
|
+
* unregisters (and drops the memoized manifest).
|
|
977
|
+
*/
|
|
978
|
+
function setPrebuiltPayloadSource(next) {
|
|
979
|
+
source = next;
|
|
980
|
+
manifestPromise = null;
|
|
981
|
+
if (!next) resetTagIndex();
|
|
982
|
+
}
|
|
983
|
+
/**
|
|
984
|
+
* Whether a source is registered — the gate for both marker emission and
|
|
985
|
+
* splice-transform installation. False means zero prebuilt overhead.
|
|
986
|
+
*/
|
|
987
|
+
function hasPrebuiltPayloadSource() {
|
|
988
|
+
return source !== null;
|
|
989
|
+
}
|
|
990
|
+
/**
|
|
991
|
+
* Ensure the manifest is loaded (and the tag index initialized). No-op
|
|
992
|
+
* when no source is registered. Used by the tombstone path to avoid
|
|
993
|
+
* skipping tombstones on cold processes where the first request is an
|
|
994
|
+
* action rather than a page render.
|
|
995
|
+
*/
|
|
996
|
+
async function ensureManifestLoaded() {
|
|
997
|
+
if (source === null) return;
|
|
998
|
+
manifestPromise ??= loadManifestWithTimeout(source);
|
|
999
|
+
await manifestPromise;
|
|
1000
|
+
}
|
|
1001
|
+
/**
|
|
1002
|
+
* Look up a manifest entry (metadata only, no payload read).
|
|
1003
|
+
* Used by the overlay to check seed existence and freshness.
|
|
1004
|
+
*/
|
|
1005
|
+
async function isParamIndependent(componentId) {
|
|
1006
|
+
if (source === null) return false;
|
|
1007
|
+
manifestPromise ??= loadManifestWithTimeout(source);
|
|
1008
|
+
return (await manifestPromise)?.[componentId]?.paramIndependent === true;
|
|
1009
|
+
}
|
|
1010
|
+
async function getManifestEntry(componentId, cacheKey) {
|
|
1011
|
+
if (source === null) return null;
|
|
1012
|
+
manifestPromise ??= loadManifestWithTimeout(source);
|
|
1013
|
+
return (await manifestPromise)?.[componentId]?.entries?.[cacheKey] ?? null;
|
|
1014
|
+
}
|
|
1015
|
+
/**
|
|
1016
|
+
* Look up a cached payload: manifest entry → payload bytes.
|
|
1017
|
+
* Null on any miss or read failure — callers fall back to live render.
|
|
1018
|
+
*
|
|
1019
|
+
* The manifest is loaded once and memoized (design/44 §manifest.json:
|
|
1020
|
+
* loaded at startup, held in memory; payloads read on demand). A failed
|
|
1021
|
+
* manifest load is memoized as null rather than retried per-request — a
|
|
1022
|
+
* broken artifact should degrade to dynamic rendering, not add a failing
|
|
1023
|
+
* read to every request.
|
|
1024
|
+
*/
|
|
1025
|
+
async function lookupPrebuiltPayload(componentId, cacheKey) {
|
|
1026
|
+
if (source === null) return null;
|
|
1027
|
+
manifestPromise ??= loadManifestWithTimeout(source);
|
|
1028
|
+
const entry = (await manifestPromise)?.[componentId]?.entries?.[cacheKey];
|
|
1029
|
+
if (!entry) return null;
|
|
1030
|
+
try {
|
|
1031
|
+
return await withTimeout(source.readPayload(entry.file), PAYLOAD_READ_TIMEOUT_MS, null, () => {
|
|
1032
|
+
console.error(`[timber] prebuilt payload read for "${entry.file}" exceeded ${PAYLOAD_READ_TIMEOUT_MS}ms — rendering dynamically`);
|
|
1033
|
+
});
|
|
1034
|
+
} catch (error) {
|
|
1035
|
+
console.error(`[timber] failed to read prebuilt payload "${entry.file}" for ${componentId} — rendering dynamically:`, error);
|
|
1036
|
+
return null;
|
|
1037
|
+
}
|
|
1038
|
+
}
|
|
1039
|
+
/** The build-artifact seed for an entry, or null if the build has none. */
|
|
1040
|
+
async function lookupArtifactSeed(id, cacheKey, needsTimestamp) {
|
|
1041
|
+
const payload = await lookupPrebuiltPayload(id, cacheKey);
|
|
1042
|
+
if (payload === null) return null;
|
|
1043
|
+
return {
|
|
1044
|
+
payload,
|
|
1045
|
+
capturedAt: (needsTimestamp ? await getManifestEntry(id, cacheKey) : null)?.buildTimestamp ?? 0
|
|
1046
|
+
};
|
|
1047
|
+
}
|
|
1048
|
+
// src/server/prebuilt/overlay.ts
|
|
1049
|
+
/**
|
|
1050
|
+
* Component cache overlay — runtime CacheHandler layer for ISR.
|
|
1051
|
+
*
|
|
1052
|
+
* Sits in front of the immutable build artifact (`.flight` files) and
|
|
1053
|
+
* stores replacement payloads and tombstones via the configured
|
|
1054
|
+
* CacheHandler. Overlay entries are per-deploy namespaced:
|
|
1055
|
+
* `timber:c:{deploymentId}:{componentId}:{hash}`
|
|
1056
|
+
*
|
|
1057
|
+
* The CacheHandler contract is untouched — tombstones and the tag index
|
|
1058
|
+
* live above the interface as value conventions. Redis, KV, and custom
|
|
1059
|
+
* handlers work unmodified.
|
|
1060
|
+
*
|
|
1061
|
+
* See design/45-cache-lifetimes.md §ISR mechanics.
|
|
1062
|
+
*/
|
|
1063
|
+
/** Default ceiling TTL for tag-only entries (24 hours), in seconds. */
|
|
1064
|
+
var CEILING_TTL_SECONDS = 86400;
|
|
1065
|
+
/** Deploy-long physical TTL for seed-backed overlay records (90 days). */
|
|
1066
|
+
var DEPLOY_LONG_TTL_SECONDS = 7776e3;
|
|
1067
|
+
function isOverlayRecord(v) {
|
|
1068
|
+
return v !== null && typeof v === "object" && v._t === "co";
|
|
1069
|
+
}
|
|
1070
|
+
function isTombstone(v) {
|
|
1071
|
+
return v !== null && typeof v === "object" && v._t === "ct";
|
|
1072
|
+
}
|
|
1073
|
+
/**
|
|
1074
|
+
* In dev the deployment ID is null; the dev store namespace stands in for
|
|
1075
|
+
* it and changes on every source change, so entries stored before a save
|
|
1076
|
+
* become unreachable (server/prebuilt/dev-store.ts).
|
|
1077
|
+
*/
|
|
1078
|
+
function overlayKey(componentId, cacheKey) {
|
|
1079
|
+
return `timber:c:${getDeploymentId() ?? devOverlayNamespace() ?? "dev"}:${componentId}:${cacheKey}`;
|
|
1080
|
+
}
|
|
1081
|
+
/**
|
|
1082
|
+
* Whether a re-render that started at `startEpoch` may store its capture
|
|
1083
|
+
* under `oKey`: nothing invalidated the key or its tags meanwhile
|
|
1084
|
+
* (TIM-1028), and the overlay key has not moved on. In dev a save moves it
|
|
1085
|
+
* to a new namespace, and the bytes may come from the pre-save code: stored,
|
|
1086
|
+
* they would answer every request after the save.
|
|
1087
|
+
*/
|
|
1088
|
+
function mayStoreRerender(startEpoch, componentId, cacheKey, oKey, tags) {
|
|
1089
|
+
return !wasInvalidatedSince(startEpoch, oKey, tags) && overlayKey(componentId, cacheKey) === oKey;
|
|
1090
|
+
}
|
|
1091
|
+
var READ_FAILED = Symbol("overlay read failed");
|
|
1092
|
+
/**
|
|
1093
|
+
* Look up an overlay entry in the cache handler.
|
|
1094
|
+
* Returns null on a clean miss (no overlay entry at all).
|
|
1095
|
+
*/
|
|
1096
|
+
async function lookupOverlay(componentId, cacheKey) {
|
|
1097
|
+
const handler = getCacheHandler();
|
|
1098
|
+
const key = overlayKey(componentId, cacheKey);
|
|
1099
|
+
const result = await guardedRead(key, () => handler.get(key), READ_FAILED);
|
|
1100
|
+
if (result === READ_FAILED) return {
|
|
1101
|
+
kind: "unreadable",
|
|
1102
|
+
record: null,
|
|
1103
|
+
payload: null
|
|
1104
|
+
};
|
|
1105
|
+
if (!result) return null;
|
|
1106
|
+
const value = result.value;
|
|
1107
|
+
if (isTombstone(value)) return {
|
|
1108
|
+
kind: "tombstone",
|
|
1109
|
+
record: null,
|
|
1110
|
+
payload: null
|
|
1111
|
+
};
|
|
1112
|
+
if (isOverlayRecord(value)) return {
|
|
1113
|
+
kind: Date.now() > value.fu ? "stale" : "fresh",
|
|
1114
|
+
record: value,
|
|
1115
|
+
payload: base64ToBytes(value.p)
|
|
1116
|
+
};
|
|
1117
|
+
return null;
|
|
1118
|
+
}
|
|
1119
|
+
/**
|
|
1120
|
+
* Resolve the effective TTL for a component's runtime lifetime.
|
|
1121
|
+
* Tag-only entries (no explicit ttl) get the ceiling TTL (design/45
|
|
1122
|
+
* §Tag-only entries carry a ceiling TTL).
|
|
1123
|
+
*/
|
|
1124
|
+
function effectiveTtl(ttl) {
|
|
1125
|
+
return ttl ?? CEILING_TTL_SECONDS;
|
|
1126
|
+
}
|
|
1127
|
+
/**
|
|
1128
|
+
* Store a component flight payload in the overlay.
|
|
1129
|
+
*/
|
|
1130
|
+
async function storeOverlayEntry(componentId, cacheKey, payloadBytes, opts) {
|
|
1131
|
+
const handler = getCacheHandler();
|
|
1132
|
+
const key = overlayKey(componentId, cacheKey);
|
|
1133
|
+
const logicalTtl = effectiveTtl(opts.ttl);
|
|
1134
|
+
const physicalTtl = opts.hasSeed ? DEPLOY_LONG_TTL_SECONDS : logicalTtl;
|
|
1135
|
+
const record = {
|
|
1136
|
+
_t: "co",
|
|
1137
|
+
p: bytesToBase64(payloadBytes),
|
|
1138
|
+
fu: Date.now() + logicalTtl * 1e3,
|
|
1139
|
+
s: opts.hasSeed
|
|
1140
|
+
};
|
|
1141
|
+
await handler.set(key, record, {
|
|
1142
|
+
ttl: physicalTtl,
|
|
1143
|
+
tags: opts.tags
|
|
1144
|
+
});
|
|
1145
|
+
}
|
|
1146
|
+
var tagIndex = null;
|
|
1147
|
+
/**
|
|
1148
|
+
* Initialize the tag index from the prebuilt manifest. Called once when the
|
|
1149
|
+
* manifest is loaded. Without a manifest (no prebuilt components), this is
|
|
1150
|
+
* never called and revalidateTag skips the tombstone path entirely.
|
|
1151
|
+
*/
|
|
1152
|
+
function initTagIndex(manifest) {
|
|
1153
|
+
tagIndex = buildTagIndex(manifest);
|
|
1154
|
+
emitIsrDiagnosticIfNeeded(manifest);
|
|
1155
|
+
}
|
|
1156
|
+
/**
|
|
1157
|
+
* Reset the tag index (for tests).
|
|
1158
|
+
* @internal
|
|
1159
|
+
*/
|
|
1160
|
+
function resetTagIndex() {
|
|
1161
|
+
tagIndex = null;
|
|
1162
|
+
}
|
|
1163
|
+
/**
|
|
1164
|
+
* Write tombstones for all seed entries carrying the given tag.
|
|
1165
|
+
* Called from cache.invalidate (cache-api.ts) AFTER the handler's own
|
|
1166
|
+
* invalidation clears overlay entries.
|
|
1167
|
+
*
|
|
1168
|
+
* The tombstone prevents the immutable seed from being served after
|
|
1169
|
+
* invalidation — without it, a handler.invalidate that clears the overlay
|
|
1170
|
+
* would expose the (now-stale) build artifact on the next request.
|
|
1171
|
+
*
|
|
1172
|
+
* Ensures the manifest is loaded first so cold-process actions that
|
|
1173
|
+
* invalidate before any page render still write tombstones.
|
|
1174
|
+
*/
|
|
1175
|
+
async function writeTombstonesForTag(tag) {
|
|
1176
|
+
if (!tagIndex) await ensureManifestLoaded();
|
|
1177
|
+
if (!tagIndex) return;
|
|
1178
|
+
const seeds = tagIndex.get(tag);
|
|
1179
|
+
if (!seeds || seeds.length === 0) return;
|
|
1180
|
+
const handler = getCacheHandler();
|
|
1181
|
+
const tombstone = { _t: "ct" };
|
|
1182
|
+
await Promise.all(seeds.map((seed) => {
|
|
1183
|
+
const key = overlayKey(seed.componentId, seed.cacheKey);
|
|
1184
|
+
return handler.set(key, tombstone, {
|
|
1185
|
+
ttl: DEPLOY_LONG_TTL_SECONDS,
|
|
1186
|
+
tags: [tag]
|
|
1187
|
+
});
|
|
1188
|
+
}));
|
|
1189
|
+
}
|
|
1190
|
+
var isrDiagnosticEmitted = false;
|
|
1191
|
+
function emitIsrDiagnosticIfNeeded(manifest) {
|
|
1192
|
+
if (isrDiagnosticEmitted) return;
|
|
1193
|
+
if (!(getCacheHandler() instanceof MemoryCacheHandler || !isCacheHandlerConfigured())) return;
|
|
1194
|
+
for (const [, component] of Object.entries(manifest)) {
|
|
1195
|
+
if (!component || typeof component !== "object" || !("entries" in component)) continue;
|
|
1196
|
+
for (const [, entry] of Object.entries(component.entries)) if (entry.tags && entry.tags.length > 0) {
|
|
1197
|
+
isrDiagnosticEmitted = true;
|
|
1198
|
+
console.warn("[timber] tag revalidation of prerendered components requires a shared cache handler in multi-instance deployments. The current MemoryCacheHandler is per-process — revalidateTag on one instance will not purge the build seed on others. Configure a shared handler (Redis, KV) for production ISR.");
|
|
1199
|
+
return;
|
|
1200
|
+
}
|
|
1201
|
+
}
|
|
1202
|
+
}
|
|
1203
|
+
function bytesToBase64(bytes) {
|
|
1204
|
+
return Buffer.from(bytes).toString("base64");
|
|
1205
|
+
}
|
|
1206
|
+
function base64ToBytes(b64) {
|
|
1207
|
+
return new Uint8Array(Buffer.from(b64, "base64"));
|
|
1208
|
+
}
|
|
1209
|
+
// src/cache/cache-api.ts
|
|
1210
|
+
var componentFallbackWarned = /* @__PURE__ */ new WeakSet();
|
|
1211
|
+
/**
|
|
1212
|
+
* Cache namespace — `cache.data`, `cache.component`, `cache.invalidate`.
|
|
1213
|
+
*
|
|
1214
|
+
* ```ts
|
|
1215
|
+
* import { cache } from '@timber-js/app/cache';
|
|
1216
|
+
*
|
|
1217
|
+
* const getUser = cache.data(
|
|
1218
|
+
* async (id: string) => db.users.findUnique({ where: { id } }),
|
|
1219
|
+
* { ttl: 60, tags: (id) => [`user:${id}`] }
|
|
1220
|
+
* );
|
|
1221
|
+
* ```
|
|
1222
|
+
*/
|
|
1223
|
+
var cache = {
|
|
1224
|
+
/**
|
|
1225
|
+
* Wrap an async function with cross-request caching.
|
|
1226
|
+
*
|
|
1227
|
+
* The configured cache handler (defaults to MemoryCacheHandler, overridable
|
|
1228
|
+
* via timber.config.ts) is re-resolved on every call, so module-scope
|
|
1229
|
+
* wrappers created before `setCacheHandler()` still pick up the configured
|
|
1230
|
+
* handler (TIM-1029).
|
|
1231
|
+
*/
|
|
1232
|
+
data(fn, opts, stableId) {
|
|
1233
|
+
return createCache(fn, opts, getCacheHandler, stableId);
|
|
1234
|
+
},
|
|
1235
|
+
/**
|
|
1236
|
+
* Invalidate cache entries by tag or key.
|
|
1237
|
+
*
|
|
1238
|
+
* ```ts
|
|
1239
|
+
* cache.invalidate({ tag: 'products' });
|
|
1240
|
+
* cache.invalidate({ key: 'user:abc' });
|
|
1241
|
+
* ```
|
|
1242
|
+
*/
|
|
1243
|
+
async invalidate(opts) {
|
|
1244
|
+
recordInvalidation(opts);
|
|
1245
|
+
await getCacheHandler().invalidate(opts.key === void 0 ? opts : {
|
|
1246
|
+
...opts,
|
|
1247
|
+
key: devDataCacheKey(opts.key)
|
|
1248
|
+
});
|
|
1249
|
+
if (opts.tag) {
|
|
1250
|
+
await writeTombstonesForTag(opts.tag);
|
|
1251
|
+
invalidateDevSeedsByTag(opts.tag);
|
|
1252
|
+
}
|
|
1253
|
+
if (opts.tag) {
|
|
1254
|
+
const purgeHandler = getCdnPurgeHandler();
|
|
1255
|
+
if (purgeHandler) try {
|
|
1256
|
+
await Promise.race([purgeHandler.purgeTags([opts.tag]), new Promise((_, reject) => setTimeout(() => reject(/* @__PURE__ */ new Error("CDN purge timed out (10s)")), 1e4))]);
|
|
1257
|
+
} catch (err) {
|
|
1258
|
+
console.error("[timber] CDN purge failed for tag:", err);
|
|
1259
|
+
}
|
|
1260
|
+
}
|
|
1261
|
+
},
|
|
1262
|
+
/**
|
|
1263
|
+
* Runtime fallback for `cache.component(...)` callsites the timber-prebuilt
|
|
1264
|
+
* transform does not rewrite — nested/computed/argument-position forms (see
|
|
1265
|
+
* plugins/prebuilt.ts). Only module-scope `const X = cache.component(...)`
|
|
1266
|
+
* declarations are transformed and eligible for prebuilding; everything else
|
|
1267
|
+
* lands here, warns once per component, and renders dynamically. Same
|
|
1268
|
+
* safety-net pattern as the data cache's runtime fnId fallback (TIM-1054):
|
|
1269
|
+
* an untraceable callsite degrades in performance, never in correctness.
|
|
1270
|
+
*/
|
|
1271
|
+
component(componentFn, _options) {
|
|
1272
|
+
if (!componentFallbackWarned.has(componentFn)) {
|
|
1273
|
+
componentFallbackWarned.add(componentFn);
|
|
1274
|
+
const name = componentFn.name || "anonymous component";
|
|
1275
|
+
console.warn(`[timber] cache.component: "${name}" was not transformed at build time — rendering dynamically. Only module-scope declarations (const X = cache.component(...)) are prebuilt.`);
|
|
1276
|
+
}
|
|
1277
|
+
return componentFn;
|
|
1278
|
+
}
|
|
1279
|
+
};
|
|
1280
|
+
export { getWaitUntil as _, storeOverlayEntry as a, lookupArtifactSeed as c, checkVersionSkew as d, MemoryCacheHandler as f, observeKeyDiscipline as g, setDefaultSingleflightTimeout as h, overlayKey as i, setPrebuiltPayloadSource as l, RedisCacheHandler as m, lookupOverlay as n, hasPrebuiltPayloadSource as o, TagAwareCacheHandler as p, mayStoreRerender as r, isParamIndependent as s, cache as t, applyReloadHeaders as u };
|
|
1281
|
+
|
|
1282
|
+
//# sourceMappingURL=cache-api-BZJNt01a.js.map
|