@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.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 (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,16 +1,21 @@
1
1
  import { keys } from "../translations/keys.js";
2
- import { computeDelta } from "./comparison.js";
2
+ import { computeDelta } from "../timeframe/comparison.js";
3
+ import { numberFormat } from "../translations/intl.js";
4
+ import "../ui/analytics.css";
3
5
  import { jsx, jsxs } from "react/jsx-runtime";
6
+ import { Pill } from "@payloadcms/ui";
4
7
  //#region src/widgets/ComparisonDelta.tsx
5
- const SUCCESS = "var(--theme-success-500, rgb(21, 135, 186))";
6
- const ERROR = "var(--theme-error-500, rgb(218, 75, 72))";
7
- const NEUTRAL = "var(--theme-elevation-400)";
8
8
  /** Metrics where a decrease is the good outcome, inverting the delta colors. */
9
9
  const LOWER_IS_BETTER = new Set(["bounceRate"]);
10
- const colorFor = (direction, metric) => {
11
- if (direction === "none") return NEUTRAL;
10
+ const toneFor = (direction, metric) => {
11
+ if (direction === "none") return "none";
12
12
  const goodWhenDown = metric !== void 0 && LOWER_IS_BETTER.has(metric);
13
- return direction === "up" !== goodWhenDown ? SUCCESS : ERROR;
13
+ return direction === "up" !== goodWhenDown ? "up" : "down";
14
+ };
15
+ const PILL_STYLE = {
16
+ up: "success",
17
+ down: "error",
18
+ none: "light-gray"
14
19
  };
15
20
  const DIRECTION_LABEL = {
16
21
  up: keys.comparisonIncrease,
@@ -19,62 +24,48 @@ const DIRECTION_LABEL = {
19
24
  };
20
25
  const DeltaArrow = ({ direction }) => /* @__PURE__ */ jsx("svg", {
21
26
  "aria-hidden": "true",
27
+ className: direction === "down" ? "analytics-delta__arrow analytics-delta__arrow--down" : "analytics-delta__arrow",
22
28
  focusable: "false",
23
29
  width: "8",
24
30
  height: "8",
25
31
  viewBox: "0 0 8 8",
26
- style: {
27
- flexShrink: 0,
28
- transform: direction === "down" ? "rotate(180deg)" : void 0
29
- },
30
32
  children: /* @__PURE__ */ jsx("path", {
31
33
  d: "M4 1.2 7.3 6.8H0.7Z",
32
34
  fill: "currentColor"
33
35
  })
34
36
  });
35
37
  /**
36
- * Period-over-period delta chip: a colored arrow, the percentage change, and a localized
37
- * "vs. previous period" caption. Renders nothing when there is no comparable previous
38
- * value; when the previous value is 0 (no percentage baseline) the localized direction
39
- * word stands in for the number. All text routes through typed translation keys; the
40
- * arrow is decorative and carried by an aria-label with the localized direction word.
38
+ * Period-over-period delta pill, tinted by whether the change is for the better. Renders
39
+ * nothing without a comparable previous value; a zero previous value shows the direction word.
41
40
  */
42
- function ComparisonDelta({ current, previous, metric, locale, t }) {
41
+ function ComparisonDelta({ current, previous, metric, locale, t, caption = true }) {
43
42
  const delta = computeDelta(current, previous);
44
43
  if (!delta) return null;
45
- const percentText = delta.percent === null ? null : new Intl.NumberFormat(locale, {
44
+ const percentText = delta.percent === null ? null : numberFormat(locale, {
46
45
  style: "percent",
47
46
  maximumFractionDigits: 1,
48
47
  signDisplay: "never"
49
48
  }).format(Math.abs(delta.percent) / 100);
50
- const visible = percentText ?? t(DIRECTION_LABEL[delta.direction]);
49
+ const direction = t(DIRECTION_LABEL[delta.direction]);
50
+ const visible = percentText ?? direction;
51
+ const ariaLabel = percentText === null || delta.direction === "none" ? t(keys.comparisonDirectionLabel, { direction }) : t(keys.comparisonChangeLabel, {
52
+ direction,
53
+ change: percentText
54
+ });
55
+ const tone = toneFor(delta.direction, metric);
51
56
  return /* @__PURE__ */ jsxs("span", {
57
+ "aria-label": ariaLabel,
58
+ className: "analytics-delta",
52
59
  role: "img",
53
- "aria-label": `${t(DIRECTION_LABEL[delta.direction])} ${percentText ?? ""} ${t(keys.comparisonVsPrevious)}`.replace(/\s+/g, " ").trim(),
54
- style: {
55
- display: "inline-flex",
56
- gap: "0.375rem",
57
- alignItems: "center",
58
- fontSize: "0.75rem",
59
- lineHeight: 1.25
60
- },
61
- children: [/* @__PURE__ */ jsxs("span", {
62
- style: {
63
- display: "inline-flex",
64
- alignItems: "center",
65
- gap: "0.25rem",
66
- color: colorFor(delta.direction, metric),
67
- fontWeight: 600,
68
- lineHeight: "inherit"
69
- },
60
+ children: [/* @__PURE__ */ jsxs(Pill, {
61
+ className: `analytics-delta__change analytics-delta__change--${tone}`,
62
+ pillStyle: PILL_STYLE[tone],
63
+ size: "medium",
70
64
  children: [delta.direction !== "none" ? /* @__PURE__ */ jsx(DeltaArrow, { direction: delta.direction }) : null, visible]
71
- }), /* @__PURE__ */ jsx("span", {
72
- style: {
73
- color: "var(--theme-elevation-400)",
74
- lineHeight: "inherit"
75
- },
65
+ }), caption ? /* @__PURE__ */ jsx("span", {
66
+ className: "analytics-delta__caption",
76
67
  children: t(keys.comparisonVsPrevious)
77
- })]
68
+ }) : null]
78
69
  });
79
70
  }
80
71
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"ComparisonDelta.js","names":[],"sources":["../../src/widgets/ComparisonDelta.tsx"],"sourcesContent":["import type { MetricKey } from '../core/contract'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { computeDelta, type DeltaDirection } from './comparison'\n\n// Payload's admin palette maps success to its blue ramp and error to its red ramp; the\n// fallbacks mirror @payloadcms/ui colors.scss so the chip renders identically outside\n// a themed admin shell.\nconst SUCCESS = 'var(--theme-success-500, rgb(21, 135, 186))'\nconst ERROR = 'var(--theme-error-500, rgb(218, 75, 72))'\nconst NEUTRAL = 'var(--theme-elevation-400)'\n\n/** Metrics where a decrease is the good outcome, inverting the delta colors. */\nconst LOWER_IS_BETTER: ReadonlySet<MetricKey> = new Set<MetricKey>(['bounceRate'])\n\nconst colorFor = (direction: DeltaDirection, metric?: MetricKey): string => {\n\tif (direction === 'none') {\n\t\treturn NEUTRAL\n\t}\n\tconst goodWhenDown = metric !== undefined && LOWER_IS_BETTER.has(metric)\n\tconst improved = (direction === 'up') !== goodWhenDown\n\treturn improved ? SUCCESS : ERROR\n}\n\nconst DIRECTION_LABEL: Record<DeltaDirection, TranslationKey> = {\n\tup: keys.comparisonIncrease,\n\tdown: keys.comparisonDecrease,\n\tnone: keys.comparisonNoChange,\n}\n\nconst DeltaArrow = ({ direction }: { direction: 'up' | 'down' }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tfocusable=\"false\"\n\t\twidth=\"8\"\n\t\theight=\"8\"\n\t\tviewBox=\"0 0 8 8\"\n\t\tstyle={{\n\t\t\tflexShrink: 0,\n\t\t\ttransform: direction === 'down' ? 'rotate(180deg)' : undefined,\n\t\t}}\n\t>\n\t\t<path d=\"M4 1.2 7.3 6.8H0.7Z\" fill=\"currentColor\" />\n\t</svg>\n)\n\nexport interface ComparisonDeltaProps {\n\tcurrent?: number\n\tprevious?: number\n\t/** Inverts good/bad coloring for metrics in {@link LOWER_IS_BETTER}. */\n\tmetric?: MetricKey\n\tlocale: string\n\tt: (key: TranslationKey) => string\n}\n\n/**\n * Period-over-period delta chip: a colored arrow, the percentage change, and a localized\n * \"vs. previous period\" caption. Renders nothing when there is no comparable previous\n * value; when the previous value is 0 (no percentage baseline) the localized direction\n * word stands in for the number. All text routes through typed translation keys; the\n * arrow is decorative and carried by an aria-label with the localized direction word.\n */\nexport function ComparisonDelta({ current, previous, metric, locale, t }: ComparisonDeltaProps) {\n\tconst delta = computeDelta(current, previous)\n\tif (!delta) {\n\t\treturn null\n\t}\n\tconst percentText =\n\t\tdelta.percent === null\n\t\t\t? null\n\t\t\t: new Intl.NumberFormat(locale, {\n\t\t\t\t\tstyle: 'percent',\n\t\t\t\t\tmaximumFractionDigits: 1,\n\t\t\t\t\tsignDisplay: 'never',\n\t\t\t\t}).format(Math.abs(delta.percent) / 100)\n\t// An unchanged value is a real 0%, so it reads as one; only a zero previous value\n\t// (no percentage exists to report) falls back to the direction word.\n\tconst visible = percentText ?? t(DIRECTION_LABEL[delta.direction])\n\tconst ariaLabel = `${t(DIRECTION_LABEL[delta.direction])} ${percentText ?? ''} ${t(\n\t\tkeys.comparisonVsPrevious\n\t)}`\n\t\t.replace(/\\s+/g, ' ')\n\t\t.trim()\n\treturn (\n\t\t<span\n\t\t\trole=\"img\"\n\t\t\taria-label={ariaLabel}\n\t\t\tstyle={{\n\t\t\t\tdisplay: 'inline-flex',\n\t\t\t\tgap: '0.375rem',\n\t\t\t\t// Not `baseline`: the value's own flex box takes its baseline from the arrow\n\t\t\t\t// glyph rather than its text, which lifts the value off the caption's line.\n\t\t\t\talignItems: 'center',\n\t\t\t\tfontSize: '0.75rem',\n\t\t\t\tlineHeight: 1.25,\n\t\t\t}}\n\t\t>\n\t\t\t<span\n\t\t\t\tstyle={{\n\t\t\t\t\tdisplay: 'inline-flex',\n\t\t\t\t\talignItems: 'center',\n\t\t\t\t\tgap: '0.25rem',\n\t\t\t\t\tcolor: colorFor(delta.direction, metric),\n\t\t\t\t\tfontWeight: 600,\n\t\t\t\t\tlineHeight: 'inherit',\n\t\t\t\t}}\n\t\t\t>\n\t\t\t\t{delta.direction !== 'none' ? <DeltaArrow direction={delta.direction} /> : null}\n\t\t\t\t{visible}\n\t\t\t</span>\n\t\t\t<span style={{ color: 'var(--theme-elevation-400)', lineHeight: 'inherit' }}>\n\t\t\t\t{t(keys.comparisonVsPrevious)}\n\t\t\t</span>\n\t\t</span>\n\t)\n}\n"],"mappings":";;;;AAOA,MAAM,UAAU;AAChB,MAAM,QAAQ;AACd,MAAM,UAAU;;AAGhB,MAAM,kBAA0C,IAAI,IAAe,CAAC,YAAY,CAAC;AAEjF,MAAM,YAAY,WAA2B,WAA+B;CAC3E,IAAI,cAAc,QACjB,OAAO;CAER,MAAM,eAAe,WAAW,KAAA,KAAa,gBAAgB,IAAI,MAAM;CAEvE,OADkB,cAAc,SAAU,eACxB,UAAU;AAC7B;AAEA,MAAM,kBAA0D;CAC/D,IAAI,KAAK;CACT,MAAM,KAAK;CACX,MAAM,KAAK;AACZ;AAEA,MAAM,cAAc,EAAE,gBACrB,oBAAC,OAAD;CACC,eAAY;CACZ,WAAU;CACV,OAAM;CACN,QAAO;CACP,SAAQ;CACR,OAAO;EACN,YAAY;EACZ,WAAW,cAAc,SAAS,mBAAmB,KAAA;CACtD;WAEA,oBAAC,QAAD;EAAM,GAAE;EAAsB,MAAK;CAAgB,CAAA;AAC/C,CAAA;;;;;;;;AAmBN,SAAgB,gBAAgB,EAAE,SAAS,UAAU,QAAQ,QAAQ,KAA2B;CAC/F,MAAM,QAAQ,aAAa,SAAS,QAAQ;CAC5C,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,cACL,MAAM,YAAY,OACf,OACA,IAAI,KAAK,aAAa,QAAQ;EAC9B,OAAO;EACP,uBAAuB;EACvB,aAAa;CACd,CAAC,EAAE,OAAO,KAAK,IAAI,MAAM,OAAO,IAAI,GAAG;CAG1C,MAAM,UAAU,eAAe,EAAE,gBAAgB,MAAM,UAAU;CAMjE,OACC,qBAAC,QAAD;EACC,MAAK;EACL,cARgB,GAAG,EAAE,gBAAgB,MAAM,UAAU,EAAE,GAAG,eAAe,GAAG,GAAG,EAChF,KAAK,oBACN,IACE,QAAQ,QAAQ,GAAG,EACnB,KAIoB;EACpB,OAAO;GACN,SAAS;GACT,KAAK;GAGL,YAAY;GACZ,UAAU;GACV,YAAY;EACb;YAXD,CAaC,qBAAC,QAAD;GACC,OAAO;IACN,SAAS;IACT,YAAY;IACZ,KAAK;IACL,OAAO,SAAS,MAAM,WAAW,MAAM;IACvC,YAAY;IACZ,YAAY;GACb;aARD,CAUE,MAAM,cAAc,SAAS,oBAAC,YAAD,EAAY,WAAW,MAAM,UAAY,CAAA,IAAI,MAC1E,OACI;MACN,oBAAC,QAAD;GAAM,OAAO;IAAE,OAAO;IAA8B,YAAY;GAAU;aACxE,EAAE,KAAK,oBAAoB;EACvB,CAAA,CACD;;AAER"}
1
+ {"version":3,"file":"ComparisonDelta.js","names":[],"sources":["../../src/widgets/ComparisonDelta.tsx"],"sourcesContent":["import { Pill } from '@payloadcms/ui'\nimport type { MetricKey, MetricValue } from '../core/contract'\nimport { computeDelta, type DeltaDirection } from '../timeframe/comparison'\nimport { numberFormat } from '../translations/intl'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport '../ui/analytics.css'\n\n/** Metrics where a decrease is the good outcome, inverting the delta colors. */\nconst LOWER_IS_BETTER: ReadonlySet<MetricKey> = new Set<MetricKey>(['bounceRate'])\n\n/** `up` is a change for the better whichever way the number moved, `down` one for the worse. */\ntype DeltaTone = 'up' | 'down' | 'none'\n\nconst toneFor = (direction: DeltaDirection, metric?: MetricKey): DeltaTone => {\n\tif (direction === 'none') {\n\t\treturn 'none'\n\t}\n\tconst goodWhenDown = metric !== undefined && LOWER_IS_BETTER.has(metric)\n\treturn (direction === 'up') !== goodWhenDown ? 'up' : 'down'\n}\n\nconst PILL_STYLE = { up: 'success', down: 'error', none: 'light-gray' } as const satisfies Record<\n\tDeltaTone,\n\tstring\n>\n\nconst DIRECTION_LABEL: Record<DeltaDirection, TranslationKey> = {\n\tup: keys.comparisonIncrease,\n\tdown: keys.comparisonDecrease,\n\tnone: keys.comparisonNoChange,\n}\n\nconst DeltaArrow = ({ direction }: { direction: 'up' | 'down' }) => (\n\t<svg\n\t\taria-hidden=\"true\"\n\t\tclassName={\n\t\t\tdirection === 'down'\n\t\t\t\t? 'analytics-delta__arrow analytics-delta__arrow--down'\n\t\t\t\t: 'analytics-delta__arrow'\n\t\t}\n\t\tfocusable=\"false\"\n\t\twidth=\"8\"\n\t\theight=\"8\"\n\t\tviewBox=\"0 0 8 8\"\n\t>\n\t\t<path d=\"M4 1.2 7.3 6.8H0.7Z\" fill=\"currentColor\" />\n\t</svg>\n)\n\nexport interface ComparisonDeltaProps {\n\t/** `null` on either side is no data, and draws no delta at all. */\n\tcurrent?: MetricValue\n\tprevious?: MetricValue\n\t/** Inverts good/bad coloring for metrics in {@link LOWER_IS_BETTER}. */\n\tmetric?: MetricKey\n\tlocale: string\n\tt: (key: TranslationKey, vars?: Record<string, string>) => string\n\t/**\n\t * Shows \"vs. previous period\" beside the pill. A list of deltas leaves it out on each row and\n\t * says it once; the pill's own name always carries it.\n\t */\n\tcaption?: boolean\n}\n\n/**\n * Period-over-period delta pill, tinted by whether the change is for the better. Renders\n * nothing without a comparable previous value; a zero previous value shows the direction word.\n */\nexport function ComparisonDelta({\n\tcurrent,\n\tprevious,\n\tmetric,\n\tlocale,\n\tt,\n\tcaption = true,\n}: ComparisonDeltaProps) {\n\tconst delta = computeDelta(current, previous)\n\tif (!delta) {\n\t\treturn null\n\t}\n\tconst percentText =\n\t\tdelta.percent === null\n\t\t\t? null\n\t\t\t: numberFormat(locale, {\n\t\t\t\t\tstyle: 'percent',\n\t\t\t\t\tmaximumFractionDigits: 1,\n\t\t\t\t\tsignDisplay: 'never',\n\t\t\t\t}).format(Math.abs(delta.percent) / 100)\n\t// An unchanged value is a real 0%, so it reads as one; only a zero previous value\n\t// (no percentage exists to report) falls back to the direction word.\n\tconst direction = t(DIRECTION_LABEL[delta.direction])\n\tconst visible = percentText ?? direction\n\t// An unchanged value says so in words; its 0% would only repeat them.\n\tconst ariaLabel =\n\t\tpercentText === null || delta.direction === 'none'\n\t\t\t? t(keys.comparisonDirectionLabel, { direction })\n\t\t\t: t(keys.comparisonChangeLabel, { direction, change: percentText })\n\tconst tone = toneFor(delta.direction, metric)\n\treturn (\n\t\t<span aria-label={ariaLabel} className=\"analytics-delta\" role=\"img\">\n\t\t\t<Pill\n\t\t\t\tclassName={`analytics-delta__change analytics-delta__change--${tone}`}\n\t\t\t\tpillStyle={PILL_STYLE[tone]}\n\t\t\t\tsize=\"medium\"\n\t\t\t>\n\t\t\t\t{delta.direction !== 'none' ? <DeltaArrow direction={delta.direction} /> : null}\n\t\t\t\t{visible}\n\t\t\t</Pill>\n\t\t\t{caption ? (\n\t\t\t\t<span className=\"analytics-delta__caption\">{t(keys.comparisonVsPrevious)}</span>\n\t\t\t) : null}\n\t\t</span>\n\t)\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,kBAA0C,IAAI,IAAe,CAAC,YAAY,CAAC;AAKjF,MAAM,WAAW,WAA2B,WAAkC;CAC7E,IAAI,cAAc,QACjB,OAAO;CAER,MAAM,eAAe,WAAW,KAAA,KAAa,gBAAgB,IAAI,MAAM;CACvE,OAAQ,cAAc,SAAU,eAAe,OAAO;AACvD;AAEA,MAAM,aAAa;CAAE,IAAI;CAAW,MAAM;CAAS,MAAM;AAAa;AAKtE,MAAM,kBAA0D;CAC/D,IAAI,KAAK;CACT,MAAM,KAAK;CACX,MAAM,KAAK;AACZ;AAEA,MAAM,cAAc,EAAE,gBACrB,oBAAC,OAAD;CACC,eAAY;CACZ,WACC,cAAc,SACX,wDACA;CAEJ,WAAU;CACV,OAAM;CACN,QAAO;CACP,SAAQ;WAER,oBAAC,QAAD;EAAM,GAAE;EAAsB,MAAK;CAAgB,CAAA;AAC/C,CAAA;;;;;AAsBN,SAAgB,gBAAgB,EAC/B,SACA,UACA,QACA,QACA,GACA,UAAU,QACc;CACxB,MAAM,QAAQ,aAAa,SAAS,QAAQ;CAC5C,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,cACL,MAAM,YAAY,OACf,OACA,aAAa,QAAQ;EACrB,OAAO;EACP,uBAAuB;EACvB,aAAa;CACd,CAAC,EAAE,OAAO,KAAK,IAAI,MAAM,OAAO,IAAI,GAAG;CAG1C,MAAM,YAAY,EAAE,gBAAgB,MAAM,UAAU;CACpD,MAAM,UAAU,eAAe;CAE/B,MAAM,YACL,gBAAgB,QAAQ,MAAM,cAAc,SACzC,EAAE,KAAK,0BAA0B,EAAE,UAAU,CAAC,IAC9C,EAAE,KAAK,uBAAuB;EAAE;EAAW,QAAQ;CAAY,CAAC;CACpE,MAAM,OAAO,QAAQ,MAAM,WAAW,MAAM;CAC5C,OACC,qBAAC,QAAD;EAAM,cAAY;EAAW,WAAU;EAAkB,MAAK;YAA9D,CACC,qBAAC,MAAD;GACC,WAAW,oDAAoD;GAC/D,WAAW,WAAW;GACtB,MAAK;aAHN,CAKE,MAAM,cAAc,SAAS,oBAAC,YAAD,EAAY,WAAW,MAAM,UAAY,CAAA,IAAI,MAC1E,OACI;MACL,UACA,oBAAC,QAAD;GAAM,WAAU;aAA4B,EAAE,KAAK,oBAAoB;EAAQ,CAAA,IAC5E,IACC;;AAER"}
@@ -1,19 +1,43 @@
1
1
  import { RealtimePoint } from "./readForWidgetRealtime.js";
2
-
3
2
  //#region src/widgets/RealtimeCounter.d.ts
3
+ /** @beta */
4
4
  interface RealtimeCounterProps {
5
5
  endpoint: string;
6
6
  intervalMs: number;
7
7
  metric: string;
8
8
  windowMinutes: number;
9
9
  dataSource?: string;
10
+ /** Read another scope; the endpoint refuses any caller that may not. */
11
+ scope?: string;
10
12
  initialActiveNow: number;
11
13
  initialSeries: RealtimePoint[];
14
+ /** Whether the reading it mounts with was counted from a sample. */
15
+ initialSampled?: boolean;
12
16
  locale: string;
13
- caption: string;
17
+ /** Reporting timezone the minute labels read in, so server and browser agree. */
18
+ timezone: string;
19
+ /** Names the sparkline for assistive tech, as the metric's own name does. */
20
+ label: string;
21
+ /**
22
+ * Words beside the number, the same for every count. Left out, the plugin's own phrase for
23
+ * `metric`, worded for the count in the admin's language.
24
+ */
25
+ caption?: string;
14
26
  pausedLabel: string;
27
+ /** Notice for a sampled reading; without it the counter renders none. */
28
+ sampledLabel?: string;
29
+ /** Heads the minutes column of the sparkline's data table, which only assistive tech sees. */
30
+ periodLabel?: string;
31
+ /** Let the sparkline take the height its card has to spare, as a dashboard widget's does. */
32
+ fill?: boolean;
15
33
  }
34
+ /**
35
+ * A live count that mounts with a server-rendered reading and polls it fresh. A new server
36
+ * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.
37
+ *
38
+ * @beta
39
+ */
16
40
  declare function RealtimeCounter(props: RealtimeCounterProps): import("react/jsx-runtime").JSX.Element;
17
41
  //#endregion
18
- export { RealtimeCounter };
42
+ export { RealtimeCounter, RealtimeCounterProps };
19
43
  //# sourceMappingURL=RealtimeCounter.d.ts.map
@@ -1,76 +1,104 @@
1
1
  "use client";
2
+ import { numberFormat } from "../translations/intl.js";
2
3
  import { TrendChart } from "../charts/TrendChart.js";
4
+ import { useTranslation } from "../translations/useTranslation.js";
5
+ import { formatMinutes } from "../fields/format.js";
3
6
  import { buildPollPath, toRealtimePoints } from "./realtimePoll.js";
4
- import { useEffect, useState } from "react";
7
+ import { useRealtimePoll } from "../ui/hooks/useRealtimePoll.js";
8
+ import { plural, pluralParts } from "../translations/plural.js";
9
+ import { LiveAnnouncement } from "../ui/components/LiveAnnouncement.js";
10
+ import { WidgetBody, WidgetNote, WidgetValue } from "./WidgetCard.js";
11
+ import { useMemo } from "react";
5
12
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
13
  //#region src/widgets/RealtimeCounter.tsx
14
+ /**
15
+ * Three minutes on the axis, the window's first, middle and last: a counter sits in a narrow card,
16
+ * and a 12-hour clock's labels with the zone beside the last are wide.
17
+ */
18
+ const REALTIME_TICKS = 3;
19
+ const captionSpan = (text) => text === "" ? null : /* @__PURE__ */ jsx("span", {
20
+ className: "analytics-widget__value-caption",
21
+ children: text
22
+ });
23
+ /**
24
+ * A live reading: the number, large inside its phrase wherever the language places it, then a
25
+ * sparkline of its last minutes.
26
+ */
27
+ function RealtimeReadout({ reading, paused, locale, timezone, phrase, windowMinutes, label, caption, pausedLabel, sampledLabel, periodLabel, fill = false }) {
28
+ const translation = useTranslation();
29
+ const points = toRealtimePoints(reading.series, locale, timezone);
30
+ const counted = windowMinutes === void 0 ? phrase : {
31
+ name: phrase,
32
+ vars: { duration: formatMinutes(windowMinutes, locale) }
33
+ };
34
+ const parts = caption === void 0 ? pluralParts(translation, counted, reading.activeNow) : {
35
+ before: "",
36
+ count: numberFormat(locale).format(reading.activeNow),
37
+ after: caption
38
+ };
39
+ const spoken = caption === void 0 ? plural(translation, counted, reading.activeNow) : `${parts.count} ${caption}`;
40
+ return /* @__PURE__ */ jsxs(Fragment, { children: [
41
+ /* @__PURE__ */ jsx(WidgetValue, {
42
+ before: paused ? null : captionSpan(parts.before.trim()),
43
+ value: parts.count,
44
+ children: captionSpan(paused ? pausedLabel : parts.after.trim())
45
+ }),
46
+ /* @__PURE__ */ jsx(WidgetBody, { children: /* @__PURE__ */ jsx(TrendChart, {
47
+ ariaLabel: label,
48
+ buckets: points,
49
+ fill,
50
+ maxTicks: REALTIME_TICKS,
51
+ minHeight: fill ? 100 : 120,
52
+ ...periodLabel === void 0 ? {} : { periodLabel }
53
+ }) }),
54
+ reading.sampled && sampledLabel ? /* @__PURE__ */ jsx(WidgetNote, { children: sampledLabel }) : null,
55
+ /* @__PURE__ */ jsx(LiveAnnouncement, { message: paused ? pausedLabel : spoken })
56
+ ] });
57
+ }
58
+ /**
59
+ * A live count that mounts with a server-rendered reading and polls it fresh. A new server
60
+ * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.
61
+ *
62
+ * @beta
63
+ */
7
64
  function RealtimeCounter(props) {
8
- const { endpoint, intervalMs, metric, windowMinutes, dataSource, locale, caption, pausedLabel } = props;
9
- const [activeNow, setActiveNow] = useState(props.initialActiveNow);
10
- const [series, setSeries] = useState(props.initialSeries);
11
- const [paused, setPaused] = useState(false);
12
- useEffect(() => {
13
- let cancelled = false;
14
- const path = buildPollPath(endpoint, {
65
+ const { endpoint, intervalMs, metric, windowMinutes, dataSource, scope } = props;
66
+ const { initialActiveNow, initialSeries, initialSampled } = props;
67
+ const initial = useMemo(() => ({
68
+ activeNow: initialActiveNow,
69
+ series: initialSeries,
70
+ sampled: initialSampled === true
71
+ }), [
72
+ initialActiveNow,
73
+ initialSeries,
74
+ initialSampled
75
+ ]);
76
+ const poll = useRealtimePoll({
77
+ url: buildPollPath(endpoint, {
15
78
  metric,
16
79
  windowMinutes,
17
- dataSource
18
- });
19
- const tick = async () => {
20
- try {
21
- const res = await fetch(path, { credentials: "same-origin" });
22
- if (!res.ok) {
23
- if (!cancelled) setPaused(true);
24
- return;
25
- }
26
- const data = await res.json();
27
- if (cancelled || data.status !== "ok") return;
28
- setActiveNow(data.activeNow);
29
- setSeries(data.series);
30
- setPaused(false);
31
- } catch {
32
- if (!cancelled) setPaused(true);
33
- }
34
- };
35
- const id = setInterval(tick, intervalMs);
36
- return () => {
37
- cancelled = true;
38
- clearInterval(id);
39
- };
40
- }, [
41
- endpoint,
80
+ ...dataSource === void 0 ? {} : { dataSource },
81
+ ...scope === void 0 ? {} : { scope }
82
+ }),
42
83
  intervalMs,
43
- metric,
84
+ initial
85
+ });
86
+ return /* @__PURE__ */ jsx(RealtimeReadout, {
87
+ ...props.caption === void 0 ? {} : { caption: props.caption },
88
+ ...props.fill === void 0 ? {} : { fill: props.fill },
89
+ label: props.label,
90
+ locale: props.locale,
91
+ phrase: metric === "pageviews" ? "livePageviews" : "liveVisitors",
44
92
  windowMinutes,
45
- dataSource
46
- ]);
47
- const nf = new Intl.NumberFormat(locale);
48
- const points = toRealtimePoints(series, locale);
49
- return /* @__PURE__ */ jsxs(Fragment, { children: [
50
- /* @__PURE__ */ jsx("span", {
51
- style: {
52
- fontSize: "2rem",
53
- fontWeight: 700,
54
- lineHeight: 1.1,
55
- color: "var(--theme-elevation-800)"
56
- },
57
- children: nf.format(activeNow)
58
- }),
59
- /* @__PURE__ */ jsx("span", {
60
- style: {
61
- fontSize: "0.75rem",
62
- color: "var(--theme-elevation-400)"
63
- },
64
- children: paused ? pausedLabel : caption
65
- }),
66
- /* @__PURE__ */ jsx(TrendChart, {
67
- buckets: points,
68
- ariaLabel: caption,
69
- minHeight: 120
70
- })
71
- ] });
93
+ paused: poll.paused,
94
+ pausedLabel: props.pausedLabel,
95
+ reading: poll.reading ?? initial,
96
+ ...props.sampledLabel === void 0 ? {} : { sampledLabel: props.sampledLabel },
97
+ ...props.periodLabel === void 0 ? {} : { periodLabel: props.periodLabel },
98
+ timezone: props.timezone
99
+ });
72
100
  }
73
101
  //#endregion
74
- export { RealtimeCounter };
102
+ export { RealtimeCounter, RealtimeReadout };
75
103
 
76
104
  //# sourceMappingURL=RealtimeCounter.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"RealtimeCounter.js","names":[],"sources":["../../src/widgets/RealtimeCounter.tsx"],"sourcesContent":["'use client'\n\nimport { useEffect, useState } from 'react'\nimport { TrendChart } from '../charts/TrendChart'\nimport type { RealtimePoint } from './readForWidgetRealtime'\nimport { buildPollPath, toRealtimePoints } from './realtimePoll'\n\nexport interface RealtimeCounterProps {\n\tendpoint: string\n\tintervalMs: number\n\tmetric: string\n\twindowMinutes: number\n\tdataSource?: string\n\tinitialActiveNow: number\n\tinitialSeries: RealtimePoint[]\n\tlocale: string\n\tcaption: string\n\tpausedLabel: string\n}\n\nexport function RealtimeCounter(props: RealtimeCounterProps) {\n\tconst { endpoint, intervalMs, metric, windowMinutes, dataSource, locale, caption, pausedLabel } =\n\t\tprops\n\tconst [activeNow, setActiveNow] = useState(props.initialActiveNow)\n\tconst [series, setSeries] = useState(props.initialSeries)\n\tconst [paused, setPaused] = useState(false)\n\n\tuseEffect(() => {\n\t\tlet cancelled = false\n\t\tconst path = buildPollPath(endpoint, { metric, windowMinutes, dataSource })\n\t\tconst tick = async () => {\n\t\t\ttry {\n\t\t\t\tconst res = await fetch(path, { credentials: 'same-origin' })\n\t\t\t\tif (!res.ok) {\n\t\t\t\t\tif (!cancelled) setPaused(true)\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t\tconst data = (await res.json()) as {\n\t\t\t\t\tstatus: string\n\t\t\t\t\tactiveNow: number\n\t\t\t\t\tseries: RealtimePoint[]\n\t\t\t\t}\n\t\t\t\tif (cancelled || data.status !== 'ok') return\n\t\t\t\tsetActiveNow(data.activeNow)\n\t\t\t\tsetSeries(data.series)\n\t\t\t\tsetPaused(false)\n\t\t\t} catch {\n\t\t\t\tif (!cancelled) setPaused(true)\n\t\t\t}\n\t\t}\n\t\tconst id = setInterval(tick, intervalMs)\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t\tclearInterval(id)\n\t\t}\n\t}, [endpoint, intervalMs, metric, windowMinutes, dataSource])\n\n\tconst nf = new Intl.NumberFormat(locale)\n\tconst points = toRealtimePoints(series, locale)\n\treturn (\n\t\t<>\n\t\t\t<span\n\t\t\t\tstyle={{\n\t\t\t\t\tfontSize: '2rem',\n\t\t\t\t\tfontWeight: 700,\n\t\t\t\t\tlineHeight: 1.1,\n\t\t\t\t\tcolor: 'var(--theme-elevation-800)',\n\t\t\t\t}}\n\t\t\t>\n\t\t\t\t{nf.format(activeNow)}\n\t\t\t</span>\n\t\t\t<span style={{ fontSize: '0.75rem', color: 'var(--theme-elevation-400)' }}>\n\t\t\t\t{paused ? pausedLabel : caption}\n\t\t\t</span>\n\t\t\t<TrendChart buckets={points} ariaLabel={caption} minHeight={120} />\n\t\t</>\n\t)\n}\n"],"mappings":";;;;;;AAoBA,SAAgB,gBAAgB,OAA6B;CAC5D,MAAM,EAAE,UAAU,YAAY,QAAQ,eAAe,YAAY,QAAQ,SAAS,gBACjF;CACD,MAAM,CAAC,WAAW,gBAAgB,SAAS,MAAM,gBAAgB;CACjE,MAAM,CAAC,QAAQ,aAAa,SAAS,MAAM,aAAa;CACxD,MAAM,CAAC,QAAQ,aAAa,SAAS,KAAK;CAE1C,gBAAgB;EACf,IAAI,YAAY;EAChB,MAAM,OAAO,cAAc,UAAU;GAAE;GAAQ;GAAe;EAAW,CAAC;EAC1E,MAAM,OAAO,YAAY;GACxB,IAAI;IACH,MAAM,MAAM,MAAM,MAAM,MAAM,EAAE,aAAa,cAAc,CAAC;IAC5D,IAAI,CAAC,IAAI,IAAI;KACZ,IAAI,CAAC,WAAW,UAAU,IAAI;KAC9B;IACD;IACA,MAAM,OAAQ,MAAM,IAAI,KAAK;IAK7B,IAAI,aAAa,KAAK,WAAW,MAAM;IACvC,aAAa,KAAK,SAAS;IAC3B,UAAU,KAAK,MAAM;IACrB,UAAU,KAAK;GAChB,QAAQ;IACP,IAAI,CAAC,WAAW,UAAU,IAAI;GAC/B;EACD;EACA,MAAM,KAAK,YAAY,MAAM,UAAU;EACvC,aAAa;GACZ,YAAY;GACZ,cAAc,EAAE;EACjB;CACD,GAAG;EAAC;EAAU;EAAY;EAAQ;EAAe;CAAU,CAAC;CAE5D,MAAM,KAAK,IAAI,KAAK,aAAa,MAAM;CACvC,MAAM,SAAS,iBAAiB,QAAQ,MAAM;CAC9C,OACC,qBAAA,UAAA,EAAA,UAAA;EACC,oBAAC,QAAD;GACC,OAAO;IACN,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,OAAO;GACR;aAEC,GAAG,OAAO,SAAS;EACf,CAAA;EACN,oBAAC,QAAD;GAAM,OAAO;IAAE,UAAU;IAAW,OAAO;GAA6B;aACtE,SAAS,cAAc;EACnB,CAAA;EACN,oBAAC,YAAD;GAAY,SAAS;GAAQ,WAAW;GAAS,WAAW;EAAM,CAAA;CACjE,EAAA,CAAA;AAEJ"}
1
+ {"version":3,"file":"RealtimeCounter.js","names":[],"sources":["../../src/widgets/RealtimeCounter.tsx"],"sourcesContent":["'use client'\n\nimport { useMemo } from 'react'\nimport { TrendChart } from '../charts/TrendChart'\nimport { formatMinutes } from '../fields/format'\nimport { numberFormat } from '../translations/intl'\nimport type { PluralName } from '../translations/keys'\nimport { type PluralPhrase, plural, pluralParts } from '../translations/plural'\nimport { useTranslation } from '../translations/useTranslation'\nimport { LiveAnnouncement } from '../ui/components/LiveAnnouncement'\nimport { useRealtimePoll } from '../ui/hooks/useRealtimePoll'\nimport type { RealtimePoint } from './readForWidgetRealtime'\nimport { buildPollPath, type RealtimeReading, toRealtimePoints } from './realtimePoll'\nimport { WidgetBody, WidgetNote, WidgetValue } from './WidgetCard'\n\n/** @beta */\nexport interface RealtimeCounterProps {\n\tendpoint: string\n\tintervalMs: number\n\tmetric: string\n\twindowMinutes: number\n\tdataSource?: string\n\t/** Read another scope; the endpoint refuses any caller that may not. */\n\tscope?: string\n\tinitialActiveNow: number\n\tinitialSeries: RealtimePoint[]\n\t/** Whether the reading it mounts with was counted from a sample. */\n\tinitialSampled?: boolean\n\tlocale: string\n\t/** Reporting timezone the minute labels read in, so server and browser agree. */\n\ttimezone: string\n\t/** Names the sparkline for assistive tech, as the metric's own name does. */\n\tlabel: string\n\t/**\n\t * Words beside the number, the same for every count. Left out, the plugin's own phrase for\n\t * `metric`, worded for the count in the admin's language.\n\t */\n\tcaption?: string\n\tpausedLabel: string\n\t/** Notice for a sampled reading; without it the counter renders none. */\n\tsampledLabel?: string\n\t/** Heads the minutes column of the sparkline's data table, which only assistive tech sees. */\n\tperiodLabel?: string\n\t/** Let the sparkline take the height its card has to spare, as a dashboard widget's does. */\n\tfill?: boolean\n}\n\nexport interface RealtimeReadoutProps {\n\treading: RealtimeReading\n\tpaused: boolean\n\tlocale: string\n\ttimezone: string\n\t/** The phrase the count is worded in, chosen per count in the admin's language. */\n\tphrase: PluralName\n\t/** The minutes the count covers, which a phrase names as its `{{duration}}`. */\n\twindowMinutes?: number\n\t/** Names the sparkline for assistive tech. */\n\tlabel: string\n\t/** A fixed caption in place of the phrase, as a host's own counter may pass. */\n\tcaption?: string\n\tpausedLabel: string\n\tsampledLabel?: string\n\tperiodLabel?: string\n\tfill?: boolean\n}\n\n/**\n * Three minutes on the axis, the window's first, middle and last: a counter sits in a narrow card,\n * and a 12-hour clock's labels with the zone beside the last are wide.\n */\nconst REALTIME_TICKS = 3\n\nconst captionSpan = (text: string) =>\n\ttext === '' ? null : <span className=\"analytics-widget__value-caption\">{text}</span>\n\n/**\n * A live reading: the number, large inside its phrase wherever the language places it, then a\n * sparkline of its last minutes.\n */\nexport function RealtimeReadout({\n\treading,\n\tpaused,\n\tlocale,\n\ttimezone,\n\tphrase,\n\twindowMinutes,\n\tlabel,\n\tcaption,\n\tpausedLabel,\n\tsampledLabel,\n\tperiodLabel,\n\tfill = false,\n}: RealtimeReadoutProps) {\n\tconst translation = useTranslation()\n\tconst points = toRealtimePoints(reading.series, locale, timezone)\n\tconst counted: PluralPhrase =\n\t\twindowMinutes === undefined\n\t\t\t? phrase\n\t\t\t: { name: phrase, vars: { duration: formatMinutes(windowMinutes, locale) } }\n\tconst parts =\n\t\tcaption === undefined\n\t\t\t? pluralParts(translation, counted, reading.activeNow)\n\t\t\t: {\n\t\t\t\t\tbefore: '',\n\t\t\t\t\tcount: numberFormat(locale).format(reading.activeNow),\n\t\t\t\t\tafter: caption,\n\t\t\t\t}\n\tconst spoken =\n\t\tcaption === undefined\n\t\t\t? plural(translation, counted, reading.activeNow)\n\t\t\t: `${parts.count} ${caption}`\n\treturn (\n\t\t<>\n\t\t\t<WidgetValue before={paused ? null : captionSpan(parts.before.trim())} value={parts.count}>\n\t\t\t\t{captionSpan(paused ? pausedLabel : parts.after.trim())}\n\t\t\t</WidgetValue>\n\t\t\t<WidgetBody>\n\t\t\t\t<TrendChart\n\t\t\t\t\tariaLabel={label}\n\t\t\t\t\tbuckets={points}\n\t\t\t\t\tfill={fill}\n\t\t\t\t\tmaxTicks={REALTIME_TICKS}\n\t\t\t\t\tminHeight={fill ? 100 : 120}\n\t\t\t\t\t{...(periodLabel === undefined ? {} : { periodLabel })}\n\t\t\t\t/>\n\t\t\t</WidgetBody>\n\t\t\t{reading.sampled && sampledLabel ? <WidgetNote>{sampledLabel}</WidgetNote> : null}\n\t\t\t<LiveAnnouncement message={paused ? pausedLabel : spoken} />\n\t\t</>\n\t)\n}\n\n/**\n * A live count that mounts with a server-rendered reading and polls it fresh. A new server\n * reading (widget re-rendered) replaces the polled one rather than being stranded behind it.\n *\n * @beta\n */\nexport function RealtimeCounter(props: RealtimeCounterProps) {\n\tconst { endpoint, intervalMs, metric, windowMinutes, dataSource, scope } = props\n\tconst { initialActiveNow, initialSeries, initialSampled } = props\n\tconst initial = useMemo<RealtimeReading>(\n\t\t() => ({\n\t\t\tactiveNow: initialActiveNow,\n\t\t\tseries: initialSeries,\n\t\t\tsampled: initialSampled === true,\n\t\t}),\n\t\t[initialActiveNow, initialSeries, initialSampled]\n\t)\n\tconst url = buildPollPath(endpoint, {\n\t\tmetric,\n\t\twindowMinutes,\n\t\t...(dataSource === undefined ? {} : { dataSource }),\n\t\t...(scope === undefined ? {} : { scope }),\n\t})\n\tconst poll = useRealtimePoll({ url, intervalMs, initial })\n\treturn (\n\t\t<RealtimeReadout\n\t\t\t{...(props.caption === undefined ? {} : { caption: props.caption })}\n\t\t\t{...(props.fill === undefined ? {} : { fill: props.fill })}\n\t\t\tlabel={props.label}\n\t\t\tlocale={props.locale}\n\t\t\tphrase={metric === 'pageviews' ? 'livePageviews' : 'liveVisitors'}\n\t\t\twindowMinutes={windowMinutes}\n\t\t\tpaused={poll.paused}\n\t\t\tpausedLabel={props.pausedLabel}\n\t\t\treading={poll.reading ?? initial}\n\t\t\t{...(props.sampledLabel === undefined ? {} : { sampledLabel: props.sampledLabel })}\n\t\t\t{...(props.periodLabel === undefined ? {} : { periodLabel: props.periodLabel })}\n\t\t\ttimezone={props.timezone}\n\t\t/>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsEA,MAAM,iBAAiB;AAEvB,MAAM,eAAe,SACpB,SAAS,KAAK,OAAO,oBAAC,QAAD;CAAM,WAAU;WAAmC;AAAW,CAAA;;;;;AAMpF,SAAgB,gBAAgB,EAC/B,SACA,QACA,QACA,UACA,QACA,eACA,OACA,SACA,aACA,cACA,aACA,OAAO,SACiB;CACxB,MAAM,cAAc,eAAe;CACnC,MAAM,SAAS,iBAAiB,QAAQ,QAAQ,QAAQ,QAAQ;CAChE,MAAM,UACL,kBAAkB,KAAA,IACf,SACA;EAAE,MAAM;EAAQ,MAAM,EAAE,UAAU,cAAc,eAAe,MAAM,EAAE;CAAE;CAC7E,MAAM,QACL,YAAY,KAAA,IACT,YAAY,aAAa,SAAS,QAAQ,SAAS,IACnD;EACA,QAAQ;EACR,OAAO,aAAa,MAAM,EAAE,OAAO,QAAQ,SAAS;EACpD,OAAO;CACR;CACH,MAAM,SACL,YAAY,KAAA,IACT,OAAO,aAAa,SAAS,QAAQ,SAAS,IAC9C,GAAG,MAAM,MAAM,GAAG;CACtB,OACC,qBAAA,UAAA,EAAA,UAAA;EACC,oBAAC,aAAD;GAAa,QAAQ,SAAS,OAAO,YAAY,MAAM,OAAO,KAAK,CAAC;GAAG,OAAO,MAAM;aAClF,YAAY,SAAS,cAAc,MAAM,MAAM,KAAK,CAAC;EAC1C,CAAA;EACb,oBAAC,YAAD,EAAA,UACC,oBAAC,YAAD;GACC,WAAW;GACX,SAAS;GACH;GACN,UAAU;GACV,WAAW,OAAO,MAAM;GACxB,GAAK,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,YAAY;EACpD,CAAA,EACU,CAAA;EACX,QAAQ,WAAW,eAAe,oBAAC,YAAD,EAAA,UAAa,aAAyB,CAAA,IAAI;EAC7E,oBAAC,kBAAD,EAAkB,SAAS,SAAS,cAAc,OAAS,CAAA;CAC1D,EAAA,CAAA;AAEJ;;;;;;;AAQA,SAAgB,gBAAgB,OAA6B;CAC5D,MAAM,EAAE,UAAU,YAAY,QAAQ,eAAe,YAAY,UAAU;CAC3E,MAAM,EAAE,kBAAkB,eAAe,mBAAmB;CAC5D,MAAM,UAAU,eACR;EACN,WAAW;EACX,QAAQ;EACR,SAAS,mBAAmB;CAC7B,IACA;EAAC;EAAkB;EAAe;CAAc,CACjD;CAOA,MAAM,OAAO,gBAAgB;EAAE,KANnB,cAAc,UAAU;GACnC;GACA;GACA,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;GACjD,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACxC,CACiC;EAAG;EAAY;CAAQ,CAAC;CACzD,OACC,oBAAC,iBAAD;EACC,GAAK,MAAM,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,MAAM,QAAQ;EACjE,GAAK,MAAM,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM,MAAM,KAAK;EACxD,OAAO,MAAM;EACb,QAAQ,MAAM;EACd,QAAQ,WAAW,cAAc,kBAAkB;EACpC;EACf,QAAQ,KAAK;EACb,aAAa,MAAM;EACnB,SAAS,KAAK,WAAW;EACzB,GAAK,MAAM,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,MAAM,aAAa;EAChF,GAAK,MAAM,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,MAAM,YAAY;EAC7E,UAAU,MAAM;CAChB,CAAA;AAEH"}
@@ -0,0 +1,80 @@
1
+ import { ReactNode } from "react";
2
+ //#region src/widgets/WidgetCard.d.ts
3
+ /** @beta */
4
+ interface WidgetCardProps {
5
+ /** The widget kind's own hook, beside the shared `analytics-widget`. */
6
+ className?: string;
7
+ title: string;
8
+ /** The window the card reads, on the title's line. Left out where there is nothing to read. */
9
+ caption?: string;
10
+ /** The value row, the body and the note, in that order. */
11
+ children?: ReactNode;
12
+ /** The footer link. No `href` renders no footer, which is how "the view is off" arrives. */
13
+ link?: {
14
+ href?: string;
15
+ label: string;
16
+ };
17
+ }
18
+ /**
19
+ * Dashboard card: title and window, content, and a footer link the title describes.
20
+ * Its only hook is `useId`, which server components may call, so any widget can compose it.
21
+ *
22
+ * @beta
23
+ */
24
+ declare function WidgetCard({
25
+ className,
26
+ title,
27
+ caption,
28
+ children,
29
+ link
30
+ }: WidgetCardProps): import("react/jsx-runtime").JSX.Element;
31
+ /**
32
+ * The big number with its qualifiers (delta, caption) beside it. `before` is what a language
33
+ * words ahead of the number; `noValueLabel` is read out in place of a missing reading's dash.
34
+ *
35
+ * @beta
36
+ */
37
+ declare function WidgetValue({
38
+ value,
39
+ noValueLabel,
40
+ before,
41
+ children
42
+ }: {
43
+ value: string;
44
+ noValueLabel?: string;
45
+ before?: ReactNode;
46
+ children?: ReactNode;
47
+ }): import("react/jsx-runtime").JSX.Element;
48
+ /**
49
+ * The chart, list or table, given the height the card has left.
50
+ *
51
+ * @beta
52
+ */
53
+ declare function WidgetBody({
54
+ children
55
+ }: {
56
+ children: ReactNode;
57
+ }): import("react/jsx-runtime").JSX.Element;
58
+ /**
59
+ * A message in place of the body, centered where the body would have been.
60
+ *
61
+ * @beta
62
+ */
63
+ declare function WidgetEmpty({
64
+ children
65
+ }: {
66
+ children: ReactNode;
67
+ }): import("react/jsx-runtime").JSX.Element;
68
+ /**
69
+ * The read's caveats, one line under the body; nothing at all when there are none.
70
+ *
71
+ * @beta
72
+ */
73
+ declare function WidgetNote({
74
+ children
75
+ }: {
76
+ children: string;
77
+ }): import("react/jsx-runtime").JSX.Element | null;
78
+ //#endregion
79
+ export { WidgetBody, WidgetCard, WidgetCardProps, WidgetEmpty, WidgetNote, WidgetValue };
80
+ //# sourceMappingURL=WidgetCard.d.ts.map
@@ -0,0 +1,99 @@
1
+ import { shownValue } from "../ui/components/NoValue.js";
2
+ import { Card } from "../ui/components/Card.js";
3
+ import { useId } from "react";
4
+ import "../ui/analytics.css";
5
+ import { jsx, jsxs } from "react/jsx-runtime";
6
+ //#region src/widgets/WidgetCard.tsx
7
+ /**
8
+ * Dashboard card: title and window, content, and a footer link the title describes.
9
+ * Its only hook is `useId`, which server components may call, so any widget can compose it.
10
+ *
11
+ * @beta
12
+ */
13
+ function WidgetCard({ className, title, caption, children, link }) {
14
+ const titleId = useId();
15
+ return /* @__PURE__ */ jsxs(Card, {
16
+ className: className ? `analytics-widget ${className}` : "analytics-widget",
17
+ children: [
18
+ /* @__PURE__ */ jsxs("div", {
19
+ className: "analytics-widget__header",
20
+ children: [/* @__PURE__ */ jsx("h2", {
21
+ className: "analytics-widget__title",
22
+ id: titleId,
23
+ title,
24
+ children: title
25
+ }), caption ? /* @__PURE__ */ jsx("span", {
26
+ className: "analytics-widget__caption",
27
+ title: caption,
28
+ children: caption
29
+ }) : null]
30
+ }),
31
+ children,
32
+ link?.href === void 0 ? null : /* @__PURE__ */ jsx("div", {
33
+ className: "analytics-widget__footer",
34
+ children: /* @__PURE__ */ jsx("a", {
35
+ "aria-describedby": titleId,
36
+ className: "analytics-widget__link",
37
+ href: link.href,
38
+ children: link.label
39
+ })
40
+ })
41
+ ]
42
+ });
43
+ }
44
+ /**
45
+ * The big number with its qualifiers (delta, caption) beside it. `before` is what a language
46
+ * words ahead of the number; `noValueLabel` is read out in place of a missing reading's dash.
47
+ *
48
+ * @beta
49
+ */
50
+ function WidgetValue({ value, noValueLabel, before, children }) {
51
+ return /* @__PURE__ */ jsxs("div", {
52
+ className: "analytics-widget__value-row",
53
+ children: [
54
+ before,
55
+ /* @__PURE__ */ jsx("span", {
56
+ className: "analytics-widget__value",
57
+ children: shownValue(value, noValueLabel)
58
+ }),
59
+ children
60
+ ]
61
+ });
62
+ }
63
+ /**
64
+ * The chart, list or table, given the height the card has left.
65
+ *
66
+ * @beta
67
+ */
68
+ function WidgetBody({ children }) {
69
+ return /* @__PURE__ */ jsx("div", {
70
+ className: "analytics-widget__body",
71
+ children
72
+ });
73
+ }
74
+ /**
75
+ * A message in place of the body, centered where the body would have been.
76
+ *
77
+ * @beta
78
+ */
79
+ function WidgetEmpty({ children }) {
80
+ return /* @__PURE__ */ jsx("div", {
81
+ className: "analytics-widget__empty",
82
+ children
83
+ });
84
+ }
85
+ /**
86
+ * The read's caveats, one line under the body; nothing at all when there are none.
87
+ *
88
+ * @beta
89
+ */
90
+ function WidgetNote({ children }) {
91
+ return children === "" ? null : /* @__PURE__ */ jsx("span", {
92
+ className: "analytics-widget__note",
93
+ children
94
+ });
95
+ }
96
+ //#endregion
97
+ export { WidgetBody, WidgetCard, WidgetEmpty, WidgetNote, WidgetValue };
98
+
99
+ //# sourceMappingURL=WidgetCard.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WidgetCard.js","names":[],"sources":["../../src/widgets/WidgetCard.tsx"],"sourcesContent":["import { type ReactNode, useId } from 'react'\nimport { Card } from '../ui/components/Card'\nimport { shownValue } from '../ui/components/NoValue'\nimport '../ui/analytics.css'\n\n/** @beta */\nexport interface WidgetCardProps {\n\t/** The widget kind's own hook, beside the shared `analytics-widget`. */\n\tclassName?: string\n\ttitle: string\n\t/** The window the card reads, on the title's line. Left out where there is nothing to read. */\n\tcaption?: string\n\t/** The value row, the body and the note, in that order. */\n\tchildren?: ReactNode\n\t/** The footer link. No `href` renders no footer, which is how \"the view is off\" arrives. */\n\tlink?: { href?: string; label: string }\n}\n\n/**\n * Dashboard card: title and window, content, and a footer link the title describes.\n * Its only hook is `useId`, which server components may call, so any widget can compose it.\n *\n * @beta\n */\nexport function WidgetCard({ className, title, caption, children, link }: WidgetCardProps) {\n\tconst titleId = useId()\n\treturn (\n\t\t<Card className={className ? `analytics-widget ${className}` : 'analytics-widget'}>\n\t\t\t<div className=\"analytics-widget__header\">\n\t\t\t\t{/* The header keeps one line and cuts what does not fit, so hovering shows it whole. */}\n\t\t\t\t<h2 className=\"analytics-widget__title\" id={titleId} title={title}>\n\t\t\t\t\t{title}\n\t\t\t\t</h2>\n\t\t\t\t{caption ? (\n\t\t\t\t\t<span className=\"analytics-widget__caption\" title={caption}>\n\t\t\t\t\t\t{caption}\n\t\t\t\t\t</span>\n\t\t\t\t) : null}\n\t\t\t</div>\n\t\t\t{children}\n\t\t\t{link?.href === undefined ? null : (\n\t\t\t\t<div className=\"analytics-widget__footer\">\n\t\t\t\t\t<a aria-describedby={titleId} className=\"analytics-widget__link\" href={link.href}>\n\t\t\t\t\t\t{link.label}\n\t\t\t\t\t</a>\n\t\t\t\t</div>\n\t\t\t)}\n\t\t</Card>\n\t)\n}\n\n/**\n * The big number with its qualifiers (delta, caption) beside it. `before` is what a language\n * words ahead of the number; `noValueLabel` is read out in place of a missing reading's dash.\n *\n * @beta\n */\nexport function WidgetValue({\n\tvalue,\n\tnoValueLabel,\n\tbefore,\n\tchildren,\n}: {\n\tvalue: string\n\tnoValueLabel?: string\n\tbefore?: ReactNode\n\tchildren?: ReactNode\n}) {\n\treturn (\n\t\t<div className=\"analytics-widget__value-row\">\n\t\t\t{before}\n\t\t\t<span className=\"analytics-widget__value\">{shownValue(value, noValueLabel)}</span>\n\t\t\t{children}\n\t\t</div>\n\t)\n}\n\n/**\n * The chart, list or table, given the height the card has left.\n *\n * @beta\n */\nexport function WidgetBody({ children }: { children: ReactNode }) {\n\treturn <div className=\"analytics-widget__body\">{children}</div>\n}\n\n/**\n * A message in place of the body, centered where the body would have been.\n *\n * @beta\n */\nexport function WidgetEmpty({ children }: { children: ReactNode }) {\n\treturn <div className=\"analytics-widget__empty\">{children}</div>\n}\n\n/**\n * The read's caveats, one line under the body; nothing at all when there are none.\n *\n * @beta\n */\nexport function WidgetNote({ children }: { children: string }) {\n\treturn children === '' ? null : <span className=\"analytics-widget__note\">{children}</span>\n}\n"],"mappings":";;;;;;;;;;;;AAwBA,SAAgB,WAAW,EAAE,WAAW,OAAO,SAAS,UAAU,QAAyB;CAC1F,MAAM,UAAU,MAAM;CACtB,OACC,qBAAC,MAAD;EAAM,WAAW,YAAY,oBAAoB,cAAc;YAA/D;GACC,qBAAC,OAAD;IAAK,WAAU;cAAf,CAEC,oBAAC,MAAD;KAAI,WAAU;KAA0B,IAAI;KAAgB;eAC1D;IACE,CAAA,GACH,UACA,oBAAC,QAAD;KAAM,WAAU;KAA4B,OAAO;eACjD;IACI,CAAA,IACH,IACA;;GACJ;GACA,MAAM,SAAS,KAAA,IAAY,OAC3B,oBAAC,OAAD;IAAK,WAAU;cACd,oBAAC,KAAD;KAAG,oBAAkB;KAAS,WAAU;KAAyB,MAAM,KAAK;eAC1E,KAAK;IACJ,CAAA;GACC,CAAA;EAED;;AAER;;;;;;;AAQA,SAAgB,YAAY,EAC3B,OACA,cACA,QACA,YAME;CACF,OACC,qBAAC,OAAD;EAAK,WAAU;YAAf;GACE;GACD,oBAAC,QAAD;IAAM,WAAU;cAA2B,WAAW,OAAO,YAAY;GAAQ,CAAA;GAChF;EACG;;AAEP;;;;;;AAOA,SAAgB,WAAW,EAAE,YAAqC;CACjE,OAAO,oBAAC,OAAD;EAAK,WAAU;EAA0B;CAAc,CAAA;AAC/D;;;;;;AAOA,SAAgB,YAAY,EAAE,YAAqC;CAClE,OAAO,oBAAC,OAAD;EAAK,WAAU;EAA2B;CAAc,CAAA;AAChE;;;;;;AAOA,SAAgB,WAAW,EAAE,YAAkC;CAC9D,OAAO,aAAa,KAAK,OAAO,oBAAC,QAAD;EAAM,WAAU;EAA0B;CAAe,CAAA;AAC1F"}
@@ -0,0 +1,42 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { asTranslate } from "../translations/server.js";
3
+ import { WIDGET_STATE_KEYS } from "./stateKeys.js";
4
+ import { WidgetCard, WidgetEmpty } from "./WidgetCard.js";
5
+ import { WithScopeToken } from "../ui/data/WithScopeToken.js";
6
+ import { retryOfferFor } from "../ui/readState.js";
7
+ import { ReadState } from "../ui/components/ReadState.js";
8
+ import { WidgetSuspense } from "./WidgetShimmer.js";
9
+ import { jsx } from "react/jsx-runtime";
10
+ //#region src/widgets/WidgetFrame.tsx
11
+ /**
12
+ * A built-in widget's frame: its loading card paints at once, and its body streams in with the
13
+ * request's scope token mounted for the client parts.
14
+ */
15
+ function WidgetFrame({ widget, children, ...shimmer }) {
16
+ const t = asTranslate(widget.req.i18n.t);
17
+ return /* @__PURE__ */ jsx(WidgetSuspense, {
18
+ ...shimmer,
19
+ ...widget.view ? { link: t(keys.widgetOpenInView) } : {},
20
+ children: /* @__PURE__ */ jsx(WithScopeToken, {
21
+ req: widget.req,
22
+ children
23
+ })
24
+ });
25
+ }
26
+ /** A card that says why it has no numbers, offering a retry where waiting can help. */
27
+ function WidgetStateCard({ status, retryAfterMs, t, locale, ...card }) {
28
+ return /* @__PURE__ */ jsx(WidgetCard, {
29
+ ...card,
30
+ children: /* @__PURE__ */ jsx(WidgetEmpty, { children: /* @__PURE__ */ jsx(ReadState, {
31
+ message: t(WIDGET_STATE_KEYS[status]),
32
+ retry: retryOfferFor(status, retryAfterMs, {
33
+ t,
34
+ locale
35
+ })
36
+ }) })
37
+ });
38
+ }
39
+ //#endregion
40
+ export { WidgetFrame, WidgetStateCard };
41
+
42
+ //# sourceMappingURL=WidgetFrame.js.map