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

package/dist/src/nosql/redis.js.map

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

package/dist/{nosql → src/nosql}/types.d.ts

@@ -17,15 +17,15 @@ import { StructType, OptionType, StringType, IntegerType, RecursiveType } from "
  */
 export declare const RedisConfigType: StructType<{
     /** Redis server hostname or IP address */
-    host: StringType;
+    readonly host: StringType;
     /** Redis server port (typically 6379) */
-    port: IntegerType;
+    readonly port: IntegerType;
     /** Password for authentication (optional) */
-    password: OptionType<StringType>;
+    readonly password: OptionType<StringType>;
     /** Database index (0-15, optional, defaults to 0) */
-    db: OptionType<IntegerType>;
+    readonly db: OptionType<IntegerType>;
     /** Key prefix for all operations (optional) */
-    keyPrefix: OptionType<StringType>;
+    readonly keyPrefix: OptionType<StringType>;
 }>;
 /**
  * MongoDB connection configuration.
@@ -34,11 +34,11 @@ export declare const RedisConfigType: StructType<{
  */
 export declare const MongoConfigType: StructType<{
     /** MongoDB connection URI */
-    uri: StringType;
+    readonly uri: StringType;
     /** Database name */
-    database: StringType;
+    readonly database: StringType;
     /** Collection name */
-    collection: StringType;
+    readonly collection: StringType;
 }>;
 /**
  * BSON-compatible value type (recursive).
@@ -54,9 +54,9 @@ export declare const BsonValueType: ReturnType<typeof RecursiveType>;
  */
 export declare const MongoFindOptionsType: StructType<{
     /** Maximum number of documents to return (optional) */
-    limit: OptionType<IntegerType>;
+    readonly limit: OptionType<IntegerType>;
     /** Number of documents to skip (optional) */
-    skip: OptionType<IntegerType>;
+    readonly skip: OptionType<IntegerType>;
 }>;
 /**
  * Opaque connection handle type.

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/nosql/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EACH,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EAOhB,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,eAAO,MAAM,eAAe;IACxB,0CAA0C;;IAG1C,yCAAyC;;IAGzC,6CAA6C;;IAG7C,qDAAqD;;IAGrD,+CAA+C;;EAEjD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;IACxB,6BAA6B;;IAG7B,oBAAoB;;IAGpB,sBAAsB;;EAExB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,UAAU,CAAC,OAAO,aAAa,CAU1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC7B,uDAAuD;;IAGvD,6CAA6C;;EAE/C,CAAC;AAEH;;;;;;GAMG;AACH,QAAA,MAAM,oBAAoB,YAAa,CAAC;AAGxC,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/nosql/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EACH,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,EACT,QAAQ,GACX,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACtC,0CAA0C;IAC1C,IAAI,EAAE,UAAU;IAEhB,yCAAyC;IACzC,IAAI,EAAE,WAAW;IAEjB,6CAA6C;IAC7C,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC;IAEhC,qDAAqD;IACrD,EAAE,EAAE,UAAU,CAAC,WAAW,CAAC;IAE3B,+CAA+C;IAC/C,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACtC,6BAA6B;IAC7B,GAAG,EAAE,UAAU;IAEf,oBAAoB;IACpB,QAAQ,EAAE,UAAU;IAEpB,sBAAsB;IACtB,UAAU,EAAE,UAAU;CACzB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAClF,WAAW,CAAC;IACR,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;IACtB,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;CACrC,CAAC,CACL,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC3C,uDAAuD;IACvD,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;IAE9B,6CAA6C;IAC7C,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC;CAChC,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC,mDAAmD;AACnD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/src/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH;;;;GAIG;AACH,QAAA,MAAM,cAAc,qDAcnB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/{platform.js → src/platform.js}

@@ -14,6 +14,7 @@
 import { SqliteImpl } from "./sql/sqlite.js";
 import { PostgresImpl } from "./sql/postgres.js";
 import { MySqlImpl } from "./sql/mysql.js";
+import { AccessImpl } from "./sql/access.js";
 // Storage implementations
 import { S3Impl } from "./storage/s3.js";
 // Transfer implementations
@@ -37,6 +38,7 @@ const NodeIOPlatform = [
     ...SqliteImpl,
     ...PostgresImpl,
     ...MySqlImpl,
+    ...AccessImpl,
     ...S3Impl,
     ...FtpImpl,
     ...SftpImpl,

package/dist/src/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/platform.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,0BAA0B;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,2BAA2B;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,8BAA8B;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,cAAc,GAAG;IACnB,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,SAAS;IACZ,GAAG,UAAU;IACb,GAAG,MAAM;IACT,GAAG,OAAO;IACV,GAAG,QAAQ;IACX,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,OAAO;IACV,GAAG,OAAO;CACb,CAAC;AAEF,eAAe,cAAc,CAAC"}

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

@@ -0,0 +1,243 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Microsoft Access platform functions for East Node IO.
+ *
+ * Provides read-only Access database operations for East programs, including
+ * opening databases, listing tables, and querying table data with user-defined
+ * return types.
+ *
+ * Uses the mdb-reader library which supports Access 97 through Access 2019,
+ * including encrypted databases.
+ *
+ * **Important**: This module is read-only. The mdb-reader library cannot create
+ * or modify Access databases.
+ *
+ * Supported formats:
+ * - `.mdb` - Access 97, 2000, 2002/2003
+ * - `.accdb` - Access 2007, 2010, 2013, 2016, 2019
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, IntegerType, NullType, OptionType, StringType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * Opens a Microsoft Access database file.
+ *
+ * Opens an Access database file (.mdb or .accdb) and returns an opaque handle
+ * for use in queries. Supports Access 97 through Access 2019, including
+ * encrypted databases.
+ *
+ * This is a platform function for the East language, enabling Access database
+ * read operations in East programs running on Node.js.
+ *
+ * @param config - Access connection configuration
+ * @returns Connection handle (opaque string)
+ *
+ * @throws {EastError} When connection fails due to:
+ * - Invalid file path (location: "access_open")
+ * - File not found (location: "access_open")
+ * - Invalid password for encrypted database (location: "access_open")
+ * - Unsupported database format (location: "access_open")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const listTables = East.function([], NullType, ($) => {
+ *     const config = $.let({
+ *         path: "./database.mdb",
+ *         password: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Access.open(config));
+ *     const tables = $.let(SQL.Access.tables(conn));
+ *     $(SQL.Access.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(listTables.toIR(), SQL.Access.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @remarks
+ * - Access databases are read-only (mdb-reader does not support writes)
+ * - Supports encrypted databases with password option
+ * - Database file is read entirely into memory on open
+ */
+export declare const access_open: import("@elaraai/east").AsyncPlatformDefinition<[import("@elaraai/east").StructType<{
+    readonly path: StringType;
+    readonly password: OptionType<StringType>;
+}>], StringType>;
+/**
+ * Lists all table names in an Access database.
+ *
+ * Returns an array of table names available in the database.
+ * Only returns normal tables (not system or linked tables).
+ *
+ * @param handle - Connection handle from access_open()
+ * @returns Object containing array of table names
+ *
+ * @throws {EastError} When operation fails due to:
+ * - Invalid connection handle (location: "access_tables")
+ *
+ * @example
+ * ```ts
+ * import { East, NullType, variant } from "@elaraai/east";
+ * import { SQL } from "@elaraai/east-node-io";
+ *
+ * const showTables = East.function([], NullType, ($) => {
+ *     const config = $.let({
+ *         path: "./database.mdb",
+ *         password: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Access.open(config));
+ *     const result = $.let(SQL.Access.tables(conn));
+ *     // result.tables contains ['Table1', 'Table2', ...]
+ *     $(SQL.Access.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(showTables.toIR(), SQL.Access.Implementation);
+ * await compiled();
+ * ```
+ */
+export declare const access_tables: import("@elaraai/east").AsyncPlatformDefinition<[StringType], import("@elaraai/east").StructType<{
+    readonly tables: ArrayType<StringType>;
+}>>;
+/**
+ * Queries data from an Access database table with a user-defined return type.
+ *
+ * Reads rows from a specified table with optional column selection and pagination.
+ * The return type is generic, allowing users to specify the expected row structure
+ * for type-safe access to query results.
+ *
+ * This is a generic platform function for the East language, enabling type-safe
+ * Access database read operations in East programs running on Node.js.
+ *
+ * @typeParam T - The expected row type for query results
+ * @param handle - Connection handle from access_open()
+ * @param options - Query options including table name, columns, offset, and limit
+ * @returns Array of rows matching the specified type T
+ *
+ * @throws {EastError} When query fails due to:
+ * - Invalid connection handle (location: "access_query")
+ * - Table not found (location: "access_query")
+ * - Column not found (location: "access_query")
+ *
+ * @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: "./database.mdb",
+ *         password: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Access.open(config));
+ *     // Query with typed results - returns Array<UserRowType>
+ *     const users = $.let(SQL.Access.query([UserRowType], conn, {
+ *         table: "Users",
+ *         columns: variant('some', ["id", "name", "email"]),
+ *         rowOffset: variant('none', null),
+ *         rowLimit: variant('some', 100n),
+ *     }));
+ *     // users is typed as Array<{ id: bigint, name: string, email: string }>
+ *     $(SQL.Access.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(queryUsers.toIR(), SQL.Access.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @remarks
+ * - Table names are case-sensitive
+ * - The row type T should match the structure of the queried columns
+ * - All Access data types are mapped to appropriate East types
+ * - NULL values are preserved in the result
+ */
+export declare const access_query: import("@elaraai/east").AsyncGenericPlatformDefinition<readonly ["T"], readonly [StringType, import("@elaraai/east").StructType<{
+    readonly table: StringType;
+    readonly columns: OptionType<ArrayType<StringType>>;
+    readonly rowOffset: OptionType<IntegerType>;
+    readonly rowLimit: OptionType<IntegerType>;
+}>], ArrayType<"T">>;
+/**
+ * Closes an Access database connection.
+ *
+ * Closes the database connection and releases all resources.
+ * The handle becomes invalid after this operation.
+ *
+ * @param handle - Connection handle from access_open()
+ *
+ * @throws {EastError} When handle is invalid (location: "access_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({
+ *         path: "./database.mdb",
+ *         password: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.Access.open(config));
+ *     // ... do work ...
+ *     $(SQL.Access.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanup.toIR(), SQL.Access.Implementation);
+ * await compiled();
+ * ```
+ */
+export declare const access_close: import("@elaraai/east").AsyncPlatformDefinition<[StringType], NullType>;
+/**
+ * Closes all Access database connections.
+ *
+ * Closes all active Access connections 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.Access.closeAll());
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanupAll.toIR(), SQL.Access.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @internal
+ */
+export declare const access_close_all: import("@elaraai/east").AsyncPlatformDefinition<[], NullType>;
+/**
+ * Node.js implementation of Access platform functions.
+ *
+ * Provides the runtime implementations for Access database operations.
+ * Pass this to East.compileAsync() to enable Access functionality.
+ */
+export declare const AccessImpl: PlatformFunction[];
+//# sourceMappingURL=access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../../src/sql/access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAwD,WAAW,EAAoB,QAAQ,EAAE,UAAU,EAAE,UAAU,EAA4B,MAAM,eAAe,CAAC;AAE3L,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAY9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,WAAW;;;gBAA8E,CAAC;AAEvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,aAAa;;GAAsF,CAAC;AAEjH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,eAAO,MAAM,YAAY;;;;;oBAKxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,YAAY,yEAAuE,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,gBAAgB,+DAAuD,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,gBAAgB,EAuNxC,CAAC"}