@wvdsh/sdk-js 1.3.26 → 1.3.29

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) {
@@ -94,69 +144,30 @@ var WavedashManager = class {
 };
 
 // src/services/audio.ts
-var WeakRefSet = class {
-  constructor() {
-    this.set = /* @__PURE__ */ new Set();
-  }
-  add(value) {
-    for (const ref of this.set) {
-      if (ref.deref() === value) return;
-    }
-    this.set.add(new WeakRef(value));
-  }
-  forEach(callback) {
-    for (const ref of this.set) {
-      const v = ref.deref();
-      if (v === void 0) this.set.delete(ref);
-      else callback(v);
-    }
-  }
-  clear() {
-    this.set.clear();
-  }
-};
 var AudioManager = class extends WavedashManager {
   constructor(sdk) {
     super(sdk);
     this._isMuted = false;
-    // Web Audio contexts and their master gain nodes
-    this.contexts = /* @__PURE__ */ new Map();
-    // HTML media elements we know about + their game-intended muted state
-    this.elements = new WeakRefSet();
-    this.intendedMuted = /* @__PURE__ */ new WeakMap();
-    // Speech synthesis utterances + their game-intended volume
-    this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
-    // Originals (restored on destroy)
-    this.originalAudioContext = null;
-    this.originalWebKitAudioContext = null;
-    this.originalAudio = null;
-    this.originalMutedDescriptor = null;
-    this.originalPlay = null;
-    this.originalSpeak = null;
-    this.originalUtteranceVolumeDescriptor = null;
-    this.mutationObserver = null;
+    // One shim per frame we've attached to.
+    this.frames = /* @__PURE__ */ new Set();
+    // Per-iframe state so we can re-shim across navigations/swaps and tear down
+    // the right frame when an iframe is removed or re-navigates. Keyed on the
+    // Document (replaced on every navigation), not contentWindow (a stable
+    // WindowProxy that survives navigations and so can't reveal a realm change).
+    this.iframeBindings = /* @__PURE__ */ new WeakMap();
+    this.iframeLoadHandlers = /* @__PURE__ */ new Map();
+    this.boundIframes = /* @__PURE__ */ new Set();
     this.handleMute = (data) => {
       if (this._isMuted === data.isMuted) return;
       this._isMuted = data.isMuted;
-      const target = this._isMuted ? 0 : 1;
-      this.contexts.forEach((gain, ctx) => {
-        const now = ctx.currentTime;
-        gain.gain.cancelScheduledValues(now);
-        gain.gain.setValueAtTime(gain.gain.value, now);
-        gain.gain.linearRampToValueAtTime(target, now + 0.05);
-      });
-      const setMutedNative = this.originalMutedDescriptor?.set;
-      if (setMutedNative) {
-        this.elements.forEach((el) => {
-          const intended = this.intendedMuted.get(el) ?? false;
-          setMutedNative.call(el, this._isMuted ? true : intended);
-        });
-      }
+      this.frames.forEach((shim) => shim.applyMute(this._isMuted));
       this.sdk.gameEventManager.notifyGame(WavedashEvents.MUTE_CHANGED, {
         isMuted: this._isMuted
       });
     };
-    this.installShims();
+    if (typeof window !== "undefined") {
+      this.attachWindow(window);
+    }
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE.MUTE_CHANGED,
       this.handleMute
@@ -173,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 }
@@ -185,15 +202,159 @@ 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
     );
     return response.success;
   }
+  /** Shim a window we can reach. Same-origin only (cross-origin access throws). */
+  attachWindow(win) {
+    try {
+      void win.document;
+    } catch {
+      return;
+    }
+    const shim = new AudioFrameShim(this, win);
+    this.frames.add(shim);
+  }
+  /**
+   * Start tracking an iframe: attach now (already-loaded frames) and on every
+   * `load` (about:blank → game, and later src swaps). Idempotent.
+   */
+  bindIframe(iframe) {
+    if (!this.boundIframes.has(iframe)) {
+      this.boundIframes.add(iframe);
+      const onLoad = () => this.attachIframe(iframe);
+      this.iframeLoadHandlers.set(iframe, onLoad);
+      iframe.addEventListener("load", onLoad);
+    }
+    this.attachIframe(iframe);
+  }
+  /** Stop tracking an iframe and tear down its frame (iframe removed from DOM). */
+  unbindIframe(iframe) {
+    const handler = this.iframeLoadHandlers.get(iframe);
+    if (handler) {
+      iframe.removeEventListener("load", handler);
+      this.iframeLoadHandlers.delete(iframe);
+    }
+    this.boundIframes.delete(iframe);
+    this.teardownFrame(iframe);
+  }
   /**
-   * Track a media element and (if SDK is currently muted) silence it.
-   * Idempotent — safe to call multiple times for the same element.
+   * Install (or re-install) a shim for an iframe's current document. No-ops
+   * while not yet navigated or already shimmed; replaces the previous shim when
+   * the iframe navigates to a fresh document, and drops it when it goes
+   * cross-origin (we can no longer reach it).
    */
+  attachIframe(iframe) {
+    let win = null;
+    let doc = null;
+    try {
+      const cw = iframe.contentWindow;
+      if (cw) {
+        doc = cw.document;
+        win = cw;
+      }
+    } catch {
+    }
+    if (!win || !doc) {
+      this.teardownFrame(iframe);
+      return;
+    }
+    const existing = this.iframeBindings.get(iframe);
+    if (existing) {
+      if (existing.doc === doc) return;
+      this.teardownFrame(iframe);
+    }
+    const shim = new AudioFrameShim(this, win);
+    this.frames.add(shim);
+    this.iframeBindings.set(iframe, { doc, shim });
+    if (this._isMuted) shim.applyMute(true);
+  }
+  /** Remove and uninstall the shim bound to an iframe's (previous) document. */
+  teardownFrame(iframe) {
+    const binding = this.iframeBindings.get(iframe);
+    if (!binding) return;
+    this.frames.delete(binding.shim);
+    binding.shim.uninstall();
+    this.iframeBindings.delete(iframe);
+  }
+  destroy() {
+    this.sdk.iframeMessenger.removeEventListener(
+      IFRAME_MESSAGE_TYPE.MUTE_CHANGED,
+      this.handleMute
+    );
+    this.boundIframes.forEach((iframe) => {
+      const handler = this.iframeLoadHandlers.get(iframe);
+      if (handler) iframe.removeEventListener("load", handler);
+    });
+    this.boundIframes.clear();
+    this.iframeLoadHandlers.clear();
+    this.frames.forEach((shim) => shim.uninstall());
+    this.frames.clear();
+    super.destroy();
+  }
+};
+var AudioFrameShim = class {
+  constructor(manager, win) {
+    this.contexts = /* @__PURE__ */ new Map();
+    // Tracked media elements + the game's intended muted value (what it last set).
+    this.elements = new WeakRefSet();
+    this.intendedMuted = /* @__PURE__ */ new WeakMap();
+    // Utterances + the game's intended volume.
+    this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
+    // Child iframes discovered in this frame's document. Tracked so we can
+    // cascade-unbind them when this frame is torn down — their own removal events
+    // never fire when the containing document is discarded wholesale.
+    this.boundChildren = /* @__PURE__ */ new Set();
+    // Originals, restored on uninstall.
+    this.originalAudioContext = null;
+    this.originalWebKitAudioContext = null;
+    this.originalAudio = null;
+    this.originalMutedDescriptor = null;
+    this.originalPlay = null;
+    this.originalSpeak = null;
+    this.originalUtteranceVolumeDescriptor = null;
+    this.mutationObserver = null;
+    this.manager = manager;
+    this.win = win;
+    this.doc = win.document ?? null;
+    this.installShims();
+  }
+  /** Push the current mute state onto everything this frame is tracking. */
+  applyMute(isMuted) {
+    const target = isMuted ? 0 : 1;
+    this.contexts.forEach((gain, ctx) => {
+      const now = ctx.currentTime;
+      gain.gain.cancelScheduledValues(now);
+      gain.gain.setValueAtTime(gain.gain.value, now);
+      gain.gain.linearRampToValueAtTime(target, now + 0.05);
+    });
+    const setMutedNative = this.originalMutedDescriptor?.set;
+    if (setMutedNative) {
+      this.elements.forEach((el) => {
+        const intended = this.intendedMuted.get(el) ?? false;
+        setMutedNative.call(el, isMuted ? true : intended);
+      });
+    }
+  }
+  /** Hand a discovered child iframe to the manager, remembering it for teardown. */
+  bindChild(iframe) {
+    this.boundChildren.add(iframe);
+    this.manager.bindIframe(iframe);
+  }
+  /** Stop tracking a child iframe that was removed from this document. */
+  unbindChild(iframe) {
+    this.boundChildren.delete(iframe);
+    this.manager.unbindIframe(iframe);
+  }
+  /** Track a media element and silence it if currently muted. Idempotent. */
   trackElement(el) {
     if (this.intendedMuted.has(el)) return;
     const getMuted = this.originalMutedDescriptor?.get;
@@ -201,139 +362,161 @@ var AudioManager = class extends WavedashManager {
     const current = getMuted ? getMuted.call(el) : el.muted;
     this.intendedMuted.set(el, current);
     this.elements.add(el);
-    if (this._isMuted && !current && setMuted) {
+    if (this.manager.isMuted() && !current && setMuted) {
       setMuted.call(el, true);
     }
   }
   installShims() {
-    if (typeof window === "undefined") return;
-    if (window.AudioContext) {
-      this.originalAudioContext = window.AudioContext;
-      window.AudioContext = this.shimAudioContextClass(window.AudioContext);
-    }
-    const win = window;
-    if (win.webkitAudioContext) {
-      this.originalWebKitAudioContext = win.webkitAudioContext;
-      win.webkitAudioContext = this.shimAudioContextClass(
-        win.webkitAudioContext
-      );
-    }
-    if (window.Audio) {
-      const OriginalAudio = window.Audio;
+    const win = this.win;
+    const doc = this.doc;
+    if (win.AudioContext) {
+      this.originalAudioContext = win.AudioContext;
+      win.AudioContext = this.shimAudioContextClass(win.AudioContext);
+    }
+    const w = win;
+    if (w.webkitAudioContext) {
+      this.originalWebKitAudioContext = w.webkitAudioContext;
+      w.webkitAudioContext = this.shimAudioContextClass(w.webkitAudioContext);
+    }
+    if (win.Audio) {
+      const OriginalAudio = win.Audio;
       this.originalAudio = OriginalAudio;
-      ((manager) => {
+      ((shim) => {
         const Shimmed = function(src) {
           const audio = new OriginalAudio(src);
-          manager.trackElement(audio);
+          shim.trackElement(audio);
           return audio;
         };
         Shimmed.prototype = OriginalAudio.prototype;
-        window.Audio = Shimmed;
+        win.Audio = Shimmed;
       })(this);
     }
-    if (typeof document !== "undefined") {
-      document.querySelectorAll("audio, video").forEach((el) => {
+    if (doc) {
+      const HTMLMediaElementCtor = win.HTMLMediaElement;
+      const HTMLIFrameElementCtor = win.HTMLIFrameElement;
+      const HTMLElementCtor = win.HTMLElement;
+      doc.querySelectorAll("audio, video").forEach((el) => {
         this.trackElement(el);
       });
-      this.mutationObserver = new MutationObserver((mutations) => {
+      doc.querySelectorAll("iframe").forEach((el) => {
+        this.bindChild(el);
+      });
+      this.mutationObserver = new win.MutationObserver((mutations) => {
         for (const m of mutations) {
           m.addedNodes.forEach((node) => {
-            if (node instanceof HTMLMediaElement) {
+            if (node instanceof HTMLMediaElementCtor) {
               this.trackElement(node);
-            } else if (node instanceof HTMLElement) {
-              node.querySelectorAll("audio, video").forEach((el) => {
-                this.trackElement(el);
+            } else if (node instanceof HTMLIFrameElementCtor) {
+              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);
+              });
+            }
+          });
+          m.removedNodes.forEach((node) => {
+            if (node instanceof HTMLIFrameElementCtor) {
+              this.unbindChild(node);
+            } else if (node instanceof HTMLElementCtor) {
+              node.querySelectorAll("iframe").forEach((f) => {
+                this.unbindChild(f);
               });
             }
           });
         }
       });
-      this.mutationObserver.observe(document.documentElement, {
+      this.mutationObserver.observe(doc.documentElement, {
         childList: true,
         subtree: true
       });
     }
-    this.originalMutedDescriptor = Object.getOwnPropertyDescriptor(HTMLMediaElement.prototype, "muted") ?? null;
+    this.originalMutedDescriptor = Object.getOwnPropertyDescriptor(
+      win.HTMLMediaElement.prototype,
+      "muted"
+    ) ?? null;
     const original = this.originalMutedDescriptor;
     if (original?.get && original?.set) {
-      ((manager) => {
-        Object.defineProperty(HTMLMediaElement.prototype, "muted", {
+      ((shim) => {
+        Object.defineProperty(win.HTMLMediaElement.prototype, "muted", {
           configurable: true,
           get() {
-            const intended = manager.intendedMuted.get(this);
+            const intended = shim.intendedMuted.get(this);
             return intended !== void 0 ? intended : original.get.call(this);
           },
           set(value) {
-            manager.intendedMuted.set(this, value);
-            manager.elements.add(this);
-            original.set.call(this, manager._isMuted ? true : value);
+            shim.intendedMuted.set(this, value);
+            shim.elements.add(this);
+            original.set.call(this, shim.manager.isMuted() ? true : value);
           }
         });
       })(this);
     }
-    const originalPlay = HTMLMediaElement.prototype.play;
+    const originalPlay = win.HTMLMediaElement.prototype.play;
     this.originalPlay = originalPlay;
-    ((manager) => {
-      HTMLMediaElement.prototype.play = function() {
-        manager.trackElement(this);
+    ((shim) => {
+      win.HTMLMediaElement.prototype.play = function() {
+        shim.trackElement(this);
         return originalPlay.call(this);
       };
     })(this);
     this.shimSpeechSynthesis();
   }
   /**
-   * Shim `window.speechSynthesis` so speech respects the SDK mute state.
-   *
-   * Never swallows speak(): utterances have a lifecycle the game may sequence
-   * off (onstart/onend, synth.speaking/pending checks), so every call is
-   * delegated and silenced via volume instead. Volume is sampled at speak()
-   * time, so forcing the native value to 0 right before delegating silences
-   * anything spoken while muted; in-flight speech at the mute edge is
-   * deliberately left to finish (can't be softened mid-utterance, and
-   * cancel() would discard the pending queue).
+   * Shim `speechSynthesis`. We never swallow `speak()` (games sequence off its
+   * lifecycle) — instead we sample volume at call time and force it to 0 while
+   * muted. Speech already in flight at the mute edge is left to finish.
    */
   shimSpeechSynthesis() {
-    if (!window.speechSynthesis || typeof SpeechSynthesisUtterance === "undefined") {
+    const win = this.win;
+    if (!win.speechSynthesis || typeof win.SpeechSynthesisUtterance === "undefined") {
       return;
     }
     this.originalUtteranceVolumeDescriptor = Object.getOwnPropertyDescriptor(
-      SpeechSynthesisUtterance.prototype,
+      win.SpeechSynthesisUtterance.prototype,
       "volume"
     ) ?? null;
     const volDesc = this.originalUtteranceVolumeDescriptor;
     if (volDesc?.get && volDesc?.set) {
-      ((manager) => {
-        Object.defineProperty(SpeechSynthesisUtterance.prototype, "volume", {
-          configurable: true,
-          get() {
-            const intended = manager.intendedUtteranceVolume.get(this);
-            return intended !== void 0 ? intended : volDesc.get.call(this);
-          },
-          set(value) {
-            manager.intendedUtteranceVolume.set(this, value);
-            volDesc.set.call(this, value);
+      ((shim) => {
+        Object.defineProperty(
+          win.SpeechSynthesisUtterance.prototype,
+          "volume",
+          {
+            configurable: true,
+            get() {
+              const intended = shim.intendedUtteranceVolume.get(this);
+              return intended !== void 0 ? intended : volDesc.get.call(this);
+            },
+            set(value) {
+              shim.intendedUtteranceVolume.set(this, value);
+              volDesc.set.call(this, value);
+            }
           }
-        });
+        );
       })(this);
     }
-    const speechSynthesis = window.speechSynthesis;
+    const speechSynthesis = win.speechSynthesis;
     const originalSpeak = speechSynthesis.speak;
     this.originalSpeak = originalSpeak;
-    ((manager) => {
+    ((shim) => {
       speechSynthesis.speak = function(utterance) {
-        if (manager._isMuted) {
-          if (!manager.intendedUtteranceVolume.has(utterance)) {
+        if (shim.manager.isMuted()) {
+          if (!shim.intendedUtteranceVolume.has(utterance)) {
             const current = volDesc?.get ? volDesc.get.call(utterance) : utterance.volume;
-            manager.intendedUtteranceVolume.set(utterance, current);
+            shim.intendedUtteranceVolume.set(utterance, current);
           }
           if (volDesc?.set) volDesc.set.call(utterance, 0);
           else utterance.volume = 0;
         } else {
-          const intended = manager.intendedUtteranceVolume.get(utterance);
+          const intended = shim.intendedUtteranceVolume.get(utterance);
           if (intended !== void 0) {
             if (volDesc?.set) volDesc.set.call(utterance, intended);
             else utterance.volume = intended;
-            manager.intendedUtteranceVolume.delete(utterance);
+            shim.intendedUtteranceVolume.delete(utterance);
           }
         }
         return originalSpeak.call(speechSynthesis, utterance);
@@ -341,13 +524,13 @@ var AudioManager = class extends WavedashManager {
     })(this);
   }
   shimAudioContextClass(Original) {
-    return /* @__PURE__ */ ((manager) => class extends Original {
+    return /* @__PURE__ */ ((shim) => class extends Original {
       constructor(opts) {
         super(opts);
         const masterGain = this.createGain();
         masterGain.connect(this.destination);
         masterGain.gain.setValueAtTime(
-          manager._isMuted ? 0 : 1,
+          shim.manager.isMuted() ? 0 : 1,
           this.currentTime
         );
         Object.defineProperty(this, "destination", {
@@ -356,60 +539,101 @@ var AudioManager = class extends WavedashManager {
             return masterGain;
           }
         });
-        manager.contexts.set(this, masterGain);
+        shim.contexts.set(this, masterGain);
       }
       close() {
-        manager.contexts.delete(this);
+        shim.contexts.delete(this);
         return super.close();
       }
     })(this);
   }
-  destroy() {
-    this.sdk.iframeMessenger.removeEventListener(
-      IFRAME_MESSAGE_TYPE.MUTE_CHANGED,
-      this.handleMute
-    );
-    if (this.mutationObserver) {
-      this.mutationObserver.disconnect();
-      this.mutationObserver = null;
+  /**
+   * Restore the globals we patched. Best-effort per statement: a frame reached
+   * through an iframe may have navigated away (globals gone) before teardown.
+   */
+  uninstall() {
+    const win = this.win;
+    try {
+      if (this.mutationObserver) {
+        this.mutationObserver.disconnect();
+        this.mutationObserver = null;
+      }
+    } catch {
     }
-    if (typeof window !== "undefined") {
-      if (this.originalAudioContext) {
-        window.AudioContext = this.originalAudioContext;
+    this.boundChildren.forEach((child) => this.manager.unbindIframe(child));
+    this.boundChildren.clear();
+    const restore = (fn) => {
+      try {
+        fn();
+      } catch {
       }
-      const win = window;
-      if (this.originalWebKitAudioContext && win.webkitAudioContext) {
-        win.webkitAudioContext = this.originalWebKitAudioContext;
+    };
+    restore(() => {
+      if (this.originalAudioContext)
+        win.AudioContext = this.originalAudioContext;
+    });
+    restore(() => {
+      const w = win;
+      if (this.originalWebKitAudioContext && w.webkitAudioContext) {
+        w.webkitAudioContext = this.originalWebKitAudioContext;
       }
-      if (this.originalAudio) {
-        window.Audio = this.originalAudio;
+    });
+    restore(() => {
+      if (this.originalAudio) win.Audio = this.originalAudio;
+    });
+    restore(() => {
+      if (this.originalSpeak && win.speechSynthesis) {
+        win.speechSynthesis.speak = this.originalSpeak;
       }
-      if (this.originalSpeak && window.speechSynthesis) {
-        window.speechSynthesis.speak = this.originalSpeak;
+    });
+    restore(() => {
+      if (this.originalUtteranceVolumeDescriptor && typeof win.SpeechSynthesisUtterance !== "undefined") {
+        Object.defineProperty(
+          win.SpeechSynthesisUtterance.prototype,
+          "volume",
+          this.originalUtteranceVolumeDescriptor
+        );
       }
-    }
-    if (this.originalUtteranceVolumeDescriptor && typeof SpeechSynthesisUtterance !== "undefined") {
-      Object.defineProperty(
-        SpeechSynthesisUtterance.prototype,
-        "volume",
-        this.originalUtteranceVolumeDescriptor
-      );
-    }
-    if (this.originalPlay) {
-      HTMLMediaElement.prototype.play = this.originalPlay;
-    }
-    if (this.originalMutedDescriptor) {
-      Object.defineProperty(
-        HTMLMediaElement.prototype,
-        "muted",
-        this.originalMutedDescriptor
-      );
-    }
+    });
+    restore(() => {
+      if (this.originalPlay) {
+        win.HTMLMediaElement.prototype.play = this.originalPlay;
+      }
+    });
+    restore(() => {
+      if (this.originalMutedDescriptor) {
+        Object.defineProperty(
+          win.HTMLMediaElement.prototype,
+          "muted",
+          this.originalMutedDescriptor
+        );
+      }
+    });
     this.contexts.clear();
     this.elements.clear();
     this.intendedMuted = /* @__PURE__ */ new WeakMap();
     this.intendedUtteranceVolume = /* @__PURE__ */ new WeakMap();
-    super.destroy();
+  }
+};
+var WeakRefSet = class {
+  constructor() {
+    this.set = /* @__PURE__ */ new Set();
+  }
+  add(value) {
+    for (const ref of this.set) {
+      if (ref.deref() === value) return;
+    }
+    this.set.add(new WeakRef(value));
+  }
+  forEach(callback) {
+    for (const ref of this.set) {
+      const v = ref.deref();
+      if (v === void 0) this.set.delete(ref);
+      else callback(v);
+    }
+  }
+  clear() {
+    this.set.clear();
   }
 };
 
@@ -483,44 +707,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";
@@ -967,6 +1153,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) => {
@@ -988,6 +1175,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 }
@@ -995,6 +1188,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
     );
@@ -1157,7 +1356,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(() => {
     });
@@ -1706,6 +1905,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 }
@@ -1971,6 +2175,7 @@ var OverlayManager = class extends WavedashManager {
         this.toggleOverlay();
       }
     };
+    if (!hasParentFrame()) return;
     this.sdk.iframeMessenger.addEventListener(
       IFRAME_MESSAGE_TYPE5.TAKE_FOCUS,
       takeFocus
@@ -3301,7 +3506,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 {
@@ -3343,6 +3617,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(
@@ -3369,7 +3659,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 {
@@ -3427,7 +3717,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);
@@ -3437,7 +3727,7 @@ var StatsManager = class extends WavedashManager {
         }
       ),
       this.sdk.convexClient.onUpdate(
-        api7.sdk.gameAchievements.listAchievementIdentifiers,
+        api8.sdk.gameAchievements.listAchievementIdentifiers,
         {},
         (ids) => {
           this.knownAchievementIds = new Set(ids);
@@ -3447,7 +3737,7 @@ var StatsManager = class extends WavedashManager {
         }
       ),
       this.sdk.convexClient.onUpdate(
-        api7.sdk.gameAchievements.getMyAchievementsForGame,
+        api8.sdk.gameAchievements.getMyAchievementsForGame,
         {},
         (achievements) => {
           this.loaded.achievements = true;
@@ -3463,7 +3753,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;
@@ -3494,11 +3784,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(() => {
@@ -3575,14 +3865,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,
@@ -3609,7 +3899,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,
@@ -3635,14 +3925,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 {
@@ -3657,7 +3947,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,
@@ -3667,15 +3957,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 {
@@ -5119,6 +5400,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",