@hypequery/clickhouse 1.6.2 → 2.0.1

package/dist/core/tests/integration/setup.js

@@ -1,11 +1,8 @@
-import path from 'path';
-import { fileURLToPath } from 'url';
 import { ClickHouseConnection } from '../../connection.js';
-import { exec } from 'child_process';
-import { promisify } from 'util';
 import { logger as hypeQueryLogger } from '../../utils/logger.js';
-// @ts-expect-error: raw JSON import for supplying fixture data
-import rawTestData from './test-data.json';
+import { CLICKHOUSE_CONTAINER_NAME, TEST_CONNECTION_CONFIG, TEST_DATA, detectComposeCommand, ensureDockerDaemon, isContainerRunning as sharedIsContainerRunning, seedClickHouseDatabase, startClickHouseContainer as sharedStartClickHouseContainer, stopClickHouseContainer as sharedStopClickHouseContainer, waitForClickHouse as sharedWaitForClickHouse,
+// @ts-expect-error: shared test harness is plain JS
+ } from '../../../../../../testing/clickhouse/harness.mjs';
 // Disable the hypequery logger to prevent "logs after tests" errors
 // This must be done early in the setup, before any queries run
 hypeQueryLogger.configure({ enabled: false });
@@ -27,20 +24,7 @@ const logger = {
         }
     }
 };
-const execAsync = promisify(exec);
-// Create a path to the project root
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const projectRoot = path.resolve(__dirname, '../../../../../');
-// Connection configuration (with defaults that can be overridden by env variables)
-const CLICKHOUSE_TEST_PORT = process.env.CLICKHOUSE_TEST_PORT || '8123';
-const config = {
-    host: process.env.CLICKHOUSE_TEST_HOST || `http://localhost:${CLICKHOUSE_TEST_PORT}`,
-    user: process.env.CLICKHOUSE_TEST_USER || 'default',
-    password: process.env.CLICKHOUSE_TEST_PASSWORD || 'hypequery_test',
-    database: process.env.CLICKHOUSE_TEST_DB || 'test_db',
-};
-export const TEST_CONNECTION_CONFIG = config;
+const config = TEST_CONNECTION_CONFIG;
 // Initialize the ClickHouse connection
 export const initializeTestConnection = async () => {
     logger.info('Initializing ClickHouse connection with config:', config);
@@ -84,178 +68,41 @@ export const ensureConnectionInitialized = () => {
     return ClickHouseConnection.getClient();
 };
 // Check if Docker is installed
-export const isDockerAvailable = async () => {
-    try {
-        await execAsync('docker --version');
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-};
-// Check if Docker Compose is installed
-export const isDockerComposeAvailable = async () => {
-    try {
-        await execAsync('docker compose version');
-        return true;
-    }
-    catch (error) {
-        try {
-            // Try the hyphenated version for older installations
-            await execAsync('docker-compose --version');
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-};
-// Check if a docker container is running
 export const isContainerRunning = async (containerName) => {
-    try {
-        const { stdout } = await execAsync(`docker ps --filter "name=${containerName}" --format "{{.Names}}"`);
-        return stdout.trim() === containerName;
-    }
-    catch (error) {
-        return false;
-    }
-};
-// Check if ClickHouse is ready
-export const isClickHouseReady = async () => {
-    try {
-        const client = ClickHouseConnection.getClient();
-        await client.ping();
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
+    return sharedIsContainerRunning(containerName);
 };
 // Start the ClickHouse container
 export const startClickHouseContainer = async () => {
-    const dockerAvailable = await isDockerAvailable();
-    if (!dockerAvailable) {
-        throw new Error('Docker is not available. Please install Docker to run integration tests.');
-    }
-    const composeAvailable = await isDockerComposeAvailable();
-    // Use Docker Compose if available
-    if (composeAvailable) {
-        logger.info('Starting ClickHouse container with Docker Compose...');
-        try {
-            // Fix the path to the docker-compose.test.yml file
-            const composePath = path.resolve(projectRoot, 'packages/clickhouse/docker-compose.test.yml');
-            logger.info(`Using Docker Compose file at: ${composePath}`);
-            // Make sure we're executing the command from the correct directory
-            await execAsync(`docker compose -f "${composePath}" up -d`);
-        }
-        catch (error) {
-            logger.error('Failed to start ClickHouse container with Docker Compose:', error);
-            throw error;
-        }
-    }
-    else {
-        // Fallback to Docker run
-        logger.info('Starting ClickHouse container with Docker...');
-        try {
-            await execAsync(`
-        docker run -d --name hypequery-test-clickhouse 
-        -p 8123:8123 -p 9000:9000
-        -e CLICKHOUSE_USER=${config.user}
-        -e CLICKHOUSE_PASSWORD=${config.password}
-        -e CLICKHOUSE_DB=${config.database}
-        --ulimit nofile=262144:262144
-        clickhouse/clickhouse-server:latest
-      `);
-        }
-        catch (error) {
-            logger.error('Failed to start ClickHouse container with Docker:', error);
-            throw error;
-        }
-    }
+    await ensureDockerDaemon();
+    const compose = await detectComposeCommand();
+    await sharedStartClickHouseContainer({
+        compose,
+        logger: (message) => logger.info(message),
+    });
 };
 // Wait for ClickHouse to be ready
 export const waitForClickHouse = async (maxAttempts = 30, retryInterval = 1000) => {
-    logger.info('Waiting for ClickHouse to be ready...');
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-        if (await isClickHouseReady()) {
-            logger.info('ClickHouse is ready!');
-            return;
-        }
-        logger.info(`Waiting for ClickHouse... Attempt ${attempt}/${maxAttempts}`);
-        await new Promise(resolve => setTimeout(resolve, retryInterval));
-    }
-    throw new Error(`ClickHouse failed to start after ${maxAttempts} attempts`);
+    await sharedWaitForClickHouse({
+        config,
+        maxAttempts,
+        retryDelayMs: retryInterval,
+        logger: (message) => logger.info(message),
+    });
 };
 // Stop the ClickHouse container
 export const stopClickHouseContainer = async () => {
-    const composeAvailable = await isDockerComposeAvailable();
-    if (composeAvailable) {
-        logger.info('Stopping ClickHouse container with Docker Compose...');
-        try {
-            // Fix the path to the docker-compose.test.yml file
-            const composePath = path.resolve(projectRoot, 'packages/clickhouse/docker-compose.test.yml');
-            logger.info(`Using Docker Compose file at: ${composePath}`);
-            // Make sure we're executing the command from the correct directory
-            await execAsync(`docker compose -f "${composePath}" down -v`);
-        }
-        catch (error) {
-            logger.error('Failed to stop ClickHouse container with Docker Compose:', error);
-            // Log the error but don't throw, so the tests can complete
-            // This allows for manual cleanup if needed
-        }
+    try {
+        const compose = await detectComposeCommand();
+        await sharedStopClickHouseContainer({
+            compose,
+            logger: (message) => logger.info(message),
+        });
     }
-    else {
-        logger.info('Stopping ClickHouse container with Docker...');
-        try {
-            await execAsync('docker stop hypequery-test-clickhouse && docker rm hypequery-test-clickhouse');
-        }
-        catch (error) {
-            logger.error('Failed to stop ClickHouse container with Docker:', error);
-            // Log the error but don't throw, so the tests can complete
-        }
+    catch (error) {
+        logger.error('Failed to stop ClickHouse container:', error);
     }
 };
-function normalizeDateValue(value) {
-    if (!value) {
-        return value;
-    }
-    if (value.includes('T')) {
-        return value.split('T')[0];
-    }
-    if (value.includes(' ')) {
-        return value.split(' ')[0];
-    }
-    return value;
-}
-function normalizeTestData() {
-    const testTable = (rawTestData.test_table ?? []).map(row => ({
-        id: row.id,
-        name: row.name,
-        category: row.category,
-        price: row.price,
-        created_at: normalizeDateValue(row.created_at),
-        is_active: row.is_active
-    }));
-    const users = (rawTestData.users ?? []).map(row => ({
-        id: row.id,
-        user_name: row.user_name,
-        email: row.email,
-        status: row.status,
-        created_at: normalizeDateValue(row.created_at)
-    }));
-    const orders = (rawTestData.orders ?? []).map(row => ({
-        id: row.id,
-        user_id: row.user_id,
-        product_id: row.product_id,
-        quantity: row.quantity,
-        total: row.total,
-        status: row.status,
-        created_at: normalizeDateValue(row.created_at)
-    }));
-    return { test_table: testTable, users, orders };
-}
-// Test data
-export const TEST_DATA = normalizeTestData();
+export { CLICKHOUSE_CONTAINER_NAME, TEST_CONNECTION_CONFIG, TEST_DATA };
 let hasSetupRun = false;
 // Setup the test database
 export const setupTestDatabase = async () => {
@@ -266,78 +113,12 @@ export const setupTestDatabase = async () => {
     if (hasSetupRun) {
         return;
     }
-    // Make sure connection is initialized before getting client
-    const client = ensureConnectionInitialized();
     try {
-        // Create and use database if it doesn't exist
-        await client.exec({ query: `CREATE DATABASE IF NOT EXISTS ${config.database}` });
-        await client.exec({ query: `USE ${config.database}` });
-        // Drop tables if they exist
-        await client.exec({ query: 'DROP TABLE IF EXISTS test_table' });
-        await client.exec({ query: 'DROP TABLE IF EXISTS users' });
-        await client.exec({ query: 'DROP TABLE IF EXISTS orders' });
-        // Create tables
-        await client.exec({
-            query: `
-        CREATE TABLE test_table (
-          id UInt32,
-          name String,
-          category String,
-          price Float64,
-          created_at Date,
-          is_active Boolean
-        ) ENGINE = MergeTree()
-        ORDER BY id
-      `
-        });
-        await client.exec({
-            query: `
-        CREATE TABLE users (
-          id UInt32,
-          user_name String,
-          email String,
-          status String,
-          created_at Date
-        ) ENGINE = MergeTree()
-        ORDER BY id
-      `
-        });
-        await client.exec({
-            query: `
-        CREATE TABLE orders (
-          id UInt32,
-          user_id UInt32,
-          product_id UInt32,
-          quantity UInt32,
-          total Float64,
-          status String,
-          created_at Date
-        ) ENGINE = MergeTree()
-        ORDER BY id
-      `
+        await seedClickHouseDatabase({
+            config,
+            data: TEST_DATA,
+            logger: (message) => logger.info(message),
         });
-        // Insert test data
-        for (const row of TEST_DATA.test_table) {
-            await client.insert({
-                table: 'test_table',
-                values: [row],
-                format: 'JSONEachRow'
-            });
-        }
-        for (const row of TEST_DATA.users) {
-            await client.insert({
-                table: 'users',
-                values: [row],
-                format: 'JSONEachRow'
-            });
-        }
-        for (const row of TEST_DATA.orders) {
-            await client.insert({
-                table: 'orders',
-                values: [row],
-                format: 'JSONEachRow'
-            });
-        }
         hasSetupRun = true;
         logger.info('Test database setup complete');
     }

package/dist/core/types/select-types.d.ts

@@ -18,6 +18,9 @@ export type SelectableItem<State extends AnyBuilderState> = SelectableColumn<Sta
 export type ColumnSelectionKey<P> = P extends `${string}.${infer C}` ? C : P;
 type QualifiedColumnValue<State extends AnyBuilderState, P> = P extends `${infer Table}.${infer Column}` ? ResolveTableSchema<State, Table> extends Record<string, ColumnType> ? Column extends keyof ResolveTableSchema<State, Table> ? ResolveTableSchema<State, Table>[Column] extends ColumnType ? InferColumnType<ResolveTableSchema<State, Table>[Column]> : never : never : never : never;
 export type ColumnSelectionValue<State extends AnyBuilderState, P> = P extends OutputColumnKeys<State> ? State['output'][P] : P extends ScalarColumnKeys<State> ? State['scalars'][P] : P extends BaseColumnKeys<State> ? BaseRow<State>[P] : QualifiedColumnValue<State, P>;
+export type ArraySelectableColumn<State extends AnyBuilderState> = {
+    [P in SelectableColumn<State>]: ColumnSelectionValue<State, P> extends readonly unknown[] | null ? P : never;
+}[SelectableColumn<State>];
 export type ColumnSelectionRecord<State extends AnyBuilderState, K> = {
     [P in Extract<K, SelectableColumn<State>> as ColumnSelectionKey<P>]: ColumnSelectionValue<State, P>;
 };

package/dist/core/types/select-types.d.ts.map

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

package/dist/core/utils/connection-endpoint.d.ts

@@ -0,0 +1,3 @@
+import type { ClickHouseConfig } from '../query-builder.js';
+export declare function getConnectionEndpoint(config: ClickHouseConfig): string | undefined;
+//# sourceMappingURL=connection-endpoint.d.ts.map

package/dist/core/utils/connection-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-endpoint.d.ts","sourceRoot":"","sources":["../../../src/core/utils/connection-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAQlF"}

package/dist/core/utils/connection-endpoint.js

@@ -0,0 +1,9 @@
+export function getConnectionEndpoint(config) {
+    if ('url' in config && typeof config.url === 'string') {
+        return config.url;
+    }
+    if ('host' in config && typeof config.host === 'string') {
+        return config.host;
+    }
+    return undefined;
+}

package/dist/core/utils/filter-application.d.ts

@@ -0,0 +1,15 @@
+import type { FilterOperator } from '../../types/index.js';
+import type { PredicateBuilder, PredicateExpression } from './predicate-builder.js';
+export interface FilterExpressionApplication<TExpression> {
+    kind: 'expression';
+    expression: TExpression;
+}
+export interface FilterConditionApplication {
+    kind: 'condition';
+    column: string | string[];
+    validationTarget: string | string[];
+    operator: FilterOperator;
+    value: unknown;
+}
+export declare function normalizeFilterApplication<TExpression>(clause: 'where' | 'prewhere', conjunction: 'AND' | 'OR', columnOrColumns: string | string[] | ((expr: PredicateBuilder<any>) => PredicateExpression), operator: FilterOperator | undefined, value: unknown, buildExpression: (builder: (expr: PredicateBuilder<any>) => PredicateExpression) => TExpression): FilterExpressionApplication<TExpression> | FilterConditionApplication;
+//# sourceMappingURL=filter-application.d.ts.map

package/dist/core/utils/filter-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-application.d.ts","sourceRoot":"","sources":["../../../src/core/utils/filter-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGpF,MAAM,WAAW,2BAA2B,CAAC,WAAW;IACtD,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,WAAW,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EACpD,MAAM,EAAE,OAAO,GAAG,UAAU,EAC5B,WAAW,EAAE,KAAK,GAAG,IAAI,EACzB,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,mBAAmB,CAAC,EAC3F,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,mBAAmB,KAAK,WAAW,GAC9F,2BAA2B,CAAC,WAAW,CAAC,GAAG,0BAA0B,CAkCvE"}

package/dist/core/utils/filter-application.js

@@ -0,0 +1,32 @@
+import { validateTupleFilterValue } from './tuple-filter-validation.js';
+export function normalizeFilterApplication(clause, conjunction, columnOrColumns, operator, value, buildExpression) {
+    if (typeof columnOrColumns === 'function') {
+        return {
+            kind: 'expression',
+            expression: buildExpression(columnOrColumns),
+        };
+    }
+    if (operator === undefined) {
+        throw new Error(`Operator is required when specifying a column for ${conjunction === 'AND' ? clause : `or${clause[0].toUpperCase()}${clause.slice(1)}`}()`);
+    }
+    if (Array.isArray(columnOrColumns) && (operator === 'inTuple' || operator === 'globalInTuple')) {
+        const columns = columnOrColumns.map(String);
+        validateTupleFilterValue(operator, value, columns.length);
+        return {
+            kind: 'condition',
+            column: columns,
+            validationTarget: columns,
+            operator,
+            value,
+        };
+    }
+    validateTupleFilterValue(operator, value, 1);
+    const column = Array.isArray(columnOrColumns) ? String(columnOrColumns[0]) : String(columnOrColumns);
+    return {
+        kind: 'condition',
+        column,
+        validationTarget: Array.isArray(columnOrColumns) ? columnOrColumns.map(String) : column,
+        operator,
+        value,
+    };
+}

package/dist/core/utils/query-config-compat.d.ts

@@ -0,0 +1,48 @@
+import type { ClickHouseSettings } from '@clickhouse/client-common';
+import type { FilterOperator, JoinType, OrderDirection, SelectQueryNode } from '../../types/index.js';
+export type LegacyStandardWhereCondition = {
+    column: string;
+    operator: FilterOperator;
+    value: any;
+    conjunction: 'AND' | 'OR';
+    type?: 'condition' | 'group-start' | 'group-end';
+};
+export type LegacyExpressionWhereCondition = {
+    type: 'expression';
+    expression: string;
+    parameters: any[];
+    conjunction: 'AND' | 'OR';
+};
+export type LegacyWhereCondition = LegacyStandardWhereCondition | LegacyExpressionWhereCondition;
+export type LegacyQueryConfig<T> = {
+    select?: Array<keyof T | string>;
+    from?: {
+        kind: 'table';
+        name: string;
+        final?: boolean;
+    };
+    where?: LegacyWhereCondition[];
+    prewhere?: LegacyWhereCondition[];
+    groupBy?: string[];
+    having?: string[];
+    limit?: number;
+    offset?: number;
+    distinct?: boolean;
+    orderBy?: Array<{
+        column: keyof T | string;
+        direction: OrderDirection;
+    }>;
+    joins?: Array<{
+        type: JoinType;
+        table: string;
+        leftColumn: string;
+        rightColumn: string;
+        alias?: string;
+    }>;
+    parameters?: any[];
+    ctes?: string[];
+    unionQueries?: string[];
+    settings?: ClickHouseSettings;
+};
+export declare function toLegacyQueryConfig<T, Schema>(queryNode: SelectQueryNode<T, Schema>): LegacyQueryConfig<T>;
+//# sourceMappingURL=query-config-compat.d.ts.map

package/dist/core/utils/query-config-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-config-compat.d.ts","sourceRoot":"","sources":["../../../src/core/utils/query-config-compat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAGV,cAAc,EACd,QAAQ,EACR,cAAc,EACd,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,GAAG,CAAC;IACX,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,WAAW,EAAE,KAAK,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,4BAA4B,GAAG,8BAA8B,CAAC;AAEjG,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACxD,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QACzB,SAAS,EAAE,cAAc,CAAC;KAC3B,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B,CAAC;AA+HF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAC3C,SAAS,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,GACpC,iBAAiB,CAAC,CAAC,CAAC,CA+BtB"}

package/dist/core/utils/query-config-compat.js

@@ -0,0 +1,137 @@
+function unwrapValueNode(value) {
+    return value.value;
+}
+function unwrapConditionValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => Array.isArray(item) ? item.map(unwrapValueNode) : unwrapValueNode(item));
+    }
+    return unwrapValueNode(value);
+}
+function collectExprParameters(expr) {
+    if (!expr)
+        return [];
+    switch (expr.kind) {
+        case 'condition': {
+            const value = unwrapConditionValue(expr.value);
+            if (expr.operator === 'between') {
+                return Array.isArray(value) ? value : [];
+            }
+            if (expr.operator === 'in' ||
+                expr.operator === 'notIn' ||
+                expr.operator === 'globalIn' ||
+                expr.operator === 'globalNotIn') {
+                return Array.isArray(value) ? value : [];
+            }
+            if (expr.operator === 'inTuple' || expr.operator === 'globalInTuple') {
+                return Array.isArray(value) ? value.flat() : [];
+            }
+            if (expr.operator === 'inSubquery' ||
+                expr.operator === 'globalInSubquery' ||
+                expr.operator === 'inTable' ||
+                expr.operator === 'globalInTable' ||
+                expr.operator === 'isNull' ||
+                expr.operator === 'isNotNull') {
+                return [];
+            }
+            return [value];
+        }
+        case 'raw':
+            return expr.parameters.map(unwrapValueNode);
+        case 'group':
+            return collectExprParameters(expr.expression);
+        case 'logical':
+            return expr.conditions.flatMap(condition => collectExprParameters(condition));
+        case 'sequence':
+            return expr.items.flatMap(item => collectExprParameters(item.expression));
+        default:
+            return [];
+    }
+}
+function flattenExprToLegacyConditions(expr, firstConjunction = 'AND') {
+    if (!expr)
+        return [];
+    switch (expr.kind) {
+        case 'condition':
+            return [{
+                    column: expr.column,
+                    operator: expr.operator,
+                    value: unwrapConditionValue(expr.value),
+                    conjunction: firstConjunction,
+                }];
+        case 'raw':
+            return [{
+                    type: 'expression',
+                    expression: expr.expression,
+                    parameters: expr.parameters.map(unwrapValueNode),
+                    conjunction: firstConjunction,
+                }];
+        case 'group': {
+            if (!expr.expression)
+                return [];
+            return [
+                {
+                    column: '',
+                    operator: 'eq',
+                    value: null,
+                    conjunction: firstConjunction,
+                    type: 'group-start',
+                },
+                ...flattenExprToLegacyConditions(expr.expression, 'AND'),
+                {
+                    column: '',
+                    operator: 'eq',
+                    value: null,
+                    conjunction: 'AND',
+                    type: 'group-end',
+                },
+            ];
+        }
+        case 'sequence':
+            return expr.items.flatMap((item, index) => flattenExprToLegacyConditions(item.expression, index === 0 ? firstConjunction : (item.conjunction || 'AND')));
+        case 'logical':
+            return flattenExprToLegacyConditions({
+                kind: 'sequence',
+                items: expr.conditions.map((condition, index) => ({
+                    conjunction: index === 0 ? undefined : expr.operator,
+                    expression: condition,
+                })),
+            }, firstConjunction);
+        default:
+            return [];
+    }
+}
+export function toLegacyQueryConfig(queryNode) {
+    return {
+        select: queryNode.select?.map(item => item.selection),
+        from: queryNode.from ? { ...queryNode.from } : undefined,
+        where: flattenExprToLegacyConditions(queryNode.where),
+        prewhere: flattenExprToLegacyConditions(queryNode.prewhere),
+        groupBy: queryNode.groupBy?.map(item => item.expression),
+        having: queryNode.having?.map(item => item.expression),
+        limit: queryNode.limit,
+        offset: queryNode.offset,
+        distinct: queryNode.distinct,
+        orderBy: queryNode.orderBy?.map(item => ({
+            column: item.column,
+            direction: item.direction,
+        })),
+        joins: queryNode.joins?.map(join => ({
+            type: join.type,
+            table: join.table,
+            leftColumn: join.leftColumn,
+            rightColumn: join.rightColumn,
+            alias: join.alias,
+        })),
+        parameters: [
+            ...collectExprParameters(queryNode.prewhere),
+            ...collectExprParameters(queryNode.where),
+            ...(queryNode.having?.flatMap(item => item.parameters?.map(unwrapValueNode) || []) || []),
+        ],
+        ctes: queryNode.ctes?.map(item => item.expression),
+        unionQueries: queryNode.unionQueries ? [...queryNode.unionQueries] : undefined,
+        settings: queryNode.settings ? { ...queryNode.settings } : undefined,
+    };
+}

package/dist/core/utils/relation-application.d.ts

@@ -0,0 +1,9 @@
+import type { SelectQueryNode } from '../../types/index.js';
+import type { SchemaDefinition } from '../types/builder-state.js';
+import type { JoinPath, JoinPathOptions, JoinRelationships } from '../join-relationships.js';
+export declare function resolveRelationPath<Schema extends SchemaDefinition<Schema>>(nameOrPath: string | JoinPath<Schema, string> | readonly JoinPath<Schema, string>[], relationships: JoinRelationships<Schema> | undefined): {
+    path: JoinPath<Schema, string> | readonly JoinPath<Schema, string>[];
+    label?: string;
+};
+export declare function applyRelationPath<Schema extends SchemaDefinition<Schema>>(query: SelectQueryNode<any, Schema>, path: JoinPath<Schema, string> | readonly JoinPath<Schema, string>[], options: JoinPathOptions | undefined, appendJoin: (currentQuery: SelectQueryNode<any, Schema>, joinPath: JoinPath<Schema, string>, options: JoinPathOptions | undefined) => SelectQueryNode<any, Schema>, label?: string): SelectQueryNode<any, Schema>;
+//# sourceMappingURL=relation-application.d.ts.map

package/dist/core/utils/relation-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-application.d.ts","sourceRoot":"","sources":["../../../src/core/utils/relation-application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACzE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACnF,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,SAAS,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAe1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACvE,KAAK,EAAE,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EACnC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACpE,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,UAAU,EAAE,CACV,YAAY,EAAE,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EAC1C,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,EAAE,eAAe,GAAG,SAAS,KACjC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,EACjC,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAQ9B"}

package/dist/core/utils/relation-application.js

@@ -0,0 +1,19 @@
+import { validateRelationAliasOverride, validateRelationPathOrigin } from './relation-validation.js';
+export function resolveRelationPath(nameOrPath, relationships) {
+    if (typeof nameOrPath !== 'string') {
+        return { path: nameOrPath };
+    }
+    if (!relationships) {
+        throw new Error('Join relationships have not been initialized. Call QueryBuilder.setJoinRelationships first.');
+    }
+    const path = relationships.get(nameOrPath);
+    if (!path) {
+        throw new Error(`Join relationship '${nameOrPath}' not found`);
+    }
+    return { path, label: nameOrPath };
+}
+export function applyRelationPath(query, path, options, appendJoin, label) {
+    validateRelationAliasOverride(path, options?.alias, label);
+    validateRelationPathOrigin(query, path, label);
+    return (Array.isArray(path) ? path : [path]).reduce((currentQuery, joinPath) => appendJoin(currentQuery, joinPath, options), query);
+}

package/dist/core/utils/relation-validation.d.ts

@@ -0,0 +1,6 @@
+import type { SelectQueryNode } from '../../types/index.js';
+import type { SchemaDefinition } from '../types/builder-state.js';
+import type { JoinPath } from '../join-relationships.js';
+export declare function validateRelationPathOrigin<Schema extends SchemaDefinition<Schema>>(query: SelectQueryNode<any, Schema>, path: JoinPath<Schema, string> | readonly JoinPath<Schema, string>[], label?: string): void;
+export declare function validateRelationAliasOverride(path: JoinPath<any, string> | readonly JoinPath<any, string>[], alias: string | undefined, label?: string): void;
+//# sourceMappingURL=relation-validation.d.ts.map