@thestatic-tv/dcl-sdk 2.5.10 → 2.5.13

package/dist/index.d.mts

@@ -763,6 +763,8 @@ declare class AdminPanelUIModule {
     private streamControlling;
     private streamControlStatus;
     private pollIntervalId;
+    private commandPollIntervalId;
+    private lastCommandTimestamp;
     private trialClaiming;
     private trialClaimError;
     private sceneAdmins;
@@ -812,6 +814,9 @@ declare class AdminPanelUIModule {
     registerSceneTab(tab: SceneTabDefinition): void;
     private startStreamPolling;
     private stopStreamPolling;
+    private startCommandPolling;
+    private stopCommandPolling;
+    private pollCommands;
     private fetchStreamData;
     private refreshStreamStatus;
     private fetchVideoState;
@@ -843,8 +848,9 @@ declare class AdminPanelUIModule {
     private ModTab;
     /**
      * Get the React-ECS component for the admin panel
+     * Always renders NotificationBanner (for broadcasts), admin panel only for admins
      */
-    getComponent: () => ReactEcs.JSX.Element | null;
+    getComponent: () => ReactEcs.JSX.Element;
 }
 
 /**
@@ -1062,9 +1068,29 @@ declare class StaticTVClient {
     _handleGuideVideoSelect(video: GuideVideo): void;
     /**
      * Play video with stream verification for live content
+     * Works with both videoScreen (SDK-managed) and onVideoPlay (user-managed) modes.
      * @internal
      */
     private _playVideoWithVerification;
+    /**
+     * Start stream verification for callback-based video playback
+     * Shows CONNECTING state and triggers fallback if verification times out
+     * @internal
+     */
+    private _startCallbackVerification;
+    /**
+     * Call this to confirm that a video stream is playing successfully.
+     * Use this when you're managing video playback yourself (onVideoPlay callback).
+     *
+     * @example
+     * ```typescript
+     * // In your video player's onReady or similar event:
+     * videoPlayer.events.on('playing', () => {
+     *   staticTV.confirmVideoPlaying()
+     * })
+     * ```
+     */
+    confirmVideoPlaying(): void;
     /**
      * Internal handler for broadcast messages
      * @internal
@@ -1213,6 +1239,27 @@ declare class StaticTVClient {
  * @param durationMs How long to show (default 5000ms)
  */
 declare function showNotification(message: string, durationMs?: number): void;
+/**
+ * Hide the current notification immediately
+ */
+declare function hideNotification(): void;
+/**
+ * Notification banner component - thestatic.tv styled
+ * Positioned at bottom-left, away from Guide/Chat/Admin panels
+ *
+ * @example
+ * ```typescript
+ * import { NotificationBanner } from '@thestatic-tv/dcl-sdk'
+ *
+ * ReactEcsRenderer.setUiRenderer(() => (
+ *   <UiEntity>
+ *     <NotificationBanner />
+ *     {myOtherComponents}
+ *   </UiEntity>
+ * ))
+ * ```
+ */
+declare function NotificationBanner(): ReactEcs.JSX.Element | null;
 /**
  * Set up the UI renderer for a StaticTVClient
  * Call this in your scene's main() function after creating the client.
@@ -1249,4 +1296,4 @@ declare function getPlayerWallet(): string | null;
  */
 declare function getPlayerDisplayName(): string | null;
 
-export { type AdminPanelConfig, AdminPanelUIModule, type Channel, type ChatChannel, type ChatMessage, type ChatUIConfig, ChatUIModule, type CommandHandler, 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 SDKTier, type SceneStats, type SceneStatsResponse, type SceneTabDefinition, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type StreamData, type VideoSlot, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet, setupStaticUI, showNotification };
+export { type AdminPanelConfig, AdminPanelUIModule, type Channel, type ChatChannel, type ChatMessage, type ChatUIConfig, ChatUIModule, type CommandHandler, type GuideFeaturedPlaylist, GuideModule, type GuideResponse, type GuideUIConfig, GuideUIModule, type GuideVideo, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, NotificationBanner, type PlayerData, type SDKTier, type SceneStats, type SceneStatsResponse, type SceneTabDefinition, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type StreamData, type VideoSlot, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet, hideNotification, setupStaticUI, showNotification };

package/dist/index.d.ts

@@ -763,6 +763,8 @@ declare class AdminPanelUIModule {
     private streamControlling;
     private streamControlStatus;
     private pollIntervalId;
+    private commandPollIntervalId;
+    private lastCommandTimestamp;
     private trialClaiming;
     private trialClaimError;
     private sceneAdmins;
@@ -812,6 +814,9 @@ declare class AdminPanelUIModule {
     registerSceneTab(tab: SceneTabDefinition): void;
     private startStreamPolling;
     private stopStreamPolling;
+    private startCommandPolling;
+    private stopCommandPolling;
+    private pollCommands;
     private fetchStreamData;
     private refreshStreamStatus;
     private fetchVideoState;
@@ -843,8 +848,9 @@ declare class AdminPanelUIModule {
     private ModTab;
     /**
      * Get the React-ECS component for the admin panel
+     * Always renders NotificationBanner (for broadcasts), admin panel only for admins
      */
-    getComponent: () => ReactEcs.JSX.Element | null;
+    getComponent: () => ReactEcs.JSX.Element;
 }
 
 /**
@@ -1062,9 +1068,29 @@ declare class StaticTVClient {
     _handleGuideVideoSelect(video: GuideVideo): void;
     /**
      * Play video with stream verification for live content
+     * Works with both videoScreen (SDK-managed) and onVideoPlay (user-managed) modes.
      * @internal
      */
     private _playVideoWithVerification;
+    /**
+     * Start stream verification for callback-based video playback
+     * Shows CONNECTING state and triggers fallback if verification times out
+     * @internal
+     */
+    private _startCallbackVerification;
+    /**
+     * Call this to confirm that a video stream is playing successfully.
+     * Use this when you're managing video playback yourself (onVideoPlay callback).
+     *
+     * @example
+     * ```typescript
+     * // In your video player's onReady or similar event:
+     * videoPlayer.events.on('playing', () => {
+     *   staticTV.confirmVideoPlaying()
+     * })
+     * ```
+     */
+    confirmVideoPlaying(): void;
     /**
      * Internal handler for broadcast messages
      * @internal
@@ -1213,6 +1239,27 @@ declare class StaticTVClient {
  * @param durationMs How long to show (default 5000ms)
  */
 declare function showNotification(message: string, durationMs?: number): void;
+/**
+ * Hide the current notification immediately
+ */
+declare function hideNotification(): void;
+/**
+ * Notification banner component - thestatic.tv styled
+ * Positioned at bottom-left, away from Guide/Chat/Admin panels
+ *
+ * @example
+ * ```typescript
+ * import { NotificationBanner } from '@thestatic-tv/dcl-sdk'
+ *
+ * ReactEcsRenderer.setUiRenderer(() => (
+ *   <UiEntity>
+ *     <NotificationBanner />
+ *     {myOtherComponents}
+ *   </UiEntity>
+ * ))
+ * ```
+ */
+declare function NotificationBanner(): ReactEcs.JSX.Element | null;
 /**
  * Set up the UI renderer for a StaticTVClient
  * Call this in your scene's main() function after creating the client.
@@ -1249,4 +1296,4 @@ declare function getPlayerWallet(): string | null;
  */
 declare function getPlayerDisplayName(): string | null;
 
-export { type AdminPanelConfig, AdminPanelUIModule, type Channel, type ChatChannel, type ChatMessage, type ChatUIConfig, ChatUIModule, type CommandHandler, 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 SDKTier, type SceneStats, type SceneStatsResponse, type SceneTabDefinition, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type StreamData, type VideoSlot, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet, setupStaticUI, showNotification };
+export { type AdminPanelConfig, AdminPanelUIModule, type Channel, type ChatChannel, type ChatMessage, type ChatUIConfig, ChatUIModule, type CommandHandler, type GuideFeaturedPlaylist, GuideModule, type GuideResponse, type GuideUIConfig, GuideUIModule, type GuideVideo, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, NotificationBanner, type PlayerData, type SDKTier, type SceneStats, type SceneStatsResponse, type SceneTabDefinition, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type StreamData, type VideoSlot, type Vod, fetchUserData, getPlayerDisplayName, getPlayerWallet, hideNotification, setupStaticUI, showNotification };