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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1,19 +1,23 @@
1
- import "./paths.js";
2
- import "../core/contract.js";
3
- import { getRuntime, platformReadGate, readAccessFor, resolveTimezoneFor } from "./runtime.js";
4
- import { NO_STORE, RETRY_AFTER, analyticsError, errorResponse } from "./errors.js";
5
- import { serializeCapabilities } from "../core/capabilities.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";
6
5
  import { resolveQueryScope, resolveRequestedScope } from "../core/scopedRead.js";
7
- import { goalSlugsFor } from "./goalHint.js";
8
- import { previousWindow, withinLookback } from "../widgets/comparison.js";
6
+ import { NO_STORE, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
7
+ import { serializeCapabilities } from "../core/capabilities.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";
9
12
  import { parseQueryParams, readParam } from "../query/parse.js";
13
+ import { queryParams } from "./queryParams.js";
14
+ import { itemRefsOf, resolveItemLabels } from "./itemLabels.js";
10
15
  import { resolveSourcesForRequest } from "./readContextForRequest.js";
16
+ import { readFailureResponse } from "./readFailure.js";
11
17
  //#region src/plugin/queryEndpoint.ts
12
18
  /**
13
- * The query as the response echoes it: the date range's instants as ISO strings, every
14
- * other field as the read carried it. `goalSlugs` rides along unchanged, so a client sees
15
- * the scope's slugs, an empty list for a scope with no goals, or the string `'unresolved'`
16
- * 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.
17
21
  */
18
22
  const serializeQuery = (query) => ({
19
23
  ...query,
@@ -22,38 +26,32 @@ const serializeQuery = (query) => ({
22
26
  end: query.dateRange.end.toISOString()
23
27
  }
24
28
  });
29
+ const noSourceResponse = () => errorResponse(404, analyticsError("unknown_source", "analytics: no source is available for this request"));
25
30
  /**
26
- * Authenticated GET over the surfacing engine: the public read primitive the admin view
27
- * and consumers' own dashboards are built on. Gating runs in a fixed order so a caller
28
- * learns nothing from the answer it is not already entitled to: authentication, then
29
- * `access.read`, then scope and source resolution (shared with the sources endpoint, so a
30
- * tenant can select no source that endpoint does not list), then capability validation of
31
- * every parameter against the selected source. Being listed is not sufficient: a shared
32
- * source that cannot narrow to the caller's scope answers 403 with `param: 'source'`.
33
- * Errors carry a code and the parameter at fault; adapter configuration and upstream error
34
- * 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.
35
33
  */
36
34
  const makeQueryHandler = () => async (req) => {
37
- if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
35
+ if (!req.user) return unauthorizedResponse();
38
36
  const runtime = getRuntime(req.payload);
39
- if (!runtime) return errorResponse(503, analyticsError("unavailable", "analytics: not available"), RETRY_AFTER);
37
+ if (!runtime) return notAvailableResponse();
40
38
  let adapterId = "unresolved";
41
39
  try {
42
- if (!await readAccessFor(runtime, req)) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
43
- const params = new URL(req.url ?? "", "http://localhost").searchParams;
44
- const platformRead = platformReadGate(runtime, req);
40
+ if (!await readGate(runtime, req)) return readDeniedResponse();
41
+ const params = queryParams(req);
42
+ const gates = scopeGates(runtime, req);
45
43
  const requested = await resolveRequestedScope({
46
44
  runtime,
47
45
  req,
48
46
  raw: params.get("scope"),
49
- platformRead
47
+ gates
50
48
  });
51
- if (!requested.ok) return requested.reason === "named" ? errorResponse(400, analyticsError("untrusted_scope", "analytics: scope is not permitted for this request", "scope")) : errorResponse(404, analyticsError("unknown_source", "analytics: no source is available for this request"));
49
+ if (!requested.ok) return requested.reason === "named" || requested.reason === "not-member" ? untrustedScopeResponse("scope") : noSourceResponse();
52
50
  const context = await resolveSourcesForRequest(req, {
53
- platformRead,
54
- scope: requested.scope
51
+ gates,
52
+ scope: requested.gated
55
53
  });
56
- if (context.adapters.size === 0) return errorResponse(404, analyticsError("unknown_source", "analytics: no source is available for this request"));
54
+ if (context.adapters.size === 0) return noSourceResponse();
57
55
  const requestedSource = readParam(params, "source");
58
56
  const adapter = context.adapters.get(requestedSource ?? context.defaultId ?? "");
59
57
  if (!adapter) return errorResponse(404, analyticsError("unknown_source", "analytics: unknown source", "source"));
@@ -63,54 +61,81 @@ const makeQueryHandler = () => async (req) => {
63
61
  req,
64
62
  scope: context.scope,
65
63
  adapter,
66
- platformRead
64
+ gates
67
65
  });
68
66
  if (!queryScope.ok) return errorResponse(403, analyticsError("forbidden", "analytics: this source cannot be read for your scope", "source"));
69
67
  const capabilities = serializeCapabilities(adapter.capabilities);
68
+ const ownScope = resolvableScope(context.scope);
70
69
  const parsed = parseQueryParams(params, {
71
70
  capabilities,
72
- timezone: await resolveTimezoneFor(runtime, req, context.scope === "*" ? null : context.scope)
71
+ timezone: await resolveTimezoneFor(runtime, req, ownScope)
73
72
  });
74
73
  if (!parsed.ok) return errorResponse(400, parsed.error);
75
- const goalSlugs = await goalSlugsFor({
74
+ const hint = await goalHintFor({
76
75
  runtime,
77
76
  req,
78
- scope: context.scope === "*" ? null : context.scope,
77
+ scope: ownScope,
79
78
  metrics: parsed.value.query.metrics,
80
79
  dimensions: parsed.value.query.dimensions
81
80
  });
82
81
  const query = {
83
82
  ...parsed.value.query,
84
83
  ...queryScope.queryScope === void 0 ? {} : { scope: queryScope.queryScope },
85
- ...goalSlugs === void 0 ? {} : { goalSlugs }
84
+ ...hint === void 0 ? {} : { goalSlugs: hint.slugs }
86
85
  };
87
86
  let comparisonRange = null;
88
87
  if (parsed.value.compare === "previous") {
89
88
  comparisonRange = previousWindow(query.dateRange, query.timezone);
90
89
  if (!comparisonRange) return errorResponse(400, analyticsError("invalid_param", "analytics: the range is too long to compare against a previous period", "compare"));
91
- if (!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, { tz: query.timezone })) comparisonRange = null;
90
+ if (!withinLookback(comparisonRange, adapter.capabilities.maxLookbackDays, {
91
+ tz: query.timezone,
92
+ now: currentDate()
93
+ })) comparisonRange = null;
92
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);
93
102
  let result;
94
103
  let comparison;
95
104
  try {
96
- [result, comparison] = await Promise.all([runtime.engine.read(adapter, query), comparisonRange ? runtime.engine.read(adapter, {
97
- ...query,
105
+ const [read, previous] = await Promise.all([runtime.engine.read(adapter, served, readOptions), comparisonRange ? runtime.engine.read(adapter, {
106
+ ...served,
98
107
  dateRange: comparisonRange
99
- }) : void 0]);
108
+ }, readOptions) : void 0]);
109
+ result = askedResult(read, aliased);
110
+ comparison = previous && askedResult(previous, aliased);
100
111
  } catch (err) {
101
- req.payload.logger?.warn(`analytics: query read failed for adapter "${adapter.id}": ${String(err)}`);
102
- return errorResponse(503, analyticsError("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);
103
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;
104
126
  const body = {
105
- result,
106
- ...comparison ? { comparison } : {},
127
+ result: withCurrency(result),
128
+ ...comparison ? { comparison: withCurrency(comparison) } : {},
129
+ ...currency ? { currency } : {},
107
130
  source: {
108
131
  id: adapter.id,
109
132
  label: adapter.label,
110
133
  kind: runtime.configAdapterIds.has(adapter.id) ? "config" : "runtime"
111
134
  },
112
135
  capabilities,
113
- query: serializeQuery(query)
136
+ query: serializeQuery(query),
137
+ ...hint && hint.builtin.length > 0 ? { builtinGoalSlugs: hint.builtin } : {},
138
+ ...itemLabels ? { itemLabels } : {}
114
139
  };
115
140
  return Response.json(body, { headers: NO_STORE });
116
141
  } catch (err) {
@@ -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, resolveRequestedScope } from '../core/scopedRead'\nimport { parseQueryParams, readParam } from '../query/parse'\nimport type { QueryResponse, SerializedAnalyticsQuery } from '../query/response'\nimport { previousWindow, withinLookback } from '../widgets/comparison'\nimport { analyticsError, errorResponse, NO_STORE, RETRY_AFTER } from './errors'\nimport { goalSlugsFor } from './goalHint'\nimport { QUERY_PATH } from './paths'\nimport { resolveSourcesForRequest } from './readContextForRequest'\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, analyticsError('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(\n\t\t\t503,\n\t\t\tanalyticsError('unavailable', 'analytics: not available'),\n\t\t\tRETRY_AFTER\n\t\t)\n\t}\n\tlet adapterId = 'unresolved'\n\ttry {\n\t\tif (!(await readAccessFor(runtime, req))) {\n\t\t\treturn errorResponse(403, analyticsError('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 requested = await resolveRequestedScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\traw: params.get('scope'),\n\t\t\tplatformRead,\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// Only a scope the caller itself named is ever named back to it.\n\t\t\treturn requested.reason === 'named'\n\t\t\t\t? errorResponse(\n\t\t\t\t\t\t400,\n\t\t\t\t\t\tanalyticsError(\n\t\t\t\t\t\t\t'untrusted_scope',\n\t\t\t\t\t\t\t'analytics: scope is not permitted for this request',\n\t\t\t\t\t\t\t'scope'\n\t\t\t\t\t\t)\n\t\t\t\t\t)\n\t\t\t\t: errorResponse(\n\t\t\t\t\t\t404,\n\t\t\t\t\t\tanalyticsError('unknown_source', 'analytics: no source is available for this request')\n\t\t\t\t\t)\n\t\t}\n\t\tconst context = await resolveSourcesForRequest(req, { platformRead, scope: requested.scope })\n\t\tif (context.adapters.size === 0) {\n\t\t\treturn errorResponse(\n\t\t\t\t404,\n\t\t\t\tanalyticsError('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(\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\tplatformRead,\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 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\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})\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\tanalyticsError('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?.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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"}
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: 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"}
@@ -1,7 +1,8 @@
1
- import "../core/contract.js";
2
- import { getRuntime, platformReadGate, resolveRegistryFor } 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 { needsUnscopedSourceAccess, resolveRequestedScope, visibleRegistryFor } from "../core/scopedRead.js";
3
5
  import { serializeCapabilities } from "../core/capabilities.js";
4
- import { resolveRequestedScope } from "../core/scopedRead.js";
5
6
  //#region src/plugin/readContextForRequest.ts
6
7
  const empty = () => ({
7
8
  sources: [],
@@ -25,17 +26,39 @@ const fromRegistry = (args) => {
25
26
  };
26
27
  };
27
28
  /**
28
- * The sources a request may read, resolved once for both read endpoints: the request's
29
- * own scope (or one a caller already had gated), the per-scope registry, and each adapter's
30
- * serialized capabilities. {@link resolveRequestedScope} owns the scope decision, so a
31
- * cross-scope resolution resolves no sources at all rather than another tenant's. A
32
- * resolution that fails outright degrades instead: nothing on a scoped install, where it is
33
- * indistinguishable from a forged request, and the static config registry otherwise.
29
+ * Sources that can answer about one scope. Under a tenant scope a shared adapter unable to narrow
30
+ * would report every tenant's numbers, so it is dropped however privileged the reader.
31
+ */
32
+ const narrowToScope = (runtime, resolved) => {
33
+ const scope = resolved.scope;
34
+ if (scope === null) return resolved;
35
+ const narrowable = resolved.sources.filter((source) => {
36
+ const adapter = resolved.adapters.get(source.id);
37
+ return adapter !== void 0 && !needsUnscopedSourceAccess(runtime, adapter, scope);
38
+ });
39
+ if (narrowable.length === resolved.sources.length) return resolved;
40
+ const kept = new Set(narrowable.map((source) => source.id));
41
+ return {
42
+ sources: narrowable,
43
+ defaultId: resolved.defaultId !== null && kept.has(resolved.defaultId) ? resolved.defaultId : narrowable[0]?.id ?? null,
44
+ adapters: new Map([...resolved.adapters].filter(([id]) => kept.has(id))),
45
+ scope
46
+ };
47
+ };
48
+ /**
49
+ * Sources a request may read, shared by every listing surface. A denied, cross-scope or non-member
50
+ * read lists nothing; a failed resolution lists nothing when scoped, else the config registry.
34
51
  */
35
52
  const resolveSourcesForRequest = async (req, args = {}) => {
36
53
  const runtime = getRuntime(req.payload);
37
54
  if (!runtime) return empty();
38
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
55
+ try {
56
+ if (!await readGate(runtime, req)) return empty();
57
+ } catch (err) {
58
+ req.payload.logger?.warn(`analytics: access.read failed, listing no sources: ${String(err)}`);
59
+ return empty();
60
+ }
61
+ const gates = args.gates ?? scopeGates(runtime, req);
39
62
  const degrade = () => runtime.scoped ? empty() : fromRegistry({
40
63
  runtime,
41
64
  registry: runtime.registry,
@@ -43,25 +66,37 @@ const resolveSourcesForRequest = async (req, args = {}) => {
43
66
  });
44
67
  try {
45
68
  let scope;
46
- if (args.scope !== void 0) scope = args.scope;
47
- else {
69
+ if (args.scope !== void 0) {
70
+ if (!isGatedScope(args.scope)) return empty();
71
+ scope = args.scope.value;
72
+ } else {
48
73
  const requested = await resolveRequestedScope({
49
74
  runtime,
50
75
  req,
51
- platformRead: allowed
76
+ gates
52
77
  });
53
78
  if (!requested.ok) return requested.reason === "failed" ? degrade() : empty();
54
79
  scope = requested.scope;
55
80
  }
56
- return fromRegistry({
81
+ const registry = await visibleRegistryFor({
57
82
  runtime,
58
- registry: await resolveRegistryFor(runtime, {
83
+ req,
84
+ resolved: await resolveRegistryFor(runtime, {
59
85
  payload: req.payload,
60
86
  req,
61
- scope: scope === "*" ? null : scope
87
+ scope: resolvableScope(scope)
62
88
  }),
63
- scope
89
+ scope,
90
+ gates
64
91
  });
92
+ return registry ? narrowToScope(runtime, fromRegistry({
93
+ runtime,
94
+ registry,
95
+ scope
96
+ })) : {
97
+ ...empty(),
98
+ scope
99
+ };
65
100
  } catch (err) {
66
101
  req.payload.logger?.warn(`analytics: source resolution failed: ${String(err)}`);
67
102
  return degrade();
@@ -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 { resolveRequestedScope } from '../core/scopedRead'\nimport type { QuerySourceRef } from '../query/response'\nimport {\n\ttype AnalyticsRuntime,\n\tgetRuntime,\n\ttype PlatformReadGate,\n\tplatformReadGate,\n\tresolveRegistryFor,\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 * A scope {@link resolveRequestedScope} already decided and gated for this request. It\n\t * replaces this call's own resolution, so pass only what that helper returned.\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 one a caller already had gated), the per-scope registry, and each adapter's\n * serialized capabilities. {@link resolveRequestedScope} owns the scope decision, so a\n * cross-scope resolution resolves no sources at all rather than another tenant's. A\n * resolution that fails outright degrades instead: nothing on a scoped install, where it is\n * indistinguishable from a forged request, and the static config registry otherwise.\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\tconst degrade = (): RequestSources =>\n\t\truntime.scoped ? empty() : fromRegistry({ runtime, registry: runtime.registry, scope: null })\n\ttry {\n\t\tlet scope: string | null\n\t\tif (args.scope !== undefined) {\n\t\t\tscope = args.scope\n\t\t} else {\n\t\t\tconst requested = await resolveRequestedScope({ runtime, req, platformRead: allowed })\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 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\treturn degrade()\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;;;;;;;;;AAUA,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,MAAM,gBACL,QAAQ,SAAS,MAAM,IAAI,aAAa;EAAE;EAAS,UAAU,QAAQ;EAAU,OAAO;CAAK,CAAC;CAC7F,IAAI;EACH,IAAI;EACJ,IAAI,KAAK,UAAU,KAAA,GAClB,QAAQ,KAAK;OACP;GACN,MAAM,YAAY,MAAM,sBAAsB;IAAE;IAAS;IAAK,cAAc;GAAQ,CAAC;GACrF,IAAI,CAAC,UAAU,IACd,OAAO,UAAU,WAAW,WAAW,QAAQ,IAAI,MAAM;GAE1D,QAAQ,UAAU;EACnB;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,OAAO,QAAQ;CAChB;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\tvisibleRegistryFor,\n} from '../core/scopedRead'\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\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\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 = (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 * 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 = (): RequestSources =>\n\t\truntime.scoped ? empty() : fromRegistry({ runtime, 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 = await visibleRegistryFor({ runtime, req, resolved, scope, gates })\n\t\treturn registry\n\t\t\t? narrowToScope(runtime, fromRegistry({ runtime, registry, scope }))\n\t\t\t: { ...empty(), scope }\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":";;;;;;AA8CA,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;;;;;AAMA,MAAM,iBAAiB,SAA2B,aAA6C;CAC9F,MAAM,QAAQ,SAAS;CACvB,IAAI,UAAU,MACb,OAAO;CAER,MAAM,aAAa,SAAS,QAAQ,QAAQ,WAAW;EACtD,MAAM,UAAU,SAAS,SAAS,IAAI,OAAO,EAAE;EAC/C,OAAO,YAAY,KAAA,KAAa,CAAC,0BAA0B,SAAS,SAAS,KAAK;CACnF,CAAC;CACD,IAAI,WAAW,WAAW,SAAS,QAAQ,QAC1C,OAAO;CAER,MAAM,OAAO,IAAI,IAAI,WAAW,KAAK,WAAW,OAAO,EAAE,CAAC;CAC1D,OAAO;EACN,SAAS;EACT,WACC,SAAS,cAAc,QAAQ,KAAK,IAAI,SAAS,SAAS,IACvD,SAAS,YACR,WAAW,IAAI,MAAM;EAC1B,UAAU,IAAI,IAAI,CAAC,GAAG,SAAS,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC,CAAC;EACvE;CACD;AACD;;;;;AAMA,MAAa,2BAA2B,OACvC,KACA,OAA2B,CAAC,MACC;CAC7B,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,MAAM;CAEd,IAAI;EACH,IAAI,CAAE,MAAM,SAAS,SAAS,GAAG,GAChC,OAAO,MAAM;CAEf,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,sDAAsD,OAAO,GAAG,GAAG;EAC5F,OAAO,MAAM;CACd;CACA,MAAM,QAAQ,KAAK,SAAS,WAAW,SAAS,GAAG;CACnD,MAAM,gBACL,QAAQ,SAAS,MAAM,IAAI,aAAa;EAAE;EAAS,UAAU,QAAQ;EAAU,OAAO;CAAK,CAAC;CAC7F,IAAI;EACH,IAAI;EACJ,IAAI,KAAK,UAAU,KAAA,GAAW;GAC7B,IAAI,CAAC,aAAa,KAAK,KAAK,GAC3B,OAAO,MAAM;GAEd,QAAQ,KAAK,MAAM;EACpB,OAAO;GACN,MAAM,YAAY,MAAM,sBAAsB;IAAE;IAAS;IAAK;GAAM,CAAC;GACrE,IAAI,CAAC,UAAU,IACd,OAAO,UAAU,WAAW,WAAW,QAAQ,IAAI,MAAM;GAE1D,QAAQ,UAAU;EACnB;EAMA,MAAM,WAAW,MAAM,mBAAmB;GAAE;GAAS;GAAK,UAAA,MALnC,mBAAmB,SAAS;IAClD,SAAS,IAAI;IACb;IACA,OAAO,gBAAgB,KAAK;GAC7B,CAAC;GACmE;GAAO;EAAM,CAAC;EAClF,OAAO,WACJ,cAAc,SAAS,aAAa;GAAE;GAAS;GAAU;EAAM,CAAC,CAAC,IACjE;GAAE,GAAG,MAAM;GAAG;EAAM;CACxB,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,wCAAwC,OAAO,GAAG,GAAG;EAC9E,OAAO,QAAQ;CAChB;AACD"}
@@ -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,64 @@
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({ req });
31
+ if (verdict === false) return [];
32
+ const { docs } = await req.payload.find({
33
+ ...query,
34
+ where: verdict === true ? where : { and: [where, verdict] },
35
+ overrideAccess: true
36
+ });
37
+ return docs;
38
+ };
39
+ const load = async (collection, req, scope) => {
40
+ try {
41
+ const docs = await findReadable(collection, req, { and: [{ enabled: { equals: true } }, providerScopeWhere(collection.scopeField, scope)] });
42
+ return new Set(docs.map((doc) => String(doc.id)));
43
+ } catch (err) {
44
+ req.payload.logger?.warn(`analytics: readable provider lookup failed, treating the scope as having none: ${String(err)}`);
45
+ return /* @__PURE__ */ new Set();
46
+ }
47
+ };
48
+ /**
49
+ * Ids of a scope's enabled provider documents this user may read, memoized per scope and user. Null
50
+ * when the install has no providers collection, so provider documents decide nothing.
51
+ */
52
+ const readableProviderDocIds = (runtime, req, scope) => {
53
+ const collection = runtime.providersCollection;
54
+ if (!collection) return null;
55
+ return readable(req, {
56
+ owner: runtime,
57
+ key: JSON.stringify(scope),
58
+ compute: () => load(collection, req, scope)
59
+ });
60
+ };
61
+ //#endregion
62
+ export { readableProviderDocIds };
63
+
64
+ //# 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 })\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,IAAI,CAAC;CACrD,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"}