isr-engine 0.0.0-stage → 2.6.21
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 +694 -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-Byzz8ZlU.cjs +105 -0
- package/dist/createCacheInspectorMiddleware-Byzz8ZlU.cjs.map +1 -0
- package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js +105 -0
- package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js.map +1 -0
- package/dist/createISRApp-C9Bezuit.cjs +7663 -0
- package/dist/createISRApp-C9Bezuit.cjs.map +1 -0
- package/dist/createISRApp-CylUYiIU.js +7322 -0
- package/dist/createISRApp-CylUYiIU.js.map +1 -0
- package/dist/createImagePlugin-_ntL0DcT.js +416 -0
- package/dist/createImagePlugin-_ntL0DcT.js.map +1 -0
- package/dist/createImagePlugin-birVNynL.cjs +435 -0
- package/dist/createImagePlugin-birVNynL.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 +200 -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 +839 -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 +42 -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 +512 -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 +19 -0
- package/src/utils/trimTrailingSlashes.ts +6 -0
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import type { ViteDevServer } from 'vite';
|
|
2
|
+
import type { RenderModeType } from './ISRConfig';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* 请求上下文数据 —— engine 内部 + 业务 hook 写入的字段。
|
|
6
|
+
*
|
|
7
|
+
* 设计原则:只放"被多处消费"的字段。一次性的(如 acceptLanguage / referer)engine
|
|
8
|
+
* 直接读 req.headers,不复制到 ctx;trace 快照同样直接读 req.headers,不依赖 ctx。
|
|
9
|
+
*
|
|
10
|
+
* 已删除的字段(声明但无消费者,纯死代码):
|
|
11
|
+
* - forceMode / forceFallback / bypassCache:dev 调试 URL 参数曾计划走这里,
|
|
12
|
+
* 现在 plugin-rsc / engine cache 都直接读 query string,没人读这三个字段
|
|
13
|
+
* - seo:声明了但 engine SEO 路径用 PageSeoMeta(独立类型),不走这里
|
|
14
|
+
* - acceptLanguage / referer:曾写到 ctx 给 trace 用,trace 改读 req.headers 后
|
|
15
|
+
* 这两个 ctx 字段就再无消费者
|
|
16
|
+
*/
|
|
17
|
+
export interface ISRContextData {
|
|
18
|
+
/** W3C trace-context traceparent 或自生成 UUID;用作 cross-service 追踪 + admin 排障索引 */
|
|
19
|
+
traceId: string;
|
|
20
|
+
/** 单服务的请求 ID;写到响应头 x-request-id 给客户端 / 客户端日志关联用 */
|
|
21
|
+
requestId: string;
|
|
22
|
+
/**
|
|
23
|
+
* 浏览器 / 设备维度的稳定 ID —— 由 engine 入口中间件保证非空:
|
|
24
|
+
* - cookie `anon` 存在 → 读取作 anonId
|
|
25
|
+
* - 缺失 → randomUUID() 生成,并通过 res.appendHeader('Set-Cookie', ...) 落 cookie
|
|
26
|
+
*
|
|
27
|
+
* 作用:
|
|
28
|
+
* 1. A/B 实验确定性分桶(hash(anonId + expKey) → variant,无需 sticky 变体 cookie)
|
|
29
|
+
* 2. telemetry / error reporting 按用户聚合(跨 session、跨设备唯一)
|
|
30
|
+
* 3. 个性化推荐 / 浏览历史等 lightweight 场景的 server-side 锚点
|
|
31
|
+
*
|
|
32
|
+
* 不是 session token、不是 userId、不识别身份;GDPR 语境下属于"persistent identifier",
|
|
33
|
+
* 业务侧若要 EU 合规需在 cookie consent 前不写。
|
|
34
|
+
*/
|
|
35
|
+
anonId: string;
|
|
36
|
+
/** 已登录用户 ID(业务侧 beforeRequest 写入,Server Component / Server Action 消费) */
|
|
37
|
+
userId?: string;
|
|
38
|
+
/**
|
|
39
|
+
* 鉴权 token(cookie / header 解出);engine 不读不写,业务侧 Server Action
|
|
40
|
+
* 透传给后端 API 做鉴权。
|
|
41
|
+
*/
|
|
42
|
+
sessionToken?: string;
|
|
43
|
+
/**
|
|
44
|
+
* 用户 session 摘要(displayName / handle / avatar 等)。业务侧 Server Component
|
|
45
|
+
* 直接读这里来拼 UI,避免每个 RSC 重新拉一次 user info。
|
|
46
|
+
*/
|
|
47
|
+
sessionUser?: { userId?: string; displayName?: string; handle?: string; [key: string]: unknown };
|
|
48
|
+
/**
|
|
49
|
+
* 解析后的 Cookie 表 —— 由 engine 入口中间件 parseCookieHeader(req.headers.cookie)
|
|
50
|
+
* 写入。Server Component 通过 `getRequestContext()?.cookies?.<name>` 读取,
|
|
51
|
+
* 让"locale / 实验位"这类 SSR 首屏就要决定的偏好不依赖 client mount。
|
|
52
|
+
*/
|
|
53
|
+
cookies?: Record<string, string>;
|
|
54
|
+
/** A/B 测试开关位(engine ABVariantMiddleware 写入;getVariant() 读) */
|
|
55
|
+
flags?: Record<string, boolean | string>;
|
|
56
|
+
/**
|
|
57
|
+
* 本次请求生效的实验变体表 —— `{ 'hero-style': 'bold' }`。由 ABVariantMiddleware
|
|
58
|
+
* 在每次请求时基于 anonId + 实验配置确定性算出(hash(anonId+expKey)),不进 cookie。
|
|
59
|
+
* ISR cache key 拼这一份的 digest,保证「不同变体走不同 cache entry」+「同一 anonId
|
|
60
|
+
* 同一实验配置永远 HIT 同一份缓存」。
|
|
61
|
+
*
|
|
62
|
+
* 与 flags 区别:experiments 只承载实验变体;flags 是更宽泛的 boolean/string 开关位
|
|
63
|
+
* (比如 feature toggle,dark launch)。getVariant() 历史上读 flags,本字段是它的 sst。
|
|
64
|
+
*/
|
|
65
|
+
experiments?: Record<string, string>;
|
|
66
|
+
/** 其它业务扩展字段(engine 不消费) */
|
|
67
|
+
[key: string]: unknown;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* ISR 请求上下文 —— 跨中间件传递的请求元数据容器
|
|
72
|
+
*
|
|
73
|
+
* plugin-rsc 模式下真正的渲染由 `@vitejs/plugin-rsc` 的 fetch handler 承担,
|
|
74
|
+
* 本类型主要用于:
|
|
75
|
+
* - ISR 缓存中间件判断命中 / 失效
|
|
76
|
+
* - 用户中间件链(MiddlewareComposer)的 context
|
|
77
|
+
* - 错误处理 / 指标采集
|
|
78
|
+
*/
|
|
79
|
+
export interface ISRContext<T = Record<string, string | string[] | undefined>> {
|
|
80
|
+
req?: {
|
|
81
|
+
headers: T;
|
|
82
|
+
cookies: Record<string, string>;
|
|
83
|
+
query: T;
|
|
84
|
+
userAgent: string;
|
|
85
|
+
};
|
|
86
|
+
|
|
87
|
+
res?: {
|
|
88
|
+
statusCode: number;
|
|
89
|
+
headers: T;
|
|
90
|
+
};
|
|
91
|
+
|
|
92
|
+
/** 当前请求的 URL */
|
|
93
|
+
url: string;
|
|
94
|
+
|
|
95
|
+
/** 最终执行的渲染模式(isr / ssg / ssr) */
|
|
96
|
+
renderModeType: RenderModeType;
|
|
97
|
+
|
|
98
|
+
/** Vite dev server 实例(仅开发模式,用于 middleware 链中访问 module graph 等) */
|
|
99
|
+
server?: ViteDevServer;
|
|
100
|
+
|
|
101
|
+
/** 错误信息 */
|
|
102
|
+
error?: Error;
|
|
103
|
+
|
|
104
|
+
/** 上下文数据 */
|
|
105
|
+
data: ISRContextData;
|
|
106
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import * as fs from 'fs';
|
|
2
|
+
import * as path from 'path';
|
|
3
|
+
import { Logger } from '@/logger/Logger';
|
|
4
|
+
|
|
5
|
+
const logger = Logger.getInstance();
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* 缓存清理工具类
|
|
9
|
+
* 负责在开发环境启动时清理统一的缓存目录
|
|
10
|
+
*/
|
|
11
|
+
export class CacheCleanup {
|
|
12
|
+
private static readonly CACHE_ROOT_DIR = '.isr-hyou';
|
|
13
|
+
private static readonly ISR_CACHE_DIR = '.isr-hyou/isr';
|
|
14
|
+
private static readonly SSR_CACHE_DIR = '.isr-hyou/ssr';
|
|
15
|
+
private static readonly SSG_CACHE_DIR = '.isr-hyou/ssg';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* 安全删除缓存根目录
|
|
19
|
+
*/
|
|
20
|
+
private static async safeClearCacheRoot(): Promise<void> {
|
|
21
|
+
try {
|
|
22
|
+
const fullPath = path.resolve(process.cwd(), this.CACHE_ROOT_DIR);
|
|
23
|
+
|
|
24
|
+
// 安全检查:确保路径包含预期的缓存目录名
|
|
25
|
+
if (!fullPath.includes('.isr-hyou')) {
|
|
26
|
+
logger.warn(`⚠️ 跳过清理可疑路径: ${fullPath}`);
|
|
27
|
+
return;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
if (fs.existsSync(fullPath)) {
|
|
31
|
+
await fs.promises.rm(fullPath, { recursive: true, force: true });
|
|
32
|
+
logger.info(`🧹 已清理缓存根目录: ${this.CACHE_ROOT_DIR}`);
|
|
33
|
+
}
|
|
34
|
+
} catch (error) {
|
|
35
|
+
logger.error('❌ 清理缓存根目录失败:', error);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 开发环境启动时清理缓存
|
|
41
|
+
* 只在开发环境(pnpm dev)时执行,生产环境不处理
|
|
42
|
+
*/
|
|
43
|
+
public static async cleanupOnDevStart(): Promise<void> {
|
|
44
|
+
// 生产环境不处理缓存
|
|
45
|
+
if (process.env.NODE_ENV === 'production') {
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
logger.info('🚀 开发环境启动,清理缓存目录...');
|
|
50
|
+
await this.safeClearCacheRoot();
|
|
51
|
+
logger.info('✅ 开发环境缓存清理完成');
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* 获取ISR缓存目录路径
|
|
56
|
+
*/
|
|
57
|
+
public static getISRCacheDir(): string {
|
|
58
|
+
return path.resolve(process.cwd(), this.ISR_CACHE_DIR);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 获取SSR缓存目录路径
|
|
63
|
+
*/
|
|
64
|
+
public static getSSRCacheDir(): string {
|
|
65
|
+
return path.resolve(process.cwd(), this.SSR_CACHE_DIR);
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 获取SSG缓存目录路径
|
|
70
|
+
*/
|
|
71
|
+
public static getSSGCacheDir(): string {
|
|
72
|
+
return path.resolve(process.cwd(), this.SSG_CACHE_DIR);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
export interface CacheDurationOverrides {
|
|
2
|
+
ttl?: unknown;
|
|
3
|
+
staleWhileRevalidate?: unknown;
|
|
4
|
+
}
|
|
5
|
+
|
|
6
|
+
/** Cache deadlines must remain finite, positive (or explicitly zero for SWR) timestamps. */
|
|
7
|
+
export function assertCacheDuration(
|
|
8
|
+
seconds: unknown,
|
|
9
|
+
label: string,
|
|
10
|
+
allowZero = false
|
|
11
|
+
): asserts seconds is number {
|
|
12
|
+
if (
|
|
13
|
+
typeof seconds !== 'number' ||
|
|
14
|
+
!Number.isFinite(seconds) ||
|
|
15
|
+
(allowZero ? seconds < 0 : seconds <= 0) ||
|
|
16
|
+
seconds * 1000 > Number.MAX_SAFE_INTEGER
|
|
17
|
+
)
|
|
18
|
+
throw new RangeError(
|
|
19
|
+
`${label} must be finite ${allowZero ? 'non-negative' : 'positive'} seconds within the safe cache window`
|
|
20
|
+
);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Undefined inherits; explicit invalid values never silently substitute another policy. */
|
|
24
|
+
export function resolveCacheDurations(
|
|
25
|
+
defaultTtl: number,
|
|
26
|
+
overrides: CacheDurationOverrides = {},
|
|
27
|
+
label = 'route'
|
|
28
|
+
): { ttlSeconds: number; swrSeconds: number } {
|
|
29
|
+
assertCacheDuration(defaultTtl, 'revalidate');
|
|
30
|
+
const ttl = overrides.ttl === undefined ? defaultTtl : overrides.ttl;
|
|
31
|
+
const swr = overrides.staleWhileRevalidate === undefined ? ttl : overrides.staleWhileRevalidate;
|
|
32
|
+
assertCacheDuration(ttl, `${label}.ttl`);
|
|
33
|
+
assertCacheDuration(swr, `${label}.staleWhileRevalidate`, true);
|
|
34
|
+
if ((ttl + swr) * 1000 > Number.MAX_SAFE_INTEGER - Date.now())
|
|
35
|
+
throw new RangeError(`${label} cache window exceeds a safe deadline timestamp`);
|
|
36
|
+
return { ttlSeconds: ttl, swrSeconds: swr };
|
|
37
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
export type CookieHeaderSource =
|
|
2
|
+
| string
|
|
3
|
+
| null
|
|
4
|
+
| undefined
|
|
5
|
+
| {
|
|
6
|
+
headers?: Headers | Record<string, string | string[] | number | undefined | null>;
|
|
7
|
+
};
|
|
8
|
+
|
|
9
|
+
export function getCookieHeader(source: CookieHeaderSource): string {
|
|
10
|
+
if (!source) return '';
|
|
11
|
+
if (typeof source === 'string') return source;
|
|
12
|
+
|
|
13
|
+
const headers = source.headers;
|
|
14
|
+
if (!headers) return '';
|
|
15
|
+
|
|
16
|
+
if (typeof (headers as Headers).get === 'function') {
|
|
17
|
+
return (headers as Headers).get('cookie') ?? '';
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
const record = headers as Record<string, string | string[] | number | undefined | null>;
|
|
21
|
+
const raw = record.cookie ?? record.Cookie;
|
|
22
|
+
if (Array.isArray(raw)) return raw.join('; ');
|
|
23
|
+
return raw === undefined || raw === null ? '' : String(raw);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
export function readCookie(source: CookieHeaderSource, name: string): string | undefined {
|
|
27
|
+
if (!name) return undefined;
|
|
28
|
+
const cookies = parseCookieHeader(getCookieHeader(source));
|
|
29
|
+
return cookies[name];
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function parseCookieHeader(header: string): Record<string, string> {
|
|
33
|
+
const cookies: Record<string, string> = Object.create(null);
|
|
34
|
+
if (!header) return cookies;
|
|
35
|
+
|
|
36
|
+
for (const part of header.split(';')) {
|
|
37
|
+
const trimmed = part.trim();
|
|
38
|
+
if (!trimmed) continue;
|
|
39
|
+
|
|
40
|
+
const index = trimmed.indexOf('=');
|
|
41
|
+
if (index <= 0) continue;
|
|
42
|
+
|
|
43
|
+
const key = trimmed.slice(0, index).trim();
|
|
44
|
+
if (!key) continue;
|
|
45
|
+
|
|
46
|
+
const rawValue = trimmed.slice(index + 1).trim();
|
|
47
|
+
cookies[key] = safeDecodeCookieValue(rawValue);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
return cookies;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function safeDecodeCookieValue(value: string): string {
|
|
54
|
+
try {
|
|
55
|
+
return decodeURIComponent(value);
|
|
56
|
+
} catch {
|
|
57
|
+
return value;
|
|
58
|
+
}
|
|
59
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 通用 hash 工具 —— 非加密用途的快速字符串 hash。
|
|
3
|
+
*
|
|
4
|
+
* 选 FNV-1a 32 位变种:
|
|
5
|
+
* - 无外部依赖(纯 JS,浏览器 / Node / edge 全部能跑)
|
|
6
|
+
* - 同一字符串永远同一结果(确定性,A/B 分桶 + cache key digest 都需要)
|
|
7
|
+
* - 雪崩效应足够好(单字符变化 → 大范围 bit 变化)
|
|
8
|
+
* - 不用于密码 / 安全场景(那种应当走 SHA / HMAC)
|
|
9
|
+
*
|
|
10
|
+
* 跟 ISR cache 里 extractVariantDigest 用的同一份 hash —— 行为可预测。
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* FNV-1a 32-bit hash —— 返回无符号 32 位整数。
|
|
15
|
+
*
|
|
16
|
+
* 算法常量遵循 Fowler/Noll/Vo 规范:
|
|
17
|
+
* offset basis = 0x811c9dc5
|
|
18
|
+
* prime = 0x01000193
|
|
19
|
+
*/
|
|
20
|
+
export function fnv1a32(input: string): number {
|
|
21
|
+
let h = 0x811c9dc5;
|
|
22
|
+
for (let i = 0; i < input.length; i++) {
|
|
23
|
+
h ^= input.charCodeAt(i);
|
|
24
|
+
h = Math.imul(h, 0x01000193);
|
|
25
|
+
}
|
|
26
|
+
return h >>> 0;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** FNV-1a 32-bit → base36 字符串。供 cache key digest 用,简短稳定 */
|
|
30
|
+
export function fnv1a32Base36(input: string): string {
|
|
31
|
+
return fnv1a32(input).toString(36);
|
|
32
|
+
}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/** Shared logical identity for HTML dispatch, aliases and build-time route validation. */
|
|
2
|
+
export function decodeHtmlPathname(raw: string): string {
|
|
3
|
+
const pathname = decodeURIComponent(raw);
|
|
4
|
+
if (
|
|
5
|
+
pathname.includes('\\') ||
|
|
6
|
+
pathname.includes('\0') ||
|
|
7
|
+
pathname.split('/').some(segment => segment === '..' || segment === '.')
|
|
8
|
+
) {
|
|
9
|
+
throw new Error('Invalid HTML pathname');
|
|
10
|
+
}
|
|
11
|
+
return pathname;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export interface HtmlRouteDeclarationOptions {
|
|
15
|
+
/** Matching rules are valid configuration, but are never concrete SSG pages. */
|
|
16
|
+
allowPatterns?: boolean;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
export function isHtmlRoutePattern(route: string): boolean {
|
|
20
|
+
return route.includes('*') || route.split('/').some(segment => segment.startsWith(':'));
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** Validate the original declaration before a URL parser can repair or normalize it. */
|
|
24
|
+
export function htmlRouteIdentity(
|
|
25
|
+
route: string,
|
|
26
|
+
{ allowPatterns = false }: HtmlRouteDeclarationOptions = {}
|
|
27
|
+
): string {
|
|
28
|
+
const invalid = (reason: string) =>
|
|
29
|
+
new Error(`Invalid HTML route ${JSON.stringify(route)}: ${reason}`);
|
|
30
|
+
if (typeof route !== 'string') throw invalid('expected a path string');
|
|
31
|
+
if (allowPatterns && route === '*') return route;
|
|
32
|
+
const syntax = allowPatterns ? /^\/[A-Za-z0-9%\-._~/*:]*$/ : /^\/[A-Za-z0-9%\-._~/]*$/;
|
|
33
|
+
if (!syntax.test(route) || route.startsWith('//'))
|
|
34
|
+
throw invalid(
|
|
35
|
+
'expected one origin-relative, percent-encoded pathname without query or fragment'
|
|
36
|
+
);
|
|
37
|
+
const segments = route.slice(1).split('/');
|
|
38
|
+
if (segments.at(-1) === '') segments.pop();
|
|
39
|
+
if (segments.some(segment => !segment)) throw invalid('empty path segment');
|
|
40
|
+
let identity: string;
|
|
41
|
+
try {
|
|
42
|
+
identity = decodeHtmlPathname(route);
|
|
43
|
+
} catch (cause) {
|
|
44
|
+
throw new Error(`Invalid HTML route ${JSON.stringify(route)}: malformed or unsafe pathname`, {
|
|
45
|
+
cause,
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
if (
|
|
49
|
+
Array.from(identity).some(character => {
|
|
50
|
+
const code = character.charCodeAt(0);
|
|
51
|
+
return code < 32 || code === 127;
|
|
52
|
+
})
|
|
53
|
+
)
|
|
54
|
+
throw invalid('control characters are forbidden');
|
|
55
|
+
return identity;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Exact duplicates are idempotent; matching rules do not own concrete page identities. */
|
|
59
|
+
export function assertDistinctHtmlRouteIdentities(
|
|
60
|
+
routes: Iterable<string>,
|
|
61
|
+
options: HtmlRouteDeclarationOptions = {}
|
|
62
|
+
): void {
|
|
63
|
+
const owners = new Map<string, string>();
|
|
64
|
+
for (const route of routes) {
|
|
65
|
+
const identity = htmlRouteIdentity(route, options);
|
|
66
|
+
if (options.allowPatterns && isHtmlRoutePattern(route)) continue;
|
|
67
|
+
const owner = owners.get(identity);
|
|
68
|
+
if (owner !== undefined && owner !== route) {
|
|
69
|
+
throw new Error(
|
|
70
|
+
`Route identity collision: ${JSON.stringify(owner)} and ${JSON.stringify(route)} resolve to ${JSON.stringify(identity)}`
|
|
71
|
+
);
|
|
72
|
+
}
|
|
73
|
+
owners.set(identity, route);
|
|
74
|
+
}
|
|
75
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { FetchHandler } from '../ssg/spider';
|
|
2
|
+
|
|
3
|
+
/** Resolve the built RSC module once, retaining the selected export's receiver. */
|
|
4
|
+
export function resolveFetchHandler(module: unknown): FetchHandler {
|
|
5
|
+
const mod = module as
|
|
6
|
+
| { default?: { fetch?: unknown } | null; fetch?: unknown }
|
|
7
|
+
| null
|
|
8
|
+
| undefined;
|
|
9
|
+
const defaultOwner = mod?.default;
|
|
10
|
+
const defaultFetch = defaultOwner?.fetch;
|
|
11
|
+
if (typeof defaultFetch === 'function') {
|
|
12
|
+
return { fetch: defaultFetch.bind(defaultOwner) as FetchHandler['fetch'] };
|
|
13
|
+
}
|
|
14
|
+
const namedFetch = mod?.fetch;
|
|
15
|
+
if (typeof namedFetch === 'function') {
|
|
16
|
+
return { fetch: namedFetch.bind(mod) as FetchHandler['fetch'] };
|
|
17
|
+
}
|
|
18
|
+
throw new TypeError('dist/rsc/index.js 未导出可调用的 { fetch } 或 default.fetch');
|
|
19
|
+
}
|