@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.
- package/CHANGELOG.md +71 -0
- package/README.md +37 -357
- package/dist/adapters/ga4/ga4.d.ts +20 -0
- package/dist/adapters/ga4/ga4.js +177 -0
- package/dist/{fetchJson-DZb2_Puj.js → adapters/http/fetchJson.js} +2 -2
- package/dist/adapters/http/fetchJson.js.map +1 -0
- package/dist/adapters/plausible/plausible.d.ts +15 -0
- package/dist/adapters/plausible/plausible.js +143 -0
- package/dist/adapters/posthog/posthog.d.ts +23 -0
- package/dist/adapters/posthog/posthog.js +121 -0
- package/dist/adapters/posthog/posthog.js.map +1 -0
- package/dist/{series-zytbzPoc.js → adapters/series.js} +2 -2
- package/dist/adapters/series.js.map +1 -0
- package/dist/adapters/umami/umami.d.ts +18 -0
- package/dist/adapters/umami/umami.js +139 -0
- package/dist/binding/resolvePath.js +61 -0
- package/dist/binding/resolvePath.js.map +1 -0
- package/dist/binding/types.d.ts +53 -0
- package/dist/charts/BarList.d.ts +20 -0
- package/dist/charts/BarList.js +73 -0
- package/dist/charts/BarList.js.map +1 -0
- package/dist/charts/TrendChart.d.ts +25 -0
- package/dist/charts/TrendChart.js +186 -0
- package/dist/charts/TrendChart.js.map +1 -0
- package/dist/charts/bars.d.ts +9 -0
- package/dist/charts/bars.js +19 -0
- package/dist/charts/bars.js.map +1 -0
- package/dist/charts/bucket.js +79 -0
- package/dist/charts/bucket.js.map +1 -0
- package/dist/charts/spline.js +84 -0
- package/dist/charts/spline.js.map +1 -0
- package/dist/charts/styles.js +42 -0
- package/dist/charts/styles.js.map +1 -0
- package/dist/core/cacheKey.js +31 -0
- package/dist/core/cacheKey.js.map +1 -0
- package/dist/core/capabilities.d.ts +12 -0
- package/dist/core/capabilities.js +12 -0
- package/dist/core/capabilities.js.map +1 -0
- package/dist/{contract-CWZPKWuR.d.ts → core/contract.d.ts} +30 -4
- package/dist/core/contract.js +10 -0
- package/dist/core/contract.js.map +1 -0
- package/dist/core/granularity.js +17 -0
- package/dist/core/granularity.js.map +1 -0
- package/dist/core/options.d.ts +115 -0
- package/dist/core/options.js +107 -0
- package/dist/core/options.js.map +1 -0
- package/dist/core/registry.js +24 -0
- package/dist/core/registry.js.map +1 -0
- package/dist/core/scopedRead.js +57 -0
- package/dist/core/scopedRead.js.map +1 -0
- package/dist/exports/adapters/ga4.d.ts +2 -20
- package/dist/exports/adapters/ga4.js +1 -176
- package/dist/exports/adapters/native.d.ts +2 -22
- package/dist/exports/adapters/native.js +1 -848
- package/dist/exports/adapters/plausible.d.ts +2 -15
- package/dist/exports/adapters/plausible.js +1 -142
- package/dist/exports/adapters/posthog.d.ts +2 -17
- package/dist/exports/adapters/posthog.js +1 -118
- package/dist/exports/adapters/umami.d.ts +2 -18
- package/dist/exports/adapters/umami.js +1 -138
- package/dist/exports/client.d.ts +5 -77
- package/dist/exports/client.js +4 -386
- package/dist/exports/geo.d.ts +4 -19
- package/dist/exports/geo.js +3 -1
- package/dist/exports/i18n.d.ts +3 -63
- package/dist/exports/i18n.js +2 -2
- package/dist/exports/next.d.ts +2 -0
- package/dist/exports/next.js +2 -0
- package/dist/exports/rsc.d.ts +13 -120
- package/dist/exports/rsc.js +10 -597
- package/dist/exports/types.d.ts +6 -4
- package/dist/exports/types.js +2 -1
- package/dist/fields/AnalyticsStatField.d.ts +31 -0
- package/dist/fields/AnalyticsStatField.js +93 -0
- package/dist/fields/AnalyticsStatField.js.map +1 -0
- package/dist/fields/dateRange/field.js +55 -0
- package/dist/fields/dateRange/field.js.map +1 -0
- package/dist/fields/dateRange/styles.js +23 -0
- package/dist/fields/dateRange/styles.js.map +1 -0
- package/dist/fields/dateRange/types.d.ts +11 -0
- package/dist/fields/dateRange/ui.d.ts +9 -0
- package/dist/fields/dateRange/ui.js +373 -0
- package/dist/fields/dateRange/ui.js.map +1 -0
- package/dist/fields/factories.d.ts +52 -0
- package/dist/fields/factories.js +65 -0
- package/dist/fields/factories.js.map +1 -0
- package/dist/fields/format.d.ts +7 -0
- package/dist/fields/format.js +22 -0
- package/dist/fields/format.js.map +1 -0
- package/dist/fields/readForDocument.js +107 -0
- package/dist/fields/readForDocument.js.map +1 -0
- package/dist/index.d.ts +18 -3
- package/dist/index.js +55 -1025
- package/dist/index.js.map +1 -1
- package/dist/native/collections/events.js +101 -0
- package/dist/native/collections/events.js.map +1 -0
- package/dist/native/collections/rollups.js +115 -0
- package/dist/native/collections/rollups.js.map +1 -0
- package/dist/native/collections/seen.js +47 -0
- package/dist/native/collections/seen.js.map +1 -0
- package/dist/native/geo/composeGeoResolvers.d.ts +7 -0
- package/dist/native/geo/composeGeoResolvers.js +14 -0
- package/dist/native/geo/composeGeoResolvers.js.map +1 -0
- package/dist/{geoResolver-CasIa4T9.d.ts → native/geo/geoResolver.d.ts} +2 -2
- package/dist/native/geo/geoResolver.js +11 -0
- package/dist/native/geo/geoResolver.js.map +1 -0
- package/dist/native/geo/maxmindResolver.d.ts +16 -0
- package/dist/native/geo/maxmindResolver.js +55 -0
- package/dist/native/geo/maxmindResolver.js.map +1 -0
- package/dist/native/ingest/device.js +15 -0
- package/dist/native/ingest/device.js.map +1 -0
- package/dist/native/ingest/endpoint.js +27 -0
- package/dist/native/ingest/endpoint.js.map +1 -0
- package/dist/native/ingest/flushBatch.js +69 -0
- package/dist/native/ingest/flushBatch.js.map +1 -0
- package/dist/native/ingest/normalizeEvent.js +38 -0
- package/dist/native/ingest/normalizeEvent.js.map +1 -0
- package/dist/native/ingest/salt.js +14 -0
- package/dist/native/ingest/salt.js.map +1 -0
- package/dist/native/ingest/source.js +22 -0
- package/dist/native/ingest/source.js.map +1 -0
- package/dist/native/ingest/visitorHash.js +12 -0
- package/dist/native/ingest/visitorHash.js.map +1 -0
- package/dist/native/ingest/writeBuffer.js +55 -0
- package/dist/native/ingest/writeBuffer.js.map +1 -0
- package/dist/native/ingest/writeEvent.js +13 -0
- package/dist/native/ingest/writeEvent.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +22 -0
- package/dist/native/nativeAdapter.js +213 -0
- package/dist/native/nativeAdapter.js.map +1 -0
- package/dist/native/realtime/buildRealtime.js +53 -0
- package/dist/native/realtime/buildRealtime.js.map +1 -0
- package/dist/native/retention/pruneTask.js +29 -0
- package/dist/native/retention/pruneTask.js.map +1 -0
- package/dist/native/rollupAcc.js +50 -0
- package/dist/native/rollupAcc.js.map +1 -0
- package/dist/native/rollups/applyDistinctDeltas.js +9 -0
- package/dist/native/rollups/applyDistinctDeltas.js.map +1 -0
- package/dist/native/rollups/bumpRollup.js +52 -0
- package/dist/native/rollups/bumpRollup.js.map +1 -0
- package/dist/native/rollups/deltas.js +31 -0
- package/dist/native/rollups/deltas.js.map +1 -0
- package/dist/native/rollups/insertIfNew.js +19 -0
- package/dist/native/rollups/insertIfNew.js.map +1 -0
- package/dist/next/posthogProxyRewrites.d.ts +36 -0
- package/dist/next/posthogProxyRewrites.js +50 -0
- package/dist/next/posthogProxyRewrites.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +36 -0
- package/dist/plugin/realtimeEndpoint.js.map +1 -0
- package/dist/plugin/registerTranslations.js +19 -0
- package/dist/plugin/registerTranslations.js.map +1 -0
- package/dist/plugin/runtime.js +20 -0
- package/dist/plugin/runtime.js.map +1 -0
- package/dist/plugin/warmTask.js +165 -0
- package/dist/plugin/warmTask.js.map +1 -0
- package/dist/providers/collection.js +159 -0
- package/dist/providers/collection.js.map +1 -0
- package/dist/providers/factory.js +62 -0
- package/dist/providers/factory.js.map +1 -0
- package/dist/providers/resolver.js +67 -0
- package/dist/providers/resolver.js.map +1 -0
- package/dist/providers/secrets.js +27 -0
- package/dist/providers/secrets.js.map +1 -0
- package/dist/surfacing/cacheStore.js +26 -0
- package/dist/surfacing/cacheStore.js.map +1 -0
- package/dist/surfacing/coalesce.js +15 -0
- package/dist/surfacing/coalesce.js.map +1 -0
- package/dist/surfacing/engine.js +63 -0
- package/dist/surfacing/engine.js.map +1 -0
- package/dist/surfacing/queue.js +44 -0
- package/dist/surfacing/queue.js.map +1 -0
- package/dist/sync/collection.js +65 -0
- package/dist/sync/collection.js.map +1 -0
- package/dist/sync/syncTask.js +123 -0
- package/dist/sync/syncTask.js.map +1 -0
- package/dist/testing/memoryAdapter.d.ts +1 -1
- package/dist/timeframe/presets.d.ts +6 -0
- package/dist/timeframe/presets.js +63 -0
- package/dist/timeframe/presets.js.map +1 -0
- package/dist/{translations-keiKtSjF.js → translations/en.js} +25 -23
- package/dist/translations/en.js.map +1 -0
- package/dist/translations/index.d.ts +14 -0
- package/dist/translations/index.js +26 -0
- package/dist/translations/index.js.map +1 -0
- package/dist/translations/keys.d.ts +78 -0
- package/dist/{keys-DEqL4LOT.js → translations/keys.js} +24 -3
- package/dist/translations/keys.js.map +1 -0
- package/dist/translations/metricKeys.js +30 -0
- package/dist/translations/metricKeys.js.map +1 -0
- package/dist/translations/server.js +13 -0
- package/dist/translations/server.js.map +1 -0
- package/dist/translations/useTranslation.js +12 -0
- package/dist/translations/useTranslation.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsBreakdownWidget.js +85 -0
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsMetricWidget.js +81 -0
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -0
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsRealtimeWidget.js +64 -0
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -0
- package/dist/widgets/AnalyticsTrendWidget.d.ts +7 -0
- package/dist/widgets/AnalyticsTrendWidget.js +91 -0
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -0
- package/dist/widgets/RealtimeCounter.d.ts +19 -0
- package/dist/widgets/RealtimeCounter.js +76 -0
- package/dist/widgets/RealtimeCounter.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +29 -0
- package/dist/widgets/breakdownTypes.js.map +1 -0
- package/dist/widgets/cardChrome.js +22 -0
- package/dist/widgets/cardChrome.js.map +1 -0
- package/dist/widgets/customWidget.d.ts +20 -0
- package/dist/widgets/customWidget.js +30 -0
- package/dist/widgets/customWidget.js.map +1 -0
- package/dist/widgets/defaults.d.ts +12 -0
- package/dist/widgets/defaults.js +72 -0
- package/dist/widgets/defaults.js.map +1 -0
- package/dist/widgets/range.js +28 -0
- package/dist/widgets/range.js.map +1 -0
- package/dist/widgets/readForWidget.d.ts +27 -0
- package/dist/widgets/readForWidget.js +57 -0
- package/dist/widgets/readForWidget.js.map +1 -0
- package/dist/widgets/readForWidgetBreakdown.d.ts +38 -0
- package/dist/widgets/readForWidgetBreakdown.js +75 -0
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -0
- package/dist/{readForWidgetRealtime-D1BD37ST.d.ts → widgets/readForWidgetRealtime.d.ts} +5 -3
- package/dist/widgets/readForWidgetRealtime.js +63 -0
- package/dist/widgets/readForWidgetRealtime.js.map +1 -0
- package/dist/widgets/readForWidgetSeries.d.ts +38 -0
- package/dist/widgets/readForWidgetSeries.js +97 -0
- package/dist/widgets/readForWidgetSeries.js.map +1 -0
- package/dist/widgets/realtimePoll.js +26 -0
- package/dist/widgets/realtimePoll.js.map +1 -0
- package/dist/widgets/registerWidgets.js +249 -0
- package/dist/widgets/registerWidgets.js.map +1 -0
- package/dist/widgets/types.js +13 -0
- package/dist/widgets/types.js.map +1 -0
- package/package.json +16 -2
- package/dist/RealtimeCounter-BJrjMPSa.js +0 -473
- package/dist/RealtimeCounter-BJrjMPSa.js.map +0 -1
- package/dist/dist-B6HruP5v.js +0 -4731
- package/dist/dist-B6HruP5v.js.map +0 -1
- package/dist/exports/adapters/native.js.map +0 -1
- package/dist/exports/adapters/posthog.js.map +0 -1
- package/dist/exports/client.js.map +0 -1
- package/dist/exports/rsc.js.map +0 -1
- package/dist/fetchJson-DZb2_Puj.js.map +0 -1
- package/dist/index-CZdCT0WJ.d.ts +0 -98
- package/dist/keys-DEqL4LOT.js.map +0 -1
- package/dist/lib-CE5x1zLQ.js +0 -1058
- package/dist/lib-CE5x1zLQ.js.map +0 -1
- package/dist/maxmindResolver-CXYXXdul.js +0 -99
- package/dist/maxmindResolver-CXYXXdul.js.map +0 -1
- package/dist/presets-CBfq_uJX.d.ts +0 -38
- package/dist/series-zytbzPoc.js.map +0 -1
- package/dist/server-Cuvhgz-S.js +0 -492
- package/dist/server-Cuvhgz-S.js.map +0 -1
- package/dist/translations-keiKtSjF.js.map +0 -1
- /package/dist/{exports/adapters → adapters/ga4}/ga4.js.map +0 -0
- /package/dist/{exports/adapters → adapters/plausible}/plausible.js.map +0 -0
- /package/dist/{exports/adapters → adapters/umami}/umami.js.map +0 -0
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
//#region src/charts/bucket.ts
|
|
2
|
+
const UNIT_BY_TIMEFRAME = {
|
|
3
|
+
today: "day",
|
|
4
|
+
last7days: "day",
|
|
5
|
+
last30days: "day",
|
|
6
|
+
thisMonth: "day",
|
|
7
|
+
last90days: "week",
|
|
8
|
+
thisYear: "month",
|
|
9
|
+
lastYear: "month",
|
|
10
|
+
allTime: "month"
|
|
11
|
+
};
|
|
12
|
+
const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
|
|
13
|
+
const bucketStart = (d, unit) => {
|
|
14
|
+
if (unit === "month") return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1));
|
|
15
|
+
if (unit === "week") {
|
|
16
|
+
const day = startOfUtcDay(d);
|
|
17
|
+
const dow = (day.getUTCDay() + 6) % 7;
|
|
18
|
+
day.setUTCDate(day.getUTCDate() - dow);
|
|
19
|
+
return day;
|
|
20
|
+
}
|
|
21
|
+
return startOfUtcDay(d);
|
|
22
|
+
};
|
|
23
|
+
const bucketByUnit = (points, unit, weekday) => {
|
|
24
|
+
const groups = /* @__PURE__ */ new Map();
|
|
25
|
+
for (const p of points) {
|
|
26
|
+
const d = bucketStart(new Date(p.date), unit);
|
|
27
|
+
const key = d.toISOString();
|
|
28
|
+
const g = groups.get(key);
|
|
29
|
+
if (g) g.value += p.value;
|
|
30
|
+
else groups.set(key, {
|
|
31
|
+
date: d,
|
|
32
|
+
value: p.value
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
const sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime());
|
|
36
|
+
const first = sorted[0];
|
|
37
|
+
const last = sorted.at(-1);
|
|
38
|
+
const multiYear = first !== void 0 && last !== void 0 && first.date.getUTCFullYear() !== last.date.getUTCFullYear();
|
|
39
|
+
const format = (d) => {
|
|
40
|
+
if (weekday) return new Intl.DateTimeFormat("en-US", {
|
|
41
|
+
weekday: "short",
|
|
42
|
+
timeZone: "UTC"
|
|
43
|
+
}).format(d);
|
|
44
|
+
if (unit === "month") return new Intl.DateTimeFormat("en-US", {
|
|
45
|
+
month: "short",
|
|
46
|
+
year: multiYear ? "numeric" : void 0,
|
|
47
|
+
timeZone: "UTC"
|
|
48
|
+
}).format(d);
|
|
49
|
+
return new Intl.DateTimeFormat("en-US", {
|
|
50
|
+
month: "short",
|
|
51
|
+
day: "numeric",
|
|
52
|
+
timeZone: "UTC"
|
|
53
|
+
}).format(d);
|
|
54
|
+
};
|
|
55
|
+
return sorted.map((g) => ({
|
|
56
|
+
label: format(g.date),
|
|
57
|
+
value: g.value
|
|
58
|
+
}));
|
|
59
|
+
};
|
|
60
|
+
/**
|
|
61
|
+
* Aggregate a daily series into display buckets sized to the timeframe (day for short
|
|
62
|
+
* ranges, week for ~quarter, month for year+), each with a formatted label. Distinct
|
|
63
|
+
* metrics are summed per bucket (a documented daily-uniques approximation).
|
|
64
|
+
*/
|
|
65
|
+
const bucketSeries = (points, timeframe, _now) => bucketByUnit(points, UNIT_BY_TIMEFRAME[timeframe], timeframe === "last7days" || timeframe === "today");
|
|
66
|
+
const DAY = 864e5;
|
|
67
|
+
const unitForSpan = (spanDays) => spanDays <= 31 ? "day" : spanDays <= 120 ? "week" : "month";
|
|
68
|
+
/**
|
|
69
|
+
* Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from
|
|
70
|
+
* the span the way the presets do: short ranges by day, a quarter by week, longer by
|
|
71
|
+
* month. Weekday labels are only used for the fixed 7-day preset, never here.
|
|
72
|
+
*/
|
|
73
|
+
const bucketByRange = (points, range) => {
|
|
74
|
+
return bucketByUnit(points, unitForSpan(Math.round((range.end.getTime() - range.start.getTime()) / DAY)), false);
|
|
75
|
+
};
|
|
76
|
+
//#endregion
|
|
77
|
+
export { bucketByRange, bucketSeries };
|
|
78
|
+
|
|
79
|
+
//# sourceMappingURL=bucket.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bucket.js","names":[],"sources":["../../src/charts/bucket.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport type { TimeframePreset } from '../timeframe/presets'\nimport type { SeriesPoint } from '../widgets/readForWidgetSeries'\n\nexport interface ChartBucket {\n\tlabel: string\n\tvalue: number\n}\n\ntype Unit = 'day' | 'week' | 'month'\n\nconst UNIT_BY_TIMEFRAME: Record<TimeframePreset, Unit> = {\n\ttoday: 'day',\n\tlast7days: 'day',\n\tlast30days: 'day',\n\tthisMonth: 'day',\n\tlast90days: 'week',\n\tthisYear: 'month',\n\tlastYear: 'month',\n\tallTime: 'month',\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst bucketStart = (d: Date, unit: Unit): Date => {\n\tif (unit === 'month') return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1))\n\tif (unit === 'week') {\n\t\tconst day = startOfUtcDay(d)\n\t\tconst dow = (day.getUTCDay() + 6) % 7\n\t\tday.setUTCDate(day.getUTCDate() - dow)\n\t\treturn day\n\t}\n\treturn startOfUtcDay(d)\n}\n\nconst bucketByUnit = (points: SeriesPoint[], unit: Unit, weekday: boolean): ChartBucket[] => {\n\tconst groups = new Map<string, { date: Date; value: number }>()\n\tfor (const p of points) {\n\t\tconst d = bucketStart(new Date(p.date), unit)\n\t\tconst key = d.toISOString()\n\t\tconst g = groups.get(key)\n\t\tif (g) {\n\t\t\tg.value += p.value\n\t\t} else {\n\t\t\tgroups.set(key, { date: d, value: p.value })\n\t\t}\n\t}\n\tconst sorted = [...groups.values()].sort((a, b) => a.date.getTime() - b.date.getTime())\n\tconst first = sorted[0]\n\tconst last = sorted.at(-1)\n\tconst multiYear =\n\t\tfirst !== undefined &&\n\t\tlast !== undefined &&\n\t\tfirst.date.getUTCFullYear() !== last.date.getUTCFullYear()\n\tconst format = (d: Date): string => {\n\t\tif (weekday) {\n\t\t\treturn new Intl.DateTimeFormat('en-US', { weekday: 'short', timeZone: 'UTC' }).format(d)\n\t\t}\n\t\tif (unit === 'month') {\n\t\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\t\tmonth: 'short',\n\t\t\t\tyear: multiYear ? 'numeric' : undefined,\n\t\t\t\ttimeZone: 'UTC',\n\t\t\t}).format(d)\n\t\t}\n\t\treturn new Intl.DateTimeFormat('en-US', {\n\t\t\tmonth: 'short',\n\t\t\tday: 'numeric',\n\t\t\ttimeZone: 'UTC',\n\t\t}).format(d)\n\t}\n\treturn sorted.map((g) => ({ label: format(g.date), value: g.value }))\n}\n\n/**\n * Aggregate a daily series into display buckets sized to the timeframe (day for short\n * ranges, week for ~quarter, month for year+), each with a formatted label. Distinct\n * metrics are summed per bucket (a documented daily-uniques approximation).\n */\nexport const bucketSeries = (\n\tpoints: SeriesPoint[],\n\ttimeframe: TimeframePreset,\n\t_now: Date\n): ChartBucket[] =>\n\tbucketByUnit(\n\t\tpoints,\n\t\tUNIT_BY_TIMEFRAME[timeframe],\n\t\ttimeframe === 'last7days' || timeframe === 'today'\n\t)\n\nconst DAY = 86_400_000\n\nconst unitForSpan = (spanDays: number): Unit =>\n\tspanDays <= 31 ? 'day' : spanDays <= 120 ? 'week' : 'month'\n\n/**\n * Bucket a daily series for a custom (arbitrary) range, choosing the bucket unit from\n * the span the way the presets do: short ranges by day, a quarter by week, longer by\n * month. Weekday labels are only used for the fixed 7-day preset, never here.\n */\nexport const bucketByRange = (points: SeriesPoint[], range: DateRange): ChartBucket[] => {\n\tconst spanDays = Math.round((range.end.getTime() - range.start.getTime()) / DAY)\n\treturn bucketByUnit(points, unitForSpan(spanDays), false)\n}\n"],"mappings":";AAWA,MAAM,oBAAmD;CACxD,OAAO;CACP,WAAW;CACX,YAAY;CACZ,WAAW;CACX,YAAY;CACZ,UAAU;CACV,UAAU;CACV,SAAS;AACV;AAEA,MAAM,iBAAiB,MACtB,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,CAAC,CAAC;AAEvE,MAAM,eAAe,GAAS,SAAqB;CAClD,IAAI,SAAS,SAAS,OAAO,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC;CACtF,IAAI,SAAS,QAAQ;EACpB,MAAM,MAAM,cAAc,CAAC;EAC3B,MAAM,OAAO,IAAI,UAAU,IAAI,KAAK;EACpC,IAAI,WAAW,IAAI,WAAW,IAAI,GAAG;EACrC,OAAO;CACR;CACA,OAAO,cAAc,CAAC;AACvB;AAEA,MAAM,gBAAgB,QAAuB,MAAY,YAAoC;CAC5F,MAAM,yBAAS,IAAI,IAA2C;CAC9D,KAAK,MAAM,KAAK,QAAQ;EACvB,MAAM,IAAI,YAAY,IAAI,KAAK,EAAE,IAAI,GAAG,IAAI;EAC5C,MAAM,MAAM,EAAE,YAAY;EAC1B,MAAM,IAAI,OAAO,IAAI,GAAG;EACxB,IAAI,GACH,EAAE,SAAS,EAAE;OAEb,OAAO,IAAI,KAAK;GAAE,MAAM;GAAG,OAAO,EAAE;EAAM,CAAC;CAE7C;CACA,MAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ,CAAC;CACtF,MAAM,QAAQ,OAAO;CACrB,MAAM,OAAO,OAAO,GAAG,EAAE;CACzB,MAAM,YACL,UAAU,KAAA,KACV,SAAS,KAAA,KACT,MAAM,KAAK,eAAe,MAAM,KAAK,KAAK,eAAe;CAC1D,MAAM,UAAU,MAAoB;EACnC,IAAI,SACH,OAAO,IAAI,KAAK,eAAe,SAAS;GAAE,SAAS;GAAS,UAAU;EAAM,CAAC,EAAE,OAAO,CAAC;EAExF,IAAI,SAAS,SACZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,MAAM,YAAY,YAAY,KAAA;GAC9B,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;EAEZ,OAAO,IAAI,KAAK,eAAe,SAAS;GACvC,OAAO;GACP,KAAK;GACL,UAAU;EACX,CAAC,EAAE,OAAO,CAAC;CACZ;CACA,OAAO,OAAO,KAAK,OAAO;EAAE,OAAO,OAAO,EAAE,IAAI;EAAG,OAAO,EAAE;CAAM,EAAE;AACrE;;;;;;AAOA,MAAa,gBACZ,QACA,WACA,SAEA,aACC,QACA,kBAAkB,YAClB,cAAc,eAAe,cAAc,OAC5C;AAED,MAAM,MAAM;AAEZ,MAAM,eAAe,aACpB,YAAY,KAAK,QAAQ,YAAY,MAAM,SAAS;;;;;;AAOrD,MAAa,iBAAiB,QAAuB,UAAoC;CAExF,OAAO,aAAa,QAAQ,YADX,KAAK,OAAO,MAAM,IAAI,QAAQ,IAAI,MAAM,MAAM,QAAQ,KAAK,GAC7B,CAAC,GAAG,KAAK;AACzD"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
//#region src/charts/spline.ts
|
|
2
|
+
const round = (n) => Math.round(n * 100) / 100;
|
|
3
|
+
/**
|
|
4
|
+
* Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the
|
|
5
|
+
* adjacent secant, interior points the average of neighbouring secants, then each is
|
|
6
|
+
* clamped so the cubic never overshoots (no wiggle between points).
|
|
7
|
+
*/
|
|
8
|
+
const computeTangents = (ys) => {
|
|
9
|
+
const n = ys.length;
|
|
10
|
+
if (n < 2) return ys.map(() => 0);
|
|
11
|
+
const d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y);
|
|
12
|
+
const m = ys.map((_, i) => {
|
|
13
|
+
if (i === 0) return d[0] ?? 0;
|
|
14
|
+
if (i === n - 1) return d[n - 2] ?? 0;
|
|
15
|
+
return ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2;
|
|
16
|
+
});
|
|
17
|
+
for (let i = 0; i < n - 1; i++) {
|
|
18
|
+
const di = d[i] ?? 0;
|
|
19
|
+
if (di === 0) {
|
|
20
|
+
m[i] = 0;
|
|
21
|
+
m[i + 1] = 0;
|
|
22
|
+
continue;
|
|
23
|
+
}
|
|
24
|
+
const mi = m[i] ?? 0;
|
|
25
|
+
const mi1 = m[i + 1] ?? 0;
|
|
26
|
+
const a = mi / di;
|
|
27
|
+
const b = mi1 / di;
|
|
28
|
+
const s = a * a + b * b;
|
|
29
|
+
if (s > 9) {
|
|
30
|
+
const t = 3 / Math.sqrt(s);
|
|
31
|
+
m[i] = t * a * di;
|
|
32
|
+
m[i + 1] = t * b * di;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
return m;
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a
|
|
39
|
+
* value series into a `width` x `height` box (y normalized to the value range; flat or
|
|
40
|
+
* single-value series sit on the vertical midline).
|
|
41
|
+
*/
|
|
42
|
+
const monotoneAreaPath = (values, opts) => {
|
|
43
|
+
const { width, height } = opts;
|
|
44
|
+
const padding = opts.padding ?? 0;
|
|
45
|
+
if (values.length === 0) return {
|
|
46
|
+
line: "",
|
|
47
|
+
area: ""
|
|
48
|
+
};
|
|
49
|
+
const innerH = height - padding * 2;
|
|
50
|
+
const max = Math.max(...values);
|
|
51
|
+
const min = Math.min(...values);
|
|
52
|
+
const span = max - min || 1;
|
|
53
|
+
const x = (i) => round(values.length > 1 ? i / (values.length - 1) * width : 0);
|
|
54
|
+
const y = (v) => round(max === min ? height / 2 : padding + innerH - (v - min) / span * innerH);
|
|
55
|
+
const v0 = values[0] ?? 0;
|
|
56
|
+
if (values.length === 1) return {
|
|
57
|
+
line: `M0,${y(v0)} L${round(width)},${y(v0)}`,
|
|
58
|
+
area: ""
|
|
59
|
+
};
|
|
60
|
+
const tangents = computeTangents(values);
|
|
61
|
+
let line = `M${x(0)},${y(v0)}`;
|
|
62
|
+
for (let i = 0; i < values.length - 1; i++) {
|
|
63
|
+
const x0 = i;
|
|
64
|
+
const x1 = i + 1;
|
|
65
|
+
const vi = values[i] ?? 0;
|
|
66
|
+
const vi1 = values[i + 1] ?? 0;
|
|
67
|
+
const ti = tangents[i] ?? 0;
|
|
68
|
+
const ti1 = tangents[i + 1] ?? 0;
|
|
69
|
+
const cp1x = round(x(x0 + 1 / 3));
|
|
70
|
+
const cp1y = round(y(vi + ti / 3));
|
|
71
|
+
const cp2x = round(x(x1 - 1 / 3));
|
|
72
|
+
const cp2y = round(y(vi1 - ti1 / 3));
|
|
73
|
+
line += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`;
|
|
74
|
+
}
|
|
75
|
+
const area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`;
|
|
76
|
+
return {
|
|
77
|
+
line,
|
|
78
|
+
area
|
|
79
|
+
};
|
|
80
|
+
};
|
|
81
|
+
//#endregion
|
|
82
|
+
export { monotoneAreaPath };
|
|
83
|
+
|
|
84
|
+
//# sourceMappingURL=spline.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"spline.js","names":[],"sources":["../../src/charts/spline.ts"],"sourcesContent":["export interface SplineGeometry {\n\tline: string\n\tarea: string\n}\n\nexport interface SplineOptions {\n\twidth: number\n\theight: number\n\tpadding?: number\n}\n\nconst round = (n: number): number => Math.round(n * 100) / 100\n\n/**\n * Fritsch-Carlson monotone tangents for a unit-spaced series: endpoints take the\n * adjacent secant, interior points the average of neighbouring secants, then each is\n * clamped so the cubic never overshoots (no wiggle between points).\n */\nexport const computeTangents = (ys: number[]): number[] => {\n\tconst n = ys.length\n\tif (n < 2) {\n\t\treturn ys.map(() => 0)\n\t}\n\tconst d = ys.slice(0, -1).map((y, i) => (ys[i + 1] ?? 0) - y)\n\tconst m = ys.map((_, i) => {\n\t\tif (i === 0) return d[0] ?? 0\n\t\tif (i === n - 1) return d[n - 2] ?? 0\n\t\treturn ((d[i - 1] ?? 0) + (d[i] ?? 0)) / 2\n\t})\n\tfor (let i = 0; i < n - 1; i++) {\n\t\tconst di = d[i] ?? 0\n\t\tif (di === 0) {\n\t\t\tm[i] = 0\n\t\t\tm[i + 1] = 0\n\t\t\tcontinue\n\t\t}\n\t\tconst mi = m[i] ?? 0\n\t\tconst mi1 = m[i + 1] ?? 0\n\t\tconst a = mi / di\n\t\tconst b = mi1 / di\n\t\tconst s = a * a + b * b\n\t\tif (s > 9) {\n\t\t\tconst t = 3 / Math.sqrt(s)\n\t\t\tm[i] = t * a * di\n\t\t\tm[i + 1] = t * b * di\n\t\t}\n\t}\n\treturn m\n}\n\n/**\n * Build SVG path strings for a monotone-cubic line and its closed area fill, mapping a\n * value series into a `width` x `height` box (y normalized to the value range; flat or\n * single-value series sit on the vertical midline).\n */\nexport const monotoneAreaPath = (values: number[], opts: SplineOptions): SplineGeometry => {\n\tconst { width, height } = opts\n\tconst padding = opts.padding ?? 0\n\tif (values.length === 0) {\n\t\treturn { line: '', area: '' }\n\t}\n\tconst innerH = height - padding * 2\n\tconst max = Math.max(...values)\n\tconst min = Math.min(...values)\n\tconst span = max - min || 1\n\tconst x = (i: number): number => round(values.length > 1 ? (i / (values.length - 1)) * width : 0)\n\tconst y = (v: number): number =>\n\t\tround(max === min ? height / 2 : padding + innerH - ((v - min) / span) * innerH)\n\tconst v0 = values[0] ?? 0\n\tif (values.length === 1) {\n\t\tconst line = `M0,${y(v0)} L${round(width)},${y(v0)}`\n\t\treturn { line, area: '' }\n\t}\n\tconst tangents = computeTangents(values)\n\tlet line = `M${x(0)},${y(v0)}`\n\tfor (let i = 0; i < values.length - 1; i++) {\n\t\tconst x0 = i\n\t\tconst x1 = i + 1\n\t\tconst vi = values[i] ?? 0\n\t\tconst vi1 = values[i + 1] ?? 0\n\t\tconst ti = tangents[i] ?? 0\n\t\tconst ti1 = tangents[i + 1] ?? 0\n\t\tconst cp1x = round(x(x0 + 1 / 3))\n\t\tconst cp1y = round(y(vi + ti / 3))\n\t\tconst cp2x = round(x(x1 - 1 / 3))\n\t\tconst cp2y = round(y(vi1 - ti1 / 3))\n\t\tline += ` C${cp1x},${cp1y} ${cp2x},${cp2y} ${x(x1)},${y(vi1)}`\n\t}\n\tconst area = `${line} L${x(values.length - 1)},${round(height)} L${x(0)},${round(height)} Z`\n\treturn { line, area }\n}\n"],"mappings":";AAWA,MAAM,SAAS,MAAsB,KAAK,MAAM,IAAI,GAAG,IAAI;;;;;;AAO3D,MAAa,mBAAmB,OAA2B;CAC1D,MAAM,IAAI,GAAG;CACb,IAAI,IAAI,GACP,OAAO,GAAG,UAAU,CAAC;CAEtB,MAAM,IAAI,GAAG,MAAM,GAAG,EAAE,EAAE,KAAK,GAAG,OAAO,GAAG,IAAI,MAAM,KAAK,CAAC;CAC5D,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM;EAC1B,IAAI,MAAM,GAAG,OAAO,EAAE,MAAM;EAC5B,IAAI,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,MAAM;EACpC,SAAS,EAAE,IAAI,MAAM,MAAM,EAAE,MAAM,MAAM;CAC1C,CAAC;CACD,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,KAAK;EAC/B,MAAM,KAAK,EAAE,MAAM;EACnB,IAAI,OAAO,GAAG;GACb,EAAE,KAAK;GACP,EAAE,IAAI,KAAK;GACX;EACD;EACA,MAAM,KAAK,EAAE,MAAM;EACnB,MAAM,MAAM,EAAE,IAAI,MAAM;EACxB,MAAM,IAAI,KAAK;EACf,MAAM,IAAI,MAAM;EAChB,MAAM,IAAI,IAAI,IAAI,IAAI;EACtB,IAAI,IAAI,GAAG;GACV,MAAM,IAAI,IAAI,KAAK,KAAK,CAAC;GACzB,EAAE,KAAK,IAAI,IAAI;GACf,EAAE,IAAI,KAAK,IAAI,IAAI;EACpB;CACD;CACA,OAAO;AACR;;;;;;AAOA,MAAa,oBAAoB,QAAkB,SAAwC;CAC1F,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,UAAU,KAAK,WAAW;CAChC,IAAI,OAAO,WAAW,GACrB,OAAO;EAAE,MAAM;EAAI,MAAM;CAAG;CAE7B,MAAM,SAAS,SAAS,UAAU;CAClC,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM;CAC9B,MAAM,MAAM,KAAK,IAAI,GAAG,MAAM;CAC9B,MAAM,OAAO,MAAM,OAAO;CAC1B,MAAM,KAAK,MAAsB,MAAM,OAAO,SAAS,IAAK,KAAK,OAAO,SAAS,KAAM,QAAQ,CAAC;CAChG,MAAM,KAAK,MACV,MAAM,QAAQ,MAAM,SAAS,IAAI,UAAU,UAAW,IAAI,OAAO,OAAQ,MAAM;CAChF,MAAM,KAAK,OAAO,MAAM;CACxB,IAAI,OAAO,WAAW,GAErB,OAAO;EAAE,MAAA,MADU,EAAE,EAAE,EAAE,IAAI,MAAM,KAAK,EAAE,GAAG,EAAE,EAAE;EAClC,MAAM;CAAG;CAEzB,MAAM,WAAW,gBAAgB,MAAM;CACvC,IAAI,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;CAC3B,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,SAAS,GAAG,KAAK;EAC3C,MAAM,KAAK;EACX,MAAM,KAAK,IAAI;EACf,MAAM,KAAK,OAAO,MAAM;EACxB,MAAM,MAAM,OAAO,IAAI,MAAM;EAC7B,MAAM,KAAK,SAAS,MAAM;EAC1B,MAAM,MAAM,SAAS,IAAI,MAAM;EAC/B,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,KAAK,KAAK,CAAC,CAAC;EACjC,MAAM,OAAO,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;EAChC,MAAM,OAAO,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC;EACnC,QAAQ,KAAK,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG;CAC5D;CACA,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE,OAAO,SAAS,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,EAAE;CACzF,OAAO;EAAE;EAAM;CAAK;AACrB"}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx } from "react/jsx-runtime";
|
|
3
|
+
//#region src/charts/styles.tsx
|
|
4
|
+
const CHART_CSS = `
|
|
5
|
+
:where(:root) {
|
|
6
|
+
--analytics-chart-1: var(--theme-success-500, #3b82f6);
|
|
7
|
+
}
|
|
8
|
+
.analytics-chart { position: relative; width: 100%; }
|
|
9
|
+
.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }
|
|
10
|
+
.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }
|
|
11
|
+
.analytics-chart__area { stroke: none; }
|
|
12
|
+
.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }
|
|
13
|
+
.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }
|
|
14
|
+
.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }
|
|
15
|
+
.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }
|
|
16
|
+
.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }
|
|
17
|
+
.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }
|
|
18
|
+
.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }
|
|
19
|
+
.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }
|
|
20
|
+
@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }
|
|
21
|
+
.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }
|
|
22
|
+
.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }
|
|
23
|
+
.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }
|
|
24
|
+
.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }
|
|
25
|
+
.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }
|
|
26
|
+
.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
|
|
27
|
+
.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }
|
|
28
|
+
.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }
|
|
29
|
+
`;
|
|
30
|
+
/**
|
|
31
|
+
* Single scoped stylesheet for all analytics charts, injected as a `<style>` element so
|
|
32
|
+
* it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically
|
|
33
|
+
* in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`
|
|
34
|
+
* scope so a consuming app can override them.
|
|
35
|
+
*/
|
|
36
|
+
function ChartStyles() {
|
|
37
|
+
return /* @__PURE__ */ jsx("style", { dangerouslySetInnerHTML: { __html: CHART_CSS } });
|
|
38
|
+
}
|
|
39
|
+
//#endregion
|
|
40
|
+
export { ChartStyles };
|
|
41
|
+
|
|
42
|
+
//# sourceMappingURL=styles.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"styles.js","names":[],"sources":["../../src/charts/styles.tsx"],"sourcesContent":["'use client'\n\nconst CHART_CSS = `\n:where(:root) {\n\t--analytics-chart-1: var(--theme-success-500, #3b82f6);\n}\n.analytics-chart { position: relative; width: 100%; }\n.analytics-chart__svg { display: block; width: 100%; height: 100%; overflow: visible; }\n.analytics-chart__grid { stroke: var(--theme-elevation-150); stroke-width: 1; vector-effect: non-scaling-stroke; }\n.analytics-chart__area { stroke: none; }\n.analytics-chart__line { fill: none; stroke: var(--analytics-chart-1); stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; vector-effect: non-scaling-stroke; }\n.analytics-chart__dot { fill: var(--theme-elevation-0); stroke: var(--analytics-chart-1); stroke-width: 2; }\n.analytics-chart__axis { fill: var(--theme-elevation-450); font-size: 0.6875rem; }\n.analytics-chart__cursor { stroke: var(--theme-elevation-300); stroke-width: 1; stroke-dasharray: 3 3; vector-effect: non-scaling-stroke; }\n.analytics-chart__active { fill: var(--analytics-chart-1); stroke: var(--theme-elevation-0); stroke-width: 2; }\n.analytics-chart__tooltip { position: absolute; pointer-events: none; transform: translate(-50%, -120%); background: var(--theme-elevation-0); border: 1px solid var(--theme-elevation-150); border-radius: var(--style-radius-m, 6px); box-shadow: 0 4px 16px rgba(0, 0, 0, 0.18); padding: 0.4rem 0.6rem; font-size: 0.75rem; white-space: nowrap; z-index: 10; animation: analytics-fade 0.12s ease-out; }\n.analytics-chart__tooltip-label { color: var(--theme-elevation-500); font-weight: 600; margin-bottom: 0.15rem; }\n.analytics-chart__tooltip-value { color: var(--theme-elevation-800); font-weight: 700; font-variant-numeric: tabular-nums; }\n@keyframes analytics-fade { from { opacity: 0; } to { opacity: 1; } }\n.analytics-bars { display: flex; flex-direction: column; gap: 0.35rem; }\n.analytics-bars__row { position: relative; display: flex; align-items: center; gap: 0.6rem; }\n.analytics-bars__track { position: relative; flex: 1; min-width: 0; height: 1.85rem; border-radius: var(--style-radius-s, 4px); overflow: hidden; }\n.analytics-bars__fill { position: absolute; inset: 0 auto 0 0; border-radius: inherit; background: color-mix(in srgb, var(--analytics-chart-1) 90%, transparent); transition: filter 0.1s ease; }\n.analytics-bars__row:hover .analytics-bars__fill { filter: brightness(1.12); }\n.analytics-bars__label { position: relative; padding: 0 0.6rem; color: var(--theme-base-800, #fff); font-size: 0.8125rem; line-height: 1.85rem; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }\n.analytics-bars__value { flex: none; font-size: 0.8125rem; font-weight: 600; font-variant-numeric: tabular-nums; color: var(--theme-elevation-800); }\n.analytics-bars__empty { color: var(--theme-elevation-400); font-size: 0.8125rem; }\n`\n\n/**\n * Single scoped stylesheet for all analytics charts, injected as a `<style>` element so\n * it ships as a JS string (our tsdown build has no CSS pipeline) and behaves identically\n * in dev and when installed from npm. The `--analytics-chart-*` tokens live in `:root`\n * scope so a consuming app can override them.\n */\nexport function ChartStyles() {\n\t// biome-ignore lint/security/noDangerouslySetInnerHtml: static build-time CSS constant, no user input\n\treturn <style dangerouslySetInnerHTML={{ __html: CHART_CSS }} />\n}\n"],"mappings":";;;AAEA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiClB,SAAgB,cAAc;CAE7B,OAAO,oBAAC,SAAD,EAAO,yBAAyB,EAAE,QAAQ,UAAU,EAAI,CAAA;AAChE"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
//#region src/core/cacheKey.ts
|
|
2
|
+
const stable = (xs) => xs ? [...xs].sort().join(",") : "";
|
|
3
|
+
const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
|
|
4
|
+
const startOfNextUtcDay = (d) => {
|
|
5
|
+
const day = startOfUtcDay(d);
|
|
6
|
+
day.setUTCDate(day.getUTCDate() + 1);
|
|
7
|
+
return day;
|
|
8
|
+
};
|
|
9
|
+
function buildCacheKey(provider, q) {
|
|
10
|
+
const pathKey = q.path ?? "site";
|
|
11
|
+
const range = `${startOfUtcDay(q.dateRange.start).toISOString()}_${startOfNextUtcDay(q.dateRange.end).toISOString()}`;
|
|
12
|
+
const filters = (q.filters ?? []).map((f) => `${f.dimension}${f.operator}${f.value}`).sort().join(";");
|
|
13
|
+
return [
|
|
14
|
+
"analytics",
|
|
15
|
+
provider,
|
|
16
|
+
q.hostname ?? "_",
|
|
17
|
+
pathKey,
|
|
18
|
+
stable(q.metrics),
|
|
19
|
+
stable(q.dimensions),
|
|
20
|
+
range,
|
|
21
|
+
q.granularity ?? "_",
|
|
22
|
+
filters,
|
|
23
|
+
String(q.limit ?? "_"),
|
|
24
|
+
q.order ? `${q.order.metric}:${q.order.direction}` : "_",
|
|
25
|
+
...q.scope !== void 0 ? [encodeURIComponent(q.scope)] : []
|
|
26
|
+
].join("|");
|
|
27
|
+
}
|
|
28
|
+
//#endregion
|
|
29
|
+
export { buildCacheKey };
|
|
30
|
+
|
|
31
|
+
//# sourceMappingURL=cacheKey.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cacheKey.js","names":[],"sources":["../../src/core/cacheKey.ts"],"sourcesContent":["import type { AnalyticsQuery } from './contract'\n\nconst stable = (xs?: string[]): string => (xs ? [...xs].sort().join(',') : '')\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst startOfNextUtcDay = (d: Date): Date => {\n\tconst day = startOfUtcDay(d)\n\tday.setUTCDate(day.getUTCDate() + 1)\n\treturn day\n}\n\nexport function buildCacheKey(provider: string, q: AnalyticsQuery): string {\n\tconst pathKey = q.path ?? 'site'\n\tconst range = `${startOfUtcDay(q.dateRange.start).toISOString()}_${startOfNextUtcDay(q.dateRange.end).toISOString()}`\n\tconst filters = (q.filters ?? [])\n\t\t.map((f) => `${f.dimension}${f.operator}${f.value}`)\n\t\t.sort()\n\t\t.join(';')\n\treturn [\n\t\t'analytics',\n\t\tprovider,\n\t\tq.hostname ?? '_',\n\t\tpathKey,\n\t\tstable(q.metrics),\n\t\tstable(q.dimensions),\n\t\trange,\n\t\tq.granularity ?? '_',\n\t\tfilters,\n\t\tString(q.limit ?? '_'),\n\t\tq.order ? `${q.order.metric}:${q.order.direction}` : '_',\n\t\t// Appended only for scoped reads so unscoped keys keep their historical format.\n\t\t...(q.scope !== undefined ? [encodeURIComponent(q.scope)] : []),\n\t].join('|')\n}\n"],"mappings":";AAEA,MAAM,UAAU,OAA2B,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;AAE3E,MAAM,iBAAiB,MACtB,IAAI,KAAK,KAAK,IAAI,EAAE,eAAe,GAAG,EAAE,YAAY,GAAG,EAAE,WAAW,CAAC,CAAC;AAEvE,MAAM,qBAAqB,MAAkB;CAC5C,MAAM,MAAM,cAAc,CAAC;CAC3B,IAAI,WAAW,IAAI,WAAW,IAAI,CAAC;CACnC,OAAO;AACR;AAEA,SAAgB,cAAc,UAAkB,GAA2B;CAC1E,MAAM,UAAU,EAAE,QAAQ;CAC1B,MAAM,QAAQ,GAAG,cAAc,EAAE,UAAU,KAAK,EAAE,YAAY,EAAE,GAAG,kBAAkB,EAAE,UAAU,GAAG,EAAE,YAAY;CAClH,MAAM,WAAW,EAAE,WAAW,CAAC,GAC7B,KAAK,MAAM,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAClD,KAAK,EACL,KAAK,GAAG;CACV,OAAO;EACN;EACA;EACA,EAAE,YAAY;EACd;EACA,OAAO,EAAE,OAAO;EAChB,OAAO,EAAE,UAAU;EACnB;EACA,EAAE,eAAe;EACjB;EACA,OAAO,EAAE,SAAS,GAAG;EACrB,EAAE,QAAQ,GAAG,EAAE,MAAM,OAAO,GAAG,EAAE,MAAM,cAAc;EAErD,GAAI,EAAE,UAAU,KAAA,IAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC;CAC9D,EAAE,KAAK,GAAG;AACX"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { DimensionKey, MetricKey } from "./contract.js";
|
|
2
|
+
|
|
3
|
+
//#region src/core/capabilities.d.ts
|
|
4
|
+
interface CapabilityRequirement {
|
|
5
|
+
metrics?: MetricKey[];
|
|
6
|
+
dimensions?: DimensionKey[];
|
|
7
|
+
realtime?: boolean;
|
|
8
|
+
perPageQuery?: boolean;
|
|
9
|
+
}
|
|
10
|
+
//#endregion
|
|
11
|
+
export { CapabilityRequirement };
|
|
12
|
+
//# sourceMappingURL=capabilities.d.ts.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
//#region src/core/capabilities.ts
|
|
2
|
+
function satisfiesCapabilities(caps, req) {
|
|
3
|
+
if (req.realtime && !caps.realtime) return false;
|
|
4
|
+
if (req.perPageQuery && !caps.perPageQuery) return false;
|
|
5
|
+
if (req.metrics?.some((m) => !caps.metrics.has(m))) return false;
|
|
6
|
+
if (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false;
|
|
7
|
+
return true;
|
|
8
|
+
}
|
|
9
|
+
//#endregion
|
|
10
|
+
export { satisfiesCapabilities };
|
|
11
|
+
|
|
12
|
+
//# sourceMappingURL=capabilities.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capabilities.js","names":[],"sources":["../../src/core/capabilities.ts"],"sourcesContent":["import type { AnalyticsCapabilities, DimensionKey, MetricKey } from './contract'\n\nexport interface CapabilityRequirement {\n\tmetrics?: MetricKey[]\n\tdimensions?: DimensionKey[]\n\trealtime?: boolean\n\tperPageQuery?: boolean\n}\n\nexport function satisfiesCapabilities(\n\tcaps: AnalyticsCapabilities,\n\treq: CapabilityRequirement\n): boolean {\n\tif (req.realtime && !caps.realtime) return false\n\tif (req.perPageQuery && !caps.perPageQuery) return false\n\tif (req.metrics?.some((m) => !caps.metrics.has(m))) return false\n\tif (req.dimensions?.some((d) => !caps.dimensions.has(d))) return false\n\treturn true\n}\n"],"mappings":";AASA,SAAgB,sBACf,MACA,KACU;CACV,IAAI,IAAI,YAAY,CAAC,KAAK,UAAU,OAAO;CAC3C,IAAI,IAAI,gBAAgB,CAAC,KAAK,cAAc,OAAO;CACnD,IAAI,IAAI,SAAS,MAAM,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,OAAO;CAC3D,IAAI,IAAI,YAAY,MAAM,MAAM,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;CACjE,OAAO;AACR"}
|
|
@@ -1,6 +1,11 @@
|
|
|
1
|
-
import { Config } from "payload";
|
|
1
|
+
import { Config, PayloadRequest } from "payload";
|
|
2
2
|
|
|
3
3
|
//#region src/core/contract.d.ts
|
|
4
|
+
/**
|
|
5
|
+
* Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every
|
|
6
|
+
* scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
|
|
7
|
+
*/
|
|
8
|
+
declare const PLATFORM_SCOPE = "*";
|
|
4
9
|
type MetricKey = 'pageviews' | 'visitors' | 'visits' | 'sessions' | 'bounceRate' | 'avgDuration' | 'entries' | 'exits' | 'scrollDepth' | 'events' | 'conversions' | 'revenue';
|
|
5
10
|
type DimensionKey = 'page' | 'referrer' | 'source' | 'medium' | 'campaign' | 'utmSource' | 'utmMedium' | 'utmCampaign' | 'utmContent' | 'utmTerm' | 'device' | 'browser' | 'os' | 'country' | 'region' | 'city' | 'language' | 'event';
|
|
6
11
|
type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month';
|
|
@@ -26,6 +31,13 @@ interface AnalyticsQuery {
|
|
|
26
31
|
metric: MetricKey;
|
|
27
32
|
direction: 'asc' | 'desc';
|
|
28
33
|
};
|
|
34
|
+
/**
|
|
35
|
+
* Analytics boundary this read belongs to (tenant id, site key). Undefined means
|
|
36
|
+
* install-wide (the default). Adapters that can filter by scope apply it; others
|
|
37
|
+
* ignore it. Always part of the surfacing cache key, so per-scope adapter
|
|
38
|
+
* instances sharing an id never share cached results.
|
|
39
|
+
*/
|
|
40
|
+
scope?: string;
|
|
29
41
|
}
|
|
30
42
|
interface AnalyticsRow {
|
|
31
43
|
dimensions?: Partial<Record<DimensionKey, string>>;
|
|
@@ -64,10 +76,24 @@ interface AnalyticsCapabilities {
|
|
|
64
76
|
realtime: number;
|
|
65
77
|
aggregate: number;
|
|
66
78
|
};
|
|
79
|
+
/**
|
|
80
|
+
* The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native
|
|
81
|
+
* scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through
|
|
82
|
+
* a shared platform adapter would expose cross-scope data, so such reads are
|
|
83
|
+
* gated by `access.platformRead`.
|
|
84
|
+
*/
|
|
85
|
+
scopedQueries?: boolean;
|
|
67
86
|
}
|
|
68
87
|
interface AdapterContext {
|
|
69
88
|
signal?: AbortSignal;
|
|
70
89
|
}
|
|
90
|
+
/** Extra context the plugin hands adapters when they register config surface. */
|
|
91
|
+
interface AdapterRegisterContext {
|
|
92
|
+
/** True when the plugin has a scopeResolver configured. */
|
|
93
|
+
scoped: boolean;
|
|
94
|
+
/** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */
|
|
95
|
+
resolveScope: (req: PayloadRequest) => Promise<string | null>;
|
|
96
|
+
}
|
|
71
97
|
interface AnalyticsAdapter {
|
|
72
98
|
readonly id: string;
|
|
73
99
|
readonly label: string;
|
|
@@ -75,9 +101,9 @@ interface AnalyticsAdapter {
|
|
|
75
101
|
isConfigured(): boolean;
|
|
76
102
|
query(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
|
|
77
103
|
realtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>;
|
|
78
|
-
register?(config: Config): void;
|
|
104
|
+
register?(config: Config, context?: AdapterRegisterContext): void;
|
|
79
105
|
}
|
|
80
106
|
type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter;
|
|
81
107
|
//#endregion
|
|
82
|
-
export {
|
|
83
|
-
//# sourceMappingURL=contract
|
|
108
|
+
export { AdapterContext, AdapterRegisterContext, AnalyticsAdapter, AnalyticsAdapterFactory, AnalyticsCapabilities, AnalyticsFilter, AnalyticsQuery, AnalyticsResult, AnalyticsRow, DateRange, DimensionKey, Granularity, MetricKey, PLATFORM_SCOPE, RateLimitDescriptor };
|
|
109
|
+
//# sourceMappingURL=contract.d.ts.map
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
//#region src/core/contract.ts
|
|
2
|
+
/**
|
|
3
|
+
* Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every
|
|
4
|
+
* scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.
|
|
5
|
+
*/
|
|
6
|
+
const PLATFORM_SCOPE = "*";
|
|
7
|
+
//#endregion
|
|
8
|
+
export { PLATFORM_SCOPE };
|
|
9
|
+
|
|
10
|
+
//# sourceMappingURL=contract.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract.js","names":[],"sources":["../../src/core/contract.ts"],"sourcesContent":["import type { Config, PayloadRequest } from 'payload'\n\n/**\n * Explicit cross-scope read marker: pass as a read's `scope` to aggregate over every\n * scope. Gated by `access.platformRead`; the query reaches the adapter unscoped.\n */\nexport const PLATFORM_SCOPE = '*'\n\nexport type MetricKey =\n\t| 'pageviews'\n\t| 'visitors'\n\t| 'visits'\n\t| 'sessions'\n\t| 'bounceRate'\n\t| 'avgDuration'\n\t| 'entries'\n\t| 'exits'\n\t| 'scrollDepth'\n\t| 'events'\n\t| 'conversions'\n\t| 'revenue'\n\nexport type DimensionKey =\n\t| 'page'\n\t| 'referrer'\n\t| 'source'\n\t| 'medium'\n\t| 'campaign'\n\t| 'utmSource'\n\t| 'utmMedium'\n\t| 'utmCampaign'\n\t| 'utmContent'\n\t| 'utmTerm'\n\t| 'device'\n\t| 'browser'\n\t| 'os'\n\t| 'country'\n\t| 'region'\n\t| 'city'\n\t| 'language'\n\t| 'event'\n\nexport type Granularity = 'minute' | 'hour' | 'day' | 'week' | 'month'\n\nexport interface DateRange {\n\tstart: Date\n\tend: Date\n}\n\nexport interface AnalyticsFilter {\n\tdimension: DimensionKey\n\toperator: 'eq' | 'contains' | 'matches'\n\tvalue: string\n}\n\nexport interface AnalyticsQuery {\n\tpath?: string\n\thostname?: string\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tdateRange: DateRange\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\t/**\n\t * Analytics boundary this read belongs to (tenant id, site key). Undefined means\n\t * install-wide (the default). Adapters that can filter by scope apply it; others\n\t * ignore it. Always part of the surfacing cache key, so per-scope adapter\n\t * instances sharing an id never share cached results.\n\t */\n\tscope?: string\n}\n\nexport interface AnalyticsRow {\n\tdimensions?: Partial<Record<DimensionKey, string>>\n\tmetrics: Partial<Record<MetricKey, number>>\n\ttimestamp?: string\n}\n\nexport interface AnalyticsResult {\n\trows: AnalyticsRow[]\n\ttotals?: Partial<Record<MetricKey, number>>\n\tmeta: { provider: string; sampled?: boolean; clamped?: boolean; fetchedAt: string }\n}\n\nexport interface RateLimitDescriptor {\n\trequestsPerMinute?: number\n\trequestsPerHour?: number\n\tmaxConcurrent?: number\n\tquotaModel?: 'requests' | 'tokens'\n\treadsCountAsUsage?: boolean\n}\n\nexport interface AnalyticsCapabilities {\n\tperPageQuery: boolean\n\trealtime: boolean\n\trealtimeWindowMinutes?: number\n\tcomparison: boolean\n\tminGranularity: Granularity\n\tmaxLookbackDays: number | null\n\tmetrics: ReadonlySet<MetricKey>\n\tdimensions: ReadonlySet<DimensionKey>\n\tbatchPageReport: boolean\n\trateLimit: RateLimitDescriptor | null\n\trecommendedTtl: { realtime: number; aggregate: number }\n\t/**\n\t * The adapter applies `AnalyticsQuery.scope` as a provider-native filter (native\n\t * scope column, PostHog `scopeProperty`, ...). Without it, a scoped read through\n\t * a shared platform adapter would expose cross-scope data, so such reads are\n\t * gated by `access.platformRead`.\n\t */\n\tscopedQueries?: boolean\n}\n\nexport interface AdapterContext {\n\tsignal?: AbortSignal\n}\n\n/** Extra context the plugin hands adapters when they register config surface. */\nexport interface AdapterRegisterContext {\n\t/** True when the plugin has a scopeResolver configured. */\n\tscoped: boolean\n\t/** The plugin's scopeResolver bound for adapter use (e.g. ingest stamping). */\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n}\n\nexport interface AnalyticsAdapter {\n\treadonly id: string\n\treadonly label: string\n\treadonly capabilities: AnalyticsCapabilities\n\tisConfigured(): boolean\n\tquery(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\trealtime?(query: AnalyticsQuery, ctx: AdapterContext): Promise<AnalyticsResult>\n\tregister?(config: Config, context?: AdapterRegisterContext): void\n}\n\nexport type AnalyticsAdapterFactory<Config> = (config: Config) => AnalyticsAdapter\n"],"mappings":";;;;;AAMA,MAAa,iBAAiB"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
//#region src/core/granularity.ts
|
|
2
|
+
const GRANULARITY_ORDER = [
|
|
3
|
+
"minute",
|
|
4
|
+
"hour",
|
|
5
|
+
"day",
|
|
6
|
+
"week",
|
|
7
|
+
"month"
|
|
8
|
+
];
|
|
9
|
+
/**
|
|
10
|
+
* Whether an adapter can bucket at granularity `g`. `minGranularity` is the finest
|
|
11
|
+
* bucket a provider supports, so it also supports every coarser one.
|
|
12
|
+
*/
|
|
13
|
+
const supportsGranularity = (caps, g) => GRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity);
|
|
14
|
+
//#endregion
|
|
15
|
+
export { supportsGranularity };
|
|
16
|
+
|
|
17
|
+
//# sourceMappingURL=granularity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"granularity.js","names":[],"sources":["../../src/core/granularity.ts"],"sourcesContent":["import type { AnalyticsCapabilities, Granularity } from './contract'\n\nexport const GRANULARITY_ORDER: Granularity[] = ['minute', 'hour', 'day', 'week', 'month']\n\n/**\n * Whether an adapter can bucket at granularity `g`. `minGranularity` is the finest\n * bucket a provider supports, so it also supports every coarser one.\n */\nexport const supportsGranularity = (caps: AnalyticsCapabilities, g: Granularity): boolean =>\n\tGRANULARITY_ORDER.indexOf(g) >= GRANULARITY_ORDER.indexOf(caps.minGranularity)\n"],"mappings":";AAEA,MAAa,oBAAmC;CAAC;CAAU;CAAQ;CAAO;CAAQ;AAAO;;;;;AAMzF,MAAa,uBAAuB,MAA6B,MAChE,kBAAkB,QAAQ,CAAC,KAAK,kBAAkB,QAAQ,KAAK,cAAc"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { AnalyticsAdapter } from "./contract.js";
|
|
2
|
+
import { TranslationsOption } from "../translations/index.js";
|
|
3
|
+
import { AnalyticsBinding } from "../binding/types.js";
|
|
4
|
+
import { CustomWidgetDef } from "../widgets/customWidget.js";
|
|
5
|
+
import { CollectionConfig, CollectionSlug, Payload, PayloadRequest } from "payload";
|
|
6
|
+
|
|
7
|
+
//#region src/core/options.d.ts
|
|
8
|
+
/**
|
|
9
|
+
* Maps a request to its analytics boundary (tenant id, site key). Null means the
|
|
10
|
+
* whole install, which is the default single-site behavior. With a multi-tenant
|
|
11
|
+
* plugin, return the request's tenant id here.
|
|
12
|
+
*/
|
|
13
|
+
type ScopeResolver = (args: {
|
|
14
|
+
req: PayloadRequest;
|
|
15
|
+
}) => string | null | Promise<string | null>;
|
|
16
|
+
/**
|
|
17
|
+
* Escape hatch replacing the provider-collection lookup: return the runtime
|
|
18
|
+
* adapters for a scope yourself (any store, any shape). Results are layered onto
|
|
19
|
+
* the static config adapters exactly like collection-resolved ones, but are not
|
|
20
|
+
* cached; memoize inside the function if lookups are expensive.
|
|
21
|
+
*/
|
|
22
|
+
type ProvidersResolve = (args: {
|
|
23
|
+
payload: Payload;
|
|
24
|
+
req?: PayloadRequest;
|
|
25
|
+
scope: string | null;
|
|
26
|
+
}) => AnalyticsAdapter[] | Promise<AnalyticsAdapter[]>;
|
|
27
|
+
type ProvidersCollectionOptions = {
|
|
28
|
+
slug?: string;
|
|
29
|
+
/**
|
|
30
|
+
* Field matched against the resolved scope when looking up a scope's providers.
|
|
31
|
+
* Point it at a tenant plugin's field (e.g. 'tenant') when that plugin manages
|
|
32
|
+
* scoping for the collection.
|
|
33
|
+
*/
|
|
34
|
+
scopeField?: string;
|
|
35
|
+
overrides?: (collection: CollectionConfig) => CollectionConfig;
|
|
36
|
+
access?: Partial<CollectionConfig['access']>;
|
|
37
|
+
};
|
|
38
|
+
type ProvidersOptions = {
|
|
39
|
+
/** Opt-in admin collection storing runtime provider configurations. */collection?: boolean | ProvidersCollectionOptions;
|
|
40
|
+
resolve?: ProvidersResolve;
|
|
41
|
+
};
|
|
42
|
+
/** Access checker for cross-scope (platform) analytics reads. */
|
|
43
|
+
type PlatformReadAccess = (args: {
|
|
44
|
+
req: PayloadRequest;
|
|
45
|
+
}) => boolean | Promise<boolean>;
|
|
46
|
+
type AnalyticsAccessOptions = {
|
|
47
|
+
/**
|
|
48
|
+
* Gates cross-scope reads: explicit `scope: '*'` reads, and scoped reads through
|
|
49
|
+
* a platform adapter that cannot filter by scope. Defaults to any authenticated
|
|
50
|
+
* admin-panel user.
|
|
51
|
+
*/
|
|
52
|
+
platformRead?: PlatformReadAccess;
|
|
53
|
+
};
|
|
54
|
+
type AnalyticsPluginOptions = {
|
|
55
|
+
disabled?: boolean;
|
|
56
|
+
/**
|
|
57
|
+
* Per-locale overrides for this plugin's UI strings, keyed by the typed
|
|
58
|
+
* translation keys exported from `@10x-media/analytics/i18n`. Values win over
|
|
59
|
+
* the built-in locales key-by-key; locales the plugin does not ship are added
|
|
60
|
+
* whole. App-level `i18n.translations` still wins over both.
|
|
61
|
+
*/
|
|
62
|
+
translations?: TranslationsOption;
|
|
63
|
+
adapters?: AnalyticsAdapter[];
|
|
64
|
+
defaultAdapter?: string;
|
|
65
|
+
scopeResolver?: ScopeResolver;
|
|
66
|
+
providers?: ProvidersOptions;
|
|
67
|
+
/**
|
|
68
|
+
* Id of one config adapter shared by every scope (the platform's own analytics,
|
|
69
|
+
* e.g. a PostHog project capturing all tenants). Included in each scope's
|
|
70
|
+
* registry like any config adapter; reads through it are scope-filtered only
|
|
71
|
+
* when the adapter supports scoped queries, otherwise they are cross-scope and
|
|
72
|
+
* require `access.platformRead`.
|
|
73
|
+
*/
|
|
74
|
+
platformAdapter?: string;
|
|
75
|
+
access?: AnalyticsAccessOptions;
|
|
76
|
+
/**
|
|
77
|
+
* Per-collection bindings, keyed by collection slug. With generated types
|
|
78
|
+
* augmented, each slug's resolvers receive that collection's typed document.
|
|
79
|
+
*/
|
|
80
|
+
collections?: { [TSlug in CollectionSlug]?: AnalyticsBinding<TSlug> };
|
|
81
|
+
cache?: {
|
|
82
|
+
ttl?: {
|
|
83
|
+
aggregate?: number;
|
|
84
|
+
realtime?: number;
|
|
85
|
+
};
|
|
86
|
+
warm?: boolean | {
|
|
87
|
+
cron?: string;
|
|
88
|
+
};
|
|
89
|
+
};
|
|
90
|
+
widgets?: boolean | {
|
|
91
|
+
disabled?: string[];
|
|
92
|
+
register?: CustomWidgetDef[];
|
|
93
|
+
/**
|
|
94
|
+
* Marks the free-text widget config fields (each widget's Title) as
|
|
95
|
+
* `localized`. Off by default; takes effect only when the Payload config
|
|
96
|
+
* enables localization (Payload strips the flag otherwise).
|
|
97
|
+
*/
|
|
98
|
+
localizeText?: boolean;
|
|
99
|
+
};
|
|
100
|
+
/**
|
|
101
|
+
* Opt-in sync tier: a cron job that persists each provider's daily metrics into a
|
|
102
|
+
* queryable collection. Reads go through the surfacing cache, so persisted rows reflect
|
|
103
|
+
* cached values up to `cache.ttl.aggregate` old; keep that TTL below the sync interval
|
|
104
|
+
* for the freshest data.
|
|
105
|
+
*/
|
|
106
|
+
sync?: boolean | {
|
|
107
|
+
collectionSlug?: CollectionSlug;
|
|
108
|
+
cron?: string;
|
|
109
|
+
lookbackDays?: number;
|
|
110
|
+
adapters?: string[];
|
|
111
|
+
};
|
|
112
|
+
};
|
|
113
|
+
//#endregion
|
|
114
|
+
export { AnalyticsAccessOptions, AnalyticsPluginOptions, PlatformReadAccess, ProvidersCollectionOptions, ProvidersOptions, ProvidersResolve, ScopeResolver };
|
|
115
|
+
//# sourceMappingURL=options.d.ts.map
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { PROVIDERS_SLUG } from "../providers/collection.js";
|
|
2
|
+
//#region src/core/options.ts
|
|
3
|
+
const DEFAULT_WARM_CRON = "*/30 * * * *";
|
|
4
|
+
const DEFAULT_SYNC_CRON = "0 */6 * * *";
|
|
5
|
+
const DEFAULT_SYNC_COLLECTION = "analytics-daily";
|
|
6
|
+
const DEFAULT_SYNC_LOOKBACK = 3;
|
|
7
|
+
const DEFAULT_SCOPE_FIELD = "scope";
|
|
8
|
+
const resolveBindings = (collections) => {
|
|
9
|
+
const out = {};
|
|
10
|
+
for (const [slug, binding] of Object.entries(collections ?? {})) {
|
|
11
|
+
if (!binding) continue;
|
|
12
|
+
if (!binding.path && !binding.pathField) throw new Error(`analytics: binding for "${slug}" needs a path resolver or a pathField`);
|
|
13
|
+
out[slug] = binding;
|
|
14
|
+
}
|
|
15
|
+
return out;
|
|
16
|
+
};
|
|
17
|
+
function resolveOptions(options) {
|
|
18
|
+
if (!options.adapters || options.adapters.length === 0) throw new Error("analytics: at least one adapter is required");
|
|
19
|
+
if (options.platformAdapter !== void 0 && !options.adapters.some((a) => a.id === options.platformAdapter)) throw new Error(`analytics: unknown platform adapter "${options.platformAdapter}"`);
|
|
20
|
+
const widgets = options.widgets === false ? {
|
|
21
|
+
enabled: false,
|
|
22
|
+
disabled: [],
|
|
23
|
+
register: [],
|
|
24
|
+
localizeText: false
|
|
25
|
+
} : options.widgets === void 0 || options.widgets === true ? {
|
|
26
|
+
enabled: true,
|
|
27
|
+
disabled: [],
|
|
28
|
+
register: [],
|
|
29
|
+
localizeText: false
|
|
30
|
+
} : {
|
|
31
|
+
enabled: true,
|
|
32
|
+
disabled: options.widgets.disabled ?? [],
|
|
33
|
+
register: options.widgets.register ?? [],
|
|
34
|
+
localizeText: options.widgets.localizeText ?? false
|
|
35
|
+
};
|
|
36
|
+
const warmOpt = options.cache?.warm;
|
|
37
|
+
const warm = warmOpt === true ? {
|
|
38
|
+
enabled: true,
|
|
39
|
+
cron: DEFAULT_WARM_CRON
|
|
40
|
+
} : warmOpt && typeof warmOpt === "object" ? {
|
|
41
|
+
enabled: true,
|
|
42
|
+
cron: warmOpt.cron ?? DEFAULT_WARM_CRON
|
|
43
|
+
} : {
|
|
44
|
+
enabled: false,
|
|
45
|
+
cron: DEFAULT_WARM_CRON
|
|
46
|
+
};
|
|
47
|
+
const collectionOpt = options.providers?.collection;
|
|
48
|
+
const providers = {
|
|
49
|
+
collection: collectionOpt === true ? {
|
|
50
|
+
enabled: true,
|
|
51
|
+
slug: PROVIDERS_SLUG,
|
|
52
|
+
scopeField: DEFAULT_SCOPE_FIELD
|
|
53
|
+
} : collectionOpt && typeof collectionOpt === "object" ? {
|
|
54
|
+
enabled: true,
|
|
55
|
+
slug: collectionOpt.slug ?? "analytics-providers",
|
|
56
|
+
scopeField: collectionOpt.scopeField ?? DEFAULT_SCOPE_FIELD,
|
|
57
|
+
overrides: collectionOpt.overrides,
|
|
58
|
+
access: collectionOpt.access
|
|
59
|
+
} : {
|
|
60
|
+
enabled: false,
|
|
61
|
+
slug: PROVIDERS_SLUG,
|
|
62
|
+
scopeField: DEFAULT_SCOPE_FIELD
|
|
63
|
+
},
|
|
64
|
+
resolve: options.providers?.resolve
|
|
65
|
+
};
|
|
66
|
+
const syncOpt = options.sync;
|
|
67
|
+
const sync = syncOpt === true ? {
|
|
68
|
+
enabled: true,
|
|
69
|
+
collectionSlug: DEFAULT_SYNC_COLLECTION,
|
|
70
|
+
cron: DEFAULT_SYNC_CRON,
|
|
71
|
+
lookbackDays: DEFAULT_SYNC_LOOKBACK
|
|
72
|
+
} : syncOpt && typeof syncOpt === "object" ? {
|
|
73
|
+
enabled: true,
|
|
74
|
+
collectionSlug: syncOpt.collectionSlug ?? DEFAULT_SYNC_COLLECTION,
|
|
75
|
+
cron: syncOpt.cron ?? DEFAULT_SYNC_CRON,
|
|
76
|
+
lookbackDays: syncOpt.lookbackDays ?? DEFAULT_SYNC_LOOKBACK,
|
|
77
|
+
adapters: syncOpt.adapters
|
|
78
|
+
} : {
|
|
79
|
+
enabled: false,
|
|
80
|
+
collectionSlug: DEFAULT_SYNC_COLLECTION,
|
|
81
|
+
cron: DEFAULT_SYNC_CRON,
|
|
82
|
+
lookbackDays: DEFAULT_SYNC_LOOKBACK
|
|
83
|
+
};
|
|
84
|
+
return {
|
|
85
|
+
adapters: options.adapters,
|
|
86
|
+
defaultAdapter: options.defaultAdapter,
|
|
87
|
+
scopeResolver: options.scopeResolver ?? (() => null),
|
|
88
|
+
scoped: options.scopeResolver !== void 0,
|
|
89
|
+
platformAdapter: options.platformAdapter,
|
|
90
|
+
access: { platformRead: options.access?.platformRead ?? (({ req }) => Boolean(req.user)) },
|
|
91
|
+
providers,
|
|
92
|
+
bindings: resolveBindings(options.collections),
|
|
93
|
+
cache: {
|
|
94
|
+
ttl: {
|
|
95
|
+
aggregate: options.cache?.ttl?.aggregate ?? 3600,
|
|
96
|
+
realtime: options.cache?.ttl?.realtime ?? 300
|
|
97
|
+
},
|
|
98
|
+
warm
|
|
99
|
+
},
|
|
100
|
+
widgets,
|
|
101
|
+
sync
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
//#endregion
|
|
105
|
+
export { resolveOptions };
|
|
106
|
+
|
|
107
|
+
//# sourceMappingURL=options.js.map
|