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

package/dist/cjs/setup/setupTelemetry.js

@@ -1,202 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetupTelemetry = exports.toBoolSet = void 0;
-const crypto_1 = require("crypto");
-const apiClient_js_1 = require("../common/atlas/apiClient.js");
-const index_js_1 = require("../common/logging/index.js");
-const deviceId_js_1 = require("../helpers/deviceId.js");
-const telemetry_js_1 = require("../telemetry/telemetry.js");
-const toBoolSet = (value) => {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value ? "true" : "false";
-};
-exports.toBoolSet = toBoolSet;
-/**
- * Per-run helper that owns the setup telemetry session: assigns the
- * `setup_session_id`, tracks wall-clock durations, and
- * accumulates context so every event carries the full set of known flags.
- *
- * One instance is constructed per `runSetup` invocation. Callers emit typed
- * events at each logical step and call {@link flush} before the process
- * exits so buffered events are best-effort sent.
- */
-class SetupTelemetry {
-    /**
-     * Builds a fully-wired {@link SetupTelemetry} for the setup CLI: a silent
-     * logger (so telemetry's internal logging doesn't leak into the
-     * interactive wizard), a fresh {@link DeviceId}, an unauthenticated
-     * {@link ApiClient}, and a {@link Telemetry} instance.
-     */
-    static create(config, keychain) {
-        const logger = new index_js_1.NullLogger();
-        const deviceId = deviceId_js_1.DeviceId.create(logger);
-        const apiClient = new apiClient_js_1.ApiClient({ baseUrl: config.apiBaseUrl }, logger);
-        const telemetry = telemetry_js_1.Telemetry.create({
-            logger,
-            deviceId,
-            apiClient,
-            keychain,
-            enabled: config.telemetry === "enabled",
-        });
-        return new SetupTelemetry(telemetry, deviceId);
-    }
-    /**
-     * Direct construction is primarily for tests that want to inject a mock
-     * telemetry pipeline. Production code should use {@link SetupTelemetry.create}.
-     */
-    constructor(telemetry, deviceId) {
-        this.telemetry = telemetry;
-        this.deviceId = deviceId;
-        this.setupSessionId = (0, crypto_1.randomUUID)();
-        this.startedAt = Date.now();
-        this.stepStartedAt = this.startedAt;
-        this.context = {};
-    }
-    /**
-     * Merges new context values into the accumulated context. Subsequent
-     * events will automatically carry the updated values.
-     */
-    updateContext(patch) {
-        this.context = { ...this.context, ...patch };
-    }
-    /**
-     * Emits a single setup event. `duration_ms` is computed from the time
-     * elapsed since the previous step (or setup start), and `result`
-     * defaults to "success" — callers pass "failure" only when the step's
-     * own code path failed (e.g. writing the editor config threw).
-     */
-    emit(stage, extra = {}, result = "success") {
-        const now = Date.now();
-        const event = {
-            timestamp: new Date(now).toISOString(),
-            source: "mdbmcp",
-            properties: {
-                component: "setup",
-                category: "setup",
-                duration_ms: now - this.stepStartedAt,
-                result,
-                stage,
-                setup_session_id: this.setupSessionId,
-                ...this.context,
-                ...extra,
-            },
-        };
-        this.telemetry.emitEvents([event]);
-        this.stepStartedAt = now;
-        this.lastStep = stage;
-    }
-    emitStarted() {
-        this.emit("started");
-    }
-    emitPrerequisitesChecked(props) {
-        this.updateContext({
-            node_version_ok: (0, exports.toBoolSet)(props.nodeVersionOk),
-            has_docker: (0, exports.toBoolSet)(props.hasDocker),
-        });
-        this.emit("prerequisites_checked");
-    }
-    emitAiToolSelected(aiTool) {
-        this.updateContext({ ai_tool: aiTool });
-        this.emit("ai_tool_selected");
-    }
-    emitReadOnlySelected(isReadOnly) {
-        this.updateContext({ read_only_mode: (0, exports.toBoolSet)(isReadOnly) });
-        this.emit("read_only_selected");
-    }
-    emitConnectionStringEntered(props) {
-        this.updateContext({
-            connection_string_provided: (0, exports.toBoolSet)(props.provided),
-            connection_string_tested: (0, exports.toBoolSet)(props.tested),
-            connection_test_attempts: props.attempts,
-        });
-        // If the user tested their connection string, surface the final
-        // test result on this step event (success/failure). If they skipped
-        // the test, the step itself still "succeeded" — the user chose not
-        // to validate — so we default to success.
-        this.emit("connection_string_entered", {}, props.testResult ?? "success");
-    }
-    emitServiceAccountIdEntered(provided) {
-        this.updateContext({ service_account_id_provided: (0, exports.toBoolSet)(provided) });
-        this.emit("service_account_id_entered");
-    }
-    emitServiceAccountSecretEntered(provided) {
-        this.updateContext({ service_account_secret_provided: (0, exports.toBoolSet)(provided) });
-        this.emit("service_account_secret_entered");
-    }
-    emitCredentialsValidated() {
-        this.emit("credentials_validated");
-    }
-    emitEditorConfigured(props) {
-        this.updateContext({
-            used_default_config_path: (0, exports.toBoolSet)(props.usedDefaultConfigPath),
-        });
-        this.emit("editor_configured", props.error ? { error_type: errorName(props.error) } : {}, props.result);
-    }
-    emitSkillsInstallPrompted(outcome) {
-        const patch = { skills_install_status: outcome.status };
-        if (outcome.status === "skipped") {
-            patch.skills_skip_reason = outcome.reason;
-        }
-        else if (outcome.status === "failed") {
-            patch.skills_install_exit_code = outcome.exitCode;
-        }
-        this.updateContext(patch);
-        this.emit("skills_install_prompted");
-    }
-    emitOpenConfigPrompted(props) {
-        this.updateContext({ opened_config_file: (0, exports.toBoolSet)(props.opened) });
-        this.emit("open_config_prompted", props.error ? { error_type: errorName(props.error) } : {}, props.result);
-    }
-    emitCompleted() {
-        this.emit("completed", { total_duration_ms: Date.now() - this.startedAt });
-    }
-    /**
-     * Emits a cancellation event (e.g. the user hit Ctrl+C). The `result` is
-     * "success" because the cancellation itself was handled gracefully — the
-     * distinct `stage: "cancelled"` is what analytics use to separate
-     * abandoned runs from completed ones.
-     */
-    emitCancelled() {
-        this.emit("cancelled", {
-            last_stage: this.lastStep,
-            total_duration_ms: Date.now() - this.startedAt,
-        });
-    }
-    emitFailed(error) {
-        this.emit("failed", {
-            last_stage: this.lastStep,
-            error_type: errorName(error),
-            total_duration_ms: Date.now() - this.startedAt,
-        }, "failure");
-    }
-    /**
-     * Best-effort flush of any buffered events before the process exits. Also
-     * closes the owned {@link DeviceId}.
-     */
-    async flush() {
-        try {
-            await this.telemetry.close();
-        }
-        catch {
-            // Ignore errors from telemetry.close()
-        }
-        finally {
-            try {
-                this.deviceId.close();
-            }
-            catch {
-                // Ignore errors - it's best-effort
-            }
-        }
-    }
-}
-exports.SetupTelemetry = SetupTelemetry;
-const errorName = (error) => {
-    if (error && typeof error === "object" && "name" in error && typeof error.name === "string") {
-        return error.name;
-    }
-    return "unknown";
-};
-//# sourceMappingURL=setupTelemetry.js.map

package/dist/cjs/setup/setupTelemetry.js.map

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

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

@@ -1,6 +0,0 @@
-import { type CommonStaticProperties } from "./types.js";
-/**
- * Machine-specific metadata formatted for telemetry
- */
-export declare const MACHINE_METADATA: CommonStaticProperties;
-//# sourceMappingURL=constants.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,sBAOrB,CAAC"}

package/dist/cjs/telemetry/constants.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MACHINE_METADATA = void 0;
-const packageInfo_js_1 = require("../common/packageInfo.js");
-/**
- * Machine-specific metadata formatted for telemetry
- */
-exports.MACHINE_METADATA = {
-    mcp_server_version: packageInfo_js_1.packageInfo.version,
-    mcp_server_name: packageInfo_js_1.packageInfo.mcpServerName,
-    platform: (typeof process !== "undefined" && process.platform) || "browser",
-    arch: (typeof process !== "undefined" && process.arch) || "unknown",
-    os_type: (typeof process !== "undefined" && process.platform) || "unknown",
-    os_version: (typeof process !== "undefined" && process.version) || "unknown",
-};
-//# sourceMappingURL=constants.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/telemetry/constants.ts"],"names":[],"mappings":";;;AAAA,6DAAuD;AAGvD;;GAEG;AACU,QAAA,gBAAgB,GAA2B;IACpD,kBAAkB,EAAE,4BAAW,CAAC,OAAO;IACvC,eAAe,EAAE,4BAAW,CAAC,aAAa;IAC1C,QAAQ,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS;IAC3E,IAAI,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS;IACnE,OAAO,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS;IAC1E,UAAU,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,SAAS;CACtE,CAAC"}

package/dist/cjs/telemetry/eventCache.d.ts

@@ -1,57 +0,0 @@
-import type { BaseEvent } from "./types.js";
-/**
- * Singleton class for in-memory telemetry event caching
- * Provides a central storage for telemetry events that couldn't be sent
- * Uses LRU cache to automatically drop oldest events when limit is exceeded
- */
-export declare class EventCache {
-    private static instance;
-    private static readonly MAX_EVENTS;
-    private cache;
-    private nextId;
-    /** Current exclusive operation, if any. The next caller awaits this before starting. */
-    private currentOperation;
-    constructor();
-    /**
-     * Gets the singleton instance of EventCache
-     * @returns The EventCache instance
-     */
-    static getInstance(): EventCache;
-    /**
-     * Gets the number of currently cached events
-     */
-    get size(): number;
-    /**
-     * Runs a callback with exclusive access to the cache so operations
-     * are serialized across all callers (e.g. multiple Telemetry instances / sessions).
-     */
-    private runExclusive;
-    /**
-     * Under exclusive access: takes up to `batchSize` oldest events and passes them
-     * to the processor. If the processor signals `removeProcessed: true`, those events
-     * are removed from the cache; otherwise they remain untouched.
-     * Returns the `result` from the processor, or `undefined` if the cache was empty.
-     */
-    processOldestBatch<T>(batchSize: number, processor: (events: BaseEvent[]) => Promise<{
-        removeProcessed: boolean;
-        result: T;
-    }>): Promise<T | undefined>;
-    /**
-     * Gets a copy of the currently cached events along with their ids
-     * @returns Array of cached BaseEvent objects
-     */
-    getEvents(): {
-        id: number;
-        event: BaseEvent;
-    }[];
-    /**
-     * Appends new events to the cache.
-     * LRU cache automatically handles dropping oldest events when limit is exceeded.
-     */
-    appendEvents(events: BaseEvent[]): void;
-    /**
-     * Removes cached events by their ids
-     */
-    removeEvents(ids: number[]): void;
-}
-//# sourceMappingURL=eventCache.d.ts.map

package/dist/cjs/telemetry/eventCache.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eventCache.d.ts","sourceRoot":"","sources":["../../../src/telemetry/eventCache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAa;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAE1C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,MAAM,CAAK;IACnB,wFAAwF;IACxF,OAAO,CAAC,gBAAgB,CAA8D;;IAWtF;;;OAGG;WACW,WAAW,IAAI,UAAU;IAOvC;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;YACW,YAAY;IAoB1B;;;;;OAKG;IACU,kBAAkB,CAAC,CAAC,EAC7B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC,GACrF,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAmBzB;;;OAGG;IACI,SAAS,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,EAAE;IAItD;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAM9C;;OAEG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;CAK3C"}

package/dist/cjs/telemetry/eventCache.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventCache = void 0;
-const lru_cache_1 = require("lru-cache");
-/**
- * Singleton class for in-memory telemetry event caching
- * Provides a central storage for telemetry events that couldn't be sent
- * Uses LRU cache to automatically drop oldest events when limit is exceeded
- */
-class EventCache {
-    constructor() {
-        this.nextId = 0;
-        this.cache = new lru_cache_1.LRUCache({
-            max: EventCache.MAX_EVENTS,
-            // Using FIFO eviction strategy for events
-            allowStale: false,
-            updateAgeOnGet: false,
-        });
-    }
-    /**
-     * Gets the singleton instance of EventCache
-     * @returns The EventCache instance
-     */
-    static getInstance() {
-        if (!EventCache.instance) {
-            EventCache.instance = new EventCache();
-        }
-        return EventCache.instance;
-    }
-    /**
-     * Gets the number of currently cached events
-     */
-    get size() {
-        return this.cache.size;
-    }
-    /**
-     * Runs a callback with exclusive access to the cache so operations
-     * are serialized across all callers (e.g. multiple Telemetry instances / sessions).
-     */
-    async runExclusive(fn) {
-        const prevOperation = this.currentOperation;
-        let resolve;
-        const promise = new Promise((res) => {
-            resolve = res;
-        });
-        // resolve is guaranteed to be assigned by the Promise constructor
-        const release = resolve;
-        this.currentOperation = { promise, resolve: release };
-        await prevOperation?.promise;
-        try {
-            return await fn();
-        }
-        finally {
-            release();
-        }
-    }
-    /**
-     * Under exclusive access: takes up to `batchSize` oldest events and passes them
-     * to the processor. If the processor signals `removeProcessed: true`, those events
-     * are removed from the cache; otherwise they remain untouched.
-     * Returns the `result` from the processor, or `undefined` if the cache was empty.
-     */
-    async processOldestBatch(batchSize, processor) {
-        return this.runExclusive(async () => {
-            const allEvents = this.getEvents();
-            const batch = allEvents.slice(0, batchSize);
-            if (batch.length === 0)
-                return undefined;
-            try {
-                const { removeProcessed, result } = await processor(batch.map((e) => e.event));
-                if (removeProcessed) {
-                    this.removeEvents(batch.map((e) => e.id));
-                }
-                return result;
-            }
-            catch {
-                // Processor threw — leave events in cache for retry
-                return undefined;
-            }
-        });
-    }
-    /**
-     * Gets a copy of the currently cached events along with their ids
-     * @returns Array of cached BaseEvent objects
-     */
-    getEvents() {
-        return Array.from(this.cache.entries()).map(([id, event]) => ({ id, event }));
-    }
-    /**
-     * Appends new events to the cache.
-     * LRU cache automatically handles dropping oldest events when limit is exceeded.
-     */
-    appendEvents(events) {
-        for (const event of events) {
-            this.cache.set(this.nextId++, event);
-        }
-    }
-    /**
-     * Removes cached events by their ids
-     */
-    removeEvents(ids) {
-        for (const id of ids) {
-            this.cache.delete(id);
-        }
-    }
-}
-exports.EventCache = EventCache;
-EventCache.MAX_EVENTS = 1000;
-//# sourceMappingURL=eventCache.js.map

package/dist/cjs/telemetry/eventCache.js.map

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

package/dist/cjs/telemetry/telemetry.d.ts

@@ -1,139 +0,0 @@
-import type { BaseEvent, CommonProperties } from "./types.js";
-import type { LoggerBase } from "../common/logging/index.js";
-import type { ApiClient } from "../common/atlas/apiClient.js";
-import { EventCache } from "./eventCache.js";
-import type { DeviceId } from "../helpers/deviceId.js";
-import type { Keychain } from "../common/keychain.js";
-import type { Session } from "../common/session.js";
-import type { UserConfig } from "../common/config/userConfig.js";
-import { EventEmitter } from "events";
-import type { TelemetryEvents } from "@mongodb-js/mcp-types";
-export type { TelemetryEvents };
-/**
- * Configuration for the {@link Telemetry} pipeline.
- */
-export interface TelemetryConfig {
-    /** Logger used by the telemetry pipeline for its own diagnostics. */
-    logger: LoggerBase;
-    /** Device id source, resolved asynchronously during setup. */
-    deviceId: DeviceId;
-    /**
-     * API client used to send events. Always required — the pipeline would
-     * otherwise buffer events in the cache forever. When no Atlas credentials
-     * are configured, callers should still pass an unauthenticated
-     * {@link ApiClient}; it will route telemetry through the unauth endpoint.
-     */
-    apiClient: ApiClient;
-    /** Secrets source used when redacting events prior to sending. */
-    keychain?: Keychain;
-    /**
-     * The user's telemetry preference. When set to `false`, no events are
-     * cached or sent. The DO_NOT_TRACK environment variable is always honored
-     * on top of this setting, so callers don't need to check it themselves.
-     */
-    enabled: boolean;
-    /**
-     * Returns the host-supplied common properties merged onto every event
-     * (e.g. hosting mode, MCP client identity, transport). Invoked on every
-     * send so values resolved after construction — like the client name/
-     * version exchanged during handshake — are captured. Static properties
-     * can simply be returned as constants from this callback.
-     *
-     * Machine metadata, device id, and container environment are provided by
-     * the pipeline itself and don't need to be returned here.
-     */
-    getCommonProperties?: () => Partial<CommonProperties>;
-    /**
-     * Optional override for the underlying event cache. Defaults to the
-     * process-wide singleton returned by {@link EventCache.getInstance}.
-     * Mostly useful for tests or callers that need to isolate caching.
-     */
-    eventCache?: EventCache;
-}
-/** Maximum number of events sent per batch. */
-export declare const BATCH_SIZE = 32;
-/** Delay between send attempts under normal conditions. */
-export declare const SEND_INTERVAL_MS = 30000;
-/** Initial backoff delay after a 429 response. */
-export declare const INITIAL_BACKOFF_MS = 60000;
-/** Maximum backoff delay (1 hour). */
-export declare const MAX_BACKOFF_MS = 3600000;
-/**
- * Calculates the next backoff duration, doubling the current value up to MAX_BACKOFF_MS.
- */
-export declare function nextBackoffMs(currentMs: number): number;
-export declare class Telemetry {
-    /** Resolves when the setup is complete or a timeout occurs */
-    setupPromise: Promise<[string, boolean]> | undefined;
-    readonly events: EventEmitter<TelemetryEvents>;
-    private readonly logger;
-    private readonly apiClient;
-    private readonly keychain?;
-    private readonly enabled;
-    private readonly getHostCommonProperties;
-    /**
-     * Machine metadata plus device_id / is_container_env, which the pipeline
-     * resolves itself during setup. Host-supplied properties are merged on
-     * top of this at send time.
-     */
-    private readonly pipelineCommonProperties;
-    private readonly eventCache;
-    private readonly deviceId;
-    private backoffMs;
-    private readonly timer;
-    private constructor();
-    /**
-     * @deprecated Pass a {@link TelemetryConfig} object instead. This
-     * positional-argument overload is preserved for backward compatibility
-     * and will be removed in the next major version.
-     */
-    static create(session: Session, userConfig: UserConfig, deviceId: DeviceId, options?: {
-        commonProperties?: Partial<CommonProperties>;
-        eventCache?: EventCache;
-    }): Telemetry;
-    static create(config: TelemetryConfig): Telemetry;
-    private setup;
-    close(): Promise<void>;
-    /**
-     * Caches events for sending via the background timer.
-     */
-    emitEvents(events: BaseEvent[]): void;
-    /**
-     * Gets the common properties for events
-     */
-    getCommonProperties(): CommonProperties;
-    /**
-     * Checks if telemetry is currently enabled.
-     *
-     * Follows the Console Do Not Track standard
-     * by respecting the DO_NOT_TRACK environment variable. The env check is
-     * done on every call so an operator can opt out mid-process.
-     */
-    isTelemetryEnabled(): boolean;
-    /**
-     * Schedules the next send attempt. Replaces any previously scheduled send.
-     */
-    private scheduleSend;
-    /**
-     * Sends a batch and reschedules the next attempt based on the result.
-     */
-    private sendBatchAndReschedule;
-    /**
-     * Determines the next send delay based on the result of the last batch.
-     * On rate-limit: uses and advances exponential backoff.
-     * On success: resets backoff and returns the normal interval.
-     * On error/empty: returns the normal interval without changing backoff state.
-     */
-    private getNextDelay;
-    /**
-     * Sends up to BATCH_SIZE oldest events from the cache.
-     * On success the sent events are removed; on failure they stay in the cache.
-     * Does not reschedule — the caller decides what to do next.
-     */
-    private sendBatch;
-    /**
-     * Sends events through the API client after redacting sensitive data.
-     */
-    private sendEvents;
-}
-//# sourceMappingURL=telemetry.d.ts.map

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

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