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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1241) hide show
  1. package/CHANGELOG.md +463 -0
  2. package/README.md +30 -37
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +7 -9
  17. package/dist/adapters/ga4/disableKey.js.map +1 -1
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +11 -0
  22. package/dist/adapters/ga4/ga4.js +206 -123
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +13 -13
  36. package/dist/adapters/plausible/plausible.js +137 -122
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +20 -9
  41. package/dist/adapters/posthog/posthog.js +179 -113
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/readTime.js +7 -0
  44. package/dist/adapters/readTime.js.map +1 -0
  45. package/dist/adapters/series.js +14 -8
  46. package/dist/adapters/series.js.map +1 -1
  47. package/dist/adapters/umami/umami.d.ts +7 -9
  48. package/dist/adapters/umami/umami.js +184 -172
  49. package/dist/adapters/umami/umami.js.map +1 -1
  50. package/dist/adapters/upstream.js +16 -0
  51. package/dist/adapters/upstream.js.map +1 -0
  52. package/dist/binding/report.d.ts +8 -0
  53. package/dist/binding/report.js +24 -0
  54. package/dist/binding/report.js.map +1 -0
  55. package/dist/binding/resolvePath.js +16 -29
  56. package/dist/binding/resolvePath.js.map +1 -1
  57. package/dist/binding/types.d.ts +14 -29
  58. package/dist/capture/captureRequest.js +28 -0
  59. package/dist/capture/captureRequest.js.map +1 -0
  60. package/dist/capture/exclusionEndpoint.js +98 -0
  61. package/dist/capture/exclusionEndpoint.js.map +1 -0
  62. package/dist/capture/exclusionPrelude.js +14 -0
  63. package/dist/capture/exclusionPrelude.js.map +1 -0
  64. package/dist/capture/exclusionToken.js +23 -0
  65. package/dist/capture/exclusionToken.js.map +1 -0
  66. package/dist/capture/jsLiteral.js +19 -0
  67. package/dist/capture/jsLiteral.js.map +1 -0
  68. package/dist/capture/mountPath.js +2 -3
  69. package/dist/capture/mountPath.js.map +1 -1
  70. package/dist/capture/proxyEndpoint.js +48 -95
  71. package/dist/capture/proxyEndpoint.js.map +1 -1
  72. package/dist/capture/proxyRoutes.js +58 -21
  73. package/dist/capture/proxyRoutes.js.map +1 -1
  74. package/dist/capture/relay.js +91 -0
  75. package/dist/capture/relay.js.map +1 -0
  76. package/dist/capture/requestBody.js +2 -6
  77. package/dist/capture/requestBody.js.map +1 -1
  78. package/dist/capture/requestTrust.js +45 -0
  79. package/dist/capture/requestTrust.js.map +1 -0
  80. package/dist/capture/sameSite.js +40 -0
  81. package/dist/capture/sameSite.js.map +1 -0
  82. package/dist/capture/slots.js +50 -25
  83. package/dist/capture/slots.js.map +1 -1
  84. package/dist/capture/trackerConfig.js +100 -36
  85. package/dist/capture/trackerConfig.js.map +1 -1
  86. package/dist/capture/trackerEndpoint.js +22 -21
  87. package/dist/capture/trackerEndpoint.js.map +1 -1
  88. package/dist/charts/BarList.d.ts +27 -14
  89. package/dist/charts/BarList.js +38 -83
  90. package/dist/charts/BarList.js.map +1 -1
  91. package/dist/charts/TrendChart.d.ts +40 -7
  92. package/dist/charts/TrendChart.js +243 -215
  93. package/dist/charts/TrendChart.js.map +1 -1
  94. package/dist/charts/bars.d.ts +15 -1
  95. package/dist/charts/bars.js +12 -12
  96. package/dist/charts/bars.js.map +1 -1
  97. package/dist/charts/bucket.js +106 -73
  98. package/dist/charts/bucket.js.map +1 -1
  99. package/dist/charts/inProgress.js +22 -0
  100. package/dist/charts/inProgress.js.map +1 -0
  101. package/dist/charts/series.d.ts +15 -0
  102. package/dist/charts/series.js +123 -0
  103. package/dist/charts/series.js.map +1 -0
  104. package/dist/charts/spline.js +91 -25
  105. package/dist/charts/spline.js.map +1 -1
  106. package/dist/charts/trendGeometry.js +91 -0
  107. package/dist/charts/trendGeometry.js.map +1 -0
  108. package/dist/core/adminOptions.d.ts +1 -0
  109. package/dist/core/adminOptions.js +193 -0
  110. package/dist/core/adminOptions.js.map +1 -0
  111. package/dist/core/budget.js +24 -0
  112. package/dist/core/budget.js.map +1 -0
  113. package/dist/core/cacheKey.d.ts +1 -0
  114. package/dist/core/cacheKey.js +48 -37
  115. package/dist/core/cacheKey.js.map +1 -1
  116. package/dist/core/cacheOptions.js +165 -0
  117. package/dist/core/cacheOptions.js.map +1 -0
  118. package/dist/core/capabilities.d.ts +24 -11
  119. package/dist/core/capabilities.js +96 -17
  120. package/dist/core/capabilities.js.map +1 -1
  121. package/dist/core/capture.d.ts +26 -25
  122. package/dist/core/captureOptions.d.ts +1 -0
  123. package/dist/core/captureOptions.js +258 -0
  124. package/dist/core/captureOptions.js.map +1 -0
  125. package/dist/core/clock.js +13 -0
  126. package/dist/core/clock.js.map +1 -0
  127. package/dist/core/collectionOption.d.ts +17 -0
  128. package/dist/core/collectionOption.js +104 -0
  129. package/dist/core/collectionOption.js.map +1 -0
  130. package/dist/core/collectionSlug.js +7 -0
  131. package/dist/core/collectionSlug.js.map +1 -0
  132. package/dist/core/contract.d.ts +285 -59
  133. package/dist/core/contract.js +6 -4
  134. package/dist/core/contract.js.map +1 -1
  135. package/dist/core/cron.js +57 -0
  136. package/dist/core/cron.js.map +1 -0
  137. package/dist/core/fetch.d.ts +17 -0
  138. package/dist/core/goalOptions.d.ts +1 -0
  139. package/dist/core/goalOptions.js +166 -0
  140. package/dist/core/goalOptions.js.map +1 -0
  141. package/dist/core/granularity.js +3 -2
  142. package/dist/core/granularity.js.map +1 -1
  143. package/dist/core/guards.js +17 -0
  144. package/dist/core/guards.js.map +1 -0
  145. package/dist/core/jobs.d.ts +40 -0
  146. package/dist/core/jobs.js +132 -0
  147. package/dist/core/jobs.js.map +1 -0
  148. package/dist/core/legacyOptions.js +145 -0
  149. package/dist/core/legacyOptions.js.map +1 -0
  150. package/dist/core/metricAliases.js +81 -0
  151. package/dist/core/metricAliases.js.map +1 -0
  152. package/dist/core/metricValues.js +57 -0
  153. package/dist/core/metricValues.js.map +1 -0
  154. package/dist/core/monotonic.js +10 -0
  155. package/dist/core/monotonic.js.map +1 -0
  156. package/dist/core/optionChecks.js +51 -0
  157. package/dist/core/optionChecks.js.map +1 -0
  158. package/dist/core/options.d.ts +473 -157
  159. package/dist/core/options.js +154 -219
  160. package/dist/core/options.js.map +1 -1
  161. package/dist/core/registry.js +45 -5
  162. package/dist/core/registry.js.map +1 -1
  163. package/dist/core/scopeList.js +7 -9
  164. package/dist/core/scopeList.js.map +1 -1
  165. package/dist/core/scopeOptions.d.ts +1 -0
  166. package/dist/core/scopeOptions.js +112 -0
  167. package/dist/core/scopeOptions.js.map +1 -0
  168. package/dist/core/scopedRead.js +182 -72
  169. package/dist/core/scopedRead.js.map +1 -1
  170. package/dist/core/sdks.d.ts +81 -0
  171. package/dist/core/sdks.js +23 -0
  172. package/dist/core/sdks.js.map +1 -0
  173. package/dist/core/serverEvent.d.ts +38 -20
  174. package/dist/core/serverEvent.js.map +1 -1
  175. package/dist/core/siteAddress.js +20 -0
  176. package/dist/core/siteAddress.js.map +1 -0
  177. package/dist/core/sourceErrors.js +109 -0
  178. package/dist/core/sourceErrors.js.map +1 -0
  179. package/dist/core/sourceOptions.js +94 -0
  180. package/dist/core/sourceOptions.js.map +1 -0
  181. package/dist/core/throttle.js +18 -0
  182. package/dist/core/throttle.js.map +1 -0
  183. package/dist/core/values.js +61 -0
  184. package/dist/core/values.js.map +1 -0
  185. package/dist/core/widgetSlugs.d.ts +17 -0
  186. package/dist/core/widgetSlugs.js +29 -0
  187. package/dist/core/widgetSlugs.js.map +1 -0
  188. package/dist/db/detachedWrite.js +36 -0
  189. package/dist/db/detachedWrite.js.map +1 -0
  190. package/dist/db/errors.js +182 -0
  191. package/dist/db/errors.js.map +1 -0
  192. package/dist/db/kind.js +32 -0
  193. package/dist/db/kind.js.map +1 -0
  194. package/dist/db/openTransaction.js +51 -0
  195. package/dist/db/openTransaction.js.map +1 -0
  196. package/dist/exports/adapters/contract.d.ts +14 -0
  197. package/dist/exports/adapters/ga4.d.ts +15 -1
  198. package/dist/exports/adapters/native.d.ts +26 -2
  199. package/dist/exports/adapters/native.js +4 -1
  200. package/dist/exports/adapters/plausible.d.ts +15 -1
  201. package/dist/exports/adapters/posthog.d.ts +15 -1
  202. package/dist/exports/adapters/umami.d.ts +15 -1
  203. package/dist/exports/attributes.d.ts +42 -0
  204. package/dist/exports/attributes.js +83 -0
  205. package/dist/exports/attributes.js.map +1 -0
  206. package/dist/exports/client.d.ts +41 -13
  207. package/dist/exports/client.js +21 -9
  208. package/dist/exports/geo.d.ts +3 -1
  209. package/dist/exports/geo.js +1 -1
  210. package/dist/exports/i18n.d.ts +2 -2
  211. package/dist/exports/i18n.js +2 -2
  212. package/dist/exports/migrations.d.ts +2 -0
  213. package/dist/exports/migrations.js +2 -0
  214. package/dist/exports/next.d.ts +18 -1
  215. package/dist/exports/next.js +3 -1
  216. package/dist/exports/react.d.ts +3 -2
  217. package/dist/exports/react.js +1 -2
  218. package/dist/exports/rsc.d.ts +31 -14
  219. package/dist/exports/rsc.js +11 -6
  220. package/dist/exports/site.d.ts +5 -0
  221. package/dist/exports/site.js +3 -0
  222. package/dist/exports/testing.d.ts +17 -0
  223. package/dist/exports/testing.js +3 -0
  224. package/dist/exports/tracker.d.ts +5 -20
  225. package/dist/exports/tracker.js +3 -14
  226. package/dist/exports/types.d.ts +40 -14
  227. package/dist/exports/types.js +5 -1
  228. package/dist/fields/AnalyticsPanelClient.js +265 -154
  229. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  230. package/dist/fields/AnalyticsPanelField.d.ts +20 -8
  231. package/dist/fields/AnalyticsPanelField.js +121 -30
  232. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  233. package/dist/fields/AnalyticsStatField.d.ts +18 -7
  234. package/dist/fields/AnalyticsStatField.js +98 -63
  235. package/dist/fields/AnalyticsStatField.js.map +1 -1
  236. package/dist/fields/FieldShimmer.js +15 -0
  237. package/dist/fields/FieldShimmer.js.map +1 -0
  238. package/dist/fields/PanelContent.js +217 -0
  239. package/dist/fields/PanelContent.js.map +1 -0
  240. package/dist/fields/PanelList.js +82 -0
  241. package/dist/fields/PanelList.js.map +1 -0
  242. package/dist/fields/PanelLiveCounter.js +63 -0
  243. package/dist/fields/PanelLiveCounter.js.map +1 -0
  244. package/dist/fields/PanelSkeleton.js +63 -0
  245. package/dist/fields/PanelSkeleton.js.map +1 -0
  246. package/dist/fields/componentPaths.js +8 -0
  247. package/dist/fields/componentPaths.js.map +1 -0
  248. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  249. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  250. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  251. package/dist/fields/config/FilterKeySelect.js +66 -0
  252. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  253. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  254. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  255. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  256. package/dist/fields/config/FilterValueField.d.ts +17 -0
  257. package/dist/fields/config/FilterValueField.js +130 -0
  258. package/dist/fields/config/FilterValueField.js.map +1 -0
  259. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  260. package/dist/fields/config/MetricSelectField.js +18 -30
  261. package/dist/fields/config/MetricSelectField.js.map +1 -1
  262. package/dist/fields/config/OptionSelect.js +52 -0
  263. package/dist/fields/config/OptionSelect.js.map +1 -0
  264. package/dist/fields/config/SourceSelectField.js +16 -31
  265. package/dist/fields/config/SourceSelectField.js.map +1 -1
  266. package/dist/fields/config/fetchSources.js +14 -26
  267. package/dist/fields/config/fetchSources.js.map +1 -1
  268. package/dist/fields/config/filterValues.js +106 -0
  269. package/dist/fields/config/filterValues.js.map +1 -0
  270. package/dist/fields/config/narrow.js +8 -10
  271. package/dist/fields/config/narrow.js.map +1 -1
  272. package/dist/fields/config/retiredPickers.d.ts +45 -0
  273. package/dist/fields/config/retiredPickers.js +46 -0
  274. package/dist/fields/config/retiredPickers.js.map +1 -0
  275. package/dist/fields/config/scopedFields.d.ts +40 -0
  276. package/dist/fields/config/scopedFields.js +68 -0
  277. package/dist/fields/config/scopedFields.js.map +1 -0
  278. package/dist/fields/config/toSelectOption.js +13 -7
  279. package/dist/fields/config/toSelectOption.js.map +1 -1
  280. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  281. package/dist/fields/config/useAnalyticsSources.js +17 -21
  282. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  283. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  284. package/dist/fields/config/useFilterCapabilities.js +23 -15
  285. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  286. package/dist/fields/config/useFormString.js +12 -0
  287. package/dist/fields/config/useFormString.js.map +1 -0
  288. package/dist/fields/dateRange/field.js +7 -19
  289. package/dist/fields/dateRange/field.js.map +1 -1
  290. package/dist/fields/dateRange/types.d.ts +5 -1
  291. package/dist/fields/dateRange/ui.d.ts +3 -2
  292. package/dist/fields/dateRange/ui.js +57 -319
  293. package/dist/fields/dateRange/ui.js.map +1 -1
  294. package/dist/fields/documentScope.js +21 -0
  295. package/dist/fields/documentScope.js.map +1 -0
  296. package/dist/fields/emptyState.js +31 -26
  297. package/dist/fields/emptyState.js.map +1 -1
  298. package/dist/fields/factories.d.ts +35 -16
  299. package/dist/fields/factories.js +66 -37
  300. package/dist/fields/factories.js.map +1 -1
  301. package/dist/fields/format.d.ts +12 -3
  302. package/dist/fields/format.js +77 -13
  303. package/dist/fields/format.js.map +1 -1
  304. package/dist/fields/itemReport.js +45 -0
  305. package/dist/fields/itemReport.js.map +1 -0
  306. package/dist/fields/readForDocument.d.ts +78 -26
  307. package/dist/fields/readForDocument.js +446 -116
  308. package/dist/fields/readForDocument.js.map +1 -1
  309. package/dist/fields/stateKeys.js +20 -0
  310. package/dist/fields/stateKeys.js.map +1 -0
  311. package/dist/goals/GoalAmountField.d.ts +10 -0
  312. package/dist/goals/GoalAmountField.js +162 -0
  313. package/dist/goals/GoalAmountField.js.map +1 -0
  314. package/dist/goals/GoalSelectField.js +89 -40
  315. package/dist/goals/GoalSelectField.js.map +1 -1
  316. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  317. package/dist/goals/GoalSelectFieldServer.js +21 -0
  318. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  319. package/dist/goals/amountField.d.ts +20 -0
  320. package/dist/goals/amountField.js +37 -0
  321. package/dist/goals/amountField.js.map +1 -0
  322. package/dist/goals/builtin.js +17 -0
  323. package/dist/goals/builtin.js.map +1 -0
  324. package/dist/goals/collection.d.ts +22 -0
  325. package/dist/goals/collection.js +141 -100
  326. package/dist/goals/collection.js.map +1 -1
  327. package/dist/goals/constants.d.ts +38 -0
  328. package/dist/goals/constants.js +49 -0
  329. package/dist/goals/constants.js.map +1 -0
  330. package/dist/goals/currency.d.ts +16 -0
  331. package/dist/goals/currency.js +46 -4
  332. package/dist/goals/currency.js.map +1 -1
  333. package/dist/goals/currencyOptions.js +70 -0
  334. package/dist/goals/currencyOptions.js.map +1 -0
  335. package/dist/goals/fetchGoals.d.ts +10 -0
  336. package/dist/goals/fetchGoals.js +12 -26
  337. package/dist/goals/fetchGoals.js.map +1 -1
  338. package/dist/goals/goalField.d.ts +4 -6
  339. package/dist/goals/goalField.js +9 -19
  340. package/dist/goals/goalField.js.map +1 -1
  341. package/dist/goals/goalsEndpoint.js +39 -40
  342. package/dist/goals/goalsEndpoint.js.map +1 -1
  343. package/dist/goals/items.js +35 -0
  344. package/dist/goals/items.js.map +1 -0
  345. package/dist/goals/latent.js +9 -0
  346. package/dist/goals/latent.js.map +1 -0
  347. package/dist/goals/linkFields.d.ts +35 -0
  348. package/dist/goals/linkFields.js +31 -0
  349. package/dist/goals/linkFields.js.map +1 -0
  350. package/dist/goals/match.d.ts +14 -0
  351. package/dist/goals/match.js +67 -46
  352. package/dist/goals/match.js.map +1 -1
  353. package/dist/goals/moneyFields.js +56 -0
  354. package/dist/goals/moneyFields.js.map +1 -0
  355. package/dist/goals/pathMatch.js +122 -0
  356. package/dist/goals/pathMatch.js.map +1 -0
  357. package/dist/goals/placeholder.js +12 -0
  358. package/dist/goals/placeholder.js.map +1 -0
  359. package/dist/goals/resolver.d.ts +3 -3
  360. package/dist/goals/resolver.js +154 -46
  361. package/dist/goals/resolver.js.map +1 -1
  362. package/dist/goals/serverRevenue.d.ts +60 -0
  363. package/dist/goals/serverRevenue.js +41 -0
  364. package/dist/goals/serverRevenue.js.map +1 -0
  365. package/dist/goals/trackGoalAction.d.ts +26 -27
  366. package/dist/goals/trackGoalAction.js +38 -52
  367. package/dist/goals/trackGoalAction.js.map +1 -1
  368. package/dist/goals/types.d.ts +13 -28
  369. package/dist/goals/types.js +1 -1
  370. package/dist/goals/types.js.map +1 -1
  371. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  372. package/dist/goals/useAnalyticsGoals.js +17 -18
  373. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  374. package/dist/index.d.ts +63 -11
  375. package/dist/index.js +257 -247
  376. package/dist/index.js.map +1 -1
  377. package/dist/items/collectionIdType.js +20 -0
  378. package/dist/items/collectionIdType.js.map +1 -0
  379. package/dist/items/idType.js +31 -0
  380. package/dist/items/idType.js.map +1 -0
  381. package/dist/items/ref.js +73 -0
  382. package/dist/items/ref.js.map +1 -0
  383. package/dist/maintenance/apiTaskState.js +141 -0
  384. package/dist/maintenance/apiTaskState.js.map +1 -0
  385. package/dist/maintenance/heartbeat.js +51 -0
  386. package/dist/maintenance/heartbeat.js.map +1 -0
  387. package/dist/maintenance/lease.d.ts +1 -0
  388. package/dist/maintenance/lease.js +81 -0
  389. package/dist/maintenance/lease.js.map +1 -0
  390. package/dist/maintenance/taskSchedule.d.ts +1 -0
  391. package/dist/maintenance/taskSchedule.js +62 -0
  392. package/dist/maintenance/taskSchedule.js.map +1 -0
  393. package/dist/maintenance/underLease.js +35 -0
  394. package/dist/maintenance/underLease.js.map +1 -0
  395. package/dist/migrations/legacy.d.ts +54 -0
  396. package/dist/migrations/legacy.js +117 -0
  397. package/dist/migrations/legacy.js.map +1 -0
  398. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  399. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  400. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  401. package/dist/native/collections/aggregates.js +54 -0
  402. package/dist/native/collections/aggregates.js.map +1 -0
  403. package/dist/native/collections/hits.js +102 -0
  404. package/dist/native/collections/hits.js.map +1 -0
  405. package/dist/native/collections/slugs.d.ts +10 -0
  406. package/dist/native/collections/slugs.js +16 -0
  407. package/dist/native/collections/slugs.js.map +1 -0
  408. package/dist/native/collections/state.js +84 -0
  409. package/dist/native/collections/state.js.map +1 -0
  410. package/dist/native/collections/storeCollection.js +29 -0
  411. package/dist/native/collections/storeCollection.js.map +1 -0
  412. package/dist/native/engine/buckets.d.ts +1 -0
  413. package/dist/native/engine/buckets.js +53 -0
  414. package/dist/native/engine/buckets.js.map +1 -0
  415. package/dist/native/engine/capabilities.js +87 -0
  416. package/dist/native/engine/capabilities.js.map +1 -0
  417. package/dist/native/engine/cost.js +72 -0
  418. package/dist/native/engine/cost.js.map +1 -0
  419. package/dist/native/engine/days.d.ts +1 -0
  420. package/dist/native/engine/days.js +182 -0
  421. package/dist/native/engine/days.js.map +1 -0
  422. package/dist/native/engine/engine.d.ts +1 -0
  423. package/dist/native/engine/engine.js +1623 -0
  424. package/dist/native/engine/engine.js.map +1 -0
  425. package/dist/native/engine/instance.js +58 -0
  426. package/dist/native/engine/instance.js.map +1 -0
  427. package/dist/native/engine/maintenance.d.ts +1 -0
  428. package/dist/native/engine/maintenance.js +677 -0
  429. package/dist/native/engine/maintenance.js.map +1 -0
  430. package/dist/native/engine/merge.js +41 -0
  431. package/dist/native/engine/merge.js.map +1 -0
  432. package/dist/native/engine/nudge.js +26 -0
  433. package/dist/native/engine/nudge.js.map +1 -0
  434. package/dist/native/engine/planner.js +198 -0
  435. package/dist/native/engine/planner.js.map +1 -0
  436. package/dist/native/engine/rebuild.d.ts +22 -0
  437. package/dist/native/engine/rebuild.js +76 -0
  438. package/dist/native/engine/rebuild.js.map +1 -0
  439. package/dist/native/engine/recent.js +17 -0
  440. package/dist/native/engine/recent.js.map +1 -0
  441. package/dist/native/engine/salt.d.ts +1 -0
  442. package/dist/native/engine/salt.js +98 -0
  443. package/dist/native/engine/salt.js.map +1 -0
  444. package/dist/native/engine/siteHosts.d.ts +1 -0
  445. package/dist/native/engine/siteHosts.js +58 -0
  446. package/dist/native/engine/siteHosts.js.map +1 -0
  447. package/dist/native/engine/toHit.js +108 -0
  448. package/dist/native/engine/toHit.js.map +1 -0
  449. package/dist/native/engine/writeBuffer.d.ts +14 -0
  450. package/dist/native/engine/writeBuffer.js +317 -0
  451. package/dist/native/engine/writeBuffer.js.map +1 -0
  452. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  453. package/dist/native/geo/composeGeoResolvers.js +4 -1
  454. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  455. package/dist/native/geo/geoResolver.d.ts +20 -2
  456. package/dist/native/geo/geoResolver.js +42 -6
  457. package/dist/native/geo/geoResolver.js.map +1 -1
  458. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  459. package/dist/native/geo/maxmindResolver.js +20 -16
  460. package/dist/native/geo/maxmindResolver.js.map +1 -1
  461. package/dist/native/geo/resolveGeo.js +31 -0
  462. package/dist/native/geo/resolveGeo.js.map +1 -0
  463. package/dist/native/ingest/bots.d.ts +2 -3
  464. package/dist/native/ingest/bots.js +8 -13
  465. package/dist/native/ingest/bots.js.map +1 -1
  466. package/dist/native/ingest/browser.js +4 -6
  467. package/dist/native/ingest/browser.js.map +1 -1
  468. package/dist/native/ingest/clientIp.js +30 -9
  469. package/dist/native/ingest/clientIp.js.map +1 -1
  470. package/dist/native/ingest/device.js +4 -6
  471. package/dist/native/ingest/device.js.map +1 -1
  472. package/dist/native/ingest/endpoint.d.ts +1 -1
  473. package/dist/native/ingest/endpoint.js +119 -34
  474. package/dist/native/ingest/endpoint.js.map +1 -1
  475. package/dist/native/ingest/itemSignature.d.ts +26 -0
  476. package/dist/native/ingest/itemSignature.js +45 -0
  477. package/dist/native/ingest/itemSignature.js.map +1 -0
  478. package/dist/native/ingest/language.js +2 -3
  479. package/dist/native/ingest/language.js.map +1 -1
  480. package/dist/native/ingest/normalizeEvent.d.ts +60 -7
  481. package/dist/native/ingest/normalizeEvent.js +226 -61
  482. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  483. package/dist/native/ingest/orderSignature.d.ts +13 -0
  484. package/dist/native/ingest/orderSignature.js +50 -0
  485. package/dist/native/ingest/orderSignature.js.map +1 -0
  486. package/dist/native/ingest/referrer.js +30 -32
  487. package/dist/native/ingest/referrer.js.map +1 -1
  488. package/dist/native/ingest/requestHost.js +10 -23
  489. package/dist/native/ingest/requestHost.js.map +1 -1
  490. package/dist/native/ingest/resolveHostname.d.ts +4 -13
  491. package/dist/native/ingest/resolveHostname.js +5 -6
  492. package/dist/native/ingest/resolveHostname.js.map +1 -1
  493. package/dist/native/ingest/revenue.d.ts +1 -0
  494. package/dist/native/ingest/revenue.js +121 -0
  495. package/dist/native/ingest/revenue.js.map +1 -0
  496. package/dist/native/ingest/route.d.ts +10 -0
  497. package/dist/native/ingest/route.js +82 -0
  498. package/dist/native/ingest/route.js.map +1 -0
  499. package/dist/native/ingest/serverTrack.d.ts +2 -10
  500. package/dist/native/ingest/serverTrack.js +181 -72
  501. package/dist/native/ingest/serverTrack.js.map +1 -1
  502. package/dist/native/ingest/signature.js +28 -0
  503. package/dist/native/ingest/signature.js.map +1 -0
  504. package/dist/native/ingest/source.d.ts +2 -3
  505. package/dist/native/ingest/source.js +35 -54
  506. package/dist/native/ingest/source.js.map +1 -1
  507. package/dist/native/ingest/utm.js +9 -9
  508. package/dist/native/ingest/utm.js.map +1 -1
  509. package/dist/native/ingest/validate.js +20 -10
  510. package/dist/native/ingest/validate.js.map +1 -1
  511. package/dist/native/ingest/visitorHash.js +6 -8
  512. package/dist/native/ingest/visitorHash.js.map +1 -1
  513. package/dist/native/nativeAdapter.d.ts +101 -33
  514. package/dist/native/nativeAdapter.js +375 -317
  515. package/dist/native/nativeAdapter.js.map +1 -1
  516. package/dist/native/rebuildDays.d.ts +12 -0
  517. package/dist/native/rebuildDays.js +16 -0
  518. package/dist/native/rebuildDays.js.map +1 -0
  519. package/dist/native/store/aggregate.js +450 -0
  520. package/dist/native/store/aggregate.js.map +1 -0
  521. package/dist/native/store/caps.d.ts +18 -0
  522. package/dist/native/store/caps.js +76 -0
  523. package/dist/native/store/caps.js.map +1 -0
  524. package/dist/native/store/chunks.js +34 -0
  525. package/dist/native/store/chunks.js.map +1 -0
  526. package/dist/native/store/columnValues.js +31 -0
  527. package/dist/native/store/columnValues.js.map +1 -0
  528. package/dist/native/store/dialect.js +106 -0
  529. package/dist/native/store/dialect.js.map +1 -0
  530. package/dist/native/store/eventStore.js +44 -0
  531. package/dist/native/store/eventStore.js.map +1 -0
  532. package/dist/native/store/hitRow.js +116 -0
  533. package/dist/native/store/hitRow.js.map +1 -0
  534. package/dist/native/store/hits.js +63 -0
  535. package/dist/native/store/hits.js.map +1 -0
  536. package/dist/native/store/ids.js +105 -0
  537. package/dist/native/store/ids.js.map +1 -0
  538. package/dist/native/store/mongo/aggregatePipelines.js +430 -0
  539. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  540. package/dist/native/store/mongo/mongoState.js +375 -0
  541. package/dist/native/store/mongo/mongoState.js.map +1 -0
  542. package/dist/native/store/mongo/mongoStore.js +618 -0
  543. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  544. package/dist/native/store/mongo/pipelines.js +695 -0
  545. package/dist/native/store/mongo/pipelines.js.map +1 -0
  546. package/dist/native/store/mongo/results.js +20 -0
  547. package/dist/native/store/mongo/results.js.map +1 -0
  548. package/dist/native/store/parts.d.ts +1 -0
  549. package/dist/native/store/parts.js +95 -0
  550. package/dist/native/store/parts.js.map +1 -0
  551. package/dist/native/store/pattern.js +213 -0
  552. package/dist/native/store/pattern.js.map +1 -0
  553. package/dist/native/store/rawRead.d.ts +23 -0
  554. package/dist/native/store/rawRead.js +384 -0
  555. package/dist/native/store/rawRead.js.map +1 -0
  556. package/dist/native/store/reclassify.js +53 -0
  557. package/dist/native/store/reclassify.js.map +1 -0
  558. package/dist/native/store/sql/aggregateSql.js +345 -0
  559. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  560. package/dist/native/store/sql/columns.js +48 -0
  561. package/dist/native/store/sql/columns.js.map +1 -0
  562. package/dist/native/store/sql/compile.js +656 -0
  563. package/dist/native/store/sql/compile.js.map +1 -0
  564. package/dist/native/store/sql/drivers.js +218 -0
  565. package/dist/native/store/sql/drivers.js.map +1 -0
  566. package/dist/native/store/sql/executor.js +132 -0
  567. package/dist/native/store/sql/executor.js.map +1 -0
  568. package/dist/native/store/sql/fragment.js +104 -0
  569. package/dist/native/store/sql/fragment.js.map +1 -0
  570. package/dist/native/store/sql/maintenanceSql.js +59 -0
  571. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  572. package/dist/native/store/sql/ownConnection.js +107 -0
  573. package/dist/native/store/sql/ownConnection.js.map +1 -0
  574. package/dist/native/store/sql/poolShare.js +101 -0
  575. package/dist/native/store/sql/poolShare.js.map +1 -0
  576. package/dist/native/store/sql/sqlState.js +325 -0
  577. package/dist/native/store/sql/sqlState.js.map +1 -0
  578. package/dist/native/store/sql/sqlStore.js +355 -0
  579. package/dist/native/store/sql/sqlStore.js.map +1 -0
  580. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  581. package/dist/native/store/sql/sqliteThread.js +314 -0
  582. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  583. package/dist/native/store/sql/sqliteWorker.js +327 -0
  584. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  585. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  586. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  587. package/dist/native/store/state.js +151 -0
  588. package/dist/native/store/state.js.map +1 -0
  589. package/dist/native/store/stateStore.js +29 -0
  590. package/dist/native/store/stateStore.js.map +1 -0
  591. package/dist/native/store/types.d.ts +9 -0
  592. package/dist/native/tasks/maintainTask.d.ts +19 -0
  593. package/dist/native/tasks/maintainTask.js +68 -0
  594. package/dist/native/tasks/maintainTask.js.map +1 -0
  595. package/dist/net/guardedFetch.d.ts +32 -0
  596. package/dist/net/guardedFetch.js +220 -0
  597. package/dist/net/guardedFetch.js.map +1 -0
  598. package/dist/net/origin.js +40 -0
  599. package/dist/net/origin.js.map +1 -0
  600. package/dist/net/platform.d.ts +9 -0
  601. package/dist/net/platform.js +35 -0
  602. package/dist/net/platform.js.map +1 -0
  603. package/dist/next/captureRewrites.d.ts +4 -24
  604. package/dist/next/captureRewrites.js +6 -50
  605. package/dist/next/captureRewrites.js.map +1 -1
  606. package/dist/next/captureRoute.d.ts +28 -0
  607. package/dist/next/captureRoute.js +67 -0
  608. package/dist/next/captureRoute.js.map +1 -0
  609. package/dist/next/ingestRoute.d.ts +17 -0
  610. package/dist/next/ingestRoute.js +17 -0
  611. package/dist/next/ingestRoute.js.map +1 -0
  612. package/dist/next/posthogProxyRewrites.d.ts +3 -25
  613. package/dist/next/posthogProxyRewrites.js +5 -37
  614. package/dist/next/posthogProxyRewrites.js.map +1 -1
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +336 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +76 -53
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +5 -12
  639. package/dist/plugin/errors.js +23 -16
  640. package/dist/plugin/errors.js.map +1 -1
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/jobsAccess.js +91 -0
  648. package/dist/plugin/jobsAccess.js.map +1 -0
  649. package/dist/plugin/keepAlive.js +48 -0
  650. package/dist/plugin/keepAlive.js.map +1 -0
  651. package/dist/plugin/peerImportError.js +3 -6
  652. package/dist/plugin/peerImportError.js.map +1 -1
  653. package/dist/plugin/peers.js +64 -0
  654. package/dist/plugin/peers.js.map +1 -0
  655. package/dist/plugin/pluginCollections.js +155 -0
  656. package/dist/plugin/pluginCollections.js.map +1 -0
  657. package/dist/plugin/queryEndpoint.js +69 -44
  658. package/dist/plugin/queryEndpoint.js.map +1 -1
  659. package/dist/plugin/queryParams.js +7 -0
  660. package/dist/plugin/queryParams.js.map +1 -0
  661. package/dist/plugin/readContextForRequest.js +52 -17
  662. package/dist/plugin/readContextForRequest.js.map +1 -1
  663. package/dist/plugin/readFailure.js +22 -0
  664. package/dist/plugin/readFailure.js.map +1 -0
  665. package/dist/plugin/readableProviders.js +64 -0
  666. package/dist/plugin/readableProviders.js.map +1 -0
  667. package/dist/plugin/realtimeEndpoint.js +77 -25
  668. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  669. package/dist/plugin/refreshEndpoint.js +69 -44
  670. package/dist/plugin/refreshEndpoint.js.map +1 -1
  671. package/dist/plugin/relabelFields.js +36 -0
  672. package/dist/plugin/relabelFields.js.map +1 -0
  673. package/dist/plugin/requestMemo.js +35 -0
  674. package/dist/plugin/requestMemo.js.map +1 -0
  675. package/dist/plugin/routeChecks.js +39 -0
  676. package/dist/plugin/routeChecks.js.map +1 -0
  677. package/dist/plugin/routes.d.ts +53 -0
  678. package/dist/plugin/routes.js +92 -0
  679. package/dist/plugin/routes.js.map +1 -0
  680. package/dist/plugin/runtime.d.ts +1 -1
  681. package/dist/plugin/runtime.js +226 -30
  682. package/dist/plugin/runtime.js.map +1 -1
  683. package/dist/plugin/schemaOnly.js +63 -0
  684. package/dist/plugin/schemaOnly.js.map +1 -0
  685. package/dist/plugin/scopeChange.js +6 -5
  686. package/dist/plugin/scopeChange.js.map +1 -1
  687. package/dist/plugin/scopeFieldBoot.js +4 -4
  688. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  689. package/dist/plugin/scopeToken.js +33 -0
  690. package/dist/plugin/scopeToken.js.map +1 -0
  691. package/dist/plugin/sourcesEndpoint.js +46 -12
  692. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  693. package/dist/plugin/unbundledLanguages.js +25 -0
  694. package/dist/plugin/unbundledLanguages.js.map +1 -0
  695. package/dist/plugin/walkFields.js +22 -0
  696. package/dist/plugin/walkFields.js.map +1 -0
  697. package/dist/plugin/warmTask.js +0 -0
  698. package/dist/plugin/warmTask.js.map +1 -1
  699. package/dist/providers/access.d.ts +1 -0
  700. package/dist/providers/access.js +35 -26
  701. package/dist/providers/access.js.map +1 -1
  702. package/dist/providers/adapterPool.js +121 -0
  703. package/dist/providers/adapterPool.js.map +1 -0
  704. package/dist/providers/collection.d.ts +53 -0
  705. package/dist/providers/collection.js +274 -150
  706. package/dist/providers/collection.js.map +1 -1
  707. package/dist/providers/factory.d.ts +76 -0
  708. package/dist/providers/factory.js +76 -23
  709. package/dist/providers/factory.js.map +1 -1
  710. package/dist/providers/hosts.d.ts +25 -0
  711. package/dist/providers/hosts.js +128 -0
  712. package/dist/providers/hosts.js.map +1 -0
  713. package/dist/providers/probe.d.ts +1 -0
  714. package/dist/providers/probe.js +101 -0
  715. package/dist/providers/probe.js.map +1 -0
  716. package/dist/providers/refresh.d.ts +18 -0
  717. package/dist/providers/refresh.js +49 -0
  718. package/dist/providers/refresh.js.map +1 -0
  719. package/dist/providers/registry.js +318 -0
  720. package/dist/providers/registry.js.map +1 -0
  721. package/dist/providers/resolver.js +23 -88
  722. package/dist/providers/resolver.js.map +1 -1
  723. package/dist/providers/retarget.js +45 -0
  724. package/dist/providers/retarget.js.map +1 -0
  725. package/dist/providers/secrets.d.ts +26 -0
  726. package/dist/providers/secrets.js +61 -4
  727. package/dist/providers/secrets.js.map +1 -1
  728. package/dist/providers/stampScope.js +9 -6
  729. package/dist/providers/stampScope.js.map +1 -1
  730. package/dist/query/dates.js +10 -12
  731. package/dist/query/dates.js.map +1 -1
  732. package/dist/query/errors.d.ts +1 -5
  733. package/dist/query/fetchQuery.d.ts +25 -32
  734. package/dist/query/fetchQuery.js +91 -91
  735. package/dist/query/fetchQuery.js.map +1 -1
  736. package/dist/query/limits.js +8 -0
  737. package/dist/query/limits.js.map +1 -0
  738. package/dist/query/parse.d.ts +6 -0
  739. package/dist/query/parse.js +153 -106
  740. package/dist/query/parse.js.map +1 -1
  741. package/dist/query/response.d.ts +23 -3
  742. package/dist/query/response.js +12 -5
  743. package/dist/query/response.js.map +1 -1
  744. package/dist/react/AnalyticsProvider.d.ts +26 -17
  745. package/dist/react/AnalyticsProvider.js +23 -22
  746. package/dist/react/AnalyticsProvider.js.map +1 -1
  747. package/dist/react/TrackerBoot.js +15 -9
  748. package/dist/react/TrackerBoot.js.map +1 -1
  749. package/dist/react/useAnalytics.d.ts +2 -11
  750. package/dist/react/useAnalytics.js +22 -24
  751. package/dist/react/useAnalytics.js.map +1 -1
  752. package/dist/site/AnalyticsScripts.d.ts +34 -0
  753. package/dist/site/AnalyticsScripts.js +30 -0
  754. package/dist/site/AnalyticsScripts.js.map +1 -0
  755. package/dist/site/getTrackerConfig.d.ts +15 -0
  756. package/dist/site/getTrackerConfig.js +40 -0
  757. package/dist/site/getTrackerConfig.js.map +1 -0
  758. package/dist/surfacing/afterRead.d.ts +37 -0
  759. package/dist/surfacing/bounded.js +38 -0
  760. package/dist/surfacing/bounded.js.map +1 -0
  761. package/dist/surfacing/breaker.js +107 -0
  762. package/dist/surfacing/breaker.js.map +1 -0
  763. package/dist/surfacing/cacheCollection.d.ts +8 -0
  764. package/dist/surfacing/cacheCollection.js +69 -0
  765. package/dist/surfacing/cacheCollection.js.map +1 -0
  766. package/dist/surfacing/cacheStore.d.ts +71 -1
  767. package/dist/surfacing/cacheStore.js +16 -37
  768. package/dist/surfacing/cacheStore.js.map +1 -1
  769. package/dist/surfacing/cacheSweep.d.ts +1 -0
  770. package/dist/surfacing/cacheSweep.js +59 -0
  771. package/dist/surfacing/cacheSweep.js.map +1 -0
  772. package/dist/surfacing/classifyError.js +282 -0
  773. package/dist/surfacing/classifyError.js.map +1 -0
  774. package/dist/surfacing/coalesce.js +2 -1
  775. package/dist/surfacing/coalesce.js.map +1 -1
  776. package/dist/surfacing/coldBudget.js +60 -0
  777. package/dist/surfacing/coldBudget.js.map +1 -0
  778. package/dist/surfacing/collectionCacheStore.js +183 -0
  779. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  780. package/dist/surfacing/engine.d.ts +1 -1
  781. package/dist/surfacing/engine.js +514 -72
  782. package/dist/surfacing/engine.js.map +1 -1
  783. package/dist/surfacing/epoch.js +70 -26
  784. package/dist/surfacing/epoch.js.map +1 -1
  785. package/dist/surfacing/lanes.d.ts +1 -0
  786. package/dist/surfacing/lanes.js +297 -0
  787. package/dist/surfacing/lanes.js.map +1 -0
  788. package/dist/surfacing/memo.js +40 -0
  789. package/dist/surfacing/memo.js.map +1 -0
  790. package/dist/surfacing/rateLimiter.d.ts +1 -0
  791. package/dist/surfacing/rateLimiter.js +69 -94
  792. package/dist/surfacing/rateLimiter.js.map +1 -1
  793. package/dist/surfacing/rebucket.js +178 -0
  794. package/dist/surfacing/rebucket.js.map +1 -0
  795. package/dist/surfacing/recipe.js +28 -0
  796. package/dist/surfacing/recipe.js.map +1 -0
  797. package/dist/surfacing/shape.js +22 -0
  798. package/dist/surfacing/shape.js.map +1 -0
  799. package/dist/surfacing/todaySplit.js +113 -0
  800. package/dist/surfacing/todaySplit.js.map +1 -0
  801. package/dist/sync/collection.d.ts +8 -0
  802. package/dist/sync/collection.js +28 -18
  803. package/dist/sync/collection.js.map +1 -1
  804. package/dist/sync/rekeyDurations.js +70 -0
  805. package/dist/sync/rekeyDurations.js.map +1 -0
  806. package/dist/sync/syncTask.js +226 -109
  807. package/dist/sync/syncTask.js.map +1 -1
  808. package/dist/testing/memoryAdapter.d.ts +6 -3
  809. package/dist/testing/memoryAdapter.js +12 -10
  810. package/dist/testing/memoryAdapter.js.map +1 -1
  811. package/dist/testing/settle.d.ts +11 -0
  812. package/dist/testing/settle.js +19 -0
  813. package/dist/testing/settle.js.map +1 -0
  814. package/dist/timeframe/calendar.js +65 -0
  815. package/dist/timeframe/calendar.js.map +1 -0
  816. package/dist/timeframe/comparison.js +46 -0
  817. package/dist/timeframe/comparison.js.map +1 -0
  818. package/dist/timeframe/presets.d.ts +1 -1
  819. package/dist/timeframe/presets.js +5 -5
  820. package/dist/timeframe/presets.js.map +1 -1
  821. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  822. package/dist/timeframe/reportingTimezone.js +64 -0
  823. package/dist/timeframe/reportingTimezone.js.map +1 -0
  824. package/dist/timeframe/tz.js +55 -39
  825. package/dist/timeframe/tz.js.map +1 -1
  826. package/dist/tracker/autoCapture.js +125 -38
  827. package/dist/tracker/autoCapture.js.map +1 -1
  828. package/dist/tracker/campaign.js +52 -0
  829. package/dist/tracker/campaign.js.map +1 -0
  830. package/dist/tracker/config.d.ts +144 -0
  831. package/dist/tracker/config.js +25 -0
  832. package/dist/tracker/config.js.map +1 -0
  833. package/dist/tracker/createTracker.d.ts +4 -10
  834. package/dist/tracker/createTracker.js +386 -115
  835. package/dist/tracker/createTracker.js.map +1 -1
  836. package/dist/tracker/digest.js +28 -0
  837. package/dist/tracker/digest.js.map +1 -0
  838. package/dist/tracker/engagement.js +100 -0
  839. package/dist/tracker/engagement.js.map +1 -0
  840. package/dist/tracker/events.js +37 -0
  841. package/dist/tracker/events.js.map +1 -0
  842. package/dist/tracker/exclusion.d.ts +2 -22
  843. package/dist/tracker/exclusion.js +53 -21
  844. package/dist/tracker/exclusion.js.map +1 -1
  845. package/dist/tracker/gate.js +194 -0
  846. package/dist/tracker/gate.js.map +1 -0
  847. package/dist/tracker/initTracker.d.ts +5 -8
  848. package/dist/tracker/initTracker.js +42 -14
  849. package/dist/tracker/initTracker.js.map +1 -1
  850. package/dist/tracker/itemCapture.js +224 -0
  851. package/dist/tracker/itemCapture.js.map +1 -0
  852. package/dist/tracker/loadScript.js +21 -14
  853. package/dist/tracker/loadScript.js.map +1 -1
  854. package/dist/tracker/pageTracking.js +6 -6
  855. package/dist/tracker/pageTracking.js.map +1 -1
  856. package/dist/tracker/registry.js +118 -30
  857. package/dist/tracker/registry.js.map +1 -1
  858. package/dist/tracker/sinks/createSink.js +38 -0
  859. package/dist/tracker/sinks/createSink.js.map +1 -0
  860. package/dist/tracker/sinks/ga4.js +64 -20
  861. package/dist/tracker/sinks/ga4.js.map +1 -1
  862. package/dist/tracker/sinks/native.js +7 -42
  863. package/dist/tracker/sinks/native.js.map +1 -1
  864. package/dist/tracker/sinks/plausible.js +27 -22
  865. package/dist/tracker/sinks/plausible.js.map +1 -1
  866. package/dist/tracker/sinks/posthog.js +26 -22
  867. package/dist/tracker/sinks/posthog.js.map +1 -1
  868. package/dist/tracker/sinks/umami.js +14 -12
  869. package/dist/tracker/sinks/umami.js.map +1 -1
  870. package/dist/tracker/sinks/vendor.js +30 -27
  871. package/dist/tracker/sinks/vendor.js.map +1 -1
  872. package/dist/tracker/skip.js +81 -0
  873. package/dist/tracker/skip.js.map +1 -0
  874. package/dist/tracker/storage.js +23 -0
  875. package/dist/tracker/storage.js.map +1 -0
  876. package/dist/tracker/transport.js +2 -5
  877. package/dist/tracker/transport.js.map +1 -1
  878. package/dist/tracker/types.d.ts +86 -63
  879. package/dist/tracker/window.js +7 -0
  880. package/dist/tracker/window.js.map +1 -0
  881. package/dist/translations/ar.js +226 -71
  882. package/dist/translations/ar.js.map +1 -1
  883. package/dist/translations/de.js +215 -69
  884. package/dist/translations/de.js.map +1 -1
  885. package/dist/translations/en.js +209 -67
  886. package/dist/translations/en.js.map +1 -1
  887. package/dist/translations/es.js +217 -68
  888. package/dist/translations/es.js.map +1 -1
  889. package/dist/translations/fr.js +221 -72
  890. package/dist/translations/fr.js.map +1 -1
  891. package/dist/translations/id.js +212 -67
  892. package/dist/translations/id.js.map +1 -1
  893. package/dist/translations/index.d.ts +1 -1
  894. package/dist/translations/index.js +5 -7
  895. package/dist/translations/index.js.map +1 -1
  896. package/dist/translations/intl.js +71 -0
  897. package/dist/translations/intl.js.map +1 -0
  898. package/dist/translations/keys.d.ts +185 -14
  899. package/dist/translations/keys.js +190 -14
  900. package/dist/translations/keys.js.map +1 -1
  901. package/dist/translations/ko.js +214 -69
  902. package/dist/translations/ko.js.map +1 -1
  903. package/dist/translations/labelMap.d.ts +10 -0
  904. package/dist/translations/labelMap.js +22 -0
  905. package/dist/translations/labelMap.js.map +1 -0
  906. package/dist/translations/metricKeys.js +10 -2
  907. package/dist/translations/metricKeys.js.map +1 -1
  908. package/dist/translations/parts.js +20 -0
  909. package/dist/translations/parts.js.map +1 -0
  910. package/dist/translations/plural.js +61 -0
  911. package/dist/translations/plural.js.map +1 -0
  912. package/dist/translations/pt.js +226 -77
  913. package/dist/translations/pt.js.map +1 -1
  914. package/dist/translations/ru.js +217 -66
  915. package/dist/translations/ru.js.map +1 -1
  916. package/dist/translations/server.d.ts +1 -0
  917. package/dist/translations/server.js +2 -3
  918. package/dist/translations/server.js.map +1 -1
  919. package/dist/translations/staticLabel.js +69 -0
  920. package/dist/translations/staticLabel.js.map +1 -0
  921. package/dist/translations/uk.js +217 -66
  922. package/dist/translations/uk.js.map +1 -1
  923. package/dist/translations/zh.js +212 -67
  924. package/dist/translations/zh.js.map +1 -1
  925. package/dist/ui/RangePicker.js +112 -0
  926. package/dist/ui/RangePicker.js.map +1 -0
  927. package/dist/ui/analytics.css +1528 -0
  928. package/dist/ui/calendarDays.js +27 -0
  929. package/dist/ui/calendarDays.js.map +1 -0
  930. package/dist/ui/classNames.js +7 -0
  931. package/dist/ui/classNames.js.map +1 -0
  932. package/dist/ui/components/Card.d.ts +28 -0
  933. package/dist/ui/components/Card.js +21 -0
  934. package/dist/ui/components/Card.js.map +1 -0
  935. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  936. package/dist/ui/components/ChartDataTable.js +48 -0
  937. package/dist/ui/components/ChartDataTable.js.map +1 -0
  938. package/dist/ui/components/DataTable.d.ts +82 -0
  939. package/dist/ui/components/DataTable.js +214 -0
  940. package/dist/ui/components/DataTable.js.map +1 -0
  941. package/dist/ui/components/LabeledSelect.js +62 -0
  942. package/dist/ui/components/LabeledSelect.js.map +1 -0
  943. package/dist/ui/components/LiveAnnouncement.js +21 -0
  944. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  945. package/dist/ui/components/MetricCard.d.ts +38 -0
  946. package/dist/ui/components/MetricCard.js +39 -0
  947. package/dist/ui/components/MetricCard.js.map +1 -0
  948. package/dist/ui/components/NoValue.js +22 -0
  949. package/dist/ui/components/NoValue.js.map +1 -0
  950. package/dist/ui/components/ReadState.js +27 -0
  951. package/dist/ui/components/ReadState.js.map +1 -0
  952. package/dist/ui/components/RefreshButton.js +26 -0
  953. package/dist/ui/components/RefreshButton.js.map +1 -0
  954. package/dist/ui/cssVars.js +7 -0
  955. package/dist/ui/cssVars.js.map +1 -0
  956. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  957. package/dist/ui/data/WithScopeToken.js +20 -0
  958. package/dist/ui/data/WithScopeToken.js.map +1 -0
  959. package/dist/ui/data/clientFieldProps.js +16 -0
  960. package/dist/ui/data/clientFieldProps.js.map +1 -0
  961. package/dist/ui/data/request.d.ts +46 -0
  962. package/dist/ui/data/request.js +119 -0
  963. package/dist/ui/data/request.js.map +1 -0
  964. package/dist/ui/data/scopeTokenContext.js +18 -0
  965. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  966. package/dist/ui/data/sharedCache.js +48 -0
  967. package/dist/ui/data/sharedCache.js.map +1 -0
  968. package/dist/ui/data/useRequest.d.ts +19 -0
  969. package/dist/ui/data/useRequest.js +123 -0
  970. package/dist/ui/data/useRequest.js.map +1 -0
  971. package/dist/ui/data/useRequestScope.js +25 -0
  972. package/dist/ui/data/useRequestScope.js.map +1 -0
  973. package/dist/ui/hooks/useDirection.js +47 -0
  974. package/dist/ui/hooks/useDirection.js.map +1 -0
  975. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  976. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  977. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  978. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  979. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  980. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  981. package/dist/ui/readState.js +19 -0
  982. package/dist/ui/readState.js.map +1 -0
  983. package/dist/ui/rows/toDisplayRows.js +49 -0
  984. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  985. package/dist/ui/viewerClock.js +7 -0
  986. package/dist/ui/viewerClock.js.map +1 -0
  987. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  988. package/dist/view/AnalyticsNavLink.js +11 -6
  989. package/dist/view/AnalyticsNavLink.js.map +1 -1
  990. package/dist/view/AnalyticsView.d.ts +8 -10
  991. package/dist/view/AnalyticsView.js +47 -18
  992. package/dist/view/AnalyticsView.js.map +1 -1
  993. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  994. package/dist/view/AnalyticsViewClient.js +15 -229
  995. package/dist/view/AnalyticsViewClient.js.map +1 -1
  996. package/dist/view/CountryFlag.d.ts +27 -0
  997. package/dist/view/CountryFlag.js +44 -0
  998. package/dist/view/CountryFlag.js.map +1 -0
  999. package/dist/view/DocumentTitle.js +27 -0
  1000. package/dist/view/DocumentTitle.js.map +1 -0
  1001. package/dist/view/ViewRoot.d.ts +21 -0
  1002. package/dist/view/ViewRoot.js +150 -0
  1003. package/dist/view/ViewRoot.js.map +1 -0
  1004. package/dist/view/ViewSections.d.ts +38 -0
  1005. package/dist/view/ViewSections.js +190 -0
  1006. package/dist/view/ViewSections.js.map +1 -0
  1007. package/dist/view/authRedirect.js +2 -4
  1008. package/dist/view/authRedirect.js.map +1 -1
  1009. package/dist/view/conversionRate.js +9 -7
  1010. package/dist/view/conversionRate.js.map +1 -1
  1011. package/dist/view/dayRange.js +6 -10
  1012. package/dist/view/dayRange.js.map +1 -1
  1013. package/dist/view/exclusionLink.d.ts +27 -0
  1014. package/dist/view/exclusionLink.js +46 -0
  1015. package/dist/view/exclusionLink.js.map +1 -0
  1016. package/dist/view/flagSrc.js +14 -0
  1017. package/dist/view/flagSrc.js.map +1 -0
  1018. package/dist/view/gating.d.ts +15 -1
  1019. package/dist/view/gating.js +66 -31
  1020. package/dist/view/gating.js.map +1 -1
  1021. package/dist/view/hostCountryFlag.js +41 -0
  1022. package/dist/view/hostCountryFlag.js.map +1 -0
  1023. package/dist/view/labels.js +95 -10
  1024. package/dist/view/labels.js.map +1 -1
  1025. package/dist/view/metricAliases.js +10 -0
  1026. package/dist/view/metricAliases.js.map +1 -0
  1027. package/dist/view/navLabel.js +15 -0
  1028. package/dist/view/navLabel.js.map +1 -0
  1029. package/dist/view/registerView.js +10 -9
  1030. package/dist/view/registerView.js.map +1 -1
  1031. package/dist/view/scopeLabel.js +21 -0
  1032. package/dist/view/scopeLabel.js.map +1 -0
  1033. package/dist/view/sections/Breakdowns.js +196 -134
  1034. package/dist/view/sections/Breakdowns.js.map +1 -1
  1035. package/dist/view/sections/EmptyStates.js +118 -30
  1036. package/dist/view/sections/EmptyStates.js.map +1 -1
  1037. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1038. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1039. package/dist/view/sections/FilterChips.js +124 -27
  1040. package/dist/view/sections/FilterChips.js.map +1 -1
  1041. package/dist/view/sections/GoalsPanel.js +68 -60
  1042. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1043. package/dist/view/sections/OverviewCards.js +29 -33
  1044. package/dist/view/sections/OverviewCards.js.map +1 -1
  1045. package/dist/view/sections/RealtimeStrip.js +70 -59
  1046. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1047. package/dist/view/sections/SectionBoundary.js +34 -0
  1048. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1049. package/dist/view/sections/Toolbar.d.ts +11 -0
  1050. package/dist/view/sections/Toolbar.js +123 -82
  1051. package/dist/view/sections/Toolbar.js.map +1 -1
  1052. package/dist/view/sections/Trend.js +176 -76
  1053. package/dist/view/sections/Trend.js.map +1 -1
  1054. package/dist/view/state.d.ts +42 -0
  1055. package/dist/view/state.js +93 -54
  1056. package/dist/view/state.js.map +1 -1
  1057. package/dist/view/useViewClock.js +31 -0
  1058. package/dist/view/useViewClock.js.map +1 -0
  1059. package/dist/view/useViewQueries.d.ts +21 -0
  1060. package/dist/view/useViewQueries.js +45 -77
  1061. package/dist/view/useViewQueries.js.map +1 -1
  1062. package/dist/view/useViewState.js +42 -0
  1063. package/dist/view/useViewState.js.map +1 -0
  1064. package/dist/view/useViewUrl.js +47 -0
  1065. package/dist/view/useViewUrl.js.map +1 -0
  1066. package/dist/view/viewBody.js +30 -0
  1067. package/dist/view/viewBody.js.map +1 -0
  1068. package/dist/view/viewContext.d.ts +81 -0
  1069. package/dist/view/viewContext.js +49 -0
  1070. package/dist/view/viewContext.js.map +1 -0
  1071. package/dist/view/viewProps.d.ts +64 -7
  1072. package/dist/view/viewProps.js +121 -35
  1073. package/dist/view/viewProps.js.map +1 -1
  1074. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1075. package/dist/widgets/AnalyticsBreakdownWidget.js +143 -118
  1076. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1077. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1078. package/dist/widgets/AnalyticsGoalsWidget.js +124 -167
  1079. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1080. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1081. package/dist/widgets/AnalyticsMetricWidget.js +80 -106
  1082. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1083. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1084. package/dist/widgets/AnalyticsRealtimeWidget.js +74 -64
  1085. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1086. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1087. package/dist/widgets/AnalyticsTrendWidget.js +129 -123
  1088. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1089. package/dist/widgets/ComparisonDelta.js +33 -42
  1090. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1091. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1092. package/dist/widgets/RealtimeCounter.js +91 -77
  1093. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1094. package/dist/widgets/WidgetCard.d.ts +80 -0
  1095. package/dist/widgets/WidgetCard.js +99 -0
  1096. package/dist/widgets/WidgetCard.js.map +1 -0
  1097. package/dist/widgets/WidgetFrame.js +42 -0
  1098. package/dist/widgets/WidgetFrame.js.map +1 -0
  1099. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1100. package/dist/widgets/WidgetShimmer.js +86 -0
  1101. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1102. package/dist/widgets/breakdownTypes.js +12 -2
  1103. package/dist/widgets/breakdownTypes.js.map +1 -1
  1104. package/dist/widgets/customWidget.d.ts +5 -1
  1105. package/dist/widgets/customWidget.js +6 -7
  1106. package/dist/widgets/customWidget.js.map +1 -1
  1107. package/dist/widgets/defaults.d.ts +4 -7
  1108. package/dist/widgets/defaults.js +4 -7
  1109. package/dist/widgets/defaults.js.map +1 -1
  1110. package/dist/widgets/fieldRows.js +14 -0
  1111. package/dist/widgets/fieldRows.js.map +1 -0
  1112. package/dist/widgets/filterCaption.js +6 -7
  1113. package/dist/widgets/filterCaption.js.map +1 -1
  1114. package/dist/widgets/filterField.d.ts +3 -7
  1115. package/dist/widgets/filterField.js +46 -35
  1116. package/dist/widgets/filterField.js.map +1 -1
  1117. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1118. package/dist/widgets/filterValueLabel.js +45 -0
  1119. package/dist/widgets/filterValueLabel.js.map +1 -0
  1120. package/dist/widgets/notices.js +73 -0
  1121. package/dist/widgets/notices.js.map +1 -0
  1122. package/dist/widgets/prepareWidgetRead.d.ts +5 -1
  1123. package/dist/widgets/prepareWidgetRead.js +59 -27
  1124. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1125. package/dist/widgets/range.js +26 -21
  1126. package/dist/widgets/range.js.map +1 -1
  1127. package/dist/widgets/readForWidget.d.ts +27 -18
  1128. package/dist/widgets/readForWidget.js +31 -29
  1129. package/dist/widgets/readForWidget.js.map +1 -1
  1130. package/dist/widgets/readForWidgetBreakdown.d.ts +39 -28
  1131. package/dist/widgets/readForWidgetBreakdown.js +46 -22
  1132. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1133. package/dist/widgets/readForWidgetGoals.d.ts +17 -23
  1134. package/dist/widgets/readForWidgetGoals.js +50 -46
  1135. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1136. package/dist/widgets/readForWidgetRealtime.d.ts +21 -17
  1137. package/dist/widgets/readForWidgetRealtime.js +51 -27
  1138. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1139. package/dist/widgets/readForWidgetSeries.d.ts +26 -31
  1140. package/dist/widgets/readForWidgetSeries.js +43 -82
  1141. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1142. package/dist/widgets/readMeta.d.ts +44 -0
  1143. package/dist/widgets/readMeta.js +47 -4
  1144. package/dist/widgets/readMeta.js.map +1 -1
  1145. package/dist/widgets/realtimePoll.d.ts +1 -0
  1146. package/dist/widgets/realtimePoll.js +53 -25
  1147. package/dist/widgets/realtimePoll.js.map +1 -1
  1148. package/dist/widgets/registerWidgets.js +204 -126
  1149. package/dist/widgets/registerWidgets.js.map +1 -1
  1150. package/dist/widgets/stateKeys.js +30 -0
  1151. package/dist/widgets/stateKeys.js.map +1 -0
  1152. package/dist/widgets/titleForecast.js +89 -0
  1153. package/dist/widgets/titleForecast.js.map +1 -0
  1154. package/dist/widgets/types.d.ts +4 -3
  1155. package/dist/widgets/types.js +2 -0
  1156. package/dist/widgets/types.js.map +1 -1
  1157. package/dist/widgets/viewLink.d.ts +24 -6
  1158. package/dist/widgets/viewLink.js +31 -24
  1159. package/dist/widgets/viewLink.js.map +1 -1
  1160. package/dist/widgets/widgetData.js +34 -0
  1161. package/dist/widgets/widgetData.js.map +1 -0
  1162. package/dist/widgets/widgetWindow.d.ts +1 -0
  1163. package/dist/widgets/widgetWindow.js +51 -0
  1164. package/dist/widgets/widgetWindow.js.map +1 -0
  1165. package/package.json +44 -22
  1166. package/dist/adapters/ga4/disableKey.d.ts +0 -9
  1167. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1168. package/dist/capture/getTrackerConfig.js +0 -31
  1169. package/dist/capture/getTrackerConfig.js.map +0 -1
  1170. package/dist/capture/slots.d.ts +0 -8
  1171. package/dist/capture/trackerConfig.d.ts +0 -33
  1172. package/dist/charts/styles.js +0 -59
  1173. package/dist/charts/styles.js.map +0 -1
  1174. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1175. package/dist/fields/dateRange/styles.js +0 -23
  1176. package/dist/fields/dateRange/styles.js.map +0 -1
  1177. package/dist/goals/GoalSelectField.d.ts +0 -7
  1178. package/dist/native/collections/events.js +0 -165
  1179. package/dist/native/collections/events.js.map +0 -1
  1180. package/dist/native/collections/rollups.js +0 -151
  1181. package/dist/native/collections/rollups.js.map +0 -1
  1182. package/dist/native/collections/seen.js +0 -47
  1183. package/dist/native/collections/seen.js.map +0 -1
  1184. package/dist/native/eventScan.js +0 -25
  1185. package/dist/native/eventScan.js.map +0 -1
  1186. package/dist/native/ingest/flushBatch.js +0 -60
  1187. package/dist/native/ingest/flushBatch.js.map +0 -1
  1188. package/dist/native/ingest/salt.js +0 -39
  1189. package/dist/native/ingest/salt.js.map +0 -1
  1190. package/dist/native/ingest/writeBuffer.js +0 -55
  1191. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1192. package/dist/native/ingest/writeEvent.js +0 -14
  1193. package/dist/native/ingest/writeEvent.js.map +0 -1
  1194. package/dist/native/query/eventAgg.js +0 -175
  1195. package/dist/native/query/eventAgg.js.map +0 -1
  1196. package/dist/native/realtime/buildRealtime.js +0 -53
  1197. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1198. package/dist/native/retention/pruneTask.js +0 -69
  1199. package/dist/native/retention/pruneTask.js.map +0 -1
  1200. package/dist/native/rollupAcc.js +0 -64
  1201. package/dist/native/rollupAcc.js.map +0 -1
  1202. package/dist/native/rollups/bucketKey.js +0 -15
  1203. package/dist/native/rollups/bucketKey.js.map +0 -1
  1204. package/dist/native/rollups/bumpRollups.js +0 -116
  1205. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1206. package/dist/native/rollups/deltas.js +0 -106
  1207. package/dist/native/rollups/deltas.js.map +0 -1
  1208. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1209. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1210. package/dist/plugin/paths.js +0 -29
  1211. package/dist/plugin/paths.js.map +0 -1
  1212. package/dist/react/TrackerBoot.d.ts +0 -22
  1213. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1214. package/dist/rsc/AnalyticsScripts.js +0 -41
  1215. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1216. package/dist/surfacing/queue.js +0 -60
  1217. package/dist/surfacing/queue.js.map +0 -1
  1218. package/dist/surfacing/retryPolicy.js +0 -15
  1219. package/dist/surfacing/retryPolicy.js.map +0 -1
  1220. package/dist/tracker/autoCapture.d.ts +0 -48
  1221. package/dist/tracker/consent.d.ts +0 -24
  1222. package/dist/tracker/consent.js +0 -48
  1223. package/dist/tracker/consent.js.map +0 -1
  1224. package/dist/tracker/loadScript.d.ts +0 -14
  1225. package/dist/tracker/pageTracking.d.ts +0 -17
  1226. package/dist/tracker/registry.d.ts +0 -27
  1227. package/dist/tracker/sinks/ga4.d.ts +0 -29
  1228. package/dist/tracker/sinks/native.d.ts +0 -22
  1229. package/dist/tracker/sinks/plausible.d.ts +0 -20
  1230. package/dist/tracker/sinks/posthog.d.ts +0 -18
  1231. package/dist/tracker/sinks/umami.d.ts +0 -18
  1232. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1233. package/dist/view/sections/styles.js +0 -76
  1234. package/dist/view/sections/styles.js.map +0 -1
  1235. package/dist/widgets/WidgetViewLink.js +0 -17
  1236. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1237. package/dist/widgets/cardChrome.d.ts +0 -8
  1238. package/dist/widgets/cardChrome.js +0 -46
  1239. package/dist/widgets/cardChrome.js.map +0 -1
  1240. package/dist/widgets/comparison.js +0 -57
  1241. package/dist/widgets/comparison.js.map +0 -1
@@ -1,7 +1,15 @@
1
- import "./paths.js";
2
- import { getRuntime, readAccessFor } from "./runtime.js";
3
- import { NO_STORE, RETRY_AFTER, analyticsError, errorResponse } from "./errors.js";
4
- 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";
5
13
  //#region src/plugin/realtimeEndpoint.ts
6
14
  const ALLOWED_METRICS = ["visitors", "pageviews"];
7
15
  const ALLOWED_WINDOWS = [
@@ -12,39 +20,83 @@ const ALLOWED_WINDOWS = [
12
20
  ];
13
21
  const DEFAULT_WINDOW = 30;
14
22
  /**
15
- * Authenticated GET handler for the realtime widget poller. Reads + clamps the query
16
- * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request
17
- * and 403 when `access.read` denies, which defaults to any authenticated user (not
18
- * admin-panel access specifically); the response is integer counts only. A source that
19
- * throws answers a retryable 503 rather than an unhandled 500: the widget polls this every
20
- * few seconds, and a provider outage is not a reason to burn a stack trace per poll. Only
21
- * the read is retryable, though, so an `access.read` resolver that throws answers 500: that
22
- * is a configuration bug, and telling the poller to come back would only repeat it. Every
23
- * answer is `no-store`, since what it counts depends on the caller's own scope.
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.
25
+ */
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({
43
+ req,
44
+ collection,
45
+ id: params.get("id") ?? ""
46
+ });
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`.
24
73
  */
25
74
  const makeRealtimeHandler = () => async (req) => {
26
- if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
75
+ if (!req.user) return unauthorizedResponse();
27
76
  try {
28
77
  const runtime = getRuntime(req.payload);
29
- if (runtime && !await readAccessFor(runtime, req)) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
30
- const params = new URL(req.url ?? "", "http://localhost").searchParams;
78
+ if (runtime && !await readGate(runtime, req)) return readDeniedResponse();
79
+ const params = queryParams(req);
31
80
  const rawMetric = params.get("metric");
32
- const metric = ALLOWED_METRICS.includes(rawMetric) ? rawMetric : "visitors";
33
- const rawWindow = Number(params.get("windowMinutes"));
34
- const windowMinutes = ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW;
35
- const dataSource = params.get("dataSource") ?? void 0;
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;
36
86
  try {
37
- const result = await readForWidgetRealtime({
87
+ const result = await readRealtimeOrThrow({
38
88
  req,
39
89
  metric,
40
90
  windowMinutes,
41
- adapterId: dataSource,
42
- now: /* @__PURE__ */ new Date()
91
+ adapterId: params.get("dataSource") ?? void 0,
92
+ now: currentDate(),
93
+ series: params.get("series") !== "0",
94
+ ...target
43
95
  });
44
96
  return Response.json(result, { headers: NO_STORE });
45
97
  } catch (err) {
46
- req.payload.logger?.warn(`analytics: realtime read failed: ${String(err)}`);
47
- return errorResponse(503, analyticsError("unavailable", "analytics: source is temporarily unavailable"), RETRY_AFTER);
98
+ req.payload.logger?.warn(`analytics: realtime read failed: ${describeWithCauses(err)}`);
99
+ return readFailureResponse(err);
48
100
  }
49
101
  } catch (err) {
50
102
  req.payload.logger?.error(`analytics: realtime request failed: ${String(err)}`);
@@ -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 { analyticsError, errorResponse, NO_STORE, RETRY_AFTER } from './errors'\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. A source that\n * throws answers a retryable 503 rather than an unhandled 500: the widget polls this every\n * few seconds, and a provider outage is not a reason to burn a stack trace per poll. Only\n * the read is retryable, though, so an `access.read` resolver that throws answers 500: that\n * is a configuration bug, and telling the poller to come back would only repeat it. Every\n * answer is `no-store`, since what it counts depends on the caller's own scope.\n */\nexport const makeRealtimeHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn errorResponse(401, analyticsError('unauthorized', 'analytics: authentication required'))\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 readAccessFor(runtime, req))) {\n\t\t\treturn errorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\t\t}\n\t\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\t\tconst rawMetric = params.get('metric')\n\t\tconst metric: MetricKey = ALLOWED_METRICS.includes(rawMetric as MetricKey)\n\t\t\t? (rawMetric as MetricKey)\n\t\t\t: 'visitors'\n\t\tconst rawWindow = Number(params.get('windowMinutes'))\n\t\tconst windowMinutes = ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW\n\t\tconst dataSource = params.get('dataSource') ?? undefined\n\t\ttry {\n\t\t\tconst result = await readForWidgetRealtime({\n\t\t\t\treq,\n\t\t\t\tmetric,\n\t\t\t\twindowMinutes,\n\t\t\t\tadapterId: dataSource,\n\t\t\t\tnow: new Date(),\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: ${String(err)}`)\n\t\t\treturn errorResponse(\n\t\t\t\t503,\n\t\t\t\tanalyticsError('unavailable', 'analytics: source is temporarily unavailable'),\n\t\t\t\tRETRY_AFTER\n\t\t\t)\n\t\t}\n\t} catch (err) {\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":";;;;;AASA,MAAM,kBAA+B,CAAC,YAAY,WAAW;AAC7D,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;AAAE;AACtC,MAAM,iBAAiB;;;;;;;;;;;;AAavB,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,cAAc,KAAK,eAAe,gBAAgB,oCAAoC,CAAC;CAE/F,IAAI;EACH,MAAM,UAAU,WAAW,IAAI,OAAO;EAEtC,IAAI,WAAW,CAAE,MAAM,cAAc,SAAS,GAAG,GAChD,OAAO,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;EAEvF,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;EAC1D,MAAM,YAAY,OAAO,IAAI,QAAQ;EACrC,MAAM,SAAoB,gBAAgB,SAAS,SAAsB,IACrE,YACD;EACH,MAAM,YAAY,OAAO,OAAO,IAAI,eAAe,CAAC;EACpD,MAAM,gBAAgB,gBAAgB,SAAS,SAAS,IAAI,YAAY;EACxE,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK,KAAA;EAC/C,IAAI;GACH,MAAM,SAAS,MAAM,sBAAsB;IAC1C;IACA;IACA;IACA,WAAW;IACX,qBAAK,IAAI,KAAK;GACf,CAAC;GACD,OAAO,SAAS,KAAK,QAAQ,EAAE,SAAS,SAAS,CAAC;EACnD,SAAS,KAAK;GACb,IAAI,QAAQ,QAAQ,KAAK,oCAAoC,OAAO,GAAG,GAAG;GAC1E,OAAO,cACN,KACA,eAAe,eAAe,8CAA8C,GAC5E,WACD;EACD;CACD,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,MAAM,uCAAuC,OAAO,GAAG,GAAG;EAC9E,OAAO,cAAc,KAAK,eAAe,YAAY,iCAAiC,CAAC;CACxF;AACD"}
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"}
@@ -1,24 +1,23 @@
1
- import "./paths.js";
2
- import "../core/contract.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import { isRecord } from "../core/values.js";
3
3
  import { epochKeyFor } from "../surfacing/epoch.js";
4
- import { cacheEpochFor, getRuntime, platformReadGate, readAccessFor } from "./runtime.js";
5
- import { readCappedBody } from "../capture/requestBody.js";
6
- import { NO_STORE, RETRY_AFTER, analyticsError, errorResponse } from "./errors.js";
4
+ import { cacheEpochFor, getRuntime, resolvableScope, scopeGates } from "./runtime.js";
7
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";
8
11
  //#region src/plugin/refreshEndpoint.ts
9
12
  /** The body carries one optional scope string; anything larger is not this request. */
10
13
  const MAX_REFRESH_BODY_BYTES = 4 * 1024;
11
14
  /**
12
- * How long one scope stays refreshed after this instance bumps it for a request. This is a
13
- * debounce of invalidation, not request rate limiting: a looped POST would otherwise retire
14
- * every cached read of a scope over and over and turn each of them into a provider call. It
15
- * bounds only what the endpoint does, never how often a caller may ask, which is the edge's
16
- * job. Collection hooks are not debounced: a save has to be visible on the next read.
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
17
  */
18
18
  const REFRESH_DEBOUNCE_MS = 5e3;
19
19
  /**
20
- * Per-scope debounce state. Entries are pruned on every write rather than kept, so an
21
- * instance that refreshes thousands of scopes over its life holds only the ones a bump
20
+ * Per-scope debounce state, pruned on every write so a long-lived instance holds only scopes a bump
22
21
  * could still be debounced against.
23
22
  */
24
23
  const createRefreshDebounce = (now, windowMs = REFRESH_DEBOUNCE_MS) => {
@@ -39,9 +38,29 @@ const createRefreshDebounce = (now, windowMs = REFRESH_DEBOUNCE_MS) => {
39
38
  };
40
39
  };
41
40
  /**
42
- * The optional `{ scope }` body. An empty body, a body that is not an object and a body
43
- * with no `scope` all mean "my own scope": a refresh is a button, and callers that send
44
- * nothing at all are the common case. Only a `scope` of the wrong type is a refusal.
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.
45
64
  */
46
65
  const parseBody = (bytes) => {
47
66
  if (bytes.byteLength === 0) return { ok: true };
@@ -51,47 +70,53 @@ const parseBody = (bytes) => {
51
70
  } catch {
52
71
  return { ok: true };
53
72
  }
54
- if (typeof parsed !== "object" || parsed === null) return { ok: true };
55
- if (!("scope" in parsed)) return { ok: true };
56
- const scope = parsed.scope;
73
+ const scope = isRecord(parsed) ? parsed.scope : void 0;
57
74
  if (scope === void 0 || scope === null) return { ok: true };
58
75
  return typeof scope === "string" ? {
59
76
  ok: true,
60
77
  scope
61
78
  } : { ok: false };
62
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
+ };
63
99
  /**
64
- * Authenticated POST raising one scope's cache epoch, which retires every cached read
65
- * keyed on the old one across every instance. Gated exactly like the read endpoints:
66
- * authentication, then `access.read`, then scope.
67
- *
68
- * Scope goes through `resolveRequestedScope`, the same decision the query endpoint reads
69
- * with, so this endpoint refuses every request that endpoint refuses: a named scope needs
70
- * `platformRead`, and so does a request whose own scope will not resolve on a scoped
71
- * install. Both answer `400 untrusted_scope`. The wildcard bumps the install-wide token,
72
- * because a cross-scope read stamps no scope on its query and its entries key on exactly
73
- * that token.
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.
74
102
  */
75
103
  const makeRefreshHandler = (opts = {}) => {
76
- const debounce = createRefreshDebounce(opts.now ?? Date.now);
104
+ const debounce = createRefreshDebounce(opts.now ?? monotonicMs);
77
105
  return async (req) => {
78
- if (!req.user) return errorResponse(401, analyticsError("unauthorized", "analytics: authentication required"));
106
+ if (!req.user) return unauthorizedResponse();
79
107
  const runtime = getRuntime(req.payload);
80
- if (!runtime) return errorResponse(503, analyticsError("unavailable", "analytics: not available"), RETRY_AFTER);
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;
81
118
  try {
82
- if (!await readAccessFor(runtime, req)) return errorResponse(403, analyticsError("forbidden", "analytics: read access denied"));
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
- platformRead: platformReadGate(runtime, req)
92
- });
93
- if (!requested.ok) return errorResponse(400, analyticsError("untrusted_scope", "analytics: scope is not permitted for this request", "scope"));
94
- const scope = requested.scope === "*" ? null : requested.scope;
119
+ if (named && scope !== null && !await knownScope(runtime, req, scope)) return Response.json({ epoch: "0" }, { headers: NO_STORE });
95
120
  const key = epochKeyFor(scope);
96
121
  if (!debounce.allows(key)) {
97
122
  const debounced = { epoch: await cacheEpochFor(runtime, scope) };
@@ -1 +1 @@
1
- {"version":3,"file":"refreshEndpoint.js","names":[],"sources":["../../src/plugin/refreshEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readCappedBody } from '../capture/requestBody'\nimport { PLATFORM_SCOPE } from '../core/contract'\nimport { resolveRequestedScope } from '../core/scopedRead'\nimport type { RefreshResponse } from '../query/fetchQuery'\nimport { epochKeyFor, INITIAL_EPOCH } from '../surfacing/epoch'\nimport { analyticsError, errorResponse, NO_STORE, RETRY_AFTER } from './errors'\nimport { REFRESH_PATH } from './paths'\nimport { cacheEpochFor, getRuntime, platformReadGate, readAccessFor } from './runtime'\n\nexport { REFRESH_PATH }\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 * How long one scope stays refreshed after this instance bumps it for a request. This is a\n * debounce of invalidation, not request rate limiting: a looped POST would otherwise retire\n * every cached read of a scope over and over and turn each of them into a provider call. It\n * bounds only what the endpoint does, never how often a caller may ask, which is the edge's\n * job. Collection hooks are not debounced: a save has to be visible on the next read.\n */\nexport const REFRESH_DEBOUNCE_MS = 5_000\n\nexport interface RefreshHandlerOptions {\n\t/** Clock behind the debounce window; `Date.now` unless a test injects one. */\n\tnow?: () => number\n}\n\nexport interface 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. Entries are pruned on every write rather than kept, so an\n * instance that refreshes thousands of scopes over its life holds only the ones 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\ntype ParsedBody = { ok: true; scope?: string } | { ok: false }\n\n/**\n * The optional `{ scope }` body. An empty body, a body that is not an object and a body\n * with no `scope` all mean \"my own scope\": a refresh is a button, and callers that send\n * nothing at all are the common case. Only a `scope` of the wrong type is a refusal.\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\tif (typeof parsed !== 'object' || parsed === null) {\n\t\treturn { ok: true }\n\t}\n\tif (!('scope' in parsed)) {\n\t\treturn { ok: true }\n\t}\n\tconst scope: unknown = parsed.scope\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\n/**\n * Authenticated POST raising one scope's cache epoch, which retires every cached read\n * keyed on the old one across every instance. Gated exactly like the read endpoints:\n * authentication, then `access.read`, then scope.\n *\n * Scope goes through `resolveRequestedScope`, the same decision the query endpoint reads\n * with, so this endpoint refuses every request that endpoint refuses: a named scope needs\n * `platformRead`, and so does a request whose own scope will not resolve on a scoped\n * install. Both answer `400 untrusted_scope`. The wildcard bumps the install-wide token,\n * because a cross-scope read stamps no scope on its query and its entries key on exactly\n * that token.\n */\nexport const makeRefreshHandler = (opts: RefreshHandlerOptions = {}): PayloadHandler => {\n\tconst now = opts.now ?? Date.now\n\tconst debounce = createRefreshDebounce(now)\n\n\treturn async (req: PayloadRequest) => {\n\t\tif (!req.user) {\n\t\t\treturn errorResponse(\n\t\t\t\t401,\n\t\t\t\tanalyticsError('unauthorized', 'analytics: authentication required')\n\t\t\t)\n\t\t}\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn errorResponse(\n\t\t\t\t503,\n\t\t\t\tanalyticsError('unavailable', 'analytics: not available'),\n\t\t\t\tRETRY_AFTER\n\t\t\t)\n\t\t}\n\t\ttry {\n\t\t\tif (!(await readAccessFor(runtime, req))) {\n\t\t\t\treturn errorResponse(403, analyticsError('forbidden', 'analytics: read access denied'))\n\t\t\t}\n\t\t\tconst read = await readCappedBody(req, MAX_REFRESH_BODY_BYTES)\n\t\t\tif (!read.ok) {\n\t\t\t\treturn read.reason === 'too-large'\n\t\t\t\t\t? errorResponse(\n\t\t\t\t\t\t\t413,\n\t\t\t\t\t\t\tanalyticsError('payload_too_large', 'analytics: the refresh body is too large')\n\t\t\t\t\t\t)\n\t\t\t\t\t: errorResponse(\n\t\t\t\t\t\t\t400,\n\t\t\t\t\t\t\tanalyticsError(\n\t\t\t\t\t\t\t\t'invalid_param',\n\t\t\t\t\t\t\t\t'analytics: the refresh body could not be read',\n\t\t\t\t\t\t\t\t'scope'\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t)\n\t\t\t}\n\t\t\tconst body = parseBody(read.body)\n\t\t\tif (!body.ok) {\n\t\t\t\treturn errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tanalyticsError('invalid_param', 'analytics: scope must be a string', 'scope')\n\t\t\t\t)\n\t\t\t}\n\t\t\tconst requested = await resolveRequestedScope({\n\t\t\t\truntime,\n\t\t\t\treq,\n\t\t\t\traw: body.scope ?? null,\n\t\t\t\tplatformRead: platformReadGate(runtime, req),\n\t\t\t})\n\t\t\tif (!requested.ok) {\n\t\t\t\treturn errorResponse(\n\t\t\t\t\t400,\n\t\t\t\t\tanalyticsError(\n\t\t\t\t\t\t'untrusted_scope',\n\t\t\t\t\t\t'analytics: scope is not permitted for this request',\n\t\t\t\t\t\t'scope'\n\t\t\t\t\t)\n\t\t\t\t)\n\t\t\t}\n\t\t\tconst scope = requested.scope === PLATFORM_SCOPE ? null : requested.scope\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":";;;;;;;;;AAaA,MAAa,yBAAyB,IAAI;;;;;;;;AAS1C,MAAa,sBAAsB;;;;;;AAqBnC,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;;;;;;AASA,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,IAAI,OAAO,WAAW,YAAY,WAAW,MAC5C,OAAO,EAAE,IAAI,KAAK;CAEnB,IAAI,EAAE,WAAW,SAChB,OAAO,EAAE,IAAI,KAAK;CAEnB,MAAM,QAAiB,OAAO;CAC9B,IAAI,UAAU,KAAA,KAAa,UAAU,MACpC,OAAO,EAAE,IAAI,KAAK;CAEnB,OAAO,OAAO,UAAU,WAAW;EAAE,IAAI;EAAM;CAAM,IAAI,EAAE,IAAI,MAAM;AACtE;;;;;;;;;;;;;AAcA,MAAa,sBAAsB,OAA8B,CAAC,MAAsB;CAEvF,MAAM,WAAW,sBADL,KAAK,OAAO,KAAK,GACa;CAE1C,OAAO,OAAO,QAAwB;EACrC,IAAI,CAAC,IAAI,MACR,OAAO,cACN,KACA,eAAe,gBAAgB,oCAAoC,CACpE;EAED,MAAM,UAAU,WAAW,IAAI,OAAO;EACtC,IAAI,CAAC,SACJ,OAAO,cACN,KACA,eAAe,eAAe,0BAA0B,GACxD,WACD;EAED,IAAI;GACH,IAAI,CAAE,MAAM,cAAc,SAAS,GAAG,GACrC,OAAO,cAAc,KAAK,eAAe,aAAa,+BAA+B,CAAC;GAEvF,MAAM,OAAO,MAAM,eAAe,KAAK,sBAAsB;GAC7D,IAAI,CAAC,KAAK,IACT,OAAO,KAAK,WAAW,cACpB,cACA,KACA,eAAe,qBAAqB,0CAA0C,CAC/E,IACC,cACA,KACA,eACC,iBACA,iDACA,OACD,CACD;GAEH,MAAM,OAAO,UAAU,KAAK,IAAI;GAChC,IAAI,CAAC,KAAK,IACT,OAAO,cACN,KACA,eAAe,iBAAiB,qCAAqC,OAAO,CAC7E;GAED,MAAM,YAAY,MAAM,sBAAsB;IAC7C;IACA;IACA,KAAK,KAAK,SAAS;IACnB,cAAc,iBAAiB,SAAS,GAAG;GAC5C,CAAC;GACD,IAAI,CAAC,UAAU,IACd,OAAO,cACN,KACA,eACC,mBACA,sDACA,OACD,CACD;GAED,MAAM,QAAQ,UAAU,UAAA,MAA2B,OAAO,UAAU;GACpE,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"}
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