fix(player): guard play/pause/removeEventListener against null refs

packages/core/src/runtime/init.ts

@@ -1102,7 +1102,9 @@ export function initSandboxRuntimeModular(): void {
       };
       node.addEventListener("error", onError);
       registerRuntimeCleanup(() => {
-        node.removeEventListener("error", onError);
+        if (typeof node.removeEventListener === "function") {
+          node.removeEventListener("error", onError);
+        }
       });
     }
 
@@ -1232,8 +1234,10 @@ export function initSandboxRuntimeModular(): void {
 
   const unbindMediaMetadataListeners = () => {
     for (const mediaEl of metadataBoundMedia) {
-      mediaEl.removeEventListener("loadedmetadata", scheduleMetadataDurationHydration);
-      mediaEl.removeEventListener("durationchange", scheduleMetadataDurationHydration);
+      if (typeof mediaEl.removeEventListener === "function") {
+        mediaEl.removeEventListener("loadedmetadata", scheduleMetadataDurationHydration);
+        mediaEl.removeEventListener("durationchange", scheduleMetadataDurationHydration);
+      }
     }
     metadataBoundMedia.clear();
   };

packages/core/src/runtime/media.ts

@@ -257,6 +257,7 @@ export function syncRuntimeMedia(params: {
         // seconds. The canplay listener was also racey — the event could
         // fire between `load()` and `addEventListener` attachment, wedging
         // the element waiting for a callback that never came.
+        if (typeof el.play !== "function") continue;
         markPlayRequested(el);
         void el.play().catch((err: unknown) => {
           // If play() rejects — e.g. autoplay blocked, element removed
@@ -274,7 +275,7 @@ export function syncRuntimeMedia(params: {
           if (name === "NotAllowedError") params.onAutoplayBlocked?.();
         });
       } else if (!params.playing && !el.paused) {
-        el.pause();
+        if (typeof el.pause === "function") el.pause();
       }
       continue;
     }
@@ -283,6 +284,6 @@ export function syncRuntimeMedia(params: {
     lastOffset.delete(el);
     strictDriftSamples.delete(el);
     seekLoadRetried.delete(el);
-    if (!el.paused) el.pause();
+    if (!el.paused && typeof el.pause === "function") el.pause();
   }
 }

packages/player/src/parent-media.ts

@@ -98,7 +98,7 @@ export class ParentMediaManager {
   destroy(): void {
     this.teardownObserver();
     for (const m of this._entries) {
-      m.el.pause();
+      if (typeof m.el.pause === "function") m.el.pause();
       m.el.src = "";
     }
     this._entries = [];
@@ -118,13 +118,15 @@ export class ParentMediaManager {
 
   playAll(): void {
     for (const m of this._entries) {
-      if (!m.el.src) continue;
+      if (!m.el.src || typeof m.el.play !== "function") continue;
       m.el.play().catch((err: unknown) => this._reportPlaybackError(err));
     }
   }
 
   pauseAll(): void {
-    for (const m of this._entries) m.el.pause();
+    for (const m of this._entries) {
+      if (typeof m.el.pause === "function") m.el.pause();
+    }
   }
 
   seekAll(timeInSeconds: number): void {
@@ -278,7 +280,7 @@ export class ParentMediaManager {
     // up immediately — bypass the jitter-coalescing gate.
     if (created && this._audioOwner === "parent") {
       this.mirrorTime(this._getCurrentTime(), { force: true });
-      if (!this._isPaused() && created.el.src) {
+      if (!this._isPaused() && created.el.src && typeof created.el.play === "function") {
         created.el.play().catch((err: unknown) => this._reportPlaybackError(err));
       }
     }
@@ -292,7 +294,7 @@ export class ParentMediaManager {
     const idx = this._entries.findIndex((m) => m.el.src === src);
     if (idx === -1) return;
     const entry = this._entries[idx];
-    entry.el.pause();
+    if (typeof entry.el.pause === "function") entry.el.pause();
     entry.el.src = "";
     this._entries.splice(idx, 1);
   }

packages/studio/src/player/components/Player.tsx

@@ -266,11 +266,15 @@ export const Player = forwardRef<HTMLIFrameElement, PlayerProps>(
         iframe.addEventListener("load", handleLoad);
 
         cleanup = () => {
-          iframe.removeEventListener("load", handleLoad);
-          player.removeEventListener("click", preventToggle, { capture: true });
-          player.removeEventListener("shadertransitionstate", handleShaderTransitionState);
-          player.removeEventListener("ready", handleReady);
-          player.removeEventListener("error", handleError);
+          if (typeof iframe.removeEventListener === "function") {
+            iframe.removeEventListener("load", handleLoad);
+          }
+          if (typeof player.removeEventListener === "function") {
+            player.removeEventListener("click", preventToggle, { capture: true });
+            player.removeEventListener("shadertransitionstate", handleShaderTransitionState);
+            player.removeEventListener("ready", handleReady);
+            player.removeEventListener("error", handleError);
+          }
           if (assetPollRef.current) clearInterval(assetPollRef.current);
           assetPollRef.current = null;
           container.removeChild(player);

packages/studio/src/player/components/PlayerControls.tsx

@@ -254,9 +254,11 @@ export const PlayerControls = memo(function PlayerControls({
           /* Already released after the first cleanup — second invocation
              via the window-fallback or visibility path is a no-op throw. */
         }
-        target.removeEventListener("pointermove", onMove);
-        target.removeEventListener("pointerup", onUp);
-        target.removeEventListener("pointercancel", onUp);
+        if (typeof target.removeEventListener === "function") {
+          target.removeEventListener("pointermove", onMove);
+          target.removeEventListener("pointerup", onUp);
+          target.removeEventListener("pointercancel", onUp);
+        }
         window.removeEventListener("pointerup", onUp);
         window.removeEventListener("pointercancel", onUp);
         document.removeEventListener("visibilitychange", onVisibilityChange);

packages/studio/src/player/hooks/usePlaybackKeyboard.ts

@@ -197,10 +197,14 @@ export function usePlaybackKeyboard({
     iframeDoc?.addEventListener("keydown", handleIframeKeyDown, true);
     iframeDoc?.addEventListener("keyup", handleIframeKeyUp, true);
     iframeShortcutCleanupRef.current = () => {
-      iframeWin?.removeEventListener("keydown", handleIframeKeyDown, true);
-      iframeWin?.removeEventListener("keyup", handleIframeKeyUp, true);
-      iframeDoc?.removeEventListener("keydown", handleIframeKeyDown, true);
-      iframeDoc?.removeEventListener("keyup", handleIframeKeyUp, true);
+      if (typeof iframeWin?.removeEventListener === "function") {
+        iframeWin.removeEventListener("keydown", handleIframeKeyDown, true);
+        iframeWin.removeEventListener("keyup", handleIframeKeyUp, true);
+      }
+      if (typeof iframeDoc?.removeEventListener === "function") {
+        iframeDoc.removeEventListener("keydown", handleIframeKeyDown, true);
+        iframeDoc.removeEventListener("keyup", handleIframeKeyUp, true);
+      }
     };
   }, [iframeRef, iframeShortcutCleanupRef]);