@remotion/renderer 4.0.514 → 4.0.516

package/dist/esm/index.mjs

@@ -20605,7 +20605,7 @@ var renderFrameWithOptionToReject = async ({
     if (!buffer2) {
       throw new Error("unexpected null buffer");
     }
-    onFrameBuffer(buffer2, frame);
+    await onFrameBuffer(buffer2, frame);
   }
   const onlyAvailableAssets = assets.filter(truthy);
   const previousAudioRenderAssets = onlyAvailableAssets.map((a) => a.audioAndVideoAssets).flat(2);
@@ -22291,6 +22291,13 @@ var prespawnFfmpeg = (options2) => {
 };
 
 // src/prestitcher-memory-usage.ts
+var MINIMUM_MEMORY_LEFT = 2000000000;
+var hasEnoughMemoryForParallelEncoding = ({
+  freeMemory,
+  estimatedUsage
+}) => {
+  return freeMemory - estimatedUsage > MINIMUM_MEMORY_LEFT;
+};
 var estimateMemoryUsageForPrestitcher = ({
   width,
   height
@@ -22309,7 +22316,10 @@ var shouldUseParallelEncoding = ({
     height,
     width
   });
-  const hasEnoughMemory = freeMemory - estimatedUsage > 2000000000 && estimatedUsage / freeMemory < 0.5;
+  const hasEnoughMemory = hasEnoughMemoryForParallelEncoding({
+    estimatedUsage,
+    freeMemory
+  });
   return {
     hasEnoughMemory,
     freeMemory,
@@ -23819,6 +23829,41 @@ var validateOutputFilename = ({
   }
 };
 
+// src/write-with-backpressure.ts
+var writeWithBackpressure = ({
+  data,
+  writable
+}) => {
+  if (writable.write(data)) {
+    return Promise.resolve();
+  }
+  return new Promise((resolve2, reject) => {
+    const cleanup = () => {
+      writable.off("close", onClose);
+      writable.off("drain", onDrain);
+      writable.off("error", onError);
+    };
+    const onClose = () => {
+      cleanup();
+      reject(new Error("The writable stream closed before it accepted all data."));
+    };
+    const onDrain = () => {
+      cleanup();
+      resolve2();
+    };
+    const onError = (error) => {
+      cleanup();
+      reject(error);
+    };
+    writable.once("close", onClose);
+    writable.once("drain", onDrain);
+    writable.once("error", onError);
+    if (writable.destroyed) {
+      onClose();
+    }
+  });
+};
+
 // src/render-media.ts
 var SLOWEST_FRAME_COUNT = 10;
 var MAX_RECENT_FRAME_TIMINGS = 150;
@@ -24176,7 +24221,11 @@ var internalRenderMediaRaw = ({
           if (exitStatus?.type === "quit-with-error") {
             throw new Error(`FFmpeg quit with code ${exitStatus.exitCode}${exitStatus.signal ? ` (signal ${exitStatus.signal})` : ""} while piping frame ${frame}. Stderr: ${exitStatus.stderr}`);
           }
-          stitcherFfmpeg?.stdin?.write(buffer2);
+          const stdin = stitcherFfmpeg?.stdin;
+          if (!stdin) {
+            throw new Error(`FFmpeg stdin is not available while trying to pipe frame ${frame} to it.`);
+          }
+          await writeWithBackpressure({ data: buffer2, writable: stdin });
           stopPerfMeasure(id);
           const frameIndex = framesToRender.indexOf(frame);
           setFrameToStitch(framesToRender[frameIndex + 1] ?? lastFrameToRender + 1);

package/dist/index.d.ts

@@ -1056,7 +1056,7 @@ export declare const RenderInternals: {
         puppeteerInstance: HeadlessBrowser | undefined;
         browserExecutable: import("./browser-executable").BrowserExecutable;
         onBrowserLog: ((log: import("./browser-log").BrowserLog) => void) | null;
-        onFrameBuffer: ((buffer: Buffer, frame: number) => void) | null;
+        onFrameBuffer: ((buffer: Buffer, frame: number) => void | Promise<void>) | null;
         onDownload: import(".").RenderMediaOnDownload | null;
         chromiumOptions: import("./open-browser").ChromiumOptions;
         scale: number;

package/dist/options/enable-cancellation.d.ts

@@ -0,0 +1,16 @@
+export declare const enableCancellationOption: {
+    name: string;
+    cliFlag: "enable-cancellation";
+    description: () => import("react/jsx-runtime").JSX.Element;
+    ssrName: null;
+    docLink: string;
+    type: boolean;
+    setConfig: (value: boolean) => void;
+    getValue: ({ commandLine }: {
+        commandLine: Record<string, unknown>;
+    }) => {
+        value: boolean;
+        source: string;
+    };
+    id: "enable-cancellation";
+};

package/dist/options/enable-cancellation.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enableCancellationOption = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cliFlag = 'enable-cancellation';
+let enableCancellation = false;
+exports.enableCancellationOption = {
+    name: 'Enable cancellation',
+    cliFlag,
+    description: () => (jsx_runtime_1.jsxs(jsx_runtime_1.Fragment, { children: ["Allows a Lambda render to be cancelled by pressing Ctrl+C while running", ' ', jsx_runtime_1.jsx("code", { children: "npx remotion lambda render" }),
+            ". Enabling cancellation causes each renderer function to poll S3 once per second while it is running."] })),
+    ssrName: null,
+    docLink: 'https://www.remotion.dev/docs/lambda/cli/render#--enable-cancellation',
+    type: false,
+    setConfig: (value) => {
+        enableCancellation = value;
+    },
+    getValue: ({ commandLine }) => {
+        if (typeof commandLine[cliFlag] === 'boolean') {
+            return {
+                value: commandLine[cliFlag],
+                source: 'cli',
+            };
+        }
+        return {
+            value: enableCancellation,
+            source: enableCancellation ? 'config' : 'default',
+        };
+    },
+    id: cliFlag,
+};

package/dist/options/index.d.ts

@@ -376,6 +376,22 @@ export declare const allOptions: {
         setConfig: (value: boolean | null) => void;
         id: "enable-folder-expiry";
     };
+    enableCancellationOption: {
+        name: string;
+        cliFlag: "enable-cancellation";
+        description: () => import("react/jsx-runtime").JSX.Element;
+        ssrName: null;
+        docLink: string;
+        type: boolean;
+        setConfig: (value: boolean) => void;
+        getValue: ({ commandLine }: {
+            commandLine: Record<string, unknown>;
+        }) => {
+            value: boolean;
+            source: string;
+        };
+        id: "enable-cancellation";
+    };
     enableMultiprocessOnLinuxOption: {
         name: string;
         cliFlag: "enable-multiprocess-on-linux";

package/dist/options/index.js

@@ -25,6 +25,7 @@ const delete_after_1 = require("./delete-after");
 const disable_git_source_1 = require("./disable-git-source");
 const disable_web_security_1 = require("./disable-web-security");
 const disallow_parallel_encoding_1 = require("./disallow-parallel-encoding");
+const enable_cancellation_1 = require("./enable-cancellation");
 const enable_lambda_insights_1 = require("./enable-lambda-insights");
 const enable_multiprocess_on_linux_1 = require("./enable-multiprocess-on-linux");
 const encoding_buffer_size_1 = require("./encoding-buffer-size");
@@ -119,6 +120,7 @@ exports.allOptions = {
     disableWebSecurityOption: disable_web_security_1.disableWebSecurityOption,
     disallowParallelEncodingOption: disallow_parallel_encoding_1.disallowParallelEncodingOption,
     folderExpiryOption: folder_expiry_1.folderExpiryOption,
+    enableCancellationOption: enable_cancellation_1.enableCancellationOption,
     enableMultiprocessOnLinuxOption: enable_multiprocess_on_linux_1.enableMultiprocessOnLinuxOption,
     glOption: gl_1.glOption,
     gopSizeOption: gop_size_1.gopSizeOption,

package/dist/prestitcher-memory-usage.d.ts

@@ -1,3 +1,7 @@
+export declare const hasEnoughMemoryForParallelEncoding: ({ freeMemory, estimatedUsage, }: {
+    freeMemory: number;
+    estimatedUsage: number;
+}) => boolean;
 export declare const shouldUseParallelEncoding: ({ width, height, logLevel, }: {
     width: number;
     height: number;

package/dist/prestitcher-memory-usage.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldUseParallelEncoding = void 0;
+exports.shouldUseParallelEncoding = exports.hasEnoughMemoryForParallelEncoding = void 0;
 const get_available_memory_1 = require("./memory/get-available-memory");
+const MINIMUM_MEMORY_LEFT = 2000000000;
+const hasEnoughMemoryForParallelEncoding = ({ freeMemory, estimatedUsage, }) => {
+    return freeMemory - estimatedUsage > MINIMUM_MEMORY_LEFT;
+};
+exports.hasEnoughMemoryForParallelEncoding = hasEnoughMemoryForParallelEncoding;
 const estimateMemoryUsageForPrestitcher = ({ width, height, }) => {
     // Empirically we detected that per 1 million pixels, FFMPEG uses around 1GB of memory, relatively independent of
     // the duration of the video.
@@ -15,8 +20,10 @@ const shouldUseParallelEncoding = ({ width, height, logLevel, }) => {
         height,
         width,
     });
-    const hasEnoughMemory = freeMemory - estimatedUsage > 2000000000 &&
-        estimatedUsage / freeMemory < 0.5;
+    const hasEnoughMemory = (0, exports.hasEnoughMemoryForParallelEncoding)({
+        estimatedUsage,
+        freeMemory,
+    });
     return {
         hasEnoughMemory,
         freeMemory,

package/dist/render-frame-and-retry-target-close.d.ts

@@ -41,7 +41,7 @@ export declare const renderFrameAndRetryTargetClose: ({ retriesLeft, attempt, as
     framesRenderedObj: {
         count: number;
     };
-    onFrameBuffer: ((buffer: Buffer, frame: number) => void) | null | undefined;
+    onFrameBuffer: ((buffer: Buffer, frame: number) => void | Promise<void>) | null | undefined;
     onFrameUpdate: ((framesRendered: number, frameIndex: number, timeToRenderInMilliseconds: number) => void) | null;
     nextFrameToRender: {
         getNextFrame: (_pageIndex: number) => number;

package/dist/render-frame-with-option-to-reject.d.ts

@@ -17,7 +17,7 @@ export declare const renderFrameWithOptionToReject: ({ reject, width, height, co
     indent: boolean;
     logLevel: "error" | "info" | "trace" | "verbose" | "warn";
     outputDir: string | null;
-    onFrameBuffer: ((buffer: Buffer, frame: number) => void) | null | undefined;
+    onFrameBuffer: ((buffer: Buffer, frame: number) => void | Promise<void>) | null | undefined;
     imageFormat: "jpeg" | "none" | "png";
     onError: (err: Error) => void;
     lastFrame: number;

package/dist/render-frame-with-option-to-reject.js

@@ -83,7 +83,7 @@ const renderFrameWithOptionToReject = async ({ reject, width, height, compId, at
         if (!buffer) {
             throw new Error('unexpected null buffer');
         }
-        onFrameBuffer(buffer, frame);
+        await onFrameBuffer(buffer, frame);
     }
     const onlyAvailableAssets = assets.filter(truthy_1.truthy);
     const previousAudioRenderAssets = onlyAvailableAssets

package/dist/render-frame.d.ts

@@ -28,7 +28,7 @@ export declare const renderFrame: ({ attempt, binariesDirectory, cancelSignal, i
     };
     timeoutInMilliseconds: number;
     outputDir: string | null;
-    onFrameBuffer: ((buffer: Buffer, frame: number) => void) | null | undefined;
+    onFrameBuffer: ((buffer: Buffer, frame: number) => void | Promise<void>) | null | undefined;
     lastFrame: number;
     onFrameUpdate: ((framesRendered: number, frameIndex: number, timeToRenderInMilliseconds: number) => void) | null;
     framesRenderedObj: {

package/dist/render-frames.d.ts

@@ -28,7 +28,7 @@ type InternalRenderFramesOptions = {
     puppeteerInstance: HeadlessBrowser | undefined;
     browserExecutable: BrowserExecutable | null;
     onBrowserLog: null | ((log: BrowserLog) => void);
-    onFrameBuffer: null | ((buffer: Buffer, frame: number) => void);
+    onFrameBuffer: null | ((buffer: Buffer, frame: number) => void | Promise<void>);
     onDownload: RenderMediaOnDownload | null;
     chromiumOptions: ChromiumOptions;
     scale: number;
@@ -85,7 +85,7 @@ export type RenderFramesOptions = Prettify<{
     puppeteerInstance?: HeadlessBrowser;
     browserExecutable?: BrowserExecutable;
     onBrowserLog?: (log: BrowserLog) => void;
-    onFrameBuffer?: (buffer: Buffer, frame: number) => void;
+    onFrameBuffer?: (buffer: Buffer, frame: number) => void | Promise<void>;
     onDownload?: RenderMediaOnDownload;
     timeoutInMilliseconds?: number;
     chromiumOptions?: ChromiumOptions;
@@ -126,7 +126,7 @@ export declare const renderFrames: (options: {
     puppeteerInstance?: HeadlessBrowser | undefined;
     browserExecutable?: BrowserExecutable | undefined;
     onBrowserLog?: ((log: BrowserLog) => void) | undefined;
-    onFrameBuffer?: ((buffer: Buffer, frame: number) => void) | undefined;
+    onFrameBuffer?: ((buffer: Buffer, frame: number) => void | Promise<void>) | undefined;
     onDownload?: RenderMediaOnDownload | undefined;
     timeoutInMilliseconds?: number | undefined;
     chromiumOptions?: ChromiumOptions | undefined;

package/dist/render-media.js

@@ -54,6 +54,7 @@ const validate_output_filename_1 = require("./validate-output-filename");
 const validate_scale_1 = require("./validate-scale");
 const validate_videobitrate_1 = require("./validate-videobitrate");
 const wrap_with_error_handling_1 = require("./wrap-with-error-handling");
+const write_with_backpressure_1 = require("./write-with-backpressure");
 const SLOWEST_FRAME_COUNT = 10;
 const MAX_RECENT_FRAME_TIMINGS = 150;
 const internalRenderMediaRaw = ({ proResProfile, x264Preset, gopSize, crf, composition: compositionWithPossibleUnevenDimensions, serializedInputPropsWithCustomSchema, pixelFormat: userPixelFormat, codec, envVariables, frameRange, puppeteerInstance, outputLocation, onProgress, overwrite, onDownload, onBrowserLog, onStart, timeoutInMilliseconds, chromiumOptions, scale, browserExecutable, port, cancelSignal, muted, enforceAudioTrack, ffmpegOverride, audioBitrate, videoBitrate, encodingMaxRate, encodingBufferSize, audioCodec, concurrency, disallowParallelEncoding, everyNthFrame, imageFormat: provisionalImageFormat, indent, jpegQuality, numberOfGifLoops, onCtrlCExit, preferLossless, serveUrl, server: reusedServer, logLevel, serializedResolvedPropsWithCustomSchema, offthreadVideoCacheSizeInBytes, colorSpace, repro, binariesDirectory, separateAudioTo, forSeamlessAacConcatenation, compositionStart, onBrowserDownload, onArtifact, metadata, hardwareAcceleration, chromeMode, offthreadVideoThreads, mediaCacheSizeInBytes, onLog, licenseKey, isProduction, sampleRate, }) => {
@@ -361,7 +362,6 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, gopSize, crf, compo
                 onFrameBuffer: parallelEncoding
                     ? async (buffer, frame) => {
                         var _a;
-                        var _b;
                         await waitForRightTimeOfFrameToBeInserted(frame);
                         if (cancelled) {
                             return;
@@ -374,10 +374,14 @@ const internalRenderMediaRaw = ({ proResProfile, x264Preset, gopSize, crf, compo
                         if ((exitStatus === null || exitStatus === void 0 ? void 0 : exitStatus.type) === 'quit-with-error') {
                             throw new Error(`FFmpeg quit with code ${exitStatus.exitCode}${exitStatus.signal ? ` (signal ${exitStatus.signal})` : ''} while piping frame ${frame}. Stderr: ${exitStatus.stderr}`);
                         }
-                        (_a = stitcherFfmpeg === null || stitcherFfmpeg === void 0 ? void 0 : stitcherFfmpeg.stdin) === null || _a === void 0 ? void 0 : _a.write(buffer);
+                        const stdin = stitcherFfmpeg === null || stitcherFfmpeg === void 0 ? void 0 : stitcherFfmpeg.stdin;
+                        if (!stdin) {
+                            throw new Error(`FFmpeg stdin is not available while trying to pipe frame ${frame} to it.`);
+                        }
+                        await (0, write_with_backpressure_1.writeWithBackpressure)({ data: buffer, writable: stdin });
                         (0, perf_1.stopPerfMeasure)(id);
                         const frameIndex = framesToRender.indexOf(frame);
-                        setFrameToStitch((_b = framesToRender[frameIndex + 1]) !== null && _b !== void 0 ? _b : lastFrameToRender + 1);
+                        setFrameToStitch((_a = framesToRender[frameIndex + 1]) !== null && _a !== void 0 ? _a : lastFrameToRender + 1);
                     }
                     : null,
                 webpackBundleOrServeUrl: serveUrl,

package/dist/write-with-backpressure.d.ts

@@ -0,0 +1,5 @@
+import type { Writable } from 'node:stream';
+export declare const writeWithBackpressure: ({ data, writable, }: {
+    data: Buffer;
+    writable: Writable;
+}) => Promise<void>;

package/dist/write-with-backpressure.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeWithBackpressure = void 0;
+const writeWithBackpressure = ({ data, writable, }) => {
+    if (writable.write(data)) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            writable.off('close', onClose);
+            writable.off('drain', onDrain);
+            writable.off('error', onError);
+        };
+        const onClose = () => {
+            cleanup();
+            reject(new Error('The writable stream closed before it accepted all data.'));
+        };
+        const onDrain = () => {
+            cleanup();
+            resolve();
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        writable.once('close', onClose);
+        writable.once('drain', onDrain);
+        writable.once('error', onError);
+        if (writable.destroyed) {
+            onClose();
+        }
+    });
+};
+exports.writeWithBackpressure = writeWithBackpressure;

package/package.json

@@ -3,7 +3,7 @@
 		"url": "https://github.com/remotion-dev/remotion/tree/main/packages/renderer"
 	},
 	"name": "@remotion/renderer",
-	"version": "4.0.514",
+	"version": "4.0.516",
 	"description": "Render Remotion videos using Node.js or Bun",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,11 +22,11 @@
 	},
 	"dependencies": {
 		"execa": "5.1.1",
-		"remotion": "4.0.514",
-		"@remotion/streaming": "4.0.514",
+		"remotion": "4.0.516",
+		"@remotion/streaming": "4.0.516",
 		"source-map": "0.8.0",
 		"ws": "8.21.0",
-		"@remotion/licensing": "4.0.514"
+		"@remotion/licensing": "4.0.516"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -40,19 +40,19 @@
 		"react-dom": "19.2.3",
 		"@typescript/native-preview": "7.0.0-dev.20260217.1",
 		"@types/ws": "8.5.10",
-		"@remotion/example-videos": "4.0.514",
-		"@remotion/eslint-config-internal": "4.0.514",
+		"@remotion/example-videos": "4.0.516",
+		"@remotion/eslint-config-internal": "4.0.516",
 		"eslint": "9.19.0",
 		"@types/node": "20.12.14"
 	},
 	"optionalDependencies": {
-		"@remotion/compositor-darwin-arm64": "4.0.514",
-		"@remotion/compositor-darwin-x64": "4.0.514",
-		"@remotion/compositor-linux-arm64-gnu": "4.0.514",
-		"@remotion/compositor-linux-arm64-musl": "4.0.514",
-		"@remotion/compositor-linux-x64-gnu": "4.0.514",
-		"@remotion/compositor-linux-x64-musl": "4.0.514",
-		"@remotion/compositor-win32-x64-msvc": "4.0.514"
+		"@remotion/compositor-darwin-arm64": "4.0.516",
+		"@remotion/compositor-darwin-x64": "4.0.516",
+		"@remotion/compositor-linux-arm64-gnu": "4.0.516",
+		"@remotion/compositor-linux-arm64-musl": "4.0.516",
+		"@remotion/compositor-linux-x64-gnu": "4.0.516",
+		"@remotion/compositor-linux-x64-musl": "4.0.516",
+		"@remotion/compositor-win32-x64-msvc": "4.0.516"
 	},
 	"keywords": [
 		"remotion",