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
package/CHANGELOG.md ADDED
@@ -0,0 +1,755 @@
1
+ # CHANGELOG
2
+
3
+ `@novel-isr/engine` 的版本变更记录。格式按 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),版本号按 [SemVer](https://semver.org/lang/zh-CN/)。
4
+
5
+ ---
6
+
7
+ ## [2.6.9] - 2026-09-20
8
+
9
+ ### Fixed
10
+
11
+ - **客户端 RSC 导航切语言不生效(必须刷新才换成对应语言)**:`detectLocale` 之前直接用原始
12
+ pathname 的首段匹配 locale,而客户端导航请求 URL 带 `_.rsc` 后缀(如 `/ja_.rsc`),导致首段变成
13
+ `ja_.rsc` 命中不了 locale,回退到 cookie / Accept-Language / defaultLocale,拿到的 intl 语言与 URL
14
+ 前缀不一致。现在先剥掉 `_.rsc` 后缀再检测,`/ja_.rsc` 正确命中 `ja`。
15
+
16
+ ## [2.6.8] - 2026-08-29
17
+
18
+ ### Security
19
+
20
+ - 升级依赖修复安全漏洞:`vite` 8.0.14 → 8.0.16(`server.fs.deny` bypass 等)、`sharp` ^0.33.5 → ^0.35.0。
21
+
22
+ ## [Unreleased]
23
+
24
+ ### Added
25
+
26
+ - **ISR 缓存 Host 隔离**(`runtime.hostIsolation` / middleware `hostIsolation` 选项):
27
+ 多域名打到同一 SSR 进程且按域名出不同内容(白标站 / tenant-by-domain)时,
28
+ cache key 追加 `|h=<host>`,各 host 独立缓存不串内容。默认关闭(单站点形态不受影响)。
29
+ `revalidatePath` 清除该路径所有 host 的条目。
30
+
31
+ - ISREngine 生命周期测试(此前覆盖率 0% → 97%):start 后 ops 路由可访问与 invalidator 注册、
32
+ shutdown 的 allSettled 失败聚合语义、initialize + generateSeo 产物落盘。server 层换受控实现
33
+ (真 Express + http.Server,不拉起 Vite)。
34
+ - `extractSsgRoutes` 测试(spider 87% → 96%):ssg.routes 数组 / 同步异步函数三种来源、
35
+ 回退 routes mode=ssg 提取、通配符跳过、来源优先级。
36
+
37
+ ### Fixed
38
+
39
+ - **variant 隔离条目无法被 `revalidatePath` 清除**:失效匹配此前只认精确 key 和 `?` 前缀,
40
+ 带 `|v=` 后缀的无 query 条目被漏掉(实验页面失效后继续回放旧缓存直到 TTL 过期)。
41
+ 匹配规则补上 `|` 前缀分支,对 `|v=` / `|h=` 隔离后缀一律全清。
42
+ - `prefetchCooldown` 由裸 `Map` 换成 `LRUCache`(max 1000 + ttl=冷却窗口),修复 prefetch 目标为动态路径时
43
+ 冷却记录无界累积的内存泄漏风险;`handler.clear()` / `destroy()` 同步清空该状态。
44
+
45
+ ### Removed
46
+
47
+ - 删除一次性社区发帖草稿 `docs/community-intro.md` / `docs/community-intro.en.md`(内容钉在 v2.3.1,已过期)。
48
+
49
+ ### Docs
50
+
51
+ - RFC 0002(Experiments Platform)状态 Draft → Implemented(`ManifestLoader` / `ExposureQueue` / kill switch 均已落地)。
52
+ - README 过期数据同步:测试数 551/543/609 → 718、覆盖率 ~50% → ~58%、版本亮点 v2.3.1 → v2.5.10、
53
+ 安装示例 `^2.3.0` → `^2.5.0`、plugin-rsc `^0.5.24` → `^0.5.26`。
54
+
55
+ ---
56
+
57
+ ## [2.6.7] - 2026-08-25
58
+
59
+ 发布主题:**i18n 主语言回退**。
60
+
61
+ ### Fixed
62
+
63
+ - **`negotiateLocale` 无法处理「地区码不匹配」**:此前只做完整 code 精确匹配 + 主语言精确匹配(例如
64
+ `locales: ['zh-hans','en-us','en-au']` 时,浏览器发 `en` 或 `en-GB` 会回退到 defaultLocale)。
65
+ 现在补上「主语言回退」:`en` / `en-GB` → 第一个 `en-*`(`en-us`)、`zh` / `zh-CN` → `zh-hans`。
66
+ 这样启用 `prefixDefault: true` + LocaleRedirect 后,英文浏览器不再被误判成默认语言。
67
+
68
+ ---
69
+
70
+ ## [2.6.2] - 2026-08-25
71
+
72
+ 发布主题:**Vite dev 首屏 stylesheet 资源身份根治**。
73
+
74
+ ### Fixed
75
+
76
+ - **刷新时首屏仍会短暂丢失路由样式**:Vite dev 的同一个 `.css` / `.scss` URL
77
+ 同时表示两类响应:stylesheet 请求根据 `Accept: text/css` 在服务器内部临时转为
78
+ `?direct` 并返回 CSS,JavaScript import 则返回调用 `__vite__updateStyle` 的模块。
79
+ `@vitejs/plugin-rsc@0.5.34` 此前把未带 `direct` 的普通模块 URL 直接交给 React
80
+ stylesheet resource,导致 SSR stylesheet 与 JavaScript 模块共享外部 URL 身份;
81
+ 浏览器缓存或请求调度一旦先看到模块响应,首屏只能等客户端重新注入样式后恢复。
82
+ - engine 现在在 `virtual:vite-rsc/css` 资源清单生成边界,用 AST 只规范化其中的样式
83
+ href,为所有 dev SSR stylesheet 追加 Vite 原生 `direct` 查询标记。stylesheet 从
84
+ HTML、HTTP 缓存到 Vite 模块图均拥有 CSS-only 身份,CSS module 的 JavaScript import
85
+ 仍使用原 URL;修复不依赖延迟、重试、DOM 隐藏或业务 preload。
86
+ - v2.6.1 的逐资源原子交接继续保留:SSR `link` 在对应 Vite inline style 就绪前仍不会
87
+ 被移除,分别覆盖首次绘制的资源身份和 hydration 后的样式所有权交接。
88
+
89
+ ### Tests
90
+
91
+ - 新增虚拟 RSC CSS 模块测试,覆盖无 query、已有 query、已带 `direct`、非样式资源和
92
+ 普通业务模块不受影响。
93
+ - 新增真实 Vite + plugin-rsc 开发集成测试,验证生成清单使用 `?direct`、stylesheet
94
+ 请求返回 `text/css`,而原始 CSS module URL 继续返回 `text/javascript`。
95
+ - 使用未增加业务样式代码的隔离消费者验证首页、博客、项目、关于、联系五条 SSR
96
+ 路由,所有首屏 stylesheet 均带 `direct` 且响应为 CSS。
97
+
98
+ ---
99
+
100
+ ## [2.6.1] - 2026-08-25
101
+
102
+ 发布主题:**Vite dev 样式资源原子交接**。
103
+
104
+ ### Fixed
105
+
106
+ - **刷新或首次切换路由时短暂出现无样式内容**:`@vitejs/plugin-rsc@0.5.34` 的 dev
107
+ 虚拟模块会在 hydration effect 中一次性删除所有 `vite-rsc/client-reference` SSR
108
+ stylesheet,但 Vite 对路由级 SCSS 的内联 `<style data-vite-dev-id>` 可能在后续任务才插入,
109
+ 因此两者之间存在可见的 CSSOM 空窗。engine 现在在 Vite 插件解析层接管该虚拟模块,按资源
110
+ 匹配 SSR link 与 Vite style;每个 link 只在自己的替代 style 已进入 DOM 后移除。
111
+ - 该修复仅在 `vite serve` 生效,不修改业务主题、路由或样式代码,也不 patch DOM prototype;
112
+ production 继续由 React 原生 stylesheet resource 生命周期管理。
113
+
114
+ ### Tests
115
+
116
+ - 新增 dev stylesheet 原子交接测试,覆盖已就绪与延迟就绪的路由样式,以及非
117
+ `client-reference` 全局样式不受影响。
118
+ - 新增 Vite 虚拟模块所有权测试,锁定 engine 必须先于上游批量清理实现解析该模块。
119
+
120
+ ## [2.6.0] - 2026-08-25
121
+
122
+ 发布主题:**React RSC 样式资源生命周期根治**。
123
+
124
+ ### Changed
125
+
126
+ - React、React DOM 与 React Server DOM Webpack 锁定到同一个包含上游 CSS Flight hint
127
+ 修复的精确构建 `19.3.0-canary-bd6ea412-20260824`。该构建从资源生产端直接输出
128
+ `:HL[href,"style"]`,使 preload 与 stylesheet 使用 React 同一套标准资源身份和挂起语义。
129
+
130
+ ### Removed
131
+
132
+ - 删除引擎对 Flight `HL` 私有字节协议的过滤器,纯 RSC 流现在原样交给 React 客户端。
133
+ - 删除对 `HTMLLinkElement.prototype` 和 `Element.prototype.setAttribute` 的全局 monkey patch。
134
+ - 删除 SSR HTML 的 CSS preload/Flight hint 流改写;首屏和客户端导航均由 React
135
+ 原生 stylesheet resource 处理。
136
+
137
+ ### Tests
138
+
139
+ - 新增样式资源所有权架构测试,防止重新引入 Flight 过滤或 DOM prototype patch,
140
+ 并强制 React 三件套严格同版。
141
+
142
+ ---
143
+
144
+ ## [2.5.16] - 2026-08-25
145
+
146
+ 发布主题:**dev 客户端导航样式原子提交修复**。
147
+
148
+ ### Fixed
149
+
150
+ - **Vite dev 首次路由切换仍闪现无样式 DOM**:纯 Flight CSS hint 过滤器此前用 `.css`
151
+ 后缀判断资源,遗漏 dev 使用的 `.scss` / `.less` 源码 URL 及无扩展名样式端点。现在以
152
+ Flight `HL` tuple 的 `style|stylesheet` 类型作为协议依据,生产构建与 dev 资源统一处理。
153
+ - **CSS preload 与 stylesheet 凭据模式不一致**:客户端兼容补丁此前给 preload 无条件添加
154
+ `crossorigin="anonymous"`,但 React 后续 stylesheet 未必携带该属性,Chrome 因此无法复用
155
+ preload 并发起第二次请求。现在补丁只纠正非法的 `as="stylesheet"`,完整保留调用方声明的
156
+ CORS/credentials 语义,避免新 DOM 先于第二次 CSSOM 建立而提交。
157
+
158
+ ### Tests
159
+
160
+ - 新增 dev `.scss`、无扩展名样式 URL 与 credentials mode 回归测试。
161
+
162
+ ---
163
+
164
+ ## [2.5.15] - 2026-08-25
165
+
166
+ 发布主题:**客户端 RSC 导航样式原子提交修复**。
167
+
168
+ ### Fixed
169
+
170
+ - **首次客户端路由切换短暂丢失页面样式**:React Flight 响应同时包含 CSS `:HL` resource hint
171
+ 和真实的 `<link rel="stylesheet" precedence>` resource。React 先处理 hint 后会把资源标记为已插入,
172
+ 导致后续 stylesheet resource 不再挂起 transition,新路由 DOM 可能在 CSS 下载完成前提交。现在纯
173
+ `_.rsc` 响应以字节安全的流式状态机移除 CSS hint,保留真实 stylesheet resource,让 React 等待路由
174
+ CSS 加载完成后再提交页面;dev 与 production 的首次路由切换行为一致。
175
+ - 初始 SSR HTML 的 Flight CSS hint 去重支持 React 19 实际使用的无 row-id `:HL[...]` wire format,
176
+ 同时保留旧的 `<hex>:HL[...]` 兼容形式。
177
+
178
+ ### Tests
179
+
180
+ - 新增纯 Flight 流回归测试,覆盖所有 chunk 切分位置、非 CSS hint 保留、真实 stylesheet resource
181
+ 保留,以及二进制 payload 逐字节透传。
182
+
183
+ ---
184
+
185
+ ## [2.5.14] - 2026-08-24
186
+
187
+ 发布主题:**CLI 服务监听配置优先级修复**。
188
+
189
+ ### Fixed
190
+
191
+ - **`novel-isr dev/start` 无条件覆盖 `ssr.config.ts` 的监听端口**:Commander 此前把 `3000`
192
+ 作为 `--port` 的默认参数,即使调用方没有传 CLI flag,也会在加载配置后覆盖
193
+ `server.port`(包括业务通过 `PORT` 环境变量解析出的端口)。现在 dev/start 仅在显式传入
194
+ `--port` / `--host` 时覆盖配置;新增命令参数回归测试,覆盖无参数与显式覆盖两种路径。
195
+
196
+ ---
197
+
198
+ ## [2.5.13] - 2026-08-24
199
+
200
+ 发布主题:**开发服务器 Vite 配置单次加载**。
201
+
202
+ ### Fixed
203
+
204
+ - **开发模式重复注册 Vite / RSC / ISR 插件**:`createViteDevServer()` 已显式调用
205
+ `loadConfigFromFile()` 并合并业务配置,但随后调用 `createServer()` 时没有关闭 Vite 的配置文件自动发现,
206
+ 导致同一 `vite.config` 被再次加载,插件初始化、缓存写入和中间件注册执行两遍。
207
+ 修复后传入 `configFile: false`,明确由引擎完成唯一一次配置加载;新增回归测试锁定该调用契约。
208
+
209
+ ---
210
+
211
+ ## [2.5.12] - 2026-08-23
212
+
213
+ 发布主题:**配置加载兼容 Node 22.18+/24 原生 type-stripping**。
214
+
215
+ ### Fixed
216
+
217
+ - **`loadConfig` 无法加载 import 了 `@novel-isr/engine/runtime` 的 `ssr.config.ts`**:
218
+ 引擎的 `./runtime` 导出指向 `src/runtime/*.ts` 源码(要留给业务侧 RSC 打包器处理),
219
+ 而配置加载用 esbuild `packages:'external'` 编译,会把这条 import 以 external 形式残留在
220
+ 临时 `.mjs` 里。Node 22.18+/24 原生 type-stripping 拒绝剥离 `node_modules` 下的 `.ts`
221
+ (`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`),导致全新环境(无 `.isr-cache`)首次 build/start 直接挂。
222
+ 修复:esbuild 编译配置时把第三方依赖保持 external,但 `@novel-isr/engine` 打进产物(esbuild 转译其
223
+ TS + tree-shake,只带入真正用到的纯函数)。新增回归测试覆盖「配置 import `@novel-isr/engine/runtime`」。
224
+
225
+ ---
226
+
227
+ ## [2.5.11] - 2026-08-23
228
+
229
+ 发布主题:**生产 SSR 非首页 CSS 资源路径修复**。
230
+
231
+ ### Fixed
232
+
233
+ - **生产 SSR 非首页样式失效(`/src/*.scss` 源码路径泄漏)**:`@vitejs/plugin-rsc` 升级
234
+ `^0.5.26 → ^0.5.34`,修复 SCSS 模块未被 hash 化到 `serverResources` manifest、导致 SSR
235
+ `<head>` 输出 `<link rel="stylesheet" href="/src/styles/global.scss">` / `/src/pages/*.module.scss`
236
+ 这类源码路径的问题(生产环境该路径返回 text/html 的 SPA 壳而非 CSS)。升级后 manifest 正确映射到
237
+ `/assets/*.css`,非首页(`/about`、`/articles`、`/case-studies`、`/contact` 等)样式正常加载。
238
+
239
+ ---
240
+
241
+ ## [2.5.10] - 2026-05-29
242
+
243
+ 发布主题:**browser telemetry 上传退避保护**。
244
+
245
+ ### Fixed
246
+
247
+ - 修复浏览器端 analytics / error-reporting endpoint 临时断连时,固定 flush interval 和 retry timer
248
+ 叠加导致同一批 payload 重复并发上传的问题。
249
+ - 上传队列现在保证同一 endpoint 同时只有一个普通 flush;失败期间只由退避 retry 驱动,成功后再继续排空已达到
250
+ `batchSize` 的后续队列。
251
+
252
+ ### Added
253
+
254
+ - 增加 browser observability 单测,覆盖 retry pending 期间 interval 不刷屏的行为。
255
+
256
+ ---
257
+
258
+ ## [2.5.9] - 2026-05-16
259
+
260
+ 发布主题:**LCP element render delay 修复 —— scoped-by-route CSS blocking 注入**。
261
+
262
+ ### Changed
263
+
264
+ - `defaults/runtime/standardize-preload-hints.ts` SSR HTML stream rewriter 升级行为:
265
+ 把 plugin-rsc 为动态 import 路由 chunk emit 的 `<link rel="preload" as="stylesheet|style" href="*.css">`
266
+ 直接改写成 `<link rel="stylesheet" data-precedence="vite-rsc/importer-resources" ...>`。
267
+ 让本路由 CSS 在初始渲染就 blocking 加载,消除 Lighthouse "Element render delay" 5+ 秒。
268
+ - 天然 scoped-by-route:plugin-rsc 只为本次渲染用到的 chunk emit 这些 preload,engine 不需要业务暴露
269
+ 路由 → 模块映射,也不会带上跨路由 CSS。100% engine-internal。
270
+ - `data-precedence` 跟 plugin-rsc 自己 emit 的 `<link rel=stylesheet precedence>` 对齐,React 19 hydrate
271
+ 时按 href + precedence dedupe,不会重复插入 link。
272
+
273
+ ### Removed
274
+
275
+ - `defaults/entry.server.ssr.tsx` 正常 SSR 路径不再调用 `collectAllCss()` 全量注入所有 manifest CSS。
276
+ csr-shell fallback 路径保留(兜底时不知道走哪条路由,全量是合理 fallback)。
277
+
278
+ ### Added
279
+
280
+ - `defaults/runtime/__tests__/standardize-preload-hints.test.ts` 单测覆盖 rewriter:
281
+ CSS preload 升级 / 非 CSS preload 透传 / 跨 chunk 边界 / 属性顺序兼容 / FLIGHT_DATA hint 改写。
282
+
283
+ ---
284
+
285
+ ## [2.5.2] - 2026-05-16
286
+
287
+ 发布主题:**static asset cache header 优化(Lighthouse "efficient cache lifetimes")**。
288
+
289
+ ### Changed
290
+
291
+ - `cli/start.ts` express.static `setHeaders` 加分支:图片 / 字体 / 图标(jpe?g/png/webp/avif/gif/svg/ico/woff2?)从默认 1h 提升到 1 周 (`max-age=604800`) + `stale-while-revalidate=86400`。修 Lighthouse "Use efficient cache lifetimes" 警告。
292
+ - `/assets/*`(hash 命名构建产物)维持 1 年 immutable;`.html` 维持 1h;其他文件维持 1h 默认。
293
+
294
+ ---
295
+
296
+ ## [2.5.1] - 2026-05-15
297
+
298
+ 发布主题:**docs 加 NODE_ENV 禁忌警告**。零 API / 零行为改动,仅文档防回归。
299
+
300
+ ### Docs
301
+
302
+ - `README.md` 顶部 + `docs/deployment.md` / `docs/getting-started.md` / `docs/observability.md` 各加 callout:⚠️ **绝不要把 NODE_ENV 写进 `.env` 文件**。
303
+ - 起因:Vite 8 严格按 `.env` 锁 `VITE_USER_NODE_ENV`,让 `vite build` 即使 production 模式也回退 development,esbuild 用 `jsxDev: true`,但 React 19 生产 `react-server` runtime 的 `jsxDEV` 是 `void 0` → SSG 全部预渲染崩。文档之前没明示这个反模式,业务侧容易踩。
304
+ - `docs/deployment.md` 的 `NODE_ENV` 行从「自动」改成显式说明各 launch path(K8s ConfigMap / Docker ENV / `pnpm start` 前缀),并新增「NODE_ENV 禁忌」专门 section。
305
+ - `docs/getting-started.md` 的 `package.json` 示例 `start` 加上 `NODE_ENV=production` 前缀,让读者直接复制就是正确姿势。
306
+
307
+ ---
308
+
309
+ ## [2.5.0] - 2026-05-15
310
+
311
+ 发布主题:**ISR 缓存可观测性 + 错误兜底 UX**。回应「能不能看到哪些页面在用过期缓存」「STALE 时上游是不是挂了」「OOM / SSR 兜底失败时用户看到什么」三个生产排错痛点。
312
+
313
+ ### Added — ISR 缓存可观测性
314
+
315
+ - **`X-Cache-Stale-Reason` 响应头** —— STALE 拆成 `swr-fresh` / `swr-bg-pending` / `swr-bg-failed-recent` 三态,让 SRE 区分「正常 SWR 流量」vs「上游持续故障,用户在持续看旧数据」。
316
+ - **`isr_invalidator_runs_total{kind,target}` / `isr_invalidator_failures_total{kind,target}`** —— 失效指标加 `target` label(path 走 `normalizeRoute` 归一化防基数爆炸,tag 原样保留),Grafana 能定位到具体业务对象。
317
+ - **`isr_l2_read_timeouts_total` counter** —— L2(Redis)读超时被降级为 miss 的次数,区分「真 miss」vs「Redis 抖动」。
318
+ - **`/__isr/cache/inventory` admin 端点** —— 库存视角,回答 Prometheus 答不了的问题:
319
+ - 「**现在这一刻**缓存里有什么、哪些已 stale 但没人请求」
320
+ - 「`/books/123` 上次什么时候被 revalidate」
321
+ - hybrid 模式下同时返回 L1 (in-process LRU) + L2 (Redis SCAN) 视图,`onlyInL2` 字段标注「在 Redis 但不在本 pod L1」
322
+ - 查询参数:`?status=fresh|stale|expired&limit=N&l2=true|false&l2Limit=N`
323
+ - dev 默认 public 开放;prod 默认上线 + 强制 `server.ops.authToken`,没配 token 时 opsConfig 自动 disable + 出 warning(行为同 `/metrics`)
324
+ - L2 走 Redis SCAN 非阻塞游标 + 总量上限保护(默认 200,硬上限 500),不会卡集群
325
+
326
+ ### Added — 错误兜底体验
327
+
328
+ - **静态 HTML 500 兜底页** —— 替代原 `text/plain "500 Internal Server Error"`。最坏情况(rscHandler 抛 + csr-shell 兜底也失败)时返回带品牌的 HTML 页面 + 可复制的 traceId。零依赖纯字符串模板,主进程 OOM 兜底也不会再失败。
329
+
330
+ ### Changed
331
+
332
+ - `ISRConfig.server.ops` 增加必填字段 `inventory: { enabled, public }`。dev 默认 `{enabled: true, public: true}`,prod 默认 `{enabled: true, public: false}`。升级业务需在 `ssr.config.ts` 加这一行。
333
+ - `ICacheAdapter` 接口新增必需方法 `inspect(limit)`,自定义 cache adapter 实现需补这个方法(MemoryCacheAdapter / RedisCacheAdapter 已实现)。
334
+
335
+ ---
336
+
337
+ ## [2.3.1] - 2026-04-29
338
+
339
+ 发布主题:**消费侧首跑 0 配置 / Express 5 / 入口架构清理**。修复一个会导致消费方
340
+ `pnpm dev` 直接报 React 默认导出错误的兼容缺陷,并把历史「虚拟入口 alias 到源 .tsx」
341
+ 导致的依赖发现盲区在 engine 内部消化掉,业务侧 `vite.config.ts` 不再需要任何兜底配置。
342
+
343
+ ### Fixed — 关键修复
344
+
345
+ - **消费方 `pnpm dev` 立刻报 `does not provide an export named 'default' / 'jsxDEV'`** ——
346
+ engine 自带的 client / runtime 源文件原先用 `import React from 'react'`,
347
+ 叠加 `optimizeDeps.exclude + alias 到源 .tsx + file:// URL` 的虚拟入口
348
+ 让 Vite scanner 不跟到 React 等 CJS 包,浏览器最终拿到原始 CJS 模块崩溃。
349
+ 统一改为 `import * as React from 'react'`,并在 `createIsrPlugin()` 内自动
350
+ 注入 `optimizeDeps.include = ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime',
351
+ 'react-dom', 'react-dom/client']`。业务侧零修改即可跑起来。
352
+
353
+ ### Changed — 重构
354
+
355
+ - **express 升级到 5.1**。删除 `pnpm.overrides` 对 `path-to-regexp@<0.1.13`
356
+ 的强制锁定 —— express 5 内置 path-to-regexp 6.x,不再受 4.x 解析到 8.x
357
+ 的 `pathRegexp is not a function` 兼容坑影响。父目录 `pnpm ls -r`
358
+ 不再触发误报警告。
359
+ - **engine 子路径 exports 部分迁移到 `dist/`**:`./auto-observability` /
360
+ `./site-hooks` 现在指向 `dist/.../*.js`(普通 ESM JS),消费方 Vite scanner
361
+ 能正常发现传递依赖。这两个文件无 `'use client'` 指令、无 `@vitejs/plugin-rsc`
362
+ 虚拟模块依赖,可安全预打包。
363
+ - **保留为源码的子路径**:`./client-entry` `./server-entry` `./runtime` 必须
364
+ 维持 `.tsx`/`.ts` 源 —— 它们要么依赖 `@vitejs/plugin-rsc/browser`、`/rsc`、
365
+ `import.meta.viteRsc` 等只能在消费方 plugin-rsc 构建上下文里解析的虚拟模块;
366
+ 要么内部混合了带 `'use client'` 指令的多个模块,bundle 后 Rollup 会丢失模块级
367
+ 指令导致 plugin-rsc 无法识别客户端边界。CHANGELOG 在此明确边界,不再随意揉合。
368
+
369
+ ### Added — 工程
370
+
371
+ - `package.json` 新增 `files` 字段,明确列出 npm publish 应包含的 `dist`、
372
+ `src/defaults`、`src/runtime`、`README.md`、`CHANGELOG.md`。`dist` 维持
373
+ `.gitignore`,由 `prepare` 脚本在 install / publish 前生成。
374
+
375
+ ### Migration — 升级指引
376
+
377
+ 如果你为了绕过 React 默认导出报错在 `vite.config.ts` 加过:
378
+
379
+ ```ts
380
+ optimizeDeps: {
381
+ include: ['react', 'react/jsx-runtime', 'react/jsx-dev-runtime', ...],
382
+ }
383
+ ```
384
+
385
+ **现在可以删除**。engine 自动注入。
386
+
387
+ 如果你为了 path-to-regexp 兼容性在 `package.json` 加过 `pnpm.overrides`,
388
+ 也可以删除 —— express 5 已经原生兼容。
389
+
390
+ ---
391
+
392
+ ## [2.2.0] - 2026-04-28
393
+
394
+ 发布主题:**ISR 缓存层 5 项性能 / 内存 / 运维优化**。所有改动**完全向后兼容**(新选项默认值即旧行为或安全保守值,零破坏性变更)。
395
+
396
+ ### Added — 新功能 / API
397
+
398
+ #### 缓存 key 版本化命名空间(无 SCAN 整体失效)
399
+
400
+ ```typescript
401
+ IsrCacheMiddlewareOptions.cacheNamespace // default 'default'
402
+ // 也可通过 ISR_CACHE_NAMESPACE env 覆盖
403
+ ```
404
+
405
+ bump `cacheNamespace` 即让旧 key 不再被读到,按 TTL 自然回收,**不需要 Redis SCAN/FLUSH**。
406
+ 所有 cache key 形如 `<ENGINE_VERSION>:<namespace>:<原始 key>`,例 `e1:default:GET:/book/1`。
407
+
408
+ #### MISS 回源 single-flight(thundering herd 保护)
409
+
410
+ ```typescript
411
+ IsrCacheMiddlewareOptions.singleflightWaitMs // default 5000ms; 0 关闭
412
+ ```
413
+
414
+ N 个并发 MISS 同 key 时,第 1 个触发渲染并锁住 key,其余 N-1 个等待该渲染完成后**重读 cache HIT 回放**。
415
+ 等待超时则 follower 退化为各自走 MISS(fail-open,避免首请求异常导致全部 follower 永久卡死)。
416
+ 缓存击穿瞬间 N 次回源压缩为 1 次。
417
+
418
+ #### Capture buffer 字节上限(OOM 防御)
419
+
420
+ ```typescript
421
+ IsrCacheMiddlewareOptions.maxCachedBodyBytes // default 5 * 1024 * 1024 (5 MB); 0 关闭
422
+ ```
423
+
424
+ 渲染响应累计字节超阈值时**立刻丢弃捕获缓冲并跳过本次入缓存**,已发往 client 的字节不受影响。
425
+ 防御场景:未分页大列表、上游 API 一次性巨大响应、并发 MISS 多份巨响应叠加 OOM。
426
+
427
+ #### Edge response prefetch on HIT(相关路径预热)
428
+
429
+ ```typescript
430
+ IsrCacheMiddlewareOptions.prefetchOnHit // (ctx: { path, cacheKey }) => string[] | Promise<string[]>
431
+ IsrCacheMiddlewareOptions.prefetchCooldownMs // default 30_000ms
432
+ ```
433
+
434
+ HIT 命中响应正常发回 client 后,**异步、非阻塞**地对相关路径发起内部 HTTP 预热请求。
435
+ 防自激:sentinel header `X-ISR-Prefetch: 1`;防风暴:同目标 cooldown 窗口内只触发一次。
436
+
437
+ 示例:
438
+
439
+ ```typescript
440
+ prefetchOnHit: ({ path }) => {
441
+ const m = path.match(/^\/book\/(\w+)$/);
442
+ return m ? [`/book/${m[1]}/reviews`, `/book/${m[1]}/related`] : [];
443
+ }
444
+ ```
445
+
446
+ #### CPU-aware prerender 默认并发
447
+
448
+ ```typescript
449
+ SpiderOptions.concurrency // default min(8, max(2, cpus/2))
450
+ // 也可通过 ISR_SSG_CONCURRENCY env 覆盖
451
+ ```
452
+
453
+ 之前默认 3 是写死常量。在多核 CI 机上跑 1000 路由 build 时间砍 ~50%。
454
+
455
+ ### Changed
456
+
457
+ - `IsrCachedEntry` cache key 全部携带 `<ENGINE_VERSION>:<namespace>:` 前缀。
458
+ **影响**:手工预 seed cache 的测试要更新 key 格式(升级前 `'GET:/x'` → 升级后 `'e1:default:GET:/x'`)。
459
+ 生产部署不受影响:bump 到 v2.2 后第一次 MISS 自然按新格式落 key;旧 key 按 Redis TTL 过期。
460
+ - `package.json` 显式标记内部包(`license: UNLICENSED`、`repository` 指向内部 git)。
461
+
462
+ ### Removed —— 公开 API 瘦身("不造假概念"原则)
463
+
464
+ 清理一批存在于类型 / 文档 / 示例 / CLI 但实际 engine 不消费、或实现是戏剧的功能。
465
+
466
+ **HTTP/2 / HTTP/3 origin 支持**:QUIC 加载逻辑动态尝试三个非依赖包(`@aspect-build/quic` /
467
+ `quic` / `@fails-components/webtransport`),实际 100% 走 catch 兜底。HTTP/2 真实工作但
468
+ production 推荐 CDN 终结。Origin 协议收窄到 `'http1.1' | 'https'`,删除 `server.http2` /
469
+ `server.http3` 配置块、`startHttp2Server` / `startHttp3Server` / 全部 QUIC 加载与
470
+ Alt-Svc / Early Hints 中间件(≈400 行)。
471
+
472
+ **`ISRConfig` 死字段**:`appName` / `apiUrl` / `entry` / `dev` / `tenants` / `sandbox` /
473
+ `isr.backgroundRevalidation` —— src/ 里 0 处读取,纯许愿单。
474
+
475
+ **`auditLog` / `redactPii`**:原内置 PII redaction 与审计日志中间件删除(业务用 SiteHooks
476
+ `onError` + 自家 logger 更直接,engine 没必要替每个项目预设合规策略)。
477
+
478
+ **`cli/migrate`**:Next.js 检测 / Vite 配置生成的迁移命令(257 行)。通用框架不需要 Next.js 专属迁移器。
479
+
480
+ **`virtual-modules` / `./cli` 子路径 export**:前者实现已破,后者与主 entry 重复。
481
+
482
+ **package.json scripts**:`prepublishOnly` / `release:dry` / `release:pack` / `release:beta` /
483
+ `release:from-ci` / `test:watch` / `test:coverage` / `format:check` / `bench:compare` —— 9 个无人调用或冗余
484
+ 脚本。`pnpm check` 现在是 `type-check + lint + test`,发布走 `release.yml` 4 段 gate。
485
+
486
+ ### Changed —— 包结构精简(npm tarball 130 entry / 548KB)
487
+
488
+ **Dep 分类调整**:
489
+ - `vite` / `react-server-dom-webpack` / `rsc-html-stream` 从 `dependencies` 移到 `peerDependencies`
490
+ - 新增 `react` / `react-dom` 为 `peerDependencies`(`./server-entry` / `./client-entry` /
491
+ `./runtime` 等 raw subpath export 直接 import 这些包,consumer 必须自带)
492
+ - README + getting-started.md 安装命令同步加上 `react-server-dom-webpack` / `rsc-html-stream`,
493
+ `examples/hello-world/package.json` 也补齐这两条 dep(严格 pnpm 模式下不能依赖 hoist)
494
+
495
+ **npm tarball 内容收敛**:
496
+ - 删 `package.json` `files` allowlist,改为 `.npmignore` deny-list(更精确:能挡掉 `__tests__`、IDE 配置、内部源码目录等)
497
+ - tarball 现仅含:`dist/` + `src/defaults/` + `src/runtime/` + `README.md` + `CHANGELOG.md`
498
+ - 不再 ship:`src/{adapters,cache,cli,config,context,discovery,engine,isr,logger,manifest,metrics,middlewares,plugin,renderer,route,rsc,server,ssg,types,utils}` —— 这些目录的代码已编译进 dist/ bundle
499
+ - 不再 ship:`__tests__/` / `.vscode/` / `tsconfig.json` / `vite.config.ts` / `.npmrc.example` 等开发期文件
500
+
501
+ **内部模块归位**:
502
+ - `src/engine/data/createCachedFetcher.ts` → `src/defaults/runtime/createCachedFetcher.ts`(被 raw-shipped 的 `defineSiteHooks` 直接消费,应放 raw 树)
503
+ - `src/adapters/observability/auto.ts` → `src/defaults/auto-observability.ts`(仅被 engine 内部 entry.server.tsx 消费,不在 `./adapters/observability` 公开 export 之内)
504
+ - 这两次重定位让 raw-shipped 树(`src/defaults` / `src/runtime`)零跨树 import,是 tarball 收敛的前提
505
+
506
+ ### Removed —— Dead exports
507
+
508
+ `src/config/defaults.ts` 删除 `DEFAULT_APP_NAME` / `DEFAULT_ENTRY_FALLBACK`(无人引用,原配套已删的 `appName` / `entry` 配置字段)。
509
+ `src/types/index.ts` 删除 `NovelISRConfig` / `NovelSSRConfig` 兼容别名(无人消费)+ 指向已删的 `virtual-modules.d.ts` 的死注释。
510
+
511
+ ### Fixed
512
+
513
+ **examples/hello-world/src/app.tsx** —— `export default function App` ⇒ `export function App`
514
+ (engine 走 named import `import { App } from '@app/_entry'`,原先用户照抄示例会撞 "App is undefined")。
515
+
516
+ **examples/hello-world/vite.config.ts** —— 注释错列 `@vitejs/plugin-react` 为 createIsrPlugin 内置依赖,与 `getting-started.md` 自家警告冲突。改写。
517
+
518
+ **examples/hello-world/README.md** —— 演示"4 条渲染路径"含 `pnpm fallback` 输出 `dist/spa/`,但本示例 vite.config 不构建独立 SPA bundle、`fallback` 是 runtime 代理不是 build 步骤。改写为"3 种用户级渲染模式"。
519
+
520
+ **bench/app/README.md** —— 多处过期路径(旧 bench 脚本 → `bench/app`)+ 不存在的"挂上 rateLimit / experiments"声明 + 引用已删 root `ssr.config.example.ts`。重写。
521
+
522
+ **bench/app/package.json** —— 删未使用的 `@vitejs/plugin-react` 死依赖。
523
+
524
+ ### Performance
525
+
526
+ - v2.2 vs v2.1 实测(1000 并发 / 单进程 / 同硬件,对比 main page ISR HIT/MISS):
527
+ - 缓存击穿瞬间 backend 调用:`100 → 1`(single-flight)
528
+ - 大列表页响应内存峰值:`50MB × N → 5MB cap`(buffer overflow protection)
529
+ - prerender 1000 路由墙钟时间:`67s → 22s`(CPU-aware concurrency)
530
+ - 详细数据见 `bench/baseline.json` v2.2 段
531
+
532
+ ### Tests
533
+
534
+ - 543 测试全过(38 文件)。从 v2.1 的 580 → v2.2 的 543:删除 `cli/migrate` / `auditLog` /
535
+ `redactPii` / `virtual-modules` 等模块时连带移除其测试(约 -40),新增 5 个覆盖
536
+ ISR 缓存层优化路径,`createCachedFetcher` 测试随源码迁到 `src/defaults/runtime/__tests__/`。
537
+ - 1 个测试调整:`bg revalidate 安全超时` 测试的预 seed key 从 `'GET:/stale-test'` → `'e1:default:GET:/stale-test'`。
538
+ - vitest exclude 从 blanket `src/defaults/**` 收窄到具体的 plugin-rsc 依赖文件(5 个 entry wrapper),其余 `src/defaults/runtime/` 的纯单测正常跑。
539
+ - Lint warnings:20 → 0。`RedisCacheAdapter.ts` 的 12 个 `this.redis!` 是 `connect/destroy` 生命周期不变量,
540
+ TS 无法跨 if-return 推断;本文件加 `eslint-disable @typescript-eslint/no-non-null-assertion`
541
+ + 顶部注释解释原因,不再作为 lint noise 干扰其他文件的真实警告。其他 7 个 NNA 通过类型缩窄改写消除。
542
+
543
+ ---
544
+
545
+ ## [2.1.0] - 2026-04-26
546
+
547
+ 发布主题:**Security & Reliability 硬化 + 测试回归网 +145% + bench/release 流水线**。
548
+ 所有改动**完全向后兼容**(新选项默认关闭或沿用旧行为,零破坏性变更)。
549
+
550
+ ### Added — 新功能 / API
551
+
552
+ #### 安全 / 可靠性配置(opt-in)
553
+
554
+ ```typescript
555
+ // isrCacheMiddleware
556
+ IsrCacheMiddlewareOptions.l2ReadTimeoutMs // default 100ms
557
+ IsrCacheMiddlewareOptions.backgroundRevalidateTimeoutMs // default 30_000ms
558
+ IsrCacheMiddlewareOptions.variantIsolation // default false
559
+ IsrCacheMiddlewareOptions.variantCookieName // default 'ab'
560
+
561
+ // RedisInvalidationBus
562
+ RedisInvalidationBusConfig.replayWindowMs // default 5min
563
+ RedisInvalidationBusConfig.replayLogMaxEntries // default 5000
564
+
565
+ // RateLimiter
566
+ export { extractClientIp, RedisLikeClient }
567
+ RateLimitOptions.trustProxy // default false
568
+
569
+ // TraceMiddleware
570
+ export { parseTraceparent } // W3C trace-context spec parser
571
+
572
+ // PromMetrics
573
+ export { normalizeRoute, addRouteNormalizeRule }
574
+ createPrometheusMetricsMiddleware({ token, path, unauthorizedStatus })
575
+
576
+ // Edge adapters
577
+ export { CloudflareEdgeContext, toVercelMiddleware, VercelMiddlewareOptions }
578
+
579
+ // ISREngine + start.ts
580
+ export { normalizeEngineConfig } // 纯函数,方便单测
581
+ export { extractRoutesForSitemap, nodeToWebRequest, pipeWebResponse } // start.ts helpers
582
+ ```
583
+
584
+ #### Bench 流水线
585
+
586
+ - `bench/app/` —— self-contained 最小 ISR 应用,覆盖 ISR / SSG / 动态 ISR / SSR
587
+ 四种渲染路径。CI 不再依赖 sibling 业务 repo
588
+ - `bench/utils.mjs` —— 抽出可单测的 `extractP95` + `sleep` helpers
589
+ - `bench/baseline.json` —— 10/100/1000 conn × 3 paths 的代表性 baseline
590
+ - `BENCH_DISABLE_RATE_LIMIT=1` —— bench 专用 env,每请求动态读取 `process.env`,
591
+ 绕过 RateLimiter(autocannon 单 IP 高并发需要)
592
+ - bench.mjs 增强:preflight + per-path warmup + non-2xx% +
593
+ CI gates (`BENCH_P95_BUDGET_MS` / `BENCH_QPS_FLOOR` / `BENCH_FAIL_ON_NON_2XX`)
594
+
595
+ #### CI/CD
596
+
597
+ - **`.github/workflows/release.yml`** —— `v*.*.*` tag push 触发的发布流水线,
598
+ 4 个串行 gate(lint+type+format / tests / build+verify dist / bench vs baseline),
599
+ 全过 → `pnpm publish --access restricted` 到私有 npm registry。
600
+ 退化 P95 > +20% 或 QPS < -15% 自动 block publish。
601
+ - **`.github/workflows/ci.yml`** 触发器扩到 `branches: ['**']`(feature 分支也跑 lint/test)
602
+ - **`.github/workflows/bench.yml`** 用 self-contained bench app 替代 sibling 依赖
603
+
604
+ ### Changed — 行为修改(所有都是无感升级)
605
+
606
+ #### 🔴 高危修复
607
+
608
+ - **`isrCacheMiddleware`:Set-Cookie 响应不入缓存**。旧行为含 `Set-Cookie` 的 RSC
609
+ 响应会被 LRU 缓存,第二个用户 HIT 时 replay 别人的 session cookie → **跨账号
610
+ 会话泄露**。现在捕获期检测到 Set-Cookie(数组或非空字符串)即跳过 `store.set`。
611
+ - **`isrCacheMiddleware`:query 参数归一化**。`?a=1&b=2` 与 `?b=2&a=1` 现在共享
612
+ 同一 cacheKey(按字母序排序 + `encodeURIComponent` 重编),消除碎片化。
613
+ - **`ssg/spider`:路径穿越防护**。`routeToFilePath` 新增白名单(`[A-Za-z0-9\-._~%/]+`)
614
+ + 段级检查(拒绝 `..` / `.` / 空段 / 反斜杠 / NUL / Unicode 非 URL 字符)+
615
+ 写盘前 `absOut.startsWith(absDir)` 二道闸。恶意 `/../etc/passwd` 不会逃出 dist。
616
+ - **`cache/RedisCacheAdapter`:Buffer 序列化保真**。旧实现 `JSON.stringify(Buffer)`
617
+ 输出 `{type:"Buffer",data:[...]}`,反序列化后 `Buffer.isBuffer()=false` →
618
+ 图片 / 签名 blob 全坏。新增 `__isr_buf_b64__` tag 的 `encodeBuffers/decodeBuffers`
619
+ 递归(支持嵌套对象 / `Uint8Array` / 循环引用 WeakSet)。
620
+ - **`cache/RedisCacheAdapter`:pipeline 错误不再被吞**。`pipeline.exec()` 返回的
621
+ `[[err, reply], ...]` 用 `assertPipelineOk()` 扫描,任一失败 → 抛聚合错误 →
622
+ 触发 fallback 或(未启用 fallback)打 error log 让监控感知。
623
+ - **`metrics/PromMetrics`:路由归一化防 label 爆炸**。`/books/123` / `/books/124`
624
+ 不再各占一条 time series,`normalizeRoute()` 把纯数字段 → `:id`、UUID → `:uuid`、
625
+ 长 hex / base64url 长串 → `:hash`。可用 `addRouteNormalizeRule()` 扩展。
626
+ - **`metrics/PromMetrics`:`/metrics` 可选 Bearer token 认证**。新签名
627
+ `({ token: process.env.METRICS_TOKEN })` 生效后非法访问返 401。
628
+
629
+ #### 🟡 中危修复
630
+
631
+ - **`isrCacheMiddleware`:A/B variant 隔离(opt-in)**。`variantIsolation: true`
632
+ 时 cacheKey 追加 FNV-1a 摘要的 variant cookie。默认 false。
633
+ - **`isrCacheMiddleware`:L2 读超时 + bg safety timer**。Redis 抖动不再拖慢
634
+ HIT/STALE,bg 请求 hang 不再永久占用 `revalidating` Set。
635
+ - **`ssg/spider`:重试 full jitter**。3 次指数退避改成 `random(0, base * 2^(n-1))`,
636
+ 大规模 SSG 同步 flake 时不再 thundering herd。
637
+ - **`cache/RedisInvalidationBus`:Sorted Set 消息重放**。Pub/Sub fire-and-forget
638
+ 在 subscriber 瞬断时消息会丢失;现在 publish 同时 ZADD 到 `<channel>:log`,
639
+ subscriber `ready` 事件触发 `ZRANGEBYSCORE (lastSeen, now]` 补拉。
640
+ - **`middlewares/RateLimiter`:`trustProxy` 真实 IP 提取**。CF-Connecting-IP >
641
+ X-Real-IP > X-Forwarded-For(最左)> `req.ip` 优先级。
642
+ - **`middlewares/RateLimiter`:Redis 后端改 Lua 脚本**。`INCR + PEXPIRE NX + PTTL`
643
+ 从 3 RTT → 1 RTT(`EVAL + EVALSHA`)。
644
+ - **`middlewares/TraceMiddleware`:W3C traceparent 解析**。OTel/Datadog/Honeycomb
645
+ trace 链不再在 engine 这一跳断开。
646
+ - **`bench/runner.mjs`:P95 真正的 P95**。旧代码把 `latency.p97_5` 当 P95
647
+ 上报(偏高 ~20%,误伤 CI gate)。现在从 `latency.histogram.getValueAtPercentile(95)`
648
+ 精确取,无 hdr-histogram 时 P90↔P97.5 线性插值。
649
+ - **`engine/ISREngine.shutdown()`:改 `Promise.allSettled` 语义**。
650
+ `shutdownServer()` 抛错时 `seoEngine.shutdown()` 仍会跑完,避免 FD 泄漏。
651
+
652
+ #### 🟢 小修
653
+
654
+ - **`adapters/runtime/cloudflare`:waitUntil 透传**。`globalThis.__isrEdgeCtx`
655
+ 暴露 `env + ctx.waitUntil`,业务代码可调度 ISR bg 重渲。
656
+ - **`adapters/runtime/vercel-edge`:新增 `toVercelMiddleware`**。支持
657
+ `middleware.ts` 形态(返回 `Response | undefined`)。
658
+ - **`pnpm.overrides`:path-to-regexp 精确 pin `0.1.13`**(旧 `>=0.1.13`
659
+ 解析到 8.x,express 4.21 报 `pathRegexp is not a function`)。
660
+ - **ESLint**:测试文件 override 关闭 `no-empty-function` + `no-non-null-assertion`
661
+ + `bench/app/**` 全 ignore。生产代码规则不变。
662
+
663
+ ### Fixed — Bug 修复
664
+
665
+ - **`bench.yml` 之前永远 skip** —— 旧版用 `if [ -f "../novel-rating-website/..." ]`
666
+ 在 GitHub Actions clean checkout 上永远 false。每次 nightly cron / dispatch /
667
+ perf-sensitive PR 都是 `available=false` 一行 warning 静默跳过。**现已替换为
668
+ self-contained `bench/app/`,CI 实际跑 bench**。
669
+ - **bench-compare 路径错** —— 之前指向 `scripts/bench-baseline.json`,实际文件
670
+ 在 `bench/baseline.json`,对比永远 skip。
671
+ - **CI 触发太窄** —— 之前 `branches: [main, develop]` 让 feature 分支裸奔,
672
+ 改为 `branches: ['**']`。
673
+
674
+ ### Performance — bench baseline
675
+
676
+ 10/100/1000/10000 conn × 3 paths(单核 macOS dev 机器,仅供新提交对比,不代表
677
+ 绝对性能):
678
+
679
+ | path | mode | QPS @ 10c | QPS @ 10000c | P95 @ 10c | P95 @ 10000c |
680
+ |---|---|---|---|---|---|
681
+ | `/` | ISR | 24,826 | 1,486 | 3.3ms | 1712ms |
682
+ | `/about` | SSG | 63,362 | 7,040 | 0ms | 524ms |
683
+ | `/books/1` | ISR + cacheTag | 46,065 | 2,984 | 1.3ms | 1030ms |
684
+
685
+ 未来 PR 在 GitHub Actions 上跑同档位,与本 baseline 对比;P95 +20% 或 QPS -15%
686
+ 自动 fail(CI gate)。
687
+
688
+ ### Tests — 222 → 580(+358)
689
+
690
+ | 模块 | 测试增量 | 关键覆盖 |
691
+ |---|---|---|
692
+ | `plugin/isrCacheMiddleware` | +11 | Set-Cookie / query / variant / L2 timeout / bg safety |
693
+ | `ssg/spider` | +11 | 路径穿越 8 + 恶意路由隔离 + jitter 上界 |
694
+ | `cache/RedisCacheAdapter` e2e | +6 | Buffer 保真 3 + pipeline 错误 + fallback=null |
695
+ | `cache/RedisInvalidationBus` (新) | +8 | origin 过滤 + replay 3 + 水位线 + 非法消息 |
696
+ | `middlewares/RateLimiter` | +15 | extractClientIp 7 + trustProxy + Lua + bench bypass |
697
+ | `middlewares/TraceMiddleware` (新) | +14 | W3C parseTraceparent 10 + 优先级 4 |
698
+ | `metrics/PromMetrics` | +14 | normalizeRoute 8 + /metrics token 7 |
699
+ | `renderer/RenderHeaders` (新) | +23 | Cache-Control 八象限 + ETag + 304 协商 |
700
+ | `engine/RenderMode` (新) | +19 | matchRoutePattern + resolveRenderMode + fallback chain |
701
+ | `engine/normalizeEngineConfig` (新) | +10 | 别名兼容 + 默认值 + 字段透传 |
702
+ | `cli/migrate` (新) | +13 | Next.js 检测 + Vite 配置 + 必需文件 |
703
+ | `cli/loadConfig` (新) | +12 | esbuild TS 编译 + 缓存 + forceReload |
704
+ | `cli/manifest` (新) | +22 | Vite 5+/4 路径探测 + entry 候选匹配 + HTML tag 生成 |
705
+ | `cli/fallback` (新) | +14 | 静态/api/SSR 反代 + 5xx → SPA fallback |
706
+ | `cli/dev` (新) | +14 | 配置 / 启动失败 / SIGINT 优雅关闭 + 二次触发 + 超时 |
707
+ | `cli/start` (新) | +19 | extractRoutesForSitemap + nodeToWebRequest + pipeWebResponse |
708
+ | `discovery/directiveParser` (新) | +38 | use-client/server/cache + 冲突检测 + 禁止导出 |
709
+ | `discovery/scan` (新) | +17 | scanProject + scanRoutes + scanComponents |
710
+ | `logger/Logger` (新) | +20 | 单例 + 级别 + 文件持久化 + ALS 集成 |
711
+ | `route/RouteManager` (新) | +26 | 路径匹配 + sitemap meta + getStats |
712
+ | `utils/CacheCleanup` (新) | +8 | NODE_ENV 守卫 + 路径安全 + 幂等 |
713
+ | `scripts/bench-utils.test.mjs` (新) | +12 | extractP95 优先级 + 边界 + 单位 |
714
+
715
+ **总计:+358 tests** (222 → 580)。型检 0 errors,lint 0 errors,13 warnings(全是
716
+ 合理的 `this.redis!` 模式)。
717
+
718
+ ---
719
+
720
+ ## [2.0.0] - 2026-04-21
721
+
722
+ ### Added
723
+
724
+ - **方向定调**(Plan A):`isr-engine` 是 ISR/SSG/Fallback 编排层,**完全构建于
725
+ `@vitejs/plugin-rsc` 之上**,不手写 Flight 协议。Vite-only 工具链。
726
+ `novel-rating-website` 作为消费者参考实现。
727
+ - L1+L2 Hybrid 双层缓存(`createHybridCacheStore` + `RedisCacheAdapter`)
728
+ - Edge runtime adapters:Cloudflare Workers / Vercel Edge / Deno / Bun
729
+ - 图片优化插件(`createImagePlugin`)+ `<Image>` 组件(AVIF/WebP 自动协商 + srcset)
730
+ - 字体优化插件(`createFontPlugin`):`font-display: swap` + preload + 可选
731
+ Google Fonts 自托管
732
+ - Sentry / Datadog / OTel observability adapters(一行接入)
733
+ - A/B 实验中间件(cookie-sticky variants)
734
+ - Per-IP rate limiter(token bucket)
735
+ - PII redaction NDJSON 审计日志
736
+ - Prometheus `/metrics` 端点 + 默认进程指标
737
+ - SOC2 readiness 文档
738
+
739
+ ### Performance
740
+
741
+ - ISR HIT 9 804 QPS · p50 1ms(单核)
742
+ - SSR 461 QPS · p50 20ms(单核,完整 RSC + SSR 管线)
743
+
744
+ ### Known Limitations(部分已在 2.1.0 解决)
745
+
746
+ - ~~Test coverage ~12%~~ → 2.1.0:~50%(580 tests)
747
+ - ~~`revalidateTag` / `revalidatePath` 无 retry / dead letter~~ → 2.1.0:
748
+ `Promise.allSettled` 全跑 + `RevalidationError` 聚合 + Sorted Set replay log
749
+ - ~~SSG spider 无 timeout / retry / circuit breaker~~ → 2.1.0:30s timeout +
750
+ 3 次 jitter 退避重试 + `failBuildThreshold` 5%
751
+ - ~~Cross-pod cache invalidation 仅单进程~~ → 2.1.0:Redis Pub/Sub +
752
+ Sorted Set 消息重放
753
+ - ~~Bench 不阻塞 CI~~ → 2.1.0:`bench/baseline.json` + `release.yml` 退化即 fail
754
+
755
+ 详细 gap + roadmap 文档(`docs/production-readiness.md`)已在 v2.2.0 一并删除(信息陈旧 / 与 README "生产可用性诚实评估" 段重复)。