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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1273) hide show
  1. package/CHANGELOG.md +780 -0
  2. package/LICENSE +21 -21
  3. package/README.md +35 -36
  4. package/dist/access/adminUser.d.ts +15 -0
  5. package/dist/access/adminUser.js +13 -0
  6. package/dist/access/adminUser.js.map +1 -0
  7. package/dist/access/decideOnce.js +16 -0
  8. package/dist/access/decideOnce.js.map +1 -0
  9. package/dist/access/membership.d.ts +23 -0
  10. package/dist/access/membership.js +63 -0
  11. package/dist/access/membership.js.map +1 -0
  12. package/dist/access/principal.d.ts +37 -0
  13. package/dist/access/principal.js +29 -0
  14. package/dist/access/principal.js.map +1 -0
  15. package/dist/access/readGate.js +16 -0
  16. package/dist/access/readGate.js.map +1 -0
  17. package/dist/adapters/ga4/disableKey.js +19 -0
  18. package/dist/adapters/ga4/disableKey.js.map +1 -0
  19. package/dist/adapters/ga4/eventName.d.ts +9 -0
  20. package/dist/adapters/ga4/eventName.js +13 -0
  21. package/dist/adapters/ga4/eventName.js.map +1 -0
  22. package/dist/adapters/ga4/ga4.d.ts +29 -0
  23. package/dist/adapters/ga4/ga4.js +324 -112
  24. package/dist/adapters/ga4/ga4.js.map +1 -1
  25. package/dist/adapters/ga4/measurementId.js +14 -0
  26. package/dist/adapters/ga4/measurementId.js.map +1 -0
  27. package/dist/adapters/goalRead.js +112 -0
  28. package/dist/adapters/goalRead.js.map +1 -0
  29. package/dist/adapters/http/baseUrl.js +15 -0
  30. package/dist/adapters/http/baseUrl.js.map +1 -0
  31. package/dist/adapters/http/fetchJson.d.ts +19 -0
  32. package/dist/adapters/http/fetchJson.js +27 -8
  33. package/dist/adapters/http/fetchJson.js.map +1 -1
  34. package/dist/adapters/mapping.js +52 -0
  35. package/dist/adapters/mapping.js.map +1 -0
  36. package/dist/adapters/plausible/plausible.d.ts +30 -3
  37. package/dist/adapters/plausible/plausible.js +198 -110
  38. package/dist/adapters/plausible/plausible.js.map +1 -1
  39. package/dist/adapters/plausible/scriptId.js +19 -0
  40. package/dist/adapters/plausible/scriptId.js.map +1 -0
  41. package/dist/adapters/posthog/posthog.d.ts +33 -9
  42. package/dist/adapters/posthog/posthog.js +307 -127
  43. package/dist/adapters/posthog/posthog.js.map +1 -1
  44. package/dist/adapters/posthog/projectCheck.js +56 -0
  45. package/dist/adapters/posthog/projectCheck.js.map +1 -0
  46. package/dist/adapters/readTime.js +7 -0
  47. package/dist/adapters/readTime.js.map +1 -0
  48. package/dist/adapters/series.js +14 -8
  49. package/dist/adapters/series.js.map +1 -1
  50. package/dist/adapters/umami/umami.d.ts +21 -3
  51. package/dist/adapters/umami/umami.js +334 -95
  52. package/dist/adapters/umami/umami.js.map +1 -1
  53. package/dist/adapters/upstream.js +16 -0
  54. package/dist/adapters/upstream.js.map +1 -0
  55. package/dist/binding/report.d.ts +8 -0
  56. package/dist/binding/report.js +24 -0
  57. package/dist/binding/report.js.map +1 -0
  58. package/dist/binding/resolvePath.js +28 -25
  59. package/dist/binding/resolvePath.js.map +1 -1
  60. package/dist/binding/types.d.ts +14 -29
  61. package/dist/capture/captureRequest.js +28 -0
  62. package/dist/capture/captureRequest.js.map +1 -0
  63. package/dist/capture/exclusionEndpoint.js +98 -0
  64. package/dist/capture/exclusionEndpoint.js.map +1 -0
  65. package/dist/capture/exclusionPrelude.js +14 -0
  66. package/dist/capture/exclusionPrelude.js.map +1 -0
  67. package/dist/capture/exclusionToken.js +23 -0
  68. package/dist/capture/exclusionToken.js.map +1 -0
  69. package/dist/capture/jsLiteral.js +19 -0
  70. package/dist/capture/jsLiteral.js.map +1 -0
  71. package/dist/capture/mountPath.js +2 -3
  72. package/dist/capture/mountPath.js.map +1 -1
  73. package/dist/capture/proxyEndpoint.js +49 -92
  74. package/dist/capture/proxyEndpoint.js.map +1 -1
  75. package/dist/capture/proxyRoutes.js +58 -21
  76. package/dist/capture/proxyRoutes.js.map +1 -1
  77. package/dist/capture/relay.js +91 -0
  78. package/dist/capture/relay.js.map +1 -0
  79. package/dist/capture/requestBody.js +2 -6
  80. package/dist/capture/requestBody.js.map +1 -1
  81. package/dist/capture/requestTrust.js +45 -0
  82. package/dist/capture/requestTrust.js.map +1 -0
  83. package/dist/capture/sameSite.js +40 -0
  84. package/dist/capture/sameSite.js.map +1 -0
  85. package/dist/capture/slots.js +50 -25
  86. package/dist/capture/slots.js.map +1 -1
  87. package/dist/capture/trackerConfig.js +131 -36
  88. package/dist/capture/trackerConfig.js.map +1 -1
  89. package/dist/capture/trackerEndpoint.js +22 -21
  90. package/dist/capture/trackerEndpoint.js.map +1 -1
  91. package/dist/capture/withoutConsent.js +91 -0
  92. package/dist/capture/withoutConsent.js.map +1 -0
  93. package/dist/charts/BarList.d.ts +27 -13
  94. package/dist/charts/BarList.js +38 -77
  95. package/dist/charts/BarList.js.map +1 -1
  96. package/dist/charts/TrendChart.d.ts +40 -7
  97. package/dist/charts/TrendChart.js +243 -215
  98. package/dist/charts/TrendChart.js.map +1 -1
  99. package/dist/charts/bars.d.ts +17 -1
  100. package/dist/charts/bars.js +12 -11
  101. package/dist/charts/bars.js.map +1 -1
  102. package/dist/charts/bucket.js +106 -73
  103. package/dist/charts/bucket.js.map +1 -1
  104. package/dist/charts/inProgress.js +22 -0
  105. package/dist/charts/inProgress.js.map +1 -0
  106. package/dist/charts/series.d.ts +15 -0
  107. package/dist/charts/series.js +123 -0
  108. package/dist/charts/series.js.map +1 -0
  109. package/dist/charts/spline.js +91 -25
  110. package/dist/charts/spline.js.map +1 -1
  111. package/dist/charts/trendGeometry.js +91 -0
  112. package/dist/charts/trendGeometry.js.map +1 -0
  113. package/dist/core/adminOptions.d.ts +1 -0
  114. package/dist/core/adminOptions.js +198 -0
  115. package/dist/core/adminOptions.js.map +1 -0
  116. package/dist/core/budget.js +24 -0
  117. package/dist/core/budget.js.map +1 -0
  118. package/dist/core/cacheKey.d.ts +1 -0
  119. package/dist/core/cacheKey.js +51 -29
  120. package/dist/core/cacheKey.js.map +1 -1
  121. package/dist/core/cacheOptions.js +165 -0
  122. package/dist/core/cacheOptions.js.map +1 -0
  123. package/dist/core/capabilities.d.ts +24 -11
  124. package/dist/core/capabilities.js +101 -17
  125. package/dist/core/capabilities.js.map +1 -1
  126. package/dist/core/capture.d.ts +59 -26
  127. package/dist/core/captureOptions.d.ts +1 -0
  128. package/dist/core/captureOptions.js +347 -0
  129. package/dist/core/captureOptions.js.map +1 -0
  130. package/dist/core/clock.js +13 -0
  131. package/dist/core/clock.js.map +1 -0
  132. package/dist/core/collectionOption.d.ts +17 -0
  133. package/dist/core/collectionOption.js +105 -0
  134. package/dist/core/collectionOption.js.map +1 -0
  135. package/dist/core/collectionSlug.js +7 -0
  136. package/dist/core/collectionSlug.js.map +1 -0
  137. package/dist/core/contract.d.ts +340 -49
  138. package/dist/core/contract.js +7 -4
  139. package/dist/core/contract.js.map +1 -1
  140. package/dist/core/cron.js +57 -0
  141. package/dist/core/cron.js.map +1 -0
  142. package/dist/core/fetch.d.ts +17 -0
  143. package/dist/core/goalOptions.d.ts +1 -0
  144. package/dist/core/goalOptions.js +166 -0
  145. package/dist/core/goalOptions.js.map +1 -0
  146. package/dist/core/granularity.js +3 -2
  147. package/dist/core/granularity.js.map +1 -1
  148. package/dist/core/guards.js +17 -0
  149. package/dist/core/guards.js.map +1 -0
  150. package/dist/core/jobs.d.ts +40 -0
  151. package/dist/core/jobs.js +132 -0
  152. package/dist/core/jobs.js.map +1 -0
  153. package/dist/core/legacyOptions.js +145 -0
  154. package/dist/core/legacyOptions.js.map +1 -0
  155. package/dist/core/metricAliases.js +81 -0
  156. package/dist/core/metricAliases.js.map +1 -0
  157. package/dist/core/metricValues.js +57 -0
  158. package/dist/core/metricValues.js.map +1 -0
  159. package/dist/core/monotonic.js +10 -0
  160. package/dist/core/monotonic.js.map +1 -0
  161. package/dist/core/optionChecks.js +51 -0
  162. package/dist/core/optionChecks.js.map +1 -0
  163. package/dist/core/options.d.ts +535 -151
  164. package/dist/core/options.js +158 -214
  165. package/dist/core/options.js.map +1 -1
  166. package/dist/core/registry.js +45 -5
  167. package/dist/core/registry.js.map +1 -1
  168. package/dist/core/scopeList.js +7 -9
  169. package/dist/core/scopeList.js.map +1 -1
  170. package/dist/core/scopeOptions.d.ts +1 -0
  171. package/dist/core/scopeOptions.js +114 -0
  172. package/dist/core/scopeOptions.js.map +1 -0
  173. package/dist/core/scopedRead.js +349 -36
  174. package/dist/core/scopedRead.js.map +1 -1
  175. package/dist/core/sdks.d.ts +81 -0
  176. package/dist/core/sdks.js +23 -0
  177. package/dist/core/sdks.js.map +1 -0
  178. package/dist/core/serverEvent.d.ts +50 -14
  179. package/dist/core/serverEvent.js.map +1 -1
  180. package/dist/core/siteAddress.js +20 -0
  181. package/dist/core/siteAddress.js.map +1 -0
  182. package/dist/core/sourceErrors.js +109 -0
  183. package/dist/core/sourceErrors.js.map +1 -0
  184. package/dist/core/sourceLabel.d.ts +10 -0
  185. package/dist/core/sourceLabel.js +63 -0
  186. package/dist/core/sourceLabel.js.map +1 -0
  187. package/dist/core/sourceOptions.js +107 -0
  188. package/dist/core/sourceOptions.js.map +1 -0
  189. package/dist/core/sourcePolicy.d.ts +55 -0
  190. package/dist/core/sourcePolicy.js +51 -0
  191. package/dist/core/sourcePolicy.js.map +1 -0
  192. package/dist/core/throttle.js +18 -0
  193. package/dist/core/throttle.js.map +1 -0
  194. package/dist/core/values.js +61 -0
  195. package/dist/core/values.js.map +1 -0
  196. package/dist/core/widgetSlugs.d.ts +17 -0
  197. package/dist/core/widgetSlugs.js +29 -0
  198. package/dist/core/widgetSlugs.js.map +1 -0
  199. package/dist/db/detachedWrite.js +36 -0
  200. package/dist/db/detachedWrite.js.map +1 -0
  201. package/dist/db/errors.js +182 -0
  202. package/dist/db/errors.js.map +1 -0
  203. package/dist/db/kind.js +32 -0
  204. package/dist/db/kind.js.map +1 -0
  205. package/dist/db/openTransaction.js +51 -0
  206. package/dist/db/openTransaction.js.map +1 -0
  207. package/dist/exports/adapters/contract.d.ts +15 -0
  208. package/dist/exports/adapters/ga4.d.ts +17 -1
  209. package/dist/exports/adapters/ga4.js +2 -1
  210. package/dist/exports/adapters/native.d.ts +29 -2
  211. package/dist/exports/adapters/native.js +5 -1
  212. package/dist/exports/adapters/plausible.d.ts +16 -1
  213. package/dist/exports/adapters/posthog.d.ts +16 -1
  214. package/dist/exports/adapters/umami.d.ts +16 -1
  215. package/dist/exports/attributes.d.ts +42 -0
  216. package/dist/exports/attributes.js +83 -0
  217. package/dist/exports/attributes.js.map +1 -0
  218. package/dist/exports/client.d.ts +45 -11
  219. package/dist/exports/client.js +23 -6
  220. package/dist/exports/geo.d.ts +4 -2
  221. package/dist/exports/geo.js +1 -1
  222. package/dist/exports/i18n.d.ts +2 -2
  223. package/dist/exports/i18n.js +2 -2
  224. package/dist/exports/migrations.d.ts +2 -0
  225. package/dist/exports/migrations.js +2 -0
  226. package/dist/exports/react.d.ts +5 -3
  227. package/dist/exports/react.js +1 -2
  228. package/dist/exports/routes.d.ts +19 -0
  229. package/dist/exports/routes.js +3 -0
  230. package/dist/exports/rsc.d.ts +33 -14
  231. package/dist/exports/rsc.js +11 -6
  232. package/dist/exports/site.d.ts +5 -0
  233. package/dist/exports/site.js +3 -0
  234. package/dist/exports/testing.d.ts +18 -0
  235. package/dist/exports/testing.js +3 -0
  236. package/dist/exports/tracker.d.ts +6 -17
  237. package/dist/exports/tracker.js +3 -11
  238. package/dist/exports/types.d.ts +46 -14
  239. package/dist/exports/types.js +7 -1
  240. package/dist/fields/AnalyticsPanelClient.js +265 -154
  241. package/dist/fields/AnalyticsPanelClient.js.map +1 -1
  242. package/dist/fields/AnalyticsPanelField.d.ts +19 -7
  243. package/dist/fields/AnalyticsPanelField.js +123 -30
  244. package/dist/fields/AnalyticsPanelField.js.map +1 -1
  245. package/dist/fields/AnalyticsStatField.d.ts +17 -6
  246. package/dist/fields/AnalyticsStatField.js +98 -63
  247. package/dist/fields/AnalyticsStatField.js.map +1 -1
  248. package/dist/fields/FieldShimmer.js +15 -0
  249. package/dist/fields/FieldShimmer.js.map +1 -0
  250. package/dist/fields/PanelContent.js +222 -0
  251. package/dist/fields/PanelContent.js.map +1 -0
  252. package/dist/fields/PanelList.js +82 -0
  253. package/dist/fields/PanelList.js.map +1 -0
  254. package/dist/fields/PanelLiveCounter.js +63 -0
  255. package/dist/fields/PanelLiveCounter.js.map +1 -0
  256. package/dist/fields/PanelSkeleton.js +63 -0
  257. package/dist/fields/PanelSkeleton.js.map +1 -0
  258. package/dist/fields/componentPaths.js +8 -0
  259. package/dist/fields/componentPaths.js.map +1 -0
  260. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  261. package/dist/fields/config/FilterDimensionSelectField.js +49 -0
  262. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  263. package/dist/fields/config/FilterKeySelect.js +66 -0
  264. package/dist/fields/config/FilterKeySelect.js.map +1 -0
  265. package/dist/fields/config/FilterOperatorSelectField.d.ts +19 -0
  266. package/dist/fields/config/FilterOperatorSelectField.js +59 -0
  267. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  268. package/dist/fields/config/FilterValueField.d.ts +17 -0
  269. package/dist/fields/config/FilterValueField.js +130 -0
  270. package/dist/fields/config/FilterValueField.js.map +1 -0
  271. package/dist/fields/config/MetricSelectField.d.ts +5 -12
  272. package/dist/fields/config/MetricSelectField.js +19 -31
  273. package/dist/fields/config/MetricSelectField.js.map +1 -1
  274. package/dist/fields/config/OptionSelect.js +52 -0
  275. package/dist/fields/config/OptionSelect.js.map +1 -0
  276. package/dist/fields/config/SourceSelectField.js +16 -31
  277. package/dist/fields/config/SourceSelectField.js.map +1 -1
  278. package/dist/fields/config/fetchSources.d.ts +3 -0
  279. package/dist/fields/config/fetchSources.js +17 -23
  280. package/dist/fields/config/fetchSources.js.map +1 -1
  281. package/dist/fields/config/filterValues.js +106 -0
  282. package/dist/fields/config/filterValues.js.map +1 -0
  283. package/dist/fields/config/narrow.js +8 -10
  284. package/dist/fields/config/narrow.js.map +1 -1
  285. package/dist/fields/config/retiredPickers.d.ts +45 -0
  286. package/dist/fields/config/retiredPickers.js +46 -0
  287. package/dist/fields/config/retiredPickers.js.map +1 -0
  288. package/dist/fields/config/scopedFields.d.ts +40 -0
  289. package/dist/fields/config/scopedFields.js +68 -0
  290. package/dist/fields/config/scopedFields.js.map +1 -0
  291. package/dist/fields/config/sourcesState.js +19 -3
  292. package/dist/fields/config/sourcesState.js.map +1 -1
  293. package/dist/fields/config/toSelectOption.js +13 -7
  294. package/dist/fields/config/toSelectOption.js.map +1 -1
  295. package/dist/fields/config/useAnalyticsSources.d.ts +10 -7
  296. package/dist/fields/config/useAnalyticsSources.js +23 -24
  297. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  298. package/dist/fields/config/useFilterCapabilities.d.ts +31 -0
  299. package/dist/fields/config/useFilterCapabilities.js +60 -0
  300. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  301. package/dist/fields/config/useFormString.js +12 -0
  302. package/dist/fields/config/useFormString.js.map +1 -0
  303. package/dist/fields/dateRange/field.js +7 -19
  304. package/dist/fields/dateRange/field.js.map +1 -1
  305. package/dist/fields/dateRange/types.d.ts +5 -1
  306. package/dist/fields/dateRange/ui.d.ts +3 -2
  307. package/dist/fields/dateRange/ui.js +57 -319
  308. package/dist/fields/dateRange/ui.js.map +1 -1
  309. package/dist/fields/documentScope.js +21 -0
  310. package/dist/fields/documentScope.js.map +1 -0
  311. package/dist/fields/emptyState.js +30 -26
  312. package/dist/fields/emptyState.js.map +1 -1
  313. package/dist/fields/factories.d.ts +35 -16
  314. package/dist/fields/factories.js +67 -38
  315. package/dist/fields/factories.js.map +1 -1
  316. package/dist/fields/format.d.ts +12 -3
  317. package/dist/fields/format.js +77 -13
  318. package/dist/fields/format.js.map +1 -1
  319. package/dist/fields/itemReport.js +45 -0
  320. package/dist/fields/itemReport.js.map +1 -0
  321. package/dist/fields/readForDocument.d.ts +79 -26
  322. package/dist/fields/readForDocument.js +451 -105
  323. package/dist/fields/readForDocument.js.map +1 -1
  324. package/dist/fields/stateKeys.js +20 -0
  325. package/dist/fields/stateKeys.js.map +1 -0
  326. package/dist/goals/GoalAmountField.d.ts +10 -0
  327. package/dist/goals/GoalAmountField.js +179 -0
  328. package/dist/goals/GoalAmountField.js.map +1 -0
  329. package/dist/goals/GoalSelectField.js +89 -40
  330. package/dist/goals/GoalSelectField.js.map +1 -1
  331. package/dist/goals/GoalSelectFieldServer.d.ts +13 -0
  332. package/dist/goals/GoalSelectFieldServer.js +21 -0
  333. package/dist/goals/GoalSelectFieldServer.js.map +1 -0
  334. package/dist/goals/amountField.d.ts +20 -0
  335. package/dist/goals/amountField.js +37 -0
  336. package/dist/goals/amountField.js.map +1 -0
  337. package/dist/goals/builtin.js +17 -0
  338. package/dist/goals/builtin.js.map +1 -0
  339. package/dist/goals/collection.d.ts +22 -0
  340. package/dist/goals/collection.js +143 -124
  341. package/dist/goals/collection.js.map +1 -1
  342. package/dist/goals/constants.d.ts +38 -0
  343. package/dist/goals/constants.js +49 -0
  344. package/dist/goals/constants.js.map +1 -0
  345. package/dist/goals/currency.d.ts +16 -0
  346. package/dist/goals/currency.js +46 -4
  347. package/dist/goals/currency.js.map +1 -1
  348. package/dist/goals/currencyOptions.js +70 -0
  349. package/dist/goals/currencyOptions.js.map +1 -0
  350. package/dist/goals/fetchGoals.d.ts +10 -0
  351. package/dist/goals/fetchGoals.js +12 -22
  352. package/dist/goals/fetchGoals.js.map +1 -1
  353. package/dist/goals/goalField.d.ts +4 -6
  354. package/dist/goals/goalField.js +9 -19
  355. package/dist/goals/goalField.js.map +1 -1
  356. package/dist/goals/goalsEndpoint.js +40 -38
  357. package/dist/goals/goalsEndpoint.js.map +1 -1
  358. package/dist/goals/items.js +35 -0
  359. package/dist/goals/items.js.map +1 -0
  360. package/dist/goals/latent.js +9 -0
  361. package/dist/goals/latent.js.map +1 -0
  362. package/dist/goals/linkFields.d.ts +35 -0
  363. package/dist/goals/linkFields.js +31 -0
  364. package/dist/goals/linkFields.js.map +1 -0
  365. package/dist/goals/match.d.ts +14 -0
  366. package/dist/goals/match.js +67 -46
  367. package/dist/goals/match.js.map +1 -1
  368. package/dist/goals/moneyFields.js +56 -0
  369. package/dist/goals/moneyFields.js.map +1 -0
  370. package/dist/goals/pathMatch.js +122 -0
  371. package/dist/goals/pathMatch.js.map +1 -0
  372. package/dist/goals/placeholder.js +12 -0
  373. package/dist/goals/placeholder.js.map +1 -0
  374. package/dist/goals/resolver.d.ts +3 -3
  375. package/dist/goals/resolver.js +155 -47
  376. package/dist/goals/resolver.js.map +1 -1
  377. package/dist/goals/serverRevenue.d.ts +60 -0
  378. package/dist/goals/serverRevenue.js +41 -0
  379. package/dist/goals/serverRevenue.js.map +1 -0
  380. package/dist/goals/trackGoalAction.d.ts +26 -25
  381. package/dist/goals/trackGoalAction.js +71 -66
  382. package/dist/goals/trackGoalAction.js.map +1 -1
  383. package/dist/goals/types.d.ts +13 -28
  384. package/dist/goals/types.js +1 -1
  385. package/dist/goals/types.js.map +1 -1
  386. package/dist/goals/useAnalyticsGoals.d.ts +6 -5
  387. package/dist/goals/useAnalyticsGoals.js +17 -18
  388. package/dist/goals/useAnalyticsGoals.js.map +1 -1
  389. package/dist/index.d.ts +69 -11
  390. package/dist/index.js +262 -192
  391. package/dist/index.js.map +1 -1
  392. package/dist/items/collectionIdType.js +20 -0
  393. package/dist/items/collectionIdType.js.map +1 -0
  394. package/dist/items/idType.js +31 -0
  395. package/dist/items/idType.js.map +1 -0
  396. package/dist/items/ref.js +73 -0
  397. package/dist/items/ref.js.map +1 -0
  398. package/dist/maintenance/apiTaskState.js +141 -0
  399. package/dist/maintenance/apiTaskState.js.map +1 -0
  400. package/dist/maintenance/heartbeat.js +51 -0
  401. package/dist/maintenance/heartbeat.js.map +1 -0
  402. package/dist/maintenance/lease.d.ts +1 -0
  403. package/dist/maintenance/lease.js +79 -0
  404. package/dist/maintenance/lease.js.map +1 -0
  405. package/dist/maintenance/taskSchedule.js +27 -0
  406. package/dist/maintenance/taskSchedule.js.map +1 -0
  407. package/dist/maintenance/underLease.js +35 -0
  408. package/dist/maintenance/underLease.js.map +1 -0
  409. package/dist/migrations/legacy.d.ts +54 -0
  410. package/dist/migrations/legacy.js +117 -0
  411. package/dist/migrations/legacy.js.map +1 -0
  412. package/dist/migrations/predefined/dropLegacyMongo.d.ts +11 -0
  413. package/dist/migrations/predefined/dropLegacyMongo.js +12 -0
  414. package/dist/migrations/predefined/dropLegacyMongo.js.map +1 -0
  415. package/dist/native/collections/aggregates.js +54 -0
  416. package/dist/native/collections/aggregates.js.map +1 -0
  417. package/dist/native/collections/hits.js +103 -0
  418. package/dist/native/collections/hits.js.map +1 -0
  419. package/dist/native/collections/slugs.d.ts +10 -0
  420. package/dist/native/collections/slugs.js +16 -0
  421. package/dist/native/collections/slugs.js.map +1 -0
  422. package/dist/native/collections/state.js +84 -0
  423. package/dist/native/collections/state.js.map +1 -0
  424. package/dist/native/collections/storeCollection.js +31 -0
  425. package/dist/native/collections/storeCollection.js.map +1 -0
  426. package/dist/native/engine/buckets.d.ts +1 -0
  427. package/dist/native/engine/buckets.js +53 -0
  428. package/dist/native/engine/buckets.js.map +1 -0
  429. package/dist/native/engine/capabilities.js +87 -0
  430. package/dist/native/engine/capabilities.js.map +1 -0
  431. package/dist/native/engine/cost.js +72 -0
  432. package/dist/native/engine/cost.js.map +1 -0
  433. package/dist/native/engine/days.d.ts +1 -0
  434. package/dist/native/engine/days.js +182 -0
  435. package/dist/native/engine/days.js.map +1 -0
  436. package/dist/native/engine/engine.d.ts +1 -0
  437. package/dist/native/engine/engine.js +1627 -0
  438. package/dist/native/engine/engine.js.map +1 -0
  439. package/dist/native/engine/instance.js +58 -0
  440. package/dist/native/engine/instance.js.map +1 -0
  441. package/dist/native/engine/maintenance.d.ts +1 -0
  442. package/dist/native/engine/maintenance.js +677 -0
  443. package/dist/native/engine/maintenance.js.map +1 -0
  444. package/dist/native/engine/merge.js +41 -0
  445. package/dist/native/engine/merge.js.map +1 -0
  446. package/dist/native/engine/nudge.js +26 -0
  447. package/dist/native/engine/nudge.js.map +1 -0
  448. package/dist/native/engine/planner.js +199 -0
  449. package/dist/native/engine/planner.js.map +1 -0
  450. package/dist/native/engine/rebuild.d.ts +22 -0
  451. package/dist/native/engine/rebuild.js +76 -0
  452. package/dist/native/engine/rebuild.js.map +1 -0
  453. package/dist/native/engine/recent.js +17 -0
  454. package/dist/native/engine/recent.js.map +1 -0
  455. package/dist/native/engine/salt.d.ts +1 -0
  456. package/dist/native/engine/salt.js +98 -0
  457. package/dist/native/engine/salt.js.map +1 -0
  458. package/dist/native/engine/siteHosts.d.ts +1 -0
  459. package/dist/native/engine/siteHosts.js +58 -0
  460. package/dist/native/engine/siteHosts.js.map +1 -0
  461. package/dist/native/engine/toHit.js +110 -0
  462. package/dist/native/engine/toHit.js.map +1 -0
  463. package/dist/native/engine/writeBuffer.d.ts +14 -0
  464. package/dist/native/engine/writeBuffer.js +317 -0
  465. package/dist/native/engine/writeBuffer.js.map +1 -0
  466. package/dist/native/geo/composeGeoResolvers.d.ts +1 -0
  467. package/dist/native/geo/composeGeoResolvers.js +5 -2
  468. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  469. package/dist/native/geo/geoResolver.d.ts +27 -2
  470. package/dist/native/geo/geoResolver.js +42 -6
  471. package/dist/native/geo/geoResolver.js.map +1 -1
  472. package/dist/native/geo/maxmindResolver.d.ts +8 -4
  473. package/dist/native/geo/maxmindResolver.js +20 -16
  474. package/dist/native/geo/maxmindResolver.js.map +1 -1
  475. package/dist/native/geo/resolveGeo.js +31 -0
  476. package/dist/native/geo/resolveGeo.js.map +1 -0
  477. package/dist/native/ingest/bots.d.ts +10 -0
  478. package/dist/native/ingest/bots.js +66 -0
  479. package/dist/native/ingest/bots.js.map +1 -0
  480. package/dist/native/ingest/browser.js +45 -0
  481. package/dist/native/ingest/browser.js.map +1 -0
  482. package/dist/native/ingest/clientIp.js +34 -8
  483. package/dist/native/ingest/clientIp.js.map +1 -1
  484. package/dist/native/ingest/device.js +4 -6
  485. package/dist/native/ingest/device.js.map +1 -1
  486. package/dist/native/ingest/endpoint.d.ts +1 -1
  487. package/dist/native/ingest/endpoint.js +185 -32
  488. package/dist/native/ingest/endpoint.js.map +1 -1
  489. package/dist/native/ingest/itemSignature.d.ts +26 -0
  490. package/dist/native/ingest/itemSignature.js +45 -0
  491. package/dist/native/ingest/itemSignature.js.map +1 -0
  492. package/dist/native/ingest/language.js +13 -0
  493. package/dist/native/ingest/language.js.map +1 -0
  494. package/dist/native/ingest/normalizeEvent.d.ts +73 -5
  495. package/dist/native/ingest/normalizeEvent.js +257 -51
  496. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  497. package/dist/native/ingest/orderSignature.d.ts +13 -0
  498. package/dist/native/ingest/orderSignature.js +50 -0
  499. package/dist/native/ingest/orderSignature.js.map +1 -0
  500. package/dist/native/ingest/referrer.js +46 -0
  501. package/dist/native/ingest/referrer.js.map +1 -0
  502. package/dist/native/ingest/requestHost.js +44 -0
  503. package/dist/native/ingest/requestHost.js.map +1 -0
  504. package/dist/native/ingest/resolveHostname.d.ts +20 -0
  505. package/dist/native/ingest/resolveHostname.js +51 -0
  506. package/dist/native/ingest/resolveHostname.js.map +1 -0
  507. package/dist/native/ingest/revenue.d.ts +1 -0
  508. package/dist/native/ingest/revenue.js +121 -0
  509. package/dist/native/ingest/revenue.js.map +1 -0
  510. package/dist/native/ingest/route.d.ts +10 -0
  511. package/dist/native/ingest/route.js +85 -0
  512. package/dist/native/ingest/route.js.map +1 -0
  513. package/dist/native/ingest/serverTrack.d.ts +2 -10
  514. package/dist/native/ingest/serverTrack.js +188 -68
  515. package/dist/native/ingest/serverTrack.js.map +1 -1
  516. package/dist/native/ingest/signature.js +28 -0
  517. package/dist/native/ingest/signature.js.map +1 -0
  518. package/dist/native/ingest/source.d.ts +10 -0
  519. package/dist/native/ingest/source.js +245 -16
  520. package/dist/native/ingest/source.js.map +1 -1
  521. package/dist/native/ingest/utm.js +33 -0
  522. package/dist/native/ingest/utm.js.map +1 -0
  523. package/dist/native/ingest/validate.js +25 -13
  524. package/dist/native/ingest/validate.js.map +1 -1
  525. package/dist/native/ingest/visitorHash.js +6 -8
  526. package/dist/native/ingest/visitorHash.js.map +1 -1
  527. package/dist/native/nativeAdapter.d.ts +128 -9
  528. package/dist/native/nativeAdapter.js +395 -281
  529. package/dist/native/nativeAdapter.js.map +1 -1
  530. package/dist/native/rebuildDays.d.ts +12 -0
  531. package/dist/native/rebuildDays.js +16 -0
  532. package/dist/native/rebuildDays.js.map +1 -0
  533. package/dist/native/store/aggregate.js +450 -0
  534. package/dist/native/store/aggregate.js.map +1 -0
  535. package/dist/native/store/caps.d.ts +18 -0
  536. package/dist/native/store/caps.js +76 -0
  537. package/dist/native/store/caps.js.map +1 -0
  538. package/dist/native/store/chunks.js +34 -0
  539. package/dist/native/store/chunks.js.map +1 -0
  540. package/dist/native/store/columnValues.js +31 -0
  541. package/dist/native/store/columnValues.js.map +1 -0
  542. package/dist/native/store/dialect.js +106 -0
  543. package/dist/native/store/dialect.js.map +1 -0
  544. package/dist/native/store/eventStore.js +44 -0
  545. package/dist/native/store/eventStore.js.map +1 -0
  546. package/dist/native/store/hitRow.js +119 -0
  547. package/dist/native/store/hitRow.js.map +1 -0
  548. package/dist/native/store/hits.js +65 -0
  549. package/dist/native/store/hits.js.map +1 -0
  550. package/dist/native/store/ids.js +105 -0
  551. package/dist/native/store/ids.js.map +1 -0
  552. package/dist/native/store/mongo/aggregatePipelines.js +438 -0
  553. package/dist/native/store/mongo/aggregatePipelines.js.map +1 -0
  554. package/dist/native/store/mongo/mongoState.js +375 -0
  555. package/dist/native/store/mongo/mongoState.js.map +1 -0
  556. package/dist/native/store/mongo/mongoStore.js +618 -0
  557. package/dist/native/store/mongo/mongoStore.js.map +1 -0
  558. package/dist/native/store/mongo/pipelines.js +705 -0
  559. package/dist/native/store/mongo/pipelines.js.map +1 -0
  560. package/dist/native/store/mongo/results.js +20 -0
  561. package/dist/native/store/mongo/results.js.map +1 -0
  562. package/dist/native/store/parts.d.ts +1 -0
  563. package/dist/native/store/parts.js +101 -0
  564. package/dist/native/store/parts.js.map +1 -0
  565. package/dist/native/store/pattern.js +213 -0
  566. package/dist/native/store/pattern.js.map +1 -0
  567. package/dist/native/store/rawRead.d.ts +23 -0
  568. package/dist/native/store/rawRead.js +387 -0
  569. package/dist/native/store/rawRead.js.map +1 -0
  570. package/dist/native/store/reclassify.js +53 -0
  571. package/dist/native/store/reclassify.js.map +1 -0
  572. package/dist/native/store/sql/aggregateSql.js +349 -0
  573. package/dist/native/store/sql/aggregateSql.js.map +1 -0
  574. package/dist/native/store/sql/columns.js +49 -0
  575. package/dist/native/store/sql/columns.js.map +1 -0
  576. package/dist/native/store/sql/compile.js +668 -0
  577. package/dist/native/store/sql/compile.js.map +1 -0
  578. package/dist/native/store/sql/drivers.js +218 -0
  579. package/dist/native/store/sql/drivers.js.map +1 -0
  580. package/dist/native/store/sql/executor.js +132 -0
  581. package/dist/native/store/sql/executor.js.map +1 -0
  582. package/dist/native/store/sql/fragment.js +104 -0
  583. package/dist/native/store/sql/fragment.js.map +1 -0
  584. package/dist/native/store/sql/maintenanceSql.js +59 -0
  585. package/dist/native/store/sql/maintenanceSql.js.map +1 -0
  586. package/dist/native/store/sql/ownConnection.js +107 -0
  587. package/dist/native/store/sql/ownConnection.js.map +1 -0
  588. package/dist/native/store/sql/poolShare.js +101 -0
  589. package/dist/native/store/sql/poolShare.js.map +1 -0
  590. package/dist/native/store/sql/sqlState.js +325 -0
  591. package/dist/native/store/sql/sqlState.js.map +1 -0
  592. package/dist/native/store/sql/sqlStore.js +355 -0
  593. package/dist/native/store/sql/sqlStore.js.map +1 -0
  594. package/dist/native/store/sql/sqliteThread.d.ts +9 -0
  595. package/dist/native/store/sql/sqliteThread.js +314 -0
  596. package/dist/native/store/sql/sqliteThread.js.map +1 -0
  597. package/dist/native/store/sql/sqliteWorker.js +327 -0
  598. package/dist/native/store/sql/sqliteWorker.js.map +1 -0
  599. package/dist/native/store/sql/sqliteWorkerSource.js +347 -0
  600. package/dist/native/store/sql/sqliteWorkerSource.js.map +1 -0
  601. package/dist/native/store/state.js +151 -0
  602. package/dist/native/store/state.js.map +1 -0
  603. package/dist/native/store/stateStore.js +29 -0
  604. package/dist/native/store/stateStore.js.map +1 -0
  605. package/dist/native/store/types.d.ts +15 -0
  606. package/dist/native/store/types.js +10 -0
  607. package/dist/native/store/types.js.map +1 -0
  608. package/dist/native/tasks/maintainTask.d.ts +19 -0
  609. package/dist/native/tasks/maintainTask.js +57 -0
  610. package/dist/native/tasks/maintainTask.js.map +1 -0
  611. package/dist/net/guardedFetch.d.ts +32 -0
  612. package/dist/net/guardedFetch.js +220 -0
  613. package/dist/net/guardedFetch.js.map +1 -0
  614. package/dist/net/origin.js +40 -0
  615. package/dist/net/origin.js.map +1 -0
  616. package/dist/net/platform.d.ts +9 -0
  617. package/dist/net/platform.js +35 -0
  618. package/dist/net/platform.js.map +1 -0
  619. package/dist/plugin/adminDependencies.js +34 -0
  620. package/dist/plugin/adminDependencies.js.map +1 -0
  621. package/dist/plugin/apiPath.js +23 -0
  622. package/dist/plugin/apiPath.js.map +1 -0
  623. package/dist/plugin/boundDocument.js +58 -0
  624. package/dist/plugin/boundDocument.js.map +1 -0
  625. package/dist/plugin/buildPhase.js +10 -0
  626. package/dist/plugin/buildPhase.js.map +1 -0
  627. package/dist/plugin/collectionChecks.js +232 -0
  628. package/dist/plugin/collectionChecks.js.map +1 -0
  629. package/dist/plugin/collectionFields.d.ts +13 -0
  630. package/dist/plugin/collectionFields.js +22 -0
  631. package/dist/plugin/collectionFields.js.map +1 -0
  632. package/dist/plugin/createRuntime.js +346 -0
  633. package/dist/plugin/createRuntime.js.map +1 -0
  634. package/dist/plugin/destroy.js +58 -0
  635. package/dist/plugin/destroy.js.map +1 -0
  636. package/dist/plugin/documentEndpoint.js +106 -53
  637. package/dist/plugin/documentEndpoint.js.map +1 -1
  638. package/dist/plugin/documentScopes.js +37 -0
  639. package/dist/plugin/documentScopes.js.map +1 -0
  640. package/dist/plugin/encrypted.js +25 -0
  641. package/dist/plugin/encrypted.js.map +1 -0
  642. package/dist/plugin/errors.d.ts +24 -0
  643. package/dist/plugin/errors.js +86 -0
  644. package/dist/plugin/errors.js.map +1 -0
  645. package/dist/plugin/flagsEndpoint.js +41 -0
  646. package/dist/plugin/flagsEndpoint.js.map +1 -0
  647. package/dist/plugin/goalHint.d.ts +1 -0
  648. package/dist/plugin/goalHint.js +35 -0
  649. package/dist/plugin/goalHint.js.map +1 -0
  650. package/dist/plugin/itemLabels.js +114 -0
  651. package/dist/plugin/itemLabels.js.map +1 -0
  652. package/dist/plugin/keepAlive.js +48 -0
  653. package/dist/plugin/keepAlive.js.map +1 -0
  654. package/dist/plugin/peerImportError.js +3 -6
  655. package/dist/plugin/peerImportError.js.map +1 -1
  656. package/dist/plugin/peers.js +64 -0
  657. package/dist/plugin/peers.js.map +1 -0
  658. package/dist/plugin/pluginCollections.js +161 -0
  659. package/dist/plugin/pluginCollections.js.map +1 -0
  660. package/dist/plugin/queryEndpoint.js +88 -52
  661. package/dist/plugin/queryEndpoint.js.map +1 -1
  662. package/dist/plugin/queryParams.js +7 -0
  663. package/dist/plugin/queryParams.js.map +1 -0
  664. package/dist/plugin/readContextForRequest.d.ts +11 -0
  665. package/dist/plugin/readContextForRequest.js +79 -32
  666. package/dist/plugin/readContextForRequest.js.map +1 -1
  667. package/dist/plugin/readFailure.js +22 -0
  668. package/dist/plugin/readFailure.js.map +1 -0
  669. package/dist/plugin/readableProviders.js +67 -0
  670. package/dist/plugin/readableProviders.js.map +1 -0
  671. package/dist/plugin/realtimeEndpoint.js +91 -21
  672. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  673. package/dist/plugin/refreshEndpoint.js +138 -0
  674. package/dist/plugin/refreshEndpoint.js.map +1 -0
  675. package/dist/plugin/relabelFields.js +36 -0
  676. package/dist/plugin/relabelFields.js.map +1 -0
  677. package/dist/plugin/requestMemo.js +35 -0
  678. package/dist/plugin/requestMemo.js.map +1 -0
  679. package/dist/plugin/routeChecks.js +39 -0
  680. package/dist/plugin/routeChecks.js.map +1 -0
  681. package/dist/plugin/routes.d.ts +53 -0
  682. package/dist/plugin/routes.js +92 -0
  683. package/dist/plugin/routes.js.map +1 -0
  684. package/dist/plugin/runtime.d.ts +1 -1
  685. package/dist/plugin/runtime.js +235 -29
  686. package/dist/plugin/runtime.js.map +1 -1
  687. package/dist/plugin/schemaOnly.js +61 -0
  688. package/dist/plugin/schemaOnly.js.map +1 -0
  689. package/dist/plugin/scopeChange.js +23 -0
  690. package/dist/plugin/scopeChange.js.map +1 -0
  691. package/dist/plugin/scopeFieldBoot.js +4 -4
  692. package/dist/plugin/scopeFieldBoot.js.map +1 -1
  693. package/dist/plugin/scopeToken.js +33 -0
  694. package/dist/plugin/scopeToken.js.map +1 -0
  695. package/dist/plugin/sourcesEndpoint.js +50 -16
  696. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  697. package/dist/plugin/unbundledLanguages.js +25 -0
  698. package/dist/plugin/unbundledLanguages.js.map +1 -0
  699. package/dist/plugin/walkFields.js +24 -0
  700. package/dist/plugin/walkFields.js.map +1 -0
  701. package/dist/plugin/warmTask.js +0 -0
  702. package/dist/plugin/warmTask.js.map +1 -1
  703. package/dist/providers/ProvidersListNotice.d.ts +11 -0
  704. package/dist/providers/ProvidersListNotice.js +36 -0
  705. package/dist/providers/ProvidersListNotice.js.map +1 -0
  706. package/dist/providers/access.d.ts +1 -0
  707. package/dist/providers/access.js +35 -26
  708. package/dist/providers/access.js.map +1 -1
  709. package/dist/providers/adapterPool.js +121 -0
  710. package/dist/providers/adapterPool.js.map +1 -0
  711. package/dist/providers/collection.d.ts +63 -0
  712. package/dist/providers/collection.js +372 -143
  713. package/dist/providers/collection.js.map +1 -1
  714. package/dist/providers/factory.d.ts +84 -0
  715. package/dist/providers/factory.js +86 -25
  716. package/dist/providers/factory.js.map +1 -1
  717. package/dist/providers/hosts.d.ts +25 -0
  718. package/dist/providers/hosts.js +128 -0
  719. package/dist/providers/hosts.js.map +1 -0
  720. package/dist/providers/probe.d.ts +1 -0
  721. package/dist/providers/probe.js +105 -0
  722. package/dist/providers/probe.js.map +1 -0
  723. package/dist/providers/refresh.d.ts +18 -0
  724. package/dist/providers/refresh.js +49 -0
  725. package/dist/providers/refresh.js.map +1 -0
  726. package/dist/providers/registry.js +329 -0
  727. package/dist/providers/registry.js.map +1 -0
  728. package/dist/providers/resolver.js +26 -88
  729. package/dist/providers/resolver.js.map +1 -1
  730. package/dist/providers/retarget.js +45 -0
  731. package/dist/providers/retarget.js.map +1 -0
  732. package/dist/providers/scopeUnique.js +41 -0
  733. package/dist/providers/scopeUnique.js.map +1 -0
  734. package/dist/providers/secrets.d.ts +26 -0
  735. package/dist/providers/secrets.js +61 -4
  736. package/dist/providers/secrets.js.map +1 -1
  737. package/dist/providers/stampScope.js +9 -6
  738. package/dist/providers/stampScope.js.map +1 -1
  739. package/dist/query/dates.js +10 -12
  740. package/dist/query/dates.js.map +1 -1
  741. package/dist/query/errors.d.ts +6 -13
  742. package/dist/query/fetchQuery.d.ts +36 -23
  743. package/dist/query/fetchQuery.js +96 -89
  744. package/dist/query/fetchQuery.js.map +1 -1
  745. package/dist/query/limits.js +8 -0
  746. package/dist/query/limits.js.map +1 -0
  747. package/dist/query/parse.d.ts +8 -2
  748. package/dist/query/parse.js +155 -108
  749. package/dist/query/parse.js.map +1 -1
  750. package/dist/query/response.d.ts +27 -4
  751. package/dist/query/response.js +18 -0
  752. package/dist/query/response.js.map +1 -0
  753. package/dist/react/AnalyticsProvider.d.ts +42 -20
  754. package/dist/react/AnalyticsProvider.js +24 -22
  755. package/dist/react/AnalyticsProvider.js.map +1 -1
  756. package/dist/react/TrackerBoot.js +15 -9
  757. package/dist/react/TrackerBoot.js.map +1 -1
  758. package/dist/react/useAnalytics.d.ts +2 -8
  759. package/dist/react/useAnalytics.js +31 -13
  760. package/dist/react/useAnalytics.js.map +1 -1
  761. package/dist/routes/captureRoute.d.ts +28 -0
  762. package/dist/routes/captureRoute.js +67 -0
  763. package/dist/routes/captureRoute.js.map +1 -0
  764. package/dist/routes/ingestRoute.d.ts +17 -0
  765. package/dist/routes/ingestRoute.js +17 -0
  766. package/dist/routes/ingestRoute.js.map +1 -0
  767. package/dist/site/AnalyticsScripts.d.ts +35 -0
  768. package/dist/site/AnalyticsScripts.js +44 -0
  769. package/dist/site/AnalyticsScripts.js.map +1 -0
  770. package/dist/site/getTrackerConfig.d.ts +15 -0
  771. package/dist/site/getTrackerConfig.js +43 -0
  772. package/dist/site/getTrackerConfig.js.map +1 -0
  773. package/dist/surfacing/afterRead.d.ts +37 -0
  774. package/dist/surfacing/bounded.js +38 -0
  775. package/dist/surfacing/bounded.js.map +1 -0
  776. package/dist/surfacing/breaker.js +107 -0
  777. package/dist/surfacing/breaker.js.map +1 -0
  778. package/dist/surfacing/cacheCollection.d.ts +8 -0
  779. package/dist/surfacing/cacheCollection.js +71 -0
  780. package/dist/surfacing/cacheCollection.js.map +1 -0
  781. package/dist/surfacing/cacheStore.d.ts +71 -1
  782. package/dist/surfacing/cacheStore.js +16 -37
  783. package/dist/surfacing/cacheStore.js.map +1 -1
  784. package/dist/surfacing/cacheSweep.d.ts +1 -0
  785. package/dist/surfacing/cacheSweep.js +59 -0
  786. package/dist/surfacing/cacheSweep.js.map +1 -0
  787. package/dist/surfacing/classifyError.js +282 -0
  788. package/dist/surfacing/classifyError.js.map +1 -0
  789. package/dist/surfacing/coalesce.js +2 -1
  790. package/dist/surfacing/coalesce.js.map +1 -1
  791. package/dist/surfacing/coldBudget.js +60 -0
  792. package/dist/surfacing/coldBudget.js.map +1 -0
  793. package/dist/surfacing/collectionCacheStore.js +183 -0
  794. package/dist/surfacing/collectionCacheStore.js.map +1 -0
  795. package/dist/surfacing/engine.d.ts +1 -1
  796. package/dist/surfacing/engine.js +514 -71
  797. package/dist/surfacing/engine.js.map +1 -1
  798. package/dist/surfacing/epoch.d.ts +1 -0
  799. package/dist/surfacing/epoch.js +116 -0
  800. package/dist/surfacing/epoch.js.map +1 -0
  801. package/dist/surfacing/lanes.d.ts +1 -0
  802. package/dist/surfacing/lanes.js +297 -0
  803. package/dist/surfacing/lanes.js.map +1 -0
  804. package/dist/surfacing/memo.js +40 -0
  805. package/dist/surfacing/memo.js.map +1 -0
  806. package/dist/surfacing/rateLimiter.d.ts +1 -0
  807. package/dist/surfacing/rateLimiter.js +69 -94
  808. package/dist/surfacing/rateLimiter.js.map +1 -1
  809. package/dist/surfacing/rebucket.js +178 -0
  810. package/dist/surfacing/rebucket.js.map +1 -0
  811. package/dist/surfacing/recipe.js +28 -0
  812. package/dist/surfacing/recipe.js.map +1 -0
  813. package/dist/surfacing/shape.js +22 -0
  814. package/dist/surfacing/shape.js.map +1 -0
  815. package/dist/surfacing/todaySplit.js +119 -0
  816. package/dist/surfacing/todaySplit.js.map +1 -0
  817. package/dist/sync/collection.d.ts +8 -0
  818. package/dist/sync/collection.js +30 -18
  819. package/dist/sync/collection.js.map +1 -1
  820. package/dist/sync/rekeyDurations.js +70 -0
  821. package/dist/sync/rekeyDurations.js.map +1 -0
  822. package/dist/sync/syncTask.js +222 -109
  823. package/dist/sync/syncTask.js.map +1 -1
  824. package/dist/testing/memoryAdapter.d.ts +6 -3
  825. package/dist/testing/memoryAdapter.js +12 -11
  826. package/dist/testing/memoryAdapter.js.map +1 -1
  827. package/dist/testing/settle.d.ts +11 -0
  828. package/dist/testing/settle.js +19 -0
  829. package/dist/testing/settle.js.map +1 -0
  830. package/dist/timeframe/calendar.js +65 -0
  831. package/dist/timeframe/calendar.js.map +1 -0
  832. package/dist/timeframe/comparison.js +46 -0
  833. package/dist/timeframe/comparison.js.map +1 -0
  834. package/dist/timeframe/presets.d.ts +1 -1
  835. package/dist/timeframe/presets.js +5 -5
  836. package/dist/timeframe/presets.js.map +1 -1
  837. package/dist/timeframe/reportingTimezone.d.ts +1 -0
  838. package/dist/timeframe/reportingTimezone.js +64 -0
  839. package/dist/timeframe/reportingTimezone.js.map +1 -0
  840. package/dist/timeframe/tz.js +55 -39
  841. package/dist/timeframe/tz.js.map +1 -1
  842. package/dist/tracker/autoCapture.js +125 -38
  843. package/dist/tracker/autoCapture.js.map +1 -1
  844. package/dist/tracker/campaign.js +52 -0
  845. package/dist/tracker/campaign.js.map +1 -0
  846. package/dist/tracker/config.d.ts +174 -0
  847. package/dist/tracker/config.js +25 -0
  848. package/dist/tracker/config.js.map +1 -0
  849. package/dist/tracker/createTracker.d.ts +5 -10
  850. package/dist/tracker/createTracker.js +437 -82
  851. package/dist/tracker/createTracker.js.map +1 -1
  852. package/dist/tracker/digest.js +28 -0
  853. package/dist/tracker/digest.js.map +1 -0
  854. package/dist/tracker/engagement.js +100 -0
  855. package/dist/tracker/engagement.js.map +1 -0
  856. package/dist/tracker/events.js +37 -0
  857. package/dist/tracker/events.js.map +1 -0
  858. package/dist/tracker/exclusion.d.ts +8 -0
  859. package/dist/tracker/exclusion.js +82 -0
  860. package/dist/tracker/exclusion.js.map +1 -0
  861. package/dist/tracker/gate.d.ts +8 -0
  862. package/dist/tracker/gate.js +244 -0
  863. package/dist/tracker/gate.js.map +1 -0
  864. package/dist/tracker/initTracker.d.ts +5 -8
  865. package/dist/tracker/initTracker.js +42 -14
  866. package/dist/tracker/initTracker.js.map +1 -1
  867. package/dist/tracker/itemCapture.js +224 -0
  868. package/dist/tracker/itemCapture.js.map +1 -0
  869. package/dist/tracker/loadScript.js +23 -15
  870. package/dist/tracker/loadScript.js.map +1 -1
  871. package/dist/tracker/pageTracking.js +6 -6
  872. package/dist/tracker/pageTracking.js.map +1 -1
  873. package/dist/tracker/registry.js +129 -30
  874. package/dist/tracker/registry.js.map +1 -1
  875. package/dist/tracker/sinks/createSink.js +60 -0
  876. package/dist/tracker/sinks/createSink.js.map +1 -0
  877. package/dist/tracker/sinks/ga4.js +106 -0
  878. package/dist/tracker/sinks/ga4.js.map +1 -0
  879. package/dist/tracker/sinks/native.js +21 -42
  880. package/dist/tracker/sinks/native.js.map +1 -1
  881. package/dist/tracker/sinks/plausible.js +36 -18
  882. package/dist/tracker/sinks/plausible.js.map +1 -1
  883. package/dist/tracker/sinks/posthog.js +145 -9
  884. package/dist/tracker/sinks/posthog.js.map +1 -1
  885. package/dist/tracker/sinks/umami.js +18 -10
  886. package/dist/tracker/sinks/umami.js.map +1 -1
  887. package/dist/tracker/sinks/vendor.js +54 -22
  888. package/dist/tracker/sinks/vendor.js.map +1 -1
  889. package/dist/tracker/skip.js +81 -0
  890. package/dist/tracker/skip.js.map +1 -0
  891. package/dist/tracker/storage.js +23 -0
  892. package/dist/tracker/storage.js.map +1 -0
  893. package/dist/tracker/transport.js +2 -5
  894. package/dist/tracker/transport.js.map +1 -1
  895. package/dist/tracker/types.d.ts +99 -44
  896. package/dist/tracker/window.js +7 -0
  897. package/dist/tracker/window.js.map +1 -0
  898. package/dist/translations/ar.js +266 -56
  899. package/dist/translations/ar.js.map +1 -1
  900. package/dist/translations/de.js +256 -55
  901. package/dist/translations/de.js.map +1 -1
  902. package/dist/translations/en.js +253 -56
  903. package/dist/translations/en.js.map +1 -1
  904. package/dist/translations/es.js +261 -57
  905. package/dist/translations/es.js.map +1 -1
  906. package/dist/translations/fr.js +265 -61
  907. package/dist/translations/fr.js.map +1 -1
  908. package/dist/translations/id.js +256 -56
  909. package/dist/translations/id.js.map +1 -1
  910. package/dist/translations/index.d.ts +1 -1
  911. package/dist/translations/index.js +5 -7
  912. package/dist/translations/index.js.map +1 -1
  913. package/dist/translations/intl.js +71 -0
  914. package/dist/translations/intl.js.map +1 -0
  915. package/dist/translations/keys.d.ts +240 -14
  916. package/dist/translations/keys.js +245 -14
  917. package/dist/translations/keys.js.map +1 -1
  918. package/dist/translations/ko.js +258 -58
  919. package/dist/translations/ko.js.map +1 -1
  920. package/dist/translations/labelMap.d.ts +10 -0
  921. package/dist/translations/labelMap.js +22 -0
  922. package/dist/translations/labelMap.js.map +1 -0
  923. package/dist/translations/metricKeys.js +16 -2
  924. package/dist/translations/metricKeys.js.map +1 -1
  925. package/dist/translations/parts.js +20 -0
  926. package/dist/translations/parts.js.map +1 -0
  927. package/dist/translations/plural.js +61 -0
  928. package/dist/translations/plural.js.map +1 -0
  929. package/dist/translations/pt.js +270 -66
  930. package/dist/translations/pt.js.map +1 -1
  931. package/dist/translations/ru.js +261 -55
  932. package/dist/translations/ru.js.map +1 -1
  933. package/dist/translations/server.d.ts +1 -0
  934. package/dist/translations/server.js +2 -3
  935. package/dist/translations/server.js.map +1 -1
  936. package/dist/translations/staticLabel.js +69 -0
  937. package/dist/translations/staticLabel.js.map +1 -0
  938. package/dist/translations/uk.js +261 -55
  939. package/dist/translations/uk.js.map +1 -1
  940. package/dist/translations/zh.js +256 -56
  941. package/dist/translations/zh.js.map +1 -1
  942. package/dist/ui/RangePicker.js +110 -0
  943. package/dist/ui/RangePicker.js.map +1 -0
  944. package/dist/ui/analytics.css +1667 -0
  945. package/dist/ui/calendarDays.js +27 -0
  946. package/dist/ui/calendarDays.js.map +1 -0
  947. package/dist/ui/classNames.js +7 -0
  948. package/dist/ui/classNames.js.map +1 -0
  949. package/dist/ui/components/Card.d.ts +28 -0
  950. package/dist/ui/components/Card.js +21 -0
  951. package/dist/ui/components/Card.js.map +1 -0
  952. package/dist/ui/components/ChartDataTable.d.ts +41 -0
  953. package/dist/ui/components/ChartDataTable.js +48 -0
  954. package/dist/ui/components/ChartDataTable.js.map +1 -0
  955. package/dist/ui/components/ChoiceMenu.js +48 -0
  956. package/dist/ui/components/ChoiceMenu.js.map +1 -0
  957. package/dist/ui/components/DataTable.d.ts +82 -0
  958. package/dist/ui/components/DataTable.js +214 -0
  959. package/dist/ui/components/DataTable.js.map +1 -0
  960. package/dist/ui/components/LabeledSelect.js +62 -0
  961. package/dist/ui/components/LabeledSelect.js.map +1 -0
  962. package/dist/ui/components/LiveAnnouncement.js +21 -0
  963. package/dist/ui/components/LiveAnnouncement.js.map +1 -0
  964. package/dist/ui/components/MetricCard.d.ts +38 -0
  965. package/dist/ui/components/MetricCard.js +39 -0
  966. package/dist/ui/components/MetricCard.js.map +1 -0
  967. package/dist/ui/components/NoValue.js +22 -0
  968. package/dist/ui/components/NoValue.js.map +1 -0
  969. package/dist/ui/components/ReadState.js +27 -0
  970. package/dist/ui/components/ReadState.js.map +1 -0
  971. package/dist/ui/components/RefreshButton.js +25 -0
  972. package/dist/ui/components/RefreshButton.js.map +1 -0
  973. package/dist/ui/components/SourcesNoticeBanner.js +20 -0
  974. package/dist/ui/components/SourcesNoticeBanner.js.map +1 -0
  975. package/dist/ui/cssVars.js +7 -0
  976. package/dist/ui/cssVars.js.map +1 -0
  977. package/dist/ui/data/WithScopeToken.d.ts +20 -0
  978. package/dist/ui/data/WithScopeToken.js +20 -0
  979. package/dist/ui/data/WithScopeToken.js.map +1 -0
  980. package/dist/ui/data/clientFieldProps.js +16 -0
  981. package/dist/ui/data/clientFieldProps.js.map +1 -0
  982. package/dist/ui/data/request.d.ts +46 -0
  983. package/dist/ui/data/request.js +119 -0
  984. package/dist/ui/data/request.js.map +1 -0
  985. package/dist/ui/data/scopeTokenContext.js +18 -0
  986. package/dist/ui/data/scopeTokenContext.js.map +1 -0
  987. package/dist/ui/data/sharedCache.js +48 -0
  988. package/dist/ui/data/sharedCache.js.map +1 -0
  989. package/dist/ui/data/useRequest.d.ts +19 -0
  990. package/dist/ui/data/useRequest.js +123 -0
  991. package/dist/ui/data/useRequest.js.map +1 -0
  992. package/dist/ui/data/useRequestScope.js +25 -0
  993. package/dist/ui/data/useRequestScope.js.map +1 -0
  994. package/dist/ui/hooks/useDirection.js +47 -0
  995. package/dist/ui/hooks/useDirection.js.map +1 -0
  996. package/dist/ui/hooks/useDismissOnEscape.js +25 -0
  997. package/dist/ui/hooks/useDismissOnEscape.js.map +1 -0
  998. package/dist/ui/hooks/useLiveAnnouncement.js +57 -0
  999. package/dist/ui/hooks/useLiveAnnouncement.js.map +1 -0
  1000. package/dist/ui/hooks/useRealtimePoll.js +112 -0
  1001. package/dist/ui/hooks/useRealtimePoll.js.map +1 -0
  1002. package/dist/ui/readState.js +19 -0
  1003. package/dist/ui/readState.js.map +1 -0
  1004. package/dist/ui/rows/toDisplayRows.js +49 -0
  1005. package/dist/ui/rows/toDisplayRows.js.map +1 -0
  1006. package/dist/ui/viewerClock.js +7 -0
  1007. package/dist/ui/viewerClock.js.map +1 -0
  1008. package/dist/view/AnalyticsNavLink.d.ts +5 -3
  1009. package/dist/view/AnalyticsNavLink.js +12 -8
  1010. package/dist/view/AnalyticsNavLink.js.map +1 -1
  1011. package/dist/view/AnalyticsView.d.ts +9 -10
  1012. package/dist/view/AnalyticsView.js +47 -19
  1013. package/dist/view/AnalyticsView.js.map +1 -1
  1014. package/dist/view/AnalyticsViewClient.d.ts +4 -7
  1015. package/dist/view/AnalyticsViewClient.js +15 -174
  1016. package/dist/view/AnalyticsViewClient.js.map +1 -1
  1017. package/dist/view/CountryFlag.d.ts +27 -0
  1018. package/dist/view/CountryFlag.js +44 -0
  1019. package/dist/view/CountryFlag.js.map +1 -0
  1020. package/dist/view/DocumentTitle.js +27 -0
  1021. package/dist/view/DocumentTitle.js.map +1 -0
  1022. package/dist/view/ViewRoot.d.ts +21 -0
  1023. package/dist/view/ViewRoot.js +155 -0
  1024. package/dist/view/ViewRoot.js.map +1 -0
  1025. package/dist/view/ViewSections.d.ts +38 -0
  1026. package/dist/view/ViewSections.js +190 -0
  1027. package/dist/view/ViewSections.js.map +1 -0
  1028. package/dist/view/authRedirect.js +2 -4
  1029. package/dist/view/authRedirect.js.map +1 -1
  1030. package/dist/view/consentShare.js +15 -0
  1031. package/dist/view/consentShare.js.map +1 -0
  1032. package/dist/view/conversionRate.js +9 -7
  1033. package/dist/view/conversionRate.js.map +1 -1
  1034. package/dist/view/dayRange.js +6 -10
  1035. package/dist/view/dayRange.js.map +1 -1
  1036. package/dist/view/exclusionLink.d.ts +27 -0
  1037. package/dist/view/exclusionLink.js +46 -0
  1038. package/dist/view/exclusionLink.js.map +1 -0
  1039. package/dist/view/flagSrc.js +14 -0
  1040. package/dist/view/flagSrc.js.map +1 -0
  1041. package/dist/view/gating.d.ts +15 -1
  1042. package/dist/view/gating.js +92 -20
  1043. package/dist/view/gating.js.map +1 -1
  1044. package/dist/view/hostCountryFlag.js +41 -0
  1045. package/dist/view/hostCountryFlag.js.map +1 -0
  1046. package/dist/view/labels.js +120 -3
  1047. package/dist/view/labels.js.map +1 -1
  1048. package/dist/view/metricAliases.js +10 -0
  1049. package/dist/view/metricAliases.js.map +1 -0
  1050. package/dist/view/navLabel.js +15 -0
  1051. package/dist/view/navLabel.js.map +1 -0
  1052. package/dist/view/registerView.js +13 -11
  1053. package/dist/view/registerView.js.map +1 -1
  1054. package/dist/view/scopeLabel.js +21 -0
  1055. package/dist/view/scopeLabel.js.map +1 -0
  1056. package/dist/view/sections/Breakdowns.js +221 -118
  1057. package/dist/view/sections/Breakdowns.js.map +1 -1
  1058. package/dist/view/sections/EmptyStates.js +120 -32
  1059. package/dist/view/sections/EmptyStates.js.map +1 -1
  1060. package/dist/view/sections/ExcludeBrowser.js +188 -0
  1061. package/dist/view/sections/ExcludeBrowser.js.map +1 -0
  1062. package/dist/view/sections/FilterChips.js +130 -25
  1063. package/dist/view/sections/FilterChips.js.map +1 -1
  1064. package/dist/view/sections/GoalsPanel.js +68 -59
  1065. package/dist/view/sections/GoalsPanel.js.map +1 -1
  1066. package/dist/view/sections/OverviewCards.js +42 -36
  1067. package/dist/view/sections/OverviewCards.js.map +1 -1
  1068. package/dist/view/sections/RealtimeStrip.js +70 -56
  1069. package/dist/view/sections/RealtimeStrip.js.map +1 -1
  1070. package/dist/view/sections/SectionBoundary.js +34 -0
  1071. package/dist/view/sections/SectionBoundary.js.map +1 -0
  1072. package/dist/view/sections/Toolbar.d.ts +11 -0
  1073. package/dist/view/sections/Toolbar.js +182 -116
  1074. package/dist/view/sections/Toolbar.js.map +1 -1
  1075. package/dist/view/sections/Trend.js +179 -73
  1076. package/dist/view/sections/Trend.js.map +1 -1
  1077. package/dist/view/state.d.ts +42 -0
  1078. package/dist/view/state.js +97 -53
  1079. package/dist/view/state.js.map +1 -1
  1080. package/dist/view/useViewClock.js +31 -0
  1081. package/dist/view/useViewClock.js.map +1 -0
  1082. package/dist/view/useViewQueries.d.ts +21 -0
  1083. package/dist/view/useViewQueries.js +50 -79
  1084. package/dist/view/useViewQueries.js.map +1 -1
  1085. package/dist/view/useViewState.js +42 -0
  1086. package/dist/view/useViewState.js.map +1 -0
  1087. package/dist/view/useViewUrl.js +52 -0
  1088. package/dist/view/useViewUrl.js.map +1 -0
  1089. package/dist/view/viewBody.js +30 -0
  1090. package/dist/view/viewBody.js.map +1 -0
  1091. package/dist/view/viewContext.d.ts +81 -0
  1092. package/dist/view/viewContext.js +49 -0
  1093. package/dist/view/viewContext.js.map +1 -0
  1094. package/dist/view/viewProps.d.ts +65 -8
  1095. package/dist/view/viewProps.js +123 -36
  1096. package/dist/view/viewProps.js.map +1 -1
  1097. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -3
  1098. package/dist/widgets/AnalyticsBreakdownWidget.js +153 -78
  1099. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  1100. package/dist/widgets/AnalyticsGoalsWidget.d.ts +6 -7
  1101. package/dist/widgets/AnalyticsGoalsWidget.js +126 -159
  1102. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -1
  1103. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -3
  1104. package/dist/widgets/AnalyticsMetricWidget.js +85 -83
  1105. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  1106. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -3
  1107. package/dist/widgets/AnalyticsRealtimeWidget.js +81 -61
  1108. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  1109. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -3
  1110. package/dist/widgets/AnalyticsTrendWidget.js +134 -100
  1111. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  1112. package/dist/widgets/ComparisonDelta.js +33 -42
  1113. package/dist/widgets/ComparisonDelta.js.map +1 -1
  1114. package/dist/widgets/RealtimeCounter.d.ts +27 -3
  1115. package/dist/widgets/RealtimeCounter.js +90 -62
  1116. package/dist/widgets/RealtimeCounter.js.map +1 -1
  1117. package/dist/widgets/WidgetCard.d.ts +80 -0
  1118. package/dist/widgets/WidgetCard.js +99 -0
  1119. package/dist/widgets/WidgetCard.js.map +1 -0
  1120. package/dist/widgets/WidgetFrame.js +42 -0
  1121. package/dist/widgets/WidgetFrame.js.map +1 -0
  1122. package/dist/widgets/WidgetShimmer.d.ts +55 -0
  1123. package/dist/widgets/WidgetShimmer.js +86 -0
  1124. package/dist/widgets/WidgetShimmer.js.map +1 -0
  1125. package/dist/widgets/breakdownTypes.js +18 -2
  1126. package/dist/widgets/breakdownTypes.js.map +1 -1
  1127. package/dist/widgets/customWidget.d.ts +5 -1
  1128. package/dist/widgets/customWidget.js +6 -7
  1129. package/dist/widgets/customWidget.js.map +1 -1
  1130. package/dist/widgets/defaultLayout.d.ts +26 -0
  1131. package/dist/widgets/defaultLayout.js +51 -0
  1132. package/dist/widgets/defaultLayout.js.map +1 -0
  1133. package/dist/widgets/defaults.d.ts +4 -3
  1134. package/dist/widgets/defaults.js +76 -24
  1135. package/dist/widgets/defaults.js.map +1 -1
  1136. package/dist/widgets/fieldRows.js +14 -0
  1137. package/dist/widgets/fieldRows.js.map +1 -0
  1138. package/dist/widgets/filterCaption.js +26 -0
  1139. package/dist/widgets/filterCaption.js.map +1 -0
  1140. package/dist/widgets/filterField.d.ts +15 -0
  1141. package/dist/widgets/filterField.js +86 -0
  1142. package/dist/widgets/filterField.js.map +1 -0
  1143. package/dist/widgets/filterValueLabel.d.ts +1 -0
  1144. package/dist/widgets/filterValueLabel.js +45 -0
  1145. package/dist/widgets/filterValueLabel.js.map +1 -0
  1146. package/dist/widgets/notices.js +79 -0
  1147. package/dist/widgets/notices.js.map +1 -0
  1148. package/dist/widgets/prepareWidgetRead.d.ts +24 -0
  1149. package/dist/widgets/prepareWidgetRead.js +110 -0
  1150. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  1151. package/dist/widgets/range.js +26 -21
  1152. package/dist/widgets/range.js.map +1 -1
  1153. package/dist/widgets/readForWidget.d.ts +32 -13
  1154. package/dist/widgets/readForWidget.js +52 -63
  1155. package/dist/widgets/readForWidget.js.map +1 -1
  1156. package/dist/widgets/readForWidgetBreakdown.d.ts +45 -18
  1157. package/dist/widgets/readForWidgetBreakdown.js +71 -58
  1158. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  1159. package/dist/widgets/readForWidgetGoals.d.ts +21 -17
  1160. package/dist/widgets/readForWidgetGoals.js +72 -52
  1161. package/dist/widgets/readForWidgetGoals.js.map +1 -1
  1162. package/dist/widgets/readForWidgetRealtime.d.ts +24 -11
  1163. package/dist/widgets/readForWidgetRealtime.js +69 -41
  1164. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  1165. package/dist/widgets/readForWidgetSeries.d.ts +29 -24
  1166. package/dist/widgets/readForWidgetSeries.js +66 -114
  1167. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  1168. package/dist/widgets/readMeta.d.ts +48 -0
  1169. package/dist/widgets/readMeta.js +66 -0
  1170. package/dist/widgets/readMeta.js.map +1 -0
  1171. package/dist/widgets/realtimePoll.d.ts +1 -0
  1172. package/dist/widgets/realtimePoll.js +56 -16
  1173. package/dist/widgets/realtimePoll.js.map +1 -1
  1174. package/dist/widgets/registerWidgets.js +207 -124
  1175. package/dist/widgets/registerWidgets.js.map +1 -1
  1176. package/dist/widgets/stateKeys.js +30 -0
  1177. package/dist/widgets/stateKeys.js.map +1 -0
  1178. package/dist/widgets/titleForecast.js +89 -0
  1179. package/dist/widgets/titleForecast.js.map +1 -0
  1180. package/dist/widgets/types.d.ts +16 -0
  1181. package/dist/widgets/types.js +2 -0
  1182. package/dist/widgets/types.js.map +1 -1
  1183. package/dist/widgets/viewLink.d.ts +24 -6
  1184. package/dist/widgets/viewLink.js +36 -26
  1185. package/dist/widgets/viewLink.js.map +1 -1
  1186. package/dist/widgets/widgetData.js +34 -0
  1187. package/dist/widgets/widgetData.js.map +1 -0
  1188. package/dist/widgets/widgetWindow.d.ts +1 -0
  1189. package/dist/widgets/widgetWindow.js +51 -0
  1190. package/dist/widgets/widgetWindow.js.map +1 -0
  1191. package/package.json +61 -42
  1192. package/dist/capture/getTrackerConfig.d.ts +0 -20
  1193. package/dist/capture/getTrackerConfig.js +0 -31
  1194. package/dist/capture/getTrackerConfig.js.map +0 -1
  1195. package/dist/capture/slots.d.ts +0 -8
  1196. package/dist/capture/trackerConfig.d.ts +0 -33
  1197. package/dist/charts/styles.js +0 -59
  1198. package/dist/charts/styles.js.map +0 -1
  1199. package/dist/exports/next.d.ts +0 -3
  1200. package/dist/exports/next.js +0 -3
  1201. package/dist/fields/config/SourceSelectField.d.ts +0 -14
  1202. package/dist/fields/dateRange/styles.js +0 -23
  1203. package/dist/fields/dateRange/styles.js.map +0 -1
  1204. package/dist/goals/GoalSelectField.d.ts +0 -7
  1205. package/dist/native/collections/events.js +0 -121
  1206. package/dist/native/collections/events.js.map +0 -1
  1207. package/dist/native/collections/rollups.js +0 -151
  1208. package/dist/native/collections/rollups.js.map +0 -1
  1209. package/dist/native/collections/seen.js +0 -47
  1210. package/dist/native/collections/seen.js.map +0 -1
  1211. package/dist/native/ingest/flushBatch.js +0 -60
  1212. package/dist/native/ingest/flushBatch.js.map +0 -1
  1213. package/dist/native/ingest/salt.js +0 -14
  1214. package/dist/native/ingest/salt.js.map +0 -1
  1215. package/dist/native/ingest/writeBuffer.js +0 -55
  1216. package/dist/native/ingest/writeBuffer.js.map +0 -1
  1217. package/dist/native/ingest/writeEvent.js +0 -14
  1218. package/dist/native/ingest/writeEvent.js.map +0 -1
  1219. package/dist/native/query/eventAgg.js +0 -161
  1220. package/dist/native/query/eventAgg.js.map +0 -1
  1221. package/dist/native/realtime/buildRealtime.js +0 -53
  1222. package/dist/native/realtime/buildRealtime.js.map +0 -1
  1223. package/dist/native/retention/pruneTask.js +0 -29
  1224. package/dist/native/retention/pruneTask.js.map +0 -1
  1225. package/dist/native/rollupAcc.js +0 -64
  1226. package/dist/native/rollupAcc.js.map +0 -1
  1227. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  1228. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  1229. package/dist/native/rollups/bumpRollup.js +0 -73
  1230. package/dist/native/rollups/bumpRollup.js.map +0 -1
  1231. package/dist/native/rollups/deltas.js +0 -90
  1232. package/dist/native/rollups/deltas.js.map +0 -1
  1233. package/dist/native/rollups/insertIfNew.js +0 -53
  1234. package/dist/native/rollups/insertIfNew.js.map +0 -1
  1235. package/dist/next/captureRewrites.d.ts +0 -41
  1236. package/dist/next/captureRewrites.js +0 -56
  1237. package/dist/next/captureRewrites.js.map +0 -1
  1238. package/dist/next/posthogProxyRewrites.d.ts +0 -41
  1239. package/dist/next/posthogProxyRewrites.js +0 -45
  1240. package/dist/next/posthogProxyRewrites.js.map +0 -1
  1241. package/dist/plugin/paths.js +0 -27
  1242. package/dist/plugin/paths.js.map +0 -1
  1243. package/dist/query/errors.js +0 -10
  1244. package/dist/query/errors.js.map +0 -1
  1245. package/dist/react/TrackerBoot.d.ts +0 -22
  1246. package/dist/rsc/AnalyticsScripts.d.ts +0 -30
  1247. package/dist/rsc/AnalyticsScripts.js +0 -41
  1248. package/dist/rsc/AnalyticsScripts.js.map +0 -1
  1249. package/dist/surfacing/queue.js +0 -60
  1250. package/dist/surfacing/queue.js.map +0 -1
  1251. package/dist/surfacing/retryPolicy.js +0 -15
  1252. package/dist/surfacing/retryPolicy.js.map +0 -1
  1253. package/dist/tracker/autoCapture.d.ts +0 -48
  1254. package/dist/tracker/consent.d.ts +0 -24
  1255. package/dist/tracker/consent.js +0 -48
  1256. package/dist/tracker/consent.js.map +0 -1
  1257. package/dist/tracker/loadScript.d.ts +0 -14
  1258. package/dist/tracker/pageTracking.d.ts +0 -17
  1259. package/dist/tracker/registry.d.ts +0 -27
  1260. package/dist/tracker/sinks/native.d.ts +0 -22
  1261. package/dist/tracker/sinks/plausible.d.ts +0 -14
  1262. package/dist/tracker/sinks/posthog.d.ts +0 -14
  1263. package/dist/tracker/sinks/umami.d.ts +0 -13
  1264. package/dist/tracker/sinks/vendor.d.ts +0 -14
  1265. package/dist/view/sections/styles.js +0 -74
  1266. package/dist/view/sections/styles.js.map +0 -1
  1267. package/dist/widgets/WidgetViewLink.js +0 -17
  1268. package/dist/widgets/WidgetViewLink.js.map +0 -1
  1269. package/dist/widgets/cardChrome.d.ts +0 -8
  1270. package/dist/widgets/cardChrome.js +0 -46
  1271. package/dist/widgets/cardChrome.js.map +0 -1
  1272. package/dist/widgets/comparison.js +0 -43
  1273. package/dist/widgets/comparison.js.map +0 -1
@@ -1,25 +1,59 @@
1
- import "./paths.js";
2
- import { getRuntime, readAccessFor } from "./runtime.js";
1
+ import { readGate } from "../access/readGate.js";
2
+ import { getRuntime, scopeGates } from "./runtime.js";
3
+ import { NO_STORE, analyticsError, errorResponse, readDeniedResponse, unauthorizedResponse, untrustedScopeResponse } from "./errors.js";
4
+ import { resolveDocumentScope } from "./documentScopes.js";
5
+ import { resolveBoundDocument, unloadedDocumentResponse } from "./boundDocument.js";
6
+ import { queryParams } from "./queryParams.js";
3
7
  import { resolveSourcesForRequest } from "./readContextForRequest.js";
4
8
  //#region src/plugin/sourcesEndpoint.ts
5
9
  /**
6
- * Authenticated GET listing the adapters visible to the requesting scope, with
7
- * serialized capabilities for client-side pickers. Gated by `access.read` like
8
- * every other read endpoint. Always answers for the caller's own resolved scope;
9
- * there is deliberately no scope parameter, so a tenant can never enumerate
10
- * another tenant's sources. Everything else about the resolution, including how a
11
- * null scope and a failed resolution fail closed, lives in
12
- * {@link resolveSourcesForRequest}, which the query endpoint shares.
10
+ * Authenticated GET listing adapters the requesting scope sees, with no scope parameter so a tenant
11
+ * never enumerates another's. `collection` and `id` list one readable document's scope instead.
13
12
  */
14
13
  const makeSourcesHandler = () => async (req) => {
15
- if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
14
+ if (!req.user) return unauthorizedResponse();
16
15
  const runtime = getRuntime(req.payload);
17
- if (runtime && !await readAccessFor(runtime, req)) return Response.json({ error: "forbidden" }, { status: 403 });
18
- const { sources, defaultId } = await resolveSourcesForRequest(req);
19
- return Response.json({
20
- defaultId,
21
- sources
22
- });
16
+ try {
17
+ return await listSources(req, runtime);
18
+ } catch (err) {
19
+ req.payload.logger?.error(`analytics: sources listing failed: ${String(err)}`);
20
+ return errorResponse(500, analyticsError("internal", "analytics: sources listing failed"));
21
+ }
22
+ };
23
+ /** The listing on the wire: what the client renders, never the adapters behind it. */
24
+ const listingBody = ({ defaultId, sources, notice }) => ({
25
+ defaultId,
26
+ sources,
27
+ ...notice ? { notice } : {}
28
+ });
29
+ const listSources = async (req, runtime) => {
30
+ if (runtime && !await readGate(runtime, req)) return readDeniedResponse();
31
+ const params = queryParams(req);
32
+ const collection = params.get("collection") ?? "";
33
+ const id = params.get("id") ?? "";
34
+ if (runtime && collection && id) {
35
+ const bound = await resolveBoundDocument({
36
+ req,
37
+ collection,
38
+ id
39
+ });
40
+ if (!bound.ok) return unloadedDocumentResponse(bound.status);
41
+ const gates = scopeGates(runtime, req);
42
+ const scope = await resolveDocumentScope({
43
+ runtime,
44
+ req,
45
+ collection,
46
+ data: bound.data,
47
+ gates
48
+ });
49
+ if (!scope.ok) return untrustedScopeResponse();
50
+ const listing = await resolveSourcesForRequest(req, {
51
+ gates,
52
+ ...scope.scope === null ? {} : { scope: scope.gated }
53
+ });
54
+ return Response.json(listingBody(listing), { headers: NO_STORE });
55
+ }
56
+ return Response.json(listingBody(await resolveSourcesForRequest(req)), { headers: NO_STORE });
23
57
  };
24
58
  //#endregion
25
59
  export { makeSourcesHandler };
@@ -1 +1 @@
1
- {"version":3,"file":"sourcesEndpoint.js","names":[],"sources":["../../src/plugin/sourcesEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { SOURCES_PATH } from './paths'\nimport { resolveSourcesForRequest } from './readContextForRequest'\nimport { getRuntime, readAccessFor } from './runtime'\n\nexport { SOURCES_PATH }\n\n/**\n * Authenticated GET listing the adapters visible to the requesting scope, with\n * serialized capabilities for client-side pickers. Gated by `access.read` like\n * every other read endpoint. Always answers for the caller's own resolved scope;\n * there is deliberately no scope parameter, so a tenant can never enumerate\n * another tenant's sources. Everything else about the resolution, including how a\n * null scope and a failed resolution fail closed, lives in\n * {@link resolveSourcesForRequest}, which the query endpoint shares.\n */\nexport const makeSourcesHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\t// No runtime means the plugin served nothing to gate: the listing below is empty anyway.\n\tif (runtime && !(await readAccessFor(runtime, req))) {\n\t\treturn Response.json({ error: 'forbidden' }, { status: 403 })\n\t}\n\tconst { sources, defaultId } = await resolveSourcesForRequest(req)\n\treturn Response.json({ defaultId, sources })\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CAEtC,IAAI,WAAW,CAAE,MAAM,cAAc,SAAS,GAAG,GAChD,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG,EAAE,QAAQ,IAAI,CAAC;CAE7D,MAAM,EAAE,SAAS,cAAc,MAAM,yBAAyB,GAAG;CACjE,OAAO,SAAS,KAAK;EAAE;EAAW;CAAQ,CAAC;AAC5C"}
1
+ {"version":3,"file":"sourcesEndpoint.js","names":[],"sources":["../../src/plugin/sourcesEndpoint.ts"],"sourcesContent":["import type { PayloadHandler, PayloadRequest } from 'payload'\nimport { readGate } from '../access/readGate'\nimport { resolveBoundDocument, unloadedDocumentResponse } from './boundDocument'\nimport { resolveDocumentScope } from './documentScopes'\nimport {\n\tanalyticsError,\n\terrorResponse,\n\tNO_STORE,\n\treadDeniedResponse,\n\tunauthorizedResponse,\n\tuntrustedScopeResponse,\n} from './errors'\nimport { queryParams } from './queryParams'\nimport { resolveSourcesForRequest } from './readContextForRequest'\nimport { type AnalyticsRuntime, getRuntime, scopeGates } from './runtime'\n\n/**\n * Authenticated GET listing adapters the requesting scope sees, with no scope parameter so a tenant\n * never enumerates another's. `collection` and `id` list one readable document's scope instead.\n */\nexport const makeSourcesHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn unauthorizedResponse()\n\t}\n\tconst runtime = getRuntime(req.payload)\n\ttry {\n\t\treturn await listSources(req, runtime)\n\t} catch (err) {\n\t\treq.payload.logger?.error(`analytics: sources listing failed: ${String(err)}`)\n\t\treturn errorResponse(500, analyticsError('internal', 'analytics: sources listing failed'))\n\t}\n}\n\n/** The listing on the wire: what the client renders, never the adapters behind it. */\nconst listingBody = ({\n\tdefaultId,\n\tsources,\n\tnotice,\n}: Awaited<ReturnType<typeof resolveSourcesForRequest>>) => ({\n\tdefaultId,\n\tsources,\n\t...(notice ? { notice } : {}),\n})\n\nconst listSources = async (\n\treq: PayloadRequest,\n\truntime: AnalyticsRuntime | undefined\n): Promise<Response> => {\n\t// No runtime means the plugin served nothing to gate: the listing below is empty anyway.\n\tif (runtime && !(await readGate(runtime, req))) {\n\t\treturn readDeniedResponse()\n\t}\n\tconst params = queryParams(req)\n\tconst collection = params.get('collection') ?? ''\n\tconst id = params.get('id') ?? ''\n\tif (runtime && collection && id) {\n\t\tconst bound = await resolveBoundDocument({ req, collection, id })\n\t\tif (!bound.ok) {\n\t\t\treturn unloadedDocumentResponse(bound.status)\n\t\t}\n\t\tconst gates = scopeGates(runtime, req)\n\t\tconst scope = await resolveDocumentScope({ runtime, req, collection, data: bound.data, gates })\n\t\tif (!scope.ok) {\n\t\t\treturn untrustedScopeResponse()\n\t\t}\n\t\tconst listing = await resolveSourcesForRequest(req, {\n\t\t\tgates,\n\t\t\t...(scope.scope === null ? {} : { scope: scope.gated }),\n\t\t})\n\t\treturn Response.json(listingBody(listing), { headers: NO_STORE })\n\t}\n\treturn Response.json(listingBody(await resolveSourcesForRequest(req)), { headers: NO_STORE })\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,IAAI,CAAC,IAAI,MACR,OAAO,qBAAqB;CAE7B,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI;EACH,OAAO,MAAM,YAAY,KAAK,OAAO;CACtC,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,MAAM,sCAAsC,OAAO,GAAG,GAAG;EAC7E,OAAO,cAAc,KAAK,eAAe,YAAY,mCAAmC,CAAC;CAC1F;AACD;;AAGA,MAAM,eAAe,EACpB,WACA,SACA,cAC4D;CAC5D;CACA;CACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAC5B;AAEA,MAAM,cAAc,OACnB,KACA,YACuB;CAEvB,IAAI,WAAW,CAAE,MAAM,SAAS,SAAS,GAAG,GAC3C,OAAO,mBAAmB;CAE3B,MAAM,SAAS,YAAY,GAAG;CAC9B,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK;CAC/C,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK;CAC/B,IAAI,WAAW,cAAc,IAAI;EAChC,MAAM,QAAQ,MAAM,qBAAqB;GAAE;GAAK;GAAY;EAAG,CAAC;EAChE,IAAI,CAAC,MAAM,IACV,OAAO,yBAAyB,MAAM,MAAM;EAE7C,MAAM,QAAQ,WAAW,SAAS,GAAG;EACrC,MAAM,QAAQ,MAAM,qBAAqB;GAAE;GAAS;GAAK;GAAY,MAAM,MAAM;GAAM;EAAM,CAAC;EAC9F,IAAI,CAAC,MAAM,IACV,OAAO,uBAAuB;EAE/B,MAAM,UAAU,MAAM,yBAAyB,KAAK;GACnD;GACA,GAAI,MAAM,UAAU,OAAO,CAAC,IAAI,EAAE,OAAO,MAAM,MAAM;EACtD,CAAC;EACD,OAAO,SAAS,KAAK,YAAY,OAAO,GAAG,EAAE,SAAS,SAAS,CAAC;CACjE;CACA,OAAO,SAAS,KAAK,YAAY,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,SAAS,SAAS,CAAC;AAC7F"}
@@ -0,0 +1,25 @@
1
+ import { translations } from "../translations/index.js";
2
+ import { deepMergeSimple } from "payload/shared";
3
+ //#region src/plugin/unbundledLanguages.ts
4
+ const bundled = new Set(Object.keys(translations));
5
+ /**
6
+ * Host admin languages this plugin ships no strings for. Payload reads a request's strings from
7
+ * `config.i18n.translations[language]` alone, so such a language would show raw keys.
8
+ */
9
+ const unbundledLanguages = (config) => Object.keys(config.i18n?.supportedLanguages ?? {}).filter((language) => !bundled.has(language));
10
+ /**
11
+ * Gives each {@link unbundledLanguages} entry English strings beneath whatever host or
12
+ * `translations` option set, which win key by key. Must run after `registerTranslations`.
13
+ */
14
+ const fillUnbundledLanguages = (config) => {
15
+ const missing = unbundledLanguages(config);
16
+ if (missing.length === 0) return;
17
+ const english = {};
18
+ for (const language of missing) english[language] = Object.fromEntries(Object.entries(translations.en).map(([namespace, strings]) => [namespace, { ...strings }]));
19
+ config.i18n ??= {};
20
+ config.i18n.translations = deepMergeSimple(english, config.i18n.translations ?? {});
21
+ };
22
+ //#endregion
23
+ export { fillUnbundledLanguages, unbundledLanguages };
24
+
25
+ //# sourceMappingURL=unbundledLanguages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unbundledLanguages.js","names":[],"sources":["../../src/plugin/unbundledLanguages.ts"],"sourcesContent":["import type { Config } from 'payload'\nimport { deepMergeSimple } from 'payload/shared'\n\nimport { translations } from '../translations'\n\ntype Translations = NonNullable<NonNullable<Config['i18n']>['translations']>\n\nconst bundled = new Set(Object.keys(translations))\n\n/**\n * Host admin languages this plugin ships no strings for. Payload reads a request's strings from\n * `config.i18n.translations[language]` alone, so such a language would show raw keys.\n */\nexport const unbundledLanguages = (config: Config): string[] =>\n\tObject.keys(config.i18n?.supportedLanguages ?? {}).filter((language) => !bundled.has(language))\n\n/**\n * Gives each {@link unbundledLanguages} entry English strings beneath whatever host or\n * `translations` option set, which win key by key. Must run after `registerTranslations`.\n */\nexport const fillUnbundledLanguages = (config: Config): void => {\n\tconst missing = unbundledLanguages(config)\n\tif (missing.length === 0) {\n\t\treturn\n\t}\n\tconst english: Record<string, Record<string, Record<string, string>>> = {}\n\tfor (const language of missing) {\n\t\tenglish[language] = Object.fromEntries(\n\t\t\tObject.entries(translations.en).map(([namespace, strings]) => [namespace, { ...strings }])\n\t\t)\n\t}\n\tconfig.i18n ??= {}\n\tconfig.i18n.translations = deepMergeSimple<Translations>(english, config.i18n.translations ?? {})\n}\n"],"mappings":";;;AAOA,MAAM,UAAU,IAAI,IAAI,OAAO,KAAK,YAAY,CAAC;;;;;AAMjD,MAAa,sBAAsB,WAClC,OAAO,KAAK,OAAO,MAAM,sBAAsB,CAAC,CAAC,EAAE,QAAQ,aAAa,CAAC,QAAQ,IAAI,QAAQ,CAAC;;;;;AAM/F,MAAa,0BAA0B,WAAyB;CAC/D,MAAM,UAAU,mBAAmB,MAAM;CACzC,IAAI,QAAQ,WAAW,GACtB;CAED,MAAM,UAAkE,CAAC;CACzE,KAAK,MAAM,YAAY,SACtB,QAAQ,YAAY,OAAO,YAC1B,OAAO,QAAQ,aAAa,EAAE,EAAE,KAAK,CAAC,WAAW,aAAa,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAC1F;CAED,OAAO,SAAS,CAAC;CACjB,OAAO,KAAK,eAAe,gBAA8B,SAAS,OAAO,KAAK,gBAAgB,CAAC,CAAC;AACjG"}
@@ -0,0 +1,24 @@
1
+ //#region src/plugin/walkFields.ts
2
+ const children = (field) => {
3
+ const out = [];
4
+ if ("fields" in field && Array.isArray(field.fields)) out.push(...field.fields);
5
+ if ("tabs" in field && Array.isArray(field.tabs)) for (const tab of field.tabs) out.push(...tab.fields);
6
+ if ("blocks" in field && Array.isArray(field.blocks)) {
7
+ for (const block of field.blocks) if (typeof block !== "string") out.push(...block.fields);
8
+ }
9
+ return out;
10
+ };
11
+ /**
12
+ * Every field of a tree, parents first, through rows, collapsibles, groups, arrays, tabs and inline
13
+ * blocks. Depth-first, so a caller keeping the first match keeps the one nearest the top.
14
+ */
15
+ function* walkFields(fields) {
16
+ for (const field of fields) {
17
+ yield field;
18
+ yield* walkFields(children(field));
19
+ }
20
+ }
21
+ //#endregion
22
+ export { walkFields };
23
+
24
+ //# sourceMappingURL=walkFields.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"walkFields.js","names":[],"sources":["../../src/plugin/walkFields.ts"],"sourcesContent":["import type { Field } from 'payload'\n\nconst children = (field: Field): Field[] => {\n\tconst out: Field[] = []\n\tif ('fields' in field && Array.isArray(field.fields)) {\n\t\tout.push(...field.fields)\n\t}\n\tif ('tabs' in field && Array.isArray(field.tabs)) {\n\t\tfor (const tab of field.tabs) {\n\t\t\tout.push(...tab.fields)\n\t\t}\n\t}\n\t// A slug names a block of `config.blocks`, which is walked where it is defined rather than\n\t// once per field that names it.\n\tif ('blocks' in field && Array.isArray(field.blocks)) {\n\t\tfor (const block of field.blocks) {\n\t\t\tif (typeof block !== 'string') {\n\t\t\t\tout.push(...block.fields)\n\t\t\t}\n\t\t}\n\t}\n\treturn out\n}\n\n/**\n * Every field of a tree, parents first, through rows, collapsibles, groups, arrays, tabs and inline\n * blocks. Depth-first, so a caller keeping the first match keeps the one nearest the top.\n */\nexport function* walkFields(fields: Field[]): Generator<Field> {\n\tfor (const field of fields) {\n\t\tyield field\n\t\tyield* walkFields(children(field))\n\t}\n}\n"],"mappings":";AAEA,MAAM,YAAY,UAA0B;CAC3C,MAAM,MAAe,CAAC;CACtB,IAAI,YAAY,SAAS,MAAM,QAAQ,MAAM,MAAM,GAClD,IAAI,KAAK,GAAG,MAAM,MAAM;CAEzB,IAAI,UAAU,SAAS,MAAM,QAAQ,MAAM,IAAI,GAC9C,KAAK,MAAM,OAAO,MAAM,MACvB,IAAI,KAAK,GAAG,IAAI,MAAM;CAKxB,IAAI,YAAY,SAAS,MAAM,QAAQ,MAAM,MAAM;OAC7C,MAAM,SAAS,MAAM,QACzB,IAAI,OAAO,UAAU,UACpB,IAAI,KAAK,GAAG,MAAM,MAAM;CAAA;CAI3B,OAAO;AACR;;;;;AAMA,UAAiB,WAAW,QAAmC;CAC9D,KAAK,MAAM,SAAS,QAAQ;EAC3B,MAAM;EACN,OAAO,WAAW,SAAS,KAAK,CAAC;CAClC;AACD"}
Binary file
@@ -1 +1 @@
1
- {"version":3,"file":"warmTask.js","names":[],"sources":["../../src/plugin/warmTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig, WidgetInstance } from 'payload'\nimport type { DimensionKey, MetricKey } from '../core/contract'\nimport type { ScopesResolver } from '../core/options'\nimport { resolveScopeList } from '../core/scopeList'\nimport { TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\nimport { breakdownSpecBySlug } from '../widgets/breakdownTypes'\nimport { resolveCustomRange } from '../widgets/range'\nimport { readForWidget, type WidgetReadStatus } from '../widgets/readForWidget'\nimport { readForWidgetBreakdown } from '../widgets/readForWidgetBreakdown'\nimport { readForWidgetSeries } from '../widgets/readForWidgetSeries'\nimport { WIDGET_METRICS, type WidgetRange } from '../widgets/types'\nimport { getRuntime, resolveTimezoneFor } from './runtime'\n\n/** Minimal shape of a dashboard widget instance the warm job reads. */\nexport interface WarmWidgetInstance {\n\twidgetSlug?: string\n\tdata?: Record<string, unknown>\n}\n\nexport type WarmTarget =\n\t| {\n\t\t\tkind: 'metric'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'series'\n\t\t\tmetric: MetricKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\t| {\n\t\t\tkind: 'breakdown'\n\t\t\tmetric: MetricKey\n\t\t\tdimension: DimensionKey\n\t\t\ttimeframe: TimeframePreset\n\t\t\tlimit: number\n\t\t\trange?: WidgetRange\n\t\t\tadapterId?: string\n\t }\n\nconst asString = (v: unknown): string | undefined => (typeof v === 'string' ? v : undefined)\n\nconst asMetric = (v: unknown): MetricKey =>\n\ttypeof v === 'string' && (WIDGET_METRICS as readonly string[]).includes(v)\n\t\t? (v as MetricKey)\n\t\t: 'pageviews'\n\nconst asTimeframe = (v: unknown): TimeframePreset | 'custom' => {\n\tif (v === 'custom') {\n\t\treturn 'custom'\n\t}\n\tif (typeof v === 'string' && (TIMEFRAME_PRESETS as readonly string[]).includes(v)) {\n\t\treturn v as TimeframePreset\n\t}\n\treturn 'last30days'\n}\n\nconst asLimit = (v: unknown): number => (typeof v === 'number' && v > 0 ? v : 5)\n\nconst asRange = (v: unknown): WidgetRange | undefined => {\n\tif (!v || typeof v !== 'object') {\n\t\treturn undefined\n\t}\n\tconst r = v as { from?: unknown; to?: unknown }\n\treturn { from: asString(r.from), to: asString(r.to) }\n}\n\nconst targetKey = (t: WarmTarget): string => {\n\tconst range = t.range ? `${t.range.from ?? ''}:${t.range.to ?? ''}` : ''\n\tconst dimension = t.kind === 'breakdown' ? t.dimension : ''\n\tconst limit = t.kind === 'breakdown' ? String(t.limit) : ''\n\treturn `${t.kind}:${t.metric}:${dimension}:${t.timeframe}:${limit}:${t.adapterId ?? ''}:${range}`\n}\n\n/**\n * Map a dashboard's widget layout to the set of reads that warm its cache. Built-in\n * metric, trend, and breakdown widgets become targets; the realtime widget is skipped\n * (its short-TTL key is kept warm by the live poller) and any other slug is a custom app\n * widget whose read shape the plugin does not know. A `custom` timeframe is kept only when\n * its range resolves (the read takes an explicit range; `timeframe` is then unused), and\n * the stored bounds travel with the target rather than concrete instants: which instants\n * two picked days span depends on the reporting timezone, which is per scope and so only\n * known inside the warm loop. Identical targets are de-duplicated so a repeated widget\n * warms its tuple once.\n */\nexport const deriveWarmTargets = (widgets: readonly WarmWidgetInstance[]): WarmTarget[] => {\n\tconst out: WarmTarget[] = []\n\tconst seen = new Set<string>()\n\tfor (const widget of widgets) {\n\t\tconst slug = widget.widgetSlug\n\t\tif (!slug || slug === 'analytics-realtime') {\n\t\t\tcontinue\n\t\t}\n\t\tconst data = widget.data ?? {}\n\t\tconst metric = asMetric(data.metric)\n\t\tconst adapterId = asString(data.dataSource)\n\t\tconst timeframeRaw = asTimeframe(data.timeframe)\n\t\tlet timeframe: TimeframePreset = 'last30days'\n\t\tlet range: WidgetRange | undefined\n\t\tif (timeframeRaw === 'custom') {\n\t\t\tconst stored = asRange(data.range)\n\t\t\t// Whether the bounds name real days is timezone-independent, so the skip decision\n\t\t\t// can be taken here even though the window itself cannot.\n\t\t\tif (!resolveCustomRange('custom', stored, DEFAULT_TIMEZONE)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\trange = stored\n\t\t} else {\n\t\t\ttimeframe = timeframeRaw\n\t\t}\n\n\t\tlet target: WarmTarget | undefined\n\t\tif (slug === 'analytics-metric') {\n\t\t\ttarget = { kind: 'metric', metric, timeframe, range, adapterId }\n\t\t} else if (slug === 'analytics-trend') {\n\t\t\ttarget = { kind: 'series', metric, timeframe, range, adapterId }\n\t\t} else {\n\t\t\tconst spec = breakdownSpecBySlug(slug)\n\t\t\tif (spec) {\n\t\t\t\ttarget = {\n\t\t\t\t\tkind: 'breakdown',\n\t\t\t\t\tmetric,\n\t\t\t\t\tdimension: spec.dimension,\n\t\t\t\t\ttimeframe,\n\t\t\t\t\tlimit: asLimit(data.limit),\n\t\t\t\t\trange,\n\t\t\t\t\tadapterId,\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (!target) {\n\t\t\tcontinue\n\t\t}\n\t\tconst key = targetKey(target)\n\t\tif (seen.has(key)) {\n\t\t\tcontinue\n\t\t}\n\t\tseen.add(key)\n\t\tout.push(target)\n\t}\n\treturn out\n}\n\nexport const WARM_TASK_SLUG = 'analytics-warm-cache'\n\n/** A dashboard `defaultLayout`: an array, or a function resolving one per request. */\nexport type WarmLayout =\n\t| ((args: { req: PayloadRequest }) => WidgetInstance[] | Promise<WidgetInstance[]>)\n\t| WidgetInstance[]\n\t| undefined\n\nconst resolveLayout = async (\n\tlayout: WarmLayout,\n\treq: PayloadRequest\n): Promise<WarmWidgetInstance[]> => {\n\ttry {\n\t\tconst list = typeof layout === 'function' ? await layout({ req }) : (layout ?? [])\n\t\treturn list.map((w) => ({ widgetSlug: w.widgetSlug, data: w.data }))\n\t} catch (err) {\n\t\treq.payload.logger.warn(\n\t\t\t`analytics warm-cache: could not resolve the dashboard layout: ${String(err)}`\n\t\t)\n\t\treturn []\n\t}\n}\n\ninterface TargetRunResult {\n\tstatus: WidgetReadStatus\n\tadapterId: string\n}\n\n/**\n * Run one target's read for one scope; the caller decides how to count/log the status. The\n * stored custom bounds resolve here, in that scope's reporting timezone, so the warmed key\n * is the one the rendered widget will ask for.\n */\nconst runTarget = async (args: {\n\ttarget: WarmTarget\n\treq: PayloadRequest\n\tnow: Date\n\tscope: string | null\n\ttimezone: string\n}): Promise<TargetRunResult> => {\n\tconst { target, req, now, scope, timezone } = args\n\tconst range = resolveCustomRange('custom', target.range, timezone)\n\tif (target.kind === 'metric') {\n\t\tconst result = await readForWidget({\n\t\t\treq,\n\t\t\tmetrics: [target.metric],\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t})\n\t\treturn { status: result.status, adapterId: result.adapterId }\n\t}\n\tif (target.kind === 'series') {\n\t\tconst result = await readForWidgetSeries({\n\t\t\treq,\n\t\t\tmetric: target.metric,\n\t\t\ttimeframe: target.timeframe,\n\t\t\tadapterId: target.adapterId,\n\t\t\tnow,\n\t\t\trange,\n\t\t\tscope,\n\t\t\ttimezone,\n\t\t})\n\t\treturn { status: result.status, adapterId: result.adapterId }\n\t}\n\tconst result = await readForWidgetBreakdown({\n\t\treq,\n\t\tmetric: target.metric,\n\t\tdimension: target.dimension,\n\t\ttimeframe: target.timeframe,\n\t\tlimit: target.limit,\n\t\tadapterId: target.adapterId,\n\t\tnow,\n\t\trange,\n\t\tscope,\n\t\ttimezone,\n\t})\n\treturn { status: result.status, adapterId: result.adapterId }\n}\n\n/**\n * Opt-in Payload task that pre-runs the dashboard's widget reads through the surfacing\n * engine so `payload.kv` is warm before a user opens the dashboard. Targets are derived\n * from `layout` (the app's `defaultLayout`, captured at registration and resolved here);\n * each read is isolated so one failing provider does not abort the rest. Most valuable\n * for slow or rate-limited provider adapters; native reads are cheap and harmless to warm.\n * With `scopes` configured, every target runs once per tenant scope (plus the install-wide\n * scope) so a multi-tenant install warms every tenant's dashboard, not just the null one.\n */\nexport const warmTask = (\n\tcron: string,\n\tlayout: WarmLayout,\n\tscopes?: ScopesResolver\n): TaskConfig<{ input: Record<string, never>; output: { warmed: number; failed: number } }> => ({\n\tslug: WARM_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst targets = deriveWarmTargets(await resolveLayout(layout, req))\n\t\tif (targets.length === 0) {\n\t\t\treturn { output: { warmed: 0, failed: 0 } }\n\t\t}\n\t\tconst scopeList = await resolveScopeList(scopes, req.payload)\n\t\tconst now = new Date()\n\t\tlet warmed = 0\n\t\tlet failed = 0\n\t\t// A tenant-pass target that degrades (e.g. a shared config adapter gated for\n\t\t// that scope) is not a failure, but a silent one leaves `warmed` unexplainably\n\t\t// short of `scopes x targets`; warn once per (scope, adapter) so it is visible.\n\t\tconst warnedGated = new Set<string>()\n\t\tconst runtime = getRuntime(req.payload)\n\t\tfor (const scope of scopeList) {\n\t\t\tconst timezone = runtime ? await resolveTimezoneFor(runtime, req, scope) : DEFAULT_TIMEZONE\n\t\t\tfor (const target of targets) {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await runTarget({ target, req, now, scope, timezone })\n\t\t\t\t\tif (result.status === 'ok') {\n\t\t\t\t\t\twarmed++\n\t\t\t\t\t} else if (scope !== null) {\n\t\t\t\t\t\tconst key = `${scope}\u0000${result.adapterId}`\n\t\t\t\t\t\tif (!warnedGated.has(key)) {\n\t\t\t\t\t\t\twarnedGated.add(key)\n\t\t\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t\t\t`analytics warm-cache: scope \"${scope}\" adapter \"${result.adapterId}\" returned \"${result.status}\", skipping`\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} catch (err) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics warm-cache: ${target.kind} read for \"${target.metric}\" (scope \"${scope ?? ''}\") failed: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { warmed, failed } }\n\t},\n\tschedule: [{ cron, queue: 'default' }],\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"warmTask.js","names":[],"sources":["../../src/plugin/warmTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport { currentDate } from '../core/clock'\nimport { type ScheduledTask, TASK_SLUGS } from '../core/jobs'\nimport { monotonicMs } from '../core/monotonic'\nimport type { AdapterRegistry } from '../core/registry'\nimport { systemRegistryFor } from '../core/scopedRead'\nimport {\n\ttype LeaseHold,\n\tstateLease,\n\tstateStoreOf,\n\tTASK_LEASE_MS,\n\tunderLease,\n} from '../maintenance/lease'\nimport { concurrencyFor, scheduleFor, TASK_BUDGET_MS } from '../maintenance/taskSchedule'\nimport type { CacheStore, ReadRecipe } from '../surfacing/cacheStore'\nimport { recipeWindow } from '../surfacing/recipe'\nimport { HOUR_MS } from '../timeframe/tz'\nimport { type AnalyticsRuntime, getRuntime, resolveTimezoneFor } from './runtime'\n\nexport const WARM_TASK_SLUG = TASK_SLUGS.warm\n\nexport interface WarmTaskOptions {\n\tschedule: ScheduledTask\n\t/** `cache.warm.windowHours`: a read asked for this recently is kept warm. */\n\twindowHours: number\n\t/** `cache.warm.maxReads`: the most reads one run refreshes. */\n\tmaxReads: number\n\t/** How long one run works before it leaves the rest to the next; {@link TASK_BUDGET_MS}. */\n\tbudgetMs?: number\n\t/** Milliseconds the budget is spent in; `monotonicMs` unless a test hands one in. */\n\tclock?: () => number\n}\n\n/**\n * What one run did with recent reads: `fresh` outlives the next run, `skipped` lost its source or\n * window. `ran` is false when another run held the lease, `finished` when the budget ran out.\n */\nexport interface WarmTaskOutput {\n\tran: boolean\n\tfinished: boolean\n\trefreshed: number\n\tfresh: number\n\tskipped: number\n\tfailed: number\n}\n\nconst NOTHING: Omit<WarmTaskOutput, 'ran' | 'finished'> = {\n\trefreshed: 0,\n\tfresh: 0,\n\tskipped: 0,\n\tfailed: 0,\n}\n\nconst notRun = (): { output: WarmTaskOutput } => ({\n\toutput: { ran: false, finished: false, ...NOTHING },\n})\n\n/** Recent recipes read per recipe a run warms, so the scopes behind the busiest one are seen too. */\nconst RECIPES_READ_PER_WARM = 4\n\n/**\n * At most `limit` recipes taken in turn from each scope, the most recently read first within a\n * scope and among the scopes, so one busy scope's reads never take every place of a run.\n */\nexport const takeInTurn = (recipes: readonly ReadRecipe[], limit: number): ReadRecipe[] => {\n\tconst queues = new Map<string | null, ReadRecipe[]>()\n\tfor (const recipe of recipes) {\n\t\tconst queue = queues.get(recipe.scope)\n\t\tif (queue) {\n\t\t\tqueue.push(recipe)\n\t\t} else {\n\t\t\tqueues.set(recipe.scope, [recipe])\n\t\t}\n\t}\n\tconst taken: ReadRecipe[] = []\n\tfor (let round = 0; taken.length < limit; round++) {\n\t\tlet any = false\n\t\tfor (const queue of queues.values()) {\n\t\t\tconst recipe = queue[round]\n\t\t\tif (recipe !== undefined && taken.length < limit) {\n\t\t\t\ttaken.push(recipe)\n\t\t\t\tany = true\n\t\t\t}\n\t\t}\n\t\tif (!any) {\n\t\t\tbreak\n\t\t}\n\t}\n\treturn taken\n}\n\n/** A scope's sources and timezone, resolved once per run, or why they could not be. */\ntype ScopeSources = { ok: true; registry: AdapterRegistry | null; tz: string } | { ok: false }\n\n/** Each scope's sources, resolved as SYSTEM on first ask and shared by the rest of the run. */\nconst scopeSourcesFor = (runtime: AnalyticsRuntime, req: PayloadRequest) => {\n\tconst resolved = new Map<string | null, Promise<ScopeSources>>()\n\tconst resolve = async (scope: string | null): Promise<ScopeSources> => {\n\t\ttry {\n\t\t\tconst registry = await systemRegistryFor(runtime, req, scope)\n\t\t\tconst tz = await resolveTimezoneFor(runtime, req, scope)\n\t\t\treturn { ok: true, registry, tz }\n\t\t} catch (err) {\n\t\t\treq.payload.logger.warn(\n\t\t\t\t`analytics warm: the sources of scope \"${scope ?? 'install-wide'}\" could not be resolved: ${String(err)}`\n\t\t\t)\n\t\t\treturn { ok: false }\n\t\t}\n\t}\n\treturn (scope: string | null): Promise<ScopeSources> => {\n\t\tconst known = resolved.get(scope)\n\t\tif (known) {\n\t\t\treturn known\n\t\t}\n\t\tconst resolving = resolve(scope)\n\t\tresolved.set(scope, resolving)\n\t\treturn resolving\n\t}\n}\n\ninterface WarmPass {\n\truntime: AnalyticsRuntime\n\tstore: CacheStore\n\treq: PayloadRequest\n\topts: WarmTaskOptions\n\thold: LeaseHold\n}\n\n/**\n * Rereads recent recipes, in turn per scope, whose today-window entry is missing or expires before\n * the next run: as SYSTEM via the scope's own sources, at background priority, within budget.\n */\nconst warmRecent = async ({ runtime, store, req, opts, hold }: WarmPass) => {\n\tconst now = currentDate()\n\tconst clock = opts.clock ?? monotonicMs\n\tconst deadline = clock() + (opts.budgetMs ?? TASK_BUDGET_MS)\n\tconst counts = { ...NOTHING }\n\tconst recipes = takeInTurn(\n\t\tawait store.recentRecipes(\n\t\t\tnew Date(now.getTime() - opts.windowHours * HOUR_MS),\n\t\t\topts.maxReads * RECIPES_READ_PER_WARM\n\t\t),\n\t\topts.maxReads\n\t)\n\tconst sourcesOf = scopeSourcesFor(runtime, req)\n\tconst warned = new Set<string>()\n\tlet finished = true\n\tfor (const recipe of recipes) {\n\t\tif (hold.lost() || clock() >= deadline) {\n\t\t\tfinished = false\n\t\t\tbreak\n\t\t}\n\t\tconst { scope } = recipe\n\t\tconst sources = await sourcesOf(scope)\n\t\tif (!sources.ok) {\n\t\t\tcounts.failed++\n\t\t\tcontinue\n\t\t}\n\t\tconst adapter = sources.registry?.all().find((each) => each.id === recipe.adapterRef)\n\t\tconst dateRange = recipeWindow(recipe, now, sources.tz)\n\t\tif (!adapter || !dateRange || !runtime.engine.refresh) {\n\t\t\tcounts.skipped++\n\t\t\tcontinue\n\t\t}\n\t\ttry {\n\t\t\tconst outcome = await runtime.engine.refresh(\n\t\t\t\tadapter,\n\t\t\t\t{ ...recipe.query, timezone: sources.tz, dateRange },\n\t\t\t\t{ freshForMs: opts.schedule.intervalMs, priority: 'background' }\n\t\t\t)\n\t\t\tcounts[outcome]++\n\t\t} catch (err) {\n\t\t\tcounts.failed++\n\t\t\tconst source = `${scope ?? ''} ${adapter.id}`\n\t\t\tif (!warned.has(source)) {\n\t\t\t\twarned.add(source)\n\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t`analytics warm: a read from \"${adapter.id}\" (scope \"${scope ?? ''}\") failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\treturn { ...counts, finished }\n}\n\n/**\n * `analytics-warm`: keeps reads from the last `windowHours` warm, one run at a time under the task\n * lease. A missed read is still served stale and refreshed, so nothing replaces a skipped run.\n */\nexport const warmTask = (\n\topts: WarmTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: WarmTaskOutput }> => ({\n\tslug: WARM_TASK_SLUG,\n\tretries: 0,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tconst store = runtime?.cache?.store\n\t\tif (!runtime || !store) {\n\t\t\treturn notRun()\n\t\t}\n\t\tconst warn = (message: string) => req.payload.logger.warn(message)\n\t\tconst outcome = await underLease(\n\t\t\t{ lease: stateLease(req.payload, WARM_TASK_SLUG, TASK_LEASE_MS), ttlMs: TASK_LEASE_MS, warn },\n\t\t\t(hold) => warmRecent({ runtime, store, req, opts, hold })\n\t\t)\n\t\tif (!outcome.ran) {\n\t\t\treturn notRun()\n\t\t}\n\t\tawait stateStoreOf(req.payload)\n\t\t\t?.beat(WARM_TASK_SLUG)\n\t\t\t.catch((err: unknown) =>\n\t\t\t\twarn(`analytics warm: stamping its heartbeat failed: ${String(err)}`)\n\t\t\t)\n\t\treturn { output: { ran: true, ...outcome.value } }\n\t},\n\t...scheduleFor(opts.schedule),\n\t...concurrencyFor('warm'),\n})\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,iBAAiB,WAAW;AA2BzC,MAAM,UAAoD;CACzD,WAAW;CACX,OAAO;CACP,SAAS;CACT,QAAQ;AACT;AAEA,MAAM,gBAA4C,EACjD,QAAQ;CAAE,KAAK;CAAO,UAAU;CAAO,GAAG;AAAQ,EACnD;;AAGA,MAAM,wBAAwB;;;;;AAM9B,MAAa,cAAc,SAAgC,UAAgC;CAC1F,MAAM,yBAAS,IAAI,IAAiC;CACpD,KAAK,MAAM,UAAU,SAAS;EAC7B,MAAM,QAAQ,OAAO,IAAI,OAAO,KAAK;EACrC,IAAI,OACH,MAAM,KAAK,MAAM;OAEjB,OAAO,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC;CAEnC;CACA,MAAM,QAAsB,CAAC;CAC7B,KAAK,IAAI,QAAQ,GAAG,MAAM,SAAS,OAAO,SAAS;EAClD,IAAI,MAAM;EACV,KAAK,MAAM,SAAS,OAAO,OAAO,GAAG;GACpC,MAAM,SAAS,MAAM;GACrB,IAAI,WAAW,KAAA,KAAa,MAAM,SAAS,OAAO;IACjD,MAAM,KAAK,MAAM;IACjB,MAAM;GACP;EACD;EACA,IAAI,CAAC,KACJ;CAEF;CACA,OAAO;AACR;;AAMA,MAAM,mBAAmB,SAA2B,QAAwB;CAC3E,MAAM,2BAAW,IAAI,IAA0C;CAC/D,MAAM,UAAU,OAAO,UAAgD;EACtE,IAAI;GAGH,OAAO;IAAE,IAAI;IAAM,UAAA,MAFI,kBAAkB,SAAS,KAAK,KAAK;IAE/B,IAAA,MADZ,mBAAmB,SAAS,KAAK,KAAK;GACvB;EACjC,SAAS,KAAK;GACb,IAAI,QAAQ,OAAO,KAClB,yCAAyC,SAAS,eAAe,2BAA2B,OAAO,GAAG,GACvG;GACA,OAAO,EAAE,IAAI,MAAM;EACpB;CACD;CACA,QAAQ,UAAgD;EACvD,MAAM,QAAQ,SAAS,IAAI,KAAK;EAChC,IAAI,OACH,OAAO;EAER,MAAM,YAAY,QAAQ,KAAK;EAC/B,SAAS,IAAI,OAAO,SAAS;EAC7B,OAAO;CACR;AACD;;;;;AAcA,MAAM,aAAa,OAAO,EAAE,SAAS,OAAO,KAAK,MAAM,WAAqB;CAC3E,MAAM,MAAM,YAAY;CACxB,MAAM,QAAQ,KAAK,SAAS;CAC5B,MAAM,WAAW,MAAM,KAAK,KAAK,YAAA;CACjC,MAAM,SAAS,EAAE,GAAG,QAAQ;CAC5B,MAAM,UAAU,WACf,MAAM,MAAM,cACX,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,cAAc,OAAO,GACnD,KAAK,WAAW,qBACjB,GACA,KAAK,QACN;CACA,MAAM,YAAY,gBAAgB,SAAS,GAAG;CAC9C,MAAM,yBAAS,IAAI,IAAY;CAC/B,IAAI,WAAW;CACf,KAAK,MAAM,UAAU,SAAS;EAC7B,IAAI,KAAK,KAAK,KAAK,MAAM,KAAK,UAAU;GACvC,WAAW;GACX;EACD;EACA,MAAM,EAAE,UAAU;EAClB,MAAM,UAAU,MAAM,UAAU,KAAK;EACrC,IAAI,CAAC,QAAQ,IAAI;GAChB,OAAO;GACP;EACD;EACA,MAAM,UAAU,QAAQ,UAAU,IAAI,EAAE,MAAM,SAAS,KAAK,OAAO,OAAO,UAAU;EACpF,MAAM,YAAY,aAAa,QAAQ,KAAK,QAAQ,EAAE;EACtD,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,OAAO,SAAS;GACtD,OAAO;GACP;EACD;EACA,IAAI;GACH,MAAM,UAAU,MAAM,QAAQ,OAAO,QACpC,SACA;IAAE,GAAG,OAAO;IAAO,UAAU,QAAQ;IAAI;GAAU,GACnD;IAAE,YAAY,KAAK,SAAS;IAAY,UAAU;GAAa,CAChE;GACA,OAAO;EACR,SAAS,KAAK;GACb,OAAO;GACP,MAAM,SAAS,GAAG,SAAS,GAAG,GAAG,QAAQ;GACzC,IAAI,CAAC,OAAO,IAAI,MAAM,GAAG;IACxB,OAAO,IAAI,MAAM;IACjB,IAAI,QAAQ,OAAO,KAClB,gCAAgC,QAAQ,GAAG,YAAY,SAAS,GAAG,aAAa,OAAO,GAAG,GAC3F;GACD;EACD;CACD;CACA,OAAO;EAAE,GAAG;EAAQ;CAAS;AAC9B;;;;;AAMA,MAAa,YACZ,UAC2E;CAC3E,MAAM;CACN,SAAS;CACT,SAAS,OAAO,EAAE,UAAU;EAC3B,MAAM,UAAU,WAAW,IAAI,OAAO;EACtC,MAAM,QAAQ,SAAS,OAAO;EAC9B,IAAI,CAAC,WAAW,CAAC,OAChB,OAAO,OAAO;EAEf,MAAM,QAAQ,YAAoB,IAAI,QAAQ,OAAO,KAAK,OAAO;EACjE,MAAM,UAAU,MAAM,WACrB;GAAE,OAAO,WAAW,IAAI,SAAS,gBAAgB,aAAa;GAAG,OAAO;GAAe;EAAK,IAC3F,SAAS,WAAW;GAAE;GAAS;GAAO;GAAK;GAAM;EAAK,CAAC,CACzD;EACA,IAAI,CAAC,QAAQ,KACZ,OAAO,OAAO;EAEf,MAAM,aAAa,IAAI,OAAO,GAC3B,KAAK,cAAc,EACpB,OAAO,QACP,KAAK,kDAAkD,OAAO,GAAG,GAAG,CACrE;EACD,OAAO,EAAE,QAAQ;GAAE,KAAK;GAAM,GAAG,QAAQ;EAAM,EAAE;CAClD;CACA,GAAG,YAAY,KAAK,QAAQ;CAC5B,GAAG,eAAe,MAAM;AACzB"}
@@ -0,0 +1,11 @@
1
+ //#region src/providers/ProvidersListNotice.d.ts
2
+ /**
3
+ * The providers list's note to a tenant reading the platform's source until it adds its own. Read
4
+ * past the shared cache: this list is where a source is added, and a cached listing outlives that.
5
+ *
6
+ * @beta
7
+ */
8
+ declare function ProvidersListNotice(): import("react/jsx-runtime").JSX.Element;
9
+ //#endregion
10
+ export { ProvidersListNotice };
11
+ //# sourceMappingURL=ProvidersListNotice.d.ts.map
@@ -0,0 +1,36 @@
1
+ "use client";
2
+ import { analyticsRoutes } from "../plugin/routes.js";
3
+ import { apiPath } from "../plugin/apiPath.js";
4
+ import { useRequestScope } from "../ui/data/useRequestScope.js";
5
+ import { requestSources } from "../fields/config/fetchSources.js";
6
+ import { SourcesNoticeBanner } from "../ui/components/SourcesNoticeBanner.js";
7
+ import { useEffect, useState } from "react";
8
+ import { jsx } from "react/jsx-runtime";
9
+ import { useConfig } from "@payloadcms/ui";
10
+ //#region src/providers/ProvidersListNotice.tsx
11
+ /**
12
+ * The providers list's note to a tenant reading the platform's source until it adds its own. Read
13
+ * past the shared cache: this list is where a source is added, and a cached listing outlives that.
14
+ *
15
+ * @beta
16
+ */
17
+ function ProvidersListNotice() {
18
+ const { config } = useConfig();
19
+ const url = apiPath(config, analyticsRoutes(config).sources);
20
+ const scope = useRequestScope();
21
+ const [read, setRead] = useState();
22
+ useEffect(() => {
23
+ if (!scope) return;
24
+ const controller = new AbortController();
25
+ requestSources(url, controller.signal).then((listing) => setRead({
26
+ scope,
27
+ notice: listing.notice
28
+ }), () => {});
29
+ return () => controller.abort();
30
+ }, [url, scope]);
31
+ return /* @__PURE__ */ jsx(SourcesNoticeBanner, { notice: read?.scope === scope ? read.notice : void 0 });
32
+ }
33
+ //#endregion
34
+ export { ProvidersListNotice };
35
+
36
+ //# sourceMappingURL=ProvidersListNotice.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ProvidersListNotice.js","names":[],"sources":["../../src/providers/ProvidersListNotice.tsx"],"sourcesContent":["'use client'\n\nimport { useConfig } from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { requestSources, type SourcesNotice } from '../fields/config/fetchSources'\nimport { apiPath } from '../plugin/apiPath'\nimport { analyticsRoutes } from '../plugin/routes'\nimport { SourcesNoticeBanner } from '../ui/components/SourcesNoticeBanner'\nimport { useRequestScope } from '../ui/data/useRequestScope'\n\n/**\n * The providers list's note to a tenant reading the platform's source until it adds its own. Read\n * past the shared cache: this list is where a source is added, and a cached listing outlives that.\n *\n * @beta\n */\nexport function ProvidersListNotice() {\n\tconst { config } = useConfig()\n\tconst url = apiPath(config, analyticsRoutes(config).sources)\n\tconst scope = useRequestScope()\n\tconst [read, setRead] = useState<{ scope: string; notice: SourcesNotice | undefined }>()\n\n\tuseEffect(() => {\n\t\tif (!scope) {\n\t\t\treturn\n\t\t}\n\t\tconst controller = new AbortController()\n\t\t// A listing that fails says nothing here: the list itself works without the note.\n\t\trequestSources(url, controller.signal).then(\n\t\t\t(listing) => setRead({ scope, notice: listing.notice }),\n\t\t\t() => {}\n\t\t)\n\t\treturn () => controller.abort()\n\t}, [url, scope])\n\n\treturn <SourcesNoticeBanner notice={read?.scope === scope ? read.notice : undefined} />\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAgB,sBAAsB;CACrC,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,MAAM,QAAQ,QAAQ,gBAAgB,MAAM,EAAE,OAAO;CAC3D,MAAM,QAAQ,gBAAgB;CAC9B,MAAM,CAAC,MAAM,WAAW,SAA+D;CAEvF,gBAAgB;EACf,IAAI,CAAC,OACJ;EAED,MAAM,aAAa,IAAI,gBAAgB;EAEvC,eAAe,KAAK,WAAW,MAAM,EAAE,MACrC,YAAY,QAAQ;GAAE;GAAO,QAAQ,QAAQ;EAAO,CAAC,SAChD,CAAC,CACR;EACA,aAAa,WAAW,MAAM;CAC/B,GAAG,CAAC,KAAK,KAAK,CAAC;CAEf,OAAO,oBAAC,qBAAD,EAAqB,QAAQ,MAAM,UAAU,QAAQ,KAAK,SAAS,KAAA,EAAY,CAAA;AACvF"}
@@ -0,0 +1 @@
1
+ import { Access, PayloadRequest } from "payload";
@@ -1,3 +1,5 @@
1
+ import { isAdminUser } from "../access/adminUser.js";
2
+ import { isScopeMember } from "../access/membership.js";
1
3
  //#region src/providers/access.ts
2
4
  const resolveOrNull = async (args, req) => {
3
5
  try {
@@ -8,37 +10,44 @@ const resolveOrNull = async (args, req) => {
8
10
  }
9
11
  };
10
12
  /**
11
- * Row access (read/update/delete) for the provider collection. Unscoped
12
- * installs keep the historical any-authenticated-user behavior. Scoped
13
- * installs constrain every row operation to the request's resolved scope via
14
- * a where clause (so list views filter instead of erroring); the platformRead
15
- * gate lifts the constraint for platform admins. A null or unresolvable scope
16
- * fails closed.
13
+ * The request's resolved scope while its user belongs to it, else null, so a tenant selector
14
+ * pointed at someone else's tenant opens nothing.
17
15
  */
18
- const providerRowAccess = (args) => {
19
- return async ({ req }) => {
20
- if (!req.user) return false;
21
- if (!args.scoped) return true;
22
- if (await args.platformRead({ req })) return true;
23
- const scope = await resolveOrNull(args, req);
24
- if (scope === null) return false;
25
- return { [args.scopeField]: { equals: scope } };
26
- };
16
+ const memberScopeOf = async (args, req) => {
17
+ const scope = await resolveOrNull(args, req);
18
+ if (scope === null) return null;
19
+ return await isScopeMember(args.member, req, scope) ? scope : null;
27
20
  };
28
21
  /**
29
- * Create access: any authenticated user in unscoped installs; in scoped
30
- * installs the requester needs a resolved scope (the stamp hook writes it) or
31
- * the platform grant (install-wide providers have no scope to resolve).
22
+ * What every operation shares: admin-collection users only, everything on an unscoped install or
23
+ * under the cross-scope grant; undefined leaves it to the request's member scope.
32
24
  */
33
- const providerCreateAccess = (args) => {
34
- return async ({ req }) => {
35
- if (!req.user) return false;
36
- if (!args.scoped) return true;
37
- if (await args.platformRead({ req })) return true;
38
- return await resolveOrNull(args, req) !== null;
39
- };
25
+ const sharedVerdict = async (args, req) => {
26
+ if (!isAdminUser({ req })) return false;
27
+ if (!args.scoped) return true;
28
+ if (await args.crossScope({ req })) return true;
29
+ };
30
+ /**
31
+ * Admin-collection users only. Scoped installs constrain rows to the request's member scope with a
32
+ * where clause (list views filter, not error) unless the cross-scope grant lifts it.
33
+ */
34
+ const providerRowAccess = (args) => async ({ req }) => {
35
+ const verdict = await sharedVerdict(args, req);
36
+ if (verdict !== void 0) return verdict;
37
+ const scope = await memberScopeOf(args, req);
38
+ if (scope === null) return false;
39
+ return { [args.scopeField]: { equals: scope } };
40
+ };
41
+ /**
42
+ * Admin-collection users only. Scoped installs need a member scope (the stamp hook writes it) or
43
+ * the cross-scope grant, since install-wide providers have no scope to resolve.
44
+ */
45
+ const providerCreateAccess = (args) => async ({ req }) => {
46
+ const verdict = await sharedVerdict(args, req);
47
+ if (verdict !== void 0) return verdict;
48
+ return await memberScopeOf(args, req) !== null;
40
49
  };
41
50
  //#endregion
42
- export { providerCreateAccess, providerRowAccess };
51
+ export { memberScopeOf, providerCreateAccess, providerRowAccess };
43
52
 
44
53
  //# sourceMappingURL=access.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"access.js","names":[],"sources":["../../src/providers/access.ts"],"sourcesContent":["import type { Access, PayloadRequest } from 'payload'\nimport type { PlatformReadAccess } from '../core/options'\n\nexport interface ProviderAccessArgs {\n\t/** True when the install configured a scopeResolver. */\n\tscoped: boolean\n\tscopeField: string\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\tplatformRead: PlatformReadAccess\n}\n\nconst resolveOrNull = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\ttry {\n\t\tconst scope = await args.resolveScope(req)\n\t\treturn scope === '' ? null : scope\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * Row access (read/update/delete) for the provider collection. Unscoped\n * installs keep the historical any-authenticated-user behavior. Scoped\n * installs constrain every row operation to the request's resolved scope via\n * a where clause (so list views filter instead of erroring); the platformRead\n * gate lifts the constraint for platform admins. A null or unresolvable scope\n * fails closed.\n */\nexport const providerRowAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\tconst scope = await resolveOrNull(args, req)\n\t\tif (scope === null) return false\n\t\treturn { [args.scopeField]: { equals: scope } }\n\t}\n}\n\n/**\n * Create access: any authenticated user in unscoped installs; in scoped\n * installs the requester needs a resolved scope (the stamp hook writes it) or\n * the platform grant (install-wide providers have no scope to resolve).\n */\nexport const providerCreateAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\treturn (await resolveOrNull(args, req)) !== null\n\t}\n}\n"],"mappings":";AAWA,MAAM,gBAAgB,OACrB,MACA,QAC4B;CAC5B,IAAI;EACH,MAAM,QAAQ,MAAM,KAAK,aAAa,GAAG;EACzC,OAAO,UAAU,KAAK,OAAO;CAC9B,QAAQ;EACP,OAAO;CACR;AACD;;;;;;;;;AAUA,MAAa,qBAAqB,SAAqC;CACtE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,MAAM,QAAQ,MAAM,cAAc,MAAM,GAAG;EAC3C,IAAI,UAAU,MAAM,OAAO;EAC3B,OAAO,GAAG,KAAK,aAAa,EAAE,QAAQ,MAAM,EAAE;CAC/C;AACD;;;;;;AAOA,MAAa,wBAAwB,SAAqC;CACzE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,OAAQ,MAAM,cAAc,MAAM,GAAG,MAAO;CAC7C;AACD"}
1
+ {"version":3,"file":"access.js","names":[],"sources":["../../src/providers/access.ts"],"sourcesContent":["import type { Access, PayloadRequest } from 'payload'\nimport { isAdminUser } from '../access/adminUser'\nimport { isScopeMember } from '../access/membership'\nimport type { CrossScopeAccess, ScopeMemberAccess } from '../core/options'\n\nexport interface ProviderAccessArgs {\n\t/** True when the install configured `scope.resolve`. */\n\tscoped: boolean\n\tscopeField: string\n\t/** The plugin's `scope.resolve` at the `admin` call site. */\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\t/** `scope.member`: whether the request's user belongs to the scope it resolved. */\n\tmember?: ScopeMemberAccess\n\t/** `access.crossScope.named`: acting on a scope other than the request's own. */\n\tcrossScope: CrossScopeAccess\n}\n\nconst resolveOrNull = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\ttry {\n\t\tconst scope = await args.resolveScope(req)\n\t\treturn scope === '' ? null : scope\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The request's resolved scope while its user belongs to it, else null, so a tenant selector\n * pointed at someone else's tenant opens nothing.\n */\nexport const memberScopeOf = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\tconst scope = await resolveOrNull(args, req)\n\tif (scope === null) {\n\t\treturn null\n\t}\n\treturn (await isScopeMember(args.member, req, scope)) ? scope : null\n}\n\n/**\n * What every operation shares: admin-collection users only, everything on an unscoped install or\n * under the cross-scope grant; undefined leaves it to the request's member scope.\n */\nconst sharedVerdict = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<boolean | undefined> => {\n\tif (!isAdminUser({ req })) return false\n\tif (!args.scoped) return true\n\tif (await args.crossScope({ req })) return true\n\treturn undefined\n}\n\n/**\n * Admin-collection users only. Scoped installs constrain rows to the request's member scope with a\n * where clause (list views filter, not error) unless the cross-scope grant lifts it.\n */\nexport const providerRowAccess =\n\t(args: ProviderAccessArgs): Access =>\n\tasync ({ req }) => {\n\t\tconst verdict = await sharedVerdict(args, req)\n\t\tif (verdict !== undefined) return verdict\n\t\tconst scope = await memberScopeOf(args, req)\n\t\tif (scope === null) return false\n\t\treturn { [args.scopeField]: { equals: scope } }\n\t}\n\n/**\n * Admin-collection users only. Scoped installs need a member scope (the stamp hook writes it) or\n * the cross-scope grant, since install-wide providers have no scope to resolve.\n */\nexport const providerCreateAccess =\n\t(args: ProviderAccessArgs): Access =>\n\tasync ({ req }) => {\n\t\tconst verdict = await sharedVerdict(args, req)\n\t\tif (verdict !== undefined) return verdict\n\t\treturn (await memberScopeOf(args, req)) !== null\n\t}\n"],"mappings":";;;AAiBA,MAAM,gBAAgB,OACrB,MACA,QAC4B;CAC5B,IAAI;EACH,MAAM,QAAQ,MAAM,KAAK,aAAa,GAAG;EACzC,OAAO,UAAU,KAAK,OAAO;CAC9B,QAAQ;EACP,OAAO;CACR;AACD;;;;;AAMA,MAAa,gBAAgB,OAC5B,MACA,QAC4B;CAC5B,MAAM,QAAQ,MAAM,cAAc,MAAM,GAAG;CAC3C,IAAI,UAAU,MACb,OAAO;CAER,OAAQ,MAAM,cAAc,KAAK,QAAQ,KAAK,KAAK,IAAK,QAAQ;AACjE;;;;;AAMA,MAAM,gBAAgB,OACrB,MACA,QACkC;CAClC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,OAAO;CAClC,IAAI,CAAC,KAAK,QAAQ,OAAO;CACzB,IAAI,MAAM,KAAK,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO;AAE5C;;;;;AAMA,MAAa,qBACX,SACD,OAAO,EAAE,UAAU;CAClB,MAAM,UAAU,MAAM,cAAc,MAAM,GAAG;CAC7C,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,MAAM,QAAQ,MAAM,cAAc,MAAM,GAAG;CAC3C,IAAI,UAAU,MAAM,OAAO;CAC3B,OAAO,GAAG,KAAK,aAAa,EAAE,QAAQ,MAAM,EAAE;AAC/C;;;;;AAMD,MAAa,wBACX,SACD,OAAO,EAAE,UAAU;CAClB,MAAM,UAAU,MAAM,cAAc,MAAM,GAAG;CAC7C,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,OAAQ,MAAM,cAAc,MAAM,GAAG,MAAO;AAC7C"}
@@ -0,0 +1,121 @@
1
+ import { currentTime } from "../core/clock.js";
2
+ /** How often idle adapters are looked for while anything is pooled. */
3
+ const SWEEP_EVERY_MS = 6e4;
4
+ /**
5
+ * Per-instance adapters keyed `id@updatedAt`, so an unchanged document is never decrypted again. A
6
+ * disposed adapter closes once no call is in flight, and again after any late call.
7
+ */
8
+ const createAdapterPool = (options) => {
9
+ const { payload } = options;
10
+ const idleMs = options.idleMs ?? 3e5;
11
+ const now = options.now ?? currentTime;
12
+ const entries = /* @__PURE__ */ new Map();
13
+ const closing = /* @__PURE__ */ new Set();
14
+ let timer;
15
+ const closeBuilt = (entry) => {
16
+ const { built } = entry;
17
+ if (!entry.owned || !built?.close) return;
18
+ const done = (async () => {
19
+ try {
20
+ await built.close?.(payload);
21
+ } catch (err) {
22
+ payload.logger?.warn(`analytics: closing the adapter of provider document "${entry.doc.id}" failed: ${String(err)}`);
23
+ }
24
+ })();
25
+ closing.add(done);
26
+ done.finally(() => closing.delete(done));
27
+ };
28
+ const stopTimer = () => {
29
+ clearInterval(timer);
30
+ timer = void 0;
31
+ };
32
+ const dispose = (entry) => {
33
+ entry.retired = true;
34
+ if (entries.get(entry.doc.id) === entry) entries.delete(entry.doc.id);
35
+ if (entry.inFlight === 0) closeBuilt(entry);
36
+ options.onDispose?.(entry.doc);
37
+ if (entries.size === 0) stopTimer();
38
+ };
39
+ const tracked = (entry, adapter) => {
40
+ const counted = async (call) => {
41
+ entry.inFlight++;
42
+ try {
43
+ return await call();
44
+ } finally {
45
+ entry.inFlight--;
46
+ if (entry.retired && entry.inFlight === 0) closeBuilt(entry);
47
+ }
48
+ };
49
+ const realtime = adapter.realtime?.bind(adapter);
50
+ return {
51
+ ...adapter,
52
+ query: (q, ctx) => counted(() => adapter.query(q, ctx)),
53
+ ...realtime ? { realtime: (q, ctx) => counted(() => realtime(q, ctx)) } : {}
54
+ };
55
+ };
56
+ const sweep = () => {
57
+ const at = now();
58
+ const idle = [...entries.values()].filter((entry) => entry.inFlight === 0 && at - entry.usedAt >= idleMs);
59
+ for (const entry of idle) dispose(entry);
60
+ return idle.map((entry) => entry.doc.id);
61
+ };
62
+ const startTimer = () => {
63
+ if (timer === void 0) {
64
+ timer = setInterval(sweep, SWEEP_EVERY_MS);
65
+ timer.unref?.();
66
+ }
67
+ };
68
+ return {
69
+ get(doc) {
70
+ const entry = entries.get(doc.id);
71
+ if (!entry || entry.doc.version !== doc.version) return;
72
+ entry.usedAt = now();
73
+ return entry.adapter;
74
+ },
75
+ put(doc, built, owned) {
76
+ const pooled = entries.get(doc.id);
77
+ if (pooled && pooled.doc.version >= doc.version) {
78
+ pooled.usedAt = now();
79
+ return pooled.adapter;
80
+ }
81
+ if (pooled) dispose(pooled);
82
+ const entry = {
83
+ doc,
84
+ adapter: null,
85
+ built,
86
+ owned,
87
+ usedAt: now(),
88
+ inFlight: 0,
89
+ retired: false
90
+ };
91
+ entry.adapter = built && owned ? tracked(entry, built) : built;
92
+ entries.set(doc.id, entry);
93
+ startTimer();
94
+ return entry.adapter;
95
+ },
96
+ touch(ids) {
97
+ const at = now();
98
+ for (const id of ids) {
99
+ const entry = entries.get(id);
100
+ if (entry) entry.usedAt = at;
101
+ }
102
+ },
103
+ retain(scope, keep) {
104
+ for (const entry of [...entries.values()]) if (entry.doc.scope === scope && !keep.has(entry.doc.id)) dispose(entry);
105
+ },
106
+ sweep,
107
+ async close() {
108
+ stopTimer();
109
+ for (const entry of [...entries.values()]) {
110
+ entry.retired = true;
111
+ entries.delete(entry.doc.id);
112
+ closeBuilt(entry);
113
+ }
114
+ await Promise.all([...closing]);
115
+ }
116
+ };
117
+ };
118
+ //#endregion
119
+ export { createAdapterPool };
120
+
121
+ //# sourceMappingURL=adapterPool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adapterPool.js","names":[],"sources":["../../src/providers/adapterPool.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { currentTime } from '../core/clock'\nimport type { AnalyticsAdapter } from '../core/contract'\n\n/** How long a pooled adapter no registry asked for is kept before it is closed. */\nexport const POOL_IDLE_MS = 5 * 60_000\n\n/** How often idle adapters are looked for while anything is pooled. */\nconst SWEEP_EVERY_MS = 60_000\n\n/** One saved state of one provider document: its id, its `updatedAt`, and the scope it was in. */\nexport interface PooledDocument {\n\tid: string\n\tversion: string\n\tscope: string | null\n}\n\ninterface AdapterPool {\n\t/**\n\t * The adapter built for exactly this version of the document, marked as used; null when that\n\t * version builds none, undefined when it was never built.\n\t */\n\tget(doc: PooledDocument): AnalyticsAdapter | null | undefined\n\t/**\n\t * Pools one document version's adapter and answers the one to hand out: an older pooled version\n\t * is disposed, a newer one wins. Never closes an `owned: false` adapter (a lent native one).\n\t */\n\tput(\n\t\tdoc: PooledDocument,\n\t\tadapter: AnalyticsAdapter | null,\n\t\towned: boolean\n\t): AnalyticsAdapter | null\n\t/** Marks the documents as used, so the idle sweep keeps them. */\n\ttouch(ids: Iterable<string>): void\n\t/** Disposes every document pooled under `scope` that `keep` leaves out: removed, disabled or moved. */\n\tretain(scope: string | null, keep: ReadonlySet<string>): void\n\t/** Disposes what nothing used for the idle window, answering the ids it disposed. */\n\tsweep(): string[]\n\t/** Closes every pooled adapter: the runtime holding the pool is retired. */\n\tclose(): Promise<void>\n}\n\ninterface AdapterPoolOptions {\n\t/** The instance every pooled adapter serves, which is what `close(payload)` is told. */\n\tpayload: Payload\n\tidleMs?: number\n\tnow?: () => number\n\t/** Told each document version disposed, so whatever still hands its adapter out drops it. */\n\tonDispose?: (doc: PooledDocument) => void\n}\n\ninterface Entry {\n\tdoc: PooledDocument\n\t/** What the pool hands out: for an owned adapter, one that counts the calls in flight. */\n\tadapter: AnalyticsAdapter | null\n\t/** The adapter as built, whose `close` the pool calls. */\n\tbuilt: AnalyticsAdapter | null\n\towned: boolean\n\tusedAt: number\n\tinFlight: number\n\tretired: boolean\n}\n\n/**\n * Per-instance adapters keyed `id@updatedAt`, so an unchanged document is never decrypted again. A\n * disposed adapter closes once no call is in flight, and again after any late call.\n */\nexport const createAdapterPool = (options: AdapterPoolOptions): AdapterPool => {\n\tconst { payload } = options\n\tconst idleMs = options.idleMs ?? POOL_IDLE_MS\n\tconst now = options.now ?? currentTime\n\tconst entries = new Map<string, Entry>()\n\tconst closing = new Set<Promise<void>>()\n\tlet timer: ReturnType<typeof setInterval> | undefined\n\n\tconst closeBuilt = (entry: Entry): void => {\n\t\tconst { built } = entry\n\t\tif (!entry.owned || !built?.close) {\n\t\t\treturn\n\t\t}\n\t\tconst done = (async () => {\n\t\t\ttry {\n\t\t\t\tawait built.close?.(payload)\n\t\t\t} catch (err) {\n\t\t\t\tpayload.logger?.warn(\n\t\t\t\t\t`analytics: closing the adapter of provider document \"${entry.doc.id}\" failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t}\n\t\t})()\n\t\tclosing.add(done)\n\t\tvoid done.finally(() => closing.delete(done))\n\t}\n\n\tconst stopTimer = (): void => {\n\t\tclearInterval(timer)\n\t\ttimer = undefined\n\t}\n\n\tconst dispose = (entry: Entry): void => {\n\t\tentry.retired = true\n\t\tif (entries.get(entry.doc.id) === entry) {\n\t\t\tentries.delete(entry.doc.id)\n\t\t}\n\t\tif (entry.inFlight === 0) {\n\t\t\tcloseBuilt(entry)\n\t\t}\n\t\toptions.onDispose?.(entry.doc)\n\t\tif (entries.size === 0) {\n\t\t\tstopTimer()\n\t\t}\n\t}\n\n\tconst tracked = (entry: Entry, adapter: AnalyticsAdapter): AnalyticsAdapter => {\n\t\tconst counted = async <T>(call: () => Promise<T>): Promise<T> => {\n\t\t\tentry.inFlight++\n\t\t\ttry {\n\t\t\t\treturn await call()\n\t\t\t} finally {\n\t\t\t\tentry.inFlight--\n\t\t\t\tif (entry.retired && entry.inFlight === 0) {\n\t\t\t\t\tcloseBuilt(entry)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tconst realtime = adapter.realtime?.bind(adapter)\n\t\treturn {\n\t\t\t...adapter,\n\t\t\tquery: (q, ctx) => counted(() => adapter.query(q, ctx)),\n\t\t\t...(realtime ? { realtime: (q, ctx) => counted(() => realtime(q, ctx)) } : {}),\n\t\t}\n\t}\n\n\tconst sweep = (): string[] => {\n\t\tconst at = now()\n\t\tconst idle = [...entries.values()].filter(\n\t\t\t(entry) => entry.inFlight === 0 && at - entry.usedAt >= idleMs\n\t\t)\n\t\tfor (const entry of idle) {\n\t\t\tdispose(entry)\n\t\t}\n\t\treturn idle.map((entry) => entry.doc.id)\n\t}\n\n\tconst startTimer = (): void => {\n\t\tif (timer === undefined) {\n\t\t\ttimer = setInterval(sweep, SWEEP_EVERY_MS)\n\t\t\ttimer.unref?.()\n\t\t}\n\t}\n\n\treturn {\n\t\tget(doc) {\n\t\t\tconst entry = entries.get(doc.id)\n\t\t\tif (!entry || entry.doc.version !== doc.version) {\n\t\t\t\treturn undefined\n\t\t\t}\n\t\t\tentry.usedAt = now()\n\t\t\treturn entry.adapter\n\t\t},\n\t\tput(doc, built, owned) {\n\t\t\tconst pooled = entries.get(doc.id)\n\t\t\tif (pooled && pooled.doc.version >= doc.version) {\n\t\t\t\tpooled.usedAt = now()\n\t\t\t\treturn pooled.adapter\n\t\t\t}\n\t\t\tif (pooled) {\n\t\t\t\tdispose(pooled)\n\t\t\t}\n\t\t\tconst entry: Entry = {\n\t\t\t\tdoc,\n\t\t\t\tadapter: null,\n\t\t\t\tbuilt,\n\t\t\t\towned,\n\t\t\t\tusedAt: now(),\n\t\t\t\tinFlight: 0,\n\t\t\t\tretired: false,\n\t\t\t}\n\t\t\tentry.adapter = built && owned ? tracked(entry, built) : built\n\t\t\tentries.set(doc.id, entry)\n\t\t\tstartTimer()\n\t\t\treturn entry.adapter\n\t\t},\n\t\ttouch(ids) {\n\t\t\tconst at = now()\n\t\t\tfor (const id of ids) {\n\t\t\t\tconst entry = entries.get(id)\n\t\t\t\tif (entry) {\n\t\t\t\t\tentry.usedAt = at\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\tretain(scope, keep) {\n\t\t\tfor (const entry of [...entries.values()]) {\n\t\t\t\tif (entry.doc.scope === scope && !keep.has(entry.doc.id)) {\n\t\t\t\t\tdispose(entry)\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\tsweep,\n\t\tasync close() {\n\t\t\tstopTimer()\n\t\t\tfor (const entry of [...entries.values()]) {\n\t\t\t\tentry.retired = true\n\t\t\t\tentries.delete(entry.doc.id)\n\t\t\t\tcloseBuilt(entry)\n\t\t\t}\n\t\t\tawait Promise.all([...closing])\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { CollectionFieldOverride } from "../plugin/collectionFields.js";
2
+ import { ProviderId } from "./factory.js";
3
+ import { CollectionConfig, Field, FieldAccess, PayloadRequest, TextField, TextareaField } from "payload";
4
+
5
+ //#region src/providers/collection.d.ts
6
+ declare const PROVIDERS_SLUG = "analytics-providers";
7
+ /** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */
8
+ type BuildSecretField = (source: TextField | TextareaField) => Field[];
9
+ /**
10
+ * Replaces a default field; it receives the plugin's own field to spread and may return any field
11
+ * type (a `row`, a `collapsible`) that still holds a field of that name.
12
+ */
13
+ type ProviderFieldOverride = CollectionFieldOverride;
14
+ interface ProviderCollectionFieldOverrides {
15
+ name?: ProviderFieldOverride;
16
+ provider?: ProviderFieldOverride;
17
+ enabled?: ProviderFieldOverride;
18
+ /** The "Default for this site" checkbox, which only a scoped install's collection carries. */
19
+ isDefault?: ProviderFieldOverride;
20
+ /** What a vendor source does without consent; empty follows `capture.withoutConsent`. */
21
+ withoutConsent?: ProviderFieldOverride;
22
+ }
23
+ /** Field access on the fields that decide where a provider document connects (`CONNECTION_PATHS`). */
24
+ interface ConnectionFieldAccess {
25
+ create?: FieldAccess;
26
+ update?: FieldAccess;
27
+ }
28
+ /** One field access function for create and update alike, or `{ create, update }`. */
29
+ type ConnectionAccess = FieldAccess | ConnectionFieldAccess;
30
+ interface ProviderFieldsOptions {
31
+ /**
32
+ * Seals each credential field, normally `encryptedField` from `@10x-media/fields` in write-only
33
+ * mode. Left out, credentials are plain text and securing them is the host's job.
34
+ */
35
+ buildSecret?: BuildSecretField;
36
+ /** Replaces one of the default fields, applied per field. */
37
+ fields?: Omit<ProviderCollectionFieldOverrides, 'isDefault'>;
38
+ /** Adds the plugin's own hidden `scope` text field. Off by default. */
39
+ scopeField?: boolean;
40
+ /**
41
+ * Accepts `http://` in a `host` field, for a vendor on a private network. Set it together with
42
+ * `providers.hosts.allowPrivateNetwork`, which lets the plugin connect there. Off, https only.
43
+ */
44
+ allowPrivateNetwork?: boolean;
45
+ /**
46
+ * Field access on every `CONNECTION_PATHS` field except the scope field. One function for create
47
+ * and update alike, or `{ create, update }`.
48
+ */
49
+ connectionAccess?: ConnectionAccess;
50
+ /**
51
+ * The provider types the select offers, the first being its default; a document saved with any
52
+ * other type is refused. Default: every type, `native` first.
53
+ */
54
+ types?: ProviderId[];
55
+ }
56
+ /**
57
+ * Provider-settings fields alone, for a host that stores them elsewhere and feeds them back through
58
+ * `providers.resolve`; {@link adapterFromProviderDoc} reads the result as is.
59
+ */
60
+ declare const analyticsProviderFields: (options?: ProviderFieldsOptions) => Field[];
61
+ //#endregion
62
+ export { BuildSecretField, ConnectionAccess, ConnectionFieldAccess, PROVIDERS_SLUG, ProviderCollectionFieldOverrides, ProviderFieldOverride, ProviderFieldsOptions, analyticsProviderFields };
63
+ //# sourceMappingURL=collection.d.ts.map