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 @@
1
+ {"version":3,"file":"auto-observability.cjs","names":[],"sources":["../../src/defaults/auto-observability.ts"],"sourcesContent":["/**\n * 环境变量驱动的 SDK 自动装配\n *\n * 用户态:什么都不做。明确开启后才接第三方 vendor,没开则跳过。\n *\n * .env\n * SENTRY_ENABLED=true\n * SENTRY_DSN=https://xxx@sentry.io/123 → 自动接 Sentry 服务端\n * DD_SERVICE=my-app → 自动接 Datadog(要求 dd-trace 已安装)\n * OTEL_EXPORTER_OTLP_ENDPOINT=http://... → 自动接 OTel(要求 @opentelemetry/* 已安装)\n *\n * 设计:SDK 都是 dynamic import;用户没装就静默跳过(不阻塞启动)。\n * 多个 vendor 同时配置时采用 fan-out:Sentry / Datadog / OTel 都会执行,\n * 任意一个 vendor 抛错都不能阻断其它 vendor、endpoint 上报或业务 hooks。\n */\n// 不引 Logger(它的 alias 在用户 RSC 上下文不解析);用 console.* 直出\nconst logger = {\n info: (...a: unknown[]) => console.log('[isr-engine:auto-obs]', ...a),\n warn: (...a: unknown[]) => console.warn('[isr-engine:auto-obs]', ...a),\n};\n\n/**\n * 用 Function 构造器隐藏 import specifier,绕过 rolldown 静态分析\n * —— 这样 SDK 不会被强制解析,用户没装时不会失败构建\n */\nconst dynamicImport = new Function('m', 'return import(m)') as (m: string) => Promise<unknown>;\nasync function tryImport(name: string): Promise<unknown> {\n return await dynamicImport(name);\n}\n\nexport interface AutoServerCtx {\n traceId: string;\n startedAt: number;\n [key: string]: unknown;\n}\n\nexport interface AutoServerHooks {\n beforeRequest?: (\n req: Request,\n baseline: { traceId: string; startedAt: number }\n ) => Record<string, unknown> | Promise<Record<string, unknown>>;\n onResponse?: (res: Response, ctx: AutoServerCtx) => void;\n onError?: (err: unknown, req: Request, ctx: AutoServerCtx) => void;\n}\n\n/**\n * 检测 env 自动选 SDK 装配\n * 调用顺序:在 entry.server 加载前后都行;推荐启动时调一次返回的 hooks 用作默认 hooks\n */\nexport async function createAutoServerHooks(): Promise<AutoServerHooks> {\n const sentryDsn = resolveSentryDsnFromEnv(process.env);\n const ddService = process.env.DD_SERVICE;\n const otelEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\n const hooks: AutoServerHooks[] = [];\n if (sentryDsn) hooks.push(await loadSentry(sentryDsn));\n if (ddService) hooks.push(await loadDatadog(ddService));\n if (otelEndpoint) hooks.push(await loadOtel(otelEndpoint));\n\n const activeHooks = hooks.filter(hasAnyHook);\n if (activeHooks.length > 0) return composeAutoServerHooks(activeHooks);\n\n logger.info(\n '🛰️ telemetry: 未检测到启用的 Sentry/DD_SERVICE/OTEL_EXPORTER_OTLP_ENDPOINT,跳过第三方服务端 adapter'\n );\n return {};\n}\n\nexport function resolveSentryDsnFromEnv(\n env: Record<string, string | undefined>\n): string | undefined {\n if (!isTruthyEnv(env.SENTRY_ENABLED)) return undefined;\n const dsn = env.SENTRY_DSN?.trim();\n return dsn || undefined;\n}\n\nfunction isTruthyEnv(value: string | undefined): boolean {\n if (!value) return false;\n return value === '1' || value.toLowerCase() === 'true';\n}\n\nexport function composeAutoServerHooks(hooks: readonly AutoServerHooks[]): AutoServerHooks {\n const activeHooks = hooks.filter(hasAnyHook);\n if (activeHooks.length === 0) return {};\n\n return {\n async beforeRequest(req, baseline) {\n const merged: Record<string, unknown> = {};\n for (const hook of activeHooks) {\n if (!hook.beforeRequest) continue;\n try {\n Object.assign(merged, (await hook.beforeRequest(req, baseline)) ?? {});\n } catch (err) {\n logger.warn('🛰️ observability beforeRequest vendor hook failed', err);\n }\n }\n return merged;\n },\n onResponse(res, ctx) {\n for (const hook of activeHooks) {\n if (!hook.onResponse) continue;\n try {\n hook.onResponse(res, ctx);\n } catch (err) {\n logger.warn('🛰️ observability onResponse vendor hook failed', err);\n }\n }\n },\n onError(err, req, ctx) {\n for (const hook of activeHooks) {\n if (!hook.onError) continue;\n try {\n hook.onError(err, req, ctx);\n } catch (vendorErr) {\n logger.warn('🛰️ observability onError vendor hook failed', vendorErr);\n }\n }\n },\n };\n}\n\nfunction hasAnyHook(hook: AutoServerHooks): boolean {\n return !!(hook.beforeRequest || hook.onResponse || hook.onError);\n}\n\n/**\n * 走 npm subpath import 而不是相对路径:\n * - 本文件是 raw-shipped src/,被 consumer bundler 当源码处理\n * - 三个 hook factory 在 dist/ 里通过 `./adapters/observability` 子路径已公开 export\n * - 用 subpath 既避免相对路径依赖(src/adapters/* 不在 npm tarball 里),也复用编译产物\n */\ntype ObservabilityAdapters = typeof import('isr-engine/adapters/observability');\n\nasync function loadObservability(): Promise<ObservabilityAdapters> {\n return (await import('isr-engine/adapters/observability')) as ObservabilityAdapters;\n}\n\nasync function loadSentry(dsn: string): Promise<AutoServerHooks> {\n try {\n const Sentry = (await tryImport('@sentry/node')) as {\n init: (opts: Record<string, unknown>) => void;\n startInactiveSpan: (opts: Record<string, unknown>) => unknown;\n captureException: (err: unknown, hint?: Record<string, unknown>) => void;\n };\n Sentry.init({\n dsn,\n tracesSampleRate: parseFloat(process.env.SENTRY_TRACES_SAMPLE_RATE ?? '0.1'),\n environment: process.env.SENTRY_ENVIRONMENT ?? process.env.NODE_ENV ?? 'production',\n });\n const { createSentryServerHooks } = await loadObservability();\n logger.info(`🛰️ telemetry: Sentry auto-wired (DSN ${dsn.replace(/\\/\\/[^@]+@/, '//<key>@')})`);\n return createSentryServerHooks({\n Sentry: Sentry as unknown as Parameters<typeof createSentryServerHooks>[0]['Sentry'],\n }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ Sentry auto-wire 失败(@sentry/node 未安装?)→ 走默认上报', err);\n return {};\n }\n}\n\nasync function loadDatadog(service: string): Promise<AutoServerHooks> {\n try {\n const tracerMod = (await tryImport('dd-trace')) as {\n default: { init: (opts: Record<string, unknown>) => unknown };\n };\n const { createDatadogServerHooks } = await loadObservability();\n const tracer = tracerMod.default.init({\n service,\n env: process.env.DD_ENV ?? process.env.NODE_ENV,\n version: process.env.DD_VERSION,\n }) as Parameters<typeof createDatadogServerHooks>[0]['tracer'];\n logger.info(`🛰️ telemetry: Datadog auto-wired (service=${service})`);\n return createDatadogServerHooks({ tracer }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ Datadog auto-wire 失败(dd-trace 未安装?)', err);\n return {};\n }\n}\n\nasync function loadOtel(endpoint: string): Promise<AutoServerHooks> {\n try {\n const { createOtelServerHooks } = await loadObservability();\n const otelApi = (await tryImport('@opentelemetry/api')) as {\n trace: {\n getTracer: (name: string) => Parameters<typeof createOtelServerHooks>[0]['tracer'];\n };\n };\n const tracer = otelApi.trace.getTracer(process.env.OTEL_SERVICE_NAME ?? 'isr-engine-app');\n logger.info(`🛰️ telemetry: OTel auto-wired (endpoint=${endpoint})`);\n return createOtelServerHooks({ tracer }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ OTel auto-wire 失败(@opentelemetry/api 未安装?)', err);\n return {};\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ export interface AutoServerCtx {
2
+ traceId: string;
3
+ startedAt: number;
4
+ [key: string]: unknown;
5
+ }
6
+ export interface AutoServerHooks {
7
+ beforeRequest?: (req: Request, baseline: {
8
+ traceId: string;
9
+ startedAt: number;
10
+ }) => Record<string, unknown> | Promise<Record<string, unknown>>;
11
+ onResponse?: (res: Response, ctx: AutoServerCtx) => void;
12
+ onError?: (err: unknown, req: Request, ctx: AutoServerCtx) => void;
13
+ }
14
+ /**
15
+ * 检测 env 自动选 SDK 装配
16
+ * 调用顺序:在 entry.server 加载前后都行;推荐启动时调一次返回的 hooks 用作默认 hooks
17
+ */
18
+ export declare function createAutoServerHooks(): Promise<AutoServerHooks>;
19
+ export declare function resolveSentryDsnFromEnv(env: Record<string, string | undefined>): string | undefined;
20
+ export declare function composeAutoServerHooks(hooks: readonly AutoServerHooks[]): AutoServerHooks;
21
+ //# sourceMappingURL=auto-observability.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-observability.d.ts","sourceRoot":"","sources":["../../src/defaults/auto-observability.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,CACd,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;CACpE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CAiBtE;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,MAAM,GAAG,SAAS,CAIpB;AAOD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,eAAe,CAsCzF"}
@@ -0,0 +1,144 @@
1
+ //#region src/defaults/auto-observability.ts
2
+ /**
3
+ * 环境变量驱动的 SDK 自动装配
4
+ *
5
+ * 用户态:什么都不做。明确开启后才接第三方 vendor,没开则跳过。
6
+ *
7
+ * .env
8
+ * SENTRY_ENABLED=true
9
+ * SENTRY_DSN=https://xxx@sentry.io/123 → 自动接 Sentry 服务端
10
+ * DD_SERVICE=my-app → 自动接 Datadog(要求 dd-trace 已安装)
11
+ * OTEL_EXPORTER_OTLP_ENDPOINT=http://... → 自动接 OTel(要求 @opentelemetry/* 已安装)
12
+ *
13
+ * 设计:SDK 都是 dynamic import;用户没装就静默跳过(不阻塞启动)。
14
+ * 多个 vendor 同时配置时采用 fan-out:Sentry / Datadog / OTel 都会执行,
15
+ * 任意一个 vendor 抛错都不能阻断其它 vendor、endpoint 上报或业务 hooks。
16
+ */
17
+ var logger = {
18
+ info: (...a) => console.log("[isr-engine:auto-obs]", ...a),
19
+ warn: (...a) => console.warn("[isr-engine:auto-obs]", ...a)
20
+ };
21
+ /**
22
+ * 用 Function 构造器隐藏 import specifier,绕过 rolldown 静态分析
23
+ * —— 这样 SDK 不会被强制解析,用户没装时不会失败构建
24
+ */
25
+ var dynamicImport = new Function("m", "return import(m)");
26
+ async function tryImport(name) {
27
+ return await dynamicImport(name);
28
+ }
29
+ /**
30
+ * 检测 env 自动选 SDK 装配
31
+ * 调用顺序:在 entry.server 加载前后都行;推荐启动时调一次返回的 hooks 用作默认 hooks
32
+ */
33
+ async function createAutoServerHooks() {
34
+ const sentryDsn = resolveSentryDsnFromEnv(process.env);
35
+ const ddService = process.env.DD_SERVICE;
36
+ const otelEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
37
+ const hooks = [];
38
+ if (sentryDsn) hooks.push(await loadSentry(sentryDsn));
39
+ if (ddService) hooks.push(await loadDatadog(ddService));
40
+ if (otelEndpoint) hooks.push(await loadOtel(otelEndpoint));
41
+ const activeHooks = hooks.filter(hasAnyHook);
42
+ if (activeHooks.length > 0) return composeAutoServerHooks(activeHooks);
43
+ logger.info("🛰️ telemetry: 未检测到启用的 Sentry/DD_SERVICE/OTEL_EXPORTER_OTLP_ENDPOINT,跳过第三方服务端 adapter");
44
+ return {};
45
+ }
46
+ function resolveSentryDsnFromEnv(env) {
47
+ if (!isTruthyEnv(env.SENTRY_ENABLED)) return void 0;
48
+ return env.SENTRY_DSN?.trim() || void 0;
49
+ }
50
+ function isTruthyEnv(value) {
51
+ if (!value) return false;
52
+ return value === "1" || value.toLowerCase() === "true";
53
+ }
54
+ function composeAutoServerHooks(hooks) {
55
+ const activeHooks = hooks.filter(hasAnyHook);
56
+ if (activeHooks.length === 0) return {};
57
+ return {
58
+ async beforeRequest(req, baseline) {
59
+ const merged = {};
60
+ for (const hook of activeHooks) {
61
+ if (!hook.beforeRequest) continue;
62
+ try {
63
+ Object.assign(merged, await hook.beforeRequest(req, baseline) ?? {});
64
+ } catch (err) {
65
+ logger.warn("🛰️ observability beforeRequest vendor hook failed", err);
66
+ }
67
+ }
68
+ return merged;
69
+ },
70
+ onResponse(res, ctx) {
71
+ for (const hook of activeHooks) {
72
+ if (!hook.onResponse) continue;
73
+ try {
74
+ hook.onResponse(res, ctx);
75
+ } catch (err) {
76
+ logger.warn("🛰️ observability onResponse vendor hook failed", err);
77
+ }
78
+ }
79
+ },
80
+ onError(err, req, ctx) {
81
+ for (const hook of activeHooks) {
82
+ if (!hook.onError) continue;
83
+ try {
84
+ hook.onError(err, req, ctx);
85
+ } catch (vendorErr) {
86
+ logger.warn("🛰️ observability onError vendor hook failed", vendorErr);
87
+ }
88
+ }
89
+ }
90
+ };
91
+ }
92
+ function hasAnyHook(hook) {
93
+ return !!(hook.beforeRequest || hook.onResponse || hook.onError);
94
+ }
95
+ async function loadObservability() {
96
+ return await import("../adapters/observability/index.js");
97
+ }
98
+ async function loadSentry(dsn) {
99
+ try {
100
+ const Sentry = await tryImport("@sentry/node");
101
+ Sentry.init({
102
+ dsn,
103
+ tracesSampleRate: parseFloat(process.env.SENTRY_TRACES_SAMPLE_RATE ?? "0.1"),
104
+ environment: process.env.SENTRY_ENVIRONMENT ?? process.env.NODE_ENV ?? "production"
105
+ });
106
+ const { createSentryServerHooks } = await loadObservability();
107
+ logger.info(`🛰️ telemetry: Sentry auto-wired (DSN ${dsn.replace(/\/\/[^@]+@/, "//<key>@")})`);
108
+ return createSentryServerHooks({ Sentry });
109
+ } catch (err) {
110
+ logger.warn("🛰️ Sentry auto-wire 失败(@sentry/node 未安装?)→ 走默认上报", err);
111
+ return {};
112
+ }
113
+ }
114
+ async function loadDatadog(service) {
115
+ try {
116
+ const tracerMod = await tryImport("dd-trace");
117
+ const { createDatadogServerHooks } = await loadObservability();
118
+ const tracer = tracerMod.default.init({
119
+ service,
120
+ env: process.env.DD_ENV ?? process.env.NODE_ENV,
121
+ version: process.env.DD_VERSION
122
+ });
123
+ logger.info(`🛰️ telemetry: Datadog auto-wired (service=${service})`);
124
+ return createDatadogServerHooks({ tracer });
125
+ } catch (err) {
126
+ logger.warn("🛰️ Datadog auto-wire 失败(dd-trace 未安装?)", err);
127
+ return {};
128
+ }
129
+ }
130
+ async function loadOtel(endpoint) {
131
+ try {
132
+ const { createOtelServerHooks } = await loadObservability();
133
+ const tracer = (await tryImport("@opentelemetry/api")).trace.getTracer(process.env.OTEL_SERVICE_NAME ?? "isr-engine-app");
134
+ logger.info(`🛰️ telemetry: OTel auto-wired (endpoint=${endpoint})`);
135
+ return createOtelServerHooks({ tracer });
136
+ } catch (err) {
137
+ logger.warn("🛰️ OTel auto-wire 失败(@opentelemetry/api 未安装?)", err);
138
+ return {};
139
+ }
140
+ }
141
+ //#endregion
142
+ export { composeAutoServerHooks, createAutoServerHooks, resolveSentryDsnFromEnv };
143
+
144
+ //# sourceMappingURL=auto-observability.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-observability.js","names":[],"sources":["../../src/defaults/auto-observability.ts"],"sourcesContent":["/**\n * 环境变量驱动的 SDK 自动装配\n *\n * 用户态:什么都不做。明确开启后才接第三方 vendor,没开则跳过。\n *\n * .env\n * SENTRY_ENABLED=true\n * SENTRY_DSN=https://xxx@sentry.io/123 → 自动接 Sentry 服务端\n * DD_SERVICE=my-app → 自动接 Datadog(要求 dd-trace 已安装)\n * OTEL_EXPORTER_OTLP_ENDPOINT=http://... → 自动接 OTel(要求 @opentelemetry/* 已安装)\n *\n * 设计:SDK 都是 dynamic import;用户没装就静默跳过(不阻塞启动)。\n * 多个 vendor 同时配置时采用 fan-out:Sentry / Datadog / OTel 都会执行,\n * 任意一个 vendor 抛错都不能阻断其它 vendor、endpoint 上报或业务 hooks。\n */\n// 不引 Logger(它的 alias 在用户 RSC 上下文不解析);用 console.* 直出\nconst logger = {\n info: (...a: unknown[]) => console.log('[isr-engine:auto-obs]', ...a),\n warn: (...a: unknown[]) => console.warn('[isr-engine:auto-obs]', ...a),\n};\n\n/**\n * 用 Function 构造器隐藏 import specifier,绕过 rolldown 静态分析\n * —— 这样 SDK 不会被强制解析,用户没装时不会失败构建\n */\nconst dynamicImport = new Function('m', 'return import(m)') as (m: string) => Promise<unknown>;\nasync function tryImport(name: string): Promise<unknown> {\n return await dynamicImport(name);\n}\n\nexport interface AutoServerCtx {\n traceId: string;\n startedAt: number;\n [key: string]: unknown;\n}\n\nexport interface AutoServerHooks {\n beforeRequest?: (\n req: Request,\n baseline: { traceId: string; startedAt: number }\n ) => Record<string, unknown> | Promise<Record<string, unknown>>;\n onResponse?: (res: Response, ctx: AutoServerCtx) => void;\n onError?: (err: unknown, req: Request, ctx: AutoServerCtx) => void;\n}\n\n/**\n * 检测 env 自动选 SDK 装配\n * 调用顺序:在 entry.server 加载前后都行;推荐启动时调一次返回的 hooks 用作默认 hooks\n */\nexport async function createAutoServerHooks(): Promise<AutoServerHooks> {\n const sentryDsn = resolveSentryDsnFromEnv(process.env);\n const ddService = process.env.DD_SERVICE;\n const otelEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;\n\n const hooks: AutoServerHooks[] = [];\n if (sentryDsn) hooks.push(await loadSentry(sentryDsn));\n if (ddService) hooks.push(await loadDatadog(ddService));\n if (otelEndpoint) hooks.push(await loadOtel(otelEndpoint));\n\n const activeHooks = hooks.filter(hasAnyHook);\n if (activeHooks.length > 0) return composeAutoServerHooks(activeHooks);\n\n logger.info(\n '🛰️ telemetry: 未检测到启用的 Sentry/DD_SERVICE/OTEL_EXPORTER_OTLP_ENDPOINT,跳过第三方服务端 adapter'\n );\n return {};\n}\n\nexport function resolveSentryDsnFromEnv(\n env: Record<string, string | undefined>\n): string | undefined {\n if (!isTruthyEnv(env.SENTRY_ENABLED)) return undefined;\n const dsn = env.SENTRY_DSN?.trim();\n return dsn || undefined;\n}\n\nfunction isTruthyEnv(value: string | undefined): boolean {\n if (!value) return false;\n return value === '1' || value.toLowerCase() === 'true';\n}\n\nexport function composeAutoServerHooks(hooks: readonly AutoServerHooks[]): AutoServerHooks {\n const activeHooks = hooks.filter(hasAnyHook);\n if (activeHooks.length === 0) return {};\n\n return {\n async beforeRequest(req, baseline) {\n const merged: Record<string, unknown> = {};\n for (const hook of activeHooks) {\n if (!hook.beforeRequest) continue;\n try {\n Object.assign(merged, (await hook.beforeRequest(req, baseline)) ?? {});\n } catch (err) {\n logger.warn('🛰️ observability beforeRequest vendor hook failed', err);\n }\n }\n return merged;\n },\n onResponse(res, ctx) {\n for (const hook of activeHooks) {\n if (!hook.onResponse) continue;\n try {\n hook.onResponse(res, ctx);\n } catch (err) {\n logger.warn('🛰️ observability onResponse vendor hook failed', err);\n }\n }\n },\n onError(err, req, ctx) {\n for (const hook of activeHooks) {\n if (!hook.onError) continue;\n try {\n hook.onError(err, req, ctx);\n } catch (vendorErr) {\n logger.warn('🛰️ observability onError vendor hook failed', vendorErr);\n }\n }\n },\n };\n}\n\nfunction hasAnyHook(hook: AutoServerHooks): boolean {\n return !!(hook.beforeRequest || hook.onResponse || hook.onError);\n}\n\n/**\n * 走 npm subpath import 而不是相对路径:\n * - 本文件是 raw-shipped src/,被 consumer bundler 当源码处理\n * - 三个 hook factory 在 dist/ 里通过 `./adapters/observability` 子路径已公开 export\n * - 用 subpath 既避免相对路径依赖(src/adapters/* 不在 npm tarball 里),也复用编译产物\n */\ntype ObservabilityAdapters = typeof import('isr-engine/adapters/observability');\n\nasync function loadObservability(): Promise<ObservabilityAdapters> {\n return (await import('isr-engine/adapters/observability')) as ObservabilityAdapters;\n}\n\nasync function loadSentry(dsn: string): Promise<AutoServerHooks> {\n try {\n const Sentry = (await tryImport('@sentry/node')) as {\n init: (opts: Record<string, unknown>) => void;\n startInactiveSpan: (opts: Record<string, unknown>) => unknown;\n captureException: (err: unknown, hint?: Record<string, unknown>) => void;\n };\n Sentry.init({\n dsn,\n tracesSampleRate: parseFloat(process.env.SENTRY_TRACES_SAMPLE_RATE ?? '0.1'),\n environment: process.env.SENTRY_ENVIRONMENT ?? process.env.NODE_ENV ?? 'production',\n });\n const { createSentryServerHooks } = await loadObservability();\n logger.info(`🛰️ telemetry: Sentry auto-wired (DSN ${dsn.replace(/\\/\\/[^@]+@/, '//<key>@')})`);\n return createSentryServerHooks({\n Sentry: Sentry as unknown as Parameters<typeof createSentryServerHooks>[0]['Sentry'],\n }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ Sentry auto-wire 失败(@sentry/node 未安装?)→ 走默认上报', err);\n return {};\n }\n}\n\nasync function loadDatadog(service: string): Promise<AutoServerHooks> {\n try {\n const tracerMod = (await tryImport('dd-trace')) as {\n default: { init: (opts: Record<string, unknown>) => unknown };\n };\n const { createDatadogServerHooks } = await loadObservability();\n const tracer = tracerMod.default.init({\n service,\n env: process.env.DD_ENV ?? process.env.NODE_ENV,\n version: process.env.DD_VERSION,\n }) as Parameters<typeof createDatadogServerHooks>[0]['tracer'];\n logger.info(`🛰️ telemetry: Datadog auto-wired (service=${service})`);\n return createDatadogServerHooks({ tracer }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ Datadog auto-wire 失败(dd-trace 未安装?)', err);\n return {};\n }\n}\n\nasync function loadOtel(endpoint: string): Promise<AutoServerHooks> {\n try {\n const { createOtelServerHooks } = await loadObservability();\n const otelApi = (await tryImport('@opentelemetry/api')) as {\n trace: {\n getTracer: (name: string) => Parameters<typeof createOtelServerHooks>[0]['tracer'];\n };\n };\n const tracer = otelApi.trace.getTracer(process.env.OTEL_SERVICE_NAME ?? 'isr-engine-app');\n logger.info(`🛰️ telemetry: OTel auto-wired (endpoint=${endpoint})`);\n return createOtelServerHooks({ tracer }) as AutoServerHooks;\n } catch (err) {\n logger.warn('🛰️ OTel auto-wire 失败(@opentelemetry/api 未安装?)', err);\n return {};\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,IAAM,SAAS;CACb,OAAO,GAAG,MAAiB,QAAQ,IAAI,yBAAyB,GAAG,CAAC;CACpE,OAAO,GAAG,MAAiB,QAAQ,KAAK,yBAAyB,GAAG,CAAC;AACvE;;;;;AAMA,IAAM,gBAAgB,IAAI,SAAS,KAAK,kBAAkB;AAC1D,eAAe,UAAU,MAAgC;CACvD,OAAO,MAAM,cAAc,IAAI;AACjC;;;;;AAqBA,eAAsB,wBAAkD;CACtE,MAAM,YAAY,wBAAwB,QAAQ,GAAG;CACrD,MAAM,YAAY,QAAQ,IAAI;CAC9B,MAAM,eAAe,QAAQ,IAAI;CAEjC,MAAM,QAA2B,CAAC;CAClC,IAAI,WAAW,MAAM,KAAK,MAAM,WAAW,SAAS,CAAC;CACrD,IAAI,WAAW,MAAM,KAAK,MAAM,YAAY,SAAS,CAAC;CACtD,IAAI,cAAc,MAAM,KAAK,MAAM,SAAS,YAAY,CAAC;CAEzD,MAAM,cAAc,MAAM,OAAO,UAAU;CAC3C,IAAI,YAAY,SAAS,GAAG,OAAO,uBAAuB,WAAW;CAErE,OAAO,KACL,wFACF;CACA,OAAO,CAAC;AACV;AAEA,SAAgB,wBACd,KACoB;CACpB,IAAI,CAAC,YAAY,IAAI,cAAc,GAAG,OAAO,KAAA;CAE7C,OADY,IAAI,YAAY,KAAK,KACnB,KAAA;AAChB;AAEA,SAAS,YAAY,OAAoC;CACvD,IAAI,CAAC,OAAO,OAAO;CACnB,OAAO,UAAU,OAAO,MAAM,YAAY,MAAM;AAClD;AAEA,SAAgB,uBAAuB,OAAoD;CACzF,MAAM,cAAc,MAAM,OAAO,UAAU;CAC3C,IAAI,YAAY,WAAW,GAAG,OAAO,CAAC;CAEtC,OAAO;EACL,MAAM,cAAc,KAAK,UAAU;GACjC,MAAM,SAAkC,CAAC;GACzC,KAAK,MAAM,QAAQ,aAAa;IAC9B,IAAI,CAAC,KAAK,eAAe;IACzB,IAAI;KACF,OAAO,OAAO,QAAS,MAAM,KAAK,cAAc,KAAK,QAAQ,KAAM,CAAC,CAAC;IACvE,SAAS,KAAK;KACZ,OAAO,KAAK,uDAAuD,GAAG;IACxE;GACF;GACA,OAAO;EACT;EACA,WAAW,KAAK,KAAK;GACnB,KAAK,MAAM,QAAQ,aAAa;IAC9B,IAAI,CAAC,KAAK,YAAY;IACtB,IAAI;KACF,KAAK,WAAW,KAAK,GAAG;IAC1B,SAAS,KAAK;KACZ,OAAO,KAAK,oDAAoD,GAAG;IACrE;GACF;EACF;EACA,QAAQ,KAAK,KAAK,KAAK;GACrB,KAAK,MAAM,QAAQ,aAAa;IAC9B,IAAI,CAAC,KAAK,SAAS;IACnB,IAAI;KACF,KAAK,QAAQ,KAAK,KAAK,GAAG;IAC5B,SAAS,WAAW;KAClB,OAAO,KAAK,iDAAiD,SAAS;IACxE;GACF;EACF;CACF;AACF;AAEA,SAAS,WAAW,MAAgC;CAClD,OAAO,CAAC,EAAE,KAAK,iBAAiB,KAAK,cAAc,KAAK;AAC1D;AAUA,eAAe,oBAAoD;CACjE,OAAQ,MAAM,OAAO;AACvB;AAEA,eAAe,WAAW,KAAuC;CAC/D,IAAI;EACF,MAAM,SAAU,MAAM,UAAU,cAAc;EAK9C,OAAO,KAAK;GACV;GACA,kBAAkB,WAAW,QAAQ,IAAI,6BAA6B,KAAK;GAC3E,aAAa,QAAQ,IAAI,sBAAA,QAAA,IAAA,YAA8C;EACzE,CAAC;EACD,MAAM,EAAE,4BAA4B,MAAM,kBAAkB;EAC5D,OAAO,KAAK,0CAA0C,IAAI,QAAQ,cAAc,UAAU,EAAE,EAAE;EAC9F,OAAO,wBAAwB,EACrB,OACV,CAAC;CACH,SAAS,KAAK;EACZ,OAAO,KAAK,sDAAsD,GAAG;EACrE,OAAO,CAAC;CACV;AACF;AAEA,eAAe,YAAY,SAA2C;CACpE,IAAI;EACF,MAAM,YAAa,MAAM,UAAU,UAAU;EAG7C,MAAM,EAAE,6BAA6B,MAAM,kBAAkB;EAC7D,MAAM,SAAS,UAAU,QAAQ,KAAK;GACpC;GACA,KAAK,QAAQ,IAAI,UAAA,QAAA,IAAA;GACjB,SAAS,QAAQ,IAAI;EACvB,CAAC;EACD,OAAO,KAAK,+CAA+C,QAAQ,EAAE;EACrE,OAAO,yBAAyB,EAAE,OAAO,CAAC;CAC5C,SAAS,KAAK;EACZ,OAAO,KAAK,4CAA4C,GAAG;EAC3D,OAAO,CAAC;CACV;AACF;AAEA,eAAe,SAAS,UAA4C;CAClE,IAAI;EACF,MAAM,EAAE,0BAA0B,MAAM,kBAAkB;EAM1D,MAAM,UAAS,MALQ,UAAU,oBAAoB,EAAA,CAK9B,MAAM,UAAU,QAAQ,IAAI,qBAAqB,gBAAgB;EACxF,OAAO,KAAK,6CAA6C,SAAS,EAAE;EACpE,OAAO,sBAAsB,EAAE,OAAO,CAAC;CACzC,SAAS,KAAK;EACZ,OAAO,KAAK,mDAAmD,GAAG;EAClE,OAAO,CAAC;CACV;AACF"}
@@ -0,0 +1,73 @@
1
+ /**
2
+ * Browser observability bridge.
3
+ *
4
+ * isr-engine owns the browser lifecycle points: app boot, page navigation,
5
+ * Web Vitals, global browser errors and Server Action failures. It deliberately
6
+ * does not import a vendor SDK or a project-specific SDK. The only integration
7
+ * contract is HTTP endpoints resolved from ssr.config.ts runtime.telemetry.
8
+ * Rendering, hydration and navigation must never depend on observability.
9
+ */
10
+ import { type TelemetryCaptureOptions, type TelemetryEventOptions, type TelemetryMeasureOptions } from '../../runtime/telemetry';
11
+ export interface BrowserObservabilityUser {
12
+ id?: string;
13
+ tenantId?: string;
14
+ segment?: string;
15
+ traits?: Record<string, unknown>;
16
+ }
17
+ export interface BrowserAnalyticsOptions {
18
+ endpoint?: string;
19
+ sampleRate?: number;
20
+ batchSize?: number;
21
+ flushIntervalMs?: number;
22
+ maxQueueSize?: number;
23
+ retryBaseDelayMs?: number;
24
+ retryMaxDelayMs?: number;
25
+ webVitals?: boolean;
26
+ trackInitialPage?: boolean;
27
+ }
28
+ export interface BrowserErrorReportingOptions {
29
+ endpoint?: string;
30
+ sampleRate?: number;
31
+ batchSize?: number;
32
+ flushIntervalMs?: number;
33
+ maxQueueSize?: number;
34
+ retryBaseDelayMs?: number;
35
+ retryMaxDelayMs?: number;
36
+ captureResourceErrors?: boolean;
37
+ /**
38
+ * 当错误来源 / 堆栈匹配下面的正则之一时,丢弃不上报。
39
+ *
40
+ * 默认会过滤 dev-runtime 噪声(@vite/client、react-refresh、HMR ping
41
+ * 等),避免开发态 WebSocket 重连时刷出的 "send was called before
42
+ * connect" 这类错误把 admin observability 通道刷爆。
43
+ *
44
+ * 业务可以在这里追加自己的过滤规则;传 `false` 关掉所有过滤(不推荐)。
45
+ */
46
+ ignoreSourcePatterns?: RegExp[] | false;
47
+ }
48
+ export interface BrowserObservabilityOptions {
49
+ app: string;
50
+ release?: string;
51
+ environment?: string;
52
+ user?: BrowserObservabilityUser;
53
+ includeQueryString?: boolean;
54
+ analytics?: false | BrowserAnalyticsOptions;
55
+ errorReporting?: false | BrowserErrorReportingOptions;
56
+ }
57
+ export interface BrowserObservabilityHandle {
58
+ track(name: string, properties?: Record<string, unknown>, options?: TelemetryEventOptions): void;
59
+ capture(error: unknown, context?: TelemetryCaptureOptions): void;
60
+ measure(name: string, value: number, options?: TelemetryMeasureOptions): void;
61
+ page(url?: URL | string): void;
62
+ captureActionError(error: unknown, actionId: string): void;
63
+ setUser(user: BrowserObservabilityUser | null): void;
64
+ flush(): Promise<void> | void;
65
+ shutdown(): void;
66
+ }
67
+ export declare function installBrowserObservability(options: BrowserObservabilityOptions): Promise<BrowserObservabilityHandle>;
68
+ /** 解析 ignoreSourcePatterns 选项 —— false 关闭过滤;数组与默认合并;缺省走默认。 */
69
+ export declare function resolveIgnorePatterns(custom: RegExp[] | false | undefined): RegExp[];
70
+ /** 判断错误是否来自 dev-runtime 等噪声源。
71
+ * 命中 ignorePatterns 任一 → 丢弃。检查 source URL + error.stack 两条。 */
72
+ export declare function shouldIgnore(ignorePatterns: RegExp[], source: string | undefined, reason: unknown): boolean;
73
+ //# sourceMappingURL=browserObservability.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browserObservability.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/browserObservability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ export interface PrefetchConnection {
2
+ saveData?: boolean;
3
+ effectiveType?: string;
4
+ }
5
+ export declare function isRscNavigation(href: string, current: string): boolean;
6
+ export declare function shouldPrefetch(href: string, current: string, policy: string | undefined, reason: 'intent' | 'viewport', connection?: PrefetchConnection): boolean;
7
+ export declare function createPrefetcher(request: (url: string) => Promise<{
8
+ ok: boolean;
9
+ }>, limit?: number): (href: string) => Promise<void>;
10
+ //# sourceMappingURL=client-navigation-policy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client-navigation-policy.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/client-navigation-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYtE;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,EAC7B,UAAU,CAAC,EAAE,kBAAkB,GAC9B,OAAO,CAQT;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,EAClD,KAAK,SAAM,GACV,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CA4BjC"}
@@ -0,0 +1,17 @@
1
+ export interface CachedFetcherOptions<TArg, TValue> {
2
+ /** 从入参生成缓存 key */
3
+ key: (arg: TArg) => string;
4
+ /** 实际加载逻辑(network / fs / dynamic import 都可) */
5
+ fetch: (arg: TArg) => Promise<TValue>;
6
+ /** 缓存 TTL(毫秒),默认 60s */
7
+ ttl?: number;
8
+ /** LRU 容量,默认 500 */
9
+ max?: number;
10
+ /** 启用 stale-while-revalidate:过期仍返回旧值,后台异步刷新(默认 false) */
11
+ swr?: boolean;
12
+ /** 拉取失败时的回退值(如不提供则抛错) */
13
+ fallback?: (arg: TArg, error: unknown) => TValue | Promise<TValue>;
14
+ }
15
+ export type CachedFetcher<TArg, TValue> = (arg: TArg) => Promise<TValue>;
16
+ export declare function createCachedFetcher<TArg, TValue>(opts: CachedFetcherOptions<TArg, TValue>): CachedFetcher<TArg, TValue>;
17
+ //# sourceMappingURL=createCachedFetcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createCachedFetcher.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/createCachedFetcher.ts"],"names":[],"mappings":"AAkDA,MAAM,WAAW,oBAAoB,CAAC,IAAI,EAAE,MAAM;IAChD,kBAAkB;IAClB,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yBAAyB;IACzB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpE;AAOD,MAAM,MAAM,aAAa,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEzE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAC9C,IAAI,EAAE,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,GACvC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CA8C7B"}
@@ -0,0 +1,11 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_i18n = require("../../i18n-CyJIoYJT.cjs");
3
+ const require_defineSiteHooks = require("../../defineSiteHooks-C3v3WLS8.cjs");
4
+ exports.applyRuntimeToServerHooks = require_defineSiteHooks.applyRuntimeToServerHooks;
5
+ exports.createAdminIntlLoader = require_defineSiteHooks.createAdminIntlLoader;
6
+ exports.createAdminSeoLoader = require_defineSiteHooks.createAdminSeoLoader;
7
+ exports.defineAdminSiteHooks = require_defineSiteHooks.defineAdminSiteHooks;
8
+ exports.defineSiteHooks = require_defineSiteHooks.defineSiteHooks;
9
+ exports.getCookieHeader = require_i18n.getCookieHeader;
10
+ exports.parseCookieHeader = require_i18n.parseCookieHeader;
11
+ exports.readCookie = require_i18n.readCookie;
@@ -0,0 +1,197 @@
1
+ import type { IntlPayload, PageSeoMeta } from './seo-runtime';
2
+ import type { DynamicSeoResolver, ISRConfig } from '../../types';
3
+ export { getCookieHeader, parseCookieHeader, readCookie } from '../../utils/cookie';
4
+ export type SiteRuntimeConfig = ISRConfig['runtime'];
5
+ export interface SiteRuntimeContext {
6
+ runtime: SiteRuntimeConfig;
7
+ services: RuntimeServices;
8
+ telemetry?: string;
9
+ site?: string;
10
+ }
11
+ export interface RuntimeServices {
12
+ api?: string;
13
+ telemetry?: string;
14
+ }
15
+ export type RuntimeServiceBase = string | ((ctx: SiteRuntimeContext) => string | null | undefined);
16
+ export type IntlMessagesByLocale = Record<string, Record<string, unknown>>;
17
+ export interface CreateAdminIntlLoaderOptions {
18
+ /** 远端字典端点;相对路径会用 runtime.services.api 拼接 */
19
+ endpoint?: string;
20
+ /** 本地兜底字典,通常来自 ssr.config.ts runtime.i18n.fallbackLocal */
21
+ fallbackMessages?: IntlMessagesByLocale;
22
+ /** 远端和本地都无法命中时使用的 locale */
23
+ defaultLocale?: string;
24
+ /** 远端请求超时,默认 1200ms */
25
+ timeoutMs?: number;
26
+ /** 响应头 / dev inspector 里显示的远端来源名 */
27
+ remoteSource?: string;
28
+ /** 响应头 / dev inspector 里显示的 fallback 来源名 */
29
+ fallbackSource?: string;
30
+ }
31
+ export interface AdminSeoFallbackEntry extends PageSeoMeta {
32
+ path: string;
33
+ group?: string;
34
+ }
35
+ export interface CreateAdminSeoLoaderOptions {
36
+ /** 远端 SEO 端点;支持 {pathname} 和路由 params 占位符 */
37
+ endpoint?: string;
38
+ /** 本地兜底 SEO 条目,通常来自 ssr.config.ts runtime.seo.fallbackLocal */
39
+ fallbackEntries?: readonly AdminSeoFallbackEntry[];
40
+ /** 远端请求超时,默认 1200ms */
41
+ timeoutMs?: number;
42
+ /**
43
+ * 参数化路径解析器;admin endpoint 没命中且 fallback 也没命中时按 pattern 匹配
44
+ * 调一个用户函数。让业务页面零 SEO 代码,所有动态 SEO 集中在 ssr.config.ts。
45
+ */
46
+ dynamicResolvers?: readonly DynamicSeoResolver[];
47
+ }
48
+ export interface DefineAdminSiteHooksOptions {
49
+ i18n?: {
50
+ locales?: readonly string[];
51
+ defaultLocale?: string;
52
+ endpoint?: string;
53
+ ttl?: number;
54
+ prefixDefault?: boolean;
55
+ detect?: IntlConfig['detect'];
56
+ fallbackLocal?: IntlMessagesByLocale;
57
+ timeoutMs?: number;
58
+ remoteSource?: string;
59
+ fallbackSource?: string;
60
+ };
61
+ seo?: {
62
+ endpoint?: string;
63
+ ttl?: number;
64
+ fallbackLocal?: readonly Record<string, unknown>[];
65
+ timeoutMs?: number;
66
+ /** 参数化路径的 SEO 解析器(参考 RuntimeSeoConfig.dynamicResolvers)。 */
67
+ dynamicResolvers?: readonly DynamicSeoResolver[];
68
+ };
69
+ beforeRequest?: SiteHooksConfig['beforeRequest'];
70
+ onError?: SiteHooksConfig['onError'];
71
+ headExtras?: SiteHooksConfig['headExtras'];
72
+ }
73
+ export interface IntlConfig {
74
+ /** 支持的 locale 列表,如 ['zh', 'en'];用于 URL 前缀解析 */
75
+ locales?: readonly string[];
76
+ /** 默认 locale —— 必须在 locales 内;同时作为 detect 失败的兜底 */
77
+ defaultLocale?: string;
78
+ /** 默认 locale 是否带 URL 前缀(默认 false:'/about';true:'/zh/about') */
79
+ prefixDefault?: boolean;
80
+ /** 远程 endpoint;`{locale}` 占位符自动替换 */
81
+ endpoint?: string;
82
+ /** 远端响应适配器;支持 admin manifest / SaaS CMS 等非标准响应 */
83
+ transform?: (data: unknown, locale: string) => IntlPayload | null | undefined | Promise<IntlPayload | null | undefined>;
84
+ /** 本地或自定义加载器;与 endpoint 互斥(优先级更高) */
85
+ load?: (locale: string, ctx: SiteRuntimeContext) => Promise<IntlPayload | null>;
86
+ /** locale 检测(默认:cookie `locale` → Accept-Language 前缀 → defaultLocale) */
87
+ detect?: (req: Request) => string;
88
+ /** 缓存 TTL 毫秒,默认 60_000 */
89
+ ttl?: number;
90
+ }
91
+ /** 仅静态值,无远程拉取(PageSeoMeta 直接复用,无需扩展) */
92
+ export type SeoStaticEntry = PageSeoMeta;
93
+ export interface SeoRemoteEntry<T = unknown> {
94
+ /** 远程 endpoint;`{paramName}` 占位符自动替换为路由捕获组 */
95
+ endpoint: string;
96
+ /** 把远程响应转成 PageSeoMeta */
97
+ transform: (data: T, params: Record<string, string>) => PageSeoMeta | null;
98
+ /** 缓存 TTL 毫秒,默认 300_000(5 分钟) */
99
+ ttl?: number;
100
+ }
101
+ export interface SeoLocalEntry {
102
+ /** 本地加载器:dynamic import / fs.readFile / 内存 Map 都可 */
103
+ load: (params: Record<string, string>, ctx: SiteRuntimeContext) => Promise<PageSeoMeta | null> | PageSeoMeta | null;
104
+ /** 缓存 TTL 毫秒,默认 300_000 */
105
+ ttl?: number;
106
+ }
107
+ export type SeoEntry = SeoStaticEntry | SeoRemoteEntry | SeoLocalEntry;
108
+ export interface SiteHooksConfig {
109
+ /** i18n 配置 */
110
+ intl?: IntlConfig;
111
+ /** SEO 路由表:path pattern(支持 `:param`)→ 静态 meta 或 remote loader */
112
+ seo?: Record<string, SeoEntry | (() => Promise<PageSeoMeta | null> | PageSeoMeta | null)>;
113
+ /**
114
+ * 错误回调。平台默认会先执行 console + runtime.telemetry errors endpoint 上报;
115
+ * 自定义 onError 作为业务补充回调追加执行,不会关闭平台默认上报。
116
+ */
117
+ onError?: (err: unknown, req: Request, ctx: {
118
+ traceId: string;
119
+ locale?: string;
120
+ }) => void | Promise<void>;
121
+ /**
122
+ * 请求级 ctx 扩展(除 engine 基线字段 + locale 之外的业务字段)。
123
+ *
124
+ * 典型用途:userId、tenantId、requestSegment、审计字段。
125
+ * 返回值会合并进 RequestContext;Server Component 使用
126
+ * `getRequestContext()` 读取,Client Component 需要由 Server Component
127
+ * 作为 props 传入。
128
+ *
129
+ * 注意:
130
+ * - 这里处在首屏关键路径上,应只做 header/cookie 解析。
131
+ * - 不要在这里查数据库或慢 API。
132
+ * - 不要在这里解析 A/B cookie;页面用 `getVariant()`。
133
+ */
134
+ beforeRequest?: (req: Request) => Record<string, unknown> | Promise<Record<string, unknown>>;
135
+ /**
136
+ * 注入到 `<head>` 末尾(`</head>` 之前)的 raw HTML 字符串。
137
+ *
138
+ * 通过 SSR HTML stream transformer 注入,**完全脱离 React 树** —— 不进 client RSC
139
+ * payload,不触发 React 19 + plugin-rsc 的 head children mismatch hydration 错误。
140
+ *
141
+ * 典型用途:
142
+ * - 主题 init inline blocking script(避免 FOUC,next-themes 同款)
143
+ * - GA / GTM snippet
144
+ * - A/B variant flag injection
145
+ * - CSP nonce / preload hints
146
+ *
147
+ * 业务侧返回完整的标签 HTML(含 `<script>` / `<style>` / `<meta>` 外壳)。返回
148
+ * 空字符串 / undefined 时跳过注入。
149
+ *
150
+ * ctx.nonce:当前请求的 CSP nonce(engine 自动注入)。业务侧的 inline `<script>`
151
+ * 必须带上 nonce 属性,否则被 nonce-based CSP 阻断:
152
+ *
153
+ * ```ts
154
+ * import { THEME_INIT_SCRIPT } from '@app/ui/theme-utils';
155
+ *
156
+ * defineAdminSiteHooks({
157
+ * headExtras: ({ nonce }) =>
158
+ * `<script${nonce ? ` nonce="${nonce}"` : ''}>${THEME_INIT_SCRIPT}</script>`,
159
+ * });
160
+ * ```
161
+ */
162
+ headExtras?: (ctx: {
163
+ nonce?: string;
164
+ }) => string | undefined;
165
+ }
166
+ export declare function createAdminIntlLoader(options?: CreateAdminIntlLoaderOptions): NonNullable<IntlConfig['load']>;
167
+ export declare function createAdminSeoLoader(options?: CreateAdminSeoLoaderOptions): SeoLocalEntry['load'];
168
+ export declare function defineAdminSiteHooks(options?: DefineAdminSiteHooksOptions): ServerHooksOutput;
169
+ export interface ServerHooksOutput {
170
+ /** site URL —— SEO 注入时把 image/canonical 等相对路径解析为绝对 URL */
171
+ siteBaseUrl?: string;
172
+ /** 浏览器可访问的 API base —— 注入到 csr-shell 的 window.__API_BASE__ */
173
+ apiBaseUrl?: string;
174
+ /**
175
+ * 原始 intl 配置(用户在 defineSiteHooks 里写的那份),透传出来给 app.tsx 的 parseLocale 用
176
+ * —— 让 i18n 配置只声明一次,不需要单独 i18n.config.ts
177
+ */
178
+ intl?: IntlConfig;
179
+ beforeRequest: (req: Request, engineCtx: {
180
+ traceId: string;
181
+ startedAt: number;
182
+ }) => Promise<Record<string, unknown>>;
183
+ loadIntl: (req: Request) => Promise<IntlPayload | null>;
184
+ loadSeoMeta: (req: Request) => Promise<PageSeoMeta | null>;
185
+ onError: (err: unknown, req: Request, ctx: {
186
+ traceId: string;
187
+ locale?: string;
188
+ }) => void | Promise<void>;
189
+ /** 注入 `<head>` 末尾的 raw HTML —— 详见 SiteHooksConfig.headExtras 注释 */
190
+ headExtras?: (ctx: {
191
+ nonce?: string;
192
+ }) => string | undefined;
193
+ __configureRuntime?: (runtime: SiteRuntimeConfig) => ServerHooksOutput;
194
+ }
195
+ export declare function defineSiteHooks(config: SiteHooksConfig): ServerHooksOutput;
196
+ export declare function applyRuntimeToServerHooks<T extends object>(hooks: T, runtime: SiteRuntimeConfig): T;
197
+ //# sourceMappingURL=defineSiteHooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defineSiteHooks.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/defineSiteHooks.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EAGV,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpF,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAcD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,kBAAkB,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEnG,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,4BAA4B;IAC3C,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD;AAgCD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9B,aAAa,CAAC,EAAE,oBAAoB,CAAC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACnD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,4DAA4D;QAC5D,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;KAClD,CAAC;IACF,aAAa,CAAC,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IAEzB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IAGxB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,KACX,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9E,qCAAqC;IACrC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChF,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;IAClC,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,WAAW,GAAG,IAAI,CAAC;IAC3E,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,IAAI,EAAE,CACJ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,kBAAkB,KACpB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;IACtD,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,cAAc,GAAG,aAAa,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1F;;;OAGG;IACH,OAAO,CAAC,EAAE,CACR,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7F;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D;AAyBD,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CA+BjC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,aAAa,CAAC,MAAM,CAAC,CAqDvB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,iBAAiB,CAEjG;AA6DD,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,CACb,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACxD,WAAW,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3D,OAAO,EAAE,CACP,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KACtC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7D,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,iBAAiB,CAAC;CACxE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAE1E;AAED,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,EACxD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,iBAAiB,GACzB,CAAC,CAiDH"}
@@ -0,0 +1,3 @@
1
+ import { c as parseCookieHeader, l as readCookie, s as getCookieHeader } from "../../i18n-Dobe0Wxn.js";
2
+ import { a as defineSiteHooks, i as defineAdminSiteHooks, n as createAdminIntlLoader, r as createAdminSeoLoader, t as applyRuntimeToServerHooks } from "../../defineSiteHooks-BeVy-qPH.js";
3
+ export { applyRuntimeToServerHooks, createAdminIntlLoader, createAdminSeoLoader, defineAdminSiteHooks, defineSiteHooks, getCookieHeader, parseCookieHeader, readCookie };
@@ -0,0 +1,2 @@
1
+ export default function DevCssLifecycleBoundary(): null;
2
+ //# sourceMappingURL=dev-css-handoff.client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev-css-handoff.client.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/dev-css-handoff.client.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,UAAU,uBAAuB,SAE9C"}
@@ -0,0 +1,57 @@
1
+ interface InspectorState {
2
+ mode: string;
3
+ modeSource: string;
4
+ strategy: string;
5
+ cache: string;
6
+ fallback: string;
7
+ i18nSource: string;
8
+ language: string;
9
+ status: number | null;
10
+ url: string;
11
+ }
12
+ type InspectorMode = (typeof MODE_LINKS)[number]['key'] | 'unknown';
13
+ interface InspectorViewModel {
14
+ resolvedMode: InspectorMode;
15
+ modeCode: string;
16
+ modeLabel: string;
17
+ modeSource: string;
18
+ strategy: string;
19
+ cacheTone: string;
20
+ cacheLabel: string;
21
+ fallbackActive: boolean;
22
+ }
23
+ declare const MODE_LINKS: readonly [{
24
+ readonly key: "isr";
25
+ readonly label: "ISR 缓存";
26
+ readonly desc: "当前 URL 走缓存渲染;命中后回放,过期后按 SWR 重生。";
27
+ }, {
28
+ readonly key: "ssr";
29
+ readonly label: "SSR 实时";
30
+ readonly desc: "当前 URL 每次请求实时渲染,按设计绕过页面缓存。";
31
+ }, {
32
+ readonly key: "ssg";
33
+ readonly label: "SSG 策略";
34
+ readonly desc: "开发态验证 SSG 缓存策略;生产静态产物来自 build 预生成。";
35
+ }, {
36
+ readonly key: "csr";
37
+ readonly label: "CSR 降级";
38
+ readonly desc: "强制进入客户端自救壳,验证 fallback 体验。";
39
+ }];
40
+ export declare function installDevRenderInspector(): void;
41
+ export declare function isDevRenderInspectorRuntimeEnabled(env: {
42
+ DEV?: boolean;
43
+ } | undefined, hot: unknown): boolean;
44
+ interface InspectorDocumentTarget {
45
+ body: HTMLElement | null;
46
+ }
47
+ interface InspectorMountTarget extends InspectorDocumentTarget {
48
+ getElementById: (elementId: string) => HTMLElement | null;
49
+ }
50
+ export declare function shouldDeferDevRenderInspectorMount(doc: InspectorDocumentTarget): boolean;
51
+ export declare function shouldMountDevRenderInspector(doc: InspectorMountTarget): boolean;
52
+ export declare function resolveDevRenderInspectorView({ state, href, }: {
53
+ state: Pick<InspectorState, 'mode' | 'modeSource' | 'cache' | 'fallback' | 'strategy'> | null;
54
+ href: string;
55
+ }): InspectorViewModel;
56
+ export {};
57
+ //# sourceMappingURL=dev-render-inspector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev-render-inspector.d.ts","sourceRoot":"","sources":["../../../src/defaults/runtime/dev-render-inspector.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAOD,KAAK,aAAa,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;AAEpE,UAAU,kBAAkB;IAC1B,YAAY,EAAE,aAAa,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;EAqBN,CAAC;AAEX,wBAAgB,yBAAyB,IAAI,IAAI,CAoGhD;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAClC,GAAG,EAAE,OAAO,GACX,OAAO,CAET;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CAC1B;AAED,UAAU,oBAAqB,SAAQ,uBAAuB;IAC5D,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;CAC3D;AAED,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAExF;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAEhF;AA+ED,wBAAgB,6BAA6B,CAAC,EAC5C,KAAK,EACL,IAAI,GACL,EAAE;IACD,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9F,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,kBAAkB,CA0BrB"}