@relq/orm 0.1.0

package/dist/esm/raw/sql-template.js

@@ -0,0 +1,66 @@
+import format from "../shared/pg-format.js";
+export class SqlFragment {
+    text;
+    _isSqlFragment = true;
+    constructor(text) {
+        this.text = text;
+    }
+    toString() {
+        return this.text;
+    }
+}
+function sqlIdentifier(name) {
+    return new SqlFragment(format.ident(name));
+}
+function sqlRaw(text) {
+    return new SqlFragment(text);
+}
+function sql(strings, ...values) {
+    let result = '';
+    for (let i = 0; i < strings.length; i++) {
+        result += strings[i];
+        if (i < values.length) {
+            const value = values[i];
+            result += formatValue(value);
+        }
+    }
+    return new SqlFragment(result);
+}
+function formatValue(value) {
+    if (value && value._isSqlFragment === true) {
+        return value.text;
+    }
+    if (value === null || value === undefined) {
+        return 'NULL';
+    }
+    if (value instanceof Date) {
+        return format('%L', value.toISOString());
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return 'ARRAY[]';
+        }
+        const escaped = value.map(v => formatValue(v)).join(', ');
+        return `(${escaped})`;
+    }
+    if (typeof value === 'boolean') {
+        return value ? 'true' : 'false';
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    if (typeof value === 'bigint') {
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        return format('%L', value);
+    }
+    if (typeof value === 'object') {
+        return format('%L', JSON.stringify(value)) + '::jsonb';
+    }
+    return format('%L', String(value));
+}
+sql.id = sqlIdentifier;
+sql.raw = sqlRaw;
+sql.fragment = sqlRaw;
+export { sql };

package/dist/esm/select/aggregate-builder.js

@@ -0,0 +1,172 @@
+import format from "../shared/pg-format.js";
+import { ConditionCollector, buildConditionsSQL } from "../condition/condition-collector.js";
+const NUMERIC_FUNCS = new Set(['COUNT', 'SUM', 'AVG', 'MIN', 'MAX']);
+export class AggregateQueryBuilder {
+    tableName;
+    groupByColumns = [];
+    entries = [];
+    whereConditions = [];
+    havingConditions = [];
+    orderByColumns = [];
+    limitValue;
+    offsetValue;
+    constructor(tableName) {
+        this.tableName = tableName;
+    }
+    groupBy(...columns) {
+        this.groupByColumns.push(...columns);
+        return this;
+    }
+    count(alias = 'count') {
+        this.entries.push({ func: 'COUNT', column: '*', alias });
+        return this;
+    }
+    countColumn(column, alias) {
+        this.entries.push({ func: 'COUNT', column, alias: alias || column });
+        return this;
+    }
+    countDistinct(column, alias) {
+        this.entries.push({ func: 'COUNT', column, alias: alias || column, distinct: true });
+        return this;
+    }
+    sum(column, alias, filter) {
+        const entry = { func: 'SUM', column, alias: alias || column };
+        if (filter) {
+            const collector = new ConditionCollector();
+            filter(collector);
+            entry.filterConditions = collector.getConditions();
+        }
+        this.entries.push(entry);
+        return this;
+    }
+    avg(column, alias, filter) {
+        const entry = { func: 'AVG', column, alias: alias || column };
+        if (filter) {
+            const collector = new ConditionCollector();
+            filter(collector);
+            entry.filterConditions = collector.getConditions();
+        }
+        this.entries.push(entry);
+        return this;
+    }
+    min(column, alias) {
+        this.entries.push({ func: 'MIN', column, alias: alias || column });
+        return this;
+    }
+    max(column, alias) {
+        this.entries.push({ func: 'MAX', column, alias: alias || column });
+        return this;
+    }
+    arrayAgg(column, alias) {
+        this.entries.push({ func: 'ARRAY_AGG', column, alias: alias || column });
+        return this;
+    }
+    stringAgg(column, delimiter = ', ', alias) {
+        this.entries.push({ func: 'STRING_AGG', column, alias: alias || column, delimiter });
+        return this;
+    }
+    jsonAgg(column, alias) {
+        this.entries.push({ func: 'JSON_AGG', column, alias: alias || column });
+        return this;
+    }
+    jsonbAgg(column, alias) {
+        this.entries.push({ func: 'JSONB_AGG', column, alias: alias || column });
+        return this;
+    }
+    boolAnd(column, alias) {
+        this.entries.push({ func: 'BOOL_AND', column, alias: alias || column });
+        return this;
+    }
+    boolOr(column, alias) {
+        this.entries.push({ func: 'BOOL_OR', column, alias: alias || column });
+        return this;
+    }
+    where(callback) {
+        const collector = new ConditionCollector();
+        callback(collector);
+        this.whereConditions.push(...collector.getConditions());
+        return this;
+    }
+    having(callback) {
+        const collector = new ConditionCollector();
+        callback(collector);
+        this.havingConditions.push(...collector.getConditions());
+        return this;
+    }
+    orderBy(column, direction = 'ASC') {
+        this.orderByColumns.push({ column, direction });
+        return this;
+    }
+    limit(count) {
+        this.limitValue = count;
+        return this;
+    }
+    offset(count) {
+        this.offsetValue = count;
+        return this;
+    }
+    getNumericAliases() {
+        return this.entries
+            .filter(e => NUMERIC_FUNCS.has(e.func))
+            .map(e => e.alias);
+    }
+    getGroupByColumns() {
+        return this.groupByColumns;
+    }
+    toString() {
+        const selectParts = [];
+        for (const col of this.groupByColumns) {
+            selectParts.push(format.ident(col));
+        }
+        for (const entry of this.entries) {
+            selectParts.push(this.buildEntrySQL(entry));
+        }
+        if (selectParts.length === 0) {
+            selectParts.push('COUNT(*) AS count');
+        }
+        let query = format('SELECT %s FROM %I', selectParts.join(', '), this.tableName);
+        if (this.whereConditions.length > 0) {
+            query += ' WHERE ' + buildConditionsSQL(this.whereConditions);
+        }
+        if (this.groupByColumns.length > 0) {
+            query += ' GROUP BY ' + this.groupByColumns.map(col => format.ident(col)).join(', ');
+        }
+        if (this.havingConditions.length > 0) {
+            query += ' HAVING ' + buildConditionsSQL(this.havingConditions);
+        }
+        if (this.orderByColumns.length > 0) {
+            query += ' ORDER BY ' + this.orderByColumns
+                .map(o => `${format.ident(o.column)} ${o.direction}`)
+                .join(', ');
+        }
+        if (this.limitValue !== undefined) {
+            query += format(' LIMIT %s', this.limitValue);
+        }
+        if (this.offsetValue !== undefined) {
+            query += format(' OFFSET %s', this.offsetValue);
+        }
+        return query;
+    }
+    buildEntrySQL(entry) {
+        let columnExpr;
+        if (entry.column === '*') {
+            columnExpr = '*';
+        }
+        else if (entry.distinct) {
+            columnExpr = `DISTINCT ${format.ident(entry.column)}`;
+        }
+        else if (entry.func === 'STRING_AGG' && entry.delimiter) {
+            columnExpr = `${format.ident(entry.column)}, ${format.literal(entry.delimiter)}`;
+        }
+        else {
+            columnExpr = format.ident(entry.column);
+        }
+        let sql = `${entry.func}(${columnExpr})`;
+        if (entry.filterConditions && entry.filterConditions.length > 0) {
+            const filterSQL = buildConditionsSQL(entry.filterConditions);
+            sql += ` FILTER (WHERE ${filterSQL})`;
+        }
+        sql += ` AS ${format.ident(entry.alias)}`;
+        return sql;
+    }
+}

package/dist/esm/select/index.js

@@ -0,0 +1,4 @@
+export { SelectBuilder } from "./select-builder.js";
+export { createTableProxy, columnRefToSQL, columnRefToSQLUnqualified, isColumnRef } from "./table-proxy.js";
+export { JoinConditionBuilder, createJoinConditionBuilder } from "./join-condition-builder.js";
+export { JoinManyBuilder, createJoinManyBuilder } from "./join-builder.js";

package/dist/esm/select/join-builder.js

@@ -0,0 +1,184 @@
+import { JoinConditionBuilder } from "./join-condition-builder.js";
+import { columnRefToSQL, columnRefToSQLUnqualified } from "./table-proxy.js";
+import { ConditionCollector, buildConditionsSQL } from "../condition/condition-collector.js";
+import format from "../shared/pg-format.js";
+export class JoinManyBuilder extends JoinConditionBuilder {
+    orderBySpecs = [];
+    selectColumns = [];
+    limitValue;
+    offsetValue;
+    groupByColumns = [];
+    havingConditions = [];
+    selectRefs(columns) {
+        this.selectColumns = columns;
+        return this;
+    }
+    orderBy(column, direction = 'ASC') {
+        this.orderBySpecs.push({ column, direction });
+        return this;
+    }
+    orderByNulls(column, direction, nulls) {
+        this.orderBySpecs.push({ column, direction, nulls });
+        return this;
+    }
+    limit(count) {
+        this.limitValue = count;
+        return this;
+    }
+    offset(count) {
+        this.offsetValue = count;
+        return this;
+    }
+    groupBy(...columns) {
+        this.groupByColumns.push(...columns);
+        return this;
+    }
+    having(callback) {
+        const collector = new ConditionCollector();
+        callback(collector);
+        this.havingConditions.push(...collector.getConditions());
+        return this;
+    }
+    hasQueryModifiers() {
+        return (this.orderBySpecs.length > 0 ||
+            this.selectColumns.length > 0 ||
+            this.limitValue !== undefined ||
+            this.offsetValue !== undefined ||
+            this.groupByColumns.length > 0 ||
+            this.havingConditions.length > 0);
+    }
+    getSelectColumns() {
+        return [...this.selectColumns];
+    }
+    getOrderBySpecs() {
+        return [...this.orderBySpecs];
+    }
+    getLimit() {
+        return this.limitValue;
+    }
+    getOffset() {
+        return this.offsetValue;
+    }
+    toLateralSQL(rightTable, rightAlias, leftAlias) {
+        const selectPart = this.buildSelectPart();
+        const fromPart = format.ident(rightTable);
+        const wherePart = this.buildWherePart(leftAlias);
+        const groupByPart = this.buildGroupByPart();
+        const havingPart = this.buildHavingPart();
+        const orderByPart = this.buildOrderByPart();
+        const limitPart = this.buildLimitPart();
+        let innerQuery = `SELECT ${selectPart} FROM ${fromPart}`;
+        if (wherePart) {
+            innerQuery += ` WHERE ${wherePart}`;
+        }
+        if (groupByPart) {
+            innerQuery += ` GROUP BY ${groupByPart}`;
+        }
+        if (havingPart) {
+            innerQuery += ` HAVING ${havingPart}`;
+        }
+        if (orderByPart) {
+            innerQuery += ` ORDER BY ${orderByPart}`;
+        }
+        if (limitPart) {
+            innerQuery += limitPart;
+        }
+        const wrappedQuery = `SELECT COALESCE(json_agg(sub.*), '[]'::json) as ${format.ident(rightAlias)} FROM (${innerQuery}) sub`;
+        return `(${wrappedQuery})`;
+    }
+    toSubquerySQL(rightTable, leftAlias) {
+        const selectPart = this.buildSelectPart();
+        const fromPart = format.ident(rightTable);
+        const wherePart = this.buildWherePart(leftAlias);
+        const groupByPart = this.buildGroupByPart();
+        const havingPart = this.buildHavingPart();
+        const orderByPart = this.buildOrderByPart();
+        const limitPart = this.buildLimitPart();
+        let query = `SELECT ${selectPart} FROM ${fromPart}`;
+        if (wherePart) {
+            query += ` WHERE ${wherePart}`;
+        }
+        if (groupByPart) {
+            query += ` GROUP BY ${groupByPart}`;
+        }
+        if (havingPart) {
+            query += ` HAVING ${havingPart}`;
+        }
+        if (orderByPart) {
+            query += ` ORDER BY ${orderByPart}`;
+        }
+        if (limitPart) {
+            query += limitPart;
+        }
+        return query;
+    }
+    buildSelectPart() {
+        if (this.selectColumns.length === 0) {
+            return '*';
+        }
+        return this.selectColumns
+            .map(col => columnRefToSQLUnqualified(col))
+            .join(', ');
+    }
+    buildWherePart(leftAlias) {
+        const parts = [];
+        for (const cond of this.conditions) {
+            if (cond.type === 'using' || cond.type === 'raw') {
+                if (cond.raw)
+                    parts.push(cond.raw);
+                continue;
+            }
+            const leftSQL = columnRefToSQL(cond.left);
+            const rightSQL = this.formatRightSide(cond.right);
+            parts.push(`${leftSQL} ${cond.operator} ${rightSQL}`);
+        }
+        if (this.whereConditions.length > 0) {
+            const whereSQL = buildConditionsSQL(this.whereConditions);
+            if (whereSQL) {
+                parts.push(whereSQL);
+            }
+        }
+        return parts.length > 0 ? parts.join(' AND ') : null;
+    }
+    buildGroupByPart() {
+        if (this.groupByColumns.length === 0) {
+            return null;
+        }
+        return this.groupByColumns
+            .map(col => columnRefToSQLUnqualified(col))
+            .join(', ');
+    }
+    buildHavingPart() {
+        if (this.havingConditions.length === 0) {
+            return null;
+        }
+        return buildConditionsSQL(this.havingConditions);
+    }
+    buildOrderByPart() {
+        if (this.orderBySpecs.length === 0) {
+            return null;
+        }
+        return this.orderBySpecs
+            .map(spec => {
+            let sql = `${columnRefToSQLUnqualified(spec.column)} ${spec.direction}`;
+            if (spec.nulls) {
+                sql += ` NULLS ${spec.nulls}`;
+            }
+            return sql;
+        })
+            .join(', ');
+    }
+    buildLimitPart() {
+        let sql = '';
+        if (this.limitValue !== undefined) {
+            sql += ` LIMIT ${this.limitValue}`;
+        }
+        if (this.offsetValue !== undefined) {
+            sql += ` OFFSET ${this.offsetValue}`;
+        }
+        return sql;
+    }
+}
+export function createJoinManyBuilder() {
+    return new JoinManyBuilder();
+}

package/dist/esm/select/join-condition-builder.js

@@ -0,0 +1,181 @@
+import { columnRefToSQL, isColumnRef } from "./table-proxy.js";
+import { ConditionCollector, buildConditionsSQL } from "../condition/condition-collector.js";
+import format from "../shared/pg-format.js";
+import { JOIN_INTERNAL } from "./join-internals.js";
+export class JoinConditionBuilder {
+    conditions = [];
+    whereConditions = [];
+    selectedColumns;
+    equal(left, right) {
+        this.conditions.push({
+            type: 'equal',
+            left,
+            right,
+            operator: '='
+        });
+        return this;
+    }
+    notEqual(left, right) {
+        this.conditions.push({
+            type: 'notEqual',
+            left,
+            right,
+            operator: '!='
+        });
+        return this;
+    }
+    greaterThan(left, right) {
+        this.conditions.push({
+            type: 'greaterThan',
+            left,
+            right,
+            operator: '>'
+        });
+        return this;
+    }
+    lessThan(left, right) {
+        this.conditions.push({
+            type: 'lessThan',
+            left,
+            right,
+            operator: '<'
+        });
+        return this;
+    }
+    greaterThanOrEqual(left, right) {
+        this.conditions.push({
+            type: 'greaterThanOrEqual',
+            left,
+            right,
+            operator: '>='
+        });
+        return this;
+    }
+    lessThanOrEqual(left, right) {
+        this.conditions.push({
+            type: 'lessThanOrEqual',
+            left,
+            right,
+            operator: '<='
+        });
+        return this;
+    }
+    like(left, right) {
+        this.conditions.push({
+            type: 'like',
+            left,
+            right,
+            operator: 'LIKE'
+        });
+        return this;
+    }
+    ilike(left, right) {
+        this.conditions.push({
+            type: 'ilike',
+            left,
+            right,
+            operator: 'ILIKE'
+        });
+        return this;
+    }
+    using(...columns) {
+        this.conditions.push({
+            type: 'using',
+            columns: columns
+        });
+        return this;
+    }
+    where(callback) {
+        const collector = new ConditionCollector();
+        callback(collector);
+        this.whereConditions.push(...collector.getConditions());
+        return this;
+    }
+    select(...args) {
+        if (args.length === 1 && Array.isArray(args[0])) {
+            this.selectedColumns = args[0];
+        }
+        else {
+            this.selectedColumns = args;
+        }
+        return this;
+    }
+    get [JOIN_INTERNAL]() {
+        return {
+            toSQL: () => this.internalToSQL(),
+            isUsingJoin: () => this.internalIsUsingJoin(),
+            getUsingColumns: () => this.internalGetUsingColumns(),
+            toUsingSQL: () => this.internalToUsingSQL(),
+            getConditions: () => [...this.conditions],
+            getWhereConditions: () => [...this.whereConditions],
+            hasConditions: () => this.conditions.length > 0,
+            hasWhereConditions: () => this.whereConditions.length > 0,
+            getSelectedColumns: () => this.selectedColumns ?? null,
+        };
+    }
+    internalToSQL() {
+        const parts = [];
+        for (const cond of this.conditions) {
+            switch (cond.type) {
+                case 'using':
+                    break;
+                case 'raw':
+                    parts.push(cond.raw);
+                    break;
+                default:
+                    const leftSQL = columnRefToSQL(cond.left);
+                    const rightSQL = this.formatRightSide(cond.right);
+                    parts.push(`${leftSQL} ${cond.operator} ${rightSQL}`);
+                    break;
+            }
+        }
+        if (this.whereConditions.length > 0) {
+            const whereSQL = buildConditionsSQL(this.whereConditions);
+            if (whereSQL) {
+                parts.push(whereSQL);
+            }
+        }
+        return parts.join(' AND ');
+    }
+    internalIsUsingJoin() {
+        return this.conditions.length === 1 && this.conditions[0].type === 'using';
+    }
+    internalGetUsingColumns() {
+        if (!this.internalIsUsingJoin())
+            return null;
+        return this.conditions[0].columns || null;
+    }
+    internalToUsingSQL() {
+        const columns = this.internalGetUsingColumns();
+        if (!columns)
+            return null;
+        return `USING (${columns.map(c => format.ident(c)).join(', ')})`;
+    }
+    formatRightSide(right) {
+        if (isColumnRef(right)) {
+            return columnRefToSQL(right);
+        }
+        if (right === null) {
+            return 'NULL';
+        }
+        if (typeof right === 'boolean') {
+            return right ? 'true' : 'false';
+        }
+        if (typeof right === 'number') {
+            return String(right);
+        }
+        if (typeof right === 'string') {
+            return format.literal(right);
+        }
+        if (right instanceof Date) {
+            return format.literal(right.toISOString());
+        }
+        if (Array.isArray(right)) {
+            return `ARRAY[${right.map(v => this.formatRightSide(v)).join(', ')}]`;
+        }
+        return format.literal(JSON.stringify(right));
+    }
+}
+export function createJoinConditionBuilder() {
+    return new JoinConditionBuilder();
+}

package/dist/esm/select/join-internals.js

@@ -0,0 +1,2 @@
+export const JOIN_INTERNAL = Symbol.for('join-internal');
+export const JOIN_SETUP = Symbol.for('join-setup');