mcp-database-inspector 2.0.1

package/dist/tools/list-tables.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { InputValidator } from '../validators/input-validator.js';
+import { Logger } from '../utils/logger.js';
+import { ToolError } from '../utils/errors.js';
+// Tool schema
+const ListTablesArgsSchema = z.object({
+    database: z.string().min(1, 'Database name is required')
+});
+export const listTablesToolDefinition = {
+    name: 'list_tables',
+    description: 'List all tables in the specified database with metadata',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            database: {
+                type: 'string',
+                description: 'Name of the database to list tables from'
+            }
+        },
+        required: ['database']
+    }
+};
+export async function handleListTables(args, dbManager) {
+    try {
+        Logger.info('Executing list_tables tool');
+        // Validate arguments
+        const validationResult = ListTablesArgsSchema.safeParse(args);
+        if (!validationResult.success) {
+            Logger.warn('Invalid arguments for list_tables', validationResult.error);
+            throw new ToolError(`Invalid arguments: ${validationResult.error.issues.map(e => `${e.path.join('.')}: ${e.message}`).join(', ')}`, 'list_tables');
+        }
+        const { database } = validationResult.data;
+        // Sanitize database name
+        const sanitizedDatabase = InputValidator.sanitizeString(database);
+        // Validate database name format
+        const dbNameValidation = InputValidator.validateDatabaseName(sanitizedDatabase);
+        if (!dbNameValidation.isValid) {
+            throw new ToolError(`Invalid database name: ${dbNameValidation.error}`, 'list_tables');
+        }
+        Logger.info(`Listing tables for database: ${sanitizedDatabase}`);
+        Logger.time('list_tables_execution');
+        // Get tables from database
+        const tables = await dbManager.getTables(sanitizedDatabase);
+        Logger.timeEnd('list_tables_execution');
+        Logger.info(`Found ${tables.length} tables in database: ${sanitizedDatabase}`);
+        // Group tables by type
+        const tablesByType = tables.reduce((acc, table) => {
+            const type = table.tableType;
+            if (!acc[type]) {
+                acc[type] = [];
+            }
+            acc[type].push(table);
+            return acc;
+        }, {});
+        // Calculate statistics
+        const stats = {
+            totalTables: tables.length,
+            baseTables: (tablesByType['BASE TABLE'] || []).length,
+            views: (tablesByType['VIEW'] || []).length,
+            systemTables: (tablesByType['SYSTEM TABLE'] || []).length,
+            totalEstimatedRows: tables.reduce((sum, table) => sum + (table.tableRows || 0), 0)
+        };
+        // Format response
+        const response = {
+            database: sanitizedDatabase,
+            tables: tables.map(table => ({
+                name: table.tableName,
+                type: table.tableType,
+                engine: table.engine,
+                estimatedRows: table.tableRows,
+                comment: table.tableComment,
+                category: table.tableType === 'BASE TABLE' ? 'table' :
+                    table.tableType === 'VIEW' ? 'view' :
+                        'system'
+            })),
+            statistics: stats,
+            tablesByType: Object.keys(tablesByType).map(type => ({
+                type,
+                count: tablesByType[type].length,
+                tables: tablesByType[type].map(t => t.tableName)
+            })),
+            summary: {
+                hasData: tables.length > 0,
+                message: tables.length === 0
+                    ? `No tables found in database '${sanitizedDatabase}'. Database may be empty or inaccessible.`
+                    : `Found ${tables.length} table(s) in database '${sanitizedDatabase}': ${stats.baseTables} base tables, ${stats.views} views.`
+            }
+        };
+        Logger.debug('list_tables completed successfully', {
+            database: sanitizedDatabase,
+            tableCount: tables.length,
+            baseTables: stats.baseTables,
+            views: stats.views
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify(response, null, 2)
+                }]
+        };
+    }
+    catch (error) {
+        Logger.error('Error in list_tables tool', error);
+        if (error instanceof ToolError) {
+            throw error;
+        }
+        throw new ToolError(`Failed to list tables: ${error instanceof Error ? error.message : 'Unknown error'}`, 'list_tables', error instanceof Error ? error : undefined);
+    }
+}
+export async function getTablesSummary(dbManager, database) {
+    try {
+        const tables = await dbManager.getTables(database);
+        const baseTables = tables.filter(t => t.tableType === 'BASE TABLE').length;
+        const views = tables.filter(t => t.tableType === 'VIEW').length;
+        if (tables.length === 0) {
+            return `Database '${database}' has no tables`;
+        }
+        const parts = [];
+        if (baseTables > 0)
+            parts.push(`${baseTables} table(s)`);
+        if (views > 0)
+            parts.push(`${views} view(s)`);
+        return `Database '${database}' contains ${parts.join(', ')}: ${tables.slice(0, 5).map(t => t.tableName).join(', ')}${tables.length > 5 ? `, and ${tables.length - 5} more` : ''}`;
+    }
+    catch (error) {
+        Logger.error(`Error getting table summary for ${database}`, error);
+        return `Error retrieving tables for database '${database}'`;
+    }
+}
+//# sourceMappingURL=list-tables.js.map

package/dist/tools/list-tables.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,32 @@
+export declare class DatabaseError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+export declare class ValidationError extends Error {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+export declare class ConnectionError extends DatabaseError {
+    readonly host?: string | undefined;
+    readonly port?: number | undefined;
+    constructor(message: string, host?: string | undefined, port?: number | undefined, cause?: Error);
+}
+export declare class QueryError extends DatabaseError {
+    readonly query?: string | undefined;
+    constructor(message: string, query?: string | undefined, cause?: Error);
+}
+export declare class ConfigurationError extends Error {
+    readonly configKey?: string | undefined;
+    constructor(message: string, configKey?: string | undefined);
+}
+export declare class ToolError extends Error {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined, cause?: Error);
+}
+export declare function isRecoverableError(error: Error): boolean;
+export declare function sanitizeErrorMessage(error: Error): string;
+export declare function createErrorResponse(error: Error): {
+    error: string;
+    code?: string;
+};
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aACO,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAQ3D;AAED,qBAAa,eAAgB,SAAQ,KAAK;aACK,KAAK,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA;CAI5D;AAED,qBAAa,eAAgB,SAAQ,aAAa;aACH,IAAI,CAAC,EAAE,MAAM;aAAkB,IAAI,CAAC,EAAE,MAAM;gBAA7E,OAAO,EAAE,MAAM,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA,EAAkB,IAAI,CAAC,EAAE,MAAM,YAAA,EAAE,KAAK,CAAC,EAAE,KAAK;CAIzG;AAED,qBAAa,UAAW,SAAQ,aAAa;aACE,KAAK,CAAC,EAAE,MAAM;gBAA/C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,MAAM,YAAA,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3E;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aACE,SAAS,CAAC,EAAE,MAAM;gBAAnD,OAAO,EAAE,MAAM,EAAkB,SAAS,CAAC,EAAE,MAAM,YAAA;CAIhE;AAED,qBAAa,SAAU,SAAQ,KAAK;aACW,QAAQ,CAAC,EAAE,MAAM;gBAAlD,OAAO,EAAE,MAAM,EAAkB,QAAQ,CAAC,EAAE,MAAM,YAAA,EAAE,KAAK,CAAC,EAAE,KAAK;CAQ9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAexD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CASzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAwBlF"}

package/dist/utils/errors.js

@@ -0,0 +1,98 @@
+export class DatabaseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'DatabaseError';
+        if (cause) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+}
+export class ValidationError extends Error {
+    field;
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+export class ConnectionError extends DatabaseError {
+    host;
+    port;
+    constructor(message, host, port, cause) {
+        super(message, cause);
+        this.host = host;
+        this.port = port;
+        this.name = 'ConnectionError';
+    }
+}
+export class QueryError extends DatabaseError {
+    query;
+    constructor(message, query, cause) {
+        super(message, cause);
+        this.query = query;
+        this.name = 'QueryError';
+    }
+}
+export class ConfigurationError extends Error {
+    configKey;
+    constructor(message, configKey) {
+        super(message);
+        this.configKey = configKey;
+        this.name = 'ConfigurationError';
+    }
+}
+export class ToolError extends Error {
+    toolName;
+    constructor(message, toolName, cause) {
+        super(message);
+        this.toolName = toolName;
+        this.name = 'ToolError';
+        if (cause) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+}
+export function isRecoverableError(error) {
+    // Determine if an error is recoverable (temporary) or fatal
+    if (error instanceof ConnectionError) {
+        // Network timeouts, temporary connection issues
+        return error.message.includes('timeout') ||
+            error.message.includes('ECONNREFUSED') ||
+            error.message.includes('ENOTFOUND');
+    }
+    if (error instanceof QueryError) {
+        // Syntax errors are not recoverable, but timeouts might be
+        return error.message.includes('timeout');
+    }
+    return false;
+}
+export function sanitizeErrorMessage(error) {
+    // Remove sensitive information from error messages
+    let message = error.message;
+    // Remove password information from connection strings
+    message = message.replace(/password=[^&\s]+/gi, 'password=***');
+    message = message.replace(/:([^@\s]+)@/g, ':***@');
+    return message;
+}
+export function createErrorResponse(error) {
+    const sanitized = sanitizeErrorMessage(error);
+    if (error instanceof ValidationError) {
+        return { error: sanitized, code: 'VALIDATION_ERROR' };
+    }
+    if (error instanceof ConnectionError) {
+        return { error: sanitized, code: 'CONNECTION_ERROR' };
+    }
+    if (error instanceof QueryError) {
+        return { error: sanitized, code: 'QUERY_ERROR' };
+    }
+    if (error instanceof DatabaseError) {
+        return { error: sanitized, code: 'DATABASE_ERROR' };
+    }
+    if (error instanceof ToolError) {
+        return { error: sanitized, code: 'TOOL_ERROR' };
+    }
+    return { error: sanitized, code: 'UNKNOWN_ERROR' };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACO;IAA7C,YAAY,OAAe,EAAkB,KAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAQ;QAExD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAE5B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACK;IAA7C,YAAY,OAAe,EAAkB,KAAc;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAS;QAEzD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IACH;IAA+B;IAA5E,YAAY,OAAe,EAAkB,IAAa,EAAkB,IAAa,EAAE,KAAa;QACtG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAS;QAAkB,SAAI,GAAJ,IAAI,CAAS;QAEvF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,aAAa;IACE;IAA7C,YAAY,OAAe,EAAkB,KAAc,EAAE,KAAa;QACxE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAS;QAEzD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACE;IAA7C,YAAY,OAAe,EAAkB,SAAkB;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,cAAS,GAAT,SAAS,CAAS;QAE7D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IACW;IAA7C,YAAY,OAAe,EAAkB,QAAiB,EAAE,KAAa;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,aAAQ,GAAR,QAAQ,CAAS;QAE5D,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,4DAA4D;IAC5D,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,gDAAgD;QAChD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YACjC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;YACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,2DAA2D;QAC3D,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAC/C,mDAAmD;IACnD,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAE5B,sDAAsD;IACtD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;IAChE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAClD,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACrD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,28 @@
+interface LogEntry {
+    timestamp: string;
+    level: string;
+    message: string;
+    data?: any;
+}
+export declare class Logger {
+    private static logLevel;
+    private static logs;
+    private static maxLogs;
+    static setLogLevel(level: 'error' | 'warn' | 'info' | 'debug' | 'trace'): void;
+    static getLogLevel(): string;
+    private static shouldLog;
+    private static addLog;
+    private static formatLog;
+    static error(message: string, data?: any): void;
+    static warn(message: string, data?: any): void;
+    static info(message: string, data?: any): void;
+    static debug(message: string, data?: any): void;
+    static trace(message: string, data?: any): void;
+    static getLogs(limit?: number): LogEntry[];
+    static clearLogs(): void;
+    static time(label: string): void;
+    static timeEnd(label: string): void;
+    static safeLog(level: 'error' | 'warn' | 'info' | 'debug' | 'trace', message: string, data?: any): void;
+}
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAQA,UAAU,QAAQ;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAQ;IAE9B,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI;IAW9E,MAAM,CAAC,WAAW,IAAI,MAAM;IAK5B,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB,OAAO,CAAC,MAAM,CAAC,MAAM;IAoBrB,OAAO,CAAC,MAAM,CAAC,SAAS;IAWxB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAM/C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAM9C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAM9C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAM/C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAM/C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAO1C,MAAM,CAAC,SAAS,IAAI,IAAI;IAKxB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOnC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAyBxG"}

package/dist/utils/logger.js

@@ -0,0 +1,132 @@
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+    LogLevel[LogLevel["TRACE"] = 4] = "TRACE";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    static logLevel = LogLevel.INFO;
+    static logs = [];
+    static maxLogs = 1000;
+    static setLogLevel(level) {
+        const levelMap = {
+            error: LogLevel.ERROR,
+            warn: LogLevel.WARN,
+            info: LogLevel.INFO,
+            debug: LogLevel.DEBUG,
+            trace: LogLevel.TRACE
+        };
+        this.logLevel = levelMap[level] ?? LogLevel.INFO;
+    }
+    static getLogLevel() {
+        const levelNames = ['error', 'warn', 'info', 'debug', 'trace'];
+        return levelNames[this.logLevel] || 'info';
+    }
+    static shouldLog(level) {
+        return level <= this.logLevel;
+    }
+    static addLog(level, message, data) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            data
+        };
+        this.logs.push(entry);
+        // Keep only the most recent logs
+        if (this.logs.length > this.maxLogs) {
+            this.logs = this.logs.slice(-this.maxLogs);
+        }
+        // Output to stderr to avoid interfering with MCP protocol on stdout
+        const logMessage = this.formatLog(entry);
+        console.error(logMessage);
+    }
+    static formatLog(entry) {
+        const timestamp = entry.timestamp.split('T')[1].split('.')[0]; // HH:MM:SS format
+        let message = `[${timestamp}] ${entry.level.toUpperCase()}: ${entry.message}`;
+        if (entry.data !== undefined) {
+            message += ` ${JSON.stringify(entry.data)}`;
+        }
+        return message;
+    }
+    static error(message, data) {
+        if (this.shouldLog(LogLevel.ERROR)) {
+            this.addLog('error', message, data);
+        }
+    }
+    static warn(message, data) {
+        if (this.shouldLog(LogLevel.WARN)) {
+            this.addLog('warn', message, data);
+        }
+    }
+    static info(message, data) {
+        if (this.shouldLog(LogLevel.INFO)) {
+            this.addLog('info', message, data);
+        }
+    }
+    static debug(message, data) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            this.addLog('debug', message, data);
+        }
+    }
+    static trace(message, data) {
+        if (this.shouldLog(LogLevel.TRACE)) {
+            this.addLog('trace', message, data);
+        }
+    }
+    static getLogs(limit) {
+        if (limit && limit > 0) {
+            return this.logs.slice(-limit);
+        }
+        return [...this.logs];
+    }
+    static clearLogs() {
+        this.logs = [];
+    }
+    // Performance timing utilities
+    static time(label) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            console.time(`[TIMER] ${label}`);
+        }
+    }
+    static timeEnd(label) {
+        if (this.shouldLog(LogLevel.DEBUG)) {
+            console.timeEnd(`[TIMER] ${label}`);
+        }
+    }
+    // Safe logging that won't throw errors
+    static safeLog(level, message, data) {
+        try {
+            switch (level) {
+                case 'error':
+                    this.error(message, data);
+                    break;
+                case 'warn':
+                    this.warn(message, data);
+                    break;
+                case 'info':
+                    this.info(message, data);
+                    break;
+                case 'debug':
+                    this.debug(message, data);
+                    break;
+                case 'trace':
+                    this.trace(message, data);
+                    break;
+            }
+        }
+        catch (error) {
+            // Fallback to console.error if our logging fails
+            console.error(`Logging failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            console.error(`Original message: ${message}`);
+        }
+    }
+}
+// Initialize from environment variable
+const envLogLevel = process.env.LOG_LEVEL?.toLowerCase();
+if (envLogLevel && ['error', 'warn', 'info', 'debug', 'trace'].includes(envLogLevel)) {
+    Logger.setLogLevel(envLogLevel);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/validators/input-validator.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+import { ValidationResult } from '../database/types.js';
+export declare class InputValidator {
+    static readonly connectionUrlSchema: z.ZodString;
+    static readonly databaseNameSchema: z.ZodString;
+    static readonly tableNameSchema: z.ZodString;
+    static readonly columnNameSchema: z.ZodString;
+    static readonly textInputSchema: z.ZodString;
+    /**
+     * Validate a connection URL
+     */
+    static validateConnectionUrl(url: string): ValidationResult;
+    /**
+     * Validate a database name
+     */
+    static validateDatabaseName(name: string): ValidationResult;
+    /**
+     * Validate a table name
+     */
+    static validateTableName(name: string): ValidationResult;
+    /**
+     * Validate a column name
+     */
+    static validateColumnName(name: string): ValidationResult;
+    /**
+     * Validate text input
+     */
+    static validateTextInput(text: string): ValidationResult;
+    /**
+     * Sanitize string input by removing dangerous characters
+     */
+    static sanitizeString(input: string): string;
+    /**
+     * Escape MySQL identifiers (table names, column names)
+     */
+    static escapeIdentifier(identifier: string): string;
+    /**
+     * Validate tool arguments based on schema
+     */
+    static validateToolArgs<T>(args: unknown, schema: z.ZodSchema<T>): ValidationResult & {
+        data?: T;
+    };
+    /**
+     * Validate that a string represents a valid number
+     */
+    static validateNumeric(value: string, options?: {
+        min?: number;
+        max?: number;
+        integer?: boolean;
+    }): ValidationResult;
+    /**
+     * Validate an array of values
+     */
+    static validateArray<T>(values: unknown[], itemValidator: (item: unknown) => ValidationResult & {
+        data?: T;
+    }): ValidationResult & {
+        data?: T[];
+    };
+    /**
+     * Validate email format (for potential user management features)
+     */
+    static validateEmail(email: string): ValidationResult;
+    /**
+     * Validate URL format
+     */
+    static validateUrl(url: string): ValidationResult;
+    /**
+     * Check if a string contains only safe characters for logging
+     */
+    static isSafeForLogging(text: string): boolean;
+    /**
+     * Sanitize text for safe logging by masking sensitive information
+     */
+    static sanitizeForLogging(text: string): string;
+}
+//# sourceMappingURL=input-validator.d.ts.map

package/dist/validators/input-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-validator.d.ts","sourceRoot":"","sources":["../../src/validators/input-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,qBAAa,cAAc;IAEzB,MAAM,CAAC,QAAQ,CAAC,mBAAmB,cAc9B;IAGL,MAAM,CAAC,QAAQ,CAAC,kBAAkB,cAGqC;IAGvE,MAAM,CAAC,QAAQ,CAAC,eAAe,cAG+C;IAG9E,MAAM,CAAC,QAAQ,CAAC,gBAAgB,cAG+C;IAG/E,MAAM,CAAC,QAAQ,CAAC,eAAe,cAI1B;IAEL;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAkB3D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAkB3D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAkBxD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAkBzD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAkBxD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAY5C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAanD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE;IAkBlG;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB;IAsBpH;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,EACpB,MAAM,EAAE,OAAO,EAAE,EACjB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,CAAC,CAAA;KAAE,GAChE,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;KAAE;IAwBpC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAUrD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB;IAUjD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAc9C;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAahD"}