@remotion/media 4.0.403 → 4.0.404

package/dist/esm/index.mjs

@@ -1344,6 +1344,27 @@ class MediaPlayer {
   };
 }
 
+// src/on-error.ts
+var callOnErrorAndResolve = ({
+  onError,
+  error,
+  disallowFallback,
+  isClientSideRendering,
+  clientSideError
+}) => {
+  const result = onError?.(error);
+  if (isClientSideRendering) {
+    return ["fail", clientSideError];
+  }
+  if (result) {
+    return [result, error];
+  }
+  if (disallowFallback) {
+    return ["fail", error];
+  }
+  return ["fallback", error];
+};
+
 // src/show-in-timeline.ts
 import { useMemo } from "react";
 import { Internals as Internals4, useVideoConfig } from "remotion";
@@ -1538,7 +1559,8 @@ var AudioForPreviewAssertedShowing = ({
   disallowFallbackToHtml5Audio,
   toneFrequency,
   audioStreamIndex,
-  fallbackHtml5AudioProps
+  fallbackHtml5AudioProps,
+  onError
 }) => {
   const videoConfig = useUnsafeVideoConfig();
   const frame = useCurrentFrame2();
@@ -1637,36 +1659,35 @@ var AudioForPreviewAssertedShowing = ({
         if (result.type === "disposed") {
           return;
         }
-        if (result.type === "unknown-container-format") {
-          if (disallowFallbackToHtml5Audio) {
-            throw new Error(`Unknown container format ${preloadedSrc}, and 'disallowFallbackToHtml5Audio' was set.`);
+        const handleError = (error, fallbackMessage) => {
+          const [action, errorToUse] = callOnErrorAndResolve({
+            onError,
+            error,
+            disallowFallback: disallowFallbackToHtml5Audio,
+            isClientSideRendering: false,
+            clientSideError: error
+          });
+          if (action === "fail") {
+            throw errorToUse;
+          } else {
+            Internals6.Log.warn({ logLevel, tag: "@remotion/media" }, fallbackMessage);
+            setShouldFallbackToNativeAudio(true);
           }
-          Internals6.Log.warn({ logLevel, tag: "@remotion/media" }, `Unknown container format for ${preloadedSrc} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <Html5Audio>`);
-          setShouldFallbackToNativeAudio(true);
+        };
+        if (result.type === "unknown-container-format") {
+          handleError(new Error(`Unknown container format ${preloadedSrc}.`), `Unknown container format for ${preloadedSrc} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <Html5Audio>`);
           return;
         }
         if (result.type === "network-error") {
-          if (disallowFallbackToHtml5Audio) {
-            throw new Error(`Network error fetching ${preloadedSrc}, and 'disallowFallbackToHtml5Audio' was set.`);
-          }
-          Internals6.Log.warn({ logLevel, tag: "@remotion/media" }, `Network error fetching ${preloadedSrc}, falling back to <Html5Audio>`);
-          setShouldFallbackToNativeAudio(true);
+          handleError(new Error(`Network error fetching ${preloadedSrc}.`), `Network error fetching ${preloadedSrc}, falling back to <Html5Audio>`);
           return;
         }
         if (result.type === "cannot-decode") {
-          if (disallowFallbackToHtml5Audio) {
-            throw new Error(`Cannot decode ${preloadedSrc}, and 'disallowFallbackToHtml5Audio' was set.`);
-          }
-          Internals6.Log.warn({ logLevel, tag: "@remotion/media" }, `Cannot decode ${preloadedSrc}, falling back to <Html5Audio>`);
-          setShouldFallbackToNativeAudio(true);
+          handleError(new Error(`Cannot decode ${preloadedSrc}.`), `Cannot decode ${preloadedSrc}, falling back to <Html5Audio>`);
           return;
         }
         if (result.type === "no-tracks") {
-          if (disallowFallbackToHtml5Audio) {
-            throw new Error(`No video or audio tracks found for ${preloadedSrc}, and 'disallowFallbackToHtml5Audio' was set.`);
-          }
-          Internals6.Log.warn({ logLevel, tag: "@remotion/media" }, `No video or audio tracks found for ${preloadedSrc}, falling back to <Html5Audio>`);
-          setShouldFallbackToNativeAudio(true);
+          handleError(new Error(`No video or audio tracks found for ${preloadedSrc}.`), `No video or audio tracks found for ${preloadedSrc}, falling back to <Html5Audio>`);
           return;
         }
         if (result.type === "success") {
@@ -1675,11 +1696,32 @@ var AudioForPreviewAssertedShowing = ({
           Internals6.Log.trace({ logLevel, tag: "@remotion/media" }, `[AudioForPreview] MediaPlayer initialized successfully`);
         }
       }).catch((error) => {
-        Internals6.Log.error({ logLevel, tag: "@remotion/media" }, "[AudioForPreview] Failed to initialize MediaPlayer", error);
-        setShouldFallbackToNativeAudio(true);
+        const [action, errorToUse] = callOnErrorAndResolve({
+          onError,
+          error,
+          disallowFallback: disallowFallbackToHtml5Audio,
+          isClientSideRendering: false,
+          clientSideError: error
+        });
+        if (action === "fail") {
+          throw errorToUse;
+        } else {
+          Internals6.Log.error({ logLevel, tag: "@remotion/media" }, "[AudioForPreview] Failed to initialize MediaPlayer", error);
+          setShouldFallbackToNativeAudio(true);
+        }
       });
     } catch (error) {
-      Internals6.Log.error({ logLevel, tag: "@remotion/media" }, "[AudioForPreview] MediaPlayer initialization failed", error);
+      const [action, errorToUse] = callOnErrorAndResolve({
+        error,
+        onError,
+        disallowFallback: disallowFallbackToHtml5Audio,
+        isClientSideRendering: false,
+        clientSideError: error
+      });
+      if (action === "fail") {
+        throw errorToUse;
+      }
+      Internals6.Log.error({ logLevel, tag: "@remotion/media" }, "[AudioForPreview] MediaPlayer initialization failed", errorToUse);
       setShouldFallbackToNativeAudio(true);
     }
     return () => {
@@ -1700,7 +1742,8 @@ var AudioForPreviewAssertedShowing = ({
     videoConfig.fps,
     audioStreamIndex,
     disallowFallbackToHtml5Audio,
-    buffer
+    buffer,
+    onError
   ]);
   useLayoutEffect(() => {
     const audioPlayer = mediaPlayerRef.current;
@@ -1827,7 +1870,8 @@ var AudioForPreview = ({
   disallowFallbackToHtml5Audio,
   toneFrequency,
   audioStreamIndex,
-  fallbackHtml5AudioProps
+  fallbackHtml5AudioProps,
+  onError
 }) => {
   const preloadedSrc = usePreload(src);
   const defaultLogLevel = Internals6.useLogLevel();
@@ -1874,6 +1918,7 @@ var AudioForPreview = ({
     stack,
     disallowFallbackToHtml5Audio: disallowFallbackToHtml5Audio ?? false,
     toneFrequency,
+    onError,
     fallbackHtml5AudioProps
   });
 };
@@ -2498,7 +2543,7 @@ var makeKeyframeManager = () => {
     }
     return { mostInThePastBank, numberOfBanks };
   };
-  const deleteOldestKeyframeBank = async (logLevel) => {
+  const deleteOldestKeyframeBank = (logLevel) => {
     const {
       mostInThePastBank: {
         bank: mostInThePastBank,
@@ -2506,31 +2551,31 @@ var makeKeyframeManager = () => {
         index: mostInThePastIndex
       },
       numberOfBanks
-    } = await getTheKeyframeBankMostInThePast();
+    } = getTheKeyframeBankMostInThePast();
     if (numberOfBanks < 2) {
       return { finish: true };
     }
     if (mostInThePastBank) {
       const range = mostInThePastBank.getRangeOfTimestamps();
       const { framesDeleted } = mostInThePastBank.prepareForDeletion(logLevel, "deleted oldest keyframe bank to stay under max cache size");
-      delete sources[mostInThePastSrc][mostInThePastIndex];
+      sources[mostInThePastSrc].splice(mostInThePastIndex, 1);
       if (range) {
         Internals10.Log.verbose({ logLevel, tag: "@remotion/media" }, `Deleted ${framesDeleted} frames for src ${mostInThePastSrc} from ${range?.firstTimestamp}sec to ${range?.lastTimestamp}sec to free up memory.`);
       }
     }
     return { finish: false };
   };
-  const ensureToStayUnderMaxCacheSize = async (logLevel, maxCacheSize) => {
-    let cacheStats = await getTotalCacheStats();
+  const ensureToStayUnderMaxCacheSize = (logLevel, maxCacheSize) => {
+    let cacheStats = getTotalCacheStats();
     let attempts = 0;
     const maxAttempts = 3;
     while (cacheStats.totalSize > maxCacheSize && attempts < maxAttempts) {
-      const { finish } = await deleteOldestKeyframeBank(logLevel);
+      const { finish } = deleteOldestKeyframeBank(logLevel);
       if (finish) {
         break;
       }
       Internals10.Log.verbose({ logLevel, tag: "@remotion/media" }, "Deleted oldest keyframe bank to stay under max cache size", (cacheStats.totalSize / 1024 / 1024).toFixed(1), "out of", (maxCacheSize / 1024 / 1024).toFixed(1));
-      cacheStats = await getTotalCacheStats();
+      cacheStats = getTotalCacheStats();
       attempts++;
     }
     if (cacheStats.totalSize > maxCacheSize && attempts >= maxAttempts) {
@@ -2610,7 +2655,7 @@ var makeKeyframeManager = () => {
     logLevel,
     maxCacheSize
   }) => {
-    await ensureToStayUnderMaxCacheSize(logLevel, maxCacheSize);
+    ensureToStayUnderMaxCacheSize(logLevel, maxCacheSize);
     clearKeyframeBanksBeforeTime({
       timestampInSeconds: timestamp,
       src,
@@ -2662,8 +2707,8 @@ var makeKeyframeManager = () => {
 var SAFE_WINDOW_OF_MONOTONICITY = 0.2;
 var keyframeManager = makeKeyframeManager();
 var audioManager = makeAudioManager();
-var getTotalCacheStats = async () => {
-  const keyframeManagerCacheStats = await keyframeManager.getCacheStats();
+var getTotalCacheStats = () => {
+  const keyframeManagerCacheStats = keyframeManager.getCacheStats();
   const audioManagerCacheStats = audioManager.getCacheStats();
   return {
     count: keyframeManagerCacheStats.count + audioManagerCacheStats.count,
@@ -3697,7 +3742,8 @@ var AudioForRendering = ({
   disallowFallbackToHtml5Audio,
   toneFrequency,
   trimAfter,
-  trimBefore
+  trimBefore,
+  onError
 }) => {
   const defaultLogLevel = Internals14.useLogLevel();
   const logLevel = overriddenLogLevel ?? defaultLogLevel;
@@ -3763,52 +3809,33 @@ var AudioForRendering = ({
       fps,
       maxCacheSize
     }).then((result) => {
-      if (result.type === "unknown-container-format") {
-        if (environment.isClientSideRendering) {
-          cancelRender2(new Error(`Cannot render audio "${src}": Unknown container format. See supported formats: https://www.remotion.dev/docs/mediabunny/formats`));
-          return;
-        }
-        if (disallowFallbackToHtml5Audio) {
-          cancelRender2(new Error(`Unknown container format ${src}, and 'disallowFallbackToHtml5Audio' was set. Failing the render.`));
+      const handleError = (error, clientSideError, fallbackMessage) => {
+        const [action, errorToUse] = callOnErrorAndResolve({
+          onError,
+          error,
+          disallowFallback: disallowFallbackToHtml5Audio ?? false,
+          isClientSideRendering: environment.isClientSideRendering,
+          clientSideError
+        });
+        if (action === "fail") {
+          cancelRender2(errorToUse);
         }
-        Internals14.Log.warn({
-          logLevel,
-          tag: "@remotion/media"
-        }, `Unknown container format for ${src} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <Html5Audio>`);
+        Internals14.Log.warn({ logLevel, tag: "@remotion/media" }, fallbackMessage);
         setReplaceWithHtml5Audio(true);
+      };
+      if (result.type === "unknown-container-format") {
+        handleError(new Error(`Unknown container format ${src}.`), new Error(`Cannot render audio "${src}": Unknown container format. See supported formats: https://www.remotion.dev/docs/mediabunny/formats`), `Unknown container format for ${src} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <Html5Audio>`);
         return;
       }
       if (result.type === "cannot-decode") {
-        if (environment.isClientSideRendering) {
-          cancelRender2(new Error(`Cannot render audio "${src}": The audio could not be decoded by the browser.`));
-          return;
-        }
-        if (disallowFallbackToHtml5Audio) {
-          cancelRender2(new Error(`Cannot decode ${src}, and 'disallowFallbackToHtml5Audio' was set. Failing the render.`));
-        }
-        Internals14.Log.warn({
-          logLevel,
-          tag: "@remotion/media"
-        }, `Cannot decode ${src}, falling back to <Html5Audio>`);
-        setReplaceWithHtml5Audio(true);
+        handleError(new Error(`Cannot decode ${src}.`), new Error(`Cannot render audio "${src}": The audio could not be decoded by the browser.`), `Cannot decode ${src}, falling back to <Html5Audio>`);
         return;
       }
       if (result.type === "cannot-decode-alpha") {
         throw new Error(`Cannot decode alpha component for ${src}, and 'disallowFallbackToHtml5Audio' was set. But this should never happen, since you used the <Audio> tag. Please report this as a bug.`);
       }
       if (result.type === "network-error") {
-        if (environment.isClientSideRendering) {
-          cancelRender2(new Error(`Cannot render audio "${src}": Network error while fetching the audio (possibly CORS).`));
-          return;
-        }
-        if (disallowFallbackToHtml5Audio) {
-          cancelRender2(new Error(`Cannot decode ${src}, and 'disallowFallbackToHtml5Audio' was set. Failing the render.`));
-        }
-        Internals14.Log.warn({
-          logLevel,
-          tag: "@remotion/media"
-        }, `Network error fetching ${src}, falling back to <Html5Audio>`);
-        setReplaceWithHtml5Audio(true);
+        handleError(new Error(`Network error fetching ${src}.`), new Error(`Cannot render audio "${src}": Network error while fetching the audio (possibly CORS).`), `Network error fetching ${src}, falling back to <Html5Audio>`);
         return;
       }
       const { audio, durationInSeconds: assetDurationInSeconds } = result;
@@ -3873,7 +3900,8 @@ var AudioForRendering = ({
     trimBefore,
     replaceWithHtml5Audio,
     maxCacheSize,
-    audioEnabled
+    audioEnabled,
+    onError
   ]);
   if (replaceWithHtml5Audio) {
     return /* @__PURE__ */ jsx2(Html5Audio, {
@@ -3974,7 +4002,8 @@ var VideoForPreviewAssertedShowing = ({
   fallbackOffthreadVideoProps,
   audioStreamIndex,
   debugOverlay,
-  headless
+  headless,
+  onError
 }) => {
   const src = usePreload2(unpreloadedSrc);
   const canvasRef = useRef2(null);
@@ -4073,36 +4102,34 @@ var VideoForPreviewAssertedShowing = ({
         if (result.type === "disposed") {
           return;
         }
-        if (result.type === "unknown-container-format") {
-          if (disallowFallbackToOffthreadVideo) {
-            throw new Error(`Unknown container format ${preloadedSrc}, and 'disallowFallbackToOffthreadVideo' was set.`);
+        const handleError = (error, fallbackMessage) => {
+          const [action, errorToUse] = callOnErrorAndResolve({
+            onError,
+            error,
+            disallowFallback: disallowFallbackToOffthreadVideo,
+            isClientSideRendering: false,
+            clientSideError: error
+          });
+          if (action === "fail") {
+            throw errorToUse;
           }
-          Internals16.Log.warn({ logLevel, tag: "@remotion/media" }, `Unknown container format for ${preloadedSrc} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <OffthreadVideo>`);
+          Internals16.Log.warn({ logLevel, tag: "@remotion/media" }, fallbackMessage);
           setShouldFallbackToNativeVideo(true);
+        };
+        if (result.type === "unknown-container-format") {
+          handleError(new Error(`Unknown container format ${preloadedSrc}.`), `Unknown container format for ${preloadedSrc} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <OffthreadVideo>`);
           return;
         }
         if (result.type === "network-error") {
-          if (disallowFallbackToOffthreadVideo) {
-            throw new Error(`Network error fetching ${preloadedSrc}, and 'disallowFallbackToOffthreadVideo' was set.`);
-          }
-          Internals16.Log.warn({ logLevel, tag: "@remotion/media" }, `Network error fetching ${preloadedSrc}, falling back to <OffthreadVideo>`);
-          setShouldFallbackToNativeVideo(true);
+          handleError(new Error(`Network error fetching ${preloadedSrc}.`), `Network error fetching ${preloadedSrc}, falling back to <OffthreadVideo>`);
           return;
         }
         if (result.type === "cannot-decode") {
-          if (disallowFallbackToOffthreadVideo) {
-            throw new Error(`Cannot decode ${preloadedSrc}, and 'disallowFallbackToOffthreadVideo' was set.`);
-          }
-          Internals16.Log.warn({ logLevel, tag: "@remotion/media" }, `Cannot decode ${preloadedSrc}, falling back to <OffthreadVideo>`);
-          setShouldFallbackToNativeVideo(true);
+          handleError(new Error(`Cannot decode ${preloadedSrc}.`), `Cannot decode ${preloadedSrc}, falling back to <OffthreadVideo>`);
           return;
         }
         if (result.type === "no-tracks") {
-          if (disallowFallbackToOffthreadVideo) {
-            throw new Error(`No video or audio tracks found for ${preloadedSrc}, and 'disallowFallbackToOffthreadVideo' was set.`);
-          }
-          Internals16.Log.warn({ logLevel, tag: "@remotion/media" }, `No video or audio tracks found for ${preloadedSrc}, falling back to <OffthreadVideo>`);
-          setShouldFallbackToNativeVideo(true);
+          handleError(new Error(`No video or audio tracks found for ${preloadedSrc}.`), `No video or audio tracks found for ${preloadedSrc}, falling back to <OffthreadVideo>`);
           return;
         }
         if (result.type === "success") {
@@ -4110,11 +4137,31 @@ var VideoForPreviewAssertedShowing = ({
           setMediaDurationInSeconds(result.durationInSeconds);
         }
       }).catch((error) => {
-        Internals16.Log.error({ logLevel, tag: "@remotion/media" }, "[VideoForPreview] Failed to initialize MediaPlayer", error);
+        const [action, errorToUse] = callOnErrorAndResolve({
+          onError,
+          error,
+          disallowFallback: disallowFallbackToOffthreadVideo,
+          isClientSideRendering: false,
+          clientSideError: error
+        });
+        if (action === "fail") {
+          throw errorToUse;
+        }
+        Internals16.Log.error({ logLevel, tag: "@remotion/media" }, "[VideoForPreview] Failed to initialize MediaPlayer", errorToUse);
         setShouldFallbackToNativeVideo(true);
       });
     } catch (error) {
-      Internals16.Log.error({ logLevel, tag: "@remotion/media" }, "[VideoForPreview] MediaPlayer initialization failed", error);
+      const [action, errorToUse] = callOnErrorAndResolve({
+        error,
+        onError,
+        disallowFallback: disallowFallbackToOffthreadVideo,
+        isClientSideRendering: false,
+        clientSideError: error
+      });
+      if (action === "fail") {
+        throw errorToUse;
+      }
+      Internals16.Log.error({ logLevel, tag: "@remotion/media" }, "[VideoForPreview] MediaPlayer initialization failed", errorToUse);
       setShouldFallbackToNativeVideo(true);
     }
     return () => {
@@ -4135,7 +4182,8 @@ var VideoForPreviewAssertedShowing = ({
     loop,
     preloadedSrc,
     sharedAudioContext,
-    videoConfig.fps
+    videoConfig.fps,
+    onError
   ]);
   const classNameValue = useMemo4(() => {
     return [Internals16.OBJECTFIT_CONTAIN_CLASS_NAME, className].filter(Internals16.truthy).join(" ");
@@ -4348,7 +4396,8 @@ var VideoForRendering = ({
   toneFrequency,
   trimAfterValue,
   trimBeforeValue,
-  headless
+  headless,
+  onError
 }) => {
   if (!src) {
     throw new TypeError("No `src` was passed to <Video>.");
@@ -4417,64 +4466,43 @@ var VideoForRendering = ({
       fps,
       maxCacheSize
     }).then((result) => {
-      if (result.type === "unknown-container-format") {
+      const handleError = (err, clientSideError, fallbackMessage, mediaDurationInSeconds) => {
         if (environment.isClientSideRendering) {
-          cancelRender3(new Error(`Cannot render video "${src}": Unknown container format. See supported formats: https://www.remotion.dev/docs/mediabunny/formats`));
+          cancelRender3(clientSideError);
           return;
         }
-        if (disallowFallbackToOffthreadVideo) {
-          cancelRender3(new Error(`Unknown container format ${src}, and 'disallowFallbackToOffthreadVideo' was set. Failing the render.`));
-        }
-        if (window.remotion_isMainTab) {
-          Internals17.Log.info({ logLevel, tag: "@remotion/media" }, `Unknown container format for ${src} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <OffthreadVideo>`);
-        }
-        setReplaceWithOffthreadVideo({ durationInSeconds: null });
-        return;
-      }
-      if (result.type === "cannot-decode") {
-        if (environment.isClientSideRendering) {
-          cancelRender3(new Error(`Cannot render video "${src}": The video could not be decoded by the browser.`));
+        const [action, errorToUse] = callOnErrorAndResolve({
+          onError,
+          error: err,
+          disallowFallback: disallowFallbackToOffthreadVideo,
+          isClientSideRendering: environment.isClientSideRendering,
+          clientSideError: err
+        });
+        if (action === "fail") {
+          cancelRender3(errorToUse);
           return;
         }
-        if (disallowFallbackToOffthreadVideo) {
-          cancelRender3(new Error(`Cannot decode ${src}, and 'disallowFallbackToOffthreadVideo' was set. Failing the render.`));
-        }
         if (window.remotion_isMainTab) {
-          Internals17.Log.warn({ logLevel, tag: "@remotion/media" }, `Cannot decode ${src}, falling back to <OffthreadVideo>`);
+          Internals17.Log.warn({ logLevel, tag: "@remotion/media" }, fallbackMessage);
         }
         setReplaceWithOffthreadVideo({
-          durationInSeconds: result.durationInSeconds
+          durationInSeconds: mediaDurationInSeconds
         });
+      };
+      if (result.type === "unknown-container-format") {
+        handleError(new Error(`Unknown container format ${src}.`), new Error(`Cannot render video "${src}": Unknown container format. See supported formats: https://www.remotion.dev/docs/mediabunny/formats`), `Unknown container format for ${src} (Supported formats: https://www.remotion.dev/docs/mediabunny/formats), falling back to <OffthreadVideo>`, null);
+        return;
+      }
+      if (result.type === "cannot-decode") {
+        handleError(new Error(`Cannot decode ${src}.`), new Error(`Cannot render video "${src}": The video could not be decoded by the browser.`), `Cannot decode ${src}, falling back to <OffthreadVideo>`, result.durationInSeconds);
         return;
       }
       if (result.type === "cannot-decode-alpha") {
-        if (environment.isClientSideRendering) {
-          cancelRender3(new Error(`Cannot render video "${src}": The alpha channel could not be decoded by the browser.`));
-          return;
-        }
-        if (disallowFallbackToOffthreadVideo) {
-          cancelRender3(new Error(`Cannot decode alpha component for ${src}, and 'disallowFallbackToOffthreadVideo' was set. Failing the render.`));
-        }
-        if (window.remotion_isMainTab) {
-          Internals17.Log.info({ logLevel, tag: "@remotion/media" }, `Cannot decode alpha component for ${src}, falling back to <OffthreadVideo>`);
-        }
-        setReplaceWithOffthreadVideo({
-          durationInSeconds: result.durationInSeconds
-        });
+        handleError(new Error(`Cannot decode alpha component for ${src}.`), new Error(`Cannot render video "${src}": The alpha channel could not be decoded by the browser.`), `Cannot decode alpha component for ${src}, falling back to <OffthreadVideo>`, result.durationInSeconds);
         return;
       }
       if (result.type === "network-error") {
-        if (environment.isClientSideRendering) {
-          cancelRender3(new Error(`Cannot render video "${src}": Network error while fetching the video (possibly CORS).`));
-          return;
-        }
-        if (disallowFallbackToOffthreadVideo) {
-          cancelRender3(new Error(`Cannot decode ${src}, and 'disallowFallbackToOffthreadVideo' was set. Failing the render.`));
-        }
-        if (window.remotion_isMainTab) {
-          Internals17.Log.warn({ logLevel, tag: "@remotion/media" }, `Network error fetching ${src} (no CORS?), falling back to <OffthreadVideo>`);
-        }
-        setReplaceWithOffthreadVideo({ durationInSeconds: null });
+        handleError(new Error(`Network error fetching ${src}.`), new Error(`Cannot render video "${src}": Network error while fetching the video (possibly CORS).`), `Network error fetching ${src} (no CORS?), falling back to <OffthreadVideo>`, null);
         return;
       }
       const {
@@ -4567,7 +4595,8 @@ var VideoForRendering = ({
     videoEnabled,
     maxCacheSize,
     cancelRender3,
-    headless
+    headless,
+    onError
   ]);
   const classNameValue = useMemo5(() => {
     return [Internals17.OBJECTFIT_CONTAIN_CLASS_NAME, className].filter(Internals17.truthy).join(" ");
@@ -4662,7 +4691,8 @@ var InnerVideo = ({
   toneFrequency,
   showInTimeline,
   debugOverlay,
-  headless
+  headless,
+  onError
 }) => {
   const environment = useRemotionEnvironment4();
   if (typeof src !== "string") {
@@ -4703,7 +4733,8 @@ var InnerVideo = ({
       toneFrequency,
       trimAfterValue,
       trimBeforeValue,
-      headless
+      headless,
+      onError
     });
   }
   return /* @__PURE__ */ jsx6(VideoForPreview, {
@@ -4726,7 +4757,8 @@ var InnerVideo = ({
     disallowFallbackToOffthreadVideo,
     fallbackOffthreadVideoProps,
     debugOverlay: debugOverlay ?? false,
-    headless: headless ?? false
+    headless: headless ?? false,
+    onError
   });
 };
 var Video = ({
@@ -4752,7 +4784,8 @@ var Video = ({
   stack,
   toneFrequency,
   debugOverlay,
-  headless
+  headless,
+  onError
 }) => {
   const fallbackLogLevel = Internals18.useLogLevel();
   return /* @__PURE__ */ jsx6(InnerVideo, {
@@ -4778,7 +4811,8 @@ var Video = ({
     toneFrequency: toneFrequency ?? 1,
     stack,
     debugOverlay: debugOverlay ?? false,
-    headless: headless ?? false
+    headless: headless ?? false,
+    onError
   });
 };
 Internals18.addSequenceStackTraces(Video);

package/dist/extract-frame-and-audio.d.ts

@@ -1,9 +1,8 @@
-import type { LogLevel } from 'remotion';
 import type { ExtractFrameViaBroadcastChannelResult } from './video-extraction/extract-frame-via-broadcast-channel';
 export declare const extractFrameAndAudio: ({ src, timeInSeconds, logLevel, durationInSeconds, playbackRate, includeAudio, includeVideo, loop, audioStreamIndex, trimAfter, trimBefore, fps, maxCacheSize, }: {
     src: string;
     timeInSeconds: number;
-    logLevel: LogLevel;
+    logLevel: "error" | "info" | "trace" | "verbose" | "warn";
     durationInSeconds: number;
     playbackRate: number;
     includeAudio: boolean;

package/dist/get-sink.d.ts

@@ -1,7 +1,6 @@
-import type { LogLevel } from 'remotion';
 import type { GetSink } from './video-extraction/get-frames-since-keyframe';
 export declare const sinkPromises: Record<string, Promise<GetSink>>;
-export declare const getSink: (src: string, logLevel: LogLevel) => Promise<{
+export declare const getSink: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn") => Promise<{
     getVideo: () => Promise<import("./video-extraction/get-frames-since-keyframe").VideoSinkResult>;
     getAudio: (index: number) => Promise<import("./video-extraction/get-frames-since-keyframe").AudioSinkResult>;
     actualMatroskaTimestamps: {

package/dist/index.d.ts

@@ -10,5 +10,6 @@ export declare const experimental_Audio: import("react").FC<import(".").AudioPro
 export declare const experimental_Video: import("react").FC<import(".").VideoProps>;
 export { AudioForPreview } from './audio/audio-for-preview';
 export { AudioProps, FallbackHtml5AudioProps } from './audio/props';
-export { VideoProps } from './video/props';
+export { MediaErrorAction } from './on-error';
+export { FallbackOffthreadVideoProps, VideoProps } from './video/props';
 export { Audio, Video };

package/dist/media-player.d.ts

@@ -42,7 +42,7 @@ export declare class MediaPlayer {
     private isPremounting;
     private isPostmounting;
     private seekPromiseChain;
-    constructor({ canvas, src, logLevel, sharedAudioContext, loop, trimBefore, trimAfter, playbackRate, globalPlaybackRate, audioStreamIndex, fps, debugOverlay, bufferState, isPremounting, isPostmounting, onVideoFrameCallback, playing, }: {
+    constructor({ canvas, src, logLevel, sharedAudioContext, loop, trimBefore, trimAfter, playbackRate, globalPlaybackRate, audioStreamIndex, fps, debugOverlay, bufferState, isPremounting, isPostmounting, onVideoFrameCallback, playing }: {
         canvas: HTMLCanvasElement | OffscreenCanvas | null;
         src: string;
         logLevel: LogLevel;

package/dist/on-error.d.ts

@@ -0,0 +1,12 @@
+export type MediaErrorEvent = {
+    error: Error;
+};
+export type MediaErrorAction = 'fallback' | 'fail';
+export type MediaOnError = (error: Error) => MediaErrorAction | undefined;
+export declare const callOnErrorAndResolve: ({ onError, error, disallowFallback, isClientSideRendering, clientSideError, }: {
+    onError: MediaOnError | undefined;
+    error: Error;
+    clientSideError: Error;
+    disallowFallback: boolean;
+    isClientSideRendering: boolean;
+}) => [MediaErrorAction, Error];

package/dist/show-in-timeline.d.ts

@@ -1,8 +1,8 @@
-import type { _InternalTypes } from 'remotion';
+import type { LoopDisplay } from 'remotion';
 export declare const useLoopDisplay: ({ loop, mediaDurationInSeconds, playbackRate, trimAfter, trimBefore, }: {
     loop: boolean;
     mediaDurationInSeconds: number | null;
     trimAfter: number | undefined;
     trimBefore: number | undefined;
     playbackRate: number;
-}) => _InternalTypes["LoopDisplay"] | undefined;
+}) => LoopDisplay | undefined;

package/dist/use-media-in-timeline.d.ts

@@ -1,4 +1,4 @@
-import type { _InternalTypes } from 'remotion';
+import type { LoopDisplay } from 'remotion';
 import { type VolumeProp } from 'remotion';
 export declare const useMediaInTimeline: ({ volume, mediaVolume, src, mediaType, playbackRate, displayName, stack, showInTimeline, premountDisplay, postmountDisplay, loopDisplay, trimBefore, trimAfter, }: {
     volume: VolumeProp | undefined;
@@ -11,7 +11,7 @@ export declare const useMediaInTimeline: ({ volume, mediaVolume, src, mediaType,
     showInTimeline: boolean;
     premountDisplay: number | null;
     postmountDisplay: number | null;
-    loopDisplay: _InternalTypes["LoopDisplay"] | undefined;
+    loopDisplay: LoopDisplay | undefined;
     trimBefore: number | undefined;
     trimAfter: number | undefined;
 }) => {