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,837 @@
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
+
11
+ import {
12
+ __clearBrowserTelemetryHandle,
13
+ __setBrowserTelemetryHandle,
14
+ type TelemetryCaptureOptions,
15
+ type TelemetryEventOptions,
16
+ type TelemetryMeasureOptions,
17
+ type TelemetryRuntimeHandle,
18
+ } from '../../runtime/telemetry';
19
+
20
+ export interface BrowserObservabilityUser {
21
+ id?: string;
22
+ tenantId?: string;
23
+ segment?: string;
24
+ traits?: Record<string, unknown>;
25
+ }
26
+
27
+ export interface BrowserAnalyticsOptions {
28
+ endpoint?: string;
29
+ sampleRate?: number;
30
+ batchSize?: number;
31
+ flushIntervalMs?: number;
32
+ maxQueueSize?: number;
33
+ retryBaseDelayMs?: number;
34
+ retryMaxDelayMs?: number;
35
+ webVitals?: boolean;
36
+ trackInitialPage?: boolean;
37
+ }
38
+
39
+ export interface BrowserErrorReportingOptions {
40
+ endpoint?: string;
41
+ sampleRate?: number;
42
+ batchSize?: number;
43
+ flushIntervalMs?: number;
44
+ maxQueueSize?: number;
45
+ retryBaseDelayMs?: number;
46
+ retryMaxDelayMs?: number;
47
+ captureResourceErrors?: boolean;
48
+ /**
49
+ * 当错误来源 / 堆栈匹配下面的正则之一时,丢弃不上报。
50
+ *
51
+ * 默认会过滤 dev-runtime 噪声(@vite/client、react-refresh、HMR ping
52
+ * 等),避免开发态 WebSocket 重连时刷出的 "send was called before
53
+ * connect" 这类错误把 admin observability 通道刷爆。
54
+ *
55
+ * 业务可以在这里追加自己的过滤规则;传 `false` 关掉所有过滤(不推荐)。
56
+ */
57
+ ignoreSourcePatterns?: RegExp[] | false;
58
+ }
59
+
60
+ /** Dev-runtime 噪声 —— 由开发工具链自身产生的错误,并非业务问题。
61
+ * Sentry 风格 inbound filter,industry-standard。 */
62
+ const DEFAULT_IGNORE_SOURCE_PATTERNS: RegExp[] = [
63
+ /@vite\/client/,
64
+ /@react-refresh/,
65
+ /__vite_ping/,
66
+ /webpack-internal:\/\//,
67
+ /webpack-hmr/,
68
+ // Chrome extensions
69
+ /^chrome-extension:\/\//,
70
+ /^moz-extension:\/\//,
71
+ /^safari-extension:\/\//,
72
+ ];
73
+
74
+ export interface BrowserObservabilityOptions {
75
+ app: string;
76
+ release?: string;
77
+ environment?: string;
78
+ user?: BrowserObservabilityUser;
79
+ includeQueryString?: boolean;
80
+ analytics?: false | BrowserAnalyticsOptions;
81
+ errorReporting?: false | BrowserErrorReportingOptions;
82
+ }
83
+
84
+ export interface BrowserObservabilityHandle {
85
+ track(name: string, properties?: Record<string, unknown>, options?: TelemetryEventOptions): void;
86
+ capture(error: unknown, context?: TelemetryCaptureOptions): void;
87
+ measure(name: string, value: number, options?: TelemetryMeasureOptions): void;
88
+ page(url?: URL | string): void;
89
+ captureActionError(error: unknown, actionId: string): void;
90
+ setUser(user: BrowserObservabilityUser | null): void;
91
+ flush(): Promise<void> | void;
92
+ shutdown(): void;
93
+ }
94
+
95
+ interface AnalyticsClientLike {
96
+ track(name: string, properties?: Record<string, unknown>, options?: TelemetryEventOptions): void;
97
+ page(path?: string, options?: Record<string, unknown>): void;
98
+ measure(name: string, value: number, options?: TelemetryMeasureOptions): void;
99
+ installWebVitals?(): () => void;
100
+ flush?(): Promise<void> | void;
101
+ shutdown?(): void;
102
+ }
103
+
104
+ interface ErrorReporterLike {
105
+ captureException(error: unknown, context?: TelemetryCaptureOptions): void;
106
+ flush?(): Promise<void> | void;
107
+ shutdown?(): void;
108
+ installGlobalHandlers?(options?: Record<string, unknown>): () => void;
109
+ }
110
+
111
+ export async function installBrowserObservability(
112
+ options: BrowserObservabilityOptions
113
+ ): Promise<BrowserObservabilityHandle> {
114
+ const cleanups: Array<() => void> = [];
115
+ let currentUser: BrowserObservabilityUser | undefined = options.user;
116
+ const getUser = () => currentUser;
117
+ const analytics =
118
+ options.analytics === false ? null : createEndpointAnalyticsClient(options, getUser);
119
+ const errorReporter =
120
+ options.errorReporting === false ? null : createEndpointErrorReporter(options, getUser);
121
+
122
+ if (
123
+ analytics &&
124
+ options.analytics !== false &&
125
+ options.analytics?.webVitals &&
126
+ typeof analytics.installWebVitals === 'function'
127
+ ) {
128
+ cleanups.push(analytics.installWebVitals());
129
+ }
130
+
131
+ if (analytics && options.analytics !== false && options.analytics?.trackInitialPage !== false) {
132
+ analytics.page();
133
+ }
134
+
135
+ const globalCleanup = errorReporter?.installGlobalHandlers?.({
136
+ captureResourceErrors:
137
+ options.errorReporting !== false ? options.errorReporting?.captureResourceErrors : undefined,
138
+ });
139
+ if (globalCleanup) {
140
+ cleanups.push(globalCleanup);
141
+ }
142
+
143
+ const handle: BrowserObservabilityHandle & TelemetryRuntimeHandle = {
144
+ track(name, properties, trackOptions) {
145
+ analytics?.track(name, properties, trackOptions);
146
+ },
147
+ capture(error, context) {
148
+ errorReporter?.captureException(error, context);
149
+ },
150
+ measure(name, value, measureOptions) {
151
+ analytics?.measure(name, value, measureOptions);
152
+ },
153
+ page(url) {
154
+ if (!analytics) return;
155
+ analytics.page(
156
+ typeof url === 'string'
157
+ ? sanitizeUrl(url, options.includeQueryString)
158
+ : url
159
+ ? toPagePath(url, options.includeQueryString)
160
+ : undefined
161
+ );
162
+ },
163
+ captureActionError(error, actionId) {
164
+ errorReporter?.captureException(error, {
165
+ source: 'server-action',
166
+ tags: { actionId },
167
+ });
168
+ },
169
+ setUser(user) {
170
+ currentUser = user ?? undefined;
171
+ },
172
+ flush() {
173
+ return Promise.all([analytics?.flush?.(), errorReporter?.flush?.()]).then(() => undefined);
174
+ },
175
+ shutdown() {
176
+ __clearBrowserTelemetryHandle(handle);
177
+ for (const cleanup of cleanups.splice(0)) {
178
+ cleanup();
179
+ }
180
+ analytics?.shutdown?.();
181
+ errorReporter?.shutdown?.();
182
+ },
183
+ };
184
+ __setBrowserTelemetryHandle(handle);
185
+ return handle;
186
+ }
187
+
188
+ function toPagePath(url: URL, includeQueryString?: boolean): string {
189
+ return includeQueryString ? `${url.pathname}${url.search}` : url.pathname;
190
+ }
191
+
192
+ function createEndpointAnalyticsClient(
193
+ options: BrowserObservabilityOptions,
194
+ getUser: () => BrowserObservabilityUser | undefined
195
+ ): AnalyticsClientLike | null {
196
+ const analyticsOptions = options.analytics === false ? undefined : options.analytics;
197
+ const endpoint = analyticsOptions?.endpoint;
198
+ if (!endpoint) return null;
199
+
200
+ const base = createEndpointQueue(
201
+ options,
202
+ {
203
+ endpoint,
204
+ batchSize: analyticsOptions?.batchSize ?? 20,
205
+ flushIntervalMs: analyticsOptions?.flushIntervalMs ?? 3000,
206
+ maxQueueSize: analyticsOptions?.maxQueueSize ?? 500,
207
+ retryBaseDelayMs: analyticsOptions?.retryBaseDelayMs ?? 1000,
208
+ retryMaxDelayMs: analyticsOptions?.retryMaxDelayMs ?? 30000,
209
+ sampleRate: analyticsOptions?.sampleRate ?? 1,
210
+ key: 'isr_engine_builtin_analytics',
211
+ },
212
+ getUser
213
+ );
214
+
215
+ return {
216
+ track(name, properties, trackOptions) {
217
+ base.enqueue({
218
+ name,
219
+ properties: properties ?? {},
220
+ tags: normalizeTags(trackOptions?.tags),
221
+ });
222
+ },
223
+ page(path) {
224
+ base.enqueue({
225
+ name: 'page_view',
226
+ properties: {
227
+ path: path ?? currentPath(options.includeQueryString),
228
+ title: isBrowser() && typeof document.title === 'string' ? document.title : undefined,
229
+ referrer:
230
+ isBrowser() && typeof document.referrer === 'string' ? document.referrer : undefined,
231
+ },
232
+ });
233
+ },
234
+ measure(name, value, measureOptions) {
235
+ if (!Number.isFinite(value)) return;
236
+ base.enqueue({
237
+ name: 'metric',
238
+ properties: {
239
+ metric: name,
240
+ value,
241
+ unit: measureOptions?.unit,
242
+ ...(measureOptions?.properties ?? {}),
243
+ },
244
+ tags: normalizeTags(measureOptions?.tags),
245
+ });
246
+ },
247
+ installWebVitals() {
248
+ return installFallbackWebVitals(base, options.includeQueryString);
249
+ },
250
+ flush() {
251
+ return base.flush();
252
+ },
253
+ shutdown() {
254
+ base.shutdown();
255
+ },
256
+ };
257
+ }
258
+
259
+ function createEndpointErrorReporter(
260
+ options: BrowserObservabilityOptions,
261
+ getUser: () => BrowserObservabilityUser | undefined
262
+ ): ErrorReporterLike | null {
263
+ const errorOptions = options.errorReporting === false ? undefined : options.errorReporting;
264
+ const endpoint = errorOptions?.endpoint;
265
+ if (!endpoint) return null;
266
+
267
+ const base = createEndpointQueue(
268
+ options,
269
+ {
270
+ endpoint,
271
+ batchSize: errorOptions?.batchSize ?? 10,
272
+ flushIntervalMs: errorOptions?.flushIntervalMs ?? 3000,
273
+ maxQueueSize: errorOptions?.maxQueueSize ?? 200,
274
+ retryBaseDelayMs: errorOptions?.retryBaseDelayMs ?? 1000,
275
+ retryMaxDelayMs: errorOptions?.retryMaxDelayMs ?? 30000,
276
+ sampleRate: errorOptions?.sampleRate ?? 1,
277
+ key: 'isr_engine_builtin_errors',
278
+ },
279
+ getUser
280
+ );
281
+
282
+ const captureException = (error: unknown, context: TelemetryCaptureOptions = {}) => {
283
+ const normalized = normalizeError(error);
284
+ base.enqueue({
285
+ message: normalized.message,
286
+ name: normalized.name,
287
+ stack: normalized.stack,
288
+ level: typeof context.level === 'string' ? context.level : 'error',
289
+ source: typeof context.source === 'string' ? context.source : undefined,
290
+ tags: normalizeTags(context.tags),
291
+ extra: isRecord(context.extra) ? context.extra : undefined,
292
+ fingerprint: Array.isArray(context.fingerprint) ? context.fingerprint : undefined,
293
+ });
294
+ };
295
+
296
+ // 解析过滤规则:errorOptions.ignoreSourcePatterns
297
+ // - undefined / 缺省:用 DEFAULT_IGNORE_SOURCE_PATTERNS(开发噪声 + 浏览器扩展)
298
+ // - false:关闭过滤(不推荐)
299
+ // - 自定义数组:与默认合并,业务可以追加而不是替换
300
+ const ignorePatterns = resolveIgnorePatterns(errorOptions?.ignoreSourcePatterns);
301
+
302
+ return {
303
+ captureException,
304
+ installGlobalHandlers(globalOptions = {}) {
305
+ if (!isBrowser()) return () => {};
306
+ const captureResourceErrors = globalOptions.captureResourceErrors !== false;
307
+ const onError = (event: ErrorEvent | Event) => {
308
+ if (event instanceof ErrorEvent) {
309
+ if (shouldIgnore(ignorePatterns, event.filename, event.error)) return;
310
+ captureException(event.error ?? event.message, {
311
+ source: event.filename,
312
+ extra: { lineno: event.lineno, colno: event.colno },
313
+ });
314
+ return;
315
+ }
316
+ if (!captureResourceErrors) return;
317
+ const target = event.target;
318
+ if (target instanceof HTMLElement) {
319
+ const url =
320
+ target instanceof HTMLImageElement || target instanceof HTMLScriptElement
321
+ ? target.src
322
+ : target instanceof HTMLLinkElement
323
+ ? target.href
324
+ : undefined;
325
+ if (shouldIgnore(ignorePatterns, url, undefined)) return;
326
+ captureException('Resource load failed', {
327
+ level: 'warning',
328
+ source: target.tagName.toLowerCase(),
329
+ extra: { url: sanitizeUrl(url, options.includeQueryString) },
330
+ });
331
+ }
332
+ };
333
+ const onRejection = (event: PromiseRejectionEvent) => {
334
+ if (shouldIgnore(ignorePatterns, undefined, event.reason)) return;
335
+ captureException(event.reason, { source: 'unhandledrejection' });
336
+ };
337
+ window.addEventListener('error', onError, true);
338
+ window.addEventListener('unhandledrejection', onRejection);
339
+ return () => {
340
+ window.removeEventListener('error', onError, true);
341
+ window.removeEventListener('unhandledrejection', onRejection);
342
+ };
343
+ },
344
+ flush() {
345
+ return base.flush();
346
+ },
347
+ shutdown() {
348
+ base.shutdown();
349
+ },
350
+ };
351
+ }
352
+
353
+ interface FallbackBaseOptions {
354
+ endpoint: string;
355
+ batchSize: number;
356
+ flushIntervalMs: number;
357
+ maxQueueSize: number;
358
+ retryBaseDelayMs: number;
359
+ retryMaxDelayMs: number;
360
+ sampleRate: number;
361
+ key: string;
362
+ }
363
+
364
+ interface FallbackPayload {
365
+ name?: string;
366
+ message?: string;
367
+ [key: string]: unknown;
368
+ }
369
+
370
+ function createEndpointQueue(
371
+ options: BrowserObservabilityOptions,
372
+ baseOptions: FallbackBaseOptions,
373
+ getUser: () => BrowserObservabilityUser | undefined
374
+ ) {
375
+ const queue: FallbackPayload[] = [];
376
+ const sessionId = readOrCreateBrowserId(`${baseOptions.key}_session`);
377
+ const anonymousId = readOrCreateBrowserId(`${baseOptions.key}_anonymous`);
378
+ let timer: number | null = null;
379
+ let retryTimer: number | null = null;
380
+ let inFlight = false;
381
+ let consecutiveFailures = 0;
382
+ let disposeLifecycleListeners: (() => void) | null = null;
383
+
384
+ const flush = async (flushOptions: { beacon?: boolean } = {}) => {
385
+ if (queue.length === 0) return;
386
+ if (!flushOptions.beacon && (inFlight || retryTimer !== null)) return;
387
+ const payloads = queue.splice(0);
388
+ const isError = baseOptions.key.includes('errors');
389
+ const body = JSON.stringify({
390
+ app: options.app,
391
+ sentAt: Date.now(),
392
+ [isError ? 'reports' : 'events']: payloads,
393
+ });
394
+ let shouldDrainAfterSuccess = false;
395
+ inFlight = true;
396
+ try {
397
+ await postJson(baseOptions.endpoint, body, flushOptions.beacon);
398
+ consecutiveFailures = 0;
399
+ shouldDrainAfterSuccess = !flushOptions.beacon && queue.length >= baseOptions.batchSize;
400
+ if (queue.length === 0) {
401
+ clearRetryTimer();
402
+ }
403
+ } catch {
404
+ queue.unshift(...payloads);
405
+ queue.splice(baseOptions.maxQueueSize);
406
+ consecutiveFailures += 1;
407
+ scheduleRetry();
408
+ } finally {
409
+ inFlight = false;
410
+ if (shouldDrainAfterSuccess) void flush();
411
+ }
412
+ };
413
+
414
+ const enqueue = (payload: FallbackPayload) => {
415
+ if (baseOptions.sampleRate <= 0) return;
416
+ if (baseOptions.sampleRate < 1 && Math.random() > baseOptions.sampleRate) return;
417
+
418
+ queue.push({
419
+ id: createId(baseOptions.key.includes('errors') ? 'err' : 'evt'),
420
+ app: options.app,
421
+ ts: Date.now(),
422
+ release: options.release,
423
+ environment: options.environment,
424
+ sessionId,
425
+ anonymousId,
426
+ user: getUser(),
427
+ url: currentPath(options.includeQueryString),
428
+ ...payload,
429
+ });
430
+ if (queue.length > baseOptions.maxQueueSize) {
431
+ queue.splice(0, queue.length - baseOptions.maxQueueSize);
432
+ }
433
+ if (queue.length >= baseOptions.batchSize) void flush();
434
+ };
435
+
436
+ const shutdown = () => {
437
+ if (timer !== null) {
438
+ clearInterval(timer);
439
+ timer = null;
440
+ }
441
+ clearRetryTimer();
442
+ disposeLifecycleListeners?.();
443
+ disposeLifecycleListeners = null;
444
+ void flush({ beacon: true });
445
+ };
446
+
447
+ const scheduleRetry = () => {
448
+ if (!isBrowser() || retryTimer !== null || queue.length === 0) return;
449
+ const base = Math.max(100, baseOptions.retryBaseDelayMs);
450
+ const max = Math.max(base, baseOptions.retryMaxDelayMs);
451
+ const backoff = Math.min(max, base * 2 ** Math.max(0, consecutiveFailures - 1));
452
+ const jitter = Math.floor(backoff * 0.2 * Math.random());
453
+ retryTimer = window.setTimeout(() => {
454
+ retryTimer = null;
455
+ void flush();
456
+ }, backoff + jitter);
457
+ };
458
+
459
+ const clearRetryTimer = () => {
460
+ if (retryTimer !== null && isBrowser()) {
461
+ window.clearTimeout(retryTimer);
462
+ }
463
+ retryTimer = null;
464
+ };
465
+
466
+ if (isBrowser()) {
467
+ if (baseOptions.flushIntervalMs > 0) {
468
+ timer = window.setInterval(() => void flush(), baseOptions.flushIntervalMs);
469
+ }
470
+ const flushOnPageHide = () => void flush({ beacon: true });
471
+ const onHidden = () => {
472
+ if (document.visibilityState === 'hidden') void flush({ beacon: true });
473
+ };
474
+ const onOnline = () => void flush();
475
+ window.addEventListener('pagehide', flushOnPageHide);
476
+ window.addEventListener('online', onOnline);
477
+ document.addEventListener('visibilitychange', onHidden);
478
+ disposeLifecycleListeners = () => {
479
+ window.removeEventListener('pagehide', flushOnPageHide);
480
+ window.removeEventListener('online', onOnline);
481
+ document.removeEventListener('visibilitychange', onHidden);
482
+ };
483
+ }
484
+
485
+ return { enqueue, flush, shutdown };
486
+ }
487
+
488
+ function installFallbackWebVitals(
489
+ base: ReturnType<typeof createEndpointQueue>,
490
+ includeQueryString?: boolean
491
+ ): () => void {
492
+ if (!isBrowser() || typeof PerformanceObserver === 'undefined') return () => {};
493
+ const cleanups: Array<() => void> = [];
494
+ let cls = 0;
495
+ let lcp = 0;
496
+ let inp = 0;
497
+ let inpEntry: (PerformanceEntry & Record<string, unknown>) | undefined;
498
+
499
+ const observe = (
500
+ type: string,
501
+ callback: (entry: PerformanceEntry & Record<string, unknown>) => void,
502
+ options: Record<string, unknown> = {}
503
+ ) => {
504
+ try {
505
+ const observer = new PerformanceObserver(list => {
506
+ for (const entry of list.getEntries()) {
507
+ callback(entry as PerformanceEntry & Record<string, unknown>);
508
+ }
509
+ });
510
+ observer.observe({ type, buffered: true, ...options });
511
+ cleanups.push(() => observer.disconnect());
512
+ } catch {
513
+ /* Unsupported metric. */
514
+ }
515
+ };
516
+
517
+ observe('paint', entry => {
518
+ if (entry.name === 'first-contentful-paint') {
519
+ base.enqueue({
520
+ name: 'web_vital',
521
+ properties: createWebVitalPayload('FCP', entry.startTime, includeQueryString, entry),
522
+ });
523
+ }
524
+ });
525
+ observe('largest-contentful-paint', entry => {
526
+ lcp = entry.startTime;
527
+ });
528
+ observe('layout-shift', entry => {
529
+ if (entry.hadRecentInput !== true && typeof entry.value === 'number') {
530
+ cls += entry.value;
531
+ }
532
+ });
533
+ observe(
534
+ 'event',
535
+ entry => {
536
+ if (
537
+ typeof entry.duration === 'number' &&
538
+ typeof entry.interactionId === 'number' &&
539
+ entry.interactionId > 0
540
+ ) {
541
+ if (entry.duration >= inp) {
542
+ inp = entry.duration;
543
+ inpEntry = entry;
544
+ }
545
+ }
546
+ },
547
+ { durationThreshold: 40 }
548
+ );
549
+
550
+ const flushFinalVitals = () => {
551
+ if (lcp > 0) {
552
+ base.enqueue({
553
+ name: 'web_vital',
554
+ properties: createWebVitalPayload('LCP', lcp, includeQueryString),
555
+ });
556
+ }
557
+ if (inp > 0) {
558
+ base.enqueue({
559
+ name: 'web_vital',
560
+ properties: createWebVitalPayload('INP', inp, includeQueryString, inpEntry),
561
+ });
562
+ }
563
+ if (cls > 0) {
564
+ base.enqueue({
565
+ name: 'web_vital',
566
+ properties: createWebVitalPayload('CLS', cls, includeQueryString),
567
+ });
568
+ }
569
+ };
570
+
571
+ const nav = performance.getEntriesByType('navigation')[0] as
572
+ PerformanceNavigationTiming | undefined;
573
+ if (nav) {
574
+ base.enqueue({
575
+ name: 'web_vital',
576
+ properties: createWebVitalPayload(
577
+ 'TTFB',
578
+ nav.responseStart,
579
+ includeQueryString,
580
+ nav as unknown as PerformanceEntry & Record<string, unknown>
581
+ ),
582
+ });
583
+ }
584
+
585
+ const flushIfHidden = () => {
586
+ if (document.visibilityState === 'hidden') flushFinalVitals();
587
+ };
588
+ window.addEventListener('pagehide', flushFinalVitals);
589
+ document.addEventListener('visibilitychange', flushIfHidden);
590
+ cleanups.push(() => {
591
+ window.removeEventListener('pagehide', flushFinalVitals);
592
+ document.removeEventListener('visibilitychange', flushIfHidden);
593
+ });
594
+ return () => cleanups.splice(0).forEach(cleanup => cleanup());
595
+ }
596
+
597
+ type WebVitalName = 'CLS' | 'FCP' | 'INP' | 'LCP' | 'TTFB';
598
+
599
+ function createWebVitalPayload(
600
+ name: WebVitalName,
601
+ value: number,
602
+ includeQueryString?: boolean,
603
+ entry?: PerformanceEntry & Record<string, unknown>
604
+ ): Record<string, unknown> {
605
+ const payload: Record<string, unknown> = {
606
+ name,
607
+ value,
608
+ href: currentHref(includeQueryString),
609
+ path: currentPath(includeQueryString),
610
+ route: currentRoute(),
611
+ title: isBrowser() && typeof document.title === 'string' ? document.title : undefined,
612
+ navigationType: currentNavigationType(),
613
+ visibilityState:
614
+ isBrowser() && typeof document.visibilityState === 'string'
615
+ ? document.visibilityState
616
+ : undefined,
617
+ device: currentDevice(),
618
+ viewport: currentViewport(),
619
+ connection: currentConnection(),
620
+ entryType: entry?.entryType,
621
+ startTime: typeof entry?.startTime === 'number' ? entry.startTime : undefined,
622
+ };
623
+ const target = pickPerformanceTarget(entry);
624
+ if (target) payload.target = target;
625
+ if (typeof entry?.interactionId === 'number') payload.interactionId = entry.interactionId;
626
+ return payload;
627
+ }
628
+
629
+ async function postJson(endpoint: string, body: string, beacon?: boolean): Promise<void> {
630
+ if (beacon && isBrowser() && typeof navigator.sendBeacon === 'function') {
631
+ const payload =
632
+ typeof Blob !== 'undefined' ? new Blob([body], { type: 'application/json' }) : body;
633
+ if (navigator.sendBeacon(endpoint, payload)) return;
634
+ }
635
+ if (typeof fetch !== 'function') return;
636
+ const response = await fetch(endpoint, {
637
+ method: 'POST',
638
+ headers: { 'content-type': 'application/json' },
639
+ body,
640
+ keepalive: beacon,
641
+ });
642
+ if (!response.ok) {
643
+ throw new Error(`observability upload failed: ${response.status}`);
644
+ }
645
+ }
646
+
647
+ function currentPath(includeQueryString?: boolean): string {
648
+ if (!isBrowser()) return '/';
649
+ const { pathname, search } = window.location;
650
+ return includeQueryString ? `${pathname}${search}` : pathname;
651
+ }
652
+
653
+ function currentHref(includeQueryString?: boolean): string | undefined {
654
+ if (!isBrowser()) return undefined;
655
+ try {
656
+ const url = new URL(window.location.href);
657
+ return includeQueryString
658
+ ? `${url.origin}${url.pathname}${url.search}`
659
+ : `${url.origin}${url.pathname}`;
660
+ } catch {
661
+ return undefined;
662
+ }
663
+ }
664
+
665
+ function currentRoute(): string | undefined {
666
+ if (!isBrowser()) return undefined;
667
+ const explicit =
668
+ document.documentElement?.getAttribute('data-route') ??
669
+ document.body?.getAttribute('data-route') ??
670
+ undefined;
671
+ if (explicit) return explicit;
672
+ const globalRoute = (window as unknown as { __ISR_ENGINE_ROUTE__?: unknown })
673
+ .__ISR_ENGINE_ROUTE__;
674
+ return typeof globalRoute === 'string' && globalRoute.trim() ? globalRoute : undefined;
675
+ }
676
+
677
+ function currentNavigationType(): string | undefined {
678
+ if (!isBrowser() || typeof performance.getEntriesByType !== 'function') return undefined;
679
+ const nav = performance.getEntriesByType('navigation')[0] as
680
+ PerformanceNavigationTiming | undefined;
681
+ return typeof nav?.type === 'string' ? nav.type : undefined;
682
+ }
683
+
684
+ function currentDevice(): string | undefined {
685
+ if (!isBrowser()) return undefined;
686
+ const uaData = (navigator as Navigator & { userAgentData?: { mobile?: boolean } }).userAgentData;
687
+ if (typeof uaData?.mobile === 'boolean') return uaData.mobile ? 'mobile' : 'desktop';
688
+ const width = window.innerWidth;
689
+ if (width < 768) return 'mobile';
690
+ if (width < 1180) return 'tablet';
691
+ return 'desktop';
692
+ }
693
+
694
+ function currentViewport(): string | undefined {
695
+ if (!isBrowser()) return undefined;
696
+ if (!Number.isFinite(window.innerWidth) || !Number.isFinite(window.innerHeight)) {
697
+ return undefined;
698
+ }
699
+ return `${window.innerWidth}x${window.innerHeight}`;
700
+ }
701
+
702
+ function currentConnection(): string | undefined {
703
+ if (!isBrowser()) return undefined;
704
+ const connection = (
705
+ navigator as Navigator & {
706
+ connection?: { effectiveType?: string; saveData?: boolean };
707
+ }
708
+ ).connection;
709
+ if (!connection?.effectiveType) return undefined;
710
+ return connection.saveData ? `${connection.effectiveType}:save-data` : connection.effectiveType;
711
+ }
712
+
713
+ function pickPerformanceTarget(
714
+ entry: (PerformanceEntry & Record<string, unknown>) | undefined
715
+ ): string | undefined {
716
+ if (typeof Element === 'undefined') return undefined;
717
+ const target = entry?.target;
718
+ if (!(target instanceof Element)) return undefined;
719
+ return toElementSelector(target);
720
+ }
721
+
722
+ function toElementSelector(element: Element): string {
723
+ const tag = element.tagName.toLowerCase();
724
+ const id = element.id ? `#${cssEscape(element.id)}` : '';
725
+ const testId = element.getAttribute('data-testid');
726
+ if (testId) return `${tag}[data-testid="${cssEscape(testId)}"]`;
727
+ const className =
728
+ typeof element.className === 'string'
729
+ ? element.className
730
+ .split(/\s+/)
731
+ .filter(Boolean)
732
+ .slice(0, 2)
733
+ .map(item => `.${cssEscape(item)}`)
734
+ .join('')
735
+ : '';
736
+ return `${tag}${id}${className}` || tag;
737
+ }
738
+
739
+ function cssEscape(value: string): string {
740
+ if (typeof CSS !== 'undefined' && typeof CSS.escape === 'function') {
741
+ return CSS.escape(value);
742
+ }
743
+ return value.replace(/["\\]/g, '\\$&');
744
+ }
745
+
746
+ function sanitizeUrl(url: string | undefined, includeQueryString?: boolean): string | undefined {
747
+ if (!url) return undefined;
748
+ if (includeQueryString) return url;
749
+ try {
750
+ const parsed = new URL(url, isBrowser() ? window.location.origin : 'http://localhost');
751
+ return parsed.origin === 'http://localhost' && !/^https?:\/\//i.test(url)
752
+ ? parsed.pathname
753
+ : `${parsed.origin}${parsed.pathname}`;
754
+ } catch {
755
+ return url.split('?')[0]?.split('#')[0];
756
+ }
757
+ }
758
+
759
+ function isBrowser(): boolean {
760
+ return typeof window !== 'undefined' && typeof document !== 'undefined';
761
+ }
762
+
763
+ function createId(prefix: string): string {
764
+ return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
765
+ }
766
+
767
+ function readOrCreateBrowserId(key: string): string {
768
+ if (!isBrowser()) return createId('runtime');
769
+ try {
770
+ const existing = window.localStorage.getItem(key);
771
+ if (existing) return existing;
772
+ const next = createId('runtime');
773
+ window.localStorage.setItem(key, next);
774
+ return next;
775
+ } catch {
776
+ return createId('runtime');
777
+ }
778
+ }
779
+
780
+ /** 解析 ignoreSourcePatterns 选项 —— false 关闭过滤;数组与默认合并;缺省走默认。 */
781
+ export function resolveIgnorePatterns(custom: RegExp[] | false | undefined): RegExp[] {
782
+ if (custom === false) return [];
783
+ if (Array.isArray(custom)) return [...DEFAULT_IGNORE_SOURCE_PATTERNS, ...custom];
784
+ return DEFAULT_IGNORE_SOURCE_PATTERNS;
785
+ }
786
+
787
+ /** 判断错误是否来自 dev-runtime 等噪声源。
788
+ * 命中 ignorePatterns 任一 → 丢弃。检查 source URL + error.stack 两条。 */
789
+ export function shouldIgnore(
790
+ ignorePatterns: RegExp[],
791
+ source: string | undefined,
792
+ reason: unknown
793
+ ): boolean {
794
+ if (ignorePatterns.length === 0) return false;
795
+ if (typeof source === 'string') {
796
+ for (const re of ignorePatterns) if (re.test(source)) return true;
797
+ }
798
+ // reason 通常是 Error 实例;其 stack 是字符串。也可能是字符串本身。
799
+ if (reason && typeof reason === 'object' && 'stack' in reason) {
800
+ const stack = (reason as { stack?: unknown }).stack;
801
+ if (typeof stack === 'string') {
802
+ for (const re of ignorePatterns) if (re.test(stack)) return true;
803
+ }
804
+ }
805
+ if (typeof reason === 'string') {
806
+ for (const re of ignorePatterns) if (re.test(reason)) return true;
807
+ }
808
+ return false;
809
+ }
810
+
811
+ function normalizeError(error: unknown): { message: string; name?: string; stack?: string } {
812
+ if (error instanceof Error) {
813
+ return { message: error.message, name: error.name, stack: error.stack };
814
+ }
815
+ if (typeof error === 'string') return { message: error };
816
+ try {
817
+ return { message: JSON.stringify(error) };
818
+ } catch {
819
+ return { message: String(error) };
820
+ }
821
+ }
822
+
823
+ function isRecord(value: unknown): value is Record<string, unknown> {
824
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
825
+ }
826
+
827
+ function normalizeTags(
828
+ tags: TelemetryEventOptions['tags'] | undefined
829
+ ): Record<string, string> | undefined {
830
+ if (!tags) return undefined;
831
+ const normalized: Record<string, string> = {};
832
+ for (const [key, value] of Object.entries(tags)) {
833
+ if (value === undefined || value === null) continue;
834
+ normalized[key] = String(value);
835
+ }
836
+ return Object.keys(normalized).length > 0 ? normalized : undefined;
837
+ }