cgraphx 1.1.0

package/dist/dbquery/executor.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafetyRejectionError = void 0;
+exports.runQuery = runQuery;
+exports.runSchema = runSchema;
+exports.listProfiles = listProfiles;
+const constants_1 = require("./constants");
+const config_1 = require("./config");
+const safety_1 = require("./safety");
+const logging_1 = require("./logging");
+const format_1 = require("./format");
+const queries_1 = require("./queries");
+const mysql_1 = require("./drivers/mysql");
+const postgres_1 = require("./drivers/postgres");
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "SafetyRejectionError", { enumerable: true, get: function () { return errors_1.SafetyRejectionError; } });
+function nowIso() {
+    return new Date().toISOString();
+}
+function elapsedMs(start) {
+    return Date.now() - start;
+}
+function statusForError(err) {
+    if (err instanceof errors_1.DbQueryError) {
+        switch (err.code) {
+            case 'CONFIG_NOT_FOUND':
+            case 'PROFILE_NOT_FOUND':
+                return 'config-error';
+            case 'SAFETY_REJECTED':
+                return 'safety-rejected';
+            case 'CONNECTION_FAILED':
+                return 'connection-failed';
+            case 'QUERY_TIMEOUT':
+                return 'timeout';
+            case 'DRIVER_ERROR':
+                return 'driver-error';
+            case 'SUBSYSTEM_DISABLED':
+                return 'disabled';
+        }
+    }
+    return 'driver-error';
+}
+function recordAndRethrow(projectRoot, start, mode, profileName, sql, err) {
+    const status = statusForError(err);
+    const errorMessage = err instanceof Error ? err.message : String(err);
+    (0, logging_1.logQuery)(projectRoot, {
+        timestamp: nowIso(),
+        profile: profileName,
+        mode,
+        sql,
+        durationMs: elapsedMs(start),
+        status,
+        errorMessage,
+    });
+    throw err;
+}
+/**
+ * Execute a read-only SQL query (spec §4.2 mode=query).
+ *
+ * Throws: SubsystemDisabledError / ConfigNotFoundError / ProfileNotFoundError
+ *        / SafetyRejectionError / ConnectionFailedError / QueryTimeoutError
+ *        / DriverError.
+ */
+async function runQuery(input, projectRoot) {
+    const start = Date.now();
+    const mode = 'query';
+    // 1. Load config (may throw ConfigNotFoundError).
+    const cfg = (0, config_1.loadProfiles)(projectRoot);
+    // 2. Disabled short-circuit (still logs).
+    if (!cfg.enabled) {
+        recordAndRethrow(projectRoot, start, mode, '(disabled)', input.sql, new errors_1.SubsystemDisabledError());
+    }
+    // 3. Resolve profile.
+    let profile;
+    try {
+        profile = (0, config_1.resolveProfile)(cfg, input.profile);
+    }
+    catch (err) {
+        recordAndRethrow(projectRoot, start, mode, input.profile ?? '(default)', input.sql, err);
+    }
+    // 4. Safety check.
+    const safety = (0, safety_1.checkSafety)(input.sql, input.limit);
+    if (!safety.ok) {
+        recordAndRethrow(projectRoot, start, mode, profile.name, input.sql, safety.error);
+    }
+    // 5. Execute via driver.
+    const driver = profile.type === 'mysql'
+        ? await (0, mysql_1.createMysqlConnection)(profile)
+        : await (0, postgres_1.createPostgresConnection)(profile);
+    try {
+        const raw = await driver.execute(safety.normalizedSql, constants_1.QUERY_TIMEOUT_MS);
+        const truncated = safety.effectiveLimit > 0 && raw.rows.length >= safety.effectiveLimit;
+        const result = (0, format_1.formatQueryResult)(raw, profile.name, elapsedMs(start), truncated);
+        (0, logging_1.logQuery)(projectRoot, {
+            timestamp: nowIso(),
+            profile: profile.name,
+            mode,
+            sql: safety.normalizedSql,
+            durationMs: elapsedMs(start),
+            rowCount: result.rowCount,
+            truncated: result.truncated,
+            status: 'ok',
+        });
+        return result;
+    }
+    catch (err) {
+        recordAndRethrow(projectRoot, start, mode, profile.name, safety.normalizedSql, err);
+    }
+    finally {
+        await driver.close();
+    }
+}
+/**
+ * Run a schema-introspection query (spec §4.2 mode=tables|ddl|indexes|table-comment).
+ */
+async function runSchema(input, projectRoot) {
+    const start = Date.now();
+    const mode = input.mode;
+    const cfg = (0, config_1.loadProfiles)(projectRoot);
+    if (!cfg.enabled) {
+        recordAndRethrow(projectRoot, start, mode, '(disabled)', undefined, new errors_1.SubsystemDisabledError());
+    }
+    let profile;
+    try {
+        profile = (0, config_1.resolveProfile)(cfg, input.profile);
+    }
+    catch (err) {
+        recordAndRethrow(projectRoot, start, mode, input.profile ?? '(default)', undefined, err);
+    }
+    if ((mode === 'ddl' || mode === 'indexes' || mode === 'table-comment') && !input.table) {
+        recordAndRethrow(projectRoot, start, mode, profile.name, undefined, new errors_1.ConfigNotFoundError(`Table name required for mode=${mode}`));
+    }
+    const table = input.table ?? '';
+    // Pick SQL template.
+    const parametrized = profile.type === 'mysql'
+        ? (0, queries_1.mysqlSchemaQuery)(mode, table, profile.database)
+        : (0, queries_1.postgresSchemaQuery)(mode, table, profile.schema ?? 'public');
+    const driver = profile.type === 'mysql'
+        ? await (0, mysql_1.createMysqlConnection)(profile)
+        : await (0, postgres_1.createPostgresConnection)(profile);
+    try {
+        // For ddl, we need three queries (columns + PK + constraints) merged.
+        if (mode === 'ddl') {
+            let colsRaw, pkRaw, consRaw;
+            if (profile.type === 'mysql') {
+                const colsQ = (0, queries_1.mysqlSchemaQuery)('ddl', table, profile.database);
+                const pkQ = (0, queries_1.mysqlPrimaryKeySql)(table, profile.database);
+                const consQ = (0, queries_1.mysqlConstraintsSql)(table, profile.database);
+                colsRaw = await driver.execute(colsQ.sql, constants_1.QUERY_TIMEOUT_MS, colsQ.params);
+                pkRaw = await driver.execute(pkQ.sql, constants_1.QUERY_TIMEOUT_MS, pkQ.params);
+                consRaw = await driver.execute(consQ.sql, constants_1.QUERY_TIMEOUT_MS, consQ.params);
+            }
+            else {
+                // PG: ddl SQL is in parametrized already; PK + constraints need extra queries.
+                colsRaw = await driver.execute(parametrized.sql, constants_1.QUERY_TIMEOUT_MS, parametrized.params);
+                const regclass = `${profile.schema ?? 'public'}.${table}`;
+                pkRaw = await driver.execute('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::regclass AND i.indisprimary ' +
+                    'ORDER BY array_position(i.indkey, a.attnum)', constants_1.QUERY_TIMEOUT_MS, [regclass]);
+                consRaw = await driver.execute('SELECT c.conname AS name, ' +
+                    'CASE WHEN c.contype = \'p\' THEN \'PRIMARY KEY\' ' +
+                    'WHEN c.contype = \'u\' THEN \'UNIQUE\' ' +
+                    'WHEN c.contype = \'f\' THEN \'FOREIGN KEY\' ' +
+                    'WHEN c.contype = \'c\' THEN \'CHECK\' ELSE c.contype::text END AS type ' +
+                    'FROM pg_constraint c WHERE c.conrelid = $1::regclass ORDER BY c.conname', constants_1.QUERY_TIMEOUT_MS, [regclass]);
+            }
+            const result = (0, format_1.formatDdlResult)(colsRaw, pkRaw, consRaw, table, profile.name, elapsedMs(start));
+            (0, logging_1.logQuery)(projectRoot, {
+                timestamp: nowIso(),
+                profile: profile.name,
+                mode,
+                sql: parametrized.sql,
+                durationMs: elapsedMs(start),
+                rowCount: result.columns.length,
+                status: 'ok',
+            });
+            return result;
+        }
+        // Single-query modes (tables / indexes / table-comment)
+        const raw = await driver.execute(parametrized.sql, constants_1.QUERY_TIMEOUT_MS, parametrized.params);
+        let result;
+        if (mode === 'tables') {
+            result = (0, format_1.formatTablesResult)(raw, profile.name, elapsedMs(start));
+        }
+        else if (mode === 'indexes') {
+            result = (0, format_1.formatIndexesResult)(raw, table, profile.name, elapsedMs(start));
+        }
+        else {
+            result = (0, format_1.formatTableCommentResult)(raw, table, profile.name, elapsedMs(start));
+        }
+        (0, logging_1.logQuery)(projectRoot, {
+            timestamp: nowIso(),
+            profile: profile.name,
+            mode,
+            sql: parametrized.sql,
+            durationMs: elapsedMs(start),
+            rowCount: 'tables' in result ? result.tables.length : 0,
+            status: 'ok',
+        });
+        return result;
+    }
+    catch (err) {
+        recordAndRethrow(projectRoot, start, mode, profile.name, parametrized.sql, err);
+    }
+    finally {
+        await driver.close();
+    }
+}
+/**
+ * List configured profiles (spec §4.2 mode=profiles). Does NOT connect to DB.
+ */
+async function listProfiles(input, projectRoot) {
+    const start = Date.now();
+    const mode = 'profiles';
+    const cfg = (0, config_1.loadProfiles)(projectRoot);
+    if (!cfg.enabled) {
+        // Per spec §2.5: even listProfiles short-circuits when disabled.
+        recordAndRethrow(projectRoot, start, mode, '(disabled)', undefined, new errors_1.SubsystemDisabledError());
+    }
+    const result = (0, format_1.formatProfilesResult)(cfg);
+    (0, logging_1.logQuery)(projectRoot, {
+        timestamp: nowIso(),
+        profile: '(none)',
+        mode,
+        durationMs: elapsedMs(start),
+        rowCount: result.profiles.length,
+        status: 'ok',
+    });
+    void input;
+    void constants_1.MAX_LIMIT;
+    return result;
+}
+//# sourceMappingURL=executor.js.map

package/dist/dbquery/executor.js.map

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

package/dist/dbquery/format.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Result formatting — normalizes driver raw output into the unified
+ * result types (QueryResult / SchemaResult / ProfilesResult).
+ *
+ * Spec §5.1 + §6.3: BLOB/large fields are base64-encoded and truncated at
+ * MAX_FIELD_BYTES (8KB).
+ */
+import type { ProfilesConfig, ProfilesResult, QueryResult, RawResult, TablesResult, DdlResult, IndexesResult, TableCommentResult } from './types';
+export declare function formatQueryResult(raw: RawResult, profileName: string, durationMs: number, truncated: boolean): QueryResult;
+export declare function formatTablesResult(raw: RawResult, profileName: string, durationMs: number): TablesResult;
+export declare function formatDdlResult(columnRows: RawResult, primaryKeyRows: RawResult, constraintRows: RawResult, table: string, profileName: string, durationMs: number): DdlResult;
+export declare function formatIndexesResult(raw: RawResult, table: string, profileName: string, durationMs: number): IndexesResult;
+export declare function formatTableCommentResult(raw: RawResult, table: string, profileName: string, durationMs: number): TableCommentResult;
+/**
+ * Build ProfilesResult — NEVER returns password (spec §2.4).
+ */
+export declare function formatProfilesResult(config: ProfilesConfig): ProfilesResult;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/dbquery/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,kBAAkB,EAInB,MAAM,SAAS,CAAC;AAyCjB,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,WAAW,CAUb;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,YAAY,CAQd;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,EACrB,cAAc,EAAE,SAAS,EACzB,cAAc,EAAE,SAAS,EACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,SAAS,CA2BX;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,aAAa,CA0Cf;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAMpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAe3E"}

package/dist/dbquery/format.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Result formatting — normalizes driver raw output into the unified
+ * result types (QueryResult / SchemaResult / ProfilesResult).
+ *
+ * Spec §5.1 + §6.3: BLOB/large fields are base64-encoded and truncated at
+ * MAX_FIELD_BYTES (8KB).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatQueryResult = formatQueryResult;
+exports.formatTablesResult = formatTablesResult;
+exports.formatDdlResult = formatDdlResult;
+exports.formatIndexesResult = formatIndexesResult;
+exports.formatTableCommentResult = formatTableCommentResult;
+exports.formatProfilesResult = formatProfilesResult;
+const constants_1 = require("./constants");
+/** Convert Buffer / large string values. Mutates rows in place. */
+function clampFields(rows) {
+    let truncated = false;
+    for (const row of rows) {
+        for (const [key, value] of Object.entries(row)) {
+            if (Buffer.isBuffer(value)) {
+                if (value.length > constants_1.MAX_FIELD_BYTES) {
+                    row[key] = value.subarray(0, constants_1.MAX_FIELD_BYTES).toString('base64');
+                    truncated = true;
+                }
+                else {
+                    row[key] = value.toString('base64');
+                }
+            }
+            else if (typeof value === 'string') {
+                if (Buffer.byteLength(value, 'utf8') > constants_1.MAX_FIELD_BYTES) {
+                    // Truncate by bytes but at a UTF-8 char boundary.
+                    const sliced = Buffer.from(value, 'utf8').subarray(0, constants_1.MAX_FIELD_BYTES).toString('utf8');
+                    row[key] = sliced;
+                    truncated = true;
+                }
+            }
+            else if (typeof value === 'bigint') {
+                // JSON.stringify can't serialize BigInt directly.
+                row[key] = value.toString();
+            }
+            else if (value !== null && typeof value === 'object') {
+                // Dates and similar — convert to ISO string.
+                if (value instanceof Date) {
+                    row[key] = value.toISOString();
+                }
+                else {
+                    try {
+                        row[key] = JSON.parse(JSON.stringify(value));
+                    }
+                    catch {
+                        row[key] = String(value);
+                    }
+                }
+            }
+        }
+    }
+    return truncated;
+}
+function formatQueryResult(raw, profileName, durationMs, truncated) {
+    const fieldTruncated = clampFields(raw.rows);
+    return {
+        columns: raw.columns,
+        rows: raw.rows,
+        rowCount: raw.rows.length,
+        truncated: truncated || fieldTruncated,
+        profile: profileName,
+        durationMs,
+    };
+}
+function formatTablesResult(raw, profileName, durationMs) {
+    const tables = raw.rows.map(row => ({
+        name: String(row.name ?? ''),
+        comment: row.comment !== undefined && row.comment !== null && row.comment !== ''
+            ? String(row.comment)
+            : undefined,
+    }));
+    return { tables, profile: profileName, durationMs };
+}
+function formatDdlResult(columnRows, primaryKeyRows, constraintRows, table, profileName, durationMs) {
+    const columns = columnRows.rows.map(row => ({
+        name: String(row.name ?? ''),
+        dataType: String(row.data_type ?? ''),
+        nullable: String(row.nullable ?? '').toUpperCase() === 'YES' ||
+            row.nullable === true || row.nullable === 't' || row.nullable === 1,
+        defaultValue: row.default_value !== null && row.default_value !== undefined
+            ? String(row.default_value)
+            : undefined,
+        comment: row.comment !== undefined && row.comment !== null && row.comment !== ''
+            ? String(row.comment)
+            : undefined,
+    }));
+    const primaryKey = primaryKeyRows.rows
+        .map(row => String(row.column_name ?? ''))
+        .filter(Boolean);
+    const constraints = constraintRows.rows
+        .map(row => ({
+        name: String(row.name ?? ''),
+        type: String(row.type ?? ''),
+        columns: [], // MySQL constraints SQL doesn't return column list — populated for FK only if needed
+    }))
+        .filter(c => c.name);
+    return { table, columns, primaryKey, constraints, profile: profileName, durationMs };
+}
+function formatIndexesResult(raw, table, profileName, durationMs) {
+    // For MySQL: rows come as one-per-column per index. Group by index name.
+    // For PG: rows come pre-grouped with a CSV string in `columns_csv`.
+    const byName = new Map();
+    for (const row of raw.rows) {
+        const name = String(row.name ?? '');
+        if (!name)
+            continue;
+        // PG path: columns_csv is a comma-separated list of quoted column names.
+        const csv = row.columns_csv;
+        if (typeof csv === 'string') {
+            byName.set(name, {
+                name,
+                columns: csv.split(',').map(s => s.trim().replace(/^"|"$/g, '')).filter(Boolean),
+                unique: Boolean(row.is_unique),
+                type: typeof row.type === 'string' ? row.type : undefined,
+            });
+            continue;
+        }
+        // MySQL path: one row per (index, column) pair.
+        const existing = byName.get(name);
+        const column = String(row.column_name ?? '');
+        if (existing) {
+            if (column)
+                existing.columns.push(column);
+        }
+        else {
+            byName.set(name, {
+                name,
+                columns: column ? [column] : [],
+                unique: Boolean(row.is_unique),
+                type: typeof row.type === 'string' ? row.type : undefined,
+            });
+        }
+    }
+    return {
+        table,
+        indexes: Array.from(byName.values()),
+        profile: profileName,
+        durationMs,
+    };
+}
+function formatTableCommentResult(raw, table, profileName, durationMs) {
+    const first = raw.rows[0];
+    const comment = first && first.comment !== undefined && first.comment !== null
+        ? String(first.comment)
+        : null;
+    return { table, comment: comment === '' ? null : comment, profile: profileName, durationMs };
+}
+/**
+ * Build ProfilesResult — NEVER returns password (spec §2.4).
+ */
+function formatProfilesResult(config) {
+    return {
+        profiles: config.profiles.map(p => ({
+            name: p.name,
+            description: p.description,
+            type: p.type,
+            host: p.host,
+            port: p.port,
+            database: p.database,
+            hasCredentials: Boolean(p.password),
+        })),
+        defaultProfile: config.defaultProfile,
+        configSources: config.sources,
+        enabled: config.enabled,
+    };
+}
+//# sourceMappingURL=format.js.map

package/dist/dbquery/format.js.map

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

package/dist/dbquery/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Public facade for the db-query subsystem.
+ *
+ * External callers (MCP tools, CLI) MUST use this module — never reach into
+ * safety / drivers / executor internals directly. Spec §1.2 contract.
+ */
+export { runQuery, runSchema, listProfiles } from './executor';
+export type { QueryInput, QueryResult, SchemaInput, SchemaResult, ProfilesInput, ProfilesResult, DBProfile, DriverKind, QueryMode, ConfigSource, ColumnDefinition, ConstraintDefinition, IndexDefinition, TableSummary, DdlResult, IndexesResult, TableCommentResult, TablesResult, } from './types';
+export { DbQueryError, ConfigNotFoundError, ProfileNotFoundError, SafetyRejectionError, ConnectionFailedError, QueryTimeoutError, DriverError, SubsystemDisabledError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dbquery/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/dbquery/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Public facade for the db-query subsystem.
+ *
+ * External callers (MCP tools, CLI) MUST use this module — never reach into
+ * safety / drivers / executor internals directly. Spec §1.2 contract.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubsystemDisabledError = exports.DriverError = exports.QueryTimeoutError = exports.ConnectionFailedError = exports.SafetyRejectionError = exports.ProfileNotFoundError = exports.ConfigNotFoundError = exports.DbQueryError = exports.listProfiles = exports.runSchema = exports.runQuery = void 0;
+var executor_1 = require("./executor");
+Object.defineProperty(exports, "runQuery", { enumerable: true, get: function () { return executor_1.runQuery; } });
+Object.defineProperty(exports, "runSchema", { enumerable: true, get: function () { return executor_1.runSchema; } });
+Object.defineProperty(exports, "listProfiles", { enumerable: true, get: function () { return executor_1.listProfiles; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "DbQueryError", { enumerable: true, get: function () { return errors_1.DbQueryError; } });
+Object.defineProperty(exports, "ConfigNotFoundError", { enumerable: true, get: function () { return errors_1.ConfigNotFoundError; } });
+Object.defineProperty(exports, "ProfileNotFoundError", { enumerable: true, get: function () { return errors_1.ProfileNotFoundError; } });
+Object.defineProperty(exports, "SafetyRejectionError", { enumerable: true, get: function () { return errors_1.SafetyRejectionError; } });
+Object.defineProperty(exports, "ConnectionFailedError", { enumerable: true, get: function () { return errors_1.ConnectionFailedError; } });
+Object.defineProperty(exports, "QueryTimeoutError", { enumerable: true, get: function () { return errors_1.QueryTimeoutError; } });
+Object.defineProperty(exports, "DriverError", { enumerable: true, get: function () { return errors_1.DriverError; } });
+Object.defineProperty(exports, "SubsystemDisabledError", { enumerable: true, get: function () { return errors_1.SubsystemDisabledError; } });
+//# sourceMappingURL=index.js.map

package/dist/dbquery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dbquery/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,uCAA+D;AAAtD,oGAAA,QAAQ,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,wGAAA,YAAY,OAAA;AAqB1C,mCASkB;AARhB,sGAAA,YAAY,OAAA;AACZ,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,8GAAA,oBAAoB,OAAA;AACpB,+GAAA,qBAAqB,OAAA;AACrB,2GAAA,iBAAiB,OAAA;AACjB,qGAAA,WAAW,OAAA;AACX,gHAAA,sBAAsB,OAAA"}

package/dist/dbquery/init.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Initialize a db-profiles.json template at <projectRoot>/.cgraphx/.
+ *
+ * Writes a starter file with two example profiles (MySQL + PostgreSQL)
+ * containing placeholder credentials the user edits in place. Mode 0600
+ * on POSIX because the file may hold real passwords once filled in.
+ *
+ * Idempotent: by default, refuses to overwrite an existing file; pass
+ * `--force` to clobber.
+ */
+export interface InitReport {
+    projectRoot: string;
+    filePath: string;
+    action: 'created' | 'already-exists' | 'overwritten';
+}
+/** The template content. Uses placeholder passwords so the user knows to fill. */
+export declare function templateProfilesContent(): string;
+/**
+ * Write the db-profiles.json template.
+ *
+ * @param projectRoot  Project root (must already have a .cgraphx/ dir)
+ * @param opts.force   Overwrite an existing file. Default false.
+ *
+ * Behavior:
+ *   - .cgraphx/ missing → throws (caller should tell user to run `cgraphx init` first)
+ *   - File exists + !force → returns action='already-exists', no write
+ *   - File exists + force  → action='overwritten'
+ *   - File absent          → action='created'
+ */
+export declare function initDbProfiles(projectRoot: string, opts?: {
+    force?: boolean;
+}): InitReport;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/dbquery/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;CACtD;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,IAAI,MAAM,CAyBhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,UAAU,CAoC9F"}