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
package/dist/cli/cli.js
ADDED
|
@@ -0,0 +1,370 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { C as loadConfig, F as logger, I as DEFAULT_PORT, L as package_default, d as startServer, f as createProductionRuntime, p as prepareProductionBuild, t as createISRApp, u as closeServer } from "../createISRApp-CDkyUuW3.js";
|
|
3
|
+
import { extname, join, resolve, sep } from "node:path";
|
|
4
|
+
import { open, readFile } from "node:fs/promises";
|
|
5
|
+
import http from "node:http";
|
|
6
|
+
import { Command } from "commander";
|
|
7
|
+
import { spawn } from "node:child_process";
|
|
8
|
+
//#region src/cli/dev.ts
|
|
9
|
+
/**
|
|
10
|
+
* 开发服务器命令
|
|
11
|
+
*/
|
|
12
|
+
function openBrowser(url) {
|
|
13
|
+
const child = spawn(process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open", process.platform === "win32" ? [
|
|
14
|
+
"/c",
|
|
15
|
+
"start",
|
|
16
|
+
"",
|
|
17
|
+
url
|
|
18
|
+
] : [url], {
|
|
19
|
+
stdio: "ignore",
|
|
20
|
+
detached: true
|
|
21
|
+
});
|
|
22
|
+
child.on("error", (error) => {
|
|
23
|
+
logger.warn("[CLI]", `自动打开浏览器失败:${error.message}`);
|
|
24
|
+
});
|
|
25
|
+
child.unref();
|
|
26
|
+
}
|
|
27
|
+
function getSamplePath(config, mode) {
|
|
28
|
+
const routes = config.routes ?? {};
|
|
29
|
+
for (const [route, value] of Object.entries(routes)) if ((typeof value === "string" ? value : value?.mode) === mode && !route.includes("*")) return route;
|
|
30
|
+
if (mode === "ssg") {
|
|
31
|
+
const ssgRoutes = config.ssg?.routes;
|
|
32
|
+
return Array.isArray(ssgRoutes) ? ssgRoutes[0] ?? "/about" : "/about";
|
|
33
|
+
}
|
|
34
|
+
if (mode === "ssr") return "/login";
|
|
35
|
+
return "/";
|
|
36
|
+
}
|
|
37
|
+
function printRenderModeLinks(baseUrl, config) {
|
|
38
|
+
const trimBase = baseUrl.replace(/\/$/, "");
|
|
39
|
+
const isrPath = getSamplePath(config, "isr");
|
|
40
|
+
const ssrPath = getSamplePath(config, "ssr");
|
|
41
|
+
const ssgPath = getSamplePath(config, "ssg");
|
|
42
|
+
logger.info("[Dev Links]", `ISR: ${trimBase}${isrPath}?mode=isr`);
|
|
43
|
+
logger.info("[Dev Links]", `SSR: ${trimBase}${ssrPath}?mode=ssr`);
|
|
44
|
+
logger.info("[Dev Links]", `SSG: ${trimBase}${ssgPath}?mode=ssg`);
|
|
45
|
+
logger.info("[Dev Links]", `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);
|
|
46
|
+
logger.info("[Dev Links]", `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);
|
|
47
|
+
logger.info("[Dev Links]", `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);
|
|
48
|
+
}
|
|
49
|
+
async function startDevServer(options) {
|
|
50
|
+
const { port, host, open = false } = options;
|
|
51
|
+
logger.info("[CLI]", "启动开发服务器");
|
|
52
|
+
logger.spin("初始化开发环境...");
|
|
53
|
+
try {
|
|
54
|
+
const config = await loadConfig();
|
|
55
|
+
config.server = config.server || { port: 3e3 };
|
|
56
|
+
if (port) config.server.port = parseInt(port);
|
|
57
|
+
if (host) config.server.host = host;
|
|
58
|
+
const app = await createISRApp(config);
|
|
59
|
+
logger.stopSpinner("开发环境初始化完成");
|
|
60
|
+
const serverContext = await app.start();
|
|
61
|
+
logger.success("[CLI]", "开发服务器已启动");
|
|
62
|
+
if (serverContext.url) {
|
|
63
|
+
logger.info("[Server]", `页面地址: ${serverContext.url}/`);
|
|
64
|
+
logger.info("[Server]", `服务地址: ${serverContext.url}`);
|
|
65
|
+
logger.info("[Server]", `健康检查: ${serverContext.url}/health`);
|
|
66
|
+
printRenderModeLinks(serverContext.url, config);
|
|
67
|
+
if (open) openBrowser(serverContext.url);
|
|
68
|
+
} else {
|
|
69
|
+
logger.info("[Server]", `端口: ${config.server.port}`);
|
|
70
|
+
logger.info("[Server]", "健康检查: /health");
|
|
71
|
+
}
|
|
72
|
+
logger.info("[CLI]", "开发提示:");
|
|
73
|
+
logger.info("[CLI]", "- 修改文件将自动重新加载");
|
|
74
|
+
logger.info("[CLI]", "- 使用 Ctrl+C 停止服务器");
|
|
75
|
+
logger.info("[CLI]", "- 查看实时日志和性能指标");
|
|
76
|
+
let shuttingDown = false;
|
|
77
|
+
const handleShutdown = async (signal) => {
|
|
78
|
+
if (shuttingDown) {
|
|
79
|
+
logger.warn("[CLI]", `收到 ${signal} 二次触发 —— 强制退出`);
|
|
80
|
+
process.exit(1);
|
|
81
|
+
}
|
|
82
|
+
shuttingDown = true;
|
|
83
|
+
logger.warn("[CLI]", `收到 ${signal},关闭服务器...`);
|
|
84
|
+
const forceExit = setTimeout(() => {
|
|
85
|
+
logger.warn("[CLI]", "关闭超时,强制退出");
|
|
86
|
+
process.exit(1);
|
|
87
|
+
}, 3e3);
|
|
88
|
+
forceExit.unref();
|
|
89
|
+
try {
|
|
90
|
+
await app.shutdown();
|
|
91
|
+
} catch (err) {
|
|
92
|
+
logger.error("[CLI]", "关闭时发生异常", err);
|
|
93
|
+
}
|
|
94
|
+
clearTimeout(forceExit);
|
|
95
|
+
process.exit(0);
|
|
96
|
+
};
|
|
97
|
+
process.on("SIGINT", () => void handleShutdown("SIGINT"));
|
|
98
|
+
process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
|
|
99
|
+
} catch (error) {
|
|
100
|
+
logger.stopSpinner("开发服务器启动失败");
|
|
101
|
+
logger.error("[CLI]", "开发服务器启动失败", error);
|
|
102
|
+
throw error;
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
//#endregion
|
|
106
|
+
//#region src/cli/start.ts
|
|
107
|
+
/** Production CLI: config, listener and process lifecycle around the shared runtime. */
|
|
108
|
+
async function startProductionServer(options) {
|
|
109
|
+
process.env.NODE_ENV = "production";
|
|
110
|
+
let build;
|
|
111
|
+
try {
|
|
112
|
+
build = await prepareProductionBuild();
|
|
113
|
+
} catch (error) {
|
|
114
|
+
if (error.code !== "ENOENT") throw error;
|
|
115
|
+
logger.error("[CLI]", "未找到生产构建产物,请先运行 pnpm build");
|
|
116
|
+
process.exit(1);
|
|
117
|
+
}
|
|
118
|
+
const config = await loadConfig();
|
|
119
|
+
if (options.port) config.server.port = parseInt(options.port, 10);
|
|
120
|
+
if (options.host) config.server.host = options.host;
|
|
121
|
+
const runtime = await createProductionRuntime(config, { build });
|
|
122
|
+
let result;
|
|
123
|
+
try {
|
|
124
|
+
result = await startServer(runtime.app, {
|
|
125
|
+
port: config.server?.port ?? 3e3,
|
|
126
|
+
host: config.server?.host,
|
|
127
|
+
strictPort: config.server?.strictPort
|
|
128
|
+
});
|
|
129
|
+
} catch (error) {
|
|
130
|
+
try {
|
|
131
|
+
await runtime.close();
|
|
132
|
+
} catch (cleanupError) {
|
|
133
|
+
logger.error("[CLI]", "Production startup cleanup failed", cleanupError);
|
|
134
|
+
}
|
|
135
|
+
throw error;
|
|
136
|
+
}
|
|
137
|
+
logger.success("[CLI]", `生产服务器已启动: ${result.url}`);
|
|
138
|
+
let shuttingDown = false;
|
|
139
|
+
const handleShutdown = async (signal) => {
|
|
140
|
+
if (shuttingDown) process.exit(1);
|
|
141
|
+
shuttingDown = true;
|
|
142
|
+
logger.warn("[CLI]", `收到 ${signal},关闭生产服务器...`);
|
|
143
|
+
const cleanups = await Promise.allSettled([closeServer(result.server)]);
|
|
144
|
+
const forceExit = setTimeout(() => process.exit(1), 3e3);
|
|
145
|
+
forceExit.unref();
|
|
146
|
+
cleanups.push(...await Promise.allSettled([Promise.resolve().then(() => runtime.close())]));
|
|
147
|
+
clearTimeout(forceExit);
|
|
148
|
+
for (const cleanup of cleanups) if (cleanup.status === "rejected") logger.error("[CLI]", "Production shutdown failed", cleanup.reason);
|
|
149
|
+
process.exit(cleanups.some((result) => result.status === "rejected") ? 1 : 0);
|
|
150
|
+
};
|
|
151
|
+
process.on("SIGINT", () => void handleShutdown("SIGINT"));
|
|
152
|
+
process.on("SIGTERM", () => void handleShutdown("SIGTERM"));
|
|
153
|
+
}
|
|
154
|
+
//#endregion
|
|
155
|
+
//#region src/cli/fallback.ts
|
|
156
|
+
/**
|
|
157
|
+
* `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理
|
|
158
|
+
*
|
|
159
|
+
* 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,
|
|
160
|
+
* 让开发者**不装 nginx**也能在本地复现整条降级链路。
|
|
161
|
+
*
|
|
162
|
+
* 监听 :PORT(默认 8080):
|
|
163
|
+
* - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回
|
|
164
|
+
* - /api/* → 反代到 mock/upstream API(默认 :3001)
|
|
165
|
+
* - 其它 → 反代到 SSR(默认 :3000);
|
|
166
|
+
* 5xx 或 connect refused → 切 dist/spa/index.html
|
|
167
|
+
* 兜底响应附带 `x-fallback: spa` 头
|
|
168
|
+
*
|
|
169
|
+
* 用法:
|
|
170
|
+
* pnpm build
|
|
171
|
+
* pnpm --filter mock-server start # :3001
|
|
172
|
+
* isr-engine start # :3000 SSR
|
|
173
|
+
* isr-engine test-fallback-local # :8080 ← 用户访问这个
|
|
174
|
+
* open http://localhost:8080/ # → 看到 SSR 渲染
|
|
175
|
+
* kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底
|
|
176
|
+
* 重启 SSR; reload # → 自动切回 SSR
|
|
177
|
+
*
|
|
178
|
+
* 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。
|
|
179
|
+
*/
|
|
180
|
+
var MIME = {
|
|
181
|
+
".html": "text/html; charset=utf-8",
|
|
182
|
+
".js": "application/javascript; charset=utf-8",
|
|
183
|
+
".mjs": "application/javascript; charset=utf-8",
|
|
184
|
+
".css": "text/css; charset=utf-8",
|
|
185
|
+
".svg": "image/svg+xml",
|
|
186
|
+
".png": "image/png",
|
|
187
|
+
".jpg": "image/jpeg",
|
|
188
|
+
".jpeg": "image/jpeg",
|
|
189
|
+
".webp": "image/webp",
|
|
190
|
+
".json": "application/json; charset=utf-8",
|
|
191
|
+
".ico": "image/x-icon"
|
|
192
|
+
};
|
|
193
|
+
function proxyRequest(req, res, target, onUpstreamError) {
|
|
194
|
+
const handleErr = (err) => {
|
|
195
|
+
if (onUpstreamError) onUpstreamError(err);
|
|
196
|
+
else sendError(res, 502, err.message);
|
|
197
|
+
};
|
|
198
|
+
const upstream = http.request({
|
|
199
|
+
host: target.host,
|
|
200
|
+
port: target.port,
|
|
201
|
+
path: req.url,
|
|
202
|
+
method: req.method,
|
|
203
|
+
headers: {
|
|
204
|
+
...req.headers,
|
|
205
|
+
host: `${target.host}:${target.port}`
|
|
206
|
+
}
|
|
207
|
+
}, (upRes) => {
|
|
208
|
+
const code = upRes.statusCode || 502;
|
|
209
|
+
if (code >= 500 && onUpstreamError) {
|
|
210
|
+
upRes.resume();
|
|
211
|
+
onUpstreamError(/* @__PURE__ */ new Error(`upstream ${code}`));
|
|
212
|
+
return;
|
|
213
|
+
}
|
|
214
|
+
res.writeHead(code, upRes.headers);
|
|
215
|
+
upRes.pipe(res);
|
|
216
|
+
});
|
|
217
|
+
upstream.on("error", handleErr);
|
|
218
|
+
req.pipe(upstream);
|
|
219
|
+
}
|
|
220
|
+
async function serveStatic(req, res, clientRoot) {
|
|
221
|
+
let pathname;
|
|
222
|
+
try {
|
|
223
|
+
pathname = decodeURIComponent(new URL(req.url || "/", "http://x").pathname);
|
|
224
|
+
} catch {
|
|
225
|
+
sendError(res, 400, "invalid request path");
|
|
226
|
+
return;
|
|
227
|
+
}
|
|
228
|
+
const filePath = join(clientRoot, pathname);
|
|
229
|
+
if (!filePath.startsWith(clientRoot + sep)) {
|
|
230
|
+
sendError(res, 403, "forbidden");
|
|
231
|
+
return;
|
|
232
|
+
}
|
|
233
|
+
try {
|
|
234
|
+
const file = await open(filePath, "r");
|
|
235
|
+
let buf;
|
|
236
|
+
try {
|
|
237
|
+
if (!(await file.stat()).isFile()) throw new Error("not file");
|
|
238
|
+
buf = await file.readFile();
|
|
239
|
+
} finally {
|
|
240
|
+
await file.close();
|
|
241
|
+
}
|
|
242
|
+
res.writeHead(200, { "content-type": MIME[extname(filePath)] || "application/octet-stream" });
|
|
243
|
+
res.end(buf);
|
|
244
|
+
} catch {
|
|
245
|
+
sendError(res, 404, "not found");
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
async function serveSpaShell(res, spaShell) {
|
|
249
|
+
try {
|
|
250
|
+
const html = await readFile(spaShell, "utf8");
|
|
251
|
+
res.writeHead(200, {
|
|
252
|
+
"content-type": "text/html; charset=utf-8",
|
|
253
|
+
"x-fallback": "spa"
|
|
254
|
+
});
|
|
255
|
+
res.end(html);
|
|
256
|
+
} catch {
|
|
257
|
+
sendError(res, 500, `SPA shell not found at ${spaShell} — run \`pnpm build\` first`);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
function sendError(res, code, msg) {
|
|
261
|
+
if (res.headersSent) return;
|
|
262
|
+
res.writeHead(code, { "content-type": "text/plain; charset=utf-8" });
|
|
263
|
+
res.end(`${code} ${msg}\n`);
|
|
264
|
+
}
|
|
265
|
+
/**
|
|
266
|
+
* 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上
|
|
267
|
+
* 验证三种分支(static / api proxy / ssr proxy + spa fallback)。
|
|
268
|
+
*/
|
|
269
|
+
function createFallbackRequestHandler(options) {
|
|
270
|
+
const distRoot = resolve(process.cwd(), options.dist);
|
|
271
|
+
const clientRoot = join(distRoot, "client");
|
|
272
|
+
const spaShell = join(distRoot, "spa", "index.html");
|
|
273
|
+
const ssr = {
|
|
274
|
+
host: "127.0.0.1",
|
|
275
|
+
port: parseInt(options.ssrPort, 10)
|
|
276
|
+
};
|
|
277
|
+
const api = {
|
|
278
|
+
host: "127.0.0.1",
|
|
279
|
+
port: parseInt(options.apiPort, 10)
|
|
280
|
+
};
|
|
281
|
+
return (req, res) => {
|
|
282
|
+
const path = (req.url || "/").split("?")[0];
|
|
283
|
+
if (path.startsWith("/assets/") || path.startsWith("/covers/") || path === "/favicon.ico" || path === "/logo.svg") {
|
|
284
|
+
serveStatic(req, res, clientRoot);
|
|
285
|
+
return;
|
|
286
|
+
}
|
|
287
|
+
if (path.startsWith("/api/")) {
|
|
288
|
+
proxyRequest(req, res, api);
|
|
289
|
+
return;
|
|
290
|
+
}
|
|
291
|
+
proxyRequest(req, res, ssr, (err) => {
|
|
292
|
+
logger.warn("[fallback]", `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);
|
|
293
|
+
serveSpaShell(res, spaShell);
|
|
294
|
+
});
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
function startFallbackProxy(options) {
|
|
298
|
+
const spaShell = join(resolve(process.cwd(), options.dist), "spa", "index.html");
|
|
299
|
+
const ssrPort = parseInt(options.ssrPort, 10);
|
|
300
|
+
const apiPort = parseInt(options.apiPort, 10);
|
|
301
|
+
const listenPort = parseInt(options.port, 10);
|
|
302
|
+
const server = http.createServer(createFallbackRequestHandler(options));
|
|
303
|
+
server.listen(listenPort, "127.0.0.1", () => {
|
|
304
|
+
logger.success("[CLI]", `本地 fallback proxy 已启动: http://localhost:${listenPort}`);
|
|
305
|
+
logger.info("[CLI]", ` → SSR upstream : http://127.0.0.1:${ssrPort}`);
|
|
306
|
+
logger.info("[CLI]", ` → API upstream : http://127.0.0.1:${apiPort}`);
|
|
307
|
+
logger.info("[CLI]", ` → 5xx fallback : ${spaShell}`);
|
|
308
|
+
logger.info("[CLI]", `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`);
|
|
309
|
+
});
|
|
310
|
+
return server;
|
|
311
|
+
}
|
|
312
|
+
//#endregion
|
|
313
|
+
//#region src/cli/serverOptions.ts
|
|
314
|
+
/**
|
|
315
|
+
* 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,
|
|
316
|
+
* CLI 才应覆盖 ssr.config.ts 中的 server 配置。
|
|
317
|
+
*/
|
|
318
|
+
function addServerBindingOptions(command) {
|
|
319
|
+
return command.option("-p, --port <port>", "端口号").option("-h, --host <host>", "主机地址");
|
|
320
|
+
}
|
|
321
|
+
//#endregion
|
|
322
|
+
//#region src/cli/cli.ts
|
|
323
|
+
/**
|
|
324
|
+
* ISR Engine CLI 主程序
|
|
325
|
+
*
|
|
326
|
+
* 主入口,负责命令注册和程序协调
|
|
327
|
+
*/
|
|
328
|
+
var program = new Command();
|
|
329
|
+
/**
|
|
330
|
+
* 主程序配置
|
|
331
|
+
*/
|
|
332
|
+
program.name("isr-engine").description("ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层").version(package_default.version);
|
|
333
|
+
/**
|
|
334
|
+
* dev 命令 - 开发服务器
|
|
335
|
+
*/
|
|
336
|
+
addServerBindingOptions(program.command("dev").description("启动开发服务器")).option("--open", "启动后自动打开浏览器", true).option("--no-open", "启动后不自动打开浏览器").action(async (options) => {
|
|
337
|
+
try {
|
|
338
|
+
await startDevServer(options);
|
|
339
|
+
} catch (error) {
|
|
340
|
+
logger.error("[CLI]", "开发服务器启动失败", error);
|
|
341
|
+
process.exit(1);
|
|
342
|
+
}
|
|
343
|
+
});
|
|
344
|
+
/**
|
|
345
|
+
* start 命令 - 生产服务器
|
|
346
|
+
*/
|
|
347
|
+
addServerBindingOptions(program.command("start").description("启动生产服务器")).action(async (options) => {
|
|
348
|
+
try {
|
|
349
|
+
await startProductionServer(options);
|
|
350
|
+
} catch (error) {
|
|
351
|
+
logger.error("[CLI]", "生产服务器启动失败", error);
|
|
352
|
+
process.exit(1);
|
|
353
|
+
}
|
|
354
|
+
});
|
|
355
|
+
/**
|
|
356
|
+
* test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)
|
|
357
|
+
* 仅本地开发用;生产环境用 nginx
|
|
358
|
+
*/
|
|
359
|
+
program.command("test-fallback-local").description("本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell").option("-p, --port <port>", "本地代理监听端口", "8080").option("--ssr-port <port>", "SSR 上游端口", String(DEFAULT_PORT)).option("--api-port <port>", "API/mock 上游端口", "3001").option("--dist <path>", "dist 根目录(含 client/ + spa/)", "./dist").action((options) => {
|
|
360
|
+
try {
|
|
361
|
+
startFallbackProxy(options);
|
|
362
|
+
} catch (error) {
|
|
363
|
+
logger.error("[CLI]", "test-fallback-local proxy 启动失败", error);
|
|
364
|
+
process.exit(1);
|
|
365
|
+
}
|
|
366
|
+
});
|
|
367
|
+
program.parse();
|
|
368
|
+
//#endregion
|
|
369
|
+
|
|
370
|
+
//# sourceMappingURL=cli.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli.js","names":[],"sources":["../../src/cli/dev.ts","../../src/cli/start.ts","../../src/cli/fallback.ts","../../src/cli/serverOptions.ts","../../src/cli/cli.ts"],"sourcesContent":["/**\n * 开发服务器命令\n */\n\nimport { spawn } from 'node:child_process';\nimport { logger } from '@/logger';\nimport { createISRApp } from '../app/createISRApp';\nimport { loadConfig } from '../config/loadConfig';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport type { ISRConfig } from '@/types';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n open?: boolean;\n}\n\nfunction openBrowser(url: string): void {\n const command =\n process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';\n const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];\n const child = spawn(command, args, { stdio: 'ignore', detached: true });\n child.on('error', error => {\n logger.warn('[CLI]', `自动打开浏览器失败:${error.message}`);\n });\n child.unref();\n}\n\nfunction getSamplePath(config: ISRConfig, mode: 'isr' | 'ssr' | 'ssg'): string {\n const routes = config.routes ?? {};\n for (const [route, value] of Object.entries(routes)) {\n const routeMode = typeof value === 'string' ? value : value?.mode;\n if (routeMode === mode && !route.includes('*')) return route;\n }\n if (mode === 'ssg') {\n const ssgRoutes = config.ssg?.routes;\n return Array.isArray(ssgRoutes) ? (ssgRoutes[0] ?? '/about') : '/about';\n }\n if (mode === 'ssr') return '/login';\n return '/';\n}\n\nfunction printRenderModeLinks(baseUrl: string, config: ISRConfig): void {\n const trimBase = baseUrl.replace(/\\/$/, '');\n const isrPath = getSamplePath(config, 'isr');\n const ssrPath = getSamplePath(config, 'ssr');\n const ssgPath = getSamplePath(config, 'ssg');\n\n logger.info('[Dev Links]', `ISR: ${trimBase}${isrPath}?mode=isr`);\n logger.info('[Dev Links]', `SSR: ${trimBase}${ssrPath}?mode=ssr`);\n logger.info('[Dev Links]', `SSG: ${trimBase}${ssgPath}?mode=ssg`);\n logger.info('[Dev Links]', `CSR fallback: ${trimBase}${isrPath}?__csr-shell=1`);\n logger.info('[Dev Links]', `No-JS/SSR HTML: ${trimBase}${isrPath}?__nojs=1`);\n logger.info('[Dev Links]', `响应头查看: x-resolved-mode / x-render-strategy / x-fallback-used`);\n}\n\nexport async function startDevServer(options: StartOptions) {\n const { port, host, open = false } = options;\n\n logger.info('[CLI]', '启动开发服务器');\n logger.spin('初始化开发环境...');\n\n try {\n // 读取项目配置\n const config = await loadConfig();\n\n // 确保 server 配置存在\n config.server = config.server || {\n port: DEFAULT_PORT,\n };\n\n // CLI 参数覆盖配置\n if (port) {\n config.server.port = parseInt(port);\n }\n if (host) {\n config.server.host = host;\n }\n // 创建应用实例\n const app = await createISRApp(config);\n\n logger.stopSpinner('开发环境初始化完成');\n\n // 启动服务器\n const serverContext = await app.start();\n\n logger.success('[CLI]', '开发服务器已启动');\n if (serverContext.url) {\n logger.info('[Server]', `页面地址: ${serverContext.url}/`);\n logger.info('[Server]', `服务地址: ${serverContext.url}`);\n logger.info('[Server]', `健康检查: ${serverContext.url}/health`);\n printRenderModeLinks(serverContext.url, config);\n if (open) {\n openBrowser(serverContext.url);\n }\n } else {\n logger.info('[Server]', `端口: ${config.server.port}`);\n logger.info('[Server]', '健康检查: /health');\n }\n\n logger.info('[CLI]', '开发提示:');\n logger.info('[CLI]', '- 修改文件将自动重新加载');\n logger.info('[CLI]', '- 使用 Ctrl+C 停止服务器');\n logger.info('[CLI]', '- 查看实时日志和性能指标');\n\n // 优雅关闭:\n // - 第一次 Ctrl+C:走 app.shutdown()(关 Vite + 强制断开 HTTP keep-alive 连接 + 释放端口)\n // - 3 秒内完不成 / 收到第二次信号:强制 process.exit(0)(防僵死)\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n logger.warn('[CLI]', `收到 ${signal} 二次触发 —— 强制退出`);\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭服务器...`);\n\n const forceExit = setTimeout(() => {\n logger.warn('[CLI]', '关闭超时,强制退出');\n process.exit(1);\n }, 3000);\n forceExit.unref();\n\n try {\n await app.shutdown();\n } catch (err) {\n logger.error('[CLI]', '关闭时发生异常', err);\n }\n clearTimeout(forceExit);\n process.exit(0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n } catch (error) {\n logger.stopSpinner('开发服务器启动失败');\n logger.error('[CLI]', '开发服务器启动失败', error);\n throw error;\n }\n}\n","/** Production CLI: config, listener and process lifecycle around the shared runtime. */\nimport { loadConfig } from '../config/loadConfig';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\nimport { startServer, closeServer } from '@/server/httpServer';\nimport { createProductionRuntime, prepareProductionBuild } from '@/server/productionRuntime';\nexport {\n extractRoutesForSitemap,\n applyTelemetryIntegrationEnv,\n createProductionJsonMiddleware,\n nodeToWebRequest,\n pipeWebResponse,\n createStaticHtmlMiddleware,\n createStaticAssetMiddleware,\n} from '@/server/productionRuntime';\n\ninterface StartOptions {\n port?: string;\n host?: string;\n}\nexport async function startProductionServer(options: StartOptions): Promise<void> {\n process.env.NODE_ENV = 'production';\n let build;\n try {\n build = await prepareProductionBuild();\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;\n logger.error('[CLI]', '未找到生产构建产物,请先运行 pnpm build');\n process.exit(1);\n }\n const config = await loadConfig();\n if (options.port) config.server.port = parseInt(options.port, 10);\n if (options.host) config.server.host = options.host;\n const runtime = await createProductionRuntime(config, { build });\n let result;\n try {\n result = await startServer(runtime.app, {\n port: config.server?.port ?? DEFAULT_PORT,\n host: config.server?.host,\n strictPort: config.server?.strictPort,\n });\n } catch (error) {\n try {\n await runtime.close();\n } catch (cleanupError) {\n logger.error('[CLI]', 'Production startup cleanup failed', cleanupError);\n }\n throw error;\n }\n logger.success('[CLI]', `生产服务器已启动: ${result.url}`);\n let shuttingDown = false;\n const handleShutdown = async (signal: NodeJS.Signals) => {\n if (shuttingDown) {\n process.exit(1);\n }\n shuttingDown = true;\n logger.warn('[CLI]', `收到 ${signal},关闭生产服务器...`);\n const cleanups = await Promise.allSettled([closeServer(result.server)]);\n const forceExit = setTimeout(() => process.exit(1), 3000);\n forceExit.unref();\n cleanups.push(...(await Promise.allSettled([Promise.resolve().then(() => runtime.close())])));\n clearTimeout(forceExit);\n for (const cleanup of cleanups) {\n if (cleanup.status === 'rejected')\n logger.error('[CLI]', 'Production shutdown failed', cleanup.reason);\n }\n process.exit(cleanups.some(result => result.status === 'rejected') ? 1 : 0);\n };\n process.on('SIGINT', () => void handleShutdown('SIGINT'));\n process.on('SIGTERM', () => void handleShutdown('SIGTERM'));\n}\n","/**\n * `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理\n *\n * 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,\n * 让开发者**不装 nginx**也能在本地复现整条降级链路。\n *\n * 监听 :PORT(默认 8080):\n * - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回\n * - /api/* → 反代到 mock/upstream API(默认 :3001)\n * - 其它 → 反代到 SSR(默认 :3000);\n * 5xx 或 connect refused → 切 dist/spa/index.html\n * 兜底响应附带 `x-fallback: spa` 头\n *\n * 用法:\n * pnpm build\n * pnpm --filter mock-server start # :3001\n * isr-engine start # :3000 SSR\n * isr-engine test-fallback-local # :8080 ← 用户访问这个\n * open http://localhost:8080/ # → 看到 SSR 渲染\n * kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底\n * 重启 SSR; reload # → 自动切回 SSR\n *\n * 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。\n */\nimport http from 'node:http';\nimport { open, readFile } from 'node:fs/promises';\nimport { extname, join, resolve, sep } from 'node:path';\nimport { logger } from '@/logger';\n\nexport interface FallbackProxyOptions {\n /** 监听端口(用户访问此处) */\n port: string;\n /** SSR 上游端口(isr-engine start 监听的) */\n ssrPort: string;\n /** API 上游端口(mock-server / 真后端) */\n apiPort: string;\n /** dist 根目录(绝对或相对路径,相对 cwd) */\n dist: string;\n}\n\nconst MIME: Record<string, string> = {\n '.html': 'text/html; charset=utf-8',\n '.js': 'application/javascript; charset=utf-8',\n '.mjs': 'application/javascript; charset=utf-8',\n '.css': 'text/css; charset=utf-8',\n '.svg': 'image/svg+xml',\n '.png': 'image/png',\n '.jpg': 'image/jpeg',\n '.jpeg': 'image/jpeg',\n '.webp': 'image/webp',\n '.json': 'application/json; charset=utf-8',\n '.ico': 'image/x-icon',\n};\n\ninterface UpstreamTarget {\n host: string;\n port: number;\n}\n\nfunction proxyRequest(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n target: UpstreamTarget,\n onUpstreamError?: (err: Error) => void\n): void {\n const handleErr = (err: Error): void => {\n if (onUpstreamError) onUpstreamError(err);\n else sendError(res, 502, err.message);\n };\n const upstream = http.request(\n {\n host: target.host,\n port: target.port,\n path: req.url,\n method: req.method,\n headers: { ...req.headers, host: `${target.host}:${target.port}` },\n },\n upRes => {\n const code = upRes.statusCode || 502;\n if (code >= 500 && onUpstreamError) {\n upRes.resume();\n onUpstreamError(new Error(`upstream ${code}`));\n return;\n }\n res.writeHead(code, upRes.headers);\n upRes.pipe(res);\n }\n );\n upstream.on('error', handleErr);\n req.pipe(upstream);\n}\n\nasync function serveStatic(\n req: http.IncomingMessage,\n res: http.ServerResponse,\n clientRoot: string\n): Promise<void> {\n let pathname: string;\n try {\n pathname = decodeURIComponent(new URL(req.url || '/', 'http://x').pathname);\n } catch {\n sendError(res, 400, 'invalid request path');\n return;\n }\n const filePath = join(clientRoot, pathname);\n if (!filePath.startsWith(clientRoot + sep)) {\n sendError(res, 403, 'forbidden');\n return;\n }\n try {\n const file = await open(filePath, 'r');\n let buf: Buffer;\n try {\n const s = await file.stat();\n if (!s.isFile()) throw new Error('not file');\n buf = await file.readFile();\n } finally {\n await file.close();\n }\n res.writeHead(200, {\n 'content-type': MIME[extname(filePath)] || 'application/octet-stream',\n });\n res.end(buf);\n } catch {\n sendError(res, 404, 'not found');\n }\n}\n\nasync function serveSpaShell(res: http.ServerResponse, spaShell: string): Promise<void> {\n try {\n const html = await readFile(spaShell, 'utf8');\n res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'x-fallback': 'spa' });\n res.end(html);\n } catch {\n sendError(res, 500, `SPA shell not found at ${spaShell} — run \\`pnpm build\\` first`);\n }\n}\n\nfunction sendError(res: http.ServerResponse, code: number, msg: string): void {\n if (res.headersSent) return;\n res.writeHead(code, { 'content-type': 'text/plain; charset=utf-8' });\n res.end(`${code} ${msg}\\n`);\n}\n\n/**\n * 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上\n * 验证三种分支(static / api proxy / ssr proxy + spa fallback)。\n */\nexport function createFallbackRequestHandler(options: FallbackProxyOptions): http.RequestListener {\n const distRoot = resolve(process.cwd(), options.dist);\n const clientRoot = join(distRoot, 'client');\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssr: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.ssrPort, 10) };\n const api: UpstreamTarget = { host: '127.0.0.1', port: parseInt(options.apiPort, 10) };\n\n return (req, res) => {\n const path = (req.url || '/').split('?')[0];\n\n if (\n path.startsWith('/assets/') ||\n path.startsWith('/covers/') ||\n path === '/favicon.ico' ||\n path === '/logo.svg'\n ) {\n void serveStatic(req, res, clientRoot);\n return;\n }\n\n if (path.startsWith('/api/')) {\n proxyRequest(req, res, api);\n return;\n }\n\n proxyRequest(req, res, ssr, err => {\n logger.warn('[fallback]', `SSR 失败 (${err.message}) → 切换 SPA shell: ${path}`);\n void serveSpaShell(res, spaShell);\n });\n };\n}\n\nexport function startFallbackProxy(options: FallbackProxyOptions): http.Server {\n const distRoot = resolve(process.cwd(), options.dist);\n const spaShell = join(distRoot, 'spa', 'index.html');\n const ssrPort = parseInt(options.ssrPort, 10);\n const apiPort = parseInt(options.apiPort, 10);\n const listenPort = parseInt(options.port, 10);\n\n const server = http.createServer(createFallbackRequestHandler(options));\n\n server.listen(listenPort, '127.0.0.1', () => {\n logger.success('[CLI]', `本地 fallback proxy 已启动: http://localhost:${listenPort}`);\n logger.info('[CLI]', ` → SSR upstream : http://127.0.0.1:${ssrPort}`);\n logger.info('[CLI]', ` → API upstream : http://127.0.0.1:${apiPort}`);\n logger.info('[CLI]', ` → 5xx fallback : ${spaShell}`);\n logger.info(\n '[CLI]',\n `提示:杀掉 SSR 进程 + 浏览器 reload,可看到自动切到 SPA shell(响应头 x-fallback: spa)`\n );\n });\n\n return server;\n}\n","import type { Command } from 'commander';\n\n/**\n * 注册服务监听参数。省略默认值是有意的:只有用户显式传参时,\n * CLI 才应覆盖 ssr.config.ts 中的 server 配置。\n */\nexport function addServerBindingOptions(command: Command): Command {\n return command.option('-p, --port <port>', '端口号').option('-h, --host <host>', '主机地址');\n}\n","#!/usr/bin/env node\n\n/**\n * ISR Engine CLI 主程序\n *\n * 主入口,负责命令注册和程序协调\n */\n\nimport { Command } from 'commander';\nimport pkg from '../../package.json';\n\nimport { startDevServer } from './dev';\nimport { startProductionServer } from './start';\nimport { startFallbackProxy } from './fallback';\nimport { addServerBindingOptions } from './serverOptions';\nimport { logger } from '@/logger';\nimport { DEFAULT_PORT } from '@/config/defaults';\n\nconst program = new Command();\n\n/**\n * 主程序配置\n */\nprogram\n .name('isr-engine')\n .description('ISR Engine — Vite + React 19 RSC 的 ISR/SSG/SSR 编排层')\n .version(pkg.version);\n\n/**\n * dev 命令 - 开发服务器\n */\naddServerBindingOptions(program.command('dev').description('启动开发服务器'))\n .option('--open', '启动后自动打开浏览器', true)\n .option('--no-open', '启动后不自动打开浏览器')\n .action(async options => {\n try {\n await startDevServer(options);\n } catch (error) {\n logger.error('[CLI]', '开发服务器启动失败', error);\n process.exit(1);\n }\n });\n\n/**\n * start 命令 - 生产服务器\n */\naddServerBindingOptions(program.command('start').description('启动生产服务器')).action(\n async options => {\n try {\n await startProductionServer(options);\n } catch (error) {\n logger.error('[CLI]', '生产服务器启动失败', error);\n process.exit(1);\n }\n }\n);\n\n/**\n * test-fallback-local 命令 - 本地 SSR→SPA 降级链路验证代理(nginx error_page 等价物)\n * 仅本地开发用;生产环境用 nginx\n */\nprogram\n .command('test-fallback-local')\n .description('本地启动 fallback 代理,验证 SSR 死时自动切到 SPA shell')\n .option('-p, --port <port>', '本地代理监听端口', '8080')\n .option('--ssr-port <port>', 'SSR 上游端口', String(DEFAULT_PORT))\n .option('--api-port <port>', 'API/mock 上游端口', '3001')\n .option('--dist <path>', 'dist 根目录(含 client/ + spa/)', './dist')\n .action(options => {\n try {\n startFallbackProxy(options);\n } catch (error) {\n logger.error('[CLI]', 'test-fallback-local proxy 启动失败', error);\n process.exit(1);\n }\n });\n\n// 主程序入口 - 直接执行\nprogram.parse();\n"],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyCD,wBAAsB,cAAc,CAAC,OAAO,EAAE,YAAY,iBAkFzD"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `isr-engine test-fallback-local` —— 本地 SSR → SPA fallback 验证代理
|
|
3
|
+
*
|
|
4
|
+
* 行为是 nginx `error_page 5xx = @spa_fallback` 的功能等价物,
|
|
5
|
+
* 让开发者**不装 nginx**也能在本地复现整条降级链路。
|
|
6
|
+
*
|
|
7
|
+
* 监听 :PORT(默认 8080):
|
|
8
|
+
* - /assets/*, /covers/*, /favicon.ico, /logo.svg → dist/client/ 静态返回
|
|
9
|
+
* - /api/* → 反代到 mock/upstream API(默认 :3001)
|
|
10
|
+
* - 其它 → 反代到 SSR(默认 :3000);
|
|
11
|
+
* 5xx 或 connect refused → 切 dist/spa/index.html
|
|
12
|
+
* 兜底响应附带 `x-fallback: spa` 头
|
|
13
|
+
*
|
|
14
|
+
* 用法:
|
|
15
|
+
* pnpm build
|
|
16
|
+
* pnpm --filter mock-server start # :3001
|
|
17
|
+
* isr-engine start # :3000 SSR
|
|
18
|
+
* isr-engine test-fallback-local # :8080 ← 用户访问这个
|
|
19
|
+
* open http://localhost:8080/ # → 看到 SSR 渲染
|
|
20
|
+
* kill <ssr pid>; reload # → 自动看到橙色 banner + SPA 兜底
|
|
21
|
+
* 重启 SSR; reload # → 自动切回 SSR
|
|
22
|
+
*
|
|
23
|
+
* 生产环境**不需要**这个命令 —— 用 nginx 的 error_page 即可。
|
|
24
|
+
*/
|
|
25
|
+
import http from 'node:http';
|
|
26
|
+
export interface FallbackProxyOptions {
|
|
27
|
+
/** 监听端口(用户访问此处) */
|
|
28
|
+
port: string;
|
|
29
|
+
/** SSR 上游端口(isr-engine start 监听的) */
|
|
30
|
+
ssrPort: string;
|
|
31
|
+
/** API 上游端口(mock-server / 真后端) */
|
|
32
|
+
apiPort: string;
|
|
33
|
+
/** dist 根目录(绝对或相对路径,相对 cwd) */
|
|
34
|
+
dist: string;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 创建 fallback 路由 handler(与 listen 解耦),便于单测直接挂到 ephemeral port 上
|
|
38
|
+
* 验证三种分支(static / api proxy / ssr proxy + spa fallback)。
|
|
39
|
+
*/
|
|
40
|
+
export declare function createFallbackRequestHandler(options: FallbackProxyOptions): http.RequestListener;
|
|
41
|
+
export declare function startFallbackProxy(options: FallbackProxyOptions): http.Server;
|
|
42
|
+
//# sourceMappingURL=fallback.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/cli/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AA0GD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,eAAe,CA8BhG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAqB7E"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serverOptions.d.ts","sourceRoot":"","sources":["../../src/cli/serverOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjE"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export { extractRoutesForSitemap, applyTelemetryIntegrationEnv, createProductionJsonMiddleware, nodeToWebRequest, pipeWebResponse, createStaticHtmlMiddleware, createStaticAssetMiddleware, } from '../server/productionRuntime.js';
|
|
2
|
+
interface StartOptions {
|
|
3
|
+
port?: string;
|
|
4
|
+
host?: string;
|
|
5
|
+
}
|
|
6
|
+
export declare function startProductionServer(options: StartOptions): Promise<void>;
|
|
7
|
+
//# sourceMappingURL=start.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/cli/start.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,8BAA8B,EAC9B,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAEpC,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDhF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 框架级默认配置常量
|
|
3
|
+
*
|
|
4
|
+
* 集中管理所有默认值,消除分散在代码各处的硬编码魔数。
|
|
5
|
+
* 业务配置只声明产品/部署意图;底层 HTTP defaults 由 engine 内部管理。
|
|
6
|
+
*/
|
|
7
|
+
/** 默认服务器端口 */
|
|
8
|
+
export declare const DEFAULT_PORT = 3000;
|
|
9
|
+
/** 默认日志文件路径 */
|
|
10
|
+
export declare const DEFAULT_LOG_FILE = "./logs/isr-engine.log";
|
|
11
|
+
//# sourceMappingURL=defaults.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc;AACd,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAe;AACf,eAAO,MAAM,gBAAgB,0BAA0B,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
//#region src/config/defineConfig.ts
|
|
3
|
+
/**
|
|
4
|
+
* ssr.config.ts 的类型收口入口。
|
|
5
|
+
*
|
|
6
|
+
* 业务侧只需要:
|
|
7
|
+
* import { defineIsrConfig } from 'isr-engine/config';
|
|
8
|
+
* export default defineIsrConfig({ ... })
|
|
9
|
+
*
|
|
10
|
+
* 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,
|
|
11
|
+
* 后续字段演进也只改 engine。
|
|
12
|
+
*
|
|
13
|
+
* 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin
|
|
14
|
+
* 工具链打进 RSC/SSG bundle。
|
|
15
|
+
*/
|
|
16
|
+
function defineIsrConfig(config) {
|
|
17
|
+
return config;
|
|
18
|
+
}
|
|
19
|
+
function defineRuntimeConfig(runtime) {
|
|
20
|
+
return runtime;
|
|
21
|
+
}
|
|
22
|
+
//#endregion
|
|
23
|
+
exports.defineIsrConfig = defineIsrConfig;
|
|
24
|
+
exports.defineRuntimeConfig = defineRuntimeConfig;
|
|
25
|
+
|
|
26
|
+
//# sourceMappingURL=defineConfig.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineConfig.cjs","names":[],"sources":["../../src/config/defineConfig.ts"],"sourcesContent":["import type { ISRConfig, RuntimeConfig } from '../types';\n\ntype ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;\ntype IsrServerConfig = ISRConfig['server'];\ntype IsrOpsConfig = IsrServerConfig['ops'];\ntype RuntimeServicesConfig = RuntimeConfig['services'];\ntype ExactOps<T> = T extends { ops: infer Ops }\n ? {\n ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;\n }\n : unknown;\ntype ExactServer<T> = T extends { server: infer Server }\n ? {\n server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;\n }\n : unknown;\ntype ExactRuntimeServices<T> = T extends { services: infer Services }\n ? {\n services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;\n }\n : unknown;\ntype ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> &\n ExactRuntimeServices<T>;\ntype ExactIsrRuntime<T> = T extends { runtime: infer Runtime }\n ? {\n runtime: ExactRuntime<Runtime & RuntimeConfig>;\n }\n : unknown;\ntype ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> &\n ExactServer<T> &\n ExactIsrRuntime<T>;\n\n/**\n * ssr.config.ts 的类型收口入口。\n *\n * 业务侧只需要:\n * import { defineIsrConfig } from 'isr-engine/config';\n * export default defineIsrConfig({ ... })\n *\n * 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,\n * 后续字段演进也只改 engine。\n *\n * 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin\n * 工具链打进 RSC/SSG bundle。\n */\nexport function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T {\n return config;\n}\n\nexport function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T {\n return runtime;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6CA,SAAgB,gBAA2C,QAA8B;CACvF,OAAO;AACT;AAEA,SAAgB,oBAAmD,SAA6B;CAC9F,OAAO;AACT"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ISRConfig, RuntimeConfig } from '../types';
|
|
2
|
+
type ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;
|
|
3
|
+
type IsrServerConfig = ISRConfig['server'];
|
|
4
|
+
type IsrOpsConfig = IsrServerConfig['ops'];
|
|
5
|
+
type RuntimeServicesConfig = RuntimeConfig['services'];
|
|
6
|
+
type ExactOps<T> = T extends {
|
|
7
|
+
ops: infer Ops;
|
|
8
|
+
} ? {
|
|
9
|
+
ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;
|
|
10
|
+
} : unknown;
|
|
11
|
+
type ExactServer<T> = T extends {
|
|
12
|
+
server: infer Server;
|
|
13
|
+
} ? {
|
|
14
|
+
server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;
|
|
15
|
+
} : unknown;
|
|
16
|
+
type ExactRuntimeServices<T> = T extends {
|
|
17
|
+
services: infer Services;
|
|
18
|
+
} ? {
|
|
19
|
+
services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;
|
|
20
|
+
} : unknown;
|
|
21
|
+
type ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> & ExactRuntimeServices<T>;
|
|
22
|
+
type ExactIsrRuntime<T> = T extends {
|
|
23
|
+
runtime: infer Runtime;
|
|
24
|
+
} ? {
|
|
25
|
+
runtime: ExactRuntime<Runtime & RuntimeConfig>;
|
|
26
|
+
} : unknown;
|
|
27
|
+
type ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> & ExactServer<T> & ExactIsrRuntime<T>;
|
|
28
|
+
/**
|
|
29
|
+
* ssr.config.ts 的类型收口入口。
|
|
30
|
+
*
|
|
31
|
+
* 业务侧只需要:
|
|
32
|
+
* import { defineIsrConfig } from 'isr-engine/config';
|
|
33
|
+
* export default defineIsrConfig({ ... })
|
|
34
|
+
*
|
|
35
|
+
* 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,
|
|
36
|
+
* 后续字段演进也只改 engine。
|
|
37
|
+
*
|
|
38
|
+
* 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin
|
|
39
|
+
* 工具链打进 RSC/SSG bundle。
|
|
40
|
+
*/
|
|
41
|
+
export declare function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T;
|
|
42
|
+
export declare function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T;
|
|
43
|
+
export {};
|
|
44
|
+
//# sourceMappingURL=defineConfig.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineConfig.d.ts","sourceRoot":"","sources":["../../src/config/defineConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzD,KAAK,aAAa,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AAChF,KAAK,eAAe,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC3C,KAAK,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;AAC3C,KAAK,qBAAqB,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;AACvD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,GAAG,EAAE,MAAM,GAAG,CAAA;CAAE,GAC3C;IACE,GAAG,EAAE,aAAa,CAAC,GAAG,GAAG,YAAY,EAAE,YAAY,CAAC,CAAC;CACtD,GACD,OAAO,CAAC;AACZ,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,MAAM,CAAA;CAAE,GACpD;IACE,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,eAAe,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrF,GACD,OAAO,CAAC;AACZ,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;CAAE,GACjE;IACE,QAAQ,EAAE,aAAa,CAAC,QAAQ,GAAG,qBAAqB,EAAE,qBAAqB,CAAC,CAAC;CAClF,GACD,OAAO,CAAC;AACZ,KAAK,YAAY,CAAC,CAAC,SAAS,aAAa,IAAI,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,GAC1E,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC1B,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,OAAO,CAAA;CAAE,GAC1D;IACE,OAAO,EAAE,YAAY,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC;CAChD,GACD,OAAO,CAAC;AACZ,KAAK,cAAc,CAAC,CAAC,SAAS,SAAS,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,GACpE,WAAW,CAAC,CAAC,CAAC,GACd,eAAe,CAAC,CAAC,CAAC,CAAC;AAErB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAEvF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAE9F"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
//#region src/config/defineConfig.ts
|
|
2
|
+
/**
|
|
3
|
+
* ssr.config.ts 的类型收口入口。
|
|
4
|
+
*
|
|
5
|
+
* 业务侧只需要:
|
|
6
|
+
* import { defineIsrConfig } from 'isr-engine/config';
|
|
7
|
+
* export default defineIsrConfig({ ... })
|
|
8
|
+
*
|
|
9
|
+
* 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,
|
|
10
|
+
* 后续字段演进也只改 engine。
|
|
11
|
+
*
|
|
12
|
+
* 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin
|
|
13
|
+
* 工具链打进 RSC/SSG bundle。
|
|
14
|
+
*/
|
|
15
|
+
function defineIsrConfig(config) {
|
|
16
|
+
return config;
|
|
17
|
+
}
|
|
18
|
+
function defineRuntimeConfig(runtime) {
|
|
19
|
+
return runtime;
|
|
20
|
+
}
|
|
21
|
+
//#endregion
|
|
22
|
+
export { defineIsrConfig, defineRuntimeConfig };
|
|
23
|
+
|
|
24
|
+
//# sourceMappingURL=defineConfig.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"defineConfig.js","names":[],"sources":["../../src/config/defineConfig.ts"],"sourcesContent":["import type { ISRConfig, RuntimeConfig } from '../types';\n\ntype ExactTopLevel<T, Shape> = T & Record<Exclude<keyof T, keyof Shape>, never>;\ntype IsrServerConfig = ISRConfig['server'];\ntype IsrOpsConfig = IsrServerConfig['ops'];\ntype RuntimeServicesConfig = RuntimeConfig['services'];\ntype ExactOps<T> = T extends { ops: infer Ops }\n ? {\n ops: ExactTopLevel<Ops & IsrOpsConfig, IsrOpsConfig>;\n }\n : unknown;\ntype ExactServer<T> = T extends { server: infer Server }\n ? {\n server: ExactTopLevel<Server & IsrServerConfig, IsrServerConfig> & ExactOps<Server>;\n }\n : unknown;\ntype ExactRuntimeServices<T> = T extends { services: infer Services }\n ? {\n services: ExactTopLevel<Services & RuntimeServicesConfig, RuntimeServicesConfig>;\n }\n : unknown;\ntype ExactRuntime<T extends RuntimeConfig> = ExactTopLevel<T, RuntimeConfig> &\n ExactRuntimeServices<T>;\ntype ExactIsrRuntime<T> = T extends { runtime: infer Runtime }\n ? {\n runtime: ExactRuntime<Runtime & RuntimeConfig>;\n }\n : unknown;\ntype ExactIsrConfig<T extends ISRConfig> = ExactTopLevel<T, ISRConfig> &\n ExactServer<T> &\n ExactIsrRuntime<T>;\n\n/**\n * ssr.config.ts 的类型收口入口。\n *\n * 业务侧只需要:\n * import { defineIsrConfig } from 'isr-engine/config';\n * export default defineIsrConfig({ ... })\n *\n * 不需要维护 `satisfies ISRConfig` 这类类型技巧。配置形状由 engine API 统一承接,\n * 后续字段演进也只改 engine。\n *\n * 注意:ssr.config.ts 应从 isr-engine/config 导入,避免根入口把 CLI/plugin\n * 工具链打进 RSC/SSG bundle。\n */\nexport function defineIsrConfig<const T extends ISRConfig>(config: ExactIsrConfig<T>): T {\n return config;\n}\n\nexport function defineRuntimeConfig<const T extends RuntimeConfig>(runtime: ExactRuntime<T>): T {\n return runtime;\n}\n"],"mappings":";;;;;;;;;;;;;;AA6CA,SAAgB,gBAA2C,QAA8B;CACvF,OAAO;AACT;AAEA,SAAgB,oBAAmD,SAA6B;CAC9F,OAAO;AACT"}
|