@remotion/media 4.0.506 → 4.0.508

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

@@ -1,6 +1,6 @@
 import type { MediaRequestInit } from './request-init';
 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, credentials, requestInit, }: {
+export declare const extractFrameAndAudio: ({ src, timeInSeconds, logLevel, durationInSeconds, playbackRate, includeAudio, includeVideo, loop, audioStreamIndex, trimAfter, trimBefore, fps, maxCacheSize, credentials, requestInit, mediaCache, }: {
     src: string;
     timeInSeconds: number;
     logLevel: "error" | "info" | "trace" | "verbose" | "warn";
@@ -16,4 +16,98 @@ export declare const extractFrameAndAudio: ({ src, timeInSeconds, logLevel, dura
     maxCacheSize: number;
     credentials: RequestCredentials | undefined;
     requestInit?: MediaRequestInit | undefined;
+    mediaCache: {
+        sinkManager: {
+            getSink: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit: MediaRequestInit | undefined) => Promise<{
+                getVideo: () => Promise<import("./video-extraction/get-frames-since-keyframe").VideoSinkResult>;
+                getAudio: (index: number | null) => Promise<import("./video-extraction/get-frames-since-keyframe").AudioSinkResult>;
+                actualMatroskaTimestamps: {
+                    observeTimestamp: (startTime: number) => void;
+                    getRealTimestamp: (observedTimestamp: number) => number | null;
+                };
+                isMatroska: boolean;
+                getDuration: () => Promise<number>;
+            }>;
+            dispose: () => void;
+        };
+        keyframeManager: {
+            requestKeyframeBank: ({ timestamp, videoSampleSink, src, logLevel, maxCacheSize, fps, }: {
+                timestamp: number;
+                videoSampleSink: import("mediabunny").VideoSampleSink;
+                src: string;
+                logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+                maxCacheSize: number;
+                fps: number;
+            }) => Promise<import("./video-extraction/keyframe-bank").KeyframeBank | null>;
+            getCacheStats: () => {
+                count: number;
+                totalSize: number;
+            };
+            clearAll: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+            dispose: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+        };
+        audioManager: {
+            getIterator: ({ src, timeInSeconds, audioSampleSink, isMatroska, actualMatroskaTimestamps, logLevel, maxCacheSize, }: {
+                src: string;
+                timeInSeconds: number;
+                audioSampleSink: import("mediabunny").AudioSampleSink;
+                isMatroska: boolean;
+                actualMatroskaTimestamps: {
+                    observeTimestamp: (startTime: number) => void;
+                    getRealTimestamp: (observedTimestamp: number) => number | null;
+                };
+                logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+                maxCacheSize: number;
+            }) => Promise<{
+                src: string;
+                getSamples: (ts: number, dur: number) => Promise<import("mediabunny").AudioSample[]>;
+                waitForCompletion: () => Promise<boolean>;
+                canSatisfyRequestedTime: (timestamp: number) => boolean;
+                logOpenFrames: () => void;
+                getCacheStats: () => {
+                    count: number;
+                    size: number;
+                };
+                getLastUsed: () => number;
+                prepareForDeletion: () => void;
+                startTimestamp: number;
+                clearBeforeThreshold: (threshold: number) => void;
+                getOldestTimestamp: () => number;
+                getNewestTimestamp: () => number | null;
+            }>;
+            getCacheStats: () => {
+                count: number;
+                totalSize: number;
+            };
+            getIteratorMostInThePast: () => {
+                src: string;
+                getSamples: (ts: number, dur: number) => Promise<import("mediabunny").AudioSample[]>;
+                waitForCompletion: () => Promise<boolean>;
+                canSatisfyRequestedTime: (timestamp: number) => boolean;
+                logOpenFrames: () => void;
+                getCacheStats: () => {
+                    count: number;
+                    size: number;
+                };
+                getLastUsed: () => number;
+                prepareForDeletion: () => void;
+                startTimestamp: number;
+                clearBeforeThreshold: (threshold: number) => void;
+                getOldestTimestamp: () => number;
+                getNewestTimestamp: () => number | null;
+            } | null;
+            logOpenFrames: () => void;
+            deleteDuplicateIterators: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+            clearAll: () => void;
+            dispose: () => void;
+        };
+        getTotalCacheStats: () => {
+            count: number;
+            totalSize: number;
+        };
+        isDisposed: () => boolean;
+        queueFrameExtraction: <T>(extract: () => Promise<T>) => Promise<T>;
+        queueAudioExtraction: <T>(extract: () => Promise<T>) => Promise<T>;
+        dispose: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+    };
 }) => Promise<ExtractFrameViaBroadcastChannelResult>;

package/dist/get-shared-input.d.ts

@@ -1,9 +1,10 @@
 import { Input } from 'mediabunny';
 import { type MediaRequestInit } from './request-init';
-export declare const acquireSharedInput: ({ src, credentials, requestInit, }: {
+export declare const acquireSharedInput: ({ src, credentials, requestInit, logLevel, }: {
     src: string;
     credentials: RequestCredentials | undefined;
     requestInit: MediaRequestInit | undefined;
+    logLevel: "error" | "info" | "trace" | "verbose" | "warn";
 }) => {
     input: Input<import("mediabunny").Source>;
     cacheKey: string;

package/dist/get-sink.d.ts

@@ -1,18 +1,20 @@
 import { type MediaRequestInit } from './request-init';
-import type { GetSink } from './video-extraction/get-frames-since-keyframe';
-export declare const sinkPromises: Record<string, Promise<GetSink>>;
 export declare const getSinkCacheKey: ({ src, credentials, requestInit, }: {
     src: string;
     credentials: RequestCredentials | undefined;
     requestInit: MediaRequestInit | undefined;
 }) => string;
-export declare const getSink: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit: MediaRequestInit | undefined) => Promise<{
-    getVideo: () => Promise<import("./video-extraction/get-frames-since-keyframe").VideoSinkResult>;
-    getAudio: (index: number | null) => Promise<import("./video-extraction/get-frames-since-keyframe").AudioSinkResult>;
-    actualMatroskaTimestamps: {
-        observeTimestamp: (startTime: number) => void;
-        getRealTimestamp: (observedTimestamp: number) => number | null;
-    };
-    isMatroska: boolean;
-    getDuration: () => Promise<number>;
-}>;
+export declare const makeSinkManager: () => {
+    getSink: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit: MediaRequestInit | undefined) => Promise<{
+        getVideo: () => Promise<import("./video-extraction/get-frames-since-keyframe").VideoSinkResult>;
+        getAudio: (index: number | null) => Promise<import("./video-extraction/get-frames-since-keyframe").AudioSinkResult>;
+        actualMatroskaTimestamps: {
+            observeTimestamp: (startTime: number) => void;
+            getRealTimestamp: (observedTimestamp: number) => number | null;
+        };
+        isMatroska: boolean;
+        getDuration: () => Promise<number>;
+    }>;
+    dispose: () => void;
+};
+export type SinkManager = ReturnType<typeof makeSinkManager>;

package/dist/max-cache-size.d.ts

@@ -0,0 +1,3 @@
+export declare const getMaxVideoCacheSize: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => number;
+export declare const getMaxSourceCacheSizeFromBudget: (budget: number) => number;
+export declare const getMaxSourceCacheSize: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => number;

package/dist/video-extraction/extract-frame-via-broadcast-channel.d.ts

@@ -19,7 +19,7 @@ export type ExtractFrameViaBroadcastChannelResult = {
 } | {
     type: 'unknown-container-format';
 };
-export declare const extractFrameViaBroadcastChannel: ({ src, timeInSeconds, logLevel, durationInSeconds, playbackRate, includeAudio, includeVideo, isClientSideRendering, loop, audioStreamIndex, trimAfter, trimBefore, fps, maxCacheSize, credentials, requestInit, }: {
+export declare const extractFrameViaBroadcastChannel: ({ src, timeInSeconds, logLevel, durationInSeconds, playbackRate, includeAudio, includeVideo, isClientSideRendering, loop, audioStreamIndex, trimAfter, trimBefore, fps, maxCacheSize, credentials, requestInit, mediaCache, }: {
     src: string;
     timeInSeconds: number;
     durationInSeconds: number;
@@ -36,4 +36,98 @@ export declare const extractFrameViaBroadcastChannel: ({ src, timeInSeconds, log
     maxCacheSize: number;
     credentials: RequestCredentials | undefined;
     requestInit?: MediaRequestInit | undefined;
+    mediaCache: {
+        sinkManager: {
+            getSink: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit: MediaRequestInit | undefined) => Promise<{
+                getVideo: () => Promise<import("./get-frames-since-keyframe").VideoSinkResult>;
+                getAudio: (index: number | null) => Promise<import("./get-frames-since-keyframe").AudioSinkResult>;
+                actualMatroskaTimestamps: {
+                    observeTimestamp: (startTime: number) => void;
+                    getRealTimestamp: (observedTimestamp: number) => number | null;
+                };
+                isMatroska: boolean;
+                getDuration: () => Promise<number>;
+            }>;
+            dispose: () => void;
+        };
+        keyframeManager: {
+            requestKeyframeBank: ({ timestamp, videoSampleSink, src, logLevel, maxCacheSize, fps, }: {
+                timestamp: number;
+                videoSampleSink: import("mediabunny").VideoSampleSink;
+                src: string;
+                logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+                maxCacheSize: number;
+                fps: number;
+            }) => Promise<import("./keyframe-bank").KeyframeBank | null>;
+            getCacheStats: () => {
+                count: number;
+                totalSize: number;
+            };
+            clearAll: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+            dispose: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+        };
+        audioManager: {
+            getIterator: ({ src, timeInSeconds, audioSampleSink, isMatroska, actualMatroskaTimestamps, logLevel, maxCacheSize, }: {
+                src: string;
+                timeInSeconds: number;
+                audioSampleSink: import("mediabunny").AudioSampleSink;
+                isMatroska: boolean;
+                actualMatroskaTimestamps: {
+                    observeTimestamp: (startTime: number) => void;
+                    getRealTimestamp: (observedTimestamp: number) => number | null;
+                };
+                logLevel: "error" | "info" | "trace" | "verbose" | "warn";
+                maxCacheSize: number;
+            }) => Promise<{
+                src: string;
+                getSamples: (ts: number, dur: number) => Promise<import("mediabunny").AudioSample[]>;
+                waitForCompletion: () => Promise<boolean>;
+                canSatisfyRequestedTime: (timestamp: number) => boolean;
+                logOpenFrames: () => void;
+                getCacheStats: () => {
+                    count: number;
+                    size: number;
+                };
+                getLastUsed: () => number;
+                prepareForDeletion: () => void;
+                startTimestamp: number;
+                clearBeforeThreshold: (threshold: number) => void;
+                getOldestTimestamp: () => number;
+                getNewestTimestamp: () => number | null;
+            }>;
+            getCacheStats: () => {
+                count: number;
+                totalSize: number;
+            };
+            getIteratorMostInThePast: () => {
+                src: string;
+                getSamples: (ts: number, dur: number) => Promise<import("mediabunny").AudioSample[]>;
+                waitForCompletion: () => Promise<boolean>;
+                canSatisfyRequestedTime: (timestamp: number) => boolean;
+                logOpenFrames: () => void;
+                getCacheStats: () => {
+                    count: number;
+                    size: number;
+                };
+                getLastUsed: () => number;
+                prepareForDeletion: () => void;
+                startTimestamp: number;
+                clearBeforeThreshold: (threshold: number) => void;
+                getOldestTimestamp: () => number;
+                getNewestTimestamp: () => number | null;
+            } | null;
+            logOpenFrames: () => void;
+            deleteDuplicateIterators: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+            clearAll: () => void;
+            dispose: () => void;
+        };
+        getTotalCacheStats: () => {
+            count: number;
+            totalSize: number;
+        };
+        isDisposed: () => boolean;
+        queueFrameExtraction: <T>(extract: () => Promise<T>) => Promise<T>;
+        queueAudioExtraction: <T>(extract: () => Promise<T>) => Promise<T>;
+        dispose: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+    };
 }) => Promise<ExtractFrameViaBroadcastChannelResult>;

package/dist/video-extraction/extract-frame.d.ts

@@ -1,4 +1,5 @@
 import { type LogLevel } from 'remotion';
+import type { MediaCache } from '../caches';
 import type { MediaRequestInit } from '../request-init';
 type ExtractFrameResult = {
     type: 'success';
@@ -31,6 +32,7 @@ type ExtractFrameParams = {
     maxCacheSize: number;
     credentials: RequestCredentials | undefined;
     requestInit?: MediaRequestInit;
+    mediaCache: MediaCache;
 };
 export declare const extractFrame: (params: ExtractFrameParams) => Promise<ExtractFrameResult>;
 export {};

package/dist/video-extraction/get-frames-since-keyframe.d.ts

@@ -8,15 +8,18 @@ type AudioSinks = {
 };
 export type AudioSinkResult = AudioSinks | 'no-audio-track' | 'cannot-decode-audio' | 'unknown-container-format' | 'network-error';
 export type VideoSinkResult = VideoSinks | 'no-video-track' | 'cannot-decode' | 'cannot-decode-prores' | 'cannot-decode-alpha' | 'unknown-container-format' | 'network-error';
-export declare const getSinks: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit?: MediaRequestInit | undefined) => Promise<{
-    getVideo: () => Promise<VideoSinkResult>;
-    getAudio: (index: number | null) => Promise<AudioSinkResult>;
-    actualMatroskaTimestamps: {
-        observeTimestamp: (startTime: number) => void;
-        getRealTimestamp: (observedTimestamp: number) => number | null;
-    };
-    isMatroska: boolean;
-    getDuration: () => Promise<number>;
-}>;
-export type GetSink = Awaited<ReturnType<typeof getSinks>>;
+export declare const makeSinks: (src: string, logLevel: "error" | "info" | "trace" | "verbose" | "warn", credentials: RequestCredentials | undefined, requestInit?: MediaRequestInit | undefined) => {
+    promise: Promise<{
+        getVideo: () => Promise<VideoSinkResult>;
+        getAudio: (index: number | null) => Promise<AudioSinkResult>;
+        actualMatroskaTimestamps: {
+            observeTimestamp: (startTime: number) => void;
+            getRealTimestamp: (observedTimestamp: number) => number | null;
+        };
+        isMatroska: boolean;
+        getDuration: () => Promise<number>;
+    }>;
+    dispose: () => void;
+};
+export type GetSink = Awaited<ReturnType<typeof makeSinks>['promise']>;
 export {};

package/dist/video-extraction/keyframe-bank.d.ts

@@ -18,6 +18,7 @@ export type KeyframeBank = {
         timestamps: number[];
     };
     getLastUsed: () => number;
+    isBusy: () => boolean;
     canSatisfyTimestamp: (timestamp: number) => boolean;
     getRangeOfTimestamps: () => {
         firstTimestamp: number;

package/dist/video-extraction/keyframe-manager.d.ts

@@ -1,6 +1,11 @@
 import type { VideoSampleSink } from 'mediabunny';
 import { type KeyframeBank } from './keyframe-bank';
-export declare const makeKeyframeManager: () => {
+export declare const makeKeyframeManager: ({ getTotalCacheStats, }: {
+    getTotalCacheStats: () => {
+        count: number;
+        totalSize: number;
+    };
+}) => {
     requestKeyframeBank: ({ timestamp, videoSampleSink, src, logLevel, maxCacheSize, fps, }: {
         timestamp: number;
         videoSampleSink: VideoSampleSink;
@@ -8,11 +13,12 @@ export declare const makeKeyframeManager: () => {
         logLevel: "error" | "info" | "trace" | "verbose" | "warn";
         maxCacheSize: number;
         fps: number;
-    }) => Promise<KeyframeBank>;
+    }) => Promise<KeyframeBank | null>;
     getCacheStats: () => {
         count: number;
         totalSize: number;
     };
     clearAll: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
+    dispose: (logLevel: "error" | "info" | "trace" | "verbose" | "warn") => void;
 };
 export type KeyframeManager = Awaited<ReturnType<typeof makeKeyframeManager>>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remotion/media",
-	"version": "4.0.506",
+	"version": "4.0.508",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"module": "dist/esm/index.mjs",
@@ -23,7 +23,7 @@
 	},
 	"dependencies": {
 		"mediabunny": "1.50.8",
-		"remotion": "4.0.506",
+		"remotion": "4.0.508",
 		"zod": "4.4.3"
 	},
 	"peerDependencies": {
@@ -31,8 +31,8 @@
 		"react-dom": ">=16.8.0"
 	},
 	"devDependencies": {
-		"@remotion/eslint-config-internal": "4.0.506",
-		"@remotion/player": "4.0.506",
+		"@remotion/eslint-config-internal": "4.0.508",
+		"@remotion/player": "4.0.508",
 		"@vitest/browser-webdriverio": "4.0.9",
 		"eslint": "9.19.0",
 		"react": "19.2.3",