@remotion/lambda 4.0.0-audio.37 → 4.0.0-audio.9

package/dist/api/get-or-create-bucket.d.ts

@@ -1,16 +1,16 @@
-import { AwsRegion } from '../pricing/aws-regions';
+import type { AwsRegion } from '../pricing/aws-regions';
 export declare type GetOrCreateBucketInput = {
     region: AwsRegion;
     onBucketEnsured?: () => void;
 };
 export declare type GetOrCreateBucketOutput = {
     bucketName: string;
+    alreadyExisted: boolean;
 };
 /**
  * @description Creates a bucket for Remotion Lambda in your S3 account. If one already exists, it will get returned instead.
- * @link https://remotion.dev/docs/lambda/getorcreatebucket
+ * @see [Documentation](https://remotion.dev/docs/lambda/getorcreatebucket)
  * @param options.region The region in which you want your S3 bucket to reside in.
  * @returns {Promise<GetOrCreateBucketOutput>} An object containing the `bucketName`.
  */
 export declare const getOrCreateBucket: (options: GetOrCreateBucketInput) => Promise<GetOrCreateBucketOutput>;
-//# sourceMappingURL=get-or-create-bucket.d.ts.map

package/dist/api/get-or-create-bucket.js

@@ -2,13 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOrCreateBucket = void 0;
 const constants_1 = require("../shared/constants");
-const random_hash_1 = require("../shared/random-hash");
+const validate_bucketname_1 = require("../shared/validate-bucketname");
 const create_bucket_1 = require("./create-bucket");
-const enable_s3_website_1 = require("./enable-s3-website");
 const get_buckets_1 = require("./get-buckets");
 /**
  * @description Creates a bucket for Remotion Lambda in your S3 account. If one already exists, it will get returned instead.
- * @link https://remotion.dev/docs/lambda/getorcreatebucket
+ * @see [Documentation](https://remotion.dev/docs/lambda/getorcreatebucket)
  * @param options.region The region in which you want your S3 bucket to reside in.
  * @returns {Promise<GetOrCreateBucketOutput>} An object containing the `bucketName`.
  */
@@ -16,23 +15,18 @@ const getOrCreateBucket = async (options) => {
     var _a, _b;
     const { remotionBuckets } = await (0, get_buckets_1.getRemotionS3Buckets)(options.region);
     if (remotionBuckets.length > 1) {
-        throw new Error(`You have multiple buckets (${remotionBuckets.map((b) => b.name)}) in your S3 region (${options.region}) starting with "${constants_1.REMOTION_BUCKET_PREFIX}". This is an error, please delete buckets so that you have one maximum.`);
+        throw new Error(`You have multiple buckets (${remotionBuckets.map((b) => b.name)}) in your S3 region (${options.region}) starting with "${constants_1.REMOTION_BUCKET_PREFIX}". Please see https://remotion.dev/docs/lambda/multiple-buckets.`);
     }
     if (remotionBuckets.length === 1) {
         (_a = options.onBucketEnsured) === null || _a === void 0 ? void 0 : _a.call(options);
-        return { bucketName: remotionBuckets[0].name };
+        return { bucketName: remotionBuckets[0].name, alreadyExisted: true };
     }
-    const bucketName = constants_1.REMOTION_BUCKET_PREFIX + (0, random_hash_1.randomHash)();
+    const bucketName = (0, validate_bucketname_1.makeBucketName)(options.region);
     await (0, create_bucket_1.createBucket)({
         bucketName,
         region: options.region,
     });
     (_b = options.onBucketEnsured) === null || _b === void 0 ? void 0 : _b.call(options);
-    await (0, enable_s3_website_1.enableS3Website)({
-        region: options.region,
-        bucketName,
-    });
-    return { bucketName };
+    return { bucketName, alreadyExisted: false };
 };
 exports.getOrCreateBucket = getOrCreateBucket;
-//# sourceMappingURL=get-or-create-bucket.js.map

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

@@ -1,8 +1,11 @@
-import { AwsRegion } from '../pricing/aws-regions';
+import type { AwsRegion } from '../pricing/aws-regions';
+declare type Options = {
+    enabledByDefaultOnly?: boolean;
+};
 /**
  * @description Gets an array of all supported AWS regions of this release of Remotion Lambda.
- * @link https://remotion.dev/docs/lambda/getregions
+ * @see [Documentation](https://remotion.dev/docs/lambda/getregions)
  * @returns {AwsRegion[]} A list of AWS regions.
  */
-export declare const getRegions: () => readonly AwsRegion[];
-//# sourceMappingURL=get-regions.d.ts.map
+export declare const getRegions: (options?: Options) => readonly AwsRegion[];
+export {};

package/dist/api/get-regions.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRegions = void 0;
+const aws_regions_1 = require("../pricing/aws-regions");
 const regions_1 = require("../regions");
 /**
  * @description Gets an array of all supported AWS regions of this release of Remotion Lambda.
- * @link https://remotion.dev/docs/lambda/getregions
+ * @see [Documentation](https://remotion.dev/docs/lambda/getregions)
  * @returns {AwsRegion[]} A list of AWS regions.
  */
-const getRegions = () => {
-    return regions_1.AWS_REGIONS;
+const getRegions = (options) => {
+    var _a;
+    const onlyEnabledByDefault = (_a = options === null || options === void 0 ? void 0 : options.enabledByDefaultOnly) !== null && _a !== void 0 ? _a : false;
+    return onlyEnabledByDefault ? aws_regions_1.DEFAULT_AWS_REGIONS : regions_1.AWS_REGIONS;
 };
 exports.getRegions = getRegions;
-//# sourceMappingURL=get-regions.js.map

package/dist/api/get-render-progress.d.ts

@@ -1,19 +1,21 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { RenderProgress } from '../shared/constants';
+import type { AwsRegion } from '../pricing/aws-regions';
+import type { CustomCredentials } from '../shared/aws-clients';
+import type { RenderProgress } from '../shared/constants';
 export declare type GetRenderInput = {
     functionName: string;
     bucketName: string;
     renderId: string;
     region: AwsRegion;
+    s3OutputProvider?: CustomCredentials;
 };
 /**
  * @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.
  */
-export declare const getRenderProgress: ({ functionName, bucketName, renderId, region, }: GetRenderInput) => Promise<RenderProgress>;
-//# sourceMappingURL=get-render-progress.d.ts.map
+export declare const getRenderProgress: ({ functionName, bucketName, renderId, region, s3OutputProvider, }: GetRenderInput) => Promise<RenderProgress>;

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

@@ -1,28 +1,31 @@
 "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,
     });
     return result;
 };
 exports.getRenderProgress = getRenderProgress;
-//# sourceMappingURL=get-render-progress.js.map

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

@@ -1,5 +1,5 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { BucketWithLocation } from './get-buckets';
+import type { AwsRegion } from '../pricing/aws-regions';
+import type { BucketWithLocation } from './get-buckets';
 declare type Site = {
     sizeInBytes: number;
     lastModified: number | null;
@@ -9,18 +9,17 @@ 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.
  */
 export declare const getSites: ({ region, }: GetSitesInput) => Promise<GetSitesOutput>;
 export {};
-//# sourceMappingURL=get-sites.d.ts.map

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.
  */
@@ -62,4 +61,3 @@ const getSites = async ({ region, }) => {
     return { sites: sitesArray, buckets: remotionBuckets };
 };
 exports.getSites = getSites;
-//# sourceMappingURL=get-sites.js.map

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

@@ -1,6 +1,6 @@
-import { iam, lambda, logs, s3 } from 'aws-policies';
+import type { iam } from 'aws-policies';
+import { lambda, logs, s3 } from 'aws-policies';
 export declare const rolePermissions: {
     actions: (s3 | iam | lambda | logs)[];
     resource: string[];
 }[];
-//# sourceMappingURL=role-permissions.d.ts.map

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

@@ -32,4 +32,3 @@ exports.rolePermissions = [
         ],
     },
 ];
-//# sourceMappingURL=role-permissions.js.map

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

@@ -1,4 +1,4 @@
-import { AwsRegion } from '../../pricing/aws-regions';
+import type { AwsRegion } from '../../pricing/aws-regions';
 export declare type EvalDecision = 'allowed' | 'explicitDeny' | 'implicitDeny';
 export declare type SimulationResult = {
     decision: EvalDecision;
@@ -11,4 +11,3 @@ export declare const simulateRule: (options: {
     resource: string[];
     retries: number;
 }) => Promise<SimulationResult[]>;
-//# sourceMappingURL=simulate-rule.d.ts.map

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,
@@ -53,4 +31,3 @@ const simulateRule = async (options) => {
     }
 };
 exports.simulateRule = simulateRule;
-//# sourceMappingURL=simulate-rule.js.map

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

@@ -1,5 +1,5 @@
-import { AwsRegion } from '../../pricing/aws-regions';
-import { SimulationResult } from './simulate-rule';
+import type { AwsRegion } from '../../pricing/aws-regions';
+import type { SimulationResult } from './simulate-rule';
 export declare const logPermissionOutput: (output: SimulationResult) => string;
 export declare type SimulatePermissionsInput = {
     region: AwsRegion;
@@ -10,10 +10,9 @@ 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.
  */
 export declare const simulatePermissions: (options: SimulatePermissionsInput) => Promise<SimulatePermissionsOutput>;
-//# sourceMappingURL=simulate.d.ts.map

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,
@@ -47,4 +66,3 @@ const simulatePermissions = async (options) => {
     return { results };
 };
 exports.simulatePermissions = simulatePermissions;
-//# sourceMappingURL=simulate.js.map

package/dist/api/iam-validation/suggested-policy.d.ts

@@ -9,4 +9,3 @@ export declare const ROLE_NAME = "remotion-lambda-role";
  * @link https://remotion.dev/docs/lambda/getrolepolicy
  */
 export declare const getRolePolicy: () => string;
-//# sourceMappingURL=suggested-policy.d.ts.map

package/dist/api/iam-validation/suggested-policy.js

@@ -42,4 +42,3 @@ exports.ROLE_NAME = 'remotion-lambda-role';
  */
 const getRolePolicy = () => JSON.stringify(suggestedRolePolicy, null, 2);
 exports.getRolePolicy = getRolePolicy;
-//# sourceMappingURL=suggested-policy.js.map

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

@@ -1,7 +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;
 }[];
-//# sourceMappingURL=user-permissions.d.ts.map

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,6 @@ 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,
         ],
         resource: [`arn:aws:s3:::${constants_1.REMOTION_BUCKET_PREFIX}*`],
     },
@@ -66,6 +58,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}*`],
     },
@@ -82,4 +75,3 @@ exports.requiredPermissions = [
         resource: [hosted_layers_1.REMOTION_HOSTED_LAYER_ARN],
     },
 ];
-//# sourceMappingURL=user-permissions.js.map

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

@@ -1,20 +1,18 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { LambdaVersions } from '../shared/constants';
-import { FunctionInfo } from './get-function-info';
+import type { AwsRegion } from '../pricing/aws-regions';
+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;
-//# sourceMappingURL=mock-functions.d.ts.map

package/dist/api/mock-functions.js

@@ -34,4 +34,3 @@ const markFunctionAsIncompatible = (functionName) => {
     }
 };
 exports.markFunctionAsIncompatible = markFunctionAsIncompatible;
-//# sourceMappingURL=mock-functions.js.map

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

@@ -1,14 +1,14 @@
-import { AwsRegion } from '../pricing/aws-regions';
-export declare type PresignURLInput = {
+import type { AwsRegion } from '../pricing/aws-regions';
+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 @@ export 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>;
-//# sourceMappingURL=presign-url.d.ts.map
+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;
         }
     }
@@ -44,4 +49,3 @@ const presignUrl = async ({ region, bucketName, objectKey, checkIfObjectExists =
     return publicUrl;
 };
 exports.presignUrl = presignUrl;
-//# sourceMappingURL=presign-url.js.map

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

@@ -1,55 +1,77 @@
-import type { ChromiumOptions } from '@remotion/renderer';
-import { FrameRange, ImageFormat, LogLevel, PixelFormat, ProResProfile } from 'remotion';
-import { AwsRegion } from '../pricing/aws-regions';
-import { Privacy } from '../shared/constants';
+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';
+import type { LambdaCodec } from '../shared/validate-lambda-codec';
 export declare type RenderMediaOnLambdaInput = {
     region: AwsRegion;
     functionName: string;
     serveUrl: string;
     composition: string;
-    inputProps: unknown;
-    codec: 'h264-mkv' | 'mp3' | 'aac' | 'wav';
-    imageFormat: ImageFormat;
+    inputProps?: unknown;
+    codec: LambdaCodec;
+    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;
-    outName?: string;
+    outName?: OutNameInput;
     timeoutInMilliseconds?: number;
     chromiumOptions?: ChromiumOptions;
     scale?: number;
+    everyNthFrame?: number;
+    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, }: 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, }: RenderMediaOnLambdaInput) => Promise<RenderMediaOnLambdaOutput>;
-//# sourceMappingURL=render-media-on-lambda.d.ts.map
+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>;