@timber-js/app 0.2.0-alpha.222 → 0.2.0-alpha.224
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/agent-skill.md +21 -5
- package/dist/_chunks/{actions-vBHr2vqd.js → actions-7dTXYJfu.js} +53 -24
- package/dist/_chunks/actions-7dTXYJfu.js.map +1 -0
- package/dist/_chunks/{als-registry-BZqHCtq-.js → als-registry-DpygwCp0.js} +2 -3
- package/dist/_chunks/{als-registry-BZqHCtq-.js.map → als-registry-DpygwCp0.js.map} +1 -1
- package/dist/_chunks/{als-slots-BEEIPKYm.js → als-slots-kbQrHTzm.js} +2 -3
- package/dist/_chunks/{als-slots-BEEIPKYm.js.map → als-slots-kbQrHTzm.js.map} +1 -1
- package/dist/_chunks/{base-path-DaQrzbez.js → base-path-DDIx0FXe.js} +2 -3
- package/dist/_chunks/{base-path-DaQrzbez.js.map → base-path-DDIx0FXe.js.map} +1 -1
- package/dist/_chunks/{build-manifest-DWppEdLB.js → build-manifest-Y4jl7nwU.js} +2 -3
- package/dist/_chunks/{build-manifest-DWppEdLB.js.map → build-manifest-Y4jl7nwU.js.map} +1 -1
- package/dist/_chunks/{build-output-helper-RV_BRcF1.js → build-output-helper-B7wWGTfR.js} +14 -10
- package/dist/_chunks/build-output-helper-B7wWGTfR.js.map +1 -0
- package/dist/_chunks/{cache-api-DdcDLpBj.js → cache-api-TDZ4hlDc.js} +190 -38
- package/dist/_chunks/cache-api-TDZ4hlDc.js.map +1 -0
- package/dist/_chunks/{canonicalize-BAWkWiKK.js → canonicalize-CqK135BN.js} +29 -4
- package/dist/_chunks/{canonicalize-BAWkWiKK.js.map → canonicalize-CqK135BN.js.map} +1 -1
- package/dist/_chunks/chains-CwOr3Myj.js +1 -0
- package/dist/_chunks/{chains-BchW_AtW.js → chains-Dgm3PrMe.js} +3 -4
- package/dist/_chunks/{chains-BchW_AtW.js.map → chains-Dgm3PrMe.js.map} +1 -1
- package/dist/_chunks/{classify-IqzMpxMs.js → classify--_kINHQV.js} +4 -5
- package/dist/_chunks/{classify-IqzMpxMs.js.map → classify--_kINHQV.js.map} +1 -1
- package/dist/_chunks/{cli-check-DQne_YhU.js → cli-check-Dv3f8d2j.js} +5 -6
- package/dist/_chunks/{cli-check-DQne_YhU.js.map → cli-check-Dv3f8d2j.js.map} +1 -1
- package/dist/_chunks/{cli-context-_mPttGGY.js → cli-context-CbZp32SK.js} +3 -4
- package/dist/_chunks/{cli-context-_mPttGGY.js.map → cli-context-CbZp32SK.js.map} +1 -1
- package/dist/_chunks/cli-context-n5hmkdla.js +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-BS-RFGE2.js → cli-schema-sync-DIPurq7X.js} +4 -5
- package/dist/_chunks/{cli-schema-sync-BS-RFGE2.js.map → cli-schema-sync-DIPurq7X.js.map} +1 -1
- package/dist/_chunks/{cli-schema-sync-v872sHms.js → cli-schema-sync-uq72EZmD.js} +1 -1
- package/dist/_chunks/{client-dep-entries-BJyP9SIu.js → client-dep-entries-CP7AkMCM.js} +4 -5
- package/dist/_chunks/{client-dep-entries-BJyP9SIu.js.map → client-dep-entries-CP7AkMCM.js.map} +1 -1
- package/dist/_chunks/{cloudflare-Byxl8FWP.js → cloudflare-B75X6u4O.js} +10 -13
- package/dist/_chunks/{cloudflare-Byxl8FWP.js.map → cloudflare-B75X6u4O.js.map} +1 -1
- package/dist/_chunks/{codec-registry-oOUxugz3.js → codec-registry-CPc6bjVl.js} +2 -3
- package/dist/_chunks/{codec-registry-oOUxugz3.js.map → codec-registry-CPc6bjVl.js.map} +1 -1
- package/dist/_chunks/{codegen-Bps1sLKJ.js → codegen-B9oWkWGf.js} +5 -8
- package/dist/_chunks/{codegen-Bps1sLKJ.js.map → codegen-B9oWkWGf.js.map} +1 -1
- package/dist/_chunks/{convention-lint-VwzrtjIt.js → convention-lint-hZwz5wd4.js} +8 -11
- package/dist/_chunks/{convention-lint-VwzrtjIt.js.map → convention-lint-hZwz5wd4.js.map} +1 -1
- package/dist/_chunks/dev-discovery-YnabkCKD.js +238 -0
- package/dist/_chunks/dev-discovery-YnabkCKD.js.map +1 -0
- package/dist/_chunks/{dev-server-BNr5drEO.js → dev-server-B7o4As0l.js} +383 -55
- package/dist/_chunks/dev-server-B7o4As0l.js.map +1 -0
- package/dist/_chunks/dev-server-hZzmbMvK.js +1 -0
- package/dist/_chunks/{dev-store-BOa304m_.js → dev-store-BvdqtHvK.js} +82 -38
- package/dist/_chunks/dev-store-BvdqtHvK.js.map +1 -0
- package/dist/_chunks/{dist-DtrJyBbw.js → dist-C1Rjlo6s.js} +3 -5
- package/dist/_chunks/{dist-DtrJyBbw.js.map → dist-C1Rjlo6s.js.map} +1 -1
- package/dist/_chunks/{error-boundary-Bc8QPZuq.js → error-boundary-DRQXGWCp.js} +20 -27
- package/dist/_chunks/{error-boundary-Bc8QPZuq.js.map → error-boundary-DRQXGWCp.js.map} +1 -1
- package/dist/_chunks/{fast-hash-C-tVYrLb.js → fast-hash-DddxkU5Y.js} +2 -3
- package/dist/_chunks/{fast-hash-C-tVYrLb.js.map → fast-hash-DddxkU5Y.js.map} +1 -1
- package/dist/_chunks/{flight-source-node-BdHUOUqg.js → flight-source-node-0Tp6evlz.js} +6 -8
- package/dist/_chunks/flight-source-node-0Tp6evlz.js.map +1 -0
- package/dist/_chunks/{format-BKclgVbk.js → format-DuPOoXUP.js} +2 -3
- package/dist/_chunks/{format-BKclgVbk.js.map → format-DuPOoXUP.js.map} +1 -1
- package/dist/_chunks/{fs-identity-BRKuL215.js → fs-identity-BmQ_Agg-.js} +3 -5
- package/dist/_chunks/{fs-identity-BRKuL215.js.map → fs-identity-BmQ_Agg-.js.map} +1 -1
- package/dist/_chunks/{global-context-B9PFncvb.js → global-context-DbxNWeBP.js} +2 -3
- package/dist/_chunks/{global-context-B9PFncvb.js.map → global-context-DbxNWeBP.js.map} +1 -1
- package/dist/_chunks/{graph-cache-CYiUS2aS.js → graph-cache-B1LAg4t7.js} +5 -89
- package/dist/_chunks/graph-cache-B1LAg4t7.js.map +1 -0
- package/dist/_chunks/{href-validation-BIrxavIy.js → href-validation-CEZy1V-k.js} +4 -7
- package/dist/_chunks/{href-validation-BIrxavIy.js.map → href-validation-CEZy1V-k.js.map} +1 -1
- package/dist/_chunks/{json-lossy-check-C3Sht92C.js → json-lossy-check-DVkLUlfC.js} +3 -4
- package/dist/_chunks/{json-lossy-check-C3Sht92C.js.map → json-lossy-check-DVkLUlfC.js.map} +1 -1
- package/dist/_chunks/{live-graph-DEu_GWbc.js → live-graph-BcVjQ1Te.js} +6 -7
- package/dist/_chunks/{live-graph-DEu_GWbc.js.map → live-graph-BcVjQ1Te.js.map} +1 -1
- package/dist/_chunks/{logger-CI_hThfy.js → logger-CWk44DLp.js} +89 -47
- package/dist/_chunks/logger-CWk44DLp.js.map +1 -0
- package/dist/_chunks/{metadata-routes-B3XJNyIH.js → metadata-routes-BL26HCDd.js} +2 -3
- package/dist/_chunks/{metadata-routes-B3XJNyIH.js.map → metadata-routes-BL26HCDd.js.map} +1 -1
- package/dist/_chunks/{navigation-root-BQfo1-kG.js → navigation-root-M3B2ZrdO.js} +6 -10
- package/dist/_chunks/{navigation-root-BQfo1-kG.js.map → navigation-root-M3B2ZrdO.js.map} +1 -1
- package/dist/_chunks/{node-response-bF0bKoig.js → node-response-B9aviPDa.js} +43 -9
- package/dist/_chunks/node-response-B9aviPDa.js.map +1 -0
- package/dist/_chunks/{param-value-C8TNYchQ.js → param-value-DqlGfF57.js} +2 -3
- package/dist/_chunks/{param-value-C8TNYchQ.js.map → param-value-DqlGfF57.js.map} +1 -1
- package/dist/_chunks/{plugin-context-uDHFqHHJ.js → plugin-context-BfSRKJfz.js} +1 -1
- package/dist/_chunks/{plugin-context-DxMMvjUt.js → plugin-context-FCkaNLUB.js} +4 -6
- package/dist/_chunks/plugin-context-FCkaNLUB.js.map +1 -0
- package/dist/_chunks/{poison-rules-DoEhbqaY.js → poison-rules-Bmz-lCPi.js} +2 -3
- package/dist/_chunks/{poison-rules-DoEhbqaY.js.map → poison-rules-Bmz-lCPi.js.map} +1 -1
- package/dist/_chunks/{poison-scan-DTWIfNgD.js → poison-scan-DJYxZc_7.js} +4 -5
- package/dist/_chunks/{poison-scan-DTWIfNgD.js.map → poison-scan-DJYxZc_7.js.map} +1 -1
- package/dist/_chunks/{purge-store-WZaxu-3m.js → purge-store-8BqLAYZ1.js} +2 -3
- package/dist/_chunks/{purge-store-WZaxu-3m.js.map → purge-store-8BqLAYZ1.js.map} +1 -1
- package/dist/_chunks/{render-timeout-Ln_u7fX-.js → render-timeout-MrrqD1wd.js} +2 -3
- package/dist/_chunks/{render-timeout-Ln_u7fX-.js.map → render-timeout-MrrqD1wd.js.map} +1 -1
- package/dist/_chunks/{resolve-schema-CkAInout.js → resolve-schema-B-aCuTu3.js} +3 -4
- package/dist/_chunks/{resolve-schema-CkAInout.js.map → resolve-schema-B-aCuTu3.js.map} +1 -1
- package/dist/_chunks/{rsc-cache-key-ClUiXQnK.js → rsc-cache-key-D0cb0Gmc.js} +2 -3
- package/dist/_chunks/{rsc-cache-key-ClUiXQnK.js.map → rsc-cache-key-D0cb0Gmc.js.map} +1 -1
- package/dist/_chunks/{rsc-media-type-DDc7duTD.js → rsc-media-type-m8jz9u6_.js} +2 -3
- package/dist/_chunks/{rsc-media-type-DDc7duTD.js.map → rsc-media-type-m8jz9u6_.js.map} +1 -1
- package/dist/_chunks/{rsc-payload-path-dffcs4jp.js → rsc-payload-path-EphpDB-J.js} +2 -3
- package/dist/_chunks/{rsc-payload-path-dffcs4jp.js.map → rsc-payload-path-EphpDB-J.js.map} +1 -1
- package/dist/_chunks/{scan-BoP17W3w.js → scan-CyizcBiX.js} +2 -3
- package/dist/_chunks/{scan-BoP17W3w.js.map → scan-CyizcBiX.js.map} +1 -1
- package/dist/_chunks/{scanner-C8fdKvKG.js → scanner-CJC-ScJU.js} +15 -23
- package/dist/_chunks/{scanner-C8fdKvKG.js.map → scanner-CJC-ScJU.js.map} +1 -1
- package/dist/_chunks/{schema-bridge-DpOmvZlI.js → schema-bridge-DyRs3cqy.js} +2 -3
- package/dist/_chunks/{schema-bridge-DpOmvZlI.js.map → schema-bridge-DyRs3cqy.js.map} +1 -1
- package/dist/_chunks/{segment-classify-C539Pa2O.js → segment-classify-Ho8jXWeC.js} +3 -5
- package/dist/_chunks/{segment-classify-C539Pa2O.js.map → segment-classify-Ho8jXWeC.js.map} +1 -1
- package/dist/_chunks/{segment-context-D3DNxKFq.js → segment-context-CYiGTi3K.js} +4 -6
- package/dist/_chunks/{segment-context-D3DNxKFq.js.map → segment-context-CYiGTi3K.js.map} +1 -1
- package/dist/_chunks/{segment-keys-D5hu1hz4.js → segment-keys-Y60KNc8C.js} +2 -3
- package/dist/_chunks/{segment-keys-D5hu1hz4.js.map → segment-keys-Y60KNc8C.js.map} +1 -1
- package/dist/_chunks/{singleflight-BeVMMKi0.js → singleflight-BChPMjwH.js} +2 -3
- package/dist/_chunks/{singleflight-BeVMMKi0.js.map → singleflight-BChPMjwH.js.map} +1 -1
- package/dist/_chunks/{sizeof-CO3dk0V1.js → sizeof-DG4W40lv.js} +3 -4
- package/dist/_chunks/{sizeof-CO3dk0V1.js.map → sizeof-DG4W40lv.js.map} +1 -1
- package/dist/_chunks/{ssr-data-nA3I70_n.js → ssr-data-9hPtcNOr.js} +3 -4
- package/dist/_chunks/{ssr-data-nA3I70_n.js.map → ssr-data-9hPtcNOr.js.map} +1 -1
- package/dist/_chunks/{state-BhNGPsdi.js → state-B-EBjeER.js} +2 -3
- package/dist/_chunks/{state-BhNGPsdi.js.map → state-B-EBjeER.js.map} +1 -1
- package/dist/_chunks/{status-page-marker-BRX9Ib-d.js → status-page-marker-XIQXlTOb.js} +8 -13
- package/dist/_chunks/{status-page-marker-BRX9Ib-d.js.map → status-page-marker-XIQXlTOb.js.map} +1 -1
- package/dist/_chunks/{tree-match-6yihorhk.js → tree-match-Bqdr9szG.js} +2 -3
- package/dist/_chunks/{tree-match-6yihorhk.js.map → tree-match-Bqdr9szG.js.map} +1 -1
- package/dist/_chunks/{use-query-states-I3JMng6J.js → use-query-states-pkDV-jSg.js} +4 -7
- package/dist/_chunks/{use-query-states-I3JMng6J.js.map → use-query-states-pkDV-jSg.js.map} +1 -1
- package/dist/_chunks/{walkers-BqzxnwGC.js → walkers-DIE203ir.js} +6 -8
- package/dist/_chunks/{walkers-BqzxnwGC.js.map → walkers-DIE203ir.js.map} +1 -1
- package/dist/_chunks/{write-file-atomic-D1qWqHb4.js → write-file-atomic-DW8m_Atv.js} +2 -3
- package/dist/_chunks/{write-file-atomic-D1qWqHb4.js.map → write-file-atomic-DW8m_Atv.js.map} +1 -1
- package/dist/adapters/build-output-helper.d.ts +10 -1
- package/dist/adapters/build-output-helper.d.ts.map +1 -1
- package/dist/adapters/cloudflare-dev.js +2 -3
- package/dist/adapters/cloudflare-kv-cache.js +3 -4
- package/dist/adapters/cloudflare.d.ts.map +1 -1
- package/dist/adapters/cloudflare.js +1 -1
- package/dist/adapters/nitro-presets.d.ts +6 -0
- package/dist/adapters/nitro-presets.d.ts.map +1 -1
- package/dist/adapters/nitro-preview.d.ts.map +1 -1
- package/dist/adapters/nitro.d.ts.map +1 -1
- package/dist/adapters/nitro.js +94 -57
- package/dist/adapters/nitro.js.map +1 -1
- package/dist/analyze/crawl-entry.js +7 -9
- package/dist/analyze/crawl-entry.js.map +1 -1
- package/dist/analyze/graph-command.d.ts.map +1 -1
- package/dist/analyze/graph-command.js +19 -105
- package/dist/analyze/graph-command.js.map +1 -1
- package/dist/cache/index.js +3 -3
- package/dist/cache/key-discipline.d.ts +61 -0
- package/dist/cache/key-discipline.d.ts.map +1 -0
- package/dist/cache/stores/cloudflare-kv.js +1 -2
- package/dist/cache/stores/memory.js +2 -3
- package/dist/cache/stores/redis.js +1 -2
- package/dist/cache/stores/vercel.js +1 -2
- package/dist/cache/timber-cache.d.ts +5 -1
- package/dist/cache/timber-cache.d.ts.map +1 -1
- package/dist/cdn/cloudflare-purge.js +1 -2
- package/dist/cdn/fastly-purge.js +1 -2
- package/dist/cdn/index.js +2 -3
- package/dist/cdn/workers-cache-purge.js +3 -5
- package/dist/cdn/workers-cache-purge.js.map +1 -1
- 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.d.ts +4 -12
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +27 -54
- package/dist/cli.js.map +1 -1
- package/dist/client/error-boundary.d.ts.map +1 -1
- package/dist/client/error-boundary.js +1 -1
- package/dist/client/index.js +22 -34
- package/dist/client/index.js.map +1 -1
- package/dist/client/internal.js +13 -18
- package/dist/client/internal.js.map +1 -1
- package/dist/client/use-cookie.d.ts +18 -5
- package/dist/client/use-cookie.d.ts.map +1 -1
- package/dist/codec.js +2 -3
- package/dist/config-types.d.ts +40 -5
- package/dist/config-types.d.ts.map +1 -1
- package/dist/config-validation.d.ts.map +1 -1
- package/dist/cookies/define-cookie.d.ts.map +1 -1
- package/dist/cookies/index.js +40 -67
- package/dist/cookies/index.js.map +1 -1
- package/dist/cookies/json-cookie.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +698 -237
- package/dist/index.js.map +1 -1
- package/dist/params/index.js +3 -4
- package/dist/plugin-context.d.ts +7 -0
- package/dist/plugin-context.d.ts.map +1 -1
- package/dist/plugins/dev-discovery.d.ts +69 -5
- package/dist/plugins/dev-discovery.d.ts.map +1 -1
- 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 +5 -1
- package/dist/plugins/dev-server.d.ts.map +1 -1
- package/dist/plugins/dev-store-clear.d.ts +59 -4
- package/dist/plugins/dev-store-clear.d.ts.map +1 -1
- package/dist/plugins/graph-endpoint.d.ts +4 -2
- package/dist/plugins/graph-endpoint.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 +113 -0
- package/dist/plugins/optimize-package-imports.d.ts.map +1 -0
- package/dist/plugins/prebuilt.d.ts.map +1 -1
- package/dist/routing/index.js +4 -4
- package/dist/rsc-runtime/rsc.d.ts +2 -1
- package/dist/rsc-runtime/rsc.d.ts.map +1 -1
- package/dist/rsc-runtime/server-references.d.ts +8 -0
- package/dist/rsc-runtime/server-references.d.ts.map +1 -0
- package/dist/search-params/index.js +5 -7
- package/dist/search-params/index.js.map +1 -1
- package/dist/server/access-gate.d.ts +12 -0
- package/dist/server/access-gate.d.ts.map +1 -1
- package/dist/server/canonicalize.d.ts +21 -0
- package/dist/server/canonicalize.d.ts.map +1 -1
- package/dist/server/cookie-context.d.ts +8 -1
- package/dist/server/cookie-context.d.ts.map +1 -1
- package/dist/server/flight-source-node.d.ts.map +1 -1
- package/dist/server/flight-source.d.ts.map +1 -1
- package/dist/server/index.d.ts +1 -1
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +8 -13
- package/dist/server/index.js.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.js +1061 -943
- package/dist/server/internal.js.map +1 -1
- package/dist/server/logger.d.ts +17 -0
- package/dist/server/logger.d.ts.map +1 -1
- package/dist/server/param-coercion.d.ts +8 -0
- package/dist/server/param-coercion.d.ts.map +1 -1
- package/dist/server/pipeline-interception.d.ts +34 -4
- 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 +3 -2
- package/dist/server/pipeline-metadata.d.ts.map +1 -1
- package/dist/server/pipeline-phases.d.ts +9 -3
- package/dist/server/pipeline-phases.d.ts.map +1 -1
- package/dist/server/pipeline.d.ts +18 -0
- package/dist/server/pipeline.d.ts.map +1 -1
- package/dist/server/prebuilt/dev-store.d.ts +68 -22
- package/dist/server/prebuilt/dev-store.d.ts.map +1 -1
- package/dist/server/prebuilt/overlay.d.ts +8 -0
- package/dist/server/prebuilt/overlay.d.ts.map +1 -1
- package/dist/server/prebuilt-runtime.d.ts.map +1 -1
- package/dist/server/primitives.d.ts +13 -0
- package/dist/server/primitives.d.ts.map +1 -1
- package/dist/server/render-utils.d.ts +21 -0
- package/dist/server/render-utils.d.ts.map +1 -1
- package/dist/server/request-context.d.ts +14 -0
- package/dist/server/request-context.d.ts.map +1 -1
- package/dist/server/route-element-builder.d.ts.map +1 -1
- package/dist/server/route-handler.d.ts +7 -0
- package/dist/server/route-handler.d.ts.map +1 -1
- package/dist/server/route-matcher.d.ts +14 -3
- package/dist/server/route-matcher.d.ts.map +1 -1
- package/dist/server/rsc-entry/api-handler.d.ts.map +1 -1
- package/dist/server/rsc-entry/index.d.ts.map +1 -1
- package/dist/server/rsc-entry/rsc-stream.d.ts.map +1 -1
- package/dist/server/signal-identity.d.ts +6 -0
- package/dist/server/signal-identity.d.ts.map +1 -1
- 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.map +1 -1
- package/dist/server/types.d.ts +5 -4
- package/dist/server/types.d.ts.map +1 -1
- package/dist/shims/font-google.js +1 -2
- package/dist/shims/font-local.js +1 -2
- package/dist/shims/headers.d.ts +11 -4
- package/dist/shims/headers.d.ts.map +1 -1
- package/docs/api/30-api-server.mdx +3 -1
- package/docs/api/32-api-cache.mdx +1 -1
- package/docs/api/34-api-config.mdx +42 -0
- package/docs/api/36-cli.mdx +72 -6
- package/docs/learn/01-quick-start.mdx +1 -1
- package/docs/learn/06-typed-params.mdx +2 -2
- package/docs/learn/10-caching.mdx +26 -5
- package/llms.txt +1 -1
- package/package.json +12 -12
- package/src/adapters/build-output-helper.ts +26 -4
- package/src/adapters/cloudflare.ts +1 -0
- package/src/adapters/nitro-presets.ts +15 -0
- package/src/adapters/nitro-preview.ts +66 -34
- package/src/adapters/nitro.ts +14 -6
- package/src/analyze/graph-command.ts +25 -133
- package/src/cache/key-discipline.ts +218 -0
- package/src/cache/timber-cache.ts +42 -5
- package/src/cli-dev-status.ts +196 -0
- package/src/cli-init.ts +278 -0
- package/src/cli.ts +33 -79
- package/src/client/error-boundary.tsx +19 -2
- package/src/client/use-cookie.ts +33 -21
- package/src/config-types.ts +40 -5
- package/src/config-validation.ts +37 -0
- package/src/cookies/define-cookie.ts +10 -46
- package/src/cookies/json-cookie.ts +4 -4
- package/src/index.ts +2 -0
- package/src/plugin-context.ts +7 -0
- package/src/plugins/dev-discovery.ts +216 -6
- package/src/plugins/dev-hostname.ts +322 -0
- package/src/plugins/dev-server.ts +96 -37
- package/src/plugins/dev-store-clear.ts +105 -7
- package/src/plugins/graph-endpoint.ts +15 -3
- package/src/plugins/optimize-package-imports-defaults.ts +88 -0
- package/src/plugins/optimize-package-imports.ts +439 -0
- package/src/plugins/prebuilt.ts +9 -0
- package/src/rsc-runtime/rsc.ts +7 -3
- package/src/rsc-runtime/server-references.ts +73 -0
- package/src/rsc-runtime/vendor-types.d.ts +9 -0
- package/src/server/access-gate.tsx +32 -20
- package/src/server/action-handler.ts +40 -34
- package/src/server/canonicalize.ts +27 -0
- package/src/server/cookie-context.ts +11 -3
- package/src/server/flight-source-node.ts +5 -2
- package/src/server/flight-source.ts +4 -3
- package/src/server/index.ts +6 -1
- package/src/server/interception-gates.ts +94 -0
- package/src/server/logger.ts +23 -0
- package/src/server/param-coercion.ts +22 -0
- package/src/server/pipeline-interception.ts +64 -4
- package/src/server/pipeline-metadata-route.ts +242 -0
- package/src/server/pipeline-metadata.ts +7 -5
- package/src/server/pipeline-phases.ts +71 -131
- package/src/server/pipeline.ts +20 -2
- package/src/server/prebuilt/dev-store.ts +113 -34
- package/src/server/prebuilt/overlay.ts +18 -0
- package/src/server/prebuilt-runtime.ts +43 -44
- package/src/server/primitives.ts +14 -0
- package/src/server/render-utils.ts +25 -0
- package/src/server/request-context.ts +27 -3
- package/src/server/route-element-builder.ts +15 -2
- package/src/server/route-handler.ts +3 -2
- package/src/server/route-matcher.ts +48 -33
- package/src/server/rsc-entry/api-handler.ts +2 -33
- package/src/server/rsc-entry/index.ts +8 -3
- package/src/server/rsc-entry/rsc-stream.ts +7 -1
- package/src/server/signal-identity.ts +30 -12
- package/src/server/traced-access.ts +50 -0
- package/src/server/tracing.ts +18 -1
- package/src/server/types.ts +5 -4
- package/src/shims/headers.ts +12 -4
- package/dist/_chunks/actions-vBHr2vqd.js.map +0 -1
- package/dist/_chunks/build-output-helper-RV_BRcF1.js.map +0 -1
- package/dist/_chunks/cache-api-DdcDLpBj.js.map +0 -1
- package/dist/_chunks/chains-B8TCLved.js +0 -1
- package/dist/_chunks/cli-context-BJQB6rtF.js +0 -1
- package/dist/_chunks/dev-server-BNr5drEO.js.map +0 -1
- package/dist/_chunks/dev-server-CUg7Mqh_.js +0 -1
- package/dist/_chunks/dev-store-BOa304m_.js.map +0 -1
- package/dist/_chunks/flight-source-node-BdHUOUqg.js.map +0 -1
- package/dist/_chunks/graph-cache-CYiUS2aS.js.map +0 -1
- package/dist/_chunks/logger-CI_hThfy.js.map +0 -1
- package/dist/_chunks/node-response-bF0bKoig.js.map +0 -1
- package/dist/_chunks/plugin-context-DxMMvjUt.js.map +0 -1
- package/dist/server/prebuilt/key-discipline.d.ts +0 -52
- package/dist/server/prebuilt/key-discipline.d.ts.map +0 -1
- package/src/server/prebuilt/key-discipline.ts +0 -122
|
@@ -16,6 +16,9 @@ import { isRscRequest } from '../shared/rsc-media-type.ts';
|
|
|
16
16
|
import { canonicalize } from './canonicalize.ts';
|
|
17
17
|
import { parseClientStateTree } from './state-tree-diff.ts';
|
|
18
18
|
import type { InterceptionContext, PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
19
|
+
import type { MiddlewareFn } from './middleware-runner.ts';
|
|
20
|
+
import { collectMiddlewareChain, matchedSegmentPath } from './route-matcher.ts';
|
|
21
|
+
import { runWithSegmentParams } from './request-context.ts';
|
|
19
22
|
|
|
20
23
|
/**
|
|
21
24
|
* Check if an intercepting route applies for this soft navigation.
|
|
@@ -158,6 +161,24 @@ export function pathnameMatchesPattern(pathname: string, pattern: string): boole
|
|
|
158
161
|
|
|
159
162
|
// ─── Pipeline Resolution ──────────────────────────────────────────────────
|
|
160
163
|
|
|
164
|
+
/**
|
|
165
|
+
* Which route renders a request, and — when an interception replaced it —
|
|
166
|
+
* which route authorizes it.
|
|
167
|
+
*/
|
|
168
|
+
export interface ResolvedRoute {
|
|
169
|
+
/** The route that renders: the canonical match unless a rewrite applied. */
|
|
170
|
+
match: RouteMatch | null;
|
|
171
|
+
/** Set for the modal shape only; see the `'children'` branch below. */
|
|
172
|
+
interception?: InterceptionContext;
|
|
173
|
+
/**
|
|
174
|
+
* The URL's own route, set whenever an interception replaced it — in
|
|
175
|
+
* either shape. Its middleware and access chain authorize the response:
|
|
176
|
+
* the rendered chain is a different route, and nothing on it was written
|
|
177
|
+
* to protect this URL (TIM-1607).
|
|
178
|
+
*/
|
|
179
|
+
canonical?: RouteMatch;
|
|
180
|
+
}
|
|
181
|
+
|
|
161
182
|
/**
|
|
162
183
|
* Resolve which route renders a soft navigation that an intercepting route
|
|
163
184
|
* may claim. Returns the canonical match unchanged when no rewrite applies.
|
|
@@ -169,12 +190,13 @@ export function resolveInterceptedRoute(
|
|
|
169
190
|
req: Request,
|
|
170
191
|
canonicalPathname: string,
|
|
171
192
|
canonicalMatch: RouteMatch | null
|
|
172
|
-
):
|
|
193
|
+
): ResolvedRoute {
|
|
173
194
|
const stripTrailingSlash = config.stripTrailingSlash ?? true;
|
|
174
195
|
let match = canonicalMatch;
|
|
175
196
|
let interception: InterceptionContext | undefined;
|
|
176
197
|
|
|
177
198
|
// Stage 2a: Intercepting route resolution (modal pattern).
|
|
199
|
+
|
|
178
200
|
// Only honored on RSC client-navigation requests (Accept: text/x-component)
|
|
179
201
|
// to prevent spoofing from plain HTML navigations or raw HTTP clients.
|
|
180
202
|
// The header value must be a valid relative pathname — reject schemes,
|
|
@@ -201,8 +223,14 @@ export function resolveInterceptedRoute(
|
|
|
201
223
|
//
|
|
202
224
|
// Neither is trusted: both are client-supplied, and satisfying the scope
|
|
203
225
|
// only selects which build-time rewrite applies. The rendered pathname is
|
|
204
|
-
// always the rewrite's own `interceptingPrefix`, the server re-derives
|
|
205
|
-
// rendered chain from it below
|
|
226
|
+
// always the rewrite's own `interceptingPrefix`, and the server re-derives
|
|
227
|
+
// the rendered chain from it below. Choosing the rendered chain is not
|
|
228
|
+
// authorization, though: an interception renders a different route than
|
|
229
|
+
// the URL names, so the URL's own middleware and access.ts files still
|
|
230
|
+
// run — the middleware before render, the access files as gates in the
|
|
231
|
+
// intercepted tree, both through `canonical` returned below (TIM-1607).
|
|
232
|
+
// Only that makes a forged header harmless: the rendered chain's
|
|
233
|
+
// access.ts files were written to protect the source page, not the target.
|
|
206
234
|
//
|
|
207
235
|
// They are handed over as two sets in that order rather than one union:
|
|
208
236
|
// each describes a single rendered chain, and only within one chain does
|
|
@@ -261,7 +289,28 @@ export function resolveInterceptedRoute(
|
|
|
261
289
|
}
|
|
262
290
|
}
|
|
263
291
|
|
|
264
|
-
|
|
292
|
+
// No canonical route — an interception with no page at its URL — leaves
|
|
293
|
+
// nothing to authorize against; the rendered chain's gates are all there
|
|
294
|
+
// are. See design/07 §"Authorization".
|
|
295
|
+
if (match === canonicalMatch || !canonicalMatch) return { match, interception };
|
|
296
|
+
return { match, interception, canonical: canonicalMatch };
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* The middleware an intercepted navigation runs: the URL's chain, then each
|
|
301
|
+
* middleware.ts only the rendered chain has. Shared ancestors are the same
|
|
302
|
+
* manifest nodes on both chains, so each file runs once, and each chain keeps
|
|
303
|
+
* its own root-to-leaf order (TIM-1607).
|
|
304
|
+
*/
|
|
305
|
+
export function interceptedMiddlewareChain(
|
|
306
|
+
canonical: RouteMatch,
|
|
307
|
+
rendered: RouteMatch
|
|
308
|
+
): MiddlewareFn[] {
|
|
309
|
+
const onCanonical = new Set(canonical.segments);
|
|
310
|
+
return collectMiddlewareChain([
|
|
311
|
+
...canonical.segments,
|
|
312
|
+
...rendered.segments.filter((segment) => !onCanonical.has(segment)),
|
|
313
|
+
]);
|
|
265
314
|
}
|
|
266
315
|
|
|
267
316
|
/**
|
|
@@ -283,3 +332,14 @@ function validateInterceptionHeader(raw: string, stripTrailingSlash: boolean): s
|
|
|
283
332
|
if (!result.ok) return null;
|
|
284
333
|
return result.pathname;
|
|
285
334
|
}
|
|
335
|
+
|
|
336
|
+
/**
|
|
337
|
+
* Run `fn` with a route's own params as what `getSegmentParams()` returns.
|
|
338
|
+
*
|
|
339
|
+
* An intercepted request publishes the rendered route's params. The URL's
|
|
340
|
+
* middleware and access.ts were written for the URL's route, and run under
|
|
341
|
+
* this so they read its params (TIM-1607).
|
|
342
|
+
*/
|
|
343
|
+
export function runWithRouteParams<T>(route: RouteMatch, fn: () => T): T {
|
|
344
|
+
return runWithSegmentParams(matchedSegmentPath(route.segments), route.segmentParams, fn);
|
|
345
|
+
}
|
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Stage 1b of the request pipeline: serving a matched metadata route
|
|
3
|
+
* (sitemap, robots, manifest, favicon, icon, apple-icon, opengraph-image).
|
|
4
|
+
*
|
|
5
|
+
* A metadata route runs the per-segment stages a page at its segment runs,
|
|
6
|
+
* in the same order: param coercion through `app/schema.ts`, then the
|
|
7
|
+
* `middleware.ts` chain, then the `access.ts` chain — then the file or
|
|
8
|
+
* handler. Files owned by the root segment are the one exception: they are
|
|
9
|
+
* the app's public crawler surface (`/robots.txt`, `/sitemap.xml`, the app
|
|
10
|
+
* icons), so no gate runs for them, not even a root `access.ts` that gates
|
|
11
|
+
* every page. A file anywhere below the root, a route group included, sits
|
|
12
|
+
* in its segments' authorization scope like any page there (TIM-1609).
|
|
13
|
+
*
|
|
14
|
+
* Signals answer with a bare status, never a deny page: a metadata route is
|
|
15
|
+
* an image, a sitemap or a text file, not a document.
|
|
16
|
+
*
|
|
17
|
+
* See design/16-metadata.md §"Pipeline Integration",
|
|
18
|
+
* design/13-security.md threat 11b.
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
import {
|
|
22
|
+
applyCookieJar,
|
|
23
|
+
buildRedirectResponse,
|
|
24
|
+
cloneWithMutableHeaders,
|
|
25
|
+
dynamicResponseHeaders,
|
|
26
|
+
fireOnRequestError,
|
|
27
|
+
} from './pipeline-helpers.ts';
|
|
28
|
+
import { errorResponseHeaders } from './error-response-headers.ts';
|
|
29
|
+
import { outcomeToResponse } from './pipeline-outcome.ts';
|
|
30
|
+
import { runMiddlewarePhase } from './pipeline-phases.ts';
|
|
31
|
+
import {
|
|
32
|
+
METADATA_CACHE_CONTROL,
|
|
33
|
+
serveStaticMetadataFile,
|
|
34
|
+
serializeSitemap,
|
|
35
|
+
} from './pipeline-metadata.ts';
|
|
36
|
+
import {
|
|
37
|
+
coerceSegmentParams,
|
|
38
|
+
ParamCoercionError,
|
|
39
|
+
warnParamCoercionFailure,
|
|
40
|
+
} from './param-coercion.ts';
|
|
41
|
+
import { setMatchedSegmentPath, setSegmentParams } from './request-context.ts';
|
|
42
|
+
import {
|
|
43
|
+
collectMiddlewareChain,
|
|
44
|
+
matchedSegmentPath,
|
|
45
|
+
type MetadataRouteMatch,
|
|
46
|
+
} from './route-matcher.ts';
|
|
47
|
+
import { mergeResponseHeaders } from './route-handler.ts';
|
|
48
|
+
import { runAccessChain } from './traced-access.ts';
|
|
49
|
+
import { loadModule } from './safe-load.ts';
|
|
50
|
+
import { isDenySignal, isRedirectSignal } from './signal-identity.ts';
|
|
51
|
+
import { logRenderError, logRouteSetupError } from './logger.ts';
|
|
52
|
+
import { isDebug } from './debug.ts';
|
|
53
|
+
import { resolveRenderTimeoutMs } from './render-timeout.ts';
|
|
54
|
+
import { concatBytes, drainWithDeadline } from './stream-utils.ts';
|
|
55
|
+
import { onAbortUntil } from './abort-scope.ts';
|
|
56
|
+
import type { PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
57
|
+
import type { MetadataHandler, MetadataRoute } from './types.ts';
|
|
58
|
+
|
|
59
|
+
/** Answer a request whose canonical pathname matched a metadata route. */
|
|
60
|
+
export async function serveMetadataRoute(
|
|
61
|
+
config: PipelineConfig,
|
|
62
|
+
req: Request,
|
|
63
|
+
method: string,
|
|
64
|
+
path: string,
|
|
65
|
+
pathname: string,
|
|
66
|
+
metaMatch: MetadataRouteMatch
|
|
67
|
+
): Promise<Response> {
|
|
68
|
+
const { segments } = metaMatch;
|
|
69
|
+
const middlewareChain = segments.length > 1 ? collectMiddlewareChain(segments) : [];
|
|
70
|
+
// Root-owned files run no gate. A deeper file is gated when its chain —
|
|
71
|
+
// root segment included — has something to run; with nothing there, it
|
|
72
|
+
// answers like a root file.
|
|
73
|
+
const gated =
|
|
74
|
+
segments.length > 1 && (middlewareChain.length > 0 || segments.some((s) => s.access));
|
|
75
|
+
const route: RouteMatch = {
|
|
76
|
+
segments,
|
|
77
|
+
segmentParams: metaMatch.segmentParams,
|
|
78
|
+
rawSegmentParams: metaMatch.segmentParams,
|
|
79
|
+
middlewareChain,
|
|
80
|
+
};
|
|
81
|
+
|
|
82
|
+
// A gated answer depends on who asked, so it starts from the page cache
|
|
83
|
+
// policy, which middleware (or a handler's own Cache-Control) may
|
|
84
|
+
// override. Under the public policy a shared cache would hand it to the
|
|
85
|
+
// next visitor without running the gates.
|
|
86
|
+
const responseHeaders = gated ? dynamicResponseHeaders() : undefined;
|
|
87
|
+
// The jar goes onto the bag once, on the way out — a middleware
|
|
88
|
+
// short-circuit or error goes through `outcomeToResponse`, which applies it.
|
|
89
|
+
const finish = (response: Response): Response => {
|
|
90
|
+
if (!responseHeaders) return cloneWithMutableHeaders(response);
|
|
91
|
+
applyCookieJar(responseHeaders);
|
|
92
|
+
return mergeResponseHeaders(response, responseHeaders);
|
|
93
|
+
};
|
|
94
|
+
const fail = async (error: unknown, phase: 'setup' | 'route'): Promise<Response> => {
|
|
95
|
+
if (phase === 'setup') logRouteSetupError({ method, path, error });
|
|
96
|
+
else logRenderError({ method, path, error });
|
|
97
|
+
await fireOnRequestError(error, req, phase, segments);
|
|
98
|
+
if (config.onPipelineError && error instanceof Error)
|
|
99
|
+
config.onPipelineError(error, 'metadata-route');
|
|
100
|
+
if (responseHeaders) applyCookieJar(responseHeaders);
|
|
101
|
+
// An error answer must not inherit the success policy or validators.
|
|
102
|
+
return new Response(null, { status: 500, headers: errorResponseHeaders(responseHeaders) });
|
|
103
|
+
};
|
|
104
|
+
|
|
105
|
+
// Setup: the same coercion, and the same failure split, as Stage 2c.
|
|
106
|
+
try {
|
|
107
|
+
route.segmentParams = await coerceSegmentParams(route);
|
|
108
|
+
} catch (error) {
|
|
109
|
+
if (!(error instanceof ParamCoercionError)) return fail(error, 'setup');
|
|
110
|
+
warnParamCoercionFailure(method, pathname, segments, error);
|
|
111
|
+
return new Response(null, { status: 404 });
|
|
112
|
+
}
|
|
113
|
+
setSegmentParams(route.segmentParams);
|
|
114
|
+
setMatchedSegmentPath(matchedSegmentPath(segments));
|
|
115
|
+
|
|
116
|
+
try {
|
|
117
|
+
if (responseHeaders && middlewareChain.length > 0) {
|
|
118
|
+
const stopped = await runMiddlewarePhase(config, req, route, responseHeaders);
|
|
119
|
+
if (stopped?.kind === 'redirect' || stopped?.kind === 'deny') throw stopped.signal;
|
|
120
|
+
if (stopped)
|
|
121
|
+
return await outcomeToResponse(config, stopped, { req, method, path, responseHeaders });
|
|
122
|
+
}
|
|
123
|
+
if (gated) await runAccessChain(segments);
|
|
124
|
+
|
|
125
|
+
const cacheControl = gated ? undefined : METADATA_CACHE_CONTROL;
|
|
126
|
+
if (metaMatch.isStatic) return finish(await serveStaticMetadataFile(metaMatch, cacheControl));
|
|
127
|
+
const response = await runMetadataHandler(metaMatch, cacheControl);
|
|
128
|
+
// An image is read to the end before it is answered, so a render that
|
|
129
|
+
// fails is a 500 (bufferResponse). Not for HEAD, whose body the
|
|
130
|
+
// pipeline discards unread: a link-preview probe must not render the
|
|
131
|
+
// image. Not for sitemap, robots or manifest: a handler's Response
|
|
132
|
+
// there can be a large stream and keeps streaming.
|
|
133
|
+
if (method === 'HEAD' || !metaMatch.contentType.startsWith('image/')) return finish(response);
|
|
134
|
+
const timeoutMs = resolveRenderTimeoutMs(config.renderTimeoutMs);
|
|
135
|
+
return finish(await bufferResponse(response, timeoutMs, req.signal));
|
|
136
|
+
} catch (error) {
|
|
137
|
+
// Control-flow signals — from a gate, or from the handler (a sitemap
|
|
138
|
+
// that calls deny(404) for an unknown tenant, a dynamic icon that
|
|
139
|
+
// redirects to a CDN-hosted asset) — answer with a bare status. A
|
|
140
|
+
// metadata route is not a navigation, so a redirect is always a real 3xx.
|
|
141
|
+
if (isRedirectSignal(error)) return finish(buildRedirectResponse(error, new Headers(), false));
|
|
142
|
+
if (isDenySignal(error)) return finish(new Response(null, { status: error.status }));
|
|
143
|
+
return fail(error, 'route');
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Call a dynamic metadata route's default export and turn its result into a
|
|
149
|
+
* Response. `cacheControl` is set on a result the framework serializes; a
|
|
150
|
+
* Response the handler returns gets no framework default (a gated route then
|
|
151
|
+
* merges its middleware headers and page policy under the handler's own).
|
|
152
|
+
*/
|
|
153
|
+
async function runMetadataHandler(
|
|
154
|
+
metaMatch: MetadataRouteMatch,
|
|
155
|
+
cacheControl: string | undefined
|
|
156
|
+
): Promise<Response> {
|
|
157
|
+
const mod = await loadModule<{ default?: MetadataHandler }>(metaMatch.file);
|
|
158
|
+
if (typeof mod.default !== 'function') {
|
|
159
|
+
if (isDebug()) {
|
|
160
|
+
console.warn(
|
|
161
|
+
`[timber] Metadata route ${metaMatch.file} does not export a default function — responding with 500\n` +
|
|
162
|
+
` Metadata routes must export a default function that returns the metadata content.`
|
|
163
|
+
);
|
|
164
|
+
}
|
|
165
|
+
return new Response('Metadata route must export a default function', { status: 500 });
|
|
166
|
+
}
|
|
167
|
+
const handlerResult = await mod.default();
|
|
168
|
+
// No default Cache-Control on a returned Response: the handler runs in
|
|
169
|
+
// the request context and may vary on cookies or headers, so a public
|
|
170
|
+
// default could serve one user's response to another (#1064).
|
|
171
|
+
if (handlerResult instanceof Response) return handlerResult;
|
|
172
|
+
// Otherwise, serialize based on content type. The type discriminator
|
|
173
|
+
// here is the metadata route's declared content type (from the file
|
|
174
|
+
// convention), not the shape of `handlerResult` — TS can't narrow the
|
|
175
|
+
// `MetadataResult` union on that, so we assert against the expected
|
|
176
|
+
// shape at each branch.
|
|
177
|
+
const contentType = metaMatch.contentType;
|
|
178
|
+
let body: string;
|
|
179
|
+
if (typeof handlerResult === 'string') {
|
|
180
|
+
body = handlerResult;
|
|
181
|
+
} else if (contentType === 'application/xml') {
|
|
182
|
+
body = serializeSitemap(handlerResult as MetadataRoute.Sitemap);
|
|
183
|
+
} else if (contentType === 'application/manifest+json') {
|
|
184
|
+
body = JSON.stringify(handlerResult, null, 2);
|
|
185
|
+
} else {
|
|
186
|
+
body = String(handlerResult);
|
|
187
|
+
}
|
|
188
|
+
const headers = new Headers({ 'Content-Type': `${contentType}; charset=utf-8` });
|
|
189
|
+
if (cacheControl) headers.set('Cache-Control', cacheControl);
|
|
190
|
+
return new Response(body, { status: 200, headers });
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Read an image route's Response body to the end, under `renderTimeoutMs`
|
|
195
|
+
* and until the client leaves, and answer with the bytes and their
|
|
196
|
+
* Content-Length.
|
|
197
|
+
*
|
|
198
|
+
* An `ImageResponse` renders lazily: the handler returns at once and the
|
|
199
|
+
* image fails, if it fails, on the body's first read. Passed through, that
|
|
200
|
+
* read happens after the status is committed, and the Web→Node bridge
|
|
201
|
+
* (srvx's `sendNodeResponse`) destroys the socket before any byte is
|
|
202
|
+
* written — an empty reply with no status line (TIM-1602). Read here, the
|
|
203
|
+
* failure throws inside `serveMetadataRoute`'s catch and answers 500.
|
|
204
|
+
* Icons and social cards are small, bounded assets, so holding one is
|
|
205
|
+
* cheap; a route.ts body is never buffered.
|
|
206
|
+
*/
|
|
207
|
+
async function bufferResponse(
|
|
208
|
+
response: Response,
|
|
209
|
+
timeoutMs: number,
|
|
210
|
+
signal: AbortSignal
|
|
211
|
+
): Promise<Response> {
|
|
212
|
+
if (!response.body) return response;
|
|
213
|
+
const reader = response.body.getReader();
|
|
214
|
+
// A client that leaves ends the read, as the bridge's close handler
|
|
215
|
+
// ended it when the body streamed. The listener lasts as long as the read.
|
|
216
|
+
const readDone = new AbortController();
|
|
217
|
+
const clientLeft = new Promise<never>((_, reject) => {
|
|
218
|
+
onAbortUntil(signal, () => reject(signal.reason), readDone.signal);
|
|
219
|
+
});
|
|
220
|
+
clientLeft.catch(() => {});
|
|
221
|
+
let chunks: Uint8Array[];
|
|
222
|
+
try {
|
|
223
|
+
chunks = await drainWithDeadline(
|
|
224
|
+
{
|
|
225
|
+
read: () => Promise.race([reader.read(), clientLeft]),
|
|
226
|
+
cancel: (reason) => void reader.cancel(reason).catch(() => {}),
|
|
227
|
+
},
|
|
228
|
+
timeoutMs,
|
|
229
|
+
'Metadata route body'
|
|
230
|
+
);
|
|
231
|
+
} finally {
|
|
232
|
+
readDone.abort();
|
|
233
|
+
}
|
|
234
|
+
const bytes = concatBytes(chunks);
|
|
235
|
+
const headers = new Headers(response.headers);
|
|
236
|
+
headers.set('Content-Length', String(bytes.byteLength));
|
|
237
|
+
return new Response(bytes, {
|
|
238
|
+
status: response.status,
|
|
239
|
+
statusText: response.statusText,
|
|
240
|
+
headers,
|
|
241
|
+
});
|
|
242
|
+
}
|
|
@@ -36,23 +36,25 @@ const TEXT_CONTENT_TYPES = new Set([
|
|
|
36
36
|
*
|
|
37
37
|
* Static metadata route files (.xml, .txt, .json, .png, .ico, .svg, etc.)
|
|
38
38
|
* are served as-is with the appropriate Content-Type header.
|
|
39
|
-
* Text files include charset=utf-8; binary files do not.
|
|
39
|
+
* Text files include charset=utf-8; binary files do not. `cacheControl` is
|
|
40
|
+
* omitted for a file behind gates, whose answer depends on who asked.
|
|
40
41
|
*
|
|
41
42
|
* See design/16-metadata.md §"Metadata Routes"
|
|
42
43
|
*/
|
|
43
44
|
export async function serveStaticMetadataFile(
|
|
44
|
-
metaMatch: import('./route-matcher.ts').MetadataRouteMatch
|
|
45
|
+
metaMatch: import('./route-matcher.ts').MetadataRouteMatch,
|
|
46
|
+
cacheControl: string | undefined
|
|
45
47
|
): Promise<Response> {
|
|
46
48
|
const { contentType, file } = metaMatch;
|
|
47
49
|
const isText = TEXT_CONTENT_TYPES.has(contentType);
|
|
48
50
|
|
|
49
51
|
const body = await readFile(file.filePath);
|
|
50
52
|
|
|
51
|
-
const headers
|
|
53
|
+
const headers = new Headers({
|
|
52
54
|
'Content-Type': isText ? `${contentType}; charset=utf-8` : contentType,
|
|
53
55
|
'Content-Length': String(body.byteLength),
|
|
54
|
-
|
|
55
|
-
|
|
56
|
+
});
|
|
57
|
+
if (cacheControl) headers.set('Cache-Control', cacheControl);
|
|
56
58
|
|
|
57
59
|
return new Response(body, { status: 200, headers });
|
|
58
60
|
}
|
|
@@ -26,16 +26,14 @@ import { withSpan } from './tracing.ts';
|
|
|
26
26
|
import { requestCspNonce } from './csp-nonce.ts';
|
|
27
27
|
import { logRenderError } from './logger.ts';
|
|
28
28
|
import { isDenySignal, isRedirectSignal } from './signal-identity.ts';
|
|
29
|
-
import { ParamCoercionError } from './param-coercion.ts';
|
|
30
29
|
import { checkVersionSkew, applyReloadHeaders } from './version-skew.ts';
|
|
30
|
+
import { serveMetadataRoute } from './pipeline-metadata-route.ts';
|
|
31
31
|
import {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
} from './pipeline-
|
|
36
|
-
import {
|
|
37
|
-
import { resolveInterceptedRoute } from './pipeline-interception.ts';
|
|
38
|
-
import { isApiRouteChain } from './route-matcher.ts';
|
|
32
|
+
interceptedMiddlewareChain,
|
|
33
|
+
resolveInterceptedRoute,
|
|
34
|
+
runWithRouteParams,
|
|
35
|
+
} from './pipeline-interception.ts';
|
|
36
|
+
import { isApiRouteChain, matchedSegmentPath } from './route-matcher.ts';
|
|
39
37
|
import {
|
|
40
38
|
applyCookieJar,
|
|
41
39
|
cloneWithMutableHeaders,
|
|
@@ -43,7 +41,11 @@ import {
|
|
|
43
41
|
fireOnRequestError,
|
|
44
42
|
type ProxyResolver,
|
|
45
43
|
} from './pipeline-helpers.ts';
|
|
46
|
-
import {
|
|
44
|
+
import {
|
|
45
|
+
coerceSegmentParams,
|
|
46
|
+
ParamCoercionError,
|
|
47
|
+
warnParamCoercionFailure,
|
|
48
|
+
} from './param-coercion.ts';
|
|
47
49
|
import { outcomeToResponse, thrownOutcome, type PhaseOutcome } from './pipeline-outcome.ts';
|
|
48
50
|
import type { InterceptionContext, PipelineConfig, RouteMatch } from './pipeline.ts';
|
|
49
51
|
import type { MetadataHandler, MetadataRoute, MiddlewareContext } from './types.ts';
|
|
@@ -93,23 +95,29 @@ export async function runProxyPhase(
|
|
|
93
95
|
|
|
94
96
|
/**
|
|
95
97
|
* Run the middleware chain phase. If the chain short-circuits with a Response,
|
|
96
|
-
* returns it as a 'response' outcome
|
|
97
|
-
* overlay and
|
|
98
|
+
* returns it as a 'response' outcome, and a thrown signal or error as its
|
|
99
|
+
* outcome. Otherwise applies the request header overlay and returns null: the
|
|
100
|
+
* request continues to the render phase.
|
|
101
|
+
*
|
|
102
|
+
* The chain is the URL's. On an intercepted navigation that is
|
|
103
|
+
* `match.canonical`'s, not the rendered route's: the URL's middleware
|
|
104
|
+
* followed by any only the rendered chain has, run with the URL's params
|
|
105
|
+
* (TIM-1607).
|
|
98
106
|
*/
|
|
99
107
|
export async function runMiddlewarePhase(
|
|
100
108
|
config: PipelineConfig,
|
|
101
109
|
req: Request,
|
|
102
110
|
match: RouteMatch,
|
|
103
|
-
responseHeaders: Headers
|
|
104
|
-
|
|
105
|
-
|
|
111
|
+
responseHeaders: Headers
|
|
112
|
+
): Promise<PhaseOutcome | null> {
|
|
113
|
+
const route = match.canonical ?? match;
|
|
106
114
|
const detailed = config.serverTiming === 'detailed';
|
|
107
115
|
const requestHeaderOverlay = new Headers();
|
|
108
116
|
const ctx: MiddlewareContext = {
|
|
109
117
|
req,
|
|
110
118
|
requestHeaders: requestHeaderOverlay,
|
|
111
119
|
headers: responseHeaders,
|
|
112
|
-
segmentParams:
|
|
120
|
+
segmentParams: route.segmentParams,
|
|
113
121
|
// Lazy: reading it is the opt-in that makes the render nonce its scripts.
|
|
114
122
|
get nonce() {
|
|
115
123
|
return requestCspNonce();
|
|
@@ -133,7 +141,8 @@ export async function runMiddlewarePhase(
|
|
|
133
141
|
};
|
|
134
142
|
|
|
135
143
|
try {
|
|
136
|
-
const
|
|
144
|
+
const runChain = () => runMiddlewareChain(route.middlewareChain, ctx);
|
|
145
|
+
const chainFn = match.canonical ? () => runWithRouteParams(route, runChain) : runChain;
|
|
137
146
|
// Enable cookie mutation during middleware (design/29-cookies.md §"Context Tracking")
|
|
138
147
|
const middlewareResponse = await (async () => {
|
|
139
148
|
setMutableCookieContext(true);
|
|
@@ -151,8 +160,7 @@ export async function runMiddlewarePhase(
|
|
|
151
160
|
// Middleware chain completed without short-circuiting — apply any
|
|
152
161
|
// injected request headers so getHeaders() returns them downstream.
|
|
153
162
|
applyRequestHeaderOverlay(requestHeaderOverlay);
|
|
154
|
-
|
|
155
|
-
return runRenderPhase(config, req, match, responseHeaders, renderContext);
|
|
163
|
+
return null;
|
|
156
164
|
} catch (error) {
|
|
157
165
|
return thrownOutcome('middleware', error);
|
|
158
166
|
}
|
|
@@ -247,84 +255,12 @@ export async function handleRequest(
|
|
|
247
255
|
}
|
|
248
256
|
|
|
249
257
|
// Stage 1b: Metadata route matching — runs before regular route matching.
|
|
250
|
-
//
|
|
258
|
+
// Files below the root run their segments' coercion, middleware.ts and
|
|
259
|
+
// access.ts; root files are the public crawler surface and skip them.
|
|
251
260
|
// See design/16-metadata.md §"Pipeline Integration"
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
try {
|
|
256
|
-
// Static metadata files (.xml, .txt, .png, .ico, etc.) are served
|
|
257
|
-
// directly from disk. Dynamic metadata routes (.ts, .tsx) export a
|
|
258
|
-
// handler function that generates the response.
|
|
259
|
-
if (metaMatch.isStatic) {
|
|
260
|
-
return await serveStaticMetadataFile(metaMatch);
|
|
261
|
-
}
|
|
262
|
-
|
|
263
|
-
setSegmentParams(metaMatch.segmentParams);
|
|
264
|
-
const mod = await loadModule<{ default?: MetadataHandler }>(metaMatch.file);
|
|
265
|
-
if (typeof mod.default !== 'function') {
|
|
266
|
-
if (isDebug()) {
|
|
267
|
-
console.warn(
|
|
268
|
-
`[timber] Metadata route ${metaMatch.file} does not export a default function — responding with 500\n` +
|
|
269
|
-
` Metadata routes must export a default function that returns the metadata content.`
|
|
270
|
-
);
|
|
271
|
-
}
|
|
272
|
-
return new Response('Metadata route must export a default function', { status: 500 });
|
|
273
|
-
}
|
|
274
|
-
const handlerResult = await mod.default();
|
|
275
|
-
// If the handler returns a Response, normalize headers so the
|
|
276
|
-
// outer Server-Timing writer can append without hitting an
|
|
277
|
-
// immutable header bag (e.g. user returns Response.redirect()).
|
|
278
|
-
// No default Cache-Control here: the handler runs in the request
|
|
279
|
-
// context and may vary on cookies or headers, so a public default
|
|
280
|
-
// could serve one user's response to another (#1064).
|
|
281
|
-
if (handlerResult instanceof Response) {
|
|
282
|
-
return cloneWithMutableHeaders(handlerResult);
|
|
283
|
-
}
|
|
284
|
-
// Otherwise, serialize based on content type. The type discriminator
|
|
285
|
-
// here is the metadata route's declared content type (from the file
|
|
286
|
-
// convention), not the shape of `handlerResult` — TS can't narrow the
|
|
287
|
-
// `MetadataResult` union on that, so we assert against the expected
|
|
288
|
-
// shape at each branch.
|
|
289
|
-
const contentType = metaMatch.contentType;
|
|
290
|
-
let body: string;
|
|
291
|
-
if (typeof handlerResult === 'string') {
|
|
292
|
-
body = handlerResult;
|
|
293
|
-
} else if (contentType === 'application/xml') {
|
|
294
|
-
body = serializeSitemap(handlerResult as MetadataRoute.Sitemap);
|
|
295
|
-
} else if (contentType === 'application/manifest+json') {
|
|
296
|
-
body = JSON.stringify(handlerResult, null, 2);
|
|
297
|
-
} else {
|
|
298
|
-
body = String(handlerResult);
|
|
299
|
-
}
|
|
300
|
-
return new Response(body, {
|
|
301
|
-
status: 200,
|
|
302
|
-
headers: {
|
|
303
|
-
'Content-Type': `${contentType}; charset=utf-8`,
|
|
304
|
-
'Cache-Control': METADATA_CACHE_CONTROL,
|
|
305
|
-
},
|
|
306
|
-
});
|
|
307
|
-
} catch (error) {
|
|
308
|
-
// Control-flow signals from the metadata handler (e.g. a sitemap that
|
|
309
|
-
// calls deny(404) for an unknown tenant, or a dynamic icon that
|
|
310
|
-
// redirects to a CDN-hosted asset) translate to proper HTTP responses
|
|
311
|
-
// instead of being logged as 500s.
|
|
312
|
-
if (isRedirectSignal(error)) {
|
|
313
|
-
return new Response(null, {
|
|
314
|
-
status: error.status,
|
|
315
|
-
headers: { Location: error.location },
|
|
316
|
-
});
|
|
317
|
-
}
|
|
318
|
-
if (isDenySignal(error)) {
|
|
319
|
-
return new Response(null, { status: error.status });
|
|
320
|
-
}
|
|
321
|
-
logRenderError({ method, path, error });
|
|
322
|
-
await fireOnRequestError(error, req, 'route');
|
|
323
|
-
if (config.onPipelineError && error instanceof Error)
|
|
324
|
-
config.onPipelineError(error, 'metadata-route');
|
|
325
|
-
return new Response(null, { status: 500 });
|
|
326
|
-
}
|
|
327
|
-
}
|
|
261
|
+
const metaMatch = config.matchMetadataRoute?.(canonicalPathname);
|
|
262
|
+
if (metaMatch) {
|
|
263
|
+
return serveMetadataRoute(config, req, method, path, canonicalPathname, metaMatch);
|
|
328
264
|
}
|
|
329
265
|
|
|
330
266
|
// Stage 1b.2: Auto-generated sitemap — serves /sitemap.xml and /sitemap/N.xml
|
|
@@ -392,7 +328,13 @@ export async function handleRequest(
|
|
|
392
328
|
try {
|
|
393
329
|
// Stage 2: Route matching, then 2a: intercepting route resolution.
|
|
394
330
|
match = config.matchRoute(canonicalPathname);
|
|
395
|
-
|
|
331
|
+
let canonical: RouteMatch | undefined;
|
|
332
|
+
({ match, interception, canonical } = resolveInterceptedRoute(
|
|
333
|
+
config,
|
|
334
|
+
req,
|
|
335
|
+
canonicalPathname,
|
|
336
|
+
match
|
|
337
|
+
));
|
|
396
338
|
|
|
397
339
|
if (!match) {
|
|
398
340
|
// Dev-time diagnostic: log the unmatched pathname so developers can
|
|
@@ -430,22 +372,24 @@ export async function handleRequest(
|
|
|
430
372
|
// Coerce raw string params through the app/schema.ts codecs.
|
|
431
373
|
// Coercion failure → 404
|
|
432
374
|
// (middleware never runs). See design/07-routing.md §"Where Coercion Runs"
|
|
375
|
+
//
|
|
376
|
+
// An intercepted navigation coerces the URL's own params too: its gates
|
|
377
|
+
// read them, and a value its codecs reject 404s exactly as a direct
|
|
378
|
+
// navigation to the URL would.
|
|
433
379
|
try {
|
|
434
380
|
match = { ...match, segmentParams: await coerceSegmentParams(match) };
|
|
381
|
+
if (canonical) {
|
|
382
|
+
canonical = {
|
|
383
|
+
...canonical,
|
|
384
|
+
segmentParams: await coerceSegmentParams(canonical),
|
|
385
|
+
middlewareChain: interceptedMiddlewareChain(canonical, match),
|
|
386
|
+
};
|
|
387
|
+
match = { ...match, canonical };
|
|
388
|
+
}
|
|
435
389
|
} catch (error) {
|
|
436
390
|
if (error instanceof ParamCoercionError) {
|
|
437
|
-
// Dev-time diagnostic:
|
|
438
|
-
|
|
439
|
-
if (isDebug()) {
|
|
440
|
-
const segmentChain = match.segments.map((s) => s.segmentName || '/').join(' → ');
|
|
441
|
-
console.warn(
|
|
442
|
-
`[timber] Param coercion failed for ${method} ${canonicalPathname} — responding with 404\n` +
|
|
443
|
-
` Matched segments: ${segmentChain}\n` +
|
|
444
|
-
` Error: ${error.message}\n` +
|
|
445
|
-
` This usually means a codec in app/schema.ts rejected the URL value.\n` +
|
|
446
|
-
` Check the codec for the bracket key of the segment named above.`
|
|
447
|
-
);
|
|
448
|
-
}
|
|
391
|
+
// Dev-time diagnostic: silent coercion 404s are brutal to debug.
|
|
392
|
+
warnParamCoercionFailure(method, canonicalPathname, match.segments, error);
|
|
449
393
|
// For API routes (route.ts), return a bare 404 — not an HTML page.
|
|
450
394
|
// API consumers expect JSON/empty responses, not rendered HTML.
|
|
451
395
|
if (isApiRouteChain(match.segments)) {
|
|
@@ -465,13 +409,7 @@ export async function handleRequest(
|
|
|
465
409
|
setSegmentParams(match.segmentParams);
|
|
466
410
|
|
|
467
411
|
// Store the matched segment path for dev-mode validation in getSegmentParams().
|
|
468
|
-
|
|
469
|
-
const segmentPath =
|
|
470
|
-
match.segments
|
|
471
|
-
.map((s) => s.segmentName)
|
|
472
|
-
.filter(Boolean)
|
|
473
|
-
.join('/') || '/';
|
|
474
|
-
setMatchedSegmentPath(segmentPath.startsWith('/') ? segmentPath : `/${segmentPath}`);
|
|
412
|
+
setMatchedSegmentPath(matchedSegmentPath(match.segments));
|
|
475
413
|
} catch (error) {
|
|
476
414
|
return outcomeToResponse(config, thrownOutcome('setup', error), {
|
|
477
415
|
req,
|
|
@@ -482,22 +420,24 @@ export async function handleRequest(
|
|
|
482
420
|
});
|
|
483
421
|
}
|
|
484
422
|
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
423
|
+
// Middleware answers for the URL: on an intercepted navigation, a
|
|
424
|
+
// short-circuit or signal is the URL's answer, resolved against its own
|
|
425
|
+
// chain and rendered with its own params — a deny page's layouts read them
|
|
426
|
+
// and its payload publishes them — exactly as a navigation the
|
|
427
|
+
// interception did not apply to.
|
|
428
|
+
const outcomeContext = { req, method, path, responseHeaders };
|
|
429
|
+
const route = match.canonical ?? match;
|
|
430
|
+
if (route.middlewareChain.length > 0) {
|
|
431
|
+
const stopped = await runMiddlewarePhase(config, req, match, responseHeaders);
|
|
432
|
+
if (stopped) {
|
|
433
|
+
const answer = () => outcomeToResponse(config, stopped, { ...outcomeContext, match: route });
|
|
434
|
+
return match.canonical ? runWithRouteParams(route, answer) : answer();
|
|
435
|
+
}
|
|
436
|
+
}
|
|
495
437
|
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
path,
|
|
500
|
-
responseHeaders,
|
|
501
|
-
match,
|
|
438
|
+
const outcome = await runRenderPhase(config, req, match, responseHeaders, {
|
|
439
|
+
canonicalPathname,
|
|
440
|
+
interception,
|
|
502
441
|
});
|
|
442
|
+
return outcomeToResponse(config, outcome, { ...outcomeContext, match });
|
|
503
443
|
}
|