@hypequery/clickhouse 0.0.0-canary-20260306132943

package/dist/core/types/builder-state.d.ts

@@ -0,0 +1,27 @@
+import type { ColumnType, InferColumnType, TableRecord } from '../../types/schema.js';
+import type { Simplify } from './type-helpers.js';
+export type SchemaDefinition<Schema extends Record<string, any> = Record<string, any>> = {
+    [K in keyof Schema]: Record<string, ColumnType>;
+};
+export type BuilderState<Schema extends SchemaDefinition<Schema>, VisibleTables extends string, OutputRow, BaseTable extends keyof Schema, Aliases extends Partial<Record<string, keyof Schema>> = {}, Scalars extends Record<string, unknown> = {}> = {
+    schema: Schema;
+    tables: VisibleTables;
+    output: OutputRow;
+    baseTable: BaseTable;
+    base: Schema[BaseTable];
+    aliases: Aliases;
+    scalars: Scalars;
+};
+export type AnyBuilderState = BuilderState<any, any, any, any, any>;
+export type BaseRow<State extends AnyBuilderState> = Simplify<{
+    [K in keyof State['base']]: State['base'][K] extends ColumnType ? InferColumnType<State['base'][K]> : never;
+}>;
+export type WidenTables<State extends AnyBuilderState, Table extends keyof State['schema']> = BuilderState<State['schema'], State['tables'] | (Table & string), State['output'], State['baseTable'], State['aliases'], State['scalars']>;
+export type UpdateOutput<State extends AnyBuilderState, Output> = BuilderState<State['schema'], State['tables'], Output, State['baseTable'], State['aliases'], State['scalars']>;
+export type InitialState<Schema extends SchemaDefinition<Schema>, Table extends keyof Schema> = BuilderState<Schema, Table & string, TableRecord<Schema[Table]>, Table, {}, {}>;
+export type ExplicitSelectionState<State extends AnyBuilderState> = BaseRow<State> extends State['output'] ? State['output'] extends BaseRow<State> ? false : true : true;
+export type AppendToOutput<State extends AnyBuilderState, Added> = UpdateOutput<State, ExplicitSelectionState<State> extends true ? Simplify<State['output'] & Added> : Simplify<Added>>;
+export type AddAlias<State extends AnyBuilderState, Alias extends string, Table extends keyof State['schema']> = BuilderState<State['schema'], State['tables'] | Alias, State['output'], State['baseTable'], State['aliases'] & Record<Alias, Table>, State['scalars']>;
+export type AddScalar<State extends AnyBuilderState, Alias extends string, Value> = BuilderState<State['schema'], State['tables'], State['output'], State['baseTable'], State['aliases'], State['scalars'] & Record<Alias, Value>>;
+export type ResolveTableSchema<State extends AnyBuilderState, Table extends string> = Table extends keyof State['schema'] ? State['schema'][Table] : Table extends keyof State['aliases'] ? State['schema'][State['aliases'][Table]] : never;
+//# sourceMappingURL=builder-state.d.ts.map

package/dist/core/types/builder-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-state.d.ts","sourceRoot":"","sources":["../../../src/core/types/builder-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI;KACtF,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,YAAY,CACtB,MAAM,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACvC,aAAa,SAAS,MAAM,EAC5B,SAAS,EACT,SAAS,SAAS,MAAM,MAAM,EAC9B,OAAO,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC,GAAG,EAAE,EAC1D,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,IAC1C;IACF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpE,MAAM,MAAM,OAAO,CAAC,KAAK,SAAS,eAAe,IAAI,QAAQ,CAAC;KAC3D,CAAC,IAAI,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,GAC7D,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACjC,KAAK;CACR,CAAC,CAAC;AAEH,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,eAAe,EAC7B,KAAK,SAAS,MAAM,KAAK,CAAC,QAAQ,CAAC,IACjC,YAAY,CACd,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,EAClC,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,WAAW,CAAC,EAClB,KAAK,CAAC,SAAS,CAAC,EAChB,KAAK,CAAC,SAAS,CAAC,CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,CACtB,KAAK,SAAS,eAAe,EAC7B,MAAM,IACJ,YAAY,CACd,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,EACf,MAAM,EACN,KAAK,CAAC,WAAW,CAAC,EAClB,KAAK,CAAC,SAAS,CAAC,EAChB,KAAK,CAAC,SAAS,CAAC,CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,CACtB,MAAM,SAAS,gBAAgB,CAAC,MAAM,CAAC,EACvC,KAAK,SAAS,MAAM,MAAM,IACxB,YAAY,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAEpF,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,eAAe,IAC9D,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,QAAQ,CAAC,GACpC,KAAK,CAAC,QAAQ,CAAC,SAAS,OAAO,CAAC,KAAK,CAAC,GACtC,KAAK,GACL,IAAI,GACJ,IAAI,CAAC;AAET,MAAM,MAAM,cAAc,CACxB,KAAK,SAAS,eAAe,EAC7B,KAAK,IACH,YAAY,CACd,KAAK,EACL,sBAAsB,CAAC,KAAK,CAAC,SAAS,IAAI,GACxC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,GACjC,QAAQ,CAAC,KAAK,CAAC,CAClB,CAAC;AAEF,MAAM,MAAM,QAAQ,CAClB,KAAK,SAAS,eAAe,EAC7B,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,MAAM,KAAK,CAAC,QAAQ,CAAC,IACjC,YAAY,CACd,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,EACvB,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,WAAW,CAAC,EAClB,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACvC,KAAK,CAAC,SAAS,CAAC,CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,CACnB,KAAK,SAAS,eAAe,EAC7B,KAAK,SAAS,MAAM,EACpB,KAAK,IACH,YAAY,CACd,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,QAAQ,CAAC,EACf,KAAK,CAAC,WAAW,CAAC,EAClB,KAAK,CAAC,SAAS,CAAC,EAChB,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CACxC,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAC5B,KAAK,SAAS,eAAe,EAC7B,KAAK,SAAS,MAAM,IAClB,KAAK,SAAS,MAAM,KAAK,CAAC,QAAQ,CAAC,GACnC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GACtB,KAAK,SAAS,MAAM,KAAK,CAAC,SAAS,CAAC,GACpC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GACxC,KAAK,CAAC"}

package/dist/core/types/builder-state.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,33 @@
+import type { SqlExpression, AliasedExpression } from '../utils/sql-expressions.js';
+import type { ColumnType, InferColumnType } from '../../types/schema.js';
+import type { AnyBuilderState, BaseRow, ResolveTableSchema } from './builder-state.js';
+import { Simplify, UnionToIntersection } from './type-helpers.js';
+type TableIdentifiers<State extends AnyBuilderState> = State['tables'] & string;
+type QualifiedColumnsFor<State extends AnyBuilderState, Table extends string> = ResolveTableSchema<State, Table> extends Record<string, ColumnType> ? `${Table}.${Extract<keyof ResolveTableSchema<State, Table>, string>}` : never;
+export type QualifiedColumnKeys<State extends AnyBuilderState> = {
+    [Table in TableIdentifiers<State>]: QualifiedColumnsFor<State, Table>;
+}[TableIdentifiers<State>];
+export type BaseColumnKeys<State extends AnyBuilderState> = keyof BaseRow<State>;
+export type OutputColumnKeys<State extends AnyBuilderState> = keyof State['output'];
+export type ScalarColumnKeys<State extends AnyBuilderState> = keyof State['scalars'];
+export type SelectableColumn<State extends AnyBuilderState> = OutputColumnKeys<State> | ScalarColumnKeys<State> | BaseColumnKeys<State> | QualifiedColumnKeys<State>;
+type StringSelectableColumn<State extends AnyBuilderState> = Extract<SelectableColumn<State>, string>;
+type AsKeyword = 'as' | 'AS' | 'As' | 'aS';
+type AliasedColumnString<State extends AnyBuilderState> = `${StringSelectableColumn<State>} ${AsKeyword} ${string}`;
+export type SelectableItem<State extends AnyBuilderState> = SelectableColumn<State> | AliasedColumnString<State> | SqlExpression;
+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 ColumnSelectionRecord<State extends AnyBuilderState, K> = {
+    [P in Extract<K, SelectableColumn<State>> as ColumnSelectionKey<P>]: ColumnSelectionValue<State, P>;
+};
+type ParsedAliasedColumn<State extends AnyBuilderState, Entry extends string> = Entry extends `${infer Column} ${infer Keyword} ${infer Alias}` ? Lowercase<Keyword> extends 'as' ? Column extends StringSelectableColumn<State> ? {
+    [P in Alias]: ColumnSelectionValue<State, Column>;
+} : {} : {} : {};
+type AliasedColumnSelectionRecord<State extends AnyBuilderState, K> = [Extract<K, string>] extends [never] ? {} : UnionToIntersection<ParsedAliasedColumn<State, Extract<K, string>>>;
+export type ExpressionSelectionRecord<K> = UnionToIntersection<K extends AliasedExpression<infer R, infer A> ? {
+    [P in A]: R;
+} : {}>;
+export type SelectionResult<State extends AnyBuilderState, K> = Simplify<ColumnSelectionRecord<State, K> & ExpressionSelectionRecord<K> & AliasedColumnSelectionRecord<State, K>>;
+export {};
+//# sourceMappingURL=select-types.d.ts.map

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

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

package/dist/core/types/select-types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/types/type-helpers.d.ts

@@ -0,0 +1,5 @@
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+export type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+//# sourceMappingURL=type-helpers.d.ts.map

package/dist/core/types/type-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/types/type-helpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC/B,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC;AAEpF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC"}

package/dist/core/types/type-helpers.js

@@ -0,0 +1 @@
+export {};

package/dist/core/utils/logger.d.ts

@@ -0,0 +1,43 @@
+import type { CacheStatus } from '../cache/types.js';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface QueryLog {
+    query: string;
+    parameters?: any[];
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    status: 'started' | 'completed' | 'error';
+    error?: Error;
+    rowCount?: number;
+    queryId?: string;
+    cacheStatus?: CacheStatus;
+    cacheKey?: string;
+    cacheMode?: string;
+    cacheAgeMs?: number;
+    cacheRowCount?: number;
+}
+export interface LoggerOptions {
+    level?: LogLevel;
+    enabled?: boolean;
+    onQueryLog?: (log: QueryLog) => void;
+}
+declare class Logger {
+    private static instance;
+    private level;
+    private enabled;
+    private onQueryLog?;
+    private querySubscribers;
+    private constructor();
+    static getInstance(): Logger;
+    configure(options: LoggerOptions): void;
+    subscribeToQuery(queryId: string, callback: (log: QueryLog) => void): () => void;
+    private shouldLog;
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    logQuery(log: QueryLog): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;CACtC;AAED,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;IAChC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAC,CAA0B;IAC7C,OAAO,CAAC,gBAAgB,CAAuD;IAE/E,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAMvC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAoBhF,OAAO,CAAC,SAAS;IAMjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;CAwC9B;AAED,eAAO,MAAM,MAAM,QAAuB,CAAC"}

package/dist/core/utils/logger.js

@@ -0,0 +1,104 @@
+class Logger {
+    static instance;
+    level = 'info';
+    enabled = true;
+    onQueryLog;
+    querySubscribers = new Map();
+    constructor() { }
+    static getInstance() {
+        if (!Logger.instance) {
+            Logger.instance = new Logger();
+        }
+        return Logger.instance;
+    }
+    configure(options) {
+        if (options.level)
+            this.level = options.level;
+        if (options.enabled !== undefined)
+            this.enabled = options.enabled;
+        if (options.onQueryLog)
+            this.onQueryLog = options.onQueryLog;
+    }
+    subscribeToQuery(queryId, callback) {
+        if (!this.querySubscribers.has(queryId)) {
+            this.querySubscribers.set(queryId, []);
+        }
+        this.querySubscribers.get(queryId).push(callback);
+        return () => {
+            const subscribers = this.querySubscribers.get(queryId);
+            if (subscribers) {
+                const index = subscribers.indexOf(callback);
+                if (index > -1) {
+                    subscribers.splice(index, 1);
+                }
+                if (subscribers.length === 0) {
+                    this.querySubscribers.delete(queryId);
+                }
+            }
+        };
+    }
+    shouldLog(level) {
+        if (!this.enabled)
+            return false;
+        const levels = ['debug', 'info', 'warn', 'error'];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    debug(message, ...args) {
+        if (this.shouldLog('debug')) {
+            console.debug(`[hypequery Debug] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.shouldLog('info')) {
+            console.info(`[hypequery Info] ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.shouldLog('warn')) {
+            console.warn(`[hypequery Warn] ${message}`, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.shouldLog('error')) {
+            console.error(`[hypequery Error] ${message}`, ...args);
+        }
+    }
+    logQuery(log) {
+        if (!this.enabled)
+            return;
+        if (this.onQueryLog) {
+            this.onQueryLog(log);
+        }
+        if (log.queryId) {
+            const subscribers = this.querySubscribers.get(log.queryId);
+            if (subscribers) {
+                subscribers.forEach(callback => callback(log));
+            }
+        }
+        const { query, parameters, duration, status, error, rowCount, cacheStatus, cacheKey, cacheMode, cacheAgeMs, cacheRowCount } = log;
+        const message = `Query ${status}: ${query}`;
+        const details = {
+            parameters,
+            duration: duration ? `${duration}ms` : undefined,
+            rowCount,
+            error: error?.message,
+            cacheStatus,
+            cacheKey,
+            cacheMode,
+            cacheAgeMs,
+            cacheRowCount
+        };
+        switch (status) {
+            case 'started':
+                this.debug(message, details);
+                break;
+            case 'completed':
+                this.info(message, details);
+                break;
+            case 'error':
+                this.error(message, details);
+                break;
+        }
+    }
+}
+export const logger = Logger.getInstance();

package/dist/core/utils/predicate-builder.d.ts

@@ -0,0 +1,33 @@
+import type { AnyBuilderState, BaseRow } from '../types/builder-state.js';
+import type { SelectableColumn } from '../types/select-types.js';
+export type PredicatePrimitive = string | number | boolean | Date | null;
+type PredicateValue = Exclude<PredicatePrimitive, string>;
+export interface PredicateExpression<T = unknown> {
+    __type: 'predicate_expression';
+    sql: string;
+    parameters: any[];
+    readonly expressionType?: T | undefined;
+}
+export interface PredicateLiteral<T = PredicatePrimitive> {
+    __type: 'predicate_literal';
+    value: T;
+}
+export type ColumnReference<State extends AnyBuilderState> = keyof BaseRow<State> | keyof State['output'] | Extract<SelectableColumn<State>, string>;
+export type PredicateArg<State extends AnyBuilderState> = ColumnReference<State> | PredicateExpression | PredicateLiteral | PredicateValue | PredicatePrimitive[];
+export interface ClickHousePredicateBuilder<State extends AnyBuilderState> {
+    dictGet<T = unknown>(dictionary: string, attribute: string, key: PredicateArg<State>): PredicateExpression<T>;
+}
+export interface PredicateBuilder<State extends AnyBuilderState> {
+    fn<T = unknown>(name: string, ...args: Array<PredicateArg<State>>): PredicateExpression<T>;
+    col(column: ColumnReference<State>): PredicateExpression;
+    value<T extends PredicatePrimitive>(value: T): PredicateLiteral<T>;
+    literal<T extends PredicatePrimitive>(value: T): PredicateLiteral<T>;
+    array(values: Array<PredicatePrimitive | PredicateLiteral>): PredicateExpression;
+    raw(sql: string): PredicateExpression;
+    and(expressions: PredicateExpression[]): PredicateExpression<boolean>;
+    or(expressions: PredicateExpression[]): PredicateExpression<boolean>;
+    ch: ClickHousePredicateBuilder<State>;
+}
+export declare function createPredicateBuilder<State extends AnyBuilderState>(): PredicateBuilder<State>;
+export {};
+//# sourceMappingURL=predicate-builder.d.ts.map

package/dist/core/utils/predicate-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-builder.d.ts","sourceRoot":"","sources":["../../../src/core/utils/predicate-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AACzE,KAAK,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC9C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,kBAAkB;IACtD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,MAAM,eAAe,CAAC,KAAK,SAAS,eAAe,IACrD,MAAM,OAAO,CAAC,KAAK,CAAC,GACpB,MAAM,KAAK,CAAC,QAAQ,CAAC,GACrB,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAE7C,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,eAAe,IAClD,eAAe,CAAC,KAAK,CAAC,GACtB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,kBAAkB,EAAE,CAAC;AAEzB,MAAM,WAAW,0BAA0B,CAAC,KAAK,SAAS,eAAe;IACvE,OAAO,CAAC,CAAC,GAAG,OAAO,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,GACvB,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,eAAe;IAC7D,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC3F,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,GAAG,mBAAmB,CAAC;IACzD,KAAK,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC,SAAS,kBAAkB,EAAE,KAAK,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,kBAAkB,GAAG,gBAAgB,CAAC,GAAG,mBAAmB,CAAC;IACjF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACtC,GAAG,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtE,EAAE,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACrE,EAAE,EAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC;CACvC;AA4GD,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,eAAe,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAgB/F"}

package/dist/core/utils/predicate-builder.js

@@ -0,0 +1,95 @@
+function createExpression(sql, parameters = []) {
+    return {
+        __type: 'predicate_expression',
+        sql,
+        parameters,
+        expressionType: undefined
+    };
+}
+function literal(value) {
+    return {
+        __type: 'predicate_literal',
+        value
+    };
+}
+function isPredicateExpression(value) {
+    return value?.__type === 'predicate_expression';
+}
+function isPredicateLiteral(value) {
+    return value?.__type === 'predicate_literal';
+}
+function buildArrayLiteral(values) {
+    const parts = [];
+    const parameters = [];
+    values.forEach(value => {
+        const normalized = normalizeLiteralValue(value);
+        parts.push(normalized.sql);
+        parameters.push(...normalized.parameters);
+    });
+    return createExpression(`[${parts.join(', ')}]`, parameters);
+}
+function normalizeLiteralValue(value) {
+    if (isPredicateLiteral(value)) {
+        return createExpression('?', [value.value]);
+    }
+    if (value === null) {
+        return createExpression('NULL');
+    }
+    if (value instanceof Date || typeof value === 'number' || typeof value === 'boolean' || typeof value === 'string') {
+        return createExpression('?', [value]);
+    }
+    throw new Error('Unsupported literal value in predicate array');
+}
+function normalizeArgument(arg) {
+    if (isPredicateExpression(arg)) {
+        return arg;
+    }
+    if (isPredicateLiteral(arg)) {
+        return createExpression('?', [arg.value]);
+    }
+    if (Array.isArray(arg)) {
+        return buildArrayLiteral(arg);
+    }
+    if (arg === null) {
+        return createExpression('NULL');
+    }
+    if (arg instanceof Date || typeof arg === 'number' || typeof arg === 'boolean') {
+        return createExpression('?', [arg]);
+    }
+    if (typeof arg === 'string') {
+        return createExpression(arg);
+    }
+    throw new Error('Unsupported predicate argument type');
+}
+function buildFunctionExpression(name, args) {
+    const builtArgs = args.map(arg => normalizeArgument(arg));
+    const sql = `${name}(${builtArgs.map(arg => arg.sql).join(', ')})`;
+    const parameters = builtArgs.flatMap(arg => arg.parameters);
+    return createExpression(sql, parameters);
+}
+function buildLogical(operator, expressions) {
+    if (!expressions.length) {
+        throw new Error(`${operator} requires at least one expression`);
+    }
+    if (expressions.length === 1) {
+        return expressions[0];
+    }
+    const sql = expressions.map(expr => `(${expr.sql})`).join(` ${operator} `);
+    const parameters = expressions.flatMap(expr => expr.parameters);
+    return createExpression(sql, parameters);
+}
+export function createPredicateBuilder() {
+    return {
+        fn: (name, ...args) => buildFunctionExpression(name, args),
+        col: column => createExpression(String(column)),
+        value: value => literal(value),
+        literal: value => literal(value),
+        array: values => buildArrayLiteral(values),
+        raw: sql => createExpression(sql),
+        and: expressions => buildLogical('AND', expressions),
+        or: expressions => buildLogical('OR', expressions),
+        ch: {
+            dictGet: (dictionary, attribute, key) => buildFunctionExpression('dictGet', [literal(dictionary), literal(attribute), key])
+        }
+    };
+}

package/dist/core/utils/sql-expressions.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Represents a raw SQL expression that can be used in queries
+ */
+export interface SqlExpression<T = unknown> {
+    __type: 'expression' | 'aliased_expression';
+    toSql(): string;
+    readonly expressionType?: T | undefined;
+}
+/**
+ * Represents an aliased SQL expression that can be used in select clauses
+ */
+export interface AliasedExpression<T = unknown, Alias extends string = string> extends SqlExpression<T> {
+    __type: 'aliased_expression';
+    alias: Alias;
+}
+/**
+ * Creates a raw SQL expression
+ * @param sql The SQL expression string
+ * @returns A SqlExpression object
+ */
+export declare function raw<T = unknown>(sql: string): SqlExpression<T>;
+export declare function selectExpr<T = unknown>(sql: string): SqlExpression<T>;
+export declare function selectExpr<T = unknown, Alias extends string = string>(sql: string, alias: Alias): AliasedExpression<T, Alias>;
+/**
+ * Creates an aliased SQL expression for use in SELECT clauses
+ * @param sql The SQL expression string
+ * @param alias The alias to use for the expression
+ * @returns An AliasedExpression object
+ */
+export declare function rawAs<T = unknown, Alias extends string = string>(sql: string, alias: Alias): AliasedExpression<T, Alias>;
+/**
+ * Converts a value to DateTime format
+ * @param field The field or expression to convert
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function toDateTime(field: string): SqlExpression<Date>;
+export declare function toDateTime<T extends string>(field: string, alias: T): AliasedExpression<Date, T>;
+export interface FormatDateTimeOptions {
+    timezone?: string;
+    alias?: string;
+}
+type FormatDateTimeAliasOptions<Alias extends string> = FormatDateTimeOptions & {
+    alias: Alias;
+};
+type FormatDateTimeNoAliasOptions = Omit<FormatDateTimeOptions, 'alias'> & {
+    alias?: undefined;
+};
+/**
+ * Formats a DateTime value using the specified format
+ * @param field The field or expression to format
+ * @param format The date format string
+ * @param options Optional configuration including timezone and alias
+ * @returns SQL expression or aliased expression
+ */
+export declare function formatDateTime(field: string, format: string, options?: FormatDateTimeNoAliasOptions): SqlExpression<string>;
+export declare function formatDateTime<T extends string>(field: string, format: string, options: FormatDateTimeAliasOptions<T>): AliasedExpression<string, T>;
+/**
+ * Truncates a date/time value to the start of the specified interval
+ * @param field The field to truncate
+ * @param interval The interval (e.g., '1 day', '15 minute')
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function toStartOfInterval(field: string, interval: string): SqlExpression<Date>;
+export declare function toStartOfInterval<T extends string>(field: string, interval: string, alias: T): AliasedExpression<Date, T>;
+/**
+ * Extracts the specified part from a date/time value
+ * @param part The part to extract (year, month, day, etc.)
+ * @param field The field to extract from
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function datePart(part: 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second', field: string): SqlExpression<number>;
+export declare function datePart<T extends string>(part: 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second', field: string, alias: T): AliasedExpression<number, T>;
+export {};
+//# sourceMappingURL=sql-expressions.d.ts.map

package/dist/core/utils/sql-expressions.d.ts.map

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

package/dist/core/utils/sql-expressions.js

@@ -0,0 +1,54 @@
+/**
+ * Creates a raw SQL expression
+ * @param sql The SQL expression string
+ * @returns A SqlExpression object
+ */
+export function raw(sql) {
+    return {
+        __type: 'expression',
+        toSql: () => sql,
+        expressionType: undefined
+    };
+}
+export function selectExpr(sql, alias) {
+    return alias ? rawAs(sql, alias) : raw(sql);
+}
+/**
+ * Creates an aliased SQL expression for use in SELECT clauses
+ * @param sql The SQL expression string
+ * @param alias The alias to use for the expression
+ * @returns An AliasedExpression object
+ */
+export function rawAs(sql, alias) {
+    return {
+        __type: 'aliased_expression',
+        alias,
+        toSql: () => `${sql} AS ${alias}`,
+        expressionType: undefined
+    };
+}
+export function toDateTime(field, alias) {
+    return alias
+        ? rawAs(`toDateTime(${field})`, alias)
+        : raw(`toDateTime(${field})`);
+}
+export function formatDateTime(field, format, options = {}) {
+    const { timezone, alias } = options;
+    let sql = `formatDateTime(${field}, '${format}'`;
+    if (timezone) {
+        sql += `, '${timezone}'`;
+    }
+    sql += ')';
+    return alias ? rawAs(sql, alias) : raw(sql);
+}
+export function toStartOfInterval(field, interval, alias) {
+    return alias
+        ? rawAs(`toStartOfInterval(${field}, INTERVAL ${interval})`, alias)
+        : raw(`toStartOfInterval(${field}, INTERVAL ${interval})`);
+}
+export function datePart(part, field, alias) {
+    const functionName = `to${part.charAt(0).toUpperCase() + part.slice(1)}`;
+    return alias
+        ? rawAs(`${functionName}(${field})`, alias)
+        : raw(`${functionName}(${field})`);
+}

package/dist/core/utils/streaming-helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function createJsonEachRowStream<T>(stream: NodeJS.ReadableStream | ReadableStream<T[]>): ReadableStream<T[]>;
+//# sourceMappingURL=streaming-helpers.d.ts.map

package/dist/core/utils/streaming-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/streaming-helpers.ts"],"names":[],"mappings":"AAoIA,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAwCnH"}