@wvdsh/sdk-js 1.3.14 → 1.3.15

package/dist/index.d.ts

@@ -625,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 {

package/dist/index.js

@@ -2698,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") {
@@ -2720,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;
@@ -2748,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;
@@ -2759,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;
@@ -2796,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;
+      }
     }
   }
   /**
@@ -2857,9 +2955,6 @@ var HeartbeatManager = class extends WavedashManager {
       logger.error("Error testing connection:", error);
     }
   }
-  isCurrentlyConnected() {
-    return this.isConnected;
-  }
 };
 
 // src/services/gameEvents.ts
@@ -3673,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.14",
+  "version": "1.3.15",
   "type": "module",
   "description": "Wavedash JavaScript SDK",
   "main": "./dist/client.js",