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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,6 +1,15 @@
1
- import "./paths.js";
2
- import { getRuntime, readAccessFor } from "./runtime.js";
3
- import { readForWidgetRealtime } from "../widgets/readForWidgetRealtime.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import { wholeNumberParam } from "../core/values.js";
3
+ import { describeWithCauses } from "../core/sourceErrors.js";
4
+ import { currentDate } from "../core/clock.js";
5
+ import { getRuntime, scopeGates } from "./runtime.js";
6
+ import { resolveRequestedScope } from "../core/scopedRead.js";
7
+ import { NO_STORE, analyticsError, errorResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
8
+ import { resolveDocumentScope } from "./documentScopes.js";
9
+ import { resolveBoundDocument, unloadedDocumentResponse } from "./boundDocument.js";
10
+ import { queryParams } from "./queryParams.js";
11
+ import { readFailureResponse } from "./readFailure.js";
12
+ import { readRealtimeOrThrow } from "../widgets/readForWidgetRealtime.js";
4
13
  //#region src/plugin/realtimeEndpoint.ts
5
14
  const ALLOWED_METRICS = ["visitors", "pageviews"];
6
15
  const ALLOWED_WINDOWS = [
@@ -11,27 +20,88 @@ const ALLOWED_WINDOWS = [
11
20
  ];
12
21
  const DEFAULT_WINDOW = 30;
13
22
  /**
14
- * Authenticated GET handler for the realtime widget poller. Reads + clamps the query
15
- * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request
16
- * and 403 when `access.read` denies, which defaults to any authenticated user (not
17
- * admin-panel access specifically); the response is integer counts only.
23
+ * The scope and page a read counts, or the answer that replaces the read. A `collection` and `id`
24
+ * count that document's page in the document's own tenant, whichever one the reader resolves to.
18
25
  */
19
- const makeRealtimeHandler = () => async (req) => {
20
- if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
21
- const runtime = getRuntime(req.payload);
22
- if (runtime && !await readAccessFor(runtime, req)) return Response.json({ error: "forbidden" }, { status: 403 });
23
- const params = new URL(req.url ?? "", "http://localhost").searchParams;
24
- const rawMetric = params.get("metric");
25
- const metric = ALLOWED_METRICS.includes(rawMetric) ? rawMetric : "visitors";
26
- const rawWindow = Number(params.get("windowMinutes"));
27
- const result = await readForWidgetRealtime({
26
+ const realtimeTargetOf = async (req, runtime, params) => {
27
+ const gates = runtime && scopeGates(runtime, req);
28
+ let scope;
29
+ if (runtime && gates) {
30
+ const raw = params.get("scope");
31
+ const requested = await resolveRequestedScope({
32
+ runtime,
33
+ req,
34
+ raw,
35
+ gates
36
+ });
37
+ if (!requested.ok && (requested.reason === "named" || requested.reason === "not-member")) return untrustedScopeResponse("scope");
38
+ scope = requested.ok && raw ? requested.gated : void 0;
39
+ }
40
+ const collection = params.get("collection");
41
+ if (!collection) return scope === void 0 ? {} : { scope };
42
+ const bound = await resolveBoundDocument({
28
43
  req,
29
- metric,
30
- windowMinutes: ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW,
31
- adapterId: params.get("dataSource") ?? void 0,
32
- now: /* @__PURE__ */ new Date()
44
+ collection,
45
+ id: params.get("id") ?? ""
33
46
  });
34
- return Response.json(result);
47
+ if (!bound.ok) return unloadedDocumentResponse(bound.status);
48
+ if (runtime && gates) {
49
+ const owner = await resolveDocumentScope({
50
+ runtime,
51
+ req,
52
+ collection,
53
+ data: bound.data,
54
+ gates
55
+ });
56
+ if (!owner.ok) return untrustedScopeResponse();
57
+ if (owner.scope !== null) scope = owner.gated;
58
+ }
59
+ if (bound.path === null) return Response.json({
60
+ status: "unavailable",
61
+ adapterId: "",
62
+ activeNow: 0,
63
+ series: []
64
+ }, { headers: NO_STORE });
65
+ return {
66
+ ...scope === void 0 ? {} : { scope },
67
+ path: bound.path
68
+ };
69
+ };
70
+ /**
71
+ * Authenticated GET for the realtime poller, answering `no-store` integer counts. `collection` and
72
+ * `id` count one readable document's page in its own scope, gated like a named `scope`.
73
+ */
74
+ const makeRealtimeHandler = () => async (req) => {
75
+ if (!req.user) return unauthorizedResponse();
76
+ try {
77
+ const runtime = getRuntime(req.payload);
78
+ if (runtime && !await readGate(runtime, req)) return readDeniedResponse();
79
+ const params = queryParams(req);
80
+ const rawMetric = params.get("metric");
81
+ const metric = ALLOWED_METRICS.find((allowed) => allowed === rawMetric) ?? "visitors";
82
+ const rawWindow = wholeNumberParam(params.get("windowMinutes"));
83
+ const windowMinutes = rawWindow !== void 0 && ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW;
84
+ const target = await realtimeTargetOf(req, runtime, params);
85
+ if (target instanceof Response) return target;
86
+ try {
87
+ const result = await readRealtimeOrThrow({
88
+ req,
89
+ metric,
90
+ windowMinutes,
91
+ adapterId: params.get("dataSource") ?? void 0,
92
+ now: currentDate(),
93
+ series: params.get("series") !== "0",
94
+ ...target
95
+ });
96
+ return Response.json(result, { headers: NO_STORE });
97
+ } catch (err) {
98
+ req.payload.logger?.warn(`analytics: realtime read failed: ${describeWithCauses(err)}`);
99
+ return readFailureResponse(err);
100
+ }
101
+ } catch (err) {
102
+ req.payload.logger?.error(`analytics: realtime request failed: ${String(err)}`);
103
+ return errorResponse(500, analyticsError("internal", "analytics: realtime read failed"));
104
+ }
35
105
  };
36
106
  //#endregion
37
107
  export { makeRealtimeHandler };
@@ -1 +1 @@
1
- {"version":3,"file":"realtimeEndpoint.js","names":[],"sources":["../../src/plugin/realtimeEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport type { MetricKey } from '../core/contract'\nimport { readForWidgetRealtime } from '../widgets/readForWidgetRealtime'\nimport { REALTIME_PATH } from './paths'\nimport { getRuntime, readAccessFor } from './runtime'\n\nexport { REALTIME_PATH }\n\nconst ALLOWED_METRICS: MetricKey[] = ['visitors', 'pageviews']\nconst ALLOWED_WINDOWS = [5, 15, 30, 60]\nconst DEFAULT_WINDOW = 30\n\n/**\n * Authenticated GET handler for the realtime widget poller. Reads + clamps the query\n * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request\n * and 403 when `access.read` denies, which defaults to any authenticated user (not\n * admin-panel access specifically); the response is integer counts only.\n */\nexport const makeRealtimeHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\t// No runtime means no adapter to read, so the skipped gate protects no data.\n\tif (runtime && !(await readAccessFor(runtime, req))) {\n\t\treturn Response.json({ error: 'forbidden' }, { status: 403 })\n\t}\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\tconst rawMetric = params.get('metric')\n\tconst metric: MetricKey = ALLOWED_METRICS.includes(rawMetric as MetricKey)\n\t\t? (rawMetric as MetricKey)\n\t\t: 'visitors'\n\tconst rawWindow = Number(params.get('windowMinutes'))\n\tconst windowMinutes = ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW\n\tconst dataSource = params.get('dataSource') ?? undefined\n\tconst result = await readForWidgetRealtime({\n\t\treq,\n\t\tmetric,\n\t\twindowMinutes,\n\t\tadapterId: dataSource,\n\t\tnow: new Date(),\n\t})\n\treturn Response.json(result)\n}\n"],"mappings":";;;;AAQA,MAAM,kBAA+B,CAAC,YAAY,WAAW;AAC7D,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;AAAE;AACtC,MAAM,iBAAiB;;;;;;;AAQvB,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CAEtC,IAAI,WAAW,CAAE,MAAM,cAAc,SAAS,GAAG,GAChD,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG,EAAE,QAAQ,IAAI,CAAC;CAE7D,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;CAC1D,MAAM,YAAY,OAAO,IAAI,QAAQ;CACrC,MAAM,SAAoB,gBAAgB,SAAS,SAAsB,IACrE,YACD;CACH,MAAM,YAAY,OAAO,OAAO,IAAI,eAAe,CAAC;CAGpD,MAAM,SAAS,MAAM,sBAAsB;EAC1C;EACA;EACA,eALqB,gBAAgB,SAAS,SAAS,IAAI,YAAY;EAMvE,WALkB,OAAO,IAAI,YAAY,KAAK,KAAA;EAM9C,qBAAK,IAAI,KAAK;CACf,CAAC;CACD,OAAO,SAAS,KAAK,MAAM;AAC5B"}
1
+ {"version":3,"file":"realtimeEndpoint.js","names":[],"sources":["../../src/plugin/realtimeEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport type { GatedScope } from '../access/principal'\nimport { readGate } from '../access/readGate'\nimport { currentDate } from '../core/clock'\nimport type { MetricKey } from '../core/contract'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport { describeWithCauses } from '../core/sourceErrors'\nimport { wholeNumberParam } from '../core/values'\nimport { readRealtimeOrThrow } from '../widgets/readForWidgetRealtime'\nimport { resolveBoundDocument, unloadedDocumentResponse } from './boundDocument'\nimport { resolveDocumentScope } from './documentScopes'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport { queryParams } from './queryParams'\nimport { readFailureResponse } from './readFailure'\nimport { type AnalyticsRuntime, getRuntime, scopeGates } from './runtime'\n\nconst ALLOWED_METRICS: MetricKey[] = ['visitors', 'pageviews']\nconst ALLOWED_WINDOWS = [5, 15, 30, 60]\nconst DEFAULT_WINDOW = 30\n\n/** What one realtime read counts: a scope other than the request's own, and one page. */\ninterface RealtimeTarget {\n\tscope?: GatedScope\n\tpath?: string\n}\n\n/**\n * The scope and page a read counts, or the answer that replaces the read. A `collection` and `id`\n * count that document's page in the document's own tenant, whichever one the reader resolves to.\n */\nconst realtimeTargetOf = async (\n\treq: PayloadRequest,\n\truntime: AnalyticsRuntime | undefined,\n\tparams: URLSearchParams\n): Promise<RealtimeTarget | Response> => {\n\tconst gates = runtime && scopeGates(runtime, req)\n\tlet scope: GatedScope | undefined\n\tif (runtime && gates) {\n\t\tconst raw = params.get('scope')\n\t\tconst requested = await resolveRequestedScope({ runtime, req, raw, gates })\n\t\t// An unresolvable own scope is left to the read, which answers its unavailable state.\n\t\tif (!requested.ok && (requested.reason === 'named' || requested.reason === 'not-member')) {\n\t\t\treturn untrustedScopeResponse('scope')\n\t\t}\n\t\tscope = requested.ok && raw ? requested.gated : undefined\n\t}\n\tconst collection = params.get('collection')\n\tif (!collection) {\n\t\treturn scope === undefined ? {} : { scope }\n\t}\n\tconst bound = await resolveBoundDocument({ req, collection, id: params.get('id') ?? '' })\n\tif (!bound.ok) {\n\t\treturn unloadedDocumentResponse(bound.status)\n\t}\n\tif (runtime && gates) {\n\t\tconst owner = await resolveDocumentScope({\n\t\t\truntime,\n\t\t\treq,\n\t\t\tcollection,\n\t\t\tdata: bound.data,\n\t\t\tgates,\n\t\t})\n\t\tif (!owner.ok) {\n\t\t\treturn untrustedScopeResponse()\n\t\t}\n\t\tif (owner.scope !== null) {\n\t\t\tscope = owner.gated\n\t\t}\n\t}\n\t// A document with no path yet (an unsaved slug) has no page to count, and counting the whole\n\t// site in its place would mislabel the number.\n\tif (bound.path === null) {\n\t\treturn Response.json(\n\t\t\t{ status: 'unavailable', adapterId: '', activeNow: 0, series: [] },\n\t\t\t{ headers: NO_STORE }\n\t\t)\n\t}\n\treturn { ...(scope === undefined ? {} : { scope }), path: bound.path }\n}\n\n/**\n * Authenticated GET for the realtime poller, answering `no-store` integer counts. `collection` and\n * `id` count one readable document's page in its own scope, gated like a named `scope`.\n */\nexport const makeRealtimeHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn unauthorizedResponse()\n\t}\n\ttry {\n\t\tconst runtime = getRuntime(req.payload)\n\t\t// No runtime means no adapter to read, so the skipped gate protects no data.\n\t\tif (runtime && !(await readGate(runtime, req))) {\n\t\t\treturn readDeniedResponse()\n\t\t}\n\t\tconst params = queryParams(req)\n\t\tconst rawMetric = params.get('metric')\n\t\tconst metric: MetricKey = ALLOWED_METRICS.find((allowed) => allowed === rawMetric) ?? 'visitors'\n\t\tconst rawWindow = wholeNumberParam(params.get('windowMinutes'))\n\t\tconst windowMinutes =\n\t\t\trawWindow !== undefined && ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW\n\t\tconst target = await realtimeTargetOf(req, runtime, params)\n\t\tif (target instanceof Response) {\n\t\t\treturn target\n\t\t}\n\t\ttry {\n\t\t\tconst result = await readRealtimeOrThrow({\n\t\t\t\treq,\n\t\t\t\tmetric,\n\t\t\t\twindowMinutes,\n\t\t\t\tadapterId: params.get('dataSource') ?? undefined,\n\t\t\t\tnow: currentDate(),\n\t\t\t\tseries: params.get('series') !== '0',\n\t\t\t\t...target,\n\t\t\t})\n\t\t\treturn Response.json(result, { headers: NO_STORE })\n\t\t} catch (err) {\n\t\t\treq.payload.logger?.warn(`analytics: realtime read failed: ${describeWithCauses(err)}`)\n\t\t\treturn readFailureResponse(err)\n\t\t}\n\t} catch (err) {\n\t\t// Only the read is retryable: a throwing `access.read` is a config bug, which a retry repeats.\n\t\treq.payload.logger?.error(`analytics: realtime request failed: ${String(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: realtime read failed'))\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,MAAM,kBAA+B,CAAC,YAAY,WAAW;AAC7D,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;AAAE;AACtC,MAAM,iBAAiB;;;;;AAYvB,MAAM,mBAAmB,OACxB,KACA,SACA,WACwC;CACxC,MAAM,QAAQ,WAAW,WAAW,SAAS,GAAG;CAChD,IAAI;CACJ,IAAI,WAAW,OAAO;EACrB,MAAM,MAAM,OAAO,IAAI,OAAO;EAC9B,MAAM,YAAY,MAAM,sBAAsB;GAAE;GAAS;GAAK;GAAK;EAAM,CAAC;EAE1E,IAAI,CAAC,UAAU,OAAO,UAAU,WAAW,WAAW,UAAU,WAAW,eAC1E,OAAO,uBAAuB,OAAO;EAEtC,QAAQ,UAAU,MAAM,MAAM,UAAU,QAAQ,KAAA;CACjD;CACA,MAAM,aAAa,OAAO,IAAI,YAAY;CAC1C,IAAI,CAAC,YACJ,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;CAE3C,MAAM,QAAQ,MAAM,qBAAqB;EAAE;EAAK;EAAY,IAAI,OAAO,IAAI,IAAI,KAAK;CAAG,CAAC;CACxF,IAAI,CAAC,MAAM,IACV,OAAO,yBAAyB,MAAM,MAAM;CAE7C,IAAI,WAAW,OAAO;EACrB,MAAM,QAAQ,MAAM,qBAAqB;GACxC;GACA;GACA;GACA,MAAM,MAAM;GACZ;EACD,CAAC;EACD,IAAI,CAAC,MAAM,IACV,OAAO,uBAAuB;EAE/B,IAAI,MAAM,UAAU,MACnB,QAAQ,MAAM;CAEhB;CAGA,IAAI,MAAM,SAAS,MAClB,OAAO,SAAS,KACf;EAAE,QAAQ;EAAe,WAAW;EAAI,WAAW;EAAG,QAAQ,CAAC;CAAE,GACjE,EAAE,SAAS,SAAS,CACrB;CAED,OAAO;EAAE,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EAAI,MAAM,MAAM;CAAK;AACtE;;;;;AAMA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,qBAAqB;CAE7B,IAAI;EACH,MAAM,UAAU,WAAW,IAAI,OAAO;EAEtC,IAAI,WAAW,CAAE,MAAM,SAAS,SAAS,GAAG,GAC3C,OAAO,mBAAmB;EAE3B,MAAM,SAAS,YAAY,GAAG;EAC9B,MAAM,YAAY,OAAO,IAAI,QAAQ;EACrC,MAAM,SAAoB,gBAAgB,MAAM,YAAY,YAAY,SAAS,KAAK;EACtF,MAAM,YAAY,iBAAiB,OAAO,IAAI,eAAe,CAAC;EAC9D,MAAM,gBACL,cAAc,KAAA,KAAa,gBAAgB,SAAS,SAAS,IAAI,YAAY;EAC9E,MAAM,SAAS,MAAM,iBAAiB,KAAK,SAAS,MAAM;EAC1D,IAAI,kBAAkB,UACrB,OAAO;EAER,IAAI;GACH,MAAM,SAAS,MAAM,oBAAoB;IACxC;IACA;IACA;IACA,WAAW,OAAO,IAAI,YAAY,KAAK,KAAA;IACvC,KAAK,YAAY;IACjB,QAAQ,OAAO,IAAI,QAAQ,MAAM;IACjC,GAAG;GACJ,CAAC;GACD,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;EACnD,SAAS,KAAK;GACb,IAAI,QAAQ,QAAQ,KAAK,oCAAoC,mBAAmB,GAAG,GAAG;GACtF,OAAO,oBAAoB,GAAG;EAC/B;CACD,SAAS,KAAK;EAEb,IAAI,QAAQ,QAAQ,MAAM,uCAAuC,OAAO,GAAG,GAAG;EAC9E,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;AACD"}
@@ -0,0 +1,138 @@
1
+ import { readGate } from "../access/readGate.js";
2
+ import { isRecord } from "../core/values.js";
3
+ import { epochKeyFor } from "../surfacing/epoch.js";
4
+ import { cacheEpochFor, getRuntime, resolvableScope, scopeGates } from "./runtime.js";
5
+ import { resolveRequestedScope } from "../core/scopedRead.js";
6
+ import { resolveScopeList } from "../core/scopeList.js";
7
+ import { NO_STORE, RETRY_AFTER, analyticsError, errorResponse, notAvailableResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
8
+ import { readCappedBody } from "../capture/requestBody.js";
9
+ import { monotonicMs } from "../core/monotonic.js";
10
+ import { isCollectionSlug } from "../core/collectionSlug.js";
11
+ //#region src/plugin/refreshEndpoint.ts
12
+ /** The body carries one optional scope string; anything larger is not this request. */
13
+ const MAX_REFRESH_BODY_BYTES = 4 * 1024;
14
+ /**
15
+ * Per-scope invalidation debounce, so a looped POST cannot turn every cached read into a provider
16
+ * call; rate limiting is the edge's job. Hooks skip it, since a save must show on the next read.
17
+ */
18
+ const REFRESH_DEBOUNCE_MS = 5e3;
19
+ /**
20
+ * Per-scope debounce state, pruned on every write so a long-lived instance holds only scopes a bump
21
+ * could still be debounced against.
22
+ */
23
+ const createRefreshDebounce = (now, windowMs = REFRESH_DEBOUNCE_MS) => {
24
+ const bumpedAt = /* @__PURE__ */ new Map();
25
+ return {
26
+ allows(key) {
27
+ const last = bumpedAt.get(key);
28
+ return last === void 0 || now() - last >= windowMs;
29
+ },
30
+ record(key) {
31
+ const at = now();
32
+ for (const [seen, when] of bumpedAt) if (at - when >= windowMs) bumpedAt.delete(seen);
33
+ bumpedAt.set(key, at);
34
+ },
35
+ get size() {
36
+ return bumpedAt.size;
37
+ }
38
+ };
39
+ };
40
+ /**
41
+ * Whether a named scope has anything to refresh: in `scope.list`, else owning a cached read,
42
+ * provider or epoch. With no list or cache collection to ask, every name passes.
43
+ */
44
+ const knownScope = async (runtime, req, scope) => {
45
+ if (runtime.scopeList) return (await resolveScopeList(runtime.scopeList, req.payload)).includes(scope);
46
+ const cacheSlug = runtime.cacheCollectionSlug;
47
+ if (cacheSlug === void 0 || !isCollectionSlug(req.payload, cacheSlug)) return true;
48
+ const owned = (collection, field) => isCollectionSlug(req.payload, collection) ? req.payload.db.findOne({
49
+ collection,
50
+ where: { [field]: { equals: scope } },
51
+ req
52
+ }) : Promise.resolve(null);
53
+ const providers = runtime.providersCollection;
54
+ const [cached, provider, epoch] = await Promise.all([
55
+ owned(cacheSlug, "owner"),
56
+ providers ? owned(providers.slug, providers.scopeField) : Promise.resolve(null),
57
+ req.payload.kv.get(epochKeyFor(scope))
58
+ ]);
59
+ return cached !== null || provider !== null || epoch !== null;
60
+ };
61
+ /**
62
+ * The optional `{ scope }` body. Empty, non-object and scope-less bodies mean the caller's own
63
+ * scope, the common button case; only a wrongly typed `scope` is refused.
64
+ */
65
+ const parseBody = (bytes) => {
66
+ if (bytes.byteLength === 0) return { ok: true };
67
+ let parsed;
68
+ try {
69
+ parsed = JSON.parse(new TextDecoder().decode(bytes));
70
+ } catch {
71
+ return { ok: true };
72
+ }
73
+ const scope = isRecord(parsed) ? parsed.scope : void 0;
74
+ if (scope === void 0 || scope === null) return { ok: true };
75
+ return typeof scope === "string" ? {
76
+ ok: true,
77
+ scope
78
+ } : { ok: false };
79
+ };
80
+ /** The scope a refresh may raise, or the refusal that answers instead. */
81
+ const refreshTargetOf = async (runtime, req) => {
82
+ if (!await readGate(runtime, req)) return readDeniedResponse();
83
+ const read = await readCappedBody(req, MAX_REFRESH_BODY_BYTES);
84
+ if (!read.ok) return read.reason === "too-large" ? errorResponse(413, analyticsError("payload_too_large", "analytics: the refresh body is too large")) : errorResponse(400, analyticsError("invalid_param", "analytics: the refresh body could not be read", "scope"));
85
+ const body = parseBody(read.body);
86
+ if (!body.ok) return errorResponse(400, analyticsError("invalid_param", "analytics: scope must be a string", "scope"));
87
+ const requested = await resolveRequestedScope({
88
+ runtime,
89
+ req,
90
+ raw: body.scope ?? null,
91
+ gates: scopeGates(runtime, req)
92
+ });
93
+ if (!requested.ok) return untrustedScopeResponse("scope");
94
+ return {
95
+ scope: resolvableScope(requested.scope),
96
+ named: body.scope !== void 0
97
+ };
98
+ };
99
+ /**
100
+ * Authenticated POST raising one scope's cache epoch, retiring its cached reads on every instance.
101
+ * Gated like the query endpoint; the wildcard bumps the install-wide token cross-scope reads use.
102
+ */
103
+ const makeRefreshHandler = (opts = {}) => {
104
+ const debounce = createRefreshDebounce(opts.now ?? monotonicMs);
105
+ return async (req) => {
106
+ if (!req.user) return unauthorizedResponse();
107
+ const runtime = getRuntime(req.payload);
108
+ if (!runtime) return notAvailableResponse();
109
+ let target;
110
+ try {
111
+ target = await refreshTargetOf(runtime, req);
112
+ } catch (err) {
113
+ req.payload.logger?.error(`analytics: refresh request failed: ${String(err)}`);
114
+ return errorResponse(500, analyticsError("internal", "analytics: refresh failed"));
115
+ }
116
+ if (target instanceof Response) return target;
117
+ const { scope, named } = target;
118
+ try {
119
+ if (named && scope !== null && !await knownScope(runtime, req, scope)) return Response.json({ epoch: "0" }, { headers: NO_STORE });
120
+ const key = epochKeyFor(scope);
121
+ if (!debounce.allows(key)) {
122
+ const debounced = { epoch: await cacheEpochFor(runtime, scope) };
123
+ return Response.json(debounced, { headers: NO_STORE });
124
+ }
125
+ const epoch = await (runtime.epoch?.bump(scope) ?? Promise.resolve("0"));
126
+ debounce.record(key);
127
+ const answer = { epoch };
128
+ return Response.json(answer, { headers: NO_STORE });
129
+ } catch (err) {
130
+ req.payload.logger?.warn(`analytics: cache refresh failed: ${String(err)}`);
131
+ return errorResponse(503, analyticsError("unavailable", "analytics: the cache could not be refreshed"), RETRY_AFTER);
132
+ }
133
+ };
134
+ };
135
+ //#endregion
136
+ export { makeRefreshHandler };
137
+
138
+ //# sourceMappingURL=refreshEndpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refreshEndpoint.js","names":[],"sources":["../../src/plugin/refreshEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { readCappedBody } from '../capture/requestBody'\nimport { isCollectionSlug } from '../core/collectionSlug'\nimport { monotonicMs } from '../core/monotonic'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport { resolveScopeList } from '../core/scopeList'\nimport { isRecord } from '../core/values'\nimport type { RefreshResponse } from '../query/fetchQuery'\nimport { epochKeyFor, INITIAL_EPOCH } from '../surfacing/epoch'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\tnotAvailableResponse,\n\tRETRY_AFTER,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport {\n\ttype AnalyticsRuntime,\n\tcacheEpochFor,\n\tgetRuntime,\n\tresolvableScope,\n\tscopeGates,\n} from './runtime'\n\n/** The body carries one optional scope string; anything larger is not this request. */\nexport const MAX_REFRESH_BODY_BYTES = 4 * 1024\n\n/**\n * Per-scope invalidation debounce, so a looped POST cannot turn every cached read into a provider\n * call; rate limiting is the edge's job. Hooks skip it, since a save must show on the next read.\n */\nexport const REFRESH_DEBOUNCE_MS = 5_000\n\ninterface RefreshHandlerOptions {\n\t/** Clock behind the debounce window; `monotonicMs` unless a test injects one. */\n\tnow?: () => number\n}\n\ninterface RefreshDebounce {\n\t/** Whether this scope may be bumped now; recording a bump is `record`'s job. */\n\tallows(key: string): boolean\n\t/** Marks the scope bumped, dropping every entry the window has already left. */\n\trecord(key: string): void\n\t/** Entries currently held, which is one window's distinct scopes at most. */\n\treadonly size: number\n}\n\n/**\n * Per-scope debounce state, pruned on every write so a long-lived instance holds only scopes a bump\n * could still be debounced against.\n */\nexport const createRefreshDebounce = (\n\tnow: () => number,\n\twindowMs: number = REFRESH_DEBOUNCE_MS\n): RefreshDebounce => {\n\tconst bumpedAt = new Map<string, number>()\n\treturn {\n\t\tallows(key) {\n\t\t\tconst last = bumpedAt.get(key)\n\t\t\treturn last === undefined || now() - last >= windowMs\n\t\t},\n\t\trecord(key) {\n\t\t\tconst at = now()\n\t\t\tfor (const [seen, when] of bumpedAt) {\n\t\t\t\tif (at - when >= windowMs) {\n\t\t\t\t\tbumpedAt.delete(seen)\n\t\t\t\t}\n\t\t\t}\n\t\t\tbumpedAt.set(key, at)\n\t\t},\n\t\tget size() {\n\t\t\treturn bumpedAt.size\n\t\t},\n\t}\n}\n\n/**\n * Whether a named scope has anything to refresh: in `scope.list`, else owning a cached read,\n * provider or epoch. With no list or cache collection to ask, every name passes.\n */\nconst knownScope = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string\n): Promise<boolean> => {\n\tif (runtime.scopeList) {\n\t\treturn (await resolveScopeList(runtime.scopeList, req.payload)).includes(scope)\n\t}\n\tconst cacheSlug = runtime.cacheCollectionSlug\n\tif (cacheSlug === undefined || !isCollectionSlug(req.payload, cacheSlug)) {\n\t\treturn true\n\t}\n\tconst owned = (collection: string, field: string) =>\n\t\tisCollectionSlug(req.payload, collection)\n\t\t\t? req.payload.db.findOne({ collection, where: { [field]: { equals: scope } }, req })\n\t\t\t: Promise.resolve(null)\n\tconst providers = runtime.providersCollection\n\tconst [cached, provider, epoch] = await Promise.all([\n\t\towned(cacheSlug, 'owner'),\n\t\tproviders ? owned(providers.slug, providers.scopeField) : Promise.resolve(null),\n\t\treq.payload.kv.get(epochKeyFor(scope)),\n\t])\n\treturn cached !== null || provider !== null || epoch !== null\n}\n\ntype ParsedBody = { ok: true; scope?: string } | { ok: false }\n\n/**\n * The optional `{ scope }` body. Empty, non-object and scope-less bodies mean the caller's own\n * scope, the common button case; only a wrongly typed `scope` is refused.\n */\nconst parseBody = (bytes: ArrayBuffer): ParsedBody => {\n\tif (bytes.byteLength === 0) {\n\t\treturn { ok: true }\n\t}\n\tlet parsed: unknown\n\ttry {\n\t\tparsed = JSON.parse(new TextDecoder().decode(bytes))\n\t} catch {\n\t\treturn { ok: true }\n\t}\n\tconst scope = isRecord(parsed) ? parsed.scope : undefined\n\tif (scope === undefined || scope === null) {\n\t\treturn { ok: true }\n\t}\n\treturn typeof scope === 'string' ? { ok: true, scope } : { ok: false }\n}\n\ninterface RefreshTarget {\n\t/** The scope whose epoch to raise, null for the install-wide one. */\n\tscope: string | null\n\t/** The body named the scope rather than leaving it to the request's own. */\n\tnamed: boolean\n}\n\n/** The scope a refresh may raise, or the refusal that answers instead. */\nconst refreshTargetOf = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<RefreshTarget | Response> => {\n\tif (!(await readGate(runtime, req))) {\n\t\treturn readDeniedResponse()\n\t}\n\tconst read = await readCappedBody(req, MAX_REFRESH_BODY_BYTES)\n\tif (!read.ok) {\n\t\treturn read.reason === 'too-large'\n\t\t\t? errorResponse(\n\t\t\t\t\t413,\n\t\t\t\t\tanalyticsError('payload_too_large', 'analytics: the refresh body is too large')\n\t\t\t\t)\n\t\t\t: errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tanalyticsError('invalid_param', 'analytics: the refresh body could not be read', 'scope')\n\t\t\t\t)\n\t}\n\tconst body = parseBody(read.body)\n\tif (!body.ok) {\n\t\treturn errorResponse(\n\t\t\t400,\n\t\t\tanalyticsError('invalid_param', 'analytics: scope must be a string', 'scope')\n\t\t)\n\t}\n\tconst requested = await resolveRequestedScope({\n\t\truntime,\n\t\treq,\n\t\traw: body.scope ?? null,\n\t\tgates: scopeGates(runtime, req),\n\t})\n\tif (!requested.ok) {\n\t\treturn untrustedScopeResponse('scope')\n\t}\n\treturn {\n\t\tscope: resolvableScope(requested.scope),\n\t\tnamed: body.scope !== undefined,\n\t}\n}\n\n/**\n * Authenticated POST raising one scope's cache epoch, retiring its cached reads on every instance.\n * Gated like the query endpoint; the wildcard bumps the install-wide token cross-scope reads use.\n */\nexport const makeRefreshHandler = (opts: RefreshHandlerOptions = {}): PayloadHandler => {\n\tconst now = opts.now ?? monotonicMs\n\tconst debounce = createRefreshDebounce(now)\n\n\treturn async (req: PayloadRequest) => {\n\t\tif (!req.user) {\n\t\t\treturn unauthorizedResponse()\n\t\t}\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn notAvailableResponse()\n\t\t}\n\t\tlet target: RefreshTarget | Response\n\t\ttry {\n\t\t\ttarget = await refreshTargetOf(runtime, req)\n\t\t} catch (err) {\n\t\t\t// A throwing `access.read` or scope resolver is a config bug, which a retry repeats.\n\t\t\treq.payload.logger?.error(`analytics: refresh request failed: ${String(err)}`)\n\t\t\treturn errorResponse(500, analyticsError('internal', 'analytics: refresh failed'))\n\t\t}\n\t\tif (target instanceof Response) {\n\t\t\treturn target\n\t\t}\n\t\tconst { scope, named } = target\n\t\ttry {\n\t\t\t// A name nothing belongs to has nothing cached to retire, and must not leave a row behind.\n\t\t\tif (named && scope !== null && !(await knownScope(runtime, req, scope))) {\n\t\t\t\tconst untouched: RefreshResponse = { epoch: INITIAL_EPOCH }\n\t\t\t\treturn Response.json(untouched, { headers: NO_STORE })\n\t\t\t}\n\t\t\tconst key = epochKeyFor(scope)\n\t\t\tif (!debounce.allows(key)) {\n\t\t\t\tconst debounced: RefreshResponse = { epoch: await cacheEpochFor(runtime, scope) }\n\t\t\t\treturn Response.json(debounced, { headers: NO_STORE })\n\t\t\t}\n\t\t\tconst epoch = await (runtime.epoch?.bump(scope) ?? Promise.resolve(INITIAL_EPOCH))\n\t\t\tdebounce.record(key)\n\t\t\tconst answer: RefreshResponse = { epoch }\n\t\t\treturn Response.json(answer, { headers: NO_STORE })\n\t\t} catch (err) {\n\t\t\t// A token that cannot be raised leaves the old numbers being served, which is a\n\t\t\t// retry rather than anything the caller can fix.\n\t\t\treq.payload.logger?.warn(`analytics: cache refresh failed: ${String(err)}`)\n\t\t\treturn errorResponse(\n\t\t\t\t503,\n\t\t\t\tanalyticsError('unavailable', 'analytics: the cache could not be refreshed'),\n\t\t\t\tRETRY_AFTER\n\t\t\t)\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;;;;;AA6BA,MAAa,yBAAyB,IAAI;;;;;AAM1C,MAAa,sBAAsB;;;;;AAoBnC,MAAa,yBACZ,KACA,WAAmB,wBACE;CACrB,MAAM,2BAAW,IAAI,IAAoB;CACzC,OAAO;EACN,OAAO,KAAK;GACX,MAAM,OAAO,SAAS,IAAI,GAAG;GAC7B,OAAO,SAAS,KAAA,KAAa,IAAI,IAAI,QAAQ;EAC9C;EACA,OAAO,KAAK;GACX,MAAM,KAAK,IAAI;GACf,KAAK,MAAM,CAAC,MAAM,SAAS,UAC1B,IAAI,KAAK,QAAQ,UAChB,SAAS,OAAO,IAAI;GAGtB,SAAS,IAAI,KAAK,EAAE;EACrB;EACA,IAAI,OAAO;GACV,OAAO,SAAS;EACjB;CACD;AACD;;;;;AAMA,MAAM,aAAa,OAClB,SACA,KACA,UACsB;CACtB,IAAI,QAAQ,WACX,QAAQ,MAAM,iBAAiB,QAAQ,WAAW,IAAI,OAAO,GAAG,SAAS,KAAK;CAE/E,MAAM,YAAY,QAAQ;CAC1B,IAAI,cAAc,KAAA,KAAa,CAAC,iBAAiB,IAAI,SAAS,SAAS,GACtE,OAAO;CAER,MAAM,SAAS,YAAoB,UAClC,iBAAiB,IAAI,SAAS,UAAU,IACrC,IAAI,QAAQ,GAAG,QAAQ;EAAE;EAAY,OAAO,GAAG,QAAQ,EAAE,QAAQ,MAAM,EAAE;EAAG;CAAI,CAAC,IACjF,QAAQ,QAAQ,IAAI;CACxB,MAAM,YAAY,QAAQ;CAC1B,MAAM,CAAC,QAAQ,UAAU,SAAS,MAAM,QAAQ,IAAI;EACnD,MAAM,WAAW,OAAO;EACxB,YAAY,MAAM,UAAU,MAAM,UAAU,UAAU,IAAI,QAAQ,QAAQ,IAAI;EAC9E,IAAI,QAAQ,GAAG,IAAI,YAAY,KAAK,CAAC;CACtC,CAAC;CACD,OAAO,WAAW,QAAQ,aAAa,QAAQ,UAAU;AAC1D;;;;;AAQA,MAAM,aAAa,UAAmC;CACrD,IAAI,MAAM,eAAe,GACxB,OAAO,EAAE,IAAI,KAAK;CAEnB,IAAI;CACJ,IAAI;EACH,SAAS,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;CACpD,QAAQ;EACP,OAAO,EAAE,IAAI,KAAK;CACnB;CACA,MAAM,QAAQ,SAAS,MAAM,IAAI,OAAO,QAAQ,KAAA;CAChD,IAAI,UAAU,KAAA,KAAa,UAAU,MACpC,OAAO,EAAE,IAAI,KAAK;CAEnB,OAAO,OAAO,UAAU,WAAW;EAAE,IAAI;EAAM;CAAM,IAAI,EAAE,IAAI,MAAM;AACtE;;AAUA,MAAM,kBAAkB,OACvB,SACA,QACuC;CACvC,IAAI,CAAE,MAAM,SAAS,SAAS,GAAG,GAChC,OAAO,mBAAmB;CAE3B,MAAM,OAAO,MAAM,eAAe,KAAK,sBAAsB;CAC7D,IAAI,CAAC,KAAK,IACT,OAAO,KAAK,WAAW,cACpB,cACA,KACA,eAAe,qBAAqB,0CAA0C,CAC/E,IACC,cACA,KACA,eAAe,iBAAiB,iDAAiD,OAAO,CACzF;CAEH,MAAM,OAAO,UAAU,KAAK,IAAI;CAChC,IAAI,CAAC,KAAK,IACT,OAAO,cACN,KACA,eAAe,iBAAiB,qCAAqC,OAAO,CAC7E;CAED,MAAM,YAAY,MAAM,sBAAsB;EAC7C;EACA;EACA,KAAK,KAAK,SAAS;EACnB,OAAO,WAAW,SAAS,GAAG;CAC/B,CAAC;CACD,IAAI,CAAC,UAAU,IACd,OAAO,uBAAuB,OAAO;CAEtC,OAAO;EACN,OAAO,gBAAgB,UAAU,KAAK;EACtC,OAAO,KAAK,UAAU,KAAA;CACvB;AACD;;;;;AAMA,MAAa,sBAAsB,OAA8B,CAAC,MAAsB;CAEvF,MAAM,WAAW,sBADL,KAAK,OAAO,WACkB;CAE1C,OAAO,OAAO,QAAwB;EACrC,IAAI,CAAC,IAAI,MACR,OAAO,qBAAqB;EAE7B,MAAM,UAAU,WAAW,IAAI,OAAO;EACtC,IAAI,CAAC,SACJ,OAAO,qBAAqB;EAE7B,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,gBAAgB,SAAS,GAAG;EAC5C,SAAS,KAAK;GAEb,IAAI,QAAQ,QAAQ,MAAM,sCAAsC,OAAO,GAAG,GAAG;GAC7E,OAAO,cAAc,KAAK,eAAe,YAAY,2BAA2B,CAAC;EAClF;EACA,IAAI,kBAAkB,UACrB,OAAO;EAER,MAAM,EAAE,OAAO,UAAU;EACzB,IAAI;GAEH,IAAI,SAAS,UAAU,QAAQ,CAAE,MAAM,WAAW,SAAS,KAAK,KAAK,GAEpE,OAAO,SAAS,KAAK,EADgB,OAAA,IAChB,GAAW,EAAE,SAAS,SAAS,CAAC;GAEtD,MAAM,MAAM,YAAY,KAAK;GAC7B,IAAI,CAAC,SAAS,OAAO,GAAG,GAAG;IAC1B,MAAM,YAA6B,EAAE,OAAO,MAAM,cAAc,SAAS,KAAK,EAAE;IAChF,OAAO,SAAS,KAAK,WAAW,EAAE,SAAS,SAAS,CAAC;GACtD;GACA,MAAM,QAAQ,OAAO,QAAQ,OAAO,KAAK,KAAK,KAAK,QAAQ,QAAA,GAAqB;GAChF,SAAS,OAAO,GAAG;GACnB,MAAM,SAA0B,EAAE,MAAM;GACxC,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;EACnD,SAAS,KAAK;GAGb,IAAI,QAAQ,QAAQ,KAAK,oCAAoC,OAAO,GAAG,GAAG;GAC1E,OAAO,cACN,KACA,eAAe,eAAe,6CAA6C,GAC3E,WACD;EACD;CACD;AACD"}
@@ -0,0 +1,36 @@
1
+ import { isRecord } from "../core/values.js";
2
+ import { builtInLabelKey } from "../translations/staticLabel.js";
3
+ import { walkFields } from "./walkFields.js";
4
+ //#region src/plugin/relabelFields.ts
5
+ /** Swaps a built-in static label held at `target[key]` for the install's own strings. */
6
+ const relabelAt = (target, key, staticLabel) => {
7
+ const builtIn = builtInLabelKey(Reflect.get(target, key));
8
+ if (builtIn !== void 0) Object.assign(target, { [key]: staticLabel(builtIn) });
9
+ };
10
+ const relabelField = (field, staticLabel) => {
11
+ relabelAt(field, "label", staticLabel);
12
+ const admin = "admin" in field ? field.admin : void 0;
13
+ if (isRecord(admin)) {
14
+ relabelAt(admin, "description", staticLabel);
15
+ relabelAt(admin, "placeholder", staticLabel);
16
+ }
17
+ if ("options" in field && Array.isArray(field.options)) {
18
+ for (const option of field.options) if (isRecord(option)) relabelAt(option, "label", staticLabel);
19
+ }
20
+ };
21
+ /**
22
+ * Field factories run before the plugin sees its `translations` option, so their static labels hold
23
+ * built-in strings. This swaps each for the install's own across collections, globals and blocks.
24
+ */
25
+ const relabelFactoryFields = (config, staticLabel) => {
26
+ const relabel = (fields) => {
27
+ for (const field of walkFields(fields)) relabelField(field, staticLabel);
28
+ };
29
+ for (const collection of config.collections ?? []) relabel(collection.fields);
30
+ for (const global of config.globals ?? []) relabel(global.fields);
31
+ for (const block of config.blocks ?? []) relabel(block.fields);
32
+ };
33
+ //#endregion
34
+ export { relabelFactoryFields };
35
+
36
+ //# sourceMappingURL=relabelFields.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relabelFields.js","names":[],"sources":["../../src/plugin/relabelFields.ts"],"sourcesContent":["import type { Config, Field } from 'payload'\nimport { isRecord } from '../core/values'\nimport { builtInLabelKey, type StaticLabelFor } from '../translations/staticLabel'\nimport { walkFields } from './walkFields'\n\n/** Swaps a built-in static label held at `target[key]` for the install's own strings. */\nconst relabelAt = (target: object, key: string, staticLabel: StaticLabelFor): void => {\n\tconst builtIn = builtInLabelKey(Reflect.get(target, key))\n\tif (builtIn !== undefined) {\n\t\tObject.assign(target, { [key]: staticLabel(builtIn) })\n\t}\n}\n\nconst relabelField = (field: Field, staticLabel: StaticLabelFor): void => {\n\trelabelAt(field, 'label', staticLabel)\n\tconst admin: unknown = 'admin' in field ? field.admin : undefined\n\tif (isRecord(admin)) {\n\t\trelabelAt(admin, 'description', staticLabel)\n\t\trelabelAt(admin, 'placeholder', staticLabel)\n\t}\n\tif ('options' in field && Array.isArray(field.options)) {\n\t\tfor (const option of field.options) {\n\t\t\tif (isRecord(option)) {\n\t\t\t\trelabelAt(option, 'label', staticLabel)\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * Field factories run before the plugin sees its `translations` option, so their static labels hold\n * built-in strings. This swaps each for the install's own across collections, globals and blocks.\n */\nexport const relabelFactoryFields = (config: Config, staticLabel: StaticLabelFor): void => {\n\tconst relabel = (fields: Field[]): void => {\n\t\tfor (const field of walkFields(fields)) {\n\t\t\trelabelField(field, staticLabel)\n\t\t}\n\t}\n\tfor (const collection of config.collections ?? []) relabel(collection.fields)\n\tfor (const global of config.globals ?? []) relabel(global.fields)\n\tfor (const block of config.blocks ?? []) relabel(block.fields)\n}\n"],"mappings":";;;;;AAMA,MAAM,aAAa,QAAgB,KAAa,gBAAsC;CACrF,MAAM,UAAU,gBAAgB,QAAQ,IAAI,QAAQ,GAAG,CAAC;CACxD,IAAI,YAAY,KAAA,GACf,OAAO,OAAO,QAAQ,GAAG,MAAM,YAAY,OAAO,EAAE,CAAC;AAEvD;AAEA,MAAM,gBAAgB,OAAc,gBAAsC;CACzE,UAAU,OAAO,SAAS,WAAW;CACrC,MAAM,QAAiB,WAAW,QAAQ,MAAM,QAAQ,KAAA;CACxD,IAAI,SAAS,KAAK,GAAG;EACpB,UAAU,OAAO,eAAe,WAAW;EAC3C,UAAU,OAAO,eAAe,WAAW;CAC5C;CACA,IAAI,aAAa,SAAS,MAAM,QAAQ,MAAM,OAAO;OAC/C,MAAM,UAAU,MAAM,SAC1B,IAAI,SAAS,MAAM,GAClB,UAAU,QAAQ,SAAS,WAAW;CAAA;AAI1C;;;;;AAMA,MAAa,wBAAwB,QAAgB,gBAAsC;CAC1F,MAAM,WAAW,WAA0B;EAC1C,KAAK,MAAM,SAAS,WAAW,MAAM,GACpC,aAAa,OAAO,WAAW;CAEjC;CACA,KAAK,MAAM,cAAc,OAAO,eAAe,CAAC,GAAG,QAAQ,WAAW,MAAM;CAC5E,KAAK,MAAM,UAAU,OAAO,WAAW,CAAC,GAAG,QAAQ,OAAO,MAAM;CAChE,KAAK,MAAM,SAAS,OAAO,UAAU,CAAC,GAAG,QAAQ,MAAM,MAAM;AAC9D"}
@@ -0,0 +1,35 @@
1
+ //#region src/plugin/requestMemo.ts
2
+ /** A Local API call reusing a request may swap its user, and an answer is about one user. */
3
+ const userKey = (req) => req.user ? `${String(req.user.collection)}:${String(req.user.id)}` : "-";
4
+ /**
5
+ * Memo kept on the request, not a module map, so the `.` and `/rsc` bundles share one answer via
6
+ * `Symbol.for`. Computed once per owner, key and user; a rejection rejects every caller alike.
7
+ */
8
+ const requestMemo = (name) => {
9
+ const slot = Symbol.for(`@10x-media/analytics/${name}`);
10
+ const ownersOf = (req) => {
11
+ const existing = Reflect.get(req, slot);
12
+ if (existing instanceof WeakMap) return existing;
13
+ const created = /* @__PURE__ */ new WeakMap();
14
+ Reflect.set(req, slot, created);
15
+ return created;
16
+ };
17
+ return (req, { owner, key, compute }) => {
18
+ const owners = ownersOf(req);
19
+ let owned = owners.get(owner);
20
+ if (!owned) {
21
+ owned = /* @__PURE__ */ new Map();
22
+ owners.set(owner, owned);
23
+ }
24
+ const id = `${key}|${userKey(req)}`;
25
+ const known = owned.get(id);
26
+ if (known) return known;
27
+ const answer = (async () => compute())();
28
+ owned.set(id, answer);
29
+ return answer;
30
+ };
31
+ };
32
+ //#endregion
33
+ export { requestMemo };
34
+
35
+ //# sourceMappingURL=requestMemo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requestMemo.js","names":[],"sources":["../../src/plugin/requestMemo.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\n/** A Local API call reusing a request may swap its user, and an answer is about one user. */\nexport const userKey = (req: PayloadRequest): string =>\n\treq.user ? `${String(req.user.collection)}:${String(req.user.id)}` : '-'\n\ninterface RequestMemoEntry<T> {\n\t/** Whatever answers it, the runtime or a host function: two owners never share an answer. */\n\towner: object\n\t/** What is being answered, unique per owner. */\n\tkey: string\n\tcompute: () => T | Promise<T>\n}\n\n/** Answers one memo entry, computing it only the first time this request and user ask. */\ntype RequestMemo<T> = (req: PayloadRequest, entry: RequestMemoEntry<T>) => Promise<T>\n\n/**\n * Memo kept on the request, not a module map, so the `.` and `/rsc` bundles share one answer via\n * `Symbol.for`. Computed once per owner, key and user; a rejection rejects every caller alike.\n */\nexport const requestMemo = <T>(name: string): RequestMemo<T> => {\n\tconst slot = Symbol.for(`@10x-media/analytics/${name}`)\n\tconst ownersOf = (req: PayloadRequest): WeakMap<object, Map<string, Promise<T>>> => {\n\t\tconst existing: unknown = Reflect.get(req, slot)\n\t\tif (existing instanceof WeakMap) {\n\t\t\treturn existing\n\t\t}\n\t\tconst created = new WeakMap<object, Map<string, Promise<T>>>()\n\t\tReflect.set(req, slot, created)\n\t\treturn created\n\t}\n\treturn (req, { owner, key, compute }) => {\n\t\tconst owners = ownersOf(req)\n\t\tlet owned = owners.get(owner)\n\t\tif (!owned) {\n\t\t\towned = new Map()\n\t\t\towners.set(owner, owned)\n\t\t}\n\t\tconst id = `${key}|${userKey(req)}`\n\t\tconst known = owned.get(id)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst answer = (async () => compute())()\n\t\towned.set(id, answer)\n\t\treturn answer\n\t}\n}\n"],"mappings":";;AAGA,MAAa,WAAW,QACvB,IAAI,OAAO,GAAG,OAAO,IAAI,KAAK,UAAU,EAAE,GAAG,OAAO,IAAI,KAAK,EAAE,MAAM;;;;;AAiBtE,MAAa,eAAkB,SAAiC;CAC/D,MAAM,OAAO,OAAO,IAAI,wBAAwB,MAAM;CACtD,MAAM,YAAY,QAAkE;EACnF,MAAM,WAAoB,QAAQ,IAAI,KAAK,IAAI;EAC/C,IAAI,oBAAoB,SACvB,OAAO;EAER,MAAM,0BAAU,IAAI,QAAyC;EAC7D,QAAQ,IAAI,KAAK,MAAM,OAAO;EAC9B,OAAO;CACR;CACA,QAAQ,KAAK,EAAE,OAAO,KAAK,cAAc;EACxC,MAAM,SAAS,SAAS,GAAG;EAC3B,IAAI,QAAQ,OAAO,IAAI,KAAK;EAC5B,IAAI,CAAC,OAAO;GACX,wBAAQ,IAAI,IAAI;GAChB,OAAO,IAAI,OAAO,KAAK;EACxB;EACA,MAAM,KAAK,GAAG,IAAI,GAAG,QAAQ,GAAG;EAChC,MAAM,QAAQ,MAAM,IAAI,EAAE;EAC1B,IAAI,OACH,OAAO;EAER,MAAM,UAAU,YAAY,QAAQ,GAAG;EACvC,MAAM,IAAI,IAAI,MAAM;EACpB,OAAO;CACR;AACD"}
@@ -0,0 +1,39 @@
1
+ import { assertRouteBaseUnshadowed, isPluginEndpoint } from "./routes.js";
2
+ import { compile, match, parse } from "path-to-regexp";
3
+ //#region src/plugin/routeChecks.ts
4
+ /** A path the pattern matches, each of its parameters filled with a sample segment. */
5
+ const samplePath = (pattern) => {
6
+ const params = {};
7
+ for (const token of parse(pattern)) if (typeof token !== "string") params[String(token.name)] = token.modifier === "*" || token.modifier === "+" ? ["sample"] : "sample";
8
+ return compile(pattern, { validate: false })(params);
9
+ };
10
+ /**
11
+ * The first plugin endpoint an earlier one takes: Payload's `handleEndpoints` answers with the first
12
+ * endpoint whose method equals the request's and whose path path-to-regexp matches.
13
+ */
14
+ const shadowedRoute = (endpoints) => {
15
+ for (const [index, ours] of endpoints.entries()) {
16
+ if (!isPluginEndpoint(ours)) continue;
17
+ const sample = samplePath(ours.path);
18
+ for (const earlier of endpoints.slice(0, index)) if (!isPluginEndpoint(earlier) && earlier.method === ours.method && match(earlier.path, { decode: decodeURIComponent })(sample) !== false) return {
19
+ earlier,
20
+ ours
21
+ };
22
+ }
23
+ };
24
+ /**
25
+ * Refuses an install where Payload would hand the plugin's requests to a collection named like the
26
+ * base's first segment, or to a root endpoint registered before the plugin's own that matches one.
27
+ */
28
+ const assertRoutesReachable = (base, config) => {
29
+ assertRouteBaseUnshadowed(base, config.collections.map((collection) => collection.slug));
30
+ const shadowed = shadowedRoute(config.endpoints || []);
31
+ if (shadowed) {
32
+ const { earlier, ours } = shadowed;
33
+ throw new Error(`analytics: the root endpoint "${earlier.method.toUpperCase()} ${earlier.path}" is registered before the plugin's "${ours.path}" and matches it, so Payload would hand it every request meant for the plugin. Set routes.base to a path that endpoint does not match, or give that endpoint a path of its own.`);
34
+ }
35
+ };
36
+ //#endregion
37
+ export { assertRoutesReachable };
38
+
39
+ //# sourceMappingURL=routeChecks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routeChecks.js","names":[],"sources":["../../src/plugin/routeChecks.ts"],"sourcesContent":["import { compile, match, parse } from 'path-to-regexp'\nimport {\n\tassertRouteBaseUnshadowed,\n\tisPluginEndpoint,\n\ttype RootEndpointShape,\n\ttype RouteBase,\n} from './routes'\n\n/** A path the pattern matches, each of its parameters filled with a sample segment. */\nexport const samplePath = (pattern: string): string => {\n\tconst params: Record<string, string | string[]> = {}\n\tfor (const token of parse(pattern)) {\n\t\tif (typeof token !== 'string') {\n\t\t\tparams[String(token.name)] =\n\t\t\t\ttoken.modifier === '*' || token.modifier === '+' ? ['sample'] : 'sample'\n\t\t}\n\t}\n\treturn compile(pattern, { validate: false })(params)\n}\n\n/** A root endpoint registered before the plugin's own `ours` that would answer its requests. */\ninterface ShadowedRoute {\n\tearlier: RootEndpointShape\n\tours: RootEndpointShape\n}\n\n/**\n * The first plugin endpoint an earlier one takes: Payload's `handleEndpoints` answers with the first\n * endpoint whose method equals the request's and whose path path-to-regexp matches.\n */\nexport const shadowedRoute = (\n\tendpoints: readonly RootEndpointShape[]\n): ShadowedRoute | undefined => {\n\tfor (const [index, ours] of endpoints.entries()) {\n\t\tif (!isPluginEndpoint(ours)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst sample = samplePath(ours.path)\n\t\tfor (const earlier of endpoints.slice(0, index)) {\n\t\t\tif (\n\t\t\t\t!isPluginEndpoint(earlier) &&\n\t\t\t\tearlier.method === ours.method &&\n\t\t\t\tmatch(earlier.path, { decode: decodeURIComponent })(sample) !== false\n\t\t\t) {\n\t\t\t\treturn { earlier, ours }\n\t\t\t}\n\t\t}\n\t}\n\treturn undefined\n}\n\n/** The slice of an assembled Payload config the route checks read. */\ninterface RoutedConfig {\n\tcollections: ReadonlyArray<{ slug: string }>\n\tendpoints?: readonly RootEndpointShape[] | false | undefined\n}\n\n/**\n * Refuses an install where Payload would hand the plugin's requests to a collection named like the\n * base's first segment, or to a root endpoint registered before the plugin's own that matches one.\n */\nexport const assertRoutesReachable = (base: RouteBase, config: RoutedConfig): void => {\n\tassertRouteBaseUnshadowed(\n\t\tbase,\n\t\tconfig.collections.map((collection) => collection.slug)\n\t)\n\tconst shadowed = shadowedRoute(config.endpoints || [])\n\tif (shadowed) {\n\t\tconst { earlier, ours } = shadowed\n\t\tthrow new Error(\n\t\t\t`analytics: the root endpoint \"${earlier.method.toUpperCase()} ${earlier.path}\" is registered before the plugin's \"${ours.path}\" and matches it, so Payload would hand it every request meant for the plugin. Set routes.base to a path that endpoint does not match, or give that endpoint a path of its own.`\n\t\t)\n\t}\n}\n"],"mappings":";;;;AASA,MAAa,cAAc,YAA4B;CACtD,MAAM,SAA4C,CAAC;CACnD,KAAK,MAAM,SAAS,MAAM,OAAO,GAChC,IAAI,OAAO,UAAU,UACpB,OAAO,OAAO,MAAM,IAAI,KACvB,MAAM,aAAa,OAAO,MAAM,aAAa,MAAM,CAAC,QAAQ,IAAI;CAGnE,OAAO,QAAQ,SAAS,EAAE,UAAU,MAAM,CAAC,EAAE,MAAM;AACpD;;;;;AAYA,MAAa,iBACZ,cAC+B;CAC/B,KAAK,MAAM,CAAC,OAAO,SAAS,UAAU,QAAQ,GAAG;EAChD,IAAI,CAAC,iBAAiB,IAAI,GACzB;EAED,MAAM,SAAS,WAAW,KAAK,IAAI;EACnC,KAAK,MAAM,WAAW,UAAU,MAAM,GAAG,KAAK,GAC7C,IACC,CAAC,iBAAiB,OAAO,KACzB,QAAQ,WAAW,KAAK,UACxB,MAAM,QAAQ,MAAM,EAAE,QAAQ,mBAAmB,CAAC,EAAE,MAAM,MAAM,OAEhE,OAAO;GAAE;GAAS;EAAK;CAG1B;AAED;;;;;AAYA,MAAa,yBAAyB,MAAiB,WAA+B;CACrF,0BACC,MACA,OAAO,YAAY,KAAK,eAAe,WAAW,IAAI,CACvD;CACA,MAAM,WAAW,cAAc,OAAO,aAAa,CAAC,CAAC;CACrD,IAAI,UAAU;EACb,MAAM,EAAE,SAAS,SAAS;EAC1B,MAAM,IAAI,MACT,iCAAiC,QAAQ,OAAO,YAAY,EAAE,GAAG,QAAQ,KAAK,uCAAuC,KAAK,KAAK,gLAChI;CACD;AACD"}
@@ -0,0 +1,53 @@
1
+ //#region src/plugin/routes.d.ts
2
+ /**
3
+ * Every mount the plugin registers under `routes.api`, all off one base. Free of server code, so
4
+ * client components and the browser tracker import it.
5
+ */
6
+ /** A path under `routes.api`, with its leading slash and without a trailing one. */
7
+ type RouteBase = `/${string}`;
8
+ /** Short, and no word an ad blocker's filter list would match. */
9
+ declare const DEFAULT_ROUTE_BASE: RouteBase;
10
+ interface RoutePaths {
11
+ base: RouteBase;
12
+ /** Authenticated read over the surfacing engine. */
13
+ query: string;
14
+ /** Authenticated read behind a document's analytics panel. */
15
+ document: string;
16
+ /** Authenticated list of the sources a request may read. */
17
+ sources: string;
18
+ /** Authenticated goal list for the admin goal picker. */
19
+ goals: string;
20
+ /** Authenticated POST retiring a scope's cached reads. */
21
+ refresh: string;
22
+ /** Authenticated realtime read the live counters poll. */
23
+ live: string;
24
+ /** Authenticated exclusion link for the selected scope; mounted while `capture.exclusion` is on. */
25
+ exclusion: string;
26
+ /** Public native ingest, and the default `native({ ingestPath })`. */
27
+ ingest: string;
28
+ /** Public tracker config. */
29
+ config: string;
30
+ /** Mount of the public capture proxy; a slot answers under `${proxy}/<slot>`. */
31
+ proxy: string;
32
+ /** The capture proxy's registered pattern. */
33
+ proxyPattern: string;
34
+ /** Mount of the public flag route; one flag answers under `${flags}/<code>.svg`. */
35
+ flags: string;
36
+ /** The flag route's registered pattern. */
37
+ flagsPattern: string;
38
+ }
39
+ declare const routePaths: (base: RouteBase) => RoutePaths;
40
+ /** The slice of a Payload config, server or client, the base is read from. */
41
+ interface RoutesConfigSource {
42
+ admin?: {
43
+ custom?: Record<string, unknown>;
44
+ } | undefined;
45
+ }
46
+ /**
47
+ * The mounts one Payload config resolved, read from `config.admin.custom` by server and client
48
+ * code alike. A config the plugin never touched answers the default base.
49
+ */
50
+ declare const analyticsRoutes: (config: RoutesConfigSource | null | undefined) => RoutePaths;
51
+ //#endregion
52
+ export { DEFAULT_ROUTE_BASE, RouteBase, RoutePaths, RoutesConfigSource, analyticsRoutes, routePaths };
53
+ //# sourceMappingURL=routes.d.ts.map
@@ -0,0 +1,92 @@
1
+ import { isRecord } from "../core/values.js";
2
+ //#region src/plugin/routes.ts
3
+ /**
4
+ * Every mount the plugin registers under `routes.api`, all off one base. Free of server code, so
5
+ * client components and the browser tracker import it.
6
+ */
7
+ /** Short, and no word an ad blocker's filter list would match. */
8
+ const DEFAULT_ROUTE_BASE = "/_x";
9
+ /**
10
+ * The plugin's key in `config.custom`, which holds its server-only runtime factory, and in
11
+ * `config.admin.custom`, which reaches the client config and carries the resolved base.
12
+ */
13
+ const ANALYTICS_CONFIG_KEY = "@10x-media/analytics";
14
+ const routePaths = (base) => ({
15
+ base,
16
+ query: `${base}/query`,
17
+ document: `${base}/document`,
18
+ sources: `${base}/sources`,
19
+ goals: `${base}/goals`,
20
+ refresh: `${base}/refresh`,
21
+ live: `${base}/live`,
22
+ exclusion: `${base}/exclusion`,
23
+ ingest: `${base}/e`,
24
+ config: `${base}/config`,
25
+ proxy: `${base}/p`,
26
+ proxyPattern: `${base}/p/:slot/:path*`,
27
+ flags: `${base}/flags`,
28
+ flagsPattern: `${base}/flags/:code`
29
+ });
30
+ /** Plain segments of URL-safe characters, none starting with a dot. */
31
+ const BASE_PATTERN = /^(?:\/[A-Za-z0-9_~-][A-Za-z0-9._~-]*)+$/;
32
+ /**
33
+ * Payload strips a leading `/globals` from every API path before it routes, so a base starting
34
+ * with it would be read as a global's route instead.
35
+ */
36
+ const GLOBALS_PREFIX = "/globals";
37
+ /**
38
+ * Payload looks a request's first segment up on `payload.collections`, a plain object, so one of
39
+ * `Object.prototype`'s keys finds something there and every request fails before any endpoint runs.
40
+ */
41
+ const INHERITED_KEYS = new Set(Object.getOwnPropertyNames(Object.prototype));
42
+ const firstSegment = (path) => path.split("/")[1] ?? "";
43
+ const isRouteBase = (value) => typeof value === "string" && BASE_PATTERN.test(value) && !value.startsWith(GLOBALS_PREFIX) && !INHERITED_KEYS.has(firstSegment(value));
44
+ /** A `routes.base` option checked for a path Payload can route, or the default when unset. */
45
+ const resolveRouteBase = (value) => {
46
+ if (value === void 0) return "/_x";
47
+ if (typeof value === "string" && value.startsWith(GLOBALS_PREFIX)) throw new Error(`analytics: routes.base "${value}" starts with "${GLOBALS_PREFIX}", which Payload routes to its globals; choose another first segment`);
48
+ if (typeof value === "string" && INHERITED_KEYS.has(firstSegment(value))) throw new Error(`analytics: routes.base "${value}" starts with "${firstSegment(value)}", a name every JavaScript object carries, which Payload would take for a collection; choose another first segment`);
49
+ if (!isRouteBase(value)) throw new Error(`analytics: routes.base must be a path of plain segments such as "/_x" (letters, digits, "-", "_", "." and "~", no trailing slash), got ${typeof value === "string" ? `"${value}"` : typeof value}`);
50
+ return value;
51
+ };
52
+ /** The base's first segment, which Payload compares against every collection slug. */
53
+ const routeBaseSegment = (base) => firstSegment(base);
54
+ /**
55
+ * The collection that would take every request under the base: Payload hands `<api>/<segment>/...`
56
+ * to the collection slugged `<segment>` before it tries a root endpoint.
57
+ */
58
+ const shadowingCollection = (base, slugs) => {
59
+ const segment = routeBaseSegment(base);
60
+ for (const slug of slugs) if (slug === segment) return slug;
61
+ };
62
+ /** Refuses a base some collection would shadow, naming that collection and the option to change. */
63
+ const assertRouteBaseUnshadowed = (base, slugs) => {
64
+ const slug = shadowingCollection(base, slugs);
65
+ if (slug !== void 0) throw new Error(`analytics: the "${slug}" collection's slug is the first segment of routes.base "${base}", so Payload would hand every analytics request to that collection. Set routes.base to a path whose first segment is no collection's slug.`);
66
+ };
67
+ /**
68
+ * The endpoint with the plugin's mark in its `custom`, which is how the route checks tell the
69
+ * plugin's own root endpoints from those registered before it.
70
+ */
71
+ const pluginEndpoint = (endpoint) => ({
72
+ ...endpoint,
73
+ custom: {
74
+ ...endpoint.custom,
75
+ [ANALYTICS_CONFIG_KEY]: true
76
+ }
77
+ });
78
+ const isPluginEndpoint = (endpoint) => endpoint.custom?.[ANALYTICS_CONFIG_KEY] === true;
79
+ /**
80
+ * The mounts one Payload config resolved, read from `config.admin.custom` by server and client
81
+ * code alike. A config the plugin never touched answers the default base.
82
+ */
83
+ const analyticsRoutes = (config) => {
84
+ const entry = config?.admin?.custom?.[ANALYTICS_CONFIG_KEY];
85
+ const routes = isRecord(entry) ? entry.routes : void 0;
86
+ const base = isRecord(routes) ? routes.base : void 0;
87
+ return routePaths(isRouteBase(base) ? base : "/_x");
88
+ };
89
+ //#endregion
90
+ export { ANALYTICS_CONFIG_KEY, DEFAULT_ROUTE_BASE, analyticsRoutes, assertRouteBaseUnshadowed, isPluginEndpoint, pluginEndpoint, resolveRouteBase, routePaths };
91
+
92
+ //# sourceMappingURL=routes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.js","names":[],"sources":["../../src/plugin/routes.ts"],"sourcesContent":["/**\n * Every mount the plugin registers under `routes.api`, all off one base. Free of server code, so\n * client components and the browser tracker import it.\n */\n\nimport { isRecord } from '../core/values'\n\n/** A path under `routes.api`, with its leading slash and without a trailing one. */\nexport type RouteBase = `/${string}`\n\n/** Short, and no word an ad blocker's filter list would match. */\nexport const DEFAULT_ROUTE_BASE: RouteBase = '/_x'\n\n/**\n * The plugin's key in `config.custom`, which holds its server-only runtime factory, and in\n * `config.admin.custom`, which reaches the client config and carries the resolved base.\n */\nexport const ANALYTICS_CONFIG_KEY = '@10x-media/analytics'\n\nexport interface RoutePaths {\n\tbase: RouteBase\n\t/** Authenticated read over the surfacing engine. */\n\tquery: string\n\t/** Authenticated read behind a document's analytics panel. */\n\tdocument: string\n\t/** Authenticated list of the sources a request may read. */\n\tsources: string\n\t/** Authenticated goal list for the admin goal picker. */\n\tgoals: string\n\t/** Authenticated POST retiring a scope's cached reads. */\n\trefresh: string\n\t/** Authenticated realtime read the live counters poll. */\n\tlive: string\n\t/** Authenticated exclusion link for the selected scope; mounted while `capture.exclusion` is on. */\n\texclusion: string\n\t/** Public native ingest, and the default `native({ ingestPath })`. */\n\tingest: string\n\t/** Public tracker config. */\n\tconfig: string\n\t/** Mount of the public capture proxy; a slot answers under `${proxy}/<slot>`. */\n\tproxy: string\n\t/** The capture proxy's registered pattern. */\n\tproxyPattern: string\n\t/** Mount of the public flag route; one flag answers under `${flags}/<code>.svg`. */\n\tflags: string\n\t/** The flag route's registered pattern. */\n\tflagsPattern: string\n}\n\nexport const routePaths = (base: RouteBase): RoutePaths => ({\n\tbase,\n\tquery: `${base}/query`,\n\tdocument: `${base}/document`,\n\tsources: `${base}/sources`,\n\tgoals: `${base}/goals`,\n\trefresh: `${base}/refresh`,\n\tlive: `${base}/live`,\n\texclusion: `${base}/exclusion`,\n\tingest: `${base}/e`,\n\tconfig: `${base}/config`,\n\tproxy: `${base}/p`,\n\tproxyPattern: `${base}/p/:slot/:path*`,\n\tflags: `${base}/flags`,\n\tflagsPattern: `${base}/flags/:code`,\n})\n\n/** Plain segments of URL-safe characters, none starting with a dot. */\nconst BASE_PATTERN = /^(?:\\/[A-Za-z0-9_~-][A-Za-z0-9._~-]*)+$/\n\n/**\n * Payload strips a leading `/globals` from every API path before it routes, so a base starting\n * with it would be read as a global's route instead.\n */\nconst GLOBALS_PREFIX = '/globals'\n\n/**\n * Payload looks a request's first segment up on `payload.collections`, a plain object, so one of\n * `Object.prototype`'s keys finds something there and every request fails before any endpoint runs.\n */\nconst INHERITED_KEYS: ReadonlySet<string> = new Set(Object.getOwnPropertyNames(Object.prototype))\n\nconst firstSegment = (path: string): string => path.split('/')[1] ?? ''\n\nexport const isRouteBase = (value: unknown): value is RouteBase =>\n\ttypeof value === 'string' &&\n\tBASE_PATTERN.test(value) &&\n\t!value.startsWith(GLOBALS_PREFIX) &&\n\t!INHERITED_KEYS.has(firstSegment(value))\n\n/** A `routes.base` option checked for a path Payload can route, or the default when unset. */\nexport const resolveRouteBase = (value: unknown): RouteBase => {\n\tif (value === undefined) {\n\t\treturn DEFAULT_ROUTE_BASE\n\t}\n\tif (typeof value === 'string' && value.startsWith(GLOBALS_PREFIX)) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base \"${value}\" starts with \"${GLOBALS_PREFIX}\", which Payload routes to its globals; choose another first segment`\n\t\t)\n\t}\n\tif (typeof value === 'string' && INHERITED_KEYS.has(firstSegment(value))) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base \"${value}\" starts with \"${firstSegment(value)}\", a name every JavaScript object carries, which Payload would take for a collection; choose another first segment`\n\t\t)\n\t}\n\tif (!isRouteBase(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base must be a path of plain segments such as \"${DEFAULT_ROUTE_BASE}\" (letters, digits, \"-\", \"_\", \".\" and \"~\", no trailing slash), got ${typeof value === 'string' ? `\"${value}\"` : typeof value}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** The base's first segment, which Payload compares against every collection slug. */\nexport const routeBaseSegment = (base: RouteBase): string => firstSegment(base)\n\n/**\n * The collection that would take every request under the base: Payload hands `<api>/<segment>/...`\n * to the collection slugged `<segment>` before it tries a root endpoint.\n */\nexport const shadowingCollection = (\n\tbase: RouteBase,\n\tslugs: Iterable<string>\n): string | undefined => {\n\tconst segment = routeBaseSegment(base)\n\tfor (const slug of slugs) {\n\t\tif (slug === segment) {\n\t\t\treturn slug\n\t\t}\n\t}\n\treturn undefined\n}\n\n/** Refuses a base some collection would shadow, naming that collection and the option to change. */\nexport const assertRouteBaseUnshadowed = (base: RouteBase, slugs: Iterable<string>): void => {\n\tconst slug = shadowingCollection(base, slugs)\n\tif (slug !== undefined) {\n\t\tthrow new Error(\n\t\t\t`analytics: the \"${slug}\" collection's slug is the first segment of routes.base \"${base}\", so Payload would hand every analytics request to that collection. Set routes.base to a path whose first segment is no collection's slug.`\n\t\t)\n\t}\n}\n\n/** What the plugin leaves under its key in `config.admin.custom`. */\nexport interface AnalyticsAdminCustom {\n\troutes: { base: RouteBase }\n}\n\n/** The slice of a root endpoint the route checks read. */\nexport interface RootEndpointShape {\n\tmethod: string\n\tpath: string\n\tcustom?: Record<string, unknown> | undefined\n}\n\n/**\n * The endpoint with the plugin's mark in its `custom`, which is how the route checks tell the\n * plugin's own root endpoints from those registered before it.\n */\nexport const pluginEndpoint = <T extends RootEndpointShape>(endpoint: T): T => ({\n\t...endpoint,\n\tcustom: { ...endpoint.custom, [ANALYTICS_CONFIG_KEY]: true },\n})\n\nexport const isPluginEndpoint = (endpoint: RootEndpointShape): boolean =>\n\tendpoint.custom?.[ANALYTICS_CONFIG_KEY] === true\n\n/** The slice of a Payload config, server or client, the base is read from. */\nexport interface RoutesConfigSource {\n\tadmin?: { custom?: Record<string, unknown> } | undefined\n}\n\n/**\n * The mounts one Payload config resolved, read from `config.admin.custom` by server and client\n * code alike. A config the plugin never touched answers the default base.\n */\nexport const analyticsRoutes = (config: RoutesConfigSource | null | undefined): RoutePaths => {\n\tconst entry = config?.admin?.custom?.[ANALYTICS_CONFIG_KEY]\n\tconst routes = isRecord(entry) ? entry.routes : undefined\n\tconst base = isRecord(routes) ? routes.base : undefined\n\treturn routePaths(isRouteBase(base) ? base : DEFAULT_ROUTE_BASE)\n}\n"],"mappings":";;;;;;;AAWA,MAAa,qBAAgC;;;;;AAM7C,MAAa,uBAAuB;AAgCpC,MAAa,cAAc,UAAiC;CAC3D;CACA,OAAO,GAAG,KAAK;CACf,UAAU,GAAG,KAAK;CAClB,SAAS,GAAG,KAAK;CACjB,OAAO,GAAG,KAAK;CACf,SAAS,GAAG,KAAK;CACjB,MAAM,GAAG,KAAK;CACd,WAAW,GAAG,KAAK;CACnB,QAAQ,GAAG,KAAK;CAChB,QAAQ,GAAG,KAAK;CAChB,OAAO,GAAG,KAAK;CACf,cAAc,GAAG,KAAK;CACtB,OAAO,GAAG,KAAK;CACf,cAAc,GAAG,KAAK;AACvB;;AAGA,MAAM,eAAe;;;;;AAMrB,MAAM,iBAAiB;;;;;AAMvB,MAAM,iBAAsC,IAAI,IAAI,OAAO,oBAAoB,OAAO,SAAS,CAAC;AAEhG,MAAM,gBAAgB,SAAyB,KAAK,MAAM,GAAG,EAAE,MAAM;AAErE,MAAa,eAAe,UAC3B,OAAO,UAAU,YACjB,aAAa,KAAK,KAAK,KACvB,CAAC,MAAM,WAAW,cAAc,KAChC,CAAC,eAAe,IAAI,aAAa,KAAK,CAAC;;AAGxC,MAAa,oBAAoB,UAA8B;CAC9D,IAAI,UAAU,KAAA,GACb,OAAA;CAED,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,cAAc,GAC/D,MAAM,IAAI,MACT,2BAA2B,MAAM,iBAAiB,eAAe,qEAClE;CAED,IAAI,OAAO,UAAU,YAAY,eAAe,IAAI,aAAa,KAAK,CAAC,GACtE,MAAM,IAAI,MACT,2BAA2B,MAAM,iBAAiB,aAAa,KAAK,EAAE,mHACvE;CAED,IAAI,CAAC,YAAY,KAAK,GACrB,MAAM,IAAI,MACT,0IAA4J,OAAO,UAAU,WAAW,IAAI,MAAM,KAAK,OAAO,OAC/M;CAED,OAAO;AACR;;AAGA,MAAa,oBAAoB,SAA4B,aAAa,IAAI;;;;;AAM9E,MAAa,uBACZ,MACA,UACwB;CACxB,MAAM,UAAU,iBAAiB,IAAI;CACrC,KAAK,MAAM,QAAQ,OAClB,IAAI,SAAS,SACZ,OAAO;AAIV;;AAGA,MAAa,6BAA6B,MAAiB,UAAkC;CAC5F,MAAM,OAAO,oBAAoB,MAAM,KAAK;CAC5C,IAAI,SAAS,KAAA,GACZ,MAAM,IAAI,MACT,mBAAmB,KAAK,2DAA2D,KAAK,4IACzF;AAEF;;;;;AAkBA,MAAa,kBAA+C,cAAoB;CAC/E,GAAG;CACH,QAAQ;EAAE,GAAG,SAAS;GAAS,uBAAuB;CAAK;AAC5D;AAEA,MAAa,oBAAoB,aAChC,SAAS,SAAS,0BAA0B;;;;;AAW7C,MAAa,mBAAmB,WAA8D;CAC7F,MAAM,QAAQ,QAAQ,OAAO,SAAS;CACtC,MAAM,SAAS,SAAS,KAAK,IAAI,MAAM,SAAS,KAAA;CAChD,MAAM,OAAO,SAAS,MAAM,IAAI,OAAO,OAAO,KAAA;CAC9C,OAAO,WAAW,YAAY,IAAI,IAAI,OAAA,KAAyB;AAChE"}