mongodb-mcp-server 0.2.0 → 0.3.1-prerelease.1

package/dist/esm/common/session.js

@@ -0,0 +1,100 @@
+import { ObjectId } from "bson";
+import { ApiClient } from "./atlas/apiClient.js";
+import { LogId } from "./logger.js";
+import EventEmitter from "events";
+import { ErrorCodes, MongoDBError } from "./errors.js";
+export class Session extends EventEmitter {
+    constructor({ apiBaseUrl, apiClientId, apiClientSecret, logger, connectionManager, exportsManager, keychain, }) {
+        super();
+        this.sessionId = new ObjectId().toString();
+        this.keychain = keychain;
+        this.logger = logger;
+        const credentials = apiClientId && apiClientSecret
+            ? {
+                clientId: apiClientId,
+                clientSecret: apiClientSecret,
+            }
+            : undefined;
+        this.apiClient = new ApiClient({ baseUrl: apiBaseUrl, credentials }, logger);
+        this.exportsManager = exportsManager;
+        this.connectionManager = connectionManager;
+        this.connectionManager.events.on("connection-success", () => this.emit("connect"));
+        this.connectionManager.events.on("connection-time-out", (error) => this.emit("connection-error", error));
+        this.connectionManager.events.on("connection-close", () => this.emit("disconnect"));
+        this.connectionManager.events.on("connection-error", (error) => this.emit("connection-error", error));
+    }
+    setMcpClient(mcpClient) {
+        if (!mcpClient) {
+            this.connectionManager.setClientName("unknown");
+            this.logger.debug({
+                id: LogId.serverMcpClientSet,
+                context: "session",
+                message: "MCP client info not found",
+            });
+        }
+        this.mcpClient = {
+            name: mcpClient?.name || "unknown",
+            version: mcpClient?.version || "unknown",
+            title: mcpClient?.title || "unknown",
+        };
+        // Set the client name on the connection manager for appName generation
+        this.connectionManager.setClientName(this.mcpClient.name || "unknown");
+    }
+    async disconnect() {
+        const atlasCluster = this.connectedAtlasCluster;
+        try {
+            await this.connectionManager.disconnect();
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.logger.error({
+                id: LogId.mongodbDisconnectFailure,
+                context: "session",
+                message: `Error closing service provider: ${error.message}`,
+            });
+        }
+        if (atlasCluster?.username && atlasCluster?.projectId) {
+            void this.apiClient
+                .deleteDatabaseUser({
+                params: {
+                    path: {
+                        groupId: atlasCluster.projectId,
+                        username: atlasCluster.username,
+                        databaseName: "admin",
+                    },
+                },
+            })
+                .catch((err) => {
+                const error = err instanceof Error ? err : new Error(String(err));
+                this.logger.error({
+                    id: LogId.atlasDeleteDatabaseUserFailure,
+                    context: "session",
+                    message: `Error deleting previous database user: ${error.message}`,
+                });
+            });
+        }
+    }
+    async close() {
+        await this.disconnect();
+        await this.apiClient.close();
+        await this.exportsManager.close();
+        this.emit("close");
+    }
+    async connectToMongoDB(settings) {
+        await this.connectionManager.connect({ ...settings });
+    }
+    get isConnectedToMongoDB() {
+        return this.connectionManager.currentConnectionState.tag === "connected";
+    }
+    get serviceProvider() {
+        if (this.isConnectedToMongoDB) {
+            const state = this.connectionManager.currentConnectionState;
+            return state.serviceProvider;
+        }
+        throw new MongoDBError(ErrorCodes.NotConnectedToMongoDB, "Not connected to MongoDB");
+    }
+    get connectedAtlasCluster() {
+        return this.connectionManager.currentConnectionState.connectedAtlasCluster;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/esm/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/esm/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/esm/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/esm/common/sessionStore.js

@@ -0,0 +1,95 @@
+import { LogId } from "./logger.js";
+import { setManagedTimeout } from "./managedTimeout.js";
+export 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: LogId.streamableHttpTransportSessionCloseNotificationFailure,
+                context: "sessionStore",
+                message: `session ${sessionId} not found, no notification delivered`,
+            });
+            return;
+        }
+        session.logger.info({
+            id: 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 = setManagedTimeout(async () => {
+            if (this.sessions[sessionId]) {
+                this.sessions[sessionId].logger.info({
+                    id: LogId.streamableHttpTransportSessionCloseNotification,
+                    context: "sessionStore",
+                    message: "Session closed due to inactivity",
+                });
+                await this.closeSession(sessionId);
+            }
+        }, this.idleTimeoutMS);
+        const notificationTimeout = 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: 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)));
+    }
+}
+//# sourceMappingURL=sessionStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.js","sourceRoot":"","sources":["../../../src/common/sessionStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,OAAO,YAAY;IAUrB,YACqB,aAAqB,EACrB,qBAA6B,EAC7B,MAAkB;QAFlB,kBAAa,GAAb,aAAa,CAAQ;QACrB,0BAAqB,GAArB,qBAAqB,CAAQ;QAC7B,WAAM,GAAN,MAAM,CAAY;QAZ/B,aAAQ,GAOZ,EAAE,CAAC;QAOH,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,qBAAqB,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,aAAa,IAAI,qBAAqB,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED,UAAU,CAAC,SAAiB;QACxB,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/C,CAAC;IAEO,YAAY,CAAC,SAAiB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QAED,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAE/B,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;IAC1C,CAAC;IAEO,gBAAgB,CAAC,SAAiB;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;gBAChB,EAAE,EAAE,KAAK,CAAC,sDAAsD;gBAChE,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,WAAW,SAAS,uCAAuC;aACvE,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAChB,EAAE,EAAE,KAAK,CAAC,+CAA+C;YACzD,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE,iDAAiD;SAC7D,CAAC,CAAC;IACP,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,SAAwC,EAAE,MAAkB;QACtF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,iBAAiB,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,IAAI,EAAE;YAC9C,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;oBACjC,EAAE,EAAE,KAAK,CAAC,+CAA+C;oBACzD,OAAO,EAAE,cAAc;oBACvB,OAAO,EAAE,kCAAkC;iBAC9C,CAAC,CAAC;gBAEH,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACvB,MAAM,mBAAmB,GAAG,iBAAiB,CACzC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EACtC,IAAI,CAAC,qBAAqB,CAC7B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG;YACvB,SAAS;YACT,YAAY;YACZ,mBAAmB;YACnB,MAAM;SACT,CAAC;IACN,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB,EAAE,iBAA0B,IAAI;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,YAAY,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,cAAc,EAAE,CAAC;YACjB,IAAI,CAAC;gBACD,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBACd,EAAE,EAAE,KAAK,CAAC,0CAA0C;oBACpD,OAAO,EAAE,yBAAyB;oBAClC,OAAO,EAAE,2BAA2B,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC7G,CAAC,CAAC;YACP,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACnG,CAAC;CACJ"}

package/dist/esm/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/esm/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/esm/helpers/connectionOptions.js

@@ -0,0 +1,39 @@
+import { ConnectionString } from "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
+ */
+export async function setAppNameParamIfMissing({ connectionString, components, }) {
+    const connectionStringUrl = new 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
+ */
+export function validateConnectionString(connectionString, looseValidation) {
+    try {
+        new ConnectionString(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/esm/helpers/connectionOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionOptions.js","sourceRoot":"","sources":["../../../src/helpers/connectionOptions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,EAC3C,gBAAgB,EAChB,UAAU,GAIb;IACG,MAAM,mBAAmB,GAAG,IAAI,gBAAgB,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,MAAM,UAAU,wBAAwB,CAAC,gBAAwB,EAAE,eAAwB;IACvF,IAAI,CAAC;QACD,IAAI,gBAAgB,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/esm/helpers/container.d.ts

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

package/dist/esm/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/esm/helpers/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../../src/helpers/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,IAAI,YAAiC,CAAC;AAEtC,MAAM,CAAC,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,EAAE,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/esm/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/esm/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/esm/helpers/deviceId.js

@@ -0,0 +1,69 @@
+import { getDeviceId } from "@mongodb-js/device-id";
+import { LogId } from "../common/logger.js";
+export const DEVICE_ID_TIMEOUT = 3000;
+export class DeviceId {
+    constructor(logger, timeout = DEVICE_ID_TIMEOUT) {
+        this.logger = logger;
+        this.timeout = timeout;
+        this.getMachineId = async () => {
+            const nodeMachineId = await import("node-machine-id");
+            const machineId = nodeMachineId.default?.machineId || nodeMachineId.machineId;
+            return machineId(true);
+        };
+        this.abortController = new AbortController();
+        this.deviceIdPromise = DeviceId.UnknownDeviceId;
+    }
+    initialize() {
+        this.deviceIdPromise = 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 ?? 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: LogId.deviceIdResolutionError,
+                    context: "deviceId",
+                    message: `Resolution error: ${String(error)}`,
+                });
+                break;
+            case "timeout":
+                this.logger.debug({
+                    id: 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;
+        }
+    }
+}
+DeviceId.UnknownDeviceId = Promise.resolve("unknown");
+//# sourceMappingURL=deviceId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceId.js","sourceRoot":"","sources":["../../../src/helpers/deviceId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC,MAAM,OAAO,QAAQ;IASjB,YAAoB,MAAkB,EAAE,UAAkB,iBAAiB;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,MAAM,MAAM,CAAC,iBAAiB,CAAC,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,WAAW,CAAC;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,iBAAiB,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,KAAK,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,KAAK,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;;AA7EuB,wBAAe,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

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

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

package/dist/esm/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/esm/helpers/generatePassword.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePassword.js","sourceRoot":"","sources":["../../../src/helpers/generatePassword.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,gBAAgB,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEhD,MAAM,CAAC,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/esm/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/esm/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/esm/helpers/indexCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCheck.js","sourceRoot":"","sources":["../../../src/helpers/indexCheck.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,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,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB,EAAE,SAAiB;IAC7F,OAAO,2BAA2B,SAAS,kBAAkB,QAAQ,IAAI,UAAU,2QAA2Q,CAAC;AACnW,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,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,YAAY,CAClB,UAAU,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,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,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/esm/index.d.ts

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

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

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

package/dist/esm/index.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+function enableFipsIfRequested() {
+    let fipsError;
+    const tlsFIPSMode = process.argv.includes("--tlsFIPSMode");
+    if (tlsFIPSMode) {
+        try {
+            // eslint-disable-next-line
+            require("crypto").setFips(1);
+        }
+        catch (err) {
+            fipsError ?? (fipsError = err);
+        }
+    }
+    if (tlsFIPSMode) {
+        if (!fipsError && !crypto.getFips()) {
+            fipsError = new Error("FIPS mode not enabled despite requested due to unknown error.");
+        }
+    }
+    if (fipsError) {
+        if (process.config.variables.node_shared_openssl) {
+            console.error("Could not enable FIPS mode. Please ensure that your system OpenSSL installation supports FIPS.");
+        }
+        else {
+            console.error("Could not enable FIPS mode. This installation does not appear to support FIPS.");
+        }
+        console.error("Error details:");
+        console.error(fipsError);
+        process.exit(1);
+    }
+}
+enableFipsIfRequested();
+import { ConsoleLogger, LogId } from "./common/logger.js";
+import { config } from "./common/config.js";
+import crypto from "crypto";
+import { packageInfo } from "./common/packageInfo.js";
+import { StdioRunner } from "./transports/stdio.js";
+import { StreamableHttpRunner } from "./transports/streamableHttp.js";
+import { systemCA } from "@mongodb-js/devtools-proxy-support";
+import { Keychain } from "./common/keychain.js";
+async function main() {
+    systemCA().catch(() => undefined); // load system CA asynchronously as in mongosh
+    assertHelpMode();
+    assertVersionMode();
+    const transportRunner = config.transport === "stdio"
+        ? new StdioRunner({
+            userConfig: config,
+        })
+        : new StreamableHttpRunner({
+            userConfig: config,
+        });
+    const shutdown = () => {
+        transportRunner.logger.info({
+            id: LogId.serverCloseRequested,
+            context: "server",
+            message: `Server close requested`,
+        });
+        transportRunner
+            .close()
+            .then(() => {
+            transportRunner.logger.info({
+                id: LogId.serverClosed,
+                context: "server",
+                message: `Server closed`,
+            });
+            process.exit(0);
+        })
+            .catch((error) => {
+            transportRunner.logger.error({
+                id: LogId.serverCloseFailure,
+                context: "server",
+                message: `Error closing server: ${error}`,
+            });
+            process.exit(1);
+        });
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGABRT", shutdown);
+    process.on("SIGTERM", shutdown);
+    process.on("SIGQUIT", shutdown);
+    try {
+        await transportRunner.start();
+    }
+    catch (error) {
+        transportRunner.logger.info({
+            id: LogId.serverCloseRequested,
+            context: "server",
+            message: `Closing server due to error: ${error}`,
+            noRedaction: true,
+        });
+        try {
+            await transportRunner.close();
+            transportRunner.logger.info({
+                id: LogId.serverClosed,
+                context: "server",
+                message: "Server closed",
+            });
+        }
+        catch (error) {
+            transportRunner.logger.error({
+                id: LogId.serverCloseFailure,
+                context: "server",
+                message: `Error closing server: ${error}`,
+            });
+        }
+        throw error;
+    }
+}
+main().catch((error) => {
+    // At this point, we may be in a very broken state, so we can't rely on the logger
+    // being functional. Instead, create a brand new ConsoleLogger and log the error
+    // to the console.
+    const logger = new ConsoleLogger(Keychain.root);
+    logger.emergency({
+        id: LogId.serverStartFailure,
+        context: "server",
+        message: `Fatal error running server: ${error}`,
+    });
+    process.exit(1);
+});
+function assertHelpMode() {
+    if (config.help) {
+        console.log("For usage information refer to the README.md:");
+        console.log("https://github.com/mongodb-js/mongodb-mcp-server?tab=readme-ov-file#quick-start");
+        process.exit(0);
+    }
+}
+function assertVersionMode() {
+    if (config.version) {
+        console.log(packageInfo.version);
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/lib.d.ts

@@ -0,0 +1,12 @@
+export { Server, type ServerOptions } from "./server.js";
+export { Session, type SessionOptions } from "./common/session.js";
+export { defaultUserConfig, type UserConfig } from "./common/config.js";
+export { LoggerBase, type LogPayload, type LoggerType, type LogLevel } from "./common/logger.js";
+export { StreamableHttpRunner } from "./transports/streamableHttp.js";
+export { ConnectionManager, type AnyConnectionState, type ConnectionState, type ConnectionStateDisconnected, type ConnectionStateErrored, type ConnectionManagerFactoryFn, } from "./common/connectionManager.js";
+export type { ConnectionErrorHandler, ConnectionErrorHandled, ConnectionErrorUnhandled, ConnectionErrorHandlerContext, } from "./common/connectionErrorHandler.js";
+export { ErrorCodes } from "./common/errors.js";
+export { Telemetry } from "./telemetry/telemetry.js";
+export { Keychain, registerGlobalSecretToRedact } from "./common/keychain.js";
+export type { Secret } from "./common/keychain.js";
+//# sourceMappingURL=lib.d.ts.map

package/dist/esm/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/lib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EACH,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,GAClC,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACR,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,GAChC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC"}