@elaraai/east-node-io 0.0.1-beta.1 → 0.0.1-beta.11

package/dist/sql/mysql.d.ts

@@ -0,0 +1,238 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * MySQL platform functions for East Node IO.
+ *
+ * Provides MySQL database operations for East programs, including
+ * connection pooling and parameterized query execution.
+ *
+ * @packageDocumentation
+ */
+import { BlobType, BooleanType, DateTimeType, FloatType, IntegerType, NullType, StringType as EastStringType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+import { StringType } from './types.js';
+/**
+ * Connects to a MySQL database.
+ *
+ * Creates a connection pool to a MySQL database and returns an
+ * opaque handle for use in queries. The connection pool is managed
+ * automatically and supports concurrent queries.
+ *
+ * This is a platform function for the East language, enabling MySQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param config - MySQL connection configuration
+ * @returns Connection handle (opaque string)
+ *
+ * @throws {EastError} When connection fails due to:
+ * - Network errors (location: "mysql_connect")
+ * - Authentication failures (location: "mysql_connect")
+ * - Invalid configuration (location: "mysql_connect")
+ * - Database does not exist (location: "mysql_connect")
+ *
+ * @example
+ * ```ts
+ * import { East, StringType, IntegerType } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const getUserById = East.function([IntegerType], NullType, ($, userId) => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     $(SQL.MySQL.query(
+ *         conn,
+ *         "SELECT name FROM users WHERE id = ?",
+ *         [variant('Integer', userId)]
+ *     ));
+ *     $(SQL.MySQL.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(getUserById.toIR(), SQL.MySQL.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses connection pooling for better performance
+ * - Default pool size is 10 connections
+ * - All queries are asynchronous
+ * - Connections are automatically returned to the pool after queries
+ */
+export declare const mysql_connect: import("@elaraai/east").AsyncPlatformDefinition<[import("@elaraai/east").StructType<{
+    host: EastStringType;
+    port: IntegerType;
+    database: EastStringType;
+    user: EastStringType;
+    password: EastStringType;
+    ssl: import("@elaraai/east").OptionType<BooleanType>;
+    maxConnections: import("@elaraai/east").OptionType<IntegerType>;
+}>], EastStringType>;
+/**
+ * Executes a SQL query with parameterized values.
+ *
+ * Runs a SQL query against a MySQL database with parameter binding for
+ * safe, injection-free queries. Returns rows as dictionaries mapping column
+ * names to typed values, along with metadata about affected rows.
+ *
+ * This is a platform function for the East language, enabling SQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param handle - Connection handle from mysql_connect()
+ * @param sql - SQL query string with ? placeholders
+ * @param params - Query parameters as SqlParameterType array
+ * @returns Query results with rows and metadata
+ *
+ * @throws {EastError} When query fails due to:
+ * - Invalid connection handle (location: "mysql_query")
+ * - SQL syntax errors (location: "mysql_query")
+ * - Connection timeout (location: "mysql_query")
+ * - Parameter type mismatch (location: "mysql_query")
+ * - Constraint violations (location: "mysql_query")
+ *
+ * @example
+ * ```ts
+ * import { East, IntegerType, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const insertUser = East.function([IntegerType], NullType, ($, userId) => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     const result = $.let(SQL.MySQL.query(
+ *         conn,
+ *         "INSERT INTO users (name, email) VALUES (?, ?)",
+ *         [variant('String', "Alice"), variant('String', "alice@example.com")]
+ *     ));
+ *     $(SQL.MySQL.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(insertUser.toIR(), SQL.MySQL.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses ? for parameter placeholders (not $1, $2 like PostgreSQL)
+ * - NULL values map to {tag: "null", value: {}}
+ * - All queries are asynchronous
+ * - Parameters prevent SQL injection attacks
+ * - Returns lastInsertId for INSERT operations
+ */
+export declare const mysql_query: import("@elaraai/east").AsyncPlatformDefinition<[EastStringType, EastStringType, import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+    Null: NullType;
+    Boolean: BooleanType;
+    Integer: IntegerType;
+    Float: FloatType;
+    String: StringType;
+    DateTime: DateTimeType;
+    Blob: BlobType;
+}>>], import("@elaraai/east").VariantType<{
+    select: import("@elaraai/east").StructType<{
+        rows: import("@elaraai/east").ArrayType<import("@elaraai/east").DictType<EastStringType, import("@elaraai/east").VariantType<{
+            Null: NullType;
+            Boolean: BooleanType;
+            Integer: IntegerType;
+            Float: FloatType;
+            String: StringType;
+            DateTime: DateTimeType;
+            Blob: BlobType;
+        }>>>;
+    }>;
+    insert: import("@elaraai/east").StructType<{
+        rowsAffected: IntegerType;
+        lastInsertId: import("@elaraai/east").OptionType<IntegerType>;
+    }>;
+    update: import("@elaraai/east").StructType<{
+        rowsAffected: IntegerType;
+    }>;
+    delete: import("@elaraai/east").StructType<{
+        rowsAffected: IntegerType;
+    }>;
+}>>;
+/**
+ * Closes a MySQL connection pool.
+ *
+ * Closes the connection pool and releases all resources.
+ * All active connections are terminated gracefully.
+ *
+ * @param handle - Connection handle from mysql_connect()
+ *
+ * @throws {EastError} When handle is invalid (location: "mysql_close")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const cleanup = East.function([], NullType, $ => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     // ... do work ...
+ *     $(SQL.MySQL.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanup.toIR(), SQL.MySQL.Implementation);
+ * await compiled();
+ * ```
+ */
+export declare const mysql_close: import("@elaraai/east").AsyncPlatformDefinition<[EastStringType], NullType>;
+/**
+ * Closes all MySQL connections.
+ *
+ * Closes all active MySQL connection pools and releases all resources.
+ * Useful for test cleanup to ensure all connections are closed.
+ *
+ * @returns Null on success
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const cleanupAll = East.function([], NullType, $ => {
+ *     // ... test code that may have left connections open ...
+ *     $(SQL.MySQL.closeAll());
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanupAll.toIR(), SQL.MySQL.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @internal
+ */
+export declare const mysql_close_all: import("@elaraai/east").AsyncPlatformDefinition<[], NullType>;
+/**
+ * Node.js implementation of MySQL platform functions.
+ *
+ * Provides the runtime implementations for MySQL operations.
+ * Pass this to East.compileAsync() to enable MySQL functionality.
+ */
+export declare const MySqlImpl: PlatformFunction[];
+//# sourceMappingURL=mysql.d.ts.map

package/dist/sql/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/sql/mysql.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAQ,SAAS,EAAE,WAAW,EAAoB,QAAQ,EAAa,UAAU,IAAI,cAAc,EAAW,MAAM,eAAe,CAAC;AAEhL,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,OAAO,EAKH,UAAU,EAEb,MAAM,YAAY,CAAC;AA+BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,aAAa;;;;;;;;oBAA+E,CAAC;AAE1G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA0G,CAAC;AAEnI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,WAAW,6EAAsE,CAAC;AAE/F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,eAAe,+DAAsD,CAAC;AAuFnF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,EAAE,gBAAgB,EA4IvC,CAAC"}

package/dist/sql/mysql.js

@@ -0,0 +1,396 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * MySQL platform functions for East Node IO.
+ *
+ * Provides MySQL database operations for East programs, including
+ * connection pooling and parameterized query execution.
+ *
+ * @packageDocumentation
+ */
+import { BlobType, BooleanType, DateTimeType, East, FloatType, IntegerType, isValueOf, match, NullType, SortedMap, StringType as EastStringType, variant } from "@elaraai/east";
+import { EastError } from "@elaraai/east/internal";
+import mysql from 'mysql2/promise';
+import { createHandle, getConnection, closeHandle, closeAllHandles } from '../connection/index.js';
+import { MySqlConfigType, ConnectionHandleType, SqlParametersType, SqlResultType, StringType, SqlParameterType } from './types.js';
+/**
+ * Connects to a MySQL database.
+ *
+ * Creates a connection pool to a MySQL database and returns an
+ * opaque handle for use in queries. The connection pool is managed
+ * automatically and supports concurrent queries.
+ *
+ * This is a platform function for the East language, enabling MySQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param config - MySQL connection configuration
+ * @returns Connection handle (opaque string)
+ *
+ * @throws {EastError} When connection fails due to:
+ * - Network errors (location: "mysql_connect")
+ * - Authentication failures (location: "mysql_connect")
+ * - Invalid configuration (location: "mysql_connect")
+ * - Database does not exist (location: "mysql_connect")
+ *
+ * @example
+ * ```ts
+ * import { East, StringType, IntegerType } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const getUserById = East.function([IntegerType], NullType, ($, userId) => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     $(SQL.MySQL.query(
+ *         conn,
+ *         "SELECT name FROM users WHERE id = ?",
+ *         [variant('Integer', userId)]
+ *     ));
+ *     $(SQL.MySQL.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(getUserById.toIR(), SQL.MySQL.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses connection pooling for better performance
+ * - Default pool size is 10 connections
+ * - All queries are asynchronous
+ * - Connections are automatically returned to the pool after queries
+ */
+export const mysql_connect = East.asyncPlatform("mysql_connect", [MySqlConfigType], ConnectionHandleType);
+/**
+ * Executes a SQL query with parameterized values.
+ *
+ * Runs a SQL query against a MySQL database with parameter binding for
+ * safe, injection-free queries. Returns rows as dictionaries mapping column
+ * names to typed values, along with metadata about affected rows.
+ *
+ * This is a platform function for the East language, enabling SQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param handle - Connection handle from mysql_connect()
+ * @param sql - SQL query string with ? placeholders
+ * @param params - Query parameters as SqlParameterType array
+ * @returns Query results with rows and metadata
+ *
+ * @throws {EastError} When query fails due to:
+ * - Invalid connection handle (location: "mysql_query")
+ * - SQL syntax errors (location: "mysql_query")
+ * - Connection timeout (location: "mysql_query")
+ * - Parameter type mismatch (location: "mysql_query")
+ * - Constraint violations (location: "mysql_query")
+ *
+ * @example
+ * ```ts
+ * import { East, IntegerType, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const insertUser = East.function([IntegerType], NullType, ($, userId) => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     const result = $.let(SQL.MySQL.query(
+ *         conn,
+ *         "INSERT INTO users (name, email) VALUES (?, ?)",
+ *         [variant('String', "Alice"), variant('String', "alice@example.com")]
+ *     ));
+ *     $(SQL.MySQL.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(insertUser.toIR(), SQL.MySQL.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses ? for parameter placeholders (not $1, $2 like PostgreSQL)
+ * - NULL values map to {tag: "null", value: {}}
+ * - All queries are asynchronous
+ * - Parameters prevent SQL injection attacks
+ * - Returns lastInsertId for INSERT operations
+ */
+export const mysql_query = East.asyncPlatform("mysql_query", [ConnectionHandleType, StringType, SqlParametersType], SqlResultType);
+/**
+ * Closes a MySQL connection pool.
+ *
+ * Closes the connection pool and releases all resources.
+ * All active connections are terminated gracefully.
+ *
+ * @param handle - Connection handle from mysql_connect()
+ *
+ * @throws {EastError} When handle is invalid (location: "mysql_close")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const cleanup = East.function([], NullType, $ => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 3306n,
+ *         database: "myapp",
+ *         user: "root",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.MySQL.connect(config));
+ *     // ... do work ...
+ *     $(SQL.MySQL.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanup.toIR(), SQL.MySQL.Implementation);
+ * await compiled();
+ * ```
+ */
+export const mysql_close = East.asyncPlatform("mysql_close", [ConnectionHandleType], NullType);
+/**
+ * Closes all MySQL connections.
+ *
+ * Closes all active MySQL connection pools and releases all resources.
+ * Useful for test cleanup to ensure all connections are closed.
+ *
+ * @returns Null on success
+ *
+ * @example
+ * ```ts
+ * import { East, NullType } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const cleanupAll = East.function([], NullType, $ => {
+ *     // ... test code that may have left connections open ...
+ *     $(SQL.MySQL.closeAll());
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanupAll.toIR(), SQL.MySQL.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @internal
+ */
+export const mysql_close_all = East.asyncPlatform("mysql_close_all", [], NullType);
+/**
+ * Converts East SQL parameter to native JavaScript value.
+ *
+ * @param param - East SQL parameter variant
+ * @returns JavaScript value for MySQL binding
+ * @internal
+ */
+function convertParamToNative(param) {
+    return match(param, {
+        String: (value) => value,
+        Integer: (value) => Number(value), // MySQL client handles numbers
+        Float: (value) => value,
+        Boolean: (value) => value,
+        Null: (value) => value,
+        Blob: (value) => Buffer.from(value), // Convert Uint8Array to Buffer
+        DateTime: (value) => value, // Pass Date object directly to MySQL
+    });
+}
+/**
+ * Converts native JavaScript value to East SQL parameter variant.
+ *
+ * @param value - Native JavaScript value from MySQL
+ * @param fieldType - MySQL field type code from field metadata
+ * @returns East SQL parameter variant
+ * @internal
+ */
+function convertNativeToParam(value, fieldType) {
+    if (isValueOf(value, NullType)) {
+        return variant('Null', null);
+    }
+    else if (((fieldType === null) &&
+        isValueOf(value, BooleanType)) || ((fieldType === 1 || fieldType === 16) && // TINY (as boolean), BIT
+        (isValueOf(value, BooleanType) || isValueOf(value, FloatType)))) {
+        return variant('Boolean', value ? true : false);
+    }
+    else if (((fieldType === null) &&
+        isValueOf(value, IntegerType)) || ((fieldType === 2 || fieldType === 3 || fieldType === 8 || fieldType === 9 || fieldType === 13) && // SHORT, LONG, LONGLONG, INT24, YEAR (not TINY=1)
+        (isValueOf(value, IntegerType) || isValueOf(value, FloatType)))) {
+        return variant('Integer', BigInt(value));
+    }
+    else if ((fieldType === 0 || fieldType === 4 || fieldType === 5 || fieldType === 246 || fieldType === null) && // DECIMAL, FLOAT, DOUBLE, NEWDECIMAL
+        isValueOf(value, FloatType)) {
+        return variant('Float', value);
+    }
+    else if ((fieldType === 253 || fieldType === 254 || fieldType === null) && // VARCHAR, STRING (CHAR)
+        isValueOf(value, EastStringType)) {
+        return variant('String', value);
+    }
+    else if ((fieldType === 252 || fieldType === null) && // BLOB or TEXT (252 is used for both!)
+        isValueOf(value, EastStringType) // Check string first for TEXT columns
+    ) {
+        return variant('String', value);
+    }
+    else if (((fieldType === null) &&
+        isValueOf(value, DateTimeType)) || ((fieldType === 7 || fieldType === 10 || fieldType === 11 || fieldType === 12) && // TIMESTAMP, DATE, TIME, DATETIME
+        isValueOf(value, DateTimeType))) {
+        return variant('DateTime', value);
+    }
+    else if ((fieldType === 252 || fieldType === null) && // BLOB or TEXT (check Blob after String)
+        isValueOf(value, BlobType)) {
+        return variant('Blob', value);
+    }
+    else {
+        return variant('Null', null);
+    }
+}
+/**
+ * Node.js implementation of MySQL platform functions.
+ *
+ * Provides the runtime implementations for MySQL operations.
+ * Pass this to East.compileAsync() to enable MySQL functionality.
+ */
+export const MySqlImpl = [
+    mysql_connect.implement(async (config) => {
+        try {
+            const poolConfig = {
+                host: config.host,
+                port: Number(config.port),
+                database: config.database,
+                user: config.user,
+                password: config.password,
+            };
+            // Handle optional SSL
+            if (config.ssl?.type === 'some' && config.ssl.value) {
+                poolConfig.ssl = {};
+            }
+            // Handle optional max connections
+            if (config.maxConnections?.type === 'some') {
+                poolConfig.connectionLimit = Number(config.maxConnections.value);
+            }
+            const pool = mysql.createPool(poolConfig);
+            // Test the connection
+            const connection = await pool.getConnection();
+            connection.release();
+            return createHandle(pool, async () => {
+                await pool.end();
+            });
+        }
+        catch (err) {
+            throw new EastError(`MySQL connection failed: ${err.message}`, {
+                location: { filename: "mysql_connect", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    mysql_query.implement(async (handle, sql, params) => {
+        try {
+            const pool = getConnection(handle);
+            // Convert East parameters to native values
+            const nativeParams = params.map(convertParamToNative);
+            // Execute the query
+            const [rows, fields] = await pool.query(sql, nativeParams);
+            // For SELECT queries, fields will contain column metadata and rows will be an array
+            // For DML queries (INSERT/UPDATE/DELETE), result will be ResultSetHeader
+            // Check using the fields array: SELECT has fields, DML doesn't
+            if (Array.isArray(rows) && fields.length > 0) {
+                // Get column metadata for type information
+                const fieldTypeMap = new SortedMap();
+                for (const field of fields) {
+                    fieldTypeMap.set(field.name, field.type);
+                }
+                // SELECT query - rows is array of RowDataPacket
+                const eastRows = rows.map((row) => {
+                    const eastRow = new SortedMap();
+                    for (const [key, value] of Object.entries(row)) {
+                        const fieldType = fieldTypeMap.get(key) || null;
+                        eastRow.set(key, convertNativeToParam(value, fieldType));
+                    }
+                    return eastRow;
+                });
+                return variant('select', { rows: eastRows });
+            }
+            else if (!Array.isArray(rows) && typeof rows === 'object' && rows !== null) {
+                // DML query - ResultSetHeader
+                const result = rows;
+                // Validate ResultSetHeader structure
+                if (typeof result.affectedRows !== 'number') {
+                    throw new EastError('MySQL ResultSetHeader missing affectedRows', {
+                        location: { filename: "mysql_query", line: 0n, column: 0n }
+                    });
+                }
+                // Determine query type from SQL
+                const trimmedSql = sql.trim().toUpperCase();
+                if (trimmedSql.startsWith('INSERT')) {
+                    return variant('insert', {
+                        rowsAffected: BigInt(result.affectedRows),
+                        lastInsertId: result.insertId && result.insertId > 0
+                            ? variant('some', BigInt(result.insertId))
+                            : variant('none', null)
+                    });
+                }
+                else if (trimmedSql.startsWith('UPDATE')) {
+                    return variant('update', {
+                        rowsAffected: BigInt(result.affectedRows)
+                    });
+                }
+                else if (trimmedSql.startsWith('DELETE')) {
+                    return variant('delete', {
+                        rowsAffected: BigInt(result.affectedRows)
+                    });
+                }
+                else {
+                    // Other mutating queries (CREATE, DROP, ALTER, etc.) - treat as update
+                    return variant('update', {
+                        rowsAffected: BigInt(result.affectedRows)
+                    });
+                }
+            }
+            else {
+                // Unexpected result type
+                throw new EastError(`Unexpected result type from MySQL query: ${typeof rows}`, {
+                    location: { filename: "mysql_query", line: 0n, column: 0n }
+                });
+            }
+        }
+        catch (err) {
+            throw new EastError(`MySQL query failed: ${err.message}`, {
+                location: { filename: "mysql_query", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    mysql_close.implement(async (handle) => {
+        try {
+            const pool = getConnection(handle);
+            await pool.end();
+            closeHandle(handle);
+            return null;
+        }
+        catch (err) {
+            throw new EastError(`MySQL close failed: ${err.message}`, {
+                location: { filename: "mysql_close", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    mysql_close_all.implement(async () => {
+        await closeAllHandles();
+        return null;
+    }),
+];
+//# sourceMappingURL=mysql.js.map

package/dist/sql/mysql.js.map

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