@elaraai/east-node-io 0.0.1-beta.8 → 1.0.0

package/dist/{sql → src/sql}/mysql.js

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { BlobType, BooleanType, DateTimeType, East, FloatType, IntegerType, isValueOf, match, NullType, SortedMap, StringType as EastStringType, variant } from "@elaraai/east";
+import { ArrayType, BlobType, BooleanType, DateTimeType, East, FloatType, IntegerType, isTypeValueEqual, isValueOf, match, NullType, OptionType, SortedMap, StringType as EastStringType, toEastTypeValue, variant } from "@elaraai/east";
 import { EastError } from "@elaraai/east/internal";
 import mysql from 'mysql2/promise';
 import { createHandle, getConnection, closeHandle, closeAllHandles } from '../connection/index.js';
@@ -130,6 +130,76 @@ export const mysql_connect = East.asyncPlatform("mysql_connect", [MySqlConfigTyp
  * - Returns lastInsertId for INSERT operations
  */
 export const mysql_query = East.asyncPlatform("mysql_query", [ConnectionHandleType, StringType, SqlParametersType], SqlResultType);
+/**
+ * Executes a SELECT query with user-defined return type.
+ *
+ * Runs a SELECT query against a MySQL database with parameter binding and
+ * returns results as an array of typed rows. The return type is generic,
+ * allowing users to specify the expected row structure for type-safe access.
+ *
+ * This is a generic platform function for the East language, enabling type-safe
+ * SELECT queries in East programs running on Node.js.
+ *
+ * @typeParam T - The expected row type for query results
+ * @param handle - Connection handle from mysql_connect()
+ * @param sql - SQL SELECT query string with ? placeholders
+ * @param params - Query parameters as SqlParameterType array
+ * @returns Array of rows matching the specified type T
+ *
+ * @throws {EastError} When query fails due to:
+ * - Invalid connection handle (location: "mysql_select")
+ * - SQL syntax errors (location: "mysql_select")
+ * - Query is not a SELECT (location: "mysql_select")
+ * - Type coercion failure (location: "mysql_select")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, StructType, StringType, IntegerType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * // Define the expected row type
+ * const UserRowType = StructType({
+ *     id: IntegerType,
+ *     name: StringType,
+ *     email: StringType,
+ * });
+ *
+ * const queryUsers = 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));
+ *
+ *     // Query with typed results - returns Array<UserRowType>
+ *     const users = $.let(SQL.MySQL.select([UserRowType], conn,
+ *         "SELECT id, name, email FROM users WHERE active = ?",
+ *         [variant('Boolean', true)]
+ *     ));
+ *     // users is typed as Array<{ id: bigint, name: string, email: string }>
+ *
+ *     $(SQL.MySQL.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(queryUsers.toIR(), SQL.MySQL.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @remarks
+ * - Only SELECT queries are supported (use mysql_query for INSERT/UPDATE/DELETE)
+ * - Uses ? for parameter placeholders
+ * - Row type T should match the structure of selected columns
+ * - All MySQL data types are mapped to appropriate East types
+ * - NULL values are preserved in the result
+ */
+export const mysql_select = East.asyncGenericPlatform("mysql_select", ["T"], [ConnectionHandleType, StringType, SqlParametersType], ArrayType("T"));
 /**
  * Closes a MySQL connection pool.
  *
@@ -292,7 +362,7 @@ export const MySqlImpl = [
         }
         catch (err) {
             throw new EastError(`MySQL connection failed: ${err.message}`, {
-                location: { filename: "mysql_connect", line: 0n, column: 0n },
+                location: [{ filename: "mysql_connect", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -330,7 +400,7 @@ export const MySqlImpl = [
                 // Validate ResultSetHeader structure
                 if (typeof result.affectedRows !== 'number') {
                     throw new EastError('MySQL ResultSetHeader missing affectedRows', {
-                        location: { filename: "mysql_query", line: 0n, column: 0n }
+                        location: [{ filename: "mysql_query", line: 0n, column: 0n }]
                     });
                 }
                 // Determine query type from SQL
@@ -363,13 +433,144 @@ export const MySqlImpl = [
             else {
                 // Unexpected result type
                 throw new EastError(`Unexpected result type from MySQL query: ${typeof rows}`, {
-                    location: { filename: "mysql_query", line: 0n, column: 0n }
+                    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 },
+                location: [{ filename: "mysql_query", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    mysql_select.implement((T) => async (...args) => {
+        const handle = args[0];
+        const sql = args[1];
+        const params = args[2];
+        const rowType = T;
+        try {
+            const pool = getConnection(handle);
+            // Validate row type is a Struct
+            if (rowType.type !== 'Struct') {
+                throw new EastError(`Expected row type must be a Struct, got ${rowType.type}`, { location: [{ filename: "mysql_select", line: 0n, column: 0n }] });
+            }
+            // Convert East parameters to native values
+            const nativeParams = params.map(convertParamToNative);
+            // Execute the query
+            const [rawRows, fields] = await pool.query(sql, nativeParams);
+            // Verify this is a SELECT query (SELECT has fields array with entries)
+            if (!Array.isArray(rawRows) || fields.length === 0) {
+                throw new EastError('mysql_select only supports SELECT queries. Use mysql_query for INSERT/UPDATE/DELETE.', {
+                    location: [{ filename: "mysql_select", line: 0n, column: 0n }]
+                });
+            }
+            // Get column metadata
+            const columnMetaMap = new Map();
+            for (const field of fields) {
+                columnMetaMap.set(field.name, { fieldType: field.type });
+            }
+            // Validate field types and determine which are OptionTypes
+            // Note: T is EastTypeValue (IR format), not EastType (runtime format)
+            const structTypeValue = rowType;
+            const fieldInfo = new Map();
+            for (const field of structTypeValue.value) {
+                const fieldName = field.name;
+                const fieldType = field.type;
+                const colMeta = columnMetaMap.get(fieldName);
+                if (!colMeta) {
+                    throw new EastError(`Column '${fieldName}' not found in query result`, { location: [{ filename: "mysql_select", line: 0n, column: 0n }] });
+                }
+                // Determine expected base type from MySQL field type
+                let expectedBaseType;
+                const ft = colMeta.fieldType;
+                if (ft === 1 || ft === 16) { // TINY (as boolean), BIT
+                    expectedBaseType = BooleanType;
+                }
+                else if (ft === 2 || ft === 3 || ft === 8 || ft === 9 || ft === 13) { // SHORT, LONG, LONGLONG, INT24, YEAR
+                    expectedBaseType = IntegerType;
+                }
+                else if (ft === 0 || ft === 4 || ft === 5 || ft === 246) { // DECIMAL, FLOAT, DOUBLE, NEWDECIMAL
+                    expectedBaseType = FloatType;
+                }
+                else if (ft === 253 || ft === 254) { // VARCHAR, STRING (CHAR)
+                    expectedBaseType = EastStringType;
+                }
+                else if (ft === 7 || ft === 10 || ft === 11 || ft === 12) { // TIMESTAMP, DATE, TIME, DATETIME
+                    expectedBaseType = DateTimeType;
+                }
+                else if (ft === 252) { // BLOB or TEXT (both use 252!)
+                    // Field type 252 is ambiguous - used for both TEXT and BLOB
+                    // Check if user expects String (TEXT) or Blob
+                    const isString = isTypeValueEqual(fieldType, toEastTypeValue(EastStringType));
+                    const isStringOption = isTypeValueEqual(fieldType, toEastTypeValue(OptionType(EastStringType)));
+                    const isBlob = isTypeValueEqual(fieldType, toEastTypeValue(BlobType));
+                    const isBlobOption = isTypeValueEqual(fieldType, toEastTypeValue(OptionType(BlobType)));
+                    if (isString || isStringOption) {
+                        expectedBaseType = EastStringType;
+                    }
+                    else if (isBlob || isBlobOption) {
+                        expectedBaseType = BlobType;
+                    }
+                    else {
+                        throw new EastError(`Type mismatch for column '${fieldName}': MySQL field type 252 (TEXT/BLOB), got ${fieldType.type} but expected String, Blob, OptionType(String), or OptionType(Blob)`, { location: [{ filename: "mysql_select", line: 0n, column: 0n }] });
+                    }
+                    fieldInfo.set(fieldName, { isOption: isStringOption || isBlobOption, expectedBaseType });
+                    continue;
+                }
+                else {
+                    // Unknown field type - skip type validation, rely on isValueOf later
+                    fieldInfo.set(fieldName, { isOption: false, expectedBaseType: IntegerType });
+                    continue;
+                }
+                // Check if field type matches base type or OptionType(base type)
+                const isBase = isTypeValueEqual(fieldType, toEastTypeValue(expectedBaseType));
+                const isOption = isTypeValueEqual(fieldType, toEastTypeValue(OptionType(expectedBaseType)));
+                if (!isBase && !isOption) {
+                    throw new EastError(`Type mismatch for column '${fieldName}': MySQL field type ${ft}, got ${fieldType.type} but expected ${expectedBaseType.type} or OptionType(${expectedBaseType.type})`, { location: [{ filename: "mysql_select", line: 0n, column: 0n }] });
+                }
+                fieldInfo.set(fieldName, { isOption, expectedBaseType });
+            }
+            // Convert values based on column metadata and handle nulls
+            const rows = rawRows.map((row, rowIndex) => {
+                const converted = {};
+                for (const [key, value] of Object.entries(row)) {
+                    const info = fieldInfo.get(key);
+                    const colMeta = columnMetaMap.get(key);
+                    const ft = colMeta?.fieldType;
+                    if (value === null) {
+                        if (info?.isOption) {
+                            converted[key] = variant('none', null);
+                        }
+                        else {
+                            throw new EastError(`null value at row[${rowIndex}] for required field '${key}' - use OptionType(${info?.expectedBaseType.type ?? 'T'}) for nullable columns`, { location: [{ filename: "mysql_select", line: 0n, column: 0n }] });
+                        }
+                    }
+                    else {
+                        // Convert based on field type
+                        let convertedValue;
+                        if (ft === 2 || ft === 3 || ft === 8 || ft === 9 || ft === 13) { // SHORT, LONG, LONGLONG, INT24, YEAR
+                            convertedValue = BigInt(value);
+                        }
+                        else if (ft === 252 && Buffer.isBuffer(value)) { // BLOB
+                            convertedValue = new Uint8Array(value);
+                        }
+                        else {
+                            convertedValue = value;
+                        }
+                        converted[key] = info?.isOption ? variant('some', convertedValue) : convertedValue;
+                    }
+                }
+                return converted;
+            });
+            // Type validation is already done field-by-field above during column metadata validation
+            return rows;
+        }
+        catch (err) {
+            if (err instanceof EastError)
+                throw err;
+            throw new EastError(`MySQL select failed: ${err.message}`, {
+                location: [{ filename: "mysql_select", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -383,7 +584,7 @@ export const MySqlImpl = [
         }
         catch (err) {
             throw new EastError(`MySQL close failed: ${err.message}`, {
-                location: { filename: "mysql_close", line: 0n, column: 0n },
+                location: [{ filename: "mysql_close", line: 0n, column: 0n }],
                 cause: err
             });
         }

package/dist/src/sql/mysql.js.map

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

package/dist/{sql → src/sql}/postgres.d.ts

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { BlobType, BooleanType, DateTimeType, FloatType, IntegerType, NullType, StringType as EastStringType } from "@elaraai/east";
+import { ArrayType, BlobType, BooleanType, DateTimeType, FloatType, IntegerType, NullType, OptionType, StringType as EastStringType } from "@elaraai/east";
 import type { PlatformFunction } from "@elaraai/east/internal";
 import { StringType } from './types.js';
 /**
@@ -69,13 +69,13 @@ import { StringType } from './types.js';
  * - Connections are automatically returned to the pool after queries
  */
 export declare const postgres_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>;
+    readonly host: EastStringType;
+    readonly port: IntegerType;
+    readonly database: EastStringType;
+    readonly user: EastStringType;
+    readonly password: EastStringType;
+    readonly ssl: OptionType<BooleanType>;
+    readonly maxConnections: OptionType<IntegerType>;
 }>], EastStringType>;
 /**
  * Executes a SQL query with parameterized values.
@@ -134,37 +134,115 @@ export declare const postgres_connect: import("@elaraai/east").AsyncPlatformDefi
  * - All queries are asynchronous
  * - Parameters prevent SQL injection attacks
  */
-export declare const postgres_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;
+export declare const postgres_query: import("@elaraai/east").AsyncPlatformDefinition<[EastStringType, EastStringType, ArrayType<import("@elaraai/east").VariantType<{
+    readonly Null: NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: FloatType;
+    readonly String: StringType;
+    readonly DateTime: DateTimeType;
+    readonly 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;
+    readonly select: import("@elaraai/east").StructType<{
+        readonly rows: ArrayType<import("@elaraai/east").DictType<EastStringType, import("@elaraai/east").VariantType<{
+            readonly Null: NullType;
+            readonly Boolean: BooleanType;
+            readonly Integer: IntegerType;
+            readonly Float: FloatType;
+            readonly String: StringType;
+            readonly DateTime: DateTimeType;
+            readonly Blob: BlobType;
         }>>>;
     }>;
-    insert: import("@elaraai/east").StructType<{
-        rowsAffected: IntegerType;
-        lastInsertId: import("@elaraai/east").OptionType<IntegerType>;
+    readonly insert: import("@elaraai/east").StructType<{
+        readonly rowsAffected: IntegerType;
+        readonly lastInsertId: OptionType<IntegerType>;
     }>;
-    update: import("@elaraai/east").StructType<{
-        rowsAffected: IntegerType;
+    readonly update: import("@elaraai/east").StructType<{
+        readonly rowsAffected: IntegerType;
     }>;
-    delete: import("@elaraai/east").StructType<{
-        rowsAffected: IntegerType;
+    readonly delete: import("@elaraai/east").StructType<{
+        readonly rowsAffected: IntegerType;
     }>;
 }>>;
+/**
+ * Executes a SELECT query with user-defined return type.
+ *
+ * Runs a SELECT query against a PostgreSQL database with parameter binding and
+ * returns results as an array of typed rows. The return type is generic,
+ * allowing users to specify the expected row structure for type-safe access.
+ *
+ * This is a generic platform function for the East language, enabling type-safe
+ * SELECT queries in East programs running on Node.js.
+ *
+ * @typeParam T - The expected row type for query results
+ * @param handle - Connection handle from postgres_connect()
+ * @param sql - SQL SELECT query string with $1, $2, etc. placeholders
+ * @param params - Query parameters as SqlParameterType array
+ * @returns Array of rows matching the specified type T
+ *
+ * @throws {EastError} When query fails due to:
+ * - Invalid connection handle (location: "postgres_select")
+ * - SQL syntax errors (location: "postgres_select")
+ * - Query is not a SELECT (location: "postgres_select")
+ * - Type coercion failure (location: "postgres_select")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, StructType, StringType, IntegerType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * // Define the expected row type
+ * const UserRowType = StructType({
+ *     id: IntegerType,
+ *     name: StringType,
+ *     email: StringType,
+ * });
+ *
+ * const queryUsers = East.function([], NullType, ($) => {
+ *     const config = $.let({
+ *         host: "localhost",
+ *         port: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *
+ *     // Query with typed results - returns Array<UserRowType>
+ *     const users = $.let(SQL.Postgres.select([UserRowType], conn,
+ *         "SELECT id, name, email FROM users WHERE active = $1",
+ *         [variant('Boolean', true)]
+ *     ));
+ *     // users is typed as Array<{ id: bigint, name: string, email: string }>
+ *
+ *     $(SQL.Postgres.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(queryUsers.toIR(), SQL.Postgres.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @remarks
+ * - Only SELECT queries are supported (use postgres_query for INSERT/UPDATE/DELETE)
+ * - Uses $1, $2, $3, etc. for parameter placeholders
+ * - Row type T should match the structure of selected columns
+ * - All PostgreSQL data types are mapped to appropriate East types
+ * - NULL values are preserved in the result
+ */
+export declare const postgres_select: import("@elaraai/east").AsyncGenericPlatformDefinition<readonly ["T"], readonly [EastStringType, EastStringType, ArrayType<import("@elaraai/east").VariantType<{
+    readonly Null: NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: FloatType;
+    readonly String: StringType;
+    readonly DateTime: DateTimeType;
+    readonly Blob: BlobType;
+}>>], ArrayType<"T">>;
 /**
  * Closes a PostgreSQL connection pool.
  *

package/dist/src/sql/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/sql/postgres.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAQ,SAAS,EAAE,WAAW,EAAsC,QAAQ,EAAE,UAAU,EAAa,UAAU,IAAI,cAAc,EAA4B,MAAM,eAAe,CAAC;AAE1O,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI9E,OAAO,EAKH,UAAU,EAEb,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;oBAAqF,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA6G,CAAC;AAEzI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,eAAO,MAAM,eAAe;;;;;;;;qBAK3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,cAAc,6EAAyE,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,+DAAyD,CAAC;AAkFzF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,gBAAgB,EAiR1C,CAAC"}