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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1,78 +1,199 @@
1
+ import { CurrencyConverter } from "../goals/currency.js";
2
+ import { CaptureClientKind, CaptureSlot } from "../tracker/config.js";
1
3
  import { Goal } from "../goals/types.js";
4
+ import { BrowserAmounts, OrderSignatureMode } from "../goals/match.js";
5
+ import { TrustedPlatform } from "../net/platform.js";
6
+ import { RouteBase } from "../plugin/routes.js";
7
+ import { FetchLike } from "./fetch.js";
8
+ import { AnalyticsCollectionOptions, CollectionOverrides } from "./collectionOption.js";
9
+ import { AnalyticsJobsOptions, AnalyticsTaskOptions } from "./jobs.js";
10
+ import { AnalyticsSdks } from "./sdks.js";
2
11
  import { AnalyticsAdapter, MetricKey } from "./contract.js";
3
- import { AnalyticsBinding } from "../binding/types.js";
4
- import { CaptureSlot } from "../capture/slots.js";
5
12
  import { TimeframePreset } from "../timeframe/presets.js";
13
+ import { AnalyticsBinding } from "../binding/types.js";
6
14
  import { TranslationsOption } from "../translations/index.js";
15
+ import { GoalCollectionFieldOverrides } from "../goals/collection.js";
16
+ import { CacheStore } from "../surfacing/cacheStore.js";
17
+ import { AfterReadHook } from "../surfacing/afterRead.js";
18
+ import { ConnectionAccess, ProviderCollectionFieldOverrides } from "../providers/collection.js";
19
+ import { ProviderHostPolicy } from "../providers/hosts.js";
7
20
  import { CustomWidgetDef } from "../widgets/customWidget.js";
8
- import { CollectionConfig, CollectionSlug, Payload, PayloadRequest } from "payload";
21
+ import { BuiltInWidgetSlug } from "./widgetSlugs.js";
22
+ import { Access, CollectionConfig, CollectionSlug, Field, Payload, PayloadRequest, RawPayloadComponent, Widget } from "payload";
9
23
  import { KeysConfig } from "@10x-media/fields/encrypted";
10
24
 
11
25
  //#region src/core/options.d.ts
12
26
  /**
13
- * Maps a request to its analytics boundary (tenant id, site key). Null means the
14
- * whole install, which is the default single-site behavior. With a multi-tenant
15
- * plugin, return the request's tenant id here.
27
+ * Who asks for a request's scope: `capture` files a visitor's hit and carries no user or cookies,
28
+ * so it resolves from the host; `admin` is every signed-in read or edit.
29
+ */
30
+ type ScopeCallSite = 'capture' | 'admin';
31
+ /**
32
+ * Maps a request to the scope it selected (tenant id, site key), null for the whole install;
33
+ * whether its user may act there is `scope.member`. `'*'` is refused.
16
34
  */
17
35
  type ScopeResolver = (args: {
18
36
  req: PayloadRequest;
37
+ callSite: ScopeCallSite;
19
38
  }) => string | null | Promise<string | null>;
20
39
  /**
21
- * Resolves the IANA reporting timezone a read's (or ingest's) day boundaries align
22
- * to. Receives the request and its already-resolved scope, so per-tenant, per-user
23
- * (`req.user`), and selector (cookie/preference) strategies are all expressible.
24
- * Return `null` to fall back to UTC.
40
+ * Lists the tenant scopes the sync task runs over, in addition to the install-wide scope it always
41
+ * covers. Warming needs no list: it repeats the reads each scope's readers made.
42
+ */
43
+ type ScopeListResolver = (args: {
44
+ payload: Payload;
45
+ }) => string[] | Promise<string[]>;
46
+ /**
47
+ * Names a scope on screen, so a tenant admin reads a name rather than an id in the view's caption.
48
+ * Undefined keeps the id.
49
+ */
50
+ type ScopeLabelResolver = (args: {
51
+ req: PayloadRequest;
52
+ scope: string;
53
+ }) => string | undefined | Promise<string | undefined>;
54
+ /** Whether the request's user belongs to `scope`, as opposed to having merely selected it. */
55
+ type ScopeMemberAccess = (args: {
56
+ req: PayloadRequest;
57
+ scope: string;
58
+ }) => boolean | Promise<boolean>;
59
+ /** How the install divides its analytics into tenants. Unset, the install is one scope. */
60
+ type AnalyticsScopeOptions = {
61
+ resolve: ScopeResolver;
62
+ /**
63
+ * Whether the request's user belongs to the scope `resolve` selected, asked on every read and
64
+ * config write. `tenantMembership()` reads the multi-tenant plugin's tenants.
65
+ */
66
+ member: ScopeMemberAccess;
67
+ list?: ScopeListResolver;
68
+ label?: ScopeLabelResolver;
69
+ };
70
+ /**
71
+ * Resolves a scope's IANA reporting timezone, also asked at ingest without the user or cookies.
72
+ * Null means UTC.
25
73
  */
26
74
  type TimezoneResolver = (args: {
27
75
  req: PayloadRequest;
28
76
  scope: string | null;
29
77
  }) => string | null | Promise<string | null>;
30
78
  /**
31
- * Enumerates the tenant scopes the cron tiers (cache warming, sync) fan out over.
32
- * Absent, each tier runs once for the install-wide scope.
79
+ * Resolves a scope's ISO 4217 revenue currency, so each tenant can have its own. Undefined reports
80
+ * revenue as a plain number.
33
81
  */
34
- type ScopesResolver = (args: {
35
- payload: Payload;
36
- }) => string[] | Promise<string[]>;
82
+ type CurrencyResolver = (args: {
83
+ req: PayloadRequest;
84
+ scope: string | null;
85
+ }) => string | undefined | Promise<string | undefined>;
37
86
  /**
38
- * Escape hatch replacing the provider-collection lookup: return the runtime
39
- * adapters for a scope yourself (any store, any shape). Results are layered onto
40
- * the static config adapters exactly like collection-resolved ones, but are not
41
- * cached; memoize inside the function if lookups are expensive.
87
+ * How the install measures money once `revenue` turns it on. Off hides every money surface but
88
+ * keeps stored data, so turning it on later reports the history.
42
89
  */
43
- type ProvidersResolve = (args: {
90
+ type AnalyticsRevenueOptions = {
91
+ /**
92
+ * ISO 4217 currency revenue is reported in, or a resolver per tenant. Unset, amounts are summed
93
+ * as sent and a mix of currencies is flagged in `meta.mixedCurrencies`.
94
+ */
95
+ currency?: string | CurrencyResolver;
96
+ /**
97
+ * FX hook native ingest calls when an event's currency differs from `currency`. Without it such
98
+ * an amount stays out of revenue, though the conversion still counts.
99
+ */
100
+ convert?: CurrencyConverter;
101
+ /**
102
+ * The `currency` breakdown dimension, keyed by the currency each amount was sent in. Default: on
103
+ * while no `convert` hook is set.
104
+ */
105
+ dimension?: boolean;
106
+ /**
107
+ * How far native ingest trusts an amount a browser sends, which anyone can forge. `'fixed'`
108
+ * (default) prefers a goal's fixed value, `'none'` ignores it, `'trust'` prefers it.
109
+ */
110
+ browserAmounts?: BrowserAmounts;
111
+ /**
112
+ * Whether native ingest takes an order id sent without the server's `signOrderId` signature.
113
+ * `'optional'` (default) takes it; `'required'` answers an unsigned one with `400`.
114
+ */
115
+ orderSignature?: OrderSignatureMode;
116
+ };
117
+ /** What `providers.resolve` is handed for one scope. */
118
+ interface ProvidersResolveArgs {
44
119
  payload: Payload;
45
120
  req?: PayloadRequest;
46
121
  scope: string | null;
47
- }) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>;
122
+ /**
123
+ * The runtime's guarded fetch: every address a vendor's host resolves to has to be public, on
124
+ * every connection and every redirect. Hand it to `adapterFromProviderDoc`.
125
+ */
126
+ fetch: FetchLike;
127
+ /**
128
+ * The hosts a document may name: each vendor's own cloud, plus `providers.hosts`. Hand it to
129
+ * `adapterFromProviderDoc` with `fetch`, which reaches a private network only when it allows one.
130
+ */
131
+ hosts: ProviderHostPolicy;
132
+ /** The plugin's `sdks`, which a GA4 document's adapter reads through. */
133
+ sdks: AnalyticsSdks;
134
+ }
135
+ /**
136
+ * Replaces the providers collection lookup with a scope's adapters, uncached. Build each with
137
+ * `adapterFromProviderDoc(row, { fetch, hosts, sdks })` so a stored key reaches allowed hosts only.
138
+ */
139
+ type ProvidersResolve = (args: ProvidersResolveArgs) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>;
140
+ /**
141
+ * Where provider documents may point. Each vendor's own cloud is always allowed: Plausible, Umami
142
+ * Cloud, and PostHog's US and EU regions.
143
+ */
144
+ type ProviderHostsOptions = {
145
+ /**
146
+ * Origins a document's host may name besides its vendor's cloud, such as `https://*.example.com`;
147
+ * no paths. A host outside them reads as `source_misconfigured`.
148
+ */
149
+ allow?: string[];
150
+ /**
151
+ * Lets document adapters reach any address over http or https, private networks included (Umami
152
+ * on the same Docker network). Default off.
153
+ */
154
+ allowPrivateNetwork?: boolean;
155
+ };
48
156
  type ProvidersCollectionOptions = {
49
157
  slug?: string;
50
158
  /**
51
- * Field matched against the resolved scope when looking up a scope's providers.
52
- * Point it at a tenant plugin's field (e.g. 'tenant') when that plugin manages
53
- * scoping for the collection.
159
+ * Field matched against the resolved scope when looking up a scope's providers. Default `scope`;
160
+ * name a tenant plugin's field (`tenant`) when that plugin scopes the collection.
54
161
  */
55
162
  scopeField?: string;
56
- overrides?: (collection: CollectionConfig) => CollectionConfig;
163
+ /**
164
+ * Replaces one of the collection's own fields, each handed the plugin's default. Applied before
165
+ * `overrides`.
166
+ */
167
+ fields?: ProviderCollectionFieldOverrides;
168
+ /**
169
+ * Reshapes the whole config last. It may not rename the collection (`slug` does) nor turn off
170
+ * its timestamps, which every instance notices a saved document by: the boot refuses both.
171
+ */
172
+ overrides?: CollectionOverrides;
57
173
  access?: Partial<CollectionConfig['access']>;
58
174
  /**
59
- * Dedicated key ring for the stored provider credentials. Unset, the
60
- * fields plugin's global `encrypted.keys` applies, and with neither the
61
- * ring derives from the Payload secret. Configure a dedicated key for
62
- * anything beyond a dev install.
175
+ * Dedicated key ring for stored provider credentials. Unset, the fields plugin's `encrypted.keys`
176
+ * applies, else a ring derived from the Payload secret, fit for dev only.
63
177
  */
64
178
  encryption?: {
65
179
  keys?: KeysConfig;
66
180
  };
181
+ /**
182
+ * Who may set or change where a document connects (provider, host, ids); a denied value is
183
+ * dropped. Default: the creator, then `access.crossScope.named` when scoped, else update access.
184
+ */
185
+ connectionAccess?: ConnectionAccess;
186
+ /**
187
+ * Which provider documents a reader reads analytics through, as collection access ANDed with
188
+ * enabled and scope. Default: the collection's own read access.
189
+ */
190
+ sourceAccess?: Access;
67
191
  };
68
192
  type ProvidersOptions = {
69
- /** Opt-in admin collection storing runtime provider configurations. */collection?: boolean | ProvidersCollectionOptions;
70
- resolve?: ProvidersResolve;
193
+ /** Opt-in admin collection storing runtime provider configurations. */collection?: boolean | ProvidersCollectionOptions; /** Replaces the collection: the two cannot both be set. */
194
+ resolve?: ProvidersResolve; /** Where the documents of either one may point. Needs `collection` or `resolve`. */
195
+ hosts?: ProviderHostsOptions;
71
196
  };
72
- /** Access checker for cross-scope (platform) analytics reads. */
73
- type PlatformReadAccess = (args: {
74
- req: PayloadRequest;
75
- }) => boolean | Promise<boolean>;
76
197
  /** Access checker for authenticated analytics reads. */
77
198
  type AnalyticsReadAccess = (args: {
78
199
  req: PayloadRequest;
@@ -81,51 +202,63 @@ type AnalyticsReadAccess = (args: {
81
202
  type AnalyticsViewAccess = (args: {
82
203
  req: PayloadRequest;
83
204
  }) => boolean | Promise<boolean>;
205
+ /** Access checker for one of the cross-scope gates under `access.crossScope`. */
206
+ type CrossScopeAccess = (args: {
207
+ req: PayloadRequest;
208
+ }) => boolean | Promise<boolean>;
209
+ /**
210
+ * The three ways a reader on a scoped install reaches past their own scope, each denied by default.
211
+ * Split so platform staff can aggregate without singling out one tenant.
212
+ */
213
+ type AnalyticsCrossScopeOptions = {
214
+ /**
215
+ * Reading a scope the request does not resolve to, by naming it. Also decides who manages other
216
+ * tenants' provider, goal and sync documents.
217
+ */
218
+ named?: CrossScopeAccess; /** Reading every scope at once: the `'*'` marker, and a scoped install's null scope. */
219
+ aggregate?: CrossScopeAccess;
220
+ /**
221
+ * Reading a tenant through a shared config adapter that cannot narrow its query to one scope.
222
+ * Also decides whether such an adapter is listed as a source at all.
223
+ */
224
+ unscopedSource?: CrossScopeAccess;
225
+ };
84
226
  type AnalyticsAccessOptions = {
85
227
  /**
86
- * Gates every authenticated read endpoint: query, document panel, realtime, sources
87
- * and goals. Defaults to any authenticated user; narrow it to a role check to keep
88
- * analytics away from admins who should not see them. Scope gating is separate and
89
- * always applies: granting `read` never widens which scope a user reads.
228
+ * Gates every read: endpoints, dashboard widgets and display fields. Default `isAdminUser` (the
229
+ * `admin.user` collection); scope gating applies on top and is never widened by it.
90
230
  */
91
231
  read?: AnalyticsReadAccess;
92
232
  /**
93
- * Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through
94
- * a shared config adapter that cannot filter by scope. Scoped installs
95
- * (`scopeResolver` configured) default to deny; configure it, for example a role
96
- * check, so platform admins can read cross-scope and manage every tenant's
97
- * providers. Unscoped installs default to any authenticated admin-panel user.
233
+ * Gates the analytics admin view. Default: `read`. A denied reader still sees the nav link and
234
+ * lands on the view's no-access message.
98
235
  */
99
- platformRead?: PlatformReadAccess;
236
+ view?: AnalyticsViewAccess;
100
237
  /**
101
- * Gates the analytics admin view. Defaults to `read`, so one gate covers the view and
102
- * the endpoints behind it. A reader this denies still sees the nav link (it is a client
103
- * component with no access context) and lands on the view's no-access message.
238
+ * Reads past the request's own scope, scoped installs only: a function grants all three gates,
239
+ * the object form each one (unset denies). Unscoped, all three open to `isAdminUser`.
104
240
  */
105
- view?: AnalyticsViewAccess;
241
+ crossScope?: CrossScopeAccess | AnalyticsCrossScopeOptions;
106
242
  };
107
- type ConsentMode = 'none' | 'required';
108
- /** Per-slot consent decision, evaluated against the slot's resolved adapter. */
109
- type ConsentResolver = (args: {
243
+ /** What `capture.gate` is asked about one capture slot. */
244
+ interface CaptureGateArgs {
110
245
  slot: CaptureSlot;
246
+ /** The adapter filling the slot for this request. */
111
247
  adapterId: string;
112
- }) => ConsentMode;
113
- /** An adapter id to fill a capture slot with, or `false` to leave it deliberately empty. */
114
- type CaptureSlotOption = string | false;
248
+ kind: CaptureClientKind;
249
+ }
115
250
  /**
116
- * A bare mode applies to every slot; a resolver decides per request-resolved adapter; the
117
- * object form maps ids and slots, with an adapter entry winning over a slot entry. Every
118
- * form overrides the default, which is `none` for the cookieless native tracker and
119
- * `required` for a vendor's.
251
+ * Which capture slots wait for the host's consent manager: `'all'`, `'off'`, a list of slots, or a
252
+ * function answering per slot (true waits).
120
253
  */
121
- type CaptureConsentOption = ConsentMode | ConsentResolver | {
122
- slots?: Partial<Record<CaptureSlot, ConsentMode>>;
123
- /**
124
- * Keyed by adapter id. A bare id must name a config adapter; a runtime provider
125
- * instance id (`<provider>:<instance>`) is taken on trust, since the providers it
126
- * comes from are only resolved per request.
127
- */
128
- adapters?: Record<string, ConsentMode>;
254
+ type CaptureGate = 'all' | 'off' | CaptureSlot[] | ((args: CaptureGateArgs) => boolean);
255
+ /** An adapter id to fill a capture slot with, or `false` to leave it deliberately empty. */
256
+ type CaptureSlotOption = string | false;
257
+ /** What the tracker and ingest do with elements marked by `itemAttributes`. */
258
+ type ItemCaptureOptions = {
259
+ /** Count an item as seen once at least half of it stays on screen for a second. */impressions?: boolean; /** Send `item_click` for the first click on an item during a pageview. */
260
+ clicks?: boolean; /** Also count an item per page it appeared on, beside its own total. */
261
+ pages?: boolean;
129
262
  };
130
263
  type AutoCaptureOptions = {
131
264
  scrollDepth?: boolean;
@@ -137,50 +270,103 @@ type AutoCaptureOptions = {
137
270
  * never stored, only the five campaign values; set false to stop sending it at all.
138
271
  */
139
272
  query?: boolean;
273
+ /**
274
+ * Content items, on by default and inert until a page marks an element with `itemAttributes`.
275
+ * `false` turns them off, crediting goals to items included.
276
+ */
277
+ items?: false | ItemCaptureOptions;
140
278
  };
141
- type ResolvedAutoCapture = Required<AutoCaptureOptions>;
142
279
  type AnalyticsGoalsCollectionOptions = {
143
- /** Set false to keep the object form's other settings while leaving the collection off. */enabled?: boolean;
144
280
  slug?: string;
145
281
  /**
146
282
  * Field matched against the resolved scope when looking up a scope's goals. Point it at
147
283
  * a tenant plugin's field (e.g. 'tenant') when that plugin manages scoping.
148
284
  */
149
285
  scopeField?: string;
150
- overrides?: (collection: CollectionConfig) => CollectionConfig;
286
+ /**
287
+ * Replaces one of the collection's own fields, each handed the plugin's default; applied before
288
+ * `overrides`. A `slug` replacement must keep a field named `slug` or the boot fails.
289
+ */
290
+ fields?: GoalCollectionFieldOverrides;
291
+ /**
292
+ * Reshapes the whole config last. It may not rename the collection (`slug` does) nor turn off
293
+ * its timestamps, which every instance notices a saved document by: the boot refuses both.
294
+ */
295
+ overrides?: CollectionOverrides;
151
296
  access?: Partial<CollectionConfig['access']>;
152
297
  };
153
298
  /** Goals as config, plus the opt-in collection editors manage their own goals through. */
154
299
  type AnalyticsGoalsOptions = {
155
300
  defaults?: Goal[]; /** Opt-in admin collection whose goals merge over `defaults`, by slug, per scope. */
156
301
  collection?: boolean | AnalyticsGoalsCollectionOptions;
302
+ /**
303
+ * The built-in `purchase` goal sales book against, on unless a configured goal claims that slug.
304
+ * `false` removes it, for an install that never sells.
305
+ */
306
+ purchase?: boolean;
307
+ };
308
+ /**
309
+ * The website addresses where the scope's tracker runs, one per site, each an `http(s)` origin with
310
+ * an optional path. May be async; scope is null on an unscoped install.
311
+ */
312
+ type ExclusionSitesResolver = (args: {
313
+ req: PayloadRequest;
314
+ scope: string | null;
315
+ }) => string[] | Promise<string[]>;
316
+ /** The signed link staff open to leave their own browser out of the numbers. */
317
+ type AnalyticsExclusionOptions = {
318
+ /**
319
+ * The query parameter the tracker reads. Default `analytics_exclude`. Letters, digits, `.`,
320
+ * `_`, `~` and `-`, at most 64 of them.
321
+ */
322
+ param?: string;
323
+ /**
324
+ * Website addresses where the tracker runs, one per site, for the view to link to: a list, or
325
+ * a per-scope function (async allowed). Unset, the view hands out only the query to append.
326
+ */
327
+ sites?: string[] | ExclusionSitesResolver;
157
328
  };
158
329
  type AnalyticsCaptureOptions = {
159
330
  /**
160
- * Which adapter fills each capture slot, overriding the defaults: `global` is the
161
- * designated `platformAdapter`, or the single config adapter when only one is
162
- * configured; `tenant` is the resolved scope's default adapter. A `global` id must
163
- * name a config adapter; a `tenant` id may also name a runtime provider instance,
164
- * so it is resolved per request rather than validated at config time.
165
- *
166
- * `false` disables a slot outright: it fills with nothing, its proxy mount 404s, and
167
- * the tracker config omits it. Use it to keep a default from filling a slot at all.
331
+ * Which capture slots wait for the host's consent manager. Required whenever a slot can fill:
332
+ * whether tracking needs consent is the operator's call, so there is no default.
333
+ */
334
+ gate?: CaptureGate;
335
+ /**
336
+ * Exact origins of other sites (`https://shop.example.com`, no path or wildcard) whose pages may
337
+ * send to ingest and the capture proxy. Unset, only the site and its subdomains can.
338
+ */
339
+ allowedOrigins?: string[];
340
+ /**
341
+ * The signed link staff open to leave their browser out of the numbers. Off by default; `true`
342
+ * turns it on as `analytics_exclude`, an object renames it through `param`.
343
+ */
344
+ exclusion?: boolean | AnalyticsExclusionOptions;
345
+ /**
346
+ * Which adapter fills each slot (`global`: `platformAdapter` or the only adapter; `tenant`: the
347
+ * scope's default). `false` leaves a slot empty: no proxy mount, no tracker entry.
168
348
  */
169
349
  slots?: {
170
350
  global?: CaptureSlotOption;
171
351
  tenant?: CaptureSlotOption;
172
352
  };
173
353
  /**
174
- * Mount each slot's snippet points at. Defaults to the runtime proxy endpoint
175
- * (`<routes.api>/analytics/p/<slot>`); set it when the slot is served through Next
176
- * rewrites instead, passing the same path `captureRewrites` was mounted at.
354
+ * Mount each slot's snippet points at. Default: the runtime proxy endpoint; set it to a
355
+ * `captureRoute` handler's path, without the Next `basePath`, which the tracker config adds.
177
356
  */
178
357
  paths?: {
179
358
  global?: string;
180
359
  tenant?: string;
181
- }; /** Whether a slot's tracker waits for consent. Native defaults to no gate, vendors to one. */
182
- consent?: CaptureConsentOption; /** Browser auto-capture listeners, all on by default except `scrollDepth`. */
183
- autoCapture?: AutoCaptureOptions; /** Limits for the public runtime capture proxy, separate from the read-path `cache`. */
360
+ }; /** Browser auto-capture listeners, all on by default except `scrollDepth`. */
361
+ autoCapture?: AutoCaptureOptions;
362
+ /**
363
+ * Pages the tracker leaves uncounted, each on unless false: `automation` (`navigator.webdriver`;
364
+ * turn it off for e2e suites asserting on hits) and `previews` (draft mode, live preview).
365
+ */
366
+ skip?: {
367
+ automation?: boolean;
368
+ previews?: boolean;
369
+ }; /** Limits for the public runtime capture proxy, separate from the read-path `cache`. */
184
370
  proxy?: {
185
371
  /**
186
372
  * Deadline for the upstream response headers, in ms. Default 10000. The body
@@ -203,60 +389,193 @@ type AnalyticsViewOptions = {
203
389
  * falls back to `en`. Unset, the plugin's own translated label applies.
204
390
  */
205
391
  navLabel?: string | Record<string, string>;
392
+ /**
393
+ * A client component replacing the view's body under the same server shell, given
394
+ * `AnalyticsViewClientProps`; compose it from the sections `@10x-media/analytics/client` exports.
395
+ *
396
+ * @beta
397
+ */
398
+ Component?: AnalyticsComponent;
399
+ };
400
+ /**
401
+ * A component a host puts in one of the plugin's places, as Payload takes one: an import-map path
402
+ * such as `'/components/Flag#Flag'`, or the object form with its export and props.
403
+ *
404
+ * @beta
405
+ */
406
+ type AnalyticsComponent = string | RawPayloadComponent;
407
+ /**
408
+ * How a host changes one built-in dashboard widget.
409
+ *
410
+ * @beta
411
+ */
412
+ interface AnalyticsWidgetOverride {
413
+ /**
414
+ * Rendered in place of the plugin's own component. A server component receives the full widget
415
+ * props, a client component its `clientProps` alone.
416
+ */
417
+ Component?: AnalyticsComponent;
418
+ /** The widget's name in the dashboard's widget list. */
419
+ label?: Widget['label'];
420
+ /**
421
+ * The widget's settings, given the plugin's own fields as `defaultFields`, the shape Payload's
422
+ * form builder and search plugins take; what it returns is the form.
423
+ */
424
+ fields?: (args: {
425
+ defaultFields: Field[];
426
+ }) => Field[];
427
+ }
428
+ /** @beta */
429
+ type AnalyticsWidgetOverrides = Partial<Record<BuiltInWidgetSlug, AnalyticsWidgetOverride>>;
430
+ /** @beta */
431
+ interface AnalyticsWidgetsOptions {
432
+ disabled?: string[];
433
+ register?: CustomWidgetDef[];
434
+ /**
435
+ * Marks each widget's free-text Title field `localized`. Default off; takes effect only when the
436
+ * Payload config enables localization.
437
+ */
438
+ localizeText?: boolean;
439
+ /**
440
+ * Period-over-period comparison on the metric and trend widgets. Default on, except for a source
441
+ * whose adapter sets `capabilities.comparison` false; `false` skips the second read.
442
+ */
443
+ comparison?: boolean;
444
+ /** Built-in widgets changed by slug: their component, their name, their settings. */
445
+ overrides?: AnalyticsWidgetOverrides;
446
+ }
447
+ /**
448
+ * `countryFlags` with a flag of the host's own.
449
+ *
450
+ * @beta
451
+ */
452
+ interface AnalyticsCountryFlags {
453
+ /**
454
+ * A client component drawing one flag from `{ code }`, an ISO 3166-1 alpha-2 code in capitals.
455
+ * Registered through `admin.dependencies`, so `payload generate:importmap` picks it up.
456
+ */
457
+ Component: AnalyticsComponent;
458
+ }
459
+ /** The collection the sync job persists daily metrics into: `slug` defaults to `analytics-daily`. */
460
+ type AnalyticsSyncCollectionOptions = AnalyticsCollectionOptions & {
461
+ /** Keeps the collection out of the admin nav. Default true. */hidden?: boolean;
462
+ };
463
+ /** The read cache's collection: `slug` defaults to `analytics-cache`. */
464
+ type AnalyticsCacheCollectionOptions = AnalyticsCollectionOptions;
465
+ /** What `analytics-sync` copies; when it runs is `jobs.tasks.sync`. */
466
+ type AnalyticsSyncOptions = {
467
+ /** Days each run reads back, today counted. Default 3. */lookbackDays?: number;
468
+ /**
469
+ * The sources it copies: a config adapter's id, or a provider type for every source built from
470
+ * provider documents of that type. Default every vendor source.
471
+ */
472
+ adapters?: string[];
473
+ collection?: AnalyticsSyncCollectionOptions;
474
+ };
475
+ /** How much reads may ask of their sources at once (`cache.concurrency`). */
476
+ type AnalyticsConcurrencyOptions = {
477
+ /** Requests in flight across every vendor source of one instance. Default 16. */global?: number; /** Requests in flight per vendor source that declares no `rateLimit.maxConcurrent`. Default 4. */
478
+ perSource?: number; /** Reads with nothing cached one scope may have waiting on its sources. Default 8. */
479
+ perScope?: number;
480
+ };
481
+ /** How reads are cached, how long they wait for their sources, and which are kept warm. */
482
+ type AnalyticsCacheOptions = {
483
+ /**
484
+ * Seconds an answer stays fresh; unset, each adapter's `recommendedTtl` applies. A native read
485
+ * whose window reaches into today stays fresh 10 seconds at most whatever this says.
486
+ */
487
+ ttl?: {
488
+ aggregate?: number;
489
+ realtime?: number;
490
+ };
491
+ /**
492
+ * Keeps recently asked reads warm: `analytics-warm` rereads each shortly before its cached answer
493
+ * expires. Default off; `true` uses the defaults. Scheduled by `jobs.tasks.warm`.
494
+ */
495
+ warm?: boolean | AnalyticsWarmOptions;
496
+ /**
497
+ * How long a read waits for its source, in ms, retries included. Default 15000. Only a read with
498
+ * nothing cached (and sync) waits; others answer an expired entry at once.
499
+ */
500
+ timeoutMs?: number;
501
+ /**
502
+ * How much reads may ask of their sources at once; past `perScope` the query endpoint answers
503
+ * 429. Native reads have a lane of their own outside these: 8, or on Postgres a third of
504
+ * `pool.max`, between 1 and 8.
505
+ */
506
+ concurrency?: AnalyticsConcurrencyOptions;
507
+ /**
508
+ * Where reads are cached across requests and instances. Default: the `analytics-cache`
509
+ * collection; a self-expiring store (Redis) replaces it. Live counts stay in memory.
510
+ */
511
+ store?: CacheStore; /** The `analytics-cache` collection of the default store; refused beside `store`. */
512
+ collection?: AnalyticsCacheCollectionOptions;
513
+ };
514
+ /** Hooks into what the plugin does. */
515
+ type AnalyticsHooksOptions = {
516
+ /**
517
+ * Runs once for every read answered to a reader, after it is cached, to observe it or answer
518
+ * that one read differently. See {@link AfterReadHook} for the contract.
519
+ */
520
+ afterRead?: AfterReadHook;
521
+ };
522
+ /** Which reads `analytics-warm` keeps warm; when it runs is `jobs.tasks.warm`. */
523
+ type AnalyticsWarmOptions = {
524
+ /** Reads asked for in this many hours count as recent. Default 24. */windowHours?: number; /** The most reads one run refreshes, most recently read first. Default 200. */
525
+ maxReads?: number;
526
+ };
527
+ /** Where the plugin's endpoints answer. */
528
+ type AnalyticsRoutesOptions = {
529
+ /**
530
+ * The path every plugin endpoint hangs off, under `routes.api`. Default `/_x`; the boot fails
531
+ * when a collection slug is its first segment, which would swallow those requests.
532
+ */
533
+ base?: RouteBase;
206
534
  };
207
535
  type AnalyticsPluginOptions = {
536
+ /**
537
+ * Switches the plugin off but keeps its schema (collections, fields, indexes, task slugs), so
538
+ * nothing is dropped. No endpoint, view, widget or task work runs; options are still checked.
539
+ */
208
540
  disabled?: boolean;
209
541
  /**
210
- * Per-locale overrides for this plugin's UI strings, keyed by the typed
211
- * translation keys exported from `@10x-media/analytics/i18n`. Values win over
212
- * the built-in locales key-by-key; locales the plugin does not ship are added
213
- * whole. App-level `i18n.translations` still wins over both.
542
+ * Per-locale overrides for the plugin's UI strings, keyed by `@10x-media/analytics/i18n` keys.
543
+ * They win per key over built-ins; app `i18n.translations` wins over both.
214
544
  */
215
545
  translations?: TranslationsOption;
216
- adapters?: AnalyticsAdapter[];
546
+ adapters: AnalyticsAdapter[];
217
547
  defaultAdapter?: string;
218
- scopeResolver?: ScopeResolver;
219
548
  /**
220
- * Enumerates the tenant scopes the cache-warming and sync cron tiers fan out
221
- * over, in addition to the install-wide (null) scope every tier already runs.
222
- * Unset, those tiers run once for the whole install, same as before.
549
+ * Id of one config adapter shared by every scope (the platform's own analytics). Reading a tenant
550
+ * through it needs `access.crossScope.unscopedSource` unless it supports scoped queries.
223
551
  */
224
- scopes?: ScopesResolver;
552
+ platformAdapter?: string; /** Tenancy: how a request maps to its scope. Unset, the whole install is one scope. */
553
+ scope?: AnalyticsScopeOptions;
225
554
  /**
226
- * IANA reporting timezone that day boundaries (timeframe windows, series axes,
227
- * native rollup buckets) align to. Defaults to UTC. A string forces one timezone
228
- * (the single-tenant / no-multi-tenancy case); a resolver derives it per request
229
- * from the scope, user, or a selector. Native rollups bucket at ingest in the
230
- * resolved timezone, so changing it does not re-bucket existing history.
555
+ * IANA timezone days are cut in. Default UTC; a resolver answers per scope. After a change,
556
+ * native recounts in the new zone only days whose raw hits it still keeps.
231
557
  */
232
558
  reportingTimezone?: string | TimezoneResolver;
233
- providers?: ProvidersOptions;
234
559
  /**
235
- * Id of one config adapter shared by every scope (the platform's own analytics,
236
- * e.g. a PostHog project capturing all tenants). Included in each scope's
237
- * registry like any config adapter; reads through it are scope-filtered only
238
- * when the adapter supports scoped queries, otherwise they are cross-scope and
239
- * require `access.platformRead`.
560
+ * Money as a capability. `false` or unset measures none; `true` measures it with the
561
+ * defaults; an object turns it on and says in which currency, and how.
240
562
  */
241
- platformAdapter?: string;
563
+ revenue?: boolean | AnalyticsRevenueOptions;
242
564
  /**
243
- * How many proxies in front of the app are trusted, counted from the right of
244
- * `x-forwarded-for`, when the plugin reads a request's client address (the native visitor
245
- * hash, geo, and the address the capture proxy forwards upstream). It also lets the native
246
- * ingest read `x-forwarded-host` for the event's hostname. Unset keeps the leftmost
247
- * forwarded entry, which the client controls.
565
+ * How many proxies to trust, counted from the right of `x-forwarded-for`, when reading a client
566
+ * address. Unset keeps the leftmost entry, which the client controls. Not with `trustedPlatform`.
248
567
  */
249
568
  trustedProxyHops?: number;
250
- access?: AnalyticsAccessOptions;
251
569
  /**
252
- * The analytics admin view and its nav link, on by default. `false` registers neither;
253
- * the read endpoints stay mounted either way, so a custom surface keeps working.
570
+ * Platform (`'vercel'` or `'cloudflare'`) whose edge headers carry the visitor's address and
571
+ * location. Set it only when every request passes through it, or the headers can be forged.
254
572
  */
255
- view?: false | AnalyticsViewOptions;
573
+ trustedPlatform?: TrustedPlatform;
574
+ access?: AnalyticsAccessOptions;
256
575
  capture?: AnalyticsCaptureOptions;
257
576
  /**
258
- * Conversion goals the tracker and the native ingest match events against. Slugs must
259
- * be unique and kebab-case; only the slug and its match reach the browser.
577
+ * Conversion goals the tracker and native ingest match events against: a list, or `{ defaults,
578
+ * collection, purchase }`. A goal's name never reaches the browser.
260
579
  */
261
580
  goals?: Goal[] | AnalyticsGoalsOptions;
262
581
  /**
@@ -264,47 +583,44 @@ type AnalyticsPluginOptions = {
264
583
  * augmented, each slug's resolvers receive that collection's typed document.
265
584
  */
266
585
  collections?: { [TSlug in CollectionSlug]?: AnalyticsBinding<TSlug> };
267
- cache?: {
268
- ttl?: {
269
- aggregate?: number;
270
- realtime?: number;
271
- };
272
- warm?: boolean | {
273
- cron?: string;
274
- }; /** Per-read provider timeout in ms, spanning retries and limiter waits. Default 15000. */
275
- timeoutMs?: number;
276
- };
277
- widgets?: boolean | {
278
- disabled?: string[];
279
- register?: CustomWidgetDef[];
280
- /**
281
- * Marks the free-text widget config fields (each widget's Title) as
282
- * `localized`. Off by default; takes effect only when the Payload config
283
- * enables localization (Payload strips the flag otherwise).
284
- */
285
- localizeText?: boolean;
286
- /**
287
- * Period-over-period comparison on the metric and trend widgets. On by
288
- * default for every source except one whose adapter sets
289
- * `capabilities.comparison` false; set false to skip the second
290
- * (previous-window) read entirely.
291
- */
292
- comparison?: boolean;
293
- };
586
+ providers?: ProvidersOptions;
294
587
  /**
295
- * Opt-in sync tier: a cron job that persists each provider's daily metrics into a
296
- * queryable collection. Reads go through the surfacing cache, so persisted rows reflect
297
- * cached values up to `cache.ttl.aggregate` old; keep that TTL below the sync interval
298
- * for the freshest data.
299
- */
300
- sync?: boolean | {
301
- collectionSlug?: CollectionSlug;
302
- cron?: string;
303
- lookbackDays?: number;
304
- adapters?: string[]; /** Surface the analytics-daily collection in the admin nav. Default false (hidden). */
305
- hidden?: boolean;
306
- };
588
+ * The analytics admin view and its nav link, on by default. `false` registers neither;
589
+ * the read endpoints stay mounted either way, so a custom surface keeps working.
590
+ */
591
+ view?: false | AnalyticsViewOptions;
592
+ /**
593
+ * Dashboard widgets, on by default. Payload's dashboard is experimental, so this option is too.
594
+ *
595
+ * @beta
596
+ */
597
+ widgets?: boolean | AnalyticsWidgetsOptions;
598
+ /**
599
+ * Flag beside country names in the view, widgets and document panel. Default on, served by the
600
+ * plugin's cached route; `false` shows none, `{ Component }` draws the host's own.
601
+ *
602
+ * @beta
603
+ */
604
+ countryFlags?: boolean | AnalyticsCountryFlags;
605
+ cache?: AnalyticsCacheOptions;
606
+ /**
607
+ * Opt-in sync tier: `analytics-sync` copies each vendor source's daily metrics into a queryable
608
+ * collection, every six hours unless `jobs.tasks.sync` says otherwise.
609
+ */
610
+ sync?: boolean | AnalyticsSyncOptions;
611
+ routes?: AnalyticsRoutesOptions;
612
+ /**
613
+ * The plugin's tasks (maintain, sync, warm) on `jobs.queue`, scheduled by `jobs.tasks`. `false`
614
+ * registers none: reads and ingest then do native upkeep, and sync or warming is refused.
615
+ */
616
+ jobs?: false | AnalyticsJobsOptions;
617
+ /**
618
+ * Optional packages handed in, which a standalone or serverless build then ships: GA4's
619
+ * `{ BetaAnalyticsDataClient }` and MaxMind's `{ open }`. A production boot warns about one missing.
620
+ */
621
+ sdks?: AnalyticsSdks;
622
+ hooks?: AnalyticsHooksOptions;
307
623
  };
308
624
  //#endregion
309
- export { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ResolvedAutoCapture, ScopeResolver, ScopesResolver, TimezoneResolver };
625
+ export { AnalyticsAccessOptions, AnalyticsCacheCollectionOptions, AnalyticsCacheOptions, AnalyticsCaptureOptions, AnalyticsComponent, AnalyticsConcurrencyOptions, AnalyticsCountryFlags, AnalyticsCrossScopeOptions, AnalyticsExclusionOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsHooksOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsRevenueOptions, AnalyticsRoutesOptions, AnalyticsScopeOptions, AnalyticsSyncCollectionOptions, AnalyticsSyncOptions, AnalyticsViewAccess, AnalyticsViewOptions, AnalyticsWarmOptions, AnalyticsWidgetOverride, AnalyticsWidgetOverrides, AnalyticsWidgetsOptions, AutoCaptureOptions, CaptureGate, CaptureGateArgs, CaptureSlotOption, CrossScopeAccess, CurrencyResolver, ExclusionSitesResolver, ItemCaptureOptions, ProviderHostsOptions, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ProvidersResolveArgs, ScopeCallSite, ScopeLabelResolver, ScopeListResolver, ScopeMemberAccess, ScopeResolver, TimezoneResolver };
310
626
  //# sourceMappingURL=options.d.ts.map