@ibm/ibmi-mcp-server 0.1.0

package/dist/mcp-server/transports/stdio/stdioTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAgB,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/mcp-server/transports/stdio/stdioTransport.js

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Handles the setup and connection for the Stdio MCP transport.
+ * Implements the MCP Specification 2025-03-26 for stdio transport.
+ * This transport communicates directly over standard input (stdin) and
+ * standard output (stdout), typically used when the MCP server is launched
+ * as a child process by a host application.
+ *
+ * Specification Reference:
+ * https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/transports.mdx#stdio
+ *
+ * --- Authentication Note ---
+ * As per the MCP Authorization Specification (2025-03-26, Section 1.2),
+ * STDIO transports SHOULD NOT implement HTTP-based authentication flows.
+ * Authorization is typically handled implicitly by the host application
+ * controlling the server process. This implementation follows that guideline.
+ *
+ * @see {@link https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/authorization.mdx | MCP Authorization Specification}
+ * @module src/mcp-server/transports/stdioTransport
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ErrorHandler } from "../../../utils/index.js";
+import { MCP_SPEC_VERSION } from "../../constants.js";
+import { logOperationStart, logOperationSuccess, } from "../../../utils/internal/logging-helpers.js";
+/**
+ * Connects a given `McpServer` instance to the Stdio transport.
+ * This function initializes the SDK's `StdioServerTransport`, which manages
+ * communication over `process.stdin` and `process.stdout` according to the
+ * MCP stdio transport specification.
+ *
+ * MCP Spec Points Covered by SDK's `StdioServerTransport`:
+ * - Reads JSON-RPC messages (requests, notifications, responses, batches) from stdin.
+ * - Writes JSON-RPC messages to stdout.
+ * - Handles newline delimiters and ensures no embedded newlines in output messages.
+ * - Ensures only valid MCP messages are written to stdout.
+ *
+ * Logging via the `logger` utility MAY result in output to stderr, which is
+ * permitted by the spec for logging purposes.
+ *
+ * @param server - The `McpServer` instance.
+ * @param parentContext - The logging and tracing context from the calling function.
+ * @returns A promise that resolves when the Stdio transport is successfully connected.
+ * @throws {Error} If the connection fails during setup.
+ */
+export async function startStdioTransport(server, parentContext) {
+    const operationContext = {
+        ...parentContext,
+        operation: "connectStdioTransport",
+        transportType: "Stdio",
+    };
+    logOperationStart(operationContext, "Attempting to connect stdio transport...");
+    try {
+        logOperationStart(operationContext, "Creating StdioServerTransport instance...");
+        const transport = new StdioServerTransport();
+        logOperationStart(operationContext, "Connecting McpServer instance to StdioServerTransport...");
+        await server.connect(transport);
+        logOperationSuccess(operationContext, "MCP Server connected and listening via stdio transport.");
+        if (process.stdout.isTTY) {
+            console.log(`\n🚀 MCP Server running in STDIO mode.\n   (MCP Spec: ${MCP_SPEC_VERSION} Stdio Transport)\n`);
+        }
+    }
+    catch (err) {
+        // Let the ErrorHandler log the error with all context, then rethrow.
+        throw ErrorHandler.handleError(err, {
+            operation: "connectStdioTransport",
+            context: operationContext,
+            critical: true,
+            rethrow: true,
+        });
+    }
+}
+//# sourceMappingURL=stdioTransport.js.map

package/dist/mcp-server/transports/stdio/stdioTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdioTransport.js","sourceRoot":"","sources":["../../../../src/mcp-server/transports/stdio/stdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAkB,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAiB,EACjB,aAA6B;IAE7B,MAAM,gBAAgB,GAAG;QACvB,GAAG,aAAa;QAChB,SAAS,EAAE,uBAAuB;QAClC,aAAa,EAAE,OAAO;KACvB,CAAC;IACF,iBAAiB,CACf,gBAAgB,EAChB,0CAA0C,CAC3C,CAAC;IAEF,IAAI,CAAC;QACH,iBAAiB,CACf,gBAAgB,EAChB,2CAA2C,CAC5C,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,iBAAiB,CACf,gBAAgB,EAChB,0DAA0D,CAC3D,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,mBAAmB,CACjB,gBAAgB,EAChB,yDAAyD,CAC1D,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CACT,yDAAyD,gBAAgB,qBAAqB,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qEAAqE;QACrE,MAAM,YAAY,CAAC,WAAW,CAAC,GAAG,EAAE;YAClC,SAAS,EAAE,uBAAuB;YAClC,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/services/duck-db/duckDBConnectionManager.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Manages DuckDB instance and connection lifecycle.
+ * @module services/duck-db/duckDBConnectionManager
+ */
+import * as duckdb from "@duckdb/node-api";
+import { RequestContext } from "../../utils/index.js";
+import { DuckDBServiceConfig } from "./types.js";
+export declare class DuckDBConnectionManager {
+    private dbInstance;
+    private dbConnection;
+    private isInitialized;
+    private currentConfig;
+    /**
+     * Initializes the DuckDB instance and connection.
+     * @param {DuckDBServiceConfig} [config] - Configuration for the service.
+     * @returns {Promise<void>}
+     */
+    initialize(config?: DuckDBServiceConfig): Promise<void>;
+    /**
+     * Installs and loads a DuckDB extension.
+     * @param {string} extensionName - The name of the extension.
+     * @param {RequestContext} parentContext - The parent request context.
+     * @returns {Promise<void>}
+     */
+    loadExtension(extensionName: string, parentContext: RequestContext): Promise<void>;
+    /**
+     * Closes the DuckDB connection and instance.
+     * @returns {Promise<void>}
+     */
+    close(): Promise<void>;
+    /**
+     * Ensures that the service is initialized.
+     * @param {RequestContext} context - The request context for error reporting.
+     * @throws {McpError} If the service is not initialized.
+     */
+    ensureInitialized(context: RequestContext): void;
+    /**
+     * Gets the underlying DuckDB connection object.
+     * @returns {duckdb.DuckDBConnection}
+     * @throws {McpError} If the service is not initialized.
+     */
+    getConnection(): duckdb.DuckDBConnection;
+    /**
+     * Gets the underlying DuckDB instance object.
+     * @returns {duckdb.DuckDBInstance}
+     * @throws {McpError} If the service is not initialized.
+     */
+    getInstance(): duckdb.DuckDBInstance;
+    /**
+     * Checks if the service is currently initialized.
+     * @returns {boolean} True if initialized, false otherwise.
+     */
+    get isServiceInitialized(): boolean;
+}
+//# sourceMappingURL=duckDBConnectionManager.d.ts.map

package/dist/services/duck-db/duckDBConnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckDBConnectionManager.d.ts","sourceRoot":"","sources":["../../../src/services/duck-db/duckDBConnectionManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAGL,cAAc,EAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAoC;IAEzD;;;;OAIG;IACU,UAAU,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8FpE;;;;;OAKG;IACU,aAAa,CACxB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,IAAI,CAAC;IAgChB;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCnC;;;;OAIG;IACI,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAUvD;;;;OAIG;IACI,aAAa,IAAI,MAAM,CAAC,gBAAgB;IAQ/C;;;;OAIG;IACI,WAAW,IAAI,MAAM,CAAC,cAAc;IAQ3C;;;OAGG;IACH,IAAW,oBAAoB,IAAI,OAAO,CAEzC;CACF"}

package/dist/services/duck-db/duckDBConnectionManager.js

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Manages DuckDB instance and connection lifecycle.
+ * @module services/duck-db/duckDBConnectionManager
+ */
+import * as duckdb from "@duckdb/node-api";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService, } from "../../utils/index.js";
+const DEFAULT_DB_PATH = ":memory:";
+export class DuckDBConnectionManager {
+    dbInstance = null;
+    dbConnection = null;
+    isInitialized = false;
+    currentConfig = null;
+    /**
+     * Initializes the DuckDB instance and connection.
+     * @param {DuckDBServiceConfig} [config] - Configuration for the service.
+     * @returns {Promise<void>}
+     */
+    async initialize(config) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBConnectionManager.initialize",
+            initialData: config,
+        });
+        if (this.isInitialized) {
+            logger.warning(context, "DuckDBConnectionManager already initialized. Close first to re-initialize.");
+            // Potentially compare new config with old config if re-init with changes is desired
+            return;
+        }
+        this.currentConfig = config || {};
+        return ErrorHandler.tryCatch(async () => {
+            const dbPath = this.currentConfig?.dbPath || DEFAULT_DB_PATH;
+            const launchConfig = this.currentConfig?.launchConfig;
+            logger.info(context, `Initializing DuckDB instance with path: ${dbPath}`);
+            // Pass launchConfig directly to the create method
+            // The exact structure for launchConfig might need verification against @duckdb/node-api docs
+            // Assuming it takes an object similar to what's in DuckDBServiceConfig
+            this.dbInstance = await duckdb.DuckDBInstance.create(dbPath, launchConfig || {});
+            this.dbConnection = await this.dbInstance.connect();
+            logger.info(context, "DuckDB instance and connection created.");
+            // Set isInitialized to true now that core components are ready
+            this.isInitialized = true;
+            // If launchConfig was successfully passed to create(), this block might no longer be needed
+            // or might be adjusted for settings that *can* be applied post-connection.
+            // For now, let's comment it out to avoid the original error.
+            // if (launchConfig) {
+            //   for (const [key, value] of Object.entries(launchConfig)) {
+            //     // Ensure connection is available for run
+            //     if (!this.dbConnection) {
+            //       throw new McpError(
+            //         BaseErrorCode.INTERNAL_ERROR,
+            //         "Connection not available for applying launch config",
+            //         context,
+            //       );
+            //     }
+            //     await this.dbConnection.run(
+            //       `SET ${key}='${String(value).replace(/'/g, "''")}';`,
+            //     );
+            //   }
+            //   logger.info({
+            //     ...context,
+            //     launchConfig,
+            //   }, "Applied launch configuration via SET commands.");
+            // }
+            if (this.currentConfig?.extensions &&
+                this.currentConfig.extensions.length > 0) {
+                logger.info({
+                    ...context,
+                    extensions: this.currentConfig.extensions,
+                }, "Loading extensions...");
+                for (const extName of this.currentConfig.extensions) {
+                    await this.loadExtension(extName, context);
+                }
+            }
+            // this.isInitialized = true; // Moved earlier
+            logger.info(context, "DuckDBConnectionManager initialized successfully.");
+        }, {
+            operation: "DuckDBConnectionManager.initialize",
+            context,
+            input: config,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+    /**
+     * Installs and loads a DuckDB extension.
+     * @param {string} extensionName - The name of the extension.
+     * @param {RequestContext} parentContext - The parent request context.
+     * @returns {Promise<void>}
+     */
+    async loadExtension(extensionName, parentContext) {
+        this.ensureInitialized(parentContext);
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBConnectionManager.loadExtension",
+            initialData: { extensionName },
+            parentContext,
+        });
+        return ErrorHandler.tryCatch(async () => {
+            logger.info(context, `Installing extension: ${extensionName}`);
+            await this.dbConnection.run(`INSTALL '${extensionName.replace(/'/g, "''")}'`);
+            logger.info(context, `Loading extension: ${extensionName}`);
+            await this.dbConnection.run(`LOAD '${extensionName.replace(/'/g, "''")}'`);
+            logger.info(context, `Extension ${extensionName} installed and loaded.`);
+        }, {
+            operation: "DuckDBConnectionManager.loadExtension",
+            context,
+            input: { extensionName },
+            errorCode: JsonRpcErrorCode.InternalError,
+        });
+    }
+    /**
+     * Closes the DuckDB connection and instance.
+     * @returns {Promise<void>}
+     */
+    async close() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBConnectionManager.close",
+        });
+        if (!this.isInitialized) {
+            logger.warning(context, "DuckDBConnectionManager not initialized, nothing to close.");
+            return;
+        }
+        return ErrorHandler.tryCatch(async () => {
+            if (this.dbConnection) {
+                this.dbConnection.closeSync(); // Use synchronous closeSync
+                this.dbConnection = null;
+                logger.info(context, "DuckDB connection closed.");
+            }
+            if (this.dbInstance) {
+                this.dbInstance.closeSync(); // Use synchronous closeSync
+                this.dbInstance = null;
+                logger.info(context, "DuckDB instance closed.");
+            }
+            this.isInitialized = false;
+            this.currentConfig = null;
+            logger.info(context, "DuckDBConnectionManager closed successfully.");
+        }, {
+            operation: "DuckDBConnectionManager.close",
+            context,
+            errorCode: JsonRpcErrorCode.InternalError,
+        });
+    }
+    /**
+     * Ensures that the service is initialized.
+     * @param {RequestContext} context - The request context for error reporting.
+     * @throws {McpError} If the service is not initialized.
+     */
+    ensureInitialized(context) {
+        if (!this.isInitialized || !this.dbConnection || !this.dbInstance) {
+            throw new McpError(JsonRpcErrorCode.ServiceUnavailable, "DuckDBConnectionManager is not initialized. Call initialize() first.", context);
+        }
+    }
+    /**
+     * Gets the underlying DuckDB connection object.
+     * @returns {duckdb.DuckDBConnection}
+     * @throws {McpError} If the service is not initialized.
+     */
+    getConnection() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBConnectionManager.getConnection",
+        });
+        this.ensureInitialized(context);
+        return this.dbConnection;
+    }
+    /**
+     * Gets the underlying DuckDB instance object.
+     * @returns {duckdb.DuckDBInstance}
+     * @throws {McpError} If the service is not initialized.
+     */
+    getInstance() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBConnectionManager.getInstance",
+        });
+        this.ensureInitialized(context);
+        return this.dbInstance;
+    }
+    /**
+     * Checks if the service is currently initialized.
+     * @returns {boolean} True if initialized, false otherwise.
+     */
+    get isServiceInitialized() {
+        return this.isInitialized;
+    }
+}
+//# sourceMappingURL=duckDBConnectionManager.js.map

package/dist/services/duck-db/duckDBConnectionManager.js.map

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

package/dist/services/duck-db/duckDBQueryExecutor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Executes SQL queries and manages transactions for DuckDB.
+ * @module services/duck-db/duckDBQueryExecutor
+ */
+import * as duckdb from "@duckdb/node-api";
+import { DuckDBQueryResult } from "./types.js";
+export declare class DuckDBQueryExecutor {
+    private dbConnection;
+    constructor(connection: duckdb.DuckDBConnection);
+    run(sql: string, params?: duckdb.DuckDBValue[]): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, params?: duckdb.DuckDBValue[]): Promise<DuckDBQueryResult<T>>;
+    stream(sql: string, params?: duckdb.DuckDBValue[]): Promise<duckdb.DuckDBResult>;
+    prepare(sql: string): Promise<duckdb.DuckDBPreparedStatement>;
+    beginTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+}
+//# sourceMappingURL=duckDBQueryExecutor.d.ts.map

package/dist/services/duck-db/duckDBQueryExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckDBQueryExecutor.d.ts","sourceRoot":"","sources":["../../../src/services/duck-db/duckDBQueryExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAG3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAA0B;gBAElC,UAAU,EAAE,MAAM,CAAC,gBAAgB;IAIlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB9D,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAoCnB,MAAM,CACjB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IAwBlB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAoB7D,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;CAOlD"}

package/dist/services/duck-db/duckDBQueryExecutor.js

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview Executes SQL queries and manages transactions for DuckDB.
+ * @module services/duck-db/duckDBQueryExecutor
+ */
+import { JsonRpcErrorCode } from "../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService } from "../../utils/index.js";
+export class DuckDBQueryExecutor {
+    dbConnection;
+    constructor(connection) {
+        this.dbConnection = connection;
+    }
+    async run(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.run",
+            initialData: { sql, params },
+        });
+        return ErrorHandler.tryCatch(async () => {
+            logger.debug({ ...context, params }, `Executing SQL (run): ${sql}`);
+            if (params === undefined) {
+                await this.dbConnection.run(sql);
+            }
+            else {
+                await this.dbConnection.run(sql, params);
+            }
+        }, {
+            operation: "DuckDBQueryExecutor.run",
+            context,
+            input: { sql, params },
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    async query(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.query",
+            initialData: { sql, params },
+        });
+        return ErrorHandler.tryCatch(async () => {
+            logger.debug({ ...context, params }, `Executing SQL (query): ${sql}`);
+            const resultObject = await this.stream(sql, params);
+            const rows = (await resultObject.getRows());
+            const columnNames = resultObject.columnNames();
+            const columnTypes = resultObject
+                .columnTypes()
+                .map((ct) => ct.typeId);
+            return {
+                rows: rows,
+                columnNames: columnNames,
+                columnTypes: columnTypes,
+                rowCount: rows.length,
+            };
+        }, {
+            operation: "DuckDBQueryExecutor.query",
+            context,
+            input: { sql, params },
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    async stream(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.stream",
+            initialData: { sql, params },
+        });
+        return ErrorHandler.tryCatch(async () => {
+            logger.debug({ ...context, params }, `Executing SQL (stream): ${sql}`);
+            if (params === undefined) {
+                return this.dbConnection.stream(sql);
+            }
+            else {
+                return this.dbConnection.stream(sql, params);
+            }
+        }, {
+            operation: "DuckDBQueryExecutor.stream",
+            context,
+            input: { sql, params },
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    async prepare(sql) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.prepare",
+            initialData: { sql },
+        });
+        return ErrorHandler.tryCatch(async () => {
+            logger.debug(context, `Preparing SQL: ${sql}`);
+            return this.dbConnection.prepare(sql);
+        }, {
+            operation: "DuckDBQueryExecutor.prepare",
+            context,
+            input: { sql },
+            errorCode: JsonRpcErrorCode.DatabaseError,
+        });
+    }
+    async beginTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.beginTransaction",
+        });
+        await this.run("BEGIN TRANSACTION");
+        logger.info(context, "Transaction started.");
+    }
+    async commitTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.commitTransaction",
+        });
+        await this.run("COMMIT");
+        logger.info(context, "Transaction committed.");
+    }
+    async rollbackTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBQueryExecutor.rollbackTransaction",
+        });
+        await this.run("ROLLBACK");
+        logger.info(context, "Transaction rolled back.");
+    }
+}
+//# sourceMappingURL=duckDBQueryExecutor.js.map

package/dist/services/duck-db/duckDBQueryExecutor.js.map

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

package/dist/services/duck-db/duckDBService.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Implements the DuckDB service for interacting with a DuckDB database.
+ * @module services/duck-db/duckDBService
+ */
+import * as duckdb from "@duckdb/node-api";
+import { DuckDBQueryResult, DuckDBServiceConfig, IDuckDBService } from "./types.js";
+export declare class DuckDBService implements IDuckDBService {
+    private connectionManager;
+    private queryExecutor;
+    private isInitialized;
+    constructor();
+    initialize(config?: DuckDBServiceConfig): Promise<void>;
+    private ensureInitialized;
+    private validateParams;
+    run(sql: string, params?: unknown[]): Promise<void>;
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<DuckDBQueryResult<T>>;
+    stream(sql: string, params?: unknown[]): Promise<duckdb.DuckDBResult>;
+    prepare(sql: string): Promise<duckdb.DuckDBPreparedStatement>;
+    beginTransaction(): Promise<void>;
+    commitTransaction(): Promise<void>;
+    rollbackTransaction(): Promise<void>;
+    loadExtension(extensionName: string): Promise<void>;
+    close(): Promise<void>;
+    getRawConnection(): duckdb.DuckDBConnection | null;
+    getRawInstance(): duckdb.DuckDBInstance | null;
+}
+//# sourceMappingURL=duckDBService.d.ts.map

package/dist/services/duck-db/duckDBService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckDBService.d.ts","sourceRoot":"","sources":["../../../src/services/duck-db/duckDBService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAU3C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,aAAa,CAAS;;IAMxB,UAAU,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC7D,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,cAAc;IAiBhB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAU1B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;IAUrE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC;IAS7D,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQlC,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,GAAG,IAAI;IAOlD,cAAc,IAAI,MAAM,CAAC,cAAc,GAAG,IAAI;CAM/C"}