@thestatic-tv/dcl-sdk 2.0.1 → 2.0.2

package/dist/index.d.mts

@@ -536,10 +536,11 @@ declare class StaticTVClient {
     private config;
     private baseUrl;
     private _keyType;
+    private _disabled;
     /** Guide module - fetch channel lineup (channel keys only) */
     readonly guide: GuideModule | null;
-    /** Session module - track visitor sessions (all keys) */
-    readonly session: SessionModule;
+    /** 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) */
@@ -569,9 +570,13 @@ declare class StaticTVClient {
      */
     constructor(config: StaticTVConfig);
     /**
-     * Get the key type (channel or scene)
+     * Get the key type (channel, scene, or null if disabled)
      */
-    get keyType(): 'channel' | 'scene';
+    get keyType(): 'channel' | 'scene' | null;
+    /**
+     * Check if tracking is disabled (no valid API key)
+     */
+    get isDisabled(): boolean;
     /**
      * Check if this is a lite (scene-only) client
      */

package/dist/index.d.ts

@@ -536,10 +536,11 @@ declare class StaticTVClient {
     private config;
     private baseUrl;
     private _keyType;
+    private _disabled;
     /** Guide module - fetch channel lineup (channel keys only) */
     readonly guide: GuideModule | null;
-    /** Session module - track visitor sessions (all keys) */
-    readonly session: SessionModule;
+    /** 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) */
@@ -569,9 +570,13 @@ declare class StaticTVClient {
      */
     constructor(config: StaticTVConfig);
     /**
-     * Get the key type (channel or scene)
+     * Get the key type (channel, scene, or null if disabled)
      */
-    get keyType(): 'channel' | 'scene';
+    get keyType(): 'channel' | 'scene' | null;
+    /**
+     * Check if tracking is disabled (no valid API key)
+     */
+    get isDisabled(): boolean;
     /**
      * Check if this is a lite (scene-only) client
      */

package/dist/index.js

@@ -453,7 +453,7 @@ var HeartbeatModule = class {
   async sendHeartbeat() {
     if (!this.currentChannel || !this.isWatching) return;
     try {
-      const sessionId = this.client.session.getSessionId();
+      const sessionId = this.client.session?.getSessionId();
       await this.client.request("/heartbeat", {
         method: "POST",
         body: JSON.stringify({
@@ -2121,16 +2121,8 @@ var StaticTVClient = class {
    * ```
    */
   constructor(config) {
-    if (!config.apiKey) {
-      throw new Error("StaticTVClient: apiKey is required");
-    }
-    if (config.apiKey.startsWith("dclk_")) {
-      this._keyType = KEY_TYPE_CHANNEL;
-    } else if (config.apiKey.startsWith("dcls_")) {
-      this._keyType = KEY_TYPE_SCENE;
-    } else {
-      throw new Error("StaticTVClient: invalid apiKey format. Must start with dclk_ or dcls_");
-    }
+    this._keyType = null;
+    this._disabled = false;
     this.config = {
       autoStartSession: true,
       sessionHeartbeatInterval: 3e4,
@@ -2139,6 +2131,34 @@ var StaticTVClient = class {
       ...config
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    if (!config.apiKey) {
+      console.warn("[StaticTV] No apiKey provided - 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;
+    }
+    if (config.apiKey.startsWith("dclk_")) {
+      this._keyType = KEY_TYPE_CHANNEL;
+    } 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.");
+      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);
@@ -2168,11 +2188,17 @@ var StaticTVClient = class {
     this.log(`StaticTVClient initialized (${this._keyType} mode)`);
   }
   /**
-   * Get the key type (channel or scene)
+   * Get the key type (channel, scene, or null if disabled)
    */
   get keyType() {
     return this._keyType;
   }
+  /**
+   * Check if tracking is disabled (no valid API key)
+   */
+  get isDisabled() {
+    return this._disabled;
+  }
   /**
    * Check if this is a lite (scene-only) client
    */
@@ -2214,13 +2240,19 @@ var StaticTVClient = class {
    * Cleanup when done (call before scene unload)
    */
   async destroy() {
+    if (this._disabled) {
+      this.log("StaticTVClient destroyed (was disabled)");
+      return;
+    }
     if (this.heartbeat) {
       this.heartbeat.stopWatching();
     }
     if (this.chatUI) {
       this.chatUI.destroy();
     }
-    await this.session.endSession();
+    if (this.session) {
+      await this.session.endSession();
+    }
     this.log("StaticTVClient destroyed");
   }
 };

package/dist/index.mjs

@@ -413,7 +413,7 @@ var HeartbeatModule = class {
   async sendHeartbeat() {
     if (!this.currentChannel || !this.isWatching) return;
     try {
-      const sessionId = this.client.session.getSessionId();
+      const sessionId = this.client.session?.getSessionId();
       await this.client.request("/heartbeat", {
         method: "POST",
         body: JSON.stringify({
@@ -2081,16 +2081,8 @@ var StaticTVClient = class {
    * ```
    */
   constructor(config) {
-    if (!config.apiKey) {
-      throw new Error("StaticTVClient: apiKey is required");
-    }
-    if (config.apiKey.startsWith("dclk_")) {
-      this._keyType = KEY_TYPE_CHANNEL;
-    } else if (config.apiKey.startsWith("dcls_")) {
-      this._keyType = KEY_TYPE_SCENE;
-    } else {
-      throw new Error("StaticTVClient: invalid apiKey format. Must start with dclk_ or dcls_");
-    }
+    this._keyType = null;
+    this._disabled = false;
     this.config = {
       autoStartSession: true,
       sessionHeartbeatInterval: 3e4,
@@ -2099,6 +2091,34 @@ var StaticTVClient = class {
       ...config
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    if (!config.apiKey) {
+      console.warn("[StaticTV] No apiKey provided - 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;
+    }
+    if (config.apiKey.startsWith("dclk_")) {
+      this._keyType = KEY_TYPE_CHANNEL;
+    } 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.");
+      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);
@@ -2128,11 +2148,17 @@ var StaticTVClient = class {
     this.log(`StaticTVClient initialized (${this._keyType} mode)`);
   }
   /**
-   * Get the key type (channel or scene)
+   * Get the key type (channel, scene, or null if disabled)
    */
   get keyType() {
     return this._keyType;
   }
+  /**
+   * Check if tracking is disabled (no valid API key)
+   */
+  get isDisabled() {
+    return this._disabled;
+  }
   /**
    * Check if this is a lite (scene-only) client
    */
@@ -2174,13 +2200,19 @@ var StaticTVClient = class {
    * Cleanup when done (call before scene unload)
    */
   async destroy() {
+    if (this._disabled) {
+      this.log("StaticTVClient destroyed (was disabled)");
+      return;
+    }
     if (this.heartbeat) {
       this.heartbeat.stopWatching();
     }
     if (this.chatUI) {
       this.chatUI.destroy();
     }
-    await this.session.endSession();
+    if (this.session) {
+      await this.session.endSession();
+    }
     this.log("StaticTVClient destroyed");
   }
 };

package/package.json

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