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

package/dist/cjs/helpers/collectCursorUntilMaxBytes.js

@@ -1,75 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getResponseBytesLimit = getResponseBytesLimit;
-exports.collectCursorUntilMaxBytesLimit = collectCursorUntilMaxBytesLimit;
-const bson_1 = require("bson");
-function getResponseBytesLimit(toolResponseBytesLimit, configuredMaxBytesPerQuery) {
-    const configuredLimit = parseInt(String(configuredMaxBytesPerQuery), 10);
-    // Setting configured maxBytesPerQuery to negative, zero or nullish is
-    // equivalent to disabling the max limit applied on documents
-    const configuredLimitIsNotApplicable = Number.isNaN(configuredLimit) || configuredLimit <= 0;
-    // It's possible to have tool parameter responseBytesLimit as null or
-    // negative values in which case we consider that no limit is to be
-    // applied from tool call perspective unless we have a maxBytesPerQuery
-    // configured.
-    const toolResponseLimitIsNotApplicable = typeof toolResponseBytesLimit !== "number" || toolResponseBytesLimit <= 0;
-    if (configuredLimitIsNotApplicable) {
-        return {
-            cappedBy: toolResponseLimitIsNotApplicable ? undefined : "tool.responseBytesLimit",
-            limit: toolResponseLimitIsNotApplicable ? 0 : toolResponseBytesLimit,
-        };
-    }
-    if (toolResponseLimitIsNotApplicable) {
-        return { cappedBy: "config.maxBytesPerQuery", limit: configuredLimit };
-    }
-    return {
-        cappedBy: configuredLimit < toolResponseBytesLimit ? "config.maxBytesPerQuery" : "tool.responseBytesLimit",
-        limit: Math.min(toolResponseBytesLimit, configuredLimit),
-    };
-}
-/**
- * This function attempts to put a guard rail against accidental memory overflow
- * on the MCP server.
- *
- * The cursor is iterated until we can predict that fetching next doc won't
- * exceed the derived limit on number of bytes for the tool call. The derived
- * limit takes into account the limit provided from the Tool's interface and the
- * configured maxBytesPerQuery for the server.
- */
-async function collectCursorUntilMaxBytesLimit({ cursor, toolResponseBytesLimit, configuredMaxBytesPerQuery, abortSignal, }) {
-    const { limit: maxBytesPerQuery, cappedBy } = getResponseBytesLimit(toolResponseBytesLimit, configuredMaxBytesPerQuery);
-    // It's possible to have no limit on the cursor response by setting both the
-    // config.maxBytesPerQuery and tool.responseBytesLimit to nullish or
-    // negative values.
-    if (maxBytesPerQuery <= 0) {
-        return {
-            cappedBy,
-            documents: await cursor.toArray(),
-        };
-    }
-    let wasCapped = false;
-    let totalBytes = 0;
-    const bufferedDocuments = [];
-    while (true) {
-        if (abortSignal?.aborted) {
-            break;
-        }
-        // If the cursor is empty then there is nothing for us to do anymore.
-        const nextDocument = await cursor.tryNext();
-        if (!nextDocument) {
-            break;
-        }
-        const nextDocumentSize = (0, bson_1.calculateObjectSize)(nextDocument);
-        if (totalBytes + nextDocumentSize >= maxBytesPerQuery) {
-            wasCapped = true;
-            break;
-        }
-        totalBytes += nextDocumentSize;
-        bufferedDocuments.push(nextDocument);
-    }
-    return {
-        cappedBy: wasCapped ? cappedBy : undefined,
-        documents: bufferedDocuments,
-    };
-}
-//# sourceMappingURL=collectCursorUntilMaxBytes.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"collectCursorUntilMaxBytes.js","sourceRoot":"","sources":["../../../src/helpers/collectCursorUntilMaxBytes.ts"],"names":[],"mappings":";;AAGA,sDAkCC;AAWD,0EAsDC;AAtGD,+BAA2C;AAG3C,SAAgB,qBAAqB,CACjC,sBAAiD,EACjD,0BAAmC;IAKnC,MAAM,eAAe,GAAW,QAAQ,CAAC,MAAM,CAAC,0BAA0B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjF,sEAAsE;IACtE,6DAA6D;IAC7D,MAAM,8BAA8B,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,eAAe,IAAI,CAAC,CAAC;IAE7F,qEAAqE;IACrE,mEAAmE;IACnE,uEAAuE;IACvE,cAAc;IACd,MAAM,gCAAgC,GAAG,OAAO,sBAAsB,KAAK,QAAQ,IAAI,sBAAsB,IAAI,CAAC,CAAC;IAEnH,IAAI,8BAA8B,EAAE,CAAC;QACjC,OAAO;YACH,QAAQ,EAAE,gCAAgC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB;YAClF,KAAK,EAAE,gCAAgC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;SACvE,CAAC;IACN,CAAC;IAED,IAAI,gCAAgC,EAAE,CAAC;QACnC,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;IAC3E,CAAC;IAED,OAAO;QACH,QAAQ,EAAE,eAAe,GAAG,sBAAsB,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB;QAC1G,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,eAAe,CAAC;KAC3D,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,+BAA+B,CAAc,EAC/D,MAAM,EACN,sBAAsB,EACtB,0BAA0B,EAC1B,WAAW,GAMd;IACG,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,qBAAqB,CAC/D,sBAAsB,EACtB,0BAA0B,CAC7B,CAAC;IAEF,4EAA4E;IAC5E,oEAAoE;IACpE,mBAAmB;IACnB,IAAI,gBAAgB,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO;YACH,QAAQ;YACR,SAAS,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE;SACpC,CAAC;IACN,CAAC;IAED,IAAI,SAAS,GAAY,KAAK,CAAC;IAC/B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,iBAAiB,GAAQ,EAAE,CAAC;IAClC,OAAO,IAAI,EAAE,CAAC;QACV,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACvB,MAAM;QACV,CAAC;QAED,qEAAqE;QACrE,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,MAAM;QACV,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAA,0BAAmB,EAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,UAAU,GAAG,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;YACpD,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACV,CAAC;QAED,UAAU,IAAI,gBAAgB,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACH,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QAC1C,SAAS,EAAE,iBAAiB;KAC/B,CAAC;AACN,CAAC"}

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

@@ -1,22 +0,0 @@
-import type { AppNameComponents } from "@mongodb-js/mcp-types";
-export type { AppNameComponents };
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"connectionOptions.d.ts","sourceRoot":"","sources":["../../../src/helpers/connectionOptions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC;;;;;;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,CASjG"}

package/dist/cjs/helpers/connectionOptions.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setAppNameParamIfMissing = setAppNameParamIfMissing;
-exports.validateConnectionString = validateConnectionString;
-const mongodb_connection_string_url_1 = 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.ConnectionString(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.ConnectionString(connectionString, { looseValidation });
-    }
-    catch (error) {
-        throw new Error(`Invalid connection string with error: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-    }
-}
-//# sourceMappingURL=connectionOptions.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"connectionOptions.js","sourceRoot":"","sources":["../../../src/helpers/connectionOptions.ts"],"names":[],"mappings":";;AAaA,4DAyBC;AASD,4DASC;AAvDD,iFAAiE;AAKjE;;;;;;GAMG;AACI,KAAK,UAAU,wBAAwB,CAAC,EAC3C,gBAAgB,EAChB,UAAU,GAIb;IACG,MAAM,mBAAmB,GAAG,IAAI,gDAAgB,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,gDAAgB,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,EACjG,EAAE,KAAK,EAAE,KAAK,EAAE,CACnB,CAAC;IACN,CAAC;AACL,CAAC"}

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

@@ -1,39 +0,0 @@
-import { z } from "zod";
-/**
- * A cap for the maxTimeMS used for FindCursor.countDocuments.
- *
- * The number is relatively smaller because we expect the count documents query
- * to be finished sooner if not by the time the batch of documents is retrieved
- * so that count documents query don't hold the final response back.
- */
-export declare const QUERY_COUNT_MAX_TIME_MS_CAP: number;
-/**
- * A cap for the maxTimeMS used for counting resulting documents of an
- * aggregation.
- */
-export declare const AGG_COUNT_MAX_TIME_MS_CAP: number;
-export declare const ONE_MB: number;
-/**
- * The name of the `export` tool. Defined here (rather than referenced from the
- * `ExportTool` class) so tools such as `find`/`aggregate` can check for the
- * export tool's availability without importing `ExportTool`, which would create
- * a circular import (`export.ts` imports `MongoDBToolBase`, `FindArgs` and
- * `AggregateArgs`).
- */
-export declare const EXPORT_TOOL_NAME = "export";
-export declare const CURSOR_LIMIT_KEYS: z.ZodEnum<{
-    "config.maxDocumentsPerQuery": "config.maxDocumentsPerQuery";
-    "config.maxBytesPerQuery": "config.maxBytesPerQuery";
-    "tool.responseBytesLimit": "tool.responseBytesLimit";
-}>;
-export type CursorLimitKey = z.infer<typeof CURSOR_LIMIT_KEYS>;
-/**
- * A map of applied limit on cursors to a human-readable description that is
- * returned to the model.
- */
-export declare const CURSOR_LIMITS_TO_LLM_TEXT: {
-    readonly "config.maxDocumentsPerQuery": "the server's configured maximum number of documents";
-    readonly "config.maxBytesPerQuery": "the server's configured maximum response size";
-    readonly "tool.responseBytesLimit": "the responseBytesLimit parameter";
-};
-//# sourceMappingURL=constants.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/helpers/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAe,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAe,CAAC;AAExD,eAAO,MAAM,MAAM,EAAE,MAAwB,CAAC;AAE9C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;CAIa,CAAC"}

package/dist/cjs/helpers/constants.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CURSOR_LIMITS_TO_LLM_TEXT = exports.CURSOR_LIMIT_KEYS = exports.EXPORT_TOOL_NAME = exports.ONE_MB = exports.AGG_COUNT_MAX_TIME_MS_CAP = exports.QUERY_COUNT_MAX_TIME_MS_CAP = void 0;
-const zod_1 = require("zod");
-/**
- * A cap for the maxTimeMS used for FindCursor.countDocuments.
- *
- * The number is relatively smaller because we expect the count documents query
- * to be finished sooner if not by the time the batch of documents is retrieved
- * so that count documents query don't hold the final response back.
- */
-exports.QUERY_COUNT_MAX_TIME_MS_CAP = 10000;
-/**
- * A cap for the maxTimeMS used for counting resulting documents of an
- * aggregation.
- */
-exports.AGG_COUNT_MAX_TIME_MS_CAP = 60000;
-exports.ONE_MB = 1 * 1024 * 1024;
-/**
- * The name of the `export` tool. Defined here (rather than referenced from the
- * `ExportTool` class) so tools such as `find`/`aggregate` can check for the
- * export tool's availability without importing `ExportTool`, which would create
- * a circular import (`export.ts` imports `MongoDBToolBase`, `FindArgs` and
- * `AggregateArgs`).
- */
-exports.EXPORT_TOOL_NAME = "export";
-exports.CURSOR_LIMIT_KEYS = zod_1.z.enum([
-    "config.maxDocumentsPerQuery",
-    "config.maxBytesPerQuery",
-    "tool.responseBytesLimit",
-]);
-/**
- * A map of applied limit on cursors to a human-readable description that is
- * returned to the model.
- */
-exports.CURSOR_LIMITS_TO_LLM_TEXT = {
-    "config.maxDocumentsPerQuery": "the server's configured maximum number of documents",
-    "config.maxBytesPerQuery": "the server's configured maximum response size",
-    "tool.responseBytesLimit": "the responseBytesLimit parameter",
-};
-//# sourceMappingURL=constants.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/helpers/constants.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;;;;GAMG;AACU,QAAA,2BAA2B,GAAW,KAAM,CAAC;AAE1D;;;GAGG;AACU,QAAA,yBAAyB,GAAW,KAAM,CAAC;AAE3C,QAAA,MAAM,GAAW,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C;;;;;;GAMG;AACU,QAAA,gBAAgB,GAAG,QAAQ,CAAC;AAE5B,QAAA,iBAAiB,GAAG,OAAC,CAAC,IAAI,CAAC;IACpC,6BAA6B;IAC7B,yBAAyB;IACzB,yBAAyB;CAC5B,CAAC,CAAC;AAGH;;;GAGG;AACU,QAAA,yBAAyB,GAAG;IACrC,6BAA6B,EAAE,qDAAqD;IACpF,yBAAyB,EAAE,+CAA+C;IAC1E,yBAAyB,EAAE,kCAAkC;CACd,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,34 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-import type { IDeviceId } from "@mongodb-js/mcp-types";
-import type { LoggerBase } from "../common/logging/index.js";
-export declare const DEVICE_ID_TIMEOUT = 3000;
-export declare class DeviceId implements IDeviceId {
-    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

@@ -1 +0,0 @@
-{"version":3,"file":"deviceId.d.ts","sourceRoot":"","sources":["../../../src/helpers/deviceId.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,qBAAa,QAAS,YAAW,SAAS;IACtC,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

@@ -1,106 +0,0 @@
-"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 index_js_1 = require("../common/logging/index.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: index_js_1.LogId.deviceIdResolutionError,
-                    context: "deviceId",
-                    message: `Resolution error: ${String(error)}`,
-                });
-                break;
-            case "timeout":
-                this.logger.debug({
-                    id: index_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

@@ -1 +0,0 @@
-{"version":3,"file":"deviceId.js","sourceRoot":"","sources":["../../../src/helpers/deviceId.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,qDAAoD;AAGpD,yDAAmD;AAEtC,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,gBAAK,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,gBAAK,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/escapeMarkdown.d.ts

@@ -1,5 +0,0 @@
-/**
- * Escapes markdown and HTML metacharacters in a string.
- */
-export declare function escapeMarkdown(value: string): string;
-//# sourceMappingURL=escapeMarkdown.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"escapeMarkdown.d.ts","sourceRoot":"","sources":["../../../src/helpers/escapeMarkdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/cjs/helpers/escapeMarkdown.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.escapeMarkdown = escapeMarkdown;
-/**
- * Escapes markdown and HTML metacharacters in a string.
- */
-function escapeMarkdown(value) {
-    return value.replace(/[\\`*_{}[\]()<>#+\-.!|]/g, "\\$&");
-}
-//# sourceMappingURL=escapeMarkdown.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"escapeMarkdown.js","sourceRoot":"","sources":["../../../src/helpers/escapeMarkdown.ts"],"names":[],"mappings":";;AAGA,wCAEC;AALD;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,12 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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/getRandomUUID.d.ts

@@ -1,6 +0,0 @@
-/**
- * Generates a random UUID that works in both Node.js and browser environments.
- * Attempts to use Node.js crypto first, then falls back to Web Crypto API.
- */
-export declare function getRandomUUID(): string;
-//# sourceMappingURL=getRandomUUID.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"getRandomUUID.d.ts","sourceRoot":"","sources":["../../../src/helpers/getRandomUUID.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAoBtC"}

package/dist/cjs/helpers/getRandomUUID.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRandomUUID = getRandomUUID;
-const bson_1 = require("bson");
-/**
- * Generates a random UUID that works in both Node.js and browser environments.
- * Attempts to use Node.js crypto first, then falls back to Web Crypto API.
- */
-function getRandomUUID() {
-    try {
-        // Try Node.js crypto module first
-        // Using require to avoid import errors in browser environments
-        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/consistent-type-imports
-        const nodeCrypto = require("crypto");
-        return nodeCrypto.randomUUID();
-    }
-    catch {
-        // Fall back to Web Crypto API (available in browsers and modern Node.js)
-        if (typeof globalThis !== "undefined" &&
-            globalThis.crypto &&
-            typeof globalThis.crypto.randomUUID === "function") {
-            return globalThis.crypto.randomUUID();
-        }
-        // If neither is available, use the BSON UUID
-        return new bson_1.UUID().toString();
-    }
-}
-//# sourceMappingURL=getRandomUUID.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"getRandomUUID.js","sourceRoot":"","sources":["../../../src/helpers/getRandomUUID.ts"],"names":[],"mappings":";;AAKA,sCAoBC;AAzBD,+BAA4B;AAC5B;;;GAGG;AACH,SAAgB,aAAa;IACzB,IAAI,CAAC;QACD,kCAAkC;QAClC,+DAA+D;QAC/D,6GAA6G;QAC7G,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAA4B,CAAC;QAChE,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACL,yEAAyE;QACzE,IACI,OAAO,UAAU,KAAK,WAAW;YACjC,UAAU,CAAC,MAAM;YACjB,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,KAAK,UAAU,EACpD,CAAC;YACC,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC;QAED,6CAA6C;QAC7C,OAAO,IAAI,WAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;AACL,CAAC"}

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

@@ -1,23 +0,0 @@
-import type { Document } from "mongodb";
-import { type LoggerBase } from "../common/logging/index.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
- */
-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({ database, collection, operation, explainCallback, logger, }: {
-    database: string;
-    collection: string;
-    operation: string;
-    explainCallback: () => Promise<Document>;
-    logger: LoggerBase;
-}): Promise<void>;
-//# sourceMappingURL=indexCheck.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"indexCheck.d.ts","sourceRoot":"","sources":["../../../src/helpers/indexCheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;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,CAAC,EAClC,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,MAAM,GACT,EAAE;IACC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,EAAE,UAAU,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB"}

package/dist/cjs/helpers/indexCheck.js

@@ -1,73 +0,0 @@
-"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");
-const index_js_1 = require("../common/logging/index.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({ database, collection, operation, explainCallback, logger, }) {
-    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)
-        logger.warning({
-            id: index_js_1.LogId.mongodbIndexCheckFailure,
-            context: "Index Usage Check",
-            message: `Index check failed to execute explain for ${operation} on ${database}.${collection}: ${error instanceof Error ? error.message : String(error)}`,
-        });
-    }
-}
-//# sourceMappingURL=indexCheck.js.map