@thestatic-tv/dcl-sdk 2.0.3 → 2.2.0

package/dist/index.d.mts

@@ -91,6 +91,8 @@ interface GuideResponse {
 interface SessionResponse {
     success: boolean;
     sessionId?: string;
+    keyType?: 'scene' | 'channel';
+    sdkType?: 'lite' | 'full';
     version: string;
 }
 /**
@@ -247,9 +249,16 @@ declare class SessionModule {
     private sessionId;
     private heartbeatTimerId;
     private isActive;
+    private _sdkType;
     constructor(client: StaticTVClient);
+    /**
+     * Get the SDK type returned by the server
+     * Determines what features are available (lite = sessions only, full = guide + chat + more)
+     */
+    get sdkType(): 'lite' | 'full';
     /**
      * Get the appropriate session endpoint based on key type
+     * All dcls_ keys use /scene-session, dclk_ keys use /session
      */
     private getEndpoint;
     /**
@@ -420,6 +429,7 @@ declare class GuideUIModule {
     private handleChannelClick;
     /**
      * Get the guide UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     getComponent: () => any;
     private renderLeftPanel;
@@ -428,6 +438,7 @@ declare class GuideUIModule {
     private renderCardGrid;
     private renderGuideCard;
     private renderCloseButton;
+    private renderToggleButton;
 }
 
 /**
@@ -508,6 +519,7 @@ declare class ChatUIModule {
     private formatTime;
     /**
      * Get the chat UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     getComponent: () => any;
     private getPositionStyle;
@@ -519,17 +531,18 @@ declare class ChatUIModule {
     private renderUserInfoBar;
     private renderInputArea;
     private renderChannelDropdown;
+    private renderToggleButton;
 }
 
 /**
  * StaticTVClient - Main client for connecting DCL scenes to thestatic.tv
  *
- * Supports two key types:
- * - dclk_* : Channel keys (full access - guide, heartbeat, interactions, UI)
- * - dcls_* : Scene-only keys (lite - session tracking only)
+ * All keys use dcls_ prefix. Features enabled based on sdkType from server:
+ * - lite: Session tracking only
+ * - full: Guide, Chat, Heartbeat, Interactions + session tracking
  */
 
-/** Key type constants */
+/** Key type constants (legacy - kept for compatibility) */
 declare const KEY_TYPE_CHANNEL = "channel";
 declare const KEY_TYPE_SCENE = "scene";
 declare class StaticTVClient {
@@ -537,18 +550,19 @@ declare class StaticTVClient {
     private baseUrl;
     private _keyType;
     private _disabled;
-    /** Guide module - fetch channel lineup (channel keys only) */
-    readonly guide: GuideModule | null;
+    private _fullFeaturesEnabled;
+    /** Guide module - fetch channel lineup (full SDK only) */
+    guide: GuideModule | null;
     /** Session module - track visitor sessions (all keys, null when disabled) */
-    readonly session: SessionModule | null;
-    /** Heartbeat module - track video watching (channel keys only) */
-    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;
+    session: SessionModule | null;
+    /** Heartbeat module - track video watching (full SDK only) */
+    heartbeat: HeartbeatModule | null;
+    /** Interactions module - like/follow channels (full SDK only) */
+    interactions: InteractionsModule | null;
+    /** Guide UI module - channel browser UI (full SDK only) */
+    guideUI: GuideUIModule | null;
+    /** Chat UI module - real-time chat UI (full SDK only) */
+    chatUI: ChatUIModule | null;
     /**
      * Create a new StaticTVClient
      *
@@ -578,7 +592,8 @@ declare class StaticTVClient {
      */
     get isDisabled(): boolean;
     /**
-     * Check if this is a lite (scene-only) client
+     * Check if this is a lite client (no full features)
+     * Returns true until session confirms sdkType is 'full'
      */
     get isLite(): boolean;
     /**
@@ -596,6 +611,25 @@ declare class StaticTVClient {
      * @internal
      */
     getConfig(): StaticTVConfig;
+    /**
+     * Initialize full feature modules (guide, heartbeat, interactions, UI)
+     * @internal
+     */
+    private _initFullModules;
+    /**
+     * Called by SessionModule when server confirms sdkType is 'full'
+     * Enables guide, chat, heartbeat, and interactions modules
+     * @internal
+     */
+    _enableFullFeatures(): void;
+    /**
+     * Check if full features are enabled (server confirmed sdkType: 'full')
+     */
+    get hasFullFeatures(): boolean;
+    /**
+     * Get the SDK type (lite or full) - only available after session starts
+     */
+    get sdkType(): 'lite' | 'full';
     /**
      * Cleanup when done (call before scene unload)
      */

package/dist/index.d.ts

@@ -91,6 +91,8 @@ interface GuideResponse {
 interface SessionResponse {
     success: boolean;
     sessionId?: string;
+    keyType?: 'scene' | 'channel';
+    sdkType?: 'lite' | 'full';
     version: string;
 }
 /**
@@ -247,9 +249,16 @@ declare class SessionModule {
     private sessionId;
     private heartbeatTimerId;
     private isActive;
+    private _sdkType;
     constructor(client: StaticTVClient);
+    /**
+     * Get the SDK type returned by the server
+     * Determines what features are available (lite = sessions only, full = guide + chat + more)
+     */
+    get sdkType(): 'lite' | 'full';
     /**
      * Get the appropriate session endpoint based on key type
+     * All dcls_ keys use /scene-session, dclk_ keys use /session
      */
     private getEndpoint;
     /**
@@ -420,6 +429,7 @@ declare class GuideUIModule {
     private handleChannelClick;
     /**
      * Get the guide UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     getComponent: () => any;
     private renderLeftPanel;
@@ -428,6 +438,7 @@ declare class GuideUIModule {
     private renderCardGrid;
     private renderGuideCard;
     private renderCloseButton;
+    private renderToggleButton;
 }
 
 /**
@@ -508,6 +519,7 @@ declare class ChatUIModule {
     private formatTime;
     /**
      * Get the chat UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     getComponent: () => any;
     private getPositionStyle;
@@ -519,17 +531,18 @@ declare class ChatUIModule {
     private renderUserInfoBar;
     private renderInputArea;
     private renderChannelDropdown;
+    private renderToggleButton;
 }
 
 /**
  * StaticTVClient - Main client for connecting DCL scenes to thestatic.tv
  *
- * Supports two key types:
- * - dclk_* : Channel keys (full access - guide, heartbeat, interactions, UI)
- * - dcls_* : Scene-only keys (lite - session tracking only)
+ * All keys use dcls_ prefix. Features enabled based on sdkType from server:
+ * - lite: Session tracking only
+ * - full: Guide, Chat, Heartbeat, Interactions + session tracking
  */
 
-/** Key type constants */
+/** Key type constants (legacy - kept for compatibility) */
 declare const KEY_TYPE_CHANNEL = "channel";
 declare const KEY_TYPE_SCENE = "scene";
 declare class StaticTVClient {
@@ -537,18 +550,19 @@ declare class StaticTVClient {
     private baseUrl;
     private _keyType;
     private _disabled;
-    /** Guide module - fetch channel lineup (channel keys only) */
-    readonly guide: GuideModule | null;
+    private _fullFeaturesEnabled;
+    /** Guide module - fetch channel lineup (full SDK only) */
+    guide: GuideModule | null;
     /** Session module - track visitor sessions (all keys, null when disabled) */
-    readonly session: SessionModule | null;
-    /** Heartbeat module - track video watching (channel keys only) */
-    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;
+    session: SessionModule | null;
+    /** Heartbeat module - track video watching (full SDK only) */
+    heartbeat: HeartbeatModule | null;
+    /** Interactions module - like/follow channels (full SDK only) */
+    interactions: InteractionsModule | null;
+    /** Guide UI module - channel browser UI (full SDK only) */
+    guideUI: GuideUIModule | null;
+    /** Chat UI module - real-time chat UI (full SDK only) */
+    chatUI: ChatUIModule | null;
     /**
      * Create a new StaticTVClient
      *
@@ -578,7 +592,8 @@ declare class StaticTVClient {
      */
     get isDisabled(): boolean;
     /**
-     * Check if this is a lite (scene-only) client
+     * Check if this is a lite client (no full features)
+     * Returns true until session confirms sdkType is 'full'
      */
     get isLite(): boolean;
     /**
@@ -596,6 +611,25 @@ declare class StaticTVClient {
      * @internal
      */
     getConfig(): StaticTVConfig;
+    /**
+     * Initialize full feature modules (guide, heartbeat, interactions, UI)
+     * @internal
+     */
+    private _initFullModules;
+    /**
+     * Called by SessionModule when server confirms sdkType is 'full'
+     * Enables guide, chat, heartbeat, and interactions modules
+     * @internal
+     */
+    _enableFullFeatures(): void;
+    /**
+     * Check if full features are enabled (server confirmed sdkType: 'full')
+     */
+    get hasFullFeatures(): boolean;
+    /**
+     * Get the SDK type (lite or full) - only available after session starts
+     */
+    get sdkType(): 'lite' | 'full';
     /**
      * Cleanup when done (call before scene unload)
      */

package/dist/index.js

@@ -249,13 +249,22 @@ var SessionModule = class {
     this.sessionId = null;
     this.heartbeatTimerId = null;
     this.isActive = false;
+    this._sdkType = "lite";
     this.client = client;
   }
+  /**
+   * Get the SDK type returned by the server
+   * Determines what features are available (lite = sessions only, full = guide + chat + more)
+   */
+  get sdkType() {
+    return this._sdkType;
+  }
   /**
    * Get the appropriate session endpoint based on key type
+   * All dcls_ keys use /scene-session, dclk_ keys use /session
    */
   getEndpoint() {
-    return this.client.isLite ? "/scene-session" : "/session";
+    return this.client.keyType === "scene" ? "/scene-session" : "/session";
   }
   /**
    * Get player wallet - prioritize config, fallback to runtime detection
@@ -296,8 +305,12 @@ var SessionModule = class {
       if (response.success && response.sessionId) {
         this.sessionId = response.sessionId;
         this.isActive = true;
+        this._sdkType = response.sdkType || "lite";
         this.startHeartbeat();
-        this.client.log(`Session started: ${this.sessionId}`);
+        this.client.log(`Session started: ${this.sessionId}, sdkType: ${this._sdkType}`);
+        if (this._sdkType === "full") {
+          this.client._enableFullFeatures();
+        }
         return this.sessionId;
       }
       return null;
@@ -765,9 +778,12 @@ var GuideUIModule = class {
     // =============================================================================
     /**
      * Get the guide UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     this.getComponent = () => {
-      if (!this._isVisible) return null;
+      if (!this._isVisible) {
+        return this.renderToggleButton();
+      }
       const windowW = this.s(UI_DIMENSIONS.guide.width);
       return import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
         uiTransform: {
@@ -1323,6 +1339,30 @@ var GuideUIModule = class {
       ]
     });
   }
+  renderToggleButton() {
+    return import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
+      uiTransform: {
+        positionType: "absolute",
+        position: { right: 20, top: "40%" },
+        width: this.s(80),
+        height: this.s(40),
+        justifyContent: "center",
+        alignItems: "center"
+      },
+      uiBackground: { color: import_math3.Color4.create(0, 0.5, 0.5, 0.9) },
+      onMouseDown: () => this.show(),
+      children: [
+        import_react_ecs2.default.createElement(import_react_ecs2.UiEntity, {
+          uiText: {
+            value: "GUIDE",
+            fontSize: this.s(16),
+            color: THEME.colors.white,
+            textAlign: "middle-center"
+          }
+        })
+      ]
+    });
+  }
 };
 
 // src/ui/chat-ui.tsx
@@ -1367,9 +1407,12 @@ var ChatUIModule = class {
     // =============================================================================
     /**
      * Get the chat UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     this.getComponent = () => {
-      if (!this._isVisible) return null;
+      if (!this._isVisible) {
+        return this.renderToggleButton();
+      }
       const scaledTheme = scaleChatTheme(DEFAULT_CHAT_THEME, this.fontScale);
       const positionStyle = this.getPositionStyle();
       return import_react_ecs3.default.createElement(import_react_ecs3.UiEntity, {
@@ -2094,6 +2137,31 @@ var ChatUIModule = class {
       ]
     });
   }
+  renderToggleButton() {
+    const unreadBadge = this._unreadCount > 0 ? ` (${this._unreadCount})` : "";
+    return import_react_ecs3.default.createElement(import_react_ecs3.UiEntity, {
+      uiTransform: {
+        positionType: "absolute",
+        position: { right: 20, top: "48%" },
+        width: 80,
+        height: 40,
+        justifyContent: "center",
+        alignItems: "center"
+      },
+      uiBackground: { color: import_math4.Color4.create(0.6, 0, 0.5, 0.9) },
+      onMouseDown: () => this.show(),
+      children: [
+        import_react_ecs3.default.createElement(import_react_ecs3.UiEntity, {
+          uiText: {
+            value: `CHAT${unreadBadge}`,
+            fontSize: 16,
+            color: THEME.colors.white,
+            textAlign: "middle-center"
+          }
+        })
+      ]
+    });
+  }
 };
 
 // src/StaticTVClient.ts
@@ -2123,6 +2191,19 @@ var StaticTVClient = class {
   constructor(config) {
     this._keyType = null;
     this._disabled = false;
+    this._fullFeaturesEnabled = false;
+    /** Guide module - fetch channel lineup (full SDK only) */
+    this.guide = null;
+    /** Session module - track visitor sessions (all keys, null when disabled) */
+    this.session = null;
+    /** Heartbeat module - track video watching (full SDK only) */
+    this.heartbeat = null;
+    /** Interactions module - like/follow channels (full SDK only) */
+    this.interactions = null;
+    /** Guide UI module - channel browser UI (full SDK only) */
+    this.guideUI = null;
+    /** Chat UI module - real-time chat UI (full SDK only) */
+    this.chatUI = null;
     this.config = {
       autoStartSession: true,
       sessionHeartbeatInterval: 3e4,
@@ -2151,27 +2232,11 @@ var StaticTVClient = class {
       console.log("[StaticTV] Invalid apiKey format (must start with dclk_ or dcls_) - tracking disabled. Scene will load normally.");
       this._disabled = true;
       this._keyType = null;
-      this.session = null;
-      this.guide = null;
-      this.heartbeat = null;
-      this.interactions = null;
-      this.guideUI = null;
-      this.chatUI = null;
       return;
     }
     this.session = new SessionModule(this);
     if (this._keyType === KEY_TYPE_CHANNEL) {
-      this.guide = new GuideModule(this);
-      this.heartbeat = new HeartbeatModule(this);
-      this.interactions = new InteractionsModule(this);
-      this.guideUI = new GuideUIModule(this, config.guideUI);
-      this.chatUI = new ChatUIModule(this, config.chatUI);
-    } else {
-      this.guide = null;
-      this.heartbeat = null;
-      this.interactions = null;
-      this.guideUI = null;
-      this.chatUI = null;
+      this._initFullModules();
     }
     if (this.config.autoStartSession) {
       fetchUserData().then(() => {
@@ -2200,10 +2265,11 @@ var StaticTVClient = class {
     return this._disabled;
   }
   /**
-   * Check if this is a lite (scene-only) client
+   * Check if this is a lite client (no full features)
+   * Returns true until session confirms sdkType is 'full'
    */
   get isLite() {
-    return this._keyType === KEY_TYPE_SCENE;
+    return !this._fullFeaturesEnabled;
   }
   /**
    * Make an authenticated API request
@@ -2236,6 +2302,40 @@ var StaticTVClient = class {
   getConfig() {
     return this.config;
   }
+  /**
+   * Initialize full feature modules (guide, heartbeat, interactions, UI)
+   * @internal
+   */
+  _initFullModules() {
+    if (this._fullFeaturesEnabled) return;
+    this.guide = new GuideModule(this);
+    this.heartbeat = new HeartbeatModule(this);
+    this.interactions = new InteractionsModule(this);
+    this.guideUI = new GuideUIModule(this, this.config.guideUI);
+    this.chatUI = new ChatUIModule(this, this.config.chatUI);
+    this._fullFeaturesEnabled = true;
+    this.log("Full features enabled (guide, chat, heartbeat, interactions)");
+  }
+  /**
+   * Called by SessionModule when server confirms sdkType is 'full'
+   * Enables guide, chat, heartbeat, and interactions modules
+   * @internal
+   */
+  _enableFullFeatures() {
+    this._initFullModules();
+  }
+  /**
+   * Check if full features are enabled (server confirmed sdkType: 'full')
+   */
+  get hasFullFeatures() {
+    return this._fullFeaturesEnabled;
+  }
+  /**
+   * Get the SDK type (lite or full) - only available after session starts
+   */
+  get sdkType() {
+    return this.session?.sdkType || "lite";
+  }
   /**
    * Cleanup when done (call before scene unload)
    */

package/dist/index.mjs

@@ -209,13 +209,22 @@ var SessionModule = class {
     this.sessionId = null;
     this.heartbeatTimerId = null;
     this.isActive = false;
+    this._sdkType = "lite";
     this.client = client;
   }
+  /**
+   * Get the SDK type returned by the server
+   * Determines what features are available (lite = sessions only, full = guide + chat + more)
+   */
+  get sdkType() {
+    return this._sdkType;
+  }
   /**
    * Get the appropriate session endpoint based on key type
+   * All dcls_ keys use /scene-session, dclk_ keys use /session
    */
   getEndpoint() {
-    return this.client.isLite ? "/scene-session" : "/session";
+    return this.client.keyType === "scene" ? "/scene-session" : "/session";
   }
   /**
    * Get player wallet - prioritize config, fallback to runtime detection
@@ -256,8 +265,12 @@ var SessionModule = class {
       if (response.success && response.sessionId) {
         this.sessionId = response.sessionId;
         this.isActive = true;
+        this._sdkType = response.sdkType || "lite";
         this.startHeartbeat();
-        this.client.log(`Session started: ${this.sessionId}`);
+        this.client.log(`Session started: ${this.sessionId}, sdkType: ${this._sdkType}`);
+        if (this._sdkType === "full") {
+          this.client._enableFullFeatures();
+        }
         return this.sessionId;
       }
       return null;
@@ -725,9 +738,12 @@ var GuideUIModule = class {
     // =============================================================================
     /**
      * Get the guide UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     this.getComponent = () => {
-      if (!this._isVisible) return null;
+      if (!this._isVisible) {
+        return this.renderToggleButton();
+      }
       const windowW = this.s(UI_DIMENSIONS.guide.width);
       return ReactEcs2.createElement(UiEntity2, {
         uiTransform: {
@@ -1283,6 +1299,30 @@ var GuideUIModule = class {
       ]
     });
   }
+  renderToggleButton() {
+    return ReactEcs2.createElement(UiEntity2, {
+      uiTransform: {
+        positionType: "absolute",
+        position: { right: 20, top: "40%" },
+        width: this.s(80),
+        height: this.s(40),
+        justifyContent: "center",
+        alignItems: "center"
+      },
+      uiBackground: { color: Color43.create(0, 0.5, 0.5, 0.9) },
+      onMouseDown: () => this.show(),
+      children: [
+        ReactEcs2.createElement(UiEntity2, {
+          uiText: {
+            value: "GUIDE",
+            fontSize: this.s(16),
+            color: THEME.colors.white,
+            textAlign: "middle-center"
+          }
+        })
+      ]
+    });
+  }
 };
 
 // src/ui/chat-ui.tsx
@@ -1327,9 +1367,12 @@ var ChatUIModule = class {
     // =============================================================================
     /**
      * Get the chat UI component for rendering
+     * Returns toggle button when hidden, full panel when visible
      */
     this.getComponent = () => {
-      if (!this._isVisible) return null;
+      if (!this._isVisible) {
+        return this.renderToggleButton();
+      }
       const scaledTheme = scaleChatTheme(DEFAULT_CHAT_THEME, this.fontScale);
       const positionStyle = this.getPositionStyle();
       return ReactEcs3.createElement(UiEntity3, {
@@ -2054,6 +2097,31 @@ var ChatUIModule = class {
       ]
     });
   }
+  renderToggleButton() {
+    const unreadBadge = this._unreadCount > 0 ? ` (${this._unreadCount})` : "";
+    return ReactEcs3.createElement(UiEntity3, {
+      uiTransform: {
+        positionType: "absolute",
+        position: { right: 20, top: "48%" },
+        width: 80,
+        height: 40,
+        justifyContent: "center",
+        alignItems: "center"
+      },
+      uiBackground: { color: Color44.create(0.6, 0, 0.5, 0.9) },
+      onMouseDown: () => this.show(),
+      children: [
+        ReactEcs3.createElement(UiEntity3, {
+          uiText: {
+            value: `CHAT${unreadBadge}`,
+            fontSize: 16,
+            color: THEME.colors.white,
+            textAlign: "middle-center"
+          }
+        })
+      ]
+    });
+  }
 };
 
 // src/StaticTVClient.ts
@@ -2083,6 +2151,19 @@ var StaticTVClient = class {
   constructor(config) {
     this._keyType = null;
     this._disabled = false;
+    this._fullFeaturesEnabled = false;
+    /** Guide module - fetch channel lineup (full SDK only) */
+    this.guide = null;
+    /** Session module - track visitor sessions (all keys, null when disabled) */
+    this.session = null;
+    /** Heartbeat module - track video watching (full SDK only) */
+    this.heartbeat = null;
+    /** Interactions module - like/follow channels (full SDK only) */
+    this.interactions = null;
+    /** Guide UI module - channel browser UI (full SDK only) */
+    this.guideUI = null;
+    /** Chat UI module - real-time chat UI (full SDK only) */
+    this.chatUI = null;
     this.config = {
       autoStartSession: true,
       sessionHeartbeatInterval: 3e4,
@@ -2111,27 +2192,11 @@ var StaticTVClient = class {
       console.log("[StaticTV] Invalid apiKey format (must start with dclk_ or dcls_) - tracking disabled. Scene will load normally.");
       this._disabled = true;
       this._keyType = null;
-      this.session = null;
-      this.guide = null;
-      this.heartbeat = null;
-      this.interactions = null;
-      this.guideUI = null;
-      this.chatUI = null;
       return;
     }
     this.session = new SessionModule(this);
     if (this._keyType === KEY_TYPE_CHANNEL) {
-      this.guide = new GuideModule(this);
-      this.heartbeat = new HeartbeatModule(this);
-      this.interactions = new InteractionsModule(this);
-      this.guideUI = new GuideUIModule(this, config.guideUI);
-      this.chatUI = new ChatUIModule(this, config.chatUI);
-    } else {
-      this.guide = null;
-      this.heartbeat = null;
-      this.interactions = null;
-      this.guideUI = null;
-      this.chatUI = null;
+      this._initFullModules();
     }
     if (this.config.autoStartSession) {
       fetchUserData().then(() => {
@@ -2160,10 +2225,11 @@ var StaticTVClient = class {
     return this._disabled;
   }
   /**
-   * Check if this is a lite (scene-only) client
+   * Check if this is a lite client (no full features)
+   * Returns true until session confirms sdkType is 'full'
    */
   get isLite() {
-    return this._keyType === KEY_TYPE_SCENE;
+    return !this._fullFeaturesEnabled;
   }
   /**
    * Make an authenticated API request
@@ -2196,6 +2262,40 @@ var StaticTVClient = class {
   getConfig() {
     return this.config;
   }
+  /**
+   * Initialize full feature modules (guide, heartbeat, interactions, UI)
+   * @internal
+   */
+  _initFullModules() {
+    if (this._fullFeaturesEnabled) return;
+    this.guide = new GuideModule(this);
+    this.heartbeat = new HeartbeatModule(this);
+    this.interactions = new InteractionsModule(this);
+    this.guideUI = new GuideUIModule(this, this.config.guideUI);
+    this.chatUI = new ChatUIModule(this, this.config.chatUI);
+    this._fullFeaturesEnabled = true;
+    this.log("Full features enabled (guide, chat, heartbeat, interactions)");
+  }
+  /**
+   * Called by SessionModule when server confirms sdkType is 'full'
+   * Enables guide, chat, heartbeat, and interactions modules
+   * @internal
+   */
+  _enableFullFeatures() {
+    this._initFullModules();
+  }
+  /**
+   * Check if full features are enabled (server confirmed sdkType: 'full')
+   */
+  get hasFullFeatures() {
+    return this._fullFeaturesEnabled;
+  }
+  /**
+   * Get the SDK type (lite or full) - only available after session starts
+   */
+  get sdkType() {
+    return this.session?.sdkType || "lite";
+  }
   /**
    * Cleanup when done (call before scene unload)
    */

package/package.json

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