@pma-network/sql 1.0.5

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PMA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# @pma-network/sql
+
+MySQL wrapper built on mysql2 with promise-based async operations, connection pooling, and named parameter support.
+
+## Features
+
+- Auto-configuration from environment variables
+- Promise-based async operations
+- Connection pooling
+- Named parameters (`:paramName`) and positional (`?`) placeholders
+- Full TypeScript support
+- Transaction handling with automatic rollback
+- Resource-specific connection strings for FiveM
+
+## Installation
+
+```bash
+pnpm add @pma-network/sql
+```
+
+Or with npm:
+
+```bash
+npm install @pma-network/sql
+```
+
+## Quick Start
+
+Set the connection string environment variable:
+
+```bash
+# server.cfg (resource-specific):
+set pma_characters_connection_string "mysql://user:password@localhost:3306/fivem"
+
+# server.cfg (global fallback):
+set mysql_connection_string "mysql://user:password@localhost:3306/fivem"
+
+# Node.js:
+export mysql_connection_string="mysql://user:password@localhost:3306/mydb"
+```
+
+Import and use:
+
+```typescript
+import db from '@pma-network/sql';
+
+const users = await db.query('SELECT * FROM users WHERE age > :age', { age: 18 });
+const result = await db.insert('INSERT INTO users (name, sex, identifier) VALUES (:name, :sex, :identifier)', {
+  name: 'John Doe',
+  sex: 'm',
+  identifier: 'discord:123456789',
+});
+```
+
+## Usage
+
+### Custom Instances
+
+Create multiple database connections:
+
+```typescript
+import { MySQL } from '@pma-network/sql';
+
+const db1 = new MySQL({
+  host: 'localhost',
+  user: 'root',
+  password: 'password',
+  database: 'mydb',
+});
+
+const db2 = new MySQL({
+  connectionString: 'mysql://user:password@remote:3306/otherdb',
+});
+```
+
+## API Reference
+
+### Configuration
+
+Configuration is read using `GetConvar` (FiveM) with `process.env` fallback.
+
+Priority order:
+
+1. Resource-specific: `{resource_name}_connection_string`
+   - Resource name detected via `GetCurrentResourceName()`
+   - Dashes converted to underscores: `pma-characters` → `pma_characters_connection_string`
+
+2. Global fallback: `mysql_connection_string`
+
+Connection string format: `mysql://username:password@hostname:port/database`
+
+Required: `mysql://` protocol, username, hostname, database name
+
+Optional: password, port (default: 3306)
+
+## Examples
+
+Named parameters:
+```typescript
+await db.query('SELECT * FROM users WHERE name = :name AND age > :age', {
+  name: 'John',
+  age: 18,
+});
+```
+
+Positional parameters:
+```typescript
+await db.query('SELECT * FROM users WHERE name = ? AND age > ?', ['John', 18]);
+```
+
+TypeScript with type definitions:
+```typescript
+import { MySQL, type RowDataPacket } from '@pma-network/sql';
+
+interface User extends RowDataPacket {
+  id: number;
+  name: string;
+  email: string;
+}
+
+const users = await db.query<User[]>('SELECT * FROM users');
+```

package/dist/MySQL.d.ts

@@ -0,0 +1,183 @@
+import type { Pool, PoolConnection, RowDataPacket } from 'mysql2/promise';
+import mysql from 'mysql2/promise';
+import type { ConnectionConfig, InsertResult, QueryParameters, TransactionCallback, UpdateResult } from './types.js';
+/**
+ * MySQL database wrapper with connection pooling and named parameter support.
+ * Automatically reads connection configuration from environment variables.
+ */
+export declare class MySQL {
+    private pool;
+    private namedPlaceholdersCompiler;
+    private debug;
+    private slowQueryThreshold;
+    private resourceName;
+    private collectMetrics;
+    private versionPrefix;
+    private metricsExportResource;
+    private metricsExportFunction;
+    /**
+     * Creates a new MySQL instance with connection pooling.
+     * If no config is provided, it will automatically look for connection strings in environment variables.
+     *
+     * @param config - Optional database configuration. If omitted, uses environment variables.
+     */
+    constructor(config?: ConnectionConfig);
+    private fetchDatabaseVersion;
+    private getConvar;
+    private getConvarInt;
+    private getConvarBool;
+    private getResourceName;
+    private formatResourceConvar;
+    private getDefaultConfig;
+    private validateConnectionString;
+    private parseConnectionString;
+    private normalizeParameters;
+    private setupConvarListeners;
+    private scheduleResourceTick;
+    private exportMetric;
+    private processParameters;
+    private logQuery;
+    private handleError;
+    /**
+     * Executes a SQL query and returns the raw results.
+     * Supports SELECT, INSERT, UPDATE, DELETE, and other SQL statements.
+     *
+     * @param query - SQL query with :name or ? placeholders
+     * @param parameters - Parameter values as object or array
+     * @returns Query result
+     * @example
+     * const result = await db.execute('SELECT * FROM users WHERE id = :id', { id: 1 });
+     */
+    execute<T = unknown>(query: string, parameters?: QueryParameters): Promise<T | null>;
+    /**
+     * Executes a SELECT query and returns rows.
+     * Use for queries returning multiple rows.
+     *
+     * @param query - SELECT query with :name or ? placeholders
+     * @param parameters - Parameter values
+     * @returns Array of rows
+     * @example
+     * const users = await db.query('SELECT * FROM users WHERE age > :age', { age: 18 });
+     */
+    query<T extends RowDataPacket[] = RowDataPacket[]>(query: string, parameters?: QueryParameters): Promise<T | null>;
+    /**
+     * Inserts a row into the database.
+     * Returns the auto-generated ID and affected row count.
+     *
+     * @param query - INSERT query with :name or ? placeholders
+     * @param parameters - Values to insert
+     * @returns Object with insertId and affectedRows
+     * @example
+     * const result = await db.insert(
+     *   'INSERT INTO users (name, email) VALUES (:name, :email)',
+     *   { name: 'John', email: 'john@example.com' }
+     * );
+     * console.log(result.insertId);
+     */
+    insert(query: string, parameters?: QueryParameters): Promise<InsertResult | null>;
+    /**
+     * Updates rows in the database.
+     * Returns the number of affected rows.
+     *
+     * @param query - UPDATE query with :name or ? placeholders
+     * @param parameters - Values to update
+     * @returns Object with affectedRows count
+     * @example
+     * const result = await db.update(
+     *   'UPDATE users SET verified = 1 WHERE id = :id',
+     *   { id: 123 }
+     * );
+     * console.log(result.affectedRows);
+     */
+    update(query: string, parameters?: QueryParameters): Promise<UpdateResult | null>;
+    /**
+     * Returns a single value from the database.
+     * Use for COUNT, SUM, or single column queries.
+     *
+     * @param query - SELECT query returning one column
+     * @param parameters - Parameter values
+     * @returns Value from first column of first row, or null
+     * @example
+     * const count = await db.scalar('SELECT COUNT(*) FROM users');
+     * const name = await db.scalar('SELECT name FROM users WHERE id = :id', { id: 1 });
+     */
+    scalar<T = unknown>(query: string, parameters?: QueryParameters): Promise<T | null>;
+    /**
+     * Returns a single row from the database.
+     * Returns null if no rows match.
+     *
+     * @param query - SELECT query with :name or ? placeholders
+     * @param parameters - Parameter values
+     * @returns Single row or null
+     * @example
+     * const user = await db.single('SELECT * FROM users WHERE id = :id', { id: 1 });
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     */
+    single<T extends RowDataPacket = RowDataPacket>(query: string, parameters?: QueryParameters): Promise<T | null>;
+    /**
+     * Prepares a statement for execution.
+     * Use for executing the same query multiple times with different parameters.
+     *
+     * @param query - SQL query to prepare
+     * @returns Prepared statement
+     * @example
+     * const stmt = await db.prepare('SELECT * FROM users WHERE id = ?');
+     */
+    prepare(query: string): Promise<mysql.PreparedStatementInfo>;
+    /**
+     * Executes multiple queries as an atomic transaction.
+     * All changes are rolled back if any query fails.
+     *
+     * @param callback - Function receiving an execute function for queries
+     * @returns Value returned by callback
+     * @example
+     * await db.transaction(async (execute) => {
+     *   await execute('INSERT INTO accounts (balance) VALUES (:balance)', { balance: 100 });
+     *   await execute('UPDATE users SET has_account = 1 WHERE id = :id', { id: 1 });
+     * });
+     */
+    transaction<T = unknown>(callback: TransactionCallback): Promise<T | null>;
+    /**
+     * Executes a query with positional parameters.
+     * Skips named parameter processing. Use ? placeholders only.
+     *
+     * @param query - SQL query with ? placeholders
+     * @param parameters - Array of values for placeholders
+     * @returns Query result
+     * @example
+     * const result = await db.rawExecute('SELECT * FROM users WHERE id = ?', [1]);
+     */
+    rawExecute<T = unknown>(query: string, parameters?: unknown[]): Promise<T | null>;
+    /**
+     * Returns a connection from the pool.
+     * Must call connection.release() when finished.
+     *
+     * @returns Database connection
+     * @example
+     * const connection = await db.getConnection();
+     * try {
+     *   await connection.query('SELECT * FROM users');
+     * } finally {
+     *   connection.release();
+     * }
+     */
+    getConnection(): Promise<PoolConnection>;
+    /**
+     * Closes all connections in the pool.
+     * Call when shutting down the application.
+     *
+     * @example
+     * await db.end();
+     */
+    end(): Promise<void>;
+    /**
+     * Returns the underlying mysql2 connection pool.
+     * Use for direct access to pool-specific methods.
+     *
+     * @returns mysql2 Pool instance
+     */
+    getPool(): Pool;
+}
+//# sourceMappingURL=MySQL.d.ts.map

package/dist/MySQL.d.ts.map

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

package/dist/MySQL.js

@@ -0,0 +1,574 @@
+import { performance } from 'node:perf_hooks';
+import mysql from 'mysql2/promise';
+import namedPlaceholders from 'named-placeholders';
+/**
+ * MySQL database wrapper with connection pooling and named parameter support.
+ * Automatically reads connection configuration from environment variables.
+ */
+export class MySQL {
+    pool;
+    namedPlaceholdersCompiler;
+    debug;
+    slowQueryThreshold;
+    resourceName;
+    collectMetrics;
+    versionPrefix = '';
+    metricsExportResource;
+    metricsExportFunction;
+    /**
+     * Creates a new MySQL instance with connection pooling.
+     * If no config is provided, it will automatically look for connection strings in environment variables.
+     *
+     * @param config - Optional database configuration. If omitted, uses environment variables.
+     */
+    constructor(config) {
+        this.resourceName = this.getResourceName();
+        this.debug = this.getConvarBool('mysql_debug', false);
+        this.slowQueryThreshold = this.getConvarInt('mysql_slow_query_warning', 150);
+        this.collectMetrics = this.getConvarBool('mysql_query_metrics', false);
+        this.metricsExportResource = this.getConvar('mysql_metrics_export_resource');
+        this.metricsExportFunction = this.getConvar('mysql_metrics_export_function');
+        this.setupConvarListeners();
+        const finalConfig = config || this.getDefaultConfig();
+        const poolConfig = finalConfig.connectionString
+            ? this.parseConnectionString(finalConfig.connectionString)
+            : finalConfig;
+        this.pool = mysql.createPool({
+            waitForConnections: true,
+            connectionLimit: 10,
+            queueLimit: 0,
+            ...poolConfig,
+        });
+        this.namedPlaceholdersCompiler = namedPlaceholders();
+        this.fetchDatabaseVersion();
+    }
+    async fetchDatabaseVersion() {
+        try {
+            const connection = await this.pool.getConnection();
+            try {
+                const serverVersion = connection.connection?._handshakePacket?.serverVersion;
+                if (serverVersion) {
+                    this.versionPrefix = `^4[${serverVersion}]^0 `;
+                }
+            }
+            finally {
+                connection.release();
+            }
+        }
+        catch {
+        }
+    }
+    getConvar(varName) {
+        if (typeof globalThis.GetConvar === 'function') {
+            return globalThis.GetConvar(varName, '') || null;
+        }
+        return process.env[varName] || null;
+    }
+    getConvarInt(varName, defaultValue) {
+        if (typeof globalThis.GetConvarInt === 'function') {
+            return globalThis.GetConvarInt(varName, defaultValue);
+        }
+        const envValue = process.env[varName];
+        if (envValue) {
+            const parsed = parseInt(envValue, 10);
+            return Number.isNaN(parsed) ? defaultValue : parsed;
+        }
+        return defaultValue;
+    }
+    getConvarBool(varName, defaultValue) {
+        if (typeof globalThis.GetConvarBool === 'function') {
+            return globalThis.GetConvarBool(varName, defaultValue);
+        }
+        const envValue = process.env[varName];
+        if (envValue !== undefined) {
+            return envValue === 'true' || envValue === '1';
+        }
+        return defaultValue;
+    }
+    getResourceName() {
+        if (typeof globalThis.GetCurrentResourceName === 'function') {
+            return globalThis.GetCurrentResourceName() || null;
+        }
+        return this.getConvar('RESOURCE_NAME');
+    }
+    formatResourceConvar(resourceName) {
+        return resourceName.replace(/-/g, '_').toLowerCase();
+    }
+    getDefaultConfig() {
+        let connectionString = null;
+        const resourceName = this.getResourceName();
+        if (resourceName) {
+            const resourceConvar = this.formatResourceConvar(resourceName);
+            connectionString = this.getConvar(`${resourceConvar}_connection_string`);
+        }
+        if (!connectionString) {
+            connectionString = this.getConvar('mysql_connection_string');
+        }
+        if (!connectionString) {
+            const resourceHint = resourceName
+                ? `\nTried: ${this.formatResourceConvar(resourceName)}_connection_string and mysql_connection_string`
+                : '\nTried: mysql_connection_string';
+            throw new Error('No MySQL connection string found. ' +
+                'Please set a connection string: ' +
+                'mysql://user:password@host:port/database' +
+                resourceHint);
+        }
+        this.validateConnectionString(connectionString);
+        return { connectionString };
+    }
+    validateConnectionString(connectionString) {
+        try {
+            const url = new URL(connectionString);
+            if (url.protocol !== 'mysql:') {
+                throw new Error(`Invalid protocol "${url.protocol}". Expected "mysql:". ` +
+                    'Connection string must start with mysql://');
+            }
+            if (!url.hostname) {
+                throw new Error('Connection string must include a hostname');
+            }
+            if (!url.pathname || url.pathname === '/') {
+                throw new Error('Connection string must include a database name');
+            }
+            if (!url.username) {
+                throw new Error('Connection string must include a username');
+            }
+        }
+        catch (error) {
+            if (error instanceof TypeError) {
+                throw new Error('Invalid connection string format. Expected: mysql://user:password@host:port/database');
+            }
+            throw error;
+        }
+    }
+    parseConnectionString(connectionString) {
+        const url = new URL(connectionString);
+        return {
+            host: url.hostname,
+            port: url.port ? parseInt(url.port, 10) : 3306,
+            user: url.username,
+            password: url.password,
+            database: url.pathname.slice(1),
+        };
+    }
+    normalizeParameters(parameters) {
+        if (Array.isArray(parameters)) {
+            for (let i = 0; i < parameters.length; i++) {
+                if (parameters[i] === undefined) {
+                    parameters[i] = null;
+                }
+            }
+        }
+        else {
+            for (const key in parameters) {
+                if (parameters[key] === undefined) {
+                    parameters[key] = null;
+                }
+            }
+        }
+    }
+    setupConvarListeners() {
+        if (typeof globalThis.AddConvarChangeListener === 'function') {
+            globalThis.AddConvarChangeListener('mysql_*', (convarName) => {
+                if (convarName === 'mysql_debug') {
+                    this.debug = this.getConvarBool('mysql_debug', false);
+                    console.log(`^2Convar changed: mysql_debug = ${this.debug}^0`);
+                }
+                else if (convarName === 'mysql_slow_query_warning') {
+                    this.slowQueryThreshold = this.getConvarInt('mysql_slow_query_warning', 150);
+                    console.log(`^2Convar changed: mysql_slow_query_warning = ${this.slowQueryThreshold}^0`);
+                }
+                else if (convarName === 'mysql_query_metrics') {
+                    this.collectMetrics = this.getConvarBool('mysql_query_metrics', false);
+                    console.log(`^2Convar changed: mysql_query_metrics = ${this.collectMetrics}^0`);
+                }
+                else if (convarName === 'mysql_metrics_export_resource') {
+                    this.metricsExportResource = this.getConvar('mysql_metrics_export_resource');
+                    console.log(`^2Convar changed: mysql_metrics_export_resource = ${this.metricsExportResource}^0`);
+                }
+                else if (convarName === 'mysql_metrics_export_function') {
+                    this.metricsExportFunction = this.getConvar('mysql_metrics_export_function');
+                    console.log(`^2Convar changed: mysql_metrics_export_function = ${this.metricsExportFunction}^0`);
+                }
+            });
+        }
+    }
+    scheduleResourceTick() {
+        if (typeof globalThis.ScheduleResourceTick === 'function' && this.resourceName) {
+            globalThis.ScheduleResourceTick(this.resourceName);
+        }
+    }
+    exportMetric(metric) {
+        if (this.metricsExportResource && this.metricsExportFunction) {
+            try {
+                exports[this.metricsExportResource]?.[this.metricsExportFunction]?.(metric);
+            }
+            catch (error) { }
+        }
+    }
+    processParameters(query, parameters) {
+        const processedQuery = query.replace(/@/g, ':');
+        if (!parameters) {
+            return [processedQuery, []];
+        }
+        this.normalizeParameters(parameters);
+        if (Array.isArray(parameters)) {
+            return [processedQuery, parameters];
+        }
+        const [finalQuery, processedParams] = this.namedPlaceholdersCompiler(processedQuery, parameters);
+        return [finalQuery, processedParams];
+    }
+    logQuery(query, executionTime, parameters, error) {
+        if (this.collectMetrics) {
+            const metric = {
+                query,
+                executionTime,
+                timestamp: Date.now(),
+                resource: this.resourceName || undefined,
+            };
+            this.exportMetric(metric);
+        }
+        const isSlowQuery = executionTime >= this.slowQueryThreshold;
+        if (this.debug || isSlowQuery || error) {
+            const resourceName = this.resourceName || 'pma-sql';
+            let color;
+            let statusText;
+            if (error) {
+                color = '^1';
+                statusText = `${this.versionPrefix}${color}Query failed^0`;
+            }
+            else {
+                color = isSlowQuery ? '^3' : '^2';
+                statusText = `${this.versionPrefix}${color}${resourceName} took ${executionTime.toFixed(4)}ms to execute a query!^0`;
+            }
+            console.log(statusText);
+            console.log(`${color}${query} [${parameters && parameters.length > 0 ? parameters.join(',') : ''}]^0`);
+            if (error) {
+                console.log(`^1Error: ${error.message}^0`);
+            }
+        }
+    }
+    handleError(error) {
+        if (typeof globalThis.printError === 'function') {
+            globalThis.printError(error);
+        }
+        else {
+            throw error;
+        }
+    }
+    /**
+     * Executes a SQL query and returns the raw results.
+     * Supports SELECT, INSERT, UPDATE, DELETE, and other SQL statements.
+     *
+     * @param query - SQL query with :name or ? placeholders
+     * @param parameters - Parameter values as object or array
+     * @returns Query result
+     * @example
+     * const result = await db.execute('SELECT * FROM users WHERE id = :id', { id: 1 });
+     */
+    async execute(query, parameters) {
+        this.scheduleResourceTick();
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [results] = await this.pool.execute(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            return results;
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Executes a SELECT query and returns rows.
+     * Use for queries returning multiple rows.
+     *
+     * @param query - SELECT query with :name or ? placeholders
+     * @param parameters - Parameter values
+     * @returns Array of rows
+     * @example
+     * const users = await db.query('SELECT * FROM users WHERE age > :age', { age: 18 });
+     */
+    async query(query, parameters) {
+        this.scheduleResourceTick();
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [rows] = await this.pool.query(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            return rows;
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Inserts a row into the database.
+     * Returns the auto-generated ID and affected row count.
+     *
+     * @param query - INSERT query with :name or ? placeholders
+     * @param parameters - Values to insert
+     * @returns Object with insertId and affectedRows
+     * @example
+     * const result = await db.insert(
+     *   'INSERT INTO users (name, email) VALUES (:name, :email)',
+     *   { name: 'John', email: 'john@example.com' }
+     * );
+     * console.log(result.insertId);
+     */
+    async insert(query, parameters) {
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [result] = await this.pool.execute(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            return {
+                insertId: result.insertId,
+                affectedRows: result.affectedRows,
+            };
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Updates rows in the database.
+     * Returns the number of affected rows.
+     *
+     * @param query - UPDATE query with :name or ? placeholders
+     * @param parameters - Values to update
+     * @returns Object with affectedRows count
+     * @example
+     * const result = await db.update(
+     *   'UPDATE users SET verified = 1 WHERE id = :id',
+     *   { id: 123 }
+     * );
+     * console.log(result.affectedRows);
+     */
+    async update(query, parameters) {
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [result] = await this.pool.execute(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            return {
+                affectedRows: result.affectedRows,
+            };
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Returns a single value from the database.
+     * Use for COUNT, SUM, or single column queries.
+     *
+     * @param query - SELECT query returning one column
+     * @param parameters - Parameter values
+     * @returns Value from first column of first row, or null
+     * @example
+     * const count = await db.scalar('SELECT COUNT(*) FROM users');
+     * const name = await db.scalar('SELECT name FROM users WHERE id = :id', { id: 1 });
+     */
+    async scalar(query, parameters) {
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [rows] = await this.pool.query(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            if (!rows || rows.length === 0) {
+                return null;
+            }
+            const firstRow = rows[0];
+            const firstColumn = Object.values(firstRow)[0];
+            return firstColumn;
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Returns a single row from the database.
+     * Returns null if no rows match.
+     *
+     * @param query - SELECT query with :name or ? placeholders
+     * @param parameters - Parameter values
+     * @returns Single row or null
+     * @example
+     * const user = await db.single('SELECT * FROM users WHERE id = :id', { id: 1 });
+     * if (user) {
+     *   console.log(user.name);
+     * }
+     */
+    async single(query, parameters) {
+        const startTime = performance.now();
+        const [processedQuery, processedParams] = this.processParameters(query, parameters);
+        try {
+            const [rows] = await this.pool.query(processedQuery, processedParams);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams);
+            return rows.length > 0 ? rows[0] : null;
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, processedParams, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Prepares a statement for execution.
+     * Use for executing the same query multiple times with different parameters.
+     *
+     * @param query - SQL query to prepare
+     * @returns Prepared statement
+     * @example
+     * const stmt = await db.prepare('SELECT * FROM users WHERE id = ?');
+     */
+    async prepare(query) {
+        this.scheduleResourceTick();
+        const connection = await this.pool.getConnection();
+        try {
+            const processedQuery = query.replace(/@/g, ':');
+            const statement = await connection.prepare(processedQuery);
+            return statement;
+        }
+        finally {
+            connection.release();
+        }
+    }
+    /**
+     * Executes multiple queries as an atomic transaction.
+     * All changes are rolled back if any query fails.
+     *
+     * @param callback - Function receiving an execute function for queries
+     * @returns Value returned by callback
+     * @example
+     * await db.transaction(async (execute) => {
+     *   await execute('INSERT INTO accounts (balance) VALUES (:balance)', { balance: 100 });
+     *   await execute('UPDATE users SET has_account = 1 WHERE id = :id', { id: 1 });
+     * });
+     */
+    async transaction(callback) {
+        this.scheduleResourceTick();
+        const connection = await this.pool.getConnection();
+        try {
+            await connection.beginTransaction();
+            const executeInTransaction = async (query, parameters) => {
+                this.scheduleResourceTick();
+                const startTime = performance.now();
+                const [processedQuery, processedParams] = this.processParameters(query, parameters);
+                try {
+                    const [result] = await connection.execute(processedQuery, processedParams);
+                    const executionTime = performance.now() - startTime;
+                    this.logQuery(processedQuery, executionTime, processedParams);
+                    return result;
+                }
+                catch (error) {
+                    const executionTime = performance.now() - startTime;
+                    this.logQuery(processedQuery, executionTime, processedParams, error);
+                    throw error;
+                }
+            };
+            const result = await callback(executeInTransaction);
+            await connection.commit();
+            return result;
+        }
+        catch (error) {
+            await connection.rollback();
+            this.handleError(error);
+            return null;
+        }
+        finally {
+            connection.release();
+        }
+    }
+    /**
+     * Executes a query with positional parameters.
+     * Skips named parameter processing. Use ? placeholders only.
+     *
+     * @param query - SQL query with ? placeholders
+     * @param parameters - Array of values for placeholders
+     * @returns Query result
+     * @example
+     * const result = await db.rawExecute('SELECT * FROM users WHERE id = ?', [1]);
+     */
+    async rawExecute(query, parameters) {
+        this.scheduleResourceTick();
+        const startTime = performance.now();
+        const processedQuery = query.replace(/@/g, ':');
+        const params = parameters || [];
+        for (let i = 0; i < params.length; i++) {
+            if (params[i] === undefined) {
+                params[i] = null;
+            }
+        }
+        try {
+            const [results] = await this.pool.execute(processedQuery, params);
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, params);
+            return results;
+        }
+        catch (error) {
+            const executionTime = performance.now() - startTime;
+            this.logQuery(processedQuery, executionTime, params, error);
+            this.handleError(error);
+            return null;
+        }
+    }
+    /**
+     * Returns a connection from the pool.
+     * Must call connection.release() when finished.
+     *
+     * @returns Database connection
+     * @example
+     * const connection = await db.getConnection();
+     * try {
+     *   await connection.query('SELECT * FROM users');
+     * } finally {
+     *   connection.release();
+     * }
+     */
+    async getConnection() {
+        return this.pool.getConnection();
+    }
+    /**
+     * Closes all connections in the pool.
+     * Call when shutting down the application.
+     *
+     * @example
+     * await db.end();
+     */
+    async end() {
+        await this.pool.end();
+    }
+    /**
+     * Returns the underlying mysql2 connection pool.
+     * Use for direct access to pool-specific methods.
+     *
+     * @returns mysql2 Pool instance
+     */
+    getPool() {
+        return this.pool;
+    }
+}
+//# sourceMappingURL=MySQL.js.map

package/dist/MySQL.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { MySQL } from './MySQL.js';
+export { MySQL };
+export type { ConnectionConfig, FieldPacket, InsertResult, Pool, PoolOptions, QueryMetrics, QueryParameters, QueryResult, ResultSetHeader, RowDataPacket, TransactionCallback, UpdateResult, } from './types.js';
+export declare const db: MySQL;
+export default db;
+//# 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,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,EAAE,OAAc,CAAC;AAC9B,eAAe,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { MySQL } from './MySQL.js';
+export { MySQL };
+export const db = new MySQL();
+export default db;
+//# 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,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,CAAC;AAgBjB,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC;AAC9B,eAAe,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { Pool, PoolOptions, RowDataPacket, ResultSetHeader, FieldPacket } from 'mysql2/promise';
+export interface ConnectionConfig extends PoolOptions {
+    connectionString?: string;
+}
+export type QueryParameters = Record<string, any> | any[];
+export type QueryResult<T = any> = T extends RowDataPacket[] ? T : any;
+export interface InsertResult {
+    insertId: number;
+    affectedRows: number;
+}
+export interface UpdateResult {
+    affectedRows: number;
+}
+export interface TransactionCallback {
+    (execute: (query: string, parameters?: QueryParameters) => Promise<any>): Promise<any>;
+}
+export interface QueryMetrics {
+    query: string;
+    executionTime: number;
+    timestamp: number;
+    resource?: string;
+}
+export { Pool, PoolOptions, RowDataPacket, ResultSetHeader, FieldPacket };
+//# 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,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErG,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;AAE1D,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,aAAa,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACxF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,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,49 @@
+{
+  "name": "@pma-network/sql",
+  "version": "1.0.5",
+  "description": "MySQL wrapper with promise-based async operations, connection pooling, and named parameters support",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mysql",
+    "mysql2",
+    "database",
+    "sql",
+    "async",
+    "promise",
+    "typescript",
+    "fivem",
+    "connection-pooling",
+    "named-parameters"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pma-rp/pma-sql.git"
+  },
+  "bugs": {
+    "url": "https://github.com/pma-rp/pma-sql/issues"
+  },
+  "homepage": "https://github.com/pma-rp/pma-sql#readme",
+  "dependencies": {
+    "mysql2": "^3.11.3",
+    "named-placeholders": "^1.1.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.6.2"
+  },
+  "engines": {
+    "node": ">=16.9.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  }
+}