isr-engine 0.0.0-stage → 1.0.1
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/CHANGELOG.md +755 -0
- package/README.md +170 -2
- package/dist/RequestContext-BVQ-rOmV.js +58 -0
- package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
- package/dist/RequestContext-DgGEAxcW.cjs +105 -0
- package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
- package/dist/abVariantContext-CWCdRSdG.js +549 -0
- package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
- package/dist/adapters/observability/client/sentry.d.ts +42 -0
- package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/index.cjs +152 -0
- package/dist/adapters/observability/index.cjs.map +1 -0
- package/dist/adapters/observability/index.d.ts +17 -0
- package/dist/adapters/observability/index.d.ts.map +1 -0
- package/dist/adapters/observability/index.js +148 -0
- package/dist/adapters/observability/index.js.map +1 -0
- package/dist/adapters/observability/server/datadog.d.ts +45 -0
- package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
- package/dist/adapters/observability/server/otel.d.ts +51 -0
- package/dist/adapters/observability/server/otel.d.ts.map +1 -0
- package/dist/adapters/observability/server/sentry.d.ts +67 -0
- package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/types.d.ts +39 -0
- package/dist/adapters/observability/types.d.ts.map +1 -0
- package/dist/adapters/runtime/cloudflare.d.ts +33 -0
- package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
- package/dist/adapters/runtime/errorResponse.d.ts +3 -0
- package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
- package/dist/adapters/runtime/index.cjs +100 -0
- package/dist/adapters/runtime/index.cjs.map +1 -0
- package/dist/adapters/runtime/index.d.ts +10 -0
- package/dist/adapters/runtime/index.d.ts.map +1 -0
- package/dist/adapters/runtime/index.js +97 -0
- package/dist/adapters/runtime/index.js.map +1 -0
- package/dist/adapters/runtime/types.d.ts +24 -0
- package/dist/adapters/runtime/types.d.ts.map +1 -0
- package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
- package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
- package/dist/app/createISRApp.d.ts +19 -0
- package/dist/app/createISRApp.d.ts.map +1 -0
- package/dist/cache/CacheManager.d.ts +81 -0
- package/dist/cache/CacheManager.d.ts.map +1 -0
- package/dist/cache/ICacheAdapter.d.ts +84 -0
- package/dist/cache/ICacheAdapter.d.ts.map +1 -0
- package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
- package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisCacheAdapter.d.ts +111 -0
- package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisInvalidationBus.d.ts +59 -0
- package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/ResponseCacheBackend.d.ts +28 -0
- package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/createAutoCacheStore.d.ts +26 -0
- package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
- package/dist/cache/index.d.ts +18 -0
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cli/cli.cjs +372 -0
- package/dist/cli/cli.cjs.map +1 -0
- package/dist/cli/cli.d.ts +8 -0
- package/dist/cli/cli.d.ts.map +1 -0
- package/dist/cli/cli.js +370 -0
- package/dist/cli/cli.js.map +1 -0
- package/dist/cli/dev.d.ts +11 -0
- package/dist/cli/dev.d.ts.map +1 -0
- package/dist/cli/fallback.d.ts +42 -0
- package/dist/cli/fallback.d.ts.map +1 -0
- package/dist/cli/serverOptions.d.ts +7 -0
- package/dist/cli/serverOptions.d.ts.map +1 -0
- package/dist/cli/start.d.ts +7 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/config/defaults.d.ts +11 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defineConfig.cjs +26 -0
- package/dist/config/defineConfig.cjs.map +1 -0
- package/dist/config/defineConfig.d.ts +44 -0
- package/dist/config/defineConfig.d.ts.map +1 -0
- package/dist/config/defineConfig.js +24 -0
- package/dist/config/defineConfig.js.map +1 -0
- package/dist/config/getEnv.d.ts +9 -0
- package/dist/config/getEnv.d.ts.map +1 -0
- package/dist/config/getStatus.d.ts +3 -0
- package/dist/config/getStatus.d.ts.map +1 -0
- package/dist/config/loadConfig.d.ts +18 -0
- package/dist/config/loadConfig.d.ts.map +1 -0
- package/dist/config/normalizeEngineConfig.d.ts +10 -0
- package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
- package/dist/config/resolveImageOptions.d.ts +5 -0
- package/dist/config/resolveImageOptions.d.ts.map +1 -0
- package/dist/config/resolveRuntimeRedis.d.ts +11 -0
- package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
- package/dist/context/RequestContext.d.ts +28 -0
- package/dist/context/RequestContext.d.ts.map +1 -0
- package/dist/context/createServerRequestContext.d.ts +42 -0
- package/dist/context/createServerRequestContext.d.ts.map +1 -0
- package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs +105 -0
- package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs.map +1 -0
- package/dist/createCacheInspectorMiddleware-Dmuobpcb.js +105 -0
- package/dist/createCacheInspectorMiddleware-Dmuobpcb.js.map +1 -0
- package/dist/createISRApp-CDkyUuW3.js +7321 -0
- package/dist/createISRApp-CDkyUuW3.js.map +1 -0
- package/dist/createISRApp-Nv9mwX8I.cjs +7662 -0
- package/dist/createISRApp-Nv9mwX8I.cjs.map +1 -0
- package/dist/createImagePlugin-BVUPlPOz.js +416 -0
- package/dist/createImagePlugin-BVUPlPOz.js.map +1 -0
- package/dist/createImagePlugin-D-X_HGlR.cjs +435 -0
- package/dist/createImagePlugin-D-X_HGlR.cjs.map +1 -0
- package/dist/defaults/auto-observability.cjs +147 -0
- package/dist/defaults/auto-observability.cjs.map +1 -0
- package/dist/defaults/auto-observability.d.ts +21 -0
- package/dist/defaults/auto-observability.d.ts.map +1 -0
- package/dist/defaults/auto-observability.js +144 -0
- package/dist/defaults/auto-observability.js.map +1 -0
- package/dist/defaults/runtime/browserObservability.d.ts +73 -0
- package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.js +3 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
- package/dist/defaults/runtime/empty-routes.d.ts +3 -0
- package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
- package/dist/defaults/runtime/error-boundary.d.ts +9 -0
- package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
- package/dist/defaults/runtime/error500-template.d.ts +21 -0
- package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
- package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
- package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
- package/dist/defaults/runtime/i18n-server.d.ts +7 -0
- package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
- package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
- package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
- package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
- package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
- package/dist/discovery/componentDiscovery.d.ts +71 -0
- package/dist/discovery/componentDiscovery.d.ts.map +1 -0
- package/dist/discovery/directiveParser.d.ts +197 -0
- package/dist/discovery/directiveParser.d.ts.map +1 -0
- package/dist/discovery/exportParser.d.ts +45 -0
- package/dist/discovery/exportParser.d.ts.map +1 -0
- package/dist/discovery/fileSystem.d.ts +33 -0
- package/dist/discovery/fileSystem.d.ts.map +1 -0
- package/dist/discovery/index.d.ts +18 -0
- package/dist/discovery/index.d.ts.map +1 -0
- package/dist/discovery/routeDiscovery.d.ts +121 -0
- package/dist/discovery/routeDiscovery.d.ts.map +1 -0
- package/dist/discovery/scan.d.ts +54 -0
- package/dist/discovery/scan.d.ts.map +1 -0
- package/dist/discovery/types.d.ts +61 -0
- package/dist/discovery/types.d.ts.map +1 -0
- package/dist/engine/ISREngine.d.ts +54 -0
- package/dist/engine/ISREngine.d.ts.map +1 -0
- package/dist/engine/RenderMode.d.ts +23 -0
- package/dist/engine/RenderMode.d.ts.map +1 -0
- package/dist/engine/i18n/types.d.ts +6 -0
- package/dist/engine/i18n/types.d.ts.map +1 -0
- package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
- package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/SEOEngine.d.ts +61 -0
- package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
- package/dist/engine/seo/config.d.ts +9 -0
- package/dist/engine/seo/config.d.ts.map +1 -0
- package/dist/engine/seo/index.d.ts +10 -0
- package/dist/engine/seo/index.d.ts.map +1 -0
- package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
- package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
- package/dist/engine/seo/types.d.ts +75 -0
- package/dist/engine/seo/types.d.ts.map +1 -0
- package/dist/error500-template-BvZmvKoa.cjs +63 -0
- package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
- package/dist/error500-template-DhaZzLOB.js +63 -0
- package/dist/error500-template-DhaZzLOB.js.map +1 -0
- package/dist/experiments/ExposureQueue.d.ts +54 -0
- package/dist/experiments/ExposureQueue.d.ts.map +1 -0
- package/dist/experiments/ManifestLoader.d.ts +57 -0
- package/dist/experiments/ManifestLoader.d.ts.map +1 -0
- package/dist/i18n-CyJIoYJT.cjs +244 -0
- package/dist/i18n-CyJIoYJT.cjs.map +1 -0
- package/dist/i18n-Dobe0Wxn.js +191 -0
- package/dist/i18n-Dobe0Wxn.js.map +1 -0
- package/dist/image/index.cjs +93 -0
- package/dist/image/index.cjs.map +1 -0
- package/dist/image/index.js +67 -0
- package/dist/image/index.js.map +1 -0
- package/dist/index.d.ts +59 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/isr/ISRRoutes.d.ts +25 -0
- package/dist/isr/ISRRoutes.d.ts.map +1 -0
- package/dist/isr-engine.cjs +2830 -0
- package/dist/isr-engine.cjs.map +1 -0
- package/dist/isr-engine.js +2740 -0
- package/dist/isr-engine.js.map +1 -0
- package/dist/logger/Logger.d.ts +33 -0
- package/dist/logger/Logger.d.ts.map +1 -0
- package/dist/logger/index.d.ts +3 -0
- package/dist/logger/index.d.ts.map +1 -0
- package/dist/manifest/ManifestLoader.d.ts +98 -0
- package/dist/manifest/ManifestLoader.d.ts.map +1 -0
- package/dist/manifest/index.d.ts +8 -0
- package/dist/manifest/index.d.ts.map +1 -0
- package/dist/manifest/types.d.ts +76 -0
- package/dist/manifest/types.d.ts.map +1 -0
- package/dist/metrics/MetricsCollector.d.ts +90 -0
- package/dist/metrics/MetricsCollector.d.ts.map +1 -0
- package/dist/metrics/PromMetrics.d.ts +59 -0
- package/dist/metrics/PromMetrics.d.ts.map +1 -0
- package/dist/metrics/index.d.ts +7 -0
- package/dist/metrics/index.d.ts.map +1 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
- package/dist/middlewares/LocaleRedirect.d.ts +27 -0
- package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
- package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
- package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/TraceMiddleware.d.ts +24 -0
- package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/abVariantContext.d.ts +7 -0
- package/dist/middlewares/abVariantContext.d.ts.map +1 -0
- package/dist/middlewares/index.d.ts +5 -0
- package/dist/middlewares/index.d.ts.map +1 -0
- package/dist/middlewares/types.d.ts +4 -0
- package/dist/middlewares/types.d.ts.map +1 -0
- package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
- package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
- package/dist/plugin/coherentCacheStore.d.ts +11 -0
- package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
- package/dist/plugin/createFontPlugin.d.ts +15 -0
- package/dist/plugin/createFontPlugin.d.ts.map +1 -0
- package/dist/plugin/createImagePlugin.d.ts +46 -0
- package/dist/plugin/createImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createIsrPlugin.d.ts +43 -0
- package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
- package/dist/plugin/index.d.ts +11 -0
- package/dist/plugin/index.d.ts.map +1 -0
- package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
- package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
- package/dist/plugin/isrCacheStore.d.ts +88 -0
- package/dist/plugin/isrCacheStore.d.ts.map +1 -0
- package/dist/plugin/remoteImageSource.d.ts +19 -0
- package/dist/plugin/remoteImageSource.d.ts.map +1 -0
- package/dist/plugin/transformDevCssModule.d.ts +3 -0
- package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
- package/dist/renderer/RenderHeaders.d.ts +28 -0
- package/dist/renderer/RenderHeaders.d.ts.map +1 -0
- package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
- package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
- package/dist/route/RouteManager.d.ts +22 -0
- package/dist/route/RouteManager.d.ts.map +1 -0
- package/dist/route/index.d.ts +2 -0
- package/dist/route/index.d.ts.map +1 -0
- package/dist/rsc/ServerActions.d.ts +65 -0
- package/dist/rsc/ServerActions.d.ts.map +1 -0
- package/dist/rsc/browser.cjs +109 -0
- package/dist/rsc/browser.cjs.map +1 -0
- package/dist/rsc/browser.d.ts +59 -0
- package/dist/rsc/browser.d.ts.map +1 -0
- package/dist/rsc/browser.js +85 -0
- package/dist/rsc/browser.js.map +1 -0
- package/dist/rsc/cacheTag.d.ts +52 -0
- package/dist/rsc/cacheTag.d.ts.map +1 -0
- package/dist/rsc/constants.d.ts +10 -0
- package/dist/rsc/constants.d.ts.map +1 -0
- package/dist/rsc/i18n.d.ts +3 -0
- package/dist/rsc/i18n.d.ts.map +1 -0
- package/dist/rsc/index.cjs +33 -0
- package/dist/rsc/index.d.ts +20 -0
- package/dist/rsc/index.d.ts.map +1 -0
- package/dist/rsc/index.js +4 -0
- package/dist/rsc/revalidate.d.ts +77 -0
- package/dist/rsc/revalidate.d.ts.map +1 -0
- package/dist/rsc-H7D_meHu.cjs +239 -0
- package/dist/rsc-H7D_meHu.cjs.map +1 -0
- package/dist/rsc-lvWPTuVD.js +168 -0
- package/dist/rsc-lvWPTuVD.js.map +1 -0
- package/dist/runtime/Image.d.ts +48 -0
- package/dist/runtime/Image.d.ts.map +1 -0
- package/dist/runtime/LocaleContext.d.ts +14 -0
- package/dist/runtime/LocaleContext.d.ts.map +1 -0
- package/dist/runtime/boundary.d.ts +27 -0
- package/dist/runtime/boundary.d.ts.map +1 -0
- package/dist/runtime/edge-context.d.ts +17 -0
- package/dist/runtime/edge-context.d.ts.map +1 -0
- package/dist/runtime/i18n-store.d.ts +11 -0
- package/dist/runtime/i18n-store.d.ts.map +1 -0
- package/dist/runtime/i18n.d.ts +115 -0
- package/dist/runtime/i18n.d.ts.map +1 -0
- package/dist/runtime/index.d.ts +16 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/routes.d.ts +88 -0
- package/dist/runtime/routes.d.ts.map +1 -0
- package/dist/runtime/telemetry.d.ts +48 -0
- package/dist/runtime/telemetry.d.ts.map +1 -0
- package/dist/security/cspNonceTemplate.d.ts +10 -0
- package/dist/security/cspNonceTemplate.d.ts.map +1 -0
- package/dist/security/staticCspManifest.d.ts +37 -0
- package/dist/security/staticCspManifest.d.ts.map +1 -0
- package/dist/server/httpServer.d.ts +17 -0
- package/dist/server/httpServer.d.ts.map +1 -0
- package/dist/server/index.d.ts +3 -0
- package/dist/server/index.d.ts.map +1 -0
- package/dist/server/manager.d.ts +17 -0
- package/dist/server/manager.d.ts.map +1 -0
- package/dist/server/middleware.d.ts +87 -0
- package/dist/server/middleware.d.ts.map +1 -0
- package/dist/server/opsConfig.d.ts +17 -0
- package/dist/server/opsConfig.d.ts.map +1 -0
- package/dist/server/productionRuntime.d.ts +41 -0
- package/dist/server/productionRuntime.d.ts.map +1 -0
- package/dist/server/types.d.ts +41 -0
- package/dist/server/types.d.ts.map +1 -0
- package/dist/server/viteDevServer.d.ts +21 -0
- package/dist/server/viteDevServer.d.ts.map +1 -0
- package/dist/ssg/spider.d.ts +142 -0
- package/dist/ssg/spider.d.ts.map +1 -0
- package/dist/types/IFlightData.d.ts +23 -0
- package/dist/types/IFlightData.d.ts.map +1 -0
- package/dist/types/IHelmetData.d.ts +24 -0
- package/dist/types/IHelmetData.d.ts.map +1 -0
- package/dist/types/IRenderMetadata.d.ts +46 -0
- package/dist/types/IRenderMetadata.d.ts.map +1 -0
- package/dist/types/IRenderResult.d.ts +16 -0
- package/dist/types/IRenderResult.d.ts.map +1 -0
- package/dist/types/ISRConfig.d.ts +463 -0
- package/dist/types/ISRConfig.d.ts.map +1 -0
- package/dist/types/ISRContext.d.ts +104 -0
- package/dist/types/ISRContext.d.ts.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/utils/CacheCleanup.d.ts +32 -0
- package/dist/utils/CacheCleanup.d.ts.map +1 -0
- package/dist/utils/cacheDuration.d.ts +12 -0
- package/dist/utils/cacheDuration.d.ts.map +1 -0
- package/dist/utils/cookie.d.ts +7 -0
- package/dist/utils/cookie.d.ts.map +1 -0
- package/dist/utils/hash.d.ts +22 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/htmlPathname.d.ts +12 -0
- package/dist/utils/htmlPathname.d.ts.map +1 -0
- package/dist/utils/index.d.ts +9 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/resolveFetchHandler.d.ts +4 -0
- package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
- package/dist/utils/trimTrailingSlashes.d.ts +3 -0
- package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
- package/package.json +199 -4
- package/src/context/RequestContext.ts +68 -0
- package/src/context/createServerRequestContext.ts +104 -0
- package/src/defaults/auto-observability.ts +195 -0
- package/src/defaults/entry.server.ssr.tsx +257 -0
- package/src/defaults/entry.server.tsx +117 -0
- package/src/defaults/entry.tsx +23 -0
- package/src/defaults/runtime/browserObservability.ts +837 -0
- package/src/defaults/runtime/client-navigation-policy.ts +67 -0
- package/src/defaults/runtime/createCachedFetcher.ts +121 -0
- package/src/defaults/runtime/defineClientEntry.tsx +773 -0
- package/src/defaults/runtime/defineServerEntry.tsx +421 -0
- package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
- package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
- package/src/defaults/runtime/dev-render-inspector.ts +597 -0
- package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
- package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
- package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
- package/src/defaults/runtime/dev-style-id.ts +91 -0
- package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
- package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
- package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +41 -0
- package/src/defaults/runtime/empty-config.ts +5 -0
- package/src/defaults/runtime/empty-routes.ts +2 -0
- package/src/defaults/runtime/error-boundary.style.css +35 -0
- package/src/defaults/runtime/error-boundary.tsx +65 -0
- package/src/defaults/runtime/error500-template.ts +66 -0
- package/src/defaults/runtime/head-extras-runtime.ts +64 -0
- package/src/defaults/runtime/hydration-shell.tsx +20 -0
- package/src/defaults/runtime/i18n-server.ts +27 -0
- package/src/defaults/runtime/navigation-history.client.ts +80 -0
- package/src/defaults/runtime/navigation-request.client.ts +21 -0
- package/src/defaults/runtime/request.tsx +100 -0
- package/src/defaults/runtime/seo-runtime.ts +257 -0
- package/src/defaults/tsconfig.json +10 -0
- package/src/defaults/types.d.ts +23 -0
- package/src/runtime/Image.tsx +124 -0
- package/src/runtime/LocaleContext.tsx +38 -0
- package/src/runtime/boundary.module.css +46 -0
- package/src/runtime/boundary.tsx +136 -0
- package/src/runtime/edge-context.ts +32 -0
- package/src/runtime/i18n-store.ts +76 -0
- package/src/runtime/i18n.ts +189 -0
- package/src/runtime/index.ts +61 -0
- package/src/runtime/routes.tsx +247 -0
- package/src/runtime/scss.d.ts +13 -0
- package/src/runtime/telemetry.ts +116 -0
- package/src/types/IFlightData.ts +27 -0
- package/src/types/IHelmetData.ts +9 -0
- package/src/types/IRenderMetadata.ts +52 -0
- package/src/types/IRenderResult.ts +16 -0
- package/src/types/ISRConfig.ts +507 -0
- package/src/types/ISRContext.ts +106 -0
- package/src/types/index.ts +6 -0
- package/src/utils/CacheCleanup.ts +74 -0
- package/src/utils/cacheDuration.ts +37 -0
- package/src/utils/cookie.ts +59 -0
- package/src/utils/hash.ts +32 -0
- package/src/utils/htmlPathname.ts +75 -0
- package/src/utils/index.ts +9 -0
- package/src/utils/resolveFetchHandler.ts +17 -0
- package/src/utils/trimTrailingSlashes.ts +6 -0
|
@@ -0,0 +1,773 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* defineClientEntry —— FaaS 风格的浏览器入口工厂
|
|
3
|
+
*
|
|
4
|
+
* 用户态写法(覆盖 engine 默认行为):
|
|
5
|
+
*
|
|
6
|
+
* // src/entry.tsx
|
|
7
|
+
* export default {
|
|
8
|
+
* devInspector: true,
|
|
9
|
+
* // beforeStart / onNavigate / onActionError 是高级逃生口:
|
|
10
|
+
* // 普通 PV、Web Vitals、全局错误、Server Action 错误由 runtime.telemetry 自动处理。
|
|
11
|
+
* };
|
|
12
|
+
*
|
|
13
|
+
* 不传任何 hook 时(engine 默认入口的写法):
|
|
14
|
+
*
|
|
15
|
+
* defineClientEntry(); // 一行搞定
|
|
16
|
+
*
|
|
17
|
+
* Hook 之外的全部协议细节(initial Flight 反序列化 / hydrateRoot vs createRoot 决策 /
|
|
18
|
+
* popstate / pushState 拦截 / Server Action setServerCallback / HMR)由本工厂内部
|
|
19
|
+
* 固化实现,用户**不需要**了解或重写。
|
|
20
|
+
*/
|
|
21
|
+
import {
|
|
22
|
+
createFromFetch,
|
|
23
|
+
createFromReadableStream,
|
|
24
|
+
createTemporaryReferenceSet,
|
|
25
|
+
encodeReply,
|
|
26
|
+
setServerCallback,
|
|
27
|
+
} from '@vitejs/plugin-rsc/browser';
|
|
28
|
+
import * as React from 'react';
|
|
29
|
+
import { createRoot, hydrateRoot } from 'react-dom/client';
|
|
30
|
+
import { rscStream } from 'rsc-html-stream/client';
|
|
31
|
+
|
|
32
|
+
import { GlobalErrorBoundary } from './error-boundary';
|
|
33
|
+
import { createNavigationRequestLifecycle } from './navigation-request.client';
|
|
34
|
+
import {
|
|
35
|
+
createPrefetcher,
|
|
36
|
+
isRscNavigation,
|
|
37
|
+
shouldPrefetch as canPrefetch,
|
|
38
|
+
type PrefetchConnection,
|
|
39
|
+
} from './client-navigation-policy';
|
|
40
|
+
import { HydrationShell } from './hydration-shell';
|
|
41
|
+
import { createRscRenderRequest, type RscRenderRequestOptions } from './request';
|
|
42
|
+
import { DevStyleCommitBoundary } from './dev-style-commit-boundary.client';
|
|
43
|
+
import {
|
|
44
|
+
completeDevStyleNavigation,
|
|
45
|
+
prepareDevStyleTree,
|
|
46
|
+
registerDevStyleRegistry,
|
|
47
|
+
runWithDevStyleNavigation,
|
|
48
|
+
} from './dev-style-navigation.client';
|
|
49
|
+
import { getOrCreateDevStyleRegistry } from './dev-style-registry.client';
|
|
50
|
+
import { observeDevRscResponse } from './dev-rsc-response.client';
|
|
51
|
+
import {
|
|
52
|
+
isInternalNavigationHistoryMutation,
|
|
53
|
+
syncBrowserUrlToFinalRedirect,
|
|
54
|
+
} from './navigation-history.client';
|
|
55
|
+
import { installDevRenderInspector } from './dev-render-inspector';
|
|
56
|
+
import { setClientI18n } from '../../runtime/i18n-store';
|
|
57
|
+
import { applySeoToDocument, type IntlPayload, type PageSeoMeta } from './seo-runtime';
|
|
58
|
+
import {
|
|
59
|
+
installBrowserObservability,
|
|
60
|
+
type BrowserObservabilityHandle,
|
|
61
|
+
type BrowserObservabilityOptions,
|
|
62
|
+
} from './browserObservability';
|
|
63
|
+
interface DefaultRscPayload {
|
|
64
|
+
root: React.ReactNode;
|
|
65
|
+
intl?: IntlPayload | null;
|
|
66
|
+
/** 与 server entry 对齐 —— 客户端 RSC 导航时把 meta 同步到 document.head */
|
|
67
|
+
seoMeta?: PageSeoMeta | null;
|
|
68
|
+
/** canonical / og:image 转绝对 URL 用 */
|
|
69
|
+
siteBaseUrl?: string | null;
|
|
70
|
+
formState?: import('react-dom/client').ReactFormState;
|
|
71
|
+
returnValue?: { ok: boolean; data: unknown };
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
interface DefaultRscPayloadState {
|
|
75
|
+
payload: DefaultRscPayload;
|
|
76
|
+
generation: number | undefined;
|
|
77
|
+
styleIds: string[];
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
async function preparePayloadDevStyles(generation: number | undefined): Promise<string[]> {
|
|
81
|
+
if (!import.meta.env.DEV || generation === undefined) return [];
|
|
82
|
+
return prepareDevStyleTree(generation);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function createPayloadState(
|
|
86
|
+
payload: DefaultRscPayload,
|
|
87
|
+
generation: number | undefined,
|
|
88
|
+
styleIds: string[] = []
|
|
89
|
+
): DefaultRscPayloadState {
|
|
90
|
+
return { payload, generation, styleIds };
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
type TemporaryReferences = ReturnType<typeof createTemporaryReferenceSet>;
|
|
94
|
+
|
|
95
|
+
interface FetchedRscPayload {
|
|
96
|
+
payload: DefaultRscPayload;
|
|
97
|
+
response: Response;
|
|
98
|
+
requestedUrl: string;
|
|
99
|
+
styleIds: string[];
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
async function fetchRscResponse(
|
|
103
|
+
request: Request,
|
|
104
|
+
temporaryReferences?: TemporaryReferences
|
|
105
|
+
): Promise<FetchedRscPayload> {
|
|
106
|
+
const responsePromise = fetch(request);
|
|
107
|
+
if (!import.meta.env.DEV) {
|
|
108
|
+
const payload = await createFromFetch<DefaultRscPayload>(
|
|
109
|
+
responsePromise,
|
|
110
|
+
temporaryReferences ? { temporaryReferences } : undefined
|
|
111
|
+
);
|
|
112
|
+
return { payload, response: await responsePromise, requestedUrl: request.url, styleIds: [] };
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
const observationPromise = responsePromise.then(observeDevRscResponse);
|
|
116
|
+
const payload = await createFromFetch<DefaultRscPayload>(
|
|
117
|
+
observationPromise.then(observation => observation.response),
|
|
118
|
+
temporaryReferences ? { temporaryReferences } : undefined
|
|
119
|
+
);
|
|
120
|
+
const observation = await observationPromise;
|
|
121
|
+
await observation.completed;
|
|
122
|
+
return {
|
|
123
|
+
payload,
|
|
124
|
+
response: observation.original,
|
|
125
|
+
requestedUrl: request.url,
|
|
126
|
+
styleIds: [],
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
async function prepareFetchedDevStyles(
|
|
131
|
+
result: FetchedRscPayload,
|
|
132
|
+
generation: number | undefined
|
|
133
|
+
): Promise<void> {
|
|
134
|
+
result.styleIds = await preparePayloadDevStyles(generation);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
function renderPayloadRoot({
|
|
138
|
+
payload,
|
|
139
|
+
generation,
|
|
140
|
+
styleIds,
|
|
141
|
+
}: DefaultRscPayloadState): React.ReactNode {
|
|
142
|
+
if (!import.meta.env.DEV || generation === undefined) return payload.root;
|
|
143
|
+
return (
|
|
144
|
+
<DevStyleCommitBoundary key={generation} generation={generation} styleIds={styleIds}>
|
|
145
|
+
{payload.root}
|
|
146
|
+
</DevStyleCommitBoundary>
|
|
147
|
+
);
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
function devStyleRequestOptions(
|
|
151
|
+
generation: number | undefined
|
|
152
|
+
): RscRenderRequestOptions | undefined {
|
|
153
|
+
if (!import.meta.env.DEV || generation === undefined) return undefined;
|
|
154
|
+
return { devStyleGeneration: generation };
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* csr-shell 友好降级页 —— 服务端崩溃时给用户的最终页面
|
|
159
|
+
*
|
|
160
|
+
* 设计原则:
|
|
161
|
+
* - 不尝试自动恢复(自动 _.rsc fetch 大概率也失败 —— server 还没起来)
|
|
162
|
+
* - 不让任何 server 错误进 React 树(避免 console 噪声 + 错误传播)
|
|
163
|
+
* - 给用户明确状态(不是白屏,不是错误堆栈)+ 显式 retry 按钮
|
|
164
|
+
*
|
|
165
|
+
* 类比:成熟产品的 outage / recovery 页面。
|
|
166
|
+
*/
|
|
167
|
+
function CsrShellFallback(): React.ReactElement {
|
|
168
|
+
return React.createElement(
|
|
169
|
+
'html',
|
|
170
|
+
{ lang: 'zh-CN' },
|
|
171
|
+
React.createElement(
|
|
172
|
+
'head',
|
|
173
|
+
null,
|
|
174
|
+
React.createElement('meta', { charSet: 'utf-8' }),
|
|
175
|
+
React.createElement('title', null, '服务暂时不可用'),
|
|
176
|
+
React.createElement('style', {
|
|
177
|
+
dangerouslySetInnerHTML: {
|
|
178
|
+
__html: `
|
|
179
|
+
:root { color-scheme: dark; }
|
|
180
|
+
body { margin:0; background:#111418; color:#e7edf4; font:14px Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif; }
|
|
181
|
+
.csr-shell-page { min-height:100vh; display:grid; place-items:center; padding:32px 20px; }
|
|
182
|
+
.csr-shell-card { width:min(520px,100%); padding:28px; border:1px solid rgba(255,255,255,.12); border-radius:8px; background:#171b21; box-shadow:0 24px 80px rgba(0,0,0,.32); }
|
|
183
|
+
.csr-shell-badge { display:inline-flex; align-items:center; height:24px; padding:0 10px; border:1px solid rgba(125,211,252,.24); border-radius:999px; background:rgba(14,165,233,.12); color:#7dd3fc; font-size:12px; font-weight:700; letter-spacing:0; }
|
|
184
|
+
.csr-shell-card h1 { margin:18px 0 8px; color:#f8fafc; font-size:clamp(24px,4vw,34px); line-height:1.15; letter-spacing:0; }
|
|
185
|
+
.csr-shell-card p { margin:0; color:#aab4c1; line-height:1.7; }
|
|
186
|
+
.csr-shell-grid { display:grid; gap:10px; margin-top:22px; }
|
|
187
|
+
.csr-shell-row { display:flex; justify-content:space-between; gap:16px; padding:12px; border:1px solid rgba(255,255,255,.08); border-radius:8px; background:rgba(255,255,255,.04); }
|
|
188
|
+
.csr-shell-row span:first-child { color:#8894a3; }
|
|
189
|
+
.csr-shell-row span:last-child { color:#f8fafc; font-weight:700; text-align:right; }
|
|
190
|
+
.csr-shell-page button { min-height:38px; margin-top:22px; padding:0 16px; border:0; border-radius:6px; background:#f97316; color:#111418; font-weight:800; cursor:pointer; }
|
|
191
|
+
.csr-shell-page button:focus-visible { outline:2px solid #fed7aa; outline-offset:2px; }
|
|
192
|
+
.csr-shell-page button:hover { background:#fb923c; }
|
|
193
|
+
`,
|
|
194
|
+
},
|
|
195
|
+
})
|
|
196
|
+
),
|
|
197
|
+
React.createElement(
|
|
198
|
+
'body',
|
|
199
|
+
null,
|
|
200
|
+
React.createElement(
|
|
201
|
+
'div',
|
|
202
|
+
{ className: 'csr-shell-page' },
|
|
203
|
+
React.createElement(
|
|
204
|
+
'main',
|
|
205
|
+
{ className: 'csr-shell-card', role: 'status', 'aria-live': 'polite' },
|
|
206
|
+
React.createElement('span', { className: 'csr-shell-badge' }, 'CSR fallback'),
|
|
207
|
+
React.createElement('h1', null, '服务端暂时不可用'),
|
|
208
|
+
React.createElement(
|
|
209
|
+
'p',
|
|
210
|
+
null,
|
|
211
|
+
'客户端自救也未能拿到 RSC 数据。请稍后重新加载,或检查服务端日志。'
|
|
212
|
+
),
|
|
213
|
+
React.createElement(
|
|
214
|
+
'div',
|
|
215
|
+
{ className: 'csr-shell-grid', 'aria-label': '降级状态' },
|
|
216
|
+
React.createElement(
|
|
217
|
+
'div',
|
|
218
|
+
{ className: 'csr-shell-row' },
|
|
219
|
+
React.createElement('span', null, 'Render strategy'),
|
|
220
|
+
React.createElement('span', null, 'client recovery')
|
|
221
|
+
),
|
|
222
|
+
React.createElement(
|
|
223
|
+
'div',
|
|
224
|
+
{ className: 'csr-shell-row' },
|
|
225
|
+
React.createElement('span', null, 'Next action'),
|
|
226
|
+
React.createElement('span', null, 'retry')
|
|
227
|
+
)
|
|
228
|
+
),
|
|
229
|
+
React.createElement(
|
|
230
|
+
'button',
|
|
231
|
+
{ type: 'button', onClick: () => location.reload() },
|
|
232
|
+
'重新加载'
|
|
233
|
+
)
|
|
234
|
+
)
|
|
235
|
+
)
|
|
236
|
+
)
|
|
237
|
+
);
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
export interface ClientEntryHooks {
|
|
241
|
+
/** Client runtime 启动前调用 —— 适合第三方 SDK 初始化或设置 telemetry user,不负责常规第一方上报 */
|
|
242
|
+
beforeStart?: (ctx: ClientEntryHookContext) => void | Promise<void>;
|
|
243
|
+
/** 客户端导航发生时调用;第一方 page_view 已自动上报,这里只做业务补充或第三方 breadcrumb */
|
|
244
|
+
onNavigate?: (url: URL, ctx: ClientEntryHookContext) => void;
|
|
245
|
+
/** Server Action 调用失败时调用;第一方错误已自动上报,这里只做业务补充或第三方 breadcrumb */
|
|
246
|
+
onActionError?: (error: unknown, actionId: string, ctx: ClientEntryHookContext) => void;
|
|
247
|
+
/**
|
|
248
|
+
* 浏览器 telemetry。engine 接管启动、导航和 Server Action 失败这些生命周期点;
|
|
249
|
+
* 具体上报只通过 ssr.config.ts runtime.telemetry 里的 endpoint。
|
|
250
|
+
* engine 不 import `@app/analytics` / `@app/error-reporting`;
|
|
251
|
+
* 这两个独立 SDK 只给非 engine 应用或业务自定义接入使用。
|
|
252
|
+
*/
|
|
253
|
+
telemetry?: false | BrowserObservabilityOptions;
|
|
254
|
+
/**
|
|
255
|
+
* 开发态渲染检查器。默认启用;业务如需完全隐藏可在 src/entry.tsx 返回
|
|
256
|
+
* `{ devInspector: false }`。
|
|
257
|
+
*/
|
|
258
|
+
devInspector?: boolean;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
export type ClientEntryTelemetryApi = Pick<
|
|
262
|
+
BrowserObservabilityHandle,
|
|
263
|
+
'track' | 'capture' | 'measure' | 'page' | 'setUser' | 'flush'
|
|
264
|
+
>;
|
|
265
|
+
|
|
266
|
+
export interface ClientEntryHookContext {
|
|
267
|
+
telemetry: ClientEntryTelemetryApi;
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
export function defineClientEntry(hooks: ClientEntryHooks = {}): void {
|
|
271
|
+
void main(hooks);
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
async function main(hooks: ClientEntryHooks): Promise<void> {
|
|
275
|
+
if (import.meta.env.DEV) {
|
|
276
|
+
const registry = getOrCreateDevStyleRegistry(document, {
|
|
277
|
+
onRscCommit: completeDevStyleNavigation,
|
|
278
|
+
});
|
|
279
|
+
registerDevStyleRegistry(registry);
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
const observability =
|
|
283
|
+
hooks.telemetry && hooks.telemetry !== false
|
|
284
|
+
? await installBrowserObservability(hooks.telemetry)
|
|
285
|
+
: null;
|
|
286
|
+
const hookContext = createHookContext(observability);
|
|
287
|
+
|
|
288
|
+
if (hooks.beforeStart) await hooks.beforeStart(hookContext);
|
|
289
|
+
|
|
290
|
+
const installInspector = () => {
|
|
291
|
+
if (hooks.devInspector === false) return;
|
|
292
|
+
try {
|
|
293
|
+
installDevRenderInspector();
|
|
294
|
+
} catch {
|
|
295
|
+
/* dev inspector 不能阻断业务客户端启动 */
|
|
296
|
+
}
|
|
297
|
+
};
|
|
298
|
+
|
|
299
|
+
// Inspector 必须先于 RSC 反序列化和 hydrateRoot 安装:
|
|
300
|
+
// 首屏 RSC / hydration / dynamic import 任一环节失败时,开发者仍能看到真实渲染模式。
|
|
301
|
+
installInspector();
|
|
302
|
+
|
|
303
|
+
function schedulePostCommitInspectorInstall(): void {
|
|
304
|
+
if (hooks.devInspector === false) return;
|
|
305
|
+
const installAfterCommit = () => {
|
|
306
|
+
installInspector();
|
|
307
|
+
window.setTimeout(installInspector, 0);
|
|
308
|
+
window.setTimeout(installInspector, 50);
|
|
309
|
+
};
|
|
310
|
+
|
|
311
|
+
if (typeof window.requestAnimationFrame === 'function') {
|
|
312
|
+
window.requestAnimationFrame(installAfterCommit);
|
|
313
|
+
return;
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
window.setTimeout(installAfterCommit, 0);
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
const navigationRequests = createNavigationRequestLifecycle();
|
|
320
|
+
|
|
321
|
+
function mountRscShellFallback(): void {
|
|
322
|
+
document.body.classList.remove('csr-shell-body');
|
|
323
|
+
document.body.removeAttribute('style');
|
|
324
|
+
|
|
325
|
+
let setPayload: (v: DefaultRscPayloadState) => void = () => {};
|
|
326
|
+
|
|
327
|
+
async function fetchRscPayload(): Promise<void> {
|
|
328
|
+
await navigationRequests.run(async signal => {
|
|
329
|
+
await runWithDevStyleNavigation(
|
|
330
|
+
async generation => {
|
|
331
|
+
const renderRequest = createRscRenderRequest(
|
|
332
|
+
window.location.href,
|
|
333
|
+
undefined,
|
|
334
|
+
devStyleRequestOptions(generation)
|
|
335
|
+
);
|
|
336
|
+
return fetchRscResponse(new Request(renderRequest, { signal }));
|
|
337
|
+
},
|
|
338
|
+
({ payload, response, requestedUrl, styleIds }, generation) => {
|
|
339
|
+
signal.throwIfAborted();
|
|
340
|
+
syncBrowserUrlToFinalRedirect(response, requestedUrl);
|
|
341
|
+
setClientI18n(payload.intl);
|
|
342
|
+
applySeoToDocument(payload.seoMeta, payload.siteBaseUrl ?? undefined);
|
|
343
|
+
setPayload(createPayloadState(payload, generation, styleIds));
|
|
344
|
+
},
|
|
345
|
+
async (result, generation) => {
|
|
346
|
+
signal.throwIfAborted();
|
|
347
|
+
await prepareFetchedDevStyles(result, generation);
|
|
348
|
+
signal.throwIfAborted();
|
|
349
|
+
}
|
|
350
|
+
);
|
|
351
|
+
});
|
|
352
|
+
}
|
|
353
|
+
|
|
354
|
+
function RscShellRoot(): React.ReactNode {
|
|
355
|
+
const [payloadState, setPayload_] = React.useState<DefaultRscPayloadState | null>(null);
|
|
356
|
+
const [failed, setFailed] = React.useState(false);
|
|
357
|
+
|
|
358
|
+
React.useEffect(() => {
|
|
359
|
+
setPayload = v => React.startTransition(() => setPayload_(v));
|
|
360
|
+
}, [setPayload_]);
|
|
361
|
+
|
|
362
|
+
React.useEffect(() => {
|
|
363
|
+
fetchRscPayload().catch(() => setFailed(true));
|
|
364
|
+
return listenNavigation(
|
|
365
|
+
() => {
|
|
366
|
+
setFailed(false);
|
|
367
|
+
fetchRscPayload().catch(() => setFailed(true));
|
|
368
|
+
},
|
|
369
|
+
hooks.onNavigate,
|
|
370
|
+
observability,
|
|
371
|
+
hookContext
|
|
372
|
+
);
|
|
373
|
+
}, []);
|
|
374
|
+
|
|
375
|
+
if (failed) return React.createElement(CsrShellFallback);
|
|
376
|
+
if (!payloadState) {
|
|
377
|
+
return React.createElement(
|
|
378
|
+
'html',
|
|
379
|
+
{ lang: 'zh-CN' },
|
|
380
|
+
React.createElement(
|
|
381
|
+
'body',
|
|
382
|
+
null,
|
|
383
|
+
React.createElement('div', { className: 'csr-shell-page' }, '加载中…')
|
|
384
|
+
)
|
|
385
|
+
);
|
|
386
|
+
}
|
|
387
|
+
return renderPayloadRoot(payloadState);
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
setServerCallback(async (id: string, args: unknown[]) => {
|
|
391
|
+
const result = await runWithDevStyleNavigation(
|
|
392
|
+
async generation => {
|
|
393
|
+
const temporaryReferences = createTemporaryReferenceSet();
|
|
394
|
+
const renderRequest = createRscRenderRequest(
|
|
395
|
+
window.location.href,
|
|
396
|
+
{
|
|
397
|
+
id,
|
|
398
|
+
body: await encodeReply(args, { temporaryReferences }),
|
|
399
|
+
},
|
|
400
|
+
devStyleRequestOptions(generation)
|
|
401
|
+
);
|
|
402
|
+
return fetchRscResponse(renderRequest, temporaryReferences);
|
|
403
|
+
},
|
|
404
|
+
({ payload, styleIds }, generation) => {
|
|
405
|
+
setClientI18n(payload.intl);
|
|
406
|
+
applySeoToDocument(payload.seoMeta, payload.siteBaseUrl ?? undefined);
|
|
407
|
+
setPayload(createPayloadState(payload, generation, styleIds));
|
|
408
|
+
return payload;
|
|
409
|
+
},
|
|
410
|
+
prepareFetchedDevStyles
|
|
411
|
+
);
|
|
412
|
+
const payload =
|
|
413
|
+
result.status === 'superseded' ? result.operationValue?.payload : result.value;
|
|
414
|
+
if (!payload) return undefined;
|
|
415
|
+
const { ok, data } = payload.returnValue!;
|
|
416
|
+
if (!ok) {
|
|
417
|
+
captureActionError(observability, data, id);
|
|
418
|
+
if (hooks.onActionError) {
|
|
419
|
+
try {
|
|
420
|
+
hooks.onActionError(data, id, hookContext);
|
|
421
|
+
} catch {
|
|
422
|
+
/* hook 抛错不影响主流程 */
|
|
423
|
+
}
|
|
424
|
+
}
|
|
425
|
+
throw data;
|
|
426
|
+
}
|
|
427
|
+
return data;
|
|
428
|
+
});
|
|
429
|
+
|
|
430
|
+
createRoot(document as unknown as Element).render(
|
|
431
|
+
React.createElement(
|
|
432
|
+
React.StrictMode,
|
|
433
|
+
null,
|
|
434
|
+
React.createElement(GlobalErrorBoundary, null, React.createElement(RscShellRoot))
|
|
435
|
+
)
|
|
436
|
+
);
|
|
437
|
+
schedulePostCommitInspectorInstall();
|
|
438
|
+
}
|
|
439
|
+
|
|
440
|
+
// SPA fallback:浏览器加载 dist/spa/index.html 触发,由部署层(Nginx/CDN)在 SSR 5xx 时切入
|
|
441
|
+
if ((globalThis as { __SPA_MODE__?: boolean }).__SPA_MODE__) {
|
|
442
|
+
mountRscShellFallback();
|
|
443
|
+
installInspector();
|
|
444
|
+
return;
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
// SSR 渲染抛异常的 csr-shell 兜底分支(与 __SPA_MODE__ 不同:这是 SSR 半死状态)
|
|
448
|
+
if ('__NO_HYDRATE' in globalThis) {
|
|
449
|
+
mountRscShellFallback();
|
|
450
|
+
installInspector();
|
|
451
|
+
return;
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
let setPayload: (v: DefaultRscPayloadState) => void = () => {};
|
|
455
|
+
const initialPayload = await createFromReadableStream<DefaultRscPayload>(rscStream);
|
|
456
|
+
setClientI18n(initialPayload.intl);
|
|
457
|
+
const initialStyleIds = import.meta.env.DEV ? await preparePayloadDevStyles(0) : [];
|
|
458
|
+
const initialPayloadState = createPayloadState(
|
|
459
|
+
initialPayload,
|
|
460
|
+
import.meta.env.DEV ? 0 : undefined,
|
|
461
|
+
initialStyleIds
|
|
462
|
+
);
|
|
463
|
+
|
|
464
|
+
function BrowserRoot(): React.ReactNode {
|
|
465
|
+
const [payloadState, setPayload_] = React.useState<DefaultRscPayloadState>(initialPayloadState);
|
|
466
|
+
React.useEffect(() => {
|
|
467
|
+
setPayload = v => React.startTransition(() => setPayload_(v));
|
|
468
|
+
}, [setPayload_]);
|
|
469
|
+
React.useEffect(() => {
|
|
470
|
+
const onNavigation = import.meta.env.DEV
|
|
471
|
+
? () => observeDevNavigationFailure(fetchRscPayload())
|
|
472
|
+
: () => {
|
|
473
|
+
const requestedUrl = window.location.href;
|
|
474
|
+
void fetchRscPayload().catch(error => {
|
|
475
|
+
console.error('RSC navigation failed; falling back to document navigation', error);
|
|
476
|
+
if (window.location.href === requestedUrl) window.location.assign(requestedUrl);
|
|
477
|
+
});
|
|
478
|
+
};
|
|
479
|
+
return listenNavigation(onNavigation, hooks.onNavigate, observability, hookContext);
|
|
480
|
+
}, []);
|
|
481
|
+
return renderPayloadRoot(payloadState);
|
|
482
|
+
}
|
|
483
|
+
|
|
484
|
+
async function fetchRscPayload(): Promise<void> {
|
|
485
|
+
await navigationRequests.run(async signal => {
|
|
486
|
+
await runWithDevStyleNavigation(
|
|
487
|
+
async generation => {
|
|
488
|
+
const renderRequest = createRscRenderRequest(
|
|
489
|
+
window.location.href,
|
|
490
|
+
undefined,
|
|
491
|
+
devStyleRequestOptions(generation)
|
|
492
|
+
);
|
|
493
|
+
return fetchRscResponse(new Request(renderRequest, { signal }));
|
|
494
|
+
},
|
|
495
|
+
({ payload, response, requestedUrl, styleIds }, generation) => {
|
|
496
|
+
// Keep every browser mutation behind the generation freshness check.
|
|
497
|
+
signal.throwIfAborted();
|
|
498
|
+
syncBrowserUrlToFinalRedirect(response, requestedUrl);
|
|
499
|
+
setClientI18n(payload.intl);
|
|
500
|
+
applySeoToDocument(payload.seoMeta, payload.siteBaseUrl ?? undefined);
|
|
501
|
+
setPayload(createPayloadState(payload, generation, styleIds));
|
|
502
|
+
},
|
|
503
|
+
async (result, generation) => {
|
|
504
|
+
signal.throwIfAborted();
|
|
505
|
+
await prepareFetchedDevStyles(result, generation);
|
|
506
|
+
signal.throwIfAborted();
|
|
507
|
+
}
|
|
508
|
+
);
|
|
509
|
+
});
|
|
510
|
+
}
|
|
511
|
+
|
|
512
|
+
setServerCallback(async (id: string, args: unknown[]) => {
|
|
513
|
+
const result = await runWithDevStyleNavigation(
|
|
514
|
+
async generation => {
|
|
515
|
+
const temporaryReferences = createTemporaryReferenceSet();
|
|
516
|
+
const renderRequest = createRscRenderRequest(
|
|
517
|
+
window.location.href,
|
|
518
|
+
{
|
|
519
|
+
id,
|
|
520
|
+
body: await encodeReply(args, { temporaryReferences }),
|
|
521
|
+
},
|
|
522
|
+
devStyleRequestOptions(generation)
|
|
523
|
+
);
|
|
524
|
+
return fetchRscResponse(renderRequest, temporaryReferences);
|
|
525
|
+
},
|
|
526
|
+
({ payload, styleIds }, generation) => {
|
|
527
|
+
setClientI18n(payload.intl);
|
|
528
|
+
applySeoToDocument(payload.seoMeta, payload.siteBaseUrl ?? undefined);
|
|
529
|
+
setPayload(createPayloadState(payload, generation, styleIds));
|
|
530
|
+
return payload;
|
|
531
|
+
},
|
|
532
|
+
prepareFetchedDevStyles
|
|
533
|
+
);
|
|
534
|
+
const payload = result.status === 'superseded' ? result.operationValue?.payload : result.value;
|
|
535
|
+
if (!payload) return undefined;
|
|
536
|
+
const { ok, data } = payload.returnValue!;
|
|
537
|
+
if (!ok) {
|
|
538
|
+
captureActionError(observability, data, id);
|
|
539
|
+
if (hooks.onActionError) {
|
|
540
|
+
try {
|
|
541
|
+
hooks.onActionError(data, id, hookContext);
|
|
542
|
+
} catch {
|
|
543
|
+
/* hook 抛错不影响主流程 */
|
|
544
|
+
}
|
|
545
|
+
}
|
|
546
|
+
throw data;
|
|
547
|
+
}
|
|
548
|
+
return data;
|
|
549
|
+
});
|
|
550
|
+
|
|
551
|
+
const browserRoot = (
|
|
552
|
+
<HydrationShell>
|
|
553
|
+
<BrowserRoot />
|
|
554
|
+
</HydrationShell>
|
|
555
|
+
);
|
|
556
|
+
|
|
557
|
+
// 注:csr-shell 路径已在 main 入口处早返回,这里只剩正常水合
|
|
558
|
+
hydrateRoot(document, browserRoot, { formState: initialPayload.formState });
|
|
559
|
+
installInspector();
|
|
560
|
+
schedulePostCommitInspectorInstall();
|
|
561
|
+
|
|
562
|
+
if (import.meta.hot) {
|
|
563
|
+
import.meta.hot.on('rsc:update', () => {
|
|
564
|
+
observeDevNavigationFailure(fetchRscPayload());
|
|
565
|
+
});
|
|
566
|
+
}
|
|
567
|
+
}
|
|
568
|
+
|
|
569
|
+
function observeDevNavigationFailure(operation: Promise<void>): void {
|
|
570
|
+
void operation.catch(error => {
|
|
571
|
+
const reportError = (globalThis as { reportError?: (error: unknown) => void }).reportError;
|
|
572
|
+
if (reportError) reportError(error);
|
|
573
|
+
else console.error(error);
|
|
574
|
+
});
|
|
575
|
+
}
|
|
576
|
+
|
|
577
|
+
function captureActionError(
|
|
578
|
+
observability: BrowserObservabilityHandle | null,
|
|
579
|
+
error: unknown,
|
|
580
|
+
actionId: string
|
|
581
|
+
): void {
|
|
582
|
+
try {
|
|
583
|
+
observability?.captureActionError(error, actionId);
|
|
584
|
+
} catch {
|
|
585
|
+
/* observability hook 抛错不影响 Server Action 语义 */
|
|
586
|
+
}
|
|
587
|
+
}
|
|
588
|
+
|
|
589
|
+
function listenNavigation(
|
|
590
|
+
onNavigation: () => void,
|
|
591
|
+
onNavigateHook?: (url: URL, ctx: ClientEntryHookContext) => void,
|
|
592
|
+
observability?: BrowserObservabilityHandle | null,
|
|
593
|
+
hookContext: ClientEntryHookContext = createHookContext(null)
|
|
594
|
+
): () => void {
|
|
595
|
+
let previousUrl = window.location.href;
|
|
596
|
+
const fire = () => {
|
|
597
|
+
const nextUrl = window.location.href;
|
|
598
|
+
const needsPayload = isRscNavigation(nextUrl, previousUrl);
|
|
599
|
+
previousUrl = nextUrl;
|
|
600
|
+
if (!needsPayload) return;
|
|
601
|
+
onNavigation();
|
|
602
|
+
const url = new URL(window.location.href);
|
|
603
|
+
try {
|
|
604
|
+
observability?.page(url);
|
|
605
|
+
} catch {
|
|
606
|
+
/* observability hook 抛错不影响导航 */
|
|
607
|
+
}
|
|
608
|
+
if (onNavigateHook) {
|
|
609
|
+
try {
|
|
610
|
+
onNavigateHook(url, hookContext);
|
|
611
|
+
} catch {
|
|
612
|
+
/* hook 抛错不影响主流程 */
|
|
613
|
+
}
|
|
614
|
+
}
|
|
615
|
+
};
|
|
616
|
+
|
|
617
|
+
window.addEventListener('popstate', fire);
|
|
618
|
+
|
|
619
|
+
const oldPushState = window.history.pushState;
|
|
620
|
+
window.history.pushState = function (...args) {
|
|
621
|
+
const res = oldPushState.apply(this, args);
|
|
622
|
+
if (isInternalNavigationHistoryMutation()) previousUrl = window.location.href;
|
|
623
|
+
else fire();
|
|
624
|
+
return res;
|
|
625
|
+
};
|
|
626
|
+
|
|
627
|
+
const oldReplaceState = window.history.replaceState;
|
|
628
|
+
window.history.replaceState = function (...args) {
|
|
629
|
+
const res = oldReplaceState.apply(this, args);
|
|
630
|
+
if (isInternalNavigationHistoryMutation()) previousUrl = window.location.href;
|
|
631
|
+
else fire();
|
|
632
|
+
return res;
|
|
633
|
+
};
|
|
634
|
+
|
|
635
|
+
function isInternalLink(link: HTMLAnchorElement): boolean {
|
|
636
|
+
return !!(
|
|
637
|
+
link.href &&
|
|
638
|
+
(!link.target || link.target === '_self') &&
|
|
639
|
+
link.origin === location.origin &&
|
|
640
|
+
!link.hasAttribute('download') &&
|
|
641
|
+
isRscNavigation(link.href, location.href)
|
|
642
|
+
);
|
|
643
|
+
}
|
|
644
|
+
|
|
645
|
+
function onClick(e: MouseEvent) {
|
|
646
|
+
const target = e.target;
|
|
647
|
+
if (!(target instanceof Element)) return;
|
|
648
|
+
const link = target.closest('a');
|
|
649
|
+
if (
|
|
650
|
+
link &&
|
|
651
|
+
link instanceof HTMLAnchorElement &&
|
|
652
|
+
isInternalLink(link) &&
|
|
653
|
+
e.button === 0 &&
|
|
654
|
+
!e.metaKey &&
|
|
655
|
+
!e.ctrlKey &&
|
|
656
|
+
!e.altKey &&
|
|
657
|
+
!e.shiftKey &&
|
|
658
|
+
!e.defaultPrevented
|
|
659
|
+
) {
|
|
660
|
+
e.preventDefault();
|
|
661
|
+
history.pushState(null, '', link.href);
|
|
662
|
+
}
|
|
663
|
+
}
|
|
664
|
+
document.addEventListener('click', onClick);
|
|
665
|
+
|
|
666
|
+
// ─── 链接预取(hover / viewport intersect 触发预取 _.rsc)─────────
|
|
667
|
+
// 复用浏览器的 RSC fetch 缓存,导航时立即命中而不是再发请求
|
|
668
|
+
// 减少 50–150ms 客户端导航延迟,对应 next/link 的 prefetch 默认行为
|
|
669
|
+
// 视口预取有硬上限:列表页/首页可能一次渲染几十个链接,不能把低优先级预取消耗成
|
|
670
|
+
// 大量真实 RSC 请求,进而挤占用户交互和应用层限流配额。
|
|
671
|
+
const maxViewportPrefetches = 12;
|
|
672
|
+
let viewportPrefetches = 0;
|
|
673
|
+
const fetchPrefetch = createPrefetcher(url => fetch(url, { priority: 'low' } as RequestInit));
|
|
674
|
+
|
|
675
|
+
function shouldPrefetch(link: HTMLAnchorElement, reason: 'intent' | 'viewport'): boolean {
|
|
676
|
+
const connection = (navigator as Navigator & { connection?: PrefetchConnection }).connection;
|
|
677
|
+
return (
|
|
678
|
+
isInternalLink(link) &&
|
|
679
|
+
canPrefetch(link.href, location.href, link.dataset.prefetch, reason, connection)
|
|
680
|
+
);
|
|
681
|
+
}
|
|
682
|
+
|
|
683
|
+
function prefetch(link: HTMLAnchorElement, reason: 'intent' | 'viewport'): void {
|
|
684
|
+
if (!shouldPrefetch(link, reason)) return;
|
|
685
|
+
if (reason === 'viewport') {
|
|
686
|
+
if (viewportPrefetches >= maxViewportPrefetches) return;
|
|
687
|
+
viewportPrefetches += 1;
|
|
688
|
+
}
|
|
689
|
+
void fetchPrefetch(link.href);
|
|
690
|
+
}
|
|
691
|
+
|
|
692
|
+
function onPointerEnter(e: Event) {
|
|
693
|
+
const target = e.target;
|
|
694
|
+
if (!(target instanceof Element)) return;
|
|
695
|
+
const link = target.closest('a');
|
|
696
|
+
if (link && link instanceof HTMLAnchorElement) {
|
|
697
|
+
prefetch(link, 'intent');
|
|
698
|
+
}
|
|
699
|
+
}
|
|
700
|
+
document.addEventListener('pointerenter', onPointerEnter, { capture: true });
|
|
701
|
+
document.addEventListener('focusin', onPointerEnter);
|
|
702
|
+
|
|
703
|
+
// viewport 内可见时预取 —— 用 IntersectionObserver 监视所有内部链接
|
|
704
|
+
let observer: IntersectionObserver | null = null;
|
|
705
|
+
let mutationObserver: MutationObserver | null = null;
|
|
706
|
+
if (typeof IntersectionObserver !== 'undefined') {
|
|
707
|
+
observer = new IntersectionObserver(
|
|
708
|
+
entries => {
|
|
709
|
+
for (const entry of entries) {
|
|
710
|
+
if (entry.isIntersecting && entry.target instanceof HTMLAnchorElement) {
|
|
711
|
+
prefetch(entry.target, 'viewport');
|
|
712
|
+
observer!.unobserve(entry.target);
|
|
713
|
+
}
|
|
714
|
+
}
|
|
715
|
+
},
|
|
716
|
+
{ rootMargin: '200px' }
|
|
717
|
+
);
|
|
718
|
+
// 初始扫描 + MutationObserver 跟踪后续 DOM 变化
|
|
719
|
+
const scan = (root: ParentNode) => {
|
|
720
|
+
if (root instanceof HTMLAnchorElement && shouldPrefetch(root, 'viewport'))
|
|
721
|
+
observer!.observe(root);
|
|
722
|
+
root.querySelectorAll('a').forEach(a => {
|
|
723
|
+
if (a instanceof HTMLAnchorElement && shouldPrefetch(a, 'viewport')) observer!.observe(a);
|
|
724
|
+
});
|
|
725
|
+
};
|
|
726
|
+
scan(document);
|
|
727
|
+
mutationObserver = new MutationObserver(records => {
|
|
728
|
+
for (const r of records) {
|
|
729
|
+
r.addedNodes.forEach(n => {
|
|
730
|
+
if (n instanceof Element) scan(n);
|
|
731
|
+
});
|
|
732
|
+
}
|
|
733
|
+
});
|
|
734
|
+
mutationObserver.observe(document.body, { childList: true, subtree: true });
|
|
735
|
+
}
|
|
736
|
+
|
|
737
|
+
return () => {
|
|
738
|
+
document.removeEventListener('click', onClick);
|
|
739
|
+
document.removeEventListener('pointerenter', onPointerEnter, { capture: true });
|
|
740
|
+
document.removeEventListener('focusin', onPointerEnter);
|
|
741
|
+
observer?.disconnect();
|
|
742
|
+
mutationObserver?.disconnect();
|
|
743
|
+
window.removeEventListener('popstate', fire);
|
|
744
|
+
window.history.pushState = oldPushState;
|
|
745
|
+
window.history.replaceState = oldReplaceState;
|
|
746
|
+
};
|
|
747
|
+
}
|
|
748
|
+
|
|
749
|
+
function createHookContext(
|
|
750
|
+
observability: BrowserObservabilityHandle | null
|
|
751
|
+
): ClientEntryHookContext {
|
|
752
|
+
return {
|
|
753
|
+
telemetry: observability
|
|
754
|
+
? {
|
|
755
|
+
track: observability.track.bind(observability),
|
|
756
|
+
capture: observability.capture.bind(observability),
|
|
757
|
+
measure: observability.measure.bind(observability),
|
|
758
|
+
page: observability.page.bind(observability),
|
|
759
|
+
setUser: observability.setUser.bind(observability),
|
|
760
|
+
flush: observability.flush.bind(observability),
|
|
761
|
+
}
|
|
762
|
+
: NOOP_TELEMETRY,
|
|
763
|
+
};
|
|
764
|
+
}
|
|
765
|
+
|
|
766
|
+
const NOOP_TELEMETRY: ClientEntryTelemetryApi = {
|
|
767
|
+
track() {},
|
|
768
|
+
capture() {},
|
|
769
|
+
measure() {},
|
|
770
|
+
page() {},
|
|
771
|
+
setUser() {},
|
|
772
|
+
flush() {},
|
|
773
|
+
};
|