@remotion/lambda 4.0.0-webhook.27 → 4.1.0-alpha3

package/dist/api/deploy-function.js

@@ -7,7 +7,6 @@ const constants_1 = require("../shared/constants");
 const function_zip_path_1 = require("../shared/function-zip-path");
 const get_account_id_1 = require("../shared/get-account-id");
 const lambda_version_string_1 = require("../shared/lambda-version-string");
-const validate_architecture_1 = require("../shared/validate-architecture");
 const validate_aws_region_1 = require("../shared/validate-aws-region");
 const validate_custom_role_arn_1 = require("../shared/validate-custom-role-arn");
 const validate_disk_size_in_mb_1 = require("../shared/validate-disk-size-in-mb");
@@ -17,54 +16,52 @@ const validate_timeout_1 = require("../shared/validate-timeout");
 const create_function_1 = require("./create-function");
 /**
  * @description Creates an AWS Lambda function in your account that will be able to render a video in the cloud.
- * @link https://remotion.dev/docs/lambda/deployfunction
- * @param options.createCloudWatchLogGroup Whether you'd like to create a CloudWatch Log Group to store the logs for this function.
- * @param options.cloudWatchLogRetentionPeriodInDays (optional) The number of days to retain the CloudWatch logs for this function. Default is 14 days.
- * @param options.region The region you want to deploy your function to.
- * @param options.timeoutInSeconds After how many seconds the lambda function should be killed if it does not end itself.
- * @param options.memorySizeInMb How much memory should be allocated to the Lambda function.
- * @param options.architecture The architecture Lambda should run on. One of x86_64 and x64
- * @param options.diskSizeInMb The amount of storage the function should be allocated. The higher, the longer videos you can render. Default 512.
+ * @see [Documentation](https://www.remotion.dev/docs/lambda/deployfunction)
+ * @param params.createCloudWatchLogGroup Whether you'd like to create a CloudWatch Log Group to store the logs for this function.
+ * @param params.cloudWatchLogRetentionPeriodInDays (optional) The number of days to retain the CloudWatch logs for this function. Default is 14 days.
+ * @param params.region The region you want to deploy your function to.
+ * @param params.timeoutInSeconds After how many seconds the lambda function should be killed if it does not end itself.
+ * @param params.memorySizeInMb How much memory should be allocated to the Lambda function.
+ * @param params.architecture The architecture Lambda should run on. One of x86_64 and x64
+ * @param params.diskSizeInMb The amount of storage the function should be allocated. The higher, the longer videos you can render. Default 512.
  * @returns {Promise<DeployFunctionOutput>} An object that contains the `functionName` property
  */
-const deployFunction = async (options) => {
+const deployFunction = async (params) => {
     var _a, _b;
-    const diskSizeInMb = (_a = options.diskSizeInMb) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_EPHEMERAL_STORAGE_IN_MB;
-    (0, validate_memory_size_1.validateMemorySize)(options.memorySizeInMb);
-    (0, validate_timeout_1.validateTimeout)(options.timeoutInSeconds);
-    (0, validate_aws_region_1.validateAwsRegion)(options.region);
-    (0, validate_retention_period_1.validateCloudWatchRetentionPeriod)(options.cloudWatchLogRetentionPeriodInDays);
-    (0, validate_architecture_1.validateArchitecture)(options.architecture);
+    const diskSizeInMb = (_a = params.diskSizeInMb) !== null && _a !== void 0 ? _a : constants_1.DEFAULT_EPHEMERAL_STORAGE_IN_MB;
+    (0, validate_memory_size_1.validateMemorySize)(params.memorySizeInMb);
+    (0, validate_timeout_1.validateTimeout)(params.timeoutInSeconds);
+    (0, validate_aws_region_1.validateAwsRegion)(params.region);
+    (0, validate_retention_period_1.validateCloudWatchRetentionPeriod)(params.cloudWatchLogRetentionPeriodInDays);
     (0, validate_disk_size_in_mb_1.validateDiskSizeInMb)(diskSizeInMb);
-    (0, validate_custom_role_arn_1.validateCustomRoleArn)(options.customRoleArn);
+    (0, validate_custom_role_arn_1.validateCustomRoleArn)(params.customRoleArn);
     const fnNameRender = [
         `${constants_1.RENDER_FN_PREFIX}${lambda_version_string_1.LAMBDA_VERSION_STRING}`,
-        `mem${options.memorySizeInMb}mb`,
+        `mem${params.memorySizeInMb}mb`,
         `disk${diskSizeInMb}mb`,
-        `${options.timeoutInSeconds}sec`,
+        `${params.timeoutInSeconds}sec`,
     ].join('-');
-    const accountId = await (0, get_account_id_1.getAccountId)({ region: options.region });
+    const accountId = await (0, get_account_id_1.getAccountId)({ region: params.region });
     const fns = await (0, get_functions_1.getFunctions)({
         compatibleOnly: true,
-        region: options.region,
+        region: params.region,
     });
     const alreadyDeployed = fns.find((f) => f.version === version_1.VERSION &&
-        f.memorySizeInMb === options.memorySizeInMb &&
-        f.timeoutInSeconds === options.timeoutInSeconds &&
+        f.memorySizeInMb === params.memorySizeInMb &&
+        f.timeoutInSeconds === params.timeoutInSeconds &&
         f.diskSizeInMb === diskSizeInMb);
     const created = await (0, create_function_1.createFunction)({
-        createCloudWatchLogGroup: options.createCloudWatchLogGroup,
-        region: options.region,
-        zipFile: function_zip_path_1.FUNCTION_ZIP,
+        createCloudWatchLogGroup: params.createCloudWatchLogGroup,
+        region: params.region,
+        zipFile: function_zip_path_1.FUNCTION_ZIP_ARM64,
         functionName: fnNameRender,
         accountId,
-        memorySizeInMb: options.memorySizeInMb,
-        timeoutInSeconds: options.timeoutInSeconds,
-        retentionInDays: (_b = options.cloudWatchLogRetentionPeriodInDays) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_CLOUDWATCH_RETENTION_PERIOD,
+        memorySizeInMb: params.memorySizeInMb,
+        timeoutInSeconds: params.timeoutInSeconds,
+        retentionInDays: (_b = params.cloudWatchLogRetentionPeriodInDays) !== null && _b !== void 0 ? _b : constants_1.DEFAULT_CLOUDWATCH_RETENTION_PERIOD,
         alreadyCreated: Boolean(alreadyDeployed),
-        architecture: options.architecture,
         ephemerealStorageInMb: diskSizeInMb,
-        customRoleArn: options.customRoleArn,
+        customRoleArn: params.customRoleArn,
     });
     if (!created.FunctionName) {
         throw new Error('Lambda was created but has no name');

package/dist/api/deploy-site.d.ts

@@ -1,7 +1,7 @@
-import type { WebpackOverrideFn } from 'remotion';
+import type { WebpackOverrideFn } from '@remotion/bundler';
 import type { AwsRegion } from '../pricing/aws-regions';
 import type { UploadDirProgress } from './upload-dir';
-export declare type DeploySiteInput = {
+export type DeploySiteInput = {
     entryPoint: string;
     bucketName: string;
     region: AwsRegion;
@@ -10,22 +10,30 @@ export declare type DeploySiteInput = {
         onBundleProgress?: (progress: number) => void;
         onUploadProgress?: (upload: UploadDirProgress) => void;
         webpackOverride?: WebpackOverrideFn;
+        ignoreRegisterRootWarning?: boolean;
         enableCaching?: boolean;
         publicDir?: string | null;
         rootDir?: string;
+        bypassBucketNameValidation?: boolean;
     };
+    privacy?: 'public' | 'no-acl';
 };
-export declare type DeploySiteOutput = Promise<{
+export type DeploySiteOutput = Promise<{
     serveUrl: string;
     siteName: string;
+    stats: {
+        uploadedFiles: number;
+        deletedFiles: number;
+        untouchedFiles: number;
+    };
 }>;
 /**
  * @description Deploys a Remotion project to an S3 bucket to prepare it for rendering on AWS Lambda.
- * @link https://remotion.dev/docs/lambda/deploysite
+ * @see [Documentation](https://remotion.dev/docs/lambda/deploysite)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.entryPoint An absolute path to the entry file of your Remotion project.
  * @param {string} params.bucketName The name of the bucket to deploy your project into.
  * @param {string} params.siteName The name of the folder in which the project gets deployed to.
  * @param {object} params.options Further options, see documentation page for this function.
  */
-export declare const deploySite: ({ bucketName, entryPoint, siteName, options, region, }: DeploySiteInput) => DeploySiteOutput;
+export declare const deploySite: ({ bucketName, entryPoint, siteName, options, region, privacy: passedPrivacy, }: DeploySiteInput) => DeploySiteOutput;

package/dist/api/deploy-site.js

@@ -1,72 +1,108 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deploySite = void 0;
-const delete_site_1 = require("../api/delete-site");
+const node_fs_1 = __importDefault(require("node:fs"));
+const io_1 = require("../functions/helpers/io");
 const bundle_site_1 = require("../shared/bundle-site");
 const constants_1 = require("../shared/constants");
 const get_account_id_1 = require("../shared/get-account-id");
+const get_s3_operations_1 = require("../shared/get-s3-operations");
 const make_s3_url_1 = require("../shared/make-s3-url");
 const random_hash_1 = require("../shared/random-hash");
 const validate_aws_region_1 = require("../shared/validate-aws-region");
 const validate_bucketname_1 = require("../shared/validate-bucketname");
+const validate_privacy_1 = require("../shared/validate-privacy");
 const validate_site_name_1 = require("../shared/validate-site-name");
 const bucket_exists_1 = require("./bucket-exists");
-const enable_s3_website_1 = require("./enable-s3-website");
 const upload_dir_1 = require("./upload-dir");
 /**
  * @description Deploys a Remotion project to an S3 bucket to prepare it for rendering on AWS Lambda.
- * @link https://remotion.dev/docs/lambda/deploysite
+ * @see [Documentation](https://remotion.dev/docs/lambda/deploysite)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.entryPoint An absolute path to the entry file of your Remotion project.
  * @param {string} params.bucketName The name of the bucket to deploy your project into.
  * @param {string} params.siteName The name of the folder in which the project gets deployed to.
  * @param {object} params.options Further options, see documentation page for this function.
  */
-const deploySite = async ({ bucketName, entryPoint, siteName, options, region, }) => {
+const deploySite = async ({ bucketName, entryPoint, siteName, options, region, privacy: passedPrivacy, }) => {
     var _a, _b, _c, _d;
     (0, validate_aws_region_1.validateAwsRegion)(region);
-    (0, validate_bucketname_1.validateBucketName)(bucketName, { mustStartWithRemotion: true });
+    (0, validate_bucketname_1.validateBucketName)(bucketName, {
+        mustStartWithRemotion: !(options === null || options === void 0 ? void 0 : options.bypassBucketNameValidation),
+    });
     const siteId = siteName !== null && siteName !== void 0 ? siteName : (0, random_hash_1.randomHash)();
     (0, validate_site_name_1.validateSiteName)(siteId);
+    const privacy = passedPrivacy !== null && passedPrivacy !== void 0 ? passedPrivacy : 'public';
+    (0, validate_privacy_1.validatePrivacy)(privacy, false);
+    const accountId = await (0, get_account_id_1.getAccountId)({ region });
     const bucketExists = await (0, bucket_exists_1.bucketExistsInRegion)({
         bucketName,
         region,
-        expectedBucketOwner: await (0, get_account_id_1.getAccountId)({ region }),
+        expectedBucketOwner: accountId,
     });
     if (!bucketExists) {
         throw new Error(`No bucket with the name ${bucketName} exists`);
     }
     const subFolder = (0, constants_1.getSitesKey)(siteId);
-    await (0, delete_site_1.deleteSite)({
-        bucketName,
-        onAfterItemDeleted: () => undefined,
-        region,
-        siteName: siteId,
-    });
-    const bundled = await (0, bundle_site_1.bundleSite)(entryPoint, (_a = options === null || options === void 0 ? void 0 : options.onBundleProgress) !== null && _a !== void 0 ? _a : (() => undefined), {
-        publicPath: `/${subFolder}/`,
-        webpackOverride: (_b = options === null || options === void 0 ? void 0 : options.webpackOverride) !== null && _b !== void 0 ? _b : ((f) => f),
-        enableCaching: (_c = options === null || options === void 0 ? void 0 : options.enableCaching) !== null && _c !== void 0 ? _c : true,
-        publicDir: options === null || options === void 0 ? void 0 : options.publicDir,
-        rootDir: options === null || options === void 0 ? void 0 : options.rootDir,
+    const [files, bundled] = await Promise.all([
+        (0, io_1.lambdaLs)({
+            bucketName,
+            expectedBucketOwner: accountId,
+            region,
+            // The `/` is important to not accidentially delete sites with the same name but containing a suffix.
+            prefix: `${subFolder}/`,
+        }),
+        (0, bundle_site_1.bundleSite)({
+            publicPath: `/${subFolder}/`,
+            webpackOverride: (_a = options === null || options === void 0 ? void 0 : options.webpackOverride) !== null && _a !== void 0 ? _a : ((f) => f),
+            enableCaching: (_b = options === null || options === void 0 ? void 0 : options.enableCaching) !== null && _b !== void 0 ? _b : true,
+            publicDir: options === null || options === void 0 ? void 0 : options.publicDir,
+            rootDir: options === null || options === void 0 ? void 0 : options.rootDir,
+            ignoreRegisterRootWarning: options === null || options === void 0 ? void 0 : options.ignoreRegisterRootWarning,
+            onProgress: (_c = options === null || options === void 0 ? void 0 : options.onBundleProgress) !== null && _c !== void 0 ? _c : (() => undefined),
+            entryPoint,
+        }),
+    ]);
+    const { toDelete, toUpload, existingCount } = await (0, get_s3_operations_1.getS3DiffOperations)({
+        objects: files,
+        bundle: bundled,
+        prefix: subFolder,
     });
     await Promise.all([
         (0, upload_dir_1.uploadDir)({
             bucket: bucketName,
             region,
-            dir: bundled,
+            localDir: bundled,
             onProgress: (_d = options === null || options === void 0 ? void 0 : options.onUploadProgress) !== null && _d !== void 0 ? _d : (() => undefined),
-            folder: subFolder,
-            privacy: 'public',
-        }),
-        (0, enable_s3_website_1.enableS3Website)({
-            region,
-            bucketName,
+            keyPrefix: subFolder,
+            privacy: privacy !== null && privacy !== void 0 ? privacy : 'public',
+            toUpload,
         }),
+        Promise.all(toDelete.map((d) => {
+            return (0, io_1.lambdaDeleteFile)({
+                bucketName,
+                customCredentials: null,
+                key: d.Key,
+                region,
+            });
+        })),
     ]);
+    if (!process.env.VITEST) {
+        node_fs_1.default.rmSync(bundled, {
+            recursive: true,
+        });
+    }
     return {
         serveUrl: (0, make_s3_url_1.makeS3ServeUrl)({ bucketName, subFolder, region }),
         siteName: siteId,
+        stats: {
+            uploadedFiles: toUpload.length,
+            deletedFiles: toDelete.length,
+            untouchedFiles: existingCount,
+        },
     };
 };
 exports.deploySite = deploySite;

package/dist/api/download-media.d.ts

@@ -1,7 +1,7 @@
 import type { LambdaReadFileProgress } from '../functions/helpers/read-with-progress';
 import type { AwsRegion } from '../pricing/aws-regions';
 import type { CustomCredentials } from '../shared/aws-clients';
-export declare type DownloadMediaInput = {
+export type DownloadMediaInput = {
     region: AwsRegion;
     bucketName: string;
     renderId: string;
@@ -9,13 +9,13 @@ export declare type DownloadMediaInput = {
     onProgress?: LambdaReadFileProgress;
     customCredentials?: CustomCredentials;
 };
-export declare type DownloadMediaOutput = {
+export type DownloadMediaOutput = {
     outputPath: string;
     sizeInBytes: number;
 };
 /**
- * @description Triggers a render on a lambda given a composition and a lambda function.
- * @link https://remotion.dev/docs/lambda/downloadmedia
+ * @description Downloads a rendered video, audio or still to the disk of the machine this API is called from.
+ * @see [Documentation](https://remotion.dev/docs/lambda/downloadmedia)
  * @param params.region The AWS region in which the media resides.
  * @param params.bucketName The `bucketName` that was specified during the render.
  * @param params.renderId The `renderId` that was obtained after triggering the render.
@@ -25,7 +25,3 @@ export declare type DownloadMediaOutput = {
  * @returns {Promise<RenderMediaOnLambdaOutput>} See documentation for detailed structure
  */
 export declare const downloadMedia: (input: DownloadMediaInput) => Promise<DownloadMediaOutput>;
-/**
- * @deprecated Renamed to downloadMedia()
- */
-export declare const downloadVideo: (input: DownloadMediaInput) => Promise<DownloadMediaOutput>;

package/dist/api/download-media.js

@@ -3,16 +3,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadVideo = exports.downloadMedia = void 0;
+exports.downloadMedia = void 0;
 const renderer_1 = require("@remotion/renderer");
-const path_1 = __importDefault(require("path"));
+const node_path_1 = __importDefault(require("node:path"));
 const expected_out_name_1 = require("../functions/helpers/expected-out-name");
 const get_render_metadata_1 = require("../functions/helpers/get-render-metadata");
 const read_with_progress_1 = require("../functions/helpers/read-with-progress");
 const get_account_id_1 = require("../shared/get-account-id");
 /**
- * @description Triggers a render on a lambda given a composition and a lambda function.
- * @link https://remotion.dev/docs/lambda/downloadmedia
+ * @description Downloads a rendered video, audio or still to the disk of the machine this API is called from.
+ * @see [Documentation](https://remotion.dev/docs/lambda/downloadmedia)
  * @param params.region The AWS region in which the media resides.
  * @param params.bucketName The `bucketName` that was specified during the render.
  * @param params.renderId The `renderId` that was obtained after triggering the render.
@@ -32,7 +32,7 @@ const downloadMedia = async (input) => {
         region: input.region,
         renderId: input.renderId,
     });
-    const outputPath = path_1.default.resolve(process.cwd(), input.outPath);
+    const outputPath = node_path_1.default.resolve(process.cwd(), input.outPath);
     renderer_1.RenderInternals.ensureOutputDirectory(outputPath);
     const { key, renderBucketName, customCredentials } = (0, expected_out_name_1.getExpectedOutName)(renderMetadata, input.bucketName, (_a = input.customCredentials) !== null && _a !== void 0 ? _a : null);
     const { sizeInBytes } = await (0, read_with_progress_1.lambdaDownloadFileWithProgress)({
@@ -50,7 +50,3 @@ const downloadMedia = async (input) => {
     };
 };
 exports.downloadMedia = downloadMedia;
-/**
- * @deprecated Renamed to downloadMedia()
- */
-exports.downloadVideo = exports.downloadMedia;

package/dist/api/estimate-price.d.ts

@@ -1,17 +1,15 @@
 import type { AwsRegion } from '../pricing/aws-regions';
-import type { LambdaArchitecture } from '../shared/validate-architecture';
-export declare type EstimatePriceInput = {
+export type EstimatePriceInput = {
     region: AwsRegion;
     durationInMiliseconds: number;
     memorySizeInMb: number;
     diskSizeInMb: number;
-    architecture: LambdaArchitecture;
     lambdasInvoked: number;
 };
 /**
  *
  * @description Calculates the AWS costs incurred for AWS Lambda given the region, execution duration and memory size.
- * @link https://remotion.dev/docs/lambda/estimateprice
+ * @see [Documentation](https://remotion.dev/docs/lambda/estimateprice)
  * @returns {number} Price in USD
  */
-export declare const estimatePrice: ({ region, durationInMiliseconds, memorySizeInMb, diskSizeInMb, architecture, lambdasInvoked, }: EstimatePriceInput) => number;
+export declare const estimatePrice: ({ region, durationInMiliseconds, memorySizeInMb, diskSizeInMb, lambdasInvoked, }: EstimatePriceInput) => number;

package/dist/api/estimate-price.js

@@ -3,20 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.estimatePrice = void 0;
 const defaults_1 = require("../defaults");
 const price_per_1_s_1 = require("../pricing/price-per-1-s");
-const validate_architecture_1 = require("../shared/validate-architecture");
 const validate_aws_region_1 = require("../shared/validate-aws-region");
 const validate_disk_size_in_mb_1 = require("../shared/validate-disk-size-in-mb");
 const validate_memory_size_1 = require("../shared/validate-memory-size");
 /**
  *
  * @description Calculates the AWS costs incurred for AWS Lambda given the region, execution duration and memory size.
- * @link https://remotion.dev/docs/lambda/estimateprice
+ * @see [Documentation](https://remotion.dev/docs/lambda/estimateprice)
  * @returns {number} Price in USD
  */
-const estimatePrice = ({ region, durationInMiliseconds, memorySizeInMb, diskSizeInMb, architecture, lambdasInvoked, }) => {
+const estimatePrice = ({ region, durationInMiliseconds, memorySizeInMb, diskSizeInMb, lambdasInvoked, }) => {
     (0, validate_memory_size_1.validateMemorySize)(memorySizeInMb);
     (0, validate_aws_region_1.validateAwsRegion)(region);
-    (0, validate_architecture_1.validateArchitecture)(architecture);
     (0, validate_disk_size_in_mb_1.validateDiskSizeInMb)(diskSizeInMb);
     if (typeof durationInMiliseconds !== 'number') {
         throw new TypeError(`Parameter 'durationInMiliseconds' must be a number but got ${typeof durationInMiliseconds}`);
@@ -30,15 +28,11 @@ const estimatePrice = ({ region, durationInMiliseconds, memorySizeInMb, diskSize
     if (durationInMiliseconds < 0) {
         throw new TypeError(`Parameter 'durationInMiliseconds' must be over 0 but it is ${durationInMiliseconds}.`);
     }
-    const durationPrice = architecture === 'x86_64'
-        ? price_per_1_s_1.pricing[region]['Lambda Duration'].price
-        : price_per_1_s_1.pricing[region]['Lambda Duration-ARM'].price;
+    const durationPrice = price_per_1_s_1.pricing[region]['Lambda Duration-ARM'].price;
     // In GB-second
     const timeCostDollars = Number(durationPrice) *
         ((memorySizeInMb * durationInMiliseconds) / 1000 / 1024);
-    const diskSizePrice = architecture === 'x86_64'
-        ? price_per_1_s_1.pricing[region]['Lambda Storage-Duration'].price
-        : price_per_1_s_1.pricing[region]['Lambda Storage-Duration-ARM'].price;
+    const diskSizePrice = price_per_1_s_1.pricing[region]['Lambda Storage-Duration-ARM'].price;
     const chargedDiskSize = Math.max(0, diskSizeInMb - defaults_1.MIN_EPHEMERAL_STORAGE_IN_MB);
     // In GB-second
     const diskSizeDollars = chargedDiskSize *

package/dist/api/get-aws-client.d.ts

@@ -3,27 +3,29 @@ import * as IamSdk from '@aws-sdk/client-iam';
 import * as LambdaSDK from '@aws-sdk/client-lambda';
 import * as S3SDK from '@aws-sdk/client-s3';
 import * as ServiceQuotasSDK from '@aws-sdk/client-service-quotas';
+import * as StsSdk from '@aws-sdk/client-sts';
 import type { AwsRegion } from '../client';
 import type { CustomCredentials, ServiceMapping } from '../shared/aws-clients';
-export declare type GetAwsClientInput<T extends keyof ServiceMapping> = {
+export type GetAwsClientInput<T extends keyof ServiceMapping> = {
     region: AwsRegion;
     service: T;
     customCredentials?: CustomCredentials | null;
 };
-declare type SdkMapping = {
+type SdkMapping = {
     s3: typeof S3SDK;
     cloudwatch: typeof CloudWatchSDK;
     iam: typeof IamSdk;
     lambda: typeof LambdaSDK;
     servicequotas: typeof ServiceQuotasSDK;
+    sts: typeof StsSdk;
 };
-export declare type GetAwsClientOutput<T extends keyof ServiceMapping> = {
+export type GetAwsClientOutput<T extends keyof ServiceMapping> = {
     client: ServiceMapping[T];
     sdk: SdkMapping[T];
 };
 /**
  * @description Gets the full AWS SDK and an instantiated client for an AWS service
- * @link https://remotion.dev/docs/lambda/getawsclient
+ * @see [Documentation](https://remotion.dev/docs/lambda/getawsclient)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.service One of `iam`, `s3`, `cloudwatch`, `iam` or `servicequotas`
  * @param {CustomCredentials} params.customCredentials Pass endpoint and credentials if you want to connect to a different cloud for S3

package/dist/api/get-aws-client.js

@@ -29,10 +29,11 @@ const IamSdk = __importStar(require("@aws-sdk/client-iam"));
 const LambdaSDK = __importStar(require("@aws-sdk/client-lambda"));
 const S3SDK = __importStar(require("@aws-sdk/client-s3"));
 const ServiceQuotasSDK = __importStar(require("@aws-sdk/client-service-quotas"));
+const StsSdk = __importStar(require("@aws-sdk/client-sts"));
 const aws_clients_1 = require("../shared/aws-clients");
 /**
  * @description Gets the full AWS SDK and an instantiated client for an AWS service
- * @link https://remotion.dev/docs/lambda/getawsclient
+ * @see [Documentation](https://remotion.dev/docs/lambda/getawsclient)
  * @param {AwsRegion} params.region The region in which the S3 bucket resides in.
  * @param {string} params.service One of `iam`, `s3`, `cloudwatch`, `iam` or `servicequotas`
  * @param {CustomCredentials} params.customCredentials Pass endpoint and credentials if you want to connect to a different cloud for S3
@@ -51,6 +52,7 @@ const getAwsClient = ({ region, service, customCredentials, }) => {
             iam: IamSdk,
             s3: S3SDK,
             servicequotas: ServiceQuotasSDK,
+            sts: StsSdk,
         }[service],
     };
 };

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

@@ -1,9 +1,9 @@
 import type { AwsRegion } from '../pricing/aws-regions';
-export declare type BucketWithLocation = {
+export type BucketWithLocation = {
     name: string;
     creationDate: number;
     region: AwsRegion;
 };
-export declare const getRemotionS3Buckets: (region: AwsRegion) => Promise<{
+export declare const getRemotionS3Buckets: (region: AwsRegion, forceBucketName?: string) => Promise<{
     remotionBuckets: BucketWithLocation[];
 }>;

package/dist/api/get-buckets.js

@@ -2,28 +2,51 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRemotionS3Buckets = void 0;
 const client_s3_1 = require("@aws-sdk/client-s3");
+const defaults_1 = require("../defaults");
 const aws_clients_1 = require("../shared/aws-clients");
-const constants_1 = require("../shared/constants");
-const getRemotionS3Buckets = async (region) => {
+const validate_bucketname_1 = require("../shared/validate-bucketname");
+const getRemotionS3Buckets = async (region, forceBucketName) => {
     const { Buckets } = await (0, aws_clients_1.getS3Client)(region, null).send(new client_s3_1.ListBucketsCommand({}));
     if (!Buckets) {
         return { remotionBuckets: [] };
     }
-    const remotionBuckets = Buckets.filter((b) => { var _a; return (_a = b.Name) === null || _a === void 0 ? void 0 : _a.startsWith(constants_1.REMOTION_BUCKET_PREFIX); });
-    const locations = await Promise.all(remotionBuckets.map((bucket) => {
-        return (0, aws_clients_1.getS3Client)(region, null).send(new client_s3_1.GetBucketLocationCommand({
-            Bucket: bucket.Name,
-        }));
-    }));
-    const bucketsWithLocation = remotionBuckets.map((bucket, i) => {
+    const remotionBuckets = Buckets.filter((b) => {
         var _a;
+        if (forceBucketName) {
+            return b.Name === forceBucketName;
+        }
+        return (_a = b.Name) === null || _a === void 0 ? void 0 : _a.startsWith(defaults_1.REMOTION_BUCKET_PREFIX);
+    });
+    const locations = await Promise.all(remotionBuckets.map(async (bucket) => {
+        var _a, _b;
+        const { region: parsedRegion } = (0, validate_bucketname_1.parseBucketName)(bucket.Name);
+        if (parsedRegion) {
+            return parsedRegion;
+        }
+        try {
+            const result = await (0, aws_clients_1.getS3Client)(region, null).send(new client_s3_1.GetBucketLocationCommand({
+                Bucket: bucket.Name,
+            }));
+            // AWS docs: Buckets in Region us-east-1 have a LocationConstraint of null!!
+            return (_a = result.LocationConstraint) !== null && _a !== void 0 ? _a : 'us-east-1';
+        }
+        catch (err) {
+            // Sometimes the API returns a bucket even if it was deleted before
+            if ((_b = err.stack) === null || _b === void 0 ? void 0 : _b.includes('NoSuchBucket')) {
+                return null;
+            }
+            throw err;
+        }
+    }));
+    const bucketsWithLocation = remotionBuckets
+        .map((bucket, i) => {
         return {
             creationDate: bucket.CreationDate.getTime(),
             name: bucket.Name,
-            // AWS docs: Buckets in Region us-east-1 have a LocationConstraint of null!!
-            region: ((_a = locations[i].LocationConstraint) !== null && _a !== void 0 ? _a : 'us-east-1'),
+            region: locations[i],
         };
-    });
+    })
+        .filter((b) => b.region);
     return {
         remotionBuckets: bucketsWithLocation.filter((bucket) => {
             return bucket.region === region;

package/dist/api/get-compositions-on-lambda.d.ts

@@ -0,0 +1,33 @@
+import type { ChromiumOptions, LogLevel } from '@remotion/renderer';
+import type { AnyCompMetadata } from 'remotion';
+import type { AwsRegion } from '../client';
+export type GetCompositionsOnLambdaInput = {
+    chromiumOptions?: ChromiumOptions;
+    region: AwsRegion;
+    inputProps: Record<string, unknown>;
+    functionName: string;
+    serveUrl: string;
+    envVariables?: Record<string, string>;
+    logLevel?: LogLevel;
+    timeoutInMilliseconds?: number;
+    forceBucketName?: string;
+    /**
+     * @deprecated in favor of `logLevel`: true
+     */
+    dumpBrowserLogs?: boolean;
+};
+export type GetCompositionsOnLambdaOutput = AnyCompMetadata[];
+/**
+ * @description Returns the compositions from a serveUrl
+ * @see [Documentation](https://remotion.dev/docs/lambda/getcompositionsonlambda)
+ * @param params.functionName The name of the Lambda function that should be used
+ * @param params.serveUrl The URL of the deployed project
+ * @param params.inputProps The input props that should be passed while the compositions are evaluated.
+ * @param params.envVariables Object containing environment variables to be inserted into the video environment
+ * @param params.region The AWS region in which the video should be rendered.
+ * @param params.logLevel The log level of the Lambda function
+ * @param params.timeoutInMilliseconds The timeout of the Lambda function
+ * @param params.chromiumOptions The options to pass to Chromium
+ * @returns The compositions
+ */
+export declare const getCompositionsOnLambda: ({ chromiumOptions, serveUrl, region, inputProps, functionName, envVariables, logLevel, timeoutInMilliseconds, forceBucketName: bucketName, dumpBrowserLogs, }: GetCompositionsOnLambdaInput) => Promise<GetCompositionsOnLambdaOutput>;

package/dist/api/get-compositions-on-lambda.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCompositionsOnLambda = void 0;
+const renderer_1 = require("@remotion/renderer");
+const version_1 = require("remotion/version");
+const defaults_1 = require("../defaults");
+const call_lambda_1 = require("../shared/call-lambda");
+const serialize_input_props_1 = require("../shared/serialize-input-props");
+/**
+ * @description Returns the compositions from a serveUrl
+ * @see [Documentation](https://remotion.dev/docs/lambda/getcompositionsonlambda)
+ * @param params.functionName The name of the Lambda function that should be used
+ * @param params.serveUrl The URL of the deployed project
+ * @param params.inputProps The input props that should be passed while the compositions are evaluated.
+ * @param params.envVariables Object containing environment variables to be inserted into the video environment
+ * @param params.region The AWS region in which the video should be rendered.
+ * @param params.logLevel The log level of the Lambda function
+ * @param params.timeoutInMilliseconds The timeout of the Lambda function
+ * @param params.chromiumOptions The options to pass to Chromium
+ * @returns The compositions
+ */
+const getCompositionsOnLambda = async ({ chromiumOptions, serveUrl, region, inputProps, functionName, envVariables, logLevel, timeoutInMilliseconds, forceBucketName: bucketName, dumpBrowserLogs, }) => {
+    var _a;
+    const serializedInputProps = await (0, serialize_input_props_1.serializeInputProps)({
+        inputProps,
+        region,
+        type: 'still',
+        userSpecifiedBucketName: bucketName !== null && bucketName !== void 0 ? bucketName : null,
+    });
+    try {
+        const res = await (0, call_lambda_1.callLambda)({
+            functionName,
+            type: defaults_1.LambdaRoutines.compositions,
+            payload: {
+                chromiumOptions: chromiumOptions !== null && chromiumOptions !== void 0 ? chromiumOptions : {},
+                serveUrl,
+                envVariables,
+                inputProps: serializedInputProps,
+                logLevel: dumpBrowserLogs
+                    ? 'verbose'
+                    : logLevel !== null && logLevel !== void 0 ? logLevel : renderer_1.RenderInternals.getLogLevel(),
+                timeoutInMilliseconds: timeoutInMilliseconds !== null && timeoutInMilliseconds !== void 0 ? timeoutInMilliseconds : 30000,
+                version: version_1.VERSION,
+                bucketName: bucketName !== null && bucketName !== void 0 ? bucketName : null,
+            },
+            region,
+        });
+        return res.compositions;
+    }
+    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.getCompositionsOnLambda = getCompositionsOnLambda;