@himanshusinghs/mongodb-mcp-server 1.7.7 → 1.11.0-prerelease.2

package/dist/cjs/transports/base.js

@@ -39,7 +39,7 @@ const server_js_1 = require("../server.js");
 const session_js_1 = require("../common/session.js");
 const telemetry_js_1 = require("../telemetry/telemetry.js");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const logger_js_1 = require("../common/logger.js");
+const index_js_1 = require("../common/logging/index.js");
 const exportsManager_js_1 = require("../common/exportsManager.js");
 const deviceId_js_1 = require("../helpers/deviceId.js");
 const keychain_js_1 = require("../common/keychain.js");
@@ -47,12 +47,12 @@ const connectionManager_js_1 = require("../common/connectionManager.js");
 const connectionErrorHandler_js_1 = require("../common/connectionErrorHandler.js");
 const elicitation_js_1 = require("../elicitation.js");
 const atlasLocal_js_1 = require("../common/atlasLocal.js");
-const vectorSearchEmbeddingsManager_js_1 = require("../common/search/vectorSearchEmbeddingsManager.js");
 const configOverrides_js_1 = require("../common/config/configOverrides.js");
 const apiClient_js_1 = require("../common/atlas/apiClient.js");
 const apiClient_js_2 = require("../common/atlas/apiClient.js");
+const mcp_metrics_1 = require("@mongodb-js/mcp-metrics");
 class TransportRunnerBase {
-    constructor({ userConfig, createConnectionManager = connectionManager_js_1.defaultCreateConnectionManager, connectionErrorHandler = connectionErrorHandler_js_1.connectionErrorHandler, createAtlasLocalClient = atlasLocal_js_1.defaultCreateAtlasLocalClient, additionalLoggers = [], telemetryProperties = {}, tools, createSessionConfig, createApiClient = apiClient_js_2.defaultCreateApiClient, }) {
+    constructor({ userConfig, createConnectionManager = connectionManager_js_1.defaultCreateConnectionManager, connectionErrorHandler = connectionErrorHandler_js_1.connectionErrorHandler, createAtlasLocalClient = atlasLocal_js_1.defaultCreateAtlasLocalClient, additionalLoggers = [], metrics, telemetryProperties = {}, tools, createSessionConfig, createApiClient = apiClient_js_2.defaultCreateApiClient, }) {
         this.userConfig = userConfig;
         this.createConnectionManager = createConnectionManager;
         this.connectionErrorHandler = connectionErrorHandler;
@@ -61,19 +61,20 @@ class TransportRunnerBase {
         this.tools = tools;
         this.createSessionConfig = createSessionConfig;
         this.createApiClient = createApiClient;
+        this.metrics = metrics ?? new mcp_metrics_1.PrometheusMetrics({ definitions: (0, mcp_metrics_1.createDefaultMetrics)() });
         const loggers = [...additionalLoggers];
         if (this.userConfig.loggers.includes("stderr")) {
-            loggers.push(new logger_js_1.ConsoleLogger(keychain_js_1.Keychain.root));
+            loggers.push(new index_js_1.ConsoleLogger(keychain_js_1.Keychain.root));
         }
         if (this.userConfig.loggers.includes("disk")) {
-            loggers.push(new logger_js_1.DiskLogger(this.userConfig.logPath, (err) => {
+            loggers.push(new index_js_1.DiskLogger(this.userConfig.logPath, (err) => {
                 // If the disk logger fails to initialize, we log the error to stderr and exit
                 // eslint-disable-next-line no-console
                 console.error("Error initializing disk logger:", err);
                 process.exit(1);
             }, keychain_js_1.Keychain.root));
         }
-        this.logger = new logger_js_1.CompositeLogger(...loggers);
+        this.logger = new index_js_1.CompositeLogger(...loggers);
         this.deviceId = deviceId_js_1.DeviceId.create(this.logger);
     }
     /**
@@ -83,7 +84,7 @@ class TransportRunnerBase {
      * @param config - Configuration object containing userConfig and optional serverOptions
      * @returns A configured Server instance
      */
-    async createServer({ userConfig = this.userConfig, serverOptions, sessionOptions, logger = new logger_js_1.CompositeLogger(this.logger), } = {}) {
+    async createServer({ userConfig = this.userConfig, serverOptions, sessionOptions, logger = new index_js_1.CompositeLogger(this.logger), } = {}) {
         const mcpServer = new mcp_js_1.McpServer({
             name: packageInfo_js_1.packageInfo.mcpServerName,
             version: packageInfo_js_1.packageInfo.version,
@@ -93,15 +94,17 @@ class TransportRunnerBase {
         const exportsManager = exportsManager_js_1.ExportsManager.init(userConfig, logger);
         const connectionManager = sessionOptions?.connectionManager ??
             (await this.createConnectionManager({ logger: logger, deviceId: this.deviceId, userConfig }));
-        const apiClient = userConfig.apiClientId && userConfig.apiClientSecret
-            ? new apiClient_js_1.ApiClient({
-                baseUrl: userConfig.apiBaseUrl,
-                credentials: {
-                    clientId: userConfig.apiClientId,
-                    clientSecret: userConfig.apiClientSecret,
-                },
-            }, logger)
-            : undefined;
+        const { apiClientId, apiClientSecret } = userConfig;
+        const apiClientOptions = {
+            baseUrl: userConfig.apiBaseUrl,
+            credentials: apiClientId && apiClientSecret
+                ? {
+                    clientId: apiClientId,
+                    clientSecret: apiClientSecret,
+                }
+                : undefined,
+        };
+        const apiClient = new apiClient_js_1.ApiClient(apiClientOptions, logger);
         const session = new session_js_1.Session({
             userConfig,
             atlasLocalClient: sessionOptions?.atlasLocalClient ?? (await this.createAtlasLocalClient({ logger: this.logger })),
@@ -110,11 +113,24 @@ class TransportRunnerBase {
             exportsManager,
             connectionManager,
             keychain: keychain_js_1.Keychain.root,
-            vectorSearchEmbeddingsManager: new vectorSearchEmbeddingsManager_js_1.VectorSearchEmbeddingsManager(userConfig, connectionManager),
             apiClient: sessionOptions?.apiClient ?? apiClient,
         });
-        const telemetry = telemetry_js_1.Telemetry.create(session, userConfig, this.deviceId, {
-            commonProperties: serverOptions?.telemetryProperties ?? this.telemetryProperties,
+        const telemetry = telemetry_js_1.Telemetry.create({
+            logger,
+            deviceId: this.deviceId,
+            apiClient: session.apiClient,
+            keychain: session.keychain,
+            enabled: userConfig.telemetry === "enabled",
+            getCommonProperties: () => ({
+                ...(serverOptions?.telemetryProperties ?? this.telemetryProperties),
+                transport: userConfig.transport,
+                mcp_client_version: session.mcpClient?.version,
+                mcp_client_name: session.mcpClient?.name,
+                session_id: session.sessionId,
+                config_atlas_auth: session.apiClient?.isAuthConfigured() ? "true" : "false",
+                config_connection_string: userConfig.connectionString ? "true" : "false",
+                has_docker: session.atlasLocalClient ? "true" : "false",
+            }),
         });
         let uiRegistry = serverOptions?.uiRegistry;
         if (!uiRegistry && userConfig.previewFeatures.includes("mcpUI")) {
@@ -131,11 +147,12 @@ class TransportRunnerBase {
             tools: serverOptions?.tools ?? this.tools,
             uiRegistry,
             toolContext: serverOptions?.toolContext,
+            metrics: this.metrics,
         });
         // We need to create the MCP logger after the server is constructed
         // because it needs the server instance
         if (userConfig.loggers.includes("mcp")) {
-            logger.addLogger(new logger_js_1.McpLogger(result, keychain_js_1.Keychain.root));
+            logger.addLogger(new index_js_1.McpLogger(result, keychain_js_1.Keychain.root));
         }
         return result;
     }

package/dist/cjs/transports/base.js.map

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

package/dist/cjs/transports/expressBasedHttpServer.d.ts

@@ -0,0 +1,24 @@
+import express from "express";
+import type http from "http";
+import type { LoggerBase } from "../lib.js";
+export type ExpressConfig = {
+    port: number;
+    hostname: string;
+};
+/** @internal */
+export declare abstract class ExpressBasedHttpServer {
+    protected httpServer: http.Server | undefined;
+    protected app: express.Express;
+    protected readonly logger: LoggerBase;
+    protected readonly logContext: string;
+    protected readonly expressConfig: ExpressConfig;
+    constructor(config: {
+        logger: LoggerBase;
+        logContext: string;
+    } & ExpressConfig);
+    get serverAddress(): string;
+    protected abstract setupRoutes(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=expressBasedHttpServer.d.ts.map

package/dist/cjs/transports/expressBasedHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressBasedHttpServer.d.ts","sourceRoot":"","sources":["../../../src/transports/expressBasedHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,gBAAgB;AAChB,8BAAsB,sBAAsB;IACxC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IAE/B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;gBAEpC,MAAM,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;IAS9E,IAAW,aAAa,IAAI,MAAM,CAUjC;IAED,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAgCrC"}

package/dist/cjs/transports/expressBasedHttpServer.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressBasedHttpServer = void 0;
+const express_1 = __importDefault(require("express"));
+const loggingDefinitions_js_1 = require("../common/logging/loggingDefinitions.js");
+/** @internal */
+class ExpressBasedHttpServer {
+    constructor(config) {
+        this.app = (0, express_1.default)();
+        this.app.enable("trust proxy"); // needed for reverse proxy support
+        this.expressConfig = { port: config.port, hostname: config.hostname };
+        this.logger = config.logger;
+        this.logContext = config.logContext;
+    }
+    get serverAddress() {
+        const result = this.httpServer?.address();
+        if (typeof result === "string") {
+            return result;
+        }
+        if (typeof result === "object" && result) {
+            return `http://${result.address}:${result.port}`;
+        }
+        throw new Error("Server is not started yet");
+    }
+    async start() {
+        await this.setupRoutes();
+        const { port, hostname } = this.expressConfig;
+        this.httpServer = await new Promise((resolve, reject) => {
+            const result = this.app.listen(port, hostname, (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve(result);
+                }
+            });
+        });
+        this.logger.info({
+            message: `Http server started on address: ${this.serverAddress}`,
+            context: this.logContext,
+            noRedaction: true,
+            id: loggingDefinitions_js_1.LogId.httpServerStarted,
+        });
+    }
+    async stop() {
+        if (this.httpServer) {
+            this.logger.info({
+                message: "Stopping server...",
+                context: this.logContext,
+                id: loggingDefinitions_js_1.LogId.httpServerStopping,
+            });
+            const server = this.httpServer;
+            await new Promise((resolve, reject) => {
+                server.close((err) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve(undefined);
+                    }
+                });
+            });
+            this.logger.info({
+                message: "Server stopped",
+                context: this.logContext,
+                id: loggingDefinitions_js_1.LogId.httpServerStopped,
+            });
+        }
+        else {
+            this.logger.info({
+                message: "Server is not running",
+                context: this.logContext,
+                id: loggingDefinitions_js_1.LogId.httpServerStopped,
+            });
+        }
+    }
+}
+exports.ExpressBasedHttpServer = ExpressBasedHttpServer;
+//# sourceMappingURL=expressBasedHttpServer.js.map

package/dist/cjs/transports/expressBasedHttpServer.js.map

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

package/dist/cjs/transports/jsonRpcErrorCodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JSON-RPC error codes for the MCP HTTP server.
+ * These are defined in a separate module to avoid circular dependencies
+ * between streamableHttp.ts and mcpHttpServer.ts.
+ */
+export declare const JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED = -32000;
+export declare const JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED = -32001;
+export declare const JSON_RPC_ERROR_CODE_SESSION_ID_INVALID = -32002;
+export declare const JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND = -32003;
+export declare const JSON_RPC_ERROR_CODE_INVALID_REQUEST = -32004;
+export declare const JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION = -32005;
+//# sourceMappingURL=jsonRpcErrorCodes.d.ts.map

package/dist/cjs/transports/jsonRpcErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRpcErrorCodes.d.ts","sourceRoot":"","sources":["../../../src/transports/jsonRpcErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,6CAA6C,SAAS,CAAC;AACpE,eAAO,MAAM,uCAAuC,SAAS,CAAC;AAC9D,eAAO,MAAM,sCAAsC,SAAS,CAAC;AAC7D,eAAO,MAAM,qCAAqC,SAAS,CAAC;AAC5D,eAAO,MAAM,mCAAmC,SAAS,CAAC;AAC1D,eAAO,MAAM,+CAA+C,SAAS,CAAC"}

package/dist/cjs/transports/jsonRpcErrorCodes.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * JSON-RPC error codes for the MCP HTTP server.
+ * These are defined in a separate module to avoid circular dependencies
+ * between streamableHttp.ts and mcpHttpServer.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION = exports.JSON_RPC_ERROR_CODE_INVALID_REQUEST = exports.JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND = exports.JSON_RPC_ERROR_CODE_SESSION_ID_INVALID = exports.JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED = exports.JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED = void 0;
+exports.JSON_RPC_ERROR_CODE_PROCESSING_REQUEST_FAILED = -32000;
+exports.JSON_RPC_ERROR_CODE_SESSION_ID_REQUIRED = -32001;
+exports.JSON_RPC_ERROR_CODE_SESSION_ID_INVALID = -32002;
+exports.JSON_RPC_ERROR_CODE_SESSION_NOT_FOUND = -32003;
+exports.JSON_RPC_ERROR_CODE_INVALID_REQUEST = -32004;
+exports.JSON_RPC_ERROR_CODE_DISALLOWED_EXTERNAL_SESSION = -32005;
+//# sourceMappingURL=jsonRpcErrorCodes.js.map

package/dist/cjs/transports/jsonRpcErrorCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonRpcErrorCodes.js","sourceRoot":"","sources":["../../../src/transports/jsonRpcErrorCodes.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,6CAA6C,GAAG,CAAC,KAAK,CAAC;AACvD,QAAA,uCAAuC,GAAG,CAAC,KAAK,CAAC;AACjD,QAAA,sCAAsC,GAAG,CAAC,KAAK,CAAC;AAChD,QAAA,qCAAqC,GAAG,CAAC,KAAK,CAAC;AAC/C,QAAA,mCAAmC,GAAG,CAAC,KAAK,CAAC;AAC7C,QAAA,+CAA+C,GAAG,CAAC,KAAK,CAAC"}

package/dist/cjs/transports/mcpHttpServer.d.ts

@@ -0,0 +1,61 @@
+import { type StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { type UserConfig, type ISessionStore, type Metrics, type DefaultMetrics, type Server, type LoggerBase } from "../lib.js";
+import type { CustomizableServerOptions, CustomizableSessionOptions, TransportRequestContext } from "./base.js";
+import { ExpressBasedHttpServer } from "./expressBasedHttpServer.js";
+export type MCPHttpServerConstructorArgs<TUserConfig extends UserConfig = UserConfig, TContext = unknown> = {
+    userConfig: TUserConfig;
+    createServerForRequest: (createParams: {
+        request: TransportRequestContext;
+        serverOptions?: CustomizableServerOptions<TUserConfig, TContext>;
+        sessionOptions?: CustomizableSessionOptions<TUserConfig>;
+    }) => Promise<Server<TUserConfig, TContext>>;
+    logger: LoggerBase;
+    serverOptions?: CustomizableServerOptions<TUserConfig, TContext>;
+    sessionOptions?: CustomizableSessionOptions<TUserConfig>;
+    metrics: Metrics<DefaultMetrics>;
+    sessionStore: ISessionStore<StreamableHTTPServerTransport>;
+};
+export declare class MCPHttpServer<TUserConfig extends UserConfig = UserConfig, TContext = unknown> extends ExpressBasedHttpServer {
+    protected readonly sessionStore: ISessionStore<StreamableHTTPServerTransport>;
+    private readonly serverOptions?;
+    private readonly sessionOptions?;
+    protected readonly userConfig: TUserConfig;
+    private readonly metrics;
+    private readonly pendingInitializations;
+    private createServerForRequest;
+    constructor({ userConfig, createServerForRequest, serverOptions, sessionOptions, logger, metrics, sessionStore, }: MCPHttpServerConstructorArgs<TUserConfig, TContext>);
+    stop(): Promise<void>;
+    private reportSessionError;
+    private startKeepAliveLoop;
+    /**
+     * Ensures the session for the given sessionId is initialized, serializing
+     * concurrent initialization attempts so only one runs at a time.
+     *
+     * If a session already exists in the store, this is a no-op.
+     * If another request is already initializing this session, this call waits
+     * for that initialization to complete.
+     * Otherwise, this call performs the initialization.
+     *
+     * After this method resolves, the caller should look up the transport from
+     * the session store via `sessionStore.getSession()`.
+     *
+     * When `isImplicitInitialization` is true, the transport is pre-configured as
+     * initialized (bypassing the MCP initialize handshake) so that it can handle
+     * non-initialize requests immediately. When false, the transport is left in
+     * its default state so it can process the initialize request normally.
+     */
+    private ensureSessionInitialized;
+    protected setupMiddlewares(): void;
+    protected setupRoutes(): Promise<void>;
+    private withErrorHandling;
+}
+/**
+ * A function to create a custom MCPHttpServer instance.
+ * When provided, the runner will use this function instead of the default MCPHttpServer constructor.
+ */
+export type CreateMcpHttpServerFn<TUserConfig extends UserConfig = UserConfig, TContext = unknown> = (args: MCPHttpServerConstructorArgs<TUserConfig, TContext>) => MCPHttpServer<TUserConfig, TContext>;
+/**
+ * Creates a default MCPHttpServer instance from the provided constructor arguments.
+ */
+export declare const createDefaultMcpHttpServer: <TUserConfig extends UserConfig = UserConfig, TContext = unknown>(args: MCPHttpServerConstructorArgs<TUserConfig, TContext>) => MCPHttpServer<TUserConfig, TContext>;
+//# sourceMappingURL=mcpHttpServer.d.ts.map

package/dist/cjs/transports/mcpHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpHttpServer.d.ts","sourceRoot":"","sources":["../../../src/transports/mcpHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAKxG,OAAO,EACH,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,MAAM,EACX,KAAK,UAAU,EAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAChH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAUrE,MAAM,MAAM,4BAA4B,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,IAAI;IACxG,UAAU,EAAE,WAAW,CAAC;IACxB,sBAAsB,EAAE,CAAC,YAAY,EAAE;QACnC,OAAO,EAAE,uBAAuB,CAAC;QACjC,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;KAC5D,KAAK,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjE,cAAc,CAAC,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,YAAY,EAAE,aAAa,CAAC,6BAA6B,CAAC,CAAC;CAC9D,CAAC;AAEF,qBAAa,aAAa,CACtB,WAAW,SAAS,UAAU,GAAG,UAAU,EAC3C,QAAQ,GAAG,OAAO,CACpB,SAAQ,sBAAsB;IAC5B,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,6BAA6B,CAAC,CAAC;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAmD;IAClF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA0C;IAC1E,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAE3E,OAAO,CAAC,sBAAsB,CAIe;gBAEjC,EACR,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,MAAM,EACN,OAAO,EACP,YAAY,GACf,EAAE,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC;IAezC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,kBAAkB;IA+C1B;;;;;;;;;;;;;;;;OAgBG;YACW,wBAAwB;IA4HtC,SAAS,CAAC,gBAAgB,IAAI,IAAI;cAgBT,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA4FrD,OAAO,CAAC,iBAAiB;CAuB5B;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,IAAI,CACjG,IAAI,EAAE,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC,KACxD,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,0BAA0B,GAAI,WAAW,SAAS,UAAU,GAAG,UAAU,EAAE,QAAQ,GAAG,OAAO,EACtG,MAAM,4BAA4B,CAAC,WAAW,EAAE,QAAQ,CAAC,KAC1D,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAmD,CAAC"}