mongodb-mcp-server 0.2.0 → 0.3.0

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

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

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

@@ -0,0 +1,16 @@
+import type { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import type { LoggerBase } from "./logger.js";
+export declare class SessionStore {
+    private readonly idleTimeoutMS;
+    private readonly notificationTimeoutMS;
+    private readonly logger;
+    private sessions;
+    constructor(idleTimeoutMS: number, notificationTimeoutMS: number, logger: LoggerBase);
+    getSession(sessionId: string): StreamableHTTPServerTransport | undefined;
+    private resetTimeout;
+    private sendNotification;
+    setSession(sessionId: string, transport: StreamableHTTPServerTransport, logger: LoggerBase): void;
+    closeSession(sessionId: string, closeTransport?: boolean): Promise<void>;
+    closeAllSessions(): Promise<void>;
+}
+//# sourceMappingURL=sessionStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../src/common/sessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACxG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,qBAAa,YAAY;IAWjB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZ3B,OAAO,CAAC,QAAQ,CAOT;gBAGc,aAAa,EAAE,MAAM,EACrB,qBAAqB,EAAE,MAAM,EAC7B,MAAM,EAAE,UAAU;IAavC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAKxE,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,gBAAgB;IAiBxB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,6BAA6B,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IA4B3F,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9E,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CAG1C"}

package/dist/cjs/common/sessionStore.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionStore = void 0;
+const logger_js_1 = require("./logger.js");
+const managedTimeout_js_1 = require("./managedTimeout.js");
+class SessionStore {
+    constructor(idleTimeoutMS, notificationTimeoutMS, logger) {
+        this.idleTimeoutMS = idleTimeoutMS;
+        this.notificationTimeoutMS = notificationTimeoutMS;
+        this.logger = logger;
+        this.sessions = {};
+        if (idleTimeoutMS <= 0) {
+            throw new Error("idleTimeoutMS must be greater than 0");
+        }
+        if (notificationTimeoutMS <= 0) {
+            throw new Error("notificationTimeoutMS must be greater than 0");
+        }
+        if (idleTimeoutMS <= notificationTimeoutMS) {
+            throw new Error("idleTimeoutMS must be greater than notificationTimeoutMS");
+        }
+    }
+    getSession(sessionId) {
+        this.resetTimeout(sessionId);
+        return this.sessions[sessionId]?.transport;
+    }
+    resetTimeout(sessionId) {
+        const session = this.sessions[sessionId];
+        if (!session) {
+            return;
+        }
+        session.abortTimeout.restart();
+        session.notificationTimeout.restart();
+    }
+    sendNotification(sessionId) {
+        const session = this.sessions[sessionId];
+        if (!session) {
+            this.logger.warning({
+                id: logger_js_1.LogId.streamableHttpTransportSessionCloseNotificationFailure,
+                context: "sessionStore",
+                message: `session ${sessionId} not found, no notification delivered`,
+            });
+            return;
+        }
+        session.logger.info({
+            id: logger_js_1.LogId.streamableHttpTransportSessionCloseNotification,
+            context: "sessionStore",
+            message: "Session is about to be closed due to inactivity",
+        });
+    }
+    setSession(sessionId, transport, logger) {
+        const session = this.sessions[sessionId];
+        if (session) {
+            throw new Error(`Session ${sessionId} already exists`);
+        }
+        const abortTimeout = (0, managedTimeout_js_1.setManagedTimeout)(async () => {
+            if (this.sessions[sessionId]) {
+                this.sessions[sessionId].logger.info({
+                    id: logger_js_1.LogId.streamableHttpTransportSessionCloseNotification,
+                    context: "sessionStore",
+                    message: "Session closed due to inactivity",
+                });
+                await this.closeSession(sessionId);
+            }
+        }, this.idleTimeoutMS);
+        const notificationTimeout = (0, managedTimeout_js_1.setManagedTimeout)(() => this.sendNotification(sessionId), this.notificationTimeoutMS);
+        this.sessions[sessionId] = {
+            transport,
+            abortTimeout,
+            notificationTimeout,
+            logger,
+        };
+    }
+    async closeSession(sessionId, closeTransport = true) {
+        const session = this.sessions[sessionId];
+        if (!session) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        session.abortTimeout.cancel();
+        session.notificationTimeout.cancel();
+        if (closeTransport) {
+            try {
+                await session.transport.close();
+            }
+            catch (error) {
+                this.logger.error({
+                    id: logger_js_1.LogId.streamableHttpTransportSessionCloseFailure,
+                    context: "streamableHttpTransport",
+                    message: `Error closing transport ${sessionId}: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        delete this.sessions[sessionId];
+    }
+    async closeAllSessions() {
+        await Promise.all(Object.keys(this.sessions).map((sessionId) => this.closeSession(sessionId)));
+    }
+}
+exports.SessionStore = SessionStore;
+//# sourceMappingURL=sessionStore.js.map

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

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

package/dist/cjs/helpers/connectionOptions.d.ts

@@ -0,0 +1,25 @@
+export interface AppNameComponents {
+    appName: string;
+    deviceId?: Promise<string>;
+    clientName?: string;
+}
+/**
+ * Sets the appName parameter with the extended format: appName--deviceId--clientName
+ * Only sets the appName if it's not already present in the connection string
+ * @param connectionString - The connection string to modify
+ * @param components - The components to build the appName from
+ * @returns The modified connection string
+ */
+export declare function setAppNameParamIfMissing({ connectionString, components, }: {
+    connectionString: string;
+    components: AppNameComponents;
+}): Promise<string>;
+/**
+ * Validates the connection string
+ * @param connectionString - The connection string to validate
+ * @param looseValidation - Whether to allow loose validation
+ * @returns void
+ * @throws Error if the connection string is invalid
+ */
+export declare function validateConnectionString(connectionString: string, looseValidation: boolean): void;
+//# sourceMappingURL=connectionOptions.d.ts.map

package/dist/cjs/helpers/connectionOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionOptions.d.ts","sourceRoot":"","sources":["../../../src/helpers/connectionOptions.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,EAC3C,gBAAgB,EAChB,UAAU,GACb,EAAE;IACC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;CACjC,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,IAAI,CAQjG"}

package/dist/cjs/helpers/connectionOptions.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setAppNameParamIfMissing = setAppNameParamIfMissing;
+exports.validateConnectionString = validateConnectionString;
+const mongodb_connection_string_url_1 = __importDefault(require("mongodb-connection-string-url"));
+/**
+ * Sets the appName parameter with the extended format: appName--deviceId--clientName
+ * Only sets the appName if it's not already present in the connection string
+ * @param connectionString - The connection string to modify
+ * @param components - The components to build the appName from
+ * @returns The modified connection string
+ */
+async function setAppNameParamIfMissing({ connectionString, components, }) {
+    const connectionStringUrl = new mongodb_connection_string_url_1.default(connectionString);
+    const searchParams = connectionStringUrl.typedSearchParams();
+    // Only set appName if it's not already present
+    if (searchParams.has("appName")) {
+        return connectionStringUrl.toString();
+    }
+    const appName = components.appName || "unknown";
+    const deviceId = components.deviceId ? await components.deviceId : "unknown";
+    const clientName = components.clientName || "unknown";
+    // Build the extended appName format: appName--deviceId--clientName
+    const extendedAppName = `${appName}--${deviceId}--${clientName}`;
+    searchParams.set("appName", extendedAppName);
+    return connectionStringUrl.toString();
+}
+/**
+ * Validates the connection string
+ * @param connectionString - The connection string to validate
+ * @param looseValidation - Whether to allow loose validation
+ * @returns void
+ * @throws Error if the connection string is invalid
+ */
+function validateConnectionString(connectionString, looseValidation) {
+    try {
+        new mongodb_connection_string_url_1.default(connectionString, { looseValidation });
+    }
+    catch (error) {
+        throw new Error(`Invalid connection string with error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=connectionOptions.js.map

package/dist/cjs/helpers/connectionOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionOptions.js","sourceRoot":"","sources":["../../../src/helpers/connectionOptions.ts"],"names":[],"mappings":";;;;;AAgBA,4DAyBC;AASD,4DAQC;AAzDD,kGAA6D;AAQ7D;;;;;;GAMG;AACI,KAAK,UAAU,wBAAwB,CAAC,EAC3C,gBAAgB,EAChB,UAAU,GAIb;IACG,MAAM,mBAAmB,GAAG,IAAI,uCAAgB,CAAC,gBAAgB,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,mBAAmB,CAAC,iBAAiB,EAAsB,CAAC;IAEjF,+CAA+C;IAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,SAAS,CAAC;IAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,IAAI,SAAS,CAAC;IAEtD,mEAAmE;IACnE,MAAM,eAAe,GAAG,GAAG,OAAO,KAAK,QAAQ,KAAK,UAAU,EAAE,CAAC;IAEjE,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAE7C,OAAO,mBAAmB,CAAC,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,gBAAwB,EAAE,eAAwB;IACvF,IAAI,CAAC;QACD,IAAI,uCAAgB,CAAC,gBAAgB,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACpG,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/cjs/helpers/container.d.ts

@@ -0,0 +1,2 @@
+export declare function detectContainerEnv(): Promise<boolean>;
+//# sourceMappingURL=container.d.ts.map

package/dist/cjs/helpers/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/helpers/container.ts"],"names":[],"mappings":"AAIA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CA8B3D"}

package/dist/cjs/helpers/container.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectContainerEnv = detectContainerEnv;
+const promises_1 = __importDefault(require("fs/promises"));
+let containerEnv;
+async function detectContainerEnv() {
+    if (containerEnv !== undefined) {
+        return containerEnv;
+    }
+    const detect = async function () {
+        if (process.platform !== "linux") {
+            return false; // we only support linux containers for now
+        }
+        if (process.env.container) {
+            return true;
+        }
+        const exists = await Promise.all(["/.dockerenv", "/run/.containerenv", "/var/run/.containerenv"].map(async (file) => {
+            try {
+                await promises_1.default.access(file);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }));
+        return exists.includes(true);
+    };
+    containerEnv = await detect();
+    return containerEnv;
+}
+//# sourceMappingURL=container.js.map

package/dist/cjs/helpers/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/helpers/container.ts"],"names":[],"mappings":";;;;;AAIA,gDA8BC;AAlCD,2DAA6B;AAE7B,IAAI,YAAiC,CAAC;AAE/B,KAAK,UAAU,kBAAkB;IACpC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK;QAChB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,CAAC,2CAA2C;QAC7D,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,CAAC,aAAa,EAAE,oBAAoB,EAAE,wBAAwB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC/E,IAAI,CAAC;gBACD,MAAM,kBAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACtB,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC,CAAC,CACL,CAAC;QAEF,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,YAAY,GAAG,MAAM,MAAM,EAAE,CAAC;IAC9B,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/cjs/helpers/deviceId.d.ts

@@ -0,0 +1,24 @@
+import type { LoggerBase } from "../common/logger.js";
+export declare const DEVICE_ID_TIMEOUT = 3000;
+export declare class DeviceId {
+    private static readonly UnknownDeviceId;
+    private deviceIdPromise;
+    private abortController;
+    private logger;
+    private readonly getMachineId;
+    private timeout;
+    private constructor();
+    private initialize;
+    static create(logger: LoggerBase, timeout?: number): DeviceId;
+    /**
+     * Closes the device ID calculation promise and abort controller.
+     */
+    close(): void;
+    /**
+     * Gets the device ID, waiting for the calculation to complete if necessary.
+     * @returns Promise that resolves to the device ID string
+     */
+    get(): Promise<string>;
+    private handleDeviceIdError;
+}
+//# sourceMappingURL=deviceId.d.ts.map

package/dist/cjs/helpers/deviceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../src/helpers/deviceId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAErE,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAaP,OAAO,CAAC,UAAU;WAWJ,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ;IAOpE;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,OAAO,CAAC,mBAAmB;CAwB9B"}

package/dist/cjs/helpers/deviceId.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceId = exports.DEVICE_ID_TIMEOUT = void 0;
+const device_id_1 = require("@mongodb-js/device-id");
+const logger_js_1 = require("../common/logger.js");
+exports.DEVICE_ID_TIMEOUT = 3000;
+class DeviceId {
+    constructor(logger, timeout = exports.DEVICE_ID_TIMEOUT) {
+        this.logger = logger;
+        this.timeout = timeout;
+        this.getMachineId = async () => {
+            const nodeMachineId = await Promise.resolve().then(() => __importStar(require("node-machine-id")));
+            const machineId = nodeMachineId.default?.machineId || nodeMachineId.machineId;
+            return machineId(true);
+        };
+        this.abortController = new AbortController();
+        this.deviceIdPromise = DeviceId.UnknownDeviceId;
+    }
+    initialize() {
+        this.deviceIdPromise = (0, device_id_1.getDeviceId)({
+            getMachineId: this.getMachineId,
+            onError: (reason, error) => {
+                this.handleDeviceIdError(reason, String(error));
+            },
+            timeout: this.timeout,
+            abortSignal: this.abortController.signal,
+        });
+    }
+    static create(logger, timeout) {
+        const instance = new DeviceId(logger, timeout ?? exports.DEVICE_ID_TIMEOUT);
+        instance.initialize();
+        return instance;
+    }
+    /**
+     * Closes the device ID calculation promise and abort controller.
+     */
+    close() {
+        this.abortController.abort();
+    }
+    /**
+     * Gets the device ID, waiting for the calculation to complete if necessary.
+     * @returns Promise that resolves to the device ID string
+     */
+    get() {
+        return this.deviceIdPromise;
+    }
+    handleDeviceIdError(reason, error) {
+        this.deviceIdPromise = DeviceId.UnknownDeviceId;
+        switch (reason) {
+            case "resolutionError":
+                this.logger.debug({
+                    id: logger_js_1.LogId.deviceIdResolutionError,
+                    context: "deviceId",
+                    message: `Resolution error: ${String(error)}`,
+                });
+                break;
+            case "timeout":
+                this.logger.debug({
+                    id: logger_js_1.LogId.deviceIdTimeout,
+                    context: "deviceId",
+                    message: "Device ID retrieval timed out",
+                    noRedaction: true,
+                });
+                break;
+            case "abort":
+                // No need to log in the case of 'abort' errors
+                break;
+        }
+    }
+}
+exports.DeviceId = DeviceId;
+DeviceId.UnknownDeviceId = Promise.resolve("unknown");
+//# sourceMappingURL=deviceId.js.map

package/dist/cjs/helpers/deviceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.js","sourceRoot":"","sources":["../../../src/helpers/deviceId.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAoD;AAEpD,mDAA4C;AAE/B,QAAA,iBAAiB,GAAG,IAAI,CAAC;AAEtC,MAAa,QAAQ;IASjB,YAAoB,MAAkB,EAAE,UAAkB,yBAAiB;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,IAAqB,EAAE;YAC5C,MAAM,aAAa,GAAG,wDAAa,iBAAiB,GAAC,CAAC;YACtD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,EAAE,SAAS,IAAI,aAAa,CAAC,SAAS,CAAC;YAC9E,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE7C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;IACpD,CAAC;IAEO,UAAU;QACd,IAAI,CAAC,eAAe,GAAG,IAAA,uBAAW,EAAC;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBACvB,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM;SAC3C,CAAC,CAAC;IACP,CAAC;IAEM,MAAM,CAAC,MAAM,CAAC,MAAkB,EAAE,OAAgB;QACrD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,IAAI,yBAAiB,CAAC,CAAC;QACpE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAEtB,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,GAAG;QACN,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAEO,mBAAmB,CAAC,MAAc,EAAE,KAAa;QACrD,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;QAEhD,QAAQ,MAAM,EAAE,CAAC;YACb,KAAK,iBAAiB;gBAClB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBACd,EAAE,EAAE,iBAAK,CAAC,uBAAuB;oBACjC,OAAO,EAAE,UAAU;oBACnB,OAAO,EAAE,qBAAqB,MAAM,CAAC,KAAK,CAAC,EAAE;iBAChD,CAAC,CAAC;gBACH,MAAM;YACV,KAAK,SAAS;gBACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBACd,EAAE,EAAE,iBAAK,CAAC,eAAe;oBACzB,OAAO,EAAE,UAAU;oBACnB,OAAO,EAAE,+BAA+B;oBACxC,WAAW,EAAE,IAAI;iBACpB,CAAC,CAAC;gBACH,MAAM;YACV,KAAK,OAAO;gBACR,+CAA+C;gBAC/C,MAAM;QACd,CAAC;IACL,CAAC;;AA9EL,4BA+EC;AA9E2B,wBAAe,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/cjs/helpers/generatePassword.d.ts

@@ -0,0 +1,2 @@
+export declare function generateSecurePassword(): Promise<string>;
+//# sourceMappingURL=generatePassword.d.ts.map

package/dist/cjs/helpers/generatePassword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePassword.d.ts","sourceRoot":"","sources":["../../../src/helpers/generatePassword.ts"],"names":[],"mappings":"AAKA,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAI9D"}

package/dist/cjs/helpers/generatePassword.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSecurePassword = generateSecurePassword;
+const crypto_1 = require("crypto");
+const util_1 = require("util");
+const randomBytesAsync = (0, util_1.promisify)(crypto_1.randomBytes);
+async function generateSecurePassword() {
+    const buf = await randomBytesAsync(16);
+    const pass = buf.toString("base64url");
+    return pass;
+}
+//# sourceMappingURL=generatePassword.js.map

package/dist/cjs/helpers/generatePassword.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePassword.js","sourceRoot":"","sources":["../../../src/helpers/generatePassword.ts"],"names":[],"mappings":";;AAKA,wDAIC;AATD,mCAAqC;AACrC,+BAAiC;AAEjC,MAAM,gBAAgB,GAAG,IAAA,gBAAS,EAAC,oBAAW,CAAC,CAAC;AAEzC,KAAK,UAAU,sBAAsB;IACxC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/cjs/helpers/indexCheck.d.ts

@@ -0,0 +1,17 @@
+import type { Document } from "mongodb";
+import type { NodeDriverServiceProvider } from "@mongosh/service-provider-node-driver";
+/**
+ * Check if the query plan uses an index
+ * @param explainResult The result of the explain query
+ * @returns true if an index is used, false if it's a full collection scan
+ */
+export declare function usesIndex(explainResult: Document): boolean;
+/**
+ * Generate an error message for index check failure
+ */
+export declare function getIndexCheckErrorMessage(database: string, collection: string, operation: string): string;
+/**
+ * Generic function to perform index usage check
+ */
+export declare function checkIndexUsage(provider: NodeDriverServiceProvider, database: string, collection: string, operation: string, explainCallback: () => Promise<Document>): Promise<void>;
+//# sourceMappingURL=indexCheck.d.ts.map

package/dist/cjs/helpers/indexCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCheck.d.ts","sourceRoot":"","sources":["../../../src/helpers/indexCheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAGvF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO,CAoC1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzG;AAED;;GAEG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,yBAAyB,EACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/cjs/helpers/indexCheck.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usesIndex = usesIndex;
+exports.getIndexCheckErrorMessage = getIndexCheckErrorMessage;
+exports.checkIndexUsage = checkIndexUsage;
+const errors_js_1 = require("../common/errors.js");
+/**
+ * Check if the query plan uses an index
+ * @param explainResult The result of the explain query
+ * @returns true if an index is used, false if it's a full collection scan
+ */
+function usesIndex(explainResult) {
+    const queryPlanner = explainResult?.queryPlanner;
+    const winningPlan = queryPlanner?.winningPlan;
+    const stage = winningPlan?.stage;
+    const inputStage = winningPlan?.inputStage;
+    // Check for index scan stages (including MongoDB 8.0+ stages)
+    const indexScanStages = [
+        "IXSCAN",
+        "COUNT_SCAN",
+        "EXPRESS_IXSCAN",
+        "EXPRESS_CLUSTERED_IXSCAN",
+        "EXPRESS_UPDATE",
+        "EXPRESS_DELETE",
+        "IDHACK",
+    ];
+    if (stage && indexScanStages.includes(stage)) {
+        return true;
+    }
+    if (inputStage && inputStage.stage && indexScanStages.includes(inputStage.stage)) {
+        return true;
+    }
+    // Recursively check deeper stages
+    if (inputStage && inputStage.inputStage) {
+        return usesIndex({ queryPlanner: { winningPlan: inputStage } });
+    }
+    if (stage === "COLLSCAN") {
+        return false;
+    }
+    // Default to false (conservative approach)
+    return false;
+}
+/**
+ * Generate an error message for index check failure
+ */
+function getIndexCheckErrorMessage(database, collection, operation) {
+    return `Index check failed: The ${operation} operation on "${database}.${collection}" performs a collection scan (COLLSCAN) instead of using an index. Consider adding an index for better performance. Use 'explain' tool for query plan analysis or 'collection-indexes' to view existing indexes. To disable this check, set MDB_MCP_INDEX_CHECK to false.`;
+}
+/**
+ * Generic function to perform index usage check
+ */
+async function checkIndexUsage(provider, database, collection, operation, explainCallback) {
+    try {
+        const explainResult = await explainCallback();
+        if (!usesIndex(explainResult)) {
+            throw new errors_js_1.MongoDBError(errors_js_1.ErrorCodes.ForbiddenCollscan, getIndexCheckErrorMessage(database, collection, operation));
+        }
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.MongoDBError && error.code === errors_js_1.ErrorCodes.ForbiddenCollscan) {
+            throw error;
+        }
+        // If explain itself fails, log but do not prevent query execution
+        // This avoids blocking normal queries in special cases (e.g., permission issues)
+        console.warn(`Index check failed to execute explain for ${operation} on ${database}.${collection}:`, error);
+    }
+}
+//# sourceMappingURL=indexCheck.js.map

package/dist/cjs/helpers/indexCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCheck.js","sourceRoot":"","sources":["../../../src/helpers/indexCheck.ts"],"names":[],"mappings":";;AASA,8BAoCC;AAKD,8DAEC;AAKD,0CAyBC;AAhFD,mDAA+D;AAE/D;;;;GAIG;AACH,SAAgB,SAAS,CAAC,aAAuB;IAC7C,MAAM,YAAY,GAAG,aAAa,EAAE,YAAoC,CAAC;IACzE,MAAM,WAAW,GAAG,YAAY,EAAE,WAAmC,CAAC;IACtE,MAAM,KAAK,GAAG,WAAW,EAAE,KAA2B,CAAC;IACvD,MAAM,UAAU,GAAG,WAAW,EAAE,UAAkC,CAAC;IAEnE,8DAA8D;IAC9D,MAAM,eAAe,GAAG;QACpB,QAAQ;QACR,YAAY;QACZ,gBAAgB;QAChB,0BAA0B;QAC1B,gBAAgB;QAChB,gBAAgB;QAChB,QAAQ;KACX,CAAC;IAEF,IAAI,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAe,CAAC,EAAE,CAAC;QACzF,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,kCAAkC;IAClC,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,2CAA2C;IAC3C,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,QAAgB,EAAE,UAAkB,EAAE,SAAiB;IAC7F,OAAO,2BAA2B,SAAS,kBAAkB,QAAQ,IAAI,UAAU,2QAA2Q,CAAC;AACnW,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACjC,QAAmC,EACnC,QAAgB,EAChB,UAAkB,EAClB,SAAiB,EACjB,eAAwC;IAExC,IAAI,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,eAAe,EAAE,CAAC;QAE9C,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,wBAAY,CAClB,sBAAU,CAAC,iBAAiB,EAC5B,yBAAyB,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAC7D,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,wBAAY,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAU,CAAC,iBAAiB,EAAE,CAAC;YAC/E,MAAM,KAAK,CAAC;QAChB,CAAC;QAED,kEAAkE;QAClE,iFAAiF;QACjF,OAAO,CAAC,IAAI,CAAC,6CAA6C,SAAS,OAAO,QAAQ,IAAI,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;IAChH,CAAC;AACL,CAAC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}