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

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

@@ -1,57 +1,138 @@
-import type { Session } from "../common/session.js";
 import type { BaseEvent, CommonProperties } from "./types.js";
-import type { UserConfig } from "../common/config/userConfig.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";
-export interface TelemetryEvents {
-    "events-emitted": [];
-    "events-send-failed": [];
-    "events-skipped": [];
+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 {
-    private readonly session;
-    private readonly userConfig;
-    private readonly commonProperties;
-    private isBufferingEvents;
     /** Resolves when the setup is complete or a timeout occurs */
     setupPromise: Promise<[string, boolean]> | undefined;
     readonly events: EventEmitter<TelemetryEvents>;
-    private eventCache;
-    private deviceId;
+    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();
-    static create(session: Session, userConfig: UserConfig, deviceId: DeviceId, { commonProperties, eventCache, }?: {
+    /**
+     * @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>;
     /**
-     * Emits events through the telemetry pipeline
-     * @param events - The events to emit
+     * Caches events for sending via the background timer.
      */
     emitEvents(events: BaseEvent[]): void;
     /**
      * Gets the common properties for events
-     * @returns Object containing common properties for all events
      */
     getCommonProperties(): CommonProperties;
     /**
-     * Checks if telemetry is currently enabled
-     * This is a method rather than a constant to capture runtime config changes
+     * Checks if telemetry is currently enabled.
      *
-     * Follows the Console Do Not Track standard (https://consoledonottrack.com/)
-     * by respecting the DO_NOT_TRACK environment variable
+     * 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;
     /**
-     * Attempts to emit events through authenticated and unauthenticated clients
-     * Falls back to caching if both attempts fail
+     * 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 emit;
+    private sendBatch;
     /**
-     * Attempts to send events through the provided API client.
-     * Events are redacted before being sent to ensure no sensitive data is transmitted
+     * Sends events through the API client after redacting sensitive data.
      */
     private sendEvents;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAIjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAQtC,MAAM,WAAW,eAAe;IAC5B,gBAAgB,EAAE,EAAE,CAAC;IACrB,oBAAoB,EAAE,EAAE,CAAC;IACzB,gBAAgB,EAAE,EAAE,CAAC;CACxB;AAED,qBAAa,SAAS;IAUd,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAXrC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,8DAA8D;IACvD,YAAY,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D,SAAgB,MAAM,EAAE,YAAY,CAAC,eAAe,CAAC,CAAsB;IAE3E,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAE3B,OAAO;IAUP,MAAM,CAAC,MAAM,CACT,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,EACI,gBAAqB,EACrB,UAAqC,GACxC,GAAE;QACC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC7C,UAAU,CAAC,EAAE,UAAU,CAAC;KACtB,GACP,SAAS;YAcE,KAAK;IAoBN,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCnC;;;OAGG;IACI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAU5C;;;OAGG;IACI,mBAAmB,IAAI,gBAAgB;IAY9C;;;;;;OAMG;IACI,kBAAkB,IAAI,OAAO;IAUpC;;;OAGG;YACW,IAAI;IAoDlB;;;OAGG;YACW,UAAU;CAmB3B"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/cjs/telemetry/telemetry.js

@@ -1,38 +1,64 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Telemetry = void 0;
-const logger_js_1 = require("../common/logger.js");
+exports.Telemetry = exports.MAX_BACKOFF_MS = exports.INITIAL_BACKOFF_MS = exports.SEND_INTERVAL_MS = exports.BATCH_SIZE = void 0;
+exports.nextBackoffMs = nextBackoffMs;
+const index_js_1 = require("../common/logging/index.js");
+const apiClientError_js_1 = require("../common/atlas/apiClientError.js");
 const constants_js_1 = require("./constants.js");
 const eventCache_js_1 = require("./eventCache.js");
 const container_js_1 = require("../helpers/container.js");
 const events_1 = require("events");
 const mongodb_redact_1 = require("mongodb-redact");
+const timer_js_1 = require("./timer.js");
+/** The timeout for individual send requests in milliseconds. */
+const SEND_TIMEOUT_MS = 5000;
+/** How long close() waits for a final flush before giving up. */
+const CLOSE_TIMEOUT_MS = 5000;
+/** Maximum number of events sent per batch. */
+exports.BATCH_SIZE = 32;
+/** Delay between send attempts under normal conditions. */
+exports.SEND_INTERVAL_MS = 30000;
+/** Initial backoff delay after a 429 response. */
+exports.INITIAL_BACKOFF_MS = 60000;
+/** Maximum backoff delay (1 hour). */
+exports.MAX_BACKOFF_MS = 3600000;
+/**
+ * Calculates the next backoff duration, doubling the current value up to MAX_BACKOFF_MS.
+ */
+function nextBackoffMs(currentMs) {
+    return Math.min(currentMs * 2, exports.MAX_BACKOFF_MS);
+}
 class Telemetry {
-    constructor(session, userConfig, commonProperties, { eventCache, deviceId }) {
-        this.session = session;
-        this.userConfig = userConfig;
-        this.commonProperties = commonProperties;
-        this.isBufferingEvents = true;
+    constructor(config) {
         this.events = new events_1.EventEmitter();
-        this.eventCache = eventCache;
-        this.deviceId = deviceId;
-    }
-    static create(session, userConfig, deviceId, { commonProperties = {}, eventCache = eventCache_js_1.EventCache.getInstance(), } = {}) {
-        const mergedProperties = {
+        this.backoffMs = exports.INITIAL_BACKOFF_MS;
+        this.timer = new timer_js_1.Timer();
+        this.logger = config.logger;
+        this.apiClient = config.apiClient;
+        this.keychain = config.keychain;
+        this.enabled = config.enabled;
+        this.getHostCommonProperties = config.getCommonProperties ?? (() => ({}));
+        this.eventCache = config.eventCache ?? eventCache_js_1.EventCache.getInstance();
+        this.deviceId = config.deviceId;
+        this.pipelineCommonProperties = {
             ...constants_js_1.MACHINE_METADATA,
-            ...commonProperties,
         };
-        const instance = new Telemetry(session, userConfig, mergedProperties, {
-            eventCache,
-            deviceId,
-        });
+    }
+    static create(sessionOrConfig, userConfig, deviceId, { commonProperties = {}, eventCache = eventCache_js_1.EventCache.getInstance(), } = {}) {
+        const config = userConfig === undefined || deviceId === undefined
+            ? sessionOrConfig
+            : legacyConfigFromSession(sessionOrConfig, userConfig, deviceId, {
+                commonProperties,
+                eventCache,
+            });
+        const instance = new Telemetry(config);
         void instance.setup();
         return instance;
     }
     async setup() {
         if (!this.isTelemetryEnabled()) {
-            this.session.logger.info({
-                id: logger_js_1.LogId.telemetryEmitFailure,
+            this.logger.info({
+                id: index_js_1.LogId.telemetryEmitFailure,
                 context: "telemetry",
                 message: "Telemetry is disabled.",
                 noRedaction: true,
@@ -41,155 +67,184 @@ class Telemetry {
         }
         this.setupPromise = Promise.all([this.deviceId.get(), (0, container_js_1.detectContainerEnv)()]);
         const [deviceIdValue, containerEnv] = await this.setupPromise;
-        this.commonProperties.device_id = deviceIdValue;
-        this.commonProperties.is_container_env = containerEnv ? "true" : "false";
-        this.isBufferingEvents = false;
+        this.pipelineCommonProperties.device_id = deviceIdValue;
+        this.pipelineCommonProperties.is_container_env = containerEnv ? "true" : "false";
+        this.scheduleSend();
     }
     async close() {
-        this.isBufferingEvents = false;
-        this.session.logger.debug({
-            id: logger_js_1.LogId.telemetryClose,
-            message: `Closing telemetry and flushing ${this.eventCache.size} events`,
+        this.timer.cancel();
+        this.logger.debug({
+            id: index_js_1.LogId.telemetryClose,
+            message: `Closing telemetry, attempting to flush up to ${exports.BATCH_SIZE} of ${this.eventCache.size} remaining events`,
             context: "telemetry",
         });
-        // Wait up to 5 seconds for events to be sent before closing, but don't throw if it times out
-        const flushMaxWaitTime = 5000;
-        let flushTimeout;
-        await Promise.race([
-            new Promise((resolve) => {
-                flushTimeout = setTimeout(() => {
-                    this.session.logger.debug({
-                        id: logger_js_1.LogId.telemetryClose,
-                        message: `Failed to flush remaining events within ${flushMaxWaitTime}ms timeout`,
-                        context: "telemetry",
-                    });
-                    resolve();
-                }, flushMaxWaitTime);
-                // This is Node-specific and can cause issues when running in electron otherwise. See https://github.com/electron/electron/issues/21162
-                if (typeof flushTimeout.unref === "function") {
-                    flushTimeout.unref();
-                }
-            }),
-            this.emit([]),
-        ]);
-        clearTimeout(flushTimeout);
+        // Best-effort: send one final batch before closing, bounded by CLOSE_TIMEOUT_MS
+        await this.sendBatch({ signal: AbortSignal.timeout(CLOSE_TIMEOUT_MS) });
     }
     /**
-     * Emits events through the telemetry pipeline
-     * @param events - The events to emit
+     * Caches events for sending via the background timer.
      */
     emitEvents(events) {
         if (!this.isTelemetryEnabled()) {
             this.events.emit("events-skipped");
             return;
         }
-        // Don't wait for events to be sent - we should not block regular server
-        // operations on telemetry
-        void this.emit(events);
+        this.eventCache.appendEvents(events);
     }
     /**
      * Gets the common properties for events
-     * @returns Object containing common properties for all events
      */
     getCommonProperties() {
         return {
-            ...this.commonProperties,
-            transport: this.userConfig.transport,
-            mcp_client_version: this.session.mcpClient?.version,
-            mcp_client_name: this.session.mcpClient?.name,
-            session_id: this.session.sessionId,
-            config_atlas_auth: this.session.apiClient?.isAuthConfigured() ? "true" : "false",
-            config_connection_string: this.userConfig.connectionString ? "true" : "false",
+            ...this.pipelineCommonProperties,
+            ...this.getHostCommonProperties(),
         };
     }
     /**
-     * Checks if telemetry is currently enabled
-     * This is a method rather than a constant to capture runtime config changes
+     * Checks if telemetry is currently enabled.
      *
-     * Follows the Console Do Not Track standard (https://consoledonottrack.com/)
-     * by respecting the DO_NOT_TRACK environment variable
+     * 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() {
-        // Check if telemetry is explicitly disabled in config
-        if (this.userConfig.telemetry === "disabled") {
+        if (!this.enabled) {
             return false;
         }
-        const doNotTrack = "DO_NOT_TRACK" in process.env;
-        return !doNotTrack;
+        // In browser environments, we don't have access to the process object, so we default to true.
+        if (typeof process === "undefined" || !process.env) {
+            return true;
+        }
+        // In Node.js environments, we check the DO_NOT_TRACK environment variable.
+        return !("DO_NOT_TRACK" in process.env);
     }
     /**
-     * Attempts to emit events through authenticated and unauthenticated clients
-     * Falls back to caching if both attempts fail
+     * Schedules the next send attempt. Replaces any previously scheduled send.
      */
-    async emit(events) {
-        if (this.isBufferingEvents) {
-            this.eventCache.appendEvents(events);
-            return;
+    scheduleSend(delayMs = exports.SEND_INTERVAL_MS) {
+        this.timer.schedule(() => {
+            void this.sendBatchAndReschedule();
+        }, delayMs);
+    }
+    /**
+     * Sends a batch and reschedules the next attempt based on the result.
+     */
+    async sendBatchAndReschedule() {
+        const result = await this.sendBatch();
+        const delay = this.getNextDelay(result);
+        this.scheduleSend(delay);
+    }
+    /**
+     * 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.
+     */
+    getNextDelay(result) {
+        if (result.status === "rate-limited") {
+            const delay = this.backoffMs;
+            this.backoffMs = nextBackoffMs(this.backoffMs);
+            this.logger.debug({
+                id: index_js_1.LogId.telemetryRateLimited,
+                context: "telemetry",
+                message: `Rate limited. Backing off for ${delay}ms, next backoff will be ${this.backoffMs}ms`,
+                noRedaction: true,
+            });
+            return delay;
         }
-        // If no API client is available, cache the events
-        if (!this.session.apiClient) {
-            this.eventCache.appendEvents(events);
-            return;
+        if (result.status === "success") {
+            this.backoffMs = exports.INITIAL_BACKOFF_MS;
         }
-        try {
-            const cachedEvents = this.eventCache.getEvents();
-            const allEvents = [...cachedEvents.map((e) => e.event), ...events];
-            this.session.logger.debug({
-                id: logger_js_1.LogId.telemetryEmitStart,
+        return exports.SEND_INTERVAL_MS;
+    }
+    /**
+     * 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.
+     */
+    async sendBatch({ signal } = {}) {
+        if (this.eventCache.size === 0) {
+            return { status: "empty" };
+        }
+        const result = await this.eventCache.processOldestBatch(exports.BATCH_SIZE, async (events) => {
+            this.logger.debug({
+                id: index_js_1.LogId.telemetryEmitStart,
                 context: "telemetry",
-                message: `Attempting to send ${allEvents.length} events (${cachedEvents.length} cached)`,
+                message: `Attempting to send ${events.length} events`,
             });
-            const result = await this.sendEvents(this.session.apiClient, allEvents);
-            if (result.success) {
-                this.eventCache.removeEvents(cachedEvents.map((e) => e.id));
-                this.session.logger.debug({
-                    id: logger_js_1.LogId.telemetryEmitSuccess,
-                    context: "telemetry",
-                    message: `Sent ${allEvents.length} events successfully: ${JSON.stringify(allEvents)}`,
-                });
-                this.events.emit("events-emitted");
-                return;
+            const sendResult = await this.sendEvents(this.apiClient, events, signal);
+            if (sendResult.status !== "success") {
+                if (sendResult.status !== "rate-limited") {
+                    this.logger.debug({
+                        id: index_js_1.LogId.telemetryEmitFailure,
+                        context: "telemetry",
+                        message: `Error sending telemetry: ${sendResult.error?.message ?? "unknown error"}`,
+                        noRedaction: true,
+                    });
+                }
+                this.events.emit("events-send-failed");
+                return { removeProcessed: false, result: sendResult };
             }
-            this.session.logger.debug({
-                id: logger_js_1.LogId.telemetryEmitFailure,
+            this.logger.debug({
+                id: index_js_1.LogId.telemetryEmitSuccess,
                 context: "telemetry",
-                message: `Error sending event to client: ${result.error instanceof Error ? result.error.message : String(result.error)}`,
+                message: `Sent ${events.length} events successfully`,
             });
-            this.eventCache.appendEvents(events);
-            this.events.emit("events-send-failed");
-        }
-        catch (error) {
-            this.session.logger.debug({
-                id: logger_js_1.LogId.telemetryEmitFailure,
-                context: "telemetry",
-                message: `Error emitting telemetry events: ${error instanceof Error ? error.message : String(error)}`,
-                noRedaction: true,
-            });
-            this.events.emit("events-send-failed");
-        }
+            this.events.emit("events-emitted");
+            return { removeProcessed: true, result: sendResult };
+        });
+        return result ?? { status: "empty" };
     }
     /**
-     * Attempts to send events through the provided API client.
-     * Events are redacted before being sent to ensure no sensitive data is transmitted
+     * Sends events through the API client after redacting sensitive data.
      */
-    async sendEvents(client, events) {
+    async sendEvents(client, events, signal) {
         try {
+            const effectiveSignal = signal ?? AbortSignal.timeout(SEND_TIMEOUT_MS);
+            const secrets = this.keychain?.allSecrets ?? [];
             await client.sendEvents(events.map((event) => ({
                 ...event,
                 properties: {
-                    ...(0, mongodb_redact_1.redact)(this.getCommonProperties(), this.session.keychain.allSecrets),
-                    ...(0, mongodb_redact_1.redact)(event.properties, this.session.keychain.allSecrets),
+                    ...(0, mongodb_redact_1.redact)(this.getCommonProperties(), secrets),
+                    ...(0, mongodb_redact_1.redact)(event.properties, secrets),
                 },
-            })));
-            return { success: true };
+            })), { signal: effectiveSignal });
+            return { status: "success" };
         }
         catch (error) {
+            if (error instanceof apiClientError_js_1.ApiClientError && error.response.status === 429) {
+                return { status: "rate-limited", error };
+            }
             return {
-                success: false,
+                status: "error",
                 error: error instanceof Error ? error : new Error(String(error)),
             };
         }
     }
 }
 exports.Telemetry = Telemetry;
+/**
+ * Translates the legacy (session, userConfig, deviceId, options) inputs
+ * accepted by the deprecated {@link Telemetry.create} overload into a
+ * {@link TelemetryConfig}.
+ */
+function legacyConfigFromSession(session, userConfig, deviceId, { commonProperties, eventCache, }) {
+    return {
+        logger: session.logger,
+        deviceId,
+        apiClient: session.apiClient,
+        keychain: session.keychain,
+        enabled: userConfig.telemetry === "enabled",
+        eventCache,
+        getCommonProperties: () => ({
+            ...commonProperties,
+            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",
+        }),
+    };
+}
 //# sourceMappingURL=telemetry.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * A reusable timer that wraps setTimeout with browser-safe unref support.
+ * In Node.js, unref() prevents the timer from keeping the process alive.
+ * In browsers (or environments without unref), the call is safely skipped.
+ */
+export declare class Timer {
+    private timerId;
+    schedule(callback: () => void, delayMs: number): void;
+    cancel(): void;
+    get isScheduled(): boolean;
+}
+//# sourceMappingURL=timer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../../src/telemetry/timer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,KAAK;IACd,OAAO,CAAC,OAAO,CAA4C;IAE3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQrD,MAAM,IAAI,IAAI;IAOd,IAAI,WAAW,IAAI,OAAO,CAEzB;CACJ"}

package/dist/cjs/telemetry/timer.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+/**
+ * A reusable timer that wraps setTimeout with browser-safe unref support.
+ * In Node.js, unref() prevents the timer from keeping the process alive.
+ * In browsers (or environments without unref), the call is safely skipped.
+ */
+class Timer {
+    schedule(callback, delayMs) {
+        this.cancel();
+        this.timerId = setTimeout(callback, delayMs);
+        if (typeof this.timerId?.unref === "function") {
+            this.timerId.unref();
+        }
+    }
+    cancel() {
+        if (this.timerId !== undefined) {
+            clearTimeout(this.timerId);
+            this.timerId = undefined;
+        }
+    }
+    get isScheduled() {
+        return this.timerId !== undefined;
+    }
+}
+exports.Timer = Timer;
+//# sourceMappingURL=timer.js.map