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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,88 +1,77 @@
1
- import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
2
- import { resolveTimeframe } from "../timeframe/presets.js";
3
- import { satisfiesCapabilities } from "../core/capabilities.js";
4
- import { resolveReadContext } from "../core/scopedRead.js";
5
- import { previousWindow } from "./comparison.js";
1
+ import { readPrincipalOf } from "../access/principal.js";
2
+ import { readFailureOf } from "../surfacing/classifyError.js";
3
+ import { comparisonWindow, engineRead, pinnedScope, prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
4
+ import { readMeta } from "./readMeta.js";
5
+ import { hasNoDeclaredGoals } from "../goals/latent.js";
6
6
  //#region src/widgets/readForWidget.ts
7
+ /**
8
+ * Totals of `metrics` over a widget's window, beside the previous window's where the install and
9
+ * the source compare. A source that fails answers with a status rather than a throw.
10
+ */
7
11
  const readForWidget = async (args) => {
8
12
  const { req, metrics, timeframe, adapterId, now, range, filters } = args;
9
- const emptyMetrics = {};
10
- const runtime = getRuntime(req.payload);
11
- if (!runtime) return {
12
- status: "unavailable",
13
- adapterId: adapterId ?? "",
14
- dateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),
15
- metrics: emptyMetrics
16
- };
17
- const ctx = await resolveReadContext({
18
- runtime,
13
+ const prepared = await prepareWidgetRead({
19
14
  req,
15
+ now,
16
+ timeframe,
20
17
  adapterId,
21
- scope: args.scope
18
+ ...readPrincipalOf(args),
19
+ ...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
20
+ timezone: args.timezone,
21
+ range,
22
+ filters,
23
+ requires: { metrics },
24
+ goalRead: () => ({ metrics })
22
25
  });
23
- if (!ctx.ok) return {
24
- status: "unavailable",
25
- adapterId: adapterId ?? "",
26
- dateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),
27
- metrics: emptyMetrics
28
- };
29
- const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
30
- const dateRange = range ?? resolveTimeframe(timeframe, now, tz);
31
- const base = {
32
- dateRange,
33
- metrics: emptyMetrics
34
- };
35
- const adapter = ctx.adapter;
36
- if (!adapter.isConfigured()) return {
37
- status: "not-configured",
38
- adapterId: adapter.id,
39
- ...base
26
+ if (!prepared.ok) return {
27
+ status: prepared.status,
28
+ adapterId: prepared.adapterId,
29
+ dateRange: prepared.dateRange,
30
+ metrics: {}
40
31
  };
41
- if (!satisfiesCapabilities(adapter.capabilities, {
32
+ const { adapter, tz, dateRange } = prepared;
33
+ const comparisonRange = args.comparison === false ? void 0 : comparisonWindow(prepared, now);
34
+ const readBase = {
42
35
  metrics,
43
- ...filters && filters.length > 0 ? {
44
- filters: filters.map((f) => f.dimension),
45
- filterOperators: filters.map((f) => f.operator)
46
- } : {}
47
- })) return {
48
- status: "unavailable",
49
- adapterId: adapter.id,
50
- ...base
36
+ filters,
37
+ timezone: tz,
38
+ scope: prepared.queryScope,
39
+ ...prepared.goalSlugs === void 0 ? {} : { goalSlugs: prepared.goalSlugs }
51
40
  };
52
- const comparisonRange = args.comparison !== false && runtime.comparison && adapter.capabilities.comparison ? previousWindow(dateRange, tz) ?? void 0 : void 0;
41
+ const read = engineRead(prepared, timeframe);
42
+ const main = read({
43
+ ...readBase,
44
+ dateRange
45
+ });
46
+ const comparing = comparisonRange ? read({
47
+ ...readBase,
48
+ dateRange: comparisonRange
49
+ }).catch(() => void 0) : void 0;
53
50
  let result;
54
- let previous;
55
51
  try {
56
- [result, previous] = await Promise.all([runtime.engine.read(adapter, {
57
- metrics,
58
- dateRange,
59
- filters,
60
- timezone: tz,
61
- scope: ctx.queryScope
62
- }), comparisonRange ? runtime.engine.read(adapter, {
63
- metrics,
64
- dateRange: comparisonRange,
65
- filters,
66
- timezone: tz,
67
- scope: ctx.queryScope
68
- }) : void 0]);
69
- } catch {
52
+ result = await main;
53
+ } catch (err) {
70
54
  return {
71
- status: "unavailable",
55
+ ...readFailureOf(err),
72
56
  adapterId: adapter.id,
73
- ...base
57
+ dateRange,
58
+ metrics: {}
74
59
  };
75
60
  }
61
+ const previous = await comparing;
76
62
  const previousMetrics = previous ? previous.totals ?? {} : void 0;
77
63
  return {
78
64
  status: "ok",
79
65
  adapterId: adapter.id,
66
+ ...substitutionOf(prepared),
67
+ ...pinnedScope(args, prepared.queryScope),
80
68
  dateRange,
69
+ timezone: tz,
81
70
  metrics: result.totals ?? {},
82
- clamped: result.meta.clamped ?? false,
83
- stale: result.meta.stale ?? false,
71
+ ...readMeta(result),
72
+ noGoals: Array.isArray(prepared.goalSlugs) && hasNoDeclaredGoals(prepared.goalSlugs, prepared.builtinGoalSlugs),
84
73
  previousMetrics,
85
- comparisonRange
74
+ comparisonRange: previous ? comparisonRange : void 0
86
75
  };
87
76
  };
88
77
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"readForWidget.js","names":[],"sources":["../../src/widgets/readForWidget.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tMetricKey,\n} from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport { previousWindow } from './comparison'\n\nexport type WidgetReadStatus = 'ok' | 'not-configured' | 'unavailable'\n\nexport interface WidgetReadResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\tmetrics: Partial<Record<MetricKey, number>>\n\tclamped?: boolean\n\t/** True when the engine served a stale cache entry after a failed provider read. */\n\tstale?: boolean\n\t/** Previous-window totals, present only when the adapter supports comparison. */\n\tpreviousMetrics?: Partial<Record<MetricKey, number>>\n\t/** The previous comparable window, present only when comparison ran. */\n\tcomparisonRange?: DateRange\n}\n\nexport interface ReadForWidgetArgs {\n\treq: PayloadRequest\n\tmetrics: MetricKey[]\n\ttimeframe: TimeframePreset\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n\tfilters?: AnalyticsFilter[]\n\t/**\n\t * Read the previous window too, where the install and the source both allow it. Defaults\n\t * to on; a caller that never renders a delta passes false to save the second read.\n\t */\n\tcomparison?: boolean\n}\n\nexport const readForWidget = async (args: ReadForWidgetArgs): Promise<WidgetReadResult> => {\n\tconst { req, metrics, timeframe, adapterId, now, range, filters } = args\n\tconst emptyMetrics = {} as Partial<Record<MetricKey, number>>\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),\n\t\t\tmetrics: emptyMetrics,\n\t\t}\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),\n\t\t\tmetrics: emptyMetrics,\n\t\t}\n\t}\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = range ?? resolveTimeframe(timeframe, now, tz)\n\tconst base = { dateRange, metrics: emptyMetrics }\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, ...base }\n\t}\n\tif (\n\t\t!satisfiesCapabilities(adapter.capabilities, {\n\t\t\tmetrics,\n\t\t\t...(filters && filters.length > 0\n\t\t\t\t? {\n\t\t\t\t\t\tfilters: filters.map((f) => f.dimension),\n\t\t\t\t\t\tfilterOperators: filters.map((f) => f.operator),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t})\n\t) {\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst comparisonRange =\n\t\targs.comparison !== false && runtime.comparison && adapter.capabilities.comparison\n\t\t\t? (previousWindow(dateRange, tz) ?? undefined)\n\t\t\t: undefined\n\tlet result: AnalyticsResult\n\tlet previous: AnalyticsResult | undefined\n\ttry {\n\t\t;[result, previous] = await Promise.all([\n\t\t\truntime.engine.read(adapter, {\n\t\t\t\tmetrics,\n\t\t\t\tdateRange,\n\t\t\t\tfilters,\n\t\t\t\ttimezone: tz,\n\t\t\t\tscope: ctx.queryScope,\n\t\t\t}),\n\t\t\tcomparisonRange\n\t\t\t\t? runtime.engine.read(adapter, {\n\t\t\t\t\t\tmetrics,\n\t\t\t\t\t\tdateRange: comparisonRange,\n\t\t\t\t\t\tfilters,\n\t\t\t\t\t\ttimezone: tz,\n\t\t\t\t\t\tscope: ctx.queryScope,\n\t\t\t\t\t})\n\t\t\t\t: undefined,\n\t\t])\n\t} catch {\n\t\t// No cache entry (fresh or stale) survived the failed read; degrade like an\n\t\t// unsupported capability instead of throwing through the widget render tree.\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst previousMetrics = previous ? (previous.totals ?? {}) : undefined\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\tmetrics: result.totals ?? {},\n\t\tclamped: result.meta.clamped ?? false,\n\t\tstale: result.meta.stale ?? false,\n\t\tpreviousMetrics,\n\t\tcomparisonRange,\n\t}\n}\n"],"mappings":";;;;;;AAoDA,MAAa,gBAAgB,OAAO,SAAuD;CAC1F,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW,KAAK,OAAO,YAAY;CACpE,MAAM,eAAe,CAAC;CAEtB,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO;EACN,QAAQ;EACR,WAAW,aAAa;EACxB,WAAW,SAAS,iBAAiB,WAAW,KAAK,KAAK,QAAQ;EAClE,SAAS;CACV;CAED,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO;EACN,QAAQ;EACR,WAAW,aAAa;EACxB,WAAW,SAAS,iBAAiB,WAAW,KAAK,KAAK,QAAQ;EAClE,SAAS;CACV;CAED,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,SAAS,iBAAiB,WAAW,KAAK,EAAE;CAC9D,MAAM,OAAO;EAAE;EAAW,SAAS;CAAa;CAChD,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO;EAAE,QAAQ;EAAkB,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEnE,IACC,CAAC,sBAAsB,QAAQ,cAAc;EAC5C;EACA,GAAI,WAAW,QAAQ,SAAS,IAC7B;GACA,SAAS,QAAQ,KAAK,MAAM,EAAE,SAAS;GACvC,iBAAiB,QAAQ,KAAK,MAAM,EAAE,QAAQ;EAC/C,IACC,CAAC;CACL,CAAC,GAED,OAAO;EAAE,QAAQ;EAAe,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEhE,MAAM,kBACL,KAAK,eAAe,SAAS,QAAQ,cAAc,QAAQ,aAAa,aACpE,eAAe,WAAW,EAAE,KAAK,KAAA,IAClC,KAAA;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;EACF,CAAC,QAAQ,YAAY,MAAM,QAAQ,IAAI,CACvC,QAAQ,OAAO,KAAK,SAAS;GAC5B;GACA;GACA;GACA,UAAU;GACV,OAAO,IAAI;EACZ,CAAC,GACD,kBACG,QAAQ,OAAO,KAAK,SAAS;GAC7B;GACA,WAAW;GACX;GACA,UAAU;GACV,OAAO,IAAI;EACZ,CAAC,IACA,KAAA,CACJ,CAAC;CACF,QAAQ;EAGP,OAAO;GAAE,QAAQ;GAAe,WAAW,QAAQ;GAAI,GAAG;EAAK;CAChE;CACA,MAAM,kBAAkB,WAAY,SAAS,UAAU,CAAC,IAAK,KAAA;CAC7D,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA,SAAS,OAAO,UAAU,CAAC;EAC3B,SAAS,OAAO,KAAK,WAAW;EAChC,OAAO,OAAO,KAAK,SAAS;EAC5B;EACA;CACD;AACD"}
1
+ {"version":3,"file":"readForWidget.js","names":[],"sources":["../../src/widgets/readForWidget.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport type {\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tMetricKey,\n\tMetricValues,\n} from '../core/contract'\nimport { hasNoDeclaredGoals } from '../goals/latent'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tcomparisonWindow,\n\tengineRead,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\nexport type { WidgetReadStatus } from './prepareWidgetRead'\n\nexport interface WidgetReadResult extends Partial<ReadNotices>, SubstitutedSource {\n\tstatus: WidgetReadStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/** The reporting timezone the read resolved in, which names its days. */\n\ttimezone?: string\n\t/**\n\t * Scope a link to this read must name, set only when the viewer would not resolve it alone:\n\t * a needless `scope` refuses every reader without `access.crossScope`.\n\t */\n\tscope?: string\n\tdateRange: DateRange\n\t/** An average with nothing to average over reads `null`; render it as no data, not zero. */\n\tmetrics: MetricValues\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** The read asked about goals and the scope declared none of its own. */\n\tnoGoals?: boolean\n\t/** Previous-window totals, present only when the adapter supports comparison. */\n\tpreviousMetrics?: MetricValues\n\t/** The previous comparable window, present only when comparison ran. */\n\tcomparisonRange?: DateRange\n}\n\n/**\n * Without `scope` the read is the request's own, behind `access.read`. A `scope` must be one\n * already cleared for this request, or a job's own with `principal: SYSTEM`.\n */\nexport type ReadForWidgetArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\tmetrics: MetricKey[]\n\t\ttimeframe: TimeframePreset\n\t\tadapterId?: string\n\t\tnow: Date\n\t\trange?: DateRange\n\t\t/**\n\t\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t\t */\n\t\ttimezone?: string\n\t\tfilters?: AnalyticsFilter[]\n\t\t/**\n\t\t * Read the previous window too, where the install and the source both allow it. Defaults\n\t\t * to on; a caller that never renders a delta passes false to save the second read.\n\t\t */\n\t\tcomparison?: boolean\n\t}\n\n/**\n * Totals of `metrics` over a widget's window, beside the previous window's where the install and\n * the source compare. A source that fails answers with a status rather than a throw.\n */\nexport const readForWidget = async (args: ReadForWidgetArgs): Promise<WidgetReadResult> => {\n\tconst { req, metrics, timeframe, adapterId, now, range, filters } = args\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\t...(args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}),\n\t\ttimezone: args.timezone,\n\t\trange,\n\t\tfilters,\n\t\trequires: { metrics },\n\t\tgoalRead: () => ({ metrics }),\n\t})\n\tif (!prepared.ok) {\n\t\treturn {\n\t\t\tstatus: prepared.status,\n\t\t\tadapterId: prepared.adapterId,\n\t\t\tdateRange: prepared.dateRange,\n\t\t\tmetrics: {},\n\t\t}\n\t}\n\tconst { adapter, tz, dateRange } = prepared\n\tconst comparisonRange = args.comparison === false ? undefined : comparisonWindow(prepared, now)\n\tconst readBase = {\n\t\tmetrics,\n\t\tfilters,\n\t\ttimezone: tz,\n\t\tscope: prepared.queryScope,\n\t\t...(prepared.goalSlugs === undefined ? {} : { goalSlugs: prepared.goalSlugs }),\n\t}\n\tconst read = engineRead(prepared, timeframe)\n\t// The number first: a comparison that fails drops the delta, never the number itself.\n\tconst main = read({ ...readBase, dateRange })\n\tconst comparing = comparisonRange\n\t\t? read({ ...readBase, dateRange: comparisonRange }).catch(() => undefined)\n\t\t: undefined\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await main\n\t} catch (err) {\n\t\treturn { ...readFailureOf(err), adapterId: adapter.id, dateRange, metrics: {} }\n\t}\n\tconst previous = await comparing\n\tconst previousMetrics = previous ? (previous.totals ?? {}) : undefined\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\tmetrics: result.totals ?? {},\n\t\t...readMeta(result),\n\t\tnoGoals:\n\t\t\tArray.isArray(prepared.goalSlugs) &&\n\t\t\thasNoDeclaredGoals(prepared.goalSlugs, prepared.builtinGoalSlugs),\n\t\tpreviousMetrics,\n\t\tcomparisonRange: previous ? comparisonRange : undefined,\n\t}\n}\n"],"mappings":";;;;;;;;;;AAgFA,MAAa,gBAAgB,OAAO,SAAuD;CAC1F,MAAM,EAAE,KAAK,SAAS,WAAW,WAAW,KAAK,OAAO,YAAY;CACpE,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;EACtE,UAAU,KAAK;EACf;EACA;EACA,UAAU,EAAE,QAAQ;EACpB,iBAAiB,EAAE,QAAQ;CAC5B,CAAC;CACD,IAAI,CAAC,SAAS,IACb,OAAO;EACN,QAAQ,SAAS;EACjB,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,SAAS,CAAC;CACX;CAED,MAAM,EAAE,SAAS,IAAI,cAAc;CACnC,MAAM,kBAAkB,KAAK,eAAe,QAAQ,KAAA,IAAY,iBAAiB,UAAU,GAAG;CAC9F,MAAM,WAAW;EAChB;EACA;EACA,UAAU;EACV,OAAO,SAAS;EAChB,GAAI,SAAS,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,SAAS,UAAU;CAC7E;CACA,MAAM,OAAO,WAAW,UAAU,SAAS;CAE3C,MAAM,OAAO,KAAK;EAAE,GAAG;EAAU;CAAU,CAAC;CAC5C,MAAM,YAAY,kBACf,KAAK;EAAE,GAAG;EAAU,WAAW;CAAgB,CAAC,EAAE,YAAY,KAAA,CAAS,IACvE,KAAA;CACH,IAAI;CACJ,IAAI;EACH,SAAS,MAAM;CAChB,SAAS,KAAK;EACb,OAAO;GAAE,GAAG,cAAc,GAAG;GAAG,WAAW,QAAQ;GAAI;GAAW,SAAS,CAAC;EAAE;CAC/E;CACA,MAAM,WAAW,MAAM;CACvB,MAAM,kBAAkB,WAAY,SAAS,UAAU,CAAC,IAAK,KAAA;CAC7D,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,GAAG,eAAe,QAAQ;EAC1B,GAAG,YAAY,MAAM,SAAS,UAAU;EACxC;EACA,UAAU;EACV,SAAS,OAAO,UAAU,CAAC;EAC3B,GAAG,SAAS,MAAM;EAClB,SACC,MAAM,QAAQ,SAAS,SAAS,KAChC,mBAAmB,SAAS,WAAW,SAAS,gBAAgB;EACjE;EACA,iBAAiB,WAAW,kBAAkB,KAAA;CAC/C;AACD"}
@@ -1,25 +1,50 @@
1
- import { AnalyticsFilter, DateRange, DimensionKey, MetricKey } from "../core/contract.js";
1
+ import { AnalyticsFilter, DateRange, DimensionKey, MetricKey, MetricValue, MetricValues } from "../core/contract.js";
2
+ import { ReadPrincipal } from "../access/principal.js";
2
3
  import { TimeframePreset } from "../timeframe/presets.js";
3
- import { WidgetReadStatus } from "./readForWidget.js";
4
+ import { ReadNotices } from "./readMeta.js";
5
+ import { StoredSourceRead, SubstitutedSource, WidgetReadStatus } from "./prepareWidgetRead.js";
4
6
  import { PayloadRequest } from "payload";
5
7
 
6
8
  //#region src/widgets/readForWidgetBreakdown.d.ts
7
9
  interface BreakdownRow {
10
+ /**
11
+ * What the reader sees, in the admin language as every built-in surface labels the row:
12
+ * a goal's name, a country's, an item's title, `Not set` for a row with no value.
13
+ */
8
14
  label: string;
9
- value: number;
15
+ /** The stored value, `''` for a row with no value: what a filter or a link to the view keeps. */
16
+ dimensionValue: string;
17
+ /** `null` when the row has no reading for an average, which is no data rather than zero. */
18
+ value: MetricValue;
10
19
  /** Every metric the read asked for, present only when `extraMetrics` asked for more. */
11
- metrics?: Partial<Record<MetricKey, number>>;
20
+ metrics?: MetricValues;
12
21
  }
13
- interface WidgetBreakdownResult {
22
+ interface WidgetBreakdownResult extends Partial<ReadNotices>, SubstitutedSource {
14
23
  status: WidgetReadStatus;
24
+ /** How long until a `busy` read can succeed, when the source or the plugin knows. */
25
+ retryAfterMs?: number;
15
26
  adapterId: string;
27
+ /** The reporting timezone the read resolved in, which names its days. */
28
+ timezone?: string;
29
+ /**
30
+ * Scope a link to this read must name, set only when the viewer would not resolve it alone:
31
+ * a needless `scope` refuses every reader without `access.crossScope`.
32
+ */
33
+ scope?: string;
16
34
  dateRange: DateRange;
17
35
  rows: BreakdownRow[];
18
- clamped?: boolean;
19
- /** True when the engine served a stale cache entry after a failed provider read. */
20
- stale?: boolean;
36
+ /** The source that answered, absent on a read that never reached one. */
37
+ provider?: string;
38
+ /** True when the read asked about goals and the scope declared none: an empty table. */
39
+ noGoals?: boolean;
40
+ /** The scope's goals behind a `goal` read's slugs, so its rows read as names. */
41
+ goals?: Array<{
42
+ slug: string;
43
+ name: string;
44
+ }>;
21
45
  }
22
- interface ReadForWidgetBreakdownArgs {
46
+ /** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
47
+ type ReadForWidgetBreakdownArgs = ReadPrincipal & StoredSourceRead & {
23
48
  req: PayloadRequest;
24
49
  metric: MetricKey;
25
50
  dimension: DimensionKey;
@@ -28,8 +53,6 @@ interface ReadForWidgetBreakdownArgs {
28
53
  adapterId?: string;
29
54
  now: Date;
30
55
  range?: DateRange;
31
- /** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
32
- scope?: string | null;
33
56
  /**
34
57
  * Reporting timezone the caller already resolved, reused rather than resolved again so
35
58
  * a caller-supplied `range` is read in the very timezone it was interpreted in.
@@ -37,16 +60,20 @@ interface ReadForWidgetBreakdownArgs {
37
60
  timezone?: string;
38
61
  filters?: AnalyticsFilter[];
39
62
  /**
40
- * Further metrics to read alongside the ranked one, narrowed to what the source serves
41
- * so an unsupported one never turns the whole read unavailable. They reach each row's
42
- * `metrics`; ranking and status still follow `metric` alone.
63
+ * Further metrics read beside the ranked one, narrowed to what the source serves so an
64
+ * unsupported one never fails the read. Ranking and status follow `metric` alone.
43
65
  */
44
66
  extraMetrics?: MetricKey[];
45
- }
67
+ /**
68
+ * Scope's goal slugs for a `goal` or `conversions` read, or `'unresolved'` if the caller's
69
+ * resolver failed. Resolved here when omitted.
70
+ */
71
+ goalSlugs?: string[] | 'unresolved'; /** The latent built-in slugs behind that hint; resolved here when omitted. */
72
+ builtinGoalSlugs?: string[];
73
+ };
46
74
  /**
47
- * Site-wide ranked breakdown of one metric by one dimension, read through the engine.
48
- * Mirrors `readForWidget` but gates on the dimension too and maps each result row to a
49
- * `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
75
+ * Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,
76
+ * each row labelled as built-in widgets label it. The adapter owns sorting and limiting.
50
77
  */
51
78
  declare const readForWidgetBreakdown: (args: ReadForWidgetBreakdownArgs) => Promise<WidgetBreakdownResult>;
52
79
  //#endregion
@@ -1,63 +1,55 @@
1
- import { getRuntime, resolveTimezoneFor } from "../plugin/runtime.js";
2
- import { resolveTimeframe } from "../timeframe/presets.js";
3
- import { satisfiesCapabilities } from "../core/capabilities.js";
4
- import { resolveReadContext } from "../core/scopedRead.js";
1
+ import { readPrincipalOf } from "../access/principal.js";
2
+ import { metricReaches } from "../core/capabilities.js";
3
+ import { readFailureOf } from "../surfacing/classifyError.js";
4
+ import { asTranslate } from "../translations/server.js";
5
+ import { emptyReading } from "../core/metricValues.js";
6
+ import { intlLocale } from "../translations/intl.js";
7
+ import { engineRead, pinnedScope, prepareWidgetRead, substitutionOf } from "./prepareWidgetRead.js";
8
+ import { readMeta } from "./readMeta.js";
9
+ import { resolveItemLabels } from "../plugin/itemLabels.js";
10
+ import { hasNoDeclaredGoals, isLatentGoalRow } from "../goals/latent.js";
11
+ import { valueLabel } from "../view/labels.js";
5
12
  //#region src/widgets/readForWidgetBreakdown.ts
6
13
  /**
7
- * Site-wide ranked breakdown of one metric by one dimension, read through the engine.
8
- * Mirrors `readForWidget` but gates on the dimension too and maps each result row to a
9
- * `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.
14
+ * Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,
15
+ * each row labelled as built-in widgets label it. The adapter owns sorting and limiting.
10
16
  */
11
17
  const readForWidgetBreakdown = async (args) => {
12
18
  const { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args;
13
- const emptyRows = [];
14
- const runtime = getRuntime(req.payload);
15
- if (!runtime) return {
16
- status: "unavailable",
17
- adapterId: adapterId ?? "",
18
- dateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),
19
- rows: emptyRows
20
- };
21
- const ctx = await resolveReadContext({
22
- runtime,
19
+ const metricsFor = (adapter) => [metric, ...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m) && metricReaches(adapter.capabilities, m, { dimensions: [dimension] }))];
20
+ const prepared = await prepareWidgetRead({
23
21
  req,
22
+ now,
23
+ timeframe,
24
24
  adapterId,
25
- scope: args.scope
25
+ ...readPrincipalOf(args),
26
+ ...args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {},
27
+ timezone: args.timezone,
28
+ range,
29
+ filters,
30
+ requires: {
31
+ metrics: [metric],
32
+ dimensions: [dimension]
33
+ },
34
+ goalRead: (adapter) => ({
35
+ metrics: metricsFor(adapter),
36
+ dimensions: [dimension]
37
+ }),
38
+ goalSlugs: args.goalSlugs,
39
+ ...args.builtinGoalSlugs === void 0 ? {} : { builtinGoalSlugs: args.builtinGoalSlugs }
26
40
  });
27
- if (!ctx.ok) return {
28
- status: "unavailable",
29
- adapterId: adapterId ?? "",
30
- dateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),
31
- rows: emptyRows
32
- };
33
- const tz = args.timezone ?? await resolveTimezoneFor(runtime, req, ctx.scope);
34
- const dateRange = range ?? resolveTimeframe(timeframe, now, tz);
35
- const base = {
36
- dateRange,
37
- rows: emptyRows
38
- };
39
- const adapter = ctx.adapter;
40
- if (!adapter.isConfigured()) return {
41
- status: "not-configured",
42
- adapterId: adapter.id,
43
- ...base
44
- };
45
- if (!satisfiesCapabilities(adapter.capabilities, {
46
- metrics: [metric],
47
- dimensions: [dimension],
48
- ...filters && filters.length > 0 ? {
49
- filters: filters.map((f) => f.dimension),
50
- filterOperators: filters.map((f) => f.operator)
51
- } : {}
52
- })) return {
53
- status: "unavailable",
54
- adapterId: adapter.id,
55
- ...base
41
+ if (!prepared.ok) return {
42
+ status: prepared.status,
43
+ adapterId: prepared.adapterId,
44
+ dateRange: prepared.dateRange,
45
+ rows: []
56
46
  };
57
- const metrics = [metric, ...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m))];
47
+ const { adapter, tz, dateRange, goalSlugs, builtinGoalSlugs, goalNames } = prepared;
48
+ const metrics = metricsFor(adapter);
49
+ const read = engineRead(prepared, timeframe);
58
50
  let result;
59
51
  try {
60
- result = await runtime.engine.read(adapter, {
52
+ result = await read({
61
53
  metrics,
62
54
  dimensions: [dimension],
63
55
  dateRange,
@@ -68,27 +60,48 @@ const readForWidgetBreakdown = async (args) => {
68
60
  },
69
61
  filters,
70
62
  timezone: tz,
71
- scope: ctx.queryScope
63
+ scope: prepared.queryScope,
64
+ ...goalSlugs === void 0 ? {} : { goalSlugs }
72
65
  });
73
- } catch {
66
+ } catch (err) {
74
67
  return {
75
- status: "unavailable",
68
+ ...readFailureOf(err),
76
69
  adapterId: adapter.id,
77
- ...base
70
+ dateRange,
71
+ rows: []
78
72
  };
79
73
  }
80
- const rows = result.rows.map((row) => ({
81
- label: row.dimensions?.[dimension] ?? "(none)",
82
- value: row.metrics[metric] ?? 0,
74
+ const kept = result.rows.map((row) => ({
75
+ dimensionValue: row.dimensions?.[dimension] ?? "",
76
+ value: row.metrics[metric] ?? emptyReading(metric),
83
77
  ...metrics.length > 1 ? { metrics: row.metrics } : {}
78
+ })).filter((row) => dimension !== "goal" || !isLatentGoalRow(row.dimensionValue, metric === "conversions" ? row.value : row.metrics?.conversions, builtinGoalSlugs));
79
+ const itemLabels = dimension === "item" ? await resolveItemLabels(req, kept.map((row) => row.dimensionValue)).catch(() => void 0) : void 0;
80
+ const translate = req.i18n?.t;
81
+ const locale = intlLocale(req.i18n?.language);
82
+ const rows = kept.map((row) => ({
83
+ label: translate === void 0 ? row.dimensionValue : valueLabel({
84
+ dimension,
85
+ value: row.dimensionValue,
86
+ provider: result.meta.provider,
87
+ t: asTranslate(translate),
88
+ locale,
89
+ goals: goalNames,
90
+ ...itemLabels ? { itemLabels } : {}
91
+ }),
92
+ ...row
84
93
  }));
85
94
  return {
86
95
  status: "ok",
87
96
  adapterId: adapter.id,
97
+ ...substitutionOf(prepared),
98
+ ...pinnedScope(args, prepared.queryScope),
88
99
  dateRange,
100
+ timezone: tz,
89
101
  rows,
90
- clamped: result.meta.clamped ?? false,
91
- stale: result.meta.stale ?? false
102
+ ...readMeta(result),
103
+ noGoals: Array.isArray(goalSlugs) && hasNoDeclaredGoals(goalSlugs, builtinGoalSlugs),
104
+ ...dimension === "goal" && goalNames.length > 0 ? { goals: goalNames } : {}
92
105
  };
93
106
  };
94
107
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"readForWidgetBreakdown.js","names":[],"sources":["../../src/widgets/readForWidgetBreakdown.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { satisfiesCapabilities } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\nimport { resolveReadContext } from '../core/scopedRead'\nimport { getRuntime, resolveTimezoneFor } from '../plugin/runtime'\nimport { resolveTimeframe, type TimeframePreset } from '../timeframe/presets'\nimport type { WidgetReadStatus } from './readForWidget'\n\nexport interface BreakdownRow {\n\tlabel: string\n\tvalue: number\n\t/** Every metric the read asked for, present only when `extraMetrics` asked for more. */\n\tmetrics?: Partial<Record<MetricKey, number>>\n}\n\nexport interface WidgetBreakdownResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n\tdateRange: DateRange\n\trows: BreakdownRow[]\n\tclamped?: boolean\n\t/** True when the engine served a stale cache entry after a failed provider read. */\n\tstale?: boolean\n}\n\nexport interface ReadForWidgetBreakdownArgs {\n\treq: PayloadRequest\n\tmetric: MetricKey\n\tdimension: DimensionKey\n\ttimeframe: TimeframePreset\n\tlimit: number\n\tadapterId?: string\n\tnow: Date\n\trange?: DateRange\n\t/** Explicit scope override; omitted resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n\t/**\n\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t */\n\ttimezone?: string\n\tfilters?: AnalyticsFilter[]\n\t/**\n\t * Further metrics to read alongside the ranked one, narrowed to what the source serves\n\t * so an unsupported one never turns the whole read unavailable. They reach each row's\n\t * `metrics`; ranking and status still follow `metric` alone.\n\t */\n\textraMetrics?: MetricKey[]\n}\n\n/**\n * Site-wide ranked breakdown of one metric by one dimension, read through the engine.\n * Mirrors `readForWidget` but gates on the dimension too and maps each result row to a\n * `{ label, value }` pair the bar list renders. The adapter owns sorting and limiting.\n */\nexport const readForWidgetBreakdown = async (\n\targs: ReadForWidgetBreakdownArgs\n): Promise<WidgetBreakdownResult> => {\n\tconst { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args\n\tconst emptyRows = [] as BreakdownRow[]\n\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),\n\t\t\trows: emptyRows,\n\t\t}\n\t}\n\tconst ctx = await resolveReadContext({ runtime, req, adapterId, scope: args.scope })\n\tif (!ctx.ok) {\n\t\treturn {\n\t\t\tstatus: 'unavailable',\n\t\t\tadapterId: adapterId ?? '',\n\t\t\tdateRange: range ?? resolveTimeframe(timeframe, now, args.timezone),\n\t\t\trows: emptyRows,\n\t\t}\n\t}\n\tconst tz = args.timezone ?? (await resolveTimezoneFor(runtime, req, ctx.scope))\n\tconst dateRange = range ?? resolveTimeframe(timeframe, now, tz)\n\tconst base = { dateRange, rows: emptyRows }\n\tconst adapter: AnalyticsAdapter = ctx.adapter\n\tif (!adapter.isConfigured()) {\n\t\treturn { status: 'not-configured', adapterId: adapter.id, ...base }\n\t}\n\tif (\n\t\t!satisfiesCapabilities(adapter.capabilities, {\n\t\t\tmetrics: [metric],\n\t\t\tdimensions: [dimension],\n\t\t\t...(filters && filters.length > 0\n\t\t\t\t? {\n\t\t\t\t\t\tfilters: filters.map((f) => f.dimension),\n\t\t\t\t\t\tfilterOperators: filters.map((f) => f.operator),\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t})\n\t) {\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst metrics = [\n\t\tmetric,\n\t\t...(args.extraMetrics ?? []).filter((m) => m !== metric && adapter.capabilities.metrics.has(m)),\n\t]\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await runtime.engine.read(adapter, {\n\t\t\tmetrics,\n\t\t\tdimensions: [dimension],\n\t\t\tdateRange,\n\t\t\tlimit,\n\t\t\torder: { metric, direction: 'desc' },\n\t\t\tfilters,\n\t\t\ttimezone: tz,\n\t\t\tscope: ctx.queryScope,\n\t\t})\n\t} catch {\n\t\t// No cache entry (fresh or stale) survived the failed read; degrade like an\n\t\t// unsupported capability instead of throwing through the widget render tree.\n\t\treturn { status: 'unavailable', adapterId: adapter.id, ...base }\n\t}\n\tconst rows = result.rows.map((row) => ({\n\t\tlabel: row.dimensions?.[dimension] ?? '(none)',\n\t\tvalue: row.metrics[metric] ?? 0,\n\t\t...(metrics.length > 1 ? { metrics: row.metrics } : {}),\n\t}))\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\tdateRange,\n\t\trows,\n\t\tclamped: result.meta.clamped ?? false,\n\t\tstale: result.meta.stale ?? false,\n\t}\n}\n"],"mappings":";;;;;;;;;;AA8DA,MAAa,yBAAyB,OACrC,SACoC;CACpC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,OAAO,WAAW,KAAK,OAAO,YAAY;CACrF,MAAM,YAAY,CAAC;CAEnB,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO;EACN,QAAQ;EACR,WAAW,aAAa;EACxB,WAAW,SAAS,iBAAiB,WAAW,KAAK,KAAK,QAAQ;EAClE,MAAM;CACP;CAED,MAAM,MAAM,MAAM,mBAAmB;EAAE;EAAS;EAAK;EAAW,OAAO,KAAK;CAAM,CAAC;CACnF,IAAI,CAAC,IAAI,IACR,OAAO;EACN,QAAQ;EACR,WAAW,aAAa;EACxB,WAAW,SAAS,iBAAiB,WAAW,KAAK,KAAK,QAAQ;EAClE,MAAM;CACP;CAED,MAAM,KAAK,KAAK,YAAa,MAAM,mBAAmB,SAAS,KAAK,IAAI,KAAK;CAC7E,MAAM,YAAY,SAAS,iBAAiB,WAAW,KAAK,EAAE;CAC9D,MAAM,OAAO;EAAE;EAAW,MAAM;CAAU;CAC1C,MAAM,UAA4B,IAAI;CACtC,IAAI,CAAC,QAAQ,aAAa,GACzB,OAAO;EAAE,QAAQ;EAAkB,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEnE,IACC,CAAC,sBAAsB,QAAQ,cAAc;EAC5C,SAAS,CAAC,MAAM;EAChB,YAAY,CAAC,SAAS;EACtB,GAAI,WAAW,QAAQ,SAAS,IAC7B;GACA,SAAS,QAAQ,KAAK,MAAM,EAAE,SAAS;GACvC,iBAAiB,QAAQ,KAAK,MAAM,EAAE,QAAQ;EAC/C,IACC,CAAC;CACL,CAAC,GAED,OAAO;EAAE,QAAQ;EAAe,WAAW,QAAQ;EAAI,GAAG;CAAK;CAEhE,MAAM,UAAU,CACf,QACA,IAAI,KAAK,gBAAgB,CAAC,GAAG,QAAQ,MAAM,MAAM,UAAU,QAAQ,aAAa,QAAQ,IAAI,CAAC,CAAC,CAC/F;CACA,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,QAAQ,OAAO,KAAK,SAAS;GAC3C;GACA,YAAY,CAAC,SAAS;GACtB;GACA;GACA,OAAO;IAAE;IAAQ,WAAW;GAAO;GACnC;GACA,UAAU;GACV,OAAO,IAAI;EACZ,CAAC;CACF,QAAQ;EAGP,OAAO;GAAE,QAAQ;GAAe,WAAW,QAAQ;GAAI,GAAG;EAAK;CAChE;CACA,MAAM,OAAO,OAAO,KAAK,KAAK,SAAS;EACtC,OAAO,IAAI,aAAa,cAAc;EACtC,OAAO,IAAI,QAAQ,WAAW;EAC9B,GAAI,QAAQ,SAAS,IAAI,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;CACtD,EAAE;CACF,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB;EACA;EACA,SAAS,OAAO,KAAK,WAAW;EAChC,OAAO,OAAO,KAAK,SAAS;CAC7B;AACD"}
1
+ {"version":3,"file":"readForWidgetBreakdown.js","names":[],"sources":["../../src/widgets/readForWidgetBreakdown.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type ReadPrincipal, readPrincipalOf } from '../access/principal'\nimport { metricReaches } from '../core/capabilities'\nimport type {\n\tAnalyticsAdapter,\n\tAnalyticsFilter,\n\tAnalyticsResult,\n\tDateRange,\n\tDimensionKey,\n\tMetricKey,\n\tMetricValue,\n\tMetricValues,\n} from '../core/contract'\nimport { emptyReading } from '../core/metricValues'\nimport { hasNoDeclaredGoals, isLatentGoalRow } from '../goals/latent'\nimport { resolveItemLabels } from '../plugin/itemLabels'\nimport { readFailureOf } from '../surfacing/classifyError'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { intlLocale } from '../translations/intl'\nimport { asTranslate } from '../translations/server'\nimport { valueLabel } from '../view/labels'\nimport {\n\tengineRead,\n\tpinnedScope,\n\tprepareWidgetRead,\n\ttype StoredSourceRead,\n\ttype SubstitutedSource,\n\tsubstitutionOf,\n\ttype WidgetReadStatus,\n} from './prepareWidgetRead'\nimport { type ReadNotices, readMeta } from './readMeta'\n\nexport interface BreakdownRow {\n\t/**\n\t * What the reader sees, in the admin language as every built-in surface labels the row:\n\t * a goal's name, a country's, an item's title, `Not set` for a row with no value.\n\t */\n\tlabel: string\n\t/** The stored value, `''` for a row with no value: what a filter or a link to the view keeps. */\n\tdimensionValue: string\n\t/** `null` when the row has no reading for an average, which is no data rather than zero. */\n\tvalue: MetricValue\n\t/** Every metric the read asked for, present only when `extraMetrics` asked for more. */\n\tmetrics?: MetricValues\n}\n\nexport interface WidgetBreakdownResult extends Partial<ReadNotices>, SubstitutedSource {\n\tstatus: WidgetReadStatus\n\t/** How long until a `busy` read can succeed, when the source or the plugin knows. */\n\tretryAfterMs?: number\n\tadapterId: string\n\t/** The reporting timezone the read resolved in, which names its days. */\n\ttimezone?: string\n\t/**\n\t * Scope a link to this read must name, set only when the viewer would not resolve it alone:\n\t * a needless `scope` refuses every reader without `access.crossScope`.\n\t */\n\tscope?: string\n\tdateRange: DateRange\n\trows: BreakdownRow[]\n\t/** The source that answered, absent on a read that never reached one. */\n\tprovider?: string\n\t/** True when the read asked about goals and the scope declared none: an empty table. */\n\tnoGoals?: boolean\n\t/** The scope's goals behind a `goal` read's slugs, so its rows read as names. */\n\tgoals?: Array<{ slug: string; name: string }>\n}\n\n/** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */\nexport type ReadForWidgetBreakdownArgs = ReadPrincipal &\n\tStoredSourceRead & {\n\t\treq: PayloadRequest\n\t\tmetric: MetricKey\n\t\tdimension: DimensionKey\n\t\ttimeframe: TimeframePreset\n\t\tlimit: number\n\t\tadapterId?: string\n\t\tnow: Date\n\t\trange?: DateRange\n\t\t/**\n\t\t * Reporting timezone the caller already resolved, reused rather than resolved again so\n\t\t * a caller-supplied `range` is read in the very timezone it was interpreted in.\n\t\t */\n\t\ttimezone?: string\n\t\tfilters?: AnalyticsFilter[]\n\t\t/**\n\t\t * Further metrics read beside the ranked one, narrowed to what the source serves so an\n\t\t * unsupported one never fails the read. Ranking and status follow `metric` alone.\n\t\t */\n\t\textraMetrics?: MetricKey[]\n\t\t/**\n\t\t * Scope's goal slugs for a `goal` or `conversions` read, or `'unresolved'` if the caller's\n\t\t * resolver failed. Resolved here when omitted.\n\t\t */\n\t\tgoalSlugs?: string[] | 'unresolved'\n\t\t/** The latent built-in slugs behind that hint; resolved here when omitted. */\n\t\tbuiltinGoalSlugs?: string[]\n\t}\n\n/**\n * Ranked breakdown of one metric by one dimension: `readForWidget` gated on the dimension too,\n * each row labelled as built-in widgets label it. The adapter owns sorting and limiting.\n */\nexport const readForWidgetBreakdown = async (\n\targs: ReadForWidgetBreakdownArgs\n): Promise<WidgetBreakdownResult> => {\n\tconst { req, metric, dimension, timeframe, limit, adapterId, now, range, filters } = args\n\tconst metricsFor = (adapter: AnalyticsAdapter): MetricKey[] => [\n\t\tmetric,\n\t\t...(args.extraMetrics ?? []).filter(\n\t\t\t(m) =>\n\t\t\t\tm !== metric &&\n\t\t\t\tadapter.capabilities.metrics.has(m) &&\n\t\t\t\tmetricReaches(adapter.capabilities, m, { dimensions: [dimension] })\n\t\t),\n\t]\n\tconst prepared = await prepareWidgetRead({\n\t\treq,\n\t\tnow,\n\t\ttimeframe,\n\t\tadapterId,\n\t\t...readPrincipalOf(args),\n\t\t...(args.fallbackWhenUnreadable ? { fallbackWhenUnreadable: true } : {}),\n\t\ttimezone: args.timezone,\n\t\trange,\n\t\tfilters,\n\t\trequires: { metrics: [metric], dimensions: [dimension] },\n\t\tgoalRead: (adapter) => ({ metrics: metricsFor(adapter), dimensions: [dimension] }),\n\t\tgoalSlugs: args.goalSlugs,\n\t\t...(args.builtinGoalSlugs === undefined ? {} : { builtinGoalSlugs: args.builtinGoalSlugs }),\n\t})\n\tif (!prepared.ok) {\n\t\treturn {\n\t\t\tstatus: prepared.status,\n\t\t\tadapterId: prepared.adapterId,\n\t\t\tdateRange: prepared.dateRange,\n\t\t\trows: [],\n\t\t}\n\t}\n\tconst { adapter, tz, dateRange, goalSlugs, builtinGoalSlugs, goalNames } = prepared\n\tconst metrics = metricsFor(adapter)\n\tconst read = engineRead(prepared, timeframe)\n\tlet result: AnalyticsResult\n\ttry {\n\t\tresult = await read({\n\t\t\tmetrics,\n\t\t\tdimensions: [dimension],\n\t\t\tdateRange,\n\t\t\tlimit,\n\t\t\torder: { metric, direction: 'desc' },\n\t\t\tfilters,\n\t\t\ttimezone: tz,\n\t\t\tscope: prepared.queryScope,\n\t\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t\t})\n\t} catch (err) {\n\t\t// A failed read is a status, never a throw through the render tree.\n\t\treturn { ...readFailureOf(err), adapterId: adapter.id, dateRange, rows: [] }\n\t}\n\tconst kept = result.rows\n\t\t.map((row) => ({\n\t\t\tdimensionValue: row.dimensions?.[dimension] ?? '',\n\t\t\tvalue: row.metrics[metric] ?? emptyReading(metric),\n\t\t\t...(metrics.length > 1 ? { metrics: row.metrics } : {}),\n\t\t}))\n\t\t// A built-in goal is latent: it earns a row once someone has converted on it, and until\n\t\t// then a site that sells nothing would read a \"Purchase\" row at zero in every report.\n\t\t.filter(\n\t\t\t(row) =>\n\t\t\t\tdimension !== 'goal' ||\n\t\t\t\t!isLatentGoalRow(\n\t\t\t\t\trow.dimensionValue,\n\t\t\t\t\tmetric === 'conversions' ? row.value : row.metrics?.conversions,\n\t\t\t\t\tbuiltinGoalSlugs\n\t\t\t\t)\n\t\t)\n\tconst itemLabels =\n\t\tdimension === 'item'\n\t\t\t? await resolveItemLabels(\n\t\t\t\t\treq,\n\t\t\t\t\tkept.map((row) => row.dimensionValue)\n\t\t\t\t).catch((): undefined => undefined)\n\t\t\t: undefined\n\t// A request built without Payload's i18n (a bare Local API caller) has no words to label with.\n\tconst translate = req.i18n?.t\n\tconst locale = intlLocale(req.i18n?.language)\n\tconst rows: BreakdownRow[] = kept.map((row) => ({\n\t\tlabel:\n\t\t\ttranslate === undefined\n\t\t\t\t? row.dimensionValue\n\t\t\t\t: valueLabel({\n\t\t\t\t\t\tdimension,\n\t\t\t\t\t\tvalue: row.dimensionValue,\n\t\t\t\t\t\tprovider: result.meta.provider,\n\t\t\t\t\t\tt: asTranslate(translate),\n\t\t\t\t\t\tlocale,\n\t\t\t\t\t\tgoals: goalNames,\n\t\t\t\t\t\t...(itemLabels ? { itemLabels } : {}),\n\t\t\t\t\t}),\n\t\t...row,\n\t}))\n\treturn {\n\t\tstatus: 'ok',\n\t\tadapterId: adapter.id,\n\t\t...substitutionOf(prepared),\n\t\t...pinnedScope(args, prepared.queryScope),\n\t\tdateRange,\n\t\ttimezone: tz,\n\t\trows,\n\t\t...readMeta(result),\n\t\t// The hint is set only for a read about goals, so one carrying nothing the install\n\t\t// declared is a scope that configured none rather than a read that never asked.\n\t\tnoGoals: Array.isArray(goalSlugs) && hasNoDeclaredGoals(goalSlugs, builtinGoalSlugs),\n\t\t...(dimension === 'goal' && goalNames.length > 0 ? { goals: goalNames } : {}),\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuGA,MAAa,yBAAyB,OACrC,SACoC;CACpC,MAAM,EAAE,KAAK,QAAQ,WAAW,WAAW,OAAO,WAAW,KAAK,OAAO,YAAY;CACrF,MAAM,cAAc,YAA2C,CAC9D,QACA,IAAI,KAAK,gBAAgB,CAAC,GAAG,QAC3B,MACA,MAAM,UACN,QAAQ,aAAa,QAAQ,IAAI,CAAC,KAClC,cAAc,QAAQ,cAAc,GAAG,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CACpE,CACD;CACA,MAAM,WAAW,MAAM,kBAAkB;EACxC;EACA;EACA;EACA;EACA,GAAG,gBAAgB,IAAI;EACvB,GAAI,KAAK,yBAAyB,EAAE,wBAAwB,KAAK,IAAI,CAAC;EACtE,UAAU,KAAK;EACf;EACA;EACA,UAAU;GAAE,SAAS,CAAC,MAAM;GAAG,YAAY,CAAC,SAAS;EAAE;EACvD,WAAW,aAAa;GAAE,SAAS,WAAW,OAAO;GAAG,YAAY,CAAC,SAAS;EAAE;EAChF,WAAW,KAAK;EAChB,GAAI,KAAK,qBAAqB,KAAA,IAAY,CAAC,IAAI,EAAE,kBAAkB,KAAK,iBAAiB;CAC1F,CAAC;CACD,IAAI,CAAC,SAAS,IACb,OAAO;EACN,QAAQ,SAAS;EACjB,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,MAAM,CAAC;CACR;CAED,MAAM,EAAE,SAAS,IAAI,WAAW,WAAW,kBAAkB,cAAc;CAC3E,MAAM,UAAU,WAAW,OAAO;CAClC,MAAM,OAAO,WAAW,UAAU,SAAS;CAC3C,IAAI;CACJ,IAAI;EACH,SAAS,MAAM,KAAK;GACnB;GACA,YAAY,CAAC,SAAS;GACtB;GACA;GACA,OAAO;IAAE;IAAQ,WAAW;GAAO;GACnC;GACA,UAAU;GACV,OAAO,SAAS;GAChB,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;EAChD,CAAC;CACF,SAAS,KAAK;EAEb,OAAO;GAAE,GAAG,cAAc,GAAG;GAAG,WAAW,QAAQ;GAAI;GAAW,MAAM,CAAC;EAAE;CAC5E;CACA,MAAM,OAAO,OAAO,KAClB,KAAK,SAAS;EACd,gBAAgB,IAAI,aAAa,cAAc;EAC/C,OAAO,IAAI,QAAQ,WAAW,aAAa,MAAM;EACjD,GAAI,QAAQ,SAAS,IAAI,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;CACtD,EAAE,EAGD,QACC,QACA,cAAc,UACd,CAAC,gBACA,IAAI,gBACJ,WAAW,gBAAgB,IAAI,QAAQ,IAAI,SAAS,aACpD,gBACD,CACF;CACD,MAAM,aACL,cAAc,SACX,MAAM,kBACN,KACA,KAAK,KAAK,QAAQ,IAAI,cAAc,CACrC,EAAE,YAAuB,KAAA,CAAS,IACjC,KAAA;CAEJ,MAAM,YAAY,IAAI,MAAM;CAC5B,MAAM,SAAS,WAAW,IAAI,MAAM,QAAQ;CAC5C,MAAM,OAAuB,KAAK,KAAK,SAAS;EAC/C,OACC,cAAc,KAAA,IACX,IAAI,iBACJ,WAAW;GACX;GACA,OAAO,IAAI;GACX,UAAU,OAAO,KAAK;GACtB,GAAG,YAAY,SAAS;GACxB;GACA,OAAO;GACP,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;EACpC,CAAC;EACJ,GAAG;CACJ,EAAE;CACF,OAAO;EACN,QAAQ;EACR,WAAW,QAAQ;EACnB,GAAG,eAAe,QAAQ;EAC1B,GAAG,YAAY,MAAM,SAAS,UAAU;EACxC;EACA,UAAU;EACV;EACA,GAAG,SAAS,MAAM;EAGlB,SAAS,MAAM,QAAQ,SAAS,KAAK,mBAAmB,WAAW,gBAAgB;EACnF,GAAI,cAAc,UAAU,UAAU,SAAS,IAAI,EAAE,OAAO,UAAU,IAAI,CAAC;CAC5E;AACD"}
@@ -1,6 +1,8 @@
1
1
  import { DateRange } from "../core/contract.js";
2
+ import { ReadPrincipal } from "../access/principal.js";
2
3
  import { TimeframePreset } from "../timeframe/presets.js";
3
- import { WidgetReadStatus } from "./readForWidget.js";
4
+ import { ReadNotices } from "./readMeta.js";
5
+ import { StoredSourceRead, SubstitutedSource, WidgetReadStatus } from "./prepareWidgetRead.js";
4
6
  import { PayloadRequest } from "payload";
5
7
 
6
8
  //#region src/widgets/readForWidgetGoals.d.ts
@@ -14,42 +16,44 @@ interface GoalRow {
14
16
  rate?: number;
15
17
  previousConversions?: number;
16
18
  }
17
- interface WidgetGoalsResult {
19
+ interface WidgetGoalsResult extends Partial<ReadNotices>, SubstitutedSource {
18
20
  status: WidgetReadStatus;
21
+ /** How long until a `busy` read can succeed, when the source or the plugin knows. */
22
+ retryAfterMs?: number;
19
23
  adapterId: string;
24
+ /**
25
+ * Scope a link to this read must name, set only when the viewer would not resolve it alone:
26
+ * a needless `scope` refuses every reader without `access.crossScope`.
27
+ */
28
+ scope?: string;
20
29
  dateRange: DateRange;
21
30
  timezone: string;
22
31
  rows: GoalRow[];
23
32
  /** Range total the rate divides by; absent when the source does not serve visitors. */
24
33
  siteVisitors?: number;
25
- clamped?: boolean;
26
- stale?: boolean;
34
+ /** The source that answered, absent on a read that never reached one. */
35
+ provider?: string;
36
+ /** True when the scope declares no goals of its own: an empty table, not a failure. */
37
+ noGoals?: boolean;
27
38
  }
28
- interface ReadForWidgetGoalsArgs {
39
+ /** Scoped like `ReadForWidgetArgs`: the request's own scope unless one is pinned. */
40
+ type ReadForWidgetGoalsArgs = ReadPrincipal & StoredSourceRead & {
29
41
  req: PayloadRequest;
30
42
  timeframe: TimeframePreset;
31
- limit: number;
32
- /** Read the previous window too, when the source can compare. */
43
+ limit: number; /** Read the previous window too, when the source can compare. */
33
44
  compare: boolean;
34
45
  adapterId?: string;
35
46
  now: Date;
36
47
  range?: DateRange;
37
- /** Explicit scope override; omitted resolves via the plugin's scopeResolver. */
38
- scope?: string | null;
39
48
  /**
40
49
  * Reporting timezone the caller already resolved, reused rather than resolved again so
41
50
  * a caller-supplied `range` is read in the very timezone it was interpreted in.
42
51
  */
43
52
  timezone?: string;
44
- }
53
+ };
45
54
  /**
46
- * The goals table behind the goals widget: conversions per goal over the window, each with
47
- * its revenue, its share of the site's visitors, and (when comparing) the same goal's
48
- * conversions in the previous window. Rows come from one `goal` breakdown read and the site
49
- * total from one totals read, both through the existing widget helpers so capability
50
- * gating, scoping and caching stay in one place. Revenue and visitors ride along only where
51
- * the source serves them; the status is the breakdown's, since a table without its rows has
52
- * nothing to show.
55
+ * Goals table from a `goal` breakdown, a visitors total for the rate and, when comparing, the
56
+ * previous window's breakdown. Status is the breakdown's: a table without rows shows nothing.
53
57
  */
54
58
  declare const readForWidgetGoals: (args: ReadForWidgetGoalsArgs) => Promise<WidgetGoalsResult>;
55
59
  //#endregion