@groundbrick/db-mysql 0.1.0

package/README.md

@@ -0,0 +1,153 @@
+# @groundbrick/db-mysql
+
+Cliente MySQL para o microframework TypeScript, implementando o contrato
+`@groundbrick/db-core` (espelho do `@groundbrick/db-postgres`): connection pooling,
+gerenciamento de transações, monitoramento de saúde e sistema de migrações.
+
+## Features
+
+- **🔗 Connection Pooling** — usando `mysql2` com pool configurável
+- **🏭 Singleton Factory** — gerenciamento centralizado de instâncias de clientes
+- **🔄 Transaction Management** — transações automáticas e manuais via `BaseTransaction`
+- **📊 Health Monitoring** — verificações de saúde com métricas de timing
+- **🗃️ Migration System** — migrações com seções `UP`/`DOWN` e checksum
+- **⚙️ TypeScript Support** — tipagem completa para queries e configurações
+- **🛡️ Error Handling** — tipos de erro específicos (`ConnectionError`, `QueryError`, etc.)
+
+## Instalação
+
+```bash
+npm install @groundbrick/db-mysql
+```
+
+### Peer Dependencies
+
+```bash
+npm install mysql2
+```
+
+## Quick Start
+
+### 1. Configuração
+
+```typescript
+// src/database.ts
+import { MysqlFactory, MysqlConfig } from '@groundbrick/db-mysql';
+import { createLogger } from '@groundbrick/logger';
+
+const config: MysqlConfig = {
+  host: process.env.DB_HOST || 'localhost',
+  port: parseInt(process.env.DB_PORT || '3306'),
+  database: process.env.DB_NAME || 'myapp',
+  user: process.env.DB_USER || 'root',
+  password: process.env.DB_PASSWORD || 'secret',
+
+  // Pool de conexões
+  connectionLimit: 10,
+  connectTimeout: 60000,
+};
+
+const logger = createLogger({ context: 'database' });
+export const dbClient = MysqlFactory.getInstance(config, logger);
+```
+
+### 2. Inicialização e Queries
+
+```typescript
+import { dbClient } from './database.js';
+
+await dbClient.initialize();
+
+const users = await dbClient.query<{ id: number; name: string; email: string }>(
+  'SELECT id, name, email FROM users WHERE active = ?',
+  [true]
+);
+
+console.log(`Found ${users.rowCount} users:`, users.rows);
+
+process.on('SIGTERM', async () => {
+  await dbClient.close();
+  process.exit(0);
+});
+```
+
+### 3. Transações
+
+```typescript
+// Transação automática (recomendado)
+const result = await dbClient.transaction(async (trx) => {
+  await trx.query('INSERT INTO audit_logs (action, user_id) VALUES (?, ?)',
+    ['USER_CREATED', 123]);
+
+  const insert = await trx.query(
+    'INSERT INTO users (name, email) VALUES (?, ?)',
+    ['João Silva', 'joao@example.com']
+  );
+
+  return insert;
+});
+```
+
+## Sistema de Migrações
+
+```typescript
+import { MysqlMigrator } from '@groundbrick/db-mysql';
+
+const migrator = new MysqlMigrator(dbClient, './migrations', logger.child('migrator'));
+
+await migrator.migrate();        // aplica pendentes
+await migrator.rollback(2);      // desfaz as últimas 2
+const status = await migrator.getStatus();
+```
+
+### Formato de arquivo de migração
+
+```sql
+-- Criar tabela de usuários
+CREATE TABLE users (
+  id INT AUTO_INCREMENT PRIMARY KEY,
+  name VARCHAR(100) NOT NULL,
+  email VARCHAR(100) UNIQUE NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- DOWN
+DROP TABLE IF EXISTS users;
+```
+
+**Regras:** seção `UP` antes de `-- DOWN`, seção `DOWN` depois; primeira linha `--`
+vira a descrição; arquivos aplicados em ordem lexicográfica; rollback executa `DOWN`
+em ordem reversa.
+
+## Error Handling
+
+```typescript
+import { ConnectionError, QueryError, TransactionError, MigrationError } from '@groundbrick/db-core';
+
+try {
+  await dbClient.query('SELECT * FROM users');
+} catch (error) {
+  if (error instanceof ConnectionError) {
+    // reconectar / fallback
+  } else if (error instanceof QueryError) {
+    // erro na query
+  }
+}
+```
+
+## API
+
+Exporta `MysqlClient`, `MysqlTransaction`, `MysqlDatabaseFactory`, `MysqlFactory`,
+`MysqlMigrator`, `MysqlSqlAdapter`, `normalizeResult` e o tipo `MysqlConfig`. A
+superfície segue o contrato `DatabaseClient`/`QueryResult` de `@groundbrick/db-core`,
+idêntica ao `@groundbrick/db-postgres` (apenas placeholders `?` em vez de `$1`).
+
+## Dependencies
+
+- `@groundbrick/db-core` — abstrações de banco de dados
+- `@groundbrick/logger` — sistema de logging
+- **peer:** `mysql2` — driver MySQL para Node.js (^3.11.0)
+
+## License
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,13 @@
+import { BaseSqlAdapter } from '@groundbrick/db-core';
+/**
+ * MySQL SQL adapter. MySQL uses `?` positional placeholders natively, so
+ * adaptSql is a passthrough. MySQL does NOT support the RETURNING clause.
+ */
+export declare class MysqlSqlAdapter extends BaseSqlAdapter {
+    getDatabaseType(): 'mysql';
+    supportsReturning(): boolean;
+    adaptSql(sql: string): string;
+    getNowFunction(): string;
+    protected createPlaceholder(_index: number): string;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,cAAc;IACjD,eAAe,IAAI,OAAO;IAI1B,iBAAiB,IAAI,OAAO;IAI5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAK7B,cAAc,IAAI,MAAM;IAIxB,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGpD"}

package/dist/adapter.js

@@ -0,0 +1,24 @@
+import { BaseSqlAdapter } from '@groundbrick/db-core';
+/**
+ * MySQL SQL adapter. MySQL uses `?` positional placeholders natively, so
+ * adaptSql is a passthrough. MySQL does NOT support the RETURNING clause.
+ */
+export class MysqlSqlAdapter extends BaseSqlAdapter {
+    getDatabaseType() {
+        return 'mysql';
+    }
+    supportsReturning() {
+        return false;
+    }
+    adaptSql(sql) {
+        // MySQL uses ? placeholders as-is.
+        return sql;
+    }
+    getNowFunction() {
+        return 'NOW()';
+    }
+    createPlaceholder(_index) {
+        return '?';
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,eAAe;QACb,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iBAAiB;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,mCAAmC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED,cAAc;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAES,iBAAiB,CAAC,MAAc;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+import { Logger } from '@groundbrick/logger';
+import { DatabaseClient, QueryResult, HealthCheckResult, SqlAdapter } from '@groundbrick/db-core';
+import { MysqlConfig } from './types.js';
+import { MysqlTransaction } from './transaction.js';
+/**
+ * MySQL database client implementing the db-core DatabaseClient contract.
+ * Mirrors PostgresClient so application code can switch engines transparently.
+ */
+export declare class MysqlClient implements DatabaseClient {
+    private pool;
+    private logger;
+    private sqlAdapter;
+    private isInitialized;
+    constructor(config: MysqlConfig, logger: Logger);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    getDatabaseType(): 'mysql';
+    getSqlAdapter(): SqlAdapter;
+    supportsReturning(): boolean;
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    transaction<T>(callback: (tx: MysqlTransaction) => Promise<T>): Promise<T>;
+    healthCheck(): Promise<HealthCheckResult>;
+    isReady(): boolean;
+}
+export { type MysqlConfig, MysqlTransaction };
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,EAIjB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIpD;;;GAGG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAwBzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,eAAe,IAAI,OAAO;IAI1B,aAAa,IAAI,UAAU;IAI3B,iBAAiB,IAAI,OAAO;IAItB,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA+BxE,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA+B1E,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA4B/C,OAAO,IAAI,OAAO;CAGnB;AAED,OAAO,EAAE,KAAK,WAAW,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/client.js

@@ -0,0 +1,158 @@
+import mysql from 'mysql2/promise';
+import { ConnectionError, QueryError, TransactionError } from '@groundbrick/db-core';
+import { MysqlTransaction } from './transaction.js';
+import { MysqlSqlAdapter } from './adapter.js';
+import { normalizeResult } from './result.js';
+/**
+ * MySQL database client implementing the db-core DatabaseClient contract.
+ * Mirrors PostgresClient so application code can switch engines transparently.
+ */
+export class MysqlClient {
+    pool;
+    logger;
+    sqlAdapter;
+    isInitialized = false;
+    constructor(config, logger) {
+        this.logger = logger.child('mysql-client');
+        this.sqlAdapter = new MysqlSqlAdapter();
+        this.pool = mysql.createPool({
+            host: config.host,
+            port: config.port,
+            database: config.database,
+            user: config.user,
+            password: config.password,
+            connectionLimit: config.max || 10,
+            idleTimeout: config.idleTimeoutMillis || 30000,
+            connectTimeout: config.connectionTimeoutMillis || 60000,
+            // Needed so multi-statement migration files run like they do under `pg`.
+            multipleStatements: config.multipleStatements ?? false,
+            timezone: config.timezone || 'Z',
+            charset: config.charset || 'utf8mb4',
+            waitForConnections: true,
+            enableKeepAlive: true,
+            // Keep DECIMAL/BIGINT as JS-safe values.
+            decimalNumbers: true
+        });
+    }
+    async initialize() {
+        if (this.isInitialized) {
+            this.logger.warn('Database already initialized');
+            return;
+        }
+        try {
+            const conn = await this.pool.getConnection();
+            await conn.query('SELECT 1');
+            conn.release();
+            this.isInitialized = true;
+            this.logger.info('MySQL client initialized');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize MySQL client', error);
+            throw new ConnectionError(`Failed to initialize MySQL client: ${error.message}`);
+        }
+    }
+    async close() {
+        if (!this.isInitialized || !this.pool)
+            return;
+        try {
+            await this.pool.end();
+            this.isInitialized = false;
+            this.logger.info('MySQL client closed');
+        }
+        catch (error) {
+            this.logger.error('Failed to close MySQL client', error);
+            throw error;
+        }
+    }
+    getDatabaseType() {
+        return 'mysql';
+    }
+    getSqlAdapter() {
+        return this.sqlAdapter;
+    }
+    supportsReturning() {
+        return false;
+    }
+    async query(sql, params = []) {
+        if (!this.isInitialized || !this.pool) {
+            throw new ConnectionError('MySQL client not initialized');
+        }
+        const timer = this.logger.startTimer('query');
+        try {
+            this.logger.debug('Executing query', {
+                sql: sql.substring(0, 100) + (sql.length > 100 ? '...' : ''),
+                paramCount: params.length
+            });
+            const [rows, fields] = await this.pool.query(sql, params);
+            return normalizeResult(rows, fields);
+        }
+        catch (error) {
+            this.logger.error('Query execution failed', error instanceof Error ? error : new Error(String(error)), { error, sql, params });
+            throw new QueryError(`Query execution failed: ${error.message}`, sql, params, error);
+        }
+        finally {
+            timer();
+        }
+    }
+    async transaction(callback) {
+        if (!this.isInitialized || !this.pool) {
+            throw new ConnectionError('MySQL client not initialized');
+        }
+        const connection = await this.pool.getConnection();
+        const transactionLogger = this.logger.child('transaction');
+        const timer = transactionLogger.startTimer('transaction');
+        const transaction = new MysqlTransaction(connection, this.logger);
+        try {
+            await connection.beginTransaction();
+            transactionLogger.debug('Transaction started');
+            const result = await callback(transaction);
+            await transaction.commit();
+            transactionLogger.debug('MySQL transaction committed');
+            return result;
+        }
+        catch (error) {
+            // rollback() is safe to call once; it also releases the connection.
+            await transaction.rollback().catch(() => {
+                /* connection may already be released */
+            });
+            transactionLogger.error('Transaction rolled back', error);
+            throw new TransactionError(`Transaction failed: ${error.message}`, error);
+        }
+        finally {
+            timer();
+        }
+    }
+    async healthCheck() {
+        const startTime = Date.now();
+        try {
+            if (!this.pool) {
+                return {
+                    status: 'unhealthy',
+                    message: 'Connection pool not initialized',
+                    timestamp: new Date(),
+                    responseTime: Date.now() - startTime
+                };
+            }
+            await this.pool.query('SELECT 1');
+            return {
+                status: 'healthy',
+                message: 'Connection successful',
+                timestamp: new Date(),
+                responseTime: Date.now() - startTime
+            };
+        }
+        catch (error) {
+            return {
+                status: 'unhealthy',
+                message: error.message,
+                timestamp: new Date(),
+                responseTime: Date.now() - startTime
+            };
+        }
+    }
+    isReady() {
+        return this.isInitialized && this.pool !== null;
+    }
+}
+export { MysqlTransaction };
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/factory.d.ts

@@ -0,0 +1,19 @@
+import { Logger } from '@groundbrick/logger';
+import { DatabaseFactory, DatabaseConfig } from '@groundbrick/db-core';
+import { MysqlClient } from './client.js';
+/**
+ * MySQL database factory (singleton). Caches one client per connection key,
+ * mirroring PostgresDatabaseFactory.
+ */
+export declare class MysqlDatabaseFactory implements DatabaseFactory {
+    private static instance;
+    private clients;
+    private defaultLogger;
+    private constructor();
+    static getInstance(): MysqlDatabaseFactory;
+    getInstance(config: DatabaseConfig, logger?: Logger): MysqlClient;
+    closeInstance(): Promise<void>;
+    private generateClientKey;
+}
+export declare const MysqlFactory: MysqlDatabaseFactory;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAqC;IAC5D,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,oBAAoB;IAO1C,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW;IAc3D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBpC,OAAO,CAAC,iBAAiB;CAG1B;AAGD,eAAO,MAAM,YAAY,sBAAqC,CAAC"}

package/dist/factory.js

@@ -0,0 +1,45 @@
+import { createLogger } from '@groundbrick/logger';
+import { MysqlClient } from './client.js';
+/**
+ * MySQL database factory (singleton). Caches one client per connection key,
+ * mirroring PostgresDatabaseFactory.
+ */
+export class MysqlDatabaseFactory {
+    static instance = null;
+    clients = new Map();
+    defaultLogger;
+    constructor() {
+        this.defaultLogger = createLogger({ context: 'mysql-factory' });
+    }
+    static getInstance() {
+        if (!MysqlDatabaseFactory.instance) {
+            MysqlDatabaseFactory.instance = new MysqlDatabaseFactory();
+        }
+        return MysqlDatabaseFactory.instance;
+    }
+    getInstance(config, logger) {
+        const clientKey = this.generateClientKey(config);
+        if (this.clients.has(clientKey)) {
+            this.defaultLogger.debug('Reusing existing MySQL client', { key: clientKey });
+            return this.clients.get(clientKey);
+        }
+        const clientLogger = logger || this.defaultLogger;
+        const client = new MysqlClient(config, clientLogger.child('mysql-client'));
+        this.clients.set(clientKey, client);
+        this.defaultLogger.info('Created new MySQL client', { key: clientKey });
+        return client;
+    }
+    async closeInstance() {
+        this.defaultLogger.info('Closing all MySQL connections');
+        const closePromises = Array.from(this.clients.values()).map((client) => client.close().catch((error) => this.defaultLogger.error('Error closing client', error instanceof Error ? error : new Error(String(error)), { error })));
+        await Promise.all(closePromises);
+        this.clients.clear();
+        MysqlDatabaseFactory.instance = null;
+    }
+    generateClientKey(config) {
+        return `${config.host}:${config.port}:${config.database}:${config.user}`;
+    }
+}
+// Default factory instance for convenience.
+export const MysqlFactory = MysqlDatabaseFactory.getInstance();
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAC,QAAQ,GAAgC,IAAI,CAAC;IACpD,OAAO,GAA6B,IAAI,GAAG,EAAE,CAAC;IAC9C,aAAa,CAAS;IAE9B;QACE,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACnC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7D,CAAC;QACD,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,WAAW,CAAC,MAAsB,EAAE,MAAe;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9E,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACtC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,IAAI,CAAC,aAAa,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAqB,EAAE,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAC1F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrE,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7B,IAAI,CAAC,aAAa,CAAC,KAAK,CACtB,sBAAsB,EACtB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD,EAAE,KAAK,EAAE,CACV,CACF,CACF,CAAC;QACF,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,oBAAoB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvC,CAAC;IAEO,iBAAiB,CAAC,MAAsB;QAC9C,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;;AAGH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAAC,WAAW,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { MysqlClient, MysqlTransaction } from './client.js';
+export { MysqlDatabaseFactory, MysqlFactory } from './factory.js';
+export { MysqlMigrator } from './migrator.js';
+export { MysqlSqlAdapter } from './adapter.js';
+export { normalizeResult } from './result.js';
+export type { MysqlConfig } from './types.js';
+export type { DatabaseClient, QueryResult, Transaction, Migration, MigrationRecord, HealthCheckResult, ConnectionError, QueryError, MigrationError } from '@groundbrick/db-core';
+export { createLogger } from '@groundbrick/logger';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,YAAY,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { MysqlClient, MysqlTransaction } from './client.js';
+export { MysqlDatabaseFactory, MysqlFactory } from './factory.js';
+export { MysqlMigrator } from './migrator.js';
+export { MysqlSqlAdapter } from './adapter.js';
+export { normalizeResult } from './result.js';
+export { createLogger } from '@groundbrick/logger';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgB9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/migrator.d.ts

@@ -0,0 +1,31 @@
+import { Logger } from '@groundbrick/logger';
+import { DatabaseClient, Migration, MigrationRecord } from '@groundbrick/db-core';
+/**
+ * MySQL migrator. Mirrors PostgresMigrator: reads `NNN_name.sql` files (each
+ * with `-- UP` / `-- DOWN` sections), tracks applied ones in `schema_migrations`.
+ *
+ * Note: MySQL implicitly commits on DDL, so a failed multi-statement migration
+ * is not atomically rolled back the way it is in PostgreSQL. Keep each migration
+ * focused and idempotent (use IF NOT EXISTS / IF EXISTS).
+ */
+export declare class MysqlMigrator {
+    private client;
+    private migrationsPath;
+    private logger;
+    constructor(client: DatabaseClient, migrationsPath: string, logger: Logger);
+    initialize(): Promise<void>;
+    migrate(): Promise<void>;
+    rollback(steps?: number): Promise<void>;
+    getPending(): Promise<Migration[]>;
+    getApplied(): Promise<MigrationRecord[]>;
+    getStatus(): Promise<{
+        total: number;
+        applied: number;
+        pending: string[];
+    }>;
+    private loadMigrations;
+    private parseMigration;
+    private applyMigration;
+    private rollbackMigration;
+}
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../src/migrator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,eAAe,EAAkB,MAAM,sBAAsB,CAAC;AAElG;;;;;;;GAOG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,MAAM;gBAFN,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM;IAGlB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBxB,QAAQ,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlC,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAMlC,UAAU,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAOxC,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;YASnE,cAAc;IAsB5B,OAAO,CAAC,cAAc;YAoBR,cAAc;YAuBd,iBAAiB;CAsBhC"}

package/dist/migrator.js

@@ -0,0 +1,149 @@
+import { readdir, readFile } from 'fs/promises';
+import { join } from 'path';
+import { createHash } from 'crypto';
+import { MigrationError } from '@groundbrick/db-core';
+/**
+ * MySQL migrator. Mirrors PostgresMigrator: reads `NNN_name.sql` files (each
+ * with `-- UP` / `-- DOWN` sections), tracks applied ones in `schema_migrations`.
+ *
+ * Note: MySQL implicitly commits on DDL, so a failed multi-statement migration
+ * is not atomically rolled back the way it is in PostgreSQL. Keep each migration
+ * focused and idempotent (use IF NOT EXISTS / IF EXISTS).
+ */
+export class MysqlMigrator {
+    client;
+    migrationsPath;
+    logger;
+    constructor(client, migrationsPath, logger) {
+        this.client = client;
+        this.migrationsPath = migrationsPath;
+        this.logger = logger;
+    }
+    async initialize() {
+        try {
+            await this.client.query(`
+        CREATE TABLE IF NOT EXISTS schema_migrations (
+          id VARCHAR(255) PRIMARY KEY,
+          description TEXT NOT NULL,
+          checksum VARCHAR(64) NOT NULL,
+          applied_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
+        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+      `);
+            this.logger.info('Migration table initialized');
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize migration table', error instanceof Error ? error : new Error(String(error)), { error });
+            throw new MigrationError(`Failed to initialize migration table: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async migrate() {
+        await this.initialize();
+        const pending = await this.getPending();
+        if (pending.length === 0) {
+            this.logger.info('No pending migrations');
+            return;
+        }
+        this.logger.info(`Applying ${pending.length} migrations`, { migrations: pending.map((m) => m.id) });
+        for (const migration of pending) {
+            await this.applyMigration(migration);
+        }
+        this.logger.info('All migrations applied successfully');
+    }
+    async rollback(steps = 1) {
+        await this.initialize();
+        const applied = await this.getApplied();
+        const toRollback = applied.slice(-steps);
+        if (toRollback.length === 0) {
+            this.logger.info('No migrations to rollback');
+            return;
+        }
+        this.logger.info(`Rolling back ${toRollback.length} migrations`, {
+            migrations: toRollback.map((m) => m.id)
+        });
+        for (const migration of toRollback.reverse()) {
+            await this.rollbackMigration(migration);
+        }
+        this.logger.info('Rollback completed successfully');
+    }
+    async getPending() {
+        const [allMigrations, appliedRecords] = await Promise.all([this.loadMigrations(), this.getApplied()]);
+        const appliedIds = new Set(appliedRecords.map((r) => r.id));
+        return allMigrations.filter((m) => !appliedIds.has(m.id));
+    }
+    async getApplied() {
+        const result = await this.client.query('SELECT * FROM schema_migrations ORDER BY applied_at, id');
+        return result.rows;
+    }
+    async getStatus() {
+        const [allMigrations, pending] = await Promise.all([this.loadMigrations(), this.getPending()]);
+        return {
+            total: allMigrations.length,
+            applied: allMigrations.length - pending.length,
+            pending: pending.map((m) => m.id)
+        };
+    }
+    async loadMigrations() {
+        try {
+            const files = await readdir(this.migrationsPath);
+            const migrationFiles = files.filter((file) => file.endsWith('.sql')).sort();
+            const migrations = [];
+            for (const file of migrationFiles) {
+                const content = await readFile(join(this.migrationsPath, file), 'utf8');
+                migrations.push(this.parseMigration(file, content));
+            }
+            return migrations;
+        }
+        catch (error) {
+            this.logger.error('Failed to load migrations', error instanceof Error ? error : new Error(String(error)), { error, path: this.migrationsPath });
+            throw new MigrationError(`Failed to load migrations: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    parseMigration(filename, content) {
+        const id = filename.replace('.sql', '');
+        const firstLine = content.split('\n')[0];
+        const description = firstLine.startsWith('--') ? firstLine.slice(2).trim() : id;
+        const downIndex = content.toLowerCase().indexOf('-- down');
+        if (downIndex === -1) {
+            throw new MigrationError(`Migration ${id} missing DOWN section`);
+        }
+        const up = content.substring(0, downIndex).trim();
+        const down = content.substring(downIndex + 7).trim();
+        if (!up || !down) {
+            throw new MigrationError(`Migration ${id} has empty UP or DOWN section`);
+        }
+        const checksum = createHash('sha256').update(content).digest('hex');
+        return { id, description, up, down, checksum };
+    }
+    async applyMigration(migration) {
+        try {
+            this.logger.info(`Applying migration: ${migration.id} - ${migration.description}`);
+            // Run the DDL outside an explicit transaction (MySQL auto-commits DDL),
+            // then record it. Migrations must be idempotent.
+            await this.client.query(migration.up);
+            await this.client.query('INSERT INTO schema_migrations (id, description, checksum) VALUES (?, ?, ?)', [migration.id, migration.description, migration.checksum]);
+            this.logger.info(`Migration applied successfully: ${migration.id}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to apply migration: ${migration.id}`, error instanceof Error ? error : new Error(String(error)), { error });
+            throw new MigrationError(`Failed to apply migration ${migration.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async rollbackMigration(record) {
+        try {
+            this.logger.info(`Rolling back migration: ${record.id} - ${record.description}`);
+            const migrations = await this.loadMigrations();
+            const migration = migrations.find((m) => m.id === record.id);
+            if (!migration) {
+                throw new MigrationError(`Migration file not found for ${record.id}`);
+            }
+            await this.client.query(migration.down);
+            await this.client.query('DELETE FROM schema_migrations WHERE id = ?', [record.id]);
+            this.logger.info(`Migration rolled back successfully: ${record.id}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to rollback migration: ${record.id}`, error instanceof Error ? error : new Error(String(error)), { error });
+            throw new MigrationError(`Failed to rollback migration ${record.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}
+//# sourceMappingURL=migrator.js.map

package/dist/migrator.js.map

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

package/dist/result.d.ts

@@ -0,0 +1,12 @@
+import type { FieldPacket } from 'mysql2/promise';
+import { QueryResult } from '@groundbrick/db-core';
+/**
+ * Normaliza o tuplo `[result, fields]` do mysql2 para o formato QueryResult.
+ *
+ * - SELECT / SHOW → `result` é um array de row objects.
+ * - INSERT / UPDATE / DELETE / DDL → `result` é um ResultSetHeader.
+ * - Multi-statement (migrations) → `result` é um array de ResultSetHeaders/arrays;
+ *   agregamos os affectedRows e não devolvemos linhas.
+ */
+export declare function normalizeResult<T>(raw: any, fields?: FieldPacket[]): QueryResult<T>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAanD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAsBnF"}

package/dist/result.js

@@ -0,0 +1,38 @@
+function safeFields(fields) {
+    if (!Array.isArray(fields))
+        return undefined;
+    return fields
+        .filter((f) => f && typeof f === 'object' && 'name' in f)
+        .map((f) => ({ name: f.name }));
+}
+function isResultSetHeader(r) {
+    return r && typeof r === 'object' && ('affectedRows' in r || 'fieldCount' in r || 'insertId' in r);
+}
+/**
+ * Normaliza o tuplo `[result, fields]` do mysql2 para o formato QueryResult.
+ *
+ * - SELECT / SHOW → `result` é um array de row objects.
+ * - INSERT / UPDATE / DELETE / DDL → `result` é um ResultSetHeader.
+ * - Multi-statement (migrations) → `result` é um array de ResultSetHeaders/arrays;
+ *   agregamos os affectedRows e não devolvemos linhas.
+ */
+export function normalizeResult(raw, fields) {
+    if (Array.isArray(raw)) {
+        // Multi-statement: elementos são headers (ou arrays de rows por statement).
+        const multi = raw.length > 0 && raw.some((r) => isResultSetHeader(r) || Array.isArray(r));
+        if (multi) {
+            const total = raw.reduce((acc, r) => acc + (r && typeof r.affectedRows === 'number' ? r.affectedRows : 0), 0);
+            return { rows: [], rowCount: total, fields: [] };
+        }
+        // SELECT de um único statement: array de row objects.
+        return { rows: raw, rowCount: raw.length, fields: safeFields(fields) };
+    }
+    // ResultSetHeader (não-SELECT, statement único).
+    const header = raw ?? {};
+    return {
+        rows: [],
+        rowCount: typeof header.affectedRows === 'number' ? header.affectedRows : 0,
+        fields: []
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAGA,SAAS,UAAU,CAAC,MAAsB;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAK,CAAS,CAAC;SACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAG,CAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAM;IAC/B,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAI,GAAQ,EAAE,MAAsB;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,4EAA4E;QAC5E,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CACtB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAChF,CAAC,CACF,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QACD,sDAAsD;QACtD,OAAO,EAAE,IAAI,EAAE,GAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAChF,CAAC;IAED,iDAAiD;IACjD,MAAM,MAAM,GAAG,GAAG,IAAI,EAAE,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

package/dist/transaction.d.ts

@@ -0,0 +1,16 @@
+import type { PoolConnection } from 'mysql2/promise';
+import { Logger } from '@groundbrick/logger';
+import { BaseTransaction, QueryResult } from '@groundbrick/db-core';
+/**
+ * MySQL transaction implementation using the unified BaseTransaction.
+ * Holds a single pooled connection for the lifetime of the transaction.
+ */
+export declare class MysqlTransaction extends BaseTransaction {
+    private readonly connection;
+    constructor(connection: PoolConnection, logger: Logger);
+    query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
+    protected doCommit(): Promise<void>;
+    protected doRollback(): Promise<void>;
+    protected doCleanup(): Promise<void>;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAc,eAAe,EAAE,WAAW,EAAoB,MAAM,sBAAsB,CAAC;AAGlG;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IAEjD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,cAAc,EAC3C,MAAM,EAAE,MAAM;IAKV,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;cA6B9D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;cAKzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;cAK3B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/dist/transaction.js

@@ -0,0 +1,43 @@
+import { QueryError, BaseTransaction, TransactionError } from '@groundbrick/db-core';
+import { normalizeResult } from './result.js';
+/**
+ * MySQL transaction implementation using the unified BaseTransaction.
+ * Holds a single pooled connection for the lifetime of the transaction.
+ */
+export class MysqlTransaction extends BaseTransaction {
+    connection;
+    constructor(connection, logger) {
+        super(logger, 'mysql');
+        this.connection = connection;
+    }
+    async query(sql, params = []) {
+        if (this.completed) {
+            throw new TransactionError('Transaction has already been completed');
+        }
+        try {
+            this.logger.debug('Executing MySQL transaction query', {
+                sql: sql.substring(0, 100) + (sql.length > 100 ? '...' : ''),
+                paramCount: params.length,
+                dbType: this.dbType
+            });
+            const [rows, fields] = await this.connection.query(sql, params);
+            return normalizeResult(rows, fields);
+        }
+        catch (error) {
+            this.logger.error('MySQL transaction query failed', error instanceof Error ? error : new Error(String(error)), { error, sql, params, dbType: this.dbType });
+            throw new QueryError(`MySQL transaction query failed: ${error.message}`, sql, params, error);
+        }
+    }
+    async doCommit() {
+        await this.connection.commit();
+        await this.ensureCleanup();
+    }
+    async doRollback() {
+        await this.connection.rollback();
+        await this.ensureCleanup();
+    }
+    async doCleanup() {
+        this.connection.release();
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.js","sourceRoot":"","sources":["../src/transaction.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAe,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAEhC;IADnB,YACmB,UAA0B,EAC3C,MAAc;QAEd,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAHN,eAAU,GAAV,UAAU,CAAgB;IAI7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAU,GAAW,EAAE,SAAgB,EAAE;QAClD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,gBAAgB,CAAC,wCAAwC,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBACrD,GAAG,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,UAAU,EAAE,MAAM,CAAC,MAAM;gBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO,eAAe,CAAI,IAAI,EAAE,MAAa,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,gCAAgC,EAChC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EACzD,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAC5C,CAAC;YACF,MAAM,IAAI,UAAU,CAClB,mCAAoC,KAAe,CAAC,OAAO,EAAE,EAC7D,GAAG,EACH,MAAM,EACN,KAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,UAAU;QACxB,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+import { DatabaseConfig as CoreDatabaseConfig, DatabaseClient, QueryResult, Transaction, Migration, MigrationRecord, HealthCheckResult, ConnectionError, QueryError, MigrationError } from '@groundbrick/db-core';
+/**
+ * MySQL-specific configuration extending the core contract.
+ */
+export interface MysqlConfig extends CoreDatabaseConfig {
+    /**
+     * Allow more than one SQL statement per query() call. Required for running
+     * migration files that contain several DDL statements (mirrors how `pg`
+     * accepts multi-statement strings). App-level queries always use single,
+     * parameterized statements.
+     */
+    multipleStatements?: boolean;
+    timezone?: string;
+    charset?: string;
+}
+export type { DatabaseClient, QueryResult, Transaction, Migration, MigrationRecord, HealthCheckResult, ConnectionError, QueryError, MigrationError };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,kBAAkB,EACpC,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,kBAAkB;IACrD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,YAAY,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACf,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@groundbrick/db-mysql",
+  "version": "0.1.0",
+  "description": "MySQL database client implementing the @groundbrick/db-core contract (mirror of db-postgres).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "typescript",
+    "mysql",
+    "database",
+    "migrations",
+    "connection-pooling",
+    "microframework"
+  ],
+  "author": "Cleiton Marques <cleiton.marques@200.systems>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/200Systems/bitbrick-microframework.git",
+    "directory": "packages/db-mysql"
+  },
+  "dependencies": {
+    "@groundbrick/db-core": "^0.2.1",
+    "@groundbrick/logger": "^0.4.1"
+  },
+  "peerDependencies": {
+    "mysql2": "^3.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "mysql2": "^3.11.0",
+    "typescript": "^5.8.3",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}