@10x-media/analytics 1.0.0-beta.11 → 1.0.0-beta.13

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 (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,21 +1,21 @@
1
1
  //#region src/charts/bars.ts
2
2
  /**
3
- * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked
4
- * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide
5
- * by zero.
3
+ * Each value as a `[0, 1]` fraction of the largest; an all-zero set and a missing reading draw no
4
+ * bar, never a divide by zero.
6
5
  */
6
+ const barShares = (values) => {
7
+ const max = values.reduce((m, value) => Math.max(m, value ?? 0), 0);
8
+ return values.map((value) => max > 0 && value !== null ? value / max : 0);
9
+ };
10
+ /** Each datum with its {@link barShares} fraction, for a ranked bar list. */
7
11
  const toBarRows = (data) => {
8
- const max = data.reduce((m, d) => Math.max(m, d.value), 0);
9
- return data.map((d) => ({
10
- label: d.label,
11
- value: d.value,
12
- fraction: max > 0 ? d.value / max : 0,
13
- display: d.display,
14
- secondary: d.secondary,
15
- selectable: d.selectable
12
+ const shares = barShares(data.map((d) => d.value));
13
+ return data.map((d, i) => ({
14
+ ...d,
15
+ fraction: shares[i] ?? 0
16
16
  }));
17
17
  };
18
18
  //#endregion
19
- export { toBarRows };
19
+ export { barShares, toBarRows };
20
20
 
21
21
  //# sourceMappingURL=bars.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bars.js","names":[],"sources":["../../src/charts/bars.ts"],"sourcesContent":["export interface BarDatum {\n\tlabel: string\n\tvalue: number\n\tdisplay?: string\n\t/** A second, unbarred column (the view's `visitors` beside the charted metric). */\n\tsecondary?: string\n\t/** `false` keeps this one row inert in a list that is otherwise selectable. */\n\tselectable?: boolean\n}\n\nexport interface BarRow {\n\tlabel: string\n\tvalue: number\n\tfraction: number\n\tdisplay?: string\n\tsecondary?: string\n\tselectable?: boolean\n}\n\n/**\n * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked\n * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide\n * by zero.\n */\nexport const toBarRows = (data: BarDatum[]): BarRow[] => {\n\tconst max = data.reduce((m, d) => Math.max(m, d.value), 0)\n\treturn data.map((d) => ({\n\t\tlabel: d.label,\n\t\tvalue: d.value,\n\t\tfraction: max > 0 ? d.value / max : 0,\n\t\tdisplay: d.display,\n\t\tsecondary: d.secondary,\n\t\tselectable: d.selectable,\n\t}))\n}\n"],"mappings":";;;;;;AAwBA,MAAa,aAAa,SAA+B;CACxD,MAAM,MAAM,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;CACzD,OAAO,KAAK,KAAK,OAAO;EACvB,OAAO,EAAE;EACT,OAAO,EAAE;EACT,UAAU,MAAM,IAAI,EAAE,QAAQ,MAAM;EACpC,SAAS,EAAE;EACX,WAAW,EAAE;EACb,YAAY,EAAE;CACf,EAAE;AACH"}
1
+ {"version":3,"file":"bars.js","names":[],"sources":["../../src/charts/bars.ts"],"sourcesContent":["import type { ReactNode } from 'react'\nimport type { MetricValue } from '../core/contract'\n\n/** @beta */\nexport interface BarDatum {\n\tlabel: string\n\t/** `null` is no reading for the row: no bar, and a dash where no `display` says otherwise. */\n\tvalue: MetricValue\n\tdisplay?: string\n\t/** A second, unbarred column (the view's `visitors` beside the charted metric). */\n\tsecondary?: string\n\t/** A third, unbarred column (the events and goals tabs' conversion rate). */\n\ttertiary?: string\n\t/** A fourth, unbarred column (the Content tab's conversions, after its click rate). */\n\tquaternary?: string\n\t/**\n\t * Drawn before the label and hidden from assistive tech: a country flag reads as the\n\t * name beside it, so announcing both says the same thing twice.\n\t */\n\tdecoration?: ReactNode\n\t/** `false` keeps this one row inert in a list that is otherwise selectable. */\n\tselectable?: boolean\n}\n\nexport interface BarRow extends BarDatum {\n\t/** The value's share of the largest, from {@link barShares}. */\n\tfraction: number\n}\n\n/**\n * Each value as a `[0, 1]` fraction of the largest; an all-zero set and a missing reading draw no\n * bar, never a divide by zero.\n */\nexport const barShares = (values: readonly MetricValue[]): number[] => {\n\tconst max = values.reduce<number>((m, value) => Math.max(m, value ?? 0), 0)\n\treturn values.map((value) => (max > 0 && value !== null ? value / max : 0))\n}\n\n/** Each datum with its {@link barShares} fraction, for a ranked bar list. */\nexport const toBarRows = (data: BarDatum[]): BarRow[] => {\n\tconst shares = barShares(data.map((d) => d.value))\n\treturn data.map((d, i) => ({ ...d, fraction: shares[i] ?? 0 }))\n}\n"],"mappings":";;;;;AAiCA,MAAa,aAAa,WAA6C;CACtE,MAAM,MAAM,OAAO,QAAgB,GAAG,UAAU,KAAK,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC;CAC1E,OAAO,OAAO,KAAK,UAAW,MAAM,KAAK,UAAU,OAAO,QAAQ,MAAM,CAAE;AAC3E;;AAGA,MAAa,aAAa,SAA+B;CACxD,MAAM,SAAS,UAAU,KAAK,KAAK,MAAM,EAAE,KAAK,CAAC;CACjD,OAAO,KAAK,KAAK,GAAG,OAAO;EAAE,GAAG;EAAG,UAAU,OAAO,MAAM;CAAE,EAAE;AAC/D"}
@@ -1,7 +1,8 @@
1
- import { startOfDayInTz, startOfMonthInTz, startOfWeekInTz } from "../timeframe/tz.js";
1
+ import { DAY_MS, HOUR_MS, addDaysInTz, startOfHourInTz } from "../timeframe/tz.js";
2
+ import { dateTimeFormat } from "../translations/intl.js";
2
3
  //#region src/charts/bucket.ts
3
4
  const UNIT_BY_TIMEFRAME = {
4
- today: "day",
5
+ today: "hour",
5
6
  last7days: "day",
6
7
  last30days: "day",
7
8
  thisMonth: "day",
@@ -10,86 +11,118 @@ const UNIT_BY_TIMEFRAME = {
10
11
  lastYear: "month",
11
12
  allTime: "month"
12
13
  };
13
- const bucketStart = (d, unit, tz) => {
14
- if (unit === "month") return startOfMonthInTz(d, tz);
15
- if (unit === "week") return startOfWeekInTz(d, tz);
16
- return startOfDayInTz(d, tz);
14
+ const DEFAULT_LOCALE = "en-US";
15
+ /**
16
+ * The unit a preset's chart buckets on. `hour` needs an hourly series: a daily one has a single
17
+ * point there, so a source without hourly rows has no chart.
18
+ */
19
+ const unitForTimeframe = (timeframe) => UNIT_BY_TIMEFRAME[timeframe];
20
+ /**
21
+ * The unit a window's series is read and charted at: a window of two days or less by hour,
22
+ * short ranges by day, a quarter by week, longer by month.
23
+ */
24
+ const unitForRange = (range) => {
25
+ const spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY_MS);
26
+ return spanDays <= 2 ? "hour" : spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
17
27
  };
18
- const bucketByUnit = (points, { unit, weekday, tz }) => {
19
- const groups = /* @__PURE__ */ new Map();
20
- for (const p of points) {
21
- const d = bucketStart(new Date(p.date), unit, tz);
22
- const key = d.toISOString();
23
- const g = groups.get(key);
24
- if (g) g.value += p.value;
25
- else groups.set(key, {
26
- date: d,
27
- value: p.value
28
- });
29
- }
30
- const sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
31
- const multiYear = new Set(sorted.map((g) => new Intl.DateTimeFormat("en-US", {
32
- year: "numeric",
33
- timeZone: tz
34
- }).format(g.date))).size > 1;
35
- const format = (d) => {
36
- if (weekday) return new Intl.DateTimeFormat("en-US", {
37
- weekday: "short",
38
- timeZone: tz
39
- }).format(d);
40
- if (unit === "month") return new Intl.DateTimeFormat("en-US", {
41
- month: "short",
42
- year: multiYear ? "numeric" : void 0,
43
- timeZone: tz
44
- }).format(d);
45
- return new Intl.DateTimeFormat("en-US", {
46
- month: "short",
47
- day: "numeric",
48
- timeZone: tz
49
- }).format(d);
50
- };
51
- return sorted.map((g) => ({
52
- label: format(g.date),
53
- value: g.value
54
- }));
28
+ const yearOf = (at, locale, timeZone) => dateTimeFormat(locale, {
29
+ year: "numeric",
30
+ timeZone
31
+ }).format(at);
32
+ /** One bucket's axis label, from its start in the reporting timezone (or `from`, if later). */
33
+ const bucketLabel = (start, { granularity, tz: timeZone = "UTC", locale = DEFAULT_LOCALE, weekday, from }, withYear = false) => {
34
+ const at = from !== void 0 && start.getTime() < from.getTime() ? from : start;
35
+ if (granularity === "minute") return dateTimeFormat(locale, {
36
+ hour: "2-digit",
37
+ minute: "2-digit",
38
+ timeZone
39
+ }).format(at);
40
+ if (granularity === "hour") return dateTimeFormat(locale, {
41
+ hour: "numeric",
42
+ timeZone
43
+ }).format(at);
44
+ if (granularity === "day" && weekday === true) return dateTimeFormat(locale, {
45
+ weekday: "short",
46
+ timeZone
47
+ }).format(at);
48
+ if (granularity === "month") return dateTimeFormat(locale, {
49
+ month: "short",
50
+ ...withYear ? { year: "numeric" } : {},
51
+ timeZone
52
+ }).format(at);
53
+ return dateTimeFormat(locale, {
54
+ month: "short",
55
+ day: "numeric",
56
+ timeZone
57
+ }).format(at);
55
58
  };
56
59
  /**
57
- * Aggregate a daily series into display buckets sized to the timeframe (day for short
58
- * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and
59
- * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting
60
- * timezone the series and comparison windows are aligned to. Distinct metrics are summed
61
- * per bucket (a documented daily-uniques approximation).
60
+ * The day an hour tick leaves out, so a two-day window's tooltip still says which "9 AM" it is.
61
+ * Every coarser bucket's tick already identifies itself, and reads undefined here.
62
62
  */
63
- const bucketSeries = (points, timeframe, tz = "UTC") => bucketByUnit(points, {
64
- unit: UNIT_BY_TIMEFRAME[timeframe],
65
- weekday: timeframe === "last7days" || timeframe === "today",
66
- tz
67
- });
63
+ const bucketTooltipLabel = (at, { granularity, tz = "UTC", locale = DEFAULT_LOCALE }) => granularity === "hour" ? dateTimeFormat(locale, {
64
+ weekday: "short",
65
+ hour: "numeric",
66
+ timeZone: tz
67
+ }).format(at) : void 0;
68
+ /** Whether a month axis needs its years: always on request, else when the series crosses one. */
69
+ const monthsNeedYear = (dates, options) => {
70
+ if (options.granularity !== "month") return false;
71
+ if (options.year === "always") return true;
72
+ const locale = options.locale ?? DEFAULT_LOCALE;
73
+ const tz = options.tz ?? "UTC";
74
+ return new Set(dates.map((at) => yearOf(at, locale, tz))).size > 1;
75
+ };
76
+ /** A bucket's axis label and, for an hour, the tooltip label naming its day. */
77
+ const labelsOf = (start, options, withYear = false) => {
78
+ const tooltipLabel = bucketTooltipLabel(start, options);
79
+ return {
80
+ label: bucketLabel(start, options, withYear),
81
+ ...tooltipLabel === void 0 ? {} : { tooltipLabel }
82
+ };
83
+ };
84
+ /** A day holds at most 25 hours, the one a clock falls back in. */
85
+ const MAX_DAY_HOURS = 25;
68
86
  /**
69
- * Re-date a comparison series onto the primary axis it is already index-aligned to, so both
70
- * series bucket on identical boundaries: bucketed on its own dates, a previous window can
71
- * split into a different number of weeks or months than the window it overlays.
87
+ * The hours after `last` to the end of its day in the reporting timezone, marked upcoming, so a day
88
+ * under way keeps its whole axis.
72
89
  */
73
- const onPrimaryAxis = (comparison, axis) => comparison.map((point, i) => ({
74
- date: axis[i]?.date ?? point.date,
75
- value: point.value
76
- }));
77
- const DAY = 864e5;
78
- const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
90
+ const upcomingHours = (last, options) => {
91
+ const tz = options.tz ?? "UTC";
92
+ const hourly = {
93
+ ...options,
94
+ granularity: "hour"
95
+ };
96
+ const dayEnd = addDaysInTz(last, 1, tz).getTime();
97
+ const hours = [];
98
+ let at = startOfHourInTz(new Date(last.getTime() + HOUR_MS), tz);
99
+ while (at.getTime() < dayEnd && hours.length < MAX_DAY_HOURS) {
100
+ hours.push({
101
+ at: at.toISOString(),
102
+ ...labelsOf(at, hourly),
103
+ value: null,
104
+ upcoming: true
105
+ });
106
+ at = startOfHourInTz(new Date(at.getTime() + HOUR_MS), tz);
107
+ }
108
+ return hours;
109
+ };
79
110
  /**
80
- * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from
81
- * the span the way the presets do: short ranges by day, a quarter by week, longer by
82
- * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for
83
- * the fixed 7-day preset, never here.
111
+ * Labels a series the engine already bucketed and summed, one chart bucket per point named by its
112
+ * start in the reporting timezone; an hourly series runs on to its day's end via {@link upcomingHours}.
84
113
  */
85
- const bucketByRange = (points, range, tz = "UTC") => {
86
- return bucketByUnit(points, {
87
- unit: unitForSpan(Math.round((range.end.getTime() - range.start.getTime()) / DAY)),
88
- weekday: false,
89
- tz
90
- });
114
+ const labelSeries = (points, options) => {
115
+ const dates = points.map((point) => new Date(point.date));
116
+ const withYear = monthsNeedYear(dates, options);
117
+ const labeled = points.map((point, i) => ({
118
+ at: point.date,
119
+ ...labelsOf(dates[i] ?? new Date(point.date), options, withYear),
120
+ value: point.value
121
+ }));
122
+ const last = dates.at(-1);
123
+ return options.granularity === "hour" && last !== void 0 ? [...labeled, ...upcomingHours(last, options)] : labeled;
91
124
  };
92
125
  //#endregion
93
- export { bucketByRange, bucketSeries, onPrimaryAxis };
126
+ export { bucketLabel, bucketTooltipLabel, labelSeries, unitForRange, unitForTimeframe, upcomingHours };
94
127
 
95
128
  //# sourceMappingURL=bucket.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfWeekInTz,\n} from '../timeframe/tz'\nimport type { SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport interface ChartBucket {\n\tlabel: string\n\tvalue: number\n}\n\ntype Unit = 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, Unit> = {\n\ttoday: 'day',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst bucketStart = (d: Date, unit: Unit, tz: string): Date => {\n\tif (unit === 'month') return startOfMonthInTz(d, tz)\n\tif (unit === 'week') return startOfWeekInTz(d, tz)\n\treturn startOfDayInTz(d, tz)\n}\n\ninterface BucketConfig {\n\tunit: Unit\n\t/** Label each bucket by weekday (only the fixed 7-day / today presets). */\n\tweekday: boolean\n\ttz: string\n}\n\nconst bucketByUnit = (\n\tpoints: SeriesPoint[],\n\t{ unit, weekday, tz }: BucketConfig\n): ChartBucket[] => {\n\tconst groups = new Map<string, { date: Date; value: number }>()\n\tfor (const p of points) {\n\t\tconst d = bucketStart(new Date(p.date), unit, tz)\n\t\tconst key = d.toISOString()\n\t\tconst g = groups.get(key)\n\t\tif (g) {\n\t\t\tg.value += p.value\n\t\t} else {\n\t\t\tgroups.set(key, { date: d, value: p.value })\n\t\t}\n\t}\n\tconst sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime())\n\t// The label reads each bucket's start in the reporting timezone, so a zone whose day\n\t// starts fall on the previous UTC calendar day still labels the correct local date.\n\tconst years = new Set(\n\t\tsorted.map((g) =>\n\t\t\tnew Intl.DateTimeFormat('en-US', { year: 'numeric', timeZone: tz }).format(g.date)\n\t\t)\n\t)\n\tconst multiYear = years.size > 1\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: tz }).format(d)\n\t\t}\n\t\tif (unit === 'month') {\n\t\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\t\tmonth: 'short',\n\t\t\t\tyear: multiYear ? 'numeric' : undefined,\n\t\t\t\ttimeZone: tz,\n\t\t\t}).format(d)\n\t\t}\n\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\tmonth: 'short',\n\t\t\tday: 'numeric',\n\t\t\ttimeZone: tz,\n\t\t}).format(d)\n\t}\n\treturn sorted.map((g) => ({ label: format(g.date), value: g.value }))\n}\n\n/**\n * Aggregate a daily series into display buckets sized to the timeframe (day for short\n * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and\n * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting\n * timezone the series and comparison windows are aligned to. Distinct metrics are summed\n * per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] =>\n\tbucketByUnit(points, {\n\t\tunit: UNIT_BY_TIMEFRAME[timeframe],\n\t\tweekday: timeframe === 'last7days' || timeframe === 'today',\n\t\ttz,\n\t})\n\n/**\n * Re-date a comparison series onto the primary axis it is already index-aligned to, so both\n * series bucket on identical boundaries: bucketed on its own dates, a previous window can\n * split into a different number of weeks or months than the window it overlays.\n */\nexport const onPrimaryAxis = (comparison: SeriesPoint[], axis: SeriesPoint[]): SeriesPoint[] =>\n\tcomparison.map((point, i) => ({ date: axis[i]?.date ?? point.date, value: point.value }))\n\nconst DAY = 86_400_000\n\nconst unitForSpan = (spanDays: number): Unit =>\n\tspanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n\n/**\n * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from\n * the span the way the presets do: short ranges by day, a quarter by week, longer by\n * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for\n * the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (\n\tpoints: SeriesPoint[],\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, { unit: unitForSpan(spanDays), weekday: false, tz })\n}\n"],"mappings":";;AAiBA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,eAAe,GAAS,MAAY,OAAqB;CAC9D,IAAI,SAAS,SAAS,OAAO,iBAAiB,GAAG,EAAE;CACnD,IAAI,SAAS,QAAQ,OAAO,gBAAgB,GAAG,EAAE;CACjD,OAAO,eAAe,GAAG,EAAE;AAC5B;AASA,MAAM,gBACL,QACA,EAAE,MAAM,SAAS,SACE;CACnB,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE;EAChD,MAAM,MAAM,EAAE,YAAY;EAC1B,MAAM,IAAI,OAAO,IAAI,GAAG;EACxB,IAAI,GACH,EAAE,SAAS,EAAE;OAEb,OAAO,IAAI,KAAK;GAAE,MAAM;GAAG,OAAO,EAAE;EAAM,CAAC;CAE7C;CACA,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;CAQtF,MAAM,YAAY,IALA,IACjB,OAAO,KAAK,MACX,IAAI,KAAK,eAAe,SAAS;EAAE,MAAM;EAAW,UAAU;CAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAClF,CAEqB,EAAE,OAAO;CAC/B,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAG,CAAC,EAAE,OAAO,CAAC;EAErF,IAAI,SAAS,SACZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,MAAM,YAAY,YAAY,KAAA;GAC9B,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;EAEZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,KAAK;GACL,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;CACZ;CACA,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE,IAAI;EAAG,OAAO,EAAE;CAAM,EAAE;AACrE;;;;;;;;AASA,MAAa,gBACZ,QACA,WACA,KAAA,UAEA,aAAa,QAAQ;CACpB,MAAM,kBAAkB;CACxB,SAAS,cAAc,eAAe,cAAc;CACpD;AACD,CAAC;;;;;;AAOF,MAAa,iBAAiB,YAA2B,SACxD,WAAW,KAAK,OAAO,OAAO;CAAE,MAAM,KAAK,IAAI,QAAQ,MAAM;CAAM,OAAO,MAAM;AAAM,EAAE;AAEzF,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;;AAQrD,MAAa,iBACZ,QACA,OACA,KAAA,UACmB;CAEnB,OAAO,aAAa,QAAQ;EAAE,MAAM,YADnB,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GACrB,CAAC;EAAG,SAAS;EAAO;CAAG,CAAC;AAChF"}
1
+ {"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange, Granularity, MetricValue } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { addDaysInTz, DAY_MS, DEFAULT_TIMEZONE, HOUR_MS, startOfHourInTz } from '../timeframe/tz'\nimport { dateTimeFormat } from '../translations/intl'\nimport type { SeriesPoint } from './series'\n\nexport interface ChartBucket {\n\t/** The bucket's period start as an ISO string; identity for React lists. */\n\tat: string\n\tlabel: string\n\t/** Carries the day an hour tick leaves out; the tooltip reads it instead of `label`. */\n\ttooltipLabel?: string\n\t/** `null` when the bucket has no reading: a gap in the line, not a zero. */\n\tvalue: MetricValue\n\t/** An hour the day has not reached yet: it holds its place on the axis and nothing more. */\n\tupcoming?: boolean\n}\n\nexport type BucketUnit = 'hour' | 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, BucketUnit> = {\n\ttoday: 'hour',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst DEFAULT_LOCALE = 'en-US'\n\n/**\n * The unit a preset's chart buckets on. `hour` needs an hourly series: a daily one has a single\n * point there, so a source without hourly rows has no chart.\n */\nexport const unitForTimeframe = (timeframe: TimeframePreset): BucketUnit =>\n\tUNIT_BY_TIMEFRAME[timeframe]\n\n/**\n * The unit a window's series is read and charted at: a window of two days or less by hour,\n * short ranges by day, a quarter by week, longer by month.\n */\nexport const unitForRange = (range: DateRange): BucketUnit => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY_MS)\n\treturn spanDays <= 2 ? 'hour' : spanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n}\n\nexport interface BucketLabelOptions {\n\t/** The bucket the series was read at; the label only names it. */\n\tgranularity: Granularity\n\t/** Reporting timezone the buckets start in; defaults to UTC. */\n\ttz?: string\n\t/** The reader's locale, from `i18n.language` on either side; defaults to `en-US`. */\n\tlocale?: string\n\t/** Name each day by its weekday, as the fixed 7-day preset does. */\n\tweekday?: boolean\n\t/** A month always names its year; without it, only a series that spans two years does. */\n\tyear?: 'always' | 'auto'\n\t/**\n\t * The window's first instant. A bucket starting before it, the week from the Monday before\n\t * the range or the month from its first, is named by the day the range starts instead.\n\t */\n\tfrom?: Date\n}\n\nconst yearOf = (at: Date, locale: string, timeZone: string): string =>\n\tdateTimeFormat(locale, { year: 'numeric', timeZone }).format(at)\n\n/** One bucket's axis label, from its start in the reporting timezone (or `from`, if later). */\nexport const bucketLabel = (\n\tstart: Date,\n\t{\n\t\tgranularity,\n\t\ttz: timeZone = DEFAULT_TIMEZONE,\n\t\tlocale = DEFAULT_LOCALE,\n\t\tweekday,\n\t\tfrom,\n\t}: BucketLabelOptions,\n\twithYear = false\n): string => {\n\tconst at = from !== undefined && start.getTime() < from.getTime() ? from : start\n\tif (granularity === 'minute') {\n\t\treturn dateTimeFormat(locale, { hour: '2-digit', minute: '2-digit', timeZone }).format(at)\n\t}\n\tif (granularity === 'hour') {\n\t\treturn dateTimeFormat(locale, { hour: 'numeric', timeZone }).format(at)\n\t}\n\tif (granularity === 'day' && weekday === true) {\n\t\treturn dateTimeFormat(locale, { weekday: 'short', timeZone }).format(at)\n\t}\n\tif (granularity === 'month') {\n\t\treturn dateTimeFormat(locale, {\n\t\t\tmonth: 'short',\n\t\t\t...(withYear ? { year: 'numeric' } : {}),\n\t\t\ttimeZone,\n\t\t}).format(at)\n\t}\n\treturn dateTimeFormat(locale, { month: 'short', day: 'numeric', timeZone }).format(at)\n}\n\n/**\n * The day an hour tick leaves out, so a two-day window's tooltip still says which \"9 AM\" it is.\n * Every coarser bucket's tick already identifies itself, and reads undefined here.\n */\nexport const bucketTooltipLabel = (\n\tat: Date,\n\t{ granularity, tz = DEFAULT_TIMEZONE, locale = DEFAULT_LOCALE }: BucketLabelOptions\n): string | undefined =>\n\tgranularity === 'hour'\n\t\t? dateTimeFormat(locale, { weekday: 'short', hour: 'numeric', timeZone: tz }).format(at)\n\t\t: undefined\n\n/** Whether a month axis needs its years: always on request, else when the series crosses one. */\nconst monthsNeedYear = (dates: Date[], options: BucketLabelOptions): boolean => {\n\tif (options.granularity !== 'month') {\n\t\treturn false\n\t}\n\tif (options.year === 'always') {\n\t\treturn true\n\t}\n\tconst locale = options.locale ?? DEFAULT_LOCALE\n\tconst tz = options.tz ?? DEFAULT_TIMEZONE\n\treturn new Set(dates.map((at) => yearOf(at, locale, tz))).size > 1\n}\n\n/** A bucket's axis label and, for an hour, the tooltip label naming its day. */\nconst labelsOf = (\n\tstart: Date,\n\toptions: BucketLabelOptions,\n\twithYear = false\n): Pick<ChartBucket, 'label' | 'tooltipLabel'> => {\n\tconst tooltipLabel = bucketTooltipLabel(start, options)\n\treturn {\n\t\tlabel: bucketLabel(start, options, withYear),\n\t\t...(tooltipLabel === undefined ? {} : { tooltipLabel }),\n\t}\n}\n/** A day holds at most 25 hours, the one a clock falls back in. */\nconst MAX_DAY_HOURS = 25\n\n/**\n * The hours after `last` to the end of its day in the reporting timezone, marked upcoming, so a day\n * under way keeps its whole axis.\n */\nexport const upcomingHours = (last: Date, options: BucketLabelOptions): ChartBucket[] => {\n\tconst tz = options.tz ?? DEFAULT_TIMEZONE\n\tconst hourly: BucketLabelOptions = { ...options, granularity: 'hour' }\n\tconst dayEnd = addDaysInTz(last, 1, tz).getTime()\n\tconst hours: ChartBucket[] = []\n\tlet at = startOfHourInTz(new Date(last.getTime() + HOUR_MS), tz)\n\twhile (at.getTime() < dayEnd && hours.length < MAX_DAY_HOURS) {\n\t\thours.push({ at: at.toISOString(), ...labelsOf(at, hourly), value: null, upcoming: true })\n\t\tat = startOfHourInTz(new Date(at.getTime() + HOUR_MS), tz)\n\t}\n\treturn hours\n}\n\n/**\n * Labels a series the engine already bucketed and summed, one chart bucket per point named by its\n * start in the reporting timezone; an hourly series runs on to its day's end via {@link upcomingHours}.\n */\nexport const labelSeries = (points: SeriesPoint[], options: BucketLabelOptions): ChartBucket[] => {\n\tconst dates = points.map((point) => new Date(point.date))\n\tconst withYear = monthsNeedYear(dates, options)\n\tconst labeled = points.map(\n\t\t(point, i): ChartBucket => ({\n\t\t\tat: point.date,\n\t\t\t...labelsOf(dates[i] ?? new Date(point.date), options, withYear),\n\t\t\tvalue: point.value,\n\t\t})\n\t)\n\tconst last = dates.at(-1)\n\treturn options.granularity === 'hour' && last !== undefined\n\t\t? [...labeled, ...upcomingHours(last, options)]\n\t\t: labeled\n}\n"],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import { tooltipLabelOf } from "./trendGeometry.js";
2
+ //#region src/charts/inProgress.ts
3
+ /**
4
+ * Marks the bucket `now` falls in as still counting ("so far") while the window reaches `now`. The
5
+ * readings stay as they are, so every total still adds up.
6
+ */
7
+ const markInProgress = (points, { now, end, soFar }) => {
8
+ if (now.getTime() > end.getTime()) return points;
9
+ const counting = points.findLastIndex((point) => {
10
+ const start = Date.parse(point.at);
11
+ return !Number.isNaN(start) && start <= now.getTime();
12
+ });
13
+ return points.map((point, i) => i === counting ? {
14
+ ...point,
15
+ inProgress: true,
16
+ tooltipLabel: soFar(tooltipLabelOf(point))
17
+ } : point);
18
+ };
19
+ //#endregion
20
+ export { markInProgress };
21
+
22
+ //# sourceMappingURL=inProgress.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inProgress.js","names":[],"sources":["../../src/charts/inProgress.ts"],"sourcesContent":["import type { TrendPoint } from './TrendChart'\nimport { tooltipLabelOf } from './trendGeometry'\n\nexport interface InProgressArgs {\n\tnow: Date\n\t/** The end of the window the series was read for. */\n\tend: Date\n\t/** The bucket's label as its tooltip and data table read it while it is still counting. */\n\tsoFar: (period: string) => string\n}\n\n/**\n * Marks the bucket `now` falls in as still counting (\"so far\") while the window reaches `now`. The\n * readings stay as they are, so every total still adds up.\n */\nexport const markInProgress = (\n\tpoints: TrendPoint[],\n\t{ now, end, soFar }: InProgressArgs\n): TrendPoint[] => {\n\tif (now.getTime() > end.getTime()) {\n\t\treturn points\n\t}\n\tconst counting = points.findLastIndex((point) => {\n\t\tconst start = Date.parse(point.at)\n\t\treturn !Number.isNaN(start) && start <= now.getTime()\n\t})\n\treturn points.map((point, i) =>\n\t\ti === counting\n\t\t\t? { ...point, inProgress: true, tooltipLabel: soFar(tooltipLabelOf(point)) }\n\t\t\t: point\n\t)\n}\n"],"mappings":";;;;;;AAeA,MAAa,kBACZ,QACA,EAAE,KAAK,KAAK,YACM;CAClB,IAAI,IAAI,QAAQ,IAAI,IAAI,QAAQ,GAC/B,OAAO;CAER,MAAM,WAAW,OAAO,eAAe,UAAU;EAChD,MAAM,QAAQ,KAAK,MAAM,MAAM,EAAE;EACjC,OAAO,CAAC,OAAO,MAAM,KAAK,KAAK,SAAS,IAAI,QAAQ;CACrD,CAAC;CACD,OAAO,OAAO,KAAK,OAAO,MACzB,MAAM,WACH;EAAE,GAAG;EAAO,YAAY;EAAM,cAAc,MAAM,eAAe,KAAK,CAAC;CAAE,IACzE,KACJ;AACD"}
@@ -0,0 +1,15 @@
1
+ import { MetricValue } from "../core/contract.js";
2
+ //#region src/charts/series.d.ts
3
+ interface SeriesPoint {
4
+ date: string;
5
+ /** `null` for an average with nothing to average over in this bucket: a gap, not a zero. */
6
+ value: MetricValue;
7
+ }
8
+ /**
9
+ * The buckets a trend series is read at. Weeks and months come folded and weighted from the engine;
10
+ * the browser only labels them.
11
+ */
12
+ type SeriesGranularity = 'hour' | 'day' | 'week' | 'month';
13
+ //#endregion
14
+ export { SeriesGranularity, SeriesPoint };
15
+ //# sourceMappingURL=series.d.ts.map
@@ -0,0 +1,123 @@
1
+ import { supportsGranularity } from "../core/granularity.js";
2
+ import { HOUR_MS, addDaysInTz, startOfDayInTz, startOfHourInTz } from "../timeframe/tz.js";
3
+ import { combineMetricValues, emptyReading } from "../core/metricValues.js";
4
+ import { addCalendarDays, calendarDayOf, calendarDayStart } from "../timeframe/calendar.js";
5
+ import { bucketStartOf, bucketStarts } from "../native/engine/buckets.js";
6
+ import { dayOfTimestamp } from "../surfacing/rebucket.js";
7
+ import { unitForRange } from "./bucket.js";
8
+ //#region src/charts/series.ts
9
+ const MAX_SERIES_DAYS = 366;
10
+ const MAX_SERIES_HOURS = 60;
11
+ /**
12
+ * Every row's reading of `metric`, grouped by the bucket `keyOf` assigns it (none, for a timestamp
13
+ * it cannot read) and folded by the metric's own rule: counts add up, averages are averaged.
14
+ */
15
+ const readingsBy = (rows, metric, keyOf) => {
16
+ const grouped = /* @__PURE__ */ new Map();
17
+ for (const row of rows) {
18
+ const key = row.timestamp ? keyOf(row.timestamp) : null;
19
+ if (key === null) continue;
20
+ const reading = row.metrics[metric] ?? emptyReading(metric);
21
+ const readings = grouped.get(key);
22
+ if (readings) readings.push(reading);
23
+ else grouped.set(key, [reading]);
24
+ }
25
+ return new Map([...grouped].map(([key, readings]) => [key, combineMetricValues(metric, readings)]));
26
+ };
27
+ /** `last` and each `back` step from it not before `first`, at most `most` of them, oldest first. */
28
+ const instantsBack = ({ last, first, most, back }) => {
29
+ const instants = [];
30
+ for (let at = last; instants.length < most && at.getTime() >= first.getTime(); at = back(at)) instants.push(at.toISOString());
31
+ return instants.reverse();
32
+ };
33
+ /** Each bucket of `axis` with its reading, an empty one reading zero (or a gap, for an average). */
34
+ const pointsOn = (axis, readings, metric) => axis.map((date) => ({
35
+ date,
36
+ value: readings.get(date) ?? emptyReading(metric)
37
+ }));
38
+ /**
39
+ * Rows on a gapless daily axis in `tz`, a gap reading zero for a count and `null` for an average.
40
+ * Only the latest `MAX_SERIES_DAYS` are drawn; the headline total still covers the whole range.
41
+ */
42
+ const fillDailySeries = (args) => {
43
+ const { rows, dateRange, metric } = args;
44
+ const tz = args.tz ?? "UTC";
45
+ const byDay = readingsBy(rows, metric, (timestamp) => {
46
+ const day = dayOfTimestamp(timestamp, tz);
47
+ return day === null ? null : calendarDayStart(day, tz).toISOString();
48
+ });
49
+ return pointsOn(instantsBack({
50
+ last: startOfDayInTz(dateRange.end, tz),
51
+ first: startOfDayInTz(dateRange.start, tz),
52
+ most: args.uncapped === true ? Number.POSITIVE_INFINITY : MAX_SERIES_DAYS,
53
+ back: (day) => addDaysInTz(day, -1, tz)
54
+ }), byDay, metric);
55
+ };
56
+ /**
57
+ * Rows on a gapless hourly axis floored in `tz`, re-floored every step so a half-hour zone or a DST
58
+ * change inside the window never leaves the axis off the hour.
59
+ */
60
+ const fillHourlySeries = (args) => {
61
+ const { rows, dateRange, metric } = args;
62
+ const tz = args.tz ?? "UTC";
63
+ const byHour = readingsBy(rows, metric, (timestamp) => startOfHourInTz(new Date(timestamp), tz).toISOString());
64
+ return pointsOn(instantsBack({
65
+ last: startOfHourInTz(dateRange.end, tz),
66
+ first: startOfHourInTz(dateRange.start, tz),
67
+ most: args.uncapped === true ? Number.POSITIVE_INFINITY : MAX_SERIES_HOURS,
68
+ back: (hour) => startOfHourInTz(new Date(hour.getTime() - HOUR_MS), tz)
69
+ }), byHour, metric);
70
+ };
71
+ /**
72
+ * Rows on a gapless axis of weeks (from Monday) or months in `tz`, each filed under the bucket its
73
+ * date falls in, over the same latest `MAX_SERIES_DAYS` as the daily axis.
74
+ */
75
+ const fillCalendarSeries = (args) => {
76
+ const { rows, dateRange, metric, unit } = args;
77
+ const tz = args.tz ?? "UTC";
78
+ const lastDay = calendarDayOf(dateRange.end, tz);
79
+ const requested = calendarDayOf(dateRange.start, tz);
80
+ const capped = addCalendarDays(lastDay, -365);
81
+ const firstDay = requested > capped || args.uncapped === true ? requested : capped;
82
+ const byBucket = readingsBy(rows, metric, (timestamp) => {
83
+ const day = dayOfTimestamp(timestamp, tz);
84
+ return day === null ? null : calendarDayStart(bucketStartOf(day, unit), tz).toISOString();
85
+ });
86
+ return pointsOn(bucketStarts(firstDay, lastDay, unit).map((start) => calendarDayStart(start, tz).toISOString()), byBucket, metric);
87
+ };
88
+ /**
89
+ * The bucket a widget's or field's series is read at: hours up to two days, days to a month, weeks
90
+ * to four months, then months. A source without hourly rows falls back to a day.
91
+ */
92
+ const seriesGranularityFor = (dateRange, caps) => {
93
+ const unit = unitForRange(dateRange);
94
+ if (unit === "hour") return supportsGranularity(caps, "hour") ? "hour" : "day";
95
+ return unit;
96
+ };
97
+ /** Whether a bucket is one {@link fillSeries} draws a gapless axis of. */
98
+ const isSeriesGranularity = (granularity) => granularity === "hour" || granularity === "day" || granularity === "week" || granularity === "month";
99
+ /**
100
+ * Fill a series onto the contiguous axis its granularity implies: every bucket of the range in
101
+ * `tz`, an empty one reading zero (or a gap, for an average), and nothing outside the range.
102
+ */
103
+ const fillSeries = (args) => {
104
+ const { granularity } = args;
105
+ if (granularity === "hour") return fillHourlySeries(args);
106
+ if (granularity === "day") return fillDailySeries(args);
107
+ return fillCalendarSeries({
108
+ ...args,
109
+ unit: granularity
110
+ });
111
+ };
112
+ /**
113
+ * Lays a comparison series over the primary axis bucket by bucket, truncated or filled to its length;
114
+ * a filled bucket borrows the axis date so every point carries a real one.
115
+ */
116
+ const alignSeries = (points, axis, metric) => points.length === axis.length ? points : axis.map((day, i) => points[i] ?? {
117
+ date: day.date,
118
+ value: emptyReading(metric)
119
+ });
120
+ //#endregion
121
+ export { alignSeries, fillSeries, isSeriesGranularity, seriesGranularityFor };
122
+
123
+ //# sourceMappingURL=series.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"series.js","names":[],"sources":["../../src/charts/series.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tAnalyticsRow,\n\tDateRange,\n\tMetricKey,\n\tMetricValue,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { combineMetricValues, emptyReading } from '../core/metricValues'\nimport { bucketStartOf, bucketStarts, type CalendarUnit } from '../native/engine/buckets'\nimport { dayOfTimestamp } from '../surfacing/rebucket'\nimport { addCalendarDays, calendarDayOf, calendarDayStart } from '../timeframe/calendar'\nimport {\n\taddDaysInTz,\n\tDEFAULT_TIMEZONE,\n\tHOUR_MS,\n\tstartOfDayInTz,\n\tstartOfHourInTz,\n} from '../timeframe/tz'\nimport { unitForRange } from './bucket'\n\nexport interface SeriesPoint {\n\tdate: string\n\t/** `null` for an average with nothing to average over in this bucket: a gap, not a zero. */\n\tvalue: MetricValue\n}\n\n/**\n * The buckets a trend series is read at. Weeks and months come folded and weighted from the engine;\n * the browser only labels them.\n */\nexport type SeriesGranularity = 'hour' | 'day' | 'week' | 'month'\n\nconst MAX_SERIES_DAYS = 366\nconst MAX_SERIES_HOURS = 60\n\n/** A series to fill: rows read over `dateRange`, bucketed in `tz` (UTC when left out). */\nexport interface FillSeriesArgs {\n\trows: AnalyticsRow[]\n\tdateRange: DateRange\n\tmetric: MetricKey\n\ttz?: string\n\t/**\n\t * Every bucket of the range, past the widgets' caps (60 hours, 366 days), for the analytics view,\n\t * whose reader picks the bucket.\n\t */\n\tuncapped?: boolean\n}\n\n/**\n * Every row's reading of `metric`, grouped by the bucket `keyOf` assigns it (none, for a timestamp\n * it cannot read) and folded by the metric's own rule: counts add up, averages are averaged.\n */\nconst readingsBy = (\n\trows: AnalyticsRow[],\n\tmetric: MetricKey,\n\tkeyOf: (timestamp: string) => string | null\n): Map<string, MetricValue> => {\n\tconst grouped = new Map<string, MetricValue[]>()\n\tfor (const row of rows) {\n\t\tconst key = row.timestamp ? keyOf(row.timestamp) : null\n\t\tif (key === null) {\n\t\t\tcontinue\n\t\t}\n\t\tconst reading = row.metrics[metric] ?? emptyReading(metric)\n\t\tconst readings = grouped.get(key)\n\t\tif (readings) {\n\t\t\treadings.push(reading)\n\t\t} else {\n\t\t\tgrouped.set(key, [reading])\n\t\t}\n\t}\n\treturn new Map(\n\t\t[...grouped].map(([key, readings]) => [key, combineMetricValues(metric, readings)])\n\t)\n}\n\n/** `last` and each `back` step from it not before `first`, at most `most` of them, oldest first. */\nconst instantsBack = ({\n\tlast,\n\tfirst,\n\tmost,\n\tback,\n}: {\n\tlast: Date\n\tfirst: Date\n\tmost: number\n\tback: (at: Date) => Date\n}): string[] => {\n\tconst instants: string[] = []\n\tfor (let at = last; instants.length < most && at.getTime() >= first.getTime(); at = back(at)) {\n\t\tinstants.push(at.toISOString())\n\t}\n\treturn instants.reverse()\n}\n\n/** Each bucket of `axis` with its reading, an empty one reading zero (or a gap, for an average). */\nconst pointsOn = (\n\taxis: string[],\n\treadings: Map<string, MetricValue>,\n\tmetric: MetricKey\n): SeriesPoint[] =>\n\taxis.map((date) => ({ date, value: readings.get(date) ?? emptyReading(metric) }))\n\n/**\n * Rows on a gapless daily axis in `tz`, a gap reading zero for a count and `null` for an average.\n * Only the latest `MAX_SERIES_DAYS` are drawn; the headline total still covers the whole range.\n */\nexport const fillDailySeries = (args: FillSeriesArgs): SeriesPoint[] => {\n\tconst { rows, dateRange, metric } = args\n\tconst tz = args.tz ?? DEFAULT_TIMEZONE\n\tconst byDay = readingsBy(rows, metric, (timestamp) => {\n\t\tconst day = dayOfTimestamp(timestamp, tz)\n\t\treturn day === null ? null : calendarDayStart(day, tz).toISOString()\n\t})\n\t// Stepped back by calendar day, so a day a DST change lengthens or shortens never mis-steps.\n\tconst days = instantsBack({\n\t\tlast: startOfDayInTz(dateRange.end, tz),\n\t\tfirst: startOfDayInTz(dateRange.start, tz),\n\t\tmost: args.uncapped === true ? Number.POSITIVE_INFINITY : MAX_SERIES_DAYS,\n\t\tback: (day) => addDaysInTz(day, -1, tz),\n\t})\n\treturn pointsOn(days, byDay, metric)\n}\n\n/**\n * Rows on a gapless hourly axis floored in `tz`, re-floored every step so a half-hour zone or a DST\n * change inside the window never leaves the axis off the hour.\n */\nexport const fillHourlySeries = (args: FillSeriesArgs): SeriesPoint[] => {\n\tconst { rows, dateRange, metric } = args\n\tconst tz = args.tz ?? DEFAULT_TIMEZONE\n\tconst byHour = readingsBy(rows, metric, (timestamp) =>\n\t\tstartOfHourInTz(new Date(timestamp), tz).toISOString()\n\t)\n\tconst hours = instantsBack({\n\t\tlast: startOfHourInTz(dateRange.end, tz),\n\t\tfirst: startOfHourInTz(dateRange.start, tz),\n\t\tmost: args.uncapped === true ? Number.POSITIVE_INFINITY : MAX_SERIES_HOURS,\n\t\tback: (hour) => startOfHourInTz(new Date(hour.getTime() - HOUR_MS), tz),\n\t})\n\treturn pointsOn(hours, byHour, metric)\n}\n\n/**\n * Rows on a gapless axis of weeks (from Monday) or months in `tz`, each filed under the bucket its\n * date falls in, over the same latest `MAX_SERIES_DAYS` as the daily axis.\n */\nexport const fillCalendarSeries = (\n\targs: FillSeriesArgs & { unit: CalendarUnit }\n): SeriesPoint[] => {\n\tconst { rows, dateRange, metric, unit } = args\n\tconst tz = args.tz ?? DEFAULT_TIMEZONE\n\tconst lastDay = calendarDayOf(dateRange.end, tz)\n\tconst requested = calendarDayOf(dateRange.start, tz)\n\tconst capped = addCalendarDays(lastDay, -(MAX_SERIES_DAYS - 1))\n\tconst firstDay = requested > capped || args.uncapped === true ? requested : capped\n\tconst byBucket = readingsBy(rows, metric, (timestamp) => {\n\t\tconst day = dayOfTimestamp(timestamp, tz)\n\t\treturn day === null ? null : calendarDayStart(bucketStartOf(day, unit), tz).toISOString()\n\t})\n\tconst buckets = bucketStarts(firstDay, lastDay, unit).map((start) =>\n\t\tcalendarDayStart(start, tz).toISOString()\n\t)\n\treturn pointsOn(buckets, byBucket, metric)\n}\n\n/**\n * The bucket a widget's or field's series is read at: hours up to two days, days to a month, weeks\n * to four months, then months. A source without hourly rows falls back to a day.\n */\nexport const seriesGranularityFor = (\n\tdateRange: DateRange,\n\tcaps: AnalyticsCapabilities\n): SeriesGranularity => {\n\tconst unit = unitForRange(dateRange)\n\tif (unit === 'hour') {\n\t\treturn supportsGranularity(caps, 'hour') ? 'hour' : 'day'\n\t}\n\treturn unit\n}\n\n/** Whether a bucket is one {@link fillSeries} draws a gapless axis of. */\nexport const isSeriesGranularity = (granularity: string): granularity is SeriesGranularity =>\n\tgranularity === 'hour' ||\n\tgranularity === 'day' ||\n\tgranularity === 'week' ||\n\tgranularity === 'month'\n\n/**\n * Fill a series onto the contiguous axis its granularity implies: every bucket of the range in\n * `tz`, an empty one reading zero (or a gap, for an average), and nothing outside the range.\n */\nexport const fillSeries = (\n\targs: FillSeriesArgs & { granularity: SeriesGranularity }\n): SeriesPoint[] => {\n\tconst { granularity } = args\n\tif (granularity === 'hour') {\n\t\treturn fillHourlySeries(args)\n\t}\n\tif (granularity === 'day') {\n\t\treturn fillDailySeries(args)\n\t}\n\treturn fillCalendarSeries({ ...args, unit: granularity })\n}\n\n/**\n * Lays a comparison series over the primary axis bucket by bucket, truncated or filled to its length;\n * a filled bucket borrows the axis date so every point carries a real one.\n */\nexport const alignSeries = (\n\tpoints: SeriesPoint[],\n\taxis: SeriesPoint[],\n\tmetric: MetricKey\n): SeriesPoint[] =>\n\tpoints.length === axis.length\n\t\t? points\n\t\t: axis.map((day, i) => points[i] ?? { date: day.date, value: emptyReading(metric) })\n"],"mappings":"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"}