@remotion/lambda 4.0.0-imgloading.2 → 4.0.0-jshmr2.1

package/dist/api/deploy-site.js

@@ -1,22 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.deploySite = void 0;
-const remotion_1 = require("remotion");
-const delete_site_1 = require("../api/delete-site");
+const fs_1 = require("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_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.
@@ -26,46 +26,74 @@ const upload_dir_1 = require("./upload-dir");
 const deploySite = async ({ bucketName, entryPoint, siteName, options, region, }) => {
     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 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 : remotion_1.Internals.getWebpackOverrideFn(),
-        enableCaching: (_c = options === null || options === void 0 ? void 0 : options.enableCaching) !== null && _c !== void 0 ? _c : remotion_1.Internals.getWebpackCaching(),
+    const [files, bundled] = await Promise.all([
+        (0, io_1.lambdaLs)({
+            bucketName,
+            expectedBucketOwner: accountId,
+            region,
+            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,
+            keyPrefix: subFolder,
             privacy: 'public',
+            toUpload,
         }),
-        (0, enable_s3_website_1.enableS3Website)({
-            region,
-            bucketName,
-        }),
+        Promise.all(toDelete.map((d) => {
+            return (0, io_1.lambdaDeleteFile)({
+                bucketName,
+                customCredentials: null,
+                key: d.Key,
+                region,
+            });
+        })),
     ]);
+    if (!process.env.VITEST) {
+        (0, fs_1.rmdirSync)(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,16 +1,29 @@
-import { LambdaReadFileProgress } from '../functions/helpers/read-with-progress';
-import { AwsRegion } from '../pricing/aws-regions';
+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 = {
     region: AwsRegion;
     bucketName: string;
     renderId: string;
     outPath: string;
     onProgress?: LambdaReadFileProgress;
+    customCredentials?: CustomCredentials;
 };
 export declare type DownloadMediaOutput = {
     outputPath: string;
     sizeInBytes: number;
 };
+/**
+ * @description Triggers a render on a lambda given a composition and a lambda function.
+ * @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.
+ * @param params.outPath Where to save the media.
+ * @param params.onProgress Progress callback function - see docs for details.
+ * @param params.customCredentials If the file was saved to a foreign cloud, pass credentials for reading from it.
+ * @returns {Promise<RenderMediaOnLambdaOutput>} See documentation for detailed structure
+ */
 export declare const downloadMedia: (input: DownloadMediaInput) => Promise<DownloadMediaOutput>;
 /**
  * @deprecated Renamed to downloadMedia()

package/dist/api/download-media.js

@@ -10,8 +10,19 @@ 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.
+ * @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.
+ * @param params.outPath Where to save the media.
+ * @param params.onProgress Progress callback function - see docs for details.
+ * @param params.customCredentials If the file was saved to a foreign cloud, pass credentials for reading from it.
+ * @returns {Promise<RenderMediaOnLambdaOutput>} See documentation for detailed structure
+ */
 const downloadMedia = async (input) => {
-    var _a;
+    var _a, _b;
     const expectedBucketOwner = await (0, get_account_id_1.getAccountId)({
         region: input.region,
     });
@@ -23,14 +34,15 @@ const downloadMedia = async (input) => {
     });
     const outputPath = path_1.default.resolve(process.cwd(), input.outPath);
     renderer_1.RenderInternals.ensureOutputDirectory(outputPath);
-    const { key, renderBucketName } = (0, expected_out_name_1.getExpectedOutName)(renderMetadata, input.bucketName);
+    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)({
         bucketName: renderBucketName,
         expectedBucketOwner,
         key,
         region: input.region,
-        onProgress: (_a = input.onProgress) !== null && _a !== void 0 ? _a : (() => undefined),
+        onProgress: (_b = input.onProgress) !== null && _b !== void 0 ? _b : (() => undefined),
         outputPath,
+        customCredentials,
     });
     return {
         outputPath,

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

@@ -1,5 +1,5 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { LambdaArchitecture } from '../shared/validate-architecture';
+import type { AwsRegion } from '../pricing/aws-regions';
+import type { LambdaArchitecture } from '../shared/validate-architecture';
 export declare type EstimatePriceInput = {
     region: AwsRegion;
     durationInMiliseconds: number;
@@ -11,7 +11,7 @@ export declare type EstimatePriceInput = {
 /**
  *
  * @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;

package/dist/api/estimate-price.js

@@ -10,7 +10,7 @@ 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, }) => {

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

@@ -3,11 +3,13 @@ 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 { AwsRegion } from '../client';
-import { ServiceMapping } from '../shared/aws-clients';
+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> = {
     region: AwsRegion;
     service: T;
+    customCredentials?: CustomCredentials | null;
 };
 declare type SdkMapping = {
     s3: typeof S3SDK;
@@ -15,6 +17,7 @@ declare type SdkMapping = {
     iam: typeof IamSdk;
     lambda: typeof LambdaSDK;
     servicequotas: typeof ServiceQuotasSDK;
+    sts: typeof StsSdk;
 };
 export declare type GetAwsClientOutput<T extends keyof ServiceMapping> = {
     client: ServiceMapping[T];
@@ -22,10 +25,11 @@ export declare type GetAwsClientOutput<T extends keyof ServiceMapping> = {
 };
 /**
  * @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
  * @returns {GetAwsClientOutput<T>} Returns `client` and `sdk` of a AWS service
  */
-export declare const getAwsClient: <T extends keyof ServiceMapping>({ region, service, }: GetAwsClientInput<T>) => GetAwsClientOutput<T>;
+export declare const getAwsClient: <T extends keyof ServiceMapping>({ region, service, customCredentials, }: GetAwsClientInput<T>) => GetAwsClientOutput<T>;
 export {};

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

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -25,23 +29,30 @@ 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
  * @returns {GetAwsClientOutput<T>} Returns `client` and `sdk` of a AWS service
  */
-const getAwsClient = ({ region, service, }) => {
+const getAwsClient = ({ region, service, customCredentials, }) => {
     return {
-        client: (0, aws_clients_1.getServiceClient)(region, service),
+        client: (0, aws_clients_1.getServiceClient)({
+            region,
+            service,
+            customCredentials: customCredentials !== null && customCredentials !== void 0 ? customCredentials : null,
+        }),
         sdk: {
             lambda: LambdaSDK,
             cloudwatch: CloudWatchSDK,
             iam: IamSdk,
             s3: S3SDK,
             servicequotas: ServiceQuotasSDK,
+            sts: StsSdk,
         }[service],
     };
 };

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

@@ -1,4 +1,4 @@
-import { AwsRegion } from '../pricing/aws-regions';
+import type { AwsRegion } from '../pricing/aws-regions';
 export declare type BucketWithLocation = {
     name: string;
     creationDate: number;

package/dist/api/get-buckets.js

@@ -4,26 +4,43 @@ exports.getRemotionS3Buckets = void 0;
 const client_s3_1 = require("@aws-sdk/client-s3");
 const aws_clients_1 = require("../shared/aws-clients");
 const constants_1 = require("../shared/constants");
+const validate_bucketname_1 = require("../shared/validate-bucketname");
 const getRemotionS3Buckets = async (region) => {
-    const { Buckets } = await (0, aws_clients_1.getS3Client)(region).send(new client_s3_1.ListBucketsCommand({}));
+    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).send(new client_s3_1.GetBucketLocationCommand({
-            Bucket: bucket.Name,
-        }));
+    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) => {
-        var _a;
+    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,29 @@
+import type { ChromiumOptions, LogLevel } from '@remotion/renderer';
+import type { TCompMetadata } from 'remotion';
+import type { AwsRegion } from '../client';
+export declare type GetCompositionsOnLambdaInput = {
+    chromiumOptions?: ChromiumOptions;
+    region: AwsRegion;
+    inputProps: unknown;
+    functionName: string;
+    serveUrl: string;
+    envVariables?: Record<string, string>;
+    logLevel?: LogLevel;
+    timeoutInMilliseconds?: number;
+    forceBucketName?: string;
+};
+export declare type GetCompositionsOnLambdaOutput = TCompMetadata[];
+/**
+ * @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, }: GetCompositionsOnLambdaInput) => Promise<GetCompositionsOnLambdaOutput>;

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCompositionsOnLambda = void 0;
+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, }) => {
+    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: logLevel !== null && logLevel !== void 0 ? logLevel : 'info',
+                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;

package/dist/api/get-function-info.d.ts

@@ -1,10 +1,9 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { LambdaVersions } from '../shared/constants';
+import type { AwsRegion } from '../pricing/aws-regions';
 export declare type FunctionInfo = {
     functionName: string;
     timeoutInSeconds: number;
     memorySizeInMb: number;
-    version: LambdaVersions | null;
+    version: string | null;
     diskSizeInMb: number;
 };
 export declare type GetFunctionInfoInput = {
@@ -13,7 +12,7 @@ export declare type GetFunctionInfoInput = {
 };
 /**
  * @description Given a region and function name, returns information about the function such as version, memory size and timeout.
- * @link https://remotion.dev/docs/lambda/getfunctioninfo
+ * @see [Documentation](https://remotion.dev/docs/lambda/getfunctioninfo)
  * @param {AwsRegion} options.region The region in which the function resides in.
  * @param {string} options.functionName The name of the function
  * @return {Promise<FunctionInfo>} Promise resolving to information about the function.

package/dist/api/get-function-info.js

@@ -8,7 +8,7 @@ const get_function_version_1 = require("../shared/get-function-version");
 const validate_aws_region_1 = require("../shared/validate-aws-region");
 /**
  * @description Given a region and function name, returns information about the function such as version, memory size and timeout.
- * @link https://remotion.dev/docs/lambda/getfunctioninfo
+ * @see [Documentation](https://remotion.dev/docs/lambda/getfunctioninfo)
  * @param {AwsRegion} options.region The region in which the function resides in.
  * @param {string} options.functionName The name of the function
  * @return {Promise<FunctionInfo>} Promise resolving to information about the function.

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

@@ -1,14 +1,12 @@
-import { AwsRegion } from '../pricing/aws-regions';
-import { FunctionInfo } from './get-function-info';
+import type { AwsRegion } from '../pricing/aws-regions';
+import type { FunctionInfo } from './get-function-info';
 export declare type GetFunctionsInput = {
     region: AwsRegion;
     compatibleOnly: boolean;
 };
 /**
- *
- *
  * @description Lists Remotion Lambda render functions deployed to AWS Lambda.
- * @link https://remotion.dev/docs/lambda/getfunctions
+ * @see [Documentation](https://remotion.dev/docs/lambda/getfunctions)
  * @param options.region The region of which the functions should be listed.
  * @param options.compatibleOnly Whether only functions compatible with the installed version of Remotion Lambda should be returned.
  * @returns {Promise<FunctionInfo[]>} An array with the objects containing information about the deployed functions.

package/dist/api/get-functions.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFunctions = void 0;
 const client_lambda_1 = require("@aws-sdk/client-lambda");
+const version_1 = require("remotion/version");
 const aws_clients_1 = require("../shared/aws-clients");
 const constants_1 = require("../shared/constants");
 const get_function_version_1 = require("../shared/get-function-version");
@@ -26,10 +27,8 @@ const getAllFunctions = async ({ existing, nextMarker, region, }) => {
     return allLambdas;
 };
 /**
- *
- *
  * @description Lists Remotion Lambda render functions deployed to AWS Lambda.
- * @link https://remotion.dev/docs/lambda/getfunctions
+ * @see [Documentation](https://remotion.dev/docs/lambda/getfunctions)
  * @param options.region The region of which the functions should be listed.
  * @param options.compatibleOnly Whether only functions compatible with the installed version of Remotion Lambda should be returned.
  * @returns {Promise<FunctionInfo[]>} An array with the objects containing information about the deployed functions.
@@ -73,7 +72,7 @@ const getFunctions = async (options) => {
         if (!options.compatibleOnly) {
             return true;
         }
-        return l.version === constants_1.CURRENT_VERSION;
+        return l.version === version_1.VERSION;
     });
 };
 exports.getFunctions = getFunctions;

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

@@ -1,4 +1,4 @@
-import { AwsRegion } from '../pricing/aws-regions';
+import type { AwsRegion } from '../pricing/aws-regions';
 export declare type GetOrCreateBucketInput = {
     region: AwsRegion;
     onBucketEnsured?: () => void;
@@ -8,7 +8,7 @@ export declare type GetOrCreateBucketOutput = {
 };
 /**
  * @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`.
  */

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,22 +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 };
     }
-    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 };
 };
 exports.getOrCreateBucket = getOrCreateBucket;

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

@@ -1,7 +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[];
+export declare const getRegions: (options?: Options) => readonly AwsRegion[];
+export {};

package/dist/api/get-regions.js

@@ -1,13 +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;