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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +710 -0
  2. package/README.md +35 -36
  3. package/dist/access/adminUser.d.ts +15 -0
  4. package/dist/access/adminUser.js +13 -0
  5. package/dist/access/adminUser.js.map +1 -0
  6. package/dist/access/decideOnce.js +16 -0
  7. package/dist/access/decideOnce.js.map +1 -0
  8. package/dist/access/membership.d.ts +23 -0
  9. package/dist/access/membership.js +63 -0
  10. package/dist/access/membership.js.map +1 -0
  11. package/dist/access/principal.d.ts +37 -0
  12. package/dist/access/principal.js +29 -0
  13. package/dist/access/principal.js.map +1 -0
  14. package/dist/access/readGate.js +16 -0
  15. package/dist/access/readGate.js.map +1 -0
  16. package/dist/adapters/ga4/disableKey.js +19 -0
  17. package/dist/adapters/ga4/disableKey.js.map +1 -0
  18. package/dist/adapters/ga4/eventName.d.ts +2 -8
  19. package/dist/adapters/ga4/eventName.js +2 -8
  20. package/dist/adapters/ga4/eventName.js.map +1 -1
  21. package/dist/adapters/ga4/ga4.d.ts +24 -0
  22. package/dist/adapters/ga4/ga4.js +226 -122
  23. package/dist/adapters/ga4/ga4.js.map +1 -1
  24. package/dist/adapters/ga4/measurementId.js +2 -3
  25. package/dist/adapters/ga4/measurementId.js.map +1 -1
  26. package/dist/adapters/goalRead.js +15 -29
  27. package/dist/adapters/goalRead.js.map +1 -1
  28. package/dist/adapters/http/baseUrl.js +15 -0
  29. package/dist/adapters/http/baseUrl.js.map +1 -0
  30. package/dist/adapters/http/fetchJson.d.ts +19 -0
  31. package/dist/adapters/http/fetchJson.js +27 -8
  32. package/dist/adapters/http/fetchJson.js.map +1 -1
  33. package/dist/adapters/mapping.js +52 -0
  34. package/dist/adapters/mapping.js.map +1 -0
  35. package/dist/adapters/plausible/plausible.d.ts +25 -13
  36. package/dist/adapters/plausible/plausible.js +144 -124
  37. package/dist/adapters/plausible/plausible.js.map +1 -1
  38. package/dist/adapters/plausible/scriptId.js +19 -0
  39. package/dist/adapters/plausible/scriptId.js.map +1 -0
  40. package/dist/adapters/posthog/posthog.d.ts +33 -9
  41. package/dist/adapters/posthog/posthog.js +279 -121
  42. package/dist/adapters/posthog/posthog.js.map +1 -1
  43. package/dist/adapters/posthog/projectCheck.js +56 -0
  44. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  45. package/dist/adapters/readTime.js +7 -0
  46. package/dist/adapters/readTime.js.map +1 -0
  47. package/dist/adapters/series.js +14 -8
  48. package/dist/adapters/series.js.map +1 -1
  49. package/dist/adapters/umami/umami.d.ts +19 -9
  50. package/dist/adapters/umami/umami.js +196 -166
  51. package/dist/adapters/umami/umami.js.map +1 -1
  52. package/dist/adapters/upstream.js +16 -0
  53. package/dist/adapters/upstream.js.map +1 -0
  54. package/dist/binding/report.d.ts +8 -0
  55. package/dist/binding/report.js +24 -0
  56. package/dist/binding/report.js.map +1 -0
  57. package/dist/binding/resolvePath.js +28 -25
  58. package/dist/binding/resolvePath.js.map +1 -1
  59. package/dist/binding/types.d.ts +14 -29
  60. package/dist/capture/captureRequest.js +28 -0
  61. package/dist/capture/captureRequest.js.map +1 -0
  62. package/dist/capture/exclusionEndpoint.js +98 -0
  63. package/dist/capture/exclusionEndpoint.js.map +1 -0
  64. package/dist/capture/exclusionPrelude.js +14 -0
  65. package/dist/capture/exclusionPrelude.js.map +1 -0
  66. package/dist/capture/exclusionToken.js +23 -0
  67. package/dist/capture/exclusionToken.js.map +1 -0
  68. package/dist/capture/jsLiteral.js +19 -0
  69. package/dist/capture/jsLiteral.js.map +1 -0
  70. package/dist/capture/mountPath.js +2 -3
  71. package/dist/capture/mountPath.js.map +1 -1
  72. package/dist/capture/proxyEndpoint.js +49 -92
  73. package/dist/capture/proxyEndpoint.js.map +1 -1
  74. package/dist/capture/proxyRoutes.js +58 -21
  75. package/dist/capture/proxyRoutes.js.map +1 -1
  76. package/dist/capture/relay.js +91 -0
  77. package/dist/capture/relay.js.map +1 -0
  78. package/dist/capture/requestBody.js +2 -6
  79. package/dist/capture/requestBody.js.map +1 -1
  80. package/dist/capture/requestTrust.js +45 -0
  81. package/dist/capture/requestTrust.js.map +1 -0
  82. package/dist/capture/sameSite.js +40 -0
  83. package/dist/capture/sameSite.js.map +1 -0
  84. package/dist/capture/slots.js +50 -25
  85. package/dist/capture/slots.js.map +1 -1
  86. package/dist/capture/trackerConfig.js +131 -36
  87. package/dist/capture/trackerConfig.js.map +1 -1
  88. package/dist/capture/trackerEndpoint.js +22 -21
  89. package/dist/capture/trackerEndpoint.js.map +1 -1
  90. package/dist/capture/withoutConsent.js +91 -0
  91. package/dist/capture/withoutConsent.js.map +1 -0
  92. package/dist/charts/BarList.d.ts +27 -13
  93. package/dist/charts/BarList.js +38 -83
  94. package/dist/charts/BarList.js.map +1 -1
  95. package/dist/charts/TrendChart.d.ts +40 -7
  96. package/dist/charts/TrendChart.js +243 -215
  97. package/dist/charts/TrendChart.js.map +1 -1
  98. package/dist/charts/bars.d.ts +17 -1
  99. package/dist/charts/bars.js +12 -11
  100. package/dist/charts/bars.js.map +1 -1
  101. package/dist/charts/bucket.js +106 -73
  102. package/dist/charts/bucket.js.map +1 -1
  103. package/dist/charts/inProgress.js +22 -0
  104. package/dist/charts/inProgress.js.map +1 -0
  105. package/dist/charts/series.d.ts +15 -0
  106. package/dist/charts/series.js +123 -0
  107. package/dist/charts/series.js.map +1 -0
  108. package/dist/charts/spline.js +91 -25
  109. package/dist/charts/spline.js.map +1 -1
  110. package/dist/charts/trendGeometry.js +91 -0
  111. package/dist/charts/trendGeometry.js.map +1 -0
  112. package/dist/core/adminOptions.d.ts +1 -0
  113. package/dist/core/adminOptions.js +198 -0
  114. package/dist/core/adminOptions.js.map +1 -0
  115. package/dist/core/budget.js +24 -0
  116. package/dist/core/budget.js.map +1 -0
  117. package/dist/core/cacheKey.d.ts +1 -0
  118. package/dist/core/cacheKey.js +48 -36
  119. package/dist/core/cacheKey.js.map +1 -1
  120. package/dist/core/cacheOptions.js +165 -0
  121. package/dist/core/cacheOptions.js.map +1 -0
  122. package/dist/core/capabilities.d.ts +24 -11
  123. package/dist/core/capabilities.js +96 -17
  124. package/dist/core/capabilities.js.map +1 -1
  125. package/dist/core/capture.d.ts +59 -26
  126. package/dist/core/captureOptions.d.ts +1 -0
  127. package/dist/core/captureOptions.js +347 -0
  128. package/dist/core/captureOptions.js.map +1 -0
  129. package/dist/core/clock.js +13 -0
  130. package/dist/core/clock.js.map +1 -0
  131. package/dist/core/collectionOption.d.ts +17 -0
  132. package/dist/core/collectionOption.js +105 -0
  133. package/dist/core/collectionOption.js.map +1 -0
  134. package/dist/core/collectionSlug.js +7 -0
  135. package/dist/core/collectionSlug.js.map +1 -0
  136. package/dist/core/contract.d.ts +321 -60
  137. package/dist/core/contract.js +7 -4
  138. package/dist/core/contract.js.map +1 -1
  139. package/dist/core/cron.js +57 -0
  140. package/dist/core/cron.js.map +1 -0
  141. package/dist/core/fetch.d.ts +17 -0
  142. package/dist/core/goalOptions.d.ts +1 -0
  143. package/dist/core/goalOptions.js +166 -0
  144. package/dist/core/goalOptions.js.map +1 -0
  145. package/dist/core/granularity.js +3 -2
  146. package/dist/core/granularity.js.map +1 -1
  147. package/dist/core/guards.js +17 -0
  148. package/dist/core/guards.js.map +1 -0
  149. package/dist/core/jobs.d.ts +40 -0
  150. package/dist/core/jobs.js +132 -0
  151. package/dist/core/jobs.js.map +1 -0
  152. package/dist/core/legacyOptions.js +145 -0
  153. package/dist/core/legacyOptions.js.map +1 -0
  154. package/dist/core/metricAliases.js +81 -0
  155. package/dist/core/metricAliases.js.map +1 -0
  156. package/dist/core/metricValues.js +57 -0
  157. package/dist/core/metricValues.js.map +1 -0
  158. package/dist/core/monotonic.js +10 -0
  159. package/dist/core/monotonic.js.map +1 -0
  160. package/dist/core/optionChecks.js +51 -0
  161. package/dist/core/optionChecks.js.map +1 -0
  162. package/dist/core/options.d.ts +530 -152
  163. package/dist/core/options.js +158 -216
  164. package/dist/core/options.js.map +1 -1
  165. package/dist/core/registry.js +45 -5
  166. package/dist/core/registry.js.map +1 -1
  167. package/dist/core/scopeList.js +7 -9
  168. package/dist/core/scopeList.js.map +1 -1
  169. package/dist/core/scopeOptions.d.ts +1 -0
  170. package/dist/core/scopeOptions.js +114 -0
  171. package/dist/core/scopeOptions.js.map +1 -0
  172. package/dist/core/scopedRead.js +349 -36
  173. package/dist/core/scopedRead.js.map +1 -1
  174. package/dist/core/sdks.d.ts +81 -0
  175. package/dist/core/sdks.js +23 -0
  176. package/dist/core/sdks.js.map +1 -0
  177. package/dist/core/serverEvent.d.ts +50 -16
  178. package/dist/core/serverEvent.js.map +1 -1
  179. package/dist/core/siteAddress.js +20 -0
  180. package/dist/core/siteAddress.js.map +1 -0
  181. package/dist/core/sourceErrors.js +109 -0
  182. package/dist/core/sourceErrors.js.map +1 -0
  183. package/dist/core/sourceLabel.d.ts +10 -0
  184. package/dist/core/sourceLabel.js +63 -0
  185. package/dist/core/sourceLabel.js.map +1 -0
  186. package/dist/core/sourceOptions.js +107 -0
  187. package/dist/core/sourceOptions.js.map +1 -0
  188. package/dist/core/sourcePolicy.d.ts +55 -0
  189. package/dist/core/sourcePolicy.js +51 -0
  190. package/dist/core/sourcePolicy.js.map +1 -0
  191. package/dist/core/throttle.js +18 -0
  192. package/dist/core/throttle.js.map +1 -0
  193. package/dist/core/values.js +61 -0
  194. package/dist/core/values.js.map +1 -0
  195. package/dist/core/widgetSlugs.d.ts +17 -0
  196. package/dist/core/widgetSlugs.js +29 -0
  197. package/dist/core/widgetSlugs.js.map +1 -0
  198. package/dist/db/detachedWrite.js +36 -0
  199. package/dist/db/detachedWrite.js.map +1 -0
  200. package/dist/db/errors.js +182 -0
  201. package/dist/db/errors.js.map +1 -0
  202. package/dist/db/kind.js +32 -0
  203. package/dist/db/kind.js.map +1 -0
  204. package/dist/db/openTransaction.js +51 -0
  205. package/dist/db/openTransaction.js.map +1 -0
  206. package/dist/exports/adapters/contract.d.ts +15 -0
  207. package/dist/exports/adapters/ga4.d.ts +16 -1
  208. package/dist/exports/adapters/native.d.ts +29 -2
  209. package/dist/exports/adapters/native.js +5 -1
  210. package/dist/exports/adapters/plausible.d.ts +16 -1
  211. package/dist/exports/adapters/posthog.d.ts +16 -1
  212. package/dist/exports/adapters/umami.d.ts +16 -1
  213. package/dist/exports/attributes.d.ts +42 -0
  214. package/dist/exports/attributes.js +83 -0
  215. package/dist/exports/attributes.js.map +1 -0
  216. package/dist/exports/client.d.ts +43 -12
  217. package/dist/exports/client.js +22 -8
  218. package/dist/exports/geo.d.ts +4 -2
  219. package/dist/exports/geo.js +1 -1
  220. package/dist/exports/i18n.d.ts +2 -2
  221. package/dist/exports/i18n.js +2 -2
  222. package/dist/exports/migrations.d.ts +2 -0
  223. package/dist/exports/migrations.js +2 -0
  224. package/dist/exports/react.d.ts +5 -3
  225. package/dist/exports/react.js +1 -2
  226. package/dist/exports/routes.d.ts +19 -0
  227. package/dist/exports/routes.js +3 -0
  228. package/dist/exports/rsc.d.ts +32 -14
  229. package/dist/exports/rsc.js +11 -6
  230. package/dist/exports/site.d.ts +5 -0
  231. package/dist/exports/site.js +3 -0
  232. package/dist/exports/testing.d.ts +18 -0
  233. package/dist/exports/testing.js +3 -0
  234. package/dist/exports/tracker.d.ts +6 -18
  235. package/dist/exports/tracker.js +3 -12
  236. package/dist/exports/types.d.ts +45 -14
  237. package/dist/exports/types.js +6 -1
  238. package/dist/fields/AnalyticsPanelClient.js +265 -154
  239. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  240. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  241. package/dist/fields/AnalyticsPanelField.js +123 -30
  242. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  243. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  244. package/dist/fields/AnalyticsStatField.js +98 -63
  245. package/dist/fields/AnalyticsStatField.js.map +1 -1
  246. package/dist/fields/FieldShimmer.js +15 -0
  247. package/dist/fields/FieldShimmer.js.map +1 -0
  248. package/dist/fields/PanelContent.js +222 -0
  249. package/dist/fields/PanelContent.js.map +1 -0
  250. package/dist/fields/PanelList.js +82 -0
  251. package/dist/fields/PanelList.js.map +1 -0
  252. package/dist/fields/PanelLiveCounter.js +63 -0
  253. package/dist/fields/PanelLiveCounter.js.map +1 -0
  254. package/dist/fields/PanelSkeleton.js +63 -0
  255. package/dist/fields/PanelSkeleton.js.map +1 -0
  256. package/dist/fields/componentPaths.js +8 -0
  257. package/dist/fields/componentPaths.js.map +1 -0
  258. package/dist/fields/config/FilterDimensionSelectField.d.ts +2 -2
  259. package/dist/fields/config/FilterDimensionSelectField.js +26 -54
  260. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -1
  261. package/dist/fields/config/FilterKeySelect.js +66 -0
  262. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  263. package/dist/fields/config/FilterOperatorSelectField.d.ts +7 -2
  264. package/dist/fields/config/FilterOperatorSelectField.js +37 -53
  265. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -1
  266. package/dist/fields/config/FilterValueField.d.ts +17 -0
  267. package/dist/fields/config/FilterValueField.js +130 -0
  268. package/dist/fields/config/FilterValueField.js.map +1 -0
  269. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  270. package/dist/fields/config/MetricSelectField.js +18 -30
  271. package/dist/fields/config/MetricSelectField.js.map +1 -1
  272. package/dist/fields/config/OptionSelect.js +52 -0
  273. package/dist/fields/config/OptionSelect.js.map +1 -0
  274. package/dist/fields/config/SourceSelectField.js +16 -31
  275. package/dist/fields/config/SourceSelectField.js.map +1 -1
  276. package/dist/fields/config/fetchSources.d.ts +3 -0
  277. package/dist/fields/config/fetchSources.js +17 -23
  278. package/dist/fields/config/fetchSources.js.map +1 -1
  279. package/dist/fields/config/filterValues.js +106 -0
  280. package/dist/fields/config/filterValues.js.map +1 -0
  281. package/dist/fields/config/narrow.js +8 -10
  282. package/dist/fields/config/narrow.js.map +1 -1
  283. package/dist/fields/config/retiredPickers.d.ts +45 -0
  284. package/dist/fields/config/retiredPickers.js +46 -0
  285. package/dist/fields/config/retiredPickers.js.map +1 -0
  286. package/dist/fields/config/scopedFields.d.ts +40 -0
  287. package/dist/fields/config/scopedFields.js +68 -0
  288. package/dist/fields/config/scopedFields.js.map +1 -0
  289. package/dist/fields/config/toSelectOption.js +13 -7
  290. package/dist/fields/config/toSelectOption.js.map +1 -1
  291. package/dist/fields/config/useAnalyticsSources.d.ts +5 -7
  292. package/dist/fields/config/useAnalyticsSources.js +17 -21
  293. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  294. package/dist/fields/config/useFilterCapabilities.d.ts +9 -6
  295. package/dist/fields/config/useFilterCapabilities.js +23 -15
  296. package/dist/fields/config/useFilterCapabilities.js.map +1 -1
  297. package/dist/fields/config/useFormString.js +12 -0
  298. package/dist/fields/config/useFormString.js.map +1 -0
  299. package/dist/fields/dateRange/field.js +7 -19
  300. package/dist/fields/dateRange/field.js.map +1 -1
  301. package/dist/fields/dateRange/types.d.ts +5 -1
  302. package/dist/fields/dateRange/ui.d.ts +3 -2
  303. package/dist/fields/dateRange/ui.js +57 -319
  304. package/dist/fields/dateRange/ui.js.map +1 -1
  305. package/dist/fields/documentScope.js +21 -0
  306. package/dist/fields/documentScope.js.map +1 -0
  307. package/dist/fields/emptyState.js +30 -26
  308. package/dist/fields/emptyState.js.map +1 -1
  309. package/dist/fields/factories.d.ts +35 -16
  310. package/dist/fields/factories.js +67 -38
  311. package/dist/fields/factories.js.map +1 -1
  312. package/dist/fields/format.d.ts +12 -3
  313. package/dist/fields/format.js +77 -13
  314. package/dist/fields/format.js.map +1 -1
  315. package/dist/fields/itemReport.js +45 -0
  316. package/dist/fields/itemReport.js.map +1 -0
  317. package/dist/fields/readForDocument.d.ts +79 -26
  318. package/dist/fields/readForDocument.js +450 -116
  319. package/dist/fields/readForDocument.js.map +1 -1
  320. package/dist/fields/stateKeys.js +20 -0
  321. package/dist/fields/stateKeys.js.map +1 -0
  322. package/dist/goals/GoalAmountField.d.ts +10 -0
  323. package/dist/goals/GoalAmountField.js +179 -0
  324. package/dist/goals/GoalAmountField.js.map +1 -0
  325. package/dist/goals/GoalSelectField.js +89 -40
  326. package/dist/goals/GoalSelectField.js.map +1 -1
  327. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  328. package/dist/goals/GoalSelectFieldServer.js +21 -0
  329. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  330. package/dist/goals/amountField.d.ts +20 -0
  331. package/dist/goals/amountField.js +37 -0
  332. package/dist/goals/amountField.js.map +1 -0
  333. package/dist/goals/builtin.js +17 -0
  334. package/dist/goals/builtin.js.map +1 -0
  335. package/dist/goals/collection.d.ts +22 -0
  336. package/dist/goals/collection.js +143 -124
  337. package/dist/goals/collection.js.map +1 -1
  338. package/dist/goals/constants.d.ts +38 -0
  339. package/dist/goals/constants.js +49 -0
  340. package/dist/goals/constants.js.map +1 -0
  341. package/dist/goals/currency.d.ts +16 -0
  342. package/dist/goals/currency.js +46 -4
  343. package/dist/goals/currency.js.map +1 -1
  344. package/dist/goals/currencyOptions.js +70 -0
  345. package/dist/goals/currencyOptions.js.map +1 -0
  346. package/dist/goals/fetchGoals.d.ts +10 -0
  347. package/dist/goals/fetchGoals.js +12 -22
  348. package/dist/goals/fetchGoals.js.map +1 -1
  349. package/dist/goals/goalField.d.ts +4 -6
  350. package/dist/goals/goalField.js +9 -19
  351. package/dist/goals/goalField.js.map +1 -1
  352. package/dist/goals/goalsEndpoint.js +40 -38
  353. package/dist/goals/goalsEndpoint.js.map +1 -1
  354. package/dist/goals/items.js +35 -0
  355. package/dist/goals/items.js.map +1 -0
  356. package/dist/goals/latent.js +9 -0
  357. package/dist/goals/latent.js.map +1 -0
  358. package/dist/goals/linkFields.d.ts +35 -0
  359. package/dist/goals/linkFields.js +31 -0
  360. package/dist/goals/linkFields.js.map +1 -0
  361. package/dist/goals/match.d.ts +14 -0
  362. package/dist/goals/match.js +67 -46
  363. package/dist/goals/match.js.map +1 -1
  364. package/dist/goals/moneyFields.js +56 -0
  365. package/dist/goals/moneyFields.js.map +1 -0
  366. package/dist/goals/pathMatch.js +122 -0
  367. package/dist/goals/pathMatch.js.map +1 -0
  368. package/dist/goals/placeholder.js +12 -0
  369. package/dist/goals/placeholder.js.map +1 -0
  370. package/dist/goals/resolver.d.ts +3 -3
  371. package/dist/goals/resolver.js +155 -47
  372. package/dist/goals/resolver.js.map +1 -1
  373. package/dist/goals/serverRevenue.d.ts +60 -0
  374. package/dist/goals/serverRevenue.js +41 -0
  375. package/dist/goals/serverRevenue.js.map +1 -0
  376. package/dist/goals/trackGoalAction.d.ts +26 -25
  377. package/dist/goals/trackGoalAction.js +71 -66
  378. package/dist/goals/trackGoalAction.js.map +1 -1
  379. package/dist/goals/types.d.ts +13 -28
  380. package/dist/goals/types.js +1 -1
  381. package/dist/goals/types.js.map +1 -1
  382. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  383. package/dist/goals/useAnalyticsGoals.js +17 -18
  384. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  385. package/dist/index.d.ts +68 -12
  386. package/dist/index.js +261 -192
  387. package/dist/index.js.map +1 -1
  388. package/dist/items/collectionIdType.js +20 -0
  389. package/dist/items/collectionIdType.js.map +1 -0
  390. package/dist/items/idType.js +31 -0
  391. package/dist/items/idType.js.map +1 -0
  392. package/dist/items/ref.js +73 -0
  393. package/dist/items/ref.js.map +1 -0
  394. package/dist/maintenance/apiTaskState.js +141 -0
  395. package/dist/maintenance/apiTaskState.js.map +1 -0
  396. package/dist/maintenance/heartbeat.js +51 -0
  397. package/dist/maintenance/heartbeat.js.map +1 -0
  398. package/dist/maintenance/lease.d.ts +1 -0
  399. package/dist/maintenance/lease.js +79 -0
  400. package/dist/maintenance/lease.js.map +1 -0
  401. package/dist/maintenance/taskSchedule.js +27 -0
  402. package/dist/maintenance/taskSchedule.js.map +1 -0
  403. package/dist/maintenance/underLease.js +35 -0
  404. package/dist/maintenance/underLease.js.map +1 -0
  405. package/dist/migrations/legacy.d.ts +54 -0
  406. package/dist/migrations/legacy.js +117 -0
  407. package/dist/migrations/legacy.js.map +1 -0
  408. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  409. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  410. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  411. package/dist/native/collections/aggregates.js +54 -0
  412. package/dist/native/collections/aggregates.js.map +1 -0
  413. package/dist/native/collections/hits.js +103 -0
  414. package/dist/native/collections/hits.js.map +1 -0
  415. package/dist/native/collections/slugs.d.ts +10 -0
  416. package/dist/native/collections/slugs.js +16 -0
  417. package/dist/native/collections/slugs.js.map +1 -0
  418. package/dist/native/collections/state.js +84 -0
  419. package/dist/native/collections/state.js.map +1 -0
  420. package/dist/native/collections/storeCollection.js +31 -0
  421. package/dist/native/collections/storeCollection.js.map +1 -0
  422. package/dist/native/engine/buckets.d.ts +1 -0
  423. package/dist/native/engine/buckets.js +53 -0
  424. package/dist/native/engine/buckets.js.map +1 -0
  425. package/dist/native/engine/capabilities.js +87 -0
  426. package/dist/native/engine/capabilities.js.map +1 -0
  427. package/dist/native/engine/cost.js +72 -0
  428. package/dist/native/engine/cost.js.map +1 -0
  429. package/dist/native/engine/days.d.ts +1 -0
  430. package/dist/native/engine/days.js +182 -0
  431. package/dist/native/engine/days.js.map +1 -0
  432. package/dist/native/engine/engine.d.ts +1 -0
  433. package/dist/native/engine/engine.js +1627 -0
  434. package/dist/native/engine/engine.js.map +1 -0
  435. package/dist/native/engine/instance.js +58 -0
  436. package/dist/native/engine/instance.js.map +1 -0
  437. package/dist/native/engine/maintenance.d.ts +1 -0
  438. package/dist/native/engine/maintenance.js +677 -0
  439. package/dist/native/engine/maintenance.js.map +1 -0
  440. package/dist/native/engine/merge.js +41 -0
  441. package/dist/native/engine/merge.js.map +1 -0
  442. package/dist/native/engine/nudge.js +26 -0
  443. package/dist/native/engine/nudge.js.map +1 -0
  444. package/dist/native/engine/planner.js +199 -0
  445. package/dist/native/engine/planner.js.map +1 -0
  446. package/dist/native/engine/rebuild.d.ts +22 -0
  447. package/dist/native/engine/rebuild.js +76 -0
  448. package/dist/native/engine/rebuild.js.map +1 -0
  449. package/dist/native/engine/recent.js +17 -0
  450. package/dist/native/engine/recent.js.map +1 -0
  451. package/dist/native/engine/salt.d.ts +1 -0
  452. package/dist/native/engine/salt.js +98 -0
  453. package/dist/native/engine/salt.js.map +1 -0
  454. package/dist/native/engine/siteHosts.d.ts +1 -0
  455. package/dist/native/engine/siteHosts.js +58 -0
  456. package/dist/native/engine/siteHosts.js.map +1 -0
  457. package/dist/native/engine/toHit.js +110 -0
  458. package/dist/native/engine/toHit.js.map +1 -0
  459. package/dist/native/engine/writeBuffer.d.ts +14 -0
  460. package/dist/native/engine/writeBuffer.js +317 -0
  461. package/dist/native/engine/writeBuffer.js.map +1 -0
  462. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  463. package/dist/native/geo/composeGeoResolvers.js +5 -2
  464. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  465. package/dist/native/geo/geoResolver.d.ts +27 -2
  466. package/dist/native/geo/geoResolver.js +42 -6
  467. package/dist/native/geo/geoResolver.js.map +1 -1
  468. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  469. package/dist/native/geo/maxmindResolver.js +20 -16
  470. package/dist/native/geo/maxmindResolver.js.map +1 -1
  471. package/dist/native/geo/resolveGeo.js +31 -0
  472. package/dist/native/geo/resolveGeo.js.map +1 -0
  473. package/dist/native/ingest/bots.d.ts +10 -0
  474. package/dist/native/ingest/bots.js +66 -0
  475. package/dist/native/ingest/bots.js.map +1 -0
  476. package/dist/native/ingest/browser.js +4 -6
  477. package/dist/native/ingest/browser.js.map +1 -1
  478. package/dist/native/ingest/clientIp.js +34 -8
  479. package/dist/native/ingest/clientIp.js.map +1 -1
  480. package/dist/native/ingest/device.js +4 -6
  481. package/dist/native/ingest/device.js.map +1 -1
  482. package/dist/native/ingest/endpoint.d.ts +1 -1
  483. package/dist/native/ingest/endpoint.js +185 -32
  484. package/dist/native/ingest/endpoint.js.map +1 -1
  485. package/dist/native/ingest/itemSignature.d.ts +26 -0
  486. package/dist/native/ingest/itemSignature.js +45 -0
  487. package/dist/native/ingest/itemSignature.js.map +1 -0
  488. package/dist/native/ingest/language.js +2 -3
  489. package/dist/native/ingest/language.js.map +1 -1
  490. package/dist/native/ingest/normalizeEvent.d.ts +70 -8
  491. package/dist/native/ingest/normalizeEvent.js +239 -60
  492. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  493. package/dist/native/ingest/orderSignature.d.ts +13 -0
  494. package/dist/native/ingest/orderSignature.js +50 -0
  495. package/dist/native/ingest/orderSignature.js.map +1 -0
  496. package/dist/native/ingest/referrer.js +30 -32
  497. package/dist/native/ingest/referrer.js.map +1 -1
  498. package/dist/native/ingest/requestHost.js +44 -0
  499. package/dist/native/ingest/requestHost.js.map +1 -0
  500. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  501. package/dist/native/ingest/resolveHostname.js +51 -0
  502. package/dist/native/ingest/resolveHostname.js.map +1 -0
  503. package/dist/native/ingest/revenue.d.ts +1 -0
  504. package/dist/native/ingest/revenue.js +121 -0
  505. package/dist/native/ingest/revenue.js.map +1 -0
  506. package/dist/native/ingest/route.d.ts +10 -0
  507. package/dist/native/ingest/route.js +85 -0
  508. package/dist/native/ingest/route.js.map +1 -0
  509. package/dist/native/ingest/serverTrack.d.ts +2 -10
  510. package/dist/native/ingest/serverTrack.js +188 -69
  511. package/dist/native/ingest/serverTrack.js.map +1 -1
  512. package/dist/native/ingest/signature.js +28 -0
  513. package/dist/native/ingest/signature.js.map +1 -0
  514. package/dist/native/ingest/source.d.ts +5 -2
  515. package/dist/native/ingest/source.js +163 -59
  516. package/dist/native/ingest/source.js.map +1 -1
  517. package/dist/native/ingest/utm.js +9 -9
  518. package/dist/native/ingest/utm.js.map +1 -1
  519. package/dist/native/ingest/validate.js +25 -13
  520. package/dist/native/ingest/validate.js.map +1 -1
  521. package/dist/native/ingest/visitorHash.js +6 -8
  522. package/dist/native/ingest/visitorHash.js.map +1 -1
  523. package/dist/native/nativeAdapter.d.ts +128 -9
  524. package/dist/native/nativeAdapter.js +396 -288
  525. package/dist/native/nativeAdapter.js.map +1 -1
  526. package/dist/native/rebuildDays.d.ts +12 -0
  527. package/dist/native/rebuildDays.js +16 -0
  528. package/dist/native/rebuildDays.js.map +1 -0
  529. package/dist/native/store/aggregate.js +450 -0
  530. package/dist/native/store/aggregate.js.map +1 -0
  531. package/dist/native/store/caps.d.ts +18 -0
  532. package/dist/native/store/caps.js +76 -0
  533. package/dist/native/store/caps.js.map +1 -0
  534. package/dist/native/store/chunks.js +34 -0
  535. package/dist/native/store/chunks.js.map +1 -0
  536. package/dist/native/store/columnValues.js +31 -0
  537. package/dist/native/store/columnValues.js.map +1 -0
  538. package/dist/native/store/dialect.js +106 -0
  539. package/dist/native/store/dialect.js.map +1 -0
  540. package/dist/native/store/eventStore.js +44 -0
  541. package/dist/native/store/eventStore.js.map +1 -0
  542. package/dist/native/store/hitRow.js +119 -0
  543. package/dist/native/store/hitRow.js.map +1 -0
  544. package/dist/native/store/hits.js +65 -0
  545. package/dist/native/store/hits.js.map +1 -0
  546. package/dist/native/store/ids.js +105 -0
  547. package/dist/native/store/ids.js.map +1 -0
  548. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  549. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  550. package/dist/native/store/mongo/mongoState.js +375 -0
  551. package/dist/native/store/mongo/mongoState.js.map +1 -0
  552. package/dist/native/store/mongo/mongoStore.js +618 -0
  553. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  554. package/dist/native/store/mongo/pipelines.js +705 -0
  555. package/dist/native/store/mongo/pipelines.js.map +1 -0
  556. package/dist/native/store/mongo/results.js +20 -0
  557. package/dist/native/store/mongo/results.js.map +1 -0
  558. package/dist/native/store/parts.d.ts +1 -0
  559. package/dist/native/store/parts.js +101 -0
  560. package/dist/native/store/parts.js.map +1 -0
  561. package/dist/native/store/pattern.js +213 -0
  562. package/dist/native/store/pattern.js.map +1 -0
  563. package/dist/native/store/rawRead.d.ts +23 -0
  564. package/dist/native/store/rawRead.js +387 -0
  565. package/dist/native/store/rawRead.js.map +1 -0
  566. package/dist/native/store/reclassify.js +53 -0
  567. package/dist/native/store/reclassify.js.map +1 -0
  568. package/dist/native/store/sql/aggregateSql.js +349 -0
  569. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  570. package/dist/native/store/sql/columns.js +49 -0
  571. package/dist/native/store/sql/columns.js.map +1 -0
  572. package/dist/native/store/sql/compile.js +668 -0
  573. package/dist/native/store/sql/compile.js.map +1 -0
  574. package/dist/native/store/sql/drivers.js +218 -0
  575. package/dist/native/store/sql/drivers.js.map +1 -0
  576. package/dist/native/store/sql/executor.js +132 -0
  577. package/dist/native/store/sql/executor.js.map +1 -0
  578. package/dist/native/store/sql/fragment.js +104 -0
  579. package/dist/native/store/sql/fragment.js.map +1 -0
  580. package/dist/native/store/sql/maintenanceSql.js +59 -0
  581. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  582. package/dist/native/store/sql/ownConnection.js +107 -0
  583. package/dist/native/store/sql/ownConnection.js.map +1 -0
  584. package/dist/native/store/sql/poolShare.js +101 -0
  585. package/dist/native/store/sql/poolShare.js.map +1 -0
  586. package/dist/native/store/sql/sqlState.js +325 -0
  587. package/dist/native/store/sql/sqlState.js.map +1 -0
  588. package/dist/native/store/sql/sqlStore.js +355 -0
  589. package/dist/native/store/sql/sqlStore.js.map +1 -0
  590. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  591. package/dist/native/store/sql/sqliteThread.js +314 -0
  592. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  593. package/dist/native/store/sql/sqliteWorker.js +327 -0
  594. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  595. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  596. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  597. package/dist/native/store/state.js +151 -0
  598. package/dist/native/store/state.js.map +1 -0
  599. package/dist/native/store/stateStore.js +29 -0
  600. package/dist/native/store/stateStore.js.map +1 -0
  601. package/dist/native/store/types.d.ts +15 -0
  602. package/dist/native/store/types.js +10 -0
  603. package/dist/native/store/types.js.map +1 -0
  604. package/dist/native/tasks/maintainTask.d.ts +19 -0
  605. package/dist/native/tasks/maintainTask.js +57 -0
  606. package/dist/native/tasks/maintainTask.js.map +1 -0
  607. package/dist/net/guardedFetch.d.ts +32 -0
  608. package/dist/net/guardedFetch.js +220 -0
  609. package/dist/net/guardedFetch.js.map +1 -0
  610. package/dist/net/origin.js +40 -0
  611. package/dist/net/origin.js.map +1 -0
  612. package/dist/net/platform.d.ts +9 -0
  613. package/dist/net/platform.js +35 -0
  614. package/dist/net/platform.js.map +1 -0
  615. package/dist/plugin/adminDependencies.js +34 -0
  616. package/dist/plugin/adminDependencies.js.map +1 -0
  617. package/dist/plugin/apiPath.js +23 -0
  618. package/dist/plugin/apiPath.js.map +1 -0
  619. package/dist/plugin/boundDocument.js +58 -0
  620. package/dist/plugin/boundDocument.js.map +1 -0
  621. package/dist/plugin/buildPhase.js +10 -0
  622. package/dist/plugin/buildPhase.js.map +1 -0
  623. package/dist/plugin/collectionChecks.js +232 -0
  624. package/dist/plugin/collectionChecks.js.map +1 -0
  625. package/dist/plugin/collectionFields.d.ts +13 -0
  626. package/dist/plugin/collectionFields.js +22 -0
  627. package/dist/plugin/collectionFields.js.map +1 -0
  628. package/dist/plugin/createRuntime.js +346 -0
  629. package/dist/plugin/createRuntime.js.map +1 -0
  630. package/dist/plugin/destroy.js +58 -0
  631. package/dist/plugin/destroy.js.map +1 -0
  632. package/dist/plugin/documentEndpoint.js +105 -71
  633. package/dist/plugin/documentEndpoint.js.map +1 -1
  634. package/dist/plugin/documentScopes.js +37 -0
  635. package/dist/plugin/documentScopes.js.map +1 -0
  636. package/dist/plugin/encrypted.js +25 -0
  637. package/dist/plugin/encrypted.js.map +1 -0
  638. package/dist/plugin/errors.d.ts +24 -0
  639. package/dist/plugin/errors.js +86 -0
  640. package/dist/plugin/errors.js.map +1 -0
  641. package/dist/plugin/flagsEndpoint.js +41 -0
  642. package/dist/plugin/flagsEndpoint.js.map +1 -0
  643. package/dist/plugin/goalHint.js +22 -11
  644. package/dist/plugin/goalHint.js.map +1 -1
  645. package/dist/plugin/itemLabels.js +114 -0
  646. package/dist/plugin/itemLabels.js.map +1 -0
  647. package/dist/plugin/keepAlive.js +48 -0
  648. package/dist/plugin/keepAlive.js.map +1 -0
  649. package/dist/plugin/peerImportError.js +3 -6
  650. package/dist/plugin/peerImportError.js.map +1 -1
  651. package/dist/plugin/peers.js +64 -0
  652. package/dist/plugin/peers.js.map +1 -0
  653. package/dist/plugin/pluginCollections.js +161 -0
  654. package/dist/plugin/pluginCollections.js.map +1 -0
  655. package/dist/plugin/queryEndpoint.js +80 -51
  656. package/dist/plugin/queryEndpoint.js.map +1 -1
  657. package/dist/plugin/queryParams.js +7 -0
  658. package/dist/plugin/queryParams.js.map +1 -0
  659. package/dist/plugin/readContextForRequest.d.ts +11 -0
  660. package/dist/plugin/readContextForRequest.js +79 -32
  661. package/dist/plugin/readContextForRequest.js.map +1 -1
  662. package/dist/plugin/readFailure.js +22 -0
  663. package/dist/plugin/readFailure.js.map +1 -0
  664. package/dist/plugin/readableProviders.js +67 -0
  665. package/dist/plugin/readableProviders.js.map +1 -0
  666. package/dist/plugin/realtimeEndpoint.js +79 -34
  667. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  668. package/dist/plugin/refreshEndpoint.js +138 -0
  669. package/dist/plugin/refreshEndpoint.js.map +1 -0
  670. package/dist/plugin/relabelFields.js +36 -0
  671. package/dist/plugin/relabelFields.js.map +1 -0
  672. package/dist/plugin/requestMemo.js +35 -0
  673. package/dist/plugin/requestMemo.js.map +1 -0
  674. package/dist/plugin/routeChecks.js +39 -0
  675. package/dist/plugin/routeChecks.js.map +1 -0
  676. package/dist/plugin/routes.d.ts +53 -0
  677. package/dist/plugin/routes.js +92 -0
  678. package/dist/plugin/routes.js.map +1 -0
  679. package/dist/plugin/runtime.d.ts +1 -1
  680. package/dist/plugin/runtime.js +235 -29
  681. package/dist/plugin/runtime.js.map +1 -1
  682. package/dist/plugin/schemaOnly.js +61 -0
  683. package/dist/plugin/schemaOnly.js.map +1 -0
  684. package/dist/plugin/scopeChange.js +23 -0
  685. package/dist/plugin/scopeChange.js.map +1 -0
  686. package/dist/plugin/scopeFieldBoot.js +4 -4
  687. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  688. package/dist/plugin/scopeToken.js +33 -0
  689. package/dist/plugin/scopeToken.js.map +1 -0
  690. package/dist/plugin/sourcesEndpoint.js +50 -23
  691. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  692. package/dist/plugin/unbundledLanguages.js +25 -0
  693. package/dist/plugin/unbundledLanguages.js.map +1 -0
  694. package/dist/plugin/walkFields.js +24 -0
  695. package/dist/plugin/walkFields.js.map +1 -0
  696. package/dist/plugin/warmTask.js +0 -0
  697. package/dist/plugin/warmTask.js.map +1 -1
  698. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  699. package/dist/providers/ProvidersListNotice.js +36 -0
  700. package/dist/providers/ProvidersListNotice.js.map +1 -0
  701. package/dist/providers/access.d.ts +1 -0
  702. package/dist/providers/access.js +35 -26
  703. package/dist/providers/access.js.map +1 -1
  704. package/dist/providers/adapterPool.js +121 -0
  705. package/dist/providers/adapterPool.js.map +1 -0
  706. package/dist/providers/collection.d.ts +63 -0
  707. package/dist/providers/collection.js +369 -150
  708. package/dist/providers/collection.js.map +1 -1
  709. package/dist/providers/factory.d.ts +84 -0
  710. package/dist/providers/factory.js +84 -25
  711. package/dist/providers/factory.js.map +1 -1
  712. package/dist/providers/hosts.d.ts +25 -0
  713. package/dist/providers/hosts.js +128 -0
  714. package/dist/providers/hosts.js.map +1 -0
  715. package/dist/providers/probe.d.ts +1 -0
  716. package/dist/providers/probe.js +105 -0
  717. package/dist/providers/probe.js.map +1 -0
  718. package/dist/providers/refresh.d.ts +18 -0
  719. package/dist/providers/refresh.js +49 -0
  720. package/dist/providers/refresh.js.map +1 -0
  721. package/dist/providers/registry.js +329 -0
  722. package/dist/providers/registry.js.map +1 -0
  723. package/dist/providers/resolver.js +26 -88
  724. package/dist/providers/resolver.js.map +1 -1
  725. package/dist/providers/retarget.js +45 -0
  726. package/dist/providers/retarget.js.map +1 -0
  727. package/dist/providers/scopeUnique.js +41 -0
  728. package/dist/providers/scopeUnique.js.map +1 -0
  729. package/dist/providers/secrets.d.ts +26 -0
  730. package/dist/providers/secrets.js +61 -4
  731. package/dist/providers/secrets.js.map +1 -1
  732. package/dist/providers/stampScope.js +9 -6
  733. package/dist/providers/stampScope.js.map +1 -1
  734. package/dist/query/dates.js +10 -12
  735. package/dist/query/dates.js.map +1 -1
  736. package/dist/query/errors.d.ts +6 -13
  737. package/dist/query/fetchQuery.d.ts +36 -23
  738. package/dist/query/fetchQuery.js +96 -89
  739. package/dist/query/fetchQuery.js.map +1 -1
  740. package/dist/query/limits.js +8 -0
  741. package/dist/query/limits.js.map +1 -0
  742. package/dist/query/parse.d.ts +8 -2
  743. package/dist/query/parse.js +155 -108
  744. package/dist/query/parse.js.map +1 -1
  745. package/dist/query/response.d.ts +23 -3
  746. package/dist/query/response.js +12 -5
  747. package/dist/query/response.js.map +1 -1
  748. package/dist/react/AnalyticsProvider.d.ts +42 -20
  749. package/dist/react/AnalyticsProvider.js +24 -22
  750. package/dist/react/AnalyticsProvider.js.map +1 -1
  751. package/dist/react/TrackerBoot.js +15 -9
  752. package/dist/react/TrackerBoot.js.map +1 -1
  753. package/dist/react/useAnalytics.d.ts +2 -8
  754. package/dist/react/useAnalytics.js +31 -13
  755. package/dist/react/useAnalytics.js.map +1 -1
  756. package/dist/routes/captureRoute.d.ts +28 -0
  757. package/dist/routes/captureRoute.js +67 -0
  758. package/dist/routes/captureRoute.js.map +1 -0
  759. package/dist/routes/ingestRoute.d.ts +17 -0
  760. package/dist/routes/ingestRoute.js +17 -0
  761. package/dist/routes/ingestRoute.js.map +1 -0
  762. package/dist/site/AnalyticsScripts.d.ts +35 -0
  763. package/dist/site/AnalyticsScripts.js +44 -0
  764. package/dist/site/AnalyticsScripts.js.map +1 -0
  765. package/dist/site/getTrackerConfig.d.ts +15 -0
  766. package/dist/site/getTrackerConfig.js +43 -0
  767. package/dist/site/getTrackerConfig.js.map +1 -0
  768. package/dist/surfacing/afterRead.d.ts +37 -0
  769. package/dist/surfacing/bounded.js +38 -0
  770. package/dist/surfacing/bounded.js.map +1 -0
  771. package/dist/surfacing/breaker.js +107 -0
  772. package/dist/surfacing/breaker.js.map +1 -0
  773. package/dist/surfacing/cacheCollection.d.ts +8 -0
  774. package/dist/surfacing/cacheCollection.js +71 -0
  775. package/dist/surfacing/cacheCollection.js.map +1 -0
  776. package/dist/surfacing/cacheStore.d.ts +71 -1
  777. package/dist/surfacing/cacheStore.js +16 -37
  778. package/dist/surfacing/cacheStore.js.map +1 -1
  779. package/dist/surfacing/cacheSweep.d.ts +1 -0
  780. package/dist/surfacing/cacheSweep.js +59 -0
  781. package/dist/surfacing/cacheSweep.js.map +1 -0
  782. package/dist/surfacing/classifyError.js +282 -0
  783. package/dist/surfacing/classifyError.js.map +1 -0
  784. package/dist/surfacing/coalesce.js +2 -1
  785. package/dist/surfacing/coalesce.js.map +1 -1
  786. package/dist/surfacing/coldBudget.js +60 -0
  787. package/dist/surfacing/coldBudget.js.map +1 -0
  788. package/dist/surfacing/collectionCacheStore.js +183 -0
  789. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  790. package/dist/surfacing/engine.d.ts +1 -1
  791. package/dist/surfacing/engine.js +514 -71
  792. package/dist/surfacing/engine.js.map +1 -1
  793. package/dist/surfacing/epoch.d.ts +1 -0
  794. package/dist/surfacing/epoch.js +116 -0
  795. package/dist/surfacing/epoch.js.map +1 -0
  796. package/dist/surfacing/lanes.d.ts +1 -0
  797. package/dist/surfacing/lanes.js +297 -0
  798. package/dist/surfacing/lanes.js.map +1 -0
  799. package/dist/surfacing/memo.js +40 -0
  800. package/dist/surfacing/memo.js.map +1 -0
  801. package/dist/surfacing/rateLimiter.d.ts +1 -0
  802. package/dist/surfacing/rateLimiter.js +69 -94
  803. package/dist/surfacing/rateLimiter.js.map +1 -1
  804. package/dist/surfacing/rebucket.js +178 -0
  805. package/dist/surfacing/rebucket.js.map +1 -0
  806. package/dist/surfacing/recipe.js +28 -0
  807. package/dist/surfacing/recipe.js.map +1 -0
  808. package/dist/surfacing/shape.js +22 -0
  809. package/dist/surfacing/shape.js.map +1 -0
  810. package/dist/surfacing/todaySplit.js +119 -0
  811. package/dist/surfacing/todaySplit.js.map +1 -0
  812. package/dist/sync/collection.d.ts +8 -0
  813. package/dist/sync/collection.js +30 -18
  814. package/dist/sync/collection.js.map +1 -1
  815. package/dist/sync/rekeyDurations.js +70 -0
  816. package/dist/sync/rekeyDurations.js.map +1 -0
  817. package/dist/sync/syncTask.js +222 -109
  818. package/dist/sync/syncTask.js.map +1 -1
  819. package/dist/testing/memoryAdapter.d.ts +6 -3
  820. package/dist/testing/memoryAdapter.js +12 -10
  821. package/dist/testing/memoryAdapter.js.map +1 -1
  822. package/dist/testing/settle.d.ts +11 -0
  823. package/dist/testing/settle.js +19 -0
  824. package/dist/testing/settle.js.map +1 -0
  825. package/dist/timeframe/calendar.js +65 -0
  826. package/dist/timeframe/calendar.js.map +1 -0
  827. package/dist/timeframe/comparison.js +46 -0
  828. package/dist/timeframe/comparison.js.map +1 -0
  829. package/dist/timeframe/presets.d.ts +1 -1
  830. package/dist/timeframe/presets.js +5 -5
  831. package/dist/timeframe/presets.js.map +1 -1
  832. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  833. package/dist/timeframe/reportingTimezone.js +64 -0
  834. package/dist/timeframe/reportingTimezone.js.map +1 -0
  835. package/dist/timeframe/tz.js +55 -39
  836. package/dist/timeframe/tz.js.map +1 -1
  837. package/dist/tracker/autoCapture.js +125 -38
  838. package/dist/tracker/autoCapture.js.map +1 -1
  839. package/dist/tracker/campaign.js +52 -0
  840. package/dist/tracker/campaign.js.map +1 -0
  841. package/dist/tracker/config.d.ts +174 -0
  842. package/dist/tracker/config.js +25 -0
  843. package/dist/tracker/config.js.map +1 -0
  844. package/dist/tracker/createTracker.d.ts +5 -10
  845. package/dist/tracker/createTracker.js +434 -91
  846. package/dist/tracker/createTracker.js.map +1 -1
  847. package/dist/tracker/digest.js +28 -0
  848. package/dist/tracker/digest.js.map +1 -0
  849. package/dist/tracker/engagement.js +100 -0
  850. package/dist/tracker/engagement.js.map +1 -0
  851. package/dist/tracker/events.js +37 -0
  852. package/dist/tracker/events.js.map +1 -0
  853. package/dist/tracker/exclusion.d.ts +8 -0
  854. package/dist/tracker/exclusion.js +82 -0
  855. package/dist/tracker/exclusion.js.map +1 -0
  856. package/dist/tracker/gate.d.ts +8 -0
  857. package/dist/tracker/gate.js +244 -0
  858. package/dist/tracker/gate.js.map +1 -0
  859. package/dist/tracker/initTracker.d.ts +5 -8
  860. package/dist/tracker/initTracker.js +42 -14
  861. package/dist/tracker/initTracker.js.map +1 -1
  862. package/dist/tracker/itemCapture.js +224 -0
  863. package/dist/tracker/itemCapture.js.map +1 -0
  864. package/dist/tracker/loadScript.js +23 -15
  865. package/dist/tracker/loadScript.js.map +1 -1
  866. package/dist/tracker/pageTracking.js +6 -6
  867. package/dist/tracker/pageTracking.js.map +1 -1
  868. package/dist/tracker/registry.js +129 -30
  869. package/dist/tracker/registry.js.map +1 -1
  870. package/dist/tracker/sinks/createSink.js +60 -0
  871. package/dist/tracker/sinks/createSink.js.map +1 -0
  872. package/dist/tracker/sinks/ga4.js +97 -17
  873. package/dist/tracker/sinks/ga4.js.map +1 -1
  874. package/dist/tracker/sinks/native.js +21 -42
  875. package/dist/tracker/sinks/native.js.map +1 -1
  876. package/dist/tracker/sinks/plausible.js +36 -18
  877. package/dist/tracker/sinks/plausible.js.map +1 -1
  878. package/dist/tracker/sinks/posthog.js +145 -9
  879. package/dist/tracker/sinks/posthog.js.map +1 -1
  880. package/dist/tracker/sinks/umami.js +18 -10
  881. package/dist/tracker/sinks/umami.js.map +1 -1
  882. package/dist/tracker/sinks/vendor.js +54 -22
  883. package/dist/tracker/sinks/vendor.js.map +1 -1
  884. package/dist/tracker/skip.js +81 -0
  885. package/dist/tracker/skip.js.map +1 -0
  886. package/dist/tracker/storage.js +23 -0
  887. package/dist/tracker/storage.js.map +1 -0
  888. package/dist/tracker/transport.js +2 -5
  889. package/dist/tracker/transport.js.map +1 -1
  890. package/dist/tracker/types.d.ts +99 -49
  891. package/dist/tracker/window.js +7 -0
  892. package/dist/tracker/window.js.map +1 -0
  893. package/dist/translations/ar.js +255 -74
  894. package/dist/translations/ar.js.map +1 -1
  895. package/dist/translations/de.js +243 -71
  896. package/dist/translations/de.js.map +1 -1
  897. package/dist/translations/en.js +238 -70
  898. package/dist/translations/en.js.map +1 -1
  899. package/dist/translations/es.js +246 -71
  900. package/dist/translations/es.js.map +1 -1
  901. package/dist/translations/fr.js +250 -75
  902. package/dist/translations/fr.js.map +1 -1
  903. package/dist/translations/id.js +241 -70
  904. package/dist/translations/id.js.map +1 -1
  905. package/dist/translations/index.d.ts +1 -1
  906. package/dist/translations/index.js +5 -7
  907. package/dist/translations/index.js.map +1 -1
  908. package/dist/translations/intl.js +71 -0
  909. package/dist/translations/intl.js.map +1 -0
  910. package/dist/translations/keys.d.ts +214 -17
  911. package/dist/translations/keys.js +219 -17
  912. package/dist/translations/keys.js.map +1 -1
  913. package/dist/translations/ko.js +243 -72
  914. package/dist/translations/ko.js.map +1 -1
  915. package/dist/translations/labelMap.d.ts +10 -0
  916. package/dist/translations/labelMap.js +22 -0
  917. package/dist/translations/labelMap.js.map +1 -0
  918. package/dist/translations/metricKeys.js +10 -2
  919. package/dist/translations/metricKeys.js.map +1 -1
  920. package/dist/translations/parts.js +20 -0
  921. package/dist/translations/parts.js.map +1 -0
  922. package/dist/translations/plural.js +61 -0
  923. package/dist/translations/plural.js.map +1 -0
  924. package/dist/translations/pt.js +255 -80
  925. package/dist/translations/pt.js.map +1 -1
  926. package/dist/translations/ru.js +246 -69
  927. package/dist/translations/ru.js.map +1 -1
  928. package/dist/translations/server.d.ts +1 -0
  929. package/dist/translations/server.js +2 -3
  930. package/dist/translations/server.js.map +1 -1
  931. package/dist/translations/staticLabel.js +69 -0
  932. package/dist/translations/staticLabel.js.map +1 -0
  933. package/dist/translations/uk.js +246 -69
  934. package/dist/translations/uk.js.map +1 -1
  935. package/dist/translations/zh.js +241 -70
  936. package/dist/translations/zh.js.map +1 -1
  937. package/dist/ui/RangePicker.js +110 -0
  938. package/dist/ui/RangePicker.js.map +1 -0
  939. package/dist/ui/analytics.css +1667 -0
  940. package/dist/ui/calendarDays.js +27 -0
  941. package/dist/ui/calendarDays.js.map +1 -0
  942. package/dist/ui/classNames.js +7 -0
  943. package/dist/ui/classNames.js.map +1 -0
  944. package/dist/ui/components/Card.d.ts +28 -0
  945. package/dist/ui/components/Card.js +21 -0
  946. package/dist/ui/components/Card.js.map +1 -0
  947. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  948. package/dist/ui/components/ChartDataTable.js +48 -0
  949. package/dist/ui/components/ChartDataTable.js.map +1 -0
  950. package/dist/ui/components/ChoiceMenu.js +48 -0
  951. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  952. package/dist/ui/components/DataTable.d.ts +82 -0
  953. package/dist/ui/components/DataTable.js +214 -0
  954. package/dist/ui/components/DataTable.js.map +1 -0
  955. package/dist/ui/components/LabeledSelect.js +62 -0
  956. package/dist/ui/components/LabeledSelect.js.map +1 -0
  957. package/dist/ui/components/LiveAnnouncement.js +21 -0
  958. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  959. package/dist/ui/components/MetricCard.d.ts +38 -0
  960. package/dist/ui/components/MetricCard.js +39 -0
  961. package/dist/ui/components/MetricCard.js.map +1 -0
  962. package/dist/ui/components/NoValue.js +22 -0
  963. package/dist/ui/components/NoValue.js.map +1 -0
  964. package/dist/ui/components/ReadState.js +27 -0
  965. package/dist/ui/components/ReadState.js.map +1 -0
  966. package/dist/ui/components/RefreshButton.js +25 -0
  967. package/dist/ui/components/RefreshButton.js.map +1 -0
  968. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  969. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  970. package/dist/ui/cssVars.js +7 -0
  971. package/dist/ui/cssVars.js.map +1 -0
  972. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  973. package/dist/ui/data/WithScopeToken.js +20 -0
  974. package/dist/ui/data/WithScopeToken.js.map +1 -0
  975. package/dist/ui/data/clientFieldProps.js +16 -0
  976. package/dist/ui/data/clientFieldProps.js.map +1 -0
  977. package/dist/ui/data/request.d.ts +46 -0
  978. package/dist/ui/data/request.js +119 -0
  979. package/dist/ui/data/request.js.map +1 -0
  980. package/dist/ui/data/scopeTokenContext.js +18 -0
  981. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  982. package/dist/ui/data/sharedCache.js +48 -0
  983. package/dist/ui/data/sharedCache.js.map +1 -0
  984. package/dist/ui/data/useRequest.d.ts +19 -0
  985. package/dist/ui/data/useRequest.js +123 -0
  986. package/dist/ui/data/useRequest.js.map +1 -0
  987. package/dist/ui/data/useRequestScope.js +25 -0
  988. package/dist/ui/data/useRequestScope.js.map +1 -0
  989. package/dist/ui/hooks/useDirection.js +47 -0
  990. package/dist/ui/hooks/useDirection.js.map +1 -0
  991. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  992. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  993. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  994. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  995. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  996. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  997. package/dist/ui/readState.js +19 -0
  998. package/dist/ui/readState.js.map +1 -0
  999. package/dist/ui/rows/toDisplayRows.js +49 -0
  1000. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1001. package/dist/ui/viewerClock.js +7 -0
  1002. package/dist/ui/viewerClock.js.map +1 -0
  1003. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1004. package/dist/view/AnalyticsNavLink.js +12 -8
  1005. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1006. package/dist/view/AnalyticsView.d.ts +9 -10
  1007. package/dist/view/AnalyticsView.js +47 -19
  1008. package/dist/view/AnalyticsView.js.map +1 -1
  1009. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1010. package/dist/view/AnalyticsViewClient.js +15 -185
  1011. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1012. package/dist/view/CountryFlag.d.ts +27 -0
  1013. package/dist/view/CountryFlag.js +44 -0
  1014. package/dist/view/CountryFlag.js.map +1 -0
  1015. package/dist/view/DocumentTitle.js +27 -0
  1016. package/dist/view/DocumentTitle.js.map +1 -0
  1017. package/dist/view/ViewRoot.d.ts +21 -0
  1018. package/dist/view/ViewRoot.js +155 -0
  1019. package/dist/view/ViewRoot.js.map +1 -0
  1020. package/dist/view/ViewSections.d.ts +38 -0
  1021. package/dist/view/ViewSections.js +190 -0
  1022. package/dist/view/ViewSections.js.map +1 -0
  1023. package/dist/view/authRedirect.js +2 -4
  1024. package/dist/view/authRedirect.js.map +1 -1
  1025. package/dist/view/consentShare.js +15 -0
  1026. package/dist/view/consentShare.js.map +1 -0
  1027. package/dist/view/conversionRate.js +9 -7
  1028. package/dist/view/conversionRate.js.map +1 -1
  1029. package/dist/view/dayRange.js +6 -10
  1030. package/dist/view/dayRange.js.map +1 -1
  1031. package/dist/view/exclusionLink.d.ts +27 -0
  1032. package/dist/view/exclusionLink.js +46 -0
  1033. package/dist/view/exclusionLink.js.map +1 -0
  1034. package/dist/view/flagSrc.js +14 -0
  1035. package/dist/view/flagSrc.js.map +1 -0
  1036. package/dist/view/gating.d.ts +15 -1
  1037. package/dist/view/gating.js +67 -32
  1038. package/dist/view/gating.js.map +1 -1
  1039. package/dist/view/hostCountryFlag.js +41 -0
  1040. package/dist/view/hostCountryFlag.js.map +1 -0
  1041. package/dist/view/labels.js +113 -16
  1042. package/dist/view/labels.js.map +1 -1
  1043. package/dist/view/metricAliases.js +10 -0
  1044. package/dist/view/metricAliases.js.map +1 -0
  1045. package/dist/view/navLabel.js +15 -0
  1046. package/dist/view/navLabel.js.map +1 -0
  1047. package/dist/view/registerView.js +13 -11
  1048. package/dist/view/registerView.js.map +1 -1
  1049. package/dist/view/scopeLabel.js +21 -0
  1050. package/dist/view/scopeLabel.js.map +1 -0
  1051. package/dist/view/sections/Breakdowns.js +195 -132
  1052. package/dist/view/sections/Breakdowns.js.map +1 -1
  1053. package/dist/view/sections/EmptyStates.js +120 -32
  1054. package/dist/view/sections/EmptyStates.js.map +1 -1
  1055. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1056. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1057. package/dist/view/sections/FilterChips.js +127 -27
  1058. package/dist/view/sections/FilterChips.js.map +1 -1
  1059. package/dist/view/sections/GoalsPanel.js +68 -60
  1060. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1061. package/dist/view/sections/OverviewCards.js +42 -36
  1062. package/dist/view/sections/OverviewCards.js.map +1 -1
  1063. package/dist/view/sections/RealtimeStrip.js +70 -59
  1064. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1065. package/dist/view/sections/SectionBoundary.js +34 -0
  1066. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1067. package/dist/view/sections/Toolbar.d.ts +11 -0
  1068. package/dist/view/sections/Toolbar.js +181 -122
  1069. package/dist/view/sections/Toolbar.js.map +1 -1
  1070. package/dist/view/sections/Trend.js +176 -76
  1071. package/dist/view/sections/Trend.js.map +1 -1
  1072. package/dist/view/state.d.ts +42 -0
  1073. package/dist/view/state.js +93 -54
  1074. package/dist/view/state.js.map +1 -1
  1075. package/dist/view/useViewClock.js +31 -0
  1076. package/dist/view/useViewClock.js.map +1 -0
  1077. package/dist/view/useViewQueries.d.ts +21 -0
  1078. package/dist/view/useViewQueries.js +45 -77
  1079. package/dist/view/useViewQueries.js.map +1 -1
  1080. package/dist/view/useViewState.js +42 -0
  1081. package/dist/view/useViewState.js.map +1 -0
  1082. package/dist/view/useViewUrl.js +52 -0
  1083. package/dist/view/useViewUrl.js.map +1 -0
  1084. package/dist/view/viewBody.js +30 -0
  1085. package/dist/view/viewBody.js.map +1 -0
  1086. package/dist/view/viewContext.d.ts +81 -0
  1087. package/dist/view/viewContext.js +49 -0
  1088. package/dist/view/viewContext.js.map +1 -0
  1089. package/dist/view/viewProps.d.ts +65 -8
  1090. package/dist/view/viewProps.js +123 -36
  1091. package/dist/view/viewProps.js.map +1 -1
  1092. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1093. package/dist/widgets/AnalyticsBreakdownWidget.js +144 -118
  1094. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1095. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1096. package/dist/widgets/AnalyticsGoalsWidget.js +126 -167
  1097. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1098. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1099. package/dist/widgets/AnalyticsMetricWidget.js +81 -106
  1100. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1101. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1102. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -63
  1103. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1104. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1105. package/dist/widgets/AnalyticsTrendWidget.js +130 -123
  1106. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1107. package/dist/widgets/ComparisonDelta.js +33 -42
  1108. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1109. package/dist/widgets/RealtimeCounter.d.ts +24 -4
  1110. package/dist/widgets/RealtimeCounter.js +90 -71
  1111. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1112. package/dist/widgets/WidgetCard.d.ts +80 -0
  1113. package/dist/widgets/WidgetCard.js +99 -0
  1114. package/dist/widgets/WidgetCard.js.map +1 -0
  1115. package/dist/widgets/WidgetFrame.js +42 -0
  1116. package/dist/widgets/WidgetFrame.js.map +1 -0
  1117. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1118. package/dist/widgets/WidgetShimmer.js +86 -0
  1119. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1120. package/dist/widgets/breakdownTypes.js +18 -2
  1121. package/dist/widgets/breakdownTypes.js.map +1 -1
  1122. package/dist/widgets/customWidget.d.ts +5 -1
  1123. package/dist/widgets/customWidget.js +6 -7
  1124. package/dist/widgets/customWidget.js.map +1 -1
  1125. package/dist/widgets/defaultLayout.d.ts +26 -0
  1126. package/dist/widgets/defaultLayout.js +51 -0
  1127. package/dist/widgets/defaultLayout.js.map +1 -0
  1128. package/dist/widgets/defaults.d.ts +4 -7
  1129. package/dist/widgets/defaults.js +12 -7
  1130. package/dist/widgets/defaults.js.map +1 -1
  1131. package/dist/widgets/fieldRows.js +14 -0
  1132. package/dist/widgets/fieldRows.js.map +1 -0
  1133. package/dist/widgets/filterCaption.js +6 -7
  1134. package/dist/widgets/filterCaption.js.map +1 -1
  1135. package/dist/widgets/filterField.d.ts +3 -7
  1136. package/dist/widgets/filterField.js +46 -35
  1137. package/dist/widgets/filterField.js.map +1 -1
  1138. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1139. package/dist/widgets/filterValueLabel.js +45 -0
  1140. package/dist/widgets/filterValueLabel.js.map +1 -0
  1141. package/dist/widgets/notices.js +79 -0
  1142. package/dist/widgets/notices.js.map +1 -0
  1143. package/dist/widgets/prepareWidgetRead.d.ts +19 -2
  1144. package/dist/widgets/prepareWidgetRead.js +63 -27
  1145. package/dist/widgets/prepareWidgetRead.js.map +1 -1
  1146. package/dist/widgets/range.js +26 -21
  1147. package/dist/widgets/range.js.map +1 -1
  1148. package/dist/widgets/readForWidget.d.ts +28 -19
  1149. package/dist/widgets/readForWidget.js +33 -29
  1150. package/dist/widgets/readForWidget.js.map +1 -1
  1151. package/dist/widgets/readForWidgetBreakdown.d.ts +40 -29
  1152. package/dist/widgets/readForWidgetBreakdown.js +48 -22
  1153. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1154. package/dist/widgets/readForWidgetGoals.d.ts +18 -24
  1155. package/dist/widgets/readForWidgetGoals.js +52 -46
  1156. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1157. package/dist/widgets/readForWidgetRealtime.d.ts +22 -17
  1158. package/dist/widgets/readForWidgetRealtime.js +54 -27
  1159. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1160. package/dist/widgets/readForWidgetSeries.d.ts +27 -32
  1161. package/dist/widgets/readForWidgetSeries.js +45 -82
  1162. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1163. package/dist/widgets/readMeta.d.ts +48 -0
  1164. package/dist/widgets/readMeta.js +52 -4
  1165. package/dist/widgets/readMeta.js.map +1 -1
  1166. package/dist/widgets/realtimePoll.d.ts +1 -0
  1167. package/dist/widgets/realtimePoll.js +56 -16
  1168. package/dist/widgets/realtimePoll.js.map +1 -1
  1169. package/dist/widgets/registerWidgets.js +207 -127
  1170. package/dist/widgets/registerWidgets.js.map +1 -1
  1171. package/dist/widgets/stateKeys.js +30 -0
  1172. package/dist/widgets/stateKeys.js.map +1 -0
  1173. package/dist/widgets/titleForecast.js +89 -0
  1174. package/dist/widgets/titleForecast.js.map +1 -0
  1175. package/dist/widgets/types.d.ts +4 -3
  1176. package/dist/widgets/types.js +2 -0
  1177. package/dist/widgets/types.js.map +1 -1
  1178. package/dist/widgets/viewLink.d.ts +24 -6
  1179. package/dist/widgets/viewLink.js +31 -24
  1180. package/dist/widgets/viewLink.js.map +1 -1
  1181. package/dist/widgets/widgetData.js +34 -0
  1182. package/dist/widgets/widgetData.js.map +1 -0
  1183. package/dist/widgets/widgetWindow.d.ts +1 -0
  1184. package/dist/widgets/widgetWindow.js +51 -0
  1185. package/dist/widgets/widgetWindow.js.map +1 -0
  1186. package/package.json +61 -42
  1187. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1188. package/dist/capture/getTrackerConfig.js +0 -31
  1189. package/dist/capture/getTrackerConfig.js.map +0 -1
  1190. package/dist/capture/slots.d.ts +0 -8
  1191. package/dist/capture/trackerConfig.d.ts +0 -33
  1192. package/dist/charts/styles.js +0 -59
  1193. package/dist/charts/styles.js.map +0 -1
  1194. package/dist/exports/next.d.ts +0 -3
  1195. package/dist/exports/next.js +0 -3
  1196. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1197. package/dist/fields/dateRange/styles.js +0 -23
  1198. package/dist/fields/dateRange/styles.js.map +0 -1
  1199. package/dist/goals/GoalSelectField.d.ts +0 -7
  1200. package/dist/native/collections/events.js +0 -157
  1201. package/dist/native/collections/events.js.map +0 -1
  1202. package/dist/native/collections/rollups.js +0 -151
  1203. package/dist/native/collections/rollups.js.map +0 -1
  1204. package/dist/native/collections/seen.js +0 -47
  1205. package/dist/native/collections/seen.js.map +0 -1
  1206. package/dist/native/eventScan.js +0 -25
  1207. package/dist/native/eventScan.js.map +0 -1
  1208. package/dist/native/ingest/flushBatch.js +0 -60
  1209. package/dist/native/ingest/flushBatch.js.map +0 -1
  1210. package/dist/native/ingest/salt.js +0 -14
  1211. package/dist/native/ingest/salt.js.map +0 -1
  1212. package/dist/native/ingest/writeBuffer.js +0 -55
  1213. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1214. package/dist/native/ingest/writeEvent.js +0 -14
  1215. package/dist/native/ingest/writeEvent.js.map +0 -1
  1216. package/dist/native/query/eventAgg.js +0 -174
  1217. package/dist/native/query/eventAgg.js.map +0 -1
  1218. package/dist/native/realtime/buildRealtime.js +0 -53
  1219. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1220. package/dist/native/retention/pruneTask.js +0 -29
  1221. package/dist/native/retention/pruneTask.js.map +0 -1
  1222. package/dist/native/rollupAcc.js +0 -64
  1223. package/dist/native/rollupAcc.js.map +0 -1
  1224. package/dist/native/rollups/bucketKey.js +0 -15
  1225. package/dist/native/rollups/bucketKey.js.map +0 -1
  1226. package/dist/native/rollups/bumpRollups.js +0 -116
  1227. package/dist/native/rollups/bumpRollups.js.map +0 -1
  1228. package/dist/native/rollups/deltas.js +0 -105
  1229. package/dist/native/rollups/deltas.js.map +0 -1
  1230. package/dist/native/rollups/insertManyIfNew.js +0 -93
  1231. package/dist/native/rollups/insertManyIfNew.js.map +0 -1
  1232. package/dist/next/captureRewrites.d.ts +0 -42
  1233. package/dist/next/captureRewrites.js +0 -57
  1234. package/dist/next/captureRewrites.js.map +0 -1
  1235. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1236. package/dist/next/posthogProxyRewrites.js +0 -45
  1237. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1238. package/dist/plugin/paths.js +0 -27
  1239. package/dist/plugin/paths.js.map +0 -1
  1240. package/dist/plugin/responses.js +0 -17
  1241. package/dist/plugin/responses.js.map +0 -1
  1242. package/dist/query/errors.js +0 -10
  1243. package/dist/query/errors.js.map +0 -1
  1244. package/dist/react/TrackerBoot.d.ts +0 -22
  1245. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1246. package/dist/rsc/AnalyticsScripts.js +0 -41
  1247. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1248. package/dist/surfacing/queue.js +0 -60
  1249. package/dist/surfacing/queue.js.map +0 -1
  1250. package/dist/surfacing/retryPolicy.js +0 -15
  1251. package/dist/surfacing/retryPolicy.js.map +0 -1
  1252. package/dist/tracker/autoCapture.d.ts +0 -48
  1253. package/dist/tracker/consent.d.ts +0 -24
  1254. package/dist/tracker/consent.js +0 -48
  1255. package/dist/tracker/consent.js.map +0 -1
  1256. package/dist/tracker/loadScript.d.ts +0 -14
  1257. package/dist/tracker/pageTracking.d.ts +0 -17
  1258. package/dist/tracker/registry.d.ts +0 -27
  1259. package/dist/tracker/sinks/ga4.d.ts +0 -21
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -57
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routes.js","names":[],"sources":["../../src/plugin/routes.ts"],"sourcesContent":["/**\n * Every mount the plugin registers under `routes.api`, all off one base. Free of server code, so\n * client components and the browser tracker import it.\n */\n\nimport { isRecord } from '../core/values'\n\n/** A path under `routes.api`, with its leading slash and without a trailing one. */\nexport type RouteBase = `/${string}`\n\n/** Short, and no word an ad blocker's filter list would match. */\nexport const DEFAULT_ROUTE_BASE: RouteBase = '/_x'\n\n/**\n * The plugin's key in `config.custom`, which holds its server-only runtime factory, and in\n * `config.admin.custom`, which reaches the client config and carries the resolved base.\n */\nexport const ANALYTICS_CONFIG_KEY = '@10x-media/analytics'\n\nexport interface RoutePaths {\n\tbase: RouteBase\n\t/** Authenticated read over the surfacing engine. */\n\tquery: string\n\t/** Authenticated read behind a document's analytics panel. */\n\tdocument: string\n\t/** Authenticated list of the sources a request may read. */\n\tsources: string\n\t/** Authenticated goal list for the admin goal picker. */\n\tgoals: string\n\t/** Authenticated POST retiring a scope's cached reads. */\n\trefresh: string\n\t/** Authenticated realtime read the live counters poll. */\n\tlive: string\n\t/** Authenticated exclusion link for the selected scope; mounted while `capture.exclusion` is on. */\n\texclusion: string\n\t/** Public native ingest, and the default `native({ ingestPath })`. */\n\tingest: string\n\t/** Public tracker config. */\n\tconfig: string\n\t/** Mount of the public capture proxy; a slot answers under `${proxy}/<slot>`. */\n\tproxy: string\n\t/** The capture proxy's registered pattern. */\n\tproxyPattern: string\n\t/** Mount of the public flag route; one flag answers under `${flags}/<code>.svg`. */\n\tflags: string\n\t/** The flag route's registered pattern. */\n\tflagsPattern: string\n}\n\nexport const routePaths = (base: RouteBase): RoutePaths => ({\n\tbase,\n\tquery: `${base}/query`,\n\tdocument: `${base}/document`,\n\tsources: `${base}/sources`,\n\tgoals: `${base}/goals`,\n\trefresh: `${base}/refresh`,\n\tlive: `${base}/live`,\n\texclusion: `${base}/exclusion`,\n\tingest: `${base}/e`,\n\tconfig: `${base}/config`,\n\tproxy: `${base}/p`,\n\tproxyPattern: `${base}/p/:slot/:path*`,\n\tflags: `${base}/flags`,\n\tflagsPattern: `${base}/flags/:code`,\n})\n\n/** Plain segments of URL-safe characters, none starting with a dot. */\nconst BASE_PATTERN = /^(?:\\/[A-Za-z0-9_~-][A-Za-z0-9._~-]*)+$/\n\n/**\n * Payload strips a leading `/globals` from every API path before it routes, so a base starting\n * with it would be read as a global's route instead.\n */\nconst GLOBALS_PREFIX = '/globals'\n\n/**\n * Payload looks a request's first segment up on `payload.collections`, a plain object, so one of\n * `Object.prototype`'s keys finds something there and every request fails before any endpoint runs.\n */\nconst INHERITED_KEYS: ReadonlySet<string> = new Set(Object.getOwnPropertyNames(Object.prototype))\n\nconst firstSegment = (path: string): string => path.split('/')[1] ?? ''\n\nexport const isRouteBase = (value: unknown): value is RouteBase =>\n\ttypeof value === 'string' &&\n\tBASE_PATTERN.test(value) &&\n\t!value.startsWith(GLOBALS_PREFIX) &&\n\t!INHERITED_KEYS.has(firstSegment(value))\n\n/** A `routes.base` option checked for a path Payload can route, or the default when unset. */\nexport const resolveRouteBase = (value: unknown): RouteBase => {\n\tif (value === undefined) {\n\t\treturn DEFAULT_ROUTE_BASE\n\t}\n\tif (typeof value === 'string' && value.startsWith(GLOBALS_PREFIX)) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base \"${value}\" starts with \"${GLOBALS_PREFIX}\", which Payload routes to its globals; choose another first segment`\n\t\t)\n\t}\n\tif (typeof value === 'string' && INHERITED_KEYS.has(firstSegment(value))) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base \"${value}\" starts with \"${firstSegment(value)}\", a name every JavaScript object carries, which Payload would take for a collection; choose another first segment`\n\t\t)\n\t}\n\tif (!isRouteBase(value)) {\n\t\tthrow new Error(\n\t\t\t`analytics: routes.base must be a path of plain segments such as \"${DEFAULT_ROUTE_BASE}\" (letters, digits, \"-\", \"_\", \".\" and \"~\", no trailing slash), got ${typeof value === 'string' ? `\"${value}\"` : typeof value}`\n\t\t)\n\t}\n\treturn value\n}\n\n/** The base's first segment, which Payload compares against every collection slug. */\nexport const routeBaseSegment = (base: RouteBase): string => firstSegment(base)\n\n/**\n * The collection that would take every request under the base: Payload hands `<api>/<segment>/...`\n * to the collection slugged `<segment>` before it tries a root endpoint.\n */\nexport const shadowingCollection = (\n\tbase: RouteBase,\n\tslugs: Iterable<string>\n): string | undefined => {\n\tconst segment = routeBaseSegment(base)\n\tfor (const slug of slugs) {\n\t\tif (slug === segment) {\n\t\t\treturn slug\n\t\t}\n\t}\n\treturn undefined\n}\n\n/** Refuses a base some collection would shadow, naming that collection and the option to change. */\nexport const assertRouteBaseUnshadowed = (base: RouteBase, slugs: Iterable<string>): void => {\n\tconst slug = shadowingCollection(base, slugs)\n\tif (slug !== undefined) {\n\t\tthrow new Error(\n\t\t\t`analytics: the \"${slug}\" collection's slug is the first segment of routes.base \"${base}\", so Payload would hand every analytics request to that collection. Set routes.base to a path whose first segment is no collection's slug.`\n\t\t)\n\t}\n}\n\n/** What the plugin leaves under its key in `config.admin.custom`. */\nexport interface AnalyticsAdminCustom {\n\troutes: { base: RouteBase }\n}\n\n/** The slice of a root endpoint the route checks read. */\nexport interface RootEndpointShape {\n\tmethod: string\n\tpath: string\n\tcustom?: Record<string, unknown> | undefined\n}\n\n/**\n * The endpoint with the plugin's mark in its `custom`, which is how the route checks tell the\n * plugin's own root endpoints from those registered before it.\n */\nexport const pluginEndpoint = <T extends RootEndpointShape>(endpoint: T): T => ({\n\t...endpoint,\n\tcustom: { ...endpoint.custom, [ANALYTICS_CONFIG_KEY]: true },\n})\n\nexport const isPluginEndpoint = (endpoint: RootEndpointShape): boolean =>\n\tendpoint.custom?.[ANALYTICS_CONFIG_KEY] === true\n\n/** The slice of a Payload config, server or client, the base is read from. */\nexport interface RoutesConfigSource {\n\tadmin?: { custom?: Record<string, unknown> } | undefined\n}\n\n/**\n * The mounts one Payload config resolved, read from `config.admin.custom` by server and client\n * code alike. A config the plugin never touched answers the default base.\n */\nexport const analyticsRoutes = (config: RoutesConfigSource | null | undefined): RoutePaths => {\n\tconst entry = config?.admin?.custom?.[ANALYTICS_CONFIG_KEY]\n\tconst routes = isRecord(entry) ? entry.routes : undefined\n\tconst base = isRecord(routes) ? routes.base : undefined\n\treturn routePaths(isRouteBase(base) ? base : DEFAULT_ROUTE_BASE)\n}\n"],"mappings":";;;;;;;AAWA,MAAa,qBAAgC;;;;;AAM7C,MAAa,uBAAuB;AAgCpC,MAAa,cAAc,UAAiC;CAC3D;CACA,OAAO,GAAG,KAAK;CACf,UAAU,GAAG,KAAK;CAClB,SAAS,GAAG,KAAK;CACjB,OAAO,GAAG,KAAK;CACf,SAAS,GAAG,KAAK;CACjB,MAAM,GAAG,KAAK;CACd,WAAW,GAAG,KAAK;CACnB,QAAQ,GAAG,KAAK;CAChB,QAAQ,GAAG,KAAK;CAChB,OAAO,GAAG,KAAK;CACf,cAAc,GAAG,KAAK;CACtB,OAAO,GAAG,KAAK;CACf,cAAc,GAAG,KAAK;AACvB;;AAGA,MAAM,eAAe;;;;;AAMrB,MAAM,iBAAiB;;;;;AAMvB,MAAM,iBAAsC,IAAI,IAAI,OAAO,oBAAoB,OAAO,SAAS,CAAC;AAEhG,MAAM,gBAAgB,SAAyB,KAAK,MAAM,GAAG,EAAE,MAAM;AAErE,MAAa,eAAe,UAC3B,OAAO,UAAU,YACjB,aAAa,KAAK,KAAK,KACvB,CAAC,MAAM,WAAW,cAAc,KAChC,CAAC,eAAe,IAAI,aAAa,KAAK,CAAC;;AAGxC,MAAa,oBAAoB,UAA8B;CAC9D,IAAI,UAAU,KAAA,GACb,OAAA;CAED,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,cAAc,GAC/D,MAAM,IAAI,MACT,2BAA2B,MAAM,iBAAiB,eAAe,qEAClE;CAED,IAAI,OAAO,UAAU,YAAY,eAAe,IAAI,aAAa,KAAK,CAAC,GACtE,MAAM,IAAI,MACT,2BAA2B,MAAM,iBAAiB,aAAa,KAAK,EAAE,mHACvE;CAED,IAAI,CAAC,YAAY,KAAK,GACrB,MAAM,IAAI,MACT,0IAA4J,OAAO,UAAU,WAAW,IAAI,MAAM,KAAK,OAAO,OAC/M;CAED,OAAO;AACR;;AAGA,MAAa,oBAAoB,SAA4B,aAAa,IAAI;;;;;AAM9E,MAAa,uBACZ,MACA,UACwB;CACxB,MAAM,UAAU,iBAAiB,IAAI;CACrC,KAAK,MAAM,QAAQ,OAClB,IAAI,SAAS,SACZ,OAAO;AAIV;;AAGA,MAAa,6BAA6B,MAAiB,UAAkC;CAC5F,MAAM,OAAO,oBAAoB,MAAM,KAAK;CAC5C,IAAI,SAAS,KAAA,GACZ,MAAM,IAAI,MACT,mBAAmB,KAAK,2DAA2D,KAAK,4IACzF;AAEF;;;;;AAkBA,MAAa,kBAA+C,cAAoB;CAC/E,GAAG;CACH,QAAQ;EAAE,GAAG,SAAS;GAAS,uBAAuB;CAAK;AAC5D;AAEA,MAAa,oBAAoB,aAChC,SAAS,SAAS,0BAA0B;;;;;AAW7C,MAAa,mBAAmB,WAA8D;CAC7F,MAAM,QAAQ,QAAQ,OAAO,SAAS;CACtC,MAAM,SAAS,SAAS,KAAK,IAAI,MAAM,SAAS,KAAA;CAChD,MAAM,OAAO,SAAS,MAAM,IAAI,OAAO,OAAO,KAAA;CAC9C,OAAO,WAAW,YAAY,IAAI,IAAI,OAAA,KAAyB;AAChE"}
@@ -1 +1 @@
1
- import { Payload, PayloadRequest } from "payload";
1
+ import { Access, Payload, PayloadRequest } from "payload";
@@ -1,51 +1,257 @@
1
+ import { captureRequest } from "../capture/captureRequest.js";
2
+ import { isAdminUser } from "../access/adminUser.js";
3
+ import { requestMemo } from "./requestMemo.js";
4
+ import { decideOnce } from "../access/decideOnce.js";
1
5
  import "../core/contract.js";
6
+ import { isRecord } from "../core/values.js";
7
+ import { NO_GRANTS } from "../core/registry.js";
8
+ import { epochsFor } from "../surfacing/epoch.js";
9
+ import { onDestroy } from "./destroy.js";
10
+ import { ANALYTICS_CONFIG_KEY } from "./routes.js";
2
11
  //#region src/plugin/runtime.ts
12
+ const isRuntimeFactory = (value) => isRecord(value) && typeof value.create === "function" && typeof value.validate === "function";
13
+ /** The factory a config carries, absent wherever the plugin is not installed or is disabled. */
14
+ const runtimeFactoryOf = (config) => {
15
+ const factory = config?.custom?.[ANALYTICS_CONFIG_KEY];
16
+ return isRuntimeFactory(factory) ? factory : void 0;
17
+ };
3
18
  /**
4
- * Stored on the Payload instance (not a module global) so the runtime survives the
5
- * separate `.` and `/rsc` bundles a consumer loads: a server-component bundle that
6
- * imported its own copy of a module-level map would never see what the plugin wrote.
7
- * `Symbol.for` keys into the cross-realm global symbol registry, so both bundles
8
- * resolve the same key on the same `payload` object.
19
+ * Stored on the Payload instance (not a module global) so the runtime survives the separate `.`
20
+ * and `/rsc` bundles a consumer loads; `Symbol.for` resolves the same key in both.
9
21
  */
10
22
  const RUNTIME_KEY = Symbol.for("@10x-media/analytics/runtime");
11
- const setRuntime = (payload, runtime) => {
12
- payload[RUNTIME_KEY] = runtime;
23
+ /** Runtimes replaced on this instance whose adapters are still waiting out their grace period. */
24
+ const RETIRING_KEY = Symbol.for("@10x-media/analytics/retiring");
25
+ /** How long a replaced runtime keeps serving the requests that already hold it. */
26
+ const RUNTIME_RETIRE_GRACE_MS = 3e4;
27
+ const isRuntimeSlot = (value) => isRecord(value) && "config" in value && "runtime" in value;
28
+ const slotOf = (payload) => {
29
+ const slot = Reflect.get(payload, RUNTIME_KEY);
30
+ return isRuntimeSlot(slot) ? slot : void 0;
31
+ };
32
+ const retiringOf = (payload) => {
33
+ const existing = Reflect.get(payload, RETIRING_KEY);
34
+ if (existing instanceof Set) return existing;
35
+ const created = /* @__PURE__ */ new Set();
36
+ Reflect.set(payload, RETIRING_KEY, created);
37
+ return created;
38
+ };
39
+ /** Runs one close, warning rather than throwing so the closes beside it still run. */
40
+ const closeOrWarn = async (payload, what, close) => {
41
+ try {
42
+ await close();
43
+ } catch (err) {
44
+ payload.logger?.warn(`analytics: closing ${what} failed: ${String(err)}`);
45
+ }
13
46
  };
14
- const getRuntime = (payload) => payload[RUNTIME_KEY];
15
- const resolveScopeFor = (runtime, req) => runtime.resolveScope?.(req) ?? Promise.resolve(null);
16
- const resolveTimezoneFor = (runtime, req, scope) => runtime.resolveTimezone?.(req, scope) ?? Promise.resolve("UTC");
17
47
  /**
18
- * The reporting timezone of a request, resolving its scope first and falling back to UTC
19
- * when the plugin is not booted or resolution throws. Callers that must interpret a
20
- * client-supplied or stored calendar day before the read begins use this; a read path
21
- * already holding a resolved scope calls {@link resolveTimezoneFor} directly.
48
+ * After the grace period, closes the retired runtime's resources and every adapter it attached that
49
+ * its successor no longer uses: a shared adapter keeps its buffer and clients.
50
+ */
51
+ const retire = (payload, retired, successor) => {
52
+ const kept = new Set(successor?.adapters ?? []);
53
+ const closing = (retired?.adapters ?? []).filter((adapter) => !kept.has(adapter));
54
+ const closeRuntime = retired?.close;
55
+ if (closing.length === 0 && !closeRuntime) return;
56
+ const pending = retiringOf(payload);
57
+ let timer;
58
+ let done;
59
+ const entry = { run: () => {
60
+ done ??= (async () => {
61
+ clearTimeout(timer);
62
+ pending.delete(entry);
63
+ await Promise.all([closeOrWarn(payload, "a replaced runtime's connections", () => closeRuntime?.()), ...closing.map((adapter) => closeOrWarn(payload, `the "${adapter.id}" adapter of a replaced runtime`, () => adapter.close?.(payload)))]);
64
+ })();
65
+ return done;
66
+ } };
67
+ pending.add(entry);
68
+ timer = setTimeout(() => void entry.run(), RUNTIME_RETIRE_GRACE_MS);
69
+ timer.unref?.();
70
+ };
71
+ /** Closes the instance's runtime and every runtime it replaced, at once: the instance is going away. */
72
+ const closeRuntimes = async (payload) => {
73
+ const slot = slotOf(payload);
74
+ if (slot?.runtime) retire(payload, slot.runtime, void 0);
75
+ await settleRetiredRuntimes(payload);
76
+ };
77
+ /**
78
+ * An instance's runtime, built on first use and rebuilt when `payload.config` changes identity (HMR
79
+ * `reload`); undefined without the plugin. Building one makes `payload.destroy()` close it.
80
+ */
81
+ const getRuntime = (payload) => {
82
+ const slot = slotOf(payload);
83
+ if (slot && slot.config === payload.config) return slot.runtime;
84
+ const runtime = runtimeFactoryOf(payload.config)?.create(payload);
85
+ Reflect.set(payload, RUNTIME_KEY, {
86
+ config: payload.config,
87
+ runtime
88
+ });
89
+ if (slot) retire(payload, slot.runtime, runtime);
90
+ if (runtime) onDestroy(payload, () => closeRuntimes(payload));
91
+ return runtime;
92
+ };
93
+ /** The runtime already built for the instance's current config; unlike `getRuntime`, never builds one. */
94
+ const builtRuntime = (payload) => {
95
+ const slot = slotOf(payload);
96
+ return slot && slot.config === payload.config ? slot.runtime : void 0;
97
+ };
98
+ /** Closes every replaced runtime's adapters now rather than after the grace period. */
99
+ const settleRetiredRuntimes = async (payload) => {
100
+ await Promise.all([...retiringOf(payload)].map((entry) => entry.run()));
101
+ };
102
+ const scopes = requestMemo("scopeResolutions");
103
+ const timezones = requestMemo("timezoneResolutions");
104
+ const currencies = requestMemo("currencyResolutions");
105
+ /** A memo key per scope argument, where absent (the request's own scope) and null differ. */
106
+ const scopeKey = (scope) => scope === void 0 ? "own" : JSON.stringify(scope);
107
+ /**
108
+ * The scope a per-scope resolver answers for: no timezone, currency, goal or source belongs to the
109
+ * cross-scope marker, so it reads as install-wide.
110
+ */
111
+ const resolvableScope = (scope) => scope === "*" ? null : scope;
112
+ /**
113
+ * The scope a signed-in reader's or editor's request selected: the `admin` call site, asked of
114
+ * the host's resolver once per request and user however many reads ask.
115
+ */
116
+ const resolveScopeFor = (runtime, req) => {
117
+ const resolve = runtime.resolveScope;
118
+ if (!resolve) return Promise.resolve(null);
119
+ return scopes(req, {
120
+ owner: runtime,
121
+ key: "admin",
122
+ compute: async () => {
123
+ try {
124
+ return await resolve(req, "admin");
125
+ } catch (err) {
126
+ req.payload?.logger?.warn?.(`analytics: scope resolution failed: ${String(err)}`);
127
+ throw err;
128
+ }
129
+ }
130
+ });
131
+ };
132
+ /**
133
+ * A visitor hit's scope, asked via {@link captureRequest} so no user, cookie or auth header reaches
134
+ * the resolver: an editor's beacon files under the site, not their admin tenant.
135
+ */
136
+ const resolveCaptureScopeFor = (runtime, req) => runtime.resolveScope?.(captureRequest(req), "capture") ?? Promise.resolve(null);
137
+ /** The scope's reporting timezone, asked of the host's resolver once per request, scope and user. */
138
+ const resolveTimezoneFor = (runtime, req, scope) => {
139
+ const resolve = runtime.resolveTimezone;
140
+ return resolve ? timezones(req, {
141
+ owner: runtime,
142
+ key: scopeKey(scope),
143
+ compute: () => resolve(req, scope)
144
+ }) : Promise.resolve("UTC");
145
+ };
146
+ /** The scope's reporting currency, asked of the host's resolver once per request, scope and user. */
147
+ const resolveCurrencyFor = (runtime, req, scope) => {
148
+ const resolve = runtime.resolveCurrency;
149
+ return resolve ? currencies(req, {
150
+ owner: runtime,
151
+ key: scopeKey(scope),
152
+ compute: () => resolve(req, scope)
153
+ }) : Promise.resolve(void 0);
154
+ };
155
+ /**
156
+ * Like {@link resolveTimezoneFor} but resolving the request's scope first, for calendar days read
157
+ * before a read begins. UTC without the plugin or when resolution throws.
22
158
  */
23
159
  const requestTimezone = async (req) => {
24
160
  const runtime = getRuntime(req.payload);
25
161
  if (!runtime) return "UTC";
26
162
  try {
27
- const scope = await resolveScopeFor(runtime, req);
28
- return await resolveTimezoneFor(runtime, req, scope === "*" ? null : scope);
163
+ return await resolveTimezoneFor(runtime, req, resolvableScope(await resolveScopeFor(runtime, req)));
29
164
  } catch {
30
165
  return "UTC";
31
166
  }
32
167
  };
33
- const resolveRegistryFor = (runtime, args) => runtime.resolveRegistry?.(args) ?? Promise.resolve(runtime.registry);
168
+ /**
169
+ * A request's reporting currency, resolving its scope first. Undefined without the plugin, without
170
+ * a configured currency, or when resolution throws: revenue then renders as a plain number.
171
+ */
172
+ const requestCurrency = async (req) => {
173
+ const runtime = getRuntime(req.payload);
174
+ if (!runtime?.resolveCurrency) return;
175
+ try {
176
+ return await resolveCurrencyFor(runtime, req, resolvableScope(await resolveScopeFor(runtime, req)));
177
+ } catch {
178
+ return;
179
+ }
180
+ };
181
+ /** The scope's refresh epoch token, the initial one wherever the runtime carries no store. */
182
+ const cacheEpochFor = (runtime, scope) => runtime.epoch?.get(scope) ?? Promise.resolve("0");
183
+ /** Both epochs the scope's cache keys carry, for a read that builds its own key. */
184
+ const cacheEpochsFor = (runtime, scope) => epochsFor({
185
+ ...runtime.epoch ? { refresh: runtime.epoch } : {},
186
+ ...runtime.configEpoch ? { config: runtime.configEpoch } : {}
187
+ }, scope);
188
+ /** The scope's adapter registry; without a per-scope resolver, the config one and no grants. */
189
+ const resolveRegistryFor = (runtime, args) => runtime.resolveRegistry?.(args) ?? Promise.resolve({
190
+ registry: runtime.registry,
191
+ grants: NO_GRANTS
192
+ });
193
+ /** The scope's goals: config goals merged with the goals collection, where the runtime can. */
34
194
  const resolveGoalsFor = (runtime, req, scope) => runtime.resolveGoals?.(req, scope) ?? Promise.resolve(runtime.goals ?? []);
35
- const resolveGoalsDetailedFor = (runtime, req, scope) => runtime.resolveGoalsDetailed?.(req, scope) ?? Promise.resolve((runtime.goals ?? []).map((goal) => ({
36
- goal,
37
- source: "config"
38
- })));
39
- const readAccessFor = async (runtime, req) => runtime.readAccess ? await runtime.readAccess({ req }) : Boolean(req.user);
40
- const platformReadFor = async (runtime, req) => runtime.platformRead ? await runtime.platformRead({ req }) : Boolean(req.user);
41
- const platformReadGate = (runtime, req) => {
42
- let pending;
43
- return () => {
44
- pending ??= platformReadFor(runtime, req);
45
- return pending;
195
+ /**
196
+ * {@link resolveGoalsFor}'s goals, each tagged with its origin. Falls back to the untagged
197
+ * resolver, not the static config list, so the two never disagree.
198
+ */
199
+ const resolveGoalsDetailedFor = async (runtime, req, scope) => {
200
+ if (runtime.resolveGoalsDetailed) return runtime.resolveGoalsDetailed(req, scope);
201
+ return (runtime.resolveGoals ? await runtime.resolveGoals(req, scope) : runtime.goals ?? []).map((goal) => ({
202
+ goal,
203
+ source: "config"
204
+ }));
205
+ };
206
+ /**
207
+ * Whether a read in `scope` spans every scope: the aggregate, or the install-wide read a scoped
208
+ * install answers a platform reader who selected no tenant.
209
+ */
210
+ const readsAcrossScopes = (runtime, scope) => scope === "*" || (scope ?? null) === null && runtime.scoped === true;
211
+ /**
212
+ * Names a report in `scope` lists goal rows by. A cross-scope report draws on every scope the
213
+ * reader may see, so a foreign goal reads by name; unnamed goals read as slugs.
214
+ */
215
+ const goalNamesFor = async (args) => {
216
+ const { runtime, req, scope, resolved } = args;
217
+ const own = resolved ?? await resolveGoalsDetailedFor(runtime, req, resolvableScope(scope));
218
+ if (!readsAcrossScopes(runtime, scope) || !runtime.listGoalsAcross) return own.map(({ goal }) => ({
219
+ slug: goal.slug,
220
+ name: goal.name
221
+ }));
222
+ const across = await runtime.listGoalsAcross(req);
223
+ const names = new Map(own.map(({ goal }) => [goal.slug, goal.name]));
224
+ for (const { goal } of across) if (!names.has(goal.slug)) names.set(goal.slug, goal.name);
225
+ return [...names].map(([slug, name]) => ({
226
+ slug,
227
+ name
228
+ }));
229
+ };
230
+ /**
231
+ * The request's {@link ScopeGates}; a gate `access.crossScope` leaves unset admits the users of the
232
+ * admin collection.
233
+ */
234
+ const scopeGates = (runtime, req) => {
235
+ const gate = (decision) => (ctx = {}) => {
236
+ const { scope, adapterId } = ctx;
237
+ const args = {
238
+ req,
239
+ ...scope === void 0 ? {} : { scope },
240
+ ...adapterId === void 0 ? {} : { adapterId }
241
+ };
242
+ return decideOnce(req, {
243
+ owner: runtime,
244
+ key: `crossScope:${decision}:${JSON.stringify(scope)}:${adapterId ?? ""}`,
245
+ decide: () => runtime.crossScope?.[decision]?.(args) ?? isAdminUser({ req })
246
+ });
247
+ };
248
+ return {
249
+ named: gate("named"),
250
+ aggregate: gate("aggregate"),
251
+ unscopedSource: gate("unscopedSource")
46
252
  };
47
253
  };
48
254
  //#endregion
49
- export { getRuntime, platformReadFor, platformReadGate, readAccessFor, requestTimezone, resolveGoalsDetailedFor, resolveGoalsFor, resolveRegistryFor, resolveScopeFor, resolveTimezoneFor, setRuntime };
255
+ export { builtRuntime, cacheEpochFor, cacheEpochsFor, getRuntime, goalNamesFor, requestCurrency, requestTimezone, resolvableScope, resolveCaptureScopeFor, resolveCurrencyFor, resolveGoalsDetailedFor, resolveGoalsFor, resolveRegistryFor, resolveScopeFor, resolveTimezoneFor, runtimeFactoryOf, scopeGates };
50
256
 
51
257
  //# sourceMappingURL=runtime.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"runtime.js","names":[],"sources":["../../src/plugin/runtime.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { ResolvedBinding } from '../binding/types'\nimport { PLATFORM_SCOPE } from '../core/contract'\nimport type { CaptureSlotOption, ConsentPolicy, ResolvedAutoCapture } from '../core/options'\nimport type { AdapterRegistry, RegistryResolver, ResolveRegistryArgs } from '../core/registry'\nimport type { ServerTrack } from '../core/serverEvent'\nimport type { GoalsResolver, ResolvedGoal } from '../goals/resolver'\nimport type { Goal } from '../goals/types'\nimport type { Engine } from '../surfacing/engine'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\nexport interface AnalyticsRuntime {\n\tregistry: AdapterRegistry\n\t/** Per-scope adapter resolution; absent runtimes fall back to the static registry. */\n\tresolveRegistry?: RegistryResolver\n\t/** The plugin's scopeResolver bound at init; absent runtimes resolve null. */\n\tresolveScope?: (req: PayloadRequest) => Promise<string | null>\n\t/** The plugin's reportingTimezone bound at init; absent runtimes resolve 'UTC'. */\n\tresolveTimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/** Id of the config adapter shared by every scope, when one is designated. */\n\tplatformAdapterId?: string\n\t/** `capture.slots` overrides naming the adapter that fills each capture slot. */\n\tcaptureSlots?: { global?: CaptureSlotOption; tenant?: CaptureSlotOption }\n\t/**\n\t * `capture.paths` overrides for a slot's mount. Unset, the tracker config derives the\n\t * runtime proxy mount; set when the slot is served through Next rewrites instead.\n\t */\n\tcapturePaths?: { global?: string; tenant?: string }\n\t/**\n\t * Whether a slot's tracker waits for consent, evaluated per request-resolved adapter.\n\t * Absent runtimes fall back to the default: no gate for native, one for a vendor.\n\t */\n\tconsentFor?: ConsentPolicy\n\t/** Browser auto-capture toggles handed to the tracker; absent runtimes default all on. */\n\tautoCapture?: ResolvedAutoCapture\n\t/** Config goals, and the fallback wherever the merged resolution is unavailable. */\n\tgoals?: Goal[]\n\t/**\n\t * Config goals merged with the goals collection for a request's scope. Absent runtimes\n\t * fall back to `goals`.\n\t */\n\tresolveGoals?: GoalsResolver['resolve']\n\t/** The same merge, each goal tagged with where it came from. */\n\tresolveGoalsDetailed?: GoalsResolver['resolveDetailed']\n\t/** Slug of the goals collection when the install enabled it; the picker links to it. */\n\tgoalsCollectionSlug?: string\n\t/**\n\t * Records an event from server code, through whichever registered adapter accepts\n\t * server events. Rejects with an `AnalyticsTrackError` when none does.\n\t */\n\ttrack?: ServerTrack\n\t/**\n\t * Where the ingest endpoint listens, relative to `routes.api`, lifted at init from the\n\t * adapter that registered one. Absent runtimes fall back to the default mount.\n\t */\n\tingestPath?: string\n\t/**\n\t * `capture.proxy` limits for the runtime capture proxy. Deliberately separate from\n\t * `cache.timeoutMs`: that is a per-read provider deadline for authenticated dashboard\n\t * queries, this is a public request path with entirely different traffic.\n\t */\n\tcaptureProxy?: { timeoutMs: number; maxBodyBytes: number }\n\t/** True when the app configured a scopeResolver (scoped install); mirrors `resolved.scoped`. */\n\tscoped?: boolean\n\t/**\n\t * Ids of the config-time adapters shared by every scope (the ones passed to\n\t * `adapters` in plugin options). Runtime provider adapters (resolved per scope\n\t * from the providers collection or `providers.resolve`) are never in it.\n\t */\n\tconfigAdapterIds: ReadonlySet<string>\n\t/** Gate for cross-scope reads; absent runtimes require an authenticated user. */\n\tplatformRead?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\t/** Gate for the query endpoint; absent runtimes require an authenticated user. */\n\treadAccess?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\tbindings: Record<string, ResolvedBinding>\n\tengine: Engine\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/** Widget period-over-period comparison; false skips the previous-window read. */\n\tcomparison: boolean\n}\n\n/**\n * Stored on the Payload instance (not a module global) so the runtime survives the\n * separate `.` and `/rsc` bundles a consumer loads: a server-component bundle that\n * imported its own copy of a module-level map would never see what the plugin wrote.\n * `Symbol.for` keys into the cross-realm global symbol registry, so both bundles\n * resolve the same key on the same `payload` object.\n */\nconst RUNTIME_KEY = Symbol.for('@10x-media/analytics/runtime')\n\ntype RuntimeHost = { [RUNTIME_KEY]?: AnalyticsRuntime }\n\nexport const setRuntime = (payload: Payload, runtime: AnalyticsRuntime): void => {\n\t;(payload as unknown as RuntimeHost)[RUNTIME_KEY] = runtime\n}\n\nexport const getRuntime = (payload: Payload): AnalyticsRuntime | undefined =>\n\t(payload as unknown as RuntimeHost)[RUNTIME_KEY]\n\nexport const resolveScopeFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<string | null> => runtime.resolveScope?.(req) ?? Promise.resolve(null)\n\nexport const resolveTimezoneFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<string> => runtime.resolveTimezone?.(req, scope) ?? Promise.resolve(DEFAULT_TIMEZONE)\n\n/**\n * The reporting timezone of a request, resolving its scope first and falling back to UTC\n * when the plugin is not booted or resolution throws. Callers that must interpret a\n * client-supplied or stored calendar day before the read begins use this; a read path\n * already holding a resolved scope calls {@link resolveTimezoneFor} directly.\n */\nexport const requestTimezone = async (req: PayloadRequest): Promise<string> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn DEFAULT_TIMEZONE\n\t}\n\ttry {\n\t\t// The cross-scope marker is not a scope a reporting timezone can be resolved for;\n\t\t// `resolveReadContext` narrows it to null the same way.\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\treturn await resolveTimezoneFor(runtime, req, scope === PLATFORM_SCOPE ? null : scope)\n\t} catch {\n\t\treturn DEFAULT_TIMEZONE\n\t}\n}\n\nexport const resolveRegistryFor = (\n\truntime: AnalyticsRuntime,\n\targs: ResolveRegistryArgs\n): Promise<AdapterRegistry> => runtime.resolveRegistry?.(args) ?? Promise.resolve(runtime.registry)\n\nexport const resolveGoalsFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<Goal[]> => runtime.resolveGoals?.(req, scope) ?? Promise.resolve(runtime.goals ?? [])\n\nexport const resolveGoalsDetailedFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<ResolvedGoal[]> =>\n\truntime.resolveGoalsDetailed?.(req, scope) ??\n\tPromise.resolve((runtime.goals ?? []).map((goal) => ({ goal, source: 'config' as const })))\n\nexport const readAccessFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<boolean> => (runtime.readAccess ? await runtime.readAccess({ req }) : Boolean(req.user))\n\nexport const platformReadFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<boolean> =>\n\truntime.platformRead ? await runtime.platformRead({ req }) : Boolean(req.user)\n\n/** A `platformRead` decision evaluated at most once, however many gates consult it. */\nexport type PlatformReadGate = () => Promise<boolean>\n\nexport const platformReadGate = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): PlatformReadGate => {\n\tlet pending: Promise<boolean> | undefined\n\treturn () => {\n\t\tpending ??= platformReadFor(runtime, req)\n\t\treturn pending\n\t}\n}\n"],"mappings":";;;;;;;;;AAyFA,MAAM,cAAc,OAAO,IAAI,8BAA8B;AAI7D,MAAa,cAAc,SAAkB,YAAoC;CAC/E,QAAoC,eAAe;AACrD;AAEA,MAAa,cAAc,YACzB,QAAmC;AAErC,MAAa,mBACZ,SACA,QAC4B,QAAQ,eAAe,GAAG,KAAK,QAAQ,QAAQ,IAAI;AAEhF,MAAa,sBACZ,SACA,KACA,UACqB,QAAQ,kBAAkB,KAAK,KAAK,KAAK,QAAQ,QAAA,KAAwB;;;;;;;AAQ/F,MAAa,kBAAkB,OAAO,QAAyC;CAC9E,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAA;CAED,IAAI;EAGH,MAAM,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EAChD,OAAO,MAAM,mBAAmB,SAAS,KAAK,UAAA,MAA2B,OAAO,KAAK;CACtF,QAAQ;EACP,OAAA;CACD;AACD;AAEA,MAAa,sBACZ,SACA,SAC8B,QAAQ,kBAAkB,IAAI,KAAK,QAAQ,QAAQ,QAAQ,QAAQ;AAElG,MAAa,mBACZ,SACA,KACA,UACqB,QAAQ,eAAe,KAAK,KAAK,KAAK,QAAQ,QAAQ,QAAQ,SAAS,CAAC,CAAC;AAE/F,MAAa,2BACZ,SACA,KACA,UAEA,QAAQ,uBAAuB,KAAK,KAAK,KACzC,QAAQ,SAAS,QAAQ,SAAS,CAAC,GAAG,KAAK,UAAU;CAAE;CAAM,QAAQ;AAAkB,EAAE,CAAC;AAE3F,MAAa,gBAAgB,OAC5B,SACA,QACuB,QAAQ,aAAa,MAAM,QAAQ,WAAW,EAAE,IAAI,CAAC,IAAI,QAAQ,IAAI,IAAI;AAEjG,MAAa,kBAAkB,OAC9B,SACA,QAEA,QAAQ,eAAe,MAAM,QAAQ,aAAa,EAAE,IAAI,CAAC,IAAI,QAAQ,IAAI,IAAI;AAK9E,MAAa,oBACZ,SACA,QACsB;CACtB,IAAI;CACJ,aAAa;EACZ,YAAY,gBAAgB,SAAS,GAAG;EACxC,OAAO;CACR;AACD"}
1
+ {"version":3,"file":"runtime.js","names":[],"sources":["../../src/plugin/runtime.ts"],"sourcesContent":["import type { Access, Payload, PayloadRequest } from 'payload'\nimport { isAdminUser } from '../access/adminUser'\nimport { decideOnce } from '../access/decideOnce'\nimport type { ResolvedBinding } from '../binding/types'\nimport { captureRequest } from '../capture/captureRequest'\nimport type { CacheKeyEpochs } from '../core/cacheKey'\nimport { type AnalyticsAdapter, type AnalyticsResult, PLATFORM_SCOPE } from '../core/contract'\nimport type { FetchLike } from '../core/fetch'\nimport type {\n\tAnalyticsCountryFlags,\n\tCaptureGatePolicy,\n\tCaptureSlotOption,\n\tCrossScopeAccess,\n\tResolvedExclusion,\n\tResolvedOptions,\n\tResolvedWithoutConsent,\n\tScopeCallSite,\n\tScopeLabelResolver,\n\tScopeListResolver,\n\tScopeMemberAccess,\n} from '../core/options'\nimport {\n\ttype AdapterRegistry,\n\tNO_GRANTS,\n\ttype RegistryResolver,\n\ttype ResolveRegistryArgs,\n\ttype ScopeRegistry,\n} from '../core/registry'\nimport type { ServerEventInput, ServerTrackOptions } from '../core/serverEvent'\nimport type { DefaultSourceRule, ResolvedSources } from '../core/sourcePolicy'\nimport { isRecord } from '../core/values'\nimport type { GoalsResolver, ResolvedGoal } from '../goals/resolver'\nimport type { Goal } from '../goals/types'\nimport type { TrustedPlatform } from '../net/platform'\nimport type { CacheStore } from '../surfacing/cacheStore'\nimport type { CacheSweeper } from '../surfacing/cacheSweep'\nimport type { Engine } from '../surfacing/engine'\nimport { type EpochStore, epochsFor, INITIAL_EPOCH } from '../surfacing/epoch'\nimport type { Memo } from '../surfacing/memo'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport type { ResolvedAutoCapture, TrackerSkip } from '../tracker/config'\nimport { onDestroy } from './destroy'\nimport { requestMemo } from './requestMemo'\nimport { ANALYTICS_CONFIG_KEY } from './routes'\n\nexport interface AnalyticsRuntime {\n\tregistry: AdapterRegistry\n\t/** Per-scope adapter resolution; absent runtimes fall back to the static registry. */\n\tresolveRegistry?: RegistryResolver\n\t/**\n\t * Never call directly: ask {@link resolveScopeFor} or {@link resolveCaptureScopeFor}, whose\n\t * capture path strips the visitor's identity first. Absent resolves null.\n\t */\n\tresolveScope?: (req: PayloadRequest, callSite: ScopeCallSite) => Promise<string | null>\n\t/**\n\t * `scope.member`, set exactly when the install is scoped. A runtime without one admits nobody\n\t * to a tenant scope they did not reach through `access.crossScope`.\n\t */\n\tmember?: ScopeMemberAccess\n\t/** The plugin's reportingTimezone as a resolver; absent runtimes resolve 'UTC'. */\n\tresolveTimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/**\n\t * The plugin's `revenue.currency` as a resolver; absent runtimes and installs that set\n\t * none resolve undefined, and revenue then renders as a plain number.\n\t */\n\tresolveCurrency?: (req: PayloadRequest, scope?: string | null) => Promise<string | undefined>\n\t/** Id of the config adapter shared by every scope, when one is designated. */\n\tplatformAdapterId?: string\n\t/**\n\t * `sources`: each shared config adapter whose tenants read under a policy other than `staff`.\n\t * Absent runtimes admit tenants to no shared adapter beyond `unscopedSource`.\n\t */\n\tsourcePolicies?: ResolvedSources['policies']\n\t/** `defaultSource`: how a tenant scope picks its default source; absent keeps the registry's. */\n\tdefaultSource?: DefaultSourceRule\n\t/** `capture.slots` overrides naming the adapter that fills each capture slot. */\n\tcaptureSlots?: { global?: CaptureSlotOption; tenant?: CaptureSlotOption }\n\t/**\n\t * `capture.paths` overrides for a slot's mount. Unset, the tracker config derives the\n\t * runtime proxy mount; set when the slot is served through Next rewrites instead.\n\t */\n\tcapturePaths?: { global?: string; tenant?: string }\n\t/**\n\t * `capture.gate`: whether a slot's tracker waits for the host's consent manager, evaluated\n\t * per request-resolved adapter. Absent runtimes hold every slot.\n\t */\n\tcaptureGate?: CaptureGatePolicy\n\t/** `capture.withoutConsent`, resolved; absent while unset, which means `'cookieless'`. */\n\tcaptureWithoutConsent?: ResolvedWithoutConsent\n\t/** Browser auto-capture toggles handed to the tracker; absent runtimes default all on. */\n\tautoCapture?: ResolvedAutoCapture\n\t/** `capture.skip`, resolved; absent runtimes skip everything it can. */\n\tcaptureSkip?: TrackerSkip\n\t/** Config goals, and the fallback wherever the merged resolution is unavailable. */\n\tgoals?: Goal[]\n\t/** `goals.purchase`: whether the resolver adds the built-in `purchase` goal. */\n\tpurchaseGoal?: boolean\n\t/**\n\t * Config goals merged with the goals collection for a request's scope. Absent runtimes\n\t * fall back to `goals`.\n\t */\n\tresolveGoals?: GoalsResolver['resolve']\n\t/** The same merge, each goal tagged with where it came from. */\n\tresolveGoalsDetailed?: GoalsResolver['resolveDetailed']\n\t/**\n\t * The goals a reader's picker lists: collection goals as the collection's read access lets\n\t * the request's user see them. Absent runtimes list what `resolveGoalsDetailed` answers.\n\t */\n\tlistGoals?: GoalsResolver['listReadable']\n\t/** The goals a report spanning every scope names its rows by; see `goalNamesFor`. */\n\tlistGoalsAcross?: GoalsResolver['listAcross']\n\t/** Slug of the goals collection when the install enabled it; the picker links to it. */\n\tgoalsCollectionSlug?: string\n\t/**\n\t * Providers collection when enabled; it makes a scoped install's sources per tenant.\n\t * `sourceAccess` picks which documents a tenant reads through, else the collection's read access.\n\t */\n\tprovidersCollection?: { slug: string; scopeField: string; sourceAccess?: Access }\n\t/**\n\t * Fetch for adapters built from provider documents: every resolved address must be public unless\n\t * `providers.hosts.allowPrivateNetwork`.\n\t */\n\tproviderFetch?: FetchLike\n\t/**\n\t * Releases what the runtime itself holds once it is retired: the adapters built from provider\n\t * documents, then the connections they reached their vendors through.\n\t */\n\tclose?: () => Promise<void>\n\t/**\n\t * Records an event from server code, through whichever registered adapter accepts\n\t * server events. Rejects with an `AnalyticsTrackError` when none does.\n\t */\n\ttrack?: (event: ServerEventInput, opts?: ServerTrackOptions) => Promise<void>\n\t/**\n\t * Where the ingest endpoint listens, relative to `routes.api`, lifted from the adapter that\n\t * registered one. Absent runtimes fall back to the base's own ingest mount.\n\t */\n\tingestPath?: string\n\t/**\n\t * `capture.proxy` limits, separate from `cache.timeoutMs` on purpose: that is a per-read deadline\n\t * for dashboard queries, this a public request path with different traffic.\n\t */\n\tcaptureProxy?: { timeoutMs: number; maxBodyBytes: number }\n\t/** The plugin's `trustedProxyHops`, read wherever a request's client address is. */\n\ttrustedProxyHops?: number\n\t/** The plugin's `trustedPlatform`, read wherever a request's client address is. */\n\ttrustedPlatform?: TrustedPlatform\n\t/**\n\t * `capture.allowedOrigins`, normalized: the other sites whose pages may POST to the public\n\t * capture routes. Absent runtimes admit no cross-site POST at all.\n\t */\n\tallowedOrigins?: ReadonlySet<string>\n\t/** `capture.exclusion` while the link is on; absent while it is off. */\n\texclusion?: ResolvedExclusion\n\t/**\n\t * `access.view`, which also gates handing out the exclusion link the view shows. Absent\n\t * runtimes fall back to the read gate alone.\n\t */\n\tviewAccess?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\t/** True when the app configured `scope.resolve` (scoped install); mirrors `resolved.scoped`. */\n\tscoped?: boolean\n\t/** `scope.label`: names the resolved scope in the view's caption. */\n\tscopeLabel?: ScopeLabelResolver\n\t/** `scope.list`: the scopes a named refresh may bump. */\n\tscopeList?: ScopeListResolver\n\t/** The read cache's collection, when the install keeps its cache there rather than in `cache.store`. */\n\tcacheCollectionSlug?: string\n\t/** `countryFlags`, for the server surfaces that draw a flag outside the view. */\n\tcountryFlags?: boolean | AnalyticsCountryFlags\n\t/**\n\t * Ids of the config-time adapters shared by every scope; runtime provider adapters (from the\n\t * providers collection or `providers.resolve`) are never in it.\n\t */\n\tconfigAdapterIds: ReadonlySet<string>\n\t/**\n\t * `access.crossScope`, every gate filled at config time. A gate a runtime leaves out (a test\n\t * double, a half-booted install) admits the users of the admin collection.\n\t */\n\tcrossScope?: Partial<Record<ScopeDecision, CrossScopeAccess>>\n\t/**\n\t * `access.read`, asked through `readGate` by every read; absent runtimes admit the users of\n\t * the admin collection.\n\t */\n\treadAccess?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\t/** Each bound collection, with the field its documents carry their scope in. */\n\tbindings: Record<string, ResolvedBinding>\n\tengine: Engine\n\t/**\n\t * The per-scope refresh epoch the engine keys on, shared with the reads that build their\n\t * own keys. Absent runtimes key on the initial token throughout.\n\t */\n\tepoch?: EpochStore\n\t/**\n\t * Provider and goal configuration epoch every cache key carries beside the refresh epoch: a hash\n\t * of committed documents, or a token `refreshProviders()` bumps. Absent, one fixed value.\n\t */\n\tconfigEpoch?: (scope?: string | null) => Promise<string>\n\t/**\n\t * Told by the providers and goals collection hooks which scopes a save touched, so this\n\t * instance reads them again as soon as the save commits. Writes nothing.\n\t */\n\tconfigChanged?: (collection: 'providers' | 'goals', scopes: Iterable<string | null>) => void\n\t/** `refreshProviders()`: retires a scope's cached reads on every instance. */\n\trefreshProviders?: (scope: string | null) => Promise<void>\n\t/**\n\t * Whether a scope's own enabled provider documents grant an adapter, decided from their\n\t * committed rows alone: nothing is decrypted. Set on an install running the providers collection.\n\t */\n\tproviderGranted?: (scope: string | null, adapterId: string) => Promise<boolean>\n\t/** The instance's in-process memo, the only place a live count is ever kept. */\n\tmemo?: Memo<AnalyticsResult>\n\t/** Where reads are cached across instances, and what deletes the expired entries. */\n\tcache?: { store: CacheStore; sweeper: CacheSweeper }\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/** Widget period-over-period comparison; false skips the previous-window read. */\n\tcomparison: boolean\n\t/** The config adapters this runtime attached to its Payload instance; retiring it closes them. */\n\tadapters?: readonly AnalyticsAdapter[]\n}\n\n/**\n * What the plugin leaves under its key in `config.custom`, which never reaches the client: how\n * to build a runtime for one Payload instance, and the boot checks its `onInit` runs.\n */\nexport interface RuntimeFactory {\n\tcreate: (payload: Payload) => AnalyticsRuntime\n\tvalidate: (payload: Payload) => Promise<void>\n\t/** The options resolved at config time, which the admin view renders with. */\n\tresolved?: ResolvedOptions\n}\n\nconst isRuntimeFactory = (value: unknown): value is RuntimeFactory =>\n\tisRecord(value) && typeof value.create === 'function' && typeof value.validate === 'function'\n\n/** The factory a config carries, absent wherever the plugin is not installed or is disabled. */\nexport const runtimeFactoryOf = (\n\tconfig: { custom?: Record<string, unknown> } | undefined\n): RuntimeFactory | undefined => {\n\tconst factory = config?.custom?.[ANALYTICS_CONFIG_KEY]\n\treturn isRuntimeFactory(factory) ? factory : undefined\n}\n\n/**\n * Stored on the Payload instance (not a module global) so the runtime survives the separate `.`\n * and `/rsc` bundles a consumer loads; `Symbol.for` resolves the same key in both.\n */\nconst RUNTIME_KEY = Symbol.for('@10x-media/analytics/runtime')\n\n/** Runtimes replaced on this instance whose adapters are still waiting out their grace period. */\nconst RETIRING_KEY = Symbol.for('@10x-media/analytics/retiring')\n\n/** How long a replaced runtime keeps serving the requests that already hold it. */\nexport const RUNTIME_RETIRE_GRACE_MS = 30_000\n\n/** A runtime and the exact config object it was built for, which is how a reload is noticed. */\ninterface RuntimeSlot {\n\tconfig: unknown\n\truntime: AnalyticsRuntime | undefined\n}\n\nconst isRuntimeSlot = (value: unknown): value is RuntimeSlot =>\n\tisRecord(value) && 'config' in value && 'runtime' in value\n\nconst slotOf = (payload: Payload): RuntimeSlot | undefined => {\n\tconst slot: unknown = Reflect.get(payload, RUNTIME_KEY)\n\treturn isRuntimeSlot(slot) ? slot : undefined\n}\n\ninterface Retirement {\n\t/** Closes the retired adapters now; later calls share the first one's promise. */\n\trun: () => Promise<void>\n}\n\nconst retiringOf = (payload: Payload): Set<Retirement> => {\n\tconst existing: unknown = Reflect.get(payload, RETIRING_KEY)\n\tif (existing instanceof Set) {\n\t\treturn existing\n\t}\n\tconst created = new Set<Retirement>()\n\tReflect.set(payload, RETIRING_KEY, created)\n\treturn created\n}\n\n/** Runs one close, warning rather than throwing so the closes beside it still run. */\nconst closeOrWarn = async (payload: Payload, what: string, close: () => unknown): Promise<void> => {\n\ttry {\n\t\tawait close()\n\t} catch (err) {\n\t\tpayload.logger?.warn(`analytics: closing ${what} failed: ${String(err)}`)\n\t}\n}\n\n/**\n * After the grace period, closes the retired runtime's resources and every adapter it attached that\n * its successor no longer uses: a shared adapter keeps its buffer and clients.\n */\nconst retire = (\n\tpayload: Payload,\n\tretired: AnalyticsRuntime | undefined,\n\tsuccessor: AnalyticsRuntime | undefined\n): void => {\n\tconst kept = new Set(successor?.adapters ?? [])\n\tconst closing = (retired?.adapters ?? []).filter((adapter) => !kept.has(adapter))\n\tconst closeRuntime = retired?.close\n\tif (closing.length === 0 && !closeRuntime) {\n\t\treturn\n\t}\n\tconst pending = retiringOf(payload)\n\tlet timer: ReturnType<typeof setTimeout> | undefined\n\tlet done: Promise<void> | undefined\n\tconst entry: Retirement = {\n\t\trun: () => {\n\t\t\tdone ??= (async () => {\n\t\t\t\tclearTimeout(timer)\n\t\t\t\tpending.delete(entry)\n\t\t\t\tawait Promise.all([\n\t\t\t\t\tcloseOrWarn(payload, \"a replaced runtime's connections\", () => closeRuntime?.()),\n\t\t\t\t\t...closing.map((adapter) =>\n\t\t\t\t\t\tcloseOrWarn(payload, `the \"${adapter.id}\" adapter of a replaced runtime`, () =>\n\t\t\t\t\t\t\tadapter.close?.(payload)\n\t\t\t\t\t\t)\n\t\t\t\t\t),\n\t\t\t\t])\n\t\t\t})()\n\t\t\treturn done\n\t\t},\n\t}\n\tpending.add(entry)\n\ttimer = setTimeout(() => void entry.run(), RUNTIME_RETIRE_GRACE_MS)\n\ttimer.unref?.()\n}\n\n/** Closes the instance's runtime and every runtime it replaced, at once: the instance is going away. */\nconst closeRuntimes = async (payload: Payload): Promise<void> => {\n\tconst slot = slotOf(payload)\n\tif (slot?.runtime) {\n\t\tretire(payload, slot.runtime, undefined)\n\t}\n\tawait settleRetiredRuntimes(payload)\n}\n\n/**\n * An instance's runtime, built on first use and rebuilt when `payload.config` changes identity (HMR\n * `reload`); undefined without the plugin. Building one makes `payload.destroy()` close it.\n */\nexport const getRuntime = (payload: Payload): AnalyticsRuntime | undefined => {\n\tconst slot = slotOf(payload)\n\tif (slot && slot.config === payload.config) {\n\t\treturn slot.runtime\n\t}\n\tconst runtime = runtimeFactoryOf(payload.config)?.create(payload)\n\tReflect.set(payload, RUNTIME_KEY, { config: payload.config, runtime })\n\tif (slot) {\n\t\tretire(payload, slot.runtime, runtime)\n\t}\n\tif (runtime) {\n\t\tonDestroy(payload, () => closeRuntimes(payload))\n\t}\n\treturn runtime\n}\n\n/** The runtime already built for the instance's current config; unlike `getRuntime`, never builds one. */\nexport const builtRuntime = (payload: Payload): AnalyticsRuntime | undefined => {\n\tconst slot = slotOf(payload)\n\treturn slot && slot.config === payload.config ? slot.runtime : undefined\n}\n\n/** Installs a hand-built runtime for the instance's current config, which is what tests need. */\nexport const setRuntime = (payload: Payload, runtime: AnalyticsRuntime): void => {\n\tReflect.set(payload, RUNTIME_KEY, { config: payload.config, runtime })\n}\n\n/** Closes every replaced runtime's adapters now rather than after the grace period. */\nexport const settleRetiredRuntimes = async (payload: Payload): Promise<void> => {\n\tawait Promise.all([...retiringOf(payload)].map((entry) => entry.run()))\n}\n\nconst scopes = requestMemo<string | null>('scopeResolutions')\nconst timezones = requestMemo<string>('timezoneResolutions')\nconst currencies = requestMemo<string | undefined>('currencyResolutions')\n\n/** A memo key per scope argument, where absent (the request's own scope) and null differ. */\nconst scopeKey = (scope: string | null | undefined): string =>\n\tscope === undefined ? 'own' : JSON.stringify(scope)\n\n/**\n * The scope a per-scope resolver answers for: no timezone, currency, goal or source belongs to the\n * cross-scope marker, so it reads as install-wide.\n */\nexport const resolvableScope = <S extends string | null | undefined>(scope: S): S | null =>\n\tscope === PLATFORM_SCOPE ? null : scope\n\n/**\n * The scope a signed-in reader's or editor's request selected: the `admin` call site, asked of\n * the host's resolver once per request and user however many reads ask.\n */\nexport const resolveScopeFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\tconst resolve = runtime.resolveScope\n\tif (!resolve) {\n\t\treturn Promise.resolve(null)\n\t}\n\treturn scopes(req, {\n\t\towner: runtime,\n\t\tkey: 'admin',\n\t\tcompute: async () => {\n\t\t\ttry {\n\t\t\t\treturn await resolve(req, 'admin')\n\t\t\t} catch (err) {\n\t\t\t\t// Said once here rather than by every read the failure reaches.\n\t\t\t\treq.payload?.logger?.warn?.(`analytics: scope resolution failed: ${String(err)}`)\n\t\t\t\tthrow err\n\t\t\t}\n\t\t},\n\t})\n}\n\n/**\n * A visitor hit's scope, asked via {@link captureRequest} so no user, cookie or auth header reaches\n * the resolver: an editor's beacon files under the site, not their admin tenant.\n */\nexport const resolveCaptureScopeFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<string | null> =>\n\truntime.resolveScope?.(captureRequest(req), 'capture') ?? Promise.resolve(null)\n\n/** The scope's reporting timezone, asked of the host's resolver once per request, scope and user. */\nexport const resolveTimezoneFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<string> => {\n\tconst resolve = runtime.resolveTimezone\n\treturn resolve\n\t\t? timezones(req, { owner: runtime, key: scopeKey(scope), compute: () => resolve(req, scope) })\n\t\t: Promise.resolve(DEFAULT_TIMEZONE)\n}\n\n/** The scope's reporting currency, asked of the host's resolver once per request, scope and user. */\nexport const resolveCurrencyFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<string | undefined> => {\n\tconst resolve = runtime.resolveCurrency\n\treturn resolve\n\t\t? currencies(req, { owner: runtime, key: scopeKey(scope), compute: () => resolve(req, scope) })\n\t\t: Promise.resolve(undefined)\n}\n\n/**\n * Like {@link resolveTimezoneFor} but resolving the request's scope first, for calendar days read\n * before a read begins. UTC without the plugin or when resolution throws.\n */\nexport const requestTimezone = async (req: PayloadRequest): Promise<string> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn DEFAULT_TIMEZONE\n\t}\n\ttry {\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\treturn await resolveTimezoneFor(runtime, req, resolvableScope(scope))\n\t} catch {\n\t\treturn DEFAULT_TIMEZONE\n\t}\n}\n\n/**\n * A request's reporting currency, resolving its scope first. Undefined without the plugin, without\n * a configured currency, or when resolution throws: revenue then renders as a plain number.\n */\nexport const requestCurrency = async (req: PayloadRequest): Promise<string | undefined> => {\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime?.resolveCurrency) {\n\t\treturn undefined\n\t}\n\ttry {\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\treturn await resolveCurrencyFor(runtime, req, resolvableScope(scope))\n\t} catch {\n\t\treturn undefined\n\t}\n}\n\n/** The scope's refresh epoch token, the initial one wherever the runtime carries no store. */\nexport const cacheEpochFor = (runtime: AnalyticsRuntime, scope?: string | null): Promise<string> =>\n\truntime.epoch?.get(scope) ?? Promise.resolve(INITIAL_EPOCH)\n\n/** Both epochs the scope's cache keys carry, for a read that builds its own key. */\nexport const cacheEpochsFor = (\n\truntime: AnalyticsRuntime,\n\tscope?: string | null\n): Promise<CacheKeyEpochs> =>\n\tepochsFor(\n\t\t{\n\t\t\t...(runtime.epoch ? { refresh: runtime.epoch } : {}),\n\t\t\t...(runtime.configEpoch ? { config: runtime.configEpoch } : {}),\n\t\t},\n\t\tscope\n\t)\n\n/** The scope's adapter registry; without a per-scope resolver, the config one and no grants. */\nexport const resolveRegistryFor = (\n\truntime: AnalyticsRuntime,\n\targs: ResolveRegistryArgs\n): Promise<ScopeRegistry> =>\n\truntime.resolveRegistry?.(args) ??\n\tPromise.resolve({ registry: runtime.registry, grants: NO_GRANTS })\n\n/** The scope's goals: config goals merged with the goals collection, where the runtime can. */\nexport const resolveGoalsFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<Goal[]> => runtime.resolveGoals?.(req, scope) ?? Promise.resolve(runtime.goals ?? [])\n\n/**\n * {@link resolveGoalsFor}'s goals, each tagged with its origin. Falls back to the untagged\n * resolver, not the static config list, so the two never disagree.\n */\nexport const resolveGoalsDetailedFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<ResolvedGoal[]> => {\n\tif (runtime.resolveGoalsDetailed) {\n\t\treturn runtime.resolveGoalsDetailed(req, scope)\n\t}\n\tconst goals = runtime.resolveGoals\n\t\t? await runtime.resolveGoals(req, scope)\n\t\t: (runtime.goals ?? [])\n\treturn goals.map((goal) => ({ goal, source: 'config' as const }))\n}\n\n/**\n * Whether a read in `scope` spans every scope: the aggregate, or the install-wide read a scoped\n * install answers a platform reader who selected no tenant.\n */\nconst readsAcrossScopes = (\n\truntime: Pick<AnalyticsRuntime, 'scoped'>,\n\tscope: string | null | undefined\n): boolean => scope === PLATFORM_SCOPE || ((scope ?? null) === null && runtime.scoped === true)\n\n/**\n * Names a report in `scope` lists goal rows by. A cross-scope report draws on every scope the\n * reader may see, so a foreign goal reads by name; unnamed goals read as slugs.\n */\nexport const goalNamesFor = async (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n\tscope: string | null | undefined\n\t/** The scope's own goals, when the caller already resolved them. */\n\tresolved?: ResolvedGoal[]\n}): Promise<Array<{ slug: string; name: string }>> => {\n\tconst { runtime, req, scope, resolved } = args\n\tconst own = resolved ?? (await resolveGoalsDetailedFor(runtime, req, resolvableScope(scope)))\n\tif (!readsAcrossScopes(runtime, scope) || !runtime.listGoalsAcross) {\n\t\treturn own.map(({ goal }) => ({ slug: goal.slug, name: goal.name }))\n\t}\n\tconst across = await runtime.listGoalsAcross(req)\n\tconst names = new Map(own.map(({ goal }) => [goal.slug, goal.name]))\n\tfor (const { goal } of across) {\n\t\tif (!names.has(goal.slug)) {\n\t\t\tnames.set(goal.slug, goal.name)\n\t\t}\n\t}\n\treturn [...names].map(([slug, name]) => ({ slug, name }))\n}\n\n/** The three cross-scope decisions `access.crossScope` names. */\nexport type ScopeDecision = 'named' | 'aggregate' | 'unscopedSource'\n\n/** What one gate is asked about: the scope (`'*'` or null for every scope) and the adapter. */\nexport interface GateContext {\n\tscope?: string | null\n\tadapterId?: string\n}\n\n/**\n * The three cross-scope decisions for one request, each evaluated at most once per user, scope and\n * adapter however many gates and reads consult it.\n */\nexport type ScopeGates = Record<ScopeDecision, (ctx?: GateContext) => Promise<boolean>>\n\n/**\n * The request's {@link ScopeGates}; a gate `access.crossScope` leaves unset admits the users of the\n * admin collection.\n */\nexport const scopeGates = (runtime: AnalyticsRuntime, req: PayloadRequest): ScopeGates => {\n\tconst gate =\n\t\t(decision: ScopeDecision) =>\n\t\t(ctx: GateContext = {}): Promise<boolean> => {\n\t\t\tconst { scope, adapterId } = ctx\n\t\t\tconst args = {\n\t\t\t\treq,\n\t\t\t\t...(scope === undefined ? {} : { scope }),\n\t\t\t\t...(adapterId === undefined ? {} : { adapterId }),\n\t\t\t}\n\t\t\treturn decideOnce(req, {\n\t\t\t\towner: runtime,\n\t\t\t\tkey: `crossScope:${decision}:${JSON.stringify(scope)}:${adapterId ?? ''}`,\n\t\t\t\tdecide: () => runtime.crossScope?.[decision]?.(args) ?? isAdminUser({ req }),\n\t\t\t})\n\t\t}\n\treturn {\n\t\tnamed: gate('named'),\n\t\taggregate: gate('aggregate'),\n\t\tunscopedSource: gate('unscopedSource'),\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAwOA,MAAM,oBAAoB,UACzB,SAAS,KAAK,KAAK,OAAO,MAAM,WAAW,cAAc,OAAO,MAAM,aAAa;;AAGpF,MAAa,oBACZ,WACgC;CAChC,MAAM,UAAU,QAAQ,SAAS;CACjC,OAAO,iBAAiB,OAAO,IAAI,UAAU,KAAA;AAC9C;;;;;AAMA,MAAM,cAAc,OAAO,IAAI,8BAA8B;;AAG7D,MAAM,eAAe,OAAO,IAAI,+BAA+B;;AAG/D,MAAa,0BAA0B;AAQvC,MAAM,iBAAiB,UACtB,SAAS,KAAK,KAAK,YAAY,SAAS,aAAa;AAEtD,MAAM,UAAU,YAA8C;CAC7D,MAAM,OAAgB,QAAQ,IAAI,SAAS,WAAW;CACtD,OAAO,cAAc,IAAI,IAAI,OAAO,KAAA;AACrC;AAOA,MAAM,cAAc,YAAsC;CACzD,MAAM,WAAoB,QAAQ,IAAI,SAAS,YAAY;CAC3D,IAAI,oBAAoB,KACvB,OAAO;CAER,MAAM,0BAAU,IAAI,IAAgB;CACpC,QAAQ,IAAI,SAAS,cAAc,OAAO;CAC1C,OAAO;AACR;;AAGA,MAAM,cAAc,OAAO,SAAkB,MAAc,UAAwC;CAClG,IAAI;EACH,MAAM,MAAM;CACb,SAAS,KAAK;EACb,QAAQ,QAAQ,KAAK,sBAAsB,KAAK,WAAW,OAAO,GAAG,GAAG;CACzE;AACD;;;;;AAMA,MAAM,UACL,SACA,SACA,cACU;CACV,MAAM,OAAO,IAAI,IAAI,WAAW,YAAY,CAAC,CAAC;CAC9C,MAAM,WAAW,SAAS,YAAY,CAAC,GAAG,QAAQ,YAAY,CAAC,KAAK,IAAI,OAAO,CAAC;CAChF,MAAM,eAAe,SAAS;CAC9B,IAAI,QAAQ,WAAW,KAAK,CAAC,cAC5B;CAED,MAAM,UAAU,WAAW,OAAO;CAClC,IAAI;CACJ,IAAI;CACJ,MAAM,QAAoB,EACzB,WAAW;EACV,UAAU,YAAY;GACrB,aAAa,KAAK;GAClB,QAAQ,OAAO,KAAK;GACpB,MAAM,QAAQ,IAAI,CACjB,YAAY,SAAS,0CAA0C,eAAe,CAAC,GAC/E,GAAG,QAAQ,KAAK,YACf,YAAY,SAAS,QAAQ,QAAQ,GAAG,wCACvC,QAAQ,QAAQ,OAAO,CACxB,CACD,CACD,CAAC;EACF,GAAG;EACH,OAAO;CACR,EACD;CACA,QAAQ,IAAI,KAAK;CACjB,QAAQ,iBAAiB,KAAK,MAAM,IAAI,GAAG,uBAAuB;CAClE,MAAM,QAAQ;AACf;;AAGA,MAAM,gBAAgB,OAAO,YAAoC;CAChE,MAAM,OAAO,OAAO,OAAO;CAC3B,IAAI,MAAM,SACT,OAAO,SAAS,KAAK,SAAS,KAAA,CAAS;CAExC,MAAM,sBAAsB,OAAO;AACpC;;;;;AAMA,MAAa,cAAc,YAAmD;CAC7E,MAAM,OAAO,OAAO,OAAO;CAC3B,IAAI,QAAQ,KAAK,WAAW,QAAQ,QACnC,OAAO,KAAK;CAEb,MAAM,UAAU,iBAAiB,QAAQ,MAAM,GAAG,OAAO,OAAO;CAChE,QAAQ,IAAI,SAAS,aAAa;EAAE,QAAQ,QAAQ;EAAQ;CAAQ,CAAC;CACrE,IAAI,MACH,OAAO,SAAS,KAAK,SAAS,OAAO;CAEtC,IAAI,SACH,UAAU,eAAe,cAAc,OAAO,CAAC;CAEhD,OAAO;AACR;;AAGA,MAAa,gBAAgB,YAAmD;CAC/E,MAAM,OAAO,OAAO,OAAO;CAC3B,OAAO,QAAQ,KAAK,WAAW,QAAQ,SAAS,KAAK,UAAU,KAAA;AAChE;;AAQA,MAAa,wBAAwB,OAAO,YAAoC;CAC/E,MAAM,QAAQ,IAAI,CAAC,GAAG,WAAW,OAAO,CAAC,EAAE,KAAK,UAAU,MAAM,IAAI,CAAC,CAAC;AACvE;AAEA,MAAM,SAAS,YAA2B,kBAAkB;AAC5D,MAAM,YAAY,YAAoB,qBAAqB;AAC3D,MAAM,aAAa,YAAgC,qBAAqB;;AAGxE,MAAM,YAAY,UACjB,UAAU,KAAA,IAAY,QAAQ,KAAK,UAAU,KAAK;;;;;AAMnD,MAAa,mBAAwD,UACpE,UAAA,MAA2B,OAAO;;;;;AAMnC,MAAa,mBACZ,SACA,QAC4B;CAC5B,MAAM,UAAU,QAAQ;CACxB,IAAI,CAAC,SACJ,OAAO,QAAQ,QAAQ,IAAI;CAE5B,OAAO,OAAO,KAAK;EAClB,OAAO;EACP,KAAK;EACL,SAAS,YAAY;GACpB,IAAI;IACH,OAAO,MAAM,QAAQ,KAAK,OAAO;GAClC,SAAS,KAAK;IAEb,IAAI,SAAS,QAAQ,OAAO,uCAAuC,OAAO,GAAG,GAAG;IAChF,MAAM;GACP;EACD;CACD,CAAC;AACF;;;;;AAMA,MAAa,0BACZ,SACA,QAEA,QAAQ,eAAe,eAAe,GAAG,GAAG,SAAS,KAAK,QAAQ,QAAQ,IAAI;;AAG/E,MAAa,sBACZ,SACA,KACA,UACqB;CACrB,MAAM,UAAU,QAAQ;CACxB,OAAO,UACJ,UAAU,KAAK;EAAE,OAAO;EAAS,KAAK,SAAS,KAAK;EAAG,eAAe,QAAQ,KAAK,KAAK;CAAE,CAAC,IAC3F,QAAQ,QAAA,KAAwB;AACpC;;AAGA,MAAa,sBACZ,SACA,KACA,UACiC;CACjC,MAAM,UAAU,QAAQ;CACxB,OAAO,UACJ,WAAW,KAAK;EAAE,OAAO;EAAS,KAAK,SAAS,KAAK;EAAG,eAAe,QAAQ,KAAK,KAAK;CAAE,CAAC,IAC5F,QAAQ,QAAQ,KAAA,CAAS;AAC7B;;;;;AAMA,MAAa,kBAAkB,OAAO,QAAyC;CAC9E,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAA;CAED,IAAI;EAEH,OAAO,MAAM,mBAAmB,SAAS,KAAK,gBAAgB,MAD1C,gBAAgB,SAAS,GAAG,CACmB,CAAC;CACrE,QAAQ;EACP,OAAA;CACD;AACD;;;;;AAMA,MAAa,kBAAkB,OAAO,QAAqD;CAC1F,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SAAS,iBACb;CAED,IAAI;EAEH,OAAO,MAAM,mBAAmB,SAAS,KAAK,gBAAgB,MAD1C,gBAAgB,SAAS,GAAG,CACmB,CAAC;CACrE,QAAQ;EACP;CACD;AACD;;AAGA,MAAa,iBAAiB,SAA2B,UACxD,QAAQ,OAAO,IAAI,KAAK,KAAK,QAAQ,QAAA,GAAqB;;AAG3D,MAAa,kBACZ,SACA,UAEA,UACC;CACC,GAAI,QAAQ,QAAQ,EAAE,SAAS,QAAQ,MAAM,IAAI,CAAC;CAClD,GAAI,QAAQ,cAAc,EAAE,QAAQ,QAAQ,YAAY,IAAI,CAAC;AAC9D,GACA,KACD;;AAGD,MAAa,sBACZ,SACA,SAEA,QAAQ,kBAAkB,IAAI,KAC9B,QAAQ,QAAQ;CAAE,UAAU,QAAQ;CAAU,QAAQ;AAAU,CAAC;;AAGlE,MAAa,mBACZ,SACA,KACA,UACqB,QAAQ,eAAe,KAAK,KAAK,KAAK,QAAQ,QAAQ,QAAQ,SAAS,CAAC,CAAC;;;;;AAM/F,MAAa,0BAA0B,OACtC,SACA,KACA,UAC6B;CAC7B,IAAI,QAAQ,sBACX,OAAO,QAAQ,qBAAqB,KAAK,KAAK;CAK/C,QAHc,QAAQ,eACnB,MAAM,QAAQ,aAAa,KAAK,KAAK,IACpC,QAAQ,SAAS,CAAC,GACT,KAAK,UAAU;EAAE;EAAM,QAAQ;CAAkB,EAAE;AACjE;;;;;AAMA,MAAM,qBACL,SACA,UACa,UAAA,QAA8B,SAAS,UAAU,QAAQ,QAAQ,WAAW;;;;;AAM1F,MAAa,eAAe,OAAO,SAMmB;CACrD,MAAM,EAAE,SAAS,KAAK,OAAO,aAAa;CAC1C,MAAM,MAAM,YAAa,MAAM,wBAAwB,SAAS,KAAK,gBAAgB,KAAK,CAAC;CAC3F,IAAI,CAAC,kBAAkB,SAAS,KAAK,KAAK,CAAC,QAAQ,iBAClD,OAAO,IAAI,KAAK,EAAE,YAAY;EAAE,MAAM,KAAK;EAAM,MAAM,KAAK;CAAK,EAAE;CAEpE,MAAM,SAAS,MAAM,QAAQ,gBAAgB,GAAG;CAChD,MAAM,QAAQ,IAAI,IAAI,IAAI,KAAK,EAAE,WAAW,CAAC,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC;CACnE,KAAK,MAAM,EAAE,UAAU,QACtB,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,GACvB,MAAM,IAAI,KAAK,MAAM,KAAK,IAAI;CAGhC,OAAO,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,WAAW;EAAE;EAAM;CAAK,EAAE;AACzD;;;;;AAqBA,MAAa,cAAc,SAA2B,QAAoC;CACzF,MAAM,QACJ,cACA,MAAmB,CAAC,MAAwB;EAC5C,MAAM,EAAE,OAAO,cAAc;EAC7B,MAAM,OAAO;GACZ;GACA,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;GACvC,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;EAChD;EACA,OAAO,WAAW,KAAK;GACtB,OAAO;GACP,KAAK,cAAc,SAAS,GAAG,KAAK,UAAU,KAAK,EAAE,GAAG,aAAa;GACrE,cAAc,QAAQ,aAAa,YAAY,IAAI,KAAK,YAAY,EAAE,IAAI,CAAC;EAC5E,CAAC;CACF;CACD,OAAO;EACN,OAAO,KAAK,OAAO;EACnB,WAAW,KAAK,WAAW;EAC3B,gBAAgB,KAAK,gBAAgB;CACtC;AACD"}
@@ -0,0 +1,61 @@
1
+ import { TASK_SLUGS } from "../core/jobs.js";
2
+ import { addStateCollection, cacheCollectionOf } from "./pluginCollections.js";
3
+ import { registerTranslations } from "./registerTranslations.js";
4
+ import { relabelFactoryFields } from "./relabelFields.js";
5
+ import { fillUnbundledLanguages } from "./unbundledLanguages.js";
6
+ //#region src/plugin/schemaOnly.ts
7
+ const addTask = (config, task) => {
8
+ config.jobs = {
9
+ ...config.jobs,
10
+ tasks: [...config.jobs?.tasks ?? [], task]
11
+ };
12
+ };
13
+ const scheduleForSchema = (schedule) => schedule.cron === null ? {} : { schedule: [{
14
+ cron: schedule.cron,
15
+ queue: schedule.queue,
16
+ hooks: {
17
+ beforeSchedule: () => ({ shouldSchedule: false }),
18
+ afterSchedule: () => void 0
19
+ }
20
+ }] };
21
+ /**
22
+ * A task slug a switched-off install keeps in its jobs enum. Its handler does nothing, and its
23
+ * schedule, kept so Payload keeps `payload-jobs-stats`, never queues a run.
24
+ */
25
+ const schemaOnlyTask = (slug, schedule) => ({
26
+ slug,
27
+ retries: 0,
28
+ handler: async () => ({ output: {} }),
29
+ ...scheduleForSchema(schedule)
30
+ });
31
+ /**
32
+ * `disabled: true`: the running plugin's schema and nothing that runs, with the same collections
33
+ * and task slugs, inert and unscheduled. It adds no `onInit`.
34
+ */
35
+ const schemaOnly = (config, args) => {
36
+ const { resolved, context } = args;
37
+ const { jobs } = resolved;
38
+ config.collections = [...config.collections ?? [], ...args.collections];
39
+ for (const adapter of resolved.adapters) adapter.registerSchema?.(config, {
40
+ jobs,
41
+ notice: context.notice
42
+ });
43
+ if (jobs !== false && resolved.cache.warm.enabled) addTask(config, schemaOnlyTask(TASK_SLUGS.warm, jobs.warm));
44
+ if (args.sync) {
45
+ config.collections = [...config.collections ?? [], args.sync];
46
+ if (jobs !== false) addTask(config, schemaOnlyTask(TASK_SLUGS.sync, jobs.sync));
47
+ }
48
+ const cache = cacheCollectionOf(resolved, context);
49
+ if (cache) config.collections = [...config.collections ?? [], cache];
50
+ addStateCollection(config, resolved, context);
51
+ relabelFactoryFields(config, context.staticLabel);
52
+ if (args.collections.length > 0 || args.sync) {
53
+ registerTranslations(config, args.translations);
54
+ fillUnbundledLanguages(config);
55
+ }
56
+ return config;
57
+ };
58
+ //#endregion
59
+ export { addTask, schemaOnly, schemaOnlyTask };
60
+
61
+ //# sourceMappingURL=schemaOnly.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemaOnly.js","names":[],"sources":["../../src/plugin/schemaOnly.ts"],"sourcesContent":["import type { CollectionConfig, Config, TaskConfig } from 'payload'\nimport { type ScheduledTask, TASK_SLUGS } from '../core/jobs'\nimport type { ResolvedOptions } from '../core/options'\nimport type { TranslationsOption } from '../translations'\nimport { addStateCollection, type CollectionContext, cacheCollectionOf } from './pluginCollections'\nimport { registerTranslations } from './registerTranslations'\nimport { relabelFactoryFields } from './relabelFields'\nimport { fillUnbundledLanguages } from './unbundledLanguages'\n\ntype JobsTask = NonNullable<NonNullable<Config['jobs']>['tasks']>[number]\n\nexport const addTask = (config: Config, task: JobsTask): void => {\n\tconfig.jobs = { ...config.jobs, tasks: [...(config.jobs?.tasks ?? []), task] }\n}\n\nconst scheduleForSchema = (schedule: ScheduledTask): Pick<TaskConfig, 'schedule'> =>\n\tschedule.cron === null\n\t\t? {}\n\t\t: {\n\t\t\t\tschedule: [\n\t\t\t\t\t{\n\t\t\t\t\t\tcron: schedule.cron,\n\t\t\t\t\t\tqueue: schedule.queue,\n\t\t\t\t\t\thooks: {\n\t\t\t\t\t\t\tbeforeSchedule: () => ({ shouldSchedule: false }),\n\t\t\t\t\t\t\tafterSchedule: () => undefined,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t}\n\n/**\n * A task slug a switched-off install keeps in its jobs enum. Its handler does nothing, and its\n * schedule, kept so Payload keeps `payload-jobs-stats`, never queues a run.\n */\nexport const schemaOnlyTask = (\n\tslug: string,\n\tschedule: ScheduledTask\n): TaskConfig<{ input: Record<string, never>; output: Record<string, never> }> => ({\n\tslug,\n\tretries: 0,\n\thandler: async () => ({ output: {} }),\n\t...scheduleForSchema(schedule),\n})\n\ninterface SchemaOnlyArgs {\n\tresolved: ResolvedOptions\n\t/** The providers and goals collections, built as the running plugin builds them. */\n\tcollections: CollectionConfig[]\n\t/** The sync collection when sync is on, built as the running plugin builds it. */\n\tsync?: CollectionConfig\n\t/** The database the collections are checked against; their notices are never said. */\n\tcontext: CollectionContext\n\ttranslations?: TranslationsOption\n}\n\n/**\n * `disabled: true`: the running plugin's schema and nothing that runs, with the same collections\n * and task slugs, inert and unscheduled. It adds no `onInit`.\n */\nexport const schemaOnly = (config: Config, args: SchemaOnlyArgs): Config => {\n\tconst { resolved, context } = args\n\tconst { jobs } = resolved\n\tconfig.collections = [...(config.collections ?? []), ...args.collections]\n\tfor (const adapter of resolved.adapters) {\n\t\tadapter.registerSchema?.(config, { jobs, notice: context.notice })\n\t}\n\tif (jobs !== false && resolved.cache.warm.enabled) {\n\t\taddTask(config, schemaOnlyTask(TASK_SLUGS.warm, jobs.warm))\n\t}\n\tif (args.sync) {\n\t\tconfig.collections = [...(config.collections ?? []), args.sync]\n\t\tif (jobs !== false) {\n\t\t\taddTask(config, schemaOnlyTask(TASK_SLUGS.sync, jobs.sync))\n\t\t}\n\t}\n\tconst cache = cacheCollectionOf(resolved, context)\n\tif (cache) {\n\t\tconfig.collections = [...(config.collections ?? []), cache]\n\t}\n\taddStateCollection(config, resolved, context)\n\trelabelFactoryFields(config, context.staticLabel)\n\tif (args.collections.length > 0 || args.sync) {\n\t\tregisterTranslations(config, args.translations)\n\t\tfillUnbundledLanguages(config)\n\t}\n\treturn config\n}\n"],"mappings":";;;;;;AAWA,MAAa,WAAW,QAAgB,SAAyB;CAChE,OAAO,OAAO;EAAE,GAAG,OAAO;EAAM,OAAO,CAAC,GAAI,OAAO,MAAM,SAAS,CAAC,GAAI,IAAI;CAAE;AAC9E;AAEA,MAAM,qBAAqB,aAC1B,SAAS,SAAS,OACf,CAAC,IACD,EACA,UAAU,CACT;CACC,MAAM,SAAS;CACf,OAAO,SAAS;CAChB,OAAO;EACN,uBAAuB,EAAE,gBAAgB,MAAM;EAC/C,qBAAqB,KAAA;CACtB;AACD,CACD,EACD;;;;;AAMH,MAAa,kBACZ,MACA,cACkF;CAClF;CACA,SAAS;CACT,SAAS,aAAa,EAAE,QAAQ,CAAC,EAAE;CACnC,GAAG,kBAAkB,QAAQ;AAC9B;;;;;AAiBA,MAAa,cAAc,QAAgB,SAAiC;CAC3E,MAAM,EAAE,UAAU,YAAY;CAC9B,MAAM,EAAE,SAAS;CACjB,OAAO,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,GAAI,GAAG,KAAK,WAAW;CACxE,KAAK,MAAM,WAAW,SAAS,UAC9B,QAAQ,iBAAiB,QAAQ;EAAE;EAAM,QAAQ,QAAQ;CAAO,CAAC;CAElE,IAAI,SAAS,SAAS,SAAS,MAAM,KAAK,SACzC,QAAQ,QAAQ,eAAe,WAAW,MAAM,KAAK,IAAI,CAAC;CAE3D,IAAI,KAAK,MAAM;EACd,OAAO,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,GAAI,KAAK,IAAI;EAC9D,IAAI,SAAS,OACZ,QAAQ,QAAQ,eAAe,WAAW,MAAM,KAAK,IAAI,CAAC;CAE5D;CACA,MAAM,QAAQ,kBAAkB,UAAU,OAAO;CACjD,IAAI,OACH,OAAO,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,GAAI,KAAK;CAE3D,mBAAmB,QAAQ,UAAU,OAAO;CAC5C,qBAAqB,QAAQ,QAAQ,WAAW;CAChD,IAAI,KAAK,YAAY,SAAS,KAAK,KAAK,MAAM;EAC7C,qBAAqB,QAAQ,KAAK,YAAY;EAC9C,uBAAuB,MAAM;CAC9B;CACA,OAAO;AACR"}
@@ -0,0 +1,23 @@
1
+ import { isRecord } from "../core/values.js";
2
+ //#region src/plugin/scopeChange.ts
3
+ /** Every scope a change touched: the document's scope, and the one an update moved it out of. */
4
+ const changedScopes = (change) => change.previousScope === void 0 || change.previousScope === change.scope ? [change.scope] : [change.scope, change.previousScope];
5
+ /**
6
+ * A document's scope as read paths spell it: a missing scope field reads as null, like unscoped
7
+ * reads, and a populated relationship yields its id.
8
+ */
9
+ const docScope = (doc, scopeField) => {
10
+ if (!isRecord(doc)) return null;
11
+ const value = doc[scopeField];
12
+ if (typeof value === "string") return value === "" ? null : value;
13
+ if (typeof value === "number") return String(value);
14
+ if (isRecord(value)) {
15
+ const id = value.id;
16
+ return typeof id === "string" || typeof id === "number" ? String(id) : null;
17
+ }
18
+ return null;
19
+ };
20
+ //#endregion
21
+ export { changedScopes, docScope };
22
+
23
+ //# sourceMappingURL=scopeChange.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopeChange.js","names":[],"sources":["../../src/plugin/scopeChange.ts"],"sourcesContent":["import { isRecord } from '../core/values'\n\n/** What a providers or goals document change tells the plugin about the scopes it touched. */\nexport interface ScopeChange {\n\tscope: string | null\n\t/** The scope the document was in before an update, so a move invalidates both. */\n\tpreviousScope?: string | null\n}\n\n/** Every scope a change touched: the document's scope, and the one an update moved it out of. */\nexport const changedScopes = (change: ScopeChange): Array<string | null> =>\n\tchange.previousScope === undefined || change.previousScope === change.scope\n\t\t? [change.scope]\n\t\t: [change.scope, change.previousScope]\n\n/**\n * A document's scope as read paths spell it: a missing scope field reads as null, like unscoped\n * reads, and a populated relationship yields its id.\n */\nexport const docScope = (doc: unknown, scopeField: string): string | null => {\n\tif (!isRecord(doc)) {\n\t\treturn null\n\t}\n\tconst value = doc[scopeField]\n\tif (typeof value === 'string') {\n\t\treturn value === '' ? null : value\n\t}\n\tif (typeof value === 'number') {\n\t\treturn String(value)\n\t}\n\tif (isRecord(value)) {\n\t\tconst id = value.id\n\t\treturn typeof id === 'string' || typeof id === 'number' ? String(id) : null\n\t}\n\treturn null\n}\n"],"mappings":";;;AAUA,MAAa,iBAAiB,WAC7B,OAAO,kBAAkB,KAAA,KAAa,OAAO,kBAAkB,OAAO,QACnE,CAAC,OAAO,KAAK,IACb,CAAC,OAAO,OAAO,OAAO,aAAa;;;;;AAMvC,MAAa,YAAY,KAAc,eAAsC;CAC5E,IAAI,CAAC,SAAS,GAAG,GAChB,OAAO;CAER,MAAM,QAAQ,IAAI;CAClB,IAAI,OAAO,UAAU,UACpB,OAAO,UAAU,KAAK,OAAO;CAE9B,IAAI,OAAO,UAAU,UACpB,OAAO,OAAO,KAAK;CAEpB,IAAI,SAAS,KAAK,GAAG;EACpB,MAAM,KAAK,MAAM;EACjB,OAAO,OAAO,OAAO,YAAY,OAAO,OAAO,WAAW,OAAO,EAAE,IAAI;CACxE;CACA,OAAO;AACR"}
@@ -7,14 +7,14 @@ const hasField = (fields, name) => fields.some((field) => {
7
7
  return false;
8
8
  });
9
9
  /**
10
- * Fails the boot when a `scopeField` the plugin does not own never materialized on the
11
- * collection. A tenant plugin registers its field after this plugin runs, so the check
12
- * waits for the assembled config at init rather than guessing at config time.
10
+ * Fails boot when a `scopeField` the plugin does not own never materialized. Checked at init
11
+ * because a tenant plugin registers its field after this plugin runs.
13
12
  */
14
13
  const validateScopeField = (payload, args) => {
15
14
  const collection = payload.config.collections.find((c) => c.slug === args.slug);
16
15
  if (!collection || hasField(collection.fields, args.scopeField)) return;
17
- throw new Error(`analytics: ${args.option} "${args.scopeField}" does not exist on ${args.slug}; register the collection with your tenant plugin or use the default scope field`);
16
+ const remedy = args.remedy ?? "register the collection with your tenant plugin or use the default scope field";
17
+ throw new Error(`analytics: ${args.option} "${args.scopeField}" does not exist on ${args.slug}; ${remedy}`);
18
18
  };
19
19
  //#endregion
20
20
  export { validateScopeField };
@@ -1 +1 @@
1
- {"version":3,"file":"scopeFieldBoot.js","names":[],"sources":["../../src/plugin/scopeFieldBoot.ts"],"sourcesContent":["import type { Field, Payload } from 'payload'\n\n/** Whether a top-level field of that name exists, looking through presentational wrappers. */\nconst hasField = (fields: Field[], name: string): boolean =>\n\tfields.some((field) => {\n\t\tif ('name' in field && field.name) {\n\t\t\treturn field.name === name\n\t\t}\n\t\tif ('fields' in field) {\n\t\t\treturn hasField(field.fields, name)\n\t\t}\n\t\tif ('tabs' in field) {\n\t\t\treturn field.tabs.some(\n\t\t\t\t(tab) => !('name' in tab && tab.name) && hasField(tab.fields as Field[], name)\n\t\t\t)\n\t\t}\n\t\treturn false\n\t})\n\nexport interface ValidateScopeFieldArgs {\n\t/** Option path quoted in the error, e.g. `goals.collection.scopeField`. */\n\toption: string\n\tslug: string\n\tscopeField: string\n}\n\n/**\n * Fails the boot when a `scopeField` the plugin does not own never materialized on the\n * collection. A tenant plugin registers its field after this plugin runs, so the check\n * waits for the assembled config at init rather than guessing at config time.\n */\nexport const validateScopeField = (payload: Payload, args: ValidateScopeFieldArgs): void => {\n\tconst collection = payload.config.collections.find((c) => c.slug === args.slug)\n\tif (!collection || hasField(collection.fields, args.scopeField)) {\n\t\treturn\n\t}\n\tthrow new Error(\n\t\t`analytics: ${args.option} \"${args.scopeField}\" does not exist on ${args.slug}; register the collection with your tenant plugin or use the default scope field`\n\t)\n}\n"],"mappings":";;AAGA,MAAM,YAAY,QAAiB,SAClC,OAAO,MAAM,UAAU;CACtB,IAAI,UAAU,SAAS,MAAM,MAC5B,OAAO,MAAM,SAAS;CAEvB,IAAI,YAAY,OACf,OAAO,SAAS,MAAM,QAAQ,IAAI;CAEnC,IAAI,UAAU,OACb,OAAO,MAAM,KAAK,MAChB,QAAQ,EAAE,UAAU,OAAO,IAAI,SAAS,SAAS,IAAI,QAAmB,IAAI,CAC9E;CAED,OAAO;AACR,CAAC;;;;;;AAcF,MAAa,sBAAsB,SAAkB,SAAuC;CAC3F,MAAM,aAAa,QAAQ,OAAO,YAAY,MAAM,MAAM,EAAE,SAAS,KAAK,IAAI;CAC9E,IAAI,CAAC,cAAc,SAAS,WAAW,QAAQ,KAAK,UAAU,GAC7D;CAED,MAAM,IAAI,MACT,cAAc,KAAK,OAAO,IAAI,KAAK,WAAW,sBAAsB,KAAK,KAAK,iFAC/E;AACD"}
1
+ {"version":3,"file":"scopeFieldBoot.js","names":[],"sources":["../../src/plugin/scopeFieldBoot.ts"],"sourcesContent":["import type { Field, Payload } from 'payload'\n\n/** Whether a top-level field of that name exists, looking through presentational wrappers. */\nconst hasField = (fields: Field[], name: string): boolean =>\n\tfields.some((field) => {\n\t\tif ('name' in field && field.name) {\n\t\t\treturn field.name === name\n\t\t}\n\t\tif ('fields' in field) {\n\t\t\treturn hasField(field.fields, name)\n\t\t}\n\t\tif ('tabs' in field) {\n\t\t\treturn field.tabs.some((tab) => !('name' in tab && tab.name) && hasField(tab.fields, name))\n\t\t}\n\t\treturn false\n\t})\n\ninterface ValidateScopeFieldArgs {\n\t/** Option path quoted in the error, e.g. `goals.collection.scopeField`. */\n\toption: string\n\tslug: string\n\tscopeField: string\n\t/** What the error tells the host to do instead; defaults to the plugin collections' advice. */\n\tremedy?: string\n}\n\n/**\n * Fails boot when a `scopeField` the plugin does not own never materialized. Checked at init\n * because a tenant plugin registers its field after this plugin runs.\n */\nexport const validateScopeField = (payload: Payload, args: ValidateScopeFieldArgs): void => {\n\tconst collection = payload.config.collections.find((c) => c.slug === args.slug)\n\tif (!collection || hasField(collection.fields, args.scopeField)) {\n\t\treturn\n\t}\n\tconst remedy =\n\t\targs.remedy ?? 'register the collection with your tenant plugin or use the default scope field'\n\tthrow new Error(\n\t\t`analytics: ${args.option} \"${args.scopeField}\" does not exist on ${args.slug}; ${remedy}`\n\t)\n}\n"],"mappings":";;AAGA,MAAM,YAAY,QAAiB,SAClC,OAAO,MAAM,UAAU;CACtB,IAAI,UAAU,SAAS,MAAM,MAC5B,OAAO,MAAM,SAAS;CAEvB,IAAI,YAAY,OACf,OAAO,SAAS,MAAM,QAAQ,IAAI;CAEnC,IAAI,UAAU,OACb,OAAO,MAAM,KAAK,MAAM,QAAQ,EAAE,UAAU,OAAO,IAAI,SAAS,SAAS,IAAI,QAAQ,IAAI,CAAC;CAE3F,OAAO;AACR,CAAC;;;;;AAeF,MAAa,sBAAsB,SAAkB,SAAuC;CAC3F,MAAM,aAAa,QAAQ,OAAO,YAAY,MAAM,MAAM,EAAE,SAAS,KAAK,IAAI;CAC9E,IAAI,CAAC,cAAc,SAAS,WAAW,QAAQ,KAAK,UAAU,GAC7D;CAED,MAAM,SACL,KAAK,UAAU;CAChB,MAAM,IAAI,MACT,cAAc,KAAK,OAAO,IAAI,KAAK,WAAW,sBAAsB,KAAK,KAAK,IAAI,QACnF;AACD"}
@@ -0,0 +1,33 @@
1
+ import { requestMemo } from "./requestMemo.js";
2
+ import { getRuntime, resolveScopeFor } from "./runtime.js";
3
+ import { createHmac } from "node:crypto";
4
+ //#region src/plugin/scopeToken.ts
5
+ /** Stands in for a scope the host's resolver could not answer, which is a scope of its own. */
6
+ const UNRESOLVED = "\0unresolved";
7
+ const tokens = requestMemo("scopeToken");
8
+ const tokenKey = (secret) => createHmac("sha256", secret).update("@10x-media/analytics:request-scope").digest();
9
+ /**
10
+ * Opaque HMAC of user and `scope.resolve` answer for admin reads, computed server-side so a tenant
11
+ * in an HttpOnly cookie or proxy header still changes it. Never throws.
12
+ */
13
+ const requestScopeToken = async (req) => {
14
+ const runtime = getRuntime(req.payload);
15
+ const { user } = req;
16
+ if (!runtime || !user) return;
17
+ return tokens(req, {
18
+ owner: runtime,
19
+ key: "token",
20
+ compute: async () => {
21
+ const scope = runtime.resolveScope ? await resolveScopeFor(runtime, req).catch(() => UNRESOLVED) : null;
22
+ return createHmac("sha256", tokenKey(req.payload.secret)).update(JSON.stringify([
23
+ String(user.collection),
24
+ String(user.id),
25
+ scope
26
+ ])).digest("base64url");
27
+ }
28
+ }).catch(() => void 0);
29
+ };
30
+ //#endregion
31
+ export { requestScopeToken };
32
+
33
+ //# sourceMappingURL=scopeToken.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scopeToken.js","names":[],"sources":["../../src/plugin/scopeToken.ts"],"sourcesContent":["import { createHmac } from 'node:crypto'\nimport type { PayloadRequest } from 'payload'\nimport { requestMemo } from './requestMemo'\nimport { getRuntime, resolveScopeFor } from './runtime'\n\n/** Stands in for a scope the host's resolver could not answer, which is a scope of its own. */\nconst UNRESOLVED = '\\u0000unresolved'\n\nconst tokens = requestMemo<string | undefined>('scopeToken')\n\nconst tokenKey = (secret: string): Buffer =>\n\tcreateHmac('sha256', secret).update('@10x-media/analytics:request-scope').digest()\n\n/**\n * Opaque HMAC of user and `scope.resolve` answer for admin reads, computed server-side so a tenant\n * in an HttpOnly cookie or proxy header still changes it. Never throws.\n */\nexport const requestScopeToken = async (req: PayloadRequest): Promise<string | undefined> => {\n\tconst runtime = getRuntime(req.payload)\n\tconst { user } = req\n\tif (!runtime || !user) {\n\t\treturn undefined\n\t}\n\treturn tokens(req, {\n\t\towner: runtime,\n\t\tkey: 'token',\n\t\tcompute: async () => {\n\t\t\tconst scope = runtime.resolveScope\n\t\t\t\t? await resolveScopeFor(runtime, req).catch(() => UNRESOLVED)\n\t\t\t\t: null\n\t\t\treturn createHmac('sha256', tokenKey(req.payload.secret))\n\t\t\t\t.update(JSON.stringify([String(user.collection), String(user.id), scope]))\n\t\t\t\t.digest('base64url')\n\t\t},\n\t}).catch(() => undefined)\n}\n"],"mappings":";;;;;AAMA,MAAM,aAAa;AAEnB,MAAM,SAAS,YAAgC,YAAY;AAE3D,MAAM,YAAY,WACjB,WAAW,UAAU,MAAM,EAAE,OAAO,oCAAoC,EAAE,OAAO;;;;;AAMlF,MAAa,oBAAoB,OAAO,QAAqD;CAC5F,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,EAAE,SAAS;CACjB,IAAI,CAAC,WAAW,CAAC,MAChB;CAED,OAAO,OAAO,KAAK;EAClB,OAAO;EACP,KAAK;EACL,SAAS,YAAY;GACpB,MAAM,QAAQ,QAAQ,eACnB,MAAM,gBAAgB,SAAS,GAAG,EAAE,YAAY,UAAU,IAC1D;GACH,OAAO,WAAW,UAAU,SAAS,IAAI,QAAQ,MAAM,CAAC,EACtD,OAAO,KAAK,UAAU;IAAC,OAAO,KAAK,UAAU;IAAG,OAAO,KAAK,EAAE;IAAG;GAAK,CAAC,CAAC,EACxE,OAAO,WAAW;EACrB;CACD,CAAC,EAAE,YAAY,KAAA,CAAS;AACzB"}