@ibm/ibmi-mcp-server 0.1.0

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

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview Implements the DuckDB service for interacting with a DuckDB database.
+ * @module services/duck-db/duckDBService
+ */
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService, } from "../../utils/index.js";
+import { DuckDBConnectionManager } from "./duckDBConnectionManager.js";
+import { DuckDBQueryExecutor } from "./duckDBQueryExecutor.js";
+export class DuckDBService {
+    connectionManager;
+    queryExecutor = null;
+    isInitialized = false;
+    constructor() {
+        this.connectionManager = new DuckDBConnectionManager();
+    }
+    async initialize(config) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.initialize",
+            initialData: config,
+        });
+        if (this.isInitialized) {
+            logger.warning(context, "DuckDBService already initialized. Close first to re-initialize.");
+            return;
+        }
+        return ErrorHandler.tryCatch(async () => {
+            await this.connectionManager.initialize(config);
+            const connection = this.connectionManager.getConnection();
+            this.queryExecutor = new DuckDBQueryExecutor(connection);
+            this.isInitialized = true;
+            logger.info(context, "DuckDBService initialized successfully.");
+        }, {
+            operation: "DuckDBService.initialize",
+            context,
+            input: config,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+    ensureInitialized(context) {
+        this.connectionManager.ensureInitialized(context); // Delegate to manager
+        if (!this.queryExecutor) {
+            // This check is mostly for type safety, as connectionManager.ensureInitialized should cover it
+            throw new McpError(JsonRpcErrorCode.ServiceUnavailable, "DuckDBQueryExecutor not available. DuckDBService may not be fully initialized.", context);
+        }
+    }
+    validateParams(params, context) {
+        if (params === undefined) {
+            return undefined;
+        }
+        if (Array.isArray(params)) {
+            return params;
+        }
+        throw new McpError(JsonRpcErrorCode.InvalidParams, "DuckDB service only supports array-style parameters, not named objects.", context);
+    }
+    async run(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.run",
+            initialData: { sql, params },
+        });
+        this.ensureInitialized(context);
+        const validatedParams = this.validateParams(params, context);
+        return this.queryExecutor.run(sql, validatedParams);
+    }
+    async query(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.query",
+            initialData: { sql, params },
+        });
+        this.ensureInitialized(context);
+        const validatedParams = this.validateParams(params, context);
+        return this.queryExecutor.query(sql, validatedParams);
+    }
+    async stream(sql, params) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.stream",
+            initialData: { sql, params },
+        });
+        this.ensureInitialized(context);
+        const validatedParams = this.validateParams(params, context);
+        return this.queryExecutor.stream(sql, validatedParams);
+    }
+    async prepare(sql) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.prepare",
+            initialData: { sql },
+        });
+        this.ensureInitialized(context);
+        return this.queryExecutor.prepare(sql);
+    }
+    async beginTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.beginTransaction",
+        });
+        this.ensureInitialized(context);
+        return this.queryExecutor.beginTransaction();
+    }
+    async commitTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.commitTransaction",
+        });
+        this.ensureInitialized(context);
+        return this.queryExecutor.commitTransaction();
+    }
+    async rollbackTransaction() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.rollbackTransaction",
+        });
+        this.ensureInitialized(context);
+        return this.queryExecutor.rollbackTransaction();
+    }
+    async loadExtension(extensionName) {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.loadExtension",
+            initialData: { extensionName },
+        });
+        // ensureInitialized is implicitly called by connectionManager.loadExtension
+        // if we call ensureInitialized here, it uses the service's context,
+        // but loadExtension in manager will create its own.
+        // It's better to let the manager handle its own initialization checks.
+        return this.connectionManager.loadExtension(extensionName, context);
+    }
+    async close() {
+        const context = requestContextService.createRequestContext({
+            operation: "DuckDBService.close",
+        });
+        // No need to check this.isInitialized here, connectionManager.close() handles it.
+        return ErrorHandler.tryCatch(async () => {
+            await this.connectionManager.close();
+            this.queryExecutor = null;
+            this.isInitialized = false;
+            logger.info(context, "DuckDBService closed successfully.");
+        }, {
+            operation: "DuckDBService.close",
+            context,
+            errorCode: JsonRpcErrorCode.InternalError,
+        });
+    }
+    getRawConnection() {
+        if (this.connectionManager.isServiceInitialized) {
+            return this.connectionManager.getConnection();
+        }
+        return null;
+    }
+    getRawInstance() {
+        if (this.connectionManager.isServiceInitialized) {
+            return this.connectionManager.getInstance();
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=duckDBService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckDBService.js","sourceRoot":"","sources":["../../../src/services/duck-db/duckDBService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,MAAM,EAEN,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO/D,MAAM,OAAO,aAAa;IAChB,iBAAiB,CAA0B;IAC3C,aAAa,GAA+B,IAAI,CAAC;IACjD,aAAa,GAAG,KAAK,CAAC;IAE9B;QACE,IAAI,CAAC,iBAAiB,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAA4B;QAC3C,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,0BAA0B;YACrC,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CACZ,OAAO,EACP,kEAAkE,CACnE,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,YAAY,CAAC,QAAQ,CAC1B,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;YAC1D,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,yCAAyC,CAAC,CAAC;QAClE,CAAC,EACD;YACE,SAAS,EAAE,0BAA0B;YACrC,OAAO;YACP,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,gBAAgB,CAAC,oBAAoB;YAChD,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;IACJ,CAAC;IAEO,iBAAiB,CAAC,OAAuB;QAC/C,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB;QACzE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,+FAA+F;YAC/F,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,kBAAkB,EACnC,gFAAgF,EAChF,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,cAAc,CACpB,MAAe,EACf,OAAuB;QAEvB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAA8B,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,yEAAyE,EACzE,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,MAAkB;QACvC,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,mBAAmB;YAC9B,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,aAAc,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAkB;QAElB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,qBAAqB;YAChC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,aAAc,CAAC,KAAK,CAAI,GAAG,EAAE,eAAe,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,MAAkB;QAC1C,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,sBAAsB;YACjC,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,aAAc,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAW;QACvB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,uBAAuB;YAClC,WAAW,EAAE,EAAE,GAAG,EAAE;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,gCAAgC;SAC5C,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAc,CAAC,gBAAgB,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,iCAAiC;SAC7C,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAc,CAAC,iBAAiB,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,mCAAmC;SAC/C,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,aAAc,CAAC,mBAAmB,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,aAAqB;QACvC,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,6BAA6B;YACxC,WAAW,EAAE,EAAE,aAAa,EAAE;SAC/B,CAAC,CAAC;QACH,4EAA4E;QAC5E,oEAAoE;QACpE,oDAAoD;QACpD,uEAAuE;QACvE,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,qBAAqB;SACjC,CAAC,CAAC;QAEH,kFAAkF;QAClF,OAAO,YAAY,CAAC,QAAQ,CAC1B,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,oCAAoC,CAAC,CAAC;QAC7D,CAAC,EACD;YACE,SAAS,EAAE,qBAAqB;YAChC,OAAO;YACP,SAAS,EAAE,gBAAgB,CAAC,aAAa;SAC1C,CACF,CAAC;IACJ,CAAC;IAED,gBAAgB;QACd,IAAI,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Defines types and interfaces for the DuckDB service.
+ * @module services/duck-db/types
+ */
+import * as duckdb from "@duckdb/node-api";
+/**
+ * Configuration options for initializing the DuckDB service.
+ */
+export interface DuckDBServiceConfig {
+    /**
+     * The path to the database file.
+     * Use ':memory:' for an in-memory database.
+     * If undefined, defaults to an in-memory database.
+     */
+    dbPath?: string;
+    /**
+     * Optional DuckDB launch configurations.
+     * Refer to DuckDB documentation for available options.
+     * Example: { allow_unsigned_extensions: 'true' }
+     */
+    launchConfig?: Record<string, string>;
+    /**
+     * List of extensions to install and load upon initialization.
+     * Example: ['httpfs', 'json']
+     */
+    extensions?: string[];
+}
+/**
+ * Represents a query to be executed.
+ */
+export interface DuckDBQuery {
+    sql: string;
+    params?: unknown[];
+}
+/**
+ * Represents the result of a query execution.
+ */
+export interface DuckDBQueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    columnNames: string[];
+    columnTypes: duckdb.DuckDBTypeId[];
+    rowCount: number;
+}
+/**
+ * Interface for the DuckDB service.
+ */
+export interface IDuckDBService {
+    /**
+     * Initializes the DuckDB service with the given configuration.
+     * Must be called before any other operations.
+     * @param {DuckDBServiceConfig} config - The configuration for the DuckDB service.
+     * @returns {Promise<void>}
+     * @throws {McpError} If initialization fails.
+     */
+    initialize(config?: DuckDBServiceConfig): Promise<void>;
+    /**
+     * Executes a SQL query that does not return a large result set (e.g., CREATE, INSERT, UPDATE, DELETE).
+     * @param {string} sql - The SQL query string.
+     * @param {unknown[]} [params] - Optional parameters for the query.
+     * @returns {Promise<void>}
+     * @throws {McpError} If the query fails or the service is not initialized.
+     */
+    run(sql: string, params?: unknown[]): Promise<void>;
+    /**
+     * Executes a SQL query and returns all resulting rows.
+     * Suitable for queries that return a manageable number of rows.
+     * @template T - The expected type of the row objects.
+     * @param {string} sql - The SQL query string.
+     * @param {unknown[]} [params] - Optional parameters for the query.
+     * @returns {Promise<DuckDBQueryResult<T>>} The query result.
+     * @throws {McpError} If the query fails or the service is not initialized.
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: unknown[]): Promise<DuckDBQueryResult<T>>;
+    /**
+     * Executes a SQL query and provides a streaming result reader.
+     * Suitable for queries that return very large result sets.
+     * The caller is responsible for closing the stream.
+     * @param {string} sql - The SQL query string.
+     * @param {unknown[]} [params] - Optional parameters for the query.
+     * @returns {Promise<duckdb.DuckDBStreamingResult>} A streaming result object.
+     * @throws {McpError} If the query fails or the service is not initialized.
+     */
+    stream(sql: string, params?: unknown[]): Promise<duckdb.DuckDBResult>;
+    /**
+     * Creates a prepared statement.
+     * @param {string} sql - The SQL query string for the prepared statement.
+     * @returns {Promise<duckdb.DuckDBPreparedStatement>} The prepared statement object.
+     * @throws {McpError} If preparing the statement fails or the service is not initialized.
+     */
+    prepare(sql: string): Promise<duckdb.DuckDBPreparedStatement>;
+    /**
+     * Begins a new transaction.
+     * @returns {Promise<void>}
+     * @throws {McpError} If starting the transaction fails or the service is not initialized.
+     */
+    beginTransaction(): Promise<void>;
+    /**
+     * Commits the current transaction.
+     * @returns {Promise<void>}
+     * @throws {McpError} If committing the transaction fails or the service is not initialized.
+     */
+    commitTransaction(): Promise<void>;
+    /**
+     * Rolls back the current transaction.
+     * @returns {Promise<void>}
+     * @throws {McpError} If rolling back the transaction fails or the service is not initialized.
+     */
+    rollbackTransaction(): Promise<void>;
+    /**
+     * Installs and loads a DuckDB extension.
+     * @param {string} extensionName - The name of the extension to install and load.
+     * @returns {Promise<void>}
+     * @throws {McpError} If installing or loading the extension fails or the service is not initialized.
+     */
+    loadExtension(extensionName: string): Promise<void>;
+    /**
+     * Closes the DuckDB connection and instance.
+     * @returns {Promise<void>}
+     * @throws {McpError} If closing fails.
+     */
+    close(): Promise<void>;
+    /**
+     * Gets the underlying DuckDB connection object.
+     * Use with caution, primarily for advanced scenarios not covered by the service interface.
+     * @returns {duckdb.DuckDBConnection | null} The connection object, or null if not initialized.
+     */
+    getRawConnection(): duckdb.DuckDBConnection | null;
+    /**
+     * Gets the underlying DuckDB instance object.
+     * Use with caution, primarily for advanced scenarios not covered by the service interface.
+     * @returns {duckdb.DuckDBInstance | null} The instance object, or null if not initialized.
+     */
+    getRawInstance(): duckdb.DuckDBInstance | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/duck-db/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;OAQG;IACH,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC;;;;;;;;OAQG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAE9D;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;OAKG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;CAChD"}

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Defines types and interfaces for the DuckDB service.
+ * @module services/duck-db/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/duck-db/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/llm-providers/openRouterProvider.d.ts

@@ -0,0 +1,36 @@
+import { ChatCompletion, ChatCompletionChunk, ChatCompletionCreateParamsNonStreaming, ChatCompletionCreateParamsStreaming } from "openai/resources/chat/completions";
+import { Stream } from "openai/streaming";
+import { RequestContext } from "../../utils/internal/requestContext.js";
+/**
+ * Options for configuring the OpenRouter client.
+ */
+export interface OpenRouterClientOptions {
+    apiKey?: string;
+    baseURL?: string;
+    siteUrl?: string;
+    siteName?: string;
+}
+/**
+ * Defines the parameters for an OpenRouter chat completion request.
+ */
+export type OpenRouterChatParams = (ChatCompletionCreateParamsNonStreaming | ChatCompletionCreateParamsStreaming) & {
+    top_k?: number;
+    min_p?: number;
+    transforms?: string[];
+    models?: string[];
+    route?: "fallback";
+    provider?: Record<string, unknown>;
+};
+declare class OpenRouterProvider {
+    private client?;
+    status: "unconfigured" | "initializing" | "ready" | "error";
+    private initializationError;
+    constructor();
+    initialize(options?: OpenRouterClientOptions): void;
+    private checkReady;
+    chatCompletion(params: OpenRouterChatParams, context: RequestContext): Promise<ChatCompletion | Stream<ChatCompletionChunk>>;
+    chatCompletionStream(params: OpenRouterChatParams, context: RequestContext): Promise<AsyncIterable<ChatCompletionChunk>>;
+}
+declare const openRouterProviderInstance: OpenRouterProvider;
+export { openRouterProviderInstance as openRouterProvider, OpenRouterProvider };
+//# sourceMappingURL=openRouterProvider.d.ts.map

package/dist/services/llm-providers/openRouterProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openRouterProvider.d.ts","sourceRoot":"","sources":["../../../src/services/llm-providers/openRouterProvider.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,sCAAsC,EACtC,mCAAmC,EACpC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAK1C,OAAO,EACL,cAAc,EAEf,MAAM,oCAAoC,CAAC;AAO5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAC/B,sCAAsC,GACtC,mCAAmC,CACtC,GAAG;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AA+KF,cAAM,kBAAkB;IACtB,OAAO,CAAC,MAAM,CAAC,CAAS;IACjB,MAAM,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;IACnE,OAAO,CAAC,mBAAmB,CAAsB;;IAM1C,UAAU,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI;IAkD1D,OAAO,CAAC,UAAU;IAgBL,cAAc,CACzB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAmB3C,oBAAoB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAuB/C;AAED,QAAA,MAAM,0BAA0B,oBAA2B,CAAC;AAE5D,OAAO,EAAE,0BAA0B,IAAI,kBAAkB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/services/llm-providers/openRouterProvider.js

@@ -0,0 +1,235 @@
+/**
+ * @fileoverview Provides a service class (`OpenRouterProvider`) for interacting with the
+ * OpenRouter API. This file implements the "handler" pattern internally, where the
+ * OpenRouterProvider class manages state and error handling, while private logic functions
+ * execute the core API interactions and throw structured errors.
+ * @module src/services/llm-providers/openRouterProvider
+ */
+import OpenAI from "openai";
+import { config } from "../../config/index.js";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { ErrorHandler } from "../../utils/internal/errorHandler.js";
+import { logger } from "../../utils/internal/logger.js";
+import { requestContextService, } from "../../utils/internal/requestContext.js";
+import { rateLimiter } from "../../utils/security/rateLimiter.js";
+import { sanitization } from "../../utils/security/sanitization.js";
+// #region Internal Logic Functions (Throwing Errors)
+/**
+ * Prepares parameters for the OpenRouter API call, separating standard
+ * and extra parameters and applying defaults.
+ * @internal
+ */
+function _prepareApiParameters(params) {
+    const effectiveModelId = params.model || config.llmDefaultModel;
+    const standardParams = {
+        model: effectiveModelId,
+        messages: params.messages,
+        ...(params.temperature !== undefined ||
+            config.llmDefaultTemperature !== undefined
+            ? { temperature: params.temperature ?? config.llmDefaultTemperature }
+            : {}),
+        ...(params.top_p !== undefined || config.llmDefaultTopP !== undefined
+            ? { top_p: params.top_p ?? config.llmDefaultTopP }
+            : {}),
+        ...(params.presence_penalty !== undefined
+            ? { presence_penalty: params.presence_penalty }
+            : {}),
+        ...(params.stream !== undefined && { stream: params.stream }),
+        ...(params.tools !== undefined && { tools: params.tools }),
+        ...(params.tool_choice !== undefined && {
+            tool_choice: params.tool_choice,
+        }),
+        ...(params.response_format !== undefined && {
+            response_format: params.response_format,
+        }),
+        ...(params.stop !== undefined && { stop: params.stop }),
+        ...(params.seed !== undefined && { seed: params.seed }),
+        ...(params.frequency_penalty !== undefined
+            ? { frequency_penalty: params.frequency_penalty }
+            : {}),
+        ...(params.logit_bias !== undefined && { logit_bias: params.logit_bias }),
+    };
+    const extraBody = {};
+    const standardKeys = new Set(Object.keys(standardParams));
+    standardKeys.add("messages");
+    for (const key in params) {
+        if (Object.prototype.hasOwnProperty.call(params, key) &&
+            !standardKeys.has(key) &&
+            key !== "max_tokens") {
+            extraBody[key] = params[key];
+        }
+    }
+    if (extraBody.top_k === undefined && config.llmDefaultTopK !== undefined) {
+        extraBody.top_k = config.llmDefaultTopK;
+    }
+    if (extraBody.min_p === undefined && config.llmDefaultMinP !== undefined) {
+        extraBody.min_p = config.llmDefaultMinP;
+    }
+    if (extraBody.provider &&
+        typeof extraBody.provider === "object" &&
+        extraBody.provider !== null) {
+        const provider = extraBody.provider;
+        if (!provider.sort) {
+            provider.sort = "throughput";
+        }
+    }
+    else if (extraBody.provider === undefined) {
+        extraBody.provider = { sort: "throughput" };
+    }
+    const modelsRequiringMaxCompletionTokens = ["openai/o1", "openai/gpt-4.1"];
+    const needsMaxCompletionTokens = modelsRequiringMaxCompletionTokens.some((modelPrefix) => effectiveModelId.startsWith(modelPrefix));
+    const effectiveMaxTokensValue = params.max_tokens ?? config.llmDefaultMaxTokens;
+    if (effectiveMaxTokensValue !== undefined) {
+        if (needsMaxCompletionTokens) {
+            extraBody.max_completion_tokens = effectiveMaxTokensValue;
+        }
+        else {
+            standardParams.max_tokens = effectiveMaxTokensValue;
+        }
+    }
+    return { standardParams, extraBody };
+}
+async function _openRouterChatCompletionLogic(client, params, context) {
+    const isStreaming = params.stream === true;
+    const { standardParams, extraBody } = _prepareApiParameters(params);
+    const apiParams = { ...standardParams };
+    if (Object.keys(extraBody).length > 0) {
+        apiParams.extra_body = extraBody;
+    }
+    logger.logInteraction("OpenRouterRequest", {
+        context,
+        request: apiParams,
+    });
+    try {
+        if (isStreaming) {
+            return await client.chat.completions.create(apiParams);
+        }
+        const response = await client.chat.completions.create(apiParams);
+        logger.logInteraction("OpenRouterResponse", {
+            context,
+            response,
+            streaming: false,
+        });
+        return response;
+    }
+    catch (e) {
+        const error = e;
+        logger.logInteraction("OpenRouterError", {
+            context,
+            error: {
+                message: error.message,
+                stack: error.stack,
+                status: error.status,
+                cause: error.cause,
+            },
+        });
+        const errorDetails = {
+            providerStatus: error.status,
+            providerMessage: error.message,
+            cause: error?.cause,
+        };
+        if (error.status === 401) {
+            throw new McpError(JsonRpcErrorCode.Unauthorized, `OpenRouter authentication failed: ${error.message}`, errorDetails);
+        }
+        else if (error.status === 429) {
+            throw new McpError(JsonRpcErrorCode.RateLimited, `OpenRouter rate limit exceeded: ${error.message}`, errorDetails);
+        }
+        else if (error.status === 402) {
+            throw new McpError(JsonRpcErrorCode.Forbidden, `OpenRouter insufficient credits or payment required: ${error.message}`, errorDetails);
+        }
+        throw new McpError(JsonRpcErrorCode.InternalError, `OpenRouter API error (${error.status || "unknown status"}): ${error.message}`, errorDetails);
+    }
+}
+class OpenRouterProvider {
+    client;
+    status;
+    initializationError = null;
+    constructor() {
+        this.status = "unconfigured";
+    }
+    initialize(options) {
+        const opContext = requestContextService.createRequestContext({
+            operation: "OpenRouterProvider.initialize",
+        });
+        this.status = "initializing";
+        const apiKey = options?.apiKey !== undefined ? options.apiKey : config.openrouterApiKey;
+        if (!apiKey) {
+            this.status = "unconfigured";
+            this.initializationError = new McpError(JsonRpcErrorCode.ConfigurationError, "OpenRouter API key is not configured.");
+            logger.error({
+                ...opContext,
+                error: this.initializationError,
+            }, this.initializationError.message);
+            return;
+        }
+        try {
+            this.client = new OpenAI({
+                baseURL: options?.baseURL || "https://openrouter.ai/api/v1",
+                apiKey,
+                defaultHeaders: {
+                    "HTTP-Referer": options?.siteUrl || config.openrouterAppUrl,
+                    "X-Title": options?.siteName || config.openrouterAppName,
+                },
+                maxRetries: 0,
+            });
+            this.status = "ready";
+            logger.info(opContext, "OpenRouter Service Initialized and Ready");
+        }
+        catch (e) {
+            const error = e;
+            this.status = "error";
+            this.initializationError = error;
+            logger.error({
+                ...opContext,
+                error,
+            }, "Failed to initialize OpenRouter client");
+        }
+    }
+    checkReady(operation, context) {
+        if (this.status !== "ready" || !this.client) {
+            const message = `OpenRouter service is not available (status: ${this.status}).`;
+            logger.error({
+                ...context,
+                status: this.status,
+            }, `[${operation}] ${message}`);
+            throw new McpError(JsonRpcErrorCode.ServiceUnavailable, message, {
+                cause: this.initializationError,
+            });
+        }
+    }
+    async chatCompletion(params, context) {
+        const operation = "OpenRouterProvider.chatCompletion";
+        const sanitizedParams = sanitization.sanitizeForLogging(params);
+        return await ErrorHandler.tryCatch(async () => {
+            this.checkReady(operation, context);
+            const rateLimitKey = context.requestId || "openrouter_default_key";
+            rateLimiter.check(rateLimitKey, context);
+            return await _openRouterChatCompletionLogic(this.client, params, context);
+        }, { operation, context, input: sanitizedParams });
+    }
+    async chatCompletionStream(params, context) {
+        const streamParams = { ...params, stream: true };
+        const response = await this.chatCompletion(streamParams, context);
+        const responseStream = response;
+        async function* loggingStream() {
+            const chunks = [];
+            try {
+                for await (const chunk of responseStream) {
+                    chunks.push(chunk);
+                    yield chunk;
+                }
+            }
+            finally {
+                logger.logInteraction("OpenRouterResponse", {
+                    context,
+                    response: chunks,
+                    streaming: true,
+                });
+            }
+        }
+        return loggingStream();
+    }
+}
+const openRouterProviderInstance = new OpenRouterProvider();
+export { openRouterProviderInstance as openRouterProvider, OpenRouterProvider };
+//# sourceMappingURL=openRouterProvider.js.map

package/dist/services/llm-providers/openRouterProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openRouterProvider.js","sourceRoot":"","sources":["../../../src/services/llm-providers/openRouterProvider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAQ5B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAEL,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AA8BhE,qDAAqD;AAErD;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,MAA4B;IACzD,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,eAAe,CAAC;IAEhE,MAAM,cAAc,GAEhB;QACF,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;YACpC,MAAM,CAAC,qBAAqB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,qBAAqB,EAAE;YACrE,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS;YACnE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,cAAc,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,gBAAgB,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI;YACtC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI;YAC1C,eAAe,EAAE,MAAM,CAAC,eAAe;SACxC,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IAEF,MAAM,SAAS,GAA4B,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1D,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IACE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YACjD,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;YACtB,GAAG,KAAK,YAAY,EACpB,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,GAAI,MAA6C,CAAC,GAAG,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzE,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;IAC1C,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACzE,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;IAC1C,CAAC;IACD,IACE,SAAS,CAAC,QAAQ;QAClB,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ;QACtC,SAAS,CAAC,QAAQ,KAAK,IAAI,EAC3B,CAAC;QACD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAmC,CAAC;QAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC;QAC/B,CAAC;IACH,CAAC;SAAM,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5C,SAAS,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,kCAAkC,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC3E,MAAM,wBAAwB,GAAG,kCAAkC,CAAC,IAAI,CACtE,CAAC,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,CAC1D,CAAC;IACF,MAAM,uBAAuB,GAC3B,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,mBAAmB,CAAC;IAElD,IAAI,uBAAuB,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,wBAAwB,EAAE,CAAC;YAC7B,SAAS,CAAC,qBAAqB,GAAG,uBAAuB,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,UAAU,GAAG,uBAAuB,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,8BAA8B,CAC3C,MAAc,EACd,MAA4B,EAC5B,OAAuB;IAEvB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;IAE3C,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,SAAqC,CAAC,UAAU,GAAG,SAAS,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,mBAAmB,EAAE;QACzC,OAAO;QACP,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACzC,SAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACnD,SAA8D,CAC/D,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE;YAC1C,OAAO;YACP,QAAQ;YACR,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,CAAiD,CAAC;QAChE,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE;YACvC,OAAO;YACP,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB;SACF,CAAC,CAAC;QACH,MAAM,YAAY,GAAG;YACnB,cAAc,EAAE,KAAK,CAAC,MAAM;YAC5B,eAAe,EAAE,KAAK,CAAC,OAAO;YAC9B,KAAK,EAAE,KAAK,EAAE,KAAK;SACpB,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACzB,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,YAAY,EAC7B,qCAAqC,KAAK,CAAC,OAAO,EAAE,EACpD,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,WAAW,EAC5B,mCAAmC,KAAK,CAAC,OAAO,EAAE,EAClD,YAAY,CACb,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAChC,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,SAAS,EAC1B,wDAAwD,KAAK,CAAC,OAAO,EAAE,EACvE,YAAY,CACb,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,aAAa,EAC9B,yBAAyB,KAAK,CAAC,MAAM,IAAI,gBAAgB,MACvD,KAAK,CAAC,OACR,EAAE,EACF,YAAY,CACb,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB;IACd,MAAM,CAAU;IACjB,MAAM,CAAsD;IAC3D,mBAAmB,GAAiB,IAAI,CAAC;IAEjD;QACE,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;IAC/B,CAAC;IAEM,UAAU,CAAC,OAAiC;QACjD,MAAM,SAAS,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YAC3D,SAAS,EAAE,+BAA+B;SAC3C,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;QAE7B,MAAM,MAAM,GACV,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;YAC7B,IAAI,CAAC,mBAAmB,GAAG,IAAI,QAAQ,CACrC,gBAAgB,CAAC,kBAAkB,EACnC,uCAAuC,CACxC,CAAC;YACF,MAAM,CAAC,KAAK,CACV;gBACE,GAAG,SAAS;gBACZ,KAAK,EAAE,IAAI,CAAC,mBAAmB;aAChC,EACD,IAAI,CAAC,mBAAmB,CAAC,OAAO,CACjC,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;gBACvB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,8BAA8B;gBAC3D,MAAM;gBACN,cAAc,EAAE;oBACd,cAAc,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,gBAAgB;oBAC3D,SAAS,EAAE,OAAO,EAAE,QAAQ,IAAI,MAAM,CAAC,iBAAiB;iBACzD;gBACD,UAAU,EAAE,CAAC;aACd,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,0CAA0C,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,CAAU,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACtB,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC;YACjC,MAAM,CAAC,KAAK,CACV;gBACE,GAAG,SAAS;gBACZ,KAAK;aACN,EACD,wCAAwC,CACzC,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,SAAiB,EAAE,OAAuB;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,gDAAgD,IAAI,CAAC,MAAM,IAAI,CAAC;YAChF,MAAM,CAAC,KAAK,CACV;gBACE,GAAG,OAAO;gBACV,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,EACD,IAAI,SAAS,KAAK,OAAO,EAAE,CAC5B,CAAC;YACF,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,OAAO,EAAE;gBAC/D,KAAK,EAAE,IAAI,CAAC,mBAAmB;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,cAAc,CACzB,MAA4B,EAC5B,OAAuB;QAEvB,MAAM,SAAS,GAAG,mCAAmC,CAAC;QACtD,MAAM,eAAe,GAAG,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAEhE,OAAO,MAAM,YAAY,CAAC,QAAQ,CAChC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,IAAI,wBAAwB,CAAC;YACnE,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,MAAM,8BAA8B,CACzC,IAAI,CAAC,MAAO,EACZ,MAAM,EACN,OAAO,CACR,CAAC;QACJ,CAAC,EACD,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAC/C,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAC/B,MAA4B,EAC5B,OAAuB;QAEvB,MAAM,YAAY,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,cAAc,GAAG,QAAuC,CAAC;QAE/D,KAAK,SAAS,CAAC,CAAC,aAAa;YAC3B,MAAM,MAAM,GAA0B,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;oBACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnB,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE;oBAC1C,OAAO;oBACP,QAAQ,EAAE,MAAM;oBAChB,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;CACF;AAED,MAAM,0BAA0B,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAE5D,OAAO,EAAE,0BAA0B,IAAI,kBAAkB,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/services/supabase/supabaseClient.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Initializes and exports a singleton Supabase client instance.
+ * This module ensures that the Supabase client is initialized once and shared
+ * across the application, using credentials from the central configuration.
+ * It handles both the standard client and the admin client (using the service role key).
+ *
+ * @module src/services/supabase/supabaseClient
+ */
+import { SupabaseClient } from "@supabase/supabase-js";
+type Database = Record<string, unknown>;
+/**
+ * Returns the singleton Supabase client instance.
+ * Throws an McpError if the client is not initialized.
+ * @returns The Supabase client.
+ */
+export declare const getSupabaseClient: () => SupabaseClient<Database>;
+/**
+ * Returns the singleton Supabase admin client instance.
+ * This client uses the service role key and bypasses RLS.
+ * Throws an McpError if the admin client is not initialized.
+ * @returns The Supabase admin client.
+ */
+export declare const getSupabaseAdminClient: () => SupabaseClient<Database>;
+export {};
+//# sourceMappingURL=supabaseClient.d.ts.map

package/dist/services/supabase/supabaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabaseClient.d.ts","sourceRoot":"","sources":["../../../src/services/supabase/supabaseClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAgB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAOrE,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiDxC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,cAAc,CAAC,QAAQ,CAQ3D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAO,cAAc,CAAC,QAAQ,CAQhE,CAAC"}