@jantokic/chtype 0.1.0

package/dist/codegen/generator.js

@@ -0,0 +1,95 @@
+/**
+ * TypeScript code generator.
+ *
+ * Takes introspected table metadata and generates:
+ * - Per-table Row interfaces (for SELECT results)
+ * - Per-table Insert interfaces (DEFAULT fields optional, MATERIALIZED/ALIAS excluded)
+ * - A Database registry type mapping table names to their types + engine metadata
+ */
+import { mapClickHouseType } from './type-mapper.js';
+/** Valid JS identifier pattern — names that don't match need quoting. */
+const VALID_IDENTIFIER = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
+/** Quote a property name if it's not a valid JS identifier. */
+function quoteProperty(name) {
+    return VALID_IDENTIFIER.test(name) ? name : `"${name}"`;
+}
+/** Convert snake_case to PascalCase, preserving casing within segments. */
+function snakeToPascal(s) {
+    return s
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+function rowName(tableName) {
+    return `${snakeToPascal(tableName)}Row`;
+}
+function insertName(tableName) {
+    return `${snakeToPascal(tableName)}Insert`;
+}
+function jsdoc(lines) {
+    if (lines.length === 0)
+        return '';
+    if (lines.length === 1)
+        return `/** ${lines[0]} */\n`;
+    return `/**\n${lines.map((l) => ` * ${l}`).join('\n')}\n */\n`;
+}
+function generateRowInterface(table, options) {
+    const docLines = [
+        `Table: \`${table.name}\``,
+        `Engine: ${table.engineFull || table.engine}`,
+    ];
+    if (table.sortingKey)
+        docLines.push(`ORDER BY: (${table.sortingKey})`);
+    if (table.partitionKey)
+        docLines.push(`PARTITION BY: ${table.partitionKey}`);
+    if (table.versionColumn)
+        docLines.push(`Version column: ${table.versionColumn}`);
+    if (table.comment)
+        docLines.push('', table.comment);
+    const fields = table.columns.map((col) => {
+        const tsType = mapClickHouseType(col.type, options);
+        const comment = col.comment ? `  /** ${col.comment} */\n` : '';
+        return `${comment}  ${quoteProperty(col.name)}: ${tsType};`;
+    });
+    return `${jsdoc(docLines)}export interface ${rowName(table.name)} {\n${fields.join('\n')}\n}`;
+}
+function generateInsertInterface(table, options) {
+    const insertableColumns = table.columns.filter((col) => col.defaultKind !== 'MATERIALIZED' && col.defaultKind !== 'ALIAS');
+    if (insertableColumns.length === 0)
+        return '';
+    const fields = insertableColumns.map((col) => {
+        const tsType = mapClickHouseType(col.type, options);
+        const optional = col.defaultKind === 'DEFAULT' ? '?' : '';
+        const comment = col.comment ? `  /** ${col.comment} */\n` : '';
+        return `${comment}  ${quoteProperty(col.name)}${optional}: ${tsType};`;
+    });
+    return `/** Insert type for \`${table.name}\` — DEFAULT columns are optional, MATERIALIZED/ALIAS columns excluded. */\nexport interface ${insertName(table.name)} {\n${fields.join('\n')}\n}`;
+}
+function generateDatabaseType(tables) {
+    const entries = tables.map((table) => {
+        const engineLiteral = JSON.stringify(table.engine);
+        const versionLiteral = table.versionColumn ? JSON.stringify(table.versionColumn) : 'null';
+        return `  ${quoteProperty(table.name)}: {\n    row: ${rowName(table.name)};\n    insert: ${insertName(table.name)};\n    engine: ${engineLiteral};\n    versionColumn: ${versionLiteral};\n  };`;
+    });
+    return `/** Database registry — maps table names to their Row/Insert types and engine metadata. */\nexport interface Database {\n${entries.join('\n')}\n}`;
+}
+export function generate(tables, options) {
+    const header = [
+        '// @generated by chtype',
+        `// Database: ${options.database}`,
+        `// Generated at: ${new Date().toISOString()}`,
+        '//',
+        '// Do not edit manually — regenerate with: npx chtype generate',
+        '',
+    ].join('\n');
+    const sections = [header];
+    for (const table of tables) {
+        sections.push(generateRowInterface(table, options));
+        const insertIface = generateInsertInterface(table, options);
+        if (insertIface)
+            sections.push(insertIface);
+    }
+    sections.push(generateDatabaseType(tables));
+    return `${sections.join('\n\n')}\n`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/codegen/generator.js.map

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

package/dist/codegen/index.d.ts

@@ -0,0 +1,5 @@
+export { defineConfig, type ChtypeConfig } from './config.js';
+export { generate, type GeneratorOptions } from './generator.js';
+export { introspect, parseVersionColumn, matchesPattern, filterTables, type IntrospectedColumn, type IntrospectedTable, type IntrospectOptions, } from './introspect.js';
+export { mapClickHouseType, type TypeMapperOptions } from './type-mapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/codegen/index.js

@@ -0,0 +1,5 @@
+export { defineConfig } from './config.js';
+export { generate } from './generator.js';
+export { introspect, parseVersionColumn, matchesPattern, filterTables, } from './introspect.js';
+export { mapClickHouseType } from './type-mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAyB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,GAIb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAA0B,MAAM,kBAAkB,CAAC"}

package/dist/codegen/introspect.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ClickHouse schema introspection.
+ *
+ * Queries system.tables and system.columns to build a complete picture
+ * of the database schema, including engine metadata and column flags.
+ */
+import type { ClickHouseClient } from '@clickhouse/client';
+export interface IntrospectedColumn {
+    name: string;
+    type: string;
+    defaultKind: 'DEFAULT' | 'MATERIALIZED' | 'ALIAS' | '';
+    defaultExpression: string;
+    comment: string;
+    isInSortingKey: boolean;
+    isInPrimaryKey: boolean;
+    isInPartitionKey: boolean;
+}
+export interface IntrospectedTable {
+    name: string;
+    engine: string;
+    engineFull: string;
+    versionColumn: string | null;
+    sortingKey: string;
+    partitionKey: string;
+    primaryKey: string;
+    comment: string;
+    columns: IntrospectedColumn[];
+}
+export interface IntrospectOptions {
+    include?: string[];
+    exclude?: string[];
+}
+interface SystemTableRow {
+    name: string;
+    engine: string;
+    engine_full: string;
+    sorting_key: string;
+    partition_key: string;
+    primary_key: string;
+    comment: string;
+}
+/**
+ * Introspect all tables in a ClickHouse database.
+ *
+ * Note: Fetches columns per-table (N+1 queries). This is fine for codegen
+ * (one-shot CLI tool) but may be slow for databases with 100+ tables.
+ */
+export declare function introspect(client: ClickHouseClient, database: string, options?: IntrospectOptions): Promise<IntrospectedTable[]>;
+/**
+ * Extract the version column from a ReplacingMergeTree engine_full string.
+ *
+ * Walks characters to find balanced parentheses instead of using a greedy regex,
+ * which handles edge cases like nested parens in replication paths.
+ */
+export declare function parseVersionColumn(engine: string, engineFull: string): string | null;
+/** Match table names against glob-like patterns (supports * wildcard). */
+export declare function matchesPattern(name: string, pattern: string): boolean;
+export declare function filterTables(tables: SystemTableRow[], include: string[], exclude: string[]): SystemTableRow[];
+export {};
+//# sourceMappingURL=introspect.d.ts.map

package/dist/codegen/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/codegen/introspect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,EAAE,CAAC;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyD9B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BpF;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,cAAc,EAAE,CAMlB"}

package/dist/codegen/introspect.js

@@ -0,0 +1,118 @@
+/**
+ * ClickHouse schema introspection.
+ *
+ * Queries system.tables and system.columns to build a complete picture
+ * of the database schema, including engine metadata and column flags.
+ */
+/**
+ * Introspect all tables in a ClickHouse database.
+ *
+ * Note: Fetches columns per-table (N+1 queries). This is fine for codegen
+ * (one-shot CLI tool) but may be slow for databases with 100+ tables.
+ */
+export async function introspect(client, database, options = {}) {
+    const tablesResult = await client.query({
+        query: `
+      SELECT name, engine, engine_full, sorting_key, partition_key, primary_key, comment
+      FROM system.tables
+      WHERE database = {database:String}
+        AND name NOT LIKE '.inner.%'
+        AND name NOT LIKE '.inner_id.%'
+      ORDER BY name
+    `,
+        query_params: { database },
+        format: 'JSONEachRow',
+    });
+    const tableRows = await tablesResult.json();
+    const filteredTables = filterTables(tableRows, options.include ?? [], options.exclude ?? []);
+    const tables = [];
+    for (const table of filteredTables) {
+        const columnsResult = await client.query({
+            query: `
+        SELECT name, type, default_kind, default_expression, comment,
+               is_in_sorting_key, is_in_primary_key, is_in_partition_key
+        FROM system.columns
+        WHERE database = {database:String} AND table = {table:String}
+        ORDER BY position
+      `,
+            query_params: { database, table: table.name },
+            format: 'JSONEachRow',
+        });
+        const columnRows = await columnsResult.json();
+        tables.push({
+            name: table.name,
+            engine: table.engine,
+            engineFull: table.engine_full,
+            versionColumn: parseVersionColumn(table.engine, table.engine_full),
+            sortingKey: table.sorting_key,
+            partitionKey: table.partition_key,
+            primaryKey: table.primary_key,
+            comment: table.comment,
+            columns: columnRows.map((col) => ({
+                name: col.name,
+                type: col.type,
+                defaultKind: (col.default_kind || ''),
+                defaultExpression: col.default_expression,
+                comment: col.comment,
+                isInSortingKey: col.is_in_sorting_key === 1,
+                isInPrimaryKey: col.is_in_primary_key === 1,
+                isInPartitionKey: col.is_in_partition_key === 1,
+            })),
+        });
+    }
+    return tables;
+}
+/**
+ * Extract the version column from a ReplacingMergeTree engine_full string.
+ *
+ * Walks characters to find balanced parentheses instead of using a greedy regex,
+ * which handles edge cases like nested parens in replication paths.
+ */
+export function parseVersionColumn(engine, engineFull) {
+    if (!engine.includes('ReplacingMergeTree'))
+        return null;
+    const idx = engineFull.indexOf('ReplacingMergeTree(');
+    if (idx === -1)
+        return null;
+    const start = engineFull.indexOf('(', idx);
+    if (start === -1)
+        return null;
+    // Walk to find matching closing paren
+    let depth = 1;
+    let end = start + 1;
+    while (end < engineFull.length && depth > 0) {
+        if (engineFull[end] === '(')
+            depth++;
+        else if (engineFull[end] === ')')
+            depth--;
+        end++;
+    }
+    if (depth !== 0)
+        return null;
+    const args = engineFull.slice(start + 1, end - 1);
+    if (!args.trim())
+        return null;
+    // The version column is the last argument that isn't a quoted string
+    const parts = args.split(',').map((s) => s.trim());
+    const lastArg = parts[parts.length - 1];
+    if (!lastArg)
+        return null;
+    if (lastArg.startsWith("'") || lastArg.startsWith('"'))
+        return null;
+    return lastArg;
+}
+/** Match table names against glob-like patterns (supports * wildcard). */
+export function matchesPattern(name, pattern) {
+    const regex = new RegExp(`^${pattern.replace(/\./g, '\\.').replace(/\*/g, '.*')}$`);
+    return regex.test(name);
+}
+export function filterTables(tables, include, exclude) {
+    return tables.filter((t) => {
+        if (include.length > 0 && !include.some((p) => matchesPattern(t.name, p)))
+            return false;
+        if (exclude.length > 0 && exclude.some((p) => matchesPattern(t.name, p)))
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=introspect.js.map

package/dist/codegen/introspect.js.map

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

package/dist/codegen/type-mapper.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Maps ClickHouse column types to TypeScript types.
+ *
+ * Handles all ClickHouse type constructors: Nullable, LowCardinality, Array, Map,
+ * Tuple, Enum, AggregateFunction, Decimal, DateTime64, FixedString, and all scalars.
+ */
+export interface TypeMapperOptions {
+    /** Map UInt64/Int64/UInt128/Int128/UInt256/Int256 to bigint instead of string */
+    bigints?: boolean;
+}
+export declare function mapClickHouseType(chType: string, options?: TypeMapperOptions): string;
+/** Find the index of the first top-level comma (not inside parentheses). */
+export declare function findTopLevelComma(s: string): number;
+/** Split a string by top-level commas (not inside parentheses). */
+export declare function splitTopLevel(s: string): string[];
+//# sourceMappingURL=type-mapper.d.ts.map

package/dist/codegen/type-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapper.d.ts","sourceRoot":"","sources":["../../src/codegen/type-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+BD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA2DzF;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAcjD"}

package/dist/codegen/type-mapper.js

@@ -0,0 +1,118 @@
+/**
+ * Maps ClickHouse column types to TypeScript types.
+ *
+ * Handles all ClickHouse type constructors: Nullable, LowCardinality, Array, Map,
+ * Tuple, Enum, AggregateFunction, Decimal, DateTime64, FixedString, and all scalars.
+ */
+const SCALAR_MAP = {
+    String: 'string',
+    UUID: 'string',
+    IPv4: 'string',
+    IPv6: 'string',
+    Date: 'string',
+    Date32: 'string',
+    DateTime: 'string',
+    Bool: 'boolean',
+    Boolean: 'boolean',
+    UInt8: 'number',
+    UInt16: 'number',
+    UInt32: 'number',
+    Int8: 'number',
+    Int16: 'number',
+    Int32: 'number',
+    Float32: 'number',
+    Float64: 'number',
+};
+const LARGE_INT_TYPES = new Set([
+    'UInt64',
+    'UInt128',
+    'UInt256',
+    'Int64',
+    'Int128',
+    'Int256',
+]);
+export function mapClickHouseType(chType, options = {}) {
+    const t = chType.replace(/\s+/g, ' ').trim();
+    const nullableMatch = t.match(/^Nullable\((.+)\)$/);
+    if (nullableMatch) {
+        return `${mapClickHouseType(nullableMatch[1], options)} | null`;
+    }
+    const lcMatch = t.match(/^LowCardinality\((.+)\)$/);
+    if (lcMatch) {
+        return mapClickHouseType(lcMatch[1], options);
+    }
+    const arrayMatch = t.match(/^Array\((.+)\)$/);
+    if (arrayMatch) {
+        const inner = mapClickHouseType(arrayMatch[1], options);
+        return inner.includes('|') ? `(${inner})[]` : `${inner}[]`;
+    }
+    const mapMatch = t.match(/^Map\((.+)\)$/);
+    if (mapMatch) {
+        const inner = mapMatch[1];
+        const commaIdx = findTopLevelComma(inner);
+        if (commaIdx !== -1) {
+            const keyType = mapClickHouseType(inner.slice(0, commaIdx).trim(), options);
+            const valType = mapClickHouseType(inner.slice(commaIdx + 1).trim(), options);
+            return `Record<${keyType}, ${valType}>`;
+        }
+    }
+    const tupleMatch = t.match(/^Tuple\((.+)\)$/);
+    if (tupleMatch) {
+        const inner = tupleMatch[1];
+        const parts = splitTopLevel(inner);
+        const mapped = parts.map((p) => {
+            const namedMatch = p.trim().match(/^\w+\s+(.+)$/);
+            return mapClickHouseType(namedMatch ? namedMatch[1] : p.trim(), options);
+        });
+        return `[${mapped.join(', ')}]`;
+    }
+    if (t.startsWith('Enum8(') || t.startsWith('Enum16(')) {
+        return 'string';
+    }
+    const aggMatch = t.match(/^(?:SimpleAggregateFunction|AggregateFunction)\(.+?,\s*(.+)\)$/);
+    if (aggMatch) {
+        return mapClickHouseType(aggMatch[1], options);
+    }
+    if (t.startsWith('Decimal'))
+        return 'string';
+    if (t.startsWith('DateTime64'))
+        return 'string';
+    if (t.startsWith('FixedString'))
+        return 'string';
+    if (LARGE_INT_TYPES.has(t)) {
+        return options.bigints ? 'bigint' : 'string';
+    }
+    return SCALAR_MAP[t] ?? 'unknown';
+}
+/** Find the index of the first top-level comma (not inside parentheses). */
+export function findTopLevelComma(s) {
+    let depth = 0;
+    for (let i = 0; i < s.length; i++) {
+        if (s[i] === '(')
+            depth++;
+        else if (s[i] === ')')
+            depth--;
+        else if (s[i] === ',' && depth === 0)
+            return i;
+    }
+    return -1;
+}
+/** Split a string by top-level commas (not inside parentheses). */
+export function splitTopLevel(s) {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let i = 0; i < s.length; i++) {
+        if (s[i] === '(')
+            depth++;
+        else if (s[i] === ')')
+            depth--;
+        else if (s[i] === ',' && depth === 0) {
+            parts.push(s.slice(start, i));
+            start = i + 1;
+        }
+    }
+    parts.push(s.slice(start));
+    return parts;
+}
+//# sourceMappingURL=type-mapper.js.map

package/dist/codegen/type-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapper.js","sourceRoot":"","sources":["../../src/codegen/type-mapper.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './codegen/index.js';
+export * from './query/index.js';
+export * from './client/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Re-export all submodules for convenience
+export * from './codegen/index.js';
+export * from './query/index.js';
+export * from './client/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/query/expressions.d.ts

@@ -0,0 +1,28 @@
+/** Represents a raw SQL expression with an optional alias. */
+export declare class Expression {
+    readonly sql: string;
+    readonly alias?: string | undefined;
+    constructor(sql: string, alias?: string | undefined);
+    as(alias: string): Expression;
+    toString(): string;
+}
+/** ClickHouse function builders. */
+export declare const fn: {
+    argMax(column: string, versionColumn: string): Expression;
+    argMin(column: string, versionColumn: string): Expression;
+    count(column?: string): Expression;
+    countDistinct(column: string): Expression;
+    sum(column: string): Expression;
+    avg(column: string): Expression;
+    min(column: string): Expression;
+    max(column: string): Expression;
+    groupArray(column: string): Expression;
+    arrayJoin(column: string): Expression;
+    uniq(column: string): Expression;
+    uniqExact(column: string): Expression;
+    toStartOfDay(column: string): Expression;
+    toStartOfHour(column: string): Expression;
+    /** Raw SQL expression — escape hatch for anything not covered. */
+    raw(sql: string): Expression;
+};
+//# sourceMappingURL=expressions.d.ts.map

package/dist/query/expressions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.d.ts","sourceRoot":"","sources":["../../src/query/expressions.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,qBAAa,UAAU;aAEH,GAAG,EAAE,MAAM;aACX,KAAK,CAAC,EAAE,MAAM;gBADd,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,YAAA;IAGhC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAI7B,QAAQ,IAAI,MAAM;CAGnB;AAED,oCAAoC;AACpC,eAAO,MAAM,EAAE;mBACE,MAAM,iBAAiB,MAAM,GAAG,UAAU;mBAG1C,MAAM,iBAAiB,MAAM,GAAG,UAAU;mBAG1C,MAAM,GAAG,UAAU;0BAGZ,MAAM,GAAG,UAAU;gBAG7B,MAAM,GAAG,UAAU;gBAGnB,MAAM,GAAG,UAAU;gBAGnB,MAAM,GAAG,UAAU;gBAGnB,MAAM,GAAG,UAAU;uBAGZ,MAAM,GAAG,UAAU;sBAGpB,MAAM,GAAG,UAAU;iBAGxB,MAAM,GAAG,UAAU;sBAGd,MAAM,GAAG,UAAU;yBAGhB,MAAM,GAAG,UAAU;0BAGlB,MAAM,GAAG,UAAU;IAGzC,kEAAkE;aACzD,MAAM,GAAG,UAAU;CAG7B,CAAC"}

package/dist/query/expressions.js

@@ -0,0 +1,65 @@
+/** Represents a raw SQL expression with an optional alias. */
+export class Expression {
+    sql;
+    alias;
+    constructor(sql, alias) {
+        this.sql = sql;
+        this.alias = alias;
+    }
+    as(alias) {
+        return new Expression(this.sql, alias);
+    }
+    toString() {
+        return this.alias ? `${this.sql} AS ${this.alias}` : this.sql;
+    }
+}
+/** ClickHouse function builders. */
+export const fn = {
+    argMax(column, versionColumn) {
+        return new Expression(`argMax(${column}, ${versionColumn})`);
+    },
+    argMin(column, versionColumn) {
+        return new Expression(`argMin(${column}, ${versionColumn})`);
+    },
+    count(column) {
+        return new Expression(column ? `count(${column})` : 'count()');
+    },
+    countDistinct(column) {
+        return new Expression(`count(DISTINCT ${column})`);
+    },
+    sum(column) {
+        return new Expression(`sum(${column})`);
+    },
+    avg(column) {
+        return new Expression(`avg(${column})`);
+    },
+    min(column) {
+        return new Expression(`min(${column})`);
+    },
+    max(column) {
+        return new Expression(`max(${column})`);
+    },
+    groupArray(column) {
+        return new Expression(`groupArray(${column})`);
+    },
+    arrayJoin(column) {
+        return new Expression(`arrayJoin(${column})`);
+    },
+    uniq(column) {
+        return new Expression(`uniq(${column})`);
+    },
+    uniqExact(column) {
+        return new Expression(`uniqExact(${column})`);
+    },
+    toStartOfDay(column) {
+        return new Expression(`toStartOfDay(${column})`);
+    },
+    toStartOfHour(column) {
+        return new Expression(`toStartOfHour(${column})`);
+    },
+    /** Raw SQL expression — escape hatch for anything not covered. */
+    raw(sql) {
+        return new Expression(sql);
+    },
+};
+//# sourceMappingURL=expressions.js.map

package/dist/query/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../src/query/expressions.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,OAAO,UAAU;IAEH;IACA;IAFlB,YACkB,GAAW,EACX,KAAc;QADd,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAS;IAC7B,CAAC;IAEJ,EAAE,CAAC,KAAa;QACd,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;IAChE,CAAC;CACF;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,MAAM,CAAC,MAAc,EAAE,aAAqB;QAC1C,OAAO,IAAI,UAAU,CAAC,UAAU,MAAM,KAAK,aAAa,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,CAAC,MAAc,EAAE,aAAqB;QAC1C,OAAO,IAAI,UAAU,CAAC,UAAU,MAAM,KAAK,aAAa,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,KAAK,CAAC,MAAe;QACnB,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;IACD,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,UAAU,CAAC,kBAAkB,MAAM,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,UAAU,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,UAAU,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,UAAU,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,UAAU,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,UAAU,CAAC,cAAc,MAAM,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,UAAU,CAAC,aAAa,MAAM,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,UAAU,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC;IAC3C,CAAC;IACD,SAAS,CAAC,MAAc;QACtB,OAAO,IAAI,UAAU,CAAC,aAAa,MAAM,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,YAAY,CAAC,MAAc;QACzB,OAAO,IAAI,UAAU,CAAC,gBAAgB,MAAM,GAAG,CAAC,CAAC;IACnD,CAAC;IACD,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,UAAU,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAC;IACpD,CAAC;IACD,kEAAkE;IAClE,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC"}

package/dist/query/index.d.ts

@@ -0,0 +1,7 @@
+export { createQueryBuilder, type QueryBuilder } from './query-builder.js';
+export { SelectBuilder } from './select-builder.js';
+export { InsertBuilder } from './insert-builder.js';
+export { Expression, fn } from './expressions.js';
+export { Param, param, type ClickHouseParamType } from './param.js';
+export type { DatabaseSchema, TableName, RowType, InsertType, ColumnName, CompiledQuery, SortDirection, ComparisonOp, SetOp, WhereOp, JoinType, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACpE,YAAY,EACV,cAAc,EACd,SAAS,EACT,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/query/index.js

@@ -0,0 +1,6 @@
+export { createQueryBuilder } from './query-builder.js';
+export { SelectBuilder } from './select-builder.js';
+export { InsertBuilder } from './insert-builder.js';
+export { Expression, fn } from './expressions.js';
+export { Param, param } from './param.js';
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAA4B,MAAM,YAAY,CAAC"}

package/dist/query/insert-builder.d.ts

@@ -0,0 +1,18 @@
+import type { CompiledQuery, DatabaseSchema, InsertType, TableName } from './types.js';
+export declare class InsertBuilder<DB extends DatabaseSchema, T extends TableName<DB> = TableName<DB>> {
+    private _table;
+    private _rows;
+    constructor(table: T);
+    values(rows: InsertType<DB, T>[]): this;
+    /**
+     * Compile the insert metadata.
+     *
+     * For bulk inserts, prefer using the client's `insert()` method
+     * which uses ClickHouse's native insert protocol.
+     */
+    compile(): CompiledQuery & {
+        table: string;
+        rows: InsertType<DB, T>[];
+    };
+}
+//# sourceMappingURL=insert-builder.d.ts.map

package/dist/query/insert-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-builder.d.ts","sourceRoot":"","sources":["../../src/query/insert-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvF,qBAAa,aAAa,CACxB,EAAE,SAAS,cAAc,EACzB,CAAC,SAAS,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;IAEvC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,KAAK,CAA2B;gBAE5B,KAAK,EAAE,CAAC;IAIpB,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI;IAKvC;;;;;OAKG;IACH,OAAO,IAAI,aAAa,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAA;KAAE;CAYxE"}