@pilat/mcp-datalink 1.0.1

package/dist/__integration__/setup.js

@@ -0,0 +1,230 @@
+/**
+ * Integration test setup utilities
+ *
+ * Manages PostgreSQL and MySQL Docker containers using Testcontainers, and SQLite file database for integration tests.
+ */
+import pg from 'pg';
+import * as mysql from 'mysql2/promise';
+import Database from 'better-sqlite3';
+import * as fs from 'fs';
+import * as path from 'path';
+import { PostgreSqlContainer } from '@testcontainers/postgresql';
+import { MySqlContainer } from '@testcontainers/mysql';
+const TEST_SQLITE_DB_PATH = './test-data/test.db';
+// Global container instances (set during startContainers)
+let postgresContainer = null;
+let mysqlContainer = null;
+// Connection strings (set dynamically after containers start)
+let TEST_PG_URL;
+let TEST_MYSQL_URL;
+/**
+ * Start the test containers (PostgreSQL and MySQL) using Testcontainers
+ */
+export async function startContainers() {
+    if (postgresContainer && mysqlContainer) {
+        console.log('Test containers already running');
+        return;
+    }
+    console.log('Starting PostgreSQL container...');
+    postgresContainer = await new PostgreSqlContainer('postgres:16-alpine')
+        .withDatabase('test_db')
+        .withUsername('test_user')
+        .withPassword('test_password')
+        .withTmpFs({ '/var/lib/postgresql/data': 'rw' })
+        .start();
+    TEST_PG_URL = postgresContainer.getConnectionUri();
+    // Store in environment variable so test files can access it
+    process.env.TEST_POSTGRES_URL = TEST_PG_URL;
+    console.log(`PostgreSQL ready on port ${postgresContainer.getPort()}`);
+    console.log('Starting MySQL container...');
+    mysqlContainer = await new MySqlContainer('mysql:8.0')
+        .withDatabase('test_db')
+        .withUsername('test_user')
+        .withUserPassword('test_password')
+        .withRootPassword('root_password')
+        .withTmpFs({ '/var/lib/mysql': 'rw' })
+        .start();
+    TEST_MYSQL_URL = mysqlContainer.getConnectionUri();
+    // Store in environment variable so test files can access it
+    process.env.TEST_MYSQL_URL = TEST_MYSQL_URL;
+    console.log(`MySQL ready on port ${mysqlContainer.getPort()}`);
+}
+/**
+ * Start the test PostgreSQL container (backward compatibility)
+ */
+export async function startPostgres() {
+    await startContainers();
+}
+/**
+ * Stop the test containers
+ */
+export async function stopContainers() {
+    console.log('Stopping test containers...');
+    if (postgresContainer) {
+        await postgresContainer.stop();
+        postgresContainer = null;
+    }
+    if (mysqlContainer) {
+        await mysqlContainer.stop();
+        mysqlContainer = null;
+    }
+    console.log('Test containers stopped');
+}
+/**
+ * Stop the test PostgreSQL container (backward compatibility)
+ */
+export async function stopPostgres() {
+    await stopContainers();
+}
+/**
+ * Get the PostgreSQL connection URL (set after containers start)
+ */
+export function getPostgresUrl() {
+    // Read from environment variable (set by global-setup)
+    const url = process.env.TEST_POSTGRES_URL || TEST_PG_URL;
+    if (!url) {
+        throw new Error('PostgreSQL container not started yet');
+    }
+    return url;
+}
+/**
+ * Get the MySQL connection URL (set after containers start)
+ */
+export function getMySqlUrl() {
+    // Read from environment variable (set by global-setup)
+    const url = process.env.TEST_MYSQL_URL || TEST_MYSQL_URL;
+    if (!url) {
+        throw new Error('MySQL container not started yet');
+    }
+    return url;
+}
+/**
+ * Get a direct PostgreSQL database client for test verification
+ */
+export async function getTestClient() {
+    const client = new pg.Client({ connectionString: getPostgresUrl() });
+    await client.connect();
+    return client;
+}
+/**
+ * Execute SQL directly for test setup/verification (PostgreSQL)
+ */
+export async function execSql(sql, params) {
+    const client = await getTestClient();
+    try {
+        return await client.query(sql, params);
+    }
+    finally {
+        await client.end();
+    }
+}
+/**
+ * Get a direct MySQL database connection for test verification
+ */
+export async function getMySqlTestConnection() {
+    return await mysql.createConnection(getMySqlUrl());
+}
+/**
+ * Execute SQL directly for test setup/verification (MySQL)
+ */
+export async function execMySql(sql, params) {
+    const connection = await getMySqlTestConnection();
+    try {
+        const [result] = await connection.execute(sql, params);
+        return result;
+    }
+    finally {
+        await connection.end();
+    }
+}
+/**
+ * Execute multiple SQL statements in a single connection (MySQL)
+ * Useful when session state needs to persist (e.g., FOREIGN_KEY_CHECKS)
+ */
+export async function execMySqlBatch(statements) {
+    const connection = await getMySqlTestConnection();
+    try {
+        for (const sql of statements) {
+            await connection.execute(sql);
+        }
+    }
+    finally {
+        await connection.end();
+    }
+}
+// ============================================================================
+// SQLite Setup Utilities (No Docker needed)
+// ============================================================================
+/**
+ * Create the SQLite test database directory and file
+ */
+export function createSqliteTestDb() {
+    const dbDir = path.dirname(TEST_SQLITE_DB_PATH);
+    // Create test-data directory if it doesn't exist
+    if (!fs.existsSync(dbDir)) {
+        fs.mkdirSync(dbDir, { recursive: true });
+        console.log(`Created directory: ${dbDir}`);
+    }
+    // Create empty database file (better-sqlite3 will create tables)
+    const db = new Database(TEST_SQLITE_DB_PATH);
+    // Enable foreign key support
+    db.pragma('foreign_keys = ON');
+    db.close();
+    console.log(`Created SQLite database: ${TEST_SQLITE_DB_PATH}`);
+}
+/**
+ * Delete the SQLite test database file
+ */
+export function deleteSqliteTestDb() {
+    if (fs.existsSync(TEST_SQLITE_DB_PATH)) {
+        fs.unlinkSync(TEST_SQLITE_DB_PATH);
+        console.log(`Deleted SQLite database: ${TEST_SQLITE_DB_PATH}`);
+    }
+    // Also clean up the -wal and -shm files if they exist
+    const walPath = TEST_SQLITE_DB_PATH + '-wal';
+    const shmPath = TEST_SQLITE_DB_PATH + '-shm';
+    if (fs.existsSync(walPath)) {
+        fs.unlinkSync(walPath);
+    }
+    if (fs.existsSync(shmPath)) {
+        fs.unlinkSync(shmPath);
+    }
+}
+/**
+ * Get a SQLite database connection for test setup/verification
+ */
+export function getSqliteTestDb() {
+    const db = new Database(TEST_SQLITE_DB_PATH);
+    // Enable foreign key support for each connection
+    db.pragma('foreign_keys = ON');
+    return db;
+}
+/**
+ * Execute SQL directly for test setup/verification (SQLite)
+ */
+export async function execSqliteSql(sql) {
+    const db = getSqliteTestDb();
+    try {
+        db.exec(sql);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Execute a query and return results (SQLite)
+ */
+export async function querySqliteSql(sql) {
+    const db = getSqliteTestDb();
+    try {
+        return db.prepare(sql).all();
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Export SQLite path for use in helpers
+ */
+export { TEST_SQLITE_DB_PATH };
+//# sourceMappingURL=setup.js.map

package/dist/__integration__/setup.js.map

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

package/dist/adapters/factory.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Database Adapter Factory
+ *
+ * Creates the appropriate database adapter based on connection URL scheme.
+ *
+ * Phase 1: PostgreSQL - DONE
+ * Phase 2: MySQL - DONE
+ * Phase 3: SQLite - DONE
+ */
+import type { DatabaseAdapter } from './types.js';
+import type { DatabaseConfig, DefaultsConfig } from '../types.js';
+/**
+ * Create a database adapter based on configuration
+ *
+ * Auto-detects database type from URL scheme:
+ * - `postgresql://` or `postgres://` -> PostgreSQL adapter
+ * - `mysql://` -> MySQL adapter
+ * - `sqlite://` or `.db`/`.sqlite` file path -> SQLite adapter
+ *
+ * @param database - Database configuration (url, readonly, etc.)
+ * @param defaults - Default settings (timeout, limits)
+ * @returns Appropriate DatabaseAdapter instance
+ * @throws DbMcpError if database type is not supported
+ */
+export declare function createAdapter(database: DatabaseConfig, defaults: DefaultsConfig): DatabaseAdapter;
+/**
+ * Check if a URL is for a supported database type
+ *
+ * @param url - Database connection URL
+ * @returns true if the URL scheme is recognized
+ */
+export declare function isSupportedUrl(url: string): boolean;
+/**
+ * Check if a database type is currently implemented
+ *
+ * @param url - Database connection URL
+ * @returns true if the database type can be used now
+ */
+export declare function isImplemented(url: string): boolean;
+//# sourceMappingURL=factory.d.ts.map

package/dist/adapters/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA+ElE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,cAAc,GACvB,eAAe,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQlD"}

package/dist/adapters/factory.js

@@ -0,0 +1,114 @@
+/**
+ * Database Adapter Factory
+ *
+ * Creates the appropriate database adapter based on connection URL scheme.
+ *
+ * Phase 1: PostgreSQL - DONE
+ * Phase 2: MySQL - DONE
+ * Phase 3: SQLite - DONE
+ */
+import { PostgreSqlAdapter } from './postgresql/adapter.js';
+import { MySqlAdapter } from './mysql/adapter.js';
+import { SqliteAdapter } from './sqlite/adapter.js';
+import { DbMcpError, ErrorCode } from '../utils/errors.js';
+/**
+ * Detect database type from URL scheme
+ *
+ * @param url - Database connection URL
+ * @returns Database scheme type
+ * @throws DbMcpError if scheme is not recognized
+ */
+function detectScheme(url) {
+    // PostgreSQL: postgresql:// or postgres://
+    if (url.startsWith('postgresql://') || url.startsWith('postgres://')) {
+        return 'postgresql';
+    }
+    // MySQL: mysql://
+    if (url.startsWith('mysql://')) {
+        return 'mysql';
+    }
+    // SQLite: sqlite:// or file path ending in .db/.sqlite/.sqlite3
+    if (url.startsWith('sqlite://') ||
+        url.endsWith('.db') ||
+        url.endsWith('.sqlite') ||
+        url.endsWith('.sqlite3')) {
+        return 'sqlite';
+    }
+    throw new DbMcpError(ErrorCode.CONFIG_INVALID, `Unknown database URL scheme: ${url}. ` +
+        'Supported schemes: postgresql://, postgres://, mysql://, sqlite://', { url });
+}
+/**
+ * Create a base database adapter (without SSH wrapping)
+ *
+ * @param config - Adapter configuration
+ * @param scheme - Database scheme type
+ * @returns Appropriate DatabaseAdapter instance
+ */
+function createBaseAdapter(config, scheme) {
+    switch (scheme) {
+        case 'postgresql':
+            return new PostgreSqlAdapter(config);
+        case 'mysql':
+            return new MySqlAdapter(config);
+        case 'sqlite':
+            return new SqliteAdapter(config);
+        default: {
+            // TypeScript exhaustive check
+            const _exhaustive = scheme;
+            throw new DbMcpError(ErrorCode.CONFIG_INVALID, `Unexpected database scheme: ${_exhaustive}`);
+        }
+    }
+}
+/**
+ * Create a database adapter based on configuration
+ *
+ * Auto-detects database type from URL scheme:
+ * - `postgresql://` or `postgres://` -> PostgreSQL adapter
+ * - `mysql://` -> MySQL adapter
+ * - `sqlite://` or `.db`/`.sqlite` file path -> SQLite adapter
+ *
+ * @param database - Database configuration (url, readonly, etc.)
+ * @param defaults - Default settings (timeout, limits)
+ * @returns Appropriate DatabaseAdapter instance
+ * @throws DbMcpError if database type is not supported
+ */
+export function createAdapter(database, defaults) {
+    const scheme = detectScheme(database.url);
+    const config = {
+        database,
+        defaults,
+    };
+    return createBaseAdapter(config, scheme);
+}
+/**
+ * Check if a URL is for a supported database type
+ *
+ * @param url - Database connection URL
+ * @returns true if the URL scheme is recognized
+ */
+export function isSupportedUrl(url) {
+    try {
+        detectScheme(url);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a database type is currently implemented
+ *
+ * @param url - Database connection URL
+ * @returns true if the database type can be used now
+ */
+export function isImplemented(url) {
+    try {
+        const scheme = detectScheme(url);
+        // All three database types are now implemented (Phase 1-3)
+        return scheme === 'postgresql' || scheme === 'mysql' || scheme === 'sqlite';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/adapters/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/adapters/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAO3D;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,2CAA2C;IAC3C,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACrE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,kBAAkB;IAClB,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gEAAgE;IAChE,IACE,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;QAC3B,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,gCAAgC,GAAG,IAAI;QACrC,oEAAoE,EACtE,EAAE,GAAG,EAAE,CACR,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CACxB,MAAqB,EACrB,MAAsB;IAEtB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAEvC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAElC,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAEnC,OAAO,CAAC,CAAC,CAAC;YACR,8BAA8B;YAC9B,MAAM,WAAW,GAAU,MAAM,CAAC;YAClC,MAAM,IAAI,UAAU,CAClB,SAAS,CAAC,cAAc,EACxB,+BAA+B,WAAW,EAAE,CAC7C,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAwB,EACxB,QAAwB;IAExB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAkB;QAC5B,QAAQ;QACR,QAAQ;KACT,CAAC;IAEF,OAAO,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,2DAA2D;QAC3D,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Database Adapters Module
+ *
+ * Barrel file exporting all adapter-related types and implementations.
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createAdapter,
+ *   DatabaseAdapter,
+ *   AdapterConnection,
+ * } from './adapters/index.js';
+ *
+ * const adapter = createAdapter(dbConfig, defaults);
+ *
+ * // SQL dialect methods are now part of the adapter
+ * adapter.validateQueryForTool(sql, 'query');
+ * const parsed = adapter.parseQuery(sql);
+ *
+ * await adapter.withConnection(async (conn) => {
+ *   const result = await conn.query('SELECT * FROM users WHERE id = $1', [1]);
+ *   return result;
+ * });
+ * ```
+ */
+export type { DatabaseAdapter, AdapterConnection, RawQueryResult, AdapterConfig, ListTablesInternalResult, } from './types.js';
+export { createAdapter, isSupportedUrl, isImplemented } from './factory.js';
+export { PostgreSqlAdapter } from './postgresql/adapter.js';
+export { MySqlAdapter } from './mysql/adapter.js';
+export { SqliteAdapter } from './sqlite/adapter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,34 @@
+/**
+ * Database Adapters Module
+ *
+ * Barrel file exporting all adapter-related types and implementations.
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createAdapter,
+ *   DatabaseAdapter,
+ *   AdapterConnection,
+ * } from './adapters/index.js';
+ *
+ * const adapter = createAdapter(dbConfig, defaults);
+ *
+ * // SQL dialect methods are now part of the adapter
+ * adapter.validateQueryForTool(sql, 'query');
+ * const parsed = adapter.parseQuery(sql);
+ *
+ * await adapter.withConnection(async (conn) => {
+ *   const result = await conn.query('SELECT * FROM users WHERE id = $1', [1]);
+ *   return result;
+ * });
+ * ```
+ */
+// Factory
+export { createAdapter, isSupportedUrl, isImplemented } from './factory.js';
+// PostgreSQL (explicit exports for testing/extension)
+export { PostgreSqlAdapter } from './postgresql/adapter.js';
+// MySQL (explicit exports for testing/extension)
+export { MySqlAdapter } from './mysql/adapter.js';
+// SQLite (explicit exports for testing/extension)
+export { SqliteAdapter } from './sqlite/adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAWH,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE5E,sDAAsD;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,iDAAiD;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,kDAAkD;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/adapters/mysql/adapter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MySQL Database Adapter
+ *
+ * Implements DatabaseAdapter interface for MySQL databases.
+ * Uses mysql2/promise driver with per-request connection recycling.
+ */
+import type { DatabaseAdapter, AdapterConnection, AdapterConfig } from '../types.js';
+import type { ParsedQuery } from '../../types.js';
+/**
+ * Strip SQL comments from a query
+ */
+declare function stripComments(sql: string): string;
+/**
+ * String-aware statement splitting
+ */
+declare function splitStatements(sql: string): string[];
+/**
+ * MySQL database adapter
+ *
+ * Creates new connections for each request to prevent session state attacks.
+ */
+export declare class MySqlAdapter implements DatabaseAdapter {
+    readonly type: "mysql";
+    private readonly connectionUrl;
+    private readonly timeout;
+    constructor(config: AdapterConfig);
+    /**
+     * Get the default schema name for MySQL (database name from URL)
+     */
+    getDefaultSchema(): string;
+    /**
+     * Parse and validate a SQL query
+     */
+    parseQuery(sql: string): ParsedQuery;
+    /**
+     * Inject a LIMIT clause into a SELECT query if it doesn't have one
+     */
+    injectLimit(sql: string, limit: number): string;
+    /**
+     * Validate that a SQL query is appropriate for a specific tool
+     */
+    validateQueryForTool(sql: string, tool: 'query' | 'execute'): void;
+    /**
+     * Get the EXPLAIN prefix for MySQL
+     */
+    getExplainPrefix(analyze: boolean): string;
+    /**
+     * Convert PostgreSQL-style placeholders ($1, $2) to MySQL-style (?)
+     */
+    convertPlaceholders(sql: string): string;
+    /**
+     * Execute a function with a managed MySQL connection
+     */
+    withConnection<T>(fn: (conn: AdapterConnection) => Promise<T>): Promise<T>;
+    /**
+     * Clean up resources (no persistent resources in this adapter)
+     */
+    dispose(): Promise<void>;
+}
+export { stripComments, splitStatements };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/mysql/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mysql/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAEjB,aAAa,EAEd,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,WAAW,EAOZ,MAAM,gBAAgB,CAAC;AA6CxB;;GAEG;AACH,iBAAS,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA0E1C;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAwD9C;AAgED;;;;GAIG;AACH,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,aAAa;IAKjC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAa1B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAsDpC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAQ/C;;OAEG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAyClE;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI1C;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxC;;OAEG;IACG,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0ChF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAsND,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC"}