@thestatic-tv/dcl-sdk 1.0.7 → 2.0.1

package/dist/index.d.ts

@@ -34,6 +34,14 @@ interface StaticTVConfig {
      * })
      */
     player?: PlayerData;
+    /**
+     * Guide UI configuration (channel keys only)
+     */
+    guideUI?: GuideUIConfig;
+    /**
+     * Chat UI configuration (channel keys only)
+     */
+    chatUI?: ChatUIConfig;
 }
 /**
  * Channel information from the guide
@@ -124,6 +132,75 @@ interface SceneStatsResponse {
     sceneName: string | null;
     version: string;
 }
+/**
+ * Video data for the guide UI
+ */
+interface GuideVideo {
+    id: string;
+    name: string;
+    src: string;
+    isLive?: boolean;
+    isCreator?: boolean;
+    channelId?: string;
+    duration?: number;
+    requiresAuth?: boolean;
+}
+/**
+ * Featured playlist for the guide UI
+ */
+interface GuideFeaturedPlaylist {
+    name: string;
+    videos: GuideVideo[];
+}
+/**
+ * Configuration options for GuideUIModule
+ */
+interface GuideUIConfig {
+    /**
+     * Callback when user selects a video
+     * Developer should handle playback
+     */
+    onVideoSelect?: (video: GuideVideo) => void;
+    /**
+     * Current video ID (for "PLAYING" indicator)
+     */
+    currentVideoId?: string;
+    /**
+     * UI scale multiplier (default: 1.0)
+     */
+    uiScale?: number;
+}
+/**
+ * Chat channel data
+ */
+interface ChatChannel {
+    id: string;
+    name: string;
+}
+/**
+ * Chat message data
+ */
+interface ChatMessage {
+    id: string;
+    username: string;
+    text: string;
+    uid: string;
+    createdAt: any;
+    isSystem?: boolean;
+}
+/**
+ * Configuration options for ChatUIModule
+ */
+interface ChatUIConfig {
+    /**
+     * Chat panel position (default: 'right')
+     */
+    position?: 'left' | 'center' | 'right';
+    /**
+     * Font scale multiplier (default: 1.0)
+     */
+    fontScale?: number;
+}
 
 /**
  * Guide module - fetch channel lineup from thestatic.tv
@@ -279,11 +356,176 @@ declare class InteractionsModule {
     follow(channelSlug: string): Promise<InteractionResponse | null>;
 }
 
+/**
+ * Guide UI Module - provides channel/video browser
+ */
+declare class GuideUIModule {
+    private client;
+    private config;
+    private _isVisible;
+    private videos;
+    private featuredPlaylists;
+    private liveVideos;
+    private activeTab;
+    private currentPage;
+    private itemsPerPage;
+    private searchQuery;
+    private uiScale;
+    private _currentVideoId;
+    constructor(client: StaticTVClient, config?: GuideUIConfig);
+    /**
+     * Initialize the guide - fetch channel data
+     */
+    init(): Promise<void>;
+    /**
+     * Show the guide UI
+     */
+    show(): void;
+    /**
+     * Hide the guide UI
+     */
+    hide(): void;
+    /**
+     * Toggle guide visibility
+     */
+    toggle(): void;
+    /**
+     * Check if guide is visible
+     */
+    get isVisible(): boolean;
+    /**
+     * Set the currently playing video ID (for "PLAYING" indicator)
+     */
+    set currentVideoId(id: string | null);
+    /**
+     * Get the currently playing video ID
+     */
+    get currentVideoId(): string | null;
+    /**
+     * Get all videos
+     */
+    getVideos(): GuideVideo[];
+    /**
+     * Get live videos only
+     */
+    getLiveVideos(): GuideVideo[];
+    /**
+     * Refresh guide data
+     */
+    refresh(): Promise<void>;
+    private getBaseUrl;
+    private fetchGuideData;
+    private s;
+    private handleVideoSelect;
+    private handleChannelClick;
+    /**
+     * Get the guide UI component for rendering
+     */
+    getComponent: () => any;
+    private renderLeftPanel;
+    private renderMenuButton;
+    private renderRightPanel;
+    private renderCardGrid;
+    private renderGuideCard;
+    private renderCloseButton;
+}
+
+/**
+ * Chat UI Module - provides real-time chat functionality
+ */
+declare class ChatUIModule {
+    private client;
+    private config;
+    private _isVisible;
+    private _unreadCount;
+    private idToken;
+    private isSigningIn;
+    private isRegisteredUser;
+    private currentUsername;
+    private currentUserId;
+    private channels;
+    private currentChannelId;
+    private showChannelDropdown;
+    private channelPage;
+    private realMessages;
+    private systemMessages;
+    private inputText;
+    private chatScrollOffset;
+    private position;
+    private fontScale;
+    private chatTimerId;
+    private playerInfoTimerId;
+    private isInitialized;
+    constructor(client: StaticTVClient, config?: ChatUIConfig);
+    /**
+     * Initialize the chat system
+     */
+    init(): Promise<void>;
+    /**
+     * Show the chat UI
+     */
+    show(): void;
+    /**
+     * Hide the chat UI
+     */
+    hide(): void;
+    /**
+     * Toggle chat visibility
+     */
+    toggle(): void;
+    /**
+     * Check if chat is visible
+     */
+    get isVisible(): boolean;
+    /**
+     * Get unread message count
+     */
+    get unreadCount(): number;
+    /**
+     * Get current channel ID
+     */
+    get currentChannel(): string;
+    /**
+     * Switch to a different channel
+     */
+    setChannel(channelId: string): void;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    private getBaseUrl;
+    private performAuth;
+    private fetchChannels;
+    private fetchMessages;
+    private handleSend;
+    private generateBootSequence;
+    private fetchPlayerInfo;
+    private switchChannel;
+    private startChatLoop;
+    private chatLoop;
+    private resetChatTimer;
+    private parseServerTime;
+    private formatTime;
+    /**
+     * Get the chat UI component for rendering
+     */
+    getComponent: () => any;
+    private getPositionStyle;
+    private renderHeader;
+    private renderChannelButton;
+    private renderMessagesArea;
+    private renderSystemMessage;
+    private renderChatMessage;
+    private renderUserInfoBar;
+    private renderInputArea;
+    private renderChannelDropdown;
+}
+
 /**
  * StaticTVClient - Main client for connecting DCL scenes to thestatic.tv
  *
  * Supports two key types:
- * - dclk_* : Channel keys (full access - guide, heartbeat, interactions)
+ * - dclk_* : Channel keys (full access - guide, heartbeat, interactions, UI)
  * - dcls_* : Scene-only keys (lite - session tracking only)
  */
 
@@ -302,6 +544,10 @@ declare class StaticTVClient {
     readonly heartbeat: HeartbeatModule | null;
     /** Interactions module - like/follow channels (channel keys only) */
     readonly interactions: InteractionsModule | null;
+    /** Guide UI module - channel browser UI (channel keys only) */
+    readonly guideUI: GuideUIModule | null;
+    /** Chat UI module - real-time chat UI (channel keys only) */
+    readonly chatUI: ChatUIModule | null;
     /**
      * Create a new StaticTVClient
      *
@@ -375,4 +621,4 @@ declare function getPlayerWallet(): string | null;
  */
 declare function getPlayerDisplayName(): string | null;
 
-export { type Channel, GuideModule, type GuideResponse, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, type PlayerData, type SceneStats, type SceneStatsResponse, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet };
+export { type Channel, type ChatChannel, type ChatMessage, type ChatUIConfig, ChatUIModule, type GuideFeaturedPlaylist, GuideModule, type GuideResponse, type GuideUIConfig, GuideUIModule, type GuideVideo, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, type PlayerData, type SceneStats, type SceneStatsResponse, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet };