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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,14 +1,56 @@
1
1
  import { keys } from "../translations/keys.js";
2
- import { asTranslate } from "../translations/server.js";
2
+ import { asTranslate, labelForKey } from "../translations/server.js";
3
3
  //#region src/goals/currency.ts
4
4
  /** ISO 4217: three uppercase letters. */
5
5
  const CURRENCY_PATTERN = /^[A-Z]{3}$/;
6
6
  /**
7
- * Shared by the goals collection and the form-builder goal action so a currency authored in
8
- * either place is accepted on the same terms. Empty is allowed: the currency is optional.
7
+ * An adapter's currency option as an upper-case ISO 4217 code, undefined when blank. Anything else
8
+ * throws naming the option, so a typo never mislabels revenue.
9
9
  */
10
+ const currencyOption = (option, value) => {
11
+ const code = value?.trim().toUpperCase();
12
+ if (!code) return;
13
+ if (!CURRENCY_PATTERN.test(code)) throw new Error(`analytics: ${option} must be an ISO 4217 currency code such as "EUR", got ${JSON.stringify(value)}`);
14
+ return code;
15
+ };
16
+ /**
17
+ * The currency a read's revenue is in: the code an `eq` currency filter names, none under any other
18
+ * currency filter (several may add up), else the reporting currency.
19
+ */
20
+ const revenueCurrencyOf = (filters, reporting) => {
21
+ const named = (filters ?? []).filter((filter) => filter.dimension === "currency");
22
+ const only = named.find((filter) => filter.operator === "eq");
23
+ if (only) return CURRENCY_PATTERN.test(only.value) ? only.value : void 0;
24
+ return named.length > 0 ? void 0 : reporting;
25
+ };
26
+ /** The currency one breakdown row's revenue is in: a `currency` row's own code, else `fallback`. */
27
+ const rowCurrencyOf = (dimension, value, fallback) => dimension === "currency" && CURRENCY_PATTERN.test(value) ? value : fallback;
28
+ /** A three-letter code or nothing, for a currency that may stay empty. */
10
29
  const validateCurrency = (value, { req }) => !value || CURRENCY_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorCurrency);
30
+ /**
31
+ * A currency for an amount, on the same terms wherever an editor sets one: a three-letter code,
32
+ * required once the amount is set so no amount is stored without its money.
33
+ */
34
+ const validateCurrencyFor = (amountOf) => (value, { data, req, siblingData }) => {
35
+ if (value && !CURRENCY_PATTERN.test(value)) return asTranslate(req.t)(keys.goalErrorCurrency);
36
+ const amount = amountOf({
37
+ data,
38
+ siblingData
39
+ });
40
+ return value || typeof amount !== "number" || !Number.isFinite(amount) ? true : asTranslate(req.t)(keys.goalErrorCurrencyRequired);
41
+ };
42
+ /**
43
+ * The `currency` an Amount control edits for the amount `amountOf` reads. Hidden rather than
44
+ * disabled: Payload keeps a hidden field's value in the form and saves it.
45
+ */
46
+ const amountCurrencyField = (amountOf) => ({
47
+ name: "currency",
48
+ type: "text",
49
+ label: labelForKey(keys.goalFieldCurrency),
50
+ validate: validateCurrencyFor(amountOf),
51
+ admin: { hidden: true }
52
+ });
11
53
  //#endregion
12
- export { validateCurrency };
54
+ export { CURRENCY_PATTERN, amountCurrencyField, currencyOption, revenueCurrencyOf, rowCurrencyOf, validateCurrency };
13
55
 
14
56
  //# sourceMappingURL=currency.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"currency.js","names":[],"sources":["../../src/goals/currency.ts"],"sourcesContent":["import type { TextFieldSingleValidation } from 'payload'\nimport { keys } from '../translations/keys'\nimport { asTranslate } from '../translations/server'\n\n/** ISO 4217: three uppercase letters. */\nexport const CURRENCY_PATTERN = /^[A-Z]{3}$/\n\n/**\n * Shared by the goals collection and the form-builder goal action so a currency authored in\n * either place is accepted on the same terms. Empty is allowed: the currency is optional.\n */\nexport const validateCurrency: TextFieldSingleValidation = (value, { req }) =>\n\t!value || CURRENCY_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorCurrency)\n"],"mappings":";;;;AAKA,MAAa,mBAAmB;;;;;AAMhC,MAAa,oBAA+C,OAAO,EAAE,UACpE,CAAC,SAAS,iBAAiB,KAAK,KAAK,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,iBAAiB"}
1
+ {"version":3,"file":"currency.js","names":[],"sources":["../../src/goals/currency.ts"],"sourcesContent":["import type { TextField, TextFieldSingleValidation } from 'payload'\nimport type { AnalyticsFilter, DimensionKey } from '../core/contract'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\n\n/** ISO 4217: three uppercase letters. */\nexport const CURRENCY_PATTERN = /^[A-Z]{3}$/\n\n/**\n * An adapter's currency option as an upper-case ISO 4217 code, undefined when blank. Anything else\n * throws naming the option, so a typo never mislabels revenue.\n */\nexport const currencyOption = (option: string, value: string | undefined): string | undefined => {\n\tconst code = value?.trim().toUpperCase()\n\tif (!code) {\n\t\treturn undefined\n\t}\n\tif (!CURRENCY_PATTERN.test(code)) {\n\t\tthrow new Error(\n\t\t\t`analytics: ${option} must be an ISO 4217 currency code such as \"EUR\", got ${JSON.stringify(value)}`\n\t\t)\n\t}\n\treturn code\n}\n\n/**\n * The currency a read's revenue is in: the code an `eq` currency filter names, none under any other\n * currency filter (several may add up), else the reporting currency.\n */\nexport const revenueCurrencyOf = (\n\tfilters: readonly AnalyticsFilter[] | undefined,\n\treporting: string | undefined\n): string | undefined => {\n\tconst named = (filters ?? []).filter((filter) => filter.dimension === 'currency')\n\tconst only = named.find((filter) => filter.operator === 'eq')\n\tif (only) {\n\t\treturn CURRENCY_PATTERN.test(only.value) ? only.value : undefined\n\t}\n\treturn named.length > 0 ? undefined : reporting\n}\n\n/** The currency one breakdown row's revenue is in: a `currency` row's own code, else `fallback`. */\nexport const rowCurrencyOf = (\n\tdimension: DimensionKey | null | undefined,\n\tvalue: string,\n\tfallback: string | undefined\n): string | undefined =>\n\tdimension === 'currency' && CURRENCY_PATTERN.test(value) ? value : fallback\n\n/**\n * Converts one amount into the reporting currency at ingest, at the event's own time. `undefined`\n * means no rate: the completion counts, and its amount stays out of revenue with the original kept.\n */\nexport type CurrencyConverter = (args: {\n\tamount: number\n\tfrom: string\n\tto: string\n\tat: Date\n}) => number | undefined | Promise<number | undefined>\n\n/** A three-letter code or nothing, for a currency that may stay empty. */\nexport const validateCurrency: TextFieldSingleValidation = (value, { req }) =>\n\t!value || CURRENCY_PATTERN.test(value) ? true : asTranslate(req.t)(keys.goalErrorCurrency)\n\n/** Reads the amount a currency belongs to out of the data its validator is handed. */\nexport type AmountOf = (args: { data: unknown; siblingData: unknown }) => unknown\n\n/**\n * A currency for an amount, on the same terms wherever an editor sets one: a three-letter code,\n * required once the amount is set so no amount is stored without its money.\n */\nconst validateCurrencyFor =\n\t(amountOf: AmountOf): TextFieldSingleValidation =>\n\t(value, { data, req, siblingData }) => {\n\t\tif (value && !CURRENCY_PATTERN.test(value)) {\n\t\t\treturn asTranslate(req.t)(keys.goalErrorCurrency)\n\t\t}\n\t\tconst amount = amountOf({ data, siblingData })\n\t\treturn value || typeof amount !== 'number' || !Number.isFinite(amount)\n\t\t\t? true\n\t\t\t: asTranslate(req.t)(keys.goalErrorCurrencyRequired)\n\t}\n\n/**\n * The `currency` an Amount control edits for the amount `amountOf` reads. Hidden rather than\n * disabled: Payload keeps a hidden field's value in the form and saves it.\n */\nexport const amountCurrencyField = (amountOf: AmountOf): TextField => ({\n\tname: 'currency',\n\ttype: 'text',\n\tlabel: labelForKey(keys.goalFieldCurrency),\n\tvalidate: validateCurrencyFor(amountOf),\n\tadmin: { hidden: true },\n})\n"],"mappings":";;;;AAMA,MAAa,mBAAmB;;;;;AAMhC,MAAa,kBAAkB,QAAgB,UAAkD;CAChG,MAAM,OAAO,OAAO,KAAK,EAAE,YAAY;CACvC,IAAI,CAAC,MACJ;CAED,IAAI,CAAC,iBAAiB,KAAK,IAAI,GAC9B,MAAM,IAAI,MACT,cAAc,OAAO,wDAAwD,KAAK,UAAU,KAAK,GAClG;CAED,OAAO;AACR;;;;;AAMA,MAAa,qBACZ,SACA,cACwB;CACxB,MAAM,SAAS,WAAW,CAAC,GAAG,QAAQ,WAAW,OAAO,cAAc,UAAU;CAChF,MAAM,OAAO,MAAM,MAAM,WAAW,OAAO,aAAa,IAAI;CAC5D,IAAI,MACH,OAAO,iBAAiB,KAAK,KAAK,KAAK,IAAI,KAAK,QAAQ,KAAA;CAEzD,OAAO,MAAM,SAAS,IAAI,KAAA,IAAY;AACvC;;AAGA,MAAa,iBACZ,WACA,OACA,aAEA,cAAc,cAAc,iBAAiB,KAAK,KAAK,IAAI,QAAQ;;AAcpE,MAAa,oBAA+C,OAAO,EAAE,UACpE,CAAC,SAAS,iBAAiB,KAAK,KAAK,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,iBAAiB;;;;;AAS1F,MAAM,uBACJ,cACA,OAAO,EAAE,MAAM,KAAK,kBAAkB;CACtC,IAAI,SAAS,CAAC,iBAAiB,KAAK,KAAK,GACxC,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,iBAAiB;CAEjD,MAAM,SAAS,SAAS;EAAE;EAAM;CAAY,CAAC;CAC7C,OAAO,SAAS,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,IAClE,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,yBAAyB;AACrD;;;;;AAMD,MAAa,uBAAuB,cAAmC;CACtE,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,iBAAiB;CACzC,UAAU,oBAAoB,QAAQ;CACtC,OAAO,EAAE,QAAQ,KAAK;AACvB"}
@@ -0,0 +1,70 @@
1
+ import { collator, displayNames } from "../translations/intl.js";
2
+ //#region src/goals/currencyOptions.ts
3
+ /** ISO 4217 codes the currency picker offers: the ones most websites sell in. */
4
+ const CURRENCY_CODES = [
5
+ "AED",
6
+ "AUD",
7
+ "BRL",
8
+ "CAD",
9
+ "CHF",
10
+ "CNY",
11
+ "CZK",
12
+ "DKK",
13
+ "EGP",
14
+ "EUR",
15
+ "GBP",
16
+ "HKD",
17
+ "HUF",
18
+ "IDR",
19
+ "ILS",
20
+ "INR",
21
+ "JPY",
22
+ "KRW",
23
+ "MXN",
24
+ "MYR",
25
+ "NOK",
26
+ "NZD",
27
+ "PLN",
28
+ "RON",
29
+ "RUB",
30
+ "SAR",
31
+ "SEK",
32
+ "SGD",
33
+ "THB",
34
+ "TRY",
35
+ "UAH",
36
+ "USD",
37
+ "ZAR"
38
+ ];
39
+ const currencyNames = (locale) => displayNames(locale, { type: "currency" }) ?? void 0;
40
+ /** `Intl.DisplayNames` throws for a stored value that is no code at all; it has no name. */
41
+ const nameOf = (code, names) => {
42
+ try {
43
+ return names?.of(code);
44
+ } catch {
45
+ return;
46
+ }
47
+ };
48
+ /** The currency's name and its code, "Euro (EUR)"; just the code where no name is known. */
49
+ const labelOf = (code, names) => {
50
+ const name = nameOf(code, names);
51
+ return name && name !== code ? `${name} (${code})` : code;
52
+ };
53
+ /**
54
+ * The picker's options in the admin's language, sorted by name. Codes in `include` are always
55
+ * offered, so a value saved outside the list still shows as picked.
56
+ */
57
+ const currencyOptions = (locale, include = []) => {
58
+ const names = currencyNames(locale);
59
+ const codes = new Set(CURRENCY_CODES);
60
+ for (const code of include) if (code) codes.add(code);
61
+ const { compare } = collator(locale);
62
+ return [...codes].map((code) => ({
63
+ label: labelOf(code, names),
64
+ value: code
65
+ })).sort((a, b) => compare(a.label, b.label));
66
+ };
67
+ //#endregion
68
+ export { currencyOptions };
69
+
70
+ //# sourceMappingURL=currencyOptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"currencyOptions.js","names":[],"sources":["../../src/goals/currencyOptions.ts"],"sourcesContent":["import { collator, displayNames } from '../translations/intl'\n\n/** ISO 4217 codes the currency picker offers: the ones most websites sell in. */\nexport const CURRENCY_CODES: readonly string[] = [\n\t'AED',\n\t'AUD',\n\t'BRL',\n\t'CAD',\n\t'CHF',\n\t'CNY',\n\t'CZK',\n\t'DKK',\n\t'EGP',\n\t'EUR',\n\t'GBP',\n\t'HKD',\n\t'HUF',\n\t'IDR',\n\t'ILS',\n\t'INR',\n\t'JPY',\n\t'KRW',\n\t'MXN',\n\t'MYR',\n\t'NOK',\n\t'NZD',\n\t'PLN',\n\t'RON',\n\t'RUB',\n\t'SAR',\n\t'SEK',\n\t'SGD',\n\t'THB',\n\t'TRY',\n\t'UAH',\n\t'USD',\n\t'ZAR',\n]\n\nexport interface CurrencyOption {\n\tlabel: string\n\tvalue: string\n}\n\nconst currencyNames = (locale: string): Intl.DisplayNames | undefined =>\n\tdisplayNames(locale, { type: 'currency' }) ?? undefined\n\n/** `Intl.DisplayNames` throws for a stored value that is no code at all; it has no name. */\nconst nameOf = (code: string, names: Intl.DisplayNames | undefined): string | undefined => {\n\ttry {\n\t\treturn names?.of(code)\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/** The currency's name and its code, \"Euro (EUR)\"; just the code where no name is known. */\nconst labelOf = (code: string, names: Intl.DisplayNames | undefined): string => {\n\tconst name = nameOf(code, names)\n\treturn name && name !== code ? `${name} (${code})` : code\n}\n\n/**\n * The picker's options in the admin's language, sorted by name. Codes in `include` are always\n * offered, so a value saved outside the list still shows as picked.\n */\nexport const currencyOptions = (\n\tlocale: string,\n\tinclude: ReadonlyArray<string | undefined> = []\n): CurrencyOption[] => {\n\tconst names = currencyNames(locale)\n\tconst codes = new Set(CURRENCY_CODES)\n\tfor (const code of include) {\n\t\tif (code) {\n\t\t\tcodes.add(code)\n\t\t}\n\t}\n\tconst { compare } = collator(locale)\n\treturn [...codes]\n\t\t.map((code) => ({ label: labelOf(code, names), value: code }))\n\t\t.sort((a, b) => compare(a.label, b.label))\n}\n"],"mappings":";;;AAGA,MAAa,iBAAoC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AAOA,MAAM,iBAAiB,WACtB,aAAa,QAAQ,EAAE,MAAM,WAAW,CAAC,KAAK,KAAA;;AAG/C,MAAM,UAAU,MAAc,UAA6D;CAC1F,IAAI;EACH,OAAO,OAAO,GAAG,IAAI;CACtB,QAAQ;EACP;CACD;AACD;;AAGA,MAAM,WAAW,MAAc,UAAiD;CAC/E,MAAM,OAAO,OAAO,MAAM,KAAK;CAC/B,OAAO,QAAQ,SAAS,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK;AACtD;;;;;AAMA,MAAa,mBACZ,QACA,UAA6C,CAAC,MACxB;CACtB,MAAM,QAAQ,cAAc,MAAM;CAClC,MAAM,QAAQ,IAAI,IAAI,cAAc;CACpC,KAAK,MAAM,QAAQ,SAClB,IAAI,MACH,MAAM,IAAI,IAAI;CAGhB,MAAM,EAAE,YAAY,SAAS,MAAM;CACnC,OAAO,CAAC,GAAG,KAAK,EACd,KAAK,UAAU;EAAE,OAAO,QAAQ,MAAM,KAAK;EAAG,OAAO;CAAK,EAAE,EAC5D,MAAM,GAAG,MAAM,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC;AAC3C"}
@@ -1,11 +1,21 @@
1
1
  import { GoalSource } from "./resolver.js";
2
2
 
3
3
  //#region src/goals/fetchGoals.d.ts
4
+ /**
5
+ * One goal as the goals endpoint lists it.
6
+ *
7
+ * @beta
8
+ */
4
9
  interface WireGoal {
5
10
  slug: string;
6
11
  name: string;
7
12
  source: GoalSource;
8
13
  }
14
+ /**
15
+ * The goals endpoint's answer.
16
+ *
17
+ * @beta
18
+ */
9
19
  interface GoalsResponse {
10
20
  goals: WireGoal[];
11
21
  /** The goals collection, when the install enabled it, so a picker can link to it. */
@@ -1,28 +1,18 @@
1
- import { GOALS_PATH } from "../plugin/paths.js";
1
+ import { isRecord } from "../core/values.js";
2
+ import { createSharedCache } from "../ui/data/sharedCache.js";
3
+ import { requestShaped } from "../ui/data/request.js";
2
4
  //#region src/goals/fetchGoals.ts
3
- const cache = /* @__PURE__ */ new Map();
5
+ const isWireGoal = (value) => isRecord(value) && typeof value.slug === "string" && typeof value.name === "string" && (value.source === "config" || value.source === "collection" || value.source === "builtin");
6
+ const isGoalsResponse = (value) => isRecord(value) && Array.isArray(value.goals) && value.goals.every(isWireGoal) && (value.collection === null || isRecord(value.collection) && typeof value.collection.slug === "string");
7
+ const cache = createSharedCache();
4
8
  /**
5
- * Fetch the caller-scope goal list once per user per admin session and share it between
6
- * every picker on the page (a document can carry several goal fields). A failed fetch
7
- * clears its cache entry so a later mount retries instead of pinning the error, and the
8
- * user id in the key keeps a soft-navigation logout/login from serving the previous
9
- * user's goals.
9
+ * The goal list at `url` for one request scope, read once and shared by every picker on the page. A
10
+ * refusal or malformed answer rejects and drops the entry, so a later mount retries.
10
11
  */
11
- const fetchGoals = (serverURL, apiRoute, userKey) => {
12
- const url = `${serverURL}${apiRoute}${GOALS_PATH}`;
13
- const key = `${userKey}:${url}`;
14
- const hit = cache.get(key);
15
- if (hit) return hit;
16
- const pending = fetch(url, { credentials: "include" }).then((res) => {
17
- if (!res.ok) throw new Error(`goals ${res.status}`);
18
- return res.json();
19
- }).catch((err) => {
20
- cache.delete(key);
21
- throw err;
22
- });
23
- cache.set(key, pending);
24
- return pending;
25
- };
12
+ const fetchGoals = (url, scope) => cache.read({
13
+ route: url,
14
+ scope
15
+ }, () => requestShaped(url, isGoalsResponse));
26
16
  //#endregion
27
17
  export { fetchGoals };
28
18
 
@@ -1 +1 @@
1
- {"version":3,"file":"fetchGoals.js","names":[],"sources":["../../src/goals/fetchGoals.ts"],"sourcesContent":["import { GOALS_PATH } from '../plugin/paths'\nimport type { GoalSource } from './resolver'\n\nexport interface WireGoal {\n\tslug: string\n\tname: string\n\tsource: GoalSource\n}\n\nexport interface GoalsResponse {\n\tgoals: WireGoal[]\n\t/** The goals collection, when the install enabled it, so a picker can link to it. */\n\tcollection: { slug: string } | null\n}\n\nconst cache = new Map<string, Promise<GoalsResponse>>()\n\n/**\n * Fetch the caller-scope goal list once per user per admin session and share it between\n * every picker on the page (a document can carry several goal fields). A failed fetch\n * clears its cache entry so a later mount retries instead of pinning the error, and the\n * user id in the key keeps a soft-navigation logout/login from serving the previous\n * user's goals.\n */\nexport const fetchGoals = (\n\tserverURL: string,\n\tapiRoute: string,\n\tuserKey: string\n): Promise<GoalsResponse> => {\n\tconst url = `${serverURL}${apiRoute}${GOALS_PATH}`\n\tconst key = `${userKey}:${url}`\n\tconst hit = cache.get(key)\n\tif (hit) return hit\n\tconst pending = fetch(url, { credentials: 'include' })\n\t\t.then((res) => {\n\t\t\tif (!res.ok) throw new Error(`goals ${res.status}`)\n\t\t\treturn res.json() as Promise<GoalsResponse>\n\t\t})\n\t\t.catch((err) => {\n\t\t\tcache.delete(key)\n\t\t\tthrow err\n\t\t})\n\tcache.set(key, pending)\n\treturn pending\n}\n"],"mappings":";;AAeA,MAAM,wBAAQ,IAAI,IAAoC;;;;;;;;AAStD,MAAa,cACZ,WACA,UACA,YAC4B;CAC5B,MAAM,MAAM,GAAG,YAAY,WAAW;CACtC,MAAM,MAAM,GAAG,QAAQ,GAAG;CAC1B,MAAM,MAAM,MAAM,IAAI,GAAG;CACzB,IAAI,KAAK,OAAO;CAChB,MAAM,UAAU,MAAM,KAAK,EAAE,aAAa,UAAU,CAAC,EACnD,MAAM,QAAQ;EACd,IAAI,CAAC,IAAI,IAAI,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ;EAClD,OAAO,IAAI,KAAK;CACjB,CAAC,EACA,OAAO,QAAQ;EACf,MAAM,OAAO,GAAG;EAChB,MAAM;CACP,CAAC;CACF,MAAM,IAAI,KAAK,OAAO;CACtB,OAAO;AACR"}
1
+ {"version":3,"file":"fetchGoals.js","names":[],"sources":["../../src/goals/fetchGoals.ts"],"sourcesContent":["import { isRecord } from '../core/values'\nimport { requestShaped } from '../ui/data/request'\nimport { createSharedCache } from '../ui/data/sharedCache'\nimport type { GoalSource } from './resolver'\n\n/**\n * One goal as the goals endpoint lists it.\n *\n * @beta\n */\nexport interface WireGoal {\n\tslug: string\n\tname: string\n\tsource: GoalSource\n}\n\n/**\n * The goals endpoint's answer.\n *\n * @beta\n */\nexport interface GoalsResponse {\n\tgoals: WireGoal[]\n\t/** The goals collection, when the install enabled it, so a picker can link to it. */\n\tcollection: { slug: string } | null\n}\n\nconst isWireGoal = (value: unknown): value is WireGoal =>\n\tisRecord(value) &&\n\ttypeof value.slug === 'string' &&\n\ttypeof value.name === 'string' &&\n\t(value.source === 'config' || value.source === 'collection' || value.source === 'builtin')\n\nconst isGoalsResponse = (value: unknown): value is GoalsResponse =>\n\tisRecord(value) &&\n\tArray.isArray(value.goals) &&\n\tvalue.goals.every(isWireGoal) &&\n\t(value.collection === null ||\n\t\t(isRecord(value.collection) && typeof value.collection.slug === 'string'))\n\nconst cache = createSharedCache<GoalsResponse>()\n\n/**\n * The goal list at `url` for one request scope, read once and shared by every picker on the page. A\n * refusal or malformed answer rejects and drops the entry, so a later mount retries.\n */\nexport const fetchGoals = (url: string, scope: string): Promise<GoalsResponse> =>\n\tcache.read({ route: url, scope }, () => requestShaped(url, isGoalsResponse))\n"],"mappings":";;;;AA2BA,MAAM,cAAc,UACnB,SAAS,KAAK,KACd,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,SAAS,aACrB,MAAM,WAAW,YAAY,MAAM,WAAW,gBAAgB,MAAM,WAAW;AAEjF,MAAM,mBAAmB,UACxB,SAAS,KAAK,KACd,MAAM,QAAQ,MAAM,KAAK,KACzB,MAAM,MAAM,MAAM,UAAU,MAC3B,MAAM,eAAe,QACpB,SAAS,MAAM,UAAU,KAAK,OAAO,MAAM,WAAW,SAAS;AAElE,MAAM,QAAQ,kBAAiC;;;;;AAM/C,MAAa,cAAc,KAAa,UACvC,MAAM,KAAK;CAAE,OAAO;CAAK;AAAM,SAAS,cAAc,KAAK,eAAe,CAAC"}
@@ -15,15 +15,13 @@ interface GoalFieldOptions {
15
15
  }) => TextField;
16
16
  }
17
17
  /**
18
- * A goal picker for any collection or global: a text field storing the goal slug, rendered
19
- * by the client picker that lists the config goals merged with the goals collection for the
20
- * requesting scope. Pair it with {@link goalSlug} wherever the stored value is read back.
18
+ * A goal picker for any collection or global, storing the slug of a goal visible to the requesting
19
+ * scope. Read the stored value back with {@link goalSlug}.
21
20
  */
22
21
  declare const goalField: (options?: GoalFieldOptions) => TextField;
23
22
  /**
24
- * The slug out of a stored goal value, for renderers that read a {@link goalField} back.
25
- * Accepts the stored string and the `{ slug }` shape a populated document carries; anything
26
- * else is not a goal reference and resolves to null rather than a guess.
23
+ * The slug from a stored {@link goalField} value, string or populated `{ slug }`; anything else is
24
+ * null rather than a guess.
27
25
  */
28
26
  declare const goalSlug: (value: unknown) => string | null;
29
27
  //#endregion
@@ -1,18 +1,18 @@
1
+ import { isRecord } from "../core/values.js";
1
2
  import { keys } from "../translations/keys.js";
2
3
  import { asTranslate, labelForKey } from "../translations/server.js";
3
4
  import { GOAL_SLUG_PATTERN } from "./types.js";
4
5
  //#region src/goals/goalField.ts
5
6
  /** importMap path of the picker; the factory never imports the component itself. */
6
- const GOAL_FIELD_COMPONENT = "@10x-media/analytics/client#GoalSelectField";
7
+ const GOAL_FIELD_COMPONENT = "@10x-media/analytics/rsc#GoalSelectFieldServer";
7
8
  const makeValidate = (required) => (value, { req }) => {
8
9
  const slug = typeof value === "string" ? value.trim() : "";
9
10
  if (slug === "") return required ? req.t("validation:required") : true;
10
11
  return GOAL_SLUG_PATTERN.test(slug) ? true : asTranslate(req.t)(keys.fieldGoalInvalid);
11
12
  };
12
13
  /**
13
- * A goal picker for any collection or global: a text field storing the goal slug, rendered
14
- * by the client picker that lists the config goals merged with the goals collection for the
15
- * requesting scope. Pair it with {@link goalSlug} wherever the stored value is read back.
14
+ * A goal picker for any collection or global, storing the slug of a goal visible to the requesting
15
+ * scope. Read the stored value back with {@link goalSlug}.
16
16
  */
17
17
  const goalField = (options = {}) => {
18
18
  const field = {
@@ -32,23 +32,13 @@ const goalField = (options = {}) => {
32
32
  return options.overrides ? options.overrides({ field }) : field;
33
33
  };
34
34
  /**
35
- * The slug out of a stored goal value, for renderers that read a {@link goalField} back.
36
- * Accepts the stored string and the `{ slug }` shape a populated document carries; anything
37
- * else is not a goal reference and resolves to null rather than a guess.
35
+ * The slug from a stored {@link goalField} value, string or populated `{ slug }`; anything else is
36
+ * null rather than a guess.
38
37
  */
39
38
  const goalSlug = (value) => {
40
- if (typeof value === "string") {
41
- const slug = value.trim();
42
- return slug === "" ? null : slug;
43
- }
44
- if (value && typeof value === "object" && !Array.isArray(value)) {
45
- const { slug } = value;
46
- if (typeof slug === "string") {
47
- const trimmed = slug.trim();
48
- return trimmed === "" ? null : trimmed;
49
- }
50
- }
51
- return null;
39
+ const raw = isRecord(value) && !Array.isArray(value) ? value.slug : value;
40
+ const slug = typeof raw === "string" ? raw.trim() : "";
41
+ return slug === "" ? null : slug;
52
42
  };
53
43
  //#endregion
54
44
  export { goalField, goalSlug };
@@ -1 +1 @@
1
- {"version":3,"file":"goalField.js","names":[],"sources":["../../src/goals/goalField.ts"],"sourcesContent":["import type { LabelFunction, StaticLabel, TextField, TextFieldSingleValidation } from 'payload'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport { GOAL_SLUG_PATTERN } from './types'\n\n/** importMap path of the picker; the factory never imports the component itself. */\nexport const GOAL_FIELD_COMPONENT = '@10x-media/analytics/client#GoalSelectField'\n\nexport interface GoalFieldOptions {\n\t/** Field name, and therefore the property the slug is stored under. Default `'goal'`. */\n\tname?: string\n\t/** Default: the translated \"Goal\". */\n\tlabel?: LabelFunction | StaticLabel\n\trequired?: boolean\n\t/** Merged over the factory's own admin config; the Field component is not replaceable here. */\n\tadmin?: TextField['admin']\n\t/** Last word on the built field. Spread the field, never deep-merge it. */\n\toverrides?: (args: { field: TextField }) => TextField\n}\n\nconst makeValidate =\n\t(required: boolean): TextFieldSingleValidation =>\n\t(value, { req }) => {\n\t\tconst slug = typeof value === 'string' ? value.trim() : ''\n\t\tif (slug === '') {\n\t\t\treturn required ? req.t('validation:required') : true\n\t\t}\n\t\treturn GOAL_SLUG_PATTERN.test(slug) ? true : asTranslate(req.t)(keys.fieldGoalInvalid)\n\t}\n\n/**\n * A goal picker for any collection or global: a text field storing the goal slug, rendered\n * by the client picker that lists the config goals merged with the goals collection for the\n * requesting scope. Pair it with {@link goalSlug} wherever the stored value is read back.\n */\nexport const goalField = (options: GoalFieldOptions = {}): TextField => {\n\tconst field: TextField = {\n\t\tname: options.name ?? 'goal',\n\t\ttype: 'text',\n\t\tlabel: options.label ?? labelForKey(keys.fieldGoalLabel),\n\t\t...(options.required ? { required: true } : {}),\n\t\tvalidate: makeValidate(Boolean(options.required)),\n\t\tadmin: {\n\t\t\t...options.admin,\n\t\t\tcomponents: {\n\t\t\t\t...options.admin?.components,\n\t\t\t\tField: { path: GOAL_FIELD_COMPONENT },\n\t\t\t},\n\t\t},\n\t}\n\treturn options.overrides ? options.overrides({ field }) : field\n}\n\n/**\n * The slug out of a stored goal value, for renderers that read a {@link goalField} back.\n * Accepts the stored string and the `{ slug }` shape a populated document carries; anything\n * else is not a goal reference and resolves to null rather than a guess.\n */\nexport const goalSlug = (value: unknown): string | null => {\n\tif (typeof value === 'string') {\n\t\tconst slug = value.trim()\n\t\treturn slug === '' ? null : slug\n\t}\n\tif (value && typeof value === 'object' && !Array.isArray(value)) {\n\t\tconst { slug } = value as { slug?: unknown }\n\t\tif (typeof slug === 'string') {\n\t\t\tconst trimmed = slug.trim()\n\t\t\treturn trimmed === '' ? null : trimmed\n\t\t}\n\t}\n\treturn null\n}\n"],"mappings":";;;;;AAMA,MAAa,uBAAuB;AAcpC,MAAM,gBACJ,cACA,OAAO,EAAE,UAAU;CACnB,MAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CACxD,IAAI,SAAS,IACZ,OAAO,WAAW,IAAI,EAAE,qBAAqB,IAAI;CAElD,OAAO,kBAAkB,KAAK,IAAI,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,gBAAgB;AACtF;;;;;;AAOD,MAAa,aAAa,UAA4B,CAAC,MAAiB;CACvE,MAAM,QAAmB;EACxB,MAAM,QAAQ,QAAQ;EACtB,MAAM;EACN,OAAO,QAAQ,SAAS,YAAY,KAAK,cAAc;EACvD,GAAI,QAAQ,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC;EAC7C,UAAU,aAAa,QAAQ,QAAQ,QAAQ,CAAC;EAChD,OAAO;GACN,GAAG,QAAQ;GACX,YAAY;IACX,GAAG,QAAQ,OAAO;IAClB,OAAO,EAAE,MAAM,qBAAqB;GACrC;EACD;CACD;CACA,OAAO,QAAQ,YAAY,QAAQ,UAAU,EAAE,MAAM,CAAC,IAAI;AAC3D;;;;;;AAOA,MAAa,YAAY,UAAkC;CAC1D,IAAI,OAAO,UAAU,UAAU;EAC9B,MAAM,OAAO,MAAM,KAAK;EACxB,OAAO,SAAS,KAAK,OAAO;CAC7B;CACA,IAAI,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;EAChE,MAAM,EAAE,SAAS;EACjB,IAAI,OAAO,SAAS,UAAU;GAC7B,MAAM,UAAU,KAAK,KAAK;GAC1B,OAAO,YAAY,KAAK,OAAO;EAChC;CACD;CACA,OAAO;AACR"}
1
+ {"version":3,"file":"goalField.js","names":[],"sources":["../../src/goals/goalField.ts"],"sourcesContent":["import type { LabelFunction, StaticLabel, TextField, TextFieldSingleValidation } from 'payload'\nimport { isRecord } from '../core/values'\nimport { keys } from '../translations/keys'\nimport { asTranslate, labelForKey } from '../translations/server'\nimport { GOAL_SLUG_PATTERN } from './types'\n\n/** importMap path of the picker; the factory never imports the component itself. */\nexport const GOAL_FIELD_COMPONENT = '@10x-media/analytics/rsc#GoalSelectFieldServer'\n\nexport interface GoalFieldOptions {\n\t/** Field name, and therefore the property the slug is stored under. Default `'goal'`. */\n\tname?: string\n\t/** Default: the translated \"Goal\". */\n\tlabel?: LabelFunction | StaticLabel\n\trequired?: boolean\n\t/** Merged over the factory's own admin config; the Field component is not replaceable here. */\n\tadmin?: TextField['admin']\n\t/** Last word on the built field. Spread the field, never deep-merge it. */\n\toverrides?: (args: { field: TextField }) => TextField\n}\n\nconst makeValidate =\n\t(required: boolean): TextFieldSingleValidation =>\n\t(value, { req }) => {\n\t\tconst slug = typeof value === 'string' ? value.trim() : ''\n\t\tif (slug === '') {\n\t\t\treturn required ? req.t('validation:required') : true\n\t\t}\n\t\treturn GOAL_SLUG_PATTERN.test(slug) ? true : asTranslate(req.t)(keys.fieldGoalInvalid)\n\t}\n\n/**\n * A goal picker for any collection or global, storing the slug of a goal visible to the requesting\n * scope. Read the stored value back with {@link goalSlug}.\n */\nexport const goalField = (options: GoalFieldOptions = {}): TextField => {\n\tconst field: TextField = {\n\t\tname: options.name ?? 'goal',\n\t\ttype: 'text',\n\t\tlabel: options.label ?? labelForKey(keys.fieldGoalLabel),\n\t\t...(options.required ? { required: true } : {}),\n\t\tvalidate: makeValidate(Boolean(options.required)),\n\t\tadmin: {\n\t\t\t...options.admin,\n\t\t\tcomponents: {\n\t\t\t\t...options.admin?.components,\n\t\t\t\tField: { path: GOAL_FIELD_COMPONENT },\n\t\t\t},\n\t\t},\n\t}\n\treturn options.overrides ? options.overrides({ field }) : field\n}\n\n/**\n * The slug from a stored {@link goalField} value, string or populated `{ slug }`; anything else is\n * null rather than a guess.\n */\nexport const goalSlug = (value: unknown): string | null => {\n\tconst raw = isRecord(value) && !Array.isArray(value) ? value.slug : value\n\tconst slug = typeof raw === 'string' ? raw.trim() : ''\n\treturn slug === '' ? null : slug\n}\n"],"mappings":";;;;;;AAOA,MAAa,uBAAuB;AAcpC,MAAM,gBACJ,cACA,OAAO,EAAE,UAAU;CACnB,MAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;CACxD,IAAI,SAAS,IACZ,OAAO,WAAW,IAAI,EAAE,qBAAqB,IAAI;CAElD,OAAO,kBAAkB,KAAK,IAAI,IAAI,OAAO,YAAY,IAAI,CAAC,EAAE,KAAK,gBAAgB;AACtF;;;;;AAMD,MAAa,aAAa,UAA4B,CAAC,MAAiB;CACvE,MAAM,QAAmB;EACxB,MAAM,QAAQ,QAAQ;EACtB,MAAM;EACN,OAAO,QAAQ,SAAS,YAAY,KAAK,cAAc;EACvD,GAAI,QAAQ,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC;EAC7C,UAAU,aAAa,QAAQ,QAAQ,QAAQ,CAAC;EAChD,OAAO;GACN,GAAG,QAAQ;GACX,YAAY;IACX,GAAG,QAAQ,OAAO;IAClB,OAAO,EAAE,MAAM,qBAAqB;GACrC;EACD;CACD;CACA,OAAO,QAAQ,YAAY,QAAQ,UAAU,EAAE,MAAM,CAAC,IAAI;AAC3D;;;;;AAMA,MAAa,YAAY,UAAkC;CAC1D,MAAM,MAAM,SAAS,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO;CACpE,MAAM,OAAO,OAAO,QAAQ,WAAW,IAAI,KAAK,IAAI;CACpD,OAAO,SAAS,KAAK,OAAO;AAC7B"}
@@ -1,52 +1,54 @@
1
- import "../plugin/paths.js";
2
- import { getRuntime, platformReadFor, readAccessFor, resolveGoalsDetailedFor, resolveScopeFor } from "../plugin/runtime.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import "../core/contract.js";
3
+ import { getRuntime, resolveGoalsDetailedFor } from "../plugin/runtime.js";
4
+ import { resolveRequestedScope } from "../core/scopedRead.js";
5
+ import { NO_STORE, analyticsError, errorResponse } from "../plugin/errors.js";
3
6
  //#region src/goals/goalsEndpoint.ts
7
+ const wireGoal = ({ goal, source }) => ({
8
+ slug: goal.slug,
9
+ name: goal.name,
10
+ source
11
+ });
12
+ const listing = (goals, collection) => Response.json({
13
+ goals,
14
+ collection
15
+ }, { headers: NO_STORE });
4
16
  /**
5
- * Authenticated GET listing the goals visible to the requesting scope, gated by
6
- * `access.read` like every other read endpoint: the config goals
7
- * merged with the goals collection, each tagged with where it came from. Scope gating
8
- * mirrors the sources endpoint exactly, because the reasoning is the same: there is no
9
- * scope parameter, so a tenant can never enumerate another tenant's goals; on a scoped
10
- * install a request that resolves no scope is ambiguous rather than install-wide and
11
- * answers empty unless `platformRead` grants it; and a failed resolution on a scoped
12
- * install is indistinguishable from a forged one, so it answers empty too, while an
13
- * unscoped install falls back to the static config goals.
17
+ * Authenticated GET listing the requested scope's goals, gated by `access.read`, never cached. There
18
+ * is no scope parameter, so no tenant can enumerate another's goals by naming one.
14
19
  */
15
20
  const makeGoalsHandler = () => async (req) => {
16
- if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
21
+ if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
17
22
  const runtime = getRuntime(req.payload);
18
- if (!runtime) return Response.json({
19
- goals: [],
20
- collection: null
21
- });
22
- if (!await readAccessFor(runtime, req)) return Response.json({ error: "forbidden" }, { status: 403 });
23
+ if (!runtime) return listing([], null);
24
+ let allowed;
25
+ try {
26
+ allowed = await readGate(runtime, req);
27
+ } catch (err) {
28
+ req.payload.logger?.error(`analytics: goals read access check failed: ${String(err)}`);
29
+ return errorResponse(500, analyticsError("internal", "analytics: goals listing failed"));
30
+ }
31
+ if (!allowed) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
23
32
  const collection = runtime.goalsCollectionSlug ? { slug: runtime.goalsCollectionSlug } : null;
24
- const configGoals = () => (runtime.goals ?? []).map((goal) => ({
25
- slug: goal.slug,
26
- name: goal.name,
33
+ const includeBuiltin = new URL(req.url ?? "", "http://localhost").searchParams.get("include") === "builtin";
34
+ const degraded = () => listing(runtime.scoped ? [] : (runtime.goals ?? []).map((goal) => wireGoal({
35
+ goal,
27
36
  source: "config"
28
- }));
37
+ })), collection);
29
38
  try {
30
- const scope = await resolveScopeFor(runtime, req);
31
- if (runtime.scoped && scope === null && !await platformReadFor(runtime, req)) return Response.json({
32
- goals: [],
33
- collection
34
- });
35
- const goals = (await resolveGoalsDetailedFor(runtime, req, scope)).map(({ goal, source }) => ({
36
- slug: goal.slug,
37
- name: goal.name,
38
- source
39
- }));
40
- return Response.json({
41
- goals,
42
- collection
39
+ const requested = await resolveRequestedScope({
40
+ runtime,
41
+ req
43
42
  });
43
+ if (!requested.ok) {
44
+ if (requested.reason === "not-member") return errorResponse(400, analyticsError("untrusted_scope", "analytics: scope is not permitted for this request"));
45
+ return requested.reason === "failed" ? degraded() : listing([], collection);
46
+ }
47
+ const scope = requested.scope === "*" ? null : requested.scope;
48
+ return listing((runtime.listGoals ? await runtime.listGoals(req, scope) : await resolveGoalsDetailedFor(runtime, req, scope)).filter((entry) => includeBuiltin || entry.source !== "builtin").map(wireGoal), collection);
44
49
  } catch (err) {
45
50
  req.payload.logger?.warn(`analytics: goals listing failed: ${String(err)}`);
46
- return Response.json({
47
- goals: runtime.scoped ? [] : configGoals(),
48
- collection
49
- });
51
+ return degraded();
50
52
  }
51
53
  };
52
54
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"goalsEndpoint.js","names":[],"sources":["../../src/goals/goalsEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { GOALS_PATH } from '../plugin/paths'\nimport {\n\tgetRuntime,\n\tplatformReadFor,\n\treadAccessFor,\n\tresolveGoalsDetailedFor,\n\tresolveScopeFor,\n} from '../plugin/runtime'\nimport type { GoalsResponse, WireGoal } from './fetchGoals'\n\nexport type { GoalsResponse, WireGoal }\nexport { GOALS_PATH }\n\n/**\n * Authenticated GET listing the goals visible to the requesting scope, gated by\n * `access.read` like every other read endpoint: the config goals\n * merged with the goals collection, each tagged with where it came from. Scope gating\n * mirrors the sources endpoint exactly, because the reasoning is the same: there is no\n * scope parameter, so a tenant can never enumerate another tenant's goals; on a scoped\n * install a request that resolves no scope is ambiguous rather than install-wide and\n * answers empty unless `platformRead` grants it; and a failed resolution on a scoped\n * install is indistinguishable from a forged one, so it answers empty too, while an\n * unscoped install falls back to the static config goals.\n */\nexport const makeGoalsHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn Response.json({ goals: [], collection: null } satisfies GoalsResponse)\n\t}\n\tif (!(await readAccessFor(runtime, req))) {\n\t\treturn Response.json({ error: 'forbidden' }, { status: 403 })\n\t}\n\tconst collection = runtime.goalsCollectionSlug ? { slug: runtime.goalsCollectionSlug } : null\n\tconst configGoals = (): WireGoal[] =>\n\t\t(runtime.goals ?? []).map((goal) => ({\n\t\t\tslug: goal.slug,\n\t\t\tname: goal.name,\n\t\t\tsource: 'config' as const,\n\t\t}))\n\ttry {\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\tif (runtime.scoped && scope === null && !(await platformReadFor(runtime, req))) {\n\t\t\treturn Response.json({ goals: [], collection } satisfies GoalsResponse)\n\t\t}\n\t\tconst resolved = await resolveGoalsDetailedFor(runtime, req, scope)\n\t\tconst goals = resolved.map(({ goal, source }) => ({\n\t\t\tslug: goal.slug,\n\t\t\tname: goal.name,\n\t\t\tsource,\n\t\t}))\n\t\treturn Response.json({ goals, collection } satisfies GoalsResponse)\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: goals listing failed: ${String(err)}`)\n\t\treturn Response.json({\n\t\t\tgoals: runtime.scoped ? [] : configGoals(),\n\t\t\tcollection,\n\t\t} satisfies GoalsResponse)\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAyBA,MAAa,yBAAyC,OAAO,QAAQ;CACpE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,SAAS,KAAK;EAAE,OAAO,CAAC;EAAG,YAAY;CAAK,CAAyB;CAE7E,IAAI,CAAE,MAAM,cAAc,SAAS,GAAG,GACrC,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG,EAAE,QAAQ,IAAI,CAAC;CAE7D,MAAM,aAAa,QAAQ,sBAAsB,EAAE,MAAM,QAAQ,oBAAoB,IAAI;CACzF,MAAM,qBACJ,QAAQ,SAAS,CAAC,GAAG,KAAK,UAAU;EACpC,MAAM,KAAK;EACX,MAAM,KAAK;EACX,QAAQ;CACT,EAAE;CACH,IAAI;EACH,MAAM,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EAChD,IAAI,QAAQ,UAAU,UAAU,QAAQ,CAAE,MAAM,gBAAgB,SAAS,GAAG,GAC3E,OAAO,SAAS,KAAK;GAAE,OAAO,CAAC;GAAG;EAAW,CAAyB;EAGvE,MAAM,SAAQ,MADS,wBAAwB,SAAS,KAAK,KAAK,GAC3C,KAAK,EAAE,MAAM,cAAc;GACjD,MAAM,KAAK;GACX,MAAM,KAAK;GACX;EACD,EAAE;EACF,OAAO,SAAS,KAAK;GAAE;GAAO;EAAW,CAAyB;CACnE,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,oCAAoC,OAAO,GAAG,GAAG;EAC1E,OAAO,SAAS,KAAK;GACpB,OAAO,QAAQ,SAAS,CAAC,IAAI,YAAY;GACzC;EACD,CAAyB;CAC1B;AACD"}
1
+ {"version":3,"file":"goalsEndpoint.js","names":[],"sources":["../../src/goals/goalsEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { PLATFORM_SCOPE } from '../core/contract'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport { analyticsError, errorResponse, NO_STORE } from '../plugin/errors'\nimport { getRuntime, resolveGoalsDetailedFor } from '../plugin/runtime'\nimport type { GoalsResponse, WireGoal } from './fetchGoals'\nimport type { ResolvedGoal } from './resolver'\n\nexport type { GoalsResponse, WireGoal }\n\nconst wireGoal = ({ goal, source }: ResolvedGoal): WireGoal => ({\n\tslug: goal.slug,\n\tname: goal.name,\n\tsource,\n})\n\nconst listing = (goals: WireGoal[], collection: GoalsResponse['collection']): Response =>\n\tResponse.json({ goals, collection } satisfies GoalsResponse, { headers: NO_STORE })\n\n/**\n * Authenticated GET listing the requested scope's goals, gated by `access.read`, never cached. There\n * is no scope parameter, so no tenant can enumerate another's goals by naming one.\n */\nexport const makeGoalsHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn errorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn listing([], null)\n\t}\n\tlet allowed: boolean\n\ttry {\n\t\tallowed = await readGate(runtime, req)\n\t} catch (err) {\n\t\t// A gate that fails must not fall through to the degraded listing below, which answers 200.\n\t\treq.payload.logger?.error(`analytics: goals read access check failed: ${String(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: goals listing failed'))\n\t}\n\tif (!allowed) {\n\t\treturn errorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\t}\n\tconst collection = runtime.goalsCollectionSlug ? { slug: runtime.goalsCollectionSlug } : null\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\t// Built-in `purchase` is latent: a picker offering it would offer a goal nobody declared.\n\tconst includeBuiltin = params.get('include') === 'builtin'\n\t// A failed scoped resolution looks like a forged one, so only an unscoped install lists config goals.\n\tconst degraded = (): Response =>\n\t\tlisting(\n\t\t\truntime.scoped\n\t\t\t\t? []\n\t\t\t\t: (runtime.goals ?? []).map((goal) => wireGoal({ goal, source: 'config' })),\n\t\t\tcollection\n\t\t)\n\ttry {\n\t\tconst requested = await resolveRequestedScope({ runtime, req })\n\t\tif (!requested.ok) {\n\t\t\tif (requested.reason === 'not-member') {\n\t\t\t\treturn errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tanalyticsError('untrusted_scope', 'analytics: scope is not permitted for this request')\n\t\t\t\t)\n\t\t\t}\n\t\t\treturn requested.reason === 'failed' ? degraded() : listing([], collection)\n\t\t}\n\t\tconst scope = requested.scope === PLATFORM_SCOPE ? null : requested.scope\n\t\tconst resolved = runtime.listGoals\n\t\t\t? await runtime.listGoals(req, scope)\n\t\t\t: await resolveGoalsDetailedFor(runtime, req, scope)\n\t\treturn listing(\n\t\t\tresolved.filter((entry) => includeBuiltin || entry.source !== 'builtin').map(wireGoal),\n\t\t\tcollection\n\t\t)\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: goals listing failed: ${String(err)}`)\n\t\treturn degraded()\n\t}\n}\n"],"mappings":";;;;;;AAWA,MAAM,YAAY,EAAE,MAAM,cAAsC;CAC/D,MAAM,KAAK;CACX,MAAM,KAAK;CACX;AACD;AAEA,MAAM,WAAW,OAAmB,eACnC,SAAS,KAAK;CAAE;CAAO;AAAW,GAA2B,EAAE,SAAS,SAAS,CAAC;;;;;AAMnF,MAAa,yBAAyC,OAAO,QAAQ;CACpE,IAAI,CAAC,IAAI,MACR,OAAO,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;CAE/F,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,QAAQ,CAAC,GAAG,IAAI;CAExB,IAAI;CACJ,IAAI;EACH,UAAU,MAAM,SAAS,SAAS,GAAG;CACtC,SAAS,KAAK;EAEb,IAAI,QAAQ,QAAQ,MAAM,8CAA8C,OAAO,GAAG,GAAG;EACrF,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;CACA,IAAI,CAAC,SACJ,OAAO,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;CAEvF,MAAM,aAAa,QAAQ,sBAAsB,EAAE,MAAM,QAAQ,oBAAoB,IAAI;CAGzF,MAAM,iBAFS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE,aAE5B,IAAI,SAAS,MAAM;CAEjD,MAAM,iBACL,QACC,QAAQ,SACL,CAAC,KACA,QAAQ,SAAS,CAAC,GAAG,KAAK,SAAS,SAAS;EAAE;EAAM,QAAQ;CAAS,CAAC,CAAC,GAC3E,UACD;CACD,IAAI;EACH,MAAM,YAAY,MAAM,sBAAsB;GAAE;GAAS;EAAI,CAAC;EAC9D,IAAI,CAAC,UAAU,IAAI;GAClB,IAAI,UAAU,WAAW,cACxB,OAAO,cACN,KACA,eAAe,mBAAmB,oDAAoD,CACvF;GAED,OAAO,UAAU,WAAW,WAAW,SAAS,IAAI,QAAQ,CAAC,GAAG,UAAU;EAC3E;EACA,MAAM,QAAQ,UAAU,UAAA,MAA2B,OAAO,UAAU;EAIpE,OAAO,SAHU,QAAQ,YACtB,MAAM,QAAQ,UAAU,KAAK,KAAK,IAClC,MAAM,wBAAwB,SAAS,KAAK,KAAK,GAE1C,QAAQ,UAAU,kBAAkB,MAAM,WAAW,SAAS,EAAE,IAAI,QAAQ,GACrF,UACD;CACD,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,oCAAoC,OAAO,GAAG,GAAG;EAC1E,OAAO,SAAS;CACjB;AACD"}
@@ -0,0 +1,35 @@
1
+ import { isRecord } from "../core/values.js";
2
+ //#region src/goals/items.ts
3
+ /** Lines past this are a catalogue dump rather than an order, and props are a bounded column. */
4
+ const MAX_REVENUE_ITEMS = 20;
5
+ const MAX_ITEM_STRING = 128;
6
+ const text = (value) => typeof value === "string" && value.trim() !== "" ? value.slice(0, MAX_ITEM_STRING) : void 0;
7
+ const amount = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
8
+ /**
9
+ * A sale's lines as stored and forwarded: the first {@link MAX_REVENUE_ITEMS}, capped, malformed or
10
+ * id-less ones dropped rather than failing the sale; none left is no `items` at all.
11
+ */
12
+ const sanitizeItems = (raw) => {
13
+ if (!Array.isArray(raw)) return;
14
+ const out = [];
15
+ for (const line of raw) {
16
+ if (out.length >= MAX_REVENUE_ITEMS) break;
17
+ if (!isRecord(line) || Array.isArray(line)) continue;
18
+ const id = text(line.id);
19
+ if (id === void 0) continue;
20
+ const name = text(line.name);
21
+ const quantity = amount(line.quantity);
22
+ const price = amount(line.price);
23
+ out.push({
24
+ id,
25
+ ...name === void 0 ? {} : { name },
26
+ ...quantity === void 0 ? {} : { quantity },
27
+ ...price === void 0 ? {} : { price }
28
+ });
29
+ }
30
+ return out.length > 0 ? out : void 0;
31
+ };
32
+ //#endregion
33
+ export { sanitizeItems };
34
+
35
+ //# sourceMappingURL=items.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"items.js","names":[],"sources":["../../src/goals/items.ts"],"sourcesContent":["import { isRecord } from '../core/values'\nimport type { RevenueItem } from '../tracker/config'\n\n/** Lines past this are a catalogue dump rather than an order, and props are a bounded column. */\nconst MAX_REVENUE_ITEMS = 20\n\nconst MAX_ITEM_STRING = 128\n\nconst text = (value: unknown): string | undefined =>\n\ttypeof value === 'string' && value.trim() !== '' ? value.slice(0, MAX_ITEM_STRING) : undefined\n\nconst amount = (value: unknown): number | undefined =>\n\ttypeof value === 'number' && Number.isFinite(value) ? value : undefined\n\n/**\n * A sale's lines as stored and forwarded: the first {@link MAX_REVENUE_ITEMS}, capped, malformed or\n * id-less ones dropped rather than failing the sale; none left is no `items` at all.\n */\nexport const sanitizeItems = (raw: unknown): RevenueItem[] | undefined => {\n\tif (!Array.isArray(raw)) {\n\t\treturn undefined\n\t}\n\tconst out: RevenueItem[] = []\n\tfor (const line of raw) {\n\t\tif (out.length >= MAX_REVENUE_ITEMS) {\n\t\t\tbreak\n\t\t}\n\t\tif (!isRecord(line) || Array.isArray(line)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst id = text(line.id)\n\t\tif (id === undefined) {\n\t\t\tcontinue\n\t\t}\n\t\tconst name = text(line.name)\n\t\tconst quantity = amount(line.quantity)\n\t\tconst price = amount(line.price)\n\t\tout.push({\n\t\t\tid,\n\t\t\t...(name === undefined ? {} : { name }),\n\t\t\t...(quantity === undefined ? {} : { quantity }),\n\t\t\t...(price === undefined ? {} : { price }),\n\t\t})\n\t}\n\treturn out.length > 0 ? out : undefined\n}\n"],"mappings":";;;AAIA,MAAM,oBAAoB;AAE1B,MAAM,kBAAkB;AAExB,MAAM,QAAQ,UACb,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,MAAM,MAAM,GAAG,eAAe,IAAI,KAAA;AAEtF,MAAM,UAAU,UACf,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ,KAAA;;;;;AAM/D,MAAa,iBAAiB,QAA4C;CACzE,IAAI,CAAC,MAAM,QAAQ,GAAG,GACrB;CAED,MAAM,MAAqB,CAAC;CAC5B,KAAK,MAAM,QAAQ,KAAK;EACvB,IAAI,IAAI,UAAU,mBACjB;EAED,IAAI,CAAC,SAAS,IAAI,KAAK,MAAM,QAAQ,IAAI,GACxC;EAED,MAAM,KAAK,KAAK,KAAK,EAAE;EACvB,IAAI,OAAO,KAAA,GACV;EAED,MAAM,OAAO,KAAK,KAAK,IAAI;EAC3B,MAAM,WAAW,OAAO,KAAK,QAAQ;EACrC,MAAM,QAAQ,OAAO,KAAK,KAAK;EAC/B,IAAI,KAAK;GACR;GACA,GAAI,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,KAAK;GACrC,GAAI,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS;GAC7C,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACxC,CAAC;CACF;CACA,OAAO,IAAI,SAAS,IAAI,MAAM,KAAA;AAC/B"}
@@ -0,0 +1,9 @@
1
+ //#region src/goals/latent.ts
2
+ /** True when the hint carries nothing the install itself declared. */
3
+ const hasNoDeclaredGoals = (slugs, builtinSlugs) => slugs.every((slug) => (builtinSlugs ?? []).includes(slug));
4
+ /** True for a built-in goal's row before it has a single conversion: not a row, yet. */
5
+ const isLatentGoalRow = (slug, conversions, builtinSlugs) => (builtinSlugs ?? []).includes(slug) && !conversions;
6
+ //#endregion
7
+ export { hasNoDeclaredGoals, isLatentGoalRow };
8
+
9
+ //# sourceMappingURL=latent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"latent.js","names":[],"sources":["../../src/goals/latent.ts"],"sourcesContent":["import type { MetricValue } from '../core/contract'\n\n// Built-in `purchase` always matches but is no goal the install has: a report treating it as one\n// would tell a site that sells nothing it has a goal, at zero, forever.\n\n/** True when the hint carries nothing the install itself declared. */\nexport const hasNoDeclaredGoals = (\n\tslugs: readonly string[],\n\tbuiltinSlugs: readonly string[] | undefined\n): boolean => slugs.every((slug) => (builtinSlugs ?? []).includes(slug))\n\n/** True for a built-in goal's row before it has a single conversion: not a row, yet. */\nexport const isLatentGoalRow = (\n\tslug: string,\n\tconversions: MetricValue | undefined,\n\tbuiltinSlugs: readonly string[] | undefined\n): boolean => (builtinSlugs ?? []).includes(slug) && !conversions\n"],"mappings":";;AAMA,MAAa,sBACZ,OACA,iBACa,MAAM,OAAO,UAAU,gBAAgB,CAAC,GAAG,SAAS,IAAI,CAAC;;AAGvE,MAAa,mBACZ,MACA,aACA,kBACc,gBAAgB,CAAC,GAAG,SAAS,IAAI,KAAK,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { GoalFieldOptions } from "./goalField.js";
2
+ import { Field, NumberField } from "payload";
3
+
4
+ //#region src/goals/linkFields.d.ts
5
+ interface AnalyticsLinkFieldsOptions {
6
+ /** Passed straight to {@link goalField}; `name` defaults to `'goal'`. */
7
+ goal?: GoalFieldOptions;
8
+ /**
9
+ * A per-link worth beside the picker, off by default. Native still prefers a goal's fixed value
10
+ * unless `revenue.browserAmounts` is `'trust'`.
11
+ */
12
+ value?: boolean | {
13
+ name?: string;
14
+ overrides?: (args: {
15
+ field: NumberField;
16
+ }) => NumberField;
17
+ };
18
+ /** Last word on the whole set. Return the fields to use, in the order to use them. */
19
+ overrides?: (args: {
20
+ fields: Field[];
21
+ }) => Field[];
22
+ /**
23
+ * Whether the value input is offered. Set it to match your `revenue` option inside a Lexical
24
+ * `LinkFeature`, whose fields the plugin cannot see to hide.
25
+ */
26
+ revenue?: boolean;
27
+ }
28
+ /**
29
+ * The analytics fields for a link: a goal picker and optional worth, for your link group or a
30
+ * `LinkFeature`'s `fields`. Read them back with `goalAttributes()` where the link renders.
31
+ */
32
+ declare const analyticsLinkFields: (options?: AnalyticsLinkFieldsOptions) => Field[];
33
+ //#endregion
34
+ export { AnalyticsLinkFieldsOptions, analyticsLinkFields };
35
+ //# sourceMappingURL=linkFields.d.ts.map
@@ -0,0 +1,31 @@
1
+ import { keys } from "../translations/keys.js";
2
+ import { labelForKey } from "../translations/server.js";
3
+ import { applyRevenueVisibility, moneyField } from "./moneyFields.js";
4
+ import { goalField } from "./goalField.js";
5
+ //#region src/goals/linkFields.ts
6
+ /**
7
+ * The analytics fields for a link: a goal picker and optional worth, for your link group or a
8
+ * `LinkFeature`'s `fields`. Read them back with `goalAttributes()` where the link renders.
9
+ */
10
+ const analyticsLinkFields = (options = {}) => {
11
+ const fields = [goalField(options.goal)];
12
+ if (options.value) {
13
+ const config = options.value === true ? {} : options.value;
14
+ const field = moneyField({
15
+ name: config.name ?? "goalValue",
16
+ type: "number",
17
+ min: 0,
18
+ label: labelForKey(keys.fieldGoalValueLabel),
19
+ admin: {
20
+ description: labelForKey(keys.fieldGoalValueHelp),
21
+ condition: (_data, siblingData) => Boolean(siblingData?.[options.goal?.name ?? "goal"])
22
+ }
23
+ });
24
+ fields.push(config.overrides ? config.overrides({ field }) : field);
25
+ }
26
+ return applyRevenueVisibility(options.overrides ? options.overrides({ fields }) : fields, options.revenue ?? true);
27
+ };
28
+ //#endregion
29
+ export { analyticsLinkFields };
30
+
31
+ //# sourceMappingURL=linkFields.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"linkFields.js","names":[],"sources":["../../src/goals/linkFields.ts"],"sourcesContent":["import type { Field, NumberField } from 'payload'\nimport { keys } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport { type GoalFieldOptions, goalField } from './goalField'\nimport { applyRevenueVisibility, moneyField } from './moneyFields'\n\nexport interface AnalyticsLinkFieldsOptions {\n\t/** Passed straight to {@link goalField}; `name` defaults to `'goal'`. */\n\tgoal?: GoalFieldOptions\n\t/**\n\t * A per-link worth beside the picker, off by default. Native still prefers a goal's fixed value\n\t * unless `revenue.browserAmounts` is `'trust'`.\n\t */\n\tvalue?: boolean | { name?: string; overrides?: (args: { field: NumberField }) => NumberField }\n\t/** Last word on the whole set. Return the fields to use, in the order to use them. */\n\toverrides?: (args: { fields: Field[] }) => Field[]\n\t/**\n\t * Whether the value input is offered. Set it to match your `revenue` option inside a Lexical\n\t * `LinkFeature`, whose fields the plugin cannot see to hide.\n\t */\n\trevenue?: boolean\n}\n\n/**\n * The analytics fields for a link: a goal picker and optional worth, for your link group or a\n * `LinkFeature`'s `fields`. Read them back with `goalAttributes()` where the link renders.\n */\nexport const analyticsLinkFields = (options: AnalyticsLinkFieldsOptions = {}): Field[] => {\n\tconst fields: Field[] = [goalField(options.goal)]\n\tif (options.value) {\n\t\tconst config = options.value === true ? {} : options.value\n\t\tconst field: NumberField = moneyField({\n\t\t\tname: config.name ?? 'goalValue',\n\t\t\ttype: 'number',\n\t\t\tmin: 0,\n\t\t\tlabel: labelForKey(keys.fieldGoalValueLabel),\n\t\t\tadmin: {\n\t\t\t\tdescription: labelForKey(keys.fieldGoalValueHelp),\n\t\t\t\tcondition: (_data, siblingData) => Boolean(siblingData?.[options.goal?.name ?? 'goal']),\n\t\t\t},\n\t\t})\n\t\tfields.push(config.overrides ? config.overrides({ field }) : field)\n\t}\n\tconst resolved = options.overrides ? options.overrides({ fields }) : fields\n\treturn applyRevenueVisibility(resolved, options.revenue ?? true)\n}\n"],"mappings":";;;;;;;;;AA2BA,MAAa,uBAAuB,UAAsC,CAAC,MAAe;CACzF,MAAM,SAAkB,CAAC,UAAU,QAAQ,IAAI,CAAC;CAChD,IAAI,QAAQ,OAAO;EAClB,MAAM,SAAS,QAAQ,UAAU,OAAO,CAAC,IAAI,QAAQ;EACrD,MAAM,QAAqB,WAAW;GACrC,MAAM,OAAO,QAAQ;GACrB,MAAM;GACN,KAAK;GACL,OAAO,YAAY,KAAK,mBAAmB;GAC3C,OAAO;IACN,aAAa,YAAY,KAAK,kBAAkB;IAChD,YAAY,OAAO,gBAAgB,QAAQ,cAAc,QAAQ,MAAM,QAAQ,OAAO;GACvF;EACD,CAAC;EACD,OAAO,KAAK,OAAO,YAAY,OAAO,UAAU,EAAE,MAAM,CAAC,IAAI,KAAK;CACnE;CAEA,OAAO,uBADU,QAAQ,YAAY,QAAQ,UAAU,EAAE,OAAO,CAAC,IAAI,QAC7B,QAAQ,WAAW,IAAI;AAChE"}
@@ -0,0 +1,14 @@
1
+ //#region src/goals/match.d.ts
2
+ /**
3
+ * How far ingest believes a browser's amount (`revenue.browserAmounts`): `trust` over a goal's fixed
4
+ * value, `fixed` only where a goal has none, `none` never. Server code is always believed.
5
+ */
6
+ type BrowserAmounts = 'none' | 'fixed' | 'trust';
7
+ /**
8
+ * Whether ingest takes an unsigned browser order id (`revenue.orderSignature`): `optional` credits
9
+ * the webhook's record only within a day of it, `required` lets no request claim an unsigned order.
10
+ */
11
+ type OrderSignatureMode = 'required' | 'optional';
12
+ //#endregion
13
+ export { BrowserAmounts, OrderSignatureMode };
14
+ //# sourceMappingURL=match.d.ts.map