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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,117 +1,117 @@
1
- import { QUERY_PATH, REFRESH_PATH } from "../plugin/paths.js";
2
- import { readResponseError } from "../plugin/errors.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";
3
5
  //#region src/query/fetchQuery.ts
4
- const apiBase = (apiRoute) => apiRoute.endsWith("/") ? apiRoute.slice(0, -1) : apiRoute;
6
+ const DEFAULT_ROUTES = routePaths("/_x");
5
7
  /**
6
- * Builds the query endpoint URL from a fixed field order (not object insertion order),
7
- * so two `QueryRequest`s with the same values always produce the same URL string. That
8
- * 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.
9
10
  */
10
- const buildQueryUrl = (apiRoute, request) => {
11
- const params = new URLSearchParams();
12
- params.set("metrics", request.metrics.join(","));
13
- if (request.dimensions && request.dimensions.length > 0) params.set("dimensions", request.dimensions.join(","));
14
- params.set("from", request.from);
15
- params.set("to", request.to);
16
- if (request.granularity !== void 0) params.set("granularity", request.granularity);
17
- if (request.filters && request.filters.length > 0) params.set("filters", JSON.stringify(request.filters));
18
- if (request.limit !== void 0) params.set("limit", String(request.limit));
19
- if (request.order !== void 0) params.set("order", `${request.order.metric}:${request.order.direction}`);
20
- if (request.compare !== void 0) params.set("compare", request.compare);
21
- if (request.source !== void 0) params.set("source", request.source);
22
- if (request.scope !== void 0) params.set("scope", request.scope);
23
- if (request.path !== void 0) params.set("path", request.path);
24
- if (request.hostname !== void 0) params.set("hostname", request.hostname);
25
- if (request.timezone !== void 0) params.set("timezone", request.timezone);
26
- return `${apiBase(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]}`;
27
14
  };
28
- const isRecord = (value) => typeof value === "object" && value !== null;
29
- /** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
30
- var QueryFetchError = class extends Error {
31
- status;
32
- error;
33
- retryAfter;
34
- constructor(status, error, retryAfter) {
35
- super(error?.message ?? `analytics query request failed with status ${status}`);
36
- this.name = "QueryFetchError";
37
- this.status = status;
38
- if (error !== void 0) this.error = error;
39
- if (retryAfter !== void 0) this.retryAfter = retryAfter;
40
- }
15
+ /**
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.
18
+ */
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()}`;
41
42
  };
42
- const readRetryAfter = (res) => {
43
- const header = res.headers.get("Retry-After");
44
- if (header === null) return void 0;
45
- const seconds = Number(header);
46
- return Number.isFinite(seconds) ? Math.floor(seconds) : void 0;
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);
47
48
  };
48
- const failure = async (res) => new QueryFetchError(res.status, await readResponseError(res), readRetryAfter(res));
49
- const runFetch = async (url) => {
50
- const res = await fetch(url, {
51
- credentials: "include",
52
- headers: { Accept: "application/json" }
53
- });
54
- if (!res.ok) throw await failure(res);
55
- return await res.json();
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;
56
61
  };
57
- const inFlight = /* @__PURE__ */ new Map();
58
62
  /**
59
- * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
60
- * one underlying fetch; the entry clears on settle (success or failure), so a later call
61
- * always sees fresh data and a failed one retries instead of pinning the error.
62
- *
63
- * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
64
- * aborting it would also cancel every other caller sharing that in-flight request.
65
- * `init.signal` instead races the caller's own promise against the abort: aborting
66
- * rejects that caller without touching the shared fetch. Use distinct requests (varying
67
- * 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.
68
65
  */
69
- const fetchQuery = (apiRoute, request, init) => {
70
- const url = buildQueryUrl(apiRoute, request);
71
- let pending = inFlight.get(url);
72
- if (!pending) {
73
- pending = runFetch(url).finally(() => {
74
- inFlight.delete(url);
75
- });
76
- inFlight.set(url, pending);
77
- }
66
+ const fetchQuery = (endpoint, request, init) => {
67
+ const url = buildQueryUrl(endpoint, request);
78
68
  const signal = init?.signal;
79
- if (!signal) return pending;
80
- 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;
81
77
  return new Promise((resolve, reject) => {
82
- const onAbort = () => reject(signal.reason);
83
- signal.addEventListener("abort", onAbort, { once: true });
84
- pending.then((value) => {
78
+ let done = false;
79
+ const settle = () => {
80
+ if (done) return false;
81
+ done = true;
82
+ fetching.waiting -= 1;
85
83
  signal.removeEventListener("abort", onAbort);
86
- 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);
87
97
  }, (err) => {
88
- signal.removeEventListener("abort", onAbort);
89
- reject(err);
98
+ if (settle()) reject(err);
90
99
  });
91
100
  });
92
101
  };
93
102
  /**
94
- * Raises the scope's cache epoch, so every later read of it misses the cache and reaches
95
- * the provider again. Not deduped, unlike `fetchQuery`: a reader pressing Refresh twice
96
- * means it twice, and the signal can go straight to the fetch because no other caller
97
- * shares it. Rejects with a `QueryFetchError` for any non-2xx answer, the same as a read.
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.
98
105
  */
99
- const refreshCache = async (apiRoute, request = {}) => {
100
- const res = await fetch(`${apiBase(apiRoute)}${REFRESH_PATH}`, {
106
+ const refreshCache = async (endpoint, request = {}) => {
107
+ const body = await requestJson(endpointOf(endpoint, "refresh"), {
101
108
  method: "POST",
102
- credentials: "include",
103
- headers: {
104
- Accept: "application/json",
105
- "Content-Type": "application/json"
106
- },
107
- body: JSON.stringify(request.scope === void 0 ? {} : { scope: request.scope }),
109
+ body: request.scope === void 0 ? {} : { scope: request.scope },
108
110
  ...request.signal === void 0 ? {} : { signal: request.signal }
109
111
  });
110
- if (!res.ok) throw await failure(res);
111
- const body = await res.json();
112
112
  return { epoch: isRecord(body) && typeof body.epoch === "string" ? body.epoch : "0" };
113
113
  };
114
114
  //#endregion
115
- export { QueryFetchError, buildQueryUrl, fetchQuery, refreshCache };
115
+ export { buildQueryUrl, fetchQuery, refreshCache };
116
116
 
117
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 { readResponseError } from '../plugin/errors'\nimport { QUERY_PATH, REFRESH_PATH } from '../plugin/paths'\nimport type { QueryError } from './errors'\nimport type { 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\nconst apiBase = (apiRoute: string): string =>\n\tapiRoute.endsWith('/') ? apiRoute.slice(0, -1) : apiRoute\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\treturn `${apiBase(apiRoute)}${QUERY_PATH}?${params.toString()}`\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\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 failure = async (res: Response): Promise<QueryFetchError> =>\n\tnew QueryFetchError(res.status, await readResponseError(res), readRetryAfter(res))\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\tthrow await failure(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\n/** What `POST /analytics/refresh` 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: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes. 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, so every later read of it misses the cache and reaches\n * the provider again. Not deduped, unlike `fetchQuery`: a reader pressing Refresh twice\n * means it twice, and the signal can go straight to the fetch because no other caller\n * shares it. Rejects with a `QueryFetchError` for any non-2xx answer, the same as a read.\n */\nexport const refreshCache = async (\n\tapiRoute: string,\n\trequest: RefreshRequest = {}\n): Promise<RefreshResponse> => {\n\tconst res = await fetch(`${apiBase(apiRoute)}${REFRESH_PATH}`, {\n\t\tmethod: 'POST',\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json', 'Content-Type': 'application/json' },\n\t\tbody: JSON.stringify(request.scope === undefined ? {} : { scope: request.scope }),\n\t\t...(request.signal === undefined ? {} : { signal: request.signal }),\n\t})\n\tif (!res.ok) {\n\t\tthrow await failure(res)\n\t}\n\tconst body: unknown = await res.json()\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":";;;AA4BA,MAAM,WAAW,aAChB,SAAS,SAAS,GAAG,IAAI,SAAS,MAAM,GAAG,EAAE,IAAI;;;;;;AAOlD,MAAa,iBAAiB,UAAkB,YAAkC;CACjF,MAAM,SAAS,IAAI,gBAAgB;CACnC,OAAO,IAAI,WAAW,QAAQ,QAAQ,KAAK,GAAG,CAAC;CAC/C,IAAI,QAAQ,cAAc,QAAQ,WAAW,SAAS,GACrD,OAAO,IAAI,cAAc,QAAQ,WAAW,KAAK,GAAG,CAAC;CAEtD,OAAO,IAAI,QAAQ,QAAQ,IAAI;CAC/B,OAAO,IAAI,MAAM,QAAQ,EAAE;CAC3B,IAAI,QAAQ,gBAAgB,KAAA,GAC3B,OAAO,IAAI,eAAe,QAAQ,WAAW;CAE9C,IAAI,QAAQ,WAAW,QAAQ,QAAQ,SAAS,GAC/C,OAAO,IAAI,WAAW,KAAK,UAAU,QAAQ,OAAO,CAAC;CAEtD,IAAI,QAAQ,UAAU,KAAA,GACrB,OAAO,IAAI,SAAS,OAAO,QAAQ,KAAK,CAAC;CAE1C,IAAI,QAAQ,UAAU,KAAA,GACrB,OAAO,IAAI,SAAS,GAAG,QAAQ,MAAM,OAAO,GAAG,QAAQ,MAAM,WAAW;CAEzE,IAAI,QAAQ,YAAY,KAAA,GACvB,OAAO,IAAI,WAAW,QAAQ,OAAO;CAEtC,IAAI,QAAQ,WAAW,KAAA,GACtB,OAAO,IAAI,UAAU,QAAQ,MAAM;CAEpC,IAAI,QAAQ,UAAU,KAAA,GACrB,OAAO,IAAI,SAAS,QAAQ,KAAK;CAElC,IAAI,QAAQ,SAAS,KAAA,GACpB,OAAO,IAAI,QAAQ,QAAQ,IAAI;CAEhC,IAAI,QAAQ,aAAa,KAAA,GACxB,OAAO,IAAI,YAAY,QAAQ,QAAQ;CAExC,IAAI,QAAQ,aAAa,KAAA,GACxB,OAAO,IAAI,YAAY,QAAQ,QAAQ;CAExC,OAAO,GAAG,QAAQ,QAAQ,IAAI,WAAW,GAAG,OAAO,SAAS;AAC7D;AAEA,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU;;AAGxC,IAAa,kBAAb,cAAqC,MAAM;CAC1C;CACA;CACA;CAEA,YAAY,QAAgB,OAAoB,YAAqB;EACpE,MAAM,OAAO,WAAW,8CAA8C,QAAQ;EAC9E,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,IAAI,UAAU,KAAA,GAAW,KAAK,QAAQ;EACtC,IAAI,eAAe,KAAA,GAAW,KAAK,aAAa;CACjD;AACD;AAEA,MAAM,kBAAkB,QAAsC;CAC7D,MAAM,SAAS,IAAI,QAAQ,IAAI,aAAa;CAC5C,IAAI,WAAW,MAAM,OAAO,KAAA;CAG5B,MAAM,UAAU,OAAO,MAAM;CAC7B,OAAO,OAAO,SAAS,OAAO,IAAI,KAAK,MAAM,OAAO,IAAI,KAAA;AACzD;AAEA,MAAM,UAAU,OAAO,QACtB,IAAI,gBAAgB,IAAI,QAAQ,MAAM,kBAAkB,GAAG,GAAG,eAAe,GAAG,CAAC;AAElF,MAAM,WAAW,OAAO,QAAwC;CAC/D,MAAM,MAAM,MAAM,MAAM,KAAK;EAC5B,aAAa;EACb,SAAS,EAAE,QAAQ,mBAAmB;CACvC,CAAC;CACD,IAAI,CAAC,IAAI,IACR,MAAM,MAAM,QAAQ,GAAG;CAExB,OAAQ,MAAM,IAAI,KAAK;AACxB;AAEA,MAAM,2BAAW,IAAI,IAAoC;;;;;;;;;;;;AAazD,MAAa,cACZ,UACA,SACA,SAC4B;CAC5B,MAAM,MAAM,cAAc,UAAU,OAAO;CAC3C,IAAI,UAAU,SAAS,IAAI,GAAG;CAC9B,IAAI,CAAC,SAAS;EACb,UAAU,SAAS,GAAG,EAAE,cAAc;GACrC,SAAS,OAAO,GAAG;EACpB,CAAC;EACD,SAAS,IAAI,KAAK,OAAO;CAC1B;CAEA,MAAM,SAAS,MAAM;CACrB,IAAI,CAAC,QAAQ,OAAO;CACpB,IAAI,OAAO,SAAS,OAAO,QAAQ,OAAO,OAAO,MAAM;CAEvD,OAAO,IAAI,SAAwB,SAAS,WAAW;EACtD,MAAM,gBAAgB,OAAO,OAAO,MAAM;EAC1C,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACxD,QAAQ,MACN,UAAU;GACV,OAAO,oBAAoB,SAAS,OAAO;GAC3C,QAAQ,KAAK;EACd,IACC,QAAiB;GACjB,OAAO,oBAAoB,SAAS,OAAO;GAC3C,OAAO,GAAG;EACX,CACD;CACD,CAAC;AACF;;;;;;;AAuBA,MAAa,eAAe,OAC3B,UACA,UAA0B,CAAC,MACG;CAC9B,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,QAAQ,IAAI,gBAAgB;EAC9D,QAAQ;EACR,aAAa;EACb,SAAS;GAAE,QAAQ;GAAoB,gBAAgB;EAAmB;EAC1E,MAAM,KAAK,UAAU,QAAQ,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,QAAQ,MAAM,CAAC;EAChF,GAAI,QAAQ,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;CAClE,CAAC;CACD,IAAI,CAAC,IAAI,IACR,MAAM,MAAM,QAAQ,GAAG;CAExB,MAAM,OAAgB,MAAM,IAAI,KAAK;CAGrC,OAAO,EAAE,OAAO,SAAS,IAAI,KAAK,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,IAAI;AACrF"}
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
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,6 +10,11 @@ import { AnalyticsError } from "../plugin/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;
@@ -1,15 +1,19 @@
1
- import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
1
+ import { isOneOf, isRecord } from "../core/values.js";
2
+ import { supportsGranularity } from "../core/granularity.js";
3
+ import { isDimensionKey, isFilterOperator, isGranularity, isMetricKey } from "../core/guards.js";
2
4
  import { isValidTimeZone } from "../timeframe/tz.js";
3
- import { METRIC_KEYS } from "../translations/metricKeys.js";
5
+ import { exceedsRangeCap } from "./limits.js";
4
6
  import { analyticsError } from "../plugin/errors.js";
5
- import { GRANULARITY_ORDER } from "../core/granularity.js";
7
+ import { TIMEFRAME_PRESETS, isTimeframePreset } from "../timeframe/presets.js";
8
+ import { filterOperatorsFor, metricOutOfReach } from "../core/capabilities.js";
9
+ import { parseItemRef } from "../items/ref.js";
10
+ import { servedName } from "../core/metricAliases.js";
6
11
  import { parseDayOrInstant } from "./dates.js";
7
12
  //#region src/query/parse.ts
8
- const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
9
- const KNOWN_DIMENSIONS = new Set(DIMENSION_KEYS);
10
- const KNOWN_OPERATORS = new Set(FILTER_OPERATORS);
11
- const KNOWN_GRANULARITIES = new Set(GRANULARITY_ORDER);
12
- const DAY_MS = 864e5;
13
+ const parsed = (value) => ({
14
+ ok: true,
15
+ value
16
+ });
13
17
  const fail = (code, message, param) => ({
14
18
  ok: false,
15
19
  error: analyticsError(code, message, param)
@@ -17,9 +21,8 @@ const fail = (code, message, param) => ({
17
21
  /** Echo a rejected value back in a message without letting a caller inflate the response. */
18
22
  const echo = (value) => value.length > 40 ? `${value.slice(0, 40)}...` : value;
19
23
  /**
20
- * A trimmed non-empty parameter, or null when absent or blank. Exported so the handler
21
- * reads `source` and `scope` (which it must resolve before the parser can run) exactly
22
- * the way the parser reads everything else.
24
+ * A trimmed non-empty parameter, or null. Exported so the handler reads `source` and `scope`
25
+ * exactly as the parser reads everything else.
23
26
  */
24
27
  const readParam = (params, name) => {
25
28
  const raw = params.get(name)?.trim();
@@ -27,8 +30,67 @@ const readParam = (params, name) => {
27
30
  };
28
31
  const commaList = (raw) => raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
29
32
  const dedupe = (values) => [...new Set(values)];
30
- const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
31
- const parseFilters = (raw, capabilities) => {
33
+ /**
34
+ * Dimension list as the query parser reads it, for callers outside the query endpoint (document
35
+ * panel). Unknown names are dropped, not refused: the caller wants blocks to draw, not an error.
36
+ */
37
+ const readDimensionList = (raw, max = 2) => dedupe(commaList(raw ?? "").filter(isDimensionKey)).slice(0, max);
38
+ const parseMetrics = (params, capabilities) => {
39
+ const listed = commaList(readParam(params, "metrics") ?? "");
40
+ if (listed.length === 0) return fail("invalid_param", "metrics is required", "metrics");
41
+ const unknown = listed.find((m) => !isMetricKey(m));
42
+ if (unknown !== void 0) return fail("invalid_param", `unknown metric: ${echo(unknown)}`, "metrics");
43
+ const metrics = dedupe(listed.filter(isMetricKey));
44
+ if (metrics.length > 10) return fail("invalid_param", `at most 10 metrics are allowed`, "metrics");
45
+ const unsupported = metrics.find((m) => !capabilities.metrics.includes(servedName(m, capabilities.metrics)));
46
+ if (unsupported !== void 0) return fail("unsupported_metric", `source does not serve ${unsupported}`, "metrics");
47
+ return parsed(metrics);
48
+ };
49
+ const parseDimensions = (params, capabilities) => {
50
+ const listed = commaList(readParam(params, "dimensions") ?? "");
51
+ const unknown = listed.find((d) => !isDimensionKey(d));
52
+ if (unknown !== void 0) return fail("invalid_param", `unknown dimension: ${echo(unknown)}`, "dimensions");
53
+ const dimensions = dedupe(listed.filter(isDimensionKey));
54
+ if (dimensions.length > 2) return fail("invalid_param", `at most 2 dimensions are allowed`, "dimensions");
55
+ const unsupported = dimensions.find((d) => !capabilities.dimensions.includes(d));
56
+ if (unsupported !== void 0) return fail("unsupported_dimension", `source does not break down by ${unsupported}`, "dimensions");
57
+ return parsed(dimensions);
58
+ };
59
+ const parseRange = (params, timezone) => {
60
+ const rawFrom = readParam(params, "from");
61
+ const rawTo = readParam(params, "to");
62
+ if (!rawFrom) return fail("invalid_param", "from is required", "from");
63
+ const start = parseDayOrInstant(rawFrom, {
64
+ timezone,
65
+ edge: "start"
66
+ });
67
+ if (!start) return fail("invalid_param", `from is not a date: ${echo(rawFrom)}`, "from");
68
+ if (!rawTo) return fail("invalid_param", "to is required", "to");
69
+ const end = parseDayOrInstant(rawTo, {
70
+ timezone,
71
+ edge: "end"
72
+ });
73
+ if (!end) return fail("invalid_param", `to is not a date: ${echo(rawTo)}`, "to");
74
+ if (end.getTime() < start.getTime()) return fail("invalid_param", "to must not be before from", "to");
75
+ if (exceedsRangeCap({
76
+ start,
77
+ end
78
+ })) return fail("range_too_long", `the range must not exceed 366 days`, "to");
79
+ return parsed({
80
+ start,
81
+ end
82
+ });
83
+ };
84
+ const parseGranularity = (params, capabilities) => {
85
+ const raw = readParam(params, "granularity");
86
+ if (raw === null) return parsed(null);
87
+ if (!isGranularity(raw)) return fail("invalid_param", `unknown granularity: ${echo(raw)}`, "granularity");
88
+ if (!supportsGranularity(capabilities, raw)) return fail("unsupported_granularity", `source buckets no finer than ${capabilities.minGranularity}`, "granularity");
89
+ return parsed(raw);
90
+ };
91
+ const parseFilters = (params, capabilities) => {
92
+ const raw = readParam(params, "filters");
93
+ if (raw === null) return parsed([]);
32
94
  let decoded;
33
95
  try {
34
96
  decoded = JSON.parse(raw);
@@ -37,132 +99,117 @@ const parseFilters = (raw, capabilities) => {
37
99
  }
38
100
  if (!Array.isArray(decoded)) return fail("invalid_param", "filters must be a JSON array", "filters");
39
101
  if (decoded.length > 10) return fail("invalid_param", `at most 10 filters are allowed`, "filters");
40
- const filterable = new Set(capabilities.filters);
41
- const operators = new Set(capabilities.filterOperators);
42
- const parsed = [];
102
+ const filters = [];
43
103
  for (const item of decoded) {
44
- if (!isRecord(item)) return fail("invalid_param", "each filter must be an object", "filters");
104
+ if (!isRecord(item) || Array.isArray(item)) return fail("invalid_param", "each filter must be an object", "filters");
45
105
  const { dimension, operator, value } = item;
46
- if (typeof dimension !== "string" || !KNOWN_DIMENSIONS.has(dimension)) return fail("invalid_param", `unknown filter dimension: ${echo(String(dimension))}`, "filters");
47
- if (typeof operator !== "string" || !KNOWN_OPERATORS.has(operator)) return fail("invalid_param", `unknown filter operator: ${echo(String(operator))}`, "filters");
106
+ if (!isDimensionKey(dimension)) return fail("invalid_param", `unknown filter dimension: ${echo(String(dimension))}`, "filters");
107
+ if (!isFilterOperator(operator)) return fail("invalid_param", `unknown filter operator: ${echo(String(operator))}`, "filters");
48
108
  if (typeof value !== "string") return fail("invalid_param", "each filter value must be a string", "filters");
49
109
  const trimmed = value.trim();
50
110
  if (trimmed.length < 1 || trimmed.length > 256) return fail("invalid_param", `each filter value must be 1 to 256 characters`, "filters");
51
- if (!filterable.has(dimension)) return fail("unsupported_filter", `source cannot filter on ${dimension}`, "filters");
52
- if (!operators.has(operator)) return fail("unsupported_operator", `source does not support ${operator}`, "filters");
53
- parsed.push({
111
+ const offered = filterOperatorsFor(capabilities, dimension);
112
+ if (offered.length === 0) return fail("unsupported_filter", `source cannot filter on ${dimension}`, "filters");
113
+ if (!offered.includes(operator)) return fail("unsupported_operator", `source cannot filter ${dimension} with ${operator}`, "filters");
114
+ filters.push({
54
115
  dimension,
55
116
  operator,
56
117
  value: trimmed
57
118
  });
58
119
  }
59
- return parsed;
120
+ return parsed(filters);
121
+ };
122
+ const parseLimit = (params) => {
123
+ const raw = readParam(params, "limit");
124
+ if (raw === null) return parsed(50);
125
+ if (!/^\d+$/.test(raw)) return fail("invalid_param", `limit must be an integer: ${echo(raw)}`, "limit");
126
+ const limit = Number(raw);
127
+ if (limit < 1 || limit > 500) return fail("invalid_param", `limit must be between 1 and 500`, "limit");
128
+ return parsed(limit);
129
+ };
130
+ const parseOrder = (params, metrics) => {
131
+ const raw = readParam(params, "order");
132
+ if (raw === null) return parsed(void 0);
133
+ const parts = raw.split(":");
134
+ const metric = parts[0] ?? "";
135
+ const direction = parts[1] ?? "";
136
+ if (parts.length !== 2 || direction !== "asc" && direction !== "desc") return fail("invalid_param", "order must be <metric>:<asc|desc>", "order");
137
+ if (!isOneOf(metrics, metric)) return fail("invalid_param", `order metric is not in metrics: ${echo(metric)}`, "order");
138
+ return parsed({
139
+ metric,
140
+ direction
141
+ });
142
+ };
143
+ /** The refusal of the first metric the source cannot read for a read of this shape. */
144
+ const outOfReach = (capabilities, metrics, shape) => {
145
+ for (const metric of metrics) {
146
+ const out = metricOutOfReach(capabilities, servedName(metric, capabilities.metrics), shape);
147
+ if (out !== null) return fail("unsupported_metric", "breakdown" in out ? `source does not serve ${metric} by ${out.breakdown}` : `source serves ${metric} only by ${out.needs} or filtered by it`, "metrics");
148
+ }
60
149
  };
61
150
  /**
62
- * Validate a query string against a source's serialized capabilities. Rules are evaluated
63
- * in a fixed order and the first failure wins: timezone, metrics, dimensions, from/to,
64
- * granularity, filters, limit, order, compare, path, hostname. Within each, a value
65
- * outside the contract's own union is `invalid_param` and a contract value the source
66
- * lacks is its `unsupported_*` code. Unknown parameters are ignored; `source` and `scope`
67
- * pass through unvalidated, since only the handler knows whether they are trusted.
151
+ * First failing rule wins, in a fixed order: a value outside the contract is `invalid_param`, one
152
+ * the source lacks its `unsupported_*` code; `source` and `scope` pass unvalidated.
68
153
  */
69
154
  const parseQueryParams = (params, args) => {
155
+ const { capabilities } = args;
70
156
  const rawTimezone = readParam(params, "timezone");
71
157
  if (rawTimezone !== null && !isValidTimeZone(rawTimezone)) return fail("invalid_param", `unknown timezone: ${echo(rawTimezone)}`, "timezone");
72
158
  const timezone = rawTimezone ?? args.timezone;
73
- const rawMetrics = readParam(params, "metrics");
74
- const metricList = rawMetrics ? commaList(rawMetrics) : [];
75
- if (metricList.length === 0) return fail("invalid_param", "metrics is required", "metrics");
76
- const unknownMetric = metricList.find((m) => !KNOWN_METRICS.has(m));
77
- if (unknownMetric !== void 0) return fail("invalid_param", `unknown metric: ${echo(unknownMetric)}`, "metrics");
78
- const metrics = dedupe(metricList);
79
- if (metrics.length > 10) return fail("invalid_param", `at most 10 metrics are allowed`, "metrics");
80
- const servedMetrics = new Set(args.capabilities.metrics);
81
- const unsupportedMetric = metrics.find((m) => !servedMetrics.has(m));
82
- if (unsupportedMetric !== void 0) return fail("unsupported_metric", `source does not serve ${unsupportedMetric}`, "metrics");
83
- const rawDimensions = readParam(params, "dimensions");
84
- const dimensionList = rawDimensions ? commaList(rawDimensions) : [];
85
- const unknownDimension = dimensionList.find((d) => !KNOWN_DIMENSIONS.has(d));
86
- if (unknownDimension !== void 0) return fail("invalid_param", `unknown dimension: ${echo(unknownDimension)}`, "dimensions");
87
- const dimensions = dedupe(dimensionList);
88
- if (dimensions.length > 2) return fail("invalid_param", `at most 2 dimensions are allowed`, "dimensions");
89
- const servedDimensions = new Set(args.capabilities.dimensions);
90
- const unsupportedDimension = dimensions.find((d) => !servedDimensions.has(d));
91
- if (unsupportedDimension !== void 0) return fail("unsupported_dimension", `source does not break down by ${unsupportedDimension}`, "dimensions");
92
- const rawFrom = readParam(params, "from");
93
- const rawTo = readParam(params, "to");
94
- if (!rawFrom) return fail("invalid_param", "from is required", "from");
95
- const start = parseDayOrInstant(rawFrom, {
96
- timezone,
97
- edge: "start"
98
- });
99
- if (!start) return fail("invalid_param", `from is not a date: ${echo(rawFrom)}`, "from");
100
- if (!rawTo) return fail("invalid_param", "to is required", "to");
101
- const end = parseDayOrInstant(rawTo, {
102
- timezone,
103
- edge: "end"
104
- });
105
- if (!end) return fail("invalid_param", `to is not a date: ${echo(rawTo)}`, "to");
106
- if (end.getTime() < start.getTime()) return fail("invalid_param", "to must not be before from", "to");
107
- if (end.getTime() - start.getTime() > 366 * DAY_MS) return fail("range_too_long", `the range must not exceed 366 days`, "to");
108
- const rawGranularity = readParam(params, "granularity");
109
- if (rawGranularity !== null && !KNOWN_GRANULARITIES.has(rawGranularity)) return fail("invalid_param", `unknown granularity: ${echo(rawGranularity)}`, "granularity");
110
- const granularity = rawGranularity;
111
- if (granularity !== null && GRANULARITY_ORDER.indexOf(granularity) < GRANULARITY_ORDER.indexOf(args.capabilities.minGranularity)) return fail("unsupported_granularity", `source buckets no finer than ${args.capabilities.minGranularity}`, "granularity");
112
- const rawFilters = readParam(params, "filters");
113
- const filters = rawFilters === null ? [] : parseFilters(rawFilters, args.capabilities);
114
- if (!Array.isArray(filters)) return filters;
115
- const rawLimit = readParam(params, "limit");
116
- let limit = 50;
117
- if (rawLimit !== null) {
118
- if (!/^\d+$/.test(rawLimit)) return fail("invalid_param", `limit must be an integer: ${echo(rawLimit)}`, "limit");
119
- limit = Number(rawLimit);
120
- if (limit < 1 || limit > 500) return fail("invalid_param", `limit must be between 1 and 500`, "limit");
121
- }
122
- const rawOrder = readParam(params, "order");
123
- let order;
124
- if (rawOrder !== null) {
125
- const parts = rawOrder.split(":");
126
- const metric = parts[0] ?? "";
127
- const direction = parts[1] ?? "";
128
- if (parts.length !== 2 || direction !== "asc" && direction !== "desc") return fail("invalid_param", "order must be <metric>:<asc|desc>", "order");
129
- const ordered = metrics.find((m) => m === metric);
130
- if (ordered === void 0) return fail("invalid_param", `order metric is not in metrics: ${echo(metric)}`, "order");
131
- order = {
132
- metric: ordered,
133
- direction
134
- };
135
- }
159
+ const metrics = parseMetrics(params, capabilities);
160
+ if (!metrics.ok) return metrics;
161
+ const dimensions = parseDimensions(params, capabilities);
162
+ if (!dimensions.ok) return dimensions;
163
+ const range = parseRange(params, timezone);
164
+ if (!range.ok) return range;
165
+ const granularity = parseGranularity(params, capabilities);
166
+ if (!granularity.ok) return granularity;
167
+ const filters = parseFilters(params, capabilities);
168
+ if (!filters.ok) return filters;
169
+ const limit = parseLimit(params);
170
+ if (!limit.ok) return limit;
171
+ const order = parseOrder(params, metrics.value);
172
+ if (!order.ok) return order;
136
173
  const rawCompare = readParam(params, "compare");
137
174
  if (rawCompare !== null && rawCompare !== "previous") return fail("invalid_param", `compare must be "previous": ${echo(rawCompare)}`, "compare");
138
- if (rawCompare === "previous" && !args.capabilities.comparison) return fail("invalid_param", "source does not support comparison", "compare");
175
+ if (rawCompare === "previous" && !capabilities.comparison) return fail("invalid_param", "source does not support comparison", "compare");
139
176
  const path = readParam(params, "path");
140
177
  if (path !== null && path.length > 512) return fail("invalid_param", `path must be at most 512 characters`, "path");
141
178
  const hostname = readParam(params, "hostname");
142
179
  if (hostname !== null && hostname.length > 253) return fail("invalid_param", `hostname must be at most 253 characters`, "hostname");
180
+ const item = readParam(params, "item");
181
+ if (item !== null && parseItemRef(item) === null) return fail("invalid_param", `item must be a <collection>:<id> ref: ${echo(item)}`, "item");
182
+ if (item !== null && capabilities.perItemQuery !== true) return fail("invalid_param", "source cannot read one item", "item");
183
+ const unreachable = outOfReach(capabilities, metrics.value, {
184
+ dimensions: dimensions.value,
185
+ filters: filters.value,
186
+ path: path !== null
187
+ });
188
+ if (unreachable) return unreachable;
189
+ const rawTimeframe = readParam(params, "timeframe");
190
+ if (rawTimeframe !== null && !isTimeframePreset(rawTimeframe)) return fail("invalid_param", `timeframe must be one of ${TIMEFRAME_PRESETS.join(", ")}: ${echo(rawTimeframe)}`, "timeframe");
143
191
  return {
144
192
  ok: true,
145
193
  value: {
146
194
  query: {
147
- metrics,
148
- dateRange: {
149
- start,
150
- end
151
- },
152
- limit,
195
+ metrics: metrics.value,
196
+ dateRange: range.value,
197
+ limit: limit.value,
153
198
  timezone,
154
- ...dimensions.length > 0 ? { dimensions } : {},
155
- ...granularity !== null ? { granularity } : {},
156
- ...filters.length > 0 ? { filters } : {},
157
- ...order ? { order } : {},
199
+ ...dimensions.value.length > 0 ? { dimensions: dimensions.value } : {},
200
+ ...granularity.value !== null ? { granularity: granularity.value } : {},
201
+ ...filters.value.length > 0 ? { filters: filters.value } : {},
202
+ ...order.value ? { order: order.value } : {},
158
203
  ...path !== null ? { path } : {},
159
- ...hostname !== null ? { hostname } : {}
204
+ ...hostname !== null ? { hostname } : {},
205
+ ...item !== null ? { item } : {}
160
206
  },
161
- compare: rawCompare === "previous" ? "previous" : null
207
+ compare: rawCompare === "previous" ? "previous" : null,
208
+ timeframe: isTimeframePreset(rawTimeframe) ? rawTimeframe : null
162
209
  }
163
210
  };
164
211
  };
165
212
  //#endregion
166
- export { parseQueryParams, readParam };
213
+ export { parseQueryParams, readDimensionList, readParam };
167
214
 
168
215
  //# sourceMappingURL=parse.js.map