@wvdsh/sdk-js 1.3.15 → 1.3.16

package/dist/index.d.ts

@@ -91,6 +91,8 @@ type UpsertedLeaderboardEntry = FunctionReturnType<typeof api.sdk.leaderboards.u
     userId: GenericId<"users">;
     username: string;
     userAvatarUrl?: string;
+    submittedScore: number;
+    submittedRank: number;
 };
 type WavedashEvent = (typeof WavedashEvents)[keyof typeof WavedashEvents];
 interface WavedashConfig {
@@ -767,6 +769,20 @@ declare class AudioManager extends WavedashManager {
     private mutationObserver;
     constructor(sdk: WavedashSDK);
     isMuted(): boolean;
+    /**
+     * Ask the host to mute (true) or unmute (false). Resolves to `true` if the
+     * host applied the change, `false` otherwise — notably, the host rejects an
+     * unmute when the user muted the game from the Wavedash UI, so games can't
+     * override an explicit user mute. The resulting state arrives via the usual
+     * MUTE_CHANGED broadcast, so `isMuted()` updates independently of this result.
+     */
+    requestMute(muted: boolean): Promise<boolean>;
+    /**
+     * Toggle mute. Like `requestMute`, the host may reject the unmute half of a
+     * toggle if the user muted from the Wavedash UI. Resolves to `true` if the
+     * host applied the change.
+     */
+    toggleMute(): Promise<boolean>;
     private handleMute;
     /**
      * Track a media element and (if SDK is currently muted) silence it.
@@ -1021,6 +1037,22 @@ declare class WavedashSDK extends EventTarget {
      * a user gesture handler when entering fullscreen.
      */
     toggleFullscreen(): Promise<boolean>;
+    /**
+     * Whether the game is currently muted. Mirrored from the Wavedash host page,
+     * which owns the mute control so its UI button and the game stay in sync.
+     */
+    isMuted(): boolean;
+    /**
+     * Ask the host to mute (true) or unmute (false). Resolves to `true` if the
+     * change was applied, `false` if it was rejected — the host won't let the
+     * game unmute when the user has muted from the Wavedash UI.
+     */
+    requestMute(muted: boolean): Promise<boolean>;
+    /**
+     * Toggle mute. Resolves to `true` if the change was applied, `false` if it
+     * was rejected (e.g. trying to unmute over an explicit user mute).
+     */
+    toggleMute(): Promise<boolean>;
     getUser(): SDKUser;
     /**
      * Get a username. Returns the logged in user's username if no ID is passed.

package/dist/index.js

@@ -1172,7 +1172,12 @@ var LeaderboardManager = class extends WavedashManager {
       this.updateCachedTotalEntries(leaderboardId, result.totalEntries);
     }
     return {
+      // Where your current leaderboard standing ranks
       ...result.entry,
+      // Where the submission itself ranks
+      submittedScore: result.submission.score,
+      submittedRank: result.submission.globalRank,
+      // User info
       userId: this.sdk.wavedashUser.id,
       username: this.sdk.wavedashUser.username,
       userAvatarUrl: this.sdk.wavedashUser.avatarUrl
@@ -3196,6 +3201,31 @@ var AudioManager = class extends WavedashManager {
   isMuted() {
     return this._isMuted;
   }
+  /**
+   * Ask the host to mute (true) or unmute (false). Resolves to `true` if the
+   * host applied the change, `false` otherwise — notably, the host rejects an
+   * unmute when the user muted the game from the Wavedash UI, so games can't
+   * override an explicit user mute. The resulting state arrives via the usual
+   * MUTE_CHANGED broadcast, so `isMuted()` updates independently of this result.
+   */
+  async requestMute(muted) {
+    const response = await this.sdk.iframeMessenger.requestFromParent(
+      IFRAME_MESSAGE_TYPE5.SET_MUTE,
+      { muted }
+    );
+    return response.success;
+  }
+  /**
+   * Toggle mute. Like `requestMute`, the host may reject the unmute half of a
+   * toggle if the user muted from the Wavedash UI. Resolves to `true` if the
+   * host applied the change.
+   */
+  async toggleMute() {
+    const response = await this.sdk.iframeMessenger.requestFromParent(
+      IFRAME_MESSAGE_TYPE5.TOGGLE_MUTE
+    );
+    return response.success;
+  }
   /**
    * Track a media element and (if SDK is currently muted) silence it.
    * Idempotent — safe to call multiple times for the same element.
@@ -3976,6 +4006,31 @@ var WavedashSDK = class extends EventTarget {
   async toggleFullscreen() {
     return this.fullscreenManager.toggleFullscreen();
   }
+  // =====
+  // Audio
+  // =====
+  /**
+   * Whether the game is currently muted. Mirrored from the Wavedash host page,
+   * which owns the mute control so its UI button and the game stay in sync.
+   */
+  isMuted() {
+    return this.audioManager.isMuted();
+  }
+  /**
+   * Ask the host to mute (true) or unmute (false). Resolves to `true` if the
+   * change was applied, `false` if it was rejected — the host won't let the
+   * game unmute when the user has muted from the Wavedash UI.
+   */
+  async requestMute(muted) {
+    return this.audioManager.requestMute(muted);
+  }
+  /**
+   * Toggle mute. Resolves to `true` if the change was applied, `false` if it
+   * was rejected (e.g. trying to unmute over an explicit user mute).
+   */
+  async toggleMute() {
+    return this.audioManager.toggleMute();
+  }
   // ============
   // User methods
   // ============

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wvdsh/sdk-js",
-  "version": "1.3.15",
+  "version": "1.3.16",
   "type": "module",
   "description": "Wavedash JavaScript SDK",
   "main": "./dist/client.js",
@@ -49,7 +49,7 @@
     "typescript-eslint": "^8.52.0"
   },
   "dependencies": {
-    "@wvdsh/api": "^0.1.28",
+    "@wvdsh/api": "^0.1.32",
     "convex": "^1.39.1",
     "lodash.throttle": "^4.1.1"
   }