@10x-media/analytics 0.1.0-beta.0 → 0.1.0-beta.2

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 (285) hide show
  1. package/CHANGELOG.md +127 -0
  2. package/README.md +38 -357
  3. package/dist/adapters/ga4/ga4.d.ts +20 -0
  4. package/dist/adapters/ga4/ga4.js +187 -0
  5. package/dist/adapters/ga4/ga4.js.map +1 -0
  6. package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
  7. package/dist/adapters/http/fetchJson.js.map +1 -0
  8. package/dist/adapters/plausible/plausible.d.ts +15 -0
  9. package/dist/adapters/plausible/plausible.js +148 -0
  10. package/dist/adapters/plausible/plausible.js.map +1 -0
  11. package/dist/adapters/posthog/posthog.d.ts +23 -0
  12. package/dist/adapters/posthog/posthog.js +132 -0
  13. package/dist/adapters/posthog/posthog.js.map +1 -0
  14. package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
  15. package/dist/adapters/series.js.map +1 -0
  16. package/dist/adapters/umami/umami.d.ts +18 -0
  17. package/dist/adapters/umami/umami.js +139 -0
  18. package/dist/{exports/adapters → adapters/umami}/umami.js.map +1 -1
  19. package/dist/binding/resolvePath.js +61 -0
  20. package/dist/binding/resolvePath.js.map +1 -0
  21. package/dist/binding/types.d.ts +55 -0
  22. package/dist/charts/BarList.d.ts +20 -0
  23. package/dist/charts/BarList.js +73 -0
  24. package/dist/charts/BarList.js.map +1 -0
  25. package/dist/charts/TrendChart.d.ts +25 -0
  26. package/dist/charts/TrendChart.js +195 -0
  27. package/dist/charts/TrendChart.js.map +1 -0
  28. package/dist/charts/bars.d.ts +9 -0
  29. package/dist/charts/bars.js +19 -0
  30. package/dist/charts/bars.js.map +1 -0
  31. package/dist/charts/bucket.js +86 -0
  32. package/dist/charts/bucket.js.map +1 -0
  33. package/dist/charts/spline.js +84 -0
  34. package/dist/charts/spline.js.map +1 -0
  35. package/dist/charts/styles.js +42 -0
  36. package/dist/charts/styles.js.map +1 -0
  37. package/dist/core/cacheKey.js +28 -0
  38. package/dist/core/cacheKey.js.map +1 -0
  39. package/dist/core/capabilities.d.ts +12 -0
  40. package/dist/core/capabilities.js +12 -0
  41. package/dist/core/capabilities.js.map +1 -0
  42. package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +42 -5
  43. package/dist/core/contract.js +10 -0
  44. package/dist/core/contract.js.map +1 -0
  45. package/dist/core/granularity.js +17 -0
  46. package/dist/core/granularity.js.map +1 -0
  47. package/dist/core/options.d.ts +140 -0
  48. package/dist/core/options.js +114 -0
  49. package/dist/core/options.js.map +1 -0
  50. package/dist/core/registry.js +24 -0
  51. package/dist/core/registry.js.map +1 -0
  52. package/dist/core/scopedRead.js +57 -0
  53. package/dist/core/scopedRead.js.map +1 -0
  54. package/dist/exports/adapters/ga4.d.ts +2 -20
  55. package/dist/exports/adapters/ga4.js +1 -176
  56. package/dist/exports/adapters/native.d.ts +2 -22
  57. package/dist/exports/adapters/native.js +1 -848
  58. package/dist/exports/adapters/plausible.d.ts +2 -15
  59. package/dist/exports/adapters/plausible.js +1 -142
  60. package/dist/exports/adapters/posthog.d.ts +2 -17
  61. package/dist/exports/adapters/posthog.js +1 -118
  62. package/dist/exports/adapters/umami.d.ts +2 -18
  63. package/dist/exports/adapters/umami.js +1 -138
  64. package/dist/exports/client.d.ts +5 -77
  65. package/dist/exports/client.js +4 -386
  66. package/dist/exports/geo.d.ts +4 -19
  67. package/dist/exports/geo.js +3 -1
  68. package/dist/exports/i18n.d.ts +3 -63
  69. package/dist/exports/i18n.js +2 -2
  70. package/dist/exports/next.d.ts +2 -0
  71. package/dist/exports/next.js +2 -0
  72. package/dist/exports/rsc.d.ts +16 -120
  73. package/dist/exports/rsc.js +14 -598
  74. package/dist/exports/types.d.ts +6 -4
  75. package/dist/exports/types.js +2 -1
  76. package/dist/fields/AnalyticsPanelClient.js +193 -0
  77. package/dist/fields/AnalyticsPanelClient.js.map +1 -0
  78. package/dist/fields/AnalyticsPanelField.d.ts +28 -0
  79. package/dist/fields/AnalyticsPanelField.js +54 -0
  80. package/dist/fields/AnalyticsPanelField.js.map +1 -0
  81. package/dist/fields/AnalyticsStatField.d.ts +31 -0
  82. package/dist/fields/AnalyticsStatField.js +104 -0
  83. package/dist/fields/AnalyticsStatField.js.map +1 -0
  84. package/dist/fields/dateRange/field.js +55 -0
  85. package/dist/fields/dateRange/field.js.map +1 -0
  86. package/dist/fields/dateRange/styles.js +23 -0
  87. package/dist/fields/dateRange/styles.js.map +1 -0
  88. package/dist/fields/dateRange/types.d.ts +11 -0
  89. package/dist/fields/dateRange/ui.d.ts +9 -0
  90. package/dist/fields/dateRange/ui.js +373 -0
  91. package/dist/fields/dateRange/ui.js.map +1 -0
  92. package/dist/fields/emptyState.js +46 -0
  93. package/dist/fields/emptyState.js.map +1 -0
  94. package/dist/fields/factories.d.ts +60 -0
  95. package/dist/fields/factories.js +94 -0
  96. package/dist/fields/factories.js.map +1 -0
  97. package/dist/fields/format.d.ts +7 -0
  98. package/dist/fields/format.js +22 -0
  99. package/dist/fields/format.js.map +1 -0
  100. package/dist/fields/readForDocument.d.ts +57 -0
  101. package/dist/fields/readForDocument.js +147 -0
  102. package/dist/fields/readForDocument.js.map +1 -0
  103. package/dist/index.d.ts +18 -3
  104. package/dist/index.js +83 -1028
  105. package/dist/index.js.map +1 -1
  106. package/dist/native/collections/events.js +101 -0
  107. package/dist/native/collections/events.js.map +1 -0
  108. package/dist/native/collections/rollups.js +115 -0
  109. package/dist/native/collections/rollups.js.map +1 -0
  110. package/dist/native/collections/seen.js +47 -0
  111. package/dist/native/collections/seen.js.map +1 -0
  112. package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
  113. package/dist/native/geo/composeGeoResolvers.js +14 -0
  114. package/dist/native/geo/composeGeoResolvers.js.map +1 -0
  115. package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
  116. package/dist/native/geo/geoResolver.js +11 -0
  117. package/dist/native/geo/geoResolver.js.map +1 -0
  118. package/dist/native/geo/maxmindResolver.d.ts +16 -0
  119. package/dist/native/geo/maxmindResolver.js +55 -0
  120. package/dist/native/geo/maxmindResolver.js.map +1 -0
  121. package/dist/native/ingest/device.js +15 -0
  122. package/dist/native/ingest/device.js.map +1 -0
  123. package/dist/native/ingest/endpoint.js +30 -0
  124. package/dist/native/ingest/endpoint.js.map +1 -0
  125. package/dist/native/ingest/flushBatch.js +69 -0
  126. package/dist/native/ingest/flushBatch.js.map +1 -0
  127. package/dist/native/ingest/normalizeEvent.js +39 -0
  128. package/dist/native/ingest/normalizeEvent.js.map +1 -0
  129. package/dist/native/ingest/salt.js +14 -0
  130. package/dist/native/ingest/salt.js.map +1 -0
  131. package/dist/native/ingest/source.js +22 -0
  132. package/dist/native/ingest/source.js.map +1 -0
  133. package/dist/native/ingest/visitorHash.js +12 -0
  134. package/dist/native/ingest/visitorHash.js.map +1 -0
  135. package/dist/native/ingest/writeBuffer.js +55 -0
  136. package/dist/native/ingest/writeBuffer.js.map +1 -0
  137. package/dist/native/ingest/writeEvent.js +14 -0
  138. package/dist/native/ingest/writeEvent.js.map +1 -0
  139. package/dist/native/nativeAdapter.d.ts +22 -0
  140. package/dist/native/nativeAdapter.js +216 -0
  141. package/dist/native/nativeAdapter.js.map +1 -0
  142. package/dist/native/realtime/buildRealtime.js +53 -0
  143. package/dist/native/realtime/buildRealtime.js.map +1 -0
  144. package/dist/native/retention/pruneTask.js +29 -0
  145. package/dist/native/retention/pruneTask.js.map +1 -0
  146. package/dist/native/rollupAcc.js +53 -0
  147. package/dist/native/rollupAcc.js.map +1 -0
  148. package/dist/native/rollups/applyDistinctDeltas.js +9 -0
  149. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
  150. package/dist/native/rollups/bumpRollup.js +52 -0
  151. package/dist/native/rollups/bumpRollup.js.map +1 -0
  152. package/dist/native/rollups/deltas.js +31 -0
  153. package/dist/native/rollups/deltas.js.map +1 -0
  154. package/dist/native/rollups/insertIfNew.js +19 -0
  155. package/dist/native/rollups/insertIfNew.js.map +1 -0
  156. package/dist/next/posthogProxyRewrites.d.ts +36 -0
  157. package/dist/next/posthogProxyRewrites.js +50 -0
  158. package/dist/next/posthogProxyRewrites.js.map +1 -0
  159. package/dist/plugin/documentEndpoint.js +80 -0
  160. package/dist/plugin/documentEndpoint.js.map +1 -0
  161. package/dist/plugin/paths.js +11 -0
  162. package/dist/plugin/paths.js.map +1 -0
  163. package/dist/plugin/realtimeEndpoint.js +36 -0
  164. package/dist/plugin/realtimeEndpoint.js.map +1 -0
  165. package/dist/plugin/registerTranslations.js +19 -0
  166. package/dist/plugin/registerTranslations.js.map +1 -0
  167. package/dist/plugin/runtime.js +21 -0
  168. package/dist/plugin/runtime.js.map +1 -0
  169. package/dist/plugin/warmTask.js +165 -0
  170. package/dist/plugin/warmTask.js.map +1 -0
  171. package/dist/providers/collection.js +159 -0
  172. package/dist/providers/collection.js.map +1 -0
  173. package/dist/providers/factory.js +62 -0
  174. package/dist/providers/factory.js.map +1 -0
  175. package/dist/providers/resolver.js +67 -0
  176. package/dist/providers/resolver.js.map +1 -0
  177. package/dist/providers/secrets.js +27 -0
  178. package/dist/providers/secrets.js.map +1 -0
  179. package/dist/surfacing/cacheStore.js +26 -0
  180. package/dist/surfacing/cacheStore.js.map +1 -0
  181. package/dist/surfacing/coalesce.js +15 -0
  182. package/dist/surfacing/coalesce.js.map +1 -0
  183. package/dist/surfacing/engine.js +63 -0
  184. package/dist/surfacing/engine.js.map +1 -0
  185. package/dist/surfacing/queue.js +44 -0
  186. package/dist/surfacing/queue.js.map +1 -0
  187. package/dist/sync/collection.js +70 -0
  188. package/dist/sync/collection.js.map +1 -0
  189. package/dist/sync/syncTask.js +123 -0
  190. package/dist/sync/syncTask.js.map +1 -0
  191. package/dist/testing/memoryAdapter.d.ts +1 -1
  192. package/dist/timeframe/presets.d.ts +6 -0
  193. package/dist/timeframe/presets.js +59 -0
  194. package/dist/timeframe/presets.js.map +1 -0
  195. package/dist/timeframe/tz.js +110 -0
  196. package/dist/timeframe/tz.js.map +1 -0
  197. package/dist/translations/de.js +78 -0
  198. package/dist/translations/de.js.map +1 -0
  199. package/dist/{translations-keiKtSjF.js → translations/en.js} +30 -25
  200. package/dist/translations/en.js.map +1 -0
  201. package/dist/translations/index.d.ts +15 -0
  202. package/dist/translations/index.js +30 -0
  203. package/dist/translations/index.js.map +1 -0
  204. package/dist/translations/keys.d.ts +81 -0
  205. package/dist/{keys-DEqL4LOT.js → translations/keys.js} +29 -5
  206. package/dist/translations/keys.js.map +1 -0
  207. package/dist/translations/metricKeys.js +28 -0
  208. package/dist/translations/metricKeys.js.map +1 -0
  209. package/dist/translations/server.js +13 -0
  210. package/dist/translations/server.js.map +1 -0
  211. package/dist/translations/useTranslation.js +12 -0
  212. package/dist/translations/useTranslation.js.map +1 -0
  213. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
  214. package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
  215. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
  216. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
  217. package/dist/widgets/AnalyticsMetricWidget.js +89 -0
  218. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
  219. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
  220. package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
  221. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
  222. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
  223. package/dist/widgets/AnalyticsTrendWidget.js +99 -0
  224. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
  225. package/dist/widgets/ComparisonDelta.js +83 -0
  226. package/dist/widgets/ComparisonDelta.js.map +1 -0
  227. package/dist/widgets/RealtimeCounter.d.ts +19 -0
  228. package/dist/widgets/RealtimeCounter.js +76 -0
  229. package/dist/widgets/RealtimeCounter.js.map +1 -0
  230. package/dist/widgets/breakdownTypes.js +29 -0
  231. package/dist/widgets/breakdownTypes.js.map +1 -0
  232. package/dist/widgets/cardChrome.d.ts +8 -0
  233. package/dist/widgets/cardChrome.js +22 -0
  234. package/dist/widgets/cardChrome.js.map +1 -0
  235. package/dist/widgets/comparison.js +43 -0
  236. package/dist/widgets/comparison.js.map +1 -0
  237. package/dist/widgets/customWidget.d.ts +20 -0
  238. package/dist/widgets/customWidget.js +30 -0
  239. package/dist/widgets/customWidget.js.map +1 -0
  240. package/dist/widgets/defaults.d.ts +12 -0
  241. package/dist/widgets/defaults.js +72 -0
  242. package/dist/widgets/defaults.js.map +1 -0
  243. package/dist/widgets/range.js +28 -0
  244. package/dist/widgets/range.js.map +1 -0
  245. package/dist/widgets/readForWidget.d.ts +31 -0
  246. package/dist/widgets/readForWidget.js +72 -0
  247. package/dist/widgets/readForWidget.js.map +1 -0
  248. package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
  249. package/dist/widgets/readForWidgetBreakdown.js +80 -0
  250. package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
  251. package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
  252. package/dist/widgets/readForWidgetRealtime.js +63 -0
  253. package/dist/widgets/readForWidgetRealtime.js.map +1 -0
  254. package/dist/widgets/readForWidgetSeries.d.ts +44 -0
  255. package/dist/widgets/readForWidgetSeries.js +117 -0
  256. package/dist/widgets/readForWidgetSeries.js.map +1 -0
  257. package/dist/widgets/realtimePoll.js +26 -0
  258. package/dist/widgets/realtimePoll.js.map +1 -0
  259. package/dist/widgets/registerWidgets.js +228 -0
  260. package/dist/widgets/registerWidgets.js.map +1 -0
  261. package/dist/widgets/types.js +13 -0
  262. package/dist/widgets/types.js.map +1 -0
  263. package/package.json +19 -5
  264. package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
  265. package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
  266. package/dist/dist-B6HruP5v.js +0 -4731
  267. package/dist/dist-B6HruP5v.js.map +0 -1
  268. package/dist/exports/adapters/ga4.js.map +0 -1
  269. package/dist/exports/adapters/native.js.map +0 -1
  270. package/dist/exports/adapters/plausible.js.map +0 -1
  271. package/dist/exports/adapters/posthog.js.map +0 -1
  272. package/dist/exports/client.js.map +0 -1
  273. package/dist/exports/rsc.js.map +0 -1
  274. package/dist/fetchJson-DZb2_Puj.js.map +0 -1
  275. package/dist/index-CZdCT0WJ.d.ts +0 -98
  276. package/dist/keys-DEqL4LOT.js.map +0 -1
  277. package/dist/lib-CE5x1zLQ.js +0 -1058
  278. package/dist/lib-CE5x1zLQ.js.map +0 -1
  279. package/dist/maxmindResolver-CXYXXdul.js +0 -99
  280. package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
  281. package/dist/presets-CBfq_uJX.d.ts +0 -38
  282. package/dist/series-zytbzPoc.js.map +0 -1
  283. package/dist/server-Cuvhgz-S.js +0 -492
  284. package/dist/server-Cuvhgz-S.js.map +0 -1
  285. package/dist/translations-keiKtSjF.js.map +0 -1
@@ -0,0 +1,9 @@
1
+ //#region src/charts/bars.d.ts
2
+ interface BarDatum {
3
+ label: string;
4
+ value: number;
5
+ display?: string;
6
+ }
7
+ //#endregion
8
+ export { BarDatum };
9
+ //# sourceMappingURL=bars.d.ts.map
@@ -0,0 +1,19 @@
1
+ //#region src/charts/bars.ts
2
+ /**
3
+ * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked
4
+ * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide
5
+ * by zero.
6
+ */
7
+ const toBarRows = (data) => {
8
+ const max = data.reduce((m, d) => Math.max(m, d.value), 0);
9
+ return data.map((d) => ({
10
+ label: d.label,
11
+ value: d.value,
12
+ fraction: max > 0 ? d.value / max : 0,
13
+ display: d.display
14
+ }));
15
+ };
16
+ //#endregion
17
+ export { toBarRows };
18
+
19
+ //# sourceMappingURL=bars.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bars.js","names":[],"sources":["../../src/charts/bars.ts"],"sourcesContent":["export interface BarDatum {\n\tlabel: string\n\tvalue: number\n\tdisplay?: string\n}\n\nexport interface BarRow {\n\tlabel: string\n\tvalue: number\n\tfraction: number\n\tdisplay?: string\n}\n\n/**\n * Scale each datum's value to a `[0, 1]` fraction of the largest value, for a ranked\n * bar list. A degenerate all-zero set yields zero fractions (no bar), never a divide\n * by zero.\n */\nexport const toBarRows = (data: BarDatum[]): BarRow[] => {\n\tconst max = data.reduce((m, d) => Math.max(m, d.value), 0)\n\treturn data.map((d) => ({\n\t\tlabel: d.label,\n\t\tvalue: d.value,\n\t\tfraction: max > 0 ? d.value / max : 0,\n\t\tdisplay: d.display,\n\t}))\n}\n"],"mappings":";;;;;;AAkBA,MAAa,aAAa,SAA+B;CACxD,MAAM,MAAM,KAAK,QAAQ,GAAG,MAAM,KAAK,IAAI,GAAG,EAAE,KAAK,GAAG,CAAC;CACzD,OAAO,KAAK,KAAK,OAAO;EACvB,OAAO,EAAE;EACT,OAAO,EAAE;EACT,UAAU,MAAM,IAAI,EAAE,QAAQ,MAAM;EACpC,SAAS,EAAE;CACZ,EAAE;AACH"}
@@ -0,0 +1,86 @@
1
+ import { startOfDayInTz, startOfMonthInTz, startOfWeekInTz } from "../timeframe/tz.js";
2
+ //#region src/charts/bucket.ts
3
+ const UNIT_BY_TIMEFRAME = {
4
+ today: "day",
5
+ last7days: "day",
6
+ last30days: "day",
7
+ thisMonth: "day",
8
+ last90days: "week",
9
+ thisYear: "month",
10
+ lastYear: "month",
11
+ allTime: "month"
12
+ };
13
+ const bucketStart = (d, unit, tz) => {
14
+ if (unit === "month") return startOfMonthInTz(d, tz);
15
+ if (unit === "week") return startOfWeekInTz(d, tz);
16
+ return startOfDayInTz(d, tz);
17
+ };
18
+ const bucketByUnit = (points, { unit, weekday, tz }) => {
19
+ const groups = /* @__PURE__ */ new Map();
20
+ for (const p of points) {
21
+ const d = bucketStart(new Date(p.date), unit, tz);
22
+ const key = d.toISOString();
23
+ const g = groups.get(key);
24
+ if (g) g.value += p.value;
25
+ else groups.set(key, {
26
+ date: d,
27
+ value: p.value
28
+ });
29
+ }
30
+ const sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
31
+ const multiYear = new Set(sorted.map((g) => new Intl.DateTimeFormat("en-US", {
32
+ year: "numeric",
33
+ timeZone: tz
34
+ }).format(g.date))).size > 1;
35
+ const format = (d) => {
36
+ if (weekday) return new Intl.DateTimeFormat("en-US", {
37
+ weekday: "short",
38
+ timeZone: tz
39
+ }).format(d);
40
+ if (unit === "month") return new Intl.DateTimeFormat("en-US", {
41
+ month: "short",
42
+ year: multiYear ? "numeric" : void 0,
43
+ timeZone: tz
44
+ }).format(d);
45
+ return new Intl.DateTimeFormat("en-US", {
46
+ month: "short",
47
+ day: "numeric",
48
+ timeZone: tz
49
+ }).format(d);
50
+ };
51
+ return sorted.map((g) => ({
52
+ label: format(g.date),
53
+ value: g.value
54
+ }));
55
+ };
56
+ /**
57
+ * Aggregate a daily series into display buckets sized to the timeframe (day for short
58
+ * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and
59
+ * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting
60
+ * timezone the series and comparison windows are aligned to. Distinct metrics are summed
61
+ * per bucket (a documented daily-uniques approximation).
62
+ */
63
+ const bucketSeries = (points, timeframe, tz = "UTC") => bucketByUnit(points, {
64
+ unit: UNIT_BY_TIMEFRAME[timeframe],
65
+ weekday: timeframe === "last7days" || timeframe === "today",
66
+ tz
67
+ });
68
+ const DAY = 864e5;
69
+ const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
70
+ /**
71
+ * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from
72
+ * the span the way the presets do: short ranges by day, a quarter by week, longer by
73
+ * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for
74
+ * the fixed 7-day preset, never here.
75
+ */
76
+ const bucketByRange = (points, range, tz = "UTC") => {
77
+ return bucketByUnit(points, {
78
+ unit: unitForSpan(Math.round((range.end.getTime() - range.start.getTime()) / DAY)),
79
+ weekday: false,
80
+ tz
81
+ });
82
+ };
83
+ //#endregion
84
+ export { bucketByRange, bucketSeries };
85
+
86
+ //# sourceMappingURL=bucket.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport {\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfWeekInTz,\n} from '../timeframe/tz'\nimport type { SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport interface ChartBucket {\n\tlabel: string\n\tvalue: number\n}\n\ntype Unit = 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, Unit> = {\n\ttoday: 'day',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst bucketStart = (d: Date, unit: Unit, tz: string): Date => {\n\tif (unit === 'month') return startOfMonthInTz(d, tz)\n\tif (unit === 'week') return startOfWeekInTz(d, tz)\n\treturn startOfDayInTz(d, tz)\n}\n\ninterface BucketConfig {\n\tunit: Unit\n\t/** Label each bucket by weekday (only the fixed 7-day / today presets). */\n\tweekday: boolean\n\ttz: string\n}\n\nconst bucketByUnit = (\n\tpoints: SeriesPoint[],\n\t{ unit, weekday, tz }: BucketConfig\n): ChartBucket[] => {\n\tconst groups = new Map<string, { date: Date; value: number }>()\n\tfor (const p of points) {\n\t\tconst d = bucketStart(new Date(p.date), unit, tz)\n\t\tconst key = d.toISOString()\n\t\tconst g = groups.get(key)\n\t\tif (g) {\n\t\t\tg.value += p.value\n\t\t} else {\n\t\t\tgroups.set(key, { date: d, value: p.value })\n\t\t}\n\t}\n\tconst sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime())\n\t// The label reads each bucket's start in the reporting timezone, so a zone whose day\n\t// starts fall on the previous UTC calendar day still labels the correct local date.\n\tconst years = new Set(\n\t\tsorted.map((g) =>\n\t\t\tnew Intl.DateTimeFormat('en-US', { year: 'numeric', timeZone: tz }).format(g.date)\n\t\t)\n\t)\n\tconst multiYear = years.size > 1\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: tz }).format(d)\n\t\t}\n\t\tif (unit === 'month') {\n\t\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\t\tmonth: 'short',\n\t\t\t\tyear: multiYear ? 'numeric' : undefined,\n\t\t\t\ttimeZone: tz,\n\t\t\t}).format(d)\n\t\t}\n\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\tmonth: 'short',\n\t\t\tday: 'numeric',\n\t\t\ttimeZone: tz,\n\t\t}).format(d)\n\t}\n\treturn sorted.map((g) => ({ label: format(g.date), value: g.value }))\n}\n\n/**\n * Aggregate a daily series into display buckets sized to the timeframe (day for short\n * ranges, week for ~quarter, month for year+), each with a formatted label. Buckets and\n * labels resolve in `tz` (defaulting to UTC) so the axis lines up with the reporting\n * timezone the series and comparison windows are aligned to. Distinct metrics are summed\n * per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] =>\n\tbucketByUnit(points, {\n\t\tunit: UNIT_BY_TIMEFRAME[timeframe],\n\t\tweekday: timeframe === 'last7days' || timeframe === 'today',\n\t\ttz,\n\t})\n\nconst DAY = 86_400_000\n\nconst unitForSpan = (spanDays: number): Unit =>\n\tspanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n\n/**\n * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from\n * the span the way the presets do: short ranges by day, a quarter by week, longer by\n * month. Buckets resolve in `tz` (defaulting to UTC); weekday labels are only used for\n * the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (\n\tpoints: SeriesPoint[],\n\trange: DateRange,\n\ttz: string = DEFAULT_TIMEZONE\n): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, { unit: unitForSpan(spanDays), weekday: false, tz })\n}\n"],"mappings":";;AAiBA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,eAAe,GAAS,MAAY,OAAqB;CAC9D,IAAI,SAAS,SAAS,OAAO,iBAAiB,GAAG,EAAE;CACnD,IAAI,SAAS,QAAQ,OAAO,gBAAgB,GAAG,EAAE;CACjD,OAAO,eAAe,GAAG,EAAE;AAC5B;AASA,MAAM,gBACL,QACA,EAAE,MAAM,SAAS,SACE;CACnB,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE;EAChD,MAAM,MAAM,EAAE,YAAY;EAC1B,MAAM,IAAI,OAAO,IAAI,GAAG;EACxB,IAAI,GACH,EAAE,SAAS,EAAE;OAEb,OAAO,IAAI,KAAK;GAAE,MAAM;GAAG,OAAO,EAAE;EAAM,CAAC;CAE7C;CACA,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;CAQtF,MAAM,YAAY,IALA,IACjB,OAAO,KAAK,MACX,IAAI,KAAK,eAAe,SAAS;EAAE,MAAM;EAAW,UAAU;CAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAClF,CAEqB,EAAE,OAAO;CAC/B,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAG,CAAC,EAAE,OAAO,CAAC;EAErF,IAAI,SAAS,SACZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,MAAM,YAAY,YAAY,KAAA;GAC9B,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;EAEZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,KAAK;GACL,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;CACZ;CACA,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE,IAAI;EAAG,OAAO,EAAE;CAAM,EAAE;AACrE;;;;;;;;AASA,MAAa,gBACZ,QACA,WACA,KAAA,UAEA,aAAa,QAAQ;CACpB,MAAM,kBAAkB;CACxB,SAAS,cAAc,eAAe,cAAc;CACpD;AACD,CAAC;AAEF,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;;AAQrD,MAAa,iBACZ,QACA,OACA,KAAA,UACmB;CAEnB,OAAO,aAAa,QAAQ;EAAE,MAAM,YADnB,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GACrB,CAAC;EAAG,SAAS;EAAO;CAAG,CAAC;AAChF"}
@@ -0,0 +1,84 @@
1
+ //#region src/charts/spline.ts
2
+ const round = (n) => Math.round(n * 100) / 100;
3
+ /**
4
+ * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the
5
+ * adjacent secant, interior points the average of neighbouring secants, then each is
6
+ * clamped so the cubic never overshoots (no wiggle between points).
7
+ */
8
+ const computeTangents = (ys) => {
9
+ const n = ys.length;
10
+ if (n < 2) return ys.map(() => 0);
11
+ const d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y);
12
+ const m = ys.map((_, i) => {
13
+ if (i === 0) return d[0] ?? 0;
14
+ if (i === n - 1) return d[n - 2] ?? 0;
15
+ return ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2;
16
+ });
17
+ for (let i = 0; i < n - 1; i++) {
18
+ const di = d[i] ?? 0;
19
+ if (di === 0) {
20
+ m[i] = 0;
21
+ m[i + 1] = 0;
22
+ continue;
23
+ }
24
+ const mi = m[i] ?? 0;
25
+ const mi1 = m[i + 1] ?? 0;
26
+ const a = mi / di;
27
+ const b = mi1 / di;
28
+ const s = a * a + b * b;
29
+ if (s > 9) {
30
+ const t = 3 / Math.sqrt(s);
31
+ m[i] = t * a * di;
32
+ m[i + 1] = t * b * di;
33
+ }
34
+ }
35
+ return m;
36
+ };
37
+ /**
38
+ * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a
39
+ * value series into a `width` x `height` box (y normalized to the value range; flat or
40
+ * single-value series sit on the vertical midline).
41
+ */
42
+ const monotoneAreaPath = (values, opts) => {
43
+ const { width, height } = opts;
44
+ const padding = opts.padding ?? 0;
45
+ if (values.length === 0) return {
46
+ line: "",
47
+ area: ""
48
+ };
49
+ const innerH = height - padding * 2;
50
+ const max = Math.max(...values);
51
+ const min = Math.min(...values);
52
+ const span = max - min || 1;
53
+ const x = (i) => round(values.length > 1 ? i / (values.length - 1) * width : 0);
54
+ const y = (v) => round(max === min ? height / 2 : padding + innerH - (v - min) / span * innerH);
55
+ const v0 = values[0] ?? 0;
56
+ if (values.length === 1) return {
57
+ line: `M0,${y(v0)} L${round(width)},${y(v0)}`,
58
+ area: ""
59
+ };
60
+ const tangents = computeTangents(values);
61
+ let line = `M${x(0)},${y(v0)}`;
62
+ for (let i = 0; i < values.length - 1; i++) {
63
+ const x0 = i;
64
+ const x1 = i + 1;
65
+ const vi = values[i] ?? 0;
66
+ const vi1 = values[i + 1] ?? 0;
67
+ const ti = tangents[i] ?? 0;
68
+ const ti1 = tangents[i + 1] ?? 0;
69
+ const cp1x = round(x(x0 + 1 / 3));
70
+ const cp1y = round(y(vi + ti / 3));
71
+ const cp2x = round(x(x1 - 1 / 3));
72
+ const cp2y = round(y(vi1 - ti1 / 3));
73
+ line += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`;
74
+ }
75
+ const area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`;
76
+ return {
77
+ line,
78
+ area
79
+ };
80
+ };
81
+ //#endregion
82
+ export { monotoneAreaPath };
83
+
84
+ //# sourceMappingURL=spline.js.map
@@ -0,0 +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":";AAWA,MAAM,SAAS,MAAsB,KAAK,MAAM,IAAI,GAAG,IAAI;;;;;;AAO3D,MAAa,mBAAmB,OAA2B;CAC1D,MAAM,IAAI,GAAG;CACb,IAAI,IAAI,GACP,OAAO,GAAG,UAAU,CAAC;CAEtB,MAAM,IAAI,GAAG,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,MAAM,KAAK,CAAC;CAC5D,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM;EAC1B,IAAI,MAAM,GAAG,OAAO,EAAE,MAAM;EAC5B,IAAI,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,MAAM;EACpC,SAAS,EAAE,IAAI,MAAM,MAAM,EAAE,MAAM,MAAM;CAC1C,CAAC;CACD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,KAAK;EAC/B,MAAM,KAAK,EAAE,MAAM;EACnB,IAAI,OAAO,GAAG;GACb,EAAE,KAAK;GACP,EAAE,IAAI,KAAK;GACX;EACD;EACA,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,MAAM,EAAE,IAAI,MAAM;EACxB,MAAM,IAAI,KAAK;EACf,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,IAAI,IAAI,IAAI;EACtB,IAAI,IAAI,GAAG;GACV,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;GACzB,EAAE,KAAK,IAAI,IAAI;GACf,EAAE,IAAI,KAAK,IAAI,IAAI;EACpB;CACD;CACA,OAAO;AACR;;;;;;AAOA,MAAa,oBAAoB,QAAkB,SAAwC;CAC1F,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,OAAO,WAAW,GACrB,OAAO;EAAE,MAAM;EAAI,MAAM;CAAG;CAE7B,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM;CAC9B,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM;CAC9B,MAAM,OAAO,MAAM,OAAO;CAC1B,MAAM,KAAK,MAAsB,MAAM,OAAO,SAAS,IAAK,KAAK,OAAO,SAAS,KAAM,QAAQ,CAAC;CAChG,MAAM,KAAK,MACV,MAAM,QAAQ,MAAM,SAAS,IAAI,UAAU,UAAW,IAAI,OAAO,OAAQ,MAAM;CAChF,MAAM,KAAK,OAAO,MAAM;CACxB,IAAI,OAAO,WAAW,GAErB,OAAO;EAAE,MAAA,MADU,EAAE,EAAE,EAAE,IAAI,MAAM,KAAK,EAAE,GAAG,EAAE,EAAE;EAClC,MAAM;CAAG;CAEzB,MAAM,WAAW,gBAAgB,MAAM;CACvC,IAAI,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;CAC3B,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,SAAS,GAAG,KAAK;EAC3C,MAAM,KAAK;EACX,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,OAAO,MAAM;EACxB,MAAM,MAAM,OAAO,IAAI,MAAM;EAC7B,MAAM,KAAK,SAAS,MAAM;EAC1B,MAAM,MAAM,SAAS,IAAI,MAAM;EAC/B,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,KAAK,KAAK,CAAC,CAAC;EACjC,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;EACnC,QAAQ,KAAK,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;CAC5D;CACA,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,OAAO,SAAS,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE;CACzF,OAAO;EAAE;EAAM;CAAK;AACrB"}
@@ -0,0 +1,42 @@
1
+ "use client";
2
+ import { jsx } from "react/jsx-runtime";
3
+ //#region src/charts/styles.tsx
4
+ const CHART_CSS = `
5
+ :where(:root) {
6
+ --analytics-chart-1: var(--theme-success-500, #3b82f6);
7
+ }
8
+ .analytics-chart { position: relative; width: 100%; }
9
+ .analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }
10
+ .analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }
11
+ .analytics-chart__area { stroke: none; }
12
+ .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
+ .analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }
14
+ .analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }
15
+ .analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }
16
+ .analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }
17
+ .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
+ .analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }
19
+ .analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }
20
+ @keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }
21
+ .analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }
22
+ .analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }
23
+ .analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }
24
+ .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; }
25
+ .analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }
26
+ .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
+ .analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }
28
+ .analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }
29
+ `;
30
+ /**
31
+ * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so
32
+ * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically
33
+ * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`
34
+ * scope so a consuming app can override them.
35
+ */
36
+ function ChartStyles() {
37
+ return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: CHART_CSS } });
38
+ }
39
+ //#endregion
40
+ export { ChartStyles };
41
+
42
+ //# sourceMappingURL=styles.js.map
@@ -0,0 +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"}
@@ -0,0 +1,28 @@
1
+ import { addDaysInTz, startOfDayInTz } from "../timeframe/tz.js";
2
+ //#region src/core/cacheKey.ts
3
+ const stable = (xs) => xs ? [...xs].sort().join(",") : "";
4
+ function buildCacheKey(provider, q) {
5
+ const pathKey = q.path ?? "site";
6
+ const tz = q.timezone ?? "UTC";
7
+ const range = `${startOfDayInTz(q.dateRange.start, tz).toISOString()}_${addDaysInTz(q.dateRange.end, 1, tz).toISOString()}`;
8
+ const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
9
+ return [
10
+ "analytics",
11
+ provider,
12
+ q.hostname ?? "_",
13
+ pathKey,
14
+ stable(q.metrics),
15
+ stable(q.dimensions),
16
+ range,
17
+ q.granularity ?? "_",
18
+ filters,
19
+ String(q.limit ?? "_"),
20
+ q.order ? `${q.order.metric}:${q.order.direction}` : "_",
21
+ ...q.timezone !== void 0 && q.timezone !== "UTC" ? [q.timezone] : [],
22
+ ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
23
+ ].join("|");
24
+ }
25
+ //#endregion
26
+ export { buildCacheKey };
27
+
28
+ //# sourceMappingURL=cacheKey.js.map
@@ -0,0 +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"}
@@ -0,0 +1,12 @@
1
+ import { DimensionKey, MetricKey } from "./contract.js";
2
+
3
+ //#region src/core/capabilities.d.ts
4
+ interface CapabilityRequirement {
5
+ metrics?: MetricKey[];
6
+ dimensions?: DimensionKey[];
7
+ realtime?: boolean;
8
+ perPageQuery?: boolean;
9
+ }
10
+ //#endregion
11
+ export { CapabilityRequirement };
12
+ //# sourceMappingURL=capabilities.d.ts.map
@@ -0,0 +1,12 @@
1
+ //#region src/core/capabilities.ts
2
+ function satisfiesCapabilities(caps, req) {
3
+ if (req.realtime && !caps.realtime) return false;
4
+ if (req.perPageQuery && !caps.perPageQuery) return false;
5
+ if (req.metrics?.some((m) => !caps.metrics.has(m))) return false;
6
+ if (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false;
7
+ return true;
8
+ }
9
+ //#endregion
10
+ export { satisfiesCapabilities };
11
+
12
+ //# sourceMappingURL=capabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type { AnalyticsCapabilities, DimensionKey, MetricKey } from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\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\treturn true\n}\n"],"mappings":";AASA,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,OAAO;AACR"}
@@ -1,7 +1,12 @@
1
- import { Config } from "payload";
1
+ import { Config, PayloadRequest } from "payload";
2
2
 
3
3
  //#region src/core/contract.d.ts
4
- type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'entries' | 'exits' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
4
+ /**
5
+ * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every
6
+ * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
7
+ */
8
+ declare const PLATFORM_SCOPE = "*";
9
+ type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
5
10
  type DimensionKey = 'page' | 'referrer' | 'source' | 'medium' | 'campaign' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmContent' | 'utmTerm' | 'device' | 'browser' | 'os' | 'country' | 'region' | 'city' | 'language' | 'event';
6
11
  type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
7
12
  interface DateRange {
@@ -26,6 +31,19 @@ interface AnalyticsQuery {
26
31
  metric: MetricKey;
27
32
  direction: 'asc' | 'desc';
28
33
  };
34
+ /**
35
+ * Analytics boundary this read belongs to (tenant id, site key). Undefined means
36
+ * install-wide (the default). Adapters that can filter by scope apply it; others
37
+ * ignore it. Always part of the surfacing cache key, so per-scope adapter
38
+ * instances sharing an id never share cached results.
39
+ */
40
+ scope?: string;
41
+ /**
42
+ * IANA reporting timezone the read's day boundaries are aligned to. Undefined
43
+ * means UTC. Adapters that can bucket in a timezone apply it (PostHog, Umami);
44
+ * others report in their own account timezone. Part of the cache key when set.
45
+ */
46
+ timezone?: string;
29
47
  }
30
48
  interface AnalyticsRow {
31
49
  dimensions?: Partial<Record<DimensionKey, string>>;
@@ -64,10 +82,29 @@ interface AnalyticsCapabilities {
64
82
  realtime: number;
65
83
  aggregate: number;
66
84
  };
85
+ /**
86
+ * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native
87
+ * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through
88
+ * a shared platform adapter would expose cross-scope data, so such reads are
89
+ * gated by `access.platformRead`.
90
+ */
91
+ scopedQueries?: boolean;
67
92
  }
68
93
  interface AdapterContext {
69
94
  signal?: AbortSignal;
70
95
  }
96
+ /** Extra context the plugin hands adapters when they register config surface. */
97
+ interface AdapterRegisterContext {
98
+ /** True when the plugin has a scopeResolver configured. */
99
+ scoped: boolean;
100
+ /** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */
101
+ resolveScope: (req: PayloadRequest) => Promise<string | null>;
102
+ /**
103
+ * The plugin's reportingTimezone bound for adapter use (e.g. bucketing native
104
+ * rollups at ingest). Resolves to `'UTC'` when no reportingTimezone is set.
105
+ */
106
+ resolveTimezone: (req: PayloadRequest, scope?: string | null) => Promise<string>;
107
+ }
71
108
  interface AnalyticsAdapter {
72
109
  readonly id: string;
73
110
  readonly label: string;
@@ -75,9 +112,9 @@ interface AnalyticsAdapter {
75
112
  isConfigured(): boolean;
76
113
  query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
77
114
  realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
78
- register?(config: Config): void;
115
+ register?(config: Config, context?: AdapterRegisterContext): void;
79
116
  }
80
117
  type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
81
118
  //#endregion
82
- export { AnalyticsFilter as a, AnalyticsRow as c, Granularity as d, MetricKey as f, AnalyticsCapabilities as i, DateRange as l, AnalyticsAdapter as n, AnalyticsQuery as o, RateLimitDescriptor as p, AnalyticsAdapterFactory as r, AnalyticsResult as s, AdapterContext as t, DimensionKey as u };
83
- //# sourceMappingURL=contract-CWZPKWuR.d.ts.map
119
+ export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
120
+ //# sourceMappingURL=contract.d.ts.map
@@ -0,0 +1,10 @@
1
+ //#region src/core/contract.ts
2
+ /**
3
+ * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every
4
+ * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
5
+ */
6
+ const PLATFORM_SCOPE = "*";
7
+ //#endregion
8
+ export { PLATFORM_SCOPE };
9
+
10
+ //# sourceMappingURL=contract.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\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\nexport type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month'\n\nexport interface DateRange {\n\tstart: Date\n\tend: Date\n}\n\nexport interface AnalyticsFilter {\n\tdimension: DimensionKey\n\toperator: 'eq' | 'contains' | 'matches'\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: { provider: string; sampled?: boolean; clamped?: boolean; fetchedAt: string }\n}\n\nexport interface RateLimitDescriptor {\n\trequestsPerMinute?: number\n\trequestsPerHour?: number\n\tmaxConcurrent?: number\n\tquotaModel?: 'requests' | 'tokens'\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\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}\n\nexport interface AnalyticsAdapter {\n\treadonly id: string\n\treadonly label: string\n\treadonly capabilities: AnalyticsCapabilities\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":";;;;;AAMA,MAAa,iBAAiB"}
@@ -0,0 +1,17 @@
1
+ //#region src/core/granularity.ts
2
+ const GRANULARITY_ORDER = [
3
+ "minute",
4
+ "hour",
5
+ "day",
6
+ "week",
7
+ "month"
8
+ ];
9
+ /**
10
+ * Whether an adapter can bucket at granularity `g`. `minGranularity` is the finest
11
+ * bucket a provider supports, so it also supports every coarser one.
12
+ */
13
+ const supportsGranularity = (caps, g) => GRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity);
14
+ //#endregion
15
+ export { supportsGranularity };
16
+
17
+ //# sourceMappingURL=granularity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"granularity.js","names":[],"sources":["../../src/core/granularity.ts"],"sourcesContent":["import type { AnalyticsCapabilities, Granularity } from './contract'\n\nexport const GRANULARITY_ORDER: Granularity[] = ['minute', 'hour', 'day', 'week', 'month']\n\n/**\n * Whether an adapter can bucket at granularity `g`. `minGranularity` is the finest\n * bucket a provider supports, so it also supports every coarser one.\n */\nexport const supportsGranularity = (caps: AnalyticsCapabilities, g: Granularity): boolean =>\n\tGRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity)\n"],"mappings":";AAEA,MAAa,oBAAmC;CAAC;CAAU;CAAQ;CAAO;CAAQ;AAAO;;;;;AAMzF,MAAa,uBAAuB,MAA6B,MAChE,kBAAkB,QAAQ,CAAC,KAAK,kBAAkB,QAAQ,KAAK,cAAc"}
@@ -0,0 +1,140 @@
1
+ import { AnalyticsAdapter } from "./contract.js";
2
+ import { TranslationsOption } from "../translations/index.js";
3
+ import { AnalyticsBinding } from "../binding/types.js";
4
+ import { CustomWidgetDef } from "../widgets/customWidget.js";
5
+ import { CollectionConfig, CollectionSlug, Payload, PayloadRequest } from "payload";
6
+
7
+ //#region src/core/options.d.ts
8
+ /**
9
+ * Maps a request to its analytics boundary (tenant id, site key). Null means the
10
+ * whole install, which is the default single-site behavior. With a multi-tenant
11
+ * plugin, return the request's tenant id here.
12
+ */
13
+ type ScopeResolver = (args: {
14
+ req: PayloadRequest;
15
+ }) => string | null | Promise<string | null>;
16
+ /**
17
+ * Resolves the IANA reporting timezone a read's (or ingest's) day boundaries align
18
+ * to. Receives the request and its already-resolved scope, so per-tenant, per-user
19
+ * (`req.user`), and selector (cookie/preference) strategies are all expressible.
20
+ * Return `null` to fall back to UTC.
21
+ */
22
+ type TimezoneResolver = (args: {
23
+ req: PayloadRequest;
24
+ scope: string | null;
25
+ }) => string | null | Promise<string | null>;
26
+ /**
27
+ * Escape hatch replacing the provider-collection lookup: return the runtime
28
+ * adapters for a scope yourself (any store, any shape). Results are layered onto
29
+ * the static config adapters exactly like collection-resolved ones, but are not
30
+ * cached; memoize inside the function if lookups are expensive.
31
+ */
32
+ type ProvidersResolve = (args: {
33
+ payload: Payload;
34
+ req?: PayloadRequest;
35
+ scope: string | null;
36
+ }) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>;
37
+ type ProvidersCollectionOptions = {
38
+ slug?: string;
39
+ /**
40
+ * Field matched against the resolved scope when looking up a scope's providers.
41
+ * Point it at a tenant plugin's field (e.g. 'tenant') when that plugin manages
42
+ * scoping for the collection.
43
+ */
44
+ scopeField?: string;
45
+ overrides?: (collection: CollectionConfig) => CollectionConfig;
46
+ access?: Partial<CollectionConfig['access']>;
47
+ };
48
+ type ProvidersOptions = {
49
+ /** Opt-in admin collection storing runtime provider configurations. */collection?: boolean | ProvidersCollectionOptions;
50
+ resolve?: ProvidersResolve;
51
+ };
52
+ /** Access checker for cross-scope (platform) analytics reads. */
53
+ type PlatformReadAccess = (args: {
54
+ req: PayloadRequest;
55
+ }) => boolean | Promise<boolean>;
56
+ type AnalyticsAccessOptions = {
57
+ /**
58
+ * Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through
59
+ * a platform adapter that cannot filter by scope. Defaults to any authenticated
60
+ * admin-panel user.
61
+ */
62
+ platformRead?: PlatformReadAccess;
63
+ };
64
+ type AnalyticsPluginOptions = {
65
+ disabled?: boolean;
66
+ /**
67
+ * Per-locale overrides for this plugin's UI strings, keyed by the typed
68
+ * translation keys exported from `@10x-media/analytics/i18n`. Values win over
69
+ * the built-in locales key-by-key; locales the plugin does not ship are added
70
+ * whole. App-level `i18n.translations` still wins over both.
71
+ */
72
+ translations?: TranslationsOption;
73
+ adapters?: AnalyticsAdapter[];
74
+ defaultAdapter?: string;
75
+ scopeResolver?: ScopeResolver;
76
+ /**
77
+ * IANA reporting timezone that day boundaries (timeframe windows, series axes,
78
+ * native rollup buckets) align to. Defaults to UTC. A string forces one timezone
79
+ * (the single-tenant / no-multi-tenancy case); a resolver derives it per request
80
+ * from the scope, user, or a selector. Native rollups bucket at ingest in the
81
+ * resolved timezone, so changing it does not re-bucket existing history.
82
+ */
83
+ reportingTimezone?: string | TimezoneResolver;
84
+ providers?: ProvidersOptions;
85
+ /**
86
+ * Id of one config adapter shared by every scope (the platform's own analytics,
87
+ * e.g. a PostHog project capturing all tenants). Included in each scope's
88
+ * registry like any config adapter; reads through it are scope-filtered only
89
+ * when the adapter supports scoped queries, otherwise they are cross-scope and
90
+ * require `access.platformRead`.
91
+ */
92
+ platformAdapter?: string;
93
+ access?: AnalyticsAccessOptions;
94
+ /**
95
+ * Per-collection bindings, keyed by collection slug. With generated types
96
+ * augmented, each slug's resolvers receive that collection's typed document.
97
+ */
98
+ collections?: { [TSlug in CollectionSlug]?: AnalyticsBinding<TSlug> };
99
+ cache?: {
100
+ ttl?: {
101
+ aggregate?: number;
102
+ realtime?: number;
103
+ };
104
+ warm?: boolean | {
105
+ cron?: string;
106
+ };
107
+ };
108
+ widgets?: boolean | {
109
+ disabled?: string[];
110
+ register?: CustomWidgetDef[];
111
+ /**
112
+ * Marks the free-text widget config fields (each widget's Title) as
113
+ * `localized`. Off by default; takes effect only when the Payload config
114
+ * enables localization (Payload strips the flag otherwise).
115
+ */
116
+ localizeText?: boolean;
117
+ /**
118
+ * Period-over-period comparison on the metric and trend widgets. On by
119
+ * default for adapters that declare `capabilities.comparison`; set false
120
+ * to skip the second (previous-window) read entirely.
121
+ */
122
+ comparison?: boolean;
123
+ };
124
+ /**
125
+ * Opt-in sync tier: a cron job that persists each provider's daily metrics into a
126
+ * queryable collection. Reads go through the surfacing cache, so persisted rows reflect
127
+ * cached values up to `cache.ttl.aggregate` old; keep that TTL below the sync interval
128
+ * for the freshest data.
129
+ */
130
+ sync?: boolean | {
131
+ collectionSlug?: CollectionSlug;
132
+ cron?: string;
133
+ lookbackDays?: number;
134
+ adapters?: string[]; /** Surface the analytics-daily collection in the admin nav. Default false (hidden). */
135
+ hidden?: boolean;
136
+ };
137
+ };
138
+ //#endregion
139
+ export { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver, TimezoneResolver };
140
+ //# sourceMappingURL=options.d.ts.map