@remotion/lambda 4.0.0-umungobongo.4 → 4.0.0-webhook.25

package/dist/api/render-media-on-lambda.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderVideoOnLambda = exports.renderMediaOnLambda = void 0;
+const version_1 = require("remotion/version");
 const call_lambda_1 = require("../shared/call-lambda");
 const constants_1 = require("../shared/constants");
 const convert_to_serve_url_1 = require("../shared/convert-to-serve-url");
+const get_cloudwatch_stream_url_1 = require("../shared/get-cloudwatch-stream-url");
 const validate_download_behavior_1 = require("../shared/validate-download-behavior");
 const validate_frames_per_lambda_1 = require("../shared/validate-frames-per-lambda");
 const validate_lambda_codec_1 = require("../shared/validate-lambda-codec");
@@ -15,57 +17,80 @@ const validate_serveurl_1 = require("../shared/validate-serveurl");
  * @param params.serveUrl The URL of the deployed project
  * @param params.composition The ID of the composition which should be rendered.
  * @param params.inputProps The input props that should be passed to the composition.
- * @param params.codec The video codec which should be used for encoding.
- * @param params.imageFormat In which image format the frames should be rendered.
+ * @param params.codec The media codec which should be used for encoding.
+ * @param params.imageFormat In which image format the frames should be rendered. Default "jpeg"
  * @param params.crf The constant rate factor to be used during encoding.
  * @param params.envVariables Object containing environment variables to be inserted into the video environment
  * @param params.proResProfile The ProRes profile if rendering a ProRes video
  * @param params.quality JPEG quality if JPEG was selected as the image format.
- * @param params.region The AWS region in which the video should be rendered.
- * @param params.maxRetries How often rendering a chunk may fail before the video render gets aborted.
+ * @param params.region The AWS region in which the media should be rendered.
+ * @param params.maxRetries How often rendering a chunk may fail before the media render gets aborted. Default "1"
  * @param params.logLevel Level of logging that Lambda function should perform. Default "info".
+ * @param params.webhook Webhook URL to be called upon completion or timeout of the rendering process.
  * @returns {Promise<RenderMediaOnLambdaOutput>} See documentation for detailed structure
  */
-const renderMediaOnLambda = async ({ functionName, serveUrl, inputProps, codec, imageFormat, crf, envVariables, pixelFormat, proResProfile, quality, region, maxRetries, composition, framesPerLambda, privacy, logLevel, frameRange, outName, timeoutInMilliseconds, chromiumOptions, scale, numberOfGifLoops, everyNthFrame, concurrencyPerLambda, downloadBehavior, }) => {
+const renderMediaOnLambda = async ({ functionName, serveUrl, inputProps, codec, imageFormat, crf, envVariables, pixelFormat, proResProfile, quality, region, maxRetries, composition, framesPerLambda, privacy, logLevel, frameRange, outName, timeoutInMilliseconds, chromiumOptions, scale, numberOfGifLoops, everyNthFrame, concurrencyPerLambda, downloadBehavior, muted, overwrite, webhook, }) => {
+    var _a;
     const actualCodec = (0, validate_lambda_codec_1.validateLambdaCodec)(codec);
     (0, validate_serveurl_1.validateServeUrl)(serveUrl);
-    (0, validate_frames_per_lambda_1.validateFramesPerLambda)(framesPerLambda !== null && framesPerLambda !== void 0 ? framesPerLambda : null);
+    (0, validate_frames_per_lambda_1.validateFramesPerLambda)({
+        framesPerLambda: framesPerLambda !== null && framesPerLambda !== void 0 ? framesPerLambda : null,
+        durationInFrames: 1,
+    });
     (0, validate_download_behavior_1.validateDownloadBehavior)(downloadBehavior);
     const realServeUrl = await (0, convert_to_serve_url_1.convertToServeUrl)(serveUrl, region);
-    const res = await (0, call_lambda_1.callLambda)({
-        functionName,
-        type: constants_1.LambdaRoutines.start,
-        payload: {
-            framesPerLambda: framesPerLambda !== null && framesPerLambda !== void 0 ? framesPerLambda : null,
-            composition,
-            serveUrl: realServeUrl,
-            inputProps,
-            codec: actualCodec,
-            imageFormat,
-            crf,
-            envVariables,
-            pixelFormat,
-            proResProfile,
-            quality,
-            maxRetries,
-            privacy,
-            logLevel: logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
-            frameRange: frameRange !== null && frameRange !== void 0 ? frameRange : null,
-            outName: outName !== null && outName !== void 0 ? outName : null,
-            timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : 30000,
-            chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
-            scale: scale !== null && scale !== void 0 ? scale : 1,
-            everyNthFrame: everyNthFrame !== null && everyNthFrame !== void 0 ? everyNthFrame : 1,
-            numberOfGifLoops: numberOfGifLoops !== null && numberOfGifLoops !== void 0 ? numberOfGifLoops : 0,
-            concurrencyPerLambda: concurrencyPerLambda !== null && concurrencyPerLambda !== void 0 ? concurrencyPerLambda : 1,
-            downloadBehavior: downloadBehavior !== null && downloadBehavior !== void 0 ? downloadBehavior : { type: 'play-in-browser' },
-        },
-        region,
-    });
-    return {
-        renderId: res.renderId,
-        bucketName: res.bucketName,
-    };
+    try {
+        const res = await (0, call_lambda_1.callLambda)({
+            functionName,
+            type: constants_1.LambdaRoutines.start,
+            payload: {
+                framesPerLambda: framesPerLambda !== null && framesPerLambda !== void 0 ? framesPerLambda : null,
+                composition,
+                serveUrl: realServeUrl,
+                inputProps: inputProps !== null && inputProps !== void 0 ? inputProps : {},
+                codec: actualCodec,
+                imageFormat: imageFormat !== null && imageFormat !== void 0 ? imageFormat : 'jpeg',
+                crf,
+                envVariables,
+                pixelFormat,
+                proResProfile,
+                quality,
+                maxRetries: maxRetries !== null && maxRetries !== void 0 ? maxRetries : 1,
+                privacy: privacy !== null && privacy !== void 0 ? privacy : 'public',
+                logLevel: logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
+                frameRange: frameRange !== null && frameRange !== void 0 ? frameRange : null,
+                outName: outName !== null && outName !== void 0 ? outName : null,
+                timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : 30000,
+                chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
+                scale: scale !== null && scale !== void 0 ? scale : 1,
+                everyNthFrame: everyNthFrame !== null && everyNthFrame !== void 0 ? everyNthFrame : 1,
+                numberOfGifLoops: numberOfGifLoops !== null && numberOfGifLoops !== void 0 ? numberOfGifLoops : 0,
+                concurrencyPerLambda: concurrencyPerLambda !== null && concurrencyPerLambda !== void 0 ? concurrencyPerLambda : 1,
+                downloadBehavior: downloadBehavior !== null && downloadBehavior !== void 0 ? downloadBehavior : { type: 'play-in-browser' },
+                muted: muted !== null && muted !== void 0 ? muted : false,
+                version: version_1.VERSION,
+                overwrite: overwrite !== null && overwrite !== void 0 ? overwrite : false,
+                webhook: webhook !== null && webhook !== void 0 ? webhook : null,
+            },
+            region,
+        });
+        return {
+            renderId: res.renderId,
+            bucketName: res.bucketName,
+            cloudWatchLogs: (0, get_cloudwatch_stream_url_1.getCloudwatchStreamUrl)({
+                functionName,
+                method: constants_1.LambdaRoutines.renderer,
+                region,
+                renderId: res.renderId,
+            }),
+        };
+    }
+    catch (err) {
+        if ((_a = err.stack) === null || _a === void 0 ? void 0 : _a.includes('UnrecognizedClientException')) {
+            throw new Error('UnrecognizedClientException: The AWS credentials provided were probably mixed up. Learn how to fix this issue here: https://remotion.dev/docs/lambda/troubleshooting/unrecognizedclientexception');
+        }
+        throw err;
+    }
 };
 exports.renderMediaOnLambda = renderMediaOnLambda;
 /**

package/dist/api/render-still-on-lambda.d.ts

@@ -27,6 +27,7 @@ export declare type RenderStillOnLambdaOutput = {
     sizeInBytes: number;
     bucketName: string;
     renderId: string;
+    cloudWatchLogs: string;
 };
 /**
  * @description Renders a still frame on Lambda

package/dist/api/render-still-on-lambda.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderStillOnLambda = void 0;
+const version_1 = require("remotion/version");
 const call_lambda_1 = require("../shared/call-lambda");
 const constants_1 = require("../shared/constants");
 const convert_to_serve_url_1 = require("../shared/convert-to-serve-url");
+const get_cloudwatch_stream_url_1 = require("../shared/get-cloudwatch-stream-url");
 /**
  * @description Renders a still frame on Lambda
  * @link https://remotion.dev/docs/lambda/renderstillonlambda
@@ -21,36 +23,52 @@ const convert_to_serve_url_1 = require("../shared/convert-to-serve-url");
  * @returns {Promise<RenderStillOnLambdaOutput>} See documentation for exact response structure.
  */
 const renderStillOnLambda = async ({ functionName, serveUrl, inputProps, imageFormat, envVariables, quality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, downloadBehavior, }) => {
+    var _a;
     const realServeUrl = await (0, convert_to_serve_url_1.convertToServeUrl)(serveUrl, region);
-    const res = await (0, call_lambda_1.callLambda)({
-        functionName,
-        type: constants_1.LambdaRoutines.still,
-        payload: {
-            composition,
-            serveUrl: realServeUrl,
-            inputProps,
-            imageFormat,
-            envVariables,
-            quality,
-            maxRetries: maxRetries !== null && maxRetries !== void 0 ? maxRetries : constants_1.DEFAULT_MAX_RETRIES,
-            frame: frame !== null && frame !== void 0 ? frame : 0,
-            privacy,
-            attempt: 1,
-            logLevel: logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
-            outName: outName !== null && outName !== void 0 ? outName : null,
-            timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : 30000,
-            chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
-            scale: scale !== null && scale !== void 0 ? scale : 1,
-            downloadBehavior: downloadBehavior !== null && downloadBehavior !== void 0 ? downloadBehavior : { type: 'play-in-browser' },
-        },
-        region,
-    });
-    return {
-        estimatedPrice: res.estimatedPrice,
-        url: res.output,
-        sizeInBytes: res.size,
-        bucketName: res.bucketName,
-        renderId: res.renderId,
-    };
+    try {
+        const res = await (0, call_lambda_1.callLambda)({
+            functionName,
+            type: constants_1.LambdaRoutines.still,
+            payload: {
+                composition,
+                serveUrl: realServeUrl,
+                inputProps,
+                imageFormat,
+                envVariables,
+                quality,
+                maxRetries: maxRetries !== null && maxRetries !== void 0 ? maxRetries : constants_1.DEFAULT_MAX_RETRIES,
+                frame: frame !== null && frame !== void 0 ? frame : 0,
+                privacy,
+                attempt: 1,
+                logLevel: logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
+                outName: outName !== null && outName !== void 0 ? outName : null,
+                timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : 30000,
+                chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
+                scale: scale !== null && scale !== void 0 ? scale : 1,
+                downloadBehavior: downloadBehavior !== null && downloadBehavior !== void 0 ? downloadBehavior : { type: 'play-in-browser' },
+                version: version_1.VERSION,
+            },
+            region,
+        });
+        return {
+            estimatedPrice: res.estimatedPrice,
+            url: res.output,
+            sizeInBytes: res.size,
+            bucketName: res.bucketName,
+            renderId: res.renderId,
+            cloudWatchLogs: (0, get_cloudwatch_stream_url_1.getCloudwatchStreamUrl)({
+                functionName,
+                method: constants_1.LambdaRoutines.still,
+                region,
+                renderId: res.renderId,
+            }),
+        };
+    }
+    catch (err) {
+        if ((_a = err.stack) === null || _a === void 0 ? void 0 : _a.includes('UnrecognizedClientException')) {
+            throw new Error('UnrecognizedClientException: The AWS credentials provided were probably mixed up. Learn how to fix this issue here: https://remotion.dev/docs/lambda/troubleshooting/unrecognizedclientexception');
+        }
+        throw err;
+    }
 };
 exports.renderStillOnLambda = renderStillOnLambda;

package/dist/api/upload-dir.js

@@ -37,7 +37,7 @@ const uploadDir = async ({ bucket, region, dir, onProgress, folder, privacy, })
     for (const file of files) {
         progresses[file.name] = 0;
     }
-    const client = (0, aws_clients_1.getS3Client)(region);
+    const client = (0, aws_clients_1.getS3Client)(region, null);
     const uploads = files.map(async (filePath) => {
         const Key = (0, make_s3_key_1.makeS3Key)(folder, dir, filePath.name);
         const Body = (0, fs_1.createReadStream)(filePath.name);

package/dist/api/validate-webhook-signature.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @description Throws if the signature of the finish webhook is missing or inauthentic
+ * @link https://remotion.dev/docs/lambda/validate-webhook-signature
+ * @param params.secret The secret used for signing the webhook
+ * @param params.body The body that was received by the endpoint
+ * @param params.signatureHeader The `X-Remotion-Signature` header
+ * @returns {void}
+ */
+export declare const validateWebhookSignature: ({ secret, body, signatureHeader, }: {
+    secret: string;
+    body: string;
+    signatureHeader: string;
+}) => void;

package/dist/api/validate-webhook-signature.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWebhookSignature = void 0;
+/**
+ * @description Throws if the signature of the finish webhook is missing or inauthentic
+ * @link https://remotion.dev/docs/lambda/validate-webhook-signature
+ * @param params.secret The secret used for signing the webhook
+ * @param params.body The body that was received by the endpoint
+ * @param params.signatureHeader The `X-Remotion-Signature` header
+ * @returns {void}
+ */
+const validateWebhookSignature = ({ secret, body, signatureHeader, }) => {
+    if (!secret) {
+        throw new TypeError("No 'secret' was provided to validateWebhookSignature().");
+    }
+    if (!body) {
+        throw new TypeError("No 'body' was provided to validateWebhookSignature().");
+    }
+    if (typeof require === 'undefined') {
+        throw new Error('validateWebhookSignature can only be called from Node.JS');
+    }
+    const Crypto = require('crypto');
+    const hmac = Crypto.createHmac('sha512', secret);
+    const signature = `sha512=${hmac.update(JSON.stringify(body)).digest('hex')}`;
+    if (!signatureHeader || signatureHeader === 'NO_SECRET_PROVIDED') {
+        throw new Error('No webhook signature was provided');
+    }
+    if (signatureHeader !== signature) {
+        throw new Error('Signatures do not match');
+    }
+};
+exports.validateWebhookSignature = validateWebhookSignature;

package/dist/cli/args.d.ts

@@ -24,6 +24,8 @@ declare type LambdaCommandLineOptions = {
     ['architecture']: LambdaArchitecture;
     ['custom-role-arn']: string | undefined;
     privacy: Privacy;
+    webhook: string | undefined;
+    ['webhook-secret']: string | undefined;
 };
 export declare const parsedLambdaCli: LambdaCommandLineOptions & minimist.ParsedArgs;
 export declare const forceFlagProvided: boolean;

package/dist/cli/commands/functions/deploy.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.functionsDeploySubcommand = exports.FUNCTIONS_DEPLOY_SUBCOMMAND = void 0;
 const cli_1 = require("@remotion/cli");
 const log_1 = require("@remotion/cli/dist/log");
+const version_1 = require("remotion/version");
 const deploy_function_1 = require("../../../api/deploy-function");
 const constants_1 = require("../../../shared/constants");
 const validate_architecture_1 = require("../../../shared/validate-architecture");
@@ -34,7 +35,7 @@ Region = ${region}
 Memory = ${memorySizeInMb}MB
 Disk size = ${diskSizeInMb}MB
 Timeout = ${timeoutInSeconds}sec
-Version = ${constants_1.CURRENT_VERSION}
+Version = ${version_1.VERSION}
 Architecture = ${architecture}
 CloudWatch Logging Enabled = ${createCloudWatchLogGroup}
 CloudWatch Retention Period = ${cloudWatchLogRetentionPeriodInDays} days

package/dist/cli/commands/render/render.js

@@ -14,13 +14,12 @@ const validate_retries_1 = require("../../../shared/validate-retries");
 const args_1 = require("../../args");
 const get_aws_region_1 = require("../../get-aws-region");
 const find_function_name_1 = require("../../helpers/find-function-name");
-const get_cloudwatch_stream_url_1 = require("../../helpers/get-cloudwatch-stream-url");
 const quit_1 = require("../../helpers/quit");
 const log_1 = require("../../log");
 const progress_1 = require("./progress");
 exports.RENDER_COMMAND = 'render';
 const renderCommand = async (args) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const serveUrl = args[0];
     if (!serveUrl) {
         log_1.Log.error('No serve URL passed.');
@@ -37,10 +36,16 @@ const renderCommand = async (args) => {
         log_1.Log.info(`${constants_1.BINARY_NAME} ${exports.RENDER_COMMAND} <serve-url> <composition-id> [output-location]`);
         (0, quit_1.quit)(1);
     }
-    const outName = (_a = args[2]) !== null && _a !== void 0 ? _a : null;
-    const { chromiumOptions, codec, crf, envVariables, frameRange, imageFormat, inputProps, logLevel, pixelFormat, proResProfile, puppeteerTimeout, quality, scale, everyNthFrame, numberOfGifLoops, } = await cli_1.CliInternals.getCliOptions({
+    const outName = args_1.parsedLambdaCli['out-name'];
+    const downloadName = (_a = args[2]) !== null && _a !== void 0 ? _a : null;
+    const { codec, reason } = cli_1.CliInternals.getFinalCodec({
+        downloadName,
+        outName: outName !== null && outName !== void 0 ? outName : null,
+    });
+    const { chromiumOptions, crf, envVariables, frameRange, imageFormat, inputProps, logLevel, pixelFormat, proResProfile, puppeteerTimeout, quality, scale, everyNthFrame, numberOfGifLoops, muted, overwrite, } = await cli_1.CliInternals.getCliOptions({
         type: 'series',
         isLambda: true,
+        codec,
     });
     const functionName = await (0, find_function_name_1.findFunctionName)();
     const region = (0, get_aws_region_1.getAwsRegion)();
@@ -49,7 +54,7 @@ const renderCommand = async (args) => {
     const privacy = (_c = args_1.parsedLambdaCli.privacy) !== null && _c !== void 0 ? _c : constants_1.DEFAULT_OUTPUT_PRIVACY;
     (0, validate_privacy_1.validatePrivacy)(privacy);
     const framesPerLambda = (_d = args_1.parsedLambdaCli['frames-per-lambda']) !== null && _d !== void 0 ? _d : undefined;
-    (0, validate_frames_per_lambda_1.validateFramesPerLambda)(framesPerLambda);
+    (0, validate_frames_per_lambda_1.validateFramesPerLambda)({ framesPerLambda, durationInFrames: 1 });
     const res = await (0, render_media_on_lambda_1.renderMediaOnLambda)({
         functionName,
         serveUrl,
@@ -75,16 +80,20 @@ const renderCommand = async (args) => {
         numberOfGifLoops,
         everyNthFrame,
         concurrencyPerLambda: args_1.parsedLambdaCli['concurrency-per-lambda'],
+        muted,
+        overwrite,
+        webhook: args_1.parsedLambdaCli.webhook
+            ? {
+                url: args_1.parsedLambdaCli.webhook,
+                secret: (_e = args_1.parsedLambdaCli['webhook-secret']) !== null && _e !== void 0 ? _e : null,
+            }
+            : undefined,
     });
-    const totalSteps = outName ? 5 : 4;
+    const totalSteps = downloadName ? 5 : 4;
     const progressBar = cli_1.CliInternals.createOverwriteableCliOutput(cli_1.CliInternals.quietFlagProvided());
-    log_1.Log.info(cli_1.CliInternals.chalk.gray(`Bucket = ${res.bucketName}, renderId = ${res.renderId}, functionName = ${functionName}`));
-    log_1.Log.verbose(`CloudWatch logs (if enabled): ${(0, get_cloudwatch_stream_url_1.getCloudwatchStreamUrl)({
-        functionName,
-        region,
-        renderId: res.renderId,
-        method: constants_1.LambdaRoutines.renderer,
-    })}`);
+    log_1.Log.info(cli_1.CliInternals.chalk.gray(`bucket = ${res.bucketName}, function = ${functionName}`));
+    log_1.Log.info(cli_1.CliInternals.chalk.gray(`renderId = ${res.renderId}, codec = ${codec} (${reason})`));
+    log_1.Log.verbose(`CloudWatch logs (if enabled): ${res.cloudWatchLogs}`);
     const status = await (0, get_render_progress_1.getRenderProgress)({
         functionName,
         bucketName: res.bucketName,
@@ -121,11 +130,11 @@ const renderCommand = async (args) => {
                 downloadInfo: null,
                 retriesInfo: newStatus.retriesInfo,
             }));
-            if (outName) {
+            if (downloadName) {
                 const downloadStart = Date.now();
                 const { outputPath, sizeInBytes } = await (0, download_media_1.downloadMedia)({
                     bucketName: res.bucketName,
-                    outPath: outName,
+                    outPath: downloadName,
                     region: (0, get_aws_region_1.getAwsRegion)(),
                     renderId: res.renderId,
                     onProgress: ({ downloaded, totalSize }) => {

package/dist/cli/commands/still.js

@@ -11,12 +11,11 @@ const validate_retries_1 = require("../../shared/validate-retries");
 const args_1 = require("../args");
 const get_aws_region_1 = require("../get-aws-region");
 const find_function_name_1 = require("../helpers/find-function-name");
-const get_cloudwatch_stream_url_1 = require("../helpers/get-cloudwatch-stream-url");
 const quit_1 = require("../helpers/quit");
 const log_1 = require("../log");
 exports.STILL_COMMAND = 'still';
 const stillCommand = async (args) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e, _f;
     const serveUrl = args[0];
     if (!serveUrl) {
         log_1.Log.error('No serve URL passed.');
@@ -33,22 +32,32 @@ const stillCommand = async (args) => {
         log_1.Log.info(`${constants_1.BINARY_NAME} ${exports.STILL_COMMAND} <serve-url> <composition-id> [output-location]`);
         (0, quit_1.quit)(1);
     }
-    const outName = (_a = args[2]) !== null && _a !== void 0 ? _a : null;
-    const { chromiumOptions, envVariables, imageFormat, inputProps, logLevel, puppeteerTimeout, quality, stillFrame, scale, } = await cli_1.CliInternals.getCliOptions({
+    const downloadName = (_a = args[2]) !== null && _a !== void 0 ? _a : null;
+    const outName = args_1.parsedLambdaCli['out-name'];
+    const { chromiumOptions, envVariables, inputProps, logLevel, puppeteerTimeout, quality, stillFrame, scale, } = await cli_1.CliInternals.getCliOptions({
         type: 'still',
         isLambda: true,
+        codec: 'h264',
     });
     const functionName = await (0, find_function_name_1.findFunctionName)();
     const maxRetries = (_b = args_1.parsedLambdaCli['max-retries']) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_MAX_RETRIES;
     (0, validate_retries_1.validateMaxRetries)(maxRetries);
     const privacy = (_c = args_1.parsedLambdaCli.privacy) !== null && _c !== void 0 ? _c : constants_1.DEFAULT_OUTPUT_PRIVACY;
     (0, validate_privacy_1.validatePrivacy)(privacy);
+    const { format: imageFormat, source: imageFormatReason } = cli_1.CliInternals.determineFinalImageFormat({
+        downloadName,
+        outName: outName !== null && outName !== void 0 ? outName : null,
+        configImageFormat: (_d = cli_1.ConfigInternals.getUserPreferredImageFormat()) !== null && _d !== void 0 ? _d : null,
+        cliFlag: (_e = cli_1.CliInternals.parsedCli['image-format']) !== null && _e !== void 0 ? _e : null,
+        isLambda: true,
+    });
     try {
+        log_1.Log.info(cli_1.CliInternals.chalk.gray(`functionName = ${functionName}, imageFormat = ${imageFormat} (${imageFormatReason})`));
         const res = await (0, render_still_on_lambda_1.renderStillOnLambda)({
             functionName,
             serveUrl,
             inputProps,
-            imageFormat: imageFormat,
+            imageFormat,
             composition,
             privacy,
             region: (0, get_aws_region_1.getAwsRegion)(),
@@ -57,23 +66,18 @@ const stillCommand = async (args) => {
             frame: stillFrame,
             quality,
             logLevel,
-            outName: args_1.parsedLambdaCli['out-name'],
+            outName,
             chromiumOptions,
             timeoutInMilliseconds: puppeteerTimeout,
             scale,
         });
-        log_1.Log.verbose(cli_1.CliInternals.chalk.gray(`Bucket = ${res.bucketName}, renderId = ${res.renderId}, functionName = ${functionName}`));
-        log_1.Log.verbose(`CloudWatch logs (if enabled): ${(0, get_cloudwatch_stream_url_1.getCloudwatchStreamUrl)({
-            functionName,
-            region: (0, get_aws_region_1.getAwsRegion)(),
-            renderId: res.renderId,
-            method: constants_1.LambdaRoutines.still,
-        })}`);
-        if (outName) {
+        log_1.Log.info(cli_1.CliInternals.chalk.gray(`Bucket = ${res.bucketName}, renderId = ${res.renderId}`));
+        log_1.Log.verbose(`CloudWatch logs (if enabled): ${res.cloudWatchLogs}`);
+        if (downloadName) {
             log_1.Log.info('Finished rendering. Downloading...');
             const { outputPath, sizeInBytes } = await (0, download_media_1.downloadMedia)({
                 bucketName: res.bucketName,
-                outPath: outName,
+                outPath: downloadName,
                 region: (0, get_aws_region_1.getAwsRegion)(),
                 renderId: res.renderId,
             });
@@ -86,7 +90,7 @@ const stillCommand = async (args) => {
         }
     }
     catch (err) {
-        const frames = renderer_1.RenderInternals.parseStack(((_d = err.stack) !== null && _d !== void 0 ? _d : '').split('\n'));
+        const frames = renderer_1.RenderInternals.parseStack(((_f = err.stack) !== null && _f !== void 0 ? _f : '').split('\n'));
         const errorWithStackFrame = new renderer_1.RenderInternals.SymbolicateableError({
             message: err.message,
             frame: null,

package/dist/cli/get-aws-region.js

@@ -6,6 +6,7 @@ const is_in_lambda_1 = require("../shared/is-in-lambda");
 const validate_aws_region_1 = require("../shared/validate-aws-region");
 const args_1 = require("./args");
 const getAwsRegion = () => {
+    var _a;
     if ((0, is_in_lambda_1.isInsideLambda)()) {
         throw new Error('Should not call getAwsRegion() if in lambda');
     }
@@ -13,7 +14,7 @@ const getAwsRegion = () => {
         (0, validate_aws_region_1.validateAwsRegion)(args_1.parsedLambdaCli.region);
         return args_1.parsedLambdaCli.region;
     }
-    const envVariable = process.env.AWS_REGION;
+    const envVariable = (_a = process.env.REMOTION_AWS_REGION) !== null && _a !== void 0 ? _a : process.env.AWS_REGION;
     if (envVariable) {
         (0, validate_aws_region_1.validateAwsRegion)(envVariable);
         return envVariable;

package/dist/cli/helpers/determine-image-format.d.ts

@@ -0,0 +1,10 @@
+import type { ImageFormat, StillImageFormat } from '@remotion/renderer';
+export declare const getImageFormat: ({ downloadName, outName, configImageFormat, cliFlag, }: {
+    downloadName: string | null;
+    outName: string | null;
+    configImageFormat: ImageFormat | null;
+    cliFlag: ImageFormat | null;
+}) => {
+    format: StillImageFormat;
+    source: string;
+};

package/dist/cli/helpers/determine-image-format.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getImageFormat = void 0;
+const deriveExtensionFromFilename = (filename) => {
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.png')) {
+        return 'png';
+    }
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.jpg')) {
+        return 'jpeg';
+    }
+    if (filename === null || filename === void 0 ? void 0 : filename.endsWith('.jpeg')) {
+        return 'jpeg';
+    }
+    return null;
+};
+const getImageFormat = ({ downloadName, outName, configImageFormat, cliFlag, }) => {
+    const outNameExtension = deriveExtensionFromFilename(outName);
+    const downloadNameExtension = deriveExtensionFromFilename(downloadName);
+    if (outNameExtension &&
+        downloadNameExtension &&
+        outNameExtension !== downloadNameExtension) {
+        throw new TypeError(`Image format mismatch: ${outName} was given as the S3 output name and ${downloadName} was given as the download name, but the extensions don't match.`);
+    }
+    if (downloadNameExtension) {
+        if (cliFlag && downloadNameExtension !== cliFlag) {
+            throw new TypeError(`Image format mismatch: ${downloadName} was given as the download name, but --image-format=${cliFlag} was passed. The image formats must match.`);
+        }
+        return { format: downloadNameExtension, source: 'Download name extension' };
+    }
+    if (outNameExtension) {
+        if (cliFlag && outNameExtension !== cliFlag) {
+            throw new TypeError(`Image format mismatch: ${outName} was given as the S3 out name, but --image-format=${cliFlag} was passed. The image formats must match.`);
+        }
+        return { format: outNameExtension, source: 'Out name extension' };
+    }
+    if (cliFlag === 'none') {
+        throw new TypeError('The --image-format flag must not be "none" for stills.');
+    }
+    if (cliFlag !== null) {
+        return { format: cliFlag, source: '--image-format flag' };
+    }
+    if (configImageFormat !== null && configImageFormat !== 'none') {
+        return { format: configImageFormat, source: 'Config file' };
+    }
+    return { format: 'png', source: 'Default' };
+};
+exports.getImageFormat = getImageFormat;

package/dist/cli/helpers/find-function-name.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findFunctionName = void 0;
+const version_1 = require("remotion/version");
 const get_functions_1 = require("../../api/get-functions");
 const constants_1 = require("../../shared/constants");
 const functions_1 = require("../commands/functions");
@@ -15,9 +16,9 @@ const findFunctionName = async () => {
         region: (0, get_aws_region_1.getAwsRegion)(),
         compatibleOnly: false,
     });
-    const lambdasWithMatchingVersion = remotionLambdas.filter((l) => l.version === constants_1.CURRENT_VERSION);
+    const lambdasWithMatchingVersion = remotionLambdas.filter((l) => l.version === version_1.VERSION);
     if (lambdasWithMatchingVersion.length === 0) {
-        log_1.Log.error(`No lambda functions with version ${constants_1.CURRENT_VERSION} found in your account.`);
+        log_1.Log.error(`No lambda functions with version ${version_1.VERSION} found in your account.`);
         if (remotionLambdas.length > 0) {
             log_1.Log.error('Other functions were found, but are not compatible with this version of the CLI.');
         }

package/dist/cli/helpers/webhook-types.d.ts

@@ -0,0 +1,6 @@
+export declare type WebhookPayload = {
+    type: 'success' | 'error' | 'timeout';
+    renderId: string;
+    bucketName: string;
+    expectedBucketOwner: string;
+};

package/dist/cli/helpers/webhook-types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cli/index.js

@@ -133,7 +133,7 @@ AWS returned an "TooManyRequestsException" error message which could mean you re
 };
 exports.executeCommand = executeCommand;
 const cli = async () => {
-    await cli_1.CliInternals.initializeRenderCli(cli_1.CliInternals.findRemotionRoot(), 'lambda');
+    await cli_1.CliInternals.initializeCli(cli_1.CliInternals.findRemotionRoot());
     await (0, exports.executeCommand)(args_1.parsedLambdaCli._);
 };
 exports.cli = cli;

package/dist/client.d.ts

@@ -2,7 +2,9 @@ import { getFunctions } from './api/get-functions';
 import { getRenderProgress } from './api/get-render-progress';
 import { renderMediaOnLambda, renderVideoOnLambda } from './api/render-media-on-lambda';
 import { renderStillOnLambda } from './api/render-still-on-lambda';
+import { validateWebhookSignature } from './api/validate-webhook-signature';
 import type { AwsRegion } from './pricing/aws-regions';
 import type { RenderProgress } from './shared/constants';
-export { renderVideoOnLambda, renderMediaOnLambda, renderStillOnLambda, getRenderProgress, getFunctions, };
-export type { AwsRegion, RenderProgress };
+import type { WebhookPayload } from './shared/invoke-webhook';
+export { renderVideoOnLambda, renderMediaOnLambda, renderStillOnLambda, getRenderProgress, getFunctions, validateWebhookSignature, };
+export type { AwsRegion, RenderProgress, WebhookPayload };