@wvdsh/sdk-js 1.3.13 → 1.3.15

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { WavedashSDK } from './index.js';
-export { BackendConnectionPayload, EngineInstance, Friend, FullscreenChangedPayload, Leaderboard, LeaderboardDisplayType, LeaderboardEntries, LeaderboardSortOrder, ListUGCItemsArgs, Lobby, LobbyDataUpdatedPayload, LobbyInvite, LobbyInvitePayload, LobbyJoinResponse, LobbyJoinedPayload, LobbyKickedPayload, LobbyKickedReason, LobbyMessage, LobbyMessagePayload, LobbyUser, LobbyUserChangeType, LobbyUsersUpdatedPayload, LobbyVisibility, P2PConfig, P2PConnection, P2PConnectionEstablishedPayload, P2PConnectionFailedPayload, P2PMessage, P2PPacketDropReason, P2PPacketDroppedPayload, P2PPeer, P2PPeerDisconnectedPayload, P2PPeerReconnectedPayload, P2PPeerReconnectingPayload, PaginatedUGCItems, RemoteFileMetadata, StatsStoredPayload, UGCItem, UGCType, UGCVisibility, UpdateUGCItemArgs, UpsertedLeaderboardEntry, WavedashConfig, WavedashEvent, WavedashEventMap, WavedashResponse } from './index.js';
+export { BackendConnectionPayload, EngineInstance, Friend, FullscreenChangedPayload, Leaderboard, LeaderboardDisplayType, LeaderboardEntries, LeaderboardSortOrder, ListUGCItemsArgs, Lobby, LobbyDataUpdatedPayload, LobbyInvite, LobbyInvitePayload, LobbyJoinResponse, LobbyJoinedPayload, LobbyKickedPayload, LobbyKickedReason, LobbyMessage, LobbyMessagePayload, LobbyUser, LobbyUserChangeType, LobbyUsersUpdatedPayload, LobbyVisibility, MuteChangedPayload, P2PConfig, P2PConnection, P2PConnectionEstablishedPayload, P2PConnectionFailedPayload, P2PMessage, P2PPacketDropReason, P2PPacketDroppedPayload, P2PPeer, P2PPeerDisconnectedPayload, P2PPeerReconnectedPayload, P2PPeerReconnectingPayload, PaginatedUGCItems, RemoteFileMetadata, StatsStoredPayload, UGCItem, UGCType, UGCVisibility, UpdateUGCItemArgs, UpsertedLeaderboardEntry, WavedashConfig, WavedashEvent, WavedashEventMap, WavedashResponse } from './index.js';
 export { GameLaunchParams } from '@wvdsh/api';
 export { GenericId as Id } from 'convex/values';
 import 'convex/browser';

package/dist/index.d.ts

@@ -31,6 +31,7 @@ declare const WavedashEvents: {
     readonly BACKEND_DISCONNECTED: "BackendDisconnected";
     readonly BACKEND_RECONNECTING: "BackendReconnecting";
     readonly FULLSCREEN_CHANGED: "FullscreenChanged";
+    readonly MUTE_CHANGED: "MuteChanged";
 };
 
 /** Reasons why a user was kicked from a lobby */
@@ -214,6 +215,10 @@ interface BackendConnectionPayload {
 interface FullscreenChangedPayload {
     isFullscreen: boolean;
 }
+/** Payload for MuteChanged event - emitted when mute state flips */
+interface MuteChangedPayload {
+    isMuted: boolean;
+}
 type WavedashEventMap = {
     [WavedashEvents.LOBBY_MESSAGE]: LobbyMessagePayload;
     [WavedashEvents.LOBBY_JOINED]: LobbyJoinedPayload;
@@ -232,6 +237,7 @@ type WavedashEventMap = {
     [WavedashEvents.BACKEND_DISCONNECTED]: BackendConnectionPayload;
     [WavedashEvents.BACKEND_RECONNECTING]: BackendConnectionPayload;
     [WavedashEvents.FULLSCREEN_CHANGED]: FullscreenChangedPayload;
+    [WavedashEvents.MUTE_CHANGED]: MuteChangedPayload;
 };
 interface P2PPeer {
     userId: GenericId<"users">;
@@ -619,36 +625,53 @@ declare class HeartbeatManager extends WavedashManager {
     private deviceFingerprintReady;
     private testConnectionInterval;
     private heartbeatInterval;
+    private gamepadPollInterval;
+    private inactivityTimeout;
     private isConnected;
     private sentDisconnectedEvent;
     private disconnectedAt;
     private lastHeartbeatTime;
+    private lastInputResetAt;
     private heartbeatInFlight;
     private isFirstTick;
     private readonly TEST_CONNECTION_INTERVAL_MS;
     private readonly DISCONNECTED_TIMEOUT_MS;
+    private readonly INACTIVITY_TIMEOUT_MS;
+    private readonly INPUT_THROTTLE_MS;
+    private readonly GAMEPAD_POLL_INTERVAL_MS;
+    private readonly GAMEPAD_AXIS_DEADZONE;
     private cachedPresenceData;
     constructor(sdk: WavedashSDK);
-    /** Start heartbeat and connection-check intervals */
+    /**
+     * Start (or refresh) the heartbeat. Idempotent: if intervals are already
+     * running this just reschedules the inactivity timer. No-op if the game
+     * hasn't loaded yet or the tab is hidden.
+     */
     start(): void;
-    /** Stop heartbeat and connection-check intervals */
+    /** Stop the heartbeat and clear the inactivity timer. Idempotent. */
     stop(): void;
-    /** Full teardown — stops intervals and removes all listeners */
-    destroy(): void;
-    private handleVisibilityChange;
-    private tickHeartbeat;
-    private sendHeartbeat;
     /**
      * Updates user presence in the backend.
      * @param data - Data to send to the backend
      * @returns true if the presence was updated successfully
      */
     updateUserPresence(data: Record<string, string | number | boolean | null>): Promise<boolean>;
+    isCurrentlyConnected(): boolean;
+    /** Full teardown — stops intervals and removes all listeners */
+    destroy(): void;
+    private tickHeartbeat;
+    private sendHeartbeat;
+    private handleVisibilityChange;
+    private handleUserInput;
+    /**
+     * Polls connected gamepads; any pressed button or out-of-deadzone axis
+     * counts as user activity and (re)starts the heartbeat.
+     */
+    private pollGamepads;
     /**
      * Tests the connection to the backend
      */
     private testConnection;
-    isCurrentlyConnected(): boolean;
 }
 
 declare class GameEventManager extends WavedashManager {
@@ -873,6 +896,7 @@ declare class WavedashSDK extends EventTarget {
         readonly BACKEND_DISCONNECTED: "BackendDisconnected";
         readonly BACKEND_RECONNECTING: "BackendReconnecting";
         readonly FULLSCREEN_CHANGED: "FullscreenChanged";
+        readonly MUTE_CHANGED: "MuteChanged";
     };
     LobbyVisibility: {
         readonly PUBLIC: 0;
@@ -1261,4 +1285,4 @@ declare global {
 
 declare function setupWavedashSDK(): WavedashSDK;
 
-export { type BackendConnectionPayload, type EngineInstance, type Friend, type FullscreenChangedPayload, type Leaderboard, type LeaderboardDisplayType, type LeaderboardEntries, type LeaderboardSortOrder, type ListUGCItemsArgs, type Lobby, type LobbyDataUpdatedPayload, type LobbyInvite, type LobbyInvitePayload, type LobbyJoinResponse, type LobbyJoinedPayload, type LobbyKickedPayload, type LobbyKickedReason, type LobbyMessage, type LobbyMessagePayload, type LobbyUser, type LobbyUserChangeType, type LobbyUsersUpdatedPayload, type LobbyVisibility, type P2PConfig, type P2PConnection, type P2PConnectionEstablishedPayload, type P2PConnectionFailedPayload, type P2PMessage, type P2PPacketDropReason, type P2PPacketDroppedPayload, type P2PPeer, type P2PPeerDisconnectedPayload, type P2PPeerReconnectedPayload, type P2PPeerReconnectingPayload, type PaginatedUGCItems, type RemoteFileMetadata, type StatsStoredPayload, type UGCItem, type UGCType, type UGCVisibility, type UpdateUGCItemArgs, type UpsertedLeaderboardEntry, type WavedashConfig, type WavedashEvent, type WavedashEventMap, type WavedashResponse, WavedashSDK, setupWavedashSDK };
+export { type BackendConnectionPayload, type EngineInstance, type Friend, type FullscreenChangedPayload, type Leaderboard, type LeaderboardDisplayType, type LeaderboardEntries, type LeaderboardSortOrder, type ListUGCItemsArgs, type Lobby, type LobbyDataUpdatedPayload, type LobbyInvite, type LobbyInvitePayload, type LobbyJoinResponse, type LobbyJoinedPayload, type LobbyKickedPayload, type LobbyKickedReason, type LobbyMessage, type LobbyMessagePayload, type LobbyUser, type LobbyUserChangeType, type LobbyUsersUpdatedPayload, type LobbyVisibility, type MuteChangedPayload, type P2PConfig, type P2PConnection, type P2PConnectionEstablishedPayload, type P2PConnectionFailedPayload, type P2PMessage, type P2PPacketDropReason, type P2PPacketDroppedPayload, type P2PPeer, type P2PPeerDisconnectedPayload, type P2PPeerReconnectedPayload, type P2PPeerReconnectingPayload, type PaginatedUGCItems, type RemoteFileMetadata, type StatsStoredPayload, type UGCItem, type UGCType, type UGCVisibility, type UpdateUGCItemArgs, type UpsertedLeaderboardEntry, type WavedashConfig, type WavedashEvent, type WavedashEventMap, type WavedashResponse, WavedashSDK, setupWavedashSDK };

package/dist/index.js

@@ -75,8 +75,11 @@ var WavedashEvents = {
   BACKEND_RECONNECTING: "BackendReconnecting",
   // attempting to reconnect to backend
   // Fullscreen events
-  FULLSCREEN_CHANGED: "FullscreenChanged"
+  FULLSCREEN_CHANGED: "FullscreenChanged",
   // fullscreen state changed
+  // Audio events
+  MUTE_CHANGED: "MuteChanged"
+  // mute state changed
   // TODO: Future events to implement
   // P2P_CONNECTION_REQUESTED: 'P2PConnectionRequested', // for now we always connect all lobby members
 };
@@ -2695,20 +2698,31 @@ import {
   HEARTBEAT,
   IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE2
 } from "@wvdsh/api";
+var INPUT_LISTENER_OPTS = {
+  passive: true,
+  capture: true
+};
 var HeartbeatManager = class extends WavedashManager {
   constructor(sdk) {
     super(sdk);
     this.deviceFingerprint = void 0;
     this.testConnectionInterval = null;
     this.heartbeatInterval = null;
+    this.gamepadPollInterval = null;
+    this.inactivityTimeout = null;
     this.isConnected = false;
     this.sentDisconnectedEvent = false;
     this.disconnectedAt = null;
     this.lastHeartbeatTime = 0;
+    this.lastInputResetAt = 0;
     this.heartbeatInFlight = false;
     this.isFirstTick = true;
     this.TEST_CONNECTION_INTERVAL_MS = 1e3;
     this.DISCONNECTED_TIMEOUT_MS = 9e4;
+    this.INACTIVITY_TIMEOUT_MS = 30 * 60 * 1e3;
+    this.INPUT_THROTTLE_MS = 1e3;
+    this.GAMEPAD_POLL_INTERVAL_MS = 1e3;
+    this.GAMEPAD_AXIS_DEADZONE = 0.2;
     this.cachedPresenceData = {};
     this.handleVisibilityChange = () => {
       if (document.visibilityState === "visible") {
@@ -2717,19 +2731,53 @@ var HeartbeatManager = class extends WavedashManager {
         this.stop();
       }
     };
+    this.handleUserInput = () => {
+      const now = Date.now();
+      if (now - this.lastInputResetAt < this.INPUT_THROTTLE_MS) return;
+      this.lastInputResetAt = now;
+      this.start();
+    };
     this.isConnected = this.sdk.convexClient.client.connectionState().isWebSocketConnected;
     document.addEventListener("visibilitychange", this.handleVisibilityChange);
+    window.addEventListener(
+      "keydown",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.addEventListener(
+      "pointerdown",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.addEventListener(
+      "pointermove",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.addEventListener("wheel", this.handleUserInput, INPUT_LISTENER_OPTS);
+    this.gamepadPollInterval = setInterval(() => {
+      this.pollGamepads();
+    }, this.GAMEPAD_POLL_INTERVAL_MS);
     this.deviceFingerprintReady = this.sdk.iframeMessenger.requestFromParent(IFRAME_MESSAGE_TYPE2.GET_DEVICE_FINGERPRINT).then((fingerprint) => {
       this.deviceFingerprint = fingerprint;
     }).catch(() => {
     });
   }
-  /** Start heartbeat and connection-check intervals */
+  /**
+   * Start (or refresh) the heartbeat. Idempotent: if intervals are already
+   * running this just reschedules the inactivity timer. No-op if the game
+   * hasn't loaded yet or the tab is hidden.
+   */
   start() {
-    if (!this.sdk.gameLoaded) {
-      return;
-    }
-    this.stop();
+    if (!this.sdk.gameLoaded) return;
+    if (document.visibilityState !== "visible") return;
+    if (this.inactivityTimeout !== null) {
+      clearTimeout(this.inactivityTimeout);
+    }
+    this.inactivityTimeout = setTimeout(() => {
+      this.stop();
+    }, this.INACTIVITY_TIMEOUT_MS);
+    if (this.heartbeatInterval !== null) return;
     if (this.isFirstTick) {
       void this.deviceFingerprintReady.then(() => {
         if (!this.sdk.gameLoaded || !this.isFirstTick) return;
@@ -2745,8 +2793,12 @@ var HeartbeatManager = class extends WavedashManager {
       this.testConnection();
     }, this.TEST_CONNECTION_INTERVAL_MS);
   }
-  /** Stop heartbeat and connection-check intervals */
+  /** Stop the heartbeat and clear the inactivity timer. Idempotent. */
   stop() {
+    if (this.inactivityTimeout !== null) {
+      clearTimeout(this.inactivityTimeout);
+      this.inactivityTimeout = null;
+    }
     if (this.heartbeatInterval !== null) {
       clearInterval(this.heartbeatInterval);
       this.heartbeatInterval = null;
@@ -2756,14 +2808,62 @@ var HeartbeatManager = class extends WavedashManager {
       this.testConnectionInterval = null;
     }
   }
+  /**
+   * Updates user presence in the backend.
+   * @param data - Data to send to the backend
+   * @returns true if the presence was updated successfully
+   */
+  async updateUserPresence(data) {
+    try {
+      this.cachedPresenceData = data;
+      await this.sdk.convexClient.mutation(api7.sdk.presence.heartbeat, {
+        data,
+        deviceFingerprint: this.deviceFingerprint
+      });
+      return true;
+    } catch (error) {
+      logger.error(`Error updating presence: ${error}`);
+      return false;
+    }
+  }
+  isCurrentlyConnected() {
+    return this.isConnected;
+  }
   /** Full teardown — stops intervals and removes all listeners */
   destroy() {
     this.stop();
+    if (this.gamepadPollInterval !== null) {
+      clearInterval(this.gamepadPollInterval);
+      this.gamepadPollInterval = null;
+    }
     document.removeEventListener(
       "visibilitychange",
       this.handleVisibilityChange
     );
+    window.removeEventListener(
+      "keydown",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.removeEventListener(
+      "pointerdown",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.removeEventListener(
+      "pointermove",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
+    window.removeEventListener(
+      "wheel",
+      this.handleUserInput,
+      INPUT_LISTENER_OPTS
+    );
   }
+  // =================
+  // Private functions
+  // =================
   tickHeartbeat() {
     const timeSinceLastHeartbeat = Date.now() - this.lastHeartbeatTime;
     const needsReestablish = this.isFirstTick || timeSinceLastHeartbeat >= HEARTBEAT.CLIENT_REESTABLISH_THRESHOLD_MS;
@@ -2793,21 +2893,22 @@ var HeartbeatManager = class extends WavedashManager {
     });
   }
   /**
-   * Updates user presence in the backend.
-   * @param data - Data to send to the backend
-   * @returns true if the presence was updated successfully
+   * Polls connected gamepads; any pressed button or out-of-deadzone axis
+   * counts as user activity and (re)starts the heartbeat.
    */
-  async updateUserPresence(data) {
-    try {
-      this.cachedPresenceData = data;
-      await this.sdk.convexClient.mutation(api7.sdk.presence.heartbeat, {
-        data,
-        deviceFingerprint: this.deviceFingerprint
-      });
-      return true;
-    } catch (error) {
-      logger.error(`Error updating presence: ${error}`);
-      return false;
+  pollGamepads() {
+    if (typeof navigator === "undefined" || !navigator.getGamepads) return;
+    const pads = navigator.getGamepads();
+    for (const pad of pads) {
+      if (!pad) continue;
+      if (pad.buttons.some((b) => b.pressed)) {
+        this.start();
+        return;
+      }
+      if (pad.axes.some((a) => Math.abs(a) > this.GAMEPAD_AXIS_DEADZONE)) {
+        this.start();
+        return;
+      }
     }
   }
   /**
@@ -2854,9 +2955,6 @@ var HeartbeatManager = class extends WavedashManager {
       logger.error("Error testing connection:", error);
     }
   }
-  isCurrentlyConnected() {
-    return this.isConnected;
-  }
 };
 
 // src/services/gameEvents.ts
@@ -3070,7 +3168,6 @@ var AudioManager = class extends WavedashManager {
     this.handleMute = (data) => {
       if (this._isMuted === data.isMuted) return;
       this._isMuted = data.isMuted;
-      logger.debug(`[AudioManager] muted=${this._isMuted}`);
       const target = this._isMuted ? 0 : 1;
       this.contexts.forEach((gain, ctx) => {
         const now = ctx.currentTime;
@@ -3085,6 +3182,10 @@ var AudioManager = class extends WavedashManager {
           setMutedNative.call(el, this._isMuted ? true : intended);
         });
       }
+      this.sdk.gameEventManager.notifyGame(
+        WavedashEvents.MUTE_CHANGED,
+        { isMuted: this._isMuted }
+      );
     };
     this.installShims();
     this.sdk.iframeMessenger.addEventListener(
@@ -3667,11 +3768,11 @@ var WavedashSDK = class extends EventTarget {
       expectAuth: true
     });
     this.gameCloudId = sdkConfig.gameCloudId;
+    this.iframeMessenger = iframeMessenger;
     this.convexClient.setAuth(
       ({ forceRefreshToken }) => this.getAuthToken(forceRefreshToken)
     );
     this.wavedashUser = sdkConfig.wavedashUser;
-    this.iframeMessenger = iframeMessenger;
     this.ugcHost = sdkConfig.ugcHost;
     this.uploadsHost = sdkConfig.uploadsHost;
     this.swMessenger = new SwMessenger();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wvdsh/sdk-js",
-  "version": "1.3.13",
+  "version": "1.3.15",
   "type": "module",
   "description": "Wavedash JavaScript SDK",
   "main": "./dist/client.js",