atproto-mcp 0.1.0

package/dist/utils/config.js

@@ -0,0 +1,311 @@
+/**
+ * Configuration management system for the AT Protocol MCP Server
+ * Handles environment variables, command-line arguments, and default settings
+ */
+import { z } from 'zod';
+import { ConfigurationError } from '../types/index.js';
+import { Logger } from './logger.js';
+const logger = new Logger('Config');
+/**
+ * Zod schema for AT Protocol configuration validation
+ * Authentication credentials are now optional to support unauthenticated mode
+ */
+const AtpConfigSchema = z.object({
+    service: z.string().url('AT Protocol service must be a valid URL'),
+    identifier: z.string().optional(),
+    password: z.string().optional(),
+    clientId: z.string().optional(),
+    clientSecret: z.string().optional(),
+    authMethod: z.enum(['app-password', 'oauth']).optional(),
+});
+/**
+ * Zod schema for MCP server configuration validation
+ */
+const McpServerConfigSchema = z.object({
+    port: z.number().int().min(1).max(65535),
+    host: z.string().min(1),
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string().min(1),
+    atproto: AtpConfigSchema,
+});
+/**
+ * Default configuration values
+ * Authentication is now optional - server works in unauthenticated mode by default
+ */
+function createDefaultConfig() {
+    // Determine if we have authentication credentials
+    const hasAppPasswordCreds = !!(process.env['ATPROTO_IDENTIFIER'] != null &&
+        process.env['ATPROTO_IDENTIFIER'] !== '' &&
+        process.env['ATPROTO_PASSWORD'] != null &&
+        process.env['ATPROTO_PASSWORD'] !== '');
+    const hasOAuthCreds = !!(process.env['ATPROTO_CLIENT_ID'] != null &&
+        process.env['ATPROTO_CLIENT_ID'] !== '' &&
+        process.env['ATPROTO_CLIENT_SECRET'] != null &&
+        process.env['ATPROTO_CLIENT_SECRET'] !== '');
+    // Default to app-password if we have those credentials, otherwise no auth method
+    let defaultAuthMethod;
+    if (hasAppPasswordCreds) {
+        defaultAuthMethod = 'app-password';
+    }
+    else if (hasOAuthCreds) {
+        defaultAuthMethod = 'oauth';
+    }
+    return {
+        port: 3000,
+        host: 'localhost',
+        name: 'atproto-mcp',
+        version: '0.1.0',
+        description: 'AT Protocol MCP Server - Comprehensive interface for LLMs to interact with AT Protocol (supports both authenticated and unauthenticated modes)',
+        atproto: {
+            service: 'https://bsky.social',
+            // Only set auth method if we have credentials
+            ...(defaultAuthMethod != null && { authMethod: defaultAuthMethod }),
+            // Include credentials if available
+            ...(process.env['ATPROTO_IDENTIFIER'] != null &&
+                process.env['ATPROTO_IDENTIFIER'] !== '' && {
+                identifier: process.env['ATPROTO_IDENTIFIER'],
+            }),
+            ...(process.env['ATPROTO_PASSWORD'] != null &&
+                process.env['ATPROTO_PASSWORD'] !== '' && { password: process.env['ATPROTO_PASSWORD'] }),
+            ...(process.env['ATPROTO_CLIENT_ID'] != null &&
+                process.env['ATPROTO_CLIENT_ID'] !== '' && { clientId: process.env['ATPROTO_CLIENT_ID'] }),
+            ...(process.env['ATPROTO_CLIENT_SECRET'] != null &&
+                process.env['ATPROTO_CLIENT_SECRET'] !== '' && {
+                clientSecret: process.env['ATPROTO_CLIENT_SECRET'],
+            }),
+        },
+    };
+}
+/**
+ * Environment variable mappings
+ */
+const ENV_MAPPINGS = {
+    MCP_SERVER_PORT: 'port',
+    MCP_SERVER_HOST: 'host',
+    MCP_SERVER_NAME: 'name',
+    ATPROTO_SERVICE: 'atproto.service',
+    ATPROTO_IDENTIFIER: 'atproto.identifier',
+    ATPROTO_PASSWORD: 'atproto.password',
+    ATPROTO_CLIENT_ID: 'atproto.clientId',
+    ATPROTO_CLIENT_SECRET: 'atproto.clientSecret',
+    ATPROTO_AUTH_METHOD: 'atproto.authMethod',
+};
+/**
+ * Configuration manager class
+ */
+export class ConfigManager {
+    config;
+    constructor(overrides = {}) {
+        this.config = this.buildConfig(overrides);
+        this.validateConfig();
+        this.logConfiguration();
+    }
+    /**
+     * Build configuration from defaults, environment variables, and overrides
+     */
+    buildConfig(overrides) {
+        // Start with defaults
+        let config = createDefaultConfig();
+        // Apply environment variables
+        config = this.applyEnvironmentVariables(config);
+        // Apply overrides (highest priority)
+        config = this.mergeConfig(config, overrides);
+        return config;
+    }
+    /**
+     * Apply environment variables to configuration
+     */
+    applyEnvironmentVariables(config) {
+        const envConfig = {};
+        for (const [envVar, configPath] of Object.entries(ENV_MAPPINGS)) {
+            const value = process.env[envVar];
+            if (value !== undefined) {
+                this.setNestedProperty(envConfig, configPath, this.parseEnvValue(value));
+            }
+        }
+        return this.mergeConfig(config, envConfig);
+    }
+    /**
+     * Parse environment variable value to appropriate type
+     */
+    parseEnvValue(value) {
+        // Try to parse as number
+        const numValue = Number(value);
+        if (!isNaN(numValue) && isFinite(numValue)) {
+            return numValue;
+        }
+        return value;
+    }
+    /**
+     * Set nested property using dot notation
+     */
+    setNestedProperty(obj, path, value) {
+        const keys = path.split('.');
+        let current = obj;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!(key in current) || typeof current[key] !== 'object') {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        const finalKey = keys[keys.length - 1];
+        current[finalKey] = value;
+    }
+    /**
+     * Deep merge configuration objects
+     */
+    mergeConfig(base, override) {
+        const result = { ...base };
+        for (const [key, value] of Object.entries(override)) {
+            if (value !== undefined) {
+                if (key === 'atproto' && typeof value === 'object' && value !== null) {
+                    result.atproto = { ...result.atproto, ...value };
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Validate configuration using Zod schema
+     */
+    validateConfig() {
+        try {
+            McpServerConfigSchema.parse(this.config);
+            this.validateAuthConfiguration();
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`);
+                throw new ConfigurationError(`Configuration validation failed: ${issues.join(', ')}`, {
+                    issues,
+                });
+            }
+            throw error;
+        }
+    }
+    /**
+     * Validate authentication configuration
+     * Authentication is now optional - only validate if auth method is specified
+     */
+    validateAuthConfiguration() {
+        const { atproto } = this.config;
+        // Skip validation in test environment if credentials are not provided
+        const isTestEnv = process.env['NODE_ENV'] === 'test';
+        // If no auth method is specified, we're in unauthenticated mode - no validation needed
+        if (!atproto.authMethod) {
+            return;
+        }
+        if (atproto.authMethod === 'app-password') {
+            if (!isTestEnv && (!atproto.identifier || !atproto.password)) {
+                throw new ConfigurationError('App password authentication requires both identifier and password', { authMethod: atproto.authMethod });
+            }
+        }
+        else if (atproto.authMethod === 'oauth') {
+            if (!isTestEnv && (!atproto.clientId || !atproto.clientSecret)) {
+                throw new ConfigurationError('OAuth authentication requires both clientId and clientSecret', { authMethod: atproto.authMethod });
+            }
+        }
+    }
+    /**
+     * Log configuration (excluding sensitive data)
+     */
+    logConfiguration() {
+        const safeConfig = {
+            ...this.config,
+            atproto: {
+                ...this.config.atproto,
+                password: this.config.atproto.password ? '[REDACTED]' : undefined,
+                clientSecret: this.config.atproto.clientSecret ? '[REDACTED]' : undefined,
+            },
+        };
+        logger.info('Configuration loaded', safeConfig);
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get AT Protocol configuration
+     */
+    getAtpConfig() {
+        return { ...this.config.atproto };
+    }
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(updates) {
+        const newConfig = this.mergeConfig(this.config, updates);
+        // Validate the new configuration
+        try {
+            McpServerConfigSchema.parse(newConfig);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                const issues = error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`);
+                throw new ConfigurationError(`Configuration update validation failed: ${issues.join(', ')}`, { issues });
+            }
+            throw error;
+        }
+        this.config = newConfig;
+        logger.info('Configuration updated');
+    }
+    /**
+     * Check if configuration is valid for the specified auth method
+     */
+    isValidForAuth(authMethod) {
+        try {
+            const testConfig = { ...this.config, atproto: { ...this.config.atproto, authMethod } };
+            McpServerConfigSchema.parse(testConfig);
+            // Additional validation for auth method requirements
+            if (authMethod === 'app-password') {
+                return !!(testConfig.atproto.identifier && testConfig.atproto.password);
+            }
+            else if (authMethod === 'oauth') {
+                return !!(testConfig.atproto.clientId && testConfig.atproto.clientSecret);
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if authentication is configured
+     */
+    hasAuthentication() {
+        const { atproto } = this.config;
+        if (!atproto.authMethod) {
+            return false;
+        }
+        if (atproto.authMethod === 'app-password') {
+            return !!(atproto.identifier && atproto.password);
+        }
+        else if (atproto.authMethod === 'oauth') {
+            return !!(atproto.clientId && atproto.clientSecret);
+        }
+        return false;
+    }
+    /**
+     * Get authentication mode description
+     */
+    getAuthMode() {
+        if (!this.hasAuthentication()) {
+            return 'unauthenticated';
+        }
+        return this.config.atproto.authMethod;
+    }
+}
+/**
+ * Create a configuration manager instance
+ */
+export function createConfig(overrides = {}) {
+    return new ConfigManager(overrides);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/firehose-client.d.ts

@@ -0,0 +1,96 @@
+/**
+ * AT Protocol Firehose Client for real-time streaming
+ */
+import { EventEmitter } from 'events';
+import type { IAtpConfig } from '../types/index.js';
+export interface IFirehoseEvent {
+    type: 'commit' | 'handle' | 'migrate' | 'tombstone';
+    seq: number;
+    time: string;
+    repo: string;
+    commit?: {
+        rev: string;
+        operation: 'create' | 'update' | 'delete';
+        collection: string;
+        rkey: string;
+        record?: any;
+        cid?: string;
+    };
+}
+export interface IFirehoseSubscription {
+    id: string;
+    collections?: string[];
+    onEvent: (event: IFirehoseEvent) => void;
+    onError?: (error: Error) => void;
+}
+export declare class FirehoseClient extends EventEmitter {
+    private ws;
+    private logger;
+    private config;
+    private subscriptions;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelay;
+    private isConnecting;
+    private isShuttingDown;
+    private heartbeatInterval;
+    private lastSeq;
+    constructor(config: IAtpConfig);
+    /**
+     * Connect to the AT Protocol firehose
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the firehose
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Subscribe to firehose events
+     */
+    subscribe(subscription: IFirehoseSubscription): void;
+    /**
+     * Unsubscribe from firehose events
+     */
+    unsubscribe(subscriptionId: string): void;
+    /**
+     * Get connection status
+     */
+    isConnected(): boolean;
+    /**
+     * Get the last processed sequence number
+     */
+    getLastSeq(): number | null;
+    /**
+     * Get firehose WebSocket URL
+     */
+    private getFirehoseUrl;
+    /**
+     * Handle incoming firehose message
+     */
+    private handleMessage;
+    /**
+     * Parse firehose message (simplified implementation)
+     */
+    private parseFirehoseMessage;
+    /**
+     * Process firehose event and notify subscribers
+     */
+    private processEvent;
+    /**
+     * Check if event matches subscription criteria
+     */
+    private matchesSubscription;
+    /**
+     * Schedule reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    private startHeartbeat;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+}
+//# sourceMappingURL=firehose-client.d.ts.map

package/dist/utils/firehose-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firehose-client.d.ts","sourceRoot":"","sources":["../../src/utils/firehose-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,aAAa,CAA4C;IACjE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAA+B;IACxD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,MAAM,EAAE,UAAU;IAM9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+D9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,qBAAqB,GAAG,IAAI;IAQpD;;OAEG;IACH,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAKzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAI3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,OAAO;CAQhB"}

package/dist/utils/firehose-client.js

@@ -0,0 +1,252 @@
+/**
+ * AT Protocol Firehose Client for real-time streaming
+ */
+import { WebSocket } from 'ws';
+import { EventEmitter } from 'events';
+import { Logger } from './logger.js';
+export class FirehoseClient extends EventEmitter {
+    ws = null;
+    logger;
+    config;
+    subscriptions = new Map();
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 10;
+    reconnectDelay = 1000; // Start with 1 second
+    isConnecting = false;
+    isShuttingDown = false;
+    heartbeatInterval = null;
+    lastSeq = null;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.logger = new Logger('FirehoseClient');
+    }
+    /**
+     * Connect to the AT Protocol firehose
+     */
+    async connect() {
+        if (this.isConnecting || this.ws?.readyState === WebSocket.OPEN) {
+            return;
+        }
+        this.isConnecting = true;
+        this.isShuttingDown = false;
+        try {
+            const firehoseUrl = this.getFirehoseUrl();
+            this.logger.info('Connecting to AT Protocol firehose', { url: firehoseUrl });
+            this.ws = new WebSocket(firehoseUrl);
+            this.ws.on('open', () => {
+                this.logger.info('Firehose connection established');
+                this.isConnecting = false;
+                this.reconnectAttempts = 0;
+                this.reconnectDelay = 1000;
+                this.startHeartbeat();
+                this.emit('connected');
+            });
+            this.ws.on('message', (data) => {
+                try {
+                    this.handleMessage(data);
+                }
+                catch (error) {
+                    this.logger.error('Error handling firehose message', error);
+                    this.emit('error', error);
+                }
+            });
+            this.ws.on('close', (code, reason) => {
+                this.logger.warn('Firehose connection closed', {
+                    code,
+                    reason: reason.toString(),
+                    reconnectAttempts: this.reconnectAttempts,
+                });
+                this.cleanup();
+                this.emit('disconnected', { code, reason: reason.toString() });
+                if (!this.isShuttingDown && this.reconnectAttempts < this.maxReconnectAttempts) {
+                    this.scheduleReconnect();
+                }
+            });
+            this.ws.on('error', (error) => {
+                this.logger.error('Firehose connection error', error);
+                this.cleanup();
+                this.emit('error', error);
+                if (!this.isShuttingDown && this.reconnectAttempts < this.maxReconnectAttempts) {
+                    this.scheduleReconnect();
+                }
+            });
+        }
+        catch (error) {
+            this.isConnecting = false;
+            this.logger.error('Failed to connect to firehose', error);
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from the firehose
+     */
+    async disconnect() {
+        this.isShuttingDown = true;
+        this.cleanup();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.logger.info('Firehose client disconnected');
+        this.emit('disconnected', { code: 1000, reason: 'Client disconnect' });
+    }
+    /**
+     * Subscribe to firehose events
+     */
+    subscribe(subscription) {
+        this.subscriptions.set(subscription.id, subscription);
+        this.logger.info('Added firehose subscription', {
+            id: subscription.id,
+            collections: subscription.collections,
+        });
+    }
+    /**
+     * Unsubscribe from firehose events
+     */
+    unsubscribe(subscriptionId) {
+        this.subscriptions.delete(subscriptionId);
+        this.logger.info('Removed firehose subscription', { id: subscriptionId });
+    }
+    /**
+     * Get connection status
+     */
+    isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Get the last processed sequence number
+     */
+    getLastSeq() {
+        return this.lastSeq;
+    }
+    /**
+     * Get firehose WebSocket URL
+     */
+    getFirehoseUrl() {
+        const baseUrl = this.config.service.replace(/^https?:\/\//, '');
+        return `wss://${baseUrl}/xrpc/com.atproto.sync.subscribeRepos`;
+    }
+    /**
+     * Handle incoming firehose message
+     */
+    handleMessage(data) {
+        try {
+            // Parse CAR (Content Addressable aRchive) format
+            // This is a simplified parser - in production, use proper CAR parsing library
+            const event = this.parseFirehoseMessage(data);
+            if (event) {
+                this.lastSeq = event.seq;
+                this.processEvent(event);
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to parse firehose message', error);
+        }
+    }
+    /**
+     * Parse firehose message (simplified implementation)
+     */
+    parseFirehoseMessage(_data) {
+        try {
+            // This is a simplified parser for demonstration
+            // In production, use @atproto/lexicon and proper CAR parsing
+            // For now, create a mock event structure
+            const mockEvent = {
+                type: 'commit',
+                seq: Date.now(),
+                time: new Date().toISOString(),
+                repo: 'did:plc:example',
+                commit: {
+                    rev: 'rev123',
+                    operation: 'create',
+                    collection: 'app.bsky.feed.post',
+                    rkey: 'rkey123',
+                    record: {
+                        text: 'Example post from firehose',
+                        createdAt: new Date().toISOString(),
+                    },
+                },
+            };
+            return mockEvent;
+        }
+        catch (error) {
+            this.logger.error('Failed to parse firehose message', error);
+            return null;
+        }
+    }
+    /**
+     * Process firehose event and notify subscribers
+     */
+    processEvent(event) {
+        this.emit('event', event);
+        // Notify matching subscriptions
+        for (const subscription of this.subscriptions.values()) {
+            try {
+                // Check if subscription matches the event
+                if (this.matchesSubscription(event, subscription)) {
+                    subscription.onEvent(event);
+                }
+            }
+            catch (error) {
+                this.logger.error('Error in subscription handler', error);
+                if (subscription.onError) {
+                    subscription.onError(error);
+                }
+            }
+        }
+    }
+    /**
+     * Check if event matches subscription criteria
+     */
+    matchesSubscription(event, subscription) {
+        // If no collections specified, match all events
+        if (!subscription.collections || subscription.collections.length === 0) {
+            return true;
+        }
+        // Check if event collection matches subscription
+        if (event.commit?.collection) {
+            return subscription.collections.includes(event.commit.collection);
+        }
+        return false;
+    }
+    /**
+     * Schedule reconnection attempt
+     */
+    scheduleReconnect() {
+        this.reconnectAttempts++;
+        const delay = Math.min(this.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1), 30000);
+        this.logger.info('Scheduling firehose reconnection', {
+            attempt: this.reconnectAttempts,
+            delay,
+        });
+        setTimeout(() => {
+            if (!this.isShuttingDown) {
+                this.connect().catch(error => {
+                    this.logger.error('Reconnection attempt failed', error);
+                });
+            }
+        }, delay);
+    }
+    /**
+     * Start heartbeat to keep connection alive
+     */
+    startHeartbeat() {
+        this.heartbeatInterval = setInterval(() => {
+            if (this.ws?.readyState === WebSocket.OPEN) {
+                this.ws.ping();
+            }
+        }, 30000); // Ping every 30 seconds
+    }
+    /**
+     * Cleanup resources
+     */
+    cleanup() {
+        this.isConnecting = false;
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+    }
+}
+//# sourceMappingURL=firehose-client.js.map