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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1,105 @@
1
+ import { kindOf } from "./values.js";
2
+ import { flatFieldName, keysOf, optionsObject } from "./optionChecks.js";
3
+ //#region src/core/collectionOption.ts
4
+ /** Only that it is a function can be checked at run time; the option's type promises the rest. */
5
+ const isOverrides = (value) => typeof value === "function";
6
+ /** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */
7
+ const overridesOf = (value, path) => {
8
+ if (value === void 0) return;
9
+ if (!isOverrides(value)) throw new Error(`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`);
10
+ return value;
11
+ };
12
+ /** A collection slug option checked at boot, trimmed, or the default when unset. */
13
+ const slugOf = (value, path, fallback) => {
14
+ if (value === void 0) return fallback;
15
+ if (typeof value !== "string" || value.trim() === "") throw new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`);
16
+ return value.trim();
17
+ };
18
+ /**
19
+ * One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`
20
+ * lists the other keys the option takes beside those two.
21
+ */
22
+ const resolveCollectionOption = (value, where) => {
23
+ const { path, fallback, extra = [] } = where;
24
+ if (value === void 0) return { slug: fallback };
25
+ const shaped = optionsObject(value, {
26
+ path,
27
+ known: [
28
+ "slug",
29
+ "overrides",
30
+ ...extra
31
+ ],
32
+ example: `an object such as { slug: '${fallback}' }`
33
+ });
34
+ const overrides = overridesOf(shaped.overrides, `${path}.overrides`);
35
+ return {
36
+ slug: slugOf(shaped.slug, `${path}.slug`, fallback),
37
+ ...overrides ? { overrides } : {}
38
+ };
39
+ };
40
+ /** The field a scoped plugin collection stamps each document's scope into, by default. */
41
+ const DEFAULT_SCOPE_FIELD = "scope";
42
+ const COLLECTION_ACCESS_KEYS = keysOf({
43
+ admin: true,
44
+ create: true,
45
+ delete: true,
46
+ read: true,
47
+ readVersions: true,
48
+ unlock: true,
49
+ update: true,
50
+ validate: true
51
+ });
52
+ /** `access` on one of the plugin's collections: a Payload access function per operation. */
53
+ const assertCollectionAccess = (value, path) => {
54
+ if (value === void 0) return;
55
+ const access = optionsObject(value, {
56
+ path,
57
+ known: COLLECTION_ACCESS_KEYS,
58
+ example: "an object such as { read }"
59
+ });
60
+ for (const [operation, fn] of Object.entries(access)) if (fn !== void 0 && typeof fn !== "function") throw new Error(`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`);
61
+ };
62
+ /** A collection's `fields` overrides: one function per field it may replace. */
63
+ const assertFieldOverrides = (value, path, known) => {
64
+ if (value === void 0) return;
65
+ const fields = optionsObject(value, {
66
+ path,
67
+ known,
68
+ example: "an object such as { name: ({ defaultField }) => defaultField }"
69
+ });
70
+ for (const [name, override] of Object.entries(fields)) if (override !== void 0 && typeof override !== "function") throw new Error(`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`);
71
+ };
72
+ /**
73
+ * A scoped collection option: off when unset or false, on under its defaults for `true`, and an
74
+ * object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.
75
+ */
76
+ const resolveScopedCollection = (option, at) => {
77
+ if (option === void 0 || typeof option === "boolean") return {
78
+ enabled: option === true,
79
+ slug: at.fallback,
80
+ scopeField: DEFAULT_SCOPE_FIELD
81
+ };
82
+ const shaped = optionsObject(option, {
83
+ path: at.path,
84
+ known: at.known,
85
+ example: `true, or an object such as { slug: '${at.exampleSlug}' }`
86
+ });
87
+ assertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys);
88
+ assertCollectionAccess(shaped.access, `${at.path}.access`);
89
+ const overrides = overridesOf(option.overrides, `${at.path}.overrides`);
90
+ return {
91
+ enabled: true,
92
+ slug: slugOf(option.slug, `${at.path}.slug`, at.fallback),
93
+ scopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {
94
+ path: `${at.path}.scopeField`,
95
+ reason: "the scope stamp writes it as a flat key"
96
+ }),
97
+ ...option.fields ? { fields: option.fields } : {},
98
+ ...overrides ? { overrides } : {},
99
+ ...option.access ? { access: option.access } : {}
100
+ };
101
+ };
102
+ //#endregion
103
+ export { resolveCollectionOption, resolveScopedCollection };
104
+
105
+ //# sourceMappingURL=collectionOption.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collectionOption.js","names":[],"sources":["../../src/core/collectionOption.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\nimport { flatFieldName, keysOf, optionsObject } from './optionChecks'\nimport { kindOf } from './values'\n\n/** Reshapes one of the plugin's generated collections; handed the finished config, it returns one. */\nexport type CollectionOverrides = (collection: CollectionConfig) => CollectionConfig\n\n/** A plugin collection's name and shape, as each option naming one takes them. */\nexport type AnalyticsCollectionOptions = {\n\t/** The slug every part of the plugin reads the collection under. */\n\tslug?: string\n\t/**\n\t * Reshapes the generated collection last. It may not rename it (`slug` does that) nor take away\n\t * what the plugin reads and writes: the boot checks both, naming the collection and the field.\n\t */\n\toverrides?: CollectionOverrides\n}\n\nexport interface ResolvedCollectionOption {\n\tslug: string\n\toverrides?: CollectionOverrides\n}\n\n/** Only that it is a function can be checked at run time; the option's type promises the rest. */\nconst isOverrides = (value: unknown): value is CollectionOverrides => typeof value === 'function'\n\n/** `overrides` checked at boot: a function or nothing, since no object is ever merged in. */\nexport const overridesOf = (value: unknown, path: string): CollectionOverrides | undefined => {\n\tif (value === undefined) {\n\t\treturn undefined\n\t}\n\tif (!isOverrides(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${path} must be a function, (collection) => collection, got ${kindOf(value)}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** A collection slug option checked at boot, trimmed, or the default when unset. */\nexport const slugOf = (value: unknown, path: string, fallback: string): string => {\n\tif (value === undefined) {\n\t\treturn fallback\n\t}\n\tif (typeof value !== 'string' || value.trim() === '') {\n\t\tthrow new Error(`analytics: ${path} must be a non-empty collection slug, got ${kindOf(value)}`)\n\t}\n\treturn value.trim()\n}\n\n/**\n * One `{ slug, overrides }` option checked at boot. `path` names it in every refusal, and `extra`\n * lists the other keys the option takes beside those two.\n */\nexport const resolveCollectionOption = (\n\tvalue: unknown,\n\twhere: { path: string; fallback: string; extra?: readonly string[] }\n): ResolvedCollectionOption => {\n\tconst { path, fallback, extra = [] } = where\n\tif (value === undefined) {\n\t\treturn { slug: fallback }\n\t}\n\tconst shaped = optionsObject(value, {\n\t\tpath,\n\t\tknown: ['slug', 'overrides', ...extra],\n\t\texample: `an object such as { slug: '${fallback}' }`,\n\t})\n\tconst overrides = overridesOf(shaped.overrides, `${path}.overrides`)\n\treturn {\n\t\tslug: slugOf(shaped.slug, `${path}.slug`, fallback),\n\t\t...(overrides ? { overrides } : {}),\n\t}\n}\n\n/** The field a scoped plugin collection stamps each document's scope into, by default. */\nconst DEFAULT_SCOPE_FIELD = 'scope'\n\ntype CollectionAccess = Partial<CollectionConfig['access']>\n\nconst COLLECTION_ACCESS_KEYS = keysOf<NonNullable<CollectionConfig['access']>>({\n\tadmin: true,\n\tcreate: true,\n\tdelete: true,\n\tread: true,\n\treadVersions: true,\n\tunlock: true,\n\tupdate: true,\n\tvalidate: true,\n})\n\n/** `access` on one of the plugin's collections: a Payload access function per operation. */\nconst assertCollectionAccess = (value: unknown, path: string): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst access = optionsObject(value, {\n\t\tpath,\n\t\tknown: COLLECTION_ACCESS_KEYS,\n\t\texample: 'an object such as { read }',\n\t})\n\tfor (const [operation, fn] of Object.entries(access)) {\n\t\tif (fn !== undefined && typeof fn !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${operation} must be an access function, got ${kindOf(fn)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** A collection's `fields` overrides: one function per field it may replace. */\nconst assertFieldOverrides = (value: unknown, path: string, known: readonly string[]): void => {\n\tif (value === undefined) {\n\t\treturn\n\t}\n\tconst fields = optionsObject(value, {\n\t\tpath,\n\t\tknown,\n\t\texample: 'an object such as { name: ({ defaultField }) => defaultField }',\n\t})\n\tfor (const [name, override] of Object.entries(fields)) {\n\t\tif (override !== undefined && typeof override !== 'function') {\n\t\t\tthrow new Error(\n\t\t\t\t`analytics: ${path}.${name} must be a function receiving { defaultField }, got ${kindOf(override)}`\n\t\t\t)\n\t\t}\n\t}\n}\n\n/** What an opt-in collection whose documents belong to a scope takes (goals, providers). */\ninterface ScopedCollectionOptions<TFields> {\n\tslug?: string\n\tscopeField?: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** A scoped collection option resolved: on or off, its slug and scope field filled. */\nexport interface ResolvedScopedCollection<TFields> {\n\tenabled: boolean\n\tslug: string\n\tscopeField: string\n\tfields?: TFields\n\toverrides?: CollectionOverrides\n\taccess?: CollectionAccess\n}\n\n/** Where a scoped collection option sits, and what it takes. */\ninterface ScopedCollectionAt {\n\tpath: string\n\tfallback: string\n\t/** Every key the option takes. */\n\tknown: readonly string[]\n\t/** The fields its `fields` may replace. */\n\tfieldKeys: readonly string[]\n\t/** The custom slug a refusal shows as an example. */\n\texampleSlug: string\n}\n\n/**\n * A scoped collection option: off when unset or false, on under its defaults for `true`, and an\n * object checked for its keys, `fields`, `access`, `overrides`, slug and scope field.\n */\nexport const resolveScopedCollection = <TFields>(\n\toption: boolean | ScopedCollectionOptions<TFields> | undefined,\n\tat: ScopedCollectionAt\n): ResolvedScopedCollection<TFields> => {\n\tif (option === undefined || typeof option === 'boolean') {\n\t\treturn { enabled: option === true, slug: at.fallback, scopeField: DEFAULT_SCOPE_FIELD }\n\t}\n\tconst shaped = optionsObject(option, {\n\t\tpath: at.path,\n\t\tknown: at.known,\n\t\texample: `true, or an object such as { slug: '${at.exampleSlug}' }`,\n\t})\n\tassertFieldOverrides(shaped.fields, `${at.path}.fields`, at.fieldKeys)\n\tassertCollectionAccess(shaped.access, `${at.path}.access`)\n\tconst overrides = overridesOf(option.overrides, `${at.path}.overrides`)\n\treturn {\n\t\tenabled: true,\n\t\tslug: slugOf(option.slug, `${at.path}.slug`, at.fallback),\n\t\tscopeField: flatFieldName(option.scopeField ?? DEFAULT_SCOPE_FIELD, {\n\t\t\tpath: `${at.path}.scopeField`,\n\t\t\treason: 'the scope stamp writes it as a flat key',\n\t\t}),\n\t\t...(option.fields ? { fields: option.fields } : {}),\n\t\t...(overrides ? { overrides } : {}),\n\t\t...(option.access ? { access: option.access } : {}),\n\t}\n}\n"],"mappings":";;;;AAwBA,MAAM,eAAe,UAAiD,OAAO,UAAU;;AAGvF,MAAa,eAAe,OAAgB,SAAkD;CAC7F,IAAI,UAAU,KAAA,GACb;CAED,IAAI,CAAC,YAAY,KAAK,GACrB,MAAM,IAAI,MACT,cAAc,KAAK,uDAAuD,OAAO,KAAK,GACvF;CAED,OAAO;AACR;;AAGA,MAAa,UAAU,OAAgB,MAAc,aAA6B;CACjF,IAAI,UAAU,KAAA,GACb,OAAO;CAER,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IACjD,MAAM,IAAI,MAAM,cAAc,KAAK,4CAA4C,OAAO,KAAK,GAAG;CAE/F,OAAO,MAAM,KAAK;AACnB;;;;;AAMA,MAAa,2BACZ,OACA,UAC8B;CAC9B,MAAM,EAAE,MAAM,UAAU,QAAQ,CAAC,MAAM;CACvC,IAAI,UAAU,KAAA,GACb,OAAO,EAAE,MAAM,SAAS;CAEzB,MAAM,SAAS,cAAc,OAAO;EACnC;EACA,OAAO;GAAC;GAAQ;GAAa,GAAG;EAAK;EACrC,SAAS,8BAA8B,SAAS;CACjD,CAAC;CACD,MAAM,YAAY,YAAY,OAAO,WAAW,GAAG,KAAK,WAAW;CACnE,OAAO;EACN,MAAM,OAAO,OAAO,MAAM,GAAG,KAAK,QAAQ,QAAQ;EAClD,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;CAClC;AACD;;AAGA,MAAM,sBAAsB;AAI5B,MAAM,yBAAyB,OAAgD;CAC9E,OAAO;CACP,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,cAAc;CACd,QAAQ;CACR,QAAQ;CACR,UAAU;AACX,CAAC;;AAGD,MAAM,0BAA0B,OAAgB,SAAuB;CACtE,IAAI,UAAU,KAAA,GACb;CAED,MAAM,SAAS,cAAc,OAAO;EACnC;EACA,OAAO;EACP,SAAS;CACV,CAAC;CACD,KAAK,MAAM,CAAC,WAAW,OAAO,OAAO,QAAQ,MAAM,GAClD,IAAI,OAAO,KAAA,KAAa,OAAO,OAAO,YACrC,MAAM,IAAI,MACT,cAAc,KAAK,GAAG,UAAU,mCAAmC,OAAO,EAAE,GAC7E;AAGH;;AAGA,MAAM,wBAAwB,OAAgB,MAAc,UAAmC;CAC9F,IAAI,UAAU,KAAA,GACb;CAED,MAAM,SAAS,cAAc,OAAO;EACnC;EACA;EACA,SAAS;CACV,CAAC;CACD,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,MAAM,GACnD,IAAI,aAAa,KAAA,KAAa,OAAO,aAAa,YACjD,MAAM,IAAI,MACT,cAAc,KAAK,GAAG,KAAK,sDAAsD,OAAO,QAAQ,GACjG;AAGH;;;;;AAqCA,MAAa,2BACZ,QACA,OACuC;CACvC,IAAI,WAAW,KAAA,KAAa,OAAO,WAAW,WAC7C,OAAO;EAAE,SAAS,WAAW;EAAM,MAAM,GAAG;EAAU,YAAY;CAAoB;CAEvF,MAAM,SAAS,cAAc,QAAQ;EACpC,MAAM,GAAG;EACT,OAAO,GAAG;EACV,SAAS,uCAAuC,GAAG,YAAY;CAChE,CAAC;CACD,qBAAqB,OAAO,QAAQ,GAAG,GAAG,KAAK,UAAU,GAAG,SAAS;CACrE,uBAAuB,OAAO,QAAQ,GAAG,GAAG,KAAK,QAAQ;CACzD,MAAM,YAAY,YAAY,OAAO,WAAW,GAAG,GAAG,KAAK,WAAW;CACtE,OAAO;EACN,SAAS;EACT,MAAM,OAAO,OAAO,MAAM,GAAG,GAAG,KAAK,QAAQ,GAAG,QAAQ;EACxD,YAAY,cAAc,OAAO,cAAc,qBAAqB;GACnE,MAAM,GAAG,GAAG,KAAK;GACjB,QAAQ;EACT,CAAC;EACD,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;EACjD,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;EACjC,GAAI,OAAO,SAAS,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;CAClD;AACD"}
@@ -0,0 +1,7 @@
1
+ //#region src/core/collectionSlug.ts
2
+ /** Whether the instance registered a collection under `slug`. */
3
+ const isCollectionSlug = (payload, slug) => Object.hasOwn(payload.collections, slug);
4
+ //#endregion
5
+ export { isCollectionSlug };
6
+
7
+ //# sourceMappingURL=collectionSlug.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collectionSlug.js","names":[],"sources":["../../src/core/collectionSlug.ts"],"sourcesContent":["import type { CollectionSlug, Payload } from 'payload'\n\n/** Whether the instance registered a collection under `slug`. */\nexport const isCollectionSlug = (payload: Payload, slug: string): slug is CollectionSlug =>\n\tObject.hasOwn(payload.collections, slug)\n"],"mappings":";;AAGA,MAAa,oBAAoB,SAAkB,SAClD,OAAO,OAAO,QAAQ,aAAa,IAAI"}
@@ -1,24 +1,37 @@
1
+ import { CurrencyConverter } from "../goals/currency.js";
1
2
  import { Goal } from "../goals/types.js";
3
+ import { BrowserAmounts, OrderSignatureMode } from "../goals/match.js";
4
+ import { TrustedPlatform } from "../net/platform.js";
5
+ import { RoutePaths } from "../plugin/routes.js";
2
6
  import { CaptureSupport } from "./capture.js";
3
- import { ServerTrack } from "./serverEvent.js";
4
- import { Config, PayloadRequest } from "payload";
7
+ import { AdapterJobs, AnalyticsTaskName, ScheduledTask } from "./jobs.js";
8
+ import { AnalyticsSdks } from "./sdks.js";
9
+ import { IngestHostnameResolver, ServerTrack } from "./serverEvent.js";
10
+ import { Config, Payload, PayloadRequest } from "payload";
5
11
 
6
12
  //#region src/core/contract.d.ts
7
13
  /**
8
14
  * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every
9
- * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
15
+ * scope. Gated by `access.crossScope.aggregate`; the query reaches the adapter unscoped.
10
16
  */
11
17
  declare const PLATFORM_SCOPE = "*";
12
- type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
13
- /** Every breakdown key the contract defines; the registry request parsers validate against. */
14
- declare const DIMENSION_KEYS: readonly ["page", "referrer", "source", "medium", "campaign", "utmSource", "utmMedium", "utmCampaign", "utmContent", "utmTerm", "device", "browser", "os", "country", "region", "city", "language", "event", "goal"];
18
+ type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' /** Time on page: engaged time per pageview, an average in milliseconds over the pageviews it is read for. */ | 'avgDuration' /** Time per visit: engaged time per visit, an average in milliseconds over the visits it is read for. */ | 'visitDuration' | 'scrollDepth' | 'events' | 'conversions' | 'revenue' /** Times a content item was seen on screen. Counted per item only, never per page or site. */ | 'impressions' /** Clicks on a content item, the first per item and pageview. */ | 'interactions';
19
+ /**
20
+ * One metric's reading. `null` is an average or a share with nothing to average over (no
21
+ * pageviews to time, no scroll reported, no sessions to bounce): no data, not zero.
22
+ */
23
+ type MetricValue = number | null;
24
+ /** A row's or a read's metrics. A metric the source did not report is absent. */
25
+ type MetricValues = Partial<Record<MetricKey, MetricValue>>;
26
+ /** Every breakdown key the contract defines, the list request parsers validate against. */
27
+ declare const DIMENSION_KEYS: readonly ["page", "referrer", "source", "channel", "medium", "campaign", "utmSource", "utmMedium", "utmCampaign", "utmContent", "utmTerm", "device", "browser", "os", "country", "region", "city", "language", "event", "goal", "currency", "item"];
15
28
  type DimensionKey = (typeof DIMENSION_KEYS)[number];
16
29
  type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
17
30
  interface DateRange {
18
31
  start: Date;
19
32
  end: Date;
20
33
  }
21
- /** Every filter operator the contract defines; the registry request parsers validate against. */
34
+ /** Every filter operator the contract defines, the list request parsers validate against. */
22
35
  declare const FILTER_OPERATORS: readonly ["eq", "contains", "matches"];
23
36
  type FilterOperator = (typeof FILTER_OPERATORS)[number];
24
37
  interface AnalyticsFilter {
@@ -29,86 +42,195 @@ interface AnalyticsFilter {
29
42
  interface AnalyticsQuery {
30
43
  path?: string;
31
44
  hostname?: string;
45
+ /**
46
+ * One content item's ref (`<collection>:<id>`): the read answers about that item, wherever
47
+ * it was shown. Only a source declaring `capabilities.perItemQuery` can serve it.
48
+ */
49
+ item?: string;
32
50
  metrics: MetricKey[];
33
51
  dimensions?: DimensionKey[];
34
52
  dateRange: DateRange;
35
53
  granularity?: Granularity;
36
54
  filters?: AnalyticsFilter[];
37
55
  limit?: number;
56
+ /**
57
+ * How a breakdown is ranked before `limit` cuts it. The metric belongs in `metrics`: ranked by
58
+ * one the read did not ask for, rows keep the source's order.
59
+ */
38
60
  order?: {
39
61
  metric: MetricKey;
40
62
  direction: 'asc' | 'desc';
41
63
  };
42
64
  /**
43
- * Analytics boundary this read belongs to (tenant id, site key). Undefined means
44
- * install-wide (the default). Adapters that can filter by scope apply it; others
45
- * ignore it. Always part of the surfacing cache key, so per-scope adapter
46
- * instances sharing an id never share cached results.
65
+ * Analytics boundary of the read (tenant id, site key); undefined means install-wide. Adapters
66
+ * that can filter by scope apply it, and it is always part of the cache key.
47
67
  */
48
68
  scope?: string;
49
69
  /**
50
- * IANA reporting timezone the read's day boundaries are aligned to. Undefined
51
- * means UTC. Adapters that can bucket in a timezone apply it (PostHog, Umami);
52
- * others report in their own account timezone. Part of the cache key when set.
70
+ * IANA timezone the read's day boundaries align to; undefined means UTC. Adapters that can bucket
71
+ * in a zone apply it, others report in their account's own.
53
72
  */
54
73
  timezone?: string;
55
74
  /**
56
- * The scope's goal slugs, set by callers that ask for the `goal` dimension or the
57
- * `conversions` metric, and possibly empty when the scope configures no goals. Provider
58
- * adapters restrict goal rows to it, since nothing in a provider marks which of its
59
- * events are this install's goals; the native engine ignores it and matches completions
60
- * itself. `'unresolved'` is the sentinel for a goal resolver that failed: the read keeps
61
- * its site numbers, reports `goalsUnresolved`, and never shares a healthy cache key.
62
- * Part of the surfacing cache key when set.
75
+ * The scope's goal slugs, which provider adapters restrict goal rows to (native matches goals
76
+ * itself). `'unresolved'` marks a failed goal resolver and never shares a healthy cache key.
63
77
  */
64
78
  goalSlugs?: string[] | 'unresolved';
65
79
  }
66
80
  interface AnalyticsRow {
67
81
  dimensions?: Partial<Record<DimensionKey, string>>;
68
- metrics: Partial<Record<MetricKey, number>>;
82
+ metrics: MetricValues;
69
83
  timestamp?: string;
84
+ /**
85
+ * How many observations each average in `metrics` was taken over, which folds days into weeks
86
+ * exactly. An average without one is weighted by its row's matching count.
87
+ */
88
+ samples?: Partial<Record<MetricKey, number>>;
70
89
  }
90
+ /** How a read's `visitors` were counted. */
91
+ type VisitorCounting = 'distinct' | 'sumOfDaily';
92
+ /** Why a stale answer's source needs a look: its settings were refused, or its host is not allowed. */
93
+ type SourceErrorKind = 'misconfigured' | 'host-refused';
71
94
  interface AnalyticsResult {
72
95
  rows: AnalyticsRow[];
73
- totals?: Partial<Record<MetricKey, number>>;
96
+ totals?: MetricValues;
74
97
  meta: {
75
- provider: string;
76
- sampled?: boolean;
77
- clamped?: boolean;
78
- fetchedAt: string; /** Served from an expired cache entry because the live refresh failed. */
98
+ provider: string; /** The source counted from a sample of its data (GA4 on a large property), so the numbers are estimates. */
99
+ sampled?: boolean; /** The read covers less than it asked for: from `dataFrom` and up to `dataTo`, where set. */
100
+ clamped?: boolean; /** ISO instant the data starts at, set with `clamped` when later than the range's start. */
101
+ dataFrom?: string;
102
+ /**
103
+ * ISO instant the data ends at, set with `clamped` when earlier than the range's end: a day
104
+ * the range cuts lies past raw retention in a scope's own zone.
105
+ */
106
+ dataTo?: string;
107
+ /**
108
+ * `distinct` counts each person once per number; `sumOfDaily` means some number adds up daily
109
+ * visitors, so a person who came on two days counts twice.
110
+ */
111
+ visitorsAre?: VisitorCounting; /** Some days of the range could not be read yet, so the numbers are a floor. */
112
+ partial?: {
113
+ missingDays: number;
114
+ };
115
+ /**
116
+ * On this many days of the range a value the read asks about was folded into the `(other)`
117
+ * row of its daily totals, and its raw hits are no longer kept: the numbers are a floor.
118
+ */
119
+ capped?: {
120
+ days: number;
121
+ };
122
+ /**
123
+ * On this many days of the range counting failed again and again and was given up: each is
124
+ * read from an earlier count when it had one, and left out otherwise.
125
+ */
126
+ failed?: {
127
+ days: number;
128
+ };
129
+ /**
130
+ * The scope's reporting timezone could not be resolved and none was ever recorded, so this
131
+ * read cut its days in UTC and counted nothing for later reads.
132
+ */
133
+ timezoneUnresolved?: true; /** ISO instant the numbers were last brought up to date, when older than `fetchedAt`. */
134
+ asOf?: string;
135
+ /**
136
+ * ISO instant the source was read (`ctx.now`), never later than the engine got the answer; a
137
+ * cached answer keeps it.
138
+ */
139
+ fetchedAt: string;
140
+ /**
141
+ * ISO 4217 code `revenue` is reported in: the vendor's own, else the install's
142
+ * `revenue.currency` or the read's `currency` filter. Absent, revenue is a plain sum as sent.
143
+ */
144
+ currency?: string;
145
+ /**
146
+ * The currencies the read's revenue adds unconverted amounts of, when more than one. Native
147
+ * sets it.
148
+ */
149
+ mixedCurrencies?: string[];
150
+ /**
151
+ * Served from a cache entry past its TTL: at once while a refresh runs, or because the refresh
152
+ * failed. `asOf` then says when the entry was fetched.
153
+ */
79
154
  stale?: boolean;
155
+ /**
156
+ * Set on a stale answer whose source last failed as set up rather than as an outage:
157
+ * credentials refused (`misconfigured`) or host not allowed (`host-refused`).
158
+ */
159
+ sourceError?: SourceErrorKind;
80
160
  /**
81
161
  * Filters the source could not carry, so the rows are wider than the query asked for.
82
162
  * A provider whose API takes one value per dimension reports the ones it dropped here.
83
163
  */
84
164
  unappliedFilters?: AnalyticsFilter[];
85
165
  /**
86
- * The read's goal numbers are absent because resolving them failed: it ran without
87
- * `AnalyticsQuery.goalSlugs`, or with `'unresolved'`, or the provider rejected the goal
88
- * request and the rest of the read was served without it. A scope that configured no
89
- * goals is an empty result instead, not this flag.
166
+ * The read's goal numbers are absent because resolving them failed. A scope with no goals gets
167
+ * an empty result instead, not this flag.
90
168
  */
91
169
  goalsUnresolved?: true;
170
+ /**
171
+ * Pageviews of the read counted without consent, at a cookieless or anonymous level, which
172
+ * the view shows as a share of all pageviews. Absent when the source cannot tell or found none.
173
+ */
174
+ withoutConsent?: {
175
+ pageviews: number;
176
+ };
177
+ /**
178
+ * Pageviews of the read recorded without a visitor (native's anonymous level): they count as
179
+ * pageviews, and toward no visitor, visit, bounce rate or time.
180
+ */
181
+ withoutVisitor?: {
182
+ pageviews: number;
183
+ };
184
+ /**
185
+ * The vendor drops what a slot counts without consent, so those visits are missing from every
186
+ * number: PostHog with its project's cookieless tracking setting off.
187
+ */
188
+ withoutConsentDropped?: true;
92
189
  };
93
190
  }
94
191
  /**
95
- * A read carrying conversions costs a provider up to twice the requests: the goal numbers
96
- * come from a second, goal-filtered request the adapter issues after the plain one.
192
+ * The vendor's limits the source's lane keeps to, one token per upstream request per window. A read
193
+ * with conversions may cost a second, goal-filtered request.
97
194
  */
98
195
  interface RateLimitDescriptor {
99
196
  requestsPerMinute?: number;
100
197
  requestsPerHour?: number;
198
+ /** Upstream requests the source may have in flight; `cache.concurrency.perSource` when unset. */
101
199
  maxConcurrent?: number;
200
+ /** Whether reads also spend the provider's write or ingest quota. */
201
+ readsCountAsUsage?: boolean;
202
+ }
203
+ /**
204
+ * Which operators each dimension can be filtered with. A dimension absent here, or listed with
205
+ * no operator, cannot be filtered at all.
206
+ */
207
+ type FilterOperatorMap = Partial<Record<DimensionKey, readonly FilterOperator[]>>;
208
+ /** Where a source reads one metric, when it cannot read it under every breakdown it offers. */
209
+ interface MetricReach {
102
210
  /**
103
- * Describes the provider's quota model for documentation; the limiter always
104
- * throttles by request count regardless of this value.
211
+ * The breakdowns the metric is read under; empty when only whole-site numbers carry it.
212
+ * Absent: every dimension the source declares.
105
213
  */
106
- quotaModel?: 'requests' | 'tokens';
107
- /** Documents whether reads consume the provider's write/ingest quota too. */
108
- readsCountAsUsage?: boolean;
214
+ dimensions?: readonly DimensionKey[];
215
+ /**
216
+ * A dimension the read must break down or filter by for the metric to have a value at all.
217
+ * A read of one page (`AnalyticsQuery.path`) counts as filtering by `page`.
218
+ */
219
+ requires?: DimensionKey;
220
+ }
221
+ /** What the numbers of a source mean where sources differ. */
222
+ interface MetricSemantics {
223
+ /**
224
+ * `distinct` counts each person once over a range; `sumOfDaily` adds up each day's visitors.
225
+ * Either may be per hostname: native's visitor id is, so two hostnames add up.
226
+ */
227
+ visitors: VisitorCounting;
228
+ /** `inactivity30m` ends a visit after 30 minutes without activity; `provider` is the vendor's own rule. */
229
+ sessions: 'inactivity30m' | 'provider';
109
230
  }
110
231
  interface AnalyticsCapabilities {
111
- perPageQuery: boolean;
232
+ /** The source answers `AnalyticsQuery.item`: one content item's views, clicks and outcomes. */
233
+ perItemQuery?: boolean;
112
234
  realtime: boolean;
113
235
  realtimeWindowMinutes?: number;
114
236
  /**
@@ -117,70 +239,209 @@ interface AnalyticsCapabilities {
117
239
  */
118
240
  comparison?: boolean;
119
241
  minGranularity: Granularity;
242
+ /**
243
+ * The source answers `week` and `month` series itself, exactly. Without it the engine reads
244
+ * days and folds them into weeks and months in the read's reporting timezone.
245
+ */
246
+ calendarBuckets?: boolean;
120
247
  maxLookbackDays: number | null;
248
+ /**
249
+ * How far back a filtered read reaches, when that is shorter than `maxLookbackDays`: the
250
+ * source narrows a longer one itself and marks it `clamped`. Absent or null: as far as any read.
251
+ */
252
+ filterLookbackDays?: number | null;
121
253
  metrics: ReadonlySet<MetricKey>;
122
254
  dimensions: ReadonlySet<DimensionKey>;
123
- /** Dimensions the adapter can apply AnalyticsQuery.filters on; empty = filters unsupported. */
124
- filters: ReadonlySet<DimensionKey>;
125
- /** Operators the adapter honors in filters; adapters ignore filters whose operator they lack. */
126
- filterOperators: ReadonlySet<FilterOperator>;
127
- batchPageReport: boolean;
255
+ /**
256
+ * Metrics the source reads only under some breakdowns or only for a page; any other is read under
257
+ * every dimension. Reads outside a metric's reach are refused and hidden by pickers.
258
+ */
259
+ metricReach?: Partial<Record<MetricKey, MetricReach>>;
260
+ /**
261
+ * The `AnalyticsQuery.filters` the source applies, per dimension. A read carrying any other
262
+ * pair is refused before it reaches the adapter. Absent: no filter at all.
263
+ */
264
+ filters?: FilterOperatorMap;
265
+ /** What `visitors` and `sessions` mean here. Absent: not declared. */
266
+ semantics?: MetricSemantics;
128
267
  rateLimit: RateLimitDescriptor | null;
268
+ /**
269
+ * Seconds an answer stays fresh. `today`, for a source cheap to read again, caps a window that
270
+ * reaches into the current day whatever `cache.ttl` says; such an answer is never served stale.
271
+ */
129
272
  recommendedTtl: {
130
273
  realtime: number;
131
274
  aggregate: number;
275
+ today?: number;
132
276
  };
133
277
  /**
134
- * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native
135
- * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through
136
- * a shared platform adapter would expose cross-scope data, so such reads are
137
- * gated by `access.platformRead`.
278
+ * The adapter applies `AnalyticsQuery.scope` as a native filter. Without it a scoped read through
279
+ * a shared adapter would see other scopes, so it is gated by `access.crossScope.unscopedSource`.
138
280
  */
139
281
  scopedQueries?: boolean;
282
+ /**
283
+ * The adapter sends every vendor request through `AdapterContext.upstream`, so each one spends
284
+ * its own rate token and slot. Without it the engine counts a whole read as one request.
285
+ */
286
+ upstreamAware?: boolean;
140
287
  }
141
288
  interface AdapterContext {
142
289
  signal?: AbortSignal;
290
+ /**
291
+ * The Payload instance the read is for, which the surfacing engine always passes. An adapter
292
+ * that stores its data in Payload's database reads through it.
293
+ */
294
+ payload?: Payload;
295
+ /**
296
+ * Sends one vendor request through the source's lane: rate token, slot, retries on outage,
297
+ * circuit breaker. Absent outside the engine, where `fn(ctx.signal)` is called directly.
298
+ */
299
+ upstream?: <T>(fn: (signal?: AbortSignal) => Promise<T>) => Promise<T>;
300
+ /**
301
+ * Milliseconds the read has left before it gives up, for a vendor SDK that takes a deadline of
302
+ * its own rather than a signal. Absent outside the engine.
303
+ */
304
+ remainingMs?: () => number;
305
+ /**
306
+ * What time it is by the plugin's clock (Payload's), which an adapter stamps `meta.fetchedAt`
307
+ * with. The engine always passes it; absent outside the engine.
308
+ */
309
+ now?: () => Date;
143
310
  }
144
311
  /** Extra context the plugin hands adapters when they register config surface. */
145
312
  interface AdapterRegisterContext {
146
- /** True when the plugin has a scopeResolver configured. */
313
+ /** True when the plugin has `scope.resolve` configured. */
147
314
  scoped: boolean;
148
- /** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */
315
+ /**
316
+ * `scope.resolve` at the `capture` call site, for ingest stamping: the host's resolver sees no
317
+ * user, cookies or authorization header, so a hit files under the site it landed on.
318
+ */
149
319
  resolveScope: (req: PayloadRequest) => Promise<string | null>;
150
320
  /**
151
- * The plugin's reportingTimezone bound for adapter use (e.g. bucketing native
152
- * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.
321
+ * The plugin's reportingTimezone bound for adapter use, for what is shown in it. Resolves to
322
+ * `'UTC'` when no reportingTimezone is set, and when the host's resolver fails.
153
323
  */
154
324
  resolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>;
155
325
  /**
156
- * The install's goals for a request's scope, for adapters that match completions
157
- * themselves (the native engine, at ingest). Config goals, with the goals collection
158
- * merged over them per scope once the install enables it.
326
+ * The same timezone, thrown rather than falling back to UTC: for an adapter storing days counted
327
+ * in it, where recounting a day in UTC would move its numbers.
328
+ */
329
+ resolveTimezoneStrict: (req: PayloadRequest, scope?: string | null) => Promise<string>;
330
+ /** The install's `revenue` settings, for adapters that declare or reconcile revenue. */
331
+ revenue: {
332
+ enabled: boolean;
333
+ dimension: boolean; /** `revenue.currency` bound for adapter use: `undefined` when none is set, revenue a plain number. */
334
+ currency: (req: PayloadRequest, scope?: string | null) => Promise<string | undefined>; /** `revenue.convert`, for adapters that reconcile revenue at ingest. */
335
+ convert?: CurrencyConverter; /** `revenue.browserAmounts`, for an adapter that takes amounts from the browser itself. */
336
+ browserAmounts?: BrowserAmounts; /** `revenue.orderSignature`, for an adapter that takes the browser's order ids. */
337
+ orderSignature?: OrderSignatureMode;
338
+ };
339
+ /**
340
+ * The install's goals for a request's scope (config goals, the collection's merged over them),
341
+ * for adapters that match completions themselves.
159
342
  */
160
343
  resolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>;
344
+ /**
345
+ * Whether a scope's own provider documents grant it this adapter; present only when the providers
346
+ * collection runs under `scope.resolve`. Native ingest stores nothing for a scope it denies.
347
+ */
348
+ adapterGrantedForScope?: (req: PayloadRequest, scope: string | null, adapterId: string) => Promise<boolean>;
349
+ /** The plugin's `trustedProxyHops`, for adapters that read a request's client address. */
350
+ trustedProxyHops?: number;
351
+ /**
352
+ * The plugin's `trustedPlatform`, for adapters that read a request's client address or
353
+ * location: the only platform whose edge headers may be believed.
354
+ */
355
+ trustedPlatform?: TrustedPlatform;
356
+ /**
357
+ * `capture.allowedOrigins`, normalized, for adapters that register a public POST endpoint: the
358
+ * only other sites whose pages may send to it from a visitor's browser.
359
+ */
360
+ allowedOrigins?: ReadonlySet<string>;
361
+ /**
362
+ * False when this adapter fills no slot `capture.gate` holds that can count without consent, as
363
+ * far as the boot can tell, so it need not check its vendor accepts such events. Absent reads as
364
+ * true.
365
+ */
366
+ adapterCountsWithoutConsent?: boolean;
367
+ /**
368
+ * The collections bound as content items, the only ones whose refs ingest keeps, and whether
369
+ * an item is also counted per page it appeared on. Absent means no item is bound.
370
+ */
371
+ items?: {
372
+ collections: ReadonlySet<string>;
373
+ pages: boolean;
374
+ };
375
+ /** The plugin's mounts under `routes.api`, for adapters that register an endpoint of their own. */
376
+ routes?: RoutePaths;
377
+ /**
378
+ * The packages the host handed the plugin as `sdks`, for adapters that would otherwise load
379
+ * them at runtime: GA4's Data API client, the native engine's MaxMind reader.
380
+ */
381
+ sdks?: AnalyticsSdks;
382
+ /**
383
+ * The plugin's `jobs`: the queue and schedule of the maintenance task an adapter registers, or
384
+ * false when the install registers no task and the adapter's own requests do that work instead.
385
+ */
386
+ jobs?: AdapterJobs;
387
+ /** Says something at init, once the instance can log: what the boot warns about rather than refuses. */
388
+ notice?: (message: string) => void;
389
+ }
390
+ /** What a switched-off install hands an adapter that keeps its schema (`disabled: true`). */
391
+ interface AdapterSchemaContext {
392
+ /** The plugin's `jobs`, which decides whether the adapter's task slug is in the jobs enum. */
393
+ jobs: AdapterJobs;
394
+ /** What the boot would warn about, which a switched-off install never says. */
395
+ notice?: (message: string) => void;
396
+ }
397
+ /** Whom a source's label is read for: the request, and the scope its sources were listed for. */
398
+ interface AdapterLabelArgs {
399
+ req: PayloadRequest;
400
+ /** Null is install-wide, `*` is cross-scope. */
401
+ scope: string | null;
161
402
  }
162
403
  interface AnalyticsAdapter {
163
404
  readonly id: string;
405
+ /** The source's name wherever no reader is known (boot-time pickers, logs). */
164
406
  readonly label: string;
407
+ /**
408
+ * The source's name for one reader, where it differs by language or by who reads. Read through
409
+ * `sourceLabelFor`, which falls back to `label` when this fails.
410
+ */
411
+ readonly labelFor?: (args: AdapterLabelArgs) => string | Promise<string>;
165
412
  readonly capabilities: AnalyticsCapabilities;
166
413
  /** Browser-tracker proxying/boot descriptor. Absent when no public capture field is set. */
167
414
  readonly capture?: CaptureSupport;
168
415
  /**
169
- * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the
170
- * adapters that register one (the native engine), and how server code reaches the same
171
- * pipeline without an HTTP round trip. Server-side only: the tracker learns the path
172
- * from `TrackerConfig.ingestPath`, and this object is never serialized.
416
+ * Where the adapter's own ingest endpoint listens, relative to `routes.api`, and how server code
417
+ * reaches that pipeline directly. Server-side only, never serialized.
173
418
  */
174
419
  readonly ingest?: {
175
420
  path: string;
176
421
  track?: ServerTrack;
422
+ hostname?: IngestHostnameResolver;
177
423
  };
178
424
  isConfigured(): boolean;
179
425
  query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
180
426
  realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
181
427
  register?(config: Config, context?: AdapterRegisterContext): void;
428
+ /**
429
+ * For `disabled: true`: adds exactly the schema `register` would (collections, fields, indexes,
430
+ * task slugs) and nothing that runs, so a switched-off install keeps its tables.
431
+ */
432
+ registerSchema?(config: Config, context: AdapterSchemaContext): void;
433
+ /**
434
+ * Binds the adapter to the Payload instance a runtime is built for, whenever one is, with or
435
+ * without `onInit`. Called again for every rebuild, so it must be idempotent per instance.
436
+ */
437
+ attach?(payload: Payload): void;
438
+ /**
439
+ * Releases what the adapter holds for one instance (buffers, clients, timers) once that
440
+ * instance's runtime is retired; another instance the adapter serves keeps what it holds.
441
+ */
442
+ close?(payload: Payload): void | Promise<void>;
182
443
  }
183
444
  type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
184
445
  //#endregion
185
- export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
446
+ export { AdapterContext, AdapterLabelArgs, AdapterRegisterContext, AdapterSchemaContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, FilterOperatorMap, Granularity, MetricKey, MetricReach, MetricSemantics, MetricValue, MetricValues, PLATFORM_SCOPE, RateLimitDescriptor, SourceErrorKind, VisitorCounting };
186
447
  //# sourceMappingURL=contract.d.ts.map