@pilat/mcp-datalink 1.0.1

package/dist/adapters/postgresql/adapter.js

@@ -0,0 +1,429 @@
+/**
+ * PostgreSQL Database Adapter
+ *
+ * Implements DatabaseAdapter interface for PostgreSQL databases.
+ * Uses node-postgres (pg) driver with per-request connection recycling.
+ */
+import pg from 'pg';
+import { parse, toSql } from 'pgsql-ast-parser';
+import { DbMcpError, ErrorCode } from '../../utils/errors.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// SQL Dialect helpers (formerly in dialect.ts)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Prefixes that indicate dangerous SQL operations
+ * pgsql-ast-parser returns types like "drop table", "alter table", etc.
+ */
+const DANGEROUS_PREFIXES = [
+    'drop',
+    'truncate',
+    'alter',
+    'create',
+    'grant',
+    'revoke',
+];
+/**
+ * Maps pgsql-ast-parser statement types to our QueryType
+ */
+function getQueryType(statement) {
+    switch (statement.type) {
+        case 'select':
+            return 'select';
+        case 'insert':
+            return 'insert';
+        case 'update':
+            return 'update';
+        case 'delete':
+            return 'delete';
+        default:
+            return 'other';
+    }
+}
+/**
+ * Check if a statement type is dangerous
+ * Handles compound types from pgsql-ast-parser like "drop table", "alter table"
+ */
+function checkDangerous(statement) {
+    const stmtType = statement.type.toLowerCase();
+    for (const prefix of DANGEROUS_PREFIXES) {
+        if (stmtType === prefix || stmtType.startsWith(prefix + ' ')) {
+            const operation = prefix.toUpperCase();
+            return {
+                isDangerous: true,
+                reason: operation + ' statements are not allowed',
+            };
+        }
+    }
+    return { isDangerous: false };
+}
+/**
+ * Type guard to check if a statement is a SelectFromStatement
+ */
+function isSelectFromStatement(statement) {
+    return statement.type === 'select' && 'columns' in statement;
+}
+/**
+ * Check if a SELECT statement has a LIMIT clause
+ */
+function hasLimitClause(statement) {
+    if (!isSelectFromStatement(statement)) {
+        return false;
+    }
+    return statement.limit !== undefined && statement.limit !== null;
+}
+/**
+ * PostgreSQL database adapter
+ *
+ * Creates new connections for each request to prevent session state attacks.
+ */
+export class PostgreSqlAdapter {
+    type = 'postgresql';
+    connectionUrl;
+    timeout;
+    constructor(config) {
+        this.connectionUrl = config.database.url;
+        this.timeout = config.defaults.timeout;
+    }
+    /**
+     * Get the default schema name for PostgreSQL
+     */
+    getDefaultSchema() {
+        return 'public';
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // SQL Dialect methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Parse and validate a SQL query
+     */
+    parseQuery(sql) {
+        let statements;
+        try {
+            statements = parse(sql);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown parse error';
+            throw new DbMcpError(ErrorCode.INVALID_SQL, 'Failed to parse SQL: ' + message, { sql });
+        }
+        // Filter out empty statements (trailing semicolons create these)
+        const nonEmptyStatements = statements.filter((stmt) => stmt.type !== 'empty' && stmt.type !== undefined);
+        if (nonEmptyStatements.length === 0) {
+            throw new DbMcpError(ErrorCode.INVALID_SQL, 'No valid SQL statement found', { sql });
+        }
+        if (nonEmptyStatements.length > 1) {
+            throw new DbMcpError(ErrorCode.MULTI_STATEMENT, 'Multiple SQL statements are not allowed. Please provide a single statement.', { sql, statementCount: nonEmptyStatements.length });
+        }
+        const statement = nonEmptyStatements[0];
+        const queryType = getQueryType(statement);
+        const { isDangerous, reason } = checkDangerous(statement);
+        return {
+            type: queryType,
+            hasLimit: hasLimitClause(statement),
+            isDangerous,
+            dangerousReason: reason,
+            sql,
+        };
+    }
+    /**
+     * Inject a LIMIT clause into a SELECT query if it doesn't have one
+     */
+    injectLimit(sql, limit) {
+        let statements;
+        try {
+            statements = parse(sql);
+        }
+        catch {
+            return sql;
+        }
+        const nonEmptyStatements = statements.filter((stmt) => stmt.type !== 'empty' && stmt.type !== undefined);
+        if (nonEmptyStatements.length !== 1) {
+            return sql;
+        }
+        const statement = nonEmptyStatements[0];
+        if (!isSelectFromStatement(statement)) {
+            return sql;
+        }
+        if (statement.limit !== undefined && statement.limit !== null) {
+            return sql;
+        }
+        statement.limit = {
+            limit: { type: 'integer', value: limit },
+        };
+        return toSql.statement(statement);
+    }
+    /**
+     * Validate that a SQL query is appropriate for a specific tool
+     */
+    validateQueryForTool(sql, tool) {
+        const parsed = this.parseQuery(sql);
+        if (tool === 'query') {
+            if (parsed.type !== 'select') {
+                throw new DbMcpError(ErrorCode.QUERY_BLOCKED, 'The query tool only accepts SELECT statements. Use the execute tool for ' +
+                    parsed.type.toUpperCase() +
+                    ' statements.', { sql, queryType: parsed.type, tool });
+            }
+        }
+        else if (tool === 'execute') {
+            if (parsed.type === 'select') {
+                throw new DbMcpError(ErrorCode.QUERY_BLOCKED, 'The execute tool does not accept SELECT statements. Use the query tool instead.', { sql, queryType: parsed.type, tool });
+            }
+            if (parsed.isDangerous) {
+                throw new DbMcpError(ErrorCode.QUERY_BLOCKED, parsed.dangerousReason ?? 'This operation is not allowed', { sql, queryType: parsed.type, tool });
+            }
+            const allowedTypes = ['insert', 'update', 'delete'];
+            if (!allowedTypes.includes(parsed.type)) {
+                throw new DbMcpError(ErrorCode.QUERY_BLOCKED, 'The execute tool only accepts INSERT, UPDATE, or DELETE statements.', { sql, queryType: parsed.type, tool });
+            }
+        }
+    }
+    /**
+     * Get the EXPLAIN prefix for PostgreSQL
+     */
+    getExplainPrefix(analyze) {
+        return analyze ? 'EXPLAIN ANALYZE ' : 'EXPLAIN ';
+    }
+    /**
+     * Convert placeholders - no-op for PostgreSQL (already uses $1, $2, $3)
+     */
+    convertPlaceholders(sql) {
+        return sql;
+    }
+    /**
+     * Execute a function with a managed PostgreSQL connection
+     */
+    async withConnection(fn) {
+        const client = new pg.Client({
+            connectionString: this.connectionUrl,
+        });
+        try {
+            // Connect to database
+            try {
+                await client.connect();
+            }
+            catch (error) {
+                throw new DbMcpError(ErrorCode.CONNECTION_FAILED, 'Failed to connect to PostgreSQL database', {
+                    cause: error instanceof Error ? error.message : String(error),
+                });
+            }
+            // SET command doesn't support parameterized queries, so validate timeout first
+            if (!Number.isInteger(this.timeout) || this.timeout < 0) {
+                throw new DbMcpError(ErrorCode.CONNECTION_FAILED, `Invalid timeout value: ${this.timeout}`);
+            }
+            await client.query(`SET statement_timeout = ${this.timeout}`);
+            // Create connection wrapper and execute user function
+            const connection = new PostgreSqlConnection(client);
+            return await fn(connection);
+        }
+        finally {
+            await client.end();
+        }
+    }
+    /**
+     * Clean up resources (no persistent resources in this adapter)
+     */
+    async dispose() {
+        // No persistent resources to clean up
+        // Each connection is created and destroyed per request
+    }
+}
+/**
+ * PostgreSQL connection wrapper
+ *
+ * Provides AdapterConnection interface over pg.Client.
+ * Handles PostgreSQL-specific query execution and metadata retrieval.
+ */
+class PostgreSqlConnection {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Execute a parameterized query
+     *
+     * SECURITY: All user SQL MUST go through this method with parameters.
+     * Uses pg's parameterized query support ($1, $2, etc.)
+     */
+    async query(sql, params) {
+        const result = await this.client.query({
+            text: sql,
+            values: params ?? [],
+            rowMode: 'array',
+        });
+        return {
+            fields: result.fields.map((f) => ({ name: f.name })),
+            rows: result.rows,
+            rowCount: result.rowCount ?? 0,
+        };
+    }
+    /**
+     * Execute a raw SQL statement (for BEGIN, COMMIT, ROLLBACK)
+     */
+    async execute(sql) {
+        await this.client.query(sql);
+    }
+    /**
+     * List tables in a PostgreSQL schema
+     *
+     * Uses information_schema and pg_class for table metadata.
+     * Note: maxTables is accepted for interface compatibility but filtering
+     * is done at the caller level to report accurate totalAvailable count.
+     */
+    async listTables(schema, _maxTables) {
+        const sql = `
+      SELECT
+        t.table_name as name,
+        t.table_schema as schema,
+        CASE WHEN t.table_type = 'BASE TABLE' THEN 'table' ELSE 'view' END as type,
+        c.reltuples::bigint as rows_estimate
+      FROM information_schema.tables t
+      LEFT JOIN pg_class c ON c.relname = t.table_name
+        AND c.relnamespace = (SELECT oid FROM pg_namespace WHERE nspname = t.table_schema)
+      WHERE t.table_schema = $1
+      ORDER BY t.table_name
+    `;
+        const result = await this.client.query(sql, [schema]);
+        const tables = result.rows.map((row) => ({
+            name: row.name,
+            schema: row.schema,
+            type: row.type,
+            rows_estimate: row.rows_estimate !== null ? Number(row.rows_estimate) : null,
+        }));
+        return {
+            tables,
+            totalAvailable: tables.length,
+        };
+    }
+    /**
+     * Describe a PostgreSQL table
+     *
+     * Retrieves columns, indexes, and foreign keys from information_schema and pg_* catalogs.
+     */
+    async describeTable(table, schema, limits) {
+        // Query 1: Get columns
+        const columnsQuery = `
+      SELECT
+        column_name as name,
+        data_type || COALESCE('(' || character_maximum_length || ')', '') as type,
+        is_nullable = 'YES' as nullable,
+        column_default as default
+      FROM information_schema.columns
+      WHERE table_schema = $1 AND table_name = $2
+      ORDER BY ordinal_position
+    `;
+        // Query 2: Get primary key columns
+        const primaryKeyQuery = `
+      SELECT a.attname as column_name
+      FROM pg_index i
+      JOIN pg_attribute a ON a.attrelid = i.indrelid AND a.attnum = ANY(i.indkey)
+      WHERE i.indrelid = ($1 || '.' || $2)::regclass AND i.indisprimary
+    `;
+        // Query 3: Get indexes
+        const indexesQuery = `
+      SELECT
+        indexname as name,
+        indexdef
+      FROM pg_indexes
+      WHERE schemaname = $1 AND tablename = $2
+    `;
+        // Query 4: Get foreign keys
+        const foreignKeysQuery = `
+      SELECT
+        kcu.column_name as column,
+        ccu.table_name as ref_table,
+        ccu.column_name as ref_column
+      FROM information_schema.table_constraints tc
+      JOIN information_schema.key_column_usage kcu
+        ON tc.constraint_name = kcu.constraint_name
+        AND tc.table_schema = kcu.table_schema
+      JOIN information_schema.constraint_column_usage ccu
+        ON tc.constraint_name = ccu.constraint_name
+        AND tc.table_schema = ccu.table_schema
+      WHERE tc.constraint_type = 'FOREIGN KEY'
+        AND tc.table_schema = $1
+        AND tc.table_name = $2
+    `;
+        // Execute all queries in parallel
+        const [columnsResult, primaryKeyResult, indexesResult, foreignKeysResult] = await Promise.all([
+            this.client.query(columnsQuery, [schema, table]),
+            this.client.query(primaryKeyQuery, [schema, table]),
+            this.client.query(indexesQuery, [schema, table]),
+            this.client.query(foreignKeysQuery, [schema, table]),
+        ]);
+        // Build set of primary key columns for quick lookup
+        const primaryKeyColumns = new Set(primaryKeyResult.rows.map((row) => row.column_name));
+        // Build columns array with primaryKey flag
+        const allColumns = columnsResult.rows.map((row) => ({
+            name: row.name,
+            type: row.type,
+            nullable: row.nullable,
+            default: row.default,
+            primaryKey: primaryKeyColumns.has(row.name),
+        }));
+        // Build indexes array
+        const allIndexes = indexesResult.rows.map((row) => {
+            const { columns, unique } = parseIndexDef(row.indexdef);
+            // An index is primary if all its columns are in the primary key
+            const primary = columns.length > 0 &&
+                columns.every((col) => primaryKeyColumns.has(col)) &&
+                columns.length === primaryKeyColumns.size;
+            return {
+                name: row.name,
+                columns,
+                unique,
+                primary,
+            };
+        });
+        // Build foreign keys array
+        const foreignKeys = foreignKeysResult.rows.map((row) => ({
+            column: row.column,
+            references: {
+                table: row.ref_table,
+                column: row.ref_column,
+            },
+        }));
+        // Apply limits and track truncation
+        let truncated = false;
+        const truncationReasons = [];
+        const columns = allColumns.length > limits.maxColumns
+            ? ((truncated = true),
+                truncationReasons.push(`columns (${allColumns.length} > ${limits.maxColumns})`),
+                allColumns.slice(0, limits.maxColumns))
+            : allColumns;
+        const indexes = allIndexes.length > limits.maxIndexes
+            ? ((truncated = true),
+                truncationReasons.push(`indexes (${allIndexes.length} > ${limits.maxIndexes})`),
+                allIndexes.slice(0, limits.maxIndexes))
+            : allIndexes;
+        return {
+            table,
+            schema,
+            columns,
+            indexes,
+            foreignKeys,
+            truncated,
+            ...(truncated && { truncationReason: truncationReasons.join(', ') }),
+        };
+    }
+}
+/**
+ * Parse index definition to extract columns and unique flag
+ *
+ * Example indexdef:
+ * `CREATE UNIQUE INDEX users_email_idx ON public.users USING btree (email)`
+ * `CREATE INDEX users_name_idx ON public.users USING btree (first_name, last_name)`
+ */
+function parseIndexDef(indexdef) {
+    const unique = indexdef.toUpperCase().includes('UNIQUE');
+    // Extract columns from parentheses after USING method (btree, hash, etc.)
+    const columnsMatch = indexdef.match(/\(([^)]+)\)\s*$/);
+    if (!columnsMatch) {
+        return { columns: [], unique };
+    }
+    // Split by comma and clean up column names (remove ASC/DESC, NULLS FIRST/LAST, etc.)
+    const columns = columnsMatch[1]
+        .split(',')
+        .map((col) => col.trim().split(/\s+/)[0])
+        .filter(Boolean);
+    return { columns, unique };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/postgresql/adapter.js.map

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

package/dist/adapters/sqlite/adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SQLite Database Adapter
+ *
+ * Implements DatabaseAdapter interface for SQLite databases.
+ * Uses better-sqlite3 library for synchronous database access.
+ */
+import type { DatabaseAdapter, AdapterConnection, AdapterConfig } from '../types.js';
+import type { ParsedQuery } from '../../types.js';
+/**
+ * SQLite database adapter
+ *
+ * Creates new database handles for each request.
+ *
+ * Note: better-sqlite3 is synchronous, but we wrap in async for interface
+ * compatibility with other adapters.
+ */
+export declare class SqliteAdapter implements DatabaseAdapter {
+    readonly type: "sqlite";
+    private readonly dbPath;
+    private readonly timeout;
+    private readonly readonly;
+    constructor(config: AdapterConfig);
+    /**
+     * Get the default schema name for SQLite
+     */
+    getDefaultSchema(): string;
+    /**
+     * Parse and validate a SQLite SQL query
+     */
+    parseQuery(sql: string): ParsedQuery;
+    /**
+     * Inject a LIMIT clause into a SELECT query if it doesn't have one
+     */
+    injectLimit(sql: string, limit: number): string;
+    /**
+     * Validate that a SQL query is appropriate for a specific tool
+     */
+    validateQueryForTool(sql: string, tool: 'query' | 'execute'): void;
+    /**
+     * Get the EXPLAIN prefix for SQLite
+     */
+    getExplainPrefix(_analyze: boolean): string;
+    /**
+     * Convert $1, $2 style placeholders to ? style for SQLite
+     */
+    convertPlaceholders(sql: string): string;
+    /**
+     * Execute a function with a managed SQLite connection
+     */
+    withConnection<T>(fn: (conn: AdapterConnection) => Promise<T>): Promise<T>;
+    /**
+     * Clean up resources (no persistent resources in this adapter)
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/sqlite/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/sqlite/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,aAAa,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,WAAW,EAOZ,MAAM,gBAAgB,CAAC;AAsRxB;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;gBAEvB,MAAM,EAAE,aAAa;IAOjC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAQ1B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAgCpC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAyClE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM;IAI3C;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA+CxC;;OAEG;IACG,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiBhF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}