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,463 @@
1
+ /**
2
+ * ISR 引擎类型定义
3
+ *
4
+ */
5
+ /**
6
+ * 渲染模式(用户级)—— 路由可选的**三种真实**缓存策略
7
+ *
8
+ * isr ── 运行时入缓存 + TTL;过期后 SWR 回放旧 + 后台重渲
9
+ * ssr ── 不入缓存;每次请求都跑 RSC + SSR 管线
10
+ * ssg ── 构建期预生成 HTML;运行时按 TTL / revalidate 更新共享响应缓存,构建文件保持不可变
11
+ *
12
+ * **csr 不在用户级**——因为"绕过 RSC 跑纯客户端"在 plugin-rsc 模型下不是一个
13
+ * 选择性的渲染策略,而是 server 跑不动时的**降级兜底**。详见下方 InternalStrategyType。
14
+ */
15
+ export type RenderModeType = 'ssg' | 'isr' | 'ssr';
16
+ /**
17
+ * 内部降级策略(fallback chain 的元素,不向用户暴露选择)
18
+ *
19
+ * static ── 直接 serve 构建期物化的 dist/client/<path>/index.html
20
+ * cached ── 命中 ISR LRU 内存缓存
21
+ * regenerate ── 缓存过期 / 不存在时重新跑管线,结果入缓存
22
+ * server ── 实时跑 RSC + SSR 管线(不入缓存,等价 SSR)
23
+ * csr-shell ── server 自身崩溃时的最后兜底:返回最小壳 HTML(无 Flight,
24
+ * 带 self.__NO_HYDRATE=1),浏览器走 createRoot 从零渲染并
25
+ * 通过 _.rsc 端点尝试自救拉数据 —— 体验降级但不是 5xx 白屏
26
+ */
27
+ export type InternalStrategyType = 'static' | 'cached' | 'regenerate' | 'server' | 'csr-shell';
28
+ /**
29
+ * 路由级规则(对象形式)—— 允许精细控制 TTL 与 stale-while-revalidate 窗口
30
+ */
31
+ export interface RouteRuleObject {
32
+ mode: RenderModeType;
33
+ /** TTL(秒),覆盖全局 revalidate 默认值;不覆盖时显式写 undefined */
34
+ ttl: number | undefined;
35
+ /** stale-while-revalidate 窗口(秒);不覆盖时显式写 undefined */
36
+ staleWhileRevalidate: number | undefined;
37
+ }
38
+ /**
39
+ * 路由规则 —— 字符串 shorthand 或完整对象
40
+ * 'isr' 使用全局 revalidate
41
+ * { mode: 'isr', ttl: 60, staleWhileRevalidate: 300 }
42
+ */
43
+ export type RouteRule = RenderModeType | RouteRuleObject;
44
+ export interface RuntimeRedisConfig {
45
+ /** 完整 Redis URL(redis://[:pass@]host:port/db),优先级高于 host/port */
46
+ url: string | undefined;
47
+ host: string | undefined;
48
+ port: number | undefined;
49
+ password: string | undefined;
50
+ /** 页面缓存 key 前缀,默认由 cache layer 使用 isr: */
51
+ keyPrefix: string | undefined;
52
+ /** 跨实例 revalidate 广播频道 */
53
+ invalidationChannel: string | undefined;
54
+ }
55
+ export interface RuntimeExperimentConfig {
56
+ variants: readonly string[];
57
+ weights: readonly number[] | undefined;
58
+ }
59
+ /**
60
+ * 实验定义动态拉取(manifest)
61
+ *
62
+ * admin-server 暴露 GET /api/experiments/manifest,返回 { version, experiments }
63
+ * engine 启动 + 60s 轮询,运营改 weights/status 不重启 server 即生效。
64
+ *
65
+ * fallbackOnError 三档:
66
+ * 'cache' → 用上一次拉成功的快照(默认;推荐)
67
+ * 'static' → 退回 runtime.experiments 静态配置
68
+ * 'empty' → 关闭所有实验,回 control
69
+ *
70
+ * 不配 endpoint → 完全跳过 manifest 拉取,仅用静态 experiments;行为同当前。
71
+ */
72
+ export interface RuntimeExperimentManifestConfig {
73
+ endpoint: string;
74
+ refreshIntervalMs: number | undefined;
75
+ fallbackOnError: 'cache' | 'static' | 'empty' | undefined;
76
+ authHeader: {
77
+ name: string;
78
+ value: string;
79
+ } | undefined;
80
+ }
81
+ /**
82
+ * 曝光上报(exposure tracking)
83
+ *
84
+ * engine ABVariantMiddleware 算完变体之后异步入队,批量 POST 给 admin-server。
85
+ * 完全 fire-and-forget,业务渲染不等。失败丢弃 + 日志,不影响业务。
86
+ *
87
+ * 不配 endpoint → 完全跳过上报;本地开发 / 不需要数据时省心。
88
+ */
89
+ export interface RuntimeExperimentTrackingConfig {
90
+ endpoint: string;
91
+ batchSize: number | undefined;
92
+ flushIntervalMs: number | undefined;
93
+ sampleRate: number | undefined;
94
+ enabled: boolean | undefined;
95
+ }
96
+ export interface RuntimeI18nConfig {
97
+ /** 支持的 locale 列表,用于 URL locale 前缀解析和请求协商 */
98
+ locales: readonly string[];
99
+ /** 默认 locale;不配置时取 locales[0] */
100
+ defaultLocale: string;
101
+ /** 默认 locale 是否带 URL 前缀 */
102
+ prefixDefault: boolean;
103
+ /** 远端字典端点;相对路径会拼到 services.api 上 */
104
+ endpoint: string | undefined;
105
+ /** 本地兜底字典;配置 API 不可用时使用 */
106
+ fallbackLocal: Record<string, Record<string, unknown>> | undefined;
107
+ /** 字典缓存 TTL(毫秒) */
108
+ ttl: number;
109
+ /** 远端请求超时(毫秒) */
110
+ timeoutMs: number;
111
+ /** 响应头 / dev inspector 里显示的远端来源名 */
112
+ remoteSource: string;
113
+ /** 响应头 / dev inspector 里显示的本地兜底来源名 */
114
+ fallbackSource: string;
115
+ }
116
+ /**
117
+ * 动态 SEO 解析器 —— 用于参数化路径(/books/:id / /u/:handle 等)。
118
+ *
119
+ * 设计目标:让业务页面**完全不写 SEO 代码**(不再需要 page export const seo /
120
+ * generateSeo)。所有动态 SEO 在 ssr.config.ts 一处集中声明:
121
+ *
122
+ * runtime.seo.dynamicResolvers = [
123
+ * { pattern: '/books/:id', resolve: async ({ params, services }) => {
124
+ * const r = await fetch(`${services.api}/books/${params.id}`);
125
+ * if (!r.ok) return null;
126
+ * const book = await r.json();
127
+ * return { title: book.title, description: book.synopsis, ... };
128
+ * }
129
+ * },
130
+ * ];
131
+ *
132
+ * 解析顺序(高 → 低):
133
+ * 1. admin endpoint 命中(运营在 dashboard 给具体 path 配过的覆盖)
134
+ * 2. dynamicResolvers pattern 匹配(业务侧请求期数据驱动)
135
+ * 3. fallbackLocal exact path 命中
136
+ * 4. 都没 → null(前端 head 走默认)
137
+ */
138
+ export interface DynamicSeoResolver {
139
+ /**
140
+ * 路径 pattern。支持 `:name` 命名参数(贪婪到 `/`)和 `*` 通配后缀。
141
+ * 例:`/books/:id`、`/u/:handle`、`/dashboard/*`
142
+ */
143
+ pattern: string;
144
+ /**
145
+ * 命中后的 resolver。返回 PageSeoMeta(平铺)或 null。
146
+ * 抛错会被引擎吞掉并写到 onError,不会导致 SSR 失败。
147
+ *
148
+ * input.params 包含 pattern 里 :name 解析出的值。
149
+ * input.locale 是当前请求 locale(可能 undefined,特别是没启 i18n 时)。
150
+ * input.services / input.runtime 给到完整 runtime context,可拿 api origin。
151
+ */
152
+ resolve: (input: {
153
+ pathname: string;
154
+ params: Record<string, string>;
155
+ locale?: string;
156
+ services: {
157
+ api?: string;
158
+ telemetry?: string;
159
+ };
160
+ }) => Promise<Record<string, unknown> | null> | Record<string, unknown> | null;
161
+ }
162
+ export interface RuntimeSeoConfig {
163
+ /** 远端 SEO 端点;支持 {pathname} */
164
+ endpoint: string | undefined;
165
+ /** 本地兜底 SEO 路由表;配置 API 不可用时使用 */
166
+ fallbackLocal: readonly Record<string, unknown>[] | undefined;
167
+ /** SEO 元数据缓存 TTL(毫秒) */
168
+ ttl: number;
169
+ /** 远端请求超时(毫秒) */
170
+ timeoutMs: number;
171
+ /**
172
+ * 参数化路径的 SEO 解析器。
173
+ * admin endpoint / fallbackLocal 是 path 完全匹配的,无法处理 /books/:id
174
+ * 这种动态路径;这里集中声明所有动态路径的 SEO 拼装逻辑,业务页面不再写
175
+ * generateSeo。详见 DynamicSeoResolver 注释。
176
+ */
177
+ dynamicResolvers: readonly DynamicSeoResolver[] | undefined;
178
+ }
179
+ export interface RuntimeServicesConfig {
180
+ /** 默认后端 API origin;业务数据、配置中心、mock 数据都走这里 */
181
+ api: string | undefined;
182
+ /** telemetry 上报 origin;不配置时回退到 api,同源部署可留空 */
183
+ telemetry: string | undefined;
184
+ }
185
+ /**
186
+ * 浏览器侧 telemetry endpoint 公共配置 ——
187
+ *
188
+ * 业务真正需要决定的只有两件事:
189
+ * - endpoint:往哪发(每个 app 自己的 admin / collector 地址)
190
+ * - sampleRate:采多少(成本 vs 可见度)
191
+ *
192
+ * 砍掉的 batchSize / flushIntervalMs / maxQueueSize / retryBaseDelayMs / retryMaxDelayMs:
193
+ * 不是业务决策,是 SDK 内部参数。engine 在 client serializer 里给业界默认值
194
+ * (batch=20/10、flush=3s、queue=500/200、retry=1s..30s 指数退避),跟 Sentry /
195
+ * Datadog SDK 同档;要调整这些非业务侧关心,应该是 SDK 层面而不是 ssr.config.ts。
196
+ */
197
+ export interface RuntimeTelemetryEndpointOptions {
198
+ /** 远端上报地址;相对路径会拼到 services.telemetry/api 上 */
199
+ endpoint: string | undefined;
200
+ /** 采样率,0..1;1 = 全采 */
201
+ sampleRate: number;
202
+ }
203
+ export interface RuntimeTelemetryEventsConfig extends RuntimeTelemetryEndpointOptions {
204
+ /** 是否自动上报首屏 page_view;默认 true */
205
+ trackInitialPage: boolean;
206
+ }
207
+ export interface RuntimeTelemetryErrorsConfig extends RuntimeTelemetryEndpointOptions {
208
+ /** 是否采集 script/link/img 等资源加载失败;默认 true */
209
+ captureResourceErrors: boolean;
210
+ }
211
+ export interface RuntimeTelemetryWebVitalsConfig {
212
+ /** 是否自动采集 Web Vitals;覆盖 FCP/LCP/CLS/INP/TTFB 等前端体验指标 */
213
+ enabled: boolean;
214
+ }
215
+ export interface RuntimeTelemetrySentryIntegrationConfig {
216
+ /** 是否启用 Sentry integration;默认 false,避免仅配置环境变量就隐式接入第三方平台 */
217
+ enabled: boolean;
218
+ /** Sentry DSN;enabled=true 但不配置时 engine 会跳过 adapter 并记录 warn */
219
+ dsn: string | undefined;
220
+ tracesSampleRate: number | undefined;
221
+ environment: string | undefined;
222
+ release: string | undefined;
223
+ }
224
+ export interface RuntimeTelemetryDatadogExporterConfig {
225
+ type: 'datadog';
226
+ name: string | undefined;
227
+ required: boolean | undefined;
228
+ service: string | undefined;
229
+ }
230
+ export interface RuntimeTelemetryOtelExporterConfig {
231
+ type: 'otel';
232
+ name: string | undefined;
233
+ required: boolean | undefined;
234
+ endpoint: string | undefined;
235
+ serviceName: string | undefined;
236
+ }
237
+ export type RuntimeTelemetryExporterConfig = RuntimeTelemetryDatadogExporterConfig | RuntimeTelemetryOtelExporterConfig;
238
+ export interface RuntimeTelemetryIntegrationsConfig {
239
+ /**
240
+ * Sentry 是完整第三方监控平台 integration,不是普通 HTTP endpoint。
241
+ *
242
+ * 语义:
243
+ * - events/errors endpoint 是第一方 HTTP 上报的唯一真值源。
244
+ * - integration 和 exporters 可同时启用,用于迁移、双写或第一方数据仓库 + Sentry 排障并存。
245
+ * - 如果只想二选一,显式关闭不需要的 exporter 或 integration;engine 不做隐式替换。
246
+ *
247
+ * SDK / issue grouping / source map / release health / performance 都在这一层。
248
+ */
249
+ sentry: RuntimeTelemetrySentryIntegrationConfig | undefined;
250
+ }
251
+ export interface RuntimeTelemetryConfig {
252
+ /** 应用名;不配置时读取 package.json name */
253
+ app: string | undefined;
254
+ /** 发布版本,用于错误归因和发布影响分析 */
255
+ release: string | undefined;
256
+ /** 当前环境:development/staging/production */
257
+ environment: string | undefined;
258
+ /** 是否把 query string 纳入 URL;默认 false,避免采集敏感参数 */
259
+ includeQueryString: boolean;
260
+ /** 前端事件/PV 埋点配置;false 表示关闭 events */
261
+ events: false | RuntimeTelemetryEventsConfig;
262
+ /** 前端错误上报配置;false 表示关闭 errors */
263
+ errors: false | RuntimeTelemetryErrorsConfig;
264
+ /** Web Vitals 配置;false 表示关闭性能指标 */
265
+ webVitals: false | RuntimeTelemetryWebVitalsConfig;
266
+ /**
267
+ * 额外 collector 出口。第一方 HTTP 上报不放这里,唯一真值源是
268
+ * events.endpoint / errors.endpoint,避免同一个地址配置两遍。
269
+ * 当前没有 Datadog/OTel collector 时应保持 [];Sentry 这类完整 SDK 平台放
270
+ * integrations,不降级为普通 exporter。
271
+ */
272
+ exporters: readonly RuntimeTelemetryExporterConfig[];
273
+ /** 第三方平台集成,和第一方 endpoint telemetry 并列挂在 telemetry 下面 */
274
+ integrations: RuntimeTelemetryIntegrationsConfig;
275
+ }
276
+ /**
277
+ * 平台运行时配置。
278
+ *
279
+ * 第一性原则:
280
+ * - 启动期 / 部署期 / 平台级能力放 ssr.config.ts 的 runtime
281
+ * - 请求期业务逻辑仍放 entry.server.tsx hooks
282
+ */
283
+ export interface RuntimeConfig {
284
+ /** 图片优化允许的精确远程 host[:port],默认禁止远程源;私网始终禁止。 */
285
+ images?: {
286
+ remoteAllowlist?: string[];
287
+ };
288
+ /** 站点公网 base URL,用于 SEO canonical / sitemap / robots */
289
+ site: string | undefined;
290
+ /**
291
+ * Cookie 跨子域共享的 Domain 属性。
292
+ *
293
+ * 用法:
294
+ * - **子域分发部署**(www.x / admin.x / api.x):设 `.your-domain.com`
295
+ * —— engine 写 anon cookie 时带 `Domain=.your-domain.com`,浏览器自动
296
+ * 带到所有子域;SSR 在 www 写、API 在 api 读、客户端在 www 读都拿得到。
297
+ * - **单一域名**(path-based routing):留空 undefined,cookie 关联当前 host
298
+ * 即可,更严格的 same-origin。
299
+ * - **localhost**:留空。浏览器对 `Domain=localhost` 处理不一致,反而出问题
300
+ */
301
+ cookieDomain?: string;
302
+ /**
303
+ * ISR 缓存按 Host 隔离。
304
+ *
305
+ * 用法:
306
+ * - **多域名打到同一 SSR 进程**(按域名出不同内容:白标站 / 渠道站 /
307
+ * tenant-by-domain):必须设 true —— cache key 追加 `|h=<host>`,
308
+ * `a.com/books` 与 `b.com/books` 各自独立缓存,不会跨站串内容。
309
+ * - **单一站点**(一个进程只服务一个域名,业界默认形态):留 false/undefined,
310
+ * 避免 www/裸域/内网探活等多个 Host 别名造成缓存碎片化。
311
+ *
312
+ * `revalidatePath` 失效不区分 host —— 清除该路径所有 host 的条目。
313
+ */
314
+ hostIsolation?: boolean;
315
+ /** 按职责拆开的后端服务 origin */
316
+ services: RuntimeServicesConfig;
317
+ /** 分布式 ISR 缓存与跨实例失效广播 */
318
+ redis: RuntimeRedisConfig | undefined;
319
+ /** A/B testing / experimentation 定义,供 getVariant() 在 Server Component 中读取 */
320
+ experiments: Record<string, RuntimeExperimentConfig>;
321
+ /** 实验定义从 admin-server 动态拉取(manifest);不配则只用 experiments 静态配置 */
322
+ experimentManifest?: RuntimeExperimentManifestConfig;
323
+ /** 曝光事件上报(server-side fire-and-forget);不配则不上报 */
324
+ experimentTracking?: RuntimeExperimentTrackingConfig;
325
+ /** i18n 字典源配置;请求期加载由 engine 默认 SiteHooks 消费 */
326
+ i18n: RuntimeI18nConfig | undefined;
327
+ /** 页面 SEO 元数据源配置;站点 canonical/sitemap base URL 统一来自 runtime.site */
328
+ seo: RuntimeSeoConfig | undefined;
329
+ /**
330
+ * telemetry 上报配置。engine 会把浏览器安全子集序列化到 client entry,
331
+ * 自动接入 page_view、Web Vitals、全局错误、资源加载失败、Server Action 错误;
332
+ * 服务端渲染异常会通过同一个 errors endpoint 非阻塞上报。
333
+ */
334
+ telemetry: false | RuntimeTelemetryConfig;
335
+ }
336
+ export declare const RenderModes: {
337
+ readonly SSG: "ssg";
338
+ readonly ISR: "isr";
339
+ readonly SSR: "ssr";
340
+ };
341
+ export declare const InternalStrategies: {
342
+ readonly STATIC: "static";
343
+ readonly CACHED: "cached";
344
+ readonly REGENERATE: "regenerate";
345
+ readonly SERVER: "server";
346
+ readonly CSR_SHELL: "csr-shell";
347
+ };
348
+ /**
349
+ * 自动降级链 —— 路由 mode 决定优先尝试哪些策略,失败逐级往下
350
+ * 所有链路最末端都是 'csr-shell',保证 server 完全崩溃时浏览器仍能拿到壳 HTML
351
+ *
352
+ * 例:mode=isr 的请求处理顺序
353
+ * 1. cached ── 命中 LRU → 直接回放
354
+ * 2. regenerate ── miss / stale → 跑管线 + 入缓存
355
+ * 3. server ── 缓存层崩溃 → 实时跑管线(不入缓存)
356
+ * 4. csr-shell ── 管线本身抛异常 → 返回壳 HTML,浏览器接管
357
+ */
358
+ export declare const FallbackChain: Record<RenderModeType, InternalStrategyType[]>;
359
+ /** Express-compatible policy for determining whether a remote proxy is trusted. */
360
+ export type ProxyTrustPolicy = boolean | number | string | string[] | ((address: string, hop: number) => boolean);
361
+ export interface ISRConfig {
362
+ /** 全局默认渲染模式 */
363
+ renderMode: RenderModeType;
364
+ /**
365
+ * 路由级别覆盖配置。
366
+ * 没有覆盖时显式写 `{}`,这样 ssr.config.ts 不存在隐藏默认值。
367
+ * 支持通配符匹配:'/posts/*' 匹配所有 /posts/ 开头的路由
368
+ * 支持动态路由:'/post/:id' 匹配 /post/123 等
369
+ *
370
+ * @example
371
+ * ```ts
372
+ * routes: {
373
+ * '/': 'ssg', // 首页使用 SSG
374
+ * '/admin/*': 'ssr', // 管理后台使用 SSR
375
+ * }
376
+ * ```
377
+ */
378
+ routes: Record<string, RouteRule>;
379
+ /**
380
+ * 平台运行时配置。
381
+ *
382
+ * 这些是稳定的部署/启动配置,成熟项目应放在 ssr.config.ts,而不是散落在
383
+ * entry.server.tsx 里。entry.server.tsx 只负责如何在请求期使用这些配置。
384
+ */
385
+ runtime: RuntimeConfig;
386
+ /**
387
+ * 全局默认页面缓存 TTL(秒)。
388
+ *
389
+ * routes[*].ttl 优先;未声明路由级 TTL 时使用这里。
390
+ * 这是产品层缓存新鲜度,不是 Redis/memory 后端配置。
391
+ */
392
+ revalidate: number;
393
+ server: {
394
+ /**
395
+ * Express trust proxy policy. Defaults to false: ignore forwarded protocol/IP.
396
+ * Behind a proxy, explicitly configure trusted addresses/CIDRs (e.g. 'loopback').
397
+ * Hop counts/true require an ingress that overwrites client forwarded headers.
398
+ */
399
+ trustProxy?: ProxyTrustPolicy;
400
+ /** Node origin 监听端口;缺省 3000。 */
401
+ port: number;
402
+ /** Node origin 监听地址;通常本地留空,容器/内网按部署平台注入。 */
403
+ host: string | undefined;
404
+ /**
405
+ * 端口严格模式。
406
+ *
407
+ * - true:端口被占用时启动失败,适合生产 / 容器 / CI,避免服务悄悄跑到错误端口。
408
+ * - false:端口被占用时最多尝试后续 20 个端口,适合本地 dev。
409
+ *
410
+ * 不配置时 engine 默认 dev=false、prod=true;成熟业务建议在 ssr.config.ts 显式写出。
411
+ */
412
+ strictPort: boolean;
413
+ /**
414
+ * 运维端点暴露策略。
415
+ *
416
+ * 公开配置保留稳定运维边界:
417
+ * - /health:健康检查,默认启用且公开
418
+ * - /metrics:Prometheus 文本指标,默认关闭;生产开启时建议配置 authToken
419
+ * - /__isr/cache/inventory:当前 L1 缓存条目元数据 + 最近 invalidate 时间。
420
+ * dev 默认 public 开放;prod 默认 enabled + 强制 authToken(故障诊断工具
421
+ * 事故来时才用,常驻必要 —— 没 token 时 resolveOpsConfig 自动 disable 且出 warning)。
422
+ *
423
+ * 长期指标 / 报警 / 可视化由 Prometheus + Grafana 承担,engine 不做。
424
+ */
425
+ ops: {
426
+ /** 共享运维口令;接受 `Authorization: Bearer <token>` 或 tokenHeader 指定 header */
427
+ authToken: string | undefined;
428
+ /** 自定义 header 名,默认 `x-isr-admin-token` */
429
+ tokenHeader: string;
430
+ health: {
431
+ enabled: boolean;
432
+ public: boolean;
433
+ };
434
+ metrics: {
435
+ enabled: boolean;
436
+ public: boolean;
437
+ };
438
+ inventory: {
439
+ enabled: boolean;
440
+ public: boolean;
441
+ };
442
+ };
443
+ };
444
+ /** SSG 预生成配置 */
445
+ ssg: {
446
+ /** 显式 SSG 路由列表(可选,优先级高于 routes 中 mode=ssg 的条目) */
447
+ routes: readonly string[] | (() => readonly string[] | Promise<readonly string[]>);
448
+ /** 并发度,默认 3 */
449
+ concurrent: number;
450
+ /** 单页请求超时毫秒,默认 30_000;防 hang 拖死整个 build */
451
+ requestTimeoutMs: number;
452
+ /** 单页最大重试次数(不含首次),默认 3;只重试 timeout/network/5xx,不重试 4xx */
453
+ maxRetries: number;
454
+ /** 重试初始退避毫秒,默认 200;指数退避 = base * 2^(N-1) */
455
+ retryBaseDelayMs: number;
456
+ /**
457
+ * 整体失败率阈值(0-1),默认 0.05(5%);超过则 build 失败。
458
+ * 设 1.0 关闭(不推荐——会 mask 真实问题)。设 0 = 任何失败都 fail build。
459
+ */
460
+ failBuildThreshold: number;
461
+ };
462
+ }
463
+ //# sourceMappingURL=ISRConfig.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ISRConfig.d.ts","sourceRoot":"","sources":["../../src/types/ISRConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC/F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,mDAAmD;IACnD,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,0BAA0B;IAC1B,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,eAAe,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC1D,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IACnE,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAChD,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iCAAiC;IACjC,aAAa,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;IAC9D,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,+BAA+B;IAC9C,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA6B,SAAQ,+BAA+B;IACnF,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA6B,SAAQ,+BAA+B;IACnF,2CAA2C;IAC3C,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,+BAA+B;IAC9C,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uCAAuC;IACtD,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,MAAM,8BAA8B,GACtC,qCAAqC,GACrC,kCAAkC,CAAC;AAEvC,MAAM,WAAW,kCAAkC;IACjD;;;;;;;;;OASG;IACH,MAAM,EAAE,uCAAuC,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,yBAAyB;IACzB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qCAAqC;IACrC,MAAM,EAAE,KAAK,GAAG,4BAA4B,CAAC;IAC7C,iCAAiC;IACjC,MAAM,EAAE,KAAK,GAAG,4BAA4B,CAAC;IAC7C,mCAAmC;IACnC,SAAS,EAAE,KAAK,GAAG,+BAA+B,CAAC;IACnD;;;;;OAKG;IACH,SAAS,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACrD,wDAAwD;IACxD,YAAY,EAAE,kCAAkC,CAAC;CAClD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACxC,wDAAwD;IACxD,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wBAAwB;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,yBAAyB;IACzB,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACrD,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;IACrD,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;IACrD,+CAA+C;IAC/C,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACpC,oEAAoE;IACpE,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAClC;;;;OAIG;IACH,SAAS,EAAE,KAAK,GAAG,sBAAsB,CAAC;CAC3C;AAED,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAGX,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,oBAAoB,EAAE,CAIxE,CAAC;AAIF,mFAAmF;AACnF,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,EAAE,GACR,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,UAAU,EAAE,cAAc,CAAC;IAE3B;;;;;;;;;;;;;OAaG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAElC;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAC;IAcvB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,MAAM,EAAE;QACN;;;;WAIG;QACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,gCAAgC;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,4CAA4C;QAC5C,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB;;;;;;;WAOG;QACH,UAAU,EAAE,OAAO,CAAC;QACpB;;;;;;;;;;;WAWG;QACH,GAAG,EAAE;YACH,wEAAwE;YACxE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;YAC9B,0CAA0C;YAC1C,WAAW,EAAE,MAAM,CAAC;YACpB,MAAM,EAAE;gBACN,OAAO,EAAE,OAAO,CAAC;gBACjB,MAAM,EAAE,OAAO,CAAC;aACjB,CAAC;YACF,OAAO,EAAE;gBACP,OAAO,EAAE,OAAO,CAAC;gBACjB,MAAM,EAAE,OAAO,CAAC;aACjB,CAAC;YACF,SAAS,EAAE;gBACT,OAAO,EAAE,OAAO,CAAC;gBACjB,MAAM,EAAE,OAAO,CAAC;aACjB,CAAC;SACH,CAAC;KACH,CAAC;IAEF,gBAAgB;IAChB,GAAG,EAAE;QACH,kDAAkD;QAClD,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,MAAM,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;QACnF,eAAe;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,2CAA2C;QAC3C,gBAAgB,EAAE,MAAM,CAAC;QACzB,0DAA0D;QAC1D,UAAU,EAAE,MAAM,CAAC;QACnB,4CAA4C;QAC5C,gBAAgB,EAAE,MAAM,CAAC;QACzB;;;WAGG;QACH,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH"}
@@ -0,0 +1,104 @@
1
+ import type { ViteDevServer } from 'vite';
2
+ import type { RenderModeType } from './ISRConfig';
3
+ /**
4
+ * 请求上下文数据 —— engine 内部 + 业务 hook 写入的字段。
5
+ *
6
+ * 设计原则:只放"被多处消费"的字段。一次性的(如 acceptLanguage / referer)engine
7
+ * 直接读 req.headers,不复制到 ctx;trace 快照同样直接读 req.headers,不依赖 ctx。
8
+ *
9
+ * 已删除的字段(声明但无消费者,纯死代码):
10
+ * - forceMode / forceFallback / bypassCache:dev 调试 URL 参数曾计划走这里,
11
+ * 现在 plugin-rsc / engine cache 都直接读 query string,没人读这三个字段
12
+ * - seo:声明了但 engine SEO 路径用 PageSeoMeta(独立类型),不走这里
13
+ * - acceptLanguage / referer:曾写到 ctx 给 trace 用,trace 改读 req.headers 后
14
+ * 这两个 ctx 字段就再无消费者
15
+ */
16
+ export interface ISRContextData {
17
+ /** W3C trace-context traceparent 或自生成 UUID;用作 cross-service 追踪 + admin 排障索引 */
18
+ traceId: string;
19
+ /** 单服务的请求 ID;写到响应头 x-request-id 给客户端 / 客户端日志关联用 */
20
+ requestId: string;
21
+ /**
22
+ * 浏览器 / 设备维度的稳定 ID —— 由 engine 入口中间件保证非空:
23
+ * - cookie `anon` 存在 → 读取作 anonId
24
+ * - 缺失 → randomUUID() 生成,并通过 res.appendHeader('Set-Cookie', ...) 落 cookie
25
+ *
26
+ * 作用:
27
+ * 1. A/B 实验确定性分桶(hash(anonId + expKey) → variant,无需 sticky 变体 cookie)
28
+ * 2. telemetry / error reporting 按用户聚合(跨 session、跨设备唯一)
29
+ * 3. 个性化推荐 / 浏览历史等 lightweight 场景的 server-side 锚点
30
+ *
31
+ * 不是 session token、不是 userId、不识别身份;GDPR 语境下属于"persistent identifier",
32
+ * 业务侧若要 EU 合规需在 cookie consent 前不写。
33
+ */
34
+ anonId: string;
35
+ /** 已登录用户 ID(业务侧 beforeRequest 写入,Server Component / Server Action 消费) */
36
+ userId?: string;
37
+ /**
38
+ * 鉴权 token(cookie / header 解出);engine 不读不写,业务侧 Server Action
39
+ * 透传给后端 API 做鉴权。
40
+ */
41
+ sessionToken?: string;
42
+ /**
43
+ * 用户 session 摘要(displayName / handle / avatar 等)。业务侧 Server Component
44
+ * 直接读这里来拼 UI,避免每个 RSC 重新拉一次 user info。
45
+ */
46
+ sessionUser?: {
47
+ userId?: string;
48
+ displayName?: string;
49
+ handle?: string;
50
+ [key: string]: unknown;
51
+ };
52
+ /**
53
+ * 解析后的 Cookie 表 —— 由 engine 入口中间件 parseCookieHeader(req.headers.cookie)
54
+ * 写入。Server Component 通过 `getRequestContext()?.cookies?.<name>` 读取,
55
+ * 让"locale / 实验位"这类 SSR 首屏就要决定的偏好不依赖 client mount。
56
+ */
57
+ cookies?: Record<string, string>;
58
+ /** A/B 测试开关位(engine ABVariantMiddleware 写入;getVariant() 读) */
59
+ flags?: Record<string, boolean | string>;
60
+ /**
61
+ * 本次请求生效的实验变体表 —— `{ 'hero-style': 'bold' }`。由 ABVariantMiddleware
62
+ * 在每次请求时基于 anonId + 实验配置确定性算出(hash(anonId+expKey)),不进 cookie。
63
+ * ISR cache key 拼这一份的 digest,保证「不同变体走不同 cache entry」+「同一 anonId
64
+ * 同一实验配置永远 HIT 同一份缓存」。
65
+ *
66
+ * 与 flags 区别:experiments 只承载实验变体;flags 是更宽泛的 boolean/string 开关位
67
+ * (比如 feature toggle,dark launch)。getVariant() 历史上读 flags,本字段是它的 sst。
68
+ */
69
+ experiments?: Record<string, string>;
70
+ /** 其它业务扩展字段(engine 不消费) */
71
+ [key: string]: unknown;
72
+ }
73
+ /**
74
+ * ISR 请求上下文 —— 跨中间件传递的请求元数据容器
75
+ *
76
+ * plugin-rsc 模式下真正的渲染由 `@vitejs/plugin-rsc` 的 fetch handler 承担,
77
+ * 本类型主要用于:
78
+ * - ISR 缓存中间件判断命中 / 失效
79
+ * - 用户中间件链(MiddlewareComposer)的 context
80
+ * - 错误处理 / 指标采集
81
+ */
82
+ export interface ISRContext<T = Record<string, string | string[] | undefined>> {
83
+ req?: {
84
+ headers: T;
85
+ cookies: Record<string, string>;
86
+ query: T;
87
+ userAgent: string;
88
+ };
89
+ res?: {
90
+ statusCode: number;
91
+ headers: T;
92
+ };
93
+ /** 当前请求的 URL */
94
+ url: string;
95
+ /** 最终执行的渲染模式(isr / ssg / ssr) */
96
+ renderModeType: RenderModeType;
97
+ /** Vite dev server 实例(仅开发模式,用于 middleware 链中访问 module graph 等) */
98
+ server?: ViteDevServer;
99
+ /** 错误信息 */
100
+ error?: Error;
101
+ /** 上下文数据 */
102
+ data: ISRContextData;
103
+ }
104
+ //# sourceMappingURL=ISRContext.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ISRContext.d.ts","sourceRoot":"","sources":["../../src/types/ISRContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;OAYG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjG;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IACzC;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,2BAA2B;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3E,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,KAAK,EAAE,CAAC,CAAC;QACT,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,GAAG,CAAC,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC;KACZ,CAAC;IAEF,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IAEZ,iCAAiC;IACjC,cAAc,EAAE,cAAc,CAAC;IAE/B,kEAAkE;IAClE,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,YAAY;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB"}
@@ -0,0 +1,7 @@
1
+ export * from './ISRConfig';
2
+ export * from './ISRContext';
3
+ export * from './IRenderResult';
4
+ export * from './IRenderMetadata';
5
+ export * from './IHelmetData';
6
+ export * from './IFlightData';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * 缓存清理工具类
3
+ * 负责在开发环境启动时清理统一的缓存目录
4
+ */
5
+ export declare class CacheCleanup {
6
+ private static readonly CACHE_ROOT_DIR;
7
+ private static readonly ISR_CACHE_DIR;
8
+ private static readonly SSR_CACHE_DIR;
9
+ private static readonly SSG_CACHE_DIR;
10
+ /**
11
+ * 安全删除缓存根目录
12
+ */
13
+ private static safeClearCacheRoot;
14
+ /**
15
+ * 开发环境启动时清理缓存
16
+ * 只在开发环境(pnpm dev)时执行,生产环境不处理
17
+ */
18
+ static cleanupOnDevStart(): Promise<void>;
19
+ /**
20
+ * 获取ISR缓存目录路径
21
+ */
22
+ static getISRCacheDir(): string;
23
+ /**
24
+ * 获取SSR缓存目录路径
25
+ */
26
+ static getSSRCacheDir(): string;
27
+ /**
28
+ * 获取SSG缓存目录路径
29
+ */
30
+ static getSSGCacheDir(): string;
31
+ }
32
+ //# sourceMappingURL=CacheCleanup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CacheCleanup.d.ts","sourceRoot":"","sources":["../../src/utils/CacheCleanup.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAe;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAmB;IAExD;;OAEG;mBACkB,kBAAkB;IAmBvC;;;OAGG;WACiB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtD;;OAEG;WACW,cAAc,IAAI,MAAM;IAItC;;OAEG;WACW,cAAc,IAAI,MAAM;IAItC;;OAEG;WACW,cAAc,IAAI,MAAM;CAGvC"}
@@ -0,0 +1,12 @@
1
+ export interface CacheDurationOverrides {
2
+ ttl?: unknown;
3
+ staleWhileRevalidate?: unknown;
4
+ }
5
+ /** Cache deadlines must remain finite, positive (or explicitly zero for SWR) timestamps. */
6
+ export declare function assertCacheDuration(seconds: unknown, label: string, allowZero?: boolean): asserts seconds is number;
7
+ /** Undefined inherits; explicit invalid values never silently substitute another policy. */
8
+ export declare function resolveCacheDurations(defaultTtl: number, overrides?: CacheDurationOverrides, label?: string): {
9
+ ttlSeconds: number;
10
+ swrSeconds: number;
11
+ };
12
+ //# sourceMappingURL=cacheDuration.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheDuration.d.ts","sourceRoot":"","sources":["../../src/utils/cacheDuration.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,UAAQ,GAChB,OAAO,CAAC,OAAO,IAAI,MAAM,CAU3B;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,sBAA2B,EACtC,KAAK,SAAU,GACd;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAS5C"}
@@ -0,0 +1,7 @@
1
+ export type CookieHeaderSource = string | null | undefined | {
2
+ headers?: Headers | Record<string, string | string[] | number | undefined | null>;
3
+ };
4
+ export declare function getCookieHeader(source: CookieHeaderSource): string;
5
+ export declare function readCookie(source: CookieHeaderSource, name: string): string | undefined;
6
+ export declare function parseCookieHeader(header: string): Record<string, string>;
7
+ //# sourceMappingURL=cookie.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cookie.d.ts","sourceRoot":"","sources":["../../src/utils/cookie.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,IAAI,GACJ,SAAS,GACT;IACE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;CACnF,CAAC;AAEN,wBAAgB,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAelE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxE"}