mongodb-mcp-server 2.1.0 → 3.0.0-prerelease.2

package/dist/cjs/common/connectionInfo.d.ts

@@ -1,51 +0,0 @@
-import type { UserConfig } from "./config/userConfig.js";
-/**
- * The host type of the connection string. Some values (e.g. local) are not yet supported, tools mostly
- * will return "unknown" for these values.
- */
-export type ConnectionStringHostType = "local" | "atlas" | "atlas_local" | "unknown";
-export type OIDCConnectionAuthType = "oidc-auth-flow" | "oidc-device-flow";
-export type ConnectionStringAuthType = "scram" | "ldap" | "kerberos" | OIDCConnectionAuthType | "x.509";
-/**
- * ConnectionStringInfo contains connection string metadata
- * without keeping the full connection string.
- */
-export interface ConnectionStringInfo {
-    authType: ConnectionStringAuthType;
-    hostType: ConnectionStringHostType;
-}
-/**
- * Atlas cluster connection info containing details about the connected Atlas cluster.
- * When provided, indicates the connection is to an Atlas cluster.
- */
-export interface AtlasClusterConnectionInfo {
-    username: string;
-    projectId: string;
-    clusterName: string;
-    instanceType: "FREE" | "FLEX" | "DEDICATED";
-    provider?: string;
-    region?: string;
-    expiryDate: Date;
-}
-/**
- * Get metadata about the connection string including authentication type and host type.
- * @param connectionString - The connection string to analyze.
- * @param config - The user configuration used to determine auth type.
- * @param atlasInfo - Optional Atlas cluster connection info. If provided, host type is set to "atlas".
- * @returns The connection string metadata.
- */
-export declare function getConnectionStringInfo(connectionString: string, config: UserConfig, atlasInfo?: AtlasClusterConnectionInfo): ConnectionStringInfo;
-/**
- * Get the host type from the connection string.
- * @param connectionString - The connection string to get the host type from.
- * @returns The host type.
- */
-export declare function getHostType(connectionString: string): ConnectionStringHostType;
-/**
- * Infer the authentication type from the connection string and user configuration.
- * @param config - The user configuration.
- * @param connectionString - The connection string to infer the auth type from.
- * @returns The inferred authentication type.
- */
-export declare function getAuthType(config: UserConfig, connectionString: string): ConnectionStringAuthType;
-//# sourceMappingURL=connectionInfo.d.ts.map

package/dist/cjs/common/connectionInfo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connectionInfo.d.ts","sourceRoot":"","sources":["../../../src/common/connectionInfo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;AAErF,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAC3E,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,sBAAsB,GAAG,OAAO,CAAC;AAExG;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,wBAAwB,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,UAAU,EAClB,SAAS,CAAC,EAAE,0BAA0B,GACvC,oBAAoB,CAKtB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,wBAAwB,CAU9E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,GAAG,wBAAwB,CAmClG"}

package/dist/cjs/common/connectionInfo.js

@@ -1,72 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getConnectionStringInfo = getConnectionStringInfo;
-exports.getHostType = getHostType;
-exports.getAuthType = getAuthType;
-const mongodb_build_info_1 = require("mongodb-build-info");
-const mongodb_connection_string_url_1 = require("mongodb-connection-string-url");
-/**
- * Get metadata about the connection string including authentication type and host type.
- * @param connectionString - The connection string to analyze.
- * @param config - The user configuration used to determine auth type.
- * @param atlasInfo - Optional Atlas cluster connection info. If provided, host type is set to "atlas".
- * @returns The connection string metadata.
- */
-function getConnectionStringInfo(connectionString, config, atlasInfo) {
-    return {
-        authType: getAuthType(config, connectionString),
-        hostType: atlasInfo !== undefined ? "atlas" : getHostType(connectionString),
-    };
-}
-/**
- * Get the host type from the connection string.
- * @param connectionString - The connection string to get the host type from.
- * @returns The host type.
- */
-function getHostType(connectionString) {
-    if ((0, mongodb_build_info_1.isAtlas)(connectionString)) {
-        return "atlas";
-    }
-    if ((0, mongodb_build_info_1.isLocalhost)(connectionString)) {
-        return "local";
-    }
-    return "unknown";
-}
-/**
- * Infer the authentication type from the connection string and user configuration.
- * @param config - The user configuration.
- * @param connectionString - The connection string to infer the auth type from.
- * @returns The inferred authentication type.
- */
-function getAuthType(config, connectionString) {
-    const connString = new mongodb_connection_string_url_1.ConnectionString(connectionString);
-    const searchParams = connString.typedSearchParams();
-    switch (searchParams.get("authMechanism")) {
-        case "MONGODB-OIDC": {
-            if (config.transport === "stdio" && config.browser) {
-                return "oidc-auth-flow";
-            }
-            if (config.transport === "http" &&
-                (config.httpHost === "127.0.0.1" || config.httpHost === "localhost") &&
-                config.browser) {
-                return "oidc-auth-flow";
-            }
-            return "oidc-device-flow";
-        }
-        case "MONGODB-X509":
-            return "x.509";
-        case "GSSAPI":
-            return "kerberos";
-        case "PLAIN":
-            if (searchParams.get("authSource") === "$external") {
-                return "ldap";
-            }
-            return "scram";
-        // default should catch also null, but eslint complains
-        // about it.
-        case null:
-        default:
-            return "scram";
-    }
-}
-//# sourceMappingURL=connectionInfo.js.map

package/dist/cjs/common/connectionInfo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connectionInfo.js","sourceRoot":"","sources":["../../../src/common/connectionInfo.ts"],"names":[],"mappings":";;AA4CA,0DASC;AAOD,kCAUC;AAQD,kCAmCC;AAjHD,2DAA0D;AAE1D,iFAAiE;AAmCjE;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACnC,gBAAwB,EACxB,MAAkB,EAClB,SAAsC;IAEtC,OAAO;QACH,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC;QAC/C,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;KAC9E,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,WAAW,CAAC,gBAAwB;IAChD,IAAI,IAAA,4BAAO,EAAC,gBAAgB,CAAC,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,IAAI,IAAA,gCAAW,EAAC,gBAAgB,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,MAAkB,EAAE,gBAAwB;IACpE,MAAM,UAAU,GAAG,IAAI,gDAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,UAAU,CAAC,iBAAiB,EAAsB,CAAC;IAExE,QAAQ,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACxC,KAAK,cAAc,CAAC,CAAC,CAAC;YAClB,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjD,OAAO,gBAAgB,CAAC;YAC5B,CAAC;YAED,IACI,MAAM,CAAC,SAAS,KAAK,MAAM;gBAC3B,CAAC,MAAM,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAC;gBACpE,MAAM,CAAC,OAAO,EAChB,CAAC;gBACC,OAAO,gBAAgB,CAAC;YAC5B,CAAC;YAED,OAAO,kBAAkB,CAAC;QAC9B,CAAC;QACD,KAAK,cAAc;YACf,OAAO,OAAO,CAAC;QACnB,KAAK,QAAQ;YACT,OAAO,UAAU,CAAC;QACtB,KAAK,OAAO;YACR,IAAI,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,WAAW,EAAE,CAAC;gBACjD,OAAO,MAAM,CAAC;YAClB,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,uDAAuD;QACvD,YAAY;QACZ,KAAK,IAAI,CAAC;QACV;YACI,OAAO,OAAO,CAAC;IACvB,CAAC;AACL,CAAC"}

package/dist/cjs/common/connectionManager.d.ts

@@ -1,147 +0,0 @@
-import { EventEmitter } from "events";
-import { NodeDriverServiceProvider } from "@mongosh/service-provider-node-driver";
-import { type ConnectionInfo } from "@mongosh/arg-parser";
-import type { DeviceId } from "../helpers/deviceId.js";
-import { type UserConfig } from "./config/userConfig.js";
-import { type LoggerBase } from "./logging/index.js";
-import { type ConnectionStringInfo, type AtlasClusterConnectionInfo } from "./connectionInfo.js";
-export type { ConnectionStringInfo, ConnectionStringAuthType, AtlasClusterConnectionInfo } from "./connectionInfo.js";
-export interface ConnectionSettings extends Omit<ConnectionInfo, "driverOptions"> {
-    driverOptions?: ConnectionInfo["driverOptions"];
-    atlas?: AtlasClusterConnectionInfo;
-}
-export type ConnectionTag = "connected" | "connecting" | "disconnected" | "errored";
-export type OIDCConnectionAuthType = "oidc-auth-flow" | "oidc-device-flow";
-export interface ConnectionState {
-    tag: ConnectionTag;
-    connectionStringInfo?: ConnectionStringInfo;
-    connectedAtlasCluster?: AtlasClusterConnectionInfo;
-}
-export declare const defaultDriverOptions: ConnectionInfo["driverOptions"];
-export declare class ConnectionStateConnected implements ConnectionState {
-    serviceProvider: NodeDriverServiceProvider;
-    connectionStringInfo?: ConnectionStringInfo | undefined;
-    connectedAtlasCluster?: AtlasClusterConnectionInfo | undefined;
-    tag: "connected";
-    constructor(serviceProvider: NodeDriverServiceProvider, connectionStringInfo?: ConnectionStringInfo | undefined, connectedAtlasCluster?: AtlasClusterConnectionInfo | undefined);
-    private _isSearchSupported?;
-    isSearchSupported(logger: LoggerBase): Promise<boolean>;
-    private probeSearchCapability;
-    /**
-     * Build an ordered list of database names to try for the search index probe.
-     * Prefers the driver's initial database from the connection string (when not
-     * a system DB), then other non-system databases from listDatabases, then the
-     * fallback #mongodb-mcp database.
-     */
-    private buildSearchProbeDatabaseCandidates;
-}
-export interface ConnectionStateConnecting extends ConnectionState {
-    tag: "connecting";
-    serviceProvider: Promise<NodeDriverServiceProvider>;
-    oidcConnectionType: OIDCConnectionAuthType;
-    oidcLoginUrl?: string;
-    oidcUserCode?: string;
-}
-export interface ConnectionStateDisconnected extends ConnectionState {
-    tag: "disconnected";
-}
-export interface ConnectionStateErrored extends ConnectionState {
-    tag: "errored";
-    errorReason: string;
-}
-export type AnyConnectionState = ConnectionStateConnected | ConnectionStateConnecting | ConnectionStateDisconnected | ConnectionStateErrored;
-export interface ConnectionManagerEvents {
-    "connection-request": [AnyConnectionState];
-    "connection-success": [ConnectionStateConnected];
-    "connection-time-out": [ConnectionStateErrored];
-    "connection-close": [ConnectionStateDisconnected];
-    "connection-error": [ConnectionStateErrored];
-    close: [AnyConnectionState];
-}
-export declare abstract class ConnectionManager {
-    clientName: string;
-    protected readonly _events: EventEmitter<ConnectionManagerEvents>;
-    readonly events: Pick<EventEmitter<ConnectionManagerEvents>, "on" | "off" | "once">;
-    private state;
-    constructor();
-    get currentConnectionState(): AnyConnectionState;
-    protected changeState<Event extends keyof ConnectionManagerEvents, State extends ConnectionManagerEvents[Event][0]>(event: Event, newState: State): State;
-    setClientName(clientName: string): void;
-    abstract connect(settings: ConnectionSettings): Promise<AnyConnectionState>;
-    abstract disconnect(): Promise<ConnectionStateDisconnected | ConnectionStateErrored>;
-    abstract close(): Promise<void>;
-}
-/**
- * Default {@link ConnectionManager} implementation used by the MongoDB MCP
- * server.
- *
- * Establishes and tears down MongoDB connections via mongosh's
- * NodeDriverServiceProvider, applying MCP-specific defaults such as the
- * `appName` (composed from package info, device id and client name) and driver
- * options (read/write concerns, proxy and OIDC settings).
- *
- * Tracks connection lifecycle as an {@link AnyConnectionState} and emits
- * `connection-request`, `connection-success`, `connection-error`,
- * `connection-close` and `close` events on {@link ConnectionManager.events}.
- * For OIDC connection strings it stays in the `connecting` state until the OIDC
- * plugin reports auth success or failure (via the shared event bus), surfacing
- * device-flow verification URL and user code when applicable.
- */
-export declare class MCPConnectionManager extends ConnectionManager {
-    private userConfig;
-    private logger;
-    private deviceId;
-    private bus;
-    /**
-     * @param userConfig - Active user configuration; used when classifying the
-     * connection string (e.g. Atlas vs. local).
-     * @param logger - Logger used for OIDC and disconnect diagnostics.
-     * @param deviceId - Provider of the stable device identifier embedded in
-     * the connection's `appName`.
-     * @param bus - Optional event emitter shared with the OIDC plugin to
-     * receive `mongodb-oidc-plugin:auth-*` notifications. A fresh emitter is
-     * created when omitted.
-     */
-    constructor(userConfig: UserConfig, logger: LoggerBase, deviceId: DeviceId, bus?: EventEmitter);
-    /**
-     * Opens a new MongoDB connection from the supplied {@link ConnectionSettings},
-     * disconnecting any prior connection first.
-     *
-     * Resolves to a `connected` state for non-OIDC auth and to a `connecting`
-     * state for OIDC flows (which transition to `connected` once the OIDC
-     * plugin reports success on the shared event bus). On failure, transitions
-     * to an `errored` state and throws a {@link MongoDBError} with either
-     * {@link ErrorCodes.MisconfiguredConnectionString} or
-     * {@link ErrorCodes.NotConnectedToMongoDB}.
-     */
-    connect(settings: ConnectionSettings): Promise<AnyConnectionState>;
-    /**
-     * Closes the underlying NodeDriverServiceProvider (awaiting it first when
-     * the manager is still in the `connecting` state) and emits
-     * `connection-close`. No-op when already `disconnected` or `errored`, in
-     * which case the current state is returned as-is.
-     */
-    disconnect(): Promise<ConnectionStateDisconnected | ConnectionStateErrored>;
-    /**
-     * Permanently shuts the manager down: best-effort disconnect (errors are
-     * logged, not thrown) followed by emission of the `close` event with the
-     * final connection state.
-     */
-    close(): Promise<void>;
-    private onOidcAuthFailed;
-    private onOidcAuthSucceeded;
-    private onOidcNotifyDeviceFlow;
-    private disconnectOnOidcError;
-}
-/**
- * Consumers of MCP server library have option to bring their own connection
- * management if they need to. To support that, we enable injecting connection
- * manager implementation through a factory function.
- */
-export type ConnectionManagerFactoryFn = (createParams: {
-    logger: LoggerBase;
-    deviceId: DeviceId;
-    userConfig: UserConfig;
-}) => Promise<ConnectionManager>;
-export declare const defaultCreateConnectionManager: ConnectionManagerFactoryFn;
-//# sourceMappingURL=connectionManager.d.ts.map

package/dist/cjs/common/connectionManager.d.ts.map

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

package/dist/cjs/common/connectionManager.js

@@ -1,373 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultCreateConnectionManager = exports.MCPConnectionManager = exports.ConnectionManager = exports.ConnectionStateConnected = exports.defaultDriverOptions = void 0;
-const events_1 = require("events");
-const mongodb_1 = require("mongodb");
-const service_provider_node_driver_1 = require("@mongosh/service-provider-node-driver");
-const arg_parser_1 = require("@mongosh/arg-parser");
-const errors_js_1 = require("./errors.js");
-const index_js_1 = require("./logging/index.js");
-const packageInfo_js_1 = require("./packageInfo.js");
-const connectionOptions_js_1 = require("../helpers/connectionOptions.js");
-const connectionInfo_js_1 = require("./connectionInfo.js");
-const SEARCH_PROBE_COLLECTION_NAME = "test";
-/** See https://github.com/mongodb/mongo/blob/master/src/mongo/base/error_codes.yml (SearchNotEnabled). */
-const MONGODB_SEARCH_NOT_ENABLED_ERROR_CODE = 31082;
-exports.defaultDriverOptions = {
-    readConcern: {
-        level: "local",
-    },
-    readPreference: "secondaryPreferred",
-    writeConcern: {
-        w: "majority",
-    },
-    timeoutMS: 30000,
-    proxy: { useEnvironmentVariableProxies: true },
-    applyProxyToOIDC: true,
-};
-class ConnectionStateConnected {
-    constructor(serviceProvider, connectionStringInfo, connectedAtlasCluster) {
-        this.serviceProvider = serviceProvider;
-        this.connectionStringInfo = connectionStringInfo;
-        this.connectedAtlasCluster = connectedAtlasCluster;
-        this.tag = "connected";
-    }
-    async isSearchSupported(logger) {
-        if (this._isSearchSupported === undefined) {
-            this._isSearchSupported = await this.probeSearchCapability(logger);
-        }
-        return this._isSearchSupported;
-    }
-    async probeSearchCapability(logger) {
-        const databases = await this.buildSearchProbeDatabaseCandidates(logger);
-        for (const databaseName of databases) {
-            try {
-                await this.serviceProvider.getSearchIndexes(databaseName, SEARCH_PROBE_COLLECTION_NAME);
-                logger.debug({
-                    id: index_js_1.LogId.searchCapabilityProbe,
-                    context: "ConnectionStateConnected",
-                    message: "Atlas Search capability probe succeeded",
-                });
-                return true;
-            }
-            catch (probeError) {
-                if (probeError instanceof mongodb_1.MongoServerError &&
-                    (probeError.code === MONGODB_SEARCH_NOT_ENABLED_ERROR_CODE ||
-                        probeError.codeName === "SearchNotEnabled")) {
-                    logger.debug({
-                        id: index_js_1.LogId.searchCapabilityProbe,
-                        context: "ConnectionStateConnected",
-                        message: "Atlas Search capability probe: search not enabled on cluster",
-                    });
-                    return false;
-                }
-                logger.debug({
-                    id: index_js_1.LogId.searchCapabilityProbe,
-                    context: "ConnectionStateConnected",
-                    message: "Atlas Search capability probe: inconclusive error for database candidate, trying next",
-                });
-            }
-        }
-        logger.debug({
-            id: index_js_1.LogId.searchCapabilityProbe,
-            context: "ConnectionStateConnected",
-            message: "Atlas Search capability probe: no success and no SearchNotEnabled; assuming search is supported",
-        });
-        return true;
-    }
-    /**
-     * Build an ordered list of database names to try for the search index probe.
-     * Prefers the driver's initial database from the connection string (when not
-     * a system DB), then other non-system databases from listDatabases, then the
-     * fallback #mongodb-mcp database.
-     */
-    async buildSearchProbeDatabaseCandidates(logger) {
-        let listedNames = [];
-        try {
-            const raw = (await this.serviceProvider.listDatabases(""));
-            const rows = raw.databases;
-            if (Array.isArray(rows)) {
-                listedNames = rows
-                    .map((row) => row.name)
-                    .filter((name) => typeof name === "string" && name.length > 0);
-            }
-        }
-        catch {
-            logger.debug({
-                id: index_js_1.LogId.searchCapabilityProbe,
-                context: "ConnectionStateConnected",
-                message: "listDatabases failed while building Atlas Search probe candidates",
-            });
-        }
-        // System databases that should be skipped when searching for accessible databases
-        const SYSTEM_DATABASES = new Set(["admin", "local", "config"]);
-        const nonSystem = listedNames
-            .filter((name) => !SYSTEM_DATABASES.has(name))
-            .slice(0, 10)
-            .sort((a, b) => a.localeCompare(b));
-        const result = new Set();
-        const initialDb = this.serviceProvider.initialDb;
-        if (initialDb.length > 0 && !SYSTEM_DATABASES.has(initialDb)) {
-            result.add(initialDb);
-        }
-        for (const name of nonSystem) {
-            result.add(name);
-        }
-        result.add("#mongodb-mcp");
-        return [...result];
-    }
-}
-exports.ConnectionStateConnected = ConnectionStateConnected;
-class ConnectionManager {
-    constructor() {
-        this.clientName = "unknown";
-        this.events = this._events = new events_1.EventEmitter();
-        this.state = { tag: "disconnected" };
-    }
-    get currentConnectionState() {
-        return this.state;
-    }
-    changeState(event, newState) {
-        this.state = newState;
-        // TypeScript doesn't seem to be happy with the spread operator and generics
-        // eslint-disable-next-line
-        this._events.emit(event, ...[newState]);
-        return newState;
-    }
-    setClientName(clientName) {
-        this.clientName = clientName;
-    }
-}
-exports.ConnectionManager = ConnectionManager;
-/**
- * Default {@link ConnectionManager} implementation used by the MongoDB MCP
- * server.
- *
- * Establishes and tears down MongoDB connections via mongosh's
- * NodeDriverServiceProvider, applying MCP-specific defaults such as the
- * `appName` (composed from package info, device id and client name) and driver
- * options (read/write concerns, proxy and OIDC settings).
- *
- * Tracks connection lifecycle as an {@link AnyConnectionState} and emits
- * `connection-request`, `connection-success`, `connection-error`,
- * `connection-close` and `close` events on {@link ConnectionManager.events}.
- * For OIDC connection strings it stays in the `connecting` state until the OIDC
- * plugin reports auth success or failure (via the shared event bus), surfacing
- * device-flow verification URL and user code when applicable.
- */
-class MCPConnectionManager extends ConnectionManager {
-    /**
-     * @param userConfig - Active user configuration; used when classifying the
-     * connection string (e.g. Atlas vs. local).
-     * @param logger - Logger used for OIDC and disconnect diagnostics.
-     * @param deviceId - Provider of the stable device identifier embedded in
-     * the connection's `appName`.
-     * @param bus - Optional event emitter shared with the OIDC plugin to
-     * receive `mongodb-oidc-plugin:auth-*` notifications. A fresh emitter is
-     * created when omitted.
-     */
-    constructor(userConfig, logger, deviceId, bus) {
-        super();
-        this.userConfig = userConfig;
-        this.logger = logger;
-        this.bus = bus ?? new events_1.EventEmitter();
-        this.bus.on("mongodb-oidc-plugin:auth-failed", this.onOidcAuthFailed.bind(this));
-        // eslint-disable-next-line @typescript-eslint/no-misused-promises
-        this.bus.on("mongodb-oidc-plugin:auth-succeeded", this.onOidcAuthSucceeded.bind(this));
-        this.deviceId = deviceId;
-    }
-    /**
-     * Opens a new MongoDB connection from the supplied {@link ConnectionSettings},
-     * disconnecting any prior connection first.
-     *
-     * Resolves to a `connected` state for non-OIDC auth and to a `connecting`
-     * state for OIDC flows (which transition to `connected` once the OIDC
-     * plugin reports success on the shared event bus). On failure, transitions
-     * to an `errored` state and throws a {@link MongoDBError} with either
-     * {@link ErrorCodes.MisconfiguredConnectionString} or
-     * {@link ErrorCodes.NotConnectedToMongoDB}.
-     */
-    async connect(settings) {
-        var _a, _b, _c, _d;
-        this._events.emit("connection-request", this.currentConnectionState);
-        if (this.currentConnectionState.tag === "connected" || this.currentConnectionState.tag === "connecting") {
-            await this.disconnect();
-        }
-        let serviceProvider;
-        let connectionStringInfo = { authType: "scram", hostType: "unknown" };
-        try {
-            settings = { ...settings };
-            const appNameComponents = {
-                appName: `${packageInfo_js_1.packageInfo.mcpServerName} ${packageInfo_js_1.packageInfo.version}`,
-                deviceId: this.deviceId.get(),
-                clientName: this.clientName,
-            };
-            settings.connectionString = await (0, connectionOptions_js_1.setAppNameParamIfMissing)({
-                connectionString: settings.connectionString,
-                components: appNameComponents,
-            });
-            const connectionInfo = settings.driverOptions
-                ? {
-                    connectionString: settings.connectionString,
-                    driverOptions: settings.driverOptions,
-                }
-                : (0, arg_parser_1.generateConnectionInfoFromCliArgs)({
-                    ...exports.defaultDriverOptions,
-                    /** TODO: Currently we're passing the entire user config to make it apply the mongosh CLI commands that were passed in. We should consider seperating the fields in the future. */
-                    ...this.userConfig,
-                    connectionSpecifier: settings.connectionString,
-                });
-            if (connectionInfo.driverOptions.oidc) {
-                (_a = connectionInfo.driverOptions.oidc).allowedFlows ?? (_a.allowedFlows = ["auth-code"]);
-                (_b = connectionInfo.driverOptions.oidc).notifyDeviceFlow ?? (_b.notifyDeviceFlow = this.onOidcNotifyDeviceFlow.bind(this));
-            }
-            (_c = connectionInfo.driverOptions).proxy ?? (_c.proxy = { useEnvironmentVariableProxies: true });
-            (_d = connectionInfo.driverOptions).applyProxyToOIDC ?? (_d.applyProxyToOIDC = true);
-            connectionStringInfo = (0, connectionInfo_js_1.getConnectionStringInfo)(connectionInfo.connectionString, this.userConfig, settings.atlas);
-            serviceProvider = service_provider_node_driver_1.NodeDriverServiceProvider.connect(connectionInfo.connectionString, {
-                productDocsLink: "https://github.com/mongodb-js/mongodb-mcp-server/",
-                productName: "MongoDB MCP",
-                ...connectionInfo.driverOptions,
-            }, undefined, this.bus);
-        }
-        catch (error) {
-            const errorReason = error instanceof Error ? error.message : `${error}`;
-            this.changeState("connection-error", {
-                tag: "errored",
-                errorReason,
-                connectionStringInfo,
-                connectedAtlasCluster: settings.atlas,
-            });
-            throw new errors_js_1.MongoDBError(errors_js_1.ErrorCodes.MisconfiguredConnectionString, errorReason);
-        }
-        try {
-            if (connectionStringInfo.authType.startsWith("oidc")) {
-                return this.changeState("connection-request", {
-                    tag: "connecting",
-                    serviceProvider,
-                    connectedAtlasCluster: settings.atlas,
-                    connectionStringInfo,
-                    oidcConnectionType: connectionStringInfo.authType,
-                });
-            }
-            return this.changeState("connection-success", new ConnectionStateConnected(await serviceProvider, connectionStringInfo, settings.atlas));
-        }
-        catch (error) {
-            const errorReason = error instanceof Error ? error.message : `${error}`;
-            this.changeState("connection-error", {
-                tag: "errored",
-                errorReason,
-                connectionStringInfo,
-                connectedAtlasCluster: settings.atlas,
-            });
-            throw new errors_js_1.MongoDBError(errors_js_1.ErrorCodes.NotConnectedToMongoDB, errorReason);
-        }
-    }
-    /**
-     * Closes the underlying NodeDriverServiceProvider (awaiting it first when
-     * the manager is still in the `connecting` state) and emits
-     * `connection-close`. No-op when already `disconnected` or `errored`, in
-     * which case the current state is returned as-is.
-     */
-    async disconnect() {
-        if (this.currentConnectionState.tag === "disconnected" || this.currentConnectionState.tag === "errored") {
-            return this.currentConnectionState;
-        }
-        if (this.currentConnectionState.tag === "connected" || this.currentConnectionState.tag === "connecting") {
-            try {
-                if (this.currentConnectionState.tag === "connected") {
-                    await this.currentConnectionState.serviceProvider?.close();
-                }
-                if (this.currentConnectionState.tag === "connecting") {
-                    const serviceProvider = await this.currentConnectionState.serviceProvider;
-                    await serviceProvider.close();
-                }
-            }
-            finally {
-                this.changeState("connection-close", {
-                    tag: "disconnected",
-                });
-            }
-        }
-        return { tag: "disconnected" };
-    }
-    /**
-     * Permanently shuts the manager down: best-effort disconnect (errors are
-     * logged, not thrown) followed by emission of the `close` event with the
-     * final connection state.
-     */
-    async close() {
-        try {
-            await this.disconnect();
-        }
-        catch (err) {
-            const error = err instanceof Error ? err : new Error(String(err));
-            this.logger.error({
-                id: index_js_1.LogId.mongodbDisconnectFailure,
-                context: "ConnectionManager",
-                message: `Error when closing ConnectionManager: ${error.message}`,
-            });
-        }
-        finally {
-            this._events.emit("close", this.currentConnectionState);
-        }
-    }
-    onOidcAuthFailed(error) {
-        if (this.currentConnectionState.tag === "connecting" &&
-            this.currentConnectionState.connectionStringInfo?.authType?.startsWith("oidc")) {
-            void this.disconnectOnOidcError(error);
-        }
-    }
-    async onOidcAuthSucceeded() {
-        if (this.currentConnectionState.tag === "connecting" &&
-            this.currentConnectionState.connectionStringInfo?.authType?.startsWith("oidc")) {
-            this.changeState("connection-success", new ConnectionStateConnected(await this.currentConnectionState.serviceProvider, this.currentConnectionState.connectionStringInfo, this.currentConnectionState.connectedAtlasCluster));
-        }
-        this.logger.info({
-            id: index_js_1.LogId.oidcFlow,
-            context: "mongodb-oidc-plugin:auth-succeeded",
-            message: "Authenticated successfully.",
-        });
-    }
-    onOidcNotifyDeviceFlow(flowInfo) {
-        if (this.currentConnectionState.tag === "connecting" &&
-            this.currentConnectionState.connectionStringInfo?.authType?.startsWith("oidc")) {
-            this.changeState("connection-request", {
-                ...this.currentConnectionState,
-                tag: "connecting",
-                connectionStringInfo: {
-                    ...this.currentConnectionState.connectionStringInfo,
-                    authType: "oidc-device-flow",
-                },
-                oidcLoginUrl: flowInfo.verificationUrl,
-                oidcUserCode: flowInfo.userCode,
-            });
-        }
-        this.logger.info({
-            id: index_js_1.LogId.oidcFlow,
-            context: "mongodb-oidc-plugin:notify-device-flow",
-            message: "OIDC Flow changed automatically to device flow.",
-        });
-    }
-    async disconnectOnOidcError(error) {
-        try {
-            await this.disconnect();
-        }
-        catch (error) {
-            this.logger.warning({
-                id: index_js_1.LogId.oidcFlow,
-                context: "disconnectOnOidcError",
-                message: String(error),
-            });
-        }
-        finally {
-            this.changeState("connection-error", { tag: "errored", errorReason: String(error) });
-        }
-    }
-}
-exports.MCPConnectionManager = MCPConnectionManager;
-const defaultCreateConnectionManager = ({ logger, deviceId, userConfig }) => {
-    return Promise.resolve(new MCPConnectionManager(userConfig, logger, deviceId));
-};
-exports.defaultCreateConnectionManager = defaultCreateConnectionManager;
-//# sourceMappingURL=connectionManager.js.map