@thestatic-tv/dcl-sdk 1.0.2 → 1.0.4

package/dist/index.d.mts

@@ -1,3 +1,12 @@
+/**
+ * Player identity data from DCL
+ */
+interface PlayerData {
+    /** Player's wallet address (userId from DCL) */
+    wallet?: string;
+    /** Player's display name */
+    name?: string;
+}
 /**
  * Configuration options for StaticTVClient
  */
@@ -14,6 +23,17 @@ interface StaticTVConfig {
     debug?: boolean;
     /** Custom API base URL (default: https://thestatic.tv/api/v1/dcl) */
     baseUrl?: string;
+    /**
+     * Player data from DCL - pass from your scene's getPlayer() call
+     * @example
+     * import { getPlayer } from '@dcl/sdk/players'
+     * const player = getPlayer()
+     * new StaticTVClient({
+     *   apiKey: 'dcls_...',
+     *   player: { wallet: player?.userId, name: player?.name }
+     * })
+     */
+    player?: PlayerData;
 }
 /**
  * Channel information from the guide
@@ -148,20 +168,28 @@ declare class GuideModule {
 declare class SessionModule {
     private client;
     private sessionId;
-    private heartbeatInterval;
+    private heartbeatTimerId;
     private isActive;
     constructor(client: StaticTVClient);
     /**
      * Get the appropriate session endpoint based on key type
      */
     private getEndpoint;
+    /**
+     * Get player wallet - prioritize config, fallback to runtime detection
+     */
+    private getWallet;
+    /**
+     * Get player display name - prioritize config, fallback to runtime detection
+     */
+    private getDisplayName;
     /**
      * Start a new session
      * Called automatically if autoStartSession is true
      */
     startSession(metadata?: Record<string, unknown>): Promise<string | null>;
     /**
-     * Start the heartbeat interval
+     * Start the heartbeat interval using DCL-compatible timer
      */
     private startHeartbeat;
     /**
@@ -193,7 +221,7 @@ declare class SessionModule {
 
 declare class HeartbeatModule {
     private client;
-    private watchInterval;
+    private watchTimerId;
     private currentChannel;
     private isWatching;
     constructor(client: StaticTVClient);
@@ -208,6 +236,10 @@ declare class HeartbeatModule {
      * Stop tracking video watching
      */
     stopWatching(): void;
+    /**
+     * Get player wallet - prioritize config, fallback to runtime detection
+     */
+    private getWallet;
     /**
      * Send a watching heartbeat (1 heartbeat = 1 minute watched)
      */

package/dist/index.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Player identity data from DCL
+ */
+interface PlayerData {
+    /** Player's wallet address (userId from DCL) */
+    wallet?: string;
+    /** Player's display name */
+    name?: string;
+}
 /**
  * Configuration options for StaticTVClient
  */
@@ -14,6 +23,17 @@ interface StaticTVConfig {
     debug?: boolean;
     /** Custom API base URL (default: https://thestatic.tv/api/v1/dcl) */
     baseUrl?: string;
+    /**
+     * Player data from DCL - pass from your scene's getPlayer() call
+     * @example
+     * import { getPlayer } from '@dcl/sdk/players'
+     * const player = getPlayer()
+     * new StaticTVClient({
+     *   apiKey: 'dcls_...',
+     *   player: { wallet: player?.userId, name: player?.name }
+     * })
+     */
+    player?: PlayerData;
 }
 /**
  * Channel information from the guide
@@ -148,20 +168,28 @@ declare class GuideModule {
 declare class SessionModule {
     private client;
     private sessionId;
-    private heartbeatInterval;
+    private heartbeatTimerId;
     private isActive;
     constructor(client: StaticTVClient);
     /**
      * Get the appropriate session endpoint based on key type
      */
     private getEndpoint;
+    /**
+     * Get player wallet - prioritize config, fallback to runtime detection
+     */
+    private getWallet;
+    /**
+     * Get player display name - prioritize config, fallback to runtime detection
+     */
+    private getDisplayName;
     /**
      * Start a new session
      * Called automatically if autoStartSession is true
      */
     startSession(metadata?: Record<string, unknown>): Promise<string | null>;
     /**
-     * Start the heartbeat interval
+     * Start the heartbeat interval using DCL-compatible timer
      */
     private startHeartbeat;
     /**
@@ -193,7 +221,7 @@ declare class SessionModule {
 
 declare class HeartbeatModule {
     private client;
-    private watchInterval;
+    private watchTimerId;
     private currentChannel;
     private isWatching;
     constructor(client: StaticTVClient);
@@ -208,6 +236,10 @@ declare class HeartbeatModule {
      * Stop tracking video watching
      */
     stopWatching(): void;
+    /**
+     * Get player wallet - prioritize config, fallback to runtime detection
+     */
+    private getWallet;
     /**
      * Send a watching heartbeat (1 heartbeat = 1 minute watched)
      */

package/dist/index.js

@@ -116,11 +116,54 @@ function getPlayerDisplayName() {
   }
 }
 
+// src/utils/timer.ts
+var import_ecs = require("@dcl/sdk/ecs");
+var nextTimerId = 1;
+var timers = /* @__PURE__ */ new Map();
+var systemAdded = false;
+function ensureTimerSystem() {
+  if (systemAdded) return;
+  import_ecs.engine.addSystem((dt) => {
+    for (const timer of timers.values()) {
+      if (!timer.active) continue;
+      timer.elapsedTime += dt;
+      if (timer.elapsedTime >= timer.intervalSeconds) {
+        timer.elapsedTime = 0;
+        try {
+          timer.callback();
+        } catch (e) {
+          console.error("[StaticTV Timer] Callback error:", e);
+        }
+      }
+    }
+  });
+  systemAdded = true;
+}
+function dclSetInterval(callback, intervalMs) {
+  ensureTimerSystem();
+  const id = nextTimerId++;
+  timers.set(id, {
+    id,
+    callback,
+    intervalSeconds: intervalMs / 1e3,
+    elapsedTime: 0,
+    active: true
+  });
+  return id;
+}
+function dclClearInterval(timerId) {
+  const timer = timers.get(timerId);
+  if (timer) {
+    timer.active = false;
+    timers.delete(timerId);
+  }
+}
+
 // src/modules/session.ts
 var SessionModule = class {
   constructor(client) {
     this.sessionId = null;
-    this.heartbeatInterval = null;
+    this.heartbeatTimerId = null;
     this.isActive = false;
     this.client = client;
   }
@@ -130,6 +173,20 @@ var SessionModule = class {
   getEndpoint() {
     return this.client.isLite ? "/scene-session" : "/session";
   }
+  /**
+   * Get player wallet - prioritize config, fallback to runtime detection
+   */
+  getWallet() {
+    const config = this.client.getConfig();
+    return config.player?.wallet || getPlayerWallet();
+  }
+  /**
+   * Get player display name - prioritize config, fallback to runtime detection
+   */
+  getDisplayName() {
+    const config = this.client.getConfig();
+    return config.player?.name || getPlayerDisplayName();
+  }
   /**
    * Start a new session
    * Called automatically if autoStartSession is true
@@ -140,12 +197,15 @@ var SessionModule = class {
       return this.sessionId;
     }
     try {
+      const walletAddress = this.getWallet();
+      const dclDisplayName = this.getDisplayName();
+      this.client.log(`Starting session with wallet: ${walletAddress}, name: ${dclDisplayName}`);
       const response = await this.client.request(this.getEndpoint(), {
         method: "POST",
         body: JSON.stringify({
           action: "enter",
-          walletAddress: getPlayerWallet(),
-          dclDisplayName: getPlayerDisplayName(),
+          walletAddress,
+          dclDisplayName,
           metadata
         })
       });
@@ -163,12 +223,12 @@ var SessionModule = class {
     }
   }
   /**
-   * Start the heartbeat interval
+   * Start the heartbeat interval using DCL-compatible timer
    */
   startHeartbeat() {
-    if (this.heartbeatInterval) return;
+    if (this.heartbeatTimerId !== null) return;
     const interval = this.client.getConfig().sessionHeartbeatInterval || 3e4;
-    this.heartbeatInterval = setInterval(() => {
+    this.heartbeatTimerId = dclSetInterval(() => {
       this.sendHeartbeat();
     }, interval);
   }
@@ -195,9 +255,9 @@ var SessionModule = class {
    */
   async endSession() {
     if (!this.isActive) return;
-    if (this.heartbeatInterval) {
-      clearInterval(this.heartbeatInterval);
-      this.heartbeatInterval = null;
+    if (this.heartbeatTimerId !== null) {
+      dclClearInterval(this.heartbeatTimerId);
+      this.heartbeatTimerId = null;
     }
     if (this.sessionId) {
       try {
@@ -234,7 +294,7 @@ var SessionModule = class {
    */
   async getStats() {
     try {
-      const wallet = getPlayerWallet();
+      const wallet = this.getWallet();
       const queryParam = wallet ? `?wallet=${wallet}` : "";
       const response = await this.client.request(
         `/scene-stats${queryParam}`,
@@ -255,7 +315,7 @@ var SessionModule = class {
 // src/modules/heartbeat.ts
 var HeartbeatModule = class {
   constructor(client) {
-    this.watchInterval = null;
+    this.watchTimerId = null;
     this.currentChannel = null;
     this.isWatching = false;
     this.client = client;
@@ -278,7 +338,7 @@ var HeartbeatModule = class {
     this.isWatching = true;
     this.sendHeartbeat();
     const interval = this.client.getConfig().watchHeartbeatInterval || 6e4;
-    this.watchInterval = setInterval(() => {
+    this.watchTimerId = dclSetInterval(() => {
       this.sendHeartbeat();
     }, interval);
     this.client.log(`Started watching ${channelSlug}`);
@@ -288,14 +348,21 @@ var HeartbeatModule = class {
    */
   stopWatching() {
     if (!this.isWatching) return;
-    if (this.watchInterval) {
-      clearInterval(this.watchInterval);
-      this.watchInterval = null;
+    if (this.watchTimerId !== null) {
+      dclClearInterval(this.watchTimerId);
+      this.watchTimerId = null;
     }
     this.client.log(`Stopped watching ${this.currentChannel}`);
     this.currentChannel = null;
     this.isWatching = false;
   }
+  /**
+   * Get player wallet - prioritize config, fallback to runtime detection
+   */
+  getWallet() {
+    const config = this.client.getConfig();
+    return config.player?.wallet || getPlayerWallet();
+  }
   /**
    * Send a watching heartbeat (1 heartbeat = 1 minute watched)
    */
@@ -307,7 +374,7 @@ var HeartbeatModule = class {
         method: "POST",
         body: JSON.stringify({
           channelSlug: this.currentChannel,
-          walletAddress: getPlayerWallet(),
+          walletAddress: this.getWallet(),
           sessionId
         })
       });

package/dist/index.mjs

@@ -91,11 +91,54 @@ function getPlayerDisplayName() {
   }
 }
 
+// src/utils/timer.ts
+import { engine } from "@dcl/sdk/ecs";
+var nextTimerId = 1;
+var timers = /* @__PURE__ */ new Map();
+var systemAdded = false;
+function ensureTimerSystem() {
+  if (systemAdded) return;
+  engine.addSystem((dt) => {
+    for (const timer of timers.values()) {
+      if (!timer.active) continue;
+      timer.elapsedTime += dt;
+      if (timer.elapsedTime >= timer.intervalSeconds) {
+        timer.elapsedTime = 0;
+        try {
+          timer.callback();
+        } catch (e) {
+          console.error("[StaticTV Timer] Callback error:", e);
+        }
+      }
+    }
+  });
+  systemAdded = true;
+}
+function dclSetInterval(callback, intervalMs) {
+  ensureTimerSystem();
+  const id = nextTimerId++;
+  timers.set(id, {
+    id,
+    callback,
+    intervalSeconds: intervalMs / 1e3,
+    elapsedTime: 0,
+    active: true
+  });
+  return id;
+}
+function dclClearInterval(timerId) {
+  const timer = timers.get(timerId);
+  if (timer) {
+    timer.active = false;
+    timers.delete(timerId);
+  }
+}
+
 // src/modules/session.ts
 var SessionModule = class {
   constructor(client) {
     this.sessionId = null;
-    this.heartbeatInterval = null;
+    this.heartbeatTimerId = null;
     this.isActive = false;
     this.client = client;
   }
@@ -105,6 +148,20 @@ var SessionModule = class {
   getEndpoint() {
     return this.client.isLite ? "/scene-session" : "/session";
   }
+  /**
+   * Get player wallet - prioritize config, fallback to runtime detection
+   */
+  getWallet() {
+    const config = this.client.getConfig();
+    return config.player?.wallet || getPlayerWallet();
+  }
+  /**
+   * Get player display name - prioritize config, fallback to runtime detection
+   */
+  getDisplayName() {
+    const config = this.client.getConfig();
+    return config.player?.name || getPlayerDisplayName();
+  }
   /**
    * Start a new session
    * Called automatically if autoStartSession is true
@@ -115,12 +172,15 @@ var SessionModule = class {
       return this.sessionId;
     }
     try {
+      const walletAddress = this.getWallet();
+      const dclDisplayName = this.getDisplayName();
+      this.client.log(`Starting session with wallet: ${walletAddress}, name: ${dclDisplayName}`);
       const response = await this.client.request(this.getEndpoint(), {
         method: "POST",
         body: JSON.stringify({
           action: "enter",
-          walletAddress: getPlayerWallet(),
-          dclDisplayName: getPlayerDisplayName(),
+          walletAddress,
+          dclDisplayName,
           metadata
         })
       });
@@ -138,12 +198,12 @@ var SessionModule = class {
     }
   }
   /**
-   * Start the heartbeat interval
+   * Start the heartbeat interval using DCL-compatible timer
    */
   startHeartbeat() {
-    if (this.heartbeatInterval) return;
+    if (this.heartbeatTimerId !== null) return;
     const interval = this.client.getConfig().sessionHeartbeatInterval || 3e4;
-    this.heartbeatInterval = setInterval(() => {
+    this.heartbeatTimerId = dclSetInterval(() => {
       this.sendHeartbeat();
     }, interval);
   }
@@ -170,9 +230,9 @@ var SessionModule = class {
    */
   async endSession() {
     if (!this.isActive) return;
-    if (this.heartbeatInterval) {
-      clearInterval(this.heartbeatInterval);
-      this.heartbeatInterval = null;
+    if (this.heartbeatTimerId !== null) {
+      dclClearInterval(this.heartbeatTimerId);
+      this.heartbeatTimerId = null;
     }
     if (this.sessionId) {
       try {
@@ -209,7 +269,7 @@ var SessionModule = class {
    */
   async getStats() {
     try {
-      const wallet = getPlayerWallet();
+      const wallet = this.getWallet();
       const queryParam = wallet ? `?wallet=${wallet}` : "";
       const response = await this.client.request(
         `/scene-stats${queryParam}`,
@@ -230,7 +290,7 @@ var SessionModule = class {
 // src/modules/heartbeat.ts
 var HeartbeatModule = class {
   constructor(client) {
-    this.watchInterval = null;
+    this.watchTimerId = null;
     this.currentChannel = null;
     this.isWatching = false;
     this.client = client;
@@ -253,7 +313,7 @@ var HeartbeatModule = class {
     this.isWatching = true;
     this.sendHeartbeat();
     const interval = this.client.getConfig().watchHeartbeatInterval || 6e4;
-    this.watchInterval = setInterval(() => {
+    this.watchTimerId = dclSetInterval(() => {
       this.sendHeartbeat();
     }, interval);
     this.client.log(`Started watching ${channelSlug}`);
@@ -263,14 +323,21 @@ var HeartbeatModule = class {
    */
   stopWatching() {
     if (!this.isWatching) return;
-    if (this.watchInterval) {
-      clearInterval(this.watchInterval);
-      this.watchInterval = null;
+    if (this.watchTimerId !== null) {
+      dclClearInterval(this.watchTimerId);
+      this.watchTimerId = null;
     }
     this.client.log(`Stopped watching ${this.currentChannel}`);
     this.currentChannel = null;
     this.isWatching = false;
   }
+  /**
+   * Get player wallet - prioritize config, fallback to runtime detection
+   */
+  getWallet() {
+    const config = this.client.getConfig();
+    return config.player?.wallet || getPlayerWallet();
+  }
   /**
    * Send a watching heartbeat (1 heartbeat = 1 minute watched)
    */
@@ -282,7 +349,7 @@ var HeartbeatModule = class {
         method: "POST",
         body: JSON.stringify({
           channelSlug: this.currentChannel,
-          walletAddress: getPlayerWallet(),
+          walletAddress: this.getWallet(),
           sessionId
         })
       });

package/package.json

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