@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,6 +1,7 @@
1
1
  import { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from "../core/contract.js";
2
- import { QueryError } from "./errors.js";
3
2
  import { QueryResponse } from "./response.js";
3
+ import { TimeframePreset } from "../timeframe/presets.js";
4
+ import { QueryFetchError } from "../ui/data/request.js";
4
5
 
5
6
  //#region src/query/fetchQuery.d.ts
6
7
  /** A client-side mirror of the parameters `parseQueryParams` reads off the request. */
@@ -25,35 +26,47 @@ interface QueryRequest {
25
26
  scope?: string;
26
27
  path?: string;
27
28
  hostname?: string;
29
+ /** One content item's ref; only a source serving `perItemQuery` accepts it. */
30
+ item?: string;
28
31
  timezone?: string;
32
+ /** The preset the range was resolved from, so the read can be kept warm; omitted when custom. */
33
+ timeframe?: TimeframePreset;
29
34
  }
30
35
  /**
31
- * Builds the query endpoint URL from a fixed field order (not object insertion order),
32
- * so two `QueryRequest`s with the same values always produce the same URL string. That
33
- * determinism is what `fetchQuery`'s in-flight dedupe keys on.
36
+ * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the
37
+ * endpoint's URL, or the API route alone, which reads from the default mount.
34
38
  */
35
- declare const buildQueryUrl: (apiRoute: string, request: QueryRequest) => string;
36
- /** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
37
- declare class QueryFetchError extends Error {
38
- readonly status: number;
39
- readonly error?: QueryError;
40
- readonly retryAfter?: number;
41
- constructor(status: number, error?: QueryError, retryAfter?: number);
39
+ declare const buildQueryUrl: (endpoint: string, request: QueryRequest) => string;
40
+ interface FetchQueryInit {
41
+ signal?: AbortSignal;
42
+ /**
43
+ * Reader's request scope (view's `scopeKey`, a picker's `useRequestScope`): reads of one URL for
44
+ * different scopes never share a fetch, so a tenant switch cannot leak an answer.
45
+ */
46
+ scope?: string;
42
47
  }
43
48
  /**
44
- * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
45
- * one underlying fetch; the entry clears on settle (success or failure), so a later call
46
- * always sees fresh data and a failed one retries instead of pinning the error.
47
- *
48
- * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
49
- * aborting it would also cancel every other caller sharing that in-flight request.
50
- * `init.signal` instead races the caller's own promise against the abort: aborting
51
- * rejects that caller without touching the shared fetch. Use distinct requests (varying
52
- * a param) when one caller's cancellation must actually stop the network call.
49
+ * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort
50
+ * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.
53
51
  */
54
- declare const fetchQuery: (apiRoute: string, request: QueryRequest, init?: {
52
+ declare const fetchQuery: (endpoint: string, request: QueryRequest, init?: FetchQueryInit) => Promise<QueryResponse>;
53
+ /** What the refresh endpoint answers: the scope's epoch token after the bump. */
54
+ interface RefreshResponse {
55
+ epoch: string;
56
+ }
57
+ interface RefreshRequest {
58
+ /**
59
+ * Refresh another scope (platform readers only; others get `400 untrusted_scope`). Omitted, the
60
+ * request's own resolved scope is refreshed.
61
+ */
62
+ scope?: string;
55
63
  signal?: AbortSignal;
56
- }) => Promise<QueryResponse>;
64
+ }
65
+ /**
66
+ * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never
67
+ * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.
68
+ */
69
+ declare const refreshCache: (endpoint: string, request?: RefreshRequest) => Promise<RefreshResponse>;
57
70
  //#endregion
58
- export { QueryFetchError, QueryRequest, buildQueryUrl, fetchQuery };
71
+ export { FetchQueryInit, QueryRequest, RefreshRequest, RefreshResponse, buildQueryUrl, fetchQuery, refreshCache };
59
72
  //# sourceMappingURL=fetchQuery.d.ts.map
@@ -1,110 +1,117 @@
1
- import { QUERY_PATH } from "../plugin/paths.js";
1
+ import { isRecord } from "../core/values.js";
2
+ import { routePaths } from "../plugin/routes.js";
3
+ import { requestJson, requestShaped } from "../ui/data/request.js";
4
+ import { isQueryResponse } from "./response.js";
2
5
  //#region src/query/fetchQuery.ts
6
+ const DEFAULT_ROUTES = routePaths("/_x");
3
7
  /**
4
- * Builds the query endpoint URL from a fixed field order (not object insertion order),
5
- * so two `QueryRequest`s with the same values always produce the same URL string. That
6
- * determinism is what `fetchQuery`'s in-flight dedupe keys on.
8
+ * The endpoint a caller named: its own URL, which ends in the endpoint's segment whatever the
9
+ * base, or the API route alone (`/api`), which gets the default mount appended.
7
10
  */
8
- const buildQueryUrl = (apiRoute, request) => {
9
- const params = new URLSearchParams();
10
- params.set("metrics", request.metrics.join(","));
11
- if (request.dimensions && request.dimensions.length > 0) params.set("dimensions", request.dimensions.join(","));
12
- params.set("from", request.from);
13
- params.set("to", request.to);
14
- if (request.granularity !== void 0) params.set("granularity", request.granularity);
15
- if (request.filters && request.filters.length > 0) params.set("filters", JSON.stringify(request.filters));
16
- if (request.limit !== void 0) params.set("limit", String(request.limit));
17
- if (request.order !== void 0) params.set("order", `${request.order.metric}:${request.order.direction}`);
18
- if (request.compare !== void 0) params.set("compare", request.compare);
19
- if (request.source !== void 0) params.set("source", request.source);
20
- if (request.scope !== void 0) params.set("scope", request.scope);
21
- if (request.path !== void 0) params.set("path", request.path);
22
- if (request.hostname !== void 0) params.set("hostname", request.hostname);
23
- if (request.timezone !== void 0) params.set("timezone", request.timezone);
24
- return `${apiRoute.endsWith("/") ? apiRoute.slice(0, -1) : apiRoute}${QUERY_PATH}?${params.toString()}`;
11
+ const endpointOf = (given, route) => {
12
+ const trimmed = given.replace(/\/+$/, "");
13
+ return trimmed.endsWith(`/${route}`) ? trimmed : `${trimmed}${DEFAULT_ROUTES[route]}`;
25
14
  };
26
- const isRecord = (value) => typeof value === "object" && value !== null;
27
15
  /**
28
- * Only the query endpoint's structured body counts. The plugin's other read endpoints
29
- * answer a flat `{ "error": "forbidden" }`, which must not land in `QueryFetchError.error`
30
- * as a string where a `QueryError` is declared.
16
+ * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the
17
+ * endpoint's URL, or the API route alone, which reads from the default mount.
31
18
  */
32
- const isQueryErrorResponse = (value) => {
33
- if (!isRecord(value)) return false;
34
- const error = value.error;
35
- return isRecord(error) && typeof error.code === "string" && typeof error.message === "string";
19
+ const buildQueryUrl = (endpoint, request) => {
20
+ const params = new URLSearchParams();
21
+ const put = (name, value) => {
22
+ if (value !== void 0) params.set(name, value);
23
+ };
24
+ const { dimensions, filters, limit, order } = request;
25
+ put("metrics", request.metrics.join(","));
26
+ put("dimensions", dimensions && dimensions.length > 0 ? dimensions.join(",") : void 0);
27
+ put("from", request.from);
28
+ put("to", request.to);
29
+ put("granularity", request.granularity);
30
+ put("filters", filters && filters.length > 0 ? JSON.stringify(filters) : void 0);
31
+ put("limit", limit === void 0 ? void 0 : String(limit));
32
+ put("order", order === void 0 ? void 0 : `${order.metric}:${order.direction}`);
33
+ put("compare", request.compare);
34
+ put("source", request.source);
35
+ put("scope", request.scope);
36
+ put("path", request.path);
37
+ put("hostname", request.hostname);
38
+ put("item", request.item);
39
+ put("timezone", request.timezone);
40
+ put("timeframe", request.timeframe);
41
+ return `${endpointOf(endpoint, "query")}?${params.toString()}`;
36
42
  };
37
- /** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
38
- var QueryFetchError = class extends Error {
39
- status;
40
- error;
41
- retryAfter;
42
- constructor(status, error, retryAfter) {
43
- super(error?.message ?? `analytics query request failed with status ${status}`);
44
- this.name = "QueryFetchError";
45
- this.status = status;
46
- if (error !== void 0) this.error = error;
47
- if (retryAfter !== void 0) this.retryAfter = retryAfter;
48
- }
43
+ const runFetch = (url, signal) => requestShaped(url, isQueryResponse, { signal });
44
+ const inFlight = /* @__PURE__ */ new Map();
45
+ /** Drops `shared` from the map unless a newer fetch already took its key. */
46
+ const forget = (key, shared) => {
47
+ if (inFlight.get(key) === shared) inFlight.delete(key);
49
48
  };
50
- const readRetryAfter = (res) => {
51
- const header = res.headers.get("Retry-After");
52
- if (header === null) return void 0;
53
- const seconds = Number(header);
54
- return Number.isFinite(seconds) ? Math.floor(seconds) : void 0;
49
+ const sharedFetch = (key, url) => {
50
+ const existing = inFlight.get(key);
51
+ if (existing) return existing;
52
+ const controller = new AbortController();
53
+ const created = {
54
+ controller,
55
+ waiting: 0,
56
+ held: false,
57
+ promise: runFetch(url, controller.signal).finally(() => forget(key, created))
58
+ };
59
+ inFlight.set(key, created);
60
+ return created;
55
61
  };
56
- const runFetch = async (url) => {
57
- const res = await fetch(url, {
58
- credentials: "include",
59
- headers: { Accept: "application/json" }
60
- });
61
- if (!res.ok) {
62
- let error;
63
- try {
64
- const body = await res.json();
65
- if (isQueryErrorResponse(body)) error = body.error;
66
- } catch {}
67
- throw new QueryFetchError(res.status, error, readRetryAfter(res));
68
- }
69
- return await res.json();
70
- };
71
- const inFlight = /* @__PURE__ */ new Map();
72
62
  /**
73
- * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
74
- * one underlying fetch; the entry clears on settle (success or failure), so a later call
75
- * always sees fresh data and a failed one retries instead of pinning the error.
76
- *
77
- * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
78
- * aborting it would also cancel every other caller sharing that in-flight request.
79
- * `init.signal` instead races the caller's own promise against the abort: aborting
80
- * rejects that caller without touching the shared fetch. Use distinct requests (varying
81
- * a param) when one caller's cancellation must actually stop the network call.
63
+ * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort
64
+ * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.
82
65
  */
83
- const fetchQuery = (apiRoute, request, init) => {
84
- const url = buildQueryUrl(apiRoute, request);
85
- let pending = inFlight.get(url);
86
- if (!pending) {
87
- pending = runFetch(url).finally(() => {
88
- inFlight.delete(url);
89
- });
90
- inFlight.set(url, pending);
91
- }
66
+ const fetchQuery = (endpoint, request, init) => {
67
+ const url = buildQueryUrl(endpoint, request);
92
68
  const signal = init?.signal;
93
- if (!signal) return pending;
94
- if (signal.aborted) return Promise.reject(signal.reason);
69
+ if (signal?.aborted) return Promise.reject(signal.reason);
70
+ const key = JSON.stringify([init?.scope ?? "", url]);
71
+ const fetching = sharedFetch(key, url);
72
+ if (!signal) {
73
+ fetching.held = true;
74
+ return fetching.promise;
75
+ }
76
+ fetching.waiting += 1;
95
77
  return new Promise((resolve, reject) => {
96
- const onAbort = () => reject(signal.reason);
97
- signal.addEventListener("abort", onAbort, { once: true });
98
- pending.then((value) => {
78
+ let done = false;
79
+ const settle = () => {
80
+ if (done) return false;
81
+ done = true;
82
+ fetching.waiting -= 1;
99
83
  signal.removeEventListener("abort", onAbort);
100
- resolve(value);
84
+ return true;
85
+ };
86
+ const onAbort = () => {
87
+ if (!settle()) return;
88
+ if (fetching.waiting === 0 && !fetching.held) {
89
+ forget(key, fetching);
90
+ fetching.controller.abort(signal.reason);
91
+ }
92
+ reject(signal.reason);
93
+ };
94
+ signal.addEventListener("abort", onAbort, { once: true });
95
+ fetching.promise.then((value) => {
96
+ if (settle()) resolve(value);
101
97
  }, (err) => {
102
- signal.removeEventListener("abort", onAbort);
103
- reject(err);
98
+ if (settle()) reject(err);
104
99
  });
105
100
  });
106
101
  };
102
+ /**
103
+ * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never
104
+ * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.
105
+ */
106
+ const refreshCache = async (endpoint, request = {}) => {
107
+ const body = await requestJson(endpointOf(endpoint, "refresh"), {
108
+ method: "POST",
109
+ body: request.scope === void 0 ? {} : { scope: request.scope },
110
+ ...request.signal === void 0 ? {} : { signal: request.signal }
111
+ });
112
+ return { epoch: isRecord(body) && typeof body.epoch === "string" ? body.epoch : "0" };
113
+ };
107
114
  //#endregion
108
- export { QueryFetchError, buildQueryUrl, fetchQuery };
115
+ export { buildQueryUrl, fetchQuery, refreshCache };
109
116
 
110
117
  //# sourceMappingURL=fetchQuery.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { QUERY_PATH } from '../plugin/paths'\nimport type { QueryError } from './errors'\nimport type { QueryErrorResponse, QueryResponse } from './response'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\ttimezone?: string\n}\n\n/**\n * Builds the query endpoint URL from a fixed field order (not object insertion order),\n * so two `QueryRequest`s with the same values always produce the same URL string. That\n * determinism is what `fetchQuery`'s in-flight dedupe keys on.\n */\nexport const buildQueryUrl = (apiRoute: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tparams.set('metrics', request.metrics.join(','))\n\tif (request.dimensions && request.dimensions.length > 0) {\n\t\tparams.set('dimensions', request.dimensions.join(','))\n\t}\n\tparams.set('from', request.from)\n\tparams.set('to', request.to)\n\tif (request.granularity !== undefined) {\n\t\tparams.set('granularity', request.granularity)\n\t}\n\tif (request.filters && request.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(request.filters))\n\t}\n\tif (request.limit !== undefined) {\n\t\tparams.set('limit', String(request.limit))\n\t}\n\tif (request.order !== undefined) {\n\t\tparams.set('order', `${request.order.metric}:${request.order.direction}`)\n\t}\n\tif (request.compare !== undefined) {\n\t\tparams.set('compare', request.compare)\n\t}\n\tif (request.source !== undefined) {\n\t\tparams.set('source', request.source)\n\t}\n\tif (request.scope !== undefined) {\n\t\tparams.set('scope', request.scope)\n\t}\n\tif (request.path !== undefined) {\n\t\tparams.set('path', request.path)\n\t}\n\tif (request.hostname !== undefined) {\n\t\tparams.set('hostname', request.hostname)\n\t}\n\tif (request.timezone !== undefined) {\n\t\tparams.set('timezone', request.timezone)\n\t}\n\tconst base = apiRoute.endsWith('/') ? apiRoute.slice(0, -1) : apiRoute\n\treturn `${base}${QUERY_PATH}?${params.toString()}`\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\n\n/**\n * Only the query endpoint's structured body counts. The plugin's other read endpoints\n * answer a flat `{ \"error\": \"forbidden\" }`, which must not land in `QueryFetchError.error`\n * as a string where a `QueryError` is declared.\n */\nconst isQueryErrorResponse = (value: unknown): value is QueryErrorResponse => {\n\tif (!isRecord(value)) return false\n\tconst error = value.error\n\treturn isRecord(error) && typeof error.code === 'string' && typeof error.message === 'string'\n}\n\n/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */\nexport class QueryFetchError extends Error {\n\treadonly status: number\n\treadonly error?: QueryError\n\treadonly retryAfter?: number\n\n\tconstructor(status: number, error?: QueryError, retryAfter?: number) {\n\t\tsuper(error?.message ?? `analytics query request failed with status ${status}`)\n\t\tthis.name = 'QueryFetchError'\n\t\tthis.status = status\n\t\tif (error !== undefined) this.error = error\n\t\tif (retryAfter !== undefined) this.retryAfter = retryAfter\n\t}\n}\n\nconst readRetryAfter = (res: Response): number | undefined => {\n\tconst header = res.headers.get('Retry-After')\n\tif (header === null) return undefined\n\t// The HTTP-date form is not a number, so it yields no delay rather than a bogus one;\n\t// a fractional delay floors, since callers schedule in whole seconds.\n\tconst seconds = Number(header)\n\treturn Number.isFinite(seconds) ? Math.floor(seconds) : undefined\n}\n\nconst runFetch = async (url: string): Promise<QueryResponse> => {\n\tconst res = await fetch(url, {\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json' },\n\t})\n\tif (!res.ok) {\n\t\tlet error: QueryError | undefined\n\t\ttry {\n\t\t\tconst body: unknown = await res.json()\n\t\t\tif (isQueryErrorResponse(body)) error = body.error\n\t\t} catch {\n\t\t\t// Body wasn't JSON; error stays undefined and the status still carries the failure.\n\t\t}\n\t\tthrow new QueryFetchError(res.status, error, readRetryAfter(res))\n\t}\n\treturn (await res.json()) as QueryResponse\n}\n\nconst inFlight = new Map<string, Promise<QueryResponse>>()\n\n/**\n * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into\n * one underlying fetch; the entry clears on settle (success or failure), so a later call\n * always sees fresh data and a failed one retries instead of pinning the error.\n *\n * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since\n * aborting it would also cancel every other caller sharing that in-flight request.\n * `init.signal` instead races the caller's own promise against the abort: aborting\n * rejects that caller without touching the shared fetch. Use distinct requests (varying\n * a param) when one caller's cancellation must actually stop the network call.\n */\nexport const fetchQuery = (\n\tapiRoute: string,\n\trequest: QueryRequest,\n\tinit?: { signal?: AbortSignal }\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(apiRoute, request)\n\tlet pending = inFlight.get(url)\n\tif (!pending) {\n\t\tpending = runFetch(url).finally(() => {\n\t\t\tinFlight.delete(url)\n\t\t})\n\t\tinFlight.set(url, pending)\n\t}\n\n\tconst signal = init?.signal\n\tif (!signal) return pending\n\tif (signal.aborted) return Promise.reject(signal.reason)\n\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tconst onAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tpending.then(\n\t\t\t(value) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\tresolve(value)\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\treject(err)\n\t\t\t}\n\t\t)\n\t})\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { isRecord } from '../core/values'\nimport { DEFAULT_ROUTE_BASE, routePaths } from '../plugin/routes'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { requestJson, requestShaped } from '../ui/data/request'\nimport { isQueryResponse, type QueryResponse } from './response'\n\nexport { QueryFetchError } from '../ui/data/request'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\t/** One content item's ref; only a source serving `perItemQuery` accepts it. */\n\titem?: string\n\ttimezone?: string\n\t/** The preset the range was resolved from, so the read can be kept warm; omitted when custom. */\n\ttimeframe?: TimeframePreset\n}\n\nconst DEFAULT_ROUTES = routePaths(DEFAULT_ROUTE_BASE)\n\n/**\n * The endpoint a caller named: its own URL, which ends in the endpoint's segment whatever the\n * base, or the API route alone (`/api`), which gets the default mount appended.\n */\nconst endpointOf = (given: string, route: 'query' | 'refresh'): string => {\n\tconst trimmed = given.replace(/\\/+$/, '')\n\treturn trimmed.endsWith(`/${route}`) ? trimmed : `${trimmed}${DEFAULT_ROUTES[route]}`\n}\n\n/**\n * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the\n * endpoint's URL, or the API route alone, which reads from the default mount.\n */\nexport const buildQueryUrl = (endpoint: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tconst put = (name: string, value: string | undefined): void => {\n\t\tif (value !== undefined) {\n\t\t\tparams.set(name, value)\n\t\t}\n\t}\n\tconst { dimensions, filters, limit, order } = request\n\tput('metrics', request.metrics.join(','))\n\tput('dimensions', dimensions && dimensions.length > 0 ? dimensions.join(',') : undefined)\n\tput('from', request.from)\n\tput('to', request.to)\n\tput('granularity', request.granularity)\n\tput('filters', filters && filters.length > 0 ? JSON.stringify(filters) : undefined)\n\tput('limit', limit === undefined ? undefined : String(limit))\n\tput('order', order === undefined ? undefined : `${order.metric}:${order.direction}`)\n\tput('compare', request.compare)\n\tput('source', request.source)\n\tput('scope', request.scope)\n\tput('path', request.path)\n\tput('hostname', request.hostname)\n\tput('item', request.item)\n\tput('timezone', request.timezone)\n\tput('timeframe', request.timeframe)\n\treturn `${endpointOf(endpoint, 'query')}?${params.toString()}`\n}\n\nconst runFetch = (url: string, signal: AbortSignal): Promise<QueryResponse> =>\n\trequestShaped(url, isQueryResponse, { signal })\n\n/** One fetch every identical concurrent read shares, and who is still waiting on it. */\ninterface SharedFetch {\n\tpromise: Promise<QueryResponse>\n\tcontroller: AbortController\n\t/** Callers that brought a signal and have neither aborted nor been answered. */\n\twaiting: number\n\t/** A caller brought no signal, so it can never abort: the fetch runs to its end. */\n\theld: boolean\n}\n\nconst inFlight = new Map<string, SharedFetch>()\n\n/** Drops `shared` from the map unless a newer fetch already took its key. */\nconst forget = (key: string, shared: SharedFetch): void => {\n\tif (inFlight.get(key) === shared) {\n\t\tinFlight.delete(key)\n\t}\n}\n\nconst sharedFetch = (key: string, url: string): SharedFetch => {\n\tconst existing = inFlight.get(key)\n\tif (existing) {\n\t\treturn existing\n\t}\n\tconst controller = new AbortController()\n\tconst created: SharedFetch = {\n\t\tcontroller,\n\t\twaiting: 0,\n\t\theld: false,\n\t\tpromise: runFetch(url, controller.signal).finally(() => forget(key, created)),\n\t}\n\tinFlight.set(key, created)\n\treturn created\n}\n\nexport interface FetchQueryInit {\n\tsignal?: AbortSignal\n\t/**\n\t * Reader's request scope (view's `scopeKey`, a picker's `useRequestScope`): reads of one URL for\n\t * different scopes never share a fetch, so a tenant switch cannot leak an answer.\n\t */\n\tscope?: string\n}\n\n/**\n * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort\n * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.\n */\nexport const fetchQuery = (\n\tendpoint: string,\n\trequest: QueryRequest,\n\tinit?: FetchQueryInit\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(endpoint, request)\n\tconst signal = init?.signal\n\tif (signal?.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\tconst key = JSON.stringify([init?.scope ?? '', url])\n\tconst fetching = sharedFetch(key, url)\n\tif (!signal) {\n\t\tfetching.held = true\n\t\treturn fetching.promise\n\t}\n\tfetching.waiting += 1\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tlet done = false\n\t\tconst settle = (): boolean => {\n\t\t\tif (done) {\n\t\t\t\treturn false\n\t\t\t}\n\t\t\tdone = true\n\t\t\tfetching.waiting -= 1\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\treturn true\n\t\t}\n\t\tconst onAbort = (): void => {\n\t\t\tif (!settle()) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (fetching.waiting === 0 && !fetching.held) {\n\t\t\t\tforget(key, fetching)\n\t\t\t\tfetching.controller.abort(signal.reason)\n\t\t\t}\n\t\t\treject(signal.reason)\n\t\t}\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tfetching.promise.then(\n\t\t\t(value) => {\n\t\t\t\tif (settle()) {\n\t\t\t\t\tresolve(value)\n\t\t\t\t}\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tif (settle()) {\n\t\t\t\t\treject(err)\n\t\t\t\t}\n\t\t\t}\n\t\t)\n\t})\n}\n\n/** What the refresh endpoint answers: the scope's epoch token after the bump. */\nexport interface RefreshResponse {\n\tepoch: string\n}\n\nexport interface RefreshRequest {\n\t/**\n\t * Refresh another scope (platform readers only; others get `400 untrusted_scope`). Omitted, the\n\t * request's own resolved scope is refreshed.\n\t */\n\tscope?: string\n\tsignal?: AbortSignal\n}\n\n/**\n * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never\n * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.\n */\nexport const refreshCache = async (\n\tendpoint: string,\n\trequest: RefreshRequest = {}\n): Promise<RefreshResponse> => {\n\tconst body = await requestJson(endpointOf(endpoint, 'refresh'), {\n\t\tmethod: 'POST',\n\t\tbody: request.scope === undefined ? {} : { scope: request.scope },\n\t\t...(request.signal === undefined ? {} : { signal: request.signal }),\n\t})\n\t// The caller acts on the refresh having happened, not on the token, so an answer this\n\t// client cannot read is reported as the initial token rather than typed into a lie.\n\treturn { epoch: isRecord(body) && typeof body.epoch === 'string' ? body.epoch : '0' }\n}\n"],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /** Whether a window is longer than {@link MAX_QUERY_RANGE_DAYS}, which every read path refuses. */
2
+ const exceedsRangeCap = (range) => range.end.getTime() - range.start.getTime() > 366 * 864e5;
3
+ /** The earliest year a bound may name: nothing was counted before 1970. */
4
+ const MIN_QUERY_YEAR = 1970;
5
+ //#endregion
6
+ export { MIN_QUERY_YEAR, exceedsRangeCap };
7
+
8
+ //# sourceMappingURL=limits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.js","names":[],"sources":["../../src/query/limits.ts"],"sourcesContent":["/**\n * Leaf module with no imports, so the admin view and browser tracker share these bounds without\n * pulling the server parser or ingest pipeline into their bundles.\n */\n\nexport const MAX_QUERY_METRICS = 10\nexport const MAX_QUERY_DIMENSIONS = 2\nexport const MAX_QUERY_FILTERS = 10\nexport const MIN_QUERY_LIMIT = 1\nexport const MAX_QUERY_LIMIT = 500\nexport const DEFAULT_QUERY_LIMIT = 50\nexport const MAX_QUERY_RANGE_DAYS = 366\n\n/** Whether a window is longer than {@link MAX_QUERY_RANGE_DAYS}, which every read path refuses. */\nexport const exceedsRangeCap = (range: { start: Date; end: Date }): boolean =>\n\trange.end.getTime() - range.start.getTime() > MAX_QUERY_RANGE_DAYS * 86_400_000\n\n/** The earliest year a bound may name: nothing was counted before 1970. */\nexport const MIN_QUERY_YEAR = 1970\n\nexport const MAX_SCOPE_LENGTH = 256\nexport const MAX_QUERY_FILTER_VALUE_LENGTH = 256\nexport const MAX_QUERY_PATH_LENGTH = 512\nexport const MAX_QUERY_HOSTNAME_LENGTH = 253\n\n/**\n * Ingest wire caps, not read-path bounds. `MAX_QUERY_LENGTH` is the page's own query string (utm\n * source), capped by the tracker and again by public ingest.\n */\nexport const MAX_QUERY_LENGTH = 512\nexport const MAX_REFERRER_LENGTH = 512\n\n/**\n * Caps each geo value: it comes from client-settable headers and keys daily totals, where an\n * oversized one fails Postgres's 2704-byte btree limit but passes Mongo.\n */\nexport const MAX_GEO_LENGTH = 128\n"],"mappings":";AAcA,MAAa,mBAAmB,UAC/B,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,IAAA,MAA2B;;AAGtE,MAAa,iBAAiB"}
@@ -1,5 +1,6 @@
1
1
  import { AnalyticsQuery } from "../core/contract.js";
2
- import { QueryError } from "./errors.js";
2
+ import { AnalyticsError } from "../plugin/errors.js";
3
+ import { TimeframePreset } from "../timeframe/presets.js";
3
4
 
4
5
  //#region src/query/parse.d.ts
5
6
  /**
@@ -9,13 +10,18 @@ import { QueryError } from "./errors.js";
9
10
  interface ParsedQuery {
10
11
  query: AnalyticsQuery;
11
12
  compare: 'previous' | null;
13
+ /**
14
+ * The named timeframe the caller resolved `from` and `to` from, which lets the read be stored
15
+ * for the warm task to repeat; null when the caller named none.
16
+ */
17
+ timeframe: TimeframePreset | null;
12
18
  }
13
19
  type ParseResult = {
14
20
  ok: true;
15
21
  value: ParsedQuery;
16
22
  } | {
17
23
  ok: false;
18
- error: QueryError;
24
+ error: AnalyticsError;
19
25
  };
20
26
  //#endregion
21
27
  export { ParseResult, ParsedQuery };