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

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

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { match, BlobType, BooleanType, DateTimeType, East, FloatType, IntegerType, isValueOf, NullType, SortedMap, variant } from "@elaraai/east";
+import { match, ArrayType, BlobType, BooleanType, DateTimeType, East, FloatType, IntegerType, isTypeValueEqual, isValueOf, NullType, OptionType, SortedMap, StringType as EastStringType, toEastTypeValue, variant } from "@elaraai/east";
 import { EastError } from "@elaraai/east/internal";
 import Database from 'better-sqlite3';
 import { createHandle, getConnection, closeHandle, closeAllHandles } from '../connection/index.js';
@@ -117,6 +117,76 @@ export const sqlite_connect = East.asyncPlatform("sqlite_connect", [SqliteConfig
  * - All queries are synchronous but wrapped in async for consistency
  */
 export const sqlite_query = East.asyncPlatform("sqlite_query", [ConnectionHandleType, StringType, SqlParametersType], SqlResultType);
+/**
+ * Executes a SELECT query with user-defined return type.
+ *
+ * Runs a SELECT query against a SQLite 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 sqlite_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: "sqlite_select")
+ * - SQL syntax errors (location: "sqlite_select")
+ * - Query is not a SELECT (location: "sqlite_select")
+ * - Type coercion failure (location: "sqlite_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({
+ *         path: ":memory:",
+ *         readOnly: variant('none', null),
+ *         memory: variant('some', true),
+ *     });
+ *
+ *     const conn = $.let(SQL.SQLite.connect(config));
+ *
+ *     // Create table and insert data
+ *     $(SQL.SQLite.query(conn, "CREATE TABLE users (id INTEGER, name TEXT, email TEXT)", []));
+ *     $(SQL.SQLite.query(conn, "INSERT INTO users VALUES (1, 'Alice', 'alice@example.com')", []));
+ *
+ *     // Query with typed results - returns Array<UserRowType>
+ *     const users = $.let(SQL.SQLite.select([UserRowType], conn,
+ *         "SELECT id, name, email FROM users",
+ *         []
+ *     ));
+ *     // users is typed as Array<{ id: bigint, name: string, email: string }>
+ *
+ *     $(SQL.SQLite.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(queryUsers.toIR(), SQL.SQLite.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @remarks
+ * - Only SELECT queries are supported (use sqlite_query for INSERT/UPDATE/DELETE)
+ * - Uses `?` placeholders for parameters (not $1, $2 like PostgreSQL)
+ * - Row type T should match the structure of selected columns
+ * - All SQLite data types are mapped to appropriate East types
+ * - NULL values are preserved in the result
+ */
+export const sqlite_select = East.asyncGenericPlatform("sqlite_select", ["T"], [ConnectionHandleType, StringType, SqlParametersType], ArrayType("T"));
 /**
  * Closes a SQLite database connection.
  *
@@ -261,7 +331,7 @@ export const SqliteImpl = [
         }
         catch (err) {
             throw new EastError(`SQLite connection failed: ${err.message}`, {
-                location: { filename: "sqlite_connect", line: 0n, column: 0n },
+                location: [{ filename: "sqlite_connect", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -280,7 +350,7 @@ export const SqliteImpl = [
                 const rows = stmt.all(...nativeParams);
                 if (!Array.isArray(rows)) {
                     throw new EastError('SQLite all() did not return an array', {
-                        location: { filename: "sqlite_query", line: 0n, column: 0n }
+                        location: [{ filename: "sqlite_query", line: 0n, column: 0n }]
                     });
                 }
                 // Get column metadata for type information
@@ -306,7 +376,7 @@ export const SqliteImpl = [
                 // Validate RunResult structure
                 if (typeof info !== 'object' || info === null || !('changes' in info)) {
                     throw new EastError('SQLite run() did not return valid RunResult', {
-                        location: { filename: "sqlite_query", line: 0n, column: 0n }
+                        location: [{ filename: "sqlite_query", line: 0n, column: 0n }]
                     });
                 }
                 // Determine query type from SQL to return the appropriate variant
@@ -339,7 +409,140 @@ export const SqliteImpl = [
         }
         catch (err) {
             throw new EastError(`SQLite query failed: ${err.message}`, {
-                location: { filename: "sqlite_query", line: 0n, column: 0n },
+                location: [{ filename: "sqlite_query", line: 0n, column: 0n }],
+                cause: err
+            });
+        }
+    }),
+    sqlite_select.implement((T) => async (...args) => {
+        const handle = args[0];
+        const sql = args[1];
+        const params = args[2];
+        const rowType = T;
+        try {
+            const db = await Promise.resolve(getConnection(handle));
+            // Convert East parameters to native values
+            const nativeParams = params.map(convertParamToNative);
+            // Prepare the statement
+            const stmt = db.prepare(sql);
+            // Verify this is a SELECT query
+            if (!stmt.reader) {
+                throw new EastError('sqlite_select only supports SELECT queries. Use sqlite_query for INSERT/UPDATE/DELETE.', {
+                    location: [{ filename: "sqlite_select", line: 0n, column: 0n }]
+                });
+            }
+            // 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: "sqlite_select", line: 0n, column: 0n }] });
+            }
+            // Get column metadata
+            const columns = stmt.columns();
+            const columnMetaMap = new Map();
+            for (const col of columns) {
+                columnMetaMap.set(col.name, { type: col.type?.toUpperCase() || null });
+            }
+            // 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: "sqlite_select", line: 0n, column: 0n }] });
+                }
+                // Determine expected base type from SQLite column type
+                let expectedBaseType;
+                const colType = colMeta.type;
+                if (colType === 'INTEGER' || colType === 'INT' || colType === 'TINYINT' || colType === 'SMALLINT' ||
+                    colType === 'MEDIUMINT' || colType === 'BIGINT' || colType === 'UNSIGNED BIG INT' ||
+                    colType === 'INT2' || colType === 'INT8') {
+                    expectedBaseType = IntegerType;
+                }
+                else if (colType === 'REAL' || colType === 'DOUBLE' || colType === 'DOUBLE PRECISION' ||
+                    colType === 'FLOAT' || colType === 'NUMERIC' || colType === 'DECIMAL') {
+                    expectedBaseType = FloatType;
+                }
+                else if (colType === 'TEXT' || colType === 'CHARACTER' || colType === 'VARCHAR' ||
+                    colType === 'VARYING CHARACTER' || colType === 'NCHAR' || colType === 'NATIVE CHARACTER' ||
+                    colType === 'NVARCHAR' || colType === 'CLOB' || colType === 'DATE') {
+                    expectedBaseType = EastStringType;
+                }
+                else if (colType === 'DATETIME') {
+                    expectedBaseType = DateTimeType;
+                }
+                else if (colType === 'BLOB') {
+                    expectedBaseType = BlobType;
+                }
+                else if (colType === 'BOOLEAN') {
+                    expectedBaseType = BooleanType;
+                }
+                else {
+                    // Unknown column 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}': SQLite column is ${colType}, got ${fieldType.type} but expected ${expectedBaseType.type} or OptionType(${expectedBaseType.type})`, { location: [{ filename: "sqlite_select", line: 0n, column: 0n }] });
+                }
+                fieldInfo.set(fieldName, { isOption, expectedBaseType });
+            }
+            // Execute the query
+            const rawRows = stmt.all(...nativeParams);
+            if (!Array.isArray(rawRows)) {
+                throw new EastError('SQLite all() did not return an array', {
+                    location: [{ filename: "sqlite_select", line: 0n, column: 0n }]
+                });
+            }
+            // 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 colType = colMeta?.type;
+                    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: "sqlite_select", line: 0n, column: 0n }] });
+                        }
+                    }
+                    else {
+                        // Convert based on column type
+                        let convertedValue;
+                        if (colType === 'INTEGER' || colType === 'INT' || colType === 'TINYINT' ||
+                            colType === 'SMALLINT' || colType === 'MEDIUMINT' || colType === 'BIGINT' ||
+                            colType === 'UNSIGNED BIG INT' || colType === 'INT2' || colType === 'INT8') {
+                            convertedValue = BigInt(value);
+                        }
+                        else if (colType === 'DATETIME') {
+                            convertedValue = new Date(value);
+                        }
+                        else if (colType === 'BLOB' && Buffer.isBuffer(value)) {
+                            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(`SQLite select failed: ${err.message}`, {
+                location: [{ filename: "sqlite_select", line: 0n, column: 0n }],
                 cause: err
             });
         }
@@ -353,7 +556,7 @@ export const SqliteImpl = [
         }
         catch (err) {
             throw new EastError(`SQLite close failed: ${err.message}`, {
-                location: { filename: "sqlite_close", line: 0n, column: 0n },
+                location: [{ filename: "sqlite_close", line: 0n, column: 0n }],
                 cause: err
             });
         }

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

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

package/dist/src/sql/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Shared SQL type definitions for East Node IO.
+ *
+ * Provides East type definitions for SQL database operations including
+ * connection configurations, query parameters, and result types.
+ *
+ * @packageDocumentation
+ */
+import { StructType, VariantType, OptionType, ArrayType, DictType, StringType, IntegerType, BooleanType, BlobType } from "@elaraai/east";
+export { StringType } from "@elaraai/east";
+/**
+ * SQLite database connection configuration.
+ *
+ * Configures a connection to a SQLite database file or in-memory database.
+ */
+export declare const SqliteConfigType: StructType<{
+    /**
+     * Path to the SQLite database file.
+     * Use ":memory:" for in-memory database.
+     */
+    readonly path: StringType;
+    /**
+     * Open database in read-only mode.
+     * Optional, defaults to false (read-write).
+     */
+    readonly readOnly: OptionType<BooleanType>;
+    /**
+     * Use in-memory database.
+     * Optional, defaults to false.
+     */
+    readonly memory: OptionType<BooleanType>;
+}>;
+/**
+ * PostgreSQL database connection configuration.
+ *
+ * Configures a connection pool to a PostgreSQL database server.
+ */
+export declare const PostgresConfigType: StructType<{
+    /** PostgreSQL server hostname or IP address */
+    readonly host: StringType;
+    /** PostgreSQL server port (typically 5432) */
+    readonly port: IntegerType;
+    /** Database name to connect to */
+    readonly database: StringType;
+    /** Username for authentication */
+    readonly user: StringType;
+    /** Password for authentication */
+    readonly password: StringType;
+    /**
+     * Enable SSL/TLS connection.
+     * Optional, defaults to false.
+     */
+    readonly ssl: OptionType<BooleanType>;
+    /**
+     * Maximum number of connections in the pool.
+     * Optional, defaults to 10.
+     */
+    readonly maxConnections: OptionType<IntegerType>;
+}>;
+/**
+ * MySQL database connection configuration.
+ *
+ * Configures a connection pool to a MySQL database server.
+ */
+export declare const MySqlConfigType: StructType<{
+    /** MySQL server hostname or IP address */
+    readonly host: StringType;
+    /** MySQL server port (typically 3306) */
+    readonly port: IntegerType;
+    /** Database name to connect to */
+    readonly database: StringType;
+    /** Username for authentication */
+    readonly user: StringType;
+    /** Password for authentication */
+    readonly password: StringType;
+    /**
+     * Enable SSL/TLS connection.
+     * Optional, defaults to false.
+     */
+    readonly ssl: OptionType<BooleanType>;
+    /**
+     * Maximum number of connections in the pool.
+     * Optional, defaults to 10.
+     */
+    readonly maxConnections: OptionType<IntegerType>;
+}>;
+/**
+ * SQL query parameter value type.
+ *
+ * Represents a typed value that can be used as a parameter in SQL queries.
+ * Supports all common SQL types with proper type safety.
+ *
+ * @remarks
+ * Use East.variant() to create parameter values:
+ * - `East.variant("string", "text")`
+ * - `East.variant("int", 42n)`
+ * - `East.variant("float", 3.14)`
+ * - `East.variant("bool", true)`
+ * - `East.variant("null", {})`
+ * - `East.variant("blob", new Uint8Array([1, 2, 3]))`
+ */
+export declare const SqlParameterType: VariantType<{
+    readonly Null: import("@elaraai/east").NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: import("@elaraai/east").FloatType;
+    readonly String: StringType;
+    readonly DateTime: import("@elaraai/east").DateTimeType;
+    readonly Blob: BlobType;
+}>;
+/**
+ * Array of SQL query parameters.
+ *
+ * Used to pass parameters to parameterized SQL queries.
+ */
+export declare const SqlParametersType: ArrayType<VariantType<{
+    readonly Null: import("@elaraai/east").NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: import("@elaraai/east").FloatType;
+    readonly String: StringType;
+    readonly DateTime: import("@elaraai/east").DateTimeType;
+    readonly Blob: BlobType;
+}>>;
+/**
+ * SQL query result row.
+ *
+ * Represents a single row from a query result as a dictionary mapping
+ * column names to typed values.
+ */
+export declare const SqlRowType: DictType<StringType, VariantType<{
+    readonly Null: import("@elaraai/east").NullType;
+    readonly Boolean: BooleanType;
+    readonly Integer: IntegerType;
+    readonly Float: import("@elaraai/east").FloatType;
+    readonly String: StringType;
+    readonly DateTime: import("@elaraai/east").DateTimeType;
+    readonly Blob: BlobType;
+}>>;
+/**
+ * SQL query execution result.
+ *
+ * A variant type representing different query result types:
+ * - `select`: Results from SELECT queries with rows
+ * - `insert`: Results from INSERT with affected rows and optional last insert ID
+ * - `update`: Results from UPDATE with affected rows
+ * - `delete`: Results from DELETE with affected rows
+ *
+ * @remarks
+ * Using variants allows type-safe handling of different query types.
+ */
+export declare const SqlResultType: VariantType<{
+    /**
+     * SELECT query result with rows.
+     */
+    readonly select: StructType<{
+        /** Array of rows returned by the query */
+        readonly rows: ArrayType<DictType<StringType, VariantType<{
+            readonly Null: import("@elaraai/east").NullType;
+            readonly Boolean: BooleanType;
+            readonly Integer: IntegerType;
+            readonly Float: import("@elaraai/east").FloatType;
+            readonly String: StringType;
+            readonly DateTime: import("@elaraai/east").DateTimeType;
+            readonly Blob: BlobType;
+        }>>>;
+    }>;
+    /**
+     * INSERT query result with metadata.
+     */
+    readonly insert: StructType<{
+        /** Number of rows inserted */
+        readonly rowsAffected: IntegerType;
+        /** Last inserted row ID (database-specific, may be None) */
+        readonly lastInsertId: OptionType<IntegerType>;
+    }>;
+    /**
+     * UPDATE query result with metadata.
+     */
+    readonly update: StructType<{
+        /** Number of rows updated */
+        readonly rowsAffected: IntegerType;
+    }>;
+    /**
+     * DELETE query result with metadata.
+     */
+    readonly delete: StructType<{
+        /** Number of rows deleted */
+        readonly rowsAffected: IntegerType;
+    }>;
+}>;
+/**
+ * Opaque connection handle type.
+ *
+ * Represents an active database connection.
+ * Handles are created by connect() functions and used in query operations.
+ *
+ * @internal
+ */
+export declare const ConnectionHandleType: StringType;
+/**
+ * Microsoft Access database connection configuration.
+ *
+ * Configures a connection to a Microsoft Access database file (.mdb or .accdb).
+ */
+export declare const AccessConfigType: StructType<{
+    /**
+     * Path to the Access database file (.mdb or .accdb).
+     */
+    readonly path: StringType;
+    /**
+     * Password for encrypted databases.
+     * Optional, only required for password-protected databases.
+     */
+    readonly password: OptionType<StringType>;
+}>;
+/**
+ * Microsoft Access database blob configuration.
+ *
+ * Configures opening a Microsoft Access database from binary data (Blob).
+ * Useful for opening databases fetched from URLs without writing to disk.
+ */
+export declare const AccessBlobConfigType: StructType<{
+    /**
+     * Binary data containing the Access database (.mdb or .accdb).
+     */
+    readonly data: BlobType;
+    /**
+     * Password for encrypted databases.
+     * Optional, only required for password-protected databases.
+     */
+    readonly password: OptionType<StringType>;
+}>;
+/**
+ * Access query options for filtering and pagination.
+ */
+export declare const AccessQueryOptionsType: StructType<{
+    /**
+     * Table name to query (case-sensitive).
+     */
+    readonly table: StringType;
+    /**
+     * Specific columns to retrieve.
+     * Optional, defaults to all columns.
+     */
+    readonly columns: OptionType<ArrayType<StringType>>;
+    /**
+     * Number of rows to skip.
+     * Optional, defaults to 0.
+     */
+    readonly rowOffset: OptionType<IntegerType>;
+    /**
+     * Maximum number of rows to return.
+     * Optional, defaults to all rows.
+     */
+    readonly rowLimit: OptionType<IntegerType>;
+}>;
+/**
+ * Access table list result.
+ */
+export declare const AccessTablesResultType: StructType<{
+    /** Array of table names in the database */
+    readonly tables: ArrayType<StringType>;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sql/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EACH,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACX,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IACzB;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;IAC3B,+CAA+C;;IAG/C,8CAA8C;;IAG9C,kCAAkC;;IAGlC,kCAAkC;;IAGlC,kCAAkC;;IAGlC;;;OAGG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;IACxB,0CAA0C;;IAG1C,yCAAyC;;IAGzC,kCAAkC;;IAGlC,kCAAkC;;IAGlC,kCAAkC;;IAGlC;;;OAGG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;EAAmB,CAAC;AAEjD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;GAA8B,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;GAAyC,CAAC;AAEjE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa;IACtB;;OAEG;;QAEC,0CAA0C;;;;;;;;;;;IAI9C;;OAEG;;QAEC,8BAA8B;;QAE9B,4DAA4D;;;IAIhE;;OAEG;;QAEC,6BAA6B;;;IAIjC;;OAEG;;QAEC,6BAA6B;;;EAGnC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,YAAa,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC7B;;OAEG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IAC/B;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;EAEL,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;IAC/B,2CAA2C;;EAE7C,CAAC"}

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

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { StructType, VariantType, OptionType, ArrayType, DictType, StringType, IntegerType, BooleanType, } from "@elaraai/east";
+import { StructType, VariantType, OptionType, ArrayType, DictType, StringType, IntegerType, BooleanType, BlobType, } from "@elaraai/east";
 import { LiteralValueType } from "@elaraai/east/internal";
 // Re-export StringType for use in other SQL modules
 export { StringType } from "@elaraai/east";
@@ -172,4 +172,68 @@ export const SqlResultType = VariantType({
  * @internal
  */
 export const ConnectionHandleType = StringType;
+/**
+ * Microsoft Access database connection configuration.
+ *
+ * Configures a connection to a Microsoft Access database file (.mdb or .accdb).
+ */
+export const AccessConfigType = StructType({
+    /**
+     * Path to the Access database file (.mdb or .accdb).
+     */
+    path: StringType,
+    /**
+     * Password for encrypted databases.
+     * Optional, only required for password-protected databases.
+     */
+    password: OptionType(StringType),
+});
+/**
+ * Microsoft Access database blob configuration.
+ *
+ * Configures opening a Microsoft Access database from binary data (Blob).
+ * Useful for opening databases fetched from URLs without writing to disk.
+ */
+export const AccessBlobConfigType = StructType({
+    /**
+     * Binary data containing the Access database (.mdb or .accdb).
+     */
+    data: BlobType,
+    /**
+     * Password for encrypted databases.
+     * Optional, only required for password-protected databases.
+     */
+    password: OptionType(StringType),
+});
+/**
+ * Access query options for filtering and pagination.
+ */
+export const AccessQueryOptionsType = StructType({
+    /**
+     * Table name to query (case-sensitive).
+     */
+    table: StringType,
+    /**
+     * Specific columns to retrieve.
+     * Optional, defaults to all columns.
+     */
+    columns: OptionType(ArrayType(StringType)),
+    /**
+     * Number of rows to skip.
+     * Optional, defaults to 0.
+     */
+    rowOffset: OptionType(IntegerType),
+    /**
+     * Maximum number of rows to return.
+     * Optional, defaults to all rows.
+     */
+    rowLimit: OptionType(IntegerType),
+});
+/**
+ * Access table list result.
+ */
+export const AccessTablesResultType = StructType({
+    /** Array of table names in the database */
+    tables: ArrayType(StringType),
+});
 //# sourceMappingURL=types.js.map

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

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