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

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 (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  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 +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  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 +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  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 +336 -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 +76 -53
  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 +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  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/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1,27 +1,34 @@
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 { NO_STORE, RETRY_AFTER, analyticsError, errorResponse } from "./errors.js";
6
- 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";
7
13
  import { parseDayOrInstant } from "../query/dates.js";
8
- import { APIError } from "payload";
14
+ import { readDimensionList } from "../query/parse.js";
15
+ import { resolveBoundDocument, unloadedDocumentResponse } from "./boundDocument.js";
16
+ import { queryParams } from "./queryParams.js";
9
17
  //#region src/plugin/documentEndpoint.ts
10
- const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
11
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"];
12
24
  const parseMetrics = (raw) => {
13
25
  if (!raw) return null;
14
- 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);
15
27
  return metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null;
16
28
  };
17
29
  /**
18
- * A custom window from the query string, read exactly like the query endpoint's: a
19
- * `YYYY-MM-DD` day is the whole calendar day in the reporting timezone (`to` inclusive of
20
- * its final instant), a datetime must carry `Z` or a `±HH:MM` offset, and anything else,
21
- * including an offset-less datetime, is rejected. `from` equal to `to` is one whole day for
22
- * day strings and a zero-width window for two instants, so only the latter is rejected. A
23
- * rejection names the bound at fault, and an inverted window blames `to`: `from` is the one
24
- * the reader picked first.
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.
25
32
  */
26
33
  const parseRange = (from, to, timezone) => {
27
34
  if (!from) return {
@@ -48,6 +55,14 @@ const parseRange = (from, to, timezone) => {
48
55
  ok: false,
49
56
  param: "to"
50
57
  };
58
+ if (exceedsRangeCap({
59
+ start,
60
+ end
61
+ })) return {
62
+ ok: false,
63
+ param: "to",
64
+ tooLong: true
65
+ };
51
66
  return {
52
67
  ok: true,
53
68
  range: {
@@ -57,68 +72,76 @@ const parseRange = (from, to, timezone) => {
57
72
  };
58
73
  };
59
74
  /**
60
- * Authenticated GET handler behind the interactive document analytics panel, gated
61
- * by `access.read` like every other read endpoint. The caller must also be able to
62
- * read the target document (enforced through `findByID`
63
- * without `overrideAccess`), so analytics never leak for content the user cannot
64
- * see; an unreadable or missing document is a uniform 404, while a read that fails for
65
- * any other reason is a logged 500 rather than a 404 that hides a broken install.
66
- * Timeframe, metrics, and data source are whitelist-validated; `timeframe=custom`
67
- * requires a parseable `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.
68
77
  */
69
78
  const makeDocumentHandler = () => async (req) => {
70
- if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
79
+ if (!req.user) return unauthorizedResponse();
71
80
  const runtime = getRuntime(req.payload);
72
- if (!runtime) return errorResponse(503, analyticsError("unavailable", "analytics: not available"), RETRY_AFTER);
73
- if (!await readAccessFor(runtime, req)) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
74
- 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);
75
92
  const collection = params.get("collection") ?? "";
76
93
  const id = params.get("id") ?? "";
77
- if (!runtime.bindings[collection] || !id) return errorResponse(404, analyticsError("not_found", "analytics: no such document"));
94
+ if (!runtime.bindings[collection] || !id) return unloadedDocumentResponse(404);
78
95
  const rawTimeframe = params.get("timeframe") ?? "last30days";
79
96
  let timezone;
80
97
  let range;
81
98
  if (rawTimeframe === "custom") {
82
99
  timezone = await requestTimezone(req);
83
100
  const parsed = parseRange(params.get("from"), params.get("to"), timezone);
84
- if (!parsed.ok) return errorResponse(400, analyticsError("invalid_param", "analytics: the custom range could not be read", parsed.param));
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));
85
102
  range = parsed.range;
86
103
  }
87
- const timeframe = TIMEFRAME_PRESETS.includes(rawTimeframe) ? rawTimeframe : "last30days";
88
- const metrics = parseMetrics(params.get("metrics")) ?? [
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 : [
89
108
  "pageviews",
90
109
  "visitors",
91
110
  "sessions",
92
111
  "avgDuration"
93
- ];
94
- let data;
95
- try {
96
- data = await req.payload.findByID({
97
- collection,
98
- id,
99
- depth: 0,
100
- overrideAccess: false,
101
- user: req.user,
102
- req
103
- });
104
- } catch (err) {
105
- if (err instanceof APIError && (err.status === 404 || err.status === 403)) return errorResponse(404, analyticsError("not_found", "analytics: no such document"));
106
- req.payload.logger?.error(`analytics: document read failed for "${collection}": ${String(err)}`);
107
- return errorResponse(500, analyticsError("internal", "analytics: document read failed"));
108
- }
109
- 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({
110
128
  req,
111
129
  collectionSlug: collection,
112
- data,
130
+ data: bound.data,
113
131
  metrics,
132
+ optionalMetrics,
114
133
  timeframe,
115
134
  range,
116
135
  ...timezone !== void 0 ? { timezone } : {},
136
+ ...dimensions.length > 0 ? { dimensions } : {},
137
+ ...limit === void 0 ? {} : { limit },
117
138
  adapterId: params.get("dataSource") ?? void 0,
118
- now: /* @__PURE__ */ new Date(),
139
+ now: currentDate(),
119
140
  compare: params.get("compare") === "1",
120
- series: params.get("series") === "1"
121
- });
141
+ series: params.get("series") === "1",
142
+ report
143
+ }, reads);
144
+ if (result.untrustedScope) return untrustedScopeResponse();
122
145
  return Response.json(result, { headers: NO_STORE });
123
146
  };
124
147
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import { APIError, type CollectionSlug, type 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 { analyticsError, errorResponse, NO_STORE, RETRY_AFTER } from './errors'\nimport { DOCUMENT_PATH } from './paths'\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\ntype RangeResult = { ok: true; range: DateRange } | { ok: false; param: 'from' | 'to' }\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. A\n * rejection names the bound at fault, and an inverted window blames `to`: `from` is the one\n * the reader picked first.\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\treturn { ok: true, range: { 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, while a read that fails for\n * any other reason is a logged 500 rather than a 404 that hides a broken install.\n * Timeframe, metrics, and data source are whitelist-validated; `timeframe=custom`\n * requires a parseable `from`/`to` pair.\n */\nexport const makeDocumentHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn errorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn errorResponse(\n\t\t\t503,\n\t\t\tanalyticsError('unavailable', 'analytics: not available'),\n\t\t\tRETRY_AFTER\n\t\t)\n\t}\n\tif (!(await readAccessFor(runtime, req))) {\n\t\treturn errorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\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 errorResponse(404, analyticsError('not_found', 'analytics: no such document'))\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 has to be resolved before\n\t\t// they can be read; a preset resolves its window inside `readForField` as before.\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\tanalyticsError(\n\t\t\t\t\t'invalid_param',\n\t\t\t\t\t'analytics: the custom range could not be read',\n\t\t\t\t\tparsed.param\n\t\t\t\t)\n\t\t\t)\n\t\t}\n\t\trange = parsed.range\n\t}\n\tconst timeframe: TimeframePreset = TIMEFRAME_PRESETS.includes(rawTimeframe as TimeframePreset)\n\t\t? (rawTimeframe as TimeframePreset)\n\t\t: 'last30days'\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 (err) {\n\t\t// `findByID` raises a `NotFound` for a missing row and a `Forbidden` for one this\n\t\t// caller may not read; both stay a uniform 404 so analytics never confirm a document\n\t\t// exists. Anything else is this install failing rather than the request being wrong.\n\t\tif (err instanceof APIError && (err.status === 404 || err.status === 403)) {\n\t\t\treturn errorResponse(404, analyticsError('not_found', 'analytics: no such document'))\n\t\t}\n\t\treq.payload.logger?.error(`analytics: document read failed for \"${collection}\": ${String(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: document read failed'))\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,\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;;;;;;;;;;AAaA,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,OAAO;EAAE,IAAI;EAAM,OAAO;GAAE;GAAO;EAAI;CAAE;AAC1C;;;;;;;;;;;AAYA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;CAE/F,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,cACN,KACA,eAAe,eAAe,0BAA0B,GACxD,WACD;CAED,IAAI,CAAE,MAAM,cAAc,SAAS,GAAG,GACrC,OAAO,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;CAEvF,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,cAAc,KAAK,eAAe,aAAa,6BAA6B,CAAC;CAErF,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,eACC,iBACA,iDACA,OAAO,KACR,CACD;EAED,QAAQ,OAAO;CAChB;CACA,MAAM,YAA6B,kBAAkB,SAAS,YAA+B,IACzF,eACD;CACH,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,SAAS,KAAK;EAIb,IAAI,eAAe,aAAa,IAAI,WAAW,OAAO,IAAI,WAAW,MACpE,OAAO,cAAc,KAAK,eAAe,aAAa,6BAA6B,CAAC;EAErF,IAAI,QAAQ,QAAQ,MAAM,wCAAwC,WAAW,KAAK,OAAO,GAAG,GAAG;EAC/F,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;CACA,MAAM,SAAS,MAAM,aAAa;EACjC;EACA,gBAAgB;EAChB;EACA;EACA;EACA;EACA,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\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;EACvC,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"}
@@ -1,15 +1,9 @@
1
1
  //#region src/plugin/errors.d.ts
2
2
  /**
3
- * Every code any analytics endpoint answers with, in one place so a handler cannot invent
4
- * a word only its own client knows. Kept free of Payload and Node imports: admin clients
5
- * import {@link readErrorCode} from here to branch on what an endpoint said.
6
- *
7
- * `invalid_param` and the `unsupported_*` family are the query parser's `400`s;
8
- * `unauthorized` (`401`), `forbidden` (`403`), `not_found` (`404`), `unknown_source`
9
- * (`404`), `untrusted_scope` (`400`), `payload_too_large` (`413`), `unavailable` (`503`)
10
- * and `internal` (`500`) are raised by the handlers themselves.
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.
11
5
  */
12
- 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", "unavailable", "internal"];
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"];
13
7
  type AnalyticsErrorCode = (typeof ANALYTICS_ERROR_CODES)[number];
14
8
  /** Wire shape of a refused request: `param` names the parameter or field at fault. */
15
9
  interface AnalyticsError {
@@ -21,9 +15,8 @@ declare const analyticsError: (code: AnalyticsErrorCode, message: string, param?
21
15
  /** The code an endpoint answered with, or undefined when the body is not the envelope. */
22
16
  declare const readErrorCode: (body: unknown) => AnalyticsErrorCode | undefined;
23
17
  /**
24
- * {@link readError} over a response whose body has yet to be read. A body that is not JSON
25
- * at all, including an empty one, reads as no error rather than throwing: the status still
26
- * carries the failure.
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.
27
20
  */
28
21
  declare const readResponseError: (res: Response) => Promise<AnalyticsError | undefined>;
29
22
  //#endregion
@@ -1,13 +1,8 @@
1
+ import { isRecord } from "../core/values.js";
1
2
  //#region src/plugin/errors.ts
2
3
  /**
3
- * Every code any analytics endpoint answers with, in one place so a handler cannot invent
4
- * a word only its own client knows. Kept free of Payload and Node imports: admin clients
5
- * import {@link readErrorCode} from here to branch on what an endpoint said.
6
- *
7
- * `invalid_param` and the `unsupported_*` family are the query parser's `400`s;
8
- * `unauthorized` (`401`), `forbidden` (`403`), `not_found` (`404`), `unknown_source`
9
- * (`404`), `untrusted_scope` (`400`), `payload_too_large` (`413`), `unavailable` (`503`)
10
- * and `internal` (`500`) are raised by the handlers themselves.
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.
11
6
  */
12
7
  const ANALYTICS_ERROR_CODES = [
13
8
  "invalid_param",
@@ -23,6 +18,8 @@ const ANALYTICS_ERROR_CODES = [
23
18
  "payload_too_large",
24
19
  "unauthorized",
25
20
  "forbidden",
21
+ "rate_limited",
22
+ "source_misconfigured",
26
23
  "unavailable",
27
24
  "internal"
28
25
  ];
@@ -35,6 +32,11 @@ const analyticsError = (code, message, param) => ({
35
32
  const NO_STORE = { "Cache-Control": "private, no-store" };
36
33
  /** How long a client should wait out a provider outage before retrying the same read. */
37
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))) };
38
40
  /** An endpoint's error answer: coded body, never cached, headers merged over `NO_STORE`. */
39
41
  const errorResponse = (status, error, headers = {}) => Response.json({ error }, {
40
42
  status,
@@ -43,13 +45,19 @@ const errorResponse = (status, error, headers = {}) => Response.json({ error },
43
45
  ...headers
44
46
  }
45
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));
46
56
  const CODES = new Set(ANALYTICS_ERROR_CODES);
47
- const isRecord = (value) => typeof value === "object" && value !== null;
48
57
  const isErrorCode = (value) => CODES.has(value);
49
58
  /**
50
- * The error out of a parsed response body, or undefined for anything this version cannot
51
- * read: a body that is not the envelope, and a code no release of this package ever sent.
52
- * A code added by a newer server therefore reads as a generic failure rather than as a lie.
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.
53
61
  */
54
62
  const readError = (body) => {
55
63
  if (!isRecord(body)) return;
@@ -62,9 +70,8 @@ const readError = (body) => {
62
70
  /** The code an endpoint answered with, or undefined when the body is not the envelope. */
63
71
  const readErrorCode = (body) => readError(body)?.code;
64
72
  /**
65
- * {@link readError} over a response whose body has yet to be read. A body that is not JSON
66
- * at all, including an empty one, reads as no error rather than throwing: the status still
67
- * carries the failure.
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.
68
75
  */
69
76
  const readResponseError = async (res) => {
70
77
  try {
@@ -74,6 +81,6 @@ const readResponseError = async (res) => {
74
81
  }
75
82
  };
76
83
  //#endregion
77
- export { ANALYTICS_ERROR_CODES, NO_STORE, RETRY_AFTER, analyticsError, errorResponse, readErrorCode, readResponseError };
84
+ export { ANALYTICS_ERROR_CODES, NO_STORE, RETRY_AFTER, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, readErrorCode, readResponseError, retryAfter, unauthorizedResponse, untrustedScopeResponse };
78
85
 
79
86
  //# sourceMappingURL=errors.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","names":[],"sources":["../../src/plugin/errors.ts"],"sourcesContent":["/**\n * Every code any analytics endpoint answers with, in one place so a handler cannot invent\n * a word only its own client knows. Kept free of Payload and Node imports: admin clients\n * import {@link readErrorCode} from here to branch on what an endpoint said.\n *\n * `invalid_param` and the `unsupported_*` family are the query parser's `400`s;\n * `unauthorized` (`401`), `forbidden` (`403`), `not_found` (`404`), `unknown_source`\n * (`404`), `untrusted_scope` (`400`), `payload_too_large` (`413`), `unavailable` (`503`)\n * and `internal` (`500`) are raised by the handlers themselves.\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'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/** 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\nconst CODES: ReadonlySet<string> = new Set<AnalyticsErrorCode>(ANALYTICS_ERROR_CODES)\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\n\nconst isErrorCode = (value: string): value is AnalyticsErrorCode => CODES.has(value)\n\n/**\n * The error out of a parsed response body, or undefined for anything this version cannot\n * read: a body that is not the envelope, and a code no release of this package ever sent.\n * A code added by a newer server therefore reads as a generic failure rather than as 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 a response whose body has yet to be read. A body that is not JSON\n * at all, including an empty one, reads as no error rather than throwing: the status still\n * 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":";;;;;;;;;;;AAUA,MAAa,wBAAwB;CACpC;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;;AAGjD,MAAa,iBACZ,QACA,OACA,UAAkC,CAAC,MACrB,SAAS,KAAK,EAAE,MAAM,GAAG;CAAE;CAAQ,SAAS;EAAE,GAAG;EAAU,GAAG;CAAQ;AAAE,CAAC;AAExF,MAAM,QAA6B,IAAI,IAAwB,qBAAqB;AAEpF,MAAM,YAAY,UACjB,OAAO,UAAU,YAAY,UAAU;AAExC,MAAM,eAAe,UAA+C,MAAM,IAAI,KAAK;;;;;;AAOnF,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;;;;;;AAOlB,MAAa,oBAAoB,OAAO,QAAuD;CAC9F,IAAI;EACH,OAAO,UAAU,MAAM,IAAI,KAAK,CAAC;CAClC,QAAQ;EACP;CACD;AACD"}
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"}