@10x-media/analytics 0.1.0-beta.4 → 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 (521) hide show
  1. package/CHANGELOG.md +280 -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 +17 -2
  68. package/dist/core/capabilities.js +20 -1
  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 +168 -8
  76. package/dist/core/options.js +132 -4
  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 -29
  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 +16 -2
  91. package/dist/exports/client.js +13 -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 +12 -4
  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 +17 -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.d.ts +23 -0
  113. package/dist/fields/config/MetricSelectField.js +51 -0
  114. package/dist/fields/config/MetricSelectField.js.map +1 -0
  115. package/dist/fields/config/SourceSelectField.d.ts +14 -0
  116. package/dist/fields/config/SourceSelectField.js +46 -0
  117. package/dist/fields/config/SourceSelectField.js.map +1 -0
  118. package/dist/fields/config/fetchSources.d.ts +16 -0
  119. package/dist/fields/config/fetchSources.js +33 -0
  120. package/dist/fields/config/fetchSources.js.map +1 -0
  121. package/dist/fields/config/narrow.js +32 -0
  122. package/dist/fields/config/narrow.js.map +1 -0
  123. package/dist/fields/config/sourcesState.js +27 -0
  124. package/dist/fields/config/sourcesState.js.map +1 -0
  125. package/dist/fields/config/toSelectOption.js +27 -0
  126. package/dist/fields/config/toSelectOption.js.map +1 -0
  127. package/dist/fields/config/useAnalyticsSources.d.ts +24 -0
  128. package/dist/fields/config/useAnalyticsSources.js +62 -0
  129. package/dist/fields/config/useAnalyticsSources.js.map +1 -0
  130. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  131. package/dist/fields/config/useFilterCapabilities.js +52 -0
  132. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  133. package/dist/fields/readForDocument.d.ts +5 -0
  134. package/dist/fields/readForDocument.js +22 -10
  135. package/dist/fields/readForDocument.js.map +1 -1
  136. package/dist/goals/GoalSelectField.d.ts +7 -0
  137. package/dist/goals/GoalSelectField.js +77 -0
  138. package/dist/goals/GoalSelectField.js.map +1 -0
  139. package/dist/goals/collection.js +254 -0
  140. package/dist/goals/collection.js.map +1 -0
  141. package/dist/goals/currency.js +14 -0
  142. package/dist/goals/currency.js.map +1 -0
  143. package/dist/goals/fetchGoals.d.ts +18 -0
  144. package/dist/goals/fetchGoals.js +33 -0
  145. package/dist/goals/fetchGoals.js.map +1 -0
  146. package/dist/goals/goalField.d.ts +31 -0
  147. package/dist/goals/goalField.js +56 -0
  148. package/dist/goals/goalField.js.map +1 -0
  149. package/dist/goals/goalsEndpoint.d.ts +1 -0
  150. package/dist/goals/goalsEndpoint.js +58 -0
  151. package/dist/goals/goalsEndpoint.js.map +1 -0
  152. package/dist/goals/match.js +64 -0
  153. package/dist/goals/match.js.map +1 -0
  154. package/dist/goals/resolver.d.ts +8 -0
  155. package/dist/goals/resolver.js +147 -0
  156. package/dist/goals/resolver.js.map +1 -0
  157. package/dist/goals/trackGoalAction.d.ts +76 -0
  158. package/dist/goals/trackGoalAction.js +158 -0
  159. package/dist/goals/trackGoalAction.js.map +1 -0
  160. package/dist/goals/types.d.ts +33 -0
  161. package/dist/goals/types.js +7 -0
  162. package/dist/goals/types.js.map +1 -0
  163. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  164. package/dist/goals/useAnalyticsGoals.js +67 -0
  165. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  166. package/dist/index.d.ts +14 -3
  167. package/dist/index.js +185 -19
  168. package/dist/index.js.map +1 -1
  169. package/dist/native/collections/events.js +65 -1
  170. package/dist/native/collections/events.js.map +1 -1
  171. package/dist/native/collections/rollups.js +39 -3
  172. package/dist/native/collections/rollups.js.map +1 -1
  173. package/dist/native/eventScan.js +25 -0
  174. package/dist/native/eventScan.js.map +1 -0
  175. package/dist/native/geo/composeGeoResolvers.js +2 -2
  176. package/dist/native/geo/composeGeoResolvers.js.map +1 -1
  177. package/dist/native/geo/geoResolver.d.ts +9 -2
  178. package/dist/native/geo/geoResolver.js.map +1 -1
  179. package/dist/native/geo/maxmindResolver.js +3 -5
  180. package/dist/native/geo/maxmindResolver.js.map +1 -1
  181. package/dist/native/ingest/bots.d.ts +11 -0
  182. package/dist/native/ingest/bots.js +71 -0
  183. package/dist/native/ingest/bots.js.map +1 -0
  184. package/dist/native/ingest/browser.js +47 -0
  185. package/dist/native/ingest/browser.js.map +1 -0
  186. package/dist/native/ingest/clientIp.js +20 -0
  187. package/dist/native/ingest/clientIp.js.map +1 -0
  188. package/dist/native/ingest/device.js +11 -3
  189. package/dist/native/ingest/device.js.map +1 -1
  190. package/dist/native/ingest/endpoint.d.ts +1 -0
  191. package/dist/native/ingest/endpoint.js +107 -21
  192. package/dist/native/ingest/endpoint.js.map +1 -1
  193. package/dist/native/ingest/flushBatch.js +29 -38
  194. package/dist/native/ingest/flushBatch.js.map +1 -1
  195. package/dist/native/ingest/language.js +14 -0
  196. package/dist/native/ingest/language.js.map +1 -0
  197. package/dist/native/ingest/normalizeEvent.d.ts +30 -0
  198. package/dist/native/ingest/normalizeEvent.js +115 -16
  199. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  200. package/dist/native/ingest/referrer.js +48 -0
  201. package/dist/native/ingest/referrer.js.map +1 -0
  202. package/dist/native/ingest/requestHost.js +57 -0
  203. package/dist/native/ingest/requestHost.js.map +1 -0
  204. package/dist/native/ingest/resolveHostname.d.ts +29 -0
  205. package/dist/native/ingest/resolveHostname.js +52 -0
  206. package/dist/native/ingest/resolveHostname.js.map +1 -0
  207. package/dist/native/ingest/salt.js +27 -2
  208. package/dist/native/ingest/salt.js.map +1 -1
  209. package/dist/native/ingest/serverTrack.d.ts +20 -0
  210. package/dist/native/ingest/serverTrack.js +109 -0
  211. package/dist/native/ingest/serverTrack.js.map +1 -0
  212. package/dist/native/ingest/source.d.ts +11 -0
  213. package/dist/native/ingest/source.js +264 -16
  214. package/dist/native/ingest/source.js.map +1 -1
  215. package/dist/native/ingest/utm.js +33 -0
  216. package/dist/native/ingest/utm.js.map +1 -0
  217. package/dist/native/ingest/validate.js +26 -0
  218. package/dist/native/ingest/validate.js.map +1 -0
  219. package/dist/native/nativeAdapter.d.ts +37 -1
  220. package/dist/native/nativeAdapter.js +175 -22
  221. package/dist/native/nativeAdapter.js.map +1 -1
  222. package/dist/native/query/eventAgg.js +175 -0
  223. package/dist/native/query/eventAgg.js.map +1 -0
  224. package/dist/native/retention/pruneTask.js +53 -13
  225. package/dist/native/retention/pruneTask.js.map +1 -1
  226. package/dist/native/rollupAcc.js +12 -1
  227. package/dist/native/rollupAcc.js.map +1 -1
  228. package/dist/native/rollups/bucketKey.js +15 -0
  229. package/dist/native/rollups/bucketKey.js.map +1 -0
  230. package/dist/native/rollups/bumpRollups.js +116 -0
  231. package/dist/native/rollups/bumpRollups.js.map +1 -0
  232. package/dist/native/rollups/deltas.js +86 -11
  233. package/dist/native/rollups/deltas.js.map +1 -1
  234. package/dist/native/rollups/insertManyIfNew.js +93 -0
  235. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  236. package/dist/next/captureRewrites.d.ts +42 -0
  237. package/dist/next/captureRewrites.js +57 -0
  238. package/dist/next/captureRewrites.js.map +1 -0
  239. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  240. package/dist/next/posthogProxyRewrites.js +16 -21
  241. package/dist/next/posthogProxyRewrites.js.map +1 -1
  242. package/dist/plugin/documentEndpoint.js +71 -24
  243. package/dist/plugin/documentEndpoint.js.map +1 -1
  244. package/dist/plugin/errors.d.ts +31 -0
  245. package/dist/plugin/errors.js +79 -0
  246. package/dist/plugin/errors.js.map +1 -0
  247. package/dist/plugin/goalHint.d.ts +1 -0
  248. package/dist/plugin/goalHint.js +24 -0
  249. package/dist/plugin/goalHint.js.map +1 -0
  250. package/dist/plugin/paths.js +19 -1
  251. package/dist/plugin/paths.js.map +1 -1
  252. package/dist/plugin/queryEndpoint.js +124 -0
  253. package/dist/plugin/queryEndpoint.js.map +1 -0
  254. package/dist/plugin/readContextForRequest.js +73 -0
  255. package/dist/plugin/readContextForRequest.js.map +1 -0
  256. package/dist/plugin/realtimeEndpoint.js +39 -18
  257. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  258. package/dist/plugin/refreshEndpoint.js +113 -0
  259. package/dist/plugin/refreshEndpoint.js.map +1 -0
  260. package/dist/plugin/runtime.d.ts +1 -0
  261. package/dist/plugin/runtime.js +33 -1
  262. package/dist/plugin/runtime.js.map +1 -1
  263. package/dist/plugin/scopeChange.js +22 -0
  264. package/dist/plugin/scopeChange.js.map +1 -0
  265. package/dist/plugin/scopeFieldBoot.js +22 -0
  266. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  267. package/dist/plugin/sourcesEndpoint.js +28 -0
  268. package/dist/plugin/sourcesEndpoint.js.map +1 -0
  269. package/dist/plugin/warmTask.js +0 -0
  270. package/dist/plugin/warmTask.js.map +1 -1
  271. package/dist/providers/access.js +2 -1
  272. package/dist/providers/access.js.map +1 -1
  273. package/dist/providers/collection.js +90 -29
  274. package/dist/providers/collection.js.map +1 -1
  275. package/dist/providers/factory.js +11 -3
  276. package/dist/providers/factory.js.map +1 -1
  277. package/dist/providers/resolver.js.map +1 -1
  278. package/dist/query/dates.js +64 -0
  279. package/dist/query/dates.js.map +1 -0
  280. package/dist/query/errors.d.ts +14 -0
  281. package/dist/query/fetchQuery.d.ts +79 -0
  282. package/dist/query/fetchQuery.js +117 -0
  283. package/dist/query/fetchQuery.js.map +1 -0
  284. package/dist/query/parse.d.ts +22 -0
  285. package/dist/query/parse.js +168 -0
  286. package/dist/query/parse.js.map +1 -0
  287. package/dist/query/response.d.ts +39 -0
  288. package/dist/query/response.js +11 -0
  289. package/dist/query/response.js.map +1 -0
  290. package/dist/react/AnalyticsProvider.d.ts +50 -0
  291. package/dist/react/AnalyticsProvider.js +67 -0
  292. package/dist/react/AnalyticsProvider.js.map +1 -0
  293. package/dist/react/TrackerBoot.d.ts +22 -0
  294. package/dist/react/TrackerBoot.js +30 -0
  295. package/dist/react/TrackerBoot.js.map +1 -0
  296. package/dist/react/useAnalytics.d.ts +20 -0
  297. package/dist/react/useAnalytics.js +52 -0
  298. package/dist/react/useAnalytics.js.map +1 -0
  299. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  300. package/dist/rsc/AnalyticsScripts.js +41 -0
  301. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  302. package/dist/surfacing/cacheStore.d.ts +1 -0
  303. package/dist/surfacing/cacheStore.js +18 -2
  304. package/dist/surfacing/cacheStore.js.map +1 -1
  305. package/dist/surfacing/engine.d.ts +1 -0
  306. package/dist/surfacing/engine.js +47 -6
  307. package/dist/surfacing/engine.js.map +1 -1
  308. package/dist/surfacing/epoch.d.ts +1 -0
  309. package/dist/surfacing/epoch.js +72 -0
  310. package/dist/surfacing/epoch.js.map +1 -0
  311. package/dist/surfacing/queue.js +22 -6
  312. package/dist/surfacing/queue.js.map +1 -1
  313. package/dist/surfacing/rateLimiter.js +130 -0
  314. package/dist/surfacing/rateLimiter.js.map +1 -0
  315. package/dist/surfacing/retryPolicy.js +15 -0
  316. package/dist/surfacing/retryPolicy.js.map +1 -0
  317. package/dist/sync/collection.js +23 -7
  318. package/dist/sync/collection.js.map +1 -1
  319. package/dist/sync/syncTask.js +68 -33
  320. package/dist/sync/syncTask.js.map +1 -1
  321. package/dist/testing/memoryAdapter.d.ts +2 -0
  322. package/dist/testing/memoryAdapter.js +17 -1
  323. package/dist/testing/memoryAdapter.js.map +1 -1
  324. package/dist/timeframe/tz.js +17 -6
  325. package/dist/timeframe/tz.js.map +1 -1
  326. package/dist/tracker/autoCapture.d.ts +48 -0
  327. package/dist/tracker/autoCapture.js +129 -0
  328. package/dist/tracker/autoCapture.js.map +1 -0
  329. package/dist/tracker/consent.d.ts +24 -0
  330. package/dist/tracker/consent.js +48 -0
  331. package/dist/tracker/consent.js.map +1 -0
  332. package/dist/tracker/createTracker.d.ts +18 -0
  333. package/dist/tracker/createTracker.js +215 -0
  334. package/dist/tracker/createTracker.js.map +1 -0
  335. package/dist/tracker/exclusion.d.ts +28 -0
  336. package/dist/tracker/exclusion.js +50 -0
  337. package/dist/tracker/exclusion.js.map +1 -0
  338. package/dist/tracker/initTracker.d.ts +22 -0
  339. package/dist/tracker/initTracker.js +33 -0
  340. package/dist/tracker/initTracker.js.map +1 -0
  341. package/dist/tracker/loadScript.d.ts +14 -0
  342. package/dist/tracker/loadScript.js +41 -0
  343. package/dist/tracker/loadScript.js.map +1 -0
  344. package/dist/tracker/pageTracking.d.ts +17 -0
  345. package/dist/tracker/pageTracking.js +38 -0
  346. package/dist/tracker/pageTracking.js.map +1 -0
  347. package/dist/tracker/registry.d.ts +27 -0
  348. package/dist/tracker/registry.js +73 -0
  349. package/dist/tracker/registry.js.map +1 -0
  350. package/dist/tracker/sinks/ga4.d.ts +29 -0
  351. package/dist/tracker/sinks/ga4.js +30 -0
  352. package/dist/tracker/sinks/ga4.js.map +1 -0
  353. package/dist/tracker/sinks/native.d.ts +22 -0
  354. package/dist/tracker/sinks/native.js +56 -0
  355. package/dist/tracker/sinks/native.js.map +1 -0
  356. package/dist/tracker/sinks/plausible.d.ts +20 -0
  357. package/dist/tracker/sinks/plausible.js +32 -0
  358. package/dist/tracker/sinks/plausible.js.map +1 -0
  359. package/dist/tracker/sinks/posthog.d.ts +18 -0
  360. package/dist/tracker/sinks/posthog.js +30 -0
  361. package/dist/tracker/sinks/posthog.js.map +1 -0
  362. package/dist/tracker/sinks/umami.d.ts +18 -0
  363. package/dist/tracker/sinks/umami.js +23 -0
  364. package/dist/tracker/sinks/umami.js.map +1 -0
  365. package/dist/tracker/sinks/vendor.d.ts +14 -0
  366. package/dist/tracker/sinks/vendor.js +81 -0
  367. package/dist/tracker/sinks/vendor.js.map +1 -0
  368. package/dist/tracker/transport.js +28 -0
  369. package/dist/tracker/transport.js.map +1 -0
  370. package/dist/tracker/types.d.ts +91 -0
  371. package/dist/translations/ar.js +221 -0
  372. package/dist/translations/ar.js.map +1 -0
  373. package/dist/translations/de.js +145 -1
  374. package/dist/translations/de.js.map +1 -1
  375. package/dist/translations/en.js +145 -1
  376. package/dist/translations/en.js.map +1 -1
  377. package/dist/translations/es.js +221 -0
  378. package/dist/translations/es.js.map +1 -0
  379. package/dist/translations/fr.js +221 -0
  380. package/dist/translations/fr.js.map +1 -0
  381. package/dist/translations/id.js +221 -0
  382. package/dist/translations/id.js.map +1 -0
  383. package/dist/translations/index.d.ts +10 -1
  384. package/dist/translations/index.js +19 -1
  385. package/dist/translations/index.js.map +1 -1
  386. package/dist/translations/keys.d.ts +144 -0
  387. package/dist/translations/keys.js +145 -1
  388. package/dist/translations/keys.js.map +1 -1
  389. package/dist/translations/ko.js +221 -0
  390. package/dist/translations/ko.js.map +1 -0
  391. package/dist/translations/metricKeys.js +8 -2
  392. package/dist/translations/metricKeys.js.map +1 -1
  393. package/dist/translations/pt.js +221 -0
  394. package/dist/translations/pt.js.map +1 -0
  395. package/dist/translations/ru.js +221 -0
  396. package/dist/translations/ru.js.map +1 -0
  397. package/dist/translations/server.js.map +1 -1
  398. package/dist/translations/uk.js +221 -0
  399. package/dist/translations/uk.js.map +1 -0
  400. package/dist/translations/zh.js +221 -0
  401. package/dist/translations/zh.js.map +1 -0
  402. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  403. package/dist/view/AnalyticsNavLink.js +40 -0
  404. package/dist/view/AnalyticsNavLink.js.map +1 -0
  405. package/dist/view/AnalyticsView.d.ts +23 -0
  406. package/dist/view/AnalyticsView.js +45 -0
  407. package/dist/view/AnalyticsView.js.map +1 -0
  408. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  409. package/dist/view/AnalyticsViewClient.js +244 -0
  410. package/dist/view/AnalyticsViewClient.js.map +1 -0
  411. package/dist/view/authRedirect.js +32 -0
  412. package/dist/view/authRedirect.js.map +1 -0
  413. package/dist/view/conversionRate.js +18 -0
  414. package/dist/view/conversionRate.js.map +1 -0
  415. package/dist/view/dayRange.js +68 -0
  416. package/dist/view/dayRange.js.map +1 -0
  417. package/dist/view/gating.d.ts +1 -0
  418. package/dist/view/gating.js +142 -0
  419. package/dist/view/gating.js.map +1 -0
  420. package/dist/view/labels.js +76 -0
  421. package/dist/view/labels.js.map +1 -0
  422. package/dist/view/registerView.js +48 -0
  423. package/dist/view/registerView.js.map +1 -0
  424. package/dist/view/sections/Breakdowns.js +198 -0
  425. package/dist/view/sections/Breakdowns.js.map +1 -0
  426. package/dist/view/sections/EmptyStates.js +92 -0
  427. package/dist/view/sections/EmptyStates.js.map +1 -0
  428. package/dist/view/sections/FilterChips.js +46 -0
  429. package/dist/view/sections/FilterChips.js.map +1 -0
  430. package/dist/view/sections/GoalsPanel.js +82 -0
  431. package/dist/view/sections/GoalsPanel.js.map +1 -0
  432. package/dist/view/sections/OverviewCards.js +65 -0
  433. package/dist/view/sections/OverviewCards.js.map +1 -0
  434. package/dist/view/sections/RealtimeStrip.js +80 -0
  435. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  436. package/dist/view/sections/Toolbar.js +207 -0
  437. package/dist/view/sections/Toolbar.js.map +1 -0
  438. package/dist/view/sections/Trend.js +125 -0
  439. package/dist/view/sections/Trend.js.map +1 -0
  440. package/dist/view/sections/styles.js +76 -0
  441. package/dist/view/sections/styles.js.map +1 -0
  442. package/dist/view/state.js +211 -0
  443. package/dist/view/state.js.map +1 -0
  444. package/dist/view/useViewQueries.js +153 -0
  445. package/dist/view/useViewQueries.js.map +1 -0
  446. package/dist/view/viewProps.d.ts +40 -0
  447. package/dist/view/viewProps.js +90 -0
  448. package/dist/view/viewProps.js.map +1 -0
  449. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  450. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  451. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  452. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  453. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  454. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  455. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  456. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  457. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  458. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  459. package/dist/widgets/AnalyticsRealtimeWidget.js +45 -23
  460. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  461. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  462. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  463. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  464. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  465. package/dist/widgets/RealtimeCounter.js +18 -4
  466. package/dist/widgets/RealtimeCounter.js.map +1 -1
  467. package/dist/widgets/WidgetViewLink.js +17 -0
  468. package/dist/widgets/WidgetViewLink.js.map +1 -0
  469. package/dist/widgets/breakdownTypes.js +38 -0
  470. package/dist/widgets/breakdownTypes.js.map +1 -1
  471. package/dist/widgets/cardChrome.js +31 -7
  472. package/dist/widgets/cardChrome.js.map +1 -1
  473. package/dist/widgets/comparison.js +15 -1
  474. package/dist/widgets/comparison.js.map +1 -1
  475. package/dist/widgets/defaults.d.ts +6 -2
  476. package/dist/widgets/defaults.js +78 -23
  477. package/dist/widgets/defaults.js.map +1 -1
  478. package/dist/widgets/filterCaption.js +27 -0
  479. package/dist/widgets/filterCaption.js.map +1 -0
  480. package/dist/widgets/filterField.d.ts +19 -0
  481. package/dist/widgets/filterField.js +75 -0
  482. package/dist/widgets/filterField.js.map +1 -0
  483. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  484. package/dist/widgets/prepareWidgetRead.js +74 -0
  485. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  486. package/dist/widgets/range.js +43 -12
  487. package/dist/widgets/range.js.map +1 -1
  488. package/dist/widgets/readForWidget.d.ts +26 -3
  489. package/dist/widgets/readForWidget.js +48 -44
  490. package/dist/widgets/readForWidget.js.map +1 -1
  491. package/dist/widgets/readForWidgetBreakdown.d.ts +34 -2
  492. package/dist/widgets/readForWidgetBreakdown.js +53 -49
  493. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  494. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  495. package/dist/widgets/readForWidgetGoals.js +140 -0
  496. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  497. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  498. package/dist/widgets/readForWidgetRealtime.js +23 -21
  499. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  500. package/dist/widgets/readForWidgetSeries.d.ts +26 -2
  501. package/dist/widgets/readForWidgetSeries.js +78 -53
  502. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  503. package/dist/widgets/readMeta.js +18 -0
  504. package/dist/widgets/readMeta.js.map +1 -0
  505. package/dist/widgets/realtimePoll.js +16 -1
  506. package/dist/widgets/realtimePoll.js.map +1 -1
  507. package/dist/widgets/registerWidgets.js +76 -14
  508. package/dist/widgets/registerWidgets.js.map +1 -1
  509. package/dist/widgets/types.d.ts +15 -0
  510. package/dist/widgets/types.js +16 -2
  511. package/dist/widgets/types.js.map +1 -1
  512. package/dist/widgets/viewLink.d.ts +22 -0
  513. package/dist/widgets/viewLink.js +86 -0
  514. package/dist/widgets/viewLink.js.map +1 -0
  515. package/package.json +27 -7
  516. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  517. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  518. package/dist/native/rollups/bumpRollup.js +0 -68
  519. package/dist/native/rollups/bumpRollup.js.map +0 -1
  520. package/dist/native/rollups/insertIfNew.js +0 -19
  521. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -0,0 +1,95 @@
1
+ import { INGEST_PATH, PROXY_PATH } from "../plugin/paths.js";
2
+ import { resolveGoalsFor, resolveScopeFor } from "../plugin/runtime.js";
3
+ import { CAPTURE_SLOTS, resolveSlotAdapterFor } from "./slots.js";
4
+ import { DEFAULT_AUTO_CAPTURE, defaultConsentFor } from "../core/options.js";
5
+ import { normalizeMountPath } from "./mountPath.js";
6
+ //#region src/capture/trackerConfig.ts
7
+ const apiRoute = (req) => req.payload?.config?.routes?.api ?? "/api";
8
+ const trackerGoals = (goals) => (goals ?? []).map(({ slug, match, value, currency }) => ({
9
+ slug,
10
+ match,
11
+ ...value ? { value } : {},
12
+ ...currency ? { currency } : {}
13
+ }));
14
+ /** The request's scope, or null when the host's resolver has none or throws. */
15
+ const scopeFor = async (runtime, req) => {
16
+ try {
17
+ return await resolveScopeFor(runtime, req);
18
+ } catch (err) {
19
+ req.payload?.logger?.warn(`analytics: tracker config scope resolution failed: ${String(err)}`);
20
+ return null;
21
+ }
22
+ };
23
+ /** The scope's merged goals, falling back to the config goals when the merge fails. */
24
+ const goalsFor = async (runtime, req, scope) => {
25
+ try {
26
+ return await resolveGoalsFor(runtime, req, scope);
27
+ } catch (err) {
28
+ req.payload?.logger?.warn(`analytics: tracker config goals resolution failed, falling back to config goals: ${String(err)}`);
29
+ return runtime.goals ?? [];
30
+ }
31
+ };
32
+ /** The config for an install with no runtime yet: no slots, but still a usable ingest path. */
33
+ const emptyTrackerConfig = (req) => ({
34
+ slots: [],
35
+ autoCapture: DEFAULT_AUTO_CAPTURE,
36
+ goals: [],
37
+ ingestPath: `${apiRoute(req)}${INGEST_PATH}`
38
+ });
39
+ /**
40
+ * The per-request tracker config: one entry per capture slot that resolves to an adapter
41
+ * declaring `capture`, in slot order. A slot whose adapter does not resolve (no scope, an
42
+ * unknown id, a throwing scope resolver) is simply absent, as is one whose snippet throws;
43
+ * this runs on a public, unauthenticated path, so every failure degrades a slot away
44
+ * rather than surfacing an error.
45
+ *
46
+ * One adapter fills at most one slot. A scoped install whose tenant registry defaults to
47
+ * the same adapter the global slot names would otherwise hand the tracker two sinks for
48
+ * it and send every event twice; the native adapter in particular resolves its scope from
49
+ * the request, so one sink already covers both. The global slot iterates first and keeps
50
+ * the entry.
51
+ */
52
+ const resolveTrackerConfig = async (args) => {
53
+ const { runtime, req } = args;
54
+ const base = apiRoute(req);
55
+ const scope = await scopeFor(runtime, req);
56
+ const slots = [];
57
+ const filled = /* @__PURE__ */ new Set();
58
+ for (const slot of CAPTURE_SLOTS) {
59
+ const adapter = await resolveSlotAdapterFor({
60
+ runtime,
61
+ req,
62
+ slot,
63
+ scope
64
+ });
65
+ const capture = adapter?.capture;
66
+ if (!adapter || !capture || filled.has(adapter.id)) continue;
67
+ const override = runtime.capturePaths?.[slot];
68
+ const path = override ? normalizeMountPath(override) : `${base}${PROXY_PATH}/${slot}`;
69
+ const kind = capture.client.kind;
70
+ try {
71
+ slots.push({
72
+ slot,
73
+ kind,
74
+ adapterId: adapter.id,
75
+ path,
76
+ snippet: capture.snippet({ path }),
77
+ client: capture.client,
78
+ requiresConsent: (runtime.consentFor?.(slot, adapter.id, kind) ?? defaultConsentFor(kind)) === "required"
79
+ });
80
+ filled.add(adapter.id);
81
+ } catch (err) {
82
+ req.payload?.logger?.warn(`analytics: capture snippet for "${adapter.id}" failed, dropping the ${slot} slot: ${String(err)}`);
83
+ }
84
+ }
85
+ return {
86
+ slots,
87
+ autoCapture: runtime.autoCapture ?? DEFAULT_AUTO_CAPTURE,
88
+ goals: trackerGoals(await goalsFor(runtime, req, scope)),
89
+ ingestPath: `${base}${runtime.ingestPath ?? "/analytics/ingest"}`
90
+ };
91
+ };
92
+ //#endregion
93
+ export { emptyTrackerConfig, resolveTrackerConfig };
94
+
95
+ //# sourceMappingURL=trackerConfig.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trackerConfig.js","names":[],"sources":["../../src/capture/trackerConfig.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\nimport type { CaptureClientKind, CaptureSnippet, CaptureSupport } from '../core/capture'\nimport { DEFAULT_AUTO_CAPTURE, defaultConsentFor, type ResolvedAutoCapture } from '../core/options'\nimport type { Goal, TrackerGoal } from '../goals/types'\nimport { INGEST_PATH, PROXY_PATH } from '../plugin/paths'\nimport { type AnalyticsRuntime, resolveGoalsFor, resolveScopeFor } from '../plugin/runtime'\nimport { normalizeMountPath } from './mountPath'\nimport { CAPTURE_SLOTS, type CaptureSlot, resolveSlotAdapterFor } from './slots'\n\nexport interface TrackerSlotConfig {\n\tslot: CaptureSlot\n\tkind: CaptureClientKind\n\tadapterId: string\n\t/** Mount the snippet and the sink talk to: the runtime proxy, or a `capture.paths` override. */\n\tpath: string\n\tsnippet: CaptureSnippet\n\tclient: CaptureSupport['client']\n\trequiresConsent: boolean\n}\n\n/**\n * Everything the browser tracker needs, and nothing else. Serialized to any visitor by the\n * public tracker endpoint, so it carries only what an adapter puts in `capture.client` and\n * `capture.snippet`: never a query credential, never a goal's admin-facing name.\n */\nexport interface TrackerConfig {\n\tslots: TrackerSlotConfig[]\n\tautoCapture: ResolvedAutoCapture\n\t/** The request scope's goals, config merged with the goals collection. */\n\tgoals: TrackerGoal[]\n\t/** Where the native sink posts events, derived from the app's own `routes.api`. */\n\tingestPath: string\n}\n\nconst apiRoute = (req: PayloadRequest): string => req.payload?.config?.routes?.api ?? '/api'\n\nconst trackerGoals = (goals: Goal[] | undefined): TrackerGoal[] =>\n\t(goals ?? []).map(({ slug, match, value, currency }) => ({\n\t\tslug,\n\t\tmatch,\n\t\t...(value ? { value } : {}),\n\t\t...(currency ? { currency } : {}),\n\t}))\n\n/** The request's scope, or null when the host's resolver has none or throws. */\nconst scopeFor = async (runtime: AnalyticsRuntime, req: PayloadRequest): Promise<string | null> => {\n\ttry {\n\t\treturn await resolveScopeFor(runtime, req)\n\t} catch (err) {\n\t\treq.payload?.logger?.warn(`analytics: tracker config scope resolution failed: ${String(err)}`)\n\t\treturn null\n\t}\n}\n\n/** The scope's merged goals, falling back to the config goals when the merge fails. */\nconst goalsFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope: string | null\n): Promise<Goal[]> => {\n\ttry {\n\t\treturn await resolveGoalsFor(runtime, req, scope)\n\t} catch (err) {\n\t\treq.payload?.logger?.warn(\n\t\t\t`analytics: tracker config goals resolution failed, falling back to config goals: ${String(err)}`\n\t\t)\n\t\treturn runtime.goals ?? []\n\t}\n}\n\n/** The config for an install with no runtime yet: no slots, but still a usable ingest path. */\nexport const emptyTrackerConfig = (req: PayloadRequest): TrackerConfig => ({\n\tslots: [],\n\tautoCapture: DEFAULT_AUTO_CAPTURE,\n\tgoals: [],\n\tingestPath: `${apiRoute(req)}${INGEST_PATH}`,\n})\n\n/**\n * The per-request tracker config: one entry per capture slot that resolves to an adapter\n * declaring `capture`, in slot order. A slot whose adapter does not resolve (no scope, an\n * unknown id, a throwing scope resolver) is simply absent, as is one whose snippet throws;\n * this runs on a public, unauthenticated path, so every failure degrades a slot away\n * rather than surfacing an error.\n *\n * One adapter fills at most one slot. A scoped install whose tenant registry defaults to\n * the same adapter the global slot names would otherwise hand the tracker two sinks for\n * it and send every event twice; the native adapter in particular resolves its scope from\n * the request, so one sink already covers both. The global slot iterates first and keeps\n * the entry.\n */\nexport const resolveTrackerConfig = async (args: {\n\truntime: AnalyticsRuntime\n\treq: PayloadRequest\n}): Promise<TrackerConfig> => {\n\tconst { runtime, req } = args\n\tconst base = apiRoute(req)\n\t// One scope resolution for the whole config: the slots and the goals must agree on it,\n\t// and the host's resolver can be as expensive as a database read.\n\tconst scope = await scopeFor(runtime, req)\n\tconst slots: TrackerSlotConfig[] = []\n\tconst filled = new Set<string>()\n\tfor (const slot of CAPTURE_SLOTS) {\n\t\tconst adapter = await resolveSlotAdapterFor({ runtime, req, slot, scope })\n\t\tconst capture = adapter?.capture\n\t\tif (!adapter || !capture || filled.has(adapter.id)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst override = runtime.capturePaths?.[slot]\n\t\tconst path = override ? normalizeMountPath(override) : `${base}${PROXY_PATH}/${slot}`\n\t\tconst kind = capture.client.kind\n\t\ttry {\n\t\t\tslots.push({\n\t\t\t\tslot,\n\t\t\t\tkind,\n\t\t\t\tadapterId: adapter.id,\n\t\t\t\tpath,\n\t\t\t\tsnippet: capture.snippet({ path }),\n\t\t\t\tclient: capture.client,\n\t\t\t\trequiresConsent:\n\t\t\t\t\t(runtime.consentFor?.(slot, adapter.id, kind) ?? defaultConsentFor(kind)) === 'required',\n\t\t\t})\n\t\t\tfilled.add(adapter.id)\n\t\t} catch (err) {\n\t\t\treq.payload?.logger?.warn(\n\t\t\t\t`analytics: capture snippet for \"${adapter.id}\" failed, dropping the ${slot} slot: ${String(err)}`\n\t\t\t)\n\t\t}\n\t}\n\treturn {\n\t\tslots,\n\t\tautoCapture: runtime.autoCapture ?? DEFAULT_AUTO_CAPTURE,\n\t\tgoals: trackerGoals(await goalsFor(runtime, req, scope)),\n\t\tingestPath: `${base}${runtime.ingestPath ?? INGEST_PATH}`,\n\t}\n}\n"],"mappings":";;;;;;AAkCA,MAAM,YAAY,QAAgC,IAAI,SAAS,QAAQ,QAAQ,OAAO;AAEtF,MAAM,gBAAgB,WACpB,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,OAAO,OAAO,gBAAgB;CACxD;CACA;CACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;CACzB,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAChC,EAAE;;AAGH,MAAM,WAAW,OAAO,SAA2B,QAAgD;CAClG,IAAI;EACH,OAAO,MAAM,gBAAgB,SAAS,GAAG;CAC1C,SAAS,KAAK;EACb,IAAI,SAAS,QAAQ,KAAK,sDAAsD,OAAO,GAAG,GAAG;EAC7F,OAAO;CACR;AACD;;AAGA,MAAM,WAAW,OAChB,SACA,KACA,UACqB;CACrB,IAAI;EACH,OAAO,MAAM,gBAAgB,SAAS,KAAK,KAAK;CACjD,SAAS,KAAK;EACb,IAAI,SAAS,QAAQ,KACpB,oFAAoF,OAAO,GAAG,GAC/F;EACA,OAAO,QAAQ,SAAS,CAAC;CAC1B;AACD;;AAGA,MAAa,sBAAsB,SAAwC;CAC1E,OAAO,CAAC;CACR,aAAa;CACb,OAAO,CAAC;CACR,YAAY,GAAG,SAAS,GAAG,IAAI;AAChC;;;;;;;;;;;;;;AAeA,MAAa,uBAAuB,OAAO,SAGb;CAC7B,MAAM,EAAE,SAAS,QAAQ;CACzB,MAAM,OAAO,SAAS,GAAG;CAGzB,MAAM,QAAQ,MAAM,SAAS,SAAS,GAAG;CACzC,MAAM,QAA6B,CAAC;CACpC,MAAM,yBAAS,IAAI,IAAY;CAC/B,KAAK,MAAM,QAAQ,eAAe;EACjC,MAAM,UAAU,MAAM,sBAAsB;GAAE;GAAS;GAAK;GAAM;EAAM,CAAC;EACzE,MAAM,UAAU,SAAS;EACzB,IAAI,CAAC,WAAW,CAAC,WAAW,OAAO,IAAI,QAAQ,EAAE,GAChD;EAED,MAAM,WAAW,QAAQ,eAAe;EACxC,MAAM,OAAO,WAAW,mBAAmB,QAAQ,IAAI,GAAG,OAAO,WAAW,GAAG;EAC/E,MAAM,OAAO,QAAQ,OAAO;EAC5B,IAAI;GACH,MAAM,KAAK;IACV;IACA;IACA,WAAW,QAAQ;IACnB;IACA,SAAS,QAAQ,QAAQ,EAAE,KAAK,CAAC;IACjC,QAAQ,QAAQ;IAChB,kBACE,QAAQ,aAAa,MAAM,QAAQ,IAAI,IAAI,KAAK,kBAAkB,IAAI,OAAO;GAChF,CAAC;GACD,OAAO,IAAI,QAAQ,EAAE;EACtB,SAAS,KAAK;GACb,IAAI,SAAS,QAAQ,KACpB,mCAAmC,QAAQ,GAAG,yBAAyB,KAAK,SAAS,OAAO,GAAG,GAChG;EACD;CACD;CACA,OAAO;EACN;EACA,aAAa,QAAQ,eAAe;EACpC,OAAO,aAAa,MAAM,SAAS,SAAS,KAAK,KAAK,CAAC;EACvD,YAAY,GAAG,OAAO,QAAQ,cAAA;CAC/B;AACD"}
@@ -0,0 +1,35 @@
1
+ import { TRACKER_PATH } from "../plugin/paths.js";
2
+ import { getRuntime } from "../plugin/runtime.js";
3
+ import { emptyTrackerConfig, resolveTrackerConfig } from "./trackerConfig.js";
4
+ //#region src/capture/trackerEndpoint.ts
5
+ /**
6
+ * Public GET serving the browser tracker its per-request configuration. Like the capture
7
+ * proxy, it runs with no `req.user` and calls the host's `scopeResolver` on behalf of an
8
+ * anonymous visitor: a resolver that throws or resolves nothing leaves the tenant slot
9
+ * absent rather than failing the request, so a broken resolver degrades capture instead of
10
+ * breaking the page.
11
+ *
12
+ * The response is per-visitor and hostname-derived, never shared: `private` with a short
13
+ * max-age, `Vary: Host, Cookie` (a `scopeResolver` may read `req.user` or a tenant cookie,
14
+ * which makes the body cookie-dependent), and no cookie of its own.
15
+ */
16
+ const makeTrackerHandler = () => async (req) => {
17
+ const runtime = getRuntime(req.payload);
18
+ const config = runtime ? await resolveTrackerConfig({
19
+ runtime,
20
+ req
21
+ }) : emptyTrackerConfig(req);
22
+ return Response.json(config, { headers: {
23
+ "cache-control": "private, max-age=60",
24
+ vary: "Host, Cookie"
25
+ } });
26
+ };
27
+ const trackerEndpoint = () => ({
28
+ method: "get",
29
+ path: TRACKER_PATH,
30
+ handler: makeTrackerHandler()
31
+ });
32
+ //#endregion
33
+ export { trackerEndpoint };
34
+
35
+ //# sourceMappingURL=trackerEndpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trackerEndpoint.js","names":[],"sources":["../../src/capture/trackerEndpoint.ts"],"sourcesContent":["import type { Endpoint, PayloadHandler } from 'payload'\nimport { TRACKER_PATH } from '../plugin/paths'\nimport { getRuntime } from '../plugin/runtime'\nimport { emptyTrackerConfig, resolveTrackerConfig } from './trackerConfig'\n\nexport { TRACKER_PATH }\n\n/**\n * Public GET serving the browser tracker its per-request configuration. Like the capture\n * proxy, it runs with no `req.user` and calls the host's `scopeResolver` on behalf of an\n * anonymous visitor: a resolver that throws or resolves nothing leaves the tenant slot\n * absent rather than failing the request, so a broken resolver degrades capture instead of\n * breaking the page.\n *\n * The response is per-visitor and hostname-derived, never shared: `private` with a short\n * max-age, `Vary: Host, Cookie` (a `scopeResolver` may read `req.user` or a tenant cookie,\n * which makes the body cookie-dependent), and no cookie of its own.\n */\nexport const makeTrackerHandler = (): PayloadHandler => async (req) => {\n\tconst runtime = getRuntime(req.payload)\n\tconst config = runtime ? await resolveTrackerConfig({ runtime, req }) : emptyTrackerConfig(req)\n\treturn Response.json(config, {\n\t\theaders: { 'cache-control': 'private, max-age=60', vary: 'Host, Cookie' },\n\t})\n}\n\nexport const trackerEndpoint = (): Endpoint => ({\n\tmethod: 'get',\n\tpath: TRACKER_PATH,\n\thandler: makeTrackerHandler(),\n})\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,MAAM,SAAS,UAAU,MAAM,qBAAqB;EAAE;EAAS;CAAI,CAAC,IAAI,mBAAmB,GAAG;CAC9F,OAAO,SAAS,KAAK,QAAQ,EAC5B,SAAS;EAAE,iBAAiB;EAAuB,MAAM;CAAe,EACzE,CAAC;AACF;AAEA,MAAa,yBAAmC;CAC/C,QAAQ;CACR,MAAM;CACN,SAAS,mBAAmB;AAC7B"}
@@ -4,6 +4,19 @@ import { BarDatum } from "./bars.js";
4
4
  interface BarListProps {
5
5
  data: BarDatum[];
6
6
  emptyLabel: string;
7
+ /**
8
+ * Makes every row a button reporting its index, bar the rows marked unselectable. Left
9
+ * out, every row is inert: a source that cannot filter by the dimension must not offer a
10
+ * click that would do nothing.
11
+ */
12
+ onSelect?: (index: number) => void;
13
+ /**
14
+ * `solid` (the default) fills the bar with the chart color and puts a white label inside
15
+ * it, which reads as long as every row has a bar to sit on. `soft` pales the fill and
16
+ * moves the label onto the elevation ramp, for a list whose rows can be zero-valued (a
17
+ * goal with no pageviews), where a zero-width bar leaves a white label on bare track.
18
+ */
19
+ fill?: 'solid' | 'soft';
7
20
  }
8
21
  /**
9
22
  * Ranked horizontal bar list (shadcn "custom label" style): each row is a filled,
@@ -13,7 +26,9 @@ interface BarListProps {
13
26
  */
14
27
  declare function BarList({
15
28
  data,
16
- emptyLabel
29
+ emptyLabel,
30
+ onSelect,
31
+ fill
17
32
  }: BarListProps): import("react/jsx-runtime").JSX.Element;
18
33
  //#endregion
19
34
  export { BarList, BarListProps };
@@ -2,15 +2,41 @@
2
2
  import { toBarRows } from "./bars.js";
3
3
  import { ChartStyles } from "./styles.js";
4
4
  import { useState } from "react";
5
- import { jsx, jsxs } from "react/jsx-runtime";
5
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
6
6
  //#region src/charts/BarList.tsx
7
7
  /**
8
+ * Ranked rows are identified by rank, since two can share a label: a provider that answers an
9
+ * unattributed bucket as an empty string, or one that repeats a value. Keying on the label
10
+ * alone made those collide, and React strands the duplicates in the DOM across a rerender.
11
+ */
12
+ const rowKey = (row, i) => `${i}:${row.label}`;
13
+ const RowContent = ({ row }) => /* @__PURE__ */ jsxs(Fragment, { children: [
14
+ /* @__PURE__ */ jsxs("span", {
15
+ className: "analytics-bars__track",
16
+ children: [/* @__PURE__ */ jsx("span", {
17
+ className: "analytics-bars__fill",
18
+ style: { width: `${row.fraction * 100}%` }
19
+ }), /* @__PURE__ */ jsx("span", {
20
+ className: "analytics-bars__label",
21
+ children: row.label
22
+ })]
23
+ }),
24
+ /* @__PURE__ */ jsx("span", {
25
+ className: "analytics-bars__value",
26
+ children: row.display ?? row.value
27
+ }),
28
+ row.secondary === void 0 ? null : /* @__PURE__ */ jsx("span", {
29
+ className: "analytics-bars__secondary",
30
+ children: row.secondary
31
+ })
32
+ ] });
33
+ /**
8
34
  * Ranked horizontal bar list (shadcn "custom label" style): each row is a filled,
9
35
  * proportional bar with the label inside and the value outside; hovering a row lifts
10
36
  * it and shows a tooltip with the full label and value (useful when the label is
11
37
  * truncated). Dependency-free; styling comes from the shared chart stylesheet.
12
38
  */
13
- function BarList({ data, emptyLabel }) {
39
+ function BarList({ data, emptyLabel, onSelect, fill = "solid" }) {
14
40
  const rows = toBarRows(data);
15
41
  const [hover, setHover] = useState(null);
16
42
  if (rows.length === 0) return /* @__PURE__ */ jsx("span", {
@@ -28,26 +54,22 @@ function BarList({ data, emptyLabel }) {
28
54
  children: [
29
55
  /* @__PURE__ */ jsx(ChartStyles, {}),
30
56
  /* @__PURE__ */ jsx("div", {
31
- className: "analytics-bars",
32
- children: rows.map((row, i) => /* @__PURE__ */ jsxs("div", {
33
- className: "analytics-bars__row",
57
+ className: `analytics-bars${fill === "soft" ? " analytics-bars--soft" : ""}`,
58
+ children: rows.map((row, i) => onSelect && row.selectable !== false ? /* @__PURE__ */ jsx("button", {
59
+ className: "analytics-bars__row analytics-bars__row--action",
60
+ onClick: () => onSelect(i),
34
61
  onPointerEnter: track(i),
62
+ onPointerLeave: () => setHover(null),
35
63
  onPointerMove: track(i),
64
+ type: "button",
65
+ children: /* @__PURE__ */ jsx(RowContent, { row })
66
+ }, rowKey(row, i)) : /* @__PURE__ */ jsx("div", {
67
+ className: "analytics-bars__row",
68
+ onPointerEnter: track(i),
36
69
  onPointerLeave: () => setHover(null),
37
- children: [/* @__PURE__ */ jsxs("span", {
38
- className: "analytics-bars__track",
39
- children: [/* @__PURE__ */ jsx("span", {
40
- className: "analytics-bars__fill",
41
- style: { width: `${row.fraction * 100}%` }
42
- }), /* @__PURE__ */ jsx("span", {
43
- className: "analytics-bars__label",
44
- children: row.label
45
- })]
46
- }), /* @__PURE__ */ jsx("span", {
47
- className: "analytics-bars__value",
48
- children: row.display ?? row.value
49
- })]
50
- }, row.label))
70
+ onPointerMove: track(i),
71
+ children: /* @__PURE__ */ jsx(RowContent, { row })
72
+ }, rowKey(row, i)))
51
73
  }),
52
74
  hover && hovered ? /* @__PURE__ */ jsxs("div", {
53
75
  className: "analytics-chart__tooltip",
@@ -1 +1 @@
1
- {"version":3,"file":"BarList.js","names":[],"sources":["../../src/charts/BarList.tsx"],"sourcesContent":["'use client'\n\nimport { type PointerEvent, useState } from 'react'\nimport { type BarDatum, toBarRows } from './bars'\nimport { ChartStyles } from './styles'\n\nexport interface BarListProps {\n\tdata: BarDatum[]\n\temptyLabel: string\n}\n\ninterface Hover {\n\ti: number\n\tx: number\n\ty: number\n}\n\n/**\n * Ranked horizontal bar list (shadcn \"custom label\" style): each row is a filled,\n * proportional bar with the label inside and the value outside; hovering a row lifts\n * it and shows a tooltip with the full label and value (useful when the label is\n * truncated). Dependency-free; styling comes from the shared chart stylesheet.\n */\nexport function BarList({ data, emptyLabel }: BarListProps) {\n\tconst rows = toBarRows(data)\n\tconst [hover, setHover] = useState<Hover | null>(null)\n\tif (rows.length === 0) {\n\t\treturn <span className=\"analytics-bars__empty\">{emptyLabel}</span>\n\t}\n\tconst track = (i: number) => (e: PointerEvent<HTMLDivElement>) =>\n\t\tsetHover({ i, x: e.clientX, y: e.clientY })\n\tconst hovered = hover ? rows[hover.i] : undefined\n\treturn (\n\t\t<div className=\"analytics-chart\">\n\t\t\t<ChartStyles />\n\t\t\t<div className=\"analytics-bars\">\n\t\t\t\t{rows.map((row, i) => (\n\t\t\t\t\t<div\n\t\t\t\t\t\tkey={row.label}\n\t\t\t\t\t\tclassName=\"analytics-bars__row\"\n\t\t\t\t\t\tonPointerEnter={track(i)}\n\t\t\t\t\t\tonPointerMove={track(i)}\n\t\t\t\t\t\tonPointerLeave={() => setHover(null)}\n\t\t\t\t\t>\n\t\t\t\t\t\t<span className=\"analytics-bars__track\">\n\t\t\t\t\t\t\t<span className=\"analytics-bars__fill\" style={{ width: `${row.fraction * 100}%` }} />\n\t\t\t\t\t\t\t<span className=\"analytics-bars__label\">{row.label}</span>\n\t\t\t\t\t\t</span>\n\t\t\t\t\t\t<span className=\"analytics-bars__value\">{row.display ?? row.value}</span>\n\t\t\t\t\t</div>\n\t\t\t\t))}\n\t\t\t</div>\n\t\t\t{hover && hovered ? (\n\t\t\t\t<div\n\t\t\t\t\tclassName=\"analytics-chart__tooltip\"\n\t\t\t\t\tstyle={{ position: 'fixed', left: hover.x, top: hover.y }}\n\t\t\t\t>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-label\">{hovered.label}</div>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-value\">{hovered.display ?? hovered.value}</div>\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,SAAgB,QAAQ,EAAE,MAAM,cAA4B;CAC3D,MAAM,OAAO,UAAU,IAAI;CAC3B,MAAM,CAAC,OAAO,YAAY,SAAuB,IAAI;CACrD,IAAI,KAAK,WAAW,GACnB,OAAO,oBAAC,QAAD;EAAM,WAAU;YAAyB;CAAiB,CAAA;CAElE,MAAM,SAAS,OAAe,MAC7B,SAAS;EAAE;EAAG,GAAG,EAAE;EAAS,GAAG,EAAE;CAAQ,CAAC;CAC3C,MAAM,UAAU,QAAQ,KAAK,MAAM,KAAK,KAAA;CACxC,OACC,qBAAC,OAAD;EAAK,WAAU;YAAf;GACC,oBAAC,aAAD,CAAc,CAAA;GACd,oBAAC,OAAD;IAAK,WAAU;cACb,KAAK,KAAK,KAAK,MACf,qBAAC,OAAD;KAEC,WAAU;KACV,gBAAgB,MAAM,CAAC;KACvB,eAAe,MAAM,CAAC;KACtB,sBAAsB,SAAS,IAAI;eALpC,CAOC,qBAAC,QAAD;MAAM,WAAU;gBAAhB,CACC,oBAAC,QAAD;OAAM,WAAU;OAAuB,OAAO,EAAE,OAAO,GAAG,IAAI,WAAW,IAAI,GAAG;MAAI,CAAA,GACpF,oBAAC,QAAD;OAAM,WAAU;iBAAyB,IAAI;MAAY,CAAA,CACpD;SACN,oBAAC,QAAD;MAAM,WAAU;gBAAyB,IAAI,WAAW,IAAI;KAAY,CAAA,CACpE;OAXC,IAAI,KAWL,CACL;GACG,CAAA;GACJ,SAAS,UACT,qBAAC,OAAD;IACC,WAAU;IACV,OAAO;KAAE,UAAU;KAAS,MAAM,MAAM;KAAG,KAAK,MAAM;IAAE;cAFzD,CAIC,oBAAC,OAAD;KAAK,WAAU;eAAkC,QAAQ;IAAW,CAAA,GACpE,oBAAC,OAAD;KAAK,WAAU;eAAkC,QAAQ,WAAW,QAAQ;IAAW,CAAA,CACnF;QACF;EACA;;AAEP"}
1
+ {"version":3,"file":"BarList.js","names":[],"sources":["../../src/charts/BarList.tsx"],"sourcesContent":["'use client'\n\nimport { type PointerEvent, type ReactNode, useState } from 'react'\nimport { type BarDatum, type BarRow, toBarRows } from './bars'\nimport { ChartStyles } from './styles'\n\nexport interface BarListProps {\n\tdata: BarDatum[]\n\temptyLabel: string\n\t/**\n\t * Makes every row a button reporting its index, bar the rows marked unselectable. Left\n\t * out, every row is inert: a source that cannot filter by the dimension must not offer a\n\t * click that would do nothing.\n\t */\n\tonSelect?: (index: number) => void\n\t/**\n\t * `solid` (the default) fills the bar with the chart color and puts a white label inside\n\t * it, which reads as long as every row has a bar to sit on. `soft` pales the fill and\n\t * moves the label onto the elevation ramp, for a list whose rows can be zero-valued (a\n\t * goal with no pageviews), where a zero-width bar leaves a white label on bare track.\n\t */\n\tfill?: 'solid' | 'soft'\n}\n\ninterface Hover {\n\ti: number\n\tx: number\n\ty: number\n}\n\n/**\n * Ranked rows are identified by rank, since two can share a label: a provider that answers an\n * unattributed bucket as an empty string, or one that repeats a value. Keying on the label\n * alone made those collide, and React strands the duplicates in the DOM across a rerender.\n */\nconst rowKey = (row: BarRow, i: number): string => `${i}:${row.label}`\n\nconst RowContent = ({ row }: { row: BarRow }): ReactNode => (\n\t<>\n\t\t<span className=\"analytics-bars__track\">\n\t\t\t<span className=\"analytics-bars__fill\" style={{ width: `${row.fraction * 100}%` }} />\n\t\t\t<span className=\"analytics-bars__label\">{row.label}</span>\n\t\t</span>\n\t\t<span className=\"analytics-bars__value\">{row.display ?? row.value}</span>\n\t\t{row.secondary === undefined ? null : (\n\t\t\t<span className=\"analytics-bars__secondary\">{row.secondary}</span>\n\t\t)}\n\t</>\n)\n\n/**\n * Ranked horizontal bar list (shadcn \"custom label\" style): each row is a filled,\n * proportional bar with the label inside and the value outside; hovering a row lifts\n * it and shows a tooltip with the full label and value (useful when the label is\n * truncated). Dependency-free; styling comes from the shared chart stylesheet.\n */\nexport function BarList({ data, emptyLabel, onSelect, fill = 'solid' }: BarListProps) {\n\tconst rows = toBarRows(data)\n\tconst [hover, setHover] = useState<Hover | null>(null)\n\tif (rows.length === 0) {\n\t\treturn <span className=\"analytics-bars__empty\">{emptyLabel}</span>\n\t}\n\tconst track = (i: number) => (e: PointerEvent<HTMLElement>) =>\n\t\tsetHover({ i, x: e.clientX, y: e.clientY })\n\tconst hovered = hover ? rows[hover.i] : undefined\n\treturn (\n\t\t<div className=\"analytics-chart\">\n\t\t\t<ChartStyles />\n\t\t\t<div className={`analytics-bars${fill === 'soft' ? ' analytics-bars--soft' : ''}`}>\n\t\t\t\t{rows.map((row, i) =>\n\t\t\t\t\tonSelect && row.selectable !== false ? (\n\t\t\t\t\t\t<button\n\t\t\t\t\t\t\tclassName=\"analytics-bars__row analytics-bars__row--action\"\n\t\t\t\t\t\t\tkey={rowKey(row, i)}\n\t\t\t\t\t\t\tonClick={() => onSelect(i)}\n\t\t\t\t\t\t\tonPointerEnter={track(i)}\n\t\t\t\t\t\t\tonPointerLeave={() => setHover(null)}\n\t\t\t\t\t\t\tonPointerMove={track(i)}\n\t\t\t\t\t\t\ttype=\"button\"\n\t\t\t\t\t\t>\n\t\t\t\t\t\t\t<RowContent row={row} />\n\t\t\t\t\t\t</button>\n\t\t\t\t\t) : (\n\t\t\t\t\t\t<div\n\t\t\t\t\t\t\tclassName=\"analytics-bars__row\"\n\t\t\t\t\t\t\tkey={rowKey(row, i)}\n\t\t\t\t\t\t\tonPointerEnter={track(i)}\n\t\t\t\t\t\t\tonPointerLeave={() => setHover(null)}\n\t\t\t\t\t\t\tonPointerMove={track(i)}\n\t\t\t\t\t\t>\n\t\t\t\t\t\t\t<RowContent row={row} />\n\t\t\t\t\t\t</div>\n\t\t\t\t\t)\n\t\t\t\t)}\n\t\t\t</div>\n\t\t\t{hover && hovered ? (\n\t\t\t\t<div\n\t\t\t\t\tclassName=\"analytics-chart__tooltip\"\n\t\t\t\t\tstyle={{ position: 'fixed', left: hover.x, top: hover.y }}\n\t\t\t\t>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-label\">{hovered.label}</div>\n\t\t\t\t\t<div className=\"analytics-chart__tooltip-value\">{hovered.display ?? hovered.value}</div>\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;;;;AAmCA,MAAM,UAAU,KAAa,MAAsB,GAAG,EAAE,GAAG,IAAI;AAE/D,MAAM,cAAc,EAAE,UACrB,qBAAA,UAAA,EAAA,UAAA;CACC,qBAAC,QAAD;EAAM,WAAU;YAAhB,CACC,oBAAC,QAAD;GAAM,WAAU;GAAuB,OAAO,EAAE,OAAO,GAAG,IAAI,WAAW,IAAI,GAAG;EAAI,CAAA,GACpF,oBAAC,QAAD;GAAM,WAAU;aAAyB,IAAI;EAAY,CAAA,CACpD;;CACN,oBAAC,QAAD;EAAM,WAAU;YAAyB,IAAI,WAAW,IAAI;CAAY,CAAA;CACvE,IAAI,cAAc,KAAA,IAAY,OAC9B,oBAAC,QAAD;EAAM,WAAU;YAA6B,IAAI;CAAgB,CAAA;AAEjE,EAAA,CAAA;;;;;;;AASH,SAAgB,QAAQ,EAAE,MAAM,YAAY,UAAU,OAAO,WAAyB;CACrF,MAAM,OAAO,UAAU,IAAI;CAC3B,MAAM,CAAC,OAAO,YAAY,SAAuB,IAAI;CACrD,IAAI,KAAK,WAAW,GACnB,OAAO,oBAAC,QAAD;EAAM,WAAU;YAAyB;CAAiB,CAAA;CAElE,MAAM,SAAS,OAAe,MAC7B,SAAS;EAAE;EAAG,GAAG,EAAE;EAAS,GAAG,EAAE;CAAQ,CAAC;CAC3C,MAAM,UAAU,QAAQ,KAAK,MAAM,KAAK,KAAA;CACxC,OACC,qBAAC,OAAD;EAAK,WAAU;YAAf;GACC,oBAAC,aAAD,CAAc,CAAA;GACd,oBAAC,OAAD;IAAK,WAAW,iBAAiB,SAAS,SAAS,0BAA0B;cAC3E,KAAK,KAAK,KAAK,MACf,YAAY,IAAI,eAAe,QAC9B,oBAAC,UAAD;KACC,WAAU;KAEV,eAAe,SAAS,CAAC;KACzB,gBAAgB,MAAM,CAAC;KACvB,sBAAsB,SAAS,IAAI;KACnC,eAAe,MAAM,CAAC;KACtB,MAAK;eAEL,oBAAC,YAAD,EAAiB,IAAM,CAAA;IAChB,GARF,OAAO,KAAK,CAAC,CAQX,IAER,oBAAC,OAAD;KACC,WAAU;KAEV,gBAAgB,MAAM,CAAC;KACvB,sBAAsB,SAAS,IAAI;KACnC,eAAe,MAAM,CAAC;eAEtB,oBAAC,YAAD,EAAiB,IAAM,CAAA;IACnB,GANC,OAAO,KAAK,CAAC,CAMd,CAEP;GACI,CAAA;GACJ,SAAS,UACT,qBAAC,OAAD;IACC,WAAU;IACV,OAAO;KAAE,UAAU;KAAS,MAAM,MAAM;KAAG,KAAK,MAAM;IAAE;cAFzD,CAIC,oBAAC,OAAD;KAAK,WAAU;eAAkC,QAAQ;IAAW,CAAA,GACpE,oBAAC,OAAD;KAAK,WAAU;eAAkC,QAAQ,WAAW,QAAQ;IAAW,CAAA,CACnF;QACF;EACA;;AAEP"}
@@ -6,20 +6,33 @@ interface TrendPoint {
6
6
  }
7
7
  interface TrendChartProps {
8
8
  buckets: TrendPoint[];
9
+ /** Previous-period series drawn on the same axes, aligned to `buckets` by index. */
10
+ comparison?: TrendPoint[];
11
+ /** Names the comparison series in the legend and the tooltip; keep it short. */
12
+ comparisonLabel?: string;
13
+ /** The comparison window, shown in the legend only, so the tooltip stays narrow. */
14
+ comparisonRange?: string;
15
+ /** Names the primary series in the legend; the legend only renders with a comparison. */
16
+ label?: string;
9
17
  ariaLabel: string;
10
18
  minHeight?: number;
11
19
  }
12
20
  /**
13
21
  * Gradient area trend chart: a monotone-cubic line over a themed gradient fill, with
14
22
  * gridlines, dots (when sparse), timeframe-aware x-axis labels, and a pointer-tracked
15
- * tooltip. Dependency-free; sizes to its container via a ResizeObserver so dots and
16
- * labels stay crisp (no aspect-ratio distortion).
23
+ * tooltip. An optional `comparison` series overlays the previous period as a muted line
24
+ * on a y-scale covering both. Dependency-free; sizes to its container via a
25
+ * ResizeObserver so dots and labels stay crisp (no aspect-ratio distortion).
17
26
  */
18
27
  declare function TrendChart({
19
28
  buckets,
29
+ comparison,
30
+ comparisonLabel,
31
+ comparisonRange,
32
+ label,
20
33
  ariaLabel,
21
34
  minHeight
22
35
  }: TrendChartProps): import("react/jsx-runtime").JSX.Element;
23
36
  //#endregion
24
- export { TrendChart, TrendChartProps };
37
+ export { TrendChart, TrendChartProps, TrendPoint };
25
38
  //# sourceMappingURL=TrendChart.d.ts.map
@@ -18,18 +18,27 @@ const GRID = [
18
18
  .5,
19
19
  .75
20
20
  ];
21
+ const DOT_LIMIT = 12;
21
22
  const tickIndices = (n) => {
22
23
  if (n <= MAX_TICKS) return Array.from({ length: n }, (_, i) => i);
23
24
  const step = (n - 1) / (MAX_TICKS - 1);
24
25
  return Array.from({ length: MAX_TICKS }, (_, i) => Math.round(i * step));
25
26
  };
27
+ const EMPTY_POINT = {
28
+ label: "",
29
+ value: 0,
30
+ display: "0"
31
+ };
32
+ /** Both windows have equal bucket counts by construction; a stray length normalizes silently. */
33
+ const alignTo = (series, length) => series.length === length ? series : Array.from({ length }, (_, i) => series[i] ?? { ...EMPTY_POINT });
26
34
  /**
27
35
  * Gradient area trend chart: a monotone-cubic line over a themed gradient fill, with
28
36
  * gridlines, dots (when sparse), timeframe-aware x-axis labels, and a pointer-tracked
29
- * tooltip. Dependency-free; sizes to its container via a ResizeObserver so dots and
30
- * labels stay crisp (no aspect-ratio distortion).
37
+ * tooltip. An optional `comparison` series overlays the previous period as a muted line
38
+ * on a y-scale covering both. Dependency-free; sizes to its container via a
39
+ * ResizeObserver so dots and labels stay crisp (no aspect-ratio distortion).
31
40
  */
32
- function TrendChart({ buckets, ariaLabel, minHeight = 160 }) {
41
+ function TrendChart({ buckets, comparison, comparisonLabel, comparisonRange, label, ariaLabel, minHeight = 160 }) {
33
42
  const ref = useRef(null);
34
43
  const [size, setSize] = useState({
35
44
  w: 600,
@@ -61,16 +70,25 @@ function TrendChart({ buckets, ariaLabel, minHeight = 160 }) {
61
70
  const height = size.h;
62
71
  const values = buckets.map((b) => b.value);
63
72
  const n = values.length;
73
+ const previous = comparison ? alignTo(comparison, n) : void 0;
74
+ const previousValues = previous?.map((p) => p.value);
64
75
  const plotW = Math.max(1, width - MARGIN.left - MARGIN.right);
65
76
  const plotH = Math.max(1, height - MARGIN.top - MARGIN.bottom);
66
- const { line, area } = monotoneAreaPath(values, {
77
+ const scaled = previousValues ? [...values, ...previousValues] : values;
78
+ const vmax = n > 0 ? Math.max(...scaled) : 0;
79
+ const vmin = n > 0 ? Math.min(...scaled) : 0;
80
+ const vspan = vmax - vmin || 1;
81
+ const geometry = {
67
82
  width: plotW,
68
83
  height: plotH,
69
- padding: PAD
70
- });
71
- const vmax = n > 0 ? Math.max(...values) : 0;
72
- const vmin = n > 0 ? Math.min(...values) : 0;
73
- const vspan = vmax - vmin || 1;
84
+ padding: PAD,
85
+ domain: {
86
+ min: vmin,
87
+ max: vmax
88
+ }
89
+ };
90
+ const { line, area } = monotoneAreaPath(values, geometry);
91
+ const previousLine = previousValues ? monotoneAreaPath(previousValues, geometry).line : "";
74
92
  const px = (i) => n > 1 ? i / (n - 1) * plotW : plotW / 2;
75
93
  const py = (v) => vmax === vmin ? plotH / 2 : PAD + (plotH - PAD * 2) - (v - vmin) / vspan * (plotH - PAD * 2);
76
94
  const onMove = (e) => {
@@ -81,111 +99,159 @@ function TrendChart({ buckets, ariaLabel, minHeight = 160 }) {
81
99
  };
82
100
  const activeValue = active !== null ? values[active] ?? 0 : 0;
83
101
  return /* @__PURE__ */ jsxs("div", {
84
- ref,
85
102
  className: "analytics-chart",
86
103
  style: {
87
104
  flex: "1 1 0",
88
105
  minHeight
89
106
  },
90
- onPointerMove: onMove,
91
- onPointerLeave: () => setActive(null),
92
107
  children: [
93
108
  /* @__PURE__ */ jsx(ChartStyles, {}),
94
- measured ? /* @__PURE__ */ jsxs("svg", {
95
- className: "analytics-chart__svg",
96
- width,
97
- height,
98
- role: "img",
99
- "aria-label": ariaLabel,
100
- children: [
101
- /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("linearGradient", {
102
- id: gradientId,
103
- x1: "0",
104
- y1: "0",
105
- x2: "0",
106
- y2: "1",
107
- children: [
108
- /* @__PURE__ */ jsx("stop", {
109
- offset: "0%",
110
- stopColor: "var(--analytics-chart-1)",
111
- stopOpacity: "0.38"
112
- }),
113
- /* @__PURE__ */ jsx("stop", {
114
- offset: "55%",
115
- stopColor: "var(--analytics-chart-1)",
116
- stopOpacity: "0.1"
117
- }),
118
- /* @__PURE__ */ jsx("stop", {
119
- offset: "100%",
120
- stopColor: "var(--analytics-chart-1)",
121
- stopOpacity: "0"
122
- })
123
- ]
124
- }) }),
125
- /* @__PURE__ */ jsxs("g", {
126
- transform: `translate(${MARGIN.left},${MARGIN.top})`,
127
- children: [
128
- GRID.map((g) => /* @__PURE__ */ jsx("line", {
129
- className: "analytics-chart__grid",
130
- x1: 0,
131
- x2: plotW,
132
- y1: g * plotH,
133
- y2: g * plotH
134
- }, g)),
135
- area ? /* @__PURE__ */ jsx("path", {
136
- className: "analytics-chart__area",
137
- d: area,
138
- fill: `url(#${gradientId})`
139
- }) : null,
140
- line ? /* @__PURE__ */ jsx("path", {
141
- className: "analytics-chart__line",
142
- d: line
143
- }) : null,
144
- n <= 12 ? values.map((v, i) => /* @__PURE__ */ jsx("circle", {
145
- className: "analytics-chart__dot",
146
- cx: px(i),
147
- cy: py(v),
148
- r: 2.5
149
- }, buckets[i]?.label ?? i)) : null,
150
- active !== null ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("line", {
151
- className: "analytics-chart__cursor",
152
- x1: px(active),
153
- x2: px(active),
154
- y1: 0,
155
- y2: plotH
156
- }), /* @__PURE__ */ jsx("circle", {
157
- className: "analytics-chart__active",
158
- cx: px(active),
159
- cy: py(activeValue),
160
- r: 3.5
161
- })] }) : null
162
- ]
163
- }),
164
- /* @__PURE__ */ jsx("g", {
165
- transform: `translate(${MARGIN.left},${height - 4})`,
166
- children: tickIndices(n).map((i) => /* @__PURE__ */ jsx("text", {
167
- className: "analytics-chart__axis",
168
- x: px(i),
169
- textAnchor: i === 0 ? "start" : i === n - 1 ? "end" : "middle",
170
- children: buckets[i]?.label
171
- }, buckets[i]?.label ?? i))
172
- })
173
- ]
174
- }) : null,
175
- active !== null ? /* @__PURE__ */ jsxs("div", {
176
- className: "analytics-chart__tooltip",
177
- style: {
178
- left: MARGIN.left + px(active),
179
- top: MARGIN.top + py(activeValue)
180
- },
181
- children: [/* @__PURE__ */ jsx("div", {
182
- className: "analytics-chart__tooltip-label",
183
- children: buckets[active]?.label
184
- }), /* @__PURE__ */ jsx("div", {
185
- className: "analytics-chart__tooltip-value",
186
- children: buckets[active]?.display
109
+ previous ? /* @__PURE__ */ jsxs("div", {
110
+ className: "analytics-chart__legend",
111
+ children: [/* @__PURE__ */ jsxs("span", {
112
+ className: "analytics-chart__legend-item",
113
+ children: [/* @__PURE__ */ jsx("span", { className: "analytics-chart__legend-swatch" }), label]
114
+ }), /* @__PURE__ */ jsxs("span", {
115
+ className: "analytics-chart__legend-item",
116
+ children: [
117
+ /* @__PURE__ */ jsx("span", { className: "analytics-chart__legend-swatch analytics-chart__legend-swatch--comparison" }),
118
+ comparisonLabel,
119
+ comparisonRange ? /* @__PURE__ */ jsx("span", {
120
+ className: "analytics-chart__legend-range",
121
+ children: `· ${comparisonRange}`
122
+ }) : null
123
+ ]
187
124
  })]
188
- }) : null
125
+ }) : null,
126
+ /* @__PURE__ */ jsxs("div", {
127
+ ref,
128
+ className: "analytics-chart__plot",
129
+ onPointerMove: onMove,
130
+ onPointerLeave: () => setActive(null),
131
+ children: [measured ? /* @__PURE__ */ jsxs("svg", {
132
+ className: "analytics-chart__svg",
133
+ width,
134
+ height,
135
+ role: "img",
136
+ "aria-label": ariaLabel,
137
+ children: [
138
+ /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("linearGradient", {
139
+ id: gradientId,
140
+ x1: "0",
141
+ y1: "0",
142
+ x2: "0",
143
+ y2: "1",
144
+ children: [
145
+ /* @__PURE__ */ jsx("stop", {
146
+ offset: "0%",
147
+ stopColor: "var(--analytics-chart-1)",
148
+ stopOpacity: "0.38"
149
+ }),
150
+ /* @__PURE__ */ jsx("stop", {
151
+ offset: "55%",
152
+ stopColor: "var(--analytics-chart-1)",
153
+ stopOpacity: "0.1"
154
+ }),
155
+ /* @__PURE__ */ jsx("stop", {
156
+ offset: "100%",
157
+ stopColor: "var(--analytics-chart-1)",
158
+ stopOpacity: "0"
159
+ })
160
+ ]
161
+ }) }),
162
+ /* @__PURE__ */ jsxs("g", {
163
+ transform: `translate(${MARGIN.left},${MARGIN.top})`,
164
+ children: [
165
+ GRID.map((g) => /* @__PURE__ */ jsx("line", {
166
+ className: "analytics-chart__grid",
167
+ x1: 0,
168
+ x2: plotW,
169
+ y1: g * plotH,
170
+ y2: g * plotH
171
+ }, g)),
172
+ area ? /* @__PURE__ */ jsx("path", {
173
+ className: "analytics-chart__area",
174
+ d: area,
175
+ fill: `url(#${gradientId})`
176
+ }) : null,
177
+ previousLine ? /* @__PURE__ */ jsx("path", {
178
+ className: "analytics-chart__comparison",
179
+ d: previousLine
180
+ }) : null,
181
+ line ? /* @__PURE__ */ jsx("path", {
182
+ className: "analytics-chart__line",
183
+ d: line
184
+ }) : null,
185
+ n <= DOT_LIMIT ? (previousValues ?? []).map((v, i) => /* @__PURE__ */ jsx("circle", {
186
+ className: "analytics-chart__dot analytics-chart__dot--comparison",
187
+ cx: px(i),
188
+ cy: py(v),
189
+ r: 2.5
190
+ }, `previous-${buckets[i]?.label ?? i}`)) : null,
191
+ n <= DOT_LIMIT ? values.map((v, i) => /* @__PURE__ */ jsx("circle", {
192
+ className: "analytics-chart__dot",
193
+ cx: px(i),
194
+ cy: py(v),
195
+ r: 2.5
196
+ }, buckets[i]?.label ?? i)) : null,
197
+ active !== null ? /* @__PURE__ */ jsxs(Fragment, { children: [
198
+ /* @__PURE__ */ jsx("line", {
199
+ className: "analytics-chart__cursor",
200
+ x1: px(active),
201
+ x2: px(active),
202
+ y1: 0,
203
+ y2: plotH
204
+ }),
205
+ previous ? /* @__PURE__ */ jsx("circle", {
206
+ className: "analytics-chart__active analytics-chart__active--comparison",
207
+ cx: px(active),
208
+ cy: py(previous[active]?.value ?? 0),
209
+ r: 3
210
+ }) : null,
211
+ /* @__PURE__ */ jsx("circle", {
212
+ className: "analytics-chart__active",
213
+ cx: px(active),
214
+ cy: py(activeValue),
215
+ r: 3.5
216
+ })
217
+ ] }) : null
218
+ ]
219
+ }),
220
+ /* @__PURE__ */ jsx("g", {
221
+ transform: `translate(${MARGIN.left},${height - 4})`,
222
+ children: tickIndices(n).map((i) => /* @__PURE__ */ jsx("text", {
223
+ className: "analytics-chart__axis",
224
+ x: px(i),
225
+ textAnchor: i === 0 ? "start" : i === n - 1 ? "end" : "middle",
226
+ children: buckets[i]?.label
227
+ }, buckets[i]?.label ?? i))
228
+ })
229
+ ]
230
+ }) : null, active !== null ? /* @__PURE__ */ jsxs("div", {
231
+ className: "analytics-chart__tooltip",
232
+ style: {
233
+ left: MARGIN.left + px(active),
234
+ top: MARGIN.top + py(activeValue)
235
+ },
236
+ children: [
237
+ /* @__PURE__ */ jsx("div", {
238
+ className: "analytics-chart__tooltip-label",
239
+ children: buckets[active]?.label
240
+ }),
241
+ /* @__PURE__ */ jsx("div", {
242
+ className: "analytics-chart__tooltip-value",
243
+ children: buckets[active]?.display
244
+ }),
245
+ previous ? /* @__PURE__ */ jsxs("div", {
246
+ className: "analytics-chart__tooltip-comparison",
247
+ children: [/* @__PURE__ */ jsx("span", { children: comparisonLabel }), /* @__PURE__ */ jsx("span", {
248
+ className: "analytics-chart__tooltip-previous",
249
+ children: previous[active]?.display
250
+ })]
251
+ }) : null
252
+ ]
253
+ }) : null]
254
+ })
189
255
  ]
190
256
  });
191
257
  }