@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
@@ -1,598 +1,14 @@
1
- import { _ as readForWidgetRealtime, a as readForWidgetSeries, c as readForWidget, f as breakdownSpecBySlug, h as REALTIME_PATH, i as TIMEFRAME_KEYS, l as formatRangeCaption, m as resolveTimeframe, r as METRIC_KEYS, s as readForWidgetBreakdown, t as asTranslate, u as resolveCustomRange, x as satisfiesCapabilities, y as getRuntime } from "../server-Cuvhgz-S.js";
2
- import { t as keys } from "../keys-DEqL4LOT.js";
3
- import { n as TrendChart, r as BarList, t as RealtimeCounter } from "../RealtimeCounter-BJrjMPSa.js";
4
- import { jsx, jsxs } from "react/jsx-runtime";
5
- //#region src/fields/format.ts
6
- const formatDuration = (ms) => {
7
- const totalSeconds = Math.round(ms / 1e3);
8
- if (totalSeconds < 60) return `${totalSeconds}s`;
9
- const minutes = Math.floor(totalSeconds / 60);
10
- const seconds = totalSeconds % 60;
11
- if (minutes < 60) return seconds === 0 ? `${minutes}m` : `${minutes}m ${seconds}s`;
12
- const hours = Math.floor(minutes / 60);
13
- const remMinutes = minutes % 60;
14
- return remMinutes === 0 ? `${hours}h` : `${hours}h ${remMinutes}m`;
15
- };
16
- const formatCount = (value, locale) => new Intl.NumberFormat(locale).format(value);
17
- const PERCENT_METRICS = new Set(["bounceRate", "scrollDepth"]);
18
- const formatMetricValue = (metric, value, locale) => {
19
- if (metric === "avgDuration") return formatDuration(value);
20
- if (PERCENT_METRICS.has(metric)) return `${Math.round(value)}%`;
21
- return formatCount(value, locale);
22
- };
23
- //#endregion
24
- //#region src/binding/resolvePath.ts
25
- const getByPath = (doc, dotPath) => dotPath.split(".").reduce((value, key) => {
26
- if (value && typeof value === "object") return value[key];
27
- }, doc);
28
- const nonEmptyString = (value) => typeof value === "string" && value.length > 0;
29
- /**
30
- * Resolve a document's analytics path. The `path` resolver wins; the `pathField`
31
- * value is the fallback. Returns null when neither yields a non-empty string (for
32
- * example an unsaved document with no slug yet).
33
- */
34
- const resolvePath = async (binding, doc, ctx) => {
35
- if (binding.path) {
36
- const resolved = await binding.path(doc, ctx);
37
- if (nonEmptyString(resolved)) return resolved;
38
- }
39
- if (binding.pathField) {
40
- const value = getByPath(doc, binding.pathField);
41
- if (nonEmptyString(value)) return value;
42
- }
43
- return null;
44
- };
45
- const CACHE_KEY = "__analyticsPathCache";
46
- /**
47
- * Resolve the path once per (doc, request): the same `doc` reference is handed to
48
- * every analytics field on a document, so caching the in-flight Promise on
49
- * `req.context` collapses an async (possibly ancestor-walking) resolver from once per
50
- * field to once per document, and shares it across concurrent field renders. When the
51
- * request carries no context bag (incomplete reqs in tests or unusual call sites), it
52
- * degrades to a direct, un-memoized resolve so the result stays correct.
53
- */
54
- const resolvePathCached = (binding, doc, ctx) => {
55
- const context = ctx.req.context;
56
- if (!context) return resolvePath(binding, doc, ctx);
57
- let cache = context[CACHE_KEY];
58
- if (!cache) {
59
- cache = /* @__PURE__ */ new WeakMap();
60
- context[CACHE_KEY] = cache;
61
- }
62
- let cached = cache.get(doc);
63
- if (!cached) {
64
- cached = resolvePath(binding, doc, ctx);
65
- cache.set(doc, cached);
66
- }
67
- return cached;
68
- };
69
- const resolveHostname = (binding, doc) => {
70
- if (typeof binding.hostname === "function") return binding.hostname(doc);
71
- return binding.hostname;
72
- };
73
- //#endregion
74
- //#region src/fields/readForDocument.ts
75
- /**
76
- * Resolve a document's analytics for one display field: look up the runtime, resolve
77
- * the bound path, capability-gate the requested metrics against the active adapter,
78
- * then read through the surfacing engine. Returns a discriminated status so the
79
- * rendering component can show the right empty state without throwing.
80
- */
81
- const readForField = async (args) => {
82
- const { req, collectionSlug, data, metrics, timeframe, adapterId, now } = args;
83
- const dateRange = resolveTimeframe(timeframe, now);
84
- const runtime = getRuntime(req.payload);
85
- if (!runtime) return {
86
- status: "not-bound",
87
- adapterId: adapterId ?? "",
88
- dateRange,
89
- metrics: {}
90
- };
91
- const binding = runtime.bindings[collectionSlug];
92
- if (!binding) return {
93
- status: "not-bound",
94
- adapterId: adapterId ?? "",
95
- dateRange,
96
- metrics: {}
97
- };
98
- let adapter;
99
- try {
100
- adapter = adapterId ? runtime.registry.get(adapterId) : runtime.registry.default();
101
- } catch {
102
- return {
103
- status: "unavailable",
104
- adapterId: adapterId ?? "",
105
- dateRange,
106
- metrics: {}
107
- };
108
- }
109
- let path;
110
- try {
111
- path = await resolvePathCached(binding, data, {
112
- req,
113
- locale: req.locale ?? void 0
114
- });
115
- } catch {
116
- path = null;
117
- }
118
- if (!path) return {
119
- status: "no-path",
120
- adapterId: adapter.id,
121
- dateRange,
122
- metrics: {}
123
- };
124
- if (!adapter.isConfigured()) return {
125
- status: "not-configured",
126
- adapterId: adapter.id,
127
- dateRange,
128
- metrics: {}
129
- };
130
- if (!satisfiesCapabilities(adapter.capabilities, {
131
- metrics,
132
- perPageQuery: true
133
- })) return {
134
- status: "unavailable",
135
- adapterId: adapter.id,
136
- dateRange,
137
- metrics: {}
138
- };
139
- const result = await runtime.engine.read(adapter, {
140
- path,
141
- hostname: resolveHostname(binding, data),
142
- metrics,
143
- dateRange
144
- });
145
- return {
146
- status: "ok",
147
- adapterId: adapter.id,
148
- dateRange,
149
- metrics: result.totals ?? {}
150
- };
151
- };
152
- //#endregion
153
- //#region src/fields/AnalyticsStatField.tsx
154
- const STATE_KEYS = {
155
- "no-path": keys.stateNoData,
156
- "not-bound": keys.stateNotBound,
157
- "not-configured": keys.stateNotConfigured,
158
- unavailable: keys.stateUnavailable
159
- };
160
- const wrapStyle = {
161
- display: "flex",
162
- flexWrap: "wrap",
163
- gap: "var(--base, 1rem)",
164
- alignItems: "flex-end"
165
- };
166
- const cardStyle$1 = {
167
- display: "flex",
168
- flexDirection: "column",
169
- gap: "0.25rem"
170
- };
171
- const labelStyle$1 = {
172
- fontSize: "0.75rem",
173
- opacity: .6,
174
- textTransform: "uppercase"
175
- };
176
- const valueStyle = {
177
- fontSize: "1.5rem",
178
- fontWeight: 600,
179
- lineHeight: 1.1
180
- };
181
- const captionStyle = {
182
- fontSize: "0.75rem",
183
- opacity: .5,
184
- width: "100%"
185
- };
186
- /**
187
- * Read-only server component for a per-document analytics stat (or row of stats).
188
- * Resolves the document's bound path, reads through the surfacing engine, and renders
189
- * static markup. Interactivity (timeframe picker, refresh) is intentionally deferred.
190
- */
191
- const AnalyticsStatField = async (props) => {
192
- const { req, data, collectionSlug, i18n, metrics, timeframe, adapterId } = props;
193
- const t = asTranslate(i18n.t);
194
- const locale = i18n.language ?? "en-US";
195
- const result = await readForField({
196
- req,
197
- collectionSlug,
198
- data,
199
- metrics,
200
- timeframe,
201
- adapterId,
202
- now: /* @__PURE__ */ new Date()
203
- });
204
- if (result.status !== "ok") return /* @__PURE__ */ jsx("div", {
205
- className: "field-type",
206
- style: { opacity: .6 },
207
- children: t(STATE_KEYS[result.status])
208
- });
209
- return /* @__PURE__ */ jsxs("div", {
210
- className: "field-type",
211
- style: wrapStyle,
212
- children: [metrics.map((metric) => /* @__PURE__ */ jsxs("div", {
213
- style: cardStyle$1,
214
- children: [/* @__PURE__ */ jsx("span", {
215
- style: labelStyle$1,
216
- children: t(METRIC_KEYS[metric])
217
- }), /* @__PURE__ */ jsx("span", {
218
- style: valueStyle,
219
- children: formatMetricValue(metric, result.metrics[metric] ?? 0, locale)
220
- })]
221
- }, metric)), /* @__PURE__ */ jsx("span", {
222
- style: captionStyle,
223
- children: t(TIMEFRAME_KEYS[timeframe])
224
- })]
225
- });
226
- };
227
- //#endregion
228
- //#region src/widgets/cardChrome.ts
229
- const cardStyle = {
230
- display: "flex",
231
- flexDirection: "column",
232
- gap: "0.375rem",
233
- padding: "var(--base, 1rem)",
234
- background: "var(--theme-elevation-50)",
235
- border: "1px solid var(--theme-elevation-150)",
236
- borderRadius: "var(--style-radius-m, 6px)",
237
- boxSizing: "border-box"
238
- };
239
- const labelStyle = {
240
- fontSize: "0.6875rem",
241
- fontWeight: 600,
242
- letterSpacing: "0.04em",
243
- textTransform: "uppercase",
244
- color: "var(--theme-elevation-500)"
245
- };
246
- //#endregion
247
- //#region src/widgets/AnalyticsBreakdownWidget.tsx
248
- const STATE_KEY$3 = {
249
- "not-configured": keys.stateNotConfigured,
250
- unavailable: keys.stateUnavailable
251
- };
252
- async function AnalyticsBreakdownWidget(props) {
253
- const spec = breakdownSpecBySlug(props.widgetSlug);
254
- const t = asTranslate(props.req.i18n.t);
255
- const data = props.widgetData ?? {};
256
- const metric = data.metric ?? "pageviews";
257
- const rawTimeframe = data.timeframe ?? "last30days";
258
- const customRange = resolveCustomRange(rawTimeframe, data.range);
259
- const timeframe = rawTimeframe === "custom" ? "last30days" : rawTimeframe;
260
- const limit = data.limit ?? 5;
261
- const title = data.title?.trim() || (spec ? t(spec.label) : "");
262
- if (!spec) return /* @__PURE__ */ jsx("div", {
263
- className: "analytics-breakdown-widget",
264
- style: cardStyle,
265
- children: /* @__PURE__ */ jsx("span", {
266
- style: { color: "var(--theme-elevation-400)" },
267
- children: t(keys.stateUnavailable)
268
- })
269
- });
270
- const result = await readForWidgetBreakdown({
271
- req: props.req,
272
- metric,
273
- dimension: spec.dimension,
274
- timeframe,
275
- limit,
276
- adapterId: data.dataSource,
277
- now: /* @__PURE__ */ new Date(),
278
- range: customRange
279
- });
280
- const locale = props.req.i18n.language ?? "en-US";
281
- const caption = customRange ? formatRangeCaption(customRange, locale) : t(TIMEFRAME_KEYS[timeframe]);
282
- return /* @__PURE__ */ jsxs("div", {
283
- className: "analytics-breakdown-widget",
284
- style: cardStyle,
285
- children: [
286
- /* @__PURE__ */ jsx("span", {
287
- style: labelStyle,
288
- children: title
289
- }),
290
- result.status !== "ok" ? /* @__PURE__ */ jsx("span", {
291
- style: { color: "var(--theme-elevation-400)" },
292
- children: t(STATE_KEY$3[result.status])
293
- }) : /* @__PURE__ */ jsx(BarList, {
294
- data: result.rows.map((row) => ({
295
- label: row.label,
296
- value: row.value,
297
- display: formatMetricValue(metric, row.value, locale)
298
- })),
299
- emptyLabel: t(keys.stateNoBreakdown)
300
- }),
301
- /* @__PURE__ */ jsx("span", {
302
- style: {
303
- fontSize: "0.75rem",
304
- color: "var(--theme-elevation-400)"
305
- },
306
- children: caption
307
- }),
308
- result.status === "ok" && result.clamped ? /* @__PURE__ */ jsx("span", {
309
- style: {
310
- fontSize: "0.6875rem",
311
- color: "var(--theme-elevation-400)"
312
- },
313
- children: t(keys.stateClamped)
314
- }) : null
315
- ]
316
- });
317
- }
318
- //#endregion
319
- //#region src/widgets/AnalyticsMetricWidget.tsx
320
- const STATE_KEY$2 = {
321
- "not-configured": keys.stateNotConfigured,
322
- unavailable: keys.stateUnavailable
323
- };
324
- async function AnalyticsMetricWidget(props) {
325
- const data = props.widgetData ?? {};
326
- const metric = data.metric ?? "pageviews";
327
- const rawTimeframe = data.timeframe ?? "last30days";
328
- const customRange = resolveCustomRange(rawTimeframe, data.range);
329
- const timeframe = rawTimeframe === "custom" ? "last30days" : rawTimeframe;
330
- const t = asTranslate(props.req.i18n.t);
331
- const locale = props.req.i18n.language ?? "en-US";
332
- const title = data.title?.trim() || t(METRIC_KEYS[metric]);
333
- const caption = customRange ? formatRangeCaption(customRange, locale) : t(TIMEFRAME_KEYS[timeframe]);
334
- const result = await readForWidget({
335
- req: props.req,
336
- metrics: [metric],
337
- timeframe,
338
- adapterId: data.dataSource,
339
- now: /* @__PURE__ */ new Date(),
340
- range: customRange
341
- });
342
- if (result.status !== "ok") return /* @__PURE__ */ jsxs("div", {
343
- className: "analytics-metric-widget",
344
- style: cardStyle,
345
- children: [/* @__PURE__ */ jsx("span", {
346
- style: labelStyle,
347
- children: title
348
- }), /* @__PURE__ */ jsx("span", {
349
- style: { color: "var(--theme-elevation-400)" },
350
- children: t(STATE_KEY$2[result.status])
351
- })]
352
- });
353
- const value = result.metrics[metric];
354
- return /* @__PURE__ */ jsxs("div", {
355
- className: "analytics-metric-widget",
356
- style: cardStyle,
357
- children: [
358
- /* @__PURE__ */ jsx("span", {
359
- style: labelStyle,
360
- children: title
361
- }),
362
- /* @__PURE__ */ jsx("span", {
363
- style: {
364
- fontSize: "2rem",
365
- fontWeight: 700,
366
- lineHeight: 1.1,
367
- color: "var(--theme-elevation-800)"
368
- },
369
- children: value === void 0 ? "–" : formatMetricValue(metric, value, locale)
370
- }),
371
- /* @__PURE__ */ jsx("span", {
372
- style: {
373
- fontSize: "0.75rem",
374
- color: "var(--theme-elevation-400)"
375
- },
376
- children: caption
377
- }),
378
- result.clamped ? /* @__PURE__ */ jsx("span", {
379
- style: {
380
- fontSize: "0.6875rem",
381
- color: "var(--theme-elevation-400)"
382
- },
383
- children: t(keys.stateClamped)
384
- }) : null
385
- ]
386
- });
387
- }
388
- //#endregion
389
- //#region src/widgets/AnalyticsRealtimeWidget.tsx
390
- const STATE_KEY$1 = {
391
- "not-configured": keys.stateNotConfigured,
392
- unavailable: keys.stateUnavailable
393
- };
394
- const POLL_INTERVAL_MS = 15e3;
395
- async function AnalyticsRealtimeWidget(props) {
396
- const data = props.widgetData ?? {};
397
- const metric = data.metric ?? "visitors";
398
- const windowMinutes = Number(data.windowMinutes) || 30;
399
- const t = asTranslate(props.req.i18n.t);
400
- const locale = props.req.i18n.language ?? "en-US";
401
- const title = data.title?.trim() || t(keys.widgetRealtimeLabel);
402
- const result = await readForWidgetRealtime({
403
- req: props.req,
404
- metric,
405
- windowMinutes,
406
- adapterId: data.dataSource,
407
- now: /* @__PURE__ */ new Date()
408
- });
409
- if (result.status !== "ok") return /* @__PURE__ */ jsxs("div", {
410
- className: "analytics-realtime-widget",
411
- style: cardStyle,
412
- children: [/* @__PURE__ */ jsx("span", {
413
- style: labelStyle,
414
- children: title
415
- }), /* @__PURE__ */ jsx("span", {
416
- style: { color: "var(--theme-elevation-400)" },
417
- children: t(STATE_KEY$1[result.status])
418
- })]
419
- });
420
- const caption = `${t(METRIC_KEYS[metric])} ${t(keys.widgetRealtimeCaption)}`;
421
- return /* @__PURE__ */ jsxs("div", {
422
- className: "analytics-realtime-widget",
423
- style: cardStyle,
424
- children: [/* @__PURE__ */ jsx("span", {
425
- style: labelStyle,
426
- children: title
427
- }), /* @__PURE__ */ jsx(RealtimeCounter, {
428
- endpoint: `/api${REALTIME_PATH}`,
429
- intervalMs: POLL_INTERVAL_MS,
430
- metric,
431
- windowMinutes,
432
- dataSource: data.dataSource,
433
- initialActiveNow: result.activeNow,
434
- initialSeries: result.series,
435
- locale,
436
- caption,
437
- pausedLabel: t(keys.widgetRealtimePaused)
438
- })]
439
- });
440
- }
441
- //#endregion
442
- //#region src/charts/bucket.ts
443
- const UNIT_BY_TIMEFRAME = {
444
- today: "day",
445
- last7days: "day",
446
- last30days: "day",
447
- thisMonth: "day",
448
- last90days: "week",
449
- thisYear: "month",
450
- lastYear: "month",
451
- allTime: "month"
452
- };
453
- const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
454
- const bucketStart = (d, unit) => {
455
- if (unit === "month") return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
456
- if (unit === "week") {
457
- const day = startOfUtcDay(d);
458
- const dow = (day.getUTCDay() + 6) % 7;
459
- day.setUTCDate(day.getUTCDate() - dow);
460
- return day;
461
- }
462
- return startOfUtcDay(d);
463
- };
464
- const bucketByUnit = (points, unit, weekday) => {
465
- const groups = /* @__PURE__ */ new Map();
466
- for (const p of points) {
467
- const d = bucketStart(new Date(p.date), unit);
468
- const key = d.toISOString();
469
- const g = groups.get(key);
470
- if (g) g.value += p.value;
471
- else groups.set(key, {
472
- date: d,
473
- value: p.value
474
- });
475
- }
476
- const sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
477
- const first = sorted[0];
478
- const last = sorted.at(-1);
479
- const multiYear = first !== void 0 && last !== void 0 && first.date.getUTCFullYear() !== last.date.getUTCFullYear();
480
- const format = (d) => {
481
- if (weekday) return new Intl.DateTimeFormat("en-US", {
482
- weekday: "short",
483
- timeZone: "UTC"
484
- }).format(d);
485
- if (unit === "month") return new Intl.DateTimeFormat("en-US", {
486
- month: "short",
487
- year: multiYear ? "numeric" : void 0,
488
- timeZone: "UTC"
489
- }).format(d);
490
- return new Intl.DateTimeFormat("en-US", {
491
- month: "short",
492
- day: "numeric",
493
- timeZone: "UTC"
494
- }).format(d);
495
- };
496
- return sorted.map((g) => ({
497
- label: format(g.date),
498
- value: g.value
499
- }));
500
- };
501
- /**
502
- * Aggregate a daily series into display buckets sized to the timeframe (day for short
503
- * ranges, week for ~quarter, month for year+), each with a formatted label. Distinct
504
- * metrics are summed per bucket (a documented daily-uniques approximation).
505
- */
506
- const bucketSeries = (points, timeframe, _now) => bucketByUnit(points, UNIT_BY_TIMEFRAME[timeframe], timeframe === "last7days" || timeframe === "today");
507
- const DAY = 864e5;
508
- const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
509
- /**
510
- * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from
511
- * the span the way the presets do: short ranges by day, a quarter by week, longer by
512
- * month. Weekday labels are only used for the fixed 7-day preset, never here.
513
- */
514
- const bucketByRange = (points, range) => {
515
- return bucketByUnit(points, unitForSpan(Math.round((range.end.getTime() - range.start.getTime()) / DAY)), false);
516
- };
517
- //#endregion
518
- //#region src/widgets/AnalyticsTrendWidget.tsx
519
- const STATE_KEY = {
520
- "not-configured": keys.stateNotConfigured,
521
- unavailable: keys.stateUnavailable
522
- };
523
- async function AnalyticsTrendWidget(props) {
524
- const data = props.widgetData ?? {};
525
- const metric = data.metric ?? "pageviews";
526
- const rawTimeframe = data.timeframe ?? "last30days";
527
- const customRange = resolveCustomRange(rawTimeframe, data.range);
528
- const timeframe = rawTimeframe === "custom" ? "last30days" : rawTimeframe;
529
- const t = asTranslate(props.req.i18n.t);
530
- const locale = props.req.i18n.language ?? "en-US";
531
- const title = data.title?.trim() || t(METRIC_KEYS[metric]);
532
- const result = await readForWidgetSeries({
533
- req: props.req,
534
- metric,
535
- timeframe,
536
- adapterId: data.dataSource,
537
- now: /* @__PURE__ */ new Date(),
538
- range: customRange
539
- });
540
- if (result.status !== "ok") return /* @__PURE__ */ jsxs("div", {
541
- className: "analytics-trend-widget",
542
- style: cardStyle,
543
- children: [/* @__PURE__ */ jsx("span", {
544
- style: labelStyle,
545
- children: title
546
- }), /* @__PURE__ */ jsx("span", {
547
- style: { color: "var(--theme-elevation-400)" },
548
- children: t(STATE_KEY[result.status])
549
- })]
550
- });
551
- const caption = customRange ? formatRangeCaption(customRange, locale) : t(TIMEFRAME_KEYS[timeframe]);
552
- const trendPoints = (customRange ? bucketByRange(result.points, customRange) : bucketSeries(result.points, timeframe, /* @__PURE__ */ new Date())).map((b) => ({
553
- ...b,
554
- display: formatMetricValue(metric, b.value, locale)
555
- }));
556
- return /* @__PURE__ */ jsxs("div", {
557
- className: "analytics-trend-widget",
558
- style: cardStyle,
559
- children: [
560
- /* @__PURE__ */ jsx("span", {
561
- style: labelStyle,
562
- children: title
563
- }),
564
- /* @__PURE__ */ jsx("span", {
565
- style: {
566
- fontSize: "1.75rem",
567
- fontWeight: 700,
568
- lineHeight: 1.1,
569
- color: "var(--theme-elevation-800)"
570
- },
571
- children: formatMetricValue(metric, result.total, locale)
572
- }),
573
- /* @__PURE__ */ jsx(TrendChart, {
574
- buckets: trendPoints,
575
- ariaLabel: `${title} ${caption}`,
576
- minHeight: 180
577
- }),
578
- /* @__PURE__ */ jsx("span", {
579
- style: {
580
- fontSize: "0.75rem",
581
- color: "var(--theme-elevation-400)"
582
- },
583
- children: caption
584
- }),
585
- result.clamped ? /* @__PURE__ */ jsx("span", {
586
- style: {
587
- fontSize: "0.6875rem",
588
- color: "var(--theme-elevation-400)"
589
- },
590
- children: t(keys.stateClamped)
591
- }) : null
592
- ]
593
- });
594
- }
595
- //#endregion
596
- export { AnalyticsBreakdownWidget, AnalyticsMetricWidget, AnalyticsRealtimeWidget, AnalyticsStatField, AnalyticsTrendWidget, formatMetricValue, readForWidget, readForWidgetBreakdown, readForWidgetRealtime, readForWidgetSeries };
597
-
598
- //# sourceMappingURL=rsc.js.map
1
+ import { readForWidgetSeries } from "../widgets/readForWidgetSeries.js";
2
+ import { readForField } from "../fields/readForDocument.js";
3
+ import { readForWidgetRealtime } from "../widgets/readForWidgetRealtime.js";
4
+ import { readForWidget } from "../widgets/readForWidget.js";
5
+ import { readForWidgetBreakdown } from "../widgets/readForWidgetBreakdown.js";
6
+ import { formatMetricValue } from "../fields/format.js";
7
+ import { AnalyticsStatField } from "../fields/AnalyticsStatField.js";
8
+ import { AnalyticsPanelField } from "../fields/AnalyticsPanelField.js";
9
+ import { cardStyle, labelStyle } from "../widgets/cardChrome.js";
10
+ import AnalyticsBreakdownWidget from "../widgets/AnalyticsBreakdownWidget.js";
11
+ import AnalyticsMetricWidget from "../widgets/AnalyticsMetricWidget.js";
12
+ import AnalyticsRealtimeWidget from "../widgets/AnalyticsRealtimeWidget.js";
13
+ import AnalyticsTrendWidget from "../widgets/AnalyticsTrendWidget.js";
14
+ export { AnalyticsBreakdownWidget, AnalyticsMetricWidget, AnalyticsPanelField, AnalyticsRealtimeWidget, AnalyticsStatField, AnalyticsTrendWidget, formatMetricValue, readForField, readForWidget, readForWidgetBreakdown, readForWidgetRealtime, readForWidgetSeries, cardStyle as widgetCardStyle, labelStyle as widgetLabelStyle };
@@ -1,4 +1,6 @@
1
- import { a as AnalyticsFilter, c as AnalyticsRow, d as Granularity, f as MetricKey, i as AnalyticsCapabilities, l as DateRange, n as AnalyticsAdapter, o as AnalyticsQuery, p as RateLimitDescriptor, r as AnalyticsAdapterFactory, s as AnalyticsResult, t as AdapterContext, u as DimensionKey } from "../contract-CWZPKWuR.js";
2
- import { a as HostnameResolver, n as AnalyticsBinding, o as PathResolver, r as BindingContext, t as TimeframePreset } from "../presets-CBfq_uJX.js";
3
- import { a as AnalyticsFieldsOptions, c as AnalyticsTabOptions, o as AnalyticsStatOptions, r as AnalyticsPluginOptions, s as AnalyticsStatRowOptions } from "../index-CZdCT0WJ.js";
4
- export { AdapterContext, AnalyticsAdapter, AnalyticsAdapterFactory, type AnalyticsBinding, AnalyticsCapabilities, type AnalyticsFieldsOptions, AnalyticsFilter, type AnalyticsPluginOptions, AnalyticsQuery, AnalyticsResult, AnalyticsRow, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, type BindingContext, DateRange, DimensionKey, Granularity, type HostnameResolver, MetricKey, type PathResolver, RateLimitDescriptor, type TimeframePreset };
1
+ import { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor } from "../core/contract.js";
2
+ import { AnalyticsBinding, BindingContext, HostnameResolver, PathResolver } from "../binding/types.js";
3
+ import { TimeframePreset } from "../timeframe/presets.js";
4
+ import { AnalyticsFieldsOptions, AnalyticsMetricLabel, AnalyticsMetricLabels, AnalyticsStatOptions, AnalyticsStatRowOptions, AnalyticsTabOptions } from "../fields/factories.js";
5
+ import { AnalyticsPluginOptions } from "../core/options.js";
6
+ export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, type AnalyticsBinding, AnalyticsCapabilities, type AnalyticsFieldsOptions, AnalyticsFilter, type AnalyticsMetricLabel, type AnalyticsMetricLabels, type AnalyticsPluginOptions, AnalyticsQuery, AnalyticsResult, AnalyticsRow, type AnalyticsStatOptions, type AnalyticsStatRowOptions, type AnalyticsTabOptions, type BindingContext, DateRange, DimensionKey, Granularity, type HostnameResolver, MetricKey, PLATFORM_SCOPE, type PathResolver, RateLimitDescriptor, type TimeframePreset };
@@ -1 +1,2 @@
1
- export {};
1
+ import { PLATFORM_SCOPE } from "../core/contract.js";
2
+ export { PLATFORM_SCOPE };