@wvdsh/sdk-js 1.3.3 → 1.3.5

package/dist/index.d.ts

@@ -245,14 +245,28 @@ interface P2PConfig {
     maxIncomingMessages?: number;
 }
 
+/**
+ * Base class for SDK managers. Provides the shared `sdk` reference and a
+ * default no-op `destroy()` so the SDK can safely iterate every manager
+ * during teardown without each one having to define an empty stub.
+ *
+ * Override `destroy()` in any manager that owns ongoing state — Convex
+ * subscriptions, intervals, peer connections, monkey-patched globals, etc.
+ * — to make sure that state is released when the SDK is torn down.
+ */
+declare abstract class WavedashManager {
+    protected sdk: WavedashSDK;
+    constructor(sdk: WavedashSDK);
+    destroy(): void;
+}
+
 /**
  * Lobby service
  *
  * Implements each of the lobby methods of the Wavedash SDK
  */
 
-declare class LobbyManager {
-    private sdk;
+declare class LobbyManager extends WavedashManager {
     private unsubscribeLobbyMessages;
     private unsubscribeLobbyUsers;
     private unsubscribeLobbyData;
@@ -342,8 +356,7 @@ declare class LobbyManager {
  * TODO: Extend this to game-level assets as well.
  */
 
-declare class FileSystemManager {
-    private sdk;
+declare class FileSystemManager extends WavedashManager {
     private remoteStorageOrigin;
     constructor(sdk: WavedashSDK);
     /**
@@ -399,11 +412,11 @@ declare class FileSystemManager {
  * Implements each of the user generated content methods of the Wavedash SDK
  */
 
-declare class UGCManager {
-    private sdk;
+declare class UGCManager extends WavedashManager {
     constructor(sdk: WavedashSDK);
     createUGCItem(ugcType: UGCType, title?: string, description?: string, visibility?: UGCVisibility, filePath?: string): Promise<GenericId<"userGeneratedContent">>;
     updateUGCItem(ugcId: GenericId<"userGeneratedContent">, title?: string, description?: string, visibility?: UGCVisibility, filePath?: string): Promise<GenericId<"userGeneratedContent">>;
+    deleteUGCItem(ugcId: GenericId<"userGeneratedContent">): Promise<GenericId<"userGeneratedContent">>;
     downloadUGCItem(ugcId: GenericId<"userGeneratedContent">, filePath: string): Promise<GenericId<"userGeneratedContent">>;
 }
 
@@ -413,8 +426,7 @@ declare class UGCManager {
  * Implements each of the leaderboard methods of the Wavedash SDK
  */
 
-declare class LeaderboardManager {
-    private sdk;
+declare class LeaderboardManager extends WavedashManager {
     private leaderboardCache;
     constructor(sdk: WavedashSDK);
     getLeaderboard(name: string): Promise<Leaderboard>;
@@ -433,8 +445,7 @@ declare class LeaderboardManager {
  * Handles WebRTC peer-to-peer connections for lobbies
  */
 
-declare class P2PManager {
-    private sdk;
+declare class P2PManager extends WavedashManager {
     private config;
     private currentConnection;
     private peerConnections;
@@ -479,6 +490,7 @@ declare class P2PManager {
     private textDecoder;
     private initialized;
     constructor(sdk: WavedashSDK);
+    destroy(): void;
     private ensureInitialized;
     init(config?: Partial<P2PConfig>): void;
     initializeP2PForCurrentLobby(lobbyId: GenericId<"lobbies">, members: SDKUser[]): Promise<P2PConnection>;
@@ -548,8 +560,7 @@ type StatEntry = {
     identifier: string;
     value: number;
 };
-declare class StatsManager {
-    private sdk;
+declare class StatsManager extends WavedashManager {
     private stats;
     private unlockedAchievements;
     private dirtyStats;
@@ -558,6 +569,7 @@ declare class StatsManager {
     private knownAchievementIds;
     private loaded;
     private subscriptions;
+    private periodicPersistInterval;
     constructor(sdk: WavedashSDK);
     destroy(): void;
     private isReady;
@@ -585,8 +597,7 @@ declare class StatsManager {
  * Lets the game update userPresence in the backend
  */
 
-declare class HeartbeatManager {
-    private sdk;
+declare class HeartbeatManager extends WavedashManager {
     private deviceFingerprint;
     private deviceFingerprintReady;
     private testConnectionInterval;
@@ -622,8 +633,7 @@ declare class HeartbeatManager {
     isCurrentlyConnected(): boolean;
 }
 
-declare class GameEventManager {
-    private sdk;
+declare class GameEventManager extends WavedashManager {
     private eventQueue;
     constructor(sdk: WavedashSDK);
     notifyGame(event: WavedashEvent, payload: string | number | object): void;
@@ -650,10 +660,9 @@ declare class GameEventManager {
  * calls route through us. The iframe isn't granted the fullscreen feature
  * policy anymore, so without these shims those calls would silently reject.
  */
-declare class FullscreenManager {
+declare class FullscreenManager extends WavedashManager {
     private _isFullscreen;
     private listeners;
-    private sdk;
     constructor(sdk: WavedashSDK);
     isFullscreen(): boolean;
     /**
@@ -680,8 +689,7 @@ declare class FullscreenManager {
  * - `takeFocus()` is also called after load completes so the game starts
  *   with keyboard focus without the player clicking first.
  */
-declare class OverlayManager {
-    private sdk;
+declare class OverlayManager extends WavedashManager {
     constructor(sdk: WavedashSDK);
     toggleOverlay(): void;
     takeFocus(): void;
@@ -694,8 +702,7 @@ declare class OverlayManager {
  * Implements friend-related methods for the Wavedash SDK
  */
 
-declare class FriendsManager {
-    private sdk;
+declare class FriendsManager extends WavedashManager {
     private userCache;
     constructor(sdk: WavedashSDK);
     /**
@@ -780,8 +787,7 @@ declare class WavedashSDK extends EventTarget {
     private _eventsReady;
     get eventsReady(): boolean;
     private launchParams;
-    private sessionEndSent;
-    private convexHttpUrl;
+    private destroyed;
     private gameFinishedLoading;
     Events: {
         readonly LOBBY_MESSAGE: "LobbyMessage";
@@ -869,6 +875,7 @@ declare class WavedashSDK extends EventTarget {
     p2pManager: P2PManager;
     fullscreenManager: FullscreenManager;
     overlayManager: OverlayManager;
+    private managers;
     private gameplayJwt;
     private gameplayJwtPromise;
     private setupWarningTimeout;
@@ -984,6 +991,11 @@ declare class WavedashSDK extends EventTarget {
      * @returns ugcId
      */
     updateUGCItem(ugcId: GenericId<"userGeneratedContent">, title?: string, description?: string, visibility?: UGCVisibility, filePath?: string): Promise<WavedashResponse<GenericId<"userGeneratedContent">>>;
+    /**
+     * Delete a UGC item: removes the row, the R2 object, and frees up the
+     * user's storage quota by the size of the deleted upload.
+     */
+    deleteUGCItem(ugcId: GenericId<"userGeneratedContent">): Promise<WavedashResponse<GenericId<"userGeneratedContent">>>;
     downloadUGCItem(ugcId: GenericId<"userGeneratedContent">, filePath: string): Promise<WavedashResponse<GenericId<"userGeneratedContent">>>;
     /**
      * Deletes a remote file from storage
@@ -1154,12 +1166,9 @@ declare class WavedashSDK extends EventTarget {
      */
     ensureGameplayJwt(): Promise<string>;
     /**
-     * Set up listeners that flush the end-of-session request when the iframe
-     * is going away. We listen for three signals:
-     *   - `beforeunload` / `pagehide` on our own window: covers tab close, hard
-     *     reload, and top-level navigation of the parent.
-     *   - `END_SESSION` postMessage from the parent: covers parent SPA navigation
+     * Tear down every manager. Called on the parent's `END_SESSION` signal
      */
+    private destroy;
     private setupSessionEndListeners;
 }
 declare global {

package/dist/index.js

@@ -83,8 +83,20 @@ var WavedashEvents = {
 
 // src/services/lobby.ts
 import { api, IFRAME_MESSAGE_TYPE } from "@wvdsh/api";
-var LobbyManager = class {
+
+// src/services/manager.ts
+var WavedashManager = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  destroy() {
+  }
+};
+
+// src/services/lobby.ts
+var LobbyManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     // Track current lobby state
     this.unsubscribeLobbyMessages = null;
     this.unsubscribeLobbyUsers = null;
@@ -182,7 +194,6 @@ var LobbyManager = class {
         invites.map((invite) => invite.notificationId)
       );
     };
-    this.sdk = sdk;
     this.unsubscribeLobbyInvites = this.sdk.convexClient.onUpdate(
       api.sdk.gameLobby.getLobbyInvites,
       {},
@@ -611,9 +622,9 @@ function toBlobFromIndexedDBValue(value) {
 import { api as api2 } from "@wvdsh/api";
 var REMOTE_STORAGE_FOLDER = "userfs";
 var WAVEDASH_PERSISTENT_DATA_PATH = "/idbfs/wavedash";
-var FileSystemManager = class {
+var FileSystemManager = class extends WavedashManager {
   constructor(sdk) {
-    this.sdk = sdk;
+    super(sdk);
   }
   /**
    * Converts a local filesystem path into a full R2 object key.
@@ -663,9 +674,19 @@ var FileSystemManager = class {
    * @returns The path of the remote file that was deleted
    */
   async deleteRemoteFile(filePath) {
-    await this.sdk.convexClient.action(api2.sdk.remoteFileStorage.deleteFile, {
-      path: this.toRemoteKey(filePath)
+    const url = this.getRemoteStorageUrl(filePath);
+    const jwt = await this.sdk.ensureGameplayJwt();
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers: {
+        Authorization: `Bearer ${jwt}`
+      }
     });
+    if (!response.ok) {
+      const msg = `Failed to delete remote file ${filePath}: ${response.status} (${response.statusText})`;
+      this.sdk.logger.error(msg);
+      throw new Error(msg);
+    }
     return filePath;
   }
   /**
@@ -907,9 +928,9 @@ var FileSystemManager = class {
 
 // src/services/ugc.ts
 import { api as api3 } from "@wvdsh/api";
-var UGCManager = class {
+var UGCManager = class extends WavedashManager {
   constructor(sdk) {
-    this.sdk = sdk;
+    super(sdk);
   }
   async createUGCItem(ugcType, title, description, visibility, filePath) {
     const { ugcId, uploadUrl } = await this.sdk.convexClient.mutation(
@@ -931,10 +952,6 @@ var UGCManager = class {
         uploadUrl,
         filePath
       );
-      await this.sdk.convexClient.mutation(
-        api3.sdk.userGeneratedContent.finishUGCUpload,
-        { success, ugcId }
-      );
       if (!success) {
         throw new Error(`Failed to upload UGC item: ${filePath}`);
       }
@@ -961,16 +978,19 @@ var UGCManager = class {
         uploadUrl,
         filePath
       );
-      await this.sdk.convexClient.mutation(
-        api3.sdk.userGeneratedContent.finishUGCUpload,
-        { success, ugcId }
-      );
       if (!success) {
         throw new Error(`Failed to upload UGC item: ${filePath}`);
       }
     }
     return ugcId;
   }
+  async deleteUGCItem(ugcId) {
+    await this.sdk.convexClient.mutation(
+      api3.sdk.userGeneratedContent.deleteUGCItem,
+      { ugcId }
+    );
+    return ugcId;
+  }
   async downloadUGCItem(ugcId, filePath) {
     const downloadUrl = await this.sdk.convexClient.query(
       api3.sdk.userGeneratedContent.getUGCItemDownloadUrl,
@@ -989,11 +1009,11 @@ var UGCManager = class {
 
 // src/services/leaderboards.ts
 import { api as api4 } from "@wvdsh/api";
-var LeaderboardManager = class {
+var LeaderboardManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     // Cache leaderboards to return totalEntries synchronously without a network call
     this.leaderboardCache = /* @__PURE__ */ new Map();
-    this.sdk = sdk;
   }
   async getLeaderboard(name) {
     const leaderboard = await this.sdk.convexClient.query(
@@ -1086,8 +1106,9 @@ var DEFAULT_P2P_CONFIG = {
   messageSize: 2048,
   maxIncomingMessages: 1024
 };
-var _P2PManager = class _P2PManager {
+var _P2PManager = class _P2PManager extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this.currentConnection = null;
     // WebRTC connection state
     this.peerConnections = /* @__PURE__ */ new Map();
@@ -1171,9 +1192,11 @@ var _P2PManager = class _P2PManager {
     this.textEncoder = new TextEncoder();
     this.textDecoder = new TextDecoder();
     this.initialized = false;
-    this.sdk = sdk;
     this.config = { ...DEFAULT_P2P_CONFIG };
   }
+  destroy() {
+    this.disconnectP2P();
+  }
   ensureInitialized() {
     if (!this.initialized) {
       this.init();
@@ -2403,8 +2426,10 @@ var P2PManager = _P2PManager;
 import { api as api6 } from "@wvdsh/api";
 import debounce2 from "lodash.debounce";
 var STORE_DEBOUNCE_MS = 1e3;
-var StatsManager = class {
+var PERIODIC_PERSIST_MS = 1e4;
+var StatsManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     // Current user values
     this.stats = /* @__PURE__ */ new Map();
     this.unlockedAchievements = /* @__PURE__ */ new Set();
@@ -2419,6 +2444,8 @@ var StatsManager = class {
     this.loaded = { stats: false, achievements: false };
     // Subscription cleanup
     this.subscriptions = [];
+    // Background flush timer — see PERIODIC_PERSIST_MS
+    this.periodicPersistInterval = null;
     // ================
     // Store / Persist
     // ================
@@ -2429,14 +2456,20 @@ var StatsManager = class {
       leading: true,
       trailing: true
     });
-    this.sdk = sdk;
     this.subscribe();
     this.requestStats().catch((error) => {
       this.sdk.logger.error("Initial stats fetch failed:", error);
     });
+    this.periodicPersistInterval = setInterval(() => {
+      void this.persist();
+    }, PERIODIC_PERSIST_MS);
   }
   destroy() {
     this.debouncedPersist.cancel();
+    if (this.periodicPersistInterval !== null) {
+      clearInterval(this.periodicPersistInterval);
+      this.periodicPersistInterval = null;
+    }
     for (const unsub of this.subscriptions) unsub();
     this.subscriptions = [];
   }
@@ -2590,8 +2623,9 @@ import {
   HEARTBEAT,
   IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE2
 } from "@wvdsh/api";
-var HeartbeatManager = class {
+var HeartbeatManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this.deviceFingerprint = void 0;
     this.testConnectionInterval = null;
     this.heartbeatInterval = null;
@@ -2610,7 +2644,6 @@ var HeartbeatManager = class {
         this.stop();
       }
     };
-    this.sdk = sdk;
     this.isConnected = this.sdk.convexClient.client.connectionState().isWebSocketConnected;
     document.addEventListener("visibilitychange", this.handleVisibilityChange);
     this.deviceFingerprintReady = this.sdk.iframeMessenger.requestFromParent(IFRAME_MESSAGE_TYPE2.GET_DEVICE_FINGERPRINT).then((fingerprint) => {
@@ -2754,10 +2787,10 @@ var HeartbeatManager = class {
 };
 
 // src/services/gameEvents.ts
-var GameEventManager = class {
+var GameEventManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this.eventQueue = [];
-    this.sdk = sdk;
   }
   // ==============================
   // JS -> Game Event Broadcasting
@@ -2797,11 +2830,11 @@ var GameEventManager = class {
 
 // src/services/fullscreen.ts
 import { IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE3 } from "@wvdsh/api";
-var FullscreenManager = class {
+var FullscreenManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this._isFullscreen = false;
     this.listeners = /* @__PURE__ */ new Set();
-    this.sdk = sdk;
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE3.FULLSCREEN_CHANGED,
       (data) => {
@@ -2886,15 +2919,15 @@ var FullscreenManager = class {
 
 // src/services/overlay.ts
 import { IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE4 } from "@wvdsh/api";
-var OverlayManager = class {
+var OverlayManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this.handleKeyDown = (event) => {
       if (event.key === "Tab" && event.shiftKey) {
         event.preventDefault();
         this.toggleOverlay();
       }
     };
-    this.sdk = sdk;
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE4.TAKE_FOCUS,
       () => this.takeFocus()
@@ -2938,10 +2971,10 @@ function getCdnImageUrl(r2Key, host, options) {
 }
 
 // src/services/friends.ts
-var FriendsManager = class {
+var FriendsManager = class extends WavedashManager {
   constructor(sdk) {
+    super(sdk);
     this.userCache = /* @__PURE__ */ new Map();
-    this.sdk = sdk;
   }
   /**
    * Cache users from any source (friends, lobby users)
@@ -3240,7 +3273,7 @@ var WavedashSDK = class extends EventTarget {
     super();
     this._initialized = false;
     this._eventsReady = false;
-    this.sessionEndSent = false;
+    this.destroyed = false;
     this.gameFinishedLoading = false;
     // Expose constants for easy access `Wavedash.LobbyVisibility.PUBLIC` etc.
     this.Events = WavedashEvents;
@@ -3272,7 +3305,6 @@ var WavedashSDK = class extends EventTarget {
     this.convexClient.setAuth(
       ({ forceRefreshToken }) => this.getAuthToken(forceRefreshToken)
     );
-    this.convexHttpUrl = sdkConfig.convexHttpUrl;
     this.wavedashUser = sdkConfig.wavedashUser;
     this.iframeMessenger = iframeMessenger;
     this.ugcHost = sdkConfig.ugcHost;
@@ -3289,6 +3321,19 @@ var WavedashSDK = class extends EventTarget {
     this.gameEventManager = new GameEventManager(this);
     this.fullscreenManager = new FullscreenManager(this);
     this.overlayManager = new OverlayManager(this);
+    this.managers = [
+      this.p2pManager,
+      this.lobbyManager,
+      this.statsManager,
+      this.heartbeatManager,
+      this.fileSystemManager,
+      this.ugcManager,
+      this.leaderboardManager,
+      this.friendsManager,
+      this.gameEventManager,
+      this.fullscreenManager,
+      this.overlayManager
+    ];
     this.friendsManager.cacheUsers([
       {
         userId: this.wavedashUser.id,
@@ -3683,6 +3728,18 @@ var WavedashSDK = class extends EventTarget {
       filePath
     );
   }
+  /**
+   * Delete a UGC item: removes the row, the R2 object, and frees up the
+   * user's storage quota by the size of the deleted upload.
+   */
+  async deleteUGCItem(ugcId) {
+    return this.apiCall(
+      this.ugcManager,
+      "deleteUGCItem",
+      [["ugcId", vId("userGeneratedContent")]],
+      ugcId
+    );
+  }
   async downloadUGCItem(ugcId, filePath) {
     return this.apiCall(
       this.ugcManager,
@@ -4195,6 +4252,9 @@ var WavedashSDK = class extends EventTarget {
         throw new Error(`Failed to refresh gameplay token: ${response.status}`);
       }
       this.gameplayJwt = await response.text();
+      iframeMessenger.postToParent(IFRAME_MESSAGE_TYPE5.GAMEPLAY_JWT_READY, {
+        gameplayJwt: this.gameplayJwt
+      });
       return this.gameplayJwt;
     })().finally(() => {
       if (this.gameplayJwtPromise === promise) {
@@ -4213,47 +4273,19 @@ var WavedashSDK = class extends EventTarget {
     return this.getAuthToken();
   }
   /**
-   * Set up listeners that flush the end-of-session request when the iframe
-   * is going away. We listen for three signals:
-   *   - `beforeunload` / `pagehide` on our own window: covers tab close, hard
-   *     reload, and top-level navigation of the parent.
-   *   - `END_SESSION` postMessage from the parent: covers parent SPA navigation
+   * Tear down every manager. Called on the parent's `END_SESSION` signal
    */
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    for (const manager of this.managers) {
+      manager.destroy();
+    }
+  }
   setupSessionEndListeners() {
-    const endSessionEndpoint = `${this.convexHttpUrl}/gameplay/end-session`;
-    const endGameplaySession = () => {
-      if (this.sessionEndSent) return;
-      if (!this.gameplayJwt) return;
-      this.sessionEndSent = true;
-      const pendingData = this.statsManager.getPendingData();
-      this.lobbyManager.destroy();
-      this.heartbeatManager.destroy();
-      this.statsManager.destroy();
-      const body = {
-        gameplayJwt: this.gameplayJwt
-      };
-      if (pendingData?.stats?.length) {
-        body.stats = pendingData.stats;
-      }
-      if (pendingData?.achievements?.length) {
-        body.achievements = pendingData.achievements;
-      }
-      const payload = JSON.stringify(body);
-      const beaconSent = navigator?.sendBeacon?.(endSessionEndpoint, payload);
-      if (!beaconSent) {
-        fetch(endSessionEndpoint, {
-          method: "POST",
-          body: payload,
-          keepalive: true
-        }).catch(() => {
-        });
-      }
-    };
-    window.addEventListener("beforeunload", endGameplaySession);
-    window.addEventListener("pagehide", endGameplaySession);
     iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE5.END_SESSION,
-      endGameplaySession
+      () => this.destroy()
     );
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wvdsh/sdk-js",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "description": "Wavedash JavaScript SDK",
   "main": "./dist/client.js",
@@ -49,7 +49,7 @@
     "typescript-eslint": "^8.52.0"
   },
   "dependencies": {
-    "@wvdsh/api": "^0.1.10",
+    "@wvdsh/api": "^0.1.14",
     "convex": "^1.34.0",
     "lodash.debounce": "^4.0.8"
   }