@x12i/countex 1.0.0 → 1.2.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 +192 -3
- package/dist/backup/export.d.ts +2 -0
- package/dist/backup/export.d.ts.map +1 -1
- package/dist/backup/export.js +2 -0
- package/dist/backup/export.js.map +1 -1
- package/dist/cli.d.ts +12 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +190 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/buffer.d.ts +4 -3
- package/dist/core/buffer.d.ts.map +1 -1
- package/dist/core/buffer.js +65 -9
- package/dist/core/buffer.js.map +1 -1
- package/dist/core/countex.d.ts.map +1 -1
- package/dist/core/countex.js +30 -3
- package/dist/core/countex.js.map +1 -1
- package/dist/core/extraction.d.ts +14 -2
- package/dist/core/extraction.d.ts.map +1 -1
- package/dist/core/extraction.js +117 -1
- package/dist/core/extraction.js.map +1 -1
- package/dist/core/mapping.d.ts.map +1 -1
- package/dist/core/mapping.js +44 -1
- package/dist/core/mapping.js.map +1 -1
- package/dist/core/timeframe.d.ts +7 -0
- package/dist/core/timeframe.d.ts.map +1 -1
- package/dist/core/timeframe.js +88 -0
- package/dist/core/timeframe.js.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/insights/advisors/fanout-health.d.ts +3 -0
- package/dist/insights/advisors/fanout-health.d.ts.map +1 -0
- package/dist/insights/advisors/fanout-health.js +3 -0
- package/dist/insights/advisors/fanout-health.js.map +1 -0
- package/dist/insights/advisors/map-health.d.ts +6 -0
- package/dist/insights/advisors/map-health.d.ts.map +1 -0
- package/dist/insights/advisors/map-health.js +154 -0
- package/dist/insights/advisors/map-health.js.map +1 -0
- package/dist/insights/advisors/resource-advisor.d.ts +4 -0
- package/dist/insights/advisors/resource-advisor.d.ts.map +1 -0
- package/dist/insights/advisors/resource-advisor.js +102 -0
- package/dist/insights/advisors/resource-advisor.js.map +1 -0
- package/dist/insights/advisors/retention-advisor.d.ts +2 -0
- package/dist/insights/advisors/retention-advisor.d.ts.map +1 -0
- package/dist/insights/advisors/retention-advisor.js +6 -0
- package/dist/insights/advisors/retention-advisor.js.map +1 -0
- package/dist/insights/advisors-subpath.d.ts +4 -0
- package/dist/insights/advisors-subpath.d.ts.map +1 -0
- package/dist/insights/advisors-subpath.js +10 -0
- package/dist/insights/advisors-subpath.js.map +1 -0
- package/dist/insights/anomaly/baseline.d.ts +4 -0
- package/dist/insights/anomaly/baseline.d.ts.map +1 -0
- package/dist/insights/anomaly/baseline.js +54 -0
- package/dist/insights/anomaly/baseline.js.map +1 -0
- package/dist/insights/anomaly/detect-anomalies.d.ts +6 -0
- package/dist/insights/anomaly/detect-anomalies.d.ts.map +1 -0
- package/dist/insights/anomaly/detect-anomalies.js +245 -0
- package/dist/insights/anomaly/detect-anomalies.js.map +1 -0
- package/dist/insights/anomaly/ewma.d.ts +2 -0
- package/dist/insights/anomaly/ewma.d.ts.map +1 -0
- package/dist/insights/anomaly/ewma.js +15 -0
- package/dist/insights/anomaly/ewma.js.map +1 -0
- package/dist/insights/anomaly/missing-activity.d.ts +3 -0
- package/dist/insights/anomaly/missing-activity.d.ts.map +1 -0
- package/dist/insights/anomaly/missing-activity.js +8 -0
- package/dist/insights/anomaly/missing-activity.js.map +1 -0
- package/dist/insights/anomaly/robust-zscore.d.ts +2 -0
- package/dist/insights/anomaly/robust-zscore.d.ts.map +1 -0
- package/dist/insights/anomaly/robust-zscore.js +9 -0
- package/dist/insights/anomaly/robust-zscore.js.map +1 -0
- package/dist/insights/anomaly-subpath.d.ts +7 -0
- package/dist/insights/anomaly-subpath.d.ts.map +1 -0
- package/dist/insights/anomaly-subpath.js +20 -0
- package/dist/insights/anomaly-subpath.js.map +1 -0
- package/dist/insights/comparison/compare-periods.d.ts +5 -0
- package/dist/insights/comparison/compare-periods.d.ts.map +1 -0
- package/dist/insights/comparison/compare-periods.js +64 -0
- package/dist/insights/comparison/compare-periods.js.map +1 -0
- package/dist/insights/comparison/growth-rate.d.ts +3 -0
- package/dist/insights/comparison/growth-rate.d.ts.map +1 -0
- package/dist/insights/comparison/growth-rate.js +3 -0
- package/dist/insights/comparison/growth-rate.js.map +1 -0
- package/dist/insights/comparison/moving-average.d.ts +2 -0
- package/dist/insights/comparison/moving-average.d.ts.map +1 -0
- package/dist/insights/comparison/moving-average.js +6 -0
- package/dist/insights/comparison/moving-average.js.map +1 -0
- package/dist/insights/comparison/trend.d.ts +5 -0
- package/dist/insights/comparison/trend.d.ts.map +1 -0
- package/dist/insights/comparison/trend.js +84 -0
- package/dist/insights/comparison/trend.js.map +1 -0
- package/dist/insights/errors.d.ts +25 -0
- package/dist/insights/errors.d.ts.map +1 -0
- package/dist/insights/errors.js +54 -0
- package/dist/insights/errors.js.map +1 -0
- package/dist/insights/forecast/budget.d.ts +2 -0
- package/dist/insights/forecast/budget.d.ts.map +1 -0
- package/dist/insights/forecast/budget.js +6 -0
- package/dist/insights/forecast/budget.js.map +1 -0
- package/dist/insights/forecast/capacity.d.ts +2 -0
- package/dist/insights/forecast/capacity.d.ts.map +1 -0
- package/dist/insights/forecast/capacity.js +3 -0
- package/dist/insights/forecast/capacity.js.map +1 -0
- package/dist/insights/forecast/forecast.d.ts +5 -0
- package/dist/insights/forecast/forecast.d.ts.map +1 -0
- package/dist/insights/forecast/forecast.js +103 -0
- package/dist/insights/forecast/forecast.js.map +1 -0
- package/dist/insights/forecast/retention.d.ts +2 -0
- package/dist/insights/forecast/retention.d.ts.map +1 -0
- package/dist/insights/forecast/retention.js +3 -0
- package/dist/insights/forecast/retention.js.map +1 -0
- package/dist/insights/index.d.ts +4 -0
- package/dist/insights/index.d.ts.map +1 -0
- package/dist/insights/index.js +23 -0
- package/dist/insights/index.js.map +1 -0
- package/dist/insights/insights-client.d.ts +33 -0
- package/dist/insights/insights-client.d.ts.map +1 -0
- package/dist/insights/insights-client.js +344 -0
- package/dist/insights/insights-client.js.map +1 -0
- package/dist/insights/llm-subpath.d.ts +4 -0
- package/dist/insights/llm-subpath.d.ts.map +1 -0
- package/dist/insights/llm-subpath.js +10 -0
- package/dist/insights/llm-subpath.js.map +1 -0
- package/dist/insights/optimization/cost-optimizer.d.ts +6 -0
- package/dist/insights/optimization/cost-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/cost-optimizer.js +98 -0
- package/dist/insights/optimization/cost-optimizer.js.map +1 -0
- package/dist/insights/optimization/latency-optimizer.d.ts +3 -0
- package/dist/insights/optimization/latency-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/latency-optimizer.js +3 -0
- package/dist/insights/optimization/latency-optimizer.js.map +1 -0
- package/dist/insights/optimization/threshold-advisor.d.ts +2 -0
- package/dist/insights/optimization/threshold-advisor.d.ts.map +1 -0
- package/dist/insights/optimization/threshold-advisor.js +3 -0
- package/dist/insights/optimization/threshold-advisor.js.map +1 -0
- package/dist/insights/optimization/token-optimizer.d.ts +4 -0
- package/dist/insights/optimization/token-optimizer.d.ts.map +1 -0
- package/dist/insights/optimization/token-optimizer.js +133 -0
- package/dist/insights/optimization/token-optimizer.js.map +1 -0
- package/dist/insights/ranking/contribution.d.ts +2 -0
- package/dist/insights/ranking/contribution.d.ts.map +1 -0
- package/dist/insights/ranking/contribution.js +6 -0
- package/dist/insights/ranking/contribution.js.map +1 -0
- package/dist/insights/ranking/helpers.d.ts +22 -0
- package/dist/insights/ranking/helpers.d.ts.map +1 -0
- package/dist/insights/ranking/helpers.js +88 -0
- package/dist/insights/ranking/helpers.js.map +1 -0
- package/dist/insights/ranking/pareto.d.ts +2 -0
- package/dist/insights/ranking/pareto.d.ts.map +1 -0
- package/dist/insights/ranking/pareto.js +6 -0
- package/dist/insights/ranking/pareto.js.map +1 -0
- package/dist/insights/ranking/slices.d.ts +2 -0
- package/dist/insights/ranking/slices.d.ts.map +1 -0
- package/dist/insights/ranking/slices.js +6 -0
- package/dist/insights/ranking/slices.js.map +1 -0
- package/dist/insights/ranking/top-bottom.d.ts +2 -0
- package/dist/insights/ranking/top-bottom.d.ts.map +1 -0
- package/dist/insights/ranking/top-bottom.js +7 -0
- package/dist/insights/ranking/top-bottom.js.map +1 -0
- package/dist/insights/recommendations/evidence.d.ts +2 -0
- package/dist/insights/recommendations/evidence.d.ts.map +1 -0
- package/dist/insights/recommendations/evidence.js +3 -0
- package/dist/insights/recommendations/evidence.js.map +1 -0
- package/dist/insights/recommendations/recommendation.d.ts +6 -0
- package/dist/insights/recommendations/recommendation.d.ts.map +1 -0
- package/dist/insights/recommendations/recommendation.js +25 -0
- package/dist/insights/recommendations/recommendation.js.map +1 -0
- package/dist/insights/recommendations/severity.d.ts +2 -0
- package/dist/insights/recommendations/severity.d.ts.map +1 -0
- package/dist/insights/recommendations/severity.js +3 -0
- package/dist/insights/recommendations/severity.js.map +1 -0
- package/dist/insights/rules/evaluate-rules.d.ts +5 -0
- package/dist/insights/rules/evaluate-rules.d.ts.map +1 -0
- package/dist/insights/rules/evaluate-rules.js +156 -0
- package/dist/insights/rules/evaluate-rules.js.map +1 -0
- package/dist/insights/types.d.ts +405 -0
- package/dist/insights/types.d.ts.map +1 -0
- package/dist/insights/types.js +3 -0
- package/dist/insights/types.js.map +1 -0
- package/dist/insights/utils/formatting.d.ts +4 -0
- package/dist/insights/utils/formatting.d.ts.map +1 -0
- package/dist/insights/utils/formatting.js +21 -0
- package/dist/insights/utils/formatting.js.map +1 -0
- package/dist/insights/utils/grouping.d.ts +2 -0
- package/dist/insights/utils/grouping.d.ts.map +1 -0
- package/dist/insights/utils/grouping.js +8 -0
- package/dist/insights/utils/grouping.js.map +1 -0
- package/dist/insights/utils/query-builder.d.ts +21 -0
- package/dist/insights/utils/query-builder.d.ts.map +1 -0
- package/dist/insights/utils/query-builder.js +107 -0
- package/dist/insights/utils/query-builder.js.map +1 -0
- package/dist/insights/utils/row-value.d.ts +5 -0
- package/dist/insights/utils/row-value.d.ts.map +1 -0
- package/dist/insights/utils/row-value.js +36 -0
- package/dist/insights/utils/row-value.js.map +1 -0
- package/dist/insights/utils/stats.d.ts +28 -0
- package/dist/insights/utils/stats.d.ts.map +1 -0
- package/dist/insights/utils/stats.js +125 -0
- package/dist/insights/utils/stats.js.map +1 -0
- package/dist/query/formatter.d.ts.map +1 -1
- package/dist/query/formatter.js +202 -24
- package/dist/query/formatter.js.map +1 -1
- package/dist/query/planner.d.ts +10 -2
- package/dist/query/planner.d.ts.map +1 -1
- package/dist/query/planner.js +39 -2
- package/dist/query/planner.js.map +1 -1
- package/dist/storage/memory.d.ts.map +1 -1
- package/dist/storage/memory.js +78 -4
- package/dist/storage/memory.js.map +1 -1
- package/dist/storage/mongo.d.ts.map +1 -1
- package/dist/storage/mongo.js +61 -16
- package/dist/storage/mongo.js.map +1 -1
- package/dist/storage/redis.d.ts +6 -7
- package/dist/storage/redis.d.ts.map +1 -1
- package/dist/storage/redis.js +108 -39
- package/dist/storage/redis.js.map +1 -1
- package/dist/types/index.d.ts +88 -4
- package/dist/types/index.d.ts.map +1 -1
- package/docs/INSIGHTS.md +59 -0
- package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -0
- package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -0
- package/docs/INSIGHTS_RESOURCE_ADVISOR.md +31 -0
- package/docs/guides/README.md +29 -0
- package/docs/guides/adapter-memory.md +48 -0
- package/docs/guides/adapter-mongo.md +50 -0
- package/docs/guides/adapter-redis.md +47 -0
- package/docs/guides/backup-export.md +39 -0
- package/docs/guides/cardinality.md +50 -0
- package/docs/guides/cli.md +45 -0
- package/docs/guides/client-events.md +49 -0
- package/docs/guides/counter-maps.md +116 -0
- package/docs/guides/idempotency.md +39 -0
- package/docs/guides/ingestion-and-flush.md +67 -0
- package/docs/guides/insights-advisors-and-optimization.md +39 -0
- package/docs/guides/insights-anomalies-and-rules.md +48 -0
- package/docs/guides/insights-comparison-and-trends.md +47 -0
- package/docs/guides/insights-forecasting-and-budget.md +61 -0
- package/docs/guides/insights-overview.md +76 -0
- package/docs/guides/insights-ranking.md +81 -0
- package/docs/guides/measures.md +67 -0
- package/docs/guides/querying.md +79 -0
- package/docs/guides/timeframes-and-bucketing.md +55 -0
- package/docs/internals/README.md +20 -0
- package/docs/internals/internal-architecture-overview.md +65 -0
- package/docs/internals/internal-backup-stream.md +23 -0
- package/docs/internals/internal-buffer-merge-and-flush.md +51 -0
- package/docs/internals/internal-cardinality.md +30 -0
- package/docs/internals/internal-idempotency.md +36 -0
- package/docs/internals/internal-ingest-pipeline.md +52 -0
- package/docs/internals/internal-insights-layer.md +36 -0
- package/docs/internals/internal-mapping-validation-and-extraction.md +59 -0
- package/docs/internals/internal-measures-and-scales.md +35 -0
- package/docs/internals/internal-query-path.md +46 -0
- package/docs/internals/internal-storage-memory.md +13 -0
- package/docs/internals/internal-storage-mongo.md +24 -0
- package/docs/internals/internal-storage-redis.md +31 -0
- package/docs/internals/internal-timeframe-bucketing.md +33 -0
- package/package.json +45 -2
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.anomaliesFromTimeseries = anomaliesFromTimeseries;
|
|
4
|
+
exports.resolveBaselineTimeframe = resolveBaselineTimeframe;
|
|
5
|
+
const stats_js_1 = require("../utils/stats.js");
|
|
6
|
+
const formatting_js_1 = require("../utils/formatting.js");
|
|
7
|
+
const timeframe_js_1 = require("../../core/timeframe.js");
|
|
8
|
+
const baseline_js_1 = require("./baseline.js");
|
|
9
|
+
const missing_activity_js_1 = require("./missing-activity.js");
|
|
10
|
+
function tsValue(pt, parsed) {
|
|
11
|
+
if (parsed.kind === "count")
|
|
12
|
+
return pt.count;
|
|
13
|
+
if (parsed.kind === "rate")
|
|
14
|
+
return pt.rate ?? 0;
|
|
15
|
+
const m = pt.measures?.[parsed.name];
|
|
16
|
+
if (!m)
|
|
17
|
+
return 0;
|
|
18
|
+
switch (parsed.agg) {
|
|
19
|
+
case "sum":
|
|
20
|
+
return m.sum ?? 0;
|
|
21
|
+
case "count":
|
|
22
|
+
return m.count ?? 0;
|
|
23
|
+
case "min":
|
|
24
|
+
return m.min ?? 0;
|
|
25
|
+
case "max":
|
|
26
|
+
return m.max ?? 0;
|
|
27
|
+
case "avg":
|
|
28
|
+
if (m.avg !== undefined)
|
|
29
|
+
return m.avg;
|
|
30
|
+
if (m.sum !== undefined && m.count !== undefined && m.count !== 0)
|
|
31
|
+
return m.sum / m.count;
|
|
32
|
+
return 0;
|
|
33
|
+
default:
|
|
34
|
+
return 0;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
function seriesKey(pt) {
|
|
38
|
+
return (0, formatting_js_1.stableSerializedGroupKeys)(pt.keys);
|
|
39
|
+
}
|
|
40
|
+
function filterBaselineByCompare(pts, evalKey, compareBy, evalTfType) {
|
|
41
|
+
if (compareBy === "same-hour-of-day" && evalTfType !== "all") {
|
|
42
|
+
const evalDate = (0, timeframe_js_1.parseBucket)(evalTfType, evalKey);
|
|
43
|
+
const eh = evalDate.getUTCHours();
|
|
44
|
+
return pts.filter((p) => (0, timeframe_js_1.parseBucket)(evalTfType, p.timeframeKey).getUTCHours() === eh);
|
|
45
|
+
}
|
|
46
|
+
if (compareBy === "same-day-of-week" && evalTfType !== "all") {
|
|
47
|
+
const evalDate = (0, timeframe_js_1.parseBucket)(evalTfType, evalKey);
|
|
48
|
+
const ed = evalDate.getUTCDay();
|
|
49
|
+
return pts.filter((p) => (0, timeframe_js_1.parseBucket)(evalTfType, p.timeframeKey).getUTCDay() === ed);
|
|
50
|
+
}
|
|
51
|
+
return pts;
|
|
52
|
+
}
|
|
53
|
+
function severityFromZ(z, threshold) {
|
|
54
|
+
const a = Math.abs(z);
|
|
55
|
+
if (a >= threshold + 2)
|
|
56
|
+
return "critical";
|
|
57
|
+
if (a >= threshold + 1)
|
|
58
|
+
return "high";
|
|
59
|
+
if (a >= threshold)
|
|
60
|
+
return "medium";
|
|
61
|
+
return "low";
|
|
62
|
+
}
|
|
63
|
+
function anomaliesFromTimeseries(evalPts, baselinePts, parsed, input, minBaselineBuckets) {
|
|
64
|
+
const method = input.method ?? "robust-zscore";
|
|
65
|
+
const sensitivity = input.sensitivity ?? "medium";
|
|
66
|
+
const threshold = (0, stats_js_1.zScoreThreshold)(sensitivity);
|
|
67
|
+
const compareBy = input.baseline?.compareBy ?? "rolling";
|
|
68
|
+
const types = input.anomalyTypes ?? ["spike", "drop", "missing"];
|
|
69
|
+
const minExpected = sensitivity === "high" ? 1 : sensitivity === "medium" ? 5 : 10;
|
|
70
|
+
const evalClusters = new Map();
|
|
71
|
+
for (const p of evalPts) {
|
|
72
|
+
const k = seriesKey(p);
|
|
73
|
+
const arr = evalClusters.get(k) ?? [];
|
|
74
|
+
arr.push(p);
|
|
75
|
+
evalClusters.set(k, arr);
|
|
76
|
+
}
|
|
77
|
+
const baselineClusters = new Map();
|
|
78
|
+
for (const p of baselinePts) {
|
|
79
|
+
const k = seriesKey(p);
|
|
80
|
+
const arr = baselineClusters.get(k) ?? [];
|
|
81
|
+
arr.push(p);
|
|
82
|
+
baselineClusters.set(k, arr);
|
|
83
|
+
}
|
|
84
|
+
const out = [];
|
|
85
|
+
for (const [keyStr, series] of evalClusters) {
|
|
86
|
+
series.sort((a, b) => (a.timeframeKey < b.timeframeKey ? -1 : 1));
|
|
87
|
+
const baseRaw = baselineClusters.get(keyStr) ?? [];
|
|
88
|
+
for (const pt of series) {
|
|
89
|
+
const observed = tsValue(pt, parsed);
|
|
90
|
+
const pool = filterBaselineByCompare(baseRaw, pt.timeframeKey, compareBy, input.timeframe.type).map((p) => tsValue(p, parsed));
|
|
91
|
+
if (pool.length < minBaselineBuckets)
|
|
92
|
+
continue;
|
|
93
|
+
if (method === "robust-zscore" || method === "zscore") {
|
|
94
|
+
let z;
|
|
95
|
+
let median;
|
|
96
|
+
let mad = 0;
|
|
97
|
+
let mean = 0;
|
|
98
|
+
let stddev = 0;
|
|
99
|
+
if (method === "robust-zscore") {
|
|
100
|
+
const r = (0, stats_js_1.robustZScore)(observed, pool);
|
|
101
|
+
z = r.z;
|
|
102
|
+
median = r.median;
|
|
103
|
+
mad = r.mad;
|
|
104
|
+
}
|
|
105
|
+
else {
|
|
106
|
+
mean = pool.reduce((a, b) => a + b, 0) / pool.length;
|
|
107
|
+
stddev = Math.sqrt(pool.reduce((s, x) => s + (x - mean) ** 2, 0) / pool.length);
|
|
108
|
+
z = stddev === 0 ? (observed === mean ? 0 : Number.POSITIVE_INFINITY) : (observed - mean) / stddev;
|
|
109
|
+
median = mean;
|
|
110
|
+
}
|
|
111
|
+
if (types.includes("missing") && (0, missing_activity_js_1.isMissingActivity)(observed, (0, stats_js_1.medianUnsorted)(pool), minExpected)) {
|
|
112
|
+
out.push({
|
|
113
|
+
type: "missing",
|
|
114
|
+
severity: "high",
|
|
115
|
+
keys: (pt.keys ?? {}),
|
|
116
|
+
timeframeKey: pt.timeframeKey,
|
|
117
|
+
observed,
|
|
118
|
+
expected: median,
|
|
119
|
+
baseline: {
|
|
120
|
+
median,
|
|
121
|
+
mean: method === "zscore" ? mean : undefined,
|
|
122
|
+
stddev: method === "zscore" ? stddev : undefined,
|
|
123
|
+
mad: method === "robust-zscore" ? mad : undefined,
|
|
124
|
+
bucketCount: pool.length,
|
|
125
|
+
},
|
|
126
|
+
score: z,
|
|
127
|
+
explanation: `Activity near zero while baseline median is ${median.toFixed(2)}.`,
|
|
128
|
+
});
|
|
129
|
+
continue;
|
|
130
|
+
}
|
|
131
|
+
if (mad === 0 && method === "robust-zscore" && Math.abs(observed - median) > minExpected) {
|
|
132
|
+
const sev = Math.abs(observed - median) > median * 2 ? "high" : "medium";
|
|
133
|
+
if (observed > median && types.includes("spike")) {
|
|
134
|
+
out.push({
|
|
135
|
+
type: "spike",
|
|
136
|
+
severity: sev,
|
|
137
|
+
keys: (pt.keys ?? {}),
|
|
138
|
+
timeframeKey: pt.timeframeKey,
|
|
139
|
+
observed,
|
|
140
|
+
expected: median,
|
|
141
|
+
baseline: { median, mad: 0, bucketCount: pool.length },
|
|
142
|
+
explanation: `Observed ${observed} vs baseline median ${median} (MAD=0 fallback).`,
|
|
143
|
+
});
|
|
144
|
+
}
|
|
145
|
+
else if (observed < median && types.includes("drop")) {
|
|
146
|
+
out.push({
|
|
147
|
+
type: "drop",
|
|
148
|
+
severity: sev,
|
|
149
|
+
keys: (pt.keys ?? {}),
|
|
150
|
+
timeframeKey: pt.timeframeKey,
|
|
151
|
+
observed,
|
|
152
|
+
expected: median,
|
|
153
|
+
baseline: { median, mad: 0, bucketCount: pool.length },
|
|
154
|
+
explanation: `Observed ${observed} vs baseline median ${median} (MAD=0 fallback).`,
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
continue;
|
|
158
|
+
}
|
|
159
|
+
if (Math.abs(z) >= threshold) {
|
|
160
|
+
const ty = z > 0 ? "spike" : "drop";
|
|
161
|
+
if (!types.includes(ty))
|
|
162
|
+
continue;
|
|
163
|
+
out.push({
|
|
164
|
+
type: ty,
|
|
165
|
+
severity: severityFromZ(z, threshold),
|
|
166
|
+
keys: (pt.keys ?? {}),
|
|
167
|
+
timeframeKey: pt.timeframeKey,
|
|
168
|
+
observed,
|
|
169
|
+
expected: median,
|
|
170
|
+
baseline: {
|
|
171
|
+
median,
|
|
172
|
+
mean: method === "zscore" ? mean : undefined,
|
|
173
|
+
stddev: method === "zscore" ? stddev : undefined,
|
|
174
|
+
mad: method === "robust-zscore" ? mad : undefined,
|
|
175
|
+
bucketCount: pool.length,
|
|
176
|
+
},
|
|
177
|
+
score: z,
|
|
178
|
+
explanation: `${ty === "spike" ? "Elevated" : "Reduced"} value (score ${z.toFixed(2)}) vs baseline of ${pool.length} buckets.`,
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
else if (method === "threshold") {
|
|
183
|
+
const med = (0, stats_js_1.medianUnsorted)(pool);
|
|
184
|
+
if (types.includes("missing") && (0, missing_activity_js_1.isMissingActivity)(observed, med, minExpected)) {
|
|
185
|
+
out.push({
|
|
186
|
+
type: "missing",
|
|
187
|
+
severity: "high",
|
|
188
|
+
keys: (pt.keys ?? {}),
|
|
189
|
+
timeframeKey: pt.timeframeKey,
|
|
190
|
+
observed,
|
|
191
|
+
expected: med,
|
|
192
|
+
baseline: { median: med, bucketCount: pool.length },
|
|
193
|
+
explanation: `Activity near zero while baseline median is ${med.toFixed(2)}.`,
|
|
194
|
+
});
|
|
195
|
+
}
|
|
196
|
+
else if (types.includes("spike") && observed > med * 2) {
|
|
197
|
+
out.push({
|
|
198
|
+
type: "spike",
|
|
199
|
+
severity: "medium",
|
|
200
|
+
keys: (pt.keys ?? {}),
|
|
201
|
+
timeframeKey: pt.timeframeKey,
|
|
202
|
+
observed,
|
|
203
|
+
expected: med,
|
|
204
|
+
baseline: { median: med, bucketCount: pool.length },
|
|
205
|
+
explanation: `Observed ${observed} exceeds 2× baseline median ${med.toFixed(2)}.`,
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
else if (types.includes("drop") && observed < med * 0.5) {
|
|
209
|
+
out.push({
|
|
210
|
+
type: "drop",
|
|
211
|
+
severity: "medium",
|
|
212
|
+
keys: (pt.keys ?? {}),
|
|
213
|
+
timeframeKey: pt.timeframeKey,
|
|
214
|
+
observed,
|
|
215
|
+
expected: med,
|
|
216
|
+
baseline: { median: med, bucketCount: pool.length },
|
|
217
|
+
explanation: `Observed ${observed} below 0.5× baseline median ${med.toFixed(2)}.`,
|
|
218
|
+
});
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
else if (method === "ewma") {
|
|
222
|
+
const med = (0, stats_js_1.medianUnsorted)(pool);
|
|
223
|
+
const deviation = Math.abs(observed - med);
|
|
224
|
+
if (deviation > Math.max(med * 0.5, minExpected) && types.includes("spike") && observed > med) {
|
|
225
|
+
out.push({
|
|
226
|
+
type: "spike",
|
|
227
|
+
severity: "medium",
|
|
228
|
+
keys: (pt.keys ?? {}),
|
|
229
|
+
timeframeKey: pt.timeframeKey,
|
|
230
|
+
observed,
|
|
231
|
+
expected: med,
|
|
232
|
+
baseline: { median: med, bucketCount: pool.length },
|
|
233
|
+
explanation: `EWMA-style check: large deviation from baseline median.`,
|
|
234
|
+
});
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
return out;
|
|
240
|
+
}
|
|
241
|
+
function resolveBaselineTimeframe(input) {
|
|
242
|
+
const n = (0, baseline_js_1.parseLookbackToBucketCount)(input.baseline?.lookback, input.timeframe.type);
|
|
243
|
+
return (0, baseline_js_1.baselineTimeframeBefore)(input.timeframe, n);
|
|
244
|
+
}
|
|
245
|
+
//# sourceMappingURL=detect-anomalies.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"detect-anomalies.js","sourceRoot":"","sources":["../../../src/insights/anomaly/detect-anomalies.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ewma.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/ewma.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.ewma = ewma;
|
|
4
|
+
function ewma(series, alpha) {
|
|
5
|
+
if (series.length === 0)
|
|
6
|
+
return [];
|
|
7
|
+
const out = [];
|
|
8
|
+
let e = series[0];
|
|
9
|
+
for (const x of series) {
|
|
10
|
+
e = alpha * x + (1 - alpha) * e;
|
|
11
|
+
out.push(e);
|
|
12
|
+
}
|
|
13
|
+
return out;
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=ewma.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ewma.js","sourceRoot":"","sources":["../../../src/insights/anomaly/ewma.ts"],"names":[],"mappings":";;AAAA,oBASC;AATD,SAAgB,IAAI,CAAC,MAAgB,EAAE,KAAa;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"missing-activity.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/missing-activity.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAET"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.isMissingActivity = isMissingActivity;
|
|
4
|
+
/** Heuristic: baseline median above floor while observed is near zero. */
|
|
5
|
+
function isMissingActivity(observed, baselineMedian, minExpected) {
|
|
6
|
+
return baselineMedian >= minExpected && observed <= minExpected * 0.05;
|
|
7
|
+
}
|
|
8
|
+
//# sourceMappingURL=missing-activity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"missing-activity.js","sourceRoot":"","sources":["../../../src/insights/anomaly/missing-activity.ts"],"names":[],"mappings":";;AACA,8CAMC;AAPD,0EAA0E;AAC1E,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,cAAsB,EACtB,WAAmB;IAEnB,OAAO,cAAc,IAAI,WAAW,IAAI,QAAQ,IAAI,WAAW,GAAG,IAAI,CAAC;AACzE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"robust-zscore.d.ts","sourceRoot":"","sources":["../../../src/insights/anomaly/robust-zscore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.madFromMedian = exports.medianUnsorted = exports.zScoreThreshold = exports.robustZScore = void 0;
|
|
4
|
+
var stats_js_1 = require("../utils/stats.js");
|
|
5
|
+
Object.defineProperty(exports, "robustZScore", { enumerable: true, get: function () { return stats_js_1.robustZScore; } });
|
|
6
|
+
Object.defineProperty(exports, "zScoreThreshold", { enumerable: true, get: function () { return stats_js_1.zScoreThreshold; } });
|
|
7
|
+
Object.defineProperty(exports, "medianUnsorted", { enumerable: true, get: function () { return stats_js_1.medianUnsorted; } });
|
|
8
|
+
Object.defineProperty(exports, "madFromMedian", { enumerable: true, get: function () { return stats_js_1.madFromMedian; } });
|
|
9
|
+
//# sourceMappingURL=robust-zscore.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"robust-zscore.js","sourceRoot":"","sources":["../../../src/insights/anomaly/robust-zscore.ts"],"names":[],"mappings":";;;AAAA,8CAAiG;AAAxF,wGAAA,YAAY,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** Focused exports for `@x12i/countex/insights/anomaly`. */
|
|
2
|
+
export { anomaliesFromTimeseries, resolveBaselineTimeframe } from "./anomaly/detect-anomalies.js";
|
|
3
|
+
export { baselineTimeframeBefore, parseLookbackToBucketCount } from "./anomaly/baseline.js";
|
|
4
|
+
export { robustZScore, zScoreThreshold, medianUnsorted, madFromMedian } from "./utils/stats.js";
|
|
5
|
+
export { ewma } from "./anomaly/ewma.js";
|
|
6
|
+
export { isMissingActivity } from "./anomaly/missing-activity.js";
|
|
7
|
+
//# sourceMappingURL=anomaly-subpath.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"anomaly-subpath.d.ts","sourceRoot":"","sources":["../../src/insights/anomaly-subpath.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.isMissingActivity = exports.ewma = exports.madFromMedian = exports.medianUnsorted = exports.zScoreThreshold = exports.robustZScore = exports.parseLookbackToBucketCount = exports.baselineTimeframeBefore = exports.resolveBaselineTimeframe = exports.anomaliesFromTimeseries = void 0;
|
|
4
|
+
/** Focused exports for `@x12i/countex/insights/anomaly`. */
|
|
5
|
+
var detect_anomalies_js_1 = require("./anomaly/detect-anomalies.js");
|
|
6
|
+
Object.defineProperty(exports, "anomaliesFromTimeseries", { enumerable: true, get: function () { return detect_anomalies_js_1.anomaliesFromTimeseries; } });
|
|
7
|
+
Object.defineProperty(exports, "resolveBaselineTimeframe", { enumerable: true, get: function () { return detect_anomalies_js_1.resolveBaselineTimeframe; } });
|
|
8
|
+
var baseline_js_1 = require("./anomaly/baseline.js");
|
|
9
|
+
Object.defineProperty(exports, "baselineTimeframeBefore", { enumerable: true, get: function () { return baseline_js_1.baselineTimeframeBefore; } });
|
|
10
|
+
Object.defineProperty(exports, "parseLookbackToBucketCount", { enumerable: true, get: function () { return baseline_js_1.parseLookbackToBucketCount; } });
|
|
11
|
+
var stats_js_1 = require("./utils/stats.js");
|
|
12
|
+
Object.defineProperty(exports, "robustZScore", { enumerable: true, get: function () { return stats_js_1.robustZScore; } });
|
|
13
|
+
Object.defineProperty(exports, "zScoreThreshold", { enumerable: true, get: function () { return stats_js_1.zScoreThreshold; } });
|
|
14
|
+
Object.defineProperty(exports, "medianUnsorted", { enumerable: true, get: function () { return stats_js_1.medianUnsorted; } });
|
|
15
|
+
Object.defineProperty(exports, "madFromMedian", { enumerable: true, get: function () { return stats_js_1.madFromMedian; } });
|
|
16
|
+
var ewma_js_1 = require("./anomaly/ewma.js");
|
|
17
|
+
Object.defineProperty(exports, "ewma", { enumerable: true, get: function () { return ewma_js_1.ewma; } });
|
|
18
|
+
var missing_activity_js_1 = require("./anomaly/missing-activity.js");
|
|
19
|
+
Object.defineProperty(exports, "isMissingActivity", { enumerable: true, get: function () { return missing_activity_js_1.isMissingActivity; } });
|
|
20
|
+
//# sourceMappingURL=anomaly-subpath.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"anomaly-subpath.js","sourceRoot":"","sources":["../../src/insights/anomaly-subpath.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC5D,qEAAkG;AAAzF,8HAAA,uBAAuB,OAAA;AAAE,+HAAA,wBAAwB,OAAA;AAC1D,qDAA4F;AAAnF,sHAAA,uBAAuB,OAAA;AAAE,yHAAA,0BAA0B,OAAA;AAC5D,6CAAgG;AAAvF,wGAAA,YAAY,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AACrE,6CAAyC;AAAhC,+FAAA,IAAI,OAAA;AACb,qEAAkE;AAAzD,wHAAA,iBAAiB,OAAA"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { QueryRow } from "../../types/index.js";
|
|
2
|
+
import type { ComparePeriodsResult } from "../types.js";
|
|
3
|
+
import type { ParsedMeasure } from "../utils/query-builder.js";
|
|
4
|
+
export declare function mergeComparePeriods(currentRows: QueryRow[], previousRows: QueryRow[], parsed: ParsedMeasure, minAbs?: number, minPct?: number): ComparePeriodsResult["rows"];
|
|
5
|
+
//# sourceMappingURL=compare-periods.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compare-periods.d.ts","sourceRoot":"","sources":["../../../src/insights/comparison/compare-periods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAW/D,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,QAAQ,EAAE,EACvB,YAAY,EAAE,QAAQ,EAAE,EACxB,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,CAAC,MAAM,CAAC,CA+C9B"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.mergeComparePeriods = mergeComparePeriods;
|
|
4
|
+
const row_value_js_1 = require("../utils/row-value.js");
|
|
5
|
+
function rowKey(keys) {
|
|
6
|
+
const sorted = {};
|
|
7
|
+
for (const k of Object.keys(keys).sort()) {
|
|
8
|
+
sorted[k] = keys[k];
|
|
9
|
+
}
|
|
10
|
+
return JSON.stringify(sorted);
|
|
11
|
+
}
|
|
12
|
+
function mergeComparePeriods(currentRows, previousRows, parsed, minAbs, minPct) {
|
|
13
|
+
const prevMap = new Map();
|
|
14
|
+
for (const r of previousRows)
|
|
15
|
+
prevMap.set(rowKey(r.keys), r);
|
|
16
|
+
const curMap = new Map();
|
|
17
|
+
for (const r of currentRows)
|
|
18
|
+
curMap.set(rowKey(r.keys), r);
|
|
19
|
+
const keys = new Set([...prevMap.keys(), ...curMap.keys()]);
|
|
20
|
+
const out = [];
|
|
21
|
+
for (const k of keys) {
|
|
22
|
+
const cur = curMap.get(k);
|
|
23
|
+
const prev = prevMap.get(k);
|
|
24
|
+
const c = cur ? (0, row_value_js_1.rowValue)(cur, parsed) : 0;
|
|
25
|
+
const p = prev ? (0, row_value_js_1.rowValue)(prev, parsed) : 0;
|
|
26
|
+
const keysObj = (cur ?? prev).keys;
|
|
27
|
+
const absoluteChange = c - p;
|
|
28
|
+
let direction;
|
|
29
|
+
if (p === 0 && c === 0)
|
|
30
|
+
direction = "flat";
|
|
31
|
+
else if (p === 0 && c > 0)
|
|
32
|
+
direction = "new";
|
|
33
|
+
else if (c === 0 && p > 0)
|
|
34
|
+
direction = "missing";
|
|
35
|
+
else if (absoluteChange > 0)
|
|
36
|
+
direction = "up";
|
|
37
|
+
else if (absoluteChange < 0)
|
|
38
|
+
direction = "down";
|
|
39
|
+
else
|
|
40
|
+
direction = "flat";
|
|
41
|
+
const percentChange = p === 0 ? null : ((c - p) / p) * 100;
|
|
42
|
+
let significance = "low";
|
|
43
|
+
const pct = percentChange === null ? 0 : Math.abs(percentChange);
|
|
44
|
+
if (pct >= 50)
|
|
45
|
+
significance = "high";
|
|
46
|
+
else if (pct >= 20)
|
|
47
|
+
significance = "medium";
|
|
48
|
+
if (minAbs !== undefined && Math.abs(absoluteChange) < minAbs)
|
|
49
|
+
continue;
|
|
50
|
+
if (minPct !== undefined && percentChange !== null && Math.abs(percentChange) < minPct)
|
|
51
|
+
continue;
|
|
52
|
+
out.push({
|
|
53
|
+
keys: keysObj,
|
|
54
|
+
current: c,
|
|
55
|
+
previous: p,
|
|
56
|
+
absoluteChange,
|
|
57
|
+
percentChange,
|
|
58
|
+
direction,
|
|
59
|
+
significance,
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
return out;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=compare-periods.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compare-periods.js","sourceRoot":"","sources":["../../../src/insights/comparison/compare-periods.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"growth-rate.d.ts","sourceRoot":"","sources":["../../../src/insights/comparison/growth-rate.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,EAAE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"growth-rate.js","sourceRoot":"","sources":["../../../src/insights/comparison/growth-rate.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"moving-average.d.ts","sourceRoot":"","sources":["../../../src/insights/comparison/moving-average.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.movingAverage = void 0;
|
|
4
|
+
var stats_js_1 = require("../utils/stats.js");
|
|
5
|
+
Object.defineProperty(exports, "movingAverage", { enumerable: true, get: function () { return stats_js_1.movingAverage; } });
|
|
6
|
+
//# sourceMappingURL=moving-average.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"moving-average.js","sourceRoot":"","sources":["../../../src/insights/comparison/moving-average.ts"],"names":[],"mappings":";;;AAAA,8CAAkD;AAAzC,yGAAA,aAAa,OAAA"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { TimeseriesPoint } from "../../types/index.js";
|
|
2
|
+
import type { TrendResult } from "../types.js";
|
|
3
|
+
import type { ParsedMeasure } from "../utils/query-builder.js";
|
|
4
|
+
export declare function trendFromTimeseries(points: TimeseriesPoint[], parsed: ParsedMeasure, method: "linear" | "moving_average" | "simple_growth", movingWindow?: number): TrendResult["rows"];
|
|
5
|
+
//# sourceMappingURL=trend.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trend.d.ts","sourceRoot":"","sources":["../../../src/insights/comparison/trend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AA+B/D,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EAAE,EACzB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,eAAe,EACrD,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CAAC,MAAM,CAAC,CAqDrB"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.trendFromTimeseries = trendFromTimeseries;
|
|
4
|
+
const formatting_js_1 = require("../utils/formatting.js");
|
|
5
|
+
const stats_js_1 = require("../utils/stats.js");
|
|
6
|
+
function tsValue(pt, parsed) {
|
|
7
|
+
if (parsed.kind === "count")
|
|
8
|
+
return pt.count;
|
|
9
|
+
if (parsed.kind === "rate")
|
|
10
|
+
return pt.rate ?? 0;
|
|
11
|
+
const m = pt.measures?.[parsed.name];
|
|
12
|
+
if (!m)
|
|
13
|
+
return 0;
|
|
14
|
+
switch (parsed.agg) {
|
|
15
|
+
case "sum":
|
|
16
|
+
return m.sum ?? 0;
|
|
17
|
+
case "count":
|
|
18
|
+
return m.count ?? 0;
|
|
19
|
+
case "min":
|
|
20
|
+
return m.min ?? 0;
|
|
21
|
+
case "max":
|
|
22
|
+
return m.max ?? 0;
|
|
23
|
+
case "avg":
|
|
24
|
+
if (m.avg !== undefined)
|
|
25
|
+
return m.avg;
|
|
26
|
+
if (m.sum !== undefined && m.count !== undefined && m.count !== 0)
|
|
27
|
+
return m.sum / m.count;
|
|
28
|
+
return 0;
|
|
29
|
+
default:
|
|
30
|
+
return 0;
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
function seriesKey(pt) {
|
|
34
|
+
return (0, formatting_js_1.stableSerializedGroupKeys)(pt.keys);
|
|
35
|
+
}
|
|
36
|
+
function trendFromTimeseries(points, parsed, method, movingWindow) {
|
|
37
|
+
const clusters = new Map();
|
|
38
|
+
for (const p of points) {
|
|
39
|
+
const k = seriesKey(p);
|
|
40
|
+
const arr = clusters.get(k) ?? [];
|
|
41
|
+
arr.push(p);
|
|
42
|
+
clusters.set(k, arr);
|
|
43
|
+
}
|
|
44
|
+
const rows = [];
|
|
45
|
+
for (const [, series] of clusters) {
|
|
46
|
+
series.sort((a, b) => (a.timeframeKey < b.timeframeKey ? -1 : 1));
|
|
47
|
+
let ys = series.map((p) => tsValue(p, parsed));
|
|
48
|
+
const xs = series.map((_, i) => i);
|
|
49
|
+
if (method === "moving_average" && (movingWindow ?? 3) > 1) {
|
|
50
|
+
ys = (0, stats_js_1.movingAverage)(ys, movingWindow ?? 3);
|
|
51
|
+
}
|
|
52
|
+
let slope = 0;
|
|
53
|
+
let r2;
|
|
54
|
+
if (method === "linear" || method === "moving_average") {
|
|
55
|
+
const reg = (0, stats_js_1.linearRegression)(xs, ys);
|
|
56
|
+
slope = reg.slope;
|
|
57
|
+
r2 = reg.r2;
|
|
58
|
+
}
|
|
59
|
+
else if (method === "simple_growth") {
|
|
60
|
+
const a = ys[0] ?? 0;
|
|
61
|
+
const b = ys[ys.length - 1] ?? 0;
|
|
62
|
+
slope = ys.length > 1 ? (b - a) / (ys.length - 1) : 0;
|
|
63
|
+
}
|
|
64
|
+
const startValue = ys[0] ?? 0;
|
|
65
|
+
const endValue = ys[ys.length - 1] ?? 0;
|
|
66
|
+
let direction = "flat";
|
|
67
|
+
if (slope > 1e-9)
|
|
68
|
+
direction = "up";
|
|
69
|
+
else if (slope < -1e-9)
|
|
70
|
+
direction = "down";
|
|
71
|
+
const changePercent = startValue === 0 ? null : ((endValue - startValue) / Math.abs(startValue)) * 100;
|
|
72
|
+
rows.push({
|
|
73
|
+
keys: (series[0]?.keys ?? {}),
|
|
74
|
+
slope,
|
|
75
|
+
direction,
|
|
76
|
+
startValue,
|
|
77
|
+
endValue,
|
|
78
|
+
changePercent,
|
|
79
|
+
r2,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
return rows;
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=trend.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trend.js","sourceRoot":"","sources":["../../../src/insights/comparison/trend.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { CountexError } from "../utils/errors.js";
|
|
2
|
+
export declare class CountexInsightError extends CountexError {
|
|
3
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
4
|
+
}
|
|
5
|
+
export declare class InsightQueryTooBroadError extends CountexInsightError {
|
|
6
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
7
|
+
}
|
|
8
|
+
export declare class InsufficientDataError extends CountexInsightError {
|
|
9
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
10
|
+
}
|
|
11
|
+
export declare class UnsupportedMeasureError extends CountexInsightError {
|
|
12
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
13
|
+
}
|
|
14
|
+
export declare class InvalidBaselineError extends CountexInsightError {
|
|
15
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
16
|
+
}
|
|
17
|
+
export declare class InsightStorageError extends CountexInsightError {
|
|
18
|
+
constructor(message: string, meta?: Record<string, unknown> & {
|
|
19
|
+
cause?: unknown;
|
|
20
|
+
});
|
|
21
|
+
}
|
|
22
|
+
export declare class InvalidInsightInputError extends CountexInsightError {
|
|
23
|
+
constructor(message: string, meta?: Record<string, unknown>);
|
|
24
|
+
}
|
|
25
|
+
//# sourceMappingURL=errors.d.ts.map
|