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

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 (514) hide show
  1. package/CHANGELOG.md +277 -0
  2. package/README.md +15 -4
  3. package/dist/adapters/ga4/disableKey.d.ts +9 -0
  4. package/dist/adapters/ga4/disableKey.js +21 -0
  5. package/dist/adapters/ga4/disableKey.js.map +1 -0
  6. package/dist/adapters/ga4/eventName.d.ts +15 -0
  7. package/dist/adapters/ga4/eventName.js +19 -0
  8. package/dist/adapters/ga4/eventName.js.map +1 -0
  9. package/dist/adapters/ga4/ga4.d.ts +5 -0
  10. package/dist/adapters/ga4/ga4.js +186 -58
  11. package/dist/adapters/ga4/ga4.js.map +1 -1
  12. package/dist/adapters/ga4/measurementId.js +15 -0
  13. package/dist/adapters/ga4/measurementId.js.map +1 -0
  14. package/dist/adapters/goalRead.js +126 -0
  15. package/dist/adapters/goalRead.js.map +1 -0
  16. package/dist/adapters/http/fetchJson.js +1 -1
  17. package/dist/adapters/plausible/plausible.d.ts +25 -0
  18. package/dist/adapters/plausible/plausible.js +159 -38
  19. package/dist/adapters/plausible/plausible.js.map +1 -1
  20. package/dist/adapters/posthog/posthog.d.ts +10 -1
  21. package/dist/adapters/posthog/posthog.js +130 -21
  22. package/dist/adapters/posthog/posthog.js.map +1 -1
  23. package/dist/adapters/series.js +11 -1
  24. package/dist/adapters/series.js.map +1 -1
  25. package/dist/adapters/umami/umami.d.ts +13 -1
  26. package/dist/adapters/umami/umami.js +278 -26
  27. package/dist/adapters/umami/umami.js.map +1 -1
  28. package/dist/binding/resolvePath.js +18 -2
  29. package/dist/binding/resolvePath.js.map +1 -1
  30. package/dist/capture/getTrackerConfig.d.ts +20 -0
  31. package/dist/capture/getTrackerConfig.js +31 -0
  32. package/dist/capture/getTrackerConfig.js.map +1 -0
  33. package/dist/capture/mountPath.js +14 -0
  34. package/dist/capture/mountPath.js.map +1 -0
  35. package/dist/capture/proxyEndpoint.js +127 -0
  36. package/dist/capture/proxyEndpoint.js.map +1 -0
  37. package/dist/capture/proxyRoutes.js +108 -0
  38. package/dist/capture/proxyRoutes.js.map +1 -0
  39. package/dist/capture/requestBody.js +68 -0
  40. package/dist/capture/requestBody.js.map +1 -0
  41. package/dist/capture/slots.d.ts +8 -0
  42. package/dist/capture/slots.js +54 -0
  43. package/dist/capture/slots.js.map +1 -0
  44. package/dist/capture/trackerConfig.d.ts +33 -0
  45. package/dist/capture/trackerConfig.js +95 -0
  46. package/dist/capture/trackerConfig.js.map +1 -0
  47. package/dist/capture/trackerEndpoint.js +35 -0
  48. package/dist/capture/trackerEndpoint.js.map +1 -0
  49. package/dist/charts/BarList.d.ts +16 -1
  50. package/dist/charts/BarList.js +41 -19
  51. package/dist/charts/BarList.js.map +1 -1
  52. package/dist/charts/TrendChart.d.ts +16 -3
  53. package/dist/charts/TrendChart.js +172 -106
  54. package/dist/charts/TrendChart.js.map +1 -1
  55. package/dist/charts/bars.d.ts +4 -0
  56. package/dist/charts/bars.js +3 -1
  57. package/dist/charts/bars.js.map +1 -1
  58. package/dist/charts/bucket.js +10 -1
  59. package/dist/charts/bucket.js.map +1 -1
  60. package/dist/charts/spline.js +2 -2
  61. package/dist/charts/spline.js.map +1 -1
  62. package/dist/charts/styles.js +18 -1
  63. package/dist/charts/styles.js.map +1 -1
  64. package/dist/core/cacheKey.js +26 -3
  65. package/dist/core/cacheKey.js.map +1 -1
  66. package/dist/core/capabilities.d.ts +5 -1
  67. package/dist/core/capabilities.js +11 -2
  68. package/dist/core/capabilities.js.map +1 -1
  69. package/dist/core/capture.d.ts +49 -0
  70. package/dist/core/contract.d.ts +74 -5
  71. package/dist/core/contract.js +30 -1
  72. package/dist/core/contract.js.map +1 -1
  73. package/dist/core/granularity.js +1 -1
  74. package/dist/core/options.d.ts +164 -6
  75. package/dist/core/options.js +126 -3
  76. package/dist/core/options.js.map +1 -1
  77. package/dist/core/registry.d.ts +1 -0
  78. package/dist/core/scopeList.js +32 -0
  79. package/dist/core/scopeList.js.map +1 -0
  80. package/dist/core/scopedRead.js +101 -30
  81. package/dist/core/scopedRead.js.map +1 -1
  82. package/dist/core/serverEvent.d.ts +60 -0
  83. package/dist/core/serverEvent.js +12 -0
  84. package/dist/core/serverEvent.js.map +1 -0
  85. package/dist/exports/adapters/ga4.d.ts +2 -1
  86. package/dist/exports/adapters/ga4.js +2 -1
  87. package/dist/exports/adapters/native.d.ts +3 -1
  88. package/dist/exports/adapters/native.js +2 -1
  89. package/dist/exports/client.d.ts +13 -3
  90. package/dist/exports/client.js +10 -1
  91. package/dist/exports/geo.d.ts +2 -2
  92. package/dist/exports/next.d.ts +2 -1
  93. package/dist/exports/next.js +2 -1
  94. package/dist/exports/react.d.ts +4 -0
  95. package/dist/exports/react.js +5 -0
  96. package/dist/exports/rsc.d.ts +11 -3
  97. package/dist/exports/rsc.js +7 -2
  98. package/dist/exports/tracker.d.ts +21 -0
  99. package/dist/exports/tracker.js +15 -0
  100. package/dist/exports/types.d.ts +16 -3
  101. package/dist/exports/types.js +4 -2
  102. package/dist/fields/AnalyticsPanelClient.js +2 -2
  103. package/dist/fields/AnalyticsPanelField.js +1 -1
  104. package/dist/fields/AnalyticsStatField.js +2 -2
  105. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  106. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  107. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  108. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  109. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  110. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  111. package/dist/fields/config/MetricSelectField.js +3 -3
  112. package/dist/fields/config/MetricSelectField.js.map +1 -1
  113. package/dist/fields/config/SourceSelectField.js +3 -3
  114. package/dist/fields/config/SourceSelectField.js.map +1 -1
  115. package/dist/fields/config/fetchSources.d.ts +5 -1
  116. package/dist/fields/config/fetchSources.js +7 -3
  117. package/dist/fields/config/fetchSources.js.map +1 -1
  118. package/dist/fields/config/narrow.js +2 -0
  119. package/dist/fields/config/narrow.js.map +1 -1
  120. package/dist/fields/config/sourcesState.js +19 -3
  121. package/dist/fields/config/sourcesState.js.map +1 -1
  122. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  123. package/dist/fields/config/useAnalyticsSources.js +9 -6
  124. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  125. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  126. package/dist/fields/config/useFilterCapabilities.js +52 -0
  127. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  128. package/dist/fields/readForDocument.d.ts +5 -0
  129. package/dist/fields/readForDocument.js +22 -10
  130. package/dist/fields/readForDocument.js.map +1 -1
  131. package/dist/goals/GoalSelectField.d.ts +7 -0
  132. package/dist/goals/GoalSelectField.js +77 -0
  133. package/dist/goals/GoalSelectField.js.map +1 -0
  134. package/dist/goals/collection.js +254 -0
  135. package/dist/goals/collection.js.map +1 -0
  136. package/dist/goals/currency.js +14 -0
  137. package/dist/goals/currency.js.map +1 -0
  138. package/dist/goals/fetchGoals.d.ts +18 -0
  139. package/dist/goals/fetchGoals.js +33 -0
  140. package/dist/goals/fetchGoals.js.map +1 -0
  141. package/dist/goals/goalField.d.ts +31 -0
  142. package/dist/goals/goalField.js +56 -0
  143. package/dist/goals/goalField.js.map +1 -0
  144. package/dist/goals/goalsEndpoint.d.ts +1 -0
  145. package/dist/goals/goalsEndpoint.js +58 -0
  146. package/dist/goals/goalsEndpoint.js.map +1 -0
  147. package/dist/goals/match.js +64 -0
  148. package/dist/goals/match.js.map +1 -0
  149. package/dist/goals/resolver.d.ts +8 -0
  150. package/dist/goals/resolver.js +147 -0
  151. package/dist/goals/resolver.js.map +1 -0
  152. package/dist/goals/trackGoalAction.d.ts +76 -0
  153. package/dist/goals/trackGoalAction.js +158 -0
  154. package/dist/goals/trackGoalAction.js.map +1 -0
  155. package/dist/goals/types.d.ts +33 -0
  156. package/dist/goals/types.js +7 -0
  157. package/dist/goals/types.js.map +1 -0
  158. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  159. package/dist/goals/useAnalyticsGoals.js +67 -0
  160. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  161. package/dist/index.d.ts +14 -3
  162. package/dist/index.js +174 -19
  163. package/dist/index.js.map +1 -1
  164. package/dist/native/collections/events.js +65 -1
  165. package/dist/native/collections/events.js.map +1 -1
  166. package/dist/native/collections/rollups.js +39 -3
  167. package/dist/native/collections/rollups.js.map +1 -1
  168. package/dist/native/eventScan.js +25 -0
  169. package/dist/native/eventScan.js.map +1 -0
  170. package/dist/native/geo/composeGeoResolvers.js +2 -2
  171. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  172. package/dist/native/geo/geoResolver.d.ts +9 -2
  173. package/dist/native/geo/geoResolver.js.map +1 -1
  174. package/dist/native/geo/maxmindResolver.js +3 -5
  175. package/dist/native/geo/maxmindResolver.js.map +1 -1
  176. package/dist/native/ingest/bots.d.ts +11 -0
  177. package/dist/native/ingest/bots.js +71 -0
  178. package/dist/native/ingest/bots.js.map +1 -0
  179. package/dist/native/ingest/browser.js +47 -0
  180. package/dist/native/ingest/browser.js.map +1 -0
  181. package/dist/native/ingest/clientIp.js +20 -0
  182. package/dist/native/ingest/clientIp.js.map +1 -0
  183. package/dist/native/ingest/device.js +11 -3
  184. package/dist/native/ingest/device.js.map +1 -1
  185. package/dist/native/ingest/endpoint.d.ts +1 -0
  186. package/dist/native/ingest/endpoint.js +107 -21
  187. package/dist/native/ingest/endpoint.js.map +1 -1
  188. package/dist/native/ingest/flushBatch.js +29 -38
  189. package/dist/native/ingest/flushBatch.js.map +1 -1
  190. package/dist/native/ingest/language.js +14 -0
  191. package/dist/native/ingest/language.js.map +1 -0
  192. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  193. package/dist/native/ingest/normalizeEvent.js +115 -16
  194. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  195. package/dist/native/ingest/referrer.js +48 -0
  196. package/dist/native/ingest/referrer.js.map +1 -0
  197. package/dist/native/ingest/requestHost.js +57 -0
  198. package/dist/native/ingest/requestHost.js.map +1 -0
  199. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  200. package/dist/native/ingest/resolveHostname.js +52 -0
  201. package/dist/native/ingest/resolveHostname.js.map +1 -0
  202. package/dist/native/ingest/salt.js +27 -2
  203. package/dist/native/ingest/salt.js.map +1 -1
  204. package/dist/native/ingest/serverTrack.d.ts +20 -0
  205. package/dist/native/ingest/serverTrack.js +109 -0
  206. package/dist/native/ingest/serverTrack.js.map +1 -0
  207. package/dist/native/ingest/source.d.ts +11 -0
  208. package/dist/native/ingest/source.js +264 -16
  209. package/dist/native/ingest/source.js.map +1 -1
  210. package/dist/native/ingest/utm.js +33 -0
  211. package/dist/native/ingest/utm.js.map +1 -0
  212. package/dist/native/ingest/validate.js +26 -0
  213. package/dist/native/ingest/validate.js.map +1 -0
  214. package/dist/native/nativeAdapter.d.ts +37 -1
  215. package/dist/native/nativeAdapter.js +175 -22
  216. package/dist/native/nativeAdapter.js.map +1 -1
  217. package/dist/native/query/eventAgg.js +175 -0
  218. package/dist/native/query/eventAgg.js.map +1 -0
  219. package/dist/native/retention/pruneTask.js +53 -13
  220. package/dist/native/retention/pruneTask.js.map +1 -1
  221. package/dist/native/rollupAcc.js +12 -1
  222. package/dist/native/rollupAcc.js.map +1 -1
  223. package/dist/native/rollups/bucketKey.js +15 -0
  224. package/dist/native/rollups/bucketKey.js.map +1 -0
  225. package/dist/native/rollups/bumpRollups.js +116 -0
  226. package/dist/native/rollups/bumpRollups.js.map +1 -0
  227. package/dist/native/rollups/deltas.js +86 -11
  228. package/dist/native/rollups/deltas.js.map +1 -1
  229. package/dist/native/rollups/insertManyIfNew.js +93 -0
  230. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  231. package/dist/next/captureRewrites.d.ts +42 -0
  232. package/dist/next/captureRewrites.js +57 -0
  233. package/dist/next/captureRewrites.js.map +1 -0
  234. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  235. package/dist/next/posthogProxyRewrites.js +16 -21
  236. package/dist/next/posthogProxyRewrites.js.map +1 -1
  237. package/dist/plugin/documentEndpoint.js +71 -24
  238. package/dist/plugin/documentEndpoint.js.map +1 -1
  239. package/dist/plugin/errors.d.ts +31 -0
  240. package/dist/plugin/errors.js +79 -0
  241. package/dist/plugin/errors.js.map +1 -0
  242. package/dist/plugin/goalHint.d.ts +1 -0
  243. package/dist/plugin/goalHint.js +24 -0
  244. package/dist/plugin/goalHint.js.map +1 -0
  245. package/dist/plugin/paths.js +17 -1
  246. package/dist/plugin/paths.js.map +1 -1
  247. package/dist/plugin/queryEndpoint.js +124 -0
  248. package/dist/plugin/queryEndpoint.js.map +1 -0
  249. package/dist/plugin/readContextForRequest.js +73 -0
  250. package/dist/plugin/readContextForRequest.js.map +1 -0
  251. package/dist/plugin/realtimeEndpoint.js +37 -16
  252. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  253. package/dist/plugin/refreshEndpoint.js +113 -0
  254. package/dist/plugin/refreshEndpoint.js.map +1 -0
  255. package/dist/plugin/runtime.d.ts +1 -0
  256. package/dist/plugin/runtime.js +33 -1
  257. package/dist/plugin/runtime.js.map +1 -1
  258. package/dist/plugin/scopeChange.js +22 -0
  259. package/dist/plugin/scopeChange.js.map +1 -0
  260. package/dist/plugin/scopeFieldBoot.js +22 -0
  261. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  262. package/dist/plugin/sourcesEndpoint.js +16 -41
  263. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  264. package/dist/plugin/warmTask.js +0 -0
  265. package/dist/plugin/warmTask.js.map +1 -1
  266. package/dist/providers/collection.js +89 -29
  267. package/dist/providers/collection.js.map +1 -1
  268. package/dist/providers/factory.js +11 -3
  269. package/dist/providers/factory.js.map +1 -1
  270. package/dist/providers/resolver.js.map +1 -1
  271. package/dist/query/dates.js +64 -0
  272. package/dist/query/dates.js.map +1 -0
  273. package/dist/query/errors.d.ts +14 -0
  274. package/dist/query/fetchQuery.d.ts +79 -0
  275. package/dist/query/fetchQuery.js +117 -0
  276. package/dist/query/fetchQuery.js.map +1 -0
  277. package/dist/query/parse.d.ts +22 -0
  278. package/dist/query/parse.js +168 -0
  279. package/dist/query/parse.js.map +1 -0
  280. package/dist/query/response.d.ts +39 -0
  281. package/dist/query/response.js +11 -0
  282. package/dist/query/response.js.map +1 -0
  283. package/dist/react/AnalyticsProvider.d.ts +50 -0
  284. package/dist/react/AnalyticsProvider.js +67 -0
  285. package/dist/react/AnalyticsProvider.js.map +1 -0
  286. package/dist/react/TrackerBoot.d.ts +22 -0
  287. package/dist/react/TrackerBoot.js +30 -0
  288. package/dist/react/TrackerBoot.js.map +1 -0
  289. package/dist/react/useAnalytics.d.ts +20 -0
  290. package/dist/react/useAnalytics.js +52 -0
  291. package/dist/react/useAnalytics.js.map +1 -0
  292. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  293. package/dist/rsc/AnalyticsScripts.js +41 -0
  294. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  295. package/dist/surfacing/cacheStore.d.ts +1 -0
  296. package/dist/surfacing/cacheStore.js +18 -2
  297. package/dist/surfacing/cacheStore.js.map +1 -1
  298. package/dist/surfacing/engine.d.ts +1 -0
  299. package/dist/surfacing/engine.js +47 -6
  300. package/dist/surfacing/engine.js.map +1 -1
  301. package/dist/surfacing/epoch.d.ts +1 -0
  302. package/dist/surfacing/epoch.js +72 -0
  303. package/dist/surfacing/epoch.js.map +1 -0
  304. package/dist/surfacing/queue.js +22 -6
  305. package/dist/surfacing/queue.js.map +1 -1
  306. package/dist/surfacing/rateLimiter.js +130 -0
  307. package/dist/surfacing/rateLimiter.js.map +1 -0
  308. package/dist/surfacing/retryPolicy.js +15 -0
  309. package/dist/surfacing/retryPolicy.js.map +1 -0
  310. package/dist/sync/collection.js +23 -7
  311. package/dist/sync/collection.js.map +1 -1
  312. package/dist/sync/syncTask.js +68 -33
  313. package/dist/sync/syncTask.js.map +1 -1
  314. package/dist/testing/memoryAdapter.d.ts +2 -0
  315. package/dist/testing/memoryAdapter.js +17 -1
  316. package/dist/testing/memoryAdapter.js.map +1 -1
  317. package/dist/timeframe/tz.js +17 -6
  318. package/dist/timeframe/tz.js.map +1 -1
  319. package/dist/tracker/autoCapture.d.ts +48 -0
  320. package/dist/tracker/autoCapture.js +129 -0
  321. package/dist/tracker/autoCapture.js.map +1 -0
  322. package/dist/tracker/consent.d.ts +24 -0
  323. package/dist/tracker/consent.js +48 -0
  324. package/dist/tracker/consent.js.map +1 -0
  325. package/dist/tracker/createTracker.d.ts +18 -0
  326. package/dist/tracker/createTracker.js +215 -0
  327. package/dist/tracker/createTracker.js.map +1 -0
  328. package/dist/tracker/exclusion.d.ts +28 -0
  329. package/dist/tracker/exclusion.js +50 -0
  330. package/dist/tracker/exclusion.js.map +1 -0
  331. package/dist/tracker/initTracker.d.ts +22 -0
  332. package/dist/tracker/initTracker.js +33 -0
  333. package/dist/tracker/initTracker.js.map +1 -0
  334. package/dist/tracker/loadScript.d.ts +14 -0
  335. package/dist/tracker/loadScript.js +41 -0
  336. package/dist/tracker/loadScript.js.map +1 -0
  337. package/dist/tracker/pageTracking.d.ts +17 -0
  338. package/dist/tracker/pageTracking.js +38 -0
  339. package/dist/tracker/pageTracking.js.map +1 -0
  340. package/dist/tracker/registry.d.ts +27 -0
  341. package/dist/tracker/registry.js +73 -0
  342. package/dist/tracker/registry.js.map +1 -0
  343. package/dist/tracker/sinks/ga4.d.ts +29 -0
  344. package/dist/tracker/sinks/ga4.js +30 -0
  345. package/dist/tracker/sinks/ga4.js.map +1 -0
  346. package/dist/tracker/sinks/native.d.ts +22 -0
  347. package/dist/tracker/sinks/native.js +56 -0
  348. package/dist/tracker/sinks/native.js.map +1 -0
  349. package/dist/tracker/sinks/plausible.d.ts +20 -0
  350. package/dist/tracker/sinks/plausible.js +32 -0
  351. package/dist/tracker/sinks/plausible.js.map +1 -0
  352. package/dist/tracker/sinks/posthog.d.ts +18 -0
  353. package/dist/tracker/sinks/posthog.js +30 -0
  354. package/dist/tracker/sinks/posthog.js.map +1 -0
  355. package/dist/tracker/sinks/umami.d.ts +18 -0
  356. package/dist/tracker/sinks/umami.js +23 -0
  357. package/dist/tracker/sinks/umami.js.map +1 -0
  358. package/dist/tracker/sinks/vendor.d.ts +14 -0
  359. package/dist/tracker/sinks/vendor.js +81 -0
  360. package/dist/tracker/sinks/vendor.js.map +1 -0
  361. package/dist/tracker/transport.js +28 -0
  362. package/dist/tracker/transport.js.map +1 -0
  363. package/dist/tracker/types.d.ts +91 -0
  364. package/dist/translations/ar.js +221 -0
  365. package/dist/translations/ar.js.map +1 -0
  366. package/dist/translations/de.js +145 -1
  367. package/dist/translations/de.js.map +1 -1
  368. package/dist/translations/en.js +145 -1
  369. package/dist/translations/en.js.map +1 -1
  370. package/dist/translations/es.js +221 -0
  371. package/dist/translations/es.js.map +1 -0
  372. package/dist/translations/fr.js +221 -0
  373. package/dist/translations/fr.js.map +1 -0
  374. package/dist/translations/id.js +221 -0
  375. package/dist/translations/id.js.map +1 -0
  376. package/dist/translations/index.d.ts +10 -1
  377. package/dist/translations/index.js +19 -1
  378. package/dist/translations/index.js.map +1 -1
  379. package/dist/translations/keys.d.ts +144 -0
  380. package/dist/translations/keys.js +145 -1
  381. package/dist/translations/keys.js.map +1 -1
  382. package/dist/translations/ko.js +221 -0
  383. package/dist/translations/ko.js.map +1 -0
  384. package/dist/translations/metricKeys.js +8 -2
  385. package/dist/translations/metricKeys.js.map +1 -1
  386. package/dist/translations/pt.js +221 -0
  387. package/dist/translations/pt.js.map +1 -0
  388. package/dist/translations/ru.js +221 -0
  389. package/dist/translations/ru.js.map +1 -0
  390. package/dist/translations/server.js.map +1 -1
  391. package/dist/translations/uk.js +221 -0
  392. package/dist/translations/uk.js.map +1 -0
  393. package/dist/translations/zh.js +221 -0
  394. package/dist/translations/zh.js.map +1 -0
  395. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  396. package/dist/view/AnalyticsNavLink.js +40 -0
  397. package/dist/view/AnalyticsNavLink.js.map +1 -0
  398. package/dist/view/AnalyticsView.d.ts +23 -0
  399. package/dist/view/AnalyticsView.js +45 -0
  400. package/dist/view/AnalyticsView.js.map +1 -0
  401. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  402. package/dist/view/AnalyticsViewClient.js +244 -0
  403. package/dist/view/AnalyticsViewClient.js.map +1 -0
  404. package/dist/view/authRedirect.js +32 -0
  405. package/dist/view/authRedirect.js.map +1 -0
  406. package/dist/view/conversionRate.js +18 -0
  407. package/dist/view/conversionRate.js.map +1 -0
  408. package/dist/view/dayRange.js +68 -0
  409. package/dist/view/dayRange.js.map +1 -0
  410. package/dist/view/gating.d.ts +1 -0
  411. package/dist/view/gating.js +142 -0
  412. package/dist/view/gating.js.map +1 -0
  413. package/dist/view/labels.js +76 -0
  414. package/dist/view/labels.js.map +1 -0
  415. package/dist/view/registerView.js +48 -0
  416. package/dist/view/registerView.js.map +1 -0
  417. package/dist/view/sections/Breakdowns.js +198 -0
  418. package/dist/view/sections/Breakdowns.js.map +1 -0
  419. package/dist/view/sections/EmptyStates.js +92 -0
  420. package/dist/view/sections/EmptyStates.js.map +1 -0
  421. package/dist/view/sections/FilterChips.js +46 -0
  422. package/dist/view/sections/FilterChips.js.map +1 -0
  423. package/dist/view/sections/GoalsPanel.js +82 -0
  424. package/dist/view/sections/GoalsPanel.js.map +1 -0
  425. package/dist/view/sections/OverviewCards.js +65 -0
  426. package/dist/view/sections/OverviewCards.js.map +1 -0
  427. package/dist/view/sections/RealtimeStrip.js +80 -0
  428. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  429. package/dist/view/sections/Toolbar.js +207 -0
  430. package/dist/view/sections/Toolbar.js.map +1 -0
  431. package/dist/view/sections/Trend.js +125 -0
  432. package/dist/view/sections/Trend.js.map +1 -0
  433. package/dist/view/sections/styles.js +76 -0
  434. package/dist/view/sections/styles.js.map +1 -0
  435. package/dist/view/state.js +211 -0
  436. package/dist/view/state.js.map +1 -0
  437. package/dist/view/useViewQueries.js +153 -0
  438. package/dist/view/useViewQueries.js.map +1 -0
  439. package/dist/view/viewProps.d.ts +40 -0
  440. package/dist/view/viewProps.js +90 -0
  441. package/dist/view/viewProps.js.map +1 -0
  442. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  443. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  444. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  445. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  446. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  447. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  448. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  449. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  450. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  451. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  452. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  453. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  454. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  455. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  456. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  457. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  458. package/dist/widgets/RealtimeCounter.js +18 -4
  459. package/dist/widgets/RealtimeCounter.js.map +1 -1
  460. package/dist/widgets/WidgetViewLink.js +17 -0
  461. package/dist/widgets/WidgetViewLink.js.map +1 -0
  462. package/dist/widgets/breakdownTypes.js +38 -0
  463. package/dist/widgets/breakdownTypes.js.map +1 -1
  464. package/dist/widgets/cardChrome.js +31 -7
  465. package/dist/widgets/cardChrome.js.map +1 -1
  466. package/dist/widgets/comparison.js +15 -1
  467. package/dist/widgets/comparison.js.map +1 -1
  468. package/dist/widgets/defaults.d.ts +6 -2
  469. package/dist/widgets/defaults.js +78 -23
  470. package/dist/widgets/defaults.js.map +1 -1
  471. package/dist/widgets/filterCaption.js +27 -0
  472. package/dist/widgets/filterCaption.js.map +1 -0
  473. package/dist/widgets/filterField.d.ts +19 -0
  474. package/dist/widgets/filterField.js +75 -0
  475. package/dist/widgets/filterField.js.map +1 -0
  476. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  477. package/dist/widgets/prepareWidgetRead.js +74 -0
  478. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  479. package/dist/widgets/range.js +43 -12
  480. package/dist/widgets/range.js.map +1 -1
  481. package/dist/widgets/readForWidget.d.ts +26 -3
  482. package/dist/widgets/readForWidget.js +48 -44
  483. package/dist/widgets/readForWidget.js.map +1 -1
  484. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  485. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  486. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  487. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  488. package/dist/widgets/readForWidgetGoals.js +140 -0
  489. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  490. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  491. package/dist/widgets/readForWidgetRealtime.js +23 -21
  492. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  493. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  494. package/dist/widgets/readForWidgetSeries.js +78 -53
  495. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  496. package/dist/widgets/readMeta.js +18 -0
  497. package/dist/widgets/readMeta.js.map +1 -0
  498. package/dist/widgets/realtimePoll.js +13 -1
  499. package/dist/widgets/realtimePoll.js.map +1 -1
  500. package/dist/widgets/registerWidgets.js +62 -10
  501. package/dist/widgets/registerWidgets.js.map +1 -1
  502. package/dist/widgets/types.d.ts +15 -0
  503. package/dist/widgets/types.js +16 -2
  504. package/dist/widgets/types.js.map +1 -1
  505. package/dist/widgets/viewLink.d.ts +22 -0
  506. package/dist/widgets/viewLink.js +86 -0
  507. package/dist/widgets/viewLink.js.map +1 -0
  508. package/package.json +27 -7
  509. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  510. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  511. package/dist/native/rollups/bumpRollup.js +0 -68
  512. package/dist/native/rollups/bumpRollup.js.map +0 -1
  513. package/dist/native/rollups/insertIfNew.js +0 -19
  514. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -25,7 +25,11 @@ const eventsCollection = (scoped = false) => ({
25
25
  name: "type",
26
26
  type: "select",
27
27
  required: true,
28
- options: ["pageview", "event"],
28
+ options: [
29
+ "pageview",
30
+ "event",
31
+ "goal"
32
+ ],
29
33
  index: true
30
34
  },
31
35
  {
@@ -47,14 +51,54 @@ const eventsCollection = (scoped = false) => ({
47
51
  name: "referrer",
48
52
  type: "text"
49
53
  },
54
+ {
55
+ name: "referrerHost",
56
+ type: "text"
57
+ },
50
58
  {
51
59
  name: "device",
52
60
  type: "text"
53
61
  },
62
+ {
63
+ name: "browser",
64
+ type: "text"
65
+ },
66
+ {
67
+ name: "os",
68
+ type: "text"
69
+ },
54
70
  {
55
71
  name: "source",
56
72
  type: "text"
57
73
  },
74
+ {
75
+ name: "channel",
76
+ type: "text"
77
+ },
78
+ {
79
+ name: "channelVersion",
80
+ type: "number"
81
+ },
82
+ {
83
+ name: "utmSource",
84
+ type: "text"
85
+ },
86
+ {
87
+ name: "utmMedium",
88
+ type: "text"
89
+ },
90
+ {
91
+ name: "utmCampaign",
92
+ type: "text"
93
+ },
94
+ {
95
+ name: "utmContent",
96
+ type: "text"
97
+ },
98
+ {
99
+ name: "utmTerm",
100
+ type: "text"
101
+ },
58
102
  {
59
103
  name: "country",
60
104
  type: "text"
@@ -67,6 +111,10 @@ const eventsCollection = (scoped = false) => ({
67
111
  name: "city",
68
112
  type: "text"
69
113
  },
114
+ {
115
+ name: "language",
116
+ type: "text"
117
+ },
70
118
  {
71
119
  name: "visitorHash",
72
120
  type: "text",
@@ -87,6 +135,22 @@ const eventsCollection = (scoped = false) => ({
87
135
  name: "props",
88
136
  type: "json"
89
137
  },
138
+ {
139
+ name: "value",
140
+ type: "number"
141
+ },
142
+ {
143
+ name: "currency",
144
+ type: "text"
145
+ },
146
+ {
147
+ name: "scrollDepth",
148
+ type: "number"
149
+ },
150
+ {
151
+ name: "goals",
152
+ type: "json"
153
+ },
90
154
  ...scoped ? [{
91
155
  name: "scope",
92
156
  type: "text",
@@ -1 +1 @@
1
- {"version":3,"file":"events.js","names":[],"sources":["../../../src/native/collections/events.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const EVENTS_SLUG = 'analytics-events'\n\n/**\n * The scope column exists only for scoped installs (a configured scopeResolver);\n * enabling scope on an existing native install therefore needs a migration adding\n * the column to events and rollups.\n */\nexport const eventsCollection = (scoped = false): CollectionConfig => ({\n\tslug: EVENTS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => false, delete: () => false },\n\tfields: [\n\t\t{ name: 'timestamp', type: 'date', required: true, index: true },\n\t\t{ name: 'type', type: 'select', required: true, options: ['pageview', 'event'], index: true },\n\t\t{ name: 'name', type: 'text' },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'hostname', type: 'text', required: true },\n\t\t{ name: 'referrer', type: 'text' },\n\t\t{ name: 'device', type: 'text' },\n\t\t{ name: 'source', type: 'text' },\n\t\t{ name: 'country', type: 'text' },\n\t\t{ name: 'region', type: 'text' },\n\t\t{ name: 'city', type: 'text' },\n\t\t{ name: 'visitorHash', type: 'text', required: true, index: true },\n\t\t{ name: 'sessionId', type: 'text', required: true, index: true },\n\t\t{ name: 'durationMs', type: 'number' },\n\t\t{ name: 'props', type: 'json' },\n\t\t...(scoped ? [{ name: 'scope', type: 'text', index: true } satisfies Field] : []),\n\t],\n\tindexes: [{ fields: ['path', 'timestamp'] }, { fields: ['type', 'timestamp'] }],\n})\n"],"mappings":";AAEA,MAAa,cAAc;;;;;;AAO3B,MAAa,oBAAoB,SAAS,WAA6B;CACtE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAO,cAAc;CAAM;CAC1F,QAAQ;EACP;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GAAE,MAAM;GAAQ,MAAM;GAAU,UAAU;GAAM,SAAS,CAAC,YAAY,OAAO;GAAG,OAAO;EAAK;EAC5F;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;EAAK;EACjD;GAAE,MAAM;GAAY,MAAM;EAAO;EACjC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAW,MAAM;EAAO;EAChC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EACjE;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GAAE,MAAM;GAAc,MAAM;EAAS;EACrC;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B,GAAI,SAAS,CAAC;GAAE,MAAM;GAAS,MAAM;GAAQ,OAAO;EAAK,CAAiB,IAAI,CAAC;CAChF;CACA,SAAS,CAAC,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,CAAC;AAC/E"}
1
+ {"version":3,"file":"events.js","names":[],"sources":["../../../src/native/collections/events.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const EVENTS_SLUG = 'analytics-events'\n\n/**\n * The scope column exists only for scoped installs (a configured scopeResolver);\n * enabling scope on an existing native install therefore needs a migration adding\n * the column to events and rollups.\n */\nexport const eventsCollection = (scoped = false): CollectionConfig => ({\n\tslug: EVENTS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => false, delete: () => false },\n\tfields: [\n\t\t{ name: 'timestamp', type: 'date', required: true, index: true },\n\t\t{\n\t\t\tname: 'type',\n\t\t\ttype: 'select',\n\t\t\trequired: true,\n\t\t\toptions: ['pageview', 'event', 'goal'],\n\t\t\tindex: true,\n\t\t},\n\t\t{ name: 'name', type: 'text' },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'hostname', type: 'text', required: true },\n\t\t{ name: 'referrer', type: 'text' },\n\t\t// Derived from the referrer at ingest: the `referrer` dimension groups and filters on the\n\t\t// bare host, which a read-time `where` could not compute.\n\t\t{ name: 'referrerHost', type: 'text' },\n\t\t{ name: 'device', type: 'text' },\n\t\t{ name: 'browser', type: 'text' },\n\t\t{ name: 'os', type: 'text' },\n\t\t{ name: 'source', type: 'text' },\n\t\t{ name: 'channel', type: 'text' },\n\t\t// The taxonomy the channel beside it was decided under, so a later reclassify can find\n\t\t// the rows an older rule set wrote.\n\t\t{ name: 'channelVersion', type: 'number' },\n\t\t// Extracted from the pageview's query string at ingest; the raw query is never stored.\n\t\t{ name: 'utmSource', type: 'text' },\n\t\t{ name: 'utmMedium', type: 'text' },\n\t\t{ name: 'utmCampaign', type: 'text' },\n\t\t{ name: 'utmContent', type: 'text' },\n\t\t{ name: 'utmTerm', type: 'text' },\n\t\t{ name: 'country', type: 'text' },\n\t\t{ name: 'region', type: 'text' },\n\t\t{ name: 'city', type: 'text' },\n\t\t{ name: 'language', type: 'text' },\n\t\t{ name: 'visitorHash', type: 'text', required: true, index: true },\n\t\t{ name: 'sessionId', type: 'text', required: true, index: true },\n\t\t{ name: 'durationMs', type: 'number' },\n\t\t{ name: 'props', type: 'json' },\n\t\t{ name: 'value', type: 'number' },\n\t\t{ name: 'currency', type: 'text' },\n\t\t{ name: 'scrollDepth', type: 'number' },\n\t\t// The completions matched at ingest, so a raw-event read (filtered or hourly) reports\n\t\t// the same conversions the rollups hold instead of re-matching against goals that may\n\t\t// since have changed.\n\t\t{ name: 'goals', type: 'json' },\n\t\t...(scoped ? [{ name: 'scope', type: 'text', index: true } satisfies Field] : []),\n\t],\n\tindexes: [{ fields: ['path', 'timestamp'] }, { fields: ['type', 'timestamp'] }],\n})\n"],"mappings":";AAEA,MAAa,cAAc;;;;;;AAO3B,MAAa,oBAAoB,SAAS,WAA6B;CACtE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAO,cAAc;CAAM;CAC1F,QAAQ;EACP;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,SAAS;IAAC;IAAY;IAAS;GAAM;GACrC,OAAO;EACR;EACA;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;EAAK;EACjD;GAAE,MAAM;GAAY,MAAM;EAAO;EAGjC;GAAE,MAAM;GAAgB,MAAM;EAAO;EACrC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAW,MAAM;EAAO;EAChC;GAAE,MAAM;GAAM,MAAM;EAAO;EAC3B;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAW,MAAM;EAAO;EAGhC;GAAE,MAAM;GAAkB,MAAM;EAAS;EAEzC;GAAE,MAAM;GAAa,MAAM;EAAO;EAClC;GAAE,MAAM;GAAa,MAAM;EAAO;EAClC;GAAE,MAAM;GAAe,MAAM;EAAO;EACpC;GAAE,MAAM;GAAc,MAAM;EAAO;EACnC;GAAE,MAAM;GAAW,MAAM;EAAO;EAChC;GAAE,MAAM;GAAW,MAAM;EAAO;EAChC;GAAE,MAAM;GAAU,MAAM;EAAO;EAC/B;GAAE,MAAM;GAAQ,MAAM;EAAO;EAC7B;GAAE,MAAM;GAAY,MAAM;EAAO;EACjC;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EACjE;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC/D;GAAE,MAAM;GAAc,MAAM;EAAS;EACrC;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B;GAAE,MAAM;GAAS,MAAM;EAAS;EAChC;GAAE,MAAM;GAAY,MAAM;EAAO;EACjC;GAAE,MAAM;GAAe,MAAM;EAAS;EAItC;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B,GAAI,SAAS,CAAC;GAAE,MAAM;GAAS,MAAM;GAAQ,OAAO;EAAK,CAAiB,IAAI,CAAC;CAChF;CACA,SAAS,CAAC,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,WAAW,EAAE,CAAC;AAC/E"}
@@ -1,9 +1,13 @@
1
1
  //#region src/native/collections/rollups.ts
2
2
  const ROLLUPS_SLUG = "analytics-rollups";
3
3
  /**
4
- * Scoped installs add a required scope key ('' = the null scope) to every rollup
4
+ * `hostname` ('' = the hostname-less family) is part of the unique bucket on every
5
+ * native install: unfiltered reads hit the '' family and hostname-scoped reads hit the
6
+ * exact-hostname family, both kept per-bucket exact by dual emission in computeRollupDeltas.
7
+ * Scoped installs add a further required scope key ('' = the null scope) to every rollup
5
8
  * row and to the unique bucket index, so each scope accumulates its own buckets.
6
- * Existing native installs enabling scope need a migration for the new column.
9
+ * Existing native installs need a migration for the new hostname column (and, if
10
+ * enabling scope, the scope column too).
7
11
  */
8
12
  const rollupsCollection = (scoped = false) => ({
9
13
  slug: ROLLUPS_SLUG,
@@ -44,6 +48,12 @@ const rollupsCollection = (scoped = false) => ({
44
48
  required: true,
45
49
  defaultValue: ""
46
50
  },
51
+ {
52
+ name: "hostname",
53
+ type: "text",
54
+ required: true,
55
+ defaultValue: ""
56
+ },
47
57
  ...scoped ? [{
48
58
  name: "scope",
49
59
  type: "text",
@@ -86,6 +96,30 @@ const rollupsCollection = (scoped = false) => ({
86
96
  type: "number",
87
97
  required: true,
88
98
  defaultValue: 0
99
+ },
100
+ {
101
+ name: "conversions",
102
+ type: "number",
103
+ required: true,
104
+ defaultValue: 0
105
+ },
106
+ {
107
+ name: "revenue",
108
+ type: "number",
109
+ required: true,
110
+ defaultValue: 0
111
+ },
112
+ {
113
+ name: "scrollDepthSum",
114
+ type: "number",
115
+ required: true,
116
+ defaultValue: 0
117
+ },
118
+ {
119
+ name: "scrollSamples",
120
+ type: "number",
121
+ required: true,
122
+ defaultValue: 0
89
123
  }
90
124
  ],
91
125
  indexes: [scoped ? {
@@ -95,6 +129,7 @@ const rollupsCollection = (scoped = false) => ({
95
129
  "path",
96
130
  "dimension",
97
131
  "dimvalue",
132
+ "hostname",
98
133
  "scope"
99
134
  ],
100
135
  unique: true
@@ -104,7 +139,8 @@ const rollupsCollection = (scoped = false) => ({
104
139
  "period",
105
140
  "path",
106
141
  "dimension",
107
- "dimvalue"
142
+ "dimvalue",
143
+ "hostname"
108
144
  ],
109
145
  unique: true
110
146
  }]
@@ -1 +1 @@
1
- {"version":3,"file":"rollups.js","names":[],"sources":["../../../src/native/collections/rollups.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const ROLLUPS_SLUG = 'analytics-rollups'\n\n/**\n * Scoped installs add a required scope key ('' = the null scope) to every rollup\n * row and to the unique bucket index, so each scope accumulates its own buckets.\n * Existing native installs enabling scope need a migration for the new column.\n */\nexport const rollupsCollection = (scoped = false): CollectionConfig => ({\n\tslug: ROLLUPS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => true, delete: () => true },\n\tfields: [\n\t\t{ name: 'granularity', type: 'text', required: true },\n\t\t{ name: 'period', type: 'date', required: true, index: true },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'dimension', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'dimvalue', type: 'text', required: true, defaultValue: '' },\n\t\t...(scoped\n\t\t\t? [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'scope',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tdefaultValue: '',\n\t\t\t\t\t\tindex: true,\n\t\t\t\t\t} satisfies Field,\n\t\t\t\t]\n\t\t\t: []),\n\t\t{ name: 'pageviews', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'events', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'durationMs', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'visitors', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'sessions', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'samples', type: 'number', required: true, defaultValue: 0 },\n\t],\n\tindexes: [\n\t\tscoped\n\t\t\t? {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'scope'],\n\t\t\t\t\tunique: true,\n\t\t\t\t}\n\t\t\t: { fields: ['granularity', 'period', 'path', 'dimension', 'dimvalue'], unique: true },\n\t],\n})\n"],"mappings":";AAEA,MAAa,eAAe;;;;;;AAO5B,MAAa,qBAAqB,SAAS,WAA6B;CACvE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAM,cAAc;CAAK;CACxF,QAAQ;EACP;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;EAAK;EACpD;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACpE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE,GAAI,SACD,CACA;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;EACR,CACD,IACC,CAAC;EACJ;GAAE,MAAM;GAAa,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACrE;GAAE,MAAM;GAAU,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAClE;GAAE,MAAM;GAAc,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACtE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;CACpE;CACA,SAAS,CACR,SACG;EACA,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;GAAY;EAAO;EAC1E,QAAQ;CACT,IACC;EAAE,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;EAAU;EAAG,QAAQ;CAAK,CACvF;AACD"}
1
+ {"version":3,"file":"rollups.js","names":[],"sources":["../../../src/native/collections/rollups.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const ROLLUPS_SLUG = 'analytics-rollups'\n\n/**\n * `hostname` ('' = the hostname-less family) is part of the unique bucket on every\n * native install: unfiltered reads hit the '' family and hostname-scoped reads hit the\n * exact-hostname family, both kept per-bucket exact by dual emission in computeRollupDeltas.\n * Scoped installs add a further required scope key ('' = the null scope) to every rollup\n * row and to the unique bucket index, so each scope accumulates its own buckets.\n * Existing native installs need a migration for the new hostname column (and, if\n * enabling scope, the scope column too).\n */\nexport const rollupsCollection = (scoped = false): CollectionConfig => ({\n\tslug: ROLLUPS_SLUG,\n\tadmin: { hidden: true },\n\taccess: { read: () => false, create: () => true, update: () => true, delete: () => true },\n\tfields: [\n\t\t{ name: 'granularity', type: 'text', required: true },\n\t\t{ name: 'period', type: 'date', required: true, index: true },\n\t\t{ name: 'path', type: 'text', required: true, index: true },\n\t\t{ name: 'dimension', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'dimvalue', type: 'text', required: true, defaultValue: '' },\n\t\t{ name: 'hostname', type: 'text', required: true, defaultValue: '' },\n\t\t...(scoped\n\t\t\t? [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'scope',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tdefaultValue: '',\n\t\t\t\t\t\tindex: true,\n\t\t\t\t\t} satisfies Field,\n\t\t\t\t]\n\t\t\t: []),\n\t\t{ name: 'pageviews', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'events', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'durationMs', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'visitors', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'sessions', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'samples', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'conversions', type: 'number', required: true, defaultValue: 0 },\n\t\t// Revenue is stored in the event's own currency and never converted, so a bucket\n\t\t// spanning several currencies sums figures that are not comparable.\n\t\t{ name: 'revenue', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'scrollDepthSum', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'scrollSamples', type: 'number', required: true, defaultValue: 0 },\n\t],\n\tindexes: [\n\t\tscoped\n\t\t\t? {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname', 'scope'],\n\t\t\t\t\tunique: true,\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tfields: ['granularity', 'period', 'path', 'dimension', 'dimvalue', 'hostname'],\n\t\t\t\t\tunique: true,\n\t\t\t\t},\n\t],\n})\n"],"mappings":";AAEA,MAAa,eAAe;;;;;;;;;;AAW5B,MAAa,qBAAqB,SAAS,WAA6B;CACvE,MAAM;CACN,OAAO,EAAE,QAAQ,KAAK;CACtB,QAAQ;EAAE,YAAY;EAAO,cAAc;EAAM,cAAc;EAAM,cAAc;CAAK;CACxF,QAAQ;EACP;GAAE,MAAM;GAAe,MAAM;GAAQ,UAAU;EAAK;EACpD;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAa,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACpE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE;GAAE,MAAM;GAAY,MAAM;GAAQ,UAAU;GAAM,cAAc;EAAG;EACnE,GAAI,SACD,CACA;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;EACR,CACD,IACC,CAAC;EACJ;GAAE,MAAM;GAAa,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACrE;GAAE,MAAM;GAAU,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAClE;GAAE,MAAM;GAAc,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACtE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAY,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACpE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACnE;GAAE,MAAM;GAAe,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAGvE;GAAE,MAAM;GAAW,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACnE;GAAE,MAAM;GAAkB,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EAC1E;GAAE,MAAM;GAAiB,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;CAC1E;CACA,SAAS,CACR,SACG;EACA,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;GAAY;GAAY;EAAO;EACtF,QAAQ;CACT,IACC;EACA,QAAQ;GAAC;GAAe;GAAU;GAAQ;GAAa;GAAY;EAAU;EAC7E,QAAQ;CACT,CACH;AACD"}
@@ -0,0 +1,25 @@
1
+ //#region src/native/eventScan.ts
2
+ /**
3
+ * Hard cap on how many raw events a single read scans. Reads that cannot use the day
4
+ * bucketed rollups (filtered, hour granularity, realtime) walk events newest-first under
5
+ * this cap, so a very busy site keeps its most recent activity rather than its oldest.
6
+ */
7
+ const EVENT_SCAN_LIMIT = 5e4;
8
+ /**
9
+ * Meta for a read that aggregated raw events under the scan cap. A scan that came back
10
+ * full almost certainly left events behind, so its numbers are a floor rather than a
11
+ * count and `sampled` tells every surface to say so.
12
+ */
13
+ const eventScanMeta = (args) => {
14
+ const meta = {
15
+ provider: "native",
16
+ fetchedAt: args.fetchedAt
17
+ };
18
+ if (args.clamped) meta.clamped = true;
19
+ if (args.eventCount >= (args.limit ?? 5e4)) meta.sampled = true;
20
+ return meta;
21
+ };
22
+ //#endregion
23
+ export { EVENT_SCAN_LIMIT, eventScanMeta };
24
+
25
+ //# sourceMappingURL=eventScan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"eventScan.js","names":[],"sources":["../../src/native/eventScan.ts"],"sourcesContent":["import type { AnalyticsResult } from '../core/contract'\n\n/**\n * Hard cap on how many raw events a single read scans. Reads that cannot use the day\n * bucketed rollups (filtered, hour granularity, realtime) walk events newest-first under\n * this cap, so a very busy site keeps its most recent activity rather than its oldest.\n */\nexport const EVENT_SCAN_LIMIT = 50_000\n\nexport interface EventScanMetaArgs {\n\tfetchedAt: string\n\t/** How many events the capped scan came back with. */\n\teventCount: number\n\tclamped?: boolean\n\tlimit?: number\n}\n\n/**\n * Meta for a read that aggregated raw events under the scan cap. A scan that came back\n * full almost certainly left events behind, so its numbers are a floor rather than a\n * count and `sampled` tells every surface to say so.\n */\nexport const eventScanMeta = (args: EventScanMetaArgs): AnalyticsResult['meta'] => {\n\tconst meta: AnalyticsResult['meta'] = { provider: 'native', fetchedAt: args.fetchedAt }\n\tif (args.clamped) {\n\t\tmeta.clamped = true\n\t}\n\tif (args.eventCount >= (args.limit ?? EVENT_SCAN_LIMIT)) {\n\t\tmeta.sampled = true\n\t}\n\treturn meta\n}\n"],"mappings":";;;;;;AAOA,MAAa,mBAAmB;;;;;;AAehC,MAAa,iBAAiB,SAAqD;CAClF,MAAM,OAAgC;EAAE,UAAU;EAAU,WAAW,KAAK;CAAU;CACtF,IAAI,KAAK,SACR,KAAK,UAAU;CAEhB,IAAI,KAAK,eAAe,KAAK,SAAA,MAC5B,KAAK,UAAU;CAEhB,OAAO;AACR"}
@@ -1,8 +1,8 @@
1
1
  //#region src/native/geo/composeGeoResolvers.ts
2
2
  function composeGeoResolvers(...resolvers) {
3
- return async (headers) => {
3
+ return async (headers, opts) => {
4
4
  for (const resolve of resolvers) {
5
- const geo = await resolve(headers);
5
+ const geo = await resolve(headers, opts);
6
6
  if (geo.country) return geo;
7
7
  }
8
8
  return {};
@@ -1 +1 @@
1
- {"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import type { Geo, GeoResolver } from './geoResolver'\n\nexport function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver {\n\treturn async (headers: Headers): Promise<Geo> => {\n\t\tfor (const resolve of resolvers) {\n\t\t\tconst geo = await resolve(headers)\n\t\t\tif (geo.country) {\n\t\t\t\treturn geo\n\t\t\t}\n\t\t}\n\t\treturn {}\n\t}\n}\n"],"mappings":";AAEA,SAAgB,oBAAoB,GAAG,WAAuC;CAC7E,OAAO,OAAO,YAAmC;EAChD,KAAK,MAAM,WAAW,WAAW;GAChC,MAAM,MAAM,MAAM,QAAQ,OAAO;GACjC,IAAI,IAAI,SACP,OAAO;EAET;EACA,OAAO,CAAC;CACT;AACD"}
1
+ {"version":3,"file":"composeGeoResolvers.js","names":[],"sources":["../../../src/native/geo/composeGeoResolvers.ts"],"sourcesContent":["import type { Geo, GeoResolver, GeoResolverOptions } from './geoResolver'\n\nexport function composeGeoResolvers(...resolvers: GeoResolver[]): GeoResolver {\n\treturn async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tfor (const resolve of resolvers) {\n\t\t\tconst geo = await resolve(headers, opts)\n\t\t\tif (geo.country) {\n\t\t\t\treturn geo\n\t\t\t}\n\t\t}\n\t\treturn {}\n\t}\n}\n"],"mappings":";AAEA,SAAgB,oBAAoB,GAAG,WAAuC;CAC7E,OAAO,OAAO,SAAkB,SAA4C;EAC3E,KAAK,MAAM,WAAW,WAAW;GAChC,MAAM,MAAM,MAAM,QAAQ,SAAS,IAAI;GACvC,IAAI,IAAI,SACP,OAAO;EAET;EACA,OAAO,CAAC;CACT;AACD"}
@@ -4,9 +4,16 @@ interface Geo {
4
4
  region?: string;
5
5
  city?: string;
6
6
  }
7
- type GeoResolver = (headers: Headers) => Geo | Promise<Geo>;
7
+ interface GeoResolverOptions {
8
+ trustedProxyHops?: number;
9
+ }
10
+ /**
11
+ * `opts` carries the install's `trustedProxyHops` for a resolver that reads the client address
12
+ * from the forwarded chain. A resolver that only reads platform headers can ignore it.
13
+ */
14
+ type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>;
8
15
  declare const platformHeaderResolver: GeoResolver;
9
16
  declare const noopResolver: GeoResolver;
10
17
  //#endregion
11
- export { Geo, GeoResolver, noopResolver, platformHeaderResolver };
18
+ export { Geo, GeoResolver, GeoResolverOptions, noopResolver, platformHeaderResolver };
12
19
  //# sourceMappingURL=geoResolver.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["export interface Geo {\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n}\n\nexport type GeoResolver = (headers: Headers) => Geo | Promise<Geo>\n\nexport const platformHeaderResolver: GeoResolver = (headers) => ({\n\tcountry: headers.get('x-vercel-ip-country') ?? headers.get('cf-ipcountry') ?? undefined,\n\tregion: headers.get('x-vercel-ip-country-region') ?? undefined,\n\tcity: headers.get('x-vercel-ip-city') ?? undefined,\n})\n\nexport const noopResolver: GeoResolver = () => ({})\n"],"mappings":";AAQA,MAAa,0BAAuC,aAAa;CAChE,SAAS,QAAQ,IAAI,qBAAqB,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAA;CAC9E,QAAQ,QAAQ,IAAI,4BAA4B,KAAK,KAAA;CACrD,MAAM,QAAQ,IAAI,kBAAkB,KAAK,KAAA;AAC1C;AAEA,MAAa,sBAAmC,CAAC"}
1
+ {"version":3,"file":"geoResolver.js","names":[],"sources":["../../../src/native/geo/geoResolver.ts"],"sourcesContent":["export interface Geo {\n\tcountry?: string\n\tregion?: string\n\tcity?: string\n}\n\nexport interface GeoResolverOptions {\n\ttrustedProxyHops?: number\n}\n\n/**\n * `opts` carries the install's `trustedProxyHops` for a resolver that reads the client address\n * from the forwarded chain. A resolver that only reads platform headers can ignore it.\n */\nexport type GeoResolver = (headers: Headers, opts?: GeoResolverOptions) => Geo | Promise<Geo>\n\nexport const platformHeaderResolver: GeoResolver = (headers) => ({\n\tcountry: headers.get('x-vercel-ip-country') ?? headers.get('cf-ipcountry') ?? undefined,\n\tregion: headers.get('x-vercel-ip-country-region') ?? undefined,\n\tcity: headers.get('x-vercel-ip-city') ?? undefined,\n})\n\nexport const noopResolver: GeoResolver = () => ({})\n"],"mappings":";AAgBA,MAAa,0BAAuC,aAAa;CAChE,SAAS,QAAQ,IAAI,qBAAqB,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAA;CAC9E,QAAQ,QAAQ,IAAI,4BAA4B,KAAK,KAAA;CACrD,MAAM,QAAQ,IAAI,kBAAkB,KAAK,KAAA;AAC1C;AAEA,MAAa,sBAAmC,CAAC"}
@@ -1,7 +1,5 @@
1
+ import { clientIpFromHeaders } from "../ingest/clientIp.js";
1
2
  //#region src/native/geo/maxmindResolver.ts
2
- const clientIp = (headers) => {
3
- return headers.get("x-forwarded-for")?.split(",")[0]?.trim() || headers.get("x-real-ip") || null;
4
- };
5
3
  /**
6
4
  * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded
7
5
  * lazily on first use. Any failure (lib not installed, file missing/unreadable,
@@ -25,8 +23,8 @@ function maxmindResolver(options) {
25
23
  })();
26
24
  return readerPromise;
27
25
  };
28
- return async (headers) => {
29
- const ip = clientIp(headers);
26
+ return async (headers, opts) => {
27
+ const ip = clientIpFromHeaders(headers, { trustedProxyHops: opts?.trustedProxyHops });
30
28
  if (!ip) return {};
31
29
  let reader;
32
30
  try {
@@ -1 +1 @@
1
- {"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { CityResponse, Reader } from 'maxmind'\nimport type { Geo, GeoResolver } from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n}\n\nconst clientIp = (headers: Headers): string | null => {\n\tconst fwd = headers.get('x-forwarded-for')?.split(',')[0]?.trim()\n\treturn fwd || headers.get('x-real-ip') || null\n}\n\n/**\n * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded\n * lazily on first use. Any failure (lib not installed, file missing/unreadable,\n * lookup error) degrades to empty geo after a single warning, so a missing or\n * unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<Reader<CityResponse>> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (): Promise<Reader<CityResponse>> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = await import('maxmind')\n\t\t\t\treturn open<CityResponse>(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\treturn async (headers: Headers): Promise<Geo> => {\n\t\tconst ip = clientIp(headers)\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: Reader<CityResponse> | null\n\t\ttry {\n\t\t\treader = await getReader()\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst r = reader.get(ip)\n\t\t\tif (!r) {\n\t\t\t\treturn {}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcountry: r.country?.iso_code ?? undefined,\n\t\t\t\tregion: r.subdivisions?.[0]?.iso_code ?? undefined,\n\t\t\t\tcity: r.city?.names.en ?? undefined,\n\t\t\t}\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n}\n"],"mappings":";AAOA,MAAM,YAAY,YAAoC;CAErD,OADY,QAAQ,IAAI,iBAAiB,GAAG,MAAM,GAAG,EAAE,IAAI,KAAK,KAClD,QAAQ,IAAI,WAAW,KAAK;AAC3C;;;;;;;AAQA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,kBAAiD;EACtD,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,MAAM,OAAO;GAC9B,OAAO,KAAmB,QAAQ,MAAM;EACzC,GAAG;EAEJ,OAAO;CACR;CAEA,OAAO,OAAO,YAAmC;EAChD,MAAM,KAAK,SAAS,OAAO;EAC3B,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU;EAC1B,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,IAAI,OAAO,IAAI,EAAE;GACvB,IAAI,CAAC,GACJ,OAAO,CAAC;GAET,OAAO;IACN,SAAS,EAAE,SAAS,YAAY,KAAA;IAChC,QAAQ,EAAE,eAAe,IAAI,YAAY,KAAA;IACzC,MAAM,EAAE,MAAM,MAAM,MAAM,KAAA;GAC3B;EACD,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;AACD"}
1
+ {"version":3,"file":"maxmindResolver.js","names":[],"sources":["../../../src/native/geo/maxmindResolver.ts"],"sourcesContent":["import type { CityResponse, Reader } from 'maxmind'\nimport { clientIpFromHeaders } from '../ingest/clientIp'\nimport type { Geo, GeoResolver, GeoResolverOptions } from './geoResolver'\n\nexport interface MaxmindOptions {\n\tdbPath: string\n}\n\n/**\n * Optional MaxMind GeoLite2 resolver. The mmdb and the maxmind lib are loaded\n * lazily on first use. Any failure (lib not installed, file missing/unreadable,\n * lookup error) degrades to empty geo after a single warning, so a missing or\n * unconfigured database never breaks ingestion.\n */\nexport function maxmindResolver(options: MaxmindOptions): GeoResolver {\n\tlet readerPromise: Promise<Reader<CityResponse>> | undefined\n\tlet warned = false\n\n\tconst warn = (detail: unknown): null => {\n\t\tif (!warned) {\n\t\t\twarned = true\n\t\t\tconsole.warn(\n\t\t\t\t`[analytics] MaxMind geo unavailable for \"${options.dbPath}\"; geo will be empty.`,\n\t\t\t\tdetail instanceof Error ? detail.message : detail\n\t\t\t)\n\t\t}\n\t\treturn null\n\t}\n\n\tconst getReader = (): Promise<Reader<CityResponse>> => {\n\t\tif (!readerPromise) {\n\t\t\treaderPromise = (async () => {\n\t\t\t\tconst { open } = await import('maxmind')\n\t\t\t\treturn open<CityResponse>(options.dbPath)\n\t\t\t})()\n\t\t}\n\t\treturn readerPromise\n\t}\n\n\treturn async (headers: Headers, opts?: GeoResolverOptions): Promise<Geo> => {\n\t\tconst ip = clientIpFromHeaders(headers, { trustedProxyHops: opts?.trustedProxyHops })\n\t\tif (!ip) {\n\t\t\treturn {}\n\t\t}\n\t\tlet reader: Reader<CityResponse> | null\n\t\ttry {\n\t\t\treader = await getReader()\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t\ttry {\n\t\t\tconst r = reader.get(ip)\n\t\t\tif (!r) {\n\t\t\t\treturn {}\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcountry: r.country?.iso_code ?? undefined,\n\t\t\t\tregion: r.subdivisions?.[0]?.iso_code ?? undefined,\n\t\t\t\tcity: r.city?.names.en ?? undefined,\n\t\t\t}\n\t\t} catch (err) {\n\t\t\twarn(err)\n\t\t\treturn {}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,gBAAgB,SAAsC;CACrE,IAAI;CACJ,IAAI,SAAS;CAEb,MAAM,QAAQ,WAA0B;EACvC,IAAI,CAAC,QAAQ;GACZ,SAAS;GACT,QAAQ,KACP,4CAA4C,QAAQ,OAAO,wBAC3D,kBAAkB,QAAQ,OAAO,UAAU,MAC5C;EACD;EACA,OAAO;CACR;CAEA,MAAM,kBAAiD;EACtD,IAAI,CAAC,eACJ,iBAAiB,YAAY;GAC5B,MAAM,EAAE,SAAS,MAAM,OAAO;GAC9B,OAAO,KAAmB,QAAQ,MAAM;EACzC,GAAG;EAEJ,OAAO;CACR;CAEA,OAAO,OAAO,SAAkB,SAA4C;EAC3E,MAAM,KAAK,oBAAoB,SAAS,EAAE,kBAAkB,MAAM,iBAAiB,CAAC;EACpF,IAAI,CAAC,IACJ,OAAO,CAAC;EAET,IAAI;EACJ,IAAI;GACH,SAAS,MAAM,UAAU;EAC1B,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;EACA,IAAI;GACH,MAAM,IAAI,OAAO,IAAI,EAAE;GACvB,IAAI,CAAC,GACJ,OAAO,CAAC;GAET,OAAO;IACN,SAAS,EAAE,SAAS,YAAY,KAAA;IAChC,QAAQ,EAAE,eAAe,IAAI,YAAY,KAAA;IACzC,MAAM,EAAE,MAAM,MAAM,MAAM,KAAA;GAC3B;EACD,SAAS,KAAK;GACb,KAAK,GAAG;GACR,OAAO,CAAC;EACT;CACD;AACD"}
@@ -0,0 +1,11 @@
1
+ //#region src/native/ingest/bots.d.ts
2
+ /**
3
+ * Whether a user agent belongs to automated traffic. An agent that says nothing counts as
4
+ * automated (every real browser sends one); the synthetic agent of a server event never does,
5
+ * since that call is trusted host code rather than a request off the internet.
6
+ */
7
+ declare const isBot: (ua: string) => boolean;
8
+ type BotFilter = (ua: string) => boolean;
9
+ //#endregion
10
+ export { BotFilter, isBot };
11
+ //# sourceMappingURL=bots.d.ts.map
@@ -0,0 +1,71 @@
1
+ import "./device.js";
2
+ //#region src/native/ingest/bots.ts
3
+ /**
4
+ * Lowercase substrings of the user agents automated traffic announces itself with: crawlers
5
+ * and their preview fetchers, uptime and performance monitors, headless browsers and the
6
+ * default agents of HTTP clients. Deliberately small and hand-held rather than a vendor list,
7
+ * so every entry can be justified against real agents and none of them can match a browser.
8
+ */
9
+ const BOT_MARKERS = new Set([
10
+ "bot",
11
+ "crawl",
12
+ "spider",
13
+ "slurp",
14
+ "headless",
15
+ "lighthouse",
16
+ "pagespeed",
17
+ "gtmetrix",
18
+ "pingdom",
19
+ "statuscake",
20
+ "datadog",
21
+ "newrelic",
22
+ "facebookexternalhit",
23
+ "whatsapp",
24
+ "embedly",
25
+ "phantomjs",
26
+ "puppeteer",
27
+ "playwright",
28
+ "selenium",
29
+ "python-requests",
30
+ "curl/",
31
+ "wget/",
32
+ "go-http-client",
33
+ "okhttp",
34
+ "axios/",
35
+ "node-fetch",
36
+ "java/",
37
+ "libwww",
38
+ "httpclient"
39
+ ]);
40
+ /**
41
+ * Device tokens that contain a marker and belong to a real phone. The agent is scanned with
42
+ * them removed, because `bot` has to keep matching mid-word (Googlebot, AhrefsBot) and would
43
+ * otherwise count every Cubot handset as a crawler.
44
+ */
45
+ const NOT_BOT_TOKENS = ["cubot"];
46
+ /**
47
+ * Whether a user agent belongs to automated traffic. An agent that says nothing counts as
48
+ * automated (every real browser sends one); the synthetic agent of a server event never does,
49
+ * since that call is trusted host code rather than a request off the internet.
50
+ */
51
+ const isBot = (ua) => {
52
+ if (ua === "analytics-server") return false;
53
+ let agent = ua.trim().toLowerCase();
54
+ if (agent === "") return true;
55
+ for (const token of NOT_BOT_TOKENS) agent = agent.replaceAll(token, "");
56
+ for (const marker of BOT_MARKERS) if (agent.includes(marker)) return true;
57
+ return false;
58
+ };
59
+ /**
60
+ * The `filterBots` option as one predicate. A host filter that throws throws through to the
61
+ * handler, which keeps the event and says so once: swallowing it here would leave a broken
62
+ * predicate silent for the life of the process.
63
+ */
64
+ const resolveBotFilter = (option) => {
65
+ if (option === false) return () => false;
66
+ return typeof option === "function" ? option : isBot;
67
+ };
68
+ //#endregion
69
+ export { isBot, resolveBotFilter };
70
+
71
+ //# sourceMappingURL=bots.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bots.js","names":[],"sources":["../../../src/native/ingest/bots.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\n/**\n * Lowercase substrings of the user agents automated traffic announces itself with: crawlers\n * and their preview fetchers, uptime and performance monitors, headless browsers and the\n * default agents of HTTP clients. Deliberately small and hand-held rather than a vendor list,\n * so every entry can be justified against real agents and none of them can match a browser.\n */\nexport const BOT_MARKERS: ReadonlySet<string> = new Set([\n\t'bot',\n\t'crawl',\n\t'spider',\n\t'slurp',\n\t'headless',\n\t'lighthouse',\n\t'pagespeed',\n\t'gtmetrix',\n\t'pingdom',\n\t'statuscake',\n\t'datadog',\n\t'newrelic',\n\t'facebookexternalhit',\n\t'whatsapp',\n\t'embedly',\n\t'phantomjs',\n\t'puppeteer',\n\t'playwright',\n\t'selenium',\n\t'python-requests',\n\t'curl/',\n\t'wget/',\n\t'go-http-client',\n\t'okhttp',\n\t'axios/',\n\t'node-fetch',\n\t'java/',\n\t'libwww',\n\t'httpclient',\n])\n\n/**\n * Device tokens that contain a marker and belong to a real phone. The agent is scanned with\n * them removed, because `bot` has to keep matching mid-word (Googlebot, AhrefsBot) and would\n * otherwise count every Cubot handset as a crawler.\n */\nconst NOT_BOT_TOKENS: readonly string[] = ['cubot']\n\n/**\n * Whether a user agent belongs to automated traffic. An agent that says nothing counts as\n * automated (every real browser sends one); the synthetic agent of a server event never does,\n * since that call is trusted host code rather than a request off the internet.\n */\nexport const isBot = (ua: string): boolean => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn false\n\t}\n\tlet agent = ua.trim().toLowerCase()\n\tif (agent === '') {\n\t\treturn true\n\t}\n\tfor (const token of NOT_BOT_TOKENS) {\n\t\tagent = agent.replaceAll(token, '')\n\t}\n\tfor (const marker of BOT_MARKERS) {\n\t\tif (agent.includes(marker)) {\n\t\t\treturn true\n\t\t}\n\t}\n\treturn false\n}\n\nexport type BotFilter = (ua: string) => boolean\n\n/**\n * The `filterBots` option as one predicate. A host filter that throws throws through to the\n * handler, which keeps the event and says so once: swallowing it here would leave a broken\n * predicate silent for the life of the process.\n */\nexport const resolveBotFilter = (option: boolean | BotFilter | undefined): BotFilter => {\n\tif (option === false) {\n\t\treturn () => false\n\t}\n\treturn typeof option === 'function' ? option : isBot\n}\n"],"mappings":";;;;;;;;AAQA,MAAa,cAAmC,IAAI,IAAI;CACvD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;;AAOD,MAAM,iBAAoC,CAAC,OAAO;;;;;;AAOlD,MAAa,SAAS,OAAwB;CAC7C,IAAI,OAAA,oBACH,OAAO;CAER,IAAI,QAAQ,GAAG,KAAK,EAAE,YAAY;CAClC,IAAI,UAAU,IACb,OAAO;CAER,KAAK,MAAM,SAAS,gBACnB,QAAQ,MAAM,WAAW,OAAO,EAAE;CAEnC,KAAK,MAAM,UAAU,aACpB,IAAI,MAAM,SAAS,MAAM,GACxB,OAAO;CAGT,OAAO;AACR;;;;;;AASA,MAAa,oBAAoB,WAAuD;CACvF,IAAI,WAAW,OACd,aAAa;CAEd,OAAO,OAAO,WAAW,aAAa,SAAS;AAChD"}
@@ -0,0 +1,47 @@
1
+ import "./device.js";
2
+ //#region src/native/ingest/browser.ts
3
+ /**
4
+ * Order is the whole algorithm: every Chromium fork still calls itself Chrome, and every iOS
5
+ * browser still calls itself Safari, so the fork has to be recognized before the engine it
6
+ * borrowed the token from.
7
+ */
8
+ const BROWSERS = [
9
+ [/edg(?:a|ios|e)?\//, "edge"],
10
+ [/\bopr\/|\bopt\/|\bopera\b/, "opera"],
11
+ [/samsungbrowser/, "samsung"],
12
+ [/firefox\/|fxios\//, "firefox"],
13
+ [/chrome\/|crios\/|chromium\//, "chrome"],
14
+ [/safari\//, "safari"]
15
+ ];
16
+ /**
17
+ * `CrOS` and `Android` both sit inside an `X11`/`Linux` UA, so they are matched ahead of it.
18
+ * `cros` needs its word boundaries: it is also a substring of `Microsoft`.
19
+ */
20
+ const PLATFORMS = [
21
+ [/iphone|ipad|ipod/, "ios"],
22
+ [/android/, "android"],
23
+ [/\bcros\b/, "chromeos"],
24
+ [/windows|win64|win32/, "windows"],
25
+ [/macintosh|mac os x/, "macos"],
26
+ [/linux|x11/, "linux"]
27
+ ];
28
+ const lookup = (table, ua, fallback) => {
29
+ if (ua === "analytics-server") return;
30
+ const s = ua.toLowerCase();
31
+ return table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback;
32
+ };
33
+ /**
34
+ * Coarse browser family from a user-agent string, `other` for anything unrecognized (a bot,
35
+ * a crawler, an HTTP client), and undefined when the agent is the synthetic server one so
36
+ * server events abstain from the browser breakdown rather than skewing it.
37
+ */
38
+ const classifyBrowser = (ua) => lookup(BROWSERS, ua, "other");
39
+ /**
40
+ * Operating system from a user-agent's platform tokens, on the same terms as
41
+ * `classifyBrowser`: `other` when nothing matches, undefined for the server agent.
42
+ */
43
+ const classifyOs = (ua) => lookup(PLATFORMS, ua, "other");
44
+ //#endregion
45
+ export { classifyBrowser, classifyOs };
46
+
47
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","names":[],"sources":["../../../src/native/ingest/browser.ts"],"sourcesContent":["import { SERVER_USER_AGENT } from './device'\n\nexport type BrowserName = 'chrome' | 'safari' | 'firefox' | 'edge' | 'opera' | 'samsung' | 'other'\n\nexport type OsName = 'ios' | 'android' | 'windows' | 'macos' | 'linux' | 'chromeos' | 'other'\n\n/**\n * Order is the whole algorithm: every Chromium fork still calls itself Chrome, and every iOS\n * browser still calls itself Safari, so the fork has to be recognized before the engine it\n * borrowed the token from.\n */\nconst BROWSERS: ReadonlyArray<[RegExp, BrowserName]> = [\n\t[/edg(?:a|ios|e)?\\//, 'edge'],\n\t[/\\bopr\\/|\\bopt\\/|\\bopera\\b/, 'opera'],\n\t[/samsungbrowser/, 'samsung'],\n\t[/firefox\\/|fxios\\//, 'firefox'],\n\t[/chrome\\/|crios\\/|chromium\\//, 'chrome'],\n\t[/safari\\//, 'safari'],\n]\n\n/**\n * `CrOS` and `Android` both sit inside an `X11`/`Linux` UA, so they are matched ahead of it.\n * `cros` needs its word boundaries: it is also a substring of `Microsoft`.\n */\nconst PLATFORMS: ReadonlyArray<[RegExp, OsName]> = [\n\t[/iphone|ipad|ipod/, 'ios'],\n\t[/android/, 'android'],\n\t[/\\bcros\\b/, 'chromeos'],\n\t[/windows|win64|win32/, 'windows'],\n\t[/macintosh|mac os x/, 'macos'],\n\t[/linux|x11/, 'linux'],\n]\n\nconst lookup = <T>(table: ReadonlyArray<[RegExp, T]>, ua: string, fallback: T): T | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\treturn table.find(([pattern]) => pattern.test(s))?.[1] ?? fallback\n}\n\n/**\n * Coarse browser family from a user-agent string, `other` for anything unrecognized (a bot,\n * a crawler, an HTTP client), and undefined when the agent is the synthetic server one so\n * server events abstain from the browser breakdown rather than skewing it.\n */\nexport const classifyBrowser = (ua: string): BrowserName | undefined =>\n\tlookup(BROWSERS, ua, 'other')\n\n/**\n * Operating system from a user-agent's platform tokens, on the same terms as\n * `classifyBrowser`: `other` when nothing matches, undefined for the server agent.\n */\nexport const classifyOs = (ua: string): OsName | undefined => lookup(PLATFORMS, ua, 'other')\n"],"mappings":";;;;;;;AAWA,MAAM,WAAiD;CACtD,CAAC,qBAAqB,MAAM;CAC5B,CAAC,6BAA6B,OAAO;CACrC,CAAC,kBAAkB,SAAS;CAC5B,CAAC,qBAAqB,SAAS;CAC/B,CAAC,+BAA+B,QAAQ;CACxC,CAAC,YAAY,QAAQ;AACtB;;;;;AAMA,MAAM,YAA6C;CAClD,CAAC,oBAAoB,KAAK;CAC1B,CAAC,WAAW,SAAS;CACrB,CAAC,YAAY,UAAU;CACvB,CAAC,uBAAuB,SAAS;CACjC,CAAC,sBAAsB,OAAO;CAC9B,CAAC,aAAa,OAAO;AACtB;AAEA,MAAM,UAAa,OAAmC,IAAY,aAA+B;CAChG,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,OAAO,MAAM,MAAM,CAAC,aAAa,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM;AAC3D;;;;;;AAOA,MAAa,mBAAmB,OAC/B,OAAO,UAAU,IAAI,OAAO;;;;;AAM7B,MAAa,cAAc,OAAmC,OAAO,WAAW,IAAI,OAAO"}
@@ -0,0 +1,20 @@
1
+ //#region src/native/ingest/clientIp.ts
2
+ /**
3
+ * The originating client IP a proxy chain reported: the first hop of `x-forwarded-for`, else
4
+ * `x-real-ip`. Null when the request carries neither, so callers can omit the value instead of
5
+ * forwarding a fabricated one.
6
+ *
7
+ * With `trustedProxyHops >= 1` the forwarded chain is the only source, counted from the right,
8
+ * and a chain shorter than the count answers null rather than falling back to a header the
9
+ * client could have written.
10
+ */
11
+ const clientIpFromHeaders = (headers, opts = {}) => {
12
+ const chain = (headers.get("x-forwarded-for") ?? "").split(",").map((entry) => entry.trim()).filter(Boolean);
13
+ const hops = opts.trustedProxyHops ?? 0;
14
+ if (hops >= 1) return chain[chain.length - hops] ?? null;
15
+ return chain[0] ?? (headers.get("x-real-ip")?.trim() || null);
16
+ };
17
+ //#endregion
18
+ export { clientIpFromHeaders };
19
+
20
+ //# sourceMappingURL=clientIp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clientIp.js","names":[],"sources":["../../../src/native/ingest/clientIp.ts"],"sourcesContent":["export interface ClientIpOptions {\n\t/**\n\t * Trusted proxies in front of the app, counted from the right of `x-forwarded-for`: the\n\t * address the outermost trusted proxy saw. Unset reads the leftmost entry, which is correct\n\t * for honest traffic and is whatever the client wrote for the rest, so an install behind a\n\t * proxy it controls should set it. There is no default of 1: an install behind a CDN plus a\n\t * proxy would then read the CDN's address for every visitor, collapsing geo and the visitor\n\t * hash onto one value, which is worse than a spoofable one.\n\t */\n\ttrustedProxyHops?: number\n}\n\n/**\n * The originating client IP a proxy chain reported: the first hop of `x-forwarded-for`, else\n * `x-real-ip`. Null when the request carries neither, so callers can omit the value instead of\n * forwarding a fabricated one.\n *\n * With `trustedProxyHops >= 1` the forwarded chain is the only source, counted from the right,\n * and a chain shorter than the count answers null rather than falling back to a header the\n * client could have written.\n */\nexport const clientIpFromHeaders = (\n\theaders: Headers,\n\topts: ClientIpOptions = {}\n): string | null => {\n\tconst chain = (headers.get('x-forwarded-for') ?? '')\n\t\t.split(',')\n\t\t.map((entry) => entry.trim())\n\t\t.filter(Boolean)\n\tconst hops = opts.trustedProxyHops ?? 0\n\tif (hops >= 1) {\n\t\treturn chain[chain.length - hops] ?? null\n\t}\n\treturn chain[0] ?? (headers.get('x-real-ip')?.trim() || null)\n}\n"],"mappings":";;;;;;;;;;AAqBA,MAAa,uBACZ,SACA,OAAwB,CAAC,MACN;CACnB,MAAM,SAAS,QAAQ,IAAI,iBAAiB,KAAK,IAC/C,MAAM,GAAG,EACT,KAAK,UAAU,MAAM,KAAK,CAAC,EAC3B,OAAO,OAAO;CAChB,MAAM,OAAO,KAAK,oBAAoB;CACtC,IAAI,QAAQ,GACX,OAAO,MAAM,MAAM,SAAS,SAAS;CAEtC,OAAO,MAAM,OAAO,QAAQ,IAAI,WAAW,GAAG,KAAK,KAAK;AACzD"}
@@ -1,15 +1,23 @@
1
1
  //#region src/native/ingest/device.ts
2
2
  /**
3
- * Coarse device class from a user-agent string. Tablets are checked before phones
4
- * because an Android tablet UA lacks the `Mobile` token an Android phone carries.
3
+ * The user agent server-side tracking stamps when the event has no browser request behind
4
+ * it. There is no device to report, so events carrying it abstain from the device breakdown
5
+ * rather than piling into `desktop` and skewing it.
6
+ */
7
+ const SERVER_USER_AGENT = "analytics-server";
8
+ /**
9
+ * Coarse device class from a user-agent string, or undefined when the agent is not a device
10
+ * at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`
11
+ * token an Android phone carries.
5
12
  */
6
13
  const classifyDevice = (ua) => {
14
+ if (ua === "analytics-server") return;
7
15
  const s = ua.toLowerCase();
8
16
  if (/ipad|tablet|playbook|silk|kindle/.test(s) || /android/.test(s) && !/mobi/.test(s)) return "tablet";
9
17
  if (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) return "mobile";
10
18
  return "desktop";
11
19
  };
12
20
  //#endregion
13
- export { classifyDevice };
21
+ export { SERVER_USER_AGENT, classifyDevice };
14
22
 
15
23
  //# sourceMappingURL=device.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * Coarse device class from a user-agent string. Tablets are checked before phones\n * because an Android tablet UA lacks the `Mobile` token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType => {\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;AAMA,MAAa,kBAAkB,OAA2B;CACzD,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
1
+ {"version":3,"file":"device.js","names":[],"sources":["../../../src/native/ingest/device.ts"],"sourcesContent":["export type DeviceType = 'desktop' | 'mobile' | 'tablet'\n\n/**\n * The user agent server-side tracking stamps when the event has no browser request behind\n * it. There is no device to report, so events carrying it abstain from the device breakdown\n * rather than piling into `desktop` and skewing it.\n */\nexport const SERVER_USER_AGENT = 'analytics-server'\n\n/**\n * Coarse device class from a user-agent string, or undefined when the agent is not a device\n * at all. Tablets are checked before phones because an Android tablet UA lacks the `Mobile`\n * token an Android phone carries.\n */\nexport const classifyDevice = (ua: string): DeviceType | undefined => {\n\tif (ua === SERVER_USER_AGENT) {\n\t\treturn undefined\n\t}\n\tconst s = ua.toLowerCase()\n\tif (/ipad|tablet|playbook|silk|kindle/.test(s) || (/android/.test(s) && !/mobi/.test(s))) {\n\t\treturn 'tablet'\n\t}\n\tif (/mobi|iphone|ipod|android|blackberry|iemobile|opera mini|windows phone/.test(s)) {\n\t\treturn 'mobile'\n\t}\n\treturn 'desktop'\n}\n"],"mappings":";;;;;;AAOA,MAAa,oBAAoB;;;;;;AAOjC,MAAa,kBAAkB,OAAuC;CACrE,IAAI,OAAA,oBACH;CAED,MAAM,IAAI,GAAG,YAAY;CACzB,IAAI,mCAAmC,KAAK,CAAC,KAAM,UAAU,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,GACrF,OAAO;CAER,IAAI,wEAAwE,KAAK,CAAC,GACjF,OAAO;CAER,OAAO;AACR"}
@@ -0,0 +1 @@
1
+ import { PayloadRequest } from "payload";