@outsidedata/dolex 0.1.0

package/dist/src/connectors/dsl-compiler.js

@@ -0,0 +1,313 @@
+/**
+ * DSL-to-SQL Compiler
+ *
+ * Translates the declarative query DSL into SQL.
+ * Targets SQLite dialect (works for CSV-in-SQLite and SQLite sources).
+ * Postgres differences are minimal and handled via dialect parameter.
+ *
+ * Supports JOIN clauses with dot-notation field references (table.field).
+ */
+import { isDslAggregateField, isDslWindowField } from '../types.js';
+const MAX_LIMIT = 10000;
+/**
+ * Quote a field reference. Handles both plain "field" and "table.field" dot notation.
+ */
+function quoteField(field) {
+    if (field.includes('.')) {
+        const [table, col] = field.split('.', 2);
+        return `"${table}"."${col}"`;
+    }
+    return `"${field}"`;
+}
+/** Check if a DSL query contains aggregate functions that need JS post-processing on SQLite/MySQL. */
+export function hasJsAggregates(query) {
+    return query.select.some(f => isDslAggregateField(f) && (f.aggregate === 'median' || f.aggregate === 'p25' || f.aggregate === 'p75' || f.aggregate === 'stddev' || f.aggregate === 'percentile'));
+}
+/** Check if a DSL query contains window function fields. */
+export function hasWindowFunctions(query) {
+    return query.select.some(f => isDslWindowField(f));
+}
+/** @deprecated Use hasJsAggregates instead */
+export const hasPercentileAggregates = hasJsAggregates;
+/** Compile a DSL query into a SQL string. */
+export function compileDsl(table, query, dialect = 'sqlite', options) {
+    if (hasWindowFunctions(query)) {
+        return compileDslWithWindows(table, query, dialect, options);
+    }
+    return compileDslBase(table, query, dialect, options);
+}
+function compileDslBase(table, query, dialect, options) {
+    const parts = [];
+    // SELECT — window fields are handled separately in compileDslWithWindows
+    const baseFields = query.select.filter((f) => !isDslWindowField(f));
+    const selectClauses = baseFields.map(f => compileSelectField(f, dialect));
+    // If there are time-bucketed groupBy fields, add them to SELECT if not already present
+    const groupByBucketSelects = [];
+    if (query.groupBy) {
+        for (const g of query.groupBy) {
+            if (typeof g !== 'string' && g.bucket) {
+                const alias = `${g.field.replace('.', '_')}_${g.bucket}`;
+                const bucketExpr = compileBucket(g.field, g.bucket, dialect);
+                const alreadySelected = query.select.some(s => isDslAggregateField(s) && s.field === g.field);
+                if (!alreadySelected) {
+                    groupByBucketSelects.push(`${bucketExpr} AS "${alias}"`);
+                }
+            }
+        }
+    }
+    parts.push(`SELECT ${[...groupByBucketSelects, ...selectClauses].join(', ')}`);
+    // FROM
+    parts.push(`FROM "${table}"`);
+    // JOIN
+    if (query.join && query.join.length > 0) {
+        for (const join of query.join) {
+            const joinType = (join.type ?? 'left').toUpperCase();
+            const leftField = join.on.left.includes('.')
+                ? quoteField(join.on.left)
+                : `"${table}"."${join.on.left}"`;
+            const rightField = `"${join.table}"."${join.on.right}"`;
+            parts.push(`${joinType} JOIN "${join.table}" ON ${leftField} = ${rightField}`);
+        }
+    }
+    // WHERE
+    if (query.filter && query.filter.length > 0) {
+        const conditions = query.filter.map(f => compileFilter(f));
+        parts.push(`WHERE ${conditions.join(' AND ')}`);
+    }
+    // GROUP BY
+    if (query.groupBy && query.groupBy.length > 0) {
+        const groupClauses = query.groupBy.map(g => compileGroupBy(g, dialect));
+        parts.push(`GROUP BY ${groupClauses.join(', ')}`);
+    }
+    // HAVING
+    if (query.having && query.having.length > 0) {
+        const havingConditions = query.having.map(f => compileHavingFilter(f, query));
+        parts.push(`HAVING ${havingConditions.join(' AND ')}`);
+    }
+    // ORDER BY
+    if (query.orderBy && query.orderBy.length > 0) {
+        const orderClauses = query.orderBy.map(o => `${quoteField(o.field)} ${o.direction.toUpperCase()}`);
+        parts.push(`ORDER BY ${orderClauses.join(', ')}`);
+    }
+    // LIMIT
+    if (!options?.skipLimit) {
+        const limit = Math.min(query.limit ?? MAX_LIMIT, MAX_LIMIT);
+        parts.push(`LIMIT ${limit}`);
+    }
+    return parts.join('\n');
+}
+function compileDslWithWindows(table, query, dialect, options) {
+    const windowFields = query.select.filter(isDslWindowField);
+    const baseFields = query.select.filter(f => !isDslWindowField(f));
+    const baseQuery = {
+        join: query.join,
+        select: baseFields,
+        groupBy: query.groupBy,
+        filter: query.filter,
+        having: query.having,
+    };
+    const cteSql = compileDslBase(table, baseQuery, dialect, { skipLimit: true });
+    const outerParts = [];
+    const windowExprs = windowFields.map(w => compileWindowExpression(w, dialect));
+    outerParts.push(`WITH _base AS (\n${cteSql}\n)`);
+    outerParts.push(`SELECT _base.*, ${windowExprs.join(', ')}`);
+    outerParts.push('FROM _base');
+    if (query.orderBy && query.orderBy.length > 0) {
+        const orderClauses = query.orderBy.map(o => `"${o.field}" ${o.direction.toUpperCase()}`);
+        outerParts.push(`ORDER BY ${orderClauses.join(', ')}`);
+    }
+    if (!options?.skipLimit) {
+        const limit = Math.min(query.limit ?? MAX_LIMIT, MAX_LIMIT);
+        outerParts.push(`LIMIT ${limit}`);
+    }
+    return outerParts.join('\n');
+}
+function compileWindowExpression(w, dialect) {
+    const partitionClause = w.partitionBy && w.partitionBy.length > 0
+        ? `PARTITION BY ${w.partitionBy.map(f => `"${f}"`).join(', ')}`
+        : '';
+    const orderClause = w.orderBy && w.orderBy.length > 0
+        ? `ORDER BY ${w.orderBy.map(o => `"${o.field}" ${o.direction.toUpperCase()}`).join(', ')}`
+        : '';
+    const overParts = [partitionClause, orderClause].filter(Boolean).join(' ');
+    const field = w.field ? `"${w.field}"` : '';
+    const offset = w.offset ?? 1;
+    const defaultVal = w.default !== undefined ? `, ${escapeValue(w.default)}` : '';
+    let expr;
+    switch (w.window) {
+        case 'lag':
+            expr = `LAG(${field}, ${offset}${defaultVal}) OVER (${overParts})`;
+            break;
+        case 'lead':
+            expr = `LEAD(${field}, ${offset}${defaultVal}) OVER (${overParts})`;
+            break;
+        case 'rank':
+            expr = `RANK() OVER (${overParts})`;
+            break;
+        case 'dense_rank':
+            expr = `DENSE_RANK() OVER (${overParts})`;
+            break;
+        case 'row_number':
+            expr = `ROW_NUMBER() OVER (${overParts})`;
+            break;
+        case 'running_sum':
+            expr = `SUM(${field}) OVER (${overParts} ROWS UNBOUNDED PRECEDING)`;
+            break;
+        case 'running_avg':
+            expr = `AVG(${field}) OVER (${overParts} ROWS UNBOUNDED PRECEDING)`;
+            break;
+        case 'pct_of_total': {
+            const pctOver = partitionClause || '';
+            expr = `CAST(${field} AS REAL) / SUM(${field}) OVER (${pctOver})`;
+            break;
+        }
+        default:
+            expr = 'NULL';
+    }
+    return `${expr} AS "${w.as}"`;
+}
+function compileSelectField(field, dialect) {
+    if (typeof field === 'string') {
+        return quoteField(field);
+    }
+    const aggFn = compileAggregate(field.aggregate, field.field, dialect, field.percentile);
+    return `${aggFn} AS "${field.as}"`;
+}
+function compileAggregate(aggregate, field, dialect, percentileValue) {
+    const quoted = quoteField(field);
+    const numField = `CAST(${quoted} AS REAL)`;
+    switch (aggregate) {
+        case 'sum': return `SUM(${numField})`;
+        case 'avg': return `AVG(${numField})`;
+        case 'min': return `MIN(${numField})`;
+        case 'max': return `MAX(${numField})`;
+        case 'count': return `COUNT(${quoted})`;
+        case 'count_distinct': return `COUNT(DISTINCT ${quoted})`;
+        case 'stddev':
+            if (dialect === 'postgres')
+                return `STDDEV_POP(${numField})`;
+            if (dialect === 'mysql')
+                return `STDDEV_POP(${numField})`;
+            return `NULL`;
+        case 'median':
+            if (dialect === 'postgres') {
+                return `PERCENTILE_CONT(0.5) WITHIN GROUP (ORDER BY ${numField})`;
+            }
+            return `NULL`;
+        case 'p25':
+            if (dialect === 'postgres') {
+                return `PERCENTILE_CONT(0.25) WITHIN GROUP (ORDER BY ${numField})`;
+            }
+            return `NULL`;
+        case 'p75':
+            if (dialect === 'postgres') {
+                return `PERCENTILE_CONT(0.75) WITHIN GROUP (ORDER BY ${numField})`;
+            }
+            return `NULL`;
+        case 'percentile': {
+            const p = percentileValue ?? 0.5;
+            if (dialect === 'postgres') {
+                return `PERCENTILE_CONT(${p}) WITHIN GROUP (ORDER BY ${numField})`;
+            }
+            return `NULL`;
+        }
+        default: return quoted;
+    }
+}
+function compileFilter(filter) {
+    const rawField = quoteField(filter.field);
+    // CAST to REAL for numeric comparisons (handles TEXT columns from CSV)
+    const isNumericComparison = typeof filter.value === 'number' ||
+        (Array.isArray(filter.value) && filter.value.length > 0 && typeof filter.value[0] === 'number');
+    const field = isNumericComparison ? `CAST(${rawField} AS REAL)` : rawField;
+    switch (filter.op) {
+        case '=':
+        case '!=':
+        case '>':
+        case '>=':
+        case '<':
+        case '<=':
+            return `${field} ${filter.op} ${escapeValue(filter.value)}`;
+        case 'in':
+            return `${field} IN (${filter.value.map(escapeValue).join(', ')})`;
+        case 'not_in':
+            return `${field} NOT IN (${filter.value.map(escapeValue).join(', ')})`;
+        case 'between':
+            return `${field} BETWEEN ${escapeValue(filter.value[0])} AND ${escapeValue(filter.value[1])}`;
+        case 'is_null':
+            return `${rawField} IS NULL`;
+        case 'is_not_null':
+            return `${rawField} IS NOT NULL`;
+        default:
+            return `${field} = ${escapeValue(filter.value)}`;
+    }
+}
+function compileHavingFilter(filter, query) {
+    const field = quoteField(filter.field);
+    const isNumericComparison = typeof filter.value === 'number' ||
+        (Array.isArray(filter.value) && filter.value.length > 0 && typeof filter.value[0] === 'number');
+    const ref = isNumericComparison ? `CAST(${field} AS REAL)` : field;
+    switch (filter.op) {
+        case '=':
+        case '!=':
+        case '>':
+        case '>=':
+        case '<':
+        case '<=':
+            return `${ref} ${filter.op} ${escapeValue(filter.value)}`;
+        case 'in':
+            return `${ref} IN (${filter.value.map(escapeValue).join(', ')})`;
+        case 'not_in':
+            return `${ref} NOT IN (${filter.value.map(escapeValue).join(', ')})`;
+        case 'between':
+            return `${ref} BETWEEN ${escapeValue(filter.value[0])} AND ${escapeValue(filter.value[1])}`;
+        case 'is_null':
+            return `${field} IS NULL`;
+        case 'is_not_null':
+            return `${field} IS NOT NULL`;
+        default:
+            return `${ref} = ${escapeValue(filter.value)}`;
+    }
+}
+function compileGroupBy(field, dialect) {
+    if (typeof field === 'string') {
+        return quoteField(field);
+    }
+    return compileBucket(field.field, field.bucket, dialect);
+}
+function compileBucket(field, bucket, dialect) {
+    const quoted = quoteField(field);
+    if (dialect === 'postgres') {
+        return `DATE_TRUNC('${bucket}', ${quoted})`;
+    }
+    if (dialect === 'mysql') {
+        switch (bucket) {
+            case 'day': return `DATE_FORMAT(${quoted}, '%Y-%m-%d')`;
+            case 'week': return `DATE_FORMAT(${quoted}, '%x-W%v')`;
+            case 'month': return `DATE_FORMAT(${quoted}, '%Y-%m')`;
+            case 'quarter': return `CONCAT(YEAR(${quoted}), '-Q', QUARTER(${quoted}))`;
+            case 'year': return `YEAR(${quoted})`;
+            default: return quoted;
+        }
+    }
+    // SQLite strftime
+    switch (bucket) {
+        case 'day': return `strftime('%Y-%m-%d', ${quoted})`;
+        case 'week': return `strftime('%Y-W%W', ${quoted})`;
+        case 'month': return `strftime('%Y-%m', ${quoted})`;
+        case 'quarter': return `(strftime('%Y', ${quoted}) || '-Q' || ((CAST(strftime('%m', ${quoted}) AS INTEGER) - 1) / 3 + 1))`;
+        case 'year': return `strftime('%Y', ${quoted})`;
+        default: return quoted;
+    }
+}
+function escapeValue(value) {
+    if (value === null || value === undefined)
+        return 'NULL';
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'boolean')
+        return value ? '1' : '0';
+    // String — escape single quotes
+    return `'${String(value).replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=dsl-compiler.js.map

package/dist/src/connectors/dsl-compiler.js.map

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

package/dist/src/connectors/dsl-validator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * DSL Validator
+ *
+ * Validates a DslQuery against a table schema before compilation.
+ * Returns helpful error messages with fuzzy suggestions for typos.
+ */
+import type { DataTable, DataSchema, DslQuery } from '../types.js';
+export interface ValidationResult {
+    ok: boolean;
+    error?: string;
+}
+/** Validate a DSL query against a table's column schema. */
+export declare function validateDsl(table: DataTable, query: DslQuery): ValidationResult;
+/**
+ * Validate a DSL query with join support.
+ * Takes the full schema so it can look up joined tables.
+ */
+export declare function validateDslWithJoins(schema: DataSchema, baseTableName: string, query: DslQuery): ValidationResult;
+//# sourceMappingURL=dsl-validator.d.ts.map

package/dist/src/connectors/dsl-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-validator.d.ts","sourceRoot":"","sources":["../../../src/connectors/dsl-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAqB,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAGtG,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,gBAAgB,CA4F/E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,QAAQ,GACd,gBAAgB,CAyHlB"}