@10x-media/analytics 0.1.0-beta.5 → 1.0.0-beta.10

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 (515) hide show
  1. package/CHANGELOG.md +270 -0
  2. package/LICENSE +21 -21
  3. package/README.md +15 -4
  4. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  5. package/dist/adapters/ga4/disableKey.js +21 -0
  6. package/dist/adapters/ga4/disableKey.js.map +1 -0
  7. package/dist/adapters/ga4/eventName.d.ts +15 -0
  8. package/dist/adapters/ga4/eventName.js +19 -0
  9. package/dist/adapters/ga4/eventName.js.map +1 -0
  10. package/dist/adapters/ga4/ga4.d.ts +5 -0
  11. package/dist/adapters/ga4/ga4.js +186 -58
  12. package/dist/adapters/ga4/ga4.js.map +1 -1
  13. package/dist/adapters/ga4/measurementId.js +15 -0
  14. package/dist/adapters/ga4/measurementId.js.map +1 -0
  15. package/dist/adapters/goalRead.js +126 -0
  16. package/dist/adapters/goalRead.js.map +1 -0
  17. package/dist/adapters/http/fetchJson.js +1 -1
  18. package/dist/adapters/plausible/plausible.d.ts +25 -0
  19. package/dist/adapters/plausible/plausible.js +159 -38
  20. package/dist/adapters/plausible/plausible.js.map +1 -1
  21. package/dist/adapters/posthog/posthog.d.ts +10 -1
  22. package/dist/adapters/posthog/posthog.js +130 -21
  23. package/dist/adapters/posthog/posthog.js.map +1 -1
  24. package/dist/adapters/series.js +11 -1
  25. package/dist/adapters/series.js.map +1 -1
  26. package/dist/adapters/umami/umami.d.ts +13 -1
  27. package/dist/adapters/umami/umami.js +278 -26
  28. package/dist/adapters/umami/umami.js.map +1 -1
  29. package/dist/binding/resolvePath.js +18 -2
  30. package/dist/binding/resolvePath.js.map +1 -1
  31. package/dist/capture/getTrackerConfig.d.ts +20 -0
  32. package/dist/capture/getTrackerConfig.js +31 -0
  33. package/dist/capture/getTrackerConfig.js.map +1 -0
  34. package/dist/capture/mountPath.js +14 -0
  35. package/dist/capture/mountPath.js.map +1 -0
  36. package/dist/capture/proxyEndpoint.js +127 -0
  37. package/dist/capture/proxyEndpoint.js.map +1 -0
  38. package/dist/capture/proxyRoutes.js +108 -0
  39. package/dist/capture/proxyRoutes.js.map +1 -0
  40. package/dist/capture/requestBody.js +68 -0
  41. package/dist/capture/requestBody.js.map +1 -0
  42. package/dist/capture/slots.d.ts +8 -0
  43. package/dist/capture/slots.js +54 -0
  44. package/dist/capture/slots.js.map +1 -0
  45. package/dist/capture/trackerConfig.d.ts +33 -0
  46. package/dist/capture/trackerConfig.js +95 -0
  47. package/dist/capture/trackerConfig.js.map +1 -0
  48. package/dist/capture/trackerEndpoint.js +35 -0
  49. package/dist/capture/trackerEndpoint.js.map +1 -0
  50. package/dist/charts/BarList.d.ts +16 -1
  51. package/dist/charts/BarList.js +41 -19
  52. package/dist/charts/BarList.js.map +1 -1
  53. package/dist/charts/TrendChart.d.ts +16 -3
  54. package/dist/charts/TrendChart.js +172 -106
  55. package/dist/charts/TrendChart.js.map +1 -1
  56. package/dist/charts/bars.d.ts +4 -0
  57. package/dist/charts/bars.js +3 -1
  58. package/dist/charts/bars.js.map +1 -1
  59. package/dist/charts/bucket.js +10 -1
  60. package/dist/charts/bucket.js.map +1 -1
  61. package/dist/charts/spline.js +2 -2
  62. package/dist/charts/spline.js.map +1 -1
  63. package/dist/charts/styles.js +18 -1
  64. package/dist/charts/styles.js.map +1 -1
  65. package/dist/core/cacheKey.js +26 -3
  66. package/dist/core/cacheKey.js.map +1 -1
  67. package/dist/core/capabilities.d.ts +5 -1
  68. package/dist/core/capabilities.js +11 -2
  69. package/dist/core/capabilities.js.map +1 -1
  70. package/dist/core/capture.d.ts +49 -0
  71. package/dist/core/contract.d.ts +74 -5
  72. package/dist/core/contract.js +30 -1
  73. package/dist/core/contract.js.map +1 -1
  74. package/dist/core/granularity.js +1 -1
  75. package/dist/core/options.d.ts +164 -6
  76. package/dist/core/options.js +126 -3
  77. package/dist/core/options.js.map +1 -1
  78. package/dist/core/registry.d.ts +1 -0
  79. package/dist/core/scopeList.js +32 -0
  80. package/dist/core/scopeList.js.map +1 -0
  81. package/dist/core/scopedRead.js +101 -30
  82. package/dist/core/scopedRead.js.map +1 -1
  83. package/dist/core/serverEvent.d.ts +60 -0
  84. package/dist/core/serverEvent.js +12 -0
  85. package/dist/core/serverEvent.js.map +1 -0
  86. package/dist/exports/adapters/ga4.d.ts +2 -1
  87. package/dist/exports/adapters/ga4.js +2 -1
  88. package/dist/exports/adapters/native.d.ts +3 -1
  89. package/dist/exports/adapters/native.js +2 -1
  90. package/dist/exports/client.d.ts +13 -3
  91. package/dist/exports/client.js +10 -1
  92. package/dist/exports/geo.d.ts +2 -2
  93. package/dist/exports/next.d.ts +2 -1
  94. package/dist/exports/next.js +2 -1
  95. package/dist/exports/react.d.ts +4 -0
  96. package/dist/exports/react.js +5 -0
  97. package/dist/exports/rsc.d.ts +11 -3
  98. package/dist/exports/rsc.js +7 -2
  99. package/dist/exports/tracker.d.ts +21 -0
  100. package/dist/exports/tracker.js +15 -0
  101. package/dist/exports/types.d.ts +16 -3
  102. package/dist/exports/types.js +4 -2
  103. package/dist/fields/AnalyticsPanelClient.js +2 -2
  104. package/dist/fields/AnalyticsPanelField.js +1 -1
  105. package/dist/fields/AnalyticsStatField.js +2 -2
  106. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  108. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  109. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  111. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  112. package/dist/fields/config/MetricSelectField.js +3 -3
  113. package/dist/fields/config/MetricSelectField.js.map +1 -1
  114. package/dist/fields/config/SourceSelectField.js +3 -3
  115. package/dist/fields/config/SourceSelectField.js.map +1 -1
  116. package/dist/fields/config/fetchSources.d.ts +5 -1
  117. package/dist/fields/config/fetchSources.js +7 -3
  118. package/dist/fields/config/fetchSources.js.map +1 -1
  119. package/dist/fields/config/narrow.js +2 -0
  120. package/dist/fields/config/narrow.js.map +1 -1
  121. package/dist/fields/config/sourcesState.js +19 -3
  122. package/dist/fields/config/sourcesState.js.map +1 -1
  123. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  124. package/dist/fields/config/useAnalyticsSources.js +9 -6
  125. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  126. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  127. package/dist/fields/config/useFilterCapabilities.js +52 -0
  128. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  129. package/dist/fields/readForDocument.d.ts +5 -0
  130. package/dist/fields/readForDocument.js +22 -10
  131. package/dist/fields/readForDocument.js.map +1 -1
  132. package/dist/goals/GoalSelectField.d.ts +7 -0
  133. package/dist/goals/GoalSelectField.js +77 -0
  134. package/dist/goals/GoalSelectField.js.map +1 -0
  135. package/dist/goals/collection.js +254 -0
  136. package/dist/goals/collection.js.map +1 -0
  137. package/dist/goals/currency.js +14 -0
  138. package/dist/goals/currency.js.map +1 -0
  139. package/dist/goals/fetchGoals.d.ts +18 -0
  140. package/dist/goals/fetchGoals.js +33 -0
  141. package/dist/goals/fetchGoals.js.map +1 -0
  142. package/dist/goals/goalField.d.ts +31 -0
  143. package/dist/goals/goalField.js +56 -0
  144. package/dist/goals/goalField.js.map +1 -0
  145. package/dist/goals/goalsEndpoint.d.ts +1 -0
  146. package/dist/goals/goalsEndpoint.js +58 -0
  147. package/dist/goals/goalsEndpoint.js.map +1 -0
  148. package/dist/goals/match.js +64 -0
  149. package/dist/goals/match.js.map +1 -0
  150. package/dist/goals/resolver.d.ts +8 -0
  151. package/dist/goals/resolver.js +147 -0
  152. package/dist/goals/resolver.js.map +1 -0
  153. package/dist/goals/trackGoalAction.d.ts +76 -0
  154. package/dist/goals/trackGoalAction.js +158 -0
  155. package/dist/goals/trackGoalAction.js.map +1 -0
  156. package/dist/goals/types.d.ts +33 -0
  157. package/dist/goals/types.js +7 -0
  158. package/dist/goals/types.js.map +1 -0
  159. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  160. package/dist/goals/useAnalyticsGoals.js +67 -0
  161. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  162. package/dist/index.d.ts +14 -3
  163. package/dist/index.js +174 -19
  164. package/dist/index.js.map +1 -1
  165. package/dist/native/collections/events.js +65 -1
  166. package/dist/native/collections/events.js.map +1 -1
  167. package/dist/native/collections/rollups.js +39 -3
  168. package/dist/native/collections/rollups.js.map +1 -1
  169. package/dist/native/eventScan.js +25 -0
  170. package/dist/native/eventScan.js.map +1 -0
  171. package/dist/native/geo/composeGeoResolvers.js +2 -2
  172. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  173. package/dist/native/geo/geoResolver.d.ts +9 -2
  174. package/dist/native/geo/geoResolver.js.map +1 -1
  175. package/dist/native/geo/maxmindResolver.js +3 -5
  176. package/dist/native/geo/maxmindResolver.js.map +1 -1
  177. package/dist/native/ingest/bots.d.ts +11 -0
  178. package/dist/native/ingest/bots.js +71 -0
  179. package/dist/native/ingest/bots.js.map +1 -0
  180. package/dist/native/ingest/browser.js +47 -0
  181. package/dist/native/ingest/browser.js.map +1 -0
  182. package/dist/native/ingest/clientIp.js +20 -0
  183. package/dist/native/ingest/clientIp.js.map +1 -0
  184. package/dist/native/ingest/device.js +11 -3
  185. package/dist/native/ingest/device.js.map +1 -1
  186. package/dist/native/ingest/endpoint.d.ts +1 -0
  187. package/dist/native/ingest/endpoint.js +107 -21
  188. package/dist/native/ingest/endpoint.js.map +1 -1
  189. package/dist/native/ingest/flushBatch.js +29 -38
  190. package/dist/native/ingest/flushBatch.js.map +1 -1
  191. package/dist/native/ingest/language.js +14 -0
  192. package/dist/native/ingest/language.js.map +1 -0
  193. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  194. package/dist/native/ingest/normalizeEvent.js +115 -16
  195. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  196. package/dist/native/ingest/referrer.js +48 -0
  197. package/dist/native/ingest/referrer.js.map +1 -0
  198. package/dist/native/ingest/requestHost.js +57 -0
  199. package/dist/native/ingest/requestHost.js.map +1 -0
  200. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  201. package/dist/native/ingest/resolveHostname.js +52 -0
  202. package/dist/native/ingest/resolveHostname.js.map +1 -0
  203. package/dist/native/ingest/salt.js +27 -2
  204. package/dist/native/ingest/salt.js.map +1 -1
  205. package/dist/native/ingest/serverTrack.d.ts +20 -0
  206. package/dist/native/ingest/serverTrack.js +109 -0
  207. package/dist/native/ingest/serverTrack.js.map +1 -0
  208. package/dist/native/ingest/source.d.ts +11 -0
  209. package/dist/native/ingest/source.js +264 -16
  210. package/dist/native/ingest/source.js.map +1 -1
  211. package/dist/native/ingest/utm.js +33 -0
  212. package/dist/native/ingest/utm.js.map +1 -0
  213. package/dist/native/ingest/validate.js +26 -0
  214. package/dist/native/ingest/validate.js.map +1 -0
  215. package/dist/native/nativeAdapter.d.ts +37 -1
  216. package/dist/native/nativeAdapter.js +175 -22
  217. package/dist/native/nativeAdapter.js.map +1 -1
  218. package/dist/native/query/eventAgg.js +175 -0
  219. package/dist/native/query/eventAgg.js.map +1 -0
  220. package/dist/native/retention/pruneTask.js +53 -13
  221. package/dist/native/retention/pruneTask.js.map +1 -1
  222. package/dist/native/rollupAcc.js +12 -1
  223. package/dist/native/rollupAcc.js.map +1 -1
  224. package/dist/native/rollups/bucketKey.js +15 -0
  225. package/dist/native/rollups/bucketKey.js.map +1 -0
  226. package/dist/native/rollups/bumpRollups.js +116 -0
  227. package/dist/native/rollups/bumpRollups.js.map +1 -0
  228. package/dist/native/rollups/deltas.js +86 -11
  229. package/dist/native/rollups/deltas.js.map +1 -1
  230. package/dist/native/rollups/insertManyIfNew.js +93 -0
  231. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  232. package/dist/next/captureRewrites.d.ts +42 -0
  233. package/dist/next/captureRewrites.js +57 -0
  234. package/dist/next/captureRewrites.js.map +1 -0
  235. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  236. package/dist/next/posthogProxyRewrites.js +16 -21
  237. package/dist/next/posthogProxyRewrites.js.map +1 -1
  238. package/dist/plugin/documentEndpoint.js +71 -24
  239. package/dist/plugin/documentEndpoint.js.map +1 -1
  240. package/dist/plugin/errors.d.ts +31 -0
  241. package/dist/plugin/errors.js +79 -0
  242. package/dist/plugin/errors.js.map +1 -0
  243. package/dist/plugin/goalHint.d.ts +1 -0
  244. package/dist/plugin/goalHint.js +24 -0
  245. package/dist/plugin/goalHint.js.map +1 -0
  246. package/dist/plugin/paths.js +17 -1
  247. package/dist/plugin/paths.js.map +1 -1
  248. package/dist/plugin/queryEndpoint.js +124 -0
  249. package/dist/plugin/queryEndpoint.js.map +1 -0
  250. package/dist/plugin/readContextForRequest.js +73 -0
  251. package/dist/plugin/readContextForRequest.js.map +1 -0
  252. package/dist/plugin/realtimeEndpoint.js +37 -16
  253. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  254. package/dist/plugin/refreshEndpoint.js +113 -0
  255. package/dist/plugin/refreshEndpoint.js.map +1 -0
  256. package/dist/plugin/runtime.d.ts +1 -0
  257. package/dist/plugin/runtime.js +33 -1
  258. package/dist/plugin/runtime.js.map +1 -1
  259. package/dist/plugin/scopeChange.js +22 -0
  260. package/dist/plugin/scopeChange.js.map +1 -0
  261. package/dist/plugin/scopeFieldBoot.js +22 -0
  262. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  263. package/dist/plugin/sourcesEndpoint.js +16 -41
  264. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  265. package/dist/plugin/warmTask.js +0 -0
  266. package/dist/plugin/warmTask.js.map +1 -1
  267. package/dist/providers/collection.js +89 -29
  268. package/dist/providers/collection.js.map +1 -1
  269. package/dist/providers/factory.js +11 -3
  270. package/dist/providers/factory.js.map +1 -1
  271. package/dist/providers/resolver.js.map +1 -1
  272. package/dist/query/dates.js +64 -0
  273. package/dist/query/dates.js.map +1 -0
  274. package/dist/query/errors.d.ts +14 -0
  275. package/dist/query/fetchQuery.d.ts +79 -0
  276. package/dist/query/fetchQuery.js +117 -0
  277. package/dist/query/fetchQuery.js.map +1 -0
  278. package/dist/query/parse.d.ts +22 -0
  279. package/dist/query/parse.js +168 -0
  280. package/dist/query/parse.js.map +1 -0
  281. package/dist/query/response.d.ts +39 -0
  282. package/dist/query/response.js +11 -0
  283. package/dist/query/response.js.map +1 -0
  284. package/dist/react/AnalyticsProvider.d.ts +50 -0
  285. package/dist/react/AnalyticsProvider.js +67 -0
  286. package/dist/react/AnalyticsProvider.js.map +1 -0
  287. package/dist/react/TrackerBoot.d.ts +22 -0
  288. package/dist/react/TrackerBoot.js +30 -0
  289. package/dist/react/TrackerBoot.js.map +1 -0
  290. package/dist/react/useAnalytics.d.ts +20 -0
  291. package/dist/react/useAnalytics.js +52 -0
  292. package/dist/react/useAnalytics.js.map +1 -0
  293. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  294. package/dist/rsc/AnalyticsScripts.js +41 -0
  295. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  296. package/dist/surfacing/cacheStore.d.ts +1 -0
  297. package/dist/surfacing/cacheStore.js +18 -2
  298. package/dist/surfacing/cacheStore.js.map +1 -1
  299. package/dist/surfacing/engine.d.ts +1 -0
  300. package/dist/surfacing/engine.js +47 -6
  301. package/dist/surfacing/engine.js.map +1 -1
  302. package/dist/surfacing/epoch.d.ts +1 -0
  303. package/dist/surfacing/epoch.js +72 -0
  304. package/dist/surfacing/epoch.js.map +1 -0
  305. package/dist/surfacing/queue.js +22 -6
  306. package/dist/surfacing/queue.js.map +1 -1
  307. package/dist/surfacing/rateLimiter.js +130 -0
  308. package/dist/surfacing/rateLimiter.js.map +1 -0
  309. package/dist/surfacing/retryPolicy.js +15 -0
  310. package/dist/surfacing/retryPolicy.js.map +1 -0
  311. package/dist/sync/collection.js +23 -7
  312. package/dist/sync/collection.js.map +1 -1
  313. package/dist/sync/syncTask.js +68 -33
  314. package/dist/sync/syncTask.js.map +1 -1
  315. package/dist/testing/memoryAdapter.d.ts +2 -0
  316. package/dist/testing/memoryAdapter.js +17 -1
  317. package/dist/testing/memoryAdapter.js.map +1 -1
  318. package/dist/timeframe/tz.js +17 -6
  319. package/dist/timeframe/tz.js.map +1 -1
  320. package/dist/tracker/autoCapture.d.ts +48 -0
  321. package/dist/tracker/autoCapture.js +129 -0
  322. package/dist/tracker/autoCapture.js.map +1 -0
  323. package/dist/tracker/consent.d.ts +24 -0
  324. package/dist/tracker/consent.js +48 -0
  325. package/dist/tracker/consent.js.map +1 -0
  326. package/dist/tracker/createTracker.d.ts +18 -0
  327. package/dist/tracker/createTracker.js +215 -0
  328. package/dist/tracker/createTracker.js.map +1 -0
  329. package/dist/tracker/exclusion.d.ts +28 -0
  330. package/dist/tracker/exclusion.js +50 -0
  331. package/dist/tracker/exclusion.js.map +1 -0
  332. package/dist/tracker/initTracker.d.ts +22 -0
  333. package/dist/tracker/initTracker.js +33 -0
  334. package/dist/tracker/initTracker.js.map +1 -0
  335. package/dist/tracker/loadScript.d.ts +14 -0
  336. package/dist/tracker/loadScript.js +41 -0
  337. package/dist/tracker/loadScript.js.map +1 -0
  338. package/dist/tracker/pageTracking.d.ts +17 -0
  339. package/dist/tracker/pageTracking.js +38 -0
  340. package/dist/tracker/pageTracking.js.map +1 -0
  341. package/dist/tracker/registry.d.ts +27 -0
  342. package/dist/tracker/registry.js +73 -0
  343. package/dist/tracker/registry.js.map +1 -0
  344. package/dist/tracker/sinks/ga4.d.ts +29 -0
  345. package/dist/tracker/sinks/ga4.js +30 -0
  346. package/dist/tracker/sinks/ga4.js.map +1 -0
  347. package/dist/tracker/sinks/native.d.ts +22 -0
  348. package/dist/tracker/sinks/native.js +56 -0
  349. package/dist/tracker/sinks/native.js.map +1 -0
  350. package/dist/tracker/sinks/plausible.d.ts +20 -0
  351. package/dist/tracker/sinks/plausible.js +32 -0
  352. package/dist/tracker/sinks/plausible.js.map +1 -0
  353. package/dist/tracker/sinks/posthog.d.ts +18 -0
  354. package/dist/tracker/sinks/posthog.js +30 -0
  355. package/dist/tracker/sinks/posthog.js.map +1 -0
  356. package/dist/tracker/sinks/umami.d.ts +18 -0
  357. package/dist/tracker/sinks/umami.js +23 -0
  358. package/dist/tracker/sinks/umami.js.map +1 -0
  359. package/dist/tracker/sinks/vendor.d.ts +14 -0
  360. package/dist/tracker/sinks/vendor.js +81 -0
  361. package/dist/tracker/sinks/vendor.js.map +1 -0
  362. package/dist/tracker/transport.js +28 -0
  363. package/dist/tracker/transport.js.map +1 -0
  364. package/dist/tracker/types.d.ts +91 -0
  365. package/dist/translations/ar.js +221 -0
  366. package/dist/translations/ar.js.map +1 -0
  367. package/dist/translations/de.js +145 -1
  368. package/dist/translations/de.js.map +1 -1
  369. package/dist/translations/en.js +145 -1
  370. package/dist/translations/en.js.map +1 -1
  371. package/dist/translations/es.js +221 -0
  372. package/dist/translations/es.js.map +1 -0
  373. package/dist/translations/fr.js +221 -0
  374. package/dist/translations/fr.js.map +1 -0
  375. package/dist/translations/id.js +221 -0
  376. package/dist/translations/id.js.map +1 -0
  377. package/dist/translations/index.d.ts +10 -1
  378. package/dist/translations/index.js +19 -1
  379. package/dist/translations/index.js.map +1 -1
  380. package/dist/translations/keys.d.ts +144 -0
  381. package/dist/translations/keys.js +145 -1
  382. package/dist/translations/keys.js.map +1 -1
  383. package/dist/translations/ko.js +221 -0
  384. package/dist/translations/ko.js.map +1 -0
  385. package/dist/translations/metricKeys.js +8 -2
  386. package/dist/translations/metricKeys.js.map +1 -1
  387. package/dist/translations/pt.js +221 -0
  388. package/dist/translations/pt.js.map +1 -0
  389. package/dist/translations/ru.js +221 -0
  390. package/dist/translations/ru.js.map +1 -0
  391. package/dist/translations/server.js.map +1 -1
  392. package/dist/translations/uk.js +221 -0
  393. package/dist/translations/uk.js.map +1 -0
  394. package/dist/translations/zh.js +221 -0
  395. package/dist/translations/zh.js.map +1 -0
  396. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  397. package/dist/view/AnalyticsNavLink.js +40 -0
  398. package/dist/view/AnalyticsNavLink.js.map +1 -0
  399. package/dist/view/AnalyticsView.d.ts +23 -0
  400. package/dist/view/AnalyticsView.js +45 -0
  401. package/dist/view/AnalyticsView.js.map +1 -0
  402. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  403. package/dist/view/AnalyticsViewClient.js +244 -0
  404. package/dist/view/AnalyticsViewClient.js.map +1 -0
  405. package/dist/view/authRedirect.js +32 -0
  406. package/dist/view/authRedirect.js.map +1 -0
  407. package/dist/view/conversionRate.js +18 -0
  408. package/dist/view/conversionRate.js.map +1 -0
  409. package/dist/view/dayRange.js +68 -0
  410. package/dist/view/dayRange.js.map +1 -0
  411. package/dist/view/gating.d.ts +1 -0
  412. package/dist/view/gating.js +142 -0
  413. package/dist/view/gating.js.map +1 -0
  414. package/dist/view/labels.js +76 -0
  415. package/dist/view/labels.js.map +1 -0
  416. package/dist/view/registerView.js +48 -0
  417. package/dist/view/registerView.js.map +1 -0
  418. package/dist/view/sections/Breakdowns.js +198 -0
  419. package/dist/view/sections/Breakdowns.js.map +1 -0
  420. package/dist/view/sections/EmptyStates.js +92 -0
  421. package/dist/view/sections/EmptyStates.js.map +1 -0
  422. package/dist/view/sections/FilterChips.js +46 -0
  423. package/dist/view/sections/FilterChips.js.map +1 -0
  424. package/dist/view/sections/GoalsPanel.js +82 -0
  425. package/dist/view/sections/GoalsPanel.js.map +1 -0
  426. package/dist/view/sections/OverviewCards.js +65 -0
  427. package/dist/view/sections/OverviewCards.js.map +1 -0
  428. package/dist/view/sections/RealtimeStrip.js +80 -0
  429. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  430. package/dist/view/sections/Toolbar.js +207 -0
  431. package/dist/view/sections/Toolbar.js.map +1 -0
  432. package/dist/view/sections/Trend.js +125 -0
  433. package/dist/view/sections/Trend.js.map +1 -0
  434. package/dist/view/sections/styles.js +76 -0
  435. package/dist/view/sections/styles.js.map +1 -0
  436. package/dist/view/state.js +211 -0
  437. package/dist/view/state.js.map +1 -0
  438. package/dist/view/useViewQueries.js +153 -0
  439. package/dist/view/useViewQueries.js.map +1 -0
  440. package/dist/view/viewProps.d.ts +40 -0
  441. package/dist/view/viewProps.js +90 -0
  442. package/dist/view/viewProps.js.map +1 -0
  443. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  444. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  445. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  446. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  448. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  449. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  450. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  451. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  453. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  454. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  455. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  456. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  457. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  458. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  459. package/dist/widgets/RealtimeCounter.js +18 -4
  460. package/dist/widgets/RealtimeCounter.js.map +1 -1
  461. package/dist/widgets/WidgetViewLink.js +17 -0
  462. package/dist/widgets/WidgetViewLink.js.map +1 -0
  463. package/dist/widgets/breakdownTypes.js +38 -0
  464. package/dist/widgets/breakdownTypes.js.map +1 -1
  465. package/dist/widgets/cardChrome.js +31 -7
  466. package/dist/widgets/cardChrome.js.map +1 -1
  467. package/dist/widgets/comparison.js +15 -1
  468. package/dist/widgets/comparison.js.map +1 -1
  469. package/dist/widgets/defaults.d.ts +6 -2
  470. package/dist/widgets/defaults.js +78 -23
  471. package/dist/widgets/defaults.js.map +1 -1
  472. package/dist/widgets/filterCaption.js +27 -0
  473. package/dist/widgets/filterCaption.js.map +1 -0
  474. package/dist/widgets/filterField.d.ts +19 -0
  475. package/dist/widgets/filterField.js +75 -0
  476. package/dist/widgets/filterField.js.map +1 -0
  477. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  478. package/dist/widgets/prepareWidgetRead.js +74 -0
  479. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  480. package/dist/widgets/range.js +43 -12
  481. package/dist/widgets/range.js.map +1 -1
  482. package/dist/widgets/readForWidget.d.ts +26 -3
  483. package/dist/widgets/readForWidget.js +48 -44
  484. package/dist/widgets/readForWidget.js.map +1 -1
  485. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  486. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  487. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  488. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  489. package/dist/widgets/readForWidgetGoals.js +140 -0
  490. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  491. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  492. package/dist/widgets/readForWidgetRealtime.js +23 -21
  493. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  494. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  495. package/dist/widgets/readForWidgetSeries.js +78 -53
  496. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  497. package/dist/widgets/readMeta.js +18 -0
  498. package/dist/widgets/readMeta.js.map +1 -0
  499. package/dist/widgets/realtimePoll.js +13 -1
  500. package/dist/widgets/realtimePoll.js.map +1 -1
  501. package/dist/widgets/registerWidgets.js +62 -10
  502. package/dist/widgets/registerWidgets.js.map +1 -1
  503. package/dist/widgets/types.d.ts +15 -0
  504. package/dist/widgets/types.js +16 -2
  505. package/dist/widgets/types.js.map +1 -1
  506. package/dist/widgets/viewLink.d.ts +22 -0
  507. package/dist/widgets/viewLink.js +86 -0
  508. package/dist/widgets/viewLink.js.map +1 -0
  509. package/package.json +28 -8
  510. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  511. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  512. package/dist/native/rollups/bumpRollup.js +0 -68
  513. package/dist/native/rollups/bumpRollup.js.map +0 -1
  514. package/dist/native/rollups/insertIfNew.js +0 -19
  515. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -1,14 +1,15 @@
1
1
  import { keys } from "../translations/keys.js";
2
2
  import { labelForKey } from "../translations/server.js";
3
- import { satisfiesCapabilities } from "../core/capabilities.js";
4
3
  import { TIMEFRAME_PRESETS } from "../timeframe/presets.js";
5
4
  import { METRIC_KEYS, TIMEFRAME_KEYS } from "../translations/metricKeys.js";
5
+ import { satisfiesCapabilities } from "../core/capabilities.js";
6
6
  import { de } from "../translations/de.js";
7
7
  import { en } from "../translations/en.js";
8
8
  import { BREAKDOWN_SPECS } from "./breakdownTypes.js";
9
- import { WIDGET_METRICS } from "./types.js";
9
+ import { GOAL_ROW_LIMITS, WIDGET_METRICS } from "./types.js";
10
10
  import { dateRangeField } from "../fields/dateRange/field.js";
11
11
  import { buildCustomWidgets } from "./customWidget.js";
12
+ import { filterField } from "./filterField.js";
12
13
  //#region src/widgets/registerWidgets.ts
13
14
  /**
14
15
  * Select options must carry static labels: `filterOptions` results are serialized
@@ -29,7 +30,10 @@ const widgetIsSupported = (requires, adapters) => !requires || adapters.some((a)
29
30
  * `dataSource`'s capabilities; an id not known at config time (a runtime/DB provider)
30
31
  * keeps the union. The default clamps to the first option when the preferred metric is
31
32
  * not servable, and options can come out empty for exotic adapter sets, which
32
- * {@link registerWidgets} treats as "skip this widget".
33
+ * {@link registerWidgets} treats as "skip this widget". When `providersEnabled`, the
34
+ * config-adapter filter is skipped entirely: a tenant's own runtime adapter may serve
35
+ * metrics no config adapter does, so every candidate is offered and `filterOptions` alone
36
+ * narrows once a `dataSource` is picked.
33
37
  */
34
38
  const metricSelectField = (candidates, args, opts = {}) => {
35
39
  const { extra, preferredDefault = "pageviews" } = opts;
@@ -37,7 +41,7 @@ const metricSelectField = (candidates, args, opts = {}) => {
37
41
  ...extra,
38
42
  metrics: [metric]
39
43
  });
40
- const options = candidates.filter((m) => args.adapters.some((a) => supports(a, m))).map((m) => ({
44
+ const options = (args.providersEnabled ? candidates : candidates.filter((m) => args.adapters.some((a) => supports(a, m)))).map((m) => ({
41
45
  value: m,
42
46
  label: staticLabel(METRIC_KEYS[m])
43
47
  }));
@@ -87,6 +91,13 @@ const timeframeSelectField = () => ({
87
91
  label: labelForKey(keys.widgetTimeframeCustom)
88
92
  }]
89
93
  });
94
+ /** Reads the previous period too: the trend overlays it, the goals table deltas against it. */
95
+ const compareField = () => ({
96
+ name: "compare",
97
+ type: "checkbox",
98
+ defaultValue: false,
99
+ label: labelForKey(keys.widgetFieldCompare)
100
+ });
90
101
  const dataSourceField = (args) => ({
91
102
  name: "dataSource",
92
103
  type: "select",
@@ -116,16 +127,21 @@ const customRangeField = () => dateRangeField({
116
127
  });
117
128
  /** The metric select in a widget's field list. */
118
129
  const findMetricField = (fields) => fields.find((field) => "name" in field && field.name === "metric");
119
- const metricWidgetFields = (args) => [
130
+ const metricWidgetFields = (args, extra = []) => [
120
131
  titleField(args, en[keys.widgetFieldTitlePlaceholder]),
121
132
  metricSelectField(WIDGET_METRICS, args),
122
133
  timeframeSelectField(),
123
134
  customRangeField(),
124
- ...args.multiProvider ? [dataSourceField(args)] : []
135
+ ...extra,
136
+ ...args.multiProvider ? [dataSourceField(args)] : [],
137
+ filterField()
125
138
  ];
126
139
  const breakdownWidgetFields = (args, spec) => [
127
140
  titleField(args, en[spec.label]),
128
- metricSelectField(WIDGET_METRICS, args, { extra: { dimensions: [spec.dimension] } }),
141
+ metricSelectField(WIDGET_METRICS, args, {
142
+ extra: { dimensions: [spec.dimension] },
143
+ ...spec.preferredDefault ? { preferredDefault: spec.preferredDefault } : {}
144
+ }),
129
145
  timeframeSelectField(),
130
146
  customRangeField(),
131
147
  {
@@ -136,6 +152,27 @@ const breakdownWidgetFields = (args, spec) => [
136
152
  max: 20,
137
153
  label: labelForKey(keys.widgetFieldLimit)
138
154
  },
155
+ ...args.multiProvider ? [dataSourceField(args)] : [],
156
+ filterField()
157
+ ];
158
+ /** A select, not the breakdown's free number: the goals table is a summary, not a report. */
159
+ const goalLimitField = () => ({
160
+ name: "limit",
161
+ type: "select",
162
+ defaultValue: String(GOAL_ROW_LIMITS[0]),
163
+ label: labelForKey(keys.widgetFieldLimit),
164
+ admin: { isClearable: false },
165
+ options: GOAL_ROW_LIMITS.map((limit) => ({
166
+ value: String(limit),
167
+ label: String(limit)
168
+ }))
169
+ });
170
+ const goalsWidgetFields = (args) => [
171
+ titleField(args, en[keys.widgetGoals]),
172
+ timeframeSelectField(),
173
+ customRangeField(),
174
+ goalLimitField(),
175
+ ...args.comparison === false ? [] : [compareField()],
139
176
  ...args.multiProvider ? [dataSourceField(args)] : []
140
177
  ];
141
178
  const realtimeWidgetFields = (args) => [
@@ -187,7 +224,7 @@ const WIDGET_DEFS = [
187
224
  requires: { metrics: ["pageviews"] },
188
225
  minWidth: "small",
189
226
  maxWidth: "full",
190
- fields: metricWidgetFields
227
+ fields: (args) => metricWidgetFields(args, args.comparison === false ? [] : [compareField()])
191
228
  },
192
229
  {
193
230
  slug: "analytics-realtime",
@@ -198,6 +235,18 @@ const WIDGET_DEFS = [
198
235
  maxWidth: "medium",
199
236
  fields: realtimeWidgetFields
200
237
  },
238
+ {
239
+ slug: "analytics-goals",
240
+ component: "@10x-media/analytics/rsc#AnalyticsGoalsWidget",
241
+ label: keys.widgetGoals,
242
+ requires: {
243
+ metrics: ["conversions"],
244
+ dimensions: ["goal"]
245
+ },
246
+ minWidth: "small",
247
+ maxWidth: "large",
248
+ fields: goalsWidgetFields
249
+ },
201
250
  ...BREAKDOWN_SPECS.map((spec) => ({
202
251
  slug: spec.slug,
203
252
  component: "@10x-media/analytics/rsc#AnalyticsBreakdownWidget",
@@ -212,13 +261,16 @@ const registerWidgets = (config, args) => {
212
261
  const built = [];
213
262
  for (const def of WIDGET_DEFS) {
214
263
  if (args.disabled.includes(def.slug)) continue;
215
- if (!widgetIsSupported(def.requires, args.adapters)) continue;
264
+ if (!args.providersEnabled && !widgetIsSupported(def.requires, args.adapters)) continue;
216
265
  const fields = def.fields(args);
217
266
  const metricField = findMetricField(fields);
218
267
  if (metricField && "options" in metricField && metricField.options.length === 0) continue;
219
268
  built.push({
220
269
  slug: def.slug,
221
- Component: def.component,
270
+ Component: {
271
+ path: def.component,
272
+ serverProps: { view: args.view ?? false }
273
+ },
222
274
  label: labelForKey(def.label),
223
275
  fields,
224
276
  minWidth: def.minWidth,
@@ -1 +1 @@
1
- {"version":3,"file":"registerWidgets.js","names":[],"sources":["../../src/widgets/registerWidgets.ts"],"sourcesContent":["import type {\n\tConfig,\n\tField,\n\tSelectField,\n\tSelectFieldSingleValidation,\n\tWidget,\n\tWidgetWidth,\n} from 'payload'\nimport { type CapabilityRequirement, satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, MetricKey } from '../core/contract'\nimport { dateRangeField } from '../fields/dateRange/field'\nimport { TIMEFRAME_PRESETS } from '../timeframe/presets'\nimport { de } from '../translations/de'\nimport { en } from '../translations/en'\nimport type { TranslationKey } from '../translations/keys'\nimport { keys } from '../translations/keys'\nimport { METRIC_KEYS, TIMEFRAME_KEYS } from '../translations/metricKeys'\nimport { labelForKey } from '../translations/server'\nimport { BREAKDOWN_SPECS, type BreakdownSpec } from './breakdownTypes'\nimport { buildCustomWidgets, type CustomWidgetDef } from './customWidget'\nimport { WIDGET_METRICS } from './types'\n\n/**\n * Select options must carry static labels: `filterOptions` results are serialized\n * into client form state at request time, where a label function cannot cross the\n * server/client boundary.\n */\nconst staticLabel = (key: TranslationKey): Record<string, string> => ({\n\tde: de[key],\n\ten: en[key],\n})\n\nexport interface RegisterWidgetsArgs {\n\tadapters: AnalyticsAdapter[]\n\tmultiProvider: boolean\n\tdisabled: string[]\n\tregister: CustomWidgetDef[]\n\tlocalizeText?: boolean\n\t/** The plugin's configured defaultAdapter, when set; falls back to the first adapter. */\n\tdefaultId?: string\n}\n\ninterface WidgetDef {\n\tslug: string\n\tcomponent: string\n\tlabel: TranslationKey\n\trequires?: CapabilityRequirement\n\tminWidth?: WidgetWidth\n\tmaxWidth?: WidgetWidth\n\tfields: (args: RegisterWidgetsArgs) => Field[]\n}\n\nexport const widgetIsSupported = (\n\trequires: CapabilityRequirement | undefined,\n\tadapters: AnalyticsAdapter[]\n): boolean => !requires || adapters.some((a) => satisfiesCapabilities(a.capabilities, requires))\n\n/**\n * The widget metric select. Options are limited to metrics at least one configured\n * adapter can serve, mirroring the OR-across-adapters gating used to hide whole widgets;\n * `extra` layers on further requirements (a breakdown widget's dimension, realtime) so\n * the picker never offers a metric the read path would report as unavailable. In\n * multi-provider installs `filterOptions` additionally narrows the picker to the selected\n * `dataSource`'s capabilities; an id not known at config time (a runtime/DB provider)\n * keeps the union. The default clamps to the first option when the preferred metric is\n * not servable, and options can come out empty for exotic adapter sets, which\n * {@link registerWidgets} treats as \"skip this widget\".\n */\nconst metricSelectField = (\n\tcandidates: MetricKey[],\n\targs: RegisterWidgetsArgs,\n\topts: {\n\t\textra?: Omit<CapabilityRequirement, 'metrics'>\n\t\tpreferredDefault?: MetricKey\n\t} = {}\n): Field => {\n\tconst { extra, preferredDefault = 'pageviews' } = opts\n\tconst supports = (adapter: AnalyticsAdapter, metric: MetricKey): boolean =>\n\t\tsatisfiesCapabilities(adapter.capabilities, { ...extra, metrics: [metric] })\n\tconst options = candidates\n\t\t.filter((m) => args.adapters.some((a) => supports(a, m)))\n\t\t.map((m) => ({ value: m, label: staticLabel(METRIC_KEYS[m]) }))\n\tconst defaultValue = options.some((o) => o.value === preferredDefault)\n\t\t? preferredDefault\n\t\t: options[0]?.value\n\tconst filterOptions: SelectField['filterOptions'] = ({ options: opts, siblingData }) => {\n\t\tconst sourceId = (siblingData as { dataSource?: unknown } | undefined)?.dataSource\n\t\tconst adapter =\n\t\t\ttypeof sourceId === 'string' ? args.adapters.find((a) => a.id === sourceId) : undefined\n\t\tif (!adapter) {\n\t\t\treturn opts\n\t\t}\n\t\treturn opts.filter((o) => typeof o === 'object' && supports(adapter, o.value as MetricKey))\n\t}\n\treturn {\n\t\tname: 'metric',\n\t\ttype: 'select',\n\t\trequired: true,\n\t\t...(defaultValue !== undefined ? { defaultValue } : {}),\n\t\tlabel: labelForKey(keys.widgetFieldMetric),\n\t\toptions,\n\t\tadmin: {\n\t\t\t// A required metric has no meaningful cleared state.\n\t\t\tisClearable: false,\n\t\t\tcomponents: {\n\t\t\t\tField: {\n\t\t\t\t\tpath: '@10x-media/analytics/client#MetricSelectField',\n\t\t\t\t\t...(extra ? { clientProps: { requires: extra } } : {}),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t...(args.multiProvider ? { filterOptions } : {}),\n\t}\n}\n\nconst titleField = (args: RegisterWidgetsArgs, placeholder: string): Field => ({\n\tname: 'title',\n\ttype: 'text',\n\tlabel: labelForKey(keys.widgetFieldTitle),\n\t...(args.localizeText ? { localized: true } : {}),\n\tadmin: { placeholder },\n})\n\nconst timeframeSelectField = (): Field => ({\n\tname: 'timeframe',\n\ttype: 'select',\n\trequired: true,\n\tdefaultValue: 'last30days',\n\tlabel: labelForKey(keys.widgetFieldTimeframe),\n\tadmin: { isClearable: false },\n\toptions: [\n\t\t...TIMEFRAME_PRESETS.map((p) => ({ value: p, label: labelForKey(TIMEFRAME_KEYS[p]) })),\n\t\t{ value: 'custom', label: labelForKey(keys.widgetTimeframeCustom) },\n\t],\n})\n\nconst dataSourceField = (args: RegisterWidgetsArgs): Field => ({\n\tname: 'dataSource',\n\ttype: 'select',\n\tlabel: labelForKey(keys.widgetFieldDataSource),\n\tdefaultValue: args.defaultId ?? args.adapters[0]?.id,\n\tadmin: {\n\t\t// Clearing would leave no source; the widget always reads through one.\n\t\tisClearable: false,\n\t\tcomponents: { Field: { path: '@10x-media/analytics/client#SourceSelectField' } },\n\t},\n\toptions: args.adapters.map((a) => ({ value: a.id, label: a.label })),\n\t// Payload's select validator rejects any value absent from `options`, but runtime\n\t// (DB-registered) provider ids are only known per request, not at config time.\n\tvalidate: ((value) =>\n\t\tvalue === undefined || value === null || (typeof value === 'string' && value.length > 0)\n\t\t\t? true\n\t\t\t: 'invalid data source') as SelectFieldSingleValidation,\n})\n\nconst customRangeField = (): Field =>\n\tdateRangeField({\n\t\tname: 'range',\n\t\tlabel: labelForKey(keys.widgetFieldRange),\n\t\tpickerAppearance: 'dayOnly',\n\t\toverrides: (f) => ({\n\t\t\t...f,\n\t\t\tadmin: {\n\t\t\t\t...f.admin,\n\t\t\t\tcondition: (_data, siblingData) => siblingData?.timeframe === 'custom',\n\t\t\t},\n\t\t}),\n\t})\n\n/** The metric select in a widget's field list. */\nexport const findMetricField = (fields: Field[]): Field | undefined =>\n\tfields.find((field) => 'name' in field && field.name === 'metric')\n\nconst metricWidgetFields = (args: RegisterWidgetsArgs): Field[] => [\n\ttitleField(args, en[keys.widgetFieldTitlePlaceholder]),\n\tmetricSelectField(WIDGET_METRICS, args),\n\ttimeframeSelectField(),\n\tcustomRangeField(),\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n]\n\nconst breakdownWidgetFields = (args: RegisterWidgetsArgs, spec: BreakdownSpec): Field[] => [\n\ttitleField(args, en[spec.label]),\n\tmetricSelectField(WIDGET_METRICS, args, { extra: { dimensions: [spec.dimension] } }),\n\ttimeframeSelectField(),\n\tcustomRangeField(),\n\t{\n\t\tname: 'limit',\n\t\ttype: 'number',\n\t\tdefaultValue: 5,\n\t\tmin: 1,\n\t\tmax: 20,\n\t\tlabel: labelForKey(keys.widgetFieldLimit),\n\t},\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n]\n\nconst realtimeWidgetFields = (args: RegisterWidgetsArgs): Field[] => [\n\ttitleField(args, en[keys.widgetFieldTitlePlaceholder]),\n\tmetricSelectField(['visitors', 'pageviews'], args, {\n\t\textra: { realtime: true },\n\t\tpreferredDefault: 'visitors',\n\t}),\n\t{\n\t\tname: 'windowMinutes',\n\t\ttype: 'select',\n\t\tdefaultValue: '30',\n\t\tlabel: labelForKey(keys.widgetFieldWindow),\n\t\tadmin: { isClearable: false },\n\t\toptions: [\n\t\t\t{ value: '5', label: '5 min' },\n\t\t\t{ value: '15', label: '15 min' },\n\t\t\t{ value: '30', label: '30 min' },\n\t\t\t{ value: '60', label: '60 min' },\n\t\t],\n\t},\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n]\n\nconst WIDGET_DEFS: WidgetDef[] = [\n\t{\n\t\tslug: 'analytics-metric',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsMetricWidget',\n\t\tlabel: keys.widgetMetricLabel,\n\t\tminWidth: 'x-small',\n\t\tmaxWidth: 'medium',\n\t\tfields: metricWidgetFields,\n\t},\n\t{\n\t\tslug: 'analytics-trend',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsTrendWidget',\n\t\tlabel: keys.widgetTrendLabel,\n\t\trequires: { metrics: ['pageviews'] },\n\t\tminWidth: 'small',\n\t\tmaxWidth: 'full',\n\t\tfields: metricWidgetFields,\n\t},\n\t{\n\t\tslug: 'analytics-realtime',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsRealtimeWidget',\n\t\tlabel: keys.widgetRealtimeLabel,\n\t\trequires: { realtime: true },\n\t\tminWidth: 'small' as WidgetWidth,\n\t\tmaxWidth: 'medium' as WidgetWidth,\n\t\tfields: realtimeWidgetFields,\n\t},\n\t...BREAKDOWN_SPECS.map(\n\t\t(spec): WidgetDef => ({\n\t\t\tslug: spec.slug,\n\t\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsBreakdownWidget',\n\t\t\tlabel: spec.label,\n\t\t\trequires: { dimensions: [spec.dimension] },\n\t\t\tminWidth: 'small' as WidgetWidth,\n\t\t\tmaxWidth: 'large' as WidgetWidth,\n\t\t\tfields: (args) => breakdownWidgetFields(args, spec),\n\t\t})\n\t),\n]\n\nexport const registerWidgets = (config: Config, args: RegisterWidgetsArgs): void => {\n\tconst built: Widget[] = []\n\tfor (const def of WIDGET_DEFS) {\n\t\tif (args.disabled.includes(def.slug)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (!widgetIsSupported(def.requires, args.adapters)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst fields = def.fields(args)\n\t\t// A required metric select with no servable option would make the widget\n\t\t// impossible to configure; skip it like an unsupported widget.\n\t\tconst metricField = findMetricField(fields)\n\t\tif (metricField && 'options' in metricField && metricField.options.length === 0) {\n\t\t\tcontinue\n\t\t}\n\t\tbuilt.push({\n\t\t\tslug: def.slug,\n\t\t\tComponent: def.component,\n\t\t\tlabel: labelForKey(def.label),\n\t\t\tfields,\n\t\t\tminWidth: def.minWidth,\n\t\t\tmaxWidth: def.maxWidth,\n\t\t})\n\t}\n\tbuilt.push(...buildCustomWidgets(args.register, args.adapters, args.disabled))\n\tif (!built.length) {\n\t\treturn\n\t}\n\tconfig.admin ??= {}\n\tconfig.admin.dashboard ??= { widgets: [] }\n\tconfig.admin.dashboard.widgets ??= []\n\tconfig.admin.dashboard.widgets.push(...built)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA2BA,MAAM,eAAe,SAAiD;CACrE,IAAI,GAAG;CACP,IAAI,GAAG;AACR;AAsBA,MAAa,qBACZ,UACA,aACa,CAAC,YAAY,SAAS,MAAM,MAAM,sBAAsB,EAAE,cAAc,QAAQ,CAAC;;;;;;;;;;;;AAa/F,MAAM,qBACL,YACA,MACA,OAGI,CAAC,MACM;CACX,MAAM,EAAE,OAAO,mBAAmB,gBAAgB;CAClD,MAAM,YAAY,SAA2B,WAC5C,sBAAsB,QAAQ,cAAc;EAAE,GAAG;EAAO,SAAS,CAAC,MAAM;CAAE,CAAC;CAC5E,MAAM,UAAU,WACd,QAAQ,MAAM,KAAK,SAAS,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,EACvD,KAAK,OAAO;EAAE,OAAO;EAAG,OAAO,YAAY,YAAY,EAAE;CAAE,EAAE;CAC/D,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU,gBAAgB,IAClE,mBACA,QAAQ,IAAI;CACf,MAAM,iBAA+C,EAAE,SAAS,MAAM,kBAAkB;EACvF,MAAM,WAAY,aAAsD;EACxE,MAAM,UACL,OAAO,aAAa,WAAW,KAAK,SAAS,MAAM,MAAM,EAAE,OAAO,QAAQ,IAAI,KAAA;EAC/E,IAAI,CAAC,SACJ,OAAO;EAER,OAAO,KAAK,QAAQ,MAAM,OAAO,MAAM,YAAY,SAAS,SAAS,EAAE,KAAkB,CAAC;CAC3F;CACA,OAAO;EACN,MAAM;EACN,MAAM;EACN,UAAU;EACV,GAAI,iBAAiB,KAAA,IAAY,EAAE,aAAa,IAAI,CAAC;EACrD,OAAO,YAAY,KAAK,iBAAiB;EACzC;EACA,OAAO;GAEN,aAAa;GACb,YAAY,EACX,OAAO;IACN,MAAM;IACN,GAAI,QAAQ,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,IAAI,CAAC;GACrD,EACD;EACD;EACA,GAAI,KAAK,gBAAgB,EAAE,cAAc,IAAI,CAAC;CAC/C;AACD;AAEA,MAAM,cAAc,MAA2B,iBAAgC;CAC9E,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,gBAAgB;CACxC,GAAI,KAAK,eAAe,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C,OAAO,EAAE,YAAY;AACtB;AAEA,MAAM,8BAAqC;CAC1C,MAAM;CACN,MAAM;CACN,UAAU;CACV,cAAc;CACd,OAAO,YAAY,KAAK,oBAAoB;CAC5C,OAAO,EAAE,aAAa,MAAM;CAC5B,SAAS,CACR,GAAG,kBAAkB,KAAK,OAAO;EAAE,OAAO;EAAG,OAAO,YAAY,eAAe,EAAE;CAAE,EAAE,GACrF;EAAE,OAAO;EAAU,OAAO,YAAY,KAAK,qBAAqB;CAAE,CACnE;AACD;AAEA,MAAM,mBAAmB,UAAsC;CAC9D,MAAM;CACN,MAAM;CACN,OAAO,YAAY,KAAK,qBAAqB;CAC7C,cAAc,KAAK,aAAa,KAAK,SAAS,IAAI;CAClD,OAAO;EAEN,aAAa;EACb,YAAY,EAAE,OAAO,EAAE,MAAM,gDAAgD,EAAE;CAChF;CACA,SAAS,KAAK,SAAS,KAAK,OAAO;EAAE,OAAO,EAAE;EAAI,OAAO,EAAE;CAAM,EAAE;CAGnE,YAAY,UACX,UAAU,KAAA,KAAa,UAAU,QAAS,OAAO,UAAU,YAAY,MAAM,SAAS,IACnF,OACA;AACL;AAEA,MAAM,yBACL,eAAe;CACd,MAAM;CACN,OAAO,YAAY,KAAK,gBAAgB;CACxC,kBAAkB;CAClB,YAAY,OAAO;EAClB,GAAG;EACH,OAAO;GACN,GAAG,EAAE;GACL,YAAY,OAAO,gBAAgB,aAAa,cAAc;EAC/D;CACD;AACD,CAAC;;AAGF,MAAa,mBAAmB,WAC/B,OAAO,MAAM,UAAU,UAAU,SAAS,MAAM,SAAS,QAAQ;AAElE,MAAM,sBAAsB,SAAuC;CAClE,WAAW,MAAM,GAAG,KAAK,4BAA4B;CACrD,kBAAkB,gBAAgB,IAAI;CACtC,qBAAqB;CACrB,iBAAiB;CACjB,GAAI,KAAK,gBAAgB,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC;AACrD;AAEA,MAAM,yBAAyB,MAA2B,SAAiC;CAC1F,WAAW,MAAM,GAAG,KAAK,MAAM;CAC/B,kBAAkB,gBAAgB,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,SAAS,EAAE,EAAE,CAAC;CACnF,qBAAqB;CACrB,iBAAiB;CACjB;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,KAAK;EACL,KAAK;EACL,OAAO,YAAY,KAAK,gBAAgB;CACzC;CACA,GAAI,KAAK,gBAAgB,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC;AACrD;AAEA,MAAM,wBAAwB,SAAuC;CACpE,WAAW,MAAM,GAAG,KAAK,4BAA4B;CACrD,kBAAkB,CAAC,YAAY,WAAW,GAAG,MAAM;EAClD,OAAO,EAAE,UAAU,KAAK;EACxB,kBAAkB;CACnB,CAAC;CACD;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,YAAY,KAAK,iBAAiB;EACzC,OAAO,EAAE,aAAa,MAAM;EAC5B,SAAS;GACR;IAAE,OAAO;IAAK,OAAO;GAAQ;GAC7B;IAAE,OAAO;IAAM,OAAO;GAAS;GAC/B;IAAE,OAAO;IAAM,OAAO;GAAS;GAC/B;IAAE,OAAO;IAAM,OAAO;GAAS;EAChC;CACD;CACA,GAAI,KAAK,gBAAgB,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC;AACrD;AAEA,MAAM,cAA2B;CAChC;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EACZ,UAAU;EACV,UAAU;EACV,QAAQ;CACT;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EACZ,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;EACnC,UAAU;EACV,UAAU;EACV,QAAQ;CACT;CACA;EACC,MAAM;EACN,WAAW;EACX,OAAO,KAAK;EACZ,UAAU,EAAE,UAAU,KAAK;EAC3B,UAAU;EACV,UAAU;EACV,QAAQ;CACT;CACA,GAAG,gBAAgB,KACjB,UAAqB;EACrB,MAAM,KAAK;EACX,WAAW;EACX,OAAO,KAAK;EACZ,UAAU,EAAE,YAAY,CAAC,KAAK,SAAS,EAAE;EACzC,UAAU;EACV,UAAU;EACV,SAAS,SAAS,sBAAsB,MAAM,IAAI;CACnD,EACD;AACD;AAEA,MAAa,mBAAmB,QAAgB,SAAoC;CACnF,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,OAAO,aAAa;EAC9B,IAAI,KAAK,SAAS,SAAS,IAAI,IAAI,GAClC;EAED,IAAI,CAAC,kBAAkB,IAAI,UAAU,KAAK,QAAQ,GACjD;EAED,MAAM,SAAS,IAAI,OAAO,IAAI;EAG9B,MAAM,cAAc,gBAAgB,MAAM;EAC1C,IAAI,eAAe,aAAa,eAAe,YAAY,QAAQ,WAAW,GAC7E;EAED,MAAM,KAAK;GACV,MAAM,IAAI;GACV,WAAW,IAAI;GACf,OAAO,YAAY,IAAI,KAAK;GAC5B;GACA,UAAU,IAAI;GACd,UAAU,IAAI;EACf,CAAC;CACF;CACA,MAAM,KAAK,GAAG,mBAAmB,KAAK,UAAU,KAAK,UAAU,KAAK,QAAQ,CAAC;CAC7E,IAAI,CAAC,MAAM,QACV;CAED,OAAO,UAAU,CAAC;CAClB,OAAO,MAAM,cAAc,EAAE,SAAS,CAAC,EAAE;CACzC,OAAO,MAAM,UAAU,YAAY,CAAC;CACpC,OAAO,MAAM,UAAU,QAAQ,KAAK,GAAG,KAAK;AAC7C"}
1
+ {"version":3,"file":"registerWidgets.js","names":[],"sources":["../../src/widgets/registerWidgets.ts"],"sourcesContent":["import type {\n\tConfig,\n\tField,\n\tSelectField,\n\tSelectFieldSingleValidation,\n\tWidget,\n\tWidgetWidth,\n} from 'payload'\nimport { type CapabilityRequirement, satisfiesCapabilities } from '../core/capabilities'\nimport type { AnalyticsAdapter, MetricKey } from '../core/contract'\nimport { dateRangeField } from '../fields/dateRange/field'\nimport { TIMEFRAME_PRESETS } from '../timeframe/presets'\nimport { de } from '../translations/de'\nimport { en } from '../translations/en'\nimport type { TranslationKey } from '../translations/keys'\nimport { keys } from '../translations/keys'\nimport { METRIC_KEYS, TIMEFRAME_KEYS } from '../translations/metricKeys'\nimport { labelForKey } from '../translations/server'\nimport { BREAKDOWN_SPECS, type BreakdownSpec } from './breakdownTypes'\nimport { buildCustomWidgets, type CustomWidgetDef } from './customWidget'\nimport { filterField } from './filterField'\nimport { GOAL_ROW_LIMITS, WIDGET_METRICS } from './types'\nimport type { WidgetView } from './viewLink'\n\n/**\n * Select options must carry static labels: `filterOptions` results are serialized\n * into client form state at request time, where a label function cannot cross the\n * server/client boundary.\n */\nconst staticLabel = (key: TranslationKey): Record<string, string> => ({\n\tde: de[key],\n\ten: en[key],\n})\n\nexport interface RegisterWidgetsArgs {\n\tadapters: AnalyticsAdapter[]\n\tmultiProvider: boolean\n\t/**\n\t * True when a tenant's own runtime adapter can exist (`providers.collection` or\n\t * `providers.resolve`). Such an adapter's capabilities are unknown at config time, so\n\t * gating on the config-adapter union would impose a false ceiling: widgets and metric\n\t * options open up, and the per-request sources endpoint plus client pickers narrow per\n\t * request instead.\n\t */\n\tprovidersEnabled: boolean\n\tdisabled: string[]\n\tregister: CustomWidgetDef[]\n\tlocalizeText?: boolean\n\t/** The plugin's configured defaultAdapter, when set; falls back to the first adapter. */\n\tdefaultId?: string\n\t/** `widgets.comparison`; false hides every compare checkbox. Defaults to on. */\n\tcomparison?: boolean\n\t/**\n\t * Where the analytics view mounts, so every built-in widget can link into it. False or\n\t * absent means no view to link to, and the widgets render without the footer link.\n\t */\n\tview?: WidgetView\n}\n\ninterface WidgetDef {\n\tslug: string\n\tcomponent: string\n\tlabel: TranslationKey\n\trequires?: CapabilityRequirement\n\tminWidth?: WidgetWidth\n\tmaxWidth?: WidgetWidth\n\tfields: (args: RegisterWidgetsArgs) => Field[]\n}\n\nexport const widgetIsSupported = (\n\trequires: CapabilityRequirement | undefined,\n\tadapters: AnalyticsAdapter[]\n): boolean => !requires || adapters.some((a) => satisfiesCapabilities(a.capabilities, requires))\n\n/**\n * The widget metric select. Options are limited to metrics at least one configured\n * adapter can serve, mirroring the OR-across-adapters gating used to hide whole widgets;\n * `extra` layers on further requirements (a breakdown widget's dimension, realtime) so\n * the picker never offers a metric the read path would report as unavailable. In\n * multi-provider installs `filterOptions` additionally narrows the picker to the selected\n * `dataSource`'s capabilities; an id not known at config time (a runtime/DB provider)\n * keeps the union. The default clamps to the first option when the preferred metric is\n * not servable, and options can come out empty for exotic adapter sets, which\n * {@link registerWidgets} treats as \"skip this widget\". When `providersEnabled`, the\n * config-adapter filter is skipped entirely: a tenant's own runtime adapter may serve\n * metrics no config adapter does, so every candidate is offered and `filterOptions` alone\n * narrows once a `dataSource` is picked.\n */\nconst metricSelectField = (\n\tcandidates: MetricKey[],\n\targs: RegisterWidgetsArgs,\n\topts: {\n\t\textra?: Omit<CapabilityRequirement, 'metrics'>\n\t\tpreferredDefault?: MetricKey\n\t} = {}\n): Field => {\n\tconst { extra, preferredDefault = 'pageviews' } = opts\n\tconst supports = (adapter: AnalyticsAdapter, metric: MetricKey): boolean =>\n\t\tsatisfiesCapabilities(adapter.capabilities, { ...extra, metrics: [metric] })\n\tconst options = (\n\t\targs.providersEnabled\n\t\t\t? candidates\n\t\t\t: candidates.filter((m) => args.adapters.some((a) => supports(a, m)))\n\t).map((m) => ({ value: m, label: staticLabel(METRIC_KEYS[m]) }))\n\tconst defaultValue = options.some((o) => o.value === preferredDefault)\n\t\t? preferredDefault\n\t\t: options[0]?.value\n\tconst filterOptions: SelectField['filterOptions'] = ({ options: opts, siblingData }) => {\n\t\tconst sourceId = (siblingData as { dataSource?: unknown } | undefined)?.dataSource\n\t\tconst adapter =\n\t\t\ttypeof sourceId === 'string' ? args.adapters.find((a) => a.id === sourceId) : undefined\n\t\tif (!adapter) {\n\t\t\treturn opts\n\t\t}\n\t\treturn opts.filter((o) => typeof o === 'object' && supports(adapter, o.value as MetricKey))\n\t}\n\treturn {\n\t\tname: 'metric',\n\t\ttype: 'select',\n\t\trequired: true,\n\t\t...(defaultValue !== undefined ? { defaultValue } : {}),\n\t\tlabel: labelForKey(keys.widgetFieldMetric),\n\t\toptions,\n\t\tadmin: {\n\t\t\t// A required metric has no meaningful cleared state.\n\t\t\tisClearable: false,\n\t\t\tcomponents: {\n\t\t\t\tField: {\n\t\t\t\t\tpath: '@10x-media/analytics/client#MetricSelectField',\n\t\t\t\t\t...(extra ? { clientProps: { requires: extra } } : {}),\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t...(args.multiProvider ? { filterOptions } : {}),\n\t}\n}\n\nconst titleField = (args: RegisterWidgetsArgs, placeholder: string): Field => ({\n\tname: 'title',\n\ttype: 'text',\n\tlabel: labelForKey(keys.widgetFieldTitle),\n\t...(args.localizeText ? { localized: true } : {}),\n\tadmin: { placeholder },\n})\n\nconst timeframeSelectField = (): Field => ({\n\tname: 'timeframe',\n\ttype: 'select',\n\trequired: true,\n\tdefaultValue: 'last30days',\n\tlabel: labelForKey(keys.widgetFieldTimeframe),\n\tadmin: { isClearable: false },\n\toptions: [\n\t\t...TIMEFRAME_PRESETS.map((p) => ({ value: p, label: labelForKey(TIMEFRAME_KEYS[p]) })),\n\t\t{ value: 'custom', label: labelForKey(keys.widgetTimeframeCustom) },\n\t],\n})\n\n/** Reads the previous period too: the trend overlays it, the goals table deltas against it. */\nconst compareField = (): Field => ({\n\tname: 'compare',\n\ttype: 'checkbox',\n\tdefaultValue: false,\n\tlabel: labelForKey(keys.widgetFieldCompare),\n})\n\nconst dataSourceField = (args: RegisterWidgetsArgs): Field => ({\n\tname: 'dataSource',\n\ttype: 'select',\n\tlabel: labelForKey(keys.widgetFieldDataSource),\n\tdefaultValue: args.defaultId ?? args.adapters[0]?.id,\n\tadmin: {\n\t\t// Clearing would leave no source; the widget always reads through one.\n\t\tisClearable: false,\n\t\tcomponents: { Field: { path: '@10x-media/analytics/client#SourceSelectField' } },\n\t},\n\toptions: args.adapters.map((a) => ({ value: a.id, label: a.label })),\n\t// Payload's select validator rejects any value absent from `options`, but runtime\n\t// (DB-registered) provider ids are only known per request, not at config time.\n\tvalidate: ((value) =>\n\t\tvalue === undefined || value === null || (typeof value === 'string' && value.length > 0)\n\t\t\t? true\n\t\t\t: 'invalid data source') as SelectFieldSingleValidation,\n})\n\nconst customRangeField = (): Field =>\n\tdateRangeField({\n\t\tname: 'range',\n\t\tlabel: labelForKey(keys.widgetFieldRange),\n\t\tpickerAppearance: 'dayOnly',\n\t\toverrides: (f) => ({\n\t\t\t...f,\n\t\t\tadmin: {\n\t\t\t\t...f.admin,\n\t\t\t\tcondition: (_data, siblingData) => siblingData?.timeframe === 'custom',\n\t\t\t},\n\t\t}),\n\t})\n\n/** The metric select in a widget's field list. */\nexport const findMetricField = (fields: Field[]): Field | undefined =>\n\tfields.find((field) => 'name' in field && field.name === 'metric')\n\nconst metricWidgetFields = (args: RegisterWidgetsArgs, extra: Field[] = []): Field[] => [\n\ttitleField(args, en[keys.widgetFieldTitlePlaceholder]),\n\tmetricSelectField(WIDGET_METRICS, args),\n\ttimeframeSelectField(),\n\tcustomRangeField(),\n\t...extra,\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n\tfilterField(),\n]\n\nconst breakdownWidgetFields = (args: RegisterWidgetsArgs, spec: BreakdownSpec): Field[] => [\n\ttitleField(args, en[spec.label]),\n\tmetricSelectField(WIDGET_METRICS, args, {\n\t\textra: { dimensions: [spec.dimension] },\n\t\t...(spec.preferredDefault ? { preferredDefault: spec.preferredDefault } : {}),\n\t}),\n\ttimeframeSelectField(),\n\tcustomRangeField(),\n\t{\n\t\tname: 'limit',\n\t\ttype: 'number',\n\t\tdefaultValue: 5,\n\t\tmin: 1,\n\t\tmax: 20,\n\t\tlabel: labelForKey(keys.widgetFieldLimit),\n\t},\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n\tfilterField(),\n]\n\n/** A select, not the breakdown's free number: the goals table is a summary, not a report. */\nconst goalLimitField = (): Field => ({\n\tname: 'limit',\n\ttype: 'select',\n\tdefaultValue: String(GOAL_ROW_LIMITS[0]),\n\tlabel: labelForKey(keys.widgetFieldLimit),\n\tadmin: { isClearable: false },\n\toptions: GOAL_ROW_LIMITS.map((limit) => ({ value: String(limit), label: String(limit) })),\n})\n\nconst goalsWidgetFields = (args: RegisterWidgetsArgs): Field[] => [\n\ttitleField(args, en[keys.widgetGoals]),\n\ttimeframeSelectField(),\n\tcustomRangeField(),\n\tgoalLimitField(),\n\t...(args.comparison === false ? [] : [compareField()]),\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n]\n\nconst realtimeWidgetFields = (args: RegisterWidgetsArgs): Field[] => [\n\ttitleField(args, en[keys.widgetFieldTitlePlaceholder]),\n\tmetricSelectField(['visitors', 'pageviews'], args, {\n\t\textra: { realtime: true },\n\t\tpreferredDefault: 'visitors',\n\t}),\n\t{\n\t\tname: 'windowMinutes',\n\t\ttype: 'select',\n\t\tdefaultValue: '30',\n\t\tlabel: labelForKey(keys.widgetFieldWindow),\n\t\tadmin: { isClearable: false },\n\t\toptions: [\n\t\t\t{ value: '5', label: '5 min' },\n\t\t\t{ value: '15', label: '15 min' },\n\t\t\t{ value: '30', label: '30 min' },\n\t\t\t{ value: '60', label: '60 min' },\n\t\t],\n\t},\n\t...(args.multiProvider ? [dataSourceField(args)] : []),\n]\n\nconst WIDGET_DEFS: WidgetDef[] = [\n\t{\n\t\tslug: 'analytics-metric',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsMetricWidget',\n\t\tlabel: keys.widgetMetricLabel,\n\t\tminWidth: 'x-small',\n\t\tmaxWidth: 'medium',\n\t\tfields: metricWidgetFields,\n\t},\n\t{\n\t\tslug: 'analytics-trend',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsTrendWidget',\n\t\tlabel: keys.widgetTrendLabel,\n\t\trequires: { metrics: ['pageviews'] },\n\t\tminWidth: 'small',\n\t\tmaxWidth: 'full',\n\t\tfields: (args) => metricWidgetFields(args, args.comparison === false ? [] : [compareField()]),\n\t},\n\t{\n\t\tslug: 'analytics-realtime',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsRealtimeWidget',\n\t\tlabel: keys.widgetRealtimeLabel,\n\t\trequires: { realtime: true },\n\t\tminWidth: 'small' as WidgetWidth,\n\t\tmaxWidth: 'medium' as WidgetWidth,\n\t\tfields: realtimeWidgetFields,\n\t},\n\t{\n\t\tslug: 'analytics-goals',\n\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsGoalsWidget',\n\t\tlabel: keys.widgetGoals,\n\t\trequires: { metrics: ['conversions'], dimensions: ['goal'] },\n\t\tminWidth: 'small' as WidgetWidth,\n\t\tmaxWidth: 'large' as WidgetWidth,\n\t\tfields: goalsWidgetFields,\n\t},\n\t...BREAKDOWN_SPECS.map(\n\t\t(spec): WidgetDef => ({\n\t\t\tslug: spec.slug,\n\t\t\tcomponent: '@10x-media/analytics/rsc#AnalyticsBreakdownWidget',\n\t\t\tlabel: spec.label,\n\t\t\trequires: { dimensions: [spec.dimension] },\n\t\t\tminWidth: 'small' as WidgetWidth,\n\t\t\tmaxWidth: 'large' as WidgetWidth,\n\t\t\tfields: (args) => breakdownWidgetFields(args, spec),\n\t\t})\n\t),\n]\n\nexport const registerWidgets = (config: Config, args: RegisterWidgetsArgs): void => {\n\tconst built: Widget[] = []\n\tfor (const def of WIDGET_DEFS) {\n\t\tif (args.disabled.includes(def.slug)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (!args.providersEnabled && !widgetIsSupported(def.requires, args.adapters)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst fields = def.fields(args)\n\t\t// A required metric select with no servable option would make the widget\n\t\t// impossible to configure; skip it like an unsupported widget.\n\t\tconst metricField = findMetricField(fields)\n\t\tif (metricField && 'options' in metricField && metricField.options.length === 0) {\n\t\t\tcontinue\n\t\t}\n\t\tbuilt.push({\n\t\t\tslug: def.slug,\n\t\t\tComponent: { path: def.component, serverProps: { view: args.view ?? false } },\n\t\t\tlabel: labelForKey(def.label),\n\t\t\tfields,\n\t\t\tminWidth: def.minWidth,\n\t\t\tmaxWidth: def.maxWidth,\n\t\t})\n\t}\n\tbuilt.push(...buildCustomWidgets(args.register, args.adapters, args.disabled))\n\tif (!built.length) {\n\t\treturn\n\t}\n\tconfig.admin ??= {}\n\tconfig.admin.dashboard ??= { widgets: [] }\n\tconfig.admin.dashboard.widgets ??= []\n\tconfig.admin.dashboard.widgets.push(...built)\n}\n"],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { DimensionKey, FilterOperator } from "../core/contract.js";
2
+ //#region src/widgets/types.d.ts
3
+ /**
4
+ * The optional one-filter group a widget stores. Every part is optional because the group
5
+ * is only ever partly filled while it is being configured; a filter counts as set once it
6
+ * has a dimension and a value.
7
+ */
8
+ interface WidgetFilter {
9
+ dimension?: DimensionKey;
10
+ operator?: FilterOperator;
11
+ value?: string;
12
+ }
13
+ //#endregion
14
+ export { WidgetFilter };
15
+ //# sourceMappingURL=types.d.ts.map
@@ -1,13 +1,27 @@
1
1
  //#region src/widgets/types.ts
2
+ /** Row counts the goals widget offers; the first is its default. */
3
+ const GOAL_ROW_LIMITS = [
4
+ 10,
5
+ 25,
6
+ 50
7
+ ];
8
+ /** The stored select value as a row count, falling back to the default for anything else. */
9
+ const resolveGoalRowLimit = (value) => {
10
+ const parsed = typeof value === "string" || typeof value === "number" ? Number(value) : NaN;
11
+ return GOAL_ROW_LIMITS.find((limit) => limit === parsed) ?? GOAL_ROW_LIMITS[0];
12
+ };
2
13
  const WIDGET_METRICS = [
3
14
  "pageviews",
4
15
  "visitors",
5
16
  "sessions",
6
17
  "avgDuration",
7
18
  "bounceRate",
8
- "events"
19
+ "events",
20
+ "conversions",
21
+ "revenue",
22
+ "scrollDepth"
9
23
  ];
10
24
  //#endregion
11
- export { WIDGET_METRICS };
25
+ export { GOAL_ROW_LIMITS, WIDGET_METRICS, resolveGoalRowLimit };
12
26
 
13
27
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","names":[],"sources":["../../src/widgets/types.ts"],"sourcesContent":["import type { MetricKey } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\n\nexport interface WidgetRange {\n\tfrom?: string\n\tto?: string\n}\n\nexport interface MetricWidgetData {\n\ttitle?: string\n\tmetric?: MetricKey\n\ttimeframe?: TimeframePreset | 'custom'\n\trange?: WidgetRange\n\tdataSource?: string\n}\n\nexport const WIDGET_METRICS: MetricKey[] = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n]\n"],"mappings":";AAgBA,MAAa,iBAA8B;CAC1C;CACA;CACA;CACA;CACA;CACA;AACD"}
1
+ {"version":3,"file":"types.js","names":[],"sources":["../../src/widgets/types.ts"],"sourcesContent":["import type { DimensionKey, FilterOperator, MetricKey } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\n\nexport interface WidgetRange {\n\tfrom?: string\n\tto?: string\n}\n\n/**\n * The optional one-filter group a widget stores. Every part is optional because the group\n * is only ever partly filled while it is being configured; a filter counts as set once it\n * has a dimension and a value.\n */\nexport interface WidgetFilter {\n\tdimension?: DimensionKey\n\toperator?: FilterOperator\n\tvalue?: string\n}\n\nexport interface MetricWidgetData {\n\ttitle?: string\n\tmetric?: MetricKey\n\ttimeframe?: TimeframePreset | 'custom'\n\trange?: WidgetRange\n\tdataSource?: string\n\t/** Trend widget only: overlay the previous period on the chart. */\n\tcompare?: boolean\n\tfilter?: WidgetFilter\n}\n\nexport interface GoalsWidgetData {\n\ttitle?: string\n\ttimeframe?: TimeframePreset | 'custom'\n\trange?: WidgetRange\n\t/** One of {@link GOAL_ROW_LIMITS}, stored as the select's string value. */\n\tlimit?: string | number\n\tcompare?: boolean\n\tdataSource?: string\n}\n\n/** Row counts the goals widget offers; the first is its default. */\nexport const GOAL_ROW_LIMITS = [10, 25, 50] as const\n\nexport type GoalRowLimit = (typeof GOAL_ROW_LIMITS)[number]\n\n/** The stored select value as a row count, falling back to the default for anything else. */\nexport const resolveGoalRowLimit = (value: unknown): GoalRowLimit => {\n\tconst parsed = typeof value === 'string' || typeof value === 'number' ? Number(value) : Number.NaN\n\tconst match = GOAL_ROW_LIMITS.find((limit) => limit === parsed)\n\treturn match ?? GOAL_ROW_LIMITS[0]\n}\n\nexport const WIDGET_METRICS: MetricKey[] = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n\t'conversions',\n\t'revenue',\n\t'scrollDepth',\n]\n"],"mappings":";;AAyCA,MAAa,kBAAkB;CAAC;CAAI;CAAI;AAAE;;AAK1C,MAAa,uBAAuB,UAAiC;CACpE,MAAM,SAAS,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;CAExF,OADc,gBAAgB,MAAM,UAAU,UAAU,MAC7C,KAAK,gBAAgB;AACjC;AAEA,MAAa,iBAA8B;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD"}
@@ -0,0 +1,22 @@
1
+ import { MetricKey } from "../core/contract.js";
2
+ import { TimeframePreset } from "../timeframe/presets.js";
3
+ import { PayloadRequest } from "payload";
4
+
5
+ //#region src/widgets/viewLink.d.ts
6
+ /**
7
+ * The view as a widget sees it: where it mounts and what it opens on, or false when the
8
+ * app turned it off. The defaults travel with the path because a link must leave out
9
+ * exactly what the view would have defaulted to anyway.
10
+ */
11
+ type WidgetView = {
12
+ path: string;
13
+ defaultRange: TimeframePreset;
14
+ defaultMetric: MetricKey;
15
+ } | false;
16
+ /** What `registerWidgets` adds to every built-in widget's server props. */
17
+ interface WidgetViewProps {
18
+ view?: WidgetView;
19
+ }
20
+ //#endregion
21
+ export { WidgetViewProps };
22
+ //# sourceMappingURL=viewLink.d.ts.map
@@ -0,0 +1,86 @@
1
+ import { zonedCalendarDay } from "../timeframe/tz.js";
2
+ import { BREAKDOWN_TABS, TAB_DIMENSIONS } from "../view/gating.js";
3
+ import { DEFAULT_VIEW_RANGE, VIEW_RANGE_PRESETS, serializeViewState } from "../view/state.js";
4
+ import { formatAdminURL } from "payload/shared";
5
+ //#region src/widgets/viewLink.ts
6
+ /** `allTime` is no range the view can hold, so an install defaulting to it opens here. */
7
+ const fallbackRange = (defaults) => defaults.range === "allTime" ? DEFAULT_VIEW_RANGE : defaults.range;
8
+ const DAY_MS = 864e5;
9
+ /**
10
+ * The widest custom window the view will accept, as a start day. `parseViewState` drops a
11
+ * wider one and opens on the default range instead, silently, so a widget on a longer
12
+ * window links to the last `MAX_QUERY_RANGE_DAYS` days of it: the most of what the widget
13
+ * shows that the view can show back.
14
+ */
15
+ const clampStartDay = (from, to) => {
16
+ const start = Date.parse(`${from}T00:00:00.000Z`);
17
+ const end = Date.parse(`${to}T00:00:00.000Z`);
18
+ if (Number.isNaN(start) || Number.isNaN(end)) return from;
19
+ const earliest = end - 365 * DAY_MS;
20
+ return start < earliest ? new Date(earliest).toISOString().slice(0, 10) : from;
21
+ };
22
+ /**
23
+ * The widget's window as the view's toolbar can hold it. A preset the toolbar does not
24
+ * offer (`allTime`, `thisMonth`, `thisYear`) would select nothing there, so the link drops
25
+ * the range instead and the view opens on its own default.
26
+ */
27
+ const rangeOf = (args, defaults) => {
28
+ if (args.timeframe === "custom") {
29
+ if (!args.range) return { range: fallbackRange(defaults) };
30
+ const to = zonedCalendarDay(args.range.end, args.timezone);
31
+ return {
32
+ range: "custom",
33
+ from: clampStartDay(zonedCalendarDay(args.range.start, args.timezone), to),
34
+ to
35
+ };
36
+ }
37
+ return VIEW_RANGE_PRESETS.includes(args.timeframe) ? { range: args.timeframe } : { range: fallbackRange(defaults) };
38
+ };
39
+ /**
40
+ * A relative admin link opening the analytics view on what the widget shows. Nothing is
41
+ * coerced against the source's capabilities here: the view does that on open, so a link
42
+ * naming something the selected source cannot serve still lands on a working view.
43
+ */
44
+ const viewHref = (args) => {
45
+ const defaults = {
46
+ range: args.defaultRange,
47
+ metric: args.defaultMetric
48
+ };
49
+ const tab = args.tab ?? "pages";
50
+ const dim = args.dim === TAB_DIMENSIONS[tab][0] ? void 0 : args.dim;
51
+ const state = {
52
+ ...rangeOf(args, defaults),
53
+ compare: args.compare === true,
54
+ ...args.source === void 0 ? {} : { source: args.source },
55
+ metric: args.metric ?? defaults.metric,
56
+ tab,
57
+ ...dim === void 0 ? {} : { dim },
58
+ filters: args.filters ?? [],
59
+ limit: 10
60
+ };
61
+ const path = formatAdminURL({
62
+ adminRoute: args.adminRoute,
63
+ path: args.viewPath
64
+ });
65
+ const query = serializeViewState(state, defaults).toString();
66
+ return query ? `${path}?${query}` : path;
67
+ };
68
+ /**
69
+ * The same link for a built-in widget, or nothing at all when the view is off. Omitting
70
+ * `timeframe` opens the view on its configured range, for a widget (realtime) whose own
71
+ * rolling window is no range the view can hold.
72
+ */
73
+ const widgetViewHref = (view, req, args) => view ? viewHref({
74
+ ...args,
75
+ timeframe: args.timeframe ?? view.defaultRange,
76
+ adminRoute: req.payload.config.routes.admin,
77
+ viewPath: view.path,
78
+ defaultRange: view.defaultRange,
79
+ defaultMetric: view.defaultMetric
80
+ }) : void 0;
81
+ /** The breakdown tab that offers a dimension; every contract dimension belongs to one. */
82
+ const viewTabForDimension = (dimension) => BREAKDOWN_TABS.find((tab) => TAB_DIMENSIONS[tab].includes(dimension));
83
+ //#endregion
84
+ export { viewTabForDimension, widgetViewHref };
85
+
86
+ //# sourceMappingURL=viewLink.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"viewLink.js","names":[],"sources":["../../src/widgets/viewLink.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport { formatAdminURL } from 'payload/shared'\nimport type { AnalyticsFilter, DateRange, DimensionKey, MetricKey } from '../core/contract'\nimport { MAX_QUERY_RANGE_DAYS } from '../query/limits'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport { zonedCalendarDay } from '../timeframe/tz'\nimport { BREAKDOWN_TABS, type BreakdownTab, TAB_DIMENSIONS } from '../view/gating'\nimport {\n\tDEFAULT_VIEW_LIMIT,\n\tDEFAULT_VIEW_RANGE,\n\tDEFAULT_VIEW_TAB,\n\tserializeViewState,\n\tVIEW_RANGE_PRESETS,\n\ttype ViewDefaults,\n\ttype ViewState,\n} from '../view/state'\n\n/**\n * The view as a widget sees it: where it mounts and what it opens on, or false when the\n * app turned it off. The defaults travel with the path because a link must leave out\n * exactly what the view would have defaulted to anyway.\n */\nexport type WidgetView =\n\t| { path: string; defaultRange: TimeframePreset; defaultMetric: MetricKey }\n\t| false\n\n/** What `registerWidgets` adds to every built-in widget's server props. */\nexport interface WidgetViewProps {\n\tview?: WidgetView\n}\n\nexport interface ViewHrefArgs {\n\tadminRoute: string\n\tviewPath: string\n\t/** The install's own starting point, so the link omits what the view defaults to. */\n\tdefaultRange: TimeframePreset\n\tdefaultMetric: MetricKey\n\tsource?: string\n\ttimeframe: TimeframePreset | 'custom'\n\t/** The widget's own window, needed only for a custom timeframe. */\n\trange?: DateRange\n\ttimezone: string\n\tcompare?: boolean\n\tmetric?: MetricKey\n\ttab?: BreakdownTab\n\t/**\n\t * The dimension the widget ranks, so the view opens on the same grouping rather than on\n\t * whatever its tab defaults to. Dropped when it is that default, which keeps the link short\n\t * and unchanged for every widget whose dimension already leads its tab.\n\t */\n\tdim?: DimensionKey\n\t/** The widget's own filter, carried as the view's filter state. */\n\tfilters?: AnalyticsFilter[]\n}\n\n/** `allTime` is no range the view can hold, so an install defaulting to it opens here. */\nconst fallbackRange = (defaults: ViewDefaults): TimeframePreset =>\n\tdefaults.range === 'allTime' ? DEFAULT_VIEW_RANGE : defaults.range\n\nconst DAY_MS = 86_400_000\n\n/**\n * The widest custom window the view will accept, as a start day. `parseViewState` drops a\n * wider one and opens on the default range instead, silently, so a widget on a longer\n * window links to the last `MAX_QUERY_RANGE_DAYS` days of it: the most of what the widget\n * shows that the view can show back.\n */\nconst clampStartDay = (from: string, to: string): string => {\n\tconst start = Date.parse(`${from}T00:00:00.000Z`)\n\tconst end = Date.parse(`${to}T00:00:00.000Z`)\n\tif (Number.isNaN(start) || Number.isNaN(end)) {\n\t\treturn from\n\t}\n\t// Both days are read whole, so the cap counts them inclusively.\n\tconst earliest = end - (MAX_QUERY_RANGE_DAYS - 1) * DAY_MS\n\treturn start < earliest ? new Date(earliest).toISOString().slice(0, 10) : from\n}\n\n/**\n * The widget's window as the view's toolbar can hold it. A preset the toolbar does not\n * offer (`allTime`, `thisMonth`, `thisYear`) would select nothing there, so the link drops\n * the range instead and the view opens on its own default.\n */\nconst rangeOf = (\n\targs: ViewHrefArgs,\n\tdefaults: ViewDefaults\n): Pick<ViewState, 'range' | 'from' | 'to'> => {\n\tif (args.timeframe === 'custom') {\n\t\tif (!args.range) {\n\t\t\treturn { range: fallbackRange(defaults) }\n\t\t}\n\t\tconst to = zonedCalendarDay(args.range.end, args.timezone)\n\t\treturn {\n\t\t\trange: 'custom',\n\t\t\tfrom: clampStartDay(zonedCalendarDay(args.range.start, args.timezone), to),\n\t\t\tto,\n\t\t}\n\t}\n\treturn VIEW_RANGE_PRESETS.includes(args.timeframe)\n\t\t? { range: args.timeframe }\n\t\t: { range: fallbackRange(defaults) }\n}\n\n/**\n * A relative admin link opening the analytics view on what the widget shows. Nothing is\n * coerced against the source's capabilities here: the view does that on open, so a link\n * naming something the selected source cannot serve still lands on a working view.\n */\nexport const viewHref = (args: ViewHrefArgs): string => {\n\tconst defaults: ViewDefaults = { range: args.defaultRange, metric: args.defaultMetric }\n\tconst tab = args.tab ?? DEFAULT_VIEW_TAB\n\t// Against the declared order, not the source's: a link is built without capabilities, and a\n\t// `dim` naming what the selected source leads its tab with is dropped by the view anyway.\n\tconst dim = args.dim === TAB_DIMENSIONS[tab][0] ? undefined : args.dim\n\tconst state: ViewState = {\n\t\t...rangeOf(args, defaults),\n\t\tcompare: args.compare === true,\n\t\t...(args.source === undefined ? {} : { source: args.source }),\n\t\tmetric: args.metric ?? defaults.metric,\n\t\ttab,\n\t\t...(dim === undefined ? {} : { dim }),\n\t\tfilters: args.filters ?? [],\n\t\tlimit: DEFAULT_VIEW_LIMIT,\n\t}\n\t// `resolveView` refuses a path without a leading slash, so the option cannot be wider.\n\tconst path = formatAdminURL({\n\t\tadminRoute: args.adminRoute,\n\t\tpath: args.viewPath as `/${string}`,\n\t})\n\tconst query = serializeViewState(state, defaults).toString()\n\treturn query ? `${path}?${query}` : path\n}\n\n/**\n * The same link for a built-in widget, or nothing at all when the view is off. Omitting\n * `timeframe` opens the view on its configured range, for a widget (realtime) whose own\n * rolling window is no range the view can hold.\n */\nexport const widgetViewHref = (\n\tview: WidgetView | undefined,\n\treq: PayloadRequest,\n\targs: Omit<\n\t\tViewHrefArgs,\n\t\t'adminRoute' | 'viewPath' | 'defaultRange' | 'defaultMetric' | 'timeframe'\n\t> & { timeframe?: TimeframePreset | 'custom' }\n): string | undefined =>\n\tview\n\t\t? viewHref({\n\t\t\t\t...args,\n\t\t\t\ttimeframe: args.timeframe ?? view.defaultRange,\n\t\t\t\tadminRoute: req.payload.config.routes.admin,\n\t\t\t\tviewPath: view.path,\n\t\t\t\tdefaultRange: view.defaultRange,\n\t\t\t\tdefaultMetric: view.defaultMetric,\n\t\t\t})\n\t\t: undefined\n\n/** The breakdown tab that offers a dimension; every contract dimension belongs to one. */\nexport const viewTabForDimension = (dimension: DimensionKey): BreakdownTab | undefined =>\n\tBREAKDOWN_TABS.find((tab) => TAB_DIMENSIONS[tab].includes(dimension))\n"],"mappings":";;;;;;AAwDA,MAAM,iBAAiB,aACtB,SAAS,UAAU,YAAY,qBAAqB,SAAS;AAE9D,MAAM,SAAS;;;;;;;AAQf,MAAM,iBAAiB,MAAc,OAAuB;CAC3D,MAAM,QAAQ,KAAK,MAAM,GAAG,KAAK,eAAe;CAChD,MAAM,MAAM,KAAK,MAAM,GAAG,GAAG,eAAe;CAC5C,IAAI,OAAO,MAAM,KAAK,KAAK,OAAO,MAAM,GAAG,GAC1C,OAAO;CAGR,MAAM,WAAW,MAAA,MAAmC;CACpD,OAAO,QAAQ,WAAW,IAAI,KAAK,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,IAAI;AAC3E;;;;;;AAOA,MAAM,WACL,MACA,aAC8C;CAC9C,IAAI,KAAK,cAAc,UAAU;EAChC,IAAI,CAAC,KAAK,OACT,OAAO,EAAE,OAAO,cAAc,QAAQ,EAAE;EAEzC,MAAM,KAAK,iBAAiB,KAAK,MAAM,KAAK,KAAK,QAAQ;EACzD,OAAO;GACN,OAAO;GACP,MAAM,cAAc,iBAAiB,KAAK,MAAM,OAAO,KAAK,QAAQ,GAAG,EAAE;GACzE;EACD;CACD;CACA,OAAO,mBAAmB,SAAS,KAAK,SAAS,IAC9C,EAAE,OAAO,KAAK,UAAU,IACxB,EAAE,OAAO,cAAc,QAAQ,EAAE;AACrC;;;;;;AAOA,MAAa,YAAY,SAA+B;CACvD,MAAM,WAAyB;EAAE,OAAO,KAAK;EAAc,QAAQ,KAAK;CAAc;CACtF,MAAM,MAAM,KAAK,OAAA;CAGjB,MAAM,MAAM,KAAK,QAAQ,eAAe,KAAK,KAAK,KAAA,IAAY,KAAK;CACnE,MAAM,QAAmB;EACxB,GAAG,QAAQ,MAAM,QAAQ;EACzB,SAAS,KAAK,YAAY;EAC1B,GAAI,KAAK,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO;EAC3D,QAAQ,KAAK,UAAU,SAAS;EAChC;EACA,GAAI,QAAQ,KAAA,IAAY,CAAC,IAAI,EAAE,IAAI;EACnC,SAAS,KAAK,WAAW,CAAC;EAC1B,OAAA;CACD;CAEA,MAAM,OAAO,eAAe;EAC3B,YAAY,KAAK;EACjB,MAAM,KAAK;CACZ,CAAC;CACD,MAAM,QAAQ,mBAAmB,OAAO,QAAQ,EAAE,SAAS;CAC3D,OAAO,QAAQ,GAAG,KAAK,GAAG,UAAU;AACrC;;;;;;AAOA,MAAa,kBACZ,MACA,KACA,SAKA,OACG,SAAS;CACT,GAAG;CACH,WAAW,KAAK,aAAa,KAAK;CAClC,YAAY,IAAI,QAAQ,OAAO,OAAO;CACtC,UAAU,KAAK;CACf,cAAc,KAAK;CACnB,eAAe,KAAK;AACrB,CAAC,IACA,KAAA;;AAGJ,MAAa,uBAAuB,cACnC,eAAe,MAAM,QAAQ,eAAe,KAAK,SAAS,SAAS,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@10x-media/analytics",
3
- "version": "0.1.0-beta.5",
3
+ "version": "1.0.0-beta.10",
4
4
  "description": "Adapter-based analytics for Payload: providers, a native engine, dashboard widgets, and portable fields.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -37,6 +37,16 @@
37
37
  "import": "./dist/exports/client.js",
38
38
  "default": "./dist/exports/client.js"
39
39
  },
40
+ "./tracker": {
41
+ "types": "./dist/exports/tracker.d.ts",
42
+ "import": "./dist/exports/tracker.js",
43
+ "default": "./dist/exports/tracker.js"
44
+ },
45
+ "./react": {
46
+ "types": "./dist/exports/react.d.ts",
47
+ "import": "./dist/exports/react.js",
48
+ "default": "./dist/exports/react.js"
49
+ },
40
50
  "./rsc": {
41
51
  "types": "./dist/exports/rsc.d.ts",
42
52
  "import": "./dist/exports/rsc.js",
@@ -94,12 +104,17 @@
94
104
  "CHANGELOG.md",
95
105
  "LICENSE"
96
106
  ],
107
+ "dependencies": {
108
+ "path-to-regexp": "6.3.0"
109
+ },
97
110
  "peerDependencies": {
98
- "@10x-media/fields": "^0.1.0-beta.5",
111
+ "@10x-media/fields": "^0.1.0-beta.7",
99
112
  "@google-analytics/data": "^6.0.0",
100
113
  "@payloadcms/db-postgres": "^3.82.0",
114
+ "@payloadcms/next": "^3.83.0",
101
115
  "@payloadcms/ui": "^3.83.0",
102
116
  "maxmind": "^4.3.24",
117
+ "next": "^15.2.9 || ^16.2.6",
103
118
  "payload": "^3.83.0",
104
119
  "react": "^19.0.0",
105
120
  "react-datepicker": "^7.6.0",
@@ -123,13 +138,17 @@
123
138
  "@google-analytics/data": "^6.1.0",
124
139
  "@payloadcms/db-mongodb": "3.85.0",
125
140
  "@payloadcms/db-postgres": "3.85.0",
141
+ "@payloadcms/next": "3.85.0",
126
142
  "@payloadcms/ui": "3.85.0",
127
143
  "@playwright/test": "1.60.0",
144
+ "@testing-library/react": "^16.1.0",
128
145
  "@types/node": "22.19.19",
129
146
  "@types/react": "19.2.15",
130
147
  "@types/react-dom": "19.2.3",
148
+ "jsdom": "^25.0.1",
131
149
  "maxmind": "^4.3.24",
132
150
  "msw": "^2.14.6",
151
+ "next": "16.2.6",
133
152
  "payload": "3.85.0",
134
153
  "playwright": "1.60.0",
135
154
  "react": "19.2.6",
@@ -138,11 +157,12 @@
138
157
  "tsdown": "0.22.1",
139
158
  "typescript": "5.9.3",
140
159
  "vitest": "4.1.7",
141
- "@10x-media/tsconfig": "0.0.0",
142
- "@10x-media/fields": "0.1.0-beta.5",
143
- "@10x-media/vitest-config": "0.0.0",
160
+ "@10x-media/form-builder": "0.1.0-beta.25",
144
161
  "@10x-media/payload-test-harness": "0.0.0",
145
- "@10x-media/tsdown-config": "0.0.0"
162
+ "@10x-media/tsdown-config": "0.0.0",
163
+ "@10x-media/tsconfig": "0.0.0",
164
+ "@10x-media/fields": "0.1.0-beta.7",
165
+ "@10x-media/vitest-config": "0.0.0"
146
166
  },
147
167
  "publishConfig": {
148
168
  "access": "public"
@@ -155,8 +175,8 @@
155
175
  "test": "vitest run",
156
176
  "test:unit": "vitest run src",
157
177
  "test:int": "vitest run tests/int",
158
- "test:matrix": "DB_MATRIX=mongo vitest run tests/int/matrix.int.spec.ts && DB_MATRIX=postgres vitest run tests/int/matrix.int.spec.ts",
159
- "test:container": "TEST_DB=container DB_MATRIX=mongo vitest run tests/int/matrix.int.spec.ts && TEST_DB=container DB_MATRIX=postgres vitest run tests/int/matrix.int.spec.ts",
178
+ "test:matrix": "DB_MATRIX=mongo vitest run tests/int && DB_MATRIX=postgres vitest run tests/int",
179
+ "test:container": "TEST_DB=container DB_MATRIX=mongo vitest run tests/int && TEST_DB=container DB_MATRIX=postgres vitest run tests/int",
160
180
  "test:e2e": "bash scripts/e2e.sh",
161
181
  "dev": "pnpm --filter @10x-media/analytics-dev dev",
162
182
  "start": "pnpm --filter @10x-media/analytics-dev start",
@@ -1,9 +0,0 @@
1
- //#region src/native/rollups/applyDistinctDeltas.ts
2
- function bucketKey(key) {
3
- const base = `${key.granularity}|${key.period.toISOString()}|${key.path}|${key.dimension}|${key.dimvalue}`;
4
- return key.scope !== void 0 ? `${base}|${key.scope}` : base;
5
- }
6
- //#endregion
7
- export { bucketKey };
8
-
9
- //# sourceMappingURL=applyDistinctDeltas.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"applyDistinctDeltas.js","names":[],"sources":["../../../src/native/rollups/applyDistinctDeltas.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { SEEN_SLUG } from '../collections/seen'\nimport type { StoredEvent } from '../ingest/normalizeEvent'\nimport { bumpRollup } from './bumpRollup'\nimport type { RollupDelta, RollupKey } from './deltas'\nimport { insertIfNew } from './insertIfNew'\n\nexport function bucketKey(key: RollupKey): string {\n\tconst base = `${key.granularity}|${key.period.toISOString()}|${key.path}|${key.dimension}|${key.dimvalue}`\n\treturn key.scope !== undefined ? `${base}|${key.scope}` : base\n}\n\n// For each rollup bucket the event touches, count this visitor and session at most once.\n// insertIfNew is the dedup gate; only a genuinely new ledger row bumps the distinct counter.\nexport async function applyDistinctDeltas(\n\tpayload: Payload,\n\tevent: StoredEvent,\n\tdeltas: RollupDelta[]\n): Promise<void> {\n\tfor (const d of deltas) {\n\t\tconst bucket = bucketKey(d.key)\n\t\tconst period = d.key.period\n\t\tif (\n\t\t\tawait insertIfNew(payload, SEEN_SLUG, {\n\t\t\t\tbucket,\n\t\t\t\tkind: 'visitor',\n\t\t\t\tvalue: event.visitorHash,\n\t\t\t\tperiod,\n\t\t\t})\n\t\t) {\n\t\t\tawait bumpRollup(payload, d.key, { visitors: 1 })\n\t\t}\n\t\tif (\n\t\t\tawait insertIfNew(payload, SEEN_SLUG, {\n\t\t\t\tbucket,\n\t\t\t\tkind: 'session',\n\t\t\t\tvalue: event.sessionId,\n\t\t\t\tperiod,\n\t\t\t})\n\t\t) {\n\t\t\tawait bumpRollup(payload, d.key, { sessions: 1 })\n\t\t}\n\t}\n}\n"],"mappings":";AAOA,SAAgB,UAAU,KAAwB;CACjD,MAAM,OAAO,GAAG,IAAI,YAAY,GAAG,IAAI,OAAO,YAAY,EAAE,GAAG,IAAI,KAAK,GAAG,IAAI,UAAU,GAAG,IAAI;CAChG,OAAO,IAAI,UAAU,KAAA,IAAY,GAAG,KAAK,GAAG,IAAI,UAAU;AAC3D"}
@@ -1,68 +0,0 @@
1
- import { ROLLUPS_SLUG } from "../collections/rollups.js";
2
- //#region src/native/rollups/bumpRollup.ts
3
- const PG_TABLE_KEY = "analytics_rollups";
4
- /**
5
- * Loads the optional Postgres peer without a literal specifier: bundlers (Turbopack, webpack,
6
- * Vite) resolve literal dynamic imports at build time, which fails a Mongo host's build even
7
- * though this branch is unreachable there. The function-built specifier is opaque to their
8
- * analyzers, the ignore comments cover bundlers that would still warn, and the type-only
9
- * reference above erases at compile time, so the package is touched only when the Postgres
10
- * branch actually runs.
11
- */
12
- const importPostgresSql = () => {
13
- return import(
14
- /* webpackIgnore: true */
15
- /* turbopackIgnore: true */
16
- /* @vite-ignore */
17
- ["@payloadcms", "db-postgres"].join("/")
18
- );
19
- };
20
- const ZERO = {
21
- pageviews: 0,
22
- events: 0,
23
- durationMs: 0,
24
- samples: 0,
25
- visitors: 0,
26
- sessions: 0
27
- };
28
- async function bumpRollup(payload, key, inc) {
29
- if (payload.db.name === "mongoose") {
30
- const model = payload.db.collections[ROLLUPS_SLUG];
31
- if (!model) throw new Error(`analytics: mongoose collection "${ROLLUPS_SLUG}" not found`);
32
- const setOnInsert = { ...key };
33
- for (const [metric, zero] of Object.entries(ZERO)) if (!(metric in inc)) setOnInsert[metric] = zero;
34
- await model.collection.updateOne(key, {
35
- $inc: inc,
36
- $setOnInsert: setOnInsert
37
- }, { upsert: true });
38
- return;
39
- }
40
- const { sql } = await importPostgresSql();
41
- const db = payload.db;
42
- const tableName = db.tableNameMap.get(PG_TABLE_KEY);
43
- if (!tableName) throw new Error(`analytics: drizzle table "${PG_TABLE_KEY}" not found`);
44
- const table = db.tables[tableName];
45
- if (!table) throw new Error(`analytics: drizzle table object for "${tableName}" not found`);
46
- const set = {};
47
- for (const [metric, amount] of Object.entries(inc)) set[metric] = sql`${table[metric]} + ${amount}`;
48
- const target = [
49
- table.granularity,
50
- table.period,
51
- table.path,
52
- table.dimension,
53
- table.dimvalue
54
- ];
55
- if (key.scope !== void 0) target.push(table.scope);
56
- await db.drizzle.insert(table).values({
57
- ...key,
58
- ...ZERO,
59
- ...inc
60
- }).onConflictDoUpdate({
61
- target,
62
- set
63
- });
64
- }
65
- //#endregion
66
- export { bumpRollup };
67
-
68
- //# sourceMappingURL=bumpRollup.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"bumpRollup.js","names":[],"sources":["../../../src/native/rollups/bumpRollup.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ROLLUPS_SLUG } from '../collections/rollups'\nimport type { RollupKey, RollupMetric } from './deltas'\n\nconst PG_TABLE_KEY = 'analytics_rollups'\n\ntype PostgresSqlModule = { sql: typeof import('@payloadcms/db-postgres')['sql'] }\n\n/**\n * Loads the optional Postgres peer without a literal specifier: bundlers (Turbopack, webpack,\n * Vite) resolve literal dynamic imports at build time, which fails a Mongo host's build even\n * though this branch is unreachable there. The function-built specifier is opaque to their\n * analyzers, the ignore comments cover bundlers that would still warn, and the type-only\n * reference above erases at compile time, so the package is touched only when the Postgres\n * branch actually runs.\n */\nconst importPostgresSql = (): Promise<PostgresSqlModule> => {\n\tconst specifier = ['@payloadcms', 'db-postgres'].join('/')\n\treturn import(\n\t\t/* webpackIgnore: true */ /* turbopackIgnore: true */ /* @vite-ignore */ specifier\n\t) as Promise<PostgresSqlModule>\n}\n\n// payload.db raw-access shapes are intentionally loose; these narrow casts reach the\n// Mongoose driver collection / Drizzle instance for atomic upserts (no public typed API).\ntype MongoDb = {\n\tname: 'mongoose'\n\tcollections: Record<\n\t\tstring,\n\t\t{ collection: { updateOne: (f: object, u: object, o: object) => Promise<unknown> } }\n\t>\n}\ntype PgDb = {\n\tname: 'postgres'\n\tdrizzle: {\n\t\tinsert: (t: unknown) => {\n\t\t\tvalues: (v: unknown) => { onConflictDoUpdate: (c: unknown) => Promise<unknown> }\n\t\t}\n\t}\n\ttables: Record<string, Record<string, unknown>>\n\ttableNameMap: Map<string, string>\n}\n\nconst ZERO: Record<RollupMetric, number> = {\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tsamples: 0,\n\tvisitors: 0,\n\tsessions: 0,\n}\n\n// Always seed every metric on insert: Payload's defaultValue is applied app-side, not as\n// a SQL default, so a raw insert that omits a NOT NULL metric column would fail on Postgres.\nexport async function bumpRollup(\n\tpayload: Payload,\n\tkey: RollupKey,\n\tinc: Partial<Record<RollupMetric, number>>\n): Promise<void> {\n\tif (payload.db.name === 'mongoose') {\n\t\tconst db = payload.db as unknown as MongoDb\n\t\tconst model = db.collections[ROLLUPS_SLUG]\n\t\tif (!model) throw new Error(`analytics: mongoose collection \"${ROLLUPS_SLUG}\" not found`)\n\t\tconst setOnInsert: Record<string, unknown> = { ...key }\n\t\tfor (const [metric, zero] of Object.entries(ZERO)) {\n\t\t\tif (!(metric in inc)) setOnInsert[metric] = zero\n\t\t}\n\t\tawait model.collection.updateOne(\n\t\t\tkey,\n\t\t\t{ $inc: inc, $setOnInsert: setOnInsert },\n\t\t\t{ upsert: true }\n\t\t)\n\t\treturn\n\t}\n\tconst { sql } = await importPostgresSql()\n\tconst db = payload.db as unknown as PgDb\n\tconst tableName = db.tableNameMap.get(PG_TABLE_KEY)\n\tif (!tableName) throw new Error(`analytics: drizzle table \"${PG_TABLE_KEY}\" not found`)\n\tconst table = db.tables[tableName]\n\tif (!table) throw new Error(`analytics: drizzle table object for \"${tableName}\" not found`)\n\tconst set: Record<string, unknown> = {}\n\tfor (const [metric, amount] of Object.entries(inc)) {\n\t\tset[metric] = sql`${table[metric]} + ${amount}`\n\t}\n\t// The conflict target must match the unique index exactly, which includes the\n\t// scope column only in scoped installs (mirrored by a scope key on RollupKey).\n\tconst target = [table.granularity, table.period, table.path, table.dimension, table.dimvalue]\n\tif (key.scope !== undefined) {\n\t\ttarget.push(table.scope)\n\t}\n\tawait db.drizzle\n\t\t.insert(table)\n\t\t.values({ ...key, ...ZERO, ...inc })\n\t\t.onConflictDoUpdate({ target, set })\n}\n"],"mappings":";;AAIA,MAAM,eAAe;;;;;;;;;AAYrB,MAAM,0BAAsD;CAE3D,OAAO;;;;EADW,CAAC,eAAe,aAAa,EAAE,KAAK,GAE4B;;AAEnF;AAsBA,MAAM,OAAqC;CAC1C,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,SAAS;CACT,UAAU;CACV,UAAU;AACX;AAIA,eAAsB,WACrB,SACA,KACA,KACgB;CAChB,IAAI,QAAQ,GAAG,SAAS,YAAY;EAEnC,MAAM,QADK,QAAQ,GACF,YAAY;EAC7B,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,mCAAmC,aAAa,YAAY;EACxF,MAAM,cAAuC,EAAE,GAAG,IAAI;EACtD,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,IAAI,GAC/C,IAAI,EAAE,UAAU,MAAM,YAAY,UAAU;EAE7C,MAAM,MAAM,WAAW,UACtB,KACA;GAAE,MAAM;GAAK,cAAc;EAAY,GACvC,EAAE,QAAQ,KAAK,CAChB;EACA;CACD;CACA,MAAM,EAAE,QAAQ,MAAM,kBAAkB;CACxC,MAAM,KAAK,QAAQ;CACnB,MAAM,YAAY,GAAG,aAAa,IAAI,YAAY;CAClD,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,6BAA6B,aAAa,YAAY;CACtF,MAAM,QAAQ,GAAG,OAAO;CACxB,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,wCAAwC,UAAU,YAAY;CAC1F,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,CAAC,QAAQ,WAAW,OAAO,QAAQ,GAAG,GAChD,IAAI,UAAU,GAAG,GAAG,MAAM,QAAQ,KAAK;CAIxC,MAAM,SAAS;EAAC,MAAM;EAAa,MAAM;EAAQ,MAAM;EAAM,MAAM;EAAW,MAAM;CAAQ;CAC5F,IAAI,IAAI,UAAU,KAAA,GACjB,OAAO,KAAK,MAAM,KAAK;CAExB,MAAM,GAAG,QACP,OAAO,KAAK,EACZ,OAAO;EAAE,GAAG;EAAK,GAAG;EAAM,GAAG;CAAI,CAAC,EAClC,mBAAmB;EAAE;EAAQ;CAAI,CAAC;AACrC"}
@@ -1,19 +0,0 @@
1
- //#region src/native/rollups/insertIfNew.ts
2
- async function insertIfNew(payload, slug, key) {
3
- if (payload.db.name === "mongoose") {
4
- const model = payload.db.collections[slug];
5
- if (!model) throw new Error(`analytics: mongoose collection "${slug}" not found`);
6
- return (await model.collection.updateOne(key, { $setOnInsert: key }, { upsert: true })).upsertedCount === 1;
7
- }
8
- const db = payload.db;
9
- const tableKey = slug.replace(/-/g, "_");
10
- const tableName = db.tableNameMap.get(tableKey);
11
- if (!tableName) throw new Error(`analytics: drizzle table "${tableKey}" not found`);
12
- const table = db.tables[tableName];
13
- if (!table) throw new Error(`analytics: drizzle table object for "${tableName}" not found`);
14
- return (await db.drizzle.insert(table).values(key).onConflictDoNothing().returning()).length === 1;
15
- }
16
- //#endregion
17
- export { insertIfNew };
18
-
19
- //# sourceMappingURL=insertIfNew.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"insertIfNew.js","names":[],"sources":["../../../src/native/rollups/insertIfNew.ts"],"sourcesContent":["import type { Payload } from 'payload'\n\n// payload.db raw-access shapes are intentionally loose; these narrow casts reach the\n// Mongoose driver collection / Drizzle instance directly (no public typed API).\ntype MongoDb = {\n\tname: 'mongoose'\n\tcollections: Record<\n\t\tstring,\n\t\t{\n\t\t\tcollection: {\n\t\t\t\tupdateOne: (f: object, u: object, o: object) => Promise<{ upsertedCount: number }>\n\t\t\t}\n\t\t}\n\t>\n}\ntype PgDb = {\n\tname: 'postgres'\n\tdrizzle: {\n\t\tinsert: (t: unknown) => {\n\t\t\tvalues: (v: unknown) => { onConflictDoNothing: () => { returning: () => Promise<unknown[]> } }\n\t\t}\n\t}\n\ttables: Record<string, Record<string, unknown>>\n\ttableNameMap: Map<string, string>\n}\n\n// Returns true iff the row was newly inserted (the key had not been seen). Single-statement\n// atomic on both adapters; the unique index on `slug` is what makes it concurrency-safe.\nexport async function insertIfNew(\n\tpayload: Payload,\n\tslug: string,\n\tkey: Record<string, unknown>\n): Promise<boolean> {\n\tif (payload.db.name === 'mongoose') {\n\t\tconst db = payload.db as unknown as MongoDb\n\t\tconst model = db.collections[slug]\n\t\tif (!model) throw new Error(`analytics: mongoose collection \"${slug}\" not found`)\n\t\tconst res = await model.collection.updateOne(key, { $setOnInsert: key }, { upsert: true })\n\t\treturn res.upsertedCount === 1\n\t}\n\tconst db = payload.db as unknown as PgDb\n\tconst tableKey = slug.replace(/-/g, '_')\n\tconst tableName = db.tableNameMap.get(tableKey)\n\tif (!tableName) throw new Error(`analytics: drizzle table \"${tableKey}\" not found`)\n\tconst table = db.tables[tableName]\n\tif (!table) throw new Error(`analytics: drizzle table object for \"${tableName}\" not found`)\n\tconst inserted = await db.drizzle.insert(table).values(key).onConflictDoNothing().returning()\n\treturn inserted.length === 1\n}\n"],"mappings":";AA4BA,eAAsB,YACrB,SACA,MACA,KACmB;CACnB,IAAI,QAAQ,GAAG,SAAS,YAAY;EAEnC,MAAM,QADK,QAAQ,GACF,YAAY;EAC7B,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,mCAAmC,KAAK,YAAY;EAEhF,QAAO,MADW,MAAM,WAAW,UAAU,KAAK,EAAE,cAAc,IAAI,GAAG,EAAE,QAAQ,KAAK,CAAC,GAC9E,kBAAkB;CAC9B;CACA,MAAM,KAAK,QAAQ;CACnB,MAAM,WAAW,KAAK,QAAQ,MAAM,GAAG;CACvC,MAAM,YAAY,GAAG,aAAa,IAAI,QAAQ;CAC9C,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,6BAA6B,SAAS,YAAY;CAClF,MAAM,QAAQ,GAAG,OAAO;CACxB,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,wCAAwC,UAAU,YAAY;CAE1F,QAAO,MADgB,GAAG,QAAQ,OAAO,KAAK,EAAE,OAAO,GAAG,EAAE,oBAAoB,EAAE,UAAU,GAC5E,WAAW;AAC5B"}