@wvdsh/sdk-js 1.3.18 → 1.3.20

package/dist/index.d.ts

@@ -665,16 +665,18 @@ declare class LobbyManager extends WavedashManager {
  * Owns the iframe ↔ parent interactions for the Wavedash overlay UI:
  * - Shift+Tab inside the iframe toggles the overlay on the host page
  *   (the host owns the overlay, so we postMessage up).
- * - When the parent closes the overlay it sends TAKE_FOCUS so keyboard
- *   input goes back to the game; we walk the DOM for a focusable target.
- * - `takeFocus()` is also called after load completes so the game starts
- *   with keyboard focus without the player clicking first.
+ * - When the parent closes the overlay it sends TAKE_FOCUS, which hands
+ *   keyboard focus back to the game (see `takeFocus`).
+ * - While the overlay is open we suspend pointer lock (the host broadcasts
+ *   OVERLAY_CHANGED) so a game can't hold/re-grab the cursor behind it.
  */
 declare class OverlayManager extends WavedashManager {
+    private restorePointerLock;
     constructor(sdk: WavedashSDK);
+    private setOpen;
     toggleOverlay(): void;
-    takeFocus(): void;
     private handleKeyDown;
+    destroy(): void;
 }
 
 /**
@@ -795,9 +797,13 @@ declare class P2PManager extends WavedashManager {
 }
 
 declare class PaidContentManager extends WavedashManager {
+    private paywallOpen;
+    private restorePointerLock;
     isEntitled(contentId: string): Promise<boolean>;
     getEntitlements(): Promise<string[]>;
     triggerPaywall(contentIdentifier: string): Promise<boolean>;
+    isPaywallOpen(): boolean;
+    destroy(): void;
 }
 
 declare class StatsManager extends WavedashManager {

package/dist/index.js

@@ -1849,6 +1849,44 @@ var LobbyManager = _LobbyManager;
 
 // src/services/overlay.ts
 import { IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE5 } from "@wvdsh/api";
+
+// src/utils/focus.ts
+function takeFocus() {
+  if (typeof document === "undefined") return;
+  const gameFocusTargets = document.getElementsByClassName("game-focus-target");
+  if (gameFocusTargets.length > 0) {
+    gameFocusTargets[0].focus();
+    return;
+  }
+  const focusableElement = document.querySelector(
+    "canvas, input, button, [tabindex]:not([tabindex='-1'])"
+  );
+  focusableElement?.focus();
+}
+
+// src/utils/pointerLock.ts
+var hasDom = typeof Element !== "undefined" && typeof document !== "undefined";
+var nativeRequestPointerLock = hasDom ? Element.prototype.requestPointerLock : void 0;
+var depth = 0;
+function suspendPointerLock() {
+  if (!hasDom || !nativeRequestPointerLock) return () => {
+  };
+  if (++depth === 1) {
+    Element.prototype.requestPointerLock = function() {
+      return Promise.resolve();
+    };
+  }
+  document.exitPointerLock();
+  let disposed = false;
+  return () => {
+    if (disposed) return;
+    disposed = true;
+    if (--depth === 0)
+      Element.prototype.requestPointerLock = nativeRequestPointerLock;
+  };
+}
+
+// src/services/overlay.ts
 var OverlayManager = class extends WavedashManager {
   constructor(sdk) {
     super(sdk);
@@ -1860,29 +1898,36 @@ var OverlayManager = class extends WavedashManager {
     };
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE5.TAKE_FOCUS,
-      () => this.takeFocus()
+      takeFocus
+    );
+    this.sdk.iframeMessenger.addEventListener(
+      IFRAME_MESSAGE_TYPE5.OVERLAY_CHANGED,
+      ({ isOpen }) => this.setOpen(isOpen)
     );
     if (typeof window !== "undefined") {
       window.addEventListener("keydown", this.handleKeyDown);
     }
   }
+  setOpen(open) {
+    if (open) {
+      this.restorePointerLock ?? (this.restorePointerLock = suspendPointerLock());
+    } else {
+      this.restorePointerLock?.();
+      this.restorePointerLock = void 0;
+    }
+  }
   toggleOverlay() {
     this.sdk.iframeMessenger.postToParent(
       IFRAME_MESSAGE_TYPE5.TOGGLE_OVERLAY,
       {}
     );
   }
-  takeFocus() {
-    if (typeof document === "undefined") return;
-    const gameFocusTargets = document.getElementsByClassName("game-focus-target");
-    if (gameFocusTargets.length > 0) {
-      gameFocusTargets[0].focus();
-      return;
+  destroy() {
+    this.restorePointerLock?.();
+    this.restorePointerLock = void 0;
+    if (typeof window !== "undefined") {
+      window.removeEventListener("keydown", this.handleKeyDown);
     }
-    const focusableElement = document.querySelector(
-      "canvas, input, button, [tabindex]:not([tabindex='-1'])"
-    );
-    focusableElement?.focus();
   }
 };
 
@@ -3204,6 +3249,10 @@ function readEntitlementsFromJwt(jwt) {
   return ents.filter((e) => typeof e === "string");
 }
 var PaidContentManager = class extends WavedashManager {
+  constructor() {
+    super(...arguments);
+    this.paywallOpen = false;
+  }
   async isEntitled(contentId) {
     const jwt = await this.sdk.ensureGameplayJwt();
     return readEntitlementsFromJwt(jwt).includes(contentId);
@@ -3214,15 +3263,34 @@ var PaidContentManager = class extends WavedashManager {
   }
   async triggerPaywall(contentIdentifier) {
     if (await this.isEntitled(contentIdentifier)) return true;
-    const response = await this.sdk.iframeMessenger.requestFromParent(
-      IFRAME_MESSAGE_TYPE6.TRIGGER_PAYWALL,
-      { contentIdentifier },
-      PAYWALL_TIMEOUT_MS
-    );
+    if (this.paywallOpen) {
+      throw new Error("Paywall already in progress");
+    }
+    this.paywallOpen = true;
+    this.restorePointerLock = suspendPointerLock();
+    let response;
+    try {
+      response = await this.sdk.iframeMessenger.requestFromParent(
+        IFRAME_MESSAGE_TYPE6.TRIGGER_PAYWALL,
+        { contentIdentifier },
+        PAYWALL_TIMEOUT_MS
+      );
+    } finally {
+      this.restorePointerLock?.();
+      this.restorePointerLock = void 0;
+      this.paywallOpen = false;
+    }
     if (!response.purchased) return false;
     await this.sdk.ensureGameplayJwt(true);
     return true;
   }
+  isPaywallOpen() {
+    return this.paywallOpen;
+  }
+  destroy() {
+    this.restorePointerLock?.();
+    this.restorePointerLock = void 0;
+  }
 };
 
 // src/services/stats.ts
@@ -3683,6 +3751,7 @@ var SwMessenger = class {
 import {
   IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE7,
   UrlParams,
+  PlayRouteCaller,
   SERVICE_WORKER_MESSAGE_TYPE
 } from "@wvdsh/api";
 
@@ -4032,7 +4101,6 @@ var WavedashSDK = class extends EventTarget {
     this.gameFinishedLoading = true;
     this.heartbeatManager.start();
     iframeMessenger.postToParent(IFRAME_MESSAGE_TYPE7.LOADING_COMPLETE, {});
-    this.overlayManager.takeFocus();
   }
   get gameLoaded() {
     return this.gameFinishedLoading;
@@ -4961,7 +5029,11 @@ var WavedashSDK = class extends EventTarget {
         await previous.catch(() => {
         });
       }
-      const response = await fetch("/auth/refresh", {
+      const refreshQuery = new URLSearchParams({
+        [UrlParams.Caller]: PlayRouteCaller.Wavedash
+      });
+      const refreshPath = `/auth/refresh?${refreshQuery.toString()}`;
+      const response = await fetch(refreshPath, {
         method: "POST",
         credentials: "same-origin"
       });

package/package.json

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