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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (368) hide show
  1. package/CHANGELOG.md +118 -0
  2. package/LICENSE +21 -21
  3. package/README.md +10 -4
  4. package/dist/adapters/ga4/eventName.d.ts +15 -0
  5. package/dist/adapters/ga4/eventName.js +19 -0
  6. package/dist/adapters/ga4/eventName.js.map +1 -0
  7. package/dist/adapters/ga4/ga4.d.ts +5 -0
  8. package/dist/adapters/ga4/ga4.js +179 -70
  9. package/dist/adapters/ga4/ga4.js.map +1 -1
  10. package/dist/adapters/ga4/measurementId.js +15 -0
  11. package/dist/adapters/ga4/measurementId.js.map +1 -0
  12. package/dist/adapters/goalRead.js +126 -0
  13. package/dist/adapters/goalRead.js.map +1 -0
  14. package/dist/adapters/plausible/plausible.d.ts +15 -0
  15. package/dist/adapters/plausible/plausible.js +112 -43
  16. package/dist/adapters/plausible/plausible.js.map +1 -1
  17. package/dist/adapters/posthog/posthog.js +47 -25
  18. package/dist/adapters/posthog/posthog.js.map +1 -1
  19. package/dist/adapters/umami/umami.d.ts +8 -0
  20. package/dist/adapters/umami/umami.js +237 -28
  21. package/dist/adapters/umami/umami.js.map +1 -1
  22. package/dist/capture/slots.js +16 -5
  23. package/dist/capture/slots.js.map +1 -1
  24. package/dist/capture/trackerConfig.d.ts +1 -0
  25. package/dist/capture/trackerConfig.js +28 -3
  26. package/dist/capture/trackerConfig.js.map +1 -1
  27. package/dist/charts/BarList.d.ts +15 -1
  28. package/dist/charts/BarList.js +41 -19
  29. package/dist/charts/BarList.js.map +1 -1
  30. package/dist/charts/TrendChart.d.ts +16 -3
  31. package/dist/charts/TrendChart.js +172 -106
  32. package/dist/charts/TrendChart.js.map +1 -1
  33. package/dist/charts/bars.d.ts +2 -0
  34. package/dist/charts/bars.js +2 -1
  35. package/dist/charts/bars.js.map +1 -1
  36. package/dist/charts/bucket.js +10 -1
  37. package/dist/charts/bucket.js.map +1 -1
  38. package/dist/charts/spline.js +2 -2
  39. package/dist/charts/spline.js.map +1 -1
  40. package/dist/charts/styles.js +18 -1
  41. package/dist/charts/styles.js.map +1 -1
  42. package/dist/core/cacheKey.js +24 -2
  43. package/dist/core/cacheKey.js.map +1 -1
  44. package/dist/core/capabilities.js +7 -2
  45. package/dist/core/capabilities.js.map +1 -1
  46. package/dist/core/capture.d.ts +1 -1
  47. package/dist/core/contract.d.ts +46 -9
  48. package/dist/core/contract.js +29 -1
  49. package/dist/core/contract.js.map +1 -1
  50. package/dist/core/granularity.js +1 -1
  51. package/dist/core/options.d.ts +62 -7
  52. package/dist/core/options.js +63 -4
  53. package/dist/core/options.js.map +1 -1
  54. package/dist/core/scopedRead.js +33 -23
  55. package/dist/core/scopedRead.js.map +1 -1
  56. package/dist/core/serverEvent.d.ts +44 -0
  57. package/dist/core/serverEvent.js +12 -0
  58. package/dist/core/serverEvent.js.map +1 -0
  59. package/dist/exports/adapters/ga4.d.ts +2 -1
  60. package/dist/exports/adapters/ga4.js +2 -1
  61. package/dist/exports/client.d.ts +12 -3
  62. package/dist/exports/client.js +9 -1
  63. package/dist/exports/rsc.d.ts +7 -2
  64. package/dist/exports/rsc.js +6 -3
  65. package/dist/exports/tracker.d.ts +3 -2
  66. package/dist/exports/tracker.js +2 -1
  67. package/dist/exports/types.d.ts +13 -4
  68. package/dist/exports/types.js +3 -2
  69. package/dist/fields/AnalyticsPanelClient.js +1 -1
  70. package/dist/fields/AnalyticsPanelField.js +1 -1
  71. package/dist/fields/AnalyticsStatField.js +2 -2
  72. package/dist/fields/config/FilterDimensionSelectField.d.ts +14 -0
  73. package/dist/fields/config/FilterDimensionSelectField.js +77 -0
  74. package/dist/fields/config/FilterDimensionSelectField.js.map +1 -0
  75. package/dist/fields/config/FilterOperatorSelectField.d.ts +14 -0
  76. package/dist/fields/config/FilterOperatorSelectField.js +75 -0
  77. package/dist/fields/config/FilterOperatorSelectField.js.map +1 -0
  78. package/dist/fields/config/MetricSelectField.js +3 -3
  79. package/dist/fields/config/MetricSelectField.js.map +1 -1
  80. package/dist/fields/config/SourceSelectField.js +3 -3
  81. package/dist/fields/config/SourceSelectField.js.map +1 -1
  82. package/dist/fields/config/fetchSources.d.ts +5 -1
  83. package/dist/fields/config/sourcesState.js +19 -3
  84. package/dist/fields/config/sourcesState.js.map +1 -1
  85. package/dist/fields/config/useAnalyticsSources.d.ts +8 -3
  86. package/dist/fields/config/useAnalyticsSources.js +9 -6
  87. package/dist/fields/config/useAnalyticsSources.js.map +1 -1
  88. package/dist/fields/config/useFilterCapabilities.d.ts +28 -0
  89. package/dist/fields/config/useFilterCapabilities.js +52 -0
  90. package/dist/fields/config/useFilterCapabilities.js.map +1 -0
  91. package/dist/fields/readForDocument.d.ts +5 -0
  92. package/dist/fields/readForDocument.js +21 -9
  93. package/dist/fields/readForDocument.js.map +1 -1
  94. package/dist/goals/GoalSelectField.d.ts +7 -0
  95. package/dist/goals/GoalSelectField.js +77 -0
  96. package/dist/goals/GoalSelectField.js.map +1 -0
  97. package/dist/goals/collection.js +250 -0
  98. package/dist/goals/collection.js.map +1 -0
  99. package/dist/goals/currency.js +14 -0
  100. package/dist/goals/currency.js.map +1 -0
  101. package/dist/goals/fetchGoals.d.ts +18 -0
  102. package/dist/goals/fetchGoals.js +29 -0
  103. package/dist/goals/fetchGoals.js.map +1 -0
  104. package/dist/goals/goalField.d.ts +31 -0
  105. package/dist/goals/goalField.js +56 -0
  106. package/dist/goals/goalField.js.map +1 -0
  107. package/dist/goals/goalsEndpoint.d.ts +1 -0
  108. package/dist/goals/goalsEndpoint.js +55 -0
  109. package/dist/goals/goalsEndpoint.js.map +1 -0
  110. package/dist/goals/resolver.d.ts +8 -0
  111. package/dist/goals/resolver.js +147 -0
  112. package/dist/goals/resolver.js.map +1 -0
  113. package/dist/goals/trackGoalAction.d.ts +74 -0
  114. package/dist/goals/trackGoalAction.js +139 -0
  115. package/dist/goals/trackGoalAction.js.map +1 -0
  116. package/dist/goals/useAnalyticsGoals.d.ts +20 -0
  117. package/dist/goals/useAnalyticsGoals.js +67 -0
  118. package/dist/goals/useAnalyticsGoals.js.map +1 -0
  119. package/dist/index.d.ts +12 -3
  120. package/dist/index.js +75 -11
  121. package/dist/index.js.map +1 -1
  122. package/dist/native/collections/events.js +36 -0
  123. package/dist/native/collections/events.js.map +1 -1
  124. package/dist/native/eventScan.js +25 -0
  125. package/dist/native/eventScan.js.map +1 -0
  126. package/dist/native/ingest/browser.js +47 -0
  127. package/dist/native/ingest/browser.js.map +1 -0
  128. package/dist/native/ingest/device.js +11 -3
  129. package/dist/native/ingest/device.js.map +1 -1
  130. package/dist/native/ingest/endpoint.d.ts +1 -0
  131. package/dist/native/ingest/endpoint.js +2 -17
  132. package/dist/native/ingest/endpoint.js.map +1 -1
  133. package/dist/native/ingest/flushBatch.js +26 -26
  134. package/dist/native/ingest/flushBatch.js.map +1 -1
  135. package/dist/native/ingest/language.js +14 -0
  136. package/dist/native/ingest/language.js.map +1 -0
  137. package/dist/native/ingest/normalizeEvent.d.ts +26 -0
  138. package/dist/native/ingest/normalizeEvent.js +35 -7
  139. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  140. package/dist/native/ingest/referrer.js +48 -0
  141. package/dist/native/ingest/referrer.js.map +1 -0
  142. package/dist/native/ingest/serverTrack.d.ts +20 -0
  143. package/dist/native/ingest/serverTrack.js +100 -0
  144. package/dist/native/ingest/serverTrack.js.map +1 -0
  145. package/dist/native/ingest/source.d.ts +7 -0
  146. package/dist/native/ingest/source.js +139 -14
  147. package/dist/native/ingest/source.js.map +1 -1
  148. package/dist/native/ingest/utm.js +33 -0
  149. package/dist/native/ingest/utm.js.map +1 -0
  150. package/dist/native/ingest/validate.js +27 -0
  151. package/dist/native/ingest/validate.js.map +1 -0
  152. package/dist/native/nativeAdapter.d.ts +1 -1
  153. package/dist/native/nativeAdapter.js +53 -36
  154. package/dist/native/nativeAdapter.js.map +1 -1
  155. package/dist/native/query/eventAgg.js +14 -1
  156. package/dist/native/query/eventAgg.js.map +1 -1
  157. package/dist/native/retention/pruneTask.js +1 -1
  158. package/dist/native/rollups/bucketKey.js +15 -0
  159. package/dist/native/rollups/bucketKey.js.map +1 -0
  160. package/dist/native/rollups/bumpRollups.js +116 -0
  161. package/dist/native/rollups/bumpRollups.js.map +1 -0
  162. package/dist/native/rollups/deltas.js +30 -15
  163. package/dist/native/rollups/deltas.js.map +1 -1
  164. package/dist/native/rollups/insertManyIfNew.js +93 -0
  165. package/dist/native/rollups/insertManyIfNew.js.map +1 -0
  166. package/dist/next/captureRewrites.d.ts +3 -2
  167. package/dist/next/captureRewrites.js +3 -2
  168. package/dist/next/captureRewrites.js.map +1 -1
  169. package/dist/plugin/documentEndpoint.js +52 -15
  170. package/dist/plugin/documentEndpoint.js.map +1 -1
  171. package/dist/plugin/goalHint.d.ts +1 -0
  172. package/dist/plugin/goalHint.js +24 -0
  173. package/dist/plugin/goalHint.js.map +1 -0
  174. package/dist/plugin/paths.js +5 -1
  175. package/dist/plugin/paths.js.map +1 -1
  176. package/dist/plugin/queryEndpoint.js +120 -0
  177. package/dist/plugin/queryEndpoint.js.map +1 -0
  178. package/dist/plugin/readContextForRequest.js +71 -0
  179. package/dist/plugin/readContextForRequest.js.map +1 -0
  180. package/dist/plugin/realtimeEndpoint.js +43 -15
  181. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  182. package/dist/plugin/responses.js +17 -0
  183. package/dist/plugin/responses.js.map +1 -0
  184. package/dist/plugin/runtime.js +31 -1
  185. package/dist/plugin/runtime.js.map +1 -1
  186. package/dist/plugin/scopeFieldBoot.js +22 -0
  187. package/dist/plugin/scopeFieldBoot.js.map +1 -0
  188. package/dist/plugin/sourcesEndpoint.js +21 -52
  189. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  190. package/dist/plugin/warmTask.js +0 -0
  191. package/dist/plugin/warmTask.js.map +1 -1
  192. package/dist/providers/collection.js +29 -13
  193. package/dist/providers/collection.js.map +1 -1
  194. package/dist/providers/factory.js +4 -2
  195. package/dist/providers/factory.js.map +1 -1
  196. package/dist/providers/resolver.js.map +1 -1
  197. package/dist/query/dates.js +64 -0
  198. package/dist/query/dates.js.map +1 -0
  199. package/dist/query/errors.d.ts +17 -0
  200. package/dist/query/errors.js +10 -0
  201. package/dist/query/errors.js.map +1 -0
  202. package/dist/query/fetchQuery.d.ts +59 -0
  203. package/dist/query/fetchQuery.js +110 -0
  204. package/dist/query/fetchQuery.js.map +1 -0
  205. package/dist/query/parse.d.ts +22 -0
  206. package/dist/query/parse.js +168 -0
  207. package/dist/query/parse.js.map +1 -0
  208. package/dist/query/response.d.ts +39 -0
  209. package/dist/query/response.js +11 -0
  210. package/dist/query/response.js.map +1 -0
  211. package/dist/surfacing/engine.js +1 -1
  212. package/dist/surfacing/engine.js.map +1 -1
  213. package/dist/testing/memoryAdapter.js +0 -1
  214. package/dist/testing/memoryAdapter.js.map +1 -1
  215. package/dist/timeframe/tz.js +17 -6
  216. package/dist/timeframe/tz.js.map +1 -1
  217. package/dist/tracker/createTracker.js +13 -1
  218. package/dist/tracker/createTracker.js.map +1 -1
  219. package/dist/tracker/sinks/ga4.d.ts +21 -0
  220. package/dist/tracker/sinks/ga4.js +26 -0
  221. package/dist/tracker/sinks/ga4.js.map +1 -0
  222. package/dist/tracker/types.d.ts +5 -0
  223. package/dist/translations/ar.js +127 -1
  224. package/dist/translations/ar.js.map +1 -1
  225. package/dist/translations/de.js +127 -1
  226. package/dist/translations/de.js.map +1 -1
  227. package/dist/translations/en.js +127 -1
  228. package/dist/translations/en.js.map +1 -1
  229. package/dist/translations/es.js +127 -1
  230. package/dist/translations/es.js.map +1 -1
  231. package/dist/translations/fr.js +127 -1
  232. package/dist/translations/fr.js.map +1 -1
  233. package/dist/translations/id.js +127 -1
  234. package/dist/translations/id.js.map +1 -1
  235. package/dist/translations/keys.d.ts +126 -0
  236. package/dist/translations/keys.js +127 -1
  237. package/dist/translations/keys.js.map +1 -1
  238. package/dist/translations/ko.js +127 -1
  239. package/dist/translations/ko.js.map +1 -1
  240. package/dist/translations/metricKeys.js +8 -2
  241. package/dist/translations/metricKeys.js.map +1 -1
  242. package/dist/translations/pt.js +127 -1
  243. package/dist/translations/pt.js.map +1 -1
  244. package/dist/translations/ru.js +127 -1
  245. package/dist/translations/ru.js.map +1 -1
  246. package/dist/translations/server.js.map +1 -1
  247. package/dist/translations/uk.js +127 -1
  248. package/dist/translations/uk.js.map +1 -1
  249. package/dist/translations/zh.js +127 -1
  250. package/dist/translations/zh.js.map +1 -1
  251. package/dist/view/AnalyticsNavLink.d.ts +19 -0
  252. package/dist/view/AnalyticsNavLink.js +40 -0
  253. package/dist/view/AnalyticsNavLink.js.map +1 -0
  254. package/dist/view/AnalyticsView.d.ts +23 -0
  255. package/dist/view/AnalyticsView.js +45 -0
  256. package/dist/view/AnalyticsView.js.map +1 -0
  257. package/dist/view/AnalyticsViewClient.d.ts +15 -0
  258. package/dist/view/AnalyticsViewClient.js +200 -0
  259. package/dist/view/AnalyticsViewClient.js.map +1 -0
  260. package/dist/view/authRedirect.js +32 -0
  261. package/dist/view/authRedirect.js.map +1 -0
  262. package/dist/view/conversionRate.js +18 -0
  263. package/dist/view/conversionRate.js.map +1 -0
  264. package/dist/view/dayRange.js +68 -0
  265. package/dist/view/dayRange.js.map +1 -0
  266. package/dist/view/gating.d.ts +1 -0
  267. package/dist/view/gating.js +142 -0
  268. package/dist/view/gating.js.map +1 -0
  269. package/dist/view/labels.js +64 -0
  270. package/dist/view/labels.js.map +1 -0
  271. package/dist/view/registerView.js +48 -0
  272. package/dist/view/registerView.js.map +1 -0
  273. package/dist/view/sections/Breakdowns.js +197 -0
  274. package/dist/view/sections/Breakdowns.js.map +1 -0
  275. package/dist/view/sections/EmptyStates.js +92 -0
  276. package/dist/view/sections/EmptyStates.js.map +1 -0
  277. package/dist/view/sections/FilterChips.js +46 -0
  278. package/dist/view/sections/FilterChips.js.map +1 -0
  279. package/dist/view/sections/GoalsPanel.js +82 -0
  280. package/dist/view/sections/GoalsPanel.js.map +1 -0
  281. package/dist/view/sections/OverviewCards.js +65 -0
  282. package/dist/view/sections/OverviewCards.js.map +1 -0
  283. package/dist/view/sections/RealtimeStrip.js +80 -0
  284. package/dist/view/sections/RealtimeStrip.js.map +1 -0
  285. package/dist/view/sections/Toolbar.js +186 -0
  286. package/dist/view/sections/Toolbar.js.map +1 -0
  287. package/dist/view/sections/Trend.js +125 -0
  288. package/dist/view/sections/Trend.js.map +1 -0
  289. package/dist/view/sections/styles.js +74 -0
  290. package/dist/view/sections/styles.js.map +1 -0
  291. package/dist/view/state.js +211 -0
  292. package/dist/view/state.js.map +1 -0
  293. package/dist/view/useViewQueries.js +153 -0
  294. package/dist/view/useViewQueries.js.map +1 -0
  295. package/dist/view/viewProps.d.ts +40 -0
  296. package/dist/view/viewProps.js +90 -0
  297. package/dist/view/viewProps.js.map +1 -0
  298. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
  299. package/dist/widgets/AnalyticsBreakdownWidget.js +78 -11
  300. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
  301. package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
  302. package/dist/widgets/AnalyticsGoalsWidget.js +196 -0
  303. package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
  304. package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
  305. package/dist/widgets/AnalyticsMetricWidget.js +63 -13
  306. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
  307. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
  308. package/dist/widgets/AnalyticsRealtimeWidget.js +44 -22
  309. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  310. package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
  311. package/dist/widgets/AnalyticsTrendWidget.js +79 -16
  312. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
  313. package/dist/widgets/RealtimeCounter.d.ts +4 -0
  314. package/dist/widgets/RealtimeCounter.js +10 -1
  315. package/dist/widgets/RealtimeCounter.js.map +1 -1
  316. package/dist/widgets/WidgetViewLink.js +17 -0
  317. package/dist/widgets/WidgetViewLink.js.map +1 -0
  318. package/dist/widgets/breakdownTypes.js +28 -1
  319. package/dist/widgets/breakdownTypes.js.map +1 -1
  320. package/dist/widgets/cardChrome.js +31 -7
  321. package/dist/widgets/cardChrome.js.map +1 -1
  322. package/dist/widgets/comparison.js +15 -1
  323. package/dist/widgets/comparison.js.map +1 -1
  324. package/dist/widgets/defaults.d.ts +6 -2
  325. package/dist/widgets/defaults.js +72 -25
  326. package/dist/widgets/defaults.js.map +1 -1
  327. package/dist/widgets/filterCaption.js +27 -0
  328. package/dist/widgets/filterCaption.js.map +1 -0
  329. package/dist/widgets/filterField.d.ts +19 -0
  330. package/dist/widgets/filterField.js +75 -0
  331. package/dist/widgets/filterField.js.map +1 -0
  332. package/dist/widgets/prepareWidgetRead.d.ts +7 -0
  333. package/dist/widgets/prepareWidgetRead.js +74 -0
  334. package/dist/widgets/prepareWidgetRead.js.map +1 -0
  335. package/dist/widgets/range.js +43 -12
  336. package/dist/widgets/range.js.map +1 -1
  337. package/dist/widgets/readForWidget.d.ts +24 -2
  338. package/dist/widgets/readForWidget.js +34 -48
  339. package/dist/widgets/readForWidget.js.map +1 -1
  340. package/dist/widgets/readForWidgetBreakdown.d.ts +32 -1
  341. package/dist/widgets/readForWidgetBreakdown.js +32 -42
  342. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  343. package/dist/widgets/readForWidgetGoals.d.ts +67 -0
  344. package/dist/widgets/readForWidgetGoals.js +140 -0
  345. package/dist/widgets/readForWidgetGoals.js.map +1 -0
  346. package/dist/widgets/readForWidgetRealtime.d.ts +8 -0
  347. package/dist/widgets/readForWidgetRealtime.js +21 -20
  348. package/dist/widgets/readForWidgetRealtime.js.map +1 -1
  349. package/dist/widgets/readForWidgetSeries.d.ts +24 -1
  350. package/dist/widgets/readForWidgetSeries.js +63 -56
  351. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  352. package/dist/widgets/readMeta.js +18 -0
  353. package/dist/widgets/readMeta.js.map +1 -0
  354. package/dist/widgets/registerWidgets.js +53 -7
  355. package/dist/widgets/registerWidgets.js.map +1 -1
  356. package/dist/widgets/types.d.ts +15 -0
  357. package/dist/widgets/types.js +12 -1
  358. package/dist/widgets/types.js.map +1 -1
  359. package/dist/widgets/viewLink.d.ts +22 -0
  360. package/dist/widgets/viewLink.js +86 -0
  361. package/dist/widgets/viewLink.js.map +1 -0
  362. package/package.json +9 -4
  363. package/dist/native/rollups/applyDistinctDeltas.js +0 -9
  364. package/dist/native/rollups/applyDistinctDeltas.js.map +0 -1
  365. package/dist/native/rollups/bumpRollup.js +0 -73
  366. package/dist/native/rollups/bumpRollup.js.map +0 -1
  367. package/dist/native/rollups/insertIfNew.js +0 -19
  368. package/dist/native/rollups/insertIfNew.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = Math.max(...values)\n\tconst min = Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n\t/** Explicit value domain, so two series drawn on one chart share a y-scale. */\n\tdomain?: { min: number; max: number }\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = opts.domain?.max ?? Math.max(...values)\n\tconst min = opts.domain?.min ?? Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":"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"}
@@ -5,18 +5,29 @@ const CHART_CSS = `
5
5
  :where(:root) {
6
6
  --analytics-chart-1: var(--theme-success-500, #3b82f6);
7
7
  }
8
- .analytics-chart { position: relative; width: 100%; }
8
+ .analytics-chart { display: flex; flex-direction: column; width: 100%; }
9
+ .analytics-chart__plot { position: relative; flex: 1 1 auto; min-height: 0; width: 100%; }
10
+ .analytics-chart__legend { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: center; margin-bottom: 0.35rem; font-size: 0.6875rem; color: var(--theme-elevation-500); }
11
+ .analytics-chart__legend-item { display: inline-flex; align-items: center; gap: 0.35rem; }
12
+ .analytics-chart__legend-swatch { width: 0.75rem; height: 0.125rem; border-radius: 999px; background: var(--analytics-chart-1); }
13
+ .analytics-chart__legend-swatch--comparison { background: var(--theme-elevation-500); }
14
+ .analytics-chart__legend-range { color: var(--theme-elevation-400); }
9
15
  .analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }
10
16
  .analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }
11
17
  .analytics-chart__area { stroke: none; }
12
18
  .analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }
13
19
  .analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }
20
+ .analytics-chart__comparison { fill: none; stroke: var(--theme-elevation-500); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }
21
+ .analytics-chart__dot--comparison { stroke: var(--theme-elevation-500); stroke-width: 1.5; }
14
22
  .analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }
15
23
  .analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }
16
24
  .analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }
25
+ .analytics-chart__active--comparison { fill: var(--theme-elevation-500); }
17
26
  .analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }
18
27
  .analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }
19
28
  .analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }
29
+ .analytics-chart__tooltip-comparison { display: flex; gap: 0.5rem; justify-content: space-between; margin-top: 0.2rem; color: var(--theme-elevation-500); }
30
+ .analytics-chart__tooltip-previous { font-weight: 600; font-variant-numeric: tabular-nums; }
20
31
  @keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }
21
32
  .analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }
22
33
  .analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }
@@ -25,6 +36,12 @@ const CHART_CSS = `
25
36
  .analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }
26
37
  .analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
27
38
  .analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }
39
+ .analytics-bars--soft .analytics-bars__track { background: var(--theme-elevation-100); }
40
+ .analytics-bars--soft .analytics-bars__fill { background: color-mix(in srgb, var(--analytics-chart-1) 25%, transparent); }
41
+ .analytics-bars--soft .analytics-bars__label { color: var(--theme-elevation-800); }
42
+ .analytics-bars__secondary { flex: none; font-size: 0.8125rem; font-variant-numeric: tabular-nums; color: var(--theme-elevation-500); }
43
+ .analytics-bars__row--action { appearance: none; background: none; border: 0; padding: 0; margin: 0; font: inherit; color: inherit; width: 100%; text-align: start; cursor: pointer; }
44
+ .analytics-bars__row--action:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }
28
45
  .analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }
29
46
  `;
30
47
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"styles.js","names":[],"sources":["../../src/charts/styles.tsx"],"sourcesContent":["'use client'\n\nconst CHART_CSS = `\n:where(:root) {\n\t--analytics-chart-1: var(--theme-success-500, #3b82f6);\n}\n.analytics-chart { position: relative; width: 100%; }\n.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }\n.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }\n.analytics-chart__area { stroke: none; }\n.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }\n.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }\n.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }\n.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }\n.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }\n.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }\n.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }\n@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }\n.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }\n.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }\n.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }\n.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }\n.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }\n.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n`\n\n/**\n * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so\n * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically\n * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`\n * scope so a consuming app can override them.\n */\nexport function ChartStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: CHART_CSS }} />\n}\n"],"mappings":";;;AAEA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiClB,SAAgB,cAAc;CAE7B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,EAAI,CAAA;AAChE"}
1
+ {"version":3,"file":"styles.js","names":[],"sources":["../../src/charts/styles.tsx"],"sourcesContent":["'use client'\n\nconst CHART_CSS = `\n:where(:root) {\n\t--analytics-chart-1: var(--theme-success-500, #3b82f6);\n}\n.analytics-chart { display: flex; flex-direction: column; width: 100%; }\n.analytics-chart__plot { position: relative; flex: 1 1 auto; min-height: 0; width: 100%; }\n.analytics-chart__legend { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: center; margin-bottom: 0.35rem; font-size: 0.6875rem; color: var(--theme-elevation-500); }\n.analytics-chart__legend-item { display: inline-flex; align-items: center; gap: 0.35rem; }\n.analytics-chart__legend-swatch { width: 0.75rem; height: 0.125rem; border-radius: 999px; background: var(--analytics-chart-1); }\n.analytics-chart__legend-swatch--comparison { background: var(--theme-elevation-500); }\n.analytics-chart__legend-range { color: var(--theme-elevation-400); }\n.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }\n.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }\n.analytics-chart__area { stroke: none; }\n.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }\n.analytics-chart__comparison { fill: none; stroke: var(--theme-elevation-500); stroke-width: 1.5; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot--comparison { stroke: var(--theme-elevation-500); stroke-width: 1.5; }\n.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }\n.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }\n.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }\n.analytics-chart__active--comparison { fill: var(--theme-elevation-500); }\n.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }\n.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }\n.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }\n.analytics-chart__tooltip-comparison { display: flex; gap: 0.5rem; justify-content: space-between; margin-top: 0.2rem; color: var(--theme-elevation-500); }\n.analytics-chart__tooltip-previous { font-weight: 600; font-variant-numeric: tabular-nums; }\n@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }\n.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }\n.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }\n.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }\n.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }\n.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }\n.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-bars--soft .analytics-bars__track { background: var(--theme-elevation-100); }\n.analytics-bars--soft .analytics-bars__fill { background: color-mix(in srgb, var(--analytics-chart-1) 25%, transparent); }\n.analytics-bars--soft .analytics-bars__label { color: var(--theme-elevation-800); }\n.analytics-bars__secondary { flex: none; font-size: 0.8125rem; font-variant-numeric: tabular-nums; color: var(--theme-elevation-500); }\n.analytics-bars__row--action { appearance: none; background: none; border: 0; padding: 0; margin: 0; font: inherit; color: inherit; width: 100%; text-align: start; cursor: pointer; }\n.analytics-bars__row--action:focus-visible { outline: var(--accessibility-outline, 2px solid var(--theme-elevation-800)); outline-offset: 2px; }\n.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n`\n\n/**\n * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so\n * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically\n * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`\n * scope so a consuming app can override them.\n */\nexport function ChartStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: CHART_CSS }} />\n}\n"],"mappings":";;;AAEA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDlB,SAAgB,cAAc;CAE7B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,EAAI,CAAA;AAChE"}
@@ -1,10 +1,31 @@
1
1
  import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
2
2
  //#region src/core/cacheKey.ts
3
3
  const stable = (xs) => xs ? [...xs].sort().join(",") : "";
4
+ /**
5
+ * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every
6
+ * render within one day shares one entry. A closed window, whose end is the final instant
7
+ * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two
8
+ * windows that differ only inside their last day share an entry, and an instant-comparing
9
+ * adapter read the narrower one's answer.
10
+ */
11
+ const rangeKey = (range, tz) => {
12
+ const nextDay = addDaysInTz(range.end, 1, tz);
13
+ if (nextDay.getTime() - 1 === range.end.getTime()) return `${range.start.toISOString()}_${range.end.toISOString()}`;
14
+ return `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`;
15
+ };
16
+ /**
17
+ * The goal segment, absent for a read with no hint and for an install with no goals, which
18
+ * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which
19
+ * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.
20
+ */
21
+ const goalKey = (goalSlugs) => {
22
+ if (goalSlugs === "unresolved") return ["goals:!unresolved"];
23
+ return goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : [];
24
+ };
4
25
  function buildCacheKey(provider, q) {
5
26
  const pathKey = q.path ?? "site";
6
27
  const tz = q.timezone ?? "UTC";
7
- const range = `${startOfDayInTz(q.dateRange.start, tz).toISOString()}_${addDaysInTz(q.dateRange.end, 1, tz).toISOString()}`;
28
+ const range = rangeKey(q.dateRange, tz);
8
29
  const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
9
30
  return [
10
31
  "analytics",
@@ -19,7 +40,8 @@ function buildCacheKey(provider, q) {
19
40
  String(q.limit ?? "_"),
20
41
  q.order ? `${q.order.metric}:${q.order.direction}` : "_",
21
42
  ...q.timezone !== void 0 && q.timezone !== "UTC" ? [q.timezone] : [],
22
- ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
43
+ ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : [],
44
+ ...goalKey(q.goalSlugs)
23
45
  ].join("|");
24
46
  }
25
47
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst range = `${startOfDayInTz(q.dateRange.start, tz).toISOString()}_${addDaysInTz(q.dateRange.end, 1, tz).toISOString()}`\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for a non-UTC timezone so default (UTC) keys keep their format.\n\t\t...(q.timezone !== undefined && q.timezone !== DEFAULT_TIMEZONE ? [q.timezone] : []),\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t].join('|')\n}\n"],"mappings":";;AAGA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;AAE3E,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,KAAK,EAAE,YAAA;CACb,MAAM,QAAQ,GAAG,eAAe,EAAE,UAAU,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,UAAU,KAAK,GAAG,EAAE,EAAE,YAAY;CACxH,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EACA;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,aAAa,KAAA,KAAa,EAAE,aAAA,QAAgC,CAAC,EAAE,QAAQ,IAAI,CAAC;EAClF,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;CAC9D,EAAE,KAAK,GAAG;AACX"}
1
+ {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import { addDaysInTz, DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\n/**\n * The window segment. A live window (a preset ends at `now`) snaps to whole days, so every\n * render within one day shares one entry. A closed window, whose end is the final instant\n * of its day in `tz`, keys on its exact bounds instead: snapping those too would let two\n * windows that differ only inside their last day share an entry, and an instant-comparing\n * adapter read the narrower one's answer.\n */\nconst rangeKey = (range: AnalyticsQuery['dateRange'], tz: string): string => {\n\tconst nextDay = addDaysInTz(range.end, 1, tz)\n\tif (nextDay.getTime() - 1 === range.end.getTime()) {\n\t\treturn `${range.start.toISOString()}_${range.end.toISOString()}`\n\t}\n\treturn `${startOfDayInTz(range.start, tz).toISOString()}_${nextDay.toISOString()}`\n}\n\n/**\n * The goal segment, absent for a read with no hint and for an install with no goals, which\n * both ask the provider for the same rows. The failed-resolver segment carries a `!`, which\n * `GOAL_SLUG_PATTERN` forbids, so no list of slugs can be written to look like it.\n */\nconst goalKey = (goalSlugs: AnalyticsQuery['goalSlugs']): string[] => {\n\tif (goalSlugs === 'unresolved') {\n\t\treturn ['goals:!unresolved']\n\t}\n\treturn goalSlugs?.length ? [`goals:${stable(goalSlugs)}`] : []\n}\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst tz = q.timezone ?? DEFAULT_TIMEZONE\n\tconst range = rangeKey(q.dateRange, tz)\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for a non-UTC timezone so default (UTC) keys keep their format.\n\t\t...(q.timezone !== undefined && q.timezone !== DEFAULT_TIMEZONE ? [q.timezone] : []),\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t\t// A provider read restricts its goal rows to the hint, so two hints answer differently\n\t\t// and must never share an entry. A failed resolver keys on its own segment rather than\n\t\t// on the healthy no-hint key. Prefixed, so the segment cannot read as a scope.\n\t\t...goalKey(q.goalSlugs),\n\t].join('|')\n}\n"],"mappings":";;AAGA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;;;;;;;;AAS3E,MAAM,YAAY,OAAoC,OAAuB;CAC5E,MAAM,UAAU,YAAY,MAAM,KAAK,GAAG,EAAE;CAC5C,IAAI,QAAQ,QAAQ,IAAI,MAAM,MAAM,IAAI,QAAQ,GAC/C,OAAO,GAAG,MAAM,MAAM,YAAY,EAAE,GAAG,MAAM,IAAI,YAAY;CAE9D,OAAO,GAAG,eAAe,MAAM,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,YAAY;AAChF;;;;;;AAOA,MAAM,WAAW,cAAqD;CACrE,IAAI,cAAc,cACjB,OAAO,CAAC,mBAAmB;CAE5B,OAAO,WAAW,SAAS,CAAC,SAAS,OAAO,SAAS,GAAG,IAAI,CAAC;AAC9D;AAEA,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,KAAK,EAAE,YAAA;CACb,MAAM,QAAQ,SAAS,EAAE,WAAW,EAAE;CACtC,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EACA;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,aAAa,KAAA,KAAa,EAAE,aAAA,QAAgC,CAAC,EAAE,QAAQ,IAAI,CAAC;EAClF,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;EAI7D,GAAG,QAAQ,EAAE,SAAS;CACvB,EAAE,KAAK,GAAG;AACX"}
@@ -8,6 +8,11 @@ function satisfiesCapabilities(caps, req) {
8
8
  if (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false;
9
9
  return true;
10
10
  }
11
+ /**
12
+ * Whether a source compares against its previous period. The engine does that read
13
+ * generically, so it is on unless an adapter opted out.
14
+ */
15
+ const comparisonOf = (caps) => caps.comparison ?? true;
11
16
  const serializeCapabilities = (caps) => ({
12
17
  metrics: [...caps.metrics],
13
18
  dimensions: [...caps.dimensions],
@@ -16,11 +21,11 @@ const serializeCapabilities = (caps) => ({
16
21
  realtime: caps.realtime,
17
22
  ...caps.realtimeWindowMinutes !== void 0 ? { realtimeWindowMinutes: caps.realtimeWindowMinutes } : {},
18
23
  perPageQuery: caps.perPageQuery,
19
- comparison: caps.comparison,
24
+ comparison: comparisonOf(caps),
20
25
  minGranularity: caps.minGranularity,
21
26
  maxLookbackDays: caps.maxLookbackDays
22
27
  });
23
28
  //#endregion
24
- export { satisfiesCapabilities, serializeCapabilities };
29
+ export { comparisonOf, satisfiesCapabilities, serializeCapabilities };
25
30
 
26
31
  //# sourceMappingURL=capabilities.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tDimensionKey,\n\tFilterOperator,\n\tGranularity,\n\tMetricKey,\n} from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfilters?: DimensionKey[]\n\tfilterOperators?: FilterOperator[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((d) => !caps.filters.has(d))) return false\n\tif (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false\n\treturn true\n}\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\tfilters: DimensionKey[]\n\tfilterOperators: FilterOperator[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\tfilters: [...caps.filters],\n\tfilterOperators: [...caps.filterOperators],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: caps.comparison,\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AAiBA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,iBAAiB,MAAM,OAAO,CAAC,KAAK,gBAAgB,IAAI,EAAE,CAAC,GAAG,OAAO;CAC7E,OAAO;AACR;AAgBA,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,iBAAiB,CAAC,GAAG,KAAK,eAAe;CACzC,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,KAAK;CACjB,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
1
+ {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type {\n\tAnalyticsCapabilities,\n\tDimensionKey,\n\tFilterOperator,\n\tGranularity,\n\tMetricKey,\n} from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfilters?: DimensionKey[]\n\tfilterOperators?: FilterOperator[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\tif (req.filters?.some((d) => !caps.filters.has(d))) return false\n\tif (req.filterOperators?.some((op) => !caps.filterOperators.has(op))) return false\n\treturn true\n}\n\n/**\n * Whether a source compares against its previous period. The engine does that read\n * generically, so it is on unless an adapter opted out.\n */\nexport const comparisonOf = (caps: AnalyticsCapabilities): boolean => caps.comparison ?? true\n\n/** Wire form of AnalyticsCapabilities for client pickers: a deliberate allowlist, so adapter internals (rate limits, TTLs) never become client contract by accident. */\nexport type SerializedCapabilities = {\n\tmetrics: MetricKey[]\n\tdimensions: DimensionKey[]\n\tfilters: DimensionKey[]\n\tfilterOperators: FilterOperator[]\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tperPageQuery: boolean\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n}\n\nexport const serializeCapabilities = (caps: AnalyticsCapabilities): SerializedCapabilities => ({\n\tmetrics: [...caps.metrics],\n\tdimensions: [...caps.dimensions],\n\tfilters: [...caps.filters],\n\tfilterOperators: [...caps.filterOperators],\n\trealtime: caps.realtime,\n\t...(caps.realtimeWindowMinutes !== undefined\n\t\t? { realtimeWindowMinutes: caps.realtimeWindowMinutes }\n\t\t: {}),\n\tperPageQuery: caps.perPageQuery,\n\tcomparison: comparisonOf(caps),\n\tminGranularity: caps.minGranularity,\n\tmaxLookbackDays: caps.maxLookbackDays,\n})\n"],"mappings":";AAiBA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,iBAAiB,MAAM,OAAO,CAAC,KAAK,gBAAgB,IAAI,EAAE,CAAC,GAAG,OAAO;CAC7E,OAAO;AACR;;;;;AAMA,MAAa,gBAAgB,SAAyC,KAAK,cAAc;AAgBzF,MAAa,yBAAyB,UAAyD;CAC9F,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,YAAY,CAAC,GAAG,KAAK,UAAU;CAC/B,SAAS,CAAC,GAAG,KAAK,OAAO;CACzB,iBAAiB,CAAC,GAAG,KAAK,eAAe;CACzC,UAAU,KAAK;CACf,GAAI,KAAK,0BAA0B,KAAA,IAChC,EAAE,uBAAuB,KAAK,sBAAsB,IACpD,CAAC;CACJ,cAAc,KAAK;CACnB,YAAY,aAAa,IAAI;CAC7B,gBAAgB,KAAK;CACrB,iBAAiB,KAAK;AACvB"}
@@ -28,7 +28,7 @@ interface SnippetScript {
28
28
  interface CaptureSnippet {
29
29
  scripts: SnippetScript[];
30
30
  }
31
- type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami';
31
+ type CaptureClientKind = 'native' | 'posthog' | 'plausible' | 'umami' | 'ga4';
32
32
  /**
33
33
  * Pure descriptor of how a vendor's browser tracker is proxied and booted, consumed by
34
34
  * a later runtime proxy endpoint, a Next rewrites helper, and a snippet renderer. Never
@@ -1,5 +1,6 @@
1
1
  import { Goal } from "../goals/types.js";
2
2
  import { CaptureSupport } from "./capture.js";
3
+ import { ServerTrack } from "./serverEvent.js";
3
4
  import { Config, PayloadRequest } from "payload";
4
5
 
5
6
  //#region src/core/contract.d.ts
@@ -9,13 +10,17 @@ import { Config, PayloadRequest } from "payload";
9
10
  */
10
11
  declare const PLATFORM_SCOPE = "*";
11
12
  type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
12
- type DimensionKey = 'page' | 'referrer' | 'source' | 'medium' | 'campaign' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmContent' | 'utmTerm' | 'device' | 'browser' | 'os' | 'country' | 'region' | 'city' | 'language' | 'event' | 'goal';
13
+ /** Every breakdown key the contract defines; the registry request parsers validate against. */
14
+ declare const DIMENSION_KEYS: readonly ["page", "referrer", "source", "medium", "campaign", "utmSource", "utmMedium", "utmCampaign", "utmContent", "utmTerm", "device", "browser", "os", "country", "region", "city", "language", "event", "goal"];
15
+ type DimensionKey = (typeof DIMENSION_KEYS)[number];
13
16
  type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
14
17
  interface DateRange {
15
18
  start: Date;
16
19
  end: Date;
17
20
  }
18
- type FilterOperator = 'eq' | 'contains' | 'matches';
21
+ /** Every filter operator the contract defines; the registry request parsers validate against. */
22
+ declare const FILTER_OPERATORS: readonly ["eq", "contains", "matches"];
23
+ type FilterOperator = (typeof FILTER_OPERATORS)[number];
19
24
  interface AnalyticsFilter {
20
25
  dimension: DimensionKey;
21
26
  operator: FilterOperator;
@@ -47,6 +52,16 @@ interface AnalyticsQuery {
47
52
  * others report in their own account timezone. Part of the cache key when set.
48
53
  */
49
54
  timezone?: string;
55
+ /**
56
+ * The scope's goal slugs, set by callers that ask for the `goal` dimension or the
57
+ * `conversions` metric, and possibly empty when the scope configures no goals. Provider
58
+ * adapters restrict goal rows to it, since nothing in a provider marks which of its
59
+ * events are this install's goals; the native engine ignores it and matches completions
60
+ * itself. `'unresolved'` is the sentinel for a goal resolver that failed: the read keeps
61
+ * its site numbers, reports `goalsUnresolved`, and never shares a healthy cache key.
62
+ * Part of the surfacing cache key when set.
63
+ */
64
+ goalSlugs?: string[] | 'unresolved';
50
65
  }
51
66
  interface AnalyticsRow {
52
67
  dimensions?: Partial<Record<DimensionKey, string>>;
@@ -62,8 +77,24 @@ interface AnalyticsResult {
62
77
  clamped?: boolean;
63
78
  fetchedAt: string; /** Served from an expired cache entry because the live refresh failed. */
64
79
  stale?: boolean;
80
+ /**
81
+ * Filters the source could not carry, so the rows are wider than the query asked for.
82
+ * A provider whose API takes one value per dimension reports the ones it dropped here.
83
+ */
84
+ unappliedFilters?: AnalyticsFilter[];
85
+ /**
86
+ * The read's goal numbers are absent because resolving them failed: it ran without
87
+ * `AnalyticsQuery.goalSlugs`, or with `'unresolved'`, or the provider rejected the goal
88
+ * request and the rest of the read was served without it. A scope that configured no
89
+ * goals is an empty result instead, not this flag.
90
+ */
91
+ goalsUnresolved?: true;
65
92
  };
66
93
  }
94
+ /**
95
+ * A read carrying conversions costs a provider up to twice the requests: the goal numbers
96
+ * come from a second, goal-filtered request the adapter issues after the plain one.
97
+ */
67
98
  interface RateLimitDescriptor {
68
99
  requestsPerMinute?: number;
69
100
  requestsPerHour?: number;
@@ -80,7 +111,11 @@ interface AnalyticsCapabilities {
80
111
  perPageQuery: boolean;
81
112
  realtime: boolean;
82
113
  realtimeWindowMinutes?: number;
83
- comparison: boolean;
114
+ /**
115
+ * Period-over-period comparison, which the engine serves for every source by reading the
116
+ * previous window itself. Adapters omit this; set it false only to opt a source out.
117
+ */
118
+ comparison?: boolean;
84
119
  minGranularity: Granularity;
85
120
  maxLookbackDays: number | null;
86
121
  metrics: ReadonlySet<MetricKey>;
@@ -119,8 +154,8 @@ interface AdapterRegisterContext {
119
154
  resolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>;
120
155
  /**
121
156
  * The install's goals for a request's scope, for adapters that match completions
122
- * themselves (the native engine, at ingest). Config goals today; a collection source
123
- * merges in behind the same call.
157
+ * themselves (the native engine, at ingest). Config goals, with the goals collection
158
+ * merged over them per scope once the install enables it.
124
159
  */
125
160
  resolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>;
126
161
  }
@@ -128,15 +163,17 @@ interface AnalyticsAdapter {
128
163
  readonly id: string;
129
164
  readonly label: string;
130
165
  readonly capabilities: AnalyticsCapabilities;
131
- /** Browser-tracker proxying/boot descriptor. Absent when the adapter has no client-side script (GA4). */
166
+ /** Browser-tracker proxying/boot descriptor. Absent when no public capture field is set. */
132
167
  readonly capture?: CaptureSupport;
133
168
  /**
134
169
  * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the
135
- * adapters that register one (the native engine). Server-side only: the tracker learns
136
- * the path from `TrackerConfig.ingestPath`, and this object is never serialized.
170
+ * adapters that register one (the native engine), and how server code reaches the same
171
+ * pipeline without an HTTP round trip. Server-side only: the tracker learns the path
172
+ * from `TrackerConfig.ingestPath`, and this object is never serialized.
137
173
  */
138
174
  readonly ingest?: {
139
175
  path: string;
176
+ track?: ServerTrack;
140
177
  };
141
178
  isConfigured(): boolean;
142
179
  query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
@@ -145,5 +182,5 @@ interface AnalyticsAdapter {
145
182
  }
146
183
  type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
147
184
  //#endregion
148
- export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
185
+ export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DIMENSION_KEYS, DateRange, DimensionKey, FILTER_OPERATORS, FilterOperator, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
149
186
  //# sourceMappingURL=contract.d.ts.map
@@ -4,7 +4,35 @@
4
4
  * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
5
5
  */
6
6
  const PLATFORM_SCOPE = "*";
7
+ /** Every breakdown key the contract defines; the registry request parsers validate against. */
8
+ const DIMENSION_KEYS = [
9
+ "page",
10
+ "referrer",
11
+ "source",
12
+ "medium",
13
+ "campaign",
14
+ "utmSource",
15
+ "utmMedium",
16
+ "utmCampaign",
17
+ "utmContent",
18
+ "utmTerm",
19
+ "device",
20
+ "browser",
21
+ "os",
22
+ "country",
23
+ "region",
24
+ "city",
25
+ "language",
26
+ "event",
27
+ "goal"
28
+ ];
29
+ /** Every filter operator the contract defines; the registry request parsers validate against. */
30
+ const FILTER_OPERATORS = [
31
+ "eq",
32
+ "contains",
33
+ "matches"
34
+ ];
7
35
  //#endregion
8
- export { PLATFORM_SCOPE };
36
+ export { DIMENSION_KEYS, FILTER_OPERATORS, PLATFORM_SCOPE };
9
37
 
10
38
  //# sourceMappingURL=contract.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\nimport type { Goal } from '../goals/types'\nimport type { CaptureSupport } from './capture'\n\n/**\n * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every\n * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.\n */\nexport const PLATFORM_SCOPE = '*'\n\nexport type MetricKey =\n\t| 'pageviews'\n\t| 'visitors'\n\t| 'visits'\n\t| 'sessions'\n\t| 'bounceRate'\n\t| 'avgDuration'\n\t| 'scrollDepth'\n\t| 'events'\n\t| 'conversions'\n\t| 'revenue'\n\nexport type DimensionKey =\n\t| 'page'\n\t| 'referrer'\n\t| 'source'\n\t| 'medium'\n\t| 'campaign'\n\t| 'utmSource'\n\t| 'utmMedium'\n\t| 'utmCampaign'\n\t| 'utmContent'\n\t| 'utmTerm'\n\t| 'device'\n\t| 'browser'\n\t| 'os'\n\t| 'country'\n\t| 'region'\n\t| 'city'\n\t| 'language'\n\t| 'event'\n\t| 'goal'\n\nexport type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month'\n\nexport interface DateRange {\n\tstart: Date\n\tend: Date\n}\n\nexport type FilterOperator = 'eq' | 'contains' | 'matches'\n\nexport interface AnalyticsFilter {\n\tdimension: DimensionKey\n\toperator: FilterOperator\n\tvalue: string\n}\n\nexport interface AnalyticsQuery {\n\tpath?: string\n\thostname?: string\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tdateRange: DateRange\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\t/**\n\t * Analytics boundary this read belongs to (tenant id, site key). Undefined means\n\t * install-wide (the default). Adapters that can filter by scope apply it; others\n\t * ignore it. Always part of the surfacing cache key, so per-scope adapter\n\t * instances sharing an id never share cached results.\n\t */\n\tscope?: string\n\t/**\n\t * IANA reporting timezone the read's day boundaries are aligned to. Undefined\n\t * means UTC. Adapters that can bucket in a timezone apply it (PostHog, Umami);\n\t * others report in their own account timezone. Part of the cache key when set.\n\t */\n\ttimezone?: string\n}\n\nexport interface AnalyticsRow {\n\tdimensions?: Partial<Record<DimensionKey, string>>\n\tmetrics: Partial<Record<MetricKey, number>>\n\ttimestamp?: string\n}\n\nexport interface AnalyticsResult {\n\trows: AnalyticsRow[]\n\ttotals?: Partial<Record<MetricKey, number>>\n\tmeta: {\n\t\tprovider: string\n\t\tsampled?: boolean\n\t\tclamped?: boolean\n\t\tfetchedAt: string\n\t\t/** Served from an expired cache entry because the live refresh failed. */\n\t\tstale?: boolean\n\t}\n}\n\nexport interface RateLimitDescriptor {\n\trequestsPerMinute?: number\n\trequestsPerHour?: number\n\tmaxConcurrent?: number\n\t/**\n\t * Describes the provider's quota model for documentation; the limiter always\n\t * throttles by request count regardless of this value.\n\t */\n\tquotaModel?: 'requests' | 'tokens'\n\t/** Documents whether reads consume the provider's write/ingest quota too. */\n\treadsCountAsUsage?: boolean\n}\n\nexport interface AnalyticsCapabilities {\n\tperPageQuery: boolean\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n\tmetrics: ReadonlySet<MetricKey>\n\tdimensions: ReadonlySet<DimensionKey>\n\t/** Dimensions the adapter can apply AnalyticsQuery.filters on; empty = filters unsupported. */\n\tfilters: ReadonlySet<DimensionKey>\n\t/** Operators the adapter honors in filters; adapters ignore filters whose operator they lack. */\n\tfilterOperators: ReadonlySet<FilterOperator>\n\tbatchPageReport: boolean\n\trateLimit: RateLimitDescriptor | null\n\trecommendedTtl: { realtime: number; aggregate: number }\n\t/**\n\t * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native\n\t * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through\n\t * a shared platform adapter would expose cross-scope data, so such reads are\n\t * gated by `access.platformRead`.\n\t */\n\tscopedQueries?: boolean\n}\n\nexport interface AdapterContext {\n\tsignal?: AbortSignal\n}\n\n/** Extra context the plugin hands adapters when they register config surface. */\nexport interface AdapterRegisterContext {\n\t/** True when the plugin has a scopeResolver configured. */\n\tscoped: boolean\n\t/** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\t/**\n\t * The plugin's reportingTimezone bound for adapter use (e.g. bucketing native\n\t * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.\n\t */\n\tresolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/**\n\t * The install's goals for a request's scope, for adapters that match completions\n\t * themselves (the native engine, at ingest). Config goals today; a collection source\n\t * merges in behind the same call.\n\t */\n\tresolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n}\n\nexport interface AnalyticsAdapter {\n\treadonly id: string\n\treadonly label: string\n\treadonly capabilities: AnalyticsCapabilities\n\t/** Browser-tracker proxying/boot descriptor. Absent when the adapter has no client-side script (GA4). */\n\treadonly capture?: CaptureSupport\n\t/**\n\t * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the\n\t * adapters that register one (the native engine). Server-side only: the tracker learns\n\t * the path from `TrackerConfig.ingestPath`, and this object is never serialized.\n\t */\n\treadonly ingest?: { path: string }\n\tisConfigured(): boolean\n\tquery(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\trealtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\tregister?(config: Config, context?: AdapterRegisterContext): void\n}\n\nexport type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter\n"],"mappings":";;;;;AAQA,MAAa,iBAAiB"}
1
+ {"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\nimport type { Goal } from '../goals/types'\nimport type { CaptureSupport } from './capture'\nimport type { ServerTrack } from './serverEvent'\n\n/**\n * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every\n * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.\n */\nexport const PLATFORM_SCOPE = '*'\n\nexport type MetricKey =\n\t| 'pageviews'\n\t| 'visitors'\n\t| 'visits'\n\t| 'sessions'\n\t| 'bounceRate'\n\t| 'avgDuration'\n\t| 'scrollDepth'\n\t| 'events'\n\t| 'conversions'\n\t| 'revenue'\n\n/** Every breakdown key the contract defines; the registry request parsers validate against. */\nexport const DIMENSION_KEYS = [\n\t'page',\n\t'referrer',\n\t'source',\n\t'medium',\n\t'campaign',\n\t'utmSource',\n\t'utmMedium',\n\t'utmCampaign',\n\t'utmContent',\n\t'utmTerm',\n\t'device',\n\t'browser',\n\t'os',\n\t'country',\n\t'region',\n\t'city',\n\t'language',\n\t'event',\n\t'goal',\n] as const\n\nexport type DimensionKey = (typeof DIMENSION_KEYS)[number]\n\nexport type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month'\n\nexport interface DateRange {\n\tstart: Date\n\tend: Date\n}\n\n/** Every filter operator the contract defines; the registry request parsers validate against. */\nexport const FILTER_OPERATORS = ['eq', 'contains', 'matches'] as const\n\nexport type FilterOperator = (typeof FILTER_OPERATORS)[number]\n\nexport interface AnalyticsFilter {\n\tdimension: DimensionKey\n\toperator: FilterOperator\n\tvalue: string\n}\n\nexport interface AnalyticsQuery {\n\tpath?: string\n\thostname?: string\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tdateRange: DateRange\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\t/**\n\t * Analytics boundary this read belongs to (tenant id, site key). Undefined means\n\t * install-wide (the default). Adapters that can filter by scope apply it; others\n\t * ignore it. Always part of the surfacing cache key, so per-scope adapter\n\t * instances sharing an id never share cached results.\n\t */\n\tscope?: string\n\t/**\n\t * IANA reporting timezone the read's day boundaries are aligned to. Undefined\n\t * means UTC. Adapters that can bucket in a timezone apply it (PostHog, Umami);\n\t * others report in their own account timezone. Part of the cache key when set.\n\t */\n\ttimezone?: string\n\t/**\n\t * The scope's goal slugs, set by callers that ask for the `goal` dimension or the\n\t * `conversions` metric, and possibly empty when the scope configures no goals. Provider\n\t * adapters restrict goal rows to it, since nothing in a provider marks which of its\n\t * events are this install's goals; the native engine ignores it and matches completions\n\t * itself. `'unresolved'` is the sentinel for a goal resolver that failed: the read keeps\n\t * its site numbers, reports `goalsUnresolved`, and never shares a healthy cache key.\n\t * Part of the surfacing cache key when set.\n\t */\n\tgoalSlugs?: string[] | 'unresolved'\n}\n\nexport interface AnalyticsRow {\n\tdimensions?: Partial<Record<DimensionKey, string>>\n\tmetrics: Partial<Record<MetricKey, number>>\n\ttimestamp?: string\n}\n\nexport interface AnalyticsResult {\n\trows: AnalyticsRow[]\n\ttotals?: Partial<Record<MetricKey, number>>\n\tmeta: {\n\t\tprovider: string\n\t\tsampled?: boolean\n\t\tclamped?: boolean\n\t\tfetchedAt: string\n\t\t/** Served from an expired cache entry because the live refresh failed. */\n\t\tstale?: boolean\n\t\t/**\n\t\t * Filters the source could not carry, so the rows are wider than the query asked for.\n\t\t * A provider whose API takes one value per dimension reports the ones it dropped here.\n\t\t */\n\t\tunappliedFilters?: AnalyticsFilter[]\n\t\t/**\n\t\t * The read's goal numbers are absent because resolving them failed: it ran without\n\t\t * `AnalyticsQuery.goalSlugs`, or with `'unresolved'`, or the provider rejected the goal\n\t\t * request and the rest of the read was served without it. A scope that configured no\n\t\t * goals is an empty result instead, not this flag.\n\t\t */\n\t\tgoalsUnresolved?: true\n\t}\n}\n\n/**\n * A read carrying conversions costs a provider up to twice the requests: the goal numbers\n * come from a second, goal-filtered request the adapter issues after the plain one.\n */\nexport interface RateLimitDescriptor {\n\trequestsPerMinute?: number\n\trequestsPerHour?: number\n\tmaxConcurrent?: number\n\t/**\n\t * Describes the provider's quota model for documentation; the limiter always\n\t * throttles by request count regardless of this value.\n\t */\n\tquotaModel?: 'requests' | 'tokens'\n\t/** Documents whether reads consume the provider's write/ingest quota too. */\n\treadsCountAsUsage?: boolean\n}\n\nexport interface AnalyticsCapabilities {\n\tperPageQuery: boolean\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\t/**\n\t * Period-over-period comparison, which the engine serves for every source by reading the\n\t * previous window itself. Adapters omit this; set it false only to opt a source out.\n\t */\n\tcomparison?: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n\tmetrics: ReadonlySet<MetricKey>\n\tdimensions: ReadonlySet<DimensionKey>\n\t/** Dimensions the adapter can apply AnalyticsQuery.filters on; empty = filters unsupported. */\n\tfilters: ReadonlySet<DimensionKey>\n\t/** Operators the adapter honors in filters; adapters ignore filters whose operator they lack. */\n\tfilterOperators: ReadonlySet<FilterOperator>\n\tbatchPageReport: boolean\n\trateLimit: RateLimitDescriptor | null\n\trecommendedTtl: { realtime: number; aggregate: number }\n\t/**\n\t * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native\n\t * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through\n\t * a shared platform adapter would expose cross-scope data, so such reads are\n\t * gated by `access.platformRead`.\n\t */\n\tscopedQueries?: boolean\n}\n\nexport interface AdapterContext {\n\tsignal?: AbortSignal\n}\n\n/** Extra context the plugin hands adapters when they register config surface. */\nexport interface AdapterRegisterContext {\n\t/** True when the plugin has a scopeResolver configured. */\n\tscoped: boolean\n\t/** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\t/**\n\t * The plugin's reportingTimezone bound for adapter use (e.g. bucketing native\n\t * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.\n\t */\n\tresolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/**\n\t * The install's goals for a request's scope, for adapters that match completions\n\t * themselves (the native engine, at ingest). Config goals, with the goals collection\n\t * merged over them per scope once the install enables it.\n\t */\n\tresolveGoals: (req: PayloadRequest, scope?: string | null) => Promise<Goal[]>\n}\n\nexport interface AnalyticsAdapter {\n\treadonly id: string\n\treadonly label: string\n\treadonly capabilities: AnalyticsCapabilities\n\t/** Browser-tracker proxying/boot descriptor. Absent when no public capture field is set. */\n\treadonly capture?: CaptureSupport\n\t/**\n\t * Where this adapter's own ingest endpoint listens, relative to `routes.api`, for the\n\t * adapters that register one (the native engine), and how server code reaches the same\n\t * pipeline without an HTTP round trip. Server-side only: the tracker learns the path\n\t * from `TrackerConfig.ingestPath`, and this object is never serialized.\n\t */\n\treadonly ingest?: { path: string; track?: ServerTrack }\n\tisConfigured(): boolean\n\tquery(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\trealtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\tregister?(config: Config, context?: AdapterRegisterContext): void\n}\n\nexport type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter\n"],"mappings":";;;;;AASA,MAAa,iBAAiB;;AAe9B,MAAa,iBAAiB;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;AAYA,MAAa,mBAAmB;CAAC;CAAM;CAAY;AAAS"}
@@ -12,6 +12,6 @@ const GRANULARITY_ORDER = [
12
12
  */
13
13
  const supportsGranularity = (caps, g) => GRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity);
14
14
  //#endregion
15
- export { supportsGranularity };
15
+ export { GRANULARITY_ORDER, supportsGranularity };
16
16
 
17
17
  //# sourceMappingURL=granularity.js.map
@@ -1,8 +1,9 @@
1
1
  import { Goal } from "../goals/types.js";
2
- import { AnalyticsAdapter } from "./contract.js";
3
- import { TranslationsOption } from "../translations/index.js";
2
+ import { AnalyticsAdapter, MetricKey } from "./contract.js";
4
3
  import { AnalyticsBinding } from "../binding/types.js";
5
4
  import { CaptureSlot } from "../capture/slots.js";
5
+ import { TimeframePreset } from "../timeframe/presets.js";
6
+ import { TranslationsOption } from "../translations/index.js";
6
7
  import { CustomWidgetDef } from "../widgets/customWidget.js";
7
8
  import { CollectionConfig, CollectionSlug, Payload, PayloadRequest } from "payload";
8
9
  import { KeysConfig } from "@10x-media/fields/encrypted";
@@ -72,7 +73,22 @@ type ProvidersOptions = {
72
73
  type PlatformReadAccess = (args: {
73
74
  req: PayloadRequest;
74
75
  }) => boolean | Promise<boolean>;
76
+ /** Access checker for authenticated analytics reads. */
77
+ type AnalyticsReadAccess = (args: {
78
+ req: PayloadRequest;
79
+ }) => boolean | Promise<boolean>;
80
+ /** Access checker for the analytics admin view. */
81
+ type AnalyticsViewAccess = (args: {
82
+ req: PayloadRequest;
83
+ }) => boolean | Promise<boolean>;
75
84
  type AnalyticsAccessOptions = {
85
+ /**
86
+ * Gates every authenticated read endpoint: query, document panel, realtime, sources
87
+ * and goals. Defaults to any authenticated user; narrow it to a role check to keep
88
+ * analytics away from admins who should not see them. Scope gating is separate and
89
+ * always applies: granting `read` never widens which scope a user reads.
90
+ */
91
+ read?: AnalyticsReadAccess;
76
92
  /**
77
93
  * Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through
78
94
  * a shared config adapter that cannot filter by scope. Scoped installs
@@ -81,6 +97,12 @@ type AnalyticsAccessOptions = {
81
97
  * providers. Unscoped installs default to any authenticated admin-panel user.
82
98
  */
83
99
  platformRead?: PlatformReadAccess;
100
+ /**
101
+ * Gates the analytics admin view. Defaults to `read`, so one gate covers the view and
102
+ * the endpoints behind it. A reader this denies still sees the nav link (it is a client
103
+ * component with no access context) and lands on the view's no-access message.
104
+ */
105
+ view?: AnalyticsViewAccess;
84
106
  };
85
107
  type ConsentMode = 'none' | 'required';
86
108
  /** Per-slot consent decision, evaluated against the slot's resolved adapter. */
@@ -110,11 +132,28 @@ type AutoCaptureOptions = {
110
132
  outboundLinks?: boolean;
111
133
  fileDownloads?: boolean;
112
134
  goalAttribute?: boolean;
135
+ /**
136
+ * Send each pageview's query string so ingest can extract its utm keys. The raw query is
137
+ * never stored, only the five campaign values; set false to stop sending it at all.
138
+ */
139
+ query?: boolean;
113
140
  };
114
141
  type ResolvedAutoCapture = Required<AutoCaptureOptions>;
115
- /** Goals as config: the array form, or the object form 1b grows a collection source on. */
142
+ type AnalyticsGoalsCollectionOptions = {
143
+ /** Set false to keep the object form's other settings while leaving the collection off. */enabled?: boolean;
144
+ slug?: string;
145
+ /**
146
+ * Field matched against the resolved scope when looking up a scope's goals. Point it at
147
+ * a tenant plugin's field (e.g. 'tenant') when that plugin manages scoping.
148
+ */
149
+ scopeField?: string;
150
+ overrides?: (collection: CollectionConfig) => CollectionConfig;
151
+ access?: Partial<CollectionConfig['access']>;
152
+ };
153
+ /** Goals as config, plus the opt-in collection editors manage their own goals through. */
116
154
  type AnalyticsGoalsOptions = {
117
- defaults?: Goal[];
155
+ defaults?: Goal[]; /** Opt-in admin collection whose goals merge over `defaults`, by slug, per scope. */
156
+ collection?: boolean | AnalyticsGoalsCollectionOptions;
118
157
  };
119
158
  type AnalyticsCaptureOptions = {
120
159
  /**
@@ -155,6 +194,16 @@ type AnalyticsCaptureOptions = {
155
194
  maxBodyBytes?: number;
156
195
  };
157
196
  };
197
+ type AnalyticsViewOptions = {
198
+ /** Admin path the view mounts at, under `routes.admin`. Default `/analytics`. */path?: `/${string}`; /** Timeframe the view opens on before the URL says otherwise. Default `last30days`. */
199
+ defaultRange?: TimeframePreset; /** Metric the cards and the trend open on. Default `pageviews`. */
200
+ defaultMetric?: MetricKey;
201
+ /**
202
+ * Nav link label. A string is used as-is; a map is keyed by admin language code and
203
+ * falls back to `en`. Unset, the plugin's own translated label applies.
204
+ */
205
+ navLabel?: string | Record<string, string>;
206
+ };
158
207
  type AnalyticsPluginOptions = {
159
208
  disabled?: boolean;
160
209
  /**
@@ -191,6 +240,11 @@ type AnalyticsPluginOptions = {
191
240
  */
192
241
  platformAdapter?: string;
193
242
  access?: AnalyticsAccessOptions;
243
+ /**
244
+ * The analytics admin view and its nav link, on by default. `false` registers neither;
245
+ * the read endpoints stay mounted either way, so a custom surface keeps working.
246
+ */
247
+ view?: false | AnalyticsViewOptions;
194
248
  capture?: AnalyticsCaptureOptions;
195
249
  /**
196
250
  * Conversion goals the tracker and the native ingest match events against. Slugs must
@@ -223,8 +277,9 @@ type AnalyticsPluginOptions = {
223
277
  localizeText?: boolean;
224
278
  /**
225
279
  * Period-over-period comparison on the metric and trend widgets. On by
226
- * default for adapters that declare `capabilities.comparison`; set false
227
- * to skip the second (previous-window) read entirely.
280
+ * default for every source except one whose adapter sets
281
+ * `capabilities.comparison` false; set false to skip the second
282
+ * (previous-window) read entirely.
228
283
  */
229
284
  comparison?: boolean;
230
285
  };
@@ -243,5 +298,5 @@ type AnalyticsPluginOptions = {
243
298
  };
244
299
  };
245
300
  //#endregion
246
- export { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ResolvedAutoCapture, ScopeResolver, ScopesResolver, TimezoneResolver };
301
+ export { AnalyticsAccessOptions, AnalyticsCaptureOptions, AnalyticsGoalsCollectionOptions, AnalyticsGoalsOptions, AnalyticsPluginOptions, AnalyticsReadAccess, AnalyticsViewAccess, AnalyticsViewOptions, AutoCaptureOptions, CaptureConsentOption, ConsentMode, ConsentResolver, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ResolvedAutoCapture, ScopeResolver, ScopesResolver, TimezoneResolver };
247
302
  //# sourceMappingURL=options.d.ts.map