cgraphx 1.1.0

package/dist/dbquery/drivers/mysql.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MySQL driver adapter (mysql2/promise).
+ *
+ * Spec §4.3 connection lifecycle: short-lived, no pool. Each execute() opens
+ * a fresh connection and closes it in finally. Connect timeout 5s, query
+ * timeout 30s (constants).
+ *
+ * Error mapping (spec §6.1):
+ *   - auth / network / unknown-db  → ConnectionFailedError
+ *   - timeout                       → QueryTimeoutError
+ *   - everything else (syntax etc.) → DriverError
+ */
+import type { DBProfile, DriverConnection } from '../types';
+export declare function createMysqlConnection(profile: DBProfile): Promise<DriverConnection>;
+//# sourceMappingURL=mysql.d.ts.map

package/dist/dbquery/drivers/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../../src/dbquery/drivers/mysql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAA0B,MAAM,UAAU,CAAC;AAkDpF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmDzF"}

package/dist/dbquery/drivers/mysql.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * MySQL driver adapter (mysql2/promise).
+ *
+ * Spec §4.3 connection lifecycle: short-lived, no pool. Each execute() opens
+ * a fresh connection and closes it in finally. Connect timeout 5s, query
+ * timeout 30s (constants).
+ *
+ * Error mapping (spec §6.1):
+ *   - auth / network / unknown-db  → ConnectionFailedError
+ *   - timeout                       → QueryTimeoutError
+ *   - everything else (syntax etc.) → DriverError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMysqlConnection = createMysqlConnection;
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+function classifyError(err) {
+    const code = err?.code ?? '';
+    const message = err instanceof Error ? err.message : String(err);
+    const lowered = message.toLowerCase();
+    // Connection / auth errors
+    if (code === 'ECONNREFUSED' ||
+        code === 'ENOTFOUND' ||
+        code === 'EHOSTUNREACH' ||
+        code === 'ETIMEDOUT' ||
+        code === 'ER_ACCESS_DENIED_ERROR' ||
+        code === 'ER_BAD_DB_ERROR' ||
+        code === 'PROTOCOL_CONNECTION_LOST' ||
+        code === 'ER_CON_COUNT_ERROR' ||
+        lowered.includes('connect etimedout') ||
+        lowered.includes('access denied')) {
+        throw new errors_1.ConnectionFailedError(`MySQL connection failed (${code || 'unknown'}): ${redact(message)}`, { code });
+    }
+    // Query timeout (mysql2 reports as ER_QUERY_INTERRUPTED)
+    if (code === 'ER_QUERY_INTERRUPTED' || lowered.includes('timeout')) {
+        throw new errors_1.QueryTimeoutError(constants_1.QUERY_TIMEOUT_MS);
+    }
+    // Everything else is a driver-level error (syntax, missing table, etc.)
+    throw new errors_1.DriverError(`MySQL error (${code || 'unknown'}): ${message}`, { code });
+}
+function redact(message) {
+    // mysql2 doesn't echo password in error text, but defensively strip any
+    // "(using password: YES)" detail that could leak presence/absence.
+    return message.replace(/using password: (yes|no)/i, 'using password: [redacted]');
+}
+async function createMysqlConnection(profile) {
+    const opts = {
+        host: profile.host,
+        port: profile.port,
+        user: profile.user,
+        password: profile.password,
+        database: profile.database,
+        connectTimeout: constants_1.CONNECT_TIMEOUT_MS,
+    };
+    // Lazy require so test environments without mysql2 installed (none expected
+    // now that it's in dependencies) still load this module file.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mysqlModule = require('mysql2/promise');
+    let conn = null;
+    try {
+        conn = await mysqlModule.createConnection(opts);
+    }
+    catch (err) {
+        classifyError(err);
+    }
+    return {
+        async execute(sql, timeoutMs, params) {
+            if (!conn)
+                throw new errors_1.DriverError('MySQL connection not initialized');
+            try {
+                const [rows, fields] = params && params.length > 0
+                    ? await conn.query({ sql, timeout: timeoutMs }, params)
+                    : await conn.query({ sql, timeout: timeoutMs });
+                const columns = (fields ?? []).map(f => ({
+                    name: f.name,
+                    dataType: f.columnType !== undefined ? String(f.columnType) : undefined,
+                }));
+                // mysql2 returns RowDataPacket[] for SELECT, OkPacket for non-SELECT.
+                const rowArray = Array.isArray(rows) ? rows : [];
+                return { columns, rows: rowArray };
+            }
+            catch (err) {
+                classifyError(err);
+            }
+        },
+        async close() {
+            if (!conn)
+                return;
+            try {
+                await conn.end();
+            }
+            catch {
+                /* ignore close errors */
+            }
+            finally {
+                conn = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=mysql.js.map

package/dist/dbquery/drivers/mysql.js.map

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

package/dist/dbquery/drivers/postgres.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PostgreSQL driver adapter (pg).
+ *
+ * Spec §4.3: short-lived Client per execute, no pool. Connect timeout 5s
+ * (pg reads this from the connection URI's `connect_timeout` query param),
+ * query timeout 30s (we SET statement_timeout after connect).
+ *
+ * Error mapping (spec §6.1):
+ *   - 28P01 / 28000 (auth)         → ConnectionFailedError
+ *   - ECONNREFUSED / ENOTFOUND     → ConnectionFailedError
+ *   - 57014 (query_canceled)       → QueryTimeoutError
+ *   - everything else              → DriverError
+ */
+import type { DBProfile, DriverConnection } from '../types';
+export declare function createPostgresConnection(profile: DBProfile): Promise<DriverConnection>;
+//# sourceMappingURL=postgres.d.ts.map

package/dist/dbquery/drivers/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/dbquery/drivers/postgres.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAA0B,MAAM,UAAU,CAAC;AA2CpF,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsD5F"}

package/dist/dbquery/drivers/postgres.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * PostgreSQL driver adapter (pg).
+ *
+ * Spec §4.3: short-lived Client per execute, no pool. Connect timeout 5s
+ * (pg reads this from the connection URI's `connect_timeout` query param),
+ * query timeout 30s (we SET statement_timeout after connect).
+ *
+ * Error mapping (spec §6.1):
+ *   - 28P01 / 28000 (auth)         → ConnectionFailedError
+ *   - ECONNREFUSED / ENOTFOUND     → ConnectionFailedError
+ *   - 57014 (query_canceled)       → QueryTimeoutError
+ *   - everything else              → DriverError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPostgresConnection = createPostgresConnection;
+const pg_1 = require("pg");
+const constants_1 = require("../constants");
+const errors_1 = require("../errors");
+function classifyError(err) {
+    const e = err;
+    const code = e.code ?? e.errno ?? '';
+    const message = e instanceof Error ? e.message : String(err);
+    const lowered = message.toLowerCase();
+    // Auth / connection errors
+    if (code === '28P01' || // password auth failed
+        code === '28000' || // authorization denied
+        code === '3D000' || // database does not exist
+        code === 'ECONNREFUSED' ||
+        code === 'ENOTFOUND' ||
+        code === 'EHOSTUNREACH' ||
+        code === 'ETIMEDOUT' ||
+        lowered.includes('password authentication failed') ||
+        lowered.includes('connect etimedout')) {
+        throw new errors_1.ConnectionFailedError(`PostgreSQL connection failed (${code || 'unknown'}): ${redact(message)}`, { code });
+    }
+    // Cancellation — pg returns code 57014 for statement_timeout cancel
+    if (code === '57014' || lowered.includes('canceling statement due to statement timeout')) {
+        throw new errors_1.QueryTimeoutError(constants_1.QUERY_TIMEOUT_MS);
+    }
+    throw new errors_1.DriverError(`PostgreSQL error (${code || 'unknown'}): ${message}`, { code });
+}
+function redact(message) {
+    return message.replace(/password:[^)\s]+/gi, 'password:[redacted]');
+}
+async function createPostgresConnection(profile) {
+    const schema = profile.schema ?? 'public';
+    const connectionString = `postgresql://${encodeURIComponent(profile.user)}:${encodeURIComponent(profile.password)}` +
+        `@${profile.host}:${profile.port}/${encodeURIComponent(profile.database)}` +
+        `?connect_timeout=${Math.ceil(constants_1.CONNECT_TIMEOUT_MS / 1000)}`;
+    let client = null;
+    try {
+        client = new pg_1.Client({ connectionString });
+        await client.connect();
+        // Apply statement_timeout so runaway queries cancel automatically.
+        await client.query(`SET statement_timeout = ${constants_1.QUERY_TIMEOUT_MS}`);
+        // Set search_path so unqualified table names resolve correctly.
+        await client.query(`SET search_path TO ${schema}, public`);
+    }
+    catch (err) {
+        if (client) {
+            try {
+                await client.end();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        classifyError(err);
+    }
+    return {
+        async execute(sql, _timeoutMs, params) {
+            if (!client)
+                throw new errors_1.DriverError('PostgreSQL client not initialized');
+            try {
+                const result = params
+                    ? await client.query(sql, params)
+                    : await client.query(sql);
+                const columns = (result.fields ?? []).map(f => ({
+                    name: f.name,
+                    dataType: f.dataTypeID !== undefined ? String(f.dataTypeID) : undefined,
+                }));
+                const rows = (result.rows ?? []);
+                return { columns, rows };
+            }
+            catch (err) {
+                classifyError(err);
+            }
+        },
+        async close() {
+            if (!client)
+                return;
+            try {
+                await client.end();
+            }
+            catch {
+                /* ignore */
+            }
+            finally {
+                client = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=postgres.js.map

package/dist/dbquery/drivers/postgres.js.map

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

package/dist/dbquery/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Error types for the db-query subsystem.
+ *
+ * Independent from codegraph's main error types so the subsystem can be
+ * removed without touching the rest of the project. All errors here are
+ * expected/operational and the MCP/CLI surfaces convert them to
+ * success-shaped responses (spec §6.2).
+ */
+export type DbQueryErrorCode = 'CONFIG_NOT_FOUND' | 'PROFILE_NOT_FOUND' | 'SAFETY_REJECTED' | 'CONNECTION_FAILED' | 'QUERY_TIMEOUT' | 'DRIVER_ERROR' | 'SUBSYSTEM_DISABLED';
+export declare class DbQueryError extends Error {
+    readonly code: DbQueryErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: DbQueryErrorCode, details?: Record<string, unknown> | undefined);
+}
+export declare class ConfigNotFoundError extends DbQueryError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class ProfileNotFoundError extends DbQueryError {
+    readonly queriedProfile: string | null;
+    constructor(queriedProfile: string | null, available: string[]);
+}
+export declare class SafetyRejectionError extends DbQueryError {
+    readonly matchedKeywords: string[];
+    readonly normalizedSql: string;
+    constructor(matchedKeywords: string[], normalizedSql: string);
+}
+export declare class ConnectionFailedError extends DbQueryError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class QueryTimeoutError extends DbQueryError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+export declare class DriverError extends DbQueryError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+export declare class SubsystemDisabledError extends DbQueryError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/dbquery/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/dbquery/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,cAAc,GACd,oBAAoB,CAAC;AAEzB,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,gBAAgB;aACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,oBAAqB,SAAQ,YAAY;aAElC,cAAc,EAAE,MAAM,GAAG,IAAI;gBAA7B,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7C,SAAS,EAAE,MAAM,EAAE;CAYtB;AAED,qBAAa,oBAAqB,SAAQ,YAAY;aAElC,eAAe,EAAE,MAAM,EAAE;aACzB,aAAa,EAAE,MAAM;gBADrB,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,MAAM;CAUxC;AAED,qBAAa,qBAAsB,SAAQ,YAAY;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,iBAAkB,SAAQ,YAAY;aACrB,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAS9C;AAED,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,qBAAa,sBAAuB,SAAQ,YAAY;;CAKvD"}

package/dist/dbquery/errors.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Error types for the db-query subsystem.
+ *
+ * Independent from codegraph's main error types so the subsystem can be
+ * removed without touching the rest of the project. All errors here are
+ * expected/operational and the MCP/CLI surfaces convert them to
+ * success-shaped responses (spec §6.2).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubsystemDisabledError = exports.DriverError = exports.QueryTimeoutError = exports.ConnectionFailedError = exports.SafetyRejectionError = exports.ProfileNotFoundError = exports.ConfigNotFoundError = exports.DbQueryError = void 0;
+class DbQueryError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'DbQueryError';
+    }
+}
+exports.DbQueryError = DbQueryError;
+class ConfigNotFoundError extends DbQueryError {
+    constructor(message, details) {
+        super(message, 'CONFIG_NOT_FOUND', details);
+        this.name = 'ConfigNotFoundError';
+    }
+}
+exports.ConfigNotFoundError = ConfigNotFoundError;
+class ProfileNotFoundError extends DbQueryError {
+    queriedProfile;
+    constructor(queriedProfile, available) {
+        const list = available.length > 0 ? available.join(', ') : '(none)';
+        super(queriedProfile
+            ? `Profile not found: ${queriedProfile}. Available profiles: ${list}`
+            : `No profile specified and no default configured. Available profiles: ${list}`, 'PROFILE_NOT_FOUND', { queriedProfile, available });
+        this.queriedProfile = queriedProfile;
+        this.name = 'ProfileNotFoundError';
+    }
+}
+exports.ProfileNotFoundError = ProfileNotFoundError;
+class SafetyRejectionError extends DbQueryError {
+    matchedKeywords;
+    normalizedSql;
+    constructor(matchedKeywords, normalizedSql) {
+        super(`Query rejected: SQL contains forbidden keyword(s): ${matchedKeywords.join(', ')}. ` +
+            `Only read-only SELECT queries are allowed.`, 'SAFETY_REJECTED', { matchedKeywords });
+        this.matchedKeywords = matchedKeywords;
+        this.normalizedSql = normalizedSql;
+        this.name = 'SafetyRejectionError';
+    }
+}
+exports.SafetyRejectionError = SafetyRejectionError;
+class ConnectionFailedError extends DbQueryError {
+    constructor(message, details) {
+        super(message, 'CONNECTION_FAILED', details);
+        this.name = 'ConnectionFailedError';
+    }
+}
+exports.ConnectionFailedError = ConnectionFailedError;
+class QueryTimeoutError extends DbQueryError {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Query timed out after ${timeoutMs}ms. The query may be too expensive; ` +
+            `narrow the scope or add a tighter LIMIT.`, 'QUERY_TIMEOUT', { timeoutMs });
+        this.timeoutMs = timeoutMs;
+        this.name = 'QueryTimeoutError';
+    }
+}
+exports.QueryTimeoutError = QueryTimeoutError;
+class DriverError extends DbQueryError {
+    constructor(message, details) {
+        super(message, 'DRIVER_ERROR', details);
+        this.name = 'DriverError';
+    }
+}
+exports.DriverError = DriverError;
+class SubsystemDisabledError extends DbQueryError {
+    constructor() {
+        super('db-query subsystem is disabled.', 'SUBSYSTEM_DISABLED');
+        this.name = 'SubsystemDisabledError';
+    }
+}
+exports.SubsystemDisabledError = SubsystemDisabledError;
+//# sourceMappingURL=errors.js.map

package/dist/dbquery/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/dbquery/errors.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAWH,MAAa,YAAa,SAAQ,KAAK;IAGnB;IACA;IAHlB,YACE,OAAe,EACC,IAAsB,EACtB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAkB;QACtB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AATD,oCASC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IAElC;IADlB,YACkB,cAA6B,EAC7C,SAAmB;QAEnB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACpE,KAAK,CACH,cAAc;YACZ,CAAC,CAAC,sBAAsB,cAAc,yBAAyB,IAAI,EAAE;YACrE,CAAC,CAAC,uEAAuE,IAAI,EAAE,EACjF,mBAAmB,EACnB,EAAE,cAAc,EAAE,SAAS,EAAE,CAC9B,CAAC;QAVc,mBAAc,GAAd,cAAc,CAAe;QAW7C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAfD,oDAeC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IAElC;IACA;IAFlB,YACkB,eAAyB,EACzB,aAAqB;QAErC,KAAK,CACH,sDAAsD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAClF,4CAA4C,EAC9C,iBAAiB,EACjB,EAAE,eAAe,EAAE,CACpB,CAAC;QARc,oBAAe,GAAf,eAAe,CAAU;QACzB,kBAAa,GAAb,aAAa,CAAQ;QAQrC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAbD,oDAaC;AAED,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,iBAAkB,SAAQ,YAAY;IACrB;IAA5B,YAA4B,SAAiB;QAC3C,KAAK,CACH,yBAAyB,SAAS,sCAAsC;YACtE,0CAA0C,EAC5C,eAAe,EACf,EAAE,SAAS,EAAE,CACd,CAAC;QANwB,cAAS,GAAT,SAAS,CAAQ;QAO3C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAVD,8CAUC;AAED,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED,MAAa,sBAAuB,SAAQ,YAAY;IACtD;QACE,KAAK,CAAC,iCAAiC,EAAE,oBAAoB,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC"}

package/dist/dbquery/executor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * db-query executor — main entry point.
+ *
+ * Routes by mode, runs safety checks, dispatches to the right driver,
+ * normalizes results, and writes one log record per call (spec §4 / §2.6).
+ *
+ * All errors thrown here are subclasses of DbQueryError (spec §6.1) —
+ * callers (MCP handler, CLI) catch and convert to success-shaped responses.
+ */
+import { SafetyRejectionError } from './errors';
+import type { QueryInput, QueryResult, SchemaInput, SchemaResult, ProfilesInput, ProfilesResult } from './types';
+/**
+ * Execute a read-only SQL query (spec §4.2 mode=query).
+ *
+ * Throws: SubsystemDisabledError / ConfigNotFoundError / ProfileNotFoundError
+ *        / SafetyRejectionError / ConnectionFailedError / QueryTimeoutError
+ *        / DriverError.
+ */
+export declare function runQuery(input: QueryInput, projectRoot: string): Promise<QueryResult>;
+/**
+ * Run a schema-introspection query (spec §4.2 mode=tables|ddl|indexes|table-comment).
+ */
+export declare function runSchema(input: SchemaInput, projectRoot: string): Promise<SchemaResult>;
+/**
+ * List configured profiles (spec §4.2 mode=profiles). Does NOT connect to DB.
+ */
+export declare function listProfiles(input: ProfilesInput, projectRoot: string): Promise<ProfilesResult>;
+export type { QueryInput, QueryResult, SchemaInput, SchemaResult, ProfilesInput, ProfilesResult };
+export { SafetyRejectionError };
+//# sourceMappingURL=executor.d.ts.map

package/dist/dbquery/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/dbquery/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAGL,oBAAoB,EAErB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EAKf,MAAM,SAAS,CAAC;AAqDjB;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAoD3F;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAiH9F;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuBrG;AAGD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC;AAClG,OAAO,EAAE,oBAAoB,EAAE,CAAC"}