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,421 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* defineServerEntry —— FaaS 风格的服务端入口工厂
|
|
3
|
+
*
|
|
4
|
+
* 用户态写法(覆盖 engine 默认行为):
|
|
5
|
+
*
|
|
6
|
+
* // src/entry.server.tsx
|
|
7
|
+
* import { defineServerEntry } from 'isr-engine/server-entry';
|
|
8
|
+
* export default defineServerEntry({
|
|
9
|
+
* beforeRequest: (req) => ({ traceId: crypto.randomUUID() }),
|
|
10
|
+
* onResponse: (res, ctx) => res.headers.set('x-trace-id', ctx.traceId),
|
|
11
|
+
* onError: (err) => console.error('render failed', err),
|
|
12
|
+
* });
|
|
13
|
+
*
|
|
14
|
+
* 不传任何 hook 时(engine 默认入口的写法):
|
|
15
|
+
*
|
|
16
|
+
* export default defineServerEntry(); // 一行搞定
|
|
17
|
+
*
|
|
18
|
+
* Hook 之外的全部协议细节(RSC / Server Action / SSR loadModule / csr-shell 透传)
|
|
19
|
+
* 由本工厂内部固化实现,用户**不需要**了解或重写。
|
|
20
|
+
*/
|
|
21
|
+
import {
|
|
22
|
+
createTemporaryReferenceSet,
|
|
23
|
+
decodeAction,
|
|
24
|
+
decodeFormState,
|
|
25
|
+
decodeReply,
|
|
26
|
+
loadServerAction,
|
|
27
|
+
renderToReadableStream,
|
|
28
|
+
} from '@vitejs/plugin-rsc/rsc';
|
|
29
|
+
import type { ReactFormState } from 'react-dom/client';
|
|
30
|
+
|
|
31
|
+
// @ts-expect-error - @app 别名在 createIsrPlugin 注入;指向用户的 src/app.tsx
|
|
32
|
+
import { App } from '@app/_entry';
|
|
33
|
+
// @app 别名在 createIsrPlugin 注入;评估用户 src/routes.tsx 以注册 page-level SEO
|
|
34
|
+
import '@app/_routes';
|
|
35
|
+
|
|
36
|
+
import { parseRenderRequest } from './request';
|
|
37
|
+
import {
|
|
38
|
+
declareDevClientReferenceStyles,
|
|
39
|
+
runWithDevStyleDeclarationCollection,
|
|
40
|
+
} from './dev-style-declarations.server';
|
|
41
|
+
import { type IntlPayload, type PageSeoMeta, injectSeoMeta, mergePageSeoMeta } from './seo-runtime';
|
|
42
|
+
import { injectHeadExtras } from './head-extras-runtime';
|
|
43
|
+
import { runWithI18n } from './i18n-server';
|
|
44
|
+
import { resolvePageSeoMeta } from '../../runtime/routes';
|
|
45
|
+
import { getRequestContext } from '../../context/RequestContext';
|
|
46
|
+
|
|
47
|
+
interface DefaultRscPayload {
|
|
48
|
+
root: React.ReactNode;
|
|
49
|
+
intl?: IntlPayload | null;
|
|
50
|
+
/**
|
|
51
|
+
* 页面 SEO meta —— 与 intl 对齐的客户端 head 同步通道。
|
|
52
|
+
* 首屏 SSR 通过 injectSeoMeta 把 meta 注入到 HTML 流;客户端 RSC 导航时
|
|
53
|
+
* 单独从 payload 读出来调用 applySeoToDocument 同步 document.title / meta /
|
|
54
|
+
* canonical / og:* / jsonLd —— 不然点链接进新页面 title 不变(hint:上次
|
|
55
|
+
* SSR 注入的 head 不会跟着 React 树重渲染)。
|
|
56
|
+
*/
|
|
57
|
+
seoMeta?: PageSeoMeta | null;
|
|
58
|
+
/** 客户端 applySeoToDocument 用来把 canonical / og:image 转绝对 URL */
|
|
59
|
+
siteBaseUrl?: string | null;
|
|
60
|
+
returnValue?: { ok: boolean; data: unknown };
|
|
61
|
+
formState?: ReactFormState;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** 默认始终注入的请求上下文 —— engine 自动维护,不需要用户写代码 */
|
|
65
|
+
export interface EngineRequestContext {
|
|
66
|
+
/** trace-id:从入站头 X-Request-Id / X-Trace-Id 读取,没有则自动生成 */
|
|
67
|
+
traceId: string;
|
|
68
|
+
/** 请求处理起点(毫秒)—— 用于自动算 X-Render-Ms */
|
|
69
|
+
startedAt: number;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** 用户 hook 之间共享的请求级上下文(engine 字段 + 用户扩展) */
|
|
73
|
+
export type ServerCtx = EngineRequestContext & Record<string, unknown>;
|
|
74
|
+
|
|
75
|
+
export interface ServerEntryHooks<C extends ServerCtx = ServerCtx> {
|
|
76
|
+
/**
|
|
77
|
+
* 站点根 URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL
|
|
78
|
+
* defineSiteHooks 自动从 site 字段填入;用户也可手动设
|
|
79
|
+
*/
|
|
80
|
+
siteBaseUrl?: string;
|
|
81
|
+
/**
|
|
82
|
+
* 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__
|
|
83
|
+
* defineSiteHooks 自动从 api 字段填入;CSR fallback 的 loader 用此 URL 拉数据
|
|
84
|
+
*/
|
|
85
|
+
apiBaseUrl?: string;
|
|
86
|
+
/**
|
|
87
|
+
* 请求进入时调用 —— 返回的对象**与 engine 请求上下文合并**作为后续 hook 的 ctx,
|
|
88
|
+
* 同时同步到 RequestContext,Server Component 可用 getRequestContext() 读取。
|
|
89
|
+
*
|
|
90
|
+
* 适用:
|
|
91
|
+
* - 从 header / cookie 解析 userId。
|
|
92
|
+
* - 从域名 / header / 路径解析 tenantId。
|
|
93
|
+
* - 注入 requestSegment、渠道、风控或审计字段。
|
|
94
|
+
*
|
|
95
|
+
* 注意:trace-id 和 startedAt 由 engine 自动维护,**不需要**在这里手动设
|
|
96
|
+
* 注意:A/B variant 由 runtime.experiments + middleware 注入,页面用 getVariant()。
|
|
97
|
+
* 不要在这里解析 ab cookie 或做慢 API / 数据库查询。
|
|
98
|
+
*/
|
|
99
|
+
beforeRequest?: (
|
|
100
|
+
request: Request,
|
|
101
|
+
engineCtx: EngineRequestContext
|
|
102
|
+
) => Partial<C> | Promise<Partial<C>>;
|
|
103
|
+
/**
|
|
104
|
+
* Response 返回前调用 —— 用于追加自定义响应头
|
|
105
|
+
*
|
|
106
|
+
* 注意:x-trace-id 和 x-render-ms 由 engine 自动注入,**不需要**在这里手动加
|
|
107
|
+
*/
|
|
108
|
+
onResponse?: (response: Response, ctx: C) => void | Promise<void>;
|
|
109
|
+
/**
|
|
110
|
+
* 渲染抛错时调用 —— 用于上报 / 打点;engine 仍会按 FallbackChain 走 csr-shell
|
|
111
|
+
* 不要在这里返回 Response —— 兜底由 engine 处理
|
|
112
|
+
*/
|
|
113
|
+
onError?: (error: unknown, request: Request, ctx: C) => void | Promise<void>;
|
|
114
|
+
/**
|
|
115
|
+
* 单页 i18n 数据加载器 —— 返回值经 RSC payload 序列化到客户端
|
|
116
|
+
*
|
|
117
|
+
* - 返回 null/undefined 时跳过(无 i18n)
|
|
118
|
+
* - engine 把结果作为 `intl` prop 传给 App,并写入 ctx.intl
|
|
119
|
+
* - 推荐用 createCachedFetcher 包装远程 URL;本地 JSON 直接 `import()` 即可
|
|
120
|
+
*
|
|
121
|
+
* @example
|
|
122
|
+
* loadIntl: async (req, ctx) => {
|
|
123
|
+
* const locale = req.headers.get('accept-language')?.split(',')[0] ?? 'en';
|
|
124
|
+
* return loadMessagesCached({ locale }); // 见 createCachedFetcher
|
|
125
|
+
* }
|
|
126
|
+
*/
|
|
127
|
+
loadIntl?: (
|
|
128
|
+
request: Request,
|
|
129
|
+
ctx: C
|
|
130
|
+
) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;
|
|
131
|
+
/**
|
|
132
|
+
* 单页 SEO 元数据加载器 —— engine 在 SSR HTML <head> 里自动注入对应标签
|
|
133
|
+
*
|
|
134
|
+
* - 返回 null/undefined 时不注入(保留 SSR 默认 head)
|
|
135
|
+
* - 用户**不需要**在自己的组件里写 <title>/<meta>
|
|
136
|
+
*
|
|
137
|
+
* @example
|
|
138
|
+
* loadSeoMeta: async (req) => {
|
|
139
|
+
* const url = new URL(req.url);
|
|
140
|
+
* if (url.pathname.startsWith('/books/')) {
|
|
141
|
+
* const book = await fetchBookCached(url.pathname.split('/')[2]);
|
|
142
|
+
* return { title: book.title, description: book.summary, image: book.cover };
|
|
143
|
+
* }
|
|
144
|
+
* return null;
|
|
145
|
+
* }
|
|
146
|
+
*/
|
|
147
|
+
loadSeoMeta?: (
|
|
148
|
+
request: Request,
|
|
149
|
+
ctx: C
|
|
150
|
+
) => PageSeoMeta | null | undefined | Promise<PageSeoMeta | null | undefined>;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
export interface ServerEntryModule {
|
|
154
|
+
fetch: (request: Request) => Promise<Response>;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** 生成一个紧凑的 trace-id(10 位 base36,约 2^52 / 1e6 = 4.5T 条不重碰)*/
|
|
158
|
+
function genTraceId(): string {
|
|
159
|
+
return `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
export function defineServerEntry<C extends ServerCtx = ServerCtx>(
|
|
163
|
+
hooks: ServerEntryHooks<C> = {}
|
|
164
|
+
): ServerEntryModule {
|
|
165
|
+
return {
|
|
166
|
+
async fetch(request) {
|
|
167
|
+
const requestStore = getRequestContext();
|
|
168
|
+
|
|
169
|
+
// ─── engine request context(每个请求自动有)───────────────
|
|
170
|
+
const engineCtx: EngineRequestContext = {
|
|
171
|
+
traceId:
|
|
172
|
+
request.headers.get('x-request-id') ||
|
|
173
|
+
request.headers.get('x-trace-id') ||
|
|
174
|
+
requestStore?.traceId ||
|
|
175
|
+
genTraceId(),
|
|
176
|
+
startedAt: Date.now(),
|
|
177
|
+
};
|
|
178
|
+
let ctx: C = { ...(requestStore ?? {}), ...engineCtx } as C;
|
|
179
|
+
|
|
180
|
+
try {
|
|
181
|
+
if (hooks.beforeRequest) {
|
|
182
|
+
const userExt = (await hooks.beforeRequest(request, engineCtx)) ?? {};
|
|
183
|
+
ctx = { ...(requestStore ?? {}), ...engineCtx, ...userExt } as C;
|
|
184
|
+
}
|
|
185
|
+
if (requestStore) {
|
|
186
|
+
Object.assign(requestStore, ctx);
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
// ─── i18n 先加载并进入请求作用域;SEO 可在 page seo 中直接 getI18n() ─────
|
|
190
|
+
const intl = hooks.loadIntl ? await Promise.resolve(hooks.loadIntl(request, ctx)) : null;
|
|
191
|
+
if (intl) {
|
|
192
|
+
(ctx as ServerCtx).intl = intl;
|
|
193
|
+
if (requestStore) {
|
|
194
|
+
requestStore.intl = intl;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
const seoMeta = await runWithI18n(intl, async () => {
|
|
199
|
+
// 双 strip:
|
|
200
|
+
// 1) _.rsc 后缀(RSC 客户端导航 URL 携带)—— 不剥的话 /books/1_.rsc
|
|
201
|
+
// 永远 match 不到 /books/:id 路由 → seoMeta=null → applySeoToDocument
|
|
202
|
+
// no-op,客户端导航后 head 不更新。
|
|
203
|
+
// 2) locale 前缀(i18n.prefixDefault=true 时所有 URL 都带)—— pages 注册的
|
|
204
|
+
// route 是业务规范路径('/'、'/books/:id'),不含 locale;不剥的话
|
|
205
|
+
// /zh-CN/books/1 也匹配不到。
|
|
206
|
+
const url = new URL(request.url);
|
|
207
|
+
if (url.pathname.endsWith('_.rsc')) {
|
|
208
|
+
url.pathname = url.pathname.slice(0, -'_.rsc'.length);
|
|
209
|
+
}
|
|
210
|
+
let localePrefix = '';
|
|
211
|
+
if (intl?.locale) {
|
|
212
|
+
localePrefix = `/${intl.locale}`;
|
|
213
|
+
if (url.pathname === localePrefix) {
|
|
214
|
+
url.pathname = '/';
|
|
215
|
+
} else if (url.pathname.startsWith(`${localePrefix}/`)) {
|
|
216
|
+
url.pathname = url.pathname.slice(localePrefix.length);
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
const [pageSeoMeta, hookSeoMeta] = await Promise.all([
|
|
220
|
+
resolvePageSeoMeta(url),
|
|
221
|
+
hooks.loadSeoMeta
|
|
222
|
+
? Promise.resolve(hooks.loadSeoMeta(request, ctx))
|
|
223
|
+
: Promise.resolve(null),
|
|
224
|
+
]);
|
|
225
|
+
const merged = mergePageSeoMeta(pageSeoMeta, hookSeoMeta);
|
|
226
|
+
// 多语言 canonical 修正:admin 存的 canonical 是规范路径(无 locale),
|
|
227
|
+
// 但页面真实 URL 含 locale 前缀。两个 locale 渲染同一个 canonical →
|
|
228
|
+
// Google 判跨语言 URL 互为重复,只索引根域那一份,其它 locale SEO 死。
|
|
229
|
+
// 这里把当前 locale 前缀重新加回相对 canonical 路径,让每个 locale 的
|
|
230
|
+
// 页面声明自己为 canonical(业界标准多语言 SEO 做法)。
|
|
231
|
+
if (merged && localePrefix && merged.canonical?.startsWith('/')) {
|
|
232
|
+
merged.canonical =
|
|
233
|
+
merged.canonical === '/' ? `${localePrefix}/` : `${localePrefix}${merged.canonical}`;
|
|
234
|
+
}
|
|
235
|
+
return merged;
|
|
236
|
+
});
|
|
237
|
+
if (seoMeta) (ctx as ServerCtx).seoMeta = seoMeta;
|
|
238
|
+
|
|
239
|
+
// headExtras hook 容错:抛错不应阻塞 SSR(业务侧返回值类型 unknown 时安全降级)。
|
|
240
|
+
// 把当前请求的 CSP nonce 透传给业务,让 inline <script> 能带 nonce 通过 CSP。
|
|
241
|
+
let headExtras: string | undefined;
|
|
242
|
+
try {
|
|
243
|
+
const headExtrasNonce = request.headers.get('x-csp-nonce') ?? undefined;
|
|
244
|
+
const raw = hooks.headExtras?.({ nonce: headExtrasNonce });
|
|
245
|
+
if (typeof raw === 'string' && raw.length > 0) headExtras = raw;
|
|
246
|
+
} catch {
|
|
247
|
+
// 业务 hook 异常 → 当作没有 headExtras,继续渲染
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
const response = await runWithI18n(intl, () =>
|
|
251
|
+
runRscPipeline(request, {
|
|
252
|
+
intl,
|
|
253
|
+
seoMeta,
|
|
254
|
+
siteBaseUrl: hooks.siteBaseUrl,
|
|
255
|
+
apiBaseUrl: hooks.apiBaseUrl,
|
|
256
|
+
headExtras,
|
|
257
|
+
})
|
|
258
|
+
);
|
|
259
|
+
|
|
260
|
+
// ─── 自动注入观测头(用户无需写代码)──────────────────
|
|
261
|
+
response.headers.set('x-trace-id', engineCtx.traceId);
|
|
262
|
+
response.headers.set('x-render-ms', String(Date.now() - engineCtx.startedAt));
|
|
263
|
+
if (intl?.locale) response.headers.set('content-language', intl.locale);
|
|
264
|
+
if (intl?.source) response.headers.set('x-i18n-source', intl.source);
|
|
265
|
+
|
|
266
|
+
if (hooks.onResponse) {
|
|
267
|
+
await hooks.onResponse(response, ctx);
|
|
268
|
+
}
|
|
269
|
+
return response;
|
|
270
|
+
} catch (err) {
|
|
271
|
+
if (hooks.onError) {
|
|
272
|
+
try {
|
|
273
|
+
await hooks.onError(err, request, ctx);
|
|
274
|
+
} catch {
|
|
275
|
+
/* hook 内部抛错不能影响兜底 */
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
throw err;
|
|
279
|
+
}
|
|
280
|
+
},
|
|
281
|
+
};
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
interface PipelineExtras {
|
|
285
|
+
intl: IntlPayload | null | undefined;
|
|
286
|
+
seoMeta: PageSeoMeta | null | undefined;
|
|
287
|
+
siteBaseUrl?: string;
|
|
288
|
+
apiBaseUrl?: string;
|
|
289
|
+
/** 注入 `<head>` 末尾的 raw HTML(业务侧 site-hooks.headExtras() 的返回值) */
|
|
290
|
+
headExtras?: string;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** 内部固化的 RSC + SSR 协议流水线 —— 用户不可见 */
|
|
294
|
+
async function runRscPipeline(request: Request, extras: PipelineExtras): Promise<Response> {
|
|
295
|
+
const renderRequest = parseRenderRequest(request);
|
|
296
|
+
request = renderRequest.request;
|
|
297
|
+
|
|
298
|
+
let returnValue: DefaultRscPayload['returnValue'] | undefined;
|
|
299
|
+
let formState: ReactFormState | undefined;
|
|
300
|
+
let temporaryReferences: unknown | undefined;
|
|
301
|
+
let actionStatus: number | undefined;
|
|
302
|
+
|
|
303
|
+
if (renderRequest.isAction) {
|
|
304
|
+
if (renderRequest.actionId) {
|
|
305
|
+
const contentType = request.headers.get('content-type');
|
|
306
|
+
const body = contentType?.startsWith('multipart/form-data')
|
|
307
|
+
? await request.formData()
|
|
308
|
+
: await request.text();
|
|
309
|
+
temporaryReferences = createTemporaryReferenceSet();
|
|
310
|
+
const args = await decodeReply(body, { temporaryReferences });
|
|
311
|
+
const action = await loadServerAction(renderRequest.actionId);
|
|
312
|
+
try {
|
|
313
|
+
const data = await action.apply(null, args);
|
|
314
|
+
returnValue = { ok: true, data };
|
|
315
|
+
} catch (e) {
|
|
316
|
+
returnValue = { ok: false, data: e };
|
|
317
|
+
actionStatus = 500;
|
|
318
|
+
}
|
|
319
|
+
} else {
|
|
320
|
+
const formData = await request.formData();
|
|
321
|
+
const decodedAction = await decodeAction(formData);
|
|
322
|
+
try {
|
|
323
|
+
const result = await decodedAction();
|
|
324
|
+
formState = await decodeFormState(result, formData);
|
|
325
|
+
} catch {
|
|
326
|
+
return new Response('Internal Server Error: server action failed', { status: 500 });
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
const devStyleDeclarations = import.meta.env.DEV ? [] : undefined;
|
|
332
|
+
const rscPayload: DefaultRscPayload = {
|
|
333
|
+
root: <App url={renderRequest.url} intl={extras.intl ?? undefined} />,
|
|
334
|
+
intl: extras.intl ?? null,
|
|
335
|
+
seoMeta: extras.seoMeta ?? null,
|
|
336
|
+
siteBaseUrl: extras.siteBaseUrl ?? null,
|
|
337
|
+
formState,
|
|
338
|
+
returnValue,
|
|
339
|
+
};
|
|
340
|
+
const rscStream = import.meta.env.DEV
|
|
341
|
+
? runWithDevStyleDeclarationCollection(
|
|
342
|
+
devStyleDeclarations!,
|
|
343
|
+
() =>
|
|
344
|
+
renderToReadableStream<DefaultRscPayload>(
|
|
345
|
+
rscPayload,
|
|
346
|
+
{ temporaryReferences },
|
|
347
|
+
{
|
|
348
|
+
onClientReference: declareDevClientReferenceStyles,
|
|
349
|
+
}
|
|
350
|
+
),
|
|
351
|
+
{ transportGeneration: renderRequest.devStyleGeneration }
|
|
352
|
+
)
|
|
353
|
+
: renderToReadableStream<DefaultRscPayload>(rscPayload, { temporaryReferences });
|
|
354
|
+
|
|
355
|
+
if (renderRequest.isRsc) {
|
|
356
|
+
return new Response(rscStream, {
|
|
357
|
+
status: actionStatus,
|
|
358
|
+
headers: { 'content-type': 'text/x-component;charset=utf-8' },
|
|
359
|
+
});
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
interface SsrModule {
|
|
363
|
+
renderHTML: (
|
|
364
|
+
rscStream: ReadableStream<Uint8Array>,
|
|
365
|
+
options: {
|
|
366
|
+
formState?: ReactFormState;
|
|
367
|
+
nonce?: string;
|
|
368
|
+
debugNojs?: boolean;
|
|
369
|
+
forceCsrShell?: boolean;
|
|
370
|
+
apiBaseUrl?: string;
|
|
371
|
+
}
|
|
372
|
+
) => Promise<{
|
|
373
|
+
stream: ReadableStream<Uint8Array>;
|
|
374
|
+
status?: number;
|
|
375
|
+
csrShellFallback?: boolean;
|
|
376
|
+
}>;
|
|
377
|
+
}
|
|
378
|
+
const ssrEntry = await import.meta.viteRsc.loadModule<SsrModule>('ssr', 'index');
|
|
379
|
+
|
|
380
|
+
// CSP nonce —— 由上游 createCspNonceMiddleware 生成并写到 req header 'x-csp-nonce'。
|
|
381
|
+
// React 19 renderToReadableStream 接 nonce 选项后,自动给所有内联 script (RSC payload、
|
|
382
|
+
// bootstrap、metadata) 打 nonce 属性。再配合 helmet CSP `script-src 'nonce-XXX'`,
|
|
383
|
+
// 整套 nonce-based CSP 闭环;Lighthouse csp-xss 不再判 'unsafe-inline' 高危。
|
|
384
|
+
const cspNonce = request.headers.get('x-csp-nonce') ?? undefined;
|
|
385
|
+
|
|
386
|
+
const ssrResult = await ssrEntry.renderHTML(rscStream, {
|
|
387
|
+
formState,
|
|
388
|
+
nonce: cspNonce,
|
|
389
|
+
debugNojs: renderRequest.url.searchParams.has('__nojs'),
|
|
390
|
+
forceCsrShell: renderRequest.url.searchParams.has('__csr-shell'),
|
|
391
|
+
apiBaseUrl: extras.apiBaseUrl,
|
|
392
|
+
});
|
|
393
|
+
|
|
394
|
+
const responseHeaders = new Headers();
|
|
395
|
+
responseHeaders.set('content-type', 'text/html; charset=utf-8');
|
|
396
|
+
responseHeaders.set('x-render-strategy', ssrResult.csrShellFallback ? 'csr-shell' : 'rsc-ssr');
|
|
397
|
+
responseHeaders.set('x-fallback-used', ssrResult.csrShellFallback ? 'true' : 'false');
|
|
398
|
+
if (ssrResult.csrShellFallback) {
|
|
399
|
+
responseHeaders.set('x-fallback-target', 'client createRoot fallback shell');
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
// SSR HTML stream pipeline —— 仅在非 csr-shell 兜底时注入(csr-shell 的 head 已固化):
|
|
403
|
+
// 1. SEO meta 抢首位(紧跟 `<head>` 开标签)—— 浏览器对 `<title>` 单值标签只取第一个
|
|
404
|
+
// 2. headExtras 末尾插入(`</head>` 之前)—— 业务侧 site-hooks.headExtras() 返回的
|
|
405
|
+
// raw HTML,典型是 theme init inline blocking script、GA snippet 等
|
|
406
|
+
// 两者都脱离 React 树,不进 client RSC payload,不会触发 hydration mismatch。
|
|
407
|
+
let finalStream = ssrResult.stream;
|
|
408
|
+
if (!ssrResult.csrShellFallback) {
|
|
409
|
+
if (extras.seoMeta) {
|
|
410
|
+
finalStream = injectSeoMeta(finalStream, extras.seoMeta, extras.siteBaseUrl);
|
|
411
|
+
}
|
|
412
|
+
if (extras.headExtras) {
|
|
413
|
+
finalStream = injectHeadExtras(finalStream, extras.headExtras);
|
|
414
|
+
}
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
return new Response(finalStream, {
|
|
418
|
+
status: ssrResult.status,
|
|
419
|
+
headers: responseHeaders,
|
|
420
|
+
});
|
|
421
|
+
}
|