@querypanel/node-sdk 1.0.25 → 1.0.26

package/dist/esm/anonymize.spec.js.map

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

package/dist/esm/clickhouseClient.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clickhouseClient.spec.d.ts.map

package/dist/esm/clickhouseClient.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouseClient.spec.d.ts","sourceRoot":"","sources":["../../src/clickhouseClient.spec.ts"],"names":[],"mappings":""}

package/dist/esm/clickhouseClient.spec.js

@@ -0,0 +1,281 @@
+import duckdb from "duckdb";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { QueryPanelSdkAPI } from "./index.js";
+// @ts-expect-error
+globalThis.fetch = async (input, _init) => {
+    const url = String(input);
+    if (url.endsWith("/v2/active-charts")) {
+        return {
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({
+                data: [
+                    {
+                        id: "ac1",
+                        chart_id: "1",
+                        order: 1,
+                        meta: null,
+                        organization_id: null,
+                        tenant_id: null,
+                        user_id: null,
+                        created_at: null,
+                        updated_at: null,
+                    },
+                ],
+                pagination: {
+                    page: 1,
+                    limit: 10,
+                    total: 1,
+                    totalPages: 1,
+                    hasNext: false,
+                    hasPrev: false,
+                },
+            }),
+        };
+    }
+    if (/\/v2\/charts\/[^/]+$/.test(url)) {
+        return {
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({
+                id: "1",
+                title: "Single",
+                description: null,
+                sql: "SELECT id, value FROM demo ORDER BY id",
+                vega_lite_spec: { mark: "point" },
+                query_id: null,
+                organization_id: null,
+                tenant_id: null,
+                user_id: null,
+                created_at: null,
+                updated_at: null,
+            }),
+        };
+    }
+    if (url.endsWith("/v2/charts")) {
+        return {
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({
+                data: [
+                    {
+                        id: "1",
+                        title: "Demo",
+                        description: null,
+                        sql: "SELECT id, value FROM demo ORDER BY id",
+                        vega_lite_spec: { mark: "bar" },
+                        query_id: null,
+                        organization_id: null,
+                        tenant_id: null,
+                        user_id: null,
+                        created_at: null,
+                        updated_at: null,
+                    },
+                ],
+                pagination: {
+                    page: 1,
+                    limit: 10,
+                    total: 1,
+                    totalPages: 1,
+                    hasNext: false,
+                    hasPrev: false,
+                },
+            }),
+        };
+    }
+    if (url.endsWith("/v2/generate-sql")) {
+        return {
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({
+                sql: "SELECT id as x, value as y FROM demo ORDER BY id",
+                rationale: "ok",
+                context: [],
+            }),
+        };
+    }
+    if (url.endsWith("/v2/generate-chart")) {
+        return {
+            ok: true,
+            status: 200,
+            text: async () => JSON.stringify({ vegaLiteSpec: { mark: "line" }, notes: null }),
+        };
+    }
+    if (/\/v2\/active-charts\/[^/]+$/.test(url)) {
+        const id = url.split("/").pop();
+        if (id === "ac1") {
+            return {
+                ok: true,
+                status: 200,
+                text: async () => JSON.stringify({
+                    id: "ac1",
+                    chart_id: "1",
+                    order: 1,
+                    meta: null,
+                    organization_id: null,
+                    tenant_id: null,
+                    user_id: null,
+                    created_at: null,
+                    updated_at: null,
+                }),
+            };
+        }
+        if (id === "ac2") {
+            return {
+                ok: true,
+                status: 200,
+                text: async () => JSON.stringify({
+                    id: "ac2",
+                    chart_id: "1",
+                    order: 1,
+                    meta: null,
+                    organization_id: null,
+                    tenant_id: null,
+                    user_id: null,
+                    created_at: null,
+                    updated_at: null,
+                    chart: {
+                        id: "1",
+                        title: "Nested",
+                        description: null,
+                        sql: "SELECT id, value FROM demo ORDER BY id",
+                        vega_lite_spec: { mark: "square" },
+                        query_id: null,
+                        organization_id: null,
+                        tenant_id: null,
+                        user_id: null,
+                        created_at: null,
+                        updated_at: null,
+                    },
+                }),
+            };
+        }
+    }
+    // other endpoints not used in this test
+    return { ok: false, status: 404, text: async () => "" };
+};
+// Helper to create an in-memory DuckDB connection and run queries
+function createDuckDb() {
+    const db = new duckdb.Database(":memory:");
+    const conn = db.connect();
+    return { db, conn };
+}
+describe("attachClickhouseClient", () => {
+    let conn;
+    let clickhouseClientFn;
+    beforeAll(async () => {
+        ({ conn } = createDuckDb());
+        clickhouseClientFn = async ({ query }) => {
+            const rows = await new Promise((resolve, reject) => {
+                conn.all(query, (err, result) => {
+                    if (err)
+                        return reject(err);
+                    resolve(result);
+                });
+            });
+            const result = {
+                json: async () => rows,
+            };
+            return result;
+        };
+        await new Promise((resolve, reject) => {
+            conn.run("CREATE TABLE demo(id INTEGER, value VARCHAR)", (err) => {
+                if (err)
+                    return reject(err);
+                conn.run("INSERT INTO demo VALUES (1, 'a'), (2, 'b')", (err2) => {
+                    if (err2)
+                        return reject(err2);
+                    resolve();
+                });
+            });
+        });
+    });
+    afterAll(() => {
+        try {
+            conn.close();
+        }
+        catch { }
+    });
+    it("returns values from runDataOnCLient when listing charts", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const result = await sdk.listCharts({ tenantId: "t1" });
+        expect(result.data.length).toBe(1);
+        const chart = result.data[0];
+        expect(chart.vega_lite_spec?.data?.values).toEqual([
+            { id: 1, value: "a" },
+            { id: 2, value: "b" },
+        ]);
+    });
+    it("hydrates data when getting a single chart", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const chart = await sdk.getChart("1", { tenantId: "t1" });
+        expect(chart.id).toBe("1");
+        expect(chart.vega_lite_spec?.data?.values).toEqual([
+            { id: 1, value: "a" },
+            { id: 2, value: "b" },
+        ]);
+    });
+    it("lists active charts without data when withdata=false", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const result = await sdk.listActiveCharts({
+            tenantId: "t1",
+            withdata: false,
+        });
+        expect(result.data.length).toBe(1);
+        const firstNoData = result.data[0];
+        if (!firstNoData)
+            throw new Error("missing active chart");
+        expect(firstNoData.chart).toBeUndefined();
+    });
+    it("lists active charts with data when withdata=true", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const result = await sdk.listActiveCharts({
+            tenantId: "t1",
+            withdata: true,
+        });
+        expect(result.data.length).toBe(1);
+        const firstWithData = result.data[0];
+        if (!firstWithData || !firstWithData.chart)
+            throw new Error("missing hydrated active chart");
+        expect(Boolean(firstWithData.chart)).toBe(true);
+        expect(firstWithData.chart.vega_lite_spec?.data?.values).toEqual([
+            { id: 1, value: "a" },
+            { id: 2, value: "b" },
+        ]);
+    });
+    it("gets active chart without nested chart unchanged", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const ac = await sdk.getActiveChart("ac1", { tenantId: "t1" });
+        expect(ac.id).toBe("ac1");
+        expect("chart" in ac ? ac.chart : undefined).toBeUndefined();
+    });
+    it("gets active chart with nested chart hydrated", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const ac = await sdk.getActiveChart("ac2", { tenantId: "t1" });
+        if (!ac.chart)
+            throw new Error("expected nested chart");
+        expect(ac.chart.vega_lite_spec?.data?.values).toEqual([
+            { id: 1, value: "a" },
+            { id: 2, value: "b" },
+        ]);
+    });
+    it("works with ask() by executing SQL against DuckDB", async () => {
+        const sdk = new QueryPanelSdkAPI("http://api", "test-token");
+        sdk.attachClickhouseClient(clickhouseClientFn);
+        const result = await sdk.ask("q", { tenantId: "t1" });
+        expect(result.sql).toContain("SELECT id as x, value as y");
+        expect(result.fields).toEqual(["x", "y"]);
+        expect(result.rows).toEqual([
+            { x: 1, y: "a" },
+            { x: 2, y: "b" },
+        ]);
+        expect(result.chart.vegaLiteSpec).toMatchObject({ mark: "line" });
+    });
+});
+//# sourceMappingURL=clickhouseClient.spec.js.map

package/dist/esm/clickhouseClient.spec.js.map

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

package/dist/esm/connectors/base.d.ts

@@ -0,0 +1,14 @@
+import type { DataFormat } from '@clickhouse/client';
+import type { IntrospectOptions, SchemaIntrospection } from '../schema/types.js';
+export interface QueryOptions {
+    params?: Record<string, unknown>;
+    format?: DataFormat;
+    settings?: Record<string, unknown>;
+}
+export interface DatabaseConnector {
+    connect(): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, options?: QueryOptions): Promise<T[]>;
+    introspect(options?: IntrospectOptions): Promise<SchemaIntrospection>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/connectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/connectors/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACtF,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/esm/connectors/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/esm/connectors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/connectors/base.ts"],"names":[],"mappings":""}

package/dist/esm/connectors/clickhouse.d.ts

@@ -0,0 +1,35 @@
+import { type ClickHouseClient, type ClickHouseClientConfigOptions } from '@clickhouse/client';
+import type { IntrospectOptions, SchemaIntrospection } from '../schema/types.js';
+import type { DatabaseConnector, QueryOptions } from './base.js';
+export interface ClickHouseConnectorConfig {
+    /** Fully qualified ClickHouse URL. Overrides host/port/protocol when provided. */
+    url?: string;
+    host?: string;
+    port?: number;
+    protocol?: 'http' | 'https';
+    database: string;
+    username?: string;
+    password?: string;
+    application?: string;
+    clickhouseSettings?: Record<string, unknown>;
+    clientOptions?: Partial<ClickHouseClientConfigOptions>;
+}
+export interface ClickHouseConnectorOverrides {
+    client?: ClickHouseClient;
+    clientFactory?: () => ClickHouseClient;
+}
+export declare class ClickHouseConnector implements DatabaseConnector {
+    private readonly config;
+    private readonly overrides;
+    private client;
+    private readonly defaultFormat;
+    constructor(config: ClickHouseConnectorConfig, overrides?: ClickHouseConnectorOverrides);
+    connect(): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, options?: QueryOptions): Promise<T[]>;
+    introspect(options?: IntrospectOptions): Promise<SchemaIntrospection>;
+    close(): Promise<void>;
+    private ensureClient;
+    private safePing;
+    private buildClientConfig;
+}
+//# sourceMappingURL=clickhouse.d.ts.map

package/dist/esm/connectors/clickhouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../../src/connectors/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAGrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAA6B,MAAM,oBAAoB,CAAC;AAQ5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,WAAW,yBAAyB;IACtC,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,4BAA4B;IACzC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,gBAAgB,CAAC;CAC1C;AA4BD,qBAAa,mBAAoB,YAAW,iBAAiB;IAKrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL9B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqE;gBAG9E,MAAM,EAAE,yBAAyB,EACjC,SAAS,GAAE,4BAAiC;IAK3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAiCrF,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsGrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAMd,YAAY;YAYZ,QAAQ;IAUtB,OAAO,CAAC,iBAAiB;CAkC5B"}

package/dist/esm/connectors/clickhouse.js

@@ -0,0 +1,281 @@
+import { createClient, } from '@clickhouse/client';
+import { extractFixedStringLength, extractPrecisionScale, isNullableType, parseKeyExpression, unwrapTypeModifiers, } from '../utils/clickhouse.js';
+export class ClickHouseConnector {
+    constructor(config, overrides = {}) {
+        this.config = config;
+        this.overrides = overrides;
+        this.defaultFormat = 'JSONEachRow';
+        this.client = overrides.client ?? null;
+    }
+    async connect() {
+        await this.ensureClient();
+    }
+    async query(sql, options) {
+        const client = await this.ensureClient();
+        const params = {
+            query: sql,
+        };
+        const format = options?.format ?? this.defaultFormat;
+        if (format) {
+            Object.assign(params, { format });
+        }
+        if (options?.params) {
+            Object.assign(params, { query_params: options.params });
+        }
+        if (options?.settings) {
+            Object.assign(params, { clickhouse_settings: options.settings });
+        }
+        const result = await client.query(params);
+        const payload = await result.json();
+        if (Array.isArray(payload)) {
+            return payload;
+        }
+        if (payload && typeof payload === 'object') {
+            const maybeData = payload.data;
+            if (Array.isArray(maybeData)) {
+                return maybeData;
+            }
+        }
+        return [];
+    }
+    async introspect(options) {
+        const allowTables = normalizeTableFilter(options?.tables);
+        const hasFilter = allowTables.length > 0;
+        const queryParams = {
+            db: this.config.database,
+        };
+        if (hasFilter) {
+            queryParams.tables = allowTables;
+        }
+        const filterClause = hasFilter ? ' AND name IN {tables:Array(String)}' : '';
+        const tables = await this.query(`SELECT name, engine, comment, total_rows, total_bytes, is_view, primary_key, sorting_key
+             FROM system.tables
+             WHERE database = {db:String}${filterClause}
+             ORDER BY name`, { params: queryParams });
+        const columnFilterClause = hasFilter ? ' AND table IN {tables:Array(String)}' : '';
+        const columns = await this.query(`SELECT table, name, type, position, default_kind, default_expression, comment,
+                    codec_expression, ttl_expression, is_in_primary_key,
+                    data_compressed_bytes, data_uncompressed_bytes
+             FROM system.columns
+             WHERE database = {db:String}${columnFilterClause}
+             ORDER BY table, position`, { params: queryParams });
+        const columnsByTable = new Map();
+        for (const rawColumn of columns) {
+            const list = columnsByTable.get(rawColumn.table) ?? [];
+            list.push(transformColumnRow(rawColumn));
+            columnsByTable.set(rawColumn.table, list);
+        }
+        const tableSchemas = tables.map((table) => {
+            const tableColumns = columnsByTable.get(table.name) ?? [];
+            const primaryKeyColumns = parseKeyExpression(table.primary_key);
+            const totalRows = toNumber(table.total_rows);
+            const totalBytes = toNumber(table.total_bytes);
+            for (const column of tableColumns) {
+                column.isPrimaryKey = column.isPrimaryKey || primaryKeyColumns.includes(column.name);
+            }
+            const indexes = primaryKeyColumns.length
+                ? [
+                    {
+                        name: 'primary_key',
+                        columns: primaryKeyColumns,
+                        unique: true,
+                        type: 'PRIMARY KEY',
+                        ...(table.primary_key ? { definition: table.primary_key } : {}),
+                    },
+                ]
+                : [];
+            const constraints = primaryKeyColumns.length
+                ? [
+                    {
+                        name: 'primary_key',
+                        type: 'PRIMARY KEY',
+                        columns: primaryKeyColumns,
+                    },
+                ]
+                : [];
+            const base = {
+                name: table.name,
+                schema: this.config.database,
+                type: asTableType(table.is_view),
+                engine: table.engine,
+                columns: tableColumns,
+                indexes,
+                constraints,
+            };
+            const comment = sanitize(table.comment);
+            if (comment !== undefined) {
+                base.comment = comment;
+            }
+            const statistics = buildTableStatistics(totalRows, totalBytes);
+            if (statistics) {
+                base.statistics = statistics;
+            }
+            return base;
+        });
+        return {
+            db: {
+                kind: 'clickhouse',
+                name: this.config.database,
+            },
+            tables: tableSchemas,
+            introspectedAt: new Date().toISOString(),
+        };
+    }
+    async close() {
+        if (!this.client)
+            return;
+        await this.client.close();
+        this.client = null;
+    }
+    async ensureClient() {
+        if (this.client) {
+            return this.client;
+        }
+        this.client = this.overrides?.clientFactory?.() ?? createClient(this.buildClientConfig());
+        const pingResult = await this.safePing(this.client);
+        if (pingResult && 'success' in pingResult && pingResult.success === false) {
+            throw pingResult.error ?? new Error('ClickHouse ping failed');
+        }
+        return this.client;
+    }
+    async safePing(client) {
+        try {
+            return await client.ping();
+        }
+        catch (error) {
+            await client.close();
+            this.client = null;
+            throw error;
+        }
+    }
+    buildClientConfig() {
+        const merged = {
+            ...(this.config.clientOptions ?? {}),
+        };
+        if (this.config.url) {
+            merged.url = this.config.url;
+        }
+        else if (this.config.host) {
+            const protocol = this.config.protocol ?? 'https';
+            const port = this.config.port ?? (protocol === 'https' ? 8443 : 8123);
+            merged.url = `${protocol}://${this.config.host}:${port}`;
+        }
+        merged.database = this.config.database;
+        if (this.config.username) {
+            merged.username = this.config.username;
+        }
+        if (this.config.password) {
+            merged.password = this.config.password;
+        }
+        if (this.config.application) {
+            merged.application = this.config.application;
+        }
+        if (this.config.clickhouseSettings) {
+            merged.clickhouse_settings = {
+                ...(this.config.clientOptions?.clickhouse_settings ?? {}),
+                ...this.config.clickhouseSettings,
+            };
+        }
+        return merged;
+    }
+}
+function normalizeTableFilter(tables) {
+    if (!tables?.length)
+        return [];
+    const seen = new Set();
+    const normalized = [];
+    for (const table of tables) {
+        if (!table)
+            continue;
+        const trimmed = table.trim();
+        if (!trimmed)
+            continue;
+        const parts = trimmed.split('.');
+        const tableName = parts[parts.length - 1];
+        if (!tableName || seen.has(tableName))
+            continue;
+        seen.add(tableName);
+        normalized.push(tableName);
+    }
+    return normalized;
+}
+function transformColumnRow(row) {
+    const nullable = isNullableType(row.type);
+    const unwrappedType = unwrapTypeModifiers(row.type);
+    const { precision, scale } = extractPrecisionScale(row.type);
+    const maxLength = extractFixedStringLength(row.type);
+    const compressedBytes = toNumber(row.data_compressed_bytes);
+    const uncompressedBytes = toNumber(row.data_uncompressed_bytes);
+    const column = {
+        name: row.name,
+        type: unwrappedType,
+        nullable,
+        isPrimaryKey: Boolean(toNumber(row.is_in_primary_key)),
+        isForeignKey: false,
+    };
+    column.rawType = row.type;
+    const defaultKind = sanitize(row.default_kind);
+    if (defaultKind !== undefined)
+        column.defaultKind = defaultKind;
+    const defaultExpression = sanitize(row.default_expression);
+    if (defaultExpression !== undefined)
+        column.defaultExpression = defaultExpression;
+    const comment = sanitize(row.comment);
+    if (comment !== undefined)
+        column.comment = comment;
+    const codec = sanitize(row.codec_expression);
+    if (codec !== undefined)
+        column.codec = codec;
+    const ttlExpression = sanitize(row.ttl_expression);
+    if (ttlExpression !== undefined)
+        column.ttlExpression = ttlExpression;
+    if (maxLength !== undefined)
+        column.maxLength = maxLength;
+    if (precision !== undefined)
+        column.precision = precision;
+    if (scale !== undefined)
+        column.scale = scale;
+    if (compressedBytes !== undefined || uncompressedBytes !== undefined) {
+        column.statistics = {};
+        if (compressedBytes !== undefined)
+            column.statistics.compressedBytes = compressedBytes;
+        if (uncompressedBytes !== undefined)
+            column.statistics.uncompressedBytes = uncompressedBytes;
+    }
+    return column;
+}
+function toNumber(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'number')
+        return value;
+    const parsed = Number.parseFloat(String(value));
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function sanitize(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const trimmed = String(value).trim();
+    return trimmed.length ? trimmed : undefined;
+}
+function asTableType(isView) {
+    if (typeof isView === 'number') {
+        return isView > 0 ? 'view' : 'table';
+    }
+    if (typeof isView === 'string') {
+        const normalized = isView.toLowerCase();
+        return normalized === '1' || normalized === 'true' ? 'view' : 'table';
+    }
+    return 'table';
+}
+function buildTableStatistics(totalRows, totalBytes) {
+    if (totalRows === undefined && totalBytes === undefined)
+        return undefined;
+    const stats = {};
+    if (totalRows !== undefined)
+        stats.totalRows = totalRows;
+    if (totalBytes !== undefined)
+        stats.totalBytes = totalBytes;
+    return stats;
+}
+//# sourceMappingURL=clickhouse.js.map