@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,177 @@
1
+ import { dayIso } from "../series.js";
2
+ //#region src/adapters/ga4/ga4.ts
3
+ const METRIC_MAP = {
4
+ pageviews: "screenPageViews",
5
+ visitors: "totalUsers",
6
+ visits: "sessions",
7
+ sessions: "sessions",
8
+ bounceRate: "bounceRate",
9
+ avgDuration: "averageSessionDuration",
10
+ events: "eventCount",
11
+ conversions: "keyEvents",
12
+ revenue: "totalRevenue"
13
+ };
14
+ const DIMENSION_MAP = {
15
+ page: "pagePath",
16
+ referrer: "pageReferrer",
17
+ source: "sessionSource",
18
+ medium: "sessionMedium",
19
+ campaign: "sessionCampaignName",
20
+ utmSource: "sessionSource",
21
+ utmMedium: "sessionMedium",
22
+ utmCampaign: "sessionCampaignName",
23
+ device: "deviceCategory",
24
+ browser: "browser",
25
+ os: "operatingSystem",
26
+ country: "countryId",
27
+ region: "region",
28
+ city: "city",
29
+ language: "language",
30
+ event: "eventName"
31
+ };
32
+ const ga4Metrics = new Set(Object.keys(METRIC_MAP));
33
+ const ga4Dimensions = new Set(Object.keys(DIMENSION_MAP));
34
+ const toContractValue = (metric, raw) => {
35
+ if (metric === "avgDuration") return Math.round(raw * 1e3);
36
+ if (metric === "bounceRate") return Math.round(raw * 100);
37
+ return raw;
38
+ };
39
+ function ga4(config) {
40
+ const capabilities = {
41
+ perPageQuery: true,
42
+ realtime: false,
43
+ comparison: false,
44
+ minGranularity: "day",
45
+ maxLookbackDays: config.maxLookbackDays !== void 0 ? config.maxLookbackDays : 425,
46
+ metrics: ga4Metrics,
47
+ dimensions: ga4Dimensions,
48
+ batchPageReport: true,
49
+ rateLimit: {
50
+ maxConcurrent: 10,
51
+ quotaModel: "tokens",
52
+ readsCountAsUsage: true
53
+ },
54
+ recommendedTtl: {
55
+ realtime: 300,
56
+ aggregate: 21600
57
+ }
58
+ };
59
+ let clientPromise;
60
+ const getClient = () => {
61
+ if (!clientPromise) clientPromise = (async () => {
62
+ let mod;
63
+ try {
64
+ mod = await import("@google-analytics/data");
65
+ } catch {
66
+ throw new Error("@10x-media/analytics: the GA4 adapter requires the optional peer dependency \"@google-analytics/data\". Install it with: pnpm add @google-analytics/data");
67
+ }
68
+ return new mod.BetaAnalyticsDataClient({
69
+ credentials: config.credentials,
70
+ projectId: config.projectId
71
+ });
72
+ })();
73
+ return clientPromise;
74
+ };
75
+ return {
76
+ id: "ga4",
77
+ label: "Google Analytics 4",
78
+ capabilities,
79
+ isConfigured: () => Boolean(config.propertyId && config.credentials?.client_email && config.credentials?.private_key),
80
+ async query(q, _ctx) {
81
+ const fetchedAt = q.dateRange.end.toISOString();
82
+ const wanted = q.metrics.filter((m) => METRIC_MAP[m]);
83
+ const providerMetrics = [...new Set(wanted.map((m) => METRIC_MAP[m]))];
84
+ const dims = (q.dimensions ?? []).filter((d) => DIMENSION_MAP[d]);
85
+ const providerDims = [...new Set(dims.map((d) => DIMENSION_MAP[d]))];
86
+ const readRow = (row) => {
87
+ const out = {};
88
+ for (const m of wanted) {
89
+ const idx = providerMetrics.indexOf(METRIC_MAP[m]);
90
+ out[m] = toContractValue(m, Number(row.metricValues?.[idx]?.value ?? 0));
91
+ }
92
+ return out;
93
+ };
94
+ const baseRequest = {
95
+ property: `properties/${config.propertyId}`,
96
+ dateRanges: [{
97
+ startDate: q.dateRange.start.toISOString().slice(0, 10),
98
+ endDate: q.dateRange.end.toISOString().slice(0, 10)
99
+ }],
100
+ metrics: providerMetrics.map((name) => ({ name })),
101
+ ...q.path ? { dimensionFilter: { filter: {
102
+ fieldName: "pagePath",
103
+ stringFilter: {
104
+ matchType: "EXACT",
105
+ value: q.path
106
+ }
107
+ } } } : {}
108
+ };
109
+ const client = await getClient();
110
+ if (q.granularity === "day" && !dims.length) {
111
+ const [response] = await client.runReport({
112
+ ...baseRequest,
113
+ dimensions: [{ name: "date" }],
114
+ metricAggregations: ["TOTAL"],
115
+ orderBys: [{ dimension: { dimensionName: "date" } }]
116
+ });
117
+ const rows = [];
118
+ for (const row of response.rows ?? []) {
119
+ const ymd = row.dimensionValues?.[0]?.value ?? "";
120
+ const ts = dayIso(`${ymd.slice(0, 4)}-${ymd.slice(4, 6)}-${ymd.slice(6, 8)}`);
121
+ if (ts) rows.push({
122
+ timestamp: ts,
123
+ metrics: readRow(row)
124
+ });
125
+ }
126
+ const totalsRow = response.totals?.[0];
127
+ return {
128
+ rows,
129
+ totals: totalsRow ? readRow(totalsRow) : {},
130
+ meta: {
131
+ provider: "ga4",
132
+ fetchedAt
133
+ }
134
+ };
135
+ }
136
+ const [response] = await client.runReport({
137
+ ...baseRequest,
138
+ ...providerDims.length ? { dimensions: providerDims.map((name) => ({ name })) } : {},
139
+ ...q.limit ? { limit: q.limit } : {}
140
+ });
141
+ if (!dims.length) {
142
+ const row = response.rows?.[0];
143
+ const totals = row ? readRow(row) : {};
144
+ return {
145
+ rows: [{ metrics: totals }],
146
+ totals,
147
+ meta: {
148
+ provider: "ga4",
149
+ fetchedAt
150
+ }
151
+ };
152
+ }
153
+ return {
154
+ rows: (response.rows ?? []).map((row) => {
155
+ const dimValues = {};
156
+ for (const d of dims) {
157
+ const idx = providerDims.indexOf(DIMENSION_MAP[d]);
158
+ dimValues[d] = row.dimensionValues?.[idx]?.value ?? "";
159
+ }
160
+ return {
161
+ dimensions: dimValues,
162
+ metrics: readRow(row)
163
+ };
164
+ }),
165
+ totals: void 0,
166
+ meta: {
167
+ provider: "ga4",
168
+ fetchedAt
169
+ }
170
+ };
171
+ }
172
+ };
173
+ }
174
+ //#endregion
175
+ export { ga4 };
176
+
177
+ //# sourceMappingURL=ga4.js.map
@@ -31,6 +31,6 @@ const fetchJson = async (url, opts) => {
31
31
  return await res.json();
32
32
  };
33
33
  //#endregion
34
- export { fetchJson as t };
34
+ export { fetchJson };
35
35
 
36
- //# sourceMappingURL=fetchJson-DZb2_Puj.js.map
36
+ //# sourceMappingURL=fetchJson.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fetchJson.js","names":[],"sources":["../../../src/adapters/http/fetchJson.ts"],"sourcesContent":["export class ProviderHttpError extends Error {\n\treadonly status: number\n\treadonly provider: string\n\tconstructor(status: number, provider: string, message: string) {\n\t\tsuper(message)\n\t\tthis.name = 'ProviderHttpError'\n\t\tthis.status = status\n\t\tthis.provider = provider\n\t}\n}\n\nexport interface FetchJsonOptions {\n\tmethod?: 'GET' | 'POST'\n\theaders?: Record<string, string>\n\tbody?: unknown\n\tsignal?: AbortSignal\n\tprovider: string\n}\n\n/**\n * Thin JSON fetch used by provider adapters. Throws ProviderHttpError (carrying the\n * status) on a non-2xx response so the surfacing engine's queue can treat it as a\n * failed fetch; the engine owns retry/backoff and caching.\n */\nexport const fetchJson = async <T>(url: string, opts: FetchJsonOptions): Promise<T> => {\n\tconst res = await fetch(url, {\n\t\tmethod: opts.method ?? 'GET',\n\t\theaders: {\n\t\t\t...(opts.body === undefined ? {} : { 'content-type': 'application/json' }),\n\t\t\t...opts.headers,\n\t\t},\n\t\tbody: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n\t\tsignal: opts.signal,\n\t})\n\tif (!res.ok) {\n\t\tconst detail = await res.text().catch(() => '')\n\t\tthrow new ProviderHttpError(\n\t\t\tres.status,\n\t\t\topts.provider,\n\t\t\t`${opts.provider}: HTTP ${res.status} ${detail.slice(0, 200)}`\n\t\t)\n\t}\n\treturn (await res.json()) as T\n}\n"],"mappings":";AAAA,IAAa,oBAAb,cAAuC,MAAM;CAC5C;CACA;CACA,YAAY,QAAgB,UAAkB,SAAiB;EAC9D,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,WAAW;CACjB;AACD;;;;;;AAeA,MAAa,YAAY,OAAU,KAAa,SAAuC;CACtF,MAAM,MAAM,MAAM,MAAM,KAAK;EAC5B,QAAQ,KAAK,UAAU;EACvB,SAAS;GACR,GAAI,KAAK,SAAS,KAAA,IAAY,CAAC,IAAI,EAAE,gBAAgB,mBAAmB;GACxE,GAAG,KAAK;EACT;EACA,MAAM,KAAK,SAAS,KAAA,IAAY,KAAA,IAAY,KAAK,UAAU,KAAK,IAAI;EACpE,QAAQ,KAAK;CACd,CAAC;CACD,IAAI,CAAC,IAAI,IAAI;EACZ,MAAM,SAAS,MAAM,IAAI,KAAK,EAAE,YAAY,EAAE;EAC9C,MAAM,IAAI,kBACT,IAAI,QACJ,KAAK,UACL,GAAG,KAAK,SAAS,SAAS,IAAI,OAAO,GAAG,OAAO,MAAM,GAAG,GAAG,GAC5D;CACD;CACA,OAAQ,MAAM,IAAI,KAAK;AACxB"}
@@ -0,0 +1,15 @@
1
+ import { AnalyticsAdapter } from "../../core/contract.js";
2
+
3
+ //#region src/adapters/plausible/plausible.d.ts
4
+ interface PlausibleConfig {
5
+ siteId: string;
6
+ apiKey: string;
7
+ /** Base URL for self-hosted CE. Defaults to Plausible Cloud. */
8
+ host?: string;
9
+ /** Maximum days of historical data. Defaults to 730. Pass null to disable clamping. */
10
+ maxLookbackDays?: number | null;
11
+ }
12
+ declare function plausible(config: PlausibleConfig): AnalyticsAdapter;
13
+ //#endregion
14
+ export { PlausibleConfig, plausible };
15
+ //# sourceMappingURL=plausible.d.ts.map
@@ -0,0 +1,143 @@
1
+ import { dayIso } from "../series.js";
2
+ import { fetchJson } from "../http/fetchJson.js";
3
+ //#region src/adapters/plausible/plausible.ts
4
+ const METRIC_MAP = {
5
+ pageviews: "pageviews",
6
+ visitors: "visitors",
7
+ visits: "visits",
8
+ sessions: "visits",
9
+ bounceRate: "bounce_rate",
10
+ avgDuration: "visit_duration",
11
+ events: "events",
12
+ scrollDepth: "scroll_depth",
13
+ revenue: "total_revenue"
14
+ };
15
+ const DIMENSION_MAP = {
16
+ page: "event:page",
17
+ source: "visit:source",
18
+ referrer: "visit:referrer",
19
+ device: "visit:device",
20
+ browser: "visit:browser",
21
+ os: "visit:os",
22
+ country: "visit:country",
23
+ region: "visit:region",
24
+ city: "visit:city",
25
+ utmSource: "visit:utm_source",
26
+ utmMedium: "visit:utm_medium",
27
+ utmCampaign: "visit:utm_campaign"
28
+ };
29
+ const plausibleMetrics = new Set(Object.keys(METRIC_MAP));
30
+ const plausibleDimensions = new Set(Object.keys(DIMENSION_MAP));
31
+ const toContractValue = (metric, raw) => metric === "avgDuration" ? Math.round(raw * 1e3) : raw;
32
+ function plausible(config) {
33
+ const host = config.host ?? "https://plausible.io";
34
+ return {
35
+ id: "plausible",
36
+ label: "Plausible",
37
+ capabilities: {
38
+ perPageQuery: true,
39
+ realtime: false,
40
+ comparison: false,
41
+ minGranularity: "day",
42
+ maxLookbackDays: config.maxLookbackDays !== void 0 ? config.maxLookbackDays : 730,
43
+ metrics: plausibleMetrics,
44
+ dimensions: plausibleDimensions,
45
+ batchPageReport: true,
46
+ rateLimit: { requestsPerHour: 600 },
47
+ recommendedTtl: {
48
+ realtime: 300,
49
+ aggregate: 3600
50
+ }
51
+ },
52
+ isConfigured: () => Boolean(config.siteId && config.apiKey),
53
+ async query(q, ctx) {
54
+ const fetchedAt = q.dateRange.end.toISOString();
55
+ const wanted = q.metrics.filter((m) => METRIC_MAP[m]);
56
+ const providerMetrics = [...new Set(wanted.map((m) => METRIC_MAP[m]))];
57
+ const dims = (q.dimensions ?? []).filter((d) => DIMENSION_MAP[d]);
58
+ const filters = [];
59
+ if (q.path) filters.push([
60
+ "is",
61
+ "event:page",
62
+ [q.path]
63
+ ]);
64
+ const readRow = (row) => {
65
+ const out = {};
66
+ for (const m of wanted) {
67
+ const idx = providerMetrics.indexOf(METRIC_MAP[m]);
68
+ out[m] = toContractValue(m, row.metrics[idx] ?? 0);
69
+ }
70
+ return out;
71
+ };
72
+ const postQuery = (extra) => fetchJson(`${host}/api/v2/query`, {
73
+ method: "POST",
74
+ headers: { authorization: `Bearer ${config.apiKey}` },
75
+ body: {
76
+ site_id: config.siteId,
77
+ metrics: providerMetrics,
78
+ date_range: [q.dateRange.start.toISOString().slice(0, 10), q.dateRange.end.toISOString().slice(0, 10)],
79
+ ...filters.length ? { filters } : {},
80
+ ...extra
81
+ },
82
+ signal: ctx.signal,
83
+ provider: "plausible"
84
+ });
85
+ const fetchTotals = async () => {
86
+ const data = await postQuery({});
87
+ return data.results[0] ? readRow(data.results[0]) : {};
88
+ };
89
+ if (q.granularity === "day" && !dims.length) {
90
+ const [seriesData, totals] = await Promise.all([postQuery({ dimensions: ["time:day"] }), fetchTotals()]);
91
+ const rows = [];
92
+ for (const row of seriesData.results) {
93
+ const ts = dayIso(row.dimensions[0] ?? "");
94
+ if (ts) rows.push({
95
+ timestamp: ts,
96
+ metrics: readRow(row)
97
+ });
98
+ }
99
+ return {
100
+ rows,
101
+ totals,
102
+ meta: {
103
+ provider: "plausible",
104
+ fetchedAt
105
+ }
106
+ };
107
+ }
108
+ if (!dims.length) {
109
+ const totals = await fetchTotals();
110
+ return {
111
+ rows: [{ metrics: totals }],
112
+ totals,
113
+ meta: {
114
+ provider: "plausible",
115
+ fetchedAt
116
+ }
117
+ };
118
+ }
119
+ return {
120
+ rows: (await postQuery({ dimensions: dims.map((d) => DIMENSION_MAP[d]) })).results.map((row) => {
121
+ const dimValues = {};
122
+ for (let i = 0; i < dims.length; i++) {
123
+ const d = dims[i];
124
+ if (d !== void 0) dimValues[d] = row.dimensions[i] ?? "";
125
+ }
126
+ return {
127
+ dimensions: dimValues,
128
+ metrics: readRow(row)
129
+ };
130
+ }),
131
+ totals: void 0,
132
+ meta: {
133
+ provider: "plausible",
134
+ fetchedAt
135
+ }
136
+ };
137
+ }
138
+ };
139
+ }
140
+ //#endregion
141
+ export { plausible };
142
+
143
+ //# sourceMappingURL=plausible.js.map
@@ -0,0 +1,23 @@
1
+ import { AnalyticsAdapter } from "../../core/contract.js";
2
+
3
+ //#region src/adapters/posthog/posthog.d.ts
4
+ interface PosthogConfig {
5
+ /** PostHog project id (numeric). */
6
+ projectId: string;
7
+ /** Personal API key with the "Query Read" scope (phx_...). */
8
+ apiKey: string;
9
+ /** API host. Defaults to US Cloud; EU is https://eu.posthog.com, self-host is your instance URL. */
10
+ host?: string;
11
+ /** Maximum days of historical data. Defaults to 730. Pass null to disable clamping. */
12
+ maxLookbackDays?: number | null;
13
+ /**
14
+ * Event property holding a query's scope (e.g. 'tenant'). Enables scoped queries:
15
+ * one platform project captures every scope with this property set, and a scoped
16
+ * read filters on it. Both the property name and value are escaped literals.
17
+ */
18
+ scopeProperty?: string;
19
+ }
20
+ declare function posthog(config: PosthogConfig): AnalyticsAdapter;
21
+ //#endregion
22
+ export { PosthogConfig, posthog };
23
+ //# sourceMappingURL=posthog.d.ts.map
@@ -0,0 +1,121 @@
1
+ import { dayIso } from "../series.js";
2
+ import { fetchJson } from "../http/fetchJson.js";
3
+ //#region src/adapters/posthog/posthog.ts
4
+ const US_CLOUD = "https://us.posthog.com";
5
+ const METRIC_SQL = {
6
+ pageviews: "count()",
7
+ visitors: "count(DISTINCT person_id)",
8
+ visits: "count(DISTINCT properties.$session_id)",
9
+ sessions: "count(DISTINCT properties.$session_id)"
10
+ };
11
+ const posthogMetrics = new Set(Object.keys(METRIC_SQL));
12
+ const posthogDimensions = new Set(["page"]);
13
+ const sqlString = (value) => `'${value.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
14
+ const sqlDateTimeLiteral = (d) => sqlString(d.toISOString().slice(0, 19).replace("T", " "));
15
+ function posthog(config) {
16
+ const host = config.host ?? US_CLOUD;
17
+ return {
18
+ id: "posthog",
19
+ label: "PostHog",
20
+ capabilities: {
21
+ perPageQuery: true,
22
+ realtime: false,
23
+ comparison: false,
24
+ minGranularity: "day",
25
+ maxLookbackDays: config.maxLookbackDays !== void 0 ? config.maxLookbackDays : 730,
26
+ metrics: posthogMetrics,
27
+ dimensions: posthogDimensions,
28
+ batchPageReport: true,
29
+ rateLimit: {
30
+ requestsPerMinute: 240,
31
+ requestsPerHour: 2400
32
+ },
33
+ recommendedTtl: {
34
+ realtime: 300,
35
+ aggregate: 3600
36
+ },
37
+ ...config.scopeProperty ? { scopedQueries: true } : {}
38
+ },
39
+ isConfigured: () => Boolean(config.projectId && config.apiKey),
40
+ async query(q, ctx) {
41
+ const fetchedAt = q.dateRange.end.toISOString();
42
+ const wanted = q.metrics.filter((m) => METRIC_SQL[m]);
43
+ const exprs = [...new Set(wanted.map((m) => METRIC_SQL[m]))];
44
+ const wantsPageBreakdown = (q.dimensions ?? []).includes("page");
45
+ const where = [
46
+ "event = '$pageview'",
47
+ `timestamp >= toDateTime(${sqlDateTimeLiteral(q.dateRange.start)})`,
48
+ `timestamp <= toDateTime(${sqlDateTimeLiteral(q.dateRange.end)})`
49
+ ];
50
+ if (q.path) where.push(`properties.$pathname = ${sqlString(q.path)}`);
51
+ if (config.scopeProperty && q.scope !== void 0) where.push(`properties[${sqlString(config.scopeProperty)}] = ${sqlString(q.scope)}`);
52
+ const selectMetrics = exprs.map((expr, i) => `${expr} AS m${i}`);
53
+ const runSql = (sql) => fetchJson(`${host}/api/projects/${config.projectId}/query/`, {
54
+ method: "POST",
55
+ headers: { authorization: `Bearer ${config.apiKey}` },
56
+ body: { query: {
57
+ kind: "HogQLQuery",
58
+ query: sql
59
+ } },
60
+ signal: ctx.signal,
61
+ provider: "posthog"
62
+ });
63
+ const readRow = (row, offset) => {
64
+ const out = {};
65
+ for (const m of wanted) {
66
+ const idx = exprs.indexOf(METRIC_SQL[m]);
67
+ out[m] = Number(row[offset + idx] ?? 0);
68
+ }
69
+ return out;
70
+ };
71
+ const fetchTotals = async () => {
72
+ const row = (await runSql(`SELECT ${selectMetrics.join(", ")} FROM events WHERE ${where.join(" AND ")}`)).results[0];
73
+ return row ? readRow(row, 0) : {};
74
+ };
75
+ if (q.granularity === "day" && !wantsPageBreakdown) {
76
+ const seriesSql = `SELECT toStartOfDay(timestamp) AS day, ${selectMetrics.join(", ")} FROM events WHERE ${where.join(" AND ")} GROUP BY day ORDER BY day`;
77
+ const [seriesData, totals] = await Promise.all([runSql(seriesSql), fetchTotals()]);
78
+ const rows = [];
79
+ for (const row of seriesData.results) {
80
+ const ts = dayIso(String(row[0] ?? ""));
81
+ if (ts) rows.push({
82
+ timestamp: ts,
83
+ metrics: readRow(row, 1)
84
+ });
85
+ }
86
+ return {
87
+ rows,
88
+ totals,
89
+ meta: {
90
+ provider: "posthog",
91
+ fetchedAt
92
+ }
93
+ };
94
+ }
95
+ if (wantsPageBreakdown) return {
96
+ rows: (await runSql(`SELECT properties.$pathname AS path, ${selectMetrics.join(", ")} FROM events WHERE ${where.join(" AND ")} GROUP BY path ORDER BY m0 DESC LIMIT ${q.limit ?? 100}`)).results.map((row) => ({
97
+ dimensions: { page: String(row[0] ?? "") },
98
+ metrics: readRow(row, 1)
99
+ })),
100
+ totals: void 0,
101
+ meta: {
102
+ provider: "posthog",
103
+ fetchedAt
104
+ }
105
+ };
106
+ const totals = await fetchTotals();
107
+ return {
108
+ rows: [{ metrics: totals }],
109
+ totals,
110
+ meta: {
111
+ provider: "posthog",
112
+ fetchedAt
113
+ }
114
+ };
115
+ }
116
+ };
117
+ }
118
+ //#endregion
119
+ export { posthog };
120
+
121
+ //# sourceMappingURL=posthog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"posthog.js","names":[],"sources":["../../../src/adapters/posthog/posthog.ts"],"sourcesContent":["import type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tAnalyticsRow,\n\tDimensionKey,\n\tMetricKey,\n} from '../../core/contract'\nimport { fetchJson } from '../http/fetchJson'\nimport { dayIso } from '../series'\n\nexport interface PosthogConfig {\n\t/** PostHog project id (numeric). */\n\tprojectId: string\n\t/** Personal API key with the \"Query Read\" scope (phx_...). */\n\tapiKey: string\n\t/** API host. Defaults to US Cloud; EU is https://eu.posthog.com, self-host is your instance URL. */\n\thost?: string\n\t/** Maximum days of historical data. Defaults to 730. Pass null to disable clamping. */\n\tmaxLookbackDays?: number | null\n\t/**\n\t * Event property holding a query's scope (e.g. 'tenant'). Enables scoped queries:\n\t * one platform project captures every scope with this property set, and a scoped\n\t * read filters on it. Both the property name and value are escaped literals.\n\t */\n\tscopeProperty?: string\n}\n\nconst US_CLOUD = 'https://us.posthog.com'\n\n// visits and sessions share the distinct-session expression and are deduped before\n// the SELECT, then read back by the expression's position.\nconst METRIC_SQL: Partial<Record<MetricKey, string>> = {\n\tpageviews: 'count()',\n\tvisitors: 'count(DISTINCT person_id)',\n\tvisits: 'count(DISTINCT properties.$session_id)',\n\tsessions: 'count(DISTINCT properties.$session_id)',\n}\n\nconst posthogMetrics: ReadonlySet<MetricKey> = new Set(Object.keys(METRIC_SQL) as MetricKey[])\nconst posthogDimensions: ReadonlySet<DimensionKey> = new Set<DimensionKey>(['page'])\n\n// The Query API has no parameter binding, so values are inlined as quoted literals.\n// Escape backslashes first, then single quotes, so a crafted path cannot break out.\nconst sqlString = (value: string): string =>\n\t`'${value.replace(/\\\\/g, '\\\\\\\\').replace(/'/g, \"\\\\'\")}'`\n\nconst sqlDateTimeLiteral = (d: Date): string =>\n\tsqlString(d.toISOString().slice(0, 19).replace('T', ' '))\n\ninterface PosthogQueryResponse {\n\tcolumns: string[]\n\ttypes: string[]\n\tresults: unknown[][]\n}\n\nexport function posthog(config: PosthogConfig): AnalyticsAdapter {\n\tconst host = config.host ?? US_CLOUD\n\tconst maxLookbackDays = config.maxLookbackDays !== undefined ? config.maxLookbackDays : 730\n\n\tconst capabilities: AnalyticsCapabilities = {\n\t\tperPageQuery: true,\n\t\trealtime: false,\n\t\tcomparison: false,\n\t\tminGranularity: 'day',\n\t\tmaxLookbackDays,\n\t\tmetrics: posthogMetrics,\n\t\tdimensions: posthogDimensions,\n\t\tbatchPageReport: true,\n\t\trateLimit: { requestsPerMinute: 240, requestsPerHour: 2400 },\n\t\trecommendedTtl: { realtime: 300, aggregate: 3600 },\n\t\t...(config.scopeProperty ? { scopedQueries: true } : {}),\n\t}\n\n\treturn {\n\t\tid: 'posthog',\n\t\tlabel: 'PostHog',\n\t\tcapabilities,\n\t\tisConfigured: () => Boolean(config.projectId && config.apiKey),\n\t\tasync query(q: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tconst fetchedAt = q.dateRange.end.toISOString()\n\t\t\tconst wanted = q.metrics.filter((m) => METRIC_SQL[m])\n\t\t\tconst exprs = [...new Set(wanted.map((m) => METRIC_SQL[m] as string))]\n\t\t\tconst wantsPageBreakdown = (q.dimensions ?? []).includes('page')\n\n\t\t\tconst where = [\n\t\t\t\t\"event = '$pageview'\",\n\t\t\t\t`timestamp >= toDateTime(${sqlDateTimeLiteral(q.dateRange.start)})`,\n\t\t\t\t`timestamp <= toDateTime(${sqlDateTimeLiteral(q.dateRange.end)})`,\n\t\t\t]\n\t\t\tif (q.path) {\n\t\t\t\twhere.push(`properties.$pathname = ${sqlString(q.path)}`)\n\t\t\t}\n\t\t\tif (config.scopeProperty && q.scope !== undefined) {\n\t\t\t\t// Bracket property access with escaped literals: neither the configured\n\t\t\t\t// property name nor the scope value can break out of the HogQL string.\n\t\t\t\twhere.push(`properties[${sqlString(config.scopeProperty)}] = ${sqlString(q.scope)}`)\n\t\t\t}\n\t\t\tconst selectMetrics = exprs.map((expr, i) => `${expr} AS m${i}`)\n\n\t\t\tconst runSql = (sql: string): Promise<PosthogQueryResponse> =>\n\t\t\t\tfetchJson<PosthogQueryResponse>(`${host}/api/projects/${config.projectId}/query/`, {\n\t\t\t\t\tmethod: 'POST',\n\t\t\t\t\theaders: { authorization: `Bearer ${config.apiKey}` },\n\t\t\t\t\tbody: { query: { kind: 'HogQLQuery', query: sql } },\n\t\t\t\t\tsignal: ctx.signal,\n\t\t\t\t\tprovider: 'posthog',\n\t\t\t\t})\n\n\t\t\tconst readRow = (row: unknown[], offset: number): Partial<Record<MetricKey, number>> => {\n\t\t\t\tconst out: Partial<Record<MetricKey, number>> = {}\n\t\t\t\tfor (const m of wanted) {\n\t\t\t\t\tconst idx = exprs.indexOf(METRIC_SQL[m] as string)\n\t\t\t\t\tout[m] = Number(row[offset + idx] ?? 0)\n\t\t\t\t}\n\t\t\t\treturn out\n\t\t\t}\n\n\t\t\tconst fetchTotals = async (): Promise<Partial<Record<MetricKey, number>>> => {\n\t\t\t\tconst data = await runSql(\n\t\t\t\t\t`SELECT ${selectMetrics.join(', ')} FROM events WHERE ${where.join(' AND ')}`\n\t\t\t\t)\n\t\t\t\tconst row = data.results[0]\n\t\t\t\treturn row ? readRow(row, 0) : {}\n\t\t\t}\n\n\t\t\tif (q.granularity === 'day' && !wantsPageBreakdown) {\n\t\t\t\tconst seriesSql = `SELECT toStartOfDay(timestamp) AS day, ${selectMetrics.join(', ')} FROM events WHERE ${where.join(' AND ')} GROUP BY day ORDER BY day`\n\t\t\t\tconst [seriesData, totals] = await Promise.all([runSql(seriesSql), fetchTotals()])\n\t\t\t\tconst rows: AnalyticsRow[] = []\n\t\t\t\tfor (const row of seriesData.results) {\n\t\t\t\t\tconst ts = dayIso(String(row[0] ?? ''))\n\t\t\t\t\tif (ts) {\n\t\t\t\t\t\trows.push({ timestamp: ts, metrics: readRow(row, 1) })\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { rows, totals, meta: { provider: 'posthog', fetchedAt } }\n\t\t\t}\n\n\t\t\tif (wantsPageBreakdown) {\n\t\t\t\tconst sql = `SELECT properties.$pathname AS path, ${selectMetrics.join(', ')} FROM events WHERE ${where.join(' AND ')} GROUP BY path ORDER BY m0 DESC LIMIT ${q.limit ?? 100}`\n\t\t\t\tconst data = await runSql(sql)\n\t\t\t\tconst rows: AnalyticsRow[] = data.results.map((row) => ({\n\t\t\t\t\tdimensions: { page: String(row[0] ?? '') },\n\t\t\t\t\tmetrics: readRow(row, 1),\n\t\t\t\t}))\n\t\t\t\treturn { rows, totals: undefined, meta: { provider: 'posthog', fetchedAt } }\n\t\t\t}\n\n\t\t\tconst totals = await fetchTotals()\n\t\t\treturn { rows: [{ metrics: totals }], totals, meta: { provider: 'posthog', fetchedAt } }\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -12,6 +12,6 @@ const dayIso = (value) => {
12
12
  return Number.isNaN(t) ? null : new Date(t).toISOString();
13
13
  };
14
14
  //#endregion
15
- export { dayIso as t };
15
+ export { dayIso };
16
16
 
17
- //# sourceMappingURL=series-zytbzPoc.js.map
17
+ //# sourceMappingURL=series.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"series.js","names":[],"sources":["../../src/adapters/series.ts"],"sourcesContent":["/**\n * Normalize a provider's day label to a UTC-day ISO string. Takes any value whose first\n * 10 chars are `YYYY-MM-DD` (a bare date, or a datetime like `2026-06-23 14:00:00`).\n * Returns null for an unparseable value so the caller can skip that one row rather than\n * emit a broken timestamp.\n */\nexport const dayIso = (value: string): string | null => {\n\tconst date = value.slice(0, 10)\n\t// V8's Date.parse leniently accepts year-only and year-month strings, so require a\n\t// full YYYY-MM-DD before parsing or a short value would resolve to Jan 1, not null.\n\tif (date.length !== 10) {\n\t\treturn null\n\t}\n\tconst t = Date.parse(`${date}T00:00:00.000Z`)\n\treturn Number.isNaN(t) ? null : new Date(t).toISOString()\n}\n"],"mappings":";;;;;;;AAMA,MAAa,UAAU,UAAiC;CACvD,MAAM,OAAO,MAAM,MAAM,GAAG,EAAE;CAG9B,IAAI,KAAK,WAAW,IACnB,OAAO;CAER,MAAM,IAAI,KAAK,MAAM,GAAG,KAAK,eAAe;CAC5C,OAAO,OAAO,MAAM,CAAC,IAAI,OAAO,IAAI,KAAK,CAAC,EAAE,YAAY;AACzD"}
@@ -0,0 +1,18 @@
1
+ import { AnalyticsAdapter } from "../../core/contract.js";
2
+
3
+ //#region src/adapters/umami/umami.d.ts
4
+ interface UmamiConfig {
5
+ websiteId: string;
6
+ /** Umami Cloud API key (sent as x-umami-api-key). */
7
+ apiKey?: string;
8
+ /** Self-hosted bearer token (from POST /api/auth/login). */
9
+ token?: string;
10
+ /** API base URL. Defaults to Umami Cloud (https://api.umami.is/v1). Self-hosted is e.g. https://site/api. */
11
+ host?: string;
12
+ /** Maximum days of historical data. Defaults to 730. Pass null to disable clamping. */
13
+ maxLookbackDays?: number | null;
14
+ }
15
+ declare function umami(config: UmamiConfig): AnalyticsAdapter;
16
+ //#endregion
17
+ export { UmamiConfig, umami };
18
+ //# sourceMappingURL=umami.d.ts.map