@gala-chain/launchpad-sdk 6.0.0 → 7.0.0-beta.2

package/dist/src/services/StreamWebSocketService.d.ts

@@ -1,586 +0,0 @@
-/**
- * Stream WebSocket Service
- *
- * Handles real-time streaming and chat events via Socket.IO including:
- * - Stream status updates (IDLE/ACTIVE/DISABLED)
- * - Viewer count updates
- * - Chat messages
- * - Subscription management
- *
- * @category Services
- * @since 5.1.0
- */
-import type { Socket } from 'socket.io-client';
-import type { GlobalFeedEventCallbacks, GlobalFeedSubscribedEvent } from '../types/global-feed.dto';
-import type { StreamChatAuthenticatedEvent, StreamChatAuthErrorEvent, StreamChatErrorEvent, StreamChatGlobalStatusEvent, StreamChatMessageEvent, StreamChatPinnedEvent, StreamChatSentEvent, StreamChatStatusEvent, StreamChatUnpinnedEvent, StreamReactionErrorEvent, StreamReactionEvent, TypingIndicatorEvent } from '../types/stream-chat.dto';
-import type { StreamCountdownEvent, StreamGlobalStatusEvent, StreamLanguageEvent, StreamStatusEvent, StreamSubscribedEvent, StreamUnsubscribedEvent, ViewerCountEvent } from '../types/streaming.dto';
-import type { ApiKeyCreatedEvent, ApiKeyRevokedEvent, ApiKeyUpdatedEvent, BalanceUpdatedEvent, CommentCreatedEvent, EngagementStatsUpdatedEvent, HolderCountUpdatedEvent, ModeratorAddedEvent, ModeratorInviteCreatedEvent, ModeratorRemovedEvent, ModeratorRoleUpdatedEvent, OverseerAddedEvent, OverseerRemovedEvent, PoolBadgeAssignedEvent, PoolMetadataUpdatedEvent, PoolSocialLinksUpdatedEvent, StatsUpdatedEvent, TokenBannedEvent, TokenConfigUpdatedEvent, TokenUnbannedEvent, TradeExecutedEvent, UserProfileUpdatedEvent } from '../types/websocket-events.dto';
-import { LoggerBase } from './BaseService';
-/**
- * Stream WebSocket configuration
- */
-export interface StreamWebSocketConfig {
-    /** Stream WebSocket server URL (SEPARATE from bundleBaseUrl) */
-    url: string;
-    /** JWT token for authentication (optional - required for chat) */
-    authToken?: string;
-    /** Maximum reconnection attempts (default: 5) */
-    reconnectAttempts?: number;
-    /** Delay between reconnection attempts in ms (default: 2000) */
-    reconnectDelay?: number;
-    /** Subscription timeout in ms (default: 10000) */
-    subscriptionTimeout?: number;
-}
-/**
- * Stream event names used by the backend.
- *
- * BREAKING CHANGE (v7.2.0): Event values changed from snake_case to SCREAMING_CASE
- * to match backend websocket-events.constant.ts. Frontend and SDK consumers must
- * update their event listeners to use these new names.
- *
- * Migration: 'stream_status' → 'STREAM_STATUS', 'token_banned' → 'TOKEN_BANNED', etc.
- */
-export declare const STREAM_EVENTS: {
-    readonly SUBSCRIBE: "subscribe_token";
-    readonly UNSUBSCRIBE: "unsubscribe_token";
-    readonly AUTHENTICATE: "authenticate";
-    readonly SEND_CHAT: "send_stream_chat";
-    readonly SEND_REACTION: "send_stream_reaction";
-    readonly TYPING_START: "typing_start";
-    readonly TYPING_STOP: "typing_stop";
-    readonly STREAM_STATUS: "STREAM_STATUS";
-    readonly RECORDING_STATUS: "RECORDING_STATUS";
-    readonly RECORDINGS_COUNT_UPDATED: "RECORDINGS_COUNT_UPDATED";
-    readonly SIMULCAST_STATUS: "SIMULCAST_STATUS";
-    readonly DOWNLOAD_READY: "DOWNLOAD_READY";
-    readonly STREAM_COUNTDOWN_UPDATED: "STREAM_COUNTDOWN_UPDATED";
-    readonly STREAM_LANGUAGE_UPDATED: "STREAM_LANGUAGE_UPDATED";
-    readonly VIEWER_COUNT: "VIEWER_COUNT";
-    readonly STREAM_SUBSCRIBED: "token_subscribed";
-    readonly STREAM_UNSUBSCRIBED: "token_unsubscribed";
-    readonly STREAM_GLOBAL_STATUS: "STREAM_GLOBAL_STATUS";
-    readonly ENGAGEMENT_STATS_UPDATED: "ENGAGEMENT_STATS_UPDATED";
-    readonly CHAT_MESSAGE: "STREAM_CHAT_MESSAGE";
-    readonly CHAT_SENT: "STREAM_CHAT_SENT";
-    readonly CHAT_UPDATED: "STREAM_CHAT_UPDATED";
-    readonly CHAT_DELETED: "STREAM_CHAT_DELETED";
-    readonly CHAT_ERROR: "stream_chat_error";
-    readonly CHAT_STATUS: "CHAT_STATUS_CHANGED";
-    readonly CHAT_GLOBAL_STATUS: "STREAM_CHAT_GLOBAL_STATUS";
-    readonly CHAT_AUTHENTICATED: "authenticated";
-    readonly CHAT_AUTH_ERROR: "stream_chat_auth_error";
-    readonly STREAM_CONTROL_STATUS_CHANGED: "STREAM_CONTROL_STATUS_CHANGED";
-    readonly REACTION: "STREAM_REACTION";
-    readonly CONTENT_REACTION_ADDED: "CONTENT_REACTION_ADDED";
-    readonly CONTENT_REACTION_REMOVED: "CONTENT_REACTION_REMOVED";
-    readonly REACTION_ERROR: "stream_reaction_error";
-    readonly USER_TYPING: "USER_TYPING";
-    readonly CHAT_PINNED: "STREAM_CHAT_PINNED";
-    readonly CHAT_UNPINNED: "STREAM_CHAT_UNPINNED";
-    readonly COMMENT_CREATED: "COMMENT_CREATED";
-    readonly COMMENT_UPDATED: "COMMENT_UPDATED";
-    readonly COMMENT_DELETED: "COMMENT_DELETED";
-    readonly USER_BANNED: "USER_BANNED";
-    readonly USER_UNBANNED: "USER_UNBANNED";
-    readonly BAN_ENFORCEMENT: "BAN_ENFORCEMENT";
-    readonly TOKEN_BANNED: "TOKEN_BANNED";
-    readonly TOKEN_UNBANNED: "TOKEN_UNBANNED";
-    readonly CONTENT_FLAGGED: "CONTENT_FLAGGED";
-    readonly FLAG_RESOLVED: "FLAG_RESOLVED";
-    readonly MODERATOR_INVITE_CREATED: "MODERATOR_INVITE_CREATED";
-    readonly MODERATOR_ADDED: "MODERATOR_ADDED";
-    readonly MODERATOR_REMOVED: "MODERATOR_REMOVED";
-    readonly MODERATOR_ROLE_UPDATED: "MODERATOR_ROLE_UPDATED";
-    readonly OVERSEER_ADDED: "OVERSEER_ADDED";
-    readonly OVERSEER_REMOVED: "OVERSEER_REMOVED";
-    readonly TRADE_EXECUTED: "TRADE_EXECUTED";
-    readonly BALANCE_UPDATED: "BALANCE_UPDATED";
-    readonly STATS_UPDATED: "STATS_UPDATED";
-    readonly POOL_METADATA_UPDATED: "POOL_METADATA_UPDATED";
-    readonly POOL_SOCIAL_LINKS_UPDATED: "POOL_SOCIAL_LINKS_UPDATED";
-    readonly POOL_BADGE_ASSIGNED: "POOL_BADGE_ASSIGNED";
-    readonly HOLDER_COUNT_UPDATED: "HOLDER_COUNT_UPDATED";
-    readonly USER_PROFILE_UPDATED: "USER_PROFILE_UPDATED";
-    readonly API_KEY_CREATED: "API_KEY_CREATED";
-    readonly API_KEY_UPDATED: "API_KEY_UPDATED";
-    readonly API_KEY_REVOKED: "API_KEY_REVOKED";
-    readonly TOKEN_CONFIG_UPDATED: "TOKEN_CONFIG_UPDATED";
-    readonly SITE_CONFIG_CHANGED: "SITE_CONFIG_CHANGED";
-    readonly COMMENTS_GLOBAL_STATUS: "COMMENTS_GLOBAL_STATUS";
-    readonly WEBHOOKS_GLOBAL_STATUS: "WEBHOOKS_GLOBAL_STATUS";
-    readonly SUBSCRIBE_GLOBAL_FEED: "subscribe_global_feed";
-    readonly UNSUBSCRIBE_GLOBAL_FEED: "unsubscribe_global_feed";
-    readonly GLOBAL_FEED_SUBSCRIBED: "global_feed_subscribed";
-    readonly GLOBAL_FEED_UNSUBSCRIBED: "global_feed_unsubscribed";
-};
-/**
- * Callback types for stream events
- */
-export interface StreamEventCallbacks {
-    onStreamStatus?: (event: StreamStatusEvent) => void;
-    onStreamSubscribed?: (event: StreamSubscribedEvent) => void;
-    onStreamUnsubscribed?: (event: StreamUnsubscribedEvent) => void;
-    onViewerCount?: (event: ViewerCountEvent) => void;
-    onStreamGlobalStatus?: (event: StreamGlobalStatusEvent) => void;
-    onChatMessage?: (event: StreamChatMessageEvent) => void;
-    onChatSent?: (event: StreamChatSentEvent) => void;
-    onChatError?: (event: StreamChatErrorEvent) => void;
-    onChatStatus?: (event: StreamChatStatusEvent) => void;
-    onChatGlobalStatus?: (event: StreamChatGlobalStatusEvent) => void;
-    onChatAuthenticated?: (event: StreamChatAuthenticatedEvent) => void;
-    onChatAuthError?: (event: StreamChatAuthErrorEvent) => void;
-    onReaction?: (event: StreamReactionEvent) => void;
-    onReactionError?: (event: StreamReactionErrorEvent) => void;
-    onTypingIndicator?: (event: TypingIndicatorEvent) => void;
-    onChatPinned?: (event: StreamChatPinnedEvent) => void;
-    onChatUnpinned?: (event: StreamChatUnpinnedEvent) => void;
-    onCountdownUpdated?: (event: StreamCountdownEvent) => void;
-    onLanguageUpdated?: (event: StreamLanguageEvent) => void;
-    onTokenBanned?: (event: TokenBannedEvent) => void;
-    onTokenUnbanned?: (event: TokenUnbannedEvent) => void;
-    onModeratorInviteCreated?: (event: ModeratorInviteCreatedEvent) => void;
-    onModeratorAdded?: (event: ModeratorAddedEvent) => void;
-    onModeratorRemoved?: (event: ModeratorRemovedEvent) => void;
-    onModeratorRoleUpdated?: (event: ModeratorRoleUpdatedEvent) => void;
-    onOverseerAdded?: (event: OverseerAddedEvent) => void;
-    onOverseerRemoved?: (event: OverseerRemovedEvent) => void;
-    onTradeExecuted?: (event: TradeExecutedEvent) => void;
-    onBalanceUpdated?: (event: BalanceUpdatedEvent) => void;
-    onPoolMetadataUpdated?: (event: PoolMetadataUpdatedEvent) => void;
-    onPoolSocialLinksUpdated?: (event: PoolSocialLinksUpdatedEvent) => void;
-    onPoolBadgeAssigned?: (event: PoolBadgeAssignedEvent) => void;
-    onHolderCountUpdated?: (event: HolderCountUpdatedEvent) => void;
-    onCommentCreated?: (event: CommentCreatedEvent) => void;
-    onUserProfileUpdated?: (event: UserProfileUpdatedEvent) => void;
-    onApiKeyCreated?: (event: ApiKeyCreatedEvent) => void;
-    onApiKeyUpdated?: (event: ApiKeyUpdatedEvent) => void;
-    onApiKeyRevoked?: (event: ApiKeyRevokedEvent) => void;
-    onTokenConfigUpdated?: (event: TokenConfigUpdatedEvent) => void;
-    onStatsUpdated?: (event: StatsUpdatedEvent) => void;
-    onEngagementStatsUpdated?: (event: EngagementStatsUpdatedEvent) => void;
-}
-/**
- * Stream WebSocket Service
- *
- * Manages real-time connections for streaming and chat functionality.
- * Uses a SEPARATE WebSocket endpoint from the bundle backend.
- *
- * Key features:
- * - Event buffering to prevent race conditions
- * - Room-based subscriptions per token
- * - Automatic reconnection with re-subscription
- * - Memory-safe listener cleanup
- *
- * @example
- * ```typescript
- * const wsService = new StreamWebSocketService({
- *   url: 'wss://stream.gala.com',
- *   authToken: 'jwt-token-here'
- * });
- *
- * await wsService.connect();
- *
- * // Subscribe to a stream
- * await wsService.subscribeToStream('mytoken', {
- *   onStreamStatus: (event) => console.log('Status:', event.status),
- *   onViewerCount: (event) => console.log('Viewers:', event.count),
- *   onChatMessage: (event) => console.log('Chat:', event.message.content)
- * });
- *
- * // Send a chat message
- * wsService.sendChatMessage('mytoken', 'Hello everyone!');
- *
- * // Cleanup
- * wsService.unsubscribeFromStream('mytoken');
- * wsService.disconnect();
- * ```
- */
-export declare class StreamWebSocketService extends LoggerBase {
-    private socket;
-    private config;
-    private isSocketIOAvailable;
-    private reconnectionManager;
-    private isAuthenticated;
-    private subscribedRooms;
-    private roomCallbacks;
-    private pendingSubscriptions;
-    private eventBuffer;
-    private eventBufferTimeouts;
-    private readonly MAX_BUFFER_SIZE;
-    private readonly BUFFER_CLEANUP_MS;
-    private globalCallbacks;
-    private isGlobalFeedSubscribed;
-    private globalFeedCallbacks;
-    private pendingGlobalFeedSubscription;
-    constructor(config: StreamWebSocketConfig, debug?: boolean);
-    /**
-     * Check if Socket.IO is available
-     */
-    private checkSocketIOAvailability;
-    /**
-     * Get room name for token
-     */
-    private getRoomName;
-    /**
-     * Buffer an event for potential late listeners
-     */
-    private bufferEvent;
-    /**
-     * Process buffered events for a newly subscribed token
-     */
-    private processBufferedEvents;
-    /**
-     * Setup global event listeners
-     */
-    private setupGlobalListeners;
-    /**
-     * Re-subscribe to all active rooms after reconnection
-     */
-    private resubscribeAll;
-    /**
-     * Connect to the stream WebSocket server
-     *
-     * @returns Promise that resolves when connected
-     * @throws ConfigurationError if Socket.IO is not available
-     */
-    connect(): Promise<void>;
-    /**
-     * Authenticate with the stream server for chat operations
-     *
-     * @param token JWT token for authentication
-     */
-    authenticate(token: string): void;
-    /**
-     * Subscribe to a token's stream events
-     *
-     * @param tokenName Token name to subscribe to
-     * @param callbacks Event callbacks for this subscription
-     * @returns Promise that resolves when subscription is confirmed
-     * @throws ValidationError if WebSocket is not connected
-     * @throws Error if subscription times out
-     */
-    subscribeToStream(tokenName: string, callbacks?: StreamEventCallbacks): Promise<StreamSubscribedEvent>;
-    /**
-     * Unsubscribe from a token's stream events
-     *
-     * @param tokenName Token name to unsubscribe from
-     */
-    unsubscribeFromStream(tokenName: string): void;
-    /**
-     * Send a chat message via WebSocket (faster than REST)
-     *
-     * @param tokenName Token name for the chat room
-     * @param content Message content
-     * @throws ValidationError if not authenticated or not connected
-     */
-    sendChatMessage(tokenName: string, content: string): void;
-    /**
-     * Send an ephemeral emoji reaction to a live stream
-     *
-     * Reactions are broadcast to all viewers but NOT persisted to database.
-     * Rate limiting is enforced server-side (burst of 10, then 0.5/sec refill).
-     *
-     * @param tokenName Token name for the stream
-     * @param emoji Emoji to send (single emoji or short sequence, max 15 chars)
-     * @param streamTime Current stream timecode in seconds (for viewer sync)
-     * @throws ValidationError if not authenticated or not connected
-     * @since 5.2.0
-     */
-    sendReaction(tokenName: string, emoji: string, streamTime?: number): void;
-    /**
-     * Send typing indicator start event
-     *
-     * Indicates user has started typing in chat. Server broadcasts typing
-     * status to all viewers in the room except the sender.
-     *
-     * Auto-expires after 5 seconds if no typing activity.
-     * Use sendTypingStop() to explicitly stop the indicator.
-     *
-     * @param tokenName Token name for the chat room
-     * @throws ValidationError if not authenticated or not connected
-     * @since 5.11.0
-     */
-    sendTypingStart(tokenName: string): void;
-    /**
-     * Send typing indicator stop event
-     *
-     * Indicates user has stopped typing (e.g., message sent, input cleared, blur).
-     * Call this when user sends message, clears input, or loses focus.
-     *
-     * @param tokenName Token name for the chat room
-     * @throws ValidationError if not authenticated or not connected
-     * @since 5.11.0
-     */
-    sendTypingStop(tokenName: string): void;
-    /**
-     * Subscribe to token banned events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeTokenBanned(tokenName: string, callback: (event: TokenBannedEvent) => void): () => void;
-    /**
-     * Subscribe to token unbanned events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeTokenUnbanned(tokenName: string, callback: (event: TokenUnbannedEvent) => void): () => void;
-    /**
-     * Subscribe to moderator invite created events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 8.5.0
-     */
-    subscribeModeratorInviteCreated(tokenName: string, callback: (event: ModeratorInviteCreatedEvent) => void): () => void;
-    /**
-     * Subscribe to moderator added events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeModeratorAdded(tokenName: string, callback: (event: ModeratorAddedEvent) => void): () => void;
-    /**
-     * Subscribe to moderator removed events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeModeratorRemoved(tokenName: string, callback: (event: ModeratorRemovedEvent) => void): () => void;
-    /**
-     * Subscribe to moderator role updated events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeModeratorRoleUpdated(tokenName: string, callback: (event: ModeratorRoleUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to overseer added events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeOverseerAdded(callback: (event: OverseerAddedEvent) => void): () => void;
-    /**
-     * Subscribe to overseer removed events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeOverseerRemoved(callback: (event: OverseerRemovedEvent) => void): () => void;
-    /**
-     * Subscribe to trade executed events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeTradeExecuted(tokenName: string, callback: (event: TradeExecutedEvent) => void): () => void;
-    /**
-     * Subscribe to pool metadata updated events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribePoolMetadataUpdated(tokenName: string, callback: (event: PoolMetadataUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to pool social links updated events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribePoolSocialLinksUpdated(tokenName: string, callback: (event: PoolSocialLinksUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to pool badge assigned events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribePoolBadgeAssigned(tokenName: string, callback: (event: PoolBadgeAssignedEvent) => void): () => void;
-    /**
-     * Subscribe to holder count updated events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeHolderCountUpdated(tokenName: string, callback: (event: HolderCountUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to comment created events for a specific token
-     *
-     * @param tokenName Token name to listen for
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeCommentCreated(tokenName: string, callback: (event: CommentCreatedEvent) => void): () => void;
-    /**
-     * Subscribe to user profile updated events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeUserProfileUpdated(callback: (event: UserProfileUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to API key created events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeApiKeyCreated(callback: (event: ApiKeyCreatedEvent) => void): () => void;
-    /**
-     * Subscribe to API key updated events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeApiKeyUpdated(callback: (event: ApiKeyUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to API key revoked events (global)
-     *
-     * @param callback Callback function
-     * @returns Function to unsubscribe
-     * @since 6.0.0
-     */
-    subscribeApiKeyRevoked(callback: (event: ApiKeyRevokedEvent) => void): () => void;
-    /**
-     * Subscribe to platform stats updated events (global).
-     * Emitted after every trade with enriched token price, market cap, and supply data.
-     *
-     * @param callback Callback function receiving StatsUpdatedEvent
-     * @returns Function to unsubscribe
-     * @since 8.3.0
-     */
-    subscribeStatsUpdated(callback: (event: StatsUpdatedEvent) => void): () => void;
-    /**
-     * Subscribe to engagement stats updated events (global).
-     * Emitted by the chat flush job every ~15 seconds when chat activity occurs.
-     * Contains updated chat/comment counts for the token.
-     *
-     * @param callback Callback function receiving EngagementStatsUpdatedEvent
-     * @returns Function to unsubscribe
-     * @since 8.5.0
-     */
-    subscribeEngagementStatsUpdated(callback: (event: EngagementStatsUpdatedEvent) => void): () => void;
-    /**
-     * Set global event callbacks (not per-room)
-     *
-     * @param callbacks Global event callbacks
-     */
-    setGlobalCallbacks(callbacks: StreamEventCallbacks): void;
-    /**
-     * Get list of currently subscribed tokens
-     */
-    getSubscribedTokens(): string[];
-    /**
-     * Check if connected to the WebSocket server
-     */
-    isConnected(): boolean;
-    /**
-     * Check if authenticated for chat operations
-     */
-    isAuthenticatedForChat(): boolean;
-    /**
-     * Subscribe to the global feed for unified real-time updates
-     *
-     * Provides homepage/listing views with token summary events and site config events.
-     * Automatically reconnects on disconnect if configured.
-     *
-     * Feed token events routed through global feed:
-     * - STREAM_STATUS, TRADE_EXECUTED, HOLDER_COUNT_UPDATED, POOL_BADGE_ASSIGNED,
-     *   VIEWER_COUNT, TOKEN_CONFIG_UPDATED, STATS_UPDATED
-     *
-     * Dedup behavior: When a client is subscribed to both a token room AND the global
-     * feed, overlapping events are delivered only via the token room callbacks (the backend
-     * uses `.except()` to prevent double delivery). Global feed callbacks fire only for
-     * tokens the client has NOT individually subscribed to.
-     *
-     * @param callbacks Optional callbacks for feed events
-     * @returns Promise resolving to subscription confirmation
-     * @throws ValidationError if WebSocket not connected
-     *
-     * @example
-     * ```typescript
-     * const subscription = await service.subscribeToGlobalFeed({
-     *   onStreamStatus: (event) => updateCard(event.tokenName, event),
-     *   onTradeExecuted: (event) => addTradeNotification(event),
-     *   onStatsUpdated: (event) => updatePriceCard(event.tokenName, event),
-     *   onTokenConfigUpdated: (event) => updateConfigCard(event.tokenName, event),
-     *   onStreamGlobalStatus: (event) => setStreamingEnabled(event.enabled),
-     * });
-     *
-     * // Later: unsubscribe
-     * service.unsubscribeFromGlobalFeed();
-     * ```
-     *
-     * @since 7.0.0
-     */
-    subscribeToGlobalFeed(callbacks?: GlobalFeedEventCallbacks): Promise<GlobalFeedSubscribedEvent>;
-    /**
-     * Unsubscribe from the global feed
-     *
-     * Stops receiving feed events and cleans up subscriptions.
-     *
-     * @example
-     * ```typescript
-     * service.unsubscribeFromGlobalFeed();
-     * ```
-     *
-     * @since 7.0.0
-     */
-    unsubscribeFromGlobalFeed(): void;
-    /**
-     * Check if currently subscribed to global feed
-     *
-     * @returns True if subscribed to global feed
-     * @since 7.0.0
-     */
-    isSubscribedToGlobalFeed(): boolean;
-    /**
-     * Update global feed event callbacks
-     *
-     * Allows updating which events you want to receive after subscription.
-     *
-     * @param callbacks Callbacks for feed events
-     * @since 7.0.0
-     */
-    setGlobalFeedCallbacks(callbacks: GlobalFeedEventCallbacks): void;
-    /**
-     * Get the underlying Socket.IO instance
-     */
-    getSocket(): Socket | null;
-    /**
-     * Disconnect from the stream WebSocket server
-     *
-     * Cleans up all listeners, subscriptions, and buffers.
-     * All cleanup operations are wrapped in try-catch to ensure
-     * complete cleanup even if individual steps fail.
-     */
-    disconnect(): void;
-}
-//# sourceMappingURL=StreamWebSocketService.d.ts.map

package/dist/src/services/StreamWebSocketService.d.ts.map

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