@duckcodeailabs/dql-core 0.1.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 (74) hide show
  1. package/LICENSE +123 -0
  2. package/dist/ast/index.d.ts +4 -0
  3. package/dist/ast/index.d.ts.map +1 -0
  4. package/dist/ast/index.js +4 -0
  5. package/dist/ast/index.js.map +1 -0
  6. package/dist/ast/nodes.d.ts +205 -0
  7. package/dist/ast/nodes.d.ts.map +1 -0
  8. package/dist/ast/nodes.js +33 -0
  9. package/dist/ast/nodes.js.map +1 -0
  10. package/dist/ast/printer.d.ts +3 -0
  11. package/dist/ast/printer.d.ts.map +1 -0
  12. package/dist/ast/printer.js +157 -0
  13. package/dist/ast/printer.js.map +1 -0
  14. package/dist/ast/visitor.d.ts +45 -0
  15. package/dist/ast/visitor.d.ts.map +1 -0
  16. package/dist/ast/visitor.js +155 -0
  17. package/dist/ast/visitor.js.map +1 -0
  18. package/dist/errors/diagnostic.d.ts +23 -0
  19. package/dist/errors/diagnostic.d.ts.map +1 -0
  20. package/dist/errors/diagnostic.js +13 -0
  21. package/dist/errors/diagnostic.js.map +1 -0
  22. package/dist/errors/index.d.ts +3 -0
  23. package/dist/errors/index.d.ts.map +1 -0
  24. package/dist/errors/index.js +3 -0
  25. package/dist/errors/index.js.map +1 -0
  26. package/dist/errors/reporter.d.ts +22 -0
  27. package/dist/errors/reporter.d.ts.map +1 -0
  28. package/dist/errors/reporter.js +64 -0
  29. package/dist/errors/reporter.js.map +1 -0
  30. package/dist/formatter/formatter.d.ts +8 -0
  31. package/dist/formatter/formatter.d.ts.map +1 -0
  32. package/dist/formatter/formatter.js +243 -0
  33. package/dist/formatter/formatter.js.map +1 -0
  34. package/dist/formatter/index.d.ts +2 -0
  35. package/dist/formatter/index.d.ts.map +1 -0
  36. package/dist/formatter/index.js +2 -0
  37. package/dist/formatter/index.js.map +1 -0
  38. package/dist/index.d.ts +7 -0
  39. package/dist/index.d.ts.map +1 -0
  40. package/dist/index.js +9 -0
  41. package/dist/index.js.map +1 -0
  42. package/dist/lexer/index.d.ts +3 -0
  43. package/dist/lexer/index.d.ts.map +1 -0
  44. package/dist/lexer/index.js +3 -0
  45. package/dist/lexer/index.js.map +1 -0
  46. package/dist/lexer/lexer.d.ts +43 -0
  47. package/dist/lexer/lexer.d.ts.map +1 -0
  48. package/dist/lexer/lexer.js +346 -0
  49. package/dist/lexer/lexer.js.map +1 -0
  50. package/dist/lexer/token.d.ts +72 -0
  51. package/dist/lexer/token.d.ts.map +1 -0
  52. package/dist/lexer/token.js +170 -0
  53. package/dist/lexer/token.js.map +1 -0
  54. package/dist/parser/index.d.ts +2 -0
  55. package/dist/parser/index.d.ts.map +1 -0
  56. package/dist/parser/index.js +2 -0
  57. package/dist/parser/index.js.map +1 -0
  58. package/dist/parser/parser.d.ts +50 -0
  59. package/dist/parser/parser.d.ts.map +1 -0
  60. package/dist/parser/parser.js +1024 -0
  61. package/dist/parser/parser.js.map +1 -0
  62. package/dist/semantic/analyzer.d.ts +27 -0
  63. package/dist/semantic/analyzer.d.ts.map +1 -0
  64. package/dist/semantic/analyzer.js +580 -0
  65. package/dist/semantic/analyzer.js.map +1 -0
  66. package/dist/semantic/index.d.ts +4 -0
  67. package/dist/semantic/index.d.ts.map +1 -0
  68. package/dist/semantic/index.js +3 -0
  69. package/dist/semantic/index.js.map +1 -0
  70. package/dist/semantic/semantic-layer.d.ts +118 -0
  71. package/dist/semantic/semantic-layer.d.ts.map +1 -0
  72. package/dist/semantic/semantic-layer.js +264 -0
  73. package/dist/semantic/semantic-layer.js.map +1 -0
  74. package/package.json +49 -0
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Semantic Layer: metric and dimension definitions parsed from YAML configs.
3
+ * Maps to the architecture spec's semantic-layer/ directory structure.
4
+ */
5
+ export interface MetricDefinition {
6
+ name: string;
7
+ label: string;
8
+ description: string;
9
+ domain: string;
10
+ sql: string;
11
+ type: 'sum' | 'count' | 'count_distinct' | 'avg' | 'min' | 'max' | 'custom';
12
+ table: string;
13
+ filters?: Record<string, string>;
14
+ tags?: string[];
15
+ owner?: string;
16
+ }
17
+ export interface DimensionDefinition {
18
+ name: string;
19
+ label: string;
20
+ description: string;
21
+ sql: string;
22
+ type: 'string' | 'number' | 'date' | 'boolean';
23
+ table: string;
24
+ tags?: string[];
25
+ }
26
+ export type HierarchyRollupType = 'sum' | 'count' | 'count_distinct' | 'avg' | 'min' | 'max' | 'none';
27
+ export interface HierarchyLevelDefinition {
28
+ name: string;
29
+ label: string;
30
+ description: string;
31
+ dimension: string;
32
+ sql?: string;
33
+ order: number;
34
+ tags?: string[];
35
+ metadata?: Record<string, unknown>;
36
+ }
37
+ export interface HierarchyDrillPathDefinition {
38
+ name: string;
39
+ levels: string[];
40
+ }
41
+ export interface HierarchyDefinition {
42
+ name: string;
43
+ label: string;
44
+ description: string;
45
+ domain?: string;
46
+ levels: HierarchyLevelDefinition[];
47
+ drillPaths?: HierarchyDrillPathDefinition[];
48
+ defaultDrillPath?: string;
49
+ defaultRollup?: HierarchyRollupType;
50
+ tags?: string[];
51
+ owner?: string;
52
+ }
53
+ export interface BlockCompanionDefinition {
54
+ name: string;
55
+ block: string;
56
+ domain?: string;
57
+ description: string;
58
+ owner?: string;
59
+ tags?: string[];
60
+ glossary?: string[];
61
+ semanticMappings?: Record<string, string>;
62
+ lineage?: string[];
63
+ notes?: string[];
64
+ reviewStatus?: 'draft' | 'review' | 'approved';
65
+ }
66
+ export interface SemanticLayerConfig {
67
+ metrics: MetricDefinition[];
68
+ dimensions: DimensionDefinition[];
69
+ hierarchies?: HierarchyDefinition[];
70
+ }
71
+ /**
72
+ * Parse a YAML-like metric definition object into a MetricDefinition.
73
+ * In production, this would use a YAML parser. For now, accepts plain objects.
74
+ */
75
+ export declare function parseMetricDefinition(raw: Record<string, unknown>): MetricDefinition;
76
+ export declare function parseDimensionDefinition(raw: Record<string, unknown>): DimensionDefinition;
77
+ export declare function parseHierarchyDefinition(raw: Record<string, unknown>): HierarchyDefinition;
78
+ export declare function parseBlockCompanionDefinition(raw: Record<string, unknown>): BlockCompanionDefinition;
79
+ /**
80
+ * SemanticLayer holds all metric and dimension definitions and provides
81
+ * lookup and search capabilities for the AI agent pipeline.
82
+ */
83
+ export declare class SemanticLayer {
84
+ private metrics;
85
+ private dimensions;
86
+ private hierarchies;
87
+ constructor(config?: SemanticLayerConfig);
88
+ addMetric(metric: MetricDefinition): void;
89
+ addDimension(dimension: DimensionDefinition): void;
90
+ addHierarchy(hierarchy: HierarchyDefinition): void;
91
+ getMetric(name: string): MetricDefinition | undefined;
92
+ getDimension(name: string): DimensionDefinition | undefined;
93
+ getHierarchy(name: string): HierarchyDefinition | undefined;
94
+ listMetrics(domain?: string): MetricDefinition[];
95
+ listDimensions(): DimensionDefinition[];
96
+ listHierarchies(domain?: string): HierarchyDefinition[];
97
+ resolveDrillPath(hierarchyName: string, drillPathName?: string): HierarchyLevelDefinition[];
98
+ nextDrillLevel(hierarchyName: string, currentLevelName?: string, drillPathName?: string): HierarchyLevelDefinition | null;
99
+ /**
100
+ * Search metrics and dimensions by text query.
101
+ */
102
+ search(query: string): {
103
+ metrics: MetricDefinition[];
104
+ dimensions: DimensionDefinition[];
105
+ };
106
+ /**
107
+ * Validate that all metric references in a SQL query resolve to known metrics/dimensions.
108
+ */
109
+ validateReferences(references: string[]): {
110
+ valid: string[];
111
+ unknown: string[];
112
+ };
113
+ /**
114
+ * Generate SQL for a metric with optional dimension grouping.
115
+ */
116
+ generateMetricSQL(metricName: string, groupBy?: string[]): string | null;
117
+ }
118
+ //# sourceMappingURL=semantic-layer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"semantic-layer.d.ts","sourceRoot":"","sources":["../../src/semantic/semantic-layer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,264 @@
1
+ /**
2
+ * Semantic Layer: metric and dimension definitions parsed from YAML configs.
3
+ * Maps to the architecture spec's semantic-layer/ directory structure.
4
+ */
5
+ /**
6
+ * Parse a YAML-like metric definition object into a MetricDefinition.
7
+ * In production, this would use a YAML parser. For now, accepts plain objects.
8
+ */
9
+ export function parseMetricDefinition(raw) {
10
+ return {
11
+ name: String(raw.name ?? ''),
12
+ label: String(raw.label ?? raw.name ?? ''),
13
+ description: String(raw.description ?? ''),
14
+ domain: String(raw.domain ?? ''),
15
+ sql: String(raw.sql ?? ''),
16
+ type: validateMetricType(String(raw.type ?? 'sum')),
17
+ table: String(raw.table ?? ''),
18
+ filters: raw.filters,
19
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : undefined,
20
+ owner: raw.owner ? String(raw.owner) : undefined,
21
+ };
22
+ }
23
+ export function parseDimensionDefinition(raw) {
24
+ return {
25
+ name: String(raw.name ?? ''),
26
+ label: String(raw.label ?? raw.name ?? ''),
27
+ description: String(raw.description ?? ''),
28
+ sql: String(raw.sql ?? ''),
29
+ type: validateDimensionType(String(raw.type ?? 'string')),
30
+ table: String(raw.table ?? ''),
31
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : undefined,
32
+ };
33
+ }
34
+ export function parseHierarchyDefinition(raw) {
35
+ const levelsRaw = Array.isArray(raw.levels) ? raw.levels : [];
36
+ const levels = levelsRaw.reduce((acc, level, index) => {
37
+ if (!level || typeof level !== 'object' || Array.isArray(level))
38
+ return acc;
39
+ const levelRaw = level;
40
+ const orderVal = Number(levelRaw.order);
41
+ acc.push({
42
+ name: String(levelRaw.name ?? `level_${index + 1}`),
43
+ label: String(levelRaw.label ?? levelRaw.name ?? `Level ${index + 1}`),
44
+ description: String(levelRaw.description ?? ''),
45
+ dimension: String(levelRaw.dimension ?? levelRaw.name ?? ''),
46
+ sql: levelRaw.sql != null ? String(levelRaw.sql) : undefined,
47
+ order: Number.isFinite(orderVal) ? orderVal : index + 1,
48
+ tags: Array.isArray(levelRaw.tags) ? levelRaw.tags.map(String) : undefined,
49
+ metadata: levelRaw.metadata && typeof levelRaw.metadata === 'object' && !Array.isArray(levelRaw.metadata)
50
+ ? levelRaw.metadata
51
+ : undefined,
52
+ });
53
+ return acc;
54
+ }, []).sort((a, b) => a.order - b.order);
55
+ const drillPathsRaw = Array.isArray(raw.drillPaths) ? raw.drillPaths : [];
56
+ const drillPaths = drillPathsRaw.reduce((acc, path, index) => {
57
+ if (!path || typeof path !== 'object' || Array.isArray(path))
58
+ return acc;
59
+ const pathRaw = path;
60
+ const pathLevels = Array.isArray(pathRaw.levels)
61
+ ? pathRaw.levels.map(String)
62
+ : levels.map((level) => level.name);
63
+ acc.push({
64
+ name: String(pathRaw.name ?? `path_${index + 1}`),
65
+ levels: pathLevels,
66
+ });
67
+ return acc;
68
+ }, []);
69
+ return {
70
+ name: String(raw.name ?? ''),
71
+ label: String(raw.label ?? raw.name ?? ''),
72
+ description: String(raw.description ?? ''),
73
+ domain: raw.domain != null ? String(raw.domain) : undefined,
74
+ levels,
75
+ drillPaths: drillPaths.length > 0 ? drillPaths : undefined,
76
+ defaultDrillPath: raw.defaultDrillPath != null ? String(raw.defaultDrillPath) : undefined,
77
+ defaultRollup: validateRollupType(String(raw.defaultRollup ?? 'sum')),
78
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : undefined,
79
+ owner: raw.owner ? String(raw.owner) : undefined,
80
+ };
81
+ }
82
+ export function parseBlockCompanionDefinition(raw) {
83
+ return {
84
+ name: String(raw.name ?? raw.block ?? ''),
85
+ block: String(raw.block ?? raw.name ?? ''),
86
+ domain: raw.domain != null ? String(raw.domain) : undefined,
87
+ description: String(raw.description ?? ''),
88
+ owner: raw.owner ? String(raw.owner) : undefined,
89
+ tags: Array.isArray(raw.tags) ? raw.tags.map(String) : undefined,
90
+ glossary: Array.isArray(raw.glossary) ? raw.glossary.map(String) : undefined,
91
+ semanticMappings: raw.semanticMappings && typeof raw.semanticMappings === 'object' && !Array.isArray(raw.semanticMappings)
92
+ ? Object.fromEntries(Object.entries(raw.semanticMappings).map(([key, value]) => [key, String(value)]))
93
+ : undefined,
94
+ lineage: Array.isArray(raw.lineage) ? raw.lineage.map(String) : undefined,
95
+ notes: Array.isArray(raw.notes) ? raw.notes.map(String) : undefined,
96
+ reviewStatus: validateReviewStatus(raw.reviewStatus),
97
+ };
98
+ }
99
+ /**
100
+ * SemanticLayer holds all metric and dimension definitions and provides
101
+ * lookup and search capabilities for the AI agent pipeline.
102
+ */
103
+ export class SemanticLayer {
104
+ metrics = new Map();
105
+ dimensions = new Map();
106
+ hierarchies = new Map();
107
+ constructor(config) {
108
+ if (config) {
109
+ for (const m of config.metrics)
110
+ this.addMetric(m);
111
+ for (const d of config.dimensions)
112
+ this.addDimension(d);
113
+ for (const h of config.hierarchies ?? [])
114
+ this.addHierarchy(h);
115
+ }
116
+ }
117
+ addMetric(metric) {
118
+ this.metrics.set(metric.name, metric);
119
+ }
120
+ addDimension(dimension) {
121
+ this.dimensions.set(dimension.name, dimension);
122
+ }
123
+ addHierarchy(hierarchy) {
124
+ const levels = [...(hierarchy.levels ?? [])].sort((a, b) => a.order - b.order);
125
+ const levelNames = new Set(levels.map((level) => level.name));
126
+ const normalizedDrillPaths = (hierarchy.drillPaths ?? [])
127
+ .map((path) => ({
128
+ name: path.name,
129
+ levels: path.levels.filter((levelName) => levelNames.has(levelName)),
130
+ }))
131
+ .filter((path) => path.levels.length > 0);
132
+ const defaultPath = hierarchy.defaultDrillPath
133
+ && normalizedDrillPaths.some((path) => path.name === hierarchy.defaultDrillPath)
134
+ ? hierarchy.defaultDrillPath
135
+ : normalizedDrillPaths[0]?.name;
136
+ this.hierarchies.set(hierarchy.name, {
137
+ ...hierarchy,
138
+ levels,
139
+ drillPaths: normalizedDrillPaths.length > 0 ? normalizedDrillPaths : undefined,
140
+ defaultDrillPath: defaultPath,
141
+ defaultRollup: hierarchy.defaultRollup ?? 'sum',
142
+ });
143
+ }
144
+ getMetric(name) {
145
+ return this.metrics.get(name);
146
+ }
147
+ getDimension(name) {
148
+ return this.dimensions.get(name);
149
+ }
150
+ getHierarchy(name) {
151
+ return this.hierarchies.get(name);
152
+ }
153
+ listMetrics(domain) {
154
+ const all = Array.from(this.metrics.values());
155
+ return domain ? all.filter((m) => m.domain === domain) : all;
156
+ }
157
+ listDimensions() {
158
+ return Array.from(this.dimensions.values());
159
+ }
160
+ listHierarchies(domain) {
161
+ const all = Array.from(this.hierarchies.values());
162
+ return domain ? all.filter((h) => h.domain === domain) : all;
163
+ }
164
+ resolveDrillPath(hierarchyName, drillPathName) {
165
+ const hierarchy = this.hierarchies.get(hierarchyName);
166
+ if (!hierarchy)
167
+ return [];
168
+ const fallback = hierarchy.levels;
169
+ if (!hierarchy.drillPaths || hierarchy.drillPaths.length === 0)
170
+ return fallback;
171
+ const selectedPathName = drillPathName ?? hierarchy.defaultDrillPath ?? hierarchy.drillPaths[0].name;
172
+ const selectedPath = hierarchy.drillPaths.find((path) => path.name === selectedPathName);
173
+ if (!selectedPath)
174
+ return fallback;
175
+ const levelMap = new Map(hierarchy.levels.map((level) => [level.name, level]));
176
+ return selectedPath.levels
177
+ .map((levelName) => levelMap.get(levelName))
178
+ .filter((level) => Boolean(level));
179
+ }
180
+ nextDrillLevel(hierarchyName, currentLevelName, drillPathName) {
181
+ const path = this.resolveDrillPath(hierarchyName, drillPathName);
182
+ if (path.length === 0)
183
+ return null;
184
+ if (!currentLevelName)
185
+ return path[0];
186
+ const currentIndex = path.findIndex((level) => level.name === currentLevelName);
187
+ if (currentIndex < 0)
188
+ return path[0];
189
+ return path[currentIndex + 1] ?? null;
190
+ }
191
+ /**
192
+ * Search metrics and dimensions by text query.
193
+ */
194
+ search(query) {
195
+ const q = query.toLowerCase();
196
+ return {
197
+ metrics: Array.from(this.metrics.values()).filter((m) => m.name.toLowerCase().includes(q) ||
198
+ m.label.toLowerCase().includes(q) ||
199
+ m.description.toLowerCase().includes(q) ||
200
+ (m.tags ?? []).some((t) => t.toLowerCase().includes(q))),
201
+ dimensions: Array.from(this.dimensions.values()).filter((d) => d.name.toLowerCase().includes(q) ||
202
+ d.label.toLowerCase().includes(q) ||
203
+ d.description.toLowerCase().includes(q)),
204
+ };
205
+ }
206
+ /**
207
+ * Validate that all metric references in a SQL query resolve to known metrics/dimensions.
208
+ */
209
+ validateReferences(references) {
210
+ const valid = [];
211
+ const unknown = [];
212
+ for (const ref of references) {
213
+ const knownLevel = Array.from(this.hierarchies.values()).some((h) => h.levels.some((level) => level.name === ref));
214
+ if (this.metrics.has(ref) || this.dimensions.has(ref) || this.hierarchies.has(ref) || knownLevel) {
215
+ valid.push(ref);
216
+ }
217
+ else {
218
+ unknown.push(ref);
219
+ }
220
+ }
221
+ return { valid, unknown };
222
+ }
223
+ /**
224
+ * Generate SQL for a metric with optional dimension grouping.
225
+ */
226
+ generateMetricSQL(metricName, groupBy) {
227
+ const metric = this.metrics.get(metricName);
228
+ if (!metric)
229
+ return null;
230
+ const dims = (groupBy ?? [])
231
+ .map((d) => this.dimensions.get(d))
232
+ .filter(Boolean);
233
+ const selectParts = [
234
+ ...dims.map((d) => `${d.sql} AS ${d.name}`),
235
+ `${metric.sql} AS ${metric.name}`,
236
+ ];
237
+ const groupByParts = dims.map((d) => d.sql);
238
+ let sql = `SELECT\n ${selectParts.join(',\n ')}\nFROM ${metric.table}`;
239
+ if (groupByParts.length > 0) {
240
+ sql += `\nGROUP BY ${groupByParts.join(', ')}`;
241
+ }
242
+ return sql;
243
+ }
244
+ }
245
+ function validateMetricType(t) {
246
+ const valid = ['sum', 'count', 'count_distinct', 'avg', 'min', 'max', 'custom'];
247
+ return valid.includes(t) ? t : 'sum';
248
+ }
249
+ function validateDimensionType(t) {
250
+ const valid = ['string', 'number', 'date', 'boolean'];
251
+ return valid.includes(t) ? t : 'string';
252
+ }
253
+ function validateRollupType(t) {
254
+ const valid = ['sum', 'count', 'count_distinct', 'avg', 'min', 'max', 'none'];
255
+ return valid.includes(t) ? t : 'sum';
256
+ }
257
+ function validateReviewStatus(value) {
258
+ const normalized = String(value ?? '').toLowerCase();
259
+ if (normalized === 'draft' || normalized === 'review' || normalized === 'approved') {
260
+ return normalized;
261
+ }
262
+ return undefined;
263
+ }
264
+ //# sourceMappingURL=semantic-layer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"semantic-layer.js","sourceRoot":"","sources":["../../src/semantic/semantic-layer.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,49 @@
1
+ {
2
+ "name": "@duckcodeailabs/dql-core",
3
+ "version": "0.1.0",
4
+ "description": "DQL language core: lexer, parser, AST, semantic analysis",
5
+ "license": "Apache-2.0",
6
+ "type": "module",
7
+ "main": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js"
13
+ }
14
+ },
15
+ "files": [
16
+ "dist"
17
+ ],
18
+ "keywords": [
19
+ "dql",
20
+ "dashboard",
21
+ "query",
22
+ "language",
23
+ "lexer",
24
+ "parser",
25
+ "ast"
26
+ ],
27
+ "repository": {
28
+ "type": "git",
29
+ "url": "https://github.com/duckcode-ai/dql.git",
30
+ "directory": "packages/dql-core"
31
+ },
32
+ "publishConfig": {
33
+ "access": "public"
34
+ },
35
+ "devDependencies": {
36
+ "vitest": "^3.0.0",
37
+ "typescript": "^5.7.0",
38
+ "@types/node": "^22.0.0"
39
+ },
40
+ "engines": {
41
+ "node": ">=18.0.0"
42
+ },
43
+ "scripts": {
44
+ "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
45
+ "test": "vitest run",
46
+ "test:watch": "vitest",
47
+ "clean": "rm -rf dist tsconfig.tsbuildinfo"
48
+ }
49
+ }