@x12i/countex 1.0.0 → 1.5.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 (317) hide show
  1. package/README.md +215 -4
  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/backup/manifest.d.ts +49 -0
  7. package/dist/backup/manifest.d.ts.map +1 -0
  8. package/dist/backup/manifest.js +103 -0
  9. package/dist/backup/manifest.js.map +1 -0
  10. package/dist/backup/snapshot-encoding.d.ts +8 -0
  11. package/dist/backup/snapshot-encoding.d.ts.map +1 -0
  12. package/dist/backup/snapshot-encoding.js +27 -0
  13. package/dist/backup/snapshot-encoding.js.map +1 -0
  14. package/dist/cli.d.ts +12 -0
  15. package/dist/cli.d.ts.map +1 -0
  16. package/dist/cli.js +206 -0
  17. package/dist/cli.js.map +1 -0
  18. package/dist/core/buffer.d.ts +4 -3
  19. package/dist/core/buffer.d.ts.map +1 -1
  20. package/dist/core/buffer.js +65 -9
  21. package/dist/core/buffer.js.map +1 -1
  22. package/dist/core/countex.d.ts +14 -1
  23. package/dist/core/countex.d.ts.map +1 -1
  24. package/dist/core/countex.js +171 -48
  25. package/dist/core/countex.js.map +1 -1
  26. package/dist/core/extraction.d.ts +14 -6
  27. package/dist/core/extraction.d.ts.map +1 -1
  28. package/dist/core/extraction.js +117 -1
  29. package/dist/core/extraction.js.map +1 -1
  30. package/dist/core/mapping.d.ts +5 -0
  31. package/dist/core/mapping.d.ts.map +1 -1
  32. package/dist/core/mapping.js +71 -1
  33. package/dist/core/mapping.js.map +1 -1
  34. package/dist/core/timeframe.d.ts +7 -0
  35. package/dist/core/timeframe.d.ts.map +1 -1
  36. package/dist/core/timeframe.js +88 -0
  37. package/dist/core/timeframe.js.map +1 -1
  38. package/dist/index.d.ts +4 -1
  39. package/dist/index.d.ts.map +1 -1
  40. package/dist/index.js +13 -1
  41. package/dist/index.js.map +1 -1
  42. package/dist/insights/advisors/fanout-health.d.ts +3 -0
  43. package/dist/insights/advisors/fanout-health.d.ts.map +1 -0
  44. package/dist/insights/advisors/fanout-health.js +3 -0
  45. package/dist/insights/advisors/fanout-health.js.map +1 -0
  46. package/dist/insights/advisors/map-health.d.ts +6 -0
  47. package/dist/insights/advisors/map-health.d.ts.map +1 -0
  48. package/dist/insights/advisors/map-health.js +154 -0
  49. package/dist/insights/advisors/map-health.js.map +1 -0
  50. package/dist/insights/advisors/resource-advisor.d.ts +4 -0
  51. package/dist/insights/advisors/resource-advisor.d.ts.map +1 -0
  52. package/dist/insights/advisors/resource-advisor.js +102 -0
  53. package/dist/insights/advisors/resource-advisor.js.map +1 -0
  54. package/dist/insights/advisors/retention-advisor.d.ts +2 -0
  55. package/dist/insights/advisors/retention-advisor.d.ts.map +1 -0
  56. package/dist/insights/advisors/retention-advisor.js +6 -0
  57. package/dist/insights/advisors/retention-advisor.js.map +1 -0
  58. package/dist/insights/advisors-subpath.d.ts +4 -0
  59. package/dist/insights/advisors-subpath.d.ts.map +1 -0
  60. package/dist/insights/advisors-subpath.js +10 -0
  61. package/dist/insights/advisors-subpath.js.map +1 -0
  62. package/dist/insights/anomaly/baseline.d.ts +4 -0
  63. package/dist/insights/anomaly/baseline.d.ts.map +1 -0
  64. package/dist/insights/anomaly/baseline.js +54 -0
  65. package/dist/insights/anomaly/baseline.js.map +1 -0
  66. package/dist/insights/anomaly/detect-anomalies.d.ts +6 -0
  67. package/dist/insights/anomaly/detect-anomalies.d.ts.map +1 -0
  68. package/dist/insights/anomaly/detect-anomalies.js +245 -0
  69. package/dist/insights/anomaly/detect-anomalies.js.map +1 -0
  70. package/dist/insights/anomaly/ewma.d.ts +2 -0
  71. package/dist/insights/anomaly/ewma.d.ts.map +1 -0
  72. package/dist/insights/anomaly/ewma.js +15 -0
  73. package/dist/insights/anomaly/ewma.js.map +1 -0
  74. package/dist/insights/anomaly/missing-activity.d.ts +3 -0
  75. package/dist/insights/anomaly/missing-activity.d.ts.map +1 -0
  76. package/dist/insights/anomaly/missing-activity.js +8 -0
  77. package/dist/insights/anomaly/missing-activity.js.map +1 -0
  78. package/dist/insights/anomaly/robust-zscore.d.ts +2 -0
  79. package/dist/insights/anomaly/robust-zscore.d.ts.map +1 -0
  80. package/dist/insights/anomaly/robust-zscore.js +9 -0
  81. package/dist/insights/anomaly/robust-zscore.js.map +1 -0
  82. package/dist/insights/anomaly-subpath.d.ts +7 -0
  83. package/dist/insights/anomaly-subpath.d.ts.map +1 -0
  84. package/dist/insights/anomaly-subpath.js +20 -0
  85. package/dist/insights/anomaly-subpath.js.map +1 -0
  86. package/dist/insights/comparison/compare-periods.d.ts +5 -0
  87. package/dist/insights/comparison/compare-periods.d.ts.map +1 -0
  88. package/dist/insights/comparison/compare-periods.js +64 -0
  89. package/dist/insights/comparison/compare-periods.js.map +1 -0
  90. package/dist/insights/comparison/growth-rate.d.ts +3 -0
  91. package/dist/insights/comparison/growth-rate.d.ts.map +1 -0
  92. package/dist/insights/comparison/growth-rate.js +3 -0
  93. package/dist/insights/comparison/growth-rate.js.map +1 -0
  94. package/dist/insights/comparison/moving-average.d.ts +2 -0
  95. package/dist/insights/comparison/moving-average.d.ts.map +1 -0
  96. package/dist/insights/comparison/moving-average.js +6 -0
  97. package/dist/insights/comparison/moving-average.js.map +1 -0
  98. package/dist/insights/comparison/trend.d.ts +5 -0
  99. package/dist/insights/comparison/trend.d.ts.map +1 -0
  100. package/dist/insights/comparison/trend.js +84 -0
  101. package/dist/insights/comparison/trend.js.map +1 -0
  102. package/dist/insights/errors.d.ts +25 -0
  103. package/dist/insights/errors.d.ts.map +1 -0
  104. package/dist/insights/errors.js +54 -0
  105. package/dist/insights/errors.js.map +1 -0
  106. package/dist/insights/forecast/budget.d.ts +2 -0
  107. package/dist/insights/forecast/budget.d.ts.map +1 -0
  108. package/dist/insights/forecast/budget.js +6 -0
  109. package/dist/insights/forecast/budget.js.map +1 -0
  110. package/dist/insights/forecast/capacity.d.ts +2 -0
  111. package/dist/insights/forecast/capacity.d.ts.map +1 -0
  112. package/dist/insights/forecast/capacity.js +3 -0
  113. package/dist/insights/forecast/capacity.js.map +1 -0
  114. package/dist/insights/forecast/forecast.d.ts +5 -0
  115. package/dist/insights/forecast/forecast.d.ts.map +1 -0
  116. package/dist/insights/forecast/forecast.js +103 -0
  117. package/dist/insights/forecast/forecast.js.map +1 -0
  118. package/dist/insights/forecast/retention.d.ts +2 -0
  119. package/dist/insights/forecast/retention.d.ts.map +1 -0
  120. package/dist/insights/forecast/retention.js +3 -0
  121. package/dist/insights/forecast/retention.js.map +1 -0
  122. package/dist/insights/index.d.ts +4 -0
  123. package/dist/insights/index.d.ts.map +1 -0
  124. package/dist/insights/index.js +23 -0
  125. package/dist/insights/index.js.map +1 -0
  126. package/dist/insights/insights-client.d.ts +33 -0
  127. package/dist/insights/insights-client.d.ts.map +1 -0
  128. package/dist/insights/insights-client.js +344 -0
  129. package/dist/insights/insights-client.js.map +1 -0
  130. package/dist/insights/llm-subpath.d.ts +4 -0
  131. package/dist/insights/llm-subpath.d.ts.map +1 -0
  132. package/dist/insights/llm-subpath.js +10 -0
  133. package/dist/insights/llm-subpath.js.map +1 -0
  134. package/dist/insights/optimization/cost-optimizer.d.ts +6 -0
  135. package/dist/insights/optimization/cost-optimizer.d.ts.map +1 -0
  136. package/dist/insights/optimization/cost-optimizer.js +98 -0
  137. package/dist/insights/optimization/cost-optimizer.js.map +1 -0
  138. package/dist/insights/optimization/latency-optimizer.d.ts +3 -0
  139. package/dist/insights/optimization/latency-optimizer.d.ts.map +1 -0
  140. package/dist/insights/optimization/latency-optimizer.js +3 -0
  141. package/dist/insights/optimization/latency-optimizer.js.map +1 -0
  142. package/dist/insights/optimization/threshold-advisor.d.ts +2 -0
  143. package/dist/insights/optimization/threshold-advisor.d.ts.map +1 -0
  144. package/dist/insights/optimization/threshold-advisor.js +3 -0
  145. package/dist/insights/optimization/threshold-advisor.js.map +1 -0
  146. package/dist/insights/optimization/token-optimizer.d.ts +4 -0
  147. package/dist/insights/optimization/token-optimizer.d.ts.map +1 -0
  148. package/dist/insights/optimization/token-optimizer.js +133 -0
  149. package/dist/insights/optimization/token-optimizer.js.map +1 -0
  150. package/dist/insights/ranking/contribution.d.ts +2 -0
  151. package/dist/insights/ranking/contribution.d.ts.map +1 -0
  152. package/dist/insights/ranking/contribution.js +6 -0
  153. package/dist/insights/ranking/contribution.js.map +1 -0
  154. package/dist/insights/ranking/helpers.d.ts +22 -0
  155. package/dist/insights/ranking/helpers.d.ts.map +1 -0
  156. package/dist/insights/ranking/helpers.js +88 -0
  157. package/dist/insights/ranking/helpers.js.map +1 -0
  158. package/dist/insights/ranking/pareto.d.ts +2 -0
  159. package/dist/insights/ranking/pareto.d.ts.map +1 -0
  160. package/dist/insights/ranking/pareto.js +6 -0
  161. package/dist/insights/ranking/pareto.js.map +1 -0
  162. package/dist/insights/ranking/slices.d.ts +2 -0
  163. package/dist/insights/ranking/slices.d.ts.map +1 -0
  164. package/dist/insights/ranking/slices.js +6 -0
  165. package/dist/insights/ranking/slices.js.map +1 -0
  166. package/dist/insights/ranking/top-bottom.d.ts +2 -0
  167. package/dist/insights/ranking/top-bottom.d.ts.map +1 -0
  168. package/dist/insights/ranking/top-bottom.js +7 -0
  169. package/dist/insights/ranking/top-bottom.js.map +1 -0
  170. package/dist/insights/recommendations/evidence.d.ts +2 -0
  171. package/dist/insights/recommendations/evidence.d.ts.map +1 -0
  172. package/dist/insights/recommendations/evidence.js +3 -0
  173. package/dist/insights/recommendations/evidence.js.map +1 -0
  174. package/dist/insights/recommendations/recommendation.d.ts +6 -0
  175. package/dist/insights/recommendations/recommendation.d.ts.map +1 -0
  176. package/dist/insights/recommendations/recommendation.js +25 -0
  177. package/dist/insights/recommendations/recommendation.js.map +1 -0
  178. package/dist/insights/recommendations/severity.d.ts +2 -0
  179. package/dist/insights/recommendations/severity.d.ts.map +1 -0
  180. package/dist/insights/recommendations/severity.js +3 -0
  181. package/dist/insights/recommendations/severity.js.map +1 -0
  182. package/dist/insights/rules/evaluate-rules.d.ts +5 -0
  183. package/dist/insights/rules/evaluate-rules.d.ts.map +1 -0
  184. package/dist/insights/rules/evaluate-rules.js +156 -0
  185. package/dist/insights/rules/evaluate-rules.js.map +1 -0
  186. package/dist/insights/types.d.ts +405 -0
  187. package/dist/insights/types.d.ts.map +1 -0
  188. package/dist/insights/types.js +3 -0
  189. package/dist/insights/types.js.map +1 -0
  190. package/dist/insights/utils/formatting.d.ts +4 -0
  191. package/dist/insights/utils/formatting.d.ts.map +1 -0
  192. package/dist/insights/utils/formatting.js +21 -0
  193. package/dist/insights/utils/formatting.js.map +1 -0
  194. package/dist/insights/utils/grouping.d.ts +2 -0
  195. package/dist/insights/utils/grouping.d.ts.map +1 -0
  196. package/dist/insights/utils/grouping.js +8 -0
  197. package/dist/insights/utils/grouping.js.map +1 -0
  198. package/dist/insights/utils/query-builder.d.ts +21 -0
  199. package/dist/insights/utils/query-builder.d.ts.map +1 -0
  200. package/dist/insights/utils/query-builder.js +107 -0
  201. package/dist/insights/utils/query-builder.js.map +1 -0
  202. package/dist/insights/utils/row-value.d.ts +5 -0
  203. package/dist/insights/utils/row-value.d.ts.map +1 -0
  204. package/dist/insights/utils/row-value.js +36 -0
  205. package/dist/insights/utils/row-value.js.map +1 -0
  206. package/dist/insights/utils/stats.d.ts +28 -0
  207. package/dist/insights/utils/stats.d.ts.map +1 -0
  208. package/dist/insights/utils/stats.js +125 -0
  209. package/dist/insights/utils/stats.js.map +1 -0
  210. package/dist/query/formatter.d.ts +2 -2
  211. package/dist/query/formatter.d.ts.map +1 -1
  212. package/dist/query/formatter.js +211 -30
  213. package/dist/query/formatter.js.map +1 -1
  214. package/dist/query/planner.d.ts +10 -2
  215. package/dist/query/planner.d.ts.map +1 -1
  216. package/dist/query/planner.js +55 -4
  217. package/dist/query/planner.js.map +1 -1
  218. package/dist/simulation/context.d.ts +5 -0
  219. package/dist/simulation/context.d.ts.map +1 -0
  220. package/dist/simulation/context.js +56 -0
  221. package/dist/simulation/context.js.map +1 -0
  222. package/dist/simulation/events.d.ts +3 -0
  223. package/dist/simulation/events.d.ts.map +1 -0
  224. package/dist/simulation/events.js +67 -0
  225. package/dist/simulation/events.js.map +1 -0
  226. package/dist/simulation/index.d.ts +7 -0
  227. package/dist/simulation/index.d.ts.map +1 -0
  228. package/dist/simulation/index.js +16 -0
  229. package/dist/simulation/index.js.map +1 -0
  230. package/dist/simulation/prng.d.ts +4 -0
  231. package/dist/simulation/prng.d.ts.map +1 -0
  232. package/dist/simulation/prng.js +18 -0
  233. package/dist/simulation/prng.js.map +1 -0
  234. package/dist/simulation/resource-estimate.d.ts +6 -0
  235. package/dist/simulation/resource-estimate.d.ts.map +1 -0
  236. package/dist/simulation/resource-estimate.js +11 -0
  237. package/dist/simulation/resource-estimate.js.map +1 -0
  238. package/dist/simulation/simulator.d.ts +15 -0
  239. package/dist/simulation/simulator.d.ts.map +1 -0
  240. package/dist/simulation/simulator.js +67 -0
  241. package/dist/simulation/simulator.js.map +1 -0
  242. package/dist/simulation/tracker.d.ts +8 -0
  243. package/dist/simulation/tracker.d.ts.map +1 -0
  244. package/dist/simulation/tracker.js +18 -0
  245. package/dist/simulation/tracker.js.map +1 -0
  246. package/dist/simulation/types.d.ts +49 -0
  247. package/dist/simulation/types.d.ts.map +1 -0
  248. package/dist/simulation/types.js +21 -0
  249. package/dist/simulation/types.js.map +1 -0
  250. package/dist/storage/memory.d.ts +3 -0
  251. package/dist/storage/memory.d.ts.map +1 -1
  252. package/dist/storage/memory.js +113 -4
  253. package/dist/storage/memory.js.map +1 -1
  254. package/dist/storage/mongo.d.ts +5 -0
  255. package/dist/storage/mongo.d.ts.map +1 -1
  256. package/dist/storage/mongo.js +129 -17
  257. package/dist/storage/mongo.js.map +1 -1
  258. package/dist/storage/redis.d.ts +12 -9
  259. package/dist/storage/redis.d.ts.map +1 -1
  260. package/dist/storage/redis.js +126 -47
  261. package/dist/storage/redis.js.map +1 -1
  262. package/dist/types/index.d.ts +139 -4
  263. package/dist/types/index.d.ts.map +1 -1
  264. package/docs/DEPLOYMENT.md +40 -2
  265. package/docs/INSIGHTS.md +59 -0
  266. package/docs/INSIGHTS_ANOMALY_DETECTION.md +33 -0
  267. package/docs/INSIGHTS_LLM_COST_AND_TOKENS.md +26 -0
  268. package/docs/INSIGHTS_RESOURCE_ADVISOR.md +31 -0
  269. package/docs/countex_gap_analysis_complete_checklist.md +1340 -0
  270. package/docs/guides/README.md +34 -0
  271. package/docs/guides/adapter-memory.md +48 -0
  272. package/docs/guides/adapter-mongo.md +62 -0
  273. package/docs/guides/adapter-redis.md +53 -0
  274. package/docs/guides/backup-export.md +83 -0
  275. package/docs/guides/cardinality.md +50 -0
  276. package/docs/guides/cli.md +53 -0
  277. package/docs/guides/client-events.md +49 -0
  278. package/docs/guides/counter-maps.md +122 -0
  279. package/docs/guides/idempotency.md +39 -0
  280. package/docs/guides/ingestion-and-flush.md +67 -0
  281. package/docs/guides/insights-advisors-and-optimization.md +39 -0
  282. package/docs/guides/insights-anomalies-and-rules.md +48 -0
  283. package/docs/guides/insights-comparison-and-trends.md +47 -0
  284. package/docs/guides/insights-forecasting-and-budget.md +61 -0
  285. package/docs/guides/insights-overview.md +82 -0
  286. package/docs/guides/insights-ranking.md +81 -0
  287. package/docs/guides/measures.md +71 -0
  288. package/docs/guides/querying.md +119 -0
  289. package/docs/guides/simulation-profiles.md +33 -0
  290. package/docs/guides/simulation-resource-estimation.md +30 -0
  291. package/docs/guides/simulation.md +36 -0
  292. package/docs/guides/timeframes-and-bucketing.md +55 -0
  293. package/docs/internals/README.md +21 -0
  294. package/docs/internals/internal-architecture-overview.md +65 -0
  295. package/docs/internals/internal-backup-stream.md +23 -0
  296. package/docs/internals/internal-buffer-merge-and-flush.md +51 -0
  297. package/docs/internals/internal-cardinality.md +30 -0
  298. package/docs/internals/internal-dimension-hash.md +34 -0
  299. package/docs/internals/internal-idempotency.md +36 -0
  300. package/docs/internals/internal-ingest-pipeline.md +52 -0
  301. package/docs/internals/internal-insights-layer.md +36 -0
  302. package/docs/internals/internal-mapping-validation-and-extraction.md +59 -0
  303. package/docs/internals/internal-measures-and-scales.md +35 -0
  304. package/docs/internals/internal-query-path.md +46 -0
  305. package/docs/internals/internal-storage-memory.md +13 -0
  306. package/docs/internals/internal-storage-mongo.md +24 -0
  307. package/docs/internals/internal-storage-redis.md +31 -0
  308. package/docs/internals/internal-timeframe-bucketing.md +33 -0
  309. package/docs/use-cases/README.md +56 -0
  310. package/docs/use-cases/audit-security-log-counts.md +550 -0
  311. package/docs/use-cases/llm-cost-and-token-metering.md +255 -0
  312. package/docs/use-cases/multi-tenant-isolation.md +203 -0
  313. package/docs/use-cases/ops-dashboard-daily-rollups.md +255 -0
  314. package/docs/use-cases/processing-workflow-activity.md +165 -0
  315. package/docs/use-cases/product-feature-usage.md +240 -0
  316. package/docs/use-cases/webhook-idempotent-ingestion.md +188 -0
  317. package/package.json +61 -2
@@ -0,0 +1,405 @@
1
+ import type { CounterMap, GroupByField, SubjectFilter, TimeframeRange } from "../types/index.js";
2
+ export type GroupByKey = GroupByField;
3
+ export type InsightMeasureSelector = "count" | `${string}.sum` | `${string}.count` | `${string}.min` | `${string}.max` | `${string}.avg` | `${string}.rate`;
4
+ export type InsightSafetyOptions = {
5
+ limit?: number;
6
+ maxGroups?: number;
7
+ maxBuckets?: number;
8
+ maxCellsScanned?: number;
9
+ requireIndexedQuery?: boolean;
10
+ signal?: AbortSignal;
11
+ };
12
+ export type InsightDefaults = {
13
+ maxGroups: number;
14
+ maxBuckets: number;
15
+ queryTimeoutMs: number;
16
+ minBaselineBuckets: number;
17
+ resultLimit: number;
18
+ };
19
+ export type InsightBaseInput = {
20
+ scope: string;
21
+ counterId: string;
22
+ timeframe: TimeframeRange;
23
+ filters?: {
24
+ subject?: SubjectFilter;
25
+ metrics?: Array<string | number>;
26
+ dimensions?: Record<string, Array<string | number | boolean | null>>;
27
+ };
28
+ groupBy?: GroupByKey[];
29
+ measure?: InsightMeasureSelector;
30
+ limit?: number;
31
+ maxGroups?: number;
32
+ maxBuckets?: number;
33
+ bypassCache?: boolean;
34
+ signal?: AbortSignal;
35
+ };
36
+ export type RankingRow = {
37
+ rank: number;
38
+ keys: Record<string, unknown>;
39
+ value: number;
40
+ shareOfTotal?: number;
41
+ cumulativeShare?: number;
42
+ };
43
+ export type RankingResult = {
44
+ rows: RankingRow[];
45
+ total?: number;
46
+ source: "cache" | "durable" | "merged";
47
+ };
48
+ export type TopNInput = InsightBaseInput & {
49
+ n: number;
50
+ includeTotal?: boolean;
51
+ };
52
+ export type BottomNInput = InsightBaseInput & {
53
+ n: number;
54
+ includeTotal?: boolean;
55
+ includeZeroes?: boolean;
56
+ zeroUniverse?: "knownSubjects" | "providedList";
57
+ };
58
+ export type PercentSliceInput = InsightBaseInput & {
59
+ percent: number;
60
+ includeTotal?: boolean;
61
+ };
62
+ export type PercentSliceResult = {
63
+ selectedPercent: number;
64
+ selectedCount: number;
65
+ totalGroups: number;
66
+ selectedValue: number;
67
+ totalValue: number;
68
+ selectedShareOfTotal: number;
69
+ rows: RankingRow[];
70
+ source: RankingResult["source"];
71
+ };
72
+ export type ParetoInput = InsightBaseInput & {
73
+ targetShare: number;
74
+ };
75
+ export type ParetoResult = {
76
+ targetShare: number;
77
+ contributorsNeeded: number;
78
+ totalGroups: number;
79
+ contributorPercent: number;
80
+ achievedShare: number;
81
+ totalValue: number;
82
+ rows: RankingRow[];
83
+ source: RankingResult["source"];
84
+ };
85
+ export type ContributionResult = {
86
+ total: number;
87
+ rows: Array<{
88
+ keys: Record<string, unknown>;
89
+ value: number;
90
+ share: number;
91
+ cumulativeShare: number;
92
+ }>;
93
+ source: RankingResult["source"];
94
+ };
95
+ export type ComparePeriodsInput = Omit<InsightBaseInput, "timeframe"> & {
96
+ current: TimeframeRange;
97
+ previous: TimeframeRange;
98
+ minAbsoluteChange?: number;
99
+ minPercentChange?: number;
100
+ };
101
+ export type ComparePeriodsResult = {
102
+ rows: Array<{
103
+ keys: Record<string, unknown>;
104
+ current: number;
105
+ previous: number;
106
+ absoluteChange: number;
107
+ percentChange: number | null;
108
+ direction: "up" | "down" | "flat" | "new" | "missing";
109
+ significance: "low" | "medium" | "high";
110
+ }>;
111
+ };
112
+ export type TrendInput = InsightBaseInput & {
113
+ method: "linear" | "moving_average" | "simple_growth";
114
+ movingAverageWindow?: number;
115
+ };
116
+ export type TrendResult = {
117
+ rows: Array<{
118
+ keys: Record<string, unknown>;
119
+ slope: number;
120
+ direction: "up" | "down" | "flat";
121
+ startValue: number;
122
+ endValue: number;
123
+ changePercent: number | null;
124
+ r2?: number;
125
+ }>;
126
+ source: RankingResult["source"];
127
+ };
128
+ export type ForecastInput = InsightBaseInput & {
129
+ history: TimeframeRange;
130
+ forecastTo: string;
131
+ method: "linear" | "moving_average" | "same_period_projection" | "weekly_seasonality_light";
132
+ };
133
+ export type ForecastResult = {
134
+ rows: Array<{
135
+ keys: Record<string, unknown>;
136
+ observedToDate: number;
137
+ projectedTotal: number;
138
+ confidence: "low" | "medium" | "high";
139
+ method: string;
140
+ explanation: string;
141
+ }>;
142
+ recommendations: CountexRecommendation[];
143
+ };
144
+ export type DetectAnomaliesInput = InsightBaseInput & {
145
+ baseline?: {
146
+ lookback?: string;
147
+ compareBy?: "previous-period" | "same-hour-of-day" | "same-day-of-week" | "rolling";
148
+ minBuckets?: number;
149
+ };
150
+ method?: "robust-zscore" | "zscore" | "ewma" | "threshold";
151
+ sensitivity?: "low" | "medium" | "high";
152
+ anomalyTypes?: Array<"spike" | "drop" | "missing" | "new" | "cardinality">;
153
+ };
154
+ export type AnomalyResult = {
155
+ anomalies: Array<{
156
+ type: "spike" | "drop" | "missing" | "new" | "cardinality";
157
+ severity: "low" | "medium" | "high" | "critical";
158
+ keys: Record<string, unknown>;
159
+ timeframeKey: string;
160
+ observed: number;
161
+ expected?: number;
162
+ baseline?: {
163
+ median?: number;
164
+ mean?: number;
165
+ stddev?: number;
166
+ mad?: number;
167
+ bucketCount: number;
168
+ };
169
+ score?: number;
170
+ explanation: string;
171
+ }>;
172
+ };
173
+ export type RuleAbsolute = {
174
+ id: string;
175
+ counterId: string;
176
+ measure: InsightMeasureSelector;
177
+ timeframe: TimeframeRange;
178
+ groupBy?: GroupByKey[];
179
+ filters?: InsightBaseInput["filters"];
180
+ warnAbove?: number;
181
+ criticalAbove?: number;
182
+ };
183
+ export type RuleRatio = {
184
+ id: string;
185
+ counterId: string;
186
+ timeframe: TimeframeRange;
187
+ groupBy?: GroupByKey[];
188
+ filters?: InsightBaseInput["filters"];
189
+ ratio: {
190
+ numerator: {
191
+ metric?: string | number;
192
+ measure?: InsightMeasureSelector;
193
+ };
194
+ denominator: {
195
+ metric?: string | number;
196
+ measure?: InsightMeasureSelector;
197
+ };
198
+ };
199
+ warnAbove?: number;
200
+ criticalAbove?: number;
201
+ };
202
+ export type InsightRule = RuleAbsolute | RuleRatio;
203
+ export type EvaluateRulesInput = {
204
+ scope: string;
205
+ rules: InsightRule[];
206
+ maxGroups?: number;
207
+ bypassCache?: boolean;
208
+ signal?: AbortSignal;
209
+ };
210
+ export type RuleEvaluationResult = {
211
+ passed: number;
212
+ warned: number;
213
+ critical: number;
214
+ results: Array<{
215
+ ruleId: string;
216
+ status: "pass" | "warn" | "critical";
217
+ keys?: Record<string, unknown>;
218
+ value: number;
219
+ threshold?: number;
220
+ recommendation?: CountexRecommendation;
221
+ }>;
222
+ };
223
+ export type CountexRecommendation = {
224
+ id: string;
225
+ type: string;
226
+ severity: "info" | "low" | "medium" | "high" | "critical";
227
+ confidence: "low" | "medium" | "high";
228
+ scope: string;
229
+ counterId: string;
230
+ title: string;
231
+ explanation: string;
232
+ evidence: {
233
+ timeframe?: TimeframeRange;
234
+ group?: Record<string, unknown>;
235
+ values?: Record<string, number | string | boolean | null>;
236
+ rows?: unknown[];
237
+ baseline?: unknown;
238
+ };
239
+ suggestedAction?: {
240
+ kind: string;
241
+ payload: unknown;
242
+ };
243
+ estimatedImpact?: {
244
+ unit?: string;
245
+ value?: number;
246
+ percent?: number;
247
+ explanation?: string;
248
+ };
249
+ };
250
+ export type RecommendMaxTokensInput = InsightBaseInput & {
251
+ outputTokenMeasure: string;
252
+ currentMaxTokens?: {
253
+ source: "provided";
254
+ values: Array<{
255
+ keys: Record<string, unknown>;
256
+ value: number;
257
+ }>;
258
+ } | {
259
+ source: "constant";
260
+ value: number;
261
+ } | {
262
+ source: "dimension";
263
+ dimension: string;
264
+ };
265
+ targetCoverage?: number;
266
+ safetyMultiplier?: number;
267
+ minCalls?: number;
268
+ roundTo?: number;
269
+ };
270
+ export type MaxTokenRecommendationResult = {
271
+ recommendations: Array<CountexRecommendation & {
272
+ type: "max_tokens_oversized" | "max_tokens_too_low" | "insufficient_data";
273
+ values: {
274
+ observedCalls: number;
275
+ observedAvg?: number;
276
+ observedP50?: number;
277
+ observedP75?: number;
278
+ observedP90?: number;
279
+ observedP95?: number;
280
+ observedP99?: number;
281
+ observedMax?: number;
282
+ currentMaxTokens?: number;
283
+ recommendedMaxTokens?: number;
284
+ };
285
+ }>;
286
+ };
287
+ export type CostDriversInput = InsightBaseInput & {
288
+ costMeasure: InsightMeasureSelector;
289
+ };
290
+ export type CostDriversResult = {
291
+ totalCost: number;
292
+ rows: RankingRow[];
293
+ recommendations: CountexRecommendation[];
294
+ };
295
+ export type BudgetProjectionInput = Omit<InsightBaseInput, "timeframe"> & {
296
+ currentWindow: TimeframeRange;
297
+ targetWindow: TimeframeRange;
298
+ measure: InsightMeasureSelector;
299
+ budget: number;
300
+ };
301
+ export type BudgetProjectionResult = {
302
+ observed: number;
303
+ projected: number;
304
+ budget: number;
305
+ projectedBudgetUsage: number;
306
+ status: "under" | "near" | "over";
307
+ recommendations: CountexRecommendation[];
308
+ };
309
+ export type MapHealthInput = InsightBaseInput & {
310
+ includeRecommendations?: boolean;
311
+ };
312
+ export type MapHealthResult = {
313
+ summary: {
314
+ uniqueCells: number;
315
+ avgCellsPerBucket: number;
316
+ estimatedIncrementsPerEvent?: number;
317
+ cardinalityStatus: "healthy" | "watch" | "risky" | "critical";
318
+ };
319
+ dimensions: Array<{
320
+ name: string;
321
+ distinctValues: number;
322
+ shareOfCells?: number;
323
+ status: "healthy" | "watch" | "risky" | "critical";
324
+ examples?: unknown[];
325
+ }>;
326
+ subjects: Array<{
327
+ subjectType: string;
328
+ distinctValues: number;
329
+ status: "healthy" | "watch" | "risky" | "critical";
330
+ }>;
331
+ metrics: {
332
+ distinctValues: number;
333
+ status: "healthy" | "watch" | "risky" | "critical";
334
+ };
335
+ recommendations: CountexRecommendation[];
336
+ };
337
+ export type ResourceAdvisorInput = {
338
+ scope: string;
339
+ counterId: string;
340
+ sampleWindow: TimeframeRange;
341
+ targetRetention: {
342
+ day?: number;
343
+ week?: number;
344
+ month?: number;
345
+ quarter?: number;
346
+ year?: number;
347
+ all?: boolean;
348
+ };
349
+ constants?: {
350
+ redisBytesPerCell?: number;
351
+ mongoBytesPerCell?: number;
352
+ dictionaryBytesPerKey?: number;
353
+ };
354
+ bypassCache?: boolean;
355
+ signal?: AbortSignal;
356
+ };
357
+ export type ResourceAdvisorResult = {
358
+ observed: {
359
+ sampleDays: number;
360
+ cellsPerDayAvg: number;
361
+ cellsPerDayP95?: number;
362
+ dictionaryKeys: number;
363
+ };
364
+ projected: {
365
+ hotCells: number;
366
+ durableCells: number;
367
+ redisBytes: number;
368
+ mongoBytes: number;
369
+ dictionaryBytes: number;
370
+ };
371
+ recommended: {
372
+ redisRamGb: number;
373
+ mongoDiskGb: number;
374
+ workerRamMb?: number;
375
+ };
376
+ assumptions: Record<string, unknown>;
377
+ recommendations: CountexRecommendation[];
378
+ };
379
+ export type CreateCountexInsightsConfig = {
380
+ countex: import("../core/countex.js").Countex;
381
+ /** Required for `estimateResourcesFromActuals` (`streamCells`). */
382
+ durable?: import("../types/index.js").DurableStorage;
383
+ mapsByCounterId?: Map<string, CounterMap> | Record<string, CounterMap>;
384
+ defaults?: Partial<InsightDefaults>;
385
+ };
386
+ export type CountexInsightsEvents = {
387
+ insight_query: {
388
+ type: string;
389
+ counterId: string;
390
+ durationMs: number;
391
+ };
392
+ recommendation: {
393
+ type: string;
394
+ severity: CountexRecommendation["severity"];
395
+ };
396
+ anomaly: {
397
+ type: string;
398
+ severity: string;
399
+ };
400
+ insufficient_data: {
401
+ insightType: string;
402
+ reason: string;
403
+ };
404
+ };
405
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/insights/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/insights/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ /** Stable JSON key for grouped query keys (order-independent). */
2
+ export declare function stableSerializedGroupKeys(keys: Record<string, string | number | undefined> | null | undefined): string;
3
+ export declare function stableKey(record: Record<string, unknown>): string;
4
+ //# sourceMappingURL=formatting.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/insights/utils/formatting.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,GACnE,MAAM,CAOR;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMjE"}
@@ -0,0 +1,21 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.stableSerializedGroupKeys = stableSerializedGroupKeys;
4
+ exports.stableKey = stableKey;
5
+ /** Stable JSON key for grouped query keys (order-independent). */
6
+ function stableSerializedGroupKeys(keys) {
7
+ const o = keys ?? {};
8
+ const sorted = {};
9
+ for (const k of Object.keys(o).sort()) {
10
+ sorted[k] = o[k];
11
+ }
12
+ return JSON.stringify(sorted);
13
+ }
14
+ function stableKey(record) {
15
+ const sorted = {};
16
+ for (const k of Object.keys(record).sort()) {
17
+ sorted[k] = record[k];
18
+ }
19
+ return JSON.stringify(sorted);
20
+ }
21
+ //# sourceMappingURL=formatting.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formatting.js","sourceRoot":"","sources":["../../../src/insights/utils/formatting.ts"],"names":[],"mappings":";;AACA,8DASC;AAED,8BAMC;AAlBD,kEAAkE;AAClE,SAAgB,yBAAyB,CACvC,IAAoE;IAEpE,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,MAAM,GAAgD,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,SAAS,CAAC,MAA+B;IACvD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function clusterKey(keys: Record<string, string | number | undefined> | undefined): string;
2
+ //# sourceMappingURL=grouping.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../../../src/insights/utils/grouping.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,MAAM,CAEhG"}
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.clusterKey = clusterKey;
4
+ const formatting_js_1 = require("./formatting.js");
5
+ function clusterKey(keys) {
6
+ return (0, formatting_js_1.stableSerializedGroupKeys)(keys);
7
+ }
8
+ //# sourceMappingURL=grouping.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"grouping.js","sourceRoot":"","sources":["../../../src/insights/utils/grouping.ts"],"names":[],"mappings":";;AAEA,gCAEC;AAJD,mDAA4D;AAE5D,SAAgB,UAAU,CAAC,IAA6D;IACtF,OAAO,IAAA,yCAAyB,EAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}
@@ -0,0 +1,21 @@
1
+ import type { QuerySpec, QueryOrderByMeasure } from "../../types/index.js";
2
+ import type { InsightBaseInput, InsightDefaults, InsightMeasureSelector } from "../types.js";
3
+ export type ParsedMeasure = {
4
+ kind: "count";
5
+ } | {
6
+ kind: "measure";
7
+ name: string;
8
+ agg: QueryOrderByMeasure["agg"];
9
+ }
10
+ /** Rates always use measure sum over elapsed window / bucket (core QuerySpec limitation). */
11
+ | {
12
+ kind: "rate";
13
+ name: string;
14
+ };
15
+ export declare function parseMeasureSelector(sel: InsightMeasureSelector | undefined): ParsedMeasure;
16
+ export declare function assertBucketSafety(timeframe: InsightBaseInput["timeframe"], maxBuckets: number): void;
17
+ export declare function mergeAbortSignals(user?: AbortSignal, timeoutMs?: number): AbortSignal | undefined;
18
+ export declare function baseToQuerySpec(input: InsightBaseInput, defaults: InsightDefaults, overrides: Partial<QuerySpec>): QuerySpec;
19
+ export declare function applyParsedMeasureToSpec(spec: QuerySpec, parsed: ParsedMeasure, dir?: "asc" | "desc"): QuerySpec;
20
+ export declare function enforceMaxGroups(rowCount: number, maxGroups: number): void;
21
+ //# sourceMappingURL=query-builder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../src/insights/utils/query-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAG7F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAA;CAAE;AACpE,6FAA6F;GAC3F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,GAAG,SAAS,GAAG,aAAa,CAiB3F;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,EACxC,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CA+BjG;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAC5B,SAAS,CAsBX;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,aAAa,EACrB,GAAG,GAAE,KAAK,GAAG,MAAe,GAC3B,SAAS,CAeX;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAO1E"}
@@ -0,0 +1,107 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.parseMeasureSelector = parseMeasureSelector;
4
+ exports.assertBucketSafety = assertBucketSafety;
5
+ exports.mergeAbortSignals = mergeAbortSignals;
6
+ exports.baseToQuerySpec = baseToQuerySpec;
7
+ exports.applyParsedMeasureToSpec = applyParsedMeasureToSpec;
8
+ exports.enforceMaxGroups = enforceMaxGroups;
9
+ const timeframe_js_1 = require("../../core/timeframe.js");
10
+ const errors_js_1 = require("../errors.js");
11
+ function parseMeasureSelector(sel) {
12
+ if (!sel || sel === "count")
13
+ return { kind: "count" };
14
+ if (sel.endsWith(".rate")) {
15
+ const name = sel.slice(0, -".rate".length);
16
+ if (!name)
17
+ throw new errors_js_1.UnsupportedMeasureError("Invalid rate measure selector");
18
+ return { kind: "rate", name };
19
+ }
20
+ const parts = sel.split(".");
21
+ if (parts.length !== 2) {
22
+ throw new errors_js_1.UnsupportedMeasureError(`Expected measure selector like name.sum, got: ${sel}`);
23
+ }
24
+ const [name, agg] = parts;
25
+ if (!name)
26
+ throw new errors_js_1.UnsupportedMeasureError(`Invalid measure name in ${sel}`);
27
+ if (agg === "sum" || agg === "count" || agg === "min" || agg === "max" || agg === "avg") {
28
+ return { kind: "measure", name, agg };
29
+ }
30
+ throw new errors_js_1.UnsupportedMeasureError(`Unsupported aggregation: ${agg}`);
31
+ }
32
+ function assertBucketSafety(timeframe, maxBuckets) {
33
+ const buckets = (0, timeframe_js_1.bucketRange)(timeframe.type, timeframe.from, timeframe.to);
34
+ if (buckets.length > maxBuckets) {
35
+ throw new errors_js_1.InsightQueryTooBroadError(`This insight would scan ${buckets.length} timeframe buckets (limit ${maxBuckets}). Narrow the timeframe or increase maxBuckets.`, { bucketCount: buckets.length, maxBuckets });
36
+ }
37
+ }
38
+ function mergeAbortSignals(user, timeoutMs) {
39
+ if (!user && !(timeoutMs !== undefined && timeoutMs > 0))
40
+ return undefined;
41
+ if (user && !(timeoutMs !== undefined && timeoutMs > 0))
42
+ return user;
43
+ const merged = new AbortController();
44
+ let to;
45
+ const cancelTimer = () => {
46
+ if (to !== undefined)
47
+ clearTimeout(to);
48
+ };
49
+ if (timeoutMs !== undefined && timeoutMs > 0) {
50
+ to = setTimeout(() => merged.abort(), timeoutMs);
51
+ }
52
+ if (user) {
53
+ if (user.aborted) {
54
+ cancelTimer();
55
+ merged.abort();
56
+ return merged.signal;
57
+ }
58
+ user.addEventListener("abort", () => {
59
+ cancelTimer();
60
+ merged.abort();
61
+ }, { once: true });
62
+ }
63
+ return merged.signal;
64
+ }
65
+ function baseToQuerySpec(input, defaults, overrides) {
66
+ const maxBuckets = input.maxBuckets ?? defaults.maxBuckets;
67
+ assertBucketSafety(input.timeframe, maxBuckets);
68
+ const spec = {
69
+ scope: input.scope,
70
+ counterId: input.counterId,
71
+ timeframe: input.timeframe,
72
+ bypassCache: input.bypassCache,
73
+ signal: mergeAbortSignals(input.signal, defaults.queryTimeoutMs > 0 ? defaults.queryTimeoutMs : undefined),
74
+ ...overrides,
75
+ };
76
+ if (input.filters?.subject)
77
+ spec.subject = input.filters.subject;
78
+ if (input.filters?.metrics)
79
+ spec.metrics = input.filters.metrics;
80
+ if (input.filters?.dimensions)
81
+ spec.dimensions = input.filters.dimensions;
82
+ if (input.groupBy?.length)
83
+ spec.groupBy = input.groupBy;
84
+ return spec;
85
+ }
86
+ function applyParsedMeasureToSpec(spec, parsed, dir = "desc") {
87
+ const next = { ...spec };
88
+ if (parsed.kind === "count") {
89
+ next.orderBy = next.orderBy ?? (dir === "desc" ? "-count" : "count");
90
+ return next;
91
+ }
92
+ if (parsed.kind === "rate") {
93
+ next.measures = [...(next.measures === "*" ? [] : next.measures ?? []), parsed.name];
94
+ next.rate = { of: { measure: parsed.name, agg: "sum" }, per: "hour" };
95
+ next.orderBy = { measure: parsed.name, agg: "sum", dir };
96
+ return next;
97
+ }
98
+ next.measures = [...(next.measures === "*" ? [] : next.measures ?? []), parsed.name];
99
+ next.orderBy = { measure: parsed.name, agg: parsed.agg, dir };
100
+ return next;
101
+ }
102
+ function enforceMaxGroups(rowCount, maxGroups) {
103
+ if (rowCount > maxGroups) {
104
+ throw new errors_js_1.InsightQueryTooBroadError(`Insight grouped result has ${rowCount} groups (limit ${maxGroups}). Add filters, reduce cardinality, or increase maxGroups.`, { rowCount, maxGroups });
105
+ }
106
+ }
107
+ //# sourceMappingURL=query-builder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../../../src/insights/utils/query-builder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { QueryRow } from "../../types/index.js";
2
+ import type { ParsedMeasure } from "./query-builder.js";
3
+ export declare function rowValue(row: QueryRow, parsed: ParsedMeasure): number;
4
+ export declare function keysToUnknown(keys: Record<string, string | number>): Record<string, unknown>;
5
+ //# sourceMappingURL=row-value.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"row-value.d.ts","sourceRoot":"","sources":["../../../src/insights/utils/row-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAuBrE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5F"}