@querypanel/node-sdk 1.0.25 → 1.0.26

package/dist/esm/adapters/clickhouse.js

@@ -0,0 +1,280 @@
+import { extractFixedStringLength, extractPrecisionScale, isNullableType, parseKeyExpression, unwrapTypeModifiers, } from "../utils/clickhouse.js";
+export class ClickHouseAdapter {
+    constructor(clientFn, options = {}) {
+        this.clientFn = clientFn;
+        console.log({ options });
+        this.databaseName = options.database ?? "default";
+        this.defaultFormat = options.defaultFormat ?? "JSONEachRow";
+        this.kind = options.kind ?? "clickhouse";
+        if (options.allowedTables) {
+            this.allowedTables = normalizeTableFilter(options.allowedTables);
+        }
+    }
+    async execute(sql, params) {
+        // Validate query against allowed tables if restrictions are in place
+        if (this.allowedTables) {
+            this.validateQueryTables(sql);
+        }
+        const queryOptions = {
+            format: this.defaultFormat,
+        };
+        if (params) {
+            queryOptions.params = params;
+        }
+        const rows = await this.query(sql, queryOptions);
+        const fields = rows.length > 0 ? Object.keys(rows[0] ?? {}) : [];
+        return { fields, rows };
+    }
+    async validate(sql, params) {
+        const queryOptions = {
+            format: this.defaultFormat,
+        };
+        if (params) {
+            queryOptions.params = params;
+        }
+        await this.query(`EXPLAIN ${sql}`, queryOptions);
+    }
+    getDialect() {
+        return "clickhouse";
+    }
+    async introspect(options) {
+        // Use adapter-level allowedTables if no specific tables provided in options
+        const tablesToIntrospect = options?.tables
+            ? normalizeTableFilter(options.tables)
+            : this.allowedTables;
+        const allowTables = tablesToIntrospect ?? [];
+        const hasFilter = allowTables.length > 0;
+        const queryParams = {
+            db: this.databaseName,
+        };
+        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, 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, is_in_primary_key
+       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.databaseName,
+                type: asTableType(table.engine),
+                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: this.kind,
+                name: this.databaseName,
+            },
+            tables: tableSchemas,
+            introspectedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Validate that the SQL query only references allowed tables.
+     * This is a basic validation that extracts table-like patterns from the query.
+     */
+    validateQueryTables(sql) {
+        if (!this.allowedTables || this.allowedTables.length === 0) {
+            return;
+        }
+        const allowedSet = new Set(this.allowedTables);
+        // Extract potential table references from SQL
+        // This regex looks for identifiers after FROM/JOIN keywords
+        // ClickHouse may use database.table notation
+        const tablePattern = /(?:FROM|JOIN)\s+(?:FINAL\s+)?(?:(?:[a-zA-Z_][a-zA-Z0-9_]*)\.)?(["'`]?[a-zA-Z_][a-zA-Z0-9_]*["'`]?)/gi;
+        const matches = sql.matchAll(tablePattern);
+        for (const match of matches) {
+            const table = match[1]?.replace(/["'`]/g, "");
+            if (table) {
+                if (!allowedSet.has(table)) {
+                    throw new Error(`Query references table "${table}" which is not in the allowed tables list`);
+                }
+            }
+        }
+    }
+    async close() {
+        // No-op: lifecycle of the underlying client is controlled by the caller.
+    }
+    async query(sql, options) {
+        const params = {
+            query: sql,
+        };
+        const format = options?.format ?? this.defaultFormat;
+        if (format !== undefined) {
+            params.format = format;
+        }
+        if (options?.params) {
+            params.query_params = options.params;
+        }
+        if (options?.settings) {
+            params.clickhouse_settings = options.settings;
+        }
+        const result = await this.clientFn(params);
+        return this.extractRows(result);
+    }
+    async extractRows(result) {
+        if (Array.isArray(result)) {
+            return result;
+        }
+        if (result &&
+            typeof result.json === "function") {
+            const payload = await result.json();
+            return normalizePayload(payload);
+        }
+        return [];
+    }
+}
+function normalizePayload(payload) {
+    if (Array.isArray(payload)) {
+        return payload;
+    }
+    if (payload && typeof payload === "object") {
+        const maybeData = payload.data;
+        if (Array.isArray(maybeData)) {
+            return maybeData;
+        }
+    }
+    return [];
+}
+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 column = {
+        name: row.name,
+        type: unwrappedType,
+        rawType: row.type,
+        nullable,
+        isPrimaryKey: Boolean(toNumber(row.is_in_primary_key)),
+        isForeignKey: false,
+    };
+    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;
+    if (maxLength !== undefined)
+        column.maxLength = maxLength;
+    if (precision !== undefined)
+        column.precision = precision;
+    if (scale !== undefined)
+        column.scale = scale;
+    return column;
+}
+function asTableType(engine) {
+    if (typeof engine === "string") {
+        const normalized = engine.toLowerCase();
+        // ClickHouse view engines: View, MaterializedView, LiveView
+        if (normalized.includes("view")) {
+            return "view";
+        }
+    }
+    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;
+}
+function sanitize(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    const trimmed = String(value).trim();
+    return trimmed.length ? trimmed : undefined;
+}
+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;
+}
+//# sourceMappingURL=clickhouse.js.map

package/dist/esm/adapters/clickhouse.js.map

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

package/dist/esm/adapters/introspection.spec.d.ts

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

package/dist/esm/adapters/introspection.spec.d.ts.map

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

package/dist/esm/adapters/introspection.spec.js

@@ -0,0 +1,190 @@
+import { describe, expect, it, vi } from "vitest";
+import { ClickHouseAdapter } from "./clickhouse.js";
+import { PostgresAdapter } from "./postgres.js";
+function createClickHouseResponse(rows) {
+    return {
+        json: async () => rows,
+    };
+}
+describe("Database adapter introspection", () => {
+    it("introspects ClickHouse tables", async () => {
+        const clientFn = vi.fn(async ({ query }) => {
+            if (query.includes("FROM system.tables")) {
+                return createClickHouseResponse([
+                    {
+                        name: "events",
+                        engine: "MergeTree",
+                        comment: "Main events table",
+                        total_rows: "1000",
+                        total_bytes: "2048",
+                        primary_key: "(id)",
+                        sorting_key: null,
+                    },
+                ]);
+            }
+            if (query.includes("FROM system.columns")) {
+                return createClickHouseResponse([
+                    {
+                        table: "events",
+                        name: "id",
+                        type: "UInt64",
+                        position: 1,
+                        default_kind: null,
+                        default_expression: null,
+                        comment: "Primary identifier",
+                        is_in_primary_key: "1",
+                    },
+                    {
+                        table: "events",
+                        name: "name",
+                        type: "Nullable(String)",
+                        position: 2,
+                        default_kind: null,
+                        default_expression: null,
+                        comment: null,
+                        is_in_primary_key: "0",
+                    },
+                ]);
+            }
+            return createClickHouseResponse([]);
+        });
+        const adapter = new ClickHouseAdapter(clientFn, {
+            database: "analytics",
+        });
+        const result = await adapter.introspect();
+        expect(result.db.name).toBe("analytics");
+        expect(result.tables).toHaveLength(1);
+        const table = result.tables[0];
+        if (!table)
+            throw new Error("missing table");
+        expect(table.columns.map((c) => c.name)).toEqual(["id", "name"]);
+        const idColumn = table.columns.find((c) => c.name === "id");
+        expect(idColumn?.isPrimaryKey).toBe(true);
+        expect(table.indexes[0]?.name).toBe("primary_key");
+    });
+    it("introspects Postgres tables", async () => {
+        const responses = new Map();
+        responses.set("tables", () => ({
+            rows: [
+                {
+                    table_name: "users",
+                    schema_name: "public",
+                    table_type: "BASE TABLE",
+                    comment: "application users",
+                    total_rows: 200,
+                    total_bytes: 4096,
+                },
+            ],
+            fields: [],
+        }));
+        responses.set("columns", () => ({
+            rows: [
+                {
+                    table_name: "users",
+                    table_schema: "public",
+                    column_name: "id",
+                    data_type: "integer",
+                    udt_name: "int4",
+                    is_nullable: "NO",
+                    column_default: "nextval('users_id_seq'::regclass)",
+                    character_maximum_length: null,
+                    numeric_precision: 32,
+                    numeric_scale: 0,
+                    ordinal_position: 1,
+                    description: "primary key",
+                },
+                {
+                    table_name: "users",
+                    table_schema: "public",
+                    column_name: "role_id",
+                    data_type: "integer",
+                    udt_name: "int4",
+                    is_nullable: "YES",
+                    column_default: null,
+                    character_maximum_length: null,
+                    numeric_precision: 32,
+                    numeric_scale: 0,
+                    ordinal_position: 2,
+                    description: null,
+                },
+            ],
+            fields: [],
+        }));
+        responses.set("constraints", () => ({
+            rows: [
+                {
+                    table_schema: "public",
+                    table_name: "users",
+                    constraint_name: "users_pkey",
+                    constraint_type: "PRIMARY KEY",
+                    column_name: "id",
+                    foreign_table_schema: null,
+                    foreign_table_name: null,
+                    foreign_column_name: null,
+                },
+                {
+                    table_schema: "public",
+                    table_name: "users",
+                    constraint_name: "users_role_id_fkey",
+                    constraint_type: "FOREIGN KEY",
+                    column_name: "role_id",
+                    foreign_table_schema: "public",
+                    foreign_table_name: "roles",
+                    foreign_column_name: "id",
+                },
+            ],
+            fields: [],
+        }));
+        responses.set("indexes", () => ({
+            rows: [
+                {
+                    schema_name: "public",
+                    table_name: "users",
+                    index_name: "users_pkey",
+                    indisunique: true,
+                    column_names: ["id"],
+                    definition: "CREATE UNIQUE INDEX users_pkey ON public.users USING btree (id)",
+                },
+            ],
+            fields: [],
+        }));
+        let indexQuerySql = null;
+        let lastSql = null;
+        const clientFn = vi.fn(async (sql) => {
+            lastSql = sql;
+            if (/pg_index\s+idx/.test(sql)) {
+                indexQuerySql = sql;
+                return responses.get("indexes")?.() ?? { rows: [], fields: [] };
+            }
+            if (sql.includes("FROM pg_class c")) {
+                return responses.get("tables")?.() ?? { rows: [], fields: [] };
+            }
+            if (sql.includes("information_schema.columns")) {
+                return responses.get("columns")?.() ?? { rows: [], fields: [] };
+            }
+            if (sql.includes("table_constraints")) {
+                return responses.get("constraints")?.() ?? { rows: [], fields: [] };
+            }
+            return { rows: [], fields: [] };
+        });
+        const adapter = new PostgresAdapter(clientFn, {
+            database: "app",
+            defaultSchema: "public",
+        });
+        const result = await adapter.introspect();
+        if (!indexQuerySql) {
+            throw new Error(`index query not executed. last sql: ${lastSql}`);
+        }
+        expect(result.db.name).toBe("app");
+        const table = result.tables[0];
+        if (!table)
+            throw new Error("expected table");
+        expect(table.constraints).toHaveLength(2);
+        const fk = table.constraints.find((c) => c.type === "FOREIGN KEY");
+        expect(fk?.referencedTable).toBe("public.roles");
+        const roleColumn = table.columns.find((c) => c.name === "role_id");
+        expect(roleColumn?.isForeignKey).toBe(true);
+        expect(table.indexes[0]?.columns).toEqual(["id"]);
+    });
+});
+//# sourceMappingURL=introspection.spec.js.map

package/dist/esm/adapters/introspection.spec.js.map

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

package/dist/esm/adapters/postgres.d.ts

@@ -0,0 +1,46 @@
+import type { IntrospectOptions, SchemaIntrospection } from "../schema/types.js";
+import type { DatabaseAdapter, DatabaseExecutionResult } from "./types.js";
+export interface PostgresQueryResult {
+    rows: Array<Record<string, unknown>>;
+    fields: Array<{
+        name: string;
+    }>;
+}
+export type PostgresClientFn = (sql: string, params?: unknown[]) => Promise<PostgresQueryResult>;
+export interface PostgresAdapterOptions {
+    /** Logical database name used in introspection metadata. */
+    database?: string;
+    /** Schema to assume when a table is provided without qualification. */
+    defaultSchema?: string;
+    /** Optional database kind label. Defaults to "postgres". */
+    kind?: SchemaIntrospection["db"]["kind"];
+    /**
+     * Optional allow-list of table names (schema-qualified or bare).
+     * When specified, introspection and queries are restricted to these tables only.
+     */
+    allowedTables?: string[];
+}
+export declare class PostgresAdapter implements DatabaseAdapter {
+    private readonly clientFn;
+    private readonly databaseName;
+    private readonly defaultSchema;
+    private readonly kind;
+    private readonly allowedTables?;
+    constructor(clientFn: PostgresClientFn, options?: PostgresAdapterOptions);
+    execute(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<DatabaseExecutionResult>;
+    /**
+     * Validate that the SQL query only references allowed tables.
+     * This is a basic validation that extracts table-like patterns from the query.
+     */
+    private validateQueryTables;
+    /**
+     * Convert named params to positional array for PostgreSQL
+     * PostgreSQL expects $1, $2, $3 in SQL and an array of values [val1, val2, val3]
+     * The LLM should generate params like: { '1': 'value1', '2': 'value2' }
+     */
+    private convertNamedToPositionalParams;
+    validate(sql: string, params?: Record<string, string | number | boolean | string[] | number[]>): Promise<void>;
+    getDialect(): "postgres";
+    introspect(options?: IntrospectOptions): Promise<SchemaIntrospection>;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/esm/adapters/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAmDD,qBAAa,eAAgB,YAAW,eAAe;IAOnD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAoB;gBAGhC,QAAQ,EAAE,gBAAgB,EAC3C,OAAO,GAAE,sBAA2B;IAahC,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACvE,OAAO,CAAC,uBAAuB,CAAC;IAiBnC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA6B3B;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IA8BhC,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACvE,OAAO,CAAC,IAAI,CAAC;IAUhB,UAAU,IACD,UAAU;IAGb,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiL5E"}