@smoregg/sdk 2.0.0 → 2.2.0

package/dist/esm/testing.js

@@ -1,4 +1,5 @@
 import { validateEventName } from './events.js';
+import { SmoreSDKError } from './errors.js';
 
 function createMockScreen(options = {}) {
   const {
@@ -8,6 +9,7 @@ function createMockScreen(options = {}) {
   } = options;
   let _controllers = [...initialControllers];
   let _isReady = false;
+  let _isConnected = false;
   let _isDestroyed = false;
   const listeners = /* @__PURE__ */ new Map();
   const _onAllReadyCallbacks = /* @__PURE__ */ new Set();
@@ -16,13 +18,15 @@ function createMockScreen(options = {}) {
   const _onControllerDisconnectCallbacks = /* @__PURE__ */ new Set();
   const _onControllerReconnectCallbacks = /* @__PURE__ */ new Set();
   const _onCharacterUpdatedCallbacks = /* @__PURE__ */ new Set();
-  const _onRateLimitedCallbacks = /* @__PURE__ */ new Set();
   const _onErrorCallbacks = /* @__PURE__ */ new Set();
+  const _onConnectionChangeCallbacks = /* @__PURE__ */ new Set();
   let _allReadyFired = false;
   let _readyResolve;
   const _readyPromise = new Promise((resolve) => {
     _readyResolve = resolve;
   });
+  const _customStates = /* @__PURE__ */ new Map();
+  const _stateChangeListeners = /* @__PURE__ */ new Set();
   const broadcasts = [];
   const sends = [];
   const screen = {
@@ -39,6 +43,12 @@ function createMockScreen(options = {}) {
     get isDestroyed() {
       return _isDestroyed;
     },
+    get isConnected() {
+      return _isConnected;
+    },
+    get protocolVersion() {
+      return 1;
+    },
     get ready() {
       return _readyPromise;
     },
@@ -82,87 +92,107 @@ function createMockScreen(options = {}) {
         _onCharacterUpdatedCallbacks.delete(callback);
       };
     },
-    onRateLimited(callback) {
-      _onRateLimitedCallbacks.add(callback);
-      return () => {
-        _onRateLimitedCallbacks.delete(callback);
-      };
-    },
     onError(callback) {
       _onErrorCallbacks.add(callback);
       return () => {
         _onErrorCallbacks.delete(callback);
       };
     },
+    onConnectionChange(callback) {
+      _onConnectionChangeCallbacks.add(callback);
+      return () => {
+        _onConnectionChangeCallbacks.delete(callback);
+      };
+    },
     // === Communication Methods ===
     broadcast(event, data) {
       if (_isDestroyed) {
-        throw new Error("Cannot broadcast: screen is destroyed");
-      }
-      if (!_isReady) {
-        throw new Error("Cannot broadcast: screen is not ready");
-      }
-      validateEventName(event);
-      broadcasts.push({ event, data });
-    },
-    broadcastRaw(event, data) {
-      if (_isDestroyed) {
-        throw new Error("Cannot broadcast: screen is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call broadcast() after destroy()");
       }
       if (!_isReady) {
-        throw new Error("Cannot broadcast: screen is not ready");
+        throw new SmoreSDKError("NOT_READY", "Cannot call broadcast() before screen is ready");
       }
       validateEventName(event);
       broadcasts.push({ event, data });
     },
     sendToController(playerIndex, event, data) {
       if (_isDestroyed) {
-        throw new Error("Cannot send: screen is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call sendToController() after destroy()");
       }
       if (!_isReady) {
-        throw new Error("Cannot send: screen is not ready");
+        throw new SmoreSDKError("NOT_READY", "Cannot call sendToController() before screen is ready");
       }
       validateEventName(event);
       if (!_controllers.some((c) => c.playerIndex === playerIndex)) {
-        throw new Error(`Invalid player index: ${playerIndex}`);
+        throw new SmoreSDKError("INVALID_PLAYER", `No controller found with player index ${playerIndex}`);
       }
       sends.push({ playerIndex, event, data });
     },
-    sendToControllerRaw(playerIndex, event, data) {
-      if (_isDestroyed) {
-        throw new Error("Cannot send: screen is destroyed");
-      }
-      if (!_isReady) {
-        throw new Error("Cannot send: screen is not ready");
-      }
-      validateEventName(event);
-      if (!_controllers.some((c) => c.playerIndex === playerIndex)) {
-        throw new Error(`Invalid player index: ${playerIndex}`);
-      }
-      sends.push({ playerIndex, event, data });
+    // === Custom State Methods ===
+    getControllerState(playerIndex) {
+      return _customStates.get(playerIndex);
+    },
+    getAllControllerStates() {
+      const result = {};
+      _customStates.forEach((state, playerIndex) => {
+        result[playerIndex] = state;
+      });
+      return result;
+    },
+    onCustomStateChange(listener) {
+      _stateChangeListeners.add(listener);
+      return () => {
+        _stateChangeListeners.delete(listener);
+      };
+    },
+    simulateStateChange(playerIndex, state) {
+      const existing = _customStates.get(playerIndex) ?? {};
+      const next = { ...existing, ...state };
+      _customStates.set(playerIndex, next);
+      _stateChangeListeners.forEach((cb) => cb(playerIndex, next));
     },
     // === Game Lifecycle ===
     gameOver(results) {
       if (_isDestroyed) {
-        throw new Error("Cannot call gameOver: screen is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call gameOver() after destroy()");
       }
       if (!_isReady) {
-        throw new Error("Cannot call gameOver: screen is not ready");
+        throw new SmoreSDKError("NOT_READY", "Cannot call gameOver() before screen is ready");
       }
       broadcasts.push({ event: "smore:game-over", data: { results } });
     },
     signalReady() {
       if (_isDestroyed) {
-        throw new Error("Cannot call signalReady: screen is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call signalReady() after destroy()");
       }
       if (!_isReady) {
-        throw new Error("Cannot call signalReady: screen is not ready");
+        throw new SmoreSDKError("NOT_READY", "Cannot call signalReady() before screen is ready");
       }
     },
     // === Event Subscription ===
     on(event, handler) {
-      validateEventName(event);
       const eventStr = event;
+      if (eventStr.startsWith("$")) {
+        switch (eventStr) {
+          case "$controller-join":
+            return screen.onControllerJoin(handler);
+          case "$controller-leave":
+            return screen.onControllerLeave(handler);
+          case "$controller-disconnect":
+            return screen.onControllerDisconnect(handler);
+          case "$controller-reconnect":
+            return screen.onControllerReconnect(handler);
+          case "$character-updated":
+            return screen.onCharacterUpdated(handler);
+          case "$all-ready":
+            return screen.onAllReady(handler);
+          case "$error":
+            return screen.onError(handler);
+          case "$connection-change":
+            return screen.onConnectionChange(handler);
+        }
+      }
+      validateEventName(event);
       if (!listeners.has(eventStr)) {
         listeners.set(eventStr, /* @__PURE__ */ new Set());
       }
@@ -188,6 +218,13 @@ function createMockScreen(options = {}) {
         listeners.get(eventStr)?.delete(handler);
       }
     },
+    removeAllListeners(event) {
+      if (event) {
+        listeners.delete(event);
+      } else {
+        listeners.clear();
+      }
+    },
     // === Utilities ===
     getController(playerIndex) {
       return _controllers.find((c) => c.playerIndex === playerIndex);
@@ -195,9 +232,6 @@ function createMockScreen(options = {}) {
     getControllerCount() {
       return _controllers.filter((c) => c.connected).length;
     },
-    hasAnyConnectedControllers() {
-      return _controllers.some((c) => c.connected);
-    },
     // === Cleanup ===
     /**
      * Note: destroy() clears recorded broadcast/event arrays. Call getBroadcasts() before destroy() if assertions are needed.
@@ -233,7 +267,7 @@ function createMockScreen(options = {}) {
     simulateControllerDisconnect(playerIndex) {
       const controller = _controllers.find((c) => c.playerIndex === playerIndex);
       if (!controller) {
-        throw new Error(`Controller ${playerIndex} not found`);
+        throw new SmoreSDKError("INVALID_PLAYER", `Controller ${playerIndex} not found`);
       }
       _controllers = _controllers.map(
         (c) => c.playerIndex === playerIndex ? { ...c, connected: false } : c
@@ -246,7 +280,7 @@ function createMockScreen(options = {}) {
     simulateControllerReconnect(playerIndex) {
       const controller = _controllers.find((c) => c.playerIndex === playerIndex);
       if (!controller) {
-        throw new Error(`Controller ${playerIndex} not found`);
+        throw new SmoreSDKError("INVALID_PLAYER", `Controller ${playerIndex} not found`);
       }
       const reconnectedController = { ...controller, connected: true };
       _controllers = _controllers.map(
@@ -257,16 +291,13 @@ function createMockScreen(options = {}) {
     simulateCharacterUpdate(playerIndex, appearance) {
       const controller = _controllers.find((c) => c.playerIndex === playerIndex);
       if (!controller) {
-        throw new Error(`Controller ${playerIndex} not found`);
+        throw new SmoreSDKError("INVALID_PLAYER", `Controller ${playerIndex} not found`);
       }
       _controllers = _controllers.map(
         (c) => c.playerIndex === playerIndex ? { ...c, appearance } : c
       );
       _onCharacterUpdatedCallbacks.forEach((cb) => cb(playerIndex, appearance));
     },
-    simulateRateLimited(event) {
-      _onRateLimitedCallbacks.forEach((cb) => cb(event));
-    },
     simulateAllReady() {
       _allReadyFired = true;
       _onAllReadyCallbacks.forEach((cb) => cb());
@@ -274,6 +305,10 @@ function createMockScreen(options = {}) {
     simulateError(error) {
       _onErrorCallbacks.forEach((cb) => cb(error));
     },
+    simulateConnectionChange(connected) {
+      _isConnected = connected;
+      _onConnectionChangeCallbacks.forEach((cb) => cb(connected));
+    },
     getBroadcasts() {
       return [...broadcasts];
     },
@@ -286,6 +321,7 @@ function createMockScreen(options = {}) {
     },
     triggerReady() {
       _isReady = true;
+      _isConnected = true;
       _readyResolve();
     }
   };
@@ -297,10 +333,11 @@ function createMockScreen(options = {}) {
 function createMockController(options = {}) {
   const {
     roomCode = "TEST",
-    myIndex = 0,
+    myPlayerIndex = 0,
     autoReady = true
   } = options;
   let _isReady = false;
+  let _isConnected = false;
   let _isDestroyed = false;
   let _controllers = options.controllers ?? [];
   const listeners = /* @__PURE__ */ new Map();
@@ -310,18 +347,21 @@ function createMockController(options = {}) {
   const _onControllerDisconnectCallbacks = /* @__PURE__ */ new Set();
   const _onControllerReconnectCallbacks = /* @__PURE__ */ new Set();
   const _onCharacterUpdatedCallbacks = /* @__PURE__ */ new Set();
-  const _onRateLimitedCallbacks = /* @__PURE__ */ new Set();
   const _onErrorCallbacks = /* @__PURE__ */ new Set();
+  const _onGameOverCallbacks = /* @__PURE__ */ new Set();
+  const _onConnectionChangeCallbacks = /* @__PURE__ */ new Set();
   let _allReadyFired = false;
   let _readyResolve;
   const _readyPromise = new Promise((resolve) => {
     _readyResolve = resolve;
   });
+  const _customStates = /* @__PURE__ */ new Map();
+  const _stateChangeListeners = /* @__PURE__ */ new Set();
   const sentEvents = [];
   const controller = {
     // === Properties ===
-    get myIndex() {
-      return myIndex;
+    get myPlayerIndex() {
+      return myPlayerIndex;
     },
     get roomCode() {
       return roomCode;
@@ -332,6 +372,12 @@ function createMockController(options = {}) {
     get isDestroyed() {
       return _isDestroyed;
     },
+    get isConnected() {
+      return _isConnected;
+    },
+    get protocolVersion() {
+      return 1;
+    },
     get controllers() {
       return [..._controllers];
     },
@@ -378,48 +424,92 @@ function createMockController(options = {}) {
         _onCharacterUpdatedCallbacks.delete(callback);
       };
     },
-    onRateLimited(callback) {
-      _onRateLimitedCallbacks.add(callback);
-      return () => {
-        _onRateLimitedCallbacks.delete(callback);
-      };
-    },
     onError(callback) {
       _onErrorCallbacks.add(callback);
       return () => {
         _onErrorCallbacks.delete(callback);
       };
     },
+    onConnectionChange(callback) {
+      _onConnectionChangeCallbacks.add(callback);
+      return () => {
+        _onConnectionChangeCallbacks.delete(callback);
+      };
+    },
+    onGameOver(callback) {
+      _onGameOverCallbacks.add(callback);
+      return () => {
+        _onGameOverCallbacks.delete(callback);
+      };
+    },
     getControllerCount() {
       return _controllers.filter((c) => c.connected).length;
     },
+    getController(playerIndex) {
+      return _controllers.find((c) => c.playerIndex === playerIndex);
+    },
+    get me() {
+      return _controllers.find((c) => c.playerIndex === myPlayerIndex);
+    },
+    setState(state) {
+      const existing = _customStates.get(myPlayerIndex) ?? {};
+      const next = { ...existing, ...state };
+      _customStates.set(myPlayerIndex, next);
+      _stateChangeListeners.forEach((cb) => cb(myPlayerIndex, next));
+    },
+    getMyState() {
+      return _customStates.get(myPlayerIndex);
+    },
+    onCustomStateChange(listener) {
+      _stateChangeListeners.add(listener);
+      return () => {
+        _stateChangeListeners.delete(listener);
+      };
+    },
     // === Communication Methods ===
     send(event, data) {
       if (_isDestroyed) {
-        throw new Error("Cannot send: controller is destroyed");
-      }
-      validateEventName(event);
-      sentEvents.push({ event, data });
-    },
-    sendRaw(event, data) {
-      if (_isDestroyed) {
-        throw new Error("Cannot send: controller is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call send() after destroy()");
       }
       validateEventName(event);
       sentEvents.push({ event, data });
     },
     signalReady() {
       if (_isDestroyed) {
-        throw new Error("Cannot call signalReady: controller is destroyed");
+        throw new SmoreSDKError("DESTROYED", "Cannot call signalReady() after destroy()");
       }
       if (!_isReady) {
-        throw new Error("Cannot call signalReady: controller is not ready");
+        throw new SmoreSDKError("NOT_READY", "Cannot call signalReady() before controller is ready");
       }
     },
     // === Event Subscription ===
     on(event, handler) {
-      validateEventName(event);
       const eventStr = event;
+      if (eventStr.startsWith("$")) {
+        switch (eventStr) {
+          case "$controller-join":
+            return controller.onControllerJoin(handler);
+          case "$controller-leave":
+            return controller.onControllerLeave(handler);
+          case "$controller-disconnect":
+            return controller.onControllerDisconnect(handler);
+          case "$controller-reconnect":
+            return controller.onControllerReconnect(handler);
+          case "$character-updated":
+            return controller.onCharacterUpdated(handler);
+          case "$all-ready":
+            return controller.onAllReady(handler);
+          case "$error":
+            return controller.onError(handler);
+          case "$game-over":
+            return controller.onGameOver(handler);
+          case "$state-recovery":
+            return controller.onCustomStateChange(handler);
+          case "$connection-change":
+            return controller.onConnectionChange(handler);
+        }
+      }
+      validateEventName(event);
       if (!listeners.has(eventStr)) {
         listeners.set(eventStr, /* @__PURE__ */ new Set());
       }
@@ -445,6 +535,13 @@ function createMockController(options = {}) {
         listeners.get(eventStr)?.delete(handler);
       }
     },
+    removeAllListeners(event) {
+      if (event) {
+        listeners.delete(event);
+      } else {
+        listeners.clear();
+      }
+    },
     // === Cleanup ===
     destroy() {
       _isDestroyed = true;
@@ -470,6 +567,7 @@ function createMockController(options = {}) {
     },
     triggerReady() {
       _isReady = true;
+      _isConnected = true;
       _readyResolve();
     },
     /**
@@ -510,22 +608,32 @@ function createMockController(options = {}) {
     simulateCharacterUpdate(playerIndex, appearance) {
       const ctrl = _controllers.find((c) => c.playerIndex === playerIndex);
       if (!ctrl) {
-        throw new Error(`Controller ${playerIndex} not found`);
+        throw new SmoreSDKError("INVALID_PLAYER", `Controller ${playerIndex} not found`);
       }
       _controllers = _controllers.map(
         (c) => c.playerIndex === playerIndex ? { ...c, appearance } : c
       );
       _onCharacterUpdatedCallbacks.forEach((cb) => cb(playerIndex, appearance));
     },
-    simulateRateLimited(event) {
-      _onRateLimitedCallbacks.forEach((cb) => cb(event));
-    },
     simulateAllReady() {
       _allReadyFired = true;
       _onAllReadyCallbacks.forEach((cb) => cb());
     },
     simulateError(error) {
       _onErrorCallbacks.forEach((cb) => cb(error));
+    },
+    simulateGameOver(results) {
+      _onGameOverCallbacks.forEach((cb) => cb(results));
+    },
+    simulateConnectionChange(connected) {
+      _isConnected = connected;
+      _onConnectionChangeCallbacks.forEach((cb) => cb(connected));
+    },
+    simulateStateChange(playerIndex, state) {
+      const existing = _customStates.get(playerIndex) ?? {};
+      const next = { ...existing, ...state };
+      _customStates.set(playerIndex, next);
+      _stateChangeListeners.forEach((cb) => cb(playerIndex, next));
     }
   };
   if (autoReady) {