@sigma4life/mysql-mcp-server 1.0.0

package/dist/handlers/accessible-schema.js

@@ -0,0 +1,192 @@
+import { resolveDatabase, resolveSchema } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { getAccessControlConfig, getTableConfigForSchema, isAccessControlInitialized, } from '../core/security/access-control.js';
+import { getTableInfo } from './schema.js';
+import { findTables } from './search.js';
+function requireAccessConfig(database) {
+    if (!isAccessControlInitialized()) {
+        throw new Error('Access control not configured. Set QUERY_ACCESS_CONFIG to enable accessible schema introspection.');
+    }
+    const config = getAccessControlConfig();
+    if (!config.databases[database.toUpperCase()]) {
+        throw new Error(`Database '${database}' is not configured in query access control. ` +
+            `Configured databases: ${Object.keys(config.databases).join(', ') || '(none)'}`);
+    }
+    return config;
+}
+function getConfiguredSchemas(config, database) {
+    const dbConfig = config.databases[database.toUpperCase()];
+    if (!dbConfig) {
+        return [];
+    }
+    return dbConfig.schemas ? Object.keys(dbConfig.schemas) : [database];
+}
+function isTableAccessible(tableName, tableConfig) {
+    const listLower = tableConfig.list.map((table) => table.toLowerCase());
+    const tableNameLower = tableName.toLowerCase();
+    if (tableConfig.mode === 'whitelist' && !listLower.includes(tableNameLower)) {
+        return {
+            accessible: false,
+            reason: `Table not in whitelist. Allowed tables: ${tableConfig.list.join(', ') || '(none)'}`,
+        };
+    }
+    if (tableConfig.mode === 'blacklist' && listLower.includes(tableNameLower)) {
+        return { accessible: false, reason: 'Table is in blacklist' };
+    }
+    return { accessible: true };
+}
+function findColumnPolicy(tableName, columnAccess) {
+    for (const [table, policy] of Object.entries(columnAccess)) {
+        if (table.toLowerCase() === tableName.toLowerCase()) {
+            return policy;
+        }
+    }
+    return null;
+}
+function filterColumns(columns, tableName, columnAccess) {
+    const policy = findColumnPolicy(tableName, columnAccess);
+    if (!policy) {
+        return { accessibleColumns: columns };
+    }
+    const policyColumns = policy.columns.map((column) => column.toLowerCase());
+    if (policy.mode === 'inclusion') {
+        return {
+            accessibleColumns: columns.filter((column) => policyColumns.includes(column.name.toLowerCase())),
+            allowedColumnsList: policy.columns,
+            mode: 'inclusion',
+        };
+    }
+    return {
+        accessibleColumns: columns.filter((column) => !policyColumns.includes(column.name.toLowerCase())),
+        blockedColumns: policy.columns,
+        mode: 'exclusion',
+    };
+}
+function annotateColumnsWithAccess(columns, tableName, columnAccess) {
+    const policy = findColumnPolicy(tableName, columnAccess);
+    if (!policy) {
+        return {
+            annotatedColumns: columns.map((column) => ({ ...column, isAccessible: true })),
+        };
+    }
+    const policyColumns = policy.columns.map((column) => column.toLowerCase());
+    return {
+        annotatedColumns: columns.map((column) => {
+            const listed = policyColumns.includes(column.name.toLowerCase());
+            const isAccessible = policy.mode === 'inclusion' ? listed : !listed;
+            return {
+                ...column,
+                isAccessible,
+                accessDeniedReason: isAccessible
+                    ? undefined
+                    : policy.mode === 'inclusion'
+                        ? `Column not in inclusion list. Allowed: ${policy.columns.join(', ')}`
+                        : `Column in exclusion list: ${policy.columns.join(', ')}`,
+            };
+        }),
+        mode: policy.mode,
+    };
+}
+export async function getAccessibleSchema(args) {
+    const database = resolveDatabase(args.database);
+    const schema = resolveSchema(args.schema);
+    const config = requireAccessConfig(database);
+    const notes = [];
+    const schemaConfig = getTableConfigForSchema(config, database, schema);
+    if (!schemaConfig) {
+        throw new Error(`Schema '${schema}' is not configured for query access in database '${database}'.`);
+    }
+    const { tableConfig, columnAccess } = schemaConfig;
+    const tableNames = tableConfig.mode === 'whitelist'
+        ? tableConfig.list
+        : (await findTables({ database })).map((table) => table.tableName);
+    const blacklist = tableConfig.mode === 'blacklist'
+        ? new Set(tableConfig.list.map((table) => table.toLowerCase()))
+        : new Set();
+    const accessibleTableNames = tableNames.filter((table) => !blacklist.has(table.toLowerCase()));
+    if (tableConfig.mode === 'blacklist' && tableConfig.list.length > 0) {
+        notes.push(`${tableConfig.list.length} table(s) blocked by blacklist: ${tableConfig.list.join(', ')}`);
+    }
+    const tables = [];
+    for (const tableName of accessibleTableNames) {
+        try {
+            const tableInfo = await getTableInfo({ database, table: tableName });
+            const { accessibleColumns, blockedColumns, allowedColumnsList, mode } = filterColumns(tableInfo.columns, tableInfo.name, columnAccess);
+            tables.push({
+                schema,
+                name: tableInfo.name,
+                type: tableInfo.type,
+                accessibleColumns,
+                columnAccessMode: mode,
+                blockedColumns,
+                allowedColumnsList,
+            });
+        }
+        catch (error) {
+            logger.warn(`Could not get info for table ${tableName}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    return {
+        database,
+        requireExplicitColumns: config.requireExplicitColumns,
+        configuredSchemas: getConfiguredSchemas(config, database),
+        tables,
+        notes: notes.length ? notes : undefined,
+    };
+}
+export async function getAccessibleTableInfo(args) {
+    const database = resolveDatabase(args.database);
+    const schema = resolveSchema(args.schema);
+    const config = requireAccessConfig(database);
+    let tableInfo;
+    try {
+        tableInfo = await getTableInfo({ database, table: args.table });
+    }
+    catch (error) {
+        return {
+            database,
+            schema,
+            table: args.table,
+            type: 'TABLE',
+            isAccessible: false,
+            accessDeniedReason: error instanceof Error ? error.message : String(error),
+        };
+    }
+    const schemaConfig = getTableConfigForSchema(config, database, schema);
+    if (!schemaConfig) {
+        return {
+            database,
+            schema,
+            table: tableInfo.name,
+            type: tableInfo.type,
+            isAccessible: false,
+            accessDeniedReason: `Schema '${schema}' is not configured for query access in database '${database}'`,
+        };
+    }
+    const tableAccess = isTableAccessible(tableInfo.name, schemaConfig.tableConfig);
+    if (!tableAccess.accessible) {
+        return {
+            database,
+            schema,
+            table: tableInfo.name,
+            type: tableInfo.type,
+            isAccessible: false,
+            accessDeniedReason: tableAccess.reason,
+        };
+    }
+    const { annotatedColumns, mode } = annotateColumnsWithAccess(tableInfo.columns, tableInfo.name, schemaConfig.columnAccess);
+    return {
+        database,
+        schema,
+        table: tableInfo.name,
+        type: tableInfo.type,
+        isAccessible: true,
+        columnAccessMode: mode,
+        columns: annotatedColumns,
+        indexes: tableInfo.indexes,
+        foreignKeys: tableInfo.foreignKeys,
+        accessibleColumnCount: annotatedColumns.filter((column) => column.isAccessible).length,
+        totalColumnCount: annotatedColumns.length,
+    };
+}
+//# sourceMappingURL=accessible-schema.js.map

package/dist/handlers/accessible-schema.js.map

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

package/dist/handlers/data.d.ts

@@ -0,0 +1,17 @@
+export interface DataQueryResult {
+    originalQuery: string;
+    executedQuery: string;
+    wasModified: boolean;
+    modifications: string[];
+    rows: unknown[];
+    rowCount: number;
+    executionTimeMs: number;
+    limitReached: boolean;
+    columnNames?: string[];
+}
+export declare function executeQuery(args: {
+    database?: string;
+    query: string;
+    parameters?: Record<string, unknown>;
+}): Promise<DataQueryResult>;
+//# sourceMappingURL=data.d.ts.map

package/dist/handlers/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/handlers/data.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,GAAG,OAAO,CAAC,eAAe,CAAC,CAmC3B"}

package/dist/handlers/data.js

@@ -0,0 +1,30 @@
+import { appConfig, resolveDatabase } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { enforceRowLimit, validateQuerySafety, } from '../core/query-safety.js';
+import { getAccessControlConfig, isAccessControlInitialized, validateQueryAccess, } from '../core/security/access-control.js';
+import { db } from '../mysql/connection.js';
+export async function executeQuery(args) {
+    const database = resolveDatabase(args.database);
+    const startTime = Date.now();
+    logger.info(`Executing read query on database: ${database}`);
+    validateQuerySafety(args.query);
+    if (!isAccessControlInitialized()) {
+        throw new Error('Access control not configured. Data queries are blocked until QUERY_ACCESS_CONFIG is set.');
+    }
+    validateQueryAccess(args.query, database, getAccessControlConfig());
+    const modResult = enforceRowLimit(args.query, appConfig.query.maxRows);
+    const rows = await db.query(modResult.modifiedQuery, args.parameters);
+    const executionTimeMs = Date.now() - startTime;
+    return {
+        originalQuery: args.query,
+        executedQuery: modResult.modifiedQuery,
+        wasModified: modResult.wasModified,
+        modifications: modResult.modifications,
+        rows,
+        rowCount: rows.length,
+        executionTimeMs,
+        limitReached: rows.length === modResult.appliedLimitValue,
+        columnNames: rows.length ? Object.keys(rows[0]) : [],
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/handlers/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/handlers/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAEL,eAAe,EACf,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAc5C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAIlC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,CAAC,IAAI,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;IAE7D,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEhC,IAAI,CAAC,0BAA0B,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAEpE,MAAM,SAAS,GAA4B,eAAe,CACxD,IAAI,CAAC,KAAK,EACV,SAAS,CAAC,KAAK,CAAC,OAAO,CACxB,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAE/C,OAAO;QACL,aAAa,EAAE,IAAI,CAAC,KAAK;QACzB,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,eAAe;QACf,YAAY,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,iBAAiB;QACzD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;KACrD,CAAC;AACJ,CAAC"}

package/dist/handlers/relationships.d.ts

@@ -0,0 +1,14 @@
+import { Relationship } from '../mysql/queries.js';
+interface RelationshipPath {
+    path: Relationship[];
+    joinCondition: string;
+}
+export declare function getRelationships(args: {
+    database?: string;
+    fromTable: string;
+    toTable?: string;
+    maxDepth?: number;
+    schema?: string;
+}): Promise<RelationshipPath[]>;
+export {};
+//# sourceMappingURL=relationships.d.ts.map

package/dist/handlers/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/handlers/relationships.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,UAAU,gBAAgB;IACxB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwB9B"}

package/dist/handlers/relationships.js

@@ -0,0 +1,77 @@
+import { cache } from '../core/cache.js';
+import { resolveDatabase, resolveSchema } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { getRelationships as getMysqlRelationships, } from '../mysql/queries.js';
+export async function getRelationships(args) {
+    const database = resolveDatabase(args.database);
+    resolveSchema(args.schema);
+    const { fromTable, toTable, maxDepth = 2 } = args;
+    const cacheKey = `relationships:${database}:${fromTable}:${toTable || 'all'}:${maxDepth}`;
+    const cached = cache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const relationships = await getMysqlRelationships();
+    const paths = toTable
+        ? findPaths(fromTable, toTable, relationships, maxDepth)
+        : relationships
+            .filter((rel) => rel.fromTable === fromTable || rel.toTable === fromTable)
+            .map((rel) => ({
+            path: [rel],
+            joinCondition: buildJoinCondition([rel]),
+        }));
+    cache.set(cacheKey, paths);
+    logger.info(`Found ${paths.length} relationship path(s) for ${fromTable}`);
+    return paths;
+}
+function findPaths(fromTable, toTable, relationships, maxDepth) {
+    const paths = [];
+    const visited = new Set();
+    function dfs(currentTable, currentPath, depth) {
+        if (depth > maxDepth) {
+            return;
+        }
+        if (currentTable === toTable && currentPath.length > 0) {
+            paths.push({
+                path: [...currentPath],
+                joinCondition: buildJoinCondition(currentPath),
+            });
+            return;
+        }
+        visited.add(currentTable);
+        for (const rel of relationships) {
+            if (rel.fromTable === currentTable && !visited.has(rel.toTable)) {
+                currentPath.push(rel);
+                dfs(rel.toTable, currentPath, depth + 1);
+                currentPath.pop();
+            }
+            if (rel.toTable === currentTable && !visited.has(rel.fromTable)) {
+                currentPath.push(rel);
+                dfs(rel.fromTable, currentPath, depth + 1);
+                currentPath.pop();
+            }
+        }
+        visited.delete(currentTable);
+    }
+    dfs(fromTable, [], 0);
+    return paths;
+}
+function buildJoinCondition(path) {
+    if (path.length === 0) {
+        return '';
+    }
+    const conditions = [];
+    let currentTable = path[0].fromTable;
+    for (const rel of path) {
+        if (rel.fromTable === currentTable) {
+            conditions.push(`JOIN ${rel.toTable} ON ${rel.fromTable}.${rel.fromColumn} = ${rel.toTable}.${rel.toColumn}`);
+            currentTable = rel.toTable;
+        }
+        else {
+            conditions.push(`JOIN ${rel.fromTable} ON ${rel.toTable}.${rel.toColumn} = ${rel.fromTable}.${rel.fromColumn}`);
+            currentTable = rel.fromTable;
+        }
+    }
+    return conditions.join('\n');
+}
+//# sourceMappingURL=relationships.js.map

package/dist/handlers/relationships.js.map

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

package/dist/handlers/schema.d.ts

@@ -0,0 +1,14 @@
+import { SchemaResult, TableMetadata } from '../core/schema-types.js';
+export declare function getSchema(args: {
+    database?: string;
+    tables?: string[];
+    schema?: string;
+    includeRelationships?: boolean;
+    includeStatistics?: boolean;
+}): Promise<SchemaResult>;
+export declare function getTableInfo(args: {
+    database?: string;
+    table: string;
+    schema?: string;
+}): Promise<TableMetadata>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/handlers/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/handlers/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,yBAAyB,CAAC;AAoFjC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCxB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmBzB"}

package/dist/handlers/schema.js

@@ -0,0 +1,104 @@
+import { cache } from '../core/cache.js';
+import { resolveDatabase, resolveSchema } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { getColumns, getForeignKeys, getIndexes, getPrimaryKeys, getStatistics, listTables, } from '../mysql/queries.js';
+import { validateDatabaseObject } from './validation.js';
+function byTable(rows) {
+    const map = new Map();
+    for (const row of rows) {
+        const list = map.get(row.tableName) || [];
+        list.push(row);
+        map.set(row.tableName, list);
+    }
+    return map;
+}
+async function buildMetadata(tableNames, includeRelationships = true, includeStatistics = false) {
+    const tables = await listTables(tableNames);
+    const actualTableNames = tables.map((table) => table.tableName);
+    const [columns, primaryKeys, foreignKeys, indexes, statistics] = await Promise.all([
+        getColumns(actualTableNames),
+        getPrimaryKeys(actualTableNames),
+        includeRelationships ? getForeignKeys(actualTableNames) : Promise.resolve([]),
+        getIndexes(actualTableNames),
+        includeStatistics ? getStatistics(actualTableNames) : Promise.resolve([]),
+    ]);
+    const columnsByTable = byTable(columns);
+    const pksByTable = byTable(primaryKeys);
+    const fksByTable = byTable(foreignKeys);
+    const indexesByTable = byTable(indexes);
+    const statsByTable = byTable(statistics);
+    return tables.map((table) => {
+        const metadata = {
+            schema: table.schemaName,
+            name: table.tableName,
+            type: table.tableType === 'VIEW' ? 'VIEW' : 'TABLE',
+            columns: (columnsByTable.get(table.tableName) || []).map(({ tableName: _tableName, ...column }) => ({
+                ...column,
+                nullable: Boolean(column.nullable),
+                isIdentity: Boolean(column.isIdentity),
+                isComputed: Boolean(column.isComputed),
+                isPrimaryKey: Boolean(column.isPrimaryKey),
+                isForeignKey: Boolean(column.isForeignKey),
+            })),
+            indexes: (indexesByTable.get(table.tableName) || []).map(({ tableName: _tableName, ...index }) => ({
+                ...index,
+                isUnique: Boolean(index.isUnique),
+                isPrimaryKey: Boolean(index.isPrimaryKey),
+            })),
+        };
+        const primaryKey = pksByTable.get(table.tableName)?.[0];
+        if (primaryKey) {
+            const { tableName: _tableName, ...pk } = primaryKey;
+            metadata.primaryKey = pk;
+        }
+        if (includeRelationships) {
+            metadata.foreignKeys = (fksByTable.get(table.tableName) || []).map(({ tableName: _tableName, ...fk }) => fk);
+        }
+        const stats = statsByTable.get(table.tableName)?.[0];
+        if (includeStatistics && stats) {
+            const { tableName: _tableName, ...tableStats } = stats;
+            metadata.statistics = tableStats;
+        }
+        return metadata;
+    });
+}
+export async function getSchema(args) {
+    const database = resolveDatabase(args.database);
+    resolveSchema(args.schema);
+    const { tables, includeRelationships = true, includeStatistics = false, } = args;
+    const cacheKey = `schema:${database}:${tables?.join(',') || 'all'}:${includeRelationships}:${includeStatistics}`;
+    const cached = cache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    if (tables?.length) {
+        const validation = await Promise.all(tables.map((table) => validateDatabaseObject(database, table)));
+        const missing = validation.filter((result) => !result.valid);
+        if (missing.length) {
+            throw new Error(missing.map((result) => result.message).join('\n'));
+        }
+    }
+    const result = {
+        schema: await buildMetadata(tables, includeRelationships, includeStatistics),
+    };
+    cache.set(cacheKey, result);
+    logger.info(`Retrieved schema for ${result.schema.length} objects from ${database}`);
+    return result;
+}
+export async function getTableInfo(args) {
+    const database = resolveDatabase(args.database);
+    resolveSchema(args.schema);
+    const validation = await validateDatabaseObject(database, args.table);
+    if (!validation.valid || !validation.table?.actualName) {
+        throw new Error(validation.message);
+    }
+    const tableName = validation.table.actualName.includes('.')
+        ? validation.table.actualName.split('.').pop()
+        : validation.table.actualName;
+    const metadata = await buildMetadata([tableName], true, false);
+    if (!metadata[0]) {
+        throw new Error(`Table '${args.table}' not found in database '${database}'`);
+    }
+    return metadata[0];
+}
+//# sourceMappingURL=schema.js.map

package/dist/handlers/schema.js.map

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

package/dist/handlers/search.d.ts

@@ -0,0 +1,14 @@
+import { ObjectSearchResult, TableSearchResult } from '../mysql/queries.js';
+export declare function findTables(args: {
+    database?: string;
+    pattern?: string;
+    hasColumn?: string;
+    schema?: string;
+}): Promise<TableSearchResult[]>;
+export declare function searchObjects(args: {
+    database?: string;
+    search: string;
+    schema?: string;
+    type?: string;
+}): Promise<ObjectSearchResult[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/handlers/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/handlers/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM/B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAMhC"}

package/dist/handlers/search.js

@@ -0,0 +1,18 @@
+import { resolveDatabase, resolveSchema } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { findTables as findMysqlTables, searchObjects as searchMysqlObjects, } from '../mysql/queries.js';
+export async function findTables(args) {
+    const database = resolveDatabase(args.database);
+    resolveSchema(args.schema);
+    const tables = await findMysqlTables(args.pattern, args.hasColumn);
+    logger.info(`Found ${tables.length} tables matching criteria in ${database}`);
+    return tables;
+}
+export async function searchObjects(args) {
+    const database = resolveDatabase(args.database);
+    resolveSchema(args.schema);
+    const results = await searchMysqlObjects(args.search, args.type);
+    logger.info(`Found ${results.length} matches for '${args.search}' in ${database}`);
+    return results;
+}
+//# sourceMappingURL=search.js.map

package/dist/handlers/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/handlers/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EACL,UAAU,IAAI,eAAe,EAC7B,aAAa,IAAI,kBAAkB,GAGpC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAKhC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAKnC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,iBAAiB,IAAI,CAAC,MAAM,QAAQ,QAAQ,EAAE,CAAC,CAAC;IACnF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/handlers/validation.d.ts

@@ -0,0 +1,32 @@
+export interface ValidationResult {
+    exists: boolean;
+    actualName?: string;
+    suggestions?: string[];
+    message: string;
+}
+export interface DatabaseValidation extends ValidationResult {
+    databases?: string[];
+}
+export interface SchemaValidation extends ValidationResult {
+    schemas?: string[];
+}
+export interface TableValidation extends ValidationResult {
+    tables?: Array<{
+        schema: string;
+        table: string;
+        fullName: string;
+        type?: string;
+        rowCount?: number | null;
+    }>;
+}
+export declare function validateDatabase(database?: string): Promise<DatabaseValidation>;
+export declare function validateSchema(database: string | undefined, schema?: string): Promise<SchemaValidation>;
+export declare function validateTable(database: string | undefined, table: string, schema?: string): Promise<TableValidation>;
+export declare function validateDatabaseObject(database?: string, table?: string, schema?: string): Promise<{
+    valid: boolean;
+    database: DatabaseValidation;
+    schema?: SchemaValidation;
+    table?: TableValidation;
+    message: string;
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/handlers/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/handlers/validation.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC9G;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CASrF;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ7G;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAuE1B;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IACT,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAiCD"}