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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (285) hide show
  1. package/CHANGELOG.md +127 -0
  2. package/README.md +38 -357
  3. package/dist/adapters/ga4/ga4.d.ts +20 -0
  4. package/dist/adapters/ga4/ga4.js +187 -0
  5. package/dist/adapters/ga4/ga4.js.map +1 -0
  6. package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
  7. package/dist/adapters/http/fetchJson.js.map +1 -0
  8. package/dist/adapters/plausible/plausible.d.ts +15 -0
  9. package/dist/adapters/plausible/plausible.js +148 -0
  10. package/dist/adapters/plausible/plausible.js.map +1 -0
  11. package/dist/adapters/posthog/posthog.d.ts +23 -0
  12. package/dist/adapters/posthog/posthog.js +132 -0
  13. package/dist/adapters/posthog/posthog.js.map +1 -0
  14. package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
  15. package/dist/adapters/series.js.map +1 -0
  16. package/dist/adapters/umami/umami.d.ts +18 -0
  17. package/dist/adapters/umami/umami.js +139 -0
  18. package/dist/{exports/adapters → adapters/umami}/umami.js.map +1 -1
  19. package/dist/binding/resolvePath.js +61 -0
  20. package/dist/binding/resolvePath.js.map +1 -0
  21. package/dist/binding/types.d.ts +55 -0
  22. package/dist/charts/BarList.d.ts +20 -0
  23. package/dist/charts/BarList.js +73 -0
  24. package/dist/charts/BarList.js.map +1 -0
  25. package/dist/charts/TrendChart.d.ts +25 -0
  26. package/dist/charts/TrendChart.js +195 -0
  27. package/dist/charts/TrendChart.js.map +1 -0
  28. package/dist/charts/bars.d.ts +9 -0
  29. package/dist/charts/bars.js +19 -0
  30. package/dist/charts/bars.js.map +1 -0
  31. package/dist/charts/bucket.js +86 -0
  32. package/dist/charts/bucket.js.map +1 -0
  33. package/dist/charts/spline.js +84 -0
  34. package/dist/charts/spline.js.map +1 -0
  35. package/dist/charts/styles.js +42 -0
  36. package/dist/charts/styles.js.map +1 -0
  37. package/dist/core/cacheKey.js +28 -0
  38. package/dist/core/cacheKey.js.map +1 -0
  39. package/dist/core/capabilities.d.ts +12 -0
  40. package/dist/core/capabilities.js +12 -0
  41. package/dist/core/capabilities.js.map +1 -0
  42. package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +42 -5
  43. package/dist/core/contract.js +10 -0
  44. package/dist/core/contract.js.map +1 -0
  45. package/dist/core/granularity.js +17 -0
  46. package/dist/core/granularity.js.map +1 -0
  47. package/dist/core/options.d.ts +140 -0
  48. package/dist/core/options.js +114 -0
  49. package/dist/core/options.js.map +1 -0
  50. package/dist/core/registry.js +24 -0
  51. package/dist/core/registry.js.map +1 -0
  52. package/dist/core/scopedRead.js +57 -0
  53. package/dist/core/scopedRead.js.map +1 -0
  54. package/dist/exports/adapters/ga4.d.ts +2 -20
  55. package/dist/exports/adapters/ga4.js +1 -176
  56. package/dist/exports/adapters/native.d.ts +2 -22
  57. package/dist/exports/adapters/native.js +1 -848
  58. package/dist/exports/adapters/plausible.d.ts +2 -15
  59. package/dist/exports/adapters/plausible.js +1 -142
  60. package/dist/exports/adapters/posthog.d.ts +2 -17
  61. package/dist/exports/adapters/posthog.js +1 -118
  62. package/dist/exports/adapters/umami.d.ts +2 -18
  63. package/dist/exports/adapters/umami.js +1 -138
  64. package/dist/exports/client.d.ts +5 -77
  65. package/dist/exports/client.js +4 -386
  66. package/dist/exports/geo.d.ts +4 -19
  67. package/dist/exports/geo.js +3 -1
  68. package/dist/exports/i18n.d.ts +3 -63
  69. package/dist/exports/i18n.js +2 -2
  70. package/dist/exports/next.d.ts +2 -0
  71. package/dist/exports/next.js +2 -0
  72. package/dist/exports/rsc.d.ts +16 -120
  73. package/dist/exports/rsc.js +14 -598
  74. package/dist/exports/types.d.ts +6 -4
  75. package/dist/exports/types.js +2 -1
  76. package/dist/fields/AnalyticsPanelClient.js +193 -0
  77. package/dist/fields/AnalyticsPanelClient.js.map +1 -0
  78. package/dist/fields/AnalyticsPanelField.d.ts +28 -0
  79. package/dist/fields/AnalyticsPanelField.js +54 -0
  80. package/dist/fields/AnalyticsPanelField.js.map +1 -0
  81. package/dist/fields/AnalyticsStatField.d.ts +31 -0
  82. package/dist/fields/AnalyticsStatField.js +104 -0
  83. package/dist/fields/AnalyticsStatField.js.map +1 -0
  84. package/dist/fields/dateRange/field.js +55 -0
  85. package/dist/fields/dateRange/field.js.map +1 -0
  86. package/dist/fields/dateRange/styles.js +23 -0
  87. package/dist/fields/dateRange/styles.js.map +1 -0
  88. package/dist/fields/dateRange/types.d.ts +11 -0
  89. package/dist/fields/dateRange/ui.d.ts +9 -0
  90. package/dist/fields/dateRange/ui.js +373 -0
  91. package/dist/fields/dateRange/ui.js.map +1 -0
  92. package/dist/fields/emptyState.js +46 -0
  93. package/dist/fields/emptyState.js.map +1 -0
  94. package/dist/fields/factories.d.ts +60 -0
  95. package/dist/fields/factories.js +94 -0
  96. package/dist/fields/factories.js.map +1 -0
  97. package/dist/fields/format.d.ts +7 -0
  98. package/dist/fields/format.js +22 -0
  99. package/dist/fields/format.js.map +1 -0
  100. package/dist/fields/readForDocument.d.ts +57 -0
  101. package/dist/fields/readForDocument.js +147 -0
  102. package/dist/fields/readForDocument.js.map +1 -0
  103. package/dist/index.d.ts +18 -3
  104. package/dist/index.js +83 -1028
  105. package/dist/index.js.map +1 -1
  106. package/dist/native/collections/events.js +101 -0
  107. package/dist/native/collections/events.js.map +1 -0
  108. package/dist/native/collections/rollups.js +115 -0
  109. package/dist/native/collections/rollups.js.map +1 -0
  110. package/dist/native/collections/seen.js +47 -0
  111. package/dist/native/collections/seen.js.map +1 -0
  112. package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
  113. package/dist/native/geo/composeGeoResolvers.js +14 -0
  114. package/dist/native/geo/composeGeoResolvers.js.map +1 -0
  115. package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
  116. package/dist/native/geo/geoResolver.js +11 -0
  117. package/dist/native/geo/geoResolver.js.map +1 -0
  118. package/dist/native/geo/maxmindResolver.d.ts +16 -0
  119. package/dist/native/geo/maxmindResolver.js +55 -0
  120. package/dist/native/geo/maxmindResolver.js.map +1 -0
  121. package/dist/native/ingest/device.js +15 -0
  122. package/dist/native/ingest/device.js.map +1 -0
  123. package/dist/native/ingest/endpoint.js +30 -0
  124. package/dist/native/ingest/endpoint.js.map +1 -0
  125. package/dist/native/ingest/flushBatch.js +69 -0
  126. package/dist/native/ingest/flushBatch.js.map +1 -0
  127. package/dist/native/ingest/normalizeEvent.js +39 -0
  128. package/dist/native/ingest/normalizeEvent.js.map +1 -0
  129. package/dist/native/ingest/salt.js +14 -0
  130. package/dist/native/ingest/salt.js.map +1 -0
  131. package/dist/native/ingest/source.js +22 -0
  132. package/dist/native/ingest/source.js.map +1 -0
  133. package/dist/native/ingest/visitorHash.js +12 -0
  134. package/dist/native/ingest/visitorHash.js.map +1 -0
  135. package/dist/native/ingest/writeBuffer.js +55 -0
  136. package/dist/native/ingest/writeBuffer.js.map +1 -0
  137. package/dist/native/ingest/writeEvent.js +14 -0
  138. package/dist/native/ingest/writeEvent.js.map +1 -0
  139. package/dist/native/nativeAdapter.d.ts +22 -0
  140. package/dist/native/nativeAdapter.js +216 -0
  141. package/dist/native/nativeAdapter.js.map +1 -0
  142. package/dist/native/realtime/buildRealtime.js +53 -0
  143. package/dist/native/realtime/buildRealtime.js.map +1 -0
  144. package/dist/native/retention/pruneTask.js +29 -0
  145. package/dist/native/retention/pruneTask.js.map +1 -0
  146. package/dist/native/rollupAcc.js +53 -0
  147. package/dist/native/rollupAcc.js.map +1 -0
  148. package/dist/native/rollups/applyDistinctDeltas.js +9 -0
  149. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
  150. package/dist/native/rollups/bumpRollup.js +52 -0
  151. package/dist/native/rollups/bumpRollup.js.map +1 -0
  152. package/dist/native/rollups/deltas.js +31 -0
  153. package/dist/native/rollups/deltas.js.map +1 -0
  154. package/dist/native/rollups/insertIfNew.js +19 -0
  155. package/dist/native/rollups/insertIfNew.js.map +1 -0
  156. package/dist/next/posthogProxyRewrites.d.ts +36 -0
  157. package/dist/next/posthogProxyRewrites.js +50 -0
  158. package/dist/next/posthogProxyRewrites.js.map +1 -0
  159. package/dist/plugin/documentEndpoint.js +80 -0
  160. package/dist/plugin/documentEndpoint.js.map +1 -0
  161. package/dist/plugin/paths.js +11 -0
  162. package/dist/plugin/paths.js.map +1 -0
  163. package/dist/plugin/realtimeEndpoint.js +36 -0
  164. package/dist/plugin/realtimeEndpoint.js.map +1 -0
  165. package/dist/plugin/registerTranslations.js +19 -0
  166. package/dist/plugin/registerTranslations.js.map +1 -0
  167. package/dist/plugin/runtime.js +21 -0
  168. package/dist/plugin/runtime.js.map +1 -0
  169. package/dist/plugin/warmTask.js +165 -0
  170. package/dist/plugin/warmTask.js.map +1 -0
  171. package/dist/providers/collection.js +159 -0
  172. package/dist/providers/collection.js.map +1 -0
  173. package/dist/providers/factory.js +62 -0
  174. package/dist/providers/factory.js.map +1 -0
  175. package/dist/providers/resolver.js +67 -0
  176. package/dist/providers/resolver.js.map +1 -0
  177. package/dist/providers/secrets.js +27 -0
  178. package/dist/providers/secrets.js.map +1 -0
  179. package/dist/surfacing/cacheStore.js +26 -0
  180. package/dist/surfacing/cacheStore.js.map +1 -0
  181. package/dist/surfacing/coalesce.js +15 -0
  182. package/dist/surfacing/coalesce.js.map +1 -0
  183. package/dist/surfacing/engine.js +63 -0
  184. package/dist/surfacing/engine.js.map +1 -0
  185. package/dist/surfacing/queue.js +44 -0
  186. package/dist/surfacing/queue.js.map +1 -0
  187. package/dist/sync/collection.js +70 -0
  188. package/dist/sync/collection.js.map +1 -0
  189. package/dist/sync/syncTask.js +123 -0
  190. package/dist/sync/syncTask.js.map +1 -0
  191. package/dist/testing/memoryAdapter.d.ts +1 -1
  192. package/dist/timeframe/presets.d.ts +6 -0
  193. package/dist/timeframe/presets.js +59 -0
  194. package/dist/timeframe/presets.js.map +1 -0
  195. package/dist/timeframe/tz.js +110 -0
  196. package/dist/timeframe/tz.js.map +1 -0
  197. package/dist/translations/de.js +78 -0
  198. package/dist/translations/de.js.map +1 -0
  199. package/dist/{translations-keiKtSjF.js → translations/en.js} +30 -25
  200. package/dist/translations/en.js.map +1 -0
  201. package/dist/translations/index.d.ts +15 -0
  202. package/dist/translations/index.js +30 -0
  203. package/dist/translations/index.js.map +1 -0
  204. package/dist/translations/keys.d.ts +81 -0
  205. package/dist/{keys-DEqL4LOT.js → translations/keys.js} +29 -5
  206. package/dist/translations/keys.js.map +1 -0
  207. package/dist/translations/metricKeys.js +28 -0
  208. package/dist/translations/metricKeys.js.map +1 -0
  209. package/dist/translations/server.js +13 -0
  210. package/dist/translations/server.js.map +1 -0
  211. package/dist/translations/useTranslation.js +12 -0
  212. package/dist/translations/useTranslation.js.map +1 -0
  213. package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
  214. package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
  215. package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
  216. package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
  217. package/dist/widgets/AnalyticsMetricWidget.js +89 -0
  218. package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
  219. package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
  220. package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
  221. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
  222. package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
  223. package/dist/widgets/AnalyticsTrendWidget.js +99 -0
  224. package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
  225. package/dist/widgets/ComparisonDelta.js +83 -0
  226. package/dist/widgets/ComparisonDelta.js.map +1 -0
  227. package/dist/widgets/RealtimeCounter.d.ts +19 -0
  228. package/dist/widgets/RealtimeCounter.js +76 -0
  229. package/dist/widgets/RealtimeCounter.js.map +1 -0
  230. package/dist/widgets/breakdownTypes.js +29 -0
  231. package/dist/widgets/breakdownTypes.js.map +1 -0
  232. package/dist/widgets/cardChrome.d.ts +8 -0
  233. package/dist/widgets/cardChrome.js +22 -0
  234. package/dist/widgets/cardChrome.js.map +1 -0
  235. package/dist/widgets/comparison.js +43 -0
  236. package/dist/widgets/comparison.js.map +1 -0
  237. package/dist/widgets/customWidget.d.ts +20 -0
  238. package/dist/widgets/customWidget.js +30 -0
  239. package/dist/widgets/customWidget.js.map +1 -0
  240. package/dist/widgets/defaults.d.ts +12 -0
  241. package/dist/widgets/defaults.js +72 -0
  242. package/dist/widgets/defaults.js.map +1 -0
  243. package/dist/widgets/range.js +28 -0
  244. package/dist/widgets/range.js.map +1 -0
  245. package/dist/widgets/readForWidget.d.ts +31 -0
  246. package/dist/widgets/readForWidget.js +72 -0
  247. package/dist/widgets/readForWidget.js.map +1 -0
  248. package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
  249. package/dist/widgets/readForWidgetBreakdown.js +80 -0
  250. package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
  251. package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
  252. package/dist/widgets/readForWidgetRealtime.js +63 -0
  253. package/dist/widgets/readForWidgetRealtime.js.map +1 -0
  254. package/dist/widgets/readForWidgetSeries.d.ts +44 -0
  255. package/dist/widgets/readForWidgetSeries.js +117 -0
  256. package/dist/widgets/readForWidgetSeries.js.map +1 -0
  257. package/dist/widgets/realtimePoll.js +26 -0
  258. package/dist/widgets/realtimePoll.js.map +1 -0
  259. package/dist/widgets/registerWidgets.js +228 -0
  260. package/dist/widgets/registerWidgets.js.map +1 -0
  261. package/dist/widgets/types.js +13 -0
  262. package/dist/widgets/types.js.map +1 -0
  263. package/package.json +19 -5
  264. package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
  265. package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
  266. package/dist/dist-B6HruP5v.js +0 -4731
  267. package/dist/dist-B6HruP5v.js.map +0 -1
  268. package/dist/exports/adapters/ga4.js.map +0 -1
  269. package/dist/exports/adapters/native.js.map +0 -1
  270. package/dist/exports/adapters/plausible.js.map +0 -1
  271. package/dist/exports/adapters/posthog.js.map +0 -1
  272. package/dist/exports/client.js.map +0 -1
  273. package/dist/exports/rsc.js.map +0 -1
  274. package/dist/fetchJson-DZb2_Puj.js.map +0 -1
  275. package/dist/index-CZdCT0WJ.d.ts +0 -98
  276. package/dist/keys-DEqL4LOT.js.map +0 -1
  277. package/dist/lib-CE5x1zLQ.js +0 -1058
  278. package/dist/lib-CE5x1zLQ.js.map +0 -1
  279. package/dist/maxmindResolver-CXYXXdul.js +0 -99
  280. package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
  281. package/dist/presets-CBfq_uJX.d.ts +0 -38
  282. package/dist/series-zytbzPoc.js.map +0 -1
  283. package/dist/server-Cuvhgz-S.js +0 -492
  284. package/dist/server-Cuvhgz-S.js.map +0 -1
  285. package/dist/translations-keiKtSjF.js.map +0 -1
@@ -0,0 +1,63 @@
1
+ import { startOfDayInTz } from "../timeframe/tz.js";
2
+ import { buildCacheKey } from "../core/cacheKey.js";
3
+ import { createCoalescer } from "./coalesce.js";
4
+ import { createQueue } from "./queue.js";
5
+ //#region src/surfacing/engine.ts
6
+ const DAY_MS = 864e5;
7
+ const clampRange = (range, maxLookbackDays, tz = "UTC") => {
8
+ if (maxLookbackDays == null) return {
9
+ range,
10
+ clamped: false
11
+ };
12
+ const floor = /* @__PURE__ */ new Date(startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS);
13
+ if (range.start.getTime() >= floor.getTime()) return {
14
+ range,
15
+ clamped: false
16
+ };
17
+ return {
18
+ range: {
19
+ start: floor,
20
+ end: range.end
21
+ },
22
+ clamped: true
23
+ };
24
+ };
25
+ const emptyResult = (provider, q) => ({
26
+ rows: [],
27
+ meta: {
28
+ provider,
29
+ fetchedAt: q.dateRange.end.toISOString()
30
+ }
31
+ });
32
+ function createEngine(opts) {
33
+ const coalesce = createCoalescer();
34
+ const queue = createQueue(opts.queue);
35
+ return { async read(adapter, query) {
36
+ if (!adapter.isConfigured()) return emptyResult(adapter.id, query);
37
+ const { range, clamped } = clampRange(query.dateRange, adapter.capabilities.maxLookbackDays, query.timezone);
38
+ const q = clamped ? {
39
+ ...query,
40
+ dateRange: range
41
+ } : query;
42
+ const key = buildCacheKey(adapter.id, q);
43
+ return coalesce(key, async () => {
44
+ const cached = await opts.store.get(key);
45
+ if (cached) return cached;
46
+ const fresh = await queue.run(() => adapter.query(q, {}));
47
+ const result = clamped ? {
48
+ ...fresh,
49
+ meta: {
50
+ ...fresh.meta,
51
+ clamped: true
52
+ }
53
+ } : fresh;
54
+ const ttl = opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate;
55
+ await opts.store.set(key, result, ttl);
56
+ return result;
57
+ });
58
+ } };
59
+ }
60
+ //#endregion
61
+ export { createEngine };
62
+
63
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","names":[],"sources":["../../src/surfacing/engine.ts"],"sourcesContent":["import { buildCacheKey } from '../core/cacheKey'\nimport type { AnalyticsAdapter, AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { CacheStore } from './cacheStore'\nimport { createCoalescer } from './coalesce'\nimport { createQueue, type QueueOptions } from './queue'\n\nconst DAY_MS = 86_400_000\n\nconst clampRange = (\n\trange: AnalyticsQuery['dateRange'],\n\tmaxLookbackDays: number | null,\n\ttz: string = DEFAULT_TIMEZONE\n): { range: AnalyticsQuery['dateRange']; clamped: boolean } => {\n\tif (maxLookbackDays == null) {\n\t\treturn { range, clamped: false }\n\t}\n\tconst floor = new Date(startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS)\n\tif (range.start.getTime() >= floor.getTime()) {\n\t\treturn { range, clamped: false }\n\t}\n\treturn { range: { start: floor, end: range.end }, clamped: true }\n}\n\nexport interface EngineOptions {\n\tstore: CacheStore\n\tqueue: QueueOptions\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n}\n\nexport interface Engine {\n\tread(adapter: AnalyticsAdapter, query: AnalyticsQuery): Promise<AnalyticsResult>\n}\n\nconst emptyResult = (provider: string, q: AnalyticsQuery): AnalyticsResult => ({\n\trows: [],\n\tmeta: { provider, fetchedAt: q.dateRange.end.toISOString() },\n})\n\nexport function createEngine(opts: EngineOptions): Engine {\n\tconst coalesce = createCoalescer<AnalyticsResult>()\n\tconst queue = createQueue(opts.queue)\n\n\treturn {\n\t\tasync read(adapter, query) {\n\t\t\tif (!adapter.isConfigured()) return emptyResult(adapter.id, query)\n\n\t\t\tconst { range, clamped } = clampRange(\n\t\t\t\tquery.dateRange,\n\t\t\t\tadapter.capabilities.maxLookbackDays,\n\t\t\t\tquery.timezone\n\t\t\t)\n\t\t\tconst q = clamped ? { ...query, dateRange: range } : query\n\t\t\tconst key = buildCacheKey(adapter.id, q)\n\t\t\treturn coalesce(key, async () => {\n\t\t\t\tconst cached = await opts.store.get<AnalyticsResult>(key)\n\t\t\t\tif (cached) return cached\n\n\t\t\t\tconst fresh = await queue.run(() => adapter.query(q, {}))\n\t\t\t\tconst result: AnalyticsResult = clamped\n\t\t\t\t\t? { ...fresh, meta: { ...fresh.meta, clamped: true } }\n\t\t\t\t\t: fresh\n\t\t\t\tconst ttl = opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate\n\t\t\t\tawait opts.store.set(key, result, ttl)\n\t\t\t\treturn result\n\t\t\t})\n\t\t},\n\t}\n}\n"],"mappings":";;;;;AAOA,MAAM,SAAS;AAEf,MAAM,cACL,OACA,iBACA,KAAA,UAC8D;CAC9D,IAAI,mBAAmB,MACtB,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,MAAM,wBAAQ,IAAI,KAAK,eAAe,MAAM,KAAK,EAAE,EAAE,QAAQ,IAAI,kBAAkB,MAAM;CACzF,IAAI,MAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,GAC1C,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,OAAO;EAAE,OAAO;GAAE,OAAO;GAAO,KAAK,MAAM;EAAI;EAAG,SAAS;CAAK;AACjE;AAaA,MAAM,eAAe,UAAkB,OAAwC;CAC9E,MAAM,CAAC;CACP,MAAM;EAAE;EAAU,WAAW,EAAE,UAAU,IAAI,YAAY;CAAE;AAC5D;AAEA,SAAgB,aAAa,MAA6B;CACzD,MAAM,WAAW,gBAAiC;CAClD,MAAM,QAAQ,YAAY,KAAK,KAAK;CAEpC,OAAO,EACN,MAAM,KAAK,SAAS,OAAO;EAC1B,IAAI,CAAC,QAAQ,aAAa,GAAG,OAAO,YAAY,QAAQ,IAAI,KAAK;EAEjE,MAAM,EAAE,OAAO,YAAY,WAC1B,MAAM,WACN,QAAQ,aAAa,iBACrB,MAAM,QACP;EACA,MAAM,IAAI,UAAU;GAAE,GAAG;GAAO,WAAW;EAAM,IAAI;EACrD,MAAM,MAAM,cAAc,QAAQ,IAAI,CAAC;EACvC,OAAO,SAAS,KAAK,YAAY;GAChC,MAAM,SAAS,MAAM,KAAK,MAAM,IAAqB,GAAG;GACxD,IAAI,QAAQ,OAAO;GAEnB,MAAM,QAAQ,MAAM,MAAM,UAAU,QAAQ,MAAM,GAAG,CAAC,CAAC,CAAC;GACxD,MAAM,SAA0B,UAC7B;IAAE,GAAG;IAAO,MAAM;KAAE,GAAG,MAAM;KAAM,SAAS;IAAK;GAAE,IACnD;GACH,MAAM,MAAM,KAAK,IAAI,aAAa,QAAQ,aAAa,eAAe;GACtE,MAAM,KAAK,MAAM,IAAI,KAAK,QAAQ,GAAG;GACrC,OAAO;EACR,CAAC;CACF,EACD;AACD"}
@@ -0,0 +1,44 @@
1
+ //#region src/surfacing/queue.ts
2
+ const wait = (ms) => new Promise((r) => setTimeout(r, ms));
3
+ function createQueue(opts) {
4
+ const maxRetries = opts.maxRetries ?? 0;
5
+ const baseDelayMs = opts.baseDelayMs ?? 200;
6
+ let active = 0;
7
+ const pending = [];
8
+ const acquire = () => {
9
+ if (active < opts.concurrency) {
10
+ active++;
11
+ return Promise.resolve();
12
+ }
13
+ return new Promise((resolve) => pending.push(resolve)).then(() => {
14
+ active++;
15
+ });
16
+ };
17
+ const release = () => {
18
+ active--;
19
+ pending.shift()?.();
20
+ };
21
+ const withRetry = async (task) => {
22
+ let attempt = 0;
23
+ for (;;) try {
24
+ return await task();
25
+ } catch (err) {
26
+ if (attempt >= maxRetries) throw err;
27
+ const jitter = baseDelayMs * .5;
28
+ await wait(baseDelayMs * 2 ** attempt + jitter * attempt);
29
+ attempt++;
30
+ }
31
+ };
32
+ return { async run(task) {
33
+ await acquire();
34
+ try {
35
+ return await withRetry(task);
36
+ } finally {
37
+ release();
38
+ }
39
+ } };
40
+ }
41
+ //#endregion
42
+ export { createQueue };
43
+
44
+ //# sourceMappingURL=queue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queue.js","names":[],"sources":["../../src/surfacing/queue.ts"],"sourcesContent":["export interface QueueOptions {\n\tconcurrency: number\n\tmaxRetries?: number\n\tbaseDelayMs?: number\n}\n\nexport interface Queue {\n\trun<T>(task: () => Promise<T>): Promise<T>\n}\n\nconst wait = (ms: number) => new Promise((r) => setTimeout(r, ms))\n\nexport function createQueue(opts: QueueOptions): Queue {\n\tconst maxRetries = opts.maxRetries ?? 0\n\tconst baseDelayMs = opts.baseDelayMs ?? 200\n\tlet active = 0\n\tconst pending: Array<() => void> = []\n\n\tconst acquire = (): Promise<void> => {\n\t\tif (active < opts.concurrency) {\n\t\t\tactive++\n\t\t\treturn Promise.resolve()\n\t\t}\n\t\treturn new Promise<void>((resolve) => pending.push(resolve)).then(() => {\n\t\t\tactive++\n\t\t})\n\t}\n\n\tconst release = (): void => {\n\t\tactive--\n\t\tpending.shift()?.()\n\t}\n\n\tconst withRetry = async <T>(task: () => Promise<T>): Promise<T> => {\n\t\tlet attempt = 0\n\t\tfor (;;) {\n\t\t\ttry {\n\t\t\t\treturn await task()\n\t\t\t} catch (err) {\n\t\t\t\tif (attempt >= maxRetries) throw err\n\t\t\t\t// Jitter derived from attempt count, not Math.random, to keep tests deterministic\n\t\t\t\tconst jitter = baseDelayMs * 0.5\n\t\t\t\tawait wait(baseDelayMs * 2 ** attempt + jitter * attempt)\n\t\t\t\tattempt++\n\t\t\t}\n\t\t}\n\t}\n\n\treturn {\n\t\tasync run<T>(task: () => Promise<T>): Promise<T> {\n\t\t\tawait acquire()\n\t\t\ttry {\n\t\t\t\treturn await withRetry(task)\n\t\t\t} finally {\n\t\t\t\trelease()\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";AAUA,MAAM,QAAQ,OAAe,IAAI,SAAS,MAAM,WAAW,GAAG,EAAE,CAAC;AAEjE,SAAgB,YAAY,MAA2B;CACtD,MAAM,aAAa,KAAK,cAAc;CACtC,MAAM,cAAc,KAAK,eAAe;CACxC,IAAI,SAAS;CACb,MAAM,UAA6B,CAAC;CAEpC,MAAM,gBAA+B;EACpC,IAAI,SAAS,KAAK,aAAa;GAC9B;GACA,OAAO,QAAQ,QAAQ;EACxB;EACA,OAAO,IAAI,SAAe,YAAY,QAAQ,KAAK,OAAO,CAAC,EAAE,WAAW;GACvE;EACD,CAAC;CACF;CAEA,MAAM,gBAAsB;EAC3B;EACA,QAAQ,MAAM,IAAI;CACnB;CAEA,MAAM,YAAY,OAAU,SAAuC;EAClE,IAAI,UAAU;EACd,SACC,IAAI;GACH,OAAO,MAAM,KAAK;EACnB,SAAS,KAAK;GACb,IAAI,WAAW,YAAY,MAAM;GAEjC,MAAM,SAAS,cAAc;GAC7B,MAAM,KAAK,cAAc,KAAK,UAAU,SAAS,OAAO;GACxD;EACD;CAEF;CAEA,OAAO,EACN,MAAM,IAAO,MAAoC;EAChD,MAAM,QAAQ;EACd,IAAI;GACH,OAAO,MAAM,UAAU,IAAI;EAC5B,UAAU;GACT,QAAQ;EACT;CACD,EACD;AACD"}
@@ -0,0 +1,70 @@
1
+ //#region src/sync/collection.ts
2
+ const METRIC_FIELDS = [
3
+ "pageviews",
4
+ "visitors",
5
+ "sessions",
6
+ "avgDuration",
7
+ "bounceRate",
8
+ "events"
9
+ ];
10
+ /**
11
+ * The sync tier's queryable collection: one row per (source, date) of a provider's daily
12
+ * metrics. It is read-only and machine-written (writes are locked to the sync job, which
13
+ * uses overrideAccess), and hidden from the admin nav by default because it is a query
14
+ * substrate for custom reporting rather than something to browse and edit; pass
15
+ * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so
16
+ * the collection stays fully queryable through the REST/local API either way. The unique
17
+ * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns
18
+ * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as
19
+ * distinct). Metric fields are nullable so a provider that omits a metric is
20
+ * distinguishable from a real zero.
21
+ */
22
+ const syncCollection = (slug, hidden = true) => ({
23
+ slug,
24
+ admin: {
25
+ hidden,
26
+ useAsTitle: "source",
27
+ defaultColumns: [
28
+ "source",
29
+ "date",
30
+ "pageviews",
31
+ "visitors"
32
+ ]
33
+ },
34
+ access: {
35
+ read: ({ req }) => Boolean(req.user),
36
+ create: () => false,
37
+ update: () => false,
38
+ delete: () => false
39
+ },
40
+ fields: [
41
+ {
42
+ name: "source",
43
+ type: "text",
44
+ required: true,
45
+ index: true
46
+ },
47
+ {
48
+ name: "date",
49
+ type: "date",
50
+ required: true,
51
+ index: true
52
+ },
53
+ ...METRIC_FIELDS.map((name) => ({
54
+ name,
55
+ type: "number"
56
+ })),
57
+ {
58
+ name: "syncedAt",
59
+ type: "date"
60
+ }
61
+ ],
62
+ indexes: [{
63
+ fields: ["source", "date"],
64
+ unique: true
65
+ }]
66
+ });
67
+ //#endregion
68
+ export { METRIC_FIELDS, syncCollection };
69
+
70
+ //# sourceMappingURL=collection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/sync/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const SYNC_DEFAULT_SLUG = 'analytics-daily'\n\nexport const METRIC_FIELDS = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n] as const\n\nexport type SyncMetric = (typeof METRIC_FIELDS)[number]\n\n/**\n * The sync tier's queryable collection: one row per (source, date) of a provider's daily\n * metrics. It is read-only and machine-written (writes are locked to the sync job, which\n * uses overrideAccess), and hidden from the admin nav by default because it is a query\n * substrate for custom reporting rather than something to browse and edit; pass\n * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so\n * the collection stays fully queryable through the REST/local API either way. The unique\n * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns\n * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as\n * distinct). Metric fields are nullable so a provider that omits a metric is\n * distinguishable from a real zero.\n */\nexport const syncCollection = (slug: string, hidden = true): CollectionConfig => ({\n\tslug,\n\tadmin: {\n\t\thidden,\n\t\tuseAsTitle: 'source',\n\t\tdefaultColumns: ['source', 'date', 'pageviews', 'visitors'],\n\t},\n\taccess: {\n\t\tread: ({ req }) => Boolean(req.user),\n\t\tcreate: () => false,\n\t\tupdate: () => false,\n\t\tdelete: () => false,\n\t},\n\tfields: [\n\t\t{ name: 'source', type: 'text', required: true, index: true },\n\t\t{ name: 'date', type: 'date', required: true, index: true },\n\t\t...METRIC_FIELDS.map((name): Field => ({ name, type: 'number' })),\n\t\t{ name: 'syncedAt', type: 'date' },\n\t],\n\tindexes: [{ fields: ['source', 'date'], unique: true }],\n})\n"],"mappings":";AAIA,MAAa,gBAAgB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;;;;;;AAgBA,MAAa,kBAAkB,MAAc,SAAS,UAA4B;CACjF;CACA,OAAO;EACN;EACA,YAAY;EACZ,gBAAgB;GAAC;GAAU;GAAQ;GAAa;EAAU;CAC3D;CACA,QAAQ;EACP,OAAO,EAAE,UAAU,QAAQ,IAAI,IAAI;EACnC,cAAc;EACd,cAAc;EACd,cAAc;CACf;CACA,QAAQ;EACP;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D,GAAG,cAAc,KAAK,UAAiB;GAAE;GAAM,MAAM;EAAS,EAAE;EAChE;GAAE,MAAM;GAAY,MAAM;EAAO;CAClC;CACA,SAAS,CAAC;EAAE,QAAQ,CAAC,UAAU,MAAM;EAAG,QAAQ;CAAK,CAAC;AACvD"}
@@ -0,0 +1,123 @@
1
+ import { supportsGranularity } from "../core/granularity.js";
2
+ import { getRuntime, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
3
+ import { METRIC_FIELDS } from "./collection.js";
4
+ //#region src/sync/syncTask.ts
5
+ const SYNC_TASK_SLUG = "analytics-sync";
6
+ const DAY_MS = 864e5;
7
+ /**
8
+ * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes
9
+ * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).
10
+ * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.
11
+ */
12
+ const toSyncRow = (source, row, syncedAt) => {
13
+ if (!row.timestamp) return null;
14
+ const date = new Date(row.timestamp);
15
+ if (Number.isNaN(date.getTime())) return null;
16
+ const doc = {
17
+ source,
18
+ date,
19
+ syncedAt
20
+ };
21
+ for (const metric of METRIC_FIELDS) {
22
+ const value = row.metrics[metric];
23
+ if (typeof value === "number") doc[metric] = value;
24
+ }
25
+ return doc;
26
+ };
27
+ const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
28
+ const upsertDailyRow = async (req, collectionSlug, row) => {
29
+ const found = (await req.payload.find({
30
+ collection: collectionSlug,
31
+ where: { and: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }] },
32
+ limit: 1,
33
+ depth: 0,
34
+ overrideAccess: true
35
+ })).docs[0];
36
+ if (found) {
37
+ await req.payload.update({
38
+ collection: collectionSlug,
39
+ id: found.id,
40
+ data: row,
41
+ overrideAccess: true
42
+ });
43
+ return;
44
+ }
45
+ await req.payload.create({
46
+ collection: collectionSlug,
47
+ data: row,
48
+ overrideAccess: true
49
+ });
50
+ };
51
+ /**
52
+ * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of
53
+ * daily metrics into the sync collection (one upserted row per source + day), reading
54
+ * through the surfacing engine so the pull rides its queue / backoff / cache. Native is
55
+ * excluded (its data already lives in the rollups collection); each provider runs in its
56
+ * own try/catch so one failure does not abort the rest.
57
+ */
58
+ const syncTask = (opts) => ({
59
+ slug: SYNC_TASK_SLUG,
60
+ handler: async ({ req }) => {
61
+ const runtime = getRuntime(req.payload);
62
+ if (!runtime) return { output: {
63
+ synced: 0,
64
+ failed: 0
65
+ } };
66
+ const now = /* @__PURE__ */ new Date();
67
+ const dateRange = {
68
+ start: /* @__PURE__ */ new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),
69
+ end: now
70
+ };
71
+ let synced = 0;
72
+ let failed = 0;
73
+ const scope = await resolveScopeFor(runtime, req).catch(() => null);
74
+ const registry = await resolveRegistryFor(runtime, {
75
+ payload: req.payload,
76
+ req,
77
+ scope
78
+ });
79
+ for (const adapter of registry.all()) {
80
+ if (adapter.id === "native") continue;
81
+ if (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) continue;
82
+ if (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, "day")) continue;
83
+ const metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m));
84
+ if (metrics.length === 0) continue;
85
+ let result;
86
+ try {
87
+ result = await runtime.engine.read(adapter, {
88
+ metrics,
89
+ dateRange,
90
+ granularity: "day",
91
+ scope: scope ?? void 0
92
+ });
93
+ } catch (err) {
94
+ failed++;
95
+ req.payload.logger.warn(`analytics sync: adapter "${adapter.id}" read failed: ${String(err)}`);
96
+ continue;
97
+ }
98
+ for (const row of result.rows) {
99
+ const doc = toSyncRow(adapter.id, row, now);
100
+ if (!doc) continue;
101
+ try {
102
+ await upsertDailyRow(req, opts.collectionSlug, doc);
103
+ synced++;
104
+ } catch (err) {
105
+ failed++;
106
+ req.payload.logger.warn(`analytics sync: upsert for "${adapter.id}" on ${doc.date.toISOString()} failed: ${String(err)}`);
107
+ }
108
+ }
109
+ }
110
+ return { output: {
111
+ synced,
112
+ failed
113
+ } };
114
+ },
115
+ schedule: [{
116
+ cron: opts.cron,
117
+ queue: "default"
118
+ }]
119
+ });
120
+ //#endregion
121
+ export { syncTask };
122
+
123
+ //# sourceMappingURL=syncTask.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"syncTask.js","names":[],"sources":["../../src/sync/syncTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport type { AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from '../plugin/runtime'\nimport { METRIC_FIELDS, type SyncMetric } from './collection'\n\nexport const SYNC_TASK_SLUG = 'analytics-sync'\n\nconst DAY_MS = 86_400_000\n\nexport type SyncRow = { source: string; date: Date; syncedAt: Date } & Partial<\n\tRecord<SyncMetric, number>\n>\n\nexport interface SyncTaskOptions {\n\tcron: string\n\tlookbackDays: number\n\tcollectionSlug: string\n\tadapterIds?: string[]\n}\n\n/**\n * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes\n * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).\n * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.\n */\nexport const toSyncRow = (source: string, row: AnalyticsRow, syncedAt: Date): SyncRow | null => {\n\tif (!row.timestamp) {\n\t\treturn null\n\t}\n\tconst date = new Date(row.timestamp)\n\tif (Number.isNaN(date.getTime())) {\n\t\treturn null\n\t}\n\tconst doc: SyncRow = { source, date, syncedAt }\n\tfor (const metric of METRIC_FIELDS) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number') {\n\t\t\tdoc[metric] = value\n\t\t}\n\t}\n\treturn doc\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst upsertDailyRow = async (\n\treq: PayloadRequest,\n\tcollectionSlug: string,\n\trow: SyncRow\n): Promise<void> => {\n\tconst existing = await req.payload.find({\n\t\tcollection: collectionSlug as never,\n\t\twhere: {\n\t\t\tand: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }],\n\t\t},\n\t\tlimit: 1,\n\t\tdepth: 0,\n\t\toverrideAccess: true,\n\t})\n\tconst found = existing.docs[0] as { id: string | number } | undefined\n\tif (found) {\n\t\tawait req.payload.update({\n\t\t\tcollection: collectionSlug as never,\n\t\t\tid: found.id,\n\t\t\tdata: row as never,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn\n\t}\n\tawait req.payload.create({\n\t\tcollection: collectionSlug as never,\n\t\tdata: row as never,\n\t\toverrideAccess: true,\n\t})\n}\n\n/**\n * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of\n * daily metrics into the sync collection (one upserted row per source + day), reading\n * through the surfacing engine so the pull rides its queue / backoff / cache. Native is\n * excluded (its data already lives in the rollups collection); each provider runs in its\n * own try/catch so one failure does not abort the rest.\n */\nexport const syncTask = (\n\topts: SyncTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: { synced: number; failed: number } }> => ({\n\tslug: SYNC_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn { output: { synced: 0, failed: 0 } }\n\t\t}\n\t\tconst now = new Date()\n\t\tconst dateRange = {\n\t\t\tstart: new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),\n\t\t\tend: now,\n\t\t}\n\t\tlet synced = 0\n\t\tlet failed = 0\n\t\t// A job req may lack the request shape an app's scopeResolver expects;\n\t\t// degrade to the install scope rather than failing the whole run.\n\t\tconst scope = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tfor (const adapter of registry.all()) {\n\t\t\tif (adapter.id === 'native') {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, 'day')) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m))\n\t\t\tif (metrics.length === 0) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet result: AnalyticsResult\n\t\t\ttry {\n\t\t\t\tresult = await runtime.engine.read(adapter, {\n\t\t\t\t\tmetrics,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t\tscope: scope ?? undefined,\n\t\t\t\t})\n\t\t\t} catch (err) {\n\t\t\t\tfailed++\n\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t`analytics sync: adapter \"${adapter.id}\" read failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tfor (const row of result.rows) {\n\t\t\t\tconst doc = toSyncRow(adapter.id, row, now)\n\t\t\t\tif (!doc) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait upsertDailyRow(req, opts.collectionSlug, doc)\n\t\t\t\t\tsynced++\n\t\t\t\t} catch (err) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics sync: upsert for \"${adapter.id}\" on ${doc.date.toISOString()} failed: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { synced, failed } }\n\t},\n\tschedule: [{ cron: opts.cron, queue: 'default' }],\n})\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { n as AnalyticsAdapter } from "../contract-CWZPKWuR.js";
1
+ import { AnalyticsAdapter } from "../core/contract.js";
2
2
 
3
3
  //#region src/testing/memoryAdapter.d.ts
4
4
  interface MemoryEvent {
@@ -0,0 +1,6 @@
1
+ //#region src/timeframe/presets.d.ts
2
+ declare const TIMEFRAME_PRESETS: readonly ["today", "last7days", "last30days", "last90days", "thisMonth", "thisYear", "lastYear", "allTime"];
3
+ type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number];
4
+ //#endregion
5
+ export { TimeframePreset };
6
+ //# sourceMappingURL=presets.d.ts.map
@@ -0,0 +1,59 @@
1
+ import { addDaysInTz, startOfDayInTz, startOfMonthInTz, startOfYearInTz } from "./tz.js";
2
+ //#region src/timeframe/presets.ts
3
+ const TIMEFRAME_PRESETS = [
4
+ "today",
5
+ "last7days",
6
+ "last30days",
7
+ "last90days",
8
+ "thisMonth",
9
+ "thisYear",
10
+ "lastYear",
11
+ "allTime"
12
+ ];
13
+ /**
14
+ * Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected
15
+ * so callers stay deterministic. `end` is `now`; `start` is the day floor of the
16
+ * window in `tz` (defaulting to UTC, so day boundaries align with the reporting
17
+ * timezone). Inclusive day windows count the current day (`last7days` = today plus 6).
18
+ */
19
+ const resolveTimeframe = (preset, now, tz = "UTC") => {
20
+ const end = new Date(now);
21
+ switch (preset) {
22
+ case "today": return {
23
+ start: startOfDayInTz(now, tz),
24
+ end
25
+ };
26
+ case "last7days": return {
27
+ start: addDaysInTz(now, -6, tz),
28
+ end
29
+ };
30
+ case "last30days": return {
31
+ start: addDaysInTz(now, -29, tz),
32
+ end
33
+ };
34
+ case "last90days": return {
35
+ start: addDaysInTz(now, -89, tz),
36
+ end
37
+ };
38
+ case "thisMonth": return {
39
+ start: startOfMonthInTz(now, tz),
40
+ end
41
+ };
42
+ case "thisYear": return {
43
+ start: startOfYearInTz(now, tz),
44
+ end
45
+ };
46
+ case "lastYear": return {
47
+ start: addDaysInTz(now, -364, tz),
48
+ end
49
+ };
50
+ case "allTime": return {
51
+ start: /* @__PURE__ */ new Date(0),
52
+ end
53
+ };
54
+ }
55
+ };
56
+ //#endregion
57
+ export { TIMEFRAME_PRESETS, resolveTimeframe };
58
+
59
+ //# sourceMappingURL=presets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"presets.js","names":[],"sources":["../../src/timeframe/presets.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport {\n\taddDaysInTz,\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfYearInTz,\n} from './tz'\n\nexport const TIMEFRAME_PRESETS = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'thisMonth',\n\t'thisYear',\n\t'lastYear',\n\t'allTime',\n] as const\n\nexport type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number]\n\n/**\n * Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected\n * so callers stay deterministic. `end` is `now`; `start` is the day floor of the\n * window in `tz` (defaulting to UTC, so day boundaries align with the reporting\n * timezone). Inclusive day windows count the current day (`last7days` = today plus 6).\n */\nexport const resolveTimeframe = (\n\tpreset: TimeframePreset,\n\tnow: Date,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange => {\n\tconst end = new Date(now)\n\tswitch (preset) {\n\t\tcase 'today':\n\t\t\treturn { start: startOfDayInTz(now, tz), end }\n\t\tcase 'last7days':\n\t\t\treturn { start: addDaysInTz(now, -6, tz), end }\n\t\tcase 'last30days':\n\t\t\treturn { start: addDaysInTz(now, -29, tz), end }\n\t\tcase 'last90days':\n\t\t\treturn { start: addDaysInTz(now, -89, tz), end }\n\t\tcase 'thisMonth':\n\t\t\treturn { start: startOfMonthInTz(now, tz), end }\n\t\tcase 'thisYear':\n\t\t\treturn { start: startOfYearInTz(now, tz), end }\n\t\tcase 'lastYear':\n\t\t\treturn { start: addDaysInTz(now, -364, tz), end }\n\t\tcase 'allTime':\n\t\t\treturn { start: new Date(0), end }\n\t}\n}\n"],"mappings":";;AASA,MAAa,oBAAoB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;AAUA,MAAa,oBACZ,QACA,KACA,KAAA,UACe;CACf,MAAM,MAAM,IAAI,KAAK,GAAG;CACxB,QAAQ,QAAR;EACC,KAAK,SACJ,OAAO;GAAE,OAAO,eAAe,KAAK,EAAE;GAAG;EAAI;EAC9C,KAAK,aACJ,OAAO;GAAE,OAAO,YAAY,KAAK,IAAI,EAAE;GAAG;EAAI;EAC/C,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,aACJ,OAAO;GAAE,OAAO,iBAAiB,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,YACJ,OAAO;GAAE,OAAO,gBAAgB,KAAK,EAAE;GAAG;EAAI;EAC/C,KAAK,YACJ,OAAO;GAAE,OAAO,YAAY,KAAK,MAAM,EAAE;GAAG;EAAI;EACjD,KAAK,WACJ,OAAO;GAAE,uBAAO,IAAI,KAAK,CAAC;GAAG;EAAI;CACnC;AACD"}
@@ -0,0 +1,110 @@
1
+ const formatterCache = /* @__PURE__ */ new Map();
2
+ const partsFormatter = (tz) => {
3
+ let formatter = formatterCache.get(tz);
4
+ if (!formatter) {
5
+ formatter = new Intl.DateTimeFormat("en-US", {
6
+ timeZone: tz,
7
+ hourCycle: "h23",
8
+ year: "numeric",
9
+ month: "2-digit",
10
+ day: "2-digit",
11
+ hour: "2-digit",
12
+ minute: "2-digit",
13
+ second: "2-digit"
14
+ });
15
+ formatterCache.set(tz, formatter);
16
+ }
17
+ return formatter;
18
+ };
19
+ /** Wall-clock parts `date` maps to in `tz`. */
20
+ const zonedParts = (date, tz) => {
21
+ const map = {};
22
+ for (const part of partsFormatter(tz).formatToParts(date)) if (part.type !== "literal") map[part.type] = part.value;
23
+ return {
24
+ year: Number(map.year),
25
+ month: Number(map.month),
26
+ day: Number(map.day),
27
+ hour: Number(map.hour),
28
+ minute: Number(map.minute),
29
+ second: Number(map.second)
30
+ };
31
+ };
32
+ /** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */
33
+ const offsetMs = (date, tz) => {
34
+ const p = zonedParts(date, tz);
35
+ return Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second) - Math.floor(date.getTime() / 1e3) * 1e3;
36
+ };
37
+ const sameLocalDay = (date, ymd, tz) => {
38
+ const p = zonedParts(date, tz);
39
+ return p.year === ymd.year && p.month === ymd.month && p.day === ymd.day;
40
+ };
41
+ /**
42
+ * The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a
43
+ * spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock
44
+ * does not exist and the refinement below oscillates between the pre- and post-transition
45
+ * offsets, so the candidate that still falls on `ymd` (the transition instant, local
46
+ * 01:00) is taken instead of the refined one that fell back onto the previous day.
47
+ */
48
+ const zonedMidnight = (ymd, tz) => {
49
+ const asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day);
50
+ const guess = new Date(asUtc - offsetMs(new Date(asUtc), tz));
51
+ const refined = new Date(asUtc - offsetMs(guess, tz));
52
+ if (sameLocalDay(refined, ymd, tz)) return refined;
53
+ if (sameLocalDay(guess, ymd, tz)) return guess;
54
+ return zonedMidnight(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
55
+ };
56
+ /** Start of `date`'s local day in `tz`. */
57
+ const startOfDayInTz = (date, tz = "UTC") => {
58
+ return zonedMidnight(zonedParts(date, tz), tz);
59
+ };
60
+ /** Start of `date`'s local month in `tz`. */
61
+ const startOfMonthInTz = (date, tz = "UTC") => {
62
+ const p = zonedParts(date, tz);
63
+ return zonedMidnight({
64
+ year: p.year,
65
+ month: p.month,
66
+ day: 1
67
+ }, tz);
68
+ };
69
+ /** Start of `date`'s local year in `tz`. */
70
+ const startOfYearInTz = (date, tz = "UTC") => {
71
+ return zonedMidnight({
72
+ year: zonedParts(date, tz).year,
73
+ month: 1,
74
+ day: 1
75
+ }, tz);
76
+ };
77
+ /**
78
+ * Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day
79
+ * start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping
80
+ * never lands short of, or past, the intended calendar day.
81
+ */
82
+ const addDaysInTz = (date, days, tz = "UTC") => {
83
+ const start = startOfDayInTz(date, tz);
84
+ return startOfDayInTz(new Date(start.getTime() + days * 864e5 + 432e5), tz);
85
+ };
86
+ /**
87
+ * Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a
88
+ * calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the
89
+ * step back to Monday runs through `addDaysInTz` to stay DST-safe.
90
+ */
91
+ const startOfWeekInTz = (date, tz = "UTC") => {
92
+ const p = zonedParts(date, tz);
93
+ const mondayIndex = (new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay() + 6) % 7;
94
+ return addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz);
95
+ };
96
+ /** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */
97
+ const zonedDayIso = (date, tz = "UTC") => startOfDayInTz(date, tz).toISOString();
98
+ /** True when `tz` is a resolvable IANA identifier. */
99
+ const isValidTimeZone = (tz) => {
100
+ try {
101
+ new Intl.DateTimeFormat("en-US", { timeZone: tz });
102
+ return true;
103
+ } catch {
104
+ return false;
105
+ }
106
+ };
107
+ //#endregion
108
+ export { addDaysInTz, isValidTimeZone, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedDayIso };
109
+
110
+ //# sourceMappingURL=tz.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tz.js","names":[],"sources":["../../src/timeframe/tz.ts"],"sourcesContent":["/**\n * IANA-timezone day math, built on `Intl.DateTimeFormat` so there is no dependency.\n * All reporting boundaries (timeframe windows, series axes, native rollup buckets,\n * cache-key day snaps) resolve through these helpers. `startOfDayInTz(d, 'UTC')` is\n * exactly the previous `Date.UTC(...)` day floor, so the default path is unchanged.\n */\n\nexport const DEFAULT_TIMEZONE = 'UTC'\n\ninterface ZonedParts {\n\tyear: number\n\tmonth: number\n\tday: number\n\thour: number\n\tminute: number\n\tsecond: number\n}\n\n// Constructing Intl.DateTimeFormat dominates the cost of these helpers (~14x), and they\n// run per event at ingest and in series loops, so formatters are cached per zone.\nconst formatterCache = new Map<string, Intl.DateTimeFormat>()\n\nconst partsFormatter = (tz: string): Intl.DateTimeFormat => {\n\tlet formatter = formatterCache.get(tz)\n\tif (!formatter) {\n\t\tformatter = new Intl.DateTimeFormat('en-US', {\n\t\t\ttimeZone: tz,\n\t\t\thourCycle: 'h23',\n\t\t\tyear: 'numeric',\n\t\t\tmonth: '2-digit',\n\t\t\tday: '2-digit',\n\t\t\thour: '2-digit',\n\t\t\tminute: '2-digit',\n\t\t\tsecond: '2-digit',\n\t\t})\n\t\tformatterCache.set(tz, formatter)\n\t}\n\treturn formatter\n}\n\n/** Wall-clock parts `date` maps to in `tz`. */\nconst zonedParts = (date: Date, tz: string): ZonedParts => {\n\tconst map: Record<string, string> = {}\n\tfor (const part of partsFormatter(tz).formatToParts(date)) {\n\t\tif (part.type !== 'literal') {\n\t\t\tmap[part.type] = part.value\n\t\t}\n\t}\n\treturn {\n\t\tyear: Number(map.year),\n\t\tmonth: Number(map.month),\n\t\tday: Number(map.day),\n\t\thour: Number(map.hour),\n\t\tminute: Number(map.minute),\n\t\tsecond: Number(map.second),\n\t}\n}\n\n/** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */\nconst offsetMs = (date: Date, tz: string): number => {\n\tconst p = zonedParts(date, tz)\n\tconst asUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second)\n\t// formatToParts drops sub-second precision, so compare against the truncated instant.\n\treturn asUtc - Math.floor(date.getTime() / 1000) * 1000\n}\n\nconst sameLocalDay = (\n\tdate: Date,\n\tymd: { year: number; month: number; day: number },\n\ttz: string\n): boolean => {\n\tconst p = zonedParts(date, tz)\n\treturn p.year === ymd.year && p.month === ymd.month && p.day === ymd.day\n}\n\n/**\n * The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a\n * spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock\n * does not exist and the refinement below oscillates between the pre- and post-transition\n * offsets, so the candidate that still falls on `ymd` (the transition instant, local\n * 01:00) is taken instead of the refined one that fell back onto the previous day.\n */\nconst zonedMidnight = (ymd: { year: number; month: number; day: number }, tz: string): Date => {\n\tconst asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day)\n\tconst guess = new Date(asUtc - offsetMs(new Date(asUtc), tz))\n\tconst refined = new Date(asUtc - offsetMs(guess, tz))\n\tif (sameLocalDay(refined, ymd, tz)) {\n\t\treturn refined\n\t}\n\tif (sameLocalDay(guess, ymd, tz)) {\n\t\treturn guess\n\t}\n\t// Neither candidate lands on ymd (the calendar date was skipped entirely, e.g. a\n\t// dateline change): fall forward to the later candidate's day start.\n\tconst later = refined.getTime() > guess.getTime() ? refined : guess\n\treturn zonedMidnight(zonedParts(later, tz), tz)\n}\n\n/** Start of `date`'s local day in `tz`. */\nexport const startOfDayInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight(p, tz)\n}\n\n/** Start of `date`'s local month in `tz`. */\nexport const startOfMonthInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight({ year: p.year, month: p.month, day: 1 }, tz)\n}\n\n/** Start of `date`'s local year in `tz`. */\nexport const startOfYearInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight({ year: p.year, month: 1, day: 1 }, tz)\n}\n\n/**\n * Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day\n * start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping\n * never lands short of, or past, the intended calendar day.\n */\nexport const addDaysInTz = (date: Date, days: number, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst start = startOfDayInTz(date, tz)\n\treturn startOfDayInTz(new Date(start.getTime() + days * 86_400_000 + 43_200_000), tz)\n}\n\n/**\n * Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a\n * calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the\n * step back to Monday runs through `addDaysInTz` to stay DST-safe.\n */\nexport const startOfWeekInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\tconst dow = new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay()\n\tconst mondayIndex = (dow + 6) % 7\n\treturn addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz)\n}\n\n/** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */\nexport const zonedDayIso = (date: Date, tz: string = DEFAULT_TIMEZONE): string =>\n\tstartOfDayInTz(date, tz).toISOString()\n\n/** True when `tz` is a resolvable IANA identifier. */\nexport const isValidTimeZone = (tz: string): boolean => {\n\ttry {\n\t\tnew Intl.DateTimeFormat('en-US', { timeZone: tz })\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ import { keys } from "./keys.js";
2
+ //#region src/translations/de.ts
3
+ /** German values, keyed by the same typed constants as `en.ts`. */
4
+ const de = {
5
+ [keys.pluginName]: "Analytics",
6
+ [keys.tabAnalytics]: "Analytics",
7
+ [keys.metricPageviews]: "Seitenaufrufe",
8
+ [keys.metricVisitors]: "Besucher",
9
+ [keys.metricSessions]: "Sitzungen",
10
+ [keys.metricEvents]: "Ereignisse",
11
+ [keys.metricAvgDuration]: "Ø Verweildauer",
12
+ [keys.metricBounceRate]: "Absprungrate",
13
+ [keys.metricScrollDepth]: "Scrolltiefe",
14
+ [keys.metricConversions]: "Conversions",
15
+ [keys.metricRevenue]: "Umsatz",
16
+ [keys.stateNoData]: "Noch keine Analysedaten",
17
+ [keys.stateNew]: "Neu",
18
+ [keys.stateNotBound]: "Analytics für diese Kollektion nicht konfiguriert",
19
+ [keys.stateNotConfigured]: "Analytics-Anbieter verbinden",
20
+ [keys.stateUnavailable]: "Für diese Datenquelle nicht verfügbar",
21
+ [keys.timeframeToday]: "Heute",
22
+ [keys.timeframeLast7Days]: "Letzte 7 Tage",
23
+ [keys.timeframeLast30Days]: "Letzte 30 Tage",
24
+ [keys.timeframeLast90Days]: "Letzte 90 Tage",
25
+ [keys.timeframeThisMonth]: "Aktueller Monat",
26
+ [keys.timeframeThisYear]: "Aktuelles Jahr",
27
+ [keys.timeframeLastYear]: "Letztes Jahr",
28
+ [keys.timeframeAllTime]: "Gesamter Zeitraum",
29
+ [keys.widgetMetricLabel]: "Kennzahl",
30
+ [keys.widgetTrendLabel]: "Verlauf",
31
+ [keys.widgetBreakdownPages]: "Top-Seiten",
32
+ [keys.widgetBreakdownSources]: "Top-Quellen",
33
+ [keys.widgetBreakdownDevices]: "Geräte",
34
+ [keys.widgetBreakdownCountries]: "Länder",
35
+ [keys.widgetFieldLimit]: "Zeilen",
36
+ [keys.stateNoBreakdown]: "Noch keine Daten",
37
+ [keys.stateClamped]: "Zeigt den maximalen Zeitraum des Anbieters",
38
+ [keys.widgetFieldTitle]: "Titel",
39
+ [keys.widgetFieldMetric]: "Kennzahl",
40
+ [keys.widgetFieldTimeframe]: "Zeitraum",
41
+ [keys.widgetFieldDataSource]: "Datenquelle",
42
+ [keys.widgetFieldTitlePlaceholder]: "z. B. Tägliche Seitenaufrufe",
43
+ [keys.widgetTimeframeCustom]: "Benutzerdefinierter Zeitraum",
44
+ [keys.widgetFieldRange]: "Datumsbereich",
45
+ [keys.dateRangePlaceholder]: "Datumsbereich auswählen...",
46
+ [keys.widgetFieldWindow]: "Fenster",
47
+ [keys.widgetRealtimeLabel]: "Gerade aktiv",
48
+ [keys.widgetRealtimeCaption]: "gerade aktiv",
49
+ [keys.widgetRealtimePaused]: "Live-Updates pausiert",
50
+ [keys.comparisonVsPrevious]: "vs. vorheriger Zeitraum",
51
+ [keys.comparisonIncrease]: "Gestiegen",
52
+ [keys.comparisonDecrease]: "Gesunken",
53
+ [keys.comparisonNoChange]: "Keine Änderung",
54
+ [keys.providersCollectionSingular]: "Analytics-Anbieter",
55
+ [keys.providersCollectionPlural]: "Analytics-Anbieter",
56
+ [keys.providerFieldProvider]: "Anbieter",
57
+ [keys.providerFieldEnabled]: "Aktiviert",
58
+ [keys.providerFieldScope]: "Bereich",
59
+ [keys.providerFieldSiteId]: "Website-ID",
60
+ [keys.providerFieldApiKey]: "API-Schlüssel",
61
+ [keys.providerFieldHost]: "Host",
62
+ [keys.providerFieldHostHelp]: "Leer lassen für Standard-Cloud des Anbieters",
63
+ [keys.providerFieldWebsiteId]: "Website-ID",
64
+ [keys.providerFieldToken]: "API-Token",
65
+ [keys.providerFieldPropertyId]: "Property-ID",
66
+ [keys.providerFieldClientEmail]: "Client-E-Mail",
67
+ [keys.providerFieldPrivateKey]: "Privater Schlüssel",
68
+ [keys.providerFieldProjectId]: "Projekt-ID",
69
+ [keys.providerSecretHelp]: "Nach dem Speichern maskiert angezeigt; neuen Wert eingeben zum Ersetzen",
70
+ [keys.providerNamePlausible]: "Plausible",
71
+ [keys.providerNameUmami]: "Umami",
72
+ [keys.providerNameGa4]: "Google Analytics 4",
73
+ [keys.providerNamePosthog]: "PostHog"
74
+ };
75
+ //#endregion
76
+ export { de };
77
+
78
+ //# sourceMappingURL=de.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"de.js","names":[],"sources":["../../src/translations/de.ts"],"sourcesContent":["import { keys, type TranslationKey } from './keys'\n\n/** German values, keyed by the same typed constants as `en.ts`. */\nexport const de: Record<TranslationKey, string> = {\n\t[keys.pluginName]: 'Analytics',\n\t[keys.tabAnalytics]: 'Analytics',\n\t[keys.metricPageviews]: 'Seitenaufrufe',\n\t[keys.metricVisitors]: 'Besucher',\n\t[keys.metricSessions]: 'Sitzungen',\n\t[keys.metricEvents]: 'Ereignisse',\n\t[keys.metricAvgDuration]: 'Ø Verweildauer',\n\t[keys.metricBounceRate]: 'Absprungrate',\n\t[keys.metricScrollDepth]: 'Scrolltiefe',\n\t[keys.metricConversions]: 'Conversions',\n\t[keys.metricRevenue]: 'Umsatz',\n\t[keys.stateNoData]: 'Noch keine Analysedaten',\n\t[keys.stateNew]: 'Neu',\n\t[keys.stateNotBound]: 'Analytics für diese Kollektion nicht konfiguriert',\n\t[keys.stateNotConfigured]: 'Analytics-Anbieter verbinden',\n\t[keys.stateUnavailable]: 'Für diese Datenquelle nicht verfügbar',\n\t[keys.timeframeToday]: 'Heute',\n\t[keys.timeframeLast7Days]: 'Letzte 7 Tage',\n\t[keys.timeframeLast30Days]: 'Letzte 30 Tage',\n\t[keys.timeframeLast90Days]: 'Letzte 90 Tage',\n\t[keys.timeframeThisMonth]: 'Aktueller Monat',\n\t[keys.timeframeThisYear]: 'Aktuelles Jahr',\n\t[keys.timeframeLastYear]: 'Letztes Jahr',\n\t[keys.timeframeAllTime]: 'Gesamter Zeitraum',\n\t[keys.widgetMetricLabel]: 'Kennzahl',\n\t[keys.widgetTrendLabel]: 'Verlauf',\n\t[keys.widgetBreakdownPages]: 'Top-Seiten',\n\t[keys.widgetBreakdownSources]: 'Top-Quellen',\n\t[keys.widgetBreakdownDevices]: 'Geräte',\n\t[keys.widgetBreakdownCountries]: 'Länder',\n\t[keys.widgetFieldLimit]: 'Zeilen',\n\t[keys.stateNoBreakdown]: 'Noch keine Daten',\n\t[keys.stateClamped]: 'Zeigt den maximalen Zeitraum des Anbieters',\n\t[keys.widgetFieldTitle]: 'Titel',\n\t[keys.widgetFieldMetric]: 'Kennzahl',\n\t[keys.widgetFieldTimeframe]: 'Zeitraum',\n\t[keys.widgetFieldDataSource]: 'Datenquelle',\n\t[keys.widgetFieldTitlePlaceholder]: 'z. B. Tägliche Seitenaufrufe',\n\t[keys.widgetTimeframeCustom]: 'Benutzerdefinierter Zeitraum',\n\t[keys.widgetFieldRange]: 'Datumsbereich',\n\t[keys.dateRangePlaceholder]: 'Datumsbereich auswählen...',\n\t[keys.widgetFieldWindow]: 'Fenster',\n\t[keys.widgetRealtimeLabel]: 'Gerade aktiv',\n\t[keys.widgetRealtimeCaption]: 'gerade aktiv',\n\t[keys.widgetRealtimePaused]: 'Live-Updates pausiert',\n\t[keys.comparisonVsPrevious]: 'vs. vorheriger Zeitraum',\n\t[keys.comparisonIncrease]: 'Gestiegen',\n\t[keys.comparisonDecrease]: 'Gesunken',\n\t[keys.comparisonNoChange]: 'Keine Änderung',\n\t[keys.providersCollectionSingular]: 'Analytics-Anbieter',\n\t[keys.providersCollectionPlural]: 'Analytics-Anbieter',\n\t[keys.providerFieldProvider]: 'Anbieter',\n\t[keys.providerFieldEnabled]: 'Aktiviert',\n\t[keys.providerFieldScope]: 'Bereich',\n\t[keys.providerFieldSiteId]: 'Website-ID',\n\t[keys.providerFieldApiKey]: 'API-Schlüssel',\n\t[keys.providerFieldHost]: 'Host',\n\t[keys.providerFieldHostHelp]: 'Leer lassen für Standard-Cloud des Anbieters',\n\t[keys.providerFieldWebsiteId]: 'Website-ID',\n\t[keys.providerFieldToken]: 'API-Token',\n\t[keys.providerFieldPropertyId]: 'Property-ID',\n\t[keys.providerFieldClientEmail]: 'Client-E-Mail',\n\t[keys.providerFieldPrivateKey]: 'Privater Schlüssel',\n\t[keys.providerFieldProjectId]: 'Projekt-ID',\n\t[keys.providerSecretHelp]:\n\t\t'Nach dem Speichern maskiert angezeigt; neuen Wert eingeben zum Ersetzen',\n\t[keys.providerNamePlausible]: 'Plausible',\n\t[keys.providerNameUmami]: 'Umami',\n\t[keys.providerNameGa4]: 'Google Analytics 4',\n\t[keys.providerNamePosthog]: 'PostHog',\n}\n"],"mappings":";;;AAGA,MAAa,KAAqC;EAChD,KAAK,aAAa;EAClB,KAAK,eAAe;EACpB,KAAK,kBAAkB;EACvB,KAAK,iBAAiB;EACtB,KAAK,iBAAiB;EACtB,KAAK,eAAe;EACpB,KAAK,oBAAoB;EACzB,KAAK,mBAAmB;EACxB,KAAK,oBAAoB;EACzB,KAAK,oBAAoB;EACzB,KAAK,gBAAgB;EACrB,KAAK,cAAc;EACnB,KAAK,WAAW;EAChB,KAAK,gBAAgB;EACrB,KAAK,qBAAqB;EAC1B,KAAK,mBAAmB;EACxB,KAAK,iBAAiB;EACtB,KAAK,qBAAqB;EAC1B,KAAK,sBAAsB;EAC3B,KAAK,sBAAsB;EAC3B,KAAK,qBAAqB;EAC1B,KAAK,oBAAoB;EACzB,KAAK,oBAAoB;EACzB,KAAK,mBAAmB;EACxB,KAAK,oBAAoB;EACzB,KAAK,mBAAmB;EACxB,KAAK,uBAAuB;EAC5B,KAAK,yBAAyB;EAC9B,KAAK,yBAAyB;EAC9B,KAAK,2BAA2B;EAChC,KAAK,mBAAmB;EACxB,KAAK,mBAAmB;EACxB,KAAK,eAAe;EACpB,KAAK,mBAAmB;EACxB,KAAK,oBAAoB;EACzB,KAAK,uBAAuB;EAC5B,KAAK,wBAAwB;EAC7B,KAAK,8BAA8B;EACnC,KAAK,wBAAwB;EAC7B,KAAK,mBAAmB;EACxB,KAAK,uBAAuB;EAC5B,KAAK,oBAAoB;EACzB,KAAK,sBAAsB;EAC3B,KAAK,wBAAwB;EAC7B,KAAK,uBAAuB;EAC5B,KAAK,uBAAuB;EAC5B,KAAK,qBAAqB;EAC1B,KAAK,qBAAqB;EAC1B,KAAK,qBAAqB;EAC1B,KAAK,8BAA8B;EACnC,KAAK,4BAA4B;EACjC,KAAK,wBAAwB;EAC7B,KAAK,uBAAuB;EAC5B,KAAK,qBAAqB;EAC1B,KAAK,sBAAsB;EAC3B,KAAK,sBAAsB;EAC3B,KAAK,oBAAoB;EACzB,KAAK,wBAAwB;EAC7B,KAAK,yBAAyB;EAC9B,KAAK,qBAAqB;EAC1B,KAAK,0BAA0B;EAC/B,KAAK,2BAA2B;EAChC,KAAK,0BAA0B;EAC/B,KAAK,yBAAyB;EAC9B,KAAK,qBACL;EACA,KAAK,wBAAwB;EAC7B,KAAK,oBAAoB;EACzB,KAAK,kBAAkB;EACvB,KAAK,sBAAsB;AAC7B"}