@thestatic-tv/dcl-sdk 2.5.1 → 2.5.3

package/dist/index.d.mts

@@ -995,6 +995,10 @@ declare class StaticTVClient {
      */
     getConfig(): StaticTVConfig;
     private _currentVideoUrl;
+    private _pendingVideoData;
+    private _streamVerified;
+    private _verificationTimeoutId;
+    private _videoEventsRegistered;
     /**
      * Play a video on the configured videoScreen entity.
      * Called by Guide UI and Admin Panel.
@@ -1013,15 +1017,41 @@ declare class StaticTVClient {
      * @internal
      */
     private _playVideoInternal;
+    /**
+     * Register video event handlers for stream verification
+     * @internal
+     */
+    private _registerVideoEvents;
+    /**
+     * Start stream verification timeout
+     * @internal
+     */
+    private _startStreamVerification;
+    /**
+     * Handle stream that's offline or failed to verify
+     * @internal
+     */
+    private _handleStreamOffline;
+    /**
+     * Clear verification timeout
+     * @internal
+     */
+    private _clearVerificationTimeout;
     /**
      * Get the currently playing video URL
      */
     get currentVideoUrl(): string;
     /**
      * Internal handler for Guide video selection
+     * Tries to play the stream and verifies it's working (like M1D-HQ behavior)
      * @internal
      */
     _handleGuideVideoSelect(video: GuideVideo): void;
+    /**
+     * Play video with stream verification for live content
+     * @internal
+     */
+    private _playVideoWithVerification;
     /**
      * Internal handler for broadcast messages
      * @internal

package/dist/index.d.ts

@@ -995,6 +995,10 @@ declare class StaticTVClient {
      */
     getConfig(): StaticTVConfig;
     private _currentVideoUrl;
+    private _pendingVideoData;
+    private _streamVerified;
+    private _verificationTimeoutId;
+    private _videoEventsRegistered;
     /**
      * Play a video on the configured videoScreen entity.
      * Called by Guide UI and Admin Panel.
@@ -1013,15 +1017,41 @@ declare class StaticTVClient {
      * @internal
      */
     private _playVideoInternal;
+    /**
+     * Register video event handlers for stream verification
+     * @internal
+     */
+    private _registerVideoEvents;
+    /**
+     * Start stream verification timeout
+     * @internal
+     */
+    private _startStreamVerification;
+    /**
+     * Handle stream that's offline or failed to verify
+     * @internal
+     */
+    private _handleStreamOffline;
+    /**
+     * Clear verification timeout
+     * @internal
+     */
+    private _clearVerificationTimeout;
     /**
      * Get the currently playing video URL
      */
     get currentVideoUrl(): string;
     /**
      * Internal handler for Guide video selection
+     * Tries to play the stream and verifies it's working (like M1D-HQ behavior)
      * @internal
      */
     _handleGuideVideoSelect(video: GuideVideo): void;
+    /**
+     * Play video with stream verification for live content
+     * @internal
+     */
+    private _playVideoWithVerification;
     /**
      * Internal handler for broadcast messages
      * @internal

package/dist/index.js

@@ -3493,6 +3493,7 @@ function setupStaticUI(client) {
 
 // src/StaticTVClient.ts
 var import_ecs3 = require("@dcl/sdk/ecs");
+var utils = __toESM(require("@dcl-sdk/utils"));
 var DEFAULT_BASE_URL = "https://thestatic.tv/api/v1/dcl";
 var DEFAULT_FALLBACK_VIDEO = "https://media.thestatic.tv/fallback-loop.mp4";
 var KEY_TYPE_CHANNEL = "channel";
@@ -3557,6 +3558,11 @@ var StaticTVClient = class {
     // --- VIDEO PLAYBACK (Internal handler for videoScreen) ---
     // =============================================================================
     this._currentVideoUrl = "";
+    this._pendingVideoData = null;
+    this._streamVerified = false;
+    this._verificationTimeoutId = null;
+    // DCL timer ID
+    this._videoEventsRegistered = false;
     this._featuresReadyPromise = new Promise((resolve) => {
       this._featuresReadyResolve = resolve;
     });
@@ -3779,9 +3785,11 @@ var StaticTVClient = class {
    * Internal video player - handles both regular videos and fallback
    * @internal
    */
-  _playVideoInternal(url, isFallback = false) {
+  _playVideoInternal(url, isFallback = false, isLiveStream = false) {
     const screen = this.config.videoScreen;
     if (screen === void 0) return;
+    this._clearVerificationTimeout();
+    this._streamVerified = false;
     if (import_ecs3.VideoPlayer.has(screen)) {
       import_ecs3.VideoPlayer.deleteFrom(screen);
     }
@@ -3795,6 +3803,74 @@ var StaticTVClient = class {
     import_ecs3.Material.setBasicMaterial(screen, {
       texture: import_ecs3.Material.Texture.Video({ videoPlayerEntity: screen })
     });
+    if (!this._videoEventsRegistered) {
+      this._registerVideoEvents();
+    }
+    if (isLiveStream && !isFallback) {
+      this._startStreamVerification();
+    }
+  }
+  /**
+   * Register video event handlers for stream verification
+   * @internal
+   */
+  _registerVideoEvents() {
+    const screen = this.config.videoScreen;
+    if (screen === void 0) return;
+    this._videoEventsRegistered = true;
+    import_ecs3.videoEventsSystem.registerVideoEventsEntity(screen, (videoEvent) => {
+      if (videoEvent.state === import_ecs3.VideoState.VS_READY || videoEvent.state === import_ecs3.VideoState.VS_PLAYING) {
+        if (this._pendingVideoData && !this._streamVerified) {
+          this._streamVerified = true;
+          this._clearVerificationTimeout();
+          this.log(`Stream verified: ${this._pendingVideoData.name}`);
+        }
+      }
+      if (videoEvent.state === import_ecs3.VideoState.VS_ERROR) {
+        if (this._pendingVideoData) {
+          this.log(`Stream error for: ${this._pendingVideoData.name}`);
+          this._handleStreamOffline();
+        }
+      }
+    });
+  }
+  /**
+   * Start stream verification timeout
+   * @internal
+   */
+  _startStreamVerification() {
+    if (this._pendingVideoData) {
+      this.showNotification(`Connecting to ${this._pendingVideoData.name}...`, 1e4);
+    }
+    this._verificationTimeoutId = utils.timers.setTimeout(() => {
+      if (!this._streamVerified && this._pendingVideoData) {
+        this.log(`Stream verification timeout for: ${this._pendingVideoData.name}`);
+        this._handleStreamOffline();
+      }
+    }, 8e3);
+  }
+  /**
+   * Handle stream that's offline or failed to verify
+   * @internal
+   */
+  _handleStreamOffline() {
+    const videoData = this._pendingVideoData;
+    this._pendingVideoData = null;
+    this._clearVerificationTimeout();
+    if (videoData) {
+      this.showNotification(`${videoData.name} is offline`, 4e3);
+    }
+    this.stopVideo();
+  }
+  /**
+   * Clear verification timeout
+   * @internal
+   */
+  _clearVerificationTimeout() {
+    if (this._verificationTimeoutId) {
+      utils.timers.clearTimeout(this._verificationTimeoutId);
+      this._verificationTimeoutId = null;
+    }
   }
   /**
    * Get the currently playing video URL
@@ -3804,16 +3880,31 @@ var StaticTVClient = class {
   }
   /**
    * Internal handler for Guide video selection
+   * Tries to play the stream and verifies it's working (like M1D-HQ behavior)
    * @internal
    */
   _handleGuideVideoSelect(video) {
-    if (video.channelId && video.isLive === false) {
-      this.showNotification(`${video.name} is offline`);
-      this.stopVideo();
-      return;
+    if (!video.src) return;
+    this._pendingVideoData = video;
+    const isLiveStream = video.channelId !== void 0 || video.src.includes(".m3u8") || video.src.includes("media.thestatic.tv");
+    this._playVideoWithVerification(video, isLiveStream);
+  }
+  /**
+   * Play video with stream verification for live content
+   * @internal
+   */
+  _playVideoWithVerification(video, isLiveStream) {
+    const screen = this.config.videoScreen;
+    if (screen !== void 0) {
+      this.log(`Playing video: ${video.src} (live: ${isLiveStream})`);
+      this._currentVideoUrl = video.src;
+      this._playVideoInternal(video.src, false, isLiveStream);
+      if (this.guideUI) {
+        this.guideUI.currentVideoId = video.id;
+      }
     }
-    if (video.src) {
-      this.playVideo(video.src);
+    if (this.config.onVideoPlay) {
+      this.config.onVideoPlay(video.src);
     }
   }
   /**

package/dist/index.mjs

@@ -3449,7 +3449,8 @@ function setupStaticUI(client) {
 }
 
 // src/StaticTVClient.ts
-import { VideoPlayer, Material } from "@dcl/sdk/ecs";
+import { VideoPlayer, Material, videoEventsSystem, VideoState } from "@dcl/sdk/ecs";
+import * as utils from "@dcl-sdk/utils";
 var DEFAULT_BASE_URL = "https://thestatic.tv/api/v1/dcl";
 var DEFAULT_FALLBACK_VIDEO = "https://media.thestatic.tv/fallback-loop.mp4";
 var KEY_TYPE_CHANNEL = "channel";
@@ -3514,6 +3515,11 @@ var StaticTVClient = class {
     // --- VIDEO PLAYBACK (Internal handler for videoScreen) ---
     // =============================================================================
     this._currentVideoUrl = "";
+    this._pendingVideoData = null;
+    this._streamVerified = false;
+    this._verificationTimeoutId = null;
+    // DCL timer ID
+    this._videoEventsRegistered = false;
     this._featuresReadyPromise = new Promise((resolve) => {
       this._featuresReadyResolve = resolve;
     });
@@ -3736,9 +3742,11 @@ var StaticTVClient = class {
    * Internal video player - handles both regular videos and fallback
    * @internal
    */
-  _playVideoInternal(url, isFallback = false) {
+  _playVideoInternal(url, isFallback = false, isLiveStream = false) {
     const screen = this.config.videoScreen;
     if (screen === void 0) return;
+    this._clearVerificationTimeout();
+    this._streamVerified = false;
     if (VideoPlayer.has(screen)) {
       VideoPlayer.deleteFrom(screen);
     }
@@ -3752,6 +3760,74 @@ var StaticTVClient = class {
     Material.setBasicMaterial(screen, {
       texture: Material.Texture.Video({ videoPlayerEntity: screen })
     });
+    if (!this._videoEventsRegistered) {
+      this._registerVideoEvents();
+    }
+    if (isLiveStream && !isFallback) {
+      this._startStreamVerification();
+    }
+  }
+  /**
+   * Register video event handlers for stream verification
+   * @internal
+   */
+  _registerVideoEvents() {
+    const screen = this.config.videoScreen;
+    if (screen === void 0) return;
+    this._videoEventsRegistered = true;
+    videoEventsSystem.registerVideoEventsEntity(screen, (videoEvent) => {
+      if (videoEvent.state === VideoState.VS_READY || videoEvent.state === VideoState.VS_PLAYING) {
+        if (this._pendingVideoData && !this._streamVerified) {
+          this._streamVerified = true;
+          this._clearVerificationTimeout();
+          this.log(`Stream verified: ${this._pendingVideoData.name}`);
+        }
+      }
+      if (videoEvent.state === VideoState.VS_ERROR) {
+        if (this._pendingVideoData) {
+          this.log(`Stream error for: ${this._pendingVideoData.name}`);
+          this._handleStreamOffline();
+        }
+      }
+    });
+  }
+  /**
+   * Start stream verification timeout
+   * @internal
+   */
+  _startStreamVerification() {
+    if (this._pendingVideoData) {
+      this.showNotification(`Connecting to ${this._pendingVideoData.name}...`, 1e4);
+    }
+    this._verificationTimeoutId = utils.timers.setTimeout(() => {
+      if (!this._streamVerified && this._pendingVideoData) {
+        this.log(`Stream verification timeout for: ${this._pendingVideoData.name}`);
+        this._handleStreamOffline();
+      }
+    }, 8e3);
+  }
+  /**
+   * Handle stream that's offline or failed to verify
+   * @internal
+   */
+  _handleStreamOffline() {
+    const videoData = this._pendingVideoData;
+    this._pendingVideoData = null;
+    this._clearVerificationTimeout();
+    if (videoData) {
+      this.showNotification(`${videoData.name} is offline`, 4e3);
+    }
+    this.stopVideo();
+  }
+  /**
+   * Clear verification timeout
+   * @internal
+   */
+  _clearVerificationTimeout() {
+    if (this._verificationTimeoutId) {
+      utils.timers.clearTimeout(this._verificationTimeoutId);
+      this._verificationTimeoutId = null;
+    }
   }
   /**
    * Get the currently playing video URL
@@ -3761,16 +3837,31 @@ var StaticTVClient = class {
   }
   /**
    * Internal handler for Guide video selection
+   * Tries to play the stream and verifies it's working (like M1D-HQ behavior)
    * @internal
    */
   _handleGuideVideoSelect(video) {
-    if (video.channelId && video.isLive === false) {
-      this.showNotification(`${video.name} is offline`);
-      this.stopVideo();
-      return;
+    if (!video.src) return;
+    this._pendingVideoData = video;
+    const isLiveStream = video.channelId !== void 0 || video.src.includes(".m3u8") || video.src.includes("media.thestatic.tv");
+    this._playVideoWithVerification(video, isLiveStream);
+  }
+  /**
+   * Play video with stream verification for live content
+   * @internal
+   */
+  _playVideoWithVerification(video, isLiveStream) {
+    const screen = this.config.videoScreen;
+    if (screen !== void 0) {
+      this.log(`Playing video: ${video.src} (live: ${isLiveStream})`);
+      this._currentVideoUrl = video.src;
+      this._playVideoInternal(video.src, false, isLiveStream);
+      if (this.guideUI) {
+        this.guideUI.currentVideoId = video.id;
+      }
     }
-    if (video.src) {
-      this.playVideo(video.src);
+    if (this.config.onVideoPlay) {
+      this.config.onVideoPlay(video.src);
     }
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thestatic-tv/dcl-sdk",
-  "version": "2.5.1",
+  "version": "2.5.3",
   "description": "Connect your Decentraland scene to thestatic.tv - full channel lineup, metrics tracking, and interactions",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -46,9 +46,11 @@
     "url": "https://github.com/thestatic-tv/dcl-sdk/issues"
   },
   "peerDependencies": {
+    "@dcl-sdk/utils": ">=1.0.0",
     "@dcl/sdk": ">=7.0.0"
   },
   "devDependencies": {
+    "@dcl-sdk/utils": "^1.4.0",
     "@dcl/sdk": "^7.0.0",
     "@vitest/coverage-v8": "^4.0.16",
     "tsup": "^8.0.0",