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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,114 +1,148 @@
1
- import "./paths.js";
2
- import { getRuntime, readAccessFor, requestTimezone } from "./runtime.js";
3
- import { TIMEFRAME_PRESETS } from "../timeframe/presets.js";
4
- import { METRIC_KEYS } from "../translations/metricKeys.js";
5
- import { readForField } from "../fields/readForDocument.js";
1
+ import { readReportMode, reportModes } from "../binding/report.js";
2
+ import { readGate } from "../access/readGate.js";
3
+ import { wholeNumberParam } from "../core/values.js";
4
+ import { isMetricKey } from "../core/guards.js";
5
+ import { describeWithCauses } from "../core/sourceErrors.js";
6
+ import { currentDate } from "../core/clock.js";
7
+ import { getRuntime, requestTimezone } from "./runtime.js";
8
+ import { exceedsRangeCap } from "../query/limits.js";
9
+ import { NO_STORE, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
10
+ import { isTimeframePreset } from "../timeframe/presets.js";
11
+ import { ITEM_PANEL_METRICS, ITEM_PANEL_OPTIONAL_METRICS } from "../fields/itemReport.js";
12
+ import { engineReads, readFieldWith } from "../fields/readForDocument.js";
6
13
  import { parseDayOrInstant } from "../query/dates.js";
7
- import { NO_STORE } from "./responses.js";
14
+ import { readDimensionList } from "../query/parse.js";
15
+ import { resolveBoundDocument, unloadedDocumentResponse } from "./boundDocument.js";
16
+ import { queryParams } from "./queryParams.js";
8
17
  //#region src/plugin/documentEndpoint.ts
9
- const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
10
18
  const MAX_METRICS = 8;
19
+ /** A panel row holds three small lists; more would stop being a panel. */
20
+ const MAX_PANEL_DIMENSIONS = 3;
21
+ const MAX_PANEL_ROWS = 25;
22
+ /** A source with no time per pageview (most vendors) leaves that card out without a warning. */
23
+ const PAGE_PANEL_OPTIONAL_METRICS = ["avgDuration"];
11
24
  const parseMetrics = (raw) => {
12
25
  if (!raw) return null;
13
- const metrics = raw.split(",").map((m) => m.trim()).filter((m) => KNOWN_METRICS.has(m));
26
+ const metrics = raw.split(",").map((m) => m.trim()).filter(isMetricKey);
14
27
  return metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null;
15
28
  };
16
29
  /**
17
- * A custom window from the query string, read exactly like the query endpoint's: a
18
- * `YYYY-MM-DD` day is the whole calendar day in the reporting timezone (`to` inclusive of
19
- * its final instant), a datetime must carry `Z` or a `±HH:MM` offset, and anything else,
20
- * including an offset-less datetime, is rejected. `from` equal to `to` is one whole day for
21
- * day strings and a zero-width window for two instants, so only the latter is rejected.
30
+ * A custom window read like the query endpoint's, capped at `MAX_QUERY_RANGE_DAYS`; a `YYYY-MM-DD`
31
+ * day spans the whole day in the reporting timezone. An inverted window blames `to`, picked second.
22
32
  */
23
33
  const parseRange = (from, to, timezone) => {
24
- if (!from || !to) return null;
34
+ if (!from) return {
35
+ ok: false,
36
+ param: "from"
37
+ };
38
+ if (!to) return {
39
+ ok: false,
40
+ param: "to"
41
+ };
25
42
  const start = parseDayOrInstant(from, {
26
43
  timezone,
27
44
  edge: "start"
28
45
  });
46
+ if (!start) return {
47
+ ok: false,
48
+ param: "from"
49
+ };
29
50
  const end = parseDayOrInstant(to, {
30
51
  timezone,
31
52
  edge: "end"
32
53
  });
33
- if (!start || !end || end.getTime() <= start.getTime()) return null;
34
- return {
54
+ if (!end || end.getTime() <= start.getTime()) return {
55
+ ok: false,
56
+ param: "to"
57
+ };
58
+ if (exceedsRangeCap({
35
59
  start,
36
60
  end
61
+ })) return {
62
+ ok: false,
63
+ param: "to",
64
+ tooLong: true
65
+ };
66
+ return {
67
+ ok: true,
68
+ range: {
69
+ start,
70
+ end
71
+ }
37
72
  };
38
73
  };
39
74
  /**
40
- * Authenticated GET handler behind the interactive document analytics panel, gated
41
- * by `access.read` like every other read endpoint. The caller must also be able to
42
- * read the target document (enforced through `findByID`
43
- * without `overrideAccess`), so analytics never leak for content the user cannot
44
- * see; an unreadable or missing document is a uniform 404. Timeframe, metrics, and
45
- * data source are whitelist-validated; `timeframe=custom` requires a parseable
46
- * `from`/`to` pair.
75
+ * Authenticated GET behind the document panel, in the document's own scope (no parameter names
76
+ * one). Unreadable and missing are one 404; other failures are a logged 500, never a masking 404.
47
77
  */
48
78
  const makeDocumentHandler = () => async (req) => {
49
- if (!req.user) return Response.json({ error: "unauthorized" }, {
50
- status: 401,
51
- headers: NO_STORE
52
- });
79
+ if (!req.user) return unauthorizedResponse();
53
80
  const runtime = getRuntime(req.payload);
54
- if (!runtime) return Response.json({ error: "unavailable" }, {
55
- status: 503,
56
- headers: NO_STORE
57
- });
58
- if (!await readAccessFor(runtime, req)) return Response.json({ error: "forbidden" }, {
59
- status: 403,
60
- headers: NO_STORE
61
- });
62
- const params = new URL(req.url ?? "", "http://localhost").searchParams;
81
+ if (!runtime) return notAvailableResponse();
82
+ try {
83
+ return await answerDocument(req, runtime);
84
+ } catch (err) {
85
+ req.payload.logger?.error(`analytics: document read failed: ${describeWithCauses(err)}`);
86
+ return errorResponse(500, analyticsError("internal", "analytics: document read failed"));
87
+ }
88
+ };
89
+ const answerDocument = async (req, runtime) => {
90
+ if (!await readGate(runtime, req)) return readDeniedResponse();
91
+ const params = queryParams(req);
63
92
  const collection = params.get("collection") ?? "";
64
93
  const id = params.get("id") ?? "";
65
- if (!runtime.bindings[collection] || !id) return Response.json({ error: "not found" }, {
66
- status: 404,
67
- headers: NO_STORE
68
- });
94
+ if (!runtime.bindings[collection] || !id) return unloadedDocumentResponse(404);
69
95
  const rawTimeframe = params.get("timeframe") ?? "last30days";
70
- const timezone = rawTimeframe === "custom" ? await requestTimezone(req) : void 0;
71
- const range = timezone !== void 0 ? parseRange(params.get("from"), params.get("to"), timezone) : void 0;
72
- const timeframe = TIMEFRAME_PRESETS.includes(rawTimeframe) ? rawTimeframe : "last30days";
73
- if (rawTimeframe === "custom" && !range) return Response.json({ error: "invalid range" }, {
74
- status: 400,
75
- headers: NO_STORE
76
- });
77
- const metrics = parseMetrics(params.get("metrics")) ?? [
96
+ let timezone;
97
+ let range;
98
+ if (rawTimeframe === "custom") {
99
+ timezone = await requestTimezone(req);
100
+ const parsed = parseRange(params.get("from"), params.get("to"), timezone);
101
+ if (!parsed.ok) return errorResponse(400, parsed.tooLong ? analyticsError("range_too_long", `analytics: the range must not exceed 366 days`, parsed.param) : analyticsError("invalid_param", "analytics: the custom range could not be read", parsed.param));
102
+ range = parsed.range;
103
+ }
104
+ const timeframe = isTimeframePreset(rawTimeframe) ? rawTimeframe : "last30days";
105
+ const report = readReportMode(params.get("report")) ?? reportModes(runtime.bindings[collection])[0] ?? "page";
106
+ const requested = parseMetrics(params.get("metrics"));
107
+ const metrics = requested ?? (report === "item" ? ITEM_PANEL_METRICS : [
78
108
  "pageviews",
79
109
  "visitors",
80
110
  "sessions",
81
111
  "avgDuration"
82
- ];
83
- let data;
84
- try {
85
- data = await req.payload.findByID({
86
- collection,
87
- id,
88
- depth: 0,
89
- overrideAccess: false,
90
- user: req.user,
91
- req
92
- });
93
- } catch {
94
- return Response.json({ error: "not found" }, {
95
- status: 404,
96
- headers: NO_STORE
97
- });
98
- }
99
- const result = await readForField({
112
+ ]);
113
+ const optionalMetrics = parseMetrics(params.get("optional")) ?? (requested === null ? report === "item" ? ITEM_PANEL_OPTIONAL_METRICS : PAGE_PANEL_OPTIONAL_METRICS : []);
114
+ const dimensions = readDimensionList(params.get("dimensions"), MAX_PANEL_DIMENSIONS);
115
+ const rawLimit = wholeNumberParam(params.get("limit"));
116
+ const limit = rawLimit === void 0 ? void 0 : Math.min(Math.max(rawLimit, 1), MAX_PANEL_ROWS);
117
+ const bound = await resolveBoundDocument({
118
+ req,
119
+ collection,
120
+ id
121
+ });
122
+ if (!bound.ok) return unloadedDocumentResponse(bound.status);
123
+ const reads = engineReads({
124
+ priority: "interactive",
125
+ ...params.get("fresh") === "1" ? { allowStale: false } : {}
126
+ });
127
+ const result = await readFieldWith({
100
128
  req,
101
129
  collectionSlug: collection,
102
- data,
130
+ data: bound.data,
103
131
  metrics,
132
+ optionalMetrics,
104
133
  timeframe,
105
- range: range ?? void 0,
134
+ range,
106
135
  ...timezone !== void 0 ? { timezone } : {},
136
+ ...dimensions.length > 0 ? { dimensions } : {},
137
+ ...limit === void 0 ? {} : { limit },
107
138
  adapterId: params.get("dataSource") ?? void 0,
108
- now: /* @__PURE__ */ new Date(),
139
+ fallbackWhenUnreadable: true,
140
+ now: currentDate(),
109
141
  compare: params.get("compare") === "1",
110
- series: params.get("series") === "1"
111
- });
142
+ series: params.get("series") === "1",
143
+ report
144
+ }, reads);
145
+ if (result.untrustedScope) return untrustedScopeResponse();
112
146
  return Response.json(result, { headers: NO_STORE });
113
147
  };
114
148
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import type { CollectionSlug, PayloadHandler } from 'payload'\nimport type { BindingDoc } from '../binding/types'\nimport type { DateRange, MetricKey } from '../core/contract'\nimport { readForField } from '../fields/readForDocument'\nimport { parseDayOrInstant } from '../query/dates'\nimport { TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport { DOCUMENT_PATH } from './paths'\nimport { NO_STORE } from './responses'\nimport { getRuntime, readAccessFor, requestTimezone } from './runtime'\n\nexport { DOCUMENT_PATH }\n\nconst KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS) as MetricKey[])\nconst MAX_METRICS = 8\n\nconst parseMetrics = (raw: string | null): MetricKey[] | null => {\n\tif (!raw) {\n\t\treturn null\n\t}\n\tconst metrics = raw\n\t\t.split(',')\n\t\t.map((m) => m.trim())\n\t\t.filter((m): m is MetricKey => KNOWN_METRICS.has(m as MetricKey))\n\treturn metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null\n}\n\n/**\n * A custom window from the query string, read exactly like the query endpoint's: a\n * `YYYY-MM-DD` day is the whole calendar day in the reporting timezone (`to` inclusive of\n * its final instant), a datetime must carry `Z` or a `±HH:MM` offset, and anything else,\n * including an offset-less datetime, is rejected. `from` equal to `to` is one whole day for\n * day strings and a zero-width window for two instants, so only the latter is rejected.\n */\nconst parseRange = (from: string | null, to: string | null, timezone: string): DateRange | null => {\n\tif (!from || !to) {\n\t\treturn null\n\t}\n\tconst start = parseDayOrInstant(from, { timezone, edge: 'start' })\n\tconst end = parseDayOrInstant(to, { timezone, edge: 'end' })\n\tif (!start || !end || end.getTime() <= start.getTime()) {\n\t\treturn null\n\t}\n\treturn { start, end }\n}\n\n/**\n * Authenticated GET handler behind the interactive document analytics panel, gated\n * by `access.read` like every other read endpoint. The caller must also be able to\n * read the target document (enforced through `findByID`\n * without `overrideAccess`), so analytics never leak for content the user cannot\n * see; an unreadable or missing document is a uniform 404. Timeframe, metrics, and\n * data source are whitelist-validated; `timeframe=custom` requires a parseable\n * `from`/`to` pair.\n */\nexport const makeDocumentHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401, headers: NO_STORE })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn Response.json({ error: 'unavailable' }, { status: 503, headers: NO_STORE })\n\t}\n\tif (!(await readAccessFor(runtime, req))) {\n\t\treturn Response.json({ error: 'forbidden' }, { status: 403, headers: NO_STORE })\n\t}\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\tconst collection = params.get('collection') ?? ''\n\tconst id = params.get('id') ?? ''\n\tif (!runtime.bindings[collection] || !id) {\n\t\treturn Response.json({ error: 'not found' }, { status: 404, headers: NO_STORE })\n\t}\n\tconst rawTimeframe = params.get('timeframe') ?? 'last30days'\n\t// Custom bounds name calendar days, so the reporting timezone has to be resolved before\n\t// they can be read; a preset resolves its window inside `readForField` as before.\n\tconst timezone = rawTimeframe === 'custom' ? await requestTimezone(req) : undefined\n\tconst range =\n\t\ttimezone !== undefined ? parseRange(params.get('from'), params.get('to'), timezone) : undefined\n\tconst timeframe: TimeframePreset = TIMEFRAME_PRESETS.includes(rawTimeframe as TimeframePreset)\n\t\t? (rawTimeframe as TimeframePreset)\n\t\t: 'last30days'\n\tif (rawTimeframe === 'custom' && !range) {\n\t\treturn Response.json({ error: 'invalid range' }, { status: 400, headers: NO_STORE })\n\t}\n\tconst metrics = parseMetrics(params.get('metrics')) ?? [\n\t\t'pageviews',\n\t\t'visitors',\n\t\t'sessions',\n\t\t'avgDuration',\n\t]\n\tlet data: BindingDoc\n\ttry {\n\t\tdata = (await req.payload.findByID({\n\t\t\tcollection: collection as CollectionSlug,\n\t\t\tid,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: false,\n\t\t\tuser: req.user,\n\t\t\treq,\n\t\t})) as BindingDoc\n\t} catch {\n\t\treturn Response.json({ error: 'not found' }, { status: 404, headers: NO_STORE })\n\t}\n\tconst result = await readForField({\n\t\treq,\n\t\tcollectionSlug: collection,\n\t\tdata,\n\t\tmetrics,\n\t\ttimeframe,\n\t\trange: range ?? undefined,\n\t\t...(timezone !== undefined ? { timezone } : {}),\n\t\tadapterId: params.get('dataSource') ?? undefined,\n\t\tnow: new Date(),\n\t\tcompare: params.get('compare') === '1',\n\t\tseries: params.get('series') === '1',\n\t})\n\treturn Response.json(result, { headers: NO_STORE })\n}\n"],"mappings":";;;;;;;;AAaA,MAAM,gBAAgB,IAAI,IAAI,OAAO,KAAK,WAAW,CAAgB;AACrE,MAAM,cAAc;AAEpB,MAAM,gBAAgB,QAA2C;CAChE,IAAI,CAAC,KACJ,OAAO;CAER,MAAM,UAAU,IACd,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,QAAQ,MAAsB,cAAc,IAAI,CAAc,CAAC;CACjE,OAAO,QAAQ,SAAS,IAAI,QAAQ,MAAM,GAAG,WAAW,IAAI;AAC7D;;;;;;;;AASA,MAAM,cAAc,MAAqB,IAAmB,aAAuC;CAClG,IAAI,CAAC,QAAQ,CAAC,IACb,OAAO;CAER,MAAM,QAAQ,kBAAkB,MAAM;EAAE;EAAU,MAAM;CAAQ,CAAC;CACjE,MAAM,MAAM,kBAAkB,IAAI;EAAE;EAAU,MAAM;CAAM,CAAC;CAC3D,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,QAAQ,KAAK,MAAM,QAAQ,GACpD,OAAO;CAER,OAAO;EAAE;EAAO;CAAI;AACrB;;;;;;;;;;AAWA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG;EAAE,QAAQ;EAAK,SAAS;CAAS,CAAC;CAEnF,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,SAAS,KAAK,EAAE,OAAO,cAAc,GAAG;EAAE,QAAQ;EAAK,SAAS;CAAS,CAAC;CAElF,IAAI,CAAE,MAAM,cAAc,SAAS,GAAG,GACrC,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG;EAAE,QAAQ;EAAK,SAAS;CAAS,CAAC;CAEhF,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;CAC1D,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK;CAC/C,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK;CAC/B,IAAI,CAAC,QAAQ,SAAS,eAAe,CAAC,IACrC,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG;EAAE,QAAQ;EAAK,SAAS;CAAS,CAAC;CAEhF,MAAM,eAAe,OAAO,IAAI,WAAW,KAAK;CAGhD,MAAM,WAAW,iBAAiB,WAAW,MAAM,gBAAgB,GAAG,IAAI,KAAA;CAC1E,MAAM,QACL,aAAa,KAAA,IAAY,WAAW,OAAO,IAAI,MAAM,GAAG,OAAO,IAAI,IAAI,GAAG,QAAQ,IAAI,KAAA;CACvF,MAAM,YAA6B,kBAAkB,SAAS,YAA+B,IACzF,eACD;CACH,IAAI,iBAAiB,YAAY,CAAC,OACjC,OAAO,SAAS,KAAK,EAAE,OAAO,gBAAgB,GAAG;EAAE,QAAQ;EAAK,SAAS;CAAS,CAAC;CAEpF,MAAM,UAAU,aAAa,OAAO,IAAI,SAAS,CAAC,KAAK;EACtD;EACA;EACA;EACA;CACD;CACA,IAAI;CACJ,IAAI;EACH,OAAQ,MAAM,IAAI,QAAQ,SAAS;GACtB;GACZ;GACA,OAAO;GACP,gBAAgB;GAChB,MAAM,IAAI;GACV;EACD,CAAC;CACF,QAAQ;EACP,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG;GAAE,QAAQ;GAAK,SAAS;EAAS,CAAC;CAChF;CACA,MAAM,SAAS,MAAM,aAAa;EACjC;EACA,gBAAgB;EAChB;EACA;EACA;EACA,OAAO,SAAS,KAAA;EAChB,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC7C,WAAW,OAAO,IAAI,YAAY,KAAK,KAAA;EACvC,qBAAK,IAAI,KAAK;EACd,SAAS,OAAO,IAAI,SAAS,MAAM;EACnC,QAAQ,OAAO,IAAI,QAAQ,MAAM;CAClC,CAAC;CACD,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;AACnD"}
1
+ {"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { readReportMode, reportModes } from '../binding/report'\nimport { currentDate } from '../core/clock'\nimport type { DateRange, MetricKey } from '../core/contract'\nimport { isMetricKey } from '../core/guards'\nimport { describeWithCauses } from '../core/sourceErrors'\nimport { wholeNumberParam } from '../core/values'\nimport { ITEM_PANEL_METRICS, ITEM_PANEL_OPTIONAL_METRICS } from '../fields/itemReport'\nimport { engineReads, readFieldWith } from '../fields/readForDocument'\nimport { parseDayOrInstant } from '../query/dates'\nimport { exceedsRangeCap, MAX_QUERY_RANGE_DAYS } from '../query/limits'\nimport { readDimensionList } from '../query/parse'\nimport { isTimeframePreset, type TimeframePreset } from '../timeframe/presets'\nimport { resolveBoundDocument, unloadedDocumentResponse } from './boundDocument'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\tnotAvailableResponse,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport { queryParams } from './queryParams'\nimport { type AnalyticsRuntime, getRuntime, requestTimezone } from './runtime'\n\nconst MAX_METRICS = 8\n/** A panel row holds three small lists; more would stop being a panel. */\nconst MAX_PANEL_DIMENSIONS = 3\nconst MAX_PANEL_ROWS = 25\n/** A source with no time per pageview (most vendors) leaves that card out without a warning. */\nconst PAGE_PANEL_OPTIONAL_METRICS: MetricKey[] = ['avgDuration']\n\nconst parseMetrics = (raw: string | null): MetricKey[] | null => {\n\tif (!raw) {\n\t\treturn null\n\t}\n\tconst metrics = raw\n\t\t.split(',')\n\t\t.map((m) => m.trim())\n\t\t.filter(isMetricKey)\n\treturn metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null\n}\n\ntype RangeResult =\n\t| { ok: true; range: DateRange }\n\t| { ok: false; param: 'from' | 'to'; tooLong?: true }\n\n/**\n * A custom window read like the query endpoint's, capped at `MAX_QUERY_RANGE_DAYS`; a `YYYY-MM-DD`\n * day spans the whole day in the reporting timezone. An inverted window blames `to`, picked second.\n */\nconst parseRange = (from: string | null, to: string | null, timezone: string): RangeResult => {\n\tif (!from) {\n\t\treturn { ok: false, param: 'from' }\n\t}\n\tif (!to) {\n\t\treturn { ok: false, param: 'to' }\n\t}\n\tconst start = parseDayOrInstant(from, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn { ok: false, param: 'from' }\n\t}\n\tconst end = parseDayOrInstant(to, { timezone, edge: 'end' })\n\tif (!end || end.getTime() <= start.getTime()) {\n\t\treturn { ok: false, param: 'to' }\n\t}\n\tif (exceedsRangeCap({ start, end })) {\n\t\treturn { ok: false, param: 'to', tooLong: true }\n\t}\n\treturn { ok: true, range: { start, end } }\n}\n\n/**\n * Authenticated GET behind the document panel, in the document's own scope (no parameter names\n * one). Unreadable and missing are one 404; other failures are a logged 500, never a masking 404.\n */\nexport const makeDocumentHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn unauthorizedResponse()\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn notAvailableResponse()\n\t}\n\ttry {\n\t\treturn await answerDocument(req, runtime)\n\t} catch (err) {\n\t\treq.payload.logger?.error(`analytics: document read failed: ${describeWithCauses(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: document read failed'))\n\t}\n}\n\nconst answerDocument = async (\n\treq: PayloadRequest,\n\truntime: AnalyticsRuntime\n): Promise<Response> => {\n\tif (!(await readGate(runtime, req))) {\n\t\treturn readDeniedResponse()\n\t}\n\tconst params = queryParams(req)\n\tconst collection = params.get('collection') ?? ''\n\tconst id = params.get('id') ?? ''\n\tif (!runtime.bindings[collection] || !id) {\n\t\treturn unloadedDocumentResponse(404)\n\t}\n\tconst rawTimeframe = params.get('timeframe') ?? 'last30days'\n\tlet timezone: string | undefined\n\tlet range: DateRange | undefined\n\tif (rawTimeframe === 'custom') {\n\t\t// Custom bounds name calendar days, so the reporting timezone must resolve before they are\n\t\t// read; a preset resolves its window inside `readForField`.\n\t\ttimezone = await requestTimezone(req)\n\t\tconst parsed = parseRange(params.get('from'), params.get('to'), timezone)\n\t\tif (!parsed.ok) {\n\t\t\treturn errorResponse(\n\t\t\t\t400,\n\t\t\t\tparsed.tooLong\n\t\t\t\t\t? analyticsError(\n\t\t\t\t\t\t\t'range_too_long',\n\t\t\t\t\t\t\t`analytics: the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`,\n\t\t\t\t\t\t\tparsed.param\n\t\t\t\t\t\t)\n\t\t\t\t\t: analyticsError(\n\t\t\t\t\t\t\t'invalid_param',\n\t\t\t\t\t\t\t'analytics: the custom range could not be read',\n\t\t\t\t\t\t\tparsed.param\n\t\t\t\t\t\t)\n\t\t\t)\n\t\t}\n\t\trange = parsed.range\n\t}\n\tconst timeframe: TimeframePreset = isTimeframePreset(rawTimeframe) ? rawTimeframe : 'last30days'\n\tconst report =\n\t\treadReportMode(params.get('report')) ?? reportModes(runtime.bindings[collection])[0] ?? 'page'\n\tconst requested = parseMetrics(params.get('metrics'))\n\tconst metrics =\n\t\trequested ??\n\t\t(report === 'item' ? ITEM_PANEL_METRICS : ['pageviews', 'visitors', 'sessions', 'avgDuration'])\n\t// Metrics the panel asked for on spec, so a source serving none of them warns nobody.\n\tconst optionalMetrics =\n\t\tparseMetrics(params.get('optional')) ??\n\t\t(requested === null\n\t\t\t? report === 'item'\n\t\t\t\t? ITEM_PANEL_OPTIONAL_METRICS\n\t\t\t\t: PAGE_PANEL_OPTIONAL_METRICS\n\t\t\t: [])\n\tconst dimensions = readDimensionList(params.get('dimensions'), MAX_PANEL_DIMENSIONS)\n\tconst rawLimit = wholeNumberParam(params.get('limit'))\n\tconst limit = rawLimit === undefined ? undefined : Math.min(Math.max(rawLimit, 1), MAX_PANEL_ROWS)\n\tconst bound = await resolveBoundDocument({ req, collection, id })\n\tif (!bound.ok) {\n\t\treturn unloadedDocumentResponse(bound.status)\n\t}\n\t// `fresh=1` waits for the source rather than answering with an expired entry: the panel asks it\n\t// when its first render could only show saved numbers, and falls back to them if the source fails.\n\tconst reads = engineReads({\n\t\tpriority: 'interactive',\n\t\t...(params.get('fresh') === '1' ? { allowStale: false } : {}),\n\t})\n\tconst result = await readFieldWith(\n\t\t{\n\t\t\treq,\n\t\t\tcollectionSlug: collection,\n\t\t\tdata: bound.data,\n\t\t\tmetrics,\n\t\t\toptionalMetrics,\n\t\t\ttimeframe,\n\t\t\trange,\n\t\t\t...(timezone !== undefined ? { timezone } : {}),\n\t\t\t...(dimensions.length > 0 ? { dimensions } : {}),\n\t\t\t...(limit === undefined ? {} : { limit }),\n\t\t\tadapterId: params.get('dataSource') ?? undefined,\n\t\t\t// The panel sends the source its field stores until the reader picks another.\n\t\t\tfallbackWhenUnreadable: true,\n\t\t\tnow: currentDate(),\n\t\t\tcompare: params.get('compare') === '1',\n\t\t\tseries: params.get('series') === '1',\n\t\t\treport,\n\t\t},\n\t\treads\n\t)\n\tif (result.untrustedScope) {\n\t\treturn untrustedScopeResponse()\n\t}\n\treturn Response.json(result, { headers: NO_STORE })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,MAAM,cAAc;;AAEpB,MAAM,uBAAuB;AAC7B,MAAM,iBAAiB;;AAEvB,MAAM,8BAA2C,CAAC,aAAa;AAE/D,MAAM,gBAAgB,QAA2C;CAChE,IAAI,CAAC,KACJ,OAAO;CAER,MAAM,UAAU,IACd,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,WAAW;CACpB,OAAO,QAAQ,SAAS,IAAI,QAAQ,MAAM,GAAG,WAAW,IAAI;AAC7D;;;;;AAUA,MAAM,cAAc,MAAqB,IAAmB,aAAkC;CAC7F,IAAI,CAAC,MACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAO;CAEnC,IAAI,CAAC,IACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAK;CAEjC,MAAM,QAAQ,kBAAkB,MAAM;EAAE;EAAU,MAAM;CAAQ,CAAC;CACjE,IAAI,CAAC,OACJ,OAAO;EAAE,IAAI;EAAO,OAAO;CAAO;CAEnC,MAAM,MAAM,kBAAkB,IAAI;EAAE;EAAU,MAAM;CAAM,CAAC;CAC3D,IAAI,CAAC,OAAO,IAAI,QAAQ,KAAK,MAAM,QAAQ,GAC1C,OAAO;EAAE,IAAI;EAAO,OAAO;CAAK;CAEjC,IAAI,gBAAgB;EAAE;EAAO;CAAI,CAAC,GACjC,OAAO;EAAE,IAAI;EAAO,OAAO;EAAM,SAAS;CAAK;CAEhD,OAAO;EAAE,IAAI;EAAM,OAAO;GAAE;GAAO;EAAI;CAAE;AAC1C;;;;;AAMA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,qBAAqB;CAE7B,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,qBAAqB;CAE7B,IAAI;EACH,OAAO,MAAM,eAAe,KAAK,OAAO;CACzC,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,MAAM,oCAAoC,mBAAmB,GAAG,GAAG;EACvF,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;AACD;AAEA,MAAM,iBAAiB,OACtB,KACA,YACuB;CACvB,IAAI,CAAE,MAAM,SAAS,SAAS,GAAG,GAChC,OAAO,mBAAmB;CAE3B,MAAM,SAAS,YAAY,GAAG;CAC9B,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK;CAC/C,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK;CAC/B,IAAI,CAAC,QAAQ,SAAS,eAAe,CAAC,IACrC,OAAO,yBAAyB,GAAG;CAEpC,MAAM,eAAe,OAAO,IAAI,WAAW,KAAK;CAChD,IAAI;CACJ,IAAI;CACJ,IAAI,iBAAiB,UAAU;EAG9B,WAAW,MAAM,gBAAgB,GAAG;EACpC,MAAM,SAAS,WAAW,OAAO,IAAI,MAAM,GAAG,OAAO,IAAI,IAAI,GAAG,QAAQ;EACxE,IAAI,CAAC,OAAO,IACX,OAAO,cACN,KACA,OAAO,UACJ,eACA,kBACA,iDACA,OAAO,KACR,IACC,eACA,iBACA,iDACA,OAAO,KACR,CACH;EAED,QAAQ,OAAO;CAChB;CACA,MAAM,YAA6B,kBAAkB,YAAY,IAAI,eAAe;CACpF,MAAM,SACL,eAAe,OAAO,IAAI,QAAQ,CAAC,KAAK,YAAY,QAAQ,SAAS,WAAW,EAAE,MAAM;CACzF,MAAM,YAAY,aAAa,OAAO,IAAI,SAAS,CAAC;CACpD,MAAM,UACL,cACC,WAAW,SAAS,qBAAqB;EAAC;EAAa;EAAY;EAAY;CAAa;CAE9F,MAAM,kBACL,aAAa,OAAO,IAAI,UAAU,CAAC,MAClC,cAAc,OACZ,WAAW,SACV,8BACA,8BACD,CAAC;CACL,MAAM,aAAa,kBAAkB,OAAO,IAAI,YAAY,GAAG,oBAAoB;CACnF,MAAM,WAAW,iBAAiB,OAAO,IAAI,OAAO,CAAC;CACrD,MAAM,QAAQ,aAAa,KAAA,IAAY,KAAA,IAAY,KAAK,IAAI,KAAK,IAAI,UAAU,CAAC,GAAG,cAAc;CACjG,MAAM,QAAQ,MAAM,qBAAqB;EAAE;EAAK;EAAY;CAAG,CAAC;CAChE,IAAI,CAAC,MAAM,IACV,OAAO,yBAAyB,MAAM,MAAM;CAI7C,MAAM,QAAQ,YAAY;EACzB,UAAU;EACV,GAAI,OAAO,IAAI,OAAO,MAAM,MAAM,EAAE,YAAY,MAAM,IAAI,CAAC;CAC5D,CAAC;CACD,MAAM,SAAS,MAAM,cACpB;EACC;EACA,gBAAgB;EAChB,MAAM,MAAM;EACZ;EACA;EACA;EACA;EACA,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC7C,GAAI,WAAW,SAAS,IAAI,EAAE,WAAW,IAAI,CAAC;EAC9C,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACvC,WAAW,OAAO,IAAI,YAAY,KAAK,KAAA;EAEvC,wBAAwB;EACxB,KAAK,YAAY;EACjB,SAAS,OAAO,IAAI,SAAS,MAAM;EACnC,QAAQ,OAAO,IAAI,QAAQ,MAAM;EACjC;CACD,GACA,KACD;CACA,IAAI,OAAO,gBACV,OAAO,uBAAuB;CAE/B,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;AACnD"}
@@ -0,0 +1,37 @@
1
+ import { scopeGates } from "./runtime.js";
2
+ import { resolveRequestedScope } from "../core/scopedRead.js";
3
+ import { scopeFromDocument } from "../fields/documentScope.js";
4
+ //#region src/plugin/documentScopes.ts
5
+ /**
6
+ * Field a collection's documents carry their scope in: the binding's server-side `scopeField`, so
7
+ * no request can choose which field a scope is read out of.
8
+ */
9
+ const scopeFieldFor = (runtime, collection) => runtime.bindings[collection]?.scopeField ?? false;
10
+ /**
11
+ * A document's scope, gated via {@link resolveRequestedScope} like a named `scope` parameter.
12
+ * Payload read access is a separate first gate: a readable foreign row still reports nothing.
13
+ */
14
+ const resolveDocumentScope = async (args) => {
15
+ const { runtime, req } = args;
16
+ const scope = scopeFromDocument(args.data, scopeFieldFor(runtime, args.collection));
17
+ if (scope === null) return {
18
+ ok: true,
19
+ scope: null
20
+ };
21
+ const requested = await resolveRequestedScope({
22
+ runtime,
23
+ req,
24
+ raw: scope,
25
+ gates: args.gates ?? scopeGates(runtime, req)
26
+ });
27
+ if (!requested.ok || requested.scope === null) return { ok: false };
28
+ return {
29
+ ok: true,
30
+ scope: requested.scope,
31
+ gated: requested.gated
32
+ };
33
+ };
34
+ //#endregion
35
+ export { resolveDocumentScope };
36
+
37
+ //# sourceMappingURL=documentScopes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"documentScopes.js","names":[],"sources":["../../src/plugin/documentScopes.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { GatedScope } from '../access/principal'\nimport type { BindingDoc, DocumentScopeField } from '../binding/types'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport { scopeFromDocument } from '../fields/documentScope'\nimport { type AnalyticsRuntime, type ScopeGates, scopeGates } from './runtime'\n\n/**\n * Field a collection's documents carry their scope in: the binding's server-side `scopeField`, so\n * no request can choose which field a scope is read out of.\n */\nexport const scopeFieldFor = (runtime: AnalyticsRuntime, collection: string): DocumentScopeField =>\n\truntime.bindings[collection]?.scopeField ?? false\n\n/**\n * A document's own scope, or a refusal to read across into it. `gated` is that scope cleared\n * for the request, absent when the document names none and the read stays on the request's own.\n */\nexport type DocumentScope =\n\t| { ok: true; scope: null }\n\t| { ok: true; scope: string; gated: GatedScope }\n\t| { ok: false }\n\ninterface DocumentScopeArgs {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tcollection: string\n\tdata: BindingDoc\n\t/** Shared cross-scope decisions; one set is created per call when omitted. */\n\tgates?: ScopeGates\n}\n\n/**\n * A document's scope, gated via {@link resolveRequestedScope} like a named `scope` parameter.\n * Payload read access is a separate first gate: a readable foreign row still reports nothing.\n */\nexport const resolveDocumentScope = async (args: DocumentScopeArgs): Promise<DocumentScope> => {\n\tconst { runtime, req } = args\n\tconst scope = scopeFromDocument(args.data, scopeFieldFor(runtime, args.collection))\n\tif (scope === null) {\n\t\treturn { ok: true, scope: null }\n\t}\n\tconst requested = await resolveRequestedScope({\n\t\truntime,\n\t\treq,\n\t\traw: scope,\n\t\tgates: args.gates ?? scopeGates(runtime, req),\n\t})\n\tif (!requested.ok || requested.scope === null) {\n\t\treturn { ok: false }\n\t}\n\treturn { ok: true, scope: requested.scope, gated: requested.gated }\n}\n"],"mappings":";;;;;;;;AAWA,MAAa,iBAAiB,SAA2B,eACxD,QAAQ,SAAS,aAAa,cAAc;;;;;AAwB7C,MAAa,uBAAuB,OAAO,SAAoD;CAC9F,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,QAAQ,kBAAkB,KAAK,MAAM,cAAc,SAAS,KAAK,UAAU,CAAC;CAClF,IAAI,UAAU,MACb,OAAO;EAAE,IAAI;EAAM,OAAO;CAAK;CAEhC,MAAM,YAAY,MAAM,sBAAsB;EAC7C;EACA;EACA,KAAK;EACL,OAAO,KAAK,SAAS,WAAW,SAAS,GAAG;CAC7C,CAAC;CACD,IAAI,CAAC,UAAU,MAAM,UAAU,UAAU,MACxC,OAAO,EAAE,IAAI,MAAM;CAEpB,OAAO;EAAE,IAAI;EAAM,OAAO,UAAU;EAAO,OAAO,UAAU;CAAM;AACnE"}
@@ -0,0 +1,25 @@
1
+ import { hasMethods } from "../core/values.js";
2
+ import { peerError } from "./peers.js";
3
+ //#region src/plugin/encrypted.ts
4
+ const HELPERS = [
5
+ "decryptFieldValue",
6
+ "encryptedField",
7
+ "isSealed",
8
+ "validateEncryptedBoot",
9
+ "withEncryptedQueryRewrite",
10
+ "withRawEncrypted"
11
+ ];
12
+ const isEncryptedModule = (mod) => hasMethods(mod, HELPERS);
13
+ /**
14
+ * The encrypted field helpers the providers collection is built on. A literal specifier, so file
15
+ * tracing ships the required peer and a bundler resolves the one copy the host's imports use.
16
+ */
17
+ const loadEncrypted = async () => {
18
+ const mod = await import("@10x-media/fields/encrypted");
19
+ if (!isEncryptedModule(mod)) throw new Error(peerError("@10x-media/fields", "has no encrypted field helpers. Update it: pnpm add @10x-media/fields@latest"));
20
+ return mod;
21
+ };
22
+ //#endregion
23
+ export { loadEncrypted };
24
+
25
+ //# sourceMappingURL=encrypted.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"encrypted.js","names":[],"sources":["../../src/plugin/encrypted.ts"],"sourcesContent":["import { hasMethods } from '../core/values'\nimport { peerError } from './peers'\n\ntype EncryptedModule = typeof import('@10x-media/fields/encrypted')\n\nconst HELPERS: readonly string[] = [\n\t'decryptFieldValue',\n\t'encryptedField',\n\t'isSealed',\n\t'validateEncryptedBoot',\n\t'withEncryptedQueryRewrite',\n\t'withRawEncrypted',\n]\n\nconst isEncryptedModule = (mod: unknown): mod is EncryptedModule => hasMethods(mod, HELPERS)\n\n/**\n * The encrypted field helpers the providers collection is built on. A literal specifier, so file\n * tracing ships the required peer and a bundler resolves the one copy the host's imports use.\n */\nexport const loadEncrypted = async (): Promise<EncryptedModule> => {\n\tconst mod: unknown = await import('@10x-media/fields/encrypted')\n\tif (!isEncryptedModule(mod)) {\n\t\tthrow new Error(\n\t\t\tpeerError(\n\t\t\t\t'@10x-media/fields',\n\t\t\t\t'has no encrypted field helpers. Update it: pnpm add @10x-media/fields@latest'\n\t\t\t)\n\t\t)\n\t}\n\treturn mod\n}\n"],"mappings":";;;AAKA,MAAM,UAA6B;CAClC;CACA;CACA;CACA;CACA;CACA;AACD;AAEA,MAAM,qBAAqB,QAAyC,WAAW,KAAK,OAAO;;;;;AAM3F,MAAa,gBAAgB,YAAsC;CAClE,MAAM,MAAe,MAAM,OAAO;CAClC,IAAI,CAAC,kBAAkB,GAAG,GACzB,MAAM,IAAI,MACT,UACC,qBACA,8EACD,CACD;CAED,OAAO;AACR"}
@@ -0,0 +1,24 @@
1
+ //#region src/plugin/errors.d.ts
2
+ /**
3
+ * Every code an analytics endpoint answers with, so no handler invents one only its client knows.
4
+ * Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.
5
+ */
6
+ declare const ANALYTICS_ERROR_CODES: readonly ["invalid_param", "unsupported_metric", "unsupported_dimension", "unsupported_filter", "unsupported_operator", "unsupported_granularity", "range_too_long", "unknown_source", "untrusted_scope", "not_found", "payload_too_large", "unauthorized", "forbidden", "rate_limited", "source_misconfigured", "unavailable", "internal"];
7
+ type AnalyticsErrorCode = (typeof ANALYTICS_ERROR_CODES)[number];
8
+ /** Wire shape of a refused request: `param` names the parameter or field at fault. */
9
+ interface AnalyticsError {
10
+ code: AnalyticsErrorCode;
11
+ message: string;
12
+ param?: string;
13
+ }
14
+ declare const analyticsError: (code: AnalyticsErrorCode, message: string, param?: string) => AnalyticsError;
15
+ /** The code an endpoint answered with, or undefined when the body is not the envelope. */
16
+ declare const readErrorCode: (body: unknown) => AnalyticsErrorCode | undefined;
17
+ /**
18
+ * {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than
19
+ * throwing, since the status still carries the failure.
20
+ */
21
+ declare const readResponseError: (res: Response) => Promise<AnalyticsError | undefined>;
22
+ //#endregion
23
+ export { ANALYTICS_ERROR_CODES, AnalyticsError, AnalyticsErrorCode, analyticsError, readErrorCode, readResponseError };
24
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1,86 @@
1
+ import { isRecord } from "../core/values.js";
2
+ //#region src/plugin/errors.ts
3
+ /**
4
+ * Every code an analytics endpoint answers with, so no handler invents one only its client knows.
5
+ * Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.
6
+ */
7
+ const ANALYTICS_ERROR_CODES = [
8
+ "invalid_param",
9
+ "unsupported_metric",
10
+ "unsupported_dimension",
11
+ "unsupported_filter",
12
+ "unsupported_operator",
13
+ "unsupported_granularity",
14
+ "range_too_long",
15
+ "unknown_source",
16
+ "untrusted_scope",
17
+ "not_found",
18
+ "payload_too_large",
19
+ "unauthorized",
20
+ "forbidden",
21
+ "rate_limited",
22
+ "source_misconfigured",
23
+ "unavailable",
24
+ "internal"
25
+ ];
26
+ const analyticsError = (code, message, param) => ({
27
+ code,
28
+ message,
29
+ ...param === void 0 ? {} : { param }
30
+ });
31
+ /** Scope depends on the caller's cookies, so no shared cache may ever hold an answer. */
32
+ const NO_STORE = { "Cache-Control": "private, no-store" };
33
+ /** How long a client should wait out a provider outage before retrying the same read. */
34
+ const RETRY_AFTER = { "Retry-After": "30" };
35
+ /**
36
+ * A `Retry-After` header for a wait in milliseconds, in whole seconds and never below 1; the
37
+ * default 30 seconds when the wait is unknown.
38
+ */
39
+ const retryAfter = (ms) => ms === void 0 ? RETRY_AFTER : { "Retry-After": String(Math.max(1, Math.ceil(ms / 1e3))) };
40
+ /** An endpoint's error answer: coded body, never cached, headers merged over `NO_STORE`. */
41
+ const errorResponse = (status, error, headers = {}) => Response.json({ error }, {
42
+ status,
43
+ headers: {
44
+ ...NO_STORE,
45
+ ...headers
46
+ }
47
+ });
48
+ /** 401 for a request with no signed-in user. */
49
+ const unauthorizedResponse = () => errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
50
+ /** 403 for a reader `access.read` turns away. */
51
+ const readDeniedResponse = () => errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
52
+ /** 503 while no runtime is registered; as retryable as a provider outage, so it waits as long. */
53
+ const notAvailableResponse = () => errorResponse(503, analyticsError("unavailable", "analytics: not available"), RETRY_AFTER);
54
+ /** 400 for a scope the request may not read; `param` names the parameter that carried it. */
55
+ const untrustedScopeResponse = (param) => errorResponse(400, analyticsError("untrusted_scope", "analytics: scope is not permitted for this request", param));
56
+ const CODES = new Set(ANALYTICS_ERROR_CODES);
57
+ const isErrorCode = (value) => CODES.has(value);
58
+ /**
59
+ * The error in a parsed body, or undefined for a non-envelope body or a code this version never
60
+ * sent, so a newer server's code reads as a generic failure rather than a lie.
61
+ */
62
+ const readError = (body) => {
63
+ if (!isRecord(body)) return;
64
+ const error = body.error;
65
+ if (!isRecord(error)) return;
66
+ const { code, message, param } = error;
67
+ if (typeof code !== "string" || !isErrorCode(code) || typeof message !== "string") return;
68
+ return analyticsError(code, message, typeof param === "string" ? param : void 0);
69
+ };
70
+ /** The code an endpoint answered with, or undefined when the body is not the envelope. */
71
+ const readErrorCode = (body) => readError(body)?.code;
72
+ /**
73
+ * {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than
74
+ * throwing, since the status still carries the failure.
75
+ */
76
+ const readResponseError = async (res) => {
77
+ try {
78
+ return readError(await res.json());
79
+ } catch {
80
+ return;
81
+ }
82
+ };
83
+ //#endregion
84
+ export { ANALYTICS_ERROR_CODES, NO_STORE, RETRY_AFTER, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, readErrorCode, readResponseError, retryAfter, unauthorizedResponse, untrustedScopeResponse };
85
+
86
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","names":[],"sources":["../../src/plugin/errors.ts"],"sourcesContent":["import { isRecord } from '../core/values'\n\n/**\n * Every code an analytics endpoint answers with, so no handler invents one only its client knows.\n * Free of Payload and Node imports: admin clients import {@link readErrorCode} from here.\n */\nexport const ANALYTICS_ERROR_CODES = [\n\t'invalid_param',\n\t'unsupported_metric',\n\t'unsupported_dimension',\n\t'unsupported_filter',\n\t'unsupported_operator',\n\t'unsupported_granularity',\n\t'range_too_long',\n\t'unknown_source',\n\t'untrusted_scope',\n\t'not_found',\n\t'payload_too_large',\n\t'unauthorized',\n\t'forbidden',\n\t'rate_limited',\n\t'source_misconfigured',\n\t'unavailable',\n\t'internal',\n] as const\n\nexport type AnalyticsErrorCode = (typeof ANALYTICS_ERROR_CODES)[number]\n\n/** Wire shape of a refused request: `param` names the parameter or field at fault. */\nexport interface AnalyticsError {\n\tcode: AnalyticsErrorCode\n\tmessage: string\n\tparam?: string\n}\n\nexport const analyticsError = (\n\tcode: AnalyticsErrorCode,\n\tmessage: string,\n\tparam?: string\n): AnalyticsError => ({\n\tcode,\n\tmessage,\n\t...(param === undefined ? {} : { param }),\n})\n\n/** Scope depends on the caller's cookies, so no shared cache may ever hold an answer. */\nexport const NO_STORE = { 'Cache-Control': 'private, no-store' }\n\n/** How long a client should wait out a provider outage before retrying the same read. */\nexport const RETRY_AFTER = { 'Retry-After': '30' }\n\n/**\n * A `Retry-After` header for a wait in milliseconds, in whole seconds and never below 1; the\n * default 30 seconds when the wait is unknown.\n */\nexport const retryAfter = (ms: number | undefined): Record<'Retry-After', string> =>\n\tms === undefined ? RETRY_AFTER : { 'Retry-After': String(Math.max(1, Math.ceil(ms / 1000))) }\n\n/** An endpoint's error answer: coded body, never cached, headers merged over `NO_STORE`. */\nexport const errorResponse = (\n\tstatus: number,\n\terror: AnalyticsError,\n\theaders: Record<string, string> = {}\n): Response => Response.json({ error }, { status, headers: { ...NO_STORE, ...headers } })\n\n/** 401 for a request with no signed-in user. */\nexport const unauthorizedResponse = (): Response =>\n\terrorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\n\n/** 403 for a reader `access.read` turns away. */\nexport const readDeniedResponse = (): Response =>\n\terrorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\n/** 503 while no runtime is registered; as retryable as a provider outage, so it waits as long. */\nexport const notAvailableResponse = (): Response =>\n\terrorResponse(503, analyticsError('unavailable', 'analytics: not available'), RETRY_AFTER)\n\n/** 400 for a scope the request may not read; `param` names the parameter that carried it. */\nexport const untrustedScopeResponse = (param?: string): Response =>\n\terrorResponse(\n\t\t400,\n\t\tanalyticsError('untrusted_scope', 'analytics: scope is not permitted for this request', param)\n\t)\n\nconst CODES: ReadonlySet<string> = new Set<AnalyticsErrorCode>(ANALYTICS_ERROR_CODES)\n\nconst isErrorCode = (value: string): value is AnalyticsErrorCode => CODES.has(value)\n\n/**\n * The error in a parsed body, or undefined for a non-envelope body or a code this version never\n * sent, so a newer server's code reads as a generic failure rather than a lie.\n */\nexport const readError = (body: unknown): AnalyticsError | undefined => {\n\tif (!isRecord(body)) {\n\t\treturn undefined\n\t}\n\tconst error: unknown = body.error\n\tif (!isRecord(error)) {\n\t\treturn undefined\n\t}\n\tconst { code, message, param } = error\n\tif (typeof code !== 'string' || !isErrorCode(code) || typeof message !== 'string') {\n\t\treturn undefined\n\t}\n\treturn analyticsError(code, message, typeof param === 'string' ? param : undefined)\n}\n\n/** The code an endpoint answered with, or undefined when the body is not the envelope. */\nexport const readErrorCode = (body: unknown): AnalyticsErrorCode | undefined =>\n\treadError(body)?.code\n\n/**\n * {@link readError} over an unread response. A non-JSON or empty body reads as no error rather than\n * throwing, since the status still carries the failure.\n */\nexport const readResponseError = async (res: Response): Promise<AnalyticsError | undefined> => {\n\ttry {\n\t\treturn readError(await res.json())\n\t} catch {\n\t\treturn undefined\n\t}\n}\n"],"mappings":";;;;;;AAMA,MAAa,wBAAwB;CACpC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;AAWA,MAAa,kBACZ,MACA,SACA,WACqB;CACrB;CACA;CACA,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;AACxC;;AAGA,MAAa,WAAW,EAAE,iBAAiB,oBAAoB;;AAG/D,MAAa,cAAc,EAAE,eAAe,KAAK;;;;;AAMjD,MAAa,cAAc,OAC1B,OAAO,KAAA,IAAY,cAAc,EAAE,eAAe,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,GAAI,CAAC,CAAC,EAAE;;AAG7F,MAAa,iBACZ,QACA,OACA,UAAkC,CAAC,MACrB,SAAS,KAAK,EAAE,MAAM,GAAG;CAAE;CAAQ,SAAS;EAAE,GAAG;EAAU,GAAG;CAAQ;AAAE,CAAC;;AAGxF,MAAa,6BACZ,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;;AAGxF,MAAa,2BACZ,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;;AAGhF,MAAa,6BACZ,cAAc,KAAK,eAAe,eAAe,0BAA0B,GAAG,WAAW;;AAG1F,MAAa,0BAA0B,UACtC,cACC,KACA,eAAe,mBAAmB,sDAAsD,KAAK,CAC9F;AAED,MAAM,QAA6B,IAAI,IAAwB,qBAAqB;AAEpF,MAAM,eAAe,UAA+C,MAAM,IAAI,KAAK;;;;;AAMnF,MAAa,aAAa,SAA8C;CACvE,IAAI,CAAC,SAAS,IAAI,GACjB;CAED,MAAM,QAAiB,KAAK;CAC5B,IAAI,CAAC,SAAS,KAAK,GAClB;CAED,MAAM,EAAE,MAAM,SAAS,UAAU;CACjC,IAAI,OAAO,SAAS,YAAY,CAAC,YAAY,IAAI,KAAK,OAAO,YAAY,UACxE;CAED,OAAO,eAAe,MAAM,SAAS,OAAO,UAAU,WAAW,QAAQ,KAAA,CAAS;AACnF;;AAGA,MAAa,iBAAiB,SAC7B,UAAU,IAAI,GAAG;;;;;AAMlB,MAAa,oBAAoB,OAAO,QAAuD;CAC9F,IAAI;EACH,OAAO,UAAU,MAAM,IAAI,KAAK,CAAC;CAClC,QAAQ;EACP;CACD;AACD"}
@@ -0,0 +1,41 @@
1
+ import { analyticsError, errorResponse } from "./errors.js";
2
+ //#region src/plugin/flagsEndpoint.ts
3
+ let loading;
4
+ /**
5
+ * Flags as SVG strings, loaded lazily: the entry is a barrel of some 300 modules that every route
6
+ * importing the config would pull in. A failed import is not cached, so later requests retry.
7
+ */
8
+ const flagsByCode = () => {
9
+ loading ??= import("country-flag-icons/string/3x2").then((module) => new Map(Object.entries(module))).catch((err) => {
10
+ loading = void 0;
11
+ throw err;
12
+ });
13
+ return loading;
14
+ };
15
+ const CODE = /^[A-Za-z]{2}$/;
16
+ const SVG_HEADERS = {
17
+ "Content-Type": "image/svg+xml; charset=utf-8",
18
+ "Cache-Control": "public, max-age=31536000, immutable",
19
+ "X-Content-Type-Options": "nosniff",
20
+ "Content-Security-Policy": "default-src 'none'; style-src 'unsafe-inline'"
21
+ };
22
+ /**
23
+ * Public GET serving one country flag SVG, so the admin bundle ships no flag artwork.
24
+ * Unauthenticated on purpose: it reads only a static map, never data, user or scope.
25
+ */
26
+ const makeFlagsHandler = () => async (req) => {
27
+ const raw = req.routeParams?.code;
28
+ const param = typeof raw === "string" ? raw : "";
29
+ const code = param.endsWith(".svg") ? param.slice(0, -4) : param;
30
+ if (!CODE.test(code)) return errorResponse(400, analyticsError("invalid_param", "analytics: flag code must be two letters", "code"));
31
+ const svg = (await flagsByCode()).get(code.toUpperCase());
32
+ if (svg === void 0) return errorResponse(404, analyticsError("not_found", `analytics: no flag for "${code.toUpperCase()}"`));
33
+ return new Response(svg, {
34
+ headers: SVG_HEADERS,
35
+ status: 200
36
+ });
37
+ };
38
+ //#endregion
39
+ export { makeFlagsHandler };
40
+
41
+ //# sourceMappingURL=flagsEndpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flagsEndpoint.js","names":[],"sources":["../../src/plugin/flagsEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { analyticsError, errorResponse } from './errors'\n\nlet loading: Promise<Map<string, string>> | undefined\n\n/**\n * Flags as SVG strings, loaded lazily: the entry is a barrel of some 300 modules that every route\n * importing the config would pull in. A failed import is not cached, so later requests retry.\n */\nconst flagsByCode = (): Promise<Map<string, string>> => {\n\tloading ??= import('country-flag-icons/string/3x2')\n\t\t.then((module) => new Map<string, string>(Object.entries(module)))\n\t\t.catch((err: unknown) => {\n\t\t\tloading = undefined\n\t\t\tthrow err\n\t\t})\n\treturn loading\n}\n\nconst CODE = /^[A-Za-z]{2}$/\n\nconst SVG_HEADERS: Record<string, string> = {\n\t'Content-Type': 'image/svg+xml; charset=utf-8',\n\t// A flag is keyed by its country code and only ever changes in a new release of the\n\t// package, so the URL itself is the version and the answer never needs revalidating.\n\t'Cache-Control': 'public, max-age=31536000, immutable',\n\t'X-Content-Type-Options': 'nosniff',\n\t// Opened directly rather than through an <img>, an SVG is a document that can run\n\t// script. This one is denied everything but the inline fills the artwork needs.\n\t'Content-Security-Policy': \"default-src 'none'; style-src 'unsafe-inline'\",\n}\n\n/**\n * Public GET serving one country flag SVG, so the admin bundle ships no flag artwork.\n * Unauthenticated on purpose: it reads only a static map, never data, user or scope.\n */\nexport const makeFlagsHandler = (): PayloadHandler => async (req) => {\n\tconst raw = req.routeParams?.code\n\tconst param = typeof raw === 'string' ? raw : ''\n\tconst code = param.endsWith('.svg') ? param.slice(0, -'.svg'.length) : param\n\t// Checked before the artwork is loaded, so a malformed code costs nothing at all.\n\tif (!CODE.test(code)) {\n\t\treturn errorResponse(\n\t\t\t400,\n\t\t\tanalyticsError('invalid_param', 'analytics: flag code must be two letters', 'code')\n\t\t)\n\t}\n\tconst svg = (await flagsByCode()).get(code.toUpperCase())\n\tif (svg === undefined) {\n\t\treturn errorResponse(\n\t\t\t404,\n\t\t\tanalyticsError('not_found', `analytics: no flag for \"${code.toUpperCase()}\"`)\n\t\t)\n\t}\n\treturn new Response(svg, { headers: SVG_HEADERS, status: 200 })\n}\n"],"mappings":";;AAGA,IAAI;;;;;AAMJ,MAAM,oBAAkD;CACvD,YAAY,OAAO,iCACjB,MAAM,WAAW,IAAI,IAAoB,OAAO,QAAQ,MAAM,CAAC,CAAC,EAChE,OAAO,QAAiB;EACxB,UAAU,KAAA;EACV,MAAM;CACP,CAAC;CACF,OAAO;AACR;AAEA,MAAM,OAAO;AAEb,MAAM,cAAsC;CAC3C,gBAAgB;CAGhB,iBAAiB;CACjB,0BAA0B;CAG1B,2BAA2B;AAC5B;;;;;AAMA,MAAa,yBAAyC,OAAO,QAAQ;CACpE,MAAM,MAAM,IAAI,aAAa;CAC7B,MAAM,QAAQ,OAAO,QAAQ,WAAW,MAAM;CAC9C,MAAM,OAAO,MAAM,SAAS,MAAM,IAAI,MAAM,MAAM,GAAG,EAAc,IAAI;CAEvE,IAAI,CAAC,KAAK,KAAK,IAAI,GAClB,OAAO,cACN,KACA,eAAe,iBAAiB,4CAA4C,MAAM,CACnF;CAED,MAAM,OAAO,MAAM,YAAY,GAAG,IAAI,KAAK,YAAY,CAAC;CACxD,IAAI,QAAQ,KAAA,GACX,OAAO,cACN,KACA,eAAe,aAAa,2BAA2B,KAAK,YAAY,EAAE,EAAE,CAC7E;CAED,OAAO,IAAI,SAAS,KAAK;EAAE,SAAS;EAAa,QAAQ;CAAI,CAAC;AAC/D"}
@@ -1,24 +1,35 @@
1
- import { resolveGoalsFor } from "./runtime.js";
1
+ import { goalNamesFor, resolveGoalsDetailedFor } from "./runtime.js";
2
2
  //#region src/plugin/goalHint.ts
3
- /** A read whose numbers are goal completions: the `goal` breakdown, or the `conversions` metric. */
4
3
  const needsGoalHint = (read) => read.metrics.includes("conversions") || (read.dimensions ?? []).includes("goal");
5
4
  /**
6
- * The scope's goal slugs for a read that asks about goals, and undefined for every other
7
- * read, which no adapter restricts. An empty list is an install with no goals, which reads
8
- * as an empty result; a resolver that throws hints `'unresolved'` instead, so the read
9
- * costs only its goal rows (the provider answers `goalsUnresolved`) and is neither cached
10
- * as a healthy answer nor mistaken for an install that configured nothing.
5
+ * Goal hint for a read about goals, else undefined. A throwing resolver hints `'unresolved'`, which
6
+ * is never cached as healthy nor mistaken for an install with no goals.
11
7
  */
12
- const goalSlugsFor = async (args) => {
8
+ const goalHintFor = async (args) => {
13
9
  if (!needsGoalHint(args)) return;
14
10
  try {
15
- return (await resolveGoalsFor(args.runtime, args.req, args.scope)).map((goal) => goal.slug);
11
+ const goals = await resolveGoalsDetailedFor(args.runtime, args.req, args.scope);
12
+ const names = await goalNamesFor({
13
+ ...args,
14
+ resolved: goals
15
+ });
16
+ return {
17
+ slugs: goals.map(({ goal }) => goal.slug),
18
+ builtin: goals.filter((entry) => entry.source === "builtin").map(({ goal }) => goal.slug),
19
+ names
20
+ };
16
21
  } catch (err) {
17
22
  args.req.payload.logger?.warn(`analytics: goal slugs failed to resolve: ${String(err)}`);
18
- return "unresolved";
23
+ return {
24
+ slugs: "unresolved",
25
+ builtin: [],
26
+ names: []
27
+ };
19
28
  }
20
29
  };
30
+ /** The hint's slugs alone, for a caller that never lists goal rows of its own. */
31
+ const goalSlugsFor = async (args) => (await goalHintFor(args))?.slugs;
21
32
  //#endregion
22
- export { goalSlugsFor };
33
+ export { goalHintFor, goalSlugsFor };
23
34
 
24
35
  //# sourceMappingURL=goalHint.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"goalHint.js","names":[],"sources":["../../src/plugin/goalHint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport { type AnalyticsRuntime, resolveGoalsFor } from './runtime'\n\n/** What a read asks for, which is all the hint needs to know whether goals are involved. */\nexport interface GoalRead {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n}\n\nexport interface GoalSlugsArgs extends GoalRead {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's own scope; goals are resolved per scope. */\n\tscope: string | null | undefined\n}\n\n/** A read whose numbers are goal completions: the `goal` breakdown, or the `conversions` metric. */\nexport const needsGoalHint = (read: GoalRead): boolean =>\n\tread.metrics.includes('conversions') || (read.dimensions ?? []).includes('goal')\n\n/**\n * The scope's goal slugs for a read that asks about goals, and undefined for every other\n * read, which no adapter restricts. An empty list is an install with no goals, which reads\n * as an empty result; a resolver that throws hints `'unresolved'` instead, so the read\n * costs only its goal rows (the provider answers `goalsUnresolved`) and is neither cached\n * as a healthy answer nor mistaken for an install that configured nothing.\n */\nexport const goalSlugsFor = async (\n\targs: GoalSlugsArgs\n): Promise<string[] | 'unresolved' | undefined> => {\n\tif (!needsGoalHint(args)) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\tconst goals = await resolveGoalsFor(args.runtime, args.req, args.scope)\n\t\treturn goals.map((goal) => goal.slug)\n\t} catch (err) {\n\t\targs.req.payload.logger?.warn(`analytics: goal slugs failed to resolve: ${String(err)}`)\n\t\treturn 'unresolved'\n\t}\n}\n"],"mappings":";;;AAkBA,MAAa,iBAAiB,SAC7B,KAAK,QAAQ,SAAS,aAAa,MAAM,KAAK,cAAc,CAAC,GAAG,SAAS,MAAM;;;;;;;;AAShF,MAAa,eAAe,OAC3B,SACkD;CAClD,IAAI,CAAC,cAAc,IAAI,GACtB;CAED,IAAI;EAEH,QAAO,MADa,gBAAgB,KAAK,SAAS,KAAK,KAAK,KAAK,KAAK,GACzD,KAAK,SAAS,KAAK,IAAI;CACrC,SAAS,KAAK;EACb,KAAK,IAAI,QAAQ,QAAQ,KAAK,4CAA4C,OAAO,GAAG,GAAG;EACvF,OAAO;CACR;AACD"}
1
+ {"version":3,"file":"goalHint.js","names":[],"sources":["../../src/plugin/goalHint.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport { type AnalyticsRuntime, goalNamesFor, resolveGoalsDetailedFor } from './runtime'\n\n/** The slice of a read that decides whether it is about goals. */\nexport interface GoalRead {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n}\n\ninterface GoalSlugsArgs extends GoalRead {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\t/** The read's own scope; goals are resolved per scope. */\n\tscope: string | null | undefined\n}\n\nconst needsGoalHint = (read: GoalRead): boolean =>\n\tread.metrics.includes('conversions') || (read.dimensions ?? []).includes('goal')\n\ninterface ResolvedGoalHint {\n\t/** Every slug the read restricts to, the latent built-in goal included. */\n\tslugs: string[] | 'unresolved'\n\t/**\n\t * Which of those slugs the install did not declare: the built-in `purchase` goal, which\n\t * counts at ingest but is not a goal a report may list until it has conversions.\n\t */\n\tbuiltin: string[]\n\t/**\n\t * Every resolved goal's name, so a report lists a goal by name rather than by its slug; for a\n\t * read spanning every scope, the names of every scope's goals the reader may see.\n\t */\n\tnames: Array<{ slug: string; name: string }>\n}\n\n/**\n * Goal hint for a read about goals, else undefined. A throwing resolver hints `'unresolved'`, which\n * is never cached as healthy nor mistaken for an install with no goals.\n */\nexport const goalHintFor = async (args: GoalSlugsArgs): Promise<ResolvedGoalHint | undefined> => {\n\tif (!needsGoalHint(args)) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\tconst goals = await resolveGoalsDetailedFor(args.runtime, args.req, args.scope)\n\t\tconst names = await goalNamesFor({ ...args, resolved: goals })\n\t\treturn {\n\t\t\tslugs: goals.map(({ goal }) => goal.slug),\n\t\t\tbuiltin: goals.filter((entry) => entry.source === 'builtin').map(({ goal }) => goal.slug),\n\t\t\tnames,\n\t\t}\n\t} catch (err) {\n\t\targs.req.payload.logger?.warn(`analytics: goal slugs failed to resolve: ${String(err)}`)\n\t\treturn { slugs: 'unresolved', builtin: [], names: [] }\n\t}\n}\n\n/** The hint's slugs alone, for a caller that never lists goal rows of its own. */\nexport const goalSlugsFor = async (\n\targs: GoalSlugsArgs\n): Promise<string[] | 'unresolved' | undefined> => (await goalHintFor(args))?.slugs\n"],"mappings":";;AAiBA,MAAM,iBAAiB,SACtB,KAAK,QAAQ,SAAS,aAAa,MAAM,KAAK,cAAc,CAAC,GAAG,SAAS,MAAM;;;;;AAqBhF,MAAa,cAAc,OAAO,SAA+D;CAChG,IAAI,CAAC,cAAc,IAAI,GACtB;CAED,IAAI;EACH,MAAM,QAAQ,MAAM,wBAAwB,KAAK,SAAS,KAAK,KAAK,KAAK,KAAK;EAC9E,MAAM,QAAQ,MAAM,aAAa;GAAE,GAAG;GAAM,UAAU;EAAM,CAAC;EAC7D,OAAO;GACN,OAAO,MAAM,KAAK,EAAE,WAAW,KAAK,IAAI;GACxC,SAAS,MAAM,QAAQ,UAAU,MAAM,WAAW,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,IAAI;GACxF;EACD;CACD,SAAS,KAAK;EACb,KAAK,IAAI,QAAQ,QAAQ,KAAK,4CAA4C,OAAO,GAAG,GAAG;EACvF,OAAO;GAAE,OAAO;GAAc,SAAS,CAAC;GAAG,OAAO,CAAC;EAAE;CACtD;AACD;;AAGA,MAAa,eAAe,OAC3B,UACmD,MAAM,YAAY,IAAI,IAAI"}