isr-engine 0.0.0-stage → 1.0.1

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 +170 -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-DGSjHQJd.cjs +105 -0
  100. package/dist/createCacheInspectorMiddleware-DGSjHQJd.cjs.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js +105 -0
  102. package/dist/createCacheInspectorMiddleware-Dmuobpcb.js.map +1 -0
  103. package/dist/createISRApp-CDkyUuW3.js +7321 -0
  104. package/dist/createISRApp-CDkyUuW3.js.map +1 -0
  105. package/dist/createISRApp-Nv9mwX8I.cjs +7662 -0
  106. package/dist/createISRApp-Nv9mwX8I.cjs.map +1 -0
  107. package/dist/createImagePlugin-BVUPlPOz.js +416 -0
  108. package/dist/createImagePlugin-BVUPlPOz.js.map +1 -0
  109. package/dist/createImagePlugin-D-X_HGlR.cjs +435 -0
  110. package/dist/createImagePlugin-D-X_HGlR.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 +199 -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 +837 -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 +41 -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 +507 -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 +17 -0
  452. package/src/utils/trimTrailingSlashes.ts +6 -0
@@ -0,0 +1,1073 @@
1
+ /**
2
+ * defineSiteHooks —— 高阶 FaaS hooks 工厂(声明式配置 → 完整 ServerEntryHooks)
3
+ *
4
+ * 让用户的 src/entry.server.tsx 收紧到「只写请求期 hooks」。
5
+ * 部署/平台配置(api/site/redis/experiments/i18n/seo/telemetry)放
6
+ * ssr.config.ts 的 runtime 字段;entry.server.tsx 只保留 beforeRequest / onError。
7
+ * 注:experiments 是 experimentation platform 的通用字段名,业务侧可理解为 A/B testing。
8
+ * 内部固化:
9
+ * - i18n 字典缓存(createCachedFetcher: TTL/SWR/dedup/fallback)
10
+ * - SEO 路由表 pattern → resolver
11
+ * - locale 检测(cookie → Accept-Language → 默认)
12
+ * - i18n/seo 远端相对 endpoint 统一使用 runtime.services.api
13
+ * - 服务端渲染错误打印 + runtime.telemetry errors endpoint 上报
14
+ *
15
+ * beforeRequest 的边界:
16
+ * - 它在每次 HTTP/RSC 请求进入渲染前执行。
17
+ * - 返回值会合并进 RequestContext,Server Component 用 getRequestContext() 读取。
18
+ * - 适合放 userId / tenantId / requestSegment 这类请求现场字段。
19
+ * - 不适合放 Redis、SEO、i18n、A/B 定义、慢 API 或数据库查询。
20
+ * - A/B variant 由 runtime.experiments + engine middleware 注入,页面用 getVariant()。
21
+ *
22
+ * 用户态写法(商业项目推荐):
23
+ * import { defineAdminSiteHooks } from 'isr-engine/site-hooks';
24
+ *
25
+ * export default defineAdminSiteHooks({
26
+ * beforeRequest: req => ({
27
+ * userId: req.headers.get('x-user-id') ?? undefined,
28
+ * tenantId: req.headers.get('x-tenant-id') ?? 'public',
29
+ * requestSegment: req.headers.get('x-segment') ?? 'default',
30
+ * }),
31
+ * });
32
+ */
33
+ import { trimTrailingSlashes } from '../../utils/trimTrailingSlashes';
34
+ import { createCachedFetcher } from './createCachedFetcher';
35
+ import type { IntlPayload, PageSeoMeta } from './seo-runtime';
36
+ import type {
37
+ DynamicSeoResolver,
38
+ ISRConfig,
39
+ RuntimeI18nConfig,
40
+ RuntimeSeoConfig,
41
+ } from '../../types';
42
+ import { readCookie } from '../../utils/cookie';
43
+ import { parseLocale, type I18nConfig } from '../../runtime/i18n';
44
+
45
+ export { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';
46
+
47
+ export type SiteRuntimeConfig = ISRConfig['runtime'];
48
+
49
+ export interface SiteRuntimeContext {
50
+ runtime: SiteRuntimeConfig;
51
+ services: RuntimeServices;
52
+ telemetry?: string;
53
+ site?: string;
54
+ }
55
+
56
+ export interface RuntimeServices {
57
+ api?: string;
58
+ telemetry?: string;
59
+ }
60
+
61
+ function createEmptyRuntimeConfig(): SiteRuntimeConfig {
62
+ return {
63
+ site: undefined,
64
+ services: { api: undefined, telemetry: undefined },
65
+ redis: undefined,
66
+ experiments: {},
67
+ i18n: undefined,
68
+ seo: undefined,
69
+ telemetry: false,
70
+ };
71
+ }
72
+
73
+ export type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string | null | undefined);
74
+
75
+ export type IntlMessagesByLocale = Record<string, Record<string, unknown>>;
76
+
77
+ export interface CreateAdminIntlLoaderOptions {
78
+ /** 远端字典端点;相对路径会用 runtime.services.api 拼接 */
79
+ endpoint?: string;
80
+ /** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */
81
+ fallbackMessages?: IntlMessagesByLocale;
82
+ /** 远端和本地都无法命中时使用的 locale */
83
+ defaultLocale?: string;
84
+ /** 远端请求超时,默认 1200ms */
85
+ timeoutMs?: number;
86
+ /** 响应头 / dev inspector 里显示的远端来源名 */
87
+ remoteSource?: string;
88
+ /** 响应头 / dev inspector 里显示的 fallback 来源名 */
89
+ fallbackSource?: string;
90
+ }
91
+
92
+ export interface AdminSeoFallbackEntry extends PageSeoMeta {
93
+ path: string;
94
+ group?: string;
95
+ }
96
+
97
+ export interface CreateAdminSeoLoaderOptions {
98
+ /** 远端 SEO 端点;支持 {pathname} 和路由 params 占位符 */
99
+ endpoint?: string;
100
+ /** 本地兜底 SEO 条目,通常来自 ssr.config.ts runtime.seo.fallbackLocal */
101
+ fallbackEntries?: readonly AdminSeoFallbackEntry[];
102
+ /** 远端请求超时,默认 1200ms */
103
+ timeoutMs?: number;
104
+ /**
105
+ * 参数化路径解析器;admin endpoint 没命中且 fallback 也没命中时按 pattern 匹配
106
+ * 调一个用户函数。让业务页面零 SEO 代码,所有动态 SEO 集中在 ssr.config.ts。
107
+ */
108
+ dynamicResolvers?: readonly DynamicSeoResolver[];
109
+ }
110
+
111
+ /**
112
+ * 内部用:把 `/books/:id` 这种 pattern 编译成 RegExp + 参数名列表。
113
+ * `:name` 匹配单段(不跨 /)。`*` 匹配任意后缀(包括 /),收成 ":wildcard" param。
114
+ * 编译后缓存,避免每次请求重算。
115
+ */
116
+ interface CompiledSeoResolver {
117
+ re: RegExp;
118
+ paramNames: string[];
119
+ resolver: DynamicSeoResolver;
120
+ }
121
+
122
+ function compileSeoResolver(resolver: DynamicSeoResolver): CompiledSeoResolver {
123
+ const paramNames: string[] = [];
124
+ const reSrc = resolver.pattern
125
+ .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
126
+ .replace(/:([A-Za-z_][A-Za-z0-9_]*)|\\\*/g, (m, name) => {
127
+ if (m === '\\*') {
128
+ paramNames.push('wildcard');
129
+ return '(.*)';
130
+ }
131
+ paramNames.push(name);
132
+ return '([^/]+)';
133
+ });
134
+ return {
135
+ re: new RegExp(`^${reSrc}$`),
136
+ paramNames,
137
+ resolver,
138
+ };
139
+ }
140
+
141
+ export interface DefineAdminSiteHooksOptions {
142
+ i18n?: {
143
+ locales?: readonly string[];
144
+ defaultLocale?: string;
145
+ endpoint?: string;
146
+ ttl?: number;
147
+ prefixDefault?: boolean;
148
+ detect?: IntlConfig['detect'];
149
+ fallbackLocal?: IntlMessagesByLocale;
150
+ timeoutMs?: number;
151
+ remoteSource?: string;
152
+ fallbackSource?: string;
153
+ };
154
+ seo?: {
155
+ endpoint?: string;
156
+ ttl?: number;
157
+ fallbackLocal?: readonly Record<string, unknown>[];
158
+ timeoutMs?: number;
159
+ /** 参数化路径的 SEO 解析器(参考 RuntimeSeoConfig.dynamicResolvers)。 */
160
+ dynamicResolvers?: readonly DynamicSeoResolver[];
161
+ };
162
+ beforeRequest?: SiteHooksConfig['beforeRequest'];
163
+ onError?: SiteHooksConfig['onError'];
164
+ headExtras?: SiteHooksConfig['headExtras'];
165
+ }
166
+
167
+ export interface IntlConfig {
168
+ // ─── URL 路由层(被 parseLocale / withLocale 等消费)───────────
169
+ /** 支持的 locale 列表,如 ['zh', 'en'];用于 URL 前缀解析 */
170
+ locales?: readonly string[];
171
+ /** 默认 locale —— 必须在 locales 内;同时作为 detect 失败的兜底 */
172
+ defaultLocale?: string;
173
+ /** 默认 locale 是否带 URL 前缀(默认 false:'/about';true:'/zh/about') */
174
+ prefixDefault?: boolean;
175
+
176
+ // ─── 翻译消息加载层(被 SEO/Header 等消费)─────────────────────
177
+ /** 远程 endpoint;`{locale}` 占位符自动替换 */
178
+ endpoint?: string;
179
+ /** 远端响应适配器;支持 admin manifest / SaaS CMS 等非标准响应 */
180
+ transform?: (
181
+ data: unknown,
182
+ locale: string
183
+ ) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;
184
+ /** 本地或自定义加载器;与 endpoint 互斥(优先级更高) */
185
+ load?: (locale: string, ctx: SiteRuntimeContext) => Promise<IntlPayload | null>;
186
+ /** locale 检测(默认:cookie `locale` → Accept-Language 前缀 → defaultLocale) */
187
+ detect?: (req: Request) => string;
188
+ /** 缓存 TTL 毫秒,默认 60_000 */
189
+ ttl?: number;
190
+ }
191
+
192
+ /** 仅静态值,无远程拉取(PageSeoMeta 直接复用,无需扩展) */
193
+ export type SeoStaticEntry = PageSeoMeta;
194
+
195
+ export interface SeoRemoteEntry<T = unknown> {
196
+ /** 远程 endpoint;`{paramName}` 占位符自动替换为路由捕获组 */
197
+ endpoint: string;
198
+ /** 把远程响应转成 PageSeoMeta */
199
+ transform: (data: T, params: Record<string, string>) => PageSeoMeta | null;
200
+ /** 缓存 TTL 毫秒,默认 300_000(5 分钟) */
201
+ ttl?: number;
202
+ }
203
+
204
+ export interface SeoLocalEntry {
205
+ /** 本地加载器:dynamic import / fs.readFile / 内存 Map 都可 */
206
+ load: (
207
+ params: Record<string, string>,
208
+ ctx: SiteRuntimeContext
209
+ ) => Promise<PageSeoMeta | null> | PageSeoMeta | null;
210
+ /** 缓存 TTL 毫秒,默认 300_000 */
211
+ ttl?: number;
212
+ }
213
+
214
+ export type SeoEntry = SeoStaticEntry | SeoRemoteEntry | SeoLocalEntry;
215
+
216
+ export interface SiteHooksConfig {
217
+ /** i18n 配置 */
218
+ intl?: IntlConfig;
219
+ /** SEO 路由表:path pattern(支持 `:param`)→ 静态 meta 或 remote loader */
220
+ seo?: Record<string, SeoEntry | (() => Promise<PageSeoMeta | null> | PageSeoMeta | null)>;
221
+ /**
222
+ * 错误回调。平台默认会先执行 console + runtime.telemetry errors endpoint 上报;
223
+ * 自定义 onError 作为业务补充回调追加执行,不会关闭平台默认上报。
224
+ */
225
+ onError?: (
226
+ err: unknown,
227
+ req: Request,
228
+ ctx: { traceId: string; locale?: string }
229
+ ) => void | Promise<void>;
230
+ /**
231
+ * 请求级 ctx 扩展(除 engine 基线字段 + locale 之外的业务字段)。
232
+ *
233
+ * 典型用途:userId、tenantId、requestSegment、审计字段。
234
+ * 返回值会合并进 RequestContext;Server Component 使用
235
+ * `getRequestContext()` 读取,Client Component 需要由 Server Component
236
+ * 作为 props 传入。
237
+ *
238
+ * 注意:
239
+ * - 这里处在首屏关键路径上,应只做 header/cookie 解析。
240
+ * - 不要在这里查数据库或慢 API。
241
+ * - 不要在这里解析 A/B cookie;页面用 `getVariant()`。
242
+ */
243
+ beforeRequest?: (req: Request) => Record<string, unknown> | Promise<Record<string, unknown>>;
244
+ /**
245
+ * 注入到 `<head>` 末尾(`</head>` 之前)的 raw HTML 字符串。
246
+ *
247
+ * 通过 SSR HTML stream transformer 注入,**完全脱离 React 树** —— 不进 client RSC
248
+ * payload,不触发 React 19 + plugin-rsc 的 head children mismatch hydration 错误。
249
+ *
250
+ * 典型用途:
251
+ * - 主题 init inline blocking script(避免 FOUC,next-themes 同款)
252
+ * - GA / GTM snippet
253
+ * - A/B variant flag injection
254
+ * - CSP nonce / preload hints
255
+ *
256
+ * 业务侧返回完整的标签 HTML(含 `<script>` / `<style>` / `<meta>` 外壳)。返回
257
+ * 空字符串 / undefined 时跳过注入。
258
+ *
259
+ * ctx.nonce:当前请求的 CSP nonce(engine 自动注入)。业务侧的 inline `<script>`
260
+ * 必须带上 nonce 属性,否则被 nonce-based CSP 阻断:
261
+ *
262
+ * ```ts
263
+ * import { THEME_INIT_SCRIPT } from '@app/ui/theme-utils';
264
+ *
265
+ * defineAdminSiteHooks({
266
+ * headExtras: ({ nonce }) =>
267
+ * `<script${nonce ? ` nonce="${nonce}"` : ''}>${THEME_INIT_SCRIPT}</script>`,
268
+ * });
269
+ * ```
270
+ */
271
+ headExtras?: (ctx: { nonce?: string }) => string | undefined;
272
+ }
273
+
274
+ interface CompiledRoute {
275
+ re: RegExp;
276
+ paramNames: string[];
277
+ resolver: (params: Record<string, string>) => Promise<PageSeoMeta | null> | PageSeoMeta | null;
278
+ }
279
+
280
+ /** 把 `/books/:id/reviews/:rid` 编译成 RegExp + 参数名列表 */
281
+ function compilePattern(pattern: string): { re: RegExp; paramNames: string[] } {
282
+ const paramNames: string[] = [];
283
+ const wildcard = pattern.endsWith('/*');
284
+ const base = wildcard ? pattern.slice(0, -2) : pattern;
285
+ const escaped = base.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
286
+ const reSrc = escaped.replace(/:(\w+)/g, (_, name) => {
287
+ paramNames.push(name);
288
+ return '([^/]+)';
289
+ });
290
+ return { re: new RegExp(`^${reSrc}${wildcard ? '(?:/.*)?' : ''}$`), paramNames };
291
+ }
292
+
293
+ function fillTemplate(template: string, vars: Record<string, string>): string {
294
+ return template.replace(/\{(\w+)\}/g, (_, k) => encodeURIComponent(vars[k] ?? ''));
295
+ }
296
+
297
+ export function createAdminIntlLoader(
298
+ options: CreateAdminIntlLoaderOptions = {}
299
+ ): NonNullable<IntlConfig['load']> {
300
+ const endpoint = options.endpoint ?? '/api/i18n/{locale}/manifest';
301
+ const fallbackMessages = options.fallbackMessages ?? {};
302
+ const defaultLocale = options.defaultLocale;
303
+ const supportedLocales = Object.keys(fallbackMessages);
304
+
305
+ return async (locale, ctx) => {
306
+ const normalizedLocale =
307
+ supportedLocales.length && defaultLocale
308
+ ? normalizeLocale(locale, supportedLocales, defaultLocale)
309
+ : locale;
310
+ const remoteUrl = resolveAdminUrl(endpoint, { locale: normalizedLocale }, ctx);
311
+ const remote = remoteUrl
312
+ ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)
313
+ : null;
314
+ const remoteMessages = extractIntlMessagesOrNull(remote);
315
+ const localMessages =
316
+ fallbackMessages[normalizedLocale] ??
317
+ (defaultLocale ? fallbackMessages[defaultLocale] : undefined) ??
318
+ {};
319
+ const messages = remoteMessages ?? normalizeMessages(localMessages);
320
+
321
+ return {
322
+ locale: normalizedLocale,
323
+ messages,
324
+ direction: rtlOf(normalizedLocale),
325
+ source: remoteMessages
326
+ ? (options.remoteSource ?? 'remote')
327
+ : (options.fallbackSource ?? 'local-fallback'),
328
+ };
329
+ };
330
+ }
331
+
332
+ export function createAdminSeoLoader(
333
+ options: CreateAdminSeoLoaderOptions = {}
334
+ ): SeoLocalEntry['load'] {
335
+ const endpoint = options.endpoint ?? '/api/seo?path={pathname}';
336
+ const fallbackEntries = options.fallbackEntries ?? [];
337
+ // 编译一次 + 缓存。N 个 resolver 在每个请求里只是 N 次正则 test,cost 可忽略。
338
+ const compiledResolvers: CompiledSeoResolver[] = (options.dynamicResolvers ?? []).map(
339
+ compileSeoResolver
340
+ );
341
+
342
+ return async (params, ctx) => {
343
+ const pathname = normalizePathname(params.pathname || '/');
344
+
345
+ // 1. admin endpoint —— 运营在 dashboard 给具体 path 配过的覆盖优先级最高
346
+ const remoteUrl = resolveAdminUrl(endpoint, { ...params, pathname }, ctx);
347
+ const remote = remoteUrl
348
+ ? await fetchJsonWithTimeout<unknown>(remoteUrl, options.timeoutMs)
349
+ : null;
350
+ const remoteMeta = extractSeoMetaOrNull(remote);
351
+ if (remoteMeta) return remoteMeta;
352
+
353
+ // 2. dynamic resolvers —— 参数化路径的请求期数据驱动
354
+ if (compiledResolvers.length > 0) {
355
+ for (const compiled of compiledResolvers) {
356
+ const m = pathname.match(compiled.re);
357
+ if (!m) continue;
358
+ const resolverParams: Record<string, string> = {};
359
+ compiled.paramNames.forEach((name, i) => {
360
+ resolverParams[name] = m[i + 1] ?? '';
361
+ });
362
+ try {
363
+ const result = await compiled.resolver.resolve({
364
+ pathname,
365
+ params: resolverParams,
366
+ locale: typeof params.locale === 'string' ? params.locale : undefined,
367
+ services: ctx.services,
368
+ });
369
+ if (result) return result as PageSeoMeta;
370
+ } catch (err) {
371
+ // resolver 抛错不阻塞渲染:业务异常时把 SEO 当 null 处理
372
+ console.warn('[seo] dynamic resolver threw, falling through to fallback', err);
373
+ }
374
+ // 同 pattern 没命中数据就继续找下一个 resolver / fallback;不退出。
375
+ // 例:/books/:id 解析失败时,可能匹配了更宽的 /:scope/:id resolver 兜底。
376
+ }
377
+ }
378
+
379
+ // 3. fallbackLocal —— build 期冻结的兜底
380
+ const fallback = fallbackEntries.find(entry => normalizePathname(entry.path) === pathname);
381
+ if (!fallback) return null;
382
+ const meta = { ...fallback } as Record<string, unknown>;
383
+ delete meta.path;
384
+ delete meta.group;
385
+ return meta as PageSeoMeta;
386
+ };
387
+ }
388
+
389
+ export function defineAdminSiteHooks(options: DefineAdminSiteHooksOptions = {}): ServerHooksOutput {
390
+ return createAdminSiteHooks(options, createEmptyRuntimeConfig());
391
+ }
392
+
393
+ function createAdminSiteHooks(
394
+ options: DefineAdminSiteHooksOptions,
395
+ runtime: SiteRuntimeConfig
396
+ ): ServerHooksOutput {
397
+ const runtimeI18n: Partial<RuntimeI18nConfig> = runtime.i18n ?? {};
398
+ const runtimeSeo: Partial<RuntimeSeoConfig> = runtime.seo ?? {};
399
+ const i18n = options.i18n ?? {};
400
+ const seo = options.seo ?? {};
401
+ const fallbackMessages = i18n.fallbackLocal ?? runtimeI18n.fallbackLocal ?? {};
402
+ const locales =
403
+ i18n.locales ??
404
+ runtimeI18n.locales ??
405
+ (Object.keys(fallbackMessages).length > 0 ? Object.keys(fallbackMessages) : ['en']);
406
+ const defaultLocale = i18n.defaultLocale ?? runtimeI18n.defaultLocale ?? locales[0] ?? 'en';
407
+
408
+ const output = createSiteHooks(
409
+ {
410
+ beforeRequest: options.beforeRequest,
411
+ onError: options.onError,
412
+ headExtras: options.headExtras,
413
+ intl: {
414
+ locales,
415
+ defaultLocale,
416
+ prefixDefault: i18n.prefixDefault ?? runtimeI18n.prefixDefault,
417
+ detect: i18n.detect,
418
+ load: createAdminIntlLoader({
419
+ endpoint: i18n.endpoint ?? runtimeI18n.endpoint,
420
+ fallbackMessages,
421
+ defaultLocale,
422
+ timeoutMs: i18n.timeoutMs ?? runtimeI18n.timeoutMs,
423
+ remoteSource: i18n.remoteSource ?? runtimeI18n.remoteSource,
424
+ fallbackSource: i18n.fallbackSource ?? runtimeI18n.fallbackSource,
425
+ }),
426
+ ttl: i18n.ttl ?? runtimeI18n.ttl ?? 60_000,
427
+ },
428
+ seo: {
429
+ '/*': {
430
+ load: createAdminSeoLoader({
431
+ endpoint: seo.endpoint ?? runtimeSeo.endpoint,
432
+ fallbackEntries: normalizeAdminSeoFallbackEntries(
433
+ seo.fallbackLocal ?? runtimeSeo.fallbackLocal
434
+ ),
435
+ timeoutMs: seo.timeoutMs ?? runtimeSeo.timeoutMs,
436
+ dynamicResolvers: seo.dynamicResolvers ?? runtimeSeo.dynamicResolvers,
437
+ }),
438
+ ttl: seo.ttl ?? runtimeSeo.ttl ?? 60_000,
439
+ },
440
+ },
441
+ },
442
+ runtime
443
+ );
444
+ Object.defineProperty(output, '__configureRuntime', {
445
+ enumerable: false,
446
+ configurable: true,
447
+ value: (nextRuntime: SiteRuntimeConfig) => createAdminSiteHooks(options, nextRuntime),
448
+ });
449
+ return output;
450
+ }
451
+
452
+ export interface ServerHooksOutput {
453
+ /** site URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL */
454
+ siteBaseUrl?: string;
455
+ /** 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__ */
456
+ apiBaseUrl?: string;
457
+ /**
458
+ * 原始 intl 配置(用户在 defineSiteHooks 里写的那份),透传出来给 app.tsx 的 parseLocale 用
459
+ * —— 让 i18n 配置只声明一次,不需要单独 i18n.config.ts
460
+ */
461
+ intl?: IntlConfig;
462
+ beforeRequest: (
463
+ req: Request,
464
+ engineCtx: { traceId: string; startedAt: number }
465
+ ) => Promise<Record<string, unknown>>;
466
+ loadIntl: (req: Request) => Promise<IntlPayload | null>;
467
+ loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;
468
+ onError: (
469
+ err: unknown,
470
+ req: Request,
471
+ ctx: { traceId: string; locale?: string }
472
+ ) => void | Promise<void>;
473
+ /** 注入 `<head>` 末尾的 raw HTML —— 详见 SiteHooksConfig.headExtras 注释 */
474
+ headExtras?: (ctx: { nonce?: string }) => string | undefined;
475
+ __configureRuntime?: (runtime: SiteRuntimeConfig) => ServerHooksOutput;
476
+ }
477
+
478
+ export function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput {
479
+ return createSiteHooks(config, createEmptyRuntimeConfig());
480
+ }
481
+
482
+ export function applyRuntimeToServerHooks<T extends object>(
483
+ hooks: T,
484
+ runtime: SiteRuntimeConfig
485
+ ): T {
486
+ const maybeRuntimeAware = hooks as T & {
487
+ __configureRuntime?: (runtime: SiteRuntimeConfig) => T;
488
+ };
489
+ if (typeof maybeRuntimeAware.__configureRuntime === 'function') {
490
+ return maybeRuntimeAware.__configureRuntime(runtime);
491
+ }
492
+ const baseHooks = hooks as T & {
493
+ siteBaseUrl?: string;
494
+ apiBaseUrl?: string;
495
+ intl?: unknown;
496
+ loadIntl?: unknown;
497
+ loadSeoMeta?: unknown;
498
+ beforeRequest?: SiteHooksConfig['beforeRequest'];
499
+ onError?: SiteHooksConfig['onError'];
500
+ };
501
+ const services = resolveRuntimeServices(runtime);
502
+ const siteBaseUrl = baseHooks.siteBaseUrl ?? runtime.site;
503
+ const apiBaseUrl = baseHooks.apiBaseUrl ?? services.api;
504
+ const hasUserContentHooks =
505
+ !!baseHooks.intl ||
506
+ typeof baseHooks.loadIntl === 'function' ||
507
+ typeof baseHooks.loadSeoMeta === 'function';
508
+
509
+ if (!hasUserContentHooks && hasRuntimeContentConfig(runtime)) {
510
+ const runtimeHooks = createAdminSiteHooks(
511
+ {
512
+ beforeRequest: baseHooks.beforeRequest,
513
+ onError: baseHooks.onError,
514
+ },
515
+ runtime
516
+ );
517
+ return {
518
+ ...hooks,
519
+ siteBaseUrl,
520
+ apiBaseUrl,
521
+ intl: runtimeHooks.intl,
522
+ beforeRequest: runtimeHooks.beforeRequest,
523
+ loadIntl: runtimeHooks.loadIntl,
524
+ loadSeoMeta: runtimeHooks.loadSeoMeta,
525
+ onError: runtimeHooks.onError,
526
+ } as T;
527
+ }
528
+
529
+ return {
530
+ ...hooks,
531
+ siteBaseUrl,
532
+ apiBaseUrl,
533
+ } as T;
534
+ }
535
+
536
+ function createSiteHooks(config: SiteHooksConfig, runtime: SiteRuntimeConfig): ServerHooksOutput {
537
+ const services = resolveRuntimeServices(runtime);
538
+ const api = services.api ?? '';
539
+ const site = runtime.site ?? '';
540
+ const runtimeCtx: SiteRuntimeContext = {
541
+ runtime,
542
+ services,
543
+ telemetry: services.telemetry,
544
+ site: site || undefined,
545
+ };
546
+ const fetchJson = async (path: string, baseUrl?: string): Promise<unknown> => {
547
+ try {
548
+ if (!baseUrl) return null;
549
+ const r = await fetch(baseUrl + path);
550
+ if (!r.ok) return null;
551
+ return await r.json();
552
+ } catch {
553
+ return null;
554
+ }
555
+ };
556
+
557
+ // ─── i18n 缓存(一次创建,请求级复用)──────────────
558
+ const intlCfg = config.intl ?? {};
559
+ const fallbackLocale = intlCfg.defaultLocale ?? 'zh-CN';
560
+ const supportedLocales = intlCfg.locales?.length ? intlCfg.locales : undefined;
561
+ // 默认 detect 优先级(业界标准 i18n 顺序):
562
+ // 1. URL pathname 前缀 /en-US/... → 'en-US' ← 显式路由意图,最高优先级
563
+ // 2. locale cookie ← 用户手动切换过的偏好
564
+ // 3. Accept-Language 头 ← 浏览器系统语言
565
+ // 4. defaultLocale ← 兜底
566
+ //
567
+ // 关键:前缀路由(prefixDefault:true 等场景)下,URL 是源真值。如果不优先用
568
+ // URL,curl /en-US 但 Accept-Language 是 zh 会被错误降级到 zh-CN,跟用户
569
+ // 明确写在 URL 里的意图相反。
570
+ // 业务侧可通过 intlCfg.detect 完全覆盖(任何 (req) => string 都行)。
571
+ const detectLocale =
572
+ intlCfg.detect ??
573
+ ((req: Request): string => {
574
+ // 1. URL 前缀
575
+ if (supportedLocales) {
576
+ try {
577
+ const pathname = new URL(req.url).pathname;
578
+ // 客户端 RSC 导航 URL 带 `_.rsc` 后缀(如 `/ja_.rsc`),不剥掉的话
579
+ // 首段会变成 `ja_.rsc` 命中不了 locale,从而错误回退到 cookie /
580
+ // Accept-Language / defaultLocale —— 这正是「切换语言必须刷新才生效」
581
+ // 的根因(RSC 导航拿到的 intl 语言与 URL 前缀不一致)。
582
+ const cleanPath = pathname.endsWith('_.rsc')
583
+ ? pathname.slice(0, -'_.rsc'.length) || '/'
584
+ : pathname;
585
+ const first = cleanPath.split('/')[1];
586
+ if (first && supportedLocales.includes(first)) return first;
587
+ } catch {
588
+ // 非法 URL(极少见,比如内部调用喂了相对路径)→ 继续后续策略
589
+ }
590
+ }
591
+ // 2. cookie
592
+ const localeCookie = readCookie(req, 'locale');
593
+ if (localeCookie) {
594
+ return supportedLocales
595
+ ? normalizeLocale(localeCookie, supportedLocales, fallbackLocale)
596
+ : localeCookie;
597
+ }
598
+ // 3. Accept-Language → 4. fallbackLocale
599
+ const accept = req.headers.get('accept-language') ?? '';
600
+ return supportedLocales
601
+ ? normalizeLocale(parseAcceptLanguage(accept), supportedLocales, fallbackLocale)
602
+ : inferLocaleFromAcceptLanguage(accept, fallbackLocale);
603
+ });
604
+
605
+ const intlLoader = createCachedFetcher<string, IntlPayload>({
606
+ key: locale => `intl:${locale}`,
607
+ ttl: intlCfg.ttl ?? 60_000,
608
+ swr: true,
609
+ fetch: async locale => {
610
+ if (intlCfg.load) {
611
+ const r = await intlCfg.load(locale, runtimeCtx);
612
+ return r ?? { locale, messages: {}, direction: rtlOf(locale) };
613
+ }
614
+ if (intlCfg.endpoint) {
615
+ const url = fillTemplate(intlCfg.endpoint, { locale });
616
+ const json = await fetchJson(url, services.api);
617
+ if (json !== null && intlCfg.transform) {
618
+ const transformed = await intlCfg.transform(json, locale);
619
+ if (transformed) {
620
+ return {
621
+ ...transformed,
622
+ direction: transformed.direction ?? rtlOf(transformed.locale),
623
+ };
624
+ }
625
+ }
626
+ return {
627
+ locale,
628
+ messages: extractIntlMessages(json),
629
+ direction: rtlOf(locale),
630
+ };
631
+ }
632
+ return { locale, messages: {}, direction: rtlOf(locale) };
633
+ },
634
+ fallback: locale => ({ locale, messages: {}, direction: rtlOf(locale) }),
635
+ });
636
+
637
+ // ─── SEO 路由表编译 + 远程 loader 缓存(每个 pattern 一份)─────
638
+ const seoRoutes: CompiledRoute[] = [];
639
+ const remoteCaches = new Map<
640
+ string,
641
+ ReturnType<typeof createCachedFetcher<string, PageSeoMeta | null>>
642
+ >();
643
+
644
+ for (const [pattern, value] of Object.entries(config.seo ?? {})) {
645
+ const { re, paramNames } = compilePattern(pattern);
646
+
647
+ if (typeof value === 'function') {
648
+ // 自定义 resolver
649
+ seoRoutes.push({ re, paramNames, resolver: value as CompiledRoute['resolver'] });
650
+ continue;
651
+ }
652
+ if ('endpoint' in value && typeof (value as SeoRemoteEntry).endpoint === 'string') {
653
+ const remote = value as SeoRemoteEntry;
654
+ const cache = createCachedFetcher<string, PageSeoMeta | null>({
655
+ key: paramKey => `seo:${pattern}:${paramKey}`,
656
+ ttl: remote.ttl ?? 300_000,
657
+ fetch: async paramKey => {
658
+ const params = JSON.parse(paramKey) as Record<string, string>;
659
+ const data = await fetchJson(fillTemplate(remote.endpoint, params), services.api);
660
+ if (data === null) return null;
661
+ return remote.transform(data, params);
662
+ },
663
+ fallback: () => null,
664
+ });
665
+ remoteCaches.set(pattern, cache);
666
+ seoRoutes.push({
667
+ re,
668
+ paramNames,
669
+ resolver: params => cache(JSON.stringify(params)),
670
+ });
671
+ continue;
672
+ }
673
+ if ('load' in value && typeof (value as SeoLocalEntry).load === 'function') {
674
+ const local = value as SeoLocalEntry;
675
+ const cache = createCachedFetcher<string, PageSeoMeta | null>({
676
+ key: paramKey => `seo-local:${pattern}:${paramKey}`,
677
+ ttl: local.ttl ?? 300_000,
678
+ fetch: async paramKey => {
679
+ const params = JSON.parse(paramKey) as Record<string, string>;
680
+ return await local.load(params, runtimeCtx);
681
+ },
682
+ fallback: () => null,
683
+ });
684
+ remoteCaches.set(pattern, cache);
685
+ seoRoutes.push({
686
+ re,
687
+ paramNames,
688
+ resolver: params => cache(JSON.stringify(params)),
689
+ });
690
+ continue;
691
+ }
692
+ // 静态 meta
693
+ const staticMeta = value as SeoStaticEntry;
694
+ const withDefaults: PageSeoMeta = {
695
+ ...staticMeta,
696
+ canonical:
697
+ staticMeta.canonical ??
698
+ (site && pattern && pattern !== '/*' ? `${site}${pattern}` : staticMeta.canonical),
699
+ };
700
+ seoRoutes.push({ re, paramNames, resolver: () => withDefaults });
701
+ }
702
+
703
+ // ─── onError ─────
704
+ const platformOnError = createPlatformOnError(runtime, runtimeCtx);
705
+ const onError: ServerHooksOutput['onError'] = async (err, req, ctx) => {
706
+ platformOnError(err, req, ctx);
707
+ if (config.onError) {
708
+ await config.onError(err, req, ctx);
709
+ }
710
+ };
711
+
712
+ const output: ServerHooksOutput = {
713
+ siteBaseUrl: site || undefined,
714
+ apiBaseUrl: api || undefined,
715
+ intl: config.intl,
716
+ headExtras: config.headExtras,
717
+ async beforeRequest(req, _engineCtx) {
718
+ const locale = detectLocale(req);
719
+ const userExt = config.beforeRequest ? await config.beforeRequest(req) : {};
720
+ return { locale, ...userExt };
721
+ },
722
+ async loadIntl(req) {
723
+ return intlLoader(detectLocale(req));
724
+ },
725
+ async loadSeoMeta(req) {
726
+ const url = new URL(req.url);
727
+ const locale = detectLocale(req);
728
+ // 客户端 RSC 导航 fetch 的 URL 带 _.rsc 后缀(详见 defaults/runtime/request.tsx)。
729
+ // 先剥后缀,否则 /zh-CN/books/1_.rsc 永远 match 不到 /books/:id route → seoMeta=null →
730
+ // 客户端导航后 head 不更新。HTML 请求没这个后缀,原行为不变。
731
+ let pathForRouting = url.pathname;
732
+ if (pathForRouting.endsWith('_.rsc')) {
733
+ pathForRouting = pathForRouting.slice(0, -'_.rsc'.length) || '/';
734
+ }
735
+ // SEO 表是按"业务规范路径"('/' / '/books' / '/about')入库的,
736
+ // 不带 locale 前缀。请求 URL 是带前缀的('/en-US/'、'/zh-CN/books'),
737
+ // 直接喂给 admin 查不到。先用 parseLocale 把 locale 段剥掉,
738
+ // 再去 seoRoutes 里匹配 + 调 admin endpoint。
739
+ // 同时 locale 单独传到 resolver params,让 endpoint 模板里 {locale}
740
+ // 占位符能填对应语言(之前那个 fix 留着,跟 strip 配合一起才完整)。
741
+ const intlConfig = config.intl;
742
+ const cleanPath =
743
+ intlConfig?.locales && intlConfig.locales.length > 0
744
+ ? parseLocale(pathForRouting, {
745
+ locales: intlConfig.locales,
746
+ defaultLocale: intlConfig.defaultLocale ?? intlConfig.locales[0]!,
747
+ prefixDefault: intlConfig.prefixDefault,
748
+ } satisfies I18nConfig).pathname
749
+ : pathForRouting;
750
+
751
+ for (const { re, paramNames, resolver } of seoRoutes) {
752
+ const m = cleanPath.match(re);
753
+ if (m) {
754
+ const params: Record<string, string> = {
755
+ pathname: cleanPath,
756
+ locale,
757
+ };
758
+ paramNames.forEach((n, i) => (params[n] = m[i + 1] ?? ''));
759
+ return await resolver(params);
760
+ }
761
+ }
762
+ return null;
763
+ },
764
+ onError,
765
+ };
766
+ Object.defineProperty(output, '__configureRuntime', {
767
+ enumerable: false,
768
+ configurable: true,
769
+ value: (nextRuntime: SiteRuntimeConfig) => createSiteHooks(config, nextRuntime),
770
+ });
771
+ return output;
772
+ }
773
+
774
+ function rtlOf(locale: string): 'ltr' | 'rtl' {
775
+ return /^(ar|he|fa|ur)/.test(locale) ? 'rtl' : 'ltr';
776
+ }
777
+
778
+ function parseAcceptLanguage(accept: string): string {
779
+ let best = '';
780
+ let bestQ = -1;
781
+ for (const part of accept.split(',')) {
782
+ const [rawLocale, ...attrs] = part.trim().split(';');
783
+ if (!rawLocale) continue;
784
+ const qAttr = attrs.find(attr => attr.trim().startsWith('q='));
785
+ const q = qAttr ? Number(qAttr.trim().slice(2)) : 1;
786
+ if (Number.isFinite(q) && q > bestQ) {
787
+ best = rawLocale;
788
+ bestQ = q;
789
+ }
790
+ }
791
+ return best;
792
+ }
793
+
794
+ function inferLocaleFromAcceptLanguage(accept: string, fallbackLocale: string): string {
795
+ const best = parseAcceptLanguage(accept);
796
+ if (!best) return fallbackLocale;
797
+ const primary = best.toLowerCase().split('-')[0];
798
+ if (primary === 'zh') return 'zh-CN';
799
+ if (primary === 'en') return 'en';
800
+ return fallbackLocale;
801
+ }
802
+
803
+ function normalizeLocale(
804
+ value: string,
805
+ supportedLocales: readonly string[],
806
+ fallbackLocale: string
807
+ ): string {
808
+ const lower = value.toLowerCase();
809
+ const exact = supportedLocales.find(locale => locale.toLowerCase() === lower);
810
+ if (exact) return exact;
811
+ const prefix = lower.split('-')[0];
812
+ const byPrefix = supportedLocales.find(locale => locale.toLowerCase().split('-')[0] === prefix);
813
+ return byPrefix ?? fallbackLocale;
814
+ }
815
+
816
+ function extractIntlMessages(data: unknown): Record<string, unknown> {
817
+ return extractIntlMessagesOrNull(data) ?? {};
818
+ }
819
+
820
+ function extractIntlMessagesOrNull(data: unknown): Record<string, unknown> | null {
821
+ if (!data || typeof data !== 'object') return null;
822
+ const raw = data as Record<string, unknown>;
823
+ const dataValue = raw.data;
824
+ const candidate =
825
+ raw.strings ??
826
+ raw.messages ??
827
+ (isRecord(dataValue) && 'strings' in dataValue ? dataValue.strings : dataValue);
828
+ if (!candidate || typeof candidate !== 'object') return null;
829
+ return normalizeMessages(candidate as Record<string, unknown>);
830
+ }
831
+
832
+ function normalizeMessages(messages: Record<string, unknown>): Record<string, unknown> {
833
+ if (isFlatRecord(messages)) {
834
+ return expandDottedRecord(messages);
835
+ }
836
+ return messages;
837
+ }
838
+
839
+ /**
840
+ * 逐层剥 envelope —— admin 在不同分支返回三种 shape:
841
+ * - flat:`{ title, description, ... }`(admin no-locale fast path)
842
+ * - 单层:`{ data: { title, ... } }`(旧版本)
843
+ * - 双层:`{ status, code, data: { data: { title, ... }, version } }`
844
+ * (api-envelope plugin 包了一层,resolvePublic 自己又是 `{ data, version }`,
845
+ * 所以 locale-aware 路径会双层 wrap)
846
+ *
847
+ * 停止条件:候选对象有 `title` / `description`(SEO 形状),或没有 `data` 字段可剥。
848
+ */
849
+ function extractSeoMetaOrNull(data: unknown): PageSeoMeta | null {
850
+ let candidate: unknown = data;
851
+ for (let i = 0; i < 4; i++) {
852
+ if (!isRecord(candidate)) return null;
853
+ if ('title' in candidate || 'description' in candidate) break;
854
+ if ('data' in candidate) {
855
+ candidate = candidate.data;
856
+ continue;
857
+ }
858
+ return null;
859
+ }
860
+ if (!isRecord(candidate)) return null;
861
+ return candidate as PageSeoMeta;
862
+ }
863
+
864
+ function normalizeAdminSeoFallbackEntries(
865
+ entries: readonly Record<string, unknown>[] = []
866
+ ): readonly AdminSeoFallbackEntry[] {
867
+ return entries.filter(
868
+ entry => typeof entry.path === 'string'
869
+ ) as unknown as readonly AdminSeoFallbackEntry[];
870
+ }
871
+
872
+ function createPlatformOnError(
873
+ runtime: SiteRuntimeConfig,
874
+ ctx: SiteRuntimeContext
875
+ ): NonNullable<ServerHooksOutput['onError']> {
876
+ const reportServerError = createServerErrorEndpointReporter(runtime, ctx);
877
+
878
+ return (err, req, errorCtx) => {
879
+ console.error('[onError]', {
880
+ traceId: errorCtx.traceId,
881
+ locale: errorCtx.locale,
882
+ url: req.url,
883
+ msg: err instanceof Error ? err.message : String(err),
884
+ });
885
+ reportServerError?.(err, req, errorCtx);
886
+ };
887
+ }
888
+
889
+ function createServerErrorEndpointReporter(
890
+ runtime: SiteRuntimeConfig,
891
+ ctx: SiteRuntimeContext
892
+ ): ((err: unknown, req: Request, errorCtx: { traceId: string; locale?: string }) => void) | null {
893
+ const config = runtime.telemetry;
894
+ if (config === false || !config || config.errors === false) return null;
895
+
896
+ const errors = config.errors ?? {};
897
+ const endpoint = resolveAdminUrl(errors.endpoint ?? '/api/observability/errors', {}, ctx, {
898
+ baseUrl: runtimeCtx => runtimeCtx.services.telemetry ?? runtimeCtx.services.api,
899
+ });
900
+ if (!endpoint) return null;
901
+
902
+ const app = config.app ?? 'isr-engine-app';
903
+ const release = config.release;
904
+ const environment = config.environment;
905
+ const includeQueryString = config.includeQueryString === true;
906
+
907
+ return (err, req, errorCtx) => {
908
+ const report = normalizeServerErrorReport(err, req, errorCtx, {
909
+ release,
910
+ environment,
911
+ includeQueryString,
912
+ });
913
+
914
+ void fetch(endpoint, {
915
+ method: 'POST',
916
+ headers: {
917
+ 'content-type': 'application/json',
918
+ accept: 'application/json',
919
+ },
920
+ body: JSON.stringify({
921
+ app,
922
+ sentAt: Date.now(),
923
+ reports: [report],
924
+ }),
925
+ signal: typeof AbortSignal !== 'undefined' ? AbortSignal.timeout(1000) : undefined,
926
+ }).catch(() => {
927
+ /* 服务端错误上报不能阻断渲染兜底;失败交给进程日志和外层 adapter */
928
+ });
929
+ };
930
+ }
931
+
932
+ function normalizeServerErrorReport(
933
+ err: unknown,
934
+ req: Request,
935
+ ctx: { traceId: string; locale?: string },
936
+ options: {
937
+ release?: string;
938
+ environment?: string;
939
+ includeQueryString?: boolean;
940
+ }
941
+ ): Record<string, unknown> {
942
+ const error = err instanceof Error ? err : null;
943
+ const message = error?.message || String(err);
944
+ const name = error?.name || 'Error';
945
+ const url = safeRequestPath(req.url, options.includeQueryString);
946
+
947
+ return {
948
+ id: createServerReportId(),
949
+ ts: Date.now(),
950
+ level: 'error',
951
+ message,
952
+ name,
953
+ stack: error?.stack,
954
+ release: options.release,
955
+ environment: options.environment,
956
+ url,
957
+ source: 'server-render',
958
+ tags: {
959
+ traceId: ctx.traceId,
960
+ locale: ctx.locale,
961
+ },
962
+ extra: {
963
+ method: req.method,
964
+ pathname: url.split('?')[0] || '/',
965
+ },
966
+ fingerprint: ['server-render', name, message.slice(0, 160)],
967
+ };
968
+ }
969
+
970
+ function safeRequestPath(rawUrl: string, includeQueryString?: boolean): string {
971
+ try {
972
+ const url = new URL(rawUrl);
973
+ return includeQueryString ? `${url.pathname}${url.search}` : url.pathname;
974
+ } catch {
975
+ return includeQueryString ? rawUrl : '/';
976
+ }
977
+ }
978
+
979
+ function createServerReportId(): string {
980
+ const random =
981
+ typeof crypto !== 'undefined' && 'randomUUID' in crypto
982
+ ? crypto.randomUUID()
983
+ : Math.random().toString(36).slice(2);
984
+ return `srv_${Date.now().toString(36)}_${random}`;
985
+ }
986
+
987
+ async function fetchJsonWithTimeout<T>(url: string, timeoutMs = 1200): Promise<T | null> {
988
+ try {
989
+ const response = await fetch(url, {
990
+ headers: { Accept: 'application/json' },
991
+ signal: timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined,
992
+ });
993
+ if (!response.ok) return null;
994
+ return (await response.json()) as T;
995
+ } catch {
996
+ return null;
997
+ }
998
+ }
999
+
1000
+ function resolveAdminUrl(
1001
+ endpoint: string,
1002
+ vars: Record<string, string>,
1003
+ ctx: SiteRuntimeContext,
1004
+ options: { baseUrl?: RuntimeServiceBase } = {}
1005
+ ): string | null {
1006
+ const filled = fillTemplate(endpoint, vars);
1007
+ if (/^(https?:)?\/\//i.test(filled)) return filled;
1008
+ const base = resolveRuntimeServiceBase(ctx, options.baseUrl);
1009
+ if (!base) return null;
1010
+ return `${trimTrailingSlashes(base)}/${filled.replace(/^\/+/, '')}`;
1011
+ }
1012
+
1013
+ function resolveRuntimeServiceBase(
1014
+ ctx: SiteRuntimeContext,
1015
+ baseUrl?: RuntimeServiceBase
1016
+ ): string | null {
1017
+ if (typeof baseUrl === 'function') {
1018
+ return baseUrl(ctx) ?? null;
1019
+ }
1020
+ if (baseUrl) return baseUrl;
1021
+ return ctx.services.api ?? null;
1022
+ }
1023
+
1024
+ function resolveRuntimeServices(runtime: SiteRuntimeConfig): RuntimeServices {
1025
+ const services = runtime.services ?? {};
1026
+ const api = services.api;
1027
+ return {
1028
+ api,
1029
+ telemetry: services.telemetry ?? api,
1030
+ };
1031
+ }
1032
+
1033
+ function hasRuntimeContentConfig(runtime: SiteRuntimeConfig): boolean {
1034
+ return !!(
1035
+ runtime.i18n?.endpoint ||
1036
+ runtime.i18n?.fallbackLocal ||
1037
+ runtime.seo?.endpoint ||
1038
+ runtime.seo?.fallbackLocal ||
1039
+ runtime.telemetry
1040
+ );
1041
+ }
1042
+
1043
+ function normalizePathname(pathname: string): string {
1044
+ if (pathname === '/') return '/';
1045
+ return trimTrailingSlashes(pathname) || '/';
1046
+ }
1047
+
1048
+ function isRecord(value: unknown): value is Record<string, unknown> {
1049
+ return !!value && typeof value === 'object' && !Array.isArray(value);
1050
+ }
1051
+
1052
+ function isFlatRecord(value: unknown): boolean {
1053
+ if (!value || typeof value !== 'object') return false;
1054
+ return Object.keys(value as Record<string, unknown>).some(key => key.includes('.'));
1055
+ }
1056
+
1057
+ function expandDottedRecord(flat: Record<string, unknown>): Record<string, unknown> {
1058
+ const out: Record<string, unknown> = {};
1059
+ for (const [key, value] of Object.entries(flat)) {
1060
+ const parts = key.split('.');
1061
+ let cur = out;
1062
+ parts.forEach((part, index) => {
1063
+ if (index === parts.length - 1) {
1064
+ cur[part] = value;
1065
+ return;
1066
+ }
1067
+ const next = cur[part];
1068
+ if (!next || typeof next !== 'object') cur[part] = {};
1069
+ cur = cur[part] as Record<string, unknown>;
1070
+ });
1071
+ }
1072
+ return out;
1073
+ }