@remotion/lambda 4.0.0-alpha.4 → 4.0.0-alpha4

package/dist/api/get-render-progress.js

@@ -1,24 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRenderProgress = void 0;
+const version_1 = require("remotion/version");
 const call_lambda_1 = require("../shared/call-lambda");
 const constants_1 = require("../shared/constants");
 /**
  * @description Gets the current status of a render originally triggered via renderMediaOnLambda().
- * @link https://remotion.dev/docs/lambda/getrenderprogress
+ * @see [Documentation](https://remotion.dev/docs/lambda/getrenderprogress)
  * @param {string} params.functionName The name of the function used to trigger the render.
  * @param {string} params.bucketName The name of the bucket that was used in the render.
  * @param {string} params.renderId The ID of the render that was returned by `renderMediaOnLambda()`.
  * @param {AwsRegion} params.region The region in which the render was triggered.
+ * @param {CustomCredentials} params.s3OutputProvider? Endpoint and credentials if the output file is stored outside of AWS.
  * @returns {Promise<RenderProgress>} See documentation for this function to see all properties on the return object.
  */
-const getRenderProgress = async ({ functionName, bucketName, renderId, region, }) => {
+const getRenderProgress = async ({ functionName, bucketName, renderId, region, s3OutputProvider, }) => {
     const result = await (0, call_lambda_1.callLambda)({
         functionName,
         type: constants_1.LambdaRoutines.status,
         payload: {
             bucketName,
             renderId,
+            version: version_1.VERSION,
+            s3OutputProvider,
         },
         region,
     });

package/dist/api/get-sites.d.ts

@@ -9,15 +9,15 @@ declare type Site = {
 };
 export declare type GetSitesInput = {
     region: AwsRegion;
+    bucketName?: string;
 };
 export declare type GetSitesOutput = {
     sites: Site[];
     buckets: BucketWithLocation[];
 };
 /**
- *
  * @description Gets all the deployed sites for a certain AWS region.
- * @link https://remotion.dev/docs/lambda/getsites
+ * @see [Documentation](https://remotion.dev/docs/lambda/getsites)
  * @param {AwsRegion} params.region The AWS region that you want to query for.
  * @returns {Promise<GetSitesOutput>} A Promise containing an object with `sites` and `bucket` keys. Consult documentation for details.
  */

package/dist/api/get-sites.js

@@ -7,9 +7,8 @@ const get_account_id_1 = require("../shared/get-account-id");
 const make_s3_url_1 = require("../shared/make-s3-url");
 const get_buckets_1 = require("./get-buckets");
 /**
- *
  * @description Gets all the deployed sites for a certain AWS region.
- * @link https://remotion.dev/docs/lambda/getsites
+ * @see [Documentation](https://remotion.dev/docs/lambda/getsites)
  * @param {AwsRegion} params.region The AWS region that you want to query for.
  * @returns {Promise<GetSitesOutput>} A Promise containing an object with `sites` and `bucket` keys. Consult documentation for details.
  */

package/dist/api/iam-validation/simulate-rule.js

@@ -2,32 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simulateRule = void 0;
 const client_iam_1 = require("@aws-sdk/client-iam");
-const aws_policies_1 = require("aws-policies");
 const aws_clients_1 = require("../../shared/aws-clients");
 const simulateRule = async (options) => {
     var _a;
     try {
-        if (options.actionNames.includes(aws_policies_1.iam.GetUser)) {
-            try {
-                await (0, aws_clients_1.getIamClient)(options.region).send(new client_iam_1.GetUserCommand({}));
-                const result = [
-                    {
-                        decision: 'allowed',
-                        name: aws_policies_1.iam.GetUser,
-                    },
-                ];
-                return result;
-            }
-            catch (err) {
-                const result = [
-                    {
-                        decision: 'explicitDeny',
-                        name: aws_policies_1.iam.GetUser,
-                    },
-                ];
-                return result;
-            }
-        }
         const res = await (0, aws_clients_1.getIamClient)(options.region).send(new client_iam_1.SimulatePrincipalPolicyCommand({
             ActionNames: options.actionNames,
             PolicySourceArn: options.arn,

package/dist/api/iam-validation/simulate.d.ts

@@ -10,7 +10,7 @@ export declare type SimulatePermissionsOutput = {
 };
 /**
  * @description Simulates calls using the AWS Simulator to validate the correct permissions.
- * @link http://remotion.dev/docs/lambda/simulatepermissions
+ * @see [Documentation](http://remotion.dev/docs/lambda/simulatepermissions)
  * @param {AwsRegion} options.region The region which you would like to validate
  * @param {(result: SimulationResult) => void} options.onSimulation The region which you would like to validate
  * @returns {Promise<SimulatePermissionsOutput>} See documentation for detailed response structure.

package/dist/api/iam-validation/simulate.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.simulatePermissions = exports.logPermissionOutput = void 0;
-const client_iam_1 = require("@aws-sdk/client-iam");
+const client_sts_1 = require("@aws-sdk/client-sts");
 const aws_clients_1 = require("../../shared/aws-clients");
 const simulate_rule_1 = require("./simulate-rule");
 const user_permissions_1 = require("./user-permissions");
@@ -19,22 +19,41 @@ const logPermissionOutput = (output) => {
 exports.logPermissionOutput = logPermissionOutput;
 /**
  * @description Simulates calls using the AWS Simulator to validate the correct permissions.
- * @link http://remotion.dev/docs/lambda/simulatepermissions
+ * @see [Documentation](http://remotion.dev/docs/lambda/simulatepermissions)
  * @param {AwsRegion} options.region The region which you would like to validate
  * @param {(result: SimulationResult) => void} options.onSimulation The region which you would like to validate
  * @returns {Promise<SimulatePermissionsOutput>} See documentation for detailed response structure.
  */
 const simulatePermissions = async (options) => {
     var _a;
-    const user = await (0, aws_clients_1.getIamClient)(options.region).send(new client_iam_1.GetUserCommand({}));
-    if (!user || !user.User) {
-        throw new Error('No valid AWS user detected');
+    const callerIdentity = await (0, aws_clients_1.getStsClient)(options.region).send(new client_sts_1.GetCallerIdentityCommand({}));
+    if (!callerIdentity || !callerIdentity.Arn) {
+        throw new Error('No valid AWS Caller Identity detected');
+    }
+    const callerIdentityArnComponents = callerIdentity.Arn.match(/arn:aws:([^:]+)::(\d+):([^/]+)(.*)/);
+    if (!callerIdentityArnComponents) {
+        throw new Error('Unknown AWS Caller Identity ARN detected');
+    }
+    const callerIdentityArnType = callerIdentityArnComponents[1];
+    let callerArn;
+    if (callerIdentityArnType === 'iam' && callerIdentityArnComponents[3] === 'user') {
+        callerArn = callerIdentity.Arn;
+    }
+    else if (callerIdentityArnType === 'sts' && callerIdentityArnComponents[3] === 'assumed-role') {
+        const assumedRoleComponents = callerIdentityArnComponents[4].match(/\/([^/]+)\/(.*)/);
+        if (!assumedRoleComponents) {
+            throw new Error('Unsupported AWS Caller Identity as Assumed-Role ARN detected');
+        }
+        callerArn = `arn:aws:iam::${callerIdentityArnComponents[2]}:role/${assumedRoleComponents[1]}`;
+    }
+    else {
+        throw new Error('Unsupported AWS Caller Identity ARN detected');
     }
     const results = [];
     for (const per of user_permissions_1.requiredPermissions) {
         const result = await (0, simulate_rule_1.simulateRule)({
             actionNames: per.actions,
-            arn: user.User.Arn,
+            arn: callerArn,
             region: options.region,
             resource: per.resource,
             retries: 2,

package/dist/api/iam-validation/user-permissions.d.ts

@@ -1,6 +1,6 @@
 import { iam, lambda, logs, s3, servicequotas } from 'aws-policies';
 export declare const requiredPermissions: {
-    actions: (s3 | iam | lambda | logs | servicequotas)[];
+    actions: (s3 | iam | lambda | 'lambda:PutRuntimeManagementConfig' | logs | servicequotas)[];
     resource: string[];
     id: string;
 }[];

package/dist/api/iam-validation/user-permissions.js

@@ -15,12 +15,6 @@ exports.requiredPermissions = [
         ],
         resource: ['*'],
     },
-    {
-        id: 'Identity',
-        actions: [aws_policies_1.iam.GetUser],
-        // eslint-disable-next-line no-template-curly-in-string
-        resource: ['arn:aws:iam::*:user/${aws:username}'],
-    },
     {
         id: 'PermissionValidation',
         actions: [aws_policies_1.iam.SimulatePrincipalPolicy],
@@ -43,8 +37,8 @@ exports.requiredPermissions = [
             aws_policies_1.s3.GetBucketLocation,
             aws_policies_1.s3.PutBucketAcl,
             aws_policies_1.s3.DeleteBucket,
-            aws_policies_1.s3.PutBucketWebsite,
-            aws_policies_1.s3.DeleteBucketWebsite,
+            aws_policies_1.s3.PutBucketOwnershipControls,
+            aws_policies_1.s3.PutBucketPublicAccessBlock,
         ],
         resource: [`arn:aws:s3:::${constants_1.REMOTION_BUCKET_PREFIX}*`],
     },
@@ -66,6 +60,7 @@ exports.requiredPermissions = [
             aws_policies_1.lambda.CreateFunction,
             aws_policies_1.lambda.DeleteFunction,
             aws_policies_1.lambda.PutFunctionEventInvokeConfig,
+            'lambda:PutRuntimeManagementConfig',
         ],
         resource: [`arn:aws:lambda:*:*:function:${constants_1.RENDER_FN_PREFIX}*`],
     },

package/dist/api/mock-functions.d.ts

@@ -1,19 +1,18 @@
 import type { AwsRegion } from '../pricing/aws-regions';
-import type { LambdaVersions } from '../shared/constants';
 import type { FunctionInfo } from './get-function-info';
 export declare let mockFunctionsStore: (FunctionInfo & {
     region: AwsRegion;
-    version: LambdaVersions;
+    version: string;
 })[];
 export declare const addFunction: (fn: FunctionInfo, region: AwsRegion) => void;
 export declare const deleteMockFunction: (name: string, region: string) => void;
 export declare const findFunction: (name: string, region: string) => (FunctionInfo & {
     region: AwsRegion;
-    version: LambdaVersions;
+    version: string;
 }) | undefined;
-export declare const getAllMockFunctions: (region: string, version: LambdaVersions | null) => (FunctionInfo & {
+export declare const getAllMockFunctions: (region: string, version: string | null) => (FunctionInfo & {
     region: AwsRegion;
-    version: LambdaVersions;
+    version: string;
 })[];
 export declare const cleanFnStore: () => void;
 export declare const markFunctionAsIncompatible: (functionName: string) => void;

package/dist/api/presign-url.d.ts

@@ -1,14 +1,14 @@
 import type { AwsRegion } from '../pricing/aws-regions';
-declare type PresignURLInput = {
+export declare type PresignUrlInput<CheckIfObjectExists extends boolean = boolean> = {
     region: AwsRegion;
     bucketName: string;
     objectKey: string;
-    checkIfObjectExists?: boolean;
+    checkIfObjectExists?: CheckIfObjectExists;
     expiresInSeconds: number;
 };
 /**
  * @description Returns a public url of an object stored in Remotion's S3 bucket.
- * @link https://remotion.dev/docs/lambda/presignurl
+ * @see [Documentation](https://remotion.dev/docs/lambda/presignurl)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.bucketName The name of the bucket to fetch the object from.
  * @param {string} params.objectKey Key of the S3 object to get.
@@ -16,5 +16,4 @@ declare type PresignURLInput = {
  * @param {boolean} params.checkIfObjectExists Whether the function should check if the object exists in the bucket before generating the presigned url.
  * @returns {Promise<string | null>} The public url of an object or `null` if `checkIfObjectExists=true` & object does not exist.
  */
-export declare const presignUrl: ({ region, bucketName, objectKey, checkIfObjectExists, expiresInSeconds, }: PresignURLInput) => Promise<string | null>;
-export {};
+export declare const presignUrl: <CheckIfObjectExists extends boolean = false>({ region, bucketName, objectKey, checkIfObjectExists, expiresInSeconds, }: PresignUrlInput<CheckIfObjectExists>) => Promise<CheckIfObjectExists extends true ? string | null : string>;

package/dist/api/presign-url.js

@@ -8,7 +8,7 @@ const validate_bucketname_1 = require("../shared/validate-bucketname");
 const validate_presign_expiration_1 = require("../shared/validate-presign-expiration");
 /**
  * @description Returns a public url of an object stored in Remotion's S3 bucket.
- * @link https://remotion.dev/docs/lambda/presignurl
+ * @see [Documentation](https://remotion.dev/docs/lambda/presignurl)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.bucketName The name of the bucket to fetch the object from.
  * @param {string} params.objectKey Key of the S3 object to get.
@@ -16,11 +16,11 @@ const validate_presign_expiration_1 = require("../shared/validate-presign-expira
  * @param {boolean} params.checkIfObjectExists Whether the function should check if the object exists in the bucket before generating the presigned url.
  * @returns {Promise<string | null>} The public url of an object or `null` if `checkIfObjectExists=true` & object does not exist.
  */
-const presignUrl = async ({ region, bucketName, objectKey, checkIfObjectExists = false, expiresInSeconds, }) => {
+const presignUrl = async ({ region, bucketName, objectKey, checkIfObjectExists, expiresInSeconds, }) => {
     (0, validate_bucketname_1.validateBucketName)(bucketName, { mustStartWithRemotion: false });
     (0, validate_presign_expiration_1.validatePresignExpiration)(expiresInSeconds);
-    const s3Client = (0, aws_clients_1.getS3Client)(region);
-    if (checkIfObjectExists) {
+    const s3Client = (0, aws_clients_1.getS3Client)(region, null);
+    if (checkIfObjectExists === true) {
         try {
             await s3Client.send(new client_s3_1.HeadObjectCommand({
                 Bucket: bucketName,
@@ -31,6 +31,11 @@ const presignUrl = async ({ region, bucketName, objectKey, checkIfObjectExists =
             if (err.name === 'NotFound') {
                 return null;
             }
+            if (err.message === 'UnknownError' ||
+                err.$metadata
+                    .httpStatusCode === 403) {
+                throw new Error(`Unable to access item "${objectKey}" from bucket "${bucketName}". You must have permission for both "s3:GetObject" and "s3:ListBucket" actions.`);
+            }
             throw err;
         }
     }

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

@@ -1,4 +1,4 @@
-import type { ChromiumOptions, FrameRange, ImageFormat, LogLevel, PixelFormat, ProResProfile } from '@remotion/renderer';
+import type { AudioCodec, ChromiumOptions, FrameRange, ImageFormat, LogLevel, PixelFormat, ProResProfile } from '@remotion/renderer';
 import type { AwsRegion } from '../pricing/aws-regions';
 import type { OutNameInput, Privacy } from '../shared/constants';
 import type { DownloadBehavior } from '../shared/content-disposition-header';
@@ -8,16 +8,16 @@ export declare type RenderMediaOnLambdaInput = {
     functionName: string;
     serveUrl: string;
     composition: string;
-    inputProps: unknown;
+    inputProps?: unknown;
     codec: LambdaCodec;
-    imageFormat: ImageFormat;
+    imageFormat?: ImageFormat;
     crf?: number | undefined;
     envVariables?: Record<string, string>;
     pixelFormat?: PixelFormat;
     proResProfile?: ProResProfile;
-    privacy: Privacy;
+    privacy?: Privacy;
     quality?: number;
-    maxRetries: number;
+    maxRetries?: number;
     framesPerLambda?: number;
     logLevel?: LogLevel;
     frameRange?: FrameRange;
@@ -29,31 +29,49 @@ export declare type RenderMediaOnLambdaInput = {
     numberOfGifLoops?: number | null;
     concurrencyPerLambda?: number;
     downloadBehavior?: DownloadBehavior | null;
+    muted?: boolean;
+    overwrite?: boolean;
+    audioBitrate?: string | null;
+    videoBitrate?: string | null;
+    webhook?: {
+        url: string;
+        secret: string | null;
+    };
+    forceWidth?: number | null;
+    forceHeight?: number | null;
+    rendererFunctionName?: string | null;
+    forceBucketName?: string;
+    audioCodec?: AudioCodec | null;
+    dumpBrowserLogs?: boolean;
 };
 export declare type RenderMediaOnLambdaOutput = {
     renderId: string;
     bucketName: string;
+    cloudWatchLogs: string;
+    folderInS3Console: string;
 };
 /**
  * @description Triggers a render on a lambda given a composition and a lambda function.
- * @link https://remotion.dev/docs/lambda/rendermediaonlambda
+ * @see [Documentation](https://remotion.dev/docs/lambda/rendermediaonlambda)
  * @param params.functionName The name of the Lambda function that should be used
  * @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 Configuration for webhook called upon completion or timeout of the render.
+ * @param params.dumpBrowserLogs Whether to print browser logs to CloudWatch
  * @returns {Promise<RenderMediaOnLambdaOutput>} See documentation for detailed structure
  */
-export declare const renderMediaOnLambda: ({ 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, }: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;
+export declare const renderMediaOnLambda: ({ 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, audioBitrate, videoBitrate, webhook, forceHeight, forceWidth, rendererFunctionName, forceBucketName: bucketName, audioCodec, dumpBrowserLogs, }: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;
 /**
  * @deprecated Renamed to renderMediaOnLambda()
  */
-export declare const renderVideoOnLambda: ({ 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, }: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;
+export declare const renderVideoOnLambda: ({ 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, audioBitrate, videoBitrate, webhook, forceHeight, forceWidth, rendererFunctionName, forceBucketName: bucketName, audioCodec, dumpBrowserLogs, }: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;

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

@@ -1,71 +1,116 @@
 "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_aws_urls_1 = require("../shared/get-aws-urls");
+const serialize_input_props_1 = require("../shared/serialize-input-props");
 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");
 const validate_serveurl_1 = require("../shared/validate-serveurl");
 /**
  * @description Triggers a render on a lambda given a composition and a lambda function.
- * @link https://remotion.dev/docs/lambda/rendermediaonlambda
+ * @see [Documentation](https://remotion.dev/docs/lambda/rendermediaonlambda)
  * @param params.functionName The name of the Lambda function that should be used
  * @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 Configuration for webhook called upon completion or timeout of the render.
+ * @param params.dumpBrowserLogs Whether to print browser logs to CloudWatch
  * @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, audioBitrate, videoBitrate, webhook, forceHeight, forceWidth, rendererFunctionName, forceBucketName: bucketName, audioCodec, dumpBrowserLogs, }) => {
+    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' },
-        },
+    const serializedInputProps = await (0, serialize_input_props_1.serializeInputProps)({
+        inputProps,
         region,
+        type: 'video-or-audio',
+        userSpecifiedBucketName: bucketName !== null && bucketName !== void 0 ? bucketName : null,
     });
-    return {
-        renderId: res.renderId,
-        bucketName: res.bucketName,
-    };
+    try {
+        const res = await (0, call_lambda_1.callLambda)({
+            functionName,
+            type: constants_1.LambdaRoutines.start,
+            payload: {
+                rendererFunctionName: rendererFunctionName !== null && rendererFunctionName !== void 0 ? rendererFunctionName : null,
+                framesPerLambda: framesPerLambda !== null && framesPerLambda !== void 0 ? framesPerLambda : null,
+                composition,
+                serveUrl,
+                inputProps: serializedInputProps,
+                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,
+                audioBitrate: audioBitrate !== null && audioBitrate !== void 0 ? audioBitrate : null,
+                videoBitrate: videoBitrate !== null && videoBitrate !== void 0 ? videoBitrate : null,
+                webhook: webhook !== null && webhook !== void 0 ? webhook : null,
+                forceHeight: forceHeight !== null && forceHeight !== void 0 ? forceHeight : null,
+                forceWidth: forceWidth !== null && forceWidth !== void 0 ? forceWidth : null,
+                bucketName: bucketName !== null && bucketName !== void 0 ? bucketName : null,
+                audioCodec: audioCodec !== null && audioCodec !== void 0 ? audioCodec : null,
+                dumpBrowserLogs: dumpBrowserLogs !== null && dumpBrowserLogs !== void 0 ? dumpBrowserLogs : false,
+            },
+            region,
+        });
+        return {
+            renderId: res.renderId,
+            bucketName: res.bucketName,
+            cloudWatchLogs: (0, get_aws_urls_1.getCloudwatchStreamUrl)({
+                functionName,
+                method: constants_1.LambdaRoutines.renderer,
+                region,
+                renderId: res.renderId,
+                rendererFunctionName: rendererFunctionName !== null && rendererFunctionName !== void 0 ? rendererFunctionName : null,
+            }),
+            folderInS3Console: (0, get_aws_urls_1.getS3RenderUrl)({
+                bucketName: res.bucketName,
+                renderId: res.renderId,
+                region,
+            }),
+        };
+    }
+    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

@@ -20,6 +20,10 @@ export declare type RenderStillOnLambdaInput = {
     chromiumOptions?: ChromiumOptions;
     scale?: number;
     downloadBehavior?: DownloadBehavior;
+    forceWidth?: number | null;
+    forceHeight?: number | null;
+    forceBucketName?: string;
+    dumpBrowserLogs?: boolean;
 };
 export declare type RenderStillOnLambdaOutput = {
     estimatedPrice: CostsInfo;
@@ -27,6 +31,7 @@ export declare type RenderStillOnLambdaOutput = {
     sizeInBytes: number;
     bucketName: string;
     renderId: string;
+    cloudWatchLogs: string;
 };
 /**
  * @description Renders a still frame on Lambda
@@ -42,6 +47,7 @@ export declare type RenderStillOnLambdaOutput = {
  * @param params.maxRetries How often rendering a chunk may fail before the video render gets aborted.
  * @param params.frame Which frame should be used for the still image. Default 0.
  * @param params.privacy Whether the item in the S3 bucket should be public. Possible values: `"private"` and `"public"`
+ * @param params.dumpBrowserLogs Whether to print browser logs to CloudWatch.
  * @returns {Promise<RenderStillOnLambdaOutput>} See documentation for exact response structure.
  */
-export declare const renderStillOnLambda: ({ functionName, serveUrl, inputProps, imageFormat, envVariables, quality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, downloadBehavior, }: RenderStillOnLambdaInput) => Promise<RenderStillOnLambdaOutput>;
+export declare const renderStillOnLambda: ({ functionName, serveUrl, inputProps, imageFormat, envVariables, quality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, downloadBehavior, forceHeight, forceWidth, forceBucketName, dumpBrowserLogs, }: RenderStillOnLambdaInput) => Promise<RenderStillOnLambdaOutput>;