@thestatic-tv/dcl-sdk 1.0.3 → 1.0.5

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
@@ -155,6 +175,14 @@ declare class SessionModule {
      * 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
@@ -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
@@ -155,6 +175,14 @@ declare class SessionModule {
      * 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
@@ -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

@@ -173,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
@@ -183,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
         })
       });
@@ -277,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}`,
@@ -339,6 +356,13 @@ var HeartbeatModule = class {
     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)
    */
@@ -350,7 +374,7 @@ var HeartbeatModule = class {
         method: "POST",
         body: JSON.stringify({
           channelSlug: this.currentChannel,
-          walletAddress: getPlayerWallet(),
+          walletAddress: this.getWallet(),
           sessionId
         })
       });

package/dist/index.mjs

@@ -148,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
@@ -158,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
         })
       });
@@ -252,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}`,
@@ -314,6 +331,13 @@ var HeartbeatModule = class {
     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)
    */
@@ -325,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.3",
+  "version": "1.0.5",
   "description": "Connect your Decentraland scene to thestatic.tv - full channel lineup, metrics tracking, and interactions",
   "main": "dist/index.js",
   "module": "dist/index.mjs",