@duckcodeailabs/dql-core 0.1.4 → 0.3.0

package/dist/semantic/sql-dialect.js

@@ -0,0 +1,350 @@
+/**
+ * SQL Dialect abstraction for cross-database semantic query generation.
+ *
+ * Each database has different syntax for date truncation, identifier quoting,
+ * type casting, etc. This module provides a uniform interface so that
+ * SemanticLayer.composeQuery() generates portable SQL.
+ */
+// ── PostgreSQL / Redshift ────────────────────────────────────────────────────
+class PostgreSQLDialect {
+    name = 'postgresql';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        return `DATE_TRUNC('${granularity}', ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP';
+    }
+    castToDate(expr) {
+        return `(${expr})::DATE`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `${a} || ${b}`;
+    }
+    ilike(column, pattern) {
+        return `${column} ILIKE ${pattern}`;
+    }
+}
+// ── DuckDB / File ────────────────────────────────────────────────────────────
+class DuckDBDialect {
+    name = 'duckdb';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        return `DATE_TRUNC('${granularity}', ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP';
+    }
+    castToDate(expr) {
+        return `CAST(${expr} AS DATE)`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `${a} || ${b}`;
+    }
+    ilike(column, pattern) {
+        return `${column} ILIKE ${pattern}`;
+    }
+}
+// ── Snowflake ────────────────────────────────────────────────────────────────
+class SnowflakeDialect {
+    name = 'snowflake';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        return `DATE_TRUNC('${granularity}', ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP()';
+    }
+    castToDate(expr) {
+        return `TO_DATE(${expr})`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `${a} || ${b}`;
+    }
+    ilike(column, pattern) {
+        return `${column} ILIKE ${pattern}`;
+    }
+}
+// ── BigQuery ─────────────────────────────────────────────────────────────────
+class BigQueryDialect {
+    name = 'bigquery';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        // BigQuery: DATE_TRUNC(column, MONTH) — note reversed arg order, granularity is keyword not string
+        const grain = granularity.toUpperCase();
+        return `DATE_TRUNC(${columnSql}, ${grain})`;
+    }
+    quoteIdentifier(name) {
+        return `\`${name.replace(/`/g, '\\`')}\``;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP()';
+    }
+    castToDate(expr) {
+        return `DATE(${expr})`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `CONCAT(${a}, ${b})`;
+    }
+    ilike(column, pattern) {
+        return `LOWER(${column}) LIKE LOWER(${pattern})`;
+    }
+}
+// ── MySQL ────────────────────────────────────────────────────────────────────
+class MySQLDialect {
+    name = 'mysql';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        // MySQL doesn't have DATE_TRUNC — use DATE_FORMAT or equivalent
+        switch (granularity) {
+            case 'day':
+                return `DATE(${columnSql})`;
+            case 'week':
+                return `DATE(DATE_SUB(${columnSql}, INTERVAL WEEKDAY(${columnSql}) DAY))`;
+            case 'month':
+                return `DATE_FORMAT(${columnSql}, '%Y-%m-01')`;
+            case 'quarter':
+                return `MAKEDATE(YEAR(${columnSql}), 1) + INTERVAL (QUARTER(${columnSql}) - 1) QUARTER`;
+            case 'year':
+                return `DATE_FORMAT(${columnSql}, '%Y-01-01')`;
+            default:
+                return `DATE(${columnSql})`;
+        }
+    }
+    quoteIdentifier(name) {
+        return `\`${name.replace(/`/g, '``')}\``;
+    }
+    currentTimestamp() {
+        return 'NOW()';
+    }
+    castToDate(expr) {
+        return `DATE(${expr})`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `CONCAT(${a}, ${b})`;
+    }
+    ilike(column, pattern) {
+        // MySQL LIKE is case-insensitive by default with utf8 collation
+        return `${column} LIKE ${pattern}`;
+    }
+}
+// ── SQLite ───────────────────────────────────────────────────────────────────
+class SQLiteDialect {
+    name = 'sqlite';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        switch (granularity) {
+            case 'day':
+                return `DATE(${columnSql})`;
+            case 'week':
+                return `DATE(${columnSql}, 'weekday 0', '-6 days')`;
+            case 'month':
+                return `STRFTIME('%Y-%m-01', ${columnSql})`;
+            case 'quarter':
+                return `STRFTIME('%Y-', ${columnSql}) || CASE ((CAST(STRFTIME('%m', ${columnSql}) AS INTEGER) - 1) / 3) WHEN 0 THEN '01-01' WHEN 1 THEN '04-01' WHEN 2 THEN '07-01' ELSE '10-01' END`;
+            case 'year':
+                return `STRFTIME('%Y-01-01', ${columnSql})`;
+            default:
+                return `DATE(${columnSql})`;
+        }
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return "DATETIME('now')";
+    }
+    castToDate(expr) {
+        return `DATE(${expr})`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `${a} || ${b}`;
+    }
+    ilike(column, pattern) {
+        return `${column} LIKE ${pattern}`;
+    }
+}
+// ── MSSQL / Fabric ───────────────────────────────────────────────────────────
+class MSSQLDialect {
+    name = 'mssql';
+    limitAtEnd = false;
+    dateTrunc(granularity, columnSql) {
+        // SQL Server 2022+ supports DATETRUNC, older versions need DATEADD/DATEDIFF
+        // Using DATETRUNC for modern compat (Azure SQL, Fabric always support it)
+        const grain = granularity.toLowerCase();
+        return `DATETRUNC(${grain}, ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `[${name.replace(/\]/g, ']]')}]`;
+    }
+    currentTimestamp() {
+        return 'GETDATE()';
+    }
+    castToDate(expr) {
+        return `CAST(${expr} AS DATE)`;
+    }
+    limitClause(n) {
+        // MSSQL uses TOP N in SELECT, but for composed queries OFFSET/FETCH is cleaner
+        return `OFFSET 0 ROWS FETCH NEXT ${n} ROWS ONLY`;
+    }
+    concat(a, b) {
+        return `CONCAT(${a}, ${b})`;
+    }
+    ilike(column, pattern) {
+        // MSSQL LIKE is case-insensitive by default
+        return `${column} LIKE ${pattern}`;
+    }
+}
+// ── ClickHouse ───────────────────────────────────────────────────────────────
+class ClickHouseDialect {
+    name = 'clickhouse';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        switch (granularity) {
+            case 'day':
+                return `toDate(${columnSql})`;
+            case 'week':
+                return `toMonday(${columnSql})`;
+            case 'month':
+                return `toStartOfMonth(${columnSql})`;
+            case 'quarter':
+                return `toStartOfQuarter(${columnSql})`;
+            case 'year':
+                return `toStartOfYear(${columnSql})`;
+            default:
+                return `toDate(${columnSql})`;
+        }
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return 'now()';
+    }
+    castToDate(expr) {
+        return `toDate(${expr})`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `concat(${a}, ${b})`;
+    }
+    ilike(column, pattern) {
+        return `${column} ILIKE ${pattern}`;
+    }
+}
+// ── Databricks ───────────────────────────────────────────────────────────────
+class DatabricksDialect {
+    name = 'databricks';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        return `DATE_TRUNC('${granularity}', ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `\`${name.replace(/`/g, '``')}\``;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP()';
+    }
+    castToDate(expr) {
+        return `CAST(${expr} AS DATE)`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `CONCAT(${a}, ${b})`;
+    }
+    ilike(column, pattern) {
+        return `${column} ILIKE ${pattern}`;
+    }
+}
+// ── Trino / Athena (Presto family) ───────────────────────────────────────────
+class TrinoDialect {
+    name = 'trino';
+    limitAtEnd = true;
+    dateTrunc(granularity, columnSql) {
+        return `DATE_TRUNC('${granularity}', ${columnSql})`;
+    }
+    quoteIdentifier(name) {
+        return `"${name.replace(/"/g, '""')}"`;
+    }
+    currentTimestamp() {
+        return 'CURRENT_TIMESTAMP';
+    }
+    castToDate(expr) {
+        return `CAST(${expr} AS DATE)`;
+    }
+    limitClause(n) {
+        return `LIMIT ${n}`;
+    }
+    concat(a, b) {
+        return `${a} || ${b}`;
+    }
+    ilike(column, pattern) {
+        return `LOWER(${column}) LIKE LOWER(${pattern})`;
+    }
+}
+// ── Dialect Registry ─────────────────────────────────────────────────────────
+const DIALECT_MAP = {
+    postgresql: new PostgreSQLDialect(),
+    redshift: new PostgreSQLDialect(),
+    duckdb: new DuckDBDialect(),
+    file: new DuckDBDialect(),
+    snowflake: new SnowflakeDialect(),
+    bigquery: new BigQueryDialect(),
+    mysql: new MySQLDialect(),
+    sqlite: new SQLiteDialect(),
+    mssql: new MSSQLDialect(),
+    fabric: new MSSQLDialect(),
+    clickhouse: new ClickHouseDialect(),
+    databricks: new DatabricksDialect(),
+    trino: new TrinoDialect(),
+    athena: new TrinoDialect(),
+};
+/** Default dialect (DuckDB) used when no driver is specified. */
+const DEFAULT_DIALECT = DIALECT_MAP['duckdb'];
+/**
+ * Get the SQL dialect for a given driver name.
+ * Falls back to DuckDB dialect if the driver is unknown.
+ */
+export function getDialect(driver) {
+    if (!driver)
+        return DEFAULT_DIALECT;
+    return DIALECT_MAP[driver] ?? DEFAULT_DIALECT;
+}
+/**
+ * List all supported dialect driver names.
+ */
+export function listDialectDrivers() {
+    return Object.keys(DIALECT_MAP);
+}
+//# sourceMappingURL=sql-dialect.js.map

package/dist/semantic/sql-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-dialect.js","sourceRoot":"","sources":["../../src/semantic/sql-dialect.ts"],"names":[],"mappings":"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"}

package/dist/semantic/yaml-loader.d.ts

@@ -0,0 +1,26 @@
+/**
+ * YAML-based semantic layer loader.
+ * Reads metric, dimension, hierarchy, cube, and block-companion YAML files
+ * from a project's semantic-layer/ directory and returns a populated SemanticLayer.
+ */
+import { SemanticLayer } from './semantic-layer.js';
+/**
+ * Load a SemanticLayer from a directory on disk.
+ * Expected structure:
+ *   semanticLayerDir/
+ *     metrics/       → *.yaml metric definitions
+ *     dimensions/    → *.yaml dimension definitions
+ *     hierarchies/   → *.yaml hierarchy definitions
+ *     cubes/         → *.yaml cube definitions
+ *     blocks/        → *.yaml block companion definitions (metadata only, not loaded into layer)
+ */
+export declare function loadSemanticLayerFromDir(semanticLayerDir: string): SemanticLayer;
+/**
+ * Load a SemanticLayer from pre-read file contents (no filesystem access needed).
+ * Useful for browser contexts or when files are already loaded.
+ */
+export declare function loadSemanticLayerFromConfig(files: Array<{
+    path: string;
+    content: string;
+}>): SemanticLayer;
+//# sourceMappingURL=yaml-loader.d.ts.map

package/dist/semantic/yaml-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.d.ts","sourceRoot":"","sources":["../../src/semantic/yaml-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,aAAa,EAKd,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,aAAa,CA4BhF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAC9C,aAAa,CAwBf"}

package/dist/semantic/yaml-loader.js

@@ -0,0 +1,80 @@
+/**
+ * YAML-based semantic layer loader.
+ * Reads metric, dimension, hierarchy, cube, and block-companion YAML files
+ * from a project's semantic-layer/ directory and returns a populated SemanticLayer.
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, extname } from 'node:path';
+import * as yaml from 'js-yaml';
+import { SemanticLayer, parseMetricDefinition, parseDimensionDefinition, parseHierarchyDefinition, parseCubeDefinition, } from './semantic-layer.js';
+/**
+ * Load a SemanticLayer from a directory on disk.
+ * Expected structure:
+ *   semanticLayerDir/
+ *     metrics/       → *.yaml metric definitions
+ *     dimensions/    → *.yaml dimension definitions
+ *     hierarchies/   → *.yaml hierarchy definitions
+ *     cubes/         → *.yaml cube definitions
+ *     blocks/        → *.yaml block companion definitions (metadata only, not loaded into layer)
+ */
+export function loadSemanticLayerFromDir(semanticLayerDir) {
+    const layer = new SemanticLayer();
+    const subdirs = [
+        { folder: 'metrics', loader: (raw) => layer.addMetric(parseMetricDefinition(raw)) },
+        { folder: 'dimensions', loader: (raw) => layer.addDimension(parseDimensionDefinition(raw)) },
+        { folder: 'hierarchies', loader: (raw) => layer.addHierarchy(parseHierarchyDefinition(raw)) },
+        { folder: 'cubes', loader: (raw) => layer.addCube(parseCubeDefinition(raw)) },
+    ];
+    for (const { folder, loader } of subdirs) {
+        const dir = join(semanticLayerDir, folder);
+        if (!existsSync(dir))
+            continue;
+        for (const file of readdirSync(dir)) {
+            if (extname(file) !== '.yaml' && extname(file) !== '.yml')
+                continue;
+            try {
+                const content = readFileSync(join(dir, file), 'utf-8');
+                const raw = yaml.load(content);
+                if (raw && typeof raw === 'object') {
+                    loader(raw);
+                }
+            }
+            catch {
+                // Skip malformed YAML files
+            }
+        }
+    }
+    return layer;
+}
+/**
+ * Load a SemanticLayer from pre-read file contents (no filesystem access needed).
+ * Useful for browser contexts or when files are already loaded.
+ */
+export function loadSemanticLayerFromConfig(files) {
+    const layer = new SemanticLayer();
+    for (const file of files) {
+        try {
+            const raw = yaml.load(file.content);
+            if (!raw || typeof raw !== 'object')
+                continue;
+            const pathLower = file.path.toLowerCase();
+            if (pathLower.includes('/metrics/') || pathLower.includes('\\metrics\\')) {
+                layer.addMetric(parseMetricDefinition(raw));
+            }
+            else if (pathLower.includes('/dimensions/') || pathLower.includes('\\dimensions\\')) {
+                layer.addDimension(parseDimensionDefinition(raw));
+            }
+            else if (pathLower.includes('/hierarchies/') || pathLower.includes('\\hierarchies\\')) {
+                layer.addHierarchy(parseHierarchyDefinition(raw));
+            }
+            else if (pathLower.includes('/cubes/') || pathLower.includes('\\cubes\\')) {
+                layer.addCube(parseCubeDefinition(raw));
+            }
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    return layer;
+}
+//# sourceMappingURL=yaml-loader.js.map

package/dist/semantic/yaml-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-loader.js","sourceRoot":"","sources":["../../src/semantic/yaml-loader.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-core",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "DQL language core: lexer, parser, AST, semantic analysis",
   "license": "Apache-2.0",
   "type": "module",
@@ -12,13 +12,6 @@
       "import": "./dist/index.js"
     }
   },
-  "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist tsconfig.tsbuildinfo",
-    "prepublishOnly": "pnpm run build"
-  },
   "files": [
     "dist"
   ],
@@ -40,11 +33,21 @@
     "access": "public"
   },
   "devDependencies": {
-    "vitest": "^3.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
-    "@types/node": "^22.0.0"
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
   }
-}
+}