@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.
Files changed (256) hide show
  1. package/README.md +192 -3
  2. package/dist/backup/export.d.ts +2 -0
  3. package/dist/backup/export.d.ts.map +1 -1
  4. package/dist/backup/export.js +2 -0
  5. package/dist/backup/export.js.map +1 -1
  6. package/dist/cli.d.ts +12 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +190 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/core/buffer.d.ts +4 -3
  11. package/dist/core/buffer.d.ts.map +1 -1
  12. package/dist/core/buffer.js +65 -9
  13. package/dist/core/buffer.js.map +1 -1
  14. package/dist/core/countex.d.ts.map +1 -1
  15. package/dist/core/countex.js +30 -3
  16. package/dist/core/countex.js.map +1 -1
  17. package/dist/core/extraction.d.ts +14 -2
  18. package/dist/core/extraction.d.ts.map +1 -1
  19. package/dist/core/extraction.js +117 -1
  20. package/dist/core/extraction.js.map +1 -1
  21. package/dist/core/mapping.d.ts.map +1 -1
  22. package/dist/core/mapping.js +44 -1
  23. package/dist/core/mapping.js.map +1 -1
  24. package/dist/core/timeframe.d.ts +7 -0
  25. package/dist/core/timeframe.d.ts.map +1 -1
  26. package/dist/core/timeframe.js +88 -0
  27. package/dist/core/timeframe.js.map +1 -1
  28. package/dist/index.d.ts +1 -1
  29. package/dist/index.d.ts.map +1 -1
  30. package/dist/insights/advisors/fanout-health.d.ts +3 -0
  31. package/dist/insights/advisors/fanout-health.d.ts.map +1 -0
  32. package/dist/insights/advisors/fanout-health.js +3 -0
  33. package/dist/insights/advisors/fanout-health.js.map +1 -0
  34. package/dist/insights/advisors/map-health.d.ts +6 -0
  35. package/dist/insights/advisors/map-health.d.ts.map +1 -0
  36. package/dist/insights/advisors/map-health.js +154 -0
  37. package/dist/insights/advisors/map-health.js.map +1 -0
  38. package/dist/insights/advisors/resource-advisor.d.ts +4 -0
  39. package/dist/insights/advisors/resource-advisor.d.ts.map +1 -0
  40. package/dist/insights/advisors/resource-advisor.js +102 -0
  41. package/dist/insights/advisors/resource-advisor.js.map +1 -0
  42. package/dist/insights/advisors/retention-advisor.d.ts +2 -0
  43. package/dist/insights/advisors/retention-advisor.d.ts.map +1 -0
  44. package/dist/insights/advisors/retention-advisor.js +6 -0
  45. package/dist/insights/advisors/retention-advisor.js.map +1 -0
  46. package/dist/insights/advisors-subpath.d.ts +4 -0
  47. package/dist/insights/advisors-subpath.d.ts.map +1 -0
  48. package/dist/insights/advisors-subpath.js +10 -0
  49. package/dist/insights/advisors-subpath.js.map +1 -0
  50. package/dist/insights/anomaly/baseline.d.ts +4 -0
  51. package/dist/insights/anomaly/baseline.d.ts.map +1 -0
  52. package/dist/insights/anomaly/baseline.js +54 -0
  53. package/dist/insights/anomaly/baseline.js.map +1 -0
  54. package/dist/insights/anomaly/detect-anomalies.d.ts +6 -0
  55. package/dist/insights/anomaly/detect-anomalies.d.ts.map +1 -0
  56. package/dist/insights/anomaly/detect-anomalies.js +245 -0
  57. package/dist/insights/anomaly/detect-anomalies.js.map +1 -0
  58. package/dist/insights/anomaly/ewma.d.ts +2 -0
  59. package/dist/insights/anomaly/ewma.d.ts.map +1 -0
  60. package/dist/insights/anomaly/ewma.js +15 -0
  61. package/dist/insights/anomaly/ewma.js.map +1 -0
  62. package/dist/insights/anomaly/missing-activity.d.ts +3 -0
  63. package/dist/insights/anomaly/missing-activity.d.ts.map +1 -0
  64. package/dist/insights/anomaly/missing-activity.js +8 -0
  65. package/dist/insights/anomaly/missing-activity.js.map +1 -0
  66. package/dist/insights/anomaly/robust-zscore.d.ts +2 -0
  67. package/dist/insights/anomaly/robust-zscore.d.ts.map +1 -0
  68. package/dist/insights/anomaly/robust-zscore.js +9 -0
  69. package/dist/insights/anomaly/robust-zscore.js.map +1 -0
  70. package/dist/insights/anomaly-subpath.d.ts +7 -0
  71. package/dist/insights/anomaly-subpath.d.ts.map +1 -0
  72. package/dist/insights/anomaly-subpath.js +20 -0
  73. package/dist/insights/anomaly-subpath.js.map +1 -0
  74. package/dist/insights/comparison/compare-periods.d.ts +5 -0
  75. package/dist/insights/comparison/compare-periods.d.ts.map +1 -0
  76. package/dist/insights/comparison/compare-periods.js +64 -0
  77. package/dist/insights/comparison/compare-periods.js.map +1 -0
  78. package/dist/insights/comparison/growth-rate.d.ts +3 -0
  79. package/dist/insights/comparison/growth-rate.d.ts.map +1 -0
  80. package/dist/insights/comparison/growth-rate.js +3 -0
  81. package/dist/insights/comparison/growth-rate.js.map +1 -0
  82. package/dist/insights/comparison/moving-average.d.ts +2 -0
  83. package/dist/insights/comparison/moving-average.d.ts.map +1 -0
  84. package/dist/insights/comparison/moving-average.js +6 -0
  85. package/dist/insights/comparison/moving-average.js.map +1 -0
  86. package/dist/insights/comparison/trend.d.ts +5 -0
  87. package/dist/insights/comparison/trend.d.ts.map +1 -0
  88. package/dist/insights/comparison/trend.js +84 -0
  89. package/dist/insights/comparison/trend.js.map +1 -0
  90. package/dist/insights/errors.d.ts +25 -0
  91. package/dist/insights/errors.d.ts.map +1 -0
  92. package/dist/insights/errors.js +54 -0
  93. package/dist/insights/errors.js.map +1 -0
  94. package/dist/insights/forecast/budget.d.ts +2 -0
  95. package/dist/insights/forecast/budget.d.ts.map +1 -0
  96. package/dist/insights/forecast/budget.js +6 -0
  97. package/dist/insights/forecast/budget.js.map +1 -0
  98. package/dist/insights/forecast/capacity.d.ts +2 -0
  99. package/dist/insights/forecast/capacity.d.ts.map +1 -0
  100. package/dist/insights/forecast/capacity.js +3 -0
  101. package/dist/insights/forecast/capacity.js.map +1 -0
  102. package/dist/insights/forecast/forecast.d.ts +5 -0
  103. package/dist/insights/forecast/forecast.d.ts.map +1 -0
  104. package/dist/insights/forecast/forecast.js +103 -0
  105. package/dist/insights/forecast/forecast.js.map +1 -0
  106. package/dist/insights/forecast/retention.d.ts +2 -0
  107. package/dist/insights/forecast/retention.d.ts.map +1 -0
  108. package/dist/insights/forecast/retention.js +3 -0
  109. package/dist/insights/forecast/retention.js.map +1 -0
  110. package/dist/insights/index.d.ts +4 -0
  111. package/dist/insights/index.d.ts.map +1 -0
  112. package/dist/insights/index.js +23 -0
  113. package/dist/insights/index.js.map +1 -0
  114. package/dist/insights/insights-client.d.ts +33 -0
  115. package/dist/insights/insights-client.d.ts.map +1 -0
  116. package/dist/insights/insights-client.js +344 -0
  117. package/dist/insights/insights-client.js.map +1 -0
  118. package/dist/insights/llm-subpath.d.ts +4 -0
  119. package/dist/insights/llm-subpath.d.ts.map +1 -0
  120. package/dist/insights/llm-subpath.js +10 -0
  121. package/dist/insights/llm-subpath.js.map +1 -0
  122. package/dist/insights/optimization/cost-optimizer.d.ts +6 -0
  123. package/dist/insights/optimization/cost-optimizer.d.ts.map +1 -0
  124. package/dist/insights/optimization/cost-optimizer.js +98 -0
  125. package/dist/insights/optimization/cost-optimizer.js.map +1 -0
  126. package/dist/insights/optimization/latency-optimizer.d.ts +3 -0
  127. package/dist/insights/optimization/latency-optimizer.d.ts.map +1 -0
  128. package/dist/insights/optimization/latency-optimizer.js +3 -0
  129. package/dist/insights/optimization/latency-optimizer.js.map +1 -0
  130. package/dist/insights/optimization/threshold-advisor.d.ts +2 -0
  131. package/dist/insights/optimization/threshold-advisor.d.ts.map +1 -0
  132. package/dist/insights/optimization/threshold-advisor.js +3 -0
  133. package/dist/insights/optimization/threshold-advisor.js.map +1 -0
  134. package/dist/insights/optimization/token-optimizer.d.ts +4 -0
  135. package/dist/insights/optimization/token-optimizer.d.ts.map +1 -0
  136. package/dist/insights/optimization/token-optimizer.js +133 -0
  137. package/dist/insights/optimization/token-optimizer.js.map +1 -0
  138. package/dist/insights/ranking/contribution.d.ts +2 -0
  139. package/dist/insights/ranking/contribution.d.ts.map +1 -0
  140. package/dist/insights/ranking/contribution.js +6 -0
  141. package/dist/insights/ranking/contribution.js.map +1 -0
  142. package/dist/insights/ranking/helpers.d.ts +22 -0
  143. package/dist/insights/ranking/helpers.d.ts.map +1 -0
  144. package/dist/insights/ranking/helpers.js +88 -0
  145. package/dist/insights/ranking/helpers.js.map +1 -0
  146. package/dist/insights/ranking/pareto.d.ts +2 -0
  147. package/dist/insights/ranking/pareto.d.ts.map +1 -0
  148. package/dist/insights/ranking/pareto.js +6 -0
  149. package/dist/insights/ranking/pareto.js.map +1 -0
  150. package/dist/insights/ranking/slices.d.ts +2 -0
  151. package/dist/insights/ranking/slices.d.ts.map +1 -0
  152. package/dist/insights/ranking/slices.js +6 -0
  153. package/dist/insights/ranking/slices.js.map +1 -0
  154. package/dist/insights/ranking/top-bottom.d.ts +2 -0
  155. package/dist/insights/ranking/top-bottom.d.ts.map +1 -0
  156. package/dist/insights/ranking/top-bottom.js +7 -0
  157. package/dist/insights/ranking/top-bottom.js.map +1 -0
  158. package/dist/insights/recommendations/evidence.d.ts +2 -0
  159. package/dist/insights/recommendations/evidence.d.ts.map +1 -0
  160. package/dist/insights/recommendations/evidence.js +3 -0
  161. package/dist/insights/recommendations/evidence.js.map +1 -0
  162. package/dist/insights/recommendations/recommendation.d.ts +6 -0
  163. package/dist/insights/recommendations/recommendation.d.ts.map +1 -0
  164. package/dist/insights/recommendations/recommendation.js +25 -0
  165. package/dist/insights/recommendations/recommendation.js.map +1 -0
  166. package/dist/insights/recommendations/severity.d.ts +2 -0
  167. package/dist/insights/recommendations/severity.d.ts.map +1 -0
  168. package/dist/insights/recommendations/severity.js +3 -0
  169. package/dist/insights/recommendations/severity.js.map +1 -0
  170. package/dist/insights/rules/evaluate-rules.d.ts +5 -0
  171. package/dist/insights/rules/evaluate-rules.d.ts.map +1 -0
  172. package/dist/insights/rules/evaluate-rules.js +156 -0
  173. package/dist/insights/rules/evaluate-rules.js.map +1 -0
  174. package/dist/insights/types.d.ts +405 -0
  175. package/dist/insights/types.d.ts.map +1 -0
  176. package/dist/insights/types.js +3 -0
  177. package/dist/insights/types.js.map +1 -0
  178. package/dist/insights/utils/formatting.d.ts +4 -0
  179. package/dist/insights/utils/formatting.d.ts.map +1 -0
  180. package/dist/insights/utils/formatting.js +21 -0
  181. package/dist/insights/utils/formatting.js.map +1 -0
  182. package/dist/insights/utils/grouping.d.ts +2 -0
  183. package/dist/insights/utils/grouping.d.ts.map +1 -0
  184. package/dist/insights/utils/grouping.js +8 -0
  185. package/dist/insights/utils/grouping.js.map +1 -0
  186. package/dist/insights/utils/query-builder.d.ts +21 -0
  187. package/dist/insights/utils/query-builder.d.ts.map +1 -0
  188. package/dist/insights/utils/query-builder.js +107 -0
  189. package/dist/insights/utils/query-builder.js.map +1 -0
  190. package/dist/insights/utils/row-value.d.ts +5 -0
  191. package/dist/insights/utils/row-value.d.ts.map +1 -0
  192. package/dist/insights/utils/row-value.js +36 -0
  193. package/dist/insights/utils/row-value.js.map +1 -0
  194. package/dist/insights/utils/stats.d.ts +28 -0
  195. package/dist/insights/utils/stats.d.ts.map +1 -0
  196. package/dist/insights/utils/stats.js +125 -0
  197. package/dist/insights/utils/stats.js.map +1 -0
  198. package/dist/query/formatter.d.ts.map +1 -1
  199. package/dist/query/formatter.js +202 -24
  200. package/dist/query/formatter.js.map +1 -1
  201. package/dist/query/planner.d.ts +10 -2
  202. package/dist/query/planner.d.ts.map +1 -1
  203. package/dist/query/planner.js +39 -2
  204. package/dist/query/planner.js.map +1 -1
  205. package/dist/storage/memory.d.ts.map +1 -1
  206. package/dist/storage/memory.js +78 -4
  207. package/dist/storage/memory.js.map +1 -1
  208. package/dist/storage/mongo.d.ts.map +1 -1
  209. package/dist/storage/mongo.js +61 -16
  210. package/dist/storage/mongo.js.map +1 -1
  211. package/dist/storage/redis.d.ts +6 -7
  212. package/dist/storage/redis.d.ts.map +1 -1
  213. package/dist/storage/redis.js +108 -39
  214. package/dist/storage/redis.js.map +1 -1
  215. package/dist/types/index.d.ts +88 -4
  216. package/dist/types/index.d.ts.map +1 -1
  217. package/docs/INSIGHTS.md +59 -0
  218. package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -0
  219. package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -0
  220. package/docs/INSIGHTS_RESOURCE_ADVISOR.md +31 -0
  221. package/docs/guides/README.md +29 -0
  222. package/docs/guides/adapter-memory.md +48 -0
  223. package/docs/guides/adapter-mongo.md +50 -0
  224. package/docs/guides/adapter-redis.md +47 -0
  225. package/docs/guides/backup-export.md +39 -0
  226. package/docs/guides/cardinality.md +50 -0
  227. package/docs/guides/cli.md +45 -0
  228. package/docs/guides/client-events.md +49 -0
  229. package/docs/guides/counter-maps.md +116 -0
  230. package/docs/guides/idempotency.md +39 -0
  231. package/docs/guides/ingestion-and-flush.md +67 -0
  232. package/docs/guides/insights-advisors-and-optimization.md +39 -0
  233. package/docs/guides/insights-anomalies-and-rules.md +48 -0
  234. package/docs/guides/insights-comparison-and-trends.md +47 -0
  235. package/docs/guides/insights-forecasting-and-budget.md +61 -0
  236. package/docs/guides/insights-overview.md +76 -0
  237. package/docs/guides/insights-ranking.md +81 -0
  238. package/docs/guides/measures.md +67 -0
  239. package/docs/guides/querying.md +79 -0
  240. package/docs/guides/timeframes-and-bucketing.md +55 -0
  241. package/docs/internals/README.md +20 -0
  242. package/docs/internals/internal-architecture-overview.md +65 -0
  243. package/docs/internals/internal-backup-stream.md +23 -0
  244. package/docs/internals/internal-buffer-merge-and-flush.md +51 -0
  245. package/docs/internals/internal-cardinality.md +30 -0
  246. package/docs/internals/internal-idempotency.md +36 -0
  247. package/docs/internals/internal-ingest-pipeline.md +52 -0
  248. package/docs/internals/internal-insights-layer.md +36 -0
  249. package/docs/internals/internal-mapping-validation-and-extraction.md +59 -0
  250. package/docs/internals/internal-measures-and-scales.md +35 -0
  251. package/docs/internals/internal-query-path.md +46 -0
  252. package/docs/internals/internal-storage-memory.md +13 -0
  253. package/docs/internals/internal-storage-mongo.md +24 -0
  254. package/docs/internals/internal-storage-redis.md +31 -0
  255. package/docs/internals/internal-timeframe-bucketing.md +33 -0
  256. 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,2 @@
1
+ export declare function ewma(series: number[], alpha: number): number[];
2
+ //# sourceMappingURL=ewma.d.ts.map
@@ -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,3 @@
1
+ /** Heuristic: baseline median above floor while observed is near zero. */
2
+ export declare function isMissingActivity(observed: number, baselineMedian: number, minExpected: number): boolean;
3
+ //# sourceMappingURL=missing-activity.d.ts.map
@@ -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,2 @@
1
+ export { robustZScore, zScoreThreshold, medianUnsorted, madFromMedian } from "../utils/stats.js";
2
+ //# sourceMappingURL=robust-zscore.d.ts.map
@@ -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,3 @@
1
+ /** Reserved for extended growth helpers; trend uses simple_growth in comparison/trend.ts. */
2
+ export {};
3
+ //# sourceMappingURL=growth-rate.d.ts.map
@@ -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,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=growth-rate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"growth-rate.js","sourceRoot":"","sources":["../../../src/insights/comparison/growth-rate.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export { movingAverage } from "../utils/stats.js";
2
+ //# sourceMappingURL=moving-average.d.ts.map
@@ -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