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,257 @@
1
+ /**
2
+ * 默认 SSR 环境入口(engine 内置)
3
+ *
4
+ * 自动启用条件:用户项目 `<root>/src/entry.ssr.tsx` 不存在时,由 createIsrPlugin
5
+ * 把 plugin-rsc 的 ssr 入口指向本文件。
6
+ *
7
+ * 这是一段纯模板代码 —— 接收 Flight 流,调用 react-dom/server.edge 输出 HTML,
8
+ * 用 rsc-html-stream 把 Flight 内联到 HTML 末尾以供浏览器水合。
9
+ *
10
+ * 用户**不需要**在自己的项目里写这个文件;只有当你需要在 SSR 环境里自定义
11
+ * payload 类型、注入 nonce、定制 fallback HTML 等场景,才在 `<root>/src/`
12
+ * 下放一个同名文件覆盖此默认实现。
13
+ */
14
+ import { createFromReadableStream } from '@vitejs/plugin-rsc/ssr';
15
+ import * as React from 'react';
16
+ import type { ReactFormState } from 'react-dom/client';
17
+ import { renderToReadableStream } from 'react-dom/server.edge';
18
+ import { injectRSCPayload } from 'rsc-html-stream/server';
19
+ import type { IntlPayload } from './runtime/seo-runtime';
20
+ import { setClientI18n } from '../runtime/i18n-store';
21
+ import { HydrationShell } from './runtime/hydration-shell';
22
+ // @ts-expect-error - 虚拟模块由 plugin-rsc 注入
23
+ import assetsManifest from 'virtual:vite-rsc/assets-manifest';
24
+
25
+ /** 收集 manifest 里所有唯一的 CSS 链接(client + server 两边)。
26
+ *
27
+ * 只在 csr-shell fallback 路径使用 —— SSR 抛错后我们不知道原本应该走哪条路由的
28
+ * CSS,所以全量注入兜底。
29
+ *
30
+ * 正常 SSR 路径不走这里:plugin-rsc 为本次渲染使用的 chunk 生成 React
31
+ * stylesheet resource,React 直接输出带 precedence 的 blocking stylesheet。
32
+ */
33
+ function collectAllCss(): string[] {
34
+ const set = new Set<string>();
35
+ const m = assetsManifest as {
36
+ clientReferenceDeps?: Record<string, { css?: string[] }>;
37
+ serverResources?: Record<string, { css?: string[] }>;
38
+ };
39
+ for (const group of [m?.clientReferenceDeps, m?.serverResources]) {
40
+ if (!group) continue;
41
+ for (const id of Object.keys(group)) {
42
+ for (const href of group[id].css ?? []) set.add(href);
43
+ }
44
+ }
45
+ return Array.from(set);
46
+ }
47
+
48
+ interface DefaultRscPayload {
49
+ root: React.ReactNode;
50
+ intl?: IntlPayload | null;
51
+ formState?: ReactFormState;
52
+ returnValue?: { ok: boolean; data: unknown };
53
+ }
54
+
55
+ /** csr-shell fallback 页面的内联样式(自包含,不依赖任何外部 stylesheet)*/
56
+ const CSR_SHELL_STYLES = `
57
+ :root { color-scheme: dark; }
58
+ .csr-shell-body {
59
+ margin: 0;
60
+ background: #111418;
61
+ color: #e7edf4;
62
+ font: 14px Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
63
+ }
64
+ .csr-shell-page {
65
+ display: grid;
66
+ min-height: 100vh;
67
+ place-items: center;
68
+ padding: 32px 20px;
69
+ }
70
+ .csr-shell-card {
71
+ width: min(520px, 100%);
72
+ padding: 28px;
73
+ border: 1px solid rgba(255, 255, 255, 0.12);
74
+ border-radius: 8px;
75
+ background: #171b21;
76
+ box-shadow: 0 24px 80px rgba(0, 0, 0, 0.32);
77
+ }
78
+ .csr-shell-badge {
79
+ display: inline-flex;
80
+ align-items: center;
81
+ height: 24px;
82
+ padding: 0 10px;
83
+ border: 1px solid rgba(125, 211, 252, 0.24);
84
+ border-radius: 999px;
85
+ background: rgba(14, 165, 233, 0.12);
86
+ color: #7dd3fc;
87
+ font-size: 12px;
88
+ font-weight: 700;
89
+ letter-spacing: 0;
90
+ }
91
+ .csr-shell-title {
92
+ margin: 18px 0 8px;
93
+ color: #f8fafc;
94
+ font-size: clamp(24px, 4vw, 34px);
95
+ line-height: 1.15;
96
+ letter-spacing: 0;
97
+ }
98
+ .csr-shell-copy {
99
+ margin: 0;
100
+ color: #aab4c1;
101
+ line-height: 1.7;
102
+ }
103
+ .csr-shell-grid {
104
+ display: grid;
105
+ gap: 10px;
106
+ margin-top: 22px;
107
+ }
108
+ .csr-shell-row {
109
+ display: flex;
110
+ justify-content: space-between;
111
+ gap: 16px;
112
+ padding: 12px;
113
+ border: 1px solid rgba(255, 255, 255, 0.08);
114
+ border-radius: 8px;
115
+ background: rgba(255, 255, 255, 0.04);
116
+ }
117
+ .csr-shell-row span:first-child { color: #8894a3; }
118
+ .csr-shell-row span:last-child { color: #f8fafc; font-weight: 700; text-align: right; }
119
+ .csr-shell-action {
120
+ display: inline-flex;
121
+ align-items: center;
122
+ justify-content: center;
123
+ min-height: 38px;
124
+ margin-top: 22px;
125
+ padding: 0 16px;
126
+ border-radius: 6px;
127
+ background: #f97316;
128
+ color: #111418;
129
+ font-weight: 800;
130
+ text-decoration: none;
131
+ }
132
+ .csr-shell-action:focus-visible {
133
+ outline: 2px solid #fed7aa;
134
+ outline-offset: 2px;
135
+ }
136
+ `;
137
+
138
+ export interface RenderHtmlOptions {
139
+ formState?: ReactFormState;
140
+ nonce?: string;
141
+ /** true 时跳过 bootstrap 脚本和 RSC 内联 payload,模拟禁用 JS 场景 */
142
+ debugNojs?: boolean;
143
+ /** 强制走 csr-shell 兜底(调试用 —— ?__csr-shell=1 触发) */
144
+ forceCsrShell?: boolean;
145
+ /** 浏览器可访问的 API base —— 注入到 csr-shell 让 CSR fallback 能 fetch */
146
+ apiBaseUrl?: string;
147
+ }
148
+
149
+ export interface RenderHtmlResult {
150
+ stream: ReadableStream<Uint8Array>;
151
+ status?: number;
152
+ /** 是否启用了 csr-shell fallback(SSR 渲染崩溃时由本模块自动设置) */
153
+ csrShellFallback?: boolean;
154
+ }
155
+
156
+ export async function renderHTML(
157
+ rscStream: ReadableStream<Uint8Array>,
158
+ options: RenderHtmlOptions = {}
159
+ ): Promise<RenderHtmlResult> {
160
+ const [rscStream1, rscStream2] = rscStream.tee();
161
+
162
+ let payload: Promise<DefaultRscPayload> | undefined;
163
+
164
+ function SsrRoot() {
165
+ payload ??= createFromReadableStream<DefaultRscPayload>(rscStream1);
166
+ const data = React.use(payload);
167
+ setClientI18n(data.intl);
168
+ return data.root;
169
+ }
170
+
171
+ const bootstrapScriptContent = await import.meta.viteRsc.loadBootstrapScriptContent('index');
172
+
173
+ let htmlStream: ReadableStream<Uint8Array>;
174
+ let status: number | undefined;
175
+ let csrShellFallback = false;
176
+
177
+ try {
178
+ if (options.forceCsrShell) throw new Error('forceCsrShell debug flag');
179
+ htmlStream = await renderToReadableStream(
180
+ <HydrationShell>
181
+ <SsrRoot />
182
+ </HydrationShell>,
183
+ {
184
+ bootstrapScriptContent: options.debugNojs ? undefined : bootstrapScriptContent,
185
+ nonce: options.nonce,
186
+ formState: options.formState,
187
+ }
188
+ );
189
+ } catch (err) {
190
+ // FallbackChain 末端 csr-shell:SSR 渲染抛异常 → 不出 5xx 白屏,
191
+ // 改返回最小壳 HTML + self.__NO_HYDRATE=1,让浏览器走 createRoot 自救
192
+ csrShellFallback = true;
193
+ status = 200; // 我们成功交付了壳;客户端去尝试 _.rsc 自愈
194
+ const reason = err instanceof Error ? err.message : err;
195
+ if (options.forceCsrShell) {
196
+ console.info('[isr-engine] CSR shell fallback requested by debug flag');
197
+ } else {
198
+ console.warn('[isr-engine] SSR render failed → falling back to csr-shell:', reason);
199
+ }
200
+ // 注入用户的全部 client CSS chunks 到 csr-shell —— 否则 CSR fallback 渲染丢样式
201
+ const cssLinks = collectAllCss();
202
+ htmlStream = await renderToReadableStream(
203
+ <html lang='zh-CN'>
204
+ <head>
205
+ <meta charSet='utf-8' />
206
+ <title>正在加载…</title>
207
+ {cssLinks.map(href => (
208
+ <link key={href} rel='stylesheet' href={href} />
209
+ ))}
210
+ <style dangerouslySetInnerHTML={{ __html: CSR_SHELL_STYLES }} />
211
+ </head>
212
+ <body className='csr-shell-body'>
213
+ <noscript>需要启用 JavaScript 以加载页面。</noscript>
214
+ <div className='csr-shell-page'>
215
+ <main className='csr-shell-card' role='status' aria-live='polite'>
216
+ <span className='csr-shell-badge'>CSR fallback</span>
217
+ <h1 className='csr-shell-title'>服务端暂时不可用</h1>
218
+ <p className='csr-shell-copy'>
219
+ 已交付客户端自救壳,正在加载前端资源并尝试恢复页面。刷新后会重新请求服务端渲染。
220
+ </p>
221
+ <div className='csr-shell-grid' aria-label='降级状态'>
222
+ <div className='csr-shell-row'>
223
+ <span>Render strategy</span>
224
+ <span>csr-shell</span>
225
+ </div>
226
+ <div className='csr-shell-row'>
227
+ <span>Cache policy</span>
228
+ <span>not cached</span>
229
+ </div>
230
+ </div>
231
+ <a className='csr-shell-action' href='/'>
232
+ 返回首页
233
+ </a>
234
+ </main>
235
+ </div>
236
+ </body>
237
+ </html>,
238
+ {
239
+ bootstrapScriptContent:
240
+ 'self.__NO_HYDRATE=1;' +
241
+ (options.apiBaseUrl ? `self.__API_BASE__=${JSON.stringify(options.apiBaseUrl)};` : '') +
242
+ (options.debugNojs ? '' : bootstrapScriptContent),
243
+ nonce: options.nonce,
244
+ }
245
+ );
246
+ }
247
+
248
+ let responseStream: ReadableStream<Uint8Array> = htmlStream;
249
+ if (!options.debugNojs && !csrShellFallback) {
250
+ // 正常路径才内联 Flight payload(csr-shell 路径下 Flight 已损坏,注入会让客户端反序列化崩)
251
+ responseStream = responseStream.pipeThrough(
252
+ injectRSCPayload(rscStream2, { nonce: options.nonce })
253
+ );
254
+ }
255
+
256
+ return { stream: responseStream, status, csrShellFallback };
257
+ }
@@ -0,0 +1,117 @@
1
+ /**
2
+ * 服务端入口(engine 内置 wrapper,**永远是** plugin-rsc 的 rsc env 入口)
3
+ *
4
+ * 自动按形状分派 —— 用户 src/entry.server.tsx 可以是任一形状:
5
+ *
6
+ * 形状 A · FaaS 配置(推荐 99% 场景):
7
+ * export default {
8
+ * beforeRequest: (req) => ({ traceId: crypto.randomUUID() }),
9
+ * onResponse: (res, ctx) => res.headers.set('x-trace-id', ctx.traceId),
10
+ * onError: (err, req) => console.error(err),
11
+ * };
12
+ *
13
+ * 形状 B · 完整 fetch handler(用户接管全部协议):
14
+ * export default { fetch: async (req) => new Response(...) };
15
+ *
16
+ * 形状 C · 不写 src/entry.server.tsx(engine 默认空 hooks)—— 不需要任何代码
17
+ *
18
+ * wrapper 在加载用户 default export 后做形状嗅探:
19
+ * 有 .fetch 方法 → 直接当 handler 用
20
+ * 否则当 hooks 配置 → 用 defineServerEntry 包一层
21
+ */
22
+ import { defineServerEntry, type ServerEntryHooks } from './runtime/defineServerEntry';
23
+ import { applyRuntimeToServerHooks } from './runtime/defineSiteHooks';
24
+ import { createAutoServerHooks } from './auto-observability';
25
+ // @ts-expect-error - @app/_server-config 由 createIsrPlugin 注入:
26
+ // - 用户提供 src/entry.server.tsx 时 → 解析到该文件
27
+ // - 用户没提供时 → 解析到 engine 内置 empty-config(默认 {})
28
+ import userConfig from '@app/_server-config';
29
+ // @ts-expect-error - virtual:isr-engine/runtime-config 由 createIsrPlugin 注入 ssr.config.ts runtime
30
+ import runtimeConfig from 'virtual:isr-engine/runtime-config';
31
+
32
+ interface FetchHandlerLike {
33
+ fetch: (request: Request) => Promise<Response>;
34
+ }
35
+
36
+ function hasFetchHandler(x: unknown): x is FetchHandlerLike {
37
+ return !!x && typeof (x as FetchHandlerLike).fetch === 'function';
38
+ }
39
+
40
+ // env 自动装配 SDK(SENTRY_ENABLED=true + SENTRY_DSN / DD_SERVICE / OTEL_EXPORTER_OTLP_ENDPOINT)
41
+ // 在第一次请求前完成;后续请求零开销
42
+ const autoHooksPromise = createAutoServerHooks();
43
+
44
+ const resolved: FetchHandlerLike = hasFetchHandler(userConfig)
45
+ ? userConfig
46
+ : (() => {
47
+ // 先用空 hooks 占位,第一个请求时把 auto + user 合并好的 handler 替换上来
48
+ let realHandler: FetchHandlerLike | null = null;
49
+ let initPromise: Promise<FetchHandlerLike> | null = null;
50
+
51
+ return {
52
+ async fetch(request: Request): Promise<Response> {
53
+ if (!realHandler) {
54
+ initPromise ??= (async () => {
55
+ const auto = await autoHooksPromise;
56
+ const user = applyRuntimeToServerHooks(
57
+ (userConfig ?? {}) as ServerEntryHooks,
58
+ runtimeConfig ?? {}
59
+ );
60
+ // 合并顺序:auto 先(SDK 模板),user 覆盖(业务定制赢)
61
+ const merged: ServerEntryHooks = {
62
+ ...auto,
63
+ ...user,
64
+ // beforeRequest / onResponse / onError 链式:先 auto 再 user
65
+ beforeRequest: chainBefore(auto.beforeRequest, user.beforeRequest),
66
+ onResponse: chainResponse(auto.onResponse, user.onResponse),
67
+ onError: chainError(auto.onError, user.onError),
68
+ };
69
+ return defineServerEntry(merged);
70
+ })();
71
+ realHandler = await initPromise;
72
+ }
73
+ return realHandler.fetch(request);
74
+ },
75
+ };
76
+ })();
77
+
78
+ function chainBefore(
79
+ a: ServerEntryHooks['beforeRequest'],
80
+ b: ServerEntryHooks['beforeRequest']
81
+ ): ServerEntryHooks['beforeRequest'] {
82
+ if (!a) return b;
83
+ if (!b) return a;
84
+ return async (req, baseline) => {
85
+ const ax = (await a(req, baseline)) ?? {};
86
+ const bx = (await b(req, baseline)) ?? {};
87
+ return { ...ax, ...bx };
88
+ };
89
+ }
90
+ function chainResponse(
91
+ a: ServerEntryHooks['onResponse'],
92
+ b: ServerEntryHooks['onResponse']
93
+ ): ServerEntryHooks['onResponse'] {
94
+ if (!a) return b;
95
+ if (!b) return a;
96
+ return async (res, ctx) => {
97
+ await a(res, ctx);
98
+ await b(res, ctx);
99
+ };
100
+ }
101
+ function chainError(
102
+ a: ServerEntryHooks['onError'],
103
+ b: ServerEntryHooks['onError']
104
+ ): ServerEntryHooks['onError'] {
105
+ if (!a) return b;
106
+ if (!b) return a;
107
+ return async (err, req, ctx) => {
108
+ await a(err, req, ctx);
109
+ await b(err, req, ctx);
110
+ };
111
+ }
112
+
113
+ export default resolved;
114
+
115
+ if (import.meta.hot) {
116
+ import.meta.hot.accept();
117
+ }
@@ -0,0 +1,23 @@
1
+ /**
2
+ * 浏览器入口(engine 内置 wrapper,**永远是** plugin-rsc 的 client env 入口)
3
+ *
4
+ * 自动加载用户 src/entry.tsx 的 default export 并应用其中的 FaaS hooks。
5
+ *
6
+ * 形状 A · FaaS 配置(推荐):
7
+ * export default {
8
+ * devInspector: true,
9
+ * // beforeStart / onNavigate / onActionError 只用于业务补充或第三方 SDK;
10
+ * // 常规 PV、Web Vitals 和错误上报由 ssr.config.ts runtime.telemetry 自动接管。
11
+ * };
12
+ *
13
+ * 形状 B · 不写 src/entry.tsx(engine 默认空 hooks)—— 不需要任何代码
14
+ *
15
+ * 不支持"完整 handler 覆盖"模式 —— 因为浏览器水合 / Server Action / 导航
16
+ * 拦截这些细节高度耦合 react-server-dom-webpack 的内部 API,用户重写出错率
17
+ * 极高且无收益。需要扩展时使用 hooks 即可。
18
+ */
19
+ import { defineClientEntry, type ClientEntryHooks } from './runtime/defineClientEntry';
20
+ // @ts-expect-error - @app/_client-config 由 createIsrPlugin 注入
21
+ import userConfig from '@app/_client-config';
22
+
23
+ defineClientEntry((userConfig ?? {}) as ClientEntryHooks);