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,27 @@
1
+ import { RenderMetadata } from './IRenderMetadata';
2
+
3
+ /**
4
+ * Flight 协议基本值类型
5
+ */
6
+ export type FlightValue = string | number | boolean | FlightValue[];
7
+
8
+ export interface FlightModuleReference {
9
+ id: string;
10
+ chunks: string[];
11
+ name: string;
12
+ }
13
+
14
+ export interface FlightActionReference {
15
+ id: string;
16
+ bound: FlightValue[];
17
+ }
18
+
19
+ export interface FlightData {
20
+ chunks: string[];
21
+ moduleMap: Array<[string, FlightModuleReference]>;
22
+ actionMap: Array<[string, FlightActionReference]>;
23
+ }
24
+
25
+ export interface SerializedFlightPayload extends FlightData {
26
+ metadata: RenderMetadata;
27
+ }
@@ -0,0 +1,9 @@
1
+ export interface HelmetData {
2
+ title: { toString: () => string };
3
+ meta: { toString: () => string };
4
+ link: { toString: () => string };
5
+ script: { toString: () => string };
6
+ style: { toString: () => string };
7
+ htmlAttributes: { toString: () => string };
8
+ bodyAttributes: { toString: () => string };
9
+ }
@@ -0,0 +1,52 @@
1
+ import { RenderModeType, InternalStrategyType } from './ISRConfig';
2
+
3
+ /**
4
+ * 统一渲染元数据接口
5
+ * 用于在引擎内部流转以及传递给客户端
6
+ */
7
+ export interface RenderMetadata {
8
+ renderModeType: RenderModeType;
9
+ /** 兼容历史字段:部分调用链会注入 renderMode */
10
+ renderMode?: RenderModeType;
11
+ timestamp: number;
12
+ renderTime: number;
13
+ fromCache: boolean;
14
+ }
15
+
16
+ /**
17
+ * 渲染诊断数据
18
+ * 用于调试、监控和性能分析,与核心 RenderMetadata 分离
19
+ *
20
+ * 字段分为两类:
21
+ * - 基础诊断字段:每次渲染都会产生
22
+ * - ISR/降级链字段:仅在特定场景下存在
23
+ */
24
+ export interface RenderDiagnostics {
25
+ // ========== 基础诊断字段 ==========
26
+ /** 渲染的组件数量 */
27
+ componentCount: number;
28
+ /** 实际执行的内部策略 */
29
+ strategy: InternalStrategyType;
30
+ /** 是否使用了降级策略 */
31
+ fallbackUsed: boolean;
32
+ /** 缓存命中 */
33
+ cacheHit: boolean;
34
+
35
+ // ========== ISR 缓存相关(仅 ISR 模式) ==========
36
+ /** ISR 缓存生成时间戳 (ms) */
37
+ generated?: number;
38
+ /** ISR 上次重新生成时间戳 (ms) */
39
+ lastRegenerated?: number;
40
+ /** ISR 下次需要重新验证的时间戳 (ms) */
41
+ revalidateAfter?: number;
42
+ /** 是否需要重新验证 */
43
+ needsRevalidation?: boolean;
44
+ /** 缓存年龄 (ms) */
45
+ cacheAge?: number;
46
+
47
+ // ========== 降级链相关(仅降级链执行时) ==========
48
+ /** 降级链总响应时间 (ms) */
49
+ totalResponseTime?: number;
50
+ /** 降级链尝试过的策略列表 */
51
+ attemptedStrategies?: InternalStrategyType[];
52
+ }
@@ -0,0 +1,16 @@
1
+ import { FlightData } from './IFlightData';
2
+ import { HelmetData } from './IHelmetData';
3
+ import { RenderMetadata, RenderDiagnostics } from './IRenderMetadata';
4
+
5
+ /**
6
+ * 统一渲染结果接口
7
+ */
8
+ export interface RenderResult {
9
+ html: string;
10
+ preloadLinks: string;
11
+ helmet: HelmetData;
12
+ statusCode: number;
13
+ meta: RenderMetadata;
14
+ diagnostics?: RenderDiagnostics;
15
+ rscPayload?: FlightData;
16
+ }
@@ -0,0 +1,512 @@
1
+ /**
2
+ * ISR 引擎类型定义
3
+ *
4
+ */
5
+
6
+ /**
7
+ * 渲染模式(用户级)—— 路由可选的**三种真实**缓存策略
8
+ *
9
+ * isr ── 运行时入缓存 + TTL;过期后 SWR 回放旧 + 后台重渲
10
+ * ssr ── 不入缓存;每次请求都跑 RSC + SSR 管线
11
+ * ssg ── 构建期预生成 HTML;运行时按 TTL / revalidate 更新共享响应缓存,构建文件保持不可变
12
+ *
13
+ * **csr 不在用户级**——因为"绕过 RSC 跑纯客户端"在 plugin-rsc 模型下不是一个
14
+ * 选择性的渲染策略,而是 server 跑不动时的**降级兜底**。详见下方 InternalStrategyType。
15
+ */
16
+ export type RenderModeType = 'ssg' | 'isr' | 'ssr';
17
+
18
+ /**
19
+ * 内部降级策略(fallback chain 的元素,不向用户暴露选择)
20
+ *
21
+ * static ── 直接 serve 构建期物化的 dist/client/<path>/index.html
22
+ * cached ── 命中 ISR LRU 内存缓存
23
+ * regenerate ── 缓存过期 / 不存在时重新跑管线,结果入缓存
24
+ * server ── 实时跑 RSC + SSR 管线(不入缓存,等价 SSR)
25
+ * csr-shell ── server 自身崩溃时的最后兜底:返回最小壳 HTML(无 Flight,
26
+ * 带 self.__NO_HYDRATE=1),浏览器走 createRoot 从零渲染并
27
+ * 通过 _.rsc 端点尝试自救拉数据 —— 体验降级但不是 5xx 白屏
28
+ */
29
+ export type InternalStrategyType = 'static' | 'cached' | 'regenerate' | 'server' | 'csr-shell';
30
+ /**
31
+ * 路由级规则(对象形式)—— 允许精细控制 TTL 与 stale-while-revalidate 窗口
32
+ */
33
+ export interface RouteRuleObject {
34
+ mode: RenderModeType;
35
+ /** TTL(秒),覆盖全局 revalidate 默认值;不覆盖时显式写 undefined */
36
+ ttl: number | undefined;
37
+ /** stale-while-revalidate 窗口(秒);不覆盖时显式写 undefined */
38
+ staleWhileRevalidate: number | undefined;
39
+ }
40
+
41
+ /**
42
+ * 路由规则 —— 字符串 shorthand 或完整对象
43
+ * 'isr' 使用全局 revalidate
44
+ * { mode: 'isr', ttl: 60, staleWhileRevalidate: 300 }
45
+ */
46
+ export type RouteRule = RenderModeType | RouteRuleObject;
47
+
48
+ export interface RuntimeRedisConfig {
49
+ /** 完整 Redis URL(redis://[:pass@]host:port/db),优先级高于 host/port */
50
+ url: string | undefined;
51
+ host: string | undefined;
52
+ port: number | undefined;
53
+ password: string | undefined;
54
+ /** 页面缓存 key 前缀,默认由 cache layer 使用 isr: */
55
+ keyPrefix: string | undefined;
56
+ /** 跨实例 revalidate 广播频道 */
57
+ invalidationChannel: string | undefined;
58
+ }
59
+
60
+ export interface RuntimeExperimentConfig {
61
+ variants: readonly string[];
62
+ weights: readonly number[] | undefined;
63
+ }
64
+
65
+ /**
66
+ * 实验定义动态拉取(manifest)
67
+ *
68
+ * admin-server 暴露 GET /api/experiments/manifest,返回 { version, experiments }
69
+ * engine 启动 + 60s 轮询,运营改 weights/status 不重启 server 即生效。
70
+ *
71
+ * fallbackOnError 三档:
72
+ * 'cache' → 用上一次拉成功的快照(默认;推荐)
73
+ * 'static' → 退回 runtime.experiments 静态配置
74
+ * 'empty' → 关闭所有实验,回 control
75
+ *
76
+ * 不配 endpoint → 完全跳过 manifest 拉取,仅用静态 experiments;行为同当前。
77
+ */
78
+ export interface RuntimeExperimentManifestConfig {
79
+ endpoint: string;
80
+ refreshIntervalMs: number | undefined;
81
+ fallbackOnError: 'cache' | 'static' | 'empty' | undefined;
82
+ authHeader: { name: string; value: string } | undefined;
83
+ }
84
+
85
+ /**
86
+ * 曝光上报(exposure tracking)
87
+ *
88
+ * engine ABVariantMiddleware 算完变体之后异步入队,批量 POST 给 admin-server。
89
+ * 完全 fire-and-forget,业务渲染不等。失败丢弃 + 日志,不影响业务。
90
+ *
91
+ * 不配 endpoint → 完全跳过上报;本地开发 / 不需要数据时省心。
92
+ */
93
+ export interface RuntimeExperimentTrackingConfig {
94
+ endpoint: string;
95
+ batchSize: number | undefined;
96
+ flushIntervalMs: number | undefined;
97
+ sampleRate: number | undefined;
98
+ enabled: boolean | undefined;
99
+ }
100
+
101
+ export interface RuntimeI18nConfig {
102
+ /** 支持的 locale 列表,用于 URL locale 前缀解析和请求协商 */
103
+ locales: readonly string[];
104
+ /** 默认 locale;不配置时取 locales[0] */
105
+ defaultLocale: string;
106
+ /** 默认 locale 是否带 URL 前缀 */
107
+ prefixDefault: boolean;
108
+ /** 远端字典端点;相对路径会拼到 services.api 上 */
109
+ endpoint: string | undefined;
110
+ /** 本地兜底字典;配置 API 不可用时使用 */
111
+ fallbackLocal: Record<string, Record<string, unknown>> | undefined;
112
+ /** 字典缓存 TTL(毫秒) */
113
+ ttl: number;
114
+ /** 远端请求超时(毫秒) */
115
+ timeoutMs: number;
116
+ /** 响应头 / dev inspector 里显示的远端来源名 */
117
+ remoteSource: string;
118
+ /** 响应头 / dev inspector 里显示的本地兜底来源名 */
119
+ fallbackSource: string;
120
+ }
121
+
122
+ /**
123
+ * 动态 SEO 解析器 —— 用于参数化路径(/books/:id / /u/:handle 等)。
124
+ *
125
+ * 设计目标:让业务页面**完全不写 SEO 代码**(不再需要 page export const seo /
126
+ * generateSeo)。所有动态 SEO 在 ssr.config.ts 一处集中声明:
127
+ *
128
+ * runtime.seo.dynamicResolvers = [
129
+ * { pattern: '/books/:id', resolve: async ({ params, services }) => {
130
+ * const r = await fetch(`${services.api}/books/${params.id}`);
131
+ * if (!r.ok) return null;
132
+ * const book = await r.json();
133
+ * return { title: book.title, description: book.synopsis, ... };
134
+ * }
135
+ * },
136
+ * ];
137
+ *
138
+ * 解析顺序(高 → 低):
139
+ * 1. admin endpoint 命中(运营在 dashboard 给具体 path 配过的覆盖)
140
+ * 2. dynamicResolvers pattern 匹配(业务侧请求期数据驱动)
141
+ * 3. fallbackLocal exact path 命中
142
+ * 4. 都没 → null(前端 head 走默认)
143
+ */
144
+ export interface DynamicSeoResolver {
145
+ /**
146
+ * 路径 pattern。支持 `:name` 命名参数(贪婪到 `/`)和 `*` 通配后缀。
147
+ * 例:`/books/:id`、`/u/:handle`、`/dashboard/*`
148
+ */
149
+ pattern: string;
150
+ /**
151
+ * 命中后的 resolver。返回 PageSeoMeta(平铺)或 null。
152
+ * 抛错会被引擎吞掉并写到 onError,不会导致 SSR 失败。
153
+ *
154
+ * input.params 包含 pattern 里 :name 解析出的值。
155
+ * input.locale 是当前请求 locale(可能 undefined,特别是没启 i18n 时)。
156
+ * input.services / input.runtime 给到完整 runtime context,可拿 api origin。
157
+ */
158
+ resolve: (input: {
159
+ pathname: string;
160
+ params: Record<string, string>;
161
+ locale?: string;
162
+ services: { api?: string; telemetry?: string };
163
+ }) => Promise<Record<string, unknown> | null> | Record<string, unknown> | null;
164
+ }
165
+
166
+ export interface RuntimeSeoConfig {
167
+ /** 远端 SEO 端点;支持 {pathname} */
168
+ endpoint: string | undefined;
169
+ /** 本地兜底 SEO 路由表;配置 API 不可用时使用 */
170
+ fallbackLocal: readonly Record<string, unknown>[] | undefined;
171
+ /** SEO 元数据缓存 TTL(毫秒) */
172
+ ttl: number;
173
+ /** 远端请求超时(毫秒) */
174
+ timeoutMs: number;
175
+ /**
176
+ * 参数化路径的 SEO 解析器。
177
+ * admin endpoint / fallbackLocal 是 path 完全匹配的,无法处理 /books/:id
178
+ * 这种动态路径;这里集中声明所有动态路径的 SEO 拼装逻辑,业务页面不再写
179
+ * generateSeo。详见 DynamicSeoResolver 注释。
180
+ */
181
+ dynamicResolvers: readonly DynamicSeoResolver[] | undefined;
182
+ }
183
+
184
+ export interface RuntimeServicesConfig {
185
+ /** 默认后端 API origin;业务数据、配置中心、mock 数据都走这里 */
186
+ api: string | undefined;
187
+ /** telemetry 上报 origin;不配置时回退到 api,同源部署可留空 */
188
+ telemetry: string | undefined;
189
+ }
190
+
191
+ /**
192
+ * 浏览器侧 telemetry endpoint 公共配置 ——
193
+ *
194
+ * 业务真正需要决定的只有两件事:
195
+ * - endpoint:往哪发(每个 app 自己的 admin / collector 地址)
196
+ * - sampleRate:采多少(成本 vs 可见度)
197
+ *
198
+ * 砍掉的 batchSize / flushIntervalMs / maxQueueSize / retryBaseDelayMs / retryMaxDelayMs:
199
+ * 不是业务决策,是 SDK 内部参数。engine 在 client serializer 里给业界默认值
200
+ * (batch=20/10、flush=3s、queue=500/200、retry=1s..30s 指数退避),跟 Sentry /
201
+ * Datadog SDK 同档;要调整这些非业务侧关心,应该是 SDK 层面而不是 ssr.config.ts。
202
+ */
203
+ export interface RuntimeTelemetryEndpointOptions {
204
+ /** 远端上报地址;相对路径会拼到 services.telemetry/api 上 */
205
+ endpoint: string | undefined;
206
+ /** 采样率,0..1;1 = 全采 */
207
+ sampleRate: number;
208
+ }
209
+
210
+ export interface RuntimeTelemetryEventsConfig extends RuntimeTelemetryEndpointOptions {
211
+ /** 是否自动上报首屏 page_view;默认 true */
212
+ trackInitialPage: boolean;
213
+ }
214
+
215
+ export interface RuntimeTelemetryErrorsConfig extends RuntimeTelemetryEndpointOptions {
216
+ /** 是否采集 script/link/img 等资源加载失败;默认 true */
217
+ captureResourceErrors: boolean;
218
+ }
219
+
220
+ export interface RuntimeTelemetryWebVitalsConfig {
221
+ /** 是否自动采集 Web Vitals;覆盖 FCP/LCP/CLS/INP/TTFB 等前端体验指标 */
222
+ enabled: boolean;
223
+ }
224
+
225
+ export interface RuntimeTelemetrySentryIntegrationConfig {
226
+ /** 是否启用 Sentry integration;默认 false,避免仅配置环境变量就隐式接入第三方平台 */
227
+ enabled: boolean;
228
+ /** Sentry DSN;enabled=true 但不配置时 engine 会跳过 adapter 并记录 warn */
229
+ dsn: string | undefined;
230
+ tracesSampleRate: number | undefined;
231
+ environment: string | undefined;
232
+ release: string | undefined;
233
+ }
234
+
235
+ export interface RuntimeTelemetryDatadogExporterConfig {
236
+ type: 'datadog';
237
+ name: string | undefined;
238
+ required: boolean | undefined;
239
+ service: string | undefined;
240
+ }
241
+
242
+ export interface RuntimeTelemetryOtelExporterConfig {
243
+ type: 'otel';
244
+ name: string | undefined;
245
+ required: boolean | undefined;
246
+ endpoint: string | undefined;
247
+ serviceName: string | undefined;
248
+ }
249
+
250
+ export type RuntimeTelemetryExporterConfig =
251
+ | RuntimeTelemetryDatadogExporterConfig
252
+ | RuntimeTelemetryOtelExporterConfig;
253
+
254
+ export interface RuntimeTelemetryIntegrationsConfig {
255
+ /**
256
+ * Sentry 是完整第三方监控平台 integration,不是普通 HTTP endpoint。
257
+ *
258
+ * 语义:
259
+ * - events/errors endpoint 是第一方 HTTP 上报的唯一真值源。
260
+ * - integration 和 exporters 可同时启用,用于迁移、双写或第一方数据仓库 + Sentry 排障并存。
261
+ * - 如果只想二选一,显式关闭不需要的 exporter 或 integration;engine 不做隐式替换。
262
+ *
263
+ * SDK / issue grouping / source map / release health / performance 都在这一层。
264
+ */
265
+ sentry: RuntimeTelemetrySentryIntegrationConfig | undefined;
266
+ }
267
+
268
+ export interface RuntimeTelemetryConfig {
269
+ /** 应用名;不配置时读取 package.json name */
270
+ app: string | undefined;
271
+ /** 发布版本,用于错误归因和发布影响分析 */
272
+ release: string | undefined;
273
+ /** 当前环境:development/staging/production */
274
+ environment: string | undefined;
275
+ /** 是否把 query string 纳入 URL;默认 false,避免采集敏感参数 */
276
+ includeQueryString: boolean;
277
+ /** 前端事件/PV 埋点配置;false 表示关闭 events */
278
+ events: false | RuntimeTelemetryEventsConfig;
279
+ /** 前端错误上报配置;false 表示关闭 errors */
280
+ errors: false | RuntimeTelemetryErrorsConfig;
281
+ /** Web Vitals 配置;false 表示关闭性能指标 */
282
+ webVitals: false | RuntimeTelemetryWebVitalsConfig;
283
+ /**
284
+ * 额外 collector 出口。第一方 HTTP 上报不放这里,唯一真值源是
285
+ * events.endpoint / errors.endpoint,避免同一个地址配置两遍。
286
+ * 当前没有 Datadog/OTel collector 时应保持 [];Sentry 这类完整 SDK 平台放
287
+ * integrations,不降级为普通 exporter。
288
+ */
289
+ exporters: readonly RuntimeTelemetryExporterConfig[];
290
+ /** 第三方平台集成,和第一方 endpoint telemetry 并列挂在 telemetry 下面 */
291
+ integrations: RuntimeTelemetryIntegrationsConfig;
292
+ }
293
+
294
+ /**
295
+ * 平台运行时配置。
296
+ *
297
+ * 第一性原则:
298
+ * - 启动期 / 部署期 / 平台级能力放 ssr.config.ts 的 runtime
299
+ * - 请求期业务逻辑仍放 entry.server.tsx hooks
300
+ */
301
+ export interface RuntimeConfig {
302
+ /** 图片优化允许的精确远程 host[:port],默认禁止远程源;私网始终禁止。 */
303
+ images?: { remoteAllowlist?: string[] };
304
+ /** 站点公网 base URL,用于 SEO canonical / sitemap / robots */
305
+ site: string | undefined;
306
+ /**
307
+ * Cookie 跨子域共享的 Domain 属性。
308
+ *
309
+ * 用法:
310
+ * - **子域分发部署**(www.x / admin.x / api.x):设 `.your-domain.com`
311
+ * —— engine 写 anon cookie 时带 `Domain=.your-domain.com`,浏览器自动
312
+ * 带到所有子域;SSR 在 www 写、API 在 api 读、客户端在 www 读都拿得到。
313
+ * - **单一域名**(path-based routing):留空 undefined,cookie 关联当前 host
314
+ * 即可,更严格的 same-origin。
315
+ * - **localhost**:留空。浏览器对 `Domain=localhost` 处理不一致,反而出问题
316
+ */
317
+ cookieDomain?: string;
318
+ /**
319
+ * ISR 缓存按 Host 隔离。
320
+ *
321
+ * 用法:
322
+ * - **多域名打到同一 SSR 进程**(按域名出不同内容:白标站 / 渠道站 /
323
+ * tenant-by-domain):必须设 true —— cache key 追加 `|h=<host>`,
324
+ * `a.com/books` 与 `b.com/books` 各自独立缓存,不会跨站串内容。
325
+ * - **单一站点**(一个进程只服务一个域名,业界默认形态):留 false/undefined,
326
+ * 避免 www/裸域/内网探活等多个 Host 别名造成缓存碎片化。
327
+ *
328
+ * `revalidatePath` 失效不区分 host —— 清除该路径所有 host 的条目。
329
+ */
330
+ hostIsolation?: boolean;
331
+ /** 按职责拆开的后端服务 origin */
332
+ services: RuntimeServicesConfig;
333
+ /** 分布式 ISR 缓存与跨实例失效广播 */
334
+ redis: RuntimeRedisConfig | undefined;
335
+ /** A/B testing / experimentation 定义,供 getVariant() 在 Server Component 中读取 */
336
+ experiments: Record<string, RuntimeExperimentConfig>;
337
+ /** 实验定义从 admin-server 动态拉取(manifest);不配则只用 experiments 静态配置 */
338
+ experimentManifest?: RuntimeExperimentManifestConfig;
339
+ /** 曝光事件上报(server-side fire-and-forget);不配则不上报 */
340
+ experimentTracking?: RuntimeExperimentTrackingConfig;
341
+ /** i18n 字典源配置;请求期加载由 engine 默认 SiteHooks 消费 */
342
+ i18n: RuntimeI18nConfig | undefined;
343
+ /** 页面 SEO 元数据源配置;站点 canonical/sitemap base URL 统一来自 runtime.site */
344
+ seo: RuntimeSeoConfig | undefined;
345
+ /**
346
+ * telemetry 上报配置。engine 会把浏览器安全子集序列化到 client entry,
347
+ * 自动接入 page_view、Web Vitals、全局错误、资源加载失败、Server Action 错误;
348
+ * 服务端渲染异常会通过同一个 errors endpoint 非阻塞上报。
349
+ */
350
+ telemetry: false | RuntimeTelemetryConfig;
351
+ }
352
+
353
+ export const RenderModes = {
354
+ SSG: 'ssg' as const, // 构建期预生成,运行时按 TTL / revalidate 重生
355
+ ISR: 'isr' as const, // 运行时缓存 + TTL + SWR
356
+ SSR: 'ssr' as const, // 不缓存,每次实时跑管线
357
+ } as const;
358
+
359
+ // 内部渲染策略 (不向用户暴露)
360
+ export const InternalStrategies = {
361
+ STATIC: 'static' as const, // 服务预构建文件(SSG)
362
+ CACHED: 'cached' as const, // 从 ISR 缓存服务
363
+ REGENERATE: 'regenerate' as const, // ISR 重新生成
364
+ SERVER: 'server' as const, // 实时跑管线(SSR / 中间兜底)
365
+ CSR_SHELL: 'csr-shell' as const, // 最后兜底:返回壳 HTML,浏览器自救
366
+ } as const;
367
+
368
+ /**
369
+ * 自动降级链 —— 路由 mode 决定优先尝试哪些策略,失败逐级往下
370
+ * 所有链路最末端都是 'csr-shell',保证 server 完全崩溃时浏览器仍能拿到壳 HTML
371
+ *
372
+ * 例:mode=isr 的请求处理顺序
373
+ * 1. cached ── 命中 LRU → 直接回放
374
+ * 2. regenerate ── miss / stale → 跑管线 + 入缓存
375
+ * 3. server ── 缓存层崩溃 → 实时跑管线(不入缓存)
376
+ * 4. csr-shell ── 管线本身抛异常 → 返回壳 HTML,浏览器接管
377
+ */
378
+ export const FallbackChain: Record<RenderModeType, InternalStrategyType[]> = {
379
+ isr: ['cached', 'regenerate', 'server', 'csr-shell'],
380
+ ssg: ['static', 'regenerate', 'server', 'csr-shell'],
381
+ ssr: ['server', 'csr-shell'],
382
+ };
383
+
384
+ // 配置接口定义
385
+ // 主配置接口
386
+ /** Express-compatible policy for determining whether a remote proxy is trusted. */
387
+ export type ProxyTrustPolicy =
388
+ | boolean
389
+ | number
390
+ | string
391
+ | string[]
392
+ | ((address: string, hop: number) => boolean);
393
+
394
+ export interface ISRConfig {
395
+ /** 全局默认渲染模式 */
396
+ renderMode: RenderModeType;
397
+
398
+ /**
399
+ * 路由级别覆盖配置。
400
+ * 没有覆盖时显式写 `{}`,这样 ssr.config.ts 不存在隐藏默认值。
401
+ * 支持通配符匹配:'/posts/*' 匹配所有 /posts/ 开头的路由
402
+ * 支持动态路由:'/post/:id' 匹配 /post/123 等
403
+ *
404
+ * @example
405
+ * ```ts
406
+ * routes: {
407
+ * '/': 'ssg', // 首页使用 SSG
408
+ * '/admin/*': 'ssr', // 管理后台使用 SSR
409
+ * }
410
+ * ```
411
+ */
412
+ routes: Record<string, RouteRule>;
413
+
414
+ /**
415
+ * 平台运行时配置。
416
+ *
417
+ * 这些是稳定的部署/启动配置,成熟项目应放在 ssr.config.ts,而不是散落在
418
+ * entry.server.tsx 里。entry.server.tsx 只负责如何在请求期使用这些配置。
419
+ */
420
+ runtime: RuntimeConfig;
421
+
422
+ /*
423
+ * No public `cache` field by design.
424
+ *
425
+ * Page cache backend selection is derived from explicit runtime.redis:
426
+ * - runtime.redis.url/host => L1 memory + L2 Redis
427
+ * - no Redis connection => in-process memory
428
+ *
429
+ * Page TTL belongs to routes[*].ttl or top-level revalidate. Keeping backend and TTL
430
+ * in separate product-level fields avoids asking every business app to know
431
+ * cache-store internals.
432
+ */
433
+
434
+ /**
435
+ * 全局默认页面缓存 TTL(秒)。
436
+ *
437
+ * routes[*].ttl 优先;未声明路由级 TTL 时使用这里。
438
+ * 这是产品层缓存新鲜度,不是 Redis/memory 后端配置。
439
+ */
440
+ revalidate: number;
441
+
442
+ server: {
443
+ /**
444
+ * Express trust proxy policy. Defaults to false: ignore forwarded protocol/IP.
445
+ * Behind a proxy, explicitly configure trusted addresses/CIDRs (e.g. 'loopback').
446
+ * Hop counts/true require an ingress that overwrites client forwarded headers.
447
+ */
448
+ trustProxy?: ProxyTrustPolicy;
449
+ /** Node origin 监听端口;缺省 3000。 */
450
+ port: number;
451
+ /** Node origin 监听地址;通常本地留空,容器/内网按部署平台注入。 */
452
+ host: string | undefined;
453
+ /**
454
+ * 端口严格模式。
455
+ *
456
+ * - true:端口被占用时启动失败,适合生产 / 容器 / CI,避免服务悄悄跑到错误端口。
457
+ * - false:端口被占用时最多尝试后续 20 个端口,适合本地 dev。
458
+ *
459
+ * 不配置时 engine 默认 dev=false、prod=true;成熟业务建议在 ssr.config.ts 显式写出。
460
+ */
461
+ strictPort: boolean;
462
+ /**
463
+ * 运维端点暴露策略。
464
+ *
465
+ * 公开配置保留稳定运维边界:
466
+ * - /health:健康检查,默认启用且公开
467
+ * - /metrics:Prometheus 文本指标,默认关闭;生产开启时建议配置 authToken
468
+ * - /__isr/cache/inventory:当前 L1 缓存条目元数据 + 最近 invalidate 时间。
469
+ * dev 默认 public 开放;prod 默认 enabled + 强制 authToken(故障诊断工具
470
+ * 事故来时才用,常驻必要 —— 没 token 时 resolveOpsConfig 自动 disable 且出 warning)。
471
+ *
472
+ * 长期指标 / 报警 / 可视化由 Prometheus + Grafana 承担,engine 不做。
473
+ */
474
+ ops: {
475
+ /** 共享运维口令;接受 `Authorization: Bearer <token>` 或 tokenHeader 指定 header */
476
+ authToken: string | undefined;
477
+ /** 自定义 header 名,默认 `x-isr-admin-token` */
478
+ tokenHeader: string;
479
+ health: {
480
+ enabled: boolean;
481
+ public: boolean;
482
+ };
483
+ metrics: {
484
+ enabled: boolean;
485
+ public: boolean;
486
+ };
487
+ inventory: {
488
+ enabled: boolean;
489
+ public: boolean;
490
+ };
491
+ };
492
+ };
493
+
494
+ /** SSG 预生成配置 */
495
+ ssg: {
496
+ /** 显式 SSG 路由列表(可选,优先级高于 routes 中 mode=ssg 的条目) */
497
+ routes: readonly string[] | (() => readonly string[] | Promise<readonly string[]>);
498
+ /** 并发度,默认 3 */
499
+ concurrent: number;
500
+ /** 单页请求超时毫秒,默认 30_000;防 hang 拖死整个 build */
501
+ requestTimeoutMs: number;
502
+ /** 单页最大重试次数(不含首次),默认 3;只重试 timeout/network/5xx,不重试 4xx */
503
+ maxRetries: number;
504
+ /** 重试初始退避毫秒,默认 200;指数退避 = base * 2^(N-1) */
505
+ retryBaseDelayMs: number;
506
+ /**
507
+ * 整体失败率阈值(0-1),默认 0.05(5%);超过则 build 失败。
508
+ * 设 1.0 关闭(不推荐——会 mask 真实问题)。设 0 = 任何失败都 fail build。
509
+ */
510
+ failBuildThreshold: number;
511
+ };
512
+ }