@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,22 +1,62 @@
1
- import { EVENTS_SLUG } from "../collections/events.js";
2
1
  import { SEEN_SLUG } from "../collections/seen.js";
2
+ import { ROLLUPS_SLUG } from "../collections/rollups.js";
3
+ import { EVENTS_SLUG } from "../collections/events.js";
4
+ import { saltKey } from "../ingest/salt.js";
3
5
  //#region src/native/retention/pruneTask.ts
4
6
  const PRUNE_TASK_SLUG = "analytics-prune-events";
5
- const pruneEventsTask = (retentionDays) => ({
7
+ const DAY_MS = 864e5;
8
+ /**
9
+ * An event arriving just before midnight is still hashed with yesterday's salt, so the sweep
10
+ * starts two days back. It ends at 62 because keys are deleted by computed name rather than by
11
+ * listing them, and that covers every day a nightly run could have missed.
12
+ */
13
+ const SALT_SWEEP_FIRST_DAY = 2;
14
+ const SALT_SWEEP_LAST_DAY = 62;
15
+ /**
16
+ * A window prunes only when it is a finite number of days above zero. Zero means "keep
17
+ * everything" wherever these windows are configured, so a window that does not say how far
18
+ * back to go must never be read here as a cutoff of now, which would delete the whole store.
19
+ */
20
+ const pruneWindow = (days) => days !== void 0 && Number.isFinite(days) && days > 0 ? days : void 0;
21
+ /**
22
+ * The nightly sweep of everything the native engine stores. It registers only on an install
23
+ * that configured a retention window, and sweeps the daily salts whenever it runs; an install
24
+ * without one sweeps its salts at ingest instead, so no install needs a jobs runner for that.
25
+ *
26
+ * A window that is not a finite number of days above zero leaves its store untouched, for both
27
+ * `retentionDays` and `rollupRetentionDays`.
28
+ *
29
+ * Deletes go through the database adapter's bulk delete, so no document is loaded to be
30
+ * deleted and nothing is reported that would cost a read to count. That bypasses collection
31
+ * hooks and access control, neither of which these three stores rely on.
32
+ */
33
+ const pruneEventsTask = (options = {}) => ({
6
34
  slug: PRUNE_TASK_SLUG,
7
35
  handler: async ({ req }) => {
8
- const cutoff = (/* @__PURE__ */ new Date(Date.now() - retentionDays * 864e5)).toISOString();
9
- const events = await req.payload.delete({
10
- collection: EVENTS_SLUG,
11
- where: { timestamp: { less_than: cutoff } },
12
- overrideAccess: true
13
- });
14
- const seen = await req.payload.delete({
15
- collection: SEEN_SLUG,
16
- where: { period: { less_than: cutoff } },
17
- overrideAccess: true
36
+ const now = (options.now ?? Date.now)();
37
+ const cutoff = (days) => (/* @__PURE__ */ new Date(now - days * DAY_MS)).toISOString();
38
+ const retentionDays = pruneWindow(options.retentionDays);
39
+ const rollupRetentionDays = pruneWindow(options.rollupRetentionDays);
40
+ if (retentionDays !== void 0) {
41
+ const before = cutoff(retentionDays);
42
+ await req.payload.db.deleteMany({
43
+ collection: EVENTS_SLUG,
44
+ where: { timestamp: { less_than: before } },
45
+ req
46
+ });
47
+ await req.payload.db.deleteMany({
48
+ collection: SEEN_SLUG,
49
+ where: { period: { less_than: before } },
50
+ req
51
+ });
52
+ }
53
+ if (rollupRetentionDays !== void 0) await req.payload.db.deleteMany({
54
+ collection: ROLLUPS_SLUG,
55
+ where: { period: { less_than: cutoff(rollupRetentionDays) } },
56
+ req
18
57
  });
19
- return { output: { deleted: events.docs.length + seen.docs.length } };
58
+ for (let day = SALT_SWEEP_FIRST_DAY; day <= SALT_SWEEP_LAST_DAY; day++) await req.payload.kv.delete(saltKey(/* @__PURE__ */ new Date(now - day * DAY_MS)));
59
+ return { output: {} };
20
60
  },
21
61
  schedule: [{
22
62
  cron: "0 3 * * *",
@@ -1 +1 @@
1
- {"version":3,"file":"pruneTask.js","names":[],"sources":["../../../src/native/retention/pruneTask.ts"],"sourcesContent":["import type { TaskConfig } from 'payload'\nimport { EVENTS_SLUG } from '../collections/events'\nimport { SEEN_SLUG } from '../collections/seen'\n\nexport const PRUNE_TASK_SLUG = 'analytics-prune-events'\n\nexport const pruneEventsTask = (\n\tretentionDays: number\n): TaskConfig<{ input: Record<string, never>; output: { deleted: number } }> => ({\n\tslug: PRUNE_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst cutoff = new Date(Date.now() - retentionDays * 86_400_000).toISOString()\n\t\tconst events = await req.payload.delete({\n\t\t\tcollection: EVENTS_SLUG as never,\n\t\t\twhere: { timestamp: { less_than: cutoff } },\n\t\t\toverrideAccess: true,\n\t\t})\n\t\tconst seen = await req.payload.delete({\n\t\t\tcollection: SEEN_SLUG as never,\n\t\t\twhere: { period: { less_than: cutoff } },\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn { output: { deleted: events.docs.length + seen.docs.length } }\n\t},\n\tschedule: [{ cron: '0 3 * * *', queue: 'default' }],\n})\n"],"mappings":";;;AAIA,MAAa,kBAAkB;AAE/B,MAAa,mBACZ,mBACgF;CAChF,MAAM;CACN,SAAS,OAAO,EAAE,UAAU;EAC3B,MAAM,0BAAS,IAAI,KAAK,KAAK,IAAI,IAAI,gBAAgB,KAAU,GAAE,YAAY;EAC7E,MAAM,SAAS,MAAM,IAAI,QAAQ,OAAO;GACvC,YAAY;GACZ,OAAO,EAAE,WAAW,EAAE,WAAW,OAAO,EAAE;GAC1C,gBAAgB;EACjB,CAAC;EACD,MAAM,OAAO,MAAM,IAAI,QAAQ,OAAO;GACrC,YAAY;GACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,OAAO,EAAE;GACvC,gBAAgB;EACjB,CAAC;EACD,OAAO,EAAE,QAAQ,EAAE,SAAS,OAAO,KAAK,SAAS,KAAK,KAAK,OAAO,EAAE;CACrE;CACA,UAAU,CAAC;EAAE,MAAM;EAAa,OAAO;CAAU,CAAC;AACnD"}
1
+ {"version":3,"file":"pruneTask.js","names":[],"sources":["../../../src/native/retention/pruneTask.ts"],"sourcesContent":["import type { TaskConfig } from 'payload'\nimport { EVENTS_SLUG } from '../collections/events'\nimport { ROLLUPS_SLUG } from '../collections/rollups'\nimport { SEEN_SLUG } from '../collections/seen'\nimport { saltKey } from '../ingest/salt'\n\nexport const PRUNE_TASK_SLUG = 'analytics-prune-events'\n\nconst DAY_MS = 86_400_000\n\n/**\n * An event arriving just before midnight is still hashed with yesterday's salt, so the sweep\n * starts two days back. It ends at 62 because keys are deleted by computed name rather than by\n * listing them, and that covers every day a nightly run could have missed.\n */\nconst SALT_SWEEP_FIRST_DAY = 2\nconst SALT_SWEEP_LAST_DAY = 62\n\nexport interface PruneOptions {\n\t/** Events and seen-ledger rows older than this many days go. Unset keeps them. */\n\tretentionDays?: number\n\t/** Rollup rows whose period is older than this many days go. Unset keeps them. */\n\trollupRetentionDays?: number\n\t/** The clock the run reads. Defaults to `Date.now`, and exists so a test can pin an instant. */\n\tnow?: () => number\n}\n\n/**\n * A window prunes only when it is a finite number of days above zero. Zero means \"keep\n * everything\" wherever these windows are configured, so a window that does not say how far\n * back to go must never be read here as a cutoff of now, which would delete the whole store.\n */\nconst pruneWindow = (days: number | undefined): number | undefined =>\n\tdays !== undefined && Number.isFinite(days) && days > 0 ? days : undefined\n\n/**\n * The nightly sweep of everything the native engine stores. It registers only on an install\n * that configured a retention window, and sweeps the daily salts whenever it runs; an install\n * without one sweeps its salts at ingest instead, so no install needs a jobs runner for that.\n *\n * A window that is not a finite number of days above zero leaves its store untouched, for both\n * `retentionDays` and `rollupRetentionDays`.\n *\n * Deletes go through the database adapter's bulk delete, so no document is loaded to be\n * deleted and nothing is reported that would cost a read to count. That bypasses collection\n * hooks and access control, neither of which these three stores rely on.\n */\nexport const pruneEventsTask = (\n\toptions: PruneOptions = {}\n): TaskConfig<{ input: Record<string, never>; output: Record<string, never> }> => ({\n\tslug: PRUNE_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst now = (options.now ?? Date.now)()\n\t\tconst cutoff = (days: number): string => new Date(now - days * DAY_MS).toISOString()\n\t\tconst retentionDays = pruneWindow(options.retentionDays)\n\t\tconst rollupRetentionDays = pruneWindow(options.rollupRetentionDays)\n\t\tif (retentionDays !== undefined) {\n\t\t\tconst before = cutoff(retentionDays)\n\t\t\tawait req.payload.db.deleteMany({\n\t\t\t\tcollection: EVENTS_SLUG,\n\t\t\t\twhere: { timestamp: { less_than: before } },\n\t\t\t\treq,\n\t\t\t})\n\t\t\tawait req.payload.db.deleteMany({\n\t\t\t\tcollection: SEEN_SLUG,\n\t\t\t\twhere: { period: { less_than: before } },\n\t\t\t\treq,\n\t\t\t})\n\t\t}\n\t\tif (rollupRetentionDays !== undefined) {\n\t\t\tawait req.payload.db.deleteMany({\n\t\t\t\tcollection: ROLLUPS_SLUG,\n\t\t\t\twhere: { period: { less_than: cutoff(rollupRetentionDays) } },\n\t\t\t\treq,\n\t\t\t})\n\t\t}\n\t\tfor (let day = SALT_SWEEP_FIRST_DAY; day <= SALT_SWEEP_LAST_DAY; day++) {\n\t\t\tawait req.payload.kv.delete(saltKey(new Date(now - day * DAY_MS)))\n\t\t}\n\t\treturn { output: {} }\n\t},\n\tschedule: [{ cron: '0 3 * * *', queue: 'default' }],\n})\n"],"mappings":";;;;;AAMA,MAAa,kBAAkB;AAE/B,MAAM,SAAS;;;;;;AAOf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;AAgB5B,MAAM,eAAe,SACpB,SAAS,KAAA,KAAa,OAAO,SAAS,IAAI,KAAK,OAAO,IAAI,OAAO,KAAA;;;;;;;;;;;;;AAclE,MAAa,mBACZ,UAAwB,CAAC,OACyD;CAClF,MAAM;CACN,SAAS,OAAO,EAAE,UAAU;EAC3B,MAAM,OAAO,QAAQ,OAAO,KAAK,KAAK;EACtC,MAAM,UAAU,0BAAyB,IAAI,KAAK,MAAM,OAAO,MAAM,GAAE,YAAY;EACnF,MAAM,gBAAgB,YAAY,QAAQ,aAAa;EACvD,MAAM,sBAAsB,YAAY,QAAQ,mBAAmB;EACnE,IAAI,kBAAkB,KAAA,GAAW;GAChC,MAAM,SAAS,OAAO,aAAa;GACnC,MAAM,IAAI,QAAQ,GAAG,WAAW;IAC/B,YAAY;IACZ,OAAO,EAAE,WAAW,EAAE,WAAW,OAAO,EAAE;IAC1C;GACD,CAAC;GACD,MAAM,IAAI,QAAQ,GAAG,WAAW;IAC/B,YAAY;IACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,OAAO,EAAE;IACvC;GACD,CAAC;EACF;EACA,IAAI,wBAAwB,KAAA,GAC3B,MAAM,IAAI,QAAQ,GAAG,WAAW;GAC/B,YAAY;GACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,OAAO,mBAAmB,EAAE,EAAE;GAC5D;EACD,CAAC;EAEF,KAAK,IAAI,MAAM,sBAAsB,OAAO,qBAAqB,OAChE,MAAM,IAAI,QAAQ,GAAG,OAAO,wBAAQ,IAAI,KAAK,MAAM,MAAM,MAAM,CAAC,CAAC;EAElE,OAAO,EAAE,QAAQ,CAAC,EAAE;CACrB;CACA,UAAU,CAAC;EAAE,MAAM;EAAa,OAAO;CAAU,CAAC;AACnD"}
@@ -5,7 +5,11 @@ const emptyAcc = () => ({
5
5
  events: 0,
6
6
  durationMs: 0,
7
7
  visitors: 0,
8
- sessions: 0
8
+ sessions: 0,
9
+ conversions: 0,
10
+ revenue: 0,
11
+ scrollDepthSum: 0,
12
+ scrollSamples: 0
9
13
  });
10
14
  const add = (acc, d) => {
11
15
  acc.pageviews += d.pageviews;
@@ -13,6 +17,10 @@ const add = (acc, d) => {
13
17
  acc.durationMs += d.durationMs;
14
18
  acc.visitors += d.visitors;
15
19
  acc.sessions += d.sessions;
20
+ acc.conversions += d.conversions ?? 0;
21
+ acc.revenue += d.revenue ?? 0;
22
+ acc.scrollDepthSum += d.scrollDepthSum ?? 0;
23
+ acc.scrollSamples += d.scrollSamples ?? 0;
16
24
  };
17
25
  const selectMetrics = (acc, wanted) => {
18
26
  const out = {};
@@ -20,7 +28,10 @@ const selectMetrics = (acc, wanted) => {
20
28
  if (wanted.includes("events")) out.events = acc.events;
21
29
  if (wanted.includes("visitors")) out.visitors = acc.visitors;
22
30
  if (wanted.includes("sessions")) out.sessions = acc.sessions;
31
+ if (wanted.includes("conversions")) out.conversions = acc.conversions;
32
+ if (wanted.includes("revenue")) out.revenue = acc.revenue;
23
33
  if (wanted.includes("avgDuration")) out.avgDuration = acc.pageviews > 0 ? Math.round(acc.durationMs / acc.pageviews) : 0;
34
+ if (wanted.includes("scrollDepth")) out.scrollDepth = acc.scrollSamples > 0 ? Math.round(acc.scrollDepthSum / acc.scrollSamples) : 0;
24
35
  return out;
25
36
  };
26
37
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"rollupAcc.js","names":[],"sources":["../../src/native/rollupAcc.ts"],"sourcesContent":["import type { AnalyticsRow, MetricKey } from '../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\n\nexport interface RollupDoc {\n\tpath: string\n\tdimvalue: string\n\tperiod: string | Date\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tvisitors: number\n\tsessions: number\n}\n\nexport interface Acc {\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tvisitors: number\n\tsessions: number\n}\n\nexport const emptyAcc = (): Acc => ({\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tvisitors: 0,\n\tsessions: 0,\n})\n\nexport const add = (acc: Acc, d: Acc): void => {\n\tacc.pageviews += d.pageviews\n\tacc.events += d.events\n\tacc.durationMs += d.durationMs\n\tacc.visitors += d.visitors\n\tacc.sessions += d.sessions\n}\n\nexport const selectMetrics = (\n\tacc: Acc,\n\twanted: MetricKey[]\n): Partial<Record<MetricKey, number>> => {\n\tconst out: Partial<Record<MetricKey, number>> = {}\n\tif (wanted.includes('pageviews')) out.pageviews = acc.pageviews\n\tif (wanted.includes('events')) out.events = acc.events\n\tif (wanted.includes('visitors')) out.visitors = acc.visitors\n\tif (wanted.includes('sessions')) out.sessions = acc.sessions\n\tif (wanted.includes('avgDuration')) {\n\t\tout.avgDuration = acc.pageviews > 0 ? Math.round(acc.durationMs / acc.pageviews) : 0\n\t}\n\treturn out\n}\n\n/**\n * Collapse per-day rollup docs into one time-series row per day in `tz` (UTC by\n * default), ascending by day. Rollups are already bucketed to their reporting-timezone\n * day at ingest, so flooring in the same `tz` is idempotent; passing the read's timezone\n * keeps a trend aligned to that zone. Distinct metrics (visitors/sessions) come from each\n * day's own rollup and are never summed across days, so a daily trend shows that day's\n * uniques.\n */\nexport const seriesFromRollups = (\n\tdocs: RollupDoc[],\n\tmetrics: MetricKey[],\n\ttz: string = DEFAULT_TIMEZONE\n): AnalyticsRow[] => {\n\tconst byDay = new Map<string, Acc>()\n\tfor (const d of docs) {\n\t\tconst day = startOfDayInTz(new Date(d.period), tz).toISOString()\n\t\tlet acc = byDay.get(day)\n\t\tif (!acc) {\n\t\t\tacc = emptyAcc()\n\t\t\tbyDay.set(day, acc)\n\t\t}\n\t\tadd(acc, d)\n\t}\n\treturn [...byDay.entries()]\n\t\t.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n\t\t.map(([day, acc]) => ({ timestamp: day, metrics: selectMetrics(acc, metrics) }))\n}\n"],"mappings":";;AAsBA,MAAa,kBAAuB;CACnC,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,UAAU;CACV,UAAU;AACX;AAEA,MAAa,OAAO,KAAU,MAAiB;CAC9C,IAAI,aAAa,EAAE;CACnB,IAAI,UAAU,EAAE;CAChB,IAAI,cAAc,EAAE;CACpB,IAAI,YAAY,EAAE;CAClB,IAAI,YAAY,EAAE;AACnB;AAEA,MAAa,iBACZ,KACA,WACwC;CACxC,MAAM,MAA0C,CAAC;CACjD,IAAI,OAAO,SAAS,WAAW,GAAG,IAAI,YAAY,IAAI;CACtD,IAAI,OAAO,SAAS,QAAQ,GAAG,IAAI,SAAS,IAAI;CAChD,IAAI,OAAO,SAAS,UAAU,GAAG,IAAI,WAAW,IAAI;CACpD,IAAI,OAAO,SAAS,UAAU,GAAG,IAAI,WAAW,IAAI;CACpD,IAAI,OAAO,SAAS,aAAa,GAChC,IAAI,cAAc,IAAI,YAAY,IAAI,KAAK,MAAM,IAAI,aAAa,IAAI,SAAS,IAAI;CAEpF,OAAO;AACR;;;;;;;;;AAUA,MAAa,qBACZ,MACA,SACA,KAAA,UACoB;CACpB,MAAM,wBAAQ,IAAI,IAAiB;CACnC,KAAK,MAAM,KAAK,MAAM;EACrB,MAAM,MAAM,eAAe,IAAI,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,YAAY;EAC/D,IAAI,MAAM,MAAM,IAAI,GAAG;EACvB,IAAI,CAAC,KAAK;GACT,MAAM,SAAS;GACf,MAAM,IAAI,KAAK,GAAG;EACnB;EACA,IAAI,KAAK,CAAC;CACX;CACA,OAAO,CAAC,GAAG,MAAM,QAAQ,CAAC,EACxB,MAAM,CAAC,IAAI,CAAC,OAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAE,EAC/C,KAAK,CAAC,KAAK,UAAU;EAAE,WAAW;EAAK,SAAS,cAAc,KAAK,OAAO;CAAE,EAAE;AACjF"}
1
+ {"version":3,"file":"rollupAcc.js","names":[],"sources":["../../src/native/rollupAcc.ts"],"sourcesContent":["import type { AnalyticsRow, MetricKey } from '../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\n\nexport interface RollupDoc {\n\tpath: string\n\tdimvalue: string\n\tperiod: string | Date\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tvisitors: number\n\tsessions: number\n\t/** Optional: rows written before the goal-counter migration carry none of these. */\n\tconversions?: number\n\trevenue?: number\n\tscrollDepthSum?: number\n\tscrollSamples?: number\n}\n\nexport interface Acc {\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tvisitors: number\n\tsessions: number\n\tconversions: number\n\trevenue: number\n\tscrollDepthSum: number\n\t/** Pageviews that reported a scroll depth; the `scrollDepth` average's denominator. */\n\tscrollSamples: number\n}\n\nexport const emptyAcc = (): Acc => ({\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tvisitors: 0,\n\tsessions: 0,\n\tconversions: 0,\n\trevenue: 0,\n\tscrollDepthSum: 0,\n\tscrollSamples: 0,\n})\n\nexport const add = (acc: Acc, d: RollupDoc | Acc): void => {\n\tacc.pageviews += d.pageviews\n\tacc.events += d.events\n\tacc.durationMs += d.durationMs\n\tacc.visitors += d.visitors\n\tacc.sessions += d.sessions\n\tacc.conversions += d.conversions ?? 0\n\tacc.revenue += d.revenue ?? 0\n\tacc.scrollDepthSum += d.scrollDepthSum ?? 0\n\tacc.scrollSamples += d.scrollSamples ?? 0\n}\n\nexport const selectMetrics = (\n\tacc: Acc,\n\twanted: MetricKey[]\n): Partial<Record<MetricKey, number>> => {\n\tconst out: Partial<Record<MetricKey, number>> = {}\n\tif (wanted.includes('pageviews')) out.pageviews = acc.pageviews\n\tif (wanted.includes('events')) out.events = acc.events\n\tif (wanted.includes('visitors')) out.visitors = acc.visitors\n\tif (wanted.includes('sessions')) out.sessions = acc.sessions\n\tif (wanted.includes('conversions')) out.conversions = acc.conversions\n\tif (wanted.includes('revenue')) out.revenue = acc.revenue\n\tif (wanted.includes('avgDuration')) {\n\t\tout.avgDuration = acc.pageviews > 0 ? Math.round(acc.durationMs / acc.pageviews) : 0\n\t}\n\tif (wanted.includes('scrollDepth')) {\n\t\t// Averaged over the pageviews that reported a depth, never over every pageview: a\n\t\t// tracker that never got to send one must not drag the average down.\n\t\tout.scrollDepth = acc.scrollSamples > 0 ? Math.round(acc.scrollDepthSum / acc.scrollSamples) : 0\n\t}\n\treturn out\n}\n\n/**\n * Collapse per-day rollup docs into one time-series row per day in `tz` (UTC by\n * default), ascending by day. Rollups are already bucketed to their reporting-timezone\n * day at ingest, so flooring in the same `tz` is idempotent; passing the read's timezone\n * keeps a trend aligned to that zone. Distinct metrics (visitors/sessions) come from each\n * day's own rollup and are never summed across days, so a daily trend shows that day's\n * uniques.\n */\nexport const seriesFromRollups = (\n\tdocs: RollupDoc[],\n\tmetrics: MetricKey[],\n\ttz: string = DEFAULT_TIMEZONE\n): AnalyticsRow[] => {\n\tconst byDay = new Map<string, Acc>()\n\tfor (const d of docs) {\n\t\tconst day = startOfDayInTz(new Date(d.period), tz).toISOString()\n\t\tlet acc = byDay.get(day)\n\t\tif (!acc) {\n\t\t\tacc = emptyAcc()\n\t\t\tbyDay.set(day, acc)\n\t\t}\n\t\tadd(acc, d)\n\t}\n\treturn [...byDay.entries()]\n\t\t.sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n\t\t.map(([day, acc]) => ({ timestamp: day, metrics: selectMetrics(acc, metrics) }))\n}\n"],"mappings":";;AAgCA,MAAa,kBAAuB;CACnC,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,UAAU;CACV,UAAU;CACV,aAAa;CACb,SAAS;CACT,gBAAgB;CAChB,eAAe;AAChB;AAEA,MAAa,OAAO,KAAU,MAA6B;CAC1D,IAAI,aAAa,EAAE;CACnB,IAAI,UAAU,EAAE;CAChB,IAAI,cAAc,EAAE;CACpB,IAAI,YAAY,EAAE;CAClB,IAAI,YAAY,EAAE;CAClB,IAAI,eAAe,EAAE,eAAe;CACpC,IAAI,WAAW,EAAE,WAAW;CAC5B,IAAI,kBAAkB,EAAE,kBAAkB;CAC1C,IAAI,iBAAiB,EAAE,iBAAiB;AACzC;AAEA,MAAa,iBACZ,KACA,WACwC;CACxC,MAAM,MAA0C,CAAC;CACjD,IAAI,OAAO,SAAS,WAAW,GAAG,IAAI,YAAY,IAAI;CACtD,IAAI,OAAO,SAAS,QAAQ,GAAG,IAAI,SAAS,IAAI;CAChD,IAAI,OAAO,SAAS,UAAU,GAAG,IAAI,WAAW,IAAI;CACpD,IAAI,OAAO,SAAS,UAAU,GAAG,IAAI,WAAW,IAAI;CACpD,IAAI,OAAO,SAAS,aAAa,GAAG,IAAI,cAAc,IAAI;CAC1D,IAAI,OAAO,SAAS,SAAS,GAAG,IAAI,UAAU,IAAI;CAClD,IAAI,OAAO,SAAS,aAAa,GAChC,IAAI,cAAc,IAAI,YAAY,IAAI,KAAK,MAAM,IAAI,aAAa,IAAI,SAAS,IAAI;CAEpF,IAAI,OAAO,SAAS,aAAa,GAGhC,IAAI,cAAc,IAAI,gBAAgB,IAAI,KAAK,MAAM,IAAI,iBAAiB,IAAI,aAAa,IAAI;CAEhG,OAAO;AACR;;;;;;;;;AAUA,MAAa,qBACZ,MACA,SACA,KAAA,UACoB;CACpB,MAAM,wBAAQ,IAAI,IAAiB;CACnC,KAAK,MAAM,KAAK,MAAM;EACrB,MAAM,MAAM,eAAe,IAAI,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,YAAY;EAC/D,IAAI,MAAM,MAAM,IAAI,GAAG;EACvB,IAAI,CAAC,KAAK;GACT,MAAM,SAAS;GACf,MAAM,IAAI,KAAK,GAAG;EACnB;EACA,IAAI,KAAK,CAAC;CACX;CACA,OAAO,CAAC,GAAG,MAAM,QAAQ,CAAC,EACxB,MAAM,CAAC,IAAI,CAAC,OAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAE,EAC/C,KAAK,CAAC,KAAK,UAAU;EAAE,WAAW;EAAK,SAAS,cAAc,KAAK,OAAO;CAAE,EAAE;AACjF"}
@@ -0,0 +1,15 @@
1
+ //#region src/native/rollups/bucketKey.ts
2
+ /**
3
+ * A rollup bucket as one string: the coalescing key a flush groups increments by, and the
4
+ * `bucket` column of the seen ledger, so a visitor is counted once per bucket per period.
5
+ * Scope is part of the key only where it is part of the bucket (a scoped install), which
6
+ * keeps an unscoped install's ledger rows byte-identical to what it already wrote.
7
+ */
8
+ function bucketKey(key) {
9
+ const base = `${key.granularity}|${key.period.toISOString()}|${key.path}|${key.dimension}|${key.dimvalue}|${key.hostname}`;
10
+ return key.scope !== void 0 ? `${base}|${key.scope}` : base;
11
+ }
12
+ //#endregion
13
+ export { bucketKey };
14
+
15
+ //# sourceMappingURL=bucketKey.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucketKey.js","names":[],"sources":["../../../src/native/rollups/bucketKey.ts"],"sourcesContent":["import type { RollupKey } from './deltas'\n\n/**\n * A rollup bucket as one string: the coalescing key a flush groups increments by, and the\n * `bucket` column of the seen ledger, so a visitor is counted once per bucket per period.\n * Scope is part of the key only where it is part of the bucket (a scoped install), which\n * keeps an unscoped install's ledger rows byte-identical to what it already wrote.\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"],"mappings":";;;;;;;AAQA,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"}
@@ -0,0 +1,116 @@
1
+ import { bucketKey } from "./bucketKey.js";
2
+ import { ROLLUPS_SLUG } from "../collections/rollups.js";
3
+ //#region src/native/rollups/bumpRollups.ts
4
+ const PG_TABLE_KEY = "analytics_rollups";
5
+ /**
6
+ * Loads the optional Postgres peer without a literal specifier: bundlers (Turbopack, webpack,
7
+ * Vite) resolve literal dynamic imports at build time, which fails a Mongo host's build even
8
+ * though this branch is unreachable there. The function-built specifier is opaque to their
9
+ * analyzers, the ignore comments cover bundlers that would still warn, and the type-only
10
+ * reference above erases at compile time, so the package is touched only when the Postgres
11
+ * branch actually runs.
12
+ */
13
+ const importPostgresSql = () => {
14
+ return import(
15
+ /* webpackIgnore: true */
16
+ /* turbopackIgnore: true */
17
+ /* @vite-ignore */
18
+ ["@payloadcms", "db-postgres"].join("/")
19
+ );
20
+ };
21
+ const ROLLUP_ZERO = {
22
+ pageviews: 0,
23
+ events: 0,
24
+ durationMs: 0,
25
+ samples: 0,
26
+ visitors: 0,
27
+ sessions: 0,
28
+ conversions: 0,
29
+ revenue: 0,
30
+ scrollDepthSum: 0,
31
+ scrollSamples: 0
32
+ };
33
+ /**
34
+ * Sums bumps that land on the same bucket. Required, not an optimization: Postgres rejects a
35
+ * statement whose ON CONFLICT DO UPDATE would touch one row twice, and a flush routinely
36
+ * bumps a bucket's visitors and sessions in the same call.
37
+ */
38
+ const coalesce = (bumps) => {
39
+ const merged = /* @__PURE__ */ new Map();
40
+ for (const bump of bumps) {
41
+ const existing = merged.get(bucketKey(bump.key));
42
+ if (!existing) {
43
+ merged.set(bucketKey(bump.key), {
44
+ key: bump.key,
45
+ inc: { ...bump.inc }
46
+ });
47
+ continue;
48
+ }
49
+ for (const [metric, amount] of Object.entries(bump.inc)) existing.inc[metric] = (existing.inc[metric] ?? 0) + amount;
50
+ }
51
+ return [...merged.values()];
52
+ };
53
+ /**
54
+ * Upserts every bucket in one statement per database, incrementing where the row exists and
55
+ * seeding the full metric baseline where it does not (Payload's defaultValue is applied
56
+ * app-side, not as a SQL default, so a raw insert that omits a NOT NULL metric would fail on
57
+ * Postgres). This is the write path a flush uses: one round trip instead of one per bucket,
58
+ * which is the difference between a handful and a few hundred per ingested hit.
59
+ */
60
+ async function bumpRollups(payload, bumps) {
61
+ const merged = coalesce(bumps);
62
+ if (merged.length === 0) return;
63
+ const scoped = merged[0]?.key.scope !== void 0;
64
+ if (merged.some(({ key }) => key.scope !== void 0 !== scoped)) throw new Error("analytics: rollup bumps mix scoped and unscoped buckets in one batch");
65
+ if (payload.db.name === "mongoose") {
66
+ const model = payload.db.collections[ROLLUPS_SLUG];
67
+ if (!model) throw new Error(`analytics: mongoose collection "${ROLLUPS_SLUG}" not found`);
68
+ const ops = merged.map(({ key, inc }) => {
69
+ const setOnInsert = { ...key };
70
+ for (const [metric, zero] of Object.entries(ROLLUP_ZERO)) if (!(metric in inc)) setOnInsert[metric] = zero;
71
+ return { updateOne: {
72
+ filter: key,
73
+ update: Object.keys(inc).length > 0 ? {
74
+ $inc: inc,
75
+ $setOnInsert: setOnInsert
76
+ } : { $setOnInsert: setOnInsert },
77
+ upsert: true
78
+ } };
79
+ });
80
+ await model.collection.bulkWrite(ops, { ordered: false });
81
+ return;
82
+ }
83
+ const { sql } = await importPostgresSql();
84
+ const db = payload.db;
85
+ const tableName = db.tableNameMap.get(PG_TABLE_KEY);
86
+ if (!tableName) throw new Error(`analytics: drizzle table "${PG_TABLE_KEY}" not found`);
87
+ const table = db.tables[tableName];
88
+ if (!table) throw new Error(`analytics: drizzle table object for "${tableName}" not found`);
89
+ const set = {};
90
+ for (const metric of Object.keys(ROLLUP_ZERO)) {
91
+ const column = table[metric];
92
+ if (!column?.name) throw new Error(`analytics: rollup column "${metric}" not found`);
93
+ set[metric] = sql`${table[metric]} + excluded.${sql.identifier(column.name)}`;
94
+ }
95
+ const target = [
96
+ table.granularity,
97
+ table.period,
98
+ table.path,
99
+ table.dimension,
100
+ table.dimvalue,
101
+ table.hostname
102
+ ];
103
+ if (scoped) target.push(table.scope);
104
+ await db.drizzle.insert(table).values(merged.map(({ key, inc }) => ({
105
+ ...key,
106
+ ...ROLLUP_ZERO,
107
+ ...inc
108
+ }))).onConflictDoUpdate({
109
+ target,
110
+ set
111
+ });
112
+ }
113
+ //#endregion
114
+ export { bumpRollups };
115
+
116
+ //# sourceMappingURL=bumpRollups.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bumpRollups.js","names":[],"sources":["../../../src/native/rollups/bumpRollups.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ROLLUPS_SLUG } from '../collections/rollups'\nimport { bucketKey } from './bucketKey'\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<string, { collection: { bulkWrite: (ops: object[], o: object) => unknown } }>\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\nexport const ROLLUP_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\nexport interface RollupBump {\n\tkey: RollupKey\n\tinc: Partial<Record<RollupMetric, number>>\n}\n\n/**\n * Sums bumps that land on the same bucket. Required, not an optimization: Postgres rejects a\n * statement whose ON CONFLICT DO UPDATE would touch one row twice, and a flush routinely\n * bumps a bucket's visitors and sessions in the same call.\n */\nconst coalesce = (bumps: RollupBump[]): RollupBump[] => {\n\tconst merged = new Map<string, RollupBump>()\n\tfor (const bump of bumps) {\n\t\tconst existing = merged.get(bucketKey(bump.key))\n\t\tif (!existing) {\n\t\t\tmerged.set(bucketKey(bump.key), { key: bump.key, inc: { ...bump.inc } })\n\t\t\tcontinue\n\t\t}\n\t\tfor (const [metric, amount] of Object.entries(bump.inc) as Array<[RollupMetric, number]>) {\n\t\t\texisting.inc[metric] = (existing.inc[metric] ?? 0) + amount\n\t\t}\n\t}\n\treturn [...merged.values()]\n}\n\n/**\n * Upserts every bucket in one statement per database, incrementing where the row exists and\n * seeding the full metric baseline where it does not (Payload's defaultValue is applied\n * app-side, not as a SQL default, so a raw insert that omits a NOT NULL metric would fail on\n * Postgres). This is the write path a flush uses: one round trip instead of one per bucket,\n * which is the difference between a handful and a few hundred per ingested hit.\n */\nexport async function bumpRollups(payload: Payload, bumps: RollupBump[]): Promise<void> {\n\tconst merged = coalesce(bumps)\n\tif (merged.length === 0) {\n\t\treturn\n\t}\n\t// A batch belongs to one install shape: scope is part of the unique bucket where it is\n\t// present, and Postgres needs one conflict target for the whole statement. A mixed batch has\n\t// no single right answer, so it is a caller bug on both adapters rather than rows quietly\n\t// filed under the first bucket's shape.\n\tconst scoped = merged[0]?.key.scope !== undefined\n\tif (merged.some(({ key }) => (key.scope !== undefined) !== scoped)) {\n\t\tthrow new Error('analytics: rollup bumps mix scoped and unscoped buckets in one batch')\n\t}\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 ops = merged.map(({ key, inc }) => {\n\t\t\tconst setOnInsert: Record<string, unknown> = { ...key }\n\t\t\tfor (const [metric, zero] of Object.entries(ROLLUP_ZERO)) {\n\t\t\t\tif (!(metric in inc)) setOnInsert[metric] = zero\n\t\t\t}\n\t\t\t// $inc rejects an empty operand, so a bump with no metrics only seeds the row.\n\t\t\tconst update =\n\t\t\t\tObject.keys(inc).length > 0\n\t\t\t\t\t? { $inc: inc, $setOnInsert: setOnInsert }\n\t\t\t\t\t: { $setOnInsert: setOnInsert }\n\t\t\treturn { updateOne: { filter: key, update, upsert: true } }\n\t\t})\n\t\tawait model.collection.bulkWrite(ops, { ordered: false })\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\t// Every metric is updated from `excluded`, the row this statement tried to insert, so one\n\t// statement can carry a different set of increments per bucket. The metrics a bump does\n\t// not name are zero in its row, and adding zero is the no-op it should be.\n\tconst set: Record<string, unknown> = {}\n\tfor (const metric of Object.keys(ROLLUP_ZERO)) {\n\t\tconst column = table[metric] as { name?: string } | undefined\n\t\tif (!column?.name) throw new Error(`analytics: rollup column \"${metric}\" not found`)\n\t\tset[metric] = sql`${table[metric]} + excluded.${sql.identifier(column.name)}`\n\t}\n\t// The conflict target must match the unique index exactly, which carries the scope column\n\t// only in scoped installs.\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 (scoped) {\n\t\ttarget.push(table.scope)\n\t}\n\tawait db.drizzle\n\t\t.insert(table)\n\t\t.values(merged.map(({ key, inc }) => ({ ...key, ...ROLLUP_ZERO, ...inc })))\n\t\t.onConflictDoUpdate({ target, set })\n}\n"],"mappings":"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"}
@@ -1,28 +1,103 @@
1
1
  import { startOfDayInTz } from "../../timeframe/tz.js";
2
2
  //#region src/native/rollups/deltas.ts
3
+ /**
4
+ * Every dimension whose bucket value is a stored string field, and the field it reads. A
5
+ * dimension the event carries no value for emits no bucket at all, so an unattributed hit
6
+ * never lands in an "unknown" row. `referrer` reads the host derived at ingest, the same
7
+ * field the raw-event read path groups and filters on.
8
+ */
9
+ const DIMENSION_FIELDS = [
10
+ ["country", "country"],
11
+ ["region", "region"],
12
+ ["city", "city"],
13
+ ["device", "device"],
14
+ ["browser", "browser"],
15
+ ["os", "os"],
16
+ ["language", "language"],
17
+ ["source", "source"],
18
+ ["channel", "channel"],
19
+ ["referrer", "referrerHost"],
20
+ ["utmSource", "utmSource"],
21
+ ["utmMedium", "utmMedium"],
22
+ ["utmCampaign", "utmCampaign"],
23
+ ["utmContent", "utmContent"],
24
+ ["utmTerm", "utmTerm"]
25
+ ];
26
+ /**
27
+ * Distinct metrics (visitors, sessions) are exact per bucket and must never be summed
28
+ * across buckets, so an unfiltered read has to hit its own exact family rather than
29
+ * derive from a hostname-scoped one (or vice versa). Every bucket is therefore emitted
30
+ * twice when a hostname is present: once in the hostname-less ('') family that unfiltered
31
+ * reads use, and once more in the exact-hostname family that a hostname-scoped read uses.
32
+ * Both families stay per-bucket exact at the cost of one extra bucket set per distinct
33
+ * hostname a site sees.
34
+ *
35
+ * Goal completions add one `('', 'goal', slug)` bucket each, carrying that goal's own single
36
+ * conversion, while every other bucket carries the event's whole conversion count, so a
37
+ * site-wide or per-page total never has to scan the goal buckets.
38
+ */
3
39
  function computeRollupDeltas(event) {
4
40
  const period = startOfDayInTz(event.timestamp, event.timezone);
41
+ const completions = event.goals ?? [];
42
+ const reportedDepth = event.scrollDepth !== void 0;
5
43
  const inc = {
6
44
  pageviews: event.type === "pageview" ? 1 : 0,
7
- events: event.type === "event" ? 1 : 0,
45
+ events: event.type === "pageview" ? 0 : 1,
8
46
  durationMs: event.durationMs ?? 0,
9
- samples: 1
47
+ samples: 1,
48
+ conversions: completions.length,
49
+ revenue: completions.reduce((sum, goal) => sum + goal.value, 0),
50
+ scrollDepthSum: reportedDepth ? event.scrollDepth ?? 0 : 0,
51
+ scrollSamples: reportedDepth ? 1 : 0
10
52
  };
11
- const make = (path, dimension, dimvalue) => ({
53
+ const make = (bucket, hostname, over) => ({
12
54
  key: {
13
55
  granularity: "day",
14
56
  period,
15
- path,
16
- dimension,
17
- dimvalue,
57
+ path: bucket[0],
58
+ dimension: bucket[1],
59
+ dimvalue: bucket[2],
60
+ hostname,
18
61
  ...event.scope !== void 0 ? { scope: event.scope } : {}
19
62
  },
20
- inc: { ...inc }
63
+ inc: {
64
+ ...inc,
65
+ ...over
66
+ }
21
67
  });
22
- const deltas = [make(event.path, "", ""), make("", "", "")];
23
- if (event.country) deltas.push(make("", "country", event.country));
24
- if (event.device) deltas.push(make("", "device", event.device));
25
- if (event.source) deltas.push(make("", "source", event.source));
68
+ const buckets = [[
69
+ event.path,
70
+ "",
71
+ ""
72
+ ], [
73
+ "",
74
+ "",
75
+ ""
76
+ ]];
77
+ if (event.type === "event" && event.name) buckets.push([
78
+ "",
79
+ "event",
80
+ event.name
81
+ ]);
82
+ for (const [dimension, field] of DIMENSION_FIELDS) {
83
+ const value = event[field];
84
+ if (typeof value === "string" && value) buckets.push([
85
+ "",
86
+ dimension,
87
+ value
88
+ ]);
89
+ }
90
+ const families = event.hostname ? ["", event.hostname] : [""];
91
+ const deltas = [];
92
+ for (const hostname of families) deltas.push(...buckets.map((bucket) => make(bucket, hostname)));
93
+ for (const hostname of families) for (const completion of completions) deltas.push(make([
94
+ "",
95
+ "goal",
96
+ completion.slug
97
+ ], hostname, {
98
+ conversions: 1,
99
+ revenue: completion.value
100
+ }));
26
101
  return deltas;
27
102
  }
28
103
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"deltas.js","names":[],"sources":["../../../src/native/rollups/deltas.ts"],"sourcesContent":["import { startOfDayInTz } from '../../timeframe/tz'\nimport type { StoredEvent } from '../ingest/normalizeEvent'\n\nexport interface RollupKey {\n\tgranularity: 'day'\n\tperiod: Date\n\tpath: string\n\tdimension: string\n\tdimvalue: string\n\t/** Present only in scoped installs, where it is part of the unique bucket. */\n\tscope?: string\n}\n\nexport type RollupMetric =\n\t| 'pageviews'\n\t| 'events'\n\t| 'durationMs'\n\t| 'samples'\n\t| 'visitors'\n\t| 'sessions'\n\nexport interface RollupDelta {\n\tkey: RollupKey\n\tinc: { pageviews: number; events: number; durationMs: number; samples: number }\n}\n\nexport function computeRollupDeltas(event: StoredEvent): RollupDelta[] {\n\t// Bucket into the event's reporting-timezone day (UTC when unset), fixing the day\n\t// boundary at ingest. Existing rollups are not re-bucketed if the timezone changes.\n\tconst period = startOfDayInTz(event.timestamp, event.timezone)\n\tconst inc = {\n\t\tpageviews: event.type === 'pageview' ? 1 : 0,\n\t\tevents: event.type === 'event' ? 1 : 0,\n\t\tdurationMs: event.durationMs ?? 0,\n\t\tsamples: 1,\n\t}\n\tconst make = (path: string, dimension: string, dimvalue: string): RollupDelta => ({\n\t\tkey: {\n\t\t\tgranularity: 'day',\n\t\t\tperiod,\n\t\t\tpath,\n\t\t\tdimension,\n\t\t\tdimvalue,\n\t\t\t...(event.scope !== undefined ? { scope: event.scope } : {}),\n\t\t},\n\t\tinc: { ...inc },\n\t})\n\tconst deltas: RollupDelta[] = [make(event.path, '', ''), make('', '', '')]\n\tif (event.country) {\n\t\tdeltas.push(make('', 'country', event.country))\n\t}\n\tif (event.device) {\n\t\tdeltas.push(make('', 'device', event.device))\n\t}\n\tif (event.source) {\n\t\tdeltas.push(make('', 'source', event.source))\n\t}\n\treturn deltas\n}\n"],"mappings":";;AA0BA,SAAgB,oBAAoB,OAAmC;CAGtE,MAAM,SAAS,eAAe,MAAM,WAAW,MAAM,QAAQ;CAC7D,MAAM,MAAM;EACX,WAAW,MAAM,SAAS,aAAa,IAAI;EAC3C,QAAQ,MAAM,SAAS,UAAU,IAAI;EACrC,YAAY,MAAM,cAAc;EAChC,SAAS;CACV;CACA,MAAM,QAAQ,MAAc,WAAmB,cAAmC;EACjF,KAAK;GACJ,aAAa;GACb;GACA;GACA;GACA;GACA,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC3D;EACA,KAAK,EAAE,GAAG,IAAI;CACf;CACA,MAAM,SAAwB,CAAC,KAAK,MAAM,MAAM,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;CACzE,IAAI,MAAM,SACT,OAAO,KAAK,KAAK,IAAI,WAAW,MAAM,OAAO,CAAC;CAE/C,IAAI,MAAM,QACT,OAAO,KAAK,KAAK,IAAI,UAAU,MAAM,MAAM,CAAC;CAE7C,IAAI,MAAM,QACT,OAAO,KAAK,KAAK,IAAI,UAAU,MAAM,MAAM,CAAC;CAE7C,OAAO;AACR"}
1
+ {"version":3,"file":"deltas.js","names":[],"sources":["../../../src/native/rollups/deltas.ts"],"sourcesContent":["import type { DimensionKey } from '../../core/contract'\nimport { startOfDayInTz } from '../../timeframe/tz'\nimport type { StoredEvent } from '../ingest/normalizeEvent'\n\nexport interface RollupKey {\n\tgranularity: 'day'\n\tperiod: Date\n\tpath: string\n\tdimension: string\n\tdimvalue: string\n\t/** '' is the hostname-less bucket family; a real hostname is its own family. */\n\thostname: string\n\t/** Present only in scoped installs, where it is part of the unique bucket. */\n\tscope?: string\n}\n\nexport type RollupMetric =\n\t| 'pageviews'\n\t| 'events'\n\t| 'durationMs'\n\t| 'samples'\n\t| 'visitors'\n\t| 'sessions'\n\t| 'conversions'\n\t| 'revenue'\n\t| 'scrollDepthSum'\n\t| 'scrollSamples'\n\n/**\n * `samples` counts every event in the bucket, so it cannot be the scroll-depth denominator:\n * `scrollSamples` counts only the pageviews that actually reported a depth, which is what\n * keeps the `scrollDepth` average honest when the tracker never got to send one.\n */\nexport type RollupInc = {\n\tpageviews: number\n\tevents: number\n\tdurationMs: number\n\tsamples: number\n\tconversions: number\n\trevenue: number\n\tscrollDepthSum: number\n\tscrollSamples: number\n}\n\nexport interface RollupDelta {\n\tkey: RollupKey\n\tinc: RollupInc\n}\n\n/**\n * Every dimension whose bucket value is a stored string field, and the field it reads. A\n * dimension the event carries no value for emits no bucket at all, so an unattributed hit\n * never lands in an \"unknown\" row. `referrer` reads the host derived at ingest, the same\n * field the raw-event read path groups and filters on.\n */\nconst DIMENSION_FIELDS: ReadonlyArray<\n\treadonly [dimension: DimensionKey, field: keyof StoredEvent]\n> = [\n\t['country', 'country'],\n\t['region', 'region'],\n\t['city', 'city'],\n\t['device', 'device'],\n\t['browser', 'browser'],\n\t['os', 'os'],\n\t['language', 'language'],\n\t['source', 'source'],\n\t['channel', 'channel'],\n\t['referrer', 'referrerHost'],\n\t['utmSource', 'utmSource'],\n\t['utmMedium', 'utmMedium'],\n\t['utmCampaign', 'utmCampaign'],\n\t['utmContent', 'utmContent'],\n\t['utmTerm', 'utmTerm'],\n]\n\n/**\n * Distinct metrics (visitors, sessions) are exact per bucket and must never be summed\n * across buckets, so an unfiltered read has to hit its own exact family rather than\n * derive from a hostname-scoped one (or vice versa). Every bucket is therefore emitted\n * twice when a hostname is present: once in the hostname-less ('') family that unfiltered\n * reads use, and once more in the exact-hostname family that a hostname-scoped read uses.\n * Both families stay per-bucket exact at the cost of one extra bucket set per distinct\n * hostname a site sees.\n *\n * Goal completions add one `('', 'goal', slug)` bucket each, carrying that goal's own single\n * conversion, while every other bucket carries the event's whole conversion count, so a\n * site-wide or per-page total never has to scan the goal buckets.\n */\nexport function computeRollupDeltas(event: StoredEvent): RollupDelta[] {\n\t// Bucket into the event's reporting-timezone day (UTC when unset), fixing the day\n\t// boundary at ingest. Existing rollups are not re-bucketed if the timezone changes.\n\tconst period = startOfDayInTz(event.timestamp, event.timezone)\n\tconst completions = event.goals ?? []\n\tconst reportedDepth = event.scrollDepth !== undefined\n\tconst inc: RollupInc = {\n\t\tpageviews: event.type === 'pageview' ? 1 : 0,\n\t\t// A `goal` event is a non-pageview hit like a custom event; it stays out of the\n\t\t// `event` dimension breakdown, which reports named custom events only.\n\t\tevents: event.type === 'pageview' ? 0 : 1,\n\t\tdurationMs: event.durationMs ?? 0,\n\t\tsamples: 1,\n\t\tconversions: completions.length,\n\t\trevenue: completions.reduce((sum, goal) => sum + goal.value, 0),\n\t\tscrollDepthSum: reportedDepth ? (event.scrollDepth ?? 0) : 0,\n\t\tscrollSamples: reportedDepth ? 1 : 0,\n\t}\n\tconst make = (\n\t\tbucket: [path: string, dimension: string, dimvalue: string],\n\t\thostname: string,\n\t\tover?: Partial<RollupInc>\n\t): RollupDelta => ({\n\t\tkey: {\n\t\t\tgranularity: 'day',\n\t\t\tperiod,\n\t\t\tpath: bucket[0],\n\t\t\tdimension: bucket[1],\n\t\t\tdimvalue: bucket[2],\n\t\t\thostname,\n\t\t\t...(event.scope !== undefined ? { scope: event.scope } : {}),\n\t\t},\n\t\tinc: { ...inc, ...over },\n\t})\n\tconst buckets: Array<[path: string, dimension: string, dimvalue: string]> = [\n\t\t[event.path, '', ''],\n\t\t['', '', ''],\n\t]\n\tif (event.type === 'event' && event.name) {\n\t\tbuckets.push(['', 'event', event.name])\n\t}\n\tfor (const [dimension, field] of DIMENSION_FIELDS) {\n\t\tconst value = event[field]\n\t\tif (typeof value === 'string' && value) {\n\t\t\tbuckets.push(['', dimension, value])\n\t\t}\n\t}\n\tconst families = event.hostname ? ['', event.hostname] : ['']\n\tconst deltas: RollupDelta[] = []\n\tfor (const hostname of families) {\n\t\tdeltas.push(...buckets.map((bucket) => make(bucket, hostname)))\n\t}\n\tfor (const hostname of families) {\n\t\tfor (const completion of completions) {\n\t\t\tdeltas.push(\n\t\t\t\tmake(['', 'goal', completion.slug], hostname, {\n\t\t\t\t\tconversions: 1,\n\t\t\t\t\trevenue: completion.value,\n\t\t\t\t})\n\t\t\t)\n\t\t}\n\t}\n\treturn deltas\n}\n"],"mappings":";;;;;;;;AAuDA,MAAM,mBAEF;CACH,CAAC,WAAW,SAAS;CACrB,CAAC,UAAU,QAAQ;CACnB,CAAC,QAAQ,MAAM;CACf,CAAC,UAAU,QAAQ;CACnB,CAAC,WAAW,SAAS;CACrB,CAAC,MAAM,IAAI;CACX,CAAC,YAAY,UAAU;CACvB,CAAC,UAAU,QAAQ;CACnB,CAAC,WAAW,SAAS;CACrB,CAAC,YAAY,cAAc;CAC3B,CAAC,aAAa,WAAW;CACzB,CAAC,aAAa,WAAW;CACzB,CAAC,eAAe,aAAa;CAC7B,CAAC,cAAc,YAAY;CAC3B,CAAC,WAAW,SAAS;AACtB;;;;;;;;;;;;;;AAeA,SAAgB,oBAAoB,OAAmC;CAGtE,MAAM,SAAS,eAAe,MAAM,WAAW,MAAM,QAAQ;CAC7D,MAAM,cAAc,MAAM,SAAS,CAAC;CACpC,MAAM,gBAAgB,MAAM,gBAAgB,KAAA;CAC5C,MAAM,MAAiB;EACtB,WAAW,MAAM,SAAS,aAAa,IAAI;EAG3C,QAAQ,MAAM,SAAS,aAAa,IAAI;EACxC,YAAY,MAAM,cAAc;EAChC,SAAS;EACT,aAAa,YAAY;EACzB,SAAS,YAAY,QAAQ,KAAK,SAAS,MAAM,KAAK,OAAO,CAAC;EAC9D,gBAAgB,gBAAiB,MAAM,eAAe,IAAK;EAC3D,eAAe,gBAAgB,IAAI;CACpC;CACA,MAAM,QACL,QACA,UACA,UACkB;EAClB,KAAK;GACJ,aAAa;GACb;GACA,MAAM,OAAO;GACb,WAAW,OAAO;GAClB,UAAU,OAAO;GACjB;GACA,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC3D;EACA,KAAK;GAAE,GAAG;GAAK,GAAG;EAAK;CACxB;CACA,MAAM,UAAsE,CAC3E;EAAC,MAAM;EAAM;EAAI;CAAE,GACnB;EAAC;EAAI;EAAI;CAAE,CACZ;CACA,IAAI,MAAM,SAAS,WAAW,MAAM,MACnC,QAAQ,KAAK;EAAC;EAAI;EAAS,MAAM;CAAI,CAAC;CAEvC,KAAK,MAAM,CAAC,WAAW,UAAU,kBAAkB;EAClD,MAAM,QAAQ,MAAM;EACpB,IAAI,OAAO,UAAU,YAAY,OAChC,QAAQ,KAAK;GAAC;GAAI;GAAW;EAAK,CAAC;CAErC;CACA,MAAM,WAAW,MAAM,WAAW,CAAC,IAAI,MAAM,QAAQ,IAAI,CAAC,EAAE;CAC5D,MAAM,SAAwB,CAAC;CAC/B,KAAK,MAAM,YAAY,UACtB,OAAO,KAAK,GAAG,QAAQ,KAAK,WAAW,KAAK,QAAQ,QAAQ,CAAC,CAAC;CAE/D,KAAK,MAAM,YAAY,UACtB,KAAK,MAAM,cAAc,aACxB,OAAO,KACN,KAAK;EAAC;EAAI;EAAQ,WAAW;CAAI,GAAG,UAAU;EAC7C,aAAa;EACb,SAAS,WAAW;CACrB,CAAC,CACF;CAGF,OAAO;AACR"}
@@ -0,0 +1,93 @@
1
+ //#region src/native/rollups/insertManyIfNew.ts
2
+ /** Mongo duplicate key. */
3
+ const MONGO_DUPLICATE = 11e3;
4
+ /**
5
+ * Which rows of an unordered `insertMany` the index rejected, or undefined when the failure
6
+ * was something else entirely (a dead connection, a validation error) and must be rethrown
7
+ * rather than read as "already seen".
8
+ */
9
+ const duplicateIndexes = (err) => {
10
+ if (typeof err !== "object" || err === null) return;
11
+ const raw = err.writeErrors;
12
+ const errors = Array.isArray(raw) ? raw : raw ? [raw] : [];
13
+ if (errors.length === 0) return err.code === MONGO_DUPLICATE ? new Set([0]) : void 0;
14
+ const indexes = /* @__PURE__ */ new Set();
15
+ for (const error of errors) {
16
+ if (error.code !== MONGO_DUPLICATE || typeof error.index !== "number") return;
17
+ indexes.add(error.index);
18
+ }
19
+ return indexes;
20
+ };
21
+ /**
22
+ * Row identity for matching a returned row back to the row that asked for it. A date field is
23
+ * normalized through Date because Postgres hands a timestamp back as its own text
24
+ * (`2026-08-01 00:00:00+00`) rather than as the Date that was sent.
25
+ */
26
+ const rowKey = (row, fields, dateFields) => JSON.stringify(fields.map((field) => {
27
+ const value = row[field];
28
+ if (!dateFields.has(field)) return String(value);
29
+ const time = new Date(value).getTime();
30
+ return Number.isNaN(time) ? String(value) : time;
31
+ }));
32
+ /**
33
+ * `insertIfNew` for a whole batch: one statement, one answer per row in the order they were
34
+ * given, true where that row was the one that created the ledger entry. The unique index is
35
+ * still the entire correctness mechanism, so a row another writer inserted first comes back
36
+ * false whether the driver reports it quietly or as a duplicate-key error.
37
+ *
38
+ * A row repeated inside one batch counts once, the first occurrence: Mongo would answer the
39
+ * repeat with a duplicate-key error while Postgres skips it silently, so the batch is
40
+ * de-duplicated here and both databases give the same answer.
41
+ */
42
+ async function insertManyIfNew(payload, slug, rows) {
43
+ if (rows.length === 0) return [];
44
+ const fields = Object.keys(rows[0]);
45
+ const dateFields = new Set(fields.filter((f) => rows.some((row) => row[f] instanceof Date)));
46
+ const seenInBatch = /* @__PURE__ */ new Set();
47
+ const first = rows.map((row) => {
48
+ const key = rowKey(row, fields, dateFields);
49
+ if (seenInBatch.has(key)) return false;
50
+ seenInBatch.add(key);
51
+ return true;
52
+ });
53
+ const attempts = rows.filter((_, index) => first[index]);
54
+ const answer = (attempted) => {
55
+ let next = 0;
56
+ return first.map((isFirst) => isFirst ? attempted[next++] ?? false : false);
57
+ };
58
+ if (payload.db.name === "mongoose") {
59
+ const model = payload.db.collections[slug];
60
+ if (!model) throw new Error(`analytics: mongoose collection "${slug}" not found`);
61
+ try {
62
+ await model.collection.insertMany(attempts.map((row) => ({ ...row })), { ordered: false });
63
+ return answer(attempts.map(() => true));
64
+ } catch (err) {
65
+ const duplicates = duplicateIndexes(err);
66
+ if (!duplicates) throw err;
67
+ return answer(attempts.map((_, index) => !duplicates.has(index)));
68
+ }
69
+ }
70
+ const db = payload.db;
71
+ const tableKey = slug.replace(/-/g, "_");
72
+ const tableName = db.tableNameMap.get(tableKey);
73
+ if (!tableName) throw new Error(`analytics: drizzle table "${tableKey}" not found`);
74
+ const table = db.tables[tableName];
75
+ if (!table) throw new Error(`analytics: drizzle table object for "${tableName}" not found`);
76
+ const inserted = await db.drizzle.insert(table).values(attempts).onConflictDoNothing().returning();
77
+ const created = /* @__PURE__ */ new Map();
78
+ for (const row of inserted) {
79
+ const key = rowKey(row, fields, dateFields);
80
+ created.set(key, (created.get(key) ?? 0) + 1);
81
+ }
82
+ return answer(attempts.map((row) => {
83
+ const key = rowKey(row, fields, dateFields);
84
+ const remaining = created.get(key) ?? 0;
85
+ if (remaining === 0) return false;
86
+ created.set(key, remaining - 1);
87
+ return true;
88
+ }));
89
+ }
90
+ //#endregion
91
+ export { insertManyIfNew };
92
+
93
+ //# sourceMappingURL=insertManyIfNew.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"insertManyIfNew.js","names":[],"sources":["../../../src/native/rollups/insertManyIfNew.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{ collection: { insertMany: (docs: 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[]) => {\n\t\t\t\tonConflictDoNothing: () => { returning: () => Promise<Array<Record<string, unknown>>> }\n\t\t\t}\n\t\t}\n\t}\n\ttables: Record<string, Record<string, unknown>>\n\ttableNameMap: Map<string, string>\n}\n\n/** Mongo duplicate key. */\nconst MONGO_DUPLICATE = 11000\n\ntype WriteError = { index?: unknown; code?: unknown }\n\n/**\n * Which rows of an unordered `insertMany` the index rejected, or undefined when the failure\n * was something else entirely (a dead connection, a validation error) and must be rethrown\n * rather than read as \"already seen\".\n */\nconst duplicateIndexes = (err: unknown): Set<number> | undefined => {\n\tif (typeof err !== 'object' || err === null) {\n\t\treturn undefined\n\t}\n\tconst raw = (err as { writeErrors?: unknown }).writeErrors\n\tconst errors: WriteError[] = Array.isArray(raw) ? raw : raw ? [raw as WriteError] : []\n\tif (errors.length === 0) {\n\t\t// A single-document rejection can arrive as a plain duplicate-key error with no\n\t\t// writeErrors array at all.\n\t\treturn (err as { code?: unknown }).code === MONGO_DUPLICATE ? new Set([0]) : undefined\n\t}\n\tconst indexes = new Set<number>()\n\tfor (const error of errors) {\n\t\tif (error.code !== MONGO_DUPLICATE || typeof error.index !== 'number') {\n\t\t\treturn undefined\n\t\t}\n\t\tindexes.add(error.index)\n\t}\n\treturn indexes\n}\n\n/**\n * Row identity for matching a returned row back to the row that asked for it. A date field is\n * normalized through Date because Postgres hands a timestamp back as its own text\n * (`2026-08-01 00:00:00+00`) rather than as the Date that was sent.\n */\nconst rowKey = (\n\trow: Record<string, unknown>,\n\tfields: string[],\n\tdateFields: ReadonlySet<string>\n): string =>\n\tJSON.stringify(\n\t\tfields.map((field) => {\n\t\t\tconst value = row[field]\n\t\t\tif (!dateFields.has(field)) {\n\t\t\t\treturn String(value)\n\t\t\t}\n\t\t\tconst time = new Date(value as string | Date).getTime()\n\t\t\treturn Number.isNaN(time) ? String(value) : time\n\t\t})\n\t)\n\n/**\n * `insertIfNew` for a whole batch: one statement, one answer per row in the order they were\n * given, true where that row was the one that created the ledger entry. The unique index is\n * still the entire correctness mechanism, so a row another writer inserted first comes back\n * false whether the driver reports it quietly or as a duplicate-key error.\n *\n * A row repeated inside one batch counts once, the first occurrence: Mongo would answer the\n * repeat with a duplicate-key error while Postgres skips it silently, so the batch is\n * de-duplicated here and both databases give the same answer.\n */\nexport async function insertManyIfNew(\n\tpayload: Payload,\n\tslug: string,\n\trows: Array<Record<string, unknown>>\n): Promise<boolean[]> {\n\tif (rows.length === 0) {\n\t\treturn []\n\t}\n\tconst fields = Object.keys(rows[0] as Record<string, unknown>)\n\tconst dateFields = new Set(fields.filter((f) => rows.some((row) => row[f] instanceof Date)))\n\tconst seenInBatch = new Set<string>()\n\tconst first: boolean[] = rows.map((row) => {\n\t\tconst key = rowKey(row, fields, dateFields)\n\t\tif (seenInBatch.has(key)) {\n\t\t\treturn false\n\t\t}\n\t\tseenInBatch.add(key)\n\t\treturn true\n\t})\n\tconst attempts = rows.filter((_, index) => first[index])\n\n\tconst answer = (attempted: boolean[]): boolean[] => {\n\t\tlet next = 0\n\t\treturn first.map((isFirst) => (isFirst ? (attempted[next++] ?? false) : false))\n\t}\n\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\ttry {\n\t\t\t// Copies, because insertMany stamps an _id onto every document it is handed.\n\t\t\tawait model.collection.insertMany(\n\t\t\t\tattempts.map((row) => ({ ...row })),\n\t\t\t\t{ ordered: false }\n\t\t\t)\n\t\t\treturn answer(attempts.map(() => true))\n\t\t} catch (err) {\n\t\t\tconst duplicates = duplicateIndexes(err)\n\t\t\tif (!duplicates) throw err\n\t\t\treturn answer(attempts.map((_, index) => !duplicates.has(index)))\n\t\t}\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(attempts).onConflictDoNothing().returning()\n\t// Returned rows say which inserts happened, not which row asked for them, so they are\n\t// matched back by value. A count rather than a flag, so identical rows stay one to one.\n\tconst created = new Map<string, number>()\n\tfor (const row of inserted) {\n\t\tconst key = rowKey(row, fields, dateFields)\n\t\tcreated.set(key, (created.get(key) ?? 0) + 1)\n\t}\n\treturn answer(\n\t\tattempts.map((row) => {\n\t\t\tconst key = rowKey(row, fields, dateFields)\n\t\t\tconst remaining = created.get(key) ?? 0\n\t\t\tif (remaining === 0) {\n\t\t\t\treturn false\n\t\t\t}\n\t\t\tcreated.set(key, remaining - 1)\n\t\t\treturn true\n\t\t})\n\t)\n}\n"],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ import { AnalyticsAdapter } from "../core/contract.js";
2
+
3
+ //#region src/next/captureRewrites.d.ts
4
+ /** One Next.js rewrite entry (the shape `next.config` `rewrites()` returns). */
5
+ interface CaptureRewrite {
6
+ source: string;
7
+ destination: string;
8
+ }
9
+ /** An adapter's capture proxy mounted at a base path in the consumer's Next app. */
10
+ interface CaptureRewriteMount {
11
+ /** Base path this adapter's proxy is mounted at, e.g. '/ph' or '/api/analytics/p/global'. */
12
+ path: string;
13
+ adapter: AnalyticsAdapter;
14
+ }
15
+ /**
16
+ * Next.js `rewrites()` entries for every adapter's capture proxy, one mount at a time.
17
+ * Each route's `source`/`upstream` already share `path-to-regexp` param names (e.g.
18
+ * `:p*`), so no translation happens beyond prefixing `source` with the mount's
19
+ * (normalized) path; `upstream` is used verbatim as `destination`. Next always strips a
20
+ * trailing slash from the matched path before substituting it into `destination` (unlike
21
+ * the runtime proxy, which can be told to keep one via `trailingSlashes`); harmless for
22
+ * every vendor this helper supports today.
23
+ *
24
+ * An adapter without `capture`, or with no proxy routes (the native adapter, and GA4 whose
25
+ * tag is served from Google's own CDN), contributes nothing rather than throwing, so one
26
+ * broken slot never blanks the rest.
27
+ * Output preserves mount order, then each mount's declared route order.
28
+ *
29
+ * Throws for a mount path that normalizes to the site root (an unprefixed catch-all
30
+ * route would swallow the whole app) or for two mounts whose normalized paths are equal
31
+ * or nested (Next matches rewrites first-match-wins, so an earlier catch-all would
32
+ * silently shadow a later mount's routes). Distinct sibling paths that merely share a
33
+ * string prefix, e.g. `/ph` and `/phx`, are unaffected.
34
+ *
35
+ * When any mounted adapter's descriptor sets `capture.proxy.trailingSlashes`, add
36
+ * `skipTrailingSlashRedirect: true` to `next.config` (see `posthogProxyRewrites`'s
37
+ * JSDoc for why PostHog needs it).
38
+ */
39
+ declare const captureRewrites: (mounts: CaptureRewriteMount[]) => CaptureRewrite[];
40
+ //#endregion
41
+ export { CaptureRewrite, CaptureRewriteMount, captureRewrites };
42
+ //# sourceMappingURL=captureRewrites.d.ts.map