@hypequery/clickhouse 0.2.1

package/dist/core/cross-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-filter.d.ts","sourceRoot":"","sources":["../../src/core/cross-filter.ts"],"names":[],"mappings":"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"}

package/dist/core/cross-filter.js

@@ -0,0 +1,218 @@
+import { FilterValidator } from './validators/filter-validator';
+export const DateRange = {
+    TODAY: 'today',
+    YESTERDAY: 'yesterday',
+    LAST_7_DAYS: 'last_7_days',
+    LAST_30_DAYS: 'last_30_days',
+    THIS_MONTH: 'this_month',
+    LAST_MONTH: 'last_month',
+    THIS_QUARTER: 'this_quarter',
+    YEAR_TO_DATE: 'year_to_date'
+};
+/**
+ * A type-safe filter builder supporting both simple conditions and complex nested groups.
+ * @template Schema - The full database schema type
+ * @template TableName - The specific table being filtered
+ */
+export class CrossFilter {
+    // Optionally pass a schema to get full type-validation.
+    constructor(schema) {
+        this.schema = schema;
+        this.rootGroup = { operator: 'AND', conditions: [] };
+    }
+    /**
+     * Adds a single filter condition to the root group with an implicit AND conjunction.
+     * Performs type-safe validation if a schema is provided.
+     */
+    add(condition) {
+        if (this.schema) {
+            const columnType = this.getColumnType(String(condition.column));
+            this.validateValueType(columnType, condition.value, String(condition.column), condition.operator);
+        }
+        // Convert Date objects to ISO strings for ClickHouse
+        let value = condition.value;
+        if (Array.isArray(value)) {
+            value = value.map(v => v instanceof Date ? v.toISOString() : v);
+        }
+        else if (value instanceof Date) {
+            value = value.toISOString();
+        }
+        this.rootGroup.conditions.push({
+            ...condition,
+            value
+        });
+        return this;
+    }
+    /**
+     * Adds multiple filter conditions to the root group.
+     */
+    addMultiple(conditions) {
+        if (this.schema) {
+            this.validateGroup(conditions);
+        }
+        this.rootGroup.conditions.push(...conditions);
+        return this;
+    }
+    /**
+     * Adds a nested group of filter conditions to the root group using the specified logical operator.
+     * @param groupConditions - Array of filter conditions or nested groups to be grouped together.
+     * @param operator - Logical operator ('AND' or 'OR') to combine the conditions in the group.
+     */
+    addGroup(groupConditions, operator) {
+        if (this.schema) {
+            this.validateGroup(groupConditions);
+        }
+        const group = {
+            operator,
+            conditions: groupConditions
+        };
+        this.rootGroup.conditions.push(group);
+        return this;
+    }
+    /**
+     * Returns the current filter tree representing all conditions and groups.
+     */
+    getConditions() {
+        return this.rootGroup;
+    }
+    /**
+     * Looks up a column's type from the schema.
+     * Defaults to 'String' if no schema is provided.
+     * @param column - The column name as a string.
+     */
+    getColumnType(column) {
+        if (!this.schema) {
+            return 'String';
+        }
+        for (const table in this.schema) {
+            const tableSchema = this.schema[table];
+            if (column in tableSchema) {
+                return tableSchema[column];
+            }
+        }
+        throw new Error(`Column '${column}' not found in schema`);
+    }
+    /**
+     * Validates the value of a filter condition against its expected column type.
+     */
+    validateValueType(columnType, value, columnName, operator) {
+        FilterValidator.validateFilterCondition({ column: columnName, operator, value }, columnType, { allowNull: true } // CrossFilter allows null values
+        );
+    }
+    /**
+     * Recursively validates an array of filter conditions and nested groups.
+     */
+    validateGroup(conditions) {
+        for (const condition of conditions) {
+            if (this.isGroup(condition)) {
+                // Recursively validate nested groups
+                this.validateGroup(condition.conditions);
+            }
+            else {
+                const columnType = this.getColumnType(String(condition.column));
+                this.validateValueType(columnType, condition.value, String(condition.column), condition.operator);
+            }
+        }
+    }
+    /**
+     * Type guard to check if an item is a FilterGroup.
+     */
+    isGroup(item) {
+        return typeof item.conditions !== 'undefined';
+    }
+    addDateCondition(column, value) {
+        this.rootGroup.conditions.push({
+            column,
+            operator: 'between',
+            value: [value[0].toISOString(), value[1].toISOString()]
+        });
+        return this;
+    }
+    addDateRange(column, range) {
+        const now = new Date();
+        let start;
+        let end;
+        switch (range) {
+            case 'today':
+                start = new Date(now.setHours(0, 0, 0, 0));
+                end = new Date(now.setHours(23, 59, 59, 999));
+                break;
+            case 'yesterday':
+                start = new Date(now.setDate(now.getDate() - 1));
+                start.setHours(0, 0, 0, 0);
+                end = new Date(start);
+                end.setHours(23, 59, 59, 999);
+                break;
+            case 'last_7_days':
+                end = new Date(now);
+                start = new Date(now.setDate(now.getDate() - 7));
+                break;
+            case 'last_30_days':
+                end = new Date(now);
+                start = new Date(now.setDate(now.getDate() - 30));
+                break;
+            case 'this_month':
+                start = new Date(now.getFullYear(), now.getMonth(), 1);
+                end = new Date(now.getFullYear(), now.getMonth() + 1, 0);
+                break;
+            case 'last_month':
+                start = new Date(now.getFullYear(), now.getMonth() - 1, 1);
+                end = new Date(now.getFullYear(), now.getMonth(), 0);
+                break;
+            case 'this_quarter':
+                const quarter = Math.floor(now.getMonth() / 3);
+                start = new Date(now.getFullYear(), quarter * 3, 1);
+                end = new Date(now.getFullYear(), (quarter + 1) * 3, 0);
+                break;
+            case 'year_to_date':
+                start = new Date(now.getFullYear(), 0, 1);
+                end = new Date(now);
+                break;
+            default:
+                throw new Error(`Unsupported date range: ${range}`);
+        }
+        return this.addDateCondition(column, [start, end]);
+    }
+    lastNDays(column, days) {
+        const end = new Date();
+        const start = new Date();
+        start.setDate(start.getDate() - days);
+        return this.addDateCondition(column, [start, end]);
+    }
+    addComparisonPeriod(column, currentRange) {
+        const periodLength = currentRange[1].getTime() - currentRange[0].getTime();
+        const previousStart = new Date(currentRange[0].getTime() - periodLength);
+        const previousEnd = new Date(currentRange[1].getTime() - periodLength);
+        return this.addDateCondition(column, [previousStart, previousEnd]);
+    }
+    addYearOverYear(column, currentRange) {
+        const previousStart = new Date(currentRange[0]);
+        previousStart.setFullYear(previousStart.getFullYear() - 1);
+        const previousEnd = new Date(currentRange[1]);
+        previousEnd.setFullYear(previousEnd.getFullYear() - 1);
+        return this.addDateCondition(column, [previousStart, previousEnd]);
+    }
+    /**
+     * Creates a filter for top N records by a value column
+     * @param valueColumn - The column to filter and order by
+     * @param n - Number of records to return
+     * @param orderBy - Sort direction, defaults to 'desc'
+     */
+    topN(valueColumn, n, orderBy = 'desc') {
+        this.add({
+            column: valueColumn,
+            operator: 'gt',
+            value: 0
+        });
+        // Store limit and order information in the root group's metadata
+        this.rootGroup = {
+            ...this.rootGroup,
+            limit: n,
+            orderBy: {
+                column: valueColumn,
+                direction: orderBy.toUpperCase()
+            }
+        };
+        return this;
+    }
+}

package/dist/core/features/aggregations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregations.d.ts","sourceRoot":"","sources":["../../../src/core/features/aggregations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qBAAa,kBAAkB,CAC7B,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAED,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAExF,OAAO,CAAC,iBAAiB;IAsBzB,GAAG,CAAC,MAAM,SAAS,MAAM,SAAS,EAAE,KAAK,SAAS,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,MAAM,EACjF,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;;;;IASf,KAAK,CAAC,MAAM,SAAS,MAAM,SAAS,EAAE,KAAK,SAAS,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,QAAQ,EACrF,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;;;;IASf,GAAG,CAAC,MAAM,SAAS,MAAM,SAAS,EAAE,KAAK,SAAS,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,MAAM,EACjF,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;;;;IASf,GAAG,CAAC,MAAM,SAAS,MAAM,SAAS,EAAE,KAAK,SAAS,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,MAAM,EACjF,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;;;;IASf,GAAG,CAAC,MAAM,SAAS,MAAM,SAAS,EAAE,KAAK,SAAS,MAAM,GAAG,GAAG,MAAM,GAAG,MAAM,MAAM,EACjF,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,KAAK;;;;;;;;;;;;;;;;;;CAQhB"}

package/dist/core/features/aggregations.js

@@ -0,0 +1,35 @@
+export class AggregationFeature {
+    constructor(builder) {
+        this.builder = builder;
+    }
+    createAggregation(column, fn, alias) {
+        const aggregationSQL = `${fn}(${String(column)}) AS ${alias}`;
+        const config = this.builder.getConfig();
+        if (config.select) {
+            return {
+                ...config,
+                select: [...(config.select || []).map(String), aggregationSQL],
+                groupBy: (config.select || []).map(String).filter(col => !col.includes(' AS '))
+            };
+        }
+        return {
+            ...config,
+            select: [aggregationSQL]
+        };
+    }
+    sum(column, alias) {
+        return this.createAggregation(column, 'SUM', alias || `${String(column)}_sum`);
+    }
+    count(column, alias) {
+        return this.createAggregation(column, 'COUNT', alias || `${String(column)}_count`);
+    }
+    avg(column, alias) {
+        return this.createAggregation(column, 'AVG', alias || `${String(column)}_avg`);
+    }
+    min(column, alias) {
+        return this.createAggregation(column, 'MIN', alias || `${String(column)}_min`);
+    }
+    max(column, alias) {
+        return this.createAggregation(column, 'MAX', alias || `${String(column)}_max`);
+    }
+}

package/dist/core/features/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/core/features/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,qBAAa,gBAAgB,CAC3B,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAED,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAExF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM;;;;;;;;;;;;;;;;;;IAS/D,eAAe,CACb,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,EACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,eAAe;;;;;;;;;;;;;;;;;;IAiBhK,WAAW,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;;;;;;;CAQrC"}

package/dist/core/features/analytics.js

@@ -0,0 +1,35 @@
+export class AnalyticsFeature {
+    constructor(builder) {
+        this.builder = builder;
+    }
+    addCTE(alias, subquery) {
+        const config = this.builder.getConfig();
+        const cte = typeof subquery === 'string' ? subquery : subquery.toSQL();
+        return {
+            ...config,
+            ctes: [...(config.ctes || []), `${alias} AS (${cte})`]
+        };
+    }
+    addTimeInterval(column, interval, method) {
+        const config = this.builder.getConfig();
+        const groupBy = config.groupBy || [];
+        if (method === 'toStartOfInterval') {
+            groupBy.push(`${method}(${String(column)}, INTERVAL ${interval})`);
+        }
+        else {
+            groupBy.push(`${method}(${String(column)})`);
+        }
+        return {
+            ...config,
+            groupBy
+        };
+    }
+    addSettings(opts) {
+        const config = this.builder.getConfig();
+        const settingsFragments = Object.entries(opts).map(([key, value]) => `${key}=${value}`);
+        return {
+            ...config,
+            settings: settingsFragments.join(', ')
+        };
+    }
+}

package/dist/core/features/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/core/features/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,qBAAa,eAAe,CAC1B,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAED,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAExF,eAAe,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,GAAG,EAAE,CAAA;KAAE;IAOrD,KAAK,IAAI,MAAM;IAKT,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAgDvB,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IA+C5C,OAAO,CAAC,sBAAsB;CA0C/B"}

package/dist/core/features/executor.js

@@ -0,0 +1,136 @@
+import { ClickHouseConnection } from '../connection';
+import { substituteParameters } from '../utils';
+import { logger } from '../utils/logger';
+export class ExecutorFeature {
+    constructor(builder) {
+        this.builder = builder;
+    }
+    toSQLWithParams() {
+        const sql = this.toSQLWithoutParameters();
+        const config = this.builder.getConfig();
+        const parameters = config.parameters || [];
+        return { sql, parameters };
+    }
+    toSQL() {
+        const { sql, parameters } = this.toSQLWithParams();
+        return substituteParameters(sql, parameters);
+    }
+    async execute() {
+        const client = ClickHouseConnection.getClient();
+        const { sql, parameters } = this.toSQLWithParams();
+        const finalSQL = substituteParameters(sql, parameters);
+        const startTime = Date.now();
+        logger.logQuery({
+            query: finalSQL,
+            parameters,
+            startTime,
+            status: 'started'
+        });
+        try {
+            const result = await client.query({
+                query: finalSQL,
+                format: 'JSONEachRow'
+            });
+            const rows = await result.json();
+            const endTime = Date.now();
+            logger.logQuery({
+                query: finalSQL,
+                parameters,
+                startTime,
+                endTime,
+                duration: endTime - startTime,
+                status: 'completed',
+                rowCount: rows.length
+            });
+            return rows;
+        }
+        catch (error) {
+            const endTime = Date.now();
+            logger.logQuery({
+                query: finalSQL,
+                parameters,
+                startTime,
+                endTime,
+                duration: endTime - startTime,
+                status: 'error',
+                error: error
+            });
+            throw error;
+        }
+    }
+    async stream() {
+        const client = ClickHouseConnection.getClient();
+        const { sql, parameters } = this.toSQLWithParams();
+        const finalSQL = substituteParameters(sql, parameters);
+        const startTime = Date.now();
+        logger.logQuery({
+            query: finalSQL,
+            parameters,
+            startTime,
+            status: 'started'
+        });
+        try {
+            const result = await client.query({
+                query: finalSQL,
+                format: 'JSONEachRow'
+            });
+            const stream = result.stream();
+            const endTime = Date.now();
+            logger.logQuery({
+                query: finalSQL,
+                parameters,
+                startTime,
+                endTime,
+                duration: endTime - startTime,
+                status: 'completed'
+            });
+            return stream;
+        }
+        catch (error) {
+            const endTime = Date.now();
+            logger.logQuery({
+                query: finalSQL,
+                parameters,
+                startTime,
+                endTime,
+                duration: endTime - startTime,
+                status: 'error',
+                error: error
+            });
+            throw error;
+        }
+    }
+    toSQLWithoutParameters() {
+        const config = this.builder.getConfig();
+        const formatter = this.builder.getFormatter();
+        const parts = [];
+        if (config.ctes?.length) {
+            parts.push(`WITH ${config.ctes.join(', ')}`);
+        }
+        parts.push(`SELECT ${formatter.formatSelect(config)}`);
+        parts.push(`FROM ${this.builder.getTableName()}`);
+        if (config.joins?.length) {
+            parts.push(formatter.formatJoins(config));
+        }
+        if (config.where?.length) {
+            parts.push(`WHERE ${formatter.formatWhere(config)}`);
+        }
+        if (config.groupBy?.length) {
+            parts.push(`GROUP BY ${formatter.formatGroupBy(config)}`);
+        }
+        if (config.having?.length) {
+            parts.push(`HAVING ${config.having.join(' AND ')}`);
+        }
+        if (config.orderBy?.length) {
+            const orderBy = config.orderBy
+                .map(({ column, direction }) => `${String(column)} ${direction}`.trim())
+                .join(', ');
+            parts.push(`ORDER BY ${orderBy}`);
+        }
+        if (config.limit) {
+            const offsetClause = config.offset ? `OFFSET ${config.offset}` : '';
+            parts.push(`LIMIT ${config.limit} ${offsetClause}`);
+        }
+        return parts.join(' ').trim();
+    }
+}

package/dist/core/features/filtering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../../src/core/features/filtering.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtE,qBAAa,gBAAgB,CAC3B,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAED,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAExF,YAAY,CAAC,CAAC,SAAS,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,EAC1D,WAAW,EAAE,KAAK,GAAG,IAAI,EACzB,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,GAAG;;;;;;;;;;;;;;;;;;CA6Bb"}

package/dist/core/features/filtering.js

@@ -0,0 +1,30 @@
+export class FilteringFeature {
+    constructor(builder) {
+        this.builder = builder;
+    }
+    addCondition(conjunction, column, operator, value) {
+        const config = this.builder.getConfig();
+        const where = config.where || [];
+        const parameters = config.parameters || [];
+        where.push({
+            column: String(column),
+            operator,
+            value,
+            conjunction
+        });
+        if (operator === 'in' || operator === 'notIn') {
+            parameters.push(...value);
+        }
+        else if (operator === 'between') {
+            parameters.push(value[0], value[1]);
+        }
+        else {
+            parameters.push(value);
+        }
+        return {
+            ...config,
+            where,
+            parameters
+        };
+    }
+}

package/dist/core/features/joins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joins.d.ts","sourceRoot":"","sources":["../../../src/core/features/joins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEnD,qBAAa,WAAW,CACtB,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAED,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAExF,OAAO,CAAC,SAAS,SAAS,MAAM,MAAM,EACpC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,SAAS,EAC3B,WAAW,EAAE,GAAG,SAAS,GAAG,MAAM,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,EAAE,EACxE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;CAYjB"}

package/dist/core/features/joins.js

@@ -0,0 +1,16 @@
+export class JoinFeature {
+    constructor(builder) {
+        this.builder = builder;
+    }
+    addJoin(type, table, leftColumn, rightColumn, alias) {
+        const config = this.builder.getConfig();
+        const newConfig = {
+            ...config,
+            joins: [
+                ...(config.joins || []),
+                { type, table: String(table), leftColumn: String(leftColumn), rightColumn, alias }
+            ]
+        };
+        return newConfig;
+    }
+}

package/dist/core/features/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../src/core/features/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAyB,MAAM,aAAa,CAAC;AAEpG,qBAAa,iBAAiB,CAC5B,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,EAC5E,CAAC,EACD,SAAS,SAAS,OAAO,GAAG,KAAK,EACjC,YAAY,GAAG,EAAE,EACjB,SAAS,GAAG,CAAC;IAKD,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAiE;IAC5F,OAAO,CAAC,QAAQ,CAAS;gBAEL,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;IAQxF,OAAO,KAAK,WAAW,GAEtB;IAED,OAAO,KAAK,WAAW,QAGtB;IAED,OAAO,KAAK,eAAe,GAE1B;IAED,OAAO,KAAK,eAAe,QAG1B;IAED,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAId,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IA0I1E,OAAO,CAAC,cAAc;IAmBhB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAIvD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAkB1E"}