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,42 @@
1
+ import * as ReactDOM from 'react-dom';
2
+
3
+ const PINNED_REACT_DOM_VERSION = '19.3.0-canary-bd6ea412-20260824';
4
+
5
+ interface ReactDomResourceDispatcher {
6
+ S(href: string, precedence: string | undefined, options?: { media?: string }): void;
7
+ }
8
+
9
+ export type DevStyleResourcePrecedence =
10
+ | 'vite-rsc/client-reference'
11
+ | 'vite-rsc/importer-resources';
12
+
13
+ interface PinnedReactDomModule {
14
+ version: string;
15
+ __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE: {
16
+ d: ReactDomResourceDispatcher;
17
+ };
18
+ }
19
+
20
+ function pinnedResourceDispatcher(): ReactDomResourceDispatcher {
21
+ const module = ReactDOM as unknown as Partial<PinnedReactDomModule>;
22
+ const dispatcher = module.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE?.d;
23
+ if (module.version !== PINNED_REACT_DOM_VERSION || typeof dispatcher?.S !== 'function') {
24
+ throw new Error(
25
+ `[isr-engine] Development CSS transport requires react-dom ${PINNED_REACT_DOM_VERSION} ` +
26
+ 'with the pinned stylesheet resource dispatcher shape.'
27
+ );
28
+ }
29
+ return dispatcher;
30
+ }
31
+
32
+ export function assertPinnedDevStyleResourceDispatcher(): void {
33
+ pinnedResourceDispatcher();
34
+ }
35
+
36
+ export function emitDevStylesheetResource(
37
+ href: string,
38
+ precedence: DevStyleResourcePrecedence,
39
+ media?: string
40
+ ): void {
41
+ pinnedResourceDispatcher().S(href, precedence, media === undefined ? undefined : { media });
42
+ }
@@ -0,0 +1,5 @@
1
+ /**
2
+ * 空 config stub —— 用户没提供 src/entry.server.tsx 或 src/entry.tsx 时
3
+ * 由 createIsrPlugin 把 alias 指向本文件,让 wrapper 走纯默认行为
4
+ */
5
+ export default {};
@@ -0,0 +1,2 @@
1
+ /** Empty route manifest stub for apps that do not use defineRoutes. */
2
+ export {};
@@ -0,0 +1,35 @@
1
+ /* 全局错误边界 fallback 页面 —— 整个 <body> 接管,不依赖业务样式
2
+ * 用平面 CSS(无 sass 依赖),让 engine 对消费方零额外依赖。 */
3
+ .eb-body {
4
+ min-height: 100vh;
5
+ display: flex;
6
+ flex-direction: column;
7
+ place-content: center;
8
+ place-items: center;
9
+ font-family:
10
+ system-ui,
11
+ -apple-system,
12
+ 'PingFang SC',
13
+ sans-serif;
14
+ padding: 2rem;
15
+ gap: 1rem;
16
+ }
17
+
18
+ .eb-title {
19
+ margin: 0;
20
+ }
21
+
22
+ .eb-message {
23
+ max-width: 600px;
24
+ white-space: pre-wrap;
25
+ color: #b00020;
26
+ margin: 0;
27
+ }
28
+
29
+ .eb-retry {
30
+ padding: 0.5rem 1.25rem;
31
+ cursor: pointer;
32
+ border: 1px solid #999;
33
+ border-radius: 4px;
34
+ background: transparent;
35
+ }
@@ -0,0 +1,65 @@
1
+ 'use client';
2
+
3
+ /**
4
+ * 全局错误边界 —— 运行在浏览器环境,捕获 RSC 水合后的渲染异常
5
+ */
6
+ import * as React from 'react';
7
+
8
+ import './error-boundary.style.css';
9
+
10
+ export function GlobalErrorBoundary(props: { children?: React.ReactNode }): React.ReactElement {
11
+ return <ErrorBoundary errorComponent={DefaultGlobalErrorPage}>{props.children}</ErrorBoundary>;
12
+ }
13
+
14
+ interface ErrorComponentProps {
15
+ error: Error;
16
+ reset: () => void;
17
+ }
18
+
19
+ class ErrorBoundary extends React.Component<{
20
+ children?: React.ReactNode;
21
+ errorComponent: React.FC<ErrorComponentProps>;
22
+ }> {
23
+ state: { error?: Error | null } = { error: null };
24
+
25
+ static getDerivedStateFromError(error: Error) {
26
+ return { error };
27
+ }
28
+
29
+ reset = () => {
30
+ this.setState({ error: null });
31
+ };
32
+
33
+ render() {
34
+ const error = this.state.error;
35
+ if (error) {
36
+ return <this.props.errorComponent error={error} reset={this.reset} />;
37
+ }
38
+ return this.props.children;
39
+ }
40
+ }
41
+
42
+ function DefaultGlobalErrorPage(props: ErrorComponentProps) {
43
+ return (
44
+ <html lang='zh-CN'>
45
+ <head>
46
+ <title>渲染异常 · Novel Rating</title>
47
+ </head>
48
+ <body className='eb-body'>
49
+ <h1 className='eb-title'>出错了</h1>
50
+ <pre className='eb-message'>
51
+ {import.meta.env.DEV && props.error?.message ? props.error.message : '发生未知错误'}
52
+ </pre>
53
+ <button
54
+ type='button'
55
+ onClick={() => {
56
+ React.startTransition(() => props.reset());
57
+ }}
58
+ className='eb-retry'
59
+ >
60
+ 重试
61
+ </button>
62
+ </body>
63
+ </html>
64
+ );
65
+ }
@@ -0,0 +1,66 @@
1
+ /**
2
+ * 静态 500 兜底 HTML 模板 —— engine 入口 catch-all 在最坏情况下的最后一道墙。
3
+ *
4
+ * 触发条件:rscHandler 抛错且 SSR / csr-shell 兜底也失败 —— 此时 React 树根本没机会
5
+ * 渲染 GlobalErrorBoundary,必须在 Express 层用纯字符串模板返回一个最小可读页面。
6
+ *
7
+ * 设计:
8
+ * - 零依赖、纯字符串拼接:再差的环境也能渲染(主进程 OOM 后兜底也不会再失败)
9
+ * - 含 traceId:让用户能贴给 support 一查到底;engine 已生成(traceId 必有值)
10
+ * - 不含任何业务文案:不假设业务品牌,业务侧想覆盖直接 monkey-patch 这个函数
11
+ * 或在 reverse proxy / nginx 层用 error_page 替换
12
+ * - 转义 traceId 防 XSS:理论上 traceId 由 engine 生成应安全,但纵深防御
13
+ */
14
+
15
+ /** HTML escape —— 把 traceId 中的 5 个特殊字符替换成 entity */
16
+ function escapeHtml(s: string): string {
17
+ return s
18
+ .replace(/&/g, '&amp;')
19
+ .replace(/</g, '&lt;')
20
+ .replace(/>/g, '&gt;')
21
+ .replace(/"/g, '&quot;')
22
+ .replace(/'/g, '&#39;');
23
+ }
24
+
25
+ /**
26
+ * 渲染 500 兜底页面。
27
+ *
28
+ * @param traceId 用户向 support 反馈时引用的请求标识;engine 入口生成保证非空。
29
+ * 空串 / undefined 显示 'unknown'。
30
+ */
31
+ export function renderError500Html(traceId: string | undefined): string {
32
+ const safeTrace = escapeHtml(traceId && traceId.length > 0 ? traceId : 'unknown');
33
+ return `<!DOCTYPE html>
34
+ <html lang="zh-CN">
35
+ <head>
36
+ <meta charset="UTF-8">
37
+ <meta name="viewport" content="width=device-width,initial-scale=1">
38
+ <meta name="robots" content="noindex,nofollow">
39
+ <title>500 · 服务暂时不可用</title>
40
+ <style>
41
+ *{box-sizing:border-box;margin:0;padding:0}
42
+ html,body{height:100%}
43
+ body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#fafafa;color:#111;display:flex;align-items:center;justify-content:center;padding:24px;line-height:1.5}
44
+ main{max-width:480px;width:100%;background:#fff;border-radius:12px;padding:32px;box-shadow:0 1px 3px rgba(0,0,0,.05),0 1px 2px rgba(0,0,0,.03)}
45
+ h1{font-size:20px;font-weight:600;margin-bottom:8px}
46
+ p{font-size:14px;color:#555;margin-bottom:16px}
47
+ .trace{font-family:ui-monospace,'SF Mono',Menlo,Consolas,monospace;font-size:12px;background:#f4f4f5;color:#333;padding:8px 12px;border-radius:6px;word-break:break-all;user-select:all}
48
+ .actions{margin-top:20px;display:flex;gap:8px}
49
+ a,button{display:inline-block;font-size:14px;padding:8px 14px;border-radius:6px;border:1px solid #d4d4d8;background:#fff;color:#111;text-decoration:none;cursor:pointer;font-family:inherit}
50
+ a:hover,button:hover{background:#f4f4f5}
51
+ </style>
52
+ </head>
53
+ <body>
54
+ <main>
55
+ <h1>服务暂时不可用</h1>
56
+ <p>页面渲染遇到异常。问题已经记录,稍后请重试。</p>
57
+ <p>如果反馈给客服,请附上以下追踪 ID:</p>
58
+ <div class="trace" aria-label="trace id">${safeTrace}</div>
59
+ <div class="actions">
60
+ <a href="/">返回首页</a>
61
+ <button type="button" onclick="location.reload()">重试</button>
62
+ </div>
63
+ </main>
64
+ </body>
65
+ </html>`;
66
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * Head extras 注入 —— SSR HTML stream transformer,在 `<head>` 末尾(即 `</head>` 之前)
3
+ * 把业务侧返回的 raw HTML 插进去。
4
+ *
5
+ * 用途:让业务侧塞 inline blocking script(theme init / GA snippet / A/B flag /
6
+ * CSP nonce 等)到 head,**完全脱离 React 树** —— inline script 不进 client RSC payload,
7
+ * 永远不会触发 React 19 + plugin-rsc 的 "head children mismatch" hydration 错误。
8
+ *
9
+ * 跟 SEO `injectSeoMeta` 同款 stream transformer 模式,区别只在插入位置:
10
+ * - SEO meta 抢首位(浏览器对 `<title>` 单值标签只取第一个) → 插 `<head>` 开标签之后
11
+ * - head extras 是业务自己的脚本,让它最后执行 → 插 `</head>` 之前
12
+ *
13
+ * stream 处理细节跟 SEO 对齐:TextDecoder 流式解码、256 字节滑动窗口防 chunk 切断、
14
+ * 注入一次后直接透传后续 chunk,性能可接受。
15
+ */
16
+
17
+ const HEAD_CLOSE_RE = /<\/head\s*>/i;
18
+
19
+ export function injectHeadExtras(
20
+ source: ReadableStream<Uint8Array>,
21
+ html: string
22
+ ): ReadableStream<Uint8Array> {
23
+ if (!html) return source;
24
+
25
+ const encoder = new TextEncoder();
26
+ const decoder = new TextDecoder('utf-8', { fatal: false });
27
+ const injection = '\n ' + html + '\n ';
28
+
29
+ let buffer = '';
30
+ let injected = false;
31
+ // 防 `</head>` 被切成两段 —— 保留 256 字节滑动窗口
32
+ const SAFE_KEEP = 256;
33
+
34
+ const transform = new TransformStream<Uint8Array, Uint8Array>({
35
+ transform(chunk, controller) {
36
+ if (injected) {
37
+ controller.enqueue(chunk);
38
+ return;
39
+ }
40
+ buffer += decoder.decode(chunk, { stream: true });
41
+ const m = HEAD_CLOSE_RE.exec(buffer);
42
+ if (m) {
43
+ const cutAt = m.index;
44
+ const before = buffer.slice(0, cutAt);
45
+ const after = buffer.slice(cutAt);
46
+ controller.enqueue(encoder.encode(before + injection + after));
47
+ buffer = '';
48
+ injected = true;
49
+ return;
50
+ }
51
+ if (buffer.length > SAFE_KEEP) {
52
+ const emit = buffer.slice(0, buffer.length - SAFE_KEEP);
53
+ buffer = buffer.slice(buffer.length - SAFE_KEEP);
54
+ controller.enqueue(encoder.encode(emit));
55
+ }
56
+ },
57
+ flush(controller) {
58
+ const tail = buffer + decoder.decode();
59
+ if (tail) controller.enqueue(encoder.encode(tail));
60
+ },
61
+ });
62
+
63
+ return source.pipeThrough(transform);
64
+ }
@@ -0,0 +1,20 @@
1
+ 'use client';
2
+
3
+ import * as React from 'react';
4
+
5
+ import { GlobalErrorBoundary } from './error-boundary';
6
+
7
+ /**
8
+ * SSR 与浏览器 hydrate 共用的根包装。
9
+ *
10
+ * React.useId 会把 owner path 编进服务端 id。Radix Tabs/Menu 等组件依赖 useId,
11
+ * 所以服务端 HTML 和客户端 hydrate 必须从同一层根包装开始渲染,否则会出现
12
+ * `aria-controls/id` 前缀不一致的 hydration mismatch。
13
+ */
14
+ export function HydrationShell(props: { children: React.ReactNode }): React.ReactElement {
15
+ return (
16
+ <React.StrictMode>
17
+ <GlobalErrorBoundary>{props.children}</GlobalErrorBoundary>
18
+ </React.StrictMode>
19
+ );
20
+ }
@@ -0,0 +1,27 @@
1
+ import { AsyncLocalStorage } from 'node:async_hooks';
2
+
3
+ import type { IntlPayload } from './seo-runtime';
4
+ import { getI18n, getI18nLocale, registerServerI18nReader } from '../../runtime/i18n-store';
5
+ import { getRequestContext } from '../../context/RequestContext';
6
+
7
+ const store = new AsyncLocalStorage<IntlPayload | null>();
8
+
9
+ export function runWithI18n<T>(intl: IntlPayload | null | undefined, fn: () => T): T {
10
+ return store.run(intl ?? null, fn);
11
+ }
12
+
13
+ export function getCurrentI18n(): IntlPayload | null {
14
+ const scoped = store.getStore();
15
+ if (scoped) return scoped;
16
+ const requestIntl = getRequestContext()?.intl;
17
+ return isIntlPayload(requestIntl) ? requestIntl : null;
18
+ }
19
+
20
+ registerServerI18nReader(getCurrentI18n);
21
+
22
+ export { getI18n, getI18nLocale };
23
+ export type { I18nParams, Translate } from '../../runtime/i18n-store';
24
+
25
+ function isIntlPayload(value: unknown): value is IntlPayload {
26
+ return !!value && typeof value === 'object' && typeof (value as IntlPayload).locale === 'string';
27
+ }
@@ -0,0 +1,80 @@
1
+ const RSC_POSTFIX = '_.rsc';
2
+
3
+ let internalNavigationHistoryMutationDepth = 0;
4
+
5
+ interface BrowserHistoryTarget {
6
+ history: History;
7
+ location: Location;
8
+ }
9
+
10
+ interface ResponseLocation {
11
+ url: string;
12
+ }
13
+
14
+ interface BusinessLocation {
15
+ origin: string;
16
+ pathname: string;
17
+ search: string;
18
+ }
19
+
20
+ function businessLocation(urlString: string): BusinessLocation | undefined {
21
+ try {
22
+ const url = new URL(urlString);
23
+ return {
24
+ origin: url.origin,
25
+ pathname: url.pathname.endsWith(RSC_POSTFIX)
26
+ ? url.pathname.slice(0, -RSC_POSTFIX.length)
27
+ : url.pathname,
28
+ search: url.search,
29
+ };
30
+ } catch {
31
+ return undefined;
32
+ }
33
+ }
34
+
35
+ function sameBusinessLocation(left: BusinessLocation, right: BusinessLocation): boolean {
36
+ return (
37
+ left.origin === right.origin && left.pathname === right.pathname && left.search === right.search
38
+ );
39
+ }
40
+
41
+ export function isInternalNavigationHistoryMutation(): boolean {
42
+ return internalNavigationHistoryMutationDepth > 0;
43
+ }
44
+
45
+ /**
46
+ * Synchronize an accepted server redirect without re-entering the RSC router.
47
+ * A completed non-redirect response, or a redirect for a location the user has
48
+ * already left, must never rewrite browser history.
49
+ */
50
+ export function syncBrowserUrlToFinalRedirect(
51
+ response: ResponseLocation,
52
+ requestedUrl: string,
53
+ browserWindow: BrowserHistoryTarget = window
54
+ ): void {
55
+ if (!response.url) return;
56
+ const requested = businessLocation(requestedUrl);
57
+ const final = businessLocation(response.url);
58
+ const current = businessLocation(browserWindow.location.href);
59
+ if (!requested || !final || !current) return;
60
+
61
+ // No route change on the wire means this was an ordinary response, even if a
62
+ // newer navigation has changed window.location while it was in flight.
63
+ if (sameBusinessLocation(requested, final)) return;
64
+
65
+ // Only the navigation that still owns the address bar may apply its redirect.
66
+ if (!sameBusinessLocation(current, requested) || final.origin !== current.origin) return;
67
+
68
+ internalNavigationHistoryMutationDepth += 1;
69
+ try {
70
+ browserWindow.history.replaceState(
71
+ null,
72
+ '',
73
+ `${final.pathname}${final.search}${browserWindow.location.hash}`
74
+ );
75
+ } catch {
76
+ // Invalid/cross-origin history targets must not break an accepted RSC tree.
77
+ } finally {
78
+ internalNavigationHistoryMutationDepth -= 1;
79
+ }
80
+ }
@@ -0,0 +1,21 @@
1
+ /** Owns route requests only; prefetches and server actions have independent consumers. */
2
+ export function createNavigationRequestLifecycle(): {
3
+ run(operation: (signal: AbortSignal) => Promise<void>): Promise<void>;
4
+ } {
5
+ let pending: AbortController | undefined;
6
+ return {
7
+ async run(operation) {
8
+ pending?.abort();
9
+ const controller = new AbortController();
10
+ pending = controller;
11
+ try {
12
+ await operation(controller.signal);
13
+ } catch (error) {
14
+ if (!controller.signal.aborted) throw error;
15
+ } finally {
16
+ // A completed payload can still own deferred React resources. Do not abort it.
17
+ if (pending === controller) pending = undefined;
18
+ }
19
+ },
20
+ };
21
+ }
@@ -0,0 +1,100 @@
1
+ /**
2
+ * RSC 请求约定 —— 区分 RSC / SSR / Server Action 三类请求
3
+ *
4
+ * 约定:
5
+ * - URL 后缀 `_.rsc` 标识 "仅返回 Flight 流" 的 RSC 请求
6
+ * - 请求头 `x-rsc-action` 携带 Server Action ID
7
+ * - POST + x-rsc-action 代表调用 Server Action(响应为新 Flight 流)
8
+ */
9
+ const URL_POSTFIX = '_.rsc';
10
+ const HEADER_ACTION_ID = 'x-rsc-action';
11
+ const HEADER_DEV_STYLE_GENERATION = 'x-isr-engine-dev-style-generation';
12
+
13
+ export interface RscRenderRequestOptions {
14
+ devStyleGeneration?: number;
15
+ }
16
+
17
+ export type RenderRequest = {
18
+ /** 为 true 时响应纯 Flight 流(text/x-component) */
19
+ isRsc: boolean;
20
+ /** 为 true 时表示 POST 请求(Server Action 调用) */
21
+ isAction: boolean;
22
+ /** Server Action ID(仅 isAction 为 true 时有意义) */
23
+ actionId?: string;
24
+ /** 已去除 `_.rsc` 后缀的规范化请求 */
25
+ request: Request;
26
+ /** 已去除 `_.rsc` 后缀的规范化 URL */
27
+ url: URL;
28
+ /** engine 开发态样式 transport generation;生产请求不携带 */
29
+ devStyleGeneration?: number;
30
+ };
31
+
32
+ /**
33
+ * 客户端构造 RSC 请求(用于导航 / Server Action 调用)
34
+ */
35
+ export function createRscRenderRequest(
36
+ urlString: string,
37
+ action?: { id: string; body: BodyInit },
38
+ options: RscRenderRequestOptions = {}
39
+ ): Request {
40
+ const url = new URL(urlString);
41
+ url.pathname += URL_POSTFIX;
42
+ const headers = new Headers();
43
+ if (action) {
44
+ headers.set(HEADER_ACTION_ID, action.id);
45
+ }
46
+ if (import.meta.env.DEV && options.devStyleGeneration !== undefined) {
47
+ if (!Number.isSafeInteger(options.devStyleGeneration) || options.devStyleGeneration < 0) {
48
+ throw new Error('Invalid development style generation in RSC request.');
49
+ }
50
+ headers.set(HEADER_DEV_STYLE_GENERATION, String(options.devStyleGeneration));
51
+ }
52
+ return new Request(url.toString(), {
53
+ method: action ? 'POST' : 'GET',
54
+ headers,
55
+ body: action?.body,
56
+ });
57
+ }
58
+
59
+ /**
60
+ * 服务端解析入站请求,输出 RenderRequest 描述
61
+ */
62
+ export function parseRenderRequest(request: Request): RenderRequest {
63
+ const url = new URL(request.url);
64
+ const isAction = request.method === 'POST';
65
+ const encodedGeneration = request.headers.get(HEADER_DEV_STYLE_GENERATION);
66
+ let devStyleGeneration: number | undefined;
67
+ if (import.meta.env.DEV && encodedGeneration !== null) {
68
+ if (!/^(?:0|[1-9]\d*)$/.test(encodedGeneration)) {
69
+ throw new Error('Invalid development style generation in RSC request.');
70
+ }
71
+ devStyleGeneration = Number(encodedGeneration);
72
+ if (!Number.isSafeInteger(devStyleGeneration)) {
73
+ throw new Error('Invalid development style generation in RSC request.');
74
+ }
75
+ }
76
+
77
+ if (url.pathname.endsWith(URL_POSTFIX)) {
78
+ url.pathname = url.pathname.slice(0, -URL_POSTFIX.length);
79
+ const actionId = request.headers.get(HEADER_ACTION_ID) || undefined;
80
+ if (isAction && !actionId) {
81
+ throw new Error('Missing x-rsc-action header for RSC action request');
82
+ }
83
+ return {
84
+ isRsc: true,
85
+ isAction,
86
+ actionId,
87
+ request: new Request(url, request),
88
+ url,
89
+ devStyleGeneration,
90
+ };
91
+ }
92
+
93
+ return {
94
+ isRsc: false,
95
+ isAction,
96
+ request,
97
+ url,
98
+ devStyleGeneration,
99
+ };
100
+ }