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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1,40 @@
1
+ import { currentTime } from "../core/clock.js";
2
+ /** How long an aggregate read is answered from memory before the store is asked again. */
3
+ const AGGREGATE_MEMO_MS = 15e3;
4
+ const createMemo = (options = {}) => {
5
+ const capacity = options.capacity ?? 500;
6
+ const now = options.now ?? currentTime;
7
+ const entries = /* @__PURE__ */ new Map();
8
+ return {
9
+ get(key) {
10
+ const entry = entries.get(key);
11
+ if (!entry) return;
12
+ entries.delete(key);
13
+ if (entry.expiresAt <= now()) return;
14
+ entries.set(key, entry);
15
+ return entry.value;
16
+ },
17
+ set(key, value, ttlMs) {
18
+ entries.delete(key);
19
+ if (!(ttlMs > 0)) return;
20
+ entries.set(key, {
21
+ value,
22
+ expiresAt: now() + ttlMs
23
+ });
24
+ for (const oldest of entries.keys()) {
25
+ if (entries.size <= capacity) break;
26
+ entries.delete(oldest);
27
+ }
28
+ },
29
+ delete(key) {
30
+ entries.delete(key);
31
+ },
32
+ get size() {
33
+ return entries.size;
34
+ }
35
+ };
36
+ };
37
+ //#endregion
38
+ export { AGGREGATE_MEMO_MS, createMemo };
39
+
40
+ //# sourceMappingURL=memo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memo.js","names":[],"sources":["../../src/surfacing/memo.ts"],"sourcesContent":["import { currentTime } from '../core/clock'\n\n/** The most entries one instance keeps in memory. */\nexport const MEMO_CAPACITY = 500\n\n/** How long an aggregate read is answered from memory before the store is asked again. */\nexport const AGGREGATE_MEMO_MS = 15_000\n\n/**\n * In-process LRU cache in front of the store, one per Payload instance, each entry with its own\n * TTL. Values are shared between callers, so none may change one.\n */\nexport interface Memo<V> {\n\tget(key: string): V | undefined\n\t/** Keeps `value` for `ttlMs`; nothing is kept for a time of zero or less. */\n\tset(key: string, value: V, ttlMs: number): void\n\tdelete(key: string): void\n\treadonly size: number\n}\n\nexport const createMemo = <V>(options: { capacity?: number; now?: () => number } = {}): Memo<V> => {\n\tconst capacity = options.capacity ?? MEMO_CAPACITY\n\tconst now = options.now ?? currentTime\n\t// A Map iterates in insertion order, so re-inserting on use keeps the least recent first.\n\tconst entries = new Map<string, { value: V; expiresAt: number }>()\n\treturn {\n\t\tget(key) {\n\t\t\tconst entry = entries.get(key)\n\t\t\tif (!entry) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tentries.delete(key)\n\t\t\tif (entry.expiresAt <= now()) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tentries.set(key, entry)\n\t\t\treturn entry.value\n\t\t},\n\t\tset(key, value, ttlMs) {\n\t\t\tentries.delete(key)\n\t\t\tif (!(ttlMs > 0)) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tentries.set(key, { value, expiresAt: now() + ttlMs })\n\t\t\tfor (const oldest of entries.keys()) {\n\t\t\t\tif (entries.size <= capacity) {\n\t\t\t\t\tbreak\n\t\t\t\t}\n\t\t\t\tentries.delete(oldest)\n\t\t\t}\n\t\t},\n\t\tdelete(key) {\n\t\t\tentries.delete(key)\n\t\t},\n\t\tget size() {\n\t\t\treturn entries.size\n\t\t},\n\t}\n}\n"],"mappings":";;AAMA,MAAa,oBAAoB;AAcjC,MAAa,cAAiB,UAAqD,CAAC,MAAe;CAClG,MAAM,WAAW,QAAQ,YAAA;CACzB,MAAM,MAAM,QAAQ,OAAO;CAE3B,MAAM,0BAAU,IAAI,IAA6C;CACjE,OAAO;EACN,IAAI,KAAK;GACR,MAAM,QAAQ,QAAQ,IAAI,GAAG;GAC7B,IAAI,CAAC,OACJ;GAED,QAAQ,OAAO,GAAG;GAClB,IAAI,MAAM,aAAa,IAAI,GAC1B;GAED,QAAQ,IAAI,KAAK,KAAK;GACtB,OAAO,MAAM;EACd;EACA,IAAI,KAAK,OAAO,OAAO;GACtB,QAAQ,OAAO,GAAG;GAClB,IAAI,EAAE,QAAQ,IACb;GAED,QAAQ,IAAI,KAAK;IAAE;IAAO,WAAW,IAAI,IAAI;GAAM,CAAC;GACpD,KAAK,MAAM,UAAU,QAAQ,KAAK,GAAG;IACpC,IAAI,QAAQ,QAAQ,UACnB;IAED,QAAQ,OAAO,MAAM;GACtB;EACD;EACA,OAAO,KAAK;GACX,QAAQ,OAAO,GAAG;EACnB;EACA,IAAI,OAAO;GACV,OAAO,QAAQ;EAChB;CACD;AACD"}
@@ -0,0 +1 @@
1
+ export { };
@@ -1,6 +1,13 @@
1
+ import { HOUR_MS, MINUTE_MS } from "../timeframe/tz.js";
2
+ import { monotonicMs } from "../core/monotonic.js";
1
3
  //#region src/surfacing/rateLimiter.ts
2
- const MINUTE_MS = 6e4;
3
- const HOUR_MS = 36e5;
4
+ const RANK = {
5
+ interactive: 0,
6
+ normal: 1,
7
+ background: 2
8
+ };
9
+ /** The first of `waiting` with the most urgent priority. */
10
+ const mostUrgent = (waiting) => waiting.reduce((best, each) => best === void 0 || RANK[each.priority] < RANK[best.priority] ? each : best, void 0);
4
11
  const createBucket = (capacity, windowMs) => {
5
12
  const intervalMs = windowMs / capacity;
6
13
  let tokens = capacity;
@@ -19,8 +26,7 @@ const createBucket = (capacity, windowMs) => {
19
26
  return {
20
27
  waitMs(now) {
21
28
  sync(now);
22
- if (tokens >= 1) return 0;
23
- return Math.ceil((1 - tokens) * intervalMs);
29
+ return tokens >= 1 ? 0 : Math.ceil((1 - tokens) * intervalMs);
24
30
  },
25
31
  take(now) {
26
32
  sync(now);
@@ -28,103 +34,72 @@ const createBucket = (capacity, windowMs) => {
28
34
  }
29
35
  };
30
36
  };
31
- const sleep = (ms, signal) => {
32
- if (signal?.aborted) return Promise.reject(signal.reason);
33
- return new Promise((resolve, reject) => {
34
- const timer = setTimeout(() => {
35
- signal?.removeEventListener("abort", onAbort);
36
- resolve();
37
- }, ms);
38
- const onAbort = () => {
39
- clearTimeout(timer);
40
- reject(signal?.reason);
41
- };
42
- signal?.addEventListener("abort", onAbort, { once: true });
43
- });
44
- };
45
- /**
46
- * Waits until every bucket holds a token, then deducts one from each. Bucket checks and
47
- * deductions happen synchronously (no await between them) so a zero-wait pass can never
48
- * race; a non-zero wait rechecks after sleeping since a concurrent taker may have spent
49
- * the token first.
50
- */
51
- const acquireTokens = async (buckets, clock, signal) => {
52
- for (;;) {
37
+ const UNLIMITED = {
38
+ take: async ({ signal }) => {
53
39
  if (signal?.aborted) throw signal.reason;
54
- const now = clock();
55
- const maxWait = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(now)), 0);
56
- if (maxWait === 0) {
57
- for (const bucket of buckets) bucket.take(now);
58
- return;
59
- }
60
- await sleep(maxWait, signal);
61
- }
62
- };
63
- const createSemaphore = (capacity) => {
64
- let active = 0;
65
- const waiters = [];
66
- const release = () => {
67
- active--;
68
- waiters.shift()?.();
69
- };
70
- return { acquire(signal) {
71
- if (signal?.aborted) return Promise.reject(signal.reason);
72
- if (active < capacity) {
73
- active++;
74
- return Promise.resolve(release);
75
- }
76
- return new Promise((resolve, reject) => {
77
- const onAbort = () => {
78
- const idx = waiters.indexOf(grant);
79
- if (idx !== -1) waiters.splice(idx, 1);
80
- reject(signal?.reason);
81
- };
82
- const grant = () => {
83
- signal?.removeEventListener("abort", onAbort);
84
- active++;
85
- resolve(release);
86
- };
87
- waiters.push(grant);
88
- signal?.addEventListener("abort", onAbort, { once: true });
89
- });
90
- } };
40
+ },
41
+ waiting: 0
91
42
  };
92
- const noopRelease = () => {};
93
43
  /**
94
- * Builds a limiter from an adapter's declared RateLimitDescriptor; a null descriptor
95
- * returns an unlimited pass-through. requestsPerMinute and requestsPerHour each maintain
96
- * their own continuously refilling token bucket and a take needs a token from every
97
- * configured bucket; maxConcurrent is a plain semaphore released by the returned function.
98
- * Token deductions are never released; they represent quota already spent.
44
+ * The token source a descriptor declares: one refilling bucket per named window, a take needing a
45
+ * token from each. `maxConcurrent` is not a token; the lane turns it into its slot count.
99
46
  */
100
- const createRateLimiter = (descriptor, clock = Date.now) => {
101
- if (!descriptor) return { take: async () => noopRelease };
47
+ const createTokenSource = (descriptor, now = monotonicMs) => {
102
48
  const buckets = [];
103
- if (descriptor.requestsPerMinute) buckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS));
104
- if (descriptor.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS));
105
- const semaphore = descriptor.maxConcurrent ? createSemaphore(descriptor.maxConcurrent) : void 0;
106
- return { async take(signal) {
107
- if (signal?.aborted) throw signal.reason;
108
- const releaseConcurrency = semaphore ? await semaphore.acquire(signal) : noopRelease;
109
- try {
110
- if (buckets.length) await acquireTokens(buckets, clock, signal);
111
- return releaseConcurrency;
112
- } catch (err) {
113
- releaseConcurrency();
114
- throw err;
49
+ if (descriptor?.requestsPerMinute) buckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS));
50
+ if (descriptor?.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS));
51
+ if (buckets.length === 0) return UNLIMITED;
52
+ const takers = [];
53
+ let timer;
54
+ const next = () => mostUrgent(takers);
55
+ const pump = () => {
56
+ clearTimeout(timer);
57
+ timer = void 0;
58
+ for (;;) {
59
+ const taker = next();
60
+ if (!taker) return;
61
+ const at = now();
62
+ const waitMs = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(at)), 0);
63
+ if (waitMs > 0) {
64
+ timer = setTimeout(pump, waitMs);
65
+ timer.unref?.();
66
+ return;
67
+ }
68
+ for (const bucket of buckets) bucket.take(at);
69
+ takers.splice(takers.indexOf(taker), 1);
70
+ taker.grant();
115
71
  }
116
- } };
117
- };
118
- /** Returns the adapter's limiter, building and caching it from its declared rateLimit on first use. */
119
- const limiterFor = (map, adapter, clock) => {
120
- let limiter = map.get(adapter.id);
121
- if (!limiter) {
122
- limiter = createRateLimiter(adapter.capabilities.rateLimit, clock);
123
- map.set(adapter.id, limiter);
124
- }
125
- return limiter;
72
+ };
73
+ return {
74
+ take({ signal, priority }) {
75
+ if (signal?.aborted) return Promise.reject(signal.reason);
76
+ return new Promise((resolve, reject) => {
77
+ const onAbort = () => {
78
+ const index = takers.indexOf(taker);
79
+ if (index !== -1) {
80
+ takers.splice(index, 1);
81
+ pump();
82
+ }
83
+ reject(signal?.reason);
84
+ };
85
+ const taker = {
86
+ priority,
87
+ grant: () => {
88
+ signal?.removeEventListener("abort", onAbort);
89
+ resolve();
90
+ }
91
+ };
92
+ takers.push(taker);
93
+ signal?.addEventListener("abort", onAbort, { once: true });
94
+ pump();
95
+ });
96
+ },
97
+ get waiting() {
98
+ return takers.length;
99
+ }
100
+ };
126
101
  };
127
102
  //#endregion
128
- export { limiterFor };
103
+ export { createTokenSource, mostUrgent };
129
104
 
130
105
  //# sourceMappingURL=rateLimiter.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"rateLimiter.js","names":[],"sources":["../../src/surfacing/rateLimiter.ts"],"sourcesContent":["import type { AnalyticsAdapter, RateLimitDescriptor } from '../core/contract'\n\nexport interface RateLimiter {\n\t/** Resolves when a request slot is available; rejects with the signal's reason when aborted while waiting. Release must be called exactly once per successful take. */\n\ttake(signal?: AbortSignal): Promise<() => void>\n}\n\nconst MINUTE_MS = 60_000\nconst HOUR_MS = 3_600_000\n\ninterface TokenBucket {\n\twaitMs(now: number): number\n\ttake(now: number): void\n}\n\nconst createBucket = (capacity: number, windowMs: number): TokenBucket => {\n\t// ms per token, rather than tokens-per-ms: for every descriptor value in this codebase\n\t// windowMs divides evenly by capacity, so this stays exact and sidesteps the float\n\t// drift a capacity/windowMs rate would reintroduce on the multiply-then-divide round trip.\n\tconst intervalMs = windowMs / capacity\n\tlet tokens = capacity\n\tlet last: number | undefined\n\n\tconst sync = (now: number): void => {\n\t\tif (last === undefined) {\n\t\t\tlast = now\n\t\t\treturn\n\t\t}\n\t\tconst elapsed = now - last\n\t\tif (elapsed > 0) {\n\t\t\ttokens = Math.min(capacity, tokens + elapsed / intervalMs)\n\t\t\tlast = now\n\t\t}\n\t}\n\n\treturn {\n\t\twaitMs(now) {\n\t\t\tsync(now)\n\t\t\tif (tokens >= 1) return 0\n\t\t\treturn Math.ceil((1 - tokens) * intervalMs)\n\t\t},\n\t\ttake(now) {\n\t\t\tsync(now)\n\t\t\ttokens -= 1\n\t\t},\n\t}\n}\n\nconst sleep = (ms: number, signal?: AbortSignal): Promise<void> => {\n\tif (signal?.aborted) return Promise.reject(signal.reason)\n\treturn new Promise<void>((resolve, reject) => {\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\tresolve()\n\t\t}, ms)\n\t\tconst onAbort = (): void => {\n\t\t\tclearTimeout(timer)\n\t\t\treject(signal?.reason)\n\t\t}\n\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t})\n}\n\n/**\n * Waits until every bucket holds a token, then deducts one from each. Bucket checks and\n * deductions happen synchronously (no await between them) so a zero-wait pass can never\n * race; a non-zero wait rechecks after sleeping since a concurrent taker may have spent\n * the token first.\n */\nconst acquireTokens = async (\n\tbuckets: TokenBucket[],\n\tclock: () => number,\n\tsignal?: AbortSignal\n): Promise<void> => {\n\tfor (;;) {\n\t\tif (signal?.aborted) throw signal.reason\n\t\tconst now = clock()\n\t\tconst maxWait = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(now)), 0)\n\t\tif (maxWait === 0) {\n\t\t\tfor (const bucket of buckets) bucket.take(now)\n\t\t\treturn\n\t\t}\n\t\tawait sleep(maxWait, signal)\n\t}\n}\n\ninterface Semaphore {\n\tacquire(signal?: AbortSignal): Promise<() => void>\n}\n\nconst createSemaphore = (capacity: number): Semaphore => {\n\tlet active = 0\n\tconst waiters: Array<() => void> = []\n\n\tconst release = (): void => {\n\t\tactive--\n\t\twaiters.shift()?.()\n\t}\n\n\treturn {\n\t\tacquire(signal) {\n\t\t\tif (signal?.aborted) return Promise.reject(signal.reason)\n\t\t\tif (active < capacity) {\n\t\t\t\tactive++\n\t\t\t\treturn Promise.resolve(release)\n\t\t\t}\n\t\t\treturn new Promise<() => void>((resolve, reject) => {\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst idx = waiters.indexOf(grant)\n\t\t\t\t\tif (idx !== -1) waiters.splice(idx, 1)\n\t\t\t\t\treject(signal?.reason)\n\t\t\t\t}\n\t\t\t\tconst grant = (): void => {\n\t\t\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\t\t\tactive++\n\t\t\t\t\tresolve(release)\n\t\t\t\t}\n\t\t\t\twaiters.push(grant)\n\t\t\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t\t\t})\n\t\t},\n\t}\n}\n\nconst noopRelease = (): void => {}\n\n/**\n * Builds a limiter from an adapter's declared RateLimitDescriptor; a null descriptor\n * returns an unlimited pass-through. requestsPerMinute and requestsPerHour each maintain\n * their own continuously refilling token bucket and a take needs a token from every\n * configured bucket; maxConcurrent is a plain semaphore released by the returned function.\n * Token deductions are never released; they represent quota already spent.\n */\nexport const createRateLimiter = (\n\tdescriptor: RateLimitDescriptor | null,\n\tclock: () => number = Date.now\n): RateLimiter => {\n\tif (!descriptor) {\n\t\treturn { take: async () => noopRelease }\n\t}\n\n\tconst buckets: TokenBucket[] = []\n\tif (descriptor.requestsPerMinute)\n\t\tbuckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS))\n\tif (descriptor.requestsPerHour) buckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS))\n\tconst semaphore = descriptor.maxConcurrent ? createSemaphore(descriptor.maxConcurrent) : undefined\n\n\treturn {\n\t\tasync take(signal) {\n\t\t\tif (signal?.aborted) throw signal.reason\n\t\t\tconst releaseConcurrency = semaphore ? await semaphore.acquire(signal) : noopRelease\n\t\t\ttry {\n\t\t\t\tif (buckets.length) await acquireTokens(buckets, clock, signal)\n\t\t\t\treturn releaseConcurrency\n\t\t\t} catch (err) {\n\t\t\t\treleaseConcurrency()\n\t\t\t\tthrow err\n\t\t\t}\n\t\t},\n\t}\n}\n\n/** Returns the adapter's limiter, building and caching it from its declared rateLimit on first use. */\nexport const limiterFor = (\n\tmap: Map<string, RateLimiter>,\n\tadapter: AnalyticsAdapter,\n\tclock?: () => number\n): RateLimiter => {\n\tlet limiter = map.get(adapter.id)\n\tif (!limiter) {\n\t\tlimiter = createRateLimiter(adapter.capabilities.rateLimit, clock)\n\t\tmap.set(adapter.id, limiter)\n\t}\n\treturn limiter\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"rateLimiter.js","names":[],"sources":["../../src/surfacing/rateLimiter.ts"],"sourcesContent":["import type { RateLimitDescriptor } from '../core/contract'\nimport { monotonicMs } from '../core/monotonic'\nimport { HOUR_MS, MINUTE_MS } from '../timeframe/tz'\n\n/**\n * Who is asking, the first served first: a reader of an open panel or view, any other reader (a\n * sidebar stat, host code), or work nobody waits on (refreshes, jobs).\n */\nexport type Priority = 'interactive' | 'normal' | 'background'\n\nconst RANK: Readonly<Record<Priority, number>> = { interactive: 0, normal: 1, background: 2 }\n\n/** The first of `waiting` with the most urgent priority. */\nexport const mostUrgent = <T extends { priority: Priority }>(\n\twaiting: readonly T[]\n): T | undefined =>\n\twaiting.reduce<T | undefined>(\n\t\t(best, each) => (best === undefined || RANK[each.priority] < RANK[best.priority] ? each : best),\n\t\tundefined\n\t)\n\n/**\n * The quota of one source: one token per upstream request, from every bucket its\n * `rateLimit` declares. Tokens are spent, never given back.\n */\nexport interface TokenSource {\n\t/**\n\t * Resolves once a token is spent for one upstream request, the most urgent taker first, each\n\t * priority in arrival order. Rejects with the signal's reason when it aborts first.\n\t */\n\ttake(options: { signal?: AbortSignal; priority: Priority }): Promise<void>\n\t/** Takers still waiting, for tests and health. */\n\treadonly waiting: number\n}\n\ninterface TokenBucket {\n\twaitMs(now: number): number\n\ttake(now: number): void\n}\n\nconst createBucket = (capacity: number, windowMs: number): TokenBucket => {\n\t// ms per token, rather than tokens per ms: every descriptor in this codebase divides its window\n\t// evenly, so this stays exact where a capacity/windowMs rate would drift.\n\tconst intervalMs = windowMs / capacity\n\tlet tokens = capacity\n\tlet last: number | undefined\n\n\tconst sync = (now: number): void => {\n\t\tif (last === undefined) {\n\t\t\tlast = now\n\t\t\treturn\n\t\t}\n\t\tconst elapsed = now - last\n\t\tif (elapsed > 0) {\n\t\t\ttokens = Math.min(capacity, tokens + elapsed / intervalMs)\n\t\t\tlast = now\n\t\t}\n\t}\n\n\treturn {\n\t\twaitMs(now) {\n\t\t\tsync(now)\n\t\t\treturn tokens >= 1 ? 0 : Math.ceil((1 - tokens) * intervalMs)\n\t\t},\n\t\ttake(now) {\n\t\t\tsync(now)\n\t\t\ttokens -= 1\n\t\t},\n\t}\n}\n\ninterface Taker {\n\tpriority: Priority\n\tgrant: () => void\n}\n\nconst UNLIMITED: TokenSource = {\n\ttake: async ({ signal }) => {\n\t\tif (signal?.aborted) {\n\t\t\tthrow signal.reason\n\t\t}\n\t},\n\twaiting: 0,\n}\n\n/**\n * The token source a descriptor declares: one refilling bucket per named window, a take needing a\n * token from each. `maxConcurrent` is not a token; the lane turns it into its slot count.\n */\nexport const createTokenSource = (\n\tdescriptor: RateLimitDescriptor | null,\n\tnow: () => number = monotonicMs\n): TokenSource => {\n\tconst buckets: TokenBucket[] = []\n\tif (descriptor?.requestsPerMinute) {\n\t\tbuckets.push(createBucket(descriptor.requestsPerMinute, MINUTE_MS))\n\t}\n\tif (descriptor?.requestsPerHour) {\n\t\tbuckets.push(createBucket(descriptor.requestsPerHour, HOUR_MS))\n\t}\n\tif (buckets.length === 0) {\n\t\treturn UNLIMITED\n\t}\n\tconst takers: Taker[] = []\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\n\tconst next = (): Taker | undefined => mostUrgent(takers)\n\n\t// Bucket checks and deductions happen with no await between them, so two takers can never spend\n\t// one token; a taker that has to wait is granted by the single timer below, in priority order.\n\tconst pump = (): void => {\n\t\tclearTimeout(timer)\n\t\ttimer = undefined\n\t\tfor (;;) {\n\t\t\tconst taker = next()\n\t\t\tif (!taker) {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst at = now()\n\t\t\tconst waitMs = buckets.reduce((max, bucket) => Math.max(max, bucket.waitMs(at)), 0)\n\t\t\tif (waitMs > 0) {\n\t\t\t\ttimer = setTimeout(pump, waitMs)\n\t\t\t\ttimer.unref?.()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tfor (const bucket of buckets) {\n\t\t\t\tbucket.take(at)\n\t\t\t}\n\t\t\ttakers.splice(takers.indexOf(taker), 1)\n\t\t\ttaker.grant()\n\t\t}\n\t}\n\n\treturn {\n\t\ttake({ signal, priority }) {\n\t\t\tif (signal?.aborted) {\n\t\t\t\treturn Promise.reject(signal.reason)\n\t\t\t}\n\t\t\treturn new Promise<void>((resolve, reject) => {\n\t\t\t\tconst onAbort = (): void => {\n\t\t\t\t\tconst index = takers.indexOf(taker)\n\t\t\t\t\tif (index !== -1) {\n\t\t\t\t\t\ttakers.splice(index, 1)\n\t\t\t\t\t\tpump()\n\t\t\t\t\t}\n\t\t\t\t\treject(signal?.reason)\n\t\t\t\t}\n\t\t\t\tconst taker: Taker = {\n\t\t\t\t\tpriority,\n\t\t\t\t\tgrant: () => {\n\t\t\t\t\t\tsignal?.removeEventListener('abort', onAbort)\n\t\t\t\t\t\tresolve()\n\t\t\t\t\t},\n\t\t\t\t}\n\t\t\t\ttakers.push(taker)\n\t\t\t\tsignal?.addEventListener('abort', onAbort, { once: true })\n\t\t\t\tpump()\n\t\t\t})\n\t\t},\n\t\tget waiting() {\n\t\t\treturn takers.length\n\t\t},\n\t}\n}\n"],"mappings":";;;AAUA,MAAM,OAA2C;CAAE,aAAa;CAAG,QAAQ;CAAG,YAAY;AAAE;;AAG5F,MAAa,cACZ,YAEA,QAAQ,QACN,MAAM,SAAU,SAAS,KAAA,KAAa,KAAK,KAAK,YAAY,KAAK,KAAK,YAAY,OAAO,MAC1F,KAAA,CACD;AAqBD,MAAM,gBAAgB,UAAkB,aAAkC;CAGzE,MAAM,aAAa,WAAW;CAC9B,IAAI,SAAS;CACb,IAAI;CAEJ,MAAM,QAAQ,QAAsB;EACnC,IAAI,SAAS,KAAA,GAAW;GACvB,OAAO;GACP;EACD;EACA,MAAM,UAAU,MAAM;EACtB,IAAI,UAAU,GAAG;GAChB,SAAS,KAAK,IAAI,UAAU,SAAS,UAAU,UAAU;GACzD,OAAO;EACR;CACD;CAEA,OAAO;EACN,OAAO,KAAK;GACX,KAAK,GAAG;GACR,OAAO,UAAU,IAAI,IAAI,KAAK,MAAM,IAAI,UAAU,UAAU;EAC7D;EACA,KAAK,KAAK;GACT,KAAK,GAAG;GACR,UAAU;EACX;CACD;AACD;AAOA,MAAM,YAAyB;CAC9B,MAAM,OAAO,EAAE,aAAa;EAC3B,IAAI,QAAQ,SACX,MAAM,OAAO;CAEf;CACA,SAAS;AACV;;;;;AAMA,MAAa,qBACZ,YACA,MAAoB,gBACH;CACjB,MAAM,UAAyB,CAAC;CAChC,IAAI,YAAY,mBACf,QAAQ,KAAK,aAAa,WAAW,mBAAmB,SAAS,CAAC;CAEnE,IAAI,YAAY,iBACf,QAAQ,KAAK,aAAa,WAAW,iBAAiB,OAAO,CAAC;CAE/D,IAAI,QAAQ,WAAW,GACtB,OAAO;CAER,MAAM,SAAkB,CAAC;CACzB,IAAI;CAEJ,MAAM,aAAgC,WAAW,MAAM;CAIvD,MAAM,aAAmB;EACxB,aAAa,KAAK;EAClB,QAAQ,KAAA;EACR,SAAS;GACR,MAAM,QAAQ,KAAK;GACnB,IAAI,CAAC,OACJ;GAED,MAAM,KAAK,IAAI;GACf,MAAM,SAAS,QAAQ,QAAQ,KAAK,WAAW,KAAK,IAAI,KAAK,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC;GAClF,IAAI,SAAS,GAAG;IACf,QAAQ,WAAW,MAAM,MAAM;IAC/B,MAAM,QAAQ;IACd;GACD;GACA,KAAK,MAAM,UAAU,SACpB,OAAO,KAAK,EAAE;GAEf,OAAO,OAAO,OAAO,QAAQ,KAAK,GAAG,CAAC;GACtC,MAAM,MAAM;EACb;CACD;CAEA,OAAO;EACN,KAAK,EAAE,QAAQ,YAAY;GAC1B,IAAI,QAAQ,SACX,OAAO,QAAQ,OAAO,OAAO,MAAM;GAEpC,OAAO,IAAI,SAAe,SAAS,WAAW;IAC7C,MAAM,gBAAsB;KAC3B,MAAM,QAAQ,OAAO,QAAQ,KAAK;KAClC,IAAI,UAAU,IAAI;MACjB,OAAO,OAAO,OAAO,CAAC;MACtB,KAAK;KACN;KACA,OAAO,QAAQ,MAAM;IACtB;IACA,MAAM,QAAe;KACpB;KACA,aAAa;MACZ,QAAQ,oBAAoB,SAAS,OAAO;MAC5C,QAAQ;KACT;IACD;IACA,OAAO,KAAK,KAAK;IACjB,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;IACzD,KAAK;GACN,CAAC;EACF;EACA,IAAI,UAAU;GACb,OAAO,OAAO;EACf;CACD;AACD"}
@@ -0,0 +1,178 @@
1
+ import { supportsGranularity } from "../core/granularity.js";
2
+ import "../timeframe/tz.js";
3
+ import { isAverageMetric } from "../core/metricValues.js";
4
+ import { calendarDayOf, parseCalendarDay } from "../timeframe/calendar.js";
5
+ import { bucketInstant, bucketStartOf } from "../native/engine/buckets.js";
6
+ //#region src/surfacing/rebucket.ts
7
+ /**
8
+ * The count an average is taken over, for a row that does not say (`AnalyticsRow.samples`):
9
+ * time and scroll per pageview, a bounce rate and a visit's length per visit.
10
+ */
11
+ const WEIGHTS = {
12
+ avgDuration: ["pageviews"],
13
+ scrollDepth: ["pageviews"],
14
+ bounceRate: ["visits", "sessions"],
15
+ visitDuration: ["visits", "sessions"]
16
+ };
17
+ /**
18
+ * The plan for `q`, or undefined when it needs none: a series of weeks or months from a source
19
+ * that does not answer those itself but serves days.
20
+ */
21
+ const rebucketPlan = (q, caps) => {
22
+ const unit = q.granularity;
23
+ if (unit !== "week" && unit !== "month" || caps.calendarBuckets === true) return;
24
+ if (!supportsGranularity(caps, "day")) return;
25
+ const asked = new Set(q.metrics);
26
+ const weights = /* @__PURE__ */ new Set();
27
+ for (const metric of q.metrics) {
28
+ const candidates = WEIGHTS[metric] ?? [];
29
+ if (candidates.some((candidate) => asked.has(candidate))) continue;
30
+ const weight = candidates.find((candidate) => caps.metrics.has(candidate));
31
+ if (weight !== void 0) weights.add(weight);
32
+ }
33
+ return {
34
+ unit,
35
+ weights: [...weights]
36
+ };
37
+ };
38
+ /** The read the adapter is given for a plan: days, with the weights beside the asked metrics. */
39
+ const dayRead = (q, plan) => ({
40
+ ...q,
41
+ granularity: "day",
42
+ metrics: [...q.metrics, ...plan.weights]
43
+ });
44
+ /**
45
+ * The local date a day row names: a vendor's UTC midnight labels that date, any other instant
46
+ * starts a day in the read's zone; a zone whose days start at UTC midnight is UTC, so both agree.
47
+ */
48
+ const dayOfTimestamp = (timestamp, tz) => {
49
+ const bare = parseCalendarDay(timestamp);
50
+ if (bare !== null) return bare;
51
+ const at = new Date(timestamp);
52
+ if (Number.isNaN(at.getTime())) return null;
53
+ return at.getTime() % 864e5 === 0 ? calendarDayOf(at, "UTC") : calendarDayOf(at, tz);
54
+ };
55
+ const nonNegative = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
56
+ /** What one row's reading of an average counts for: its own samples, else its matching count. */
57
+ const weightOf = (row, metric) => {
58
+ const own = nonNegative(row.samples?.[metric]);
59
+ if (own !== void 0) return own;
60
+ for (const candidate of WEIGHTS[metric] ?? []) {
61
+ const count = nonNegative(row.metrics[candidate]);
62
+ if (count !== void 0) return count;
63
+ }
64
+ };
65
+ /**
66
+ * One average over several rows: weighted when every reading has a weight, so a week is the
67
+ * mean of its visits rather than of its days; a plain mean otherwise, and `null` with no reading.
68
+ */
69
+ const foldAverage = (rows, metric) => {
70
+ const readings = [];
71
+ for (const row of rows) {
72
+ const value = row.metrics[metric];
73
+ if (typeof value === "number" && Number.isFinite(value)) readings.push({
74
+ value,
75
+ weight: weightOf(row, metric)
76
+ });
77
+ }
78
+ if (readings.length === 0) return { value: null };
79
+ if (readings.some((reading) => reading.weight === void 0)) {
80
+ const sum = readings.reduce((total, reading) => total + reading.value, 0);
81
+ return { value: Math.round(sum / readings.length) };
82
+ }
83
+ let weights = 0;
84
+ let sum = 0;
85
+ for (const { value, weight = 0 } of readings) {
86
+ weights += weight;
87
+ sum += value * weight;
88
+ }
89
+ return weights > 0 ? {
90
+ value: Math.round(sum / weights),
91
+ samples: weights
92
+ } : {
93
+ value: null,
94
+ samples: 0
95
+ };
96
+ };
97
+ const foldCount = (rows, metric) => rows.reduce((sum, row) => {
98
+ const value = row.metrics[metric];
99
+ return typeof value === "number" && Number.isFinite(value) ? sum + value : sum;
100
+ }, 0);
101
+ /** `metrics` narrowed to the ones the read asked for, which drops the weights a plan added. */
102
+ const askedOnly = (metrics, asked) => {
103
+ const out = {};
104
+ for (const metric of asked) {
105
+ const value = metrics[metric];
106
+ if (value !== void 0) out[metric] = value;
107
+ }
108
+ return out;
109
+ };
110
+ const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
111
+ const dimensionKey = (dimensions) => JSON.stringify(Object.entries(dimensions ?? {}).filter(([, value]) => value !== void 0).sort(([a], [b]) => compareText(a, b)));
112
+ const foldBucket = (bucket, tz, asked) => {
113
+ const metrics = {};
114
+ const samples = {};
115
+ for (const metric of asked) {
116
+ if (!bucket.rows.some((row) => row.metrics[metric] !== void 0)) continue;
117
+ if (!isAverageMetric(metric)) {
118
+ metrics[metric] = foldCount(bucket.rows, metric);
119
+ continue;
120
+ }
121
+ const folded = foldAverage(bucket.rows, metric);
122
+ metrics[metric] = folded.value;
123
+ if (folded.samples !== void 0) samples[metric] = folded.samples;
124
+ }
125
+ return {
126
+ ...bucket.dimensions === void 0 ? {} : { dimensions: bucket.dimensions },
127
+ timestamp: bucketInstant(bucket.start, tz).toISOString(),
128
+ metrics,
129
+ ...Object.keys(samples).length > 0 ? { samples } : {}
130
+ };
131
+ };
132
+ /**
133
+ * A day series folded into the asked weeks or months in the reporting zone: counts add, averages
134
+ * are weighted, visitors add per day (so a multi-day bucket marks the read `sumOfDaily`).
135
+ */
136
+ const foldResult = (result, q, plan) => {
137
+ const tz = q.timezone ?? "UTC";
138
+ const passthrough = [];
139
+ const buckets = /* @__PURE__ */ new Map();
140
+ for (const row of result.rows) {
141
+ if (row.timestamp === void 0) {
142
+ passthrough.push(plan.weights.length === 0 ? row : {
143
+ ...row,
144
+ metrics: askedOnly(row.metrics, q.metrics)
145
+ });
146
+ continue;
147
+ }
148
+ const day = dayOfTimestamp(row.timestamp, tz);
149
+ if (day === null) continue;
150
+ const start = bucketStartOf(day, plan.unit);
151
+ const key = `${dimensionKey(row.dimensions)}|${start}`;
152
+ const bucket = buckets.get(key) ?? {
153
+ key,
154
+ dimensions: row.dimensions,
155
+ start,
156
+ rows: [],
157
+ visitorDays: /* @__PURE__ */ new Set()
158
+ };
159
+ bucket.rows.push(row);
160
+ if (typeof row.metrics.visitors === "number") bucket.visitorDays.add(day);
161
+ buckets.set(key, bucket);
162
+ }
163
+ const ordered = [...buckets.values()].sort((a, b) => compareText(a.key, b.key));
164
+ const meta = q.metrics.includes("visitors") && ordered.some((bucket) => bucket.visitorDays.size > 1) ? {
165
+ ...result.meta,
166
+ visitorsAre: "sumOfDaily"
167
+ } : result.meta;
168
+ return {
169
+ ...result,
170
+ rows: [...passthrough, ...ordered.map((bucket) => foldBucket(bucket, tz, q.metrics))],
171
+ ...result.totals === void 0 || plan.weights.length === 0 ? {} : { totals: askedOnly(result.totals, q.metrics) },
172
+ meta
173
+ };
174
+ };
175
+ //#endregion
176
+ export { dayOfTimestamp, dayRead, foldResult, rebucketPlan };
177
+
178
+ //# sourceMappingURL=rebucket.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rebucket.js","names":[],"sources":["../../src/surfacing/rebucket.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tAnalyticsRow,\n\tMetricKey,\n\tMetricValue,\n\tMetricValues,\n} from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { isAverageMetric } from '../core/metricValues'\nimport { bucketInstant, bucketStartOf, type CalendarUnit } from '../native/engine/buckets'\nimport { type CalendarDay, calendarDayOf, parseCalendarDay } from '../timeframe/calendar'\nimport { DAY_MS, DEFAULT_TIMEZONE } from '../timeframe/tz'\n\n/**\n * The count an average is taken over, for a row that does not say (`AnalyticsRow.samples`):\n * time and scroll per pageview, a bounce rate and a visit's length per visit.\n */\nconst WEIGHTS: Partial<Record<MetricKey, readonly MetricKey[]>> = {\n\tavgDuration: ['pageviews'],\n\tscrollDepth: ['pageviews'],\n\tbounceRate: ['visits', 'sessions'],\n\tvisitDuration: ['visits', 'sessions'],\n}\n\n/** How the engine reads a week or month series from a source that buckets no coarser than days. */\nexport interface RebucketPlan {\n\tunit: CalendarUnit\n\t/** Counts the read adds only to weigh its averages, and strips from the answer again. */\n\tweights: MetricKey[]\n}\n\n/**\n * The plan for `q`, or undefined when it needs none: a series of weeks or months from a source\n * that does not answer those itself but serves days.\n */\nexport const rebucketPlan = (\n\tq: AnalyticsQuery,\n\tcaps: AnalyticsCapabilities\n): RebucketPlan | undefined => {\n\tconst unit = q.granularity\n\tif ((unit !== 'week' && unit !== 'month') || caps.calendarBuckets === true) {\n\t\treturn undefined\n\t}\n\tif (!supportsGranularity(caps, 'day')) {\n\t\treturn undefined\n\t}\n\tconst asked = new Set(q.metrics)\n\tconst weights = new Set<MetricKey>()\n\tfor (const metric of q.metrics) {\n\t\tconst candidates = WEIGHTS[metric] ?? []\n\t\tif (candidates.some((candidate) => asked.has(candidate))) {\n\t\t\tcontinue\n\t\t}\n\t\tconst weight = candidates.find((candidate) => caps.metrics.has(candidate))\n\t\tif (weight !== undefined) {\n\t\t\tweights.add(weight)\n\t\t}\n\t}\n\treturn { unit, weights: [...weights] }\n}\n\n/** The read the adapter is given for a plan: days, with the weights beside the asked metrics. */\nexport const dayRead = (q: AnalyticsQuery, plan: RebucketPlan): AnalyticsQuery => ({\n\t...q,\n\tgranularity: 'day',\n\tmetrics: [...q.metrics, ...plan.weights],\n})\n\n/**\n * The local date a day row names: a vendor's UTC midnight labels that date, any other instant\n * starts a day in the read's zone; a zone whose days start at UTC midnight is UTC, so both agree.\n */\nexport const dayOfTimestamp = (timestamp: string, tz: string): CalendarDay | null => {\n\tconst bare = parseCalendarDay(timestamp)\n\tif (bare !== null) {\n\t\treturn bare\n\t}\n\tconst at = new Date(timestamp)\n\tif (Number.isNaN(at.getTime())) {\n\t\treturn null\n\t}\n\treturn at.getTime() % DAY_MS === 0 ? calendarDayOf(at, 'UTC') : calendarDayOf(at, tz)\n}\n\nconst nonNegative = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : undefined\n\n/** What one row's reading of an average counts for: its own samples, else its matching count. */\nconst weightOf = (row: AnalyticsRow, metric: MetricKey): number | undefined => {\n\tconst own = nonNegative(row.samples?.[metric])\n\tif (own !== undefined) {\n\t\treturn own\n\t}\n\tfor (const candidate of WEIGHTS[metric] ?? []) {\n\t\tconst count = nonNegative(row.metrics[candidate])\n\t\tif (count !== undefined) {\n\t\t\treturn count\n\t\t}\n\t}\n\treturn undefined\n}\n\ninterface Folded {\n\tvalue: MetricValue\n\tsamples?: number\n}\n\n/**\n * One average over several rows: weighted when every reading has a weight, so a week is the\n * mean of its visits rather than of its days; a plain mean otherwise, and `null` with no reading.\n */\nconst foldAverage = (rows: readonly AnalyticsRow[], metric: MetricKey): Folded => {\n\tconst readings: Array<{ value: number; weight: number | undefined }> = []\n\tfor (const row of rows) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number' && Number.isFinite(value)) {\n\t\t\treadings.push({ value, weight: weightOf(row, metric) })\n\t\t}\n\t}\n\tif (readings.length === 0) {\n\t\treturn { value: null }\n\t}\n\tif (readings.some((reading) => reading.weight === undefined)) {\n\t\tconst sum = readings.reduce((total, reading) => total + reading.value, 0)\n\t\treturn { value: Math.round(sum / readings.length) }\n\t}\n\tlet weights = 0\n\tlet sum = 0\n\tfor (const { value, weight = 0 } of readings) {\n\t\tweights += weight\n\t\tsum += value * weight\n\t}\n\treturn weights > 0\n\t\t? { value: Math.round(sum / weights), samples: weights }\n\t\t: { value: null, samples: 0 }\n}\n\nconst foldCount = (rows: readonly AnalyticsRow[], metric: MetricKey): number =>\n\trows.reduce((sum, row) => {\n\t\tconst value = row.metrics[metric]\n\t\treturn typeof value === 'number' && Number.isFinite(value) ? sum + value : sum\n\t}, 0)\n\n/** `metrics` narrowed to the ones the read asked for, which drops the weights a plan added. */\nconst askedOnly = (metrics: MetricValues, asked: readonly MetricKey[]): MetricValues => {\n\tconst out: MetricValues = {}\n\tfor (const metric of asked) {\n\t\tconst value = metrics[metric]\n\t\tif (value !== undefined) {\n\t\t\tout[metric] = value\n\t\t}\n\t}\n\treturn out\n}\n\nconst compareText = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0)\n\nconst dimensionKey = (dimensions: AnalyticsRow['dimensions']): string =>\n\tJSON.stringify(\n\t\tObject.entries(dimensions ?? {})\n\t\t\t.filter(([, value]) => value !== undefined)\n\t\t\t.sort(([a], [b]) => compareText(a, b))\n\t)\n\ninterface Bucket {\n\tkey: string\n\tdimensions: AnalyticsRow['dimensions']\n\tstart: CalendarDay\n\trows: AnalyticsRow[]\n\t/** The days whose rows counted visitors. */\n\tvisitorDays: Set<CalendarDay>\n}\n\nconst foldBucket = (bucket: Bucket, tz: string, asked: readonly MetricKey[]): AnalyticsRow => {\n\tconst metrics: MetricValues = {}\n\tconst samples: Partial<Record<MetricKey, number>> = {}\n\tfor (const metric of asked) {\n\t\tif (!bucket.rows.some((row) => row.metrics[metric] !== undefined)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (!isAverageMetric(metric)) {\n\t\t\tmetrics[metric] = foldCount(bucket.rows, metric)\n\t\t\tcontinue\n\t\t}\n\t\tconst folded = foldAverage(bucket.rows, metric)\n\t\tmetrics[metric] = folded.value\n\t\tif (folded.samples !== undefined) {\n\t\t\tsamples[metric] = folded.samples\n\t\t}\n\t}\n\treturn {\n\t\t...(bucket.dimensions === undefined ? {} : { dimensions: bucket.dimensions }),\n\t\ttimestamp: bucketInstant(bucket.start, tz).toISOString(),\n\t\tmetrics,\n\t\t...(Object.keys(samples).length > 0 ? { samples } : {}),\n\t}\n}\n\n/**\n * A day series folded into the asked weeks or months in the reporting zone: counts add, averages\n * are weighted, visitors add per day (so a multi-day bucket marks the read `sumOfDaily`).\n */\nexport const foldResult = (\n\tresult: AnalyticsResult,\n\tq: AnalyticsQuery,\n\tplan: RebucketPlan\n): AnalyticsResult => {\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst passthrough: AnalyticsRow[] = []\n\tconst buckets = new Map<string, Bucket>()\n\tfor (const row of result.rows) {\n\t\tif (row.timestamp === undefined) {\n\t\t\tpassthrough.push(\n\t\t\t\tplan.weights.length === 0 ? row : { ...row, metrics: askedOnly(row.metrics, q.metrics) }\n\t\t\t)\n\t\t\tcontinue\n\t\t}\n\t\tconst day = dayOfTimestamp(row.timestamp, tz)\n\t\tif (day === null) {\n\t\t\tcontinue\n\t\t}\n\t\tconst start = bucketStartOf(day, plan.unit)\n\t\tconst key = `${dimensionKey(row.dimensions)}|${start}`\n\t\tconst bucket = buckets.get(key) ?? {\n\t\t\tkey,\n\t\t\tdimensions: row.dimensions,\n\t\t\tstart,\n\t\t\trows: [],\n\t\t\tvisitorDays: new Set<CalendarDay>(),\n\t\t}\n\t\tbucket.rows.push(row)\n\t\tif (typeof row.metrics.visitors === 'number') {\n\t\t\tbucket.visitorDays.add(day)\n\t\t}\n\t\tbuckets.set(key, bucket)\n\t}\n\tconst ordered = [...buckets.values()].sort((a, b) => compareText(a.key, b.key))\n\tconst summed =\n\t\tq.metrics.includes('visitors') && ordered.some((bucket) => bucket.visitorDays.size > 1)\n\tconst meta: AnalyticsResult['meta'] = summed\n\t\t? { ...result.meta, visitorsAre: 'sumOfDaily' }\n\t\t: result.meta\n\treturn {\n\t\t...result,\n\t\trows: [...passthrough, ...ordered.map((bucket) => foldBucket(bucket, tz, q.metrics))],\n\t\t...(result.totals === undefined || plan.weights.length === 0\n\t\t\t? {}\n\t\t\t: { totals: askedOnly(result.totals, q.metrics) }),\n\t\tmeta,\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
2
+ import { resolveTimeframe } from "../timeframe/presets.js";
3
+ import { previousWindow } from "../timeframe/comparison.js";
4
+ //#region src/surfacing/recipe.ts
5
+ /** Every window a recipe can name, in the order a read is matched against them. */
6
+ const RECIPE_WINDOWS = [
7
+ "live",
8
+ "days",
9
+ "previous"
10
+ ];
11
+ const isRecipeWindow = (value) => RECIPE_WINDOWS.some((window) => window === value);
12
+ /**
13
+ * The window a recipe names at `now` in `tz` (see `RecipeWindow`); null where the preset has no
14
+ * previous window (a range longer than a year).
15
+ */
16
+ const recipeWindow = (recipe, now, tz) => {
17
+ const live = resolveTimeframe(recipe.timeframe, now, tz);
18
+ if (recipe.window === "live") return live;
19
+ if (recipe.window === "previous") return previousWindow(live, tz);
20
+ return {
21
+ start: startOfDayInTz(live.start, tz),
22
+ end: /* @__PURE__ */ new Date(addDaysInTz(live.end, 1, tz).getTime() - 1)
23
+ };
24
+ };
25
+ //#endregion
26
+ export { RECIPE_WINDOWS, isRecipeWindow, recipeWindow };
27
+
28
+ //# sourceMappingURL=recipe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"recipe.js","names":[],"sources":["../../src/surfacing/recipe.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport { previousWindow } from '../timeframe/comparison'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { addDaysInTz, startOfDayInTz } from '../timeframe/tz'\nimport type { RecipeWindow } from './cacheStore'\n\n/** Every window a recipe can name, in the order a read is matched against them. */\nexport const RECIPE_WINDOWS: readonly RecipeWindow[] = ['live', 'days', 'previous']\n\nexport const isRecipeWindow = (value: unknown): value is RecipeWindow =>\n\tRECIPE_WINDOWS.some((window) => window === value)\n\n/**\n * The window a recipe names at `now` in `tz` (see `RecipeWindow`); null where the preset has no\n * previous window (a range longer than a year).\n */\nexport const recipeWindow = (\n\trecipe: { timeframe: TimeframePreset; window: RecipeWindow },\n\tnow: Date,\n\ttz: string\n): DateRange | null => {\n\tconst live = resolveTimeframe(recipe.timeframe, now, tz)\n\tif (recipe.window === 'live') {\n\t\treturn live\n\t}\n\tif (recipe.window === 'previous') {\n\t\treturn previousWindow(live, tz)\n\t}\n\treturn {\n\t\tstart: startOfDayInTz(live.start, tz),\n\t\tend: new Date(addDaysInTz(live.end, 1, tz).getTime() - 1),\n\t}\n}\n"],"mappings":";;;;;AAOA,MAAa,iBAA0C;CAAC;CAAQ;CAAQ;AAAU;AAElF,MAAa,kBAAkB,UAC9B,eAAe,MAAM,WAAW,WAAW,KAAK;;;;;AAMjD,MAAa,gBACZ,QACA,KACA,OACsB;CACtB,MAAM,OAAO,iBAAiB,OAAO,WAAW,KAAK,EAAE;CACvD,IAAI,OAAO,WAAW,QACrB,OAAO;CAER,IAAI,OAAO,WAAW,YACrB,OAAO,eAAe,MAAM,EAAE;CAE/B,OAAO;EACN,OAAO,eAAe,KAAK,OAAO,EAAE;EACpC,qBAAK,IAAI,KAAK,YAAY,KAAK,KAAK,GAAG,EAAE,EAAE,QAAQ,IAAI,CAAC;CACzD;AACD"}
@@ -0,0 +1,22 @@
1
+ import { sortRowsByMetric } from "../core/metricValues.js";
2
+ //#region src/surfacing/shape.ts
3
+ /** A breakdown's rows: grouped by a dimension, with no timestamp, so their order is a ranking. */
4
+ const isRanking = (query, rows) => (query.dimensions?.length ?? 0) > 0 && rows.every((row) => row.timestamp === void 0);
5
+ /**
6
+ * A breakdown ranked by `order` (no value last, ties in source order, first metric descending
7
+ * when only `limit` is set) and cut to `limit`; an `order` on an unasked metric keeps source order.
8
+ */
9
+ const shapeResult = (result, query) => {
10
+ const limit = query.limit !== void 0 && Number.isInteger(query.limit) && query.limit > 0 ? query.limit : void 0;
11
+ if (!isRanking(query, result.rows) || limit === void 0 && query.order === void 0) return result;
12
+ const metric = query.order?.metric ?? query.metrics[0];
13
+ const ranked = metric === void 0 ? result.rows : sortRowsByMetric(result.rows, metric, query.order?.direction ?? "desc");
14
+ return {
15
+ ...result,
16
+ rows: limit === void 0 ? ranked : ranked.slice(0, limit)
17
+ };
18
+ };
19
+ //#endregion
20
+ export { shapeResult };
21
+
22
+ //# sourceMappingURL=shape.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shape.js","names":[],"sources":["../../src/surfacing/shape.ts"],"sourcesContent":["import type { AnalyticsQuery, AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { sortRowsByMetric } from '../core/metricValues'\n\n/** A breakdown's rows: grouped by a dimension, with no timestamp, so their order is a ranking. */\nconst isRanking = (query: AnalyticsQuery, rows: readonly AnalyticsRow[]): boolean =>\n\t(query.dimensions?.length ?? 0) > 0 && rows.every((row) => row.timestamp === undefined)\n\n/**\n * A breakdown ranked by `order` (no value last, ties in source order, first metric descending\n * when only `limit` is set) and cut to `limit`; an `order` on an unasked metric keeps source order.\n */\nexport const shapeResult = (result: AnalyticsResult, query: AnalyticsQuery): AnalyticsResult => {\n\tconst limit =\n\t\tquery.limit !== undefined && Number.isInteger(query.limit) && query.limit > 0\n\t\t\t? query.limit\n\t\t\t: undefined\n\tif (!isRanking(query, result.rows) || (limit === undefined && query.order === undefined)) {\n\t\treturn result\n\t}\n\tconst metric = query.order?.metric ?? query.metrics[0]\n\tconst ranked =\n\t\tmetric === undefined\n\t\t\t? result.rows\n\t\t\t: sortRowsByMetric(result.rows, metric, query.order?.direction ?? 'desc')\n\treturn { ...result, rows: limit === undefined ? ranked : ranked.slice(0, limit) }\n}\n"],"mappings":";;;AAIA,MAAM,aAAa,OAAuB,UACxC,MAAM,YAAY,UAAU,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,cAAc,KAAA,CAAS;;;;;AAMvF,MAAa,eAAe,QAAyB,UAA2C;CAC/F,MAAM,QACL,MAAM,UAAU,KAAA,KAAa,OAAO,UAAU,MAAM,KAAK,KAAK,MAAM,QAAQ,IACzE,MAAM,QACN,KAAA;CACJ,IAAI,CAAC,UAAU,OAAO,OAAO,IAAI,KAAM,UAAU,KAAA,KAAa,MAAM,UAAU,KAAA,GAC7E,OAAO;CAER,MAAM,SAAS,MAAM,OAAO,UAAU,MAAM,QAAQ;CACpD,MAAM,SACL,WAAW,KAAA,IACR,OAAO,OACP,iBAAiB,OAAO,MAAM,QAAQ,MAAM,OAAO,aAAa,MAAM;CAC1E,OAAO;EAAE,GAAG;EAAQ,MAAM,UAAU,KAAA,IAAY,SAAS,OAAO,MAAM,GAAG,KAAK;CAAE;AACjF"}