isr-engine 0.0.0-stage → 1.0.0

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-B32Suct_.js +105 -0
  100. package/dist/createCacheInspectorMiddleware-B32Suct_.js.map +1 -0
  101. package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs +105 -0
  102. package/dist/createCacheInspectorMiddleware-CAzxgGNh.cjs.map +1 -0
  103. package/dist/createISRApp-Bvs5_63N.cjs +7663 -0
  104. package/dist/createISRApp-Bvs5_63N.cjs.map +1 -0
  105. package/dist/createISRApp-CfGFTcw-.js +7322 -0
  106. package/dist/createISRApp-CfGFTcw-.js.map +1 -0
  107. package/dist/createImagePlugin-BHVUkFBd.js +416 -0
  108. package/dist/createImagePlugin-BHVUkFBd.js.map +1 -0
  109. package/dist/createImagePlugin-C-hHZCqj.cjs +435 -0
  110. package/dist/createImagePlugin-C-hHZCqj.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,421 @@
1
+ /**
2
+ * defineServerEntry —— FaaS 风格的服务端入口工厂
3
+ *
4
+ * 用户态写法(覆盖 engine 默认行为):
5
+ *
6
+ * // src/entry.server.tsx
7
+ * import { defineServerEntry } from 'isr-engine/server-entry';
8
+ * export default defineServerEntry({
9
+ * beforeRequest: (req) => ({ traceId: crypto.randomUUID() }),
10
+ * onResponse: (res, ctx) => res.headers.set('x-trace-id', ctx.traceId),
11
+ * onError: (err) => console.error('render failed', err),
12
+ * });
13
+ *
14
+ * 不传任何 hook 时(engine 默认入口的写法):
15
+ *
16
+ * export default defineServerEntry(); // 一行搞定
17
+ *
18
+ * Hook 之外的全部协议细节(RSC / Server Action / SSR loadModule / csr-shell 透传)
19
+ * 由本工厂内部固化实现,用户**不需要**了解或重写。
20
+ */
21
+ import {
22
+ createTemporaryReferenceSet,
23
+ decodeAction,
24
+ decodeFormState,
25
+ decodeReply,
26
+ loadServerAction,
27
+ renderToReadableStream,
28
+ } from '@vitejs/plugin-rsc/rsc';
29
+ import type { ReactFormState } from 'react-dom/client';
30
+
31
+ // @ts-expect-error - @app 别名在 createIsrPlugin 注入;指向用户的 src/app.tsx
32
+ import { App } from '@app/_entry';
33
+ // @app 别名在 createIsrPlugin 注入;评估用户 src/routes.tsx 以注册 page-level SEO
34
+ import '@app/_routes';
35
+
36
+ import { parseRenderRequest } from './request';
37
+ import {
38
+ declareDevClientReferenceStyles,
39
+ runWithDevStyleDeclarationCollection,
40
+ } from './dev-style-declarations.server';
41
+ import { type IntlPayload, type PageSeoMeta, injectSeoMeta, mergePageSeoMeta } from './seo-runtime';
42
+ import { injectHeadExtras } from './head-extras-runtime';
43
+ import { runWithI18n } from './i18n-server';
44
+ import { resolvePageSeoMeta } from '../../runtime/routes';
45
+ import { getRequestContext } from '../../context/RequestContext';
46
+
47
+ interface DefaultRscPayload {
48
+ root: React.ReactNode;
49
+ intl?: IntlPayload | null;
50
+ /**
51
+ * 页面 SEO meta —— 与 intl 对齐的客户端 head 同步通道。
52
+ * 首屏 SSR 通过 injectSeoMeta 把 meta 注入到 HTML 流;客户端 RSC 导航时
53
+ * 单独从 payload 读出来调用 applySeoToDocument 同步 document.title / meta /
54
+ * canonical / og:* / jsonLd —— 不然点链接进新页面 title 不变(hint:上次
55
+ * SSR 注入的 head 不会跟着 React 树重渲染)。
56
+ */
57
+ seoMeta?: PageSeoMeta | null;
58
+ /** 客户端 applySeoToDocument 用来把 canonical / og:image 转绝对 URL */
59
+ siteBaseUrl?: string | null;
60
+ returnValue?: { ok: boolean; data: unknown };
61
+ formState?: ReactFormState;
62
+ }
63
+
64
+ /** 默认始终注入的请求上下文 —— engine 自动维护,不需要用户写代码 */
65
+ export interface EngineRequestContext {
66
+ /** trace-id:从入站头 X-Request-Id / X-Trace-Id 读取,没有则自动生成 */
67
+ traceId: string;
68
+ /** 请求处理起点(毫秒)—— 用于自动算 X-Render-Ms */
69
+ startedAt: number;
70
+ }
71
+
72
+ /** 用户 hook 之间共享的请求级上下文(engine 字段 + 用户扩展) */
73
+ export type ServerCtx = EngineRequestContext & Record<string, unknown>;
74
+
75
+ export interface ServerEntryHooks<C extends ServerCtx = ServerCtx> {
76
+ /**
77
+ * 站点根 URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL
78
+ * defineSiteHooks 自动从 site 字段填入;用户也可手动设
79
+ */
80
+ siteBaseUrl?: string;
81
+ /**
82
+ * 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__
83
+ * defineSiteHooks 自动从 api 字段填入;CSR fallback 的 loader 用此 URL 拉数据
84
+ */
85
+ apiBaseUrl?: string;
86
+ /**
87
+ * 请求进入时调用 —— 返回的对象**与 engine 请求上下文合并**作为后续 hook 的 ctx,
88
+ * 同时同步到 RequestContext,Server Component 可用 getRequestContext() 读取。
89
+ *
90
+ * 适用:
91
+ * - 从 header / cookie 解析 userId。
92
+ * - 从域名 / header / 路径解析 tenantId。
93
+ * - 注入 requestSegment、渠道、风控或审计字段。
94
+ *
95
+ * 注意:trace-id 和 startedAt 由 engine 自动维护,**不需要**在这里手动设
96
+ * 注意:A/B variant 由 runtime.experiments + middleware 注入,页面用 getVariant()。
97
+ * 不要在这里解析 ab cookie 或做慢 API / 数据库查询。
98
+ */
99
+ beforeRequest?: (
100
+ request: Request,
101
+ engineCtx: EngineRequestContext
102
+ ) => Partial<C> | Promise<Partial<C>>;
103
+ /**
104
+ * Response 返回前调用 —— 用于追加自定义响应头
105
+ *
106
+ * 注意:x-trace-id 和 x-render-ms 由 engine 自动注入,**不需要**在这里手动加
107
+ */
108
+ onResponse?: (response: Response, ctx: C) => void | Promise<void>;
109
+ /**
110
+ * 渲染抛错时调用 —— 用于上报 / 打点;engine 仍会按 FallbackChain 走 csr-shell
111
+ * 不要在这里返回 Response —— 兜底由 engine 处理
112
+ */
113
+ onError?: (error: unknown, request: Request, ctx: C) => void | Promise<void>;
114
+ /**
115
+ * 单页 i18n 数据加载器 —— 返回值经 RSC payload 序列化到客户端
116
+ *
117
+ * - 返回 null/undefined 时跳过(无 i18n)
118
+ * - engine 把结果作为 `intl` prop 传给 App,并写入 ctx.intl
119
+ * - 推荐用 createCachedFetcher 包装远程 URL;本地 JSON 直接 `import()` 即可
120
+ *
121
+ * @example
122
+ * loadIntl: async (req, ctx) => {
123
+ * const locale = req.headers.get('accept-language')?.split(',')[0] ?? 'en';
124
+ * return loadMessagesCached({ locale }); // 见 createCachedFetcher
125
+ * }
126
+ */
127
+ loadIntl?: (
128
+ request: Request,
129
+ ctx: C
130
+ ) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;
131
+ /**
132
+ * 单页 SEO 元数据加载器 —— engine 在 SSR HTML <head> 里自动注入对应标签
133
+ *
134
+ * - 返回 null/undefined 时不注入(保留 SSR 默认 head)
135
+ * - 用户**不需要**在自己的组件里写 <title>/<meta>
136
+ *
137
+ * @example
138
+ * loadSeoMeta: async (req) => {
139
+ * const url = new URL(req.url);
140
+ * if (url.pathname.startsWith('/books/')) {
141
+ * const book = await fetchBookCached(url.pathname.split('/')[2]);
142
+ * return { title: book.title, description: book.summary, image: book.cover };
143
+ * }
144
+ * return null;
145
+ * }
146
+ */
147
+ loadSeoMeta?: (
148
+ request: Request,
149
+ ctx: C
150
+ ) => PageSeoMeta | null | undefined | Promise<PageSeoMeta | null | undefined>;
151
+ }
152
+
153
+ export interface ServerEntryModule {
154
+ fetch: (request: Request) => Promise<Response>;
155
+ }
156
+
157
+ /** 生成一个紧凑的 trace-id(10 位 base36,约 2^52 / 1e6 = 4.5T 条不重碰)*/
158
+ function genTraceId(): string {
159
+ return `t-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
160
+ }
161
+
162
+ export function defineServerEntry<C extends ServerCtx = ServerCtx>(
163
+ hooks: ServerEntryHooks<C> = {}
164
+ ): ServerEntryModule {
165
+ return {
166
+ async fetch(request) {
167
+ const requestStore = getRequestContext();
168
+
169
+ // ─── engine request context(每个请求自动有)───────────────
170
+ const engineCtx: EngineRequestContext = {
171
+ traceId:
172
+ request.headers.get('x-request-id') ||
173
+ request.headers.get('x-trace-id') ||
174
+ requestStore?.traceId ||
175
+ genTraceId(),
176
+ startedAt: Date.now(),
177
+ };
178
+ let ctx: C = { ...(requestStore ?? {}), ...engineCtx } as C;
179
+
180
+ try {
181
+ if (hooks.beforeRequest) {
182
+ const userExt = (await hooks.beforeRequest(request, engineCtx)) ?? {};
183
+ ctx = { ...(requestStore ?? {}), ...engineCtx, ...userExt } as C;
184
+ }
185
+ if (requestStore) {
186
+ Object.assign(requestStore, ctx);
187
+ }
188
+
189
+ // ─── i18n 先加载并进入请求作用域;SEO 可在 page seo 中直接 getI18n() ─────
190
+ const intl = hooks.loadIntl ? await Promise.resolve(hooks.loadIntl(request, ctx)) : null;
191
+ if (intl) {
192
+ (ctx as ServerCtx).intl = intl;
193
+ if (requestStore) {
194
+ requestStore.intl = intl;
195
+ }
196
+ }
197
+
198
+ const seoMeta = await runWithI18n(intl, async () => {
199
+ // 双 strip:
200
+ // 1) _.rsc 后缀(RSC 客户端导航 URL 携带)—— 不剥的话 /books/1_.rsc
201
+ // 永远 match 不到 /books/:id 路由 → seoMeta=null → applySeoToDocument
202
+ // no-op,客户端导航后 head 不更新。
203
+ // 2) locale 前缀(i18n.prefixDefault=true 时所有 URL 都带)—— pages 注册的
204
+ // route 是业务规范路径('/'、'/books/:id'),不含 locale;不剥的话
205
+ // /zh-CN/books/1 也匹配不到。
206
+ const url = new URL(request.url);
207
+ if (url.pathname.endsWith('_.rsc')) {
208
+ url.pathname = url.pathname.slice(0, -'_.rsc'.length);
209
+ }
210
+ let localePrefix = '';
211
+ if (intl?.locale) {
212
+ localePrefix = `/${intl.locale}`;
213
+ if (url.pathname === localePrefix) {
214
+ url.pathname = '/';
215
+ } else if (url.pathname.startsWith(`${localePrefix}/`)) {
216
+ url.pathname = url.pathname.slice(localePrefix.length);
217
+ }
218
+ }
219
+ const [pageSeoMeta, hookSeoMeta] = await Promise.all([
220
+ resolvePageSeoMeta(url),
221
+ hooks.loadSeoMeta
222
+ ? Promise.resolve(hooks.loadSeoMeta(request, ctx))
223
+ : Promise.resolve(null),
224
+ ]);
225
+ const merged = mergePageSeoMeta(pageSeoMeta, hookSeoMeta);
226
+ // 多语言 canonical 修正:admin 存的 canonical 是规范路径(无 locale),
227
+ // 但页面真实 URL 含 locale 前缀。两个 locale 渲染同一个 canonical →
228
+ // Google 判跨语言 URL 互为重复,只索引根域那一份,其它 locale SEO 死。
229
+ // 这里把当前 locale 前缀重新加回相对 canonical 路径,让每个 locale 的
230
+ // 页面声明自己为 canonical(业界标准多语言 SEO 做法)。
231
+ if (merged && localePrefix && merged.canonical?.startsWith('/')) {
232
+ merged.canonical =
233
+ merged.canonical === '/' ? `${localePrefix}/` : `${localePrefix}${merged.canonical}`;
234
+ }
235
+ return merged;
236
+ });
237
+ if (seoMeta) (ctx as ServerCtx).seoMeta = seoMeta;
238
+
239
+ // headExtras hook 容错:抛错不应阻塞 SSR(业务侧返回值类型 unknown 时安全降级)。
240
+ // 把当前请求的 CSP nonce 透传给业务,让 inline <script> 能带 nonce 通过 CSP。
241
+ let headExtras: string | undefined;
242
+ try {
243
+ const headExtrasNonce = request.headers.get('x-csp-nonce') ?? undefined;
244
+ const raw = hooks.headExtras?.({ nonce: headExtrasNonce });
245
+ if (typeof raw === 'string' && raw.length > 0) headExtras = raw;
246
+ } catch {
247
+ // 业务 hook 异常 → 当作没有 headExtras,继续渲染
248
+ }
249
+
250
+ const response = await runWithI18n(intl, () =>
251
+ runRscPipeline(request, {
252
+ intl,
253
+ seoMeta,
254
+ siteBaseUrl: hooks.siteBaseUrl,
255
+ apiBaseUrl: hooks.apiBaseUrl,
256
+ headExtras,
257
+ })
258
+ );
259
+
260
+ // ─── 自动注入观测头(用户无需写代码)──────────────────
261
+ response.headers.set('x-trace-id', engineCtx.traceId);
262
+ response.headers.set('x-render-ms', String(Date.now() - engineCtx.startedAt));
263
+ if (intl?.locale) response.headers.set('content-language', intl.locale);
264
+ if (intl?.source) response.headers.set('x-i18n-source', intl.source);
265
+
266
+ if (hooks.onResponse) {
267
+ await hooks.onResponse(response, ctx);
268
+ }
269
+ return response;
270
+ } catch (err) {
271
+ if (hooks.onError) {
272
+ try {
273
+ await hooks.onError(err, request, ctx);
274
+ } catch {
275
+ /* hook 内部抛错不能影响兜底 */
276
+ }
277
+ }
278
+ throw err;
279
+ }
280
+ },
281
+ };
282
+ }
283
+
284
+ interface PipelineExtras {
285
+ intl: IntlPayload | null | undefined;
286
+ seoMeta: PageSeoMeta | null | undefined;
287
+ siteBaseUrl?: string;
288
+ apiBaseUrl?: string;
289
+ /** 注入 `<head>` 末尾的 raw HTML(业务侧 site-hooks.headExtras() 的返回值) */
290
+ headExtras?: string;
291
+ }
292
+
293
+ /** 内部固化的 RSC + SSR 协议流水线 —— 用户不可见 */
294
+ async function runRscPipeline(request: Request, extras: PipelineExtras): Promise<Response> {
295
+ const renderRequest = parseRenderRequest(request);
296
+ request = renderRequest.request;
297
+
298
+ let returnValue: DefaultRscPayload['returnValue'] | undefined;
299
+ let formState: ReactFormState | undefined;
300
+ let temporaryReferences: unknown | undefined;
301
+ let actionStatus: number | undefined;
302
+
303
+ if (renderRequest.isAction) {
304
+ if (renderRequest.actionId) {
305
+ const contentType = request.headers.get('content-type');
306
+ const body = contentType?.startsWith('multipart/form-data')
307
+ ? await request.formData()
308
+ : await request.text();
309
+ temporaryReferences = createTemporaryReferenceSet();
310
+ const args = await decodeReply(body, { temporaryReferences });
311
+ const action = await loadServerAction(renderRequest.actionId);
312
+ try {
313
+ const data = await action.apply(null, args);
314
+ returnValue = { ok: true, data };
315
+ } catch (e) {
316
+ returnValue = { ok: false, data: e };
317
+ actionStatus = 500;
318
+ }
319
+ } else {
320
+ const formData = await request.formData();
321
+ const decodedAction = await decodeAction(formData);
322
+ try {
323
+ const result = await decodedAction();
324
+ formState = await decodeFormState(result, formData);
325
+ } catch {
326
+ return new Response('Internal Server Error: server action failed', { status: 500 });
327
+ }
328
+ }
329
+ }
330
+
331
+ const devStyleDeclarations = import.meta.env.DEV ? [] : undefined;
332
+ const rscPayload: DefaultRscPayload = {
333
+ root: <App url={renderRequest.url} intl={extras.intl ?? undefined} />,
334
+ intl: extras.intl ?? null,
335
+ seoMeta: extras.seoMeta ?? null,
336
+ siteBaseUrl: extras.siteBaseUrl ?? null,
337
+ formState,
338
+ returnValue,
339
+ };
340
+ const rscStream = import.meta.env.DEV
341
+ ? runWithDevStyleDeclarationCollection(
342
+ devStyleDeclarations!,
343
+ () =>
344
+ renderToReadableStream<DefaultRscPayload>(
345
+ rscPayload,
346
+ { temporaryReferences },
347
+ {
348
+ onClientReference: declareDevClientReferenceStyles,
349
+ }
350
+ ),
351
+ { transportGeneration: renderRequest.devStyleGeneration }
352
+ )
353
+ : renderToReadableStream<DefaultRscPayload>(rscPayload, { temporaryReferences });
354
+
355
+ if (renderRequest.isRsc) {
356
+ return new Response(rscStream, {
357
+ status: actionStatus,
358
+ headers: { 'content-type': 'text/x-component;charset=utf-8' },
359
+ });
360
+ }
361
+
362
+ interface SsrModule {
363
+ renderHTML: (
364
+ rscStream: ReadableStream<Uint8Array>,
365
+ options: {
366
+ formState?: ReactFormState;
367
+ nonce?: string;
368
+ debugNojs?: boolean;
369
+ forceCsrShell?: boolean;
370
+ apiBaseUrl?: string;
371
+ }
372
+ ) => Promise<{
373
+ stream: ReadableStream<Uint8Array>;
374
+ status?: number;
375
+ csrShellFallback?: boolean;
376
+ }>;
377
+ }
378
+ const ssrEntry = await import.meta.viteRsc.loadModule<SsrModule>('ssr', 'index');
379
+
380
+ // CSP nonce —— 由上游 createCspNonceMiddleware 生成并写到 req header 'x-csp-nonce'。
381
+ // React 19 renderToReadableStream 接 nonce 选项后,自动给所有内联 script (RSC payload、
382
+ // bootstrap、metadata) 打 nonce 属性。再配合 helmet CSP `script-src 'nonce-XXX'`,
383
+ // 整套 nonce-based CSP 闭环;Lighthouse csp-xss 不再判 'unsafe-inline' 高危。
384
+ const cspNonce = request.headers.get('x-csp-nonce') ?? undefined;
385
+
386
+ const ssrResult = await ssrEntry.renderHTML(rscStream, {
387
+ formState,
388
+ nonce: cspNonce,
389
+ debugNojs: renderRequest.url.searchParams.has('__nojs'),
390
+ forceCsrShell: renderRequest.url.searchParams.has('__csr-shell'),
391
+ apiBaseUrl: extras.apiBaseUrl,
392
+ });
393
+
394
+ const responseHeaders = new Headers();
395
+ responseHeaders.set('content-type', 'text/html; charset=utf-8');
396
+ responseHeaders.set('x-render-strategy', ssrResult.csrShellFallback ? 'csr-shell' : 'rsc-ssr');
397
+ responseHeaders.set('x-fallback-used', ssrResult.csrShellFallback ? 'true' : 'false');
398
+ if (ssrResult.csrShellFallback) {
399
+ responseHeaders.set('x-fallback-target', 'client createRoot fallback shell');
400
+ }
401
+
402
+ // SSR HTML stream pipeline —— 仅在非 csr-shell 兜底时注入(csr-shell 的 head 已固化):
403
+ // 1. SEO meta 抢首位(紧跟 `<head>` 开标签)—— 浏览器对 `<title>` 单值标签只取第一个
404
+ // 2. headExtras 末尾插入(`</head>` 之前)—— 业务侧 site-hooks.headExtras() 返回的
405
+ // raw HTML,典型是 theme init inline blocking script、GA snippet 等
406
+ // 两者都脱离 React 树,不进 client RSC payload,不会触发 hydration mismatch。
407
+ let finalStream = ssrResult.stream;
408
+ if (!ssrResult.csrShellFallback) {
409
+ if (extras.seoMeta) {
410
+ finalStream = injectSeoMeta(finalStream, extras.seoMeta, extras.siteBaseUrl);
411
+ }
412
+ if (extras.headExtras) {
413
+ finalStream = injectHeadExtras(finalStream, extras.headExtras);
414
+ }
415
+ }
416
+
417
+ return new Response(finalStream, {
418
+ status: ssrResult.status,
419
+ headers: responseHeaders,
420
+ });
421
+ }