@wvdsh/sdk-js 1.3.7 → 1.3.9

package/dist/index.js

@@ -93,6 +93,44 @@ var WavedashManager = class {
   }
 };
 
+// src/utils/logger.ts
+var LOG_LEVEL = {
+  DEBUG: 0,
+  // Most verbose
+  INFO: 1,
+  WARN: 2,
+  ERROR: 3
+};
+var WavedashLogger = class {
+  constructor(logLevel = LOG_LEVEL.WARN) {
+    this.logLevel = logLevel;
+  }
+  setLogLevel(level) {
+    this.logLevel = level;
+  }
+  debug(message, ...args) {
+    if (this.logLevel <= LOG_LEVEL.DEBUG) {
+      console.log(`[WavedashJS] ${message}`, ...args);
+    }
+  }
+  info(message, ...args) {
+    if (this.logLevel <= LOG_LEVEL.INFO) {
+      console.log(`[WavedashJS] ${message}`, ...args);
+    }
+  }
+  warn(message, ...args) {
+    if (this.logLevel <= LOG_LEVEL.WARN) {
+      console.warn(`[WavedashJS] ${message}`, ...args);
+    }
+  }
+  error(message, ...args) {
+    if (this.logLevel <= LOG_LEVEL.ERROR) {
+      console.error(`[WavedashJS] ${message}`, ...args);
+    }
+  }
+};
+var logger = new WavedashLogger();
+
 // src/services/lobby.ts
 var _LobbyManager = class _LobbyManager extends WavedashManager {
   constructor(sdk) {
@@ -153,7 +191,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
       for (const user of previousUsers) {
         if (!newUserIds.has(user.userId)) {
           if (user.userId === this.sdk.getUserId()) {
-            this.sdk.logger.warn(
+            logger.warn(
               "USER WAS KICKED FROM LOBBY! Received notification for myself leaving."
             );
           }
@@ -169,7 +207,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
       }
       if (this.lobbyId) {
         this.p2pUpdateQueue = this.p2pUpdateQueue.then(() => this.updateP2PConnections(newUsers)).catch((error) => {
-          this.sdk.logger.error("Error in queued P2P update:", error);
+          logger.error("Error in queued P2P update:", error);
         });
       }
     };
@@ -204,7 +242,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
       {},
       this.processInviteUpdates,
       (error) => {
-        this.sdk.logger.error(`Lobby invites subscription error: ${error}`);
+        logger.error(`Lobby invites subscription error: ${error}`);
       }
     );
   }
@@ -232,7 +270,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
   }
   getLobbyUsers(lobbyId) {
     if (this.lobbyId !== lobbyId) {
-      this.sdk.logger.error(
+      logger.error(
         "Must be a member of the lobby to access user list"
       );
       return [];
@@ -241,7 +279,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
   }
   getHostId(lobbyId) {
     if (this.lobbyId !== lobbyId) {
-      this.sdk.logger.error(
+      logger.error(
         "Must be a member of the lobby to access the host ID"
       );
       return null;
@@ -317,11 +355,11 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
   sendLobbyMessage(lobbyId, message) {
     const args = { lobbyId, message };
     if (message.length === 0) {
-      this.sdk.logger.error("Message cannot be empty");
+      logger.error("Message cannot be empty");
       return false;
     }
     if (message.length > LOBBY_MESSAGE_MAX_LENGTH) {
-      this.sdk.logger.error(
+      logger.error(
         `Message cannot be longer than ${LOBBY_MESSAGE_MAX_LENGTH} characters`
       );
       return false;
@@ -329,7 +367,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
     try {
       this.sdk.convexClient.mutation(api.sdk.gameLobby.sendMessage, args);
     } catch (error) {
-      this.sdk.logger.error(`Error sending lobby message: ${error}`);
+      logger.error(`Error sending lobby message: ${error}`);
       return false;
     }
     return true;
@@ -372,7 +410,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
     this.lobbyMetadata = response.metadata;
     this.sdk.friendsManager.cacheUsers(response.users);
     const onLobbySubscriptionError = (error) => {
-      this.sdk.logger.error(`Lobby subscription error: ${error.message}`);
+      logger.error(`Lobby subscription error: ${error.message}`);
       if (error.message.includes("not a member")) {
         this.handleLobbyKicked(LobbyKickedReason.KICKED);
       } else {
@@ -406,7 +444,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
     if (response.users.length > 1) {
       this.p2pUpdateQueue = this.updateP2PConnections(response.users).catch(
         (error) => {
-          this.sdk.logger.error("Error initializing P2P on join:", error);
+          logger.error("Error initializing P2P on join:", error);
         }
       );
     }
@@ -419,7 +457,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
       users: response.users,
       metadata: response.metadata
     });
-    this.sdk.logger.debug("Subscribed to lobby:", response.lobbyId);
+    logger.debug("Subscribed to lobby:", response.lobbyId);
   }
   /**
    * Handle being kicked or removed from a lobby (subscription error)
@@ -429,7 +467,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
   handleLobbyKicked(reason = LobbyKickedReason.KICKED) {
     const lobbyId = this.lobbyId;
     if (!lobbyId) return;
-    this.sdk.logger.warn(
+    logger.warn(
       `User was removed from lobby: ${lobbyId} (reason: ${reason})`
     );
     this.cleanupLobbyState();
@@ -516,7 +554,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
       lobbyId: this.lobbyId,
       updates
     }).catch((error) => {
-      this.sdk.logger.error("Error updating lobby metadata:", error);
+      logger.error("Error updating lobby metadata:", error);
     }).finally(() => {
       this.inFlightMetadataUpdate = null;
       if (Object.keys(this.pendingMetadataUpdates).length > 0) {
@@ -538,7 +576,7 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
     try {
       if (newUsers.length <= 1) {
         this.sdk.p2pManager.disconnectP2P();
-        this.sdk.logger.debug(
+        logger.debug(
           "Only one user in lobby, P2P connections disconnected"
         );
         return;
@@ -552,11 +590,11 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
         this.lobbyId,
         wavedashUsers
       );
-      this.sdk.logger.debug(
+      logger.debug(
         `P2P connections updated for lobby ${this.lobbyId} with ${wavedashUsers.length} users`
       );
     } catch (error) {
-      this.sdk.logger.error("Error updating P2P connections:", error);
+      logger.error("Error updating P2P connections:", error);
     }
   }
 };
@@ -701,7 +739,7 @@ var FileSystemManager = class extends WavedashManager {
     });
     if (!response.ok) {
       const msg = `Failed to delete remote file ${filePath}: ${response.status} (${response.statusText})`;
-      this.sdk.logger.error(msg);
+      logger.error(msg);
       throw new Error(msg);
     }
     return filePath;
@@ -760,9 +798,9 @@ var FileSystemManager = class extends WavedashManager {
     return path;
   }
   async writeLocalFile(filePath, data) {
-    this.sdk.logger.debug(`Writing local file: ${filePath}`);
+    logger.debug(`Writing local file: ${filePath}`);
     if (this.sdk.engineInstance?.FS) {
-      this.sdk.logger.error(
+      logger.error(
         `${this.sdk.engineInstance.type} engine detected, use engine's builtin file access to save files.`
       );
       return false;
@@ -771,14 +809,14 @@ var FileSystemManager = class extends WavedashManager {
       await writeToIndexedDB(filePath, data);
       return true;
     } catch (error) {
-      this.sdk.logger.error(`Failed to write local file: ${error}`);
+      logger.error(`Failed to write local file: ${error}`);
       return false;
     }
   }
   async readLocalFile(filePath) {
-    this.sdk.logger.debug(`Reading local file: ${filePath}`);
+    logger.debug(`Reading local file: ${filePath}`);
     if (this.sdk.engineInstance?.FS) {
-      this.sdk.logger.error(
+      logger.error(
         `${this.sdk.engineInstance.type} engine detected, use engine's builtin file access to read files.`
       );
       return null;
@@ -789,7 +827,7 @@ var FileSystemManager = class extends WavedashManager {
       const arrayBuffer = await blob.arrayBuffer();
       return new Uint8Array(arrayBuffer);
     } catch (error) {
-      this.sdk.logger.error(`Failed to read local file: ${error}`);
+      logger.error(`Failed to read local file: ${error}`);
       return null;
     }
   }
@@ -798,9 +836,9 @@ var FileSystemManager = class extends WavedashManager {
   // ================
   // Helper to upload a local file to a presigned URL
   async upload(presignedUploadUrl, filePath) {
-    this.sdk.logger.debug(`Uploading ${filePath} to: ${presignedUploadUrl}`);
+    logger.debug(`Uploading ${filePath} to: ${presignedUploadUrl}`);
     if (this.sdk.engineInstance && !this.sdk.engineInstance.FS) {
-      this.sdk.logger.error("Engine instance is missing the Emscripten FS API");
+      logger.error("Engine instance is missing the Emscripten FS API");
       return false;
     }
     let success = false;
@@ -813,9 +851,9 @@ var FileSystemManager = class extends WavedashManager {
   }
   // Helper to download a file from a URL and save locally
   async download(url, filePath) {
-    this.sdk.logger.debug(`Downloading ${filePath} from: ${url}`);
+    logger.debug(`Downloading ${filePath} from: ${url}`);
     if (this.sdk.engineInstance && !this.sdk.engineInstance.FS) {
-      this.sdk.logger.error("Engine instance is missing the Emscripten FS API");
+      logger.error("Engine instance is missing the Emscripten FS API");
       return false;
     }
     const jwt = await this.sdk.ensureGameplayJwt();
@@ -826,7 +864,7 @@ var FileSystemManager = class extends WavedashManager {
       }
     });
     if (!response.ok) {
-      this.sdk.logger.error(
+      logger.error(
         `Failed to download remote file: ${response.status} (${response.statusText})`
       );
       return false;
@@ -848,10 +886,10 @@ var FileSystemManager = class extends WavedashManager {
         const success = await this.writeLocalFile(filePath, dataArray);
         if (!success) return false;
       }
-      this.sdk.logger.debug(`Successfully saved to: ${filePath}`);
+      logger.debug(`Successfully saved to: ${filePath}`);
       return true;
     } catch (error) {
-      this.sdk.logger.error(
+      logger.error(
         `Failed to save file ${filePath}: ${error instanceof Error ? error.message : String(error)}`
       );
       return false;
@@ -888,7 +926,7 @@ var FileSystemManager = class extends WavedashManager {
     try {
       const blob = await this.readLocalFileBlob(indexedDBKey);
       if (!blob) {
-        this.sdk.logger.error(`File not found in IndexedDB: ${indexedDBKey}`);
+        logger.error(`File not found in IndexedDB: ${indexedDBKey}`);
         return false;
       }
       const response = await fetch(presignedUploadUrl, {
@@ -898,7 +936,7 @@ var FileSystemManager = class extends WavedashManager {
       });
       return response.ok;
     } catch (error) {
-      this.sdk.logger.error(`Error uploading from IndexedDB: ${error}`);
+      logger.error(`Error uploading from IndexedDB: ${error}`);
       return false;
     }
   }
@@ -920,14 +958,14 @@ var FileSystemManager = class extends WavedashManager {
       return response.ok;
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
-      this.sdk.logger.error(`Error uploading from FS: ${msg}`);
+      logger.error(`Error uploading from FS: ${msg}`);
       return false;
     }
   }
   async readLocalFileBlob(filePath) {
-    this.sdk.logger.debug(`Reading local file (blob): ${filePath}`);
+    logger.debug(`Reading local file (blob): ${filePath}`);
     if (this.sdk.engineInstance?.FS) {
-      this.sdk.logger.error(
+      logger.error(
         `${this.sdk.engineInstance.type} engine detected, use engine's builtin file access to read files.`
       );
       return null;
@@ -937,7 +975,7 @@ var FileSystemManager = class extends WavedashManager {
       if (!record) return null;
       return toBlobFromIndexedDBValue(record);
     } catch (error) {
-      this.sdk.logger.error(`Failed to read local file blob: ${error}`);
+      logger.error(`Failed to read local file blob: ${error}`);
       return null;
     }
   }
@@ -1063,7 +1101,8 @@ var LeaderboardManager = class extends WavedashManager {
     const entry = result.entry ? {
       ...result.entry,
       userId: this.sdk.wavedashUser.id,
-      username: this.sdk.wavedashUser.username
+      username: this.sdk.wavedashUser.username,
+      userAvatarUrl: this.sdk.wavedashUser.avatarUrl
     } : null;
     return entry ? [entry] : [];
   }
@@ -1075,6 +1114,7 @@ var LeaderboardManager = class extends WavedashManager {
     if (result && result.totalEntries) {
       this.updateCachedTotalEntries(leaderboardId, result.totalEntries);
     }
+    this.sdk.friendsManager.cacheLeaderboardPage(result.entries);
     return result.entries;
   }
   async listLeaderboardEntries(leaderboardId, offset, limit, friendsOnly = false) {
@@ -1085,6 +1125,7 @@ var LeaderboardManager = class extends WavedashManager {
     if (result && result.totalEntries) {
       this.updateCachedTotalEntries(leaderboardId, result.totalEntries);
     }
+    this.sdk.friendsManager.cacheLeaderboardPage(result.entries);
     return result.entries;
   }
   async uploadLeaderboardScore(leaderboardId, score, keepBest, ugcId) {
@@ -1262,7 +1303,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       return this.updateP2PConnection(members);
     }
     if (this.initializationInProgress && this.initializationLobbyId === lobbyId) {
-      this.sdk.logger.debug(
+      logger.debug(
         "P2P initialization already in progress, waiting..."
       );
       await this.initializationInProgress;
@@ -1330,7 +1371,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     if (!this.currentConnection) {
       throw new Error("No existing P2P connection to update");
     }
-    this.sdk.logger.debug("Updating P2P connection with new member list");
+    logger.debug("Updating P2P connection with new member list");
     const currentPeerUserIds = new Set(
       Object.keys(this.currentConnection.peers)
     );
@@ -1345,7 +1386,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           existingPeer.username = member.username;
         }
       } else {
-        this.sdk.logger.debug(
+        logger.debug(
           `Adding new peer: ${member.username} (${member.id})`
         );
         this.currentConnection.peers[member.id] = {
@@ -1359,7 +1400,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       const currentUserId = this.sdk.getUserId();
       const connectionPromises = connectionsToCreate.map((userId) => {
         const shouldCreateChannels = currentUserId < userId;
-        this.sdk.logger.debug(
+        logger.debug(
           `Creating connection to new peer ${userId}, shouldCreateChannels: ${shouldCreateChannels}`
         );
         return this.createPeerConnection(
@@ -1374,13 +1415,13 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       );
       if (peersToInitiate.length > 0) {
         const offerPromises = peersToInitiate.map((userId) => {
-          this.sdk.logger.debug(
+          logger.debug(
             `Initiating offer to new peer ${userId} (lower userId rule)`
           );
           return this.createOfferToPeer(userId);
         });
         await Promise.all(offerPromises);
-        this.sdk.logger.debug(
+        logger.debug(
           `Initiated ${offerPromises.length} offers to new peers`
         );
       }
@@ -1390,7 +1431,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     )) {
       if (!newPeerUserIds.has(userId)) {
         const peer = this.currentConnection.peers[userId];
-        this.sdk.logger.debug(`Peer left: ${peer.username} (${userId})`);
+        logger.debug(`Peer left: ${peer.username} (${userId})`);
         const pc = this.peerConnections.get(userId);
         if (pc) {
           pc.close();
@@ -1412,7 +1453,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     this.subscribeToSignalingMessages(connection);
     if (this.signalingSubscriptionReady) {
       await this.signalingSubscriptionReady;
-      this.sdk.logger.debug("Signaling subscription confirmed ready");
+      logger.debug("Signaling subscription confirmed ready");
     }
     await this.establishPeerConnections(connection);
   }
@@ -1458,7 +1499,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         await this.handleSignalingMessage(message, connection);
         this.processedSignalingMessages.add(message._id);
       } catch (error) {
-        this.sdk.logger.error("Error handling signaling message:", error);
+        logger.error("Error handling signaling message:", error);
       }
     }
     if (newMessageIds.length > 0) {
@@ -1471,7 +1512,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           this.pendingProcessedMessageIds.delete(messageId);
         }
       } catch (error) {
-        this.sdk.logger.error(
+        logger.error(
           "Failed to mark signaling messages as processed:",
           error
         );
@@ -1488,7 +1529,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     const remoteUserId = message.fromUserId;
     if (!this.peerConnections.has(remoteUserId)) {
       if (message.messageType === P2P_SIGNALING_MESSAGE_TYPE.OFFER) {
-        this.sdk.logger.debug(
+        logger.debug(
           `Received offer from ${remoteUserId} before peer connection exists, creating on-demand`
         );
         if (!connection.peers[remoteUserId]) {
@@ -1505,13 +1546,13 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           // shouldCreateChannels = false, we'll receive them via ondatachannel
         );
         if (!success) {
-          this.sdk.logger.error(
+          logger.error(
             `Failed to create on-demand peer connection for ${remoteUserId}`
           );
           return;
         }
       } else {
-        this.sdk.logger.warn(
+        logger.warn(
           `No peer connection for user ${remoteUserId}, dropping ${message.messageType} message`
         );
         return;
@@ -1521,14 +1562,14 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     switch (message.messageType) {
       case P2P_SIGNALING_MESSAGE_TYPE.OFFER: {
         this.iceRestartInProgress.delete(remoteUserId);
-        this.sdk.logger.debug(`Processing offer from peer ${remoteUserId}:`);
+        logger.debug(`Processing offer from peer ${remoteUserId}:`);
         await pc.setRemoteDescription(
           new RTCSessionDescription(message.data)
         );
         await this.flushPendingIceCandidates(remoteUserId, pc);
         const answer = await pc.createAnswer();
         await pc.setLocalDescription(answer);
-        this.sdk.logger.debug(
+        logger.debug(
           `  Answer created, waiting for ondatachannel events...`
         );
         const answerData = {
@@ -1553,7 +1594,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           const pending = this.pendingIceCandidates.get(remoteUserId) || [];
           pending.push(iceData);
           this.pendingIceCandidates.set(remoteUserId, pending);
-          this.sdk.logger.debug(
+          logger.debug(
             `Buffered ICE candidate for ${remoteUserId} (remote description not yet set, ${pending.length} buffered)`
           );
         } else {
@@ -1562,7 +1603,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         break;
       }
       default:
-        this.sdk.logger.warn(
+        logger.warn(
           "Unknown signaling message type:",
           message.messageType
         );
@@ -1579,7 +1620,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         try {
           await pc.addIceCandidate(new RTCIceCandidate(candidate));
         } catch (error) {
-          this.sdk.logger.warn(
+          logger.warn(
             `Failed to add buffered ICE candidate for ${remoteUserId}:`,
             error
           );
@@ -1589,13 +1630,13 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     }
   }
   async establishPeerConnections(connection) {
-    this.sdk.logger.debug("Establishing WebRTC connections to peers...");
+    logger.debug("Establishing WebRTC connections to peers...");
     const currentUserId = this.sdk.getUserId();
     const connectionPromises = [];
     Object.entries(connection.peers).forEach(
       ([userId, peer]) => {
         const shouldCreateChannels = currentUserId < userId;
-        this.sdk.logger.debug(
+        logger.debug(
           `Creating connection to peer ${userId} (${peer.username}), shouldCreateChannels: ${shouldCreateChannels}`
         );
         connectionPromises.push(
@@ -1607,17 +1648,17 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     const peersToInitiate = Object.keys(connection.peers).filter((userId) => currentUserId < userId);
     if (peersToInitiate.length > 0) {
       const offerPromises = peersToInitiate.map((userId) => {
-        this.sdk.logger.debug(
+        logger.debug(
           `Initiating offer to peer ${userId} (lower userId rule)`
         );
         return this.createOfferToPeer(userId);
       });
       await Promise.all(offerPromises);
-      this.sdk.logger.debug(
+      logger.debug(
         `Created ${connectionPromises.length} peer connections and initiated ${offerPromises.length} offers`
       );
     } else {
-      this.sdk.logger.debug(
+      logger.debug(
         `Created ${connectionPromises.length} peer connections, no offers to initiate`
       );
     }
@@ -1629,11 +1670,11 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     }
     const reliableChannel = this.reliableChannels.get(remoteUserId);
     const unreliableChannel = this.unreliableChannels.get(remoteUserId);
-    this.sdk.logger.debug(`Creating offer to peer ${remoteUserId}:`);
-    this.sdk.logger.debug(
+    logger.debug(`Creating offer to peer ${remoteUserId}:`);
+    logger.debug(
       `  Reliable channel state: ${reliableChannel?.readyState || "none"}`
     );
-    this.sdk.logger.debug(
+    logger.debug(
       `  Unreliable channel state: ${unreliableChannel?.readyState || "none"}`
     );
     const offer = await pc.createOffer();
@@ -1650,7 +1691,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
   async createPeerConnection(remoteUserId, connection, shouldCreateChannels = false) {
     const iceServers = await this.getIceServers();
     if (!iceServers) {
-      this.sdk.logger.error(
+      logger.error(
         `No ICE servers available for peer ${remoteUserId}`
       );
       this.sdk.gameEventManager.notifyGame(
@@ -1674,7 +1715,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       rtcpMuxPolicy: "require"
     });
     if (shouldCreateChannels) {
-      this.sdk.logger.debug(`Creating data channels for peer ${remoteUserId}`);
+      logger.debug(`Creating data channels for peer ${remoteUserId}`);
       if (this.config.enableReliableChannel) {
         const reliableChannel = pc.createDataChannel("reliable", {
           ordered: true,
@@ -1702,17 +1743,17 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         );
       }
     } else {
-      this.sdk.logger.debug(
+      logger.debug(
         `Will receive data channels from peer ${remoteUserId} via ondatachannel`
       );
     }
     pc.onicecandidate = (event) => {
       if (event.candidate) {
         const candidateType = event.candidate.candidate.includes("typ host") ? "host" : event.candidate.candidate.includes("typ srflx") ? "srflx (STUN)" : event.candidate.candidate.includes("typ relay") ? "relay (TURN)" : "unknown";
-        this.sdk.logger.debug(
+        logger.debug(
           `Peer ${remoteUserId} gathered ICE candidate: ${candidateType}`
         );
-        this.sdk.logger.debug(`  Candidate: ${event.candidate.candidate}`);
+        logger.debug(`  Candidate: ${event.candidate.candidate}`);
         const candidateData = {
           candidate: event.candidate.candidate,
           sdpMid: event.candidate.sdpMid,
@@ -1727,7 +1768,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     };
     pc.ondatachannel = (event) => {
       const channel = event.channel;
-      this.sdk.logger.debug(
+      logger.debug(
         `Received ${channel.label} data channel from peer ${remoteUserId}`
       );
       if (channel.label === "reliable") {
@@ -1742,21 +1783,21 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       );
     };
     pc.onconnectionstatechange = () => {
-      this.sdk.logger.debug(
+      logger.debug(
         `Peer ${remoteUserId} connection state: ${pc.connectionState}`
       );
       if (pc.connectionState === "connected") {
-        this.sdk.logger.debug(
+        logger.debug(
           `  Peer ${remoteUserId} fully connected, expecting ondatachannel events now...`
         );
       }
     };
     pc.oniceconnectionstatechange = () => {
-      this.sdk.logger.debug(
+      logger.debug(
         `Peer ${remoteUserId} ICE connection state: ${pc.iceConnectionState}`
       );
       if (pc.iceConnectionState === "connected") {
-        this.sdk.logger.debug(
+        logger.debug(
           `  ICE connected to peer ${remoteUserId}, data channels should be available...`
         );
         this.iceRestartAttempts.delete(remoteUserId);
@@ -1774,7 +1815,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           }
         }
       } else if (pc.iceConnectionState === "failed") {
-        this.sdk.logger.debug(
+        logger.debug(
           `ICE connection to peer ${remoteUserId} failed, will retry in 500ms...`
         );
         if (!this.reconnectingPeers.has(remoteUserId)) {
@@ -1792,20 +1833,20 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         }
         setTimeout(() => {
           if (pc.iceConnectionState === "failed") {
-            this.sdk.logger.warn(
+            logger.warn(
               `ICE connection to peer ${remoteUserId} still failed after delay, attempting ICE restart...`
             );
             this.attemptIceRestart(remoteUserId, pc);
           }
         }, 500);
       } else if (pc.iceConnectionState === "disconnected") {
-        this.sdk.logger.debug(
+        logger.debug(
           `ICE connection to peer ${remoteUserId} disconnected, may recover...`
         );
       }
     };
     pc.onicegatheringstatechange = () => {
-      this.sdk.logger.debug(
+      logger.debug(
         `Peer ${remoteUserId} ICE gathering state: ${pc.iceGatheringState}`
       );
     };
@@ -1819,20 +1860,20 @@ var _P2PManager = class _P2PManager extends WavedashManager {
   async attemptIceRestart(remoteUserId, pc) {
     const currentUserId = this.sdk.getUserId();
     if (currentUserId > remoteUserId) {
-      this.sdk.logger.debug(
+      logger.debug(
         `Waiting for peer ${remoteUserId} to initiate ICE restart (they have lower userId)`
       );
       return;
     }
     if (this.iceRestartInProgress.has(remoteUserId)) {
-      this.sdk.logger.debug(
+      logger.debug(
         `ICE restart already in progress for peer ${remoteUserId}, skipping`
       );
       return;
     }
     const attempts = this.iceRestartAttempts.get(remoteUserId) || 0;
     if (attempts >= this.MAX_ICE_RESTART_ATTEMPTS) {
-      this.sdk.logger.error(
+      logger.error(
         `Max ICE restart attempts (${this.MAX_ICE_RESTART_ATTEMPTS}) reached for peer ${remoteUserId}, giving up`
       );
       this.reconnectingPeers.delete(remoteUserId);
@@ -1853,7 +1894,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     }
     this.iceRestartAttempts.set(remoteUserId, attempts + 1);
     this.iceRestartInProgress.add(remoteUserId);
-    this.sdk.logger.debug(
+    logger.debug(
       `ICE restart attempt ${attempts + 1}/${this.MAX_ICE_RESTART_ATTEMPTS} for peer ${remoteUserId}`
     );
     try {
@@ -1868,9 +1909,9 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         type: P2P_SIGNALING_MESSAGE_TYPE.OFFER,
         data: offerData
       });
-      this.sdk.logger.debug(`ICE restart offer sent to peer ${remoteUserId}`);
+      logger.debug(`ICE restart offer sent to peer ${remoteUserId}`);
     } catch (error) {
-      this.sdk.logger.error(
+      logger.error(
         `Failed to initiate ICE restart for peer ${remoteUserId}:`,
         error
       );
@@ -1878,7 +1919,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
   }
   setupDataChannelHandlers(channel, remoteUserId, type) {
     channel.onopen = () => {
-      this.sdk.logger.debug(
+      logger.debug(
         `${type} data channel opened with peer ${remoteUserId}`
       );
       if (this.isPeerReady(remoteUserId) && !this.establishedPeers.has(remoteUserId)) {
@@ -1899,7 +1940,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       this.enqueueMessage(event.data, remoteUserId);
     };
     channel.onerror = (error) => {
-      this.sdk.logger.error(
+      logger.error(
         `Data channel error with peer ${remoteUserId}:`,
         error
       );
@@ -1916,7 +1957,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       }
     };
     channel.onclose = () => {
-      this.sdk.logger.debug(
+      logger.debug(
         `${type} data channel closed with peer ${remoteUserId}`
       );
       this.establishedPeers.delete(remoteUserId);
@@ -1940,42 +1981,42 @@ var _P2PManager = class _P2PManager extends WavedashManager {
     this.ensureInitialized();
     try {
       if (!this.currentConnection) {
-        this.sdk.logger.error(
+        logger.error(
           `P2P send called before P2P is initialized, dropping message.`
         );
         this.reportPacketDrop(appChannel, "SEND", "PEER_NOT_READY");
         return false;
       }
       if (!payload) {
-        this.sdk.logger.error(
+        logger.error(
           `P2P send called with missing payload, dropping message.`
         );
         this.reportPacketDrop(appChannel, "SEND", "INVALID_PAYLOAD_SIZE");
         return false;
       }
       if (!Number.isInteger(appChannel) || appChannel < 0 || appChannel >= this.MAX_CHANNELS) {
-        this.sdk.logger.error(
+        logger.error(
           `P2P appChannel must be an integer in [0, ${this.MAX_CHANNELS}), received ${appChannel}, dropping message.`
         );
         this.reportPacketDrop(-1, "SEND", "INVALID_CHANNEL");
         return false;
       }
       if (payloadSize <= 0) {
-        this.sdk.logger.error(
+        logger.error(
           `P2P payloadSize must be greater than 0, received ${payloadSize}, dropping message.`
         );
         this.reportPacketDrop(appChannel, "SEND", "INVALID_PAYLOAD_SIZE");
         return false;
       }
       if (payloadSize > this.MAX_PAYLOAD_SIZE) {
-        this.sdk.logger.error(
+        logger.error(
           `P2P payload too large: ${payloadSize} bytes exceeds max ${this.MAX_PAYLOAD_SIZE} bytes, dropping message.`
         );
         this.reportPacketDrop(appChannel, "SEND", "PAYLOAD_TOO_LARGE");
         return false;
       }
       if (payloadSize > payload.length) {
-        this.sdk.logger.error(
+        logger.error(
           `payloadSize is greater than payload buffer length: ${payloadSize} > ${payload.length}, dropping message.`
         );
         this.reportPacketDrop(appChannel, "SEND", "INVALID_PAYLOAD_SIZE");
@@ -1990,7 +2031,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           try {
             channel.send(messageData);
           } catch (error) {
-            this.sdk.logger.error(
+            logger.error(
               `P2P broadcast to peer ${peerUserId} failed:`,
               error
             );
@@ -1999,7 +2040,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       } else {
         const channel = channelMap.get(toUserId);
         if (!channel || channel.readyState !== "open") {
-          this.sdk.logger.error(
+          logger.error(
             `P2P no open channel to peer ${toUserId}, dropping message.`
           );
           this.reportPacketDrop(appChannel, "SEND", "PEER_NOT_READY");
@@ -2008,7 +2049,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
         try {
           channel.send(messageData);
         } catch (error) {
-          this.sdk.logger.error(
+          logger.error(
             `P2P send to peer ${toUserId} failed, dropping message:`,
             error
           );
@@ -2018,7 +2059,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       }
       return true;
     } catch (error) {
-      this.sdk.logger.error(`Error sending P2P message:`, error);
+      logger.error(`Error sending P2P message:`, error);
       return false;
     }
   }
@@ -2039,9 +2080,9 @@ var _P2PManager = class _P2PManager extends WavedashManager {
           data: message.data
         }
       );
-      this.sdk.logger.debug("Sent signaling message:", message.type);
+      logger.debug("Sent signaling message:", message.type);
     } catch (error) {
-      this.sdk.logger.error("Failed to send signaling message:", error);
+      logger.error("Failed to send signaling message:", error);
       throw error;
     }
   }
@@ -2127,7 +2168,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       messageCount: 0,
       incomingDataView
     });
-    this.sdk.logger.debug(
+    logger.debug(
       `Allocated P2P ring buffer for channel ${channel} (${(queueDataSize / 1024 / 1024).toFixed(1)}MB)`
     );
   }
@@ -2197,7 +2238,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
   enqueueMessage(wireData, fromUserId) {
     try {
       if (wireData.byteLength < this.WIRE_PAYLOAD_OFFSET) {
-        this.sdk.logger.warn("Binary message too short to extract channel");
+        logger.warn("Binary message too short to extract channel");
         this.reportPacketDrop(-1, "RECEIVE", "MALFORMED");
         return;
       }
@@ -2205,7 +2246,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       const channel = wireBytes[this.WIRE_CHANNEL_OFFSET];
       if (!this.channelQueues.has(channel)) {
         if (channel >= this.MAX_CHANNELS) {
-          this.sdk.logger.warn(
+          logger.warn(
             `Channel ${channel} exceeds max channels (${this.MAX_CHANNELS}), dropping message`
           );
           this.reportPacketDrop(channel, "RECEIVE", "INVALID_CHANNEL");
@@ -2215,7 +2256,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       }
       const queue = this.channelQueues.get(channel);
       if (queue.messageCount >= this.QUEUE_SIZE) {
-        this.sdk.logger.warn(
+        logger.warn(
           `P2P message queue full for channel ${channel}, dropping message`
         );
         this.reportPacketDrop(channel, "RECEIVE", "QUEUE_FULL");
@@ -2225,7 +2266,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       const storedSize = this.PAYLOAD_OFFSET + payloadLength;
       const maxMessageSize = this.MESSAGE_SIZE - this.MESSAGE_SLOT_HEADER_SIZE;
       if (storedSize > maxMessageSize) {
-        this.sdk.logger.warn(
+        logger.warn(
           `Message too large for queue: ${storedSize} > ${maxMessageSize}, dropping message.`
         );
         this.reportPacketDrop(channel, "RECEIVE", "PAYLOAD_TOO_LARGE");
@@ -2265,7 +2306,7 @@ var _P2PManager = class _P2PManager extends WavedashManager {
       queue.writeIndex = (queue.writeIndex + 1) % this.QUEUE_SIZE;
       queue.messageCount++;
     } catch (error) {
-      this.sdk.logger.error(`Error enqueuing binary P2P message:`, error);
+      logger.error(`Error enqueuing binary P2P message:`, error);
     }
   }
   // Returns the max payload size (what game engines should report as max packet size)
@@ -2483,7 +2524,7 @@ var StatsManager = class extends WavedashManager {
     );
     this.subscribe();
     this.requestStats().catch((error) => {
-      this.sdk.logger.error("Initial stats fetch failed:", error);
+      logger.error("Initial stats fetch failed:", error);
     });
   }
   destroy() {
@@ -2506,7 +2547,7 @@ var StatsManager = class extends WavedashManager {
           this.knownStatIds = new Set(ids);
         },
         (error) => {
-          this.sdk.logger.error("Stat identifiers subscription error:", error);
+          logger.error("Stat identifiers subscription error:", error);
         }
       ),
       this.sdk.convexClient.onUpdate(
@@ -2516,7 +2557,7 @@ var StatsManager = class extends WavedashManager {
           this.knownAchievementIds = new Set(ids);
         },
         (error) => {
-          this.sdk.logger.error(
+          logger.error(
             "Achievement identifiers subscription error:",
             error
           );
@@ -2532,7 +2573,7 @@ var StatsManager = class extends WavedashManager {
           }
         },
         (error) => {
-          this.sdk.logger.error("Achievement subscription error:", error);
+          logger.error("Achievement subscription error:", error);
         }
       )
     );
@@ -2583,7 +2624,7 @@ var StatsManager = class extends WavedashManager {
       });
     }).catch((error) => {
       const message = error instanceof Error ? error.message : `Error storing stats: ${error}`;
-      this.sdk.logger.error(message);
+      logger.error(message);
       this.sdk.gameEventManager.notifyGame(WavedashEvents.STATS_STORED, {
         success: false,
         message
@@ -2747,7 +2788,7 @@ var HeartbeatManager = class extends WavedashManager {
         this.lastHeartbeatTime = Date.now();
       }
     }).catch((error) => {
-      this.sdk.logger.error(`Heartbeat failed: ${error}`);
+      logger.error(`Heartbeat failed: ${error}`);
     }).finally(() => {
       this.heartbeatInFlight = false;
     });
@@ -2766,7 +2807,7 @@ var HeartbeatManager = class extends WavedashManager {
       });
       return true;
     } catch (error) {
-      this.sdk.logger.error(`Error updating presence: ${error}`);
+      logger.error(`Error updating presence: ${error}`);
       return false;
     }
   }
@@ -2793,7 +2834,7 @@ var HeartbeatManager = class extends WavedashManager {
         );
       } else if (!this.isConnected && wasConnected) {
         this.disconnectedAt = Date.now();
-        this.sdk.logger.warn(
+        logger.warn(
           "Backend disconnected - attempting to reconnect..."
         );
         this.sdk.gameEventManager.notifyGame(
@@ -2813,7 +2854,7 @@ var HeartbeatManager = class extends WavedashManager {
         this.sentDisconnectedEvent = false;
       }
     } catch (error) {
-      this.sdk.logger.error("Error testing connection:", error);
+      logger.error("Error testing connection:", error);
     }
   }
   isCurrentlyConnected() {
@@ -2833,7 +2874,7 @@ var GameEventManager = class extends WavedashManager {
   notifyGame(event, payload) {
     if (!this.sdk.eventsReady) {
       this.eventQueue.push({ event, payload });
-      this.sdk.logger.debug(`Queued event: ${event}`);
+      logger.debug(`Queued event: ${event}`);
       return;
     }
     if (!this.sdk.engineInstance) {
@@ -2851,7 +2892,7 @@ var GameEventManager = class extends WavedashManager {
         data
       );
     } else {
-      this.sdk.logger.error("Engine instance not set. Dropping event:", event);
+      logger.error("Engine instance not set. Dropping event:", event);
     }
   }
   flushEventQueue() {
@@ -3009,21 +3050,10 @@ function getCdnImageUrl(r2Key, host, options) {
 var FriendsManager = class extends WavedashManager {
   constructor(sdk) {
     super(sdk);
+    // Persistent cache for users with a durable relationship (self, friends, shared lobby).
     this.userCache = /* @__PURE__ */ new Map();
-  }
-  /**
-   * Cache users from any source (friends, lobby users)
-   * Accepts both Friend format (avatarUrl) and LobbyUser format (userAvatarUrl)
-   * @param users - Array of users with userId, username, and optional avatar r2Key
-   */
-  cacheUsers(users) {
-    for (const user of users) {
-      this.userCache.set(user.userId, {
-        username: user.username,
-        // Support both Friend (avatarUrl) and LobbyUser (userAvatarUrl) formats
-        avatarR2Key: user.avatarUrl ?? user.userAvatarUrl
-      });
-    }
+    // Transient cache for only the most recently loaded leaderboard page. Cleared on each new page.
+    this.leaderboardPageUserCache = /* @__PURE__ */ new Map();
   }
   /**
    * Returns CDN URL with size transformation for a cached user's avatar.
@@ -3033,7 +3063,7 @@ var FriendsManager = class extends WavedashManager {
    * @returns CDN URL with size transformation, or null if user not cached or has no avatar
    */
   getUserAvatarUrl(userId, size = AvatarSize.MEDIUM) {
-    const user = this.userCache.get(userId);
+    const user = this.userCache.get(userId) ?? this.leaderboardPageUserCache.get(userId);
     if (!user?.avatarR2Key) {
       return null;
     }
@@ -3051,8 +3081,17 @@ var FriendsManager = class extends WavedashManager {
    * @returns The username, or null if user not cached
    */
   getUsername(userId) {
-    return this.userCache.get(userId)?.username ?? null;
+    return this.userCache.get(userId)?.username ?? this.leaderboardPageUserCache.get(userId)?.username ?? null;
   }
+  /**
+   * List all friends for the logged in user
+   * @returns Array<{
+   *   avatarUrl?: string;
+   *   isOnline: boolean;
+   *   userId: Id<"users">;
+   *   username: string;
+   * }>
+   */
   async listFriends() {
     const friends = await this.sdk.convexClient.query(
       api8.sdk.friends.listFriends,
@@ -3061,41 +3100,37 @@ var FriendsManager = class extends WavedashManager {
     this.cacheUsers(friends);
     return friends;
   }
-};
-
-// src/utils/logger.ts
-var LOG_LEVEL = {
-  DEBUG: 0,
-  // Most verbose
-  INFO: 1,
-  WARN: 2,
-  ERROR: 3
-};
-var WavedashLogger = class {
-  constructor(logLevel = LOG_LEVEL.WARN) {
-    this.logLevel = logLevel;
-  }
-  setLogLevel(level) {
-    this.logLevel = level;
-  }
-  debug(message, ...args) {
-    if (this.logLevel <= LOG_LEVEL.DEBUG) {
-      console.log(`[WavedashJS] ${message}`, ...args);
-    }
-  }
-  info(message, ...args) {
-    if (this.logLevel <= LOG_LEVEL.INFO) {
-      console.log(`[WavedashJS] ${message}`, ...args);
-    }
-  }
-  warn(message, ...args) {
-    if (this.logLevel <= LOG_LEVEL.WARN) {
-      console.warn(`[WavedashJS] ${message}`, ...args);
+  /**
+   * Cache users from any source (friends, lobby users)
+   * Accepts both Friend format (avatarUrl) and LobbyUser format (userAvatarUrl)
+   * @param users - Array of users with userId, username, and optional avatar r2Key
+   * @internal
+   */
+  cacheUsers(users) {
+    for (const user of users) {
+      this.userCache.set(user.userId, {
+        username: user.username,
+        // Support both Friend (avatarUrl) and LobbyUser (userAvatarUrl) formats
+        avatarR2Key: user.avatarUrl ?? user.userAvatarUrl
+      });
     }
   }
-  error(message, ...args) {
-    if (this.logLevel <= LOG_LEVEL.ERROR) {
-      console.error(`[WavedashJS] ${message}`, ...args);
+  /**
+   * Replace the leaderboard-page cache with the users from a single page of
+   * leaderboard entries.
+   * 
+   * In general devs should just use the username and userAvatarUrl returned
+   * from `listLeaderboardEntries` directly, but we cache the latest leaderboard
+   * page here just so getUserAvatarUrl and getUsername still work for the current page.
+   * @internal
+   */
+  cacheLeaderboardPage(users) {
+    this.leaderboardPageUserCache.clear();
+    for (const user of users) {
+      this.leaderboardPageUserCache.set(user.userId, {
+        username: user.username,
+        avatarR2Key: user.userAvatarUrl
+      });
     }
   }
 };
@@ -3194,6 +3229,69 @@ var IFrameMessenger = class {
   }
 };
 
+// src/utils/swMessenger.ts
+var SwMessenger = class {
+  constructor() {
+    this.handleMessage = (event) => {
+      const data = event.data;
+      const type = data?.type;
+      if (!type) return;
+      const set = this.listeners.get(type);
+      if (!set || set.size === 0) return;
+      const port = event.ports?.[0];
+      const reply = (message) => {
+        if (port) {
+          try {
+            port.postMessage(message);
+          } catch (err) {
+            logger.warn("Failed to reply to SW via port", err);
+          }
+        }
+        this.postToServiceWorker(message);
+      };
+      for (const listener of set) listener(data?.payload, reply);
+    };
+    this.listeners = /* @__PURE__ */ new Map();
+    if (typeof navigator !== "undefined" && navigator.serviceWorker) {
+      navigator.serviceWorker.addEventListener("message", this.handleMessage);
+    }
+  }
+  /**
+   * Register a handler for an incoming message type from the SW. The handler
+   * receives the message payload and a `reply` function that routes the
+   * response back via the transferred MessagePort when present, falling back
+   * to a controller postMessage otherwise.
+   */
+  addEventListener(type, listener) {
+    let set = this.listeners.get(type);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(type, set);
+    }
+    set.add(listener);
+  }
+  removeEventListener(type, listener) {
+    this.listeners.get(type)?.delete(listener);
+  }
+  /**
+   * Fire-and-forget message to the active service worker controller. No-op
+   * when no SW is controlling the page (first load before activation, or
+   * environments without SW support).
+   */
+  postToServiceWorker(message) {
+    if (typeof navigator === "undefined" || !navigator.serviceWorker) {
+      return false;
+    }
+    try {
+      navigator.serviceWorker.controller?.postMessage(message);
+      return true;
+    } catch (err) {
+      logger.warn("Failed to post message to service worker", err);
+      return false;
+    }
+  }
+};
+
 // src/index.ts
 import { IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE5, UrlParams } from "@wvdsh/api";
 
@@ -3344,7 +3442,7 @@ var WavedashSDK = class extends EventTarget {
     this.iframeMessenger = iframeMessenger;
     this.ugcHost = sdkConfig.ugcHost;
     this.uploadsHost = sdkConfig.uploadsHost;
-    this.logger = new WavedashLogger();
+    this.swMessenger = new SwMessenger();
     this.p2pManager = new P2PManager(this);
     this.lobbyManager = new LobbyManager(this);
     this.statsManager = new StatsManager(this);
@@ -3377,10 +3475,11 @@ var WavedashSDK = class extends EventTarget {
       }
     ]);
     this.setupSessionEndListeners();
+    this.setupSwCredsListener();
     this.launchParams = sdkConfig.launchParams ?? {};
     this.setupWarningTimeout = setTimeout(() => {
       this.setupWarningTimeout = null;
-      this.logger.warn(
+      logger.warn(
         "Wavedash.init(), Wavedash.loadComplete(), or Wavedash.updateLoadProgressZeroToOne() not called yet"
       );
     }, 1e4);
@@ -3403,24 +3502,24 @@ var WavedashSDK = class extends EventTarget {
   init(config) {
     this.loadComplete();
     if (this._initialized) {
-      this.logger.warn("init called twice! Already initialized, skipping init");
+      logger.warn("init called twice! Already initialized, skipping init");
       return false;
     }
     if (typeof config === "string") {
       try {
         config = JSON.parse(config);
       } catch (error) {
-        this.logger.error("Initialized with invalid config:", error);
+        logger.error("Initialized with invalid config:", error);
         return false;
       }
     }
     this.config = config ?? {};
     this._initialized = true;
-    this.logger.setLogLevel(
+    logger.setLogLevel(
       this.config.debug ? LOG_LEVEL.DEBUG : LOG_LEVEL.WARN
     );
     this.p2pManager.init(this.config.p2p);
-    this.logger.debug("Initialized with config:", this.config);
+    logger.debug("Initialized with config:", this.config);
     if (!this.config.deferEvents) {
       this.readyForEvents();
     }
@@ -3567,13 +3666,13 @@ var WavedashSDK = class extends EventTarget {
    * @returns The user's JWT signed by the Wavedash backend
    */
   async getUserJwt() {
-    this.logger.debug("getUserJwt");
+    logger.debug("getUserJwt");
     try {
       const data = await this.ensureGameplayJwt();
       return this.formatResponse({ success: true, data });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.error("getUserJwt", message);
+      logger.error("getUserJwt", message);
       return this.formatResponse({ success: false, data: null, message });
     }
   }
@@ -4217,29 +4316,29 @@ var WavedashSDK = class extends EventTarget {
   // require config or produce events (lobby join/create, P2P).
   ensureInit() {
     if (!this._initialized) {
-      this.logger.error("SDK not initialized. Call WavedashJS.init first.");
+      logger.error("SDK not initialized. Call WavedashJS.init first.");
       throw new Error("SDK not initialized");
     }
   }
   async apiCall(manager, method, argSpecs, ...args) {
-    this.logger.debug(method, ...args);
+    logger.debug(method, ...args);
     try {
       validateArgs(method, argSpecs, args);
       const data = await manager[method](...args);
       return this.formatResponse({ success: true, data });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.error(method, message);
+      logger.error(method, message);
       return this.formatResponse({ success: false, data: null, message });
     }
   }
   apiCallSync(target, method, argSpecs, ...args) {
-    this.logger.debug(method, ...args);
+    logger.debug(method, ...args);
     try {
       validateArgs(method, argSpecs, args);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
-      this.logger.error(method, message);
+      logger.error(method, message);
       throw error;
     }
     return this.formatResponse(target[method](...args));
@@ -4290,6 +4389,10 @@ var WavedashSDK = class extends EventTarget {
       iframeMessenger.postToParent(IFRAME_MESSAGE_TYPE5.GAMEPLAY_JWT_READY, {
         gameplayJwt: this.gameplayJwt
       });
+      this.swMessenger.postToServiceWorker({
+        type: "embed.jwt-update",
+        payload: { gameplayJwt: this.gameplayJwt }
+      });
       return this.gameplayJwt;
     })().finally(() => {
       if (this.gameplayJwtPromise === promise) {
@@ -4323,6 +4426,30 @@ var WavedashSDK = class extends EventTarget {
       () => this.destroy()
     );
   }
+  /**
+   * Respond to the service worker's `embed.creds-request` with the SDK's
+   * current gameplay JWT. The SW asks when it wakes from termination with no
+   * in-memory or IDB credentials (e.g. Safari ITP storage decay) — we're the
+   * fastest live source. JWT only; sessionToken is owned by the SW + cookies.
+   */
+  setupSwCredsListener() {
+    this.swMessenger.addEventListener(
+      "embed.creds-request",
+      async (_payload, reply) => {
+        let jwt;
+        try {
+          jwt = await this.ensureGameplayJwt();
+        } catch (err) {
+          logger.warn("Failed to resolve JWT for creds-request", err);
+          return;
+        }
+        reply({
+          type: "embed.creds-response",
+          payload: { gameplayJwt: jwt }
+        });
+      }
+    );
+  }
 };
 function setupWavedashSDK() {
   const existing = window.Wavedash;