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

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