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

package/dist/cjs/common/logging/nullLogger.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NullLogger = void 0;
-const loggerBase_js_1 = require("./loggerBase.js");
-class NullLogger extends loggerBase_js_1.LoggerBase {
-    constructor() {
-        super(undefined);
-    }
-    logCore() {
-        // No-op logger, does not log anything
-    }
-}
-exports.NullLogger = NullLogger;
-//# sourceMappingURL=nullLogger.js.map

package/dist/cjs/common/logging/nullLogger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"nullLogger.js","sourceRoot":"","sources":["../../../../src/common/logging/nullLogger.ts"],"names":[],"mappings":";;;AACA,mDAA6C;AAE7C,MAAa,UAAW,SAAQ,0BAAU;IAGtC;QACI,KAAK,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;IAES,OAAO;QACb,sCAAsC;IAC1C,CAAC;CACJ;AAVD,gCAUC"}

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

@@ -1,7 +0,0 @@
-export interface ManagedTimeout {
-    cancel: () => void;
-    restart: () => void;
-}
-export declare function setManagedTimeout(callback: () => Promise<void> | void, timeoutMS: number): ManagedTimeout;
-export declare function sleep(ms: number): Promise<void>;
-//# sourceMappingURL=managedTimeout.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"managedTimeout.d.ts","sourceRoot":"","sources":["../../../src/common/managedTimeout.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAqBzG;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/cjs/common/managedTimeout.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setManagedTimeout = setManagedTimeout;
-exports.sleep = sleep;
-function setManagedTimeout(callback, timeoutMS) {
-    let timeoutId = setTimeout(() => {
-        void callback();
-    }, timeoutMS);
-    function cancel() {
-        clearTimeout(timeoutId);
-        timeoutId = undefined;
-    }
-    function restart() {
-        cancel();
-        timeoutId = setTimeout(() => {
-            void callback();
-        }, timeoutMS);
-    }
-    return {
-        cancel,
-        restart,
-    };
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-//# sourceMappingURL=managedTimeout.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"managedTimeout.js","sourceRoot":"","sources":["../../../src/common/managedTimeout.ts"],"names":[],"mappings":";;AAKA,8CAqBC;AAED,sBAEC;AAzBD,SAAgB,iBAAiB,CAAC,QAAoC,EAAE,SAAiB;IACrF,IAAI,SAAS,GAA+B,UAAU,CAAC,GAAG,EAAE;QACxD,KAAK,QAAQ,EAAE,CAAC;IACpB,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,SAAS,MAAM;QACX,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,SAAS,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,SAAS,OAAO;QACZ,MAAM,EAAE,CAAC;QACT,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YACxB,KAAK,QAAQ,EAAE,CAAC;QACpB,CAAC,EAAE,SAAS,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACH,MAAM;QACN,OAAO;KACV,CAAC;AACN,CAAC;AAED,SAAgB,KAAK,CAAC,EAAU;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC"}

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

@@ -1,26 +0,0 @@
-/**
- * A matched `fetch`/`Request` pair. Both must come from the same implementation:
- * a `Request` built by one implementation is not recognized as a `Request` by
- * another and gets coerced to a string, producing a bogus URL.
- */
-export type HttpClient = {
-    fetch: typeof fetch;
-    Request: typeof globalThis.Request;
-};
-/**
- * Process-wide memoized `fetch`. In Node it is backed by
- * devtools-proxy-support's `createFetch` (env-var proxy config + system-CA
- * trust); elsewhere it falls back to the platform `fetch`.
- *
- * Memoized because `createFetch` builds a fresh multi-hundred-KB system-CA
- * string and a proxy Agent that accumulates over time with as many calls to
- * createFetch. Our current usage can safely utilize a shared fetch instance so
- * we memoize it.
- */
-export declare function getSharedProxyFetch(): typeof fetch;
-/**
- * The `HttpClient` used when an embedder doesn't provide one: the shared
- * proxy-aware `fetch` paired with the `Request` implementation it understands.
- */
-export declare function getDefaultHttpClient(): HttpClient;
-//# sourceMappingURL=proxyFetch.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"proxyFetch.d.ts","sourceRoot":"","sources":["../../../src/common/proxyFetch.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;CACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,KAAK,CAqBlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAQjD"}

package/dist/cjs/common/proxyFetch.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSharedProxyFetch = getSharedProxyFetch;
-exports.getDefaultHttpClient = getDefaultHttpClient;
-const devtools_proxy_support_1 = require("@mongodb-js/devtools-proxy-support");
-const node_fetch_1 = require("node-fetch");
-const isNodeRuntime_js_1 = require("../helpers/isNodeRuntime.js");
-let sharedProxyFetch;
-/**
- * Process-wide memoized `fetch`. In Node it is backed by
- * devtools-proxy-support's `createFetch` (env-var proxy config + system-CA
- * trust); elsewhere it falls back to the platform `fetch`.
- *
- * Memoized because `createFetch` builds a fresh multi-hundred-KB system-CA
- * string and a proxy Agent that accumulates over time with as many calls to
- * createFetch. Our current usage can safely utilize a shared fetch instance so
- * we memoize it.
- */
-function getSharedProxyFetch() {
-    if (sharedProxyFetch === undefined) {
-        // In Node we use `createFetch` from devtools-proxy-support to pick up
-        // environment-variable proxy configuration and system CA trust, and we
-        // use node-fetch's Request since its interface is a superset of the web
-        // Request. In the browser those Node-only concerns don't apply and the
-        // implementations aren't available, so we fall back to the native
-        // `fetch`/`Request` globals. createFetch assumes that the first
-        // parameter of fetch is always a string with the URL. However, fetch
-        // can also receive a Request object. While the typechecking complains,
-        // createFetch does passthrough the parameters so it works fine. That
-        // said, node-fetch has incompatibilities with the web version of fetch
-        // and can lead to genuine issues so we would like to move away of
-        // node-fetch dependency.
-        sharedProxyFetch = (0, isNodeRuntime_js_1.isNodeRuntime)()
-            ? (0, devtools_proxy_support_1.createFetch)({
-                useEnvironmentVariableProxies: true,
-            })
-            : globalThis.fetch.bind(globalThis);
-    }
-    return sharedProxyFetch;
-}
-/**
- * The `HttpClient` used when an embedder doesn't provide one: the shared
- * proxy-aware `fetch` paired with the `Request` implementation it understands.
- */
-function getDefaultHttpClient() {
-    return {
-        fetch: getSharedProxyFetch(),
-        // NodeFetchRequest has more overloadings than the native Request so it
-        // complains here. However, the interfaces are actually compatible so
-        // it's not a real problem, just a type checking problem.
-        Request: ((0, isNodeRuntime_js_1.isNodeRuntime)() ? node_fetch_1.Request : globalThis.Request),
-    };
-}
-//# sourceMappingURL=proxyFetch.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"proxyFetch.js","sourceRoot":"","sources":["../../../src/common/proxyFetch.ts"],"names":[],"mappings":";;AA0BA,kDAqBC;AAMD,oDAQC;AA7DD,+EAAiE;AACjE,2CAAyD;AACzD,kEAA4D;AAE5D,IAAI,gBAA0C,CAAC;AAY/C;;;;;;;;;GASG;AACH,SAAgB,mBAAmB;IAC/B,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACjC,sEAAsE;QACtE,uEAAuE;QACvE,wEAAwE;QACxE,uEAAuE;QACvE,kEAAkE;QAClE,gEAAgE;QAChE,qEAAqE;QACrE,uEAAuE;QACvE,qEAAqE;QACrE,uEAAuE;QACvE,kEAAkE;QAClE,yBAAyB;QACzB,gBAAgB,GAAG,IAAA,gCAAa,GAAE;YAC9B,CAAC,CAAE,IAAA,oCAAW,EAAC;gBACT,6BAA6B,EAAE,IAAI;aACtC,CAA6B;YAChC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAChC,OAAO;QACH,KAAK,EAAE,mBAAmB,EAAE;QAC5B,uEAAuE;QACvE,qEAAqE;QACrE,yDAAyD;QACzD,OAAO,EAAE,CAAC,IAAA,gCAAa,GAAE,CAAC,CAAC,CAAC,oBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAyC;KAC7G,CAAC;AACN,CAAC"}

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

@@ -1,5 +0,0 @@
-export declare const previewFeatureValues: readonly ["mcpUI"];
-export type PreviewFeature = (typeof previewFeatureValues)[number];
-export declare const monitoringServerFeatureValues: readonly ["health-check", "metrics"];
-export type MonitoringServerFeature = (typeof monitoringServerFeatureValues)[number];
-//# sourceMappingURL=schemas.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/common/schemas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,oBAAqB,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,6BAA6B,sCAAuC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/cjs/common/schemas.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.monitoringServerFeatureValues = exports.previewFeatureValues = void 0;
-exports.previewFeatureValues = ["mcpUI"];
-exports.monitoringServerFeatureValues = ["health-check", "metrics"];
-//# sourceMappingURL=schemas.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/common/schemas.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,CAAC,OAAO,CAAU,CAAC;AAG1C,QAAA,6BAA6B,GAAG,CAAC,cAAc,EAAE,SAAS,CAAU,CAAC"}

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

@@ -1,48 +0,0 @@
-import type { ApiClient } from "./atlas/apiClient.js";
-import type { Implementation } from "@modelcontextprotocol/sdk/types.js";
-import type { CompositeLogger } from "./logging/index.js";
-import EventEmitter from "events";
-import type { ExportsManager } from "./exportsManager.js";
-import type { Client } from "@mongodb-js/atlas-local";
-import type { Keychain } from "./keychain.js";
-import { type ConnectionErrorHandler } from "./connectionErrorHandler.js";
-import type { ConnectionRegistry } from "./connectionRegistry.js";
-export interface SessionOptions {
-    logger: CompositeLogger;
-    exportsManager: ExportsManager;
-    connectionRegistry: ConnectionRegistry;
-    keychain: Keychain;
-    atlasLocalClient?: Client;
-    connectionErrorHandler: ConnectionErrorHandler;
-    apiClient: ApiClient;
-}
-export type SessionEvents = {
-    close: [];
-};
-/**
- * Per-MCP-session context: logging, exports, Atlas API access, and secrets.
- *
- * MongoDB connection state is deliberately NOT session-scoped — it lives in the
- * app-level {@link ConnectionRegistry} (shared across sessions) and is addressed
- * by the `connectionId` tool argument. The registry reference here is dependency
- * plumbing, not state.
- */
-export declare class Session extends EventEmitter<SessionEvents> {
-    readonly sessionId: string;
-    readonly exportsManager: ExportsManager;
-    readonly connectionRegistry: ConnectionRegistry;
-    readonly apiClient: ApiClient;
-    readonly atlasLocalClient?: Client;
-    readonly keychain: Keychain;
-    readonly connectionErrorHandler: ConnectionErrorHandler;
-    mcpClient?: {
-        name?: string;
-        version?: string;
-        title?: string;
-    };
-    readonly logger: CompositeLogger;
-    constructor({ logger, connectionRegistry, exportsManager, keychain, atlasLocalClient, connectionErrorHandler, apiClient, }: SessionOptions);
-    setMcpClient(mcpClient: Implementation | undefined): void;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=session.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/common/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,SAAS,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG;IACxB,KAAK,EAAE,EAAE,CAAC;CACb,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,OAAQ,SAAQ,YAAY,CAAC,aAAa,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAA6B;IACvD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IAExD,SAAS,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,SAAgB,MAAM,EAAE,eAAe,CAAC;gBAE5B,EACR,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,GACZ,EAAE,cAAc;IAYjB,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAgBnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/cjs/common/session.js

@@ -1,54 +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.Session = void 0;
-const bson_1 = require("bson");
-const index_js_1 = require("./logging/index.js");
-const events_1 = __importDefault(require("events"));
-/**
- * Per-MCP-session context: logging, exports, Atlas API access, and secrets.
- *
- * MongoDB connection state is deliberately NOT session-scoped — it lives in the
- * app-level {@link ConnectionRegistry} (shared across sessions) and is addressed
- * by the `connectionId` tool argument. The registry reference here is dependency
- * plumbing, not state.
- */
-class Session extends events_1.default {
-    constructor({ logger, connectionRegistry, exportsManager, keychain, atlasLocalClient, connectionErrorHandler, apiClient, }) {
-        super();
-        this.sessionId = new bson_1.ObjectId().toString();
-        this.keychain = keychain;
-        this.logger = logger;
-        this.apiClient = apiClient;
-        this.atlasLocalClient = atlasLocalClient;
-        this.exportsManager = exportsManager;
-        this.connectionRegistry = connectionRegistry;
-        this.connectionErrorHandler = connectionErrorHandler;
-    }
-    setMcpClient(mcpClient) {
-        if (!mcpClient) {
-            this.logger.debug({
-                id: index_js_1.LogId.serverMcpClientSet,
-                context: "session",
-                message: "MCP client info not found",
-            });
-        }
-        this.mcpClient = {
-            name: mcpClient?.name || "unknown",
-            version: mcpClient?.version || "unknown",
-            title: mcpClient?.title || "unknown",
-        };
-    }
-    async close() {
-        // Close the registry before the API client: revoking
-        // Atlas entries deletes their temporary database users through it.
-        await this.connectionRegistry.close().catch(() => undefined);
-        await this.apiClient?.close();
-        await this.exportsManager.close();
-        this.emit("close");
-    }
-}
-exports.Session = Session;
-//# sourceMappingURL=session.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/common/session.ts"],"names":[],"mappings":";;;;;;AAAA,+BAAgC;AAIhC,iDAA2C;AAC3C,oDAAkC;AAqBlC;;;;;;;GAOG;AACH,MAAa,OAAQ,SAAQ,gBAA2B;IAiBpD,YAAY,EACR,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,sBAAsB,EACtB,SAAS,GACI;QACb,KAAK,EAAE,CAAC;QAzBH,cAAS,GAAW,IAAI,eAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;QA2BnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,SAAqC;QAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACd,EAAE,EAAE,gBAAK,CAAC,kBAAkB;gBAC5B,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,2BAA2B;aACvC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,CAAC,SAAS,GAAG;YACb,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,SAAS;YAClC,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,SAAS;YACxC,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,SAAS;SACvC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK;QACP,qDAAqD;QACrD,mEAAmE;QACnE,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;CACJ;AA7DD,0BA6DC"}

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

@@ -1,176 +0,0 @@
-import type { ClientCapabilities, Implementation } from "@modelcontextprotocol/sdk/types.js";
-import type { LoggerBase } from "./logging/index.js";
-import type { Session } from "./session.js";
-import type { Metrics, DefaultMetrics } from "@mongodb-js/mcp-metrics";
-import type { CloseableTransport, SessionCloseReason } from "@mongodb-js/mcp-types";
-export type { CloseableTransport, SessionCloseReason };
-/**
- * The client state negotiated during MCP initialization. Stores that persist
- * it durably allow an implicitly re-initialized session (one restored on a
- * pod that never saw the client's `initialize` request) to retain the
- * client's capabilities — e.g. whether it supports elicitation — instead of
- * treating the restored client as capability-less.
- */
-export type NegotiatedClientState = {
-    clientCapabilities?: ClientCapabilities;
-    clientInfo?: Implementation;
-};
-/**
- * Error that `ISessionStore` implementations can throw from `getSession` to
- * reject a request (e.g. when identity validation against the request headers
- * fails). Unlike returning `undefined`, which means the session does not exist
- * and may trigger implicit session initialization, throwing this error fails
- * the request without creating a session. To avoid leaking whether the
- * session exists, the response is indistinguishable from "session not found";
- * the error message is only logged server-side.
- */
-export declare class SessionRejectedError extends Error {
-    constructor(message: string);
-}
-/**
- * Error thrown from `addSession` when the store has already reached its
- * configured `maxSessions` limit. Callers should surface this distinctly
- * from a generic failure so clients can be told to retry later rather than
- * treating it as a permanent request error.
- */
-export declare class SessionLimitExceededError extends Error {
-    constructor(message: string);
-}
-/**
- * Interface for managing MCP transport sessions.
- *
- * Implement this interface to provide custom session storage and lifecycle
- * management (e.g. database-based session storage).
- */
-export interface ISessionStore<T extends CloseableTransport = CloseableTransport> {
-    /**
-     * Returns the transport for the given session id or `undefined` if the
-     * session does not exist.
-     *
-     * @param headers The headers of the incoming request. Implementations can
-     * use them to validate the caller's identity before returning the session.
-     * To reject a request for an existing session, throw a
-     * {@link SessionRejectedError} rather than returning `undefined` — the
-     * latter is treated as "session not found" and may trigger implicit
-     * session initialization.
-     */
-    getSession(sessionId: string, headers?: Record<string, unknown>): Promise<T | undefined>;
-    /**
-     * Stores a newly initialized session.
-     *
-     * @param params.session The server session, exposing session-level state
-     * (e.g. the logger or the connection manager) to implementations that
-     * need it.
-     * @param params.headers The headers of the request that initiated the
-     * session (e.g. for tracing the x-request-id in logs and downstream
-     * requests).
-     */
-    addSession(params: {
-        sessionId: string;
-        transport: T;
-        /** TODO: Remove in v2 — redundant with `session.logger`. */
-        logger: LoggerBase;
-        session: Session;
-        headers?: Record<string, unknown>;
-    }): Promise<void>;
-    closeSession(params: {
-        sessionId: string;
-        reason?: SessionCloseReason;
-    }): Promise<void>;
-    closeAllSessions(): Promise<void>;
-    /**
-     * Durably records the client state negotiated during a real MCP
-     * initialization, so it can be restored when the session is later
-     * implicitly re-initialized (only relevant with
-     * `externallyManagedSessions`). Stores without durable storage can
-     * implement this as a no-op (the base `SessionStore` does), in which case
-     * restored sessions are treated as capability-less.
-     *
-     * @param headers The headers of the initiating request, for identity
-     * scoping and tracing — mirroring `getSession`.
-     */
-    saveNegotiatedClientState(sessionId: string, state: NegotiatedClientState, headers?: Record<string, unknown>): Promise<void>;
-    /**
-     * Returns the previously saved negotiated client state for the session,
-     * or `undefined` when unknown. Called during implicit session
-     * re-initialization, before the restored session serves its first
-     * request.
-     */
-    loadNegotiatedClientState(sessionId: string, headers?: Record<string, unknown>): Promise<NegotiatedClientState | undefined>;
-}
-export declare class SessionStore<T extends CloseableTransport = CloseableTransport> implements ISessionStore<T> {
-    private sessions;
-    private readonly idleTimeoutMS;
-    private readonly notificationTimeoutMS;
-    private readonly maxSessions;
-    /** Min idle time (ms) before the LRU session may be evicted to admit a new one. */
-    private readonly evictionIdleGraceMS;
-    private readonly logger;
-    private readonly metrics;
-    constructor(params: {
-        options: {
-            idleTimeoutMS: number;
-            notificationTimeoutMS: number;
-            maxSessions: number;
-            evictionIdleGraceMS?: number;
-        };
-        logger: LoggerBase;
-        metrics: Metrics<DefaultMetrics>;
-    });
-    getSession(sessionId: string, _headers?: Record<string, unknown>): Promise<T | undefined>;
-    /**
-     * Returns whether a session with the given id exists in this store.
-     *
-     * Unlike `getSession`, this does not reset the session's idle
-     * timeout, so it is safe to call when probing on behalf of requests that
-     * may not be served (e.g. authorization checks) without extending the
-     * session's lifetime.
-     */
-    hasSession(sessionId: string): boolean;
-    private resetTimeout;
-    private findEvictableSession;
-    private sendNotification;
-    addSession(params: {
-        sessionId: string;
-        transport: T;
-        /** TODO: Remove in v2 — redundant with `session.logger`. */
-        logger: LoggerBase;
-        session: Session;
-        headers?: Record<string, unknown>;
-    }): Promise<void>;
-    closeSession({ sessionId, reason, }: {
-        sessionId: string;
-        reason?: SessionCloseReason;
-    }): Promise<void>;
-    closeAllSessions(): Promise<void>;
-    /**
-     * The in-memory store does not persist negotiated client state: a session
-     * it evicts loses its transport too, and restoring client state is only
-     * meaningful with durable session storage. Restored sessions therefore
-     * behave as capability-less unless a subclass overrides these.
-     */
-    saveNegotiatedClientState(sessionId: string, state: NegotiatedClientState, headers?: Record<string, unknown>): Promise<void>;
-    loadNegotiatedClientState(sessionId: string, headers?: Record<string, unknown>): Promise<NegotiatedClientState | undefined>;
-}
-/**
- * Constructor arguments for creating a SessionStore instance.
- */
-export type SessionStoreConstructorArgs<TMetrics extends DefaultMetrics = DefaultMetrics> = {
-    options: {
-        idleTimeoutMS: number;
-        notificationTimeoutMS: number;
-        maxSessions: number;
-    };
-    logger: LoggerBase;
-    metrics: Metrics<TMetrics>;
-};
-/**
- * A function to create a custom SessionStore instance.
- * When provided, the runner will use this function instead of the default SessionStore constructor.
- */
-export type CreateSessionStoreFn<TTransport extends CloseableTransport = CloseableTransport, TMetrics extends DefaultMetrics = DefaultMetrics> = (args: SessionStoreConstructorArgs<TMetrics>) => ISessionStore<TTransport>;
-/**
- * Creates a default SessionStore instance from the provided constructor arguments.
- */
-export declare function createDefaultSessionStore<TTransport extends CloseableTransport = CloseableTransport, TMetrics extends DefaultMetrics = DefaultMetrics>(params: SessionStoreConstructorArgs<TMetrics>): SessionStore<TTransport>;
-//# sourceMappingURL=sessionStore.d.ts.map

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

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