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

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 (1259) hide show
  1. package/CHANGELOG.md +530 -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 +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  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 +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  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 +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  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 +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  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 +108 -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 +198 -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 +28 -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 +297 -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 +505 -157
  159. package/dist/core/options.js +158 -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 +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  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/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,122 +1,381 @@
1
+ import { requestMemo } from "../plugin/requestMemo.js";
2
+ import { decideOnce } from "../access/decideOnce.js";
3
+ import { readGate } from "../access/readGate.js";
1
4
  import "./contract.js";
2
- import { platformReadGate, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
5
+ import { isScopeMember } from "../access/membership.js";
6
+ import { SYSTEM, isGatedScope, mintGatedScope } from "../access/principal.js";
7
+ import { createRegistry, filterRegistry } from "./registry.js";
8
+ import { readableProviderDocIds } from "../plugin/readableProviders.js";
9
+ import { resolvableScope, resolveRegistryFor, resolveScopeFor, scopeGates } from "../plugin/runtime.js";
10
+ import { sourceLabelFor, sourceRefFor } from "./sourceLabel.js";
3
11
  //#region src/core/scopedRead.ts
12
+ const cleared = (scope) => ({
13
+ ok: true,
14
+ scope,
15
+ gated: mintGatedScope(scope)
16
+ });
4
17
  /**
5
- * The scope one request may act on, decided in one place for every endpoint that takes a
6
- * `scope` from a caller, so a read gate and a state-changing gate cannot drift apart.
7
- *
8
- * The raw value is trimmed and a blank one counts as absent, exactly as `readParam` reads a
9
- * query string. Naming a scope, the platform wildcard included, is the cross-scope decision
10
- * and requires `platformRead`. Absent means the request's own resolved scope, which is
11
- * itself cross-scope when the resolver answers the wildcard or, on a scoped install, null:
12
- * null usually means "no tenant selected" rather than "everything", so it fails closed
13
- * behind the same gate. A resolver that throws answers no scope either, separately, so a
14
- * caller with a degraded answer to give can tell it from a refusal. Per-adapter narrowing
15
- * is a later decision, in `resolveQueryScope`.
18
+ * The scope one request may act on, for every endpoint taking a caller's `scope`, and the only
19
+ * place a {@link GatedScope} is minted. A scoped install's null, no tenant selected, fails closed.
16
20
  */
17
21
  const resolveRequestedScope = async (args) => {
18
22
  const { runtime, req } = args;
19
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
23
+ const gates = args.gates ?? scopeGates(runtime, req);
20
24
  const named = typeof args.raw === "string" ? args.raw.trim() : "";
21
- if (named !== "") return await allowed() ? {
22
- ok: true,
23
- scope: named
24
- } : {
25
- ok: false,
26
- reason: "named"
27
- };
25
+ if (named !== "") {
26
+ if (named === "*") return await gates.aggregate({ scope: "*" }) ? cleared(named) : {
27
+ ok: false,
28
+ reason: "named"
29
+ };
30
+ if (runtime.scoped !== true || named.length > 256) return {
31
+ ok: false,
32
+ reason: "named"
33
+ };
34
+ if (await gates.named({ scope: named })) return cleared(named);
35
+ const own = await resolveScopeFor(runtime, req).catch(() => null);
36
+ if (own === null || own === "*" || own !== named) return {
37
+ ok: false,
38
+ reason: "named"
39
+ };
40
+ return await isScopeMember(runtime.member, req, own) ? cleared(own) : {
41
+ ok: false,
42
+ reason: "not-member"
43
+ };
44
+ }
28
45
  let scope;
29
46
  try {
30
47
  scope = await resolveScopeFor(runtime, req);
31
- } catch (err) {
32
- req.payload.logger?.warn(`analytics: scope resolution failed: ${String(err)}`);
48
+ } catch {
33
49
  return {
34
50
  ok: false,
35
51
  reason: "failed"
36
52
  };
37
53
  }
38
- if ((scope === "*" || runtime.scoped === true && scope === null) && !await allowed()) return {
54
+ if (scope === "*" || scope === null) return (scope === "*" || runtime.scoped === true) && !await gates.aggregate({ scope }) ? {
39
55
  ok: false,
40
56
  reason: "unresolved"
57
+ } : cleared(scope);
58
+ if (await isScopeMember(runtime.member, req, scope) || await gates.named({ scope })) return cleared(scope);
59
+ return {
60
+ ok: false,
61
+ reason: "not-member"
62
+ };
63
+ };
64
+ /**
65
+ * True for a shared config adapter that cannot narrow its query, read under a tenant scope: it
66
+ * would answer with every scope's data, so reading or listing it takes `unscopedSource`.
67
+ */
68
+ const needsUnscopedSourceAccess = (runtime, adapter, scope) => scope !== null && scope !== "*" && runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries;
69
+ /**
70
+ * {@link SYSTEM} reads any scope, but never a tenant through a shared adapter that cannot narrow
71
+ * to it: a job would store that adapter's install-wide numbers as the tenant's own.
72
+ */
73
+ const SYSTEM_GATES = {
74
+ named: () => Promise.resolve(true),
75
+ aggregate: () => Promise.resolve(true),
76
+ unscopedSource: () => Promise.resolve(false)
77
+ };
78
+ const NONE_ADMITTED = /* @__PURE__ */ new Set();
79
+ /**
80
+ * Whether `sources.<id>.tenants` lets this member of `scope` read through a shared adapter none
81
+ * of its documents grants; asked once per request, scope and adapter. A policy that throws denies.
82
+ */
83
+ const policyAdmits = async (args) => {
84
+ const { runtime, req, scope, adapter, own } = args;
85
+ const policy = runtime.sourcePolicies?.get(adapter.id);
86
+ if (policy === void 0 || !runtime.configAdapterIds.has(adapter.id) || adapter.capabilities.scopedQueries !== true || !await isScopeMember(runtime.member, req, scope)) return false;
87
+ return decideOnce(req, {
88
+ owner: runtime,
89
+ key: `sourcePolicy:${JSON.stringify(scope)}:${adapter.id}`,
90
+ decide: async () => {
91
+ if (policy === "tenant") return true;
92
+ if (policy === "fallback") return own.length === 0;
93
+ try {
94
+ const ownSources = await Promise.all(own.map(async (granted) => ({
95
+ id: granted.adapter.id,
96
+ label: await sourceLabelFor(granted.adapter, {
97
+ req,
98
+ scope
99
+ }),
100
+ docId: granted.docId
101
+ })));
102
+ return await policy({
103
+ req,
104
+ scope,
105
+ adapterId: adapter.id,
106
+ ownSources
107
+ }) === true;
108
+ } catch (err) {
109
+ req.payload.logger?.warn(`analytics: sources.${adapter.id}.tenants threw for scope "${scope}", which counts as no: ${String(err)}`);
110
+ return false;
111
+ }
112
+ }
113
+ });
114
+ };
115
+ const pickedDefaults = requestMemo("defaultSources");
116
+ /** The `defaultSource` function's pick, asked once per request, scope and set of sources. */
117
+ const pickDefault = (args) => {
118
+ const { runtime, req, resolved, scope, visible, pick } = args;
119
+ const listed = visible.all();
120
+ return pickedDefaults(req, {
121
+ owner: pick,
122
+ key: `${JSON.stringify(scope)}:${listed.map((adapter) => adapter.id).join(",")}`,
123
+ compute: async () => {
124
+ try {
125
+ return await pick({
126
+ req,
127
+ scope,
128
+ sources: await Promise.all(listed.map((adapter) => sourceRefFor(adapter, {
129
+ req,
130
+ scope,
131
+ configIds: runtime.configAdapterIds,
132
+ docId: resolved.grants.get(adapter.id)
133
+ })))
134
+ });
135
+ } catch (err) {
136
+ req.payload.logger?.warn(`analytics: defaultSource threw for scope "${scope}", which keeps the default: ${String(err)}`);
137
+ return;
138
+ }
139
+ }
140
+ });
141
+ };
142
+ /**
143
+ * A tenant scope's default among the sources a reader sees: its document flagged the default, else
144
+ * the `defaultSource` rule's pick, else undefined for the registry's own.
145
+ */
146
+ const scopeDefaultId = async (args) => {
147
+ const { runtime, resolved, visible } = args;
148
+ const all = visible.all();
149
+ const sees = (id) => id !== void 0 && all.some((adapter) => adapter.id === id);
150
+ if (sees(resolved.defaultGrant)) return resolved.defaultGrant;
151
+ const rule = runtime.defaultSource;
152
+ if (rule === void 0) return;
153
+ if (rule === "tenantFirst") return all.find((adapter) => resolved.grants.has(adapter.id))?.id;
154
+ if (rule === "platformFirst") return sees(runtime.platformAdapterId) ? runtime.platformAdapterId : void 0;
155
+ const picked = await pickDefault({
156
+ ...args,
157
+ pick: rule
158
+ });
159
+ return sees(picked) ? picked : void 0;
160
+ };
161
+ /** `visible` reading through the scope's chosen default; the very registry when it already does. */
162
+ const withScopeDefault = async (args) => {
163
+ const { visible } = args;
164
+ if (!visible) return null;
165
+ const chosen = await scopeDefaultId({
166
+ ...args,
167
+ visible
168
+ });
169
+ return chosen === void 0 || chosen === visible.default().id ? visible : createRegistry(visible.all(), chosen);
170
+ };
171
+ /**
172
+ * {@link visibleRegistryFor}, also naming the shared adapters only a `fallback` policy admitted,
173
+ * which a listing says so about.
174
+ */
175
+ const visibleSourcesFor = async (args) => {
176
+ const { runtime, req, resolved, scope } = args;
177
+ const { registry, grants } = resolved;
178
+ if (runtime.scoped !== true || scope === null || scope === "*") return {
179
+ registry,
180
+ fallbackAdmitted: NONE_ADMITTED
181
+ };
182
+ if (args.principal === SYSTEM) return {
183
+ registry: await withScopeDefault({
184
+ runtime,
185
+ req,
186
+ resolved,
187
+ scope,
188
+ visible: filterRegistry(registry, (adapter) => grants.has(adapter.id) || !needsUnscopedSourceAccess(runtime, adapter, scope))
189
+ }),
190
+ fallbackAdmitted: NONE_ADMITTED
41
191
  };
192
+ const gates = args.gates ?? scopeGates(runtime, req);
193
+ const readable = await readableProviderDocIds(runtime, req, scope);
194
+ const own = [];
195
+ for (const adapter of registry.all()) {
196
+ const docId = grants.get(adapter.id);
197
+ if (docId !== void 0 && (readable === null || readable.has(docId))) own.push({
198
+ adapter,
199
+ docId
200
+ });
201
+ }
202
+ const keep = new Set(own.map((granted) => granted.adapter.id));
203
+ const fallbackAdmitted = /* @__PURE__ */ new Set();
204
+ for (const adapter of registry.all()) {
205
+ if (grants.has(adapter.id)) continue;
206
+ if (!runtime.providersCollection && adapter.capabilities.scopedQueries) {
207
+ keep.add(adapter.id);
208
+ continue;
209
+ }
210
+ if (await gates.unscopedSource({
211
+ scope,
212
+ adapterId: adapter.id
213
+ })) {
214
+ keep.add(adapter.id);
215
+ continue;
216
+ }
217
+ if (await policyAdmits({
218
+ runtime,
219
+ req,
220
+ scope,
221
+ adapter,
222
+ own
223
+ })) {
224
+ keep.add(adapter.id);
225
+ if (runtime.sourcePolicies?.get(adapter.id) === "fallback") fallbackAdmitted.add(adapter.id);
226
+ }
227
+ }
42
228
  return {
43
- ok: true,
44
- scope
229
+ registry: await withScopeDefault({
230
+ runtime,
231
+ req,
232
+ resolved,
233
+ scope,
234
+ visible: filterRegistry(registry, (adapter) => keep.has(adapter.id))
235
+ }),
236
+ fallbackAdmitted
45
237
  };
46
238
  };
47
239
  /**
48
- * The scope to stamp on one adapter query, or a refusal. Cross-scope reads fail closed
49
- * behind `platformRead`: the `'*'` marker, and any scoped read through a shared config
50
- * adapter that cannot narrow the query to one scope (whether or not it is the designated
51
- * platform adapter), which would otherwise answer with every scope's data. A tenant's own
52
- * runtime adapters are never gated. Every read path decides this here, so the widgets and
53
- * the query endpoint cannot drift apart on what counts as cross-scope.
240
+ * The adapters a request may read through in one tenant scope, or null for none: the scope's own
241
+ * sources follow the providers' read access (`sourceAccess`), a config adapter `unscopedSource` or
242
+ * its `sources` policy. A tenant scope reads through its chosen default (see `defaultSource`).
243
+ */
244
+ const visibleRegistryFor = async (args) => (await visibleSourcesFor(args)).registry;
245
+ /**
246
+ * The sources a job reads one scope through as {@link SYSTEM}, or null when the scope holds
247
+ * none: exactly what `resolveReadContext` lets a system read choose from.
248
+ */
249
+ const systemRegistryFor = async (runtime, req, scope) => {
250
+ return visibleRegistryFor({
251
+ runtime,
252
+ req,
253
+ resolved: await resolveRegistryFor(runtime, {
254
+ payload: req.payload,
255
+ req,
256
+ scope: resolvableScope(scope)
257
+ }),
258
+ scope,
259
+ principal: SYSTEM
260
+ });
261
+ };
262
+ /**
263
+ * The scope to stamp on one adapter query, or a refusal. Every read path decides it here, so
264
+ * widgets and the query endpoint cannot drift on what counts as cross-scope.
54
265
  */
55
266
  const resolveQueryScope = async (args) => {
56
267
  const { runtime, req, scope, adapter } = args;
57
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
58
- if (scope === "*") return await allowed() ? { ok: true } : { ok: false };
268
+ const gates = args.gates ?? scopeGates(runtime, req);
269
+ if (scope === "*") return await gates.aggregate({ scope }) ? { ok: true } : { ok: false };
59
270
  if (scope === null) return { ok: true };
60
- if (runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries) return await allowed() ? { ok: true } : { ok: false };
271
+ if (needsUnscopedSourceAccess(runtime, adapter, scope)) return await gates.unscopedSource({
272
+ scope,
273
+ adapterId: adapter.id
274
+ }) ? { ok: true } : { ok: false };
61
275
  return {
62
276
  ok: true,
63
277
  queryScope: scope
64
278
  };
65
279
  };
66
280
  /**
67
- * Resolve one read's scope and adapter: explicit scope wins over the request's
68
- * resolved scope, the registry is resolved per scope, then the adapter is picked
69
- * by id (or the registry default). A request's own scope goes through
70
- * `resolveRequestedScope`, the same decision every endpoint that takes a scope
71
- * reads with, so the widgets cannot drift from them on what a scope may be.
72
- * Cross-scope reads fail closed behind `platformRead`: an explicit `'*'` scope
73
- * always, any scoped read through a shared config adapter that cannot narrow the
74
- * query to one scope (whether or not it is the designated platform adapter), and,
75
- * on a scoped install, a request that resolves no scope at all. That last case is
76
- * ambiguous rather than intentionally install-wide (a tenant's scopeResolver
77
- * returning null usually means "no tenant selected", not "read everything"), so it
78
- * fails closed the same way. An explicit `scope: null` override bypasses that gate:
79
- * it is the trusted server-side caller's path (cron passes, tests), never a
80
- * request's own resolution. A tenant's own runtime adapters are never gated.
81
- * Any resolution failure (unknown adapter id, a throwing scopeResolver or
82
- * provider lookup) degrades to `{ ok: false }` so read paths render their
83
- * unavailable state instead of throwing.
281
+ * The read's scope: the system's own, one already cleared, or the one the request asks for. Checked
282
+ * at runtime, since a JavaScript caller or a cast can pass anything; anything else is refused.
283
+ */
284
+ const principalScope = async (args, gates) => {
285
+ const { scope } = args;
286
+ if (args.principal === SYSTEM) return typeof scope === "string" || scope === null ? {
287
+ ok: true,
288
+ scope,
289
+ pin: {
290
+ principal: SYSTEM,
291
+ scope
292
+ }
293
+ } : { ok: false };
294
+ if (isGatedScope(scope)) return {
295
+ ok: true,
296
+ scope: scope.value,
297
+ pin: { scope }
298
+ };
299
+ if (scope !== void 0 && scope !== null && typeof scope !== "string") return { ok: false };
300
+ const requested = await resolveRequestedScope({
301
+ runtime: args.runtime,
302
+ req: args.req,
303
+ gates,
304
+ raw: scope
305
+ });
306
+ if (!requested.ok) switch (requested.reason) {
307
+ case "not-member": return {
308
+ ok: false,
309
+ reason: "not-member"
310
+ };
311
+ case "named": return {
312
+ ok: false,
313
+ reason: "no-access"
314
+ };
315
+ case "unresolved": return {
316
+ ok: false,
317
+ reason: "no-scope"
318
+ };
319
+ case "failed": return { ok: false };
320
+ }
321
+ return {
322
+ ok: true,
323
+ scope: requested.scope,
324
+ pin: { scope: requested.gated }
325
+ };
326
+ };
327
+ /**
328
+ * One read's scope and adapter, behind `access.read` and `resolveRequestedScope` unless the
329
+ * principal is {@link SYSTEM}. Any failure answers `{ ok: false }`, so a surface never throws.
84
330
  */
85
331
  const resolveReadContext = async (args) => {
86
332
  const { runtime, req, adapterId } = args;
87
- const allowed = platformReadGate(runtime, req);
333
+ const system = args.principal === SYSTEM;
334
+ const gates = system ? SYSTEM_GATES : scopeGates(runtime, req);
88
335
  try {
89
- let scope;
90
- if (args.scope !== void 0) scope = args.scope;
91
- else {
92
- const requested = await resolveRequestedScope({
93
- runtime,
94
- req,
95
- platformRead: allowed
96
- });
97
- if (!requested.ok) return { ok: false };
98
- scope = requested.scope;
99
- }
100
- const registryScope = scope === "*" ? null : scope;
101
- const registry = await resolveRegistryFor(runtime, {
102
- payload: req.payload,
336
+ if (!system && !await readGate(runtime, req)) return {
337
+ ok: false,
338
+ reason: "no-access"
339
+ };
340
+ const decided = await principalScope(args, gates);
341
+ if (!decided.ok) return decided;
342
+ const { scope, pin } = decided;
343
+ const registryScope = resolvableScope(scope);
344
+ const registry = await visibleRegistryFor({
345
+ runtime,
103
346
  req,
104
- scope: registryScope
347
+ resolved: await resolveRegistryFor(runtime, {
348
+ payload: req.payload,
349
+ req,
350
+ scope: registryScope
351
+ }),
352
+ scope,
353
+ gates,
354
+ ...system ? { principal: SYSTEM } : {}
105
355
  });
106
- const adapter = adapterId ? registry.get(adapterId) : registry.default();
356
+ if (!registry) return {
357
+ ok: false,
358
+ reason: "no-sources"
359
+ };
360
+ const fallback = registry.default();
361
+ const preferred = args.prefer && !args.prefer(fallback) ? registry.all().find(args.prefer) : void 0;
362
+ const substitutedFrom = adapterId && args.fallbackWhenUnreadable && !registry.all().some((a) => a.id === adapterId) ? adapterId : void 0;
363
+ const adapter = adapterId && substitutedFrom === void 0 ? registry.get(adapterId) : preferred ?? fallback;
107
364
  const decision = await resolveQueryScope({
108
365
  runtime,
109
366
  req,
110
367
  scope,
111
368
  adapter,
112
- platformRead: allowed
369
+ gates
113
370
  });
114
371
  if (!decision.ok) return { ok: false };
115
372
  return {
116
373
  ok: true,
117
374
  adapter,
118
375
  scope: registryScope,
119
- queryScope: decision.queryScope
376
+ queryScope: decision.queryScope,
377
+ pin,
378
+ ...substitutedFrom === void 0 ? {} : { substitutedFrom }
120
379
  };
121
380
  } catch (err) {
122
381
  req.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`);
@@ -124,6 +383,6 @@ const resolveReadContext = async (args) => {
124
383
  }
125
384
  };
126
385
  //#endregion
127
- export { resolveQueryScope, resolveReadContext, resolveRequestedScope };
386
+ export { needsUnscopedSourceAccess, resolveQueryScope, resolveReadContext, resolveRequestedScope, systemRegistryFor, visibleSourcesFor };
128
387
 
129
388
  //# sourceMappingURL=scopedRead.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"scopedRead.js","names":[],"sources":["../../src/core/scopedRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport {\n\ttype AnalyticsRuntime,\n\ttype PlatformReadGate,\n\tplatformReadGate,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n} from '../plugin/runtime'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from './contract'\n\nexport type ReadContext =\n\t| {\n\t\t\tok: true\n\t\t\tadapter: AnalyticsAdapter\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t }\n\t| { ok: false }\n\nexport interface ResolveReadContextArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tadapterId?: string\n\t/** Explicit scope override; undefined resolves via the plugin's scopeResolver. */\n\tscope?: string | null\n}\n\nexport interface QueryScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's resolved scope; `'*'` is the explicit cross-scope marker. */\n\tscope: string | null\n\tadapter: AnalyticsAdapter\n\t/** Shared `platformRead` decision; one is created per call when omitted. */\n\tplatformRead?: PlatformReadGate\n}\n\n/**\n * A scope a request may act on, or why it may not. `named` is a scope the caller asked for\n * and `platformRead` denies; `unresolved` is a request whose own scope is cross-scope, or\n * ambiguous on a scoped install, behind the same gate; `failed` is a `scopeResolver` that\n * threw, which callers that can serve something degraded tell apart from a refusal.\n */\nexport type RequestedScope =\n\t| { ok: true; scope: string | null }\n\t| { ok: false; reason: 'named' | 'unresolved' | 'failed' }\n\nexport interface RequestedScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The `scope` the request carried, untrimmed; null or undefined when it carried none. */\n\traw?: string | null\n\t/** Shared `platformRead` decision; one is created per call when omitted. */\n\tplatformRead?: PlatformReadGate\n}\n\n/**\n * The scope one request may act on, decided in one place for every endpoint that takes a\n * `scope` from a caller, so a read gate and a state-changing gate cannot drift apart.\n *\n * The raw value is trimmed and a blank one counts as absent, exactly as `readParam` reads a\n * query string. Naming a scope, the platform wildcard included, is the cross-scope decision\n * and requires `platformRead`. Absent means the request's own resolved scope, which is\n * itself cross-scope when the resolver answers the wildcard or, on a scoped install, null:\n * null usually means \"no tenant selected\" rather than \"everything\", so it fails closed\n * behind the same gate. A resolver that throws answers no scope either, separately, so a\n * caller with a degraded answer to give can tell it from a refusal. Per-adapter narrowing\n * is a later decision, in `resolveQueryScope`.\n */\nexport const resolveRequestedScope = async (args: RequestedScopeArgs): Promise<RequestedScope> => {\n\tconst { runtime, req } = args\n\tconst allowed = args.platformRead ?? platformReadGate(runtime, req)\n\tconst named = typeof args.raw === 'string' ? args.raw.trim() : ''\n\tif (named !== '') {\n\t\treturn (await allowed()) ? { ok: true, scope: named } : { ok: false, reason: 'named' }\n\t}\n\tlet scope: string | null\n\ttry {\n\t\tscope = await resolveScopeFor(runtime, req)\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: scope resolution failed: ${String(err)}`)\n\t\treturn { ok: false, reason: 'failed' }\n\t}\n\tconst crossScope = scope === PLATFORM_SCOPE || (runtime.scoped === true && scope === null)\n\tif (crossScope && !(await allowed())) {\n\t\treturn { ok: false, reason: 'unresolved' }\n\t}\n\treturn { ok: true, scope }\n}\n\n/**\n * The scope to stamp on one adapter query, or a refusal. Cross-scope reads fail closed\n * behind `platformRead`: the `'*'` marker, and any scoped read through a shared config\n * adapter that cannot narrow the query to one scope (whether or not it is the designated\n * platform adapter), which would otherwise answer with every scope's data. A tenant's own\n * runtime adapters are never gated. Every read path decides this here, so the widgets and\n * the query endpoint cannot drift apart on what counts as cross-scope.\n */\nexport const resolveQueryScope = async (\n\targs: QueryScopeArgs\n): Promise<{ ok: true; queryScope?: string } | { ok: false }> => {\n\tconst { runtime, req, scope, adapter } = args\n\tconst allowed = args.platformRead ?? platformReadGate(runtime, req)\n\tif (scope === PLATFORM_SCOPE) {\n\t\treturn (await allowed()) ? { ok: true } : { ok: false }\n\t}\n\tif (scope === null) {\n\t\treturn { ok: true }\n\t}\n\tif (runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries) {\n\t\treturn (await allowed()) ? { ok: true } : { ok: false }\n\t}\n\treturn { ok: true, queryScope: scope }\n}\n\n/**\n * Resolve one read's scope and adapter: explicit scope wins over the request's\n * resolved scope, the registry is resolved per scope, then the adapter is picked\n * by id (or the registry default). A request's own scope goes through\n * `resolveRequestedScope`, the same decision every endpoint that takes a scope\n * reads with, so the widgets cannot drift from them on what a scope may be.\n * Cross-scope reads fail closed behind `platformRead`: an explicit `'*'` scope\n * always, any scoped read through a shared config adapter that cannot narrow the\n * query to one scope (whether or not it is the designated platform adapter), and,\n * on a scoped install, a request that resolves no scope at all. That last case is\n * ambiguous rather than intentionally install-wide (a tenant's scopeResolver\n * returning null usually means \"no tenant selected\", not \"read everything\"), so it\n * fails closed the same way. An explicit `scope: null` override bypasses that gate:\n * it is the trusted server-side caller's path (cron passes, tests), never a\n * request's own resolution. A tenant's own runtime adapters are never gated.\n * Any resolution failure (unknown adapter id, a throwing scopeResolver or\n * provider lookup) degrades to `{ ok: false }` so read paths render their\n * unavailable state instead of throwing.\n */\nexport const resolveReadContext = async (args: ResolveReadContextArgs): Promise<ReadContext> => {\n\tconst { runtime, req, adapterId } = args\n\tconst allowed = platformReadGate(runtime, req)\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 { ok: false }\n\t\t\t}\n\t\t\tscope = requested.scope\n\t\t}\n\t\tconst registryScope = scope === PLATFORM_SCOPE ? null : scope\n\t\tconst registry = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: registryScope,\n\t\t})\n\t\tconst adapter = adapterId ? registry.get(adapterId) : registry.default()\n\t\tconst decision = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope,\n\t\t\tadapter,\n\t\t\tplatformRead: allowed,\n\t\t})\n\t\tif (!decision.ok) {\n\t\t\treturn { ok: false }\n\t\t}\n\t\treturn { ok: true, adapter, scope: registryScope, queryScope: decision.queryScope }\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`)\n\t\treturn { ok: false }\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAsEA,MAAa,wBAAwB,OAAO,SAAsD;CACjG,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,UAAU,KAAK,gBAAgB,iBAAiB,SAAS,GAAG;CAClE,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,KAAK,IAAI,KAAK,IAAI;CAC/D,IAAI,UAAU,IACb,OAAQ,MAAM,QAAQ,IAAK;EAAE,IAAI;EAAM,OAAO;CAAM,IAAI;EAAE,IAAI;EAAO,QAAQ;CAAQ;CAEtF,IAAI;CACJ,IAAI;EACH,QAAQ,MAAM,gBAAgB,SAAS,GAAG;CAC3C,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,uCAAuC,OAAO,GAAG,GAAG;EAC7E,OAAO;GAAE,IAAI;GAAO,QAAQ;EAAS;CACtC;CAEA,KADmB,UAAA,OAA6B,QAAQ,WAAW,QAAQ,UAAU,SACnE,CAAE,MAAM,QAAQ,GACjC,OAAO;EAAE,IAAI;EAAO,QAAQ;CAAa;CAE1C,OAAO;EAAE,IAAI;EAAM;CAAM;AAC1B;;;;;;;;;AAUA,MAAa,oBAAoB,OAChC,SACgE;CAChE,MAAM,EAAE,SAAS,KAAK,OAAO,YAAY;CACzC,MAAM,UAAU,KAAK,gBAAgB,iBAAiB,SAAS,GAAG;CAClE,IAAI,UAAA,KACH,OAAQ,MAAM,QAAQ,IAAK,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,MAAM;CAEvD,IAAI,UAAU,MACb,OAAO,EAAE,IAAI,KAAK;CAEnB,IAAI,QAAQ,iBAAiB,IAAI,QAAQ,EAAE,KAAK,CAAC,QAAQ,aAAa,eACrE,OAAQ,MAAM,QAAQ,IAAK,EAAE,IAAI,KAAK,IAAI,EAAE,IAAI,MAAM;CAEvD,OAAO;EAAE,IAAI;EAAM,YAAY;CAAM;AACtC;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,qBAAqB,OAAO,SAAuD;CAC/F,MAAM,EAAE,SAAS,KAAK,cAAc;CACpC,MAAM,UAAU,iBAAiB,SAAS,GAAG;CAC7C,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,EAAE,IAAI,MAAM;GAEpB,QAAQ,UAAU;EACnB;EACA,MAAM,gBAAgB,UAAA,MAA2B,OAAO;EACxD,MAAM,WAAW,MAAM,mBAAmB,SAAS;GAClD,SAAS,IAAI;GACb;GACA,OAAO;EACR,CAAC;EACD,MAAM,UAAU,YAAY,SAAS,IAAI,SAAS,IAAI,SAAS,QAAQ;EACvE,MAAM,WAAW,MAAM,kBAAkB;GACxC;GACA;GACA;GACA;GACA,cAAc;EACf,CAAC;EACD,IAAI,CAAC,SAAS,IACb,OAAO,EAAE,IAAI,MAAM;EAEpB,OAAO;GAAE,IAAI;GAAM;GAAS,OAAO;GAAe,YAAY,SAAS;EAAW;CACnF,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,8CAA8C,OAAO,GAAG,GAAG;EACpF,OAAO,EAAE,IAAI,MAAM;CACpB;AACD"}
1
+ {"version":3,"file":"scopedRead.js","names":[],"sources":["../../src/core/scopedRead.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { decideOnce } from '../access/decideOnce'\nimport { isScopeMember } from '../access/membership'\nimport {\n\ttype GatedScope,\n\tisGatedScope,\n\tmintGatedScope,\n\ttype ReadPrincipal,\n\tSYSTEM,\n} from '../access/principal'\nimport { readGate } from '../access/readGate'\nimport { readableProviderDocIds } from '../plugin/readableProviders'\nimport { requestMemo } from '../plugin/requestMemo'\nimport {\n\ttype AnalyticsRuntime,\n\tresolvableScope,\n\tresolveRegistryFor,\n\tresolveScopeFor,\n\ttype ScopeGates,\n\tscopeGates,\n} from '../plugin/runtime'\nimport { MAX_SCOPE_LENGTH } from '../query/limits'\nimport { type AnalyticsAdapter, PLATFORM_SCOPE } from './contract'\nimport {\n\ttype AdapterRegistry,\n\tcreateRegistry,\n\tfilterRegistry,\n\ttype ScopeRegistry,\n} from './registry'\nimport { sourceLabelFor, sourceRefFor } from './sourceLabel'\nimport type { DefaultSourceFunction, SourceRef } from './sourcePolicy'\n\nexport type ReadContext =\n\t| {\n\t\t\tok: true\n\t\t\tadapter: AnalyticsAdapter\n\t\t\tscope: string | null\n\t\t\t/** The scope to stamp on the adapter query; undefined for install-wide reads. */\n\t\t\tqueryScope?: string\n\t\t\t/**\n\t\t\t * The read's principal and scope, for the reads it makes on its behalf: handing this on\n\t\t\t * keeps every one of them on exactly this scope without deciding it again.\n\t\t\t */\n\t\t\tpin: ReadPrincipal\n\t\t\t/** The source asked for, which this reader cannot read, when the scope default read instead. */\n\t\t\tsubstitutedFrom?: string\n\t }\n\t| {\n\t\t\tok: false\n\t\t\t/**\n\t\t\t * Why the read was refused: `no-sources` (nothing this reader may read), `no-access`,\n\t\t\t * `not-member`, or `no-scope` (no single scope resolved, no cross-scope read).\n\t\t\t */\n\t\t\treason?: 'no-sources' | 'no-access' | 'not-member' | 'no-scope'\n\t }\n\ntype ResolveReadContextArgs = {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tadapterId?: string\n\t/**\n\t * Without an `adapterId`, the source to read through is the scope's default when this accepts\n\t * it, else the first visible source it accepts, else the default all the same.\n\t */\n\tprefer?: (adapter: AnalyticsAdapter) => boolean\n\t/**\n\t * An `adapterId` this reader cannot read is read as if none were named, the substitution\n\t * reported as `substitutedFrom`: for a stored choice, never a caller's explicit one.\n\t */\n\tfallbackWhenUnreadable?: boolean\n} & ReadPrincipal\n\ninterface QueryScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's resolved scope; `'*'` is the explicit cross-scope marker. */\n\tscope: string | null\n\tadapter: AnalyticsAdapter\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\n/**\n * A scope a request may act on, or why not: `named` and `unresolved` are denied cross-scope gates,\n * `failed` a throwing `scope.resolve`, `not-member` a scope its user does not belong to.\n */\nexport type RequestedScope =\n\t| {\n\t\t\tok: true\n\t\t\tscope: string | null\n\t\t\t/** The same scope as a token the reads below accept without deciding it again. */\n\t\t\tgated: GatedScope\n\t }\n\t| { ok: false; reason: 'named' | 'unresolved' | 'failed' | 'not-member' }\n\ninterface RequestedScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The `scope` the request carried, untrimmed; null or undefined when it carried none. */\n\traw?: string | null\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\nconst cleared = (scope: string | null): RequestedScope => ({\n\tok: true,\n\tscope,\n\tgated: mintGatedScope(scope),\n})\n\n/**\n * The scope one request may act on, for every endpoint taking a caller's `scope`, and the only\n * place a {@link GatedScope} is minted. A scoped install's null, no tenant selected, fails closed.\n */\nexport const resolveRequestedScope = async (args: RequestedScopeArgs): Promise<RequestedScope> => {\n\tconst { runtime, req } = args\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tconst named = typeof args.raw === 'string' ? args.raw.trim() : ''\n\tif (named !== '') {\n\t\t// The wildcard is never the request's own scope in this sense: it names every scope,\n\t\t// whatever the resolver answered, and stays behind the aggregate gate.\n\t\tif (named === PLATFORM_SCOPE) {\n\t\t\treturn (await gates.aggregate({ scope: PLATFORM_SCOPE }))\n\t\t\t\t? cleared(named)\n\t\t\t\t: { ok: false, reason: 'named' }\n\t\t}\n\t\t// An install without tenants has no scope to name, and no tenant id runs this long.\n\t\tif (runtime.scoped !== true || named.length > MAX_SCOPE_LENGTH) {\n\t\t\treturn { ok: false, reason: 'named' }\n\t\t}\n\t\tif (await gates.named({ scope: named })) {\n\t\t\treturn cleared(named)\n\t\t}\n\t\t// Only after the gate has said no, so a platform reader still costs one resolution.\n\t\tconst own = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tif (own === null || own === PLATFORM_SCOPE || own !== named) {\n\t\t\treturn { ok: false, reason: 'named' }\n\t\t}\n\t\treturn (await isScopeMember(runtime.member, req, own))\n\t\t\t? cleared(own)\n\t\t\t: { ok: false, reason: 'not-member' }\n\t}\n\tlet scope: string | null\n\ttry {\n\t\tscope = await resolveScopeFor(runtime, req)\n\t} catch {\n\t\treturn { ok: false, reason: 'failed' }\n\t}\n\tif (scope === PLATFORM_SCOPE || scope === null) {\n\t\tconst crossScope = scope === PLATFORM_SCOPE || runtime.scoped === true\n\t\treturn crossScope && !(await gates.aggregate({ scope }))\n\t\t\t? { ok: false, reason: 'unresolved' }\n\t\t\t: cleared(scope)\n\t}\n\tif ((await isScopeMember(runtime.member, req, scope)) || (await gates.named({ scope }))) {\n\t\treturn cleared(scope)\n\t}\n\treturn { ok: false, reason: 'not-member' }\n}\n\n/**\n * True for a shared config adapter that cannot narrow its query, read under a tenant scope: it\n * would answer with every scope's data, so reading or listing it takes `unscopedSource`.\n */\nexport const needsUnscopedSourceAccess = (\n\truntime: AnalyticsRuntime,\n\tadapter: AnalyticsAdapter,\n\tscope: string | null\n): boolean =>\n\tscope !== null &&\n\tscope !== PLATFORM_SCOPE &&\n\truntime.configAdapterIds.has(adapter.id) &&\n\t!adapter.capabilities.scopedQueries\n\n/**\n * {@link SYSTEM} reads any scope, but never a tenant through a shared adapter that cannot narrow\n * to it: a job would store that adapter's install-wide numbers as the tenant's own.\n */\nconst SYSTEM_GATES: ScopeGates = {\n\tnamed: () => Promise.resolve(true),\n\taggregate: () => Promise.resolve(true),\n\tunscopedSource: () => Promise.resolve(false),\n}\n\ninterface VisibleArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tresolved: ScopeRegistry\n\tscope: string | null\n\tgates?: ScopeGates\n\tprincipal?: typeof SYSTEM\n}\n\n/** The adapters one reader sees in a scope, and which of them a `fallback` policy alone admitted. */\nexport interface VisibleSources {\n\tregistry: AdapterRegistry | null\n\t/** Shared adapters listed only because a `fallback` policy let a member of the scope in. */\n\tfallbackAdmitted: ReadonlySet<string>\n}\n\nconst NONE_ADMITTED: ReadonlySet<string> = new Set()\n\n/** A source the reader reads a scope through by one of the scope's own provider documents. */\ninterface Granted {\n\tadapter: AnalyticsAdapter\n\tdocId: string\n}\n\n/**\n * Whether `sources.<id>.tenants` lets this member of `scope` read through a shared adapter none\n * of its documents grants; asked once per request, scope and adapter. A policy that throws denies.\n */\nconst policyAdmits = async (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tscope: string\n\tadapter: AnalyticsAdapter\n\town: readonly Granted[]\n}): Promise<boolean> => {\n\tconst { runtime, req, scope, adapter, own } = args\n\tconst policy = runtime.sourcePolicies?.get(adapter.id)\n\t// The boot refuses a policy on an adapter that cannot narrow; a tenant must never read totals\n\t// spanning every tenant, so a runtime built any other way is held to it too.\n\tif (\n\t\tpolicy === undefined ||\n\t\t!runtime.configAdapterIds.has(adapter.id) ||\n\t\tadapter.capabilities.scopedQueries !== true ||\n\t\t!(await isScopeMember(runtime.member, req, scope))\n\t) {\n\t\treturn false\n\t}\n\treturn decideOnce(req, {\n\t\towner: runtime,\n\t\tkey: `sourcePolicy:${JSON.stringify(scope)}:${adapter.id}`,\n\t\tdecide: async () => {\n\t\t\tif (policy === 'tenant') {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tif (policy === 'fallback') {\n\t\t\t\treturn own.length === 0\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst ownSources = await Promise.all(\n\t\t\t\t\town.map(async (granted) => ({\n\t\t\t\t\t\tid: granted.adapter.id,\n\t\t\t\t\t\tlabel: await sourceLabelFor(granted.adapter, { req, scope }),\n\t\t\t\t\t\tdocId: granted.docId,\n\t\t\t\t\t}))\n\t\t\t\t)\n\t\t\t\treturn (await policy({ req, scope, adapterId: adapter.id, ownSources })) === true\n\t\t\t} catch (err) {\n\t\t\t\treq.payload.logger?.warn(\n\t\t\t\t\t`analytics: sources.${adapter.id}.tenants threw for scope \"${scope}\", which counts as no: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn false\n\t\t\t}\n\t\t},\n\t})\n}\n\nconst pickedDefaults = requestMemo<string | undefined>('defaultSources')\n\n/** The `defaultSource` function's pick, asked once per request, scope and set of sources. */\nconst pickDefault = (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tresolved: ScopeRegistry\n\tscope: string\n\tvisible: AdapterRegistry\n\tpick: DefaultSourceFunction\n}): Promise<string | undefined> => {\n\tconst { runtime, req, resolved, scope, visible, pick } = args\n\tconst listed = visible.all()\n\treturn pickedDefaults(req, {\n\t\towner: pick,\n\t\tkey: `${JSON.stringify(scope)}:${listed.map((adapter) => adapter.id).join(',')}`,\n\t\tcompute: async () => {\n\t\t\ttry {\n\t\t\t\tconst sources: SourceRef[] = await Promise.all(\n\t\t\t\t\tlisted.map((adapter) =>\n\t\t\t\t\t\tsourceRefFor(adapter, {\n\t\t\t\t\t\t\treq,\n\t\t\t\t\t\t\tscope,\n\t\t\t\t\t\t\tconfigIds: runtime.configAdapterIds,\n\t\t\t\t\t\t\tdocId: resolved.grants.get(adapter.id),\n\t\t\t\t\t\t})\n\t\t\t\t\t)\n\t\t\t\t)\n\t\t\t\treturn await pick({ req, scope, sources })\n\t\t\t} catch (err) {\n\t\t\t\treq.payload.logger?.warn(\n\t\t\t\t\t`analytics: defaultSource threw for scope \"${scope}\", which keeps the default: ${String(err)}`\n\t\t\t\t)\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t},\n\t})\n}\n\ninterface ScopeDefaultArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tresolved: ScopeRegistry\n\tscope: string\n\tvisible: AdapterRegistry\n}\n\n/**\n * A tenant scope's default among the sources a reader sees: its document flagged the default, else\n * the `defaultSource` rule's pick, else undefined for the registry's own.\n */\nconst scopeDefaultId = async (args: ScopeDefaultArgs): Promise<string | undefined> => {\n\tconst { runtime, resolved, visible } = args\n\tconst all = visible.all()\n\tconst sees = (id: string | undefined): id is string =>\n\t\tid !== undefined && all.some((adapter) => adapter.id === id)\n\tif (sees(resolved.defaultGrant)) {\n\t\treturn resolved.defaultGrant\n\t}\n\tconst rule = runtime.defaultSource\n\tif (rule === undefined) {\n\t\treturn undefined\n\t}\n\tif (rule === 'tenantFirst') {\n\t\treturn all.find((adapter) => resolved.grants.has(adapter.id))?.id\n\t}\n\tif (rule === 'platformFirst') {\n\t\treturn sees(runtime.platformAdapterId) ? runtime.platformAdapterId : undefined\n\t}\n\tconst picked = await pickDefault({ ...args, pick: rule })\n\treturn sees(picked) ? picked : undefined\n}\n\n/** `visible` reading through the scope's chosen default; the very registry when it already does. */\nconst withScopeDefault = async (\n\targs: Omit<ScopeDefaultArgs, 'visible'> & { visible: AdapterRegistry | null }\n): Promise<AdapterRegistry | null> => {\n\tconst { visible } = args\n\tif (!visible) {\n\t\treturn null\n\t}\n\tconst chosen = await scopeDefaultId({ ...args, visible })\n\treturn chosen === undefined || chosen === visible.default().id\n\t\t? visible\n\t\t: createRegistry(visible.all(), chosen)\n}\n\n/**\n * {@link visibleRegistryFor}, also naming the shared adapters only a `fallback` policy admitted,\n * which a listing says so about.\n */\nexport const visibleSourcesFor = async (args: VisibleArgs): Promise<VisibleSources> => {\n\tconst { runtime, req, resolved, scope } = args\n\tconst { registry, grants } = resolved\n\tif (runtime.scoped !== true || scope === null || scope === PLATFORM_SCOPE) {\n\t\treturn { registry, fallbackAdmitted: NONE_ADMITTED }\n\t}\n\tif (args.principal === SYSTEM) {\n\t\tconst visible = filterRegistry(\n\t\t\tregistry,\n\t\t\t(adapter) => grants.has(adapter.id) || !needsUnscopedSourceAccess(runtime, adapter, scope)\n\t\t)\n\t\treturn {\n\t\t\tregistry: await withScopeDefault({ runtime, req, resolved, scope, visible }),\n\t\t\tfallbackAdmitted: NONE_ADMITTED,\n\t\t}\n\t}\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tconst readable = await readableProviderDocIds(runtime, req, scope)\n\tconst own: Granted[] = []\n\tfor (const adapter of registry.all()) {\n\t\tconst docId = grants.get(adapter.id)\n\t\tif (docId !== undefined && (readable === null || readable.has(docId))) {\n\t\t\town.push({ adapter, docId })\n\t\t}\n\t}\n\tconst keep = new Set(own.map((granted) => granted.adapter.id))\n\tconst fallbackAdmitted = new Set<string>()\n\tfor (const adapter of registry.all()) {\n\t\tif (grants.has(adapter.id)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (!runtime.providersCollection && adapter.capabilities.scopedQueries) {\n\t\t\tkeep.add(adapter.id)\n\t\t\tcontinue\n\t\t}\n\t\tif (await gates.unscopedSource({ scope, adapterId: adapter.id })) {\n\t\t\tkeep.add(adapter.id)\n\t\t\tcontinue\n\t\t}\n\t\tif (await policyAdmits({ runtime, req, scope, adapter, own })) {\n\t\t\tkeep.add(adapter.id)\n\t\t\tif (runtime.sourcePolicies?.get(adapter.id) === 'fallback') {\n\t\t\t\tfallbackAdmitted.add(adapter.id)\n\t\t\t}\n\t\t}\n\t}\n\tconst visible = filterRegistry(registry, (adapter) => keep.has(adapter.id))\n\treturn {\n\t\tregistry: await withScopeDefault({ runtime, req, resolved, scope, visible }),\n\t\tfallbackAdmitted,\n\t}\n}\n\n/**\n * The adapters a request may read through in one tenant scope, or null for none: the scope's own\n * sources follow the providers' read access (`sourceAccess`), a config adapter `unscopedSource` or\n * its `sources` policy. A tenant scope reads through its chosen default (see `defaultSource`).\n */\nexport const visibleRegistryFor = async (args: VisibleArgs): Promise<AdapterRegistry | null> =>\n\t(await visibleSourcesFor(args)).registry\n\n/**\n * The sources a job reads one scope through as {@link SYSTEM}, or null when the scope holds\n * none: exactly what `resolveReadContext` lets a system read choose from.\n */\nexport const systemRegistryFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<AdapterRegistry | null> => {\n\tconst resolved = await resolveRegistryFor(runtime, {\n\t\tpayload: req.payload,\n\t\treq,\n\t\tscope: resolvableScope(scope),\n\t})\n\treturn visibleRegistryFor({ runtime, req, resolved, scope, principal: SYSTEM })\n}\n\n/**\n * The scope to stamp on one adapter query, or a refusal. Every read path decides it here, so\n * widgets and the query endpoint cannot drift on what counts as cross-scope.\n */\nexport const resolveQueryScope = async (\n\targs: QueryScopeArgs\n): Promise<{ ok: true; queryScope?: string } | { ok: false }> => {\n\tconst { runtime, req, scope, adapter } = args\n\tconst gates = args.gates ?? scopeGates(runtime, req)\n\tif (scope === PLATFORM_SCOPE) {\n\t\treturn (await gates.aggregate({ scope })) ? { ok: true } : { ok: false }\n\t}\n\tif (scope === null) {\n\t\treturn { ok: true }\n\t}\n\tif (needsUnscopedSourceAccess(runtime, adapter, scope)) {\n\t\treturn (await gates.unscopedSource({ scope, adapterId: adapter.id }))\n\t\t\t? { ok: true }\n\t\t\t: { ok: false }\n\t}\n\treturn { ok: true, queryScope: scope }\n}\n\ntype PrincipalScope =\n\t| { ok: true; scope: string | null; pin: ReadPrincipal }\n\t| Extract<ReadContext, { ok: false }>\n\n/**\n * The read's scope: the system's own, one already cleared, or the one the request asks for. Checked\n * at runtime, since a JavaScript caller or a cast can pass anything; anything else is refused.\n */\nconst principalScope = async (\n\targs: ResolveReadContextArgs,\n\tgates: ScopeGates\n): Promise<PrincipalScope> => {\n\tconst { scope } = args\n\tif (args.principal === SYSTEM) {\n\t\treturn typeof scope === 'string' || scope === null\n\t\t\t? { ok: true, scope, pin: { principal: SYSTEM, scope } }\n\t\t\t: { ok: false }\n\t}\n\tif (isGatedScope(scope)) {\n\t\treturn { ok: true, scope: scope.value, pin: { scope } }\n\t}\n\tif (scope !== undefined && scope !== null && typeof scope !== 'string') {\n\t\treturn { ok: false }\n\t}\n\tconst requested = await resolveRequestedScope({\n\t\truntime: args.runtime,\n\t\treq: args.req,\n\t\tgates,\n\t\traw: scope,\n\t})\n\tif (!requested.ok) {\n\t\tswitch (requested.reason) {\n\t\t\tcase 'not-member':\n\t\t\t\treturn { ok: false, reason: 'not-member' }\n\t\t\tcase 'named':\n\t\t\t\treturn { ok: false, reason: 'no-access' }\n\t\t\tcase 'unresolved':\n\t\t\t\treturn { ok: false, reason: 'no-scope' }\n\t\t\tcase 'failed':\n\t\t\t\treturn { ok: false }\n\t\t}\n\t}\n\treturn { ok: true, scope: requested.scope, pin: { scope: requested.gated } }\n}\n\n/**\n * One read's scope and adapter, behind `access.read` and `resolveRequestedScope` unless the\n * principal is {@link SYSTEM}. Any failure answers `{ ok: false }`, so a surface never throws.\n */\nexport const resolveReadContext = async (args: ResolveReadContextArgs): Promise<ReadContext> => {\n\tconst { runtime, req, adapterId } = args\n\tconst system = args.principal === SYSTEM\n\tconst gates = system ? SYSTEM_GATES : scopeGates(runtime, req)\n\ttry {\n\t\tif (!system && !(await readGate(runtime, req))) {\n\t\t\treturn { ok: false, reason: 'no-access' }\n\t\t}\n\t\tconst decided = await principalScope(args, gates)\n\t\tif (!decided.ok) {\n\t\t\treturn decided\n\t\t}\n\t\tconst { scope, pin } = decided\n\t\tconst registryScope = resolvableScope(scope)\n\t\tconst resolved = await resolveRegistryFor(runtime, {\n\t\t\tpayload: req.payload,\n\t\t\treq,\n\t\t\tscope: registryScope,\n\t\t})\n\t\t// The default is picked out of what this reader may actually read, so a scope whose\n\t\t// leading source is the platform's own shared one still serves a tenant admin.\n\t\tconst registry = await visibleRegistryFor({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tresolved,\n\t\t\tscope,\n\t\t\tgates,\n\t\t\t...(system ? { principal: SYSTEM } : {}),\n\t\t})\n\t\tif (!registry) {\n\t\t\treturn { ok: false, reason: 'no-sources' }\n\t\t}\n\t\tconst fallback = registry.default()\n\t\tconst preferred =\n\t\t\targs.prefer && !args.prefer(fallback) ? registry.all().find(args.prefer) : undefined\n\t\tconst substitutedFrom =\n\t\t\tadapterId && args.fallbackWhenUnreadable && !registry.all().some((a) => a.id === adapterId)\n\t\t\t\t? adapterId\n\t\t\t\t: undefined\n\t\tconst adapter =\n\t\t\tadapterId && substitutedFrom === undefined ? registry.get(adapterId) : (preferred ?? fallback)\n\t\tconst decision = await resolveQueryScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tscope,\n\t\t\tadapter,\n\t\t\tgates,\n\t\t})\n\t\tif (!decision.ok) {\n\t\t\treturn { ok: false }\n\t\t}\n\t\treturn {\n\t\t\tok: true,\n\t\t\tadapter,\n\t\t\tscope: registryScope,\n\t\t\tqueryScope: decision.queryScope,\n\t\t\tpin,\n\t\t\t...(substitutedFrom === undefined ? {} : { substitutedFrom }),\n\t\t}\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`)\n\t\treturn { ok: false }\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ //#region src/core/sdks.d.ts
2
+ /**
3
+ * What the GA4 adapter hands the Data API client it builds. A type alias rather than an
4
+ * interface: the SDK's `ClientOptions` carries an index signature, which an interface never meets.
5
+ */
6
+ type Ga4ClientOptions = {
7
+ credentials: {
8
+ client_email: string;
9
+ private_key: string;
10
+ };
11
+ projectId?: string;
12
+ };
13
+ /**
14
+ * One row of a GA4 report, as far as the adapter reads it.
15
+ *
16
+ * @beta
17
+ */
18
+ interface Ga4ReportRow {
19
+ dimensionValues?: Array<{
20
+ value?: string | null;
21
+ }> | null;
22
+ metricValues?: Array<{
23
+ value?: string | null;
24
+ }> | null;
25
+ }
26
+ /**
27
+ * A GA4 report as far as the adapter reads it, written out so no SDK type is needed.
28
+ *
29
+ * @beta
30
+ */
31
+ interface Ga4ReportResponse {
32
+ rows?: Ga4ReportRow[] | null;
33
+ totals?: Ga4ReportRow[] | null;
34
+ metadata?: {
35
+ samplingMetadatas?: unknown[] | null;
36
+ currencyCode?: string | null;
37
+ } | null;
38
+ }
39
+ /**
40
+ * The Data API client the GA4 adapter calls: the SDK's `BetaAnalyticsDataClient` is one.
41
+ *
42
+ * @beta
43
+ */
44
+ interface Ga4Client {
45
+ runReport(request: object, options?: {
46
+ timeout?: number;
47
+ retry?: null;
48
+ }): Promise<[Ga4ReportResponse, ...unknown[]]>;
49
+ close?(): Promise<void>;
50
+ }
51
+ /**
52
+ * The part of `@google-analytics/data` the GA4 adapter uses: pass the package's own class,
53
+ * `{ BetaAnalyticsDataClient }`. Written structurally, so an install without the package compiles.
54
+ */
55
+ interface Ga4Sdk {
56
+ BetaAnalyticsDataClient: new (options: Ga4ClientOptions) => Ga4Client;
57
+ }
58
+ /** An open MaxMind database: what it answers for one address is read field by field. */
59
+ interface MaxmindReader {
60
+ get(address: string): unknown;
61
+ }
62
+ /**
63
+ * The part of `maxmind` the geo resolver uses: pass the package's own `{ open }`. Written
64
+ * structurally, so an install without the package compiles.
65
+ */
66
+ interface MaxmindSdk {
67
+ open(database: string): Promise<MaxmindReader>;
68
+ }
69
+ /**
70
+ * Optional packages handed to the plugin rather than loaded by it: a runtime-loaded package escapes
71
+ * a standalone or serverless build's file tracing.
72
+ */
73
+ interface AnalyticsSdks {
74
+ /** `{ BetaAnalyticsDataClient }` from `@google-analytics/data`, for every GA4 source. */
75
+ ga4?: Ga4Sdk;
76
+ /** `{ open }` from `maxmind`, for the native engine's MaxMind geo lookups. */
77
+ maxmind?: MaxmindSdk;
78
+ }
79
+ //#endregion
80
+ export { AnalyticsSdks, Ga4Client, Ga4ClientOptions, Ga4ReportResponse, Ga4ReportRow, Ga4Sdk, MaxmindReader, MaxmindSdk };
81
+ //# sourceMappingURL=sdks.d.ts.map
@@ -0,0 +1,23 @@
1
+ import { hasMethods, isRecord, onlyKeys } from "./values.js";
2
+ //#region src/core/sdks.ts
3
+ /** `{ BetaAnalyticsDataClient }` as `sdks.ga4` and `ga4({ sdk })` take it. */
4
+ const isGa4Sdk = (value) => hasMethods(value, ["BetaAnalyticsDataClient"]);
5
+ /** `{ open }` as `sdks.maxmind` and `maxmindResolver({ sdk })` take it. */
6
+ const isMaxmindSdk = (value) => hasMethods(value, ["open"]);
7
+ /** `sdks`, checked at boot: a wrong shape would otherwise fail the first read instead. */
8
+ const resolveSdks = (option) => {
9
+ if (option === void 0) return {};
10
+ if (!isRecord(option) || Array.isArray(option)) throw new Error("analytics: sdks must be an object such as { ga4: { BetaAnalyticsDataClient } }");
11
+ onlyKeys(option, ["ga4", "maxmind"], "sdks");
12
+ const { ga4, maxmind } = option;
13
+ if (ga4 !== void 0 && !isGa4Sdk(ga4)) throw new Error("analytics: sdks.ga4 must be { BetaAnalyticsDataClient }, imported from '@google-analytics/data'");
14
+ if (maxmind !== void 0 && !isMaxmindSdk(maxmind)) throw new Error("analytics: sdks.maxmind must be { open }, imported from 'maxmind'");
15
+ return {
16
+ ...ga4 === void 0 ? {} : { ga4 },
17
+ ...maxmind === void 0 ? {} : { maxmind }
18
+ };
19
+ };
20
+ //#endregion
21
+ export { isGa4Sdk, isMaxmindSdk, resolveSdks };
22
+
23
+ //# sourceMappingURL=sdks.js.map