@umituz/web-dashboard 8.11.0 → 9.0.0
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/README.md +54 -7
- package/package.json +6 -2
- package/src/config/DashboardConfig.ts +4 -8
- package/src/domains/analytics/components/AnalyticsLayout.test.tsx +85 -0
- package/src/domains/analytics/components/AnalyticsLayout.tsx +103 -105
- package/src/domains/analytics/components/index.ts +0 -3
- package/src/domains/analytics/hooks/index.ts +1 -1
- package/src/domains/analytics/hooks/useAnalytics.test.tsx +125 -0
- package/src/domains/analytics/hooks/useAnalytics.ts +37 -56
- package/src/domains/analytics/index.ts +9 -26
- package/src/domains/analytics/services/index.ts +0 -1
- package/src/domains/analytics/types/analytics.ts +32 -149
- package/src/domains/analytics/types/index.ts +3 -15
- package/src/domains/analytics/utils/analytics.test.ts +82 -13
- package/src/domains/analytics/utils/analytics.ts +52 -75
- package/src/domains/analytics/utils/index.ts +5 -8
- package/src/domains/charts/charts.css +455 -0
- package/src/domains/charts/components/ActivityHeatmap.test.tsx +48 -0
- package/src/domains/charts/components/ActivityHeatmap.tsx +58 -0
- package/src/domains/charts/components/BarChart.test.tsx +91 -0
- package/src/domains/charts/components/BarChart.tsx +143 -0
- package/src/domains/charts/components/ChartCard.tsx +39 -0
- package/src/domains/charts/components/ChartPrimitives.test.tsx +90 -0
- package/src/domains/charts/components/ChartTip.tsx +18 -0
- package/src/domains/charts/components/Donut.test.tsx +51 -0
- package/src/domains/charts/components/Donut.tsx +97 -0
- package/src/domains/charts/components/HBars.tsx +31 -0
- package/src/domains/charts/components/Legend.tsx +21 -0
- package/src/domains/charts/components/LineChart.test.tsx +81 -0
- package/src/domains/charts/components/LineChart.tsx +244 -0
- package/src/domains/charts/components/Sparkline.tsx +35 -0
- package/src/domains/charts/components/index.ts +16 -0
- package/src/domains/charts/index.ts +16 -2
- package/src/domains/charts/ssr.test.tsx +35 -0
- package/src/domains/charts/types/index.ts +8 -0
- package/src/domains/charts/utils.ts +15 -0
- package/src/index.ts +6 -23
- package/src/styles/chrome.css +10 -490
- package/src/styles/dashboard.contract.test.ts +20 -5
- package/src/styles/dashboard.css +1 -0
- package/src/domains/analytics/components/AnalyticsCard.tsx +0 -87
- package/src/domains/analytics/components/AnalyticsChart.tsx +0 -387
- package/src/domains/analytics/components/MetricCard.tsx +0 -42
- package/src/domains/analytics/services/AnalyticsEngineService.ts +0 -300
- package/src/domains/charts/components.test.tsx +0 -141
- package/src/domains/charts/components.tsx +0 -683
|
@@ -1,58 +1,39 @@
|
|
|
1
1
|
import { useState, useCallback, useEffect, useMemo, useRef } from "react";
|
|
2
|
+
import { presetRange } from "@umituz/web-design-system/organisms";
|
|
3
|
+
import type { DateRange } from "@umituz/web-design-system/organisms";
|
|
2
4
|
import type {
|
|
3
|
-
KPIs,
|
|
4
|
-
TimeSeriesData,
|
|
5
|
-
DateRangeValue,
|
|
6
5
|
AnalyticsExportOptions,
|
|
6
|
+
KpiDatum,
|
|
7
|
+
TimeSeriesDatum,
|
|
7
8
|
} from "../types/analytics";
|
|
8
9
|
|
|
9
10
|
export interface AnalyticsApiClient {
|
|
10
|
-
loadAnalytics: (range:
|
|
11
|
-
exportAnalytics
|
|
11
|
+
loadAnalytics: (range: DateRange) => Promise<AnalyticsPayload>;
|
|
12
|
+
exportAnalytics?: (payload: AnalyticsPayload, options: AnalyticsExportOptions) => Promise<Blob>;
|
|
12
13
|
}
|
|
13
14
|
|
|
14
|
-
export interface
|
|
15
|
-
kpis:
|
|
16
|
-
|
|
15
|
+
export interface AnalyticsPayload {
|
|
16
|
+
kpis: KpiDatum[];
|
|
17
|
+
series: TimeSeriesDatum[];
|
|
17
18
|
}
|
|
18
19
|
|
|
19
20
|
export interface UseAnalyticsOptions {
|
|
20
|
-
|
|
21
|
-
|
|
21
|
+
initialRange?: DateRange;
|
|
22
|
+
refreshInterval?: number;
|
|
22
23
|
apiClient: AnalyticsApiClient;
|
|
23
24
|
}
|
|
24
25
|
|
|
25
26
|
export interface UseAnalyticsReturn {
|
|
26
|
-
kpis:
|
|
27
|
-
|
|
27
|
+
kpis: KpiDatum[];
|
|
28
|
+
series: TimeSeriesDatum[];
|
|
28
29
|
isLoading: boolean;
|
|
29
30
|
error: string | null;
|
|
30
|
-
|
|
31
|
-
|
|
31
|
+
range: DateRange;
|
|
32
|
+
updateRange: (range: DateRange) => void;
|
|
32
33
|
refresh: () => Promise<void>;
|
|
33
34
|
exportData: (options: AnalyticsExportOptions) => Promise<void>;
|
|
34
35
|
}
|
|
35
36
|
|
|
36
|
-
const DEFAULT_RANGE_DAYS = 30;
|
|
37
|
-
const MS_PER_DAY = 24 * 60 * 60 * 1000;
|
|
38
|
-
|
|
39
|
-
const buildDefaultRange = (): DateRangeValue => {
|
|
40
|
-
const today = new Date();
|
|
41
|
-
const start = new Date(Date.now() - DEFAULT_RANGE_DAYS * MS_PER_DAY);
|
|
42
|
-
return {
|
|
43
|
-
from: start.toISOString().split("T")[0] as string,
|
|
44
|
-
to: today.toISOString().split("T")[0] as string,
|
|
45
|
-
};
|
|
46
|
-
};
|
|
47
|
-
|
|
48
|
-
const EMPTY_KPIS: KPIs = {
|
|
49
|
-
downloads: { current: 0, previous: 0, growth: 0 },
|
|
50
|
-
engagement: { current: 0, previous: 0, growth: 0 },
|
|
51
|
-
users: { current: 0, previous: 0, growth: 0 },
|
|
52
|
-
revenue: { current: 0, previous: 0, growth: 0 },
|
|
53
|
-
retention: { current: 0, previous: 0, growth: 0 },
|
|
54
|
-
};
|
|
55
|
-
|
|
56
37
|
const toErrorMessage = (err: unknown, fallback: string): string =>
|
|
57
38
|
err instanceof Error && err.message ? err.message : fallback;
|
|
58
39
|
|
|
@@ -60,27 +41,25 @@ const toError = (err: unknown, fallback: string): Error =>
|
|
|
60
41
|
err instanceof Error ? err : new Error(fallback);
|
|
61
42
|
|
|
62
43
|
export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
|
|
63
|
-
const {
|
|
44
|
+
const { initialRange, refreshInterval = 0, apiClient } = options;
|
|
64
45
|
|
|
65
|
-
const [
|
|
66
|
-
|
|
67
|
-
);
|
|
68
|
-
const [kpis, setKpis] = useState<KPIs>(EMPTY_KPIS);
|
|
69
|
-
const [timeSeries, setTimeSeries] = useState<TimeSeriesData[]>([]);
|
|
46
|
+
const [range, setRange] = useState<DateRange>(initialRange ?? presetRange("30d"));
|
|
47
|
+
const [kpis, setKpis] = useState<KpiDatum[]>([]);
|
|
48
|
+
const [series, setSeries] = useState<TimeSeriesDatum[]>([]);
|
|
70
49
|
const [isLoading, setIsLoading] = useState(false);
|
|
71
50
|
const [error, setError] = useState<string | null>(null);
|
|
72
51
|
|
|
73
|
-
|
|
52
|
+
const requestIdRef = useRef(0);
|
|
74
53
|
|
|
75
54
|
const refresh = useCallback(async () => {
|
|
76
55
|
const requestId = ++requestIdRef.current;
|
|
77
56
|
setIsLoading(true);
|
|
78
57
|
setError(null);
|
|
79
58
|
try {
|
|
80
|
-
const payload = await apiClient.loadAnalytics(
|
|
59
|
+
const payload = await apiClient.loadAnalytics(range);
|
|
81
60
|
if (requestIdRef.current === requestId) {
|
|
82
61
|
setKpis(payload.kpis);
|
|
83
|
-
|
|
62
|
+
setSeries(payload.series);
|
|
84
63
|
}
|
|
85
64
|
} catch (err) {
|
|
86
65
|
if (requestIdRef.current === requestId) {
|
|
@@ -91,34 +70,37 @@ export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
|
|
|
91
70
|
setIsLoading(false);
|
|
92
71
|
}
|
|
93
72
|
}
|
|
94
|
-
}, [apiClient,
|
|
73
|
+
}, [apiClient, range]);
|
|
95
74
|
|
|
96
|
-
const
|
|
97
|
-
|
|
75
|
+
const updateRange = useCallback((nextRange: DateRange) => {
|
|
76
|
+
setRange(nextRange);
|
|
98
77
|
}, []);
|
|
99
78
|
|
|
100
79
|
const exportData = useCallback(
|
|
101
80
|
async (exportOptions: AnalyticsExportOptions) => {
|
|
102
|
-
const
|
|
81
|
+
const exportAnalytics = apiClient.exportAnalytics;
|
|
82
|
+
if (!exportAnalytics) {
|
|
83
|
+
throw new Error('AnalyticsApiClient.exportAnalytics not configured');
|
|
84
|
+
}
|
|
85
|
+
const payload: AnalyticsPayload = { kpis, series };
|
|
103
86
|
try {
|
|
104
|
-
const blob = await
|
|
87
|
+
const blob = await exportAnalytics(payload, exportOptions);
|
|
105
88
|
|
|
106
89
|
const url = URL.createObjectURL(blob);
|
|
107
90
|
const link = document.createElement("a");
|
|
108
91
|
link.href = url;
|
|
109
92
|
link.download =
|
|
110
|
-
exportOptions.filename ?? `analytics-${
|
|
93
|
+
exportOptions.filename ?? `analytics-${range.from}-${range.to}.${exportOptions.format}`;
|
|
111
94
|
document.body.appendChild(link);
|
|
112
95
|
link.click();
|
|
113
96
|
document.body.removeChild(link);
|
|
114
97
|
URL.revokeObjectURL(url);
|
|
115
98
|
} catch (err) {
|
|
116
|
-
|
|
117
99
|
setError(toErrorMessage(err, 'Failed to export analytics'));
|
|
118
100
|
throw toError(err, 'Failed to export analytics');
|
|
119
101
|
}
|
|
120
102
|
},
|
|
121
|
-
[apiClient,
|
|
103
|
+
[apiClient, range.from, range.to, kpis, series],
|
|
122
104
|
);
|
|
123
105
|
|
|
124
106
|
useEffect(() => {
|
|
@@ -136,15 +118,15 @@ export function useAnalytics(options: UseAnalyticsOptions): UseAnalyticsReturn {
|
|
|
136
118
|
return useMemo(
|
|
137
119
|
() => ({
|
|
138
120
|
kpis,
|
|
139
|
-
|
|
121
|
+
series,
|
|
140
122
|
isLoading,
|
|
141
123
|
error,
|
|
142
|
-
|
|
143
|
-
|
|
124
|
+
range,
|
|
125
|
+
updateRange,
|
|
144
126
|
refresh,
|
|
145
127
|
exportData,
|
|
146
128
|
}),
|
|
147
|
-
[kpis,
|
|
129
|
+
[kpis, series, isLoading, error, range, updateRange, refresh, exportData],
|
|
148
130
|
);
|
|
149
131
|
}
|
|
150
132
|
|
|
@@ -153,7 +135,6 @@ export const createStubAnalyticsApiClient = (
|
|
|
153
135
|
): AnalyticsApiClient => {
|
|
154
136
|
const notConfigured: AnalyticsApiClient = {
|
|
155
137
|
loadAnalytics: () => Promise.reject(new Error('AnalyticsApiClient not configured')),
|
|
156
|
-
exportAnalytics: () => Promise.reject(new Error('AnalyticsApiClient not configured')),
|
|
157
138
|
};
|
|
158
139
|
return { ...notConfigured, ...overrides };
|
|
159
140
|
};
|
|
@@ -1,7 +1,4 @@
|
|
|
1
1
|
export {
|
|
2
|
-
MetricCard,
|
|
3
|
-
AnalyticsChart,
|
|
4
|
-
AnalyticsCard,
|
|
5
2
|
AnalyticsLayout,
|
|
6
3
|
} from "./components";
|
|
7
4
|
|
|
@@ -11,7 +8,7 @@ export {
|
|
|
11
8
|
} from "./hooks";
|
|
12
9
|
export type {
|
|
13
10
|
AnalyticsApiClient,
|
|
14
|
-
|
|
11
|
+
AnalyticsPayload,
|
|
15
12
|
UseAnalyticsOptions,
|
|
16
13
|
UseAnalyticsReturn,
|
|
17
14
|
} from "./hooks";
|
|
@@ -22,39 +19,25 @@ export {
|
|
|
22
19
|
formatCurrency,
|
|
23
20
|
calculateGrowth,
|
|
24
21
|
getTrend,
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
22
|
+
toKpiDelta,
|
|
23
|
+
toCsv,
|
|
24
|
+
downloadCsv,
|
|
25
|
+
exportCsv,
|
|
28
26
|
calculateConversionRate,
|
|
29
27
|
calculateDropOffRate,
|
|
30
|
-
createDateRangePreset,
|
|
31
|
-
getDateRangePresets,
|
|
32
28
|
aggregateByPeriod,
|
|
33
29
|
calculateMovingAverage,
|
|
34
30
|
detectOutliers,
|
|
35
31
|
roundTo,
|
|
36
|
-
generateColor,
|
|
37
|
-
generateChartColors,
|
|
38
32
|
} from "./utils";
|
|
33
|
+
export type { KpiDeltaLike } from "./utils";
|
|
39
34
|
|
|
40
35
|
export type {
|
|
41
|
-
|
|
36
|
+
KpiDatum,
|
|
37
|
+
TimeSeriesDatum,
|
|
42
38
|
TimeSeriesData,
|
|
43
|
-
|
|
44
|
-
FunnelStep,
|
|
45
|
-
FunnelData,
|
|
46
|
-
CohortAnalysis,
|
|
47
|
-
UserSegment,
|
|
48
|
-
KPIData,
|
|
49
|
-
KPIs,
|
|
50
|
-
ChartType,
|
|
51
|
-
ChartConfig,
|
|
52
|
-
MetricCardProps,
|
|
53
|
-
AnalyticsCardProps,
|
|
39
|
+
AnalyticsLayoutLabels,
|
|
54
40
|
AnalyticsLayoutProps,
|
|
55
|
-
AnalyticsPeriod,
|
|
56
|
-
AnalyticsConfig,
|
|
57
|
-
MetricConfig,
|
|
58
41
|
DateRangePreset,
|
|
59
42
|
DateRangeValue,
|
|
60
43
|
ExportFormat,
|
|
@@ -1,151 +1,52 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { ReactNode } from "react";
|
|
2
|
+
import type { DateRange, KpiIconTone, RangePreset } from "@umituz/web-design-system/organisms";
|
|
2
3
|
|
|
3
|
-
export interface
|
|
4
|
+
export interface KpiDatum {
|
|
4
5
|
id: string;
|
|
5
|
-
|
|
6
|
-
value: number;
|
|
6
|
+
label: string;
|
|
7
|
+
value: number | string;
|
|
7
8
|
previousValue?: number;
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
9
|
+
format?: (value: number) => string;
|
|
10
|
+
goodWhen?: "up" | "down";
|
|
11
|
+
hint?: string;
|
|
12
|
+
icon?: ReactNode;
|
|
13
|
+
iconTone?: KpiIconTone;
|
|
14
|
+
spark?: readonly number[];
|
|
15
|
+
onClick?: () => void;
|
|
11
16
|
}
|
|
12
17
|
|
|
13
|
-
export interface
|
|
18
|
+
export interface TimeSeriesDatum {
|
|
14
19
|
date: string;
|
|
15
20
|
[key: string]: string | number;
|
|
16
21
|
}
|
|
17
22
|
|
|
18
|
-
export
|
|
19
|
-
label: string;
|
|
20
|
-
value: number;
|
|
21
|
-
[key: string]: string | number | boolean;
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
export interface FunnelStep {
|
|
25
|
-
name: string;
|
|
26
|
-
count: number;
|
|
27
|
-
conversionRate: number;
|
|
28
|
-
dropOffRate: number;
|
|
29
|
-
averageTime?: number;
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
export interface FunnelData {
|
|
33
|
-
title: string;
|
|
34
|
-
steps: FunnelStep[];
|
|
35
|
-
totalUsers: number;
|
|
36
|
-
finalConversion: number;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
export interface CohortAnalysis {
|
|
40
|
-
cohort: string;
|
|
41
|
-
size: number;
|
|
42
|
-
retention: number[];
|
|
43
|
-
averageRetention: number;
|
|
44
|
-
}
|
|
45
|
-
|
|
46
|
-
export interface UserSegment {
|
|
47
|
-
name: string;
|
|
48
|
-
count: number;
|
|
49
|
-
percentage: number;
|
|
50
|
-
characteristics: string[];
|
|
51
|
-
behavior: {
|
|
52
|
-
avgSessionDuration: number;
|
|
53
|
-
pagesPerSession: number;
|
|
54
|
-
bounceRate: number;
|
|
55
|
-
};
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
export interface KPIData {
|
|
59
|
-
current: number;
|
|
60
|
-
previous: number;
|
|
61
|
-
growth: number;
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
export interface KPIs {
|
|
65
|
-
downloads: KPIData;
|
|
66
|
-
engagement: KPIData;
|
|
67
|
-
users: KPIData;
|
|
68
|
-
revenue: KPIData;
|
|
69
|
-
retention: KPIData;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
export type ChartType =
|
|
73
|
-
| "line"
|
|
74
|
-
| "bar"
|
|
75
|
-
| "area"
|
|
76
|
-
| "pie"
|
|
77
|
-
| "donut"
|
|
78
|
-
| "funnel"
|
|
79
|
-
| "heatmap"
|
|
80
|
-
| "metric"
|
|
81
|
-
| "table";
|
|
82
|
-
|
|
83
|
-
export interface ChartConfig {
|
|
84
|
-
id: string;
|
|
85
|
-
type: ChartType;
|
|
86
|
-
title?: string;
|
|
87
|
-
description?: string;
|
|
88
|
-
data: TimeSeriesData[] | ChartData[] | Metric[];
|
|
89
|
-
xAxisKey?: string;
|
|
90
|
-
yAxisKeys?: string[];
|
|
91
|
-
colors?: string[];
|
|
92
|
-
showLegend?: boolean;
|
|
93
|
-
showGrid?: boolean;
|
|
94
|
-
showTooltip?: boolean;
|
|
95
|
-
height?: number | string;
|
|
96
|
-
aspectRatio?: string;
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
export type AnalyticsPeriod = '7d' | '30d' | '90d' | '1y' | (string & {});
|
|
100
|
-
|
|
101
|
-
export interface MetricCardProps {
|
|
102
|
-
metric: Metric;
|
|
103
|
-
lastPeriodLabel?: string;
|
|
104
|
-
size?: "sm" | "md" | "lg";
|
|
105
|
-
showTrend?: boolean;
|
|
106
|
-
showIcon?: boolean;
|
|
107
|
-
className?: string;
|
|
108
|
-
onClick?: () => void;
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
export interface AnalyticsCardProps {
|
|
112
|
-
title?: string;
|
|
113
|
-
description?: string;
|
|
114
|
-
chart?: ChartConfig;
|
|
115
|
-
metrics?: Metric[];
|
|
116
|
-
size?: "sm" | "md" | "lg" | "full";
|
|
117
|
-
loading?: boolean;
|
|
118
|
-
error?: string;
|
|
119
|
-
className?: string;
|
|
120
|
-
children?: React.ReactNode;
|
|
121
|
-
}
|
|
23
|
+
export type TimeSeriesData = TimeSeriesDatum;
|
|
122
24
|
|
|
123
25
|
export interface AnalyticsLayoutLabels {
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
export: string;
|
|
129
|
-
loading: string;
|
|
26
|
+
refresh?: string;
|
|
27
|
+
export?: string;
|
|
28
|
+
retry?: string;
|
|
29
|
+
range?: string;
|
|
130
30
|
}
|
|
131
31
|
|
|
132
32
|
export interface AnalyticsLayoutProps {
|
|
133
|
-
|
|
134
|
-
labels: AnalyticsLayoutLabels;
|
|
135
|
-
title?: string;
|
|
33
|
+
title: string;
|
|
136
34
|
description?: string;
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
onPeriodChange?: (period: AnalyticsPeriod) => void;
|
|
141
|
-
showDateRange?: boolean;
|
|
142
|
-
showRefresh?: boolean;
|
|
143
|
-
showExport?: boolean;
|
|
144
|
-
charts?: ChartConfig[];
|
|
35
|
+
range?: DateRange;
|
|
36
|
+
onRangeChange?: (range: DateRange) => void;
|
|
37
|
+
presets?: readonly RangePreset[];
|
|
145
38
|
onRefresh?: () => void;
|
|
39
|
+
refreshing?: boolean;
|
|
146
40
|
onExport?: () => void;
|
|
147
|
-
|
|
148
|
-
|
|
41
|
+
kpis?: readonly KpiDatum[];
|
|
42
|
+
charts?: ReactNode;
|
|
43
|
+
filters?: ReactNode;
|
|
44
|
+
loading?: boolean;
|
|
45
|
+
error?: string | null;
|
|
46
|
+
onRetry?: () => void;
|
|
47
|
+
children?: ReactNode;
|
|
48
|
+
className?: string;
|
|
49
|
+
labels?: AnalyticsLayoutLabels;
|
|
149
50
|
}
|
|
150
51
|
|
|
151
52
|
export interface DateRangePreset {
|
|
@@ -171,21 +72,3 @@ export interface AnalyticsExportOptions {
|
|
|
171
72
|
dateRange?: DateRangeValue;
|
|
172
73
|
filename?: string;
|
|
173
74
|
}
|
|
174
|
-
|
|
175
|
-
export interface AnalyticsConfig {
|
|
176
|
-
brandName: string;
|
|
177
|
-
defaultPeriod?: string;
|
|
178
|
-
availablePeriods?: string[];
|
|
179
|
-
showExport?: boolean;
|
|
180
|
-
showRefresh?: boolean;
|
|
181
|
-
enableRealTime?: boolean;
|
|
182
|
-
metrics?: MetricConfig[];
|
|
183
|
-
}
|
|
184
|
-
|
|
185
|
-
export interface MetricConfig {
|
|
186
|
-
id: string;
|
|
187
|
-
name: string;
|
|
188
|
-
unit?: string;
|
|
189
|
-
icon?: string;
|
|
190
|
-
}
|
|
191
|
-
|
|
@@ -1,21 +1,9 @@
|
|
|
1
1
|
export type {
|
|
2
|
-
|
|
2
|
+
KpiDatum,
|
|
3
|
+
TimeSeriesDatum,
|
|
3
4
|
TimeSeriesData,
|
|
4
|
-
|
|
5
|
-
FunnelStep,
|
|
6
|
-
FunnelData,
|
|
7
|
-
CohortAnalysis,
|
|
8
|
-
UserSegment,
|
|
9
|
-
KPIData,
|
|
10
|
-
KPIs,
|
|
11
|
-
ChartType,
|
|
12
|
-
ChartConfig,
|
|
13
|
-
MetricCardProps,
|
|
14
|
-
AnalyticsCardProps,
|
|
5
|
+
AnalyticsLayoutLabels,
|
|
15
6
|
AnalyticsLayoutProps,
|
|
16
|
-
AnalyticsPeriod,
|
|
17
|
-
AnalyticsConfig,
|
|
18
|
-
MetricConfig,
|
|
19
7
|
DateRangePreset,
|
|
20
8
|
DateRangeValue,
|
|
21
9
|
ExportFormat,
|
|
@@ -1,17 +1,20 @@
|
|
|
1
|
-
import { describe, it, expect } from "vitest";
|
|
1
|
+
import { afterEach, describe, it, expect, vi } from "vitest";
|
|
2
2
|
import {
|
|
3
3
|
formatNumber,
|
|
4
4
|
formatPercentage,
|
|
5
5
|
formatCurrency,
|
|
6
6
|
calculateGrowth,
|
|
7
7
|
getTrend,
|
|
8
|
+
toKpiDelta,
|
|
9
|
+
toCsv,
|
|
10
|
+
downloadCsv,
|
|
11
|
+
exportCsv,
|
|
8
12
|
calculateConversionRate,
|
|
9
13
|
calculateDropOffRate,
|
|
10
14
|
calculateMovingAverage,
|
|
11
15
|
detectOutliers,
|
|
12
16
|
aggregateByPeriod,
|
|
13
17
|
roundTo,
|
|
14
|
-
createDateRangePreset,
|
|
15
18
|
} from "./analytics";
|
|
16
19
|
|
|
17
20
|
describe("formatNumber", () => {
|
|
@@ -82,6 +85,68 @@ describe("getTrend", () => {
|
|
|
82
85
|
});
|
|
83
86
|
});
|
|
84
87
|
|
|
88
|
+
describe("toKpiDelta", () => {
|
|
89
|
+
it("returns undefined without a usable previous value", () => {
|
|
90
|
+
expect(toKpiDelta(5)).toBeUndefined();
|
|
91
|
+
expect(toKpiDelta(5, 0)).toBeUndefined();
|
|
92
|
+
expect(toKpiDelta("not-a-number", 10)).toBeUndefined();
|
|
93
|
+
});
|
|
94
|
+
|
|
95
|
+
it("computes an up delta and marks it good by default", () => {
|
|
96
|
+
expect(toKpiDelta(120, 100)).toEqual({ value: "+20.0%", direction: "up", good: true });
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
it("marks a down delta bad by default and good when goodWhen is down", () => {
|
|
100
|
+
expect(toKpiDelta(80, 100)).toEqual({ value: "-20.0%", direction: "down", good: false });
|
|
101
|
+
expect(toKpiDelta(80, 100, "down")).toEqual({ value: "-20.0%", direction: "down", good: true });
|
|
102
|
+
});
|
|
103
|
+
|
|
104
|
+
it("goes flat under a 0.05% change", () => {
|
|
105
|
+
expect(toKpiDelta(100.01, 100)).toEqual({ value: "0.0%", direction: "flat", good: true });
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
it("accepts numeric strings", () => {
|
|
109
|
+
expect(toKpiDelta("110", 100)).toEqual({ value: "+10.0%", direction: "up", good: true });
|
|
110
|
+
});
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
describe("toCsv", () => {
|
|
114
|
+
it("joins headers and rows with a BOM and CRLF line endings", () => {
|
|
115
|
+
expect(toCsv(["a", "b"], [[1, 2], [3, 4]])).toBe("a,b\r\n1,2\r\n3,4");
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
it("quotes cells containing commas, quotes, newlines or semicolons", () => {
|
|
119
|
+
expect(toCsv(["Name", "Note"], [["A", "has, comma"]])).toBe(
|
|
120
|
+
'Name,Note\r\nA,"has, comma"',
|
|
121
|
+
);
|
|
122
|
+
expect(toCsv(["q"], [['say "hi"']])).toBe('q\r\n"say ""hi"""');
|
|
123
|
+
expect(toCsv(["s"], [["a;b"]])).toBe('s\r\n"a;b"');
|
|
124
|
+
expect(toCsv(["n"], [["l1\nl2"]])).toBe('n\r\n"l1\nl2"');
|
|
125
|
+
});
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
describe("downloadCsv / exportCsv", () => {
|
|
129
|
+
afterEach(() => {
|
|
130
|
+
vi.restoreAllMocks();
|
|
131
|
+
});
|
|
132
|
+
|
|
133
|
+
it("triggers a browser download and revokes the object url", () => {
|
|
134
|
+
const createObjectURL = vi.fn(() => "blob:csv");
|
|
135
|
+
const revokeObjectURL = vi.fn();
|
|
136
|
+
Object.defineProperty(URL, "createObjectURL", { value: createObjectURL, configurable: true });
|
|
137
|
+
Object.defineProperty(URL, "revokeObjectURL", { value: revokeObjectURL, configurable: true });
|
|
138
|
+
const click = vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => {});
|
|
139
|
+
|
|
140
|
+
exportCsv({ filename: "report.csv", headers: ["a"], rows: [[1]] });
|
|
141
|
+
|
|
142
|
+
expect(click).toHaveBeenCalledTimes(1);
|
|
143
|
+
expect(revokeObjectURL).toHaveBeenCalledWith("blob:csv");
|
|
144
|
+
|
|
145
|
+
downloadCsv("x.csv", "a");
|
|
146
|
+
expect(click).toHaveBeenCalledTimes(2);
|
|
147
|
+
});
|
|
148
|
+
});
|
|
149
|
+
|
|
85
150
|
describe("calculateConversionRate", () => {
|
|
86
151
|
it("returns 0 for an empty total", () => {
|
|
87
152
|
expect(calculateConversionRate(5, 0)).toBe(0);
|
|
@@ -146,6 +211,21 @@ describe("aggregateByPeriod", () => {
|
|
|
146
211
|
]);
|
|
147
212
|
});
|
|
148
213
|
|
|
214
|
+
it("groups by the Sunday-starting week key", () => {
|
|
215
|
+
const result = aggregateByPeriod(
|
|
216
|
+
[
|
|
217
|
+
{ date: "2026-01-01", value: 1 },
|
|
218
|
+
{ date: "2026-01-02", value: 2 },
|
|
219
|
+
{ date: "2026-01-04", value: 3 },
|
|
220
|
+
],
|
|
221
|
+
"week",
|
|
222
|
+
);
|
|
223
|
+
expect(result).toEqual([
|
|
224
|
+
{ date: "2025-12-28", value: 3 },
|
|
225
|
+
{ date: "2026-01-04", value: 3 },
|
|
226
|
+
]);
|
|
227
|
+
});
|
|
228
|
+
|
|
149
229
|
it("groups by month key when period is month", () => {
|
|
150
230
|
const result = aggregateByPeriod(
|
|
151
231
|
[
|
|
@@ -163,14 +243,3 @@ describe("roundTo", () => {
|
|
|
163
243
|
expect(roundTo(3.14159, 2)).toBe(3.14);
|
|
164
244
|
});
|
|
165
245
|
});
|
|
166
|
-
|
|
167
|
-
describe("createDateRangePreset", () => {
|
|
168
|
-
it("resolves from/to dates around today", () => {
|
|
169
|
-
const preset = createDateRangePreset("Last 7 Days", 7);
|
|
170
|
-
const today = new Date().toISOString().split("T")[0];
|
|
171
|
-
expect(preset.value).toBe("last-7-days");
|
|
172
|
-
expect(preset.to).toBe(today);
|
|
173
|
-
expect(preset.from).toBeDefined();
|
|
174
|
-
expect(preset.from).not.toBe(preset.to);
|
|
175
|
-
});
|
|
176
|
-
});
|