@ibm/ibmi-mcp-server 0.1.0

package/dist/ibmi-mcp-server/services/baseConnectionPool.js

@@ -0,0 +1,431 @@
+/**
+ * @fileoverview Base connection pool abstraction for IBM i connections
+ * Provides shared connection pool logic that can be extended by specific implementations
+ *
+ * @module src/services/baseConnectionPool
+ */
+import pkg from "@ibm/mapepire-js";
+const { Pool, getCertificate } = pkg;
+import { ErrorHandler, logger } from "../../utils/internal/index.js";
+import { requestContextService, } from "../../utils/internal/requestContext.js";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { SqlSecurityValidator } from "../utils/security/sqlSecurityValidator.js";
+/**
+ * Base connection pool manager that provides shared functionality
+ * for all IBM i connection pools in the application
+ */
+export class BaseConnectionPool {
+    pools = new Map();
+    initializationPromises = new Map();
+    /**
+     * Create a daemon server configuration from connection config
+     * @param config - Connection configuration
+     * @param context - Request context for logging
+     */
+    async createDaemonServer(config, context) {
+        const server = {
+            host: config.host,
+            user: config.user,
+            password: config.password,
+            rejectUnauthorized: !(config.ignoreUnauthorized ?? true),
+        };
+        // Get SSL certificate if needed
+        if (!(config.ignoreUnauthorized ?? true)) {
+            logger.debug(context, "Fetching SSL certificate for secure connection");
+            const ca = await getCertificate(server);
+            server.ca = ca.raw;
+        }
+        return server;
+    }
+    /**
+     * Initialize a connection pool for the given identifier
+     * @param poolId - Unique identifier for the pool
+     * @param config - Connection configuration
+     * @param context - Request context for logging
+     */
+    async initializePool(poolId, config, context) {
+        // Check if there's already an initialization in progress
+        const existingPromise = this.initializationPromises.get(poolId);
+        if (existingPromise) {
+            logger.debug(context, `Waiting for existing initialization of pool: ${String(poolId)}`);
+            return existingPromise;
+        }
+        let poolState = this.pools.get(poolId);
+        if (!poolState) {
+            poolState = {
+                pool: null,
+                isInitialized: false,
+                isConnecting: false,
+                healthStatus: "unknown",
+                config,
+            };
+            this.pools.set(poolId, poolState);
+        }
+        // Check if already initialized
+        if (poolState.isInitialized && poolState.pool) {
+            logger.debug(context, `Pool '${String(poolId)}' already initialized`);
+            return;
+        }
+        // Create initialization promise and store it
+        const initPromise = this.performInitialization(poolId, poolState, context);
+        this.initializationPromises.set(poolId, initPromise);
+        try {
+            await initPromise;
+        }
+        finally {
+            // Clean up the promise from the map
+            this.initializationPromises.delete(poolId);
+        }
+    }
+    /**
+     * Perform the actual initialization of a pool
+     * @private
+     */
+    async performInitialization(poolId, poolState, context) {
+        // Double-check if already initialized (in case another thread completed it)
+        if (poolState.isInitialized && poolState.pool) {
+            return;
+        }
+        if (poolState.isConnecting) {
+            logger.debug(context, `Pool '${String(poolId)}' is already connecting, waiting...`);
+            // Wait a bit and check again
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            if (poolState.isInitialized && poolState.pool) {
+                return;
+            }
+        }
+        poolState.isConnecting = true;
+        try {
+            logger.info({
+                ...context,
+                host: poolState.config.host,
+                port: poolState.config.port || 8471,
+                user: poolState.config.user.substring(0, 3) + "***",
+                ignoreUnauthorized: poolState.config.ignoreUnauthorized ?? true,
+            }, `Initializing connection pool: ${String(poolId).substring(0, 7)}***`);
+            // Create daemon server configuration
+            const server = await this.createDaemonServer(poolState.config, context);
+            // Create and initialize connection pool
+            poolState.pool = new Pool({
+                creds: server,
+                maxSize: poolState.config.maxSize || 10,
+                startingSize: poolState.config.startingSize || 2,
+            });
+            await poolState.pool.init();
+            poolState.isInitialized = true;
+            poolState.healthStatus = "healthy";
+            poolState.lastHealthCheck = new Date();
+            logger.info(context, `Connection pool initialized successfully: ${String(poolId).substring(0, 7)}***`);
+        }
+        catch (error) {
+            poolState.isInitialized = false;
+            poolState.healthStatus = "unhealthy";
+            poolState.pool = null;
+            const handledError = ErrorHandler.handleError(error, {
+                operation: "performInitialization",
+                context,
+                errorCode: JsonRpcErrorCode.InitializationFailed,
+                critical: true,
+            });
+            throw handledError;
+        }
+        finally {
+            poolState.isConnecting = false;
+        }
+    }
+    /**
+     * Execute a SQL query on a specific pool
+     * @param poolId - Pool identifier
+     * @param query - SQL query string
+     * @param params - Query parameters
+     * @param context - Request context for logging
+     */
+    async executeQuery(poolId, query, params, context, securityConfig) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "ExecuteQuery",
+                poolId: String(poolId),
+            });
+        return ErrorHandler.tryCatch(async () => {
+            const poolState = this.pools.get(poolId);
+            if (!poolState) {
+                throw new McpError(JsonRpcErrorCode.ConfigurationError, `Pool '${String(poolId)}' not found. Please register the pool first.`, { poolId: String(poolId) });
+            }
+            // Ensure pool is initialized
+            await this.initializePool(poolId, poolState.config, operationContext);
+            if (!poolState.pool) {
+                throw new McpError(JsonRpcErrorCode.InternalError, `Connection pool '${String(poolId)}' is not available`, { poolId: String(poolId) });
+            }
+            // Additional check to ensure pool is properly initialized
+            if (!poolState.isInitialized) {
+                throw new McpError(JsonRpcErrorCode.InternalError, `Connection pool '${String(poolId)}' is not fully initialized`, {
+                    poolId: String(poolId),
+                    isInitialized: poolState.isInitialized,
+                    isConnecting: poolState.isConnecting,
+                });
+            }
+            logger.debug({
+                ...operationContext,
+                query: query,
+                queryLength: query.length,
+                hasParameters: !!params && params.length > 0,
+                paramCount: params?.length || 0,
+            }, `Executing SQL query on pool: ${String(poolId)}`);
+            // Validate parameter types for mapepire compatibility
+            if (params && params.length > 0) {
+                for (let i = 0; i < params.length; i++) {
+                    const param = params[i];
+                    if (param !== null && param !== undefined) {
+                        const isValidType = typeof param === "string" ||
+                            typeof param === "number" ||
+                            (Array.isArray(param) &&
+                                param.every((item) => typeof item === "string" || typeof item === "number"));
+                        if (!isValidType) {
+                            logger.warning({
+                                ...operationContext,
+                                paramIndex: i,
+                                paramType: typeof param,
+                                paramValue: param,
+                            }, `Parameter ${i} has invalid type for mapepire binding`);
+                        }
+                    }
+                }
+            }
+            // Apply security validation if config is provided
+            if (securityConfig) {
+                SqlSecurityValidator.validateQuery(query, securityConfig, operationContext);
+            }
+            const result = await poolState.pool.execute(query, {
+                parameters: params,
+            });
+            logger.debug({
+                ...operationContext,
+                rowCount: result.data?.length || 0,
+                success: result.success,
+                sqlReturnCode: result.sql_rc,
+                executionTime: result.execution_time,
+            }, `Query executed successfully on pool: ${String(poolId)}`);
+            // Update health status on successful query
+            poolState.healthStatus = "healthy";
+            poolState.lastHealthCheck = new Date();
+            return result;
+        }, {
+            operation: "ExecuteQuery",
+            context: operationContext,
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    /**
+     * Execute a SQL query with automatic pagination
+     * @param poolId - Pool identifier
+     * @param query - SQL query string
+     * @param params - Query parameters
+     * @param context - Request context for logging
+     * @param fetchSize - Number of records per fetch
+     */
+    async executeQueryWithPagination(poolId, query, params, context, fetchSize = 300, securityConfig) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "ExecuteQueryWithPagination",
+                poolId: String(poolId),
+            });
+        return ErrorHandler.tryCatch(async () => {
+            const poolState = this.pools.get(poolId);
+            if (!poolState) {
+                throw new McpError(JsonRpcErrorCode.ConfigurationError, `Pool '${String(poolId)}' not found`, { poolId: String(poolId) });
+            }
+            // Ensure pool is initialized
+            await this.initializePool(poolId, poolState.config, operationContext);
+            if (!poolState.pool) {
+                throw new McpError(JsonRpcErrorCode.InternalError, "Connection pool is not available");
+            }
+            // Apply security validation if config is provided
+            if (securityConfig) {
+                SqlSecurityValidator.validateQuery(query, securityConfig, operationContext);
+            }
+            logger.debug({
+                ...operationContext,
+                queryLength: query.length,
+                hasParameters: !!params && params.length > 0,
+                paramCount: params?.length || 0,
+                fetchSize,
+            }, "Executing SQL query with pagination");
+            // Create query object with parameters
+            const queryObj = poolState.pool.query(query, { parameters: params });
+            // Execute initial query
+            let result = await queryObj.execute();
+            const allData = [];
+            if (result.success && result.data) {
+                allData.push(...result.data);
+            }
+            // Fetch more results until done
+            let fetchCount = 1;
+            while (!result.is_done && fetchCount < 100) {
+                // Safety limit
+                logger.debug({
+                    ...operationContext,
+                    fetchCount,
+                    currentDataLength: allData.length,
+                }, "Fetching more results");
+                result = await queryObj.fetchMore(fetchSize);
+                if (result.success && result.data) {
+                    allData.push(...result.data);
+                }
+                fetchCount++;
+            }
+            // Close the query
+            await queryObj.close();
+            logger.debug({
+                ...operationContext,
+                totalRows: allData.length,
+                fetchCount,
+                success: result.success,
+                sqlReturnCode: result.sql_rc,
+                executionTime: result.execution_time,
+            }, "Paginated query completed");
+            return {
+                data: allData,
+                success: result.success,
+                sql_rc: result.sql_rc,
+                execution_time: result.execution_time,
+            };
+        }, {
+            operation: "ExecuteQueryWithPagination",
+            context: operationContext,
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    /**
+     * Check the health of a specific pool
+     * @param poolId - Pool identifier
+     * @param context - Request context for logging
+     */
+    async checkPoolHealth(poolId, context) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "CheckPoolHealth",
+                poolId: String(poolId),
+            });
+        const poolState = this.pools.get(poolId);
+        if (!poolState) {
+            return {
+                status: "unknown",
+                initialized: false,
+                connecting: false,
+            };
+        }
+        try {
+            if (!poolState.isInitialized || !poolState.pool) {
+                return {
+                    status: "unknown",
+                    initialized: false,
+                    connecting: poolState.isConnecting,
+                };
+            }
+            // Execute a simple query to test connection
+            await this.executeQuery(poolId, "SELECT 1 FROM SYSIBM.SYSDUMMY1", [], operationContext);
+            poolState.healthStatus = "healthy";
+            poolState.lastHealthCheck = new Date();
+            logger.debug(operationContext, `Health check passed for pool: ${String(poolId)}`);
+            return {
+                status: "healthy",
+                lastCheck: poolState.lastHealthCheck,
+                initialized: true,
+                connecting: false,
+            };
+        }
+        catch (error) {
+            poolState.healthStatus = "unhealthy";
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error({
+                ...operationContext,
+                error: errorMessage,
+            }, `Health check failed for pool: ${String(poolId)}`);
+            return {
+                status: "unhealthy",
+                lastError: errorMessage,
+                lastCheck: new Date(),
+                initialized: poolState.isInitialized,
+                connecting: poolState.isConnecting,
+            };
+        }
+    }
+    /**
+     * Close a specific pool's connections
+     * @param poolId - Pool identifier
+     * @param context - Request context for logging
+     */
+    async closePool(poolId, context) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "ClosePool",
+                poolId: String(poolId),
+            });
+        const poolState = this.pools.get(poolId);
+        if (!poolState || !poolState.pool) {
+            return;
+        }
+        try {
+            logger.info(operationContext, `Closing connection pool: ${String(poolId)}`);
+            await poolState.pool.end();
+            poolState.pool = null;
+            poolState.isInitialized = false;
+            poolState.healthStatus = "unknown";
+            logger.info(operationContext, `Connection pool closed successfully: ${String(poolId)}`);
+        }
+        catch (error) {
+            logger.error({
+                ...operationContext,
+                error: error instanceof Error ? error.message : String(error),
+            }, `Error closing connection pool: ${String(poolId)}`);
+        }
+    }
+    /**
+     * Close all connection pools gracefully
+  
+    /**
+     * Close all connection pools gracefully
+     * @param context - Request context for logging
+     */
+    async closeAllPools(context) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "CloseAllPools",
+            });
+        const closePromises = Array.from(this.pools.keys()).map((poolId) => this.closePool(poolId, operationContext));
+        const results = await Promise.allSettled(closePromises);
+        logger.info({
+            ...operationContext,
+            closedCount: results.length,
+        }, "All connection pools closed");
+    }
+    /**
+     * Get status of a specific pool
+     * @param poolId - Pool identifier
+     */
+    getPoolStatus(poolId) {
+        const poolState = this.pools.get(poolId);
+        if (!poolState) {
+            return null;
+        }
+        return {
+            initialized: poolState.isInitialized,
+            connecting: poolState.isConnecting,
+            healthStatus: poolState.healthStatus,
+        };
+    }
+    /**
+     * Get list of registered pool identifiers
+     */
+    getRegisteredPools() {
+        return Array.from(this.pools.keys());
+    }
+    /**
+     * Clear all pools (for testing)
+     */
+    clearAllPools() {
+        this.pools.clear();
+        this.initializationPromises.clear();
+    }
+}
+//# sourceMappingURL=baseConnectionPool.js.map

package/dist/ibmi-mcp-server/services/baseConnectionPool.js.map

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

package/dist/ibmi-mcp-server/services/connectionPool.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview IBM i connection pool management using mapepire-js
+ * This module provides a singleton connection pool for IBM i DB2 database operations.
+ * Credentials are provided by the MCP client via environment variables.
+ *
+ * @module src/services/mapepire/connectionPool
+ */
+import { BindingValue, QueryResult } from "@ibm/mapepire-js";
+import { RequestContext } from "../../utils/internal/requestContext.js";
+import { BaseConnectionPool } from "./baseConnectionPool.js";
+declare const IBM_I_POOL_ID: unique symbol;
+/**
+ * IBM i connection pool manager with lazy initialization
+ * Credentials are provided by MCP client via environment variables
+ */
+export declare class IBMiConnectionPool extends BaseConnectionPool<typeof IBM_I_POOL_ID> {
+    private static instance;
+    /**
+     * Get the singleton instance
+     */
+    private static getInstance;
+    /**
+     * Initialize the connection pool using credentials from config
+     * Called automatically on first query if not already initialized
+     */
+    private static ensureInitialized;
+    /**
+     * Execute a SQL query with automatic pagination to fetch all results
+     * Uses the query/execute/fetchMore pattern for large result sets
+     */
+    static executeQueryWithPagination(query: string, params?: BindingValue[], context?: RequestContext, fetchSize?: number): Promise<{
+        data: unknown[];
+        success: boolean;
+        sql_rc?: unknown;
+        execution_time?: number;
+    }>;
+    /**
+     * Execute a SQL query against the IBM i database
+     * Automatically initializes the pool if not already done
+     */
+    static executeQuery(query: string, params?: BindingValue[], context?: RequestContext): Promise<QueryResult<unknown>>;
+    /**
+     * Check the health of the connection pool
+     */
+    static healthCheck(): Promise<boolean>;
+    /**
+     * Close the connection pool gracefully
+     */
+    static close(): Promise<void>;
+    /**
+     * Get connection pool status for monitoring
+     */
+    static getStatus(): {
+        initialized: boolean;
+        connecting: boolean;
+        poolExists: boolean;
+    };
+}
+export {};
+//# sourceMappingURL=connectionPool.d.ts.map

package/dist/ibmi-mcp-server/services/connectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionPool.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/services/connectionPool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI7D,OAAO,EAEL,cAAc,EACf,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AAGjC,QAAA,MAAM,aAAa,eAAgC,CAAC;AAEpD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,OAAO,aAAa,CACrB;IACC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B;;;OAGG;mBACkB,iBAAiB;IA0DtC;;;OAGG;WACU,0BAA0B,CACrC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC;QACT,IAAI,EAAE,OAAO,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAkBF;;;OAGG;WACU,YAAY,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,YAAY,EAAE,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAiBhC;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAwB5C;;OAEG;WACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC;;OAEG;IACH,MAAM,CAAC,SAAS,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;KACrB;CAUF"}

package/dist/ibmi-mcp-server/services/connectionPool.js

@@ -0,0 +1,153 @@
+/**
+ * @fileoverview IBM i connection pool management using mapepire-js
+ * This module provides a singleton connection pool for IBM i DB2 database operations.
+ * Credentials are provided by the MCP client via environment variables.
+ *
+ * @module src/services/mapepire/connectionPool
+ */
+import { config } from "../../config/index.js";
+import { logger } from "../../utils/internal/logger.js";
+import { ErrorHandler } from "../../utils/internal/errorHandler.js";
+import { requestContextService, } from "../../utils/internal/requestContext.js";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { BaseConnectionPool, } from "./baseConnectionPool.js";
+// Singleton identifier for the IBM i connection pool
+const IBM_I_POOL_ID = Symbol("ibmi-singleton-pool");
+/**
+ * IBM i connection pool manager with lazy initialization
+ * Credentials are provided by MCP client via environment variables
+ */
+export class IBMiConnectionPool extends BaseConnectionPool {
+    static instance;
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new IBMiConnectionPool();
+        }
+        return this.instance;
+    }
+    /**
+     * Initialize the connection pool using credentials from config
+     * Called automatically on first query if not already initialized
+     */
+    static async ensureInitialized() {
+        const instance = this.getInstance();
+        const poolState = instance.pools.get(IBM_I_POOL_ID);
+        if (poolState && poolState.isInitialized) {
+            return;
+        }
+        const context = requestContextService.createRequestContext({
+            operation: "InitializeIBMiConnectionPool",
+        });
+        try {
+            // Check if DB2i configuration is available
+            if (!config.db2i) {
+                throw new McpError(JsonRpcErrorCode.ConfigurationError, "DB2i configuration not found. Please ensure DB2i_HOST, DB2i_USER, and DB2i_PASS environment variables are set.", { configSection: "db2i" });
+            }
+            const { host, user, password, ignoreUnauthorized } = config.db2i;
+            logger.info({
+                ...context,
+                host,
+                user: user.substring(0, 3) + "***", // Mask username for security
+                ignoreUnauthorized,
+            }, "Initializing IBM i connection pool");
+            // Convert config to pool connection config
+            const poolConfig = {
+                host,
+                user,
+                password,
+                ignoreUnauthorized,
+            };
+            // Initialize the pool using base class
+            await instance.initializePool(IBM_I_POOL_ID, poolConfig, context);
+            logger.info(context, "IBM i connection pool initialized successfully");
+        }
+        catch (error) {
+            const handledError = ErrorHandler.handleError(error, {
+                operation: "InitializeIBMiConnectionPool",
+                context,
+                errorCode: JsonRpcErrorCode.InitializationFailed,
+                critical: true,
+            });
+            throw handledError;
+        }
+    }
+    /**
+     * Execute a SQL query with automatic pagination to fetch all results
+     * Uses the query/execute/fetchMore pattern for large result sets
+     */
+    static async executeQueryWithPagination(query, params, context, fetchSize = 300) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "ExecuteQueryWithPagination",
+            });
+        await this.ensureInitialized();
+        const instance = this.getInstance();
+        return instance.executeQueryWithPagination(IBM_I_POOL_ID, query, params, operationContext, fetchSize);
+    }
+    /**
+     * Execute a SQL query against the IBM i database
+     * Automatically initializes the pool if not already done
+     */
+    static async executeQuery(query, params, context) {
+        const operationContext = context ||
+            requestContextService.createRequestContext({
+                operation: "ExecuteQuery",
+            });
+        await this.ensureInitialized();
+        const instance = this.getInstance();
+        return instance.executeQuery(IBM_I_POOL_ID, query, params, operationContext);
+    }
+    /**
+     * Check the health of the connection pool
+     */
+    static async healthCheck() {
+        const context = requestContextService.createRequestContext({
+            operation: "ConnectionHealthCheck",
+        });
+        try {
+            await this.ensureInitialized();
+            const instance = this.getInstance();
+            const health = await instance.checkPoolHealth(IBM_I_POOL_ID, context);
+            logger.debug(context, "Connection health check passed");
+            return health.status === "healthy";
+        }
+        catch (error) {
+            logger.error({
+                ...context,
+                error: error instanceof Error ? error.message : String(error),
+            }, "Connection health check failed");
+            return false;
+        }
+    }
+    /**
+     * Close the connection pool gracefully
+     */
+    static async close() {
+        const context = requestContextService.createRequestContext({
+            operation: "CloseConnectionPool",
+        });
+        const instance = this.getInstance();
+        const poolState = instance.pools.get(IBM_I_POOL_ID);
+        if (poolState && poolState.pool) {
+            logger.info(context, "Closing IBM i connection pool");
+            await instance.closePool(IBM_I_POOL_ID, context);
+            logger.info(context, "IBM i connection pool closed successfully");
+        }
+    }
+    /**
+     * Get connection pool status for monitoring
+     */
+    static getStatus() {
+        const instance = this.getInstance();
+        const poolStatus = instance.getPoolStatus(IBM_I_POOL_ID);
+        return {
+            initialized: poolStatus?.initialized ?? false,
+            connecting: poolStatus?.connecting ?? false,
+            poolExists: poolStatus !== null,
+        };
+    }
+}
+//# sourceMappingURL=connectionPool.js.map