@10x-media/analytics 1.0.0-beta.9 → 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 +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  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 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,20 +1,23 @@
1
- import "./paths.js";
2
- import "../core/contract.js";
3
- import { getRuntime, platformReadGate, readAccessFor, resolveTimezoneFor } from "./runtime.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import { describeWithCauses } from "../core/sourceErrors.js";
3
+ import { currentDate } from "../core/clock.js";
4
+ import { getRuntime, resolvableScope, resolveCurrencyFor, resolveTimezoneFor, scopeGates } from "./runtime.js";
5
+ import { resolveQueryScope, resolveRequestedScope } from "../core/scopedRead.js";
6
+ import { NO_STORE, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
4
7
  import { serializeCapabilities } from "../core/capabilities.js";
5
- import { resolveQueryScope } from "../core/scopedRead.js";
6
- import { goalSlugsFor } from "./goalHint.js";
7
- import { previousWindow, withinLookback } from "../widgets/comparison.js";
8
- import { NO_STORE, RETRY_AFTER, errorResponse } from "./responses.js";
9
- import { queryError } from "../query/errors.js";
8
+ import { previousWindow, withinLookback } from "../timeframe/comparison.js";
9
+ import { revenueCurrencyOf } from "../goals/currency.js";
10
+ import { aliasMetrics, askedResult, servedQuery } from "../core/metricAliases.js";
11
+ import { goalHintFor } from "./goalHint.js";
10
12
  import { parseQueryParams, readParam } from "../query/parse.js";
13
+ import { queryParams } from "./queryParams.js";
14
+ import { itemRefsOf, resolveItemLabels } from "./itemLabels.js";
11
15
  import { resolveSourcesForRequest } from "./readContextForRequest.js";
16
+ import { readFailureResponse } from "./readFailure.js";
12
17
  //#region src/plugin/queryEndpoint.ts
13
18
  /**
14
- * The query as the response echoes it: the date range's instants as ISO strings, every
15
- * other field as the read carried it. `goalSlugs` rides along unchanged, so a client sees
16
- * the scope's slugs, an empty list for a scope with no goals, or the string `'unresolved'`
17
- * when the resolver failed.
19
+ * The query as the response echoes it, the range as ISO strings. `goalSlugs` rides along: the
20
+ * scope's slugs, `[]` for no goals, or `'unresolved'` when the resolver failed.
18
21
  */
19
22
  const serializeQuery = (query) => ({
20
23
  ...query,
@@ -23,95 +26,121 @@ const serializeQuery = (query) => ({
23
26
  end: query.dateRange.end.toISOString()
24
27
  }
25
28
  });
29
+ const noSourceResponse = () => errorResponse(404, analyticsError("unknown_source", "analytics: no source is available for this request"));
26
30
  /**
27
- * Authenticated GET over the surfacing engine: the public read primitive the admin view
28
- * and consumers' own dashboards are built on. Gating runs in a fixed order so a caller
29
- * learns nothing from the answer it is not already entitled to: authentication, then
30
- * `access.read`, then scope and source resolution (shared with the sources endpoint, so a
31
- * tenant can select no source that endpoint does not list), then capability validation of
32
- * every parameter against the selected source. Being listed is not sufficient: a shared
33
- * source that cannot narrow to the caller's scope answers 403 with `param: 'source'`.
34
- * Errors carry a code and the parameter at fault; adapter configuration and upstream error
35
- * text never reach the response.
31
+ * Authenticated GET over the surfacing engine, gated in order (auth, `access.read`, scope, source,
32
+ * capabilities) so no answer leaks past the caller's entitlement. Upstream error text never leaks.
36
33
  */
37
34
  const makeQueryHandler = () => async (req) => {
38
- if (!req.user) return errorResponse(401, queryError("unauthorized", "analytics: authentication required"));
35
+ if (!req.user) return unauthorizedResponse();
39
36
  const runtime = getRuntime(req.payload);
40
- if (!runtime) return errorResponse(503, queryError("unavailable", "analytics: not available"), RETRY_AFTER);
37
+ if (!runtime) return notAvailableResponse();
41
38
  let adapterId = "unresolved";
42
39
  try {
43
- if (!await readAccessFor(runtime, req)) return errorResponse(403, queryError("forbidden", "analytics: read access denied"));
44
- const params = new URL(req.url ?? "", "http://localhost").searchParams;
45
- const platformRead = platformReadGate(runtime, req);
46
- const requestedScope = readParam(params, "scope");
47
- if (requestedScope !== null && !await platformRead()) return errorResponse(400, queryError("untrusted_scope", "analytics: scope is not permitted for this request", "scope"));
40
+ if (!await readGate(runtime, req)) return readDeniedResponse();
41
+ const params = queryParams(req);
42
+ const gates = scopeGates(runtime, req);
43
+ const requested = await resolveRequestedScope({
44
+ runtime,
45
+ req,
46
+ raw: params.get("scope"),
47
+ gates
48
+ });
49
+ if (!requested.ok) return requested.reason === "named" || requested.reason === "not-member" ? untrustedScopeResponse("scope") : noSourceResponse();
48
50
  const context = await resolveSourcesForRequest(req, {
49
- platformRead,
50
- ...requestedScope === null ? {} : { scope: requestedScope }
51
+ gates,
52
+ scope: requested.gated
51
53
  });
52
- if (context.adapters.size === 0) return errorResponse(404, queryError("unknown_source", "analytics: no source is available for this request"));
54
+ if (context.adapters.size === 0) return noSourceResponse();
53
55
  const requestedSource = readParam(params, "source");
54
56
  const adapter = context.adapters.get(requestedSource ?? context.defaultId ?? "");
55
- if (!adapter) return errorResponse(404, queryError("unknown_source", "analytics: unknown source", "source"));
57
+ if (!adapter) return errorResponse(404, analyticsError("unknown_source", "analytics: unknown source", "source"));
56
58
  adapterId = adapter.id;
57
59
  const queryScope = await resolveQueryScope({
58
60
  runtime,
59
61
  req,
60
62
  scope: context.scope,
61
63
  adapter,
62
- platformRead
64
+ gates
63
65
  });
64
- if (!queryScope.ok) return errorResponse(403, queryError("forbidden", "analytics: this source cannot be read for your scope", "source"));
66
+ if (!queryScope.ok) return errorResponse(403, analyticsError("forbidden", "analytics: this source cannot be read for your scope", "source"));
65
67
  const capabilities = serializeCapabilities(adapter.capabilities);
68
+ const ownScope = resolvableScope(context.scope);
66
69
  const parsed = parseQueryParams(params, {
67
70
  capabilities,
68
- timezone: await resolveTimezoneFor(runtime, req, context.scope === "*" ? null : context.scope)
71
+ timezone: await resolveTimezoneFor(runtime, req, ownScope)
69
72
  });
70
73
  if (!parsed.ok) return errorResponse(400, parsed.error);
71
- const goalSlugs = await goalSlugsFor({
74
+ const hint = await goalHintFor({
72
75
  runtime,
73
76
  req,
74
- scope: context.scope === "*" ? null : context.scope,
77
+ scope: ownScope,
75
78
  metrics: parsed.value.query.metrics,
76
79
  dimensions: parsed.value.query.dimensions
77
80
  });
78
81
  const query = {
79
82
  ...parsed.value.query,
80
83
  ...queryScope.queryScope === void 0 ? {} : { scope: queryScope.queryScope },
81
- ...goalSlugs === void 0 ? {} : { goalSlugs }
84
+ ...hint === void 0 ? {} : { goalSlugs: hint.slugs }
82
85
  };
83
86
  let comparisonRange = null;
84
87
  if (parsed.value.compare === "previous") {
85
88
  comparisonRange = previousWindow(query.dateRange, query.timezone);
86
- if (!comparisonRange) return errorResponse(400, queryError("invalid_param", "analytics: the range is too long to compare against a previous period", "compare"));
87
- if (!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, { tz: query.timezone })) comparisonRange = null;
89
+ if (!comparisonRange) return errorResponse(400, analyticsError("invalid_param", "analytics: the range is too long to compare against a previous period", "compare"));
90
+ if (!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, {
91
+ tz: query.timezone,
92
+ now: currentDate()
93
+ })) comparisonRange = null;
88
94
  }
95
+ const readOptions = {
96
+ whenBusy: "refuse",
97
+ priority: "interactive",
98
+ ...parsed.value.timeframe === null ? {} : { timeframe: parsed.value.timeframe }
99
+ };
100
+ const aliased = aliasMetrics(query.metrics, adapter.capabilities.metrics);
101
+ const served = servedQuery(query, aliased);
89
102
  let result;
90
103
  let comparison;
91
104
  try {
92
- [result, comparison] = await Promise.all([runtime.engine.read(adapter, query), comparisonRange ? runtime.engine.read(adapter, {
93
- ...query,
105
+ const [read, previous] = await Promise.all([runtime.engine.read(adapter, served, readOptions), comparisonRange ? runtime.engine.read(adapter, {
106
+ ...served,
94
107
  dateRange: comparisonRange
95
- }) : void 0]);
108
+ }, readOptions) : void 0]);
109
+ result = askedResult(read, aliased);
110
+ comparison = previous && askedResult(previous, aliased);
96
111
  } catch (err) {
97
- req.payload.logger?.warn(`analytics: query read failed for adapter "${adapter.id}": ${String(err)}`);
98
- return errorResponse(503, queryError("unavailable", "analytics: source is temporarily unavailable"), RETRY_AFTER);
112
+ req.payload.logger?.warn(`analytics: query read failed for adapter "${adapter.id}": ${describeWithCauses(err)}`);
113
+ return readFailureResponse(err);
99
114
  }
115
+ const reporting = revenueCurrencyOf(query.filters, await resolveCurrencyFor(runtime, req, ownScope));
116
+ const withCurrency = (read) => reporting && read.meta.currency === void 0 ? {
117
+ ...read,
118
+ meta: {
119
+ ...read.meta,
120
+ currency: reporting
121
+ }
122
+ } : read;
123
+ const currency = result.meta.currency ?? reporting;
124
+ const refs = itemRefsOf(query, [result, comparison]);
125
+ const itemLabels = refs.length > 0 ? await resolveItemLabels(req, refs) : void 0;
100
126
  const body = {
101
- result,
102
- ...comparison ? { comparison } : {},
127
+ result: withCurrency(result),
128
+ ...comparison ? { comparison: withCurrency(comparison) } : {},
129
+ ...currency ? { currency } : {},
103
130
  source: {
104
131
  id: adapter.id,
105
- label: adapter.label,
132
+ label: context.sources.find((source) => source.id === adapter.id)?.label ?? adapter.label,
106
133
  kind: runtime.configAdapterIds.has(adapter.id) ? "config" : "runtime"
107
134
  },
108
135
  capabilities,
109
- query: serializeQuery(query)
136
+ query: serializeQuery(query),
137
+ ...hint && hint.builtin.length > 0 ? { builtinGoalSlugs: hint.builtin } : {},
138
+ ...itemLabels ? { itemLabels } : {}
110
139
  };
111
140
  return Response.json(body, { headers: NO_STORE });
112
141
  } catch (err) {
113
- req.payload.logger?.warn(`analytics: query failed for adapter "${adapterId}": ${String(err)}`);
114
- return errorResponse(500, queryError("internal", "analytics: query failed"));
142
+ req.payload.logger?.error(`analytics: query failed for adapter "${adapterId}": ${String(err)}`);
143
+ return errorResponse(500, analyticsError("internal", "analytics: query failed"));
115
144
  }
116
145
  };
117
146
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"queryEndpoint.js","names":[],"sources":["../../src/plugin/queryEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { serializeCapabilities } from '../core/capabilities'\nimport {\n\ttype AnalyticsQuery,\n\ttype AnalyticsResult,\n\ttype DateRange,\n\tPLATFORM_SCOPE,\n} from '../core/contract'\nimport { resolveQueryScope } from '../core/scopedRead'\nimport { queryError } from '../query/errors'\nimport { parseQueryParams, readParam } from '../query/parse'\nimport type { QueryResponse, SerializedAnalyticsQuery } from '../query/response'\nimport { previousWindow, withinLookback } from '../widgets/comparison'\nimport { goalSlugsFor } from './goalHint'\nimport { QUERY_PATH } from './paths'\nimport { resolveSourcesForRequest } from './readContextForRequest'\nimport { errorResponse, NO_STORE, RETRY_AFTER } from './responses'\nimport { getRuntime, platformReadGate, readAccessFor, resolveTimezoneFor } from './runtime'\n\nexport { QUERY_PATH }\n\n/**\n * The query as the response echoes it: the date range's instants as ISO strings, every\n * other field as the read carried it. `goalSlugs` rides along unchanged, so a client sees\n * the scope's slugs, an empty list for a scope with no goals, or the string `'unresolved'`\n * when the resolver failed.\n */\nexport const serializeQuery = (query: AnalyticsQuery): SerializedAnalyticsQuery => ({\n\t...query,\n\tdateRange: {\n\t\tstart: query.dateRange.start.toISOString(),\n\t\tend: query.dateRange.end.toISOString(),\n\t},\n})\n\n/**\n * Authenticated GET over the surfacing engine: the public read primitive the admin view\n * and consumers' own dashboards are built on. Gating runs in a fixed order so a caller\n * learns nothing from the answer it is not already entitled to: authentication, then\n * `access.read`, then scope and source resolution (shared with the sources endpoint, so a\n * tenant can select no source that endpoint does not list), then capability validation of\n * every parameter against the selected source. Being listed is not sufficient: a shared\n * source that cannot narrow to the caller's scope answers 403 with `param: 'source'`.\n * Errors carry a code and the parameter at fault; adapter configuration and upstream error\n * text never reach the response.\n */\nexport const makeQueryHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn errorResponse(401, queryError('unauthorized', 'analytics: authentication required'))\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\t// Both `unavailable` answers are retryable, so both carry the same delay: a client\n\t\t// backs off identically whether the plugin is still booting or a provider is down.\n\t\treturn errorResponse(503, queryError('unavailable', 'analytics: not available'), RETRY_AFTER)\n\t}\n\tlet adapterId = 'unresolved'\n\ttry {\n\t\tif (!(await readAccessFor(runtime, req))) {\n\t\t\treturn errorResponse(403, queryError('forbidden', 'analytics: read access denied'))\n\t\t}\n\t\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\t\tconst platformRead = platformReadGate(runtime, req)\n\t\tconst requestedScope = readParam(params, 'scope')\n\t\tif (requestedScope !== null && !(await platformRead())) {\n\t\t\treturn errorResponse(\n\t\t\t\t400,\n\t\t\t\tqueryError('untrusted_scope', 'analytics: scope is not permitted for this request', 'scope')\n\t\t\t)\n\t\t}\n\t\tconst context = await resolveSourcesForRequest(req, {\n\t\t\tplatformRead,\n\t\t\t...(requestedScope === null ? {} : { scope: requestedScope }),\n\t\t})\n\t\tif (context.adapters.size === 0) {\n\t\t\treturn errorResponse(\n\t\t\t\t404,\n\t\t\t\tqueryError('unknown_source', 'analytics: no source is available for this request')\n\t\t\t)\n\t\t}\n\t\tconst requestedSource = readParam(params, 'source')\n\t\tconst adapter = context.adapters.get(requestedSource ?? context.defaultId ?? '')\n\t\tif (!adapter) {\n\t\t\treturn errorResponse(404, queryError('unknown_source', 'analytics: unknown source', 'source'))\n\t\t}\n\t\tadapterId = adapter.id\n\t\tconst queryScope = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope: context.scope,\n\t\t\tadapter,\n\t\t\tplatformRead,\n\t\t})\n\t\tif (!queryScope.ok) {\n\t\t\treturn errorResponse(\n\t\t\t\t403,\n\t\t\t\tqueryError('forbidden', 'analytics: this source cannot be read for your scope', 'source')\n\t\t\t)\n\t\t}\n\t\tconst capabilities = serializeCapabilities(adapter.capabilities)\n\t\tconst timezone = await resolveTimezoneFor(\n\t\t\truntime,\n\t\t\treq,\n\t\t\tcontext.scope === PLATFORM_SCOPE ? null : context.scope\n\t\t)\n\t\tconst parsed = parseQueryParams(params, { capabilities, timezone })\n\t\tif (!parsed.ok) {\n\t\t\treturn errorResponse(400, parsed.error)\n\t\t}\n\t\tconst goalSlugs = await goalSlugsFor({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope: context.scope === PLATFORM_SCOPE ? null : context.scope,\n\t\t\tmetrics: parsed.value.query.metrics,\n\t\t\tdimensions: parsed.value.query.dimensions,\n\t\t})\n\t\tconst query: AnalyticsQuery = {\n\t\t\t...parsed.value.query,\n\t\t\t...(queryScope.queryScope === undefined ? {} : { scope: queryScope.queryScope }),\n\t\t\t...(goalSlugs === undefined ? {} : { goalSlugs }),\n\t\t}\n\t\tlet comparisonRange: DateRange | null = null\n\t\tif (parsed.value.compare === 'previous') {\n\t\t\tcomparisonRange = previousWindow(query.dateRange, query.timezone)\n\t\t\tif (!comparisonRange) {\n\t\t\t\treturn errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tqueryError(\n\t\t\t\t\t\t'invalid_param',\n\t\t\t\t\t\t'analytics: the range is too long to compare against a previous period',\n\t\t\t\t\t\t'compare'\n\t\t\t\t\t)\n\t\t\t\t)\n\t\t\t}\n\t\t\t// The view decides this same predicate on the browser clock, so a client near the\n\t\t\t// floor or with a skewed clock must lose only its delta, never the whole read.\n\t\t\tif (\n\t\t\t\t!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, {\n\t\t\t\t\ttz: query.timezone,\n\t\t\t\t})\n\t\t\t) {\n\t\t\t\tcomparisonRange = null\n\t\t\t}\n\t\t}\n\t\tlet result: AnalyticsResult\n\t\tlet comparison: AnalyticsResult | undefined\n\t\ttry {\n\t\t\t;[result, comparison] = await Promise.all([\n\t\t\t\truntime.engine.read(adapter, query),\n\t\t\t\tcomparisonRange\n\t\t\t\t\t? runtime.engine.read(adapter, { ...query, dateRange: comparisonRange })\n\t\t\t\t\t: undefined,\n\t\t\t])\n\t\t} catch (err) {\n\t\t\t// Neither a fresh nor a stale entry survived the read: the source is down, not the\n\t\t\t// request wrong, so the client is told to retry rather than to change anything.\n\t\t\treq.payload.logger?.warn(\n\t\t\t\t`analytics: query read failed for adapter \"${adapter.id}\": ${String(err)}`\n\t\t\t)\n\t\t\treturn errorResponse(\n\t\t\t\t503,\n\t\t\t\tqueryError('unavailable', 'analytics: source is temporarily unavailable'),\n\t\t\t\tRETRY_AFTER\n\t\t\t)\n\t\t}\n\t\tconst body: QueryResponse = {\n\t\t\tresult,\n\t\t\t...(comparison ? { comparison } : {}),\n\t\t\tsource: {\n\t\t\t\tid: adapter.id,\n\t\t\t\tlabel: adapter.label,\n\t\t\t\tkind: runtime.configAdapterIds.has(adapter.id) ? 'config' : 'runtime',\n\t\t\t},\n\t\t\tcapabilities,\n\t\t\tquery: serializeQuery(query),\n\t\t}\n\t\treturn Response.json(body, { headers: NO_STORE })\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: query failed for adapter \"${adapterId}\": ${String(err)}`)\n\t\treturn errorResponse(500, queryError('internal', 'analytics: query failed'))\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"queryEndpoint.js","names":[],"sources":["../../src/plugin/queryEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { serializeCapabilities } from '../core/capabilities'\nimport { currentDate } from '../core/clock'\nimport type { AnalyticsQuery, AnalyticsResult, DateRange } from '../core/contract'\nimport { aliasMetrics, askedResult, servedQuery } from '../core/metricAliases'\nimport { resolveQueryScope, resolveRequestedScope } from '../core/scopedRead'\nimport { describeWithCauses } from '../core/sourceErrors'\nimport { revenueCurrencyOf } from '../goals/currency'\nimport { parseQueryParams, readParam } from '../query/parse'\nimport type { QueryResponse, SerializedAnalyticsQuery } from '../query/response'\nimport type { ReadOptions } from '../surfacing/engine'\nimport { previousWindow, withinLookback } from '../timeframe/comparison'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\tnotAvailableResponse,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport { goalHintFor } from './goalHint'\nimport { itemRefsOf, resolveItemLabels } from './itemLabels'\nimport { queryParams } from './queryParams'\nimport { resolveSourcesForRequest } from './readContextForRequest'\nimport { readFailureResponse } from './readFailure'\nimport {\n\tgetRuntime,\n\tresolvableScope,\n\tresolveCurrencyFor,\n\tresolveTimezoneFor,\n\tscopeGates,\n} from './runtime'\n\n/**\n * The query as the response echoes it, the range as ISO strings. `goalSlugs` rides along: the\n * scope's slugs, `[]` for no goals, or `'unresolved'` when the resolver failed.\n */\nexport const serializeQuery = (query: AnalyticsQuery): SerializedAnalyticsQuery => ({\n\t...query,\n\tdateRange: {\n\t\tstart: query.dateRange.start.toISOString(),\n\t\tend: query.dateRange.end.toISOString(),\n\t},\n})\n\nconst noSourceResponse = (): Response =>\n\terrorResponse(\n\t\t404,\n\t\tanalyticsError('unknown_source', 'analytics: no source is available for this request')\n\t)\n\n/**\n * Authenticated GET over the surfacing engine, gated in order (auth, `access.read`, scope, source,\n * capabilities) so no answer leaks past the caller's entitlement. Upstream error text never leaks.\n */\nexport const makeQueryHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn unauthorizedResponse()\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn notAvailableResponse()\n\t}\n\tlet adapterId = 'unresolved'\n\ttry {\n\t\tif (!(await readGate(runtime, req))) {\n\t\t\treturn readDeniedResponse()\n\t\t}\n\t\tconst params = queryParams(req)\n\t\tconst gates = scopeGates(runtime, req)\n\t\tconst requested = await resolveRequestedScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\traw: params.get('scope'),\n\t\t\tgates,\n\t\t})\n\t\tif (!requested.ok) {\n\t\t\t// A request whose own scope will not resolve answers like a scope with no sources.\n\t\t\t// A scope the caller named, or one its user does not belong to, is refused as such.\n\t\t\treturn requested.reason === 'named' || requested.reason === 'not-member'\n\t\t\t\t? untrustedScopeResponse('scope')\n\t\t\t\t: noSourceResponse()\n\t\t}\n\t\tconst context = await resolveSourcesForRequest(req, { gates, scope: requested.gated })\n\t\tif (context.adapters.size === 0) {\n\t\t\treturn noSourceResponse()\n\t\t}\n\t\tconst requestedSource = readParam(params, 'source')\n\t\tconst adapter = context.adapters.get(requestedSource ?? context.defaultId ?? '')\n\t\tif (!adapter) {\n\t\t\treturn errorResponse(\n\t\t\t\t404,\n\t\t\t\tanalyticsError('unknown_source', 'analytics: unknown source', 'source')\n\t\t\t)\n\t\t}\n\t\tadapterId = adapter.id\n\t\tconst queryScope = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope: context.scope,\n\t\t\tadapter,\n\t\t\tgates,\n\t\t})\n\t\tif (!queryScope.ok) {\n\t\t\treturn errorResponse(\n\t\t\t\t403,\n\t\t\t\tanalyticsError(\n\t\t\t\t\t'forbidden',\n\t\t\t\t\t'analytics: this source cannot be read for your scope',\n\t\t\t\t\t'source'\n\t\t\t\t)\n\t\t\t)\n\t\t}\n\t\tconst capabilities = serializeCapabilities(adapter.capabilities)\n\t\tconst ownScope = resolvableScope(context.scope)\n\t\tconst timezone = await resolveTimezoneFor(runtime, req, ownScope)\n\t\tconst parsed = parseQueryParams(params, { capabilities, timezone })\n\t\tif (!parsed.ok) {\n\t\t\treturn errorResponse(400, parsed.error)\n\t\t}\n\t\tconst hint = await goalHintFor({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope: ownScope,\n\t\t\tmetrics: parsed.value.query.metrics,\n\t\t\tdimensions: parsed.value.query.dimensions,\n\t\t})\n\t\tconst query: AnalyticsQuery = {\n\t\t\t...parsed.value.query,\n\t\t\t...(queryScope.queryScope === undefined ? {} : { scope: queryScope.queryScope }),\n\t\t\t...(hint === undefined ? {} : { goalSlugs: hint.slugs }),\n\t\t}\n\t\tlet comparisonRange: DateRange | null = null\n\t\tif (parsed.value.compare === 'previous') {\n\t\t\tcomparisonRange = previousWindow(query.dateRange, query.timezone)\n\t\t\tif (!comparisonRange) {\n\t\t\t\treturn errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tanalyticsError(\n\t\t\t\t\t\t'invalid_param',\n\t\t\t\t\t\t'analytics: the range is too long to compare against a previous period',\n\t\t\t\t\t\t'compare'\n\t\t\t\t\t)\n\t\t\t\t)\n\t\t\t}\n\t\t\t// The view decides this same predicate on the browser clock, so a client near the\n\t\t\t// floor or with a skewed clock must lose only its delta, never the whole read.\n\t\t\tif (\n\t\t\t\t!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, {\n\t\t\t\t\ttz: query.timezone,\n\t\t\t\t\tnow: currentDate(),\n\t\t\t\t})\n\t\t\t) {\n\t\t\t\tcomparisonRange = null\n\t\t\t}\n\t\t}\n\t\t// The view names the preset its days came from, so the engine can store the read for the warm\n\t\t// task when those days are the preset's today; any other window stores nothing.\n\t\tconst readOptions: ReadOptions = {\n\t\t\twhenBusy: 'refuse',\n\t\t\tpriority: 'interactive',\n\t\t\t...(parsed.value.timeframe === null ? {} : { timeframe: parsed.value.timeframe }),\n\t\t}\n\t\t// Read under the source's own names and answered under the caller's: `visits` from native.\n\t\tconst aliased = aliasMetrics(query.metrics, adapter.capabilities.metrics)\n\t\tconst served = servedQuery(query, aliased)\n\t\tlet result: AnalyticsResult\n\t\tlet comparison: AnalyticsResult | undefined\n\t\ttry {\n\t\t\tconst [read, previous] = await Promise.all([\n\t\t\t\truntime.engine.read(adapter, served, readOptions),\n\t\t\t\tcomparisonRange\n\t\t\t\t\t? runtime.engine.read(adapter, { ...served, dateRange: comparisonRange }, readOptions)\n\t\t\t\t\t: undefined,\n\t\t\t])\n\t\t\tresult = askedResult(read, aliased)\n\t\t\tcomparison = previous && askedResult(previous, aliased)\n\t\t} catch (err) {\n\t\t\treq.payload.logger?.warn(\n\t\t\t\t`analytics: query read failed for adapter \"${adapter.id}\": ${describeWithCauses(err)}`\n\t\t\t)\n\t\t\treturn readFailureResponse(err)\n\t\t}\n\t\t// A shallow copy, since the cached entry is shared between requests and reporting currency\n\t\t// resolves per scope. A source naming its own revenue currency keeps it.\n\t\tconst reporting = revenueCurrencyOf(\n\t\t\tquery.filters,\n\t\t\tawait resolveCurrencyFor(runtime, req, ownScope)\n\t\t)\n\t\tconst withCurrency = (read: AnalyticsResult): AnalyticsResult =>\n\t\t\treporting && read.meta.currency === undefined\n\t\t\t\t? { ...read, meta: { ...read.meta, currency: reporting } }\n\t\t\t\t: read\n\t\tconst currency = result.meta.currency ?? reporting\n\t\t// Resolved per request rather than cached with the read: a title is whatever this reader\n\t\t// may see of the document, and the cached rows are shared by every reader of the scope.\n\t\tconst refs = itemRefsOf(query, [result, comparison])\n\t\tconst itemLabels = refs.length > 0 ? await resolveItemLabels(req, refs) : undefined\n\t\tconst body: QueryResponse = {\n\t\t\tresult: withCurrency(result),\n\t\t\t...(comparison ? { comparison: withCurrency(comparison) } : {}),\n\t\t\t...(currency ? { currency } : {}),\n\t\t\tsource: {\n\t\t\t\tid: adapter.id,\n\t\t\t\tlabel: context.sources.find((source) => source.id === adapter.id)?.label ?? adapter.label,\n\t\t\t\tkind: runtime.configAdapterIds.has(adapter.id) ? 'config' : 'runtime',\n\t\t\t},\n\t\t\tcapabilities,\n\t\t\tquery: serializeQuery(query),\n\t\t\t...(hint && hint.builtin.length > 0 ? { builtinGoalSlugs: hint.builtin } : {}),\n\t\t\t...(itemLabels ? { itemLabels } : {}),\n\t\t}\n\t\treturn Response.json(body, { headers: NO_STORE })\n\t} catch (err) {\n\t\treq.payload.logger?.error(`analytics: query failed for adapter \"${adapterId}\": ${String(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: query failed'))\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ //#region src/plugin/queryParams.ts
2
+ /** A request's query parameters, read off `req.url`; a request without one has none. */
3
+ const queryParams = (req) => new URL(req.url ?? "", "http://localhost").searchParams;
4
+ //#endregion
5
+ export { queryParams };
6
+
7
+ //# sourceMappingURL=queryParams.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queryParams.js","names":[],"sources":["../../src/plugin/queryParams.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\n/** A request's query parameters, read off `req.url`; a request without one has none. */\nexport const queryParams = (req: Pick<PayloadRequest, 'url'>): URLSearchParams =>\n\tnew URL(req.url ?? '', 'http://localhost').searchParams\n"],"mappings":";;AAGA,MAAa,eAAe,QAC3B,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE"}
@@ -0,0 +1,11 @@
1
+ import { PayloadRequest } from "payload";
2
+
3
+ //#region src/plugin/readContextForRequest.d.ts
4
+ /**
5
+ * What a listing tells its reader about itself: `platformFallback` when a shared source is listed
6
+ * only because the scope has no source of its own yet (`sources.<id>.tenants: 'fallback'`).
7
+ */
8
+ type SourcesNotice = 'platformFallback';
9
+ //#endregion
10
+ export { SourcesNotice };
11
+ //# sourceMappingURL=readContextForRequest.d.ts.map
@@ -1,5 +1,8 @@
1
- import "../core/contract.js";
2
- import { getRuntime, platformReadGate, resolveRegistryFor, resolveScopeFor } from "./runtime.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import { isGatedScope } from "../access/principal.js";
3
+ import { getRuntime, resolvableScope, resolveRegistryFor, scopeGates } from "./runtime.js";
4
+ import { sourceRefFor } from "../core/sourceLabel.js";
5
+ import { needsUnscopedSourceAccess, resolveRequestedScope, visibleSourcesFor } from "../core/scopedRead.js";
3
6
  import { serializeCapabilities } from "../core/capabilities.js";
4
7
  //#region src/plugin/readContextForRequest.ts
5
8
  const empty = () => ({
@@ -8,61 +11,105 @@ const empty = () => ({
8
11
  adapters: /* @__PURE__ */ new Map(),
9
12
  scope: null
10
13
  });
11
- const fromRegistry = (args) => {
12
- const { runtime, registry, scope } = args;
14
+ const fromRegistry = async (args) => {
15
+ const { runtime, req, registry, scope } = args;
13
16
  const adapters = registry.all();
14
17
  return {
15
- sources: adapters.map((adapter) => ({
16
- id: adapter.id,
17
- label: adapter.label,
18
- kind: runtime.configAdapterIds.has(adapter.id) ? "config" : "runtime",
18
+ sources: await Promise.all(adapters.map(async (adapter) => ({
19
+ ...await sourceRefFor(adapter, {
20
+ req,
21
+ scope,
22
+ configIds: runtime.configAdapterIds
23
+ }),
19
24
  capabilities: serializeCapabilities(adapter.capabilities)
20
- })),
25
+ }))),
21
26
  defaultId: registry.default().id,
22
27
  adapters: new Map(adapters.map((adapter) => [adapter.id, adapter])),
23
28
  scope
24
29
  };
25
30
  };
26
31
  /**
27
- * The sources a request may read, resolved once for both read endpoints: the request's
28
- * own scope (or a trusted explicit one), the per-scope registry, and each adapter's
29
- * serialized capabilities. Two resolutions are cross-scope and fail closed behind
30
- * `platformRead`: a scopeResolver answering the `'*'` marker, and, on a scoped install, one
31
- * answering no scope at all, which is ambiguous rather than install-wide (returning null
32
- * usually means "no tenant selected"). A failed resolution resolves nothing too, since it is
33
- * indistinguishable from a forged one. An unscoped install falls back to the static config
34
- * registry on failure.
32
+ * Sources that can answer about one scope. Under a tenant scope a shared adapter unable to narrow
33
+ * would report every tenant's numbers, so it is dropped however privileged the reader.
34
+ */
35
+ const narrowToScope = (runtime, resolved) => {
36
+ const scope = resolved.scope;
37
+ if (scope === null) return resolved;
38
+ const narrowable = resolved.sources.filter((source) => {
39
+ const adapter = resolved.adapters.get(source.id);
40
+ return adapter !== void 0 && !needsUnscopedSourceAccess(runtime, adapter, scope);
41
+ });
42
+ if (narrowable.length === resolved.sources.length) return resolved;
43
+ const kept = new Set(narrowable.map((source) => source.id));
44
+ return {
45
+ sources: narrowable,
46
+ defaultId: resolved.defaultId !== null && kept.has(resolved.defaultId) ? resolved.defaultId : narrowable[0]?.id ?? null,
47
+ adapters: new Map([...resolved.adapters].filter(([id]) => kept.has(id))),
48
+ scope
49
+ };
50
+ };
51
+ /**
52
+ * Sources a request may read, shared by every listing surface. A denied, cross-scope or non-member
53
+ * read lists nothing; a failed resolution lists nothing when scoped, else the config registry.
35
54
  */
36
55
  const resolveSourcesForRequest = async (req, args = {}) => {
37
56
  const runtime = getRuntime(req.payload);
38
57
  if (!runtime) return empty();
39
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
58
+ try {
59
+ if (!await readGate(runtime, req)) return empty();
60
+ } catch (err) {
61
+ req.payload.logger?.warn(`analytics: access.read failed, listing no sources: ${String(err)}`);
62
+ return empty();
63
+ }
64
+ const gates = args.gates ?? scopeGates(runtime, req);
65
+ const degrade = async () => runtime.scoped ? empty() : fromRegistry({
66
+ runtime,
67
+ req,
68
+ registry: runtime.registry,
69
+ scope: null
70
+ });
40
71
  try {
41
72
  let scope;
42
73
  if (args.scope !== void 0) {
43
- if (!await allowed()) return empty();
44
- scope = args.scope;
74
+ if (!isGatedScope(args.scope)) return empty();
75
+ scope = args.scope.value;
45
76
  } else {
46
- scope = await resolveScopeFor(runtime, req);
47
- if ((scope === "*" || runtime.scoped && scope === null) && !await allowed()) return empty();
77
+ const requested = await resolveRequestedScope({
78
+ runtime,
79
+ req,
80
+ gates
81
+ });
82
+ if (!requested.ok) return requested.reason === "failed" ? degrade() : empty();
83
+ scope = requested.scope;
48
84
  }
49
- return fromRegistry({
85
+ const { registry, fallbackAdmitted } = await visibleSourcesFor({
50
86
  runtime,
51
- registry: await resolveRegistryFor(runtime, {
87
+ req,
88
+ resolved: await resolveRegistryFor(runtime, {
52
89
  payload: req.payload,
53
90
  req,
54
- scope: scope === "*" ? null : scope
91
+ scope: resolvableScope(scope)
55
92
  }),
56
- scope
93
+ scope,
94
+ gates
57
95
  });
96
+ if (!registry) return {
97
+ ...empty(),
98
+ scope
99
+ };
100
+ const listed = narrowToScope(runtime, await fromRegistry({
101
+ runtime,
102
+ req,
103
+ registry,
104
+ scope
105
+ }));
106
+ return listed.sources.some((source) => fallbackAdmitted.has(source.id)) ? {
107
+ ...listed,
108
+ notice: "platformFallback"
109
+ } : listed;
58
110
  } catch (err) {
59
111
  req.payload.logger?.warn(`analytics: source resolution failed: ${String(err)}`);
60
- if (runtime.scoped) return empty();
61
- return fromRegistry({
62
- runtime,
63
- registry: runtime.registry,
64
- scope: null
65
- });
112
+ return degrade();
66
113
  }
67
114
  };
68
115
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"readContextForRequest.js","names":[],"sources":["../../src/plugin/readContextForRequest.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type SerializedCapabilities, serializeCapabilities } from '../core/capabilities'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from '../core/contract'\nimport type { AdapterRegistry } from '../core/registry'\nimport type { QuerySourceRef } from '../query/response'\nimport {\n\ttype AnalyticsRuntime,\n\tgetRuntime,\n\ttype PlatformReadGate,\n\tplatformReadGate,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n} from './runtime'\n\n/** One readable source on the wire: its identity plus the capabilities a client gates on. */\nexport interface RequestSource extends QuerySourceRef {\n\tcapabilities: SerializedCapabilities\n}\n\nexport interface RequestSources {\n\t/** Wire rows for the resolved scope, in registry order; empty when none resolve. */\n\tsources: RequestSource[]\n\tdefaultId: string | null\n\t/** The adapters behind `sources`, for callers that read through them. */\n\tadapters: ReadonlyMap<string, AnalyticsAdapter>\n\t/** Scope the sources were resolved for; null is install-wide, `*` is cross-scope. */\n\tscope: string | null\n}\n\nexport interface ResolveSourcesArgs {\n\t/**\n\t * Read another scope's sources instead of the request's own. Evaluated behind\n\t * `access.platformRead`; a denied override resolves nothing at all.\n\t */\n\tscope?: string | null\n\t/** Shared `platformRead` decision; one is created per call when omitted. */\n\tplatformRead?: PlatformReadGate\n}\n\nconst empty = (): RequestSources => ({\n\tsources: [],\n\tdefaultId: null,\n\tadapters: new Map(),\n\tscope: null,\n})\n\nconst fromRegistry = (args: {\n\truntime: AnalyticsRuntime\n\tregistry: AdapterRegistry\n\tscope: string | null\n}): RequestSources => {\n\tconst { runtime, registry, scope } = args\n\tconst adapters = registry.all()\n\treturn {\n\t\tsources: adapters.map((adapter) => ({\n\t\t\tid: adapter.id,\n\t\t\tlabel: adapter.label,\n\t\t\tkind: runtime.configAdapterIds.has(adapter.id) ? ('config' as const) : ('runtime' as const),\n\t\t\tcapabilities: serializeCapabilities(adapter.capabilities),\n\t\t})),\n\t\tdefaultId: registry.default().id,\n\t\tadapters: new Map(adapters.map((adapter) => [adapter.id, adapter])),\n\t\tscope,\n\t}\n}\n\n/**\n * The sources a request may read, resolved once for both read endpoints: the request's\n * own scope (or a trusted explicit one), the per-scope registry, and each adapter's\n * serialized capabilities. Two resolutions are cross-scope and fail closed behind\n * `platformRead`: a scopeResolver answering the `'*'` marker, and, on a scoped install, one\n * answering no scope at all, which is ambiguous rather than install-wide (returning null\n * usually means \"no tenant selected\"). A failed resolution resolves nothing too, since it is\n * indistinguishable from a forged one. An unscoped install falls back to the static config\n * registry on failure.\n */\nexport const resolveSourcesForRequest = async (\n\treq: PayloadRequest,\n\targs: ResolveSourcesArgs = {}\n): Promise<RequestSources> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn empty()\n\t}\n\tconst allowed = args.platformRead ?? platformReadGate(runtime, req)\n\ttry {\n\t\tlet scope: string | null\n\t\tif (args.scope !== undefined) {\n\t\t\tif (!(await allowed())) {\n\t\t\t\treturn empty()\n\t\t\t}\n\t\t\tscope = args.scope\n\t\t} else {\n\t\t\tscope = await resolveScopeFor(runtime, req)\n\t\t\tconst crossScope = scope === PLATFORM_SCOPE || (runtime.scoped && scope === null)\n\t\t\tif (crossScope && !(await allowed())) {\n\t\t\t\treturn empty()\n\t\t\t}\n\t\t}\n\t\tconst registry = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: scope === PLATFORM_SCOPE ? null : scope,\n\t\t})\n\t\treturn fromRegistry({ runtime, registry, scope })\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: source resolution failed: ${String(err)}`)\n\t\tif (runtime.scoped) {\n\t\t\treturn empty()\n\t\t}\n\t\treturn fromRegistry({ runtime, registry: runtime.registry, scope: null })\n\t}\n}\n"],"mappings":";;;;AAuCA,MAAM,eAA+B;CACpC,SAAS,CAAC;CACV,WAAW;CACX,0BAAU,IAAI,IAAI;CAClB,OAAO;AACR;AAEA,MAAM,gBAAgB,SAIA;CACrB,MAAM,EAAE,SAAS,UAAU,UAAU;CACrC,MAAM,WAAW,SAAS,IAAI;CAC9B,OAAO;EACN,SAAS,SAAS,KAAK,aAAa;GACnC,IAAI,QAAQ;GACZ,OAAO,QAAQ;GACf,MAAM,QAAQ,iBAAiB,IAAI,QAAQ,EAAE,IAAK,WAAsB;GACxE,cAAc,sBAAsB,QAAQ,YAAY;EACzD,EAAE;EACF,WAAW,SAAS,QAAQ,EAAE;EAC9B,UAAU,IAAI,IAAI,SAAS,KAAK,YAAY,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;EAClE;CACD;AACD;;;;;;;;;;;AAYA,MAAa,2BAA2B,OACvC,KACA,OAA2B,CAAC,MACC;CAC7B,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,MAAM;CAEd,MAAM,UAAU,KAAK,gBAAgB,iBAAiB,SAAS,GAAG;CAClE,IAAI;EACH,IAAI;EACJ,IAAI,KAAK,UAAU,KAAA,GAAW;GAC7B,IAAI,CAAE,MAAM,QAAQ,GACnB,OAAO,MAAM;GAEd,QAAQ,KAAK;EACd,OAAO;GACN,QAAQ,MAAM,gBAAgB,SAAS,GAAG;GAE1C,KADmB,UAAA,OAA6B,QAAQ,UAAU,UAAU,SAC1D,CAAE,MAAM,QAAQ,GACjC,OAAO,MAAM;EAEf;EAMA,OAAO,aAAa;GAAE;GAAS,UAAA,MALR,mBAAmB,SAAS;IAClD,SAAS,IAAI;IACb;IACA,OAAO,UAAA,MAA2B,OAAO;GAC1C,CAAC;GACwC;EAAM,CAAC;CACjD,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,wCAAwC,OAAO,GAAG,GAAG;EAC9E,IAAI,QAAQ,QACX,OAAO,MAAM;EAEd,OAAO,aAAa;GAAE;GAAS,UAAU,QAAQ;GAAU,OAAO;EAAK,CAAC;CACzE;AACD"}
1
+ {"version":3,"file":"readContextForRequest.js","names":[],"sources":["../../src/plugin/readContextForRequest.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { type GatedScope, isGatedScope } from '../access/principal'\nimport { readGate } from '../access/readGate'\nimport { type SerializedCapabilities, serializeCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter } from '../core/contract'\nimport type { AdapterRegistry } from '../core/registry'\nimport {\n\tneedsUnscopedSourceAccess,\n\tresolveRequestedScope,\n\tvisibleSourcesFor,\n} from '../core/scopedRead'\nimport { sourceRefFor } from '../core/sourceLabel'\nimport type { QuerySourceRef } from '../query/response'\nimport {\n\ttype AnalyticsRuntime,\n\tgetRuntime,\n\tresolvableScope,\n\tresolveRegistryFor,\n\ttype ScopeGates,\n\tscopeGates,\n} from './runtime'\n\n/** One readable source on the wire: its identity plus the capabilities a client gates on. */\nexport interface RequestSource extends QuerySourceRef {\n\tcapabilities: SerializedCapabilities\n}\n\n/**\n * What a listing tells its reader about itself: `platformFallback` when a shared source is listed\n * only because the scope has no source of its own yet (`sources.<id>.tenants: 'fallback'`).\n */\nexport type SourcesNotice = 'platformFallback'\n\ninterface RequestSources {\n\t/** Wire rows for the resolved scope, in registry order; empty when none resolve. */\n\tsources: RequestSource[]\n\tdefaultId: string | null\n\tnotice?: SourcesNotice\n\t/** The adapters behind `sources`, for callers that read through them. */\n\tadapters: ReadonlyMap<string, AnalyticsAdapter>\n\t/** Scope the sources were resolved for; null is install-wide, `*` is cross-scope. */\n\tscope: string | null\n}\n\ninterface ResolveSourcesArgs {\n\t/**\n\t * A scope {@link resolveRequestedScope} already cleared for this request, which replaces this\n\t * call's own resolution. Only that helper mints one.\n\t */\n\tscope?: GatedScope\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\nconst empty = (): RequestSources => ({\n\tsources: [],\n\tdefaultId: null,\n\tadapters: new Map(),\n\tscope: null,\n})\n\nconst fromRegistry = async (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tregistry: AdapterRegistry\n\tscope: string | null\n}): Promise<RequestSources> => {\n\tconst { runtime, req, registry, scope } = args\n\tconst adapters = registry.all()\n\treturn {\n\t\tsources: await Promise.all(\n\t\t\tadapters.map(async (adapter) => ({\n\t\t\t\t...(await sourceRefFor(adapter, { req, scope, configIds: runtime.configAdapterIds })),\n\t\t\t\tcapabilities: serializeCapabilities(adapter.capabilities),\n\t\t\t}))\n\t\t),\n\t\tdefaultId: registry.default().id,\n\t\tadapters: new Map(adapters.map((adapter) => [adapter.id, adapter])),\n\t\tscope,\n\t}\n}\n\n/**\n * Sources that can answer about one scope. Under a tenant scope a shared adapter unable to narrow\n * would report every tenant's numbers, so it is dropped however privileged the reader.\n */\nconst narrowToScope = (runtime: AnalyticsRuntime, resolved: RequestSources): RequestSources => {\n\tconst scope = resolved.scope\n\tif (scope === null) {\n\t\treturn resolved\n\t}\n\tconst narrowable = resolved.sources.filter((source) => {\n\t\tconst adapter = resolved.adapters.get(source.id)\n\t\treturn adapter !== undefined && !needsUnscopedSourceAccess(runtime, adapter, scope)\n\t})\n\tif (narrowable.length === resolved.sources.length) {\n\t\treturn resolved\n\t}\n\tconst kept = new Set(narrowable.map((source) => source.id))\n\treturn {\n\t\tsources: narrowable,\n\t\tdefaultId:\n\t\t\tresolved.defaultId !== null && kept.has(resolved.defaultId)\n\t\t\t\t? resolved.defaultId\n\t\t\t\t: (narrowable[0]?.id ?? null),\n\t\tadapters: new Map([...resolved.adapters].filter(([id]) => kept.has(id))),\n\t\tscope,\n\t}\n}\n\n/**\n * Sources a request may read, shared by every listing surface. A denied, cross-scope or non-member\n * read lists nothing; a failed resolution lists nothing when scoped, else the config registry.\n */\nexport const resolveSourcesForRequest = async (\n\treq: PayloadRequest,\n\targs: ResolveSourcesArgs = {}\n): Promise<RequestSources> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn empty()\n\t}\n\ttry {\n\t\tif (!(await readGate(runtime, req))) {\n\t\t\treturn empty()\n\t\t}\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: access.read failed, listing no sources: ${String(err)}`)\n\t\treturn empty()\n\t}\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tconst degrade = async (): Promise<RequestSources> =>\n\t\truntime.scoped\n\t\t\t? empty()\n\t\t\t: fromRegistry({ runtime, req, registry: runtime.registry, scope: null })\n\ttry {\n\t\tlet scope: string | null\n\t\tif (args.scope !== undefined) {\n\t\t\tif (!isGatedScope(args.scope)) {\n\t\t\t\treturn empty()\n\t\t\t}\n\t\t\tscope = args.scope.value\n\t\t} else {\n\t\t\tconst requested = await resolveRequestedScope({ runtime, req, gates })\n\t\t\tif (!requested.ok) {\n\t\t\t\treturn requested.reason === 'failed' ? degrade() : empty()\n\t\t\t}\n\t\t\tscope = requested.scope\n\t\t}\n\t\tconst resolved = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: resolvableScope(scope),\n\t\t})\n\t\tconst { registry, fallbackAdmitted } = await visibleSourcesFor({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tresolved,\n\t\t\tscope,\n\t\t\tgates,\n\t\t})\n\t\tif (!registry) {\n\t\t\treturn { ...empty(), scope }\n\t\t}\n\t\tconst listed = narrowToScope(runtime, await fromRegistry({ runtime, req, registry, scope }))\n\t\treturn listed.sources.some((source) => fallbackAdmitted.has(source.id))\n\t\t\t? { ...listed, notice: 'platformFallback' }\n\t\t\t: listed\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: source resolution failed: ${String(err)}`)\n\t\treturn degrade()\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import { analyticsError, errorResponse, retryAfter } from "./errors.js";
2
+ import { classifyError } from "../surfacing/classifyError.js";
3
+ //#region src/plugin/readFailure.ts
4
+ /** What the endpoint says for a source whose host the install does not allow. */
5
+ const HOST_REFUSED_MESSAGE = "analytics: this source's host is not one the install allows; list it in providers.hosts.allow, or set providers.hosts.allowPrivateNetwork for a private or http address";
6
+ /**
7
+ * Answer for a failed read with nothing cached to serve. A misconfigured source (502) omits
8
+ * `Retry-After` since waiting will not fix it; upstream error text never reaches the answer.
9
+ */
10
+ const readFailureResponse = (err) => {
11
+ const failure = classifyError(err);
12
+ switch (failure.kind) {
13
+ case "invalid_param": return errorResponse(400, analyticsError("invalid_param", failure.message ?? "analytics: the source refused this query as asked", failure.param ?? "query"));
14
+ case "source_misconfigured": return errorResponse(502, failure.hostRefused ? analyticsError("source_misconfigured", HOST_REFUSED_MESSAGE, "host") : analyticsError("source_misconfigured", "analytics: this source is not set up correctly; check its settings", "source"));
15
+ case "rate_limited": return errorResponse(429, analyticsError("rate_limited", "analytics: too many reads are waiting on their sources for this scope; retry shortly"), retryAfter(failure.retryAfterMs));
16
+ case "unavailable": return errorResponse(503, analyticsError("unavailable", "analytics: source is temporarily unavailable"), retryAfter(failure.retryAfterMs));
17
+ }
18
+ };
19
+ //#endregion
20
+ export { readFailureResponse };
21
+
22
+ //# sourceMappingURL=readFailure.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readFailure.js","names":[],"sources":["../../src/plugin/readFailure.ts"],"sourcesContent":["import { classifyError } from '../surfacing/classifyError'\nimport { analyticsError, errorResponse, retryAfter } from './errors'\n\n/** What the endpoint says for a source whose host the install does not allow. */\nexport const HOST_REFUSED_MESSAGE =\n\t\"analytics: this source's host is not one the install allows; list it in providers.hosts.allow, or set providers.hosts.allowPrivateNetwork for a private or http address\"\n\n/**\n * Answer for a failed read with nothing cached to serve. A misconfigured source (502) omits\n * `Retry-After` since waiting will not fix it; upstream error text never reaches the answer.\n */\nexport const readFailureResponse = (err: unknown): Response => {\n\tconst failure = classifyError(err)\n\tswitch (failure.kind) {\n\t\tcase 'invalid_param':\n\t\t\treturn errorResponse(\n\t\t\t\t400,\n\t\t\t\tanalyticsError(\n\t\t\t\t\t'invalid_param',\n\t\t\t\t\tfailure.message ?? 'analytics: the source refused this query as asked',\n\t\t\t\t\tfailure.param ?? 'query'\n\t\t\t\t)\n\t\t\t)\n\t\tcase 'source_misconfigured':\n\t\t\treturn errorResponse(\n\t\t\t\t502,\n\t\t\t\tfailure.hostRefused\n\t\t\t\t\t? analyticsError('source_misconfigured', HOST_REFUSED_MESSAGE, 'host')\n\t\t\t\t\t: analyticsError(\n\t\t\t\t\t\t\t'source_misconfigured',\n\t\t\t\t\t\t\t'analytics: this source is not set up correctly; check its settings',\n\t\t\t\t\t\t\t'source'\n\t\t\t\t\t\t)\n\t\t\t)\n\t\tcase 'rate_limited':\n\t\t\treturn errorResponse(\n\t\t\t\t429,\n\t\t\t\tanalyticsError(\n\t\t\t\t\t'rate_limited',\n\t\t\t\t\t'analytics: too many reads are waiting on their sources for this scope; retry shortly'\n\t\t\t\t),\n\t\t\t\tretryAfter(failure.retryAfterMs)\n\t\t\t)\n\t\tcase 'unavailable':\n\t\t\treturn errorResponse(\n\t\t\t\t503,\n\t\t\t\tanalyticsError('unavailable', 'analytics: source is temporarily unavailable'),\n\t\t\t\tretryAfter(failure.retryAfterMs)\n\t\t\t)\n\t}\n}\n"],"mappings":";;;;AAIA,MAAa,uBACZ;;;;;AAMD,MAAa,uBAAuB,QAA2B;CAC9D,MAAM,UAAU,cAAc,GAAG;CACjC,QAAQ,QAAQ,MAAhB;EACC,KAAK,iBACJ,OAAO,cACN,KACA,eACC,iBACA,QAAQ,WAAW,qDACnB,QAAQ,SAAS,OAClB,CACD;EACD,KAAK,wBACJ,OAAO,cACN,KACA,QAAQ,cACL,eAAe,wBAAwB,sBAAsB,MAAM,IACnE,eACA,wBACA,sEACA,QACD,CACH;EACD,KAAK,gBACJ,OAAO,cACN,KACA,eACC,gBACA,sFACD,GACA,WAAW,QAAQ,YAAY,CAChC;EACD,KAAK,eACJ,OAAO,cACN,KACA,eAAe,eAAe,8CAA8C,GAC5E,WAAW,QAAQ,YAAY,CAChC;CACF;AACD"}
@@ -0,0 +1,67 @@
1
+ import { requestMemo } from "./requestMemo.js";
2
+ import { providerScopeWhere } from "../providers/resolver.js";
3
+ //#region src/plugin/readableProviders.ts
4
+ /** Far above any realistic provider count for one scope, far below a listing worth paging. */
5
+ const MAX_PROVIDER_DOCS = 200;
6
+ /** Per request and user: a dashboard asks once per widget. */
7
+ const readable = requestMemo("readableProviders");
8
+ /**
9
+ * Enabled provider documents of one scope a reader reads through. A set `sourceAccess` decides
10
+ * (false reads none, a `Where` narrows); otherwise the collection's own read access runs.
11
+ */
12
+ const findReadable = async (collection, req, where) => {
13
+ const query = {
14
+ collection: collection.slug,
15
+ limit: MAX_PROVIDER_DOCS,
16
+ pagination: false,
17
+ depth: 0,
18
+ disableErrors: true,
19
+ req
20
+ };
21
+ if (!collection.sourceAccess) {
22
+ const { docs } = await req.payload.find({
23
+ ...query,
24
+ where,
25
+ overrideAccess: false,
26
+ user: req.user
27
+ });
28
+ return docs;
29
+ }
30
+ const verdict = await collection.sourceAccess({
31
+ req,
32
+ slug: collection.slug
33
+ });
34
+ if (verdict === false) return [];
35
+ const { docs } = await req.payload.find({
36
+ ...query,
37
+ where: verdict === true ? where : { and: [where, verdict] },
38
+ overrideAccess: true
39
+ });
40
+ return docs;
41
+ };
42
+ const load = async (collection, req, scope) => {
43
+ try {
44
+ const docs = await findReadable(collection, req, { and: [{ enabled: { equals: true } }, providerScopeWhere(collection.scopeField, scope)] });
45
+ return new Set(docs.map((doc) => String(doc.id)));
46
+ } catch (err) {
47
+ req.payload.logger?.warn(`analytics: readable provider lookup failed, treating the scope as having none: ${String(err)}`);
48
+ return /* @__PURE__ */ new Set();
49
+ }
50
+ };
51
+ /**
52
+ * Ids of a scope's enabled provider documents this user may read, memoized per scope and user. Null
53
+ * when the install has no providers collection, so provider documents decide nothing.
54
+ */
55
+ const readableProviderDocIds = (runtime, req, scope) => {
56
+ const collection = runtime.providersCollection;
57
+ if (!collection) return null;
58
+ return readable(req, {
59
+ owner: runtime,
60
+ key: JSON.stringify(scope),
61
+ compute: () => load(collection, req, scope)
62
+ });
63
+ };
64
+ //#endregion
65
+ export { readableProviderDocIds };
66
+
67
+ //# sourceMappingURL=readableProviders.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readableProviders.js","names":[],"sources":["../../src/plugin/readableProviders.ts"],"sourcesContent":["import type { CollectionSlug, PayloadRequest, Where } from 'payload'\nimport { providerScopeWhere } from '../providers/resolver'\nimport { requestMemo } from './requestMemo'\nimport type { AnalyticsRuntime } from './runtime'\n\n/** Far above any realistic provider count for one scope, far below a listing worth paging. */\nconst MAX_PROVIDER_DOCS = 200\n\n/** Per request and user: a dashboard asks once per widget. */\nconst readable = requestMemo<ReadonlySet<string>>('readableProviders')\n\ntype ProvidersCollection = NonNullable<AnalyticsRuntime['providersCollection']>\n\n/**\n * Enabled provider documents of one scope a reader reads through. A set `sourceAccess` decides\n * (false reads none, a `Where` narrows); otherwise the collection's own read access runs.\n */\nconst findReadable = async (\n\tcollection: ProvidersCollection,\n\treq: PayloadRequest,\n\twhere: Where\n): Promise<Array<{ id: string | number }>> => {\n\tconst query = {\n\t\t// The plugin registered this slug itself; `CollectionSlug` is the host's generated union.\n\t\tcollection: collection.slug as CollectionSlug,\n\t\tlimit: MAX_PROVIDER_DOCS,\n\t\tpagination: false,\n\t\tdepth: 0,\n\t\tdisableErrors: true,\n\t\treq,\n\t}\n\tif (!collection.sourceAccess) {\n\t\tconst { docs } = await req.payload.find({\n\t\t\t...query,\n\t\t\twhere,\n\t\t\toverrideAccess: false,\n\t\t\tuser: req.user,\n\t\t})\n\t\treturn docs\n\t}\n\tconst verdict = await collection.sourceAccess({ req, slug: collection.slug })\n\tif (verdict === false) {\n\t\treturn []\n\t}\n\tconst { docs } = await req.payload.find({\n\t\t...query,\n\t\twhere: verdict === true ? where : { and: [where, verdict] },\n\t\toverrideAccess: true,\n\t})\n\treturn docs\n}\n\nconst load = async (\n\tcollection: ProvidersCollection,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<ReadonlySet<string>> => {\n\ttry {\n\t\tconst docs = await findReadable(collection, req, {\n\t\t\tand: [{ enabled: { equals: true } }, providerScopeWhere(collection.scopeField, scope)],\n\t\t})\n\t\treturn new Set(docs.map((doc) => String(doc.id)))\n\t} catch (err) {\n\t\treq.payload.logger?.warn(\n\t\t\t`analytics: readable provider lookup failed, treating the scope as having none: ${String(err)}`\n\t\t)\n\t\treturn new Set()\n\t}\n}\n\n/**\n * Ids of a scope's enabled provider documents this user may read, memoized per scope and user. Null\n * when the install has no providers collection, so provider documents decide nothing.\n */\nexport const readableProviderDocIds = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<ReadonlySet<string>> | null => {\n\tconst collection = runtime.providersCollection\n\tif (!collection) {\n\t\treturn null\n\t}\n\treturn readable(req, {\n\t\towner: runtime,\n\t\tkey: JSON.stringify(scope),\n\t\tcompute: () => load(collection, req, scope),\n\t})\n}\n"],"mappings":";;;;AAMA,MAAM,oBAAoB;;AAG1B,MAAM,WAAW,YAAiC,mBAAmB;;;;;AAQrE,MAAM,eAAe,OACpB,YACA,KACA,UAC6C;CAC7C,MAAM,QAAQ;EAEb,YAAY,WAAW;EACvB,OAAO;EACP,YAAY;EACZ,OAAO;EACP,eAAe;EACf;CACD;CACA,IAAI,CAAC,WAAW,cAAc;EAC7B,MAAM,EAAE,SAAS,MAAM,IAAI,QAAQ,KAAK;GACvC,GAAG;GACH;GACA,gBAAgB;GAChB,MAAM,IAAI;EACX,CAAC;EACD,OAAO;CACR;CACA,MAAM,UAAU,MAAM,WAAW,aAAa;EAAE;EAAK,MAAM,WAAW;CAAK,CAAC;CAC5E,IAAI,YAAY,OACf,OAAO,CAAC;CAET,MAAM,EAAE,SAAS,MAAM,IAAI,QAAQ,KAAK;EACvC,GAAG;EACH,OAAO,YAAY,OAAO,QAAQ,EAAE,KAAK,CAAC,OAAO,OAAO,EAAE;EAC1D,gBAAgB;CACjB,CAAC;CACD,OAAO;AACR;AAEA,MAAM,OAAO,OACZ,YACA,KACA,UACkC;CAClC,IAAI;EACH,MAAM,OAAO,MAAM,aAAa,YAAY,KAAK,EAChD,KAAK,CAAC,EAAE,SAAS,EAAE,QAAQ,KAAK,EAAE,GAAG,mBAAmB,WAAW,YAAY,KAAK,CAAC,EACtF,CAAC;EACD,OAAO,IAAI,IAAI,KAAK,KAAK,QAAQ,OAAO,IAAI,EAAE,CAAC,CAAC;CACjD,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KACnB,kFAAkF,OAAO,GAAG,GAC7F;EACA,uBAAO,IAAI,IAAI;CAChB;AACD;;;;;AAMA,MAAa,0BACZ,SACA,KACA,UACyC;CACzC,MAAM,aAAa,QAAQ;CAC3B,IAAI,CAAC,YACJ,OAAO;CAER,OAAO,SAAS,KAAK;EACpB,OAAO;EACP,KAAK,KAAK,UAAU,KAAK;EACzB,eAAe,KAAK,YAAY,KAAK,KAAK;CAC3C,CAAC;AACF"}