@wvdsh/sdk-js 1.3.7 → 1.3.9

package/dist/index.d.ts

@@ -702,18 +702,8 @@ declare class OverlayManager extends WavedashManager {
 
 declare class FriendsManager extends WavedashManager {
     private userCache;
+    private leaderboardPageUserCache;
     constructor(sdk: WavedashSDK);
-    /**
-     * 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: Array<{
-        userId: GenericId<"users">;
-        username: string;
-        avatarUrl?: string;
-        userAvatarUrl?: string;
-    }>): void;
     /**
      * Returns CDN URL with size transformation for a cached user's avatar.
      * @param userId - The user ID to get the avatar URL for
@@ -728,31 +718,18 @@ declare class FriendsManager extends WavedashManager {
      * @returns The username, or null if user not cached
      */
     getUsername(userId: GenericId<"users">): string | null;
+    /**
+     * List all friends for the logged in user
+     * @returns Array<{
+     *   avatarUrl?: string;
+     *   isOnline: boolean;
+     *   userId: Id<"users">;
+     *   username: string;
+     * }>
+     */
     listFriends(): Promise<Friend[]>;
 }
 
-/**
- * Logger interface and implementation
- * Simply logs to the console with customizable log level
- *
- * In the future we could extend this to write .log files to IndexedDB or cache storage
- */
-interface Logger {
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-declare class WavedashLogger implements Logger {
-    private logLevel;
-    constructor(logLevel?: number);
-    setLogLevel(level: number): void;
-    debug(message: string, ...args: unknown[]): void;
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-}
-
 /**
  * Utilities for handling iframe messaging between the iframe'd Wavedash SDK and the parent window.
  * Assumes window is defined and this is only ever running inside an iframe.
@@ -779,6 +756,36 @@ declare class IFrameMessenger {
     requestFromParent<T extends keyof IFrameEventPayloadMap>(requestType: T, data?: Record<string, unknown>): Promise<IFrameEventPayloadMap[T]>;
 }
 
+/**
+ * Utilities for messaging between the SDK and the service worker
+ * that proxies API requests on its behalf.
+ */
+type SwMessage<T = unknown> = {
+    type: string;
+    payload?: T;
+};
+type SwReply = (message: SwMessage) => void;
+type SwListener = (payload: unknown, reply: SwReply) => void;
+declare class SwMessenger {
+    private listeners;
+    constructor();
+    /**
+     * 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: string, listener: SwListener): void;
+    removeEventListener(type: string, listener: SwListener): void;
+    /**
+     * 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: SwMessage): boolean;
+    private handleMessage;
+}
+
 declare class WavedashSDK extends EventTarget {
     private _initialized;
     get initialized(): boolean;
@@ -868,8 +875,8 @@ declare class WavedashSDK extends EventTarget {
     convexClient: ConvexClient;
     engineCallbackReceiver: string;
     engineInstance: EngineInstance | null;
-    logger: WavedashLogger;
     iframeMessenger: IFrameMessenger;
+    swMessenger: SwMessenger;
     p2pManager: P2PManager;
     fullscreenManager: FullscreenManager;
     overlayManager: OverlayManager;
@@ -1168,6 +1175,13 @@ declare class WavedashSDK extends EventTarget {
      */
     private destroy;
     private setupSessionEndListeners;
+    /**
+     * 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.
+     */
+    private setupSwCredsListener;
 }
 declare global {
     interface Window {