truss-db-mcp 1.0.0

package/dist/lib/connection.js

@@ -0,0 +1,175 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import Database from 'better-sqlite3';
+// ── Connection State ────────────────────────────────────────────────
+let currentDb = null;
+let currentDialect = 'sqlite';
+let currentPath = null;
+// ── SQLite Connection ───────────────────────────────────────────────
+export function connectSqlite(dbPath) {
+    const absPath = resolve(dbPath);
+    if (!existsSync(absPath)) {
+        throw new Error(`Database file not found: ${absPath}`);
+    }
+    // Close existing connection
+    if (currentDb) {
+        try {
+            currentDb.close();
+        }
+        catch { /* ignore */ }
+    }
+    currentDb = new Database(absPath, { readonly: false });
+    currentDialect = 'sqlite';
+    currentPath = absPath;
+    // Enable WAL mode for better concurrency
+    currentDb.pragma('journal_mode = WAL');
+    const tables = listTableNames();
+    const version = currentDb.pragma('user_version');
+    const sqliteVersion = currentDb.prepare('SELECT sqlite_version() as v').get();
+    return {
+        connected: true,
+        dialect: 'sqlite',
+        tables,
+        version: `SQLite ${sqliteVersion.v}`,
+        path: absPath,
+    };
+}
+// ── Connection Accessors ────────────────────────────────────────────
+export function getDb() {
+    if (!currentDb) {
+        throw new Error('No database connected. Use the connect tool first.');
+    }
+    return currentDb;
+}
+export function getDialect() {
+    return currentDialect;
+}
+export function isConnected() {
+    return currentDb !== null;
+}
+export function closeConnection() {
+    if (currentDb) {
+        try {
+            currentDb.close();
+        }
+        catch { /* ignore */ }
+        currentDb = null;
+        currentPath = null;
+    }
+}
+// ── Table Operations ────────────────────────────────────────────────
+function listTableNames() {
+    const db = getDb();
+    const rows = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name").all();
+    return rows.map(r => r.name);
+}
+export function listTables() {
+    const db = getDb();
+    const tableNames = listTableNames();
+    const results = [];
+    for (const tableName of tableNames) {
+        const columns = getColumnInfo(tableName);
+        const countRow = db.prepare(`SELECT COUNT(*) as cnt FROM "${tableName}"`).get();
+        results.push({
+            name: tableName,
+            columns,
+            rowCount: countRow.cnt,
+        });
+    }
+    return results;
+}
+export function describeTable(tableName) {
+    const db = getDb();
+    // Verify table exists
+    const exists = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name = ?").get(tableName);
+    if (!exists) {
+        throw new Error(`Table "${tableName}" not found.`);
+    }
+    const columns = getColumnInfo(tableName);
+    const indexes = getIndexInfo(tableName);
+    const foreignKeys = getForeignKeyInfo(tableName);
+    const countRow = db.prepare(`SELECT COUNT(*) as cnt FROM "${tableName}"`).get();
+    // Get CREATE TABLE statement
+    const createRow = db.prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name = ?").get(tableName);
+    return {
+        name: tableName,
+        columns,
+        rowCount: countRow.cnt,
+        indexes,
+        foreignKeys,
+        createSql: createRow.sql,
+    };
+}
+function getColumnInfo(tableName) {
+    const db = getDb();
+    const rows = db.pragma(`table_info("${tableName}")`);
+    return rows.map(r => ({
+        name: r.name,
+        type: r.type || 'ANY',
+        nullable: r.notnull === 0,
+        defaultValue: r.dflt_value,
+        primaryKey: r.pk > 0,
+    }));
+}
+function getIndexInfo(tableName) {
+    const db = getDb();
+    const indexes = db.pragma(`index_list("${tableName}")`);
+    return indexes.map(idx => {
+        const cols = db.pragma(`index_info("${idx.name}")`);
+        return {
+            name: idx.name,
+            columns: cols.map(c => c.name),
+            unique: idx.unique === 1,
+        };
+    });
+}
+function getForeignKeyInfo(tableName) {
+    const db = getDb();
+    const fks = db.pragma(`foreign_key_list("${tableName}")`);
+    return fks.map(fk => ({
+        column: fk.from,
+        referencedTable: fk.table,
+        referencedColumn: fk.to,
+    }));
+}
+// ── Query Execution ─────────────────────────────────────────────────
+const WRITE_PATTERN = /^\s*(INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|TRUNCATE|REPLACE|MERGE)\b/i;
+export function isWriteQuery(sql) {
+    return WRITE_PATTERN.test(sql);
+}
+export function executeQuery(sql, params = []) {
+    const db = getDb();
+    const start = performance.now();
+    const stmt = db.prepare(sql);
+    let rows;
+    if (isWriteQuery(sql)) {
+        const info = stmt.run(...params);
+        rows = [{ changes: info.changes, lastInsertRowid: Number(info.lastInsertRowid) }];
+    }
+    else {
+        rows = stmt.all(...params);
+    }
+    const executionTimeMs = Math.round((performance.now() - start) * 100) / 100;
+    // Extract column names
+    const columns = rows.length > 0 ? Object.keys(rows[0]) : [];
+    return {
+        rows,
+        columns,
+        rowCount: rows.length,
+        executionTimeMs,
+    };
+}
+export function executeReadOnlyQuery(sql, params = []) {
+    if (isWriteQuery(sql)) {
+        throw new Error('Write operations (INSERT, UPDATE, DELETE, DROP, ALTER, CREATE, TRUNCATE) are not allowed in free tier. ' +
+            'Upgrade to Pro for full write access: https://truss.dev/pricing');
+    }
+    return executeQuery(sql, params);
+}
+// ── EXPLAIN ─────────────────────────────────────────────────────────
+export function explainQuery(sql) {
+    const db = getDb();
+    const rows = db.prepare(`EXPLAIN QUERY PLAN ${sql}`).all();
+    return rows.map(r => `${' '.repeat(r.id * 2)}${r.detail}`).join('\n');
+}
+//# sourceMappingURL=connection.js.map

package/dist/lib/connection.js.map

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

package/dist/lib/license.d.ts

@@ -0,0 +1,4 @@
+import type { LicenseStatus } from '../types.js';
+export declare function getLicenseStatus(): Promise<LicenseStatus>;
+export declare function requirePro(): Promise<void>;
+//# sourceMappingURL=license.d.ts.map

package/dist/lib/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/lib/license.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,aAAa,CAAC;AAuE9D,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAiC/D;AAED,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAQhD"}

package/dist/lib/license.js

@@ -0,0 +1,94 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getConfig, getDataDir } from './config.js';
+const CACHE_FILE = 'db-license-cache.json';
+const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+function getCachePath() {
+    return join(getDataDir(), CACHE_FILE);
+}
+function readCache() {
+    try {
+        const raw = readFileSync(getCachePath(), 'utf-8');
+        const cache = JSON.parse(raw);
+        if (Date.now() - cache.cachedAt < CACHE_TTL_MS) {
+            return cache;
+        }
+        return null; // expired
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(cache) {
+    try {
+        writeFileSync(getCachePath(), JSON.stringify(cache, null, 2));
+    }
+    catch {
+        // non-fatal
+    }
+}
+function isValidKeyFormat(key) {
+    return /^truss_[0-9a-f]{32}$/.test(key);
+}
+async function validateRemote(key) {
+    const config = getConfig();
+    const url = `${config.trussApiBaseUrl}/validate/${key}`;
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': 'truss-db-mcp/1.0.0',
+            },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            return { valid: false, expiresAt: null };
+        }
+        const body = await response.json();
+        return {
+            valid: body.valid === true,
+            expiresAt: body.expires_at ?? null,
+        };
+    }
+    catch {
+        // Network error -- fall back to format check + cache
+        return { valid: isValidKeyFormat(key), expiresAt: null };
+    }
+}
+export async function getLicenseStatus() {
+    const config = getConfig();
+    const key = config.licenseKey;
+    // No key -> free tier
+    if (!key) {
+        return { tier: 'free', valid: true, expiresAt: null };
+    }
+    // Format check
+    if (!isValidKeyFormat(key)) {
+        return { tier: 'free', valid: false, expiresAt: null };
+    }
+    // Check cache first
+    const cached = readCache();
+    if (cached && cached.key === key) {
+        return { tier: cached.tier, valid: cached.valid, expiresAt: cached.expiresAt };
+    }
+    // Remote validation
+    const result = await validateRemote(key);
+    const tier = result.valid ? 'pro' : 'free';
+    writeCache({
+        key,
+        valid: result.valid,
+        tier,
+        expiresAt: result.expiresAt,
+        cachedAt: Date.now(),
+    });
+    return { tier, valid: result.valid, expiresAt: result.expiresAt };
+}
+export async function requirePro() {
+    const status = await getLicenseStatus();
+    if (status.tier !== 'pro') {
+        throw new Error('This feature requires a TRUSS Pro license ($25/mo). ' +
+            'Get yours at https://truss.dev/pricing and set TRUSS_LICENSE_KEY.');
+    }
+}
+//# sourceMappingURL=license.js.map

package/dist/lib/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../src/lib/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAC3C,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAUvD,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;QAC9C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,CAAC,UAAU;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB;IACrC,IAAI,CAAC;QACH,aAAa,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAW;IACvC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,eAAe,aAAa,GAAG,EAAE,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;gBAC5B,YAAY,EAAE,oBAAoB;aACnC;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC3C,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA6C,CAAC;QAC9E,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;YAC1B,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;SACnC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;QACrD,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;IAE9B,sBAAsB;IACtB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,eAAe;IACf,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,IAAI,MAAM,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IACjF,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAgB,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAExD,UAAU,CAAC;QACT,GAAG;QACH,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,sDAAsD;YACtD,mEAAmE,CACpE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/query-optimizer.d.ts

@@ -0,0 +1,3 @@
+import type { QueryOptimizationResult } from '../types.js';
+export declare function optimizeQuery(sql: string): QueryOptimizationResult;
+//# sourceMappingURL=query-optimizer.d.ts.map

package/dist/lib/query-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-optimizer.d.ts","sourceRoot":"","sources":["../../src/lib/query-optimizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,aAAa,CAAC;AAEnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAUlE"}

package/dist/lib/query-optimizer.js

@@ -0,0 +1,155 @@
+import { explainQuery, getDb } from './connection.js';
+export function optimizeQuery(sql) {
+    const explainPlan = explainQuery(sql);
+    const suggestions = analyzeExplainPlan(explainPlan, sql);
+    const estimatedImprovement = estimateImprovement(suggestions);
+    return {
+        explainPlan,
+        suggestions,
+        estimatedImprovement,
+    };
+}
+function analyzeExplainPlan(plan, sql) {
+    const suggestions = [];
+    const lines = plan.split('\n');
+    // Detect full table scans
+    const scanPattern = /SCAN (?:TABLE )?(\w+)/gi;
+    const scannedTables = new Set();
+    for (const line of lines) {
+        let match;
+        while ((match = scanPattern.exec(line)) !== null) {
+            scannedTables.add(match[1]);
+        }
+    }
+    // For each full scan, check if WHERE clause references columns that could be indexed
+    if (scannedTables.size > 0) {
+        const whereColumns = extractWhereColumns(sql);
+        for (const table of scannedTables) {
+            const tableCols = whereColumns.filter(wc => {
+                // Column might be qualified (table.col) or unqualified
+                return wc.table === table || wc.table === null;
+            });
+            if (tableCols.length > 0) {
+                const existingIndexes = getExistingIndexes(table);
+                const indexedColumns = new Set(existingIndexes.flatMap(idx => idx.columns));
+                for (const col of tableCols) {
+                    if (!indexedColumns.has(col.column)) {
+                        suggestions.push({
+                            type: 'index',
+                            description: `Table "${table}" is doing a full scan. Consider adding an index on column "${col.column}" used in WHERE clause.`,
+                            sql: `CREATE INDEX idx_${table}_${col.column} ON "${table}"("${col.column}");`,
+                        });
+                    }
+                }
+                if (tableCols.length === 0) {
+                    suggestions.push({
+                        type: 'warning',
+                        description: `Full table scan on "${table}". This may be intentional if you need all rows, but can be slow on large tables.`,
+                    });
+                }
+            }
+            else {
+                suggestions.push({
+                    type: 'warning',
+                    description: `Full table scan on "${table}". No WHERE clause filtering detected for this table.`,
+                });
+            }
+        }
+    }
+    // Detect subquery patterns that could be JOINs
+    if (/\bIN\s*\(\s*SELECT\b/i.test(sql)) {
+        suggestions.push({
+            type: 'rewrite',
+            description: 'Consider rewriting IN (SELECT ...) as a JOIN, which is often faster for large datasets.',
+        });
+    }
+    // Detect SELECT * usage
+    if (/SELECT\s+\*/i.test(sql)) {
+        suggestions.push({
+            type: 'rewrite',
+            description: 'Consider selecting only the columns you need instead of SELECT *. This reduces I/O and memory usage.',
+        });
+    }
+    // Detect missing LIMIT
+    if (!/\bLIMIT\b/i.test(sql) && /^\s*SELECT\b/i.test(sql)) {
+        suggestions.push({
+            type: 'warning',
+            description: 'Query has no LIMIT clause. For large tables, consider adding LIMIT to avoid returning excessive rows.',
+        });
+    }
+    // Detect LIKE with leading wildcard
+    if (/LIKE\s+['"]%/i.test(sql)) {
+        suggestions.push({
+            type: 'warning',
+            description: 'LIKE pattern with leading wildcard (%) prevents index usage. Consider full-text search for better performance.',
+        });
+    }
+    // Detect ORDER BY without index
+    const orderByMatch = sql.match(/ORDER\s+BY\s+(\w+(?:\.\w+)?)/i);
+    if (orderByMatch) {
+        const orderCol = orderByMatch[1].includes('.') ? orderByMatch[1].split('.')[1] : orderByMatch[1];
+        suggestions.push({
+            type: 'index',
+            description: `If sorting is slow, consider indexing the ORDER BY column "${orderCol}".`,
+        });
+    }
+    // If no scan detected, query uses indexes well
+    if (scannedTables.size === 0 && suggestions.length === 0) {
+        suggestions.push({
+            type: 'rewrite',
+            description: 'Query already uses indexes effectively. No major optimizations needed.',
+        });
+    }
+    return suggestions;
+}
+function extractWhereColumns(sql) {
+    const columns = [];
+    // Match WHERE and AND/OR conditions
+    const whereMatch = sql.match(/WHERE\s+([\s\S]*?)(?:ORDER\s+BY|GROUP\s+BY|HAVING|LIMIT|$)/i);
+    if (!whereMatch)
+        return columns;
+    const whereClause = whereMatch[1];
+    // Extract column references from conditions
+    const colPattern = /(\w+)\.(\w+)\s*(?:=|!=|<>|>=|<=|>|<|LIKE|IN|IS|BETWEEN)/gi;
+    let match;
+    while ((match = colPattern.exec(whereClause)) !== null) {
+        columns.push({ table: match[1], column: match[2] });
+    }
+    // Also match unqualified columns
+    const unqualPattern = /(?:^|\bAND\b|\bOR\b|\bWHERE\b)\s+(\w+)\s*(?:=|!=|<>|>=|<=|>|<|LIKE|IN|IS|BETWEEN)/gi;
+    while ((match = unqualPattern.exec(whereClause)) !== null) {
+        if (!['AND', 'OR', 'NOT', 'WHERE', 'BETWEEN', 'IN', 'LIKE', 'IS'].includes(match[1].toUpperCase())) {
+            columns.push({ table: null, column: match[1] });
+        }
+    }
+    return columns;
+}
+function getExistingIndexes(tableName) {
+    try {
+        const db = getDb();
+        const indexes = db.pragma(`index_list("${tableName}")`);
+        return indexes.map(idx => {
+            const cols = db.pragma(`index_info("${idx.name}")`);
+            return { name: idx.name, columns: cols.map(c => c.name) };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function estimateImprovement(suggestions) {
+    const indexSuggestions = suggestions.filter(s => s.type === 'index').length;
+    const rewriteSuggestions = suggestions.filter(s => s.type === 'rewrite').length;
+    const warnings = suggestions.filter(s => s.type === 'warning').length;
+    if (indexSuggestions === 0 && rewriteSuggestions === 0) {
+        return 'Query is already well-optimized.';
+    }
+    if (indexSuggestions > 0) {
+        return `Adding ${indexSuggestions} index(es) could improve performance significantly, especially on large tables (10x-100x for indexed lookups vs full scans).`;
+    }
+    if (rewriteSuggestions > 0) {
+        return 'Query rewrite may improve performance by 2x-10x depending on data size.';
+    }
+    return 'Minor optimizations possible. See suggestions for details.';
+}
+//# sourceMappingURL=query-optimizer.js.map

package/dist/lib/query-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-optimizer.js","sourceRoot":"","sources":["../../src/lib/query-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAC;AAGlE,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAE9D,OAAO;QACL,WAAW;QACX,WAAW;QACX,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,GAAW;IACnD,MAAM,WAAW,GAA6B,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,0BAA0B;IAC1B,MAAM,WAAW,GAAG,yBAAyB,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC;QACV,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACjD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,qFAAqF;IACrF,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAE9C,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBACzC,uDAAuD;gBACvD,OAAO,EAAE,CAAC,KAAK,KAAK,KAAK,IAAI,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;YACjD,CAAC,CAAC,CAAC;YAEH,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAClD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;gBAE5E,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;oBAC5B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBACpC,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI,EAAE,OAAO;4BACb,WAAW,EAAE,UAAU,KAAK,+DAA+D,GAAG,CAAC,MAAM,yBAAyB;4BAC9H,GAAG,EAAE,oBAAoB,KAAK,IAAI,GAAG,CAAC,MAAM,QAAQ,KAAK,MAAM,GAAG,CAAC,MAAM,KAAK;yBAC/E,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,WAAW,CAAC,IAAI,CAAC;wBACf,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,uBAAuB,KAAK,mFAAmF;qBAC7H,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,uBAAuB,KAAK,uDAAuD;iBACjG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yFAAyF;SACvG,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,sGAAsG;SACpH,CAAC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzD,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,uGAAuG;SACrH,CAAC,CAAC;IACL,CAAC;IAED,oCAAoC;IACpC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,gHAAgH;SAC9H,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAChE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjG,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,8DAA8D,QAAQ,IAAI;SACxF,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,IAAI,aAAa,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,WAAW,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wEAAwE;SACtF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAOD,SAAS,mBAAmB,CAAC,GAAW;IACtC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,oCAAoC;IACpC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;IAC5F,IAAI,CAAC,UAAU;QAAE,OAAO,OAAO,CAAC;IAEhC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAElC,4CAA4C;IAC5C,MAAM,UAAU,GAAG,2DAA2D,CAAC;IAC/E,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,iCAAiC;IACjC,MAAM,aAAa,GAAG,qFAAqF,CAAC;IAC5G,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACnG,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,SAAS,IAAI,CAGpD,CAAC;QAEH,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACvB,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,GAAG,CAAC,IAAI,IAAI,CAA4B,CAAC;YAC/E,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAqC;IAChE,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAC5E,MAAM,kBAAkB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAChF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEtE,IAAI,gBAAgB,KAAK,CAAC,IAAI,kBAAkB,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IAED,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,gBAAgB,8HAA8H,CAAC;IAClK,CAAC;IAED,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,yEAAyE,CAAC;IACnF,CAAC;IAED,OAAO,4DAA4D,CAAC;AACtE,CAAC"}

package/dist/tools/connect.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerConnect(server: McpServer): void;
+//# sourceMappingURL=connect.d.ts.map

package/dist/tools/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/tools/connect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsCvD"}

package/dist/tools/connect.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { connectSqlite } from '../lib/connection.js';
+export function registerConnect(server) {
+    server.tool('connect', 'Connect to a SQLite database file. Provide the path to the .db or .sqlite file.', {
+        path: z.string().describe('Path to the SQLite database file'),
+    }, async ({ path }) => {
+        try {
+            const info = connectSqlite(path);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            connected: info.connected,
+                            dialect: info.dialect,
+                            tables: info.tables,
+                            tableCount: info.tables.length,
+                            version: info.version,
+                            path: info.path,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            connected: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=connect.js.map

package/dist/tools/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/tools/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,IAAI,CACT,SAAS,EACT,iFAAiF,EACjF;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAC9D,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAEjC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,IAAI,CAAC,SAAS;4BACzB,OAAO,EAAE,IAAI,CAAC,OAAO;4BACrB,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;4BAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;4BACrB,IAAI,EAAE,IAAI,CAAC,IAAI;yBAChB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,SAAS,EAAE,KAAK;4BAChB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,CAAC;qBACH,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/describe-table.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDescribeTable(server: McpServer): void;
+//# sourceMappingURL=describe-table.d.ts.map

package/dist/tools/describe-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.d.ts","sourceRoot":"","sources":["../../src/tools/describe-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8D7D"}

package/dist/tools/describe-table.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { describeTable, isConnected } from '../lib/connection.js';
+export function registerDescribeTable(server) {
+    server.tool('describe_table', 'Get detailed schema for a table: columns, types, indexes, foreign keys, and CREATE statement.', {
+        table: z.string().describe('Name of the table to describe'),
+    }, async ({ table }) => {
+        try {
+            if (!isConnected()) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'No database connected. Use the connect tool first.',
+                            }),
+                        }],
+                    isError: true,
+                };
+            }
+            const schema = describeTable(table);
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            name: schema.name,
+                            row_count: schema.rowCount,
+                            columns: schema.columns.map(c => ({
+                                name: c.name,
+                                type: c.type,
+                                nullable: c.nullable,
+                                default_value: c.defaultValue,
+                                primary_key: c.primaryKey,
+                            })),
+                            indexes: schema.indexes.map(i => ({
+                                name: i.name,
+                                columns: i.columns,
+                                unique: i.unique,
+                            })),
+                            foreign_keys: schema.foreignKeys.map(fk => ({
+                                column: fk.column,
+                                references: `${fk.referencedTable}(${fk.referencedColumn})`,
+                            })),
+                            create_sql: schema.createSql,
+                        }, null, 2),
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: err instanceof Error ? err.message : String(err),
+                        }),
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=describe-table.js.map

package/dist/tools/describe-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-table.js","sourceRoot":"","sources":["../../src/tools/describe-table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,+FAA+F,EAC/F;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KAC5D,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,oDAAoD;6BAC5D,CAAC;yBACH,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YAEpC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,SAAS,EAAE,MAAM,CAAC,QAAQ;4BAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gCAChC,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gCACpB,aAAa,EAAE,CAAC,CAAC,YAAY;gCAC7B,WAAW,EAAE,CAAC,CAAC,UAAU;6BAC1B,CAAC,CAAC;4BACH,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gCAChC,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gCAClB,MAAM,EAAE,CAAC,CAAC,MAAM;6BACjB,CAAC,CAAC;4BACH,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gCAC1C,MAAM,EAAE,EAAE,CAAC,MAAM;gCACjB,UAAU,EAAE,GAAG,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,gBAAgB,GAAG;6BAC5D,CAAC,CAAC;4BACH,UAAU,EAAE,MAAM,CAAC,SAAS;yBAC7B,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,CAAC;qBACH,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/export-data.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerExportData(server: McpServer): void;
+//# sourceMappingURL=export-data.d.ts.map

package/dist/tools/export-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-data.d.ts","sourceRoot":"","sources":["../../src/tools/export-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyD1D"}