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

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 (1241) hide show
  1. package/CHANGELOG.md +463 -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 +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  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 +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  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 +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  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 +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  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 +100 -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 +193 -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 +26 -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 +285 -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 +473 -157
  159. package/dist/core/options.js +154 -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 +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  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/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -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
@@ -1 +1 @@
1
- {"version":3,"file":"parse.js","names":[],"sources":["../../src/query/parse.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport {\n\ttype AnalyticsFilter,\n\ttype AnalyticsQuery,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype Granularity,\n\ttype MetricKey,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport { type AnalyticsError, analyticsError } from '../plugin/errors'\nimport { isValidTimeZone } from '../timeframe/tz'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport { parseDayOrInstant } from './dates'\nimport {\n\tDEFAULT_QUERY_LIMIT,\n\tMAX_QUERY_DIMENSIONS,\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_HOSTNAME_LENGTH,\n\tMAX_QUERY_LIMIT,\n\tMAX_QUERY_METRICS,\n\tMAX_QUERY_PATH_LENGTH,\n\tMAX_QUERY_RANGE_DAYS,\n\tMIN_QUERY_LIMIT,\n} from './limits'\n\n/**\n * A validated read request. `source` and `scope` are absent by design: the handler must\n * resolve both before the parser can run, and reads them itself through {@link readParam}.\n */\nexport interface ParsedQuery {\n\tquery: AnalyticsQuery\n\tcompare: 'previous' | null\n}\n\nexport type ParseResult = { ok: true; value: ParsedQuery } | { ok: false; error: AnalyticsError }\n\nexport interface ParseQueryArgs {\n\tcapabilities: SerializedCapabilities\n\t/** Reporting timezone the plugin resolved for this request; the `timezone` param overrides it. */\n\ttimezone: string\n}\n\nconst KNOWN_METRICS = new Set<string>(Object.keys(METRIC_KEYS))\nconst KNOWN_DIMENSIONS = new Set<string>(DIMENSION_KEYS)\nconst KNOWN_OPERATORS = new Set<string>(FILTER_OPERATORS)\nconst KNOWN_GRANULARITIES = new Set<string>(GRANULARITY_ORDER)\nconst DAY_MS = 86_400_000\n\nconst fail = (code: AnalyticsError['code'], message: string, param: string): ParseResult => ({\n\tok: false,\n\terror: analyticsError(code, message, param),\n})\n\n/** Echo a rejected value back in a message without letting a caller inflate the response. */\nconst echo = (value: string): string => (value.length > 40 ? `${value.slice(0, 40)}...` : value)\n\n/**\n * A trimmed non-empty parameter, or null when absent or blank. Exported so the handler\n * reads `source` and `scope` (which it must resolve before the parser can run) exactly\n * the way the parser reads everything else.\n */\nexport const readParam = (params: URLSearchParams, name: string): string | null => {\n\tconst raw = params.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\nconst commaList = (raw: string): string[] =>\n\traw\n\t\t.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\nconst dedupe = <T extends string>(values: T[]): T[] => [...new Set(values)]\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst parseFilters = (\n\traw: string,\n\tcapabilities: SerializedCapabilities\n): AnalyticsFilter[] | ParseResult => {\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (decoded.length > MAX_QUERY_FILTERS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_FILTERS} filters are allowed`, 'filters')\n\t}\n\tconst filterable = new Set<string>(capabilities.filters)\n\tconst operators = new Set<string>(capabilities.filterOperators)\n\tconst parsed: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (!isRecord(item)) {\n\t\t\treturn fail('invalid_param', 'each filter must be an object', 'filters')\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (typeof dimension !== 'string' || !KNOWN_DIMENSIONS.has(dimension)) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`unknown filter dimension: ${echo(String(dimension))}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (typeof operator !== 'string' || !KNOWN_OPERATORS.has(operator)) {\n\t\t\treturn fail('invalid_param', `unknown filter operator: ${echo(String(operator))}`, 'filters')\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\treturn fail('invalid_param', 'each filter value must be a string', 'filters')\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`each filter value must be 1 to ${MAX_QUERY_FILTER_VALUE_LENGTH} characters`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (!filterable.has(dimension)) {\n\t\t\treturn fail('unsupported_filter', `source cannot filter on ${dimension}`, 'filters')\n\t\t}\n\t\tif (!operators.has(operator)) {\n\t\t\treturn fail('unsupported_operator', `source does not support ${operator}`, 'filters')\n\t\t}\n\t\tparsed.push({\n\t\t\tdimension: dimension as DimensionKey,\n\t\t\toperator: operator as FilterOperator,\n\t\t\tvalue: trimmed,\n\t\t})\n\t}\n\treturn parsed\n}\n\n/**\n * Validate a query string against a source's serialized capabilities. Rules are evaluated\n * in a fixed order and the first failure wins: timezone, metrics, dimensions, from/to,\n * granularity, filters, limit, order, compare, path, hostname. Within each, a value\n * outside the contract's own union is `invalid_param` and a contract value the source\n * lacks is its `unsupported_*` code. Unknown parameters are ignored; `source` and `scope`\n * pass through unvalidated, since only the handler knows whether they are trusted.\n */\nexport const parseQueryParams = (params: URLSearchParams, args: ParseQueryArgs): ParseResult => {\n\tconst rawTimezone = readParam(params, 'timezone')\n\tif (rawTimezone !== null && !isValidTimeZone(rawTimezone)) {\n\t\treturn fail('invalid_param', `unknown timezone: ${echo(rawTimezone)}`, 'timezone')\n\t}\n\tconst timezone = rawTimezone ?? args.timezone\n\n\tconst rawMetrics = readParam(params, 'metrics')\n\tconst metricList = rawMetrics ? commaList(rawMetrics) : []\n\tif (metricList.length === 0) {\n\t\treturn fail('invalid_param', 'metrics is required', 'metrics')\n\t}\n\tconst unknownMetric = metricList.find((m) => !KNOWN_METRICS.has(m))\n\tif (unknownMetric !== undefined) {\n\t\treturn fail('invalid_param', `unknown metric: ${echo(unknownMetric)}`, 'metrics')\n\t}\n\tconst metrics = dedupe(metricList) as MetricKey[]\n\tif (metrics.length > MAX_QUERY_METRICS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_METRICS} metrics are allowed`, 'metrics')\n\t}\n\tconst servedMetrics = new Set<string>(args.capabilities.metrics)\n\tconst unsupportedMetric = metrics.find((m) => !servedMetrics.has(m))\n\tif (unsupportedMetric !== undefined) {\n\t\treturn fail('unsupported_metric', `source does not serve ${unsupportedMetric}`, 'metrics')\n\t}\n\n\tconst rawDimensions = readParam(params, 'dimensions')\n\tconst dimensionList = rawDimensions ? commaList(rawDimensions) : []\n\tconst unknownDimension = dimensionList.find((d) => !KNOWN_DIMENSIONS.has(d))\n\tif (unknownDimension !== undefined) {\n\t\treturn fail('invalid_param', `unknown dimension: ${echo(unknownDimension)}`, 'dimensions')\n\t}\n\tconst dimensions = dedupe(dimensionList) as DimensionKey[]\n\tif (dimensions.length > MAX_QUERY_DIMENSIONS) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`at most ${MAX_QUERY_DIMENSIONS} dimensions are allowed`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\tconst servedDimensions = new Set<string>(args.capabilities.dimensions)\n\tconst unsupportedDimension = dimensions.find((d) => !servedDimensions.has(d))\n\tif (unsupportedDimension !== undefined) {\n\t\treturn fail(\n\t\t\t'unsupported_dimension',\n\t\t\t`source does not break down by ${unsupportedDimension}`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\n\tconst rawFrom = readParam(params, 'from')\n\tconst rawTo = readParam(params, 'to')\n\tif (!rawFrom) {\n\t\treturn fail('invalid_param', 'from is required', 'from')\n\t}\n\tconst start = parseDayOrInstant(rawFrom, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn fail('invalid_param', `from is not a date: ${echo(rawFrom)}`, 'from')\n\t}\n\tif (!rawTo) {\n\t\treturn fail('invalid_param', 'to is required', 'to')\n\t}\n\tconst end = parseDayOrInstant(rawTo, { timezone, edge: 'end' })\n\tif (!end) {\n\t\treturn fail('invalid_param', `to is not a date: ${echo(rawTo)}`, 'to')\n\t}\n\tif (end.getTime() < start.getTime()) {\n\t\treturn fail('invalid_param', 'to must not be before from', 'to')\n\t}\n\tif (end.getTime() - start.getTime() > MAX_QUERY_RANGE_DAYS * DAY_MS) {\n\t\treturn fail('range_too_long', `the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`, 'to')\n\t}\n\n\tconst rawGranularity = readParam(params, 'granularity')\n\tif (rawGranularity !== null && !KNOWN_GRANULARITIES.has(rawGranularity)) {\n\t\treturn fail('invalid_param', `unknown granularity: ${echo(rawGranularity)}`, 'granularity')\n\t}\n\tconst granularity = rawGranularity as Granularity | null\n\tif (\n\t\tgranularity !== null &&\n\t\tGRANULARITY_ORDER.indexOf(granularity) <\n\t\t\tGRANULARITY_ORDER.indexOf(args.capabilities.minGranularity)\n\t) {\n\t\treturn fail(\n\t\t\t'unsupported_granularity',\n\t\t\t`source buckets no finer than ${args.capabilities.minGranularity}`,\n\t\t\t'granularity'\n\t\t)\n\t}\n\n\tconst rawFilters = readParam(params, 'filters')\n\tconst filters = rawFilters === null ? [] : parseFilters(rawFilters, args.capabilities)\n\tif (!Array.isArray(filters)) {\n\t\treturn filters\n\t}\n\n\tconst rawLimit = readParam(params, 'limit')\n\tlet limit = DEFAULT_QUERY_LIMIT\n\tif (rawLimit !== null) {\n\t\tif (!/^\\d+$/.test(rawLimit)) {\n\t\t\treturn fail('invalid_param', `limit must be an integer: ${echo(rawLimit)}`, 'limit')\n\t\t}\n\t\tlimit = Number(rawLimit)\n\t\tif (limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`,\n\t\t\t\t'limit'\n\t\t\t)\n\t\t}\n\t}\n\n\tconst rawOrder = readParam(params, 'order')\n\tlet order: AnalyticsQuery['order']\n\tif (rawOrder !== null) {\n\t\tconst parts = rawOrder.split(':')\n\t\tconst metric = parts[0] ?? ''\n\t\tconst direction = parts[1] ?? ''\n\t\tif (parts.length !== 2 || (direction !== 'asc' && direction !== 'desc')) {\n\t\t\treturn fail('invalid_param', 'order must be <metric>:<asc|desc>', 'order')\n\t\t}\n\t\tconst ordered = metrics.find((m) => m === metric)\n\t\tif (ordered === undefined) {\n\t\t\treturn fail('invalid_param', `order metric is not in metrics: ${echo(metric)}`, 'order')\n\t\t}\n\t\torder = { metric: ordered, direction }\n\t}\n\n\tconst rawCompare = readParam(params, 'compare')\n\tif (rawCompare !== null && rawCompare !== 'previous') {\n\t\treturn fail('invalid_param', `compare must be \"previous\": ${echo(rawCompare)}`, 'compare')\n\t}\n\tif (rawCompare === 'previous' && !args.capabilities.comparison) {\n\t\treturn fail('invalid_param', 'source does not support comparison', 'compare')\n\t}\n\n\tconst path = readParam(params, 'path')\n\tif (path !== null && path.length > MAX_QUERY_PATH_LENGTH) {\n\t\treturn fail('invalid_param', `path must be at most ${MAX_QUERY_PATH_LENGTH} characters`, 'path')\n\t}\n\tconst hostname = readParam(params, 'hostname')\n\tif (hostname !== null && hostname.length > MAX_QUERY_HOSTNAME_LENGTH) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`hostname must be at most ${MAX_QUERY_HOSTNAME_LENGTH} characters`,\n\t\t\t'hostname'\n\t\t)\n\t}\n\n\tconst query: AnalyticsQuery = {\n\t\tmetrics,\n\t\tdateRange: { start, end },\n\t\tlimit,\n\t\ttimezone,\n\t\t...(dimensions.length > 0 ? { dimensions } : {}),\n\t\t...(granularity !== null ? { granularity } : {}),\n\t\t...(filters.length > 0 ? { filters } : {}),\n\t\t...(order ? { order } : {}),\n\t\t...(path !== null ? { path } : {}),\n\t\t...(hostname !== null ? { hostname } : {}),\n\t}\n\treturn {\n\t\tok: true,\n\t\tvalue: { query, compare: rawCompare === 'previous' ? 'previous' : null },\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"parse.js","names":[],"sources":["../../src/query/parse.ts"],"sourcesContent":["import {\n\tfilterOperatorsFor,\n\tmetricOutOfReach,\n\ttype SerializedCapabilities,\n} from '../core/capabilities'\nimport type {\n\tAnalyticsFilter,\n\tAnalyticsQuery,\n\tDateRange,\n\tDimensionKey,\n\tGranularity,\n\tMetricKey,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { isDimensionKey, isFilterOperator, isGranularity, isMetricKey } from '../core/guards'\nimport { servedName } from '../core/metricAliases'\nimport { isOneOf, isRecord } from '../core/values'\nimport { parseItemRef } from '../items/ref'\nimport { type AnalyticsError, analyticsError } from '../plugin/errors'\nimport { isTimeframePreset, TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { isValidTimeZone } from '../timeframe/tz'\nimport { parseDayOrInstant } from './dates'\nimport {\n\tDEFAULT_QUERY_LIMIT,\n\texceedsRangeCap,\n\tMAX_QUERY_DIMENSIONS,\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_HOSTNAME_LENGTH,\n\tMAX_QUERY_LIMIT,\n\tMAX_QUERY_METRICS,\n\tMAX_QUERY_PATH_LENGTH,\n\tMAX_QUERY_RANGE_DAYS,\n\tMIN_QUERY_LIMIT,\n} from './limits'\n\n/**\n * A validated read request. `source` and `scope` are absent by design: the handler must\n * resolve both before the parser can run, and reads them itself through {@link readParam}.\n */\nexport interface ParsedQuery {\n\tquery: AnalyticsQuery\n\tcompare: 'previous' | null\n\t/**\n\t * The named timeframe the caller resolved `from` and `to` from, which lets the read be stored\n\t * for the warm task to repeat; null when the caller named none.\n\t */\n\ttimeframe: TimeframePreset | null\n}\n\nexport type ParseResult = { ok: true; value: ParsedQuery } | { ok: false; error: AnalyticsError }\n\ninterface ParseQueryArgs {\n\tcapabilities: SerializedCapabilities\n\t/** Reporting timezone the plugin resolved for this request; the `timezone` param overrides it. */\n\ttimezone: string\n}\n\ntype Failure = Extract<ParseResult, { ok: false }>\n\n/** One parameter's parsed value, or the failure that ends the parse. */\ntype Parsed<T> = { ok: true; value: T } | Failure\n\nconst parsed = <T>(value: T): Parsed<T> => ({ ok: true, value })\n\nconst fail = (code: AnalyticsError['code'], message: string, param: string): Failure => ({\n\tok: false,\n\terror: analyticsError(code, message, param),\n})\n\n/** Echo a rejected value back in a message without letting a caller inflate the response. */\nconst echo = (value: string): string => (value.length > 40 ? `${value.slice(0, 40)}...` : value)\n\n/**\n * A trimmed non-empty parameter, or null. Exported so the handler reads `source` and `scope`\n * exactly as the parser reads everything else.\n */\nexport const readParam = (params: URLSearchParams, name: string): string | null => {\n\tconst raw = params.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\nconst commaList = (raw: string): string[] =>\n\traw\n\t\t.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\nconst dedupe = <T extends string>(values: T[]): T[] => [...new Set(values)]\n\n/**\n * Dimension list as the query parser reads it, for callers outside the query endpoint (document\n * panel). Unknown names are dropped, not refused: the caller wants blocks to draw, not an error.\n */\nexport const readDimensionList = (\n\traw: string | null,\n\tmax: number = MAX_QUERY_DIMENSIONS\n): DimensionKey[] => dedupe(commaList(raw ?? '').filter(isDimensionKey)).slice(0, max)\n\nconst parseMetrics = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<MetricKey[]> => {\n\tconst listed = commaList(readParam(params, 'metrics') ?? '')\n\tif (listed.length === 0) {\n\t\treturn fail('invalid_param', 'metrics is required', 'metrics')\n\t}\n\tconst unknown = listed.find((m) => !isMetricKey(m))\n\tif (unknown !== undefined) {\n\t\treturn fail('invalid_param', `unknown metric: ${echo(unknown)}`, 'metrics')\n\t}\n\tconst metrics = dedupe(listed.filter(isMetricKey))\n\tif (metrics.length > MAX_QUERY_METRICS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_METRICS} metrics are allowed`, 'metrics')\n\t}\n\t// A source serving one of `visits` and `sessions` answers the other under the name asked for.\n\tconst unsupported = metrics.find(\n\t\t(m) => !capabilities.metrics.includes(servedName(m, capabilities.metrics))\n\t)\n\tif (unsupported !== undefined) {\n\t\treturn fail('unsupported_metric', `source does not serve ${unsupported}`, 'metrics')\n\t}\n\treturn parsed(metrics)\n}\n\nconst parseDimensions = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<DimensionKey[]> => {\n\tconst listed = commaList(readParam(params, 'dimensions') ?? '')\n\tconst unknown = listed.find((d) => !isDimensionKey(d))\n\tif (unknown !== undefined) {\n\t\treturn fail('invalid_param', `unknown dimension: ${echo(unknown)}`, 'dimensions')\n\t}\n\tconst dimensions = dedupe(listed.filter(isDimensionKey))\n\tif (dimensions.length > MAX_QUERY_DIMENSIONS) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`at most ${MAX_QUERY_DIMENSIONS} dimensions are allowed`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\tconst unsupported = dimensions.find((d) => !capabilities.dimensions.includes(d))\n\tif (unsupported !== undefined) {\n\t\treturn fail(\n\t\t\t'unsupported_dimension',\n\t\t\t`source does not break down by ${unsupported}`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\treturn parsed(dimensions)\n}\n\nconst parseRange = (params: URLSearchParams, timezone: string): Parsed<DateRange> => {\n\tconst rawFrom = readParam(params, 'from')\n\tconst rawTo = readParam(params, 'to')\n\tif (!rawFrom) {\n\t\treturn fail('invalid_param', 'from is required', 'from')\n\t}\n\tconst start = parseDayOrInstant(rawFrom, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn fail('invalid_param', `from is not a date: ${echo(rawFrom)}`, 'from')\n\t}\n\tif (!rawTo) {\n\t\treturn fail('invalid_param', 'to is required', 'to')\n\t}\n\tconst end = parseDayOrInstant(rawTo, { timezone, edge: 'end' })\n\tif (!end) {\n\t\treturn fail('invalid_param', `to is not a date: ${echo(rawTo)}`, 'to')\n\t}\n\tif (end.getTime() < start.getTime()) {\n\t\treturn fail('invalid_param', 'to must not be before from', 'to')\n\t}\n\tif (exceedsRangeCap({ start, end })) {\n\t\treturn fail('range_too_long', `the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`, 'to')\n\t}\n\treturn parsed({ start, end })\n}\n\nconst parseGranularity = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<Granularity | null> => {\n\tconst raw = readParam(params, 'granularity')\n\tif (raw === null) {\n\t\treturn parsed(null)\n\t}\n\tif (!isGranularity(raw)) {\n\t\treturn fail('invalid_param', `unknown granularity: ${echo(raw)}`, 'granularity')\n\t}\n\tif (!supportsGranularity(capabilities, raw)) {\n\t\treturn fail(\n\t\t\t'unsupported_granularity',\n\t\t\t`source buckets no finer than ${capabilities.minGranularity}`,\n\t\t\t'granularity'\n\t\t)\n\t}\n\treturn parsed(raw)\n}\n\nconst parseFilters = (\n\tparams: URLSearchParams,\n\tcapabilities: SerializedCapabilities\n): Parsed<AnalyticsFilter[]> => {\n\tconst raw = readParam(params, 'filters')\n\tif (raw === null) {\n\t\treturn parsed([])\n\t}\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (decoded.length > MAX_QUERY_FILTERS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_FILTERS} filters are allowed`, 'filters')\n\t}\n\tconst filters: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (!isRecord(item) || Array.isArray(item)) {\n\t\t\treturn fail('invalid_param', 'each filter must be an object', 'filters')\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (!isDimensionKey(dimension)) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`unknown filter dimension: ${echo(String(dimension))}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (!isFilterOperator(operator)) {\n\t\t\treturn fail('invalid_param', `unknown filter operator: ${echo(String(operator))}`, 'filters')\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\treturn fail('invalid_param', 'each filter value must be a string', 'filters')\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`each filter value must be 1 to ${MAX_QUERY_FILTER_VALUE_LENGTH} characters`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\t// Per pair, not per list: a source can take `contains` on one dimension and not another.\n\t\tconst offered = filterOperatorsFor(capabilities, dimension)\n\t\tif (offered.length === 0) {\n\t\t\treturn fail('unsupported_filter', `source cannot filter on ${dimension}`, 'filters')\n\t\t}\n\t\tif (!offered.includes(operator)) {\n\t\t\treturn fail(\n\t\t\t\t'unsupported_operator',\n\t\t\t\t`source cannot filter ${dimension} with ${operator}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tfilters.push({ dimension, operator, value: trimmed })\n\t}\n\treturn parsed(filters)\n}\n\nconst parseLimit = (params: URLSearchParams): Parsed<number> => {\n\tconst raw = readParam(params, 'limit')\n\tif (raw === null) {\n\t\treturn parsed(DEFAULT_QUERY_LIMIT)\n\t}\n\tif (!/^\\d+$/.test(raw)) {\n\t\treturn fail('invalid_param', `limit must be an integer: ${echo(raw)}`, 'limit')\n\t}\n\tconst limit = Number(raw)\n\tif (limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`,\n\t\t\t'limit'\n\t\t)\n\t}\n\treturn parsed(limit)\n}\n\nconst parseOrder = (\n\tparams: URLSearchParams,\n\tmetrics: readonly MetricKey[]\n): Parsed<AnalyticsQuery['order']> => {\n\tconst raw = readParam(params, 'order')\n\tif (raw === null) {\n\t\treturn parsed(undefined)\n\t}\n\tconst parts = raw.split(':')\n\tconst metric = parts[0] ?? ''\n\tconst direction = parts[1] ?? ''\n\tif (parts.length !== 2 || (direction !== 'asc' && direction !== 'desc')) {\n\t\treturn fail('invalid_param', 'order must be <metric>:<asc|desc>', 'order')\n\t}\n\tif (!isOneOf(metrics, metric)) {\n\t\treturn fail('invalid_param', `order metric is not in metrics: ${echo(metric)}`, 'order')\n\t}\n\treturn parsed({ metric, direction })\n}\n\n/** The refusal of the first metric the source cannot read for a read of this shape. */\nconst outOfReach = (\n\tcapabilities: SerializedCapabilities,\n\tmetrics: readonly MetricKey[],\n\tshape: { dimensions: DimensionKey[]; filters: AnalyticsFilter[]; path: boolean }\n): Failure | undefined => {\n\tfor (const metric of metrics) {\n\t\tconst out = metricOutOfReach(capabilities, servedName(metric, capabilities.metrics), shape)\n\t\tif (out !== null) {\n\t\t\treturn fail(\n\t\t\t\t'unsupported_metric',\n\t\t\t\t'breakdown' in out\n\t\t\t\t\t? `source does not serve ${metric} by ${out.breakdown}`\n\t\t\t\t\t: `source serves ${metric} only by ${out.needs} or filtered by it`,\n\t\t\t\t'metrics'\n\t\t\t)\n\t\t}\n\t}\n\treturn undefined\n}\n\n/**\n * First failing rule wins, in a fixed order: a value outside the contract is `invalid_param`, one\n * the source lacks its `unsupported_*` code; `source` and `scope` pass unvalidated.\n */\nexport const parseQueryParams = (params: URLSearchParams, args: ParseQueryArgs): ParseResult => {\n\tconst { capabilities } = args\n\tconst rawTimezone = readParam(params, 'timezone')\n\tif (rawTimezone !== null && !isValidTimeZone(rawTimezone)) {\n\t\treturn fail('invalid_param', `unknown timezone: ${echo(rawTimezone)}`, 'timezone')\n\t}\n\tconst timezone = rawTimezone ?? args.timezone\n\tconst metrics = parseMetrics(params, capabilities)\n\tif (!metrics.ok) {\n\t\treturn metrics\n\t}\n\tconst dimensions = parseDimensions(params, capabilities)\n\tif (!dimensions.ok) {\n\t\treturn dimensions\n\t}\n\tconst range = parseRange(params, timezone)\n\tif (!range.ok) {\n\t\treturn range\n\t}\n\tconst granularity = parseGranularity(params, capabilities)\n\tif (!granularity.ok) {\n\t\treturn granularity\n\t}\n\tconst filters = parseFilters(params, capabilities)\n\tif (!filters.ok) {\n\t\treturn filters\n\t}\n\tconst limit = parseLimit(params)\n\tif (!limit.ok) {\n\t\treturn limit\n\t}\n\tconst order = parseOrder(params, metrics.value)\n\tif (!order.ok) {\n\t\treturn order\n\t}\n\n\tconst rawCompare = readParam(params, 'compare')\n\tif (rawCompare !== null && rawCompare !== 'previous') {\n\t\treturn fail('invalid_param', `compare must be \"previous\": ${echo(rawCompare)}`, 'compare')\n\t}\n\tif (rawCompare === 'previous' && !capabilities.comparison) {\n\t\treturn fail('invalid_param', 'source does not support comparison', 'compare')\n\t}\n\n\tconst path = readParam(params, 'path')\n\tif (path !== null && path.length > MAX_QUERY_PATH_LENGTH) {\n\t\treturn fail('invalid_param', `path must be at most ${MAX_QUERY_PATH_LENGTH} characters`, 'path')\n\t}\n\tconst hostname = readParam(params, 'hostname')\n\tif (hostname !== null && hostname.length > MAX_QUERY_HOSTNAME_LENGTH) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`hostname must be at most ${MAX_QUERY_HOSTNAME_LENGTH} characters`,\n\t\t\t'hostname'\n\t\t)\n\t}\n\n\tconst item = readParam(params, 'item')\n\tif (item !== null && parseItemRef(item) === null) {\n\t\treturn fail('invalid_param', `item must be a <collection>:<id> ref: ${echo(item)}`, 'item')\n\t}\n\tif (item !== null && capabilities.perItemQuery !== true) {\n\t\treturn fail('invalid_param', 'source cannot read one item', 'item')\n\t}\n\n\tconst unreachable = outOfReach(capabilities, metrics.value, {\n\t\tdimensions: dimensions.value,\n\t\tfilters: filters.value,\n\t\tpath: path !== null,\n\t})\n\tif (unreachable) {\n\t\treturn unreachable\n\t}\n\n\tconst rawTimeframe = readParam(params, 'timeframe')\n\tif (rawTimeframe !== null && !isTimeframePreset(rawTimeframe)) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`timeframe must be one of ${TIMEFRAME_PRESETS.join(', ')}: ${echo(rawTimeframe)}`,\n\t\t\t'timeframe'\n\t\t)\n\t}\n\n\tconst query: AnalyticsQuery = {\n\t\tmetrics: metrics.value,\n\t\tdateRange: range.value,\n\t\tlimit: limit.value,\n\t\ttimezone,\n\t\t...(dimensions.value.length > 0 ? { dimensions: dimensions.value } : {}),\n\t\t...(granularity.value !== null ? { granularity: granularity.value } : {}),\n\t\t...(filters.value.length > 0 ? { filters: filters.value } : {}),\n\t\t...(order.value ? { order: order.value } : {}),\n\t\t...(path !== null ? { path } : {}),\n\t\t...(hostname !== null ? { hostname } : {}),\n\t\t...(item !== null ? { item } : {}),\n\t}\n\treturn {\n\t\tok: true,\n\t\tvalue: {\n\t\t\tquery,\n\t\t\tcompare: rawCompare === 'previous' ? 'previous' : null,\n\t\t\ttimeframe: isTimeframePreset(rawTimeframe) ? rawTimeframe : null,\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -10,6 +10,11 @@ interface QuerySourceRef {
10
10
  /** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */
11
11
  kind: 'config' | 'runtime';
12
12
  }
13
+ /**
14
+ * What each content item a read names is called, keyed by its ref: the document's title as the
15
+ * reader may see it, or `null` for one that is removed, hidden from them or not an item at all.
16
+ */
17
+ type ItemLabels = Record<string, string | null>;
13
18
  /** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */
14
19
  type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {
15
20
  dateRange: {
@@ -17,7 +22,7 @@ type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {
17
22
  end: string;
18
23
  };
19
24
  };
20
- /** Successful answer of `GET /analytics/query`. */
25
+ /** Successful answer of the query endpoint (`GET <routes.api><routes.base>/query`). */
21
26
  interface QueryResponse {
22
27
  result: AnalyticsResult;
23
28
  /**
@@ -25,15 +30,30 @@ interface QueryResponse {
25
30
  * Omitted when the source does not compare or that window is beyond its lookback.
26
31
  */
27
32
  comparison?: AnalyticsResult;
33
+ /**
34
+ * ISO 4217 code of the read's revenue: the install's `revenue.currency`, or the code `currency`
35
+ * is filtered to, counted as sent. Absent means revenue is a plain number.
36
+ */
37
+ currency?: string;
28
38
  source: QuerySourceRef;
29
39
  capabilities: SerializedCapabilities;
30
40
  /** The query after validation and defaulting, so a client renders what it actually got. */
31
41
  query: SerializedAnalyticsQuery;
42
+ /**
43
+ * Slugs in `query.goalSlugs` the install never declared (latent built-in `purchase`); a report
44
+ * hides such a row until it converts and never counts it as the install having goals.
45
+ */
46
+ builtinGoalSlugs?: string[];
47
+ /**
48
+ * Titles for every item ref the read names (in its rows, its filters, or `query.item`), read
49
+ * with the caller's own access. Absent when it names none.
50
+ */
51
+ itemLabels?: ItemLabels;
32
52
  }
33
- /** Every non-2xx answer of `GET /analytics/query`. */
53
+ /** Every non-2xx answer of the query endpoint. */
34
54
  interface QueryErrorResponse {
35
55
  error: QueryError;
36
56
  }
37
57
  //#endregion
38
- export { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery };
58
+ export { ItemLabels, QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery };
39
59
  //# sourceMappingURL=response.d.ts.map
@@ -1,11 +1,18 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { hasNoDeclaredGoals } from "../goals/latent.js";
1
3
  //#region src/query/response.ts
2
4
  /**
3
- * Whether the echoed query asked about goals and the scope configured none. The hint is
4
- * set only for a goal read, so an empty list is a scope with nothing to convert on: an
5
- * empty table rather than a source that could not answer, which is `meta.goalsUnresolved`.
5
+ * Whether a goal read found no declared goals in scope: an empty table, unlike a source that could
6
+ * not answer (`meta.goalsUnresolved`).
6
7
  */
7
- const askedAboutNoGoals = (query) => Array.isArray(query?.goalSlugs) && query.goalSlugs.length === 0;
8
+ const askedAboutNoGoals = (response) => {
9
+ const slugs = response?.query?.goalSlugs;
10
+ return Array.isArray(slugs) && hasNoDeclaredGoals(slugs, response?.builtinGoalSlugs);
11
+ };
12
+ const isResult = (value) => isRecord(value) && Array.isArray(value.rows) && value.rows.every((row) => isRecord(row) && isRecord(row.metrics)) && isRecord(value.meta) && typeof value.meta.provider === "string";
13
+ /** The parts of an answer every surface reads before it renders: the rows, their source, the query. */
14
+ const isQueryResponse = (value) => isRecord(value) && isResult(value.result) && (value.comparison === void 0 || isResult(value.comparison)) && isRecord(value.source) && typeof value.source.id === "string" && isRecord(value.capabilities) && isRecord(value.query) && Array.isArray(value.query.metrics);
8
15
  //#endregion
9
- export { askedAboutNoGoals };
16
+ export { askedAboutNoGoals, isQueryResponse };
10
17
 
11
18
  //# sourceMappingURL=response.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"response.js","names":[],"sources":["../../src/query/response.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport type { AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport type { QueryError } from './errors'\n\n/** Identity of the source a read was served by; its capabilities travel beside it. */\nexport interface QuerySourceRef {\n\tid: string\n\tlabel: string\n\t/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */\n\tkind: 'config' | 'runtime'\n}\n\n/** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */\nexport type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {\n\tdateRange: { start: string; end: string }\n}\n\n/** Successful answer of `GET /analytics/query`. */\nexport interface QueryResponse {\n\tresult: AnalyticsResult\n\t/**\n\t * The equal-length window before `query.dateRange`, asked for with `compare=previous`.\n\t * Omitted when the source does not compare or that window is beyond its lookback.\n\t */\n\tcomparison?: AnalyticsResult\n\tsource: QuerySourceRef\n\tcapabilities: SerializedCapabilities\n\t/** The query after validation and defaulting, so a client renders what it actually got. */\n\tquery: SerializedAnalyticsQuery\n}\n\n/**\n * Whether the echoed query asked about goals and the scope configured none. The hint is\n * set only for a goal read, so an empty list is a scope with nothing to convert on: an\n * empty table rather than a source that could not answer, which is `meta.goalsUnresolved`.\n */\nexport const askedAboutNoGoals = (query?: SerializedAnalyticsQuery): boolean =>\n\tArray.isArray(query?.goalSlugs) && query.goalSlugs.length === 0\n\n/** Every non-2xx answer of `GET /analytics/query`. */\nexport interface QueryErrorResponse {\n\terror: QueryError\n}\n"],"mappings":";;;;;;AAoCA,MAAa,qBAAqB,UACjC,MAAM,QAAQ,OAAO,SAAS,KAAK,MAAM,UAAU,WAAW"}
1
+ {"version":3,"file":"response.js","names":[],"sources":["../../src/query/response.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport type { AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { isRecord } from '../core/values'\nimport { hasNoDeclaredGoals } from '../goals/latent'\nimport type { QueryError } from './errors'\n\n/** Identity of the source a read was served by; its capabilities travel beside it. */\nexport interface QuerySourceRef {\n\tid: string\n\tlabel: string\n\t/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */\n\tkind: 'config' | 'runtime'\n}\n\n/**\n * What each content item a read names is called, keyed by its ref: the document's title as the\n * reader may see it, or `null` for one that is removed, hidden from them or not an item at all.\n */\nexport type ItemLabels = Record<string, string | null>\n\n/** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */\nexport type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {\n\tdateRange: { start: string; end: string }\n}\n\n/** Successful answer of the query endpoint (`GET <routes.api><routes.base>/query`). */\nexport interface QueryResponse {\n\tresult: AnalyticsResult\n\t/**\n\t * The equal-length window before `query.dateRange`, asked for with `compare=previous`.\n\t * Omitted when the source does not compare or that window is beyond its lookback.\n\t */\n\tcomparison?: AnalyticsResult\n\t/**\n\t * ISO 4217 code of the read's revenue: the install's `revenue.currency`, or the code `currency`\n\t * is filtered to, counted as sent. Absent means revenue is a plain number.\n\t */\n\tcurrency?: string\n\tsource: QuerySourceRef\n\tcapabilities: SerializedCapabilities\n\t/** The query after validation and defaulting, so a client renders what it actually got. */\n\tquery: SerializedAnalyticsQuery\n\t/**\n\t * Slugs in `query.goalSlugs` the install never declared (latent built-in `purchase`); a report\n\t * hides such a row until it converts and never counts it as the install having goals.\n\t */\n\tbuiltinGoalSlugs?: string[]\n\t/**\n\t * Titles for every item ref the read names (in its rows, its filters, or `query.item`), read\n\t * with the caller's own access. Absent when it names none.\n\t */\n\titemLabels?: ItemLabels\n}\n\n/**\n * Whether a goal read found no declared goals in scope: an empty table, unlike a source that could\n * not answer (`meta.goalsUnresolved`).\n */\nexport const askedAboutNoGoals = (\n\tresponse?: Pick<QueryResponse, 'builtinGoalSlugs'> & { query?: SerializedAnalyticsQuery }\n): boolean => {\n\tconst slugs = response?.query?.goalSlugs\n\treturn Array.isArray(slugs) && hasNoDeclaredGoals(slugs, response?.builtinGoalSlugs)\n}\n\nconst isResult = (value: unknown): value is AnalyticsResult =>\n\tisRecord(value) &&\n\tArray.isArray(value.rows) &&\n\tvalue.rows.every((row) => isRecord(row) && isRecord(row.metrics)) &&\n\tisRecord(value.meta) &&\n\ttypeof value.meta.provider === 'string'\n\n/** The parts of an answer every surface reads before it renders: the rows, their source, the query. */\nexport const isQueryResponse = (value: unknown): value is QueryResponse =>\n\tisRecord(value) &&\n\tisResult(value.result) &&\n\t(value.comparison === undefined || isResult(value.comparison)) &&\n\tisRecord(value.source) &&\n\ttypeof value.source.id === 'string' &&\n\tisRecord(value.capabilities) &&\n\tisRecord(value.query) &&\n\tArray.isArray(value.query.metrics)\n\n/** Every non-2xx answer of the query endpoint. */\nexport interface QueryErrorResponse {\n\terror: QueryError\n}\n"],"mappings":";;;;;;;AA0DA,MAAa,qBACZ,aACa;CACb,MAAM,QAAQ,UAAU,OAAO;CAC/B,OAAO,MAAM,QAAQ,KAAK,KAAK,mBAAmB,OAAO,UAAU,gBAAgB;AACpF;AAEA,MAAM,YAAY,UACjB,SAAS,KAAK,KACd,MAAM,QAAQ,MAAM,IAAI,KACxB,MAAM,KAAK,OAAO,QAAQ,SAAS,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,KAChE,SAAS,MAAM,IAAI,KACnB,OAAO,MAAM,KAAK,aAAa;;AAGhC,MAAa,mBAAmB,UAC/B,SAAS,KAAK,KACd,SAAS,MAAM,MAAM,MACpB,MAAM,eAAe,KAAA,KAAa,SAAS,MAAM,UAAU,MAC5D,SAAS,MAAM,MAAM,KACrB,OAAO,MAAM,OAAO,OAAO,YAC3B,SAAS,MAAM,YAAY,KAC3B,SAAS,MAAM,KAAK,KACpB,MAAM,QAAQ,MAAM,MAAM,OAAO"}
@@ -1,5 +1,5 @@
1
- import { TrackerConfig } from "../capture/trackerConfig.js";
2
- import { LoadScript, Tracker } from "../tracker/types.js";
1
+ import { CaptureSlot, TrackerConfig } from "../tracker/config.js";
2
+ import { GateState, GateStatus, LoadScript, Tracker } from "../tracker/types.js";
3
3
  import { ReactElement, ReactNode } from "react";
4
4
 
5
5
  //#region src/react/AnalyticsProvider.d.ts
@@ -7,7 +7,15 @@ import { ReactElement, ReactNode } from "react";
7
7
  interface AnalyticsCommands {
8
8
  track: Tracker['track'];
9
9
  trackGoal: Tracker['trackGoal'];
10
- consent: Tracker['consent'];
10
+ /** Records a sale, with the amount that actually moved rather than the goal's own. */
11
+ purchase: Tracker['purchase'];
12
+ /** A no-op in the browser, with a development warning: refunds are server-side. */
13
+ refund: Tracker['refund'];
14
+ /**
15
+ * Opens or closes capture slots for the host's consent manager. Safe before the tracker has
16
+ * booted: the answer is kept for the window and applied at boot.
17
+ */
18
+ setGate: (state: GateState) => void;
11
19
  /** Takes this browser out of capture, or puts it back. */
12
20
  setExcluded: Tracker['exclude'];
13
21
  }
@@ -15,6 +23,8 @@ interface AnalyticsCommands {
15
23
  interface AnalyticsApi extends AnalyticsCommands {
16
24
  /** True while this browser is excluded from capture. Flipping it re-renders the caller. */
17
25
  excluded: boolean;
26
+ /** Each capture slot's gate. A change re-renders the caller. */
27
+ gate: Readonly<Record<CaptureSlot, GateStatus>>;
18
28
  }
19
29
  interface AnalyticsProviderProps {
20
30
  /** Resolved server-side by `getTrackerConfig`, or fetched from the tracker endpoint. */
@@ -22,28 +32,27 @@ interface AnalyticsProviderProps {
22
32
  children?: ReactNode;
23
33
  /** CSP nonce applied to the vendor scripts the tracker injects. */
24
34
  nonce?: string;
25
- /** Replaces script injection, for a consent manager or a framework script loader. */
35
+ /**
36
+ * Replaces script injection, for a framework script loader. A function cannot cross from a
37
+ * server component, so pass it from a client component of your own.
38
+ */
26
39
  loadScript?: LoadScript;
40
+ /** The answer the host already has at boot, as `<AnalyticsScripts gate>` takes it. */
41
+ gate?: GateState;
42
+ /** `false` injects no vendor script at all, for a consent manager that loads them itself. */
43
+ snippets?: boolean;
27
44
  }
28
45
  /**
29
- * Shares the window's tracker with the tree through `useAnalytics`. Use it when components
30
- * need to call `track`, `trackGoal`, or `consent` themselves; a page that only needs
31
- * pageviews and auto-capture can render `<AnalyticsScripts />` (which boots
32
- * `<TrackerBoot />`) and skip the provider. Rendering both is fine: the tracker is leased
33
- * from a per-window registry, so there is still only one.
34
- *
35
- * The lease is taken lazily in the browser rather than during render, so server rendering
36
- * stays inert and React's double-invoked render cannot leak a second tracker.
37
- *
38
- * Whichever component boots the tracker first owns its options, so a `nonce` or
39
- * `loadScript` passed to a provider that mounts after `<TrackerBoot />` is ignored: give
40
- * them to whatever boots first, or render only one of the two.
46
+ * Shares the window's one tracker with the tree through `useAnalytics`, leased after mount. The
47
+ * first component to boot it owns its options: after `<AnalyticsScripts />`, this one's are ignored.
41
48
  */
42
49
  declare const AnalyticsProvider: ({
43
50
  config,
44
51
  children,
45
52
  nonce,
46
- loadScript
53
+ loadScript,
54
+ gate,
55
+ snippets
47
56
  }: AnalyticsProviderProps) => ReactElement;
48
57
  //#endregion
49
58
  export { AnalyticsApi, AnalyticsCommands, AnalyticsProvider, AnalyticsProviderProps };