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

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 (262) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +37 -357
  3. package/dist/adapters/ga4/ga4.d.ts +20 -0
  4. package/dist/adapters/ga4/ga4.js +177 -0
  5. package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
  6. package/dist/adapters/http/fetchJson.js.map +1 -0
  7. package/dist/adapters/plausible/plausible.d.ts +15 -0
  8. package/dist/adapters/plausible/plausible.js +143 -0
  9. package/dist/adapters/posthog/posthog.d.ts +23 -0
  10. package/dist/adapters/posthog/posthog.js +121 -0
  11. package/dist/adapters/posthog/posthog.js.map +1 -0
  12. package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
  13. package/dist/adapters/series.js.map +1 -0
  14. package/dist/adapters/umami/umami.d.ts +18 -0
  15. package/dist/adapters/umami/umami.js +139 -0
  16. package/dist/binding/resolvePath.js +61 -0
  17. package/dist/binding/resolvePath.js.map +1 -0
  18. package/dist/binding/types.d.ts +53 -0
  19. package/dist/charts/BarList.d.ts +20 -0
  20. package/dist/charts/BarList.js +73 -0
  21. package/dist/charts/BarList.js.map +1 -0
  22. package/dist/charts/TrendChart.d.ts +25 -0
  23. package/dist/charts/TrendChart.js +186 -0
  24. package/dist/charts/TrendChart.js.map +1 -0
  25. package/dist/charts/bars.d.ts +9 -0
  26. package/dist/charts/bars.js +19 -0
  27. package/dist/charts/bars.js.map +1 -0
  28. package/dist/charts/bucket.js +79 -0
  29. package/dist/charts/bucket.js.map +1 -0
  30. package/dist/charts/spline.js +84 -0
  31. package/dist/charts/spline.js.map +1 -0
  32. package/dist/charts/styles.js +42 -0
  33. package/dist/charts/styles.js.map +1 -0
  34. package/dist/core/cacheKey.js +31 -0
  35. package/dist/core/cacheKey.js.map +1 -0
  36. package/dist/core/capabilities.d.ts +12 -0
  37. package/dist/core/capabilities.js +12 -0
  38. package/dist/core/capabilities.js.map +1 -0
  39. package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +30 -4
  40. package/dist/core/contract.js +10 -0
  41. package/dist/core/contract.js.map +1 -0
  42. package/dist/core/granularity.js +17 -0
  43. package/dist/core/granularity.js.map +1 -0
  44. package/dist/core/options.d.ts +115 -0
  45. package/dist/core/options.js +107 -0
  46. package/dist/core/options.js.map +1 -0
  47. package/dist/core/registry.js +24 -0
  48. package/dist/core/registry.js.map +1 -0
  49. package/dist/core/scopedRead.js +57 -0
  50. package/dist/core/scopedRead.js.map +1 -0
  51. package/dist/exports/adapters/ga4.d.ts +2 -20
  52. package/dist/exports/adapters/ga4.js +1 -176
  53. package/dist/exports/adapters/native.d.ts +2 -22
  54. package/dist/exports/adapters/native.js +1 -848
  55. package/dist/exports/adapters/plausible.d.ts +2 -15
  56. package/dist/exports/adapters/plausible.js +1 -142
  57. package/dist/exports/adapters/posthog.d.ts +2 -17
  58. package/dist/exports/adapters/posthog.js +1 -118
  59. package/dist/exports/adapters/umami.d.ts +2 -18
  60. package/dist/exports/adapters/umami.js +1 -138
  61. package/dist/exports/client.d.ts +5 -77
  62. package/dist/exports/client.js +4 -386
  63. package/dist/exports/geo.d.ts +4 -19
  64. package/dist/exports/geo.js +3 -1
  65. package/dist/exports/i18n.d.ts +3 -63
  66. package/dist/exports/i18n.js +2 -2
  67. package/dist/exports/next.d.ts +2 -0
  68. package/dist/exports/next.js +2 -0
  69. package/dist/exports/rsc.d.ts +13 -120
  70. package/dist/exports/rsc.js +10 -597
  71. package/dist/exports/types.d.ts +6 -4
  72. package/dist/exports/types.js +2 -1
  73. package/dist/fields/AnalyticsStatField.d.ts +31 -0
  74. package/dist/fields/AnalyticsStatField.js +93 -0
  75. package/dist/fields/AnalyticsStatField.js.map +1 -0
  76. package/dist/fields/dateRange/field.js +55 -0
  77. package/dist/fields/dateRange/field.js.map +1 -0
  78. package/dist/fields/dateRange/styles.js +23 -0
  79. package/dist/fields/dateRange/styles.js.map +1 -0
  80. package/dist/fields/dateRange/types.d.ts +11 -0
  81. package/dist/fields/dateRange/ui.d.ts +9 -0
  82. package/dist/fields/dateRange/ui.js +373 -0
  83. package/dist/fields/dateRange/ui.js.map +1 -0
  84. package/dist/fields/factories.d.ts +52 -0
  85. package/dist/fields/factories.js +65 -0
  86. package/dist/fields/factories.js.map +1 -0
  87. package/dist/fields/format.d.ts +7 -0
  88. package/dist/fields/format.js +22 -0
  89. package/dist/fields/format.js.map +1 -0
  90. package/dist/fields/readForDocument.js +107 -0
  91. package/dist/fields/readForDocument.js.map +1 -0
  92. package/dist/index.d.ts +18 -3
  93. package/dist/index.js +55 -1025
  94. package/dist/index.js.map +1 -1
  95. package/dist/native/collections/events.js +101 -0
  96. package/dist/native/collections/events.js.map +1 -0
  97. package/dist/native/collections/rollups.js +115 -0
  98. package/dist/native/collections/rollups.js.map +1 -0
  99. package/dist/native/collections/seen.js +47 -0
  100. package/dist/native/collections/seen.js.map +1 -0
  101. package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
  102. package/dist/native/geo/composeGeoResolvers.js +14 -0
  103. package/dist/native/geo/composeGeoResolvers.js.map +1 -0
  104. package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
  105. package/dist/native/geo/geoResolver.js +11 -0
  106. package/dist/native/geo/geoResolver.js.map +1 -0
  107. package/dist/native/geo/maxmindResolver.d.ts +16 -0
  108. package/dist/native/geo/maxmindResolver.js +55 -0
  109. package/dist/native/geo/maxmindResolver.js.map +1 -0
  110. package/dist/native/ingest/device.js +15 -0
  111. package/dist/native/ingest/device.js.map +1 -0
  112. package/dist/native/ingest/endpoint.js +27 -0
  113. package/dist/native/ingest/endpoint.js.map +1 -0
  114. package/dist/native/ingest/flushBatch.js +69 -0
  115. package/dist/native/ingest/flushBatch.js.map +1 -0
  116. package/dist/native/ingest/normalizeEvent.js +38 -0
  117. package/dist/native/ingest/normalizeEvent.js.map +1 -0
  118. package/dist/native/ingest/salt.js +14 -0
  119. package/dist/native/ingest/salt.js.map +1 -0
  120. package/dist/native/ingest/source.js +22 -0
  121. package/dist/native/ingest/source.js.map +1 -0
  122. package/dist/native/ingest/visitorHash.js +12 -0
  123. package/dist/native/ingest/visitorHash.js.map +1 -0
  124. package/dist/native/ingest/writeBuffer.js +55 -0
  125. package/dist/native/ingest/writeBuffer.js.map +1 -0
  126. package/dist/native/ingest/writeEvent.js +13 -0
  127. package/dist/native/ingest/writeEvent.js.map +1 -0
  128. package/dist/native/nativeAdapter.d.ts +22 -0
  129. package/dist/native/nativeAdapter.js +213 -0
  130. package/dist/native/nativeAdapter.js.map +1 -0
  131. package/dist/native/realtime/buildRealtime.js +53 -0
  132. package/dist/native/realtime/buildRealtime.js.map +1 -0
  133. package/dist/native/retention/pruneTask.js +29 -0
  134. package/dist/native/retention/pruneTask.js.map +1 -0
  135. package/dist/native/rollupAcc.js +50 -0
  136. package/dist/native/rollupAcc.js.map +1 -0
  137. package/dist/native/rollups/applyDistinctDeltas.js +9 -0
  138. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
  139. package/dist/native/rollups/bumpRollup.js +52 -0
  140. package/dist/native/rollups/bumpRollup.js.map +1 -0
  141. package/dist/native/rollups/deltas.js +31 -0
  142. package/dist/native/rollups/deltas.js.map +1 -0
  143. package/dist/native/rollups/insertIfNew.js +19 -0
  144. package/dist/native/rollups/insertIfNew.js.map +1 -0
  145. package/dist/next/posthogProxyRewrites.d.ts +36 -0
  146. package/dist/next/posthogProxyRewrites.js +50 -0
  147. package/dist/next/posthogProxyRewrites.js.map +1 -0
  148. package/dist/plugin/realtimeEndpoint.js +36 -0
  149. package/dist/plugin/realtimeEndpoint.js.map +1 -0
  150. package/dist/plugin/registerTranslations.js +19 -0
  151. package/dist/plugin/registerTranslations.js.map +1 -0
  152. package/dist/plugin/runtime.js +20 -0
  153. package/dist/plugin/runtime.js.map +1 -0
  154. package/dist/plugin/warmTask.js +165 -0
  155. package/dist/plugin/warmTask.js.map +1 -0
  156. package/dist/providers/collection.js +159 -0
  157. package/dist/providers/collection.js.map +1 -0
  158. package/dist/providers/factory.js +62 -0
  159. package/dist/providers/factory.js.map +1 -0
  160. package/dist/providers/resolver.js +67 -0
  161. package/dist/providers/resolver.js.map +1 -0
  162. package/dist/providers/secrets.js +27 -0
  163. package/dist/providers/secrets.js.map +1 -0
  164. package/dist/surfacing/cacheStore.js +26 -0
  165. package/dist/surfacing/cacheStore.js.map +1 -0
  166. package/dist/surfacing/coalesce.js +15 -0
  167. package/dist/surfacing/coalesce.js.map +1 -0
  168. package/dist/surfacing/engine.js +63 -0
  169. package/dist/surfacing/engine.js.map +1 -0
  170. package/dist/surfacing/queue.js +44 -0
  171. package/dist/surfacing/queue.js.map +1 -0
  172. package/dist/sync/collection.js +65 -0
  173. package/dist/sync/collection.js.map +1 -0
  174. package/dist/sync/syncTask.js +123 -0
  175. package/dist/sync/syncTask.js.map +1 -0
  176. package/dist/testing/memoryAdapter.d.ts +1 -1
  177. package/dist/timeframe/presets.d.ts +6 -0
  178. package/dist/timeframe/presets.js +63 -0
  179. package/dist/timeframe/presets.js.map +1 -0
  180. package/dist/{translations-keiKtSjF.js → translations/en.js} +25 -23
  181. package/dist/translations/en.js.map +1 -0
  182. package/dist/translations/index.d.ts +14 -0
  183. package/dist/translations/index.js +26 -0
  184. package/dist/translations/index.js.map +1 -0
  185. package/dist/translations/keys.d.ts +78 -0
  186. package/dist/{keys-DEqL4LOT.js → translations/keys.js} +24 -3
  187. package/dist/translations/keys.js.map +1 -0
  188. package/dist/translations/metricKeys.js +30 -0
  189. package/dist/translations/metricKeys.js.map +1 -0
  190. package/dist/translations/server.js +13 -0
  191. package/dist/translations/server.js.map +1 -0
  192. package/dist/translations/useTranslation.js +12 -0
  193. package/dist/translations/useTranslation.js.map +1 -0
  194. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
  195. package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
  196. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
  197. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
  198. package/dist/widgets/AnalyticsMetricWidget.js +81 -0
  199. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
  200. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
  201. package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
  202. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
  203. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
  204. package/dist/widgets/AnalyticsTrendWidget.js +91 -0
  205. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
  206. package/dist/widgets/RealtimeCounter.d.ts +19 -0
  207. package/dist/widgets/RealtimeCounter.js +76 -0
  208. package/dist/widgets/RealtimeCounter.js.map +1 -0
  209. package/dist/widgets/breakdownTypes.js +29 -0
  210. package/dist/widgets/breakdownTypes.js.map +1 -0
  211. package/dist/widgets/cardChrome.js +22 -0
  212. package/dist/widgets/cardChrome.js.map +1 -0
  213. package/dist/widgets/customWidget.d.ts +20 -0
  214. package/dist/widgets/customWidget.js +30 -0
  215. package/dist/widgets/customWidget.js.map +1 -0
  216. package/dist/widgets/defaults.d.ts +12 -0
  217. package/dist/widgets/defaults.js +72 -0
  218. package/dist/widgets/defaults.js.map +1 -0
  219. package/dist/widgets/range.js +28 -0
  220. package/dist/widgets/range.js.map +1 -0
  221. package/dist/widgets/readForWidget.d.ts +27 -0
  222. package/dist/widgets/readForWidget.js +57 -0
  223. package/dist/widgets/readForWidget.js.map +1 -0
  224. package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
  225. package/dist/widgets/readForWidgetBreakdown.js +75 -0
  226. package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
  227. package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
  228. package/dist/widgets/readForWidgetRealtime.js +63 -0
  229. package/dist/widgets/readForWidgetRealtime.js.map +1 -0
  230. package/dist/widgets/readForWidgetSeries.d.ts +38 -0
  231. package/dist/widgets/readForWidgetSeries.js +97 -0
  232. package/dist/widgets/readForWidgetSeries.js.map +1 -0
  233. package/dist/widgets/realtimePoll.js +26 -0
  234. package/dist/widgets/realtimePoll.js.map +1 -0
  235. package/dist/widgets/registerWidgets.js +249 -0
  236. package/dist/widgets/registerWidgets.js.map +1 -0
  237. package/dist/widgets/types.js +13 -0
  238. package/dist/widgets/types.js.map +1 -0
  239. package/package.json +16 -2
  240. package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
  241. package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
  242. package/dist/dist-B6HruP5v.js +0 -4731
  243. package/dist/dist-B6HruP5v.js.map +0 -1
  244. package/dist/exports/adapters/native.js.map +0 -1
  245. package/dist/exports/adapters/posthog.js.map +0 -1
  246. package/dist/exports/client.js.map +0 -1
  247. package/dist/exports/rsc.js.map +0 -1
  248. package/dist/fetchJson-DZb2_Puj.js.map +0 -1
  249. package/dist/index-CZdCT0WJ.d.ts +0 -98
  250. package/dist/keys-DEqL4LOT.js.map +0 -1
  251. package/dist/lib-CE5x1zLQ.js +0 -1058
  252. package/dist/lib-CE5x1zLQ.js.map +0 -1
  253. package/dist/maxmindResolver-CXYXXdul.js +0 -99
  254. package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
  255. package/dist/presets-CBfq_uJX.d.ts +0 -38
  256. package/dist/series-zytbzPoc.js.map +0 -1
  257. package/dist/server-Cuvhgz-S.js +0 -492
  258. package/dist/server-Cuvhgz-S.js.map +0 -1
  259. package/dist/translations-keiKtSjF.js.map +0 -1
  260. /package/dist/{exports/adapters → adapters/ga4}/ga4.js.map +0 -0
  261. /package/dist/{exports/adapters → adapters/plausible}/plausible.js.map +0 -0
  262. /package/dist/{exports/adapters → adapters/umami}/umami.js.map +0 -0
@@ -0,0 +1,79 @@
1
+ //#region src/charts/bucket.ts
2
+ const UNIT_BY_TIMEFRAME = {
3
+ today: "day",
4
+ last7days: "day",
5
+ last30days: "day",
6
+ thisMonth: "day",
7
+ last90days: "week",
8
+ thisYear: "month",
9
+ lastYear: "month",
10
+ allTime: "month"
11
+ };
12
+ const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
13
+ const bucketStart = (d, unit) => {
14
+ if (unit === "month") return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
15
+ if (unit === "week") {
16
+ const day = startOfUtcDay(d);
17
+ const dow = (day.getUTCDay() + 6) % 7;
18
+ day.setUTCDate(day.getUTCDate() - dow);
19
+ return day;
20
+ }
21
+ return startOfUtcDay(d);
22
+ };
23
+ const bucketByUnit = (points, unit, weekday) => {
24
+ const groups = /* @__PURE__ */ new Map();
25
+ for (const p of points) {
26
+ const d = bucketStart(new Date(p.date), unit);
27
+ const key = d.toISOString();
28
+ const g = groups.get(key);
29
+ if (g) g.value += p.value;
30
+ else groups.set(key, {
31
+ date: d,
32
+ value: p.value
33
+ });
34
+ }
35
+ const sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
36
+ const first = sorted[0];
37
+ const last = sorted.at(-1);
38
+ const multiYear = first !== void 0 && last !== void 0 && first.date.getUTCFullYear() !== last.date.getUTCFullYear();
39
+ const format = (d) => {
40
+ if (weekday) return new Intl.DateTimeFormat("en-US", {
41
+ weekday: "short",
42
+ timeZone: "UTC"
43
+ }).format(d);
44
+ if (unit === "month") return new Intl.DateTimeFormat("en-US", {
45
+ month: "short",
46
+ year: multiYear ? "numeric" : void 0,
47
+ timeZone: "UTC"
48
+ }).format(d);
49
+ return new Intl.DateTimeFormat("en-US", {
50
+ month: "short",
51
+ day: "numeric",
52
+ timeZone: "UTC"
53
+ }).format(d);
54
+ };
55
+ return sorted.map((g) => ({
56
+ label: format(g.date),
57
+ value: g.value
58
+ }));
59
+ };
60
+ /**
61
+ * Aggregate a daily series into display buckets sized to the timeframe (day for short
62
+ * ranges, week for ~quarter, month for year+), each with a formatted label. Distinct
63
+ * metrics are summed per bucket (a documented daily-uniques approximation).
64
+ */
65
+ const bucketSeries = (points, timeframe, _now) => bucketByUnit(points, UNIT_BY_TIMEFRAME[timeframe], timeframe === "last7days" || timeframe === "today");
66
+ const DAY = 864e5;
67
+ const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
68
+ /**
69
+ * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from
70
+ * the span the way the presets do: short ranges by day, a quarter by week, longer by
71
+ * month. Weekday labels are only used for the fixed 7-day preset, never here.
72
+ */
73
+ const bucketByRange = (points, range) => {
74
+ return bucketByUnit(points, unitForSpan(Math.round((range.end.getTime() - range.start.getTime()) / DAY)), false);
75
+ };
76
+ //#endregion
77
+ export { bucketByRange, bucketSeries };
78
+
79
+ //# 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 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 startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst bucketStart = (d: Date, unit: Unit): Date => {\n\tif (unit === 'month') return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1))\n\tif (unit === 'week') {\n\t\tconst day = startOfUtcDay(d)\n\t\tconst dow = (day.getUTCDay() + 6) % 7\n\t\tday.setUTCDate(day.getUTCDate() - dow)\n\t\treturn day\n\t}\n\treturn startOfUtcDay(d)\n}\n\nconst bucketByUnit = (points: SeriesPoint[], unit: Unit, weekday: boolean): 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)\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\tconst first = sorted[0]\n\tconst last = sorted.at(-1)\n\tconst multiYear =\n\t\tfirst !== undefined &&\n\t\tlast !== undefined &&\n\t\tfirst.date.getUTCFullYear() !== last.date.getUTCFullYear()\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: 'UTC' }).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: 'UTC',\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: 'UTC',\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. Distinct\n * metrics are summed per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\t_now: Date\n): ChartBucket[] =>\n\tbucketByUnit(\n\t\tpoints,\n\t\tUNIT_BY_TIMEFRAME[timeframe],\n\t\ttimeframe === 'last7days' || timeframe === 'today'\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. Weekday labels are only used for the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (points: SeriesPoint[], range: DateRange): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, unitForSpan(spanDays), false)\n}\n"],"mappings":";AAWA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,iBAAiB,MACtB,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,CAAC,CAAC;AAEvE,MAAM,eAAe,GAAS,SAAqB;CAClD,IAAI,SAAS,SAAS,OAAO,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC;CACtF,IAAI,SAAS,QAAQ;EACpB,MAAM,MAAM,cAAc,CAAC;EAC3B,MAAM,OAAO,IAAI,UAAU,IAAI,KAAK;EACpC,IAAI,WAAW,IAAI,WAAW,IAAI,GAAG;EACrC,OAAO;CACR;CACA,OAAO,cAAc,CAAC;AACvB;AAEA,MAAM,gBAAgB,QAAuB,MAAY,YAAoC;CAC5F,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,IAAI;EAC5C,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;CACtF,MAAM,QAAQ,OAAO;CACrB,MAAM,OAAO,OAAO,GAAG,EAAE;CACzB,MAAM,YACL,UAAU,KAAA,KACV,SAAS,KAAA,KACT,MAAM,KAAK,eAAe,MAAM,KAAK,KAAK,eAAe;CAC1D,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAM,CAAC,EAAE,OAAO,CAAC;EAExF,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;;;;;;AAOA,MAAa,gBACZ,QACA,WACA,SAEA,aACC,QACA,kBAAkB,YAClB,cAAc,eAAe,cAAc,OAC5C;AAED,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;AAOrD,MAAa,iBAAiB,QAAuB,UAAoC;CAExF,OAAO,aAAa,QAAQ,YADX,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GAC7B,CAAC,GAAG,KAAK;AACzD"}
@@ -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,31 @@
1
+ //#region src/core/cacheKey.ts
2
+ const stable = (xs) => xs ? [...xs].sort().join(",") : "";
3
+ const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
4
+ const startOfNextUtcDay = (d) => {
5
+ const day = startOfUtcDay(d);
6
+ day.setUTCDate(day.getUTCDate() + 1);
7
+ return day;
8
+ };
9
+ function buildCacheKey(provider, q) {
10
+ const pathKey = q.path ?? "site";
11
+ const range = `${startOfUtcDay(q.dateRange.start).toISOString()}_${startOfNextUtcDay(q.dateRange.end).toISOString()}`;
12
+ const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
13
+ return [
14
+ "analytics",
15
+ provider,
16
+ q.hostname ?? "_",
17
+ pathKey,
18
+ stable(q.metrics),
19
+ stable(q.dimensions),
20
+ range,
21
+ q.granularity ?? "_",
22
+ filters,
23
+ String(q.limit ?? "_"),
24
+ q.order ? `${q.order.metric}:${q.order.direction}` : "_",
25
+ ...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
26
+ ].join("|");
27
+ }
28
+ //#endregion
29
+ export { buildCacheKey };
30
+
31
+ //# sourceMappingURL=cacheKey.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst startOfNextUtcDay = (d: Date): Date => {\n\tconst day = startOfUtcDay(d)\n\tday.setUTCDate(day.getUTCDate() + 1)\n\treturn day\n}\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst range = `${startOfUtcDay(q.dateRange.start).toISOString()}_${startOfNextUtcDay(q.dateRange.end).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 scoped reads so unscoped keys keep their historical format.\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t].join('|')\n}\n"],"mappings":";AAEA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;AAE3E,MAAM,iBAAiB,MACtB,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,CAAC,CAAC;AAEvE,MAAM,qBAAqB,MAAkB;CAC5C,MAAM,MAAM,cAAc,CAAC;CAC3B,IAAI,WAAW,IAAI,WAAW,IAAI,CAAC;CACnC,OAAO;AACR;AAEA,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,QAAQ,GAAG,cAAc,EAAE,UAAU,KAAK,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,UAAU,GAAG,EAAE,YAAY;CAClH,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,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,6 +1,11 @@
1
- import { Config } from "payload";
1
+ import { Config, PayloadRequest } from "payload";
2
2
 
3
3
  //#region src/core/contract.d.ts
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 = "*";
4
9
  type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'entries' | 'exits' | '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';
@@ -26,6 +31,13 @@ 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;
29
41
  }
30
42
  interface AnalyticsRow {
31
43
  dimensions?: Partial<Record<DimensionKey, string>>;
@@ -64,10 +76,24 @@ interface AnalyticsCapabilities {
64
76
  realtime: number;
65
77
  aggregate: number;
66
78
  };
79
+ /**
80
+ * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native
81
+ * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through
82
+ * a shared platform adapter would expose cross-scope data, so such reads are
83
+ * gated by `access.platformRead`.
84
+ */
85
+ scopedQueries?: boolean;
67
86
  }
68
87
  interface AdapterContext {
69
88
  signal?: AbortSignal;
70
89
  }
90
+ /** Extra context the plugin hands adapters when they register config surface. */
91
+ interface AdapterRegisterContext {
92
+ /** True when the plugin has a scopeResolver configured. */
93
+ scoped: boolean;
94
+ /** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */
95
+ resolveScope: (req: PayloadRequest) => Promise<string | null>;
96
+ }
71
97
  interface AnalyticsAdapter {
72
98
  readonly id: string;
73
99
  readonly label: string;
@@ -75,9 +101,9 @@ interface AnalyticsAdapter {
75
101
  isConfigured(): boolean;
76
102
  query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
77
103
  realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
78
- register?(config: Config): void;
104
+ register?(config: Config, context?: AdapterRegisterContext): void;
79
105
  }
80
106
  type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
81
107
  //#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
108
+ export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
109
+ //# 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| 'entries'\n\t| 'exits'\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}\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}\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,115 @@
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
+ * Escape hatch replacing the provider-collection lookup: return the runtime
18
+ * adapters for a scope yourself (any store, any shape). Results are layered onto
19
+ * the static config adapters exactly like collection-resolved ones, but are not
20
+ * cached; memoize inside the function if lookups are expensive.
21
+ */
22
+ type ProvidersResolve = (args: {
23
+ payload: Payload;
24
+ req?: PayloadRequest;
25
+ scope: string | null;
26
+ }) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>;
27
+ type ProvidersCollectionOptions = {
28
+ slug?: string;
29
+ /**
30
+ * Field matched against the resolved scope when looking up a scope's providers.
31
+ * Point it at a tenant plugin's field (e.g. 'tenant') when that plugin manages
32
+ * scoping for the collection.
33
+ */
34
+ scopeField?: string;
35
+ overrides?: (collection: CollectionConfig) => CollectionConfig;
36
+ access?: Partial<CollectionConfig['access']>;
37
+ };
38
+ type ProvidersOptions = {
39
+ /** Opt-in admin collection storing runtime provider configurations. */collection?: boolean | ProvidersCollectionOptions;
40
+ resolve?: ProvidersResolve;
41
+ };
42
+ /** Access checker for cross-scope (platform) analytics reads. */
43
+ type PlatformReadAccess = (args: {
44
+ req: PayloadRequest;
45
+ }) => boolean | Promise<boolean>;
46
+ type AnalyticsAccessOptions = {
47
+ /**
48
+ * Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through
49
+ * a platform adapter that cannot filter by scope. Defaults to any authenticated
50
+ * admin-panel user.
51
+ */
52
+ platformRead?: PlatformReadAccess;
53
+ };
54
+ type AnalyticsPluginOptions = {
55
+ disabled?: boolean;
56
+ /**
57
+ * Per-locale overrides for this plugin's UI strings, keyed by the typed
58
+ * translation keys exported from `@10x-media/analytics/i18n`. Values win over
59
+ * the built-in locales key-by-key; locales the plugin does not ship are added
60
+ * whole. App-level `i18n.translations` still wins over both.
61
+ */
62
+ translations?: TranslationsOption;
63
+ adapters?: AnalyticsAdapter[];
64
+ defaultAdapter?: string;
65
+ scopeResolver?: ScopeResolver;
66
+ providers?: ProvidersOptions;
67
+ /**
68
+ * Id of one config adapter shared by every scope (the platform's own analytics,
69
+ * e.g. a PostHog project capturing all tenants). Included in each scope's
70
+ * registry like any config adapter; reads through it are scope-filtered only
71
+ * when the adapter supports scoped queries, otherwise they are cross-scope and
72
+ * require `access.platformRead`.
73
+ */
74
+ platformAdapter?: string;
75
+ access?: AnalyticsAccessOptions;
76
+ /**
77
+ * Per-collection bindings, keyed by collection slug. With generated types
78
+ * augmented, each slug's resolvers receive that collection's typed document.
79
+ */
80
+ collections?: { [TSlug in CollectionSlug]?: AnalyticsBinding<TSlug> };
81
+ cache?: {
82
+ ttl?: {
83
+ aggregate?: number;
84
+ realtime?: number;
85
+ };
86
+ warm?: boolean | {
87
+ cron?: string;
88
+ };
89
+ };
90
+ widgets?: boolean | {
91
+ disabled?: string[];
92
+ register?: CustomWidgetDef[];
93
+ /**
94
+ * Marks the free-text widget config fields (each widget's Title) as
95
+ * `localized`. Off by default; takes effect only when the Payload config
96
+ * enables localization (Payload strips the flag otherwise).
97
+ */
98
+ localizeText?: boolean;
99
+ };
100
+ /**
101
+ * Opt-in sync tier: a cron job that persists each provider's daily metrics into a
102
+ * queryable collection. Reads go through the surfacing cache, so persisted rows reflect
103
+ * cached values up to `cache.ttl.aggregate` old; keep that TTL below the sync interval
104
+ * for the freshest data.
105
+ */
106
+ sync?: boolean | {
107
+ collectionSlug?: CollectionSlug;
108
+ cron?: string;
109
+ lookbackDays?: number;
110
+ adapters?: string[];
111
+ };
112
+ };
113
+ //#endregion
114
+ export { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver };
115
+ //# sourceMappingURL=options.d.ts.map
@@ -0,0 +1,107 @@
1
+ import { PROVIDERS_SLUG } from "../providers/collection.js";
2
+ //#region src/core/options.ts
3
+ const DEFAULT_WARM_CRON = "*/30 * * * *";
4
+ const DEFAULT_SYNC_CRON = "0 */6 * * *";
5
+ const DEFAULT_SYNC_COLLECTION = "analytics-daily";
6
+ const DEFAULT_SYNC_LOOKBACK = 3;
7
+ const DEFAULT_SCOPE_FIELD = "scope";
8
+ const resolveBindings = (collections) => {
9
+ const out = {};
10
+ for (const [slug, binding] of Object.entries(collections ?? {})) {
11
+ if (!binding) continue;
12
+ if (!binding.path && !binding.pathField) throw new Error(`analytics: binding for "${slug}" needs a path resolver or a pathField`);
13
+ out[slug] = binding;
14
+ }
15
+ return out;
16
+ };
17
+ function resolveOptions(options) {
18
+ if (!options.adapters || options.adapters.length === 0) throw new Error("analytics: at least one adapter is required");
19
+ if (options.platformAdapter !== void 0 && !options.adapters.some((a) => a.id === options.platformAdapter)) throw new Error(`analytics: unknown platform adapter "${options.platformAdapter}"`);
20
+ const widgets = options.widgets === false ? {
21
+ enabled: false,
22
+ disabled: [],
23
+ register: [],
24
+ localizeText: false
25
+ } : options.widgets === void 0 || options.widgets === true ? {
26
+ enabled: true,
27
+ disabled: [],
28
+ register: [],
29
+ localizeText: false
30
+ } : {
31
+ enabled: true,
32
+ disabled: options.widgets.disabled ?? [],
33
+ register: options.widgets.register ?? [],
34
+ localizeText: options.widgets.localizeText ?? false
35
+ };
36
+ const warmOpt = options.cache?.warm;
37
+ const warm = warmOpt === true ? {
38
+ enabled: true,
39
+ cron: DEFAULT_WARM_CRON
40
+ } : warmOpt && typeof warmOpt === "object" ? {
41
+ enabled: true,
42
+ cron: warmOpt.cron ?? DEFAULT_WARM_CRON
43
+ } : {
44
+ enabled: false,
45
+ cron: DEFAULT_WARM_CRON
46
+ };
47
+ const collectionOpt = options.providers?.collection;
48
+ const providers = {
49
+ collection: collectionOpt === true ? {
50
+ enabled: true,
51
+ slug: PROVIDERS_SLUG,
52
+ scopeField: DEFAULT_SCOPE_FIELD
53
+ } : collectionOpt && typeof collectionOpt === "object" ? {
54
+ enabled: true,
55
+ slug: collectionOpt.slug ?? "analytics-providers",
56
+ scopeField: collectionOpt.scopeField ?? DEFAULT_SCOPE_FIELD,
57
+ overrides: collectionOpt.overrides,
58
+ access: collectionOpt.access
59
+ } : {
60
+ enabled: false,
61
+ slug: PROVIDERS_SLUG,
62
+ scopeField: DEFAULT_SCOPE_FIELD
63
+ },
64
+ resolve: options.providers?.resolve
65
+ };
66
+ const syncOpt = options.sync;
67
+ const sync = syncOpt === true ? {
68
+ enabled: true,
69
+ collectionSlug: DEFAULT_SYNC_COLLECTION,
70
+ cron: DEFAULT_SYNC_CRON,
71
+ lookbackDays: DEFAULT_SYNC_LOOKBACK
72
+ } : syncOpt && typeof syncOpt === "object" ? {
73
+ enabled: true,
74
+ collectionSlug: syncOpt.collectionSlug ?? DEFAULT_SYNC_COLLECTION,
75
+ cron: syncOpt.cron ?? DEFAULT_SYNC_CRON,
76
+ lookbackDays: syncOpt.lookbackDays ?? DEFAULT_SYNC_LOOKBACK,
77
+ adapters: syncOpt.adapters
78
+ } : {
79
+ enabled: false,
80
+ collectionSlug: DEFAULT_SYNC_COLLECTION,
81
+ cron: DEFAULT_SYNC_CRON,
82
+ lookbackDays: DEFAULT_SYNC_LOOKBACK
83
+ };
84
+ return {
85
+ adapters: options.adapters,
86
+ defaultAdapter: options.defaultAdapter,
87
+ scopeResolver: options.scopeResolver ?? (() => null),
88
+ scoped: options.scopeResolver !== void 0,
89
+ platformAdapter: options.platformAdapter,
90
+ access: { platformRead: options.access?.platformRead ?? (({ req }) => Boolean(req.user)) },
91
+ providers,
92
+ bindings: resolveBindings(options.collections),
93
+ cache: {
94
+ ttl: {
95
+ aggregate: options.cache?.ttl?.aggregate ?? 3600,
96
+ realtime: options.cache?.ttl?.realtime ?? 300
97
+ },
98
+ warm
99
+ },
100
+ widgets,
101
+ sync
102
+ };
103
+ }
104
+ //#endregion
105
+ export { resolveOptions };
106
+
107
+ //# sourceMappingURL=options.js.map