@10x-media/analytics 1.0.0-beta.7 → 1.0.0-beta.9

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 (368) hide show
  1. package/CHANGELOG.md +118 -0
  2. package/LICENSE +21 -21
  3. package/README.md +10 -4
  4. package/dist/adapters/ga4/eventName.d.ts +15 -0
  5. package/dist/adapters/ga4/eventName.js +19 -0
  6. package/dist/adapters/ga4/eventName.js.map +1 -0
  7. package/dist/adapters/ga4/ga4.d.ts +5 -0
  8. package/dist/adapters/ga4/ga4.js +179 -70
  9. package/dist/adapters/ga4/ga4.js.map +1 -1
  10. package/dist/adapters/ga4/measurementId.js +15 -0
  11. package/dist/adapters/ga4/measurementId.js.map +1 -0
  12. package/dist/adapters/goalRead.js +126 -0
  13. package/dist/adapters/goalRead.js.map +1 -0
  14. package/dist/adapters/plausible/plausible.d.ts +15 -0
  15. package/dist/adapters/plausible/plausible.js +112 -43
  16. package/dist/adapters/plausible/plausible.js.map +1 -1
  17. package/dist/adapters/posthog/posthog.js +47 -25
  18. package/dist/adapters/posthog/posthog.js.map +1 -1
  19. package/dist/adapters/umami/umami.d.ts +8 -0
  20. package/dist/adapters/umami/umami.js +237 -28
  21. package/dist/adapters/umami/umami.js.map +1 -1
  22. package/dist/capture/slots.js +16 -5
  23. package/dist/capture/slots.js.map +1 -1
  24. package/dist/capture/trackerConfig.d.ts +1 -0
  25. package/dist/capture/trackerConfig.js +28 -3
  26. package/dist/capture/trackerConfig.js.map +1 -1
  27. package/dist/charts/BarList.d.ts +15 -1
  28. package/dist/charts/BarList.js +41 -19
  29. package/dist/charts/BarList.js.map +1 -1
  30. package/dist/charts/TrendChart.d.ts +16 -3
  31. package/dist/charts/TrendChart.js +172 -106
  32. package/dist/charts/TrendChart.js.map +1 -1
  33. package/dist/charts/bars.d.ts +2 -0
  34. package/dist/charts/bars.js +2 -1
  35. package/dist/charts/bars.js.map +1 -1
  36. package/dist/charts/bucket.js +10 -1
  37. package/dist/charts/bucket.js.map +1 -1
  38. package/dist/charts/spline.js +2 -2
  39. package/dist/charts/spline.js.map +1 -1
  40. package/dist/charts/styles.js +18 -1
  41. package/dist/charts/styles.js.map +1 -1
  42. package/dist/core/cacheKey.js +24 -2
  43. package/dist/core/cacheKey.js.map +1 -1
  44. package/dist/core/capabilities.js +7 -2
  45. package/dist/core/capabilities.js.map +1 -1
  46. package/dist/core/capture.d.ts +1 -1
  47. package/dist/core/contract.d.ts +46 -9
  48. package/dist/core/contract.js +29 -1
  49. package/dist/core/contract.js.map +1 -1
  50. package/dist/core/granularity.js +1 -1
  51. package/dist/core/options.d.ts +62 -7
  52. package/dist/core/options.js +63 -4
  53. package/dist/core/options.js.map +1 -1
  54. package/dist/core/scopedRead.js +33 -23
  55. package/dist/core/scopedRead.js.map +1 -1
  56. package/dist/core/serverEvent.d.ts +44 -0
  57. package/dist/core/serverEvent.js +12 -0
  58. package/dist/core/serverEvent.js.map +1 -0
  59. package/dist/exports/adapters/ga4.d.ts +2 -1
  60. package/dist/exports/adapters/ga4.js +2 -1
  61. package/dist/exports/client.d.ts +12 -3
  62. package/dist/exports/client.js +9 -1
  63. package/dist/exports/rsc.d.ts +7 -2
  64. package/dist/exports/rsc.js +6 -3
  65. package/dist/exports/tracker.d.ts +3 -2
  66. package/dist/exports/tracker.js +2 -1
  67. package/dist/exports/types.d.ts +13 -4
  68. package/dist/exports/types.js +3 -2
  69. package/dist/fields/AnalyticsPanelClient.js +1 -1
  70. package/dist/fields/AnalyticsPanelField.js +1 -1
  71. package/dist/fields/AnalyticsStatField.js +2 -2
  72. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  73. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  74. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  75. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  76. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  77. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  78. package/dist/fields/config/MetricSelectField.js +3 -3
  79. package/dist/fields/config/MetricSelectField.js.map +1 -1
  80. package/dist/fields/config/SourceSelectField.js +3 -3
  81. package/dist/fields/config/SourceSelectField.js.map +1 -1
  82. package/dist/fields/config/fetchSources.d.ts +5 -1
  83. package/dist/fields/config/sourcesState.js +19 -3
  84. package/dist/fields/config/sourcesState.js.map +1 -1
  85. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  86. package/dist/fields/config/useAnalyticsSources.js +9 -6
  87. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  88. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  89. package/dist/fields/config/useFilterCapabilities.js +52 -0
  90. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  91. package/dist/fields/readForDocument.d.ts +5 -0
  92. package/dist/fields/readForDocument.js +21 -9
  93. package/dist/fields/readForDocument.js.map +1 -1
  94. package/dist/goals/GoalSelectField.d.ts +7 -0
  95. package/dist/goals/GoalSelectField.js +77 -0
  96. package/dist/goals/GoalSelectField.js.map +1 -0
  97. package/dist/goals/collection.js +250 -0
  98. package/dist/goals/collection.js.map +1 -0
  99. package/dist/goals/currency.js +14 -0
  100. package/dist/goals/currency.js.map +1 -0
  101. package/dist/goals/fetchGoals.d.ts +18 -0
  102. package/dist/goals/fetchGoals.js +29 -0
  103. package/dist/goals/fetchGoals.js.map +1 -0
  104. package/dist/goals/goalField.d.ts +31 -0
  105. package/dist/goals/goalField.js +56 -0
  106. package/dist/goals/goalField.js.map +1 -0
  107. package/dist/goals/goalsEndpoint.d.ts +1 -0
  108. package/dist/goals/goalsEndpoint.js +55 -0
  109. package/dist/goals/goalsEndpoint.js.map +1 -0
  110. package/dist/goals/resolver.d.ts +8 -0
  111. package/dist/goals/resolver.js +147 -0
  112. package/dist/goals/resolver.js.map +1 -0
  113. package/dist/goals/trackGoalAction.d.ts +74 -0
  114. package/dist/goals/trackGoalAction.js +139 -0
  115. package/dist/goals/trackGoalAction.js.map +1 -0
  116. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  117. package/dist/goals/useAnalyticsGoals.js +67 -0
  118. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  119. package/dist/index.d.ts +12 -3
  120. package/dist/index.js +75 -11
  121. package/dist/index.js.map +1 -1
  122. package/dist/native/collections/events.js +36 -0
  123. package/dist/native/collections/events.js.map +1 -1
  124. package/dist/native/eventScan.js +25 -0
  125. package/dist/native/eventScan.js.map +1 -0
  126. package/dist/native/ingest/browser.js +47 -0
  127. package/dist/native/ingest/browser.js.map +1 -0
  128. package/dist/native/ingest/device.js +11 -3
  129. package/dist/native/ingest/device.js.map +1 -1
  130. package/dist/native/ingest/endpoint.d.ts +1 -0
  131. package/dist/native/ingest/endpoint.js +2 -17
  132. package/dist/native/ingest/endpoint.js.map +1 -1
  133. package/dist/native/ingest/flushBatch.js +26 -26
  134. package/dist/native/ingest/flushBatch.js.map +1 -1
  135. package/dist/native/ingest/language.js +14 -0
  136. package/dist/native/ingest/language.js.map +1 -0
  137. package/dist/native/ingest/normalizeEvent.d.ts +26 -0
  138. package/dist/native/ingest/normalizeEvent.js +35 -7
  139. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  140. package/dist/native/ingest/referrer.js +48 -0
  141. package/dist/native/ingest/referrer.js.map +1 -0
  142. package/dist/native/ingest/serverTrack.d.ts +20 -0
  143. package/dist/native/ingest/serverTrack.js +100 -0
  144. package/dist/native/ingest/serverTrack.js.map +1 -0
  145. package/dist/native/ingest/source.d.ts +7 -0
  146. package/dist/native/ingest/source.js +139 -14
  147. package/dist/native/ingest/source.js.map +1 -1
  148. package/dist/native/ingest/utm.js +33 -0
  149. package/dist/native/ingest/utm.js.map +1 -0
  150. package/dist/native/ingest/validate.js +27 -0
  151. package/dist/native/ingest/validate.js.map +1 -0
  152. package/dist/native/nativeAdapter.d.ts +1 -1
  153. package/dist/native/nativeAdapter.js +53 -36
  154. package/dist/native/nativeAdapter.js.map +1 -1
  155. package/dist/native/query/eventAgg.js +14 -1
  156. package/dist/native/query/eventAgg.js.map +1 -1
  157. package/dist/native/retention/pruneTask.js +1 -1
  158. package/dist/native/rollups/bucketKey.js +15 -0
  159. package/dist/native/rollups/bucketKey.js.map +1 -0
  160. package/dist/native/rollups/bumpRollups.js +116 -0
  161. package/dist/native/rollups/bumpRollups.js.map +1 -0
  162. package/dist/native/rollups/deltas.js +30 -15
  163. package/dist/native/rollups/deltas.js.map +1 -1
  164. package/dist/native/rollups/insertManyIfNew.js +93 -0
  165. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  166. package/dist/next/captureRewrites.d.ts +3 -2
  167. package/dist/next/captureRewrites.js +3 -2
  168. package/dist/next/captureRewrites.js.map +1 -1
  169. package/dist/plugin/documentEndpoint.js +52 -15
  170. package/dist/plugin/documentEndpoint.js.map +1 -1
  171. package/dist/plugin/goalHint.d.ts +1 -0
  172. package/dist/plugin/goalHint.js +24 -0
  173. package/dist/plugin/goalHint.js.map +1 -0
  174. package/dist/plugin/paths.js +5 -1
  175. package/dist/plugin/paths.js.map +1 -1
  176. package/dist/plugin/queryEndpoint.js +120 -0
  177. package/dist/plugin/queryEndpoint.js.map +1 -0
  178. package/dist/plugin/readContextForRequest.js +71 -0
  179. package/dist/plugin/readContextForRequest.js.map +1 -0
  180. package/dist/plugin/realtimeEndpoint.js +43 -15
  181. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  182. package/dist/plugin/responses.js +17 -0
  183. package/dist/plugin/responses.js.map +1 -0
  184. package/dist/plugin/runtime.js +31 -1
  185. package/dist/plugin/runtime.js.map +1 -1
  186. package/dist/plugin/scopeFieldBoot.js +22 -0
  187. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  188. package/dist/plugin/sourcesEndpoint.js +21 -52
  189. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  190. package/dist/plugin/warmTask.js +0 -0
  191. package/dist/plugin/warmTask.js.map +1 -1
  192. package/dist/providers/collection.js +29 -13
  193. package/dist/providers/collection.js.map +1 -1
  194. package/dist/providers/factory.js +4 -2
  195. package/dist/providers/factory.js.map +1 -1
  196. package/dist/providers/resolver.js.map +1 -1
  197. package/dist/query/dates.js +64 -0
  198. package/dist/query/dates.js.map +1 -0
  199. package/dist/query/errors.d.ts +17 -0
  200. package/dist/query/errors.js +10 -0
  201. package/dist/query/errors.js.map +1 -0
  202. package/dist/query/fetchQuery.d.ts +59 -0
  203. package/dist/query/fetchQuery.js +110 -0
  204. package/dist/query/fetchQuery.js.map +1 -0
  205. package/dist/query/parse.d.ts +22 -0
  206. package/dist/query/parse.js +168 -0
  207. package/dist/query/parse.js.map +1 -0
  208. package/dist/query/response.d.ts +39 -0
  209. package/dist/query/response.js +11 -0
  210. package/dist/query/response.js.map +1 -0
  211. package/dist/surfacing/engine.js +1 -1
  212. package/dist/surfacing/engine.js.map +1 -1
  213. package/dist/testing/memoryAdapter.js +0 -1
  214. package/dist/testing/memoryAdapter.js.map +1 -1
  215. package/dist/timeframe/tz.js +17 -6
  216. package/dist/timeframe/tz.js.map +1 -1
  217. package/dist/tracker/createTracker.js +13 -1
  218. package/dist/tracker/createTracker.js.map +1 -1
  219. package/dist/tracker/sinks/ga4.d.ts +21 -0
  220. package/dist/tracker/sinks/ga4.js +26 -0
  221. package/dist/tracker/sinks/ga4.js.map +1 -0
  222. package/dist/tracker/types.d.ts +5 -0
  223. package/dist/translations/ar.js +127 -1
  224. package/dist/translations/ar.js.map +1 -1
  225. package/dist/translations/de.js +127 -1
  226. package/dist/translations/de.js.map +1 -1
  227. package/dist/translations/en.js +127 -1
  228. package/dist/translations/en.js.map +1 -1
  229. package/dist/translations/es.js +127 -1
  230. package/dist/translations/es.js.map +1 -1
  231. package/dist/translations/fr.js +127 -1
  232. package/dist/translations/fr.js.map +1 -1
  233. package/dist/translations/id.js +127 -1
  234. package/dist/translations/id.js.map +1 -1
  235. package/dist/translations/keys.d.ts +126 -0
  236. package/dist/translations/keys.js +127 -1
  237. package/dist/translations/keys.js.map +1 -1
  238. package/dist/translations/ko.js +127 -1
  239. package/dist/translations/ko.js.map +1 -1
  240. package/dist/translations/metricKeys.js +8 -2
  241. package/dist/translations/metricKeys.js.map +1 -1
  242. package/dist/translations/pt.js +127 -1
  243. package/dist/translations/pt.js.map +1 -1
  244. package/dist/translations/ru.js +127 -1
  245. package/dist/translations/ru.js.map +1 -1
  246. package/dist/translations/server.js.map +1 -1
  247. package/dist/translations/uk.js +127 -1
  248. package/dist/translations/uk.js.map +1 -1
  249. package/dist/translations/zh.js +127 -1
  250. package/dist/translations/zh.js.map +1 -1
  251. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  252. package/dist/view/AnalyticsNavLink.js +40 -0
  253. package/dist/view/AnalyticsNavLink.js.map +1 -0
  254. package/dist/view/AnalyticsView.d.ts +23 -0
  255. package/dist/view/AnalyticsView.js +45 -0
  256. package/dist/view/AnalyticsView.js.map +1 -0
  257. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  258. package/dist/view/AnalyticsViewClient.js +200 -0
  259. package/dist/view/AnalyticsViewClient.js.map +1 -0
  260. package/dist/view/authRedirect.js +32 -0
  261. package/dist/view/authRedirect.js.map +1 -0
  262. package/dist/view/conversionRate.js +18 -0
  263. package/dist/view/conversionRate.js.map +1 -0
  264. package/dist/view/dayRange.js +68 -0
  265. package/dist/view/dayRange.js.map +1 -0
  266. package/dist/view/gating.d.ts +1 -0
  267. package/dist/view/gating.js +142 -0
  268. package/dist/view/gating.js.map +1 -0
  269. package/dist/view/labels.js +64 -0
  270. package/dist/view/labels.js.map +1 -0
  271. package/dist/view/registerView.js +48 -0
  272. package/dist/view/registerView.js.map +1 -0
  273. package/dist/view/sections/Breakdowns.js +197 -0
  274. package/dist/view/sections/Breakdowns.js.map +1 -0
  275. package/dist/view/sections/EmptyStates.js +92 -0
  276. package/dist/view/sections/EmptyStates.js.map +1 -0
  277. package/dist/view/sections/FilterChips.js +46 -0
  278. package/dist/view/sections/FilterChips.js.map +1 -0
  279. package/dist/view/sections/GoalsPanel.js +82 -0
  280. package/dist/view/sections/GoalsPanel.js.map +1 -0
  281. package/dist/view/sections/OverviewCards.js +65 -0
  282. package/dist/view/sections/OverviewCards.js.map +1 -0
  283. package/dist/view/sections/RealtimeStrip.js +80 -0
  284. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  285. package/dist/view/sections/Toolbar.js +186 -0
  286. package/dist/view/sections/Toolbar.js.map +1 -0
  287. package/dist/view/sections/Trend.js +125 -0
  288. package/dist/view/sections/Trend.js.map +1 -0
  289. package/dist/view/sections/styles.js +74 -0
  290. package/dist/view/sections/styles.js.map +1 -0
  291. package/dist/view/state.js +211 -0
  292. package/dist/view/state.js.map +1 -0
  293. package/dist/view/useViewQueries.js +153 -0
  294. package/dist/view/useViewQueries.js.map +1 -0
  295. package/dist/view/viewProps.d.ts +40 -0
  296. package/dist/view/viewProps.js +90 -0
  297. package/dist/view/viewProps.js.map +1 -0
  298. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  299. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  300. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  301. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  302. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  303. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  304. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  305. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  306. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  307. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  308. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  309. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  310. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  311. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  312. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  313. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  314. package/dist/widgets/RealtimeCounter.js +10 -1
  315. package/dist/widgets/RealtimeCounter.js.map +1 -1
  316. package/dist/widgets/WidgetViewLink.js +17 -0
  317. package/dist/widgets/WidgetViewLink.js.map +1 -0
  318. package/dist/widgets/breakdownTypes.js +28 -1
  319. package/dist/widgets/breakdownTypes.js.map +1 -1
  320. package/dist/widgets/cardChrome.js +31 -7
  321. package/dist/widgets/cardChrome.js.map +1 -1
  322. package/dist/widgets/comparison.js +15 -1
  323. package/dist/widgets/comparison.js.map +1 -1
  324. package/dist/widgets/defaults.d.ts +6 -2
  325. package/dist/widgets/defaults.js +72 -25
  326. package/dist/widgets/defaults.js.map +1 -1
  327. package/dist/widgets/filterCaption.js +27 -0
  328. package/dist/widgets/filterCaption.js.map +1 -0
  329. package/dist/widgets/filterField.d.ts +19 -0
  330. package/dist/widgets/filterField.js +75 -0
  331. package/dist/widgets/filterField.js.map +1 -0
  332. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  333. package/dist/widgets/prepareWidgetRead.js +74 -0
  334. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  335. package/dist/widgets/range.js +43 -12
  336. package/dist/widgets/range.js.map +1 -1
  337. package/dist/widgets/readForWidget.d.ts +24 -2
  338. package/dist/widgets/readForWidget.js +34 -48
  339. package/dist/widgets/readForWidget.js.map +1 -1
  340. package/dist/widgets/readForWidgetBreakdown.d.ts +32 -1
  341. package/dist/widgets/readForWidgetBreakdown.js +32 -42
  342. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  343. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  344. package/dist/widgets/readForWidgetGoals.js +140 -0
  345. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  346. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  347. package/dist/widgets/readForWidgetRealtime.js +21 -20
  348. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  349. package/dist/widgets/readForWidgetSeries.d.ts +24 -1
  350. package/dist/widgets/readForWidgetSeries.js +63 -56
  351. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  352. package/dist/widgets/readMeta.js +18 -0
  353. package/dist/widgets/readMeta.js.map +1 -0
  354. package/dist/widgets/registerWidgets.js +53 -7
  355. package/dist/widgets/registerWidgets.js.map +1 -1
  356. package/dist/widgets/types.d.ts +15 -0
  357. package/dist/widgets/types.js +12 -1
  358. package/dist/widgets/types.js.map +1 -1
  359. package/dist/widgets/viewLink.d.ts +22 -0
  360. package/dist/widgets/viewLink.js +86 -0
  361. package/dist/widgets/viewLink.js.map +1 -0
  362. package/package.json +9 -4
  363. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  364. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  365. package/dist/native/rollups/bumpRollup.js +0 -73
  366. package/dist/native/rollups/bumpRollup.js.map +0 -1
  367. package/dist/native/rollups/insertIfNew.js +0 -19
  368. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -1,4 +1,15 @@
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",
@@ -11,6 +22,6 @@ const WIDGET_METRICS = [
11
22
  "scrollDepth"
12
23
  ];
13
24
  //#endregion
14
- export { WIDGET_METRICS };
25
+ export { GOAL_ROW_LIMITS, WIDGET_METRICS, resolveGoalRowLimit };
15
26
 
16
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\t'conversions',\n\t'revenue',\n\t'scrollDepth',\n]\n"],"mappings":";AAgBA,MAAa,iBAA8B;CAC1C;CACA;CACA;CACA;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": "1.0.0-beta.7",
3
+ "version": "1.0.0-beta.9",
4
4
  "description": "Adapter-based analytics for Payload: providers, a native engine, dashboard widgets, and portable fields.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -111,8 +111,10 @@
111
111
  "@10x-media/fields": "^0.1.0-beta.7",
112
112
  "@google-analytics/data": "^6.0.0",
113
113
  "@payloadcms/db-postgres": "^3.82.0",
114
+ "@payloadcms/next": "^3.83.0",
114
115
  "@payloadcms/ui": "^3.83.0",
115
116
  "maxmind": "^4.3.24",
117
+ "next": "^15.2.9 || ^16.2.6",
116
118
  "payload": "^3.83.0",
117
119
  "react": "^19.0.0",
118
120
  "react-datepicker": "^7.6.0",
@@ -136,6 +138,7 @@
136
138
  "@google-analytics/data": "^6.1.0",
137
139
  "@payloadcms/db-mongodb": "3.85.0",
138
140
  "@payloadcms/db-postgres": "3.85.0",
141
+ "@payloadcms/next": "3.85.0",
139
142
  "@payloadcms/ui": "3.85.0",
140
143
  "@playwright/test": "1.60.0",
141
144
  "@testing-library/react": "^16.1.0",
@@ -145,6 +148,7 @@
145
148
  "jsdom": "^25.0.1",
146
149
  "maxmind": "^4.3.24",
147
150
  "msw": "^2.14.6",
151
+ "next": "16.2.6",
148
152
  "payload": "3.85.0",
149
153
  "playwright": "1.60.0",
150
154
  "react": "19.2.6",
@@ -153,11 +157,12 @@
153
157
  "tsdown": "0.22.1",
154
158
  "typescript": "5.9.3",
155
159
  "vitest": "4.1.7",
160
+ "@10x-media/fields": "0.1.0-beta.7",
156
161
  "@10x-media/tsconfig": "0.0.0",
162
+ "@10x-media/payload-test-harness": "0.0.0",
163
+ "@10x-media/form-builder": "0.1.0-beta.24",
157
164
  "@10x-media/tsdown-config": "0.0.0",
158
- "@10x-media/vitest-config": "0.0.0",
159
- "@10x-media/fields": "0.1.0-beta.7",
160
- "@10x-media/payload-test-harness": "0.0.0"
165
+ "@10x-media/vitest-config": "0.0.0"
161
166
  },
162
167
  "publishConfig": {
163
168
  "access": "public"
@@ -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}|${key.hostname}`;
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}|${key.hostname}`\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,SAAS,GAAG,IAAI;CAChH,OAAO,IAAI,UAAU,KAAA,IAAY,GAAG,KAAK,GAAG,IAAI,UAAU;AAC3D"}
@@ -1,73 +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
- conversions: 0,
28
- revenue: 0,
29
- scrollDepthSum: 0,
30
- scrollSamples: 0
31
- };
32
- async function bumpRollup(payload, key, inc) {
33
- if (payload.db.name === "mongoose") {
34
- const model = payload.db.collections[ROLLUPS_SLUG];
35
- if (!model) throw new Error(`analytics: mongoose collection "${ROLLUPS_SLUG}" not found`);
36
- const setOnInsert = { ...key };
37
- for (const [metric, zero] of Object.entries(ZERO)) if (!(metric in inc)) setOnInsert[metric] = zero;
38
- await model.collection.updateOne(key, {
39
- $inc: inc,
40
- $setOnInsert: setOnInsert
41
- }, { upsert: true });
42
- return;
43
- }
44
- const { sql } = await importPostgresSql();
45
- const db = payload.db;
46
- const tableName = db.tableNameMap.get(PG_TABLE_KEY);
47
- if (!tableName) throw new Error(`analytics: drizzle table "${PG_TABLE_KEY}" not found`);
48
- const table = db.tables[tableName];
49
- if (!table) throw new Error(`analytics: drizzle table object for "${tableName}" not found`);
50
- const set = {};
51
- for (const [metric, amount] of Object.entries(inc)) set[metric] = sql`${table[metric]} + ${amount}`;
52
- const target = [
53
- table.granularity,
54
- table.period,
55
- table.path,
56
- table.dimension,
57
- table.dimvalue,
58
- table.hostname
59
- ];
60
- if (key.scope !== void 0) target.push(table.scope);
61
- await db.drizzle.insert(table).values({
62
- ...key,
63
- ...ZERO,
64
- ...inc
65
- }).onConflictDoUpdate({
66
- target,
67
- set
68
- });
69
- }
70
- //#endregion
71
- export { bumpRollup };
72
-
73
- //# 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\tconversions: 0,\n\trevenue: 0,\n\tscrollDepthSum: 0,\n\tscrollSamples: 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 = [\n\t\ttable.granularity,\n\t\ttable.period,\n\t\ttable.path,\n\t\ttable.dimension,\n\t\ttable.dimvalue,\n\t\ttable.hostname,\n\t]\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;CACV,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,eAAe;AAChB;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;EACd,MAAM;EACN,MAAM;EACN,MAAM;EACN,MAAM;EACN,MAAM;EACN,MAAM;CACP;CACA,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"}