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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,68 +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 to stamp on one adapter query, or a refusal. Cross-scope reads fail closed
6
- * behind `platformRead`: the `'*'` marker, and any scoped read through a shared config
7
- * adapter that cannot narrow the query to one scope (whether or not it is the designated
8
- * platform adapter), which would otherwise answer with every scope's data. A tenant's own
9
- * runtime adapters are never gated. Every read path decides this here, so the widgets and
10
- * the query endpoint cannot drift apart on what counts as cross-scope.
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.
20
+ */
21
+ const resolveRequestedScope = async (args) => {
22
+ const { runtime, req } = args;
23
+ const gates = args.gates ?? scopeGates(runtime, req);
24
+ const named = typeof args.raw === "string" ? args.raw.trim() : "";
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
+ }
45
+ let scope;
46
+ try {
47
+ scope = await resolveScopeFor(runtime, req);
48
+ } catch {
49
+ return {
50
+ ok: false,
51
+ reason: "failed"
52
+ };
53
+ }
54
+ if (scope === "*" || scope === null) return (scope === "*" || runtime.scoped === true) && !await gates.aggregate({ scope }) ? {
55
+ ok: false,
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
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
+ }
228
+ return {
229
+ registry: await withScopeDefault({
230
+ runtime,
231
+ req,
232
+ resolved,
233
+ scope,
234
+ visible: filterRegistry(registry, (adapter) => keep.has(adapter.id))
235
+ }),
236
+ fallbackAdmitted
237
+ };
238
+ };
239
+ /**
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.
11
265
  */
12
266
  const resolveQueryScope = async (args) => {
13
267
  const { runtime, req, scope, adapter } = args;
14
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
15
- 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 };
16
270
  if (scope === null) return { ok: true };
17
- 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 };
18
275
  return {
19
276
  ok: true,
20
277
  queryScope: scope
21
278
  };
22
279
  };
23
280
  /**
24
- * Resolve one read's scope and adapter: explicit scope wins over the request's
25
- * resolved scope, the registry is resolved per scope, then the adapter is picked
26
- * by id (or the registry default). Cross-scope reads fail closed behind
27
- * `platformRead`: an explicit `'*'` scope always, any scoped read through a
28
- * shared config adapter that cannot narrow the query to one scope (whether or
29
- * not it is the designated platform adapter), and, on a scoped install, a
30
- * request that resolves no scope at all. That last case is ambiguous rather
31
- * than intentionally install-wide (a tenant's scopeResolver returning null
32
- * usually means "no tenant selected", not "read everything"), so it fails
33
- * closed the same way. An explicit `scope: null` override bypasses that gate:
34
- * it is the trusted server-side caller's path (cron passes, tests), never a
35
- * request's own resolution. A tenant's own runtime adapters are never gated.
36
- * Any resolution failure (unknown adapter id, a throwing scopeResolver or
37
- * provider lookup) degrades to `{ ok: false }` so read paths render their
38
- * 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.
39
330
  */
40
331
  const resolveReadContext = async (args) => {
41
332
  const { runtime, req, adapterId } = args;
42
- const allowed = platformReadGate(runtime, req);
333
+ const system = args.principal === SYSTEM;
334
+ const gates = system ? SYSTEM_GATES : scopeGates(runtime, req);
43
335
  try {
44
- const scope = args.scope !== void 0 ? args.scope : await resolveScopeFor(runtime, req);
45
- if (runtime.scoped && args.scope === void 0 && scope === null && !await allowed()) return { ok: false };
46
- const registryScope = scope === "*" ? null : scope;
47
- const registry = await resolveRegistryFor(runtime, {
48
- 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,
49
346
  req,
50
- 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 } : {}
51
355
  });
52
- 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;
53
364
  const decision = await resolveQueryScope({
54
365
  runtime,
55
366
  req,
56
367
  scope,
57
368
  adapter,
58
- platformRead: allowed
369
+ gates
59
370
  });
60
371
  if (!decision.ok) return { ok: false };
61
372
  return {
62
373
  ok: true,
63
374
  adapter,
64
375
  scope: registryScope,
65
- queryScope: decision.queryScope
376
+ queryScope: decision.queryScope,
377
+ pin,
378
+ ...substitutedFrom === void 0 ? {} : { substitutedFrom }
66
379
  };
67
380
  } catch (err) {
68
381
  req.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`);
@@ -70,6 +383,6 @@ const resolveReadContext = async (args) => {
70
383
  }
71
384
  };
72
385
  //#endregion
73
- export { resolveQueryScope, resolveReadContext };
386
+ export { needsUnscopedSourceAccess, resolveQueryScope, resolveReadContext, resolveRequestedScope, systemRegistryFor, visibleSourcesFor };
74
387
 
75
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 * 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). Cross-scope reads fail closed behind\n * `platformRead`: an explicit `'*'` scope always, any scoped read through a\n * shared config adapter that cannot narrow the query to one scope (whether or\n * not it is the designated platform adapter), and, on a scoped install, a\n * request that resolves no scope at all. That last case is ambiguous rather\n * than intentionally install-wide (a tenant's scopeResolver returning null\n * usually means \"no tenant selected\", not \"read everything\"), so it fails\n * 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\tconst scope = args.scope !== undefined ? args.scope : await resolveScopeFor(runtime, req)\n\t\tif (runtime.scoped && args.scope === undefined && scope === null && !(await allowed())) {\n\t\t\treturn { ok: false }\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":";;;;;;;;;;;AA8CA,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;;;;;;;;;;;;;;;;;;AAmBA,MAAa,qBAAqB,OAAO,SAAuD;CAC/F,MAAM,EAAE,SAAS,KAAK,cAAc;CACpC,MAAM,UAAU,iBAAiB,SAAS,GAAG;CAC7C,IAAI;EACH,MAAM,QAAQ,KAAK,UAAU,KAAA,IAAY,KAAK,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EACxF,IAAI,QAAQ,UAAU,KAAK,UAAU,KAAA,KAAa,UAAU,QAAQ,CAAE,MAAM,QAAQ,GACnF,OAAO,EAAE,IAAI,MAAM;EAEpB,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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sdks.js","names":[],"sources":["../../src/core/sdks.ts"],"sourcesContent":["import { hasMethods, isRecord, onlyKeys } from './values'\n\n/**\n * What the GA4 adapter hands the Data API client it builds. A type alias rather than an\n * interface: the SDK's `ClientOptions` carries an index signature, which an interface never meets.\n */\nexport type Ga4ClientOptions = {\n\tcredentials: { client_email: string; private_key: string }\n\tprojectId?: string\n}\n\n/**\n * One row of a GA4 report, as far as the adapter reads it.\n *\n * @beta\n */\nexport interface Ga4ReportRow {\n\tdimensionValues?: Array<{ value?: string | null }> | null\n\tmetricValues?: Array<{ value?: string | null }> | null\n}\n\n/**\n * A GA4 report as far as the adapter reads it, written out so no SDK type is needed.\n *\n * @beta\n */\nexport interface Ga4ReportResponse {\n\trows?: Ga4ReportRow[] | null\n\ttotals?: Ga4ReportRow[] | null\n\tmetadata?: {\n\t\tsamplingMetadatas?: unknown[] | null\n\t\tcurrencyCode?: string | null\n\t} | null\n}\n\n/**\n * The Data API client the GA4 adapter calls: the SDK's `BetaAnalyticsDataClient` is one.\n *\n * @beta\n */\nexport interface Ga4Client {\n\trunReport(\n\t\trequest: object,\n\t\toptions?: { timeout?: number; retry?: null }\n\t): Promise<[Ga4ReportResponse, ...unknown[]]>\n\tclose?(): Promise<void>\n}\n\n/**\n * The part of `@google-analytics/data` the GA4 adapter uses: pass the package's own class,\n * `{ BetaAnalyticsDataClient }`. Written structurally, so an install without the package compiles.\n */\nexport interface Ga4Sdk {\n\tBetaAnalyticsDataClient: new (options: Ga4ClientOptions) => Ga4Client\n}\n\n/** An open MaxMind database: what it answers for one address is read field by field. */\nexport interface MaxmindReader {\n\tget(address: string): unknown\n}\n\n/**\n * The part of `maxmind` the geo resolver uses: pass the package's own `{ open }`. Written\n * structurally, so an install without the package compiles.\n */\nexport interface MaxmindSdk {\n\topen(database: string): Promise<MaxmindReader>\n}\n\n/**\n * Optional packages handed to the plugin rather than loaded by it: a runtime-loaded package escapes\n * a standalone or serverless build's file tracing.\n */\nexport interface AnalyticsSdks {\n\t/** `{ BetaAnalyticsDataClient }` from `@google-analytics/data`, for every GA4 source. */\n\tga4?: Ga4Sdk\n\t/** `{ open }` from `maxmind`, for the native engine's MaxMind geo lookups. */\n\tmaxmind?: MaxmindSdk\n}\n\n/** `{ BetaAnalyticsDataClient }` as `sdks.ga4` and `ga4({ sdk })` take it. */\nexport const isGa4Sdk = (value: unknown): value is Ga4Sdk =>\n\thasMethods(value, ['BetaAnalyticsDataClient'])\n\n/** `{ open }` as `sdks.maxmind` and `maxmindResolver({ sdk })` take it. */\nexport const isMaxmindSdk = (value: unknown): value is MaxmindSdk => hasMethods(value, ['open'])\n\n/** `sdks`, checked at boot: a wrong shape would otherwise fail the first read instead. */\nexport const resolveSdks = (option: unknown): AnalyticsSdks => {\n\tif (option === undefined) {\n\t\treturn {}\n\t}\n\tif (!isRecord(option) || Array.isArray(option)) {\n\t\tthrow new Error(\n\t\t\t'analytics: sdks must be an object such as { ga4: { BetaAnalyticsDataClient } }'\n\t\t)\n\t}\n\tonlyKeys(option, ['ga4', 'maxmind'], 'sdks')\n\tconst { ga4, maxmind } = option\n\tif (ga4 !== undefined && !isGa4Sdk(ga4)) {\n\t\tthrow new Error(\n\t\t\t\"analytics: sdks.ga4 must be { BetaAnalyticsDataClient }, imported from '@google-analytics/data'\"\n\t\t)\n\t}\n\tif (maxmind !== undefined && !isMaxmindSdk(maxmind)) {\n\t\tthrow new Error(\"analytics: sdks.maxmind must be { open }, imported from 'maxmind'\")\n\t}\n\treturn { ...(ga4 === undefined ? {} : { ga4 }), ...(maxmind === undefined ? {} : { maxmind }) }\n}\n"],"mappings":";;;AAiFA,MAAa,YAAY,UACxB,WAAW,OAAO,CAAC,yBAAyB,CAAC;;AAG9C,MAAa,gBAAgB,UAAwC,WAAW,OAAO,CAAC,MAAM,CAAC;;AAG/F,MAAa,eAAe,WAAmC;CAC9D,IAAI,WAAW,KAAA,GACd,OAAO,CAAC;CAET,IAAI,CAAC,SAAS,MAAM,KAAK,MAAM,QAAQ,MAAM,GAC5C,MAAM,IAAI,MACT,gFACD;CAED,SAAS,QAAQ,CAAC,OAAO,SAAS,GAAG,MAAM;CAC3C,MAAM,EAAE,KAAK,YAAY;CACzB,IAAI,QAAQ,KAAA,KAAa,CAAC,SAAS,GAAG,GACrC,MAAM,IAAI,MACT,iGACD;CAED,IAAI,YAAY,KAAA,KAAa,CAAC,aAAa,OAAO,GACjD,MAAM,IAAI,MAAM,mEAAmE;CAEpF,OAAO;EAAE,GAAI,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,IAAI;EAAI,GAAI,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ;CAAG;AAC/F"}