@thestatic-tv/dcl-sdk 2.5.26 → 2.5.29

package/dist/index.d.mts

@@ -87,6 +87,7 @@ interface StaticTVConfig {
     debug?: boolean;
     /** Custom API base URL (default: https://thestatic.tv/api/v1/dcl) */
     baseUrl?: string;
+    apiUrl?: string;
     /**
      * Player data from DCL - pass from your scene's getPlayer() call
      * @example
@@ -98,6 +99,18 @@ interface StaticTVConfig {
      * })
      */
     player?: PlayerData;
+    /**
+     * Custom boundary check function — overrides the SDK's auto-detected parcel bounds.
+     * Use this for L-shaped or irregular estates where the bounding box is too large.
+     * Return true if the player is physically inside your scene, false if nearby but outside.
+     * @example
+     * customBoundsCheck: () => {
+     *   const pos = getPlayerPosition()
+     *   if (!pos) return false
+     *   return (pos.x >= 0 && pos.x <= 16 && pos.z >= 0 && pos.z <= 64)
+     * }
+     */
+    customBoundsCheck?: () => boolean;
     /**
      * Guide UI configuration
      */
@@ -469,7 +482,8 @@ declare class SessionModule {
      */
     get bounds(): SceneBounds$1 | null;
     /**
-     * Check if player is currently within scene bounds
+     * Check if player is currently within scene bounds.
+     * Uses customBoundsCheck from config if provided, otherwise falls back to auto-detected parcel bounds.
      */
     isPlayerInScene(): boolean;
     /**
@@ -916,6 +930,7 @@ declare const KEY_TYPE_SCENE = "scene";
 declare class StaticTVClient {
     private config;
     private baseUrl;
+    readonly apiUrl: string;
     private _keyType;
     private _keyId;
     private _disabled;
@@ -1359,10 +1374,11 @@ interface SceneBounds {
  */
 declare function getSceneBounds(): Promise<SceneBounds | null>;
 /**
- * Check if player is within scene boundaries
- * Returns true if in bounds, false if out of bounds or can't determine
+ * Check if player is within any of the scene's parcel boundaries.
+ * Checks each parcel individually so irregular/L-shaped estates work correctly.
+ * Returns true if in bounds, false if out of bounds or can't determine.
  */
-declare function isPlayerInBounds(bounds: SceneBounds): boolean;
+declare function isPlayerInBounds(_bounds: SceneBounds): boolean;
 /**
  * Get player's current position
  */

package/dist/index.d.ts

@@ -87,6 +87,7 @@ interface StaticTVConfig {
     debug?: boolean;
     /** Custom API base URL (default: https://thestatic.tv/api/v1/dcl) */
     baseUrl?: string;
+    apiUrl?: string;
     /**
      * Player data from DCL - pass from your scene's getPlayer() call
      * @example
@@ -98,6 +99,18 @@ interface StaticTVConfig {
      * })
      */
     player?: PlayerData;
+    /**
+     * Custom boundary check function — overrides the SDK's auto-detected parcel bounds.
+     * Use this for L-shaped or irregular estates where the bounding box is too large.
+     * Return true if the player is physically inside your scene, false if nearby but outside.
+     * @example
+     * customBoundsCheck: () => {
+     *   const pos = getPlayerPosition()
+     *   if (!pos) return false
+     *   return (pos.x >= 0 && pos.x <= 16 && pos.z >= 0 && pos.z <= 64)
+     * }
+     */
+    customBoundsCheck?: () => boolean;
     /**
      * Guide UI configuration
      */
@@ -469,7 +482,8 @@ declare class SessionModule {
      */
     get bounds(): SceneBounds$1 | null;
     /**
-     * Check if player is currently within scene bounds
+     * Check if player is currently within scene bounds.
+     * Uses customBoundsCheck from config if provided, otherwise falls back to auto-detected parcel bounds.
      */
     isPlayerInScene(): boolean;
     /**
@@ -916,6 +930,7 @@ declare const KEY_TYPE_SCENE = "scene";
 declare class StaticTVClient {
     private config;
     private baseUrl;
+    readonly apiUrl: string;
     private _keyType;
     private _keyId;
     private _disabled;
@@ -1359,10 +1374,11 @@ interface SceneBounds {
  */
 declare function getSceneBounds(): Promise<SceneBounds | null>;
 /**
- * Check if player is within scene boundaries
- * Returns true if in bounds, false if out of bounds or can't determine
+ * Check if player is within any of the scene's parcel boundaries.
+ * Checks each parcel individually so irregular/L-shaped estates work correctly.
+ * Returns true if in bounds, false if out of bounds or can't determine.
  */
-declare function isPlayerInBounds(bounds: SceneBounds): boolean;
+declare function isPlayerInBounds(_bounds: SceneBounds): boolean;
 /**
  * Get player's current position
  */

package/dist/index.js

@@ -256,6 +256,7 @@ var import_ecs2 = require("@dcl/sdk/ecs");
 var import_Runtime = require("~system/Runtime");
 var PARCEL_SIZE = 16;
 var cachedBounds = null;
+var cachedParcelRects = [];
 var boundsInitialized = false;
 var boundsError = false;
 function parseParcel(parcel) {
@@ -291,6 +292,16 @@ async function getSceneBounds() {
       boundsError = true;
       return null;
     }
+    const base = baseParcel ? parseParcel(baseParcel) : coords[0];
+    if (!base) {
+      boundsError = true;
+      return null;
+    }
+    cachedParcelRects = coords.map((c) => {
+      const minX = (c.x - base.x) * PARCEL_SIZE;
+      const minZ = (c.z - base.z) * PARCEL_SIZE;
+      return { minX, maxX: minX + PARCEL_SIZE, minZ, maxZ: minZ + PARCEL_SIZE };
+    });
     const worldMinX = Math.min(...coords.map((c) => c.x));
     const worldMaxX = Math.max(...coords.map((c) => c.x));
     const worldMinZ = Math.min(...coords.map((c) => c.z));
@@ -313,13 +324,15 @@ async function getSceneBounds() {
     return null;
   }
 }
-function isPlayerInBounds(bounds) {
+function isPlayerInBounds(_bounds) {
   try {
     const transform = import_ecs2.Transform.getOrNull(import_ecs2.engine.PlayerEntity);
     if (!transform) return false;
-    const pos = transform.position;
+    const { x, z } = transform.position;
     const buffer = 0.5;
-    return pos.x >= bounds.minX - buffer && pos.x <= bounds.maxX + buffer && pos.z >= bounds.minZ - buffer && pos.z <= bounds.maxZ + buffer;
+    return cachedParcelRects.some(
+      (r) => x >= r.minX - buffer && x <= r.maxX + buffer && z >= r.minZ - buffer && z <= r.maxZ + buffer
+    );
   } catch {
     return false;
   }
@@ -366,9 +379,12 @@ var SessionModule = class {
     return this._bounds;
   }
   /**
-   * Check if player is currently within scene bounds
+   * Check if player is currently within scene bounds.
+   * Uses customBoundsCheck from config if provided, otherwise falls back to auto-detected parcel bounds.
    */
   isPlayerInScene() {
+    const customCheck = this.client.getConfig().customBoundsCheck;
+    if (customCheck) return customCheck();
     if (!this._bounds) return true;
     return isPlayerInBounds(this._bounds);
   }
@@ -3957,6 +3973,7 @@ var StaticTVClient = class {
       ...config
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    this.apiUrl = config.apiUrl || DEFAULT_BASE_URL;
     if (!config.apiKey) {
       this._disabled = true;
       this._keyType = null;
@@ -4009,7 +4026,7 @@ var StaticTVClient = class {
   }
   /** Get the API base URL (for internal module use) */
   getBaseUrl() {
-    return this.baseUrl;
+    return this.apiUrl;
   }
   /**
    * Get the key type (channel, scene, or null if disabled)
@@ -4076,7 +4093,7 @@ var StaticTVClient = class {
    * @internal
    */
   async request(endpoint, options = {}) {
-    const url = `${this.baseUrl}${endpoint}`;
+    const url = `${this.apiUrl}${endpoint}`;
     return request(url, {
       ...options,
       headers: {
@@ -4326,12 +4343,8 @@ var StaticTVClient = class {
     }
     if (hasCallback) {
       this.config.onVideoPlay(video.src);
-      if (isLiveStream) {
-        this._startCallbackVerification(video);
-      } else {
-        this._streamVerified = true;
-        this._pendingVideoData = null;
-      }
+      this._streamVerified = true;
+      this._pendingVideoData = null;
     }
     if (this.guideUI) {
       this.guideUI.currentVideoId = video.id;

package/dist/index.mjs

@@ -208,6 +208,7 @@ import { engine as engine2, Transform } from "@dcl/sdk/ecs";
 import { getSceneInformation } from "~system/Runtime";
 var PARCEL_SIZE = 16;
 var cachedBounds = null;
+var cachedParcelRects = [];
 var boundsInitialized = false;
 var boundsError = false;
 function parseParcel(parcel) {
@@ -243,6 +244,16 @@ async function getSceneBounds() {
       boundsError = true;
       return null;
     }
+    const base = baseParcel ? parseParcel(baseParcel) : coords[0];
+    if (!base) {
+      boundsError = true;
+      return null;
+    }
+    cachedParcelRects = coords.map((c) => {
+      const minX = (c.x - base.x) * PARCEL_SIZE;
+      const minZ = (c.z - base.z) * PARCEL_SIZE;
+      return { minX, maxX: minX + PARCEL_SIZE, minZ, maxZ: minZ + PARCEL_SIZE };
+    });
     const worldMinX = Math.min(...coords.map((c) => c.x));
     const worldMaxX = Math.max(...coords.map((c) => c.x));
     const worldMinZ = Math.min(...coords.map((c) => c.z));
@@ -265,13 +276,15 @@ async function getSceneBounds() {
     return null;
   }
 }
-function isPlayerInBounds(bounds) {
+function isPlayerInBounds(_bounds) {
   try {
     const transform = Transform.getOrNull(engine2.PlayerEntity);
     if (!transform) return false;
-    const pos = transform.position;
+    const { x, z } = transform.position;
     const buffer = 0.5;
-    return pos.x >= bounds.minX - buffer && pos.x <= bounds.maxX + buffer && pos.z >= bounds.minZ - buffer && pos.z <= bounds.maxZ + buffer;
+    return cachedParcelRects.some(
+      (r) => x >= r.minX - buffer && x <= r.maxX + buffer && z >= r.minZ - buffer && z <= r.maxZ + buffer
+    );
   } catch {
     return false;
   }
@@ -318,9 +331,12 @@ var SessionModule = class {
     return this._bounds;
   }
   /**
-   * Check if player is currently within scene bounds
+   * Check if player is currently within scene bounds.
+   * Uses customBoundsCheck from config if provided, otherwise falls back to auto-detected parcel bounds.
    */
   isPlayerInScene() {
+    const customCheck = this.client.getConfig().customBoundsCheck;
+    if (customCheck) return customCheck();
     if (!this._bounds) return true;
     return isPlayerInBounds(this._bounds);
   }
@@ -3909,6 +3925,7 @@ var StaticTVClient = class {
       ...config
     };
     this.baseUrl = config.baseUrl || DEFAULT_BASE_URL;
+    this.apiUrl = config.apiUrl || DEFAULT_BASE_URL;
     if (!config.apiKey) {
       this._disabled = true;
       this._keyType = null;
@@ -3961,7 +3978,7 @@ var StaticTVClient = class {
   }
   /** Get the API base URL (for internal module use) */
   getBaseUrl() {
-    return this.baseUrl;
+    return this.apiUrl;
   }
   /**
    * Get the key type (channel, scene, or null if disabled)
@@ -4028,7 +4045,7 @@ var StaticTVClient = class {
    * @internal
    */
   async request(endpoint, options = {}) {
-    const url = `${this.baseUrl}${endpoint}`;
+    const url = `${this.apiUrl}${endpoint}`;
     return request(url, {
       ...options,
       headers: {
@@ -4278,12 +4295,8 @@ var StaticTVClient = class {
     }
     if (hasCallback) {
       this.config.onVideoPlay(video.src);
-      if (isLiveStream) {
-        this._startCallbackVerification(video);
-      } else {
-        this._streamVerified = true;
-        this._pendingVideoData = null;
-      }
+      this._streamVerified = true;
+      this._pendingVideoData = null;
     }
     if (this.guideUI) {
       this.guideUI.currentVideoId = video.id;

package/package.json

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