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

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, LogLevel, PixelFormat, ProResProfile, VideoImageFormat } 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,20 @@ export declare type RenderMediaOnLambdaInput = {
     functionName: string;
     serveUrl: string;
     composition: string;
-    inputProps: unknown;
+    inputProps?: Record<string, unknown>;
     codec: LambdaCodec;
-    imageFormat: ImageFormat;
+    imageFormat?: VideoImageFormat;
     crf?: number | undefined;
     envVariables?: Record<string, string>;
     pixelFormat?: PixelFormat;
     proResProfile?: ProResProfile;
-    privacy: Privacy;
-    quality?: number;
-    maxRetries: number;
+    privacy?: Privacy;
+    /**
+     * @deprecated Renamed to `jpegQuality`
+     */
+    quality?: never;
+    jpegQuality?: number;
+    maxRetries?: number;
     framesPerLambda?: number;
     logLevel?: LogLevel;
     frameRange?: FrameRange;
@@ -29,31 +33,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.jpegQuality JPEG quality if JPEG was selected as the image format.
+ * @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: (input: 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: (input: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;

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

@@ -3,69 +3,61 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderVideoOnLambda = exports.renderMediaOnLambda = void 0;
 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 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");
+const get_aws_urls_1 = require("../shared/get-aws-urls");
+const make_lambda_payload_1 = require("./make-lambda-payload");
 /**
  * @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.jpegQuality JPEG quality if JPEG was selected as the image format.
+ * @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 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_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,
-    };
+const renderMediaOnLambda = async (input) => {
+    var _a;
+    const { functionName, region, rendererFunctionName } = input;
+    try {
+        const res = await (0, call_lambda_1.callLambda)({
+            functionName,
+            type: constants_1.LambdaRoutines.start,
+            payload: await (0, make_lambda_payload_1.makeLambdaRenderMediaPayload)(input),
+            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

@@ -7,12 +7,16 @@ export declare type RenderStillOnLambdaInput = {
     functionName: string;
     serveUrl: string;
     composition: string;
-    inputProps: unknown;
+    inputProps: Record<string, unknown>;
     imageFormat: StillImageFormat;
     privacy: Privacy;
     maxRetries?: number;
     envVariables?: Record<string, string>;
-    quality?: number;
+    /**
+     * @deprecated Renamed to `jpegQuality`
+     */
+    quality?: never;
+    jpegQuality?: number;
     frame?: number;
     logLevel?: LogLevel;
     outName?: OutNameInput;
@@ -20,6 +24,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 +35,7 @@ export declare type RenderStillOnLambdaOutput = {
     sizeInBytes: number;
     bucketName: string;
     renderId: string;
+    cloudWatchLogs: string;
 };
 /**
  * @description Renders a still frame on Lambda
@@ -37,11 +46,12 @@ export declare type RenderStillOnLambdaOutput = {
  * @param params.inputProps The input props that should be passed to the composition.
  * @param params.imageFormat In which image format the frames should be rendered.
  * @param params.envVariables Object containing environment variables to be inserted into the video environment
- * @param params.quality JPEG quality if JPEG was selected as the image format.
+ * @param params.jpegQuality 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.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, jpegQuality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, downloadBehavior, forceHeight, forceWidth, forceBucketName, dumpBrowserLogs, }: RenderStillOnLambdaInput) => Promise<RenderStillOnLambdaOutput>;

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_aws_urls_1 = require("../shared/get-aws-urls");
+const serialize_input_props_1 = require("../shared/serialize-input-props");
 /**
  * @description Renders a still frame on Lambda
  * @link https://remotion.dev/docs/lambda/renderstillonlambda
@@ -13,44 +15,74 @@ const convert_to_serve_url_1 = require("../shared/convert-to-serve-url");
  * @param params.inputProps The input props that should be passed to the composition.
  * @param params.imageFormat In which image format the frames should be rendered.
  * @param params.envVariables Object containing environment variables to be inserted into the video environment
- * @param params.quality JPEG quality if JPEG was selected as the image format.
+ * @param params.jpegQuality 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.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.
  */
-const renderStillOnLambda = async ({ functionName, serveUrl, inputProps, imageFormat, envVariables, quality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, 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.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' },
-        },
+const renderStillOnLambda = async ({ functionName, serveUrl, inputProps, imageFormat, envVariables, quality, jpegQuality, region, maxRetries, composition, privacy, frame, logLevel, outName, timeoutInMilliseconds, chromiumOptions, scale, downloadBehavior, forceHeight, forceWidth, forceBucketName, dumpBrowserLogs, }) => {
+    var _a;
+    if (quality) {
+        throw new Error('The `quality` option is deprecated. Use `jpegQuality` instead.');
+    }
+    const serializedInputProps = await (0, serialize_input_props_1.serializeInputProps)({
+        inputProps,
         region,
+        type: 'still',
+        userSpecifiedBucketName: forceBucketName !== null && forceBucketName !== void 0 ? forceBucketName : null,
     });
-    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,
+                inputProps: serializedInputProps,
+                imageFormat,
+                envVariables,
+                jpegQuality,
+                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,
+                forceHeight: forceHeight !== null && forceHeight !== void 0 ? forceHeight : null,
+                forceWidth: forceWidth !== null && forceWidth !== void 0 ? forceWidth : null,
+                bucketName: forceBucketName !== null && forceBucketName !== void 0 ? forceBucketName : null,
+                dumpBrowserLogs: dumpBrowserLogs !== null && dumpBrowserLogs !== void 0 ? dumpBrowserLogs : false,
+            },
+            region,
+        });
+        return {
+            estimatedPrice: res.estimatedPrice,
+            url: res.output,
+            sizeInBytes: res.size,
+            bucketName: res.bucketName,
+            renderId: res.renderId,
+            cloudWatchLogs: (0, get_aws_urls_1.getCloudwatchStreamUrl)({
+                functionName,
+                method: constants_1.LambdaRoutines.still,
+                region,
+                renderId: res.renderId,
+                rendererFunctionName: null,
+            }),
+        };
+    }
+    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/speculate-function-name.d.ts

@@ -0,0 +1,14 @@
+export declare type SpeculateFunctionNameInput = {
+    memorySizeInMb: string | number;
+    diskSizeInMb: string | number;
+    timeoutInSeconds: string | number;
+};
+/**
+ * @description Speculate the name of a lambda function that will be created when you call `deployFunction`, based on the function configuration.
+ * @see [Documentation](https://www.remotion.dev/docs/lambda/speculatefunctionname)
+ * @param params.memorySizeInMb How much memory is allocated to the Lambda function.
+ * @param params.diskSizeInMb The amount of storage the function is allocated.
+ * @param params.timeoutInSeconds Time in seconds until the function times out.
+ * @returns {string} The speculated lambda function name
+ */
+export declare const speculateFunctionName: ({ memorySizeInMb, diskSizeInMb, timeoutInSeconds, }: SpeculateFunctionNameInput) => string;

package/dist/api/speculate-function-name.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.speculateFunctionName = void 0;
+const defaults_1 = require("../defaults");
+const lambda_version_string_1 = require("../shared/lambda-version-string");
+/**
+ * @description Speculate the name of a lambda function that will be created when you call `deployFunction`, based on the function configuration.
+ * @see [Documentation](https://www.remotion.dev/docs/lambda/speculatefunctionname)
+ * @param params.memorySizeInMb How much memory is allocated to the Lambda function.
+ * @param params.diskSizeInMb The amount of storage the function is allocated.
+ * @param params.timeoutInSeconds Time in seconds until the function times out.
+ * @returns {string} The speculated lambda function name
+ */
+const speculateFunctionName = ({ memorySizeInMb, diskSizeInMb, timeoutInSeconds, }) => {
+    return [
+        `${defaults_1.RENDER_FN_PREFIX}${lambda_version_string_1.LAMBDA_VERSION_STRING}`,
+        `mem${memorySizeInMb}mb`,
+        `disk${diskSizeInMb}mb`,
+        `${timeoutInSeconds}sec`,
+    ].join('-');
+};
+exports.speculateFunctionName = speculateFunctionName;

package/dist/api/upload-dir.d.ts

@@ -11,11 +11,12 @@ export declare type MockFile = {
     content: string;
 };
 export declare const getDirFiles: (entry: string) => MockFile[];
-export declare const uploadDir: ({ bucket, region, dir, onProgress, folder, privacy, }: {
+export declare const uploadDir: ({ bucket, region, localDir, onProgress, keyPrefix, privacy, toUpload, }: {
     bucket: string;
     region: AwsRegion;
-    dir: string;
-    folder: string;
+    localDir: string;
+    keyPrefix: string;
     onProgress: (progress: UploadDirProgress) => void;
     privacy: Privacy;
+    toUpload: string[];
 }) => Promise<void>;

package/dist/api/upload-dir.js

@@ -4,76 +4,79 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadDir = exports.getDirFiles = void 0;
-const client_s3_1 = require("@aws-sdk/client-s3");
 const lib_storage_1 = require("@aws-sdk/lib-storage");
-const fs_1 = require("fs");
 const mime_types_1 = __importDefault(require("mime-types"));
-const path_1 = __importDefault(require("path"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
 const aws_clients_1 = require("../shared/aws-clients");
 const make_s3_key_1 = require("../shared/make-s3-key");
 const getDirFiles = (entry) => {
     throw new TypeError('should only be executed in test ' + JSON.stringify(entry));
 };
 exports.getDirFiles = getDirFiles;
-const uploadDir = async ({ bucket, region, dir, onProgress, folder, privacy, }) => {
-    async function getFiles(directory) {
-        const dirents = await fs_1.promises.readdir(directory, { withFileTypes: true });
-        const _files = await Promise.all(dirents.map(async (dirent) => {
-            const res = path_1.default.resolve(directory, dirent.name);
-            const { size } = await fs_1.promises.stat(res);
-            return dirent.isDirectory()
-                ? getFiles(res)
-                : [
-                    {
-                        name: res,
-                        size,
-                    },
-                ];
-        }));
-        return _files.flat(1);
-    }
-    const files = await getFiles(dir);
+async function getFiles(directory, originalDirectory, toUpload) {
+    const dirents = await node_fs_1.promises.readdir(directory, { withFileTypes: true });
+    const _files = await Promise.all(dirents
+        .map((dirent) => {
+        const res = node_path_1.default.resolve(directory, dirent.name);
+        return [dirent, res];
+    })
+        .filter(([dirent, res]) => {
+        const relative = node_path_1.default.relative(originalDirectory, res);
+        if (dirent.isDirectory()) {
+            return true;
+        }
+        if (!toUpload.includes(relative)) {
+            return false;
+        }
+        return true;
+    })
+        .map(async ([dirent, res]) => {
+        const { size } = await node_fs_1.promises.stat(res);
+        return dirent.isDirectory()
+            ? getFiles(res, originalDirectory, toUpload)
+            : [
+                {
+                    name: res,
+                    size,
+                },
+            ];
+    }));
+    return _files.flat(1);
+}
+const uploadDir = async ({ bucket, region, localDir, onProgress, keyPrefix, privacy, toUpload, }) => {
+    const files = await getFiles(localDir, localDir, toUpload);
     const progresses = {};
     for (const file of files) {
         progresses[file.name] = 0;
     }
-    const client = (0, aws_clients_1.getS3Client)(region);
-    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);
+    const client = (0, aws_clients_1.getS3Client)(region, null);
+    const uploads = files.map((filePath) => {
+        const Key = (0, make_s3_key_1.makeS3Key)(keyPrefix, localDir, filePath.name);
+        const Body = (0, node_fs_1.createReadStream)(filePath.name);
         const ContentType = mime_types_1.default.lookup(Key) || 'application/octet-stream';
         const ACL = privacy === 'no-acl'
             ? undefined
             : privacy === 'private'
                 ? 'private'
                 : 'public-read';
-        if (filePath.size > 5 * 1024 * 1024) {
-            const paralellUploads3 = new lib_storage_1.Upload({
-                client,
-                queueSize: 4,
-                partSize: 5 * 1024 * 1024,
-                params: {
-                    Key,
-                    Bucket: bucket,
-                    Body,
-                    ACL,
-                    ContentType,
-                },
-            });
-            paralellUploads3.on('httpUploadProgress', (progress) => {
-                var _a;
-                progresses[filePath.name] = (_a = progress.loaded) !== null && _a !== void 0 ? _a : 0;
-            });
-            return paralellUploads3.done();
-        }
-        await client.send(new client_s3_1.PutObjectCommand({
-            Key,
-            Bucket: bucket,
-            Body,
-            ACL,
-            ContentType,
-        }));
-        progresses[filePath.name] = filePath.size;
+        const paralellUploads3 = new lib_storage_1.Upload({
+            client,
+            queueSize: 4,
+            partSize: 5 * 1024 * 1024,
+            params: {
+                Key,
+                Bucket: bucket,
+                Body,
+                ACL,
+                ContentType,
+            },
+        });
+        paralellUploads3.on('httpUploadProgress', (progress) => {
+            var _a;
+            progresses[filePath.name] = (_a = progress.loaded) !== null && _a !== void 0 ? _a : 0;
+        });
+        return paralellUploads3.done();
     });
     const promise = Promise.all(uploads);
     const interval = setInterval(() => {