@thestatic-tv/dcl-sdk 1.0.0 → 1.0.2

package/dist/index.d.mts

@@ -84,6 +84,26 @@ interface InteractionResponse {
     alreadyExists: boolean;
     version: string;
 }
+/**
+ * Scene stats for display in-world
+ */
+interface SceneStats {
+    date: string;
+    totalSessions: number;
+    uniqueVisitors: number;
+    totalMinutes: number;
+    visitorNumber: number | null;
+    isFirstVisitor: boolean;
+}
+/**
+ * Scene stats response from the API
+ */
+interface SceneStatsResponse {
+    success: boolean;
+    stats: SceneStats;
+    sceneName: string | null;
+    version: string;
+}
 
 /**
  * Guide module - fetch channel lineup from thestatic.tv
@@ -160,6 +180,11 @@ declare class SessionModule {
      * Check if a session is currently active
      */
     isSessionActive(): boolean;
+    /**
+     * Get scene stats (visitors, sessions, etc.)
+     * Useful for displaying metrics in-world
+     */
+    getStats(): Promise<SceneStatsResponse['stats'] | null>;
 }
 
 /**
@@ -294,4 +319,4 @@ declare class StaticTVClient {
     destroy(): Promise<void>;
 }
 
-export { type Channel, GuideModule, type GuideResponse, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod };
+export { type Channel, GuideModule, type GuideResponse, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, type SceneStats, type SceneStatsResponse, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod };

package/dist/index.d.ts

@@ -84,6 +84,26 @@ interface InteractionResponse {
     alreadyExists: boolean;
     version: string;
 }
+/**
+ * Scene stats for display in-world
+ */
+interface SceneStats {
+    date: string;
+    totalSessions: number;
+    uniqueVisitors: number;
+    totalMinutes: number;
+    visitorNumber: number | null;
+    isFirstVisitor: boolean;
+}
+/**
+ * Scene stats response from the API
+ */
+interface SceneStatsResponse {
+    success: boolean;
+    stats: SceneStats;
+    sceneName: string | null;
+    version: string;
+}
 
 /**
  * Guide module - fetch channel lineup from thestatic.tv
@@ -160,6 +180,11 @@ declare class SessionModule {
      * Check if a session is currently active
      */
     isSessionActive(): boolean;
+    /**
+     * Get scene stats (visitors, sessions, etc.)
+     * Useful for displaying metrics in-world
+     */
+    getStats(): Promise<SceneStatsResponse['stats'] | null>;
 }
 
 /**
@@ -294,4 +319,4 @@ declare class StaticTVClient {
     destroy(): Promise<void>;
 }
 
-export { type Channel, GuideModule, type GuideResponse, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod };
+export { type Channel, GuideModule, type GuideResponse, HeartbeatModule, type HeartbeatResponse, type InteractionResponse, InteractionsModule, KEY_TYPE_CHANNEL, KEY_TYPE_SCENE, type SceneStats, type SceneStatsResponse, SessionModule, type SessionResponse, StaticTVClient, type StaticTVConfig, type Vod };

package/dist/index.js

@@ -32,22 +32,13 @@ module.exports = __toCommonJS(index_exports);
 
 // src/utils/http.ts
 async function request(url, options = {}) {
-  const { timeout = 1e4, ...fetchOptions } = options;
-  const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), timeout);
-  try {
-    const response = await fetch(url, {
-      ...fetchOptions,
-      signal: controller.signal
-    });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({}));
-      throw new Error(errorData.error || `HTTP ${response.status}`);
-    }
-    return response.json();
-  } finally {
-    clearTimeout(timeoutId);
+  const { timeout: _timeout, ...fetchOptions } = options;
+  const response = await fetch(url, fetchOptions);
+  if (!response.ok) {
+    const errorData = await response.json().catch(() => ({}));
+    throw new Error(errorData.error || `HTTP ${response.status}`);
   }
+  return response.json();
 }
 
 // src/modules/guide.ts
@@ -108,7 +99,7 @@ var GuideModule = class {
 // src/utils/identity.ts
 function getPlayerWallet() {
   try {
-    const { getPlayer } = require("@dcl/sdk/src/players");
+    const { getPlayer } = require("@dcl/sdk/players");
     const player = getPlayer();
     return player?.userId ?? null;
   } catch {
@@ -117,7 +108,7 @@ function getPlayerWallet() {
 }
 function getPlayerDisplayName() {
   try {
-    const { getPlayer } = require("@dcl/sdk/src/players");
+    const { getPlayer } = require("@dcl/sdk/players");
     const player = getPlayer();
     return player?.name ?? null;
   } catch {
@@ -237,6 +228,28 @@ var SessionModule = class {
   isSessionActive() {
     return this.isActive;
   }
+  /**
+   * Get scene stats (visitors, sessions, etc.)
+   * Useful for displaying metrics in-world
+   */
+  async getStats() {
+    try {
+      const wallet = getPlayerWallet();
+      const queryParam = wallet ? `?wallet=${wallet}` : "";
+      const response = await this.client.request(
+        `/scene-stats${queryParam}`,
+        { method: "GET" }
+      );
+      if (response.success && response.stats) {
+        this.client.log("Stats fetched:", response.stats);
+        return response.stats;
+      }
+      return null;
+    } catch (error) {
+      this.client.log(`Failed to fetch stats: ${error}`);
+      return null;
+    }
+  }
 };
 
 // src/modules/heartbeat.ts

package/dist/index.mjs

@@ -7,22 +7,13 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 
 // src/utils/http.ts
 async function request(url, options = {}) {
-  const { timeout = 1e4, ...fetchOptions } = options;
-  const controller = new AbortController();
-  const timeoutId = setTimeout(() => controller.abort(), timeout);
-  try {
-    const response = await fetch(url, {
-      ...fetchOptions,
-      signal: controller.signal
-    });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({}));
-      throw new Error(errorData.error || `HTTP ${response.status}`);
-    }
-    return response.json();
-  } finally {
-    clearTimeout(timeoutId);
+  const { timeout: _timeout, ...fetchOptions } = options;
+  const response = await fetch(url, fetchOptions);
+  if (!response.ok) {
+    const errorData = await response.json().catch(() => ({}));
+    throw new Error(errorData.error || `HTTP ${response.status}`);
   }
+  return response.json();
 }
 
 // src/modules/guide.ts
@@ -83,7 +74,7 @@ var GuideModule = class {
 // src/utils/identity.ts
 function getPlayerWallet() {
   try {
-    const { getPlayer } = __require("@dcl/sdk/src/players");
+    const { getPlayer } = __require("@dcl/sdk/players");
     const player = getPlayer();
     return player?.userId ?? null;
   } catch {
@@ -92,7 +83,7 @@ function getPlayerWallet() {
 }
 function getPlayerDisplayName() {
   try {
-    const { getPlayer } = __require("@dcl/sdk/src/players");
+    const { getPlayer } = __require("@dcl/sdk/players");
     const player = getPlayer();
     return player?.name ?? null;
   } catch {
@@ -212,6 +203,28 @@ var SessionModule = class {
   isSessionActive() {
     return this.isActive;
   }
+  /**
+   * Get scene stats (visitors, sessions, etc.)
+   * Useful for displaying metrics in-world
+   */
+  async getStats() {
+    try {
+      const wallet = getPlayerWallet();
+      const queryParam = wallet ? `?wallet=${wallet}` : "";
+      const response = await this.client.request(
+        `/scene-stats${queryParam}`,
+        { method: "GET" }
+      );
+      if (response.success && response.stats) {
+        this.client.log("Stats fetched:", response.stats);
+        return response.stats;
+      }
+      return null;
+    } catch (error) {
+      this.client.log(`Failed to fetch stats: ${error}`);
+      return null;
+    }
+  }
 };
 
 // src/modules/heartbeat.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thestatic-tv/dcl-sdk",
-  "version": "1.0.0",
+  "version": "1.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",