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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1259) hide show
  1. package/CHANGELOG.md +530 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +17 -0
  22. package/dist/adapters/ga4/ga4.js +208 -124
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +19 -13
  36. package/dist/adapters/plausible/plausible.js +139 -123
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +26 -9
  41. package/dist/adapters/posthog/posthog.js +194 -115
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +13 -9
  48. package/dist/adapters/umami/umami.js +186 -173
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +108 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +198 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +28 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +297 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +505 -157
  159. package/dist/core/options.js +158 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +114 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +330 -71
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceLabel.d.ts +10 -0
  180. package/dist/core/sourceLabel.js +63 -0
  181. package/dist/core/sourceLabel.js.map +1 -0
  182. package/dist/core/sourceOptions.js +106 -0
  183. package/dist/core/sourceOptions.js.map +1 -0
  184. package/dist/core/sourcePolicy.d.ts +55 -0
  185. package/dist/core/sourcePolicy.js +51 -0
  186. package/dist/core/sourcePolicy.js.map +1 -0
  187. package/dist/core/throttle.js +18 -0
  188. package/dist/core/throttle.js.map +1 -0
  189. package/dist/core/values.js +61 -0
  190. package/dist/core/values.js.map +1 -0
  191. package/dist/core/widgetSlugs.d.ts +17 -0
  192. package/dist/core/widgetSlugs.js +29 -0
  193. package/dist/core/widgetSlugs.js.map +1 -0
  194. package/dist/db/detachedWrite.js +36 -0
  195. package/dist/db/detachedWrite.js.map +1 -0
  196. package/dist/db/errors.js +182 -0
  197. package/dist/db/errors.js.map +1 -0
  198. package/dist/db/kind.js +32 -0
  199. package/dist/db/kind.js.map +1 -0
  200. package/dist/db/openTransaction.js +51 -0
  201. package/dist/db/openTransaction.js.map +1 -0
  202. package/dist/exports/adapters/contract.d.ts +15 -0
  203. package/dist/exports/adapters/ga4.d.ts +16 -1
  204. package/dist/exports/adapters/native.d.ts +27 -2
  205. package/dist/exports/adapters/native.js +4 -1
  206. package/dist/exports/adapters/plausible.d.ts +16 -1
  207. package/dist/exports/adapters/posthog.d.ts +16 -1
  208. package/dist/exports/adapters/umami.d.ts +16 -1
  209. package/dist/exports/attributes.d.ts +42 -0
  210. package/dist/exports/attributes.js +83 -0
  211. package/dist/exports/attributes.js.map +1 -0
  212. package/dist/exports/client.d.ts +43 -13
  213. package/dist/exports/client.js +22 -9
  214. package/dist/exports/geo.d.ts +3 -1
  215. package/dist/exports/geo.js +1 -1
  216. package/dist/exports/i18n.d.ts +2 -2
  217. package/dist/exports/i18n.js +2 -2
  218. package/dist/exports/migrations.d.ts +2 -0
  219. package/dist/exports/migrations.js +2 -0
  220. package/dist/exports/next.d.ts +19 -1
  221. package/dist/exports/next.js +3 -1
  222. package/dist/exports/react.d.ts +3 -2
  223. package/dist/exports/react.js +1 -2
  224. package/dist/exports/rsc.d.ts +32 -14
  225. package/dist/exports/rsc.js +11 -6
  226. package/dist/exports/site.d.ts +5 -0
  227. package/dist/exports/site.js +3 -0
  228. package/dist/exports/testing.d.ts +18 -0
  229. package/dist/exports/testing.js +3 -0
  230. package/dist/exports/tracker.d.ts +5 -20
  231. package/dist/exports/tracker.js +3 -14
  232. package/dist/exports/types.d.ts +44 -14
  233. package/dist/exports/types.js +5 -1
  234. package/dist/fields/AnalyticsPanelClient.js +265 -154
  235. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  236. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  237. package/dist/fields/AnalyticsPanelField.js +123 -30
  238. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  239. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  240. package/dist/fields/AnalyticsStatField.js +98 -63
  241. package/dist/fields/AnalyticsStatField.js.map +1 -1
  242. package/dist/fields/FieldShimmer.js +15 -0
  243. package/dist/fields/FieldShimmer.js.map +1 -0
  244. package/dist/fields/PanelContent.js +222 -0
  245. package/dist/fields/PanelContent.js.map +1 -0
  246. package/dist/fields/PanelList.js +82 -0
  247. package/dist/fields/PanelList.js.map +1 -0
  248. package/dist/fields/PanelLiveCounter.js +63 -0
  249. package/dist/fields/PanelLiveCounter.js.map +1 -0
  250. package/dist/fields/PanelSkeleton.js +63 -0
  251. package/dist/fields/PanelSkeleton.js.map +1 -0
  252. package/dist/fields/componentPaths.js +8 -0
  253. package/dist/fields/componentPaths.js.map +1 -0
  254. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  255. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  256. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  257. package/dist/fields/config/FilterKeySelect.js +66 -0
  258. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  259. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  260. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  261. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  262. package/dist/fields/config/FilterValueField.d.ts +17 -0
  263. package/dist/fields/config/FilterValueField.js +130 -0
  264. package/dist/fields/config/FilterValueField.js.map +1 -0
  265. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  266. package/dist/fields/config/MetricSelectField.js +18 -30
  267. package/dist/fields/config/MetricSelectField.js.map +1 -1
  268. package/dist/fields/config/OptionSelect.js +52 -0
  269. package/dist/fields/config/OptionSelect.js.map +1 -0
  270. package/dist/fields/config/SourceSelectField.js +16 -31
  271. package/dist/fields/config/SourceSelectField.js.map +1 -1
  272. package/dist/fields/config/fetchSources.d.ts +3 -0
  273. package/dist/fields/config/fetchSources.js +17 -27
  274. package/dist/fields/config/fetchSources.js.map +1 -1
  275. package/dist/fields/config/filterValues.js +106 -0
  276. package/dist/fields/config/filterValues.js.map +1 -0
  277. package/dist/fields/config/narrow.js +8 -10
  278. package/dist/fields/config/narrow.js.map +1 -1
  279. package/dist/fields/config/retiredPickers.d.ts +45 -0
  280. package/dist/fields/config/retiredPickers.js +46 -0
  281. package/dist/fields/config/retiredPickers.js.map +1 -0
  282. package/dist/fields/config/scopedFields.d.ts +40 -0
  283. package/dist/fields/config/scopedFields.js +68 -0
  284. package/dist/fields/config/scopedFields.js.map +1 -0
  285. package/dist/fields/config/toSelectOption.js +13 -7
  286. package/dist/fields/config/toSelectOption.js.map +1 -1
  287. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  288. package/dist/fields/config/useAnalyticsSources.js +17 -21
  289. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  290. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  291. package/dist/fields/config/useFilterCapabilities.js +23 -15
  292. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  293. package/dist/fields/config/useFormString.js +12 -0
  294. package/dist/fields/config/useFormString.js.map +1 -0
  295. package/dist/fields/dateRange/field.js +7 -19
  296. package/dist/fields/dateRange/field.js.map +1 -1
  297. package/dist/fields/dateRange/types.d.ts +5 -1
  298. package/dist/fields/dateRange/ui.d.ts +3 -2
  299. package/dist/fields/dateRange/ui.js +57 -319
  300. package/dist/fields/dateRange/ui.js.map +1 -1
  301. package/dist/fields/documentScope.js +21 -0
  302. package/dist/fields/documentScope.js.map +1 -0
  303. package/dist/fields/emptyState.js +31 -26
  304. package/dist/fields/emptyState.js.map +1 -1
  305. package/dist/fields/factories.d.ts +35 -16
  306. package/dist/fields/factories.js +66 -37
  307. package/dist/fields/factories.js.map +1 -1
  308. package/dist/fields/format.d.ts +12 -3
  309. package/dist/fields/format.js +77 -13
  310. package/dist/fields/format.js.map +1 -1
  311. package/dist/fields/itemReport.js +45 -0
  312. package/dist/fields/itemReport.js.map +1 -0
  313. package/dist/fields/readForDocument.d.ts +79 -26
  314. package/dist/fields/readForDocument.js +450 -116
  315. package/dist/fields/readForDocument.js.map +1 -1
  316. package/dist/fields/stateKeys.js +20 -0
  317. package/dist/fields/stateKeys.js.map +1 -0
  318. package/dist/goals/GoalAmountField.d.ts +10 -0
  319. package/dist/goals/GoalAmountField.js +162 -0
  320. package/dist/goals/GoalAmountField.js.map +1 -0
  321. package/dist/goals/GoalSelectField.js +89 -40
  322. package/dist/goals/GoalSelectField.js.map +1 -1
  323. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  324. package/dist/goals/GoalSelectFieldServer.js +21 -0
  325. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  326. package/dist/goals/amountField.d.ts +20 -0
  327. package/dist/goals/amountField.js +37 -0
  328. package/dist/goals/amountField.js.map +1 -0
  329. package/dist/goals/builtin.js +17 -0
  330. package/dist/goals/builtin.js.map +1 -0
  331. package/dist/goals/collection.d.ts +22 -0
  332. package/dist/goals/collection.js +139 -125
  333. package/dist/goals/collection.js.map +1 -1
  334. package/dist/goals/constants.d.ts +38 -0
  335. package/dist/goals/constants.js +49 -0
  336. package/dist/goals/constants.js.map +1 -0
  337. package/dist/goals/currency.d.ts +16 -0
  338. package/dist/goals/currency.js +46 -4
  339. package/dist/goals/currency.js.map +1 -1
  340. package/dist/goals/currencyOptions.js +70 -0
  341. package/dist/goals/currencyOptions.js.map +1 -0
  342. package/dist/goals/fetchGoals.d.ts +10 -0
  343. package/dist/goals/fetchGoals.js +12 -26
  344. package/dist/goals/fetchGoals.js.map +1 -1
  345. package/dist/goals/goalField.d.ts +4 -6
  346. package/dist/goals/goalField.js +9 -19
  347. package/dist/goals/goalField.js.map +1 -1
  348. package/dist/goals/goalsEndpoint.js +39 -40
  349. package/dist/goals/goalsEndpoint.js.map +1 -1
  350. package/dist/goals/items.js +35 -0
  351. package/dist/goals/items.js.map +1 -0
  352. package/dist/goals/latent.js +9 -0
  353. package/dist/goals/latent.js.map +1 -0
  354. package/dist/goals/linkFields.d.ts +35 -0
  355. package/dist/goals/linkFields.js +31 -0
  356. package/dist/goals/linkFields.js.map +1 -0
  357. package/dist/goals/match.d.ts +14 -0
  358. package/dist/goals/match.js +67 -46
  359. package/dist/goals/match.js.map +1 -1
  360. package/dist/goals/moneyFields.js +56 -0
  361. package/dist/goals/moneyFields.js.map +1 -0
  362. package/dist/goals/pathMatch.js +122 -0
  363. package/dist/goals/pathMatch.js.map +1 -0
  364. package/dist/goals/placeholder.js +12 -0
  365. package/dist/goals/placeholder.js.map +1 -0
  366. package/dist/goals/resolver.d.ts +3 -3
  367. package/dist/goals/resolver.js +155 -47
  368. package/dist/goals/resolver.js.map +1 -1
  369. package/dist/goals/serverRevenue.d.ts +60 -0
  370. package/dist/goals/serverRevenue.js +41 -0
  371. package/dist/goals/serverRevenue.js.map +1 -0
  372. package/dist/goals/trackGoalAction.d.ts +26 -27
  373. package/dist/goals/trackGoalAction.js +38 -52
  374. package/dist/goals/trackGoalAction.js.map +1 -1
  375. package/dist/goals/types.d.ts +13 -28
  376. package/dist/goals/types.js +1 -1
  377. package/dist/goals/types.js.map +1 -1
  378. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  379. package/dist/goals/useAnalyticsGoals.js +17 -18
  380. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  381. package/dist/index.d.ts +67 -12
  382. package/dist/index.js +258 -247
  383. package/dist/index.js.map +1 -1
  384. package/dist/items/collectionIdType.js +20 -0
  385. package/dist/items/collectionIdType.js.map +1 -0
  386. package/dist/items/idType.js +31 -0
  387. package/dist/items/idType.js.map +1 -0
  388. package/dist/items/ref.js +73 -0
  389. package/dist/items/ref.js.map +1 -0
  390. package/dist/maintenance/apiTaskState.js +141 -0
  391. package/dist/maintenance/apiTaskState.js.map +1 -0
  392. package/dist/maintenance/heartbeat.js +51 -0
  393. package/dist/maintenance/heartbeat.js.map +1 -0
  394. package/dist/maintenance/lease.d.ts +1 -0
  395. package/dist/maintenance/lease.js +81 -0
  396. package/dist/maintenance/lease.js.map +1 -0
  397. package/dist/maintenance/taskSchedule.d.ts +1 -0
  398. package/dist/maintenance/taskSchedule.js +62 -0
  399. package/dist/maintenance/taskSchedule.js.map +1 -0
  400. package/dist/maintenance/underLease.js +35 -0
  401. package/dist/maintenance/underLease.js.map +1 -0
  402. package/dist/migrations/legacy.d.ts +54 -0
  403. package/dist/migrations/legacy.js +117 -0
  404. package/dist/migrations/legacy.js.map +1 -0
  405. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  406. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  407. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  408. package/dist/native/collections/aggregates.js +54 -0
  409. package/dist/native/collections/aggregates.js.map +1 -0
  410. package/dist/native/collections/hits.js +102 -0
  411. package/dist/native/collections/hits.js.map +1 -0
  412. package/dist/native/collections/slugs.d.ts +10 -0
  413. package/dist/native/collections/slugs.js +16 -0
  414. package/dist/native/collections/slugs.js.map +1 -0
  415. package/dist/native/collections/state.js +84 -0
  416. package/dist/native/collections/state.js.map +1 -0
  417. package/dist/native/collections/storeCollection.js +29 -0
  418. package/dist/native/collections/storeCollection.js.map +1 -0
  419. package/dist/native/engine/buckets.d.ts +1 -0
  420. package/dist/native/engine/buckets.js +53 -0
  421. package/dist/native/engine/buckets.js.map +1 -0
  422. package/dist/native/engine/capabilities.js +87 -0
  423. package/dist/native/engine/capabilities.js.map +1 -0
  424. package/dist/native/engine/cost.js +72 -0
  425. package/dist/native/engine/cost.js.map +1 -0
  426. package/dist/native/engine/days.d.ts +1 -0
  427. package/dist/native/engine/days.js +182 -0
  428. package/dist/native/engine/days.js.map +1 -0
  429. package/dist/native/engine/engine.d.ts +1 -0
  430. package/dist/native/engine/engine.js +1623 -0
  431. package/dist/native/engine/engine.js.map +1 -0
  432. package/dist/native/engine/instance.js +58 -0
  433. package/dist/native/engine/instance.js.map +1 -0
  434. package/dist/native/engine/maintenance.d.ts +1 -0
  435. package/dist/native/engine/maintenance.js +677 -0
  436. package/dist/native/engine/maintenance.js.map +1 -0
  437. package/dist/native/engine/merge.js +41 -0
  438. package/dist/native/engine/merge.js.map +1 -0
  439. package/dist/native/engine/nudge.js +26 -0
  440. package/dist/native/engine/nudge.js.map +1 -0
  441. package/dist/native/engine/planner.js +198 -0
  442. package/dist/native/engine/planner.js.map +1 -0
  443. package/dist/native/engine/rebuild.d.ts +22 -0
  444. package/dist/native/engine/rebuild.js +76 -0
  445. package/dist/native/engine/rebuild.js.map +1 -0
  446. package/dist/native/engine/recent.js +17 -0
  447. package/dist/native/engine/recent.js.map +1 -0
  448. package/dist/native/engine/salt.d.ts +1 -0
  449. package/dist/native/engine/salt.js +98 -0
  450. package/dist/native/engine/salt.js.map +1 -0
  451. package/dist/native/engine/siteHosts.d.ts +1 -0
  452. package/dist/native/engine/siteHosts.js +58 -0
  453. package/dist/native/engine/siteHosts.js.map +1 -0
  454. package/dist/native/engine/toHit.js +108 -0
  455. package/dist/native/engine/toHit.js.map +1 -0
  456. package/dist/native/engine/writeBuffer.d.ts +14 -0
  457. package/dist/native/engine/writeBuffer.js +317 -0
  458. package/dist/native/engine/writeBuffer.js.map +1 -0
  459. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  460. package/dist/native/geo/composeGeoResolvers.js +4 -1
  461. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  462. package/dist/native/geo/geoResolver.d.ts +20 -2
  463. package/dist/native/geo/geoResolver.js +42 -6
  464. package/dist/native/geo/geoResolver.js.map +1 -1
  465. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  466. package/dist/native/geo/maxmindResolver.js +20 -16
  467. package/dist/native/geo/maxmindResolver.js.map +1 -1
  468. package/dist/native/geo/resolveGeo.js +31 -0
  469. package/dist/native/geo/resolveGeo.js.map +1 -0
  470. package/dist/native/ingest/bots.d.ts +2 -3
  471. package/dist/native/ingest/bots.js +8 -13
  472. package/dist/native/ingest/bots.js.map +1 -1
  473. package/dist/native/ingest/browser.js +4 -6
  474. package/dist/native/ingest/browser.js.map +1 -1
  475. package/dist/native/ingest/clientIp.js +30 -9
  476. package/dist/native/ingest/clientIp.js.map +1 -1
  477. package/dist/native/ingest/device.js +4 -6
  478. package/dist/native/ingest/device.js.map +1 -1
  479. package/dist/native/ingest/endpoint.d.ts +1 -1
  480. package/dist/native/ingest/endpoint.js +119 -34
  481. package/dist/native/ingest/endpoint.js.map +1 -1
  482. package/dist/native/ingest/itemSignature.d.ts +26 -0
  483. package/dist/native/ingest/itemSignature.js +45 -0
  484. package/dist/native/ingest/itemSignature.js.map +1 -0
  485. package/dist/native/ingest/language.js +2 -3
  486. package/dist/native/ingest/language.js.map +1 -1
  487. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  488. package/dist/native/ingest/normalizeEvent.js +226 -61
  489. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  490. package/dist/native/ingest/orderSignature.d.ts +13 -0
  491. package/dist/native/ingest/orderSignature.js +50 -0
  492. package/dist/native/ingest/orderSignature.js.map +1 -0
  493. package/dist/native/ingest/referrer.js +30 -32
  494. package/dist/native/ingest/referrer.js.map +1 -1
  495. package/dist/native/ingest/requestHost.js +10 -23
  496. package/dist/native/ingest/requestHost.js.map +1 -1
  497. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  498. package/dist/native/ingest/resolveHostname.js +5 -6
  499. package/dist/native/ingest/resolveHostname.js.map +1 -1
  500. package/dist/native/ingest/revenue.d.ts +1 -0
  501. package/dist/native/ingest/revenue.js +121 -0
  502. package/dist/native/ingest/revenue.js.map +1 -0
  503. package/dist/native/ingest/route.d.ts +10 -0
  504. package/dist/native/ingest/route.js +82 -0
  505. package/dist/native/ingest/route.js.map +1 -0
  506. package/dist/native/ingest/serverTrack.d.ts +2 -10
  507. package/dist/native/ingest/serverTrack.js +181 -72
  508. package/dist/native/ingest/serverTrack.js.map +1 -1
  509. package/dist/native/ingest/signature.js +28 -0
  510. package/dist/native/ingest/signature.js.map +1 -0
  511. package/dist/native/ingest/source.d.ts +2 -3
  512. package/dist/native/ingest/source.js +35 -54
  513. package/dist/native/ingest/source.js.map +1 -1
  514. package/dist/native/ingest/utm.js +9 -9
  515. package/dist/native/ingest/utm.js.map +1 -1
  516. package/dist/native/ingest/validate.js +20 -10
  517. package/dist/native/ingest/validate.js.map +1 -1
  518. package/dist/native/ingest/visitorHash.js +6 -8
  519. package/dist/native/ingest/visitorHash.js.map +1 -1
  520. package/dist/native/nativeAdapter.d.ts +107 -33
  521. package/dist/native/nativeAdapter.js +376 -317
  522. package/dist/native/nativeAdapter.js.map +1 -1
  523. package/dist/native/rebuildDays.d.ts +12 -0
  524. package/dist/native/rebuildDays.js +16 -0
  525. package/dist/native/rebuildDays.js.map +1 -0
  526. package/dist/native/store/aggregate.js +450 -0
  527. package/dist/native/store/aggregate.js.map +1 -0
  528. package/dist/native/store/caps.d.ts +18 -0
  529. package/dist/native/store/caps.js +76 -0
  530. package/dist/native/store/caps.js.map +1 -0
  531. package/dist/native/store/chunks.js +34 -0
  532. package/dist/native/store/chunks.js.map +1 -0
  533. package/dist/native/store/columnValues.js +31 -0
  534. package/dist/native/store/columnValues.js.map +1 -0
  535. package/dist/native/store/dialect.js +106 -0
  536. package/dist/native/store/dialect.js.map +1 -0
  537. package/dist/native/store/eventStore.js +44 -0
  538. package/dist/native/store/eventStore.js.map +1 -0
  539. package/dist/native/store/hitRow.js +116 -0
  540. package/dist/native/store/hitRow.js.map +1 -0
  541. package/dist/native/store/hits.js +63 -0
  542. package/dist/native/store/hits.js.map +1 -0
  543. package/dist/native/store/ids.js +105 -0
  544. package/dist/native/store/ids.js.map +1 -0
  545. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  546. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  547. package/dist/native/store/mongo/mongoState.js +375 -0
  548. package/dist/native/store/mongo/mongoState.js.map +1 -0
  549. package/dist/native/store/mongo/mongoStore.js +618 -0
  550. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  551. package/dist/native/store/mongo/pipelines.js +695 -0
  552. package/dist/native/store/mongo/pipelines.js.map +1 -0
  553. package/dist/native/store/mongo/results.js +20 -0
  554. package/dist/native/store/mongo/results.js.map +1 -0
  555. package/dist/native/store/parts.d.ts +1 -0
  556. package/dist/native/store/parts.js +95 -0
  557. package/dist/native/store/parts.js.map +1 -0
  558. package/dist/native/store/pattern.js +213 -0
  559. package/dist/native/store/pattern.js.map +1 -0
  560. package/dist/native/store/rawRead.d.ts +23 -0
  561. package/dist/native/store/rawRead.js +384 -0
  562. package/dist/native/store/rawRead.js.map +1 -0
  563. package/dist/native/store/reclassify.js +53 -0
  564. package/dist/native/store/reclassify.js.map +1 -0
  565. package/dist/native/store/sql/aggregateSql.js +345 -0
  566. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  567. package/dist/native/store/sql/columns.js +48 -0
  568. package/dist/native/store/sql/columns.js.map +1 -0
  569. package/dist/native/store/sql/compile.js +656 -0
  570. package/dist/native/store/sql/compile.js.map +1 -0
  571. package/dist/native/store/sql/drivers.js +218 -0
  572. package/dist/native/store/sql/drivers.js.map +1 -0
  573. package/dist/native/store/sql/executor.js +132 -0
  574. package/dist/native/store/sql/executor.js.map +1 -0
  575. package/dist/native/store/sql/fragment.js +104 -0
  576. package/dist/native/store/sql/fragment.js.map +1 -0
  577. package/dist/native/store/sql/maintenanceSql.js +59 -0
  578. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  579. package/dist/native/store/sql/ownConnection.js +107 -0
  580. package/dist/native/store/sql/ownConnection.js.map +1 -0
  581. package/dist/native/store/sql/poolShare.js +101 -0
  582. package/dist/native/store/sql/poolShare.js.map +1 -0
  583. package/dist/native/store/sql/sqlState.js +325 -0
  584. package/dist/native/store/sql/sqlState.js.map +1 -0
  585. package/dist/native/store/sql/sqlStore.js +355 -0
  586. package/dist/native/store/sql/sqlStore.js.map +1 -0
  587. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  588. package/dist/native/store/sql/sqliteThread.js +314 -0
  589. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  590. package/dist/native/store/sql/sqliteWorker.js +327 -0
  591. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  592. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  593. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  594. package/dist/native/store/state.js +151 -0
  595. package/dist/native/store/state.js.map +1 -0
  596. package/dist/native/store/stateStore.js +29 -0
  597. package/dist/native/store/stateStore.js.map +1 -0
  598. package/dist/native/store/types.d.ts +9 -0
  599. package/dist/native/tasks/maintainTask.d.ts +19 -0
  600. package/dist/native/tasks/maintainTask.js +68 -0
  601. package/dist/native/tasks/maintainTask.js.map +1 -0
  602. package/dist/net/guardedFetch.d.ts +32 -0
  603. package/dist/net/guardedFetch.js +220 -0
  604. package/dist/net/guardedFetch.js.map +1 -0
  605. package/dist/net/origin.js +40 -0
  606. package/dist/net/origin.js.map +1 -0
  607. package/dist/net/platform.d.ts +9 -0
  608. package/dist/net/platform.js +35 -0
  609. package/dist/net/platform.js.map +1 -0
  610. package/dist/next/captureRewrites.d.ts +4 -24
  611. package/dist/next/captureRewrites.js +6 -50
  612. package/dist/next/captureRewrites.js.map +1 -1
  613. package/dist/next/captureRoute.d.ts +28 -0
  614. package/dist/next/captureRoute.js +67 -0
  615. package/dist/next/captureRoute.js.map +1 -0
  616. package/dist/next/ingestRoute.d.ts +17 -0
  617. package/dist/next/ingestRoute.js +17 -0
  618. package/dist/next/ingestRoute.js.map +1 -0
  619. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  620. package/dist/next/posthogProxyRewrites.js +5 -37
  621. package/dist/next/posthogProxyRewrites.js.map +1 -1
  622. package/dist/plugin/adminDependencies.js +34 -0
  623. package/dist/plugin/adminDependencies.js.map +1 -0
  624. package/dist/plugin/apiPath.js +23 -0
  625. package/dist/plugin/apiPath.js.map +1 -0
  626. package/dist/plugin/boundDocument.js +58 -0
  627. package/dist/plugin/boundDocument.js.map +1 -0
  628. package/dist/plugin/buildPhase.js +10 -0
  629. package/dist/plugin/buildPhase.js.map +1 -0
  630. package/dist/plugin/collectionChecks.js +232 -0
  631. package/dist/plugin/collectionChecks.js.map +1 -0
  632. package/dist/plugin/collectionFields.d.ts +13 -0
  633. package/dist/plugin/collectionFields.js +22 -0
  634. package/dist/plugin/collectionFields.js.map +1 -0
  635. package/dist/plugin/createRuntime.js +339 -0
  636. package/dist/plugin/createRuntime.js.map +1 -0
  637. package/dist/plugin/destroy.js +58 -0
  638. package/dist/plugin/destroy.js.map +1 -0
  639. package/dist/plugin/documentEndpoint.js +77 -53
  640. package/dist/plugin/documentEndpoint.js.map +1 -1
  641. package/dist/plugin/documentScopes.js +37 -0
  642. package/dist/plugin/documentScopes.js.map +1 -0
  643. package/dist/plugin/encrypted.js +25 -0
  644. package/dist/plugin/encrypted.js.map +1 -0
  645. package/dist/plugin/errors.d.ts +5 -12
  646. package/dist/plugin/errors.js +23 -16
  647. package/dist/plugin/errors.js.map +1 -1
  648. package/dist/plugin/flagsEndpoint.js +41 -0
  649. package/dist/plugin/flagsEndpoint.js.map +1 -0
  650. package/dist/plugin/goalHint.js +22 -11
  651. package/dist/plugin/goalHint.js.map +1 -1
  652. package/dist/plugin/itemLabels.js +114 -0
  653. package/dist/plugin/itemLabels.js.map +1 -0
  654. package/dist/plugin/jobsAccess.js +91 -0
  655. package/dist/plugin/jobsAccess.js.map +1 -0
  656. package/dist/plugin/keepAlive.js +48 -0
  657. package/dist/plugin/keepAlive.js.map +1 -0
  658. package/dist/plugin/peerImportError.js +3 -6
  659. package/dist/plugin/peerImportError.js.map +1 -1
  660. package/dist/plugin/peers.js +64 -0
  661. package/dist/plugin/peers.js.map +1 -0
  662. package/dist/plugin/pluginCollections.js +161 -0
  663. package/dist/plugin/pluginCollections.js.map +1 -0
  664. package/dist/plugin/queryEndpoint.js +70 -45
  665. package/dist/plugin/queryEndpoint.js.map +1 -1
  666. package/dist/plugin/queryParams.js +7 -0
  667. package/dist/plugin/queryParams.js.map +1 -0
  668. package/dist/plugin/readContextForRequest.d.ts +11 -0
  669. package/dist/plugin/readContextForRequest.js +70 -25
  670. package/dist/plugin/readContextForRequest.js.map +1 -1
  671. package/dist/plugin/readFailure.js +22 -0
  672. package/dist/plugin/readFailure.js.map +1 -0
  673. package/dist/plugin/readableProviders.js +64 -0
  674. package/dist/plugin/readableProviders.js.map +1 -0
  675. package/dist/plugin/realtimeEndpoint.js +77 -25
  676. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  677. package/dist/plugin/refreshEndpoint.js +69 -44
  678. package/dist/plugin/refreshEndpoint.js.map +1 -1
  679. package/dist/plugin/relabelFields.js +36 -0
  680. package/dist/plugin/relabelFields.js.map +1 -0
  681. package/dist/plugin/requestMemo.js +35 -0
  682. package/dist/plugin/requestMemo.js.map +1 -0
  683. package/dist/plugin/routeChecks.js +39 -0
  684. package/dist/plugin/routeChecks.js.map +1 -0
  685. package/dist/plugin/routes.d.ts +53 -0
  686. package/dist/plugin/routes.js +92 -0
  687. package/dist/plugin/routes.js.map +1 -0
  688. package/dist/plugin/runtime.d.ts +1 -1
  689. package/dist/plugin/runtime.js +234 -30
  690. package/dist/plugin/runtime.js.map +1 -1
  691. package/dist/plugin/schemaOnly.js +63 -0
  692. package/dist/plugin/schemaOnly.js.map +1 -0
  693. package/dist/plugin/scopeChange.js +6 -5
  694. package/dist/plugin/scopeChange.js.map +1 -1
  695. package/dist/plugin/scopeFieldBoot.js +4 -4
  696. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  697. package/dist/plugin/scopeToken.js +33 -0
  698. package/dist/plugin/scopeToken.js.map +1 -0
  699. package/dist/plugin/sourcesEndpoint.js +50 -17
  700. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  701. package/dist/plugin/unbundledLanguages.js +25 -0
  702. package/dist/plugin/unbundledLanguages.js.map +1 -0
  703. package/dist/plugin/walkFields.js +22 -0
  704. package/dist/plugin/walkFields.js.map +1 -0
  705. package/dist/plugin/warmTask.js +0 -0
  706. package/dist/plugin/warmTask.js.map +1 -1
  707. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  708. package/dist/providers/ProvidersListNotice.js +36 -0
  709. package/dist/providers/ProvidersListNotice.js.map +1 -0
  710. package/dist/providers/access.d.ts +1 -0
  711. package/dist/providers/access.js +35 -26
  712. package/dist/providers/access.js.map +1 -1
  713. package/dist/providers/adapterPool.js +121 -0
  714. package/dist/providers/adapterPool.js.map +1 -0
  715. package/dist/providers/collection.d.ts +61 -0
  716. package/dist/providers/collection.js +340 -151
  717. package/dist/providers/collection.js.map +1 -1
  718. package/dist/providers/factory.d.ts +76 -0
  719. package/dist/providers/factory.js +75 -25
  720. package/dist/providers/factory.js.map +1 -1
  721. package/dist/providers/hosts.d.ts +25 -0
  722. package/dist/providers/hosts.js +128 -0
  723. package/dist/providers/hosts.js.map +1 -0
  724. package/dist/providers/probe.d.ts +1 -0
  725. package/dist/providers/probe.js +105 -0
  726. package/dist/providers/probe.js.map +1 -0
  727. package/dist/providers/refresh.d.ts +18 -0
  728. package/dist/providers/refresh.js +49 -0
  729. package/dist/providers/refresh.js.map +1 -0
  730. package/dist/providers/registry.js +328 -0
  731. package/dist/providers/registry.js.map +1 -0
  732. package/dist/providers/resolver.js +26 -88
  733. package/dist/providers/resolver.js.map +1 -1
  734. package/dist/providers/retarget.js +45 -0
  735. package/dist/providers/retarget.js.map +1 -0
  736. package/dist/providers/scopeUnique.js +41 -0
  737. package/dist/providers/scopeUnique.js.map +1 -0
  738. package/dist/providers/secrets.d.ts +26 -0
  739. package/dist/providers/secrets.js +61 -4
  740. package/dist/providers/secrets.js.map +1 -1
  741. package/dist/providers/stampScope.js +9 -6
  742. package/dist/providers/stampScope.js.map +1 -1
  743. package/dist/query/dates.js +10 -12
  744. package/dist/query/dates.js.map +1 -1
  745. package/dist/query/errors.d.ts +1 -5
  746. package/dist/query/fetchQuery.d.ts +25 -32
  747. package/dist/query/fetchQuery.js +91 -91
  748. package/dist/query/fetchQuery.js.map +1 -1
  749. package/dist/query/limits.js +8 -0
  750. package/dist/query/limits.js.map +1 -0
  751. package/dist/query/parse.d.ts +6 -0
  752. package/dist/query/parse.js +153 -106
  753. package/dist/query/parse.js.map +1 -1
  754. package/dist/query/response.d.ts +23 -3
  755. package/dist/query/response.js +12 -5
  756. package/dist/query/response.js.map +1 -1
  757. package/dist/react/AnalyticsProvider.d.ts +26 -17
  758. package/dist/react/AnalyticsProvider.js +23 -22
  759. package/dist/react/AnalyticsProvider.js.map +1 -1
  760. package/dist/react/TrackerBoot.js +15 -9
  761. package/dist/react/TrackerBoot.js.map +1 -1
  762. package/dist/react/useAnalytics.d.ts +2 -11
  763. package/dist/react/useAnalytics.js +22 -24
  764. package/dist/react/useAnalytics.js.map +1 -1
  765. package/dist/site/AnalyticsScripts.d.ts +34 -0
  766. package/dist/site/AnalyticsScripts.js +30 -0
  767. package/dist/site/AnalyticsScripts.js.map +1 -0
  768. package/dist/site/getTrackerConfig.d.ts +15 -0
  769. package/dist/site/getTrackerConfig.js +40 -0
  770. package/dist/site/getTrackerConfig.js.map +1 -0
  771. package/dist/surfacing/afterRead.d.ts +37 -0
  772. package/dist/surfacing/bounded.js +38 -0
  773. package/dist/surfacing/bounded.js.map +1 -0
  774. package/dist/surfacing/breaker.js +107 -0
  775. package/dist/surfacing/breaker.js.map +1 -0
  776. package/dist/surfacing/cacheCollection.d.ts +8 -0
  777. package/dist/surfacing/cacheCollection.js +69 -0
  778. package/dist/surfacing/cacheCollection.js.map +1 -0
  779. package/dist/surfacing/cacheStore.d.ts +71 -1
  780. package/dist/surfacing/cacheStore.js +16 -37
  781. package/dist/surfacing/cacheStore.js.map +1 -1
  782. package/dist/surfacing/cacheSweep.d.ts +1 -0
  783. package/dist/surfacing/cacheSweep.js +59 -0
  784. package/dist/surfacing/cacheSweep.js.map +1 -0
  785. package/dist/surfacing/classifyError.js +282 -0
  786. package/dist/surfacing/classifyError.js.map +1 -0
  787. package/dist/surfacing/coalesce.js +2 -1
  788. package/dist/surfacing/coalesce.js.map +1 -1
  789. package/dist/surfacing/coldBudget.js +60 -0
  790. package/dist/surfacing/coldBudget.js.map +1 -0
  791. package/dist/surfacing/collectionCacheStore.js +183 -0
  792. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  793. package/dist/surfacing/engine.d.ts +1 -1
  794. package/dist/surfacing/engine.js +514 -72
  795. package/dist/surfacing/engine.js.map +1 -1
  796. package/dist/surfacing/epoch.js +70 -26
  797. package/dist/surfacing/epoch.js.map +1 -1
  798. package/dist/surfacing/lanes.d.ts +1 -0
  799. package/dist/surfacing/lanes.js +297 -0
  800. package/dist/surfacing/lanes.js.map +1 -0
  801. package/dist/surfacing/memo.js +40 -0
  802. package/dist/surfacing/memo.js.map +1 -0
  803. package/dist/surfacing/rateLimiter.d.ts +1 -0
  804. package/dist/surfacing/rateLimiter.js +69 -94
  805. package/dist/surfacing/rateLimiter.js.map +1 -1
  806. package/dist/surfacing/rebucket.js +178 -0
  807. package/dist/surfacing/rebucket.js.map +1 -0
  808. package/dist/surfacing/recipe.js +28 -0
  809. package/dist/surfacing/recipe.js.map +1 -0
  810. package/dist/surfacing/shape.js +22 -0
  811. package/dist/surfacing/shape.js.map +1 -0
  812. package/dist/surfacing/todaySplit.js +113 -0
  813. package/dist/surfacing/todaySplit.js.map +1 -0
  814. package/dist/sync/collection.d.ts +8 -0
  815. package/dist/sync/collection.js +28 -18
  816. package/dist/sync/collection.js.map +1 -1
  817. package/dist/sync/rekeyDurations.js +70 -0
  818. package/dist/sync/rekeyDurations.js.map +1 -0
  819. package/dist/sync/syncTask.js +226 -109
  820. package/dist/sync/syncTask.js.map +1 -1
  821. package/dist/testing/memoryAdapter.d.ts +6 -3
  822. package/dist/testing/memoryAdapter.js +12 -10
  823. package/dist/testing/memoryAdapter.js.map +1 -1
  824. package/dist/testing/settle.d.ts +11 -0
  825. package/dist/testing/settle.js +19 -0
  826. package/dist/testing/settle.js.map +1 -0
  827. package/dist/timeframe/calendar.js +65 -0
  828. package/dist/timeframe/calendar.js.map +1 -0
  829. package/dist/timeframe/comparison.js +46 -0
  830. package/dist/timeframe/comparison.js.map +1 -0
  831. package/dist/timeframe/presets.d.ts +1 -1
  832. package/dist/timeframe/presets.js +5 -5
  833. package/dist/timeframe/presets.js.map +1 -1
  834. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  835. package/dist/timeframe/reportingTimezone.js +64 -0
  836. package/dist/timeframe/reportingTimezone.js.map +1 -0
  837. package/dist/timeframe/tz.js +55 -39
  838. package/dist/timeframe/tz.js.map +1 -1
  839. package/dist/tracker/autoCapture.js +125 -38
  840. package/dist/tracker/autoCapture.js.map +1 -1
  841. package/dist/tracker/campaign.js +52 -0
  842. package/dist/tracker/campaign.js.map +1 -0
  843. package/dist/tracker/config.d.ts +149 -0
  844. package/dist/tracker/config.js +25 -0
  845. package/dist/tracker/config.js.map +1 -0
  846. package/dist/tracker/createTracker.d.ts +4 -10
  847. package/dist/tracker/createTracker.js +386 -115
  848. package/dist/tracker/createTracker.js.map +1 -1
  849. package/dist/tracker/digest.js +28 -0
  850. package/dist/tracker/digest.js.map +1 -0
  851. package/dist/tracker/engagement.js +100 -0
  852. package/dist/tracker/engagement.js.map +1 -0
  853. package/dist/tracker/events.js +37 -0
  854. package/dist/tracker/events.js.map +1 -0
  855. package/dist/tracker/exclusion.d.ts +2 -22
  856. package/dist/tracker/exclusion.js +53 -21
  857. package/dist/tracker/exclusion.js.map +1 -1
  858. package/dist/tracker/gate.js +194 -0
  859. package/dist/tracker/gate.js.map +1 -0
  860. package/dist/tracker/initTracker.d.ts +5 -8
  861. package/dist/tracker/initTracker.js +42 -14
  862. package/dist/tracker/initTracker.js.map +1 -1
  863. package/dist/tracker/itemCapture.js +224 -0
  864. package/dist/tracker/itemCapture.js.map +1 -0
  865. package/dist/tracker/loadScript.js +21 -14
  866. package/dist/tracker/loadScript.js.map +1 -1
  867. package/dist/tracker/pageTracking.js +6 -6
  868. package/dist/tracker/pageTracking.js.map +1 -1
  869. package/dist/tracker/registry.js +118 -30
  870. package/dist/tracker/registry.js.map +1 -1
  871. package/dist/tracker/sinks/createSink.js +41 -0
  872. package/dist/tracker/sinks/createSink.js.map +1 -0
  873. package/dist/tracker/sinks/ga4.js +64 -20
  874. package/dist/tracker/sinks/ga4.js.map +1 -1
  875. package/dist/tracker/sinks/native.js +7 -42
  876. package/dist/tracker/sinks/native.js.map +1 -1
  877. package/dist/tracker/sinks/plausible.js +27 -22
  878. package/dist/tracker/sinks/plausible.js.map +1 -1
  879. package/dist/tracker/sinks/posthog.js +54 -22
  880. package/dist/tracker/sinks/posthog.js.map +1 -1
  881. package/dist/tracker/sinks/umami.js +14 -12
  882. package/dist/tracker/sinks/umami.js.map +1 -1
  883. package/dist/tracker/sinks/vendor.js +30 -27
  884. package/dist/tracker/sinks/vendor.js.map +1 -1
  885. package/dist/tracker/skip.js +81 -0
  886. package/dist/tracker/skip.js.map +1 -0
  887. package/dist/tracker/storage.js +23 -0
  888. package/dist/tracker/storage.js.map +1 -0
  889. package/dist/tracker/transport.js +2 -5
  890. package/dist/tracker/transport.js.map +1 -1
  891. package/dist/tracker/types.d.ts +86 -63
  892. package/dist/tracker/window.js +7 -0
  893. package/dist/tracker/window.js.map +1 -0
  894. package/dist/translations/ar.js +232 -71
  895. package/dist/translations/ar.js.map +1 -1
  896. package/dist/translations/de.js +221 -69
  897. package/dist/translations/de.js.map +1 -1
  898. package/dist/translations/en.js +215 -67
  899. package/dist/translations/en.js.map +1 -1
  900. package/dist/translations/es.js +223 -68
  901. package/dist/translations/es.js.map +1 -1
  902. package/dist/translations/fr.js +227 -72
  903. package/dist/translations/fr.js.map +1 -1
  904. package/dist/translations/id.js +218 -67
  905. package/dist/translations/id.js.map +1 -1
  906. package/dist/translations/index.d.ts +1 -1
  907. package/dist/translations/index.js +5 -7
  908. package/dist/translations/index.js.map +1 -1
  909. package/dist/translations/intl.js +71 -0
  910. package/dist/translations/intl.js.map +1 -0
  911. package/dist/translations/keys.d.ts +191 -14
  912. package/dist/translations/keys.js +196 -14
  913. package/dist/translations/keys.js.map +1 -1
  914. package/dist/translations/ko.js +220 -69
  915. package/dist/translations/ko.js.map +1 -1
  916. package/dist/translations/labelMap.d.ts +10 -0
  917. package/dist/translations/labelMap.js +22 -0
  918. package/dist/translations/labelMap.js.map +1 -0
  919. package/dist/translations/metricKeys.js +10 -2
  920. package/dist/translations/metricKeys.js.map +1 -1
  921. package/dist/translations/parts.js +20 -0
  922. package/dist/translations/parts.js.map +1 -0
  923. package/dist/translations/plural.js +61 -0
  924. package/dist/translations/plural.js.map +1 -0
  925. package/dist/translations/pt.js +232 -77
  926. package/dist/translations/pt.js.map +1 -1
  927. package/dist/translations/ru.js +223 -66
  928. package/dist/translations/ru.js.map +1 -1
  929. package/dist/translations/server.d.ts +1 -0
  930. package/dist/translations/server.js +2 -3
  931. package/dist/translations/server.js.map +1 -1
  932. package/dist/translations/staticLabel.js +69 -0
  933. package/dist/translations/staticLabel.js.map +1 -0
  934. package/dist/translations/uk.js +223 -66
  935. package/dist/translations/uk.js.map +1 -1
  936. package/dist/translations/zh.js +218 -67
  937. package/dist/translations/zh.js.map +1 -1
  938. package/dist/ui/RangePicker.js +112 -0
  939. package/dist/ui/RangePicker.js.map +1 -0
  940. package/dist/ui/analytics.css +1533 -0
  941. package/dist/ui/calendarDays.js +27 -0
  942. package/dist/ui/calendarDays.js.map +1 -0
  943. package/dist/ui/classNames.js +7 -0
  944. package/dist/ui/classNames.js.map +1 -0
  945. package/dist/ui/components/Card.d.ts +28 -0
  946. package/dist/ui/components/Card.js +21 -0
  947. package/dist/ui/components/Card.js.map +1 -0
  948. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  949. package/dist/ui/components/ChartDataTable.js +48 -0
  950. package/dist/ui/components/ChartDataTable.js.map +1 -0
  951. package/dist/ui/components/DataTable.d.ts +82 -0
  952. package/dist/ui/components/DataTable.js +214 -0
  953. package/dist/ui/components/DataTable.js.map +1 -0
  954. package/dist/ui/components/LabeledSelect.js +62 -0
  955. package/dist/ui/components/LabeledSelect.js.map +1 -0
  956. package/dist/ui/components/LiveAnnouncement.js +21 -0
  957. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  958. package/dist/ui/components/MetricCard.d.ts +38 -0
  959. package/dist/ui/components/MetricCard.js +39 -0
  960. package/dist/ui/components/MetricCard.js.map +1 -0
  961. package/dist/ui/components/NoValue.js +22 -0
  962. package/dist/ui/components/NoValue.js.map +1 -0
  963. package/dist/ui/components/ReadState.js +27 -0
  964. package/dist/ui/components/ReadState.js.map +1 -0
  965. package/dist/ui/components/RefreshButton.js +26 -0
  966. package/dist/ui/components/RefreshButton.js.map +1 -0
  967. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  969. package/dist/ui/cssVars.js +7 -0
  970. package/dist/ui/cssVars.js.map +1 -0
  971. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  972. package/dist/ui/data/WithScopeToken.js +20 -0
  973. package/dist/ui/data/WithScopeToken.js.map +1 -0
  974. package/dist/ui/data/clientFieldProps.js +16 -0
  975. package/dist/ui/data/clientFieldProps.js.map +1 -0
  976. package/dist/ui/data/request.d.ts +46 -0
  977. package/dist/ui/data/request.js +119 -0
  978. package/dist/ui/data/request.js.map +1 -0
  979. package/dist/ui/data/scopeTokenContext.js +18 -0
  980. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  981. package/dist/ui/data/sharedCache.js +48 -0
  982. package/dist/ui/data/sharedCache.js.map +1 -0
  983. package/dist/ui/data/useRequest.d.ts +19 -0
  984. package/dist/ui/data/useRequest.js +123 -0
  985. package/dist/ui/data/useRequest.js.map +1 -0
  986. package/dist/ui/data/useRequestScope.js +25 -0
  987. package/dist/ui/data/useRequestScope.js.map +1 -0
  988. package/dist/ui/hooks/useDirection.js +47 -0
  989. package/dist/ui/hooks/useDirection.js.map +1 -0
  990. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  992. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  994. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  995. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  996. package/dist/ui/readState.js +19 -0
  997. package/dist/ui/readState.js.map +1 -0
  998. package/dist/ui/rows/toDisplayRows.js +49 -0
  999. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1000. package/dist/ui/viewerClock.js +7 -0
  1001. package/dist/ui/viewerClock.js.map +1 -0
  1002. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1003. package/dist/view/AnalyticsNavLink.js +11 -6
  1004. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1005. package/dist/view/AnalyticsView.d.ts +8 -10
  1006. package/dist/view/AnalyticsView.js +47 -18
  1007. package/dist/view/AnalyticsView.js.map +1 -1
  1008. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1009. package/dist/view/AnalyticsViewClient.js +15 -229
  1010. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1011. package/dist/view/CountryFlag.d.ts +27 -0
  1012. package/dist/view/CountryFlag.js +44 -0
  1013. package/dist/view/CountryFlag.js.map +1 -0
  1014. package/dist/view/DocumentTitle.js +27 -0
  1015. package/dist/view/DocumentTitle.js.map +1 -0
  1016. package/dist/view/ViewRoot.d.ts +21 -0
  1017. package/dist/view/ViewRoot.js +152 -0
  1018. package/dist/view/ViewRoot.js.map +1 -0
  1019. package/dist/view/ViewSections.d.ts +38 -0
  1020. package/dist/view/ViewSections.js +190 -0
  1021. package/dist/view/ViewSections.js.map +1 -0
  1022. package/dist/view/authRedirect.js +2 -4
  1023. package/dist/view/authRedirect.js.map +1 -1
  1024. package/dist/view/conversionRate.js +9 -7
  1025. package/dist/view/conversionRate.js.map +1 -1
  1026. package/dist/view/dayRange.js +6 -10
  1027. package/dist/view/dayRange.js.map +1 -1
  1028. package/dist/view/exclusionLink.d.ts +27 -0
  1029. package/dist/view/exclusionLink.js +46 -0
  1030. package/dist/view/exclusionLink.js.map +1 -0
  1031. package/dist/view/flagSrc.js +14 -0
  1032. package/dist/view/flagSrc.js.map +1 -0
  1033. package/dist/view/gating.d.ts +15 -1
  1034. package/dist/view/gating.js +66 -31
  1035. package/dist/view/gating.js.map +1 -1
  1036. package/dist/view/hostCountryFlag.js +41 -0
  1037. package/dist/view/hostCountryFlag.js.map +1 -0
  1038. package/dist/view/labels.js +95 -10
  1039. package/dist/view/labels.js.map +1 -1
  1040. package/dist/view/metricAliases.js +10 -0
  1041. package/dist/view/metricAliases.js.map +1 -0
  1042. package/dist/view/navLabel.js +15 -0
  1043. package/dist/view/navLabel.js.map +1 -0
  1044. package/dist/view/registerView.js +13 -11
  1045. package/dist/view/registerView.js.map +1 -1
  1046. package/dist/view/scopeLabel.js +21 -0
  1047. package/dist/view/scopeLabel.js.map +1 -0
  1048. package/dist/view/sections/Breakdowns.js +196 -134
  1049. package/dist/view/sections/Breakdowns.js.map +1 -1
  1050. package/dist/view/sections/EmptyStates.js +118 -30
  1051. package/dist/view/sections/EmptyStates.js.map +1 -1
  1052. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1053. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1054. package/dist/view/sections/FilterChips.js +124 -27
  1055. package/dist/view/sections/FilterChips.js.map +1 -1
  1056. package/dist/view/sections/GoalsPanel.js +68 -60
  1057. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1058. package/dist/view/sections/OverviewCards.js +29 -33
  1059. package/dist/view/sections/OverviewCards.js.map +1 -1
  1060. package/dist/view/sections/RealtimeStrip.js +70 -59
  1061. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1062. package/dist/view/sections/SectionBoundary.js +34 -0
  1063. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1064. package/dist/view/sections/Toolbar.d.ts +11 -0
  1065. package/dist/view/sections/Toolbar.js +123 -82
  1066. package/dist/view/sections/Toolbar.js.map +1 -1
  1067. package/dist/view/sections/Trend.js +176 -76
  1068. package/dist/view/sections/Trend.js.map +1 -1
  1069. package/dist/view/state.d.ts +42 -0
  1070. package/dist/view/state.js +93 -54
  1071. package/dist/view/state.js.map +1 -1
  1072. package/dist/view/useViewClock.js +31 -0
  1073. package/dist/view/useViewClock.js.map +1 -0
  1074. package/dist/view/useViewQueries.d.ts +21 -0
  1075. package/dist/view/useViewQueries.js +45 -77
  1076. package/dist/view/useViewQueries.js.map +1 -1
  1077. package/dist/view/useViewState.js +42 -0
  1078. package/dist/view/useViewState.js.map +1 -0
  1079. package/dist/view/useViewUrl.js +47 -0
  1080. package/dist/view/useViewUrl.js.map +1 -0
  1081. package/dist/view/viewBody.js +30 -0
  1082. package/dist/view/viewBody.js.map +1 -0
  1083. package/dist/view/viewContext.d.ts +81 -0
  1084. package/dist/view/viewContext.js +49 -0
  1085. package/dist/view/viewContext.js.map +1 -0
  1086. package/dist/view/viewProps.d.ts +65 -8
  1087. package/dist/view/viewProps.js +123 -36
  1088. package/dist/view/viewProps.js.map +1 -1
  1089. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1090. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1091. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1092. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1093. package/dist/widgets/AnalyticsGoalsWidget.js +125 -167
  1094. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1096. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1097. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1100. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1103. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1104. package/dist/widgets/ComparisonDelta.js +33 -42
  1105. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1106. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1107. package/dist/widgets/RealtimeCounter.js +91 -77
  1108. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1109. package/dist/widgets/WidgetCard.d.ts +80 -0
  1110. package/dist/widgets/WidgetCard.js +99 -0
  1111. package/dist/widgets/WidgetCard.js.map +1 -0
  1112. package/dist/widgets/WidgetFrame.js +42 -0
  1113. package/dist/widgets/WidgetFrame.js.map +1 -0
  1114. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1115. package/dist/widgets/WidgetShimmer.js +86 -0
  1116. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1117. package/dist/widgets/breakdownTypes.js +12 -2
  1118. package/dist/widgets/breakdownTypes.js.map +1 -1
  1119. package/dist/widgets/customWidget.d.ts +5 -1
  1120. package/dist/widgets/customWidget.js +6 -7
  1121. package/dist/widgets/customWidget.js.map +1 -1
  1122. package/dist/widgets/defaultLayout.d.ts +26 -0
  1123. package/dist/widgets/defaultLayout.js +51 -0
  1124. package/dist/widgets/defaultLayout.js.map +1 -0
  1125. package/dist/widgets/defaults.d.ts +4 -7
  1126. package/dist/widgets/defaults.js +4 -7
  1127. package/dist/widgets/defaults.js.map +1 -1
  1128. package/dist/widgets/fieldRows.js +14 -0
  1129. package/dist/widgets/fieldRows.js.map +1 -0
  1130. package/dist/widgets/filterCaption.js +6 -7
  1131. package/dist/widgets/filterCaption.js.map +1 -1
  1132. package/dist/widgets/filterField.d.ts +3 -7
  1133. package/dist/widgets/filterField.js +46 -35
  1134. package/dist/widgets/filterField.js.map +1 -1
  1135. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1136. package/dist/widgets/filterValueLabel.js +45 -0
  1137. package/dist/widgets/filterValueLabel.js.map +1 -0
  1138. package/dist/widgets/notices.js +74 -0
  1139. package/dist/widgets/notices.js.map +1 -0
  1140. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1141. package/dist/widgets/prepareWidgetRead.js +63 -27
  1142. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1143. package/dist/widgets/range.js +26 -21
  1144. package/dist/widgets/range.js.map +1 -1
  1145. package/dist/widgets/readForWidget.d.ts +28 -19
  1146. package/dist/widgets/readForWidget.js +33 -29
  1147. package/dist/widgets/readForWidget.js.map +1 -1
  1148. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1149. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1150. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1151. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1152. package/dist/widgets/readForWidgetGoals.js +52 -46
  1153. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1154. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1155. package/dist/widgets/readForWidgetRealtime.js +54 -28
  1156. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1157. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1158. package/dist/widgets/readForWidgetSeries.js +45 -82
  1159. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1160. package/dist/widgets/readMeta.d.ts +44 -0
  1161. package/dist/widgets/readMeta.js +47 -4
  1162. package/dist/widgets/readMeta.js.map +1 -1
  1163. package/dist/widgets/realtimePoll.d.ts +1 -0
  1164. package/dist/widgets/realtimePoll.js +53 -25
  1165. package/dist/widgets/realtimePoll.js.map +1 -1
  1166. package/dist/widgets/registerWidgets.js +207 -127
  1167. package/dist/widgets/registerWidgets.js.map +1 -1
  1168. package/dist/widgets/stateKeys.js +30 -0
  1169. package/dist/widgets/stateKeys.js.map +1 -0
  1170. package/dist/widgets/titleForecast.js +89 -0
  1171. package/dist/widgets/titleForecast.js.map +1 -0
  1172. package/dist/widgets/types.d.ts +4 -3
  1173. package/dist/widgets/types.js +2 -0
  1174. package/dist/widgets/types.js.map +1 -1
  1175. package/dist/widgets/viewLink.d.ts +24 -6
  1176. package/dist/widgets/viewLink.js +31 -24
  1177. package/dist/widgets/viewLink.js.map +1 -1
  1178. package/dist/widgets/widgetData.js +34 -0
  1179. package/dist/widgets/widgetData.js.map +1 -0
  1180. package/dist/widgets/widgetWindow.d.ts +1 -0
  1181. package/dist/widgets/widgetWindow.js +51 -0
  1182. package/dist/widgets/widgetWindow.js.map +1 -0
  1183. package/package.json +44 -22
  1184. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1185. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1186. package/dist/capture/getTrackerConfig.js +0 -31
  1187. package/dist/capture/getTrackerConfig.js.map +0 -1
  1188. package/dist/capture/slots.d.ts +0 -8
  1189. package/dist/capture/trackerConfig.d.ts +0 -33
  1190. package/dist/charts/styles.js +0 -59
  1191. package/dist/charts/styles.js.map +0 -1
  1192. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1193. package/dist/fields/dateRange/styles.js +0 -23
  1194. package/dist/fields/dateRange/styles.js.map +0 -1
  1195. package/dist/goals/GoalSelectField.d.ts +0 -7
  1196. package/dist/native/collections/events.js +0 -165
  1197. package/dist/native/collections/events.js.map +0 -1
  1198. package/dist/native/collections/rollups.js +0 -151
  1199. package/dist/native/collections/rollups.js.map +0 -1
  1200. package/dist/native/collections/seen.js +0 -47
  1201. package/dist/native/collections/seen.js.map +0 -1
  1202. package/dist/native/eventScan.js +0 -25
  1203. package/dist/native/eventScan.js.map +0 -1
  1204. package/dist/native/ingest/flushBatch.js +0 -60
  1205. package/dist/native/ingest/flushBatch.js.map +0 -1
  1206. package/dist/native/ingest/salt.js +0 -39
  1207. package/dist/native/ingest/salt.js.map +0 -1
  1208. package/dist/native/ingest/writeBuffer.js +0 -55
  1209. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1210. package/dist/native/ingest/writeEvent.js +0 -14
  1211. package/dist/native/ingest/writeEvent.js.map +0 -1
  1212. package/dist/native/query/eventAgg.js +0 -175
  1213. package/dist/native/query/eventAgg.js.map +0 -1
  1214. package/dist/native/realtime/buildRealtime.js +0 -53
  1215. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1216. package/dist/native/retention/pruneTask.js +0 -69
  1217. package/dist/native/retention/pruneTask.js.map +0 -1
  1218. package/dist/native/rollupAcc.js +0 -64
  1219. package/dist/native/rollupAcc.js.map +0 -1
  1220. package/dist/native/rollups/bucketKey.js +0 -15
  1221. package/dist/native/rollups/bucketKey.js.map +0 -1
  1222. package/dist/native/rollups/bumpRollups.js +0 -116
  1223. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1224. package/dist/native/rollups/deltas.js +0 -106
  1225. package/dist/native/rollups/deltas.js.map +0 -1
  1226. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1227. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1228. package/dist/plugin/paths.js +0 -29
  1229. package/dist/plugin/paths.js.map +0 -1
  1230. package/dist/react/TrackerBoot.d.ts +0 -22
  1231. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1232. package/dist/rsc/AnalyticsScripts.js +0 -41
  1233. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1234. package/dist/surfacing/queue.js +0 -60
  1235. package/dist/surfacing/queue.js.map +0 -1
  1236. package/dist/surfacing/retryPolicy.js +0 -15
  1237. package/dist/surfacing/retryPolicy.js.map +0 -1
  1238. package/dist/tracker/autoCapture.d.ts +0 -48
  1239. package/dist/tracker/consent.d.ts +0 -24
  1240. package/dist/tracker/consent.js +0 -48
  1241. package/dist/tracker/consent.js.map +0 -1
  1242. package/dist/tracker/loadScript.d.ts +0 -14
  1243. package/dist/tracker/pageTracking.d.ts +0 -17
  1244. package/dist/tracker/registry.d.ts +0 -27
  1245. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1246. package/dist/tracker/sinks/native.d.ts +0 -22
  1247. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1248. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1249. package/dist/tracker/sinks/umami.d.ts +0 -18
  1250. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1251. package/dist/view/sections/styles.js +0 -76
  1252. package/dist/view/sections/styles.js.map +0 -1
  1253. package/dist/widgets/WidgetViewLink.js +0 -17
  1254. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1255. package/dist/widgets/cardChrome.d.ts +0 -8
  1256. package/dist/widgets/cardChrome.js +0 -46
  1257. package/dist/widgets/cardChrome.js.map +0 -1
  1258. package/dist/widgets/comparison.js +0 -57
  1259. package/dist/widgets/comparison.js.map +0 -1
@@ -1,13 +1,26 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { keys } from "../translations/keys.js";
3
+ import { currentTime } from "../core/clock.js";
4
+ import { recall, remember } from "../surfacing/bounded.js";
5
+ import { createEpochFallback } from "../surfacing/epoch.js";
6
+ import { asTranslate } from "../translations/server.js";
1
7
  import { GOAL_SLUG_PATTERN } from "./types.js";
8
+ import { isCollectionSlug } from "../core/collectionSlug.js";
9
+ import { PROBE_MEMO_MS, createCollectionProbe } from "../providers/probe.js";
10
+ import "./constants.js";
11
+ import { builtinPurchaseGoal } from "./builtin.js";
12
+ //#region src/goals/resolver.ts
13
+ /** The most enabled goals one scope's read takes: a ceiling, not a page size. */
14
+ const MAX_GOALS = 500;
15
+ /** The most a listing over every scope takes, for the names of a report that spans them. */
16
+ const MAX_GOALS_ACROSS = 5e3;
2
17
  /**
3
- * A scoped install stores install-wide goals with no scope at all, so a null scope has to
4
- * match both an absent field and an empty string (same shape the providers lookup uses).
5
- * The empty string is not castable on a relationship-typed `scopeField`, so install-wide
6
- * lookups on a host-owned relationship field fail the read and resolve config goals only.
18
+ * A null scope matches an absent field and an empty string alike. A host-owned relationship field
19
+ * cannot cast the empty string, so its install-wide lookups fail and resolve config goals only.
7
20
  */
8
21
  const goalScopeWhere = (scopeField, scope) => scope === null ? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: "" } }] } : { [scopeField]: { equals: scope } };
9
22
  const text = (value) => typeof value === "string" && value.trim() !== "" ? value : void 0;
10
- const object = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
23
+ const object = (value) => isRecord(value) && !Array.isArray(value) ? value : void 0;
11
24
  const docToMatch = (value) => {
12
25
  const raw = object(value);
13
26
  switch (raw?.kind) {
@@ -30,9 +43,8 @@ const docToMatch = (value) => {
30
43
  }
31
44
  };
32
45
  /**
33
- * One goal document as the matcher sees it, or null when the document cannot produce a
34
- * usable goal. Editors can save a half-filled draft, so a document missing the part its
35
- * match kind needs is skipped rather than allowed to match everything or nothing.
46
+ * One goal document as the matcher sees it, or null for a half-filled draft, which must match
47
+ * neither everything nor nothing.
36
48
  */
37
49
  const docToGoal = (doc) => {
38
50
  if (doc.enabled === false) return null;
@@ -56,10 +68,15 @@ const docToGoal = (doc) => {
56
68
  name: text(doc.name) ?? slug,
57
69
  match,
58
70
  ...value ? { value } : {},
59
- ...currency ? { currency } : {}
71
+ ...currency ? { currency } : {},
72
+ ...doc.browser === false ? { browser: false } : {}
60
73
  };
61
74
  };
62
- const mergeDetailed = (config, collection) => {
75
+ /**
76
+ * Config order, a collection goal replacing a same-slug config goal in place, then collection extras,
77
+ * then built-in `purchase` if unclaimed: editors adjust without reordering reports.
78
+ */
79
+ const mergeGoals = (config, collection, purchase = true) => {
63
80
  const bySlug = /* @__PURE__ */ new Map();
64
81
  for (const goal of collection) if (!bySlug.has(goal.slug)) bySlug.set(goal.slug, goal);
65
82
  const out = [];
@@ -79,69 +96,160 @@ const mergeDetailed = (config, collection) => {
79
96
  goal,
80
97
  source: "collection"
81
98
  });
99
+ if (purchase && !out.some((entry) => entry.goal.slug === "purchase")) out.push({
100
+ goal: builtinPurchaseGoal(),
101
+ source: "builtin"
102
+ });
82
103
  return out;
83
104
  };
105
+ /**
106
+ * The built-in goal's name in the caller's admin language, applied after the cache so no scope's
107
+ * entry freezes the language that warmed it.
108
+ */
109
+ const translateBuiltin = (goals, req) => {
110
+ const t = req.i18n?.t;
111
+ if (!t || !goals.some((entry) => entry.source === "builtin")) return goals;
112
+ const name = asTranslate(t)(keys.goalBuiltinPurchase);
113
+ return goals.map((entry) => entry.source === "builtin" ? {
114
+ goal: {
115
+ ...entry.goal,
116
+ name
117
+ },
118
+ source: entry.source
119
+ } : entry);
120
+ };
84
121
  /** The resolver an install without the goals collection gets: config goals, no reads. */
85
- const configGoalsResolver = (config) => {
86
- const detailed = mergeDetailed(config, []);
122
+ const configGoalsResolver = (config, purchase = true) => {
123
+ const detailed = mergeGoals(config, [], purchase);
87
124
  return {
88
- resolve: async () => config,
89
- resolveDetailed: async () => detailed,
90
- invalidate: () => {}
125
+ resolve: async (req) => translateBuiltin(detailed, req).map((entry) => entry.goal),
126
+ resolveDetailed: async (req) => translateBuiltin(detailed, req),
127
+ listReadable: async (req) => translateBuiltin(detailed, req),
128
+ listAcross: async (req) => translateBuiltin(detailed, req),
129
+ epoch: async () => "0",
130
+ changed: () => {}
91
131
  };
92
132
  };
133
+ const goalsOf = (docs) => docs.filter(isRecord).flatMap((doc) => docToGoal(doc) ?? []);
93
134
  /**
94
- * Merges the goals collection over the config goals, cached per scope for a short TTL so
95
- * ingest (which resolves goals on every event) does not query the collection per request.
96
- * Invalidation clears all scopes at once: a document's scope can itself change, so evicting
97
- * one scope could leave a stale entry under the other.
135
+ * Merges collection over config goals per instance, cached per scope under its goals epoch so
136
+ * ingest rereads only after a change. Read on its own request, outside the caller's transaction.
98
137
  */
99
138
  const createGoalsResolver = (args) => {
100
- const ttlMs = args.ttlMs ?? 3e4;
101
- const now = args.now ?? Date.now;
102
- const configGoals = mergeDetailed(args.config, []);
139
+ const { payload } = args;
140
+ const now = args.now ?? currentTime;
141
+ const purchase = args.purchase !== false;
142
+ const configGoals = mergeGoals(args.config, [], purchase);
143
+ const probe = args.probe ?? createCollectionProbe({
144
+ payload,
145
+ slug: args.slug,
146
+ scopeField: args.scopeField,
147
+ ...args.scoped ? { where: (scope) => goalScopeWhere(args.scopeField, scope) } : {},
148
+ now
149
+ });
103
150
  const cache = /* @__PURE__ */ new Map();
104
- const load = async (req, scope) => {
151
+ /** Scopes whose collection read failed, served the config goals until the instant kept. */
152
+ const failed = /* @__PURE__ */ new Map();
153
+ const outages = createEpochFallback(now);
154
+ const scopeOf = (scope) => args.scoped && scope !== void 0 && scope !== "" ? scope : null;
155
+ const whereFor = (scope) => args.scoped ? { and: [{ enabled: { equals: true } }, goalScopeWhere(args.scopeField, scope)] } : { enabled: { equals: true } };
156
+ /** The goals collection's slug as the instance registered it; a read of a missing one throws. */
157
+ const goalsSlug = (on) => {
158
+ if (!isCollectionSlug(on, args.slug)) throw new Error(`analytics: no "${args.slug}" collection is registered for the goals`);
159
+ return args.slug;
160
+ };
161
+ /** Every enabled goal document of the scope, as committed. */
162
+ const findAll = async (scope) => {
163
+ const { docs } = await payload.find({
164
+ collection: goalsSlug(payload),
165
+ where: whereFor(scope),
166
+ limit: MAX_GOALS,
167
+ pagination: false,
168
+ depth: 0,
169
+ overrideAccess: true
170
+ });
171
+ return goalsOf(docs);
172
+ };
173
+ const resolveDetailed = async (req, raw) => {
174
+ const scope = scopeOf(raw);
175
+ const key = scope ?? "";
176
+ const at = now();
177
+ if ((failed.get(key) ?? 0) > at) return translateBuiltin(configGoals, req);
178
+ try {
179
+ const { epoch } = await probe.read(scope);
180
+ let cached = recall(cache, key);
181
+ if (cached?.epoch !== epoch) {
182
+ const entry = {
183
+ epoch,
184
+ goals: findAll(scope).then((goals) => mergeGoals(args.config, goals, purchase))
185
+ };
186
+ remember(cache, [key, entry]);
187
+ entry.goals.catch(() => {
188
+ if (cache.get(key) === entry) cache.delete(key);
189
+ });
190
+ cached = entry;
191
+ }
192
+ return translateBuiltin(await cached.goals, req);
193
+ } catch (err) {
194
+ remember(failed, [key, at + PROBE_MEMO_MS]);
195
+ payload.logger?.warn?.(`analytics: goals collection read failed for scope "${key}", falling back to config goals: ${String(err)}`);
196
+ return translateBuiltin(configGoals, req);
197
+ }
198
+ };
199
+ /**
200
+ * The documents `where` matches that the request's user may read, merged over config goals; a
201
+ * failed read logs `failure` and lists the config goals alone.
202
+ */
203
+ const listFor = async (req, query) => {
105
204
  try {
106
205
  const { docs } = await req.payload.find({
107
- collection: args.slug,
108
- where: args.scoped ? { and: [{ enabled: { equals: true } }, goalScopeWhere(args.scopeField, scope)] } : { enabled: { equals: true } },
109
- limit: 500,
206
+ collection: goalsSlug(req.payload),
207
+ where: query.where,
208
+ limit: query.limit,
110
209
  pagination: false,
111
210
  depth: 0,
112
- overrideAccess: true,
211
+ overrideAccess: false,
212
+ user: req.user,
213
+ disableErrors: true,
113
214
  req
114
215
  });
115
- const goals = [];
116
- for (const doc of docs) {
117
- const goal = docToGoal(doc);
118
- if (goal) goals.push(goal);
119
- }
120
- return mergeDetailed(args.config, goals);
216
+ return translateBuiltin(mergeGoals(args.config, goalsOf(docs), purchase), req);
121
217
  } catch (err) {
122
- req.payload.logger?.warn?.(`analytics: goals collection read failed for scope "${scope ?? ""}", falling back to config goals: ${String(err)}`);
123
- return configGoals;
218
+ req.payload.logger?.warn?.(`analytics: ${query.failure}: ${String(err)}`);
219
+ return translateBuiltin(configGoals, req);
124
220
  }
125
221
  };
126
- const resolveDetailed = async (req, scope) => {
127
- const key = scope ?? "";
128
- const at = now();
129
- const hit = cache.get(key);
130
- if (hit && hit.expiresAt > at) return hit.goals;
131
- const goals = await load(req, args.scoped ? scope ?? null : null);
132
- cache.set(key, {
133
- goals,
134
- expiresAt: at + ttlMs
222
+ const listReadable = (req, raw) => {
223
+ const scope = scopeOf(raw);
224
+ return listFor(req, {
225
+ where: whereFor(scope),
226
+ limit: MAX_GOALS,
227
+ failure: `goals collection listing failed for scope "${scope ?? ""}", listing config goals`
135
228
  });
136
- return goals;
137
229
  };
230
+ const listAcross = (req) => args.scoped ? listFor(req, {
231
+ where: { enabled: { equals: true } },
232
+ limit: MAX_GOALS_ACROSS,
233
+ failure: "goals collection listing across scopes failed, naming config goals only"
234
+ }) : listReadable(req, null);
138
235
  return {
139
236
  resolve: async (req, scope) => (await resolveDetailed(req, scope)).map((entry) => entry.goal),
140
237
  resolveDetailed,
141
- invalidate: () => cache.clear()
238
+ listReadable,
239
+ listAcross,
240
+ epoch: async (raw) => {
241
+ const scope = scopeOf(raw);
242
+ if ((failed.get(scope ?? "") ?? 0) > now()) return outages.outage(scope);
243
+ try {
244
+ return outages.read(scope, (await probe.read(scope)).epoch);
245
+ } catch {
246
+ return outages.outage(scope);
247
+ }
248
+ },
249
+ changed: (scopes) => probe.expedite([...scopes].map(scopeOf))
142
250
  };
143
251
  };
144
252
  //#endregion
145
- export { configGoalsResolver, createGoalsResolver, goalScopeWhere };
253
+ export { configGoalsResolver, createGoalsResolver };
146
254
 
147
255
  //# sourceMappingURL=resolver.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolver.js","names":[],"sources":["../../src/goals/resolver.ts"],"sourcesContent":["import type { PayloadRequest, Where } from 'payload'\nimport { GOAL_SLUG_PATTERN, type Goal, type GoalMatch } from './types'\n\nexport const GOALS_CACHE_TTL_MS = 30_000\n\n/** Where a resolved goal came from; Task 2's endpoint shows it next to the goal. */\nexport type GoalSource = 'config' | 'collection'\n\nexport interface ResolvedGoal {\n\tgoal: Goal\n\tsource: GoalSource\n}\n\nexport interface GoalsResolver {\n\tresolve: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n\tresolveDetailed: (req: PayloadRequest, scope?: string | null) => Promise<ResolvedGoal[]>\n\t/** Drops every cached scope; wired to the goals collection's change hooks. */\n\tinvalidate: () => void\n}\n\n/**\n * A scoped install stores install-wide goals with no scope at all, so a null scope has to\n * match both an absent field and an empty string (same shape the providers lookup uses).\n * The empty string is not castable on a relationship-typed `scopeField`, so install-wide\n * lookups on a host-owned relationship field fail the read and resolve config goals only.\n */\nexport const goalScopeWhere = (scopeField: string, scope: string | null): Where =>\n\tscope === null\n\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t: { [scopeField]: { equals: scope } }\n\nconst text = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && value.trim() !== '' ? value : undefined\n\nconst object = (value: unknown): Record<string, unknown> | undefined =>\n\tvalue && typeof value === 'object' && !Array.isArray(value)\n\t\t? (value as Record<string, unknown>)\n\t\t: undefined\n\nconst docToMatch = (value: unknown): GoalMatch | null => {\n\tconst raw = object(value)\n\tswitch (raw?.kind) {\n\t\tcase 'goal':\n\t\t\treturn { kind: 'goal' }\n\t\tcase 'event': {\n\t\t\tconst name = text(raw.name)\n\t\t\treturn name ? { kind: 'event', name } : null\n\t\t}\n\t\tcase 'path': {\n\t\t\tconst pattern = text(raw.pattern)\n\t\t\treturn pattern ? { kind: 'path', pattern } : null\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * One goal document as the matcher sees it, or null when the document cannot produce a\n * usable goal. Editors can save a half-filled draft, so a document missing the part its\n * match kind needs is skipped rather than allowed to match everything or nothing.\n */\nexport const docToGoal = (doc: Record<string, unknown>): Goal | null => {\n\tif (doc.enabled === false) {\n\t\treturn null\n\t}\n\tconst slug = text(doc.slug)\n\tif (!slug || !GOAL_SLUG_PATTERN.test(slug)) {\n\t\treturn null\n\t}\n\tconst match = docToMatch(doc.match)\n\tif (!match) {\n\t\treturn null\n\t}\n\tconst raw = object(doc.value)\n\tconst fixed = raw?.fixed\n\tif (fixed !== null && fixed !== undefined) {\n\t\tif (typeof fixed !== 'number' || !Number.isFinite(fixed) || fixed < 0) {\n\t\t\treturn null\n\t\t}\n\t}\n\tconst prop = text(raw?.prop)\n\tconst value =\n\t\ttypeof fixed === 'number' || prop\n\t\t\t? { ...(typeof fixed === 'number' ? { fixed } : {}), ...(prop ? { prop } : {}) }\n\t\t\t: undefined\n\tconst currency = text(doc.currency)\n\treturn {\n\t\tslug,\n\t\tname: text(doc.name) ?? slug,\n\t\tmatch,\n\t\t...(value ? { value } : {}),\n\t\t...(currency ? { currency } : {}),\n\t}\n}\n\nconst mergeDetailed = (config: Goal[], collection: Goal[]): ResolvedGoal[] => {\n\tconst bySlug = new Map<string, Goal>()\n\tfor (const goal of collection) {\n\t\tif (!bySlug.has(goal.slug)) {\n\t\t\tbySlug.set(goal.slug, goal)\n\t\t}\n\t}\n\tconst out: ResolvedGoal[] = []\n\tconst taken = new Set<string>()\n\tfor (const goal of config) {\n\t\tconst override = bySlug.get(goal.slug)\n\t\tout.push(override ? { goal: override, source: 'collection' } : { goal, source: 'config' })\n\t\ttaken.add(goal.slug)\n\t}\n\tfor (const [slug, goal] of bySlug) {\n\t\tif (!taken.has(slug)) {\n\t\t\tout.push({ goal, source: 'collection' })\n\t\t}\n\t}\n\treturn out\n}\n\n/**\n * Config order first, with a collection goal replacing the config goal of the same slug in\n * place, then the collection's own extras. Editors adjust what config declared without\n * reordering the reports built on it.\n */\nexport const mergeGoals = (config: Goal[], collection: Goal[]): Goal[] =>\n\tmergeDetailed(config, collection).map((entry) => entry.goal)\n\n/** The resolver an install without the goals collection gets: config goals, no reads. */\nexport const configGoalsResolver = (config: Goal[]): GoalsResolver => {\n\tconst detailed = mergeDetailed(config, [])\n\treturn {\n\t\tresolve: async () => config,\n\t\tresolveDetailed: async () => detailed,\n\t\tinvalidate: () => {},\n\t}\n}\n\nexport interface CreateGoalsResolverArgs {\n\tslug: string\n\tscopeField: string\n\t/** True when the install configured a scopeResolver; unscoped installs ignore scope. */\n\tscoped: boolean\n\tconfig: Goal[]\n\tttlMs?: number\n\tnow?: () => number\n}\n\n/**\n * Merges the goals collection over the config goals, cached per scope for a short TTL so\n * ingest (which resolves goals on every event) does not query the collection per request.\n * Invalidation clears all scopes at once: a document's scope can itself change, so evicting\n * one scope could leave a stale entry under the other.\n */\nexport const createGoalsResolver = (args: CreateGoalsResolverArgs): GoalsResolver => {\n\tconst ttlMs = args.ttlMs ?? GOALS_CACHE_TTL_MS\n\tconst now = args.now ?? Date.now\n\tconst configGoals = mergeDetailed(args.config, [])\n\tconst cache = new Map<string, { goals: ResolvedGoal[]; expiresAt: number }>()\n\n\tconst load = async (req: PayloadRequest, scope: string | null): Promise<ResolvedGoal[]> => {\n\t\ttry {\n\t\t\tconst { docs } = await req.payload.find({\n\t\t\t\tcollection: args.slug as never,\n\t\t\t\twhere: args.scoped\n\t\t\t\t\t? { and: [{ enabled: { equals: true } }, goalScopeWhere(args.scopeField, scope)] }\n\t\t\t\t\t: { enabled: { equals: true } },\n\t\t\t\tlimit: 500,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: true,\n\t\t\t\treq,\n\t\t\t})\n\t\t\tconst goals: Goal[] = []\n\t\t\tfor (const doc of docs as unknown as Array<Record<string, unknown>>) {\n\t\t\t\tconst goal = docToGoal(doc)\n\t\t\t\tif (goal) {\n\t\t\t\t\tgoals.push(goal)\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn mergeDetailed(args.config, goals)\n\t\t} catch (err) {\n\t\t\t// Goal matching must not take ingest down with the collection: config goals still\n\t\t\t// match, and the failed result is cached so a broken read is not retried per event.\n\t\t\treq.payload.logger?.warn?.(\n\t\t\t\t`analytics: goals collection read failed for scope \"${scope ?? ''}\", falling back to config goals: ${String(err)}`\n\t\t\t)\n\t\t\treturn configGoals\n\t\t}\n\t}\n\n\tconst resolveDetailed = async (\n\t\treq: PayloadRequest,\n\t\tscope?: string | null\n\t): Promise<ResolvedGoal[]> => {\n\t\tconst key = scope ?? ''\n\t\tconst at = now()\n\t\tconst hit = cache.get(key)\n\t\tif (hit && hit.expiresAt > at) {\n\t\t\treturn hit.goals\n\t\t}\n\t\tconst goals = await load(req, args.scoped ? (scope ?? null) : null)\n\t\tcache.set(key, { goals, expiresAt: at + ttlMs })\n\t\treturn goals\n\t}\n\n\treturn {\n\t\tresolve: async (req, scope) => (await resolveDetailed(req, scope)).map((entry) => entry.goal),\n\t\tresolveDetailed,\n\t\tinvalidate: () => cache.clear(),\n\t}\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"resolver.js","names":[],"sources":["../../src/goals/resolver.ts"],"sourcesContent":["import type { CollectionSlug, Payload, PayloadRequest, Where } from 'payload'\nimport { currentTime } from '../core/clock'\nimport { isCollectionSlug } from '../core/collectionSlug'\nimport { isRecord } from '../core/values'\nimport { type CollectionProbe, createCollectionProbe, PROBE_MEMO_MS } from '../providers/probe'\nimport { recall, remember } from '../surfacing/bounded'\nimport { createEpochFallback, FIXED_CONFIG_EPOCH } from '../surfacing/epoch'\nimport type { GoalMatch } from '../tracker/config'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\nimport { builtinPurchaseGoal } from './builtin'\nimport { PURCHASE_GOAL_SLUG } from './constants'\nimport { GOAL_SLUG_PATTERN, type Goal } from './types'\n\n/** The most enabled goals one scope's read takes: a ceiling, not a page size. */\nconst MAX_GOALS = 500\n\n/** The most a listing over every scope takes, for the names of a report that spans them. */\nconst MAX_GOALS_ACROSS = 5000\n\n/** Where a resolved goal came from, which the goals endpoint shows beside it. */\nexport type GoalSource = 'config' | 'collection' | 'builtin'\n\nexport interface ResolvedGoal {\n\tgoal: Goal\n\tsource: GoalSource\n}\n\nexport interface GoalsResolver {\n\tresolve: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n\tresolveDetailed: (req: PayloadRequest, scope?: string | null) => Promise<ResolvedGoal[]>\n\t/**\n\t * The same merge for a reader's listing, with the collection's goals its read access shows the\n\t * request's user, uncached. Ingest and jobs keep `resolveDetailed`, which sees every goal.\n\t */\n\tlistReadable: (req: PayloadRequest, scope?: string | null) => Promise<ResolvedGoal[]>\n\t/**\n\t * The same merge over every scope the user may read, uncached, for a report spanning them; a slug\n\t * two scopes share keeps the first name found.\n\t */\n\tlistAcross: (req: PayloadRequest) => Promise<ResolvedGoal[]>\n\t/** The scope's goals configuration epoch, which every cache key carries. */\n\tepoch: (scope?: string | null) => Promise<string>\n\t/** A save on this instance touched these scopes, which it reads again as soon as it commits. */\n\tchanged: (scopes: Iterable<string | null>) => void\n}\n\n/**\n * A null scope matches an absent field and an empty string alike. A host-owned relationship field\n * cannot cast the empty string, so its install-wide lookups fail and resolve config goals only.\n */\nexport const goalScopeWhere = (scopeField: string, scope: string | null): Where =>\n\tscope === null\n\t\t? { or: [{ [scopeField]: { equals: null } }, { [scopeField]: { equals: '' } }] }\n\t\t: { [scopeField]: { equals: scope } }\n\nconst text = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && value.trim() !== '' ? value : undefined\n\nconst object = (value: unknown): Record<string, unknown> | undefined =>\n\tisRecord(value) && !Array.isArray(value) ? value : undefined\n\nconst docToMatch = (value: unknown): GoalMatch | null => {\n\tconst raw = object(value)\n\tswitch (raw?.kind) {\n\t\tcase 'goal':\n\t\t\treturn { kind: 'goal' }\n\t\tcase 'event': {\n\t\t\tconst name = text(raw.name)\n\t\t\treturn name ? { kind: 'event', name } : null\n\t\t}\n\t\tcase 'path': {\n\t\t\tconst pattern = text(raw.pattern)\n\t\t\treturn pattern ? { kind: 'path', pattern } : null\n\t\t}\n\t\tdefault:\n\t\t\treturn null\n\t}\n}\n\n/**\n * One goal document as the matcher sees it, or null for a half-filled draft, which must match\n * neither everything nor nothing.\n */\nexport const docToGoal = (doc: Record<string, unknown>): Goal | null => {\n\tif (doc.enabled === false) {\n\t\treturn null\n\t}\n\tconst slug = text(doc.slug)\n\tif (!slug || !GOAL_SLUG_PATTERN.test(slug)) {\n\t\treturn null\n\t}\n\tconst match = docToMatch(doc.match)\n\tif (!match) {\n\t\treturn null\n\t}\n\tconst raw = object(doc.value)\n\tconst fixed = raw?.fixed\n\tif (fixed !== null && fixed !== undefined) {\n\t\tif (typeof fixed !== 'number' || !Number.isFinite(fixed) || fixed < 0) {\n\t\t\treturn null\n\t\t}\n\t}\n\tconst prop = text(raw?.prop)\n\tconst value =\n\t\ttypeof fixed === 'number' || prop\n\t\t\t? { ...(typeof fixed === 'number' ? { fixed } : {}), ...(prop ? { prop } : {}) }\n\t\t\t: undefined\n\tconst currency = text(doc.currency)\n\treturn {\n\t\tslug,\n\t\tname: text(doc.name) ?? slug,\n\t\tmatch,\n\t\t...(value ? { value } : {}),\n\t\t...(currency ? { currency } : {}),\n\t\t...(doc.browser === false ? { browser: false } : {}),\n\t}\n}\n\n/**\n * Config order, a collection goal replacing a same-slug config goal in place, then collection extras,\n * then built-in `purchase` if unclaimed: editors adjust without reordering reports.\n */\nexport const mergeGoals = (config: Goal[], collection: Goal[], purchase = true): ResolvedGoal[] => {\n\tconst bySlug = new Map<string, Goal>()\n\tfor (const goal of collection) {\n\t\tif (!bySlug.has(goal.slug)) {\n\t\t\tbySlug.set(goal.slug, goal)\n\t\t}\n\t}\n\tconst out: ResolvedGoal[] = []\n\tconst taken = new Set<string>()\n\tfor (const goal of config) {\n\t\tconst override = bySlug.get(goal.slug)\n\t\tout.push(override ? { goal: override, source: 'collection' } : { goal, source: 'config' })\n\t\ttaken.add(goal.slug)\n\t}\n\tfor (const [slug, goal] of bySlug) {\n\t\tif (!taken.has(slug)) {\n\t\t\tout.push({ goal, source: 'collection' })\n\t\t}\n\t}\n\tif (purchase && !out.some((entry) => entry.goal.slug === PURCHASE_GOAL_SLUG)) {\n\t\tout.push({ goal: builtinPurchaseGoal(), source: 'builtin' })\n\t}\n\treturn out\n}\n\n/**\n * The built-in goal's name in the caller's admin language, applied after the cache so no scope's\n * entry freezes the language that warmed it.\n */\nconst translateBuiltin = (goals: ResolvedGoal[], req: PayloadRequest): ResolvedGoal[] => {\n\tconst t = req.i18n?.t\n\tif (!t || !goals.some((entry) => entry.source === 'builtin')) {\n\t\treturn goals\n\t}\n\tconst name = asTranslate(t)(keys.goalBuiltinPurchase)\n\treturn goals.map((entry) =>\n\t\tentry.source === 'builtin' ? { goal: { ...entry.goal, name }, source: entry.source } : entry\n\t)\n}\n\n/** The resolver an install without the goals collection gets: config goals, no reads. */\nexport const configGoalsResolver = (config: Goal[], purchase = true): GoalsResolver => {\n\tconst detailed = mergeGoals(config, [], purchase)\n\treturn {\n\t\tresolve: async (req) => translateBuiltin(detailed, req).map((entry) => entry.goal),\n\t\tresolveDetailed: async (req) => translateBuiltin(detailed, req),\n\t\tlistReadable: async (req) => translateBuiltin(detailed, req),\n\t\tlistAcross: async (req) => translateBuiltin(detailed, req),\n\t\tepoch: async () => FIXED_CONFIG_EPOCH,\n\t\tchanged: () => {},\n\t}\n}\n\nexport interface CreateGoalsResolverArgs {\n\t/** The instance whose goals collection this resolves. */\n\tpayload: Payload\n\tslug: string\n\tscopeField: string\n\t/** True when the install configured `scope.resolve`; unscoped installs ignore scope. */\n\tscoped: boolean\n\tconfig: Goal[]\n\t/** `goals.purchase`: false drops the built-in goal for an install that never sells. */\n\tpurchase?: boolean\n\t/** The collection's committed state; one over `payload.db` when left out. */\n\tprobe?: CollectionProbe\n\tnow?: () => number\n}\n\ninterface CachedGoals {\n\tepoch: string\n\tgoals: Promise<ResolvedGoal[]>\n}\n\nconst goalsOf = (docs: unknown[]): Goal[] =>\n\tdocs.filter(isRecord).flatMap((doc) => docToGoal(doc) ?? [])\n\n/**\n * Merges collection over config goals per instance, cached per scope under its goals epoch so\n * ingest rereads only after a change. Read on its own request, outside the caller's transaction.\n */\nexport const createGoalsResolver = (args: CreateGoalsResolverArgs): GoalsResolver => {\n\tconst { payload } = args\n\tconst now = args.now ?? currentTime\n\tconst purchase = args.purchase !== false\n\tconst configGoals = mergeGoals(args.config, [], purchase)\n\tconst probe =\n\t\targs.probe ??\n\t\tcreateCollectionProbe({\n\t\t\tpayload,\n\t\t\tslug: args.slug,\n\t\t\tscopeField: args.scopeField,\n\t\t\t...(args.scoped ? { where: (scope) => goalScopeWhere(args.scopeField, scope) } : {}),\n\t\t\tnow,\n\t\t})\n\tconst cache = new Map<string, CachedGoals>()\n\t/** Scopes whose collection read failed, served the config goals until the instant kept. */\n\tconst failed = new Map<string, number>()\n\tconst outages = createEpochFallback(now)\n\n\tconst scopeOf = (scope: string | null | undefined): string | null =>\n\t\targs.scoped && scope !== undefined && scope !== '' ? scope : null\n\n\tconst whereFor = (scope: string | null): Where =>\n\t\targs.scoped\n\t\t\t? { and: [{ enabled: { equals: true } }, goalScopeWhere(args.scopeField, scope)] }\n\t\t\t: { enabled: { equals: true } }\n\n\t/** The goals collection's slug as the instance registered it; a read of a missing one throws. */\n\tconst goalsSlug = (on: Payload): CollectionSlug => {\n\t\tif (!isCollectionSlug(on, args.slug)) {\n\t\t\tthrow new Error(`analytics: no \"${args.slug}\" collection is registered for the goals`)\n\t\t}\n\t\treturn args.slug\n\t}\n\n\t/** Every enabled goal document of the scope, as committed. */\n\tconst findAll = async (scope: string | null): Promise<Goal[]> => {\n\t\tconst { docs } = await payload.find({\n\t\t\tcollection: goalsSlug(payload),\n\t\t\twhere: whereFor(scope),\n\t\t\tlimit: MAX_GOALS,\n\t\t\tpagination: false,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn goalsOf(docs)\n\t}\n\n\tconst resolveDetailed = async (\n\t\treq: PayloadRequest,\n\t\traw?: string | null\n\t): Promise<ResolvedGoal[]> => {\n\t\tconst scope = scopeOf(raw)\n\t\tconst key = scope ?? ''\n\t\tconst at = now()\n\t\tif ((failed.get(key) ?? 0) > at) {\n\t\t\treturn translateBuiltin(configGoals, req)\n\t\t}\n\t\ttry {\n\t\t\tconst { epoch } = await probe.read(scope)\n\t\t\tlet cached = recall(cache, key)\n\t\t\tif (cached?.epoch !== epoch) {\n\t\t\t\tconst entry: CachedGoals = {\n\t\t\t\t\tepoch,\n\t\t\t\t\tgoals: findAll(scope).then((goals) => mergeGoals(args.config, goals, purchase)),\n\t\t\t\t}\n\t\t\t\tremember(cache, [key, entry])\n\t\t\t\tentry.goals.catch(() => {\n\t\t\t\t\tif (cache.get(key) === entry) {\n\t\t\t\t\t\tcache.delete(key)\n\t\t\t\t\t}\n\t\t\t\t})\n\t\t\t\tcached = entry\n\t\t\t}\n\t\t\treturn translateBuiltin(await cached.goals, req)\n\t\t} catch (err) {\n\t\t\t// Goal matching must not take ingest down with the collection: config goals still match,\n\t\t\t// and a broken read is asked again once per probe window rather than per event.\n\t\t\tremember(failed, [key, at + PROBE_MEMO_MS])\n\t\t\tpayload.logger?.warn?.(\n\t\t\t\t`analytics: goals collection read failed for scope \"${key}\", falling back to config goals: ${String(err)}`\n\t\t\t)\n\t\t\treturn translateBuiltin(configGoals, req)\n\t\t}\n\t}\n\n\t/**\n\t * The documents `where` matches that the request's user may read, merged over config goals; a\n\t * failed read logs `failure` and lists the config goals alone.\n\t */\n\tconst listFor = async (\n\t\treq: PayloadRequest,\n\t\tquery: { where: Where; limit: number; failure: string }\n\t): Promise<ResolvedGoal[]> => {\n\t\ttry {\n\t\t\tconst { docs } = await req.payload.find({\n\t\t\t\tcollection: goalsSlug(req.payload),\n\t\t\t\twhere: query.where,\n\t\t\t\tlimit: query.limit,\n\t\t\t\tpagination: false,\n\t\t\t\tdepth: 0,\n\t\t\t\toverrideAccess: false,\n\t\t\t\tuser: req.user,\n\t\t\t\tdisableErrors: true,\n\t\t\t\treq,\n\t\t\t})\n\t\t\treturn translateBuiltin(mergeGoals(args.config, goalsOf(docs), purchase), req)\n\t\t} catch (err) {\n\t\t\treq.payload.logger?.warn?.(`analytics: ${query.failure}: ${String(err)}`)\n\t\t\treturn translateBuiltin(configGoals, req)\n\t\t}\n\t}\n\n\tconst listReadable = (req: PayloadRequest, raw?: string | null): Promise<ResolvedGoal[]> => {\n\t\tconst scope = scopeOf(raw)\n\t\treturn listFor(req, {\n\t\t\twhere: whereFor(scope),\n\t\t\tlimit: MAX_GOALS,\n\t\t\tfailure: `goals collection listing failed for scope \"${scope ?? ''}\", listing config goals`,\n\t\t})\n\t}\n\n\tconst listAcross = (req: PayloadRequest): Promise<ResolvedGoal[]> =>\n\t\targs.scoped\n\t\t\t? listFor(req, {\n\t\t\t\t\twhere: { enabled: { equals: true } },\n\t\t\t\t\tlimit: MAX_GOALS_ACROSS,\n\t\t\t\t\tfailure: 'goals collection listing across scopes failed, naming config goals only',\n\t\t\t\t})\n\t\t\t: listReadable(req, null)\n\n\treturn {\n\t\tresolve: async (req, scope) => (await resolveDetailed(req, scope)).map((entry) => entry.goal),\n\t\tresolveDetailed,\n\t\tlistReadable,\n\t\tlistAcross,\n\t\t// While the collection cannot be read the scope's answers are counted with config goals alone,\n\t\t// so they key on that outage's own token: never the healthy epoch, never another outage's.\n\t\tepoch: async (raw) => {\n\t\t\tconst scope = scopeOf(raw)\n\t\t\tif ((failed.get(scope ?? '') ?? 0) > now()) {\n\t\t\t\treturn outages.outage(scope)\n\t\t\t}\n\t\t\ttry {\n\t\t\t\treturn outages.read(scope, (await probe.read(scope)).epoch)\n\t\t\t} catch {\n\t\t\t\treturn outages.outage(scope)\n\t\t\t}\n\t\t},\n\t\tchanged: (scopes) => probe.expedite([...scopes].map(scopeOf)),\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,60 @@
1
+ import { RevenueItem } from "../tracker/config.js";
2
+ import { ServerTrackOptions } from "../core/serverEvent.js";
3
+ import { Payload } from "payload";
4
+
5
+ //#region src/goals/serverRevenue.d.ts
6
+ /** A sale, in the vocabulary GA4 uses for one. */
7
+ interface PurchaseInput {
8
+ /** The money that moved. */
9
+ value: number;
10
+ /** ISO 4217. Taken to be the reporting currency when omitted. */
11
+ currency?: string;
12
+ /**
13
+ * The order this amount belongs to. A second call with the same order and goal is ignored, so a
14
+ * payment provider may retry its webhook as often as it likes. Stored only as a digest.
15
+ */
16
+ orderId: string;
17
+ /**
18
+ * Goal slug the sale is booked against. Defaults to `purchase`, which the plugin defines unless
19
+ * config or the collection claims it, so a sale counts with no goal declared.
20
+ */
21
+ goal?: string;
22
+ /** The lines of the sale, capped and stored under the event's props. */
23
+ items?: RevenueItem[];
24
+ /**
25
+ * The content item the sale is credited to, as its `<collection>:<id>` ref: the offer or the
26
+ * product card the buyer came through. Kept only when that collection is bound as items.
27
+ */
28
+ item?: string;
29
+ /** Site the sale belongs to. Defaults to the install's `serverURL` host. */
30
+ hostname?: string;
31
+ /** The page the sale is filed under; `/orders` when unset. */
32
+ path?: string;
33
+ scope?: string | null;
34
+ props?: Record<string, unknown>;
35
+ /** When the charge settled, refused out of range exactly as `trackServerEvent`'s `now` is. */
36
+ timestamp?: Date;
37
+ }
38
+ /** A refund. The sign belongs to the call, so the amount is passed as the positive it is. */
39
+ interface RefundInput extends Omit<PurchaseInput, 'value'> {
40
+ /** The money that came back, as a positive amount. */
41
+ value: number;
42
+ /**
43
+ * The payment provider's refund id: each id counts once, so partial refunds each count and a retry
44
+ * is ignored. Stored only as a digest, like the order id.
45
+ */
46
+ refundId: string;
47
+ }
48
+ /**
49
+ * Records a sale from server code (a payment webhook, a job, a server action) with its real total,
50
+ * not the goal's fixed worth. Needs the native adapter; `orderId` makes retries safe.
51
+ */
52
+ declare const purchase: (payload: Payload, input: PurchaseInput, opts?: ServerTrackOptions) => Promise<void>;
53
+ /**
54
+ * Records a refund as a negative completion: revenue falls, conversions stand. The sign is applied
55
+ * here whatever the provider sends; a missing or invalid `refundId` throws `AnalyticsTrackError`.
56
+ */
57
+ declare const refund: (payload: Payload, input: RefundInput, opts?: ServerTrackOptions) => Promise<void>;
58
+ //#endregion
59
+ export { PurchaseInput, RefundInput, purchase, refund };
60
+ //# sourceMappingURL=serverRevenue.d.ts.map
@@ -0,0 +1,41 @@
1
+ import "./constants.js";
2
+ import { trackServerEvent } from "../native/ingest/serverTrack.js";
3
+ /**
4
+ * A goal event carrying money, keyed by a digest of scope, goal and `orderId` (and `refundId`), so a
5
+ * retried webhook writes once. An unmatched `goal` is recorded but completes nothing, logged once.
6
+ */
7
+ const recordRevenue = async (payload, input, opts) => {
8
+ await trackServerEvent(payload, {
9
+ type: "goal",
10
+ name: input.goal ?? "purchase",
11
+ path: input.path ?? "/orders",
12
+ hostname: input.hostname ?? new URL(payload.config.serverURL || "http://localhost").hostname,
13
+ value: input.value,
14
+ revenue: true,
15
+ orderId: input.orderId,
16
+ ...input.refundId === void 0 ? {} : { refundId: input.refundId },
17
+ ...input.currency ? { currency: input.currency } : {},
18
+ ...input.items ? { items: input.items } : {},
19
+ ...input.item ? { item: input.item } : {},
20
+ ...input.props ? { props: input.props } : {},
21
+ ...input.scope !== void 0 ? { scope: input.scope } : {},
22
+ ...input.timestamp ? { now: input.timestamp } : {}
23
+ }, opts);
24
+ };
25
+ /**
26
+ * Records a sale from server code (a payment webhook, a job, a server action) with its real total,
27
+ * not the goal's fixed worth. Needs the native adapter; `orderId` makes retries safe.
28
+ */
29
+ const purchase = (payload, input, opts) => recordRevenue(payload, input, opts);
30
+ /**
31
+ * Records a refund as a negative completion: revenue falls, conversions stand. The sign is applied
32
+ * here whatever the provider sends; a missing or invalid `refundId` throws `AnalyticsTrackError`.
33
+ */
34
+ const refund = (payload, input, opts) => recordRevenue(payload, {
35
+ ...input,
36
+ value: -Math.abs(input.value)
37
+ }, opts);
38
+ //#endregion
39
+ export { purchase, refund };
40
+
41
+ //# sourceMappingURL=serverRevenue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serverRevenue.js","names":[],"sources":["../../src/goals/serverRevenue.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport type { ServerTrackOptions } from '../core/serverEvent'\nimport { trackServerEvent } from '../native/ingest/serverTrack'\nimport type { RevenueItem } from '../tracker/config'\nimport { PURCHASE_GOAL_SLUG } from './constants'\n\n/** Where a sale is filed when the call names no page: one path for every order, never its id. */\nexport const ORDERS_PATH = '/orders'\n\n/** A sale, in the vocabulary GA4 uses for one. */\nexport interface PurchaseInput {\n\t/** The money that moved. */\n\tvalue: number\n\t/** ISO 4217. Taken to be the reporting currency when omitted. */\n\tcurrency?: string\n\t/**\n\t * The order this amount belongs to. A second call with the same order and goal is ignored, so a\n\t * payment provider may retry its webhook as often as it likes. Stored only as a digest.\n\t */\n\torderId: string\n\t/**\n\t * Goal slug the sale is booked against. Defaults to `purchase`, which the plugin defines unless\n\t * config or the collection claims it, so a sale counts with no goal declared.\n\t */\n\tgoal?: string\n\t/** The lines of the sale, capped and stored under the event's props. */\n\titems?: RevenueItem[]\n\t/**\n\t * The content item the sale is credited to, as its `<collection>:<id>` ref: the offer or the\n\t * product card the buyer came through. Kept only when that collection is bound as items.\n\t */\n\titem?: string\n\t/** Site the sale belongs to. Defaults to the install's `serverURL` host. */\n\thostname?: string\n\t/** The page the sale is filed under; `/orders` when unset. */\n\tpath?: string\n\tscope?: string | null\n\tprops?: Record<string, unknown>\n\t/** When the charge settled, refused out of range exactly as `trackServerEvent`'s `now` is. */\n\ttimestamp?: Date\n}\n\n/** A refund. The sign belongs to the call, so the amount is passed as the positive it is. */\nexport interface RefundInput extends Omit<PurchaseInput, 'value'> {\n\t/** The money that came back, as a positive amount. */\n\tvalue: number\n\t/**\n\t * The payment provider's refund id: each id counts once, so partial refunds each count and a retry\n\t * is ignored. Stored only as a digest, like the order id.\n\t */\n\trefundId: string\n}\n\n/**\n * A goal event carrying money, keyed by a digest of scope, goal and `orderId` (and `refundId`), so a\n * retried webhook writes once. An unmatched `goal` is recorded but completes nothing, logged once.\n */\nconst recordRevenue = async (\n\tpayload: Payload,\n\tinput: PurchaseInput & { refundId?: string },\n\topts?: ServerTrackOptions\n): Promise<void> => {\n\tawait trackServerEvent(\n\t\tpayload,\n\t\t{\n\t\t\ttype: 'goal',\n\t\t\tname: input.goal ?? PURCHASE_GOAL_SLUG,\n\t\t\tpath: input.path ?? ORDERS_PATH,\n\t\t\thostname: input.hostname ?? new URL(payload.config.serverURL || 'http://localhost').hostname,\n\t\t\tvalue: input.value,\n\t\t\trevenue: true,\n\t\t\torderId: input.orderId,\n\t\t\t...(input.refundId === undefined ? {} : { refundId: input.refundId }),\n\t\t\t...(input.currency ? { currency: input.currency } : {}),\n\t\t\t...(input.items ? { items: input.items } : {}),\n\t\t\t...(input.item ? { item: input.item } : {}),\n\t\t\t...(input.props ? { props: input.props } : {}),\n\t\t\t...(input.scope !== undefined ? { scope: input.scope } : {}),\n\t\t\t...(input.timestamp ? { now: input.timestamp } : {}),\n\t\t},\n\t\topts\n\t)\n}\n\n/**\n * Records a sale from server code (a payment webhook, a job, a server action) with its real total,\n * not the goal's fixed worth. Needs the native adapter; `orderId` makes retries safe.\n */\nexport const purchase = (\n\tpayload: Payload,\n\tinput: PurchaseInput,\n\topts?: ServerTrackOptions\n): Promise<void> => recordRevenue(payload, input, opts)\n\n/**\n * Records a refund as a negative completion: revenue falls, conversions stand. The sign is applied\n * here whatever the provider sends; a missing or invalid `refundId` throws `AnalyticsTrackError`.\n */\nexport const refund = (\n\tpayload: Payload,\n\tinput: RefundInput,\n\topts?: ServerTrackOptions\n): Promise<void> => recordRevenue(payload, { ...input, value: -Math.abs(input.value) }, opts)\n"],"mappings":";;;;;;AAyDA,MAAM,gBAAgB,OACrB,SACA,OACA,SACmB;CACnB,MAAM,iBACL,SACA;EACC,MAAM;EACN,MAAM,MAAM,QAAA;EACZ,MAAM,MAAM,QAAA;EACZ,UAAU,MAAM,YAAY,IAAI,IAAI,QAAQ,OAAO,aAAa,kBAAkB,EAAE;EACpF,OAAO,MAAM;EACb,SAAS;EACT,SAAS,MAAM;EACf,GAAI,MAAM,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,MAAM,SAAS;EACnE,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;EACrD,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC5C,GAAI,MAAM,OAAO,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;EACzC,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC5C,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC1D,GAAI,MAAM,YAAY,EAAE,KAAK,MAAM,UAAU,IAAI,CAAC;CACnD,GACA,IACD;AACD;;;;;AAMA,MAAa,YACZ,SACA,OACA,SACmB,cAAc,SAAS,OAAO,IAAI;;;;;AAMtD,MAAa,UACZ,SACA,OACA,SACmB,cAAc,SAAS;CAAE,GAAG;CAAO,OAAO,CAAC,KAAK,IAAI,MAAM,KAAK;AAAE,GAAG,IAAI"}
@@ -1,12 +1,11 @@
1
+ import { GOAL_ACTION_TYPE } from "./constants.js";
2
+ import { ServerTrackIdentity } from "../core/serverEvent.js";
1
3
  import { Field, Payload, PayloadRequest } from "payload";
2
4
 
3
5
  //#region src/goals/trackGoalAction.d.ts
4
- /** The action type form-builder stores as the block slug on a form's `actions` array. */
5
- declare const GOAL_ACTION_TYPE = "analyticsGoal";
6
6
  /**
7
- * The run context form-builder hands a post-submit action, narrowed to what goal tracking
8
- * reads. A structural subset rather than an import: analytics never depends on form-builder
9
- * at runtime, so an install without it still resolves this module.
7
+ * Form-builder's post-submit run context as goal tracking reads it, structural so analytics never
8
+ * depends on form-builder at runtime.
10
9
  */
11
10
  interface GoalActionRunArgs {
12
11
  form: {
@@ -39,38 +38,38 @@ interface GoalActionDefinition {
39
38
  }
40
39
  interface TrackGoalActionOptions {
41
40
  /**
42
- * Site the completion belongs to. Falls back to the submitting request's host as the
43
- * native adapter's `hostname` policy judges it, then to the host of `serverURL`. With none
44
- * of the three the completion is not recorded at all, and one warning names the install.
45
- * Set it whenever a jobs runner queues actions: the runner's request carries the CMS host
46
- * at best, and often no host at all.
41
+ * Site the completion belongs to; falls back to the submitting host (per the hostname policy), then
42
+ * `serverURL`, else nothing is recorded. Set it whenever a jobs runner queues actions.
47
43
  */
48
44
  hostname?: string | ((args: GoalActionRunArgs) => string);
49
45
  /** Page the completion is attributed to. Defaults to `/forms/<form id>`. */
50
46
  path?: string | ((args: GoalActionRunArgs) => string);
51
47
  /**
52
- * Analytics boundary to stamp; `null` is install-wide. Leave unset and the scope resolves
53
- * from the action's request, which on a queued dispatch is the runner's rather than the
54
- * submitter's and so usually lands install-wide. Set it on any scoped install whose
55
- * actions are queued, since the submitter's tenant cannot be recovered there.
48
+ * Analytics boundary to stamp, `null` install-wide. Unset, it resolves from the action's request, so
49
+ * set it on any scoped install whose actions are queued.
56
50
  */
57
51
  scope?: string | null | ((args: GoalActionRunArgs) => string | null | Promise<string | null>);
52
+ /**
53
+ * `'none'` records no visitor id, location, device or language; a function decides per submission
54
+ * from the host's consent. Defaults as `trackServerEvent`'s `identity`.
55
+ */
56
+ identity?: ServerTrackIdentity | ((args: GoalActionRunArgs) => ServerTrackIdentity | Promise<ServerTrackIdentity>);
57
+ /**
58
+ * Whether the action offers amount inputs. Set it to match your `revenue` option: form-builder often
59
+ * registers its blocks too late for the plugin to hide them.
60
+ */
61
+ revenue?: boolean;
62
+ /**
63
+ * Currency the Amount control fills in for an amount set without one, normally your
64
+ * `revenue.currency`. Unset, the editor picks.
65
+ */
66
+ defaultCurrency?: string;
58
67
  }
59
68
  /**
60
- * A form-builder post-submit action that completes an analytics goal, authored per form in
61
- * the admin: pick the goal, optionally a revenue value (fixed, or read from a submission
62
- * field) and its currency. Register it through form-builder's `actions` option under
63
- * {@link GOAL_ACTION_TYPE}.
64
- *
65
- * Needs the native adapter, since it records through {@link trackServerEvent}. `essential`
66
- * is deliberately unset: a goal is a measurement, so a failed write is logged and the
67
- * submission still succeeds.
68
- *
69
- * On any install with a jobs runner, form-builder queues non-essential actions, and the
70
- * queued run carries the runner's request rather than the visitor's. Set `hostname` (and
71
- * `scope`, on a scoped install) there, since neither can be recovered from that request.
69
+ * A form-builder post-submit action completing an analytics goal, configured per form; needs the
70
+ * native adapter. Not essential: a failed write is logged and the submission still succeeds.
72
71
  */
73
72
  declare const trackGoalAction: (options?: TrackGoalActionOptions) => GoalActionDefinition;
74
73
  //#endregion
75
- export { GOAL_ACTION_TYPE, GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction };
74
+ export { GoalActionDefinition, GoalActionRunArgs, TrackGoalActionOptions, trackGoalAction };
76
75
  //# sourceMappingURL=trackGoalAction.d.ts.map