@thestatic-tv/dcl-sdk 2.0.2 → 2.1.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;
     /**
@@ -524,12 +533,12 @@ declare class ChatUIModule {
 /**
  * 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 +546,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 +588,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 +607,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;
     /**
@@ -524,12 +533,12 @@ declare class ChatUIModule {
 /**
  * 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 +546,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 +588,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 +607,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;
@@ -2123,6 +2136,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,
@@ -2132,7 +2158,7 @@ var StaticTVClient = class {
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
     if (!config.apiKey) {
-      console.warn("[StaticTV] No apiKey provided - tracking disabled. Scene will load normally.");
+      console.log("[StaticTV] No apiKey provided - tracking disabled. Scene will load normally.");
       this._disabled = true;
       this._keyType = null;
       this.session = null;
@@ -2148,30 +2174,14 @@ var StaticTVClient = class {
     } else if (config.apiKey.startsWith("dcls_")) {
       this._keyType = KEY_TYPE_SCENE;
     } else {
-      console.warn("[StaticTV] Invalid apiKey format (must start with dclk_ or dcls_) - tracking disabled. Scene will load normally.");
+      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 +2210,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 +2247,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;
@@ -2083,6 +2096,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,
@@ -2092,7 +2118,7 @@ var StaticTVClient = class {
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
     if (!config.apiKey) {
-      console.warn("[StaticTV] No apiKey provided - tracking disabled. Scene will load normally.");
+      console.log("[StaticTV] No apiKey provided - tracking disabled. Scene will load normally.");
       this._disabled = true;
       this._keyType = null;
       this.session = null;
@@ -2108,30 +2134,14 @@ var StaticTVClient = class {
     } else if (config.apiKey.startsWith("dcls_")) {
       this._keyType = KEY_TYPE_SCENE;
     } else {
-      console.warn("[StaticTV] Invalid apiKey format (must start with dclk_ or dcls_) - tracking disabled. Scene will load normally.");
+      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 +2170,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 +2207,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.2",
+  "version": "2.1.0",
   "description": "Connect your Decentraland scene to thestatic.tv - full channel lineup, metrics tracking, and interactions",
   "main": "dist/index.js",
   "module": "dist/index.mjs",