@10x-media/analytics 1.0.0-beta.10 → 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 (1242) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/LICENSE +21 -21
  3. package/README.md +30 -37
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +7 -9
  18. package/dist/adapters/ga4/disableKey.js.map +1 -1
  19. package/dist/adapters/ga4/eventName.d.ts +2 -8
  20. package/dist/adapters/ga4/eventName.js +2 -8
  21. package/dist/adapters/ga4/eventName.js.map +1 -1
  22. package/dist/adapters/ga4/ga4.d.ts +11 -0
  23. package/dist/adapters/ga4/ga4.js +206 -123
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +2 -3
  26. package/dist/adapters/ga4/measurementId.js.map +1 -1
  27. package/dist/adapters/goalRead.js +15 -29
  28. package/dist/adapters/goalRead.js.map +1 -1
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +13 -13
  37. package/dist/adapters/plausible/plausible.js +137 -122
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +20 -9
  42. package/dist/adapters/posthog/posthog.js +179 -113
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/readTime.js +7 -0
  45. package/dist/adapters/readTime.js.map +1 -0
  46. package/dist/adapters/series.js +14 -8
  47. package/dist/adapters/series.js.map +1 -1
  48. package/dist/adapters/umami/umami.d.ts +7 -9
  49. package/dist/adapters/umami/umami.js +184 -172
  50. package/dist/adapters/umami/umami.js.map +1 -1
  51. package/dist/adapters/upstream.js +16 -0
  52. package/dist/adapters/upstream.js.map +1 -0
  53. package/dist/binding/report.d.ts +8 -0
  54. package/dist/binding/report.js +24 -0
  55. package/dist/binding/report.js.map +1 -0
  56. package/dist/binding/resolvePath.js +16 -29
  57. package/dist/binding/resolvePath.js.map +1 -1
  58. package/dist/binding/types.d.ts +14 -29
  59. package/dist/capture/captureRequest.js +28 -0
  60. package/dist/capture/captureRequest.js.map +1 -0
  61. package/dist/capture/exclusionEndpoint.js +98 -0
  62. package/dist/capture/exclusionEndpoint.js.map +1 -0
  63. package/dist/capture/exclusionPrelude.js +14 -0
  64. package/dist/capture/exclusionPrelude.js.map +1 -0
  65. package/dist/capture/exclusionToken.js +23 -0
  66. package/dist/capture/exclusionToken.js.map +1 -0
  67. package/dist/capture/jsLiteral.js +19 -0
  68. package/dist/capture/jsLiteral.js.map +1 -0
  69. package/dist/capture/mountPath.js +2 -3
  70. package/dist/capture/mountPath.js.map +1 -1
  71. package/dist/capture/proxyEndpoint.js +48 -95
  72. package/dist/capture/proxyEndpoint.js.map +1 -1
  73. package/dist/capture/proxyRoutes.js +58 -21
  74. package/dist/capture/proxyRoutes.js.map +1 -1
  75. package/dist/capture/relay.js +91 -0
  76. package/dist/capture/relay.js.map +1 -0
  77. package/dist/capture/requestBody.js +2 -6
  78. package/dist/capture/requestBody.js.map +1 -1
  79. package/dist/capture/requestTrust.js +45 -0
  80. package/dist/capture/requestTrust.js.map +1 -0
  81. package/dist/capture/sameSite.js +40 -0
  82. package/dist/capture/sameSite.js.map +1 -0
  83. package/dist/capture/slots.js +50 -25
  84. package/dist/capture/slots.js.map +1 -1
  85. package/dist/capture/trackerConfig.js +100 -36
  86. package/dist/capture/trackerConfig.js.map +1 -1
  87. package/dist/capture/trackerEndpoint.js +22 -21
  88. package/dist/capture/trackerEndpoint.js.map +1 -1
  89. package/dist/charts/BarList.d.ts +27 -14
  90. package/dist/charts/BarList.js +38 -83
  91. package/dist/charts/BarList.js.map +1 -1
  92. package/dist/charts/TrendChart.d.ts +40 -7
  93. package/dist/charts/TrendChart.js +243 -215
  94. package/dist/charts/TrendChart.js.map +1 -1
  95. package/dist/charts/bars.d.ts +15 -1
  96. package/dist/charts/bars.js +12 -12
  97. package/dist/charts/bars.js.map +1 -1
  98. package/dist/charts/bucket.js +106 -73
  99. package/dist/charts/bucket.js.map +1 -1
  100. package/dist/charts/inProgress.js +22 -0
  101. package/dist/charts/inProgress.js.map +1 -0
  102. package/dist/charts/series.d.ts +15 -0
  103. package/dist/charts/series.js +123 -0
  104. package/dist/charts/series.js.map +1 -0
  105. package/dist/charts/spline.js +91 -25
  106. package/dist/charts/spline.js.map +1 -1
  107. package/dist/charts/trendGeometry.js +91 -0
  108. package/dist/charts/trendGeometry.js.map +1 -0
  109. package/dist/core/adminOptions.d.ts +1 -0
  110. package/dist/core/adminOptions.js +193 -0
  111. package/dist/core/adminOptions.js.map +1 -0
  112. package/dist/core/budget.js +24 -0
  113. package/dist/core/budget.js.map +1 -0
  114. package/dist/core/cacheKey.d.ts +1 -0
  115. package/dist/core/cacheKey.js +48 -37
  116. package/dist/core/cacheKey.js.map +1 -1
  117. package/dist/core/cacheOptions.js +165 -0
  118. package/dist/core/cacheOptions.js.map +1 -0
  119. package/dist/core/capabilities.d.ts +24 -11
  120. package/dist/core/capabilities.js +96 -17
  121. package/dist/core/capabilities.js.map +1 -1
  122. package/dist/core/capture.d.ts +26 -25
  123. package/dist/core/captureOptions.d.ts +1 -0
  124. package/dist/core/captureOptions.js +258 -0
  125. package/dist/core/captureOptions.js.map +1 -0
  126. package/dist/core/clock.js +13 -0
  127. package/dist/core/clock.js.map +1 -0
  128. package/dist/core/collectionOption.d.ts +17 -0
  129. package/dist/core/collectionOption.js +104 -0
  130. package/dist/core/collectionOption.js.map +1 -0
  131. package/dist/core/collectionSlug.js +7 -0
  132. package/dist/core/collectionSlug.js.map +1 -0
  133. package/dist/core/contract.d.ts +285 -59
  134. package/dist/core/contract.js +6 -4
  135. package/dist/core/contract.js.map +1 -1
  136. package/dist/core/cron.js +57 -0
  137. package/dist/core/cron.js.map +1 -0
  138. package/dist/core/fetch.d.ts +17 -0
  139. package/dist/core/goalOptions.d.ts +1 -0
  140. package/dist/core/goalOptions.js +166 -0
  141. package/dist/core/goalOptions.js.map +1 -0
  142. package/dist/core/granularity.js +3 -2
  143. package/dist/core/granularity.js.map +1 -1
  144. package/dist/core/guards.js +17 -0
  145. package/dist/core/guards.js.map +1 -0
  146. package/dist/core/jobs.d.ts +40 -0
  147. package/dist/core/jobs.js +132 -0
  148. package/dist/core/jobs.js.map +1 -0
  149. package/dist/core/legacyOptions.js +145 -0
  150. package/dist/core/legacyOptions.js.map +1 -0
  151. package/dist/core/metricAliases.js +81 -0
  152. package/dist/core/metricAliases.js.map +1 -0
  153. package/dist/core/metricValues.js +57 -0
  154. package/dist/core/metricValues.js.map +1 -0
  155. package/dist/core/monotonic.js +10 -0
  156. package/dist/core/monotonic.js.map +1 -0
  157. package/dist/core/optionChecks.js +51 -0
  158. package/dist/core/optionChecks.js.map +1 -0
  159. package/dist/core/options.d.ts +473 -157
  160. package/dist/core/options.js +154 -219
  161. package/dist/core/options.js.map +1 -1
  162. package/dist/core/registry.js +45 -5
  163. package/dist/core/registry.js.map +1 -1
  164. package/dist/core/scopeList.js +7 -9
  165. package/dist/core/scopeList.js.map +1 -1
  166. package/dist/core/scopeOptions.d.ts +1 -0
  167. package/dist/core/scopeOptions.js +112 -0
  168. package/dist/core/scopeOptions.js.map +1 -0
  169. package/dist/core/scopedRead.js +182 -72
  170. package/dist/core/scopedRead.js.map +1 -1
  171. package/dist/core/sdks.d.ts +81 -0
  172. package/dist/core/sdks.js +23 -0
  173. package/dist/core/sdks.js.map +1 -0
  174. package/dist/core/serverEvent.d.ts +38 -20
  175. package/dist/core/serverEvent.js.map +1 -1
  176. package/dist/core/siteAddress.js +20 -0
  177. package/dist/core/siteAddress.js.map +1 -0
  178. package/dist/core/sourceErrors.js +109 -0
  179. package/dist/core/sourceErrors.js.map +1 -0
  180. package/dist/core/sourceOptions.js +94 -0
  181. package/dist/core/sourceOptions.js.map +1 -0
  182. package/dist/core/throttle.js +18 -0
  183. package/dist/core/throttle.js.map +1 -0
  184. package/dist/core/values.js +61 -0
  185. package/dist/core/values.js.map +1 -0
  186. package/dist/core/widgetSlugs.d.ts +17 -0
  187. package/dist/core/widgetSlugs.js +29 -0
  188. package/dist/core/widgetSlugs.js.map +1 -0
  189. package/dist/db/detachedWrite.js +36 -0
  190. package/dist/db/detachedWrite.js.map +1 -0
  191. package/dist/db/errors.js +182 -0
  192. package/dist/db/errors.js.map +1 -0
  193. package/dist/db/kind.js +32 -0
  194. package/dist/db/kind.js.map +1 -0
  195. package/dist/db/openTransaction.js +51 -0
  196. package/dist/db/openTransaction.js.map +1 -0
  197. package/dist/exports/adapters/contract.d.ts +14 -0
  198. package/dist/exports/adapters/ga4.d.ts +15 -1
  199. package/dist/exports/adapters/native.d.ts +26 -2
  200. package/dist/exports/adapters/native.js +4 -1
  201. package/dist/exports/adapters/plausible.d.ts +15 -1
  202. package/dist/exports/adapters/posthog.d.ts +15 -1
  203. package/dist/exports/adapters/umami.d.ts +15 -1
  204. package/dist/exports/attributes.d.ts +42 -0
  205. package/dist/exports/attributes.js +83 -0
  206. package/dist/exports/attributes.js.map +1 -0
  207. package/dist/exports/client.d.ts +41 -13
  208. package/dist/exports/client.js +21 -9
  209. package/dist/exports/geo.d.ts +3 -1
  210. package/dist/exports/geo.js +1 -1
  211. package/dist/exports/i18n.d.ts +2 -2
  212. package/dist/exports/i18n.js +2 -2
  213. package/dist/exports/migrations.d.ts +2 -0
  214. package/dist/exports/migrations.js +2 -0
  215. package/dist/exports/next.d.ts +18 -1
  216. package/dist/exports/next.js +3 -1
  217. package/dist/exports/react.d.ts +3 -2
  218. package/dist/exports/react.js +1 -2
  219. package/dist/exports/rsc.d.ts +31 -14
  220. package/dist/exports/rsc.js +11 -6
  221. package/dist/exports/site.d.ts +5 -0
  222. package/dist/exports/site.js +3 -0
  223. package/dist/exports/testing.d.ts +17 -0
  224. package/dist/exports/testing.js +3 -0
  225. package/dist/exports/tracker.d.ts +5 -20
  226. package/dist/exports/tracker.js +3 -14
  227. package/dist/exports/types.d.ts +40 -14
  228. package/dist/exports/types.js +5 -1
  229. package/dist/fields/AnalyticsPanelClient.js +265 -154
  230. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  231. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  232. package/dist/fields/AnalyticsPanelField.js +121 -30
  233. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  234. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  235. package/dist/fields/AnalyticsStatField.js +98 -63
  236. package/dist/fields/AnalyticsStatField.js.map +1 -1
  237. package/dist/fields/FieldShimmer.js +15 -0
  238. package/dist/fields/FieldShimmer.js.map +1 -0
  239. package/dist/fields/PanelContent.js +217 -0
  240. package/dist/fields/PanelContent.js.map +1 -0
  241. package/dist/fields/PanelList.js +82 -0
  242. package/dist/fields/PanelList.js.map +1 -0
  243. package/dist/fields/PanelLiveCounter.js +63 -0
  244. package/dist/fields/PanelLiveCounter.js.map +1 -0
  245. package/dist/fields/PanelSkeleton.js +63 -0
  246. package/dist/fields/PanelSkeleton.js.map +1 -0
  247. package/dist/fields/componentPaths.js +8 -0
  248. package/dist/fields/componentPaths.js.map +1 -0
  249. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  250. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  251. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  252. package/dist/fields/config/FilterKeySelect.js +66 -0
  253. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  254. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  255. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  256. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterValueField.d.ts +17 -0
  258. package/dist/fields/config/FilterValueField.js +130 -0
  259. package/dist/fields/config/FilterValueField.js.map +1 -0
  260. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  261. package/dist/fields/config/MetricSelectField.js +18 -30
  262. package/dist/fields/config/MetricSelectField.js.map +1 -1
  263. package/dist/fields/config/OptionSelect.js +52 -0
  264. package/dist/fields/config/OptionSelect.js.map +1 -0
  265. package/dist/fields/config/SourceSelectField.js +16 -31
  266. package/dist/fields/config/SourceSelectField.js.map +1 -1
  267. package/dist/fields/config/fetchSources.js +14 -26
  268. package/dist/fields/config/fetchSources.js.map +1 -1
  269. package/dist/fields/config/filterValues.js +106 -0
  270. package/dist/fields/config/filterValues.js.map +1 -0
  271. package/dist/fields/config/narrow.js +8 -10
  272. package/dist/fields/config/narrow.js.map +1 -1
  273. package/dist/fields/config/retiredPickers.d.ts +45 -0
  274. package/dist/fields/config/retiredPickers.js +46 -0
  275. package/dist/fields/config/retiredPickers.js.map +1 -0
  276. package/dist/fields/config/scopedFields.d.ts +40 -0
  277. package/dist/fields/config/scopedFields.js +68 -0
  278. package/dist/fields/config/scopedFields.js.map +1 -0
  279. package/dist/fields/config/toSelectOption.js +13 -7
  280. package/dist/fields/config/toSelectOption.js.map +1 -1
  281. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  282. package/dist/fields/config/useAnalyticsSources.js +17 -21
  283. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  284. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  285. package/dist/fields/config/useFilterCapabilities.js +23 -15
  286. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  287. package/dist/fields/config/useFormString.js +12 -0
  288. package/dist/fields/config/useFormString.js.map +1 -0
  289. package/dist/fields/dateRange/field.js +7 -19
  290. package/dist/fields/dateRange/field.js.map +1 -1
  291. package/dist/fields/dateRange/types.d.ts +5 -1
  292. package/dist/fields/dateRange/ui.d.ts +3 -2
  293. package/dist/fields/dateRange/ui.js +57 -319
  294. package/dist/fields/dateRange/ui.js.map +1 -1
  295. package/dist/fields/documentScope.js +21 -0
  296. package/dist/fields/documentScope.js.map +1 -0
  297. package/dist/fields/emptyState.js +31 -26
  298. package/dist/fields/emptyState.js.map +1 -1
  299. package/dist/fields/factories.d.ts +35 -16
  300. package/dist/fields/factories.js +66 -37
  301. package/dist/fields/factories.js.map +1 -1
  302. package/dist/fields/format.d.ts +12 -3
  303. package/dist/fields/format.js +77 -13
  304. package/dist/fields/format.js.map +1 -1
  305. package/dist/fields/itemReport.js +45 -0
  306. package/dist/fields/itemReport.js.map +1 -0
  307. package/dist/fields/readForDocument.d.ts +78 -26
  308. package/dist/fields/readForDocument.js +446 -116
  309. package/dist/fields/readForDocument.js.map +1 -1
  310. package/dist/fields/stateKeys.js +20 -0
  311. package/dist/fields/stateKeys.js.map +1 -0
  312. package/dist/goals/GoalAmountField.d.ts +10 -0
  313. package/dist/goals/GoalAmountField.js +162 -0
  314. package/dist/goals/GoalAmountField.js.map +1 -0
  315. package/dist/goals/GoalSelectField.js +89 -40
  316. package/dist/goals/GoalSelectField.js.map +1 -1
  317. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  318. package/dist/goals/GoalSelectFieldServer.js +21 -0
  319. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  320. package/dist/goals/amountField.d.ts +20 -0
  321. package/dist/goals/amountField.js +37 -0
  322. package/dist/goals/amountField.js.map +1 -0
  323. package/dist/goals/builtin.js +17 -0
  324. package/dist/goals/builtin.js.map +1 -0
  325. package/dist/goals/collection.d.ts +22 -0
  326. package/dist/goals/collection.js +141 -100
  327. package/dist/goals/collection.js.map +1 -1
  328. package/dist/goals/constants.d.ts +38 -0
  329. package/dist/goals/constants.js +49 -0
  330. package/dist/goals/constants.js.map +1 -0
  331. package/dist/goals/currency.d.ts +16 -0
  332. package/dist/goals/currency.js +46 -4
  333. package/dist/goals/currency.js.map +1 -1
  334. package/dist/goals/currencyOptions.js +70 -0
  335. package/dist/goals/currencyOptions.js.map +1 -0
  336. package/dist/goals/fetchGoals.d.ts +10 -0
  337. package/dist/goals/fetchGoals.js +12 -26
  338. package/dist/goals/fetchGoals.js.map +1 -1
  339. package/dist/goals/goalField.d.ts +4 -6
  340. package/dist/goals/goalField.js +9 -19
  341. package/dist/goals/goalField.js.map +1 -1
  342. package/dist/goals/goalsEndpoint.js +39 -40
  343. package/dist/goals/goalsEndpoint.js.map +1 -1
  344. package/dist/goals/items.js +35 -0
  345. package/dist/goals/items.js.map +1 -0
  346. package/dist/goals/latent.js +9 -0
  347. package/dist/goals/latent.js.map +1 -0
  348. package/dist/goals/linkFields.d.ts +35 -0
  349. package/dist/goals/linkFields.js +31 -0
  350. package/dist/goals/linkFields.js.map +1 -0
  351. package/dist/goals/match.d.ts +14 -0
  352. package/dist/goals/match.js +67 -46
  353. package/dist/goals/match.js.map +1 -1
  354. package/dist/goals/moneyFields.js +56 -0
  355. package/dist/goals/moneyFields.js.map +1 -0
  356. package/dist/goals/pathMatch.js +122 -0
  357. package/dist/goals/pathMatch.js.map +1 -0
  358. package/dist/goals/placeholder.js +12 -0
  359. package/dist/goals/placeholder.js.map +1 -0
  360. package/dist/goals/resolver.d.ts +3 -3
  361. package/dist/goals/resolver.js +154 -46
  362. package/dist/goals/resolver.js.map +1 -1
  363. package/dist/goals/serverRevenue.d.ts +60 -0
  364. package/dist/goals/serverRevenue.js +41 -0
  365. package/dist/goals/serverRevenue.js.map +1 -0
  366. package/dist/goals/trackGoalAction.d.ts +26 -27
  367. package/dist/goals/trackGoalAction.js +38 -52
  368. package/dist/goals/trackGoalAction.js.map +1 -1
  369. package/dist/goals/types.d.ts +13 -28
  370. package/dist/goals/types.js +1 -1
  371. package/dist/goals/types.js.map +1 -1
  372. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  373. package/dist/goals/useAnalyticsGoals.js +17 -18
  374. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  375. package/dist/index.d.ts +63 -11
  376. package/dist/index.js +257 -247
  377. package/dist/index.js.map +1 -1
  378. package/dist/items/collectionIdType.js +20 -0
  379. package/dist/items/collectionIdType.js.map +1 -0
  380. package/dist/items/idType.js +31 -0
  381. package/dist/items/idType.js.map +1 -0
  382. package/dist/items/ref.js +73 -0
  383. package/dist/items/ref.js.map +1 -0
  384. package/dist/maintenance/apiTaskState.js +141 -0
  385. package/dist/maintenance/apiTaskState.js.map +1 -0
  386. package/dist/maintenance/heartbeat.js +51 -0
  387. package/dist/maintenance/heartbeat.js.map +1 -0
  388. package/dist/maintenance/lease.d.ts +1 -0
  389. package/dist/maintenance/lease.js +81 -0
  390. package/dist/maintenance/lease.js.map +1 -0
  391. package/dist/maintenance/taskSchedule.d.ts +1 -0
  392. package/dist/maintenance/taskSchedule.js +62 -0
  393. package/dist/maintenance/taskSchedule.js.map +1 -0
  394. package/dist/maintenance/underLease.js +35 -0
  395. package/dist/maintenance/underLease.js.map +1 -0
  396. package/dist/migrations/legacy.d.ts +54 -0
  397. package/dist/migrations/legacy.js +117 -0
  398. package/dist/migrations/legacy.js.map +1 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  401. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  402. package/dist/native/collections/aggregates.js +54 -0
  403. package/dist/native/collections/aggregates.js.map +1 -0
  404. package/dist/native/collections/hits.js +102 -0
  405. package/dist/native/collections/hits.js.map +1 -0
  406. package/dist/native/collections/slugs.d.ts +10 -0
  407. package/dist/native/collections/slugs.js +16 -0
  408. package/dist/native/collections/slugs.js.map +1 -0
  409. package/dist/native/collections/state.js +84 -0
  410. package/dist/native/collections/state.js.map +1 -0
  411. package/dist/native/collections/storeCollection.js +29 -0
  412. package/dist/native/collections/storeCollection.js.map +1 -0
  413. package/dist/native/engine/buckets.d.ts +1 -0
  414. package/dist/native/engine/buckets.js +53 -0
  415. package/dist/native/engine/buckets.js.map +1 -0
  416. package/dist/native/engine/capabilities.js +87 -0
  417. package/dist/native/engine/capabilities.js.map +1 -0
  418. package/dist/native/engine/cost.js +72 -0
  419. package/dist/native/engine/cost.js.map +1 -0
  420. package/dist/native/engine/days.d.ts +1 -0
  421. package/dist/native/engine/days.js +182 -0
  422. package/dist/native/engine/days.js.map +1 -0
  423. package/dist/native/engine/engine.d.ts +1 -0
  424. package/dist/native/engine/engine.js +1623 -0
  425. package/dist/native/engine/engine.js.map +1 -0
  426. package/dist/native/engine/instance.js +58 -0
  427. package/dist/native/engine/instance.js.map +1 -0
  428. package/dist/native/engine/maintenance.d.ts +1 -0
  429. package/dist/native/engine/maintenance.js +677 -0
  430. package/dist/native/engine/maintenance.js.map +1 -0
  431. package/dist/native/engine/merge.js +41 -0
  432. package/dist/native/engine/merge.js.map +1 -0
  433. package/dist/native/engine/nudge.js +26 -0
  434. package/dist/native/engine/nudge.js.map +1 -0
  435. package/dist/native/engine/planner.js +198 -0
  436. package/dist/native/engine/planner.js.map +1 -0
  437. package/dist/native/engine/rebuild.d.ts +22 -0
  438. package/dist/native/engine/rebuild.js +76 -0
  439. package/dist/native/engine/rebuild.js.map +1 -0
  440. package/dist/native/engine/recent.js +17 -0
  441. package/dist/native/engine/recent.js.map +1 -0
  442. package/dist/native/engine/salt.d.ts +1 -0
  443. package/dist/native/engine/salt.js +98 -0
  444. package/dist/native/engine/salt.js.map +1 -0
  445. package/dist/native/engine/siteHosts.d.ts +1 -0
  446. package/dist/native/engine/siteHosts.js +58 -0
  447. package/dist/native/engine/siteHosts.js.map +1 -0
  448. package/dist/native/engine/toHit.js +108 -0
  449. package/dist/native/engine/toHit.js.map +1 -0
  450. package/dist/native/engine/writeBuffer.d.ts +14 -0
  451. package/dist/native/engine/writeBuffer.js +317 -0
  452. package/dist/native/engine/writeBuffer.js.map +1 -0
  453. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  454. package/dist/native/geo/composeGeoResolvers.js +4 -1
  455. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  456. package/dist/native/geo/geoResolver.d.ts +20 -2
  457. package/dist/native/geo/geoResolver.js +42 -6
  458. package/dist/native/geo/geoResolver.js.map +1 -1
  459. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  460. package/dist/native/geo/maxmindResolver.js +20 -16
  461. package/dist/native/geo/maxmindResolver.js.map +1 -1
  462. package/dist/native/geo/resolveGeo.js +31 -0
  463. package/dist/native/geo/resolveGeo.js.map +1 -0
  464. package/dist/native/ingest/bots.d.ts +2 -3
  465. package/dist/native/ingest/bots.js +8 -13
  466. package/dist/native/ingest/bots.js.map +1 -1
  467. package/dist/native/ingest/browser.js +4 -6
  468. package/dist/native/ingest/browser.js.map +1 -1
  469. package/dist/native/ingest/clientIp.js +30 -9
  470. package/dist/native/ingest/clientIp.js.map +1 -1
  471. package/dist/native/ingest/device.js +4 -6
  472. package/dist/native/ingest/device.js.map +1 -1
  473. package/dist/native/ingest/endpoint.d.ts +1 -1
  474. package/dist/native/ingest/endpoint.js +119 -34
  475. package/dist/native/ingest/endpoint.js.map +1 -1
  476. package/dist/native/ingest/itemSignature.d.ts +26 -0
  477. package/dist/native/ingest/itemSignature.js +45 -0
  478. package/dist/native/ingest/itemSignature.js.map +1 -0
  479. package/dist/native/ingest/language.js +2 -3
  480. package/dist/native/ingest/language.js.map +1 -1
  481. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  482. package/dist/native/ingest/normalizeEvent.js +226 -61
  483. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  484. package/dist/native/ingest/orderSignature.d.ts +13 -0
  485. package/dist/native/ingest/orderSignature.js +50 -0
  486. package/dist/native/ingest/orderSignature.js.map +1 -0
  487. package/dist/native/ingest/referrer.js +30 -32
  488. package/dist/native/ingest/referrer.js.map +1 -1
  489. package/dist/native/ingest/requestHost.js +10 -23
  490. package/dist/native/ingest/requestHost.js.map +1 -1
  491. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  492. package/dist/native/ingest/resolveHostname.js +5 -6
  493. package/dist/native/ingest/resolveHostname.js.map +1 -1
  494. package/dist/native/ingest/revenue.d.ts +1 -0
  495. package/dist/native/ingest/revenue.js +121 -0
  496. package/dist/native/ingest/revenue.js.map +1 -0
  497. package/dist/native/ingest/route.d.ts +10 -0
  498. package/dist/native/ingest/route.js +82 -0
  499. package/dist/native/ingest/route.js.map +1 -0
  500. package/dist/native/ingest/serverTrack.d.ts +2 -10
  501. package/dist/native/ingest/serverTrack.js +181 -72
  502. package/dist/native/ingest/serverTrack.js.map +1 -1
  503. package/dist/native/ingest/signature.js +28 -0
  504. package/dist/native/ingest/signature.js.map +1 -0
  505. package/dist/native/ingest/source.d.ts +2 -3
  506. package/dist/native/ingest/source.js +35 -54
  507. package/dist/native/ingest/source.js.map +1 -1
  508. package/dist/native/ingest/utm.js +9 -9
  509. package/dist/native/ingest/utm.js.map +1 -1
  510. package/dist/native/ingest/validate.js +20 -10
  511. package/dist/native/ingest/validate.js.map +1 -1
  512. package/dist/native/ingest/visitorHash.js +6 -8
  513. package/dist/native/ingest/visitorHash.js.map +1 -1
  514. package/dist/native/nativeAdapter.d.ts +101 -33
  515. package/dist/native/nativeAdapter.js +375 -317
  516. package/dist/native/nativeAdapter.js.map +1 -1
  517. package/dist/native/rebuildDays.d.ts +12 -0
  518. package/dist/native/rebuildDays.js +16 -0
  519. package/dist/native/rebuildDays.js.map +1 -0
  520. package/dist/native/store/aggregate.js +450 -0
  521. package/dist/native/store/aggregate.js.map +1 -0
  522. package/dist/native/store/caps.d.ts +18 -0
  523. package/dist/native/store/caps.js +76 -0
  524. package/dist/native/store/caps.js.map +1 -0
  525. package/dist/native/store/chunks.js +34 -0
  526. package/dist/native/store/chunks.js.map +1 -0
  527. package/dist/native/store/columnValues.js +31 -0
  528. package/dist/native/store/columnValues.js.map +1 -0
  529. package/dist/native/store/dialect.js +106 -0
  530. package/dist/native/store/dialect.js.map +1 -0
  531. package/dist/native/store/eventStore.js +44 -0
  532. package/dist/native/store/eventStore.js.map +1 -0
  533. package/dist/native/store/hitRow.js +116 -0
  534. package/dist/native/store/hitRow.js.map +1 -0
  535. package/dist/native/store/hits.js +63 -0
  536. package/dist/native/store/hits.js.map +1 -0
  537. package/dist/native/store/ids.js +105 -0
  538. package/dist/native/store/ids.js.map +1 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  540. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  541. package/dist/native/store/mongo/mongoState.js +375 -0
  542. package/dist/native/store/mongo/mongoState.js.map +1 -0
  543. package/dist/native/store/mongo/mongoStore.js +618 -0
  544. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  545. package/dist/native/store/mongo/pipelines.js +695 -0
  546. package/dist/native/store/mongo/pipelines.js.map +1 -0
  547. package/dist/native/store/mongo/results.js +20 -0
  548. package/dist/native/store/mongo/results.js.map +1 -0
  549. package/dist/native/store/parts.d.ts +1 -0
  550. package/dist/native/store/parts.js +95 -0
  551. package/dist/native/store/parts.js.map +1 -0
  552. package/dist/native/store/pattern.js +213 -0
  553. package/dist/native/store/pattern.js.map +1 -0
  554. package/dist/native/store/rawRead.d.ts +23 -0
  555. package/dist/native/store/rawRead.js +384 -0
  556. package/dist/native/store/rawRead.js.map +1 -0
  557. package/dist/native/store/reclassify.js +53 -0
  558. package/dist/native/store/reclassify.js.map +1 -0
  559. package/dist/native/store/sql/aggregateSql.js +345 -0
  560. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  561. package/dist/native/store/sql/columns.js +48 -0
  562. package/dist/native/store/sql/columns.js.map +1 -0
  563. package/dist/native/store/sql/compile.js +656 -0
  564. package/dist/native/store/sql/compile.js.map +1 -0
  565. package/dist/native/store/sql/drivers.js +218 -0
  566. package/dist/native/store/sql/drivers.js.map +1 -0
  567. package/dist/native/store/sql/executor.js +132 -0
  568. package/dist/native/store/sql/executor.js.map +1 -0
  569. package/dist/native/store/sql/fragment.js +104 -0
  570. package/dist/native/store/sql/fragment.js.map +1 -0
  571. package/dist/native/store/sql/maintenanceSql.js +59 -0
  572. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  573. package/dist/native/store/sql/ownConnection.js +107 -0
  574. package/dist/native/store/sql/ownConnection.js.map +1 -0
  575. package/dist/native/store/sql/poolShare.js +101 -0
  576. package/dist/native/store/sql/poolShare.js.map +1 -0
  577. package/dist/native/store/sql/sqlState.js +325 -0
  578. package/dist/native/store/sql/sqlState.js.map +1 -0
  579. package/dist/native/store/sql/sqlStore.js +355 -0
  580. package/dist/native/store/sql/sqlStore.js.map +1 -0
  581. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  582. package/dist/native/store/sql/sqliteThread.js +314 -0
  583. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  584. package/dist/native/store/sql/sqliteWorker.js +327 -0
  585. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  587. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  588. package/dist/native/store/state.js +151 -0
  589. package/dist/native/store/state.js.map +1 -0
  590. package/dist/native/store/stateStore.js +29 -0
  591. package/dist/native/store/stateStore.js.map +1 -0
  592. package/dist/native/store/types.d.ts +9 -0
  593. package/dist/native/tasks/maintainTask.d.ts +19 -0
  594. package/dist/native/tasks/maintainTask.js +68 -0
  595. package/dist/native/tasks/maintainTask.js.map +1 -0
  596. package/dist/net/guardedFetch.d.ts +32 -0
  597. package/dist/net/guardedFetch.js +220 -0
  598. package/dist/net/guardedFetch.js.map +1 -0
  599. package/dist/net/origin.js +40 -0
  600. package/dist/net/origin.js.map +1 -0
  601. package/dist/net/platform.d.ts +9 -0
  602. package/dist/net/platform.js +35 -0
  603. package/dist/net/platform.js.map +1 -0
  604. package/dist/next/captureRewrites.d.ts +4 -24
  605. package/dist/next/captureRewrites.js +6 -50
  606. package/dist/next/captureRewrites.js.map +1 -1
  607. package/dist/next/captureRoute.d.ts +28 -0
  608. package/dist/next/captureRoute.js +67 -0
  609. package/dist/next/captureRoute.js.map +1 -0
  610. package/dist/next/ingestRoute.d.ts +17 -0
  611. package/dist/next/ingestRoute.js +17 -0
  612. package/dist/next/ingestRoute.js.map +1 -0
  613. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  614. package/dist/next/posthogProxyRewrites.js +5 -37
  615. package/dist/next/posthogProxyRewrites.js.map +1 -1
  616. package/dist/plugin/adminDependencies.js +34 -0
  617. package/dist/plugin/adminDependencies.js.map +1 -0
  618. package/dist/plugin/apiPath.js +23 -0
  619. package/dist/plugin/apiPath.js.map +1 -0
  620. package/dist/plugin/boundDocument.js +58 -0
  621. package/dist/plugin/boundDocument.js.map +1 -0
  622. package/dist/plugin/buildPhase.js +10 -0
  623. package/dist/plugin/buildPhase.js.map +1 -0
  624. package/dist/plugin/collectionChecks.js +232 -0
  625. package/dist/plugin/collectionChecks.js.map +1 -0
  626. package/dist/plugin/collectionFields.d.ts +13 -0
  627. package/dist/plugin/collectionFields.js +22 -0
  628. package/dist/plugin/collectionFields.js.map +1 -0
  629. package/dist/plugin/createRuntime.js +336 -0
  630. package/dist/plugin/createRuntime.js.map +1 -0
  631. package/dist/plugin/destroy.js +58 -0
  632. package/dist/plugin/destroy.js.map +1 -0
  633. package/dist/plugin/documentEndpoint.js +76 -53
  634. package/dist/plugin/documentEndpoint.js.map +1 -1
  635. package/dist/plugin/documentScopes.js +37 -0
  636. package/dist/plugin/documentScopes.js.map +1 -0
  637. package/dist/plugin/encrypted.js +25 -0
  638. package/dist/plugin/encrypted.js.map +1 -0
  639. package/dist/plugin/errors.d.ts +5 -12
  640. package/dist/plugin/errors.js +23 -16
  641. package/dist/plugin/errors.js.map +1 -1
  642. package/dist/plugin/flagsEndpoint.js +41 -0
  643. package/dist/plugin/flagsEndpoint.js.map +1 -0
  644. package/dist/plugin/goalHint.js +22 -11
  645. package/dist/plugin/goalHint.js.map +1 -1
  646. package/dist/plugin/itemLabels.js +114 -0
  647. package/dist/plugin/itemLabels.js.map +1 -0
  648. package/dist/plugin/jobsAccess.js +91 -0
  649. package/dist/plugin/jobsAccess.js.map +1 -0
  650. package/dist/plugin/keepAlive.js +48 -0
  651. package/dist/plugin/keepAlive.js.map +1 -0
  652. package/dist/plugin/peerImportError.js +3 -6
  653. package/dist/plugin/peerImportError.js.map +1 -1
  654. package/dist/plugin/peers.js +64 -0
  655. package/dist/plugin/peers.js.map +1 -0
  656. package/dist/plugin/pluginCollections.js +155 -0
  657. package/dist/plugin/pluginCollections.js.map +1 -0
  658. package/dist/plugin/queryEndpoint.js +69 -44
  659. package/dist/plugin/queryEndpoint.js.map +1 -1
  660. package/dist/plugin/queryParams.js +7 -0
  661. package/dist/plugin/queryParams.js.map +1 -0
  662. package/dist/plugin/readContextForRequest.js +52 -17
  663. package/dist/plugin/readContextForRequest.js.map +1 -1
  664. package/dist/plugin/readFailure.js +22 -0
  665. package/dist/plugin/readFailure.js.map +1 -0
  666. package/dist/plugin/readableProviders.js +64 -0
  667. package/dist/plugin/readableProviders.js.map +1 -0
  668. package/dist/plugin/realtimeEndpoint.js +77 -25
  669. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  670. package/dist/plugin/refreshEndpoint.js +69 -44
  671. package/dist/plugin/refreshEndpoint.js.map +1 -1
  672. package/dist/plugin/relabelFields.js +36 -0
  673. package/dist/plugin/relabelFields.js.map +1 -0
  674. package/dist/plugin/requestMemo.js +35 -0
  675. package/dist/plugin/requestMemo.js.map +1 -0
  676. package/dist/plugin/routeChecks.js +39 -0
  677. package/dist/plugin/routeChecks.js.map +1 -0
  678. package/dist/plugin/routes.d.ts +53 -0
  679. package/dist/plugin/routes.js +92 -0
  680. package/dist/plugin/routes.js.map +1 -0
  681. package/dist/plugin/runtime.d.ts +1 -1
  682. package/dist/plugin/runtime.js +226 -30
  683. package/dist/plugin/runtime.js.map +1 -1
  684. package/dist/plugin/schemaOnly.js +63 -0
  685. package/dist/plugin/schemaOnly.js.map +1 -0
  686. package/dist/plugin/scopeChange.js +6 -5
  687. package/dist/plugin/scopeChange.js.map +1 -1
  688. package/dist/plugin/scopeFieldBoot.js +4 -4
  689. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  690. package/dist/plugin/scopeToken.js +33 -0
  691. package/dist/plugin/scopeToken.js.map +1 -0
  692. package/dist/plugin/sourcesEndpoint.js +46 -12
  693. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  694. package/dist/plugin/unbundledLanguages.js +25 -0
  695. package/dist/plugin/unbundledLanguages.js.map +1 -0
  696. package/dist/plugin/walkFields.js +22 -0
  697. package/dist/plugin/walkFields.js.map +1 -0
  698. package/dist/plugin/warmTask.js +0 -0
  699. package/dist/plugin/warmTask.js.map +1 -1
  700. package/dist/providers/access.d.ts +1 -0
  701. package/dist/providers/access.js +35 -26
  702. package/dist/providers/access.js.map +1 -1
  703. package/dist/providers/adapterPool.js +121 -0
  704. package/dist/providers/adapterPool.js.map +1 -0
  705. package/dist/providers/collection.d.ts +53 -0
  706. package/dist/providers/collection.js +274 -150
  707. package/dist/providers/collection.js.map +1 -1
  708. package/dist/providers/factory.d.ts +76 -0
  709. package/dist/providers/factory.js +76 -23
  710. package/dist/providers/factory.js.map +1 -1
  711. package/dist/providers/hosts.d.ts +25 -0
  712. package/dist/providers/hosts.js +128 -0
  713. package/dist/providers/hosts.js.map +1 -0
  714. package/dist/providers/probe.d.ts +1 -0
  715. package/dist/providers/probe.js +101 -0
  716. package/dist/providers/probe.js.map +1 -0
  717. package/dist/providers/refresh.d.ts +18 -0
  718. package/dist/providers/refresh.js +49 -0
  719. package/dist/providers/refresh.js.map +1 -0
  720. package/dist/providers/registry.js +318 -0
  721. package/dist/providers/registry.js.map +1 -0
  722. package/dist/providers/resolver.js +23 -88
  723. package/dist/providers/resolver.js.map +1 -1
  724. package/dist/providers/retarget.js +45 -0
  725. package/dist/providers/retarget.js.map +1 -0
  726. package/dist/providers/secrets.d.ts +26 -0
  727. package/dist/providers/secrets.js +61 -4
  728. package/dist/providers/secrets.js.map +1 -1
  729. package/dist/providers/stampScope.js +9 -6
  730. package/dist/providers/stampScope.js.map +1 -1
  731. package/dist/query/dates.js +10 -12
  732. package/dist/query/dates.js.map +1 -1
  733. package/dist/query/errors.d.ts +1 -5
  734. package/dist/query/fetchQuery.d.ts +25 -32
  735. package/dist/query/fetchQuery.js +91 -91
  736. package/dist/query/fetchQuery.js.map +1 -1
  737. package/dist/query/limits.js +8 -0
  738. package/dist/query/limits.js.map +1 -0
  739. package/dist/query/parse.d.ts +6 -0
  740. package/dist/query/parse.js +153 -106
  741. package/dist/query/parse.js.map +1 -1
  742. package/dist/query/response.d.ts +23 -3
  743. package/dist/query/response.js +12 -5
  744. package/dist/query/response.js.map +1 -1
  745. package/dist/react/AnalyticsProvider.d.ts +26 -17
  746. package/dist/react/AnalyticsProvider.js +23 -22
  747. package/dist/react/AnalyticsProvider.js.map +1 -1
  748. package/dist/react/TrackerBoot.js +15 -9
  749. package/dist/react/TrackerBoot.js.map +1 -1
  750. package/dist/react/useAnalytics.d.ts +2 -11
  751. package/dist/react/useAnalytics.js +22 -24
  752. package/dist/react/useAnalytics.js.map +1 -1
  753. package/dist/site/AnalyticsScripts.d.ts +34 -0
  754. package/dist/site/AnalyticsScripts.js +30 -0
  755. package/dist/site/AnalyticsScripts.js.map +1 -0
  756. package/dist/site/getTrackerConfig.d.ts +15 -0
  757. package/dist/site/getTrackerConfig.js +40 -0
  758. package/dist/site/getTrackerConfig.js.map +1 -0
  759. package/dist/surfacing/afterRead.d.ts +37 -0
  760. package/dist/surfacing/bounded.js +38 -0
  761. package/dist/surfacing/bounded.js.map +1 -0
  762. package/dist/surfacing/breaker.js +107 -0
  763. package/dist/surfacing/breaker.js.map +1 -0
  764. package/dist/surfacing/cacheCollection.d.ts +8 -0
  765. package/dist/surfacing/cacheCollection.js +69 -0
  766. package/dist/surfacing/cacheCollection.js.map +1 -0
  767. package/dist/surfacing/cacheStore.d.ts +71 -1
  768. package/dist/surfacing/cacheStore.js +16 -37
  769. package/dist/surfacing/cacheStore.js.map +1 -1
  770. package/dist/surfacing/cacheSweep.d.ts +1 -0
  771. package/dist/surfacing/cacheSweep.js +59 -0
  772. package/dist/surfacing/cacheSweep.js.map +1 -0
  773. package/dist/surfacing/classifyError.js +282 -0
  774. package/dist/surfacing/classifyError.js.map +1 -0
  775. package/dist/surfacing/coalesce.js +2 -1
  776. package/dist/surfacing/coalesce.js.map +1 -1
  777. package/dist/surfacing/coldBudget.js +60 -0
  778. package/dist/surfacing/coldBudget.js.map +1 -0
  779. package/dist/surfacing/collectionCacheStore.js +183 -0
  780. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  781. package/dist/surfacing/engine.d.ts +1 -1
  782. package/dist/surfacing/engine.js +514 -72
  783. package/dist/surfacing/engine.js.map +1 -1
  784. package/dist/surfacing/epoch.js +70 -26
  785. package/dist/surfacing/epoch.js.map +1 -1
  786. package/dist/surfacing/lanes.d.ts +1 -0
  787. package/dist/surfacing/lanes.js +297 -0
  788. package/dist/surfacing/lanes.js.map +1 -0
  789. package/dist/surfacing/memo.js +40 -0
  790. package/dist/surfacing/memo.js.map +1 -0
  791. package/dist/surfacing/rateLimiter.d.ts +1 -0
  792. package/dist/surfacing/rateLimiter.js +69 -94
  793. package/dist/surfacing/rateLimiter.js.map +1 -1
  794. package/dist/surfacing/rebucket.js +178 -0
  795. package/dist/surfacing/rebucket.js.map +1 -0
  796. package/dist/surfacing/recipe.js +28 -0
  797. package/dist/surfacing/recipe.js.map +1 -0
  798. package/dist/surfacing/shape.js +22 -0
  799. package/dist/surfacing/shape.js.map +1 -0
  800. package/dist/surfacing/todaySplit.js +113 -0
  801. package/dist/surfacing/todaySplit.js.map +1 -0
  802. package/dist/sync/collection.d.ts +8 -0
  803. package/dist/sync/collection.js +28 -18
  804. package/dist/sync/collection.js.map +1 -1
  805. package/dist/sync/rekeyDurations.js +70 -0
  806. package/dist/sync/rekeyDurations.js.map +1 -0
  807. package/dist/sync/syncTask.js +226 -109
  808. package/dist/sync/syncTask.js.map +1 -1
  809. package/dist/testing/memoryAdapter.d.ts +6 -3
  810. package/dist/testing/memoryAdapter.js +12 -10
  811. package/dist/testing/memoryAdapter.js.map +1 -1
  812. package/dist/testing/settle.d.ts +11 -0
  813. package/dist/testing/settle.js +19 -0
  814. package/dist/testing/settle.js.map +1 -0
  815. package/dist/timeframe/calendar.js +65 -0
  816. package/dist/timeframe/calendar.js.map +1 -0
  817. package/dist/timeframe/comparison.js +46 -0
  818. package/dist/timeframe/comparison.js.map +1 -0
  819. package/dist/timeframe/presets.d.ts +1 -1
  820. package/dist/timeframe/presets.js +5 -5
  821. package/dist/timeframe/presets.js.map +1 -1
  822. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  823. package/dist/timeframe/reportingTimezone.js +64 -0
  824. package/dist/timeframe/reportingTimezone.js.map +1 -0
  825. package/dist/timeframe/tz.js +55 -39
  826. package/dist/timeframe/tz.js.map +1 -1
  827. package/dist/tracker/autoCapture.js +125 -38
  828. package/dist/tracker/autoCapture.js.map +1 -1
  829. package/dist/tracker/campaign.js +52 -0
  830. package/dist/tracker/campaign.js.map +1 -0
  831. package/dist/tracker/config.d.ts +144 -0
  832. package/dist/tracker/config.js +25 -0
  833. package/dist/tracker/config.js.map +1 -0
  834. package/dist/tracker/createTracker.d.ts +4 -10
  835. package/dist/tracker/createTracker.js +386 -115
  836. package/dist/tracker/createTracker.js.map +1 -1
  837. package/dist/tracker/digest.js +28 -0
  838. package/dist/tracker/digest.js.map +1 -0
  839. package/dist/tracker/engagement.js +100 -0
  840. package/dist/tracker/engagement.js.map +1 -0
  841. package/dist/tracker/events.js +37 -0
  842. package/dist/tracker/events.js.map +1 -0
  843. package/dist/tracker/exclusion.d.ts +2 -22
  844. package/dist/tracker/exclusion.js +53 -21
  845. package/dist/tracker/exclusion.js.map +1 -1
  846. package/dist/tracker/gate.js +194 -0
  847. package/dist/tracker/gate.js.map +1 -0
  848. package/dist/tracker/initTracker.d.ts +5 -8
  849. package/dist/tracker/initTracker.js +42 -14
  850. package/dist/tracker/initTracker.js.map +1 -1
  851. package/dist/tracker/itemCapture.js +224 -0
  852. package/dist/tracker/itemCapture.js.map +1 -0
  853. package/dist/tracker/loadScript.js +21 -14
  854. package/dist/tracker/loadScript.js.map +1 -1
  855. package/dist/tracker/pageTracking.js +6 -6
  856. package/dist/tracker/pageTracking.js.map +1 -1
  857. package/dist/tracker/registry.js +118 -30
  858. package/dist/tracker/registry.js.map +1 -1
  859. package/dist/tracker/sinks/createSink.js +38 -0
  860. package/dist/tracker/sinks/createSink.js.map +1 -0
  861. package/dist/tracker/sinks/ga4.js +64 -20
  862. package/dist/tracker/sinks/ga4.js.map +1 -1
  863. package/dist/tracker/sinks/native.js +7 -42
  864. package/dist/tracker/sinks/native.js.map +1 -1
  865. package/dist/tracker/sinks/plausible.js +27 -22
  866. package/dist/tracker/sinks/plausible.js.map +1 -1
  867. package/dist/tracker/sinks/posthog.js +26 -22
  868. package/dist/tracker/sinks/posthog.js.map +1 -1
  869. package/dist/tracker/sinks/umami.js +14 -12
  870. package/dist/tracker/sinks/umami.js.map +1 -1
  871. package/dist/tracker/sinks/vendor.js +30 -27
  872. package/dist/tracker/sinks/vendor.js.map +1 -1
  873. package/dist/tracker/skip.js +81 -0
  874. package/dist/tracker/skip.js.map +1 -0
  875. package/dist/tracker/storage.js +23 -0
  876. package/dist/tracker/storage.js.map +1 -0
  877. package/dist/tracker/transport.js +2 -5
  878. package/dist/tracker/transport.js.map +1 -1
  879. package/dist/tracker/types.d.ts +86 -63
  880. package/dist/tracker/window.js +7 -0
  881. package/dist/tracker/window.js.map +1 -0
  882. package/dist/translations/ar.js +226 -71
  883. package/dist/translations/ar.js.map +1 -1
  884. package/dist/translations/de.js +215 -69
  885. package/dist/translations/de.js.map +1 -1
  886. package/dist/translations/en.js +209 -67
  887. package/dist/translations/en.js.map +1 -1
  888. package/dist/translations/es.js +217 -68
  889. package/dist/translations/es.js.map +1 -1
  890. package/dist/translations/fr.js +221 -72
  891. package/dist/translations/fr.js.map +1 -1
  892. package/dist/translations/id.js +212 -67
  893. package/dist/translations/id.js.map +1 -1
  894. package/dist/translations/index.d.ts +1 -1
  895. package/dist/translations/index.js +5 -7
  896. package/dist/translations/index.js.map +1 -1
  897. package/dist/translations/intl.js +71 -0
  898. package/dist/translations/intl.js.map +1 -0
  899. package/dist/translations/keys.d.ts +185 -14
  900. package/dist/translations/keys.js +190 -14
  901. package/dist/translations/keys.js.map +1 -1
  902. package/dist/translations/ko.js +214 -69
  903. package/dist/translations/ko.js.map +1 -1
  904. package/dist/translations/labelMap.d.ts +10 -0
  905. package/dist/translations/labelMap.js +22 -0
  906. package/dist/translations/labelMap.js.map +1 -0
  907. package/dist/translations/metricKeys.js +10 -2
  908. package/dist/translations/metricKeys.js.map +1 -1
  909. package/dist/translations/parts.js +20 -0
  910. package/dist/translations/parts.js.map +1 -0
  911. package/dist/translations/plural.js +61 -0
  912. package/dist/translations/plural.js.map +1 -0
  913. package/dist/translations/pt.js +226 -77
  914. package/dist/translations/pt.js.map +1 -1
  915. package/dist/translations/ru.js +217 -66
  916. package/dist/translations/ru.js.map +1 -1
  917. package/dist/translations/server.d.ts +1 -0
  918. package/dist/translations/server.js +2 -3
  919. package/dist/translations/server.js.map +1 -1
  920. package/dist/translations/staticLabel.js +69 -0
  921. package/dist/translations/staticLabel.js.map +1 -0
  922. package/dist/translations/uk.js +217 -66
  923. package/dist/translations/uk.js.map +1 -1
  924. package/dist/translations/zh.js +212 -67
  925. package/dist/translations/zh.js.map +1 -1
  926. package/dist/ui/RangePicker.js +112 -0
  927. package/dist/ui/RangePicker.js.map +1 -0
  928. package/dist/ui/analytics.css +1528 -0
  929. package/dist/ui/calendarDays.js +27 -0
  930. package/dist/ui/calendarDays.js.map +1 -0
  931. package/dist/ui/classNames.js +7 -0
  932. package/dist/ui/classNames.js.map +1 -0
  933. package/dist/ui/components/Card.d.ts +28 -0
  934. package/dist/ui/components/Card.js +21 -0
  935. package/dist/ui/components/Card.js.map +1 -0
  936. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  937. package/dist/ui/components/ChartDataTable.js +48 -0
  938. package/dist/ui/components/ChartDataTable.js.map +1 -0
  939. package/dist/ui/components/DataTable.d.ts +82 -0
  940. package/dist/ui/components/DataTable.js +214 -0
  941. package/dist/ui/components/DataTable.js.map +1 -0
  942. package/dist/ui/components/LabeledSelect.js +62 -0
  943. package/dist/ui/components/LabeledSelect.js.map +1 -0
  944. package/dist/ui/components/LiveAnnouncement.js +21 -0
  945. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  946. package/dist/ui/components/MetricCard.d.ts +38 -0
  947. package/dist/ui/components/MetricCard.js +39 -0
  948. package/dist/ui/components/MetricCard.js.map +1 -0
  949. package/dist/ui/components/NoValue.js +22 -0
  950. package/dist/ui/components/NoValue.js.map +1 -0
  951. package/dist/ui/components/ReadState.js +27 -0
  952. package/dist/ui/components/ReadState.js.map +1 -0
  953. package/dist/ui/components/RefreshButton.js +26 -0
  954. package/dist/ui/components/RefreshButton.js.map +1 -0
  955. package/dist/ui/cssVars.js +7 -0
  956. package/dist/ui/cssVars.js.map +1 -0
  957. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  958. package/dist/ui/data/WithScopeToken.js +20 -0
  959. package/dist/ui/data/WithScopeToken.js.map +1 -0
  960. package/dist/ui/data/clientFieldProps.js +16 -0
  961. package/dist/ui/data/clientFieldProps.js.map +1 -0
  962. package/dist/ui/data/request.d.ts +46 -0
  963. package/dist/ui/data/request.js +119 -0
  964. package/dist/ui/data/request.js.map +1 -0
  965. package/dist/ui/data/scopeTokenContext.js +18 -0
  966. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  967. package/dist/ui/data/sharedCache.js +48 -0
  968. package/dist/ui/data/sharedCache.js.map +1 -0
  969. package/dist/ui/data/useRequest.d.ts +19 -0
  970. package/dist/ui/data/useRequest.js +123 -0
  971. package/dist/ui/data/useRequest.js.map +1 -0
  972. package/dist/ui/data/useRequestScope.js +25 -0
  973. package/dist/ui/data/useRequestScope.js.map +1 -0
  974. package/dist/ui/hooks/useDirection.js +47 -0
  975. package/dist/ui/hooks/useDirection.js.map +1 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  977. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  979. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  980. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  981. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  982. package/dist/ui/readState.js +19 -0
  983. package/dist/ui/readState.js.map +1 -0
  984. package/dist/ui/rows/toDisplayRows.js +49 -0
  985. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  986. package/dist/ui/viewerClock.js +7 -0
  987. package/dist/ui/viewerClock.js.map +1 -0
  988. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  989. package/dist/view/AnalyticsNavLink.js +11 -6
  990. package/dist/view/AnalyticsNavLink.js.map +1 -1
  991. package/dist/view/AnalyticsView.d.ts +8 -10
  992. package/dist/view/AnalyticsView.js +47 -18
  993. package/dist/view/AnalyticsView.js.map +1 -1
  994. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  995. package/dist/view/AnalyticsViewClient.js +15 -229
  996. package/dist/view/AnalyticsViewClient.js.map +1 -1
  997. package/dist/view/CountryFlag.d.ts +27 -0
  998. package/dist/view/CountryFlag.js +44 -0
  999. package/dist/view/CountryFlag.js.map +1 -0
  1000. package/dist/view/DocumentTitle.js +27 -0
  1001. package/dist/view/DocumentTitle.js.map +1 -0
  1002. package/dist/view/ViewRoot.d.ts +21 -0
  1003. package/dist/view/ViewRoot.js +150 -0
  1004. package/dist/view/ViewRoot.js.map +1 -0
  1005. package/dist/view/ViewSections.d.ts +38 -0
  1006. package/dist/view/ViewSections.js +190 -0
  1007. package/dist/view/ViewSections.js.map +1 -0
  1008. package/dist/view/authRedirect.js +2 -4
  1009. package/dist/view/authRedirect.js.map +1 -1
  1010. package/dist/view/conversionRate.js +9 -7
  1011. package/dist/view/conversionRate.js.map +1 -1
  1012. package/dist/view/dayRange.js +6 -10
  1013. package/dist/view/dayRange.js.map +1 -1
  1014. package/dist/view/exclusionLink.d.ts +27 -0
  1015. package/dist/view/exclusionLink.js +46 -0
  1016. package/dist/view/exclusionLink.js.map +1 -0
  1017. package/dist/view/flagSrc.js +14 -0
  1018. package/dist/view/flagSrc.js.map +1 -0
  1019. package/dist/view/gating.d.ts +15 -1
  1020. package/dist/view/gating.js +66 -31
  1021. package/dist/view/gating.js.map +1 -1
  1022. package/dist/view/hostCountryFlag.js +41 -0
  1023. package/dist/view/hostCountryFlag.js.map +1 -0
  1024. package/dist/view/labels.js +95 -10
  1025. package/dist/view/labels.js.map +1 -1
  1026. package/dist/view/metricAliases.js +10 -0
  1027. package/dist/view/metricAliases.js.map +1 -0
  1028. package/dist/view/navLabel.js +15 -0
  1029. package/dist/view/navLabel.js.map +1 -0
  1030. package/dist/view/registerView.js +10 -9
  1031. package/dist/view/registerView.js.map +1 -1
  1032. package/dist/view/scopeLabel.js +21 -0
  1033. package/dist/view/scopeLabel.js.map +1 -0
  1034. package/dist/view/sections/Breakdowns.js +196 -134
  1035. package/dist/view/sections/Breakdowns.js.map +1 -1
  1036. package/dist/view/sections/EmptyStates.js +118 -30
  1037. package/dist/view/sections/EmptyStates.js.map +1 -1
  1038. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1039. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1040. package/dist/view/sections/FilterChips.js +124 -27
  1041. package/dist/view/sections/FilterChips.js.map +1 -1
  1042. package/dist/view/sections/GoalsPanel.js +68 -60
  1043. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1044. package/dist/view/sections/OverviewCards.js +29 -33
  1045. package/dist/view/sections/OverviewCards.js.map +1 -1
  1046. package/dist/view/sections/RealtimeStrip.js +70 -59
  1047. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1048. package/dist/view/sections/SectionBoundary.js +34 -0
  1049. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1050. package/dist/view/sections/Toolbar.d.ts +11 -0
  1051. package/dist/view/sections/Toolbar.js +123 -82
  1052. package/dist/view/sections/Toolbar.js.map +1 -1
  1053. package/dist/view/sections/Trend.js +176 -76
  1054. package/dist/view/sections/Trend.js.map +1 -1
  1055. package/dist/view/state.d.ts +42 -0
  1056. package/dist/view/state.js +93 -54
  1057. package/dist/view/state.js.map +1 -1
  1058. package/dist/view/useViewClock.js +31 -0
  1059. package/dist/view/useViewClock.js.map +1 -0
  1060. package/dist/view/useViewQueries.d.ts +21 -0
  1061. package/dist/view/useViewQueries.js +45 -77
  1062. package/dist/view/useViewQueries.js.map +1 -1
  1063. package/dist/view/useViewState.js +42 -0
  1064. package/dist/view/useViewState.js.map +1 -0
  1065. package/dist/view/useViewUrl.js +47 -0
  1066. package/dist/view/useViewUrl.js.map +1 -0
  1067. package/dist/view/viewBody.js +30 -0
  1068. package/dist/view/viewBody.js.map +1 -0
  1069. package/dist/view/viewContext.d.ts +81 -0
  1070. package/dist/view/viewContext.js +49 -0
  1071. package/dist/view/viewContext.js.map +1 -0
  1072. package/dist/view/viewProps.d.ts +64 -7
  1073. package/dist/view/viewProps.js +121 -35
  1074. package/dist/view/viewProps.js.map +1 -1
  1075. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1077. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1078. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1079. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1080. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1081. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1082. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1083. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1084. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1086. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1087. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1088. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1089. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1090. package/dist/widgets/ComparisonDelta.js +33 -42
  1091. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1092. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1093. package/dist/widgets/RealtimeCounter.js +91 -77
  1094. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1095. package/dist/widgets/WidgetCard.d.ts +80 -0
  1096. package/dist/widgets/WidgetCard.js +99 -0
  1097. package/dist/widgets/WidgetCard.js.map +1 -0
  1098. package/dist/widgets/WidgetFrame.js +42 -0
  1099. package/dist/widgets/WidgetFrame.js.map +1 -0
  1100. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1101. package/dist/widgets/WidgetShimmer.js +86 -0
  1102. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1103. package/dist/widgets/breakdownTypes.js +12 -2
  1104. package/dist/widgets/breakdownTypes.js.map +1 -1
  1105. package/dist/widgets/customWidget.d.ts +5 -1
  1106. package/dist/widgets/customWidget.js +6 -7
  1107. package/dist/widgets/customWidget.js.map +1 -1
  1108. package/dist/widgets/defaults.d.ts +4 -7
  1109. package/dist/widgets/defaults.js +4 -7
  1110. package/dist/widgets/defaults.js.map +1 -1
  1111. package/dist/widgets/fieldRows.js +14 -0
  1112. package/dist/widgets/fieldRows.js.map +1 -0
  1113. package/dist/widgets/filterCaption.js +6 -7
  1114. package/dist/widgets/filterCaption.js.map +1 -1
  1115. package/dist/widgets/filterField.d.ts +3 -7
  1116. package/dist/widgets/filterField.js +46 -35
  1117. package/dist/widgets/filterField.js.map +1 -1
  1118. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1119. package/dist/widgets/filterValueLabel.js +45 -0
  1120. package/dist/widgets/filterValueLabel.js.map +1 -0
  1121. package/dist/widgets/notices.js +73 -0
  1122. package/dist/widgets/notices.js.map +1 -0
  1123. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1124. package/dist/widgets/prepareWidgetRead.js +59 -27
  1125. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1126. package/dist/widgets/range.js +26 -21
  1127. package/dist/widgets/range.js.map +1 -1
  1128. package/dist/widgets/readForWidget.d.ts +27 -18
  1129. package/dist/widgets/readForWidget.js +31 -29
  1130. package/dist/widgets/readForWidget.js.map +1 -1
  1131. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1132. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1133. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1134. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1135. package/dist/widgets/readForWidgetGoals.js +50 -46
  1136. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1137. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1138. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1139. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1140. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1141. package/dist/widgets/readForWidgetSeries.js +43 -82
  1142. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1143. package/dist/widgets/readMeta.d.ts +44 -0
  1144. package/dist/widgets/readMeta.js +47 -4
  1145. package/dist/widgets/readMeta.js.map +1 -1
  1146. package/dist/widgets/realtimePoll.d.ts +1 -0
  1147. package/dist/widgets/realtimePoll.js +53 -25
  1148. package/dist/widgets/realtimePoll.js.map +1 -1
  1149. package/dist/widgets/registerWidgets.js +204 -126
  1150. package/dist/widgets/registerWidgets.js.map +1 -1
  1151. package/dist/widgets/stateKeys.js +30 -0
  1152. package/dist/widgets/stateKeys.js.map +1 -0
  1153. package/dist/widgets/titleForecast.js +89 -0
  1154. package/dist/widgets/titleForecast.js.map +1 -0
  1155. package/dist/widgets/types.d.ts +4 -3
  1156. package/dist/widgets/types.js +2 -0
  1157. package/dist/widgets/types.js.map +1 -1
  1158. package/dist/widgets/viewLink.d.ts +24 -6
  1159. package/dist/widgets/viewLink.js +31 -24
  1160. package/dist/widgets/viewLink.js.map +1 -1
  1161. package/dist/widgets/widgetData.js +34 -0
  1162. package/dist/widgets/widgetData.js.map +1 -0
  1163. package/dist/widgets/widgetWindow.d.ts +1 -0
  1164. package/dist/widgets/widgetWindow.js +51 -0
  1165. package/dist/widgets/widgetWindow.js.map +1 -0
  1166. package/package.json +44 -22
  1167. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1168. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1169. package/dist/capture/getTrackerConfig.js +0 -31
  1170. package/dist/capture/getTrackerConfig.js.map +0 -1
  1171. package/dist/capture/slots.d.ts +0 -8
  1172. package/dist/capture/trackerConfig.d.ts +0 -33
  1173. package/dist/charts/styles.js +0 -59
  1174. package/dist/charts/styles.js.map +0 -1
  1175. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1176. package/dist/fields/dateRange/styles.js +0 -23
  1177. package/dist/fields/dateRange/styles.js.map +0 -1
  1178. package/dist/goals/GoalSelectField.d.ts +0 -7
  1179. package/dist/native/collections/events.js +0 -165
  1180. package/dist/native/collections/events.js.map +0 -1
  1181. package/dist/native/collections/rollups.js +0 -151
  1182. package/dist/native/collections/rollups.js.map +0 -1
  1183. package/dist/native/collections/seen.js +0 -47
  1184. package/dist/native/collections/seen.js.map +0 -1
  1185. package/dist/native/eventScan.js +0 -25
  1186. package/dist/native/eventScan.js.map +0 -1
  1187. package/dist/native/ingest/flushBatch.js +0 -60
  1188. package/dist/native/ingest/flushBatch.js.map +0 -1
  1189. package/dist/native/ingest/salt.js +0 -39
  1190. package/dist/native/ingest/salt.js.map +0 -1
  1191. package/dist/native/ingest/writeBuffer.js +0 -55
  1192. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1193. package/dist/native/ingest/writeEvent.js +0 -14
  1194. package/dist/native/ingest/writeEvent.js.map +0 -1
  1195. package/dist/native/query/eventAgg.js +0 -175
  1196. package/dist/native/query/eventAgg.js.map +0 -1
  1197. package/dist/native/realtime/buildRealtime.js +0 -53
  1198. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1199. package/dist/native/retention/pruneTask.js +0 -69
  1200. package/dist/native/retention/pruneTask.js.map +0 -1
  1201. package/dist/native/rollupAcc.js +0 -64
  1202. package/dist/native/rollupAcc.js.map +0 -1
  1203. package/dist/native/rollups/bucketKey.js +0 -15
  1204. package/dist/native/rollups/bucketKey.js.map +0 -1
  1205. package/dist/native/rollups/bumpRollups.js +0 -116
  1206. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1207. package/dist/native/rollups/deltas.js +0 -106
  1208. package/dist/native/rollups/deltas.js.map +0 -1
  1209. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1210. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1211. package/dist/plugin/paths.js +0 -29
  1212. package/dist/plugin/paths.js.map +0 -1
  1213. package/dist/react/TrackerBoot.d.ts +0 -22
  1214. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1215. package/dist/rsc/AnalyticsScripts.js +0 -41
  1216. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1217. package/dist/surfacing/queue.js +0 -60
  1218. package/dist/surfacing/queue.js.map +0 -1
  1219. package/dist/surfacing/retryPolicy.js +0 -15
  1220. package/dist/surfacing/retryPolicy.js.map +0 -1
  1221. package/dist/tracker/autoCapture.d.ts +0 -48
  1222. package/dist/tracker/consent.d.ts +0 -24
  1223. package/dist/tracker/consent.js +0 -48
  1224. package/dist/tracker/consent.js.map +0 -1
  1225. package/dist/tracker/loadScript.d.ts +0 -14
  1226. package/dist/tracker/pageTracking.d.ts +0 -17
  1227. package/dist/tracker/registry.d.ts +0 -27
  1228. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1229. package/dist/tracker/sinks/native.d.ts +0 -22
  1230. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1231. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1232. package/dist/tracker/sinks/umami.d.ts +0 -18
  1233. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1234. package/dist/view/sections/styles.js +0 -76
  1235. package/dist/view/sections/styles.js.map +0 -1
  1236. package/dist/widgets/WidgetViewLink.js +0 -17
  1237. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1238. package/dist/widgets/cardChrome.d.ts +0 -8
  1239. package/dist/widgets/cardChrome.js +0 -46
  1240. package/dist/widgets/cardChrome.js.map +0 -1
  1241. package/dist/widgets/comparison.js +0 -57
  1242. package/dist/widgets/comparison.js.map +0 -1
@@ -1,8 +1,9 @@
1
1
  //#region src/providers/secrets.ts
2
2
  /**
3
- * Every credential path in the provider collection. The decrypting provider
4
- * source derives from this list; `collection.test.ts` asserts it stays in
5
- * parity with the collection's own secret fields so the two can't drift.
3
+ * Every credential path in the providers collection; `collection.test.ts` holds it to the
4
+ * collection's secret fields.
5
+ *
6
+ * @beta
6
7
  */
7
8
  const SECRET_PATHS = [
8
9
  {
@@ -26,7 +27,63 @@ const SECRET_PATHS = [
26
27
  path: "posthog.apiKey"
27
28
  }
28
29
  ];
30
+ /**
31
+ * Values that decide where a document's credentials go: changing one clears its stored secrets
32
+ * unless they are sent again. `provider: null` marks the one every provider shares.
33
+ *
34
+ * @beta
35
+ */
36
+ const CONNECTION_PATHS = [
37
+ {
38
+ provider: null,
39
+ path: "provider"
40
+ },
41
+ {
42
+ provider: "plausible",
43
+ path: "plausible.host"
44
+ },
45
+ {
46
+ provider: "plausible",
47
+ path: "plausible.siteId"
48
+ },
49
+ {
50
+ provider: "umami",
51
+ path: "umami.host"
52
+ },
53
+ {
54
+ provider: "umami",
55
+ path: "umami.websiteId"
56
+ },
57
+ {
58
+ provider: "ga4",
59
+ path: "ga4.propertyId"
60
+ },
61
+ {
62
+ provider: "ga4",
63
+ path: "ga4.projectId"
64
+ },
65
+ {
66
+ provider: "ga4",
67
+ path: "ga4.clientEmail"
68
+ },
69
+ {
70
+ provider: "posthog",
71
+ path: "posthog.host"
72
+ },
73
+ {
74
+ provider: "posthog",
75
+ path: "posthog.region"
76
+ },
77
+ {
78
+ provider: "posthog",
79
+ path: "posthog.projectId"
80
+ },
81
+ {
82
+ provider: "posthog",
83
+ path: "posthog.scopeProperty"
84
+ }
85
+ ];
29
86
  //#endregion
30
- export { SECRET_PATHS };
87
+ export { CONNECTION_PATHS, SECRET_PATHS };
31
88
 
32
89
  //# sourceMappingURL=secrets.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"secrets.js","names":[],"sources":["../../src/providers/secrets.ts"],"sourcesContent":["import type { ProviderId } from './factory'\n\n/**\n * Every credential path in the provider collection. The decrypting provider\n * source derives from this list; `collection.test.ts` asserts it stays in\n * parity with the collection's own secret fields so the two can't drift.\n */\nexport const SECRET_PATHS: ReadonlyArray<{ provider: ProviderId; path: string }> = [\n\t{ provider: 'plausible', path: 'plausible.apiKey' },\n\t{ provider: 'umami', path: 'umami.apiKey' },\n\t{ provider: 'umami', path: 'umami.token' },\n\t{ provider: 'ga4', path: 'ga4.privateKey' },\n\t{ provider: 'posthog', path: 'posthog.apiKey' },\n]\n"],"mappings":";;;;;;AAOA,MAAa,eAAsE;CAClF;EAAE,UAAU;EAAa,MAAM;CAAmB;CAClD;EAAE,UAAU;EAAS,MAAM;CAAe;CAC1C;EAAE,UAAU;EAAS,MAAM;CAAc;CACzC;EAAE,UAAU;EAAO,MAAM;CAAiB;CAC1C;EAAE,UAAU;EAAW,MAAM;CAAiB;AAC/C"}
1
+ {"version":3,"file":"secrets.js","names":[],"sources":["../../src/providers/secrets.ts"],"sourcesContent":["import type { ProviderId } from './factory'\n\n/**\n * Every credential path in the providers collection; `collection.test.ts` holds it to the\n * collection's secret fields.\n *\n * @beta\n */\nexport const SECRET_PATHS: ReadonlyArray<{ provider: ProviderId; path: string }> = [\n\t{ provider: 'plausible', path: 'plausible.apiKey' },\n\t{ provider: 'umami', path: 'umami.apiKey' },\n\t{ provider: 'umami', path: 'umami.token' },\n\t{ provider: 'ga4', path: 'ga4.privateKey' },\n\t{ provider: 'posthog', path: 'posthog.apiKey' },\n]\n\n/**\n * Values that decide where a document's credentials go: changing one clears its stored secrets\n * unless they are sent again. `provider: null` marks the one every provider shares.\n *\n * @beta\n */\nexport const CONNECTION_PATHS: ReadonlyArray<{ provider: ProviderId | null; path: string }> = [\n\t{ provider: null, path: 'provider' },\n\t{ provider: 'plausible', path: 'plausible.host' },\n\t{ provider: 'plausible', path: 'plausible.siteId' },\n\t{ provider: 'umami', path: 'umami.host' },\n\t{ provider: 'umami', path: 'umami.websiteId' },\n\t{ provider: 'ga4', path: 'ga4.propertyId' },\n\t{ provider: 'ga4', path: 'ga4.projectId' },\n\t{ provider: 'ga4', path: 'ga4.clientEmail' },\n\t{ provider: 'posthog', path: 'posthog.host' },\n\t{ provider: 'posthog', path: 'posthog.region' },\n\t{ provider: 'posthog', path: 'posthog.projectId' },\n\t{ provider: 'posthog', path: 'posthog.scopeProperty' },\n]\n"],"mappings":";;;;;;;AAQA,MAAa,eAAsE;CAClF;EAAE,UAAU;EAAa,MAAM;CAAmB;CAClD;EAAE,UAAU;EAAS,MAAM;CAAe;CAC1C;EAAE,UAAU;EAAS,MAAM;CAAc;CACzC;EAAE,UAAU;EAAO,MAAM;CAAiB;CAC1C;EAAE,UAAU;EAAW,MAAM;CAAiB;AAC/C;;;;;;;AAQA,MAAa,mBAAiF;CAC7F;EAAE,UAAU;EAAM,MAAM;CAAW;CACnC;EAAE,UAAU;EAAa,MAAM;CAAiB;CAChD;EAAE,UAAU;EAAa,MAAM;CAAmB;CAClD;EAAE,UAAU;EAAS,MAAM;CAAa;CACxC;EAAE,UAAU;EAAS,MAAM;CAAkB;CAC7C;EAAE,UAAU;EAAO,MAAM;CAAiB;CAC1C;EAAE,UAAU;EAAO,MAAM;CAAgB;CACzC;EAAE,UAAU;EAAO,MAAM;CAAkB;CAC3C;EAAE,UAAU;EAAW,MAAM;CAAe;CAC5C;EAAE,UAAU;EAAW,MAAM;CAAiB;CAC9C;EAAE,UAAU;EAAW,MAAM;CAAoB;CACjD;EAAE,UAAU;EAAW,MAAM;CAAwB;AACtD"}
@@ -1,27 +1,30 @@
1
+ import { isScopeMember } from "../access/membership.js";
1
2
  //#region src/providers/stampScope.ts
2
3
  const asComparable = (value) => value === null || value === void 0 || value === "" ? null : String(value);
4
+ const assertMember = async (args, req, scope) => {
5
+ if (!await isScopeMember(args.member, req, scope)) throw new Error("analytics: cannot create a provider in a scope the user does not belong to");
6
+ };
3
7
  /**
4
- * Stamps the request's resolved scope onto new provider documents and refuses
5
- * scope reassignment, so a tenant admin can neither create a provider for
6
- * another tenant nor move one there. platformRead lifts both restrictions. A
7
- * value already stamped by an external tenant plugin passes through when it
8
- * matches the resolved scope (string-compared, so relationship ids work).
8
+ * Stamps the resolved scope on create and refuses a move or a create outside the user's scopes,
9
+ * whatever access the write overrode; the cross-scope grant lifts all of it.
9
10
  */
10
11
  const stampScope = (args) => {
11
12
  return async ({ data, operation, originalDoc, req }) => {
12
13
  if (!args.scoped || !data) return data;
13
14
  const incoming = asComparable(data[args.scopeField]);
14
- if (await args.platformRead({ req })) return data;
15
+ if (await args.crossScope({ req })) return data;
15
16
  const resolved = await args.resolveScope(req);
16
17
  if (operation === "create") {
17
18
  if (incoming === null) {
18
19
  if (resolved === null) throw new Error("analytics: no scope resolved for provider create");
20
+ await assertMember(args, req, resolved);
19
21
  return {
20
22
  ...data,
21
23
  [args.scopeField]: resolved
22
24
  };
23
25
  }
24
26
  if (incoming !== resolved) throw new Error("analytics: cannot create a provider for another scope");
27
+ await assertMember(args, req, incoming);
25
28
  return data;
26
29
  }
27
30
  const stored = asComparable(originalDoc?.[args.scopeField]);
@@ -1 +1 @@
1
- {"version":3,"file":"stampScope.js","names":[],"sources":["../../src/providers/stampScope.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook } from 'payload'\nimport type { ProviderAccessArgs } from './access'\n\nconst asComparable = (value: unknown): string | null =>\n\tvalue === null || value === undefined || value === '' ? null : String(value)\n\n/**\n * Stamps the request's resolved scope onto new provider documents and refuses\n * scope reassignment, so a tenant admin can neither create a provider for\n * another tenant nor move one there. platformRead lifts both restrictions. A\n * value already stamped by an external tenant plugin passes through when it\n * matches the resolved scope (string-compared, so relationship ids work).\n */\nexport const stampScope = (args: ProviderAccessArgs): CollectionBeforeChangeHook => {\n\treturn async ({ data, operation, originalDoc, req }) => {\n\t\tif (!args.scoped || !data) return data\n\t\tconst incoming = asComparable(data[args.scopeField])\n\t\tconst platform = await args.platformRead({ req })\n\t\tif (platform) return data\n\t\tconst resolved = await args.resolveScope(req)\n\t\tif (operation === 'create') {\n\t\t\tif (incoming === null) {\n\t\t\t\tif (resolved === null) {\n\t\t\t\t\tthrow new Error('analytics: no scope resolved for provider create')\n\t\t\t\t}\n\t\t\t\treturn { ...data, [args.scopeField]: resolved }\n\t\t\t}\n\t\t\tif (incoming !== resolved) {\n\t\t\t\tthrow new Error('analytics: cannot create a provider for another scope')\n\t\t\t}\n\t\t\treturn data\n\t\t}\n\t\tconst stored = asComparable(originalDoc?.[args.scopeField])\n\t\tif (data[args.scopeField] !== undefined && incoming !== stored) {\n\t\t\tthrow new Error('analytics: cannot move a provider to another scope')\n\t\t}\n\t\treturn data\n\t}\n}\n"],"mappings":";AAGA,MAAM,gBAAgB,UACrB,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,KAAK,OAAO,OAAO,KAAK;;;;;;;;AAS5E,MAAa,cAAc,SAAyD;CACnF,OAAO,OAAO,EAAE,MAAM,WAAW,aAAa,UAAU;EACvD,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,OAAO;EAClC,MAAM,WAAW,aAAa,KAAK,KAAK,WAAW;EAEnD,IAAI,MADmB,KAAK,aAAa,EAAE,IAAI,CAAC,GAClC,OAAO;EACrB,MAAM,WAAW,MAAM,KAAK,aAAa,GAAG;EAC5C,IAAI,cAAc,UAAU;GAC3B,IAAI,aAAa,MAAM;IACtB,IAAI,aAAa,MAChB,MAAM,IAAI,MAAM,kDAAkD;IAEnE,OAAO;KAAE,GAAG;MAAO,KAAK,aAAa;IAAS;GAC/C;GACA,IAAI,aAAa,UAChB,MAAM,IAAI,MAAM,uDAAuD;GAExE,OAAO;EACR;EACA,MAAM,SAAS,aAAa,cAAc,KAAK,WAAW;EAC1D,IAAI,KAAK,KAAK,gBAAgB,KAAA,KAAa,aAAa,QACvD,MAAM,IAAI,MAAM,oDAAoD;EAErE,OAAO;CACR;AACD"}
1
+ {"version":3,"file":"stampScope.js","names":[],"sources":["../../src/providers/stampScope.ts"],"sourcesContent":["import type { CollectionBeforeChangeHook, PayloadRequest } from 'payload'\nimport { isScopeMember } from '../access/membership'\nimport type { ProviderAccessArgs } from './access'\n\nconst asComparable = (value: unknown): string | null =>\n\tvalue === null || value === undefined || value === '' ? null : String(value)\n\nconst assertMember = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest,\n\tscope: string\n): Promise<void> => {\n\tif (!(await isScopeMember(args.member, req, scope))) {\n\t\tthrow new Error('analytics: cannot create a provider in a scope the user does not belong to')\n\t}\n}\n\n/**\n * Stamps the resolved scope on create and refuses a move or a create outside the user's scopes,\n * whatever access the write overrode; the cross-scope grant lifts all of it.\n */\nexport const stampScope = (args: ProviderAccessArgs): CollectionBeforeChangeHook => {\n\treturn async ({ data, operation, originalDoc, req }) => {\n\t\tif (!args.scoped || !data) return data\n\t\tconst incoming = asComparable(data[args.scopeField])\n\t\tif (await args.crossScope({ req })) return data\n\t\tconst resolved = await args.resolveScope(req)\n\t\tif (operation === 'create') {\n\t\t\tif (incoming === null) {\n\t\t\t\tif (resolved === null) {\n\t\t\t\t\tthrow new Error('analytics: no scope resolved for provider create')\n\t\t\t\t}\n\t\t\t\tawait assertMember(args, req, resolved)\n\t\t\t\treturn { ...data, [args.scopeField]: resolved }\n\t\t\t}\n\t\t\tif (incoming !== resolved) {\n\t\t\t\tthrow new Error('analytics: cannot create a provider for another scope')\n\t\t\t}\n\t\t\tawait assertMember(args, req, incoming)\n\t\t\treturn data\n\t\t}\n\t\tconst stored = asComparable(originalDoc?.[args.scopeField])\n\t\tif (data[args.scopeField] !== undefined && incoming !== stored) {\n\t\t\tthrow new Error('analytics: cannot move a provider to another scope')\n\t\t}\n\t\treturn data\n\t}\n}\n"],"mappings":";;AAIA,MAAM,gBAAgB,UACrB,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,KAAK,OAAO,OAAO,KAAK;AAE5E,MAAM,eAAe,OACpB,MACA,KACA,UACmB;CACnB,IAAI,CAAE,MAAM,cAAc,KAAK,QAAQ,KAAK,KAAK,GAChD,MAAM,IAAI,MAAM,4EAA4E;AAE9F;;;;;AAMA,MAAa,cAAc,SAAyD;CACnF,OAAO,OAAO,EAAE,MAAM,WAAW,aAAa,UAAU;EACvD,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,OAAO;EAClC,MAAM,WAAW,aAAa,KAAK,KAAK,WAAW;EACnD,IAAI,MAAM,KAAK,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO;EAC3C,MAAM,WAAW,MAAM,KAAK,aAAa,GAAG;EAC5C,IAAI,cAAc,UAAU;GAC3B,IAAI,aAAa,MAAM;IACtB,IAAI,aAAa,MAChB,MAAM,IAAI,MAAM,kDAAkD;IAEnE,MAAM,aAAa,MAAM,KAAK,QAAQ;IACtC,OAAO;KAAE,GAAG;MAAO,KAAK,aAAa;IAAS;GAC/C;GACA,IAAI,aAAa,UAChB,MAAM,IAAI,MAAM,uDAAuD;GAExE,MAAM,aAAa,MAAM,KAAK,QAAQ;GACtC,OAAO;EACR;EACA,MAAM,SAAS,aAAa,cAAc,KAAK,WAAW;EAC1D,IAAI,KAAK,KAAK,gBAAgB,KAAA,KAAa,aAAa,QACvD,MAAM,IAAI,MAAM,oDAAoD;EAErE,OAAO;CACR;AACD"}
@@ -1,9 +1,9 @@
1
1
  import { addDaysInTz, startOfCalendarDayInTz } from "../timeframe/tz.js";
2
+ import "./limits.js";
2
3
  //#region src/query/dates.ts
3
4
  /**
4
- * Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the
5
- * query endpoint's parser, the document panel endpoint, and the widgets' stored custom
6
- * range. A leaf module so those cannot drift apart on what a calendar day means.
5
+ * Range-bound parsing shared by the query parser, document panel endpoint and stored widget ranges,
6
+ * so none drifts on what a calendar day means.
7
7
  */
8
8
  /** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */
9
9
  const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
@@ -23,12 +23,15 @@ const DAYS_IN_MONTH = [
23
23
  31
24
24
  ];
25
25
  const isLeapYear = (year) => year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
26
- /** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */
26
+ /**
27
+ * Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day or one before 1970,
28
+ * which `Date.UTC` would also misread for years 0 to 99.
29
+ */
27
30
  const calendarParts = (raw) => {
28
31
  const year = Number(raw.slice(0, 4));
29
32
  const month = Number(raw.slice(5, 7));
30
33
  const day = Number(raw.slice(8, 10));
31
- if (month < 1 || month > 12) return null;
34
+ if (year < 1970 || month < 1 || month > 12) return null;
32
35
  const lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1];
33
36
  if (lastDay === void 0 || day < 1 || day > lastDay) return null;
34
37
  return {
@@ -38,13 +41,8 @@ const calendarParts = (raw) => {
38
41
  };
39
42
  };
40
43
  /**
41
- * A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is
42
- * its first instant, the end edge its last, matching the inclusive `end` every adapter
43
- * reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other
44
- * accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant
45
- * it names. A datetime without an offset is rejected rather than silently read in the
46
- * server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,
47
- * `Sep 1 2026`).
44
+ * A `YYYY-MM-DD` bound spans the whole day in `timezone` (end edge is its last instant, as adapters
45
+ * read `end` inclusively); otherwise only a datetime with `Z` or `±HH:MM` passes.
48
46
  */
49
47
  const parseDayOrInstant = (raw, args) => {
50
48
  if (DATE_ONLY.test(raw)) {
@@ -1 +1 @@
1
- {"version":3,"file":"dates.js","names":[],"sources":["../../src/query/dates.ts"],"sourcesContent":["import { addDaysInTz, startOfCalendarDayInTz } from '../timeframe/tz'\n\n/**\n * Range-bound parsing, shared by every surface that takes `from`/`to` from outside: the\n * query endpoint's parser, the document panel endpoint, and the widgets' stored custom\n * range. A leaf module so those cannot drift apart on what a calendar day means.\n */\n\n/** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */\nexport const DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/\n\n// Fractional seconds run to nanoseconds because Python emits microseconds; `Date` truncates.\nconst DATE_TIME = /^(\\d{4}-\\d{2}-\\d{2})T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?([Zz]|[+-]\\d{2}:\\d{2})$/\n\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]\n\nconst isLeapYear = (year: number): boolean =>\n\t(year % 4 === 0 && year % 100 !== 0) || year % 400 === 0\n\n/** Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day. */\nconst calendarParts = (raw: string): { year: number; month: number; day: number } | null => {\n\tconst year = Number(raw.slice(0, 4))\n\tconst month = Number(raw.slice(5, 7))\n\tconst day = Number(raw.slice(8, 10))\n\tif (month < 1 || month > 12) {\n\t\treturn null\n\t}\n\tconst lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1]\n\tif (lastDay === undefined || day < 1 || day > lastDay) {\n\t\treturn null\n\t}\n\treturn { year, month, day }\n}\n\nexport interface BoundArgs {\n\t/** Reporting timezone a day string is read in; ignored for an instant. */\n\ttimezone: string\n\t/** Which end of the window this value bounds. */\n\tedge: 'start' | 'end'\n}\n\n/**\n * A range bound. `YYYY-MM-DD` is the whole calendar day in `timezone`: the start edge is\n * its first instant, the end edge its last, matching the inclusive `end` every adapter\n * reads (`less_than_equal`, `timestamp <=`, GA4's inclusive `endDate`). The only other\n * accepted form is a full datetime carrying `Z` or a `±HH:MM` offset, taken as the instant\n * it names. A datetime without an offset is rejected rather than silently read in the\n * server's own zone, and so are the loose forms `Date` would otherwise accept (`2026`,\n * `Sep 1 2026`).\n */\nexport const parseDayOrInstant = (raw: string, args: BoundArgs): Date | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\tconst ymd = calendarParts(raw)\n\t\tif (!ymd) {\n\t\t\treturn null\n\t\t}\n\t\tconst dayStart = startOfCalendarDayInTz(ymd, args.timezone)\n\t\treturn args.edge === 'start'\n\t\t\t? dayStart\n\t\t\t: new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1)\n\t}\n\tconst datePart = DATE_TIME.exec(raw)?.[1]\n\tif (datePart === undefined || !calendarParts(datePart)) {\n\t\treturn null\n\t}\n\tconst parsed = new Date(raw)\n\treturn Number.isNaN(parsed.getTime()) ? null : parsed\n}\n"],"mappings":";;;;;;;;AASA,MAAa,YAAY;AAGzB,MAAM,YAAY;AAElB,MAAM,gBAAgB;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAAE;AAErE,MAAM,cAAc,SAClB,OAAO,MAAM,KAAK,OAAO,QAAQ,KAAM,OAAO,QAAQ;;AAGxD,MAAM,iBAAiB,QAAqE;CAC3F,MAAM,OAAO,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACnC,MAAM,QAAQ,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACpC,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;CACnC,IAAI,QAAQ,KAAK,QAAQ,IACxB,OAAO;CAER,MAAM,UAAU,UAAU,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,QAAQ;CAC7E,IAAI,YAAY,KAAA,KAAa,MAAM,KAAK,MAAM,SAC7C,OAAO;CAER,OAAO;EAAE;EAAM;EAAO;CAAI;AAC3B;;;;;;;;;;AAkBA,MAAa,qBAAqB,KAAa,SAAiC;CAC/E,IAAI,UAAU,KAAK,GAAG,GAAG;EACxB,MAAM,MAAM,cAAc,GAAG;EAC7B,IAAI,CAAC,KACJ,OAAO;EAER,MAAM,WAAW,uBAAuB,KAAK,KAAK,QAAQ;EAC1D,OAAO,KAAK,SAAS,UAClB,2BACA,IAAI,KAAK,YAAY,UAAU,GAAG,KAAK,QAAQ,EAAE,QAAQ,IAAI,CAAC;CAClE;CACA,MAAM,WAAW,UAAU,KAAK,GAAG,IAAI;CACvC,IAAI,aAAa,KAAA,KAAa,CAAC,cAAc,QAAQ,GACpD,OAAO;CAER,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,OAAO,OAAO,MAAM,OAAO,QAAQ,CAAC,IAAI,OAAO;AAChD"}
1
+ {"version":3,"file":"dates.js","names":[],"sources":["../../src/query/dates.ts"],"sourcesContent":["import { addDaysInTz, startOfCalendarDayInTz } from '../timeframe/tz'\nimport { MIN_QUERY_YEAR } from './limits'\n\n/**\n * Range-bound parsing shared by the query parser, document panel endpoint and stored widget ranges,\n * so none drifts on what a calendar day means.\n */\n\n/** The only offset-free bound form: a `YYYY-MM-DD` calendar day. */\nexport const DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/\n\n// Fractional seconds run to nanoseconds because Python emits microseconds; `Date` truncates.\nconst DATE_TIME = /^(\\d{4}-\\d{2}-\\d{2})T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?([Zz]|[+-]\\d{2}:\\d{2})$/\n\nconst DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]\n\nconst isLeapYear = (year: number): boolean =>\n\t(year % 4 === 0 && year % 100 !== 0) || year % 400 === 0\n\n/**\n * Calendar parts of a `YYYY-MM-DD` string, or null when it names no real day or one before 1970,\n * which `Date.UTC` would also misread for years 0 to 99.\n */\nconst calendarParts = (raw: string): { year: number; month: number; day: number } | null => {\n\tconst year = Number(raw.slice(0, 4))\n\tconst month = Number(raw.slice(5, 7))\n\tconst day = Number(raw.slice(8, 10))\n\tif (year < MIN_QUERY_YEAR || month < 1 || month > 12) {\n\t\treturn null\n\t}\n\tconst lastDay = month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1]\n\tif (lastDay === undefined || day < 1 || day > lastDay) {\n\t\treturn null\n\t}\n\treturn { year, month, day }\n}\n\ninterface BoundArgs {\n\t/** Reporting timezone a day string is read in; ignored for an instant. */\n\ttimezone: string\n\tedge: 'start' | 'end'\n}\n\n/**\n * A `YYYY-MM-DD` bound spans the whole day in `timezone` (end edge is its last instant, as adapters\n * read `end` inclusively); otherwise only a datetime with `Z` or `±HH:MM` passes.\n */\nexport const parseDayOrInstant = (raw: string, args: BoundArgs): Date | null => {\n\tif (DATE_ONLY.test(raw)) {\n\t\tconst ymd = calendarParts(raw)\n\t\tif (!ymd) {\n\t\t\treturn null\n\t\t}\n\t\tconst dayStart = startOfCalendarDayInTz(ymd, args.timezone)\n\t\treturn args.edge === 'start'\n\t\t\t? dayStart\n\t\t\t: new Date(addDaysInTz(dayStart, 1, args.timezone).getTime() - 1)\n\t}\n\tconst datePart = DATE_TIME.exec(raw)?.[1]\n\tif (datePart === undefined || !calendarParts(datePart)) {\n\t\treturn null\n\t}\n\tconst parsed = new Date(raw)\n\treturn Number.isNaN(parsed.getTime()) ? null : parsed\n}\n"],"mappings":";;;;;;;;AASA,MAAa,YAAY;AAGzB,MAAM,YAAY;AAElB,MAAM,gBAAgB;CAAC;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;CAAI;AAAE;AAErE,MAAM,cAAc,SAClB,OAAO,MAAM,KAAK,OAAO,QAAQ,KAAM,OAAO,QAAQ;;;;;AAMxD,MAAM,iBAAiB,QAAqE;CAC3F,MAAM,OAAO,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACnC,MAAM,QAAQ,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC;CACpC,MAAM,MAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC;CACnC,IAAI,OAAA,QAAyB,QAAQ,KAAK,QAAQ,IACjD,OAAO;CAER,MAAM,UAAU,UAAU,KAAK,WAAW,IAAI,IAAI,KAAK,cAAc,QAAQ;CAC7E,IAAI,YAAY,KAAA,KAAa,MAAM,KAAK,MAAM,SAC7C,OAAO;CAER,OAAO;EAAE;EAAM;EAAO;CAAI;AAC3B;;;;;AAYA,MAAa,qBAAqB,KAAa,SAAiC;CAC/E,IAAI,UAAU,KAAK,GAAG,GAAG;EACxB,MAAM,MAAM,cAAc,GAAG;EAC7B,IAAI,CAAC,KACJ,OAAO;EAER,MAAM,WAAW,uBAAuB,KAAK,KAAK,QAAQ;EAC1D,OAAO,KAAK,SAAS,UAClB,2BACA,IAAI,KAAK,YAAY,UAAU,GAAG,KAAK,QAAQ,EAAE,QAAQ,IAAI,CAAC;CAClE;CACA,MAAM,WAAW,UAAU,KAAK,GAAG,IAAI;CACvC,IAAI,aAAa,KAAA,KAAa,CAAC,cAAc,QAAQ,GACpD,OAAO;CAER,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,OAAO,OAAO,MAAM,OAAO,QAAQ,CAAC,IAAI,OAAO;AAChD"}
@@ -1,11 +1,7 @@
1
1
  import { AnalyticsError, AnalyticsErrorCode, analyticsError } from "../plugin/errors.js";
2
2
 
3
3
  //#region src/query/errors.d.ts
4
- /**
5
- * The query endpoint's vocabulary, which is the whole plugin's since every endpoint
6
- * answers in one envelope. Kept under its old name so consumers importing it still
7
- * compile; new code reads {@link AnalyticsErrorCode}.
8
- */
4
+ /** Alias of {@link AnalyticsErrorCode}, kept for consumers that imported this name. */
9
5
  type QueryErrorCode = AnalyticsErrorCode;
10
6
  /** Alias of {@link AnalyticsError}, kept for consumers that imported this name. */
11
7
  type QueryError = AnalyticsError;
@@ -1,6 +1,7 @@
1
1
  import { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from "../core/contract.js";
2
- import { QueryError } from "./errors.js";
2
+ import { TimeframePreset } from "../timeframe/presets.js";
3
3
  import { QueryResponse } from "./response.js";
4
+ import { QueryFetchError } from "../ui/data/request.js";
4
5
 
5
6
  //#region src/query/fetchQuery.d.ts
6
7
  /** A client-side mirror of the parameters `parseQueryParams` reads off the request. */
@@ -25,55 +26,47 @@ interface QueryRequest {
25
26
  scope?: string;
26
27
  path?: string;
27
28
  hostname?: string;
29
+ /** One content item's ref; only a source serving `perItemQuery` accepts it. */
30
+ item?: string;
28
31
  timezone?: string;
32
+ /** The preset the range was resolved from, so the read can be kept warm; omitted when custom. */
33
+ timeframe?: TimeframePreset;
29
34
  }
30
35
  /**
31
- * Builds the query endpoint URL from a fixed field order (not object insertion order),
32
- * so two `QueryRequest`s with the same values always produce the same URL string. That
33
- * determinism is what `fetchQuery`'s in-flight dedupe keys on.
36
+ * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the
37
+ * endpoint's URL, or the API route alone, which reads from the default mount.
34
38
  */
35
- declare const buildQueryUrl: (apiRoute: string, request: QueryRequest) => string;
36
- /** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
37
- declare class QueryFetchError extends Error {
38
- readonly status: number;
39
- readonly error?: QueryError;
40
- readonly retryAfter?: number;
41
- constructor(status: number, error?: QueryError, retryAfter?: number);
39
+ declare const buildQueryUrl: (endpoint: string, request: QueryRequest) => string;
40
+ interface FetchQueryInit {
41
+ signal?: AbortSignal;
42
+ /**
43
+ * Reader's request scope (view's `scopeKey`, a picker's `useRequestScope`): reads of one URL for
44
+ * different scopes never share a fetch, so a tenant switch cannot leak an answer.
45
+ */
46
+ scope?: string;
42
47
  }
43
48
  /**
44
- * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
45
- * one underlying fetch; the entry clears on settle (success or failure), so a later call
46
- * always sees fresh data and a failed one retries instead of pinning the error.
47
- *
48
- * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
49
- * aborting it would also cancel every other caller sharing that in-flight request.
50
- * `init.signal` instead races the caller's own promise against the abort: aborting
51
- * rejects that caller without touching the shared fetch. Use distinct requests (varying
52
- * a param) when one caller's cancellation must actually stop the network call.
49
+ * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort
50
+ * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.
53
51
  */
54
- declare const fetchQuery: (apiRoute: string, request: QueryRequest, init?: {
55
- signal?: AbortSignal;
56
- }) => Promise<QueryResponse>;
57
- /** What `POST /analytics/refresh` answers: the scope's epoch token after the bump. */
52
+ declare const fetchQuery: (endpoint: string, request: QueryRequest, init?: FetchQueryInit) => Promise<QueryResponse>;
53
+ /** What the refresh endpoint answers: the scope's epoch token after the bump. */
58
54
  interface RefreshResponse {
59
55
  epoch: string;
60
56
  }
61
57
  interface RefreshRequest {
62
58
  /**
63
- * Refresh another scope. Platform readers only: the endpoint answers
64
- * `400 untrusted_scope` for any caller that may not read across scopes. Omitted, the
59
+ * Refresh another scope (platform readers only; others get `400 untrusted_scope`). Omitted, the
65
60
  * request's own resolved scope is refreshed.
66
61
  */
67
62
  scope?: string;
68
63
  signal?: AbortSignal;
69
64
  }
70
65
  /**
71
- * Raises the scope's cache epoch, so every later read of it misses the cache and reaches
72
- * the provider again. Not deduped, unlike `fetchQuery`: a reader pressing Refresh twice
73
- * means it twice, and the signal can go straight to the fetch because no other caller
74
- * shares it. Rejects with a `QueryFetchError` for any non-2xx answer, the same as a read.
66
+ * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never
67
+ * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.
75
68
  */
76
- declare const refreshCache: (apiRoute: string, request?: RefreshRequest) => Promise<RefreshResponse>;
69
+ declare const refreshCache: (endpoint: string, request?: RefreshRequest) => Promise<RefreshResponse>;
77
70
  //#endregion
78
- export { QueryFetchError, QueryRequest, RefreshRequest, RefreshResponse, buildQueryUrl, fetchQuery, refreshCache };
71
+ export { FetchQueryInit, QueryRequest, RefreshRequest, RefreshResponse, buildQueryUrl, fetchQuery, refreshCache };
79
72
  //# sourceMappingURL=fetchQuery.d.ts.map
@@ -1,117 +1,117 @@
1
- import { QUERY_PATH, REFRESH_PATH } from "../plugin/paths.js";
2
- import { readResponseError } from "../plugin/errors.js";
1
+ import { isRecord } from "../core/values.js";
2
+ import { routePaths } from "../plugin/routes.js";
3
+ import { requestJson, requestShaped } from "../ui/data/request.js";
4
+ import { isQueryResponse } from "./response.js";
3
5
  //#region src/query/fetchQuery.ts
4
- const apiBase = (apiRoute) => apiRoute.endsWith("/") ? apiRoute.slice(0, -1) : apiRoute;
6
+ const DEFAULT_ROUTES = routePaths("/_x");
5
7
  /**
6
- * Builds the query endpoint URL from a fixed field order (not object insertion order),
7
- * so two `QueryRequest`s with the same values always produce the same URL string. That
8
- * determinism is what `fetchQuery`'s in-flight dedupe keys on.
8
+ * The endpoint a caller named: its own URL, which ends in the endpoint's segment whatever the
9
+ * base, or the API route alone (`/api`), which gets the default mount appended.
9
10
  */
10
- const buildQueryUrl = (apiRoute, request) => {
11
- const params = new URLSearchParams();
12
- params.set("metrics", request.metrics.join(","));
13
- if (request.dimensions && request.dimensions.length > 0) params.set("dimensions", request.dimensions.join(","));
14
- params.set("from", request.from);
15
- params.set("to", request.to);
16
- if (request.granularity !== void 0) params.set("granularity", request.granularity);
17
- if (request.filters && request.filters.length > 0) params.set("filters", JSON.stringify(request.filters));
18
- if (request.limit !== void 0) params.set("limit", String(request.limit));
19
- if (request.order !== void 0) params.set("order", `${request.order.metric}:${request.order.direction}`);
20
- if (request.compare !== void 0) params.set("compare", request.compare);
21
- if (request.source !== void 0) params.set("source", request.source);
22
- if (request.scope !== void 0) params.set("scope", request.scope);
23
- if (request.path !== void 0) params.set("path", request.path);
24
- if (request.hostname !== void 0) params.set("hostname", request.hostname);
25
- if (request.timezone !== void 0) params.set("timezone", request.timezone);
26
- return `${apiBase(apiRoute)}${QUERY_PATH}?${params.toString()}`;
11
+ const endpointOf = (given, route) => {
12
+ const trimmed = given.replace(/\/+$/, "");
13
+ return trimmed.endsWith(`/${route}`) ? trimmed : `${trimmed}${DEFAULT_ROUTES[route]}`;
27
14
  };
28
- const isRecord = (value) => typeof value === "object" && value !== null;
29
- /** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
30
- var QueryFetchError = class extends Error {
31
- status;
32
- error;
33
- retryAfter;
34
- constructor(status, error, retryAfter) {
35
- super(error?.message ?? `analytics query request failed with status ${status}`);
36
- this.name = "QueryFetchError";
37
- this.status = status;
38
- if (error !== void 0) this.error = error;
39
- if (retryAfter !== void 0) this.retryAfter = retryAfter;
40
- }
15
+ /**
16
+ * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the
17
+ * endpoint's URL, or the API route alone, which reads from the default mount.
18
+ */
19
+ const buildQueryUrl = (endpoint, request) => {
20
+ const params = new URLSearchParams();
21
+ const put = (name, value) => {
22
+ if (value !== void 0) params.set(name, value);
23
+ };
24
+ const { dimensions, filters, limit, order } = request;
25
+ put("metrics", request.metrics.join(","));
26
+ put("dimensions", dimensions && dimensions.length > 0 ? dimensions.join(",") : void 0);
27
+ put("from", request.from);
28
+ put("to", request.to);
29
+ put("granularity", request.granularity);
30
+ put("filters", filters && filters.length > 0 ? JSON.stringify(filters) : void 0);
31
+ put("limit", limit === void 0 ? void 0 : String(limit));
32
+ put("order", order === void 0 ? void 0 : `${order.metric}:${order.direction}`);
33
+ put("compare", request.compare);
34
+ put("source", request.source);
35
+ put("scope", request.scope);
36
+ put("path", request.path);
37
+ put("hostname", request.hostname);
38
+ put("item", request.item);
39
+ put("timezone", request.timezone);
40
+ put("timeframe", request.timeframe);
41
+ return `${endpointOf(endpoint, "query")}?${params.toString()}`;
41
42
  };
42
- const readRetryAfter = (res) => {
43
- const header = res.headers.get("Retry-After");
44
- if (header === null) return void 0;
45
- const seconds = Number(header);
46
- return Number.isFinite(seconds) ? Math.floor(seconds) : void 0;
43
+ const runFetch = (url, signal) => requestShaped(url, isQueryResponse, { signal });
44
+ const inFlight = /* @__PURE__ */ new Map();
45
+ /** Drops `shared` from the map unless a newer fetch already took its key. */
46
+ const forget = (key, shared) => {
47
+ if (inFlight.get(key) === shared) inFlight.delete(key);
47
48
  };
48
- const failure = async (res) => new QueryFetchError(res.status, await readResponseError(res), readRetryAfter(res));
49
- const runFetch = async (url) => {
50
- const res = await fetch(url, {
51
- credentials: "include",
52
- headers: { Accept: "application/json" }
53
- });
54
- if (!res.ok) throw await failure(res);
55
- return await res.json();
49
+ const sharedFetch = (key, url) => {
50
+ const existing = inFlight.get(key);
51
+ if (existing) return existing;
52
+ const controller = new AbortController();
53
+ const created = {
54
+ controller,
55
+ waiting: 0,
56
+ held: false,
57
+ promise: runFetch(url, controller.signal).finally(() => forget(key, created))
58
+ };
59
+ inFlight.set(key, created);
60
+ return created;
56
61
  };
57
- const inFlight = /* @__PURE__ */ new Map();
58
62
  /**
59
- * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
60
- * one underlying fetch; the entry clears on settle (success or failure), so a later call
61
- * always sees fresh data and a failed one retries instead of pinning the error.
62
- *
63
- * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
64
- * aborting it would also cancel every other caller sharing that in-flight request.
65
- * `init.signal` instead races the caller's own promise against the abort: aborting
66
- * rejects that caller without touching the shared fetch. Use distinct requests (varying
67
- * a param) when one caller's cancellation must actually stop the network call.
63
+ * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort
64
+ * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.
68
65
  */
69
- const fetchQuery = (apiRoute, request, init) => {
70
- const url = buildQueryUrl(apiRoute, request);
71
- let pending = inFlight.get(url);
72
- if (!pending) {
73
- pending = runFetch(url).finally(() => {
74
- inFlight.delete(url);
75
- });
76
- inFlight.set(url, pending);
77
- }
66
+ const fetchQuery = (endpoint, request, init) => {
67
+ const url = buildQueryUrl(endpoint, request);
78
68
  const signal = init?.signal;
79
- if (!signal) return pending;
80
- if (signal.aborted) return Promise.reject(signal.reason);
69
+ if (signal?.aborted) return Promise.reject(signal.reason);
70
+ const key = JSON.stringify([init?.scope ?? "", url]);
71
+ const fetching = sharedFetch(key, url);
72
+ if (!signal) {
73
+ fetching.held = true;
74
+ return fetching.promise;
75
+ }
76
+ fetching.waiting += 1;
81
77
  return new Promise((resolve, reject) => {
82
- const onAbort = () => reject(signal.reason);
83
- signal.addEventListener("abort", onAbort, { once: true });
84
- pending.then((value) => {
78
+ let done = false;
79
+ const settle = () => {
80
+ if (done) return false;
81
+ done = true;
82
+ fetching.waiting -= 1;
85
83
  signal.removeEventListener("abort", onAbort);
86
- resolve(value);
84
+ return true;
85
+ };
86
+ const onAbort = () => {
87
+ if (!settle()) return;
88
+ if (fetching.waiting === 0 && !fetching.held) {
89
+ forget(key, fetching);
90
+ fetching.controller.abort(signal.reason);
91
+ }
92
+ reject(signal.reason);
93
+ };
94
+ signal.addEventListener("abort", onAbort, { once: true });
95
+ fetching.promise.then((value) => {
96
+ if (settle()) resolve(value);
87
97
  }, (err) => {
88
- signal.removeEventListener("abort", onAbort);
89
- reject(err);
98
+ if (settle()) reject(err);
90
99
  });
91
100
  });
92
101
  };
93
102
  /**
94
- * Raises the scope's cache epoch, so every later read of it misses the cache and reaches
95
- * the provider again. Not deduped, unlike `fetchQuery`: a reader pressing Refresh twice
96
- * means it twice, and the signal can go straight to the fetch because no other caller
97
- * shares it. Rejects with a `QueryFetchError` for any non-2xx answer, the same as a read.
103
+ * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never
104
+ * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.
98
105
  */
99
- const refreshCache = async (apiRoute, request = {}) => {
100
- const res = await fetch(`${apiBase(apiRoute)}${REFRESH_PATH}`, {
106
+ const refreshCache = async (endpoint, request = {}) => {
107
+ const body = await requestJson(endpointOf(endpoint, "refresh"), {
101
108
  method: "POST",
102
- credentials: "include",
103
- headers: {
104
- Accept: "application/json",
105
- "Content-Type": "application/json"
106
- },
107
- body: JSON.stringify(request.scope === void 0 ? {} : { scope: request.scope }),
109
+ body: request.scope === void 0 ? {} : { scope: request.scope },
108
110
  ...request.signal === void 0 ? {} : { signal: request.signal }
109
111
  });
110
- if (!res.ok) throw await failure(res);
111
- const body = await res.json();
112
112
  return { epoch: isRecord(body) && typeof body.epoch === "string" ? body.epoch : "0" };
113
113
  };
114
114
  //#endregion
115
- export { QueryFetchError, buildQueryUrl, fetchQuery, refreshCache };
115
+ export { buildQueryUrl, fetchQuery, refreshCache };
116
116
 
117
117
  //# sourceMappingURL=fetchQuery.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { readResponseError } from '../plugin/errors'\nimport { QUERY_PATH, REFRESH_PATH } from '../plugin/paths'\nimport type { QueryError } from './errors'\nimport type { QueryResponse } from './response'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\ttimezone?: string\n}\n\nconst apiBase = (apiRoute: string): string =>\n\tapiRoute.endsWith('/') ? apiRoute.slice(0, -1) : apiRoute\n\n/**\n * Builds the query endpoint URL from a fixed field order (not object insertion order),\n * so two `QueryRequest`s with the same values always produce the same URL string. That\n * determinism is what `fetchQuery`'s in-flight dedupe keys on.\n */\nexport const buildQueryUrl = (apiRoute: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tparams.set('metrics', request.metrics.join(','))\n\tif (request.dimensions && request.dimensions.length > 0) {\n\t\tparams.set('dimensions', request.dimensions.join(','))\n\t}\n\tparams.set('from', request.from)\n\tparams.set('to', request.to)\n\tif (request.granularity !== undefined) {\n\t\tparams.set('granularity', request.granularity)\n\t}\n\tif (request.filters && request.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(request.filters))\n\t}\n\tif (request.limit !== undefined) {\n\t\tparams.set('limit', String(request.limit))\n\t}\n\tif (request.order !== undefined) {\n\t\tparams.set('order', `${request.order.metric}:${request.order.direction}`)\n\t}\n\tif (request.compare !== undefined) {\n\t\tparams.set('compare', request.compare)\n\t}\n\tif (request.source !== undefined) {\n\t\tparams.set('source', request.source)\n\t}\n\tif (request.scope !== undefined) {\n\t\tparams.set('scope', request.scope)\n\t}\n\tif (request.path !== undefined) {\n\t\tparams.set('path', request.path)\n\t}\n\tif (request.hostname !== undefined) {\n\t\tparams.set('hostname', request.hostname)\n\t}\n\tif (request.timezone !== undefined) {\n\t\tparams.set('timezone', request.timezone)\n\t}\n\treturn `${apiBase(apiRoute)}${QUERY_PATH}?${params.toString()}`\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\n\n/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */\nexport class QueryFetchError extends Error {\n\treadonly status: number\n\treadonly error?: QueryError\n\treadonly retryAfter?: number\n\n\tconstructor(status: number, error?: QueryError, retryAfter?: number) {\n\t\tsuper(error?.message ?? `analytics query request failed with status ${status}`)\n\t\tthis.name = 'QueryFetchError'\n\t\tthis.status = status\n\t\tif (error !== undefined) this.error = error\n\t\tif (retryAfter !== undefined) this.retryAfter = retryAfter\n\t}\n}\n\nconst readRetryAfter = (res: Response): number | undefined => {\n\tconst header = res.headers.get('Retry-After')\n\tif (header === null) return undefined\n\t// The HTTP-date form is not a number, so it yields no delay rather than a bogus one;\n\t// a fractional delay floors, since callers schedule in whole seconds.\n\tconst seconds = Number(header)\n\treturn Number.isFinite(seconds) ? Math.floor(seconds) : undefined\n}\n\nconst failure = async (res: Response): Promise<QueryFetchError> =>\n\tnew QueryFetchError(res.status, await readResponseError(res), readRetryAfter(res))\n\nconst runFetch = async (url: string): Promise<QueryResponse> => {\n\tconst res = await fetch(url, {\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json' },\n\t})\n\tif (!res.ok) {\n\t\tthrow await failure(res)\n\t}\n\treturn (await res.json()) as QueryResponse\n}\n\nconst inFlight = new Map<string, Promise<QueryResponse>>()\n\n/**\n * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into\n * one underlying fetch; the entry clears on settle (success or failure), so a later call\n * always sees fresh data and a failed one retries instead of pinning the error.\n *\n * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since\n * aborting it would also cancel every other caller sharing that in-flight request.\n * `init.signal` instead races the caller's own promise against the abort: aborting\n * rejects that caller without touching the shared fetch. Use distinct requests (varying\n * a param) when one caller's cancellation must actually stop the network call.\n */\nexport const fetchQuery = (\n\tapiRoute: string,\n\trequest: QueryRequest,\n\tinit?: { signal?: AbortSignal }\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(apiRoute, request)\n\tlet pending = inFlight.get(url)\n\tif (!pending) {\n\t\tpending = runFetch(url).finally(() => {\n\t\t\tinFlight.delete(url)\n\t\t})\n\t\tinFlight.set(url, pending)\n\t}\n\n\tconst signal = init?.signal\n\tif (!signal) return pending\n\tif (signal.aborted) return Promise.reject(signal.reason)\n\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tconst onAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tpending.then(\n\t\t\t(value) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\tresolve(value)\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\treject(err)\n\t\t\t}\n\t\t)\n\t})\n}\n\n/** What `POST /analytics/refresh` answers: the scope's epoch token after the bump. */\nexport interface RefreshResponse {\n\tepoch: string\n}\n\nexport interface RefreshRequest {\n\t/**\n\t * Refresh another scope. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes. Omitted, the\n\t * request's own resolved scope is refreshed.\n\t */\n\tscope?: string\n\tsignal?: AbortSignal\n}\n\n/**\n * Raises the scope's cache epoch, so every later read of it misses the cache and reaches\n * the provider again. Not deduped, unlike `fetchQuery`: a reader pressing Refresh twice\n * means it twice, and the signal can go straight to the fetch because no other caller\n * shares it. Rejects with a `QueryFetchError` for any non-2xx answer, the same as a read.\n */\nexport const refreshCache = async (\n\tapiRoute: string,\n\trequest: RefreshRequest = {}\n): Promise<RefreshResponse> => {\n\tconst res = await fetch(`${apiBase(apiRoute)}${REFRESH_PATH}`, {\n\t\tmethod: 'POST',\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json', 'Content-Type': 'application/json' },\n\t\tbody: JSON.stringify(request.scope === undefined ? {} : { scope: request.scope }),\n\t\t...(request.signal === undefined ? {} : { signal: request.signal }),\n\t})\n\tif (!res.ok) {\n\t\tthrow await failure(res)\n\t}\n\tconst body: unknown = await res.json()\n\t// The caller acts on the refresh having happened, not on the token, so an answer this\n\t// client cannot read is reported as the initial token rather than typed into a lie.\n\treturn { epoch: isRecord(body) && typeof body.epoch === 'string' ? body.epoch : '0' }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { isRecord } from '../core/values'\nimport { DEFAULT_ROUTE_BASE, routePaths } from '../plugin/routes'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { requestJson, requestShaped } from '../ui/data/request'\nimport { isQueryResponse, type QueryResponse } from './response'\n\nexport { QueryFetchError } from '../ui/data/request'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\t/** One content item's ref; only a source serving `perItemQuery` accepts it. */\n\titem?: string\n\ttimezone?: string\n\t/** The preset the range was resolved from, so the read can be kept warm; omitted when custom. */\n\ttimeframe?: TimeframePreset\n}\n\nconst DEFAULT_ROUTES = routePaths(DEFAULT_ROUTE_BASE)\n\n/**\n * The endpoint a caller named: its own URL, which ends in the endpoint's segment whatever the\n * base, or the API route alone (`/api`), which gets the default mount appended.\n */\nconst endpointOf = (given: string, route: 'query' | 'refresh'): string => {\n\tconst trimmed = given.replace(/\\/+$/, '')\n\treturn trimmed.endsWith(`/${route}`) ? trimmed : `${trimmed}${DEFAULT_ROUTES[route]}`\n}\n\n/**\n * The URL of one read, its fields in a fixed order so `fetchQuery`'s dedupe can key on it. Takes the\n * endpoint's URL, or the API route alone, which reads from the default mount.\n */\nexport const buildQueryUrl = (endpoint: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tconst put = (name: string, value: string | undefined): void => {\n\t\tif (value !== undefined) {\n\t\t\tparams.set(name, value)\n\t\t}\n\t}\n\tconst { dimensions, filters, limit, order } = request\n\tput('metrics', request.metrics.join(','))\n\tput('dimensions', dimensions && dimensions.length > 0 ? dimensions.join(',') : undefined)\n\tput('from', request.from)\n\tput('to', request.to)\n\tput('granularity', request.granularity)\n\tput('filters', filters && filters.length > 0 ? JSON.stringify(filters) : undefined)\n\tput('limit', limit === undefined ? undefined : String(limit))\n\tput('order', order === undefined ? undefined : `${order.metric}:${order.direction}`)\n\tput('compare', request.compare)\n\tput('source', request.source)\n\tput('scope', request.scope)\n\tput('path', request.path)\n\tput('hostname', request.hostname)\n\tput('item', request.item)\n\tput('timezone', request.timezone)\n\tput('timeframe', request.timeframe)\n\treturn `${endpointOf(endpoint, 'query')}?${params.toString()}`\n}\n\nconst runFetch = (url: string, signal: AbortSignal): Promise<QueryResponse> =>\n\trequestShaped(url, isQueryResponse, { signal })\n\n/** One fetch every identical concurrent read shares, and who is still waiting on it. */\ninterface SharedFetch {\n\tpromise: Promise<QueryResponse>\n\tcontroller: AbortController\n\t/** Callers that brought a signal and have neither aborted nor been answered. */\n\twaiting: number\n\t/** A caller brought no signal, so it can never abort: the fetch runs to its end. */\n\theld: boolean\n}\n\nconst inFlight = new Map<string, SharedFetch>()\n\n/** Drops `shared` from the map unless a newer fetch already took its key. */\nconst forget = (key: string, shared: SharedFetch): void => {\n\tif (inFlight.get(key) === shared) {\n\t\tinFlight.delete(key)\n\t}\n}\n\nconst sharedFetch = (key: string, url: string): SharedFetch => {\n\tconst existing = inFlight.get(key)\n\tif (existing) {\n\t\treturn existing\n\t}\n\tconst controller = new AbortController()\n\tconst created: SharedFetch = {\n\t\tcontroller,\n\t\twaiting: 0,\n\t\theld: false,\n\t\tpromise: runFetch(url, controller.signal).finally(() => forget(key, created)),\n\t}\n\tinFlight.set(key, created)\n\treturn created\n}\n\nexport interface FetchQueryInit {\n\tsignal?: AbortSignal\n\t/**\n\t * Reader's request scope (view's `scopeKey`, a picker's `useRequestScope`): reads of one URL for\n\t * different scopes never share a fetch, so a tenant switch cannot leak an answer.\n\t */\n\tscope?: string\n}\n\n/**\n * Shares one fetch among concurrent identical reads (same scope and URL) until it settles. An abort\n * rejects only its caller; the fetch aborts once every sharer has and none lacks a signal.\n */\nexport const fetchQuery = (\n\tendpoint: string,\n\trequest: QueryRequest,\n\tinit?: FetchQueryInit\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(endpoint, request)\n\tconst signal = init?.signal\n\tif (signal?.aborted) {\n\t\treturn Promise.reject(signal.reason)\n\t}\n\tconst key = JSON.stringify([init?.scope ?? '', url])\n\tconst fetching = sharedFetch(key, url)\n\tif (!signal) {\n\t\tfetching.held = true\n\t\treturn fetching.promise\n\t}\n\tfetching.waiting += 1\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tlet done = false\n\t\tconst settle = (): boolean => {\n\t\t\tif (done) {\n\t\t\t\treturn false\n\t\t\t}\n\t\t\tdone = true\n\t\t\tfetching.waiting -= 1\n\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\treturn true\n\t\t}\n\t\tconst onAbort = (): void => {\n\t\t\tif (!settle()) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (fetching.waiting === 0 && !fetching.held) {\n\t\t\t\tforget(key, fetching)\n\t\t\t\tfetching.controller.abort(signal.reason)\n\t\t\t}\n\t\t\treject(signal.reason)\n\t\t}\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tfetching.promise.then(\n\t\t\t(value) => {\n\t\t\t\tif (settle()) {\n\t\t\t\t\tresolve(value)\n\t\t\t\t}\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tif (settle()) {\n\t\t\t\t\treject(err)\n\t\t\t\t}\n\t\t\t}\n\t\t)\n\t})\n}\n\n/** What the refresh endpoint answers: the scope's epoch token after the bump. */\nexport interface RefreshResponse {\n\tepoch: string\n}\n\nexport interface RefreshRequest {\n\t/**\n\t * Refresh another scope (platform readers only; others get `400 untrusted_scope`). Omitted, the\n\t * request's own resolved scope is refreshed.\n\t */\n\tscope?: string\n\tsignal?: AbortSignal\n}\n\n/**\n * Raises the scope's cache epoch through the refresh endpoint (or the API route alone), never\n * deduped: Refresh pressed twice means it twice. Rejects with a `QueryFetchError` on non-2xx.\n */\nexport const refreshCache = async (\n\tendpoint: string,\n\trequest: RefreshRequest = {}\n): Promise<RefreshResponse> => {\n\tconst body = await requestJson(endpointOf(endpoint, 'refresh'), {\n\t\tmethod: 'POST',\n\t\tbody: request.scope === undefined ? {} : { scope: request.scope },\n\t\t...(request.signal === undefined ? {} : { signal: request.signal }),\n\t})\n\t// The caller acts on the refresh having happened, not on the token, so an answer this\n\t// client cannot read is reported as the initial token rather than typed into a lie.\n\treturn { epoch: isRecord(body) && typeof body.epoch === 'string' ? body.epoch : '0' }\n}\n"],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /** Whether a window is longer than {@link MAX_QUERY_RANGE_DAYS}, which every read path refuses. */
2
+ const exceedsRangeCap = (range) => range.end.getTime() - range.start.getTime() > 366 * 864e5;
3
+ /** The earliest year a bound may name: nothing was counted before 1970. */
4
+ const MIN_QUERY_YEAR = 1970;
5
+ //#endregion
6
+ export { MIN_QUERY_YEAR, exceedsRangeCap };
7
+
8
+ //# sourceMappingURL=limits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"limits.js","names":[],"sources":["../../src/query/limits.ts"],"sourcesContent":["/**\n * Leaf module with no imports, so the admin view and browser tracker share these bounds without\n * pulling the server parser or ingest pipeline into their bundles.\n */\n\nexport const MAX_QUERY_METRICS = 10\nexport const MAX_QUERY_DIMENSIONS = 2\nexport const MAX_QUERY_FILTERS = 10\nexport const MIN_QUERY_LIMIT = 1\nexport const MAX_QUERY_LIMIT = 500\nexport const DEFAULT_QUERY_LIMIT = 50\nexport const MAX_QUERY_RANGE_DAYS = 366\n\n/** Whether a window is longer than {@link MAX_QUERY_RANGE_DAYS}, which every read path refuses. */\nexport const exceedsRangeCap = (range: { start: Date; end: Date }): boolean =>\n\trange.end.getTime() - range.start.getTime() > MAX_QUERY_RANGE_DAYS * 86_400_000\n\n/** The earliest year a bound may name: nothing was counted before 1970. */\nexport const MIN_QUERY_YEAR = 1970\n\nexport const MAX_SCOPE_LENGTH = 256\nexport const MAX_QUERY_FILTER_VALUE_LENGTH = 256\nexport const MAX_QUERY_PATH_LENGTH = 512\nexport const MAX_QUERY_HOSTNAME_LENGTH = 253\n\n/**\n * Ingest wire caps, not read-path bounds. `MAX_QUERY_LENGTH` is the page's own query string (utm\n * source), capped by the tracker and again by public ingest.\n */\nexport const MAX_QUERY_LENGTH = 512\nexport const MAX_REFERRER_LENGTH = 512\n\n/**\n * Caps each geo value: it comes from client-settable headers and keys daily totals, where an\n * oversized one fails Postgres's 2704-byte btree limit but passes Mongo.\n */\nexport const MAX_GEO_LENGTH = 128\n"],"mappings":";AAcA,MAAa,mBAAmB,UAC/B,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,IAAA,MAA2B;;AAGtE,MAAa,iBAAiB"}
@@ -1,5 +1,6 @@
1
1
  import { AnalyticsQuery } from "../core/contract.js";
2
2
  import { AnalyticsError } from "../plugin/errors.js";
3
+ import { TimeframePreset } from "../timeframe/presets.js";
3
4
 
4
5
  //#region src/query/parse.d.ts
5
6
  /**
@@ -9,6 +10,11 @@ import { AnalyticsError } from "../plugin/errors.js";
9
10
  interface ParsedQuery {
10
11
  query: AnalyticsQuery;
11
12
  compare: 'previous' | null;
13
+ /**
14
+ * The named timeframe the caller resolved `from` and `to` from, which lets the read be stored
15
+ * for the warm task to repeat; null when the caller named none.
16
+ */
17
+ timeframe: TimeframePreset | null;
12
18
  }
13
19
  type ParseResult = {
14
20
  ok: true;