@hypequery/clickhouse 1.4.0-beta.2 → 1.4.0

package/dist/core/tests/integration/test-data.json

@@ -0,0 +1,190 @@
+{
+    "test_table": [
+        {
+            "id": 1,
+            "name": "Product A",
+            "category": "A",
+            "price": 10.5,
+            "created_at": "2023-01-01 10:00:00",
+            "is_active": true,
+            "tags": [
+                "new",
+                "sale"
+            ],
+            "attributes": {
+                "color": "red",
+                "size": "M"
+            },
+            "optional_note": "Popular item",
+            "sku": "A-100",
+            "delivery_dates": [
+                "2023-01-05",
+                "2023-01-10"
+            ]
+        },
+        {
+            "id": 2,
+            "name": "Product B",
+            "category": "B",
+            "price": 20.75,
+            "created_at": "2023-01-02 12:30:00",
+            "is_active": true,
+            "tags": [
+                "featured"
+            ],
+            "attributes": {
+                "color": "blue",
+                "size": "L"
+            },
+            "optional_note": null,
+            "sku": "B-200",
+            "delivery_dates": [
+                "2023-01-06"
+            ]
+        },
+        {
+            "id": 3,
+            "name": "Product C",
+            "category": "A",
+            "price": 15.0,
+            "created_at": "2023-01-03 09:45:00",
+            "is_active": false,
+            "tags": [],
+            "attributes": {
+                "color": "green",
+                "size": "S"
+            },
+            "optional_note": "Backordered",
+            "sku": "C-300",
+            "delivery_dates": []
+        },
+        {
+            "id": 4,
+            "name": "Product D",
+            "category": "C",
+            "price": 8.25,
+            "created_at": "2023-01-04 15:15:00",
+            "is_active": true,
+            "tags": [
+                "clearance"
+            ],
+            "attributes": {
+                "color": "yellow",
+                "size": "XL"
+            },
+            "optional_note": null,
+            "sku": "D-400",
+            "delivery_dates": [
+                "2023-01-08"
+            ]
+        },
+        {
+            "id": 5,
+            "name": "Product E",
+            "category": "B",
+            "price": 30.0,
+            "created_at": "2023-01-05 11:20:00",
+            "is_active": true,
+            "tags": [
+                "premium",
+                "gift"
+            ],
+            "attributes": {
+                "color": "black",
+                "size": "M"
+            },
+            "optional_note": "Limited stock",
+            "sku": "E-500",
+            "delivery_dates": [
+                "2023-01-07",
+                "2023-01-09"
+            ]
+        },
+        {
+            "id": 6,
+            "name": "Product F",
+            "category": "D",
+            "price": 12.5,
+            "created_at": "2023-01-06 14:40:00",
+            "is_active": false,
+            "tags": [],
+            "attributes": {
+                "color": "white",
+                "size": "M"
+            },
+            "optional_note": null,
+            "sku": "F-600",
+            "delivery_dates": []
+        }
+    ],
+    "users": [
+        {
+            "id": 1,
+            "user_name": "john_doe",
+            "email": "john@example.com",
+            "status": "active",
+            "created_at": "2023-01-01"
+        },
+        {
+            "id": 2,
+            "user_name": "jane_smith",
+            "email": "jane@example.com",
+            "status": "active",
+            "created_at": "2023-01-02"
+        },
+        {
+            "id": 3,
+            "user_name": "bob_jones",
+            "email": "bob@example.com",
+            "status": "inactive",
+            "created_at": "2023-01-03"
+        }
+    ],
+    "orders": [
+        {
+            "id": 1,
+            "user_id": 1,
+            "product_id": 1,
+            "quantity": 2,
+            "total": 21.0,
+            "status": "completed",
+            "created_at": "2023-01-10"
+        },
+        {
+            "id": 2,
+            "user_id": 1,
+            "product_id": 3,
+            "quantity": 1,
+            "total": 15.0,
+            "status": "completed",
+            "created_at": "2023-01-11"
+        },
+        {
+            "id": 3,
+            "user_id": 2,
+            "product_id": 2,
+            "quantity": 3,
+            "total": 62.25,
+            "status": "pending",
+            "created_at": "2023-01-12"
+        },
+        {
+            "id": 4,
+            "user_id": 2,
+            "product_id": 5,
+            "quantity": 1,
+            "total": 30.0,
+            "status": "completed",
+            "created_at": "2023-01-13"
+        },
+        {
+            "id": 5,
+            "user_id": 3,
+            "product_id": 4,
+            "quantity": 2,
+            "total": 16.5,
+            "status": "cancelled",
+            "created_at": "2023-01-14"
+        }
+    ]
+}

package/dist/core/tests/test-utils.d.ts

@@ -1,4 +1,5 @@
-import { QueryBuilder } from '../query-builder.js';
+import { SelectQB } from '../query-builder.js';
+import type { TableRecord } from '../../types/schema.js';
 export type TestTableSchema = {
     id: 'Int32';
     name: 'String';
@@ -12,18 +13,32 @@ export type TestTableSchema = {
     brand: 'String';
     total: 'Int32';
     priority: 'String';
+    is_premium: 'Bool';
+    metadata: 'Map(String, String)';
+    tags: 'Array(String)';
+    settings: 'Map(LowCardinality(String), String)';
+    optional_name: 'Nullable(String)';
+    categories: 'Array(LowCardinality(String))';
+    feature_flags: 'Array(Map(LowCardinality(String), String))';
+    optional_tags: 'Nullable(Array(String))';
+    permissions: 'Map(String, Array(String))';
+    created_timestamp: 'DateTime64(9)';
 };
 export type UsersSchema = {
     id: 'Int32';
     user_name: 'String';
     email: 'String';
     created_at: 'Date';
+    profile: 'Map(String, String)';
+    preferences: 'Nullable(Map(LowCardinality(String), String))';
+    roles: 'Array(LowCardinality(String))';
+    is_active: 'Bool';
 };
 export interface TestSchema {
     test_table: TestTableSchema;
     users: UsersSchema;
 }
 export declare const TEST_SCHEMAS: TestSchema;
-export declare function setupUsersBuilder(): QueryBuilder<TestSchema, TestSchema['users'], false, {}, TestSchema['users']>;
-export declare function setupTestBuilder(): QueryBuilder<TestSchema, TestSchema['test_table'], false, {}, TestSchema['test_table']>;
+export declare function setupUsersBuilder(): SelectQB<TestSchema, 'users', TableRecord<TestSchema['users']>, 'users'>;
+export declare function setupTestBuilder(): SelectQB<TestSchema, 'test_table', TableRecord<TestSchema['test_table']>, 'test_table'>;
 //# sourceMappingURL=test-utils.d.ts.map

package/dist/core/tests/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tests/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;CACpB;AAGD,eAAO,MAAM,YAAY,EAAE,UAqB1B,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CASjH;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAS1H"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/core/tests/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IAEnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,qCAAqC,CAAC;IAChD,aAAa,EAAE,kBAAkB,CAAC;IAClC,UAAU,EAAE,+BAA+B,CAAC;IAC5C,aAAa,EAAE,4CAA4C,CAAC;IAC5D,aAAa,EAAE,yBAAyB,CAAC;IACzC,WAAW,EAAE,4BAA4B,CAAC;IAC1C,iBAAiB,EAAE,eAAe,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,WAAW,EAAE,+CAA+C,CAAC;IAC7D,KAAK,EAAE,+BAA+B,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,UAmC1B,CAAC;AAoBF,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAU5G;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAU1H"}

package/dist/core/tests/test-utils.js

@@ -1,5 +1,5 @@
 import { QueryBuilder } from '../query-builder.js';
-// Test data
+import { buildRuntimeContext, resolveCacheConfig } from '../cache/runtime-context.js';
 export const TEST_SCHEMAS = {
     test_table: {
         id: 'Int32',
@@ -14,23 +14,50 @@ export const TEST_SCHEMAS = {
         brand: 'String',
         total: 'Int32',
         priority: 'String',
+        is_premium: 'Bool',
+        metadata: 'Map(String, String)',
+        tags: 'Array(String)',
+        settings: 'Map(LowCardinality(String), String)',
+        optional_name: 'Nullable(String)',
+        categories: 'Array(LowCardinality(String))',
+        feature_flags: 'Array(Map(LowCardinality(String), String))',
+        optional_tags: 'Nullable(Array(String))',
+        permissions: 'Map(String, Array(String))',
+        created_timestamp: 'DateTime64(9)',
     },
     users: {
         id: 'Int32',
         user_name: 'String',
         email: 'String',
-        created_at: 'Date'
+        created_at: 'Date',
+        profile: 'Map(String, String)',
+        preferences: 'Nullable(Map(LowCardinality(String), String))',
+        roles: 'Array(LowCardinality(String))',
+        is_active: 'Bool',
     }
 };
+function createTestRuntime() {
+    return buildRuntimeContext(resolveCacheConfig(undefined, 'tests'));
+}
 export function setupUsersBuilder() {
-    return new QueryBuilder('users', {
-        name: 'users',
-        columns: TEST_SCHEMAS.users
-    }, TEST_SCHEMAS);
+    const state = {
+        schema: TEST_SCHEMAS,
+        tables: 'users',
+        output: {},
+        baseTable: 'users',
+        base: TEST_SCHEMAS.users,
+        aliases: {}
+    };
+    return new QueryBuilder('users', state, createTestRuntime());
 }
 export function setupTestBuilder() {
-    return new QueryBuilder('test_table', {
-        name: 'test_table',
-        columns: TEST_SCHEMAS.test_table
-    }, TEST_SCHEMAS);
+    const state = {
+        schema: TEST_SCHEMAS,
+        tables: 'test_table',
+        output: {},
+        baseTable: 'test_table',
+        base: TEST_SCHEMAS.test_table,
+        aliases: {}
+    };
+    return new QueryBuilder('test_table', state, createTestRuntime());
 }

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

@@ -0,0 +1,25 @@
+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>> = {}> = {
+    schema: Schema;
+    tables: VisibleTables;
+    output: OutputRow;
+    baseTable: BaseTable;
+    base: Schema[BaseTable];
+    aliases: Aliases;
+};
+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']>;
+export type UpdateOutput<State extends AnyBuilderState, Output> = BuilderState<State['schema'], State['tables'], Output, State['baseTable'], State['aliases']>;
+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>>;
+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":"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"}

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

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

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

@@ -0,0 +1,32 @@
+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 SelectableColumn<State extends AnyBuilderState> = OutputColumnKeys<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 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

@@ -1,3 +1,4 @@
+import type { CacheStatus } from '../cache/types.js';
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 export interface QueryLog {
     query: string;
@@ -9,6 +10,11 @@ export interface QueryLog {
     error?: Error;
     rowCount?: number;
     queryId?: string;
+    cacheStatus?: CacheStatus;
+    cacheKey?: string;
+    cacheMode?: string;
+    cacheAgeMs?: number;
+    cacheRowCount?: number;
 }
 export interface LoggerOptions {
     level?: LogLevel;

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA,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;CAClB;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;CAmC9B;AAED,eAAO,MAAM,MAAM,QAAuB,CAAC"}
+{"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

@@ -75,13 +75,18 @@ class Logger {
                 subscribers.forEach(callback => callback(log));
             }
         }
-        const { query, parameters, duration, status, error, rowCount } = 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
+            error: error?.message,
+            cacheStatus,
+            cacheKey,
+            cacheMode,
+            cacheAgeMs,
+            cacheRowCount
         };
         switch (status) {
             case 'started':

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

@@ -0,0 +1,29 @@
+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 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>;
+}
+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,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;CACtE;AA4GD,wBAAgB,sBAAsB,CAAC,KAAK,SAAS,eAAe,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAY/F"}

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

@@ -0,0 +1,92 @@
+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)
+    };
+}