@thestatic-tv/dcl-sdk 2.5.7 → 2.5.9

package/dist/index.d.mts

@@ -1000,6 +1000,8 @@ declare class StaticTVClient {
     private _verificationTimeoutId;
     private _videoEventsRegistered;
     private _verificationStartTime;
+    private _offlineVideoId;
+    private _offlineTimeoutId;
     /**
      * Play a video on the configured videoScreen entity.
      * Called by Guide UI and Admin Panel.
@@ -1042,6 +1044,16 @@ declare class StaticTVClient {
      * Get the currently playing video URL
      */
     get currentVideoUrl(): string;
+    /**
+     * Get the video ID currently being connected/verified (for "CONNECTING" indicator)
+     * Returns null if no stream verification is in progress
+     */
+    get connectingVideoId(): string | null;
+    /**
+     * Get the video ID that was detected as offline (for "OFFLINE" indicator)
+     * Returns null after ~5 seconds (temporary indicator)
+     */
+    get offlineVideoId(): string | null;
     /**
      * Internal handler for Guide video selection
      * Tries to play the stream and verifies it's working (like M1D-HQ behavior)

package/dist/index.d.ts

@@ -1000,6 +1000,8 @@ declare class StaticTVClient {
     private _verificationTimeoutId;
     private _videoEventsRegistered;
     private _verificationStartTime;
+    private _offlineVideoId;
+    private _offlineTimeoutId;
     /**
      * Play a video on the configured videoScreen entity.
      * Called by Guide UI and Admin Panel.
@@ -1042,6 +1044,16 @@ declare class StaticTVClient {
      * Get the currently playing video URL
      */
     get currentVideoUrl(): string;
+    /**
+     * Get the video ID currently being connected/verified (for "CONNECTING" indicator)
+     * Returns null if no stream verification is in progress
+     */
+    get connectingVideoId(): string | null;
+    /**
+     * Get the video ID that was detected as offline (for "OFFLINE" indicator)
+     * Returns null after ~5 seconds (temporary indicator)
+     */
+    get offlineVideoId(): string | null;
     /**
      * Internal handler for Guide video selection
      * Tries to play the stream and verifies it's working (like M1D-HQ behavior)

package/dist/index.js

@@ -1341,6 +1341,16 @@ var GuideUIModule = class {
     const cardW = this.s(UI_DIMENSIONS.guide.content.cardWidth);
     const cardH = this.s(UI_DIMENSIONS.guide.content.cardHeight);
     const isActive = this._currentVideoId === video.id;
+    const isConnecting = this.client.connectingVideoId === video.id;
+    const isOffline = this.client.offlineVideoId === video.id;
+    let cardBgColor = import_math3.Color4.create(0.15, 0.15, 0.15, 0.8);
+    if (isOffline) {
+      cardBgColor = import_math3.Color4.create(0.4, 0.1, 0.1, 0.5);
+    } else if (isConnecting) {
+      cardBgColor = import_math3.Color4.create(0.4, 0.3, 0, 0.5);
+    } else if (isActive) {
+      cardBgColor = import_math3.Color4.create(0, 0.4, 0, 0.5);
+    }
     return import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
       key: video.id,
       uiTransform: {
@@ -1353,7 +1363,7 @@ var GuideUIModule = class {
         flexDirection: "column",
         margin: 4
       },
-      uiBackground: { color: isActive ? import_math3.Color4.create(0, 0.4, 0, 0.5) : import_math3.Color4.create(0.15, 0.15, 0.15, 0.8) },
+      uiBackground: { color: cardBgColor },
       children: [
         // Main click area
         import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
@@ -1373,7 +1383,26 @@ var GuideUIModule = class {
                 color: THEME.colors.white
               }
             }),
-            ...isActive ? [
+            // Status indicator: OFFLINE > CONNECTING > PLAYING > LIVE
+            ...isOffline ? [
+              import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
+                key: "offline",
+                uiText: {
+                  value: "OFFLINE",
+                  fontSize: this.s(UI_DIMENSIONS.guide.content.bodySize),
+                  color: THEME.colors.red
+                }
+              })
+            ] : isConnecting ? [
+              import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
+                key: "connecting",
+                uiText: {
+                  value: "CONNECTING...",
+                  fontSize: this.s(UI_DIMENSIONS.guide.content.bodySize),
+                  color: THEME.colors.yellow
+                }
+              })
+            ] : isActive ? [
               import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
                 key: "playing",
                 uiText: {
@@ -3564,6 +3593,10 @@ var StaticTVClient = class {
     // DCL timer ID
     this._videoEventsRegistered = false;
     this._verificationStartTime = 0;
+    // Timestamp when verification started
+    this._offlineVideoId = null;
+    // Temporarily stores ID of offline stream
+    this._offlineTimeoutId = null;
     this._featuresReadyPromise = new Promise((resolve) => {
       this._featuresReadyResolve = resolve;
     });
@@ -3735,7 +3768,7 @@ var StaticTVClient = class {
   getConfig() {
     return this.config;
   }
-  // Timestamp when verification started
+  // Timer to clear offline state
   /**
    * Play a video on the configured videoScreen entity.
    * Called by Guide UI and Admin Panel.
@@ -3872,6 +3905,14 @@ var StaticTVClient = class {
     this._clearVerificationTimeout();
     if (videoData) {
       this.showNotification(`${videoData.name} is offline`, 4e3);
+      this._offlineVideoId = videoData.id;
+      if (this._offlineTimeoutId) {
+        utils.timers.clearTimeout(this._offlineTimeoutId);
+      }
+      this._offlineTimeoutId = utils.timers.setTimeout(() => {
+        this._offlineVideoId = null;
+        this._offlineTimeoutId = null;
+      }, 5e3);
     }
     this.stopVideo();
   }
@@ -3891,6 +3932,20 @@ var StaticTVClient = class {
   get currentVideoUrl() {
     return this._currentVideoUrl;
   }
+  /**
+   * Get the video ID currently being connected/verified (for "CONNECTING" indicator)
+   * Returns null if no stream verification is in progress
+   */
+  get connectingVideoId() {
+    return this._pendingVideoData && !this._streamVerified ? this._pendingVideoData.id : null;
+  }
+  /**
+   * Get the video ID that was detected as offline (for "OFFLINE" indicator)
+   * Returns null after ~5 seconds (temporary indicator)
+   */
+  get offlineVideoId() {
+    return this._offlineVideoId;
+  }
   /**
    * Internal handler for Guide video selection
    * Tries to play the stream and verifies it's working (like M1D-HQ behavior)

package/dist/index.mjs

@@ -1298,6 +1298,16 @@ var GuideUIModule = class {
     const cardW = this.s(UI_DIMENSIONS.guide.content.cardWidth);
     const cardH = this.s(UI_DIMENSIONS.guide.content.cardHeight);
     const isActive = this._currentVideoId === video.id;
+    const isConnecting = this.client.connectingVideoId === video.id;
+    const isOffline = this.client.offlineVideoId === video.id;
+    let cardBgColor = Color43.create(0.15, 0.15, 0.15, 0.8);
+    if (isOffline) {
+      cardBgColor = Color43.create(0.4, 0.1, 0.1, 0.5);
+    } else if (isConnecting) {
+      cardBgColor = Color43.create(0.4, 0.3, 0, 0.5);
+    } else if (isActive) {
+      cardBgColor = Color43.create(0, 0.4, 0, 0.5);
+    }
     return ReactEcs2.createElement(UiEntity2, {
       key: video.id,
       uiTransform: {
@@ -1310,7 +1320,7 @@ var GuideUIModule = class {
         flexDirection: "column",
         margin: 4
       },
-      uiBackground: { color: isActive ? Color43.create(0, 0.4, 0, 0.5) : Color43.create(0.15, 0.15, 0.15, 0.8) },
+      uiBackground: { color: cardBgColor },
       children: [
         // Main click area
         ReactEcs2.createElement(UiEntity2, {
@@ -1330,7 +1340,26 @@ var GuideUIModule = class {
                 color: THEME.colors.white
               }
             }),
-            ...isActive ? [
+            // Status indicator: OFFLINE > CONNECTING > PLAYING > LIVE
+            ...isOffline ? [
+              ReactEcs2.createElement(UiEntity2, {
+                key: "offline",
+                uiText: {
+                  value: "OFFLINE",
+                  fontSize: this.s(UI_DIMENSIONS.guide.content.bodySize),
+                  color: THEME.colors.red
+                }
+              })
+            ] : isConnecting ? [
+              ReactEcs2.createElement(UiEntity2, {
+                key: "connecting",
+                uiText: {
+                  value: "CONNECTING...",
+                  fontSize: this.s(UI_DIMENSIONS.guide.content.bodySize),
+                  color: THEME.colors.yellow
+                }
+              })
+            ] : isActive ? [
               ReactEcs2.createElement(UiEntity2, {
                 key: "playing",
                 uiText: {
@@ -3521,6 +3550,10 @@ var StaticTVClient = class {
     // DCL timer ID
     this._videoEventsRegistered = false;
     this._verificationStartTime = 0;
+    // Timestamp when verification started
+    this._offlineVideoId = null;
+    // Temporarily stores ID of offline stream
+    this._offlineTimeoutId = null;
     this._featuresReadyPromise = new Promise((resolve) => {
       this._featuresReadyResolve = resolve;
     });
@@ -3692,7 +3725,7 @@ var StaticTVClient = class {
   getConfig() {
     return this.config;
   }
-  // Timestamp when verification started
+  // Timer to clear offline state
   /**
    * Play a video on the configured videoScreen entity.
    * Called by Guide UI and Admin Panel.
@@ -3829,6 +3862,14 @@ var StaticTVClient = class {
     this._clearVerificationTimeout();
     if (videoData) {
       this.showNotification(`${videoData.name} is offline`, 4e3);
+      this._offlineVideoId = videoData.id;
+      if (this._offlineTimeoutId) {
+        utils.timers.clearTimeout(this._offlineTimeoutId);
+      }
+      this._offlineTimeoutId = utils.timers.setTimeout(() => {
+        this._offlineVideoId = null;
+        this._offlineTimeoutId = null;
+      }, 5e3);
     }
     this.stopVideo();
   }
@@ -3848,6 +3889,20 @@ var StaticTVClient = class {
   get currentVideoUrl() {
     return this._currentVideoUrl;
   }
+  /**
+   * Get the video ID currently being connected/verified (for "CONNECTING" indicator)
+   * Returns null if no stream verification is in progress
+   */
+  get connectingVideoId() {
+    return this._pendingVideoData && !this._streamVerified ? this._pendingVideoData.id : null;
+  }
+  /**
+   * Get the video ID that was detected as offline (for "OFFLINE" indicator)
+   * Returns null after ~5 seconds (temporary indicator)
+   */
+  get offlineVideoId() {
+    return this._offlineVideoId;
+  }
   /**
    * Internal handler for Guide video selection
    * Tries to play the stream and verifies it's working (like M1D-HQ behavior)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thestatic-tv/dcl-sdk",
-  "version": "2.5.7",
+  "version": "2.5.9",
   "description": "Connect your Decentraland scene to thestatic.tv - full channel lineup, metrics tracking, and interactions",
   "main": "dist/index.js",
   "module": "dist/index.mjs",