@wix/media 1.0.50 → 1.0.52

package/build/cjs/index.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];

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,0FAA0E;AAC1E,mFAAmE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0FAA0E;AAC1E,mFAAmE"}

package/build/cjs/index.typings.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];

package/build/cjs/index.typings.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.typings.js","sourceRoot":"","sources":["../../index.typings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,6FAA6E;AAC7E,sFAAsE"}
+{"version":3,"file":"index.typings.js","sourceRoot":"","sources":["../../index.typings.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6FAA6E;AAC7E,sFAAsE"}

package/build/cjs/meta.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];

package/build/cjs/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../meta.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,wFAAwE;AACxE,iFAAiE"}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../meta.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wFAAwE;AACxE,iFAAiE"}

package/build/cjs/src/media-site-media-v1-file-descriptor.http.d.ts

@@ -3,24 +3,45 @@ import { BulkDeleteFilesRequest, BulkDeleteFilesResponse, BulkImportFilesRequest
 /**
  * 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.
  */
 export declare function generateFilesDownloadUrl(payload: GenerateFilesDownloadUrlRequest): RequestOptionsFactory<GenerateFilesDownloadUrlResponse & GenerateFilesDownloadUrlResponseNonNullableFields>;
 /**
  * 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.
  */
 export declare function generateFileDownloadUrl(payload: GenerateFileDownloadUrlRequest): RequestOptionsFactory<GenerateFileDownloadUrlResponse & GenerateFileDownloadUrlResponseNonNullableFields>;
-/** Gets information about the specified file in the Media Manager. */
+/**
+ * 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.
+ */
 export declare function getFileDescriptor(payload: GetFileDescriptorRequest): RequestOptionsFactory<GetFileDescriptorResponse & GetFileDescriptorResponseNonNullableFields>;
-/** Gets information about the specified files in the Media Manager. */
+/**
+ * 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.
+ */
 export declare function getFileDescriptors(payload: GetFileDescriptorsRequest): RequestOptionsFactory<GetFileDescriptorsResponse & GetFileDescriptorsResponseNonNullableFields>;
 /**
- * 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.
  */
@@ -28,33 +49,36 @@ export declare function updateFileDescriptor(payload: UpdateFileDescriptorReques
 /**
  * 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.
  */
 export declare function generateFileUploadUrl(payload: GenerateFileUploadUrlRequest): RequestOptionsFactory<GenerateFileUploadUrlResponse & GenerateFileUploadUrlResponseNonNullableFields>;
 /**
- * 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.
  */
 export declare function generateFileResumableUploadUrl(payload: GenerateFileResumableUploadUrlRequest): RequestOptionsFactory<GenerateFileResumableUploadUrlResponse & GenerateFileResumableUploadUrlResponseNonNullableFields>;
 /**
- * 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.
  */
 export declare function importFile(payload: ImportFileRequest): RequestOptionsFactory<ImportFileResponse & ImportFileResponseNonNullableFields>;
 /**
@@ -62,52 +86,69 @@ export declare function importFile(payload: ImportFileRequest): RequestOptionsFa
  * > 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.
  */
 export declare function bulkImportFiles(payload: BulkImportFilesRequest): RequestOptionsFactory<BulkImportFilesResponse & BulkImportFilesResponseNonNullableFields>;
 /**
- * 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.
  */
 export declare function bulkImportFile(payload: BulkImportFileRequest): RequestOptionsFactory<BulkImportFileResponse & BulkImportFileResponseNonNullableFields>;
 /**
  * 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.
  */
 export declare function listFiles(payload: ListFilesRequest): RequestOptionsFactory<ListFilesResponse & ListFilesResponseNonNullableFields>;
 /**
  * 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.
  */
 export declare function searchFiles(payload: SearchFilesRequest): RequestOptionsFactory<SearchFilesResponse & SearchFilesResponseNonNullableFields>;
-/** Generates a URL for streaming a specific video file in the Media Manager. */
+/**
+ * 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.
+ */
 export declare function generateVideoStreamingUrl(payload: GenerateVideoStreamingUrlRequest): RequestOptionsFactory<GenerateVideoStreamingUrlResponse & GenerateVideoStreamingUrlResponseNonNullableFields>;
 /**
  * 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.
@@ -117,11 +158,19 @@ export declare function generateVideoStreamingUrl(payload: GenerateVideoStreamin
  * > - You can use `bulkRestoreFilesFromTrashBin()` to restore files from the Media Manager's trash bin.
  */
 export declare function bulkDeleteFiles(payload: BulkDeleteFilesRequest): RequestOptionsFactory<BulkDeleteFilesResponse>;
-/** Restores the specified files from the Media Manager's trash bin, and moves them to their original locations in the Media Manager. */
+/**
+ * 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.
+ */
 export declare function bulkRestoreFilesFromTrashBin(payload: BulkRestoreFilesFromTrashBinRequest): RequestOptionsFactory<BulkRestoreFilesFromTrashBinResponse>;
 /**
  * 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.
  */
 export declare function listDeletedFiles(payload: ListDeletedFilesRequest): RequestOptionsFactory<ListDeletedFilesResponse & ListDeletedFilesResponseNonNullableFields>;