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,33 @@
1
+ import { Ora } from 'ora';
2
+ export declare enum LogLevel {
3
+ VERBOSE = "verbose",
4
+ DEBUG = "debug",
5
+ INFO = "info",
6
+ WARN = "warn",
7
+ ERROR = "error",
8
+ SUCCESS = "success"
9
+ }
10
+ export interface LoggerOptions {
11
+ verbose?: boolean;
12
+ logFile?: string;
13
+ }
14
+ export declare class Logger {
15
+ private static instance;
16
+ private verboseMode;
17
+ private logFile;
18
+ private spinner;
19
+ static getInstance(options?: LoggerOptions): Logger;
20
+ private formatMessage;
21
+ private getLevelColor;
22
+ private writeToFile;
23
+ log(level: LogLevel, ...args: unknown[]): void;
24
+ error(...args: unknown[]): void;
25
+ warn(...args: unknown[]): void;
26
+ info(...args: unknown[]): void;
27
+ success(...args: unknown[]): void;
28
+ debug(...args: unknown[]): void;
29
+ verbose(...args: unknown[]): void;
30
+ spin(message: string): Ora;
31
+ stopSpinner(message?: string, success?: boolean): void;
32
+ }
33
+ //# sourceMappingURL=Logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAK/B,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAoB;WAErB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM;IAwB9D,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,WAAW;IAWZ,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAqBvC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIvB,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAI1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAIxB,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE;IAI1B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG;IAQ1B,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,OAAc;CAU7D"}
@@ -0,0 +1,3 @@
1
+ import { Logger } from './Logger';
2
+ export declare const logger: Logger;
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,eAAO,MAAM,MAAM,QAGjB,CAAC"}
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Vite Manifest 加载器
3
+ *
4
+ * @description 加载 Vite 构建产出的 Manifest 文件,用于生产环境 SSR 资源注入
5
+ *
6
+ * @example
7
+ * ```typescript
8
+ * const manifest = ManifestLoader.load({ rootDir: process.cwd() });
9
+ * if (manifest) {
10
+ * const assets = ManifestLoader.getEntryAssets('src/entry.tsx');
11
+ * console.log(assets.js); // '/assets/entry.a1b2c3.js'
12
+ * }
13
+ * ```
14
+ */
15
+ import type { AssetInfo, ParsedManifest, ManifestConfig } from './types';
16
+ /**
17
+ * Vite Manifest 加载器
18
+ */
19
+ export declare class ManifestLoader {
20
+ private static logger;
21
+ private static manifest;
22
+ private static publicPath;
23
+ private constructor();
24
+ /**
25
+ * 加载 Manifest
26
+ * @returns 解析后的 Manifest,失败返回 null
27
+ */
28
+ static load(config: ManifestConfig): ParsedManifest | null;
29
+ /**
30
+ * 检测 Manifest 路径
31
+ */
32
+ private static detectManifestPath;
33
+ /**
34
+ * 从路径加载 Manifest
35
+ */
36
+ private static loadFromPath;
37
+ /**
38
+ * 解析 Vite Manifest
39
+ */
40
+ private static parse;
41
+ /**
42
+ * 转换为 AssetInfo
43
+ */
44
+ private static toAssetInfo;
45
+ /**
46
+ * 收集预加载模块(包含静态与动态导入),并统一为 manifest key 风格
47
+ */
48
+ private static collectPreloadModules;
49
+ private static uniqueValues;
50
+ /**
51
+ * 标准化 manifest 路径(便于跨环境匹配)
52
+ */
53
+ private static normalizeManifestPath;
54
+ /**
55
+ * 构建匹配候选(含带/不带前导斜杠、去扩展名)
56
+ */
57
+ private static buildMatchVariants;
58
+ /**
59
+ * 在 manifest 映射中查找候选匹配 key
60
+ */
61
+ private static findModuleKeyByCandidates;
62
+ /**
63
+ * 解析依赖 key(imports)
64
+ */
65
+ private static normalizeImportId;
66
+ /**
67
+ * 规范化路径
68
+ */
69
+ private static normalizePath;
70
+ /**
71
+ * 获取已加载的 Manifest
72
+ */
73
+ static getManifest(): ParsedManifest | null;
74
+ /**
75
+ * 获取入口资源信息
76
+ */
77
+ static getEntryAssets(entryPath: string): AssetInfo | null;
78
+ /**
79
+ * 生成入口候选 key(兼容 build 产物和路径写法差异)
80
+ */
81
+ private static buildEntryCandidates;
82
+ /**
83
+ * 按候选路径解析入口资源,找不到时回退到最接近入口的 chunk
84
+ */
85
+ static resolveEntryAssets(entryPath?: string): AssetInfo | null;
86
+ /**
87
+ * 获取模块资源信息
88
+ */
89
+ static getModuleAssets(modulePath: string): AssetInfo | null;
90
+ /**
91
+ * 生成 HTML 资源标签
92
+ */
93
+ static generateHtmlTags(entryPath?: string): {
94
+ head: string;
95
+ scripts: string;
96
+ };
97
+ }
98
+ //# sourceMappingURL=ManifestLoader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ManifestLoader.d.ts","sourceRoot":"","sources":["../../src/manifest/ManifestLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAGV,SAAS,EACT,cAAc,EACd,cAAc,EACf,MAAM,SAAS,CAAC;AAoBjB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAO;IAIhC,OAAO;IAIP;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,IAAI;IAe1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAejC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAyB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK;IAgBpB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAY1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IASpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAsBxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAKhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAO5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,cAAc,GAAG,IAAI;IAI3C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAmB1D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA+BnC;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAuB/D;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAY5D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CA4C/E"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Manifest 模块
3
+ *
4
+ * @description Vite 构建 Manifest 加载,用于生产环境 SSR 资源注入
5
+ */
6
+ export { ManifestLoader } from './ManifestLoader';
7
+ export type { ParsedManifest, ManifestConfig, AssetInfo } from './types';
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/manifest/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Vite Manifest 类型定义
3
+ *
4
+ * @description Vite 构建产出的 manifest.json 结构
5
+ * @see https://vite.dev/guide/backend-integration.html
6
+ */
7
+ /**
8
+ * Vite Manifest Chunk
9
+ * @description 对应 Vite 官方 ManifestChunk 接口
10
+ * @see https://vite.dev/guide/backend-integration.html
11
+ */
12
+ export interface ManifestChunk {
13
+ /** 输入文件名(如果已知) */
14
+ src?: string;
15
+ /** 输出文件名 */
16
+ file: string;
17
+ /** 该 chunk 导入的 CSS 文件列表(仅 JS chunk) */
18
+ css?: string[];
19
+ /** 该 chunk 导入的资源文件列表,不含 CSS(仅 JS chunk) */
20
+ assets?: string[];
21
+ /** 是否为入口点 */
22
+ isEntry?: boolean;
23
+ /** chunk/资源名称(如果已知) */
24
+ name?: string;
25
+ /** 是否为动态入口点(仅 JS chunk) */
26
+ isDynamicEntry?: boolean;
27
+ /** 静态导入的 chunk 列表,值为 manifest 的 key(仅 JS chunk) */
28
+ imports?: string[];
29
+ /** 动态导入的 chunk 列表,值为 manifest 的 key(仅 JS chunk) */
30
+ dynamicImports?: string[];
31
+ }
32
+ /**
33
+ * Vite Manifest
34
+ * @description Record<name, chunk> 结构,key 为相对于项目根目录的源文件路径
35
+ */
36
+ export type ViteManifest = Record<string, ManifestChunk>;
37
+ /**
38
+ * 标准化的资源信息
39
+ */
40
+ export interface AssetInfo {
41
+ /** JavaScript 文件路径 */
42
+ js: string;
43
+ /** CSS 文件路径列表 */
44
+ css: string[];
45
+ /** 需要 modulepreload 的依赖模块 */
46
+ preloadModules: string[];
47
+ /** 静态资源列表 */
48
+ assets: string[];
49
+ /** 是否为入口文件 */
50
+ isEntry: boolean;
51
+ }
52
+ /**
53
+ * 解析后的 Manifest
54
+ */
55
+ export interface ParsedManifest {
56
+ /** Manifest 文件路径 */
57
+ filePath: string;
58
+ /** 入口模块映射 */
59
+ entries: Map<string, AssetInfo>;
60
+ /** 所有模块映射 */
61
+ modules: Map<string, AssetInfo>;
62
+ /** 原始数据 */
63
+ raw: ViteManifest;
64
+ }
65
+ /**
66
+ * Manifest 加载配置
67
+ */
68
+ export interface ManifestConfig {
69
+ /** 项目根目录 */
70
+ rootDir: string;
71
+ /** 自定义 Manifest 路径 */
72
+ manifestPath?: string;
73
+ /** 静态资源公共路径前缀 */
74
+ publicPath?: string;
75
+ }
76
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,6BAA6B;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,aAAa;IACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,WAAW;IACX,GAAG,EAAE,YAAY,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
@@ -0,0 +1,90 @@
1
+ /**
2
+ * 运行时性能指标采集器 (Singleton)
3
+ *
4
+ * 跟踪 ISR 引擎的实时性能指标:
5
+ * - 请求计数与响应时间直方图
6
+ * - 缓存命中/未命中率
7
+ * - 按渲染模式分类的统计
8
+ * - 内存使用采样
9
+ *
10
+ * @description 零依赖、无侧效果的纯内存采集器
11
+ * 可被 Prometheus exporter 消费
12
+ */
13
+ import type { RenderModeType } from '../types';
14
+ /** 单次请求记录 */
15
+ export interface RequestRecord {
16
+ url: string;
17
+ method: string;
18
+ statusCode: number;
19
+ responseTime: number;
20
+ renderMode: RenderModeType;
21
+ cacheHit: boolean;
22
+ timestamp: number;
23
+ }
24
+ /** 聚合统计快照 */
25
+ export interface MetricsSnapshot {
26
+ /** 服务启动时间 */
27
+ startedAt: number;
28
+ /** 运行时长 (ms) */
29
+ uptime: number;
30
+ /** 请求总数 */
31
+ totalRequests: number;
32
+ /** 成功请求数 (2xx) */
33
+ successRequests: number;
34
+ /** 错误请求数 (4xx/5xx) */
35
+ errorRequests: number;
36
+ /** 成功率 (0-100) */
37
+ successRate: number;
38
+ /** 平均响应时间 (ms) */
39
+ avgResponseTime: number;
40
+ /** P50 响应时间 */
41
+ p50ResponseTime: number;
42
+ /** P95 响应时间 */
43
+ p95ResponseTime: number;
44
+ /** P99 响应时间 */
45
+ p99ResponseTime: number;
46
+ /** 缓存命中率 (0-100) */
47
+ cacheHitRate: number;
48
+ /** 按渲染模式分类的请求计数 */
49
+ renderModeBreakdown: Record<string, number>;
50
+ /** 当前内存使用 (MB) */
51
+ memoryUsageMB: number;
52
+ /** 当前堆使用 (MB) */
53
+ heapUsedMB: number;
54
+ }
55
+ export declare class MetricsCollector {
56
+ private static instance;
57
+ private startedAt;
58
+ private totalRequests;
59
+ private successRequests;
60
+ private errorRequests;
61
+ private cacheHits;
62
+ private cacheMisses;
63
+ private totalResponseTime;
64
+ private renderModeBreakdown;
65
+ /** 滑动窗口:用于计算百分位 */
66
+ private recentResponseTimes;
67
+ private constructor();
68
+ static getInstance(): MetricsCollector;
69
+ /**
70
+ * 重置所有指标 (用于测试)
71
+ */
72
+ reset(): void;
73
+ /**
74
+ * 记录一次请求
75
+ */
76
+ record(record: RequestRecord): void;
77
+ /**
78
+ * 获取当前指标快照
79
+ */
80
+ getSnapshot(): MetricsSnapshot;
81
+ /**
82
+ * 计算百分位值
83
+ */
84
+ private percentile;
85
+ /**
86
+ * 返回 JSON 格式的指标 (可用于 /metrics API 端点)
87
+ */
88
+ toJSON(): MetricsSnapshot;
89
+ }
90
+ //# sourceMappingURL=MetricsCollector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MetricsCollector.d.ts","sourceRoot":"","sources":["../../src/metrics/MetricsCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,eAAe;IAC9B,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,kBAAkB;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,mBAAmB,CAA8B;IAEzD,mBAAmB;IACnB,OAAO,CAAC,mBAAmB,CAAgB;IAG3C,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IA2BnC;;OAEG;IACH,WAAW,IAAI,eAAe;IAgC9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACH,MAAM,IAAI,eAAe;CAG1B"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * PromMetrics —— prom-client 包装,导出 Prometheus 文本格式
3
+ *
4
+ * 设计:
5
+ * - prom-client 是 Node 生态的事实标准(Grafana / Datadog / Prometheus 直接抓取)
6
+ * - 单 Registry,避免污染全局;用户业务可拿 `promRegistry` 自行注册自家 metric
7
+ * - 响应时间用 Histogram(带桶),不是平均值 —— 才能正确算 P95/P99
8
+ * - 默认采集 process_*(CPU / RSS / event-loop lag)—— 一行 collectDefaultMetrics
9
+ */
10
+ import { Counter, Histogram, Gauge, Registry } from 'prom-client';
11
+ export declare const promRegistry: Registry<"text/plain; version=0.0.4; charset=utf-8">;
12
+ export declare const httpRequestsTotal: Counter<"cache" | "route" | "mode" | "method" | "status">;
13
+ export declare const httpRequestDurationSeconds: Histogram<"cache" | "route" | "mode" | "method">;
14
+ export declare const cacheEntriesGauge: Gauge<"backend">;
15
+ export declare const cacheRevalidatingGauge: Gauge<string>;
16
+ export declare const cacheHitsTotal: Counter<"status">;
17
+ export declare const invalidatorRunsTotal: Counter<"kind" | "target">;
18
+ export declare const invalidatorFailuresTotal: Counter<"kind" | "target">;
19
+ export declare const l2ReadTimeoutsTotal: Counter<string>;
20
+ export type RouteNormalizeRule = (segment: string) => string | null;
21
+ export declare function addRouteNormalizeRule(rule: RouteNormalizeRule): void;
22
+ export declare function normalizeRoute(route: string): string;
23
+ /** 一行调用更新所有计数 —— 给 isrCacheMiddleware / 中间件用 */
24
+ export declare function recordHttpRequest(opts: {
25
+ method: string;
26
+ route: string;
27
+ status: number;
28
+ mode: string;
29
+ cache: string;
30
+ durationMs: number;
31
+ }): void;
32
+ export interface PrometheusMetricsMiddlewareOptions {
33
+ /** 挂载路径;默认 `/metrics` */
34
+ path?: string;
35
+ /**
36
+ * 要求客户端提供的 Bearer token。
37
+ * 明确设 false/undefined/'' → 不做认证(仅建议用于纯内网 /k8s Pod 内暴露)。
38
+ * 生产外网挂载**强烈建议**设 token,避免指标泄露业务信息(QPS、错误分布、路由列表)。
39
+ */
40
+ token?: string | false;
41
+ /** 不通过时返回的状态码;默认 401 */
42
+ unauthorizedStatus?: number;
43
+ }
44
+ /**
45
+ * Express / connect 中间件:暴露 /metrics 端点(Prometheus text exposition format)
46
+ *
47
+ * 认证:可选 Bearer token —— 未设 token 时保持旧行为(匿名可访问)。
48
+ * 生产建议:`createPrometheusMetricsMiddleware({ token: process.env.METRICS_TOKEN })`。
49
+ */
50
+ export declare function createPrometheusMetricsMiddleware(pathOrOptions?: string | PrometheusMetricsMiddlewareOptions): (req: {
51
+ url?: string;
52
+ method?: string;
53
+ headers?: Record<string, string | string[] | undefined>;
54
+ }, res: {
55
+ setHeader(k: string, v: string): void;
56
+ end(body?: string): void;
57
+ statusCode: number;
58
+ }, next: () => void) => Promise<void>;
59
+ //# sourceMappingURL=PromMetrics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PromMetrics.d.ts","sourceRoot":"","sources":["../../src/metrics/PromMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAyB,MAAM,aAAa,CAAC;AAEzF,eAAO,MAAM,YAAY,sDAAiB,CAAC;AAM3C,eAAO,MAAM,iBAAiB,2DAK5B,CAAC;AAEH,eAAO,MAAM,0BAA0B,kDAOrC,CAAC;AAEH,eAAO,MAAM,iBAAiB,kBAK5B,CAAC;AAEH,eAAO,MAAM,sBAAsB,eAIjC,CAAC;AAEH,eAAO,MAAM,cAAc,mBAKzB,CAAC;AAYH,eAAO,MAAM,oBAAoB,4BAK/B,CAAC;AAEH,eAAO,MAAM,wBAAwB,4BAKnC,CAAC;AAKH,eAAO,MAAM,mBAAmB,iBAI9B,CAAC;AAuBH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAGpE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0BpD;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAcP;AAED,MAAM,WAAW,kCAAkC;IACjD,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,wBAAwB;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,aAAa,GAAE,MAAM,GAAG,kCAAuC,IAS7D,KAAK;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,EAC/F,KAAK;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB,EACD,MAAM,MAAM,IAAI,KACf,OAAO,CAAC,IAAI,CAAC,CAyBjB"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Metrics 模块导出
3
+ */
4
+ export { MetricsCollector } from './MetricsCollector';
5
+ export type { RequestRecord, MetricsSnapshot } from './MetricsCollector';
6
+ export { promRegistry, httpRequestsTotal, httpRequestDurationSeconds, cacheEntriesGauge, cacheRevalidatingGauge, cacheHitsTotal, recordHttpRequest, createPrometheusMetricsMiddleware, } from './PromMetrics';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,iCAAiC,GAClC,MAAM,eAAe,CAAC"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * A/B Variant Middleware —— anonId 确定性 hash 分桶(自研 ISR 原生实现)
3
+ *
4
+ * 设计原则:
5
+ * - **不再把变体编码进 cookie**(旧版每次写 cookie → Set-Cookie → ISR 缓存失效)
6
+ * - 用 RequestContext.anonId(engine 入口保证存在)做确定性 hash 分桶:
7
+ *
8
+ * variant = pickByBucket(exp.variants, exp.weights,
9
+ * fnv1a(anonId + ':' + expKey) % 10000)
10
+ *
11
+ * 同一 anonId × 同一 experiment 永远拿同一 variant,engine 升级实验也不需要
12
+ * rewrite cookie。
13
+ *
14
+ * 数据源优先级(manifest > static):
15
+ * - 如果 ManifestLoader 接上 → 从 manifest 拿 effective experiments(admin-server
16
+ * 运营 60s 内可改),manifest 拉失败时 loader 内部按 fallbackOnError 策略回退
17
+ * - 没接 manifest → 用构造时传入的 static experiments
18
+ *
19
+ * 曝光上报:
20
+ * - 如果 ExposureQueue 接上 → 算完 ctx.experiments 后 fire-and-forget push 一条
21
+ * - 没接 queue → 跳过;A/B 仅在内存里跑(本地开发 / 不需要数据时的默认)
22
+ *
23
+ * 一致性 + 缓存:ctx.experiments 由本 middleware 写入;ISR cache 把它的 stable
24
+ * digest 拼进 cache key —— 不同变体走不同 cache entry,同变体多用户共享 entry。
25
+ *
26
+ * 用法:
27
+ *
28
+ * import { createABVariantMiddleware, getVariant } from '../isr-engine';
29
+ *
30
+ * app.use(createABVariantMiddleware({
31
+ * experiments: {
32
+ * 'home-hero': { variants: ['classic', 'hero-v2'], weights: [50, 50] },
33
+ * },
34
+ * manifestLoader, // 可选:admin-server 拉取
35
+ * exposureQueue, // 可选:曝光上报
36
+ * }));
37
+ *
38
+ * // Server Component:
39
+ * import { getVariant } from '../isr-engine';
40
+ * const v = getVariant('home-hero');
41
+ *
42
+ * 注意:本 middleware **完全不写 cookie**。anonId cookie 由 engine 入口 middleware
43
+ * (createServerRequestContext + applyAnonCookie)落,跟实验配置变化解耦。
44
+ */
45
+ import type { Request, Response, NextFunction } from 'express';
46
+ import type { ExposureQueueInstance } from '../experiments/ExposureQueue';
47
+ import type { ManifestLoaderInstance } from '../experiments/ManifestLoader';
48
+ export { getVariant } from './abVariantContext';
49
+ export interface ExperimentConfig {
50
+ /** 变体列表 */
51
+ variants: readonly string[];
52
+ /** 权重(与 variants 同长;和不必为 100);不传 → 平均分 */
53
+ weights?: readonly number[];
54
+ }
55
+ export interface ABVariantOptions {
56
+ /** A/B testing 静态定义;manifestLoader 接上时仅作 fallback */
57
+ experiments: Record<string, ExperimentConfig>;
58
+ /**
59
+ * 自定义分桶逻辑(覆盖默认 fnv1a(anonId + ':' + name));如按 userId / geo / device。
60
+ * 必须是 **确定性函数**(同输入永远同输出),否则 ISR cache 会反复 MISS。
61
+ */
62
+ assigner?: (anonId: string, name: string, exp: ExperimentConfig) => string;
63
+ /**
64
+ * 实验定义动态拉取实例。接上时每请求从 loader 读 effective experiments;
65
+ * 不接则用 options.experiments 静态配置。
66
+ */
67
+ manifestLoader?: ManifestLoaderInstance | null;
68
+ /**
69
+ * 曝光上报队列实例。接上时每请求 fire-and-forget push 一条 exposure 事件。
70
+ */
71
+ exposureQueue?: ExposureQueueInstance | null;
72
+ }
73
+ export declare function createABVariantMiddleware(options: ABVariantOptions): (req: Request, _res: Response, next: NextFunction) => void;
74
+ //# sourceMappingURL=ABVariantMiddleware.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ABVariantMiddleware.d.ts","sourceRoot":"","sources":["../../src/middlewares/ABVariantMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,WAAW;IACX,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC3E;;;OAGG;IACH,cAAc,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC/C;;OAEG;IACH,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC9C;AAsCD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,IAIpC,KAAK,OAAO,EAAE,MAAM,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAmCrF"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Locale redirect 中间件 ——
3
+ *
4
+ * `runtime.i18n.prefixDefault: true` 时,根目录 / 业务路径裸 URL(无 locale 前缀)
5
+ * 一律 302 到 `/{negotiated}/path`。negotiated 来源优先级:
6
+ * 1. cookie 'locale'(用户上次切过的)
7
+ * 2. Accept-Language 头协商(RFC 4647 lookup → 命中 i18n.locales 之一)
8
+ * 3. i18n.defaultLocale
9
+ *
10
+ * 命中条件外的请求一概放行:
11
+ * - 已带 locale 前缀的 URL(/zh-CN/books 等)
12
+ * - 静态资源(含 . 的路径,比如 /favicon.ico、/_/img/abc.webp)
13
+ * - 框架内部端口 /api/*、/_rsc*、/health、/metrics、/sitemap.xml、/robots.txt
14
+ * - 非 GET / HEAD(POST 表单不走 302,否则丢 body)
15
+ *
16
+ * 这是路由层关切(locale code 怎么从 URL 解出 / 没有时怎么决议),engine 拥有
17
+ * `parseLocale` / `negotiateLocale` 的同处,redirect 跟它们一起放最合适。
18
+ */
19
+ import type { Request, Response, NextFunction } from 'express';
20
+ import type { I18nConfig } from '../runtime/i18n';
21
+ export interface CreateLocaleRedirectOptions {
22
+ i18n: I18nConfig;
23
+ /** 跳过 redirect 的额外 path 前缀(业务自有 ops 路由等) */
24
+ skipPathPrefixes?: readonly string[];
25
+ }
26
+ export declare function createLocaleRedirectMiddleware(options: CreateLocaleRedirectOptions): ((req: Request, res: Response, next: NextFunction) => void) | null;
27
+ //# sourceMappingURL=LocaleRedirect.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LocaleRedirect.d.ts","sourceRoot":"","sources":["../../src/middlewares/LocaleRedirect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA0BD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,2BAA2B,GACnC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CA2DpE"}
@@ -0,0 +1,20 @@
1
+ import { ISRContext } from '../types';
2
+ import { Middleware, NextFunction } from './types';
3
+ export declare class MiddlewareComposer {
4
+ private static instance;
5
+ private middlewares;
6
+ private logger;
7
+ static getInstance(): MiddlewareComposer;
8
+ /**
9
+ * 注册中间件
10
+ * 支持传入单个、多个或数组形式的中间件
11
+ */
12
+ use(...middlewares: (Middleware | Middleware[])[]): void;
13
+ /**
14
+ * 执行中间件链 (洋葱模型) - 高性能优化版
15
+ * @param context ISR 上下文
16
+ * @param finalHandler 最终执行的业务逻辑 (通常是渲染)
17
+ */
18
+ compose(context: ISRContext, finalHandler: NextFunction): Promise<void>;
19
+ }
20
+ //# sourceMappingURL=MiddlewareComposer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MiddlewareComposer.d.ts","sourceRoot":"","sources":["../../src/middlewares/MiddlewareComposer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGnD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqB;IAC5C,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,MAAM,CAAwB;WAExB,WAAW,IAAI,kBAAkB;IAO/C;;;OAGG;IACH,GAAG,CAAC,GAAG,WAAW,EAAE,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,EAAE;IAIjD;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY;CAmC9D"}
@@ -0,0 +1,14 @@
1
+ import { Middleware } from './types';
2
+ /**
3
+ * 性能观测中间件 —— 记录中间件链的总耗时。
4
+ *
5
+ * 产出两路信号:
6
+ * 1) `logger.info('[Performance] ...')`:开发排错用
7
+ * 2) `context.res.headers['X-Render-Ms']`:注入到响应头供前端 / 网关读取
8
+ * (例如 Browser performance.mark、Grafana Nginx 日志抓取 $upstream_http_x_render_ms)
9
+ *
10
+ * 注意:ISRContext.res.headers 是上下文级的 header 袋。能否真正走到 wire 取决于
11
+ * 上层 Express 适配把这些 header 真正 apply 到 ServerResponse。框架默认适配已做了。
12
+ */
13
+ export declare const performanceMiddleware: Middleware;
14
+ //# sourceMappingURL=PerformanceMiddleware.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"PerformanceMiddleware.d.ts","sourceRoot":"","sources":["../../src/middlewares/PerformanceMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,UAkBnC,CAAC"}
@@ -0,0 +1,24 @@
1
+ import { Middleware } from './types';
2
+ /**
3
+ * W3C trace-context (traceparent) 解析
4
+ *
5
+ * 格式:`00-<trace-id:32 hex>-<parent-id:16 hex>-<flags:2 hex>`
6
+ * 标准:https://www.w3.org/TR/trace-context/
7
+ *
8
+ * 支持版本:只接受 `00`(当前规范唯一定义的版本)。其他版本按未识别丢弃。
9
+ * 解析失败返回 null —— 调用方走生成新 ID 的路径。
10
+ */
11
+ export declare function parseTraceparent(raw: string | undefined): {
12
+ traceId: string;
13
+ parentId: string;
14
+ flags: string;
15
+ } | null;
16
+ /**
17
+ * 优先级读取 traceId:
18
+ * 1) W3C traceparent 头(业界标准,OTel/Datadog/Honeycomb 全支持)
19
+ * 2) context.data.traceId(上游框架已解析好的)
20
+ * 3) X-Request-Id(Heroku/Nginx/Kubernetes ingress 常用)
21
+ * 4) 自生成 `trace-<uuid>`(结尾兜底)
22
+ */
23
+ export declare const traceMiddleware: Middleware;
24
+ //# sourceMappingURL=TraceMiddleware.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TraceMiddleware.d.ts","sourceRoot":"","sources":["../../src/middlewares/TraceMiddleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAY7D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,UAsC7B,CAAC"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * 在 Server Component 里读取 variant
3
+ *
4
+ * 不在 A/B middleware 后调用 → 返回 undefined
5
+ */
6
+ export declare function getVariant(experimentName: string): string | undefined;
7
+ //# sourceMappingURL=abVariantContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"abVariantContext.d.ts","sourceRoot":"","sources":["../../src/middlewares/abVariantContext.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrE"}
@@ -0,0 +1,5 @@
1
+ export * from './types';
2
+ export * from './MiddlewareComposer';
3
+ export * from './TraceMiddleware';
4
+ export * from './PerformanceMiddleware';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middlewares/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { ISRContext } from '../types';
2
+ export type NextFunction = () => Promise<void>;
3
+ export type Middleware = (context: ISRContext, next: NextFunction) => Promise<void>;
4
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/middlewares/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}