isr-engine 0.0.0-stage → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +755 -0
- package/README.md +170 -2
- package/dist/RequestContext-BVQ-rOmV.js +58 -0
- package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
- package/dist/RequestContext-DgGEAxcW.cjs +105 -0
- package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
- package/dist/abVariantContext-CWCdRSdG.js +549 -0
- package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
- package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
- package/dist/adapters/observability/client/sentry.d.ts +42 -0
- package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/index.cjs +152 -0
- package/dist/adapters/observability/index.cjs.map +1 -0
- package/dist/adapters/observability/index.d.ts +17 -0
- package/dist/adapters/observability/index.d.ts.map +1 -0
- package/dist/adapters/observability/index.js +148 -0
- package/dist/adapters/observability/index.js.map +1 -0
- package/dist/adapters/observability/server/datadog.d.ts +45 -0
- package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
- package/dist/adapters/observability/server/otel.d.ts +51 -0
- package/dist/adapters/observability/server/otel.d.ts.map +1 -0
- package/dist/adapters/observability/server/sentry.d.ts +67 -0
- package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
- package/dist/adapters/observability/types.d.ts +39 -0
- package/dist/adapters/observability/types.d.ts.map +1 -0
- package/dist/adapters/runtime/cloudflare.d.ts +33 -0
- package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
- package/dist/adapters/runtime/errorResponse.d.ts +3 -0
- package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
- package/dist/adapters/runtime/index.cjs +100 -0
- package/dist/adapters/runtime/index.cjs.map +1 -0
- package/dist/adapters/runtime/index.d.ts +10 -0
- package/dist/adapters/runtime/index.d.ts.map +1 -0
- package/dist/adapters/runtime/index.js +97 -0
- package/dist/adapters/runtime/index.js.map +1 -0
- package/dist/adapters/runtime/types.d.ts +24 -0
- package/dist/adapters/runtime/types.d.ts.map +1 -0
- package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
- package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
- package/dist/app/createISRApp.d.ts +19 -0
- package/dist/app/createISRApp.d.ts.map +1 -0
- package/dist/cache/CacheManager.d.ts +81 -0
- package/dist/cache/CacheManager.d.ts.map +1 -0
- package/dist/cache/ICacheAdapter.d.ts +84 -0
- package/dist/cache/ICacheAdapter.d.ts.map +1 -0
- package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
- package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisCacheAdapter.d.ts +111 -0
- package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
- package/dist/cache/RedisInvalidationBus.d.ts +59 -0
- package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
- package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/ResponseCacheBackend.d.ts +28 -0
- package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
- package/dist/cache/createAutoCacheStore.d.ts +26 -0
- package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
- package/dist/cache/index.d.ts +18 -0
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cli/cli.cjs +372 -0
- package/dist/cli/cli.cjs.map +1 -0
- package/dist/cli/cli.d.ts +8 -0
- package/dist/cli/cli.d.ts.map +1 -0
- package/dist/cli/cli.js +370 -0
- package/dist/cli/cli.js.map +1 -0
- package/dist/cli/dev.d.ts +11 -0
- package/dist/cli/dev.d.ts.map +1 -0
- package/dist/cli/fallback.d.ts +42 -0
- package/dist/cli/fallback.d.ts.map +1 -0
- package/dist/cli/serverOptions.d.ts +7 -0
- package/dist/cli/serverOptions.d.ts.map +1 -0
- package/dist/cli/start.d.ts +7 -0
- package/dist/cli/start.d.ts.map +1 -0
- package/dist/config/defaults.d.ts +11 -0
- package/dist/config/defaults.d.ts.map +1 -0
- package/dist/config/defineConfig.cjs +26 -0
- package/dist/config/defineConfig.cjs.map +1 -0
- package/dist/config/defineConfig.d.ts +44 -0
- package/dist/config/defineConfig.d.ts.map +1 -0
- package/dist/config/defineConfig.js +24 -0
- package/dist/config/defineConfig.js.map +1 -0
- package/dist/config/getEnv.d.ts +9 -0
- package/dist/config/getEnv.d.ts.map +1 -0
- package/dist/config/getStatus.d.ts +3 -0
- package/dist/config/getStatus.d.ts.map +1 -0
- package/dist/config/loadConfig.d.ts +18 -0
- package/dist/config/loadConfig.d.ts.map +1 -0
- package/dist/config/normalizeEngineConfig.d.ts +10 -0
- package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
- package/dist/config/resolveImageOptions.d.ts +5 -0
- package/dist/config/resolveImageOptions.d.ts.map +1 -0
- package/dist/config/resolveRuntimeRedis.d.ts +11 -0
- package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
- package/dist/context/RequestContext.d.ts +28 -0
- package/dist/context/RequestContext.d.ts.map +1 -0
- package/dist/context/createServerRequestContext.d.ts +42 -0
- package/dist/context/createServerRequestContext.d.ts.map +1 -0
- package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs +105 -0
- package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs.map +1 -0
- package/dist/createCacheInspectorMiddleware-Dmuobpcb.js +105 -0
- package/dist/createCacheInspectorMiddleware-Dmuobpcb.js.map +1 -0
- package/dist/createISRApp-CDkyUuW3.js +7321 -0
- package/dist/createISRApp-CDkyUuW3.js.map +1 -0
- package/dist/createISRApp-Nv9mwX8I.cjs +7662 -0
- package/dist/createISRApp-Nv9mwX8I.cjs.map +1 -0
- package/dist/createImagePlugin-BVUPlPOz.js +416 -0
- package/dist/createImagePlugin-BVUPlPOz.js.map +1 -0
- package/dist/createImagePlugin-D-X_HGlR.cjs +435 -0
- package/dist/createImagePlugin-D-X_HGlR.cjs.map +1 -0
- package/dist/defaults/auto-observability.cjs +147 -0
- package/dist/defaults/auto-observability.cjs.map +1 -0
- package/dist/defaults/auto-observability.d.ts +21 -0
- package/dist/defaults/auto-observability.d.ts.map +1 -0
- package/dist/defaults/auto-observability.js +144 -0
- package/dist/defaults/auto-observability.js.map +1 -0
- package/dist/defaults/runtime/browserObservability.d.ts +73 -0
- package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
- package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
- package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
- package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
- package/dist/defaults/runtime/defineSiteHooks.js +3 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
- package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
- package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
- package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
- package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
- package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
- package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
- package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
- package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
- package/dist/defaults/runtime/empty-routes.d.ts +3 -0
- package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
- package/dist/defaults/runtime/error-boundary.d.ts +9 -0
- package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
- package/dist/defaults/runtime/error500-template.d.ts +21 -0
- package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
- package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
- package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
- package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
- package/dist/defaults/runtime/i18n-server.d.ts +7 -0
- package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
- package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
- package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
- package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
- package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
- package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
- package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
- package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
- package/dist/discovery/componentDiscovery.d.ts +71 -0
- package/dist/discovery/componentDiscovery.d.ts.map +1 -0
- package/dist/discovery/directiveParser.d.ts +197 -0
- package/dist/discovery/directiveParser.d.ts.map +1 -0
- package/dist/discovery/exportParser.d.ts +45 -0
- package/dist/discovery/exportParser.d.ts.map +1 -0
- package/dist/discovery/fileSystem.d.ts +33 -0
- package/dist/discovery/fileSystem.d.ts.map +1 -0
- package/dist/discovery/index.d.ts +18 -0
- package/dist/discovery/index.d.ts.map +1 -0
- package/dist/discovery/routeDiscovery.d.ts +121 -0
- package/dist/discovery/routeDiscovery.d.ts.map +1 -0
- package/dist/discovery/scan.d.ts +54 -0
- package/dist/discovery/scan.d.ts.map +1 -0
- package/dist/discovery/types.d.ts +61 -0
- package/dist/discovery/types.d.ts.map +1 -0
- package/dist/engine/ISREngine.d.ts +54 -0
- package/dist/engine/ISREngine.d.ts.map +1 -0
- package/dist/engine/RenderMode.d.ts +23 -0
- package/dist/engine/RenderMode.d.ts.map +1 -0
- package/dist/engine/i18n/types.d.ts +6 -0
- package/dist/engine/i18n/types.d.ts.map +1 -0
- package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
- package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/SEOEngine.d.ts +61 -0
- package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
- package/dist/engine/seo/config.d.ts +9 -0
- package/dist/engine/seo/config.d.ts.map +1 -0
- package/dist/engine/seo/index.d.ts +10 -0
- package/dist/engine/seo/index.d.ts.map +1 -0
- package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
- package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
- package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
- package/dist/engine/seo/types.d.ts +75 -0
- package/dist/engine/seo/types.d.ts.map +1 -0
- package/dist/error500-template-BvZmvKoa.cjs +63 -0
- package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
- package/dist/error500-template-DhaZzLOB.js +63 -0
- package/dist/error500-template-DhaZzLOB.js.map +1 -0
- package/dist/experiments/ExposureQueue.d.ts +54 -0
- package/dist/experiments/ExposureQueue.d.ts.map +1 -0
- package/dist/experiments/ManifestLoader.d.ts +57 -0
- package/dist/experiments/ManifestLoader.d.ts.map +1 -0
- package/dist/i18n-CyJIoYJT.cjs +244 -0
- package/dist/i18n-CyJIoYJT.cjs.map +1 -0
- package/dist/i18n-Dobe0Wxn.js +191 -0
- package/dist/i18n-Dobe0Wxn.js.map +1 -0
- package/dist/image/index.cjs +93 -0
- package/dist/image/index.cjs.map +1 -0
- package/dist/image/index.js +67 -0
- package/dist/image/index.js.map +1 -0
- package/dist/index.d.ts +59 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/isr/ISRRoutes.d.ts +25 -0
- package/dist/isr/ISRRoutes.d.ts.map +1 -0
- package/dist/isr-engine.cjs +2830 -0
- package/dist/isr-engine.cjs.map +1 -0
- package/dist/isr-engine.js +2740 -0
- package/dist/isr-engine.js.map +1 -0
- package/dist/logger/Logger.d.ts +33 -0
- package/dist/logger/Logger.d.ts.map +1 -0
- package/dist/logger/index.d.ts +3 -0
- package/dist/logger/index.d.ts.map +1 -0
- package/dist/manifest/ManifestLoader.d.ts +98 -0
- package/dist/manifest/ManifestLoader.d.ts.map +1 -0
- package/dist/manifest/index.d.ts +8 -0
- package/dist/manifest/index.d.ts.map +1 -0
- package/dist/manifest/types.d.ts +76 -0
- package/dist/manifest/types.d.ts.map +1 -0
- package/dist/metrics/MetricsCollector.d.ts +90 -0
- package/dist/metrics/MetricsCollector.d.ts.map +1 -0
- package/dist/metrics/PromMetrics.d.ts +59 -0
- package/dist/metrics/PromMetrics.d.ts.map +1 -0
- package/dist/metrics/index.d.ts +7 -0
- package/dist/metrics/index.d.ts.map +1 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
- package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
- package/dist/middlewares/LocaleRedirect.d.ts +27 -0
- package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
- package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
- package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
- package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/TraceMiddleware.d.ts +24 -0
- package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
- package/dist/middlewares/abVariantContext.d.ts +7 -0
- package/dist/middlewares/abVariantContext.d.ts.map +1 -0
- package/dist/middlewares/index.d.ts +5 -0
- package/dist/middlewares/index.d.ts.map +1 -0
- package/dist/middlewares/types.d.ts +4 -0
- package/dist/middlewares/types.d.ts.map +1 -0
- package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
- package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
- package/dist/plugin/coherentCacheStore.d.ts +11 -0
- package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
- package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
- package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
- package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
- package/dist/plugin/createFontPlugin.d.ts +15 -0
- package/dist/plugin/createFontPlugin.d.ts.map +1 -0
- package/dist/plugin/createImagePlugin.d.ts +46 -0
- package/dist/plugin/createImagePlugin.d.ts.map +1 -0
- package/dist/plugin/createIsrPlugin.d.ts +43 -0
- package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
- package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
- package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
- package/dist/plugin/index.d.ts +11 -0
- package/dist/plugin/index.d.ts.map +1 -0
- package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
- package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
- package/dist/plugin/isrCacheStore.d.ts +88 -0
- package/dist/plugin/isrCacheStore.d.ts.map +1 -0
- package/dist/plugin/remoteImageSource.d.ts +19 -0
- package/dist/plugin/remoteImageSource.d.ts.map +1 -0
- package/dist/plugin/transformDevCssModule.d.ts +3 -0
- package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
- package/dist/renderer/RenderHeaders.d.ts +28 -0
- package/dist/renderer/RenderHeaders.d.ts.map +1 -0
- package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
- package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
- package/dist/route/RouteManager.d.ts +22 -0
- package/dist/route/RouteManager.d.ts.map +1 -0
- package/dist/route/index.d.ts +2 -0
- package/dist/route/index.d.ts.map +1 -0
- package/dist/rsc/ServerActions.d.ts +65 -0
- package/dist/rsc/ServerActions.d.ts.map +1 -0
- package/dist/rsc/browser.cjs +109 -0
- package/dist/rsc/browser.cjs.map +1 -0
- package/dist/rsc/browser.d.ts +59 -0
- package/dist/rsc/browser.d.ts.map +1 -0
- package/dist/rsc/browser.js +85 -0
- package/dist/rsc/browser.js.map +1 -0
- package/dist/rsc/cacheTag.d.ts +52 -0
- package/dist/rsc/cacheTag.d.ts.map +1 -0
- package/dist/rsc/constants.d.ts +10 -0
- package/dist/rsc/constants.d.ts.map +1 -0
- package/dist/rsc/i18n.d.ts +3 -0
- package/dist/rsc/i18n.d.ts.map +1 -0
- package/dist/rsc/index.cjs +33 -0
- package/dist/rsc/index.d.ts +20 -0
- package/dist/rsc/index.d.ts.map +1 -0
- package/dist/rsc/index.js +4 -0
- package/dist/rsc/revalidate.d.ts +77 -0
- package/dist/rsc/revalidate.d.ts.map +1 -0
- package/dist/rsc-H7D_meHu.cjs +239 -0
- package/dist/rsc-H7D_meHu.cjs.map +1 -0
- package/dist/rsc-lvWPTuVD.js +168 -0
- package/dist/rsc-lvWPTuVD.js.map +1 -0
- package/dist/runtime/Image.d.ts +48 -0
- package/dist/runtime/Image.d.ts.map +1 -0
- package/dist/runtime/LocaleContext.d.ts +14 -0
- package/dist/runtime/LocaleContext.d.ts.map +1 -0
- package/dist/runtime/boundary.d.ts +27 -0
- package/dist/runtime/boundary.d.ts.map +1 -0
- package/dist/runtime/edge-context.d.ts +17 -0
- package/dist/runtime/edge-context.d.ts.map +1 -0
- package/dist/runtime/i18n-store.d.ts +11 -0
- package/dist/runtime/i18n-store.d.ts.map +1 -0
- package/dist/runtime/i18n.d.ts +115 -0
- package/dist/runtime/i18n.d.ts.map +1 -0
- package/dist/runtime/index.d.ts +16 -0
- package/dist/runtime/index.d.ts.map +1 -0
- package/dist/runtime/routes.d.ts +88 -0
- package/dist/runtime/routes.d.ts.map +1 -0
- package/dist/runtime/telemetry.d.ts +48 -0
- package/dist/runtime/telemetry.d.ts.map +1 -0
- package/dist/security/cspNonceTemplate.d.ts +10 -0
- package/dist/security/cspNonceTemplate.d.ts.map +1 -0
- package/dist/security/staticCspManifest.d.ts +37 -0
- package/dist/security/staticCspManifest.d.ts.map +1 -0
- package/dist/server/httpServer.d.ts +17 -0
- package/dist/server/httpServer.d.ts.map +1 -0
- package/dist/server/index.d.ts +3 -0
- package/dist/server/index.d.ts.map +1 -0
- package/dist/server/manager.d.ts +17 -0
- package/dist/server/manager.d.ts.map +1 -0
- package/dist/server/middleware.d.ts +87 -0
- package/dist/server/middleware.d.ts.map +1 -0
- package/dist/server/opsConfig.d.ts +17 -0
- package/dist/server/opsConfig.d.ts.map +1 -0
- package/dist/server/productionRuntime.d.ts +41 -0
- package/dist/server/productionRuntime.d.ts.map +1 -0
- package/dist/server/types.d.ts +41 -0
- package/dist/server/types.d.ts.map +1 -0
- package/dist/server/viteDevServer.d.ts +21 -0
- package/dist/server/viteDevServer.d.ts.map +1 -0
- package/dist/ssg/spider.d.ts +142 -0
- package/dist/ssg/spider.d.ts.map +1 -0
- package/dist/types/IFlightData.d.ts +23 -0
- package/dist/types/IFlightData.d.ts.map +1 -0
- package/dist/types/IHelmetData.d.ts +24 -0
- package/dist/types/IHelmetData.d.ts.map +1 -0
- package/dist/types/IRenderMetadata.d.ts +46 -0
- package/dist/types/IRenderMetadata.d.ts.map +1 -0
- package/dist/types/IRenderResult.d.ts +16 -0
- package/dist/types/IRenderResult.d.ts.map +1 -0
- package/dist/types/ISRConfig.d.ts +463 -0
- package/dist/types/ISRConfig.d.ts.map +1 -0
- package/dist/types/ISRContext.d.ts +104 -0
- package/dist/types/ISRContext.d.ts.map +1 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/utils/CacheCleanup.d.ts +32 -0
- package/dist/utils/CacheCleanup.d.ts.map +1 -0
- package/dist/utils/cacheDuration.d.ts +12 -0
- package/dist/utils/cacheDuration.d.ts.map +1 -0
- package/dist/utils/cookie.d.ts +7 -0
- package/dist/utils/cookie.d.ts.map +1 -0
- package/dist/utils/hash.d.ts +22 -0
- package/dist/utils/hash.d.ts.map +1 -0
- package/dist/utils/htmlPathname.d.ts +12 -0
- package/dist/utils/htmlPathname.d.ts.map +1 -0
- package/dist/utils/index.d.ts +9 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/resolveFetchHandler.d.ts +4 -0
- package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
- package/dist/utils/trimTrailingSlashes.d.ts +3 -0
- package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
- package/package.json +199 -4
- package/src/context/RequestContext.ts +68 -0
- package/src/context/createServerRequestContext.ts +104 -0
- package/src/defaults/auto-observability.ts +195 -0
- package/src/defaults/entry.server.ssr.tsx +257 -0
- package/src/defaults/entry.server.tsx +117 -0
- package/src/defaults/entry.tsx +23 -0
- package/src/defaults/runtime/browserObservability.ts +837 -0
- package/src/defaults/runtime/client-navigation-policy.ts +67 -0
- package/src/defaults/runtime/createCachedFetcher.ts +121 -0
- package/src/defaults/runtime/defineClientEntry.tsx +773 -0
- package/src/defaults/runtime/defineServerEntry.tsx +421 -0
- package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
- package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
- package/src/defaults/runtime/dev-render-inspector.ts +597 -0
- package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
- package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
- package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
- package/src/defaults/runtime/dev-style-id.ts +91 -0
- package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
- package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
- package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +41 -0
- package/src/defaults/runtime/empty-config.ts +5 -0
- package/src/defaults/runtime/empty-routes.ts +2 -0
- package/src/defaults/runtime/error-boundary.style.css +35 -0
- package/src/defaults/runtime/error-boundary.tsx +65 -0
- package/src/defaults/runtime/error500-template.ts +66 -0
- package/src/defaults/runtime/head-extras-runtime.ts +64 -0
- package/src/defaults/runtime/hydration-shell.tsx +20 -0
- package/src/defaults/runtime/i18n-server.ts +27 -0
- package/src/defaults/runtime/navigation-history.client.ts +80 -0
- package/src/defaults/runtime/navigation-request.client.ts +21 -0
- package/src/defaults/runtime/request.tsx +100 -0
- package/src/defaults/runtime/seo-runtime.ts +257 -0
- package/src/defaults/tsconfig.json +10 -0
- package/src/defaults/types.d.ts +23 -0
- package/src/runtime/Image.tsx +124 -0
- package/src/runtime/LocaleContext.tsx +38 -0
- package/src/runtime/boundary.module.css +46 -0
- package/src/runtime/boundary.tsx +136 -0
- package/src/runtime/edge-context.ts +32 -0
- package/src/runtime/i18n-store.ts +76 -0
- package/src/runtime/i18n.ts +189 -0
- package/src/runtime/index.ts +61 -0
- package/src/runtime/routes.tsx +247 -0
- package/src/runtime/scss.d.ts +13 -0
- package/src/runtime/telemetry.ts +116 -0
- package/src/types/IFlightData.ts +27 -0
- package/src/types/IHelmetData.ts +9 -0
- package/src/types/IRenderMetadata.ts +52 -0
- package/src/types/IRenderResult.ts +16 -0
- package/src/types/ISRConfig.ts +507 -0
- package/src/types/ISRContext.ts +106 -0
- package/src/types/index.ts +6 -0
- package/src/utils/CacheCleanup.ts +74 -0
- package/src/utils/cacheDuration.ts +37 -0
- package/src/utils/cookie.ts +59 -0
- package/src/utils/hash.ts +32 -0
- package/src/utils/htmlPathname.ts +75 -0
- package/src/utils/index.ts +9 -0
- package/src/utils/resolveFetchHandler.ts +17 -0
- package/src/utils/trimTrailingSlashes.ts +6 -0
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 获取环境变量
|
|
3
|
+
* @param key 环境变量名
|
|
4
|
+
* @param defaultValue 默认值 (支持 string | number | boolean)
|
|
5
|
+
* @returns 环境变量值或默认值
|
|
6
|
+
*/
|
|
7
|
+
export declare function getEnv<T extends string | number | boolean>(key: string, defaultValue: T): T;
|
|
8
|
+
export declare function getEnv(key: string): string | undefined;
|
|
9
|
+
//# sourceMappingURL=getEnv.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"getEnv.d.ts","sourceRoot":"","sources":["../../src/config/getEnv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;AAC7F,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"getStatus.d.ts","sourceRoot":"","sources":["../../src/config/getStatus.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,QAAO,OAA8C,CAAC;AAExE,eAAO,MAAM,MAAM,QAAO,OAA8C,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 配置加载工具
|
|
3
|
+
*/
|
|
4
|
+
import type { ISRConfig } from '../types/index.js';
|
|
5
|
+
export interface LoadConfigOptions {
|
|
6
|
+
forceReload?: boolean;
|
|
7
|
+
cwd?: string;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* 加载项目配置
|
|
11
|
+
* 支持运行时动态更新和加载 ssr.config.ts 等配置文件
|
|
12
|
+
*/
|
|
13
|
+
export declare function loadConfig(options?: LoadConfigOptions): Promise<ISRConfig>;
|
|
14
|
+
/**
|
|
15
|
+
* 清除配置缓存
|
|
16
|
+
*/
|
|
17
|
+
export declare function clearConfigCache(): void;
|
|
18
|
+
//# sourceMappingURL=loadConfig.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AASzC,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqCpF;AAmED;;GAEG;AACH,wBAAgB,gBAAgB,SAE/B"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { ISRConfig } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Engine-owned config normalization.
|
|
4
|
+
*
|
|
5
|
+
* User config should describe product/deployment intent. Operational defaults such as
|
|
6
|
+
* "use in-process ISR cache when no Redis connection is available" belong here, not in
|
|
7
|
+
* each application's ssr.config.ts.
|
|
8
|
+
*/
|
|
9
|
+
export declare function normalizeEngineConfig(config: ISRConfig): ISRConfig;
|
|
10
|
+
//# sourceMappingURL=normalizeEngineConfig.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"normalizeEngineConfig.d.ts","sourceRoot":"","sources":["../../src/config/normalizeEngineConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAqDlE"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveImageOptions.d.ts","sourceRoot":"","sources":["../../src/config/resolveImageOptions.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG;IAAE,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAkClF"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { RuntimeRedisConfig } from '../types/index.js';
|
|
2
|
+
/**
|
|
3
|
+
* Resolve Redis connection from runtime config only.
|
|
4
|
+
*
|
|
5
|
+
* A non-empty runtime.redis.url/host enables Redis; missing connection data means the
|
|
6
|
+
* engine stays on memory-backed defaults. Environment variables must be wired explicitly
|
|
7
|
+
* in ssr.config.ts so the config file remains the single source of truth.
|
|
8
|
+
*/
|
|
9
|
+
export declare function resolveRuntimeRedisConfig(redis?: RuntimeRedisConfig): RuntimeRedisConfig | undefined;
|
|
10
|
+
export declare function hasRuntimeRedisConnection(redis?: RuntimeRedisConfig): boolean;
|
|
11
|
+
//# sourceMappingURL=resolveRuntimeRedis.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolveRuntimeRedis.d.ts","sourceRoot":"","sources":["../../src/config/resolveRuntimeRedis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOlD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,CAAC,EAAE,kBAAkB,GACzB,kBAAkB,GAAG,SAAS,CA8BhC;AAED,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAG7E"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { AsyncLocalStorage } from 'async_hooks';
|
|
2
|
+
import type { ISRContextData } from '../types/ISRContext';
|
|
3
|
+
export type RequestContextState = ISRContextData;
|
|
4
|
+
export declare const requestContext: AsyncLocalStorage<ISRContextData>;
|
|
5
|
+
export declare const getRequestContext: () => RequestContextState | undefined;
|
|
6
|
+
export declare const getTraceId: () => string;
|
|
7
|
+
export declare const getRequestId: () => string;
|
|
8
|
+
/**
|
|
9
|
+
* 获取 anonId —— 浏览器 / 设备维度稳定 UUID。
|
|
10
|
+
*
|
|
11
|
+
* engine 入口 createServerRequestContext 已保证 RequestContext 存在时这个字段必有值
|
|
12
|
+
* (cookie 缺失会自动生成);context 不在时(极少数 dev / unit-test 场景)返回 'system'。
|
|
13
|
+
* 业务侧用法:feature gating、telemetry user 维度聚合、个性化推荐 anchor。
|
|
14
|
+
*/
|
|
15
|
+
export declare const getAnonId: () => string;
|
|
16
|
+
/**
|
|
17
|
+
* 获取已登录用户 ID。业务侧 beforeRequest hook 解 session 写入;未登录返回 null。
|
|
18
|
+
* 注意:不要把这里返回的字符串当 anonId 用 —— anonId 跨登录态稳定(一个浏览器永远
|
|
19
|
+
* 同一份),userId 跨设备稳定但匿名期为 null。两者职责不同。
|
|
20
|
+
*/
|
|
21
|
+
export declare const getUserId: () => string | null;
|
|
22
|
+
/**
|
|
23
|
+
* 获取本次请求生效的全部实验变体 —— `{ 'hero-style': 'bold', ... }`。
|
|
24
|
+
* 由 ABVariantMiddleware 基于 hash(anonId + expKey) 确定性算出,不在 cookie 里持久化。
|
|
25
|
+
* 没接 ABVariantMiddleware 时返回空对象。
|
|
26
|
+
*/
|
|
27
|
+
export declare const getExperiments: () => Record<string, string>;
|
|
28
|
+
//# sourceMappingURL=RequestContext.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"RequestContext.d.ts","sourceRoot":"","sources":["../../src/context/RequestContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAcjD,eAAO,MAAM,cAAc,mCAA4B,CAAC;AAGxD,eAAO,MAAM,iBAAiB,QAAO,mBAAmB,GAAG,SAE1D,CAAC;AAGF,eAAO,MAAM,UAAU,QAAO,MAG7B,CAAC;AAGF,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,QAAO,MAG5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,IAGrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAGtD,CAAC"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
import type { ISRContextData } from '../types/ISRContext';
|
|
3
|
+
/** anonId cookie 名称 —— engine 全局常量,避免散落字符串。 */
|
|
4
|
+
export declare const ANON_COOKIE_NAME = "anon";
|
|
5
|
+
/** anonId cookie 有效期(秒)。1 年;浏览器侧最大也只能撑到这个量级。 */
|
|
6
|
+
export declare const ANON_COOKIE_MAX_AGE_SECONDS: number;
|
|
7
|
+
export interface CreatedRequestContext {
|
|
8
|
+
/** 直接喂给 requestContext.run() 的 ISRContextData 实例 */
|
|
9
|
+
data: ISRContextData;
|
|
10
|
+
/** true 表示 anonId 是本次新生成的,调用方需要把 Set-Cookie 写到响应头 */
|
|
11
|
+
needsAnonCookie: boolean;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* 从 IncomingMessage 构造 ISRContextData。
|
|
15
|
+
*
|
|
16
|
+
* 优先级:
|
|
17
|
+
* - traceId: W3C traceparent header → 自生成 UUID
|
|
18
|
+
* - requestId: X-Request-Id header → 自生成 UUID
|
|
19
|
+
* - anonId: cookie `anon` → 自生成 UUID(needsAnonCookie=true)
|
|
20
|
+
*
|
|
21
|
+
* userId / sessionToken / sessionUser 留空 —— 业务侧 beforeRequest hook 写入。
|
|
22
|
+
*/
|
|
23
|
+
export declare function createServerRequestContext(req: IncomingMessage): CreatedRequestContext;
|
|
24
|
+
/**
|
|
25
|
+
* 把 anonId Set-Cookie 头写进响应。
|
|
26
|
+
*
|
|
27
|
+
* Set-Cookie 写在 cache lookup 之前(live 响应 client 必收到),但 cache 层
|
|
28
|
+
* 在 captureAndStore 里会从存储的 headers 里剥掉 anon 这条 —— cache entry 永远
|
|
29
|
+
* user-agnostic,可以被多个 anonId 命中(cache key 走 ctx.experiments digest 隔离)。
|
|
30
|
+
*
|
|
31
|
+
* 参数:HttpOnly=false 让客户端 SDK 能读取做曝光上报;SameSite=Lax 让 GET 请求
|
|
32
|
+
* 跨站跳转也带(搜索引擎结果点击进来不会丢 anonId);Path=/ 全站共享。
|
|
33
|
+
* Secure 不强制 —— dev http 也要工作;生产 HTTPS 由 reverse proxy 自动加 Secure 标记
|
|
34
|
+
* 不在 engine 侧加。
|
|
35
|
+
*
|
|
36
|
+
* @param cookieDomain 可选 `Domain` 属性。子域分发部署(www.x / admin.x / api.x)
|
|
37
|
+
* 时设 `.your-domain.com`,让浏览器把 anon cookie 自动带到所有子域 ——
|
|
38
|
+
* SSR 在 www 写、admin-server 在 api 读、客户端 SDK 在 www 读,都能拿到。
|
|
39
|
+
* 单一域名部署时留空,浏览器只把 cookie 关联到当前 host。
|
|
40
|
+
*/
|
|
41
|
+
export declare function applyAnonCookie(res: ServerResponse, anonId: string, cookieDomain?: string): void;
|
|
42
|
+
//# sourceMappingURL=createServerRequestContext.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createServerRequestContext.d.ts","sourceRoot":"","sources":["../../src/context/createServerRequestContext.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,QAAqB,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG,qBAAqB,CAkCtF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAShG"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
const require_createISRApp = require("./createISRApp-Nv9mwX8I.cjs");
|
|
2
|
+
/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
|
|
3
|
+
var HARD_LIMIT = 1e3;
|
|
4
|
+
/** L1 默认 limit */
|
|
5
|
+
var DEFAULT_LIMIT = 100;
|
|
6
|
+
/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */
|
|
7
|
+
var L2_HARD_LIMIT = 500;
|
|
8
|
+
/** L2 默认 limit */
|
|
9
|
+
var L2_DEFAULT_LIMIT = 200;
|
|
10
|
+
function parseStatusFilter(raw) {
|
|
11
|
+
if (raw === "fresh" || raw === "stale" || raw === "expired" || raw === "all") return raw;
|
|
12
|
+
return "all";
|
|
13
|
+
}
|
|
14
|
+
function parseLimit(raw) {
|
|
15
|
+
if (!raw) return DEFAULT_LIMIT;
|
|
16
|
+
const n = parseInt(raw, 10);
|
|
17
|
+
if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;
|
|
18
|
+
return Math.min(n, HARD_LIMIT);
|
|
19
|
+
}
|
|
20
|
+
function parseL2Limit(raw) {
|
|
21
|
+
if (!raw) return L2_DEFAULT_LIMIT;
|
|
22
|
+
const n = parseInt(raw, 10);
|
|
23
|
+
if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;
|
|
24
|
+
return Math.min(n, L2_HARD_LIMIT);
|
|
25
|
+
}
|
|
26
|
+
function parseBoolFlag(raw, defaultValue) {
|
|
27
|
+
if (raw === null) return defaultValue;
|
|
28
|
+
const v = raw.toLowerCase();
|
|
29
|
+
if (v === "true" || v === "1" || v === "yes") return true;
|
|
30
|
+
if (v === "false" || v === "0" || v === "no") return false;
|
|
31
|
+
return defaultValue;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* 创建 inventory 中间件。
|
|
35
|
+
*
|
|
36
|
+
* 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开
|
|
37
|
+
* cache handler 内部 metric 记录这次 admin 请求)。
|
|
38
|
+
*
|
|
39
|
+
* @param handler ISR cache handler,必须支持 getCacheInspection()
|
|
40
|
+
* @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效
|
|
41
|
+
*/
|
|
42
|
+
function createCacheInspectorMiddleware(handler, opsConfig) {
|
|
43
|
+
if (!opsConfig.inventory.enabled) return (_req, _res, next) => next();
|
|
44
|
+
const auth = require_createISRApp.createOpsAuthMiddleware("inventory", opsConfig);
|
|
45
|
+
return (req, res, next) => {
|
|
46
|
+
if (req.method !== "GET" && req.method !== "HEAD") {
|
|
47
|
+
next();
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
if ((req.url ?? "/").split("?")[0] !== "/__isr/cache/inventory") {
|
|
51
|
+
next();
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
auth(req, res, () => {
|
|
55
|
+
respond(req, res, handler);
|
|
56
|
+
});
|
|
57
|
+
};
|
|
58
|
+
async function respond(req, res, h) {
|
|
59
|
+
try {
|
|
60
|
+
const snapshot = h.getCacheInspection();
|
|
61
|
+
const params = new URLSearchParams((req.url ?? "").split("?")[1] ?? "");
|
|
62
|
+
const statusFilter = parseStatusFilter(params.get("status"));
|
|
63
|
+
const limit = parseLimit(params.get("limit"));
|
|
64
|
+
const includeL2 = parseBoolFlag(params.get("l2"), true);
|
|
65
|
+
const l2Limit = parseL2Limit(params.get("l2Limit"));
|
|
66
|
+
const filtered = statusFilter === "all" ? snapshot.entries : snapshot.entries.filter((e) => e.status === statusFilter);
|
|
67
|
+
const limited = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds).slice(0, limit);
|
|
68
|
+
const sortedInvalidations = [...snapshot.invalidations].sort((a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs);
|
|
69
|
+
const l2Items = includeL2 && snapshot.backend === "hybrid" ? await h.getL2Inspection(l2Limit) : [];
|
|
70
|
+
const body = JSON.stringify({
|
|
71
|
+
now: snapshot.now,
|
|
72
|
+
backend: snapshot.backend,
|
|
73
|
+
size: snapshot.size,
|
|
74
|
+
max: snapshot.max,
|
|
75
|
+
filter: {
|
|
76
|
+
status: statusFilter,
|
|
77
|
+
limit,
|
|
78
|
+
l2: includeL2,
|
|
79
|
+
l2Limit
|
|
80
|
+
},
|
|
81
|
+
filtered: filtered.length,
|
|
82
|
+
entries: limited,
|
|
83
|
+
invalidations: sortedInvalidations,
|
|
84
|
+
l2: {
|
|
85
|
+
scanned: l2Items.length,
|
|
86
|
+
items: l2Items
|
|
87
|
+
}
|
|
88
|
+
}, null, 2);
|
|
89
|
+
if (res.headersSent) return;
|
|
90
|
+
res.statusCode = 200;
|
|
91
|
+
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
92
|
+
res.setHeader("cache-control", "no-store");
|
|
93
|
+
res.end(body);
|
|
94
|
+
} catch (err) {
|
|
95
|
+
if (res.headersSent) return;
|
|
96
|
+
res.statusCode = 500;
|
|
97
|
+
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
98
|
+
res.end(JSON.stringify({ error: err.message }));
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
//#endregion
|
|
103
|
+
exports.createCacheInspectorMiddleware = createCacheInspectorMiddleware;
|
|
104
|
+
|
|
105
|
+
//# sourceMappingURL=createCacheInspectorMiddleware-DGSjHQJd.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createCacheInspectorMiddleware-DGSjHQJd.cjs","names":[],"sources":["../src/plugin/createCacheInspectorMiddleware.ts"],"sourcesContent":["/**\n * ISR cache inventory 端点 —— 暴露当前 L1 缓存条目元数据 + 最近 invalidate 时间。\n *\n * 用途:回答 “这一刻,哪些页面的缓存是 stale?某 path/tag 上次什么时候被 revalidate?”\n * 这类 *库存视角* 问题。流量视角(按路由 cache 状态分布)走 Prometheus\n * `isr_http_requests_total{cache=\"STALE\",route=...}`;本端点是补充而非替代。\n *\n * 边界(明确写在这里防止滑坡):\n * ✅ 只读 L1(in-process LRU),永不 SCAN Redis(SCAN 阻塞,量大不该走 engine)\n * ✅ 只返回元数据:key / 时间戳 / size / tags;body 一字节都不返回\n * ✅ 只给 JSON,不给 HTML 浏览器(漂亮 UI 走业务自建或单独包)\n * ✅ 鉴权复用 opsConfig.authToken,不引入 SSO/RBAC(那是业务网关的事)\n * ✅ 端点路径 /__isr/cache/inventory 已在 isrCacheMiddleware.isBypassPath 列表,\n * 自身永远不会被 ISR 缓存\n *\n * 查询参数:\n * ?status=fresh|stale|expired|all 过滤 L1 条目状态(默认 all)\n * ?limit=N L1 条目数上限(默认 100,硬上限 1000)\n * ?l2=true|false 是否包含 L2(Redis)SCAN 视图(默认 true,\n * hybrid 模式才有内容;memory 模式恒为 [] 不发请求)\n * ?l2Limit=N L2 SCAN 条目数上限(默认 200,硬上限 500,防 SCAN 流量过大)\n *\n * 响应示例(hybrid 模式):\n * {\n * \"now\": 1715760000000,\n * \"backend\": \"hybrid\",\n * \"size\": 234, // L1 条目数\n * \"max\": 1000, // L1 容量\n * \"filtered\": 12, // L1 过滤后条目数\n * \"entries\": [...], // L1 条目(含 fresh/stale/expired 状态)\n * \"invalidations\": [...], // 最近 invalidate 时间\n * \"l2\": {\n * \"scanned\": 234,\n * \"items\": [\n * { \"key\": \"GET:/books/1\", \"sizeBytes\": 12450, \"ttlSecondsRemaining\": 1800, \"onlyInL2\": false },\n * { \"key\": \"GET:/cold-page\", \"sizeBytes\": 800, \"ttlSecondsRemaining\": 7200, \"onlyInL2\": true }\n * ]\n * }\n * }\n */\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { Connect } from 'vite';\nimport type { IsrCacheHandler, IsrCacheInspectionEntry } from './isrCacheMiddleware';\nimport type { ResolvedOpsConfig } from '../server/opsConfig';\nimport { createOpsAuthMiddleware } from '../server/opsConfig';\n\n/** Inventory 端点路径常量 —— 与 isrCacheMiddleware.isBypassPath 中的 /__isr 前缀对齐 */\nexport const CACHE_INVENTORY_PATH = '/__isr/cache/inventory';\n\n/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */\nconst HARD_LIMIT = 1000;\n/** L1 默认 limit */\nconst DEFAULT_LIMIT = 100;\n/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */\nconst L2_HARD_LIMIT = 500;\n/** L2 默认 limit */\nconst L2_DEFAULT_LIMIT = 200;\n\ntype StatusFilter = 'fresh' | 'stale' | 'expired' | 'all';\n\nfunction parseStatusFilter(raw: string | null): StatusFilter {\n if (raw === 'fresh' || raw === 'stale' || raw === 'expired' || raw === 'all') return raw;\n return 'all';\n}\n\nfunction parseLimit(raw: string | null): number {\n if (!raw) return DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;\n return Math.min(n, HARD_LIMIT);\n}\n\nfunction parseL2Limit(raw: string | null): number {\n if (!raw) return L2_DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;\n return Math.min(n, L2_HARD_LIMIT);\n}\n\nfunction parseBoolFlag(raw: string | null, defaultValue: boolean): boolean {\n if (raw === null) return defaultValue;\n const v = raw.toLowerCase();\n if (v === 'true' || v === '1' || v === 'yes') return true;\n if (v === 'false' || v === '0' || v === 'no') return false;\n return defaultValue;\n}\n\n/**\n * 创建 inventory 中间件。\n *\n * 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开\n * cache handler 内部 metric 记录这次 admin 请求)。\n *\n * @param handler ISR cache handler,必须支持 getCacheInspection()\n * @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效\n */\nexport function createCacheInspectorMiddleware(\n handler: IsrCacheHandler,\n opsConfig: ResolvedOpsConfig\n): Connect.NextHandleFunction {\n // disabled 时直接返回 no-op,运行期不引入任何分支开销\n if (!opsConfig.inventory.enabled) {\n return (_req, _res, next) => next();\n }\n\n const auth = createOpsAuthMiddleware('inventory', opsConfig);\n\n return (req: IncomingMessage, res: ServerResponse, next: Connect.NextFunction) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') {\n next();\n return;\n }\n // 用 URL 解析路径(剥 query string)。req.url 一定有,但形态可能含 query。\n const url = req.url ?? '/';\n const pathOnly = url.split('?')[0];\n if (pathOnly !== CACHE_INVENTORY_PATH) {\n next();\n return;\n }\n\n // 鉴权 —— public=true 时 createOpsAuthMiddleware 返回 noop next()\n auth(req as never, res as never, () => {\n void respond(req, res, handler);\n });\n };\n\n async function respond(\n req: IncomingMessage,\n res: ServerResponse,\n h: IsrCacheHandler\n ): Promise<void> {\n try {\n const snapshot = h.getCacheInspection();\n const params = new URLSearchParams((req.url ?? '').split('?')[1] ?? '');\n const statusFilter = parseStatusFilter(params.get('status'));\n const limit = parseLimit(params.get('limit'));\n const includeL2 = parseBoolFlag(params.get('l2'), true);\n const l2Limit = parseL2Limit(params.get('l2Limit'));\n\n const filtered: IsrCacheInspectionEntry[] =\n statusFilter === 'all'\n ? snapshot.entries\n : snapshot.entries.filter(e => e.status === statusFilter);\n\n // 排序:fresh 先返回最新入缓存的;stale/expired 先返回最旧的(最该被关注)。\n // 对于 all:按 ageSeconds 降序(旧的优先),方便排错时一眼看到长期未刷新的条目。\n const sorted = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds);\n const limited = sorted.slice(0, limit);\n\n const sortedInvalidations = [...snapshot.invalidations].sort(\n (a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs\n );\n\n // L2 视图(仅 hybrid 模式有内容)—— 异步 SCAN 拉取\n const l2Items =\n includeL2 && snapshot.backend === 'hybrid' ? await h.getL2Inspection(l2Limit) : [];\n\n const body = JSON.stringify(\n {\n now: snapshot.now,\n backend: snapshot.backend,\n size: snapshot.size,\n max: snapshot.max,\n filter: { status: statusFilter, limit, l2: includeL2, l2Limit },\n filtered: filtered.length,\n entries: limited,\n invalidations: sortedInvalidations,\n l2: { scanned: l2Items.length, items: l2Items },\n },\n null,\n 2\n );\n\n if (res.headersSent) return;\n res.statusCode = 200;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.setHeader('cache-control', 'no-store');\n res.end(body);\n } catch (err) {\n if (res.headersSent) return;\n res.statusCode = 500;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.end(JSON.stringify({ error: (err as Error).message }));\n }\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { S as createOpsAuthMiddleware } from "./createISRApp-CDkyUuW3.js";
|
|
2
|
+
/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */
|
|
3
|
+
var HARD_LIMIT = 1e3;
|
|
4
|
+
/** L1 默认 limit */
|
|
5
|
+
var DEFAULT_LIMIT = 100;
|
|
6
|
+
/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */
|
|
7
|
+
var L2_HARD_LIMIT = 500;
|
|
8
|
+
/** L2 默认 limit */
|
|
9
|
+
var L2_DEFAULT_LIMIT = 200;
|
|
10
|
+
function parseStatusFilter(raw) {
|
|
11
|
+
if (raw === "fresh" || raw === "stale" || raw === "expired" || raw === "all") return raw;
|
|
12
|
+
return "all";
|
|
13
|
+
}
|
|
14
|
+
function parseLimit(raw) {
|
|
15
|
+
if (!raw) return DEFAULT_LIMIT;
|
|
16
|
+
const n = parseInt(raw, 10);
|
|
17
|
+
if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;
|
|
18
|
+
return Math.min(n, HARD_LIMIT);
|
|
19
|
+
}
|
|
20
|
+
function parseL2Limit(raw) {
|
|
21
|
+
if (!raw) return L2_DEFAULT_LIMIT;
|
|
22
|
+
const n = parseInt(raw, 10);
|
|
23
|
+
if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;
|
|
24
|
+
return Math.min(n, L2_HARD_LIMIT);
|
|
25
|
+
}
|
|
26
|
+
function parseBoolFlag(raw, defaultValue) {
|
|
27
|
+
if (raw === null) return defaultValue;
|
|
28
|
+
const v = raw.toLowerCase();
|
|
29
|
+
if (v === "true" || v === "1" || v === "yes") return true;
|
|
30
|
+
if (v === "false" || v === "0" || v === "no") return false;
|
|
31
|
+
return defaultValue;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* 创建 inventory 中间件。
|
|
35
|
+
*
|
|
36
|
+
* 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开
|
|
37
|
+
* cache handler 内部 metric 记录这次 admin 请求)。
|
|
38
|
+
*
|
|
39
|
+
* @param handler ISR cache handler,必须支持 getCacheInspection()
|
|
40
|
+
* @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效
|
|
41
|
+
*/
|
|
42
|
+
function createCacheInspectorMiddleware(handler, opsConfig) {
|
|
43
|
+
if (!opsConfig.inventory.enabled) return (_req, _res, next) => next();
|
|
44
|
+
const auth = createOpsAuthMiddleware("inventory", opsConfig);
|
|
45
|
+
return (req, res, next) => {
|
|
46
|
+
if (req.method !== "GET" && req.method !== "HEAD") {
|
|
47
|
+
next();
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
if ((req.url ?? "/").split("?")[0] !== "/__isr/cache/inventory") {
|
|
51
|
+
next();
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
auth(req, res, () => {
|
|
55
|
+
respond(req, res, handler);
|
|
56
|
+
});
|
|
57
|
+
};
|
|
58
|
+
async function respond(req, res, h) {
|
|
59
|
+
try {
|
|
60
|
+
const snapshot = h.getCacheInspection();
|
|
61
|
+
const params = new URLSearchParams((req.url ?? "").split("?")[1] ?? "");
|
|
62
|
+
const statusFilter = parseStatusFilter(params.get("status"));
|
|
63
|
+
const limit = parseLimit(params.get("limit"));
|
|
64
|
+
const includeL2 = parseBoolFlag(params.get("l2"), true);
|
|
65
|
+
const l2Limit = parseL2Limit(params.get("l2Limit"));
|
|
66
|
+
const filtered = statusFilter === "all" ? snapshot.entries : snapshot.entries.filter((e) => e.status === statusFilter);
|
|
67
|
+
const limited = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds).slice(0, limit);
|
|
68
|
+
const sortedInvalidations = [...snapshot.invalidations].sort((a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs);
|
|
69
|
+
const l2Items = includeL2 && snapshot.backend === "hybrid" ? await h.getL2Inspection(l2Limit) : [];
|
|
70
|
+
const body = JSON.stringify({
|
|
71
|
+
now: snapshot.now,
|
|
72
|
+
backend: snapshot.backend,
|
|
73
|
+
size: snapshot.size,
|
|
74
|
+
max: snapshot.max,
|
|
75
|
+
filter: {
|
|
76
|
+
status: statusFilter,
|
|
77
|
+
limit,
|
|
78
|
+
l2: includeL2,
|
|
79
|
+
l2Limit
|
|
80
|
+
},
|
|
81
|
+
filtered: filtered.length,
|
|
82
|
+
entries: limited,
|
|
83
|
+
invalidations: sortedInvalidations,
|
|
84
|
+
l2: {
|
|
85
|
+
scanned: l2Items.length,
|
|
86
|
+
items: l2Items
|
|
87
|
+
}
|
|
88
|
+
}, null, 2);
|
|
89
|
+
if (res.headersSent) return;
|
|
90
|
+
res.statusCode = 200;
|
|
91
|
+
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
92
|
+
res.setHeader("cache-control", "no-store");
|
|
93
|
+
res.end(body);
|
|
94
|
+
} catch (err) {
|
|
95
|
+
if (res.headersSent) return;
|
|
96
|
+
res.statusCode = 500;
|
|
97
|
+
res.setHeader("content-type", "application/json; charset=utf-8");
|
|
98
|
+
res.end(JSON.stringify({ error: err.message }));
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
//#endregion
|
|
103
|
+
export { createCacheInspectorMiddleware };
|
|
104
|
+
|
|
105
|
+
//# sourceMappingURL=createCacheInspectorMiddleware-Dmuobpcb.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"createCacheInspectorMiddleware-Dmuobpcb.js","names":[],"sources":["../src/plugin/createCacheInspectorMiddleware.ts"],"sourcesContent":["/**\n * ISR cache inventory 端点 —— 暴露当前 L1 缓存条目元数据 + 最近 invalidate 时间。\n *\n * 用途:回答 “这一刻,哪些页面的缓存是 stale?某 path/tag 上次什么时候被 revalidate?”\n * 这类 *库存视角* 问题。流量视角(按路由 cache 状态分布)走 Prometheus\n * `isr_http_requests_total{cache=\"STALE\",route=...}`;本端点是补充而非替代。\n *\n * 边界(明确写在这里防止滑坡):\n * ✅ 只读 L1(in-process LRU),永不 SCAN Redis(SCAN 阻塞,量大不该走 engine)\n * ✅ 只返回元数据:key / 时间戳 / size / tags;body 一字节都不返回\n * ✅ 只给 JSON,不给 HTML 浏览器(漂亮 UI 走业务自建或单独包)\n * ✅ 鉴权复用 opsConfig.authToken,不引入 SSO/RBAC(那是业务网关的事)\n * ✅ 端点路径 /__isr/cache/inventory 已在 isrCacheMiddleware.isBypassPath 列表,\n * 自身永远不会被 ISR 缓存\n *\n * 查询参数:\n * ?status=fresh|stale|expired|all 过滤 L1 条目状态(默认 all)\n * ?limit=N L1 条目数上限(默认 100,硬上限 1000)\n * ?l2=true|false 是否包含 L2(Redis)SCAN 视图(默认 true,\n * hybrid 模式才有内容;memory 模式恒为 [] 不发请求)\n * ?l2Limit=N L2 SCAN 条目数上限(默认 200,硬上限 500,防 SCAN 流量过大)\n *\n * 响应示例(hybrid 模式):\n * {\n * \"now\": 1715760000000,\n * \"backend\": \"hybrid\",\n * \"size\": 234, // L1 条目数\n * \"max\": 1000, // L1 容量\n * \"filtered\": 12, // L1 过滤后条目数\n * \"entries\": [...], // L1 条目(含 fresh/stale/expired 状态)\n * \"invalidations\": [...], // 最近 invalidate 时间\n * \"l2\": {\n * \"scanned\": 234,\n * \"items\": [\n * { \"key\": \"GET:/books/1\", \"sizeBytes\": 12450, \"ttlSecondsRemaining\": 1800, \"onlyInL2\": false },\n * { \"key\": \"GET:/cold-page\", \"sizeBytes\": 800, \"ttlSecondsRemaining\": 7200, \"onlyInL2\": true }\n * ]\n * }\n * }\n */\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { Connect } from 'vite';\nimport type { IsrCacheHandler, IsrCacheInspectionEntry } from './isrCacheMiddleware';\nimport type { ResolvedOpsConfig } from '../server/opsConfig';\nimport { createOpsAuthMiddleware } from '../server/opsConfig';\n\n/** Inventory 端点路径常量 —— 与 isrCacheMiddleware.isBypassPath 中的 /__isr 前缀对齐 */\nexport const CACHE_INVENTORY_PATH = '/__isr/cache/inventory';\n\n/** L1 单次响应最多条目数(硬上限),避免极端情况返回 5MB+ JSON */\nconst HARD_LIMIT = 1000;\n/** L1 默认 limit */\nconst DEFAULT_LIMIT = 100;\n/** L2 SCAN 单次返回硬上限 —— 比 L1 更严,因为每个 entry 一次 STRLEN+TTL 是 2 个 Redis 命令 */\nconst L2_HARD_LIMIT = 500;\n/** L2 默认 limit */\nconst L2_DEFAULT_LIMIT = 200;\n\ntype StatusFilter = 'fresh' | 'stale' | 'expired' | 'all';\n\nfunction parseStatusFilter(raw: string | null): StatusFilter {\n if (raw === 'fresh' || raw === 'stale' || raw === 'expired' || raw === 'all') return raw;\n return 'all';\n}\n\nfunction parseLimit(raw: string | null): number {\n if (!raw) return DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return DEFAULT_LIMIT;\n return Math.min(n, HARD_LIMIT);\n}\n\nfunction parseL2Limit(raw: string | null): number {\n if (!raw) return L2_DEFAULT_LIMIT;\n const n = parseInt(raw, 10);\n if (!Number.isFinite(n) || n <= 0) return L2_DEFAULT_LIMIT;\n return Math.min(n, L2_HARD_LIMIT);\n}\n\nfunction parseBoolFlag(raw: string | null, defaultValue: boolean): boolean {\n if (raw === null) return defaultValue;\n const v = raw.toLowerCase();\n if (v === 'true' || v === '1' || v === 'yes') return true;\n if (v === 'false' || v === '0' || v === 'no') return false;\n return defaultValue;\n}\n\n/**\n * 创建 inventory 中间件。\n *\n * 必须在 ISR cache middleware 之前挂(路径已在 isBypassPath 但提前挂可以避开\n * cache handler 内部 metric 记录这次 admin 请求)。\n *\n * @param handler ISR cache handler,必须支持 getCacheInspection()\n * @param opsConfig resolveOpsConfig 的输出 —— inventory.enabled 控制端点是否生效\n */\nexport function createCacheInspectorMiddleware(\n handler: IsrCacheHandler,\n opsConfig: ResolvedOpsConfig\n): Connect.NextHandleFunction {\n // disabled 时直接返回 no-op,运行期不引入任何分支开销\n if (!opsConfig.inventory.enabled) {\n return (_req, _res, next) => next();\n }\n\n const auth = createOpsAuthMiddleware('inventory', opsConfig);\n\n return (req: IncomingMessage, res: ServerResponse, next: Connect.NextFunction) => {\n if (req.method !== 'GET' && req.method !== 'HEAD') {\n next();\n return;\n }\n // 用 URL 解析路径(剥 query string)。req.url 一定有,但形态可能含 query。\n const url = req.url ?? '/';\n const pathOnly = url.split('?')[0];\n if (pathOnly !== CACHE_INVENTORY_PATH) {\n next();\n return;\n }\n\n // 鉴权 —— public=true 时 createOpsAuthMiddleware 返回 noop next()\n auth(req as never, res as never, () => {\n void respond(req, res, handler);\n });\n };\n\n async function respond(\n req: IncomingMessage,\n res: ServerResponse,\n h: IsrCacheHandler\n ): Promise<void> {\n try {\n const snapshot = h.getCacheInspection();\n const params = new URLSearchParams((req.url ?? '').split('?')[1] ?? '');\n const statusFilter = parseStatusFilter(params.get('status'));\n const limit = parseLimit(params.get('limit'));\n const includeL2 = parseBoolFlag(params.get('l2'), true);\n const l2Limit = parseL2Limit(params.get('l2Limit'));\n\n const filtered: IsrCacheInspectionEntry[] =\n statusFilter === 'all'\n ? snapshot.entries\n : snapshot.entries.filter(e => e.status === statusFilter);\n\n // 排序:fresh 先返回最新入缓存的;stale/expired 先返回最旧的(最该被关注)。\n // 对于 all:按 ageSeconds 降序(旧的优先),方便排错时一眼看到长期未刷新的条目。\n const sorted = [...filtered].sort((a, b) => b.ageSeconds - a.ageSeconds);\n const limited = sorted.slice(0, limit);\n\n const sortedInvalidations = [...snapshot.invalidations].sort(\n (a, b) => b.lastInvalidatedMs - a.lastInvalidatedMs\n );\n\n // L2 视图(仅 hybrid 模式有内容)—— 异步 SCAN 拉取\n const l2Items =\n includeL2 && snapshot.backend === 'hybrid' ? await h.getL2Inspection(l2Limit) : [];\n\n const body = JSON.stringify(\n {\n now: snapshot.now,\n backend: snapshot.backend,\n size: snapshot.size,\n max: snapshot.max,\n filter: { status: statusFilter, limit, l2: includeL2, l2Limit },\n filtered: filtered.length,\n entries: limited,\n invalidations: sortedInvalidations,\n l2: { scanned: l2Items.length, items: l2Items },\n },\n null,\n 2\n );\n\n if (res.headersSent) return;\n res.statusCode = 200;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.setHeader('cache-control', 'no-store');\n res.end(body);\n } catch (err) {\n if (res.headersSent) return;\n res.statusCode = 500;\n res.setHeader('content-type', 'application/json; charset=utf-8');\n res.end(JSON.stringify({ error: (err as Error).message }));\n }\n }\n}\n"],"mappings":"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"}
|