isr-engine 0.0.0-stage → 2.6.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (452) hide show
  1. package/CHANGELOG.md +755 -0
  2. package/README.md +694 -2
  3. package/dist/RequestContext-BVQ-rOmV.js +58 -0
  4. package/dist/RequestContext-BVQ-rOmV.js.map +1 -0
  5. package/dist/RequestContext-DgGEAxcW.cjs +105 -0
  6. package/dist/RequestContext-DgGEAxcW.cjs.map +1 -0
  7. package/dist/abVariantContext-CWCdRSdG.js +549 -0
  8. package/dist/abVariantContext-CWCdRSdG.js.map +1 -0
  9. package/dist/abVariantContext-Cqp-uxtd.cjs +678 -0
  10. package/dist/abVariantContext-Cqp-uxtd.cjs.map +1 -0
  11. package/dist/adapters/observability/client/sentry.d.ts +42 -0
  12. package/dist/adapters/observability/client/sentry.d.ts.map +1 -0
  13. package/dist/adapters/observability/index.cjs +152 -0
  14. package/dist/adapters/observability/index.cjs.map +1 -0
  15. package/dist/adapters/observability/index.d.ts +17 -0
  16. package/dist/adapters/observability/index.d.ts.map +1 -0
  17. package/dist/adapters/observability/index.js +148 -0
  18. package/dist/adapters/observability/index.js.map +1 -0
  19. package/dist/adapters/observability/server/datadog.d.ts +45 -0
  20. package/dist/adapters/observability/server/datadog.d.ts.map +1 -0
  21. package/dist/adapters/observability/server/otel.d.ts +51 -0
  22. package/dist/adapters/observability/server/otel.d.ts.map +1 -0
  23. package/dist/adapters/observability/server/sentry.d.ts +67 -0
  24. package/dist/adapters/observability/server/sentry.d.ts.map +1 -0
  25. package/dist/adapters/observability/types.d.ts +39 -0
  26. package/dist/adapters/observability/types.d.ts.map +1 -0
  27. package/dist/adapters/runtime/cloudflare.d.ts +33 -0
  28. package/dist/adapters/runtime/cloudflare.d.ts.map +1 -0
  29. package/dist/adapters/runtime/errorResponse.d.ts +3 -0
  30. package/dist/adapters/runtime/errorResponse.d.ts.map +1 -0
  31. package/dist/adapters/runtime/index.cjs +100 -0
  32. package/dist/adapters/runtime/index.cjs.map +1 -0
  33. package/dist/adapters/runtime/index.d.ts +10 -0
  34. package/dist/adapters/runtime/index.d.ts.map +1 -0
  35. package/dist/adapters/runtime/index.js +97 -0
  36. package/dist/adapters/runtime/index.js.map +1 -0
  37. package/dist/adapters/runtime/types.d.ts +24 -0
  38. package/dist/adapters/runtime/types.d.ts.map +1 -0
  39. package/dist/adapters/runtime/vercel-edge.d.ts +59 -0
  40. package/dist/adapters/runtime/vercel-edge.d.ts.map +1 -0
  41. package/dist/app/createISRApp.d.ts +19 -0
  42. package/dist/app/createISRApp.d.ts.map +1 -0
  43. package/dist/cache/CacheManager.d.ts +81 -0
  44. package/dist/cache/CacheManager.d.ts.map +1 -0
  45. package/dist/cache/ICacheAdapter.d.ts +84 -0
  46. package/dist/cache/ICacheAdapter.d.ts.map +1 -0
  47. package/dist/cache/MemoryCacheAdapter.d.ts +50 -0
  48. package/dist/cache/MemoryCacheAdapter.d.ts.map +1 -0
  49. package/dist/cache/RedisCacheAdapter.d.ts +111 -0
  50. package/dist/cache/RedisCacheAdapter.d.ts.map +1 -0
  51. package/dist/cache/RedisInvalidationBus.d.ts +59 -0
  52. package/dist/cache/RedisInvalidationBus.d.ts.map +1 -0
  53. package/dist/cache/RedisResponseCacheBackend.d.ts +30 -0
  54. package/dist/cache/RedisResponseCacheBackend.d.ts.map +1 -0
  55. package/dist/cache/ResponseCacheBackend.d.ts +28 -0
  56. package/dist/cache/ResponseCacheBackend.d.ts.map +1 -0
  57. package/dist/cache/createAutoCacheStore.d.ts +26 -0
  58. package/dist/cache/createAutoCacheStore.d.ts.map +1 -0
  59. package/dist/cache/index.d.ts +18 -0
  60. package/dist/cache/index.d.ts.map +1 -0
  61. package/dist/cli/cli.cjs +372 -0
  62. package/dist/cli/cli.cjs.map +1 -0
  63. package/dist/cli/cli.d.ts +8 -0
  64. package/dist/cli/cli.d.ts.map +1 -0
  65. package/dist/cli/cli.js +370 -0
  66. package/dist/cli/cli.js.map +1 -0
  67. package/dist/cli/dev.d.ts +11 -0
  68. package/dist/cli/dev.d.ts.map +1 -0
  69. package/dist/cli/fallback.d.ts +42 -0
  70. package/dist/cli/fallback.d.ts.map +1 -0
  71. package/dist/cli/serverOptions.d.ts +7 -0
  72. package/dist/cli/serverOptions.d.ts.map +1 -0
  73. package/dist/cli/start.d.ts +7 -0
  74. package/dist/cli/start.d.ts.map +1 -0
  75. package/dist/config/defaults.d.ts +11 -0
  76. package/dist/config/defaults.d.ts.map +1 -0
  77. package/dist/config/defineConfig.cjs +26 -0
  78. package/dist/config/defineConfig.cjs.map +1 -0
  79. package/dist/config/defineConfig.d.ts +44 -0
  80. package/dist/config/defineConfig.d.ts.map +1 -0
  81. package/dist/config/defineConfig.js +24 -0
  82. package/dist/config/defineConfig.js.map +1 -0
  83. package/dist/config/getEnv.d.ts +9 -0
  84. package/dist/config/getEnv.d.ts.map +1 -0
  85. package/dist/config/getStatus.d.ts +3 -0
  86. package/dist/config/getStatus.d.ts.map +1 -0
  87. package/dist/config/loadConfig.d.ts +18 -0
  88. package/dist/config/loadConfig.d.ts.map +1 -0
  89. package/dist/config/normalizeEngineConfig.d.ts +10 -0
  90. package/dist/config/normalizeEngineConfig.d.ts.map +1 -0
  91. package/dist/config/resolveImageOptions.d.ts +5 -0
  92. package/dist/config/resolveImageOptions.d.ts.map +1 -0
  93. package/dist/config/resolveRuntimeRedis.d.ts +11 -0
  94. package/dist/config/resolveRuntimeRedis.d.ts.map +1 -0
  95. package/dist/context/RequestContext.d.ts +28 -0
  96. package/dist/context/RequestContext.d.ts.map +1 -0
  97. package/dist/context/createServerRequestContext.d.ts +42 -0
  98. package/dist/context/createServerRequestContext.d.ts.map +1 -0
  99. package/dist/createCacheInspectorMiddleware-Byzz8ZlU.cjs +105 -0
  100. package/dist/createCacheInspectorMiddleware-Byzz8ZlU.cjs.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js +105 -0
  102. package/dist/createCacheInspectorMiddleware-DYJ2WGYu.js.map +1 -0
  103. package/dist/createISRApp-C9Bezuit.cjs +7663 -0
  104. package/dist/createISRApp-C9Bezuit.cjs.map +1 -0
  105. package/dist/createISRApp-CylUYiIU.js +7322 -0
  106. package/dist/createISRApp-CylUYiIU.js.map +1 -0
  107. package/dist/createImagePlugin-_ntL0DcT.js +416 -0
  108. package/dist/createImagePlugin-_ntL0DcT.js.map +1 -0
  109. package/dist/createImagePlugin-birVNynL.cjs +435 -0
  110. package/dist/createImagePlugin-birVNynL.cjs.map +1 -0
  111. package/dist/defaults/auto-observability.cjs +147 -0
  112. package/dist/defaults/auto-observability.cjs.map +1 -0
  113. package/dist/defaults/auto-observability.d.ts +21 -0
  114. package/dist/defaults/auto-observability.d.ts.map +1 -0
  115. package/dist/defaults/auto-observability.js +144 -0
  116. package/dist/defaults/auto-observability.js.map +1 -0
  117. package/dist/defaults/runtime/browserObservability.d.ts +73 -0
  118. package/dist/defaults/runtime/browserObservability.d.ts.map +1 -0
  119. package/dist/defaults/runtime/client-navigation-policy.d.ts +10 -0
  120. package/dist/defaults/runtime/client-navigation-policy.d.ts.map +1 -0
  121. package/dist/defaults/runtime/createCachedFetcher.d.ts +17 -0
  122. package/dist/defaults/runtime/createCachedFetcher.d.ts.map +1 -0
  123. package/dist/defaults/runtime/defineSiteHooks.cjs +11 -0
  124. package/dist/defaults/runtime/defineSiteHooks.d.ts +197 -0
  125. package/dist/defaults/runtime/defineSiteHooks.d.ts.map +1 -0
  126. package/dist/defaults/runtime/defineSiteHooks.js +3 -0
  127. package/dist/defaults/runtime/dev-css-handoff.client.d.ts +2 -0
  128. package/dist/defaults/runtime/dev-css-handoff.client.d.ts.map +1 -0
  129. package/dist/defaults/runtime/dev-render-inspector.d.ts +57 -0
  130. package/dist/defaults/runtime/dev-render-inspector.d.ts.map +1 -0
  131. package/dist/defaults/runtime/dev-rsc-response.client.d.ts +7 -0
  132. package/dist/defaults/runtime/dev-rsc-response.client.d.ts.map +1 -0
  133. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts +9 -0
  134. package/dist/defaults/runtime/dev-style-commit-boundary.client.d.ts.map +1 -0
  135. package/dist/defaults/runtime/dev-style-declarations.server.d.ts +15 -0
  136. package/dist/defaults/runtime/dev-style-declarations.server.d.ts.map +1 -0
  137. package/dist/defaults/runtime/dev-style-id.d.ts +9 -0
  138. package/dist/defaults/runtime/dev-style-id.d.ts.map +1 -0
  139. package/dist/defaults/runtime/dev-style-navigation.client.d.ts +26 -0
  140. package/dist/defaults/runtime/dev-style-navigation.client.d.ts.map +1 -0
  141. package/dist/defaults/runtime/dev-style-registry.client.d.ts +19 -0
  142. package/dist/defaults/runtime/dev-style-registry.client.d.ts.map +1 -0
  143. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts +4 -0
  144. package/dist/defaults/runtime/dev-style-resource-dispatcher.server.d.ts.map +1 -0
  145. package/dist/defaults/runtime/empty-routes.d.ts +3 -0
  146. package/dist/defaults/runtime/empty-routes.d.ts.map +1 -0
  147. package/dist/defaults/runtime/error-boundary.d.ts +9 -0
  148. package/dist/defaults/runtime/error-boundary.d.ts.map +1 -0
  149. package/dist/defaults/runtime/error500-template.d.ts +21 -0
  150. package/dist/defaults/runtime/error500-template.d.ts.map +1 -0
  151. package/dist/defaults/runtime/head-extras-runtime.d.ts +17 -0
  152. package/dist/defaults/runtime/head-extras-runtime.d.ts.map +1 -0
  153. package/dist/defaults/runtime/hydration-shell.d.ts +12 -0
  154. package/dist/defaults/runtime/hydration-shell.d.ts.map +1 -0
  155. package/dist/defaults/runtime/i18n-server.d.ts +7 -0
  156. package/dist/defaults/runtime/i18n-server.d.ts.map +1 -0
  157. package/dist/defaults/runtime/navigation-history.client.d.ts +16 -0
  158. package/dist/defaults/runtime/navigation-history.client.d.ts.map +1 -0
  159. package/dist/defaults/runtime/navigation-request.client.d.ts +5 -0
  160. package/dist/defaults/runtime/navigation-request.client.d.ts.map +1 -0
  161. package/dist/defaults/runtime/seo-runtime.d.ts +41 -0
  162. package/dist/defaults/runtime/seo-runtime.d.ts.map +1 -0
  163. package/dist/defineSiteHooks-BeVy-qPH.js +720 -0
  164. package/dist/defineSiteHooks-BeVy-qPH.js.map +1 -0
  165. package/dist/defineSiteHooks-C3v3WLS8.cjs +755 -0
  166. package/dist/defineSiteHooks-C3v3WLS8.cjs.map +1 -0
  167. package/dist/discovery/componentDiscovery.d.ts +71 -0
  168. package/dist/discovery/componentDiscovery.d.ts.map +1 -0
  169. package/dist/discovery/directiveParser.d.ts +197 -0
  170. package/dist/discovery/directiveParser.d.ts.map +1 -0
  171. package/dist/discovery/exportParser.d.ts +45 -0
  172. package/dist/discovery/exportParser.d.ts.map +1 -0
  173. package/dist/discovery/fileSystem.d.ts +33 -0
  174. package/dist/discovery/fileSystem.d.ts.map +1 -0
  175. package/dist/discovery/index.d.ts +18 -0
  176. package/dist/discovery/index.d.ts.map +1 -0
  177. package/dist/discovery/routeDiscovery.d.ts +121 -0
  178. package/dist/discovery/routeDiscovery.d.ts.map +1 -0
  179. package/dist/discovery/scan.d.ts +54 -0
  180. package/dist/discovery/scan.d.ts.map +1 -0
  181. package/dist/discovery/types.d.ts +61 -0
  182. package/dist/discovery/types.d.ts.map +1 -0
  183. package/dist/engine/ISREngine.d.ts +54 -0
  184. package/dist/engine/ISREngine.d.ts.map +1 -0
  185. package/dist/engine/RenderMode.d.ts +23 -0
  186. package/dist/engine/RenderMode.d.ts.map +1 -0
  187. package/dist/engine/i18n/types.d.ts +6 -0
  188. package/dist/engine/i18n/types.d.ts.map +1 -0
  189. package/dist/engine/seo/PageSeoMeta.d.ts +9 -0
  190. package/dist/engine/seo/PageSeoMeta.d.ts.map +1 -0
  191. package/dist/engine/seo/SEOEngine.d.ts +61 -0
  192. package/dist/engine/seo/SEOEngine.d.ts.map +1 -0
  193. package/dist/engine/seo/config.d.ts +9 -0
  194. package/dist/engine/seo/config.d.ts.map +1 -0
  195. package/dist/engine/seo/index.d.ts +10 -0
  196. package/dist/engine/seo/index.d.ts.map +1 -0
  197. package/dist/engine/seo/injectSeoMeta.d.ts +5 -0
  198. package/dist/engine/seo/injectSeoMeta.d.ts.map +1 -0
  199. package/dist/engine/seo/resolveSeoConfig.d.ts +15 -0
  200. package/dist/engine/seo/resolveSeoConfig.d.ts.map +1 -0
  201. package/dist/engine/seo/types.d.ts +75 -0
  202. package/dist/engine/seo/types.d.ts.map +1 -0
  203. package/dist/error500-template-BvZmvKoa.cjs +63 -0
  204. package/dist/error500-template-BvZmvKoa.cjs.map +1 -0
  205. package/dist/error500-template-DhaZzLOB.js +63 -0
  206. package/dist/error500-template-DhaZzLOB.js.map +1 -0
  207. package/dist/experiments/ExposureQueue.d.ts +54 -0
  208. package/dist/experiments/ExposureQueue.d.ts.map +1 -0
  209. package/dist/experiments/ManifestLoader.d.ts +57 -0
  210. package/dist/experiments/ManifestLoader.d.ts.map +1 -0
  211. package/dist/i18n-CyJIoYJT.cjs +244 -0
  212. package/dist/i18n-CyJIoYJT.cjs.map +1 -0
  213. package/dist/i18n-Dobe0Wxn.js +191 -0
  214. package/dist/i18n-Dobe0Wxn.js.map +1 -0
  215. package/dist/image/index.cjs +93 -0
  216. package/dist/image/index.cjs.map +1 -0
  217. package/dist/image/index.js +67 -0
  218. package/dist/image/index.js.map +1 -0
  219. package/dist/index.d.ts +59 -0
  220. package/dist/index.d.ts.map +1 -0
  221. package/dist/isr/ISRRoutes.d.ts +25 -0
  222. package/dist/isr/ISRRoutes.d.ts.map +1 -0
  223. package/dist/isr-engine.cjs +2830 -0
  224. package/dist/isr-engine.cjs.map +1 -0
  225. package/dist/isr-engine.js +2740 -0
  226. package/dist/isr-engine.js.map +1 -0
  227. package/dist/logger/Logger.d.ts +33 -0
  228. package/dist/logger/Logger.d.ts.map +1 -0
  229. package/dist/logger/index.d.ts +3 -0
  230. package/dist/logger/index.d.ts.map +1 -0
  231. package/dist/manifest/ManifestLoader.d.ts +98 -0
  232. package/dist/manifest/ManifestLoader.d.ts.map +1 -0
  233. package/dist/manifest/index.d.ts +8 -0
  234. package/dist/manifest/index.d.ts.map +1 -0
  235. package/dist/manifest/types.d.ts +76 -0
  236. package/dist/manifest/types.d.ts.map +1 -0
  237. package/dist/metrics/MetricsCollector.d.ts +90 -0
  238. package/dist/metrics/MetricsCollector.d.ts.map +1 -0
  239. package/dist/metrics/PromMetrics.d.ts +59 -0
  240. package/dist/metrics/PromMetrics.d.ts.map +1 -0
  241. package/dist/metrics/index.d.ts +7 -0
  242. package/dist/metrics/index.d.ts.map +1 -0
  243. package/dist/middlewares/ABVariantMiddleware.d.ts +74 -0
  244. package/dist/middlewares/ABVariantMiddleware.d.ts.map +1 -0
  245. package/dist/middlewares/LocaleRedirect.d.ts +27 -0
  246. package/dist/middlewares/LocaleRedirect.d.ts.map +1 -0
  247. package/dist/middlewares/MiddlewareComposer.d.ts +20 -0
  248. package/dist/middlewares/MiddlewareComposer.d.ts.map +1 -0
  249. package/dist/middlewares/PerformanceMiddleware.d.ts +14 -0
  250. package/dist/middlewares/PerformanceMiddleware.d.ts.map +1 -0
  251. package/dist/middlewares/TraceMiddleware.d.ts +24 -0
  252. package/dist/middlewares/TraceMiddleware.d.ts.map +1 -0
  253. package/dist/middlewares/abVariantContext.d.ts +7 -0
  254. package/dist/middlewares/abVariantContext.d.ts.map +1 -0
  255. package/dist/middlewares/index.d.ts +5 -0
  256. package/dist/middlewares/index.d.ts.map +1 -0
  257. package/dist/middlewares/types.d.ts +4 -0
  258. package/dist/middlewares/types.d.ts.map +1 -0
  259. package/dist/plugin/clientObservabilityConfig.d.ts +16 -0
  260. package/dist/plugin/clientObservabilityConfig.d.ts.map +1 -0
  261. package/dist/plugin/coherentCacheStore.d.ts +11 -0
  262. package/dist/plugin/coherentCacheStore.d.ts.map +1 -0
  263. package/dist/plugin/createAutomaticImagePlugin.d.ts +4 -0
  264. package/dist/plugin/createAutomaticImagePlugin.d.ts.map +1 -0
  265. package/dist/plugin/createCacheInspectorMiddleware.d.ts +16 -0
  266. package/dist/plugin/createCacheInspectorMiddleware.d.ts.map +1 -0
  267. package/dist/plugin/createDevCssHandoffPlugin.d.ts +25 -0
  268. package/dist/plugin/createDevCssHandoffPlugin.d.ts.map +1 -0
  269. package/dist/plugin/createFontPlugin.d.ts +15 -0
  270. package/dist/plugin/createFontPlugin.d.ts.map +1 -0
  271. package/dist/plugin/createImagePlugin.d.ts +46 -0
  272. package/dist/plugin/createImagePlugin.d.ts.map +1 -0
  273. package/dist/plugin/createIsrPlugin.d.ts +43 -0
  274. package/dist/plugin/createIsrPlugin.d.ts.map +1 -0
  275. package/dist/plugin/createSsgPostBuildPlugin.d.ts +4 -0
  276. package/dist/plugin/createSsgPostBuildPlugin.d.ts.map +1 -0
  277. package/dist/plugin/devAssetRequestMiddleware.d.ts +10 -0
  278. package/dist/plugin/devAssetRequestMiddleware.d.ts.map +1 -0
  279. package/dist/plugin/index.d.ts +11 -0
  280. package/dist/plugin/index.d.ts.map +1 -0
  281. package/dist/plugin/isrCacheMiddleware.d.ts +223 -0
  282. package/dist/plugin/isrCacheMiddleware.d.ts.map +1 -0
  283. package/dist/plugin/isrCacheStore.d.ts +88 -0
  284. package/dist/plugin/isrCacheStore.d.ts.map +1 -0
  285. package/dist/plugin/remoteImageSource.d.ts +19 -0
  286. package/dist/plugin/remoteImageSource.d.ts.map +1 -0
  287. package/dist/plugin/transformDevCssModule.d.ts +3 -0
  288. package/dist/plugin/transformDevCssModule.d.ts.map +1 -0
  289. package/dist/renderer/RenderHeaders.d.ts +28 -0
  290. package/dist/renderer/RenderHeaders.d.ts.map +1 -0
  291. package/dist/rolldown-runtime-D7D4PA-g.js +13 -0
  292. package/dist/rolldown-runtime-DakpK96I.cjs +43 -0
  293. package/dist/route/RouteManager.d.ts +22 -0
  294. package/dist/route/RouteManager.d.ts.map +1 -0
  295. package/dist/route/index.d.ts +2 -0
  296. package/dist/route/index.d.ts.map +1 -0
  297. package/dist/rsc/ServerActions.d.ts +65 -0
  298. package/dist/rsc/ServerActions.d.ts.map +1 -0
  299. package/dist/rsc/browser.cjs +109 -0
  300. package/dist/rsc/browser.cjs.map +1 -0
  301. package/dist/rsc/browser.d.ts +59 -0
  302. package/dist/rsc/browser.d.ts.map +1 -0
  303. package/dist/rsc/browser.js +85 -0
  304. package/dist/rsc/browser.js.map +1 -0
  305. package/dist/rsc/cacheTag.d.ts +52 -0
  306. package/dist/rsc/cacheTag.d.ts.map +1 -0
  307. package/dist/rsc/constants.d.ts +10 -0
  308. package/dist/rsc/constants.d.ts.map +1 -0
  309. package/dist/rsc/i18n.d.ts +3 -0
  310. package/dist/rsc/i18n.d.ts.map +1 -0
  311. package/dist/rsc/index.cjs +33 -0
  312. package/dist/rsc/index.d.ts +20 -0
  313. package/dist/rsc/index.d.ts.map +1 -0
  314. package/dist/rsc/index.js +4 -0
  315. package/dist/rsc/revalidate.d.ts +77 -0
  316. package/dist/rsc/revalidate.d.ts.map +1 -0
  317. package/dist/rsc-H7D_meHu.cjs +239 -0
  318. package/dist/rsc-H7D_meHu.cjs.map +1 -0
  319. package/dist/rsc-lvWPTuVD.js +168 -0
  320. package/dist/rsc-lvWPTuVD.js.map +1 -0
  321. package/dist/runtime/Image.d.ts +48 -0
  322. package/dist/runtime/Image.d.ts.map +1 -0
  323. package/dist/runtime/LocaleContext.d.ts +14 -0
  324. package/dist/runtime/LocaleContext.d.ts.map +1 -0
  325. package/dist/runtime/boundary.d.ts +27 -0
  326. package/dist/runtime/boundary.d.ts.map +1 -0
  327. package/dist/runtime/edge-context.d.ts +17 -0
  328. package/dist/runtime/edge-context.d.ts.map +1 -0
  329. package/dist/runtime/i18n-store.d.ts +11 -0
  330. package/dist/runtime/i18n-store.d.ts.map +1 -0
  331. package/dist/runtime/i18n.d.ts +115 -0
  332. package/dist/runtime/i18n.d.ts.map +1 -0
  333. package/dist/runtime/index.d.ts +16 -0
  334. package/dist/runtime/index.d.ts.map +1 -0
  335. package/dist/runtime/routes.d.ts +88 -0
  336. package/dist/runtime/routes.d.ts.map +1 -0
  337. package/dist/runtime/telemetry.d.ts +48 -0
  338. package/dist/runtime/telemetry.d.ts.map +1 -0
  339. package/dist/security/cspNonceTemplate.d.ts +10 -0
  340. package/dist/security/cspNonceTemplate.d.ts.map +1 -0
  341. package/dist/security/staticCspManifest.d.ts +37 -0
  342. package/dist/security/staticCspManifest.d.ts.map +1 -0
  343. package/dist/server/httpServer.d.ts +17 -0
  344. package/dist/server/httpServer.d.ts.map +1 -0
  345. package/dist/server/index.d.ts +3 -0
  346. package/dist/server/index.d.ts.map +1 -0
  347. package/dist/server/manager.d.ts +17 -0
  348. package/dist/server/manager.d.ts.map +1 -0
  349. package/dist/server/middleware.d.ts +87 -0
  350. package/dist/server/middleware.d.ts.map +1 -0
  351. package/dist/server/opsConfig.d.ts +17 -0
  352. package/dist/server/opsConfig.d.ts.map +1 -0
  353. package/dist/server/productionRuntime.d.ts +41 -0
  354. package/dist/server/productionRuntime.d.ts.map +1 -0
  355. package/dist/server/types.d.ts +41 -0
  356. package/dist/server/types.d.ts.map +1 -0
  357. package/dist/server/viteDevServer.d.ts +21 -0
  358. package/dist/server/viteDevServer.d.ts.map +1 -0
  359. package/dist/ssg/spider.d.ts +142 -0
  360. package/dist/ssg/spider.d.ts.map +1 -0
  361. package/dist/types/IFlightData.d.ts +23 -0
  362. package/dist/types/IFlightData.d.ts.map +1 -0
  363. package/dist/types/IHelmetData.d.ts +24 -0
  364. package/dist/types/IHelmetData.d.ts.map +1 -0
  365. package/dist/types/IRenderMetadata.d.ts +46 -0
  366. package/dist/types/IRenderMetadata.d.ts.map +1 -0
  367. package/dist/types/IRenderResult.d.ts +16 -0
  368. package/dist/types/IRenderResult.d.ts.map +1 -0
  369. package/dist/types/ISRConfig.d.ts +463 -0
  370. package/dist/types/ISRConfig.d.ts.map +1 -0
  371. package/dist/types/ISRContext.d.ts +104 -0
  372. package/dist/types/ISRContext.d.ts.map +1 -0
  373. package/dist/types/index.d.ts +7 -0
  374. package/dist/types/index.d.ts.map +1 -0
  375. package/dist/utils/CacheCleanup.d.ts +32 -0
  376. package/dist/utils/CacheCleanup.d.ts.map +1 -0
  377. package/dist/utils/cacheDuration.d.ts +12 -0
  378. package/dist/utils/cacheDuration.d.ts.map +1 -0
  379. package/dist/utils/cookie.d.ts +7 -0
  380. package/dist/utils/cookie.d.ts.map +1 -0
  381. package/dist/utils/hash.d.ts +22 -0
  382. package/dist/utils/hash.d.ts.map +1 -0
  383. package/dist/utils/htmlPathname.d.ts +12 -0
  384. package/dist/utils/htmlPathname.d.ts.map +1 -0
  385. package/dist/utils/index.d.ts +9 -0
  386. package/dist/utils/index.d.ts.map +1 -0
  387. package/dist/utils/resolveFetchHandler.d.ts +4 -0
  388. package/dist/utils/resolveFetchHandler.d.ts.map +1 -0
  389. package/dist/utils/trimTrailingSlashes.d.ts +3 -0
  390. package/dist/utils/trimTrailingSlashes.d.ts.map +1 -0
  391. package/package.json +200 -4
  392. package/src/context/RequestContext.ts +68 -0
  393. package/src/context/createServerRequestContext.ts +104 -0
  394. package/src/defaults/auto-observability.ts +195 -0
  395. package/src/defaults/entry.server.ssr.tsx +257 -0
  396. package/src/defaults/entry.server.tsx +117 -0
  397. package/src/defaults/entry.tsx +23 -0
  398. package/src/defaults/runtime/browserObservability.ts +839 -0
  399. package/src/defaults/runtime/client-navigation-policy.ts +67 -0
  400. package/src/defaults/runtime/createCachedFetcher.ts +121 -0
  401. package/src/defaults/runtime/defineClientEntry.tsx +773 -0
  402. package/src/defaults/runtime/defineServerEntry.tsx +421 -0
  403. package/src/defaults/runtime/defineSiteHooks.ts +1073 -0
  404. package/src/defaults/runtime/dev-css-handoff.client.ts +5 -0
  405. package/src/defaults/runtime/dev-render-inspector.ts +597 -0
  406. package/src/defaults/runtime/dev-rsc-response.client.ts +48 -0
  407. package/src/defaults/runtime/dev-style-commit-boundary.client.tsx +20 -0
  408. package/src/defaults/runtime/dev-style-declarations.server.ts +158 -0
  409. package/src/defaults/runtime/dev-style-id.ts +91 -0
  410. package/src/defaults/runtime/dev-style-navigation.client.ts +152 -0
  411. package/src/defaults/runtime/dev-style-registry.client.ts +744 -0
  412. package/src/defaults/runtime/dev-style-resource-dispatcher.server.ts +42 -0
  413. package/src/defaults/runtime/empty-config.ts +5 -0
  414. package/src/defaults/runtime/empty-routes.ts +2 -0
  415. package/src/defaults/runtime/error-boundary.style.css +35 -0
  416. package/src/defaults/runtime/error-boundary.tsx +65 -0
  417. package/src/defaults/runtime/error500-template.ts +66 -0
  418. package/src/defaults/runtime/head-extras-runtime.ts +64 -0
  419. package/src/defaults/runtime/hydration-shell.tsx +20 -0
  420. package/src/defaults/runtime/i18n-server.ts +27 -0
  421. package/src/defaults/runtime/navigation-history.client.ts +80 -0
  422. package/src/defaults/runtime/navigation-request.client.ts +21 -0
  423. package/src/defaults/runtime/request.tsx +100 -0
  424. package/src/defaults/runtime/seo-runtime.ts +257 -0
  425. package/src/defaults/tsconfig.json +10 -0
  426. package/src/defaults/types.d.ts +23 -0
  427. package/src/runtime/Image.tsx +124 -0
  428. package/src/runtime/LocaleContext.tsx +38 -0
  429. package/src/runtime/boundary.module.css +46 -0
  430. package/src/runtime/boundary.tsx +136 -0
  431. package/src/runtime/edge-context.ts +32 -0
  432. package/src/runtime/i18n-store.ts +76 -0
  433. package/src/runtime/i18n.ts +189 -0
  434. package/src/runtime/index.ts +61 -0
  435. package/src/runtime/routes.tsx +247 -0
  436. package/src/runtime/scss.d.ts +13 -0
  437. package/src/runtime/telemetry.ts +116 -0
  438. package/src/types/IFlightData.ts +27 -0
  439. package/src/types/IHelmetData.ts +9 -0
  440. package/src/types/IRenderMetadata.ts +52 -0
  441. package/src/types/IRenderResult.ts +16 -0
  442. package/src/types/ISRConfig.ts +512 -0
  443. package/src/types/ISRContext.ts +106 -0
  444. package/src/types/index.ts +6 -0
  445. package/src/utils/CacheCleanup.ts +74 -0
  446. package/src/utils/cacheDuration.ts +37 -0
  447. package/src/utils/cookie.ts +59 -0
  448. package/src/utils/hash.ts +32 -0
  449. package/src/utils/htmlPathname.ts +75 -0
  450. package/src/utils/index.ts +9 -0
  451. package/src/utils/resolveFetchHandler.ts +19 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
@@ -0,0 +1,549 @@
1
+ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
2
+ import { a as getRequestId, i as getRequestContext, o as getTraceId } from "./RequestContext-BVQ-rOmV.js";
3
+ import chalk from "chalk";
4
+ import ora from "ora";
5
+ import fs from "fs";
6
+ import path from "path";
7
+ import { Counter, Gauge, Histogram, Registry, collectDefaultMetrics } from "prom-client";
8
+ import { AsyncLocalStorage } from "node:async_hooks";
9
+ //#region src/logger/Logger.ts
10
+ var Logger = class Logger {
11
+ static instance;
12
+ verboseMode = false;
13
+ logFile = null;
14
+ spinner = null;
15
+ static getInstance(options = {}) {
16
+ if (!Logger.instance) Logger.instance = new Logger();
17
+ if (options.verbose !== void 0) Logger.instance.verboseMode = options.verbose;
18
+ if (options.logFile !== void 0) {
19
+ Logger.instance.logFile = options.logFile;
20
+ try {
21
+ const dir = path.dirname(options.logFile);
22
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
23
+ } catch (error) {
24
+ console.error("Failed to create log directory:", error);
25
+ }
26
+ }
27
+ return Logger.instance;
28
+ }
29
+ formatMessage(level, colorize, ...args) {
30
+ const timestamp = (/* @__PURE__ */ new Date()).toISOString();
31
+ const levelName = level.toUpperCase();
32
+ const traceId = getTraceId();
33
+ const requestId = getRequestId();
34
+ let levelTag = `[${levelName}]`;
35
+ let traceTag = `[${escapeLogValue(traceId)}]`;
36
+ let requestTag = requestId !== "unknown" ? `[${escapeLogValue(requestId)}]` : "";
37
+ const message = args.map((arg) => {
38
+ if (arg instanceof Error) return arg.stack || arg.message;
39
+ return typeof arg === "object" ? JSON.stringify(arg, null, 2) ?? "" : String(arg);
40
+ }).map(escapeLogValue).join(" ");
41
+ if (colorize) {
42
+ levelTag = this.getLevelColor(level)(levelTag);
43
+ traceTag = chalk.cyan(traceTag);
44
+ requestTag = requestTag ? chalk.blue(requestTag) : "";
45
+ return `${chalk.gray(timestamp)} ${traceTag} ${requestTag} ${levelTag} ${message}`;
46
+ }
47
+ return `${timestamp} ${traceTag} ${requestTag} ${levelTag} ${message}`;
48
+ }
49
+ getLevelColor(level) {
50
+ switch (level) {
51
+ case "error": return chalk.red.bold;
52
+ case "warn": return chalk.yellow.bold;
53
+ case "success": return chalk.green.bold;
54
+ case "info": return chalk.blue.bold;
55
+ case "debug": return chalk.magenta;
56
+ case "verbose": return chalk.gray;
57
+ default: return chalk.white;
58
+ }
59
+ }
60
+ writeToFile(message) {
61
+ if (this.logFile) try {
62
+ fs.appendFileSync(this.logFile, message + "\n");
63
+ } catch (error) {
64
+ process.stderr.write(`Failed to write to log file: ${error}\n`);
65
+ }
66
+ }
67
+ log(level, ...args) {
68
+ if (this.spinner && this.spinner.isSpinning) this.spinner.stop();
69
+ if (level === "verbose" && !this.verboseMode) return;
70
+ if (level === "debug" && !this.verboseMode) return;
71
+ console.log(this.formatMessage(level, true, ...args));
72
+ if (this.logFile) this.writeToFile(this.formatMessage(level, false, ...args));
73
+ if (this.spinner && !this.spinner.isSpinning) this.spinner.start();
74
+ }
75
+ error(...args) {
76
+ this.log("error", ...args);
77
+ }
78
+ warn(...args) {
79
+ this.log("warn", ...args);
80
+ }
81
+ info(...args) {
82
+ this.log("info", ...args);
83
+ }
84
+ success(...args) {
85
+ this.log("success", ...args);
86
+ }
87
+ debug(...args) {
88
+ this.log("debug", ...args);
89
+ }
90
+ verbose(...args) {
91
+ this.log("verbose", ...args);
92
+ }
93
+ spin(message) {
94
+ if (this.spinner) this.spinner.succeed();
95
+ this.spinner = ora(message).start();
96
+ return this.spinner;
97
+ }
98
+ stopSpinner(message, success = true) {
99
+ if (this.spinner) {
100
+ if (success) this.spinner.succeed(message);
101
+ else this.spinner.fail(message);
102
+ this.spinner = null;
103
+ }
104
+ }
105
+ };
106
+ function escapeLogValue(value) {
107
+ return Array.from(value, (character) => {
108
+ const code = character.charCodeAt(0);
109
+ if (character === "\n") return "\\n";
110
+ if (character === "\r") return "\\r";
111
+ if (code < 32 || code >= 127 && code <= 159 || code === 8232 || code === 8233) return `\\u${code.toString(16).padStart(4, "0")}`;
112
+ return character;
113
+ }).join("");
114
+ }
115
+ //#endregion
116
+ //#region src/metrics/PromMetrics.ts
117
+ /**
118
+ * PromMetrics —— prom-client 包装,导出 Prometheus 文本格式
119
+ *
120
+ * 设计:
121
+ * - prom-client 是 Node 生态的事实标准(Grafana / Datadog / Prometheus 直接抓取)
122
+ * - 单 Registry,避免污染全局;用户业务可拿 `promRegistry` 自行注册自家 metric
123
+ * - 响应时间用 Histogram(带桶),不是平均值 —— 才能正确算 P95/P99
124
+ * - 默认采集 process_*(CPU / RSS / event-loop lag)—— 一行 collectDefaultMetrics
125
+ */
126
+ var PromMetrics_exports = /* @__PURE__ */ __exportAll({
127
+ cacheEntriesGauge: () => cacheEntriesGauge,
128
+ cacheHitsTotal: () => cacheHitsTotal,
129
+ cacheRevalidatingGauge: () => cacheRevalidatingGauge,
130
+ createPrometheusMetricsMiddleware: () => createPrometheusMetricsMiddleware,
131
+ httpRequestDurationSeconds: () => httpRequestDurationSeconds,
132
+ httpRequestsTotal: () => httpRequestsTotal,
133
+ invalidatorFailuresTotal: () => invalidatorFailuresTotal,
134
+ invalidatorRunsTotal: () => invalidatorRunsTotal,
135
+ l2ReadTimeoutsTotal: () => l2ReadTimeoutsTotal,
136
+ normalizeRoute: () => normalizeRoute,
137
+ promRegistry: () => promRegistry,
138
+ recordHttpRequest: () => recordHttpRequest
139
+ });
140
+ var promRegistry = new Registry();
141
+ collectDefaultMetrics({
142
+ register: promRegistry,
143
+ prefix: "isr_"
144
+ });
145
+ var httpRequestsTotal = new Counter({
146
+ name: "isr_http_requests_total",
147
+ help: "Total ISR HTTP requests",
148
+ labelNames: [
149
+ "method",
150
+ "route",
151
+ "status",
152
+ "mode",
153
+ "cache"
154
+ ],
155
+ registers: [promRegistry]
156
+ });
157
+ var httpRequestDurationSeconds = new Histogram({
158
+ name: "isr_http_request_duration_seconds",
159
+ help: "ISR HTTP request duration",
160
+ labelNames: [
161
+ "method",
162
+ "route",
163
+ "mode",
164
+ "cache"
165
+ ],
166
+ buckets: [
167
+ .001,
168
+ .005,
169
+ .01,
170
+ .025,
171
+ .05,
172
+ .1,
173
+ .25,
174
+ .5,
175
+ 1,
176
+ 2.5,
177
+ 5
178
+ ],
179
+ registers: [promRegistry]
180
+ });
181
+ var cacheEntriesGauge = new Gauge({
182
+ name: "isr_cache_entries",
183
+ help: "Current ISR cache entries (L1 LRU size)",
184
+ labelNames: ["backend"],
185
+ registers: [promRegistry]
186
+ });
187
+ var cacheRevalidatingGauge = new Gauge({
188
+ name: "isr_cache_revalidating_inflight",
189
+ help: "Number of in-flight background revalidations",
190
+ registers: [promRegistry]
191
+ });
192
+ var cacheHitsTotal = new Counter({
193
+ name: "isr_cache_hits_total",
194
+ help: "ISR cache hits",
195
+ labelNames: ["status"],
196
+ registers: [promRegistry]
197
+ });
198
+ var invalidatorRunsTotal = new Counter({
199
+ name: "isr_invalidator_runs_total",
200
+ help: "Total revalidate dispatches (one increment per revalidatePath/Tag call with ≥1 invalidator)",
201
+ labelNames: ["kind", "target"],
202
+ registers: [promRegistry]
203
+ });
204
+ var invalidatorFailuresTotal = new Counter({
205
+ name: "isr_invalidator_failures_total",
206
+ help: "Per-invalidator failures during revalidate dispatch (one increment per failing invalidator)",
207
+ labelNames: ["kind", "target"],
208
+ registers: [promRegistry]
209
+ });
210
+ var l2ReadTimeoutsTotal = new Counter({
211
+ name: "isr_l2_read_timeouts_total",
212
+ help: "L2 cache async read timeouts (raceWithTimeout fired before underlying promise resolved)",
213
+ registers: [promRegistry]
214
+ });
215
+ /**
216
+ * 路由归一化 —— 防 Prometheus label 基数爆炸。
217
+ *
218
+ * 动态段(id / uuid / hex / 长 hash)直接作为 label 值会让时间序列数爆炸
219
+ * (每个 /books/123 都是新序列),Prometheus 存储成本线性暴涨、查询变慢。
220
+ *
221
+ * 规则:
222
+ * - 纯数字段(1 ~ 20 位) → `:id`
223
+ * - UUID v1-v5 → `:uuid`
224
+ * - 长 hex(≥16 字符全 hex)→ `:hash`
225
+ * - base64url/大小写混合长串(≥24 字符,含数字和字母)→ `:hash`
226
+ *
227
+ * 命中任意规则即替换;其他保留原样(`/books` `/about` 保留)。
228
+ *
229
+ * 可用 `addRouteNormalizeRule(pattern, replacement)` 扩展业务特有规则。
230
+ */
231
+ var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
232
+ var LONG_HEX_RE = /^[0-9a-f]{16,}$/i;
233
+ var OPAQUE_ID_RE = /^[A-Za-z0-9_-]{24,}$/;
234
+ var PURE_DIGIT_RE = /^\d{1,20}$/;
235
+ var customRules = [];
236
+ function normalizeRoute(route) {
237
+ if (!route || route === "/") return "/";
238
+ const segments = route.split("/");
239
+ for (let i = 0; i < segments.length; i++) {
240
+ const seg = segments[i];
241
+ if (!seg) continue;
242
+ let replaced = null;
243
+ for (const rule of customRules) {
244
+ replaced = rule(seg);
245
+ if (replaced) break;
246
+ }
247
+ if (replaced) {
248
+ segments[i] = replaced;
249
+ continue;
250
+ }
251
+ if (PURE_DIGIT_RE.test(seg)) segments[i] = ":id";
252
+ else if (UUID_RE.test(seg)) segments[i] = ":uuid";
253
+ else if (LONG_HEX_RE.test(seg)) segments[i] = ":hash";
254
+ else if (OPAQUE_ID_RE.test(seg)) segments[i] = ":hash";
255
+ }
256
+ return segments.join("/");
257
+ }
258
+ /** 一行调用更新所有计数 —— 给 isrCacheMiddleware / 中间件用 */
259
+ function recordHttpRequest(opts) {
260
+ const route = normalizeRoute(opts.route);
261
+ httpRequestsTotal.inc({
262
+ method: opts.method,
263
+ route,
264
+ status: String(opts.status),
265
+ mode: opts.mode,
266
+ cache: opts.cache
267
+ });
268
+ httpRequestDurationSeconds.observe({
269
+ method: opts.method,
270
+ route,
271
+ mode: opts.mode,
272
+ cache: opts.cache
273
+ }, opts.durationMs / 1e3);
274
+ if (opts.cache) cacheHitsTotal.inc({ status: opts.cache });
275
+ }
276
+ /**
277
+ * Express / connect 中间件:暴露 /metrics 端点(Prometheus text exposition format)
278
+ *
279
+ * 认证:可选 Bearer token —— 未设 token 时保持旧行为(匿名可访问)。
280
+ * 生产建议:`createPrometheusMetricsMiddleware({ token: process.env.METRICS_TOKEN })`。
281
+ */
282
+ function createPrometheusMetricsMiddleware(pathOrOptions = {}) {
283
+ const options = typeof pathOrOptions === "string" ? { path: pathOrOptions } : pathOrOptions;
284
+ const path = options.path ?? "/metrics";
285
+ const token = options.token && options.token !== "" ? options.token : null;
286
+ const unauthorizedStatus = options.unauthorizedStatus ?? 401;
287
+ return async function(req, res, next) {
288
+ if (req.url !== path || req.method !== "GET") return next();
289
+ if (token) {
290
+ const authHeader = req.headers?.["authorization"];
291
+ const raw = Array.isArray(authHeader) ? authHeader[0] : authHeader;
292
+ if (!(typeof raw === "string" && raw === `Bearer ${token}`)) {
293
+ res.statusCode = unauthorizedStatus;
294
+ res.setHeader("WWW-Authenticate", "Bearer realm=\"metrics\"");
295
+ res.end("Unauthorized");
296
+ return;
297
+ }
298
+ }
299
+ try {
300
+ const body = await promRegistry.metrics();
301
+ res.setHeader("content-type", promRegistry.contentType);
302
+ res.statusCode = 200;
303
+ res.end(body);
304
+ } catch (err) {
305
+ res.statusCode = 500;
306
+ res.end(`metrics error: ${err instanceof Error ? err.message : String(err)}`);
307
+ }
308
+ };
309
+ }
310
+ //#endregion
311
+ //#region src/rsc/revalidate.ts
312
+ /**
313
+ * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效
314
+ *
315
+ * 跨环境状态共享:
316
+ * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),
317
+ * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),
318
+ * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。
319
+ * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,
320
+ * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。
321
+ *
322
+ * 失败语义(v2.0.x 起):
323
+ * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行
324
+ * 但 reject 被吞**——多 invalidator 场景下出现"看似成功但部分缓存没清"的脏状态。
325
+ * 现在改为:
326
+ * 1. `Promise.allSettled` 让所有 invalidator 都跑到底
327
+ * 2. 每个失败单独打 metric + log(含 trace 上下文)
328
+ * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)
329
+ * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,
330
+ * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种"沉默错误"比抛错更危险。
331
+ *
332
+ * 用法:
333
+ * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`
334
+ * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册
335
+ * 3. 分发到所有注册的 invalidator,清理对应缓存条目
336
+ *
337
+ * 注意:
338
+ * - 本模块不持有任何缓存实现,纯做路由分发
339
+ * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op
340
+ */
341
+ var logger$1 = Logger.getInstance();
342
+ /** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */
343
+ var REGISTRY_KEY = Symbol.for("isr-engine:revalidate-registry");
344
+ function getRegistry() {
345
+ const g = globalThis;
346
+ if (!g[REGISTRY_KEY]) g[REGISTRY_KEY] = /* @__PURE__ */ new Set();
347
+ return g[REGISTRY_KEY];
348
+ }
349
+ /**
350
+ * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)
351
+ * 返回取消注册的函数
352
+ */
353
+ function registerInvalidator(fn) {
354
+ const registry = getRegistry();
355
+ registry.add(fn);
356
+ return () => {
357
+ registry.delete(fn);
358
+ };
359
+ }
360
+ /**
361
+ * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。
362
+ *
363
+ * 含:
364
+ * - successCount / failureCount:方便调用方决定补偿策略
365
+ * - causes:每个失败的原始 Error(按注册顺序)
366
+ * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')
367
+ *
368
+ * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node
369
+ * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。
370
+ */
371
+ var RevalidationError = class extends Error {
372
+ target;
373
+ successCount;
374
+ failureCount;
375
+ causes;
376
+ constructor(target, successCount, failureCount, causes) {
377
+ super(`revalidate(${target}) —— ${failureCount} invalidator(s) failed, ${successCount} succeeded. First cause: ${causes[0]?.message ?? "(unknown)"}`);
378
+ this.name = "RevalidationError";
379
+ this.target = target;
380
+ this.successCount = successCount;
381
+ this.failureCount = failureCount;
382
+ this.causes = causes;
383
+ }
384
+ };
385
+ /**
386
+ * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。
387
+ *
388
+ * `Promise.allSettled` 保证任意 invalidator 抛错都不会中断其他 invalidator 的执行——
389
+ * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。
390
+ */
391
+ async function dispatch(target) {
392
+ const registry = getRegistry();
393
+ const targetLabel = `${target.kind}:${target.value}`;
394
+ const targetMetricValue = target.kind === "path" ? normalizeRoute(target.value) : target.value;
395
+ if (registry.size === 0) {
396
+ logger$1.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);
397
+ return;
398
+ }
399
+ invalidatorRunsTotal.inc({
400
+ kind: target.kind,
401
+ target: targetMetricValue
402
+ });
403
+ const invalidators = Array.from(registry);
404
+ const results = await Promise.allSettled(invalidators.map(async (fn) => fn(target)));
405
+ const causes = [];
406
+ let successCount = 0;
407
+ let failureCount = 0;
408
+ results.forEach((r, idx) => {
409
+ if (r.status === "fulfilled") {
410
+ successCount++;
411
+ return;
412
+ }
413
+ failureCount++;
414
+ const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));
415
+ causes.push(err);
416
+ invalidatorFailuresTotal.inc({
417
+ kind: target.kind,
418
+ target: targetMetricValue
419
+ });
420
+ logger$1.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);
421
+ });
422
+ if (failureCount > 0) throw new RevalidationError(targetLabel, successCount, failureCount, causes);
423
+ logger$1.debug(`✅ revalidate(${targetLabel}) —— 已分发到 ${registry.size} 个 invalidator(全部成功)`);
424
+ }
425
+ /**
426
+ * 使指定路径的缓存失效
427
+ *
428
+ * @param path 形如 '/books' / '/posts/42' 的路径
429
+ * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)
430
+ */
431
+ async function revalidatePath(path) {
432
+ await dispatch({
433
+ kind: "path",
434
+ value: path
435
+ });
436
+ }
437
+ /**
438
+ * 使指定 tag 标记的所有缓存条目失效
439
+ *
440
+ * @param tag 业务语义 tag(如 'books' / `book:${id}`)
441
+ * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)
442
+ */
443
+ async function revalidateTag(tag) {
444
+ await dispatch({
445
+ kind: "tag",
446
+ value: tag
447
+ });
448
+ }
449
+ //#endregion
450
+ //#region src/rsc/cacheTag.ts
451
+ /**
452
+ * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效
453
+ *
454
+ * 协作模型:
455
+ * 1. ISR 缓存中间件在进入 handler 前 `runWithTagStore(() => rscHandler(request))`
456
+ * —— 给本次请求开一个 AsyncLocalStorage 作用域,内部放 `{ tags: Set<string> }`
457
+ * 2. Server Component 体内任意位置调用 `cacheTag('books', `book:${id}`)`
458
+ * → 写入当前作用域的 tags Set
459
+ * 3. 响应捕获阶段 `collectTags()` 读出 tag 列表,写入 CachedEntry.tags
460
+ * 4. `revalidateTag('books')` 被 invalidator 接收后,遍历 cache 条目,
461
+ * 命中 tags 列表的精准清除(无副作用污染其他条目)
462
+ *
463
+ * 跨环境状态共享:
464
+ * Server Component 在 Vite `rsc` 环境执行(模块图 A),
465
+ * ISR 缓存中间件在 Node(模块图 B)。
466
+ * ES 模块作用域的 `new AsyncLocalStorage()` 会被双模块图各持有一份副本,
467
+ * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。
468
+ * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)
469
+ */
470
+ var logger = Logger.getInstance();
471
+ var ALS_KEY = Symbol.for("isr-engine:cache-tag-als");
472
+ function getALS() {
473
+ const g = globalThis;
474
+ if (!g[ALS_KEY]) g[ALS_KEY] = new AsyncLocalStorage();
475
+ return g[ALS_KEY];
476
+ }
477
+ /**
478
+ * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用
479
+ *
480
+ * fn 内部以及 fn 启动的任何 async/Promise 链路内,调用 cacheTag(...) 都会
481
+ * 写入本作用域,不会污染父作用域或兄弟请求
482
+ */
483
+ function runWithTagStore(fn) {
484
+ return getALS().run({
485
+ tags: /* @__PURE__ */ new Set(),
486
+ uncacheable: false
487
+ }, fn);
488
+ }
489
+ /**
490
+ * 在 Server Component / loader 内显式声明本次渲染产物**不应入缓存**。
491
+ * 适用场景:上游接口失败、降级渲染了一段错误提示 UI、命中风控/限流等
492
+ * —— 渲染结果是 200,但内容会让用户困惑或马上过期,不应被 ISR HIT 反复回放。
493
+ *
494
+ * 调用一次即可;后续 cacheTag(...) 仍可继续调用但不会改变 uncacheable 决定。
495
+ */
496
+ function markUncacheable() {
497
+ const store = getALS().getStore();
498
+ if (store) store.uncacheable = true;
499
+ }
500
+ /** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */
501
+ function isUncacheable() {
502
+ return getALS().getStore()?.uncacheable === true;
503
+ }
504
+ /**
505
+ * Server Component / server action / server-only util 内声明:
506
+ * 本次渲染/调用产出的缓存条目应关联以下 tag
507
+ *
508
+ * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略
509
+ */
510
+ function cacheTag(...tags) {
511
+ const store = getALS().getStore();
512
+ if (!store) return;
513
+ for (const tag of tags) if (typeof tag === "string" && tag.length > 0) store.tags.add(tag);
514
+ }
515
+ /**
516
+ * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)
517
+ */
518
+ function collectTags() {
519
+ const store = getALS().getStore();
520
+ return store ? Array.from(store.tags) : [];
521
+ }
522
+ /**
523
+ * 调试:打印当前 tag store 状态
524
+ */
525
+ function debugTagStore(label = "") {
526
+ const store = getALS().getStore();
527
+ logger.debug(`[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : "<none>"}`);
528
+ }
529
+ //#endregion
530
+ //#region src/middlewares/abVariantContext.ts
531
+ /**
532
+ * A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦
533
+ *
534
+ * RSC 环境通过本文件 import(不引入 express 类型,bundle 更轻);
535
+ * Express 中间件在 ABVariantMiddleware.ts。
536
+ */
537
+ /**
538
+ * 在 Server Component 里读取 variant
539
+ *
540
+ * 不在 A/B middleware 后调用 → 返回 undefined
541
+ */
542
+ function getVariant(experimentName) {
543
+ const v = getRequestContext()?.flags?.[experimentName];
544
+ return typeof v === "string" ? v : void 0;
545
+ }
546
+ //#endregion
547
+ export { invalidatorRunsTotal as _, isUncacheable as a, recordHttpRequest as b, RevalidationError as c, revalidateTag as d, PromMetrics_exports as f, invalidatorFailuresTotal as g, createPrometheusMetricsMiddleware as h, debugTagStore as i, registerInvalidator as l, cacheRevalidatingGauge as m, cacheTag as n, markUncacheable as o, cacheEntriesGauge as p, collectTags as r, runWithTagStore as s, getVariant as t, revalidatePath as u, l2ReadTimeoutsTotal as v, Logger as x, promRegistry as y };
548
+
549
+ //# sourceMappingURL=abVariantContext-CWCdRSdG.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"abVariantContext-CWCdRSdG.js","names":[],"sources":["../src/logger/Logger.ts","../src/metrics/PromMetrics.ts","../src/rsc/revalidate.ts","../src/rsc/cacheTag.ts","../src/middlewares/abVariantContext.ts"],"sourcesContent":["import chalk from 'chalk';\nimport ora, { Ora } from 'ora';\nimport fs from 'fs';\nimport path from 'path';\nimport { getTraceId, getRequestId } from '../context/RequestContext';\n\nexport enum LogLevel {\n VERBOSE = 'verbose',\n DEBUG = 'debug',\n INFO = 'info',\n WARN = 'warn',\n ERROR = 'error',\n SUCCESS = 'success',\n}\n\nexport interface LoggerOptions {\n verbose?: boolean;\n logFile?: string;\n}\n\nexport class Logger {\n private static instance: Logger;\n private verboseMode: boolean = false;\n private logFile: string | null = null;\n private spinner: Ora | null = null;\n\n public static getInstance(options: LoggerOptions = {}): Logger {\n if (!Logger.instance) {\n Logger.instance = new Logger();\n }\n\n if (options.verbose !== undefined) {\n Logger.instance.verboseMode = options.verbose;\n }\n\n if (options.logFile !== undefined) {\n Logger.instance.logFile = options.logFile;\n try {\n const dir = path.dirname(options.logFile);\n if (!fs.existsSync(dir)) {\n fs.mkdirSync(dir, { recursive: true });\n }\n } catch (error) {\n console.error('Failed to create log directory:', error);\n }\n }\n\n return Logger.instance;\n }\n\n private formatMessage(level: LogLevel, colorize: boolean, ...args: unknown[]): string {\n const timestamp = new Date().toISOString();\n const levelName = level.toUpperCase();\n const traceId = getTraceId();\n const requestId = getRequestId();\n\n let levelTag = `[${levelName}]`;\n let traceTag = `[${escapeLogValue(traceId)}]`;\n let requestTag = requestId !== 'unknown' ? `[${escapeLogValue(requestId)}]` : '';\n\n const message = args\n .map(arg => {\n if (arg instanceof Error) {\n return arg.stack || arg.message;\n }\n return typeof arg === 'object' ? (JSON.stringify(arg, null, 2) ?? '') : String(arg);\n })\n .map(escapeLogValue)\n .join(' ');\n\n if (colorize) {\n const levelColor = this.getLevelColor(level);\n levelTag = levelColor(levelTag);\n traceTag = chalk.cyan(traceTag);\n requestTag = requestTag ? chalk.blue(requestTag) : '';\n return `${chalk.gray(timestamp)} ${traceTag} ${requestTag} ${levelTag} ${message}`;\n }\n\n return `${timestamp} ${traceTag} ${requestTag} ${levelTag} ${message}`;\n }\n\n private getLevelColor(level: LogLevel) {\n switch (level) {\n case LogLevel.ERROR:\n return chalk.red.bold;\n case LogLevel.WARN:\n return chalk.yellow.bold;\n case LogLevel.SUCCESS:\n return chalk.green.bold;\n case LogLevel.INFO:\n return chalk.blue.bold;\n case LogLevel.DEBUG:\n return chalk.magenta;\n case LogLevel.VERBOSE:\n return chalk.gray;\n default:\n return chalk.white;\n }\n }\n\n private writeToFile(message: string) {\n if (this.logFile) {\n try {\n fs.appendFileSync(this.logFile, message + '\\n');\n } catch (error) {\n // Prevent infinite loop if logging fails\n process.stderr.write(`Failed to write to log file: ${error}\\n`);\n }\n }\n }\n\n public log(level: LogLevel, ...args: unknown[]) {\n if (this.spinner && this.spinner.isSpinning) {\n this.spinner.stop();\n }\n\n if (level === LogLevel.VERBOSE && !this.verboseMode) return;\n if (level === LogLevel.DEBUG && !this.verboseMode) return;\n\n // Console output\n console.log(this.formatMessage(level, true, ...args));\n\n // File output\n if (this.logFile) {\n this.writeToFile(this.formatMessage(level, false, ...args));\n }\n\n if (this.spinner && !this.spinner.isSpinning) {\n this.spinner.start();\n }\n }\n\n public error(...args: unknown[]) {\n this.log(LogLevel.ERROR, ...args);\n }\n\n public warn(...args: unknown[]) {\n this.log(LogLevel.WARN, ...args);\n }\n\n public info(...args: unknown[]) {\n this.log(LogLevel.INFO, ...args);\n }\n\n public success(...args: unknown[]) {\n this.log(LogLevel.SUCCESS, ...args);\n }\n\n public debug(...args: unknown[]) {\n this.log(LogLevel.DEBUG, ...args);\n }\n\n public verbose(...args: unknown[]) {\n this.log(LogLevel.VERBOSE, ...args);\n }\n\n public spin(message: string): Ora {\n if (this.spinner) {\n this.spinner.succeed();\n }\n this.spinner = ora(message).start();\n return this.spinner;\n }\n\n public stopSpinner(message?: string, success: boolean = true) {\n if (this.spinner) {\n if (success) {\n this.spinner.succeed(message);\n } else {\n this.spinner.fail(message);\n }\n this.spinner = null;\n }\n }\n}\n\nfunction escapeLogValue(value: string): string {\n return Array.from(value, character => {\n const code = character.charCodeAt(0);\n if (character === '\\n') return '\\\\n';\n if (character === '\\r') return '\\\\r';\n if (code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === 0x2028 || code === 0x2029) {\n return `\\\\u${code.toString(16).padStart(4, '0')}`;\n }\n return character;\n }).join('');\n}\n","/**\n * PromMetrics —— prom-client 包装,导出 Prometheus 文本格式\n *\n * 设计:\n * - prom-client 是 Node 生态的事实标准(Grafana / Datadog / Prometheus 直接抓取)\n * - 单 Registry,避免污染全局;用户业务可拿 `promRegistry` 自行注册自家 metric\n * - 响应时间用 Histogram(带桶),不是平均值 —— 才能正确算 P95/P99\n * - 默认采集 process_*(CPU / RSS / event-loop lag)—— 一行 collectDefaultMetrics\n */\nimport { Counter, Histogram, Gauge, Registry, collectDefaultMetrics } from 'prom-client';\n\nexport const promRegistry = new Registry();\n\ncollectDefaultMetrics({ register: promRegistry, prefix: 'isr_' });\n\n// ─── 业务指标(与 isr-engine 概念一致)───\n\nexport const httpRequestsTotal = new Counter({\n name: 'isr_http_requests_total',\n help: 'Total ISR HTTP requests',\n labelNames: ['method', 'route', 'status', 'mode', 'cache'] as const,\n registers: [promRegistry],\n});\n\nexport const httpRequestDurationSeconds = new Histogram({\n name: 'isr_http_request_duration_seconds',\n help: 'ISR HTTP request duration',\n labelNames: ['method', 'route', 'mode', 'cache'] as const,\n // 桶:1ms - 5s(覆盖 HIT 极快到 SSR 慢路径)\n buckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5],\n registers: [promRegistry],\n});\n\nexport const cacheEntriesGauge = new Gauge({\n name: 'isr_cache_entries',\n help: 'Current ISR cache entries (L1 LRU size)',\n labelNames: ['backend'] as const,\n registers: [promRegistry],\n});\n\nexport const cacheRevalidatingGauge = new Gauge({\n name: 'isr_cache_revalidating_inflight',\n help: 'Number of in-flight background revalidations',\n registers: [promRegistry],\n});\n\nexport const cacheHitsTotal = new Counter({\n name: 'isr_cache_hits_total',\n help: 'ISR cache hits',\n labelNames: ['status'] as const, // HIT / STALE / MISS / BYPASS / REVALIDATING\n registers: [promRegistry],\n});\n\n// ─── 失效(revalidatePath / revalidateTag)—— 分别记总调用数与失败数 ───\n//\n// 这两个对生产排错很关键:\n// - revalidatePath / revalidateTag 是 Server Action 的关键路径,失败意味着用户看到旧数据\n// - 失败率 = failures / runs,告警阈值通常设 1%\n// - kind 标签拆 path / tag,因为这俩失败通常对应不同的根因(路由匹配 vs tag 索引)\n// - target 标签是归一化路径或 tag 名,让 Grafana 能定位到具体业务对象(如 /books/:id)。\n// 必须走 normalizeRoute 防止 /books/123 / /books/124 各起一条时间序列导致基数爆炸;\n// tag 本身就是业务定义的有限集合(如 'books' / 'book:123'),不再二次归一化。\n\nexport const invalidatorRunsTotal = new Counter({\n name: 'isr_invalidator_runs_total',\n help: 'Total revalidate dispatches (one increment per revalidatePath/Tag call with ≥1 invalidator)',\n labelNames: ['kind', 'target'] as const, // kind='path'|'tag'; target=normalized path or tag value\n registers: [promRegistry],\n});\n\nexport const invalidatorFailuresTotal = new Counter({\n name: 'isr_invalidator_failures_total',\n help: 'Per-invalidator failures during revalidate dispatch (one increment per failing invalidator)',\n labelNames: ['kind', 'target'] as const,\n registers: [promRegistry],\n});\n\n// L2(Redis 等异步后端)读超时计数 —— 命中 raceWithTimeout 的兜底返回 undefined。\n// 缓存中间件把 L2 超时降级为 miss,业务侧看不到错误但 cache hit rate 会被拖低。\n// 单独 counter 让 SRE 能区分 “真 miss”(数据没缓存过)vs “伪 miss”(Redis 抖动)。\nexport const l2ReadTimeoutsTotal = new Counter({\n name: 'isr_l2_read_timeouts_total',\n help: 'L2 cache async read timeouts (raceWithTimeout fired before underlying promise resolved)',\n registers: [promRegistry],\n});\n\n/**\n * 路由归一化 —— 防 Prometheus label 基数爆炸。\n *\n * 动态段(id / uuid / hex / 长 hash)直接作为 label 值会让时间序列数爆炸\n * (每个 /books/123 都是新序列),Prometheus 存储成本线性暴涨、查询变慢。\n *\n * 规则:\n * - 纯数字段(1 ~ 20 位) → `:id`\n * - UUID v1-v5 → `:uuid`\n * - 长 hex(≥16 字符全 hex)→ `:hash`\n * - base64url/大小写混合长串(≥24 字符,含数字和字母)→ `:hash`\n *\n * 命中任意规则即替换;其他保留原样(`/books` `/about` 保留)。\n *\n * 可用 `addRouteNormalizeRule(pattern, replacement)` 扩展业务特有规则。\n */\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\nconst LONG_HEX_RE = /^[0-9a-f]{16,}$/i;\nconst OPAQUE_ID_RE = /^[A-Za-z0-9_-]{24,}$/;\nconst PURE_DIGIT_RE = /^\\d{1,20}$/;\n\nexport type RouteNormalizeRule = (segment: string) => string | null;\nconst customRules: RouteNormalizeRule[] = [];\n\nexport function addRouteNormalizeRule(rule: RouteNormalizeRule): void {\n customRules.push(rule);\n}\n\nexport function normalizeRoute(route: string): string {\n if (!route || route === '/') return '/';\n const segments = route.split('/');\n for (let i = 0; i < segments.length; i++) {\n const seg = segments[i];\n if (!seg) continue;\n let replaced: string | null = null;\n for (const rule of customRules) {\n replaced = rule(seg);\n if (replaced) break;\n }\n if (replaced) {\n segments[i] = replaced;\n continue;\n }\n if (PURE_DIGIT_RE.test(seg)) {\n segments[i] = ':id';\n } else if (UUID_RE.test(seg)) {\n segments[i] = ':uuid';\n } else if (LONG_HEX_RE.test(seg)) {\n segments[i] = ':hash';\n } else if (OPAQUE_ID_RE.test(seg)) {\n segments[i] = ':hash';\n }\n }\n return segments.join('/');\n}\n\n/** 一行调用更新所有计数 —— 给 isrCacheMiddleware / 中间件用 */\nexport function recordHttpRequest(opts: {\n method: string;\n route: string;\n status: number;\n mode: string;\n cache: string;\n durationMs: number;\n}): void {\n const route = normalizeRoute(opts.route);\n httpRequestsTotal.inc({\n method: opts.method,\n route,\n status: String(opts.status),\n mode: opts.mode,\n cache: opts.cache,\n });\n httpRequestDurationSeconds.observe(\n { method: opts.method, route, mode: opts.mode, cache: opts.cache },\n opts.durationMs / 1000\n );\n if (opts.cache) cacheHitsTotal.inc({ status: opts.cache });\n}\n\nexport interface PrometheusMetricsMiddlewareOptions {\n /** 挂载路径;默认 `/metrics` */\n path?: string;\n /**\n * 要求客户端提供的 Bearer token。\n * 明确设 false/undefined/'' → 不做认证(仅建议用于纯内网 /k8s Pod 内暴露)。\n * 生产外网挂载**强烈建议**设 token,避免指标泄露业务信息(QPS、错误分布、路由列表)。\n */\n token?: string | false;\n /** 不通过时返回的状态码;默认 401 */\n unauthorizedStatus?: number;\n}\n\n/**\n * Express / connect 中间件:暴露 /metrics 端点(Prometheus text exposition format)\n *\n * 认证:可选 Bearer token —— 未设 token 时保持旧行为(匿名可访问)。\n * 生产建议:`createPrometheusMetricsMiddleware({ token: process.env.METRICS_TOKEN })`。\n */\nexport function createPrometheusMetricsMiddleware(\n pathOrOptions: string | PrometheusMetricsMiddlewareOptions = {}\n) {\n const options: PrometheusMetricsMiddlewareOptions =\n typeof pathOrOptions === 'string' ? { path: pathOrOptions } : pathOrOptions;\n const path = options.path ?? '/metrics';\n const token = options.token && options.token !== '' ? options.token : null;\n const unauthorizedStatus = options.unauthorizedStatus ?? 401;\n\n return async function (\n req: { url?: string; method?: string; headers?: Record<string, string | string[] | undefined> },\n res: {\n setHeader(k: string, v: string): void;\n end(body?: string): void;\n statusCode: number;\n },\n next: () => void\n ): Promise<void> {\n if (req.url !== path || req.method !== 'GET') return next();\n\n if (token) {\n const authHeader = req.headers?.['authorization'];\n const raw = Array.isArray(authHeader) ? authHeader[0] : authHeader;\n const ok = typeof raw === 'string' && raw === `Bearer ${token}`;\n if (!ok) {\n res.statusCode = unauthorizedStatus;\n res.setHeader('WWW-Authenticate', 'Bearer realm=\"metrics\"');\n res.end('Unauthorized');\n return;\n }\n }\n\n try {\n const body = await promRegistry.metrics();\n res.setHeader('content-type', promRegistry.contentType);\n res.statusCode = 200;\n res.end(body);\n } catch (err) {\n res.statusCode = 500;\n res.end(`metrics error: ${err instanceof Error ? err.message : String(err)}`);\n }\n };\n}\n","/**\n * 缓存失效契约 —— `revalidatePath(path)` 按路径精准失效;`revalidateTag(tag)` 按渲染期声明的 tag 失效\n *\n * 跨环境状态共享:\n * Server Action 在 Vite 的 `rsc` 环境中执行(模块图 A),\n * 而 ISR 缓存中间件注册 invalidator 在 Node 上下文(模块图 B),\n * 两份模块图下,同名模块可能各自持有独立的 ES 模块状态。\n * 因此本模块把 invalidator 注册表挂在 `globalThis` 上作为跨环境单例,\n * 确保 `revalidatePath/Tag` 调用能分发到所有已注册的 invalidator。\n *\n * 失败语义(v2.0.x 起):\n * 过去版本用 `Promise.all`,**首个失败的 invalidator 会抛出,剩余的可能仍在执行\n * 但 reject 被吞**——多 invalidator 场景下出现\"看似成功但部分缓存没清\"的脏状态。\n * 现在改为:\n * 1. `Promise.allSettled` 让所有 invalidator 都跑到底\n * 2. 每个失败单独打 metric + log(含 trace 上下文)\n * 3. 整体 ≥ 1 个失败 → 抛聚合 `RevalidationError`(含 successCount/failureCount/causes)\n * 调用方(Server Action)务必 `try { await revalidateTag(...) } catch (e) { ... }`,\n * 否则用户提交后看到的是 200 但底层有部分 cache 未清——这种\"沉默错误\"比抛错更危险。\n *\n * 用法:\n * 1. Server Action 内部调用 `revalidatePath('/books')` 或 `revalidateTag('books')`\n * 2. ISR cache 中间件 / ISREngine 启动时通过 `registerInvalidator(fn)` 注册\n * 3. 分发到所有注册的 invalidator,清理对应缓存条目\n *\n * 注意:\n * - 本模块不持有任何缓存实现,纯做路由分发\n * - 若未注册 invalidator(例如脱离 engine 的纯 RSC 场景),调用静默为 no-op\n */\n\nimport { Logger } from '../logger/Logger';\nimport {\n invalidatorFailuresTotal,\n invalidatorRunsTotal,\n normalizeRoute,\n} from '../metrics/PromMetrics';\n\nconst logger = Logger.getInstance();\n\n/** Invalidator 签名:接收失效目标描述 */\nexport interface RevalidateInvalidator {\n (target: { kind: 'path'; value: string } | { kind: 'tag'; value: string }): Promise<void> | void;\n}\n\n/** 全局单例 key(Symbol.for 保证跨模块图复用同一注册表) */\nconst REGISTRY_KEY = Symbol.for('isr-engine:revalidate-registry');\n\ntype GlobalWithRegistry = typeof globalThis & {\n [REGISTRY_KEY]?: Set<RevalidateInvalidator>;\n};\n\nfunction getRegistry(): Set<RevalidateInvalidator> {\n const g = globalThis as GlobalWithRegistry;\n if (!g[REGISTRY_KEY]) {\n g[REGISTRY_KEY] = new Set<RevalidateInvalidator>();\n }\n return g[REGISTRY_KEY];\n}\n\n/**\n * 注册一个 invalidator 实例(通常由 ISR 缓存中间件 / ISREngine 调用)\n * 返回取消注册的函数\n */\nexport function registerInvalidator(fn: RevalidateInvalidator): () => void {\n const registry = getRegistry();\n registry.add(fn);\n return () => {\n registry.delete(fn);\n };\n}\n\n/**\n * 聚合失效错误 —— 当一个或多个 invalidator 失败时抛出。\n *\n * 含:\n * - successCount / failureCount:方便调用方决定补偿策略\n * - causes:每个失败的原始 Error(按注册顺序)\n * - target:触发本次 revalidate 的描述('tag:books' / 'path:/books')\n *\n * 注意:用 `extends Error` 而非 `AggregateError`,因为 AggregateError 在某些 Node\n * 版本对 stack/message 序列化不稳,自定义 class 更可控且 instanceof 检测可靠。\n */\nexport class RevalidationError extends Error {\n public readonly target: string;\n public readonly successCount: number;\n public readonly failureCount: number;\n public readonly causes: readonly Error[];\n\n constructor(\n target: string,\n successCount: number,\n failureCount: number,\n causes: readonly Error[]\n ) {\n super(\n `revalidate(${target}) —— ${failureCount} invalidator(s) failed, ` +\n `${successCount} succeeded. First cause: ${causes[0]?.message ?? '(unknown)'}`\n );\n this.name = 'RevalidationError';\n this.target = target;\n this.successCount = successCount;\n this.failureCount = failureCount;\n this.causes = causes;\n }\n}\n\ntype RevalidateTarget = { kind: 'path'; value: string } | { kind: 'tag'; value: string };\n\n/**\n * 内部统一分发:跑所有 invalidator,把失败聚合成 RevalidationError 抛出。\n *\n * `Promise.allSettled` 保证任意 invalidator 抛错都不会中断其他 invalidator 的执行——\n * 这样即使 Redis 回源失败,进程内 LRU 至少能清干净;进程内 LRU 失败也不会拖累 Redis。\n */\nasync function dispatch(target: RevalidateTarget): Promise<void> {\n const registry = getRegistry();\n const targetLabel = `${target.kind}:${target.value}`;\n // path 必须归一化防止动态段(/books/123 / /books/124)让 Prom 时间序列爆炸;\n // tag 是业务定义的有限标识符('books'、'book:123' 也是有限模式),原样保留。\n const targetMetricValue = target.kind === 'path' ? normalizeRoute(target.value) : target.value;\n\n if (registry.size === 0) {\n logger.debug(`revalidate(${targetLabel}) —— 无 invalidator 注册,忽略`);\n return;\n }\n\n invalidatorRunsTotal.inc({ kind: target.kind, target: targetMetricValue });\n\n // 包一层 async 函数:把同步抛错也转成 Promise rejection,让 allSettled 能统一处理\n // (直接 `fn(target)` 在 fn 同步抛错时会在 `.map` 里 escape,allSettled 收不到)\n const invalidators = Array.from(registry);\n const results = await Promise.allSettled(invalidators.map(async fn => fn(target)));\n\n const causes: Error[] = [];\n let successCount = 0;\n let failureCount = 0;\n\n results.forEach((r, idx) => {\n if (r.status === 'fulfilled') {\n successCount++;\n return;\n }\n failureCount++;\n const err = r.reason instanceof Error ? r.reason : new Error(String(r.reason));\n causes.push(err);\n invalidatorFailuresTotal.inc({ kind: target.kind, target: targetMetricValue });\n // 单独 log 每个失败,方便从 stack 定位是哪个 invalidator\n logger.error(`[revalidate] invalidator #${idx} failed for ${targetLabel}: ${err.message}`, err);\n });\n\n if (failureCount > 0) {\n throw new RevalidationError(targetLabel, successCount, failureCount, causes);\n }\n\n logger.debug(\n `✅ revalidate(${targetLabel}) —— 已分发到 ${registry.size} 个 invalidator(全部成功)`\n );\n}\n\n/**\n * 使指定路径的缓存失效\n *\n * @param path 形如 '/books' / '/posts/42' 的路径\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidatePath(path: string): Promise<void> {\n await dispatch({ kind: 'path', value: path });\n}\n\n/**\n * 使指定 tag 标记的所有缓存条目失效\n *\n * @param tag 业务语义 tag(如 'books' / `book:${id}`)\n * @throws {RevalidationError} 任意 invalidator 失败时(其余仍执行完毕)\n */\nexport async function revalidateTag(tag: string): Promise<void> {\n await dispatch({ kind: 'tag', value: tag });\n}\n","/**\n * 缓存 Tag 上下文 —— 支持 Server Component 在渲染期声明 tag,便于后续 revalidateTag 精细失效\n *\n * 协作模型:\n * 1. ISR 缓存中间件在进入 handler 前 `runWithTagStore(() => rscHandler(request))`\n * —— 给本次请求开一个 AsyncLocalStorage 作用域,内部放 `{ tags: Set<string> }`\n * 2. Server Component 体内任意位置调用 `cacheTag('books', `book:${id}`)`\n * → 写入当前作用域的 tags Set\n * 3. 响应捕获阶段 `collectTags()` 读出 tag 列表,写入 CachedEntry.tags\n * 4. `revalidateTag('books')` 被 invalidator 接收后,遍历 cache 条目,\n * 命中 tags 列表的精准清除(无副作用污染其他条目)\n *\n * 跨环境状态共享:\n * Server Component 在 Vite `rsc` 环境执行(模块图 A),\n * ISR 缓存中间件在 Node(模块图 B)。\n * ES 模块作用域的 `new AsyncLocalStorage()` 会被双模块图各持有一份副本,\n * 导致 cacheTag 写入的 store 与 collectTags 读取的 store 不互通。\n * 故本模块把 ALS 实例挂在 `globalThis` 上作为跨模块图单例(Symbol.for key)\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nimport { Logger } from '../logger/Logger';\n\nconst logger = Logger.getInstance();\n\ninterface TagStore {\n tags: Set<string>;\n /** 本次渲染过程中是否被显式标记为不可缓存(例如上游 fetch 失败) */\n uncacheable: boolean;\n}\n\nconst ALS_KEY = Symbol.for('isr-engine:cache-tag-als');\n\ntype GlobalWithALS = typeof globalThis & {\n [ALS_KEY]?: AsyncLocalStorage<TagStore>;\n};\n\nfunction getALS(): AsyncLocalStorage<TagStore> {\n const g = globalThis as GlobalWithALS;\n if (!g[ALS_KEY]) {\n g[ALS_KEY] = new AsyncLocalStorage<TagStore>();\n }\n return g[ALS_KEY];\n}\n\n/**\n * 在独立的 tag 作用域中执行 fn —— 通常由 ISR 缓存中间件在每次请求前调用\n *\n * fn 内部以及 fn 启动的任何 async/Promise 链路内,调用 cacheTag(...) 都会\n * 写入本作用域,不会污染父作用域或兄弟请求\n */\nexport function runWithTagStore<T>(fn: () => T | Promise<T>): T | Promise<T> {\n return getALS().run({ tags: new Set<string>(), uncacheable: false }, fn);\n}\n\n/**\n * 在 Server Component / loader 内显式声明本次渲染产物**不应入缓存**。\n * 适用场景:上游接口失败、降级渲染了一段错误提示 UI、命中风控/限流等\n * —— 渲染结果是 200,但内容会让用户困惑或马上过期,不应被 ISR HIT 反复回放。\n *\n * 调用一次即可;后续 cacheTag(...) 仍可继续调用但不会改变 uncacheable 决定。\n */\nexport function markUncacheable(): void {\n const store = getALS().getStore();\n if (store) {\n store.uncacheable = true;\n }\n}\n\n/** 读取本次渲染是否被标记为不可缓存(ISR 缓存中间件在响应捕获阶段调用) */\nexport function isUncacheable(): boolean {\n return getALS().getStore()?.uncacheable === true;\n}\n\n/**\n * Server Component / server action / server-only util 内声明:\n * 本次渲染/调用产出的缓存条目应关联以下 tag\n *\n * 多次调用会合并 tag;无 tag 作用域(例如脱离缓存中间件时)静默忽略\n */\nexport function cacheTag(...tags: string[]): void {\n const store = getALS().getStore();\n if (!store) {\n return;\n }\n for (const tag of tags) {\n if (typeof tag === 'string' && tag.length > 0) {\n store.tags.add(tag);\n }\n }\n}\n\n/**\n * 读取当前 tag 作用域的 tag 列表(ISR 缓存中间件在响应捕获阶段调用)\n */\nexport function collectTags(): string[] {\n const store = getALS().getStore();\n return store ? Array.from(store.tags) : [];\n}\n\n/**\n * 调试:打印当前 tag store 状态\n */\nexport function debugTagStore(label = ''): void {\n const store = getALS().getStore();\n logger.debug(\n `[cacheTag] ${label} store=${store ? JSON.stringify(Array.from(store.tags)) : '<none>'}`\n );\n}\n","/**\n * A/B variant 在 Server Component 里读取的 helper —— 与 express middleware 解耦\n *\n * RSC 环境通过本文件 import(不引入 express 类型,bundle 更轻);\n * Express 中间件在 ABVariantMiddleware.ts。\n */\nimport { getRequestContext } from '../context/RequestContext';\n\n/**\n * 在 Server Component 里读取 variant\n *\n * 不在 A/B middleware 后调用 → 返回 undefined\n */\nexport function getVariant(experimentName: string): string | undefined {\n const ctx = getRequestContext();\n const v = ctx?.flags?.[experimentName];\n return typeof v === 'string' ? v : undefined;\n}\n"],"mappings":"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"}