mcp-server-framework 1.0.0

package/build/connection/connection-state.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Connection State Manager
+ *
+ * Manages the connection state to a backend service and notifies
+ * listeners when the state changes. This enables dynamic tool
+ * availability based on connection status.
+ *
+ * Generic implementation works with any service client implementing ServiceClient.
+ *
+ * @module connection/connection-state
+ */
+import type { ServiceClient } from "./types.js";
+import type { ConnectionState, ConnectionStateListener, ConnectionStateEvent, ConnectionTelemetry } from "./core/types.js";
+export type { ConnectionState } from "./core/types.js";
+/**
+ * Options for automatic reconnection with exponential backoff.
+ *
+ * When auto-reconnect is enabled, the ConnectionStateManager will
+ * automatically attempt to re-establish the connection when the
+ * state transitions to 'error'.
+ *
+ * This handles reconnection to the **API backend** (e.g. a REST API service),
+ * NOT MCP transport reconnection (which is client-side, handled by the SDK).
+ */
+export interface ReconnectOptions {
+    /** Maximum number of reconnect attempts before giving up. Default: 5 */
+    readonly maxRetries?: number;
+    /** Initial delay before the first reconnect attempt in ms. Default: 1000 */
+    readonly initialDelayMs?: number;
+    /** Maximum delay between attempts in ms (caps exponential growth). Default: 30000 */
+    readonly maxDelayMs?: number;
+    /** Multiplier for exponential backoff. Default: 1.5 */
+    readonly backoffMultiplier?: number;
+}
+/**
+ * Options for ConnectionStateManager construction.
+ */
+export interface ConnectionStateOptions {
+    /** Optional telemetry implementation (defaults to no-op). */
+    readonly telemetry?: ConnectionTelemetry;
+    /** Health check timeout in milliseconds. Default: 10000 */
+    readonly healthCheckTimeoutMs?: number;
+}
+/**
+ * Manages the connection state to a backend service.
+ *
+ * Generic implementation that works with any client implementing ServiceClient.
+ *
+ * Features:
+ * - Tracks connection state (disconnected, connecting, connected, error)
+ * - Notifies listeners when state changes
+ * - Provides current client instance
+ * - Supports health check validation
+ * - Uses circular buffer for efficient history management (O(1) operations)
+ *
+ * @typeParam TService - The service client type (must implement ServiceClient)
+ *
+ * @example
+ * ```typescript
+ * const manager = new ConnectionStateManager<MyServiceClient>();
+ * manager.onStateChange((state, client) => {
+ *   if (state === 'connected') {
+ *     console.log('Connected!');
+ *   }
+ * });
+ * await manager.connect(serviceClient);
+ *
+ * // With any ServiceClient implementation
+ * const genericManager = new ConnectionStateManager<MyServiceClient>();
+ * ```
+ */
+export declare class ConnectionStateManager<TService extends ServiceClient = ServiceClient> {
+    private state;
+    private client;
+    private lastError;
+    private listeners;
+    /** Injected telemetry — defaults to no-op when not provided. */
+    private readonly telemetry;
+    /** Health check timeout in milliseconds. */
+    private readonly healthCheckTimeoutMs;
+    private readonly maxHistorySize;
+    private stateHistory;
+    private historyIndex;
+    private historyCount;
+    private _reconnectAbort;
+    private _reconnectUnsubscribe;
+    /**
+     * Create a new ConnectionStateManager.
+     *
+     * @param options - Optional configuration (telemetry, healthCheckTimeoutMs).
+     *   Also accepts a bare `ConnectionTelemetry` for backwards compatibility.
+     */
+    constructor(options?: ConnectionStateOptions | ConnectionTelemetry);
+    /**
+     * Get the current connection state.
+     */
+    getState(): ConnectionState;
+    /**
+     * Get the current service client instance.
+     * Returns null if not connected.
+     */
+    getClient(): TService | null;
+    /**
+     * Check if the client is currently connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Get the last error that occurred (if any).
+     */
+    getLastError(): Error | null;
+    /**
+     * Get the connection state history.
+     * Returns the most recent state changes (up to maxHistorySize).
+     * History is returned in chronological order (oldest first).
+     */
+    getHistory(): readonly ConnectionStateEvent[];
+    /**
+     * Register a listener for connection state changes.
+     *
+     * @param listener - Function to call when state changes
+     * @returns Unsubscribe function
+     */
+    onStateChange(listener: ConnectionStateListener<TService>): () => void;
+    /**
+     * Set the connection state to 'connecting'.
+     * Call this before attempting to connect.
+     */
+    setConnecting(): void;
+    /**
+     * Set the client and mark as connected.
+     * Validates the connection with a health check before completing.
+     * Includes OpenTelemetry tracing for the connection process.
+     *
+     * @param client - The authenticated service client
+     * @param skipHealthCheck - Skip health check validation (for testing)
+     * @returns true if connection was successful
+     */
+    connect(client: TService, skipHealthCheck?: boolean): Promise<boolean>;
+    /**
+     * Perform health check validation against the service client.
+     * Throws if the health check fails or times out.
+     */
+    private performHealthCheck;
+    /**
+     * Disconnect from the backend service.
+     * Calls {@link ServiceClient.disconnect} if the client implements it,
+     * then clears the client reference and sets state to 'disconnected'.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Set connection error state.
+     *
+     * @param error - The error that occurred
+     */
+    setError(error: Error): void;
+    /**
+     * Enable automatic reconnection with exponential backoff.
+     *
+     * When the connection state transitions to 'error', the manager will
+     * automatically attempt to reconnect using the stored client instance.
+     * Subsequent attempts use exponential backoff up to `maxDelayMs`.
+     *
+     * This handles reconnection to the **API backend**, NOT MCP transport
+     * reconnection (which is client-side, handled by the SDK's
+     * `StreamableHTTPReconnectionOptions`).
+     *
+     * @param options - Reconnect configuration (all fields optional with sensible defaults)
+     */
+    enableAutoReconnect(options?: ReconnectOptions): void;
+    /**
+     * Disable automatic reconnection.
+     * Aborts any in-flight reconnect attempt and removes the listener.
+     */
+    disableAutoReconnect(): void;
+    /**
+     * Internal reconnect loop with exponential backoff.
+     */
+    private attemptReconnect;
+    /**
+     * Clear all listeners.
+     * Useful for cleanup during shutdown.
+     */
+    clearListeners(): void;
+    /**
+     * Reset the connection manager to initial state.
+     * Useful for testing or complete reset scenarios.
+     */
+    reset(): void;
+    /**
+     * Internal method to update state and notify listeners.
+     * Uses circular buffer for O(1) history management.
+     * Records metrics for state transitions.
+     */
+    private setState;
+}
+//# sourceMappingURL=connection-state.d.ts.map

package/build/connection/connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../src/connection/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAezB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAsB,CAAC,QAAQ,SAAS,aAAa,GAAG,aAAa;IAChF,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAqD;IAEtE,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAEhD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAI9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAC3E,OAAO,CAAC,YAAY,CAA8E;IAClG,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;IAGzB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,qBAAqB,CAA6B;IAE1D;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,sBAAsB,GAAG,mBAAmB;IAWlE;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;;OAGG;IACH,SAAS,IAAI,QAAQ,GAAG,IAAI;IAI5B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,IAAI,KAAK,GAAG,IAAI;IAI5B;;;;OAIG;IACH,UAAU,IAAI,SAAS,oBAAoB,EAAE;IAmB7C;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI;IAKtE;;;OAGG;IACH,aAAa,IAAI,IAAI;IAIrB;;;;;;;;OAQG;IACG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAkC1E;;;OAGG;YACW,kBAAkB;IA6ChC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK5B;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAkBrD;;;OAGG;IACH,oBAAoB,IAAI,IAAI;IAY5B;;OAEG;YACW,gBAAgB;IAqE9B;;;OAGG;IACH,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAYb;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CA2DjB"}

package/build/connection/connection-state.js

@@ -0,0 +1,426 @@
+/**
+ * Connection State Manager
+ *
+ * Manages the connection state to a backend service and notifies
+ * listeners when the state changes. This enables dynamic tool
+ * availability based on connection status.
+ *
+ * Generic implementation works with any service client implementing ServiceClient.
+ *
+ * @module connection/connection-state
+ */
+import { logger as baseLogger } from "../logger/index.js";
+import { ConnectionError } from "../errors/index.js";
+import { NO_OP_TELEMETRY } from "./core/types.js";
+import { CONNECTION_STATE_CONFIG, CONNECTION_LOG_COMPONENTS, ConnectionStateLogMessages, VALID_STATE_TRANSITIONS, RECONNECT_DEFAULTS, } from "./core/constants.js";
+const logger = baseLogger.child({
+    component: CONNECTION_LOG_COMPONENTS.CONNECTION_STATE,
+});
+/**
+ * Manages the connection state to a backend service.
+ *
+ * Generic implementation that works with any client implementing ServiceClient.
+ *
+ * Features:
+ * - Tracks connection state (disconnected, connecting, connected, error)
+ * - Notifies listeners when state changes
+ * - Provides current client instance
+ * - Supports health check validation
+ * - Uses circular buffer for efficient history management (O(1) operations)
+ *
+ * @typeParam TService - The service client type (must implement ServiceClient)
+ *
+ * @example
+ * ```typescript
+ * const manager = new ConnectionStateManager<MyServiceClient>();
+ * manager.onStateChange((state, client) => {
+ *   if (state === 'connected') {
+ *     console.log('Connected!');
+ *   }
+ * });
+ * await manager.connect(serviceClient);
+ *
+ * // With any ServiceClient implementation
+ * const genericManager = new ConnectionStateManager<MyServiceClient>();
+ * ```
+ */
+export class ConnectionStateManager {
+    state = "disconnected";
+    client = null;
+    lastError = null;
+    listeners = new Set();
+    /** Injected telemetry — defaults to no-op when not provided. */
+    telemetry;
+    /** Health check timeout in milliseconds. */
+    healthCheckTimeoutMs;
+    // Performance: Use circular buffer instead of array with shift()
+    // shift() is O(n), circular buffer is O(1)
+    maxHistorySize = CONNECTION_STATE_CONFIG.MAX_HISTORY_SIZE;
+    stateHistory = new Array(this.maxHistorySize).fill(null);
+    historyIndex = 0;
+    historyCount = 0;
+    // Auto-reconnect state
+    _reconnectAbort = null;
+    _reconnectUnsubscribe = null;
+    /**
+     * Create a new ConnectionStateManager.
+     *
+     * @param options - Optional configuration (telemetry, healthCheckTimeoutMs).
+     *   Also accepts a bare `ConnectionTelemetry` for backwards compatibility.
+     */
+    constructor(options) {
+        // Backwards compatibility: accept bare telemetry object
+        if (options && "withSpan" in options) {
+            this.telemetry = options;
+            this.healthCheckTimeoutMs = CONNECTION_STATE_CONFIG.HEALTH_CHECK_TIMEOUT_MS;
+        }
+        else {
+            this.telemetry = options?.telemetry ?? NO_OP_TELEMETRY;
+            this.healthCheckTimeoutMs = options?.healthCheckTimeoutMs ?? CONNECTION_STATE_CONFIG.HEALTH_CHECK_TIMEOUT_MS;
+        }
+    }
+    /**
+     * Get the current connection state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get the current service client instance.
+     * Returns null if not connected.
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Check if the client is currently connected.
+     */
+    isConnected() {
+        return this.state === "connected" && this.client !== null;
+    }
+    /**
+     * Get the last error that occurred (if any).
+     */
+    getLastError() {
+        return this.lastError;
+    }
+    /**
+     * Get the connection state history.
+     * Returns the most recent state changes (up to maxHistorySize).
+     * History is returned in chronological order (oldest first).
+     */
+    getHistory() {
+        // Reconstruct array from circular buffer in chronological order
+        const result = [];
+        for (let i = 0; i < this.historyCount; i++) {
+            // Circular buffer read: start from the oldest entry and walk forward.
+            // historyIndex points to the NEXT write position, so the oldest entry
+            // is at (historyIndex - historyCount). Adding maxHistorySize before
+            // modulo prevents negative indices.
+            const index = (this.historyIndex - this.historyCount + i + this.maxHistorySize) % this.maxHistorySize;
+            const event = this.stateHistory[index];
+            /* v8 ignore start - defensive check for circular buffer integrity */
+            if (event) {
+                result.push(event);
+            }
+            /* v8 ignore stop */
+        }
+        return result;
+    }
+    /**
+     * Register a listener for connection state changes.
+     *
+     * @param listener - Function to call when state changes
+     * @returns Unsubscribe function
+     */
+    onStateChange(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Set the connection state to 'connecting'.
+     * Call this before attempting to connect.
+     */
+    setConnecting() {
+        this.setState("connecting");
+    }
+    /**
+     * Set the client and mark as connected.
+     * Validates the connection with a health check before completing.
+     * Includes OpenTelemetry tracing for the connection process.
+     *
+     * @param client - The authenticated service client
+     * @param skipHealthCheck - Skip health check validation (for testing)
+     * @returns true if connection was successful
+     */
+    async connect(client, skipHealthCheck = false) {
+        return this.telemetry.withSpan("api.connection.connect", async (span) => {
+            this.setState("connecting");
+            logger.debug(ConnectionStateLogMessages.CONNECTING);
+            this.telemetry.addSpanAttributes({
+                "mcp.operation": "connect",
+                "connection.skip_health_check": skipHealthCheck,
+                "connection.client_type": client.clientType,
+            });
+            try {
+                if (!skipHealthCheck) {
+                    await this.performHealthCheck(client);
+                }
+                this.client = client;
+                this.lastError = null;
+                this.setState("connected");
+                this.telemetry.addSpanEvent("connection.established");
+                return true;
+                /* v8 ignore start - catch block for connection errors */
+            }
+            catch (error) {
+                this.lastError = error instanceof Error ? error : new Error(String(error));
+                this.setState("error", this.lastError);
+                span.setAttribute("error.message", this.lastError.message);
+                logger.error(ConnectionStateLogMessages.ERROR_STATE, this.lastError.message);
+                return false;
+            }
+            /* v8 ignore stop */
+        });
+    }
+    /**
+     * Perform health check validation against the service client.
+     * Throws if the health check fails or times out.
+     */
+    async performHealthCheck(client) {
+        const healthCheckFn = client.healthCheck?.bind(client);
+        if (!healthCheckFn) {
+            // No healthCheck method — assume healthy
+            this.telemetry.addSpanEvent("health_check.skipped", {
+                reason: "not_implemented",
+            });
+            logger.debug(ConnectionStateLogMessages.HEALTH_CHECK_SKIPPED);
+            return;
+        }
+        this.telemetry.addSpanEvent("health_check.start");
+        const timeoutMs = this.healthCheckTimeoutMs;
+        logger.trace(ConnectionStateLogMessages.HEALTH_CHECK_START);
+        let timer;
+        try {
+            const health = await Promise.race([
+                healthCheckFn(),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(new Error(`Health check timed out after ${timeoutMs}ms`)), timeoutMs);
+                }),
+            ]);
+            if (health.status !== "healthy") {
+                this.telemetry.addSpanEvent("health_check.failed", {
+                    "health.message": health.message || "unknown",
+                });
+                logger.warn(ConnectionStateLogMessages.HEALTH_CHECK_FAILED, health.message || "unknown");
+                throw ConnectionError.healthCheckFailed(health.message || "unknown");
+            }
+            this.telemetry.addSpanEvent("health_check.success", {
+                "health.status": health.status,
+                "health.message": health.message || "ok",
+            });
+            /* v8 ignore next - optional API version logging */
+            logger.debug(ConnectionStateLogMessages.HEALTH_CHECK_SUCCESS);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+    }
+    /**
+     * Disconnect from the backend service.
+     * Calls {@link ServiceClient.disconnect} if the client implements it,
+     * then clears the client reference and sets state to 'disconnected'.
+     */
+    async disconnect() {
+        // Stop auto-reconnect so it doesn't trigger on the disconnect state change
+        this.disableAutoReconnect();
+        this.telemetry.addSpanEvent("connection.disconnect");
+        // Allow client to release its own resources (sockets, pools, timers)
+        if (this.client && typeof this.client.disconnect === "function") {
+            try {
+                await this.client.disconnect();
+            }
+            catch (error) {
+                logger.warn(ConnectionStateLogMessages.CLIENT_DISCONNECT_ERROR, String(error));
+            }
+        }
+        this.client = null;
+        this.lastError = null;
+        this.setState("disconnected");
+        logger.info(ConnectionStateLogMessages.DISCONNECTED);
+    }
+    /**
+     * Set connection error state.
+     *
+     * @param error - The error that occurred
+     */
+    setError(error) {
+        this.lastError = error;
+        this.setState("error", error);
+    }
+    /**
+     * Enable automatic reconnection with exponential backoff.
+     *
+     * When the connection state transitions to 'error', the manager will
+     * automatically attempt to reconnect using the stored client instance.
+     * Subsequent attempts use exponential backoff up to `maxDelayMs`.
+     *
+     * This handles reconnection to the **API backend**, NOT MCP transport
+     * reconnection (which is client-side, handled by the SDK's
+     * `StreamableHTTPReconnectionOptions`).
+     *
+     * @param options - Reconnect configuration (all fields optional with sensible defaults)
+     */
+    enableAutoReconnect(options) {
+        // Disable any existing reconnect before re-enabling
+        this.disableAutoReconnect();
+        const maxRetries = options?.maxRetries ?? RECONNECT_DEFAULTS.MAX_RETRIES;
+        const initialDelayMs = options?.initialDelayMs ?? RECONNECT_DEFAULTS.INITIAL_DELAY_MS;
+        const maxDelayMs = options?.maxDelayMs ?? RECONNECT_DEFAULTS.MAX_DELAY_MS;
+        const backoffMultiplier = options?.backoffMultiplier ?? RECONNECT_DEFAULTS.BACKOFF_MULTIPLIER;
+        logger.info(ConnectionStateLogMessages.RECONNECT_ENABLED, maxRetries, initialDelayMs, maxDelayMs);
+        this._reconnectUnsubscribe = this.onStateChange((state) => {
+            if (state === "error" && !this._reconnectAbort) {
+                void this.attemptReconnect(maxRetries, initialDelayMs, maxDelayMs, backoffMultiplier);
+            }
+        });
+    }
+    /**
+     * Disable automatic reconnection.
+     * Aborts any in-flight reconnect attempt and removes the listener.
+     */
+    disableAutoReconnect() {
+        if (this._reconnectAbort) {
+            this._reconnectAbort.abort();
+            this._reconnectAbort = null;
+        }
+        if (this._reconnectUnsubscribe) {
+            this._reconnectUnsubscribe();
+            this._reconnectUnsubscribe = null;
+            logger.info(ConnectionStateLogMessages.RECONNECT_DISABLED);
+        }
+    }
+    /**
+     * Internal reconnect loop with exponential backoff.
+     */
+    async attemptReconnect(maxRetries, initialDelayMs, maxDelayMs, backoffMultiplier) {
+        // Abort any previous reconnect loop
+        this._reconnectAbort?.abort();
+        const abort = new AbortController();
+        this._reconnectAbort = abort;
+        const client = this.client;
+        if (!client) {
+            // No client to reconnect with — nothing we can do
+            this._reconnectAbort = null;
+            return;
+        }
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            if (abort.signal.aborted) {
+                logger.debug(ConnectionStateLogMessages.RECONNECT_ABORTED);
+                this._reconnectAbort = null;
+                return;
+            }
+            const baseDelay = Math.min(initialDelayMs * backoffMultiplier ** (attempt - 1), maxDelayMs);
+            // Add jitter (±25%) to prevent thundering herd on concurrent reconnects
+            const jitter = baseDelay * (0.75 + Math.random() * 0.5);
+            const delay = Math.min(jitter, maxDelayMs);
+            logger.info(ConnectionStateLogMessages.RECONNECT_ATTEMPT, attempt, maxRetries, Math.round(delay));
+            // Wait with abort support
+            await new Promise((resolve) => {
+                const timer = setTimeout(resolve, delay);
+                abort.signal.addEventListener("abort", () => {
+                    clearTimeout(timer);
+                    resolve();
+                }, { once: true });
+            });
+            if (abort.signal.aborted) {
+                logger.debug(ConnectionStateLogMessages.RECONNECT_ABORTED);
+                this._reconnectAbort = null;
+                return;
+            }
+            const success = await this.connect(client);
+            if (success) {
+                logger.info(ConnectionStateLogMessages.RECONNECT_SUCCESS, attempt);
+                this._reconnectAbort = null;
+                return;
+            }
+            logger.warn(ConnectionStateLogMessages.RECONNECT_FAILED, attempt, maxRetries, this.lastError?.message ?? "unknown");
+        }
+        this._reconnectAbort = null;
+        logger.error(ConnectionStateLogMessages.RECONNECT_EXHAUSTED, maxRetries);
+    }
+    /**
+     * Clear all listeners.
+     * Useful for cleanup during shutdown.
+     */
+    clearListeners() {
+        this.listeners.clear();
+    }
+    /**
+     * Reset the connection manager to initial state.
+     * Useful for testing or complete reset scenarios.
+     */
+    reset() {
+        this.disableAutoReconnect();
+        this.state = "disconnected";
+        this.client = null;
+        this.lastError = null;
+        this.listeners.clear();
+        // Reset circular buffer
+        this.stateHistory = new Array(this.maxHistorySize).fill(null);
+        this.historyIndex = 0;
+        this.historyCount = 0;
+    }
+    /**
+     * Internal method to update state and notify listeners.
+     * Uses circular buffer for O(1) history management.
+     * Records metrics for state transitions.
+     */
+    setState(newState, error) {
+        const previousState = this.state;
+        if (previousState === newState) {
+            return; // No change
+        }
+        // Validate state transition (strict — reject invalid transitions)
+        const allowed = VALID_STATE_TRANSITIONS[previousState];
+        if (allowed && !allowed.includes(newState)) {
+            logger.warn(ConnectionStateLogMessages.INVALID_TRANSITION, previousState, newState, previousState, allowed.join(", "));
+            return; // Reject invalid transition
+        }
+        this.state = newState;
+        // Record state transition in metrics
+        this.telemetry.recordConnectionStateChange(previousState, newState);
+        // Add telemetry event for state change
+        this.telemetry.addSpanEvent("connection.state_change", {
+            "connection.state.previous": previousState,
+            "connection.state.current": newState,
+            "connection.error": error?.message,
+        });
+        const event = {
+            previousState,
+            currentState: newState,
+            clientType: this.client?.clientType ?? null,
+            error,
+            timestamp: new Date(),
+        };
+        // Add to circular buffer - O(1) operation instead of shift() which is O(n)
+        this.stateHistory[this.historyIndex] = event;
+        this.historyIndex = (this.historyIndex + 1) % this.maxHistorySize;
+        if (this.historyCount < this.maxHistorySize) {
+            this.historyCount++;
+        }
+        logger.trace(ConnectionStateLogMessages.STATE_CHANGE, previousState, newState);
+        // Notify listeners
+        for (const listener of this.listeners) {
+            try {
+                listener(newState, this.client, error);
+            }
+            catch (listenerError) {
+                const errorMessage = listenerError instanceof Error ? listenerError.message : String(listenerError);
+                logger.error(ConnectionStateLogMessages.LISTENER_ERROR, errorMessage);
+            }
+        }
+    }
+}
+//# sourceMappingURL=connection-state.js.map

package/build/connection/connection-state.js.map

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