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

package/dist/sql/postgres.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * PostgreSQL platform functions for East Node IO.
+ *
+ * Provides PostgreSQL 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 PostgreSQL database.
+ *
+ * Creates a connection pool to a PostgreSQL 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 PostgreSQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param config - PostgreSQL connection configuration
+ * @returns Connection handle (opaque string)
+ *
+ * @throws {EastError} When connection fails due to:
+ * - Network errors (location: "postgres_connect")
+ * - Authentication failures (location: "postgres_connect")
+ * - Invalid configuration (location: "postgres_connect")
+ * - Database does not exist (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     $(SQL.Postgres.query(
+ *         conn,
+ *         "SELECT name FROM users WHERE id = $1",
+ *         [variant('Integer', userId)]
+ *     ));
+ *     $(SQL.Postgres.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(getUserById.toIR(), SQL.Postgres.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 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>;
+}>], EastStringType>;
+/**
+ * Executes a SQL query with parameterized values.
+ *
+ * Runs a SQL query against a PostgreSQL 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 postgres_connect()
+ * @param sql - SQL query string with $1, $2, etc. 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: "postgres_query")
+ * - SQL syntax errors (location: "postgres_query")
+ * - Connection timeout (location: "postgres_query")
+ * - Parameter type mismatch (location: "postgres_query")
+ * - Constraint violations (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     const result = $.let(SQL.Postgres.query(
+ *         conn,
+ *         "INSERT INTO users (name, email) VALUES ($1, $2) RETURNING id",
+ *         [variant('String', "Alice"), variant('String', "alice@example.com")]
+ *     ));
+ *     $(SQL.Postgres.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(insertUser.toIR(), SQL.Postgres.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses $1, $2, $3, etc. for parameter placeholders
+ * - NULL values map to {tag: "null", value: {}}
+ * - 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;
+}>>], 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 PostgreSQL connection pool.
+ *
+ * Closes the connection pool and releases all resources.
+ * All active connections are terminated gracefully.
+ *
+ * @param handle - Connection handle from postgres_connect()
+ *
+ * @throws {EastError} When handle is invalid (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     // ... do work ...
+ *     $(SQL.Postgres.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanup.toIR(), SQL.Postgres.Implementation);
+ * await compiled();
+ * ```
+ */
+export declare const postgres_close: import("@elaraai/east").AsyncPlatformDefinition<[EastStringType], NullType>;
+/**
+ * Closes all PostgreSQL connections.
+ *
+ * Closes all active PostgreSQL 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.Postgres.closeAll());
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanupAll.toIR(), SQL.Postgres.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @internal
+ */
+export declare const postgres_close_all: import("@elaraai/east").AsyncPlatformDefinition<[], NullType>;
+/**
+ * Node.js implementation of PostgreSQL platform functions.
+ *
+ * Provides the runtime implementations for PostgreSQL operations.
+ * Pass this to East.compileAsync() to enable PostgreSQL functionality.
+ */
+export declare const PostgresImpl: PlatformFunction[];
+//# sourceMappingURL=postgres.d.ts.map

package/dist/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,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;AA4BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;oBAAqF,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAA6G,CAAC;AAEzI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,cAAc,6EAAyE,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,kBAAkB,+DAAyD,CAAC;AAkFzF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,gBAAgB,EAoI1C,CAAC"}

package/dist/sql/postgres.js

@@ -0,0 +1,381 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * PostgreSQL platform functions for East Node IO.
+ *
+ * Provides PostgreSQL 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 pg from 'pg';
+import { createHandle, getConnection, closeHandle, closeAllHandles } from '../connection/index.js';
+import { PostgresConfigType, ConnectionHandleType, SqlParametersType, SqlResultType, StringType, SqlParameterType } from './types.js';
+/**
+ * Connects to a PostgreSQL database.
+ *
+ * Creates a connection pool to a PostgreSQL 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 PostgreSQL database
+ * operations in East programs running on Node.js.
+ *
+ * @param config - PostgreSQL connection configuration
+ * @returns Connection handle (opaque string)
+ *
+ * @throws {EastError} When connection fails due to:
+ * - Network errors (location: "postgres_connect")
+ * - Authentication failures (location: "postgres_connect")
+ * - Invalid configuration (location: "postgres_connect")
+ * - Database does not exist (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     $(SQL.Postgres.query(
+ *         conn,
+ *         "SELECT name FROM users WHERE id = $1",
+ *         [variant('Integer', userId)]
+ *     ));
+ *     $(SQL.Postgres.close(conn));
+ *     $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(getUserById.toIR(), SQL.Postgres.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 postgres_connect = East.asyncPlatform("postgres_connect", [PostgresConfigType], ConnectionHandleType);
+/**
+ * Executes a SQL query with parameterized values.
+ *
+ * Runs a SQL query against a PostgreSQL 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 postgres_connect()
+ * @param sql - SQL query string with $1, $2, etc. 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: "postgres_query")
+ * - SQL syntax errors (location: "postgres_query")
+ * - Connection timeout (location: "postgres_query")
+ * - Parameter type mismatch (location: "postgres_query")
+ * - Constraint violations (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     const result = $.let(SQL.Postgres.query(
+ *         conn,
+ *         "INSERT INTO users (name, email) VALUES ($1, $2) RETURNING id",
+ *         [variant('String', "Alice"), variant('String', "alice@example.com")]
+ *     ));
+ *     $(SQL.Postgres.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(insertUser.toIR(), SQL.Postgres.Implementation);
+ * await compiled(42n);
+ * ```
+ *
+ * @remarks
+ * - Uses $1, $2, $3, etc. for parameter placeholders
+ * - NULL values map to {tag: "null", value: {}}
+ * - All queries are asynchronous
+ * - Parameters prevent SQL injection attacks
+ */
+export const postgres_query = East.asyncPlatform("postgres_query", [ConnectionHandleType, StringType, SqlParametersType], SqlResultType);
+/**
+ * Closes a PostgreSQL connection pool.
+ *
+ * Closes the connection pool and releases all resources.
+ * All active connections are terminated gracefully.
+ *
+ * @param handle - Connection handle from postgres_connect()
+ *
+ * @throws {EastError} When handle is invalid (location: "postgres_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: 5432n,
+ *         database: "myapp",
+ *         user: "postgres",
+ *         password: "secret",
+ *         ssl: variant('none', null),
+ *         maxConnections: variant('none', null),
+ *     });
+ *     const conn = $.let(SQL.Postgres.connect(config));
+ *     // ... do work ...
+ *     $(SQL.Postgres.close(conn));
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanup.toIR(), SQL.Postgres.Implementation);
+ * await compiled();
+ * ```
+ */
+export const postgres_close = East.asyncPlatform("postgres_close", [ConnectionHandleType], NullType);
+/**
+ * Closes all PostgreSQL connections.
+ *
+ * Closes all active PostgreSQL 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.Postgres.closeAll());
+ *     return $.return(null);
+ * });
+ *
+ * const compiled = East.compileAsync(cleanupAll.toIR(), SQL.Postgres.Implementation);
+ * await compiled();
+ * ```
+ *
+ * @internal
+ */
+export const postgres_close_all = East.asyncPlatform("postgres_close_all", [], NullType);
+/**
+ * Converts East SQL parameter to native JavaScript value.
+ *
+ * @param param - East SQL parameter variant
+ * @returns JavaScript value for PostgreSQL binding
+ * @internal
+ */
+function convertParamToNative(param) {
+    return match(param, {
+        String: (value) => value,
+        Integer: (value) => Number(value), // PostgreSQL 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 PostgreSQL
+    });
+}
+/**
+ * Converts native JavaScript value to East SQL parameter variant.
+ *
+ * @param value - Native JavaScript value from PostgreSQL
+ * @param columnOid - PostgreSQL column OID from field metadata
+ * @returns East SQL parameter variant
+ * @internal
+ */
+function convertNativeToParam(value, columnOid) {
+    if (isValueOf(value, NullType)) {
+        return variant('Null', null);
+    }
+    else if (((columnOid === null) &&
+        isValueOf(value, BooleanType)) || ((columnOid === 16) && // bool
+        isValueOf(value, BooleanType))) {
+        return variant('Boolean', value);
+    }
+    else if (((columnOid === null) &&
+        isValueOf(value, IntegerType)) || ((columnOid === 20 || columnOid === 21 || columnOid === 23) && // int8, int2, int4
+        (isValueOf(value, IntegerType) || isValueOf(value, FloatType)))) {
+        return variant('Integer', BigInt(value));
+    }
+    else if ((columnOid === 700 || columnOid === 701 || columnOid === 1700 || columnOid === null) && // float4, float8, numeric
+        isValueOf(value, FloatType)) {
+        return variant('Float', value);
+    }
+    else if ((columnOid === 25 || columnOid === 1042 || columnOid === 1043 || columnOid === null) && // text, bpchar, varchar
+        isValueOf(value, EastStringType)) {
+        return variant('String', value);
+    }
+    else if (((columnOid === null) &&
+        isValueOf(value, DateTimeType)) || ((columnOid === 1082 || columnOid === 1083 || columnOid === 1114 || columnOid === 1184) && // date, time, timestamp, timestamptz
+        isValueOf(value, DateTimeType))) {
+        return variant('DateTime', value);
+    }
+    else if ((columnOid === 17 || columnOid === null) && // bytea
+        isValueOf(value, BlobType)) {
+        return variant('Blob', value);
+    }
+    else {
+        return variant('Null', null);
+    }
+}
+/**
+ * Node.js implementation of PostgreSQL platform functions.
+ *
+ * Provides the runtime implementations for PostgreSQL operations.
+ * Pass this to East.compileAsync() to enable PostgreSQL functionality.
+ */
+export const PostgresImpl = [
+    postgres_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 = { rejectUnauthorized: false };
+            }
+            // Handle optional max connections
+            if (config.maxConnections?.type === 'some') {
+                poolConfig.max = Number(config.maxConnections.value);
+            }
+            const pool = new pg.Pool(poolConfig);
+            // Test the connection
+            const client = await pool.connect();
+            client.release();
+            return createHandle(pool, async () => {
+                await pool.end();
+            });
+        }
+        catch (err) {
+            throw new EastError(`PostgreSQL connection failed: ${err.message}`, {
+                location: { filename: "postgres_connect", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    postgres_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 result = await pool.query(sql, nativeParams);
+            // Validate result structure
+            if (!result || typeof result !== 'object') {
+                throw new EastError('Invalid result from PostgreSQL query', {
+                    location: { filename: "postgres_query", line: 0n, column: 0n }
+                });
+            }
+            if (!Array.isArray(result.rows)) {
+                throw new EastError('PostgreSQL query result missing rows array', {
+                    location: { filename: "postgres_query", line: 0n, column: 0n }
+                });
+            }
+            // PostgreSQL provides a `command` field indicating query type
+            const command = result.command?.toUpperCase();
+            if (command === 'SELECT') {
+                // Get column metadata for type information
+                const columnOidMap = new Map();
+                if (result.fields) {
+                    for (const field of result.fields) {
+                        columnOidMap.set(field.name, field.dataTypeID);
+                    }
+                }
+                // Convert rows to East format (SortedMap objects)
+                const eastRows = result.rows.map((row) => {
+                    const eastRow = new SortedMap();
+                    for (const [key, value] of Object.entries(row)) {
+                        const columnOid = columnOidMap.get(key) || null;
+                        eastRow.set(key, convertNativeToParam(value, columnOid));
+                    }
+                    return eastRow;
+                });
+                return variant('select', { rows: eastRows });
+            }
+            else if (command === 'INSERT') {
+                return variant('insert', {
+                    rowsAffected: BigInt(result.rowCount ?? 0),
+                    lastInsertId: variant('none', null) // PostgreSQL doesn't provide lastInsertId automatically
+                });
+            }
+            else if (command === 'UPDATE') {
+                return variant('update', {
+                    rowsAffected: BigInt(result.rowCount ?? 0)
+                });
+            }
+            else if (command === 'DELETE') {
+                return variant('delete', {
+                    rowsAffected: BigInt(result.rowCount ?? 0)
+                });
+            }
+            else {
+                // For other commands (CREATE, DROP, ALTER, etc.), return as select with empty rows
+                // This maintains compatibility with DDL statements
+                return variant('select', { rows: [] });
+            }
+        }
+        catch (err) {
+            throw new EastError(`PostgreSQL query failed: ${err.message}`, {
+                location: { filename: "postgres_query", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    postgres_close.implement(async (handle) => {
+        try {
+            const pool = getConnection(handle);
+            await pool.end();
+            closeHandle(handle);
+            return null;
+        }
+        catch (err) {
+            throw new EastError(`PostgreSQL close failed: ${err.message}`, {
+                location: { filename: "postgres_close", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    postgres_close_all.implement(async () => {
+        await closeAllHandles();
+        return null;
+    }),
+];
+//# sourceMappingURL=postgres.js.map

package/dist/sql/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/sql/postgres.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,IAAI,cAAc,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGhL,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EACH,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,gBAAgB,EACnB,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC,kBAAkB,CAAC,EAAE,oBAAoB,CAAC,CAAC;AAEnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,UAAU,EAAE,iBAAiB,CAAC,EAAE,aAAa,CAAC,CAAC;AAEzI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,aAAa,CAAC,oBAAoB,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;AAEzF;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,KAA2C;IACrE,OAAO,KAAK,CAAC,KAAK,EAAE;QAChB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;QACxB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAG,oCAAoC;QACxE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;QACvB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;QACzB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;QACtB,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAG,+BAA+B;QACrE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAG,0CAA0C;KAC1E,CAAC,CAAA;AACN,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAAC,KAAU,EAAE,SAA6B;IACnE,IAAI,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;SAAM,IACH,CACI,CAAC,SAAS,KAAK,IAAI,CAAC;QACpB,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAChC,IAAI,CACD,CAAC,SAAS,KAAK,EAAE,CAAC,IAAK,OAAO;QAC9B,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAChC,EACH,CAAC;QACC,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;SAAM,IACH,CACI,CAAC,SAAS,KAAK,IAAI,CAAC;QACpB,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAChC,IAAI,CACD,CAAC,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,CAAC,IAAK,mBAAmB;QAClF,CAAC,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CACjE,EACH,CAAC;QACC,OAAO,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;SAAM,IACH,CAAC,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,CAAC,IAAK,0BAA0B;QACnH,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,EAC7B,CAAC;QACC,OAAO,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;SAAM,IACH,CAAC,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,CAAC,IAAK,wBAAwB;QACjH,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,EAClC,CAAC;QACC,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;SAAM,IACH,CACI,CAAC,SAAS,KAAK,IAAI,CAAC;QACpB,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CACjC,IAAI,CACD,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,CAAC,IAAK,qCAAqC;QAChI,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CACjC,EACH,CAAC;QACC,OAAO,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;SAAM,IACH,CAAC,SAAS,KAAK,EAAE,IAAI,SAAS,KAAK,IAAI,CAAC,IAAK,QAAQ;QACrD,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAC5B,CAAC;QACC,OAAO,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACJ,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB;IAC5C,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,MAA8C,EAAE,EAAE;QAChF,IAAI,CAAC;YACD,MAAM,UAAU,GAAkB;gBAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC5B,CAAC;YAEF,sBAAsB;YACtB,IAAI,MAAM,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBAClD,UAAU,CAAC,GAAG,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;YACnD,CAAC;YAED,kCAAkC;YAClC,IAAI,MAAM,CAAC,cAAc,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzC,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAErC,sBAAsB;YACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,EAAE,CAAC;YAEjB,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;gBACjC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,iCAAiC,GAAG,CAAC,OAAO,EAAE,EAAE;gBAChE,QAAQ,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAChE,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IAEF,cAAc,CAAC,SAAS,CAAC,KAAK,EAC1B,MAAgD,EAChD,GAAmC,EACnC,MAA6C,EACH,EAAE;QAC5C,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,aAAa,CAAU,MAAM,CAAC,CAAC;YAE5C,2CAA2C;YAC3C,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;YAEtD,oBAAoB;YACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAEnD,4BAA4B;YAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxC,MAAM,IAAI,SAAS,CAAC,sCAAsC,EAAE;oBACxD,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;iBACjE,CAAC,CAAC;YACP,CAAC;YAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,SAAS,CAAC,4CAA4C,EAAE;oBAC9D,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;iBACjE,CAAC,CAAC;YACP,CAAC;YAED,8DAA8D;YAC9D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;YAE9C,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACvB,2CAA2C;gBAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;gBAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBAChC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAgC,CAAC,CAAC;oBACzE,CAAC;gBACL,CAAC;gBAED,kDAAkD;gBAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE;oBAC1C,MAAM,OAAO,GAAG,IAAI,SAAS,EAAe,CAAC;oBAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;wBAChD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;oBAC7D,CAAC;oBACD,OAAO,OAAO,CAAC;gBACnB,CAAC,CAAC,CAAC;gBAEH,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAQ,CAAC;YACxD,CAAC;iBAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE;oBACrB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;oBAC1C,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAE,wDAAwD;iBAChG,CAAQ,CAAC;YACd,CAAC;iBAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE;oBACrB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;iBAC7C,CAAQ,CAAC;YACd,CAAC;iBAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,OAAO,CAAC,QAAQ,EAAE;oBACrB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;iBAC7C,CAAQ,CAAC;YACd,CAAC;iBAAM,CAAC;gBACJ,mFAAmF;gBACnF,mDAAmD;gBACnD,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAQ,CAAC;YAClD,CAAC;QACL,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC9D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IAEF,cAAc,CAAC,SAAS,CAAC,KAAK,EAAE,MAAgD,EAAE,EAAE;QAChF,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,aAAa,CAAU,MAAM,CAAC,CAAC;YAC5C,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACjB,WAAW,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QAChB,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAChB,MAAM,IAAI,SAAS,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,EAAE;gBAC3D,QAAQ,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC9D,KAAK,EAAE,GAAG;aACb,CAAC,CAAC;QACP,CAAC;IACL,CAAC,CAAC;IAEF,kBAAkB,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;QACpC,MAAM,eAAe,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;CACL,CAAC"}