@wix/media 1.0.50 → 1.0.52

package/build/cjs/src/media-site-media-v1-file-descriptor.universal.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];
@@ -30,6 +34,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listDeletedFiles = exports.bulkRestoreFilesFromTrashBin = exports.bulkDeleteFiles = exports.generateVideoStreamingUrl = exports.searchFiles = exports.listFiles = exports.bulkImportFile = exports.bulkImportFiles = exports.importFile = exports.generateFileResumableUploadUrl = exports.generateFileUploadUrl = exports.updateFileDescriptor = exports.getFileDescriptors = exports.getFileDescriptor = exports.generateFileDownloadUrl = exports.generateFilesDownloadUrl = exports.StreamFormat = exports.RootFolder = exports.SortOrder = exports.UploadProtocol = exports.ContentDisposition = exports.IdentityType = exports.Namespace = exports.State = exports.OperationStatus = exports.MediaType = exports.__debug = void 0;
 const velo_1 = require("@wix/metro-runtime/velo");
+const transform_error_1 = require("@wix/sdk-runtime/transform-error");
 const ambassadorWixMediaSiteMediaV1FileDescriptor = __importStar(require("./media-site-media-v1-file-descriptor.http"));
 let __verbose = false;
 function __log(...args) {
@@ -57,7 +62,7 @@ var MediaType;
     MediaType["ARCHIVE"] = "ARCHIVE";
     MediaType["MODEL3D"] = "MODEL3D";
     MediaType["OTHER"] = "OTHER";
-})(MediaType = exports.MediaType || (exports.MediaType = {}));
+})(MediaType || (exports.MediaType = MediaType = {}));
 var OperationStatus;
 (function (OperationStatus) {
     /** File upload or processing failed */
@@ -66,14 +71,14 @@ var OperationStatus;
     OperationStatus["READY"] = "READY";
     /** File is waiting for processing or currently being processed */
     OperationStatus["PENDING"] = "PENDING";
-})(OperationStatus = exports.OperationStatus || (exports.OperationStatus = {}));
+})(OperationStatus || (exports.OperationStatus = OperationStatus = {}));
 var State;
 (function (State) {
     /** File is ready for consumption */
     State["OK"] = "OK";
     /** Deleted file */
     State["DELETED"] = "DELETED";
-})(State = exports.State || (exports.State = {}));
+})(State || (exports.State = State = {}));
 var Namespace;
 (function (Namespace) {
     Namespace["NO_NAMESPACE"] = "NO_NAMESPACE";
@@ -100,7 +105,7 @@ var Namespace;
     Namespace["CHAT_MOBILE"] = "CHAT_MOBILE";
     /** _nsWixForms */
     Namespace["WIX_FORMS"] = "WIX_FORMS";
-})(Namespace = exports.Namespace || (exports.Namespace = {}));
+})(Namespace || (exports.Namespace = Namespace = {}));
 var IdentityType;
 (function (IdentityType) {
     IdentityType["UNKNOWN"] = "UNKNOWN";
@@ -108,24 +113,24 @@ var IdentityType;
     IdentityType["MEMBER"] = "MEMBER";
     IdentityType["WIX_USER"] = "WIX_USER";
     IdentityType["APP"] = "APP";
-})(IdentityType = exports.IdentityType || (exports.IdentityType = {}));
+})(IdentityType || (exports.IdentityType = IdentityType = {}));
 var ContentDisposition;
 (function (ContentDisposition) {
     /** Using the link in the browser will download the file */
     ContentDisposition["ATTACHMENT"] = "ATTACHMENT";
     /** Using the link in the browser will open the file in the browser */
     ContentDisposition["INLINE"] = "INLINE";
-})(ContentDisposition = exports.ContentDisposition || (exports.ContentDisposition = {}));
+})(ContentDisposition || (exports.ContentDisposition = ContentDisposition = {}));
 var UploadProtocol;
 (function (UploadProtocol) {
     /** The upload protocol to use for implementing the resumable upload. */
     UploadProtocol["TUS"] = "TUS";
-})(UploadProtocol = exports.UploadProtocol || (exports.UploadProtocol = {}));
+})(UploadProtocol || (exports.UploadProtocol = UploadProtocol = {}));
 var SortOrder;
 (function (SortOrder) {
     SortOrder["ASC"] = "ASC";
     SortOrder["DESC"] = "DESC";
-})(SortOrder = exports.SortOrder || (exports.SortOrder = {}));
+})(SortOrder || (exports.SortOrder = SortOrder = {}));
 var RootFolder;
 (function (RootFolder) {
     /** Root of all site media */
@@ -134,13 +139,13 @@ var RootFolder;
     RootFolder["TRASH_ROOT"] = "TRASH_ROOT";
     /** Root of all visitor uploads */
     RootFolder["VISITOR_UPLOADS_ROOT"] = "VISITOR_UPLOADS_ROOT";
-})(RootFolder = exports.RootFolder || (exports.RootFolder = {}));
+})(RootFolder || (exports.RootFolder = RootFolder = {}));
 var StreamFormat;
 (function (StreamFormat) {
     StreamFormat["UNKNOWN"] = "UNKNOWN";
     StreamFormat["HLS"] = "HLS";
     StreamFormat["DASH"] = "DASH";
-})(StreamFormat = exports.StreamFormat || (exports.StreamFormat = {}));
+})(StreamFormat || (exports.StreamFormat = StreamFormat = {}));
 const _audioV2 = { assets: 'wix.common.Audio' };
 const _bulkDeleteFilesRequest = {};
 const _bulkDeleteFilesResponse = {};
@@ -192,6 +197,8 @@ const _updateFileDescriptorResponse = { file: '_fileDescriptor' };
 /**
  * Generates a URL for downloading a compressed file containing specific files in the Media Manager.
  *
+ * The `generateFilesDownloadUrl()` function returns a Promise that resolves to a download URL.
+ *
  * The compressed file can contain up to 1000 files.
  * @param fileIds - IDs of the files to download.
  * @public
@@ -236,9 +243,11 @@ function generateFilesDownloadUrl(fileIds) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileIds',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { fileIds: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['fileIds']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -248,10 +257,12 @@ exports.generateFilesDownloadUrl = generateFilesDownloadUrl;
 /**
  * Generates one or more temporary URLs for downloading a specific file in the Media Manager.
  *
+ * The `generateFileDownloadUrl()` function returns a Promise that resolves to an array containing download URLs for the assets specified in the options parameter.
+ *
  * To download different assets of the file, use the `assetKeys` parameter which generates a download URL for each asset.
- * If no `assetKey` is specified, it defaults to `src`, which generates one download URL in the original file's format and quality.
+ * If no asset key is specified, it defaults to `src`, which generates one download URL in the original file's format and quality.
  *
- * Use this endpoint to grant external clients access to a private media file. Use the `expirationInMinutes` parameter to set the URL expiration time, and the `expirationRedirectUrl` parameter to add a redirect url when the URL expires.
+ * Use this endpoint to grant external clients access to a private media file. Use the `expirationInMinutes` parameter to set the URL expiration time, and the `expirationRedirectUrl` parameter to add a redirect URL when the URL expires.
  * @param fileId - File ID.
  * @public
  * @requiredField fileId
@@ -302,10 +313,18 @@ function generateFileDownloadUrl(fileId, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileId',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    fileId: '$[0]',
+                    downloadFileName: '$[1].downloadFileName',
+                    expirationInMinutes: '$[1].expirationInMinutes',
+                    expirationRedirectUrl: '$[1].expirationRedirectUrl',
+                    assetKeys: '$[1].assetKeys',
+                    contentDisposition: '$[1].contentDisposition',
+                },
+                singleArgumentUnchanged: false,
+            }, ['fileId', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -314,6 +333,11 @@ function generateFileDownloadUrl(fileId, options) {
 exports.generateFileDownloadUrl = generateFileDownloadUrl;
 /**
  * Gets information about the specified file in the Media Manager.
+ *
+ *
+ * The `getFileDescriptor()` function returns a Promise that resolves to the specified file's descriptor.
+ *
+ * Use `getFileDescriptors()` to get multiple file descriptors at once.
  * @param fileId - File ID.
  * @public
  * @documentationMaturity preview
@@ -365,9 +389,11 @@ function getFileDescriptor(fileId) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileId',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { fileId: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['fileId']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -376,6 +402,11 @@ function getFileDescriptor(fileId) {
 exports.getFileDescriptor = getFileDescriptor;
 /**
  * Gets information about the specified files in the Media Manager.
+ *
+ *
+ * The `getFileDescriptors()` function returns a Promise that resolves to an array containing the specified files' descriptors.
+ *
+ * Use `getFileDescriptor()` to get a single file descriptor.
  * @param fileIds - File IDs.
  * @public
  * @documentationMaturity preview
@@ -426,9 +457,11 @@ function getFileDescriptors(fileIds) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileIds',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { fileIds: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['fileIds']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -436,7 +469,10 @@ function getFileDescriptors(fileIds) {
 }
 exports.getFileDescriptors = getFileDescriptors;
 /**
- * Updates a file. <br />
+ * Updates a file.
+ *
+ *
+ * The `updateFileDescriptor()` function returns a Promise that resolves to the updated file's descriptor.
  *
  * You can use the `parentFolderId` parameter to move a file from its current folder to a different folder.
  * @param _id - File ID. Generated when a file is uploaded to the Media Manager.
@@ -496,10 +532,11 @@ function updateFileDescriptor(_id, file) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                '_id',
-                'file',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: { file: '$[1]' },
+                explicitPathsToArguments: { 'file.id': '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['_id', 'file']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -509,9 +546,11 @@ exports.updateFileDescriptor = updateFileDescriptor;
 /**
  * Generates an upload URL to allow external clients to upload a file to the Media Manager.
  *
+ * The `generateFileUploadUrl()` function returns a Promise that resolves to an upload URL.
+ *
  * To learn how external clients can use the generated upload URL in the response to upload a file to the Media Manager, see the Upload API article.
  *
- * > **Note:** Any interruption in the upload process stops the file upload. For files larger than 10MB, or when network connection is poor, use the generateFileResumableUploadUrl() instead. With the resumable upload URL, any interruption in the upload process pauses the file upload, and resumes the file upload process after the interruption.
+ * > **Note:** Any interruption in the upload process stops the file upload. For files larger than 10MB, or when network connection is poor, use `generateFileResumableUploadUrl()` instead. With the resumable upload URL, any interruption in the upload process pauses the file upload, and resumes the file upload process after the interruption.
  * @param mimeType - File mime type.
  * @public
  * @documentationMaturity preview
@@ -564,10 +603,19 @@ function generateFileUploadUrl(mimeType, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'mimeType',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    mimeType: '$[0]',
+                    fileName: '$[1].fileName',
+                    sizeInBytes: '$[1].sizeInBytes',
+                    parentFolderId: '$[1].parentFolderId',
+                    private: '$[1].private',
+                    labels: '$[1].labels',
+                    externalInfo: '$[1].externalInfo',
+                },
+                singleArgumentUnchanged: false,
+            }, ['mimeType', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -575,9 +623,11 @@ function generateFileUploadUrl(mimeType, options) {
 }
 exports.generateFileUploadUrl = generateFileUploadUrl;
 /**
- * Generates a resumable upload URL to allow external clients to easily upload large files over 10MB to the Media Manager.
+ * Generates a resumable upload URL to allow external clients to upload large files over 10MB to the Media Manager.
  *
- * With the resumable upload URL, any interruptions in the upload process pauses the file upload, and resumes the file upload process after the interruption. The resumable upload URL is also helpful when network connection is poor.
+ * The `generateFileResumableUploadUrl()` function returns a Promise that resolves to an upload URL, token, and protocol.
+ *
+ * When using the resumable upload URL, any interruptions will pause the file upload process, which automatically resumes once the interruption is resolved. The resumable upload URL is also helpful when network connection is poor.
  *
  * To learn how external clients can use the generated upload URL in the response to upload large files to the Media Manager, see the Resumable Upload API article.
  * @param mimeType - File mime type.
@@ -632,10 +682,19 @@ function generateFileResumableUploadUrl(mimeType, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'mimeType',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    mimeType: '$[0]',
+                    fileName: '$[1].fileName',
+                    sizeInBytes: '$[1].sizeInBytes',
+                    parentFolderId: '$[1].parentFolderId',
+                    private: '$[1].private',
+                    labels: '$[1].labels',
+                    uploadProtocol: '$[1].uploadProtocol',
+                },
+                singleArgumentUnchanged: false,
+            }, ['mimeType', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -643,19 +702,18 @@ function generateFileResumableUploadUrl(mimeType, options) {
 }
 exports.generateFileResumableUploadUrl = generateFileResumableUploadUrl;
 /**
- * Imports a file to the Media Manager using an external url.
+ * Imports a file to the Media Manager using an external URL.
+ *
+ * The `importFile()` function returns a Promise that resolves to the imported file's descriptor.
  *
- * This function returns information about the imported file.
+ * This function returns information about the imported file. Importing a file is the method through which you can add files to the Media Manager.
  * Use the `parentFolderId` parameter to specify which folder you want the file to be imported to.
  * If no folder is specified, the file is imported to the `media-root` folder.
  *
- * To import a file, you need to provide one of the following:
- * 1. Pass the file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request. For example, `'image/png'`.
- * 2. Pass the file's name and extension. For example, `'my-image.png'`.
- * 3. If you don't know the file's extension or MIME type, pass its [media type](https://support.wix.com/en/article/wix-media-supported-media-file-types-and-file-sizes) in the `mediaType` parameter of the request. For example, `'IMAGE'`. Note that this option only works if the server hosting the media allows a 'HEAD' request.
- *
- * >**Note:** The `media` property isn't returned in the `files` response object.
- *
+ * To import a file, you need to pass one of the following:
+ * - The file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request. For example, `'image/png'`.
+ * - The file's name and extension. For example, `'my-image.png'`.
+ * - If you don't know the file's extension or MIME type, its [media type](https://support.wix.com/en/article/wix-media-supported-media-file-types-and-file-sizes) in the `mediaType` parameter of the request. For example, `'IMAGE'`. Note that this option only works if the server hosting the media allows a 'HEAD' request.
  * @param url - Publicly accessible external file URL.
  * @public
  * @documentationMaturity preview
@@ -717,10 +775,22 @@ function importFile(url, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'url',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    url: '$[0]',
+                    mediaType: '$[1].mediaType',
+                    displayName: '$[1].displayName',
+                    parentFolderId: '$[1].parentFolderId',
+                    private: '$[1].private',
+                    labels: '$[1].labels',
+                    mimeType: '$[1].mimeType',
+                    externalInfo: '$[1].externalInfo',
+                    urlParams: '$[1].urlParams',
+                    urlHeaders: '$[1].urlHeaders',
+                },
+                singleArgumentUnchanged: false,
+            }, ['url', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -732,15 +802,17 @@ exports.importFile = importFile;
  * > This function has been replaced with `bulkImportFile()`, and will be removed on March 31, 2024.
  *
  *
+ * The `bulkImportFiles()` function returns a Promise that resolves to an array of the imported files' descriptors.
+ *
  * Imports a bulk of files to the Media Manager using external urls.
  *
  * Returns information about the imported files. Use the `parentFolderId` parameter to specify in which folder you want each file to be imported.
  * If no folder is specified, the file is imported to the `media-root` folder.
  *
- * To import files, you need to provide one of the following:
- * 1. Pass each file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request. For example, `'image/png'`.
- * 2. Pass each file's name and extension. For example, `'my-image.png'`.
- * 3. If you don't know a file's extension or MIME type, pass its [media type](https://support.wix.com/en/article/wix-media-supported-media-file-types-and-file-sizes) in the `mediaType` parameter of the request. For example, `'IMAGE'`. Note that this option only works if the server hosting the media allows a 'HEAD' request.
+ * To import a file, you need to pass one of the following:
+ * - The file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request. For example, `'image/png'`.
+ * - The file's name and extension. For example, `'my-image.png'`.
+ * - If you don't know the file's extension or MIME type, its [media type](https://support.wix.com/en/article/wix-media-supported-media-file-types-and-file-sizes) in the `mediaType` parameter of the request. For example, `'IMAGE'`. Note that this option only works if the server hosting the media allows a 'HEAD' request.
  *
  * >**Note:** The `media` property isn't returned in the `files` response object.
  * @param importFileRequests - Information about the files to import.
@@ -794,9 +866,11 @@ function bulkImportFiles(importFileRequests) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'importFileRequests',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { importFileRequests: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['importFileRequests']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -804,22 +878,23 @@ function bulkImportFiles(importFileRequests) {
 }
 exports.bulkImportFiles = bulkImportFiles;
 /**
- * Imports a bulk of files to the Media Manager using external urls. <br/>
+ * Imports a bulk of files to the Media Manager using external urls.
  *
- * Returns information about the imported files. Use the `parentFolderId` parameter to specify in which folder you want each file to be imported to.
- * If no folder is specified, the file is imported to the `media-root` folder.
+ * The `bulkImportFile()` function returns a Promise that resolves to an object containing bulk import metadata and an array of imported files' descriptors and metadata.
  *
- * To import files, you need to provide one of the following:
- * 1. Pass each file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request.  For example, 'image/png'.
- * 2. Pass each file's name and extension. For example, 'my-image.png'.
- * 3. If you don't know a file's extension or MIME type, pass its media type in the `mediaType` parameter of the request. For example, 'IMAGE'. Note that this option only works if the server hosting the media allows a 'HEAD' request.
+ * Returns information about the imported files. Use the `parentFolderId` parameter to specify in which folder you want each file to be imported.
+ * If no folder is specified, the file is imported to the `media-root` folder.
  *
- * >**Note:** The `media` property isn't returned in the `files` response object.
+ * To import a file, you need to pass one of the following:
+ * - The file's [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) in the `mimeType` parameter of the request. For example, `'image/png'`.
+ * - The file's name and extension. For example, `'my-image.png'`.
+ * - If you don't know the file's extension or MIME type, its [media type](https://support.wix.com/en/article/wix-media-supported-media-file-types-and-file-sizes) in the `mediaType` parameter of the request. For example, `'IMAGE'`. Note that this option only works if the server hosting the media allows a 'HEAD' request.
  * @param importFileRequests - Information about the files to import.
  * @public
  * @documentationMaturity preview
  * @requiredField importFileRequests
  * @requiredField importFileRequests.url
+ * @param options - Options to include the file descriptor in the response.
  * @permissionScope Manage Bookings Services and Settings
  * @permissionScope Manage Media Manager
  * @applicableIdentity APP
@@ -869,10 +944,14 @@ function bulkImportFile(importFileRequests, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'importFileRequests',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    importFileRequests: '$[0]',
+                    returnEntity: '$[1].returnEntity',
+                },
+                singleArgumentUnchanged: false,
+            }, ['importFileRequests', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -882,7 +961,11 @@ exports.bulkImportFile = bulkImportFile;
 /**
  * Retrieves a list of files in the Media Manager.
  *
+ * The `listFiles()` function returns a Promise that resolves to an array of the specified files' descriptors and cursor information.
+ *
  * To retrieve a list of files within a specific folder in the Media Manager, pass the folder's ID in the `parentFolderId` parameter. If no folder is specified, the endpoint retrieves only the list of files in the root folder of the Media Manager.
+ *
+ * To retrieve a list of (non-permanently) deleted files, use the `listDeletedFiles()` function.
  * @public
  * @documentationMaturity preview
  * @param options - Options to use when listing media files.
@@ -938,9 +1021,17 @@ function listFiles(options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    parentFolderId: '$[0].parentFolderId',
+                    mediaTypes: '$[0].mediaTypes',
+                    private: '$[0].private',
+                    sort: '$[0].sort',
+                    paging: '$[0].paging',
+                },
+                singleArgumentUnchanged: false,
+            }, ['options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -950,7 +1041,9 @@ exports.listFiles = listFiles;
 /**
  * Searches all folders in the Media Manager and returns a list of files that match the terms specified in the optional parameters.
  *
- * If no parameters are specified, the endpoint returns all files in the `MEDIA_ROOT` folder.
+ * The `searchFiles()` function returns a Promise that resolves to an array of the specified files' descriptors and cursor information.
+ *
+ * If no parameters are specified, the function returns all files in the `MEDIA_ROOT` folder.
  * @public
  * @documentationMaturity preview
  * @param options - Options to specify which folders to search.
@@ -1007,9 +1100,18 @@ function searchFiles(options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    search: '$[0].search',
+                    rootFolder: '$[0].rootFolder',
+                    mediaTypes: '$[0].mediaTypes',
+                    private: '$[0].private',
+                    sort: '$[0].sort',
+                    paging: '$[0].paging',
+                },
+                singleArgumentUnchanged: false,
+            }, ['options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -1018,6 +1120,11 @@ function searchFiles(options) {
 exports.searchFiles = searchFiles;
 /**
  * Generates a URL for streaming a specific video file in the Media Manager.
+ *
+ *
+ * The `generateVideoStreamingUrl()` function returns a Promise that resolves to a download URL and its asset key.
+ *
+ * To stream different assets of the file, use the `assetKeys` parameter which generates a video streaming URL for each asset. If no asset key is specified, it defaults to `src`, which generates one video streaming URL in the original file's format and quality.
  * @param fileId - File ID.
  * @public
  * @documentationMaturity preview
@@ -1063,10 +1170,11 @@ function generateVideoStreamingUrl(fileId, options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileId',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { fileId: '$[0]', format: '$[1].format' },
+                singleArgumentUnchanged: false,
+            }, ['fileId', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -1077,7 +1185,9 @@ exports.generateVideoStreamingUrl = generateVideoStreamingUrl;
  * Deletes the specified files from the Media Manager.
  *
  *
- * The deleted files are moved to the Media Manager's trash bin (`TRASH-ROOT` folder) unless permanently deleted. To permanently delete files, pass the `permanent` parameter with the value `true`. Permanently deleting files isn't reversible, so make sure that these files aren't being used in a site or in any other way as the files will no longer be accessible.
+ * The `bulkDeleteFiles()` function returns a Promise that resolves when the files are deleted.
+ *
+ * The deleted files are moved to the Media Manager's trash bin (`TRASH_ROOT` folder) unless permanently deleted. To permanently delete files, pass the `permanent` parameter with the value `true`. Permanently deleting files isn't reversible, so make sure that these files aren't being used in a site or in any other way as the files will no longer be accessible.
  *
  * >**Notes:**
  * > - The specified files can be from different folders.
@@ -1129,13 +1239,16 @@ function bulkDeleteFiles(fileIds, options) {
         try {
             const result = yield httpClient.request(reqOpts);
             (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
-            return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileIds',
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    fileIds: '$[0]',
+                    permanent: '$[1].permanent',
+                },
+                singleArgumentUnchanged: false,
+            }, ['fileIds', 'options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -1144,6 +1257,8 @@ function bulkDeleteFiles(fileIds, options) {
 exports.bulkDeleteFiles = bulkDeleteFiles;
 /**
  * Restores the specified files from the Media Manager's trash bin, and moves them to their original locations in the Media Manager.
+ *
+ * The `bulkRestoreFilesFromTrashBin()` function returns a Promise that resolves when the files have been restored.
  * @param fileIds - IDs of the files to restore from the Media Manager's trash bin.
  * @public
  * @documentationMaturity preview
@@ -1184,12 +1299,13 @@ function bulkRestoreFilesFromTrashBin(fileIds) {
         try {
             const result = yield httpClient.request(reqOpts);
             (_b = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onSuccess) === null || _b === void 0 ? void 0 : _b.call(sideEffects, result);
-            return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'fileIds',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: { fileIds: '$[0]' },
+                singleArgumentUnchanged: false,
+            }, ['fileIds']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }
@@ -1199,7 +1315,11 @@ exports.bulkRestoreFilesFromTrashBin = bulkRestoreFilesFromTrashBin;
 /**
  * Retrieves a list of files in the Media Manager's trash bin.
  *
- * >**Note:** The Media Manager's trash bin (`TRASH-ROOT` folder) only contains temporarily deleted files, not permanently deleted files.
+ * The `listDeletedFiles()` function returns a Promise that resolves to an array of the specified deleted files' descriptors and cursor information.
+ *
+ * >**Note:** The Media Manager's trash bin (`TRASH_ROOT` folder) only contains temporarily deleted files, not permanently deleted files.
+ *
+ * To retrieve a list of non-deleted files, use the `listFiles()` function.
  * @public
  * @documentationMaturity preview
  * @param options - Options to use when listing deleted files from the trash bin.
@@ -1255,9 +1375,17 @@ function listDeletedFiles(options) {
             return fromJSON(result.data);
         }
         catch (err) {
-            const transformedError = (0, velo_1.transformError)(err, requestTransformation, [
-                'options',
-            ]);
+            const transformedError = (0, transform_error_1.transformError)(err, {
+                spreadPathsToArguments: {},
+                explicitPathsToArguments: {
+                    parentFolderId: '$[0].parentFolderId',
+                    mediaTypes: '$[0].mediaTypes',
+                    private: '$[0].private',
+                    sort: '$[0].sort',
+                    paging: '$[0].paging',
+                },
+                singleArgumentUnchanged: false,
+            }, ['options']);
             (_c = sideEffects === null || sideEffects === void 0 ? void 0 : sideEffects.onError) === null || _c === void 0 ? void 0 : _c.call(sideEffects, err);
             throw transformedError;
         }