@10x-media/analytics 1.0.0-beta.8 → 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 +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  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 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,83 +1,88 @@
1
+ import { valueAt } from "../core/values.js";
1
2
  import { keys } from "../translations/keys.js";
3
+ import { getRuntime } from "../plugin/runtime.js";
4
+ import { normalizeHostname, requestHostname } from "../native/ingest/requestHost.js";
2
5
  import { labelForKey } from "../translations/server.js";
3
- import { validateCurrency } from "./currency.js";
6
+ import { CURRENCY_PATTERN, amountCurrencyField } from "./currency.js";
7
+ import { amountField } from "./amountField.js";
8
+ import { applyRevenueVisibility, moneyField } from "./moneyFields.js";
9
+ import { finiteNumber } from "./match.js";
10
+ import { GOAL_ACTION_TYPE } from "./constants.js";
4
11
  import { AnalyticsTrackError } from "../core/serverEvent.js";
5
- import { trackServerEvent } from "../native/ingest/serverTrack.js";
12
+ import { ingestAdapter, trackServerEvent } from "../native/ingest/serverTrack.js";
6
13
  import { goalField, goalSlug } from "./goalField.js";
7
14
  //#region src/goals/trackGoalAction.ts
8
- /** The action type form-builder stores as the block slug on a form's `actions` array. */
9
- const GOAL_ACTION_TYPE = "analyticsGoal";
10
- const configFields = () => [
15
+ /** The amount the action's currency belongs to: its fixed amount. */
16
+ const fixedAmount = ({ siblingData }) => valueAt(siblingData, "value");
17
+ const configFields = (defaultCurrency) => [
11
18
  goalField({
12
19
  name: "goal",
13
20
  required: true
14
21
  }),
15
- {
22
+ moneyField(amountField({
16
23
  name: "value",
17
24
  type: "number",
18
25
  min: 0,
19
- label: labelForKey(keys.goalFieldValue)
20
- },
21
- {
26
+ label: labelForKey(keys.goalFieldAmount)
27
+ }, {
28
+ currencyPath: "currency",
29
+ defaultCurrency
30
+ })),
31
+ moneyField({
22
32
  name: "valueFrom",
23
33
  type: "text",
24
34
  label: labelForKey(keys.actionGoalFieldValueFrom),
25
35
  admin: { description: labelForKey(keys.actionGoalFieldValueFromHelp) }
26
- },
27
- {
28
- name: "currency",
29
- type: "text",
30
- label: labelForKey(keys.goalFieldCurrency),
31
- validate: validateCurrency
32
- }
36
+ }),
37
+ moneyField(amountCurrencyField(fixedAmount))
33
38
  ];
34
- const finiteNumber = (value) => {
35
- if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
36
- if (typeof value === "string" && value.trim() !== "") {
37
- const parsed = Number(value);
38
- return Number.isFinite(parsed) ? parsed : void 0;
39
- }
39
+ const checkedCurrency = (code) => {
40
+ if (code !== void 0 && !CURRENCY_PATTERN.test(code)) throw new Error(`analytics: trackGoalAction's defaultCurrency must be a three-letter ISO 4217 code, got "${code}"`);
41
+ return code;
40
42
  };
41
43
  const nonEmpty = (value) => {
42
44
  if (typeof value !== "string") return;
43
45
  const trimmed = value.trim();
44
46
  return trimmed === "" ? void 0 : trimmed;
45
47
  };
46
- const fromOption = (option, args) => nonEmpty(typeof option === "function" ? option(args) : option ?? void 0);
47
- /**
48
- * The host out of a `Host` header. An IPv6 literal keeps its brackets, which is what the URL
49
- * spec and every other hostname in the pipeline use; only a bracketed or single-colon host
50
- * can carry a port, so a bare `::1` is left whole rather than truncated at its last colon.
51
- */
52
- const stripPort = (host) => {
53
- const bracketed = /^(\[[^\]]+\])(?::\d+)?$/.exec(host);
54
- if (bracketed?.[1]) return bracketed[1];
55
- if (host.indexOf(":") !== host.lastIndexOf(":")) return host;
56
- return host.replace(/:\d+$/, "");
57
- };
48
+ const fromOption = (option, args) => nonEmpty(typeof option === "function" ? option(args) : option);
58
49
  const serverUrlHost = (payload) => {
59
50
  const serverURL = nonEmpty(payload.config?.serverURL);
60
- if (!serverURL) return;
51
+ if (!serverURL) return null;
61
52
  try {
62
- return nonEmpty(new URL(serverURL).hostname);
53
+ return normalizeHostname(new URL(serverURL).hostname);
63
54
  } catch {
64
- return;
55
+ return null;
65
56
  }
66
57
  };
67
58
  /**
68
- * The option, then the submitting request, then the install's own `serverURL`. The queued
69
- * dispatch path reaches the last two with the runner's request, so an install that queues
70
- * actions and serves more than one site has to say which site in the option.
59
+ * The submitting host as the writing adapter's hostname policy judges it: a `Host` header is
60
+ * forgeable, and a conversion must not mint a hostname ingest would refuse.
71
61
  */
72
- const hostnameFor = (options, args) => {
73
- const configured = fromOption(options.hostname, args);
74
- if (configured) return configured.toLowerCase();
75
- const header = nonEmpty(args.req?.headers.get("host"));
76
- const fromHeader = header ? nonEmpty(stripPort(header)) : void 0;
77
- if (fromHeader) return fromHeader.toLowerCase();
78
- const fromServerUrl = serverUrlHost(args.payload);
79
- if (fromServerUrl) return fromServerUrl.toLowerCase();
80
- throw new AnalyticsTrackError("analytics: trackGoalAction could not resolve a hostname; set the `hostname` option, or configure `serverURL`, since a queued run has no submitting request");
62
+ const policyHostname = async (args, scope) => {
63
+ if (!args.req) return null;
64
+ const policy = ingestAdapter(args.payload)?.ingest?.hostname;
65
+ if (policy) return policy({
66
+ req: args.req,
67
+ scope
68
+ });
69
+ return requestHostname(args.req.headers, { trustedProxyHops: getRuntime(args.payload)?.trustedProxyHops });
70
+ };
71
+ /**
72
+ * The option, then the submitting request under the hostname policy, then `serverURL`; null means no
73
+ * site can be credited.
74
+ */
75
+ const hostnameFor = async (options, args, scope) => {
76
+ const configured = normalizeHostname(fromOption(options.hostname, args));
77
+ if (configured) return configured;
78
+ return await policyHostname(args, scope) ?? serverUrlHost(args.payload);
79
+ };
80
+ let warnedNoHostname = false;
81
+ /** Once per process, so repeated public submissions cannot choose how much the log grows. */
82
+ const warnNoHostname = (payload) => {
83
+ if (warnedNoHostname) return;
84
+ warnedNoHostname = true;
85
+ payload.logger?.warn("analytics: a form goal could not be recorded because no hostname resolved: set serverURL or check the adapter's hostname policy");
81
86
  };
82
87
  /** The fixed value wins; otherwise the named answer, and only when it reads as a number. */
83
88
  const valueFor = (args) => {
@@ -101,39 +106,39 @@ const scopeFor = async (options, args) => {
101
106
  return { scope: typeof options.scope === "function" ? await options.scope(args) : options.scope };
102
107
  };
103
108
  /**
104
- * A form-builder post-submit action that completes an analytics goal, authored per form in
105
- * the admin: pick the goal, optionally a revenue value (fixed, or read from a submission
106
- * field) and its currency. Register it through form-builder's `actions` option under
107
- * {@link GOAL_ACTION_TYPE}.
108
- *
109
- * Needs the native adapter, since it records through {@link trackServerEvent}. `essential`
110
- * is deliberately unset: a goal is a measurement, so a failed write is logged and the
111
- * submission still succeeds.
112
- *
113
- * On any install with a jobs runner, form-builder queues non-essential actions, and the
114
- * queued run carries the runner's request rather than the visitor's. Set `hostname` (and
115
- * `scope`, on a scoped install) there, since neither can be recovered from that request.
109
+ * A form-builder post-submit action completing an analytics goal, configured per form; needs the
110
+ * native adapter. Not essential: a failed write is logged and the submission still succeeds.
116
111
  */
117
112
  const trackGoalAction = (options = {}) => ({
118
113
  type: GOAL_ACTION_TYPE,
119
114
  label: keys.actionGoalLabel,
120
- config: configFields(),
115
+ config: applyRevenueVisibility(configFields(checkedCurrency(options.defaultCurrency)), options.revenue ?? true),
121
116
  run: async (args) => {
122
117
  const slug = goalSlug(args.config.goal);
123
118
  if (!slug) throw new AnalyticsTrackError("analytics: trackGoalAction has no goal configured");
119
+ const scope = await scopeFor(options, args);
120
+ const hostname = await hostnameFor(options, args, scope.scope ?? null);
121
+ if (!hostname) {
122
+ warnNoHostname(args.payload);
123
+ return;
124
+ }
125
+ const identity = typeof options.identity === "function" ? await options.identity(args) : options.identity;
124
126
  await trackServerEvent(args.payload, {
125
127
  type: "goal",
126
128
  name: slug,
127
129
  path: fromOption(options.path, args) ?? `/forms/${args.form.id}`,
128
- hostname: hostnameFor(options, args),
130
+ hostname,
129
131
  value: valueFor(args),
130
132
  currency: nonEmpty(args.config.currency),
131
133
  props: propsFor(args),
132
- ...await scopeFor(options, args)
133
- }, { req: args.req });
134
+ ...scope
135
+ }, {
136
+ req: args.req,
137
+ ...identity === void 0 ? {} : { identity }
138
+ });
134
139
  }
135
140
  });
136
141
  //#endregion
137
- export { GOAL_ACTION_TYPE, trackGoalAction };
142
+ export { trackGoalAction };
138
143
 
139
144
  //# sourceMappingURL=trackGoalAction.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"trackGoalAction.js","names":[],"sources":["../../src/goals/trackGoalAction.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\nimport { AnalyticsTrackError } from '../core/serverEvent'\nimport { trackServerEvent } from '../native/ingest/serverTrack'\nimport { keys } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport { validateCurrency } from './currency'\nimport { goalField, goalSlug } from './goalField'\n\n/** The action type form-builder stores as the block slug on a form's `actions` array. */\nexport const GOAL_ACTION_TYPE = 'analyticsGoal'\n\n/**\n * The run context form-builder hands a post-submit action, narrowed to what goal tracking\n * reads. A structural subset rather than an import: analytics never depends on form-builder\n * at runtime, so an install without it still resolves this module.\n */\nexport interface GoalActionRunArgs {\n\tform: { id: number | string; title?: string }\n\tsubmissionId: number | string\n\t/** One entry per answered field, keyed by the field's machine name. */\n\tvalues: Array<{ field: string; value: unknown }>\n\tconfig: Record<string, unknown>\n\tpayload: Payload\n\t/**\n\t * The request the action runs under. On a queued dispatch this is the job runner's own\n\t * request, not the visitor's, so it carries neither the submitting host nor the tenant.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Structural counterpart of form-builder's `ActionDefinition<Record<string, unknown>>`; a\n * value of this type is assignable to it, which `trackGoalAction.test.ts` pins.\n */\nexport interface GoalActionDefinition {\n\ttype: typeof GOAL_ACTION_TYPE\n\tlabel: string | Record<string, string>\n\tconfig: Field[]\n\trun: (args: GoalActionRunArgs) => Promise<void>\n}\n\nexport interface TrackGoalActionOptions {\n\t/**\n\t * Site the completion belongs to. Falls back to the submitting request's host, then to\n\t * the host of `serverURL`. Set it whenever a jobs runner queues actions: the runner's\n\t * request carries the CMS host at best, and often no host at all.\n\t */\n\thostname?: string | ((args: GoalActionRunArgs) => string)\n\t/** Page the completion is attributed to. Defaults to `/forms/<form id>`. */\n\tpath?: string | ((args: GoalActionRunArgs) => string)\n\t/**\n\t * Analytics boundary to stamp; `null` is install-wide. Leave unset and the scope resolves\n\t * from the action's request, which on a queued dispatch is the runner's rather than the\n\t * submitter's and so usually lands install-wide. Set it on any scoped install whose\n\t * actions are queued, since the submitter's tenant cannot be recovered there.\n\t */\n\tscope?: string | null | ((args: GoalActionRunArgs) => string | null | Promise<string | null>)\n}\n\nconst configFields = (): Field[] => [\n\tgoalField({ name: 'goal', required: true }),\n\t{\n\t\tname: 'value',\n\t\ttype: 'number',\n\t\tmin: 0,\n\t\tlabel: labelForKey(keys.goalFieldValue),\n\t},\n\t{\n\t\tname: 'valueFrom',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.actionGoalFieldValueFrom),\n\t\tadmin: { description: labelForKey(keys.actionGoalFieldValueFromHelp) },\n\t},\n\t{\n\t\tname: 'currency',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.goalFieldCurrency),\n\t\tvalidate: validateCurrency,\n\t},\n]\n\nconst finiteNumber = (value: unknown): number | undefined => {\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : undefined\n\t}\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\tconst parsed = Number(value)\n\t\treturn Number.isFinite(parsed) ? parsed : undefined\n\t}\n\treturn undefined\n}\n\nconst nonEmpty = (value: unknown): string | undefined => {\n\tif (typeof value !== 'string') {\n\t\treturn undefined\n\t}\n\tconst trimmed = value.trim()\n\treturn trimmed === '' ? undefined : trimmed\n}\n\nconst fromOption = (\n\toption: string | ((args: GoalActionRunArgs) => string) | undefined,\n\targs: GoalActionRunArgs\n): string | undefined =>\n\tnonEmpty(typeof option === 'function' ? option(args) : (option ?? undefined))\n\n/**\n * The host out of a `Host` header. An IPv6 literal keeps its brackets, which is what the URL\n * spec and every other hostname in the pipeline use; only a bracketed or single-colon host\n * can carry a port, so a bare `::1` is left whole rather than truncated at its last colon.\n */\nconst stripPort = (host: string): string => {\n\tconst bracketed = /^(\\[[^\\]]+\\])(?::\\d+)?$/.exec(host)\n\tif (bracketed?.[1]) {\n\t\treturn bracketed[1]\n\t}\n\tif (host.indexOf(':') !== host.lastIndexOf(':')) {\n\t\treturn host\n\t}\n\treturn host.replace(/:\\d+$/, '')\n}\n\nconst serverUrlHost = (payload: Payload): string | undefined => {\n\tconst serverURL = nonEmpty(payload.config?.serverURL)\n\tif (!serverURL) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\treturn nonEmpty(new URL(serverURL).hostname)\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/**\n * The option, then the submitting request, then the install's own `serverURL`. The queued\n * dispatch path reaches the last two with the runner's request, so an install that queues\n * actions and serves more than one site has to say which site in the option.\n */\nconst hostnameFor = (options: TrackGoalActionOptions, args: GoalActionRunArgs): string => {\n\tconst configured = fromOption(options.hostname, args)\n\tif (configured) {\n\t\treturn configured.toLowerCase()\n\t}\n\tconst header = nonEmpty(args.req?.headers.get('host'))\n\tconst fromHeader = header ? nonEmpty(stripPort(header)) : undefined\n\tif (fromHeader) {\n\t\treturn fromHeader.toLowerCase()\n\t}\n\tconst fromServerUrl = serverUrlHost(args.payload)\n\tif (fromServerUrl) {\n\t\treturn fromServerUrl.toLowerCase()\n\t}\n\tthrow new AnalyticsTrackError(\n\t\t'analytics: trackGoalAction could not resolve a hostname; set the `hostname` option, or configure `serverURL`, since a queued run has no submitting request'\n\t)\n}\n\n/** The fixed value wins; otherwise the named answer, and only when it reads as a number. */\nconst valueFor = (args: GoalActionRunArgs): number | undefined => {\n\tconst fixed = finiteNumber(args.config.value)\n\tif (fixed !== undefined) {\n\t\treturn fixed\n\t}\n\tconst field = nonEmpty(args.config.valueFrom)\n\tif (!field) {\n\t\treturn undefined\n\t}\n\treturn finiteNumber(args.values.find((entry) => entry.field === field)?.value)\n}\n\nconst propsFor = (args: GoalActionRunArgs): Record<string, unknown> => {\n\tconst props: Record<string, unknown> = {\n\t\tformId: String(args.form.id),\n\t\tsubmissionId: String(args.submissionId),\n\t}\n\tconst title = nonEmpty(args.form.title)\n\tif (title) {\n\t\tprops.formTitle = title\n\t}\n\treturn props\n}\n\nconst scopeFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs\n): Promise<{ scope?: string | null }> => {\n\tif (options.scope === undefined) {\n\t\treturn {}\n\t}\n\treturn { scope: typeof options.scope === 'function' ? await options.scope(args) : options.scope }\n}\n\n/**\n * A form-builder post-submit action that completes an analytics goal, authored per form in\n * the admin: pick the goal, optionally a revenue value (fixed, or read from a submission\n * field) and its currency. Register it through form-builder's `actions` option under\n * {@link GOAL_ACTION_TYPE}.\n *\n * Needs the native adapter, since it records through {@link trackServerEvent}. `essential`\n * is deliberately unset: a goal is a measurement, so a failed write is logged and the\n * submission still succeeds.\n *\n * On any install with a jobs runner, form-builder queues non-essential actions, and the\n * queued run carries the runner's request rather than the visitor's. Set `hostname` (and\n * `scope`, on a scoped install) there, since neither can be recovered from that request.\n */\nexport const trackGoalAction = (options: TrackGoalActionOptions = {}): GoalActionDefinition => ({\n\ttype: GOAL_ACTION_TYPE,\n\tlabel: keys.actionGoalLabel,\n\tconfig: configFields(),\n\trun: async (args) => {\n\t\tconst slug = goalSlug(args.config.goal)\n\t\tif (!slug) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackGoalAction has no goal configured')\n\t\t}\n\t\tawait trackServerEvent(\n\t\t\targs.payload,\n\t\t\t{\n\t\t\t\ttype: 'goal',\n\t\t\t\tname: slug,\n\t\t\t\tpath: fromOption(options.path, args) ?? `/forms/${args.form.id}`,\n\t\t\t\thostname: hostnameFor(options, args),\n\t\t\t\tvalue: valueFor(args),\n\t\t\t\tcurrency: nonEmpty(args.config.currency),\n\t\t\t\tprops: propsFor(args),\n\t\t\t\t...(await scopeFor(options, args)),\n\t\t\t},\n\t\t\t{ req: args.req }\n\t\t)\n\t},\n})\n"],"mappings":";;;;;;;;AASA,MAAa,mBAAmB;AAkDhC,MAAM,qBAA8B;CACnC,UAAU;EAAE,MAAM;EAAQ,UAAU;CAAK,CAAC;CAC1C;EACC,MAAM;EACN,MAAM;EACN,KAAK;EACL,OAAO,YAAY,KAAK,cAAc;CACvC;CACA;EACC,MAAM;EACN,MAAM;EACN,OAAO,YAAY,KAAK,wBAAwB;EAChD,OAAO,EAAE,aAAa,YAAY,KAAK,4BAA4B,EAAE;CACtE;CACA;EACC,MAAM;EACN,MAAM;EACN,OAAO,YAAY,KAAK,iBAAiB;EACzC,UAAU;CACX;AACD;AAEA,MAAM,gBAAgB,UAAuC;CAC5D,IAAI,OAAO,UAAU,UACpB,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ,KAAA;CAEzC,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IAAI;EACrD,MAAM,SAAS,OAAO,KAAK;EAC3B,OAAO,OAAO,SAAS,MAAM,IAAI,SAAS,KAAA;CAC3C;AAED;AAEA,MAAM,YAAY,UAAuC;CACxD,IAAI,OAAO,UAAU,UACpB;CAED,MAAM,UAAU,MAAM,KAAK;CAC3B,OAAO,YAAY,KAAK,KAAA,IAAY;AACrC;AAEA,MAAM,cACL,QACA,SAEA,SAAS,OAAO,WAAW,aAAa,OAAO,IAAI,IAAK,UAAU,KAAA,CAAU;;;;;;AAO7E,MAAM,aAAa,SAAyB;CAC3C,MAAM,YAAY,0BAA0B,KAAK,IAAI;CACrD,IAAI,YAAY,IACf,OAAO,UAAU;CAElB,IAAI,KAAK,QAAQ,GAAG,MAAM,KAAK,YAAY,GAAG,GAC7C,OAAO;CAER,OAAO,KAAK,QAAQ,SAAS,EAAE;AAChC;AAEA,MAAM,iBAAiB,YAAyC;CAC/D,MAAM,YAAY,SAAS,QAAQ,QAAQ,SAAS;CACpD,IAAI,CAAC,WACJ;CAED,IAAI;EACH,OAAO,SAAS,IAAI,IAAI,SAAS,EAAE,QAAQ;CAC5C,QAAQ;EACP;CACD;AACD;;;;;;AAOA,MAAM,eAAe,SAAiC,SAAoC;CACzF,MAAM,aAAa,WAAW,QAAQ,UAAU,IAAI;CACpD,IAAI,YACH,OAAO,WAAW,YAAY;CAE/B,MAAM,SAAS,SAAS,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC;CACrD,MAAM,aAAa,SAAS,SAAS,UAAU,MAAM,CAAC,IAAI,KAAA;CAC1D,IAAI,YACH,OAAO,WAAW,YAAY;CAE/B,MAAM,gBAAgB,cAAc,KAAK,OAAO;CAChD,IAAI,eACH,OAAO,cAAc,YAAY;CAElC,MAAM,IAAI,oBACT,4JACD;AACD;;AAGA,MAAM,YAAY,SAAgD;CACjE,MAAM,QAAQ,aAAa,KAAK,OAAO,KAAK;CAC5C,IAAI,UAAU,KAAA,GACb,OAAO;CAER,MAAM,QAAQ,SAAS,KAAK,OAAO,SAAS;CAC5C,IAAI,CAAC,OACJ;CAED,OAAO,aAAa,KAAK,OAAO,MAAM,UAAU,MAAM,UAAU,KAAK,GAAG,KAAK;AAC9E;AAEA,MAAM,YAAY,SAAqD;CACtE,MAAM,QAAiC;EACtC,QAAQ,OAAO,KAAK,KAAK,EAAE;EAC3B,cAAc,OAAO,KAAK,YAAY;CACvC;CACA,MAAM,QAAQ,SAAS,KAAK,KAAK,KAAK;CACtC,IAAI,OACH,MAAM,YAAY;CAEnB,OAAO;AACR;AAEA,MAAM,WAAW,OAChB,SACA,SACwC;CACxC,IAAI,QAAQ,UAAU,KAAA,GACrB,OAAO,CAAC;CAET,OAAO,EAAE,OAAO,OAAO,QAAQ,UAAU,aAAa,MAAM,QAAQ,MAAM,IAAI,IAAI,QAAQ,MAAM;AACjG;;;;;;;;;;;;;;;AAgBA,MAAa,mBAAmB,UAAkC,CAAC,OAA6B;CAC/F,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ,aAAa;CACrB,KAAK,OAAO,SAAS;EACpB,MAAM,OAAO,SAAS,KAAK,OAAO,IAAI;EACtC,IAAI,CAAC,MACJ,MAAM,IAAI,oBAAoB,mDAAmD;EAElF,MAAM,iBACL,KAAK,SACL;GACC,MAAM;GACN,MAAM;GACN,MAAM,WAAW,QAAQ,MAAM,IAAI,KAAK,UAAU,KAAK,KAAK;GAC5D,UAAU,YAAY,SAAS,IAAI;GACnC,OAAO,SAAS,IAAI;GACpB,UAAU,SAAS,KAAK,OAAO,QAAQ;GACvC,OAAO,SAAS,IAAI;GACpB,GAAI,MAAM,SAAS,SAAS,IAAI;EACjC,GACA,EAAE,KAAK,KAAK,IAAI,CACjB;CACD;AACD"}
1
+ {"version":3,"file":"trackGoalAction.js","names":[],"sources":["../../src/goals/trackGoalAction.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\nimport { AnalyticsTrackError, type ServerTrackIdentity } from '../core/serverEvent'\nimport { valueAt } from '../core/values'\nimport { normalizeHostname, requestHostname } from '../native/ingest/requestHost'\nimport { ingestAdapter, trackServerEvent } from '../native/ingest/serverTrack'\nimport { getRuntime } from '../plugin/runtime'\nimport { keys } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport { amountField } from './amountField'\nimport { GOAL_ACTION_TYPE } from './constants'\nimport { type AmountOf, amountCurrencyField, CURRENCY_PATTERN } from './currency'\nimport { goalField, goalSlug } from './goalField'\nimport { finiteNumber } from './match'\nimport { applyRevenueVisibility, moneyField } from './moneyFields'\n\nexport { GOAL_ACTION_TYPE }\n\n/**\n * Form-builder's post-submit run context as goal tracking reads it, structural so analytics never\n * depends on form-builder at runtime.\n */\nexport interface GoalActionRunArgs {\n\tform: { id: number | string; title?: string }\n\tsubmissionId: number | string\n\t/** One entry per answered field, keyed by the field's machine name. */\n\tvalues: Array<{ field: string; value: unknown }>\n\tconfig: Record<string, unknown>\n\tpayload: Payload\n\t/**\n\t * The request the action runs under. On a queued dispatch this is the job runner's own\n\t * request, not the visitor's, so it carries neither the submitting host nor the tenant.\n\t */\n\treq?: PayloadRequest\n}\n\n/**\n * Structural counterpart of form-builder's `ActionDefinition<Record<string, unknown>>`; a\n * value of this type is assignable to it, which `trackGoalAction.test.ts` pins.\n */\nexport interface GoalActionDefinition {\n\ttype: typeof GOAL_ACTION_TYPE\n\tlabel: string | Record<string, string>\n\tconfig: Field[]\n\trun: (args: GoalActionRunArgs) => Promise<void>\n}\n\nexport interface TrackGoalActionOptions {\n\t/**\n\t * Site the completion belongs to; falls back to the submitting host (per the hostname policy), then\n\t * `serverURL`, else nothing is recorded. Set it whenever a jobs runner queues actions.\n\t */\n\thostname?: string | ((args: GoalActionRunArgs) => string)\n\t/** Page the completion is attributed to. Defaults to `/forms/<form id>`. */\n\tpath?: string | ((args: GoalActionRunArgs) => string)\n\t/**\n\t * Analytics boundary to stamp, `null` install-wide. Unset, it resolves from the action's request, so\n\t * set it on any scoped install whose actions are queued.\n\t */\n\tscope?: string | null | ((args: GoalActionRunArgs) => string | null | Promise<string | null>)\n\t/**\n\t * `'none'` records no visitor id, location, device or language; a function decides per submission\n\t * from the host's consent. Defaults as `trackServerEvent`'s `identity`.\n\t */\n\tidentity?:\n\t\t| ServerTrackIdentity\n\t\t| ((args: GoalActionRunArgs) => ServerTrackIdentity | Promise<ServerTrackIdentity>)\n\t/**\n\t * Whether the action offers amount inputs. Set it to match your `revenue` option: form-builder often\n\t * registers its blocks too late for the plugin to hide them.\n\t */\n\trevenue?: boolean\n\t/**\n\t * Currency the Amount control fills in for an amount set without one, normally your\n\t * `revenue.currency`. Unset, the editor picks.\n\t */\n\tdefaultCurrency?: string\n}\n\n/** The amount the action's currency belongs to: its fixed amount. */\nconst fixedAmount: AmountOf = ({ siblingData }) => valueAt(siblingData, 'value')\n\nconst configFields = (defaultCurrency: string | undefined): Field[] => [\n\tgoalField({ name: 'goal', required: true }),\n\tmoneyField(\n\t\tamountField(\n\t\t\t{ name: 'value', type: 'number', min: 0, label: labelForKey(keys.goalFieldAmount) },\n\t\t\t{ currencyPath: 'currency', defaultCurrency }\n\t\t)\n\t),\n\tmoneyField({\n\t\tname: 'valueFrom',\n\t\ttype: 'text',\n\t\tlabel: labelForKey(keys.actionGoalFieldValueFrom),\n\t\tadmin: { description: labelForKey(keys.actionGoalFieldValueFromHelp) },\n\t}),\n\tmoneyField(amountCurrencyField(fixedAmount)),\n]\n\nconst checkedCurrency = (code: string | undefined): string | undefined => {\n\tif (code !== undefined && !CURRENCY_PATTERN.test(code)) {\n\t\tthrow new Error(\n\t\t\t`analytics: trackGoalAction's defaultCurrency must be a three-letter ISO 4217 code, got \"${code}\"`\n\t\t)\n\t}\n\treturn code\n}\n\nconst nonEmpty = (value: unknown): string | undefined => {\n\tif (typeof value !== 'string') {\n\t\treturn undefined\n\t}\n\tconst trimmed = value.trim()\n\treturn trimmed === '' ? undefined : trimmed\n}\n\nconst fromOption = (\n\toption: string | ((args: GoalActionRunArgs) => string) | undefined,\n\targs: GoalActionRunArgs\n): string | undefined => nonEmpty(typeof option === 'function' ? option(args) : option)\n\nconst serverUrlHost = (payload: Payload): string | null => {\n\tconst serverURL = nonEmpty(payload.config?.serverURL)\n\tif (!serverURL) {\n\t\treturn null\n\t}\n\ttry {\n\t\treturn normalizeHostname(new URL(serverURL).hostname)\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The submitting host as the writing adapter's hostname policy judges it: a `Host` header is\n * forgeable, and a conversion must not mint a hostname ingest would refuse.\n */\nconst policyHostname = async (\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tif (!args.req) {\n\t\treturn null\n\t}\n\tconst policy = ingestAdapter(args.payload)?.ingest?.hostname\n\tif (policy) {\n\t\treturn policy({ req: args.req, scope })\n\t}\n\treturn requestHostname(args.req.headers, {\n\t\ttrustedProxyHops: getRuntime(args.payload)?.trustedProxyHops,\n\t})\n}\n\n/**\n * The option, then the submitting request under the hostname policy, then `serverURL`; null means no\n * site can be credited.\n */\nconst hostnameFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs,\n\tscope: string | null\n): Promise<string | null> => {\n\tconst configured = normalizeHostname(fromOption(options.hostname, args))\n\tif (configured) {\n\t\treturn configured\n\t}\n\treturn (await policyHostname(args, scope)) ?? serverUrlHost(args.payload)\n}\n\nlet warnedNoHostname = false\n\n/** Once per process, so repeated public submissions cannot choose how much the log grows. */\nconst warnNoHostname = (payload: Payload): void => {\n\tif (warnedNoHostname) {\n\t\treturn\n\t}\n\twarnedNoHostname = true\n\tpayload.logger?.warn(\n\t\t\"analytics: a form goal could not be recorded because no hostname resolved: set serverURL or check the adapter's hostname policy\"\n\t)\n}\n\n/** The fixed value wins; otherwise the named answer, and only when it reads as a number. */\nconst valueFor = (args: GoalActionRunArgs): number | undefined => {\n\tconst fixed = finiteNumber(args.config.value)\n\tif (fixed !== undefined) {\n\t\treturn fixed\n\t}\n\tconst field = nonEmpty(args.config.valueFrom)\n\tif (!field) {\n\t\treturn undefined\n\t}\n\treturn finiteNumber(args.values.find((entry) => entry.field === field)?.value)\n}\n\nconst propsFor = (args: GoalActionRunArgs): Record<string, unknown> => {\n\tconst props: Record<string, unknown> = {\n\t\tformId: String(args.form.id),\n\t\tsubmissionId: String(args.submissionId),\n\t}\n\tconst title = nonEmpty(args.form.title)\n\tif (title) {\n\t\tprops.formTitle = title\n\t}\n\treturn props\n}\n\nconst scopeFor = async (\n\toptions: TrackGoalActionOptions,\n\targs: GoalActionRunArgs\n): Promise<{ scope?: string | null }> => {\n\tif (options.scope === undefined) {\n\t\treturn {}\n\t}\n\treturn { scope: typeof options.scope === 'function' ? await options.scope(args) : options.scope }\n}\n\n/**\n * A form-builder post-submit action completing an analytics goal, configured per form; needs the\n * native adapter. Not essential: a failed write is logged and the submission still succeeds.\n */\nexport const trackGoalAction = (options: TrackGoalActionOptions = {}): GoalActionDefinition => ({\n\ttype: GOAL_ACTION_TYPE,\n\tlabel: keys.actionGoalLabel,\n\tconfig: applyRevenueVisibility(\n\t\tconfigFields(checkedCurrency(options.defaultCurrency)),\n\t\toptions.revenue ?? true\n\t),\n\trun: async (args) => {\n\t\tconst slug = goalSlug(args.config.goal)\n\t\tif (!slug) {\n\t\t\tthrow new AnalyticsTrackError('analytics: trackGoalAction has no goal configured')\n\t\t}\n\t\tconst scope = await scopeFor(options, args)\n\t\tconst hostname = await hostnameFor(options, args, scope.scope ?? null)\n\t\tif (!hostname) {\n\t\t\twarnNoHostname(args.payload)\n\t\t\treturn\n\t\t}\n\t\tconst identity =\n\t\t\ttypeof options.identity === 'function' ? await options.identity(args) : options.identity\n\t\tawait trackServerEvent(\n\t\t\targs.payload,\n\t\t\t{\n\t\t\t\ttype: 'goal',\n\t\t\t\tname: slug,\n\t\t\t\tpath: fromOption(options.path, args) ?? `/forms/${args.form.id}`,\n\t\t\t\thostname,\n\t\t\t\tvalue: valueFor(args),\n\t\t\t\tcurrency: nonEmpty(args.config.currency),\n\t\t\t\tprops: propsFor(args),\n\t\t\t\t...scope,\n\t\t\t},\n\t\t\t{ req: args.req, ...(identity === undefined ? {} : { identity }) }\n\t\t)\n\t},\n})\n"],"mappings":";;;;;;;;;;;;;;;AA+EA,MAAM,eAAyB,EAAE,kBAAkB,QAAQ,aAAa,OAAO;AAE/E,MAAM,gBAAgB,oBAAiD;CACtE,UAAU;EAAE,MAAM;EAAQ,UAAU;CAAK,CAAC;CAC1C,WACC,YACC;EAAE,MAAM;EAAS,MAAM;EAAU,KAAK;EAAG,OAAO,YAAY,KAAK,eAAe;CAAE,GAClF;EAAE,cAAc;EAAY;CAAgB,CAC7C,CACD;CACA,WAAW;EACV,MAAM;EACN,MAAM;EACN,OAAO,YAAY,KAAK,wBAAwB;EAChD,OAAO,EAAE,aAAa,YAAY,KAAK,4BAA4B,EAAE;CACtE,CAAC;CACD,WAAW,oBAAoB,WAAW,CAAC;AAC5C;AAEA,MAAM,mBAAmB,SAAiD;CACzE,IAAI,SAAS,KAAA,KAAa,CAAC,iBAAiB,KAAK,IAAI,GACpD,MAAM,IAAI,MACT,2FAA2F,KAAK,EACjG;CAED,OAAO;AACR;AAEA,MAAM,YAAY,UAAuC;CACxD,IAAI,OAAO,UAAU,UACpB;CAED,MAAM,UAAU,MAAM,KAAK;CAC3B,OAAO,YAAY,KAAK,KAAA,IAAY;AACrC;AAEA,MAAM,cACL,QACA,SACwB,SAAS,OAAO,WAAW,aAAa,OAAO,IAAI,IAAI,MAAM;AAEtF,MAAM,iBAAiB,YAAoC;CAC1D,MAAM,YAAY,SAAS,QAAQ,QAAQ,SAAS;CACpD,IAAI,CAAC,WACJ,OAAO;CAER,IAAI;EACH,OAAO,kBAAkB,IAAI,IAAI,SAAS,EAAE,QAAQ;CACrD,QAAQ;EACP,OAAO;CACR;AACD;;;;;AAMA,MAAM,iBAAiB,OACtB,MACA,UAC4B;CAC5B,IAAI,CAAC,KAAK,KACT,OAAO;CAER,MAAM,SAAS,cAAc,KAAK,OAAO,GAAG,QAAQ;CACpD,IAAI,QACH,OAAO,OAAO;EAAE,KAAK,KAAK;EAAK;CAAM,CAAC;CAEvC,OAAO,gBAAgB,KAAK,IAAI,SAAS,EACxC,kBAAkB,WAAW,KAAK,OAAO,GAAG,iBAC7C,CAAC;AACF;;;;;AAMA,MAAM,cAAc,OACnB,SACA,MACA,UAC4B;CAC5B,MAAM,aAAa,kBAAkB,WAAW,QAAQ,UAAU,IAAI,CAAC;CACvE,IAAI,YACH,OAAO;CAER,OAAQ,MAAM,eAAe,MAAM,KAAK,KAAM,cAAc,KAAK,OAAO;AACzE;AAEA,IAAI,mBAAmB;;AAGvB,MAAM,kBAAkB,YAA2B;CAClD,IAAI,kBACH;CAED,mBAAmB;CACnB,QAAQ,QAAQ,KACf,iIACD;AACD;;AAGA,MAAM,YAAY,SAAgD;CACjE,MAAM,QAAQ,aAAa,KAAK,OAAO,KAAK;CAC5C,IAAI,UAAU,KAAA,GACb,OAAO;CAER,MAAM,QAAQ,SAAS,KAAK,OAAO,SAAS;CAC5C,IAAI,CAAC,OACJ;CAED,OAAO,aAAa,KAAK,OAAO,MAAM,UAAU,MAAM,UAAU,KAAK,GAAG,KAAK;AAC9E;AAEA,MAAM,YAAY,SAAqD;CACtE,MAAM,QAAiC;EACtC,QAAQ,OAAO,KAAK,KAAK,EAAE;EAC3B,cAAc,OAAO,KAAK,YAAY;CACvC;CACA,MAAM,QAAQ,SAAS,KAAK,KAAK,KAAK;CACtC,IAAI,OACH,MAAM,YAAY;CAEnB,OAAO;AACR;AAEA,MAAM,WAAW,OAChB,SACA,SACwC;CACxC,IAAI,QAAQ,UAAU,KAAA,GACrB,OAAO,CAAC;CAET,OAAO,EAAE,OAAO,OAAO,QAAQ,UAAU,aAAa,MAAM,QAAQ,MAAM,IAAI,IAAI,QAAQ,MAAM;AACjG;;;;;AAMA,MAAa,mBAAmB,UAAkC,CAAC,OAA6B;CAC/F,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ,uBACP,aAAa,gBAAgB,QAAQ,eAAe,CAAC,GACrD,QAAQ,WAAW,IACpB;CACA,KAAK,OAAO,SAAS;EACpB,MAAM,OAAO,SAAS,KAAK,OAAO,IAAI;EACtC,IAAI,CAAC,MACJ,MAAM,IAAI,oBAAoB,mDAAmD;EAElF,MAAM,QAAQ,MAAM,SAAS,SAAS,IAAI;EAC1C,MAAM,WAAW,MAAM,YAAY,SAAS,MAAM,MAAM,SAAS,IAAI;EACrE,IAAI,CAAC,UAAU;GACd,eAAe,KAAK,OAAO;GAC3B;EACD;EACA,MAAM,WACL,OAAO,QAAQ,aAAa,aAAa,MAAM,QAAQ,SAAS,IAAI,IAAI,QAAQ;EACjF,MAAM,iBACL,KAAK,SACL;GACC,MAAM;GACN,MAAM;GACN,MAAM,WAAW,QAAQ,MAAM,IAAI,KAAK,UAAU,KAAK,KAAK;GAC5D;GACA,OAAO,SAAS,IAAI;GACpB,UAAU,SAAS,KAAK,OAAO,QAAQ;GACvC,OAAO,SAAS,IAAI;GACpB,GAAG;EACJ,GACA;GAAE,KAAK,KAAK;GAAK,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;EAAG,CAClE;CACD;AACD"}
@@ -1,33 +1,18 @@
1
+ import { TrackerGoal } from "../tracker/config.js";
2
+
1
3
  //#region src/goals/types.d.ts
2
- /**
3
- * How an incoming event is recognized as a completion of this goal. `goal` matches an
4
- * explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.
5
- */
6
- type GoalMatch = {
7
- kind: 'event';
4
+ interface Goal extends TrackerGoal {
5
+ /**
6
+ * Admin-facing label. Never leaves the server: the tracker config carries a goal's slug, match,
7
+ * value and currency alone.
8
+ */
8
9
  name: string;
9
- } | {
10
- kind: 'path';
11
- pattern: string;
12
- } | {
13
- kind: 'goal';
14
- };
15
- interface Goal {
16
- /** Stable identifier, kebab-case; unique across the install's goals. */
17
- slug: string;
18
- /** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */
19
- name: string;
20
- match: GoalMatch;
21
- /** Revenue for one completion: a fixed amount, or read from an event property. */
22
- value?: {
23
- fixed?: number;
24
- prop?: string;
25
- };
26
- /** ISO 4217 code the goal's value is denominated in. */
27
- currency?: string;
10
+ /**
11
+ * `false` makes the goal server-only: native ingest ignores a browser's completion of it, so a
12
+ * request cannot forge one. Server code (`purchase`, `trackServerEvent`) still completes it.
13
+ */
14
+ browser?: boolean;
28
15
  }
29
- /** The goal fields the browser tracker needs; `name` is admin-facing only. */
30
- type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>;
31
16
  //#endregion
32
- export { Goal, GoalMatch, TrackerGoal };
17
+ export { Goal };
33
18
  //# sourceMappingURL=types.d.ts.map
@@ -1,5 +1,5 @@
1
1
  //#region src/goals/types.ts
2
- /** Kebab-case, so a slug is safe in a URL, a data attribute, and a rollup bucket key. */
2
+ /** Kebab-case, so a slug is safe in a URL, a data attribute, and a daily total's key. */
3
3
  const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
4
4
  //#endregion
5
5
  export { GOAL_SLUG_PATTERN };
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","names":[],"sources":["../../src/goals/types.ts"],"sourcesContent":["/**\n * How an incoming event is recognized as a completion of this goal. `goal` matches an\n * explicit `trackGoal(slug)` call, which is what the attribute and action hookups emit.\n */\nexport type GoalMatch =\n\t| { kind: 'event'; name: string }\n\t| { kind: 'path'; pattern: string }\n\t| { kind: 'goal' }\n\nexport interface Goal {\n\t/** Stable identifier, kebab-case; unique across the install's goals. */\n\tslug: string\n\t/** Admin-facing label. Never leaves the server: the tracker config carries slugs only. */\n\tname: string\n\tmatch: GoalMatch\n\t/** Revenue for one completion: a fixed amount, or read from an event property. */\n\tvalue?: { fixed?: number; prop?: string }\n\t/** ISO 4217 code the goal's value is denominated in. */\n\tcurrency?: string\n}\n\n/** The goal fields the browser tracker needs; `name` is admin-facing only. */\nexport type TrackerGoal = Pick<Goal, 'slug' | 'match' | 'value' | 'currency'>\n\n/** Kebab-case, so a slug is safe in a URL, a data attribute, and a rollup bucket key. */\nexport const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\n"],"mappings":";;AAyBA,MAAa,oBAAoB"}
1
+ {"version":3,"file":"types.js","names":[],"sources":["../../src/goals/types.ts"],"sourcesContent":["import type { TrackerGoal } from '../tracker/config'\n\nexport interface Goal extends TrackerGoal {\n\t/**\n\t * Admin-facing label. Never leaves the server: the tracker config carries a goal's slug, match,\n\t * value and currency alone.\n\t */\n\tname: string\n\t/**\n\t * `false` makes the goal server-only: native ingest ignores a browser's completion of it, so a\n\t * request cannot forge one. Server code (`purchase`, `trackServerEvent`) still completes it.\n\t */\n\tbrowser?: boolean\n}\n\n/** Kebab-case, so a slug is safe in a URL, a data attribute, and a daily total's key. */\nexport const GOAL_SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\n"],"mappings":";;AAgBA,MAAa,oBAAoB"}
@@ -1,6 +1,7 @@
1
1
  import { GoalsResponse } from "./fetchGoals.js";
2
2
 
3
3
  //#region src/goals/useAnalyticsGoals.d.ts
4
+ /** @beta */
4
5
  interface AnalyticsGoals {
5
6
  /** Null until the fetch settles, and on a failed one: not the same thing as none. */
6
7
  goals: GoalsResponse['goals'] | null;
@@ -9,12 +10,12 @@ interface AnalyticsGoals {
9
10
  error: boolean;
10
11
  }
11
12
  /**
12
- * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
13
- * the fetch is in flight, when it fails, and when there is no authenticated user yet, so
14
- * a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
15
- * previous user are never returned while a new user's fetch is pending.
13
+ * The caller scope's goals for an admin picker: `goals` is null while loading, failed or signed out,
14
+ * so "loading" differs from "none". Another scope's goals never show while this one loads.
15
+ *
16
+ * @beta
16
17
  */
17
18
  declare const useAnalyticsGoals: () => AnalyticsGoals;
18
19
  //#endregion
19
- export { useAnalyticsGoals };
20
+ export { AnalyticsGoals, useAnalyticsGoals };
20
21
  //# sourceMappingURL=useAnalyticsGoals.d.ts.map
@@ -1,7 +1,10 @@
1
1
  "use client";
2
+ import { analyticsRoutes } from "../plugin/routes.js";
3
+ import { apiPath } from "../plugin/apiPath.js";
4
+ import { useRequestScope } from "../ui/data/useRequestScope.js";
2
5
  import { fetchGoals } from "./fetchGoals.js";
3
6
  import { useEffect, useState } from "react";
4
- import { useAuth, useConfig } from "@payloadcms/ui";
7
+ import { useConfig } from "@payloadcms/ui";
5
8
  //#region src/goals/useAnalyticsGoals.ts
6
9
  const EMPTY = {
7
10
  collection: null,
@@ -14,21 +17,21 @@ const FAILED = {
14
17
  goals: null
15
18
  };
16
19
  /**
17
- * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while
18
- * the fetch is in flight, when it fails, and when there is no authenticated user yet, so
19
- * a picker can tell "still loading" from "this scope has no goals". Goals fetched for a
20
- * previous user are never returned while a new user's fetch is pending.
20
+ * The caller scope's goals for an admin picker: `goals` is null while loading, failed or signed out,
21
+ * so "loading" differs from "none". Another scope's goals never show while this one loads.
22
+ *
23
+ * @beta
21
24
  */
22
25
  const useAnalyticsGoals = () => {
23
- const { user } = useAuth();
24
- const { config: { routes: { api }, serverURL } } = useConfig();
25
- const userKey = String(user?.id ?? "");
26
+ const { config } = useConfig();
27
+ const url = apiPath(config, analyticsRoutes(config).goals);
28
+ const scope = useRequestScope();
26
29
  const [state, setState] = useState({
27
30
  data: EMPTY,
28
31
  key: ""
29
32
  });
30
33
  useEffect(() => {
31
- if (!userKey) {
34
+ if (!scope) {
32
35
  setState({
33
36
  data: EMPTY,
34
37
  key: ""
@@ -36,30 +39,26 @@ const useAnalyticsGoals = () => {
36
39
  return;
37
40
  }
38
41
  let cancelled = false;
39
- fetchGoals(serverURL ?? "", api, userKey).then(({ collection, goals }) => {
42
+ fetchGoals(url, scope).then(({ collection, goals }) => {
40
43
  if (!cancelled) setState({
41
44
  data: {
42
45
  collection,
43
46
  error: false,
44
47
  goals
45
48
  },
46
- key: userKey
49
+ key: scope
47
50
  });
48
51
  }).catch(() => {
49
52
  if (!cancelled) setState({
50
53
  data: FAILED,
51
- key: userKey
54
+ key: scope
52
55
  });
53
56
  });
54
57
  return () => {
55
58
  cancelled = true;
56
59
  };
57
- }, [
58
- api,
59
- serverURL,
60
- userKey
61
- ]);
62
- return state.key === userKey ? state.data : EMPTY;
60
+ }, [url, scope]);
61
+ return state.key === scope ? state.data : EMPTY;
63
62
  };
64
63
  //#endregion
65
64
  export { useAnalyticsGoals };
@@ -1 +1 @@
1
- {"version":3,"file":"useAnalyticsGoals.js","names":[],"sources":["../../src/goals/useAnalyticsGoals.ts"],"sourcesContent":["'use client'\n\nimport { useAuth, useConfig } from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { fetchGoals, type GoalsResponse } from './fetchGoals'\n\nexport interface AnalyticsGoals {\n\t/** Null until the fetch settles, and on a failed one: not the same thing as none. */\n\tgoals: GoalsResponse['goals'] | null\n\tcollection: GoalsResponse['collection']\n\t/** The fetch settled in failure, so a picker can say so instead of claiming none exist. */\n\terror: boolean\n}\n\nconst EMPTY: AnalyticsGoals = { collection: null, error: false, goals: null }\nconst FAILED: AnalyticsGoals = { collection: null, error: true, goals: null }\n\n/**\n * Fetches the caller-scope goal list for the admin goal picker. `goals` stays null while\n * the fetch is in flight, when it fails, and when there is no authenticated user yet, so\n * a picker can tell \"still loading\" from \"this scope has no goals\". Goals fetched for a\n * previous user are never returned while a new user's fetch is pending.\n */\nexport const useAnalyticsGoals = (): AnalyticsGoals => {\n\tconst { user } = useAuth()\n\tconst {\n\t\tconfig: {\n\t\t\troutes: { api },\n\t\t\tserverURL,\n\t\t},\n\t} = useConfig()\n\tconst userKey = String(user?.id ?? '')\n\tconst [state, setState] = useState<{ key: string; data: AnalyticsGoals }>({\n\t\tdata: EMPTY,\n\t\tkey: '',\n\t})\n\n\tuseEffect(() => {\n\t\tif (!userKey) {\n\t\t\tsetState({ data: EMPTY, key: '' })\n\t\t\treturn\n\t\t}\n\t\tlet cancelled = false\n\t\tfetchGoals(serverURL ?? '', api, userKey)\n\t\t\t.then(({ collection, goals }) => {\n\t\t\t\tif (!cancelled) setState({ data: { collection, error: false, goals }, key: userKey })\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tif (!cancelled) setState({ data: FAILED, key: userKey })\n\t\t\t})\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [api, serverURL, userKey])\n\n\treturn state.key === userKey ? state.data : EMPTY\n}\n"],"mappings":";;;;;AAcA,MAAM,QAAwB;CAAE,YAAY;CAAM,OAAO;CAAO,OAAO;AAAK;AAC5E,MAAM,SAAyB;CAAE,YAAY;CAAM,OAAO;CAAM,OAAO;AAAK;;;;;;;AAQ5E,MAAa,0BAA0C;CACtD,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,EACL,QAAQ,EACP,QAAQ,EAAE,OACV,gBAEE,UAAU;CACd,MAAM,UAAU,OAAO,MAAM,MAAM,EAAE;CACrC,MAAM,CAAC,OAAO,YAAY,SAAgD;EACzE,MAAM;EACN,KAAK;CACN,CAAC;CAED,gBAAgB;EACf,IAAI,CAAC,SAAS;GACb,SAAS;IAAE,MAAM;IAAO,KAAK;GAAG,CAAC;GACjC;EACD;EACA,IAAI,YAAY;EAChB,WAAW,aAAa,IAAI,KAAK,OAAO,EACtC,MAAM,EAAE,YAAY,YAAY;GAChC,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;KAAE;KAAY,OAAO;KAAO;IAAM;IAAG,KAAK;GAAQ,CAAC;EACrF,CAAC,EACA,YAAY;GACZ,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;IAAQ,KAAK;GAAQ,CAAC;EACxD,CAAC;EACF,aAAa;GACZ,YAAY;EACb;CACD,GAAG;EAAC;EAAK;EAAW;CAAO,CAAC;CAE5B,OAAO,MAAM,QAAQ,UAAU,MAAM,OAAO;AAC7C"}
1
+ {"version":3,"file":"useAnalyticsGoals.js","names":[],"sources":["../../src/goals/useAnalyticsGoals.ts"],"sourcesContent":["'use client'\n\nimport { useConfig } from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { apiPath } from '../plugin/apiPath'\nimport { analyticsRoutes } from '../plugin/routes'\nimport { useRequestScope } from '../ui/data/useRequestScope'\nimport { fetchGoals, type GoalsResponse } from './fetchGoals'\n\n/** @beta */\nexport interface AnalyticsGoals {\n\t/** Null until the fetch settles, and on a failed one: not the same thing as none. */\n\tgoals: GoalsResponse['goals'] | null\n\tcollection: GoalsResponse['collection']\n\t/** The fetch settled in failure, so a picker can say so instead of claiming none exist. */\n\terror: boolean\n}\n\nconst EMPTY: AnalyticsGoals = { collection: null, error: false, goals: null }\nconst FAILED: AnalyticsGoals = { collection: null, error: true, goals: null }\n\n/**\n * The caller scope's goals for an admin picker: `goals` is null while loading, failed or signed out,\n * so \"loading\" differs from \"none\". Another scope's goals never show while this one loads.\n *\n * @beta\n */\nexport const useAnalyticsGoals = (): AnalyticsGoals => {\n\tconst { config } = useConfig()\n\tconst url = apiPath(config, analyticsRoutes(config).goals)\n\tconst scope = useRequestScope()\n\tconst [state, setState] = useState<{ key: string; data: AnalyticsGoals }>({\n\t\tdata: EMPTY,\n\t\tkey: '',\n\t})\n\n\tuseEffect(() => {\n\t\tif (!scope) {\n\t\t\tsetState({ data: EMPTY, key: '' })\n\t\t\treturn\n\t\t}\n\t\tlet cancelled = false\n\t\tfetchGoals(url, scope)\n\t\t\t.then(({ collection, goals }) => {\n\t\t\t\tif (!cancelled) setState({ data: { collection, error: false, goals }, key: scope })\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tif (!cancelled) setState({ data: FAILED, key: scope })\n\t\t\t})\n\t\treturn () => {\n\t\t\tcancelled = true\n\t\t}\n\t}, [url, scope])\n\n\treturn state.key === scope ? state.data : EMPTY\n}\n"],"mappings":";;;;;;;;AAkBA,MAAM,QAAwB;CAAE,YAAY;CAAM,OAAO;CAAO,OAAO;AAAK;AAC5E,MAAM,SAAyB;CAAE,YAAY;CAAM,OAAO;CAAM,OAAO;AAAK;;;;;;;AAQ5E,MAAa,0BAA0C;CACtD,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,MAAM,QAAQ,QAAQ,gBAAgB,MAAM,EAAE,KAAK;CACzD,MAAM,QAAQ,gBAAgB;CAC9B,MAAM,CAAC,OAAO,YAAY,SAAgD;EACzE,MAAM;EACN,KAAK;CACN,CAAC;CAED,gBAAgB;EACf,IAAI,CAAC,OAAO;GACX,SAAS;IAAE,MAAM;IAAO,KAAK;GAAG,CAAC;GACjC;EACD;EACA,IAAI,YAAY;EAChB,WAAW,KAAK,KAAK,EACnB,MAAM,EAAE,YAAY,YAAY;GAChC,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;KAAE;KAAY,OAAO;KAAO;IAAM;IAAG,KAAK;GAAM,CAAC;EACnF,CAAC,EACA,YAAY;GACZ,IAAI,CAAC,WAAW,SAAS;IAAE,MAAM;IAAQ,KAAK;GAAM,CAAC;EACtD,CAAC;EACF,aAAa;GACZ,YAAY;EACb;CACD,GAAG,CAAC,KAAK,KAAK,CAAC;CAEf,OAAO,MAAM,QAAQ,QAAQ,MAAM,OAAO;AAC3C"}
package/dist/index.d.ts CHANGED
@@ -1,18 +1,76 @@
1
- import { Goal, GoalMatch, TrackerGoal } from "./goals/types.js";
2
- import { AnalyticsTrackError, ServerEventInput, ServerTrack, ServerTrackOptions } from "./core/serverEvent.js";
3
- import { PLATFORM_SCOPE } from "./core/contract.js";
4
- import { GoalsResponse, WireGoal } from "./goals/fetchGoals.js";
1
+ import { CurrencyConverter } from "./goals/currency.js";
2
+ import { CaptureClientKind, CaptureSlot, CaptureSnippet, ConsentPhase, GoalMatch, HeldSlotMode, RevenueItem, SlotMode, SlotWithoutConsent, SnippetScript, TrackerGoal, TrackerSlotConfig, WithoutConsentLevel } from "./tracker/config.js";
3
+ import { Goal } from "./goals/types.js";
4
+ import { BrowserAmounts, OrderSignatureMode } from "./goals/match.js";
5
+ import { TrustedPlatform } from "./net/platform.js";
6
+ import { DEFAULT_ROUTE_BASE, RouteBase, RoutePaths, RoutesConfigSource, analyticsRoutes, routePaths } from "./plugin/routes.js";
7
+ import { FetchInit, FetchLike } from "./core/fetch.js";
8
+ import { CaptureSupport, CookielessSupport, ProxyDescriptor, ProxyRoute, ProxyRouteKind, SnippetArgs, SnippetMode } from "./core/capture.js";
9
+ import { AnalyticsCollectionOptions, CollectionOverrides } from "./core/collectionOption.js";
10
+ import { AdapterJobs, AnalyticsJobsOptions, AnalyticsTaskName, AnalyticsTaskOptions, ScheduledTask, TASK_NAMES } from "./core/jobs.js";
11
+ import { AnalyticsSdks, Ga4Client, Ga4ClientOptions, Ga4ReportResponse, Ga4ReportRow, Ga4Sdk, MaxmindReader, MaxmindSdk } from "./core/sdks.js";
12
+ import { HitMode, HitType } from "./native/store/types.js";
13
+ import { CURRENCY_ATTRIBUTE, EVENT_ATTRIBUTE, EVENT_PROP_PREFIX, GOAL_ACTION_TYPE, GOAL_ATTRIBUTE, ITEM_ATTRIBUTE, ITEM_CLICK_EVENT, ITEM_NAME_ATTRIBUTE, MAX_ITEMS_PER_BEACON, PURCHASE_GOAL_SLUG, VALUE_ATTRIBUTE } from "./goals/constants.js";
14
+ import { AnalyticsAttributes } from "./exports/attributes.js";
15
+ import { ItemSignatureMode, itemAttributesFor, signItemRef } from "./native/ingest/itemSignature.js";
16
+ import { RawEventInput } from "./native/ingest/normalizeEvent.js";
17
+ import { AnalyticsTrackError, IngestHostnameResolver, ServerEventInput, ServerTrack, ServerTrackIdentity, ServerTrackOptions } from "./core/serverEvent.js";
18
+ import { AdapterContext, AdapterLabelArgs, AdapterRegisterContext, AdapterSchemaContext, AnalyticsAdapter, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, FilterOperatorMap, Granularity, MetricKey, MetricReach, MetricSemantics, MetricValue, MetricValues, PLATFORM_SCOPE, RateLimitDescriptor, SourceErrorKind, VisitorCounting } from "./core/contract.js";
19
+ import { AnalyticsSourceOptions, DefaultSourceFunction, DefaultSourceRule, OwnSource, SourcePolicy, SourcePolicyFunction, SourceRef } from "./core/sourcePolicy.js";
20
+ import { AdapterLabelOption } from "./core/sourceLabel.js";
21
+ import { STATE_SLUG } from "./native/collections/slugs.js";
22
+ import { RebuildDaysInput, RebuildDaysReport } from "./native/engine/rebuild.js";
23
+ import { CapabilityRequirement, FilterPair, SerializedCapabilities } from "./core/capabilities.js";
24
+ import { GatedScope, ReadPrincipal, SYSTEM } from "./access/principal.js";
25
+ import { ANALYTICS_ERROR_CODES, AnalyticsError, AnalyticsErrorCode, analyticsError, readErrorCode } from "./plugin/errors.js";
5
26
  import { QueryError, QueryErrorCode } from "./query/errors.js";
6
- import { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery } from "./query/response.js";
7
- import { AnalyticsBinding, BindingContext, HostnameResolver, PathResolver } from "./binding/types.js";
8
- import { TimeframePreset } from "./timeframe/presets.js";
27
+ import { ItemLabels, QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery } from "./query/response.js";
28
+ import { AnalyticsBinding, BindingContext, BindingDoc, HostnameResolver, PathResolver } from "./binding/types.js";
29
+ import { CollectionFieldOverride } from "./plugin/collectionFields.js";
30
+ import { PluralCategory, PluralName, PluralVariant, SingularKey, TranslationKey, keys, pluralKeys } from "./translations/keys.js";
31
+ import { TranslationsOption } from "./translations/index.js";
32
+ import { GOALS_SLUG, GoalCollectionFieldOverrides, GoalFieldOverride } from "./goals/collection.js";
33
+ import { HostPattern, ProviderHostPolicy, resolveHostPolicy } from "./providers/hosts.js";
34
+ import { PROVIDER_IDS, ProviderDoc, ProviderFactoryContext, ProviderId, adapterFromProviderDoc } from "./providers/factory.js";
35
+ import { BuildSecretField, ConnectionAccess, ConnectionFieldAccess, PROVIDERS_SLUG, ProviderCollectionFieldOverrides, ProviderFieldOverride, ProviderFieldsOptions, analyticsProviderFields } from "./providers/collection.js";
36
+ import { AfterReadAnswer, AfterReadArgs, AfterReadHook, ReadOrigin } from "./surfacing/afterRead.js";
37
+ import { TIMEFRAME_PRESETS, TimeframePreset } from "./timeframe/presets.js";
38
+ import { CacheEntry, CacheSetOptions, CacheStore, ReadRecipe, RecipeWindow } from "./surfacing/cacheStore.js";
9
39
  import { CustomWidgetDef } from "./widgets/customWidget.js";
10
- import { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, ScopesResolver, TimezoneResolver } from "./core/options.js";
11
- import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
40
+ import { BUILT_IN_WIDGET_SLUGS, BuiltInWidgetSlug } from "./core/widgetSlugs.js";
41
+ import { AnalyticsAccessOptions, AnalyticsCacheCollectionOptions, AnalyticsCacheOptions, AnalyticsCaptureOptions, AnalyticsComponent, AnalyticsConcurrencyOptions, AnalyticsCountryFlags, AnalyticsCrossScopeOptions, AnalyticsExclusionOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsHooksOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsRevenueOptions, AnalyticsRoutesOptions, AnalyticsScopeOptions, AnalyticsSyncCollectionOptions, AnalyticsSyncOptions, AnalyticsViewAccess, AnalyticsViewOptions, AnalyticsWarmOptions, AnalyticsWidgetOverride, AnalyticsWidgetOverrides, AnalyticsWidgetsOptions, AutoCaptureOptions, CaptureGate, CaptureGateArgs, CaptureSlotOption, CrossScopeAccess, CurrencyResolver, ExclusionSitesResolver, ItemCaptureOptions, ProviderHostsOptions, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ProvidersResolveArgs, ScopeCallSite, ScopeLabelResolver, ScopeListResolver, ScopeMemberAccess, ScopeResolver, TimezoneResolver, WithoutConsentArgs, WithoutConsentFunction, WithoutConsentOption } from "./core/options.js";
42
+ import { GoalSource } from "./goals/resolver.js";
43
+ import { GoalsResponse, WireGoal } from "./goals/fetchGoals.js";
44
+ import { ReadNotices } from "./widgets/readMeta.js";
45
+ import { StoredSourceRead, SubstitutedSource, WidgetReadStatus } from "./widgets/prepareWidgetRead.js";
46
+ import { ReadForWidgetRealtimeArgs, RealtimePoint, WidgetRealtimeResult, WidgetRealtimeStatus, readForWidgetRealtime } from "./widgets/readForWidgetRealtime.js";
47
+ import { ReportMode, ReportOption } from "./binding/report.js";
48
+ import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatBaseOptions, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField } from "./fields/factories.js";
49
+ import { SeriesGranularity, SeriesPoint } from "./charts/series.js";
50
+ import { FieldBreakdown, FieldBreakdownRow, FieldReadResult, FieldReadStatus, ReadForFieldArgs, readForField } from "./fields/readForDocument.js";
51
+ import { WidgetFilter } from "./widgets/types.js";
52
+ import { ReadForWidgetArgs, WidgetReadResult, readForWidget } from "./widgets/readForWidget.js";
53
+ import { BreakdownRow, ReadForWidgetBreakdownArgs, WidgetBreakdownResult, readForWidgetBreakdown } from "./widgets/readForWidgetBreakdown.js";
54
+ import { GoalRow, ReadForWidgetGoalsArgs, WidgetGoalsResult, readForWidgetGoals } from "./widgets/readForWidgetGoals.js";
55
+ import { ReadForWidgetSeriesArgs, WidgetSeriesResult, readForWidgetSeries } from "./widgets/readForWidgetSeries.js";
12
56
  import { GoalFieldOptions, goalField, goalSlug } from "./goals/goalField.js";
13
- import { GOAL_ACTION_TYPE, GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction } from "./goals/trackGoalAction.js";
57
+ import { GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction } from "./goals/trackGoalAction.js";
58
+ import { isAdminUser } from "./access/adminUser.js";
59
+ import { TenantMembershipOptions, tenantMembership } from "./access/membership.js";
60
+ import { ProviderHttpError, parseRetryAfter } from "./adapters/http/fetchJson.js";
61
+ import { AnalyticsLinkFieldsOptions, analyticsLinkFields } from "./goals/linkFields.js";
62
+ import { PurchaseInput, RefundInput, purchase, refund } from "./goals/serverRevenue.js";
63
+ import { signOrderId } from "./native/ingest/orderSignature.js";
14
64
  import { trackServerEvent } from "./native/ingest/serverTrack.js";
65
+ import { rebuildDays } from "./native/rebuildDays.js";
66
+ import { GuardedFetch, GuardedFetchOptions, createGuardedFetch } from "./net/guardedFetch.js";
67
+ import { RefreshProvidersOptions, refreshProviders } from "./providers/refresh.js";
68
+ import { CONNECTION_PATHS, SECRET_PATHS } from "./providers/secrets.js";
69
+ import { CACHE_SLUG } from "./surfacing/cacheCollection.js";
70
+ import { SYNC_SLUG } from "./sync/collection.js";
71
+ import { AnalyticsDefaultLayoutOptions, analyticsDefaultLayout } from "./widgets/defaultLayout.js";
15
72
  import { analyticsDefaultWidgets } from "./widgets/defaults.js";
73
+ import { widgetFilters } from "./widgets/filterField.js";
16
74
 
17
75
  //#region src/index.d.ts
18
76
  declare module 'payload' {
@@ -22,5 +80,5 @@ declare module 'payload' {
22
80
  }
23
81
  declare const analytics: (options: AnalyticsPluginOptions) => import("payload").Plugin;
24
82
  //#endregion
25
- export { type AnalyticsAccessOptions, type AnalyticsBinding, type AnalyticsCaptureOptions, type AnalyticsFieldsOptions, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsReadAccess, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AutoCaptureOptions, type BindingContext, type CaptureConsentOption, type ConsentMode, type ConsentResolver, type CustomWidgetDef, GOAL_ACTION_TYPE, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalFieldOptions, type GoalMatch, type GoalsResponse, type HostnameResolver, PLATFORM_SCOPE, type PathResolver, type PlatformReadAccess, type AnalyticsPluginOptions as PluginOptions, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type ScopeResolver, type ScopesResolver, type SerializedAnalyticsQuery, type ServerEventInput, type ServerTrack, type ServerTrackOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type WireGoal, analytics, analyticsDefaultWidgets, analyticsFields, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, goalField, goalSlug, trackGoalAction, trackServerEvent };
83
+ export { ANALYTICS_ERROR_CODES, type AdapterContext, type AdapterJobs, type AdapterLabelArgs, type AdapterLabelOption, type AdapterRegisterContext, type AdapterSchemaContext, type AfterReadAnswer, type AfterReadArgs, type AfterReadHook, type AnalyticsAccessOptions, type AnalyticsAdapter, type AnalyticsAttributes, type AnalyticsBinding, type AnalyticsCacheCollectionOptions, type AnalyticsCacheOptions, type AnalyticsCapabilities, type AnalyticsCaptureOptions, type AnalyticsCollectionOptions, type AnalyticsComponent, type AnalyticsConcurrencyOptions, type AnalyticsCountryFlags, type AnalyticsCrossScopeOptions, type AnalyticsDefaultLayoutOptions, type AnalyticsError, type AnalyticsErrorCode, type AnalyticsExclusionOptions, type AnalyticsFieldsOptions, type AnalyticsFilter, type AnalyticsGoalsCollectionOptions, type AnalyticsGoalsOptions, type AnalyticsHooksOptions, type AnalyticsJobsOptions, type AnalyticsLinkFieldsOptions, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, type AnalyticsQuery, type AnalyticsReadAccess, type AnalyticsResult, type AnalyticsRevenueOptions, type AnalyticsRoutesOptions, type AnalyticsRow, type AnalyticsScopeOptions, type AnalyticsSdks, type AnalyticsSourceOptions, type AnalyticsStatBaseOptions, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsSyncCollectionOptions, type AnalyticsSyncOptions, type AnalyticsTabOptions, type AnalyticsTaskName, type AnalyticsTaskOptions, AnalyticsTrackError, type AnalyticsViewAccess, type AnalyticsViewOptions, type AnalyticsWarmOptions, type AnalyticsWidgetOverride, type AnalyticsWidgetOverrides, type AnalyticsWidgetsOptions, type AutoCaptureOptions, BUILT_IN_WIDGET_SLUGS, type BindingContext, type BindingDoc, type BreakdownRow, type BrowserAmounts, type BuildSecretField, type BuiltInWidgetSlug, CACHE_SLUG, CONNECTION_PATHS, CURRENCY_ATTRIBUTE, type CacheEntry, type CacheSetOptions, type CacheStore, type CapabilityRequirement, type CaptureClientKind, type CaptureGate, type CaptureGateArgs, type CaptureSlot, type CaptureSlotOption, type CaptureSnippet, type CaptureSupport, type CollectionFieldOverride, type CollectionOverrides, type ConnectionAccess, type ConnectionFieldAccess, type ConsentPhase, type CookielessSupport, type CrossScopeAccess, type CurrencyConverter, type CurrencyResolver, type CustomWidgetDef, DEFAULT_ROUTE_BASE, type DIMENSION_KEYS, type DateRange, type DefaultSourceFunction, type DefaultSourceRule, type DimensionKey, EVENT_ATTRIBUTE, EVENT_PROP_PREFIX, type ExclusionSitesResolver, type FILTER_OPERATORS, type FetchInit, type FetchLike, type FieldBreakdown, type FieldBreakdownRow, type FieldReadResult, type FieldReadStatus, type FilterOperator, type FilterOperatorMap, type FilterPair, GOALS_SLUG, GOAL_ACTION_TYPE, GOAL_ATTRIBUTE, type Ga4Client, type Ga4ClientOptions, type Ga4ReportResponse, type Ga4ReportRow, type Ga4Sdk, type GatedScope, type Goal, type GoalActionDefinition, type GoalActionRunArgs, type GoalCollectionFieldOverrides, type GoalFieldOptions, type GoalFieldOverride, type GoalMatch, type GoalRow, type GoalSource, type GoalsResponse, type Granularity, type GuardedFetch, type GuardedFetchOptions, type HeldSlotMode, type HitMode, type HitType, type HostPattern, type HostnameResolver, ITEM_ATTRIBUTE, ITEM_CLICK_EVENT, ITEM_NAME_ATTRIBUTE, type IngestHostnameResolver, type ItemCaptureOptions, type ItemLabels, type ItemSignatureMode, MAX_ITEMS_PER_BEACON, type MaxmindReader, type MaxmindSdk, type MetricKey, type MetricReach, type MetricSemantics, type MetricValue, type MetricValues, type OrderSignatureMode, type OwnSource, PLATFORM_SCOPE, PROVIDERS_SLUG, PROVIDER_IDS, PURCHASE_GOAL_SLUG, type PathResolver, type AnalyticsPluginOptions as PluginOptions, type PluralCategory, type PluralName, type PluralVariant, type ProviderCollectionFieldOverrides, type ProviderDoc, type ProviderFactoryContext, type ProviderFieldOverride, type ProviderFieldsOptions, type ProviderHostPolicy, type ProviderHostsOptions, ProviderHttpError, type ProviderId, type ProvidersCollectionOptions, type ProvidersOptions, type ProvidersResolve, type ProvidersResolveArgs, type ProxyDescriptor, type ProxyRoute, type ProxyRouteKind, type QueryError, type QueryErrorCode, type QueryErrorResponse, type QueryResponse, type QuerySourceRef, type RateLimitDescriptor, type RawEventInput, type ReadForFieldArgs, type ReadForWidgetArgs, type ReadForWidgetBreakdownArgs, type ReadForWidgetGoalsArgs, type ReadForWidgetRealtimeArgs, type ReadForWidgetSeriesArgs, type ReadNotices, type ReadOrigin, type ReadPrincipal, type ReadRecipe, type RealtimePoint, type RebuildDaysInput, type RebuildDaysReport, type RecipeWindow, type RefreshProvidersOptions, type ReportMode, type ReportOption, type RevenueItem, type RouteBase, type RoutePaths, type RoutesConfigSource, SECRET_PATHS, STATE_SLUG, SYNC_SLUG, SYSTEM, type ScheduledTask, type ScopeCallSite, type ScopeLabelResolver, type ScopeListResolver, type ScopeMemberAccess, type ScopeResolver, type SerializedAnalyticsQuery, type SerializedCapabilities, type SeriesGranularity, type SeriesPoint, type ServerEventInput, type PurchaseInput as ServerPurchaseInput, type RefundInput as ServerRefundInput, type ServerTrack, type ServerTrackIdentity, type ServerTrackOptions, type SingularKey, type SlotMode, type SlotWithoutConsent, type SnippetArgs, type SnippetMode, type SnippetScript, type SourceErrorKind, type SourcePolicy, type SourcePolicyFunction, type SourceRef, type StoredSourceRead, type SubstitutedSource, type TASK_NAMES, TIMEFRAME_PRESETS, type TenantMembershipOptions, type TimeframePreset, type TimezoneResolver, type TrackGoalActionOptions, type TrackerGoal, type TrackerSlotConfig, type TranslationKey, type TranslationsOption, type TrustedPlatform, VALUE_ATTRIBUTE, type VisitorCounting, type WidgetBreakdownResult, type WidgetFilter, type WidgetGoalsResult, type WidgetReadResult, type WidgetReadStatus, type WidgetRealtimeResult, type WidgetRealtimeStatus, type WidgetSeriesResult, type WireGoal, type WithoutConsentArgs, type WithoutConsentFunction, type WithoutConsentLevel, type WithoutConsentOption, adapterFromProviderDoc, analytics, analyticsDefaultLayout, analyticsDefaultWidgets, analyticsError, analyticsFields, analyticsLinkFields, analyticsProviderFields, analyticsRoutes, analyticsStat, analyticsStatRow, analyticsTab, analyticsTabsField, createGuardedFetch, goalField, goalSlug, isAdminUser, itemAttributesFor, keys, parseRetryAfter, pluralKeys, purchase, readErrorCode, readForField, readForWidget, readForWidgetBreakdown, readForWidgetGoals, readForWidgetRealtime, readForWidgetSeries, rebuildDays, refreshProviders, refund, resolveHostPolicy, routePaths, signItemRef, signOrderId, tenantMembership, trackGoalAction, trackServerEvent, widgetFilters };
26
84
  //# sourceMappingURL=index.d.ts.map