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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1242) hide show
  1. package/CHANGELOG.md +470 -0
  2. package/LICENSE +21 -21
  3. package/README.md +30 -37
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +7 -9
  18. package/dist/adapters/ga4/disableKey.js.map +1 -1
  19. package/dist/adapters/ga4/eventName.d.ts +2 -8
  20. package/dist/adapters/ga4/eventName.js +2 -8
  21. package/dist/adapters/ga4/eventName.js.map +1 -1
  22. package/dist/adapters/ga4/ga4.d.ts +11 -0
  23. package/dist/adapters/ga4/ga4.js +206 -123
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +2 -3
  26. package/dist/adapters/ga4/measurementId.js.map +1 -1
  27. package/dist/adapters/goalRead.js +15 -29
  28. package/dist/adapters/goalRead.js.map +1 -1
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +13 -13
  37. package/dist/adapters/plausible/plausible.js +137 -122
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +20 -9
  42. package/dist/adapters/posthog/posthog.js +179 -113
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/readTime.js +7 -0
  45. package/dist/adapters/readTime.js.map +1 -0
  46. package/dist/adapters/series.js +14 -8
  47. package/dist/adapters/series.js.map +1 -1
  48. package/dist/adapters/umami/umami.d.ts +7 -9
  49. package/dist/adapters/umami/umami.js +184 -172
  50. package/dist/adapters/umami/umami.js.map +1 -1
  51. package/dist/adapters/upstream.js +16 -0
  52. package/dist/adapters/upstream.js.map +1 -0
  53. package/dist/binding/report.d.ts +8 -0
  54. package/dist/binding/report.js +24 -0
  55. package/dist/binding/report.js.map +1 -0
  56. package/dist/binding/resolvePath.js +16 -29
  57. package/dist/binding/resolvePath.js.map +1 -1
  58. package/dist/binding/types.d.ts +14 -29
  59. package/dist/capture/captureRequest.js +28 -0
  60. package/dist/capture/captureRequest.js.map +1 -0
  61. package/dist/capture/exclusionEndpoint.js +98 -0
  62. package/dist/capture/exclusionEndpoint.js.map +1 -0
  63. package/dist/capture/exclusionPrelude.js +14 -0
  64. package/dist/capture/exclusionPrelude.js.map +1 -0
  65. package/dist/capture/exclusionToken.js +23 -0
  66. package/dist/capture/exclusionToken.js.map +1 -0
  67. package/dist/capture/jsLiteral.js +19 -0
  68. package/dist/capture/jsLiteral.js.map +1 -0
  69. package/dist/capture/mountPath.js +2 -3
  70. package/dist/capture/mountPath.js.map +1 -1
  71. package/dist/capture/proxyEndpoint.js +48 -95
  72. package/dist/capture/proxyEndpoint.js.map +1 -1
  73. package/dist/capture/proxyRoutes.js +58 -21
  74. package/dist/capture/proxyRoutes.js.map +1 -1
  75. package/dist/capture/relay.js +91 -0
  76. package/dist/capture/relay.js.map +1 -0
  77. package/dist/capture/requestBody.js +2 -6
  78. package/dist/capture/requestBody.js.map +1 -1
  79. package/dist/capture/requestTrust.js +45 -0
  80. package/dist/capture/requestTrust.js.map +1 -0
  81. package/dist/capture/sameSite.js +40 -0
  82. package/dist/capture/sameSite.js.map +1 -0
  83. package/dist/capture/slots.js +50 -25
  84. package/dist/capture/slots.js.map +1 -1
  85. package/dist/capture/trackerConfig.js +100 -36
  86. package/dist/capture/trackerConfig.js.map +1 -1
  87. package/dist/capture/trackerEndpoint.js +22 -21
  88. package/dist/capture/trackerEndpoint.js.map +1 -1
  89. package/dist/charts/BarList.d.ts +27 -14
  90. package/dist/charts/BarList.js +38 -83
  91. package/dist/charts/BarList.js.map +1 -1
  92. package/dist/charts/TrendChart.d.ts +40 -7
  93. package/dist/charts/TrendChart.js +243 -215
  94. package/dist/charts/TrendChart.js.map +1 -1
  95. package/dist/charts/bars.d.ts +15 -1
  96. package/dist/charts/bars.js +12 -12
  97. package/dist/charts/bars.js.map +1 -1
  98. package/dist/charts/bucket.js +106 -73
  99. package/dist/charts/bucket.js.map +1 -1
  100. package/dist/charts/inProgress.js +22 -0
  101. package/dist/charts/inProgress.js.map +1 -0
  102. package/dist/charts/series.d.ts +15 -0
  103. package/dist/charts/series.js +123 -0
  104. package/dist/charts/series.js.map +1 -0
  105. package/dist/charts/spline.js +91 -25
  106. package/dist/charts/spline.js.map +1 -1
  107. package/dist/charts/trendGeometry.js +91 -0
  108. package/dist/charts/trendGeometry.js.map +1 -0
  109. package/dist/core/adminOptions.d.ts +1 -0
  110. package/dist/core/adminOptions.js +193 -0
  111. package/dist/core/adminOptions.js.map +1 -0
  112. package/dist/core/budget.js +24 -0
  113. package/dist/core/budget.js.map +1 -0
  114. package/dist/core/cacheKey.d.ts +1 -0
  115. package/dist/core/cacheKey.js +48 -37
  116. package/dist/core/cacheKey.js.map +1 -1
  117. package/dist/core/cacheOptions.js +165 -0
  118. package/dist/core/cacheOptions.js.map +1 -0
  119. package/dist/core/capabilities.d.ts +24 -11
  120. package/dist/core/capabilities.js +96 -17
  121. package/dist/core/capabilities.js.map +1 -1
  122. package/dist/core/capture.d.ts +26 -25
  123. package/dist/core/captureOptions.d.ts +1 -0
  124. package/dist/core/captureOptions.js +258 -0
  125. package/dist/core/captureOptions.js.map +1 -0
  126. package/dist/core/clock.js +13 -0
  127. package/dist/core/clock.js.map +1 -0
  128. package/dist/core/collectionOption.d.ts +17 -0
  129. package/dist/core/collectionOption.js +104 -0
  130. package/dist/core/collectionOption.js.map +1 -0
  131. package/dist/core/collectionSlug.js +7 -0
  132. package/dist/core/collectionSlug.js.map +1 -0
  133. package/dist/core/contract.d.ts +285 -59
  134. package/dist/core/contract.js +6 -4
  135. package/dist/core/contract.js.map +1 -1
  136. package/dist/core/cron.js +57 -0
  137. package/dist/core/cron.js.map +1 -0
  138. package/dist/core/fetch.d.ts +17 -0
  139. package/dist/core/goalOptions.d.ts +1 -0
  140. package/dist/core/goalOptions.js +166 -0
  141. package/dist/core/goalOptions.js.map +1 -0
  142. package/dist/core/granularity.js +3 -2
  143. package/dist/core/granularity.js.map +1 -1
  144. package/dist/core/guards.js +17 -0
  145. package/dist/core/guards.js.map +1 -0
  146. package/dist/core/jobs.d.ts +40 -0
  147. package/dist/core/jobs.js +132 -0
  148. package/dist/core/jobs.js.map +1 -0
  149. package/dist/core/legacyOptions.js +145 -0
  150. package/dist/core/legacyOptions.js.map +1 -0
  151. package/dist/core/metricAliases.js +81 -0
  152. package/dist/core/metricAliases.js.map +1 -0
  153. package/dist/core/metricValues.js +57 -0
  154. package/dist/core/metricValues.js.map +1 -0
  155. package/dist/core/monotonic.js +10 -0
  156. package/dist/core/monotonic.js.map +1 -0
  157. package/dist/core/optionChecks.js +51 -0
  158. package/dist/core/optionChecks.js.map +1 -0
  159. package/dist/core/options.d.ts +473 -157
  160. package/dist/core/options.js +154 -219
  161. package/dist/core/options.js.map +1 -1
  162. package/dist/core/registry.js +45 -5
  163. package/dist/core/registry.js.map +1 -1
  164. package/dist/core/scopeList.js +7 -9
  165. package/dist/core/scopeList.js.map +1 -1
  166. package/dist/core/scopeOptions.d.ts +1 -0
  167. package/dist/core/scopeOptions.js +112 -0
  168. package/dist/core/scopeOptions.js.map +1 -0
  169. package/dist/core/scopedRead.js +182 -72
  170. package/dist/core/scopedRead.js.map +1 -1
  171. package/dist/core/sdks.d.ts +81 -0
  172. package/dist/core/sdks.js +23 -0
  173. package/dist/core/sdks.js.map +1 -0
  174. package/dist/core/serverEvent.d.ts +38 -20
  175. package/dist/core/serverEvent.js.map +1 -1
  176. package/dist/core/siteAddress.js +20 -0
  177. package/dist/core/siteAddress.js.map +1 -0
  178. package/dist/core/sourceErrors.js +109 -0
  179. package/dist/core/sourceErrors.js.map +1 -0
  180. package/dist/core/sourceOptions.js +94 -0
  181. package/dist/core/sourceOptions.js.map +1 -0
  182. package/dist/core/throttle.js +18 -0
  183. package/dist/core/throttle.js.map +1 -0
  184. package/dist/core/values.js +61 -0
  185. package/dist/core/values.js.map +1 -0
  186. package/dist/core/widgetSlugs.d.ts +17 -0
  187. package/dist/core/widgetSlugs.js +29 -0
  188. package/dist/core/widgetSlugs.js.map +1 -0
  189. package/dist/db/detachedWrite.js +36 -0
  190. package/dist/db/detachedWrite.js.map +1 -0
  191. package/dist/db/errors.js +182 -0
  192. package/dist/db/errors.js.map +1 -0
  193. package/dist/db/kind.js +32 -0
  194. package/dist/db/kind.js.map +1 -0
  195. package/dist/db/openTransaction.js +51 -0
  196. package/dist/db/openTransaction.js.map +1 -0
  197. package/dist/exports/adapters/contract.d.ts +14 -0
  198. package/dist/exports/adapters/ga4.d.ts +15 -1
  199. package/dist/exports/adapters/native.d.ts +26 -2
  200. package/dist/exports/adapters/native.js +4 -1
  201. package/dist/exports/adapters/plausible.d.ts +15 -1
  202. package/dist/exports/adapters/posthog.d.ts +15 -1
  203. package/dist/exports/adapters/umami.d.ts +15 -1
  204. package/dist/exports/attributes.d.ts +42 -0
  205. package/dist/exports/attributes.js +83 -0
  206. package/dist/exports/attributes.js.map +1 -0
  207. package/dist/exports/client.d.ts +41 -13
  208. package/dist/exports/client.js +21 -9
  209. package/dist/exports/geo.d.ts +3 -1
  210. package/dist/exports/geo.js +1 -1
  211. package/dist/exports/i18n.d.ts +2 -2
  212. package/dist/exports/i18n.js +2 -2
  213. package/dist/exports/migrations.d.ts +2 -0
  214. package/dist/exports/migrations.js +2 -0
  215. package/dist/exports/next.d.ts +18 -1
  216. package/dist/exports/next.js +3 -1
  217. package/dist/exports/react.d.ts +3 -2
  218. package/dist/exports/react.js +1 -2
  219. package/dist/exports/rsc.d.ts +31 -14
  220. package/dist/exports/rsc.js +11 -6
  221. package/dist/exports/site.d.ts +5 -0
  222. package/dist/exports/site.js +3 -0
  223. package/dist/exports/testing.d.ts +17 -0
  224. package/dist/exports/testing.js +3 -0
  225. package/dist/exports/tracker.d.ts +5 -20
  226. package/dist/exports/tracker.js +3 -14
  227. package/dist/exports/types.d.ts +40 -14
  228. package/dist/exports/types.js +5 -1
  229. package/dist/fields/AnalyticsPanelClient.js +265 -154
  230. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  231. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  232. package/dist/fields/AnalyticsPanelField.js +121 -30
  233. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  234. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  235. package/dist/fields/AnalyticsStatField.js +98 -63
  236. package/dist/fields/AnalyticsStatField.js.map +1 -1
  237. package/dist/fields/FieldShimmer.js +15 -0
  238. package/dist/fields/FieldShimmer.js.map +1 -0
  239. package/dist/fields/PanelContent.js +217 -0
  240. package/dist/fields/PanelContent.js.map +1 -0
  241. package/dist/fields/PanelList.js +82 -0
  242. package/dist/fields/PanelList.js.map +1 -0
  243. package/dist/fields/PanelLiveCounter.js +63 -0
  244. package/dist/fields/PanelLiveCounter.js.map +1 -0
  245. package/dist/fields/PanelSkeleton.js +63 -0
  246. package/dist/fields/PanelSkeleton.js.map +1 -0
  247. package/dist/fields/componentPaths.js +8 -0
  248. package/dist/fields/componentPaths.js.map +1 -0
  249. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  250. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  251. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  252. package/dist/fields/config/FilterKeySelect.js +66 -0
  253. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  254. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  255. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  256. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterValueField.d.ts +17 -0
  258. package/dist/fields/config/FilterValueField.js +130 -0
  259. package/dist/fields/config/FilterValueField.js.map +1 -0
  260. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  261. package/dist/fields/config/MetricSelectField.js +18 -30
  262. package/dist/fields/config/MetricSelectField.js.map +1 -1
  263. package/dist/fields/config/OptionSelect.js +52 -0
  264. package/dist/fields/config/OptionSelect.js.map +1 -0
  265. package/dist/fields/config/SourceSelectField.js +16 -31
  266. package/dist/fields/config/SourceSelectField.js.map +1 -1
  267. package/dist/fields/config/fetchSources.js +14 -26
  268. package/dist/fields/config/fetchSources.js.map +1 -1
  269. package/dist/fields/config/filterValues.js +106 -0
  270. package/dist/fields/config/filterValues.js.map +1 -0
  271. package/dist/fields/config/narrow.js +8 -10
  272. package/dist/fields/config/narrow.js.map +1 -1
  273. package/dist/fields/config/retiredPickers.d.ts +45 -0
  274. package/dist/fields/config/retiredPickers.js +46 -0
  275. package/dist/fields/config/retiredPickers.js.map +1 -0
  276. package/dist/fields/config/scopedFields.d.ts +40 -0
  277. package/dist/fields/config/scopedFields.js +68 -0
  278. package/dist/fields/config/scopedFields.js.map +1 -0
  279. package/dist/fields/config/toSelectOption.js +13 -7
  280. package/dist/fields/config/toSelectOption.js.map +1 -1
  281. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  282. package/dist/fields/config/useAnalyticsSources.js +17 -21
  283. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  284. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  285. package/dist/fields/config/useFilterCapabilities.js +23 -15
  286. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  287. package/dist/fields/config/useFormString.js +12 -0
  288. package/dist/fields/config/useFormString.js.map +1 -0
  289. package/dist/fields/dateRange/field.js +7 -19
  290. package/dist/fields/dateRange/field.js.map +1 -1
  291. package/dist/fields/dateRange/types.d.ts +5 -1
  292. package/dist/fields/dateRange/ui.d.ts +3 -2
  293. package/dist/fields/dateRange/ui.js +57 -319
  294. package/dist/fields/dateRange/ui.js.map +1 -1
  295. package/dist/fields/documentScope.js +21 -0
  296. package/dist/fields/documentScope.js.map +1 -0
  297. package/dist/fields/emptyState.js +31 -26
  298. package/dist/fields/emptyState.js.map +1 -1
  299. package/dist/fields/factories.d.ts +35 -16
  300. package/dist/fields/factories.js +66 -37
  301. package/dist/fields/factories.js.map +1 -1
  302. package/dist/fields/format.d.ts +12 -3
  303. package/dist/fields/format.js +77 -13
  304. package/dist/fields/format.js.map +1 -1
  305. package/dist/fields/itemReport.js +45 -0
  306. package/dist/fields/itemReport.js.map +1 -0
  307. package/dist/fields/readForDocument.d.ts +78 -26
  308. package/dist/fields/readForDocument.js +446 -116
  309. package/dist/fields/readForDocument.js.map +1 -1
  310. package/dist/fields/stateKeys.js +20 -0
  311. package/dist/fields/stateKeys.js.map +1 -0
  312. package/dist/goals/GoalAmountField.d.ts +10 -0
  313. package/dist/goals/GoalAmountField.js +162 -0
  314. package/dist/goals/GoalAmountField.js.map +1 -0
  315. package/dist/goals/GoalSelectField.js +89 -40
  316. package/dist/goals/GoalSelectField.js.map +1 -1
  317. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  318. package/dist/goals/GoalSelectFieldServer.js +21 -0
  319. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  320. package/dist/goals/amountField.d.ts +20 -0
  321. package/dist/goals/amountField.js +37 -0
  322. package/dist/goals/amountField.js.map +1 -0
  323. package/dist/goals/builtin.js +17 -0
  324. package/dist/goals/builtin.js.map +1 -0
  325. package/dist/goals/collection.d.ts +22 -0
  326. package/dist/goals/collection.js +141 -100
  327. package/dist/goals/collection.js.map +1 -1
  328. package/dist/goals/constants.d.ts +38 -0
  329. package/dist/goals/constants.js +49 -0
  330. package/dist/goals/constants.js.map +1 -0
  331. package/dist/goals/currency.d.ts +16 -0
  332. package/dist/goals/currency.js +46 -4
  333. package/dist/goals/currency.js.map +1 -1
  334. package/dist/goals/currencyOptions.js +70 -0
  335. package/dist/goals/currencyOptions.js.map +1 -0
  336. package/dist/goals/fetchGoals.d.ts +10 -0
  337. package/dist/goals/fetchGoals.js +12 -26
  338. package/dist/goals/fetchGoals.js.map +1 -1
  339. package/dist/goals/goalField.d.ts +4 -6
  340. package/dist/goals/goalField.js +9 -19
  341. package/dist/goals/goalField.js.map +1 -1
  342. package/dist/goals/goalsEndpoint.js +39 -40
  343. package/dist/goals/goalsEndpoint.js.map +1 -1
  344. package/dist/goals/items.js +35 -0
  345. package/dist/goals/items.js.map +1 -0
  346. package/dist/goals/latent.js +9 -0
  347. package/dist/goals/latent.js.map +1 -0
  348. package/dist/goals/linkFields.d.ts +35 -0
  349. package/dist/goals/linkFields.js +31 -0
  350. package/dist/goals/linkFields.js.map +1 -0
  351. package/dist/goals/match.d.ts +14 -0
  352. package/dist/goals/match.js +67 -46
  353. package/dist/goals/match.js.map +1 -1
  354. package/dist/goals/moneyFields.js +56 -0
  355. package/dist/goals/moneyFields.js.map +1 -0
  356. package/dist/goals/pathMatch.js +122 -0
  357. package/dist/goals/pathMatch.js.map +1 -0
  358. package/dist/goals/placeholder.js +12 -0
  359. package/dist/goals/placeholder.js.map +1 -0
  360. package/dist/goals/resolver.d.ts +3 -3
  361. package/dist/goals/resolver.js +154 -46
  362. package/dist/goals/resolver.js.map +1 -1
  363. package/dist/goals/serverRevenue.d.ts +60 -0
  364. package/dist/goals/serverRevenue.js +41 -0
  365. package/dist/goals/serverRevenue.js.map +1 -0
  366. package/dist/goals/trackGoalAction.d.ts +26 -27
  367. package/dist/goals/trackGoalAction.js +38 -52
  368. package/dist/goals/trackGoalAction.js.map +1 -1
  369. package/dist/goals/types.d.ts +13 -28
  370. package/dist/goals/types.js +1 -1
  371. package/dist/goals/types.js.map +1 -1
  372. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  373. package/dist/goals/useAnalyticsGoals.js +17 -18
  374. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  375. package/dist/index.d.ts +63 -11
  376. package/dist/index.js +257 -247
  377. package/dist/index.js.map +1 -1
  378. package/dist/items/collectionIdType.js +20 -0
  379. package/dist/items/collectionIdType.js.map +1 -0
  380. package/dist/items/idType.js +31 -0
  381. package/dist/items/idType.js.map +1 -0
  382. package/dist/items/ref.js +73 -0
  383. package/dist/items/ref.js.map +1 -0
  384. package/dist/maintenance/apiTaskState.js +141 -0
  385. package/dist/maintenance/apiTaskState.js.map +1 -0
  386. package/dist/maintenance/heartbeat.js +51 -0
  387. package/dist/maintenance/heartbeat.js.map +1 -0
  388. package/dist/maintenance/lease.d.ts +1 -0
  389. package/dist/maintenance/lease.js +81 -0
  390. package/dist/maintenance/lease.js.map +1 -0
  391. package/dist/maintenance/taskSchedule.d.ts +1 -0
  392. package/dist/maintenance/taskSchedule.js +62 -0
  393. package/dist/maintenance/taskSchedule.js.map +1 -0
  394. package/dist/maintenance/underLease.js +35 -0
  395. package/dist/maintenance/underLease.js.map +1 -0
  396. package/dist/migrations/legacy.d.ts +54 -0
  397. package/dist/migrations/legacy.js +117 -0
  398. package/dist/migrations/legacy.js.map +1 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  401. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  402. package/dist/native/collections/aggregates.js +54 -0
  403. package/dist/native/collections/aggregates.js.map +1 -0
  404. package/dist/native/collections/hits.js +102 -0
  405. package/dist/native/collections/hits.js.map +1 -0
  406. package/dist/native/collections/slugs.d.ts +10 -0
  407. package/dist/native/collections/slugs.js +16 -0
  408. package/dist/native/collections/slugs.js.map +1 -0
  409. package/dist/native/collections/state.js +84 -0
  410. package/dist/native/collections/state.js.map +1 -0
  411. package/dist/native/collections/storeCollection.js +29 -0
  412. package/dist/native/collections/storeCollection.js.map +1 -0
  413. package/dist/native/engine/buckets.d.ts +1 -0
  414. package/dist/native/engine/buckets.js +53 -0
  415. package/dist/native/engine/buckets.js.map +1 -0
  416. package/dist/native/engine/capabilities.js +87 -0
  417. package/dist/native/engine/capabilities.js.map +1 -0
  418. package/dist/native/engine/cost.js +72 -0
  419. package/dist/native/engine/cost.js.map +1 -0
  420. package/dist/native/engine/days.d.ts +1 -0
  421. package/dist/native/engine/days.js +182 -0
  422. package/dist/native/engine/days.js.map +1 -0
  423. package/dist/native/engine/engine.d.ts +1 -0
  424. package/dist/native/engine/engine.js +1623 -0
  425. package/dist/native/engine/engine.js.map +1 -0
  426. package/dist/native/engine/instance.js +58 -0
  427. package/dist/native/engine/instance.js.map +1 -0
  428. package/dist/native/engine/maintenance.d.ts +1 -0
  429. package/dist/native/engine/maintenance.js +677 -0
  430. package/dist/native/engine/maintenance.js.map +1 -0
  431. package/dist/native/engine/merge.js +41 -0
  432. package/dist/native/engine/merge.js.map +1 -0
  433. package/dist/native/engine/nudge.js +26 -0
  434. package/dist/native/engine/nudge.js.map +1 -0
  435. package/dist/native/engine/planner.js +198 -0
  436. package/dist/native/engine/planner.js.map +1 -0
  437. package/dist/native/engine/rebuild.d.ts +22 -0
  438. package/dist/native/engine/rebuild.js +76 -0
  439. package/dist/native/engine/rebuild.js.map +1 -0
  440. package/dist/native/engine/recent.js +17 -0
  441. package/dist/native/engine/recent.js.map +1 -0
  442. package/dist/native/engine/salt.d.ts +1 -0
  443. package/dist/native/engine/salt.js +98 -0
  444. package/dist/native/engine/salt.js.map +1 -0
  445. package/dist/native/engine/siteHosts.d.ts +1 -0
  446. package/dist/native/engine/siteHosts.js +58 -0
  447. package/dist/native/engine/siteHosts.js.map +1 -0
  448. package/dist/native/engine/toHit.js +108 -0
  449. package/dist/native/engine/toHit.js.map +1 -0
  450. package/dist/native/engine/writeBuffer.d.ts +14 -0
  451. package/dist/native/engine/writeBuffer.js +317 -0
  452. package/dist/native/engine/writeBuffer.js.map +1 -0
  453. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  454. package/dist/native/geo/composeGeoResolvers.js +4 -1
  455. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  456. package/dist/native/geo/geoResolver.d.ts +20 -2
  457. package/dist/native/geo/geoResolver.js +42 -6
  458. package/dist/native/geo/geoResolver.js.map +1 -1
  459. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  460. package/dist/native/geo/maxmindResolver.js +20 -16
  461. package/dist/native/geo/maxmindResolver.js.map +1 -1
  462. package/dist/native/geo/resolveGeo.js +31 -0
  463. package/dist/native/geo/resolveGeo.js.map +1 -0
  464. package/dist/native/ingest/bots.d.ts +2 -3
  465. package/dist/native/ingest/bots.js +8 -13
  466. package/dist/native/ingest/bots.js.map +1 -1
  467. package/dist/native/ingest/browser.js +4 -6
  468. package/dist/native/ingest/browser.js.map +1 -1
  469. package/dist/native/ingest/clientIp.js +30 -9
  470. package/dist/native/ingest/clientIp.js.map +1 -1
  471. package/dist/native/ingest/device.js +4 -6
  472. package/dist/native/ingest/device.js.map +1 -1
  473. package/dist/native/ingest/endpoint.d.ts +1 -1
  474. package/dist/native/ingest/endpoint.js +119 -34
  475. package/dist/native/ingest/endpoint.js.map +1 -1
  476. package/dist/native/ingest/itemSignature.d.ts +26 -0
  477. package/dist/native/ingest/itemSignature.js +45 -0
  478. package/dist/native/ingest/itemSignature.js.map +1 -0
  479. package/dist/native/ingest/language.js +2 -3
  480. package/dist/native/ingest/language.js.map +1 -1
  481. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  482. package/dist/native/ingest/normalizeEvent.js +226 -61
  483. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  484. package/dist/native/ingest/orderSignature.d.ts +13 -0
  485. package/dist/native/ingest/orderSignature.js +50 -0
  486. package/dist/native/ingest/orderSignature.js.map +1 -0
  487. package/dist/native/ingest/referrer.js +30 -32
  488. package/dist/native/ingest/referrer.js.map +1 -1
  489. package/dist/native/ingest/requestHost.js +10 -23
  490. package/dist/native/ingest/requestHost.js.map +1 -1
  491. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  492. package/dist/native/ingest/resolveHostname.js +5 -6
  493. package/dist/native/ingest/resolveHostname.js.map +1 -1
  494. package/dist/native/ingest/revenue.d.ts +1 -0
  495. package/dist/native/ingest/revenue.js +121 -0
  496. package/dist/native/ingest/revenue.js.map +1 -0
  497. package/dist/native/ingest/route.d.ts +10 -0
  498. package/dist/native/ingest/route.js +82 -0
  499. package/dist/native/ingest/route.js.map +1 -0
  500. package/dist/native/ingest/serverTrack.d.ts +2 -10
  501. package/dist/native/ingest/serverTrack.js +181 -72
  502. package/dist/native/ingest/serverTrack.js.map +1 -1
  503. package/dist/native/ingest/signature.js +28 -0
  504. package/dist/native/ingest/signature.js.map +1 -0
  505. package/dist/native/ingest/source.d.ts +2 -3
  506. package/dist/native/ingest/source.js +35 -54
  507. package/dist/native/ingest/source.js.map +1 -1
  508. package/dist/native/ingest/utm.js +9 -9
  509. package/dist/native/ingest/utm.js.map +1 -1
  510. package/dist/native/ingest/validate.js +20 -10
  511. package/dist/native/ingest/validate.js.map +1 -1
  512. package/dist/native/ingest/visitorHash.js +6 -8
  513. package/dist/native/ingest/visitorHash.js.map +1 -1
  514. package/dist/native/nativeAdapter.d.ts +101 -33
  515. package/dist/native/nativeAdapter.js +375 -317
  516. package/dist/native/nativeAdapter.js.map +1 -1
  517. package/dist/native/rebuildDays.d.ts +12 -0
  518. package/dist/native/rebuildDays.js +16 -0
  519. package/dist/native/rebuildDays.js.map +1 -0
  520. package/dist/native/store/aggregate.js +450 -0
  521. package/dist/native/store/aggregate.js.map +1 -0
  522. package/dist/native/store/caps.d.ts +18 -0
  523. package/dist/native/store/caps.js +76 -0
  524. package/dist/native/store/caps.js.map +1 -0
  525. package/dist/native/store/chunks.js +34 -0
  526. package/dist/native/store/chunks.js.map +1 -0
  527. package/dist/native/store/columnValues.js +31 -0
  528. package/dist/native/store/columnValues.js.map +1 -0
  529. package/dist/native/store/dialect.js +106 -0
  530. package/dist/native/store/dialect.js.map +1 -0
  531. package/dist/native/store/eventStore.js +44 -0
  532. package/dist/native/store/eventStore.js.map +1 -0
  533. package/dist/native/store/hitRow.js +116 -0
  534. package/dist/native/store/hitRow.js.map +1 -0
  535. package/dist/native/store/hits.js +63 -0
  536. package/dist/native/store/hits.js.map +1 -0
  537. package/dist/native/store/ids.js +105 -0
  538. package/dist/native/store/ids.js.map +1 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  540. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  541. package/dist/native/store/mongo/mongoState.js +375 -0
  542. package/dist/native/store/mongo/mongoState.js.map +1 -0
  543. package/dist/native/store/mongo/mongoStore.js +618 -0
  544. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  545. package/dist/native/store/mongo/pipelines.js +695 -0
  546. package/dist/native/store/mongo/pipelines.js.map +1 -0
  547. package/dist/native/store/mongo/results.js +20 -0
  548. package/dist/native/store/mongo/results.js.map +1 -0
  549. package/dist/native/store/parts.d.ts +1 -0
  550. package/dist/native/store/parts.js +95 -0
  551. package/dist/native/store/parts.js.map +1 -0
  552. package/dist/native/store/pattern.js +213 -0
  553. package/dist/native/store/pattern.js.map +1 -0
  554. package/dist/native/store/rawRead.d.ts +23 -0
  555. package/dist/native/store/rawRead.js +384 -0
  556. package/dist/native/store/rawRead.js.map +1 -0
  557. package/dist/native/store/reclassify.js +53 -0
  558. package/dist/native/store/reclassify.js.map +1 -0
  559. package/dist/native/store/sql/aggregateSql.js +345 -0
  560. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  561. package/dist/native/store/sql/columns.js +48 -0
  562. package/dist/native/store/sql/columns.js.map +1 -0
  563. package/dist/native/store/sql/compile.js +656 -0
  564. package/dist/native/store/sql/compile.js.map +1 -0
  565. package/dist/native/store/sql/drivers.js +218 -0
  566. package/dist/native/store/sql/drivers.js.map +1 -0
  567. package/dist/native/store/sql/executor.js +132 -0
  568. package/dist/native/store/sql/executor.js.map +1 -0
  569. package/dist/native/store/sql/fragment.js +104 -0
  570. package/dist/native/store/sql/fragment.js.map +1 -0
  571. package/dist/native/store/sql/maintenanceSql.js +59 -0
  572. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  573. package/dist/native/store/sql/ownConnection.js +107 -0
  574. package/dist/native/store/sql/ownConnection.js.map +1 -0
  575. package/dist/native/store/sql/poolShare.js +101 -0
  576. package/dist/native/store/sql/poolShare.js.map +1 -0
  577. package/dist/native/store/sql/sqlState.js +325 -0
  578. package/dist/native/store/sql/sqlState.js.map +1 -0
  579. package/dist/native/store/sql/sqlStore.js +355 -0
  580. package/dist/native/store/sql/sqlStore.js.map +1 -0
  581. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  582. package/dist/native/store/sql/sqliteThread.js +314 -0
  583. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  584. package/dist/native/store/sql/sqliteWorker.js +327 -0
  585. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  587. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  588. package/dist/native/store/state.js +151 -0
  589. package/dist/native/store/state.js.map +1 -0
  590. package/dist/native/store/stateStore.js +29 -0
  591. package/dist/native/store/stateStore.js.map +1 -0
  592. package/dist/native/store/types.d.ts +9 -0
  593. package/dist/native/tasks/maintainTask.d.ts +19 -0
  594. package/dist/native/tasks/maintainTask.js +68 -0
  595. package/dist/native/tasks/maintainTask.js.map +1 -0
  596. package/dist/net/guardedFetch.d.ts +32 -0
  597. package/dist/net/guardedFetch.js +220 -0
  598. package/dist/net/guardedFetch.js.map +1 -0
  599. package/dist/net/origin.js +40 -0
  600. package/dist/net/origin.js.map +1 -0
  601. package/dist/net/platform.d.ts +9 -0
  602. package/dist/net/platform.js +35 -0
  603. package/dist/net/platform.js.map +1 -0
  604. package/dist/next/captureRewrites.d.ts +4 -24
  605. package/dist/next/captureRewrites.js +6 -50
  606. package/dist/next/captureRewrites.js.map +1 -1
  607. package/dist/next/captureRoute.d.ts +28 -0
  608. package/dist/next/captureRoute.js +67 -0
  609. package/dist/next/captureRoute.js.map +1 -0
  610. package/dist/next/ingestRoute.d.ts +17 -0
  611. package/dist/next/ingestRoute.js +17 -0
  612. package/dist/next/ingestRoute.js.map +1 -0
  613. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  614. package/dist/next/posthogProxyRewrites.js +5 -37
  615. package/dist/next/posthogProxyRewrites.js.map +1 -1
  616. package/dist/plugin/adminDependencies.js +34 -0
  617. package/dist/plugin/adminDependencies.js.map +1 -0
  618. package/dist/plugin/apiPath.js +23 -0
  619. package/dist/plugin/apiPath.js.map +1 -0
  620. package/dist/plugin/boundDocument.js +58 -0
  621. package/dist/plugin/boundDocument.js.map +1 -0
  622. package/dist/plugin/buildPhase.js +10 -0
  623. package/dist/plugin/buildPhase.js.map +1 -0
  624. package/dist/plugin/collectionChecks.js +232 -0
  625. package/dist/plugin/collectionChecks.js.map +1 -0
  626. package/dist/plugin/collectionFields.d.ts +13 -0
  627. package/dist/plugin/collectionFields.js +22 -0
  628. package/dist/plugin/collectionFields.js.map +1 -0
  629. package/dist/plugin/createRuntime.js +336 -0
  630. package/dist/plugin/createRuntime.js.map +1 -0
  631. package/dist/plugin/destroy.js +58 -0
  632. package/dist/plugin/destroy.js.map +1 -0
  633. package/dist/plugin/documentEndpoint.js +76 -53
  634. package/dist/plugin/documentEndpoint.js.map +1 -1
  635. package/dist/plugin/documentScopes.js +37 -0
  636. package/dist/plugin/documentScopes.js.map +1 -0
  637. package/dist/plugin/encrypted.js +25 -0
  638. package/dist/plugin/encrypted.js.map +1 -0
  639. package/dist/plugin/errors.d.ts +5 -12
  640. package/dist/plugin/errors.js +23 -16
  641. package/dist/plugin/errors.js.map +1 -1
  642. package/dist/plugin/flagsEndpoint.js +41 -0
  643. package/dist/plugin/flagsEndpoint.js.map +1 -0
  644. package/dist/plugin/goalHint.js +22 -11
  645. package/dist/plugin/goalHint.js.map +1 -1
  646. package/dist/plugin/itemLabels.js +114 -0
  647. package/dist/plugin/itemLabels.js.map +1 -0
  648. package/dist/plugin/jobsAccess.js +91 -0
  649. package/dist/plugin/jobsAccess.js.map +1 -0
  650. package/dist/plugin/keepAlive.js +48 -0
  651. package/dist/plugin/keepAlive.js.map +1 -0
  652. package/dist/plugin/peerImportError.js +3 -6
  653. package/dist/plugin/peerImportError.js.map +1 -1
  654. package/dist/plugin/peers.js +64 -0
  655. package/dist/plugin/peers.js.map +1 -0
  656. package/dist/plugin/pluginCollections.js +155 -0
  657. package/dist/plugin/pluginCollections.js.map +1 -0
  658. package/dist/plugin/queryEndpoint.js +69 -44
  659. package/dist/plugin/queryEndpoint.js.map +1 -1
  660. package/dist/plugin/queryParams.js +7 -0
  661. package/dist/plugin/queryParams.js.map +1 -0
  662. package/dist/plugin/readContextForRequest.js +52 -17
  663. package/dist/plugin/readContextForRequest.js.map +1 -1
  664. package/dist/plugin/readFailure.js +22 -0
  665. package/dist/plugin/readFailure.js.map +1 -0
  666. package/dist/plugin/readableProviders.js +64 -0
  667. package/dist/plugin/readableProviders.js.map +1 -0
  668. package/dist/plugin/realtimeEndpoint.js +77 -25
  669. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  670. package/dist/plugin/refreshEndpoint.js +69 -44
  671. package/dist/plugin/refreshEndpoint.js.map +1 -1
  672. package/dist/plugin/relabelFields.js +36 -0
  673. package/dist/plugin/relabelFields.js.map +1 -0
  674. package/dist/plugin/requestMemo.js +35 -0
  675. package/dist/plugin/requestMemo.js.map +1 -0
  676. package/dist/plugin/routeChecks.js +39 -0
  677. package/dist/plugin/routeChecks.js.map +1 -0
  678. package/dist/plugin/routes.d.ts +53 -0
  679. package/dist/plugin/routes.js +92 -0
  680. package/dist/plugin/routes.js.map +1 -0
  681. package/dist/plugin/runtime.d.ts +1 -1
  682. package/dist/plugin/runtime.js +226 -30
  683. package/dist/plugin/runtime.js.map +1 -1
  684. package/dist/plugin/schemaOnly.js +63 -0
  685. package/dist/plugin/schemaOnly.js.map +1 -0
  686. package/dist/plugin/scopeChange.js +6 -5
  687. package/dist/plugin/scopeChange.js.map +1 -1
  688. package/dist/plugin/scopeFieldBoot.js +4 -4
  689. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  690. package/dist/plugin/scopeToken.js +33 -0
  691. package/dist/plugin/scopeToken.js.map +1 -0
  692. package/dist/plugin/sourcesEndpoint.js +46 -12
  693. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  694. package/dist/plugin/unbundledLanguages.js +25 -0
  695. package/dist/plugin/unbundledLanguages.js.map +1 -0
  696. package/dist/plugin/walkFields.js +22 -0
  697. package/dist/plugin/walkFields.js.map +1 -0
  698. package/dist/plugin/warmTask.js +0 -0
  699. package/dist/plugin/warmTask.js.map +1 -1
  700. package/dist/providers/access.d.ts +1 -0
  701. package/dist/providers/access.js +35 -26
  702. package/dist/providers/access.js.map +1 -1
  703. package/dist/providers/adapterPool.js +121 -0
  704. package/dist/providers/adapterPool.js.map +1 -0
  705. package/dist/providers/collection.d.ts +53 -0
  706. package/dist/providers/collection.js +274 -150
  707. package/dist/providers/collection.js.map +1 -1
  708. package/dist/providers/factory.d.ts +76 -0
  709. package/dist/providers/factory.js +76 -23
  710. package/dist/providers/factory.js.map +1 -1
  711. package/dist/providers/hosts.d.ts +25 -0
  712. package/dist/providers/hosts.js +128 -0
  713. package/dist/providers/hosts.js.map +1 -0
  714. package/dist/providers/probe.d.ts +1 -0
  715. package/dist/providers/probe.js +101 -0
  716. package/dist/providers/probe.js.map +1 -0
  717. package/dist/providers/refresh.d.ts +18 -0
  718. package/dist/providers/refresh.js +49 -0
  719. package/dist/providers/refresh.js.map +1 -0
  720. package/dist/providers/registry.js +318 -0
  721. package/dist/providers/registry.js.map +1 -0
  722. package/dist/providers/resolver.js +23 -88
  723. package/dist/providers/resolver.js.map +1 -1
  724. package/dist/providers/retarget.js +45 -0
  725. package/dist/providers/retarget.js.map +1 -0
  726. package/dist/providers/secrets.d.ts +26 -0
  727. package/dist/providers/secrets.js +61 -4
  728. package/dist/providers/secrets.js.map +1 -1
  729. package/dist/providers/stampScope.js +9 -6
  730. package/dist/providers/stampScope.js.map +1 -1
  731. package/dist/query/dates.js +10 -12
  732. package/dist/query/dates.js.map +1 -1
  733. package/dist/query/errors.d.ts +1 -5
  734. package/dist/query/fetchQuery.d.ts +25 -32
  735. package/dist/query/fetchQuery.js +91 -91
  736. package/dist/query/fetchQuery.js.map +1 -1
  737. package/dist/query/limits.js +8 -0
  738. package/dist/query/limits.js.map +1 -0
  739. package/dist/query/parse.d.ts +6 -0
  740. package/dist/query/parse.js +153 -106
  741. package/dist/query/parse.js.map +1 -1
  742. package/dist/query/response.d.ts +23 -3
  743. package/dist/query/response.js +12 -5
  744. package/dist/query/response.js.map +1 -1
  745. package/dist/react/AnalyticsProvider.d.ts +26 -17
  746. package/dist/react/AnalyticsProvider.js +23 -22
  747. package/dist/react/AnalyticsProvider.js.map +1 -1
  748. package/dist/react/TrackerBoot.js +15 -9
  749. package/dist/react/TrackerBoot.js.map +1 -1
  750. package/dist/react/useAnalytics.d.ts +2 -11
  751. package/dist/react/useAnalytics.js +22 -24
  752. package/dist/react/useAnalytics.js.map +1 -1
  753. package/dist/site/AnalyticsScripts.d.ts +34 -0
  754. package/dist/site/AnalyticsScripts.js +30 -0
  755. package/dist/site/AnalyticsScripts.js.map +1 -0
  756. package/dist/site/getTrackerConfig.d.ts +15 -0
  757. package/dist/site/getTrackerConfig.js +40 -0
  758. package/dist/site/getTrackerConfig.js.map +1 -0
  759. package/dist/surfacing/afterRead.d.ts +37 -0
  760. package/dist/surfacing/bounded.js +38 -0
  761. package/dist/surfacing/bounded.js.map +1 -0
  762. package/dist/surfacing/breaker.js +107 -0
  763. package/dist/surfacing/breaker.js.map +1 -0
  764. package/dist/surfacing/cacheCollection.d.ts +8 -0
  765. package/dist/surfacing/cacheCollection.js +69 -0
  766. package/dist/surfacing/cacheCollection.js.map +1 -0
  767. package/dist/surfacing/cacheStore.d.ts +71 -1
  768. package/dist/surfacing/cacheStore.js +16 -37
  769. package/dist/surfacing/cacheStore.js.map +1 -1
  770. package/dist/surfacing/cacheSweep.d.ts +1 -0
  771. package/dist/surfacing/cacheSweep.js +59 -0
  772. package/dist/surfacing/cacheSweep.js.map +1 -0
  773. package/dist/surfacing/classifyError.js +282 -0
  774. package/dist/surfacing/classifyError.js.map +1 -0
  775. package/dist/surfacing/coalesce.js +2 -1
  776. package/dist/surfacing/coalesce.js.map +1 -1
  777. package/dist/surfacing/coldBudget.js +60 -0
  778. package/dist/surfacing/coldBudget.js.map +1 -0
  779. package/dist/surfacing/collectionCacheStore.js +183 -0
  780. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  781. package/dist/surfacing/engine.d.ts +1 -1
  782. package/dist/surfacing/engine.js +514 -72
  783. package/dist/surfacing/engine.js.map +1 -1
  784. package/dist/surfacing/epoch.js +70 -26
  785. package/dist/surfacing/epoch.js.map +1 -1
  786. package/dist/surfacing/lanes.d.ts +1 -0
  787. package/dist/surfacing/lanes.js +297 -0
  788. package/dist/surfacing/lanes.js.map +1 -0
  789. package/dist/surfacing/memo.js +40 -0
  790. package/dist/surfacing/memo.js.map +1 -0
  791. package/dist/surfacing/rateLimiter.d.ts +1 -0
  792. package/dist/surfacing/rateLimiter.js +69 -94
  793. package/dist/surfacing/rateLimiter.js.map +1 -1
  794. package/dist/surfacing/rebucket.js +178 -0
  795. package/dist/surfacing/rebucket.js.map +1 -0
  796. package/dist/surfacing/recipe.js +28 -0
  797. package/dist/surfacing/recipe.js.map +1 -0
  798. package/dist/surfacing/shape.js +22 -0
  799. package/dist/surfacing/shape.js.map +1 -0
  800. package/dist/surfacing/todaySplit.js +113 -0
  801. package/dist/surfacing/todaySplit.js.map +1 -0
  802. package/dist/sync/collection.d.ts +8 -0
  803. package/dist/sync/collection.js +28 -18
  804. package/dist/sync/collection.js.map +1 -1
  805. package/dist/sync/rekeyDurations.js +70 -0
  806. package/dist/sync/rekeyDurations.js.map +1 -0
  807. package/dist/sync/syncTask.js +226 -109
  808. package/dist/sync/syncTask.js.map +1 -1
  809. package/dist/testing/memoryAdapter.d.ts +6 -3
  810. package/dist/testing/memoryAdapter.js +12 -10
  811. package/dist/testing/memoryAdapter.js.map +1 -1
  812. package/dist/testing/settle.d.ts +11 -0
  813. package/dist/testing/settle.js +19 -0
  814. package/dist/testing/settle.js.map +1 -0
  815. package/dist/timeframe/calendar.js +65 -0
  816. package/dist/timeframe/calendar.js.map +1 -0
  817. package/dist/timeframe/comparison.js +46 -0
  818. package/dist/timeframe/comparison.js.map +1 -0
  819. package/dist/timeframe/presets.d.ts +1 -1
  820. package/dist/timeframe/presets.js +5 -5
  821. package/dist/timeframe/presets.js.map +1 -1
  822. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  823. package/dist/timeframe/reportingTimezone.js +64 -0
  824. package/dist/timeframe/reportingTimezone.js.map +1 -0
  825. package/dist/timeframe/tz.js +55 -39
  826. package/dist/timeframe/tz.js.map +1 -1
  827. package/dist/tracker/autoCapture.js +125 -38
  828. package/dist/tracker/autoCapture.js.map +1 -1
  829. package/dist/tracker/campaign.js +52 -0
  830. package/dist/tracker/campaign.js.map +1 -0
  831. package/dist/tracker/config.d.ts +144 -0
  832. package/dist/tracker/config.js +25 -0
  833. package/dist/tracker/config.js.map +1 -0
  834. package/dist/tracker/createTracker.d.ts +4 -10
  835. package/dist/tracker/createTracker.js +386 -115
  836. package/dist/tracker/createTracker.js.map +1 -1
  837. package/dist/tracker/digest.js +28 -0
  838. package/dist/tracker/digest.js.map +1 -0
  839. package/dist/tracker/engagement.js +100 -0
  840. package/dist/tracker/engagement.js.map +1 -0
  841. package/dist/tracker/events.js +37 -0
  842. package/dist/tracker/events.js.map +1 -0
  843. package/dist/tracker/exclusion.d.ts +2 -22
  844. package/dist/tracker/exclusion.js +53 -21
  845. package/dist/tracker/exclusion.js.map +1 -1
  846. package/dist/tracker/gate.js +194 -0
  847. package/dist/tracker/gate.js.map +1 -0
  848. package/dist/tracker/initTracker.d.ts +5 -8
  849. package/dist/tracker/initTracker.js +42 -14
  850. package/dist/tracker/initTracker.js.map +1 -1
  851. package/dist/tracker/itemCapture.js +224 -0
  852. package/dist/tracker/itemCapture.js.map +1 -0
  853. package/dist/tracker/loadScript.js +21 -14
  854. package/dist/tracker/loadScript.js.map +1 -1
  855. package/dist/tracker/pageTracking.js +6 -6
  856. package/dist/tracker/pageTracking.js.map +1 -1
  857. package/dist/tracker/registry.js +118 -30
  858. package/dist/tracker/registry.js.map +1 -1
  859. package/dist/tracker/sinks/createSink.js +38 -0
  860. package/dist/tracker/sinks/createSink.js.map +1 -0
  861. package/dist/tracker/sinks/ga4.js +64 -20
  862. package/dist/tracker/sinks/ga4.js.map +1 -1
  863. package/dist/tracker/sinks/native.js +7 -42
  864. package/dist/tracker/sinks/native.js.map +1 -1
  865. package/dist/tracker/sinks/plausible.js +27 -22
  866. package/dist/tracker/sinks/plausible.js.map +1 -1
  867. package/dist/tracker/sinks/posthog.js +26 -22
  868. package/dist/tracker/sinks/posthog.js.map +1 -1
  869. package/dist/tracker/sinks/umami.js +14 -12
  870. package/dist/tracker/sinks/umami.js.map +1 -1
  871. package/dist/tracker/sinks/vendor.js +30 -27
  872. package/dist/tracker/sinks/vendor.js.map +1 -1
  873. package/dist/tracker/skip.js +81 -0
  874. package/dist/tracker/skip.js.map +1 -0
  875. package/dist/tracker/storage.js +23 -0
  876. package/dist/tracker/storage.js.map +1 -0
  877. package/dist/tracker/transport.js +2 -5
  878. package/dist/tracker/transport.js.map +1 -1
  879. package/dist/tracker/types.d.ts +86 -63
  880. package/dist/tracker/window.js +7 -0
  881. package/dist/tracker/window.js.map +1 -0
  882. package/dist/translations/ar.js +226 -71
  883. package/dist/translations/ar.js.map +1 -1
  884. package/dist/translations/de.js +215 -69
  885. package/dist/translations/de.js.map +1 -1
  886. package/dist/translations/en.js +209 -67
  887. package/dist/translations/en.js.map +1 -1
  888. package/dist/translations/es.js +217 -68
  889. package/dist/translations/es.js.map +1 -1
  890. package/dist/translations/fr.js +221 -72
  891. package/dist/translations/fr.js.map +1 -1
  892. package/dist/translations/id.js +212 -67
  893. package/dist/translations/id.js.map +1 -1
  894. package/dist/translations/index.d.ts +1 -1
  895. package/dist/translations/index.js +5 -7
  896. package/dist/translations/index.js.map +1 -1
  897. package/dist/translations/intl.js +71 -0
  898. package/dist/translations/intl.js.map +1 -0
  899. package/dist/translations/keys.d.ts +185 -14
  900. package/dist/translations/keys.js +190 -14
  901. package/dist/translations/keys.js.map +1 -1
  902. package/dist/translations/ko.js +214 -69
  903. package/dist/translations/ko.js.map +1 -1
  904. package/dist/translations/labelMap.d.ts +10 -0
  905. package/dist/translations/labelMap.js +22 -0
  906. package/dist/translations/labelMap.js.map +1 -0
  907. package/dist/translations/metricKeys.js +10 -2
  908. package/dist/translations/metricKeys.js.map +1 -1
  909. package/dist/translations/parts.js +20 -0
  910. package/dist/translations/parts.js.map +1 -0
  911. package/dist/translations/plural.js +61 -0
  912. package/dist/translations/plural.js.map +1 -0
  913. package/dist/translations/pt.js +226 -77
  914. package/dist/translations/pt.js.map +1 -1
  915. package/dist/translations/ru.js +217 -66
  916. package/dist/translations/ru.js.map +1 -1
  917. package/dist/translations/server.d.ts +1 -0
  918. package/dist/translations/server.js +2 -3
  919. package/dist/translations/server.js.map +1 -1
  920. package/dist/translations/staticLabel.js +69 -0
  921. package/dist/translations/staticLabel.js.map +1 -0
  922. package/dist/translations/uk.js +217 -66
  923. package/dist/translations/uk.js.map +1 -1
  924. package/dist/translations/zh.js +212 -67
  925. package/dist/translations/zh.js.map +1 -1
  926. package/dist/ui/RangePicker.js +112 -0
  927. package/dist/ui/RangePicker.js.map +1 -0
  928. package/dist/ui/analytics.css +1528 -0
  929. package/dist/ui/calendarDays.js +27 -0
  930. package/dist/ui/calendarDays.js.map +1 -0
  931. package/dist/ui/classNames.js +7 -0
  932. package/dist/ui/classNames.js.map +1 -0
  933. package/dist/ui/components/Card.d.ts +28 -0
  934. package/dist/ui/components/Card.js +21 -0
  935. package/dist/ui/components/Card.js.map +1 -0
  936. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  937. package/dist/ui/components/ChartDataTable.js +48 -0
  938. package/dist/ui/components/ChartDataTable.js.map +1 -0
  939. package/dist/ui/components/DataTable.d.ts +82 -0
  940. package/dist/ui/components/DataTable.js +214 -0
  941. package/dist/ui/components/DataTable.js.map +1 -0
  942. package/dist/ui/components/LabeledSelect.js +62 -0
  943. package/dist/ui/components/LabeledSelect.js.map +1 -0
  944. package/dist/ui/components/LiveAnnouncement.js +21 -0
  945. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  946. package/dist/ui/components/MetricCard.d.ts +38 -0
  947. package/dist/ui/components/MetricCard.js +39 -0
  948. package/dist/ui/components/MetricCard.js.map +1 -0
  949. package/dist/ui/components/NoValue.js +22 -0
  950. package/dist/ui/components/NoValue.js.map +1 -0
  951. package/dist/ui/components/ReadState.js +27 -0
  952. package/dist/ui/components/ReadState.js.map +1 -0
  953. package/dist/ui/components/RefreshButton.js +26 -0
  954. package/dist/ui/components/RefreshButton.js.map +1 -0
  955. package/dist/ui/cssVars.js +7 -0
  956. package/dist/ui/cssVars.js.map +1 -0
  957. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  958. package/dist/ui/data/WithScopeToken.js +20 -0
  959. package/dist/ui/data/WithScopeToken.js.map +1 -0
  960. package/dist/ui/data/clientFieldProps.js +16 -0
  961. package/dist/ui/data/clientFieldProps.js.map +1 -0
  962. package/dist/ui/data/request.d.ts +46 -0
  963. package/dist/ui/data/request.js +119 -0
  964. package/dist/ui/data/request.js.map +1 -0
  965. package/dist/ui/data/scopeTokenContext.js +18 -0
  966. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  967. package/dist/ui/data/sharedCache.js +48 -0
  968. package/dist/ui/data/sharedCache.js.map +1 -0
  969. package/dist/ui/data/useRequest.d.ts +19 -0
  970. package/dist/ui/data/useRequest.js +123 -0
  971. package/dist/ui/data/useRequest.js.map +1 -0
  972. package/dist/ui/data/useRequestScope.js +25 -0
  973. package/dist/ui/data/useRequestScope.js.map +1 -0
  974. package/dist/ui/hooks/useDirection.js +47 -0
  975. package/dist/ui/hooks/useDirection.js.map +1 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  977. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  979. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  980. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  981. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  982. package/dist/ui/readState.js +19 -0
  983. package/dist/ui/readState.js.map +1 -0
  984. package/dist/ui/rows/toDisplayRows.js +49 -0
  985. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  986. package/dist/ui/viewerClock.js +7 -0
  987. package/dist/ui/viewerClock.js.map +1 -0
  988. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  989. package/dist/view/AnalyticsNavLink.js +11 -6
  990. package/dist/view/AnalyticsNavLink.js.map +1 -1
  991. package/dist/view/AnalyticsView.d.ts +8 -10
  992. package/dist/view/AnalyticsView.js +47 -18
  993. package/dist/view/AnalyticsView.js.map +1 -1
  994. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  995. package/dist/view/AnalyticsViewClient.js +15 -229
  996. package/dist/view/AnalyticsViewClient.js.map +1 -1
  997. package/dist/view/CountryFlag.d.ts +27 -0
  998. package/dist/view/CountryFlag.js +44 -0
  999. package/dist/view/CountryFlag.js.map +1 -0
  1000. package/dist/view/DocumentTitle.js +27 -0
  1001. package/dist/view/DocumentTitle.js.map +1 -0
  1002. package/dist/view/ViewRoot.d.ts +21 -0
  1003. package/dist/view/ViewRoot.js +150 -0
  1004. package/dist/view/ViewRoot.js.map +1 -0
  1005. package/dist/view/ViewSections.d.ts +38 -0
  1006. package/dist/view/ViewSections.js +190 -0
  1007. package/dist/view/ViewSections.js.map +1 -0
  1008. package/dist/view/authRedirect.js +2 -4
  1009. package/dist/view/authRedirect.js.map +1 -1
  1010. package/dist/view/conversionRate.js +9 -7
  1011. package/dist/view/conversionRate.js.map +1 -1
  1012. package/dist/view/dayRange.js +6 -10
  1013. package/dist/view/dayRange.js.map +1 -1
  1014. package/dist/view/exclusionLink.d.ts +27 -0
  1015. package/dist/view/exclusionLink.js +46 -0
  1016. package/dist/view/exclusionLink.js.map +1 -0
  1017. package/dist/view/flagSrc.js +14 -0
  1018. package/dist/view/flagSrc.js.map +1 -0
  1019. package/dist/view/gating.d.ts +15 -1
  1020. package/dist/view/gating.js +66 -31
  1021. package/dist/view/gating.js.map +1 -1
  1022. package/dist/view/hostCountryFlag.js +41 -0
  1023. package/dist/view/hostCountryFlag.js.map +1 -0
  1024. package/dist/view/labels.js +95 -10
  1025. package/dist/view/labels.js.map +1 -1
  1026. package/dist/view/metricAliases.js +10 -0
  1027. package/dist/view/metricAliases.js.map +1 -0
  1028. package/dist/view/navLabel.js +15 -0
  1029. package/dist/view/navLabel.js.map +1 -0
  1030. package/dist/view/registerView.js +10 -9
  1031. package/dist/view/registerView.js.map +1 -1
  1032. package/dist/view/scopeLabel.js +21 -0
  1033. package/dist/view/scopeLabel.js.map +1 -0
  1034. package/dist/view/sections/Breakdowns.js +196 -134
  1035. package/dist/view/sections/Breakdowns.js.map +1 -1
  1036. package/dist/view/sections/EmptyStates.js +118 -30
  1037. package/dist/view/sections/EmptyStates.js.map +1 -1
  1038. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1039. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1040. package/dist/view/sections/FilterChips.js +124 -27
  1041. package/dist/view/sections/FilterChips.js.map +1 -1
  1042. package/dist/view/sections/GoalsPanel.js +68 -60
  1043. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1044. package/dist/view/sections/OverviewCards.js +29 -33
  1045. package/dist/view/sections/OverviewCards.js.map +1 -1
  1046. package/dist/view/sections/RealtimeStrip.js +70 -59
  1047. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1048. package/dist/view/sections/SectionBoundary.js +34 -0
  1049. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1050. package/dist/view/sections/Toolbar.d.ts +11 -0
  1051. package/dist/view/sections/Toolbar.js +123 -82
  1052. package/dist/view/sections/Toolbar.js.map +1 -1
  1053. package/dist/view/sections/Trend.js +176 -76
  1054. package/dist/view/sections/Trend.js.map +1 -1
  1055. package/dist/view/state.d.ts +42 -0
  1056. package/dist/view/state.js +93 -54
  1057. package/dist/view/state.js.map +1 -1
  1058. package/dist/view/useViewClock.js +31 -0
  1059. package/dist/view/useViewClock.js.map +1 -0
  1060. package/dist/view/useViewQueries.d.ts +21 -0
  1061. package/dist/view/useViewQueries.js +45 -77
  1062. package/dist/view/useViewQueries.js.map +1 -1
  1063. package/dist/view/useViewState.js +42 -0
  1064. package/dist/view/useViewState.js.map +1 -0
  1065. package/dist/view/useViewUrl.js +47 -0
  1066. package/dist/view/useViewUrl.js.map +1 -0
  1067. package/dist/view/viewBody.js +30 -0
  1068. package/dist/view/viewBody.js.map +1 -0
  1069. package/dist/view/viewContext.d.ts +81 -0
  1070. package/dist/view/viewContext.js +49 -0
  1071. package/dist/view/viewContext.js.map +1 -0
  1072. package/dist/view/viewProps.d.ts +64 -7
  1073. package/dist/view/viewProps.js +121 -35
  1074. package/dist/view/viewProps.js.map +1 -1
  1075. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1077. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1078. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1079. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1080. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1081. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1082. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1083. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1084. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1086. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1087. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1088. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1089. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1090. package/dist/widgets/ComparisonDelta.js +33 -42
  1091. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1092. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1093. package/dist/widgets/RealtimeCounter.js +91 -77
  1094. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1095. package/dist/widgets/WidgetCard.d.ts +80 -0
  1096. package/dist/widgets/WidgetCard.js +99 -0
  1097. package/dist/widgets/WidgetCard.js.map +1 -0
  1098. package/dist/widgets/WidgetFrame.js +42 -0
  1099. package/dist/widgets/WidgetFrame.js.map +1 -0
  1100. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1101. package/dist/widgets/WidgetShimmer.js +86 -0
  1102. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1103. package/dist/widgets/breakdownTypes.js +12 -2
  1104. package/dist/widgets/breakdownTypes.js.map +1 -1
  1105. package/dist/widgets/customWidget.d.ts +5 -1
  1106. package/dist/widgets/customWidget.js +6 -7
  1107. package/dist/widgets/customWidget.js.map +1 -1
  1108. package/dist/widgets/defaults.d.ts +4 -7
  1109. package/dist/widgets/defaults.js +4 -7
  1110. package/dist/widgets/defaults.js.map +1 -1
  1111. package/dist/widgets/fieldRows.js +14 -0
  1112. package/dist/widgets/fieldRows.js.map +1 -0
  1113. package/dist/widgets/filterCaption.js +6 -7
  1114. package/dist/widgets/filterCaption.js.map +1 -1
  1115. package/dist/widgets/filterField.d.ts +3 -7
  1116. package/dist/widgets/filterField.js +46 -35
  1117. package/dist/widgets/filterField.js.map +1 -1
  1118. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1119. package/dist/widgets/filterValueLabel.js +45 -0
  1120. package/dist/widgets/filterValueLabel.js.map +1 -0
  1121. package/dist/widgets/notices.js +73 -0
  1122. package/dist/widgets/notices.js.map +1 -0
  1123. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1124. package/dist/widgets/prepareWidgetRead.js +59 -27
  1125. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1126. package/dist/widgets/range.js +26 -21
  1127. package/dist/widgets/range.js.map +1 -1
  1128. package/dist/widgets/readForWidget.d.ts +27 -18
  1129. package/dist/widgets/readForWidget.js +31 -29
  1130. package/dist/widgets/readForWidget.js.map +1 -1
  1131. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1132. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1133. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1134. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1135. package/dist/widgets/readForWidgetGoals.js +50 -46
  1136. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1137. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1138. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1139. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1140. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1141. package/dist/widgets/readForWidgetSeries.js +43 -82
  1142. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1143. package/dist/widgets/readMeta.d.ts +44 -0
  1144. package/dist/widgets/readMeta.js +47 -4
  1145. package/dist/widgets/readMeta.js.map +1 -1
  1146. package/dist/widgets/realtimePoll.d.ts +1 -0
  1147. package/dist/widgets/realtimePoll.js +53 -25
  1148. package/dist/widgets/realtimePoll.js.map +1 -1
  1149. package/dist/widgets/registerWidgets.js +204 -126
  1150. package/dist/widgets/registerWidgets.js.map +1 -1
  1151. package/dist/widgets/stateKeys.js +30 -0
  1152. package/dist/widgets/stateKeys.js.map +1 -0
  1153. package/dist/widgets/titleForecast.js +89 -0
  1154. package/dist/widgets/titleForecast.js.map +1 -0
  1155. package/dist/widgets/types.d.ts +4 -3
  1156. package/dist/widgets/types.js +2 -0
  1157. package/dist/widgets/types.js.map +1 -1
  1158. package/dist/widgets/viewLink.d.ts +24 -6
  1159. package/dist/widgets/viewLink.js +31 -24
  1160. package/dist/widgets/viewLink.js.map +1 -1
  1161. package/dist/widgets/widgetData.js +34 -0
  1162. package/dist/widgets/widgetData.js.map +1 -0
  1163. package/dist/widgets/widgetWindow.d.ts +1 -0
  1164. package/dist/widgets/widgetWindow.js +51 -0
  1165. package/dist/widgets/widgetWindow.js.map +1 -0
  1166. package/package.json +44 -22
  1167. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1168. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1169. package/dist/capture/getTrackerConfig.js +0 -31
  1170. package/dist/capture/getTrackerConfig.js.map +0 -1
  1171. package/dist/capture/slots.d.ts +0 -8
  1172. package/dist/capture/trackerConfig.d.ts +0 -33
  1173. package/dist/charts/styles.js +0 -59
  1174. package/dist/charts/styles.js.map +0 -1
  1175. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1176. package/dist/fields/dateRange/styles.js +0 -23
  1177. package/dist/fields/dateRange/styles.js.map +0 -1
  1178. package/dist/goals/GoalSelectField.d.ts +0 -7
  1179. package/dist/native/collections/events.js +0 -165
  1180. package/dist/native/collections/events.js.map +0 -1
  1181. package/dist/native/collections/rollups.js +0 -151
  1182. package/dist/native/collections/rollups.js.map +0 -1
  1183. package/dist/native/collections/seen.js +0 -47
  1184. package/dist/native/collections/seen.js.map +0 -1
  1185. package/dist/native/eventScan.js +0 -25
  1186. package/dist/native/eventScan.js.map +0 -1
  1187. package/dist/native/ingest/flushBatch.js +0 -60
  1188. package/dist/native/ingest/flushBatch.js.map +0 -1
  1189. package/dist/native/ingest/salt.js +0 -39
  1190. package/dist/native/ingest/salt.js.map +0 -1
  1191. package/dist/native/ingest/writeBuffer.js +0 -55
  1192. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1193. package/dist/native/ingest/writeEvent.js +0 -14
  1194. package/dist/native/ingest/writeEvent.js.map +0 -1
  1195. package/dist/native/query/eventAgg.js +0 -175
  1196. package/dist/native/query/eventAgg.js.map +0 -1
  1197. package/dist/native/realtime/buildRealtime.js +0 -53
  1198. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1199. package/dist/native/retention/pruneTask.js +0 -69
  1200. package/dist/native/retention/pruneTask.js.map +0 -1
  1201. package/dist/native/rollupAcc.js +0 -64
  1202. package/dist/native/rollupAcc.js.map +0 -1
  1203. package/dist/native/rollups/bucketKey.js +0 -15
  1204. package/dist/native/rollups/bucketKey.js.map +0 -1
  1205. package/dist/native/rollups/bumpRollups.js +0 -116
  1206. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1207. package/dist/native/rollups/deltas.js +0 -106
  1208. package/dist/native/rollups/deltas.js.map +0 -1
  1209. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1210. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1211. package/dist/plugin/paths.js +0 -29
  1212. package/dist/plugin/paths.js.map +0 -1
  1213. package/dist/react/TrackerBoot.d.ts +0 -22
  1214. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1215. package/dist/rsc/AnalyticsScripts.js +0 -41
  1216. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1217. package/dist/surfacing/queue.js +0 -60
  1218. package/dist/surfacing/queue.js.map +0 -1
  1219. package/dist/surfacing/retryPolicy.js +0 -15
  1220. package/dist/surfacing/retryPolicy.js.map +0 -1
  1221. package/dist/tracker/autoCapture.d.ts +0 -48
  1222. package/dist/tracker/consent.d.ts +0 -24
  1223. package/dist/tracker/consent.js +0 -48
  1224. package/dist/tracker/consent.js.map +0 -1
  1225. package/dist/tracker/loadScript.d.ts +0 -14
  1226. package/dist/tracker/pageTracking.d.ts +0 -17
  1227. package/dist/tracker/registry.d.ts +0 -27
  1228. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1229. package/dist/tracker/sinks/native.d.ts +0 -22
  1230. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1231. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1232. package/dist/tracker/sinks/umami.d.ts +0 -18
  1233. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1234. package/dist/view/sections/styles.js +0 -76
  1235. package/dist/view/sections/styles.js.map +0 -1
  1236. package/dist/widgets/WidgetViewLink.js +0 -17
  1237. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1238. package/dist/widgets/cardChrome.d.ts +0 -8
  1239. package/dist/widgets/cardChrome.js +0 -46
  1240. package/dist/widgets/cardChrome.js.map +0 -1
  1241. package/dist/widgets/comparison.js +0 -57
  1242. package/dist/widgets/comparison.js.map +0 -1
@@ -1,9 +1,49 @@
1
1
  //#region src/core/registry.ts
2
- /** Wrap a config-time registry as a resolver: every scope sees the same adapters. */
3
- const staticRegistryResolver = (registry) => () => Promise.resolve(registry);
2
+ /** The grants of a registry no provider document adds to. */
3
+ const NO_GRANTS = /* @__PURE__ */ new Map();
4
+ /**
5
+ * The registry minus the adapters `keep` rejects, or null when it rejects all. The default survives
6
+ * only if kept.
7
+ */
8
+ const filterRegistry = (registry, keep) => {
9
+ const kept = registry.all().filter(keep);
10
+ if (kept.length === 0) return null;
11
+ if (kept.length === registry.all().length) return registry;
12
+ const defaultId = registry.default().id;
13
+ return createRegistry(kept, kept.some((a) => a.id === defaultId) ? defaultId : void 0);
14
+ };
15
+ /**
16
+ * Each adapter's copy without revenue, made once: reads reach a source through a lane keyed on the
17
+ * adapter object, so one adapter must narrow to one object however many registries are built.
18
+ */
19
+ const withoutRevenueCopies = /* @__PURE__ */ new WeakMap();
20
+ const dropRevenue = (adapter) => {
21
+ if (!adapter.capabilities.metrics.has("revenue")) return adapter;
22
+ const made = withoutRevenueCopies.get(adapter);
23
+ if (made) return made;
24
+ const copy = {
25
+ ...adapter,
26
+ capabilities: {
27
+ ...adapter.capabilities,
28
+ metrics: new Set([...adapter.capabilities.metrics].filter((metric) => metric !== "revenue"))
29
+ }
30
+ };
31
+ withoutRevenueCopies.set(adapter, copy);
32
+ return copy;
33
+ };
34
+ /**
35
+ * The registry with `revenue` gone from every adapter: the one place an install measuring no money
36
+ * hides the metric from every reader at once.
37
+ */
38
+ const withoutRevenue = (registry) => {
39
+ const all = registry.all();
40
+ if (!all.some((adapter) => adapter.capabilities.metrics.has("revenue"))) return registry;
41
+ return createRegistry(all.map(dropRevenue), registry.default().id);
42
+ };
43
+ /** A registry over `adapters`, reading through `defaultId` or else the first when none is named. */
4
44
  function createRegistry(adapters, defaultId) {
5
- if (adapters.length === 0) throw new Error("analytics: at least one adapter is required");
6
- const first = adapters[0];
45
+ const [first] = adapters;
46
+ if (first === void 0) throw new Error("analytics: at least one adapter is required");
7
47
  const byId = new Map(adapters.map((a) => [a.id, a]));
8
48
  if (defaultId !== void 0 && !byId.has(defaultId)) throw new Error(`analytics: unknown default adapter "${defaultId}"`);
9
49
  const fallback = defaultId ?? first.id;
@@ -19,6 +59,6 @@ function createRegistry(adapters, defaultId) {
19
59
  };
20
60
  }
21
61
  //#endregion
22
- export { createRegistry, staticRegistryResolver };
62
+ export { NO_GRANTS, createRegistry, filterRegistry, withoutRevenue };
23
63
 
24
64
  //# sourceMappingURL=registry.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"registry.js","names":[],"sources":["../../src/core/registry.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from './contract'\n\nexport interface AdapterRegistry {\n\tget(id: string): AnalyticsAdapter\n\tdefault(): AnalyticsAdapter\n\tall(): AnalyticsAdapter[]\n\tisMultiProvider(): boolean\n}\n\nexport type ResolveRegistryArgs = {\n\tpayload: Payload\n\treq?: PayloadRequest\n\t/** The analytics boundary to resolve adapters for; null is the whole install. */\n\tscope: string | null\n}\n\n/**\n * The seam every read path resolves its adapters through. The static config\n * registry is the base for all scopes; runtime provider sources (collection,\n * `providers.resolve`) layer per-scope adapters on top of it.\n */\nexport type RegistryResolver = (args: ResolveRegistryArgs) => Promise<AdapterRegistry>\n\n/** Wrap a config-time registry as a resolver: every scope sees the same adapters. */\nexport const staticRegistryResolver =\n\t(registry: AdapterRegistry): RegistryResolver =>\n\t() =>\n\t\tPromise.resolve(registry)\n\nexport function createRegistry(adapters: AnalyticsAdapter[], defaultId?: string): AdapterRegistry {\n\tif (adapters.length === 0) throw new Error('analytics: at least one adapter is required')\n\tconst first = adapters[0] as AnalyticsAdapter\n\tconst byId = new Map(adapters.map((a) => [a.id, a]))\n\tif (defaultId !== undefined && !byId.has(defaultId)) {\n\t\tthrow new Error(`analytics: unknown default adapter \"${defaultId}\"`)\n\t}\n\tconst fallback = defaultId ?? first.id\n\treturn {\n\t\tget(id) {\n\t\t\tconst a = byId.get(id)\n\t\t\tif (!a) throw new Error(`analytics: unknown adapter \"${id}\"`)\n\t\t\treturn a\n\t\t},\n\t\tdefault: () => byId.get(fallback) ?? first,\n\t\tall: () => adapters,\n\t\tisMultiProvider: () => adapters.length > 1,\n\t}\n}\n"],"mappings":";;AAyBA,MAAa,0BACX,mBAEA,QAAQ,QAAQ,QAAQ;AAE1B,SAAgB,eAAe,UAA8B,WAAqC;CACjG,IAAI,SAAS,WAAW,GAAG,MAAM,IAAI,MAAM,6CAA6C;CACxF,MAAM,QAAQ,SAAS;CACvB,MAAM,OAAO,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;CACnD,IAAI,cAAc,KAAA,KAAa,CAAC,KAAK,IAAI,SAAS,GACjD,MAAM,IAAI,MAAM,uCAAuC,UAAU,EAAE;CAEpE,MAAM,WAAW,aAAa,MAAM;CACpC,OAAO;EACN,IAAI,IAAI;GACP,MAAM,IAAI,KAAK,IAAI,EAAE;GACrB,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,+BAA+B,GAAG,EAAE;GAC5D,OAAO;EACR;EACA,eAAe,KAAK,IAAI,QAAQ,KAAK;EACrC,WAAW;EACX,uBAAuB,SAAS,SAAS;CAC1C;AACD"}
1
+ {"version":3,"file":"registry.js","names":[],"sources":["../../src/core/registry.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { AnalyticsAdapter } from './contract'\n\nexport interface AdapterRegistry {\n\tget(id: string): AnalyticsAdapter\n\tdefault(): AnalyticsAdapter\n\tall(): AnalyticsAdapter[]\n\tisMultiProvider(): boolean\n}\n\nexport type ResolveRegistryArgs = {\n\tpayload: Payload\n\treq?: PayloadRequest\n\t/** The analytics boundary to resolve adapters for; null is the whole install. */\n\tscope: string | null\n}\n\n/**\n * One scope's adapters, and which its own provider documents put there. A `native` document grants\n * the config native adapter, so a granted id can name a config adapter.\n */\nexport interface ScopeRegistry {\n\tregistry: AdapterRegistry\n\t/** Adapter id to the id of the provider document granting it to this scope. */\n\tgrants: ReadonlyMap<string, string>\n}\n\n/** The grants of a registry no provider document adds to. */\nexport const NO_GRANTS: ReadonlyMap<string, string> = new Map()\n\n/**\n * The seam every read resolves its adapters through: the config registry for all scopes, with\n * runtime provider sources layered per scope on top.\n */\nexport type RegistryResolver = (args: ResolveRegistryArgs) => Promise<ScopeRegistry>\n\n/**\n * The registry minus the adapters `keep` rejects, or null when it rejects all. The default survives\n * only if kept.\n */\nexport const filterRegistry = (\n\tregistry: AdapterRegistry,\n\tkeep: (adapter: AnalyticsAdapter) => boolean\n): AdapterRegistry | null => {\n\tconst kept = registry.all().filter(keep)\n\tif (kept.length === 0) {\n\t\treturn null\n\t}\n\tif (kept.length === registry.all().length) {\n\t\treturn registry\n\t}\n\tconst defaultId = registry.default().id\n\treturn createRegistry(kept, kept.some((a) => a.id === defaultId) ? defaultId : undefined)\n}\n\n/**\n * Each adapter's copy without revenue, made once: reads reach a source through a lane keyed on the\n * adapter object, so one adapter must narrow to one object however many registries are built.\n */\nconst withoutRevenueCopies = new WeakMap<AnalyticsAdapter, AnalyticsAdapter>()\n\nconst dropRevenue = (adapter: AnalyticsAdapter): AnalyticsAdapter => {\n\tif (!adapter.capabilities.metrics.has('revenue')) {\n\t\treturn adapter\n\t}\n\tconst made = withoutRevenueCopies.get(adapter)\n\tif (made) {\n\t\treturn made\n\t}\n\tconst copy: AnalyticsAdapter = {\n\t\t...adapter,\n\t\tcapabilities: {\n\t\t\t...adapter.capabilities,\n\t\t\tmetrics: new Set([...adapter.capabilities.metrics].filter((metric) => metric !== 'revenue')),\n\t\t},\n\t}\n\twithoutRevenueCopies.set(adapter, copy)\n\treturn copy\n}\n\n/**\n * The registry with `revenue` gone from every adapter: the one place an install measuring no money\n * hides the metric from every reader at once.\n */\nexport const withoutRevenue = (registry: AdapterRegistry): AdapterRegistry => {\n\tconst all = registry.all()\n\tif (!all.some((adapter) => adapter.capabilities.metrics.has('revenue'))) {\n\t\treturn registry\n\t}\n\treturn createRegistry(all.map(dropRevenue), registry.default().id)\n}\n\n/** A registry over `adapters`, reading through `defaultId` or else the first when none is named. */\nexport function createRegistry(adapters: AnalyticsAdapter[], defaultId?: string): AdapterRegistry {\n\tconst [first] = adapters\n\tif (first === undefined) throw new Error('analytics: at least one adapter is required')\n\tconst byId = new Map(adapters.map((a) => [a.id, a]))\n\tif (defaultId !== undefined && !byId.has(defaultId)) {\n\t\tthrow new Error(`analytics: unknown default adapter \"${defaultId}\"`)\n\t}\n\tconst fallback = defaultId ?? first.id\n\treturn {\n\t\tget(id) {\n\t\t\tconst a = byId.get(id)\n\t\t\tif (!a) throw new Error(`analytics: unknown adapter \"${id}\"`)\n\t\t\treturn a\n\t\t},\n\t\tdefault: () => byId.get(fallback) ?? first,\n\t\tall: () => adapters,\n\t\tisMultiProvider: () => adapters.length > 1,\n\t}\n}\n"],"mappings":";;AA4BA,MAAa,4BAAyC,IAAI,IAAI;;;;;AAY9D,MAAa,kBACZ,UACA,SAC4B;CAC5B,MAAM,OAAO,SAAS,IAAI,EAAE,OAAO,IAAI;CACvC,IAAI,KAAK,WAAW,GACnB,OAAO;CAER,IAAI,KAAK,WAAW,SAAS,IAAI,EAAE,QAClC,OAAO;CAER,MAAM,YAAY,SAAS,QAAQ,EAAE;CACrC,OAAO,eAAe,MAAM,KAAK,MAAM,MAAM,EAAE,OAAO,SAAS,IAAI,YAAY,KAAA,CAAS;AACzF;;;;;AAMA,MAAM,uCAAuB,IAAI,QAA4C;AAE7E,MAAM,eAAe,YAAgD;CACpE,IAAI,CAAC,QAAQ,aAAa,QAAQ,IAAI,SAAS,GAC9C,OAAO;CAER,MAAM,OAAO,qBAAqB,IAAI,OAAO;CAC7C,IAAI,MACH,OAAO;CAER,MAAM,OAAyB;EAC9B,GAAG;EACH,cAAc;GACb,GAAG,QAAQ;GACX,SAAS,IAAI,IAAI,CAAC,GAAG,QAAQ,aAAa,OAAO,EAAE,QAAQ,WAAW,WAAW,SAAS,CAAC;EAC5F;CACD;CACA,qBAAqB,IAAI,SAAS,IAAI;CACtC,OAAO;AACR;;;;;AAMA,MAAa,kBAAkB,aAA+C;CAC7E,MAAM,MAAM,SAAS,IAAI;CACzB,IAAI,CAAC,IAAI,MAAM,YAAY,QAAQ,aAAa,QAAQ,IAAI,SAAS,CAAC,GACrE,OAAO;CAER,OAAO,eAAe,IAAI,IAAI,WAAW,GAAG,SAAS,QAAQ,EAAE,EAAE;AAClE;;AAGA,SAAgB,eAAe,UAA8B,WAAqC;CACjG,MAAM,CAAC,SAAS;CAChB,IAAI,UAAU,KAAA,GAAW,MAAM,IAAI,MAAM,6CAA6C;CACtF,MAAM,OAAO,IAAI,IAAI,SAAS,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;CACnD,IAAI,cAAc,KAAA,KAAa,CAAC,KAAK,IAAI,SAAS,GACjD,MAAM,IAAI,MAAM,uCAAuC,UAAU,EAAE;CAEpE,MAAM,WAAW,aAAa,MAAM;CACpC,OAAO;EACN,IAAI,IAAI;GACP,MAAM,IAAI,KAAK,IAAI,EAAE;GACrB,IAAI,CAAC,GAAG,MAAM,IAAI,MAAM,+BAA+B,GAAG,EAAE;GAC5D,OAAO;EACR;EACA,eAAe,KAAK,IAAI,QAAQ,KAAK;EACrC,WAAW;EACX,uBAAuB,SAAS,SAAS;CAC1C;AACD"}
@@ -1,19 +1,17 @@
1
1
  //#region src/core/scopeList.ts
2
2
  /**
3
- * Resolves the scopes a cron tier (warm, sync) fans out over: the install-wide
4
- * null scope first, then each tenant scope from `scopes()`, deduplicated (an
5
- * empty string folds into null). A throwing or rejecting resolver degrades to
6
- * the null-only pass so one tenant-enumeration bug does not block the whole run.
3
+ * The scopes the sync task fans out over: null first, then each tenant from `scope.list`,
4
+ * deduplicated. A failing resolver degrades to the null-only pass rather than blocking the run.
7
5
  */
8
- const resolveScopeList = async (scopes, payload) => {
9
- if (!scopes) return [null];
6
+ const resolveScopeList = async (list, payload) => {
7
+ if (!list) return [null];
10
8
  let raw;
11
9
  try {
12
- const result = await scopes({ payload });
13
- if (!Array.isArray(result)) throw new Error("scopes() must resolve to an array of scope ids");
10
+ const result = await list({ payload });
11
+ if (!Array.isArray(result)) throw new Error("scope.list must resolve to an array of scope ids");
14
12
  raw = result;
15
13
  } catch (err) {
16
- payload.logger.warn(`analytics: scopes() failed, falling back to the install-wide scope: ${String(err)}`);
14
+ payload.logger.warn(`analytics: scope.list failed, falling back to the install-wide scope: ${String(err)}`);
17
15
  return [null];
18
16
  }
19
17
  const out = [null];
@@ -1 +1 @@
1
- {"version":3,"file":"scopeList.js","names":[],"sources":["../../src/core/scopeList.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport type { ScopesResolver } from './options'\n\n/**\n * Resolves the scopes a cron tier (warm, sync) fans out over: the install-wide\n * null scope first, then each tenant scope from `scopes()`, deduplicated (an\n * empty string folds into null). A throwing or rejecting resolver degrades to\n * the null-only pass so one tenant-enumeration bug does not block the whole run.\n */\nexport const resolveScopeList = async (\n\tscopes: ScopesResolver | undefined,\n\tpayload: Payload\n): Promise<Array<string | null>> => {\n\tif (!scopes) {\n\t\treturn [null]\n\t}\n\tlet raw: string[]\n\ttry {\n\t\tconst result = await scopes({ payload })\n\t\tif (!Array.isArray(result)) {\n\t\t\tthrow new Error('scopes() must resolve to an array of scope ids')\n\t\t}\n\t\traw = result\n\t} catch (err) {\n\t\tpayload.logger.warn(\n\t\t\t`analytics: scopes() failed, falling back to the install-wide scope: ${String(err)}`\n\t\t)\n\t\treturn [null]\n\t}\n\tconst out: Array<string | null> = [null]\n\tconst seen = new Set<string | null>([null])\n\tfor (const value of raw) {\n\t\tconst scope = value === '' ? null : value\n\t\tif (seen.has(scope)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(scope)\n\t\tout.push(scope)\n\t}\n\treturn out\n}\n"],"mappings":";;;;;;;AASA,MAAa,mBAAmB,OAC/B,QACA,YACmC;CACnC,IAAI,CAAC,QACJ,OAAO,CAAC,IAAI;CAEb,IAAI;CACJ,IAAI;EACH,MAAM,SAAS,MAAM,OAAO,EAAE,QAAQ,CAAC;EACvC,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,MAAM,IAAI,MAAM,gDAAgD;EAEjE,MAAM;CACP,SAAS,KAAK;EACb,QAAQ,OAAO,KACd,uEAAuE,OAAO,GAAG,GAClF;EACA,OAAO,CAAC,IAAI;CACb;CACA,MAAM,MAA4B,CAAC,IAAI;CACvC,MAAM,OAAO,IAAI,IAAmB,CAAC,IAAI,CAAC;CAC1C,KAAK,MAAM,SAAS,KAAK;EACxB,MAAM,QAAQ,UAAU,KAAK,OAAO;EACpC,IAAI,KAAK,IAAI,KAAK,GACjB;EAED,KAAK,IAAI,KAAK;EACd,IAAI,KAAK,KAAK;CACf;CACA,OAAO;AACR"}
1
+ {"version":3,"file":"scopeList.js","names":[],"sources":["../../src/core/scopeList.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport type { ScopeListResolver } from './options'\n\n/**\n * The scopes the sync task fans out over: null first, then each tenant from `scope.list`,\n * deduplicated. A failing resolver degrades to the null-only pass rather than blocking the run.\n */\nexport const resolveScopeList = async (\n\tlist: ScopeListResolver | undefined,\n\tpayload: Payload\n): Promise<Array<string | null>> => {\n\tif (!list) {\n\t\treturn [null]\n\t}\n\tlet raw: string[]\n\ttry {\n\t\tconst result = await list({ payload })\n\t\tif (!Array.isArray(result)) {\n\t\t\tthrow new Error('scope.list must resolve to an array of scope ids')\n\t\t}\n\t\traw = result\n\t} catch (err) {\n\t\tpayload.logger.warn(\n\t\t\t`analytics: scope.list failed, falling back to the install-wide scope: ${String(err)}`\n\t\t)\n\t\treturn [null]\n\t}\n\tconst out: Array<string | null> = [null]\n\tconst seen = new Set<string | null>([null])\n\tfor (const value of raw) {\n\t\tconst scope = value === '' ? null : value\n\t\tif (seen.has(scope)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(scope)\n\t\tout.push(scope)\n\t}\n\treturn out\n}\n"],"mappings":";;;;;AAOA,MAAa,mBAAmB,OAC/B,MACA,YACmC;CACnC,IAAI,CAAC,MACJ,OAAO,CAAC,IAAI;CAEb,IAAI;CACJ,IAAI;EACH,MAAM,SAAS,MAAM,KAAK,EAAE,QAAQ,CAAC;EACrC,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,MAAM,IAAI,MAAM,kDAAkD;EAEnE,MAAM;CACP,SAAS,KAAK;EACb,QAAQ,OAAO,KACd,yEAAyE,OAAO,GAAG,GACpF;EACA,OAAO,CAAC,IAAI;CACb;CACA,MAAM,MAA4B,CAAC,IAAI;CACvC,MAAM,OAAO,IAAI,IAAmB,CAAC,IAAI,CAAC;CAC1C,KAAK,MAAM,SAAS,KAAK;EACxB,MAAM,QAAQ,UAAU,KAAK,OAAO;EACpC,IAAI,KAAK,IAAI,KAAK,GACjB;EAED,KAAK,IAAI,KAAK;EACd,IAAI,KAAK,KAAK;CACf;CACA,OAAO;AACR"}
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,112 @@
1
+ import { isAdminUser } from "../access/adminUser.js";
2
+ import "./contract.js";
3
+ import { isRecord, kindOf } from "./values.js";
4
+ import { keysOf, optionalFunction, optionsObject } from "./optionChecks.js";
5
+ //#region src/core/scopeOptions.ts
6
+ const SCOPE_KEYS = keysOf({
7
+ resolve: true,
8
+ member: true,
9
+ list: true,
10
+ label: true
11
+ });
12
+ const ACCESS_KEYS = keysOf({
13
+ read: true,
14
+ view: true,
15
+ crossScope: true
16
+ });
17
+ const CROSS_SCOPE_GATES = keysOf({
18
+ named: true,
19
+ aggregate: true,
20
+ unscopedSource: true
21
+ });
22
+ const MEMBER_REQUIRED = "analytics: scope.member is required with scope.resolve. scope.resolve picks which scope a request is for; scope.member decides whether its user belongs to that scope, and every read and every write to the plugin's collections asks it. With @payloadcms/plugin-multi-tenant, pass tenantMembership() from '@10x-media/analytics'. Pass () => true only when scope.resolve derives the scope from req.user itself, so a user can never select a scope they do not belong to.";
23
+ /** One access function for all three cross-scope gates, which is what the function form means. */
24
+ const allCrossScope = (access) => ({
25
+ named: access,
26
+ aggregate: access,
27
+ unscopedSource: access
28
+ });
29
+ /** The `'*'` marker is a reader's request for every scope, never a request's own scope. */
30
+ const refusingWildcard = (resolve) => async (args) => {
31
+ const scope = await resolve(args);
32
+ if (scope === "*") throw new Error(`analytics: scope.resolve returned "*", which names every scope at once; return one scope id, or null for the install-wide scope`);
33
+ return scope;
34
+ };
35
+ /** `scope`: unset resolves every request to the install-wide scope; set, it needs `member`. */
36
+ const resolveScope = (option) => {
37
+ if (option !== void 0) optionsObject(option, {
38
+ path: "scope",
39
+ known: SCOPE_KEYS,
40
+ example: "an object such as { resolve, member }"
41
+ });
42
+ const resolve = optionalFunction(option?.resolve, "scope.resolve");
43
+ const list = optionalFunction(option?.list, "scope.list");
44
+ const label = optionalFunction(option?.label, "scope.label");
45
+ const member = optionalFunction(option?.member, "scope.member");
46
+ if (!resolve) return { resolve: () => null };
47
+ if (member === void 0) throw new Error(MEMBER_REQUIRED);
48
+ return {
49
+ resolve: refusingWildcard(resolve),
50
+ member,
51
+ ...list ? { list } : {},
52
+ ...label ? { label } : {}
53
+ };
54
+ };
55
+ /**
56
+ * Refuses the options that only mean something on a scoped install: an unscoped config carrying one
57
+ * almost always forgot `scope.resolve`, so it fails the boot rather than doing nothing.
58
+ */
59
+ const assertScopedOnlyOptions = (options) => {
60
+ const paths = [];
61
+ for (const key of [
62
+ "list",
63
+ "label",
64
+ "member"
65
+ ]) if (options.scope?.[key] !== void 0) paths.push(`scope.${key}`);
66
+ if (options.access?.crossScope !== void 0) paths.push("access.crossScope");
67
+ if (typeof options.capture?.slots?.tenant === "string") paths.push("capture.slots.tenant");
68
+ if (options.capture?.paths?.tenant !== void 0) paths.push("capture.paths.tenant");
69
+ for (const [slug, binding] of Object.entries(options.collections ?? {})) if (binding?.scopeField !== void 0 && binding.scopeField !== false) paths.push(`collections.${slug}.scopeField`);
70
+ const goalsCollection = Array.isArray(options.goals) ? void 0 : options.goals?.collection;
71
+ if (isRecord(goalsCollection) && goalsCollection.scopeField !== void 0) paths.push("goals.collection.scopeField");
72
+ const providersCollection = options.providers?.collection;
73
+ if (isRecord(providersCollection) && providersCollection.scopeField !== void 0) paths.push("providers.collection.scopeField");
74
+ if (paths.length > 0) {
75
+ const one = paths.length === 1;
76
+ throw new Error(`analytics: ${paths.join(", ")} ${one ? "only applies" : "only apply"} to a scoped install. Set scope.resolve, or remove ${one ? "it" : "them"}.`);
77
+ }
78
+ };
79
+ /** Unset gates deny on a scoped install and admit `isAdminUser` on an unscoped one. */
80
+ const resolveCrossScope = (option, scoped) => {
81
+ const fallback = scoped ? () => false : isAdminUser;
82
+ if (option === void 0) return allCrossScope(fallback);
83
+ if (typeof option === "function") return allCrossScope(option);
84
+ if (!isRecord(option)) throw new Error(`analytics: access.crossScope must be a function or an object, got ${kindOf(option)}`);
85
+ for (const [gate, access] of Object.entries(option)) {
86
+ if (!CROSS_SCOPE_GATES.includes(gate)) throw new Error(`analytics: access.crossScope has no "${gate}" gate; the gates are named, aggregate and unscopedSource`);
87
+ if (access !== void 0 && typeof access !== "function") throw new Error(`analytics: access.crossScope.${gate} must be a function`);
88
+ }
89
+ return {
90
+ named: option.named ?? fallback,
91
+ aggregate: option.aggregate ?? fallback,
92
+ unscopedSource: option.unscopedSource ?? fallback
93
+ };
94
+ };
95
+ /** `access`: the read gate, the view gate (the read gate unless set) and the cross-scope gates. */
96
+ const resolveAccess = (option, scoped) => {
97
+ if (option !== void 0) optionsObject(option, {
98
+ path: "access",
99
+ known: ACCESS_KEYS,
100
+ example: "an object such as { read: isAdminUser }"
101
+ });
102
+ const read = optionalFunction(option?.read, "access.read") ?? isAdminUser;
103
+ return {
104
+ read,
105
+ view: optionalFunction(option?.view, "access.view") ?? read,
106
+ crossScope: resolveCrossScope(option?.crossScope, scoped)
107
+ };
108
+ };
109
+ //#endregion
110
+ export { allCrossScope, assertScopedOnlyOptions, resolveAccess, resolveScope };
111
+
112
+ //# sourceMappingURL=scopeOptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopeOptions.js","names":[],"sources":["../../src/core/scopeOptions.ts"],"sourcesContent":["import { isAdminUser } from '../access/adminUser'\nimport type { ScopeDecision } from '../plugin/runtime'\nimport { PLATFORM_SCOPE } from './contract'\nimport { keysOf, optionalFunction, optionsObject } from './optionChecks'\nimport type {\n\tAnalyticsAccessOptions,\n\tAnalyticsPluginOptions,\n\tAnalyticsReadAccess,\n\tAnalyticsScopeOptions,\n\tCrossScopeAccess,\n\tResolvedCrossScope,\n\tResolvedOptions,\n\tResolvedScope,\n\tScopeResolver,\n} from './options'\nimport { isRecord, kindOf } from './values'\n\nconst SCOPE_KEYS = keysOf<AnalyticsScopeOptions>({\n\tresolve: true,\n\tmember: true,\n\tlist: true,\n\tlabel: true,\n})\n\nconst ACCESS_KEYS = keysOf<AnalyticsAccessOptions>({ read: true, view: true, crossScope: true })\n\nconst CROSS_SCOPE_GATES = keysOf<Record<ScopeDecision, true>>({\n\tnamed: true,\n\taggregate: true,\n\tunscopedSource: true,\n})\n\nconst MEMBER_REQUIRED =\n\t\"analytics: scope.member is required with scope.resolve. scope.resolve picks which scope a request is for; scope.member decides whether its user belongs to that scope, and every read and every write to the plugin's collections asks it. With @payloadcms/plugin-multi-tenant, pass tenantMembership() from '@10x-media/analytics'. Pass () => true only when scope.resolve derives the scope from req.user itself, so a user can never select a scope they do not belong to.\"\n\n/** One access function for all three cross-scope gates, which is what the function form means. */\nexport const allCrossScope = (access: CrossScopeAccess): ResolvedCrossScope => ({\n\tnamed: access,\n\taggregate: access,\n\tunscopedSource: access,\n})\n\n/** The `'*'` marker is a reader's request for every scope, never a request's own scope. */\nconst refusingWildcard =\n\t(resolve: ScopeResolver): ScopeResolver =>\n\tasync (args) => {\n\t\tconst scope = await resolve(args)\n\t\tif (scope === PLATFORM_SCOPE) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: scope.resolve returned \"${PLATFORM_SCOPE}\", which names every scope at once; return one scope id, or null for the install-wide scope`\n\t\t\t)\n\t\t}\n\t\treturn scope\n\t}\n\n/** `scope`: unset resolves every request to the install-wide scope; set, it needs `member`. */\nexport const resolveScope = (option: AnalyticsPluginOptions['scope']): ResolvedScope => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'scope',\n\t\t\tknown: SCOPE_KEYS,\n\t\t\texample: 'an object such as { resolve, member }',\n\t\t})\n\t}\n\tconst resolve = optionalFunction(option?.resolve, 'scope.resolve')\n\tconst list = optionalFunction(option?.list, 'scope.list')\n\tconst label = optionalFunction(option?.label, 'scope.label')\n\tconst member = optionalFunction(option?.member, 'scope.member')\n\tif (!resolve) {\n\t\treturn { resolve: () => null }\n\t}\n\tif (member === undefined) {\n\t\tthrow new Error(MEMBER_REQUIRED)\n\t}\n\treturn {\n\t\tresolve: refusingWildcard(resolve),\n\t\tmember,\n\t\t...(list ? { list } : {}),\n\t\t...(label ? { label } : {}),\n\t}\n}\n\n/**\n * Refuses the options that only mean something on a scoped install: an unscoped config carrying one\n * almost always forgot `scope.resolve`, so it fails the boot rather than doing nothing.\n */\nexport const assertScopedOnlyOptions = (options: AnalyticsPluginOptions): void => {\n\tconst paths: string[] = []\n\tfor (const key of ['list', 'label', 'member'] as const) {\n\t\tif (options.scope?.[key] !== undefined) {\n\t\t\tpaths.push(`scope.${key}`)\n\t\t}\n\t}\n\tif (options.access?.crossScope !== undefined) {\n\t\tpaths.push('access.crossScope')\n\t}\n\tif (typeof options.capture?.slots?.tenant === 'string') {\n\t\tpaths.push('capture.slots.tenant')\n\t}\n\tif (options.capture?.paths?.tenant !== undefined) {\n\t\tpaths.push('capture.paths.tenant')\n\t}\n\tfor (const [slug, binding] of Object.entries(options.collections ?? {})) {\n\t\tif (binding?.scopeField !== undefined && binding.scopeField !== false) {\n\t\t\tpaths.push(`collections.${slug}.scopeField`)\n\t\t}\n\t}\n\tconst goalsCollection = Array.isArray(options.goals) ? undefined : options.goals?.collection\n\tif (isRecord(goalsCollection) && goalsCollection.scopeField !== undefined) {\n\t\tpaths.push('goals.collection.scopeField')\n\t}\n\tconst providersCollection = options.providers?.collection\n\tif (isRecord(providersCollection) && providersCollection.scopeField !== undefined) {\n\t\tpaths.push('providers.collection.scopeField')\n\t}\n\tif (paths.length > 0) {\n\t\tconst one = paths.length === 1\n\t\tthrow new Error(\n\t\t\t`analytics: ${paths.join(', ')} ${one ? 'only applies' : 'only apply'} to a scoped install. Set scope.resolve, or remove ${one ? 'it' : 'them'}.`\n\t\t)\n\t}\n}\n\n/** Unset gates deny on a scoped install and admit `isAdminUser` on an unscoped one. */\nconst resolveCrossScope = (\n\toption: AnalyticsAccessOptions['crossScope'],\n\tscoped: boolean\n): ResolvedCrossScope => {\n\tconst fallback: CrossScopeAccess = scoped ? () => false : isAdminUser\n\tif (option === undefined) {\n\t\treturn allCrossScope(fallback)\n\t}\n\tif (typeof option === 'function') {\n\t\treturn allCrossScope(option)\n\t}\n\tif (!isRecord(option)) {\n\t\tthrow new Error(\n\t\t\t`analytics: access.crossScope must be a function or an object, got ${kindOf(option)}`\n\t\t)\n\t}\n\tfor (const [gate, access] of Object.entries(option)) {\n\t\tif (!CROSS_SCOPE_GATES.includes(gate)) {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: access.crossScope has no \"${gate}\" gate; the gates are named, aggregate and unscopedSource`\n\t\t\t)\n\t\t}\n\t\tif (access !== undefined && typeof access !== 'function') {\n\t\t\tthrow new Error(`analytics: access.crossScope.${gate} must be a function`)\n\t\t}\n\t}\n\treturn {\n\t\tnamed: option.named ?? fallback,\n\t\taggregate: option.aggregate ?? fallback,\n\t\tunscopedSource: option.unscopedSource ?? fallback,\n\t}\n}\n\n/** `access`: the read gate, the view gate (the read gate unless set) and the cross-scope gates. */\nexport const resolveAccess = (\n\toption: AnalyticsAccessOptions | undefined,\n\tscoped: boolean\n): ResolvedOptions['access'] => {\n\tif (option !== undefined) {\n\t\toptionsObject(option, {\n\t\t\tpath: 'access',\n\t\t\tknown: ACCESS_KEYS,\n\t\t\texample: 'an object such as { read: isAdminUser }',\n\t\t})\n\t}\n\tconst read: AnalyticsReadAccess = optionalFunction(option?.read, 'access.read') ?? isAdminUser\n\treturn {\n\t\tread,\n\t\tview: optionalFunction(option?.view, 'access.view') ?? read,\n\t\tcrossScope: resolveCrossScope(option?.crossScope, scoped),\n\t}\n}\n"],"mappings":";;;;;AAiBA,MAAM,aAAa,OAA8B;CAChD,SAAS;CACT,QAAQ;CACR,MAAM;CACN,OAAO;AACR,CAAC;AAED,MAAM,cAAc,OAA+B;CAAE,MAAM;CAAM,MAAM;CAAM,YAAY;AAAK,CAAC;AAE/F,MAAM,oBAAoB,OAAoC;CAC7D,OAAO;CACP,WAAW;CACX,gBAAgB;AACjB,CAAC;AAED,MAAM,kBACL;;AAGD,MAAa,iBAAiB,YAAkD;CAC/E,OAAO;CACP,WAAW;CACX,gBAAgB;AACjB;;AAGA,MAAM,oBACJ,YACD,OAAO,SAAS;CACf,MAAM,QAAQ,MAAM,QAAQ,IAAI;CAChC,IAAI,UAAA,KACH,MAAM,IAAI,MACT,iIACD;CAED,OAAO;AACR;;AAGD,MAAa,gBAAgB,WAA2D;CACvF,IAAI,WAAW,KAAA,GACd,cAAc,QAAQ;EACrB,MAAM;EACN,OAAO;EACP,SAAS;CACV,CAAC;CAEF,MAAM,UAAU,iBAAiB,QAAQ,SAAS,eAAe;CACjE,MAAM,OAAO,iBAAiB,QAAQ,MAAM,YAAY;CACxD,MAAM,QAAQ,iBAAiB,QAAQ,OAAO,aAAa;CAC3D,MAAM,SAAS,iBAAiB,QAAQ,QAAQ,cAAc;CAC9D,IAAI,CAAC,SACJ,OAAO,EAAE,eAAe,KAAK;CAE9B,IAAI,WAAW,KAAA,GACd,MAAM,IAAI,MAAM,eAAe;CAEhC,OAAO;EACN,SAAS,iBAAiB,OAAO;EACjC;EACA,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;EACvB,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC1B;AACD;;;;;AAMA,MAAa,2BAA2B,YAA0C;CACjF,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,OAAO;EAAC;EAAQ;EAAS;CAAQ,GAC3C,IAAI,QAAQ,QAAQ,SAAS,KAAA,GAC5B,MAAM,KAAK,SAAS,KAAK;CAG3B,IAAI,QAAQ,QAAQ,eAAe,KAAA,GAClC,MAAM,KAAK,mBAAmB;CAE/B,IAAI,OAAO,QAAQ,SAAS,OAAO,WAAW,UAC7C,MAAM,KAAK,sBAAsB;CAElC,IAAI,QAAQ,SAAS,OAAO,WAAW,KAAA,GACtC,MAAM,KAAK,sBAAsB;CAElC,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,QAAQ,eAAe,CAAC,CAAC,GACrE,IAAI,SAAS,eAAe,KAAA,KAAa,QAAQ,eAAe,OAC/D,MAAM,KAAK,eAAe,KAAK,YAAY;CAG7C,MAAM,kBAAkB,MAAM,QAAQ,QAAQ,KAAK,IAAI,KAAA,IAAY,QAAQ,OAAO;CAClF,IAAI,SAAS,eAAe,KAAK,gBAAgB,eAAe,KAAA,GAC/D,MAAM,KAAK,6BAA6B;CAEzC,MAAM,sBAAsB,QAAQ,WAAW;CAC/C,IAAI,SAAS,mBAAmB,KAAK,oBAAoB,eAAe,KAAA,GACvE,MAAM,KAAK,iCAAiC;CAE7C,IAAI,MAAM,SAAS,GAAG;EACrB,MAAM,MAAM,MAAM,WAAW;EAC7B,MAAM,IAAI,MACT,cAAc,MAAM,KAAK,IAAI,EAAE,GAAG,MAAM,iBAAiB,aAAa,qDAAqD,MAAM,OAAO,OAAO,EAChJ;CACD;AACD;;AAGA,MAAM,qBACL,QACA,WACwB;CACxB,MAAM,WAA6B,eAAe,QAAQ;CAC1D,IAAI,WAAW,KAAA,GACd,OAAO,cAAc,QAAQ;CAE9B,IAAI,OAAO,WAAW,YACrB,OAAO,cAAc,MAAM;CAE5B,IAAI,CAAC,SAAS,MAAM,GACnB,MAAM,IAAI,MACT,qEAAqE,OAAO,MAAM,GACnF;CAED,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,GAAG;EACpD,IAAI,CAAC,kBAAkB,SAAS,IAAI,GACnC,MAAM,IAAI,MACT,wCAAwC,KAAK,0DAC9C;EAED,IAAI,WAAW,KAAA,KAAa,OAAO,WAAW,YAC7C,MAAM,IAAI,MAAM,gCAAgC,KAAK,oBAAoB;CAE3E;CACA,OAAO;EACN,OAAO,OAAO,SAAS;EACvB,WAAW,OAAO,aAAa;EAC/B,gBAAgB,OAAO,kBAAkB;CAC1C;AACD;;AAGA,MAAa,iBACZ,QACA,WAC+B;CAC/B,IAAI,WAAW,KAAA,GACd,cAAc,QAAQ;EACrB,MAAM;EACN,OAAO;EACP,SAAS;CACV,CAAC;CAEF,MAAM,OAA4B,iBAAiB,QAAQ,MAAM,aAAa,KAAK;CACnF,OAAO;EACN;EACA,MAAM,iBAAiB,QAAQ,MAAM,aAAa,KAAK;EACvD,YAAY,kBAAkB,QAAQ,YAAY,MAAM;CACzD;AACD"}
@@ -1,122 +1,232 @@
1
+ import { readGate } from "../access/readGate.js";
1
2
  import "./contract.js";
2
- import { platformReadGate, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
3
+ import { isScopeMember } from "../access/membership.js";
4
+ import { SYSTEM, isGatedScope, mintGatedScope } from "../access/principal.js";
5
+ import { filterRegistry } from "./registry.js";
6
+ import { readableProviderDocIds } from "../plugin/readableProviders.js";
7
+ import { resolvableScope, resolveRegistryFor, resolveScopeFor, scopeGates } from "../plugin/runtime.js";
3
8
  //#region src/core/scopedRead.ts
9
+ const cleared = (scope) => ({
10
+ ok: true,
11
+ scope,
12
+ gated: mintGatedScope(scope)
13
+ });
4
14
  /**
5
- * The scope one request may act on, decided in one place for every endpoint that takes a
6
- * `scope` from a caller, so a read gate and a state-changing gate cannot drift apart.
7
- *
8
- * The raw value is trimmed and a blank one counts as absent, exactly as `readParam` reads a
9
- * query string. Naming a scope, the platform wildcard included, is the cross-scope decision
10
- * and requires `platformRead`. Absent means the request's own resolved scope, which is
11
- * itself cross-scope when the resolver answers the wildcard or, on a scoped install, null:
12
- * null usually means "no tenant selected" rather than "everything", so it fails closed
13
- * behind the same gate. A resolver that throws answers no scope either, separately, so a
14
- * caller with a degraded answer to give can tell it from a refusal. Per-adapter narrowing
15
- * is a later decision, in `resolveQueryScope`.
15
+ * The scope one request may act on, for every endpoint taking a caller's `scope`, and the only
16
+ * place a {@link GatedScope} is minted. A scoped install's null, no tenant selected, fails closed.
16
17
  */
17
18
  const resolveRequestedScope = async (args) => {
18
19
  const { runtime, req } = args;
19
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
20
+ const gates = args.gates ?? scopeGates(runtime, req);
20
21
  const named = typeof args.raw === "string" ? args.raw.trim() : "";
21
- if (named !== "") return await allowed() ? {
22
- ok: true,
23
- scope: named
24
- } : {
25
- ok: false,
26
- reason: "named"
27
- };
22
+ if (named !== "") {
23
+ if (named === "*") return await gates.aggregate() ? cleared(named) : {
24
+ ok: false,
25
+ reason: "named"
26
+ };
27
+ if (runtime.scoped !== true || named.length > 256) return {
28
+ ok: false,
29
+ reason: "named"
30
+ };
31
+ if (await gates.named()) return cleared(named);
32
+ const own = await resolveScopeFor(runtime, req).catch(() => null);
33
+ if (own === null || own === "*" || own !== named) return {
34
+ ok: false,
35
+ reason: "named"
36
+ };
37
+ return await isScopeMember(runtime.member, req, own) ? cleared(own) : {
38
+ ok: false,
39
+ reason: "not-member"
40
+ };
41
+ }
28
42
  let scope;
29
43
  try {
30
44
  scope = await resolveScopeFor(runtime, req);
31
- } catch (err) {
32
- req.payload.logger?.warn(`analytics: scope resolution failed: ${String(err)}`);
45
+ } catch {
33
46
  return {
34
47
  ok: false,
35
48
  reason: "failed"
36
49
  };
37
50
  }
38
- if ((scope === "*" || runtime.scoped === true && scope === null) && !await allowed()) return {
51
+ if (scope === "*" || scope === null) return (scope === "*" || runtime.scoped === true) && !await gates.aggregate() ? {
39
52
  ok: false,
40
53
  reason: "unresolved"
41
- };
54
+ } : cleared(scope);
55
+ if (await isScopeMember(runtime.member, req, scope) || await gates.named()) return cleared(scope);
42
56
  return {
43
- ok: true,
44
- scope
57
+ ok: false,
58
+ reason: "not-member"
45
59
  };
46
60
  };
47
61
  /**
48
- * The scope to stamp on one adapter query, or a refusal. Cross-scope reads fail closed
49
- * behind `platformRead`: the `'*'` marker, and any scoped read through a shared config
50
- * adapter that cannot narrow the query to one scope (whether or not it is the designated
51
- * platform adapter), which would otherwise answer with every scope's data. A tenant's own
52
- * runtime adapters are never gated. Every read path decides this here, so the widgets and
53
- * the query endpoint cannot drift apart on what counts as cross-scope.
62
+ * True for a shared config adapter that cannot narrow its query, read under a tenant scope: it
63
+ * would answer with every scope's data, so reading or listing it takes `unscopedSource`.
64
+ */
65
+ const needsUnscopedSourceAccess = (runtime, adapter, scope) => scope !== null && scope !== "*" && runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries;
66
+ /**
67
+ * {@link SYSTEM} reads any scope, but never a tenant through a shared adapter that cannot narrow
68
+ * to it: a job would store that adapter's install-wide numbers as the tenant's own.
69
+ */
70
+ const SYSTEM_GATES = {
71
+ named: () => Promise.resolve(true),
72
+ aggregate: () => Promise.resolve(true),
73
+ unscopedSource: () => Promise.resolve(false)
74
+ };
75
+ /**
76
+ * The adapters a request may read through in one tenant scope, or null for none: the scope's own
77
+ * sources follow the providers' read access (`sourceAccess`), a config adapter `unscopedSource`.
78
+ */
79
+ const visibleRegistryFor = async (args) => {
80
+ const { runtime, req, resolved, scope } = args;
81
+ const { registry, grants } = resolved;
82
+ if (runtime.scoped !== true || scope === null || scope === "*") return registry;
83
+ if (args.principal === SYSTEM) return filterRegistry(registry, (adapter) => grants.has(adapter.id) || !needsUnscopedSourceAccess(runtime, adapter, scope));
84
+ const gates = args.gates ?? scopeGates(runtime, req);
85
+ const readable = await readableProviderDocIds(runtime, req, scope);
86
+ const keep = /* @__PURE__ */ new Set();
87
+ for (const adapter of registry.all()) {
88
+ const docId = grants.get(adapter.id);
89
+ if (docId !== void 0) {
90
+ if (readable === null || readable.has(docId)) keep.add(adapter.id);
91
+ continue;
92
+ }
93
+ if (!runtime.providersCollection && adapter.capabilities.scopedQueries) {
94
+ keep.add(adapter.id);
95
+ continue;
96
+ }
97
+ if (await gates.unscopedSource()) keep.add(adapter.id);
98
+ }
99
+ return filterRegistry(registry, (adapter) => keep.has(adapter.id));
100
+ };
101
+ /**
102
+ * The sources a job reads one scope through as {@link SYSTEM}, or null when the scope holds
103
+ * none: exactly what `resolveReadContext` lets a system read choose from.
104
+ */
105
+ const systemRegistryFor = async (runtime, req, scope) => {
106
+ return visibleRegistryFor({
107
+ runtime,
108
+ req,
109
+ resolved: await resolveRegistryFor(runtime, {
110
+ payload: req.payload,
111
+ req,
112
+ scope: resolvableScope(scope)
113
+ }),
114
+ scope,
115
+ principal: SYSTEM
116
+ });
117
+ };
118
+ /**
119
+ * The scope to stamp on one adapter query, or a refusal. Every read path decides it here, so
120
+ * widgets and the query endpoint cannot drift on what counts as cross-scope.
54
121
  */
55
122
  const resolveQueryScope = async (args) => {
56
123
  const { runtime, req, scope, adapter } = args;
57
- const allowed = args.platformRead ?? platformReadGate(runtime, req);
58
- if (scope === "*") return await allowed() ? { ok: true } : { ok: false };
124
+ const gates = args.gates ?? scopeGates(runtime, req);
125
+ if (scope === "*") return await gates.aggregate() ? { ok: true } : { ok: false };
59
126
  if (scope === null) return { ok: true };
60
- if (runtime.configAdapterIds.has(adapter.id) && !adapter.capabilities.scopedQueries) return await allowed() ? { ok: true } : { ok: false };
127
+ if (needsUnscopedSourceAccess(runtime, adapter, scope)) return await gates.unscopedSource() ? { ok: true } : { ok: false };
61
128
  return {
62
129
  ok: true,
63
130
  queryScope: scope
64
131
  };
65
132
  };
66
133
  /**
67
- * Resolve one read's scope and adapter: explicit scope wins over the request's
68
- * resolved scope, the registry is resolved per scope, then the adapter is picked
69
- * by id (or the registry default). A request's own scope goes through
70
- * `resolveRequestedScope`, the same decision every endpoint that takes a scope
71
- * reads with, so the widgets cannot drift from them on what a scope may be.
72
- * Cross-scope reads fail closed behind `platformRead`: an explicit `'*'` scope
73
- * always, any scoped read through a shared config adapter that cannot narrow the
74
- * query to one scope (whether or not it is the designated platform adapter), and,
75
- * on a scoped install, a request that resolves no scope at all. That last case is
76
- * ambiguous rather than intentionally install-wide (a tenant's scopeResolver
77
- * returning null usually means "no tenant selected", not "read everything"), so it
78
- * fails closed the same way. An explicit `scope: null` override bypasses that gate:
79
- * it is the trusted server-side caller's path (cron passes, tests), never a
80
- * request's own resolution. A tenant's own runtime adapters are never gated.
81
- * Any resolution failure (unknown adapter id, a throwing scopeResolver or
82
- * provider lookup) degrades to `{ ok: false }` so read paths render their
83
- * unavailable state instead of throwing.
134
+ * The read's scope: the system's own, one already cleared, or the one the request asks for. Checked
135
+ * at runtime, since a JavaScript caller or a cast can pass anything; anything else is refused.
136
+ */
137
+ const principalScope = async (args, gates) => {
138
+ const { scope } = args;
139
+ if (args.principal === SYSTEM) return typeof scope === "string" || scope === null ? {
140
+ ok: true,
141
+ scope,
142
+ pin: {
143
+ principal: SYSTEM,
144
+ scope
145
+ }
146
+ } : { ok: false };
147
+ if (isGatedScope(scope)) return {
148
+ ok: true,
149
+ scope: scope.value,
150
+ pin: { scope }
151
+ };
152
+ if (scope !== void 0 && scope !== null && typeof scope !== "string") return { ok: false };
153
+ const requested = await resolveRequestedScope({
154
+ runtime: args.runtime,
155
+ req: args.req,
156
+ gates,
157
+ raw: scope
158
+ });
159
+ if (!requested.ok) switch (requested.reason) {
160
+ case "not-member": return {
161
+ ok: false,
162
+ reason: "not-member"
163
+ };
164
+ case "named": return {
165
+ ok: false,
166
+ reason: "no-access"
167
+ };
168
+ case "unresolved": return {
169
+ ok: false,
170
+ reason: "no-scope"
171
+ };
172
+ case "failed": return { ok: false };
173
+ }
174
+ return {
175
+ ok: true,
176
+ scope: requested.scope,
177
+ pin: { scope: requested.gated }
178
+ };
179
+ };
180
+ /**
181
+ * One read's scope and adapter, behind `access.read` and `resolveRequestedScope` unless the
182
+ * principal is {@link SYSTEM}. Any failure answers `{ ok: false }`, so a surface never throws.
84
183
  */
85
184
  const resolveReadContext = async (args) => {
86
185
  const { runtime, req, adapterId } = args;
87
- const allowed = platformReadGate(runtime, req);
186
+ const system = args.principal === SYSTEM;
187
+ const gates = system ? SYSTEM_GATES : scopeGates(runtime, req);
88
188
  try {
89
- let scope;
90
- if (args.scope !== void 0) scope = args.scope;
91
- else {
92
- const requested = await resolveRequestedScope({
93
- runtime,
94
- req,
95
- platformRead: allowed
96
- });
97
- if (!requested.ok) return { ok: false };
98
- scope = requested.scope;
99
- }
100
- const registryScope = scope === "*" ? null : scope;
101
- const registry = await resolveRegistryFor(runtime, {
102
- payload: req.payload,
189
+ if (!system && !await readGate(runtime, req)) return {
190
+ ok: false,
191
+ reason: "no-access"
192
+ };
193
+ const decided = await principalScope(args, gates);
194
+ if (!decided.ok) return decided;
195
+ const { scope, pin } = decided;
196
+ const registryScope = resolvableScope(scope);
197
+ const registry = await visibleRegistryFor({
198
+ runtime,
103
199
  req,
104
- scope: registryScope
200
+ resolved: await resolveRegistryFor(runtime, {
201
+ payload: req.payload,
202
+ req,
203
+ scope: registryScope
204
+ }),
205
+ scope,
206
+ gates,
207
+ ...system ? { principal: SYSTEM } : {}
105
208
  });
106
- const adapter = adapterId ? registry.get(adapterId) : registry.default();
209
+ if (!registry) return {
210
+ ok: false,
211
+ reason: "no-sources"
212
+ };
213
+ const fallback = registry.default();
214
+ const preferred = args.prefer && !args.prefer(fallback) ? registry.all().find(args.prefer) : void 0;
215
+ const adapter = adapterId ? registry.get(adapterId) : preferred ?? fallback;
107
216
  const decision = await resolveQueryScope({
108
217
  runtime,
109
218
  req,
110
219
  scope,
111
220
  adapter,
112
- platformRead: allowed
221
+ gates
113
222
  });
114
223
  if (!decision.ok) return { ok: false };
115
224
  return {
116
225
  ok: true,
117
226
  adapter,
118
227
  scope: registryScope,
119
- queryScope: decision.queryScope
228
+ queryScope: decision.queryScope,
229
+ pin
120
230
  };
121
231
  } catch (err) {
122
232
  req.payload.logger?.warn(`analytics: read context resolution failed: ${String(err)}`);
@@ -124,6 +234,6 @@ const resolveReadContext = async (args) => {
124
234
  }
125
235
  };
126
236
  //#endregion
127
- export { resolveQueryScope, resolveReadContext, resolveRequestedScope };
237
+ export { needsUnscopedSourceAccess, resolveQueryScope, resolveReadContext, resolveRequestedScope, systemRegistryFor, visibleRegistryFor };
128
238
 
129
239
  //# sourceMappingURL=scopedRead.js.map