@wvdsh/sdk-js 1.3.27 → 1.3.30

package/dist/index.js

@@ -84,6 +84,56 @@ var WavedashEvents = {
 // src/services/audio.ts
 import { IFRAME_MESSAGE_TYPE } from "@wvdsh/api";
 
+// 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/utils/parentOrigin.ts
+var _parentOrigin = "";
+function setParentOrigin(origin) {
+  _parentOrigin = origin;
+}
+function getParentOrigin() {
+  return _parentOrigin;
+}
+function hasParentFrame() {
+  return _parentOrigin !== "";
+}
+
 // src/services/manager.ts
 var WavedashManager = class {
   constructor(sdk) {
@@ -134,6 +184,12 @@ var AudioManager = class extends WavedashManager {
    * MUTE_CHANGED broadcast, so `isMuted()` updates independently of this result.
    */
   async requestMute(muted) {
+    if (!hasParentFrame()) {
+      logger.debug(
+        "requestMute() is disabled outside a Wavedash parent frame (e.g. `wavedash dev`)"
+      );
+      return false;
+    }
     const response = await this.sdk.iframeMessenger.requestFromParent(
       IFRAME_MESSAGE_TYPE.SET_MUTE,
       { muted }
@@ -146,6 +202,12 @@ var AudioManager = class extends WavedashManager {
    * host applied the change.
    */
   async toggleMute() {
+    if (!hasParentFrame()) {
+      logger.debug(
+        "toggleMute() is disabled outside a Wavedash parent frame (e.g. `wavedash dev`)"
+      );
+      return false;
+    }
     const response = await this.sdk.iframeMessenger.requestFromParent(
       IFRAME_MESSAGE_TYPE.TOGGLE_MUTE
     );
@@ -241,7 +303,12 @@ var AudioManager = class extends WavedashManager {
 };
 var AudioFrameShim = class {
   constructor(manager, win) {
-    this.contexts = /* @__PURE__ */ new Map();
+    // Weakly tracked so we never outlive the game's own references: pinning a
+    // context here would keep its OS audio stream mixing forever, and games that
+    // churn contexts would accumulate streams (a crackle source on weaker audio
+    // stacks, e.g. Firefox/Windows). The gain lives exactly as long as its context.
+    this.contexts = new WeakRefSet();
+    this.contextGains = /* @__PURE__ */ new WeakMap();
     // Tracked media elements + the game's intended muted value (what it last set).
     this.elements = new WeakRefSet();
     this.intendedMuted = /* @__PURE__ */ new WeakMap();
@@ -268,11 +335,19 @@ var AudioFrameShim = class {
   /** Push the current mute state onto everything this frame is tracking. */
   applyMute(isMuted) {
     const target = isMuted ? 0 : 1;
-    this.contexts.forEach((gain, ctx) => {
+    this.contexts.forEach((ctx) => {
+      const gain = this.contextGains.get(ctx);
+      if (!gain) return;
       const now = ctx.currentTime;
-      gain.gain.cancelScheduledValues(now);
-      gain.gain.setValueAtTime(gain.gain.value, now);
-      gain.gain.linearRampToValueAtTime(target, now + 0.05);
+      const param = gain.gain;
+      if (typeof param.cancelAndHoldAtTime === "function") {
+        param.cancelAndHoldAtTime(now);
+      } else {
+        const current = param.value;
+        param.cancelScheduledValues(now);
+        param.setValueAtTime(current, now);
+      }
+      param.linearRampToValueAtTime(target, now + 0.05);
     });
     const setMutedNative = this.originalMutedDescriptor?.set;
     if (setMutedNative) {
@@ -348,11 +423,13 @@ var AudioFrameShim = class {
               this.bindChild(node);
             } else if (node instanceof HTMLElementCtor) {
               const el = node;
-              el.querySelectorAll("audio, video").forEach((m2) => {
-                this.trackElement(m2);
-              });
-              el.querySelectorAll("iframe").forEach((f) => {
-                this.bindChild(f);
+              if (!el.firstElementChild) return;
+              el.querySelectorAll("audio, video, iframe").forEach((child) => {
+                if (child instanceof HTMLIFrameElementCtor) {
+                  this.bindChild(child);
+                } else {
+                  this.trackElement(child);
+                }
               });
             }
           });
@@ -360,7 +437,9 @@ var AudioFrameShim = class {
             if (node instanceof HTMLIFrameElementCtor) {
               this.unbindChild(node);
             } else if (node instanceof HTMLElementCtor) {
-              node.querySelectorAll("iframe").forEach((f) => {
+              const el = node;
+              if (!el.firstElementChild) return;
+              el.querySelectorAll("iframe").forEach((f) => {
                 this.unbindChild(f);
               });
             }
@@ -465,22 +544,46 @@ var AudioFrameShim = class {
     return /* @__PURE__ */ ((shim) => class extends Original {
       constructor(opts) {
         super(opts);
+        const realDestination = this.destination;
         const masterGain = this.createGain();
-        masterGain.connect(this.destination);
-        masterGain.gain.setValueAtTime(
-          shim.manager.isMuted() ? 0 : 1,
-          this.currentTime
-        );
+        masterGain.connect(realDestination);
+        masterGain.gain.value = shim.manager.isMuted() ? 0 : 1;
+        Object.defineProperty(masterGain, "maxChannelCount", {
+          configurable: true,
+          get: () => realDestination.maxChannelCount
+        });
+        for (const prop of [
+          "channelCount",
+          "channelCountMode",
+          "channelInterpretation"
+        ]) {
+          const nativeSet = Object.getOwnPropertyDescriptor(
+            shim.win.AudioNode.prototype,
+            prop
+          )?.set;
+          Object.defineProperty(masterGain, prop, {
+            configurable: true,
+            get: () => realDestination[prop],
+            set: (value) => {
+              realDestination[prop] = value;
+              try {
+                nativeSet?.call(masterGain, value);
+              } catch {
+              }
+            }
+          });
+        }
         Object.defineProperty(this, "destination", {
           configurable: true,
           get() {
             return masterGain;
           }
         });
-        shim.contexts.set(this, masterGain);
+        shim.contexts.add(this);
+        shim.contextGains.set(this, masterGain);
       }
       close() {
-        shim.contexts.delete(this);
+        shim.contextGains.delete(this);
         return super.close();
       }
     })(this);
@@ -548,6 +651,7 @@ var AudioFrameShim = class {
       }
     });
     this.contexts.clear();
+    this.contextGains = /* @__PURE__ */ new WeakMap();
     this.elements.clear();
     this.intendedMuted = /* @__PURE__ */ new WeakMap();
     this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
@@ -645,44 +749,6 @@ function toBlobFromIndexedDBValue(value) {
   throw new Error("Unrecognized value shape from IndexedDB");
 }
 
-// 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/fileSystem.ts
 import { api } from "@wvdsh/api";
 var REMOTE_STORAGE_FOLDER = "userfs";
@@ -1129,6 +1195,7 @@ var FullscreenManager = class extends WavedashManager {
     super(sdk);
     this._isFullscreen = false;
     this.listeners = /* @__PURE__ */ new Set();
+    if (!hasParentFrame()) return;
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE2.FULLSCREEN_CHANGED,
       (data) => {
@@ -1150,6 +1217,12 @@ var FullscreenManager = class extends WavedashManager {
    * (e.g. browser rejected for lack of user activation).
    */
   async requestFullscreen(fullscreen) {
+    if (!hasParentFrame()) {
+      logger.debug(
+        "requestFullscreen() is disabled outside a Wavedash parent frame (e.g. `wavedash dev`)"
+      );
+      return false;
+    }
     const response = await this.sdk.iframeMessenger.requestFromParent(
       IFRAME_MESSAGE_TYPE2.SET_FULLSCREEN,
       { fullscreen }
@@ -1157,6 +1230,12 @@ var FullscreenManager = class extends WavedashManager {
     return response.success;
   }
   async toggleFullscreen() {
+    if (!hasParentFrame()) {
+      logger.debug(
+        "toggleFullscreen() is disabled outside a Wavedash parent frame (e.g. `wavedash dev`)"
+      );
+      return false;
+    }
     const response = await this.sdk.iframeMessenger.requestFromParent(
       IFRAME_MESSAGE_TYPE2.TOGGLE_FULLSCREEN
     );
@@ -1319,7 +1398,7 @@ var HeartbeatManager = class extends WavedashManager {
     this.gamepadPollInterval = setInterval(() => {
       this.pollGamepads();
     }, this.GAMEPAD_POLL_INTERVAL_MS);
-    this.deviceFingerprintReady = this.sdk.iframeMessenger.requestFromParent(IFRAME_MESSAGE_TYPE3.GET_DEVICE_FINGERPRINT).then((fingerprint) => {
+    this.deviceFingerprintReady = !hasParentFrame() ? Promise.resolve() : this.sdk.iframeMessenger.requestFromParent(IFRAME_MESSAGE_TYPE3.GET_DEVICE_FINGERPRINT).then((fingerprint) => {
       this.deviceFingerprint = fingerprint;
     }).catch(() => {
     });
@@ -1868,6 +1947,11 @@ var _LobbyManager = class _LobbyManager extends WavedashManager {
     if (!this.lobbyId) {
       throw new Error("User is not in a lobby");
     }
+    if (!hasParentFrame()) {
+      throw new Error(
+        "Lobby invite links are not available outside a Wavedash parent frame (e.g. `wavedash dev`)"
+      );
+    }
     const inviteLink = await this.sdk.iframeMessenger.requestFromParent(
       IFRAME_MESSAGE_TYPE4.GET_LOBBY_INVITE_LINK,
       { lobbyId: this.lobbyId, copyToClipboard }
@@ -2133,6 +2217,7 @@ var OverlayManager = class extends WavedashManager {
         this.toggleOverlay();
       }
     };
+    if (!hasParentFrame()) return;
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE5.TAKE_FOCUS,
       takeFocus
@@ -3463,7 +3548,76 @@ _P2PManager.MEMORY_WARNING_THRESHOLD_BYTES = 128 * 1024 * 1024;
 var P2PManager = _P2PManager;
 
 // src/services/paidContent.ts
-import { IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE6 } from "@wvdsh/api";
+import { api as api7, IFRAME_MESSAGE_TYPE as IFRAME_MESSAGE_TYPE6 } from "@wvdsh/api";
+
+// src/utils/devPaywall.ts
+var Z_INDEX = 2147483647;
+function showDevPaywall(contentIdentifier) {
+  if (typeof document === "undefined") return Promise.resolve(false);
+  return new Promise((resolve) => {
+    const overlay = document.createElement("div");
+    overlay.style.cssText = "position:fixed;inset:0;z-index:" + Z_INDEX + ";display:flex;align-items:center;justify-content:center;background:rgba(8,10,18,0.72);font:14px ui-sans-serif,system-ui,sans-serif;color:#e2e8f0";
+    const card = document.createElement("div");
+    card.style.cssText = "max-width:420px;width:calc(100% - 48px);background:#11151f;border:1px solid #2a3344;border-radius:12px;padding:24px;box-shadow:0 20px 60px rgba(0,0,0,0.5);box-sizing:border-box";
+    const badge = document.createElement("p");
+    badge.textContent = "wavedash dev \u2014 simulated purchase";
+    badge.style.cssText = "margin:0 0 12px;font-size:11px;letter-spacing:0.08em;text-transform:uppercase;color:#7c8aa5";
+    const title = document.createElement("p");
+    title.textContent = "Unlock paid content?";
+    title.style.cssText = "margin:0 0 8px;font-size:18px;font-weight:600;color:#f1f5f9";
+    const body = document.createElement("p");
+    body.style.cssText = "margin:0 0 20px;line-height:1.5;color:#cbd5e1";
+    body.append(
+      document.createTextNode("This game is requesting purchase of \u201C")
+    );
+    const id = document.createElement("code");
+    id.textContent = contentIdentifier;
+    id.style.cssText = "background:#1c2433;border-radius:4px;padding:1px 6px;color:#93c5fd";
+    body.append(
+      id,
+      document.createTextNode(
+        "\u201D. No real payment happens in dev \u2014 simulate the outcome to test your flow."
+      )
+    );
+    const buttons = document.createElement("div");
+    buttons.style.cssText = "display:flex;gap:12px;justify-content:flex-end";
+    const baseBtn = "border-radius:8px;padding:9px 18px;font-size:14px;font-weight:600;cursor:pointer;border:1px solid transparent";
+    const cancel = document.createElement("button");
+    cancel.type = "button";
+    cancel.textContent = "Cancel";
+    cancel.style.cssText = baseBtn + ";background:transparent;border-color:#374151;color:#cbd5e1";
+    const buy = document.createElement("button");
+    buy.type = "button";
+    buy.textContent = "Simulate purchase";
+    buy.style.cssText = baseBtn + ";background:#2563eb;color:#fff";
+    buttons.append(cancel, buy);
+    card.append(badge, title, body, buttons);
+    overlay.append(card);
+    let settled = false;
+    const finish = (purchased) => {
+      if (settled) return;
+      settled = true;
+      document.removeEventListener("keydown", onKeyDown, true);
+      overlay.remove();
+      resolve(purchased);
+    };
+    const onKeyDown = (event) => {
+      if (event.key === "Escape") {
+        event.preventDefault();
+        finish(false);
+      }
+    };
+    cancel.addEventListener("click", () => finish(false));
+    buy.addEventListener("click", () => finish(true));
+    overlay.addEventListener("click", (event) => {
+      if (event.target === overlay) finish(false);
+    });
+    document.addEventListener("keydown", onKeyDown, true);
+    document.body.append(overlay);
+  });
+}
+
+// src/services/paidContent.ts
 var PAYWALL_TIMEOUT_MS = 10 * 60 * 1e3;
 function decodeJwtPayload(jwt) {
   try {
@@ -3505,6 +3659,22 @@ var PaidContentManager = class extends WavedashManager {
     }
     this.paywallOpen = true;
     this.restorePointerLock = suspendPointerLock();
+    if (!hasParentFrame()) {
+      let purchased;
+      try {
+        purchased = await showDevPaywall(contentIdentifier);
+      } finally {
+        this.restorePointerLock?.();
+        this.restorePointerLock = void 0;
+        this.paywallOpen = false;
+      }
+      if (!purchased) return false;
+      await this.sdk.convexClient.mutation(api7.sdk.paidContent.mockPurchase, {
+        contentIdentifier
+      });
+      await this.sdk.ensureGameplayJwt(true);
+      return true;
+    }
     let response;
     try {
       response = await this.sdk.iframeMessenger.requestFromParent(
@@ -3531,7 +3701,7 @@ var PaidContentManager = class extends WavedashManager {
 };
 
 // src/services/stats.ts
-import { api as api7 } from "@wvdsh/api";
+import { api as api8 } from "@wvdsh/api";
 import throttle2 from "lodash.throttle";
 var STORE_THROTTLE_MS = 1e3;
 var StatsManager = class extends WavedashManager {
@@ -3589,7 +3759,7 @@ var StatsManager = class extends WavedashManager {
   subscribe() {
     this.subscriptions.push(
       this.sdk.convexClient.onUpdate(
-        api7.sdk.gameAchievements.listStatIdentifiers,
+        api8.sdk.gameAchievements.listStatIdentifiers,
         {},
         (ids) => {
           this.knownStatIds = new Set(ids);
@@ -3599,7 +3769,7 @@ var StatsManager = class extends WavedashManager {
         }
       ),
       this.sdk.convexClient.onUpdate(
-        api7.sdk.gameAchievements.listAchievementIdentifiers,
+        api8.sdk.gameAchievements.listAchievementIdentifiers,
         {},
         (ids) => {
           this.knownAchievementIds = new Set(ids);
@@ -3609,7 +3779,7 @@ var StatsManager = class extends WavedashManager {
         }
       ),
       this.sdk.convexClient.onUpdate(
-        api7.sdk.gameAchievements.getMyAchievementsForGame,
+        api8.sdk.gameAchievements.getMyAchievementsForGame,
         {},
         (achievements) => {
           this.loaded.achievements = true;
@@ -3625,7 +3795,7 @@ var StatsManager = class extends WavedashManager {
   }
   async requestStats() {
     const newStats = await this.sdk.convexClient.query(
-      api7.sdk.gameAchievements.getMyStatsForGame,
+      api8.sdk.gameAchievements.getMyStatsForGame,
       {}
     );
     this.loaded.stats = true;
@@ -3656,11 +3826,11 @@ var StatsManager = class extends WavedashManager {
     if (!pending) return;
     this.inFlightPersist = Promise.all([
       pending.stats.length > 0 ? this.sdk.convexClient.mutation(
-        api7.sdk.gameAchievements.setUserGameStats,
+        api8.sdk.gameAchievements.setUserGameStats,
         { stats: pending.stats }
       ) : Promise.resolve(),
       pending.achievements.length > 0 ? this.sdk.convexClient.mutation(
-        api7.sdk.gameAchievements.setUserGameAchievements,
+        api8.sdk.gameAchievements.setUserGameAchievements,
         { achievements: pending.achievements }
       ) : Promise.resolve()
     ]).then(() => {
@@ -3737,14 +3907,14 @@ var StatsManager = class extends WavedashManager {
 };
 
 // src/services/ugc.ts
-import { api as api8 } from "@wvdsh/api";
+import { api as api9 } from "@wvdsh/api";
 var UGCManager = class extends WavedashManager {
   constructor(sdk) {
     super(sdk);
   }
   async createUGCItem(ugcType, title, description, visibility, filePath) {
     const { ugcId, uploadUrl } = await this.sdk.convexClient.mutation(
-      api8.sdk.userGeneratedContent.createUGCItem,
+      api9.sdk.userGeneratedContent.createUGCItem,
       {
         ugcType,
         title,
@@ -3771,7 +3941,7 @@ var UGCManager = class extends WavedashManager {
   async updateUGCItem(ugcId, updates = {}) {
     const { title, description, visibility, filePath } = updates;
     const { uploadUrl } = await this.sdk.convexClient.mutation(
-      api8.sdk.userGeneratedContent.updateUGCItem,
+      api9.sdk.userGeneratedContent.updateUGCItem,
       {
         ugcId,
         title,
@@ -3797,14 +3967,14 @@ var UGCManager = class extends WavedashManager {
   }
   async deleteUGCItem(ugcId) {
     await this.sdk.convexClient.mutation(
-      api8.sdk.userGeneratedContent.deleteUGCItem,
+      api9.sdk.userGeneratedContent.deleteUGCItem,
       { ugcId }
     );
     return ugcId;
   }
   async downloadUGCItem(ugcId, filePath) {
     const downloadUrl = await this.sdk.convexClient.query(
-      api8.sdk.userGeneratedContent.getUGCItemDownloadUrl,
+      api9.sdk.userGeneratedContent.getUGCItemDownloadUrl,
       { ugcId }
     );
     try {
@@ -3819,7 +3989,7 @@ var UGCManager = class extends WavedashManager {
     const { createdBy, ugcType, titleSearch, numItems, continueCursor } = args;
     const filters = createdBy !== void 0 || ugcType !== void 0 || titleSearch !== void 0 ? { createdBy, ugcType, titleSearch } : void 0;
     return await this.sdk.convexClient.query(
-      api8.sdk.userGeneratedContent.listUGCItems,
+      api9.sdk.userGeneratedContent.listUGCItems,
       {
         filters,
         numItems,
@@ -3829,15 +3999,6 @@ var UGCManager = class extends WavedashManager {
   }
 };
 
-// src/utils/parentOrigin.ts
-var _parentOrigin = "";
-function setParentOrigin(origin) {
-  _parentOrigin = origin;
-}
-function getParentOrigin() {
-  return _parentOrigin;
-}
-
 // src/utils/iframeMessenger.ts
 var RESPONSE_TIMEOUT_MS = 15e3;
 var IFrameMessenger = class {
@@ -5281,6 +5442,7 @@ var WavedashSDK = class extends EventTarget {
       const refreshQuery = new URLSearchParams({
         [UrlParams.Caller]: PlayRouteCaller.Wavedash
       });
+      if (forceRefresh) refreshQuery.set("fresh", "1");
       const refreshPath = `/auth/refresh?${refreshQuery.toString()}`;
       const response = await fetch(refreshPath, {
         method: "POST",