@10x-media/analytics 1.0.0-beta.8 → 4.0.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,7 +1,10 @@
1
1
  import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
2
+ import { isRecord, wholeNumberParam } from "../core/values.js";
3
+ import { GRANULARITY_ORDER } from "../core/granularity.js";
2
4
  import { zonedCalendarDay } from "../timeframe/tz.js";
3
5
  import { TIMEFRAME_PRESETS, resolveTimeframe } from "../timeframe/presets.js";
4
- import { GRANULARITY_ORDER } from "../core/granularity.js";
6
+ import { servedName } from "../core/metricAliases.js";
7
+ import { dayRangeDays } from "./dayRange.js";
5
8
  import { BREAKDOWN_TABS, VIEW_METRIC_ORDER } from "./gating.js";
6
9
  //#region src/view/state.ts
7
10
  /**
@@ -16,6 +19,7 @@ const VIEW_RANGE_PRESETS = [
16
19
  "lastYear"
17
20
  ];
18
21
  const DEFAULT_VIEW_RANGE = "last30days";
22
+ /** @beta */
19
23
  const VIEW_LIMITS = [
20
24
  10,
21
25
  25,
@@ -23,27 +27,37 @@ const VIEW_LIMITS = [
23
27
  100
24
28
  ];
25
29
  const DEFAULT_VIEW_TAB = "pages";
26
- const KNOWN_METRICS = new Set(VIEW_METRIC_ORDER);
27
- const KNOWN_DIMENSIONS = new Set(DIMENSION_KEYS);
28
- const KNOWN_OPERATORS = new Set(FILTER_OPERATORS);
29
- const KNOWN_GRANULARITIES = new Set(GRANULARITY_ORDER);
30
- const KNOWN_PRESETS = new Set(TIMEFRAME_PRESETS);
31
- const DAY_MS = 864e5;
30
+ const AGGREGATE_TAG = `*:`;
31
+ /**
32
+ * Aggregate marker tagged with the tenant it was chosen from: the host's selector can move while
33
+ * the address stays open, and an untagged marker would aggregate under a tenant nobody asked for.
34
+ */
35
+ const aggregateToken = (from) => from === "" ? "*" : `${AGGREGATE_TAG}${from}`;
36
+ /** Whether `value` asks to aggregate: the bare wildcard or an {@link aggregateToken}. */
37
+ const isAggregateToken = (value) => value === "*" || typeof value === "string" && value.startsWith(AGGREGATE_TAG);
38
+ /** The tenant an aggregate token was chosen from; `''` when it names none. */
39
+ const aggregateFrom = (token) => token.startsWith(AGGREGATE_TAG) ? token.slice(AGGREGATE_TAG.length) : "";
40
+ /** A filter's identity, which its chip keys on. */
41
+ const filterKey = ({ dimension, operator, value }) => `${dimension}:${operator}:${value}`;
42
+ /** `state` with its filter at `index` removed. */
43
+ const withoutFilter = (state, index) => ({
44
+ ...state,
45
+ filters: state.filters.filter((_, at) => at !== index)
46
+ });
47
+ const known = (list, value) => list.find((entry) => entry === value);
32
48
  const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
33
- const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
34
49
  const read = (search, name) => {
35
50
  const raw = search.get(name)?.trim();
36
51
  return raw ? raw : null;
37
52
  };
38
53
  /**
39
- * Epoch ms of a `YYYY-MM-DD` day, or null when it names no real calendar day. The
40
- * round trip is the validation: `Date.parse` rolls February 30 forward instead of failing.
54
+ * Whether `raw` is a `YYYY-MM-DD` day naming a real calendar day. The round trip is the
55
+ * validation: `Date.parse` rolls February 30 forward instead of failing.
41
56
  */
42
- const dayValue = (raw) => {
43
- if (raw === null || !DAY_PATTERN.test(raw)) return null;
57
+ const isCalendarDay = (raw) => {
58
+ if (raw === null || !DAY_PATTERN.test(raw)) return false;
44
59
  const ms = Date.parse(`${raw}T00:00:00.000Z`);
45
- if (Number.isNaN(ms) || new Date(ms).toISOString().slice(0, 10) !== raw) return null;
46
- return ms;
60
+ return !Number.isNaN(ms) && new Date(ms).toISOString().slice(0, 10) === raw;
47
61
  };
48
62
  /** A configured default the view cannot serve falls back to the built-in range. */
49
63
  const defaultRange = (defaults) => defaults.range === "allTime" ? DEFAULT_VIEW_RANGE : defaults.range;
@@ -52,23 +66,26 @@ const parseRange = (search, defaults) => {
52
66
  const raw = read(search, "range");
53
67
  if (raw === null) return fallback;
54
68
  if (raw === "custom") {
55
- const from = dayValue(read(search, "from"));
56
- const to = dayValue(read(search, "to"));
57
- if (from === null || to === null || to < from) return fallback;
58
- if (Math.round((to - from) / DAY_MS) + 1 > 366) return fallback;
69
+ const from = read(search, "from");
70
+ const to = read(search, "to");
71
+ if (!isCalendarDay(from) || !isCalendarDay(to) || to < from) return fallback;
72
+ if (dayRangeDays({
73
+ from,
74
+ to
75
+ }) > 366) return fallback;
59
76
  return {
60
77
  range: "custom",
61
- from: new Date(from).toISOString().slice(0, 10),
62
- to: new Date(to).toISOString().slice(0, 10)
78
+ from,
79
+ to
63
80
  };
64
81
  }
65
- if (!KNOWN_PRESETS.has(raw) || raw === "allTime") return fallback;
66
- return { range: raw };
82
+ const preset = known(TIMEFRAME_PRESETS, raw);
83
+ if (preset === void 0 || preset === "allTime") return fallback;
84
+ return { range: preset };
67
85
  };
68
86
  /**
69
- * Filters as the endpoint's own parser would accept them, minus its errors: an entry
70
- * naming a dimension, operator or value outside the contract is dropped rather than
71
- * failing the whole URL, since a hand-edited link should still open a working view.
87
+ * Filters as the endpoint parser accepts them; invalid entries drop so a hand-edited link still
88
+ * opens. Repeats drop too: chips key on {@link filterKey}, so duplicates would collide in React.
72
89
  */
73
90
  const parseFilters = (search) => {
74
91
  const raw = read(search, "filters");
@@ -81,20 +98,26 @@ const parseFilters = (search) => {
81
98
  }
82
99
  if (!Array.isArray(decoded)) return [];
83
100
  const filters = [];
101
+ const seen = /* @__PURE__ */ new Set();
84
102
  for (const item of decoded) {
85
103
  if (filters.length === 10) break;
86
- if (!isRecord(item)) continue;
87
- const { dimension, operator, value } = item;
88
- if (typeof dimension !== "string" || !KNOWN_DIMENSIONS.has(dimension)) continue;
89
- if (typeof operator !== "string" || !KNOWN_OPERATORS.has(operator)) continue;
104
+ if (!isRecord(item) || Array.isArray(item)) continue;
105
+ const dimension = known(DIMENSION_KEYS, item.dimension);
106
+ const operator = known(FILTER_OPERATORS, item.operator);
107
+ const { value } = item;
108
+ if (dimension === void 0 || operator === void 0) continue;
90
109
  if (typeof value !== "string") continue;
91
110
  const trimmed = value.trim();
92
111
  if (trimmed.length < 1 || trimmed.length > 256) continue;
93
- filters.push({
112
+ const filter = {
94
113
  dimension,
95
114
  operator,
96
115
  value: trimmed
97
- });
116
+ };
117
+ const key = filterKey(filter);
118
+ if (seen.has(key)) continue;
119
+ seen.add(key);
120
+ filters.push(filter);
98
121
  }
99
122
  return filters;
100
123
  };
@@ -102,9 +125,9 @@ const parseOrder = (search) => {
102
125
  const raw = read(search, "order");
103
126
  if (raw === null) return;
104
127
  const parts = raw.split(":");
105
- const metric = parts[0] ?? "";
128
+ const metric = known(VIEW_METRIC_ORDER, parts[0]);
106
129
  const direction = parts[1] ?? "";
107
- if (parts.length !== 2 || !KNOWN_METRICS.has(metric)) return;
130
+ if (parts.length !== 2 || metric === void 0) return;
108
131
  if (direction !== "asc" && direction !== "desc") return;
109
132
  return {
110
133
  metric,
@@ -116,22 +139,26 @@ const parseOrder = (search) => {
116
139
  * default, so a truncated, stale or hand-edited link always opens a working view.
117
140
  */
118
141
  const parseViewState = (search, defaults) => {
119
- const metric = read(search, "metric");
120
- const granularity = read(search, "granularity");
121
- const tab = read(search, "tab");
142
+ const metric = known(VIEW_METRIC_ORDER, read(search, "metric"));
143
+ const granularity = known(GRANULARITY_ORDER, read(search, "granularity"));
144
+ const tab = known(BREAKDOWN_TABS, read(search, "tab"));
145
+ const dim = known(DIMENSION_KEYS, read(search, "dim"));
122
146
  const source = read(search, "source");
123
- const limit = Number(read(search, "limit"));
147
+ const scope = read(search, "scope");
148
+ const limit = wholeNumberParam(read(search, "limit"));
124
149
  const compare = read(search, "compare");
125
150
  const order = parseOrder(search);
126
151
  return {
127
152
  ...parseRange(search, defaults),
128
153
  compare: compare === "1" || compare === "true",
129
154
  ...source === null ? {} : { source },
130
- metric: metric !== null && KNOWN_METRICS.has(metric) ? metric : defaults.metric,
131
- ...granularity !== null && KNOWN_GRANULARITIES.has(granularity) ? { granularity } : {},
132
- tab: tab !== null && BREAKDOWN_TABS.includes(tab) ? tab : DEFAULT_VIEW_TAB,
155
+ ...scope !== null && isAggregateToken(scope) ? { scope } : {},
156
+ metric: metric ?? defaults.metric,
157
+ ...granularity === void 0 ? {} : { granularity },
158
+ tab: tab ?? "pages",
159
+ ...dim === void 0 ? {} : { dim },
133
160
  filters: parseFilters(search),
134
- limit: VIEW_LIMITS.includes(limit) ? limit : 10,
161
+ limit: VIEW_LIMITS.find((each) => each === limit) ?? 10,
135
162
  ...order === void 0 ? {} : { order }
136
163
  };
137
164
  };
@@ -148,46 +175,63 @@ const serializeViewState = (state, defaults) => {
148
175
  }
149
176
  if (state.compare) params.set("compare", "1");
150
177
  if (state.source !== void 0) params.set("source", state.source);
178
+ if (state.scope !== void 0) params.set("scope", state.scope);
151
179
  if (state.metric !== defaults.metric) params.set("metric", state.metric);
152
180
  if (state.granularity !== void 0) params.set("granularity", state.granularity);
153
181
  if (state.tab !== "pages") params.set("tab", state.tab);
182
+ if (state.dim !== void 0) params.set("dim", state.dim);
154
183
  if (state.filters.length > 0) params.set("filters", JSON.stringify(state.filters));
155
184
  if (state.limit !== 10) params.set("limit", String(state.limit));
156
185
  if (state.order !== void 0) params.set("order", `${state.order.metric}:${state.order.direction}`);
157
186
  return params;
158
187
  };
159
188
  /**
160
- * The nearest state the selected source can actually serve. The URL outlives a source
161
- * switch, so a metric, tab, filter, comparison, bucket or sort the new source lacks is
162
- * replaced or dropped here rather than sent to the endpoint to be rejected. Returns the
163
- * same object when the gate forbids nothing, so a render can compare by identity.
189
+ * Nearest state the selected source serves: the URL outlives a source switch, so what it lacks is
190
+ * replaced or dropped here. Same object when the gate forbids nothing, for identity checks.
164
191
  */
165
192
  const coerceState = (state, gate) => {
166
- const metric = gate.metrics.includes(state.metric) ? state.metric : gate.metrics[0] ?? state.metric;
193
+ const named = servedName(state.metric, gate.metrics);
194
+ const metric = gate.metrics.includes(named) ? named : gate.metrics[0] ?? state.metric;
167
195
  const tab = gate.tabs.includes(state.tab) ? state.tab : gate.tabs[0] ?? state.tab;
196
+ const dim = state.dim !== void 0 && gate.dimensionsFor(tab).includes(state.dim) ? state.dim : void 0;
168
197
  const compare = state.compare && gate.canCompare;
169
- const filters = state.filters.filter((filter) => gate.canFilter(filter.dimension) && gate.operators.includes(filter.operator));
198
+ const filters = state.filters.filter((filter) => gate.operatorsFor(filter.dimension).includes(filter.operator));
170
199
  const granularity = state.granularity !== void 0 && gate.granularities.includes(state.granularity) ? state.granularity : void 0;
171
- const order = state.order !== void 0 && gate.metrics.includes(state.order.metric) ? state.order : void 0;
172
- if (metric === state.metric && tab === state.tab && compare === state.compare && filters.length === state.filters.length && granularity === state.granularity && order === state.order) return state;
200
+ const order = state.order !== void 0 && gate.columns.includes(state.order.metric) ? state.order : void 0;
201
+ if (metric === state.metric && tab === state.tab && dim === state.dim && compare === state.compare && filters.length === state.filters.length && granularity === state.granularity && order === state.order) return state;
173
202
  return {
174
203
  range: state.range,
175
204
  ...state.from === void 0 ? {} : { from: state.from },
176
205
  ...state.to === void 0 ? {} : { to: state.to },
177
206
  compare,
178
207
  ...state.source === void 0 ? {} : { source: state.source },
208
+ ...state.scope === void 0 ? {} : { scope: state.scope },
179
209
  metric,
180
210
  ...granularity === void 0 ? {} : { granularity },
181
211
  tab,
212
+ ...dim === void 0 ? {} : { dim },
182
213
  filters,
183
214
  limit: state.limit,
184
215
  ...order === void 0 ? {} : { order }
185
216
  };
186
217
  };
187
218
  /**
188
- * The inclusive day window a state reads, in the reporting timezone. The endpoint reads
189
- * `from`/`to` in that same timezone, so the toolbar caption and every request share one
190
- * answer. `now` is injected to keep callers deterministic.
219
+ * State as the server read it: an unserved `source` drops and `scope` becomes the resolved one.
220
+ * Same object when nothing needed correcting, so the URL is rewritten only on a change.
221
+ */
222
+ const normalizeViewState = (state, served) => {
223
+ const source = state.source !== void 0 && !served.sourceIds.includes(state.source) ? void 0 : state.source;
224
+ if (source === state.source && served.scope === state.scope) return state;
225
+ const { source: _source, scope: _scope, ...rest } = state;
226
+ return {
227
+ ...rest,
228
+ ...source === void 0 ? {} : { source },
229
+ ...served.scope === void 0 ? {} : { scope: served.scope }
230
+ };
231
+ };
232
+ /**
233
+ * Inclusive day window a state reads, in the reporting timezone the endpoint reads `from`/`to`
234
+ * in, so toolbar caption and every request agree.
191
235
  */
192
236
  const rangeFor = (state, timezone, now) => {
193
237
  if (state.range === "custom" && state.from !== void 0 && state.to !== void 0) return {
@@ -201,6 +245,6 @@ const rangeFor = (state, timezone, now) => {
201
245
  };
202
246
  };
203
247
  //#endregion
204
- export { DEFAULT_VIEW_RANGE, DEFAULT_VIEW_TAB, VIEW_LIMITS, VIEW_RANGE_PRESETS, coerceState, parseViewState, rangeFor, serializeViewState };
248
+ export { DEFAULT_VIEW_RANGE, DEFAULT_VIEW_TAB, VIEW_LIMITS, VIEW_RANGE_PRESETS, aggregateFrom, aggregateToken, coerceState, filterKey, isAggregateToken, normalizeViewState, parseViewState, rangeFor, serializeViewState, withoutFilter };
205
249
 
206
250
  //# sourceMappingURL=state.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"state.js","names":[],"sources":["../../src/view/state.ts"],"sourcesContent":["import {\n\ttype AnalyticsFilter,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype Granularity,\n\ttype MetricKey,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport {\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_RANGE_DAYS,\n} from '../query/limits'\nimport { resolveTimeframe, TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport {\n\tBREAKDOWN_TABS,\n\ttype BreakdownTab,\n\ttype DayRange,\n\tVIEW_METRIC_ORDER,\n\ttype ViewGate,\n} from './gating'\n\n/**\n * The presets the toolbar offers. `allTime` is deliberately absent: it is unbounded, and\n * the query endpoint refuses any window longer than a year.\n */\nexport const VIEW_RANGE_PRESETS: TimeframePreset[] = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'lastYear',\n]\n\nexport const DEFAULT_VIEW_RANGE: TimeframePreset = 'last30days'\n\nexport const VIEW_LIMITS = [10, 25, 50, 100] as const\n\nexport type ViewLimit = (typeof VIEW_LIMITS)[number]\n\nexport const DEFAULT_VIEW_LIMIT: ViewLimit = 10\n\nexport const DEFAULT_VIEW_TAB: BreakdownTab = 'pages'\n\n/** Everything the view reads from the URL. A view is its state, so a link is a view. */\nexport interface ViewState {\n\trange: TimeframePreset | 'custom'\n\t/** Set only on a custom range: an inclusive `YYYY-MM-DD` day in the reporting timezone. */\n\tfrom?: string\n\tto?: string\n\tcompare: boolean\n\tsource?: string\n\tmetric: MetricKey\n\t/** Absent means automatic; {@link autoGranularity} picks one from the range. */\n\tgranularity?: Granularity\n\ttab: BreakdownTab\n\tfilters: AnalyticsFilter[]\n\tlimit: ViewLimit\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n}\n\n/** The install's configured starting point, as `AnalyticsViewClientProps.defaults` carries it. */\nexport interface ViewDefaults {\n\trange: TimeframePreset\n\tmetric: MetricKey\n}\n\nconst KNOWN_METRICS = new Set<string>(VIEW_METRIC_ORDER)\nconst KNOWN_DIMENSIONS = new Set<string>(DIMENSION_KEYS)\nconst KNOWN_OPERATORS = new Set<string>(FILTER_OPERATORS)\nconst KNOWN_GRANULARITIES = new Set<string>(GRANULARITY_ORDER)\nconst KNOWN_PRESETS = new Set<string>(TIMEFRAME_PRESETS)\nconst DAY_MS = 86_400_000\nconst DAY_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst read = (search: URLSearchParams, name: string): string | null => {\n\tconst raw = search.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\n/**\n * Epoch ms of a `YYYY-MM-DD` day, or null when it names no real calendar day. The\n * round trip is the validation: `Date.parse` rolls February 30 forward instead of failing.\n */\nconst dayValue = (raw: string | null): number | null => {\n\tif (raw === null || !DAY_PATTERN.test(raw)) {\n\t\treturn null\n\t}\n\tconst ms = Date.parse(`${raw}T00:00:00.000Z`)\n\tif (Number.isNaN(ms) || new Date(ms).toISOString().slice(0, 10) !== raw) {\n\t\treturn null\n\t}\n\treturn ms\n}\n\n/** A configured default the view cannot serve falls back to the built-in range. */\nconst defaultRange = (defaults: ViewDefaults): TimeframePreset =>\n\tdefaults.range === 'allTime' ? DEFAULT_VIEW_RANGE : defaults.range\n\nconst parseRange = (\n\tsearch: URLSearchParams,\n\tdefaults: ViewDefaults\n): Pick<ViewState, 'range' | 'from' | 'to'> => {\n\tconst fallback = { range: defaultRange(defaults) }\n\tconst raw = read(search, 'range')\n\tif (raw === null) {\n\t\treturn fallback\n\t}\n\tif (raw === 'custom') {\n\t\tconst from = dayValue(read(search, 'from'))\n\t\tconst to = dayValue(read(search, 'to'))\n\t\tif (from === null || to === null || to < from) {\n\t\t\treturn fallback\n\t\t}\n\t\t// Beyond the endpoint's own cap the read would only ever answer `range_too_long`.\n\t\tif (Math.round((to - from) / DAY_MS) + 1 > MAX_QUERY_RANGE_DAYS) {\n\t\t\treturn fallback\n\t\t}\n\t\treturn {\n\t\t\trange: 'custom',\n\t\t\tfrom: new Date(from).toISOString().slice(0, 10),\n\t\t\tto: new Date(to).toISOString().slice(0, 10),\n\t\t}\n\t}\n\tif (!KNOWN_PRESETS.has(raw) || raw === 'allTime') {\n\t\treturn fallback\n\t}\n\treturn { range: raw as TimeframePreset }\n}\n\n/**\n * Filters as the endpoint's own parser would accept them, minus its errors: an entry\n * naming a dimension, operator or value outside the contract is dropped rather than\n * failing the whole URL, since a hand-edited link should still open a working view.\n */\nconst parseFilters = (search: URLSearchParams): AnalyticsFilter[] => {\n\tconst raw = read(search, 'filters')\n\tif (raw === null) {\n\t\treturn []\n\t}\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn []\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn []\n\t}\n\tconst filters: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (filters.length === MAX_QUERY_FILTERS) {\n\t\t\tbreak\n\t\t}\n\t\tif (!isRecord(item)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (typeof dimension !== 'string' || !KNOWN_DIMENSIONS.has(dimension)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof operator !== 'string' || !KNOWN_OPERATORS.has(operator)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\tcontinue\n\t\t}\n\t\tfilters.push({\n\t\t\tdimension: dimension as DimensionKey,\n\t\t\toperator: operator as FilterOperator,\n\t\t\tvalue: trimmed,\n\t\t})\n\t}\n\treturn filters\n}\n\nconst parseOrder = (search: URLSearchParams): ViewState['order'] => {\n\tconst raw = read(search, 'order')\n\tif (raw === null) {\n\t\treturn undefined\n\t}\n\tconst parts = raw.split(':')\n\tconst metric = parts[0] ?? ''\n\tconst direction = parts[1] ?? ''\n\tif (parts.length !== 2 || !KNOWN_METRICS.has(metric)) {\n\t\treturn undefined\n\t}\n\tif (direction !== 'asc' && direction !== 'desc') {\n\t\treturn undefined\n\t}\n\treturn { metric: metric as MetricKey, direction }\n}\n\n/**\n * Total by construction: every value the URL cannot justify falls back to the install\n * default, so a truncated, stale or hand-edited link always opens a working view.\n */\nexport const parseViewState = (search: URLSearchParams, defaults: ViewDefaults): ViewState => {\n\tconst metric = read(search, 'metric')\n\tconst granularity = read(search, 'granularity')\n\tconst tab = read(search, 'tab')\n\tconst source = read(search, 'source')\n\tconst limit = Number(read(search, 'limit'))\n\tconst compare = read(search, 'compare')\n\tconst order = parseOrder(search)\n\treturn {\n\t\t...parseRange(search, defaults),\n\t\tcompare: compare === '1' || compare === 'true',\n\t\t...(source === null ? {} : { source }),\n\t\tmetric: metric !== null && KNOWN_METRICS.has(metric) ? (metric as MetricKey) : defaults.metric,\n\t\t...(granularity !== null && KNOWN_GRANULARITIES.has(granularity)\n\t\t\t? { granularity: granularity as Granularity }\n\t\t\t: {}),\n\t\ttab:\n\t\t\ttab !== null && BREAKDOWN_TABS.includes(tab as BreakdownTab)\n\t\t\t\t? (tab as BreakdownTab)\n\t\t\t\t: DEFAULT_VIEW_TAB,\n\t\tfilters: parseFilters(search),\n\t\tlimit: VIEW_LIMITS.includes(limit as ViewLimit) ? (limit as ViewLimit) : DEFAULT_VIEW_LIMIT,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * The shortest URL that parses back to `state`: anything equal to a default is left out,\n * and the keys are written in one fixed order so an unchanged view never rewrites history.\n */\nexport const serializeViewState = (state: ViewState, defaults: ViewDefaults): URLSearchParams => {\n\tconst params = new URLSearchParams()\n\tif (state.range !== defaultRange(defaults)) {\n\t\tparams.set('range', state.range)\n\t}\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\tparams.set('from', state.from)\n\t\tparams.set('to', state.to)\n\t}\n\tif (state.compare) {\n\t\tparams.set('compare', '1')\n\t}\n\tif (state.source !== undefined) {\n\t\tparams.set('source', state.source)\n\t}\n\tif (state.metric !== defaults.metric) {\n\t\tparams.set('metric', state.metric)\n\t}\n\tif (state.granularity !== undefined) {\n\t\tparams.set('granularity', state.granularity)\n\t}\n\tif (state.tab !== DEFAULT_VIEW_TAB) {\n\t\tparams.set('tab', state.tab)\n\t}\n\tif (state.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(state.filters))\n\t}\n\tif (state.limit !== DEFAULT_VIEW_LIMIT) {\n\t\tparams.set('limit', String(state.limit))\n\t}\n\tif (state.order !== undefined) {\n\t\tparams.set('order', `${state.order.metric}:${state.order.direction}`)\n\t}\n\treturn params\n}\n\n/**\n * The nearest state the selected source can actually serve. The URL outlives a source\n * switch, so a metric, tab, filter, comparison, bucket or sort the new source lacks is\n * replaced or dropped here rather than sent to the endpoint to be rejected. Returns the\n * same object when the gate forbids nothing, so a render can compare by identity.\n */\nexport const coerceState = (state: ViewState, gate: ViewGate): ViewState => {\n\tconst metric = gate.metrics.includes(state.metric)\n\t\t? state.metric\n\t\t: (gate.metrics[0] ?? state.metric)\n\tconst tab = gate.tabs.includes(state.tab) ? state.tab : (gate.tabs[0] ?? state.tab)\n\tconst compare = state.compare && gate.canCompare\n\tconst filters = state.filters.filter(\n\t\t(filter) => gate.canFilter(filter.dimension) && gate.operators.includes(filter.operator)\n\t)\n\tconst granularity =\n\t\tstate.granularity !== undefined && gate.granularities.includes(state.granularity)\n\t\t\t? state.granularity\n\t\t\t: undefined\n\tconst order =\n\t\tstate.order !== undefined && gate.metrics.includes(state.order.metric) ? state.order : undefined\n\tconst unchanged =\n\t\tmetric === state.metric &&\n\t\ttab === state.tab &&\n\t\tcompare === state.compare &&\n\t\tfilters.length === state.filters.length &&\n\t\tgranularity === state.granularity &&\n\t\torder === state.order\n\tif (unchanged) {\n\t\treturn state\n\t}\n\treturn {\n\t\trange: state.range,\n\t\t...(state.from === undefined ? {} : { from: state.from }),\n\t\t...(state.to === undefined ? {} : { to: state.to }),\n\t\tcompare,\n\t\t...(state.source === undefined ? {} : { source: state.source }),\n\t\tmetric,\n\t\t...(granularity === undefined ? {} : { granularity }),\n\t\ttab,\n\t\tfilters,\n\t\tlimit: state.limit,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * The inclusive day window a state reads, in the reporting timezone. The endpoint reads\n * `from`/`to` in that same timezone, so the toolbar caption and every request share one\n * answer. `now` is injected to keep callers deterministic.\n */\nexport const rangeFor = (state: ViewState, timezone: string, now: Date): DayRange => {\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\treturn { from: state.from, to: state.to }\n\t}\n\tconst preset = state.range === 'custom' ? DEFAULT_VIEW_RANGE : state.range\n\tconst { start, end } = resolveTimeframe(preset, now, timezone)\n\treturn { from: zonedCalendarDay(start, timezone), to: zonedCalendarDay(end, timezone) }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"state.js","names":[],"sources":["../../src/view/state.ts"],"sourcesContent":["import {\n\ttype AnalyticsFilter,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype Granularity,\n\ttype MetricKey,\n\tPLATFORM_SCOPE,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport { servedName } from '../core/metricAliases'\nimport { isRecord, wholeNumberParam } from '../core/values'\nimport {\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_RANGE_DAYS,\n} from '../query/limits'\nimport { resolveTimeframe, TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport { dayRangeDays } from './dayRange'\nimport {\n\tBREAKDOWN_TABS,\n\ttype BreakdownTab,\n\ttype DayRange,\n\tVIEW_METRIC_ORDER,\n\ttype ViewGate,\n} from './gating'\n\n/**\n * The presets the toolbar offers. `allTime` is deliberately absent: it is unbounded, and\n * the query endpoint refuses any window longer than a year.\n */\nexport const VIEW_RANGE_PRESETS: TimeframePreset[] = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'lastYear',\n]\n\nexport const DEFAULT_VIEW_RANGE: TimeframePreset = 'last30days'\n\n/** @beta */\nexport const VIEW_LIMITS = [10, 25, 50, 100] as const\n\n/** @beta */\nexport type ViewLimit = (typeof VIEW_LIMITS)[number]\n\nexport const DEFAULT_VIEW_LIMIT: ViewLimit = 10\n\nexport const DEFAULT_VIEW_TAB: BreakdownTab = 'pages'\n\n/**\n * Everything the view reads from the URL. A view is its state, so a link is a view.\n *\n * @beta\n */\nexport interface ViewState {\n\trange: TimeframePreset | 'custom'\n\t/** Set only on a custom range: an inclusive `YYYY-MM-DD` day in the reporting timezone. */\n\tfrom?: string\n\tto?: string\n\tcompare: boolean\n\tsource?: string\n\t/**\n\t * An {@link aggregateToken} when aggregating across every scope, absent for the request's own.\n\t * No other value survives a render: the host owns which scope a request resolves to.\n\t */\n\tscope?: string\n\tmetric: MetricKey\n\t/** Absent means automatic; {@link autoGranularity} picks one from the range. */\n\tgranularity?: Granularity\n\ttab: BreakdownTab\n\t/** The dimension the tab groups by. Absent means its default, the first one served. */\n\tdim?: DimensionKey\n\tfilters: AnalyticsFilter[]\n\tlimit: ViewLimit\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n}\n\n/** The install's configured starting point, as `AnalyticsViewClientProps.defaults` carries it. */\nexport interface ViewDefaults {\n\trange: TimeframePreset\n\tmetric: MetricKey\n}\n\nconst AGGREGATE_TAG = `${PLATFORM_SCOPE}:`\n\n/**\n * Aggregate marker tagged with the tenant it was chosen from: the host's selector can move while\n * the address stays open, and an untagged marker would aggregate under a tenant nobody asked for.\n */\nexport const aggregateToken = (from: string): string =>\n\tfrom === '' ? PLATFORM_SCOPE : `${AGGREGATE_TAG}${from}`\n\n/** Whether `value` asks to aggregate: the bare wildcard or an {@link aggregateToken}. */\nexport const isAggregateToken = (value: string | null | undefined): boolean =>\n\tvalue === PLATFORM_SCOPE || (typeof value === 'string' && value.startsWith(AGGREGATE_TAG))\n\n/** The tenant an aggregate token was chosen from; `''` when it names none. */\nexport const aggregateFrom = (token: string): string =>\n\ttoken.startsWith(AGGREGATE_TAG) ? token.slice(AGGREGATE_TAG.length) : ''\n\n/** A filter's identity, which its chip keys on. */\nexport const filterKey = ({ dimension, operator, value }: AnalyticsFilter): string =>\n\t`${dimension}:${operator}:${value}`\n\n/** `state` with its filter at `index` removed. */\nexport const withoutFilter = (state: ViewState, index: number): ViewState => ({\n\t...state,\n\tfilters: state.filters.filter((_, at) => at !== index),\n})\n\nconst known = <T extends string>(list: readonly T[], value: unknown): T | undefined =>\n\tlist.find((entry) => entry === value)\n\nconst DAY_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/\n\nconst read = (search: URLSearchParams, name: string): string | null => {\n\tconst raw = search.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\n/**\n * Whether `raw` is a `YYYY-MM-DD` day naming a real calendar day. The round trip is the\n * validation: `Date.parse` rolls February 30 forward instead of failing.\n */\nconst isCalendarDay = (raw: string | null): raw is string => {\n\tif (raw === null || !DAY_PATTERN.test(raw)) {\n\t\treturn false\n\t}\n\tconst ms = Date.parse(`${raw}T00:00:00.000Z`)\n\treturn !Number.isNaN(ms) && new Date(ms).toISOString().slice(0, 10) === raw\n}\n\n/** A configured default the view cannot serve falls back to the built-in range. */\nconst defaultRange = (defaults: ViewDefaults): TimeframePreset =>\n\tdefaults.range === 'allTime' ? DEFAULT_VIEW_RANGE : defaults.range\n\nconst parseRange = (\n\tsearch: URLSearchParams,\n\tdefaults: ViewDefaults\n): Pick<ViewState, 'range' | 'from' | 'to'> => {\n\tconst fallback = { range: defaultRange(defaults) }\n\tconst raw = read(search, 'range')\n\tif (raw === null) {\n\t\treturn fallback\n\t}\n\tif (raw === 'custom') {\n\t\tconst from = read(search, 'from')\n\t\tconst to = read(search, 'to')\n\t\t// Same-length ISO days order as strings do.\n\t\tif (!isCalendarDay(from) || !isCalendarDay(to) || to < from) {\n\t\t\treturn fallback\n\t\t}\n\t\t// Beyond the endpoint's own cap the read would only ever answer `range_too_long`.\n\t\tif (dayRangeDays({ from, to }) > MAX_QUERY_RANGE_DAYS) {\n\t\t\treturn fallback\n\t\t}\n\t\treturn { range: 'custom', from, to }\n\t}\n\tconst preset = known(TIMEFRAME_PRESETS, raw)\n\tif (preset === undefined || preset === 'allTime') {\n\t\treturn fallback\n\t}\n\treturn { range: preset }\n}\n\n/**\n * Filters as the endpoint parser accepts them; invalid entries drop so a hand-edited link still\n * opens. Repeats drop too: chips key on {@link filterKey}, so duplicates would collide in React.\n */\nconst parseFilters = (search: URLSearchParams): AnalyticsFilter[] => {\n\tconst raw = read(search, 'filters')\n\tif (raw === null) {\n\t\treturn []\n\t}\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn []\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn []\n\t}\n\tconst filters: AnalyticsFilter[] = []\n\tconst seen = new Set<string>()\n\tfor (const item of decoded) {\n\t\tif (filters.length === MAX_QUERY_FILTERS) {\n\t\t\tbreak\n\t\t}\n\t\tif (!isRecord(item) || Array.isArray(item)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst dimension = known(DIMENSION_KEYS, item.dimension)\n\t\tconst operator = known(FILTER_OPERATORS, item.operator)\n\t\tconst { value } = item\n\t\tif (dimension === undefined || operator === undefined) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\tcontinue\n\t\t}\n\t\tconst filter = { dimension, operator, value: trimmed }\n\t\tconst key = filterKey(filter)\n\t\tif (seen.has(key)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(key)\n\t\tfilters.push(filter)\n\t}\n\treturn filters\n}\n\nconst parseOrder = (search: URLSearchParams): ViewState['order'] => {\n\tconst raw = read(search, 'order')\n\tif (raw === null) {\n\t\treturn undefined\n\t}\n\tconst parts = raw.split(':')\n\tconst metric = known(VIEW_METRIC_ORDER, parts[0])\n\tconst direction = parts[1] ?? ''\n\tif (parts.length !== 2 || metric === undefined) {\n\t\treturn undefined\n\t}\n\tif (direction !== 'asc' && direction !== 'desc') {\n\t\treturn undefined\n\t}\n\treturn { metric, direction }\n}\n\n/**\n * Total by construction: every value the URL cannot justify falls back to the install\n * default, so a truncated, stale or hand-edited link always opens a working view.\n */\nexport const parseViewState = (search: URLSearchParams, defaults: ViewDefaults): ViewState => {\n\tconst metric = known(VIEW_METRIC_ORDER, read(search, 'metric'))\n\tconst granularity = known(GRANULARITY_ORDER, read(search, 'granularity'))\n\tconst tab = known(BREAKDOWN_TABS, read(search, 'tab'))\n\tconst dim = known(DIMENSION_KEYS, read(search, 'dim'))\n\tconst source = read(search, 'source')\n\tconst scope = read(search, 'scope')\n\tconst limit = wholeNumberParam(read(search, 'limit'))\n\tconst compare = read(search, 'compare')\n\tconst order = parseOrder(search)\n\treturn {\n\t\t...parseRange(search, defaults),\n\t\tcompare: compare === '1' || compare === 'true',\n\t\t...(source === null ? {} : { source }),\n\t\t// The aggregate marker is the only scope a URL may name: every other one is the host's\n\t\t// own answer for the request, which an address cannot override.\n\t\t...(scope !== null && isAggregateToken(scope) ? { scope } : {}),\n\t\tmetric: metric ?? defaults.metric,\n\t\t...(granularity === undefined ? {} : { granularity }),\n\t\ttab: tab ?? DEFAULT_VIEW_TAB,\n\t\t...(dim === undefined ? {} : { dim }),\n\t\tfilters: parseFilters(search),\n\t\tlimit: VIEW_LIMITS.find((each) => each === limit) ?? DEFAULT_VIEW_LIMIT,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * The shortest URL that parses back to `state`: anything equal to a default is left out,\n * and the keys are written in one fixed order so an unchanged view never rewrites history.\n */\nexport const serializeViewState = (state: ViewState, defaults: ViewDefaults): URLSearchParams => {\n\tconst params = new URLSearchParams()\n\tif (state.range !== defaultRange(defaults)) {\n\t\tparams.set('range', state.range)\n\t}\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\tparams.set('from', state.from)\n\t\tparams.set('to', state.to)\n\t}\n\tif (state.compare) {\n\t\tparams.set('compare', '1')\n\t}\n\tif (state.source !== undefined) {\n\t\tparams.set('source', state.source)\n\t}\n\tif (state.scope !== undefined) {\n\t\tparams.set('scope', state.scope)\n\t}\n\tif (state.metric !== defaults.metric) {\n\t\tparams.set('metric', state.metric)\n\t}\n\tif (state.granularity !== undefined) {\n\t\tparams.set('granularity', state.granularity)\n\t}\n\tif (state.tab !== DEFAULT_VIEW_TAB) {\n\t\tparams.set('tab', state.tab)\n\t}\n\tif (state.dim !== undefined) {\n\t\tparams.set('dim', state.dim)\n\t}\n\tif (state.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(state.filters))\n\t}\n\tif (state.limit !== DEFAULT_VIEW_LIMIT) {\n\t\tparams.set('limit', String(state.limit))\n\t}\n\tif (state.order !== undefined) {\n\t\tparams.set('order', `${state.order.metric}:${state.order.direction}`)\n\t}\n\treturn params\n}\n\n/**\n * Nearest state the selected source serves: the URL outlives a source switch, so what it lacks is\n * replaced or dropped here. Same object when the gate forbids nothing, for identity checks.\n */\nexport const coerceState = (state: ViewState, gate: ViewGate): ViewState => {\n\tconst named = servedName(state.metric, gate.metrics)\n\tconst metric = gate.metrics.includes(named) ? named : (gate.metrics[0] ?? state.metric)\n\tconst tab = gate.tabs.includes(state.tab) ? state.tab : (gate.tabs[0] ?? state.tab)\n\tconst dim =\n\t\tstate.dim !== undefined && gate.dimensionsFor(tab).includes(state.dim) ? state.dim : undefined\n\tconst compare = state.compare && gate.canCompare\n\tconst filters = state.filters.filter((filter) =>\n\t\tgate.operatorsFor(filter.dimension).includes(filter.operator)\n\t)\n\tconst granularity =\n\t\tstate.granularity !== undefined && gate.granularities.includes(state.granularity)\n\t\t\t? state.granularity\n\t\t\t: undefined\n\tconst order =\n\t\tstate.order !== undefined && gate.columns.includes(state.order.metric) ? state.order : undefined\n\tconst unchanged =\n\t\tmetric === state.metric &&\n\t\ttab === state.tab &&\n\t\tdim === state.dim &&\n\t\tcompare === state.compare &&\n\t\tfilters.length === state.filters.length &&\n\t\tgranularity === state.granularity &&\n\t\torder === state.order\n\tif (unchanged) {\n\t\treturn state\n\t}\n\treturn {\n\t\trange: state.range,\n\t\t...(state.from === undefined ? {} : { from: state.from }),\n\t\t...(state.to === undefined ? {} : { to: state.to }),\n\t\tcompare,\n\t\t...(state.source === undefined ? {} : { source: state.source }),\n\t\t...(state.scope === undefined ? {} : { scope: state.scope }),\n\t\tmetric,\n\t\t...(granularity === undefined ? {} : { granularity }),\n\t\ttab,\n\t\t...(dim === undefined ? {} : { dim }),\n\t\tfilters,\n\t\tlimit: state.limit,\n\t\t...(order === undefined ? {} : { order }),\n\t}\n}\n\n/**\n * State as the server read it: an unserved `source` drops and `scope` becomes the resolved one.\n * Same object when nothing needed correcting, so the URL is rewritten only on a change.\n */\nexport const normalizeViewState = (\n\tstate: ViewState,\n\tserved: { sourceIds: string[]; scope?: string }\n): ViewState => {\n\tconst source =\n\t\tstate.source !== undefined && !served.sourceIds.includes(state.source)\n\t\t\t? undefined\n\t\t\t: state.source\n\tif (source === state.source && served.scope === state.scope) {\n\t\treturn state\n\t}\n\tconst { source: _source, scope: _scope, ...rest } = state\n\treturn {\n\t\t...rest,\n\t\t...(source === undefined ? {} : { source }),\n\t\t...(served.scope === undefined ? {} : { scope: served.scope }),\n\t}\n}\n\n/**\n * Inclusive day window a state reads, in the reporting timezone the endpoint reads `from`/`to`\n * in, so toolbar caption and every request agree.\n */\nexport const rangeFor = (state: ViewState, timezone: string, now: Date): DayRange => {\n\tif (state.range === 'custom' && state.from !== undefined && state.to !== undefined) {\n\t\treturn { from: state.from, to: state.to }\n\t}\n\tconst preset = state.range === 'custom' ? DEFAULT_VIEW_RANGE : state.range\n\tconst { start, end } = resolveTimeframe(preset, now, timezone)\n\treturn { from: zonedCalendarDay(start, timezone), to: zonedCalendarDay(end, timezone) }\n}\n"],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ "use client";
2
+ import { viewerNow } from "../ui/viewerClock.js";
3
+ import { useCallback, useEffect, useState } from "react";
4
+ //#region src/view/useViewClock.ts
5
+ /**
6
+ * View's one clock, held so captions and request keys stay stable; it moves on tab return or
7
+ * refresh. Reads key on calendar days, so a same-day tick only updates relative labels.
8
+ */
9
+ const useViewClock = () => {
10
+ const [now, setNow] = useState(viewerNow);
11
+ const tick = useCallback(() => {
12
+ setNow(viewerNow());
13
+ }, []);
14
+ useEffect(() => {
15
+ const onVisible = () => {
16
+ if (document.visibilityState !== "hidden") tick();
17
+ };
18
+ document.addEventListener("visibilitychange", onVisible);
19
+ return () => {
20
+ document.removeEventListener("visibilitychange", onVisible);
21
+ };
22
+ }, [tick]);
23
+ return {
24
+ now,
25
+ tick
26
+ };
27
+ };
28
+ //#endregion
29
+ export { useViewClock };
30
+
31
+ //# sourceMappingURL=useViewClock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useViewClock.js","names":[],"sources":["../../src/view/useViewClock.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useEffect, useState } from 'react'\nimport { viewerNow } from '../ui/viewerClock'\n\nexport interface ViewClock {\n\t/** The one instant every range, caption and relative label of a render reads. */\n\tnow: Date\n\t/** Reads the clock again, as a refresh does. */\n\ttick: () => void\n}\n\n/**\n * View's one clock, held so captions and request keys stay stable; it moves on tab return or\n * refresh. Reads key on calendar days, so a same-day tick only updates relative labels.\n */\nexport const useViewClock = (): ViewClock => {\n\tconst [now, setNow] = useState(viewerNow)\n\tconst tick = useCallback(() => {\n\t\tsetNow(viewerNow())\n\t}, [])\n\n\tuseEffect(() => {\n\t\tconst onVisible = (): void => {\n\t\t\tif (document.visibilityState !== 'hidden') {\n\t\t\t\ttick()\n\t\t\t}\n\t\t}\n\t\tdocument.addEventListener('visibilitychange', onVisible)\n\t\treturn () => {\n\t\t\tdocument.removeEventListener('visibilitychange', onVisible)\n\t\t}\n\t}, [tick])\n\n\treturn { now, tick }\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,qBAAgC;CAC5C,MAAM,CAAC,KAAK,UAAU,SAAS,SAAS;CACxC,MAAM,OAAO,kBAAkB;EAC9B,OAAO,UAAU,CAAC;CACnB,GAAG,CAAC,CAAC;CAEL,gBAAgB;EACf,MAAM,kBAAwB;GAC7B,IAAI,SAAS,oBAAoB,UAChC,KAAK;EAEP;EACA,SAAS,iBAAiB,oBAAoB,SAAS;EACvD,aAAa;GACZ,SAAS,oBAAoB,oBAAoB,SAAS;EAC3D;CACD,GAAG,CAAC,IAAI,CAAC;CAET,OAAO;EAAE;EAAK;CAAK;AACpB"}
@@ -0,0 +1,21 @@
1
+ import { QueryResponse } from "../query/response.js";
2
+ import { RequestState } from "../ui/data/useRequest.js";
3
+ //#region src/view/useViewQueries.d.ts
4
+ /**
5
+ * One section's read. `data` survives loading and errors while source and scope hold, so a range
6
+ * change dims the chart rather than blanking it; another source or scope starts from a skeleton.
7
+ *
8
+ * @beta
9
+ */
10
+ type QueryState<T> = RequestState<T>;
11
+ /** @beta */
12
+ interface ViewQueries {
13
+ cards: QueryState<QueryResponse>;
14
+ trend: QueryState<QueryResponse>;
15
+ breakdown: QueryState<QueryResponse>;
16
+ /** Null when the source serves no goal breakdown, so the panel is not rendered at all. */
17
+ goals: QueryState<QueryResponse> | null;
18
+ }
19
+ //#endregion
20
+ export { QueryState, ViewQueries };
21
+ //# sourceMappingURL=useViewQueries.d.ts.map
@@ -1,15 +1,11 @@
1
1
  "use client";
2
+ import "../core/contract.js";
3
+ import { metricReaches } from "../core/capabilities.js";
2
4
  import { fetchQuery } from "../query/fetchQuery.js";
3
- import { autoGranularity, gate, resolveSource } from "./gating.js";
5
+ import { RATE_DIMENSIONS, autoGranularity, canCompareRange, gate, resolveSource } from "./gating.js";
4
6
  import { coerceState, rangeFor } from "./state.js";
5
- import { useCallback, useEffect, useRef, useState } from "react";
7
+ import { useRequest } from "../ui/data/useRequest.js";
6
8
  //#region src/view/useViewQueries.ts
7
- /**
8
- * `QueryState.error.message` for a section with nothing to ask for: the scope has no
9
- * readable source, or the source serves no metric or dimension the section needs. It is
10
- * never an endpoint failure, so a caller can tell the two apart without a `QueryFetchError`.
11
- */
12
- const SECTION_UNAVAILABLE = "analytics: this source serves no data for this section";
13
9
  const NO_REQUESTS = {
14
10
  cards: null,
15
11
  trend: null,
@@ -17,10 +13,8 @@ const NO_REQUESTS = {
17
13
  goals: null
18
14
  };
19
15
  /**
20
- * Derives the four reads from the view state and the selected source's capabilities.
21
- * Pure and total: the state is coerced to what the source serves first, so no request
22
- * here can carry a metric, dimension, filter, bucket or comparison the endpoint would
23
- * reject. `now` is injected to keep callers deterministic.
16
+ * Four reads from view state and source capabilities. State is coerced to what the source serves
17
+ * first, so no request carries anything the endpoint would reject.
24
18
  */
25
19
  const buildViewRequests = (props, state, now) => {
26
20
  const source = resolveSource(props.sources, state.source);
@@ -34,13 +28,21 @@ const buildViewRequests = (props, state, now) => {
34
28
  to: range.to,
35
29
  ...view.filters.length > 0 ? { filters: view.filters } : {},
36
30
  source: source.id,
37
- timezone: props.timezone
31
+ ...view.scope === void 0 ? {} : { scope: "*" },
32
+ timezone: props.timezone,
33
+ ...view.range === "custom" ? {} : { timeframe: view.range }
38
34
  };
39
- const compare = view.compare ? { compare: "previous" } : {};
40
- const breakdownMetrics = [view.metric, ...served.metrics.includes("visitors") && view.metric !== "visitors" ? ["visitors"] : []];
41
- const dimension = served.dimensionsFor(view.tab)[0];
35
+ const compare = view.compare && canCompareRange(served, range, {
36
+ timezone: props.timezone,
37
+ now
38
+ }) ? { compare: "previous" } : {};
39
+ const dimension = view.dim ?? served.dimensionsFor(view.tab)[0];
40
+ const columns = dimension === void 0 ? [] : served.metricsFor(dimension, view.metric);
41
+ const reachesUnder = (metric, under) => served.metrics.includes(metric) && metricReaches(source.capabilities, metric, { dimensions: [under] });
42
+ const needsVisitors = dimension !== void 0 && RATE_DIMENSIONS.includes(dimension) && reachesUnder("visitors", dimension);
43
+ const breakdownMetrics = [...new Set([...columns, ...needsVisitors ? ["visitors"] : []])];
42
44
  const order = view.order !== void 0 && breakdownMetrics.includes(view.order.metric) ? view.order : {
43
- metric: view.metric,
45
+ metric: columns[0] ?? view.metric,
44
46
  direction: "desc"
45
47
  };
46
48
  return {
@@ -65,78 +67,47 @@ const buildViewRequests = (props, state, now) => {
65
67
  goals: served.goals ? {
66
68
  metrics: [
67
69
  "conversions",
68
- ...served.metrics.includes("revenue") ? ["revenue"] : [],
69
- ...served.metrics.includes("visitors") ? ["visitors"] : []
70
+ ...reachesUnder("revenue", "goal") ? ["revenue"] : [],
71
+ ...reachesUnder("visitors", "goal") ? ["visitors"] : []
70
72
  ],
71
73
  dimensions: ["goal"],
72
74
  ...shared
73
75
  } : null
74
76
  };
75
77
  };
76
- const asError = (err) => err instanceof Error ? err : new Error(String(err));
77
78
  /**
78
- * Runs one section's read. The request is keyed by its serialized form, so a state change
79
- * that leaves a section's query identical never refetches it, and one that changes it
80
- * aborts the in-flight read before issuing the new one.
79
+ * Identity of a section's answer (source and scope). A read under another identity starts empty,
80
+ * so a source switch never shows the last source's numbers under the new one's name.
81
81
  */
82
- const useQuerySection = (apiRoute, request) => {
83
- const [section, setSection] = useState({ status: "loading" });
84
- const pending = useRef(null);
85
- const key = request === null ? null : JSON.stringify(request);
86
- const run = useCallback((serialized) => {
87
- pending.current?.abort();
88
- if (serialized === null) {
89
- pending.current = null;
90
- setSection({
91
- status: "error",
92
- error: /* @__PURE__ */ new Error(SECTION_UNAVAILABLE)
93
- });
94
- return;
95
- }
96
- const controller = new AbortController();
97
- pending.current = controller;
98
- setSection((prev) => prev.status === "loading" ? prev : {
99
- status: "loading",
100
- ...prev.data === void 0 ? {} : { data: prev.data }
101
- });
102
- fetchQuery(apiRoute, JSON.parse(serialized), { signal: controller.signal }).then((data) => {
103
- if (!controller.signal.aborted) setSection({
104
- status: "ok",
105
- data
106
- });
107
- }, (err) => {
108
- if (!controller.signal.aborted) setSection((prev) => ({
109
- status: "error",
110
- error: asError(err),
111
- ...prev.data === void 0 ? {} : { data: prev.data }
112
- }));
113
- });
114
- }, [apiRoute]);
115
- const refetch = useCallback(() => {
116
- run(key);
117
- }, [run, key]);
118
- useEffect(() => {
119
- run(key);
120
- return () => {
121
- pending.current?.abort();
122
- };
123
- }, [run, key]);
124
- return {
125
- ...section,
126
- isRefetching: section.status === "loading" && section.data !== void 0,
127
- refetch
128
- };
82
+ const answerIdentity = (props, state) => {
83
+ return `${resolveSource(props.sources, state.source)?.id ?? ""}|${state.scope ?? ""}|${props.scopeKey}`;
129
84
  };
130
85
  /**
131
- * The view's four reads for one state, each with its own lifecycle: a section refetches
132
- * only when its own request changes, and an in-flight read is aborted when it does.
86
+ * One section's read through the query endpoint, keyed by its serialized request and the scope
87
+ * it reads for, which the request itself does not name.
133
88
  */
134
- const useViewQueries = (props, state) => {
135
- const requests = buildViewRequests(props, state, /* @__PURE__ */ new Date());
136
- const cards = useQuerySection(props.apiRoute, requests.cards);
137
- const trend = useQuerySection(props.apiRoute, requests.trend);
138
- const breakdown = useQuerySection(props.apiRoute, requests.breakdown);
139
- const goals = useQuerySection(props.apiRoute, requests.goals);
89
+ const useQuerySection = (endpoint, request, at) => useRequest({
90
+ key: request === null ? null : JSON.stringify([at.scope, request]),
91
+ run: ({ signal }) => request === null ? Promise.reject(/* @__PURE__ */ new Error("no request")) : fetchQuery(endpoint, request, {
92
+ signal,
93
+ scope: at.scope
94
+ }),
95
+ keep: at.keep
96
+ });
97
+ /**
98
+ * The four reads, each with its own lifecycle: a section refetches only when its request changes,
99
+ * aborting any read in flight. `now` is the view's one clock, so reads cover the captioned days.
100
+ */
101
+ const useViewQueries = (props, state, now) => {
102
+ const requests = buildViewRequests(props, state, now);
103
+ const at = {
104
+ keep: answerIdentity(props, state),
105
+ scope: props.scopeKey
106
+ };
107
+ const cards = useQuerySection(props.endpoints.query, requests.cards, at);
108
+ const trend = useQuerySection(props.endpoints.query, requests.trend, at);
109
+ const breakdown = useQuerySection(props.endpoints.query, requests.breakdown, at);
110
+ const goals = useQuerySection(props.endpoints.query, requests.goals, at);
140
111
  return {
141
112
  cards,
142
113
  trend,
@@ -145,6 +116,6 @@ const useViewQueries = (props, state) => {
145
116
  };
146
117
  };
147
118
  //#endregion
148
- export { SECTION_UNAVAILABLE, useViewQueries };
119
+ export { useViewQueries };
149
120
 
150
121
  //# sourceMappingURL=useViewQueries.js.map